[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-2541-gcaba86
|
From: |
Arnold Robbins |
|
Subject: |
[gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-2541-gcaba861 |
|
Date: |
Wed, 12 Apr 2017 06:05:42 -0400 (EDT) |
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, master has been updated
via caba861750571c86af1e80731f1a43dc96b47e95 (commit)
from c8d82e842e7ad94cae039e6c978b4bea1a31c4d5 (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=caba861750571c86af1e80731f1a43dc96b47e95
commit caba861750571c86af1e80731f1a43dc96b47e95
Author: Arnold D. Robbins <address@hidden>
Date: Wed Apr 12 13:05:23 2017 +0300
Add Italian translation of the gawk manual.
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 61d09e2..4da39fe 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2017-04-12 Arnold D. Robbins <address@hidden>
+
+ * it: New directory with Italian translation of the manual.
+ * Makefile.am (EXTRA_DIST): Add `it' and wordlist2.
+
2017-04-12 Manuel Collado <address@hidden>
* gawktexi.in, gawk.1: Small clarification of the patsplit behavior.
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 367ed0c..0b9316b 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -41,13 +41,14 @@ EXTRA_DIST = ChangeLog ChangeLog.0 README.card ad.block
setter.outline \
gawktexi.in sidebar.awk \
general-program.eps general-program.fig general-program.pdf \
general-program.png general-program.txt \
+ it \
process-flow.eps process-flow.fig process-flow.pdf \
process-flow.png process-flow.txt \
macros colors no.colors $(man_MANS) \
lflashlight-small.xpic lflashlight.eps lflashlight.pdf \
rflashlight-small.xpic rflashlight.eps rflashlight.pdf \
statist.jpg statist.eps statist.pdf \
- wordlist \
+ wordlist wordlist2 \
bc_notes
# Get rid of generated files when cleaning
diff --git a/doc/Makefile.in b/doc/Makefile.in
index c20aecf..078a006 100644
--- a/doc/Makefile.in
+++ b/doc/Makefile.in
@@ -369,13 +369,14 @@ EXTRA_DIST = ChangeLog ChangeLog.0 README.card ad.block
setter.outline \
gawktexi.in sidebar.awk \
general-program.eps general-program.fig general-program.pdf \
general-program.png general-program.txt \
+ it \
process-flow.eps process-flow.fig process-flow.pdf \
process-flow.png process-flow.txt \
macros colors no.colors $(man_MANS) \
lflashlight-small.xpic lflashlight.eps lflashlight.pdf \
rflashlight-small.xpic rflashlight.eps rflashlight.pdf \
statist.jpg statist.eps statist.pdf \
- wordlist \
+ wordlist wordlist2 \
bc_notes
diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
new file mode 100644
index 0000000..112686c
--- /dev/null
+++ b/doc/it/ChangeLog
@@ -0,0 +1,7 @@
+2017-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog: created.
+
+ Italian translation of "The Gawk Manual", contributed
+ by Antonio Giovanni Colombo <address@hidden>
+ and Marco Curreli <address@hidden>.
diff --git a/doc/it/api-figura1.eps b/doc/it/api-figura1.eps
new file mode 100755
index 0000000..9356079
--- /dev/null
+++ b/doc/it/api-figura1.eps
@@ -0,0 +1,536 @@
+%!PS-Adobe-3.0 EPSF-3.0
+%%Title: api-figura1.fig
+%%Creator: fig2dev Version 3.2 Patchlevel 5e
+%%CreationDate: Wed Jun 29 10:59:41 2016
+%%BoundingBox: 0 0 356 221
+%Magnification: 1.0000
+%%EndComments
+%%BeginProlog
+/MyAppDict 100 dict dup begin def
+/$F2psDict 200 dict def
+$F2psDict begin
+$F2psDict /mtrx matrix put
+/col-1 {0 setgray} bind def
+/col0 {0.000 0.000 0.000 srgb} bind def
+/col1 {0.000 0.000 1.000 srgb} bind def
+/col2 {0.000 1.000 0.000 srgb} bind def
+/col3 {0.000 1.000 1.000 srgb} bind def
+/col4 {1.000 0.000 0.000 srgb} bind def
+/col5 {1.000 0.000 1.000 srgb} bind def
+/col6 {1.000 1.000 0.000 srgb} bind def
+/col7 {1.000 1.000 1.000 srgb} bind def
+/col8 {0.000 0.000 0.560 srgb} bind def
+/col9 {0.000 0.000 0.690 srgb} bind def
+/col10 {0.000 0.000 0.820 srgb} bind def
+/col11 {0.530 0.810 1.000 srgb} bind def
+/col12 {0.000 0.560 0.000 srgb} bind def
+/col13 {0.000 0.690 0.000 srgb} bind def
+/col14 {0.000 0.820 0.000 srgb} bind def
+/col15 {0.000 0.560 0.560 srgb} bind def
+/col16 {0.000 0.690 0.690 srgb} bind def
+/col17 {0.000 0.820 0.820 srgb} bind def
+/col18 {0.560 0.000 0.000 srgb} bind def
+/col19 {0.690 0.000 0.000 srgb} bind def
+/col20 {0.820 0.000 0.000 srgb} bind def
+/col21 {0.560 0.000 0.560 srgb} bind def
+/col22 {0.690 0.000 0.690 srgb} bind def
+/col23 {0.820 0.000 0.820 srgb} bind def
+/col24 {0.500 0.190 0.000 srgb} bind def
+/col25 {0.630 0.250 0.000 srgb} bind def
+/col26 {0.750 0.380 0.000 srgb} bind def
+/col27 {1.000 0.500 0.500 srgb} bind def
+/col28 {1.000 0.630 0.630 srgb} bind def
+/col29 {1.000 0.750 0.750 srgb} bind def
+/col30 {1.000 0.880 0.880 srgb} bind def
+/col31 {1.000 0.840 0.000 srgb} bind def
+
+end
+
+% This junk string is used by the show operators
+/PATsstr 1 string def
+/PATawidthshow { % cx cy cchar rx ry string
+ % Loop over each character in the string
+ { % cx cy cchar rx ry char
+ % Show the character
+ dup % cx cy cchar rx ry char char
+ PATsstr dup 0 4 -1 roll put % cx cy cchar rx ry char (char)
+ false charpath % cx cy cchar rx ry char
+ /clip load PATdraw
+ % Move past the character (charpath modified the
+ % current point)
+ currentpoint % cx cy cchar rx ry char x y
+ newpath
+ moveto % cx cy cchar rx ry char
+ % Reposition by cx,cy if the character in the string is cchar
+ 3 index eq { % cx cy cchar rx ry
+ 4 index 4 index rmoveto
+ } if
+ % Reposition all characters by rx ry
+ 2 copy rmoveto % cx cy cchar rx ry
+ } forall
+ pop pop pop pop pop % -
+ currentpoint
+ newpath
+ moveto
+} bind def
+/PATcg {
+ 7 dict dup begin
+ /lw currentlinewidth def
+ /lc currentlinecap def
+ /lj currentlinejoin def
+ /ml currentmiterlimit def
+ /ds [ currentdash ] def
+ /cc [ currentrgbcolor ] def
+ /cm matrix currentmatrix def
+ end
+} bind def
+% PATdraw - calculates the boundaries of the object and
+% fills it with the current pattern
+/PATdraw { % proc
+ save exch
+ PATpcalc % proc nw nh px py
+ 5 -1 roll exec % nw nh px py
+ newpath
+ PATfill % -
+ restore
+} bind def
+% PATfill - performs the tiling for the shape
+/PATfill { % nw nh px py PATfill -
+ PATDict /CurrentPattern get dup begin
+ setfont
+ % Set the coordinate system to Pattern Space
+ PatternGState PATsg
+ % Set the color for uncolored pattezns
+ PaintType 2 eq { PATDict /PColor get PATsc } if
+ % Create the string for showing
+ 3 index string % nw nh px py str
+ % Loop for each of the pattern sources
+ 0 1 Multi 1 sub { % nw nh px py str source
+ % Move to the starting location
+ 3 index 3 index % nw nh px py str source px py
+ moveto % nw nh px py str source
+ % For multiple sources, set the appropriate color
+ Multi 1 ne { dup PC exch get PATsc } if
+ % Set the appropriate string for the source
+ 0 1 7 index 1 sub { 2 index exch 2 index put } for pop
+ % Loop over the number of vertical cells
+ 3 index % nw nh px py str nh
+ { % nw nh px py str
+ currentpoint % nw nh px py str cx cy
+ 2 index oldshow % nw nh px py str cx cy
+ YStep add moveto % nw nh px py str
+ } repeat % nw nh px py str
+ } for
+ 5 { pop } repeat
+ end
+} bind def
+
+% PATkshow - kshow with the current pattezn
+/PATkshow { % proc string
+ exch bind % string proc
+ 1 index 0 get % string proc char
+ % Loop over all but the last character in the string
+ 0 1 4 index length 2 sub {
+ % string proc char idx
+ % Find the n+1th character in the string
+ 3 index exch 1 add get % string proc char char+1
+ exch 2 copy % strinq proc char+1 char char+1 char
+ % Now show the nth character
+ PATsstr dup 0 4 -1 roll put % string proc chr+1 chr chr+1 (chr)
+ false charpath % string proc char+1 char char+1
+ /clip load PATdraw
+ % Move past the character (charpath modified the current point)
+ currentpoint newpath moveto
+ % Execute the user proc (should consume char and char+1)
+ mark 3 1 roll % string proc char+1 mark char char+1
+ 4 index exec % string proc char+1 mark...
+ cleartomark % string proc char+1
+ } for
+ % Now display the last character
+ PATsstr dup 0 4 -1 roll put % string proc (char+1)
+ false charpath % string proc
+ /clip load PATdraw
+ neewath
+ pop pop % -
+} bind def
+% PATmp - the makepattern equivalent
+/PATmp { % patdict patmtx PATmp patinstance
+ exch dup length 7 add % We will add 6 new entries plus 1 FID
+ dict copy % Create a new dictionary
+ begin
+ % Matrix to install when painting the pattern
+ TilingType PATtcalc
+ /PatternGState PATcg def
+ PatternGState /cm 3 -1 roll put
+ % Check for multi pattern sources (Level 1 fast color patterns)
+ currentdict /Multi known not { /Multi 1 def } if
+ % Font dictionary definitions
+ /FontType 3 def
+ % Create a dummy encoding vector
+ /Encoding 256 array def
+ 3 string 0 1 255 {
+ Encoding exch dup 3 index cvs cvn put } for pop
+ /FontMatrix matrix def
+ /FontBBox BBox def
+ /BuildChar {
+ mark 3 1 roll % mark dict char
+ exch begin
+ Multi 1 ne {PaintData exch get}{pop} ifelse % mark [paintdata]
+ PaintType 2 eq Multi 1 ne or
+ { XStep 0 FontBBox aload pop setcachedevice }
+ { XStep 0 setcharwidth } ifelse
+ currentdict % mark [paintdata] dict
+ /PaintProc load % mark [paintdata] dict paintproc
+ end
+ gsave
+ false PATredef exec true PATredef
+ grestore
+ cleartomark % -
+ } bind def
+ currentdict
+ end % newdict
+ /foo exch % /foo newlict
+ definefont % newfont
+} bind def
+% PATpcalc - calculates the starting point and width/height
+% of the tile fill for the shape
+/PATpcalc { % - PATpcalc nw nh px py
+ PATDict /CurrentPattern get begin
+ gsave
+ % Set up the coordinate system to Pattern Space
+ % and lock down pattern
+ PatternGState /cm get setmatrix
+ BBox aload pop pop pop translate
+ % Determine the bounding box of the shape
+ pathbbox % llx lly urx ury
+ grestore
+ % Determine (nw, nh) the # of cells to paint width and height
+ PatHeight div ceiling % llx lly urx qh
+ 4 1 roll % qh llx lly urx
+ PatWidth div ceiling % qh llx lly qw
+ 4 1 roll % qw qh llx lly
+ PatHeight div floor % qw qh llx ph
+ 4 1 roll % ph qw qh llx
+ PatWidth div floor % ph qw qh pw
+ 4 1 roll % pw ph qw qh
+ 2 index sub cvi abs % pw ph qs qh-ph
+ exch 3 index sub cvi abs exch % pw ph nw=qw-pw nh=qh-ph
+ % Determine the starting point of the pattern fill
+ %(px, py)
+ 4 2 roll % nw nh pw ph
+ PatHeight mul % nw nh pw py
+ exch % nw nh py pw
+ PatWidth mul exch % nw nh px py
+ end
+} bind def
+
+% Save the original routines so that we can use them later on
+/oldfill /fill load def
+/oldeofill /eofill load def
+/oldstroke /stroke load def
+/oldshow /show load def
+/oldashow /ashow load def
+/oldwidthshow /widthshow load def
+/oldawidthshow /awidthshow load def
+/oldkshow /kshow load def
+
+% These defs are necessary so that subsequent procs don't bind in
+% the originals
+/fill { oldfill } bind def
+/eofill { oldeofill } bind def
+/stroke { oldstroke } bind def
+/show { oldshow } bind def
+/ashow { oldashow } bind def
+/widthshow { oldwidthshow } bind def
+/awidthshow { oldawidthshow } bind def
+/kshow { oldkshow } bind def
+/PATredef {
+ MyAppDict begin
+ {
+ /fill { /clip load PATdraw newpath } bind def
+ /eofill { /eoclip load PATdraw newpath } bind def
+ /stroke { PATstroke } bind def
+ /show { 0 0 null 0 0 6 -1 roll PATawidthshow } bind def
+ /ashow { 0 0 null 6 3 roll PATawidthshow }
+ bind def
+ /widthshow { 0 0 3 -1 roll PATawidthshow }
+ bind def
+ /awidthshow { PATawidthshow } bind def
+ /kshow { PATkshow } bind def
+ } {
+ /fill { oldfill } bind def
+ /eofill { oldeofill } bind def
+ /stroke { oldstroke } bind def
+ /show { oldshow } bind def
+ /ashow { oldashow } bind def
+ /widthshow { oldwidthshow } bind def
+ /awidthshow { oldawidthshow } bind def
+ /kshow { oldkshow } bind def
+ } ifelse
+ end
+} bind def
+false PATredef
+% Conditionally define setcmykcolor if not available
+/setcmykcolor where { pop } {
+ /setcmykcolor {
+ 1 sub 4 1 roll
+ 3 {
+ 3 index add neg dup 0 lt { pop 0 } if 3 1 roll
+ } repeat
+ setrgbcolor - pop
+ } bind def
+} ifelse
+/PATsc { % colorarray
+ aload length % c1 ... cn length
+ dup 1 eq { pop setgray } { 3 eq { setrgbcolor } { setcmykcolor
+ } ifelse } ifelse
+} bind def
+/PATsg { % dict
+ begin
+ lw setlinewidth
+ lc setlinecap
+ lj setlinejoin
+ ml setmiterlimit
+ ds aload pop setdash
+ cc aload pop setrgbcolor
+ cm setmatrix
+ end
+} bind def
+
+/PATDict 3 dict def
+/PATsp {
+ true PATredef
+ PATDict begin
+ /CurrentPattern exch def
+ % If it's an uncolored pattern, save the color
+ CurrentPattern /PaintType get 2 eq {
+ /PColor exch def
+ } if
+ /CColor [ currentrgbcolor ] def
+ end
+} bind def
+% PATstroke - stroke with the current pattern
+/PATstroke {
+ countdictstack
+ save
+ mark
+ {
+ currentpoint strokepath moveto
+ PATpcalc % proc nw nh px py
+ clip newpath PATfill
+ } stopped {
+ (*** PATstroke Warning: Path is too complex, stroking
+ with gray) =
+ cleartomark
+ restore
+ countdictstack exch sub dup 0 gt
+ { { end } repeat } { pop } ifelse
+ gsave 0.5 setgray oldstroke grestore
+ } { pop restore pop } ifelse
+ newpath
+} bind def
+/PATtcalc { % modmtx tilingtype PATtcalc tilematrix
+ % Note: tiling types 2 and 3 are not supported
+ gsave
+ exch concat % tilingtype
+ matrix currentmatrix exch % cmtx tilingtype
+ % Tiling type 1 and 3: constant spacing
+ 2 ne {
+ % Distort the pattern so that it occupies
+ % an integral number of device pixels
+ dup 4 get exch dup 5 get exch % tx ty cmtx
+ XStep 0 dtransform
+ round exch round exch % tx ty cmtx dx.x dx.y
+ XStep div exch XStep div exch % tx ty cmtx a b
+ 0 YStep dtransform
+ round exch round exch % tx ty cmtx a b dy.x dy.y
+ YStep div exch YStep div exch % tx ty cmtx a b c d
+ 7 -3 roll astore % { a b c d tx ty }
+ } if
+ grestore
+} bind def
+/PATusp {
+ false PATredef
+ PATDict begin
+ CColor PATsc
+ end
+} bind def
+
+% right30
+11 dict begin
+/PaintType 1 def
+/PatternType 1 def
+/TilingType 1 def
+/BBox [0 0 1 1] def
+/XStep 1 def
+/YStep 1 def
+/PatWidth 1 def
+/PatHeight 1 def
+/Multi 2 def
+/PaintData [
+ { clippath } bind
+ { 32 16 true [ 32 0 0 -16 0 16 ]
+ {<00030003000c000c0030003000c000c0030003000c000c00
+ 30003000c000c00000030003000c000c0030003000c000c0
+ 030003000c000c0030003000c000c000>}
+ imagemask } bind
+] def
+/PaintProc {
+ pop
+ exec fill
+} def
+currentdict
+end
+/P2 exch def
+
+/cp {closepath} bind def
+/ef {eofill} bind def
+/gr {grestore} bind def
+/gs {gsave} bind def
+/sa {save} bind def
+/rs {restore} bind def
+/l {lineto} bind def
+/m {moveto} bind def
+/rm {rmoveto} bind def
+/n {newpath} bind def
+/s {stroke} bind def
+/sh {show} bind def
+/slc {setlinecap} bind def
+/slj {setlinejoin} bind def
+/slw {setlinewidth} bind def
+/srgb {setrgbcolor} bind def
+/rot {rotate} bind def
+/sc {scale} bind def
+/sd {setdash} bind def
+/ff {findfont} bind def
+/sf {setfont} bind def
+/scf {scalefont} bind def
+/sw {stringwidth} bind def
+/tr {translate} bind def
+/tnt {dup dup currentrgbcolor
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb}
+ bind def
+/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul
+ 4 -2 roll mul srgb} bind def
+/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def
+/$F2psEnd {$F2psEnteredState restore end} def
+
+/pageheader {
+save
+newpath 0 221 moveto 0 0 lineto 356 0 lineto 356 221 lineto closepath clip
newpath
+-194.8 344.2 translate
+1 -1 scale
+$F2psBegin
+10 setmiterlimit
+0 slj 0 slc
+ 0.06299 0.06299 sc
+} bind def
+/pagefooter {
+$F2psEnd
+restore
+} bind def
+%%EndProlog
+pageheader
+%
+% Fig objects follow
+%
+%
+% here starts figure with depth 50
+% Arc
+7.500 slw
+0 slc
+gs clippath
+3599 4000 m 3567 4148 l 3626 4161 l 3658 4013 l 3658 4013 l 3603 4124 l 3599
4000 l cp
+eoclip
+n 5449.3 4471.5 1878.7 -70.5453 -169.8379 arcn
+gs col0 s gr
+ gr
+
+% arrowhead
+0 slj
+n 3599 4000 m 3603 4124 l 3658 4013 l 3599 4000 l cp gs 0.00 setgray ef gr
col0 s
+% Arc
+gs clippath
+4422 4004 m 4425 4155 l 4485 4154 l 4482 4003 l 4482 4003 l 4455 4124 l 4422
4004 l cp
+eoclip
+n 5539.0 4051.3 1087.6 -60.4713 175.3232 arcn
+gs col0 s gr
+ gr
+
+% arrowhead
+n 4422 4004 m 4455 4124 l 4482 4003 l 4422 4004 l cp gs 0.00 setgray ef gr
col0 s
+% Arc
+gs clippath
+4986 4010 m 5012 4159 l 5072 4149 l 5046 4000 l 5046 4000 l 5037 4124 l 4986
4010 l cp
+eoclip
+n 5628.8 3967.5 613.5 -36.7999 163.6698 arcn
+gs col0 s gr
+ gr
+
+% arrowhead
+n 4986 4010 m 5037 4124 l 5046 4000 l 4986 4010 l cp gs 0.00 setgray ef gr
col0 s
+% Arc
+135.000 slw
+gs clippath
+7736 3835 m 7756 3984 l 7907 3964 l 7887 3814 l 7841 3821 l 7828 3944 l 7782
3829 l cp
+eoclip
+n 6609.1 4056.9 1224.8 -93.9364 -4.5364 arc
+gs col0 s gr
+ gr
+
+% arrowhead
+7.500 slw
+n 7782 3829 m 7828 3944 l 7841 3821 l col0 s
+% Polyline
+n 3105 4140 m 6660 4140 l 6660 5085 l 3105 5085 l
+ cp gs col0 s gr
+% Polyline
+n 6660 4140 m 8730 4140 l 8730 5085 l 6660 5085 l
+ cp gs col7 0.50 shd ef gr gs col0 s gr
+% Polyline
+n 5805 2610 m 6345 2610 l 6345 3690 l 5805 3690 l
+ cp gs col0 s gr
+% Polyline
+n 5805 2835 m 6345 2835 l 6345 3015 l 5805 3015 l
+ cp gs col0 s gr
+% Polyline
+n 5805 3195 m 6345 3195 l 6345 3375 l 5805 3375 l
+ cp gs col0 s gr
+% Polyline
+n 5805 3510 m 6345 3510 l 6345 3690 l 5805 3690 l
+ cp gs col0 s gr
+% Polyline
+n 3510 4140 m 3780 4140 l 3780 5085 l 3510 5085 l
+ cp gs /PC [[1.00 1.00 1.00] [0.00 0.00 0.00]] def
+15.00 15.00 sc P2 [16 0 0 -8 234.00 276.00] PATmp PATsp ef gr PATusp gs col0 s
gr
+% Polyline
+n 4365 4140 m 4635 4140 l 4635 5085 l 4365 5085 l
+ cp gs /PC [[1.00 1.00 1.00] [0.00 0.00 0.00]] def
+15.00 15.00 sc P2 [16 0 0 -8 291.00 276.00] PATmp PATsp ef gr PATusp gs col0 s
gr
+% Polyline
+n 4905 4140 m 5265 4140 l 5265 5085 l 4905 5085 l
+ cp gs /PC [[1.00 1.00 1.00] [0.00 0.00 0.00]] def
+15.00 15.00 sc P2 [16 0 0 -8 327.00 276.00] PATmp PATsp ef gr PATusp gs col0 s
gr
+/Times-Roman ff 190.50 scf sf
+5985 2115 m
+gs 1 -1 sc (API) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+5895 2340 m
+gs 1 -1 sc (Struct) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+7020 5400 m
+gs 1 -1 sc ( Estensione) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+6525 2655 m
+gs 1 -1 sc (dl_load\(api_p, id\);) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+3195 5400 m
+gs 1 -1 sc (Memoria indirizzabile programma gawk) col0 sh gr
+% here ends figure;
+pagefooter
+showpage
+%%Trailer
+end
+%EOF
diff --git a/doc/it/api-figura1.fig b/doc/it/api-figura1.fig
new file mode 100755
index 0000000..c2718c7
--- /dev/null
+++ b/doc/it/api-figura1.fig
@@ -0,0 +1,40 @@
+#FIG 3.2 Produced by xfig version 3.2.5c
+Landscape
+Center
+Metric
+A4
+100.00
+Single
+-2
+1200 2
+5 1 0 1 0 7 50 -1 -1 0.000 0 1 1 0 5449.265 4471.471 6075 2700 4320 2970 3600
4140
+ 1 1 1.00 60.00 120.00
+5 1 0 1 0 7 50 -1 -1 0.000 0 1 1 0 5538.971 4051.323 6075 3105 4725 3330 4455
4140
+ 1 1 1.00 60.00 120.00
+5 1 0 1 0 7 50 -1 -1 0.000 0 1 1 0 5628.750 3967.500 6120 3600 5220 3510 5040
4140
+ 1 1 1.00 60.00 120.00
+5 1 0 10 0 7 50 -1 -1 0.000 0 0 1 0 6609.079 4056.868 6525 2835 7560 3285 7830
3960
+ 0 0 1.00 60.00 120.00
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+ 3105 4140 6660 4140 6660 5085 3105 5085 3105 4140
+2 2 0 1 0 7 50 -1 10 0.000 0 0 -1 0 0 5
+ 6660 4140 8730 4140 8730 5085 6660 5085 6660 4140
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+ 5805 2610 6345 2610 6345 3690 5805 3690 5805 2610
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+ 5805 2835 6345 2835 6345 3015 5805 3015 5805 2835
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+ 5805 3195 6345 3195 6345 3375 5805 3375 5805 3195
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+ 5805 3510 6345 3510 6345 3690 5805 3690 5805 3510
+2 2 0 1 0 7 50 -1 42 0.000 0 0 -1 0 0 5
+ 3510 4140 3780 4140 3780 5085 3510 5085 3510 4140
+2 2 0 1 0 7 50 -1 42 0.000 0 0 -1 0 0 5
+ 4365 4140 4635 4140 4635 5085 4365 5085 4365 4140
+2 2 0 1 0 7 50 -1 42 0.000 0 0 -1 0 0 5
+ 4905 4140 5265 4140 5265 5085 4905 5085 4905 4140
+4 0 0 50 -1 0 12 0.0000 4 135 270 5985 2115 API\001
+4 0 0 50 -1 0 12 0.0000 4 135 540 5895 2340 Struct\001
+4 0 0 50 -1 0 12 0.0000 4 135 1170 7020 5400 Estensione\001
+4 0 0 50 -1 0 12 0.0000 4 180 1710 6525 2655 dl_load(api_p, id);\001
+4 0 0 50 -1 0 12 0.0000 4 165 3240 3195 5400 Memoria indirizzabile programma
gawk\001
diff --git a/doc/it/api-figura1.pdf b/doc/it/api-figura1.pdf
new file mode 100755
index 0000000..f31e25a
Binary files /dev/null and b/doc/it/api-figura1.pdf differ
diff --git a/doc/it/api-figura1.png b/doc/it/api-figura1.png
new file mode 100755
index 0000000..444c297
Binary files /dev/null and b/doc/it/api-figura1.png differ
diff --git a/doc/it/api-figura1.txt b/doc/it/api-figura1.txt
new file mode 100755
index 0000000..630e18f
--- /dev/null
+++ b/doc/it/api-figura1.txt
@@ -0,0 +1,24 @@
+ Struct (Struttura)
+ API
+ +---+
+ | |
+ +---+
+ +---------------| |
+ | +---+ dl_load(api_p, id);
+ | | | ___________________
+ | +---+ |
+ | +---------| | __________________ |
+ | | +---+ ||
+ | | | | ||
+ | | +---+ ||
+ | | +---| | ||
+ | | | +---+ \ || /
+ | | | \ /
+ v v v \/
++-------+-+---+-+---+-+------------------+--------------------+
+| |x| |x| |x| |OOOOOOOOOOOOOOOOOOOO|
+| |x| |x| |x| |OOOOOOOOOOOOOOOOOOOO|
+| |x| |x| |x| |OOOOOOOOOOOOOOOOOOOO|
++-------+-+---+-+---+-+------------------+--------------------+
+
+ Memoria indirizzabile programma gawk Estensione
diff --git a/doc/it/api-figura2.eps b/doc/it/api-figura2.eps
new file mode 100755
index 0000000..9920d3b
--- /dev/null
+++ b/doc/it/api-figura2.eps
@@ -0,0 +1,517 @@
+%!PS-Adobe-3.0 EPSF-3.0
+%%Title: api-figura2.fig
+%%Creator: fig2dev Version 3.2 Patchlevel 5e
+%%CreationDate: Wed Jun 29 11:02:52 2016
+%%BoundingBox: 0 0 356 173
+%Magnification: 1.0000
+%%EndComments
+%%BeginProlog
+/MyAppDict 100 dict dup begin def
+/$F2psDict 200 dict def
+$F2psDict begin
+$F2psDict /mtrx matrix put
+/col-1 {0 setgray} bind def
+/col0 {0.000 0.000 0.000 srgb} bind def
+/col1 {0.000 0.000 1.000 srgb} bind def
+/col2 {0.000 1.000 0.000 srgb} bind def
+/col3 {0.000 1.000 1.000 srgb} bind def
+/col4 {1.000 0.000 0.000 srgb} bind def
+/col5 {1.000 0.000 1.000 srgb} bind def
+/col6 {1.000 1.000 0.000 srgb} bind def
+/col7 {1.000 1.000 1.000 srgb} bind def
+/col8 {0.000 0.000 0.560 srgb} bind def
+/col9 {0.000 0.000 0.690 srgb} bind def
+/col10 {0.000 0.000 0.820 srgb} bind def
+/col11 {0.530 0.810 1.000 srgb} bind def
+/col12 {0.000 0.560 0.000 srgb} bind def
+/col13 {0.000 0.690 0.000 srgb} bind def
+/col14 {0.000 0.820 0.000 srgb} bind def
+/col15 {0.000 0.560 0.560 srgb} bind def
+/col16 {0.000 0.690 0.690 srgb} bind def
+/col17 {0.000 0.820 0.820 srgb} bind def
+/col18 {0.560 0.000 0.000 srgb} bind def
+/col19 {0.690 0.000 0.000 srgb} bind def
+/col20 {0.820 0.000 0.000 srgb} bind def
+/col21 {0.560 0.000 0.560 srgb} bind def
+/col22 {0.690 0.000 0.690 srgb} bind def
+/col23 {0.820 0.000 0.820 srgb} bind def
+/col24 {0.500 0.190 0.000 srgb} bind def
+/col25 {0.630 0.250 0.000 srgb} bind def
+/col26 {0.750 0.380 0.000 srgb} bind def
+/col27 {1.000 0.500 0.500 srgb} bind def
+/col28 {1.000 0.630 0.630 srgb} bind def
+/col29 {1.000 0.750 0.750 srgb} bind def
+/col30 {1.000 0.880 0.880 srgb} bind def
+/col31 {1.000 0.840 0.000 srgb} bind def
+
+end
+
+% This junk string is used by the show operators
+/PATsstr 1 string def
+/PATawidthshow { % cx cy cchar rx ry string
+ % Loop over each character in the string
+ { % cx cy cchar rx ry char
+ % Show the character
+ dup % cx cy cchar rx ry char char
+ PATsstr dup 0 4 -1 roll put % cx cy cchar rx ry char (char)
+ false charpath % cx cy cchar rx ry char
+ /clip load PATdraw
+ % Move past the character (charpath modified the
+ % current point)
+ currentpoint % cx cy cchar rx ry char x y
+ newpath
+ moveto % cx cy cchar rx ry char
+ % Reposition by cx,cy if the character in the string is cchar
+ 3 index eq { % cx cy cchar rx ry
+ 4 index 4 index rmoveto
+ } if
+ % Reposition all characters by rx ry
+ 2 copy rmoveto % cx cy cchar rx ry
+ } forall
+ pop pop pop pop pop % -
+ currentpoint
+ newpath
+ moveto
+} bind def
+/PATcg {
+ 7 dict dup begin
+ /lw currentlinewidth def
+ /lc currentlinecap def
+ /lj currentlinejoin def
+ /ml currentmiterlimit def
+ /ds [ currentdash ] def
+ /cc [ currentrgbcolor ] def
+ /cm matrix currentmatrix def
+ end
+} bind def
+% PATdraw - calculates the boundaries of the object and
+% fills it with the current pattern
+/PATdraw { % proc
+ save exch
+ PATpcalc % proc nw nh px py
+ 5 -1 roll exec % nw nh px py
+ newpath
+ PATfill % -
+ restore
+} bind def
+% PATfill - performs the tiling for the shape
+/PATfill { % nw nh px py PATfill -
+ PATDict /CurrentPattern get dup begin
+ setfont
+ % Set the coordinate system to Pattern Space
+ PatternGState PATsg
+ % Set the color for uncolored pattezns
+ PaintType 2 eq { PATDict /PColor get PATsc } if
+ % Create the string for showing
+ 3 index string % nw nh px py str
+ % Loop for each of the pattern sources
+ 0 1 Multi 1 sub { % nw nh px py str source
+ % Move to the starting location
+ 3 index 3 index % nw nh px py str source px py
+ moveto % nw nh px py str source
+ % For multiple sources, set the appropriate color
+ Multi 1 ne { dup PC exch get PATsc } if
+ % Set the appropriate string for the source
+ 0 1 7 index 1 sub { 2 index exch 2 index put } for pop
+ % Loop over the number of vertical cells
+ 3 index % nw nh px py str nh
+ { % nw nh px py str
+ currentpoint % nw nh px py str cx cy
+ 2 index oldshow % nw nh px py str cx cy
+ YStep add moveto % nw nh px py str
+ } repeat % nw nh px py str
+ } for
+ 5 { pop } repeat
+ end
+} bind def
+
+% PATkshow - kshow with the current pattezn
+/PATkshow { % proc string
+ exch bind % string proc
+ 1 index 0 get % string proc char
+ % Loop over all but the last character in the string
+ 0 1 4 index length 2 sub {
+ % string proc char idx
+ % Find the n+1th character in the string
+ 3 index exch 1 add get % string proc char char+1
+ exch 2 copy % strinq proc char+1 char char+1 char
+ % Now show the nth character
+ PATsstr dup 0 4 -1 roll put % string proc chr+1 chr chr+1 (chr)
+ false charpath % string proc char+1 char char+1
+ /clip load PATdraw
+ % Move past the character (charpath modified the current point)
+ currentpoint newpath moveto
+ % Execute the user proc (should consume char and char+1)
+ mark 3 1 roll % string proc char+1 mark char char+1
+ 4 index exec % string proc char+1 mark...
+ cleartomark % string proc char+1
+ } for
+ % Now display the last character
+ PATsstr dup 0 4 -1 roll put % string proc (char+1)
+ false charpath % string proc
+ /clip load PATdraw
+ neewath
+ pop pop % -
+} bind def
+% PATmp - the makepattern equivalent
+/PATmp { % patdict patmtx PATmp patinstance
+ exch dup length 7 add % We will add 6 new entries plus 1 FID
+ dict copy % Create a new dictionary
+ begin
+ % Matrix to install when painting the pattern
+ TilingType PATtcalc
+ /PatternGState PATcg def
+ PatternGState /cm 3 -1 roll put
+ % Check for multi pattern sources (Level 1 fast color patterns)
+ currentdict /Multi known not { /Multi 1 def } if
+ % Font dictionary definitions
+ /FontType 3 def
+ % Create a dummy encoding vector
+ /Encoding 256 array def
+ 3 string 0 1 255 {
+ Encoding exch dup 3 index cvs cvn put } for pop
+ /FontMatrix matrix def
+ /FontBBox BBox def
+ /BuildChar {
+ mark 3 1 roll % mark dict char
+ exch begin
+ Multi 1 ne {PaintData exch get}{pop} ifelse % mark [paintdata]
+ PaintType 2 eq Multi 1 ne or
+ { XStep 0 FontBBox aload pop setcachedevice }
+ { XStep 0 setcharwidth } ifelse
+ currentdict % mark [paintdata] dict
+ /PaintProc load % mark [paintdata] dict paintproc
+ end
+ gsave
+ false PATredef exec true PATredef
+ grestore
+ cleartomark % -
+ } bind def
+ currentdict
+ end % newdict
+ /foo exch % /foo newlict
+ definefont % newfont
+} bind def
+% PATpcalc - calculates the starting point and width/height
+% of the tile fill for the shape
+/PATpcalc { % - PATpcalc nw nh px py
+ PATDict /CurrentPattern get begin
+ gsave
+ % Set up the coordinate system to Pattern Space
+ % and lock down pattern
+ PatternGState /cm get setmatrix
+ BBox aload pop pop pop translate
+ % Determine the bounding box of the shape
+ pathbbox % llx lly urx ury
+ grestore
+ % Determine (nw, nh) the # of cells to paint width and height
+ PatHeight div ceiling % llx lly urx qh
+ 4 1 roll % qh llx lly urx
+ PatWidth div ceiling % qh llx lly qw
+ 4 1 roll % qw qh llx lly
+ PatHeight div floor % qw qh llx ph
+ 4 1 roll % ph qw qh llx
+ PatWidth div floor % ph qw qh pw
+ 4 1 roll % pw ph qw qh
+ 2 index sub cvi abs % pw ph qs qh-ph
+ exch 3 index sub cvi abs exch % pw ph nw=qw-pw nh=qh-ph
+ % Determine the starting point of the pattern fill
+ %(px, py)
+ 4 2 roll % nw nh pw ph
+ PatHeight mul % nw nh pw py
+ exch % nw nh py pw
+ PatWidth mul exch % nw nh px py
+ end
+} bind def
+
+% Save the original routines so that we can use them later on
+/oldfill /fill load def
+/oldeofill /eofill load def
+/oldstroke /stroke load def
+/oldshow /show load def
+/oldashow /ashow load def
+/oldwidthshow /widthshow load def
+/oldawidthshow /awidthshow load def
+/oldkshow /kshow load def
+
+% These defs are necessary so that subsequent procs don't bind in
+% the originals
+/fill { oldfill } bind def
+/eofill { oldeofill } bind def
+/stroke { oldstroke } bind def
+/show { oldshow } bind def
+/ashow { oldashow } bind def
+/widthshow { oldwidthshow } bind def
+/awidthshow { oldawidthshow } bind def
+/kshow { oldkshow } bind def
+/PATredef {
+ MyAppDict begin
+ {
+ /fill { /clip load PATdraw newpath } bind def
+ /eofill { /eoclip load PATdraw newpath } bind def
+ /stroke { PATstroke } bind def
+ /show { 0 0 null 0 0 6 -1 roll PATawidthshow } bind def
+ /ashow { 0 0 null 6 3 roll PATawidthshow }
+ bind def
+ /widthshow { 0 0 3 -1 roll PATawidthshow }
+ bind def
+ /awidthshow { PATawidthshow } bind def
+ /kshow { PATkshow } bind def
+ } {
+ /fill { oldfill } bind def
+ /eofill { oldeofill } bind def
+ /stroke { oldstroke } bind def
+ /show { oldshow } bind def
+ /ashow { oldashow } bind def
+ /widthshow { oldwidthshow } bind def
+ /awidthshow { oldawidthshow } bind def
+ /kshow { oldkshow } bind def
+ } ifelse
+ end
+} bind def
+false PATredef
+% Conditionally define setcmykcolor if not available
+/setcmykcolor where { pop } {
+ /setcmykcolor {
+ 1 sub 4 1 roll
+ 3 {
+ 3 index add neg dup 0 lt { pop 0 } if 3 1 roll
+ } repeat
+ setrgbcolor - pop
+ } bind def
+} ifelse
+/PATsc { % colorarray
+ aload length % c1 ... cn length
+ dup 1 eq { pop setgray } { 3 eq { setrgbcolor } { setcmykcolor
+ } ifelse } ifelse
+} bind def
+/PATsg { % dict
+ begin
+ lw setlinewidth
+ lc setlinecap
+ lj setlinejoin
+ ml setmiterlimit
+ ds aload pop setdash
+ cc aload pop setrgbcolor
+ cm setmatrix
+ end
+} bind def
+
+/PATDict 3 dict def
+/PATsp {
+ true PATredef
+ PATDict begin
+ /CurrentPattern exch def
+ % If it's an uncolored pattern, save the color
+ CurrentPattern /PaintType get 2 eq {
+ /PColor exch def
+ } if
+ /CColor [ currentrgbcolor ] def
+ end
+} bind def
+% PATstroke - stroke with the current pattern
+/PATstroke {
+ countdictstack
+ save
+ mark
+ {
+ currentpoint strokepath moveto
+ PATpcalc % proc nw nh px py
+ clip newpath PATfill
+ } stopped {
+ (*** PATstroke Warning: Path is too complex, stroking
+ with gray) =
+ cleartomark
+ restore
+ countdictstack exch sub dup 0 gt
+ { { end } repeat } { pop } ifelse
+ gsave 0.5 setgray oldstroke grestore
+ } { pop restore pop } ifelse
+ newpath
+} bind def
+/PATtcalc { % modmtx tilingtype PATtcalc tilematrix
+ % Note: tiling types 2 and 3 are not supported
+ gsave
+ exch concat % tilingtype
+ matrix currentmatrix exch % cmtx tilingtype
+ % Tiling type 1 and 3: constant spacing
+ 2 ne {
+ % Distort the pattern so that it occupies
+ % an integral number of device pixels
+ dup 4 get exch dup 5 get exch % tx ty cmtx
+ XStep 0 dtransform
+ round exch round exch % tx ty cmtx dx.x dx.y
+ XStep div exch XStep div exch % tx ty cmtx a b
+ 0 YStep dtransform
+ round exch round exch % tx ty cmtx a b dy.x dy.y
+ YStep div exch YStep div exch % tx ty cmtx a b c d
+ 7 -3 roll astore % { a b c d tx ty }
+ } if
+ grestore
+} bind def
+/PATusp {
+ false PATredef
+ PATDict begin
+ CColor PATsc
+ end
+} bind def
+
+% right30
+11 dict begin
+/PaintType 1 def
+/PatternType 1 def
+/TilingType 1 def
+/BBox [0 0 1 1] def
+/XStep 1 def
+/YStep 1 def
+/PatWidth 1 def
+/PatHeight 1 def
+/Multi 2 def
+/PaintData [
+ { clippath } bind
+ { 32 16 true [ 32 0 0 -16 0 16 ]
+ {<00030003000c000c0030003000c000c0030003000c000c00
+ 30003000c000c00000030003000c000c0030003000c000c0
+ 030003000c000c0030003000c000c000>}
+ imagemask } bind
+] def
+/PaintProc {
+ pop
+ exec fill
+} def
+currentdict
+end
+/P2 exch def
+
+% crosshatch45
+11 dict begin
+/PaintType 1 def
+/PatternType 1 def
+/TilingType 1 def
+/BBox [0 0 1 1] def
+/XStep 1 def
+/YStep 1 def
+/PatWidth 1 def
+/PatHeight 1 def
+/Multi 2 def
+/PaintData [
+ { clippath } bind
+ { 20 20 true [ 20 0 0 -20 0 20 ]
+ {<8020004050102088201104400a02800401000a02
+ 8011044020882040501080200040501020882011
+ 04400a02800401000a0280110440208820405010>}
+ imagemask } bind
+] def
+/PaintProc {
+ pop
+ exec fill
+} def
+currentdict
+end
+/P6 exch def
+
+/cp {closepath} bind def
+/ef {eofill} bind def
+/gr {grestore} bind def
+/gs {gsave} bind def
+/sa {save} bind def
+/rs {restore} bind def
+/l {lineto} bind def
+/m {moveto} bind def
+/rm {rmoveto} bind def
+/n {newpath} bind def
+/s {stroke} bind def
+/sh {show} bind def
+/slc {setlinecap} bind def
+/slj {setlinejoin} bind def
+/slw {setlinewidth} bind def
+/srgb {setrgbcolor} bind def
+/rot {rotate} bind def
+/sc {scale} bind def
+/sd {setdash} bind def
+/ff {findfont} bind def
+/sf {setfont} bind def
+/scf {scalefont} bind def
+/sw {stringwidth} bind def
+/tr {translate} bind def
+/tnt {dup dup currentrgbcolor
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb}
+ bind def
+/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul
+ 4 -2 roll mul srgb} bind def
+/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def
+/$F2psEnd {$F2psEnteredState restore end} def
+
+/pageheader {
+save
+newpath 0 173 moveto 0 0 lineto 356 0 lineto 356 173 lineto closepath clip
newpath
+-194.8 344.2 translate
+1 -1 scale
+$F2psBegin
+10 setmiterlimit
+0 slj 0 slc
+ 0.06299 0.06299 sc
+} bind def
+/pagefooter {
+$F2psEnd
+restore
+} bind def
+%%EndProlog
+pageheader
+%
+% Fig objects follow
+%
+%
+% here starts figure with depth 50
+% Arc
+7.500 slw
+0 slc
+gs clippath
+3662 4014 m 3567 4132 l 3613 4170 l 3708 4052 l 3708 4052 l 3610 4127 l 3662
4014 l cp
+eoclip
+n 5895.0 5917.5 2902.8 -37.7581 -142.2419 arcn
+gs col0 s gr
+ gr
+
+% arrowhead
+0 slj
+n 3662 4014 m 3610 4127 l 3708 4052 l 3662 4014 l cp gs 0.00 setgray ef gr
col0 s
+% Polyline
+n 3105 4140 m 6660 4140 l 6660 5085 l 3105 5085 l
+ cp gs col0 s gr
+% Polyline
+n 6660 4140 m 8730 4140 l 8730 5085 l 6660 5085 l
+ cp gs col7 0.50 shd ef gr gs col0 s gr
+% Polyline
+n 3510 4140 m 3780 4140 l 3780 5085 l 3510 5085 l
+ cp gs /PC [[1.00 1.00 1.00] [0.00 0.00 0.00]] def
+15.00 15.00 sc P2 [16 0 0 -8 234.00 276.00] PATmp PATsp ef gr PATusp gs col0 s
gr
+% Polyline
+n 4365 4140 m 4635 4140 l 4635 5085 l 4365 5085 l
+ cp gs /PC [[1.00 1.00 1.00] [0.00 0.00 0.00]] def
+15.00 15.00 sc P2 [16 0 0 -8 291.00 276.00] PATmp PATsp ef gr PATusp gs col0 s
gr
+% Polyline
+n 4905 4140 m 5265 4140 l 5265 5085 l 4905 5085 l
+ cp gs /PC [[1.00 1.00 1.00] [0.00 0.00 0.00]] def
+15.00 15.00 sc P2 [16 0 0 -8 327.00 276.00] PATmp PATsp ef gr PATusp gs col0 s
gr
+% Polyline
+n 7965 4140 m 8370 4140 l 8370 5085 l 7965 5085 l
+ cp gs /PC [[1.00 1.00 1.00] [0.00 0.00 0.00]] def
+15.00 15.00 sc P6 [16 0 0 -16 531.00 276.00] PATmp PATsp ef gr PATusp gs col0
s gr
+/Courier-Bold ff 190.50 scf sf
+3420 2880 m
+gs 1 -1 sc (register_ext_func\({ "chdir", do_chdir, 1 }\);) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+6840 5400 m
+gs 1 -1 sc ( Estensione) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+3195 5400 m
+gs 1 -1 sc (Memoria indirizzabile programma gawk) col0 sh gr
+% here ends figure;
+pagefooter
+showpage
+%%Trailer
+end
+%EOF
diff --git a/doc/it/api-figura2.fig b/doc/it/api-figura2.fig
new file mode 100755
index 0000000..a8b5c47
--- /dev/null
+++ b/doc/it/api-figura2.fig
@@ -0,0 +1,26 @@
+#FIG 3.2 Produced by xfig version 3.2.5c
+Landscape
+Center
+Metric
+A4
+100.00
+Single
+-2
+1200 2
+5 1 0 1 0 7 50 -1 -1 0.000 0 1 1 0 5895.000 5917.500 8190 4140 5940 3015 3600
4140
+ 1 1 1.00 60.00 120.00
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+ 3105 4140 6660 4140 6660 5085 3105 5085 3105 4140
+2 2 0 1 0 7 50 -1 10 0.000 0 0 -1 0 0 5
+ 6660 4140 8730 4140 8730 5085 6660 5085 6660 4140
+2 2 0 1 0 7 50 -1 42 0.000 0 0 -1 0 0 5
+ 3510 4140 3780 4140 3780 5085 3510 5085 3510 4140
+2 2 0 1 0 7 50 -1 42 0.000 0 0 -1 0 0 5
+ 4365 4140 4635 4140 4635 5085 4365 5085 4365 4140
+2 2 0 1 0 7 50 -1 42 0.000 0 0 -1 0 0 5
+ 4905 4140 5265 4140 5265 5085 4905 5085 4905 4140
+2 2 0 1 0 7 50 -1 46 0.000 0 0 -1 0 0 5
+ 7965 4140 8370 4140 8370 5085 7965 5085 7965 4140
+4 0 0 50 -1 14 12 0.0000 4 180 3960 3420 2880 register_ext_func({ "chdir",
do_chdir, 1 });\001
+4 0 0 50 -1 0 12 0.0000 4 135 1260 6840 5400 Estensione\001
+4 0 0 50 -1 0 12 0.0000 4 165 3240 3195 5400 Memoria indirizzabile programma
gawk\001
diff --git a/doc/it/api-figura2.pdf b/doc/it/api-figura2.pdf
new file mode 100755
index 0000000..cadd426
Binary files /dev/null and b/doc/it/api-figura2.pdf differ
diff --git a/doc/it/api-figura2.png b/doc/it/api-figura2.png
new file mode 100755
index 0000000..dbc4691
Binary files /dev/null and b/doc/it/api-figura2.png differ
diff --git a/doc/it/api-figura2.txt b/doc/it/api-figura2.txt
new file mode 100755
index 0000000..a030fb5
--- /dev/null
+++ b/doc/it/api-figura2.txt
@@ -0,0 +1,12 @@
+ register_ext_func({ "chdir", do_chdir, 1 });
+
+ +--------------------------------------------+
+ | |
+ V |
++-------+-+---+-+---+-+------------------+--------------+-+---+
+| |x| |x| |x| |OOOOOOOOOOOOOO|X|OOO|
+| |x| |x| |x| |OOOOOOOOOOOOOO|X|OOO|
+| |x| |x| |x| |OOOOOOOOOOOOOO|X|OOO|
++-------+-+---+-+---+-+------------------+--------------+-+---+
+
+ Memoria indirizzabile programma gawk Estensione
diff --git a/doc/it/api-figura3.eps b/doc/it/api-figura3.eps
new file mode 100755
index 0000000..daa3ba7
--- /dev/null
+++ b/doc/it/api-figura3.eps
@@ -0,0 +1,526 @@
+%!PS-Adobe-3.0 EPSF-3.0
+%%Title: api-figura3.fig
+%%Creator: fig2dev Version 3.2 Patchlevel 5e
+%%CreationDate: Wed Jun 29 11:05:29 2016
+%%BoundingBox: 0 0 356 170
+%Magnification: 1.0000
+%%EndComments
+%%BeginProlog
+/MyAppDict 100 dict dup begin def
+/$F2psDict 200 dict def
+$F2psDict begin
+$F2psDict /mtrx matrix put
+/col-1 {0 setgray} bind def
+/col0 {0.000 0.000 0.000 srgb} bind def
+/col1 {0.000 0.000 1.000 srgb} bind def
+/col2 {0.000 1.000 0.000 srgb} bind def
+/col3 {0.000 1.000 1.000 srgb} bind def
+/col4 {1.000 0.000 0.000 srgb} bind def
+/col5 {1.000 0.000 1.000 srgb} bind def
+/col6 {1.000 1.000 0.000 srgb} bind def
+/col7 {1.000 1.000 1.000 srgb} bind def
+/col8 {0.000 0.000 0.560 srgb} bind def
+/col9 {0.000 0.000 0.690 srgb} bind def
+/col10 {0.000 0.000 0.820 srgb} bind def
+/col11 {0.530 0.810 1.000 srgb} bind def
+/col12 {0.000 0.560 0.000 srgb} bind def
+/col13 {0.000 0.690 0.000 srgb} bind def
+/col14 {0.000 0.820 0.000 srgb} bind def
+/col15 {0.000 0.560 0.560 srgb} bind def
+/col16 {0.000 0.690 0.690 srgb} bind def
+/col17 {0.000 0.820 0.820 srgb} bind def
+/col18 {0.560 0.000 0.000 srgb} bind def
+/col19 {0.690 0.000 0.000 srgb} bind def
+/col20 {0.820 0.000 0.000 srgb} bind def
+/col21 {0.560 0.000 0.560 srgb} bind def
+/col22 {0.690 0.000 0.690 srgb} bind def
+/col23 {0.820 0.000 0.820 srgb} bind def
+/col24 {0.500 0.190 0.000 srgb} bind def
+/col25 {0.630 0.250 0.000 srgb} bind def
+/col26 {0.750 0.380 0.000 srgb} bind def
+/col27 {1.000 0.500 0.500 srgb} bind def
+/col28 {1.000 0.630 0.630 srgb} bind def
+/col29 {1.000 0.750 0.750 srgb} bind def
+/col30 {1.000 0.880 0.880 srgb} bind def
+/col31 {1.000 0.840 0.000 srgb} bind def
+
+end
+
+% This junk string is used by the show operators
+/PATsstr 1 string def
+/PATawidthshow { % cx cy cchar rx ry string
+ % Loop over each character in the string
+ { % cx cy cchar rx ry char
+ % Show the character
+ dup % cx cy cchar rx ry char char
+ PATsstr dup 0 4 -1 roll put % cx cy cchar rx ry char (char)
+ false charpath % cx cy cchar rx ry char
+ /clip load PATdraw
+ % Move past the character (charpath modified the
+ % current point)
+ currentpoint % cx cy cchar rx ry char x y
+ newpath
+ moveto % cx cy cchar rx ry char
+ % Reposition by cx,cy if the character in the string is cchar
+ 3 index eq { % cx cy cchar rx ry
+ 4 index 4 index rmoveto
+ } if
+ % Reposition all characters by rx ry
+ 2 copy rmoveto % cx cy cchar rx ry
+ } forall
+ pop pop pop pop pop % -
+ currentpoint
+ newpath
+ moveto
+} bind def
+/PATcg {
+ 7 dict dup begin
+ /lw currentlinewidth def
+ /lc currentlinecap def
+ /lj currentlinejoin def
+ /ml currentmiterlimit def
+ /ds [ currentdash ] def
+ /cc [ currentrgbcolor ] def
+ /cm matrix currentmatrix def
+ end
+} bind def
+% PATdraw - calculates the boundaries of the object and
+% fills it with the current pattern
+/PATdraw { % proc
+ save exch
+ PATpcalc % proc nw nh px py
+ 5 -1 roll exec % nw nh px py
+ newpath
+ PATfill % -
+ restore
+} bind def
+% PATfill - performs the tiling for the shape
+/PATfill { % nw nh px py PATfill -
+ PATDict /CurrentPattern get dup begin
+ setfont
+ % Set the coordinate system to Pattern Space
+ PatternGState PATsg
+ % Set the color for uncolored pattezns
+ PaintType 2 eq { PATDict /PColor get PATsc } if
+ % Create the string for showing
+ 3 index string % nw nh px py str
+ % Loop for each of the pattern sources
+ 0 1 Multi 1 sub { % nw nh px py str source
+ % Move to the starting location
+ 3 index 3 index % nw nh px py str source px py
+ moveto % nw nh px py str source
+ % For multiple sources, set the appropriate color
+ Multi 1 ne { dup PC exch get PATsc } if
+ % Set the appropriate string for the source
+ 0 1 7 index 1 sub { 2 index exch 2 index put } for pop
+ % Loop over the number of vertical cells
+ 3 index % nw nh px py str nh
+ { % nw nh px py str
+ currentpoint % nw nh px py str cx cy
+ 2 index oldshow % nw nh px py str cx cy
+ YStep add moveto % nw nh px py str
+ } repeat % nw nh px py str
+ } for
+ 5 { pop } repeat
+ end
+} bind def
+
+% PATkshow - kshow with the current pattezn
+/PATkshow { % proc string
+ exch bind % string proc
+ 1 index 0 get % string proc char
+ % Loop over all but the last character in the string
+ 0 1 4 index length 2 sub {
+ % string proc char idx
+ % Find the n+1th character in the string
+ 3 index exch 1 add get % string proc char char+1
+ exch 2 copy % strinq proc char+1 char char+1 char
+ % Now show the nth character
+ PATsstr dup 0 4 -1 roll put % string proc chr+1 chr chr+1 (chr)
+ false charpath % string proc char+1 char char+1
+ /clip load PATdraw
+ % Move past the character (charpath modified the current point)
+ currentpoint newpath moveto
+ % Execute the user proc (should consume char and char+1)
+ mark 3 1 roll % string proc char+1 mark char char+1
+ 4 index exec % string proc char+1 mark...
+ cleartomark % string proc char+1
+ } for
+ % Now display the last character
+ PATsstr dup 0 4 -1 roll put % string proc (char+1)
+ false charpath % string proc
+ /clip load PATdraw
+ neewath
+ pop pop % -
+} bind def
+% PATmp - the makepattern equivalent
+/PATmp { % patdict patmtx PATmp patinstance
+ exch dup length 7 add % We will add 6 new entries plus 1 FID
+ dict copy % Create a new dictionary
+ begin
+ % Matrix to install when painting the pattern
+ TilingType PATtcalc
+ /PatternGState PATcg def
+ PatternGState /cm 3 -1 roll put
+ % Check for multi pattern sources (Level 1 fast color patterns)
+ currentdict /Multi known not { /Multi 1 def } if
+ % Font dictionary definitions
+ /FontType 3 def
+ % Create a dummy encoding vector
+ /Encoding 256 array def
+ 3 string 0 1 255 {
+ Encoding exch dup 3 index cvs cvn put } for pop
+ /FontMatrix matrix def
+ /FontBBox BBox def
+ /BuildChar {
+ mark 3 1 roll % mark dict char
+ exch begin
+ Multi 1 ne {PaintData exch get}{pop} ifelse % mark [paintdata]
+ PaintType 2 eq Multi 1 ne or
+ { XStep 0 FontBBox aload pop setcachedevice }
+ { XStep 0 setcharwidth } ifelse
+ currentdict % mark [paintdata] dict
+ /PaintProc load % mark [paintdata] dict paintproc
+ end
+ gsave
+ false PATredef exec true PATredef
+ grestore
+ cleartomark % -
+ } bind def
+ currentdict
+ end % newdict
+ /foo exch % /foo newlict
+ definefont % newfont
+} bind def
+% PATpcalc - calculates the starting point and width/height
+% of the tile fill for the shape
+/PATpcalc { % - PATpcalc nw nh px py
+ PATDict /CurrentPattern get begin
+ gsave
+ % Set up the coordinate system to Pattern Space
+ % and lock down pattern
+ PatternGState /cm get setmatrix
+ BBox aload pop pop pop translate
+ % Determine the bounding box of the shape
+ pathbbox % llx lly urx ury
+ grestore
+ % Determine (nw, nh) the # of cells to paint width and height
+ PatHeight div ceiling % llx lly urx qh
+ 4 1 roll % qh llx lly urx
+ PatWidth div ceiling % qh llx lly qw
+ 4 1 roll % qw qh llx lly
+ PatHeight div floor % qw qh llx ph
+ 4 1 roll % ph qw qh llx
+ PatWidth div floor % ph qw qh pw
+ 4 1 roll % pw ph qw qh
+ 2 index sub cvi abs % pw ph qs qh-ph
+ exch 3 index sub cvi abs exch % pw ph nw=qw-pw nh=qh-ph
+ % Determine the starting point of the pattern fill
+ %(px, py)
+ 4 2 roll % nw nh pw ph
+ PatHeight mul % nw nh pw py
+ exch % nw nh py pw
+ PatWidth mul exch % nw nh px py
+ end
+} bind def
+
+% Save the original routines so that we can use them later on
+/oldfill /fill load def
+/oldeofill /eofill load def
+/oldstroke /stroke load def
+/oldshow /show load def
+/oldashow /ashow load def
+/oldwidthshow /widthshow load def
+/oldawidthshow /awidthshow load def
+/oldkshow /kshow load def
+
+% These defs are necessary so that subsequent procs don't bind in
+% the originals
+/fill { oldfill } bind def
+/eofill { oldeofill } bind def
+/stroke { oldstroke } bind def
+/show { oldshow } bind def
+/ashow { oldashow } bind def
+/widthshow { oldwidthshow } bind def
+/awidthshow { oldawidthshow } bind def
+/kshow { oldkshow } bind def
+/PATredef {
+ MyAppDict begin
+ {
+ /fill { /clip load PATdraw newpath } bind def
+ /eofill { /eoclip load PATdraw newpath } bind def
+ /stroke { PATstroke } bind def
+ /show { 0 0 null 0 0 6 -1 roll PATawidthshow } bind def
+ /ashow { 0 0 null 6 3 roll PATawidthshow }
+ bind def
+ /widthshow { 0 0 3 -1 roll PATawidthshow }
+ bind def
+ /awidthshow { PATawidthshow } bind def
+ /kshow { PATkshow } bind def
+ } {
+ /fill { oldfill } bind def
+ /eofill { oldeofill } bind def
+ /stroke { oldstroke } bind def
+ /show { oldshow } bind def
+ /ashow { oldashow } bind def
+ /widthshow { oldwidthshow } bind def
+ /awidthshow { oldawidthshow } bind def
+ /kshow { oldkshow } bind def
+ } ifelse
+ end
+} bind def
+false PATredef
+% Conditionally define setcmykcolor if not available
+/setcmykcolor where { pop } {
+ /setcmykcolor {
+ 1 sub 4 1 roll
+ 3 {
+ 3 index add neg dup 0 lt { pop 0 } if 3 1 roll
+ } repeat
+ setrgbcolor - pop
+ } bind def
+} ifelse
+/PATsc { % colorarray
+ aload length % c1 ... cn length
+ dup 1 eq { pop setgray } { 3 eq { setrgbcolor } { setcmykcolor
+ } ifelse } ifelse
+} bind def
+/PATsg { % dict
+ begin
+ lw setlinewidth
+ lc setlinecap
+ lj setlinejoin
+ ml setmiterlimit
+ ds aload pop setdash
+ cc aload pop setrgbcolor
+ cm setmatrix
+ end
+} bind def
+
+/PATDict 3 dict def
+/PATsp {
+ true PATredef
+ PATDict begin
+ /CurrentPattern exch def
+ % If it's an uncolored pattern, save the color
+ CurrentPattern /PaintType get 2 eq {
+ /PColor exch def
+ } if
+ /CColor [ currentrgbcolor ] def
+ end
+} bind def
+% PATstroke - stroke with the current pattern
+/PATstroke {
+ countdictstack
+ save
+ mark
+ {
+ currentpoint strokepath moveto
+ PATpcalc % proc nw nh px py
+ clip newpath PATfill
+ } stopped {
+ (*** PATstroke Warning: Path is too complex, stroking
+ with gray) =
+ cleartomark
+ restore
+ countdictstack exch sub dup 0 gt
+ { { end } repeat } { pop } ifelse
+ gsave 0.5 setgray oldstroke grestore
+ } { pop restore pop } ifelse
+ newpath
+} bind def
+/PATtcalc { % modmtx tilingtype PATtcalc tilematrix
+ % Note: tiling types 2 and 3 are not supported
+ gsave
+ exch concat % tilingtype
+ matrix currentmatrix exch % cmtx tilingtype
+ % Tiling type 1 and 3: constant spacing
+ 2 ne {
+ % Distort the pattern so that it occupies
+ % an integral number of device pixels
+ dup 4 get exch dup 5 get exch % tx ty cmtx
+ XStep 0 dtransform
+ round exch round exch % tx ty cmtx dx.x dx.y
+ XStep div exch XStep div exch % tx ty cmtx a b
+ 0 YStep dtransform
+ round exch round exch % tx ty cmtx a b dy.x dy.y
+ YStep div exch YStep div exch % tx ty cmtx a b c d
+ 7 -3 roll astore % { a b c d tx ty }
+ } if
+ grestore
+} bind def
+/PATusp {
+ false PATredef
+ PATDict begin
+ CColor PATsc
+ end
+} bind def
+
+% right30
+11 dict begin
+/PaintType 1 def
+/PatternType 1 def
+/TilingType 1 def
+/BBox [0 0 1 1] def
+/XStep 1 def
+/YStep 1 def
+/PatWidth 1 def
+/PatHeight 1 def
+/Multi 2 def
+/PaintData [
+ { clippath } bind
+ { 32 16 true [ 32 0 0 -16 0 16 ]
+ {<00030003000c000c0030003000c000c0030003000c000c00
+ 30003000c000c00000030003000c000c0030003000c000c0
+ 030003000c000c0030003000c000c000>}
+ imagemask } bind
+] def
+/PaintProc {
+ pop
+ exec fill
+} def
+currentdict
+end
+/P2 exch def
+
+% crosshatch45
+11 dict begin
+/PaintType 1 def
+/PatternType 1 def
+/TilingType 1 def
+/BBox [0 0 1 1] def
+/XStep 1 def
+/YStep 1 def
+/PatWidth 1 def
+/PatHeight 1 def
+/Multi 2 def
+/PaintData [
+ { clippath } bind
+ { 20 20 true [ 20 0 0 -20 0 20 ]
+ {<8020004050102088201104400a02800401000a02
+ 8011044020882040501080200040501020882011
+ 04400a02800401000a0280110440208820405010>}
+ imagemask } bind
+] def
+/PaintProc {
+ pop
+ exec fill
+} def
+currentdict
+end
+/P6 exch def
+
+/cp {closepath} bind def
+/ef {eofill} bind def
+/gr {grestore} bind def
+/gs {gsave} bind def
+/sa {save} bind def
+/rs {restore} bind def
+/l {lineto} bind def
+/m {moveto} bind def
+/rm {rmoveto} bind def
+/n {newpath} bind def
+/s {stroke} bind def
+/sh {show} bind def
+/slc {setlinecap} bind def
+/slj {setlinejoin} bind def
+/slw {setlinewidth} bind def
+/srgb {setrgbcolor} bind def
+/rot {rotate} bind def
+/sc {scale} bind def
+/sd {setdash} bind def
+/ff {findfont} bind def
+/sf {setfont} bind def
+/scf {scalefont} bind def
+/sw {stringwidth} bind def
+/tr {translate} bind def
+/tnt {dup dup currentrgbcolor
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb}
+ bind def
+/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul
+ 4 -2 roll mul srgb} bind def
+/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def
+/$F2psEnd {$F2psEnteredState restore end} def
+
+/pageheader {
+save
+newpath 0 170 moveto 0 0 lineto 356 0 lineto 356 170 lineto closepath clip
newpath
+-194.8 344.2 translate
+1 -1 scale
+$F2psBegin
+10 setmiterlimit
+0 slj 0 slc
+ 0.06299 0.06299 sc
+} bind def
+/pagefooter {
+$F2psEnd
+restore
+} bind def
+%%EndProlog
+pageheader
+%
+% Fig objects follow
+%
+%
+% here starts figure with depth 50
+% Arc
+7.500 slw
+0 slc
+gs clippath
+8019 4079 m 8138 4172 l 8175 4125 l 8056 4032 l 8056 4032 l 8132 4130 l 8019
4079 l cp
+eoclip
+n 6120.0 6627.7 3207.7 -129.1463 -50.8537 arc
+gs col0 s gr
+ gr
+
+% arrowhead
+0 slj
+n 8019 4079 m 8132 4130 l 8056 4032 l 8019 4079 l cp gs 0.00 setgray ef gr
col0 s
+% Polyline
+n 3105 4140 m 6660 4140 l 6660 5085 l 3105 5085 l
+ cp gs col0 s gr
+% Polyline
+n 6660 4140 m 8730 4140 l 8730 5085 l 6660 5085 l
+ cp gs col7 0.50 shd ef gr gs col0 s gr
+% Polyline
+n 3510 4140 m 3780 4140 l 3780 5085 l 3510 5085 l
+ cp gs /PC [[1.00 1.00 1.00] [0.00 0.00 0.00]] def
+15.00 15.00 sc P2 [16 0 0 -8 234.00 276.00] PATmp PATsp ef gr PATusp gs col0 s
gr
+% Polyline
+n 4365 4140 m 4635 4140 l 4635 5085 l 4365 5085 l
+ cp gs /PC [[1.00 1.00 1.00] [0.00 0.00 0.00]] def
+15.00 15.00 sc P2 [16 0 0 -8 291.00 276.00] PATmp PATsp ef gr PATusp gs col0 s
gr
+% Polyline
+n 4905 4140 m 5265 4140 l 5265 5085 l 4905 5085 l
+ cp gs /PC [[1.00 1.00 1.00] [0.00 0.00 0.00]] def
+15.00 15.00 sc P2 [16 0 0 -8 327.00 276.00] PATmp PATsp ef gr PATusp gs col0 s
gr
+% Polyline
+n 7965 4140 m 8370 4140 l 8370 5085 l 7965 5085 l
+ cp gs /PC [[1.00 1.00 1.00] [0.00 0.00 0.00]] def
+15.00 15.00 sc P6 [16 0 0 -16 531.00 276.00] PATmp PATsp ef gr PATusp gs col0
s gr
+/Courier-Bold ff 190.50 scf sf
+3240 3150 m
+gs 1 -1 sc ( chdir\("/path"\)) col0 sh gr
+/Courier-Bold ff 190.50 scf sf
+3330 3375 m
+gs 1 -1 sc (}) col0 sh gr
+/Courier-Bold ff 190.50 scf sf
+3375 2925 m
+gs 1 -1 sc (BEGIN {) col0 sh gr
+/Courier-Bold ff 190.50 scf sf
+6660 3150 m
+gs 1 -1 sc (\(*fnptr\)\(1\);) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+3150 5400 m
+gs 1 -1 sc (Memoria indirizzabile programma gawk) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+6930 5400 m
+gs 1 -1 sc ( Estensione) col0 sh gr
+% here ends figure;
+pagefooter
+showpage
+%%Trailer
+end
+%EOF
diff --git a/doc/it/api-figura3.fig b/doc/it/api-figura3.fig
new file mode 100755
index 0000000..fae9294
--- /dev/null
+++ b/doc/it/api-figura3.fig
@@ -0,0 +1,29 @@
+#FIG 3.2 Produced by xfig version 3.2.5c
+Landscape
+Center
+Metric
+A4
+100.00
+Single
+-2
+1200 2
+5 1 0 1 0 7 50 -1 -1 0.000 0 0 1 0 6120.000 6627.656 4095 4140 6120 3420 8145
4140
+ 1 1 1.00 60.00 120.00
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+ 3105 4140 6660 4140 6660 5085 3105 5085 3105 4140
+2 2 0 1 0 7 50 -1 10 0.000 0 0 -1 0 0 5
+ 6660 4140 8730 4140 8730 5085 6660 5085 6660 4140
+2 2 0 1 0 7 50 -1 42 0.000 0 0 -1 0 0 5
+ 3510 4140 3780 4140 3780 5085 3510 5085 3510 4140
+2 2 0 1 0 7 50 -1 42 0.000 0 0 -1 0 0 5
+ 4365 4140 4635 4140 4635 5085 4365 5085 4365 4140
+2 2 0 1 0 7 50 -1 42 0.000 0 0 -1 0 0 5
+ 4905 4140 5265 4140 5265 5085 4905 5085 4905 4140
+2 2 0 1 0 7 50 -1 46 0.000 0 0 -1 0 0 5
+ 7965 4140 8370 4140 8370 5085 7965 5085 7965 4140
+4 0 0 50 -1 14 12 0.0000 4 180 1620 3240 3150 chdir("/path")\001
+4 0 0 50 -1 14 12 0.0000 4 165 90 3330 3375 }\001
+4 0 0 50 -1 14 12 0.0000 4 165 630 3375 2925 BEGIN {\001
+4 0 0 50 -1 14 12 0.0000 4 180 1080 6660 3150 (*fnptr)(1);\001
+4 0 0 50 -1 0 12 0.0000 4 165 3240 3150 5400 Memoria indirizzabile programma
gawk\001
+4 0 0 50 -1 0 12 0.0000 4 135 1260 6930 5400 Estensione\001
diff --git a/doc/it/api-figura3.pdf b/doc/it/api-figura3.pdf
new file mode 100755
index 0000000..07f406b
Binary files /dev/null and b/doc/it/api-figura3.pdf differ
diff --git a/doc/it/api-figura3.png b/doc/it/api-figura3.png
new file mode 100755
index 0000000..26ca6cd
Binary files /dev/null and b/doc/it/api-figura3.png differ
diff --git a/doc/it/api-figura3.txt b/doc/it/api-figura3.txt
new file mode 100755
index 0000000..02791df
--- /dev/null
+++ b/doc/it/api-figura3.txt
@@ -0,0 +1,13 @@
+ BEGIN {
+ chdir("/path") (*fnptr)(1);
+ }
+ +--------------------------------------------+
+ | |
+ | V
++-------+-+---+-+---+-+------------------+--------------+-+---+
+| |x| |x| |x| |OOOOOOOOOOOOOO|X|OOO|
+| |x| |x| |x| |OOOOOOOOOOOOOO|X|OOO|
+| |x| |x| |x| |OOOOOOOOOOOOOO|X|OOO|
++-------+-+---+-+---+-+------------------+--------------+-+---+
+
+ Memoria indirizzabile programma gawk Estensione
diff --git a/doc/it/compila_originale.sh b/doc/it/compila_originale.sh
new file mode 100755
index 0000000..06d53b9
--- /dev/null
+++ b/doc/it/compila_originale.sh
@@ -0,0 +1,16 @@
+
+#
+# builds the PDF version of the Gawk manual,
+# in the current directory
+#
+echo "Building the pdf version of the gawk manual"
+echo "in directory:"
+pwd
+echo "Beware, it can take a long time!"
+if [ -f "gawktexi.in" ]
+then
+ gawk -f sidebar.awk gawktexi.in >gawk.texi
+fi
+# just in case, drop previous Index
+rm -f gawk.cps gawk.cp gawk.aux gawk.fn gawk.ky gawk.log gawk.pg
+texi2pdf gawk.texi
diff --git a/doc/it/compila_smallprint.sh b/doc/it/compila_smallprint.sh
new file mode 100755
index 0000000..dd8d57f
--- /dev/null
+++ b/doc/it/compila_smallprint.sh
@@ -0,0 +1,19 @@
+#!/bin/bash
+
+# eventuali file di lavoro da elaborazioni precedenti
+rm -f gawk-it-17x24.pdf gawk-it.toc gawk-it.aux gawk-it.cp gawk-it.texi
2>/dev/null
+
+sed '{
+ s/@example/@smallexample/g
+ s/@end example/@end smallexample/g
+ }' gawktexi.in > gawktexi-tmp.in
+
+awk -f sidebar.awk < gawktexi-tmp.in > gawk-it.texi
+
+texi2dvi -t "@set SMALLPRINT" -t "@set FOR_PRINT" -t @manuale -t "@include
margini.texi" gawk-it.texi -o gawk-it-17x24.dvi
+
+dvipdfmx --dvipdfm -p 170mm,240mm gawk-it-17x24.dvi
+
+awk -f sidebar.awk < gawktexi.in > gawk-it.texi
+
+rm gawktexi-tmp.in
diff --git a/doc/it/epsf.tex b/doc/it/epsf.tex
new file mode 100755
index 0000000..847de77
--- /dev/null
+++ b/doc/it/epsf.tex
@@ -0,0 +1,653 @@
+%%% -*-TeX-*-
+%%% ====================================================================
+%%% @TeX-file{
+%%% author = "Tom Rokicki",
+%%% version = "2.7.4",
+%%% date = "14 February 2011",
+%%% time = "15:44:06 MST",
+%%% filename = "epsf.tex",
+%%% address = "Tom Rokicki
+%%% Box 2081
+%%% Stanford, CA 94309
+%%% USA",
+%%% telephone = "+1 415 855 9989",
+%%% checksum = "29223 653 3100 27123",
+%%% email = "address@hidden (Internet)",
+%%% codetable = "ISO/ASCII",
+%%% copyright = "This file is freely redistributable and
+%%% placed into the public domain by Tomas
+%%% Rokicki.",
+%%% keywords = "PostScript, TeX",
+%%% license = "public domain",
+%%% supported = "yes",
+%%% abstract = "This file contains macros to support the
+%%% inclusion of Encapsulated PostScript files
+%%% in TeX documents.",
+%%% docstring = "This file contains TeX macros to include an
+%%% Encapsulated PostScript graphic. It works
+%%% by finding the bounding box comment,
+%%% calculating the correct scale values, and
+%%% inserting a vbox of the appropriate size at
+%%% the current position in the TeX document.
+%%%
+%%% To use, simply use
+%%%
+%%% \input epsf % somewhere early on in your TeX file
+%%%
+%%% % then where you want to insert a vbox for a figure:
+%%% \epsfbox{filename.ps}
+%%%
+%%% Alternatively, you can supply your own
+%%% bounding box by
+%%%
+%%% \epsfbox[0 0 30 50]{filename.ps}
+%%%
+%%% This will not read in the file, and will
+%%% instead use the bounding box you specify.
+%%%
+%%% The effect will be to typeset the figure as
+%%% a TeX box, at the point of your \epsfbox
+%%% command. By default, the graphic will have
+%%% its `natural' width (namely the width of
+%%% its bounding box, as described in
+%%% filename.ps). The TeX box will have depth
+%%% zero.
+%%%
+%%% You can enlarge or reduce the figure by
+%%% using
+%%%
+%%% \epsfxsize = <dimen> \epsfbox{filename.ps}
+%%% or
+%%% \epsfysize = <dimen> \epsfbox{filename.ps}
+%%%
+%%% instead. Then the width of the TeX box will
+%%% be \epsfxsize and its height will be scaled
+%%% proportionately (or the height will be
+%%% \epsfysize and its width will be scaled
+%%% proportionately).
+%%%
+%%% The width (and height) is restored to zero
+%%% after each use, so \epsfxsize or \epsfysize
+%%% must be specified before EACH use of
+%%% \epsfbox.
+%%%
+%%% A more general facility for sizing is
+%%% available by defining the \epsfsize macro.
+%%% Normally you can redefine this macro to do
+%%% almost anything. The first parameter is
+%%% the natural x size of the PostScript
+%%% graphic, the second parameter is the
+%%% natural y size of the PostScript graphic.
+%%% It must return the xsize to use, or 0 if
+%%% natural scaling is to be used. Common uses
+%%% include:
+%%%
+%%% \epsfxsize % just leave the old value alone
+%%% 0pt % use the natural sizes
+%%% #1 % use the natural sizes
+%%% \hsize % scale to full width
+%%% 0.5#1 % scale to 50% of natural size
+%%% \ifnum #1 > \hsize \hsize \else #1\fi
+%%% % smaller of natural, hsize
+%%%
+%%% If you want TeX to report the size of the
+%%% figure (as a message on your terminal when
+%%% it processes each figure), use
+%%% `\epsfverbosetrue'.
+%%%
+%%% If you only want to get the bounding box
+%%% extents, without producing any output boxes
+%%% or \special{}, then use \epsfgetbb{filename}.
+%%% The bounding box corner coordinates are saved
+%%% in the macros \epsfllx, \epsflly, \epsfurx,
+%%% and \epsfury in PostScript units of big
+%%% points.
+%%%
+%%% Revision history:
+%%%
+%%% ---------------------------------------------
+%%% epsf.tex macro file:
+%%% Originally written by Tomas Rokicki of
+%%% Radical Eye Software, 29 Mar 1989.
+%%%
+%%% ---------------------------------------------
+%%% Revised by Don Knuth, 3 Jan 1990.
+%%%
+%%% ---------------------------------------------
+%%% Revised by Tomas Rokicki, 18 Jul 1990.
+%%% Accept bounding boxes with no space after
+%%% the colon.
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, 03 Dec 1991 [2.0].
+%%% Add version number and date typeout.
+%%%
+%%% Use \immediate\write16 instead of \message
+%%% to ensure output on new line.
+%%%
+%%% Handle nested EPS files.
+%%%
+%%% Handle %%BoundingBox: (atend) lines.
+%%%
+%%% Do not quit when blank lines are found.
+%%%
+%%% Add a few percents to remove generation of
+%%% spurious blank space.
+%%%
+%%% Move \special output to
+%%% \epsfspecial{filename} so that other macro
+%%% packages can input this one, then change
+%%% the definition of \epsfspecial to match
+%%% another DVI driver.
+%%%
+%%% Move size computation to \epsfsetsize which
+%%% can be called by the user; the verbose
+%%% output of the bounding box and scaled width
+%%% and height happens here.
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, 05 May 1992 [2.1].
+%%% Wrap \leavevmode\hbox{} around \vbox{} with
+%%% the \special so that \epsffile{} can be
+%%% used inside \begin{center}...\end{center}
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, 09 Dec 1992 [2.2].
+%%% Introduce \epsfshow{true,false} and
+%%% \epsfframe{true,false} macros; the latter
+%%% suppresses the insertion of the PostScript,
+%%% and instead just creates an empty box,
+%%% which may be handy for rapid prototyping.
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, 14 Dec 1992 [2.3].
+%%% Add \epsfshowfilename{true,false}. When
+%%% true, and \epsfshowfalse is specified, the
+%%% PostScript file name will be displayed
+%%% centered in the figure box.
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, 20 June 1993 [2.4].
+%%% Remove non-zero debug setting of \epsfframemargin,
+%%% and change margin handling to preserve EPS image
+%%% size and aspect ratio, so that the actual
+%%% box is \epsfxsize+\epsfframemargin wide by
+%%% \epsfysize+\epsfframemargin high.
+%%% Reduce output of \epsfshowfilenametrue to
+%%% just the bare file name.
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, 13 July 1993 [2.5].
+%%% Add \epsfframethickness for control of
+%%% \epsfframe frame lines.
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, 02 July 1996 [2.6]
+%%% Add missing initialization \epsfatendfalse;
+%%% the lack of this resulted in the wrong
+%%% BoundingBox being picked up, mea culpa, sigh...
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, 25 October 1996 [2.7]
+%%% Update to match changes in from dvips 5-600
+%%% distribution: new user-accessible macros:
+%%% \epsfclipon, \epsfclipoff, \epsfdrafton,
+%%% \epsfdraftoff, change \empty to \epsfempty.
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, 18 May 2002 [2.7.1]
+%%% Add write statements to echo input file
+%%% names. Prior to that change, an error in
+%%% such a file could be quite hard to track
+%%% down: a long list of TeX page numbers could
+%%% suddenly be followed by ``TeX buffer
+%%% capacity'' exceeded, without any indication
+%%% of the file that was responsible.
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, 16 May 2003 [2.7.2]
+%%% Supply two critical percent characters that
+%%% were mistakenly omitted in version 2.7.1,
+%%% and resulted in a small amount of spurious
+%%% horizontal space.
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, 14 Feb 2011 [2.7.3]
+%%% Add previously-missing \space in rwi
+%%% assignments (bug reported 14-Feb-2011 by
+%%% Stefan Rueger <address@hidden>).
+%%%
+%%% ---------------------------------------------
+%%% Revised by Nelson H. F. Beebe
+%%% <address@hidden>, Karl Berry
+%%% <address@hidden>, and Robin Fairbairns
+%%% <address@hidden>,
+%%% 23 July 2005 [2.7.3]
+%%% Add critical \hbox{} wrapper in \epsfsetgraph
+%%% so that \epsfbox{} does not conflict with
+%%% LaTeX center environment when \epsfbox{} is
+%%% surrounded by other horizonal objects.
+%%% Improve macro readability by adding legal,
+%%% but invisible-in-typeset-output, spaces.
+%%% Ensure that verbose status reports come
+%%% inside (filename ...) list.
+%%%
+%%% ---------------------------------------------
+%%% The checksum field above contains a CRC-16
+%%% checksum as the first value, followed by
+%%% the equivalent of the standard UNIX wc
+%%% (word count) utility output of lines,
+%%% words, and characters. This is produced by
+%%% Robert Solovay's checksum utility.",
+%%% }
+%%% ====================================================================
+
+%\immediate \write16 {This is `epsf.tex' v2.0 <02 Dec 1991>}%
+%\immediate \write16 {This is `epsf.tex' v2.1 <05 May 1992>}%
+%\immediate \write16 {This is `epsf.tex' v2.2 <09 Dec 1992>}%
+%\immediate \write16 {This is `epsf.tex' v2.3 <14 Dec 1992>}%
+%\immediate \write16 {This is `epsf.tex' v2.4 <20 June 1993>}%
+%\immediate \write16 {This is `epsf.tex' v2.5 <13 July 1993>}%
+%\immediate \write16 {This is `epsf.tex' v2.6 <02 July 1996>}%
+%\immediate \write16 {This is `epsf.tex' v2.7 <25 October 1996>}%
+%\immediate \write16 {This is `epsf.tex' v2.7.1 <18 May 2002>}%
+%\immediate \write16 {This is `epsf.tex' v2.7.2 <16 May 2003>}%
+%\immediate \write16 {This is `epsf.tex' v2.7.3 <23 July 2005>}%
+\immediate \write16 {This is `epsf.tex' v2.7.4 <14 February 2011>}%
+%
+\newread \epsffilein % file to \read
+\newif \ifepsfatend % need to scan to LAST %%BoundingBox comment?
+\newif \ifepsfbbfound % success?
+\newif \ifepsfdraft % use draft mode?
+\newif \ifepsffileok % continue looking for the bounding box?
+\newif \ifepsfframe % frame the bounding box?
+\newif \ifepsfshow % show PostScript file, or just bounding box?
+\epsfshowtrue % default is to display PostScript file
+\newif \ifepsfshowfilename % show the file name if \epsfshowfalse specified?
+\newif \ifepsfverbose % report what you're making?
+\newdimen \epsfframemargin % margin between box and frame
+\newdimen \epsfframethickness % thickness of frame rules
+\newdimen \epsfrsize % vertical size before scaling
+\newdimen \epsftmp % register for arithmetic manipulation
+\newdimen \epsftsize % horizontal size before scaling
+\newdimen \epsfxsize % horizontal size after scaling
+\newdimen \epsfysize % vertical size after scaling
+\newdimen \pspoints % conversion factor
+%
+\pspoints = 1bp % Adobe points are `big'
+\epsfxsize = 0pt % default value, means `use natural size'
+\epsfysize = 0pt % ditto
+\epsfframemargin = 0pt % default value: frame box flush around picture
+\epsfframethickness = 0.4pt % TeX's default rule thickness
+%
+\def \epsfbox #1{%
+ \global \def \epsfllx {72}%
+ \global \def \epsflly {72}%
+ \global \def \epsfurx {540}%
+ \global \def \epsfury {720}%
+ \def \lbracket {[}%
+ \def \testit {#1}%
+ \ifx \testit \lbracket
+ \let \next = \epsfgetlitbb
+ \else
+ \let \next = \epsfnormal
+ \fi
+ \next{#1}%
+}%
+%
+% We use \epsfgetlitbb if the user specified an explicit bounding box,
+% and \epsfnormal otherwise. Because \epsfgetbb can be called
+% separately to retrieve the bounding box, we move the verbose
+% printing the bounding box extents and size on the terminal to
+% \epsfstatus. Therefore, when the user provided the bounding box,
+% \epsfgetbb will not be called, so we must call \epsfsetsize and
+% \epsfstatus ourselves.
+%
+\def \epsfgetlitbb #1#2 #3 #4 #5]#6{%
+ \epsfgrab #2 #3 #4 #5 .\\%
+ \epsfsetsize
+ \epsfstatus{#6}%
+ \epsfsetgraph{#6}%
+}%
+%
+\def \epsfnormal #1{%
+ \epsfgetbb{#1}%
+ \epsfsetgraph{#1}%
+}%
+%
+\def \epsfgetbb #1{%
+%
+% The first thing we need to do is to open the
+% PostScript file, if possible.
+%
+ \openin\epsffilein=#1
+ \immediate \write16 {(#1}%
+ \ifeof \epsffilein
+ \errmessage{Could not open file #1, ignoring it}%
+ \else %process the file
+ {% %start a group to contain catcode changes
+ % Make all special characters, except space, to be of type
+ % `other' so we process the file in almost verbatim mode
+ % (TeXbook, p. 344).
+ \chardef \other = 12%
+ \def \do ##1{\catcode`##1=\other}%
+ \dospecials
+ \catcode `\ = 10%
+ \epsffileoktrue %true while we are looping
+ \epsfatendfalse %[02-Jul-1996]: add forgotten initialization
+ \loop %reading lines from the EPS file
+ \read \epsffilein to \epsffileline
+ \ifeof \epsffilein %then no more input
+ \epsffileokfalse %so set completion flag
+ \else %otherwise process one line
+ \expandafter \epsfaux \epsffileline :. \\%
+ \fi
+ \ifepsffileok
+ \repeat
+ \ifepsfbbfound
+ \else
+ \ifepsfverbose
+ \immediate \write16 {No BoundingBox comment found in %
+ file #1; using defaults}%
+ \fi
+ \fi
+ }% %end catcode changes
+ \closein\epsffilein
+ \fi %end of file processing
+ \epsfsetsize %compute size parameters
+ \epsfstatus{#1}%
+ \immediate \write16 {)}%
+}%
+%
+% Clipping control:
+\def \epsfclipon {\def \epsfclipstring { clip}}%
+\def \epsfclipoff {\def \epsfclipstring {\ifepsfdraft \space clip\fi}}%
+\epsfclipoff % default for dvips is OFF
+%
+% The special that is emitted by \epsfsetgraph comes from this macro.
+% It is defined separately to allow easy customization by other
+% packages that first \input epsf.tex, then redefine \epsfspecial.
+% This macro is invoked in the lower-left corner of a box of the
+% width and height determined from the arguments to \epsffile, or
+% from the %%BoundingBox in the EPS file itself.
+%
+% This version is for dvips:
+\def \epsfspecial #1{%
+ \epsftmp=10\epsfxsize
+ \divide \epsftmp by \pspoints
+ \ifnum \epsfrsize = 0%
+ \relax
+ \special{PSfile=\ifepsfdraft psdraft.ps\else#1\fi\space
+ llx=\epsfllx\space
+ lly=\epsflly\space
+ urx=\epsfurx\space
+ ury=\epsfury\space
+ rwi=\number\epsftmp\space
+ \epsfclipstring
+ }%
+ \else
+ \epsfrsize=10\epsfysize
+ \divide \epsfrsize by \pspoints
+ \special{PSfile=\ifepsfdraft psdraft.ps\else#1\fi\space
+ llx=\epsfllx\space
+ lly=\epsflly\space
+ urx=\epsfurx\space
+ ury=\epsfury\space
+ rwi=\number\epsftmp\space
+ rhi=\number\epsfrsize
+ \epsfclipstring
+ }%
+ \fi
+}%
+%
+% \epsfframe macro adapted from the TeXbook, exercise 21.3, p. 223, 331.
+% but modified to set the box width to the natural width, rather
+% than the line width, and to include space for margins and rules
+\def \epsfframe #1%
+{%
+ % method for detecting latex suggested by Robin Fairbairns, May 2005.
+ \ifx \documentstyle \epsfundefined
+ \relax
+ \else
+% \leavevmode % so we can put this inside
+ % a latex centered environment
+ % The \leavevmode breaks under plain when this is inside a box,
+ % because it forces the figure to be the entire \hsize. On the
+ % other hand, we need the \leavevmode for it to work in LaTeX,
+ % because the {center} environment works by adjusting TeX's
+ % paragraph parameters.
+ %
+ % Compare the LaTeX sequence
+ % \begin{center}
+ % \epsfbox{tip.eps}q
+ % \end{center}
+ % (needs the \leavevmode to put the q right next to the image)
+ %
+ % with the plain TeX sequence:
+ % \leftline{\vbox{\epsfbox{tip.eps}}q}
+ % (had the q all the way over to the right, when \leavevmode was used)
+ \fi
+ %
+ \setbox0 = \hbox{#1}%
+ \dimen0 = \wd0 % natural width of argument
+ \advance \dimen0 by 2\epsfframemargin % plus width of 2 margins
+ \advance \dimen0 by 2\epsfframethickness % plus width of 2 rule lines
+ \relax
+ \hbox{%
+ \vbox
+ {%
+ \hrule height \epsfframethickness depth 0pt
+ \hbox to \dimen0
+ {%
+ \hss
+ \vrule width \epsfframethickness
+ \kern \epsfframemargin
+ \vbox {\kern \epsfframemargin \box0 \kern \epsfframemargin }%
+ \kern \epsfframemargin
+ \vrule width \epsfframethickness
+ \hss
+ }% end hbox
+ \hrule height 0pt depth \epsfframethickness
+ }% end vbox
+ }% end hbox
+ \relax
+}%
+%
+\def \epsfsetgraph #1%
+{%
+ %
+ % Make the vbox and stick in a \special that the DVI driver can
+ % parse. \vfil and \hfil are used to place the \special origin at
+ % the lower-left corner of the vbox. \epsfspecial can be redefined
+ % to produce alternate \special syntaxes.
+ %
+ \ifvmode \leavevmode \fi
+ \relax
+ \hbox{% so we can put this in \begin{center}...\end{center}
+ \ifepsfframe \expandafter \epsfframe \fi
+ {\vbox to\epsfysize
+ {%
+ \ifepsfshow
+ % output \special{} at lower-left corner of figure box
+ \vfil
+ \hbox to \epsfxsize{\epsfspecial{#1}\hfil}%
+ \else
+ \vfil
+ \hbox to\epsfxsize{%
+ \hss
+ \ifepsfshowfilename
+ {%
+ \epsfframemargin=3pt % local change of margin
+ \epsfframe{{\tt #1}}%
+ }%
+ \fi
+ \hss
+ }%
+ \vfil
+ \fi
+ }%
+ }}%
+ \relax
+ %
+ % Reset \epsfxsize and \epsfysize, as documented above.
+ %
+ \global \epsfxsize = 0pt
+ \global \epsfysize = 0pt
+}%
+%
+% Now we have to calculate the scale and offset values to use.
+% First we compute the natural sizes.
+%
+\def \epsfsetsize
+{%
+ \epsfrsize = \epsfury \pspoints
+ \advance \epsfrsize by -\epsflly \pspoints
+ \epsftsize = \epsfurx \pspoints
+ \advance \epsftsize by -\epsfllx \pspoints
+%
+% If `epsfxsize' is 0, we default to the natural size of the picture.
+% Otherwise we scale the graph to be \epsfxsize wide.
+%
+ \epsfxsize = \epsfsize{\epsftsize}{\epsfrsize}%
+ \ifnum \epsfxsize = 0
+ \ifnum \epsfysize = 0
+ \epsfxsize = \epsftsize
+ \epsfysize = \epsfrsize
+ \epsfrsize = 0pt
+%
+% We have a sticky problem here: TeX doesn't do floating point arithmetic!
+% Our goal is to compute y = rx/t. The following loop does this reasonably
+% fast, with an error of at most about 16 sp (about 1/4000 pt).
+%
+ \else
+ \epsftmp = \epsftsize
+ \divide \epsftmp by \epsfrsize
+ \epsfxsize = \epsfysize
+ \multiply \epsfxsize by \epsftmp
+ \multiply \epsftmp by \epsfrsize
+ \advance \epsftsize by -\epsftmp
+ \epsftmp = \epsfysize
+ \loop
+ \advance \epsftsize by \epsftsize
+ \divide \epsftmp by 2
+ \ifnum \epsftmp > 0
+ \ifnum \epsftsize < \epsfrsize
+ \else
+ \advance \epsftsize -\epsfrsize
+ \advance \epsfxsize \epsftmp
+ \fi
+ \repeat
+ \epsfrsize = 0pt
+ \fi
+ \else
+ \ifnum \epsfysize = 0
+ \epsftmp = \epsfrsize
+ \divide \epsftmp by \epsftsize
+ \epsfysize = \epsfxsize
+ \multiply \epsfysize by \epsftmp
+ \multiply \epsftmp by \epsftsize
+ \advance \epsfrsize by -\epsftmp
+ \epsftmp = \epsfxsize
+ \loop
+ \advance \epsfrsize by \epsfrsize
+ \divide \epsftmp by 2
+ \ifnum \epsftmp > 0
+ \ifnum \epsfrsize < \epsftsize
+ \else
+ \advance \epsfrsize by -\epsftsize
+ \advance \epsfysize by \epsftmp
+ \fi
+ \repeat
+ \epsfrsize = 0pt
+ \else
+ \epsfrsize = \epsfysize
+ \fi
+ \fi
+}%
+%
+% Issue some status messages if the user requested them
+%
+\def \epsfstatus #1{% arg = filename
+ \ifepsfverbose
+ \immediate \write16 {#1: BoundingBox:
+ llx = \epsfllx \space lly = \epsflly \space
+ urx = \epsfurx \space ury = \epsfury \space}%
+ \immediate \write16 {#1: scaled width = \the\epsfxsize \space
+ scaled height = \the\epsfysize}%
+ \fi
+}%
+%
+% We still need to define the tricky \epsfaux macro. This requires
+% a couple of magic constants for comparison purposes.
+%
+{\catcode`\%=12 \global \let \epsfpercent=%\global \def \epsfbblit
{%BoundingBox}}%
+\global \def \epsfatend{(atend)}%
+%
+% So we're ready to check for `%BoundingBox:' and to grab the
+% values if they are found.
+%
+% If we find a line
+%
+% %%BoundingBox: (atend)
+%
+% then we ignore it, but set a flag to force parsing all of the
+% file, so the last %%BoundingBox parsed will be the one used. This
+% is necessary, because EPS files can themselves contain other EPS
+% files with their own %%BoundingBox comments.
+%
+% If we find a line
+%
+% %%BoundingBox: llx lly urx ury
+%
+% then we save the 4 values in \epsfllx, \epsflly, \epsfurx, \epsfury.
+% Then, if we have not previously parsed an (atend), we flag completion
+% and can stop reading the file. Otherwise, we must keep on reading
+% to end of file so that we find the values on the LAST %%BoundingBox.
+\long \def \epsfaux#1#2:#3\\%
+{%
+ \def \testit {#2}% % save second character up to just before colon
+ \ifx#1\epsfpercent % then first char is percent (quick test)
+ \ifx \testit \epsfbblit % then (slow test) we have %%BoundingBox
+ \epsfgrab #3 . . . \\%
+ \ifx \epsfllx\epsfatend % then ignore %%BoundingBox: (atend)
+ \global \epsfatendtrue
+ \else % else found %%BoundingBox: llx lly urx ury
+ \ifepsfatend % then keep parsing ALL %%BoundingBox lines
+ \else % else stop after first one parsed
+ \epsffileokfalse
+ \fi
+ \global \epsfbbfoundtrue
+ \fi
+ \fi
+ \fi
+}%
+%
+% Here we grab the values and stuff them in the appropriate definitions.
+%
+\def \epsfempty {}%
+\def \epsfgrab #1 #2 #3 #4 #5\\{%
+ \global \def \epsfllx {#1}\ifx \epsfllx\epsfempty
+ \epsfgrab #2 #3 #4 #5 .\\\else
+ \global \def \epsflly {#2}%
+ \global \def \epsfurx {#3}\global \def \epsfury {#4}\fi
+}%
+%
+% We default the epsfsize macro.
+%
+\def \epsfsize #1#2{\epsfxsize}%
+%
+% Finally, another definition for compatibility with older macros.
+%
+\let \epsffile = \epsfbox
+\endinput
diff --git a/doc/it/flusso-elaborazione.eps b/doc/it/flusso-elaborazione.eps
new file mode 100755
index 0000000..c9e4c93
--- /dev/null
+++ b/doc/it/flusso-elaborazione.eps
@@ -0,0 +1,420 @@
+%!PS-Adobe-3.0 EPSF-3.0
+%%Creator: cairo 1.12.8 (http://cairographics.org)
+%%CreationDate: Wed Dec 17 19:10:08 2014
+%%Pages: 1
+%%DocumentData: Clean7Bit
+%%LanguageLevel: 2
+%%BoundingBox: 0 -1 366 172
+%%EndComments
+%%BeginProlog
+save
+50 dict begin
+/q { gsave } bind def
+/Q { grestore } bind def
+/cm { 6 array astore concat } bind def
+/w { setlinewidth } bind def
+/J { setlinecap } bind def
+/j { setlinejoin } bind def
+/M { setmiterlimit } bind def
+/d { setdash } bind def
+/m { moveto } bind def
+/l { lineto } bind def
+/c { curveto } bind def
+/h { closepath } bind def
+/re { exch dup neg 3 1 roll 5 3 roll moveto 0 rlineto
+ 0 exch rlineto 0 rlineto closepath } bind def
+/S { stroke } bind def
+/f { fill } bind def
+/f* { eofill } bind def
+/n { newpath } bind def
+/W { clip } bind def
+/W* { eoclip } bind def
+/BT { } bind def
+/ET { } bind def
+/pdfmark where { pop globaldict /?pdfmark /exec load put }
+ { globaldict begin /?pdfmark /pop load def /pdfmark
+ /cleartomark load def end } ifelse
+/BDC { mark 3 1 roll /BDC pdfmark } bind def
+/EMC { mark /EMC pdfmark } bind def
+/cairo_store_point { /cairo_point_y exch def /cairo_point_x exch def } def
+/Tj { show currentpoint cairo_store_point } bind def
+/TJ {
+ {
+ dup
+ type /stringtype eq
+ { show } { -0.001 mul 0 cairo_font_matrix dtransform rmoveto } ifelse
+ } forall
+ currentpoint cairo_store_point
+} bind def
+/cairo_selectfont { cairo_font_matrix aload pop pop pop 0 0 6 array astore
+ cairo_font exch selectfont cairo_point_x cairo_point_y moveto } bind def
+/Tf { pop /cairo_font exch def /cairo_font_matrix where
+ { pop cairo_selectfont } if } bind def
+/Td { matrix translate cairo_font_matrix matrix concatmatrix dup
+ /cairo_font_matrix exch def dup 4 get exch 5 get cairo_store_point
+ /cairo_font where { pop cairo_selectfont } if } bind def
+/Tm { 2 copy 8 2 roll 6 array astore /cairo_font_matrix exch def
+ cairo_store_point /cairo_font where { pop cairo_selectfont } if } bind
def
+/g { setgray } bind def
+/rg { setrgbcolor } bind def
+/d1 { setcachedevice } bind def
+%%EndProlog
+11 dict begin
+/FontType 42 def
+/FontName /DejaVuSans def
+/PaintType 0 def
+/FontMatrix [ 1 0 0 1 0 0 ] def
+/FontBBox [ 0 0 0 0 ] def
+/Encoding 256 array def
+0 1 255 { Encoding exch /.notdef put } for
+Encoding 63 /question put
+Encoding 65 /A put
+Encoding 69 /E put
+Encoding 73 /I put
+Encoding 78 /N put
+Encoding 80 /P put
+Encoding 83 /S put
+Encoding 97 /a put
+Encoding 98 /b put
+Encoding 99 /c put
+Encoding 100 /d put
+Encoding 101 /e put
+Encoding 105 /i put
+Encoding 108 /l put
+Encoding 110 /n put
+Encoding 111 /o put
+Encoding 114 /r put
+Encoding 116 /t put
+Encoding 117 /u put
+Encoding 122 /z put
+Encoding 236 /igrave put
+/CharStrings 22 dict dup begin
+/.notdef 0 def
+/I 1 def
+/n 2 def
+/i 3 def
+/z 4 def
+/a 5 def
+/l 6 def
+/o 7 def
+/e 8 def
+/A 9 def
+/c 10 def
+/r 11 def
+/d 12 def
+/t 13 def
+/question 14 def
+/N 15 def
+/S 16 def
+/igrave 17 def
+/E 18 def
+/b 19 def
+/P 20 def
+/u 21 def
+end readonly def
+/sfnts [
+<0001000000090080000300106376742000691d3900000ddc000001fe6670676d7134766a0000
+0fdc000000ab676c7966478ea3590000009c00000d4068656164f79ac5e70000108800000036
+686865610cb80669000010c000000024686d747864c10d12000010e4000000606c6f63610000
+a9f000001144000000646d61787004850671000011a800000020707265703b07f100000011c8
+0000056800020066fe96046605a400030007001a400c04fb0006fb0108057f0204002fc4d4ec
+310010d4ecd4ec301311211125211121660400fc73031bfce5fe96070ef8f2720629000100c9
+0000019305d50003002eb700af02011c00040410fc4bb0105458b9000000403859ec31002fec
+3001400d30054005500560058f059f05065d13331123c9caca05d5fa2b00000100ba00000464
+047b001300364019030900030e0106870e11b80cbc0a010208004e0d09080b461410fcec32f4
+ec31002f3ce4f4c4ec1112173930b46015cf1502015d0111231134262322061511231133153e
+013332160464b87c7c95acb9b942b375c1c602a4fd5c029e9f9ebea4fd870460ae6564ef0002
+00c100000179061400030007002b400e06be04b100bc020501080400460810fc3cec3231002f
+e4fcec30400b1009400950096009700905015d1333112311331523c1b8b8b8b80460fba00614
+e90000010058000003db04600009009d401a081102030203110708074208a900bc03a9050803
+01000401060a10dc4bb00b544bb00c545b58b90006ffc038594bb0135458b9000600403859c4
+32c411393931002fecf4ec304b5358071005ed071005ed592201404205021602260247024907
+050b080f0b18031b082b08200b36033908300b400140024503400440054308570359085f0b60
+01600266036004600562087f0b800baf0b1b5d005d1321150121152135012171036afd4c02b4
+fc7d02b4fd650460a8fcdb93a80325000002007bffe3042d047b000a002500bc4027191f0b17
+090e00a91706b90e1120861fba1cb923b8118c170c001703180d09080b1f030814452610fcec
+ccd4ec323211393931002fc4e4f4fcf4ec10c6ee10ee11391139123930406e301d301e301f30
+20302130223f27401d401e401f402040214022501d501e501f50205021502250277027851d87
+1e871f8720872185229027a027f0271e301e301f30203021401e401f40204021501e501f5020
+5021601e601f60206021701e701f70207021801e801f80208021185d015d0122061514163332
+363d01371123350e01232226353436332135342623220607353e0133321602bedfac816f99b9
+b8b83fbc88accbfdfb0102a79760b65465be5af3f00233667b6273d9b4294cfd81aa6661c1a2
+bdc0127f8b2e2eaa2727fc00000100c100000179061400030022b7009702010800460410fcec
+31002fec30400d10054005500560057005f00506015d13331123c1b8b80614f9ec0000020071
+ffe30475047b000b0017004a401306b91200b90cb8128c1809120f51031215451810fcecf4ec
+310010e4f4ec10ee3040233f197b007b067f077f087f097f0a7f0b7b0c7f0d7f0e7f0f7f107f
+117b12a019f01911015d012206151416333236353426273200111000232200111000027394ac
+ab9593acac93f00112feeef0f1feef011103dfe7c9c9e7e8c8c7e99cfec8feecfeedfec70139
+011301140138000000020071ffe3047f047b0014001b00704024001501098608880515a90105
+b90c01bb18b912b80c8c1c1b1502081508004b02120f451c10fcecf4ecc4111239310010e4f4
+ece410ee10ee10f4ee1112393040293f1d701da01dd01df01d053f003f013f023f153f1b052c
+072f082f092c0a6f006f016f026f156f1b095d71015d0115211e0133323637150e0123200011
+1000333200072e0123220607047ffcb20ccdb76ac76263d06bfef4fec70129fce20107b802a5
+889ab90e025e5abec73434ae2a2c0138010a01130143feddc497b4ae9e000002001000000568
+05d50002000a00c2404100110100040504021105050401110a030a0011020003030a07110504
+06110505040911030a08110a030a4200030795010381090509080706040302010009050a0b10
+d4c4173931002f3ce4d4ec1239304b5358071005ed0705ed071005ed0705ed071008ed071005
+ed071005ed071008ed5922b2200c01015d40420f010f020f070f080f005800760070008c0009
+07010802060309041601190256015802500c67016802780176027c0372047707780887018802
+800c980299039604175d005d090121013301230321032302bcfeee0225fe7be50239d288fd5f
+88d5050efd1903aefa2b017ffe81000000010071ffe303e7047b0019003f401b00860188040e
+860d880ab91104b917b8118c1a07120d004814451a10fce432ec310010e4f4ec10fef4ee10f5
+ee30400b0f1b101b801b901ba01b05015d01152e0123220615141633323637150e0123220011
+100021321603e74e9d50b3c6c6b3509d4e4da55dfdfed6012d010655a20435ac2b2be3cdcde3
+2b2baa2424013e010e0112013a230000000100ba0000034a047b001100304014060b0700110b
+03870eb809bc070a06080008461210fcc4ec3231002fe4f4ecc4d4cc11123930b450139f1302
+015d012e012322061511231133153e0133321617034a1f492c9ca7b9b93aba85132e1c03b412
+11cbbefdb20460ae66630505000000020071ffe3045a06140010001c003840191ab9000e14b9
+05088c0eb801970317040008024711120b451d10fcecf4ec323231002fece4f4c4ec10c4ee30
+b6601e801ea01e03015d0111331123350e012322021110003332160114163332363534262322
+0603a2b8b83ab17ccbff00ffcb7cb1fdc7a79292a8a89292a703b6025ef9eca8646101440108
+0108014461fe15cbe7e7cbcbe7e700010037000002f2059e0013003840190e05080f03a90011
+01bc08870a0b08090204000810120e461410fc3cc4fc3cc432393931002fecf43cc4ec321139
+3930b2af1501015d01112115211114163b01152322263511233533110177017bfe854b73bdbd
+d5a28787059efec28ffda0894e9a9fd202608f013e00000000020093000003b005f000030024
+0065402b241e0906040a1d13040014861388109517910083021d1a0d0905040a1e010d1c1a04
+1c05010300261a132510dc4bb00c5458b90013ffc03859c4fcecd4ec10ee1139391112391112
+3931002feef6fef4ee10cd11393917393001b679097a0a7a20035d2533152313233534363f01
+3e0135342623220607353e013332161514060f010e01070e01150187cbcbc5bf385a5a393383
+6c4fb3615ec167b8df485a582f27080606fefe01919a65825659355e31596e4643bc3938c29f
+4c8956562f3519153c340000000100c90000053305d500090079401e07110102010211060706
+4207020300af0805060107021c0436071c00040a10fcecfcec11393931002f3cec323939304b
+5358071004ed071004ed5922b21f0b01015d4030360238074802470769026607800207060109
+0615011a06460149065701580665016906790685018a0695019a069f0b105d005d1321011133
+1121011123c901100296c4fef0fd6ac405d5fb1f04e1fa2b04e1fb1f00010087ffe304a205f0
+0027007e403c0d0c020e0b021e1f1e080902070a021f1f1e420a0b1e1f0415010015a1149418
+9511049500942591118c281e0a0b1f1b0700221b190e2d071914222810dcc4ecfcece4111239
+393939310010e4f4e4ec10eef6ee10c6111739304b535807100eed11173907100eed11173959
+22b20f2901015db61f292f294f29035d01152e012322061514161f011e011514042122262735
+1e013332363534262f012e01353424333216044873cc5fa5b377a67ae2d7feddfee76aef807b
+ec72adbc879a7be2ca0117f569da05a4c53736807663651f192bd9b6d9e0302fd04546887e6e
+7c1f182dc0abc6e42600ffffffc7000001a6066610270016ff1d0000120600170000000100c9
+0000048b05d5000b002e401506950402950081089504ad0a05010907031c00040c10fcec32d4
+c4c431002fececf4ec10ee30b21f0d01015d132115211121152111211521c903b0fd1a02c7fd
+3902f8fc3e05d5aafe46aafde3aa0000000200baffe304a40614000b001c0038401903b90c0f
+09b918158c0fb81b971900121247180c06081a461d10fcec3232f4ec31002fece4f4c4ec10c6
+ee30b6601e801ea01e03015d013426232206151416333236013e013332001110022322262715
+23113303e5a79292a7a79292a7fd8e3ab17bcc00ffffcc7bb13ab9b9022fcbe7e7cbcbe7e702
+526461febcfef8fef8febc6164a80614000200c90000048d05d500080013003a401801951000
+95098112100a0802040005190d3f11001c09041410fcec32fcec11173931002ff4ecd4ec3040
+0b0f151f153f155f15af1505015d011133323635342623252132041514042b0111230193fe8d
+9a9a8dfe3801c8fb0101fefffbfeca052ffdcf92878692a6e3dbdde2fda8000200aeffe30458
+047b00130014003b401c030900030e0106870e118c0a01bc14b80c0d0908140b4e0208004615
+10fcecf439ec3231002fe4e432f4c4ec1112173930b46f15c01502015d131133111416333236
+3511331123350e0123222601aeb87c7c95adb8b843b175c1c801cf01ba02a6fd619f9fbea402
+7bfba0ac6663f003a800000100aa04f00289066600030031400901b400b3040344010410dcec
+310010f4ec30004bb009544bb00e545b58bd0004ffc000010004000400403811373859090123
+01016f011a99feba0666fe8a0176000200c100000179047b00030004002c400b04b800bf0204
+010800460510fcec3931002fece43040110404340444041006400650066006700608015d1333
+112313c1b8b85c0460fba0047b00013500b800cb00cb00c100aa009c01a600b8006600000071
+00cb00a002b20085007500b800c301cb0189022d00cb00a600f000d300aa008700cb03aa0400
+014a003300cb000000d9050200f4015400b4009c01390114013907060400044e04b4045204b8
+04e704cd0037047304cd04600473013303a2055605a60556053903c5021200c9001f00b801df
+007300ba03e9033303bc0444040e00df03cd03aa00e503aa0404000000cb008f00a4007b00b8
+0014016f007f027b0252008f00c705cd009a009a006f00cb00cd019e01d300f000ba018300d5
+009803040248009e01d500c100cb00f600830354027f00000333026600d300c700a400cd008f
+009a0073040005d5010a00fe022b00a400b4009c00000062009c0000001d032d05d505d505d5
+05f0007f007b005400a406b80614072301d300b800cb00a601c301ec069300a000d3035c0371
+03db0185042304a80448008f0139011401390360008f05d5019a061407230666017904600460
+0460047b009c00000277046001aa00e904600762007b00c5007f027b000000b4025205cd0066
+00bc00660077061000cd013b01850389008f007b0000001d00cd074a042f009c009c0000077d
+006f0000006f0335006a006f007b00ae00b2002d0396008f027b00f600830354063705f6008f
+009c04e10266008f018d02f600cd03440029006604ee00730000140000960000b70706050403
+0201002c2010b002254964b040515820c859212d2cb002254964b040515820c859212d2c2010
+0720b00050b00d7920b8ffff5058041b0559b0051cb0032508b0042523e120b00050b00d7920
+b8ffff5058041b0559b0051cb0032508e12d2c4b505820b0fd454459212d2cb002254560442d
+2c4b5358b00225b0022545445921212d2c45442d2cb00225b0022549b00525b005254960b020
+6368208a108a233a8a10653a2d00000100000002547a3935de785f0f3cf5001f080000000000
+c990133600000000c9901336f7d6fcae0d72095500000008000000010000000000010000076d
+fe1d00000de2f7d6fa510d7200010000000000000000000000000000001804cd0066025c00c9
+051200ba023900c10433005804e7007b023900c104e5007104ec00710579001004660071034a
+00ba0514007103230037043f009305fc00c9051400870239ffc7050e00c9051400ba04d300c9
+051200ae040000aa023900c100000000000000440000008c0000010400000154000002200000
+034c000003880000042c00000500000005fc00000694000007040000079c00000818000008f0
+0000099800000a9000000aa800000b0800000ba000000c2000000ca400000cf400000d400001
+000000180354002b0068000c000200100099000800000415021600080004b8028040fffbfe03
+fa1403f92503f83203f79603f60e03f5fe03f4fe03f32503f20e03f19603f02503ef8a4105ef
+fe03ee9603ed9603ecfa03ebfa03eafe03e93a03e84203e7fe03e63203e5e45305e59603e48a
+4105e45303e3e22f05e3fa03e22f03e1fe03e0fe03df3203de1403dd9603dcfe03db1203da7d
+03d9bb03d8fe03d68a4105d67d03d5d44705d57d03d44703d3d21b05d3fe03d21b03d1fe03d0
+fe03cffe03cefe03cd9603cccb1e05ccfe03cb1e03ca3203c9fe03c6851105c61c03c51603c4
+fe03c3fe03c2fe03c1fe03c0fe03bffe03befe03bdfe03bcfe03bbfe03ba1103b9862505b9fe
+03b8b7bb05b8fe03b7b65d05b7bb03b78004b6b52505b65d40ff03b64004b52503b4fe03b396
+03b2fe03b1fe03b0fe03affe03ae6403ad0e03acab2505ac6403abaa1205ab2503aa1203a98a
+4105a9fa03a8fe03a7fe03a6fe03a51203a4fe03a3a20e05a33203a20e03a16403a08a4105a0
+96039ffe039e9d0c059efe039d0c039c9b19059c64039b9a10059b19039a1003990a0398fe03
+97960d0597fe03960d03958a410595960394930e05942803930e0392fa039190bb0591fe0390
+8f5d0590bb039080048f8e25058f5d038f40048e25038dfe038c8b2e058cfe038b2e038a8625
+058a410389880b05891403880b03878625058764038685110586250385110384fe0383821105
+83fe0382110381fe0380fe037ffe0340ff7e7d7d057efe037d7d037c64037b5415057b25037a
+fe0379fe03780e03770c03760a0375fe0374fa0373fa0372fa0371fa0370fe036ffe036efe03
+6c21036bfe036a1142056a530369fe03687d036711420566fe0365fe0364fe0363fe0362fe03
+613a0360fa035e0c035dfe035bfe035afe0359580a0559fa03580a035716190557320356fe03
+5554150555420354150353011005531803521403514a130551fe03500b034ffe034e4d10054e
+fe034d10034cfe034b4a13054bfe034a4910054a1303491d0d05491003480d0347fe03469603
+45960344fe0343022d0543fa0342bb03414b0340fe033ffe033e3d12053e14033d3c0f053d12
+033c3b0d053c40ff0f033b0d033afe0339fe033837140538fa033736100537140336350b0536
+1003350b03341e03330d0332310b0532fe03310b03302f0b05300d032f0b032e2d09052e1003
+2d09032c32032b2a25052b64032a2912052a25032912032827250528410327250326250b0526
+0f03250b0324fe0323fe03220f03210110052112032064031ffa031e1d0d051e64031d0d031c
+1142051cfe031bfa031a42031911420519fe031864031716190517fe031601100516190315fe
+0314fe0313fe031211420512fe0311022d05114203107d030f64030efe030d0c16050dfe030c
+0110050c16030bfe030a100309fe0308022d0508fe030714030664030401100504fe03401503
+022d0503fe0302011005022d0301100300fe0301b80164858d012b2b2b2b2b2b2b2b2b2b2b2b
+2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b
+2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b
+2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b
+2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b
+2b002b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b
+2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b
+2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b
+2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b
+2b2b2b2b2b2b2b1d00>
+] def
+/f-0-0 currentdict end definefont pop
+%%Page: 1 1
+%%BeginPageSetup
+%%PageBoundingBox: 0 -1 366 172
+%%EndPageSetup
+q 0 -1 366 173 rectclip q
+0 g
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 141.949 130.645 m 182.324 90.27 l 222.703 130.645 l 182.324 171.023 l
141.949
+ 130.645 l S
+Q q
+0 171.344 366 -172 re W n
+-0.5 172.531 m -0.5 -1.469 l 366.5 -1.469 l 366.5 172.531 l -0.5 172.531
+ l 130.297 127.812 m 139.809 127.812 l 139.809 131.59 l 130.297 131.59 l
+ 137.855 129.703 l 130.297 127.812 l W n
+q
+0 171.344 366 -172 re W n
+[ 1 0 0 1 0 -0.65625 ] concat
+ q
+0 g
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 87.84 130.359 m 138.863 130.359 l S
+ Q
+Q
+Q q
+0 g
+130.297 127.812 m 137.855 129.703 l 130.297 131.59 l 130.297 127.812 l f*
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 130.297 127.812 m 137.855 129.703 l 130.297 131.59 l 130.297 127.812 l S
+Q q
+0 171.344 366 -172 re W n
+-0.5 172.531 m -0.5 -1.469 l 366.5 -1.469 l 366.5 172.531 l -0.5 172.531
+ l 269.188 127.812 m 278.699 127.812 l 278.699 131.59 l 269.188 131.59 l
+ 276.746 129.703 l 269.188 127.812 l W n
+q
+0 171.344 366 -172 re W n
+[ 1 0 0 1 0 -0.65625 ] concat
+ q
+0 g
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 226.734 130.359 m 277.754 130.359 l S
+ Q
+Q
+Q q
+0 g
+269.188 127.812 m 276.746 129.703 l 269.188 131.59 l 269.188 127.812 l f*
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 269.188 127.812 m 276.746 129.703 l 269.188 131.59 l 269.188 127.812 l S
+4.945 149.543 m 2.336 149.543 0.223 147.43 0.223 144.82 c 0.223 114.145
+ l 0.223 111.535 2.336 109.418 4.945 109.418 c 79.969 109.418 l 82.574 109.418
+ 84.691 111.535 84.691 114.145 c 84.691 144.82 l 84.691 147.43 82.574 149.543
+ 79.969 149.543 c 4.945 149.543 l S
+285.312 149.543 m 282.703 149.543 280.59 147.43 280.59 144.82 c 280.59
+113.891 l 280.59 111.281 282.703 109.168 285.312 109.168 c 360.84 109.168
+ l 363.449 109.168 365.562 111.281 365.562 113.891 c 365.562 144.82 l 365.562
+ 147.43 363.449 149.543 360.84 149.543 c 285.312 149.543 l S
+Q q
+0 152.344 366 -132 re W n
+-95.199 152.273 m -95.199 20.82 l 457.016 20.82 l 457.016 152.273 l -95.199
+ 152.273 l 179.891 55.719 m 179.891 48.535 l 185.578 48.535 l 185.578 55.719
+ l 182.734 50.012 l 179.891 55.719 l W n
+q
+0 152.344 366 -132 re W n
+[ 1 0 0 1 0 -0.65625 ] concat
+ q
+0 g
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 182.734 88.453 m 182.734 49.906 l S
+ Q
+Q
+Q q
+21 171.344 293 -168 re W n
+21.961 170.488 m 21.961 3.996 l 313.367 3.996 l 313.367 170.488 l 21.961
+ 170.488 l 109.363 118.598 m 109.363 127.699 l 106.359 127.699 l 106.359
+ 118.598 l 107.859 125.832 l 109.363 118.598 l W n
+q
+21 171.344 293 -168 re W n
+[ 1 0 0 1 0 -0.65625 ] concat
+ q
+0 g
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 139.371 21.672 m 107.859 21.672 l 107.859 127.453 l S
+ Q
+Q
+Q q
+0 g
+109.57 118.301 m 107.684 125.859 l 105.793 118.301 l 109.57 118.301 l f*
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 109.57 118.301 m 107.684 125.859 l 105.793 118.301 l 109.57 118.301 l S
+BT
+10 0 0 10 4.1806 125.86455 Tm
+/f-0-0 1 Tf
+[(I)3(n)9(i)-14(z)-17(i)-13(a)-13(l)-13(i)-14(z)-17(z)-17(a)-12(z)-17(i)
+-14(o)-13(n)9(e)]TJ
+15.95277 1.22084 Td
+[(A)17(n)9(c)8(o)-13(r)-5(a)]TJ
+0.75418 -1.2125 Td
+[(d)10(a)-12(t)17(i)]TJ
+0.80832 -1.25 Td
+(?)Tj
+5.1 2.25 Td
+[(No)]TJ
+-3.89166 -6.45 Td
+[(S)10(\354)]TJ
+-4.27084 -5.57084 Td
+[(E)7(l)-14(a)-12(b)10(o)-14(r)-5(a)-12(z)-17(i)-14(o)-13(n)9(e)]TJ
+15.2625 11.0125 Td
+[(P)20(u)8(l)-13(i)-14(z)-17(i)-14(a)]TJ
+ET
+4.945 149.543 m 2.336 149.543 0.223 147.43 0.223 144.82 c 0.223 114.145
+ l 0.223 111.535 2.336 109.418 4.945 109.418 c 79.969 109.418 l 82.574 109.418
+ 84.691 111.535 84.691 114.145 c 84.691 144.82 l 84.691 147.43 82.574 149.543
+ 79.969 149.543 c 4.945 149.543 l S
+144.965 39.297 m 142.352 39.297 140.234 37.238 140.234 34.699 c 140.234
+ 4.848 l 140.234 2.309 142.352 0.25 144.965 0.25 c 220.035 0.25 l 222.648
+ 0.25 224.766 2.309 224.766 4.848 c 224.766 34.699 l 224.766 37.238 222.648
+ 39.297 220.035 39.297 c 144.965 39.297 l S
+180.824 49.602 m 182.715 42.043 l 184.605 49.602 l 180.824 49.602 l f*
+Q Q
+showpage
+%%Trailer
+end restore
+%%EOF
diff --git a/doc/it/flusso-elaborazione.fig b/doc/it/flusso-elaborazione.fig
new file mode 100755
index 0000000..50c9a20
--- /dev/null
+++ b/doc/it/flusso-elaborazione.fig
@@ -0,0 +1,37 @@
+#FIG 3.2 Produced by xfig version 3.2.5c
+Landscape
+Center
+Metric
+A4
+100.00
+Single
+-2
+1200 2
+2 3 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+ 4819 3540 5460 4181 6101 3540 5460 2899 4819 3540
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 3960 3555 4770 3555
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 6165 3555 6975 3555
+2 4 0 1 0 7 50 -1 -1 0.000 0 0 5 0 0 5
+ 7020 3240 7020 3881 8369 3881 8369 3240 7020 3240
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 5490 4230 5490 5040
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 3
+ 1 1 1.00 60.00 120.00
+ 4905 5355 4275 5355 4275 3600
+2 4 0 1 0 7 50 -1 -1 0.000 0 0 7 0 0 5
+ 3915 3870 3915 3330 1935 3330 1935 3870 3915 3870
+2 4 0 1 0 7 50 -1 -1 0.000 0 0 7 0 0 5
+ 6345 5670 6345 4995 4950 4995 4950 5670 6345 5670
+4 0 0 50 -1 0 12 0.0000 4 135 450 5265 3885 ?\001
+4 0 0 50 -1 0 12 0.0000 4 135 180 6210 3465 No\001
+4 0 0 50 -1 0 12 0.0000 4 135 540 5265 3375 Ancora\001
+4 0 0 50 -1 0 12 0.0000 4 135 360 5265 3630 dati\001
+4 0 0 50 -1 0 12 0.0000 4 135 630 7290 3600 Pulizia\001
+4 0 0 50 -1 0 12 0.0000 4 135 1080 5130 5400 Elaborazione\001
+4 0 0 50 -1 0 12 0.0000 4 135 1440 2205 3645 Inizializzazione\001
+4 0 0 50 -1 0 12 0.0000 4 135 270 5535 4455 Si'\001
diff --git a/doc/it/flusso-elaborazione.pdf b/doc/it/flusso-elaborazione.pdf
new file mode 100755
index 0000000..e7fb855
Binary files /dev/null and b/doc/it/flusso-elaborazione.pdf differ
diff --git a/doc/it/flusso-elaborazione.png b/doc/it/flusso-elaborazione.png
new file mode 100755
index 0000000..4dc9590
Binary files /dev/null and b/doc/it/flusso-elaborazione.png differ
diff --git a/doc/it/flusso-elaborazione.txt b/doc/it/flusso-elaborazione.txt
new file mode 100755
index 0000000..87a5b43
--- /dev/null
+++ b/doc/it/flusso-elaborazione.txt
@@ -0,0 +1,11 @@
+ _______
++------------------+ / Ancora\ No +---------+
+| Inizializzazione | -------> < dati > -------> | Pulizia |
++------------------+ ^ \ ? / +---------+
+ | +--+--+
+ | | Sì
+ | |
+ | V
+ | +--------------+
+ +--+ Elaborazione |
+ +--------------+
diff --git a/doc/it/gawk-it.texi b/doc/it/gawk-it.texi
new file mode 100644
index 0000000..ea3fd2f
--- /dev/null
+++ b/doc/it/gawk-it.texi
@@ -0,0 +1,46902 @@
+% ****************************************************
+% * DO NOT MODIFY THIS FILE!!!! *
+% * It was generated from gawktexi.in by sidebar.awk *
+% * Edit gawktexi.in instead. *
+% ****************************************************
+\language=30
+\input texinfo @c -*-texinfo-*-
address@hidden vim: filetype=texinfo
address@hidden %**start of header (This is for running Texinfo on a region.)
address@hidden gawk-it.info
address@hidden Guida Utente di GNU Awk
address@hidden it
address@hidden %**end of header (This is for running Texinfo on a region.)
+
address@hidden Creazione e manipolazione di testi
address@hidden
+* Gawk: (gawk). Un linguaggio per scandire ed elaborare testi.
address@hidden direntry
address@hidden Programmi di address@hidden individuale
address@hidden
+* awk: (gawk)Avviare gawk. Scansione e processo di testi.
address@hidden direntry
+
address@hidden Enable better indexing, requires texindex from Texinfo 6 or
later.
address@hidden
+\global\usebracesinindexestrue
address@hidden tex
+
address@hidden FOR_PRINT
address@hidden
+\gdef\xrefprintnodename#1{``#1''}
address@hidden tex
address@hidden ifset
+
address@hidden FOR_PRINT
address@hidden With early 2014 texinfo.tex, restore PDF links and colors
address@hidden
+\gdef\linkcolor{0.5 0.09 0.12} % Dark Red
+\gdef\urlcolor{0.5 0.09 0.12} % Also
+\global\urefurlonlylinktrue
address@hidden tex
address@hidden ifclear
+
address@hidden
address@hidden BULLET @bullet{}
address@hidden MINUS @minus{}
address@hidden ifnotdocbook
+
address@hidden
address@hidden BULLET
address@hidden MINUS
address@hidden ifdocbook
+
address@hidden xref-automatic-section-title
+
address@hidden The following information should be updated here only!
address@hidden This sets the edition of the document, the version of gawk it
address@hidden applies to and all the info about who's publishing this edition
+
address@hidden These apply across the board.
address@hidden Aggiornata alla versione del 3 marzo 2017
address@hidden UPDATE-MONTH gennaio 2017
address@hidden VERSION 4.1
address@hidden PATCHLEVEL 4
+
address@hidden added Italian hyphenation stuff
address@hidden o-met-te-re o-met-ten-do}
+
address@hidden GAWKINETTITLE TCP/IP Internetworking with @command{gawk}
address@hidden FOR_PRINT
address@hidden TITLE Programmare efficacemente in awk
address@hidden ifset
address@hidden FOR_PRINT
address@hidden TITLE GAWK: Programmare efficacemente in AWK
address@hidden ifclear
address@hidden SUBTITLE Una Guida Utente per GNU Awk
address@hidden EDITION 4.1
+
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden SMALLPRINT
address@hidden DARKCORNER @address@hidden,1cm}, @image{rflashlight,1cm}}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden DARKCORNER @address@hidden,0.7cm}, @image{rflashlight,0.7cm}}
address@hidden ifset
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden iftex
address@hidden
address@hidden DOCUMENT File Info
address@hidden CHAPTER nodo principale
address@hidden APPENDIX nodo principale
address@hidden SECTION nodo secondario
address@hidden SECTIONS nodi secondari
address@hidden SUBSECTION nodo
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE videata
address@hidden ifinfo
address@hidden
address@hidden DOCUMENT Documento
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE videata
address@hidden ifhtml
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden ifdocbook
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden ifxml
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden ifplaintext
+
address@hidden
address@hidden empty on purpose
address@hidden PART1
address@hidden PART2
address@hidden PART3
address@hidden PART4
address@hidden ifdocbook
+
address@hidden
address@hidden PART1 Parte I:@*
address@hidden PART2 Parte II:@*
address@hidden PART3 Parte III:@*
address@hidden PART4 Parte IV:@*
address@hidden ifnotdocbook
+
address@hidden some special symbols
address@hidden
address@hidden LEQ @address@hidden
address@hidden PI @address@hidden
address@hidden iftex
address@hidden
address@hidden LEQ @inlineraw{docbook, ≤}
address@hidden PI @inlineraw{docbook, &pgr;}
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden LEQ <=
address@hidden PI @i{pi}
address@hidden ifnotdocbook
address@hidden ifnottex
+
address@hidden
address@hidden
address@hidden ii{text}
address@hidden
address@hidden macro
address@hidden ifnotdocbook
address@hidden ifnottex
+
address@hidden
address@hidden ii{text}
address@hidden,<lineannotation>\text\</lineannotation>}
address@hidden macro
address@hidden ifdocbook
+
address@hidden FOR_PRINT
address@hidden FN nome-file
address@hidden FFN Nome-file
address@hidden for Italian plurals {FN}s
address@hidden FNS nomi-file
address@hidden FFNS Nomi-file
address@hidden DF file-dati
address@hidden DDF File-dati
address@hidden PVERSION versione
address@hidden ifclear
address@hidden FOR_PRINT
address@hidden FN nome-file
address@hidden FFN Nome-File
address@hidden for Italian plurals {FN}s
address@hidden FNS nomi-file
address@hidden FFNS Nomi-file
address@hidden DF file-dati
address@hidden DDF File-dati
address@hidden PVERSION Versione
address@hidden ifset
+
address@hidden For HTML, spell out email addresses, to avoid problems with
address@hidden address harvesters for spammers.
address@hidden
address@hidden EMAIL{real,spelled}
+``\spelled\''
address@hidden macro
address@hidden ifhtml
address@hidden
address@hidden EMAIL{real,spelled}
address@hidden
address@hidden macro
address@hidden ifnothtml
+
address@hidden Indexing macros
address@hidden
+
address@hidden cindexawkfunc{name}
address@hidden @code{\name\}
address@hidden macro
+
address@hidden cindexgawkfunc{name}
address@hidden @code{\name\}
address@hidden macro
+
address@hidden ifinfo
+
address@hidden
+
address@hidden cindexawkfunc{name}
address@hidden @code{\name\()}, funzione
address@hidden macro
+
address@hidden cindexgawkfunc{name}
address@hidden @code{\name\()}, funzione (@command{gawk})
address@hidden macro
address@hidden ifnotinfo
+
address@hidden
+Some comments on the layout for TeX.
+1. Use at least texinfo.tex 2016-02-05.07.
address@hidden ignore
+
address@hidden merge the function and variable indexes into the concept index
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden ifinfo
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden iftex
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden ifxml
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden ifdocbook
+
address@hidden If "finalout" is commented out, the printed output will show
address@hidden black boxes that mark lines that are too long. Thus, it is
address@hidden unwise to comment it out when running a master in case there are
address@hidden overfulls which are deemed okay.
+
address@hidden
address@hidden
address@hidden iftex
+
address@hidden
address@hidden
+<para>
+“To boldly go where no man has gone before”
+(“Per arrivare address@hidden dove nessun uomo @`e mai giunto
prima”)
address@hidden un Marchio Registrato della Paramount Pictures
Corporation.</para>
+
+<para>Titolo originale:</para>
address@hidden: Effective AWK address@hidden
address@hidden User's Guide for GNU Awk}
+
+<para>Published by:</para>
+<literallayout class="normal">Free Software Foundation
+51 Franklin Street, Fifth Floor -- Boston, MA 02110-1301 USA
+Tel.: +1-617-542-5942 Fax: +1-617-542-2652 Email: <email>gnu@@gnu.org</email>
+URL: <ulink
url="http://www.gnu.org";>http://www.gnu.org/</ulink></literallayout>
+
+<literallayout class="normal">Copyright © 1989, 1991, 1992, 1993,
1996–2005, 2007, 2009–2017
+Free Software Foundation, Inc.
+All Rights Reserved.
+</literallayout>
+
+</para>Traduzione e revisione:<para>
+<literallayout class="normal">
+Antonio Giovanni Colombo -- <email>azc100(chiocciola)gmail(punto)com</email>
+Marco Curreli -- <email>marcocurreli(chiocciola)tiscali(punto)it</email>
+(Italian Linux Documentation Project (<ulink
url="http://www.pluto.it/ildp";>http://www.pluto.it/ildp/</ulink>)
+</literallayout>
+
+<para>Pubblicato da:</para>
+<literallayout class="normal">Free Software Foundation
+Email: <email>gnu@@gnu.org</email>
+URL: <ulink url="http://www.gnu.org";>http://www.gnu.org/</ulink>
+
+e da:
+Italian Linux Documentation Project (ILDP)
+Email: <emailildp@@pluto.it
+URL: <ulink
url="http://www.pluto.it/ildp";>http://www.pluto.it/ildp/</ulink></literallayout>
+
+<literallayout class="normal">Copyright © 2016
+Free Software Foundation, Inc.
+All Rights Reserved.
+</literallayout>
address@hidden docbook
+
address@hidden
address@hidden
+Copyright @copyright{} 2017 -- Free Software Foundation, Inc.
address@hidden iftex
address@hidden ifnotdocbook
address@hidden 2
+Questa @`e l'Edizione @value{EDITION} di @address@hidden: @value{SUBTITLE}},
+per la versione @address@hidden (o successiva)
+dell'implementazione GNU di AWK.
address@hidden
address@hidden
address@hidden
+(Titolo originale: @i{Gawk: Effective AWK Programming: A User's Guide for GNU
Awk.)}
address@hidden ifnotdocbook
address@hidden ifnotxml
address@hidden ifnottex
+
address@hidden garantito il permesso di copiare, distribuire e/o modificare
questo
+documento seguendo i termini della Licenza per Documentazione Libera
+GNU, Versione 1.3 o ogni versione successiva pubblicata dalla Free
+Software Foundation; con le Sezioni Non Modificabili ``GNU General
+Public License'', con i testi di copertina ``Un Manuale GNU'', e con i
+testi di quarta di copertina come in (a) address@hidden avanti.
address@hidden FOR_PRINT
+Una copia della licenza @`e acclusa nella sezione intitolata
+"Licenza per Documentazione Libera GNU".
address@hidden ifclear
address@hidden FOR_PRINT
+Una copia della licenza
+si address@hidden trovare in internet all'indirizzo
address@hidden://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html,
+il sito web del Progetto GNU}.
address@hidden ifset
+
address@hidden a
address@hidden
+Il testo di quarta di copertina della FSF @`e: address@hidden garantito il
permesso di
+copiare e modificare questo manuale GNU.''
address@hidden enumerate
address@hidden copying
+
address@hidden Comment out the "smallbook" for technical review. Saves
address@hidden considerable paper. Remember to turn it back on *before*
address@hidden starting the page-breaking work.
+
address@hidden 4/2002: Karl Berry recommends commenting out this and the
address@hidden address@hidden odd', and letting users use `texi2dvi -t'
address@hidden if they want to waste paper.
address@hidden @smallbook
+
+
address@hidden Uncomment this for the release. Leaving it off saves paper
address@hidden during editing and review.
address@hidden odd
+
address@hidden GNU Awk
address@hidden
address@hidden @value{TITLE}
address@hidden @value{SUBTITLE}
address@hidden Edizione @value{EDITION}
address@hidden @value{UPDATE-MONTH}
address@hidden Arnold D. Robbins
+
address@hidden
address@hidden Include the Distribution inside the titlepage environment so
address@hidden that headings are turned off. Headings on and off do not work.
+
address@hidden
address@hidden 0pt plus 1filll
+``To boldly go where no man has gone before''
+(``Per arrivare address@hidden dove nessun uomo @`e mai giunto prima'')
address@hidden un Marchio Registrato della Paramount Pictures Corporation. @*
address@hidden sorry, i couldn't resist
address@hidden 1
+Titolo originale:@*
address@hidden: Effective AWK address@hidden
address@hidden User's Guide for GNU Awk}
address@hidden 0
+Published by @strong{Free Software address@hidden
+51 Franklin Street, Fifth Floor -- Boston, MA 02110-1301 USA @*
+Tel.: +1-617-542-5942 -- Fax: +1-617-542-2652 -- Email: @email{gnu@@gnu.org} @*
+URL: @uref{http://www.gnu.org/}
address@hidden 0
address@hidden This one is correct for gawk 3.1.0 from the FSF
+ISBN 1-882114-28-0
address@hidden 0
+Copyright @copyright{} 1989, 1991, 1992, 1993, 1996--2005, 2007, 2009--2017 @*
+Free Software Foundation, Inc.
address@hidden 1
+Traduzione e revisione:@*
+Antonio Giovanni Colombo -- @email{azc100(chiocciola)gmail(punto)address@hidden
+Marco Curreli -- @email{marcocurreli(chiocciola)tiscali(punto)address@hidden
+(Italian Linux Documentation Project -- @uref{http://www.pluto.it/ildp})
address@hidden 1
+Pubblicato da:
+Free Software address@hidden
+Email: @email{gnu@@gnu.org}; URL: @uref{http://www.gnu.org/}
+
+e da:
+Italian Linux Documentation Project (ILDP)@*
+Email: @email{ildp@@pluto.it}; URL: @uref{http://www.pluto.it/ildp}
+
address@hidden
address@hidden 1
address@hidden ifnotdocbook
address@hidden titlepage
+
address@hidden Thanks to Bob Chassell for directions on doing dedications.
address@hidden
address@hidden off
address@hidden
address@hidden }
address@hidden 9
+
address@hidden SMALLPRINT
address@hidden @i{Ai miei genitori, per il loro amore, e per lo splendido
esempio che mi hanno dato.}
address@hidden 1
address@hidden @i{A mia moglie, Miriam, per avermi reso completo.
+Grazie per aver costruito la tua vita insieme a me.}
address@hidden 1
address@hidden @i{Ai nostri figli, Chana, Rivka, Nachum e Malka, per aver
arricchito le nostre vite in misura incalcolabile.}
address@hidden ifclear
+
address@hidden SMALLPRINT
address@hidden @i{Ai miei genitori, per il loro amore,}
address@hidden @i{ e per lo splendido esempio che mi hanno dato.}
address@hidden 1
address@hidden @i{A mia moglie, Miriam, per avermi reso completo.} @*
address@hidden @i{ Grazie per aver costruito la tua vita insieme a me.}
address@hidden 1
address@hidden @i{Ai nostri figli, Chana, Rivka, Nachum e Malka,}
address@hidden @i{per aver arricchito le nostre vite in misura incalcolabile.}
address@hidden ifset
+
address@hidden 1
address@hidden }
address@hidden
address@hidden }
address@hidden
address@hidden on
address@hidden iftex
+
address@hidden
+<dedication>
+<para>Ai miei genitori, per il loro amore, e per lo splendido
+esempio che mi hanno dato.</para>
+<para>A mia moglie Miriam, per avermi reso completo.
+Grazie per aver costruito la tua vita insieme con me.</para>
+<para>Ai nostri figli Chana, Rivka, Nachum e Malka,
+per aver arricchito le nostre vite in misura incalcolabile.</para>
+</dedication>
address@hidden docbook
+
address@hidden
address@hidden off
address@hidden @thispage@ @ @ @address@hidden @| @|
address@hidden @| @| @address@hidden@ @ @ @thispage
address@hidden iftex
+
address@hidden
address@hidden
address@hidden
address@hidden Top
address@hidden Introduzione Generale
address@hidden Preface node should come right after the Top
address@hidden node, in `unnumbered' sections, then the chapter, `What is gawk'.
address@hidden Licensing nodes are appendices, they're not central to AWK.
+
+Questo file documenta @command{awk}, un programma che si address@hidden usare
per
+selezionare dei record determinati in un file ed eseguire azioni su di essi.
+
address@hidden
+Copyright dell'edizione originale @copyright{} 1989, 1991, 1992, 1993,
1996--2005, 2007, 2009--2017 @*
+Free Software Foundation, Inc.
+
address@hidden
+Copyright dell'edizione italiana @copyright{} 2016 -- Free Software
Foundation, Inc.
+
+
address@hidden
+
address@hidden ifnotdocbook
address@hidden ifnotxml
address@hidden ifnottex
+
address@hidden
+* Introduzione3:: Alcune parole gentili riguardo a questo
+ @value{DOCUMENT}.
+* Introduzione4:: Ulteriori parole gentili.
+* Prefazione:: Di cosa tratta questo @value{DOCUMENT};
+ breve storia e ringraziamenti.
+* Per iniziare:: Un'introduzione elementare all'uso di
+ @command{awk}. Come eseguire un programma
+ @command{awk}. Sintassi della riga di
+ comando.
+* Invocare Gawk:: Come eseguire @command{gawk}.
+* Espressioni regolari:: Tutto quel che c'@`e da sapere
+ sull'individuazione di stringhe tramite
+ espressioni regolari.
+* Leggere file:: Come leggere file e manipolare campi.
+* Stampare:: Come stampare usando @command{awk}.
+ Descrizione delle istruzioni @code{print} e
+ @code{printf}. @`E descritta inoltre la
+ ridirezione dell'output.
+* Espressioni:: Le espressioni sono i componenti elementari
+ delle istruzioni.
+* Criteri di ricerca e azioni:: Panoramica sui criteri di ricerca e sulle
+ azioni.
+* Vettori:: La descrizione e l'uso dei vettori. Sono
+ inoltre descritte le istruzioni di controllo
+ relative ai vettori.
+* Funzioni:: Funzioni predefinite e definite dall'utente.
+* Funzioni di libreria:: Una libreria di funzioni di @command{awk}.
+* Programmi di esempio:: Molti programmi @command{awk} con
+ spiegazioni dettagliate.
+* address@hidden avanzate:: Roba per utenti sofisticati, propria di
+ @command{gawk}.
+* Internazionalizzazione:: Come far address@hidden@dotless{i}} che
@command{gawk} parli la
+ vostra lingua.
+* Debugger:: Il debugger di @command{gawk}.
+* Calcolo con precisione arbitraria:: Calcolo con precisione arbitraria in
+ @command{gawk}.
+* Estensioni dinamiche:: Aggiungere nuove funzioni predefinite di
+ @command{gawk}.
+* Storia del linguaggio:: L'evoluzione del linguaggio @command{awk}.
+* Installazione:: Installare @command{gawk} in vari sistemi
+ operativi.
+* Note:: Note riguardo ad aggiunte a @command{gawk}
+ e possibili futuri sviluppi.
+* Concetti fondamentali:: Velocissima introduzione alla
+ programmazione.
+* Glossario:: Spiegazione di alcuni termini poco
+ familiari.
+* Copia:: Il vostro diritto a copiare e distribuire
+ @command{gawk}.
+* Licenza per Documentazione Libera GNU (FDL):: La licenza per questo
+ @value{DOCUMENT}.
+* Indice analitico:: Indice dei concetti e delle variabili.
+
address@hidden
+* Storia:: La storia di @command{gawk} e
+ @command{awk}.
+* Nomi:: Che nome usare per trovare
+ @command{awk}.
+* Questo manuale:: Uso di questo @value{DOCUMENT}.
+ Comprende esempi di file in input
+ utilizzabili.
+* Convenzioni:: Convenzioni tipografiche.
+* Storia del manuale:: Breve storia del progetto GNU e di
+ questo @value{DOCUMENT}.
+* Come contribuire:: Un aiuto per la salvezza del mondo.
+* Ringraziamenti:: Ringraziamenti.
+* Eseguire gawk:: Come eseguire programmi
+ @command{gawk}; comprende la sintassi
+ della riga di comando.
+* Monouso:: Eseguire un breve programma
+ @command{awk} di tipo usa-e-getta.
+* Leggere dal terminale:: Senza uso di file in input (input
+ immesso da tastiera).
+* Lunghi:: Mettere programmi @command{awk}
+ permanenti in file.
+* @dfn{Script} eseguibili:: Preparare programmi @command{awk}
+ da eseguire come @dfn{script}.
+* Commenti:: Aggiungere documentazione a programmi
+ @command{gawk}.
+* Protezione:: Ulteriore discussione di problemi
+ connessi alle protezioni nella shell.
+* Doppi apici in DOS:: Doppi apici in file .BAT Windows
+* File dati di esempio:: File di dati di esempio da usare nei
+ programmi @command{awk} illustrati in
+ questo @value{DOCUMENT}.
+* Molto semplice:: Un esempio molto semplice.
+* Due regole:: Un esempio meno semplice di programma
+ di una riga, che usa due regole.
+* Maggiore sofisticazione:: Un esempio address@hidden complesso.
+* Istruzioni/Righe:: Suddividere o riunire istruzioni
+ su [una o address@hidden righe.
+* Altre address@hidden:: Altre address@hidden di
@command{awk}.
+* Quando:: Quando usare @command{gawk} e quando
+ usare altre cose.
+* Sommario dell'introduzione:: Sommario dell'introduzione.
+* Riga di comando:: Come eseguire @command{awk}.
+* Opzioni:: Opzioni sulla riga di comando e loro
+ significato.
+* Altri argomenti:: Nomi dei file in input e assegnamento
+ di valori a variabili.
+* Specificare lo standard input:: Come specificare lo standard input
+ insieme ad altri file.
+* Variabili d'ambiente:: Le variabili d'ambiente usate da
+ @command{gawk}.
+* AWKPATH (Variabile):: Ricerca di programmi @command{awk}
+ in una lista di directory.
+* AWKLIBPATH (Variabile):: Ricerca di librerie condivise
+ @command{awk} in una lista di
+ directory.
+* Altre variabili d'ambiente:: Le variabili d'ambiente.
+* Codice di ritorno:: Il codice di ritorno all'uscita
+ da @command{gawk}.
+* Includere file:: Come includere altri file nel
+ proprio programma.
+* Caricare librerie condivise:: Caricare librerie condivise nel
+ proprio programma.
+* Parti obsolete:: Opzioni e/o address@hidden obsolete.
+* Non documentato:: Opzioni e address@hidden non
documentate.
+* Sommario invocazione:: Sommario di come eseguire
+ @command{awk}.
+* Uso di @dfn{regexp}:: Come usare le espressioni regolari.
+* Sequenze di protezione:: Come scrivere caratteri non stampabili.
+* Operatori di espressioni regolari:: Operatori di espressioni regolari.
+* Espressioni tra parentesi quadre:: Cosa possono contenere @samp{[...]}.
+* address@hidden lungo da sinistra:: Quanto @`e lungo il testo
individuato.
+* Espressioni regolari calcolate:: Usare @dfn{regexp} dinamiche.
+* Operatori di @dfn{regexp} GNU:: Operatori propri del software GNU.
+* Maiuscolo-Minuscolo:: Fare confronti ignorando
+ maiuscolo/minuscolo.
+* Sommario espressioni regolari:: Sommario delle espressioni regolari.
+* Record:: Controllare come i dati sono suddivisi
+ in record.
+* awk divisione record:: Divisione dei record con @command{awk}
+ standard.
+* gawk divisione record:: Divisione dei record con
@command{gawk}.
+* Campi:: Un'introduzione ai campi.
+* Campi non costanti:: Numeri di campo variabili.
+* Cambiare i campi:: Cambiare il contenuto di un campo.
+* Separatori di campo:: I separatori di campo, e come
+ cambiarli.
+* Separatori di campo di default:: Come di solito sono separati i campi.
+* Separare campi con @dfn{regexp}:: Usare @dfn{regexp} come separatori.
+* Campi di un solo carattere:: Fare di ogni carattere un campo
+ separato.
+* Separatori campo da riga di comando:: Impostare @code{FS} dalla riga di
+ comando.
+* Campo intera riga:: Fare di una riga intera un campo
+ solo.
+* Sommario sulla separazione campi:: Alcuni punti finali e una tavola di
+ sommario.
+* Dimensione costante:: Leggere campi di larghezza costante.
+* Separazione in base al contenuto:: Definire campi dal loro Contenuto.
+* Righe multiple:: Record su righe multiple
+* Getline:: Richiedere input usando @code{getline}.
+* Getline semplice:: Usare @code{getline} senza argomenti.
+* Getline variabile:: Usare @code{getline} in una variabile.
+* Getline file:: Usare @code{getline} da un file.
+* Getline variabile file:: Usare @code{getline} in una variabile
+ da un file.
+* Getline @dfn{pipe}:: Usare @code{getline} da una @dfn{pipe}.
+* Getline variabile @dfn{pipe}:: Usare @code{getline} in una variabile
+ da una @dfn{pipe}.
+* Getline coprocesso:: Usare @code{getline} da un coprocesso.
+* Getline variabile coprocesso:: Usare @code{getline} in una variabile
+ da un coprocesso.
+* Note su getline:: Cose importanti da sapere su
+ @code{getline}.
+* Sommario di getline:: Sommario delle varianti di
+ @code{getline}.
+* Timeout in lettura:: Leggere input entro un tempo limite.
+* Proseguire dopo errore in input:: Rielaborare input dopo certi errori.
+* Directory su riga di comando:: Cosa accade se si mette una directory
+ sulla riga di comando.
+* Sommario di Input:: Sommario di Input.
+* Esercizi su Input:: Esercizi.
+* Print:: L'istruzione @code{print}.
+* Esempi su print:: Semplici esempi di
+ istruzioni @code{print}.
+* Separatori di output:: I separatori di output e come
+ modificarli.
+* OFMT:: Controllare l'output di numeri con
+ @code{print}.
+* Printf:: L'istruzione @code{printf}.
+* Printf Fondamenti:: Sintassi dell'istruzione
+ @code{printf}.
+* Lettere di controllo:: Lettere di controllo del formato.
+* Modificatori di formato:: Modificatori specifiche di formato.
+* Esempi su printf:: Numerosi esempi.
+* Ridirezione:: Come ridirigere l'output a diversi
+ file e @dfn{pipe}.
+* FD speciali:: File speciali per I/O.
+* File speciali:: Interpretazione @value{FNS} in
+ @command{gawk}. @command{gawk}
+ permette di accedere a descrittori di
+ file ereditati.
+* Altri file ereditati:: Accedere ad altri file aperti con
+ @command{gawk}.
+* Reti speciali:: File speciali per comunicazioni con
+ la rete.
+* Avvertimenti speciali:: Cose a cui prestare attenzione.
+* Chiusura file e @dfn{pipe}:: Chiudere file in input e di output e
+ @dfn{pipe}.
+* Continuazione dopo errori:: Abilitare continuazione dopo errori
+ in output.
+* Sommario di Output:: Sommario di Output.
+* Esercizi su Output:: Esercizi.
+* Valori:: Costanti, variabili ed espressioni
+ regolari.
+* Costanti:: Costanti di tipo stringa, numeriche ed
+ espressioni regolari.
+* Costanti scalari:: Costanti numeriche e stringhe.
+* Numeri non-decimali:: Cosa sono i numeri ottali ed
+ esadecimali.
+* Costanti come espressioni regolari:: Costanti fornite tramite espressioni
+ regolari.
+* Usare le costanti @dfn{regexp}:: Quando e come usare una costante
+ specificata tramite espressioni
+ regolari
+* Costanti @dfn{regexp} normali:: Costanti @dfn{regexp} normali in
+ @command{awk}.
+* Costanti @dfn{regexp} forti:: Costanti @dfn{regexp} fortemente
+ tipizzate.
+* Variabili:: Le variabili permettono di
+ definire valori da usare in seguito.
+* Usare variabili:: Usare variabili nei propri programmi.
+* Opzioni di assegnamento:: Impostare variabili dalla riga di
+ comando, e un sommario della sintassi
+ della riga di comando.
+ Questo @`e un metodo di input avanzato.
+* Conversione:: La conversione di stringhe in numeri
+ e viceversa.
+* Stringhe e numeri:: Come @command{awk} converte tra
+ stringhe e numeri.
+* Localizzazione e conversioni:: Come la localizzazione address@hidden
influire
+ sulle conversioni.
+* Tutti gli operatori:: Gli operatori di @command{gawk}.
+* Operatori aritmetici:: Operazioni aritmetiche (@samp{+},
+ @samp{-}, etc.)
+* Concatenazione:: Concatenazione di stringhe.
+* Operatori di assegnamento:: Cambiare il valore di una variabile
+ o di un campo.
+* Operatori di incremento:: Incrementare il valore numerico di una
+ variabile.
+* Valori e condizioni di address@hidden:: Determinare Vero/Falso.
+* Valori di address@hidden:: Cosa @`e ``vero'' e cosa @`e
``falso''.
+* Tipi di variabile e confronti:: Come alle variabili si assegna il tipo
+ e l'effetto che questo ha sul confronto
+ di numeri e stringhe con @samp{<}, etc.
+* Tipi di variabile:: Tipo stringa rispetto a tipo numero.
+* Operatori di confronto:: Gli operatori di confronto.
+* Confronto POSIX di stringhe:: Confronto tra stringhe usando le
+ regole POSIX.
+* Operatori booleani:: Combinare espressioni di confronto
+ usando operatori booleani @samp{||}
+ (``or''), @samp{&&} (``and'') e
+ @samp{!} (``not'').
+* Espressioni condizionali:: Le espressioni condizionali scelgono
+ una tra due sottoespressioni, a
+ seconda del valore di una terza
+ sottoespressione.
+* Chiamate di funzione:: Una chiamata di funzione @`e
+ un'espressione.
+* Precedenza:: Come si nidificano i vari operatori.
+* Localizzazioni:: Come la localizzazione influenza la
+ gestione dati.
+* Sommario delle espressioni:: Sommario delle espressioni.
+* Panoramica sui criteri di ricerca:: Come scrivere un criterio di ricerca.
+* @dfn{regexp} come criteri di ricerca:: Espressioni regolari come criteri
+ di ricerca.
+* Espressioni come criteri di ricerca:: Qualsiasi espressione address@hidden
servire da
+ criterio di ricerca.
+* Intervalli:: Specificare intervalli di record con i
+ criteri di ricerca.
+* BEGIN/END:: Specificare regole di inizio e fine
+ programma.
+* Usare BEGIN/END:: Come e perch@'e usare regole BEGIN/END.
+* I/O e BEGIN/END:: Problemi di I/O nelle regole BEGIN/END.
+* BEGINFILE/ENDFILE:: Due condizioni speciali per controlli
+ avanzati.
+* Vuoto:: Il criterio di ricerca vuoto, che
+ corrisponde a ogni record.
+* Usare variabili di shell:: Come usare variabili di shell in
+ @command{awk}.
+* Panoramica sulle azioni:: Cosa costituisce un'azione.
+* Istruzioni:: Descrizione dettagliata delle varie
+ istruzioni di controllo.
+* Istruzione if:: Eseguire in maniera condizionale
+ istruzioni @command{awk}.
+* Istruzione while:: Eseguire il ciclo, finch@'e @`e
+ verificata una condizione.
+* Istruzione do:: Eseguire l'azione specificata,
continuare
+ a eseguire il ciclo
+ finch@'e @`e verificata una condizione.
+* Istruzione for:: Un'altra istruzione iterativa, che
+ permette di specificare clausole
+ iniziali e di incremento.
+* Istruzione switch:: Valutazione di quale insieme di
+ istruzioni eseguire, a seconda del
+ valore assunto da una variabile.
+* Istruzione break:: Uscire subito dal ciclo address@hidden
interno
+ in cui ci si trova.
+* Istruzione continue:: Andare alla fine del ciclo
address@hidden interno
+ in cui ci si trova.
+* Istruzione next:: Smettere di elaborare il record
+ corrente.
+* Istruzione nextfile:: Smettere di elaborare il file
+ corrente.
+* Istruzione exit:: Interrompere l'esecuzione di
@command{awk}.
+* Variabili predefinite:: Sommario delle variabili predefinite.
+* Variabili modificabili dall'utente:: Variabili predefinite modificabili per
+ controllare @command{awk}.
+* Variabili auto-assegnate:: Variabili predefinite con cui
+ @command{awk} fornisce informazioni.
+* ARGC e ARGV:: Modi di usare @code{ARGC} e
+ @code{ARGV}.
+* Sommario criteri e azioni:: Sommario criteri e azioni.
+* Fondamenti sui vettori:: Informazioni di base sui vettori.
+* Introduzione ai vettori:: Introduzione ai vettori.
+* Visitare elementi:: Come esaminare un elemento di un
+ vettore.
+* Impostare elementi:: Come cambiare un elemento di un
+ vettore.
+* Esempio di vettore:: Esempio semplice di vettore
+* Visitare un intero vettore:: Variazione dell'istruzione
+ @code{for}. Cicla attraverso gli
+ indici degli elementi contenuti in
+ un vettore.
+* Controllare visita:: Controllare l'ordine in cui i vettori
+ sono visitati.
+* Indici numerici di vettore:: Come usare numeri come indici in
+ @command{awk}.
+* Indici non inizializzati:: Usare variabili non inizializzate
+ come indici.
+* Cancellazione:: L'istruzione @code{delete} toglie un
+ elemento da un vettore.
+* Vettori multidimensionali:: Emulare vettori multidimensionali in
+ @command{awk}.
+* Visitare vettori multidimensionali:: Visitare vettori multidimensionali.
+* Vettori di vettori:: Vettori multidimensionali veri.
+* Sommario dei vettori:: Sommario dei vettori.
+* Funzioni predefinite:: Riepilogo delle funzioni predefinite.
+* Chiamare funzioni predefinite:: Come chiamare funzioni predefinite.
+* Funzioni numeriche:: Funzioni che trattano numeri, comprese
+ @code{int()}, @code{sin()}
+ e @code{rand()}.
+* Funzioni per stringhe:: Funzioni di manipolazione di stringhe,
+ come @code{split()}, @code{match()}
+ e @code{sprintf()}.
+* Dettagli ostici:: address@hidden di quel che si vorrebbe
sapere su
+ @samp{\} e @samp{&} con @code{sub()},
+ @code{gsub()}, e @code{gensub()}.
+* Funzioni di I/O:: Funzioni per i file e per i comandi
+ della shell.
+* Funzioni di tempo:: Funzione per gestire marcature
temporali.
+* Funzioni a livello di bit:: Funzioni per operazioni di
+ manipolazione bit.
+* Funzioni per i tipi:: Funzioni per conoscere il tipo
+ di una variabile.
+* Funzioni di internazionalizzazione:: Funzioni per tradurre stringhe.
+* Funzioni definite dall'utente:: Descrizione dettagliata delle funzioni
+ definite dall'utente.
+* Sintassi delle definizioni:: Come scrivere definizioni e cosa
+ significano.
+* Esempio di funzione:: Un esempio di definizione di
+ funzione e spiegazione della stessa.
+* Precisazioni sulle funzioni:: Cose a cui prestare attenzione.
+* Chiamare una funzione:: Non usare spazi.
+* Campo di address@hidden variabili:: Variabili locali e globali.
+* Parametri per valore/riferimento:: Passaggio parametri.
+* Istruzione return:: Specificare il valore che una
+ funzione restituisce.
+* Variabili di tipo dinamico:: Come cambiare tipo a una variabile in
+ fase di esecuzione del programma.
+* Chiamate indirette:: Scegliere la funzione da chiamare in
+ fase di esecuzione del programma.
+* Sommario delle funzioni:: Sommario delle funzioni.
+* Nomi di variabili di libreria:: Che nomi @`e meglio dare alle variabili
+ private globali nelle funzioni di
+ libreria
+* Funzioni di tipo generale:: Funzioni di uso generale.
+* Funzione strtonum:: Da usare se non @`e disponibile la
+ funzione predefinita
+ @code{strtonum()}.
+* Funzione assert:: Una funzione per controllare
+ affermazioni in programmi
+ @command{awk}.
+* Funzione round:: Una funzione per eseguire
+ arrotondamenti se @code{sprintf()}
+ non lo fa correttamente.
+* Funzione random Cliff:: Il generatore Cliff di numeri casuali.
+* Funzioni ordinali:: Funzioni per usare caratteri come
+ numeri e viceversa.
+* Funzione join:: Una funzione per raccogliere un
+ vettore in una stringa.
+* Funzione getlocaltime:: Una funzione per ottenere data e
+ ora nel formato desiderato.
+* Funzione readfile:: Una funzione per leggere un file
+ intero in un colpo solo.
+* Apici alla shell:: Una funzione per passare stringhe
+ con apici alla shell.
+* Gestione File Dati:: Funzioni for gestire file dati
+ specificati sulla riga di comando,
+* Funzione filetrans:: Una funzione per gestire il passaggio
+ da un file in input al successivo.
+* Funzione rewind:: Una funzione per rileggere il file
+ di input.
+* Controllo di file:: Controllare che i file in input siano
+ accessibili.
+* File vuoti:: Controllare se i file in input sono
+ vuoti.
+* Ignorare assegnamenti di variabili:: Trattare assegnamenti di variabili
+ come nomi di file.
+* Funzione getopt:: Una funzione per trattare argomenti
+ presenti sulla riga di comando.
+* Funzioni Passwd:: Funzioni per ottenete informazioni
+ sull'utente [da /etc/passwd].
+* Funzioni Group:: Funzioni per ottenete informazioni
+ sul gruppo [da /etc/group].
+* Visitare vettori:: Una funzione per visitare vettori
+ di vettori.
+* Sommario funzioni di libreria:: Sommario funzioni di libreria.
+* Esercizi con le librerie:: Esercizi.
+* Eseguire esempi:: Come eseguire i programmi di esempio.
+* Cloni:: Cloni di programmi di address@hidden
comuni.
+* Programma cut:: Il programma di address@hidden
@command{cut}.
+* Programma egrep:: Il programma di address@hidden
@command{egrep}.
+* Programma id:: Il programma di address@hidden
@command{id}.
+* Programma split:: Il programma di address@hidden
@command{split}.
+* Programma tee:: Il programma di address@hidden
@command{tee}.
+* Programma uniq:: Il programma di address@hidden
@command{uniq}.
+* Programma wc:: Il programma di address@hidden
@command{wc}.
+* Programmi vari:: Alcuni interessanti programmi in
+ @command{awk}
+* Programma dupword:: Trovare parole duplicate in un
+ documento.
+* Programma alarm:: Un programma di sveglia.
+* Programma translate:: Un programma simile al comando di
+ address@hidden @command{tr}.
+* Programma labels:: Stampare etichette per lettere.
+* Programma utilizzo parole:: Un programma per produrre un contatore
+ dell'utilizzo di parole in un testo.
+* Programma riordino diario:: Eliminare righe doppie da un file di
+ cronologia.
+* Programma extract:: Estrarre programmi da file sorgenti
+ Texinfo.
+* Programma sed semplice:: Un semplice editor di flusso.
+* Programma igawk:: Un programma per fornire ad
+ @command{awk} la address@hidden di
+ includere file.
+* Programma anagram:: Trovare anagrammi da una lista di
+ parole.
+* Programma signature:: La gente fa cose stupefacenti se ha
+ troppo tempo libero.
+* Sommario dei programmi:: Sommario dei programmi.
+* Esercizi sui programmi:: Esercizi.
+* Dati non decimali:: Consentire dati di input in base
+ diversa da 10.
+* Ordinamento di vettori:: Modi per controllare la visita di un
+ vettore e il suo ordinamento.
+* Controllare visita vettori:: Come usare PROCINFO["sorted_in"].
+* Funzioni di ordinamento di vettori:: Come usare @code{asort()} e
+ @code{asorti()}.
+* I/O bidirezionale:: Comunicazione nei due sensi con un
+ altro processo.
+* Reti TCP/IP:: Usare @command{gawk} per
+ programmazione di rete.
+* Profilare:: Profilare i propri programmi
+ @command{awk}.
+* Sommario address@hidden avanzate:: Sommario address@hidden avanzate.
+* I18N e L10N:: Internazionalizzazione e localiz.
+* Utilizzare @command{gettext}:: Come funziona GNU @code{gettext}.
+* I18N per programmatore:: address@hidden per il programmatore.
+* I18N per traduttore:: address@hidden per il traduttore.
+* Estrazione di stringhe:: Estrarre stringhe marcate.
+* Ordinamento di printf:: Riordinare argomenti @code{printf}
+ [nelle stringhe da tradurre].
+* address@hidden nell'I18N:: Problemi di address@hidden a livello
di
+ @command{awk}.
+* Esempio I18N:: Un semplice esempio di
+ internazionalizzazione.
+* Gawk internazionalizzato:: @command{gawk} stesso @`e
+ internazionalizzato.
+* Sommario I18N:: Sommario sull'internazionalizzazione.
+* Debugging:: Introduzione al debugger di
+ @command{gawk}.
+* Nozioni sul debug:: address@hidden sul debug.
+* Terminologia nel debug:: Concetti fondamentali sul debug.
+* Debug di Awk:: Il debug di @command{awk}.
+* Esempio di sessione di debug:: Esempio di sessione di debug di
+ @command{gawk}.
+* Invocazione del debugger:: Come avviare il debugger.
+* Trovare il bug:: Trovare il bug.
+* Lista dei comandi di debug:: I principali comandi di debug.
+* Controllo dei breakpoint:: Controllo dei punti d'interruzione.
+* Controllo esecuzione debugger:: Controllo di esecuzione.
+* Vedere e modificare dati:: Vedere e modificare dati.
+* Stack di esecuzione:: Lavorare con lo stack.
+* Informazioni sul debugger:: Ottenere informazioni sullo stato
+ del programma e del debugger.
+* Comandi vari del debugger:: Comandi vari del debugger.
+* Supporto per Readline:: Supporto per Readline.
+* Limitazioni:: Limitazioni.
+* Sommario sul debug:: Sommario sul debug.
+* Aritmetica del computer:: Una rapida introduzione alla
matematica del
+ computer.
+* Definizioni matematiche:: Altre cose da sapere.
+* address@hidden MPFR:: address@hidden per il calcolo a
+ precisione arbitraria in @command{gawk}
+* Cautela col calcolo in VM:: Cose da sapere.
+* Inesattezza nei calcoli:: La matematica in virgola mobile non @`e
+ esatta.
+* Rappresentazioni inesatte:: Molti numeri non sono rappresentati
+ esattamente.
+* Confronti tra valori in VM:: Come confrontare valori in virgola
mobile.
+* Gli errori si sommano:: Gli errori diventano sempre maggiori.
+* Ottenere la precisione:: Ottenere la precisione voluta.
+* Tentare di arrotondare:: Tentare di aggiungere bit di
precisione e
+ arrotondare.
+* Impostare la precisione:: Impostare la precisione.
+* Impostare modi di arrotondare:: Impostare la address@hidden di
+ arrotondamento.
+* Interi a precisione arbitraria:: Aritmetica dei numeri interi a
precisione
+ arbitraria con @command{gawk}.
+* Problemi virgola mobile POSIX:: Confronto tra standard e uso corrente.
+* Sommario virgola mobile:: Sommario della trattazione della
+ virgola mobile.
+* Introduzione alle estensioni:: Cos'@`e un'estensione.
+* Licenza delle estensioni:: tipo di licenza delle estensioni.
+* Panoramica sul meccanismo delle estensioni:: Come funziona a grandi linee.
+* Descrizione dell'API delle estensioni:: Una descrizione completa dell'API.
+* Intro funzioni API delle estensioni:: Introduzione alle funzioni dell'API.
+* Tipi di dati generali:: I tipi di dati.
+* Funzioni di allocazione memoria:: Funzioni per allocare memoria.
+* Funzioni di costruzione:: Funzioni per creare valori.
+* Funzioni di registrazione:: Funzioni per registrare cose con
+ @command{gawk}.
+* Funzioni di estensione:: Registrare funzioni di estensione.
+* Funzioni di exit callback:: Registrare una exit di callback.
+* Stringa di versione Estensioni:: Registrare una stringa di versione.
+* Analizzatori di input:: Registrare un analizzatore di input.
+* Processori di output:: Registrare un processore di output.
+* Processori bidirezionali:: Registrare un processore
+ bidirezionale.
+* Stampare messaggi:: Stampare messaggi dalle estensioni.
+* Aggiornare @code{ERRNO}:: Funzioni per aggiornare @code{ERRNO}.
+* Richiedere valori:: Come ottenere un valore.
+* Accedere ai parametri:: Funzioni per acceder ai parametri.
+* Accedere alla tabella simboli:: Funzioni per accedere alle variabili
+ globali.
+* Tabella simboli per nome:: Accedere e aggiornare variabili per
nome.
+* Tabella simboli tramite cookie:: Accedere alle variabili per ``cookie''.
+* Valori nascosti:: Creare e usare valori nascosti.
+* Manipolazione di vettori:: Funzioni per lavorare coi vettori.
+* Tipi di dati per i vettori:: Tipi dati per lavorare coi vettori.
+* Funzioni per i vettori:: Funzioni per lavorare coi vettori.
+* Appiattimento di vettori:: Come appiattire i vettori.
+* Creazione di vettori:: Come creare e popolare vettori.
+* Ridirezione API:: Come accedere alla ridirezioni e
+ modificarle.
+* Variabili dell'estensione API:: Variabili fornite dall'API.
+* Versione dell'estensione:: Informazioni sulla versione API.
+* Variabili informative di estens. API:: Variabili che forniscono informazioni
+ sull'invocazione di @command{gawk}.
+* Codice predefinito di un'estensione API:: Codice predefinito di interfaccia
API.
+* Modifiche dalla versione API 1:: Modifiche dalla versione 1 dell'API.
+* Trovare le estensioni:: Come @command{gawk} trova le
+ estensioni compilate.
+* Esempio di estensione:: Esempio di codice C di un'estensione.
+* Descrizione interna file:: Quello che le nuove funzioni faranno.
+* Operazioni interne file:: Codice per gestire file all'interno.
+* Usare operazioni interne file:: Come usare un'estensione esterna.
+* Esempi di estensione:: Le estensioni di esempio incluse con
+ @command{gawk}.
+* Esempio di estensione funzioni file:: Funzioni relative ai file.
+* Esempio di estensione Fnmatch:: Un'interfaccia a @code{fnmatch()}.
+* Esempio di estensione Fork:: Un'interfaccia a @code{fork()} e
+ altre funzioni di processo.
+* Esempio di estensione Inplace:: Consentire modifica file input
+ nell'estensione.
+* Esempio di estensione Ord:: Conversioni di caratteri in valori
+ numerici e viceversa.
+* Esempio di estensione Readdir:: Un'interfaccia a @code{readdir()}.
+* Esempio di estensione Revout:: Invertire la stringa in output.
+* Esempio di estensione Rev2way:: Esempio di I/O bidirezionale.
+* Esempio di estensione Rwarray:: Scaricare e ricaricare un vettore.
+* Esempio di estensione Readfile:: Leggere un intero file in una stringa.
+* Esempio di estensione Time:: Un'interfaccia a @code{gettimeofday()}
+ e @code{sleep()}.
+* Esempio di estensione API Test:: Test per la API.
+* gawkextlib:: Il progetto @code{gawkextlib}.
+* Sommario delle estensioni:: Sommario delle estensioni.
+* Esercizi sulle estensioni:: Esercizi.
+* V7/SVR3.1:: Le principali differenze tra V7 e
+ System V Release 3.1.
+* SVR4:: Differenze minori tra System V
+ Release 3.1 e 4.
+* POSIX:: Nuove address@hidden per lo standard
+ POSIX.
+* BTL:: Nuove address@hidden dalla versione
+ di @command{awk} di Brian Kernighan.
+* POSIX/GNU:: Le estensioni in @command{gawk} non
+ previste in @command{awk} POSIX.
+* Storia delle address@hidden:: Storia delle address@hidden di
+ @command{gawk}.
+* Estensioni comuni:: Sommario Estensioni comuni.
+* Intervalli e localizzazione:: Come le localizzazioni influiscono
+ sugli intervalli delle espressioni
+ regolari.
+* Contributori:: I maggiori contributori a
+ @command{gawk}.
+* Sommario della storia:: Sommario della storia.
+* Distribuzione di Gawk:: Contenuto della distribuzione di
+ @command{gawk}.
+* Scaricare:: Come ottenere la distribuzione.
+* Scompattazione:: Come estrarre la distribuzione.
+* Contenuti della distribuzione:: Cosa c'@`e nella distribuzione.
+* Installazione Unix:: Installare @command{gawk} su
+ varie versioni di Unix.
+* Installazione veloce:: Compilare @command{gawk} sotto Unix.
+* File da usare a inizio sessione:: Funzioni di personalizzazione shell.
+* Ulteriori opzioni di configurazione:: Altre opzioni utilizzabili in fase
+ di compilazione.
+* Filosofia della configurazione:: Come si suppone che funzioni.
+* Installazione non-Unix:: Installazioni su altri Sistemi
+ Operativi.
+* Installazione su PC:: Installare e compilare
+ @command{gawk} su Microsoft Windows.
+* Installazione binaria su PC:: Installare una distribuzione pronta
+ all'uso.
+* Compilazione su PC:: Compilare @command{gawk} per
+ Windows32.
+* Uso su PC:: Eseguire @command{gawk} su Windows32.
+* Cygwin:: Compilare ed eseguire @command{gawk}
+ per Cygwin.
+* MSYS:: Usare @command{gawk} nell'ambiente
+ MSYS.
+* Installazione su VMS:: Installare @command{gawk} su VMS.
+* Compilazione su VMS:: Come compilare @command{gawk} su
+ VMS.
+* Estensioni dinamiche su VMS:: Compilare estensioni dinamiche
+ di @command{gawk} su VMS.
+* Dettagli installazione su VMS:: Come installare @command{gawk} su
+ VMS.
+* Esecuzione su VMS:: Come eseguire @command{gawk} su VMS.
+* GNV su VMS:: Il progetto GNV di VMS.
+* Vecchio Gawk su VMS:: Una versione non aggiornata arriva
+ con alcune versioni di VMS.
+* Bug:: Notificare problemi e bug.
+* Indirizzo Bug:: Dove notificare problemi.
+* Usenet:: Dove non notificare problemi.
+* Manutentori:: Manutentori di version non-*nix.
+* Altre versioni:: Altre implementazioni di
+ @command{awk} liberamente
+ disponibili.
+* Sommario dell'installazione:: Sommario dell'installazione.
+* address@hidden di address@hidden:: Come inibire alcune estensioni
di
+ @command{gawk}.
+* Aggiunte:: Fare aggiunte a @command{gawk}.
+* Accedere ai sorgenti:: Accedere al deposito sorgenti Git.
+* Aggiungere codice:: Aggiungere codice al programma
+ principale @command{gawk}.
+* Nuovi sistemi:: Rendere disponibile @command{gawk}
+ a un nuovo sistema operativo.
+* File derivati:: Perch@'e i file ancillari sono tenuti
+ nel deposito @command{git}.
+* Future estensioni:: Nuove address@hidden che potranno
+ essere implementate in futuro.
+* Limitazioni dell'implementazione:: Alcune limitazioni
+ dell'implementazione.
+* Progetto delle estensioni:: Note di progetto sull'estensione API.
+* Problemi con le vecchie estensioni:: Problemi con la precedente
+ implementazione di estensioni.
+* Obiettivi delle estensioni:: Obiettivi del nuovo meccanismo.
+* Altre scelte progettuali per le estensioni:: Qualche altra scelta
progettuale.
+* Futuri sviluppi delle estensioni:: address@hidden di crescita futura.
+* Meccanismo delle vecchie estensioni:: Problemi con le vecchie estensioni.
+* Sommario delle note:: Sommario delle note di
+ implementazione.
+* Fondamenti ad alto livello:: Una visione dall'alto.
+* Fondamenti sui tipi di dati:: Una velocissima introduzione ai tipi
+ di dati.
address@hidden detailmenu
address@hidden menu
+
address@hidden dedication for Info file
address@hidden
+Ai miei genitori, per il loro amore, e per lo splendido
+esempio che mi hanno dato.
address@hidden 1
+A mia moglie Miriam, per avermi reso completo.
+Grazie per aver costruito la tua vita insieme a me.
address@hidden 1
+Ai nostri figli Chana, Rivka, Nachum e Malka,
+per aver arricchito le nostre vite in misura incalcolabile.
address@hidden ifinfo
+
address@hidden SMALLPRINT
address@hidden 10
address@hidden ifset
+
address@hidden
address@hidden
+
address@hidden SMALLPRINT
address@hidden 11
address@hidden ifset
+
address@hidden Introduzione3
address@hidden Introduzione alla Terza Edizione
+
address@hidden This bit is post-processed by a script which turns the chapter
address@hidden tag into a preface tag, and moves this stuff to before the title.
address@hidden Bleah.
address@hidden
+ <prefaceinfo>
+ <author>
+ <firstname>Michael</firstname>
+ <surname>Brennan</surname>
+ <!-- can't put mawk into command tags. sigh. -->
+ <affiliation><jobtitle>Autore di mawk</jobtitle></affiliation>
+ </author>
+ <date>Marzo 2001</date>
+ </prefaceinfo>
address@hidden docbook
+
+Arnold Robbins e io siamo buoni amici. Ci siamo conosciuti
address@hidden 11 years ago
+nel 1990 per un insieme di
+circostanze---e per il nostro linguaggio di programmazione preferito, AWK.
+Tutto era iniziato un paio d'anni prima.
+Avevo appena iniziato un nuovo lavoro e avevo notato un computer Unix
scollegato
+che giaceva in un angolo.
+Nessuno sapeva come usarlo, tanto meno io. Comunque,
+qualche giorno address@hidden tardi, stava funzionando, con
+me come @code{root} e solo e unico utente.
+Quel giorno, iniziai la transizione da statistico a programmatore Unix.
+
+In uno dei miei giri per biblioteche e librerie alla ricerca di libri sullo
+Unix, trovai il libro, dalla copertina grigia, su AWK, noto anche come @:
+Alfred V.@: Aho, Brian W.@: Kernighan e
+Peter J.@: Weinberger, @cite{The AWK Programming Language}, (Addison-Wesley,
+1988). Il semplice paradigma di programmazione di AWK
+---trovare un'espressione di ricerca nell'input e di conseguenza compiere
+un'azione---riduceva spesso
+complesse e tediose manipolazioni di dati a poche righe di codice. Ero
+entusiasta di cimentarmi nella programmazione in AWK.
+
address@hidden, l'@command{awk} sul mio computer era una versione limitata del
+linguaggio descritto nel libro grigio. Scoprii che il mio computer aveva il
+``vecchio @command{awk}'' mentre il libro descriveva il ``nuovo
address@hidden''
+Imparai che non era un caso isolato; la vecchia versione si rifiutava di farsi
da
+parte o di cedere il suo nome. Se un sistema aveva un nuovo @command{awk},
+questo era chiamato invariabilmente @command{nawk}, e pochi sistemi lo avevano.
+Il miglior modo per ottenere un nuovo @command{awk} era quello di scaricare via
address@hidden il codice sorgente di @command{gawk} da @code{prep.ai.mit.edu}.
address@hidden era una versione del nuovo @command{awk} scritta da David Trueman
+e Arnold, e disponibile sotto la GNU General Public License.
+
+Per inciso, ora non @`e
address@hidden address@hidden@dotless{i}} difficile trovare un nuovo
@command{awk}. @command{gawk} viene
+fornito con GNU/Linux, e si possono scaricare i binari e il codice sorgente per
+quasi tutti i sistemi; mia moglie usa @command{gawk} nella sua stazione di
lavoro VMS.
+
+Il mio sistema Unix non era inizialmente collegato a una presa di corrente; a
+maggior ragione non era collegato a una rete. address@hidden@dotless{i}},
ignaro dell'esistenza di
address@hidden e in generale della address@hidden di Unix, e desiderando un
nuovo
address@hidden, ne scrissi uno mio, chiamato @command{mawk}. Prima di aver
+finito, scoprii l'esistenza di @command{gawk},
+ma era troppo tardi per fermarmi, address@hidden@dotless{i}} alla fine inviai
un messaggio
+a un newsgroup @code{comp.sources}.
+
+Qualche giorno dopo ricevetti un cordiale messaggio di posta elettronica
+da Arnold che si presentava.
+Propose di scambiarci progetti e algoritmi, e
address@hidden una bozza dello standard POSIX, che mi permise di
+aggiornare @command{mawk} per includere le estensioni al linguaggio
+aggiunte dopo la pubblicazione di @cite{The AWK Programming Language}.
+
+Francamente, se i nostri ruoli fossero stati
+invertiti, io non sarei stato address@hidden@dotless{i}} disponibile e
probabilmente non ci
+saremmo mai incontrati. Sono felice che l'incontro sia avvenuto.
+Lui @`e un vero esperto tra gli esperti di AWK e una persona squisita.
+Arnold mette a disposizione della Free Software Foundation parti significative
+della sua esperienza e del suo tempo.
+
+Questo libro @`e il manuale di riferimento di @command{gawk}, ma
sostanzialmente
address@hidden un libro sulla programmazione in AWK che
address@hidden un vasto pubblico.
address@hidden un riferimento completo al linguaggio AWK come definito dalla
versione del
+1987 di Bell Laboratories e codificato nelle POSIX Utilities
+standard del 1992.
+
+D'altra parte, un programmatore AWK alle prime armi address@hidden studiare
+una address@hidden di programmi pratici che permettono di apprezzare
+la potenza dei concetti di base di AWK:
+flusso di controllo guidato dai dati, ricerca di corrispondenze tramite
+espressioni regolari e vettori associativi.
+Chi desidera qualcosa di nuovo address@hidden provare l'interfaccia di
@command{gawk}
+verso i protocolli di rete attraverso i file speciali @file{/inet}.
+
+I programmi in questo libro evidenziano come un programma AWK sia
+generalmente molto address@hidden piccolo e veloce da sviluppare
+di uno equivalente scritto in C.
+Di conseguenza, @`e spesso conveniente creare un prototipo di un
+algoritmo o di un progetto in AWK per arrivare a eseguirlo in breve tempo e
+scoprire prima i problemi che possono presentarsi. Spesso, l'efficienza di
+questa versione iniziale interpretata @`e sufficiente e il prototipo
+AWK diventa il prodotto finale.
+
+Il nuovo comando @command{pgawk} (profiling @command{gawk}) produce
+conteggi sull'esecuzione delle istruzioni del programma.
+Recentemente ho fatto un tentativo con un algoritmo che, a fronte di
address@hidden
address@hidden
address@hidden ifnotdocbook
address@hidden
address@hidden
address@hidden ifdocbook
+righe di input, produceva il risultato in un tempo
address@hidden
+$\sim\! Cn^2$,
address@hidden tex
address@hidden
address@hidden
+~ C n^2,
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>∼ Cn<superscript>2</superscript></emphasis>
address@hidden docbook
+mentre in teoria
+avrebbe dovuto terminare in un tempo
address@hidden
+$\sim\! Cn\log n$.
address@hidden tex
address@hidden
address@hidden
+~ C n log n.
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>∼ Cn log n</emphasis>
address@hidden docbook
+Dopo qualche minuto di attenta lettura
+del profilo in @file{awkprof.out}, ho ricondotto il problema a
+una singola riga di codice. @command{pgawk} @`e una gradita integrazione
+ai miei strumenti di programmatore.
+
+Arnold ha condensato in questo libro oltre un decennio di esperienza nell'uso
di
+programmi AWK e nello sviluppo di @command{gawk}. Se si vuole usare
+AWK o imparare ad usarlo, @`e consigliabile leggere questo libro.
+
address@hidden
address@hidden Brennan, Michael
address@hidden
+Michael Brennan
+Autore di @command{mawk}
+Marzo 2001
address@hidden display
address@hidden ifnotdocbook
+
address@hidden Introduzione4
address@hidden Introduzione alla Quarta Edizione
+
address@hidden This bit is post-processed by a script which turns the chapter
address@hidden tag into a preface tag, and moves this stuff to before the title.
address@hidden Bleah.
address@hidden
+ <prefaceinfo>
+ <author>
+ <firstname>Michael</firstname>
+ <surname>Brennan</surname>
+ <!-- can't put mawk into command tags. sigh. -->
+ <affiliation><jobtitle>Autore di mawk</jobtitle></affiliation>
+ </author>
+ <date>Ottobre 2014</date>
+ </prefaceinfo>
address@hidden docbook
+
+Ci sono cose che non cambiano. Tredici anni fa scrivevo:
+``Se si vuole usare AWK o imparare ad usarlo, @`e consigliabile
+leggere questo libro.''
+Era vero allora e rimane vero anche oggi.
+
+Imparare a usare un linguaggio di programmazione richiede qualcosa di
address@hidden
+che padroneggiarne la sintassi. Occorre comprendere come
+usare le address@hidden del linguaggio per risolvere problemi pratici di
+programmazione. Uno dei punti address@hidden importanti di questo libro @`e
che
+fornisce molti esempi che mostrano come utilizzare AWK.
+
+Altre cose, invece, cambiano. I nostri computer sono diventati molto
address@hidden
+veloci e la loro memoria @`e molto address@hidden estesa.
+Per questa ragione, la address@hidden di esecuzione e l'uso efficiente della
+memoria, caratteristiche di un linguaggio di livello elevato, hanno minore
+rilevanza.
+Scrivere un programma prototipo in AWK per poi riscriverlo in C per
+migliorare l'utilizzo delle risorse capita sempre meno, perch@'e sempre
address@hidden
+spesso il prototipo @`e abbastanza veloce anche per essere messo in produzione.
+
+Naturalmente, ci sono tipi di calcoli che sono effettuati address@hidden
agevolmente
+da programmi scritti in C o C++.
+Con @command{gawk} 4.1 e successive versioni, non @`e necessario
+decidere se scrivere un programma in AWK oppure in C/C++. Si address@hidden
scrivere
+buona parte del programma in AWK e le parti che richiedono
+specificamente il C/C++ possono essere scritte in C/C++ e quindi il tutto
address@hidden essere eseguito come un programma unico, con il modulo
@command{gawk}
+che carica dinamicamente il modulo C/C++ in fase di esecuzione.
address@hidden Chapter 16
address@hidden
+Il
address@hidden iftex
address@hidden dinamiche},
+spiega la procedura in gran
+dettaglio, e, come prevedibile, riporta molti esempi che sono di aiuto per
+approfondire anche gli aspetti address@hidden complessi.
+
address@hidden per me un piacere programmare in AWK ed @`e stato divertente
(ri)leggere
+questo libro. Penso che address@hidden lo stesso per voi.
+
address@hidden
address@hidden Brennan, Michael
address@hidden
+Michael Brennan
+Autore di @command{mawk}
+Ottobre 2014
address@hidden display
address@hidden ifnotdocbook
address@hidden Prefazione
address@hidden Prefazione
address@hidden I saw a comment somewhere that the preface should describe the
book itself,
address@hidden and the introduction should describe what the book covers.
address@hidden
address@hidden 12/2000: Chuck wants the preface & intro combined.
+
address@hidden This bit is post-processed by a script which turns the chapter
address@hidden tag into a preface tag, and moves this stuff to before the title.
address@hidden Bleah.
address@hidden
+ <prefaceinfo>
+ <author>
+ <firstname>Arnold</firstname>
+ <surname>Robbins</surname>
+ <affiliation><jobtitle>Nof Ayalon</jobtitle></affiliation>
+ <affiliation><jobtitle>Israel</jobtitle></affiliation>
+ </author>
+ <date>Febbraio 2015</date>
+ </prefaceinfo>
address@hidden docbook
+
+Lavorando con file di testo capita di dover eseguire alcuni tipi ripetitivi di
+operazioni. Si potrebbe voler estrarre alcune righe e scartare il resto, o fare
+modifiche laddove siano verificate certe condizioni, lasciando inalterato il
+resto del file. Questi compiti risultano spesso address@hidden agevoli usando
address@hidden Il programma di address@hidden @command{awk} interpreta un
linguaggio
+di programmazione specializzato che rende facile eseguire semplici
address@hidden
+di riformattazione di dati.
+
address@hidden Brian Kernighan, @command{awk} di
+L'implementazione GNU di @command{awk} @`e chiamata @command{gawk}; se
+invocato con le opzioni o con le variabili d'ambiente appropriate,
+(@pxref{Opzioni}), @`e pienamente
+compatibile con le specifiche
address@hidden standard POSIX 2008 @`e accessibile in rete all'indirizzo
address@hidden@url{http://www.opengroup.org/onlinepubs/9699919799/}.}}
+del linguaggio @command{awk}
+e con la versione Unix di @command{awk} mantenuta
+da Brian Kernighan.
address@hidden implica che tutti i programmi
address@hidden scritti correttamente dovrebbero funzionare con @command{gawk}.
address@hidden nella maggior parte dei casi non si distingue tra @command{gawk}
e
+altre implementazioni di @command{awk}.
+
address@hidden @command{awk}, POSIX e, si veda anche POSIX @command{awk}
address@hidden @command{awk}, POSIX e
address@hidden POSIX, @command{awk} e
address@hidden @command{gawk}, @command{awk} e
address@hidden @command{awk}, @command{gawk} e
address@hidden @command{awk}, uso di
+Usando @command{awk} potete:
+
address@hidden @value{BULLET}
address@hidden
+Gestire piccole basi di dati personali
+
address@hidden
+Generare rapporti
+
address@hidden
+Validare dati
+
address@hidden
+Produrre indici ed effettuare altre operazioni per la preparazione di documenti
+
address@hidden
+Sperimentare algoritmi che possono essere adattati in seguito ad altri
+linguaggi per computer
address@hidden itemize
+
address@hidden @command{awk}, si veda anche @command{gawk}
address@hidden @command{gawk}, si veda anche @command{awk}
address@hidden @command{gawk}, uso di
+Inoltre,
address@hidden
+fornisce strumenti che rendono facile:
+
address@hidden @value{BULLET}
address@hidden
+Estrarre frammenti di dati per l'elaborazione
+
address@hidden
+Ordinare dati
+
address@hidden
+Effettuare semplici comunicazioni di rete
+
address@hidden
+Creare il profilo di esecuzione ed effettuare il debug
+di programmi @command{awk}.
+
address@hidden
+Estendere il linguaggio con funzioni scritte in C o C++.
address@hidden itemize
+
+Questo @value{DOCUMENT} spiega il linguaggio @command{awk} e come lo si
address@hidden
+usare efficacemente. @`E richiesta una address@hidden coi comandi di sistema
+di base, come @command{cat} e @command{ls},@footnote{Questi programmi di
address@hidden sono disponibili sui sistemi conformi a POSIX, come pure sui
sistemi
+tradizionali basati su Unix. Se si usa qualche altro sistema operativo, si
+deve comunque avere address@hidden con i concetti di ridirezione I/O e di
address@hidden address@hidden@dotless{i}} come con le address@hidden di base
della shell, come la
+ridirezione, l'input/output (I/O) e le @dfn{pipe}.
+
address@hidden GNU @command{awk}, si veda @command{gawk}
+Implementazioni del linguaggio @command{awk} sono disponibili per diversi
+sistemi operativi di computer. Questo @value{DOCUMENT}, oltre a descrivere il
+linguaggio @command{awk} in generale, descrive anche la specifica
+implementazione di @command{awk} chiamata @command{gawk} (che sta per
+``GNU @command{awk}''). @command{gawk} funziona su una vasta gamma di sistemi
+Unix, dai PC basati su architettura Intel fino
+a sistemi di potenza molto maggiore.
address@hidden @`e stato portato anche su Mac OS X,
+Microsoft Windows
+(tutte le versioni),
+e address@hidden altro sistema operativo obsoleto su cui
address@hidden era stato portato non @`e address@hidden mantenuto e il codice
specifico
+per quei sistemi @`e stato rimosso.}
+
address@hidden
+* Storia:: La storia di @command{gawk} e
+ @command{awk}.
+* Nomi:: Che nome usare per trovare
+ @command{awk}.
+* Questo manuale:: Uso di questo @value{DOCUMENT}.
+ Comprende esempi di file in input
+ utilizzabili.
+* Convenzioni:: Convenzioni tipografiche.
+* Storia del manuale:: Breve storia del Progetto GNU e di
+ questo @value{DOCUMENT}.
address@hidden FOR_PRINT
+* Aggiornamenti:: Come tenersi al corrente.
address@hidden ifset
+* Come contribuire:: Un aiuto per la salvezza del mondo.
+* Ringraziamenti:: Ringraziamenti.
address@hidden menu
+
address@hidden Storia
address@hidden La storia di @command{gawk} e @command{awk}
address@hidden ricetta per un linguaggio di programmazione
address@hidden linguaggio di programmazione, ricetta per un
address@hidden programmazione, ricetta per un linguaggio di
address@hidden sidebar, Ricetta per un linguaggio di programmazione
address@hidden
address@hidden
+<sidebar><title>Ricetta per un linguaggio di programmazione</title>
address@hidden docbook
+
+
address@hidden {2 parti di} {1 parte di @code{egrep}} {1 parte di
@code{snobol}}
address@hidden @tab 1 parte di @code{egrep} @tab 1 parte di @code{snobol}
address@hidden @tab 2 parti di @code{ed} @tab 3 parti di C
address@hidden multitable
+
+Mescolare bene tutte le parti usando @code{lex} e @code{yacc}.
+Preparare una concisa documentazione e distribuire.
+
+Dopo otto anni, aggiungere un'altra parte di @code{egrep} e altre due
+parti di C. Documentare molto bene e distribuire.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Ricetta per un linguaggio di programmazione}
+
+
+
address@hidden {2 parti di} {1 parte di @code{egrep}} {1 parte di
@code{snobol}}
address@hidden @tab 1 parte di @code{egrep} @tab 1 parte di @code{snobol}
address@hidden @tab 2 parti di @code{ed} @tab 3 parti di C
address@hidden multitable
+
+Mescolare bene tutte le parti usando @code{lex} e @code{yacc}.
+Preparare una concisa documentazione e distribuire.
+
+Dopo otto anni, aggiungere un'altra parte di @code{egrep} e altre due
+parti di C. Documentare molto bene e distribuire.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Aho, Alfred
address@hidden Weinberger, Peter
address@hidden Kernighan, Brian
address@hidden @command{awk}, storia di
+Il nome @command{awk} deriva dalle iniziali dei suoi progettisti: Alfred V.@:
+Aho, Peter J.@: Weinberger e Brian W.@: Kernighan. La versione originale di
address@hidden fu scritta nel 1977 negli AT&T Bell Laboratories.
+Nel 1985, una nuova versione rese il linguaggio di programmazione
address@hidden potente, introducendo le funzioni definite dall'utente, flussi
di input
+multipli ed espressioni regolari calcolate.
+Questa nuova versione ebbe larga diffusione con Unix System V
+Release 3.1 (1987).
+La versione in System V Release 4 (1989) ha aggiunto alcune nuove
address@hidden
+e ha fatto pulizia nel comportamento di alcuni degli ``punti oscuri'' del
+linguaggio. Le specifiche per @command{awk} nello standard POSIX Command
+Language and Utilities ha in seguito reso address@hidden chiaro il linguaggio.
Sia i
+progettisti di @command{gawk} che quelli dell'originale @command{awk} dei Bell
+Laboratories hanno collaborato alla formulazione delle specifiche POSIX.
+
address@hidden Rubin, Paul
address@hidden Fenlason, Jay
address@hidden Trueman, David
+Paul Rubin ha scritto @command{gawk}, nel 1986.
+Jay Fenlason l'ha completata, seguendo i consigli di Richard Stallman.
+Anche John Woods ha fornito parti del codice. Nel 1988 e 1989, David Trueman,
+col mio aiuto, ha rivisto completamente @command{gawk} per la address@hidden
+col address@hidden recente @command{awk}.
+Intorno al 1994, sono divenuto il manutentore principale.
+Lo sviluppo corrente @`e incentrato sulla correzione degli errori, sul
+miglioramento delle prestazioni, sulla address@hidden agli standard e,
+occasionalmente, su nuove address@hidden
+
+Nel maggio 1997, J@"urgen Kahrs address@hidden@dotless{i}} la address@hidden
di un accesso alla
+rete da @command{awk}, e con un piccolo aiuto da parte mia, address@hidden ad
+aggiungere address@hidden a @command{gawk} per fare questo. A quel tempo,
+lui scrisse anche il grosso di
address@hidden@value{GAWKINETTITLE}}
+(un documento separato, disponibile come parte della distribuzione
address@hidden). Il suo codice alla fine venne integrato nella distribuzione
+principale di @command{gawk} con la versione 3.1 di @command{gawk}.
+
+John Haque ha riscritto la parte interna di @command{gawk}, mentre metteva a
+punto un debugger a livello di @command{awk}. Questa versione divenne
+disponibile come @command{gawk} versione 4.0 nel 2011.
+
address@hidden
+per un elenco completo di quelli che hanno fornito contributi importanti a
address@hidden
+
address@hidden Nomi
address@hidden Una rosa, con ogni altro nome...
+
address@hidden @command{awk}, nuovo e vecchio
+Il linguaggio @command{awk} si @`e evoluto nel corso degli anni. Tutti i
+dettagli si trovano in @ref{Storia del linguaggio}.
+Il linguaggio descritto in questo @value{DOCUMENT}
+viene spesso citato come ``nuovo @command{awk}''.
+Per analogia, la versione originale di @command{awk} @`e citata
+come ``vecchio @command{awk}.''
+
+Su molti sistemi di uso corrente, eseguendo il programma di address@hidden
address@hidden, si invoca qualche versione del nuovo
address@hidden@footnote{Solo i sistemi Solaris usano ancora un
+vecchio @command{awk} per il programma di address@hidden predefinito
address@hidden Una versione address@hidden moderna di @command{awk} si trova
+nella directory @file{/usr/xpg6/bin} su questi sistemi.} Se
+il comando @command{awk} nel sistema in uso @`e il vecchio, il
+risultato che vedrete per il programma di test che segue @`e
+del tipo:
+
address@hidden
+$ @kbd{awk 1 /dev/null}
address@hidden awk: syntax error near line 1
address@hidden awk: bailing out near line 1
address@hidden example
+
address@hidden
+Se questo @`e il caso, dovreste cercare una versione del nuovo @command{awk},
+o semplicemente installare @command{gawk}!
+
+All'interno di questo @value{DOCUMENT}, quando si fa riferimento a
address@hidden del linguaggio che dovrebbe essere disponibile in ogni
+implementazione completa di @command{awk} POSIX, viene usato il termine
address@hidden Quando si fa riferimento a una address@hidden specifica
+dell'implementazione GNU, viene usato i termine @command{gawk}.
+
address@hidden Questo manuale
address@hidden Uso di questo @value{DOCUMENT}
address@hidden @command{awk}, descrizione dei termini
+
+Il termine @command{awk} si riferisce sia a uno specifico programma sia al
+linguaggio che si usa per dire al programma stesso cosa deve fare. Quando
dobbiamo
+essere precisi, chiamiamo il linguaggio ``il linguaggio @command{awk},''
+e il programma ``l'address@hidden @command{awk}.''
+Questo @value{DOCUMENT} spiega
+sia come scrivere programmi nel linguaggio @command{awk} che come
+eseguire l'address@hidden @command{awk}.
+Il termine ``programma @command{awk}'' si riferisce a un programma scritto
+dall'utente nel linguaggio di programmazione @command{awk}.
+
address@hidden @command{gawk}, @command{awk} e
address@hidden @command{awk}, @command{gawk} e
address@hidden POSIX @command{awk}
+In primo luogo, questo @value{DOCUMENT} spiega le address@hidden di
@command{awk}
+come definite nello standard POSIX, e lo fa nel contesto dell'implementazione
address@hidden Oltre a questo, cerca anche di descrivere le differenze
+significative tra @command{gawk}
+e altre
address@hidden FOR_PRINT
+implementazioni @address@hidden queste differenze
+si trovano nell'indice alla
+voce ``differenze tra @command{awk} e @command{gawk}.''}
address@hidden ifclear
address@hidden FOR_PRINT
+implementazioni @command{awk}.
address@hidden ifset
+Infine, vien fatta rilevare ogni address@hidden di @command{gawk} non
+inclusa nello standard POSIX per @command{awk}.
+
address@hidden
+Questo @value{DOCUMENT} ha il difficile compito di essere tanto una guida
+introduttiva che un manuale di riferimento. I neofiti possono
+tranquillamente saltare i dettagli che sembrano loro troppo complessi.
+Possono anche ignorare i molti riferimenti incrociati, preparati avendo in
+mente gli utenti esperti e per le versioni Info e
address@hidden://www.gnu.org/software/gawk/manual/, HTML}
+del @value{DOCUMENT}.
address@hidden ifnotinfo
+
+Ci sono dei riquadri
+sparsi in tutto il @value{DOCUMENT}.
+Aggiungono una spiegazione address@hidden completa su punti importanti, ma che
+probabilmente non sono di interesse in sede di prima lettura.
address@hidden FOR_PRINT
+Si trovano tutti nell'indice analitico, alla voce ``sidebar.'' @c non c'e
riquadro nell'indice analitico
address@hidden ifclear
+
+La maggior parte delle volte, gli esempi usano programmi @command{awk}
completi.
+Alcune delle @value{SECTIONS} address@hidden avanzate mostrano solo la parte
del programma
address@hidden che illustra il concetto che si sta descrivendo.
+
+Sebbene questo @value{DOCUMENT} sia destinato soprattutto alle persone che non
+hanno una precedente conoscenza di @command{awk}, esso contiene anche tante
+informazioni che anche gli esperti di @command{awk} troveranno utili.
+In particolare, dovrebbero essere d'interesse la descrizione di POSIX
address@hidden e i programmi di esempio
address@hidden
+in
address@hidden ifnottex
address@hidden
+nel
address@hidden iftex
address@hidden di libreria} e
address@hidden
address@hidden
+in
address@hidden ifnottex
address@hidden ifnotdocbook
address@hidden
+nel
address@hidden iftex
address@hidden di esempio}.
+
+Questo @value{DOCUMENT} @`e suddiviso in diverse parti, come segue:
+
address@hidden FULLXREF ON
+
address@hidden @value{BULLET}
address@hidden
+La Parte I descrive il linguaggio @command{awk} e il programma @command{gawk}
+nel dettaglio.
+Inizia con le nozioni di base, e continua con tutte le caratteristiche di
address@hidden Contiene i seguenti capitoli:
+
address@hidden nested
address@hidden @value{MINUS}
address@hidden
address@hidden iniziare},
+fornisce le nozioni minime indispensabili per iniziare a usare @command{awk}.
+
address@hidden
address@hidden Gawk},
+descrive come eseguire @command{gawk}, il significato delle sue
+opzioni da riga di comando e come trovare i file sorgenti del programma
address@hidden
+
address@hidden
address@hidden regolari},
+introduce le espressioni regolari in generale, e in particolare le
address@hidden
+disponibili in @command{awk} POSIX e @command{gawk}.
+
address@hidden
address@hidden file},
+descrive come @command{awk} legge i dati inseriti dall'utente.
+Introduce i concetti di record e campi, e anche il
+comando @code{getline}.
+Contiene una prima descrizione della ridirezione I/O, e una breve descrizione
+dell'I/O di rete.
+
address@hidden
address@hidden,
+descrive come i programmi @command{awk} possono produrre output con
address@hidden e @code{printf}.
+
address@hidden
address@hidden,
+descrive le espressioni, che sono i componenti elementari di base
+per portare a termine la maggior parte delle operazioni in un programma.
+
address@hidden
address@hidden di ricerca e azioni},
+descrive come scrivere espressioni di ricerca per individuare corrispondenze
nei
+record, le azioni da eseguire quando si @`e trovata una corrispondenza
+in un record, e le variabili predefinite di @command{awk} e
address@hidden
+
address@hidden
address@hidden,
+tratta dell'unica struttura di dati di @command{awk}: il vettore associativo.
+Vengono trattati anche l'eliminazione di elementi del vettore e di interi
+vettori, e l'ordinamento dei vettori in @command{gawk}.
+Il @value{CHAPTER} descrive inoltre come @command{gawk} fornisce vettori di
+vettori.
+
address@hidden
address@hidden,
+descrive le funzioni predefinite fornite da @command{awk} e
address@hidden, e spiega come definire funzioni personalizzate. Viene
+anche spiegato come @command{gawk} permetta di invocare funzioni in
+maniera indiretta.
address@hidden itemize
+
address@hidden
+La Parte II illustra come usare @command{awk} e @command{gawk} per la
+risoluzione di problemi. Qui ci sono molti programmi da leggere e da cui
imparare.
+Questa parte contiene i seguenti capitoli:
+
address@hidden nested
address@hidden @value{MINUS}
address@hidden
address@hidden di libreria},
+fornisce diverse funzioni pensate per
+essere usate dai programmi scritti in @command{awk}.
+
address@hidden
address@hidden di esempio},
+fornisce molti programmi @command{awk} di esempio.
address@hidden itemize
+
+La lettura di questi due capitoli permette di capire come
address@hidden address@hidden risolvere problemi pratici.
+
address@hidden
+La Parte III si concentra sulle address@hidden specifiche di @command{gawk}.
+Contiene i seguenti capitoli:
+
address@hidden nested
address@hidden @value{MINUS}
address@hidden
address@hidden@`a avanzate},
+descrive diverse address@hidden avanzate.
+Di particolare rilevanza sono
+la address@hidden di controllare l'ordine di visita dei vettori,
+quella di instaurare comunicazioni bidirezionali con altri processi,
+di effettuare connessioni di rete TCP/IP, e di
+profilare i propri programmi @command{awk}.
+
address@hidden
address@hidden,
+descrive address@hidden speciali per tradurre i messaggi
+di programma in diverse lingue in fase di esecuzione.
+
address@hidden
address@hidden, descrive il debugger di @command{gawk}.
+
address@hidden
address@hidden con precisione arbitraria},
+illustra le address@hidden di calcolo avanzate.
+
address@hidden
address@hidden dinamiche},
+descrive come aggiungere nuove variabili e
+funzioni a @command{gawk} scrivendo estensioni in C o C++.
address@hidden itemize
+
address@hidden
address@hidden FOR_PRINT
+La Parte IV contiene le appendici, il Glossario, e due licenze relative,
+rispettivamente, al codice sorgente di @command{gawk} e a questo
address@hidden Contiene le seguenti appendici:
address@hidden ifclear
+
address@hidden FOR_PRINT
+La Parte IV contiene le seguenti appendici,
+che includono la Licenza per Documentazione Libera GNU:
address@hidden ifset
+
address@hidden @value{MINUS}
address@hidden
address@hidden del linguaggio},
+descrive l'evoluzione del linguaggio @command{awk} dalla sua prima versione
+fino a oggi. Descrive anche come @command{gawk}
+ha acquisito nuove address@hidden col passare del tempo.
+
address@hidden
address@hidden,
+descrive come ottenere @command{gawk}, come compilarlo
+sui sistemi compatibili con POSIX,
+e come compilarlo e usarlo su diversi sistemi
+non conformi allo standard POSIX. Spiega anche come segnalare gli errori
+di @command{gawk} e dove si possono ottenere altre implementazioni
+di @command{awk} liberamente disponibili.
+
address@hidden FOR_PRINT
address@hidden
address@hidden,
+presenta la licenza applicabile al codice sorgente @command{gawk}.
address@hidden ifset
+
address@hidden FOR_PRINT
address@hidden
address@hidden,
+descrive come disabilitare le estensioni @command{gawk},
+come contribuire scrivendo del nuovo codice per @command{gawk},
+e alcune possibili direzioni per il futuro sviluppo di @command{gawk}.
+
address@hidden
address@hidden fondamentali},
+fornisce del materiale di riferimento a livello elementare per chi
+sia completamente digiuno di programmazione informatica.
+
+Il @ref{Glossario}, definisce quasi tutti i termini significativi
+usati all'interno di questo @value{DOCUMENT}. Se si incontrano termini
+coi quali non si ha address@hidden, questo @`e il posto dove cercarli.
+
address@hidden
address@hidden, e
address@hidden per Documentazione Libera GNU (FDL)},
+presentano le licenze che si applicano, rispettivamente, al codice sorgente
+di @command{gawk} e a questo @value{DOCUMENT}.
address@hidden ifclear
address@hidden itemize
address@hidden itemize
+
address@hidden FOR_PRINT
+La versione di questo @value{DOCUMENT} distribuita con @command{gawk}
+contiene ulteriori appendici e altro materiale.
+Per ragioni di spazio, per questa edizione a stampa abbiamo tralasciato alcune
+delle appendici. Si possono trovare in rete ai seguenti indirizzi:
+
address@hidden @value{BULLET}
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/Notes.html,
+L'appendice sulle note di implementazione}
+descrive come disabilitare le estensioni @command{gawk}, come contribuire
+scrivendo del nuovo codice per @command{gawk}, dove reperire informazioni
+su alcune possibili future direzioni dello sviluppo di @command{gawk}, e
+sulle decisioni di progetto che hanno influito sulle estensioni API.
+
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/Basic-Concepts.html,
+L'appendice sui concetti fondamentali}
+fornisce del materiale di riferimento a livello elementare per chi sia
completamente a
+digiuno di programmazione informatica.
+
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/Glossary.html,
+Il Glossario}
+definisce la maggior parte, se non tutti, i termini significativi usati
+nel corso del libro. Se si incontrano termini con cui non si ha
address@hidden,
+questo @`e il posto dove cercarli.
+
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html,
la licenza GNU FDL}
address@hidden la licenza che vale per questo @value{DOCUMENT}.
address@hidden itemize
+
address@hidden ok not to use CHAPTER / SECTION here
+Alcuni dei capitoli hanno sezioni con esercizi; queste sono anche
+state omesse dall'edizione a stampa ma sono disponibili online.
address@hidden ifset
+
address@hidden FULLXREF OFF
+
address@hidden Convenzioni
address@hidden Convenzioni tipografiche
+
address@hidden Texinfo
+Questo @value{DOCUMENT} @`e scritto in
@uref{http://www.gnu.org/software/texinfo/, Texinfo},
+il linguaggio di formattazione della documentazione GNU. Viene usato un unico
+file sorgente Texinfo per produrre sia la versione a stampa della
documentazione
+sia quella online.
address@hidden
+A causa di address@hidden, le convenzioni tipografiche
+sono leggermente diverse da quelle presenti in altri libri che potete aver
letto.
address@hidden ifnotinfo
address@hidden
+Questo @value{SECTION} documenta brevemente le convenzioni tipografiche usate
in Texinfo.
address@hidden ifinfo
+
+Gli esempi da immettere sulla riga di comando sono preceduti dai
+comuni prompt di shell primario e secondario, @samp{$} e @samp{>}.
+L'input che si inserisce viene mostrato @kbd{in questo modo}.
address@hidden 8/2014: @print{} is stripped from the texi to make docbook.
address@hidden FOR_PRINT
+L'output del comando @`e preceduto dal glifo address@hidden'', che
+in genere rappresenta lo standard output del comando.
address@hidden ifclear
address@hidden FOR_PRINT
+L'output del comando, normalmente il suo standard output, @`e stampato
address@hidden questo modo}.
address@hidden ifset
+Messaggi di errore e altri output sullo standard error del comando sono
+preceduti dal glifo address@hidden''. Per esempio:
+
address@hidden
+$ @kbd{echo ciao su stdout}
address@hidden ciao su stdout
+$ @kbd{echo salve su stderr 1>&2}
address@hidden salve su stderr
address@hidden example
+
address@hidden
+Nel testo, quasi tutto address@hidden che riguarda la programmazione,
+per esempio i nomi dei comandi,
+appare in @code{questo font}. I frammenti
+di codice appaiono nello stesso font e tra apici, @samp{in questo modo}.
address@hidden che viene sostituito dall'utente o dal programmatore
+appare in @var{questo font}.
+Le opzioni sono stampate address@hidden@dotless{i}}: @option{-f}.
+I @value{FNS} sono indicati in questo modo: @file{/percorso/al/file}.
address@hidden FOR_PRINT
+Certe cose sono
+evidenziate @emph{in questo modo}, e se un punto dev'essere reso in modo
address@hidden
+marcato, viene evidenziato @strong{in questo modo}.
address@hidden ifclear
+La prima occorrenza di un
+nuovo termine @`e usualmente la sua @dfn{definizione} e appare nello stesso
+font della precedente occorrenza di ``definizione'' in questa frase.
address@hidden ifnotinfo
+
+I caratteri che si battono sulla tastiera sono scritti come @kbd{questi}. In
+particolare, ci sono caratteri speciali chiamati ``caratteri di controllo''.
+Questi sono caratteri che vengono battuti tenendo premuti il tasto
address@hidden e un altro tasto contemporaneamente.
+Per esempio, @kbd{Ctrl-d} @`e battuto premendo e tenendo premuto il tasto
address@hidden, poi premendo il tasto @kbd{d} e infine rilasciando entrambi i
+tasti.
+
+Per amor di address@hidden, in questo @value{DOCUMENT}, la versione di Brian
+Kernighan di @command{awk} address@hidden citata come ``BWK @command{awk}.''
+(@xref{Altre versioni} per informazioni su questa e altre versioni.)
+
address@hidden FOR_PRINT
address@hidden NOTA
+Note interessanti sono stampate in questo modo.
address@hidden quotation
+
address@hidden ATTENZIONE
+Note di avviso o raccomandazioni di cautela sono stampate in questo modo.
address@hidden quotation
address@hidden ifset
+
address@hidden fakenode --- for prepinfo
address@hidden Angoli Bui
address@hidden Kernighan, Brian
address@hidden
address@hidden angoli bui sono essenzialmente frattali---per quanto vengano
+illuminati, ce n'@`e sempre uno address@hidden piccolo e address@hidden buio.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden a.b., si veda angolo buio
address@hidden angolo buio
+Fino allo standard POSIX (e @address@hidden),
+molte caratteristiche di @command{awk} erano poco documentate o
+non documentate affatto. Le descrizioni di queste caratteristiche
+(chiamate spesso ``angoli bui'') sono segnalate in questo @value{DOCUMENT} con
address@hidden
+il disegno di una torcia elettrica nel margine, come mostrato qui.
address@hidden
address@hidden iftex
address@hidden
+``(a.b.)''.
address@hidden ifnottex
address@hidden FOR_PRINT
+Appaiono anche nell'indice sotto la voce ``angolo buio.''
address@hidden ifclear
+
+Ma come osservato nella citazione d'apertura, ogni trattazione degli
+angoli bui @`e per definizione incompleta.
+
address@hidden e.c., si veda estensioni comuni
+Estensioni al linguaggio standard di @command{awk} disponibili in
address@hidden di una
+implementazione di @command{awk} sono segnate
address@hidden FOR_PRINT
address@hidden,'' ed elencate nell'indice sotto ``estensioni comuni''
+e ``comuni, estensioni''.
address@hidden ifclear
address@hidden FOR_PRINT
address@hidden'' per ``estensioni comuni.''
address@hidden ifset
+
address@hidden Storia del manuale
address@hidden Breve storia del Progetto GNU e di questo @value{DOCUMENT}
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden Stallman, Richard
+La Free Software Foundation (FSF) @`e un'organizzazione senza scopo di lucro
+dedita alla produzione e distribuzione di software liberamente distribuibile.
address@hidden stata fondata da Richard M.@: Stallman, l'autore della prima
versione
+dell'editor Emacs. GNU Emacs @`e oggi la versione di Emacs address@hidden
largamente usata.
+
address@hidden Progetto GNU
address@hidden GNU, Progetto
address@hidden GPL (General Public License)
address@hidden General Public License, si veda GPL
address@hidden documentazione, online
+Il Progetto address@hidden sta per ``GNU's Not Unix.''}
address@hidden un progetto della Free Software
+Foundation in continuo sviluppo per creare un ambiente per computer completo,
liberamente
+distribuibile, conforme allo standard POSIX.
+La FSF usa la GNU General Public License (GPL) per assicurare che
+il codice sorgente del loro software sia sempre
+disponibile all'utente finale.
address@hidden FOR_PRINT
+Una copia della GPL @`e inclusa
address@hidden
+in questo @value{DOCUMENT}
address@hidden ifnotinfo
+per la consultazione
+(@pxref{Copia}).
address@hidden ifclear
+La GPL si applica al codice sorgente in linguaggio C per @command{gawk}.
+Per saperne di address@hidden sulla FSF e sul Progetto GNU,
+si veda @uref{http://www.gnu.org, la pagina principale del Progetto GNU}.
+Questo @value{DOCUMENT} si address@hidden leggere anche dal
address@hidden://www.gnu.org/software/gawk/manual/, sito di GNU}.
+
address@hidden FOR_PRINT
+Una shell, un editor (Emacs), compilatori ottimizzanti C, C++ e
+Objective-C altamente portabili, un debugger simbolico e dozzine di grandi e
+piccoli programmi di address@hidden (come @command{gawk}), sono stati
completati e
+sono liberamente disponibili. Il kernel del sistema operativo GNU (noto come
+HURD), @`e stato rilasciato ma @`e ancora allo stato di sviluppo iniziale.
+
address@hidden Linux
address@hidden GNU/Linux
address@hidden sistemi operativi basati su BSD
+In attesa che il sistema operativo GNU venga address@hidden completatamente
+sviluppato, si dovrebbe prendere in considerazione l'uso di GNU/Linux, un
+sistema operativo liberamente distribuibile e basato su Unix disponibile
+per Intel, Power Architecture,
+Sun SPARC, IBM S/390, e altri
address@hidden terminologia ``GNU/Linux'' @`e spiegata
+nel @ref{Glossario}.}
+Molte distribuzioni GNU/Linux sono
+scaricabili da internet.
address@hidden ifclear
+
address@hidden
+Il @value{DOCUMENT} @`e realmente libero---almeno, l'informazione che contiene
address@hidden libera per chiunque---. Il codice sorgente del
@value{DOCUMENT}, leggibile
+elettronicamente, viene fornito con @command{gawk}.
address@hidden FOR_PRINT
+(Dare un'occhiata alla Free Documentation
+License in @ref{Licenza per Documentazione Libera GNU (FDL)}.)
address@hidden ifclear
address@hidden ifnotinfo
+
address@hidden Close, Diane
+Il @value{DOCUMENT} in s@'e ha address@hidden avuto parecchie edizioni in
passato.
+Paul Rubin ha scritto la prima bozza di @cite{The GAWK Manual};, che era
+lunga una quarantina di pagine.
+Diane Close e Richard Stallman l'hanno migliorata arrivando alla
+versione che era
+lunga una novantina di pagine, e descriveva solo la versione originale
+``vecchia'' di @command{awk}.
+Ho iniziato a lavorare con quella versione nell'autunno del 1988.
+Mentre ci stavo lavorando,
+la FSF ha pubblicato parecchie versioni preliminari, numerate address@hidden).
+Nel 1996, l'edizione 1.0 fu rilasciata assieme a @command{gawk} 3.0.0.
+La FSF ha pubblicato le prime due edizioni col
+titolo @cite{GAWK: The GNU Awk User's Guide}.
address@hidden FOR_PRINT
+SSC ha pubblicato due edizioni del @value{DOCUMENT} col
+titolo @cite{Effective awk Programming}, e O'Reilly ha pubblicato
+la terza edizione nel 2001
address@hidden ifset
+
+Questa edizione mantiene la struttra di base delle edizioni precedenti.
+Per l'edizione FSF 4.0, il contenuto era stato accuratamente rivisto
+e aggiornato. Tutti i riferimenti a versioni di @command{gawk} anteriori alla
+versione 4.0 sono stati eliminati.
+Di particolare interesse in quella edizione era l'aggiunta del @ref{Debugger}.
+
+Per l'edizione FSF
address@hidden FOR_PRINT
address@hidden,
address@hidden ifclear
address@hidden FOR_PRINT
address@hidden
+(la quarta edizione, come pubblicata da O'Reilly),
address@hidden ifset
+il contenuto @`e stato riorganizzato in parti,
+e le aggiunte address@hidden importanti sono
address@hidden
+il
address@hidden iftex
address@hidden con precisione arbitraria}, e
address@hidden
+il
address@hidden iftex
address@hidden dinamiche}.
+
+Questo @value{DOCUMENT} address@hidden certamente ad evolversi. Se si trovano
+errori nel @value{DOCUMENT}, si prega di segnalarli! @xref{Bug}
+per informazioni su come inviare le segnalazione di problemi elettronicamente.
address@hidden FOR_PRINT
address@hidden Restare aggiornati
address@hidden Come restare aggiornati
+
+Potreste avere una versione di @command{gawk} address@hidden recente di quella
+descritta qui. Per vedere cosa @`e cambiato,
+dovreste prima guardare il file @file{NEWS} nella distribuzione di
address@hidden, che fornisce un sommario ad alto livello dei
+cambiamenti in ciascuna versione.
+
+You can then look at the @uref{http://www.gnu.org/software/gawk/manual/,
+online version} of this @value{DOCUMENT} to read about any new features.
address@hidden ifset
+
address@hidden FOR_PRINT
address@hidden Come contribuire
address@hidden Come collaborare
+
+Come manutentore di GNU @command{awk}, un tempo pensai che sarei stato in grado
+di gestire una raccolta di programmi @command{awk} pubblicamente disponibili e
+avevo anche esortato a collaborare. Rendere disponibili le cose su Internet
+aiuta a contenere la distribuzione @command{gawk} entro dimensioni gestibili.
+
+L'iniziale raccolta di materiale, come questo, @`e tuttora disponibile
+su @uref{ftp://ftp.freefriends.org/arnold/Awkstuff}.
+
+Chi fosse @emph{seriamente} interessato a contribuire nell'implementazione
+di un sito Internet dedicato ad argomenti riguardanti il
+linguaggio @command{awk}, @`e pregato di contattarmi.
+
address@hidden
+Nella speranza di
+fare qualcosa di address@hidden esteso, acquisii il dominio @code{awk.info}.
+
+Tuttavia, mi accorsi che non potevo dedicare abbastanza tempo per la gestione
+del codice inviato dai collaboratori: l'archivio non cresceva e il dominio
+rimase in disuso per diversi anni.
+
+Alla fine del 2008, un volontario si assunse il compito di mettere a punto
+un sito web collegato ad @address@hidden://awk.info}---e fece un
+lavoro molto ben fatto.
+
+Se qualcuno ha scritto un programma @command{awk} interessante, o un'estensione
+a @command{gawk} che vuole condividere col resto del mondo, @`e invitato a
+consultare la pagina @uref{http://awk.info/?contribute} per sapere come
+inviarlo per contribuire al sito web.
+
+Mentre scrivo, questo sito @`e in cerca di un responsabile; se qualcuno @`e
+interessato mi contatti.
address@hidden ignore
+
address@hidden
+Altri collegamenti:
+
+http://www.reddit.com/r/linux/comments/dtect/composing_music_in_awk/
address@hidden ignore
address@hidden ifclear
+
address@hidden Ringraziamenti
address@hidden Ringraziamenti
+
+La bozza iniziale di @cite{The GAWK Manual} riportava i seguenti
ringraziamenti:
+
address@hidden
+Molte persone devono essere ringraziate per la loro assistenza nella produzione
+di questo manuale. Jay Fenlason ha contribuito con molte idee e programmi di
+esempio. Richard Mlynarik e Robert Chassell hanno fatto utili osservazioni
+sulle bozze di questo manuale. Lo scritto
address@hidden Supplemental Document for AWK} di John W.@: Pierce, del
+Chemistry Department di UC San Diego, fa il punto su diverse questioni
rilevanti
+sia per l'implementazione di @command{awk} che per questo manuale, che
+altrimenti ci sarebbero sfuggite.
address@hidden quotation
+
address@hidden Stallman, Richard
+Vorrei ringraziare Richard M.@: Stallman, per la sua visione di un mondo
+migliore e per il suo coraggio nel fondare la FSF e nel dare inizio al
+Progetto GNU.
+
address@hidden FOR_PRINT
+Edizioni precedenti di questo @value{DOCUMENT} riportavano i seguenti
+ringraziamenti:
address@hidden ifclear
address@hidden FOR_PRINT
+La precedente edizione di questo @value{DOCUMENT} riportava
+i seguenti ringraziamenti:
address@hidden ifset
+
address@hidden
+Le seguenti persone (in ordine alfabetico)
+hanno inviato commenti utili riguardo alle diverse
+versioni di questo libro:
+Rick Adams,
+Dr.@: Nelson H.F. Beebe,
+Karl Berry,
+Dr.@: Michael Brennan,
+Rich Burridge,
+Claire Cloutier,
+Diane Close,
+Scott Deifik,
+Christopher (``Topher'') Eliot,
+Jeffrey Friedl,
+Dr.@: Darrel Hankerson,
+Michal Jaegermann,
+Dr.@: Richard J.@: LeBlanc,
+Michael Lijewski,
+Pat Rankin,
+Miriam Robbins,
+Mary Sheehan,
+e
+Chuck Toporek.
+
address@hidden Berry, Karl
address@hidden Chassell, Robert J.@:
address@hidden @cindex Texinfo
+Robert J.@: Chassell ha dato preziosissimi consigli
+sull'uso di Texinfo.
+Merita anche un particolare ringraziamento per avermi
+convinto a @emph{non} dare a questo @value{DOCUMENT}
+il titolo @cite{How to Gawk Politely}. [Un gioco di parole in inglese che
address@hidden
+significare sia
address@hidden usare Gawk educatamente}
+che @cite{Come curiosare educatamente}].
+Karl Berry ha aiutato in modo significativo con la parte @TeX{} di Texinfo.
+
address@hidden Hartholz, Marshall
address@hidden Hartholz, Elaine
address@hidden Schreiber, Bert
address@hidden Schreiber, Rita
+Vorrei ringraziare Marshall ed Elaine Hartholz di Seattle e il Dr.@: Bert e
Rita
+Schreiber di Detroit per i lunghi periodi di vacanza trascorsi in tutta
address@hidden in casa loro, che mi hanno permesso di fare importanti progressi
+nella scrittura di questo @value{DOCUMENT} e con lo stesso @command{gawk}.
+
address@hidden Hughes, Phil
+Phil Hughes di SSC
+ha contribuito in modo molto importante prestandomi il suo portatile col
sistema
+GNU/Linux, non una volta, ma due, il che mi ha permesso di fare tantissimo
lavoro
+mentre ero fuori casa.
+
address@hidden Trueman, David
+David Trueman merita un riconoscimento speciale; ha fatto un lavoro da
sentinella
+durante lo sviluppo di @command{gawk} affinch@'e funzioni bene e senza errori.
+Sebbene non sia address@hidden impegnato con @command{gawk},
+lavorare con lui a questo progetto @`e stato un vero piacere.
+
address@hidden Drepper, Ulrich
address@hidden GNITS mailing list
address@hidden mailing list, GNITS
+Gli intrepidi membri della lista GNITS, con una particolare menzione per Ulrich
+Drepper, hanno fornito un aiuto prezioso e commenti per il progetto
+delle address@hidden di internazionalizzazione.
+
+Chuck Toporek, Mary Sheehan, e Claire Cloutier della O'Reilly & Associates
hanno
+fornito un'assistenza editoriale rilevante per questo @value{DOCUMENT} per la
+versione 3.1 di @command{gawk}.
address@hidden quotation
+
address@hidden Beebe, Nelson H.F.@:
address@hidden Buening, Andreas
address@hidden Collado, Manuel
address@hidden Colombo, Antonio
address@hidden Davies, Stephen
address@hidden Deifik, Scott
address@hidden Demaille, Akim
address@hidden G., Daniel Richard
address@hidden Hankerson, Darrel
address@hidden Jaegermann, Michal
address@hidden Kahrs, J@"urgen
address@hidden Kasal, Stepan
address@hidden Malmberg, John E.
address@hidden Pitts, Dave
address@hidden Ramey, Chet
address@hidden Rankin, Pat
address@hidden Schorr, Andrew
address@hidden Vinschen, Corinna
address@hidden Zaretskii, Eli
+
+Dr.@: Nelson Beebe,
+Andreas Buening,
+Dr.@: Manuel Collado,
+Antonio Colombo,
+Stephen Davies,
+Scott Deifik,
+Akim Demaille,
+Daniel Richard G.,
+Darrel Hankerson,
+Michal Jaegermann,
+J@"urgen Kahrs,
+Stepan Kasal,
+John Malmberg,
+Dave Pitts,
+Chet Ramey,
+Pat Rankin,
+Andrew Schorr,
+Corinna Vinschen,
+ed Eli Zaretskii
+(in ordine alfabetico)
+costituiscono l'attuale ``gruppo di lavoro sulla address@hidden'' di
address@hidden Senza il loro duro lavoro e il loro aiuto,
address@hidden non sarebbe stato neanche lontanamente il buon programma che @`e
+oggi. @`E stato e continua a essere un piacere lavorare con questo gruppo
+di ottimi collaboratori.
+
+Notevoli contributi di codice e documentazione sono arrivati da
+parecchie persone. @xref{Contributori} per l'elenco completo.
+
address@hidden FOR_PRINT
address@hidden Oram, Andy
+Grazie ad Andy Oram della O'Reilly Media per aver iniziato
+la quarta edizione e per il suo aiuto in corso d'opera.
+Grazie a Jasmine Kwityn per il suo lavoro di revisione.
address@hidden ifset
+
+Grazie a Michael Brennan per le Prefazioni.
+
address@hidden Duman, Patrice
address@hidden Berry, Karl
+Grazie a Patrice Dumas per il nuovo programma @command{makeinfo}.
+Grazie a Karl Berry, che continua a lavorare per tenere
+aggiornato il linguaggio di marcatura Texinfo.
+
address@hidden Kernighan, Brian
address@hidden Brennan, Michael
address@hidden Day, Robert P.J.@:
+Robert P.J.@: Day, Michael Brennan e Brian Kernighan hanno gentilmente
+fatto da revisiori per l'edizione 2015 di questo @value{DOCUMENT}. Le loro
+osservazioni hanno contribuito a migliorare la stesura finale.
+
+Vorrei ringraziare Brian Kernighan per la sua preziosa assistenza durante
+la fase di collaudo e di debug di @command{gawk} e
+per l'aiuto in corso d'opera e i consigli nel chiarire diversi punti sul
+linguaggio. Non avremmo proprio fatto un address@hidden@dotless{i}} buon
lavoro su @command{gawk} e
+sulla sua documentazione senza il suo aiuto.
+
+Brian @`e un fuoriclasse sia come programmatore che come autore di manuali
+tecnici. @`E mio dovere ringraziarlo (una volta di address@hidden) per la sua
costante
+amicizia e per essere stato per me un modello da seguire ormai da quasi
+30 anni! Averlo come revisiore @`e per me un privilegio eccitante, ma @`e
+stata anche un'esperienza che mi ha fatto sentire molto address@hidden
+
address@hidden Robbins, Miriam
address@hidden Robbins, Jean
address@hidden Robbins, Harry
address@hidden D-o
+Devo ringraziare la mia meravigliosa moglie, Miriam, per la sua pazienza nel
+corso delle molte versioni di questo progetto, per la correzione delle bozze e
+per aver condiviso con me il computer.
+Vorrei ringraziare i miei genitori per il loro amore, e per la gentilezza con
cui
+mi hanno cresciuto ed educato.
+Infine, devo riconoscere la mia gratitudine a D-o, per le molte address@hidden
+che mi ha offerto, e anche per i doni che mi ha elargito, con cui trarre
+vantaggio da quelle address@hidden
address@hidden
address@hidden 2
address@hidden
+Arnold Robbins @*
+Nof Ayalon @*
+Israel @*
+Febbraio 2015
address@hidden ifnotdocbook
+
address@hidden
address@hidden @value{PART1}Il Linguaggio @command{awk}
address@hidden ifnotinfo
+
address@hidden
address@hidden Il Linguaggio @command{awk}
+
+La Parte I descrive il linguaggio @command{awk} e il programma @command{gawk}
+nel dettaglio. Inizia con le nozioni di base, e continua con tutte le
address@hidden di @command{awk}. Sono incluse anche molte, ma non tutte, le
address@hidden di @command{gawk}. Questa parte contiene i
+seguenti capitoli:
+
address@hidden @value{BULLET}
address@hidden
address@hidden iniziare}
+
address@hidden
address@hidden Gawk}
+
address@hidden
address@hidden regolari}
+
address@hidden
address@hidden file}
+
address@hidden
address@hidden
+
address@hidden
address@hidden
+
address@hidden
address@hidden e azioni}
+
address@hidden
address@hidden
+
address@hidden
address@hidden
address@hidden itemize
address@hidden ifdocbook
address@hidden Per iniziare
address@hidden Per iniziare con @command{awk}
address@hidden @cindex @dfn{script}, definizione di
address@hidden @cindex rule, definizione di
address@hidden @cindex program, definizione di
address@hidden @cindex basic function of @command{awk}
address@hidden @command{awk}, funzione di
+
+Il compito fondamentale di @command{awk} @`e quello di ricercare righe (o
+altre address@hidden di testo) in file che corrispondano a certi criteri di
ricerca.
+Quando una riga corrisponde a uno dei criteri, @command{awk} esegue su
+quella riga le azioni specificate per quel criterio. @command{awk} continua
+a elaborare righe in input in questo modo, finch@'e non raggiunge la fine delle
+righe nei file in input.
+
address@hidden @command{awk}, uso di
address@hidden linguaggi di address@hidden guidati-dai-dati/procedurali
address@hidden @command{awk}, programmi
+I programmi scritti in @command{awk} sono differenti dai programmi scritti
+nella maggior parte degli altri linguaggi,
+poich@'e i programmi @command{awk} sono @dfn{guidati dai dati} (ovvero,
+richiedono di descrivere i dati sui quali si vuole operare, e in seguito
+che cosa fare una volta che tali dati siano stati individuati).
+La maggior parte degli altri linguaggi sono @dfn{procedurali}; si deve
+descrivere, in maniera molto dettagliata, ogni passo che il programma
+deve eseguire. Lavorando con linguaggi procedurali, solitamente @`e
+molto address@hidden difficile descrivere chiaramente i dati che il programma
+deve elaborare.
+Per questa ragione i programmi @command{awk} sono spesso piacevolmente
+facili da leggere e da scrivere.
+
address@hidden programma, definizione di
address@hidden regola, definizione di
+Quando si esegue @command{awk}, va specificato un
address@hidden @command{awk} che
+dice ad @command{awk} cosa fare. Il programma consiste di una serie di
address@hidden (address@hidden anche contenere @dfn{definizioni di funzioni},
+una address@hidden avanzata che per ora ignoreremo;
address@hidden definite dall'utente}). Ogni regola specifica un
+criterio di ricerca e un'azione da effettuare
+una volta che viene trovato un record corrispondente.
+
+Sintatticamente, una regola consiste in un @dfn{criterio di ricerca}, seguito
+da una @dfn{azione}.
+L'azione @`e racchiusa tra parentesi graffe per separarla dal criterio di
+ricerca.
+Per separare regole, basta andare a capo. Quindi un programma
address@hidden ha una struttura simile a questa:
+
address@hidden
address@hidden @{ @var{azione} @}
address@hidden @{ @var{azione} @}
address@hidden
address@hidden example
+
address@hidden
+* Eseguire gawk:: Come iniziare a eseguire programmi
+ @command{gawk}; comprende la sintassi
+ della riga di comando.
+* File dati di esempio:: File di dati di esempio da usare nei
+ programmi @command{awk} illustrati in
+ questo @value{DOCUMENT}.
+* Molto semplice:: Un esempio molto semplice.
+* Due regole:: Un esempio meno semplice di programma
+ di una riga, che usa due regole.
+* Maggiore sofisticazione:: Un esempio address@hidden complesso.
+* Istruzioni/Righe:: Suddividere o riunire istruzioni
+ su [una o address@hidden righe.
+* Altre address@hidden:: Altre address@hidden di @command{awk}.
+* Quando:: Quando usare @command{gawk} e quando
+ usare altre cose.
+* Sommario dell'introduzione:: Sommario dell'introduzione.
address@hidden menu
+
address@hidden Eseguire gawk
address@hidden Come iniziare a eseguire programmi @command{gawk}
+
address@hidden programmi @command{awk}, eseguire
+Ci sono vari modi di eseguire un programma @command{awk}. Se il programma @`e
+corto, @`e address@hidden facile includerlo nel comando con cui si invoca
@command{awk},
address@hidden@dotless{i}}:
+
address@hidden
+awk '@var{programma}' @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden riga di comando, formati
+Quando il programma @`e lungo, di solito @`e meglio metterlo in un file
+ed eseguirlo con un comando come questo:
+
address@hidden
+awk -f @var{file-di-programma} @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden si occupa di entrambe queste address@hidden insieme
+a parecchie varianti di ciascuna di esse.
+
address@hidden
+* Monouso:: Eseguire un breve programma
+ @command{awk} di tipo usa-e-getta.
+* Leggere dal terminale:: Senza uso di file in input (input
+ immesso da tastiera).
+* Lunghi:: Mettere programmi @command{awk}
+ permanenti in file.
+* @dfn{Script} eseguibili:: Preparare programmi @command{awk}
+ da eseguire come @dfn{script}.
+* Commenti:: Aggiungere documentazione a programmi
+ @command{gawk}.
+* Protezione:: Ulteriore discussione di problemi
+ connessi all'uso di apici nella shell.
address@hidden menu
+
address@hidden Monouso
address@hidden Eseguire un breve programma @command{awk} usa-e-getta
+
+Una volta acquisita address@hidden con @command{awk}, address@hidden spesso di
+preparare semplici
+programmi nel momento in cui servono. In questo caso si address@hidden
scrivere
+il programma come primo argomento del comando @command{awk},
address@hidden@dotless{i}}:
+
address@hidden
+awk '@var{programma}' @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden
+dove @var{programma} consiste in una serie di criteri di ricerca e di
+azioni, come descritto precedentemente.
+
address@hidden apice singolo (@code{'})
address@hidden @code{'} (apice singolo)
+Questo formato di comando chiede alla @dfn{shell}, ossia all'interpretatore
+dei comandi, di richiamare @command{awk} e di usare il @var{programma} per
+trattare record nei file in input.
+Il @var{programma} @`e incluso tra apici in modo che
+la shell non interpreti qualche carattere destinato ad @command{awk} come
+carattere speciale
+della shell. Gli apici fanno inoltre address@hidden@dotless{i}} che la shell
tratti tutto il
address@hidden come un solo argomento per @command{awk}, e permettono che
address@hidden sia address@hidden lungo di una riga.
+
address@hidden shell, @dfn{script}
address@hidden programmi @command{awk}, eseguire, da @dfn{script} di shell
+Questo formato @`e utile anche per eseguire programmi @command{awk} di
+dimensioni piccole o medie da @dfn{script} di shell, perch@'e non richiede
+un file separato che contenga il programma @command{awk}. Uno @dfn{script}
+di shell @`e address@hidden affidabile, perch@'e non ci sono altri file che
possono
+venirsi a trovare fuori posto.
+
address@hidden avanti in questo capitolo,
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden
address@hidden
address@hidden ifdocbook
address@hidden semplice},
+si vedranno esempi di parecchi programmi,
+brevi, scritti sulla riga di comando.
+
address@hidden Leggere dal terminale
address@hidden Senza uso di file in input (input immesso da tastiera)
+
address@hidden standard input
address@hidden input, standard
address@hidden file in input, eseguire @command{awk} senza usarli
+Si address@hidden anche eseguire @command{awk} senza indicare alcun file in
input. Se
+si immette la seguente riga di comando:
+
address@hidden
+awk '@var{programma}'
address@hidden example
+
address@hidden
address@hidden prende come input del @var{programma} lo @dfn{standard input},
+che di solito significa qualsiasi cosa venga immesso dalla tastiera.
address@hidden prosegue finch@'e non si segnala una fine-file battendo
@kbd{Ctrl-d}.
+(In sistemi operativi non-POSIX, il carattere di fine-file address@hidden
essere diverso.)
+
address@hidden input, file in, si veda file in input
address@hidden file in input, eseguire @command{awk} senza usarli
address@hidden programmi @command{awk}, eseguire, senza file in input
+Per esempio, il seguente programma stampa un consiglio da amico
+(dalla @cite{Guida galattica per gli autostoppisti} di Douglas Adams ),
+per non lasciarsi spaventare dalle address@hidden della programmazione per
+computer:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Non v\47allarmate!" @}'}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden esegue le istruzioni associate a @code{BEGIN} prima di leggere
+qualsiasi input. Se non ci sono altre istruzioni nel proprio programma, come
+in questo caso, @command{awk} si ferma, invece di tentare di leggere input che
+non sa come elaborare.
+Il @samp{\47} @`e un modo straordinario (spiegato address@hidden avanti) per
inserire un
+apice singolo nel programma, senza dover ricorrere a fastidiosi meccanismi
+di protezione della shell.
+
address@hidden NOTA
+Se si usa Bash come shell, si dovrebbe digitare il comando @samp{set +H} prima
+eseguire questo programma interattivamente, per non avere una cronologia dei
+comandi nello stile della C shell, che tratta il @samp{!} come un carattere
+speciale. Si raccomanda di inserire quel comando nel proprio file di
+personalizzazione della shell.
address@hidden quotation
+
+Il seguente semplice programma @command{awk}
+emula il comando @command{cat}; ovvero copia qualsiasi cosa si
+batta sulla tastiera nel suo standard output (perch@'e succede @`e spiegato fra
+poco):
+
address@hidden
+$ @kbd{awk '@{ print @}'}
address@hidden @`e il tempo per tutti gli uomini buoni}
address@hidden Ora @`e il tempo per tutti gli uomini buoni
address@hidden venire in aiuto al loro paese.}
address@hidden di venire in aiuto al loro paese.
address@hidden sono sedici lustri e sette anni, ...}
address@hidden Or sono sedici lustri e sette anni, ...
address@hidden, io preoccupato?}
address@hidden Cosa, io preoccupato?
address@hidden
address@hidden example
+
address@hidden Lunghi
address@hidden Eseguire programmi lunghi
+
address@hidden programmi @command{awk}, eseguire
address@hidden programmi @command{awk}, lunghi
address@hidden file, programmi @command{awk} in
+Talora i programmi @command{awk} sono molto lunghi. In tali situazioni
+conviene mettere il programma in un file separato. Per dire ad
address@hidden di usare quel file come programma, digitare:
+
address@hidden
+awk -f @var{file-sorgente} @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden @option{-f}, opzione
address@hidden riga di comando, opzione @option{-f}
+L'opzione @option{-f} dice al comando @command{awk} di ottenere il programma
address@hidden dal file @var{file-sorgente} (@pxref{Opzioni}).
+Ogni @value{FN} address@hidden essere usato come @var{file-sorgente}. Per
esempio, si
+potrebbe mettere il programma:
+
address@hidden
+BEGIN @{ print \"Non v'allarmate!\" @}
address@hidden example
+
address@hidden
+nel file @file{consiglio}. Allora questo comando:
+
address@hidden
+awk -f consiglio
address@hidden example
+
address@hidden
address@hidden equivalente al comando:
+
address@hidden
+awk 'BEGIN @{ print \"Non v\47allarmate!\" @}'
address@hidden example
+
address@hidden protezione, nella riga di comando di @command{gawk}
address@hidden
+Questo @`e address@hidden stato spiegato prima
+(@pxref{Leggere dal terminale}).
+Si noti che normalmente non serve mettere apici singoli nel @value{FN} che si
+fornisce con @option{-f}, perch@'e di solito i @value{FNS} non contengono
+caratteri che sono speciali per la shell. Si noti che in @file{consiglio},
+il programma @command{awk} non ha dei doppi apici che lo delimitano. I
+doppi apici sono necessari solo per programmi scritti direttamente sulla riga
+di comando di @command{awk}.
+(Inoltre, se il programma si trova in un file, @`e possibile usare un apice
+singolo all'interno del programma, invece del magico @samp{\47}.)
+
address@hidden apice singolo (@code{'}), nella riga di comando di @command{gawk}
address@hidden @code{'} (apice singolo), nella riga di comando di @command{gawk}
+Per identificare chiaramente un file di programma @command{awk} come tale,
+si address@hidden aggiungere il suffisso @file{.awk} al @value{FN}.
address@hidden non
+cambia l'esecuzione del programma @command{awk} ma semplifica
+la ``manutenzione''.
+
address@hidden @dfn{Script} eseguibili
address@hidden Programmi @command{awk} da eseguire come @dfn{script}
address@hidden programmi @command{awk}
address@hidden @code{#} (cancelletto), @code{#!} (@dfn{script} eseguibili)
address@hidden Unix, @dfn{script} @command{awk} e
address@hidden cancelletto (@code{#}), @code{#!} (@dfn{script} eseguibili)
+
+Una volta familiarizzato con @command{awk}, si potrebbero scrivere
address@hidden che richiamano @command{awk}, usando il meccanismo di
address@hidden @samp{#!}. address@hidden @`e
+possibile in molti sistemi address@hidden meccanismo @samp{#!}
+funziona nei sistemi
+GNU/Linux, in quelli basati su BSD e nei sistemi Unix a pagamento.}
+Per esempio, si potrebbe modificare il file @file{consiglio} e farlo divenire:
+
address@hidden
+#! /bin/awk -f
+
+BEGIN @{ print \"Non v'allarmate!\" @}
address@hidden example
+
address@hidden
+Dopo aver reso eseguibile questo file (con il comando @command{chmod}),
+digitare semplicemente @samp{consiglio}
+al prompt della shell e il sistema si address@hidden a eseguire @command{awk}
+come se si fosse digitato @samp{awk -f consiglio}:
+
address@hidden
+$ @kbd{chmod +x consiglio}
+$ @kbd{consiglio}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden
+(Si suppone che la directory corrente sia tra quelle contenute nella variabile
+che indica il "percorso" di ricerca [solitamente @code{$PATH}]. In caso
+contrario si potrebbe aver bisogno di digitare @samp{./consiglio} nella
+shell.)
+
address@hidden @command{awk} autocontenuti sono utili se si vuol scrivere un
+programma che gli utenti possono richiamare senza dover essere informati che
+il programma @`e scritto in @command{awk}.
+
address@hidden sidebar, Comprendere @samp{#!}
address@hidden
address@hidden
+<sidebar><title>Comprendere @samp{#!}</title>
address@hidden docbook
+
address@hidden address@hidden, @code{#!} (@dfn{script} eseguibili)
+
address@hidden @`e un linguaggio @dfn{interpretato}. address@hidden significa
che il
+comando @command{awk} legge il programma dell'utente e poi elabora i dati
+secondo le istruzioni contenute nel programma (diversamente da un linguaggio
address@hidden come il C, dove il programma viene prima compilato in codice
+macchina che @`e eseguito direttamente dal processore del sistema). Il
+programma di address@hidden @command{awk} @`e address@hidden chiamato
@dfn{interpretatore}.
+Molti linguaggi moderni sono interpretati.
+
+La riga che inizia con @samp{#!} lista l'intero @value{FN} di un
+interpretatore
+da richiamare, con degli argomenti facoltativi che saranno passati a
+quell'interpretatore sulla riga di comando. Il sistema operativo quindi
+richiama l'interpretatore con gli argomenti dati e con l'intera lista di
+argomenti con cui era stato invocato il programma. Il primo argomento nella
+lista @`e l'intero @value{FN} del programma @command{awk}. Il resto della
lista
+degli argomenti contiene opzioni per @command{awk}, oppure @value{DF}, o
+entrambi. (Si noti che in molti sistemi @command{awk} address@hidden essere
trovato in
address@hidden/usr/bin} invece che in @file{/bin}.)
+
+Alcuni sistemi limitano la lunghezza del nome del programma interpretarore a
+32 caratteri. Spesso, si address@hidden rimediare utilizzando un collegamento
simbolico.
+
+Non si dovrebbero mettere altri argomenti oltre al primo nella riga @samp{#!}
+dopo il percorso del comando @command{awk}. Non funziona. Il sistema
+operativo tratta il resto della riga come un argomento solo, e lo passa ad
address@hidden
address@hidden@dotless{i}} facendo il comportamento address@hidden poco chiaro;
con ogni address@hidden un
+messaggio di errore di qualche tipo da @command{awk}.
+
address@hidden variabili @code{ARGC}/@code{ARGV}, address@hidden e
address@hidden address@hidden, variabile @code{ARGV}
+Infine, il valore di @code{ARGV[0]}
+(@pxref{Variabili predefinite})
address@hidden variare a seconda del sistema operativo.
+Alcuni sistemi ci mettono @samp{awk}, altri il nome completo del percorso
+di @command{awk} (ad. es. @file{/bin/awk}), e altri ancora mettono il nome
+dello @dfn{script} dell'utente (@samp{consiglio}). @value{DARKCORNER}
+Non bisogna fidarsi del valore di @code{ARGV[0]}
+per ottenere il nome del proprio @dfn{script}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Comprendere @samp{#!}}
+
+
address@hidden address@hidden, @code{#!} (@dfn{script} eseguibili)
+
address@hidden @`e un linguaggio @dfn{interpretato}. address@hidden significa
che il
+comando @command{awk} legge il programma dell'utente e poi elabora i dati
+secondo le istruzioni contenute nel programma (diversamente da un linguaggio
address@hidden come il C, dove il programma viene prima compilato in codice
+macchina che @`e eseguito direttamente dal processore del sistema). Il
+programma di address@hidden @command{awk} @`e address@hidden chiamato
@dfn{interpretatore}.
+Molti linguaggi moderni sono interpretati.
+
+La riga che inizia con @samp{#!} lista l'intero @value{FN} di un
+interpretatore
+da richiamare, con degli argomenti facoltativi che saranno passati a
+quell'interpretatore sulla riga di comando. Il sistema operativo quindi
+richiama l'interpretatore con gli argomenti dati e con l'intera lista di
+argomenti con cui era stato invocato il programma. Il primo argomento nella
+lista @`e l'intero @value{FN} del programma @command{awk}. Il resto della
lista
+degli argomenti contiene opzioni per @command{awk}, oppure @value{DF}, o
+entrambi. (Si noti che in molti sistemi @command{awk} address@hidden essere
trovato in
address@hidden/usr/bin} invece che in @file{/bin}.)
+
+Alcuni sistemi limitano la lunghezza del nome del programma interpretarore a
+32 caratteri. Spesso, si address@hidden rimediare utilizzando un collegamento
simbolico.
+
+Non si dovrebbero mettere altri argomenti oltre al primo nella riga @samp{#!}
+dopo il percorso del comando @command{awk}. Non funziona. Il sistema
+operativo tratta il resto della riga come un argomento solo, e lo passa ad
address@hidden
address@hidden@dotless{i}} facendo il comportamento address@hidden poco chiaro;
con ogni address@hidden un
+messaggio di errore di qualche tipo da @command{awk}.
+
address@hidden variabili @code{ARGC}/@code{ARGV}, address@hidden e
address@hidden address@hidden, variabile @code{ARGV}
+Infine, il valore di @code{ARGV[0]}
+(@pxref{Variabili predefinite})
address@hidden variare a seconda del sistema operativo.
+Alcuni sistemi ci mettono @samp{awk}, altri il nome completo del percorso
+di @command{awk} (ad. es. @file{/bin/awk}), e altri ancora mettono il nome
+dello @dfn{script} dell'utente (@samp{consiglio}). @value{DARKCORNER}
+Non bisogna fidarsi del valore di @code{ARGV[0]}
+per ottenere il nome del proprio @dfn{script}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Commenti
address@hidden Documentare programmi @command{gawk}.
address@hidden @code{#} (cancelletto), commentare
address@hidden cancelletto (@code{#}), commentare
address@hidden commentare
address@hidden programmi @command{awk}, documentazione
+
+Un @dfn{commento} @`e del testo incluso in un programma per aiutare le
+persone che lo leggeranno; non @`e parte del programma eseguibile vero e
+proprio. I commenti possono spiegare cosa fa il programma e come funziona.
+Quasi tutti i linguaggi di programmazione possono contenere commenti, poich@'e
+i programmi sono solitamente difficili da comprendere senza di essi.
+
+Nel linguaggio @command{awk}, un commento inizia con il segno del
+cancelletto (@samp{#}) e continua fino alla fine della riga.
+Il @samp{#} non deve necessariamente essere il primo carattere della riga.
+Il linguaggio @command{awk} ignora il resto di una riga dopo il carattere
+cancelletto.
+Per esempio, potremmo mettere quel che segue in @file{consiglio}:
+
address@hidden
+# Questo programma stampa uno scherzoso consiglio amichevole.
+# Aiuta a far passare la paura del computer agli utenti novelli.
+BEGIN @{ print "Non v'allarmate!" @}
address@hidden example
+
+Si possono mettere dei commenti nei programmi @command{awk} usa-e-getta da
+digitare direttamente da tastiera, ma address@hidden solitmanete non serve
molto; il
+fine di un commento @`e di aiutare l'utente o qualcun altro a comprendere il
+programma, quando lo rilegge in un secondo tempo.
+
address@hidden protezione, per piccoli programmi awk
address@hidden apice singolo (@code{'}), vs.@: apostrofo
address@hidden @code{'} (apice singolo), vs.@: apostrofo
address@hidden ATTENZIONE
+Come detto in
address@hidden,
+si possono includere programmi di dimensioni da piccole a medie tra apici
+singoli, per mantenere compatti i propri @dfn{script} di shell
+autocontenuti. Nel far questo, @emph{non} bisogna inserire un apostrofo
+(ossia un apice singolo) in un commento, (o in qualsiasi altra parte del
+vostro programma). La shell interpreta gli apici singoli come delimitatori
+di chiusura dell'intero programma. Di conseguenza, solitamente la shell
+emette un messaggio riguardo ad apici presenti in numero dispari, e se
address@hidden viene comunque eseguito, @`e probabile che stampi strani
+messaggi di errori di sintassi.
+Per esempio, nel caso seguente:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Ciao" @} # un'idea brillante'}
+>
address@hidden example
+
+La shell considera il secondo apice singolo come delimitatore del testo
+precedente, e trova che un nuovo testo tra apici ha inizio verso la fine
+della riga di comando. A causa di address@hidden emette una richiesta
secondaria di
+input, e si mette in attesa di ulteriore input.
+Con il comando @command{awk} Unix, se si chiude l'ulteriore stringa tra
+apici singoli il risultato @`e il seguente:
+
address@hidden
+$ @kbd{awk '@{ print "Ciao" @} # un'idea brillante'}
+> @kbd{'}
address@hidden awk: fatale: non riesco ad aprire file `brillante'
address@hidden in lettura (File o directory non esistente)
address@hidden example
+
address@hidden @code{\} (barra inversa)
address@hidden barra inversa (@code{\})
+Mettere una barra inversa prima dell'apice singolo in @samp{un'idea} non
+risolverebbe, poich@'e le barre inverse non sono speciali all'interno di apici
+singoli.
+La prossima @value{SUBSECTION} descrive le regole di protezione della shell.
address@hidden quotation
+
address@hidden Protezione
address@hidden Uso di apici nella shell.
address@hidden shell, uso di apici, regole per
+
address@hidden
+* Doppi apici in DOS:: Passaggio di apici in file .BAT Windows.
address@hidden menu
+
+Per programmi @command{awk} di lunghezza da corta a media spesso conviene
+digitare il programma sulla riga di comando @command{awk}.
+La maniera migliore per farlo @`e racchiudere l'intero programma tra apici
+singoli.
+Questo vale sia che si digiti il programma interattivamente su
+richiesta della shell, sia che lo si scriva come parte di uno @dfn{script}
+di shell di maggiori dimensioni:
+
address@hidden
+awk '@var{testo del programma}' @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden shell, uso di apici, regole per
address@hidden Bourne shell, uso di apici, regole per la
+Quando si lavora con la shell, non guasta avere una conoscenza
+di base sulle regole per l'uso di apici nella shell. Le regole
+seguenti valgono solo per shell in stile Bourne (come Bash, la
+Bourne-Again shell). Se si usa la C shell, si avranno regole differenti.
+
+Prima di immergerci nelle regole, introduciamo un concetto che ricorre
+in tutto questo @value{DOCUMENT}, che @`e quello della stringa @dfn{null},
+o vuota.
+
+La stringa nulla @`e una variabile, di tipo carattere, che non ha un valore.
+In altre parole, @`e vuota. Nei programmi @command{awk} si scrive
address@hidden@dotless{i}}:
address@hidden""}. Nella shell la si address@hidden scrivere usando apici sia
singoli
+che doppi: @code{""} oppure @code{''}. Sebbena la stringa nulla non contenga
+alcun carattere, essa esiste lo stesso. Si consideri questo comando:
+
address@hidden
+$ @kbd{echo ""}
address@hidden example
+
address@hidden
+Qui, il comando @command{echo} riceve un solo argomento, anche se
+quell'argomento non contiene alcun carattere. Nel resto di questo
address@hidden, usiamo indifferentemente i termini @dfn{stringa nulla}
+e @dfn{stringa vuota}. Ora, proseguiamo con le regole relative agli apici:
+
+
address@hidden @value{BULLET}
address@hidden
+Elementi tra apici possono essere concatenati con elementi non tra apici.
+La shell converte il tutto in un singolo argomento da passare
+al comando.
+
address@hidden
+Mettere una barra inversa (@samp{\}) prima di qualsiasi singolo carattere
+lo protegge. La shell toglie la barra inversa e passa il carattere
+protetto al comando.
+
address@hidden
address@hidden @code{\} (barra inversa), nei comandi di shell
address@hidden barra inversa (@code{\}), nei comandi di shell
address@hidden apice singolo (@code{'}), nei comandi di shell
address@hidden @code{'} (apice singolo), nei comandi di shell
+Gli apici singoli proteggono qualsiasi cosa sia inclusa tra un apice di
+apertura e uno di chiusura.
+La shell non interpreta il testo protetto, il quale viene passato
address@hidden@dotless{i}} com'@`e
+al comando.
address@hidden @emph{impossibile} inserire un apice singolo in un testo
racchiuso fra
+apici singoli. Potete trovare in
address@hidden
+un esempio di cosa succede se si prova a farlo.
+
address@hidden
address@hidden doppio apice (@code{"}), nei comandi shell
address@hidden @code{"} (doppio apice), nei comandi shell
+I doppi apici proteggono la maggior parte di quel che @`e racchiuso tra i
+doppi apici di apertura e quelli di chiusura.
+La shell effettua almeno la sostituzione di variabili e di comandi
+sul testo racchiuso tra doppi apici.
+Shell differenti possono fare ulteriori tipi di elaborazione
+sul testo racchiuso tra doppi apici.
+
+Poich@'e alcuni caratteri all'interno di un testo racchiuso tra doppi apici
+sono interpretati dalla shell, essi devono essere @dfn{protetti} all'interno
+del testo stesso. Sono da tener presenti i caratteri
address@hidden, @samp{`}, @samp{\}, e @samp{"}, tutti i quali devono essere
+preceduti da una barra inversa quando ricorrono all'interno di un testo
+racchiuso tra doppi apici, per poter essere passati letteralmente al
+programma. (La barra inversa viene tolta prima del passaggio al programma.)
+Quindi, l'esempio visto
address@hidden
+precedentemente
address@hidden ifnotinfo
+in @ref{Leggere dal terminale}:
+
address@hidden
+awk 'BEGIN @{ print "Non v\47allarmate!" @}'
address@hidden example
+
address@hidden
+si potrebbe scrivere invece address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{awk "BEGIN @{ print \"Non v'allarmate!\" @}"}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden apice singolo (@code{'}), con doppio apice
address@hidden @code{'} (apice singolo), con doppio apice
+Va notato che l'apice singolo non @`e speciale all'interno di un testo
+racchiuso tra doppi apici.
+
address@hidden
+Le stringhe nulle sono rimosse se presenti come parte di un argomento
+non-nullo sulla riga di comando, mentre oggetti esplicitamente nulli
+sono mantenuti come tali.
+Per esempio, per richiedere che il separatore di campo @code{FS} sia
+impostato alla stringa nulla, digitare:
+
address@hidden
+awk -F "" '@var{programma}' @var{file} # corretto
address@hidden example
+
address@hidden
address@hidden stringa nulla come argomento a @command{gawk}, protezione della
+Non @`e invece da usare:
+
address@hidden
+awk -F"" '@var{programma}' @var{file} # errato!
address@hidden example
+
address@hidden
+Nel secondo caso, @command{awk} tenta di usare il nome del programma come
+valore di @code{FS}, e il primo @value{FN} come testo del programma!
address@hidden come minimo genera un errore di sintassi, e un comportamento
confuso nel
+caso peggiore.
address@hidden itemize
+
address@hidden protezione, nella riga di comando di @command{gawk}, trucchi per
+Mischiare apici singoli e doppi @`e difficile. Occorre utilizzare
+trucchi della shell per gli apici, come questi:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un apice singolo. <'"'"'>" @}'}
address@hidden Questo @`e un apice singolo. <'>
address@hidden example
+
address@hidden
+Questo programma stampa tre stringhe tra apici concatenate tra loro.
+La prima e la terza sono rinchiuse tra apici singoli, la seconda tra apici
+doppi.
+
+Quanto sopra address@hidden essere ``semplificato'' address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un apice singolo <'\''>" @}'}
address@hidden Questo @`e un apice singolo <'>
address@hidden example
+
address@hidden
+A voi la scelta del address@hidden leggibile dei due.
+
+Un'altra opzione @`e quella di usare doppi apici, proteggendo i doppi apici
+inclusi, a livello @command{awk}:
+
address@hidden
+$ @kbd{awk "BEGIN @{ print \"Questo @`e un apice singolo <'>\" @}"}
address@hidden Questo @`e un apice singolo <'>
address@hidden example
+
address@hidden
+Quest'opzione @`e fastidiosa anche perch@'e il doppio apice, la barra inversa e
+il simbolo del dollaro sono molto comuni nei programmi @command{awk}
address@hidden
+avanzati.
+
+Una terza opzione @`e quella di usare le sequenze ottali equivalenti
+(@pxref{Sequenze di protezione})
+per i caratteri
+apice singolo e doppio, address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un apice singolo <\47>" @}'}
address@hidden Questo @`e un apice singolo <'>
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un doppio apice <\42>" @}'}
address@hidden Questo @`e un doppio apice <">
address@hidden example
+
address@hidden
+Questo funziona bene, ma sai dovrebbe commentare chiaramente quel che
+il testo protetto significa.
+
+Una quarta address@hidden @`e di usare assegnamenti di variabili sulla riga di
+comando, address@hidden@dotless{i}}:
+
address@hidden
address@hidden awk -v sq="'" 'BEGIN @{ print "Questo @`e un apice singolo <" sq
">" @}'}
address@hidden Questo @`e un apice singolo <'>
address@hidden example
+
+(Qui, le due stringhe costanti e il valore di @code{sq} sono concatenati in
+un'unica stringa che @`e stampata da @code{print}.)
+
+Se servono veramente sia gli apici singoli che quelli doppi nel proprio
+programma @command{awk}, @`e probabilmente meglio tenerlo in un file separato,
+dove la shell non interferisce, e si address@hidden scrivere quello che si
vuole.
+
address@hidden Doppi apici in DOS
address@hidden Doppi apici in file .BAT Windows
+
address@hidden
+Date: Wed, 21 May 2008 09:58:43 +0200 (CEST)
+From: address@hidden
+Subject: (g)awk "contribution"
+To: address@hidden
+Message-id: <address@hidden>
+
+Hello Arnold,
+
+maybe you can help me out. Found your email on the GNU/awk online manual
+pages.
+
+I've searched hard to figure out how, on Windows, to print double quotes.
+Couldn't find it in the Quotes area, nor on google or elsewhere. Finally i
+figured out how to do this myself.
+
+How to print all lines in a file surrounded by double quotes (on Windows):
+
+gawk "{ print \"\042\" $0 \"\042\" }" <file>
+
+Maybe this is a helpfull tip for other (Windows) gawk users. However, i
+don't have a clue as to where to "publish" this tip! Do you?
+
+Kind regards,
+
+Jeroen Brink
address@hidden ignore
+
+Sebbene questo @value{DOCUMENT} in generale si preoccupi solo di sistemi POSIX
+e della shell POSIX, il problema che stiamo per vedere emerge abbastanza
+spesso presso parecchi utenti, e per questo ne parliamo.
+
address@hidden Brink, Jeroen
+Le ``shell'' nei sistemi Microsoft Windows usaso il carattere doppio apice
+per protezione, e rendono difficile o impossibile inserire un carattere
+doppio apice in uno @dfn{script} scritto su una riga di comando.
+l'esempio che segue, per il quale ringraziamo Jeroen Brink, mostra come
+stampare tutte le righe di un file, racchiudendole tra doppi apici:
+
address@hidden
+gawk "@{ print \"\042\" $0 \"\042\" @}" @var{file}
address@hidden example
+
+
address@hidden File dati di esempio
address@hidden @value{DDF} per gli esempi
+
address@hidden input file, esempi
address@hidden file di @code{mail-list}
+Molti degli esempi in questo @value{DOCUMENT} hanno come input due @value{DF}
+di esempio. Il primo, @file{mail-list}, contiene una lista di nomi di
+persone, insieme ai loro indirizzi email e a informazioni riguardanti le
+persone stesse.
+Il secondo @value{DF}, di nome @file{inventory-shipped}, contiene
+informazioni riguardo a consegne mensili. In entrambi i file,
+ogni riga @`e considerata come un @dfn{record}.
+
+Nel @file{mail-list}, ogni record contiene il nome di una persona,
+il suo numero di telefono, il suo indirizzo email, e un codice che indica
+la sua relazione con l'autore della lista.
+Le colonne sono allineate usando degli spazi.
+Una @samp{A} nell'ultima colonna indica che quella persona @`e un conoscente
+[Acquaintance]. Una @samp{F} nell'ultima colonna significa che quella
+persona @`e un amico [Friend]. Una @samp{R} vuol dire che quella persona @`e
+un parente [Relative]:
+
address@hidden
address@hidden system if test ! -d eg ; then mkdir eg ; fi
address@hidden system if test ! -d eg/lib ; then mkdir eg/lib ; fi
address@hidden system if test ! -d eg/data ; then mkdir eg/data ; fi
address@hidden system if test ! -d eg/prog ; then mkdir eg/prog ; fi
address@hidden system if test ! -d eg/misc ; then mkdir eg/misc ; fi
address@hidden file eg/data/mail-list
+Amelia 555-5553 amelia.zodiacusque@@gmail.com F
+Anthony 555-3412 anthony.asserturo@@hotmail.com A
+Becky 555-7685 becky.algebrarum@@gmail.com A
+Bill 555-1675 bill.drowning@@hotmail.com A
+Broderick 555-0542 broderick.aliquotiens@@yahoo.com R
+Camilla 555-2912 camilla.infusarum@@skynet.be R
+Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
+Julie 555-6699 julie.perscrutabor@@skeeve.com F
+Martin 555-6480 martin.codicibus@@hotmail.com A
+Samuel 555-3430 samuel.lanceolis@@shu.edu A
+Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden endfile
address@hidden example
+
address@hidden file @code{inventory-shipped}
+Il @value{DF} @file{inventory-shipped} contiene
+informazioni sulle consegne effettuate durante l'anno.
+Ogni record contiene il mese, il numero di contenitori verdi spediti,
+il numero di scatole rosse spedite, il numero di borse arancione spedite,
+e il numero di pacchetti blu spediti, in quest'ordine.
+Ci sono 16 record, relativi ai dodici mesi dello scorso anno e ai primi
+quattro mesi dell'anno in corso.
+Una riga vuota separa i data relativi a ciascun anno:
+
address@hidden
address@hidden file eg/data/inventory-shipped
+Jan 13 25 15 115
+Feb 15 32 24 226
+Mar 15 24 34 228
+Apr 31 52 63 420
+May 16 34 29 208
+Jun 31 42 75 492
+Jul 24 34 67 436
+Aug 15 34 47 316
+Sep 13 55 37 277
+Oct 29 54 68 525
+Nov 20 87 82 577
+Dec 17 35 61 401
+
+Jan 21 36 64 620
+Feb 26 58 80 652
+Mar 24 75 70 495
+Apr 21 70 74 514
address@hidden endfile
address@hidden example
+
+Questi file di esempio sono inclusi nella distribuzione @command{gawk},
+nella directory @file{awklib/eg/data}.
+
address@hidden Molto semplice
address@hidden Alcuni esempi molto semplici
+
+I seguenti comandi eseguono un semplice programma @command{awk} che cerca
+nel file in input @file{mail-list} la stringa di caratteri @samp{li} (una
+sequenza di caratteri @`e solitamente chiamato una @dfn{stringa};
+il termine @dfn{stringa} @`e basato su un uso linguistico, del tipo
+``una stringa di perle'' o ``una stringa di luci decorative''):
+
address@hidden
+awk '/li/ @{ print $0 @}' mail-list
address@hidden example
+
address@hidden
+Quando si incontra una riga che contiene @samp{li}, la si stampa, perch@'e
address@hidden@samp{print $0}} significa "stampa la riga corrente". (Lo
scrivere solo
address@hidden ha lo stesso significato, quindi avremmo anche potuto
+limitarci a fare address@hidden@dotless{i}}).
+
+Si address@hidden notato che delle barre (@samp{/}) delimitano la stringa
@samp{li}
+nel programma @command{awk}. Le barre indicano che @samp{li} @`e il
+modello da ricercare. Questo tipo di notazione @`e definita come
address@hidden regolare}, e address@hidden trattata address@hidden avanti in
maggior dettaglio
address@hidden
+(@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}).
address@hidden ifnottex
+Il modello address@hidden corrispondere anche solo a una parte di una parola.
+Ci sono
+apici singoli che racchiudono il programma @command{awk} in modo che la
+shell non interpreti alcuna parte di esso come un carattere speciale della
+shell.
+
+Questo @`e quello che il programma stampa:
+
address@hidden
+$ @kbd{awk '/li/ @{ print $0 @}' mail-list}
address@hidden Amelia 555-5553 amelia.zodiacusque@@gmail.com F
address@hidden Broderick 555-0542 broderick.aliquotiens@@yahoo.com R
address@hidden Julie 555-6699 julie.perscrutabor@@skeeve.com F
address@hidden Samuel 555-3430 samuel.lanceolis@@shu.edu A
address@hidden example
+
address@hidden azioni, default
address@hidden criteri di ricerca, default
+In una regola @command{awk}, il criterio di selezione o l'azione possono
+essere omessi, ma non entrambi. Se il criterio @`e omesso, l'azione viene
+applicata a @emph{ogni} riga dell'input.
+Se l'azione viene omessa, per default si stampano tutte le righe che
+sono individuate dal criterio di selezione.
+
address@hidden azioni, omesse
+Quindi, si potrebbe omettere l'azione (l'istruzione @code{print} e le
+graffe) nell'esempio precedente e il risultato sarebbe lo stesso:
address@hidden stampa tutte le righe che corrispondono al criterio di
+ricerca @samp{li}. Per confronto, omettendo l'istruzione @code{print} ma
+lasciando le graffe si richiede un'azione nulla, che non fa nulla
(address@hidden non
+stampa alcuna riga).
+
address@hidden programmi @command{awk}, esempi molto corti
+Molti programmi @command{awk} pratici sono lunghi solo una o due righe.
+Qui sotto troviamo una collezione di programmi utili e corti, per iniziare.
+Alcuni di questi programmi contengono elementi del linguaggio che non sono
+ancora stati spiegati. (La descrizione del programma fornisce una buona
+idea di quel che si vuole ottenere, ma occorre leggere il resto del
address@hidden per divenire esperti in @command{awk}!)
+Molti degli esempi usano un @value{DF} di nome @file{data}. Questo serve solo
+a indicare la posizione del nome; se questi programmi devono venir usati per
+se stessi, sostituire i propri @value{FNS} al posto di @file{data}.
+Per futura memoria, si noti che spesso c'@`e address@hidden di un modo per
fare qualcosa
+in @command{awk}. In un altro momento, si potrebbe tornare a guardare questi
+esempi per vedere se si riescono a trovare modi differenti per fare le stesse
+cose mostrate qui appresso:
+
address@hidden @value{BULLET}
address@hidden
+Stampare ogni riga lunga address@hidden di 80 caratteri:
+
address@hidden
+awk 'length($0) > 80' data
address@hidden example
+
+L'unica regola presente ha un'espressione di relazione come modello
+e non ha azione---quindi applica l'azione di default, stampando il record.
+
address@hidden
+Stampare la lunghezza della riga in input address@hidden lunga:
+
address@hidden
+awk '@{ if (length($0) > max) max = length($0) @}
+ END @{ print max @}' data
address@hidden example
+
+Il codice associato a @code{END} viene eseguito dopo che tutto
+l'input @`e stato letto; @`e l'altra faccia della medaglia di @code{BEGIN}.
+
address@hidden programma @command{expand}
address@hidden @command{expand}, programma
address@hidden
+Stampare la lunghezza della riga address@hidden lunga in @file{data}:
+
address@hidden
+expand data | awk '@{ if (x < length($0)) x = length($0) @}
+ END @{ print "la lunghezza massima di una riga @`e" x @}'
address@hidden example
+
+Questo esempio @`e leggermente diverso da quello precedente:
+l'input @`e l'output del comando @command{expand}, che cambia i TAB
+in spazi, in modo che le larghezze confrontate siano quelle che sarebbero
+qualora le si stampasse, e non il numero dei caratteri di input su ogni
+riga. [il carattere TAB occupa un byte nel file, ma address@hidden generare
fino a
+otto spazi bianchi in fase di stampa.]
+
address@hidden
+Stampare ogni riga che abbia almeno un campo:
+
address@hidden
+awk 'NF > 0' data
address@hidden example
+
+Questa @`e una maniera facile per eliminare le righe vuote dal file (o
+piuttosto, per creare un nuovo file, simile al vecchio, ma nel quale le
+linee vuote sono state tolte).
+
address@hidden
+Stampare sette numeri casuali compresi tra 0 e 100, inclusi:
+
address@hidden
+awk 'BEGIN @{ for (i = 1; i <= 7; i++)
+ print int(101 * rand()) @}'
address@hidden example
+
address@hidden
+Stampare il numero totale di byte usato da un @var{elenco-file}:
+
address@hidden
+ls -l @var{elenco-file} | awk '@{ x += $5 @}
+ END @{ print "byte totali: " x @}'
address@hidden example
+
address@hidden
+Stampare il numero totale di kilobyte usati da @var{elenco-file}:
+
address@hidden Don't use \ continuation, not discussed yet
address@hidden Remember that awk does floating point division,
address@hidden no need for (x+1023) / 1024
address@hidden
+ls -l @var{elenco-file} | awk '@{ x += $5 @}
+ END @{ print "K-byte totali:", x / 1024 @}'
address@hidden example
+
address@hidden
+Stampare una lista in ordine alfabetico di tutti gli utenti del sistema
+[Unix]:
+
address@hidden
+awk -F: '@{ print $1 @}' /etc/passwd | sort
address@hidden example
+
address@hidden
+Contare le righe in un file:
+
address@hidden
+awk 'END @{ print NR @}' data
address@hidden example
+
address@hidden
+Stampare le righe pari nel @value{DF}:
+
address@hidden
+awk 'NR % 2 == 0' data
address@hidden example
+
+Se aveste usato invece l'espressione @samp{NR % 2 == 1},
+il programma avrebbe stampato le righe dispari.
address@hidden itemize
+
address@hidden Due regole
address@hidden Un esempio che usa due regole
address@hidden programmi @command{awk}
+
+Il programma @command{awk} legge il file in input una riga alla volta.
+Per ogni riga @command{awk} controlla la corrispondenza con ogni regola.
+Se viene trovata address@hidden di una corrispondenza, vengono eseguite
altrettante
+azioni, nell'ordine in cui appaiono nel programma @command{awk}.
+Se non viene trovata nessuna corrispondenza, non viene eseguita alcuna azione.
+
+Dopo aver elaborato tutte le regole che hanno corrispondenza con la riga (e
+pu@'o darsi che nessuna corrisponda), @command{awk} legge la riga successiva.
Comunque
address@hidden next},
address@hidden
+e @ref{Istruzione Nextfile}.)
address@hidden ifdocbook
address@hidden
+e anche @pxref{Istruzione nextfile}.)
address@hidden ifnotdocbook
+Si prosegue address@hidden@dotless{i}} finch@'e il programma raggiunge la fine
del file.
+Per esempio, il seguente programma @command{awk} contiene due regole:
+
address@hidden
+/12/ @{ print $0 @}
+/21/ @{ print $0 @}
address@hidden example
+
address@hidden
+La prima regola ha la stringa @samp{12} da cercare e
address@hidden $0} come
+azione. La seconda regola ha la
+stringa @samp{21} da cercare e ha ancora @samp{print $0} come azione.
+L'azione di ciascuna regola @`e racchiusa in una coppia di parentesi graffe.
+
+Questo programma stampa ogni riga che contiene la stringa
address@hidden @emph{oppure} la stringa @samp{21}. Se una riga contiene
entrambe
+le stringhe, @`e stampata due volte, una volta per ogni regola.
+
+Questo @`e address@hidden che capita se eseguiamo questo programma sui nostri
@value{DF},
address@hidden e @file{inventory-shipped}:
+
address@hidden
+$ @kbd{awk '/12/ @{ print $0 @}}
+> @kbd{/21/ @{ print $0 @}' mail-list inventory-shipped}
address@hidden Anthony 555-3412 anthony.asserturo@@hotmail.com A
address@hidden Camilla 555-2912 camilla.infusarum@@skynet.be R
address@hidden Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden Jan 21 36 64 620
address@hidden Apr 21 70 74 514
address@hidden example
+
address@hidden
+Si noti che la riga che inizia con @samp{Jean-Paul}
+nel file @file{mail-list}
address@hidden stata stampata due volte, una volta per ogni regola.
+
address@hidden Maggiore sofisticazione
address@hidden Un esempio address@hidden complesso
+
+Dopo aver imparato a eseguire alcuni semplici compiti, vediamo cosa possono
+fare i tipici programmi @command{awk}.
+Questo esempio mostra come @command{awk} address@hidden essere usato per
riassumere,
+selezionare e riordinare l'output di un altro comando. Sono usate
address@hidden di cui non si @`e ancora parlato, quindi non ci si deve
preoccupare
+se alcuni dettagli risulteranno oscuri:
+
address@hidden
+ls -l | awk '$6 == "Nov" @{ somma += $5 @}
+ END @{ print somma @}'
address@hidden example
+
address@hidden comando @command{ls}
+Questo comando stampa il numero totale di byte in tutti i file contenuti
+nella directory corrente, la cui data di modifica @`e novembre (di qualsiasi
+anno). La parte @address@hidden -l}} dell'esempio @`e un comando di sistema
che
+fornisce un elenco dei file in una directory, con anche la dimensione di
+ogni file e la data di ultima modifica. Il suo output @`e del tipo:
+
address@hidden
+-rw-r--r-- 1 arnold user 1933 Nov 7 13:05 Makefile
+-rw-r--r-- 1 arnold user 10809 Nov 7 13:03 awk.h
+-rw-r--r-- 1 arnold user 983 Apr 13 12:14 awk.tab.h
+-rw-r--r-- 1 arnold user 31869 Jun 15 12:20 awkgram.y
+-rw-r--r-- 1 arnold user 22414 Nov 7 13:03 awk1.c
+-rw-r--r-- 1 arnold user 37455 Nov 7 13:03 awk2.c
+-rw-r--r-- 1 arnold user 27511 Dec 9 13:07 awk3.c
+-rw-r--r-- 1 arnold user 7989 Nov 7 13:03 awk4.c
address@hidden example
+
address@hidden
address@hidden continuazione di riga, nella C shell
+Il primo campo contiene le autorizzazioni di lettura/scrittura [r/w], il
+secondo il numero dei collegamenti al file address@hidden il numero di nomi
con cui
+il file @`e conosciuto], e il terzo campo identifica il proprietario del file.
+Il quarto campo identifica il gruppo a cui appartiene il file.
+Il quinto campo contiene la dimensione del file, in byte.
+Il sesto, settimo e ottavo campo contengono il mese, il giorno e l'ora,
+rispettivamente, in cui il file @`e stato modificato. Infine, il nono campo
+contiene il @value{FN}.
+
address@hidden @cindex automatic initialization
address@hidden inizializzazione automatica
+L'espressione @samp{$6 == "Nov"} nel nostro programma @command{awk} controlla
+se il sesto campo dell'output di @address@hidden -l}} corrisponda alla stringa
address@hidden Ogni volta che una riga ha la stringa
address@hidden come suo sesto campo, @command{awk} esegue l'azione
address@hidden += $5}. Questo aggiunge il quinto campo (la dimensione del file)
+alla variabile @code{somma}. Come risultato, quando @command{awk} ha finito
+di leggere tutte le righe in input, @code{somma} contiene la somma totale
+delle dimensioni dei file che corrispondono al criterio di ricerca.
+(address@hidden funziona contando sul fatto che le variabili @command{awk} sono
+automaticamente inizializzate a zero.)
+
+Dopo che l'ultima riga dell'output di @command{ls} @`e stata elaborata, la
+regola @code{END} viene eseguita e viene stampato il valore di @code{somma}.
+In questo esempio, il valore di @code{somma} @`e 80600.
+
+Queste tecniche address@hidden avanzate di @command{awk} sono trattate in
address@hidden
+successive (@pxref{Panoramica sulle azioni}). Prima di poter passare a una
+programmazione address@hidden avanzata con @command{awk}, @`e necessario
sapere come
address@hidden interpreta i file in input e visualizza quelli in output.
+Modificando campi e usando l'istruzione @code{print} @`e possibile produrre
+dei rapporti molto utili ed esteticamente gradevoli.
+
address@hidden Istruzioni/Righe
address@hidden Istruzioni e righe in @command{awk}
address@hidden interruzioni di riga
address@hidden andare a capo
+
+Molto spesso, ogni riga di un programma @command{awk} @`e un'istruzione a s@'e
+stante o una regola isolata, come:
+
address@hidden
+awk '/12/ @{ print $0 @}
+ /21/ @{ print $0 @}' mail-list inventory-shipped
address@hidden example
+
address@hidden @command{gawk}, andare a capo
+Comunque, @command{gawk} ignora i ritorni a capo dopo ognuno di questi
+simboli e istruzioni:
+
address@hidden
+, @{ ? : || && do else
address@hidden example
+
address@hidden
+Un ritorno a capo in ogni altro punto del programma @`e considerato come la
+fine di un'address@hidden @samp{?} e i @samp{:} elencati sopra sono
+usati nell'espressione condizionale in tre parti descritta in
address@hidden condizionali}.
+Il cambio di riga dopo @samp{?} e i @samp{:} @`e un'estensione minore in
address@hidden; specificando @option{--posix} come opzione
+(@pxref{Opzioni}), quest'estensione non @`e valida.}
+
address@hidden @code{\} (barra inversa), continuazione di riga e
address@hidden barra inversa (@code{\}), continuazione di riga e
+Volendo dividere una sola istruzione su due righe in un punto in cui
+andando a capo sarebbe considerata conclusa, @`e possibile @dfn{continuare}
+nella riga successiva terminando la prima riga con un carattere di
+barra inversa (@samp{\}). La barra inversa dev'essere l'ultimo carattere
+sulla riga, per essere riconosciuto come un carattere di continuazione.
+Una barra inversa @`e consentita in ogni parte dell'istruzione, anche in mezzo
+a una stringa o a un'espressione regolare. Per esempio:
+
address@hidden
+awk '/Questa espressione regolare @`e troppo lunga, quindi\
+ la continuiamo sulla riga seguente/ @{ print $1 @}'
address@hidden example
+
address@hidden
address@hidden address@hidden, continuazione di riga con barra inversa e
+Non abbiamo quasi mai usato la continuazione tramite barra inversa nei nostri
+programmi di esempio. @command{gawk} non pone limiti alla lunghezza di
+una riga, quindi la continuazione tramite barra inversa non @`e mai
strettamente
+necessaria; serve soltanto a migliorare la address@hidden del programma.
+Per la stessa ragione, ma anche per amore di chiarezza, abbiamo tenuto
+concise molte istruzioni nei programmi presentati in questo @value{DOCUMENT}.
+La continuazione tramite barra inversa @`e molto utile quando il proprio
+programma @command{awk} si trova in un file sorgente separato, invece di
+essere immesso nella riga di comando. Si noti anche che molte implementazioni
+di @command{awk} presentano delle differenze su dove @`e possibile usare
+la continuazione tramite barra inversa. Per esempio, potrebbero non
+consentire di spezzare una costante di tipo stringa usando la continuazione
+tramite barra inversa. Quindi, per ottenere la massima address@hidden dei
+propri programmi @command{awk}, @`e meglio non spezzare le righe nel
+mezzo di un'espressione regolare o di una stringa.
address@hidden 10/2000: gawk, mawk, and current bell labs awk allow it,
address@hidden solaris 2.7 nawk does not. Solaris /usr/xpg4/bin/awk does
though! sigh.
+
address@hidden comando @command{csh}
address@hidden barra inversa (@code{\}), continuazione di riga e, in
@command{csh}
address@hidden @code{\} (barra inversa), continuazione di riga e, in
@command{csh}
address@hidden ATTENZIONE
address@hidden continuazione tramite barra inversa non funziona come sopra
descritto
+nella C shell.} Funziona per programmi @command{awk} contenuti in file e
+per programmi sulla riga di comando, @emph{ammesso} che si stia usando una
+shell conforme a POSIX, come la Unix Bourne shell o Bash. Ma la C shell si
+comporta in maniera diversa! In quel caso, occorre usare due barre inverse
+consecutive, in fondo alla riga. Si noti anche che quando si usa la C shell
address@hidden andata a capo nel vostro programma @command{awk} deve essere
+indicata con una barra inversa. Per esempio:
+
address@hidden
+% @kbd{awk 'BEGIN @{ \}
+? @kbd{ print \\}
+? @kbd{ "ciao, mondo" \}
+? @address@hidden'}
address@hidden ciao, mondo
address@hidden example
+
address@hidden
+Qui, il @samp{%} e il @samp{?} sono i prompt primario e secondario della
+C shell, analogamente a quelli usati nella shell standard @samp{$} e @samp{>}.
+
+Si confronti l'esempio precedente, come viene scritto in una shell conforme
+a POSIX:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{print \}
+> @kbd{"ciao, mondo"}
+> @address@hidden'}
address@hidden ciao, mondo
address@hidden example
address@hidden quotation
+
address@hidden @`e un linguaggio orientato alla riga. L'azione relativa a ogni
+regola deve iniziare sulla stessa riga del criterio di selezione. Per avere
+criterio di selezione e azione su righe separate, si
address@hidden usare la continuazione tramite barra inversa; non si
address@hidden fare
+diversamente.
+
address@hidden barra inversa (@code{\}), continuazione di riga, commenti e
address@hidden @code{\} (barra inversa), continuazione di riga, commenti e
address@hidden commenti, continuazione di riga con barra inversa e i
+Un'altra cosa da tener presente @`e che la continuazione tramite barra inversa
e
+i commenti non possono essere frammisti. Non appena @command{awk} incontra
+un @samp{#} che inizia un commento, ignora @emph{tutto} il resto della riga.
+Per esempio:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print "Non allarmarti" # una amichevole \}
+> @kbd{ regola BEGIN}
+> @address@hidden'}
address@hidden gawk: riga com.:2: regola BEGIN
address@hidden gawk: riga com.:2: ^ syntax error
address@hidden example
+
address@hidden
+In questo caso, parrebbe che la barra inversa continui il commento sulla riga
+successiva. Invece, la combinazione barra inversa-ritorno a capo non viene
+per nulla notata, in quanto ``nascosta'' all'interno del commento. Quindi,
+il @code{BEGIN} @`e marcato come errore di sintassi.
+
address@hidden istruzioni multiple
address@hidden @code{;} (punto e virgola), separare istruzioni nelle azioni
address@hidden punto e virgola (@code{;}), separare istruzioni nelle azioni
+Quando le istruzioni @command{awk} all'interno di una regola sono brevi, si
+potrebbe metterne address@hidden d'una su una riga sola. address@hidden @`e
possibile separando le
+istruzioni con un punto e virgola (@samp{;}).
+Questo vale anche per le regole stesse.
+Quindi, il programma visto all'inizio di
address@hidden
+questa
address@hidden ifnotinfo
address@hidden
+questo
address@hidden ifinfo
address@hidden
+poteva essere scritto anche address@hidden@dotless{i}}:
+
address@hidden
+/12/ @{ print $0 @} ; /21/ @{ print $0 @}
address@hidden example
+
address@hidden NOTA BENE
+La address@hidden che address@hidden regole coesistano sulla stessa riga, se
sono separate
+da un punto e virgola, non esisteva nel linguaggio @command{awk} originale;
address@hidden stata aggiunta per congruenza con quanto @`e consentito per le
istruzioni
+all'interno di un'azione.
address@hidden quotation
+
address@hidden Altre address@hidden
address@hidden Altre address@hidden di @command{awk}
+
address@hidden variabili
+Il linguaggio @command{awk} mette a disposizione un numero di variabili
address@hidden, o @dfn{predefinite}, che il programma dell'utente
address@hidden usare
+per ottenere informazioni da @command{awk}. Ci sono pure altre variabili
+che il programma address@hidden impostare, per definire come @command{awk} deve
+gestire i dati.
+
+Inoltre, @command{awk} mette a disposizione parecchie funzioni predefinite
address@hidden per effettuare calcoli di tipo comune e operazioni che
+agiscono sulle stringhe di caratteri.
address@hidden mette a disposizione funzioni predefinite per gestire le
+marcature temporali, per effettuare manipolazioni a livello di bit, per
+tradurre stringhe al momento dell'esecuzione del programma
+(internazionalizzazione), per determinare qual @`e il tipo di una variabile,
+e per ordinare dei vettori.
+
+Nel seguito della presentazione del linguaggio @command{awk}, saranno
+introdotte molte delle variabili e parecchie funzioni. Esse sono
+descritte sistematicamente in @ref{Variabili predefinite} e in
address@hidden
+
address@hidden Quando
address@hidden Quando usare @command{gawk}
+
address@hidden @command{awk}, uso di
+Ora che abbiamo visto qualcosa di quel che @command{awk} @`e in grado di fare,
+ci si address@hidden chiedere come @command{awk} potrebbe tornare utile.
Usando
+programmi di address@hidden, criteri di ricerca sofisticati, separatori
+di campo, istruzioni aritmetiche, e altri criteri di selezione, @`e possibile
+produrre degli output molto address@hidden complessi. Il linguaggio
@command{awk} @`e
+molto utile per fornire dei tabulati partendo da grandi address@hidden di dati
+grezzi, per esempio riassumendo informazioni dall'output di altri
+programmi di address@hidden come @command{ls}.
+(@xref{Maggiore sofisticazione}.)
+
+I programmi scritti con @command{awk} sono normalmente molto address@hidden
+corti dei loro equivalenti in altri linguaggi. address@hidden rende i
programmi
address@hidden facili da comporre e da utilizzare. Spesso i programmi
address@hidden possono essere scritti al volo a terminale, usati una volta sola
+e buttati via. Poich@'e i programmi @command{awk} sono interpretati, si
address@hidden
+evitare la (normalmente laboriosa) parte di compilazione nel ciclo tipico
+dello sviluppo software, ossia edita-compila-prova-correggi.
+
address@hidden Brian Kernighan, @command{awk} di
+In @command{awk} sono stati scritti programmi complessi, compreso un assembler
+completo, pluri-piattaforma per
address@hidden FOR_PRINT
address@hidden
+microprocessori a 8-bit (@pxrefil{Glossario}, per maggiori informazioni),
address@hidden iftex
address@hidden
+microprocessori a 8-bit (@pxref{Glossario}, per maggiori informazioni),
address@hidden ifnottex
address@hidden ifclear
address@hidden FOR_PRINT
+microprocessori a 8-bit,
address@hidden ifset
+e un assembler di microcodice per un computer dedicato esclusivamente
+al linguaggio Prolog.
+Le address@hidden dell'originale @command{awk} erano messe a dura prova
+da programmi di questa address@hidden, ma le versioni moderne sono
address@hidden robuste.
+
address@hidden programmi @command{awk}, complessi
+Se capita di scrivere programmi @command{awk} address@hidden lunghi di,
diciamo,
+qualche centinaio di righe, si potrebbe considerare la address@hidden di usare
+un linguaggio di programmazione differente da @command{awk}.
+La shell consente di ricercare stringhe ed espressioni regolari; inoltre
+consente di usare in maniera efficace i comandi di address@hidden del sistema.
+Python offre un piacevole equilibrio tra la address@hidden di una
programmazione
+ad alto livello, e la address@hidden di interagire a livello di sistema
address@hidden linguaggi di @dfn{script} popolari comprendono Ruby
+e Perl.}
+
address@hidden Sommario dell'introduzione
address@hidden Sommario
+
address@hidden FIXME: Review this chapter for summary of builtin functions
called.
address@hidden @value{BULLET}
address@hidden
+I programmi in @command{awk} consistono di coppie di
address@hidden di address@hidden
+
address@hidden
+Un'@var{azione} senza una @var{condizione di ricerca} viene sempre eseguita.
+L'@var{azione} di default per una condizione mancante @`e @address@hidden
print $0 @}}.
+
address@hidden
+Usare
address@hidden '@var{programma}' @var{file}}
+oppure
address@hidden -f @var{file-programma} @var{file}}
+per eseguire @command{awk}.
+
address@hidden
+Si address@hidden usare la notazione speciale @samp{#!} nella prima riga per
creare
+programmi @command{awk} che siano eseguibili direttamente.
+
address@hidden
+I commenti nei programmi @command{awk} iniziano con @samp{#} e continuano
+fino alla fine della stessa riga.
+
address@hidden
+Prestare attenzione ai problemi con gli apici nei programmi @command{awk}
+che facciano parte di uno @dfn{script} della shell (o di un file .BAT di
+MS-Windows).
+
address@hidden
+Si address@hidden usare la continuazione tramite barra inversa per continuare
righe di
+codice sorgente. Le righe sono continuate automaticamente dopo i simboli
+virgola, parentesi aperta, punto interrogativo, punto e virgola,
address@hidden||}, @samp{&&}, @code{do} ed @code{else}.
address@hidden itemize
address@hidden Invocare Gawk
address@hidden Eseguire @command{awk} e @command{gawk}
+
+Questo @value{CHAPTER} tratta di come eseguire @command{awk}, delle opzioni da
+riga di comando, sia quelle dello standard POSIX che quelle specifiche di
address@hidden, e di cosa fanno @command{awk} e @command{gawk} con gli
+argomenti che non sono opzioni.
+Prosegue poi spiegando come @command{gawk} cerca i file sorgenti,
+leggendo lo standard input assieme ad altri file, le variabili d'ambiente di
address@hidden, lo stato di ritorno di @command{gawk}, l'uso dei file inclusi,
+e opzioni e/o address@hidden obsolete e non documentate.
+
+Molte delle opzioni e address@hidden qui descritte sono trattate con
+maggior dettaglio nei capitoli successivi del @value{DOCUMENT}; gli argomenti
+presenti in questo @value{CHAPTER} che al momento non interessano si possono
+tranquillamente saltare.
+
address@hidden
+* Riga di comando:: Come eseguire @command{awk}.
+* Opzioni:: Opzioni sulla riga di comando e loro
+ significato.
+* Altri argomenti:: Nomi dei file in input e assegnamento di
+ valori a variabili.
+* Specificare lo standard input:: Come specificare lo standard input insieme ad
+ altri file.
+* Variabili d'ambiente:: Le variabili d'ambiente usate da
+ @command{gawk}.
+* Codice di ritorno:: Il codice di ritorno all'uscita da
+ @command{gawk}.
+* Includere file:: Come includere altri file nel proprio
+ programma.
+* Caricare librerie condivise:: Caricare librerie condivise nel
+ proprio programma.
+* Parti obsolete:: Opzioni e/o address@hidden obsolete.
+* Non documentato:: Opzioni e address@hidden non documentate.
+* Sommario invocazione:: Sommario invocazione.
address@hidden menu
+
address@hidden Riga di comando
address@hidden Come eseguire @command{awk}
address@hidden riga di comando, eseguire @command{awk} da
address@hidden @command{awk}, eseguire
address@hidden argomenti, riga di comando, eseguire @command{awk}
address@hidden opzioni sulla riga di comando, eseguire @command{awk}
+
+Ci sono due modi di eseguire @command{awk}: con un programma esplicito o con
+uno o address@hidden file di programma. Qui @`e mostrata la sintassi di
entrambi; le voci
+racchiuse tra address@hidden sono opzionali:
+
address@hidden
address@hidden address@hidden @option{-f} @var{file_di _programma}
address@hidden @var{file} @dots{}
address@hidden address@hidden address@hidden @code{'@var{programma}'}
@var{file} @dots{}
address@hidden display
+
address@hidden GNU, opzioni estese
address@hidden estese, opzioni
address@hidden opzioni estese
+In aggiunta alle tradizionali opzioni di una sola lettera in stile POSIX,
address@hidden consente anche le opzioni estese GNU.
+
address@hidden angolo buio, invocare @command{awk}
address@hidden @dfn{lint}, controlli con programma vuoto
address@hidden possibile invocare @command{awk} con un programma vuoto:
+
address@hidden
+awk '' file_dati_1 file_dati_2
address@hidden example
+
address@hidden @option{--lint}, opzione
address@hidden
+Fare address@hidden@dotless{i}} ha comunque poco senso; @command{awk} termina
+silenziosamente quando viene fornito un programma vuoto.
address@hidden
+Se @`e stato specificato @option{--lint} sulla riga di comando,
address@hidden emette un avviso che avverte
+che il programma @`e vuoto.
+
address@hidden Opzioni
address@hidden Opzioni sulla riga di comando
address@hidden opzioni sulla riga di comando
address@hidden riga di comando, opzioni
address@hidden GNU, opzioni estese
address@hidden opzioni estese
+
+Le opzioni sono precedute da un trattino e consistono in un unico carattere.
+Le opzioni estese in stile GNU sono precedute da un doppio trattino e
+consistono in una parola
+chiave. La parola chiave address@hidden essere abbreviata, a condizione che
+l'abbreviazione identifichi univocamente l'opzione. Se l'opzione prevede un
+argomento, la parola chiave @`e immediatamente seguita da un segno di uguale
+(@samp{=}) e dal valore dell'argomento, oppure la parola chiave e il valore
+dell'argomento sono separati da spazi.
+Se un'opzione con un valore viene immessa address@hidden di una volta,
+l'ultimo valore @`e quello che conta.
+
address@hidden POSIX @command{awk}, opzioni estese GNU e
+Ogni opzione estesa di @command{gawk} ha una corrispondente opzione
+breve in stile POSIX.
+Le opzioni estese e brevi sono
+intercambiabili in tutti i contesti.
+L'elenco seguente descrive le opzioni richieste dallo standard POSIX:
+
address@hidden @code
address@hidden -F @var{fs}
address@hidden --field-separator @var{fs}
address@hidden @option{-F}, opzione
address@hidden @option{--field-separator}, opzione
address@hidden @code{FS}, variabile, l'opzione @code{--field-separator} e
+Imposta la variabile @code{FS} a @var{fs}
+(@pxref{Separatori di campo}).
+
address@hidden -f @var{file-sorgente}
address@hidden --file @var{file-sorgente}
address@hidden @option{-f}, opzione
address@hidden @option{--file}, opzione
address@hidden @command{awk}, programmi, collocazione dei
+Legge il sorgente del programma @command{awk} da @var{file-sorgente}
+anzich@'e prenderlo dal primo argomento che non @`e un'opzione.
+Quest'opzione address@hidden essere data address@hidden volte; il programma
@command{awk}
address@hidden formato dalla concatenazione del contenuto di ogni
address@hidden specificato.
+
address@hidden -v @address@hidden
address@hidden --assign @address@hidden
address@hidden @option{-v}, opzione
address@hidden @option{--assign}, opzione
address@hidden variabili, impostazione
+Imposta la variabile @var{var} al valore @var{val} @emph{prima} che inizi
+l'esecuzione del programma. Tali valori di variabile sono disponibili
+all'interno della regola @code{BEGIN}
+(@pxref{Altri argomenti}).
+
+L'opzione @option{-v} address@hidden impostare una sola variabile per volta,
ma address@hidden
+essere usata address@hidden di una volta, impostando ogni volta una variabile
+differente, in questo modo:
address@hidden @w{-v pippo=1} @w{-v pluto=2} @dots{}}.
+
address@hidden predefinite, variabili, opzione @address@hidden impostare con
address@hidden variabili predefinite, impostare con opzione @code{-v}
address@hidden ATTENZIONE
+Usare @option{-v} per impostare valori di variabili predefinite
address@hidden condurre a risultati sorprendenti. @command{awk} address@hidden
i
+valori di quelle variabili secondo le sue address@hidden, anche ignorando
+eventuali valori iniziali che possono essere stati assegnati.
address@hidden quotation
+
address@hidden -W @var{gawk-opt}
address@hidden @option{-W}, opzione
+Fornisce un'opzione specifica dell'implementazione. Questa @`e la convenzione
+POSIX per fornire opzioni specifiche dell'implementazione.
+Queste opzioni
+hanno anche una corrispondente opzione estesa scritta in stile GNU.
+Si noti che le opzioni estese possono essere abbreviate, sempre che
+le abbreviazioni siano univoche.
+L'elenco completo delle opzioni specifiche di @command{gawk} @`e riportato di
+seguito.
+
address@hidden --
address@hidden riga di comando, opzioni, fine delle
address@hidden opzioni sulla riga di comando, fine delle
+Segnale della fine delle opzioni da riga di comando. I seguenti argomenti
+non sono trattati come opzioni anche se iniziano con @samp{-}. Questa
+interpretazione di @option{--} segue le convenzioni POSIX per l'analisi degli
+argomenti.
+
address@hidden @code{-} (meno), nomi di file che iniziano con
address@hidden meno (@code{-}), nomi di file che iniziano con
address@hidden utile se si hanno @value{FNS} che iniziano con @samp{-},
+o negli @dfn{script} di shell, se si hanno @value{FNS} che devono essere
+specificati dall'utente che potrebbero iniziare con @samp{-}.
address@hidden utile anche per passare opzioni al programma @command{awk};
+si veda @ref{Funzione getopt}.
address@hidden table
+
+L'elenco che segue descrive le opzioni specifiche di @command{gawk}:
+
address@hidden Have to use @asis here to get docbook to come out right.
address@hidden @asis
address@hidden @option{-b}
address@hidden @option{--characters-as-bytes}
address@hidden @option{-b}, opzione
address@hidden @option{--characters-as-bytes}, opzione
+Fa address@hidden@dotless{i}} che @command{gawk} tratti tutti i dati in input
come caratteri di un solo
+byte. In aggiunta, tutto l'output scritto con @code{print} o @code{printf}
+viene trattato come composto da caratteri contenuti in un solo byte.
+
+Normalmente, @command{gawk} segue lo standard POSIX e cerca di elaborare i suoi
+dati di input in accordo con la localizzazione corrente
+(@pxref{Localizzazioni}).
+Questo spesso address@hidden comportare la conversione di caratteri multibyte
in
+caratteri estesi (internamente), e address@hidden
+creare problemi o confusione se i dati di input non contengono caratteri
+multibyte validi. Quest'opzione @`e una maniera facile di dire a
@command{gawk}:
address@hidden le mani dai miei dati!''.
+
address@hidden @option{-c}
address@hidden @option{--traditional}
address@hidden @option{-c}, opzione
address@hidden @option{--traditional}, opzione
address@hidden address@hidden compatibile di (@command{gawk}), specificare
+Specifica la @address@hidden di address@hidden, nella quale le estensioni GNU
al
+linguaggio @command{awk} sono disabilitate; in questo modo @command{gawk} si
+comporta proprio come la versione di BWK @command{awk}.
+
address@hidden/GNU},
+che riassume le estensioni.
address@hidden FOR_PRINT
+Si veda anche
address@hidden@`a di address@hidden
address@hidden ifclear
+
address@hidden @option{-C}
address@hidden @option{--copyright}
address@hidden @option{-C}, opzione
address@hidden @option{--copyright}, opzione
address@hidden GPL (General Public License), stampare
+Stampa la versione ridotta della General Public License ed esce.
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-d}, opzione
address@hidden @option{--dump-variables}, opzione
address@hidden fornire una lista di tutte le variabili del programma
address@hidden @file{awkvars.out}, file
address@hidden file @file{awkvars.out}
address@hidden variabili globali, stampare una lista delle
+Stampa una lista ordinata di variabili globali, i loro tipi, e i valori finali
+in @var{file}. Se non viene fornito alcun @var{file}, stampa questa lista
+in un file chiamato @file{awkvars.out} nella directory corrente.
+Non sono consentiti spazi tra @option{-d} e @var{file}, se
address@hidden viene specificato.
+
address@hidden risoluzione di problemi, address@hidden variabili globali
address@hidden problemi, risoluzione di, address@hidden variabili globali
+Avere una lista di tutte le variabili globali @`e un buon modo per cercare
+refusi nei propri programmi.
+Si address@hidden usare quest'opzione anche se si ha un grosso programma con
tantissime
+funzioni, e si vuol essere sicuri che le funzioni non usino
+inavvertitamente variabili globali che sarebbero dovute essere locali
+(questo @`e un errore particolarmente facile da fare con nomi di variabile
+semplici come @code{i}, @code{j}, etc.).
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-D}, opzione
address@hidden @option{--debug}, opzione
address@hidden @command{awk}, debug, abilitare
+Abilita l'esecuzione del debug di programmi @command{awk}
+(@pxref{Debugging}).
+Per default, il debugger legge i comandi interattivamente dalla tastiera
+(standard input).
+L'argomento opzionale @var{file} consente di specificare un file con una lista
+di comandi per il debugger da eseguire in maniera non interattiva.
+Non sono consentiti spazi tra @option{-D} e @var{file}, se
address@hidden viene indicato.
+
address@hidden @option{-e} @var{testo-del-programma}
address@hidden @option{--source} @var{testo-del-programma}
address@hidden @option{-e}, opzione
address@hidden @option{--source}, opzione
address@hidden codice sorgente, combinare
+Fornisce del codice sorgente nel @var{testo-del-programma}.
+Quest'opzione consente di combinare il codice sorgente contenuto in file
+col codice sorgente immesso sulla riga di comando.
+Questo @`e particolarmente utile quando si hanno funzioni di libreria che si
+vogliono usare dai programmi da riga di comando
+(@pxref{AWKPATH (Variabile)}).
+
address@hidden @option{-E} @var{file}
address@hidden @option{--exec} @var{file}
address@hidden @option{-E}, opzione
address@hidden @option{--exec}, opzione
address@hidden @command{awk}, programmi, collocazione dei
address@hidden CGI, @command{awk} @dfn{script} per
+Simile a @option{-f}, legge il testo del programma @command{awk} da
address@hidden Ci sono due differenze rispetto a @option{-f}:
+
address@hidden @value{BULLET}
address@hidden
+Quest'opzione fa terminare l'elaborazione delle opzioni; qualsiasi
+altra cosa sulla riga di comando viene inoltrata direttamente al programma
address@hidden
+
address@hidden
+Le variabili da riga di comando della forma
address@hidden@address@hidden non sono ammesse.
address@hidden itemize
+
+Quest'opzione @`e particolarmente necessaria per le applicazioni World Wide Web
+CGI che passano argomenti attraverso le URL; l'uso di quest'opzione impedisce
+a un utente malintenzionato (o ad altri) di passare opzioni, assegnamenti o
+codice sorgente @command{awk} (con @option{-e}) all'applicazione
address@hidden maggiori dettagli,
+si veda la Sezione 4.4 di @uref{http://www.ietf.org/rfc/rfc3875,
+RFC 3875}. Si veda anche
address@hidden://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html,
+note esplicative spedite alla mailing list @command{gawk} bug}.}
+Quest'opzione dovrebbe essere usata
+con @dfn{script} @samp{#!}
+(@address@hidden eseguibili}), in questo modo:
+
address@hidden
+#! /usr/local/bin/gawk -E
+
address@hidden programma awk @`e qui @dots{}}
address@hidden example
+
address@hidden @option{-g}
address@hidden @option{--gen-pot}
address@hidden @option{-g}, opzione
address@hidden @option{--gen-pot}, opzione
address@hidden address@hidden, generare file oggetto
address@hidden file oggetto portabili, generare
+Analizza il programma sorgente e
+genera un file GNU @command{gettext} @dfn{portable object template} sullo
+standard output per tutte le costanti di tipo stringa che sono state marcate
+come da tradurre.
address@hidden,
+per informazioni su quest'opzione.
+
address@hidden @option{-h}
address@hidden @option{--help}
address@hidden @option{-h}, opzione
address@hidden @option{--help}, opzione
address@hidden GNU, opzioni estese, stampare una lista di
address@hidden opzioni, stampare una lista di
address@hidden stampa, lista di opzioni
+Stampa un messaggio sull'``uso'' riassumendo le opzioni brevi ed estese
+accettate da @command{gawk} ed esce.
+
address@hidden @option{-i} @var{file-sorgente}
address@hidden @option{--include} @var{file-sorgente}
address@hidden @option{-i}, opzione
address@hidden @option{--include}, opzione
address@hidden @command{awk}, programmi, collocazione dei
+Legge una libreria di sorgenti @command{awk} da @var{file-sorgente}.
+Quest'opzione @`e del tutto equivalente a usare la direttiva @code{@@include}
+all'interno del proprio programma. @`E molto simile all'opzione
address@hidden, ma ci sono due differenze importanti. Primo, quando viene usata
+l'opzione @option{-i}, il sorgente del programma non viene caricato se @`e
+stato caricato in precedenza, mentre con @option{-f}, @command{gawk} carica
+sempre il file. Secondo, poich@'e quest'opzione @`e pensata per essere usata
+con librerie di codice, @command{gawk} non riconosce tali file come
+costituenti l'input del programma principale. address@hidden@dotless{i}},
dopo l'elaborazione di
+un argomento @option{-i}, @command{gawk} si aspetta di trovare il codice
+sorgente principale attraverso l'opzione @option{-f} o sulla riga di comando.
+
address@hidden @option{-l} @var{ext}
address@hidden @option{--load} @var{ext}
address@hidden @option{-l}, opzione
address@hidden @option{--load}, opzione
address@hidden caricare estensioni
+Carica un'estensione dinamica denominata @var{ext}. Le estensioni sono
+memorizzate come librerie condivise di sistema.
+Quest'opzione ricerca la libreria usando la variabile d'ambiente
address@hidden Il suffisso corretto per la piattaforma in uso address@hidden
+fornito per default, address@hidden non @`e necessario specificarlo nel nome
+dell'estensione. La routine di inizializzazione dell'estensione dovrebbe
+essere denominata @code{dl_load()}. Un'alternativa @`e quella di usare la
+direttiva @code{@@load} all'interno del programma per caricare una libreria
+condivisa. Questa address@hidden avanzata @`e descritta in dettaglio in
address@hidden dinamiche}.
+
address@hidden @address@hidden
address@hidden @address@hidden@var{valore}]
address@hidden @option{-l}, opzione
address@hidden @option{--lint}, opzione
address@hidden @dfn{lint}, controlli, emissione di avvertimenti
address@hidden avvertimenti, emissione di
+Emette messaggi d'avvertimento relativi a costrutti dubbi o non portabili ad
+altre implementazioni di @command{awk}.
+Non sono consentiti spazi tra @option{-L} e @var{valore}, se
+viene indicato il @var{valore}.
+Alcuni avvertimenti vengono emessi quando @command{gawk} legge preliminarmente
+il programma. Altri vengono emessi quando il programma viene eseguito.
+Con l'argomento opzionale @samp{fatal}, gli avvertimenti @dfn{lint} sono
considerati
+come errori gravi. Potrebbe essere una misura drastica, address@hidden il suo
uso
address@hidden certamente lo sviluppo di programmi @command{awk} address@hidden
corretti.
+Con l'argomento opzionale @samp{invalid}, vengono emessi solo gli avvertimenti
+relativi a quello che @`e effettivamente non valido (address@hidden non ancora
+completamente implementata).
+
+Alcuni avvertimenti vengono stampati solo una volta, anche se i costrutti dubbi
+per i quali vengono emessi avvisi ricorrono diverse volte nel programma
address@hidden address@hidden, nell'eliminazione dei problemi rilevati da
address@hidden, bisogna porre attenzione a cercare tutte le occorrenze di ogni
+costrutto inappropriato. Siccome i programmi @command{awk} generalmente sono
+brevi, questa non @`e un'operazione gravosa.
+
address@hidden @option{-M}
address@hidden @option{--bignum}
address@hidden @option{-M}, opzione
address@hidden @option{--bignum}, opzione
+Chiede il calcolo con precisione arbitraria sui numeri. Quest'opzione non ha
+alcun effetto se @command{gawk} non @`e compilato per l'uso delle librerie GNU
+MPFR e MP
+(@pxref{Calcolo con precisione arbitraria}).
+
address@hidden @option{-n}
address@hidden @option{--non-decimal-data}
address@hidden @option{-n}, opzione
address@hidden @option{--non-decimal-data}, opzione
address@hidden address@hidden valori, abilitare l'interpretazione di
address@hidden address@hidden valori, abilitare l'interpretazione di
address@hidden risoluzione di problemi, opzione @code{--non-decimal-data}
+Abilita l'interpretazione automatica di valori ottali ed esadecimali
+nei dati di input
+(@pxref{Dati non decimali}).
+
address@hidden ATTENZIONE
+Quest'opzione address@hidden generare gravi malfunzionamenti nei vecchi
programmi.
+Usare con cautela. Si noti anche che
+quest'opzione potrebbe non essere address@hidden disponibile in una futura
versione di
address@hidden
address@hidden quotation
+
address@hidden @option{-N}
address@hidden @option{--use-lc-numeric}
address@hidden @option{-N}, opzione
address@hidden @option{--use-lc-numeric}, opzione
+Forza l'uso del carattere di separazione decimale della localizzazione
+quando analizza i dati in input
+(@pxref{Localizzazioni}).
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-o}, opzione
address@hidden @option{--pretty-print}, opzione
+Consente la stampa di una versione formattata elegantemente dei programmi
address@hidden Implica l'opzione @option{--no-optimize}.
+Per default il programma di output viene creato in un file
+chiamato @file{awkprof.out} (@pxref{Profilare}).
+L'argomento opzionale @var{file} consente di specificare un
address@hidden differente per l'output.
+Non sono consentiti spazi tra @option{-o} e @var{file}, se
address@hidden viene indicato.
+
address@hidden NOTA
+Nel passato, quest'opzione eseguiva anche il programma.
+Ora non @`e address@hidden address@hidden@dotless{i}}.
address@hidden quotation
+
address@hidden @option{-O}
address@hidden @option{--optimize}
address@hidden @option{--optimize}, opzione
address@hidden @option{-O}, opzione
+Abilita le ottimizzazioni di default nella rappresentazione interna del
+programma. Attualmente, questo comprende delle semplificazioni nell'uso
+di costanti e l'eliminazione delle code di chiamata nelle funzioni
+ricorsive [sostituzione della chiamata di funzione con dei salti
+diretti alla funzione].
+
+Queste ottimizzazioni sono abilitate per default.
+Quest'opzione rimane disponibile per address@hidden all'indietro.
+Tuttavia address@hidden essere usata per annullare l'effetto di una precedente
+opzione @option{-s} (si veda address@hidden sotto in questa lista).
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-p}, opzione
address@hidden @option{--profile}, opzione
address@hidden @command{awk}, profilatura, abilitare la
+Abilita la creazione del profilo di esecuzione di programmi @command{awk}
+(@pxref{Profilare}).
+Implicitamente viene forzata l'opzione @option{--no-optimize}.
+Per default, i profili vengono creati in un file chiamato @file{awkprof.out}.
+L'argomento opzionale @var{file} consente di specificare un altro
address@hidden per il file del profilo.
+Non sono consentiti spazi tra @option{-p} e @var{file}, se
+viene indicato un @var{file}.
+
+Il profilo contiene il numero di esecuzioni di ogni istruzione sul margine
+sinistro e il conteggio delle chiamate di funzione per ogni funzione.
+
address@hidden @option{-P}
address@hidden @option{--posix}
address@hidden @option{-P}, opzione
address@hidden @option{--posix}, opzione
address@hidden POSIX, address@hidden
address@hidden @command{gawk}, address@hidden disabilitare
+Opera in address@hidden POSIX rigorosa. Disabilita tutte le estensioni di
address@hidden (proprio come @option{--traditional}) e
+disabilita tutte le estensioni non consentite da POSIX.
+
address@hidden comuni}, per un sommario delle estensioni
+di @command{gawk} che sono disabilitate da quest'opzione.
+Inoltre,
+vengono applicate le seguenti
+restrizioni:
+
address@hidden @value{BULLET}
+
address@hidden ritorno a capo
address@hidden spazi vuoti, ritorno a capo invece che
address@hidden
+I ritorni a capo non sono consentiti dopo @samp{?} o @samp{:}
+(@pxref{Espressioni condizionali}).
+
+
address@hidden @code{FS}, variabile, come carattere TAB
address@hidden
+Specificando @samp{-Ft} sulla riga di comando non si imposta il valore
+della variabile @code{FS} a un singolo carattere TAB
+(@pxref{Separatori di campo}).
+
address@hidden localizzazione, separatore decimale della
address@hidden separatore decimale, carattere, specifico della localizzazione
address@hidden
+Il carattere di separatore decimale della localizzazione @`e usato per
analizzare
+i dati di input
+(@pxref{Localizzazioni}).
address@hidden itemize
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden @option{--traditional}, opzione, e opzione @code{--posix}
address@hidden @option{--posix}, opzione, e opzione @code{--traditional}
+Se si forniscono entrambe le opzioni @option{--traditional} e @option{--posix}
+sulla riga di comando, @option{--posix} ha la precedenza. Se vengono fornite
+entrambe le opzioni @command{gawk} emette un avviso.
+
address@hidden @option{-r}
address@hidden @option{--re-interval}
address@hidden @option{-r}, opzione
address@hidden @option{--re-interval}, opzione
address@hidden espressioni regolari, espressioni di intervallo e
+Consente le espressioni di intervallo
+(@pxref{Operatori di espressioni regolari})
+nelle espressioni regolari.
+Questo @`e ora il comportamento di default di @command{gawk}.
+Tuttavia, quest'opzione rimane (sia per address@hidden
+che per l'uso in combinazione con @option{--traditional}).
+
address@hidden @option{-s}
address@hidden @option{--no-optimize}
address@hidden @option{--no-optimize}, opzione
address@hidden opzione @option{--no-optimize}
address@hidden @option{-s}, opzione,
address@hidden opzione @option{-s}
+Disabilita le opzioni di ottimizzazione di default di @command{gawk}
+effettuate sulla rappresentazione interna del programma.
+
address@hidden @option{-S}
address@hidden @option{--sandbox}
address@hidden @option{-S}, opzione
address@hidden @option{--sandbox}, opzione
address@hidden sandbox, address@hidden
address@hidden prova, address@hidden di
+Disabilita la funzione @code{system()},
+la ridirezione dell'input con @code{getline},
+la ridirezione dell'output con @code{print} e @code{printf},
+e le estensioni dinamiche.
address@hidden particolarmente utile quando si vogliono eseguire @dfn{script}
@command{awk}
+da sorgenti dubbie e si vuol essere ricuri che gli @dfn{script} non abbiano
+accesso al sistema (oltre al @value{DF} di input specificato).
+
address@hidden @option{-t}
address@hidden @option{--lint-old}
address@hidden @option{-L}, opzione
address@hidden @option{--lint-old}, opzione
+Avvisa su costrutti che non sono disponibili nella versione originale di
address@hidden dalla versione 7 di Unix
+(@pxref{V7/SVR3.1}).
+
address@hidden @option{-V}
address@hidden @option{--version}
address@hidden @option{-V}, opzione
address@hidden @option{--version}, opzione
address@hidden @command{gawk}, versioni di, informazioni address@hidden stampa
+Stampa informazioni sulla versione di questa specifica copia di @command{gawk}.
+Consente di determinare se la copia di @command{gawk} in uso @`e aggiornata
+rispetto a quello che @`e attualmente in distribuzione da parte della Free
+Software Foundation.
address@hidden utile anche per la segnalazione di bug
+(@pxref{Bug}).
address@hidden table
+
+Ogni altra opzione, se @`e stato specificato il testo di un programma
address@hidden contrassegnata come non valida con un messaggio di avvertimento,
+altrimenti @`e ignorata.
+
address@hidden @option{-F}, opzione, opzione @option{-Ft} imposta @code{FS} a
TAB
+In address@hidden di address@hidden, come caso particolare, se il valore di
@var{fs}
+fornito all'opzione @option{-F} @`e @samp{t}, @code{FS} @`e impostata al
carattere
+TAB (@code{"\t"}). Questo @`e vero solo per @option{--traditional} e non
+per @option{--posix}
+(@pxref{Separatori di campo}).
+
address@hidden @option{-f}, opzione, usi multipli
+L'opzione @option{-f} address@hidden essere usata address@hidden di una volta
nella riga di comando.
+In questo caso, @command{awk} legge il sorgente del suo programma da tutti i
+file indicati, come se fossere concatenati assieme a formare un unico grande
+file.
+Questo @`e utile per creare librerie di funzioni di @command{awk}. Queste
+funzioni possono venir scritte una volta e in seguito recuperate da una
+posizione standard, invece di doverle includere in ogni singolo programma.
+L'opzione @option{-i} @`e simile in questo senso.
+(Come indicato in
address@hidden delle definizioni},
+i nomi di funzione devono essere univoci).
+
+Con @command{awk} standard, le funzioni di libreria si possono ancora usare,
+anche se il programma @`e immesso dalla tastiera,
+specificando @samp{-f /dev/tty}. Dopo aver scritto il programma,
+premere @kbd{Ctrl-d} (il carattere di fine file) per terminarlo.
+(Si potrebbe anche usare @samp{-f -} per leggere il sorgente del programma
+dallo standard input, ma poi non si address@hidden usare lo standard input
come sorgente
+di dati).
+
+Siccome @`e scomodo usare il meccanismo di @command{awk} standard per combinare
+file sorgenti e programmi @command{awk} da riga di comando, @command{gawk}
+fornisce l'opzione @option{-e}. Questo non richiede di evitare l'uso dello
+standard input per immettere codice sorgente; consente di combinare
+facilmente codice sorgente da riga di comando e da libreria
+(@pxref{AWKPATH (Variabile)}).
+Come per @option{-f}, le opzioni @option{-e} e @option{-i}
+si possono usare address@hidden volte nella riga di comando.
+
address@hidden @option{-e}, opzione
+Se non sono specificate opzioni @option{-f} o @option{-e}, @command{gawk}
+usa il primo argomento che non @`e un'opzione come testo del
+codice sorgente del programma.
+
address@hidden @env{POSIXLY_CORRECT}, variabile d'ambiente
address@hidden @dfn{lint}, controlli, variabile d'ambiente @env{POSIXLY_CORRECT}
address@hidden POSIX, address@hidden
+Se la variabile d'ambiente @env{POSIXLY_CORRECT} esiste,
address@hidden si comporta in address@hidden POSIX rigorosa, esattamente come se
+fosse stata fornita l'opzione @option{--posix}.
+Molti programi GNU cercano questa variabile d'ambiente per eliminare
+estensioni che confliggono con POSIX, ma @command{gawk} si comporta in modo
+diverso: sopprime tutte le estensioni, anche quelle che non confliggono con
+POSIX, e funziona rigorosamente in address@hidden POSIX.
+Se viene fornita l'opzione @option{--lint} sulla riga di comando e
address@hidden passa alla address@hidden POSIX a causa di @env{POSIXLY_CORRECT},
+viene emesso un messaggio di avvertimento indicando che @`e attiva la
address@hidden POSIX. Normalmente questa variabile si imposta nel file di avvio
+della shell a livello utente.
+Per una shell compatibile con Bourne (come Bash), queste righe andranno
+aggiunte nel file @file{.profile} della directory "home" dell'utente:
+
address@hidden
+POSIXLY_CORRECT=true
+export POSIXLY_CORRECT
address@hidden example
+
address@hidden @command{csh}, comando, variabile d'ambiente
@env{POSIXLY_CORRECT}
+Per una shell compatibile con C,@footnote{Non raccomandato.}
+questa riga address@hidden aggiunta nel file @file{.login} nella directory
"home"
+dell'utente:
+
address@hidden
+setenv POSIXLY_CORRECT true
address@hidden example
+
address@hidden address@hidden, variabile d'ambiente @env{POSIXLY_CORRECT}
+Avere @env{POSIXLY_CORRECT} impostata non @`e raccomandato per l'uso
quotidiano,
+ma @`e utile per provare la address@hidden dei programmi su altri
+ambienti.
+
address@hidden Altri argomenti
address@hidden Altri argomenti della riga di comando
address@hidden riga di comando, argomenti
address@hidden argomenti, riga di comando
+
+Qualsiasi altro argomento sulla riga di comando @`e trattato normalmente come
+file in input da elaborare nell'ordine con cui @`e specificato. Comunque, un
+argomento che ha la forma @address@hidden@var{valore}}, assegna
+il valore @var{valore} alla variabile @var{var}---non specifica affatto
+un file. (Si veda @ref{Opzioni di assegnamento}.) Nel seguente esempio,
address@hidden @`e un assegnamento di variabile, non un @value{FN}:
+
address@hidden
+awk -f programma.awk file1 count=1 file2
address@hidden example
+
address@hidden @command{gawk}, variabile @code{ARGIND} in
address@hidden @code{ARGIND}, variabile, argomenti da riga di comando
address@hidden @code{ARGV}, vettore, indicizzare all'interno di
address@hidden @code{ARGC}/@code{ARGV}, variabili, argomenti da riga di comando
+Tutti gli argomenti da riga di comando sono resi disponibili al programma
address@hidden nel vettore @code{ARGV} (@pxref{Variabili predefinite}).
Opzioni da
+riga di comando e il testo del programma (se presente) sono esclusi da
address@hidden Tutti gli altri argomenti, compresi gli assegnamenti di
+variabile, sono inclusi. Come ogni elemento di @code{ARGV} viene elaborato,
address@hidden imposta @code{ARGIND} all'indice in @code{ARGV}
+dell'elemento corrente.
+
address@hidden FIXME: One day, move the ARGC and ARGV node closer to here.
+La modifica di @code{ARGC} e @code{ARGV} nel proprio programma @command{awk}
+consente di controllare come @command{awk} elabora i file in input; questo @`e
+descritto address@hidden dettagliatamente in @ref{ARGC e ARGV}.
+
address@hidden file in input, assegnamenti di variabile e
address@hidden assegnamenti di variabile e file in input
+La distinzione tra argomenti che sono @value{FN} e argomenti di assegnamento
+di variabili vien fatta quando @command{awk} deve aprire il successivo file di
+input.
+A quel punto dell'esecuzione, controlla la variabile @value{FN} per vedere se
address@hidden piuttosto un assegnamento di variabile; se
address@hidden@dotless{i}} @`e, @command{awk} imposta la
+variabile invece di leggere un file.
+
+Dunque, le variabili ricevono effettivamente i valori loro assegnati dopo che
+tutti i file precedentemente specificati sono stati letti. In particolare, i
+valori delle variabili assegnati in questo modo @emph{non} sono disponibili
+all'interno di una regola @code{BEGIN}
+(@pxref{BEGIN/END}),
+poich@'e tali regole vengono eseguite prima che @command{awk} cominci a
+esaminare la lista degli argomenti.
+
address@hidden angolo buio, sequenze di protezione
+I valori delle variabili dati sulla riga di comando sono elaborati per
+rimuovere sequenze di protezione (@pxref{Sequenze di protezione}).
address@hidden
+
+In alcune implementazioni di @command{awk} molto vecchie, quando un
+assegnamento di variabile capitava prima di un qualsiasi @value{FN},
+l'assegnamento avveniva @emph{prima} che fosse stata eseguita la regola
address@hidden Il comportamento di @command{awk} era in questo modo
+ambiguo; alcuni assegnamenti da riga di comando erano disponibili
+all'interno della regola @code{BEGIN}, mentre altri no. Sfortunatamente,
+alcune applicazioni finivano per essere dipendenti da questa
address@hidden''. Quando @command{awk} fu modificato per essere address@hidden
+coerente, fu aggiunta l'opzione @option{-v} a beneficio delle
+applicazioni che dipendevano dal vecchio comportamento.
+
+La address@hidden dell'assegnamento di variabile @`e molto utile per assegnare
+valori a variabili come @code{RS}, @code{OFS}, e @code{ORS}, che controllano i
+formati di input e di output, prima di effettuare la scansione dei @value{DF}.
address@hidden utile anche per effettuare passaggi multipli su un o stesso
address@hidden Per esempio:
+
address@hidden file, passaggi multipli su
address@hidden
+awk 'pass == 1 @{ @var{pass 1 stuff} @}
+ pass == 2 @{ @var{pass 2 stuff} @}' pass=1 mydata pass=2 mydata
address@hidden example
+
+Una volta disponibile la address@hidden per assegnare una variabile, l'opzione
address@hidden per impostare il valore di @code{FS} non @`e address@hidden
strettamente
+necessaria. Rimane per address@hidden all'indietro.
+
address@hidden Specificare lo standard input
address@hidden Come specificare lo standard input insieme ad altri file
+
+Capita spesso di voler leggere lo standard input assieme ad altri file.
+Per esempio, leggere un file, leggere lo standard input derivante da una
address@hidden, e poi leggere un altro file.
+
+Il modo di indicare lo standard input, con tutte le versioni di @command{awk},
address@hidden quello di usare un segno meno o trattino da solo, @samp{-}. Per
esempio:
+
address@hidden
address@hidden | awk -f ilmioprogramma.awk file1 - file2
address@hidden example
+
address@hidden
+In questo caso, @command{awk} legge prima @file{file1}, poi legge
+l'output di @var{qualche_comando}, e infile legge
address@hidden
+
+Si address@hidden anche usare @code{"-"} per indicare lo standard input quando
si leggono
+i file con @code{getline} (@pxref{Getline file}).
+
+In aggiunta, @command{gawk} consente di specificare il
address@hidden speciale @file{/dev/stdin}, sia sulla riga di comando che
+quando si usa @code{getline}.
+Anche qualche altra versione di @command{awk} include questa address@hidden,
+ma non @`e standard.
+(Alcuni sistemi operativi prevedono un file @file{/dev/stdin}
+nel filesystem; comunque, @command{gawk} elabora sempre
+questo @value{FN} per conto suo [ossia non importa se il sistema
+operativo rende disponibile il file o no].)
+
address@hidden Variabili d'ambiente
address@hidden Le variabili d'ambiente usate da @command{gawk}
address@hidden variabili d'ambiente usate da @command{gawk}
+
+Diverse variabili d'ambiente influiscono sul comportamento
+di @command{gawk}.
+
address@hidden
+* AWKPATH (Variabile):: Ricerca di programmi @command{awk}
+ in una lista di directory.
+* AWKLIBPATH (Variabile):: Ricerca di librerie condivise
+ @command{awk} su varie directory.
+* Altre variabili d'ambiente:: Le variabili d'ambiente.
address@hidden menu
+
address@hidden AWKPATH (Variabile)
address@hidden Ricerca di programmi @command{awk} in una lista di directory.
address@hidden @env{AWKPATH}, variabile d'ambiente
address@hidden directory, ricerca di file sorgente
address@hidden percorso di ricerca per file sorgente
address@hidden ricerca, percorso di, per file sorgente
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
d'ambiente @env{AWKPATH}
address@hidden
+Il precedente @value{SECTION} ha descritto come i file di programma di
address@hidden possono essere specificati sulla riga di comando con
+l'opzione @option{-f}.
address@hidden ifinfo
+Nella maggior parte delle implementazioni di @command{awk} si deve indicare il
+percorso completo di ogni file di programma, a meno che il file non
+sia nella directory corrente. Con @command{gawk}, invece, se la
+variabile @value{FN} impostata con le opzioni @option{-f} o @option{-i} non
+contiene un separatore di directory @samp{/}, @command{gawk} cerca un file con
+quel nome in un elenco di directory (chiamato @dfn{percorso di ricerca}),
+scorrendole una per una.
+
+Il percorso di ricerca @`e una stringa di nomi di directory separati da due
address@hidden e virgola in MS-Windows.}. @command{gawk} prende
+il percorso di ricerca dalla variabile d'ambiente @env{AWKPATH}. Se questa
+variabile non esiste, o se ha un come valore la stringa nulla,
address@hidden usa un percorso di default (descritto tra poco).
+
+La address@hidden del percorso di ricerca @`e particolarmente utile per
costruire
+librerie di funzioni di @command{awk}. I file di libreria possono essere messi
+in una directory standard inclusa nel percorso di ricerca
+e richiamati sulla riga di comando con un
address@hidden breve. Altrimenti, si dovrebbe scrivere l'intero @value{FN} per
+ciascun file.
+
+Usando l'opzione @option{-i}, o l'opzione @option{-f}, i programmi di
address@hidden scritti sulla riga di comando possono usare le address@hidden
+contenute nei file di libreria di @command{awk}
address@hidden
+(@pxrefil{Funzioni di libreria}).
address@hidden iftex
address@hidden
+(@pxref{Funzioni di libreria}).
address@hidden ifnottex
+La ricerca del percorso non viene eseguita se @command{gawk} @`e in
address@hidden di
address@hidden, sia con l'opzione @option{--traditional} che con l'opzione
address@hidden
address@hidden
+
+Se il file del codice sorgente non viene trovato con una prima ricerca,
+il percorso viene cercato di nuovo dopo aver aggiunto il suffisso
address@hidden al @value{FN}.
+
+Il meccanismo di ricerca del percorso di @command{gawk} @`e simile a quello
+della shell.
+(Si veda @uref{http://www.gnu.org/software/bash/manual/,
address@hidden Bourne-Again SHell manual}}.)
+Un elemento nullo nel percorso indica la directory corrente.
+(Un elemento nullo @`e indicato iniziando o terminando il percorso con un segno
+di @samp{:} oppure mettendo due @samp{:} consecutivi address@hidden::}].)
+
address@hidden NOTA
+Per includere la directory corrente nel percorso di ricerca, si address@hidden
+aggiungere @file{.} come un elemento del percorso di ricerca, oppure
+inserire un elemento nullo.
+
+Diverse passate versioni di @command{gawk} avrebbero effettuato anche una
+ricerca esplicita nella directory corrente, prima o dopo aver esaminato il
+percorso di ricerca. A partire dalla @value{PVERSION} 4.1.2, questo non
+vale address@hidden; se si desidera una ricerca nella directory corrente, @`e
+necessario aggiungere @file{.} esplicitamente, oppure aggiungendo un
+elemento nullo al percorso di ricerca.
address@hidden quotation
+
+Il valore di default di @env{AWKPATH} @`e
address@hidden:/usr/local/share/address@hidden versione di @command{gawk}
+che state usando potrebbe usare una directory diversa; address@hidden dipende
da come
address@hidden @`e stato compilato e installato. La directory effettiva @`e il
+valore di @code{$(datadir)} generato quando @`e stato configurato
address@hidden Non @`e comunque il caso di preoccuparsi per questo.}
+Poich@'e @file{.} @`e incluso all'inizio, @command{gawk} cerca dapprima nella
+directory corrente, e poi in @file{/usr/local/share/awk}.
+In pratica, questo vuol dire che solo raramente ci address@hidden bisogno di
cambiare
+il valore di @env{AWKPATH}.
+
address@hidden da usare a inizio sessione}, per informazioni su funzioni che
possono
+essere di aiuto per gestire la variabile @env{AWKPATH}.
+
address@hidden memorizza il valore del percorso di ricerca in uso in
address@hidden"AWKPATH"]}. Questo consente di aver accesso al valore del
+percorso di ricerca in uso all'interno di un programma @command{awk}.
+
+Sebbene la variabile @code{ENVIRON["AWKPATH"]} possa
+essere cambiata anche all'interno di
+un programma @command{awk}, questo non modifica il comportamento del
+programma in esecuzione. Questo comportamento ha una sua logica: la variabile
+d'ambiente @env{AWKPATH} @`e usata per trovare i file sorgenti del programma;
una
+volta che il programma @`e in esecuzione, tutti i file sono stati trovati,
+e @command{gawk} non ha address@hidden bisogno di usare @env{AWKPATH}.
+
address@hidden AWKLIBPATH (Variabile)
address@hidden Ricerca di librerie condivise @command{awk} su varie directory.
address@hidden @env{AWKLIBPATH}, variabile d'ambiente
address@hidden directory, ricerca di estensioni caricabili
address@hidden percorso di ricerca per estensioni
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
d'ambiente @code{AWKLIBPATH}
+
+La variabile d'ambiente @env{AWKLIBPATH} @`e simile alla variabile
@env{AWKPATH},
+ma @`e usata per ricercare estensioni caricabili (memorizzate come
+librerie condivise di sistema) specificate con l'opzione @option{-l},
+anzich@'e file sorgenti. Se l'estensione non viene trovata, il percorso viene
+cercato nuovamente dopo aver aggiunto il suffisso per la libreria condivisa
+appropriato per la piattaforma. Per esempio, sui sistemi GNU/Linux viene usato
+il suffisso @samp{.so}. Il percorso di ricerca specificato @`e usato anche
+attraverso la direttiva @code{@@load}
+(@pxref{Caricare librerie condivise}).
+
+Se la variabile d'ambiente @env{AWKLIBPATH} non esiste, o se ha come valore
+la stringa nulla, @command{gawk} usa un percorso di ricerca di default;
+questo normalmente vale @samp{/usr/local/lib/gawk}, anche se il suo valore
address@hidden essere diverso, a seconda di come @`e stato installato
@command{gawk}.
+
address@hidden da usare a inizio sessione}, per informazioni su funzioni che
possono
+essere di aiuto per gestire la variabile @env{AWKPATH}.
+
address@hidden memorizza il valore del percorso di ricerca in uso in
address@hidden"AWKLIBPATH"]}. Questo consente di aver accesso al valore del
+percorso di ricerca in uso all'interno di un programma @command{awk}.
+
address@hidden Altre variabili d'ambiente
address@hidden Le variabili d'ambiente.
+
+Molte altre variabili d'ambiente influenzano il comportamento di
address@hidden, ma esse sono address@hidden specializzate. Quelle dell'elenco
seguente
+sono quelle address@hidden utili agli utenti normali:
+
address@hidden @env
address@hidden GAWK_MSEC_SLEEP
+Specifica l'intervallo tra due tentativi di riconnessione,
+in millisecondi. Sui sistemi che non prevedono
+la chiamata di sistema @code{usleep()},
+il valore @`e arrotondato a un numero intero di secondi .
+
address@hidden GAWK_READ_TIMEOUT
+Specifica per quanto tempo, in millisecondi, @command{gawk}
+aspetta l'input prima di emettere un messaggio di errore.
+
address@hidden GAWK_SOCK_RETRIES
+Controlla il numero di volte che @command{gawk} cerca di
+ristabilire una connessione bidirezionale TCP/IP (@dfn{socket}) prima di
+rinunciare a farlo.
address@hidden TCP/IP}.
+Si noti che quando @`e attiva l'opzione di continuazione dopo errori di I/O
+(@pxref{Continuazione dopo errori}),
address@hidden tenta di aprire un @dfn{socket} TCP/IP soltanto una volta.
+
address@hidden POSIXLY_CORRECT
+Provoca il passaggio di @command{gawk} alla address@hidden di address@hidden
POSIX,
+disabilitando tutte le estensioni tradizionali e GNU.
address@hidden
address@hidden table
+
+Le variabili d'ambiente nell'elenco che segue sono utili
+soprattutto agli sviluppatori di @command{gawk} per il collaudo e la messa
+a punto del programma. Sono soggette a cambiamenti. Le variabili sono:
+
address@hidden @env
address@hidden AWKBUFSIZE
+Questa variabile riguarda solo @command{gawk} installato su sistemi
+conformi a POSIX.
+Col valore di @samp{exact}, @command{gawk} usa la dimensione di ogni file di
+input come dimensione del buffer di memoria da allocare per I/O. Altrimenti,
+il valore dovrebbe essere un numero, e @command{gawk} usa questo numero come
+dimensione del buffer da allocare. (Quando questa variabile non @`e impostata,
address@hidden usa la address@hidden piccola tra le dimensioni del file e la
dimensione
+del blocco di ``default'', che normalmente @`e la dimensione del blocco I/O
+del filesystem).
+
address@hidden AWK_HASH
+Se questa variabile @`e impostata con un valore di @samp{gst}, @command{gawk}
+usa la funzione hash di GNU Smalltalk per gestire i vettori.
+Questa funzione address@hidden essere leggermente address@hidden veloce della
funzione standard.
address@hidden AWKREADFUNC
+Se questa variabile esiste, @command{gawk} legge i file sorgenti una riga per
+volta, anzich@'e a blocchi. Questa variabile @`e presente
+per problemi di debug su filesystem di sistemi operativi non POSIX,
+dove l'I/O @`e elaborato a record, non a blocchi.
+
address@hidden GAWK_MSG_SRC
+Se questa variabile esiste, @command{gawk} include il @value{FN} e il
+numero di riga all'interno del codice sorgente @command{gawk}
+dal quale sono stati generati i messaggi di avvertimento o
+i messaggi di errore grave. Il suo intento @`e quello di aiutare a isolare
+l'origine di un messaggio, poich@'e ci possono essere address@hidden righe di
codice che
+producono lo stesso messaggio di avvertimento o di errore.
+
address@hidden GAWK_LOCALE_DIR
+Specifica la posizione dei file oggetto compilati contenenti la traduzione dei
+messaggi emessi da @command{gawk} stesso. Questa variabile @`e passata alla
+funzione @code{bindtextdomain()} nella fase di partenza di @command{gawk}.
+
address@hidden GAWK_NO_DFA
+Se questa variabile esiste, @command{gawk} non usa il riconoscitore di
+espressioni regolari ASFD [automa a stati finiti deterministico] per i tipi di
+test di corrispondenza. Questo address@hidden causare un rallentamento di
@command{gawk}.
+Il suo intento @`e quello di aiutare a isolare le differenze tra i due
+riconoscitori di espressioni regolari che @command{gawk} usa internamente (non
+dovrebbero esserci differenze, ma a volte la teoria non coincide con la
+pratica).
+
address@hidden GAWK_STACKSIZE
+Specifica di quanto @command{gawk} dovrebbe accrescere il suo stack di
+valutazione interno, all'occorrenza.
+
address@hidden INT_CHAIN_MAX
+Specifica il numero massimo previsto di elementi che @command{gawk} mantiene
+su una catena hash per gestire i vettori indicizzati da numeri interi.
+
address@hidden STR_CHAIN_MAX
+Specifica il numero massimo previsto di elementi che @command{gawk} mantiene
+su una catena hash per gestire i vettori indicizzati da stringhe.
+
address@hidden TIDYMEM
+Se questa variabile esiste, @command{gawk} usa le chiamate di libreria
address@hidden()} della @dfn{GNU C library} per aiutare a scoprire
+possibili sprechi di memoria.
address@hidden table
+
address@hidden Codice di ritorno
address@hidden Il codice di ritorno all'uscita da @command{gawk}
+
address@hidden codice di ritorno, di @command{gawk}
address@hidden stato d'uscita, di @command{gawk}
+Se l'istruzione @code{exit} viene usata con un valore
+(@pxref{Istruzione exit}), @command{gawk} termina l'esecuzione con il valore
+numerico specificato.
+
+Altrimenti, se non ci sono stati problemi durante l'esecuzione,
address@hidden esce col valore della costante C
address@hidden, che normalmente @`e zero.
+
+Se si verifica un errore, @command{gawk} esce col valore della
+costante C @code{EXIT_FAILURE}, che normalmente @`e uguale a uno.
+
+Se @command{gawk} esce a causa di un errore grave, il codice di ritorno
address@hidden due. Sui sistemi non POSIX questo valore address@hidden essere
mappato
+a @code{EXIT_FAILURE}.
+
address@hidden Includere file
address@hidden Come includere altri file nel proprio programma
+
address@hidden Panos Papadopoulos <address@hidden> contributed the original
address@hidden text for this section.
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
address@hidden @code{@@include}, direttiva
address@hidden direttiva @code{@@include}
address@hidden includere file, direttiva @code{@@include}
+La direttiva @code{@@include} address@hidden essere usata per leggere file
sorgenti
+di @command{awk} esterni. Questo address@hidden la address@hidden di
suddividere file
+sorgenti di @command{awk} di grandi dimensioni in porzioni address@hidden
piccole e address@hidden
+maneggevoli, e anche di riutilizzare codice @command{awk} di uso comune
+da diversi @dfn{script} @command{awk}. In altre parole, si possono
+raggruppare funzioni di @command{awk} usate per eseguire determinati compiti
+all'interno di file esterni. Questi file possono essere usati proprio come
+librerie di funzioni, usando la direttiva @code{@@include} assieme alla
+variabile d'ambiente @env{AWKPATH}. Si noti che i file sorgenti possono
+venire inclusi anche usando l'opzione @option{-i}.
+
+Vediamolo con un esempio.
+Iniziamo con due @dfn{script} @command{awk} (banali), che chiameremo
address@hidden e @file{test2}. Questo @`e lo @dfn{script} @file{test1}:
+
address@hidden
+BEGIN @{
+ print "Questo @`e lo script test1."
address@hidden
address@hidden example
+
address@hidden
+e questo @`e @file{test2}:
+
address@hidden
+@@include "test1"
+BEGIN @{
+ print "Questo @`e lo script test2."
address@hidden
address@hidden example
+
+L'esecuzione di @command{gawk} con @file{test2}
+produce il seguente risultato:
+
address@hidden
+$ @kbd{gawk -f test2}
address@hidden Questo @`e lo script test1.
address@hidden Questo @`e lo script test2.
address@hidden example
+
address@hidden esegue lo @dfn{script} @file{test2}, il quale include
address@hidden, usando la direttiva @code{@@include}.
address@hidden@dotless{i}}, per includere file sorgenti di @command{awk}
esterni, basta usare
address@hidden@@include} seguito dal nome del file da includere,
+racchiuso tra doppi apici.
+
address@hidden NOTA
+Si tenga presente che questo @`e un costrutto del linguaggio e che @value{FN}
+non address@hidden essere una variabile di tipo stringa, ma solo una costante
di tipo
+letterale racchiusa tra doppi apici.
address@hidden quotation
+
+I file da includere possono essere nidificati; p.es., dato un terzo
address@hidden, che chiameremo @file{test3}:
+
address@hidden
+@@include "test2"
+BEGIN @{
+ print "Questo @`e lo script test3."
address@hidden
address@hidden example
+
address@hidden
+L'esecuzione di @command{gawk} con lo @dfn{script} @file{test3} produce i
+seguenti risultati:
+
address@hidden
+$ @kbd{gawk -f test3}
address@hidden Questo @`e lo script test1.
address@hidden Questo @`e lo script test2.
address@hidden Questo @`e lo script test3.
address@hidden example
+
+Il @value{FN}, naturalmente, address@hidden essere un nome di percorso.
+Per esempio:
+
address@hidden
+@@include "../funzioni_di_i_o"
address@hidden example
+
address@hidden
+e:
+
address@hidden
+@@include "/usr/awklib/network"
address@hidden example
+
address@hidden
+sono entrambi percorsi validi. La variabile d'ambiente @env{AWKPATH}
address@hidden
+rivestire grande importanza quando si usa @code{@@include}. Le stesse
+regole per l'uso della variabile d'ambiente @env{AWKPATH} nelle ricerche
+da riga di comando
+(@pxref{AWKPATH (Variabile)}) si applicano anche a
address@hidden@@include}.
+
+Questo @`e di grande aiuto nella costruzione di librerie di funzioni di
address@hidden Se si ha uno @dfn{script} di grandi dimensioni contenente
+utili funzioni @command{awk} di uso comune, lo si address@hidden suddividere
in file
+di libreria e mettere questi file in una directory dedicata. In seguito si
+possono includere queste ``librerie'' usando il percorso completo dei
+file, o impostando opportunamente la variabile d'ambiente @env{AWKPATH} e
+quindi usando @code{@@include} con la sola parte del percorso completo che
+designa il file. Naturalmente,
+si possono tenere i file di libreria in address@hidden di una directory;
address@hidden @`e complesso l'ambiente di lavoro, address@hidden
+directory possono essere necessarie per organizzare i file da includere.
+
+Vista la address@hidden di specificare opzioni @option{-f} multiple, il
+meccanismo @code{@@include} non @`e strettamente necessario.
+Comunque, la direttiva @code{@@include} address@hidden essere d'aiuto nel
costruire
+programmi @command{gawk} autosufficienti, riducendo address@hidden@dotless{i}}
la address@hidden
+di scrivere righe di comando complesse e tediose.
+In particolare, @code{@@include} @`e molto utile per scrivere @dfn{script} CGI
+eseguibili da pagine web.
+
+Come @`e stato detto in @ref{AWKPATH (Variabile)}, i file sorgenti vengono
+sempre cercati nella directory corrente, prima di eseguire la ricerca in
address@hidden; questo si applica anche ai file indicati con
address@hidden@@include}.
+
address@hidden Caricare librerie condivise
address@hidden Caricare librerie condivise nel proprio programma
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
address@hidden @code{@@load}, direttiva
address@hidden direttiva @code{@@load}
address@hidden caricare estensioni, direttiva @code{@@load}
address@hidden estensioni, caricamento, direttiva @code{@@load}
+La direttiva @code{@@load} address@hidden essere usata per leggere estensioni
di
address@hidden esterne (memorizzate come librerie condivise di sistema).
+Questo consente di collegare del codice compilato che address@hidden offrire
prestazioni
+migliori o dare l'accesso a address@hidden estese non incluse nel linguaggio
address@hidden La variabile @env{AWKLIBPATH} viene usata per ricercare
+l'estensione. Usare @code{@@load} @'e del tutto equivalente a usare l'opzione
da
+riga di comando @option{-l}.
+
+Se l'estensione non viene trovata in @env{AWKLIBPATH}, viene effettuata
+un'altra ricerca dopo aver aggiunto al @value{FN} il suffisso della
+libreria condivisa comunemente in uso per la piattaforma corrente. Per
+esempio, sui sistemi GNU/Linux viene usato il suffisso @samp{.so}:
+
address@hidden
+$ @kbd{gawk '@@load "ordchr"; BEGIN @{print chr(65)@}'}
address@hidden A
address@hidden example
+
address@hidden
+Questo @`e equivalente all'esempio seguente:
+
address@hidden
+$ @kbd{gawk -lordchr 'BEGIN @{print chr(65)@}'}
address@hidden A
address@hidden example
+
address@hidden
+Per l'uso da riga di comando @`e address@hidden conveniente l'opzione
@option{-l},
+ma @code{@@load} @`e utile da inserire all'interno di un file sorgente di
address@hidden che richieda l'accesso a un'estensione.
+
address@hidden dinamiche}, descrive come scrivere estensioni (in C or C++)
+che possono essere caricate sia con @code{@@load} che con l'opzione
address@hidden @`E anche descritta l'estensione @code{ordchr}.
+
address@hidden Parti obsolete
address@hidden Opzioni e/o address@hidden obsolete
+
address@hidden update this section for each release!
+
address@hidden opzioni deprecate
address@hidden address@hidden deprecate
address@hidden obsolete, address@hidden
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive address@hidden o opzioni da riga di comando
+provenienti da precedenti versioni di @command{gawk} che non sono
address@hidden
+disponibili nella versione corrente, o che sono ancora utilizzabili ma sono
+deprecate (address@hidden significa che @emph{non} saranno presenti nella
prossima
+versione).
+
+I file speciali relativi ai processi @file{/dev/pid}, @file{/dev/ppid},
address@hidden/dev/pgrpid} e @file{/dev/user} erano deprecati, ma ancora
disponibili,
+in @command{gawk} 3.1. A partire dalla @value{PVERSION} 4.0, non sono
address@hidden interpretati da @command{gawk} in modo speciale (al loro posto
usare
+invece @code{PROCINFO}; si veda @ref{Variabili auto-assegnate}).
+
address@hidden
+This @value{SECTION}
+is thus essentially a place holder,
+in case some option becomes obsolete in a future version of @command{gawk}.
address@hidden ignore
+
address@hidden Non documentato
address@hidden Opzioni e address@hidden non documentate
address@hidden non documentate, address@hidden
address@hidden address@hidden non documentate
address@hidden Skywalker, Luke
address@hidden Kenobi, Obi-Wan
address@hidden Jedi, Cavalieri
address@hidden Cavalieri Jedi
address@hidden
address@hidden il codice sorgente, Luke!}
address@hidden Obi-Wan
address@hidden quotation
+
address@hidden conchiglie, mare
address@hidden
+Questa @value{SECTION} @`e stata lasciata intenzionalmente vuota.
address@hidden ifnotinfo
address@hidden
+Questo @value{SECTION} @`e stato lasciato intenzionalmente vuoto.
address@hidden ifinfo
+
address@hidden
address@hidden If these came out in the Info file or TeX document, then they
wouldn't
address@hidden be undocumented, would they?
+
address@hidden ha un'opzione non documentata:
+
address@hidden @code
address@hidden -W nostalgia
address@hidden --nostalgia
+Stampa il messaggio @samp{awk: bailing out near line 1} e termina
+con un errore grave.
+Quest'opzione @`e stata ispirata dal comportamento comune delle primissime
+versioni di @command{awk} Unix e da una maglietta [con la scritta].
+Il messaggio @emph{NON} viene tradotto in ambienti non inglesi.
address@hidden so there! nyah, nyah.
address@hidden table
+
+Le prime versioni di @command{awk} non richiedevano alcun separatore (a capo
+
+o @samp{;}) tra le regole nei programmi @command{awk}. Quindi,
+era normale vedere programmi di una riga come:
+
address@hidden
+awk '@{ sum += $1 @} END @{ print sum @}'
address@hidden example
+
address@hidden in address@hidden consente questo stile, ma la cosa non @`e
+documentata per non incoraggiare la pratica. Il modo corretto per scrivere
+quel programma @`e uno dei
+seguenti:
+
address@hidden
+awk '@{ sum += $1 @} ; END @{ print sum @}'
address@hidden example
+
address@hidden
+oppure:
+
address@hidden
+awk '@{ sum += $1 @}
+ END @{ print sum @}' data
address@hidden example
+
address@hidden
address@hidden/Righe}, per una spiegazione address@hidden ampia.
+
+Si possono inserire righe bianche dopo @samp{;} nei cicli @code{for}.
+Questa sembre essere stata una address@hidden a lungo non documentata in
address@hidden Unix.
+
+Analogamente, si possono usare istruzioni @code{print} o @code{printf}
+nelle parti @var{valore-iniziale} e @var{incremento} di un ciclo
address@hidden Questa @`e un'altra address@hidden a lungo non documentata in
address@hidden Unix.
+
address@hidden consente di usare come nomi di parametro dei
+nomi di funzioni predefinite che facciano parte delle estensioni
address@hidden, all'interno di funzioni definite dall'utente.
+Questo avviene per ``salvaguardare per il futuro'' vecchi programmi che
+utilizzino nomi di funzioni aggiunte da @command{gawk} dopo che questi
+programmi erano stati scritti.
+Le funzioni predefinite standard di command{awk}, per esempio
address@hidden()} o @code{substr()} @emph{non} ammettono questa address@hidden
+
+Il vettore @code{PROCINFO["argv"]} contiene tutti gli argomenti della
+riga di comando (una volta espansi i metacaratteri ed elaborata la
+ridirezione, nelle piattaforme in cui address@hidden dev'essere fatto
manualmente
+dal programma), con indici che vanno da 0 as @code{argc} @minus{} 1.
+Per esempio, @code{PROCINFO["argv"][0]} address@hidden il nome con cui @`e
+stato invocato @command{gawk}. L'esempio seguente mostra come @`e
+possibile usare questa address@hidden:
+
address@hidden
+awk '
+BEGIN @{
+ for (i = 0; i < length(PROCINFO["argv"]); i++)
+ print i, PROCINFO["argv"][i]
address@hidden'
address@hidden example
+
address@hidden da tener presente che questo vettore @`e diverso dal vettore
+standard @code{ARGV} che non comprende quegli argomenti della riga di
+comando che sono address@hidden stati elaborati da
address@hidden (@pxref{ARGC e ARGV}).
+
address@hidden ignore
+
address@hidden Sommario invocazione
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Per eseguire @command{awk} usare, o
address@hidden '@var{programma}' @var{file}}
+o
address@hidden -f @var{file-del-programma} @var{file}}.
+
address@hidden
+Le tre opzioni standard per tutte le versioni di @command{awk} sono
address@hidden, @option{-F} e @option{-v}. @command{gawk} fornisce queste e
+molte altre, come pure le opzioni estese corrispondenti scritte in stile GNU.
+
address@hidden
+Gli argomenti da riga di comando che non sono opzioni sono trattati normalmente
+come @value{FNS}, a meno che non abbiano la forma @address@hidden@var{valore}};
+nel qual caso vengono riconosciuti come assegnamenti di variabile da eseguire
+in quel punto
+nell'elaborazione dell'input.
+
address@hidden
+Tutti gli argomenti da riga di comando che non sono opzioni, escluso il testo
+del programma, vengono messe nel vettore @code{ARGV}. Modifiche a @code{ARGC}
+e @code{ARGV} influiscono su come @command{awk} elabora l'input.
+
address@hidden
+Si address@hidden usare un segno meno a s@'e stante (@samp{-}) per designare
lo standard
+input sulla riga di comando. @command{gawk} consente anche di usare il
address@hidden speciale @file{/dev/stdin}.
+
+
address@hidden
address@hidden tiene conto di diverse variabili d'ambiente;
address@hidden, @env{AWKLIBPATH} e @env{POSIXLY_CORRECT} sono le
address@hidden importanti.
+
address@hidden
+Lo stato d'uscita di @command{gawk} invia informazioni al programma che lo
+ha invocato. Usare l'istruzione @code{exit} dall'interno di un programma
address@hidden per impostare il codice di ritorno.
+
address@hidden
address@hidden consente di includere nel proprio programma file sorgenti di
address@hidden con la direttiva @code{@@include} o con le opzioni da riga di
+comando @option{-i} e @option{-f}.
+
address@hidden
address@hidden consente di caricare funzioni aggiuntive scritte in C
+o C++ con la direttiva @code{@@load} e/o con l'opzione @option{-l}
+(questa address@hidden avanzata @`e descritta address@hidden avanti, in
address@hidden dinamiche}).
address@hidden itemize
address@hidden Espressioni regolari
address@hidden Espressioni regolari
address@hidden @dfn{regexp}
address@hidden espressioni regolari
+
+Una @dfn{espressione regolare}, o @dfn{regexp}, @`e un modo per descrivere un
+insieme di stringhe.
+Poich@'e le espressioni regolari sono una parte fondamentale della
+programmazione in @command{awk}, il loro formato e il loro uso meritano un
address@hidden a s@'e stante.
+
address@hidden barra (@code{/}), per delimitare le espressioni regolari
address@hidden @code{/} (barra), per delimitare le espressioni regolari
+Un'espressione regolare racchiusa tra barre (@samp{/})
address@hidden un modello di ricerca @command{awk} che individua tutti i record
in input
+il cui testo corrisponde al modello stesso.
+L'espressione regolare address@hidden semplice @`e una sequenza di lettere o
di numeri, o
+di entrambi. Una tale @dfn{regexp} individua ogni stringa che contenga quella
+particolare sequenza.
+Quindi, la @dfn{regexp} @samp{pippo} individua ogni stringa che contenga
address@hidden In altre parole, al modello di ricerca @code{/pippo/}
corrisponde
+ogni record in input che contiene i cinque caratteri consecutivi @samp{pippo}
address@hidden qualsiasi parte} del record. Altri tipi di @dfn{regexp}
permettono
+di specificare classi di stringhe molto address@hidden complesse.
+
address@hidden
+All'inizio, gli esempi in questo @value{CHAPTER} sono semplici.
+Man mano che entriamo nei dettagli su
+come funzionano le espressioni regolari utilizzeremo formulazioni
address@hidden
+complesse.
address@hidden ifnotinfo
+
address@hidden
+* Uso di @dfn{regexp}:: Come usare le espressioni regolari.
+* Sequenze di protezione:: Come scrivere caratteri non stampabili.
+* Operatori di espressioni regolari:: Operatori di espressioni regolari.
+* Espressioni tra parentesi quadre:: Cosa possono contenere @samp{[...]}.
+* address@hidden lungo da sinistra:: Quanto @`e lungo il testo
individuato.
+* Espressioni regolari calcolate:: Usare @dfn{regexp} dinamiche.
+* Operatori di @dfn{regexp} GNU:: Operatori propri del software GNU.
+* Maiuscolo-Minuscolo:: Fare confronti ignorando
+ maiuscolo/minuscolo.
+* Sommario espressioni regolari:: Sommario delle espressioni regolari.
address@hidden menu
+
address@hidden Uso di @dfn{regexp}
address@hidden Uso di espressioni regolari
+
address@hidden espressioni regolari, come criteri di ricerca
+Un'espressione regolare address@hidden essere usata come modello di ricerca
+racchiudendola tra barre. L'espressione regolare @`e quindi confrontata
+con tutto il testo di ogni record (normalmente, basta che corrisponda a
+una parte qualsiasi del testo per risultare soddisfatta). Per esempio,
+il seguente programma stampa il secondo campo di ogni record in cui compaia
+la stringa @samp{li}, in qualsiasi parte del record:
+
address@hidden
+$ @kbd{awk '/li/ @{ print $2 @}' mail-list}
address@hidden 555-5553
address@hidden 555-0542
address@hidden 555-6699
address@hidden 555-3430
address@hidden example
+
address@hidden espressioni regolari, operatori
address@hidden operatori, ricerca in stringhe
address@hidden @cindex operators, @code{~}
address@hidden ricerca in stringhe, operatori
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @cindex operatori, @code{!~}
address@hidden @code{if}, istruzione, uso di espressioni regolari in
address@hidden @code{while}, istruzione, uso di espressioni regolari in
address@hidden @address@hidden, istruzione, uso di espressioni regolari in
address@hidden @cindex istruzione @code{if}
address@hidden @cindex istruzione @code{while}
address@hidden @cindex istruzione @code{do}
+Espressioni regolari possono anche essere usate in espressioni di confronto.
+Queste espressioni consentono di specificare le stringhe da riconoscere;
+non devono necessariamente comprendere l'intero record corrente. I due
+operatori @samp{~} e @samp{!~} confrontano espressioni regolari. Le
+espressioni che usano questi operatori possono essere usate come modelli di
+ricerca, o nelle istruzioni @code{if}, @code{while}, @code{for}, e @code{do}.
+(@xref{Istruzioni}.)
+Per esempio:
+
address@hidden
address@hidden ~ /@var{regexp}/
address@hidden example
+
address@hidden
address@hidden verificata se l'espressione @var{exp} (intesa come stringa)
+corrisponde a @var{regexp}. L'esempio che segue individua, o sceglie,
+tutti i record in input in cui la lettera maiuscola @samp{J} @`e presente da
+qualche parte nel primo campo:
+
address@hidden
+$ @kbd{awk '$1 ~ /J/' inventory-shipped}
address@hidden Jan 13 25 15 115
address@hidden Jun 31 42 75 492
address@hidden Jul 24 34 67 436
address@hidden Jan 21 36 64 620
address@hidden example
+
+Lo stesso risultato si address@hidden ottenere anche
address@hidden@dotless{i}}:
+
address@hidden
+awk '@{ if ($1 ~ /J/) print @}' inventory-shipped
address@hidden example
+
+Il prossimo esempio chiede che l'espressione @var{exp}
+(intesa come stringa)
address@hidden corrisponda a @var{regexp}:
+
address@hidden
address@hidden !~ /@var{regexp}/
address@hidden example
+
+L'esempio che segue individua o sceglie tutti i record in input il cui
+primo campo @emph{NON} contiene
+la lettera maiuscola @samp{J}:
+
address@hidden
+$ @kbd{awk '$1 !~ /J/' inventory-shipped}
address@hidden Feb 15 32 24 226
address@hidden Mar 15 24 34 228
address@hidden Apr 31 52 63 420
address@hidden May 16 34 29 208
address@hidden
address@hidden example
+
address@hidden @dfn{regexp}, costanti
address@hidden costanti @dfn{regexp}
address@hidden espressioni regolari, costanti, si veda costanti @dfn{regexp}
+Quando una @dfn{regexp} @`e racchiusa tra barre, come @code{/pippo/}, la
chiamiamo
+una @dfn{costante regexp}, proprio come @code{5.27} @`e una costante
+numerica e @code{"pippo"} @`e una costante [di tipo] stringa.
+
address@hidden Sequenze di protezione
address@hidden Sequenze di protezione
+
address@hidden sequenze di protezione, in stringhe
address@hidden barra inversa (@code{\}), in sequenze di protezione
address@hidden @code{\} (barra inversa), in sequenze di protezione
+Alcuni caratteri non possono essere inclusi letteralmente in costanti
+stringa (@code{"pippo"}) o in costanti @dfn{regexp} (@code{/pippo/}).
+Vanno invece rappresentati usando @dfn{sequenze di protezione},
+ossia sequenze di caratteri preceduti da una barra inversa (@samp{\}).
+Una sequenza di protezione address@hidden essere usata per includere un
carattere di
+"doppio apice" in una costante stringa. Poich@'e un semplice doppio apice
+termina la stringa, va usato @samp{\"} per richiedere che un doppio apice sia
+presente all'interno di una stringa. Per esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Egli le disse \"ciao!\"." @}'}
address@hidden Egli le disse "ciao!".
address@hidden example
+
+Lo stesso carattere di barra inversa @`e un altro carattere che non
address@hidden essere
+incluso normalmente; occorre scrivere @samp{\\} per inserire una barra
+inversa nella stringa o @dfn{regexp}. Quindi, la stringa costituita dai due
+caratteri @samp{"} e @samp{\} deve essere scritta come @code{"\"\\"}.
+
+Altre sequenze di protezione rappresentano caratteri non stampabili
+come TAB o il ritorno a capo. Anche se @`e possibile immettere la maggior
parte dei
+caratteri non stampabili direttamente in una costante stringa o
address@hidden, essi possono non essere di facile comprensione.
+
+La seguente lista elenca
+tutte le sequenze di protezione usate in @command{awk} e
+cosa rappresentano. Se non @`e detto altrimenti, tutte queste sequenze di
+protezione valgono sia per costanti stringa che per costanti @dfn{regexp}:
+
address@hidden @code
address@hidden \\
+Barra inversa letterale, @samp{\}.
+
address@hidden @cindex @command{awk} language, V.4 version
address@hidden @code{\} (barra inversa), @code{\a}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\a}, sequenza di protezione
address@hidden \a
+Il carattere ``campanello'', @kbd{Ctrl-g}, codice ASCII 7 (BEL).
+(Spesso genera qualche tipo di segnale sonoro udibile.)
+
address@hidden @code{\} (barra inversa), @code{\b}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\b}, sequenza di protezione
address@hidden \b
+Barra inversa, @kbd{Ctrl-h}, codice ASCII 8 (BS).
+
address@hidden @code{\} (barra inversa), @code{\f}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\f}, sequenza di protezione
address@hidden \f
+Nuova pagina, @kbd{Ctrl-l}, codice ASCII 12 (FF).
+
address@hidden @code{\} (barra inversa), @code{\n}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\n}, sequenza di protezione
address@hidden \n
+A capo, @kbd{Ctrl-j}, codice ASCII 10 (LF).
+
address@hidden @code{\} (barra inversa), @code{\r}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\r}, sequenza di protezione
address@hidden \r
+Ritorno del carrello, @kbd{Ctrl-m}, codice ASCII 13 (CR).
+
address@hidden @code{\} (barra inversa), @code{\t}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\t}, sequenza di protezione
address@hidden \t
+Tabulazione orizzontale, @kbd{Ctrl-i}, codice ASCII 9 (HT).
+
address@hidden @cindex @command{awk} language, V.4 version
address@hidden @code{\} (barra inversa), @code{\v}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\v}, sequenza di protezione
address@hidden \v
+Tabulazione verticale, @kbd{Ctrl-k}, codice ASCII 11 (VT).
+
address@hidden @code{\} (barra inversa), @address@hidden, sequenza di protezione
address@hidden barra inversa (@code{\}), @address@hidden, sequenza di protezione
address@hidden address@hidden
+Il valore ottale @var{nnn}, dove @var{nnn} address@hidden essere da 1 a 3
cifre ottali,
+tra @samp{0} e @samp{7}. Per esempio, il codice per il carattere ASCII ESC
+(escape) @`e @samp{\033}.
+
address@hidden @cindex @command{awk} language, V.4 version
address@hidden @cindex @command{awk} language, POSIX version
address@hidden @code{\} (barra inversa), @code{\x}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\x}, sequenza di protezione
address@hidden comuni, address@hidden @code{\x}, sequenza di protezione
address@hidden estensioni comuni, @code{\x}, sequenza di protezione
address@hidden address@hidden@dots{}
+Il valore esadecimale @var{hh}, dove @var{hh} indica una sequenza di cifre
+esadecimali (@address@hidden, e @address@hidden
+o @address@hidden). Dopo @samp{\x} @`e consentito un massimo di due cifre.
+Ogni ulteriore cifra esadecimale @`e considerata come una semplice
+lettera o numero. @value{COMMONEXT}
+(La sequenza di protezione @samp{\x} non @`e permessa in POSIX awk.)
+
address@hidden ATTENZIONE
+In ISO C, la sequenza di protezione continua fino a raggiungere il primo
+carattere che non sia una cifra esadecimale.
+In passato, @command{gawk} avrebbe continuato ad aggiungere
+cifre esadecimali al valore finch@'e non trovava una cifra non esadecimale
+oppure fino a raggiungere la fine della stringa.
+Comunque usare address@hidden di due cifre esadecimali produceva risultati
indefiniti.
+Dalla @value{PVERSION} 4.2,
+vengono elaborate solo due cifre.
address@hidden quotation
+
address@hidden @code{\} (barra inversa), @code{\/}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\/}, sequenza di protezione
address@hidden \/
+Una barra (necessario solo per costanti @dfn{regexp}).
+Questa sequenza si usa per inserire una costante @dfn{regexp}
+che contiene una barra
+(come @code{/.*:\/home\/[[:alnum:]]+:.*/}; la notazione @samp{[[:alnum:]]}
address@hidden spiegata address@hidden avanti,
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden tra parentesi quadre}).
+Poich@'e una @dfn{regexp} @`e racchiusa tra
+barre, si deve proteggere ogni barra che sia parte dell'espressione, per dire
+ad @command{awk} di andare avanti a scandire il resto della @dfn{regexp}.
+
address@hidden @code{\} (barra inversa), @code{\"}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\"}, sequenza di protezione
address@hidden \"
+Un doppio apice (necessario solo per costanti stringa).
+Questa sequenza si usa per inserire in una costante stringa il carattere
+doppio apice
+(come @code{"Egli le disse \"ciao!\"."}).
+Poich@'e la stringa @`e racchiusa tra
+doppi apici, si deve proteggere ogni doppio apice che sia parte della stringa
+per dire ad @command{awk} di andare avanti a elaborare il resto della stringa.
address@hidden table
+
+In @command{gawk}, parecchie altre sequenze di due caratteri inizianti con
+con una barra inversa hanno un significato speciale nelle @dfn{regexp}.
address@hidden di @dfn{regexp} GNU}.
+
+In una @dfn{regexp}, una barra inversa che preceda un carattere non presente
+nella lista precedente, e non elencato in
address@hidden di @dfn{regexp} GNU},
+significa che il carattere seguente dovrebbe essere preso letteralmente,
+anche se normalmente sarebbe un operatore di @dfn{regexp}. Per esempio,
address@hidden/a\+b/} individua i tre caratteri @samp{a+b}.
+
address@hidden barra inversa (@code{\}), in sequenze di protezione
address@hidden @code{\} (barra inversa), in sequenze di protezione
address@hidden address@hidden
+Per una completa address@hidden, non usare una barra inversa prima di qualsiasi
+carattere non incluso nella lista precedente, o che non sia un operatore.
address@hidden 11/2014: Moved so as to not stack sidebars
address@hidden sidebar, Barra inversa prima di un carattere normale
address@hidden
address@hidden
+<sidebar><title>Barra inversa prima di un carattere normale</title>
address@hidden docbook
+
address@hidden address@hidden, barra inversa in sequenze di protezione
address@hidden POSIX @command{awk}, barre inverse in costanti stringa
address@hidden barra inversa (@code{\}), in sequenze di protezione, POSIX e
address@hidden @code{\} (barra inversa), in sequenze di protezione, POSIX e
+
address@hidden risoluzione di problemi, barra inversa prima di caratteri non
speciali
address@hidden problemi, risoluzione di, barra inversa prima di caratteri non
speciali
+Se si mette una barra inversa in una costante stringa prima di qualcosa che
+non sia uno dei caratteri elencati sopra, POSIX @command{awk} di proposito
+lascia indefinito il comportamento. Ci sono due address@hidden:
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden Brian Kernighan, @command{awk} di
address@hidden @asis
address@hidden Togliere la barra inversa
+Questo @`e quel che sia BWK @command{awk} che @command{gawk} fanno.
+Per esempio, @code{"a\qc"} equivale a @code{"aqc"}.
+(Poich@'e questo @`e un errore che address@hidden capitare o non capitare con
la stessa
address@hidden, @command{gawk} lo segnala).
+Volendo usare come separatore di campo @samp{FS = @w{"[ \t]+\|[ \t]+"}}
+ossia delle barre verticali precedute e seguite da almeno uno spazio,
+occorre mettere due barre inverse nella stringa:
address@hidden = @w{"[ \t]+\\|[ \t]+"}}.)
address@hidden I did this! This is why I added the warning.
+
address@hidden @command{gawk}, sequenze di protezione
address@hidden Unix @command{awk}, barre inverse in sequenze di protezione
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden Tenere la barra inversa address@hidden@dotless{i}} com'@`e.
+Alcune altre implementazioni di @command{awk} fanno questo.
+In quelle implementazioni, immettere @code{"a\qc"} equivale a immettere
address@hidden"a\\qc"}.
address@hidden table
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Barra inversa prima di un carattere normale}
+
+
address@hidden address@hidden, barra inversa in sequenze di protezione
address@hidden POSIX @command{awk}, barre inverse in costanti stringa
address@hidden barra inversa (@code{\}), in sequenze di protezione, POSIX e
address@hidden @code{\} (barra inversa), in sequenze di protezione, POSIX e
+
address@hidden risoluzione di problemi, barra inversa prima di caratteri non
speciali
address@hidden problemi, risoluzione di, barra inversa prima di caratteri non
speciali
+Se si mette una barra inversa in una costante stringa prima di qualcosa che
+non sia uno dei caratteri elencati sopra, POSIX @command{awk} di proposito
+lascia indefinito il comportamento. Ci sono due address@hidden:
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden Brian Kernighan, @command{awk} di
address@hidden @asis
address@hidden Togliere la barra inversa
+Questo @`e quel che sia BWK @command{awk} che @command{gawk} fanno.
+Per esempio, @code{"a\qc"} equivale a @code{"aqc"}.
+(Poich@'e questo @`e un errore che address@hidden capitare o non capitare con
la stessa
address@hidden, @command{gawk} lo segnala).
+Volendo usare come separatore di campo @samp{FS = @w{"[ \t]+\|[ \t]+"}}
+ossia delle barre verticali precedute e seguite da almeno uno spazio,
+occorre mettere due barre inverse nella stringa:
address@hidden = @w{"[ \t]+\\|[ \t]+"}}.)
address@hidden I did this! This is why I added the warning.
+
address@hidden @command{gawk}, sequenze di protezione
address@hidden Unix @command{awk}, barre inverse in sequenze di protezione
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden Tenere la barra inversa address@hidden@dotless{i}} com'@`e.
+Alcune altre implementazioni di @command{awk} fanno questo.
+In quelle implementazioni, immettere @code{"a\qc"} equivale a immettere
address@hidden"a\\qc"}.
address@hidden table
address@hidden cartouche
address@hidden ifnotdocbook
+Ricapitolando:
+
address@hidden @value{BULLET}
address@hidden
+Le sequenze di protezione nella lista di cui sopra sono sempre elaborate
+per prime, sia per le costanti stringa che per le costanti @dfn{regexp}.
Questo
+viene fatto quasi subito, non appena @command{awk} legge il programma.
+
address@hidden
address@hidden elabora sia costanti @dfn{regexp} che @dfn{regexp} dinamiche
+(@pxref{Espressioni regolari calcolate}),
+per gli operatori speciali elencati in
address@hidden di @dfn{regexp} GNU}.
+
address@hidden
+Una barra inversa prima di ogni altro carattere richiede di trattare quel
+carattere letteralmente.
address@hidden itemize
+
address@hidden sidebar, Sequenze di protezione per metacaratteri
address@hidden
address@hidden
+<sidebar><title>Sequenze di protezione per metacaratteri</title>
address@hidden docbook
+
address@hidden metacaratteri, sequenze di protezione per
+
+Supponiamo che si usi una protezione ottale o esadecimale
+per rappresentare un metacarattere di @dfn{regexp}
+(si veda @ref{Operatori di espressioni regolari}).
address@hidden considera il carattere come un carattere letterale o
+come un operatore di @dfn{regexp}?
+
address@hidden angolo buio, sequenze di protezione, per metacaratteri
+Storicamente, tali caratteri erano considerati letteralmente.
address@hidden
+Invece, lo standard POSIX richiede che siano considerati
+come metacaratteri veri e propri, e questo @`e address@hidden che
@command{gawk} fa.
+In address@hidden compatibile (@pxref{Opzioni}),
address@hidden tratta i caratteri scritti come sequenze ottali ed esadecimali
+letteramente, quando sono usati in costanti @dfn{regexp}. Quindi,
address@hidden/a\52b/} @`e equivalente a @code{/a\*b/}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Sequenze di protezione per metacaratteri}
+
+
address@hidden metacaratteri, sequenze di protezione per
+
+Supponiamo che si usi una protezione ottale o esadecimale
+per rappresentare un metacarattere di @dfn{regexp}
+(si veda @ref{Operatori di espressioni regolari}).
address@hidden considera il carattere come un carattere letterale o
+come un operatore di @dfn{regexp}?
+
address@hidden angolo buio, sequenze di protezione, per metacaratteri
+Storicamente, tali caratteri erano considerati letteralmente.
address@hidden
+Invece, lo standard POSIX richiede che siano considerati
+come metacaratteri veri e propri, e questo @`e address@hidden che
@command{gawk} fa.
+In address@hidden compatibile (@pxref{Opzioni}),
address@hidden tratta i caratteri scritti come sequenze ottali ed esadecimali
+letteramente, quando sono usati in costanti @dfn{regexp}. Quindi,
address@hidden/a\52b/} @`e equivalente a @code{/a\*b/}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Operatori di espressioni regolari
address@hidden Operatori di espressioni regolari
address@hidden espressioni regolari, operatori
address@hidden metacaratteri in espressioni regolari
+
address@hidden possibile inserire in espressioni regolari dei caratteri
speciali,
+detti @dfn{operatori di espressioni regolari} o @dfn{metacaratteri}, per
+aumentarne il potere e la address@hidden
+
+Le sequenze di protezione descritte
address@hidden
+prima
address@hidden ifnotinfo
+in @ref{Sequenze di protezione}
+sono valide all'interno di una @dfn{regexp}. Sono precedute da una @samp{\} e
+sono riconosciute e convertite nei caratteri reali corrispondenti nella
+primissima fase dell'elaborazione delle @dfn{regexp}.
+
+Ecco una lista dei metacaratteri. Tutti i caratteri che non sono sequenze
+di protezione e che non sono elencati qui rappresentano se stessi:
+
address@hidden Use @asis so the docbook comes out ok. Sigh.
address@hidden @asis
address@hidden barra inversa (@code{\}), operatore @dfn{regexp}
address@hidden barra inversa (@code{\}), operatore @dfn{regexp}
address@hidden @code{\} (barra inversa), operatore @dfn{regexp}
address@hidden @code{\}
+Si usa per togliere il significato speciale a un carattere quando si effettuano
+confronti. Per esempio, @samp{\$}
+individua il carattere @samp{$}.
+
address@hidden espressioni regolari, ancore nelle
address@hidden Texinfo, inizi di capitolo nei file
address@hidden @code{^} (circonflesso), operatore @dfn{regexp}
address@hidden circonflesso (@code{^}), operatore @dfn{regexp}
address@hidden @code{^}
+Si usa per indicare l'inizio di una stringa. Per esempio, @samp{^@@chapter}
+individua @samp{@@chapter} all'inizio di una stringa e si address@hidden usare
per
+identificare inizi di capitoli in file sorgenti Texinfo.
+Il simbolo @samp{^} @`e conosciuto come @address@hidden, perch@'e @`ancora la
ricerca
+solo all'inizio della stringa.
+
address@hidden importante notare che @samp{^} non individua un inizio di riga
+(il punto subito dopo un ritorno a capo @samp{\n}) che si trovi all'interno
+di una stringa. La condizione non @`e verificata nell'esempio seguente:
+
address@hidden
+if ("riga1\nRIGA 2" ~ /^R/) @dots{}
address@hidden example
+
address@hidden @code{$} (dollaro), operatore @dfn{regexp}
address@hidden dollaro (@code{$}), operatore @dfn{regexp}
address@hidden @code{$}
+Simile a @samp{^}, ma serve a indicare la fine di una stringa.
+Per esempio, @samp{p$}
+individua un record che termina con la lettera @samp{p}. Il @samp{$} @`e
+un'@`ancora e non individua una fine di riga (il punto immediatamente prima
+di un carattere di ritorno a capo @samp{\n})
+contenuta in una stringa.
+La condizione nell'esempio seguente non @`e verificata:
+
address@hidden
+if ("riga1\nRIGA 2" ~ /1$/) @dots{}
address@hidden example
+
address@hidden @code{.} (punto), operatore @dfn{regexp}
address@hidden punto (@code{.}), operatore @dfn{regexp}
address@hidden @code{.} (punto)
+Individua un qualsiasi carattere,
address@hidden il carattere di ritorno a capo. Per esempio, @samp{.P}
+individua ogni carattere in una stringa che sia seguito da una @samp{P}.
+Usando la concatenazione, si address@hidden formare un'espressione regolare
come
address@hidden, che individua qualsiasi sequenza di tre caratteri che inizia con
address@hidden e finisce con @samp{A}.
+
address@hidden POSIX @command{awk}, uso del punto (@code{.})
+In address@hidden POSIX stretta (@pxref{Opzioni}),
address@hidden non individua il carattere @sc{nul},
+ossia il carattere con tutti i bit uguali a zero.
+In altri contesti, @sc{nul} @`e solo un carattere qualsiasi. Altre versioni
+di @command{awk} possono non essere in grado di individuare il carattere
address@hidden
+
address@hidden @code{[]} (parentesi quadre), operatore @dfn{regexp}
address@hidden parentesi quadre (@code{[]}), operatore @dfn{regexp}
address@hidden espressioni tra parentesi
address@hidden insiemi di caratteri, si veda anche espressioni tra parentesi
quadre
address@hidden liste di caratteri, si veda espressioni tra parentesi quadre
address@hidden classi di caratteri, si veda espressioni tra parentesi quadre
address@hidden @address@hidden@code{]}
+Questa @`e chiamata una @dfn{espressione tra parentesi address@hidden
+altri testi, un'espressione tra parentesi quadre potrebbe essere
+definita come @dfn{insieme di caratteri}, @dfn{classe di caratteri} o
+ @dfn{lista di caratteri}.}
+Individua @emph{uno} qualsiasi dei caratteri racchiusi tra
+parentesi quadre. Per esempio, @samp{[MVX]} individua uno qualsiasi
+dei caratteri @samp{M}, @samp{V}, o @samp{X} in una stringa. Una spiegazione
+esauriente di quel che si address@hidden mettere all'interno di un'espressione
tra
+parentesi quadre @`e data in
address@hidden tra parentesi quadre}.
+
address@hidden espressioni tra parentesi quadre, complementate
address@hidden @address@hidden@code{]}
+Questa @`e una @dfn{espressione tra parentesi quadre complementata}. Il primo
+carattere dopo la @samp{[} @emph{deve} essere un @samp{^}. Individua
+qualsiasi carattere
address@hidden quelli tra parentesi quadre. Per esempio, @samp{[^awk]}
+individua qualsiasi carattere che non sia una @samp{a}, @samp{w}, o @samp{k}.
+
address@hidden @code{|} (barra verticale)
address@hidden barra verticale (@code{|})
address@hidden @code{|}
+Questo @`e un @dfn{operatore alternativa} ed @`e usato per specificare delle
+alternative. La @samp{|} ha la precedenza address@hidden bassa tra tutti gli
operatori
+di espressioni regolari. Per esempio, @samp{^P|[aeiouy]} individua tutte le
+stringhe corrispondenti a @samp{^P} oppure a @samp{[aeiouy]}. address@hidden
significa
+che individua qualsiasi stringa che inizi con @samp{P} o contenga (in
+qualsiasi posizione al suo interno) una vocale inglese minuscola.
+
+L'alternativa si applica alle @dfn{regexp} address@hidden ampie individuabili
in ogni
+lato.
+
address@hidden @code{()} (parentesi), operatore @dfn{regexp}
address@hidden parentesi (@code{()}), operatore @dfn{regexp}
address@hidden @code{(address@hidden@code{)}
+Le parentesi sono usate per raggruppare, sia nelle espressioni regolari sia
+in quelle aritmetiche. Si possono usare per concatenare espressioni regolari
+che contengono l'operatore alternativa, @samp{|}. Per esempio,
address@hidden@@(samp|code)address@hidden@address@hidden individua sia
@samp{@@address@hidden@}} sia
address@hidden@@address@hidden@}}.
+(Queste sono sequenze in linguaggio Texinfo per controllare la formattazione.
+Il significato di @samp{+} @`e
+spiegato address@hidden avanti in questa lista.)
+
address@hidden @code{*} (asterisco), operatore @code{*}, come operatore
@dfn{regexp}
address@hidden asterisco (@code{*}), operatore @code{*}, come operatore
@dfn{regexp}
address@hidden @code{*}
+Questo simbolo richiede che la precedente espressione regolare sia
+ripetuta tante volte quanto serve per trovare una corrispondenza. Per
+esempio, @samp{ph*} applica il simbolo
address@hidden al carattere @samp{h} che lo precede immediatamente e ricerca
+corrispondenze costituite da una @samp{p} seguita da un numero qualsiasi di
address@hidden Viene individuata anche solo la @samp{p}, se non ci sono
address@hidden
+
+Ci sono due sfumature da capire sul funzionamento di @samp{*}.
+Primo, @samp{*} tiene conto solo del singolo componente dell'espressione
+regolare che lo precede (p.es., in @samp{ph*} vale solo per @samp{h}).
+Per fare address@hidden@dotless{i}} che @samp{*} si applichi a una
sottoespressione address@hidden estesa,
+occorre metterla tra parentesi:
address@hidden(ph)*} individua @samp{ph}, @samp{phph}, @samp{phphph} e
address@hidden@dotless{i}} via.
+
+Secondo, @samp{*} trova quante address@hidden ripetizioni siano possibili. Se
il testo
+da ricercare @`e @samp{phhhhhhhhhhhhhhooey}, @samp{ph*} individua tutte le
address@hidden
+
address@hidden @code{+} (address@hidden), operatore @dfn{regexp}
address@hidden address@hidden (@code{+}), operatore @dfn{regexp}
address@hidden @code{+}
+Questo simbolo @`e simile a @samp{*}, tranne per il fatto che l'espressione
+precedente deve essere trovata almeno una volta. Questo significa che
address@hidden individuerebbe @samp{why} e @samp{whhy}, ma non @samp{wy}, mentre
address@hidden li troverebbe tutti e tre.
+
address@hidden @code{?} (punto interrogativo), operatore @dfn{regexp}
address@hidden punto interrogativo (@code{?}), operatore @dfn{regexp}
address@hidden @code{?}
+Questo simbolo @`e simile a @samp{*}, tranne per il fatto che l'espressione che
+precede address@hidden essere trovata una volta sola oppure non trovata
+affatto. Per esempio, @samp{fe?d}
+individua @samp{fed} e @samp{fd}, ma nient'altro.
+
address@hidden espressioni di intervallo, (@dfn{regexp})
address@hidden @address@hidden@address@hidden@}}
address@hidden @address@hidden@address@hidden,@}}
address@hidden @address@hidden@address@hidden,address@hidden@address@hidden
+Uno o due numeri tra parentesi graffe rappresentano una
address@hidden di intervallo}.
+Se c'@`e un numero tra graffe, la @dfn{regexp} precedente @`e ripetuta
address@hidden volte.
+Se ci sono due numeri separati da una virgola, la @dfn{regexp} precedente @`e
+ripetuta da @var{n} a @var{m} volte.
+Se c'@`e un numero seguito da una virgola, allora la @dfn{regexp} precedente
address@hidden ripetuta almeno @var{n} volte:
+
address@hidden @code
address@hidden address@hidden@}y
+Riconosce @samp{whhhy}, ma non @samp{why} o @samp{whhhhy}.
+
address@hidden address@hidden,address@hidden
+Riconosce soltanto @samp{whhhy}, @samp{whhhhy}, o @samp{whhhhhy}.
+
address@hidden address@hidden,@}y
+Riconosce @samp{whhy}, @samp{whhhy} e address@hidden@dotless{i}} via.
address@hidden table
+
address@hidden POSIX @command{awk}, espressioni di intervallo in
+Le espressioni di intervallo non erano tradizionalmente disponibili in
address@hidden Sono state aggiunte come parte dello standard POSIX per
+rendere @command{awk} ed @command{egrep} coerenti tra di loro.
+
address@hidden @command{gawk}, espressioni di intervallo e
+In passato, poich@'e vecchi programmi possono usare @address@hidden e
@address@hidden in
+costanti @dfn{regexp},
address@hidden @emph{non} riconosceva espressioni di intervallo
+nelle @dfn{regexp}.
+
+Comunque, a partire dalla @value{PVERSION} 4.0,
address@hidden riconosce espressioni di intervallo per default.
address@hidden accade perch@'e la address@hidden con POSIX @`e ritenuta
address@hidden
+importante da molti utenti @command{gawk} rispetto alla address@hidden con
+dei vecchi programmi.
+
+Per programmi che usano @address@hidden e @address@hidden in costanti
@dfn{regexp},
address@hidden buona pratica proteggerli sempre con una barra inversa. Allora
le
+costanti @dfn{regexp} sono valide e si comportano come desiderato, usando
+qualsiasi versione di @address@hidden@`E meglio usare due barre inverse
+se si sta usando una costante stringa con un operatore @dfn{regexp} o una
+funzione.}
+
+Infine, quando @address@hidden e @address@hidden appaiono in costanti
@dfn{regexp}
+in un modo non interpretabile come espressione di intervallo
+(come in @code{/address@hidden@}/}), allora sono prese letteralmente.
address@hidden table
+
address@hidden precedenza, operatore @dfn{regexp}
address@hidden espressioni regolari, operatori, precedenza di
+Nelle espressioni regolari, gli operatori @samp{*}, @samp{+}, e @samp{?},
+come pure le parentesi graffe @address@hidden e @address@hidden,
+hanno
+la precedenza address@hidden alta, seguiti dalla concatenazione, e infine da
@samp{|}.
+Come nell'algebra, le parentesi possono cambiare il raggruppamento degli
+operatori.
address@hidden POSIX @command{awk}, espressioni regolari e
address@hidden @command{gawk}, espressioni regolari, precedenza
+In POSIX @command{awk} e in @command{gawk}, gli operatori @samp{*},
address@hidden, e @samp{?} rappresentano se stessi quando non c'@`e nulla
+nella @dfn{regexp} che li precede. Per esempio, @code{/+/} individua un
+semplice segno address@hidden Comunque, molte altre versioni di @command{awk}
+trattano una simile notazione come un errore di sintassi.
+
+Se @command{gawk} @`e in address@hidden compatibile (@pxref{Opzioni}), le
espressioni
+di intervallo non si possono usare nelle espressioni regolari.
+
address@hidden Espressioni tra parentesi quadre
address@hidden Usare espressioni tra parentesi quadre
address@hidden espressioni tra parentesi quadre
address@hidden espressioni tra parentesi quadre, espressioni di intervallo
address@hidden espressioni di intervallo, (@dfn{regexp})
address@hidden elenchi di caratteri in un'espressione regolare
address@hidden caratteri, elenchi di, in un'espressione regolare
+
+Come detto sopra, un'espressione tra parentesi quadre individua qualsiasi
+carattere incluso tra le parentesi quadre aperta e chiusa.
+
+All'interno di un'espressione tra parentesi quadre, una
address@hidden di intervallo} @`e formata da due caratteri separati da un
+trattino. Individua ogni singolo carattere compreso tra i due caratteri,
+ordinati secondo l'insieme di caratteri in uso nel sistema. Per esempio,
address@hidden @`e equivalente a @samp{[0123456789]}.
+(Si veda @ref{Intervalli e localizzazione} per una spiegazione di come
+lo standard POSIX e @command{gawk} sono cambiati nel corso degli anni.
+La cosa ha un interesse principalmente storico.)
+
+Con la crescente address@hidden dello
address@hidden://www.unicode.org, standard di caratteri Unicode},
+c'@`e un'ulteriore dettaglio da tenere in conto. Le sequenze di
+protezione ottali ed esadecimali utilizzabili per inserire
+valori all'interno di espressioni tra parentesi quadre
+sono considerate contenere solo caratteri
+che occupano un unico byte (caratteri il cui valore stia
+nell'intervallo 0--256). Per individuare un intervallo di
+caratteri in cui i punti di inizio e fine dell'intervello
+abbiano valori maggiori di 256, occorre immettere direttamente
+le codifiche multi-byte dei caratteri in questione.
+
address@hidden @code{\} (barra inversa), in espressioni tra parentesi quadre
address@hidden barra inversa (@code{\}), in espressioni tra parentesi quadre
address@hidden @code{^} (circonflesso), in espressioni tra parentesi quadre
address@hidden circonflesso (@code{^}), in espressioni tra parentesi quadre
address@hidden @code{-} (meno), in espressioni tra parentesi quadre
address@hidden meno (@code{-}), in espressioni tra parentesi quadre
+Per includere uno dei caratteri @samp{\}, @samp{]}, @samp{-}, o @samp{^} in
+un'espressione tra parentesi quadre, occorre inserire un @samp{\} prima del
+carattere stesso. Per esempio:
+
address@hidden
+[d\]]
address@hidden example
+
address@hidden
+individua sia @samp{d} che @samp{]}.
+Inoltre, se si mette una @samp{]} subito dopo la
address@hidden aperta, la parentesi quadra chiusa @`e considerata come uno dei
+caratteri da individuare.
+
address@hidden POSIX @command{awk}, espressioni tra parentesi quadre e
address@hidden espressioni regolari estese (ERE)
address@hidden ERE (espressioni regolari estese)
address@hidden @command{egrep}, programma di address@hidden
address@hidden programma di address@hidden @command{egrep}
+L'utilizzo di @samp{\} nelle espressioni tra parentesi quadre
address@hidden compatibile con altre implementazioni di @command{awk} ed @`e
anche richiesto
+da POSIX.
+Le espressioni regolari in @command{awk} sono un insieme address@hidden esteso
delle
+specificazioni POSIX per le espressioni regolari estese (ERE).
+Le ERE POSIX sono basate sulle espressioni regolari accettate dal
+tradizionale programma di address@hidden @command{egrep}.
+
address@hidden espressioni tra parentesi quadre, classi di caratteri
address@hidden POSIX @command{awk}, espressioni tra parentesi quadre e, classi
di caratteri
+Le @dfn{classi di caratteri} sono una address@hidden introdotta nello standard
+POSIX. Una classe di caratteri @`e una particolare notazione per descrivere
+liste di caratteri cha hanno un attributo specifico, ma i caratteri
+veri e propri possono variare da paese a paese e/o
+da insieme di caratteri a insieme di caratteri. Per esempio, la nozione di
+cosa sia un carattere alfabetico @`e diversa tra gli Stati Uniti e la Francia.
+
+Una classe di caratteri @`e valida solo in una @dfn{regexp} @emph{contenuta}
+tra le parentesi quadre di un'espressione tra parentesi quadre. Le classi di
+caratteri consistono di @samp{[:},
+una parola chiave che segnala la classe, e @samp{:]}. La
address@hidden elenca le classi di caratteri definite dallo
+standard POSIX.
+
address@hidden Tabella,tabella-caratteri-classe
address@hidden di caratteri POSIX}
address@hidden @columnfractions .15 .85
address@hidden Classe @tab Significato
address@hidden @code{[:alnum:]} @tab Caratteri alfanumerici.
address@hidden @code{[:alpha:]} @tab Caratteri alfabetici.
address@hidden @code{[:blank:]} @tab Caratteri spazio e TAB.
address@hidden @code{[:cntrl:]} @tab Caratteri di controllo.
address@hidden @code{[:digit:]} @tab Caratteri numerici.
address@hidden @code{[:graph:]} @tab Caratteri che sono stampabili e visibili.
+(Uno @dfn{spazio} @`e stampabile ma non visibile, mentre una @samp{a} @`e
l'uno e
+l'altro.)
address@hidden @code{[:lower:]} @tab Caratteri alfabetici minuscoli.
address@hidden @code{[:print:]} @tab Caratteri stampabili (caratteri che non
sono
+caratteri di controllo).
address@hidden @code{[:punct:]} @tab Caratteri di punteggiatura (caratteri che
non
+sono lettere, cifre, caratteri di controllo, o caratteri di spazio).
address@hidden @code{[:space:]} @tab Caratteri di spazio (come @dfn{spazio},
TAB, e
address@hidden, per citarne alcuni).
address@hidden @code{[:upper:]} @tab Caratteri alfabetici maiuscoli.
address@hidden @code{[:xdigit:]} @tab Caratteri che sono cifre esadecimali.
address@hidden multitable
address@hidden float
+
+Per esempio, prima dello standard POSIX, si doveva scrivere
address@hidden/[A-Za-z0-9]/} per individuare i
+caratteri alfanumerici. Se l'insieme
+di caratteri in uso comprendeva altri caratteri alfabetici, l'espressione
+non li avrebbe individuati.
+Con le classi di caratteri POSIX si address@hidden scrivere
address@hidden/[[:alnum:]]/} per designare i caratteri alfabetici e numerici
+dell'insieme di caratteri in uso.
+
address@hidden Thanks to
address@hidden Date: Tue, 01 Jul 2014 07:39:51 +0200
address@hidden From: Hermann Peifer <address@hidden>
+Alcuni programmi di address@hidden che cercano espressioni regolari prevedono
+una classe di caratteri, non standard,
address@hidden:ascii:]}; @command{awk} non la prevede. Tuttavia, @`e possibile
ottenere
+lo stesso risultato utilizzando @samp{[\x00-\x7F]}. Quest'espressione
+individua tutti i valori numerici tra zero e 127, che @`e l'intervallo definito
+dell'insieme di caratteri ASCII. Usando una lista di caratteri che esclude
+(@samp{[^\x00-\x7F]}) si individuano tutti i caratteri mono-byte che non
+sono nell'intervallo ASCII.
+
address@hidden espressioni tra parentesi quadre, elementi di collazione
address@hidden espressioni tra parentesi quadre, non-ASCII
address@hidden elementi di collazione
+In espressioni tra parentesi quadre possono apparire due ulteriori sequenze
+speciali. Riguardano insiemi di caratteri non-ASCII, che possono avere
+simboli singoli (chiamati @dfn{elementi di collazione}) che sono rappresentati
+con address@hidden di un carattere. Possono designare anche parecchi
caratteri che sono
+equivalenti tra loro ai fini della @dfn{collazione}, o dell'ordinamento.
+(Per esempio, in francese, la semplice ``e'' e la sua versione con accento
grave address@hidden''
+sono equivalenti). Queste sequenze sono:
+
address@hidden @asis
address@hidden espressioni tra parentesi quadre, elementi di collazione
address@hidden elementi di collazione
address@hidden elementi di collazione
+Elementi di collazione multi-byte racchiusi fra
address@hidden e @samp{.]}. Per esempio, se @samp{ch} @`e un elemento di
collazione,
address@hidden @`e una @dfn{regexp} che individua questo elemento di
+collazione, mentre @samp{[ch]} @`e una @dfn{regexp} che individua le lettere
address@hidden o @samp{h}.
+
address@hidden espressioni tra parentesi quadre, classi di equivalenza
address@hidden classi di equivalenza
+Sono nomi, specifici a una particolare localizzazione, per una lista di
+caratteri equivalenti tra loro. Il nome @`e racchiuso fra
address@hidden e @samp{=]}.
+Per esempio, il nome @samp{e} potrebbe essere usato per designare
+``e'', address@hidden'', address@hidden'', e ``@'e''. In questo caso,
@samp{[[=e=]]} @`e una @dfn{regexp}
+che corrisponde a @samp{e}, @address@hidden, @address@hidden e @samp{@'e}.
address@hidden table
+
+Queste address@hidden sono molto utili in localizzazioni non inglesi.
+
address@hidden internazionalizzazione, localizzazione, classi di caratteri
address@hidden @command{gawk}, classi di caratteri e
address@hidden POSIX @command{awk}, espressioni tra parentesi quadre e, classi
di caratteri
address@hidden ATTENZIONE
+Le funzioni di libreria che @command{gawk} usa per individuare le espressioni
+regolari per ora riconoscono solo le classi di caratteri POSIX;
+non riconoscono simboli di collazione o classi di equivalenza.
address@hidden quotation
address@hidden maybe one day ...
+
+In un'espressione tra parentesi quadre, una parentesi aperta (@samp{[})
+che non costituisca l'inizio della specificazione di una classe di
+caratteri, di simboli di collazione o di una classe di equivalenza
address@hidden interpretata letteralmente. Questo vale anche per @samp{.} e
@samp{*}.
+
address@hidden address@hidden lungo da sinistra
address@hidden Quanto @`e lungo il testo individuato?
+
address@hidden espressioni regolari, corrispondenza address@hidden a sinistra
address@hidden @cindex matching, leftmost longest
+Si consideri il caso seguente:
+
address@hidden
+echo aaaabcd | awk '@{ sub(/a+/, "<A>"); print @}'
address@hidden example
+
+Questo esempio usa la funzione @code{sub()} per modificare il record in input.
+(@code{sub()} sostituisce la prima ricorrenza in ogni testo individuato dal
+primo argomento con la stringa fornita come secondo argomento;
address@hidden per stringhe}.) Qui, la @dfn{regexp} @code{/a+/} richiede
+``uno o address@hidden caratteri @samp{a},'' e il testo da sostituire @`e
@samp{<A>}.
+
+L'input contiene quattro caratteri @samp{a}.
+Le espressioni regolari @command{awk} (e POSIX) individuano sempre
+la sequenza @address@hidden lunga}, partendo da sinistra, di caratteri in
input che
+corrispondono. Quindi, tutti e quattro i caratteri @samp{a} sono
+rimpiazzati con @samp{<A>} in questo esempio:
+
address@hidden
+$ @kbd{echo aaaabcd | awk '@{ sub(/a+/, "<A>"); print @}'}
address@hidden <A>bcd
address@hidden example
+
+Per semplici test corrisponde/non corrisponde, la cosa ha poca importanza.
+Ma se si sta controllando un testo o si fanno sostituzioni usando le funzioni
address@hidden()}, @code{sub()}, @code{gsub()} e @code{gensub()},
address@hidden invece molto importante.
address@hidden
address@hidden per stringhe},
+Per maggiori informazioni su queste funzioni.
address@hidden ifinfo
+Tenere in conto questo principio @`e importante anche quando si suddividono
+record e campi usando delle @dfn{regexp} (@pxref{Record},
+e anche @pxref{Separatori di campo}).
+
address@hidden Espressioni regolari calcolate
address@hidden Usare @dfn{regexp} dinamiche
+
address@hidden espressioni regolari calcolate
address@hidden espressioni regolari dinamiche
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @cindex operators, @code{~}
address@hidden @cindex operators, @code{!~}
+L'espressione a destra di un operatore @samp{~} o @samp{!~} non deve
+necessariamente essere una costante @dfn{regexp} (address@hidden, una stringa
di
+caratteri tra barre). address@hidden essere una qualsiasi
+espressione. L'espressione @`e valutata e convertita in una stringa
+se necessario; il contenuto della stringa @`e poi usato come una @dfn{regexp}.
+Una @dfn{regexp} calcolata in questo modo @`e detta una @dfn{regexp dinamica}
+o una @dfn{regexp calcolata}:
+
address@hidden
+BEGIN @{ @dfn{regexp}_numerica = "[[:digit:]]+" @}
+$0 ~ @dfn{regexp}_numerica @{ print @}
address@hidden example
+
address@hidden
+Questo @dfn{script} imposta @code{regexp_numerica} come una @dfn{regexp} che
+descrive una o address@hidden cifre, e poi controlla se un record in input
corrisponde a
+questa regexp.
+
address@hidden NOTA
+Usando gli operatori @samp{~} e @samp{!~}, si tenga presente che c'@`e
+una differenza tra una costante @dfn{regexp} racchiusa tra barre e una
+costante stringa racchiusa tra doppi apici.
+Se si intende utilizzare una costante stringa, occorre comprendere che
+la stringa @`e, in sostanza, scandita @emph{due volte}: la prima volta quando
address@hidden legge il programma, e la seconda volta quando va a
+confrontare la stringa a sinistra dell'operatore con il modello che sta
+alla sua destra. Questo vale per ogni espressione (come la
address@hidden, vista nel precedente esempio), non solo per le
+costanti stringa.
address@hidden quotation
+
address@hidden costanti @dfn{regexp}, barre vs.@: doppi apici
address@hidden @code{\} (barra inversa), in costanti @dfn{regexp}
address@hidden barra inversa (@code{\}), in costanti @dfn{regexp}
address@hidden @code{"} (doppio apice), in costanti @dfn{regexp}
address@hidden doppio apice (@code{"}), in costanti @dfn{regexp}
+Che differenza fa la doppia scansione di una stringa?
+La risposta ha a che vedere con le sequenze di protezione e particolarmente
+con le barre inverse. Per inserire una barra inversa in un'espressione
+regolare all'interno di una stringa, occorre inserire @emph{due} barre
+inverse.
+
+Per esempio, @code{/\*/} @`e una costante @dfn{regexp} per designare un
@samp{*}
+letterale.
address@hidden richiesta una sola barra inversa. Per fare lo stesso con una
stringa,
+occorre immettere @code{"\\*"}. La prima barra inversa protegge la
+seconda in modo che la stringa in address@hidden contenga i
+due caratteri @samp{\} e @samp{*}.
+
address@hidden risoluzione di problemi, costanti @dfn{regexp} vs.@: costanti
stringa
address@hidden problemi, risoluzione di, costanti @dfn{regexp} vs.@: costanti
stringa
address@hidden costanti @dfn{regexp}, vs.@: costanti stringa
address@hidden costanti stringa, vs.@: costanti @dfn{regexp}
+Dato che si possono usare sia costanti @dfn{regexp} che costanti stringa per
+descrivere espressioni regolari, qual @`e da preferire? La risposta @`e
+``costanti @dfn{regexp}'', per molti motivi:
+
address@hidden @value{BULLET}
address@hidden
+Le costanti stringa sono address@hidden complicate da scrivere e
address@hidden difficili
+da leggere. Usare costanti @dfn{regexp} rende i programmi
+meno inclini all'errore. Non comprendere la differenza tra i due tipi di
+costanti @`e una fonte frequente di errori.
+
address@hidden
address@hidden address@hidden efficiente usare costanti @dfn{regexp}.
@command{awk} address@hidden accorgersi
+che @`e stata fornita una @dfn{regexp} e memorizzarla internamente in una forma
+che rende la ricerca di corrispondenze address@hidden efficiente. Se si usa
una costante
+stringa, @command{awk} deve prima convertire la stringa nel suo formato
+interno e quindi eseguire la ricerca di corrispondenze.
+
address@hidden
+Usare costanti @dfn{regexp} @`e la forma migliore; lascia comprendere
+chiaramente che si vuole una corrispondenza con una @dfn{regexp}.
address@hidden itemize
+
address@hidden sidebar, Usare @code{\n} in espressioni tra parentesi quadre in
@dfn{regexp} dinamiche
address@hidden
address@hidden
+<sidebar><title>Usare @code{\n} in espressioni tra parentesi quadre in
@dfn{regexp} dinamiche</title>
address@hidden docbook
+
address@hidden espressioni regolari dinamiche, contenenti dei ritorni a capo
address@hidden ritorno a capo, in @dfn{regexp} dinamiche
+
+Alcune delle prime versioni di @command{awk} non consentono di usare il
+carattere di ritorno
+a capo all'interno di un'espressione tra parentesi quadre in @dfn{regexp}
+dinamiche:
+
address@hidden
+$ @kbd{awk '$0 ~ "[ \t\n]"'}
address@hidden awk: newline in character class [
address@hidden ]...
address@hidden source line number 1
address@hidden context is
address@hidden $0 ~ "[ >>> \t\n]" <<<
address@hidden example
+
address@hidden ritorno a capo, in costanti @dfn{regexp}
+Ma un ritorno a capo in una costante @dfn{regexp} non address@hidden alcun
problema:
+
address@hidden
+$ @kbd{awk '$0 ~ /[ \t\n]/'}
address@hidden una riga di esempio}
address@hidden ecco una riga di esempio
address@hidden
address@hidden example
+
address@hidden non ha questo problema, e non dovrebbe accadere spesso
+in pratica, ma val la pena di notarlo a futura memoria.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Usare @code{\n} in espressioni tra parentesi quadre in
@dfn{regexp} dinamiche}
+
+
address@hidden espressioni regolari dinamiche, contenenti dei ritorni a capo
address@hidden ritorno a capo, in @dfn{regexp} dinamiche
+
+Alcune delle prime versioni di @command{awk} non consentono di usare il
+carattere di ritorno
+a capo all'interno di un'espressione tra parentesi quadre in @dfn{regexp}
+dinamiche:
+
address@hidden
+$ @kbd{awk '$0 ~ "[ \t\n]"'}
address@hidden awk: newline in character class [
address@hidden ]...
address@hidden source line number 1
address@hidden context is
address@hidden $0 ~ "[ >>> \t\n]" <<<
address@hidden example
+
address@hidden ritorno a capo, in costanti @dfn{regexp}
+Ma un ritorno a capo in una costante @dfn{regexp} non address@hidden alcun
problema:
+
address@hidden
+$ @kbd{awk '$0 ~ /[ \t\n]/'}
address@hidden una riga di esempio}
address@hidden ecco una riga di esempio
address@hidden
address@hidden example
+
address@hidden non ha questo problema, e non dovrebbe accadere spesso
+in pratica, ma val la pena di notarlo a futura memoria.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Operatori di @dfn{regexp} GNU
address@hidden Operatori @dfn{regexp} propri di @command{gawk}
+
address@hidden This section adapted (long ago) from the regex-0.12 manual
+
address@hidden espressioni regolari, operatori, @command{gawk}
address@hidden @command{gawk}, espressioni regolari, operatori
address@hidden operatori, specifici per GNU
address@hidden espressioni regolari, operatori, per parole
address@hidden parola, definizione in @dfn{regexp}
+Il software GNU che ha a che fare con espressioni regolari comprende alcuni
+operatori @dfn{regexp} aggiuntivi. Questi
+operatori sono descritti in
address@hidden
+questa
address@hidden ifnotinfo
address@hidden
+questo
address@hidden ifinfo
address@hidden e sono specificamente
+per @command{gawk}; non sono disponibili in altre implementazioni di
address@hidden
+La maggior parte degli operatori aggiuntivi riguarda l'identificazione di
+parole. Ai nostri fini, una @dfn{parola} @`e una sequenza di uno o
address@hidden lettere,
+cifre, o trattini bassi (@samp{_}):
+
address@hidden @code
address@hidden @cindex operatori, @code{\s} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\s}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\s}, operatore (@command{gawk})
address@hidden \s
+Corrisponde a ogni carattere bianco.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[[:space:]]}}.
+
address@hidden @cindex operatori, @code{\S} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\S}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\S}, operatore (@command{gawk})
address@hidden \S
+Corrisponde a ogni carattere che non @`e uno spazio bianco.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[^[:space:]]}}.
+
address@hidden @cindex operatori, @code{\w} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\w}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\w}, operatore (@command{gawk})
address@hidden \w
+Corrisponde a ogni carattere che componga una parola; ovvero, corrisponde a
+ogni lettera, cifra, o trattino basso.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[[:alnum:]_]}}.
+
address@hidden @cindex operatori, @code{\W} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\W}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\W}, operatore (@command{gawk})
address@hidden \W
+Corrisponde a ogni carattere che non @`e parte di una parola.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[^[:alnum:]_]}}.
+
address@hidden @cindex operatori, @code{\<} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\<}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\<}, operatore (@command{gawk})
address@hidden \<
+Individua la stringa nulla all'inizio di una parola.
+Per esempio, @code{/\<via/} individua @samp{via} ma non
address@hidden
+
address@hidden @cindex operatori, @code{\>} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\>}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\>}, operatore (@command{gawk})
address@hidden \>
+Individua la stringa nulla alla fine di una parola.
+Per esempio, @code{/via\>/} individua @samp{via} ma non @samp{viadotto}.
+
address@hidden @cindex operatori, @code{\y} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\y}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\y}, operatore (@command{gawk})
address@hidden limite-di-parola, individuare il
address@hidden \y
+Individua la stringa nulla o alla fine o all'inizio di una parola.
+(address@hidden, il limite di una parola - @address@hidden in inglese).
+Per esempio, @samp{\yradar?\y}
+individua sia @samp{rada} che @samp{radar}, come parole separate.
+
address@hidden @cindex operatori, @code{\B} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\B}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\B}, operatore (@command{gawk})
address@hidden \B
+Individua la stringa nulla che ricorre all'interno di una parola.
+Per esempio,
address@hidden/\Bora\B/} individua @samp{Colorado}, ma non individua @samp{che
ora @`e}.
address@hidden @`e essenzialmente l'opposto di @samp{\y}.
address@hidden table
+
address@hidden buffer, operatori per
address@hidden espressioni regolari, operatori, per buffer
address@hidden operatori, ricerca in stringhe, per buffer
+Ci sono due altri operatori che operano sui buffer. In Emacs un
address@hidden @`e, naturalmente, un buffer di Emacs. In altri programmi GNU,
+fra cui @command{gawk}, le routine di libreria delle @dfn{regexp} considerano
+come buffer l'intera stringa su cui effettuare il confronto.
+Gli operatori sono:
+
address@hidden @code
address@hidden \`
address@hidden @cindex operatori, @code{\`} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\`}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\`}, operatore (@command{gawk})
+Individua la stringa nulla che occorre all'inizio di un buffer
+(di una stringa)
+
address@hidden @cindex operatori, @code{\'} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\'}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\'}, operatore (@command{gawk})
address@hidden \'
+Individua la stringa nulla che occorre alla fine di un buffer
+(di una stringa)
address@hidden table
+
address@hidden @code{^} (circonflesso), operatore @dfn{regexp}
address@hidden circonflesso (@code{^}), operatore @dfn{regexp}
address@hidden @code{?} (punto interrogativo), operatore @dfn{regexp}
address@hidden punto interrogativo (@code{?}), operatore @dfn{regexp}
+Poich@'e @samp{^} e @samp{$} si riferiscono sempre all'inizio e alla
+fine di stringhe, questi operatori non aggiungono nuove address@hidden
+ad @command{awk}. Sono inclusi per address@hidden con altro
+software GNU.
+
address@hidden @command{gawk}, operatore limite-di-parola
address@hidden limite-di-parola, operatore (@command{gawk})
address@hidden operatori, limite-di-parola (@command{gawk})
+In altro software GNU, l'operatore di limite-di-parola @`e @samp{\b}. Questo,
+comunque, @`e in conflitto con la definizione, nel linguaggio @command{awk},
+di @samp{\b} come
+backspace, quindi @command{gawk} usa una lettera differente.
+Un metodo alternativo sarebbe stato di richiedere due barre inverse negli
+operatori GNU, ma questo @`e stato ritenuto troppo arzigogolato. Il metodo
+corrente di usare @samp{\y} al posto del @samp{\b} di GNU sembra essere
+il male minore.
+
address@hidden espressioni regolari, @command{gawk}, opzioni sulla riga di
comando
address@hidden @command{gawk}, opzioni sulla riga di comando, ed espressioni
regolari
+Le varie opzioni sulla riga di comando
+(@pxref{Opzioni})
+controllano come @command{gawk} interpreta i caratteri nelle @dfn{regexp}:
+
address@hidden @asis
address@hidden Nessuna opzione
+Per default, @command{gawk} fornisce tutte le address@hidden delle
+regexp POSIX e gli
+operatori @dfn{regexp} GNU
address@hidden
+predecentemente descritti.
address@hidden ifnotinfo
address@hidden
address@hidden
+Sono descritti
+in @ref{Operatori di espressioni regolari}.
address@hidden ifnotdocbook
address@hidden ifnottex
+
address@hidden @code{--posix}
+Sono ammesse solo le @dfn{regexp} POSIX; gli operatori GNU non sono
+speciali (p.es., @samp{\w} individua una semplice lettera @samp{w}).
+Le espressioni di intervallo sono ammesse.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden @code{--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.
+I caratteri descritti usando sequenze di protezione ottali ed esadecimali sono
+trattati letteralmente, anche se rappresentano metacaratteri di @dfn{regexp}.
+
address@hidden @code{--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.
address@hidden table
+
address@hidden Maiuscolo-Minuscolo
address@hidden Fare confronti ignorando maiuscolo/minuscolo
+
address@hidden espressioni regolari, maiuscolo/minuscolo
address@hidden @dfn{regexp}, maiuscolo/minuscolo
address@hidden maiuscolo/minuscolo e @dfn{regexp}
+Il tipo di carattere (maiuscolo/minuscolo) @`e normalmente rilevante nelle
+espressioni regolari, sia nella ricerca di
+caratteri normali (address@hidden, non metacaratteri), sia all'interno di
espressioni
+fra parentesi. Quindi, una @samp{w} in un'espressione regolare individua
+solo una @samp{w} e non la corrispondente maiuscola @samp{W}.
+
+Il modo address@hidden semplice per richiedere una ricerca non sensibile al
+maiuscolo/minuscolo @`e di usare un'espressione tra parentesi quadre, per
+esempio @samp{[Ww]}. Comunque, questo address@hidden essere pesante se si usa
spesso,
+e address@hidden rendere le espressioni regolari di difficile lettura.
+Ci sono due alternative che potrebbero essere preferibili.
+
+Un modo per fare un confronto non sensibile a maiuscolo/minuscolo in un
+particolare punto del programma
address@hidden di convertire i dati in un solo tipo (o minuscole o maiuscole),
+usando le funzioni di stringa
+predefinite @code{tolower()} o @code{toupper()} (che non
+abbiamo ancora introdotto;
address@hidden per stringhe}).
+Per esempio:
+
address@hidden
+tolower($1) ~ /foo/ @{ @dots{} @}
address@hidden example
+
address@hidden
+converte il primo campo in minuscole, prima di fare un confronto.
+Questo funziona in ogni @command{awk} conforme allo standard POSIX.
+
address@hidden @command{gawk}, espressioni regolari, differenza
maiuscolo/minuscolo
address@hidden distinzione maiuscolo/minuscolo, @command{gawk}
address@hidden differenze tra @command{awk} e @command{gawk}, espressioni
regolari
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @code{IGNORECASE}, variabile, con operatori @code{~} e @code{!~}
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden @cindex variables, @code{IGNORECASE}
+Un altro metodo, proprio di @command{gawk}, @`e di impostare la variabile
address@hidden a un valore diverso da zero (@pxref{Variabili predefinite}).
+Quando @code{IGNORECASE} @`e diverso da zero, @emph{tutte} le operazioni con
+regexp e stringhe ignorano la distinzione maiuscolo/minuscolo.
+
+Il cambio del valore di @code{IGNORECASE} controlla dinamicamente la
address@hidden a maiuscolo/minuscolo del programma quando @`e in esecuzione.
+Il tipo di carattere (maiuscolo/minuscolo) @`e rilevante per default,
+poich@'e @code{IGNORECASE} (come la maggior parte delle variabili) @`e
+inizializzata a zero:
+
address@hidden
+x = "aB"
+if (x ~ /ab/) @dots{} # questo test non address@hidden verificato
+
+IGNORECASE = 1
+if (x ~ /ab/) @dots{} # adesso address@hidden verificato
address@hidden example
+
+In generale, non @`e possibile usare @code{IGNORECASE} per rendere certe regole
+non sensibili a maiuscolo/minuscolo e altre regole invece
address@hidden@dotless{i}}, perch@'e non c'@`e
+una maniera diretta per impostare
address@hidden solo per l'espressione di
+una particolare address@hidden esperti in C e C++ noteranno
+che questo @`e possible, usando qualcosa come
address@hidden = 1 && /foObAr/ @{ @dots{} @}}
+e
address@hidden = 0 || /foobar/ @{ @dots{} @}}.
+Comunque, questo @`e un po' tortuoso e non @`e raccomandato.}
+Per fare questo, si usino espressioni tra parentesi quadre oppure
address@hidden()}. Comunque, una cosa che si address@hidden fare con
@code{IGNORECASE}
+soltanto @`e di utilizzare o di ignorare la address@hidden a
maiuscolo/minuscolo
+per tutte le regole contemporaneamente.
+
address@hidden @`e impostabile dalla riga di comando o in una regola
address@hidden (@pxref{Altri argomenti}; e
address@hidden BEGIN/END}).
+Impostare @code{IGNORECASE} dalla riga di comando @`e un modo per rendere
+un programma insensibile a maiuscolo/minuscolo senza doverlo modificare.
+
address@hidden @cindex ISO 8859-1
address@hidden @cindex ISO Latin-1
+In localizzazioni multibyte,
+le equivalenze tra caratteri maiuscoli
+e minuscoli sono controllate usando i valori in formato esteso
+dell'insieme di caratteri della localizzazione.
+Per il resto, i caratteri sono controllati usando l'insieme di caratteri
+ISO-8859-1 (ISO Latin-1).
+Questo insieme di caratteri @`e un'estensione del tradizionale insieme con 128
+caratteri ASCII, che include anche molti caratteri adatti
+per le lingue address@hidden questo sembra oscuro,
+non c'@`e ragione di preoccuparsi; significa solo che @command{gawk} fa
+la cosa giusta.}
+
+Il valore di @code{IGNORECASE} non ha effetto se @command{gawk} @`e in
address@hidden compatibile (@pxref{Opzioni}).
+Il tipo di carattere (maiuscolo o minuscolo) @`e sempre rilevante in
address@hidden
+compatibile.
+
address@hidden Sommario espressioni regolari
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Le espressioni regolari descrivono insiemi di stringhe da confrontare.
+In @command{awk}, le costanti @dfn{regexp} sono scritte racchiuse
+fra barre: @code{/address@hidden@code{/}.
+
address@hidden
+Le costanti @dfn{regexp} possono essere usate da sole in modelli di ricerca e
+in espressioni condizionali, o come parte di espressioni di ricerca
+usando gli operatori @samp{~} e @samp{!~}.
+
address@hidden
+Le sequenze di protezione consentono di rappresentare caratteri non stampabili
+e consentono anche di rappresentare metacaratteri @dfn{regexp} come caratteri
+letterali per i quali cercare corrispondenze.
+
address@hidden
+Gli operatori @dfn{regexp} consentono raggruppamento, alternativa e
+ripetizione.
+
address@hidden
+Le espressioni tra parentesi quadre sono delle notazioni abbreviate per
+specificare insiemi di caratteri che possono avere corrispondenze in un
+punto particolare di una @dfn{regexp}.
+All'interno di espressioni tra parentesi quadre, le classi di caratteri POSIX
+consentono di specificare certi gruppi di caratteri in maniera indipendente
+dalla localizzazione.
+
address@hidden
+Le espressioni regolari individuano il testo address@hidden lungo possibile, a
partire
+da sinistra nella stringa in esame. Questo ha importanza nei casi in cui
+serve conoscere la lunghezza della corrispondenza, come nella sostituzione di
+testo e quando il separatore di record sia una @dfn{regexp}.
+
address@hidden
+Espressioni di ricerca possono usare @dfn{regexp} dinamiche, ossia, i valori
+delle stringhe sono considerato come espressioni regolari.
+
address@hidden
+La variabile @command{gawk} @code{IGNORECASE} consente di controllare la
+differenza maiuscolo/minuscolo nel confronto mediante @dfn{regexp}. In altre
+versioni di @command{awk}, vanno usate invece le funzioni @code{tolower()} o
address@hidden()}.
+
address@hidden itemize
+
address@hidden Leggere file
address@hidden Leggere file in input
+
address@hidden leggere file in input
address@hidden file in input, leggere
address@hidden file in input
address@hidden @code{FILENAME}, variabile
address@hidden variabile @code{FILENAME}
+Nel tipico programma @command{awk},
address@hidden legge tutto l'input sia dallo standard input
+(per default @`e la tastiera, ma spesso @`e una @dfn{pipe} da un altro comando)
+o da file i cui nomi vengono specificati sulla riga di comando di
address@hidden Se si specificano file in input, @command{awk} li legge
+nell'ordine, elaborando tutti i dati di uno prima di passare al successivo.
+Il nome del file in input corrente si trova nella variabile predefinita
address@hidden
+(@pxref{Variabili predefinite}).
+
address@hidden record
address@hidden campi
+L'input @`e letto in address@hidden chiamate @dfn{record}, e viene elaborato,
secondo le
+regole del programma, un record alla volta.
+Per default, ogni record @`e una riga. Ogni
+record @`e suddiviso automaticamente in "pezzi" chiamati @dfn{campi}.
+Questo rende address@hidden pratico far lavorare i programmi sulle parti di un
record.
+
address@hidden @code{getline}, comando
+In rare occasioni, si potrebbe aver bisogno di usare il comando
address@hidden Il comando @code{getline} @`e utile sia perch@'e address@hidden
procurare
+un input esplicito da un numero indeterminato di file, sia perch@'e non vanno
+specificati sulla riga di comando di @command{awk} i nomi dei file usati con
+getline (@pxref{Getline}).
+
address@hidden
+* Record:: Controllare come i dati sono suddivisi
+ in record.
+* Campi:: Un'introduzione ai campi.
+* Campi non costanti:: Numeri di campo variabili.
+* Cambiare i campi:: Cambiare il contenuto di un campo.
+* Separatori di campo:: I separatori di campo, e come
+ cambiarli.
+* Dimensione costante:: Leggere campi di larghezza costante.
+* Separazione in base al contenuto:: Definire campi dal loro contenuto.
+* Righe multiple:: Leggere record che sono su address@hidden
righe.
+* Getline:: Leggere file sotto il controllo del
+ programma, usando la funzione
+ @code{getline}.
+* Timeout in lettura:: Leggere input entro un tempo limite.
+* Proseguire dopo errore in input:: Elaborare ulteriore input dopo certi
+ errori di I/O.
+* Directory su riga di comando:: Cosa succede mettendo una directory
+ sulla riga di comando.
+* Sommario di Input:: Sommario di Input.
+* Esercizi su Input:: Esercizi.
address@hidden menu
+
address@hidden Record
address@hidden Controllare come i dati sono suddivisi in record
+
address@hidden input, suddividere in record
address@hidden record, suddividere l'input in
address@hidden @code{NR}, variabile
address@hidden @code{FNR}, variabile
address@hidden suddivide l'input per il programma in record e campi.
+Tiene traccia del numero di record address@hidden letti dal
+file in input corrente. Questo valore @`e memorizzato in una variabile
+predefinita chiamata @code{FNR} che @`e reimpostata a zero ogni volta che si
+inizia un nuovo file. Un'altra variabile predefinita, @code{NR}, registra il
+numero totale di record in input address@hidden letti da tutti i @value{DF}.
+Il suo valore iniziale @`e zero ma non viene mai reimpostata a zero
+automaticamente.
+
address@hidden
+* awk divisione record:: Come @command{awk} standard divide i record.
+* gawk divisione record:: Come @command{gawk} divide i record.
address@hidden menu
+
address@hidden awk divisione record
address@hidden Come @command{awk} standard divide i record.
+
address@hidden separatori di record
address@hidden record, separatori di
+I record sono separati da un carattere chiamato @dfn{separatore di record}.
+Per default, il separatore di record @`e il carattere di ritorno a capo.
+Questo @`e il motivo per cui i record sono, per default, righe singole.
+Per usare un diverso carattere come separatore di record
+basta assegnare quel carattere alla variabile predefinita @code{RS}.
+
address@hidden ritorno a capo, come separatore di record
address@hidden a capo, come separatore di record
address@hidden @code{RS}, variabile
+Come per ogni altra variabile,
+il valore di @code{RS} address@hidden essere cambiato nel programma
@command{awk}
+con l'operatore di assegnamento, @samp{=}
+(@pxref{Operatori di assegnamento}).
+Il nuovo separatore di record dovrebbe essere racchiuso tra doppi apici,
+per indicare una costante di stringa. Spesso il momento giusto per far questo
address@hidden all'inizio dell'esecuzione, prima che sia elaborato qualsiasi
input,
+in modo che il primo record sia letto col separatore appropriato.
+Per far address@hidden, si usa il criterio speciale @code{BEGIN}
+(@pxref{BEGIN/END}).
+Per esempio:
+
address@hidden
+awk 'BEGIN @{ RS = "u" @}
+ @{ print $0 @}' mail-list
address@hidden example
+
address@hidden
+cambia il valore di @code{RS} in @samp{u}, prima di leggere qualsiasi input.
+Il nuovo valore @`e una stringa il cui primo carattere @`e la lettera ``u'';
come
+risultato, i record sono separati dalla lettera ``u''. Poi viene letto il
+file in input, e la seconda regola nel programma @command{awk} (l'azione
+eseguita se non si specifica un criterio)
+stampa ogni record. Poich@'e ogni istruzione @code{print} aggiunge
+un ritorno a capo alla fine del suo output, questo programma
address@hidden copia l'input con ogni @samp{u} trasformato in un ritorno
+a capo. Qui vediamo il risultato dell'esecuzione del programma sul file
address@hidden:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ RS = "u" @}}
+> @address@hidden print $0 @}' mail-list}
address@hidden Amelia 555-5553 amelia.zodiac
address@hidden sq
address@hidden e@@gmail.com F
address@hidden Anthony 555-3412 anthony.assert
address@hidden ro@@hotmail.com A
address@hidden Becky 555-7685 becky.algebrar
address@hidden m@@gmail.com A
address@hidden Bill 555-1675 bill.drowning@@hotmail.com A
address@hidden Broderick 555-0542 broderick.aliq
address@hidden otiens@@yahoo.com R
address@hidden Camilla 555-2912 camilla.inf
address@hidden sar
address@hidden m@@skynet.be R
address@hidden Fabi
address@hidden s 555-1234 fabi
address@hidden s.
address@hidden ndevicesim
address@hidden s@@
address@hidden cb.ed
address@hidden F
address@hidden J
address@hidden lie 555-6699 j
address@hidden lie.perscr
address@hidden tabor@@skeeve.com F
address@hidden Martin 555-6480 martin.codicib
address@hidden s@@hotmail.com A
address@hidden Sam
address@hidden el 555-3430 sam
address@hidden el.lanceolis@@sh
address@hidden .ed
address@hidden A
address@hidden Jean-Pa
address@hidden l 555-2127 jeanpa
address@hidden l.campanor
address@hidden m@@ny
address@hidden .ed
address@hidden R
address@hidden
address@hidden example
+
address@hidden
+Si noti che la voce relativa al nome @samp{Bill} non @`e divisa.
+Nel @value{DF} originale
+(@pxref{File dati di esempio}),
+la riga appare in questo modo:
+
address@hidden
+Bill 555-1675 bill.drowning@@hotmail.com A
address@hidden example
+
address@hidden
+Essa non contiene nessuna @samp{u}, per cui non c'@`e alcun motivo di dividere
+il record, diversamente dalle altre, che hanno una o address@hidden ricorrenze
della
address@hidden Infatti, questo record @`e trattato come parte del record
precedente;
+il ritorno a capo che li separa nell'output @`e l'originale ritorno a capo nel
address@hidden, non quella aggiunta da @command{awk} quando ha stampato il
record!
+
address@hidden separatori di record, cambiare i
address@hidden record, separatori di
+Un altro modo per cambiare il separatore di record @`e sulla riga di comando,
+usando la address@hidden dell'assegnamento di variabile
+(@pxref{Altri argomenti}):
+
address@hidden
+awk '@{ print $0 @}' RS="u" mail-list
address@hidden example
+
address@hidden
+Questo imposta @code{RS} a @samp{u} prima di elaborare @file{mail-list}.
+
+Usando un carattere alfabetico come @samp{u} come separatore di record
address@hidden molto probabile che si ottengano risultati strani.
+Usando un carattere insolito come @samp{/} @`e address@hidden probabile
+che si ottenga un comportamento corretto nella maggioranza dei casi, ma non
+c'@`e nessuna garanzia. La morale @`e: conosci i tuoi dati!
+
+Quando si usano caratteri normali come separatore di record,
+c'@`e un caso insolito che capita quando @command{gawk}
address@hidden reso completamente conforme a POSIX (@pxref{Opzioni}).
+In quel caso, la seguente (estrema) @dfn{pipeline} stampa un sorprendente
address@hidden:
+
address@hidden
+$ echo | gawk --posix 'BEGIN @{ RS = "a" @} ; @{ print NF @}'
address@hidden 1
address@hidden example
+
+C'@`e un solo campo, consistente in un ritorno a capo. Il valore della
+variabile predefinita @code{NF} @`e il numero di campi nel record corrente.
+(Normalmente @command{gawk} tratta il ritorno a capo come uno spazio
+vuoto, stampando @samp{0} come risultato. Anche molte altre versioni di
address@hidden agiscono in questo modo.)
+
address@hidden angolo buio, file in input
+Il raggiungimento della fine di un file in input fa terminare il record di
+input corrente, anche se l'ultimo carattere nel file non @`e il carattere in
address@hidden @value{DARKCORNER}
+
address@hidden stringhe vuote
address@hidden stringhe nulle
address@hidden @cindex strings, empty, see null strings
+La stringa nulla @code{""} (una stringa che non contiene alcun carattere)
+ha un significato particolare come
+valore di @code{RS}. Significa che i record sono separati
+soltanto da una o address@hidden righe vuote.
address@hidden multiple} per maggiori dettagli.
+
+Se si cambia il valore di @code{RS} nel mezzo di un'esecuzione di
address@hidden, il nuovo valore @`e usato per delimitare i record successivi, ma
+non riguarda il record in corso di elaborazione e neppure quelli address@hidden
+elaborati.
+
address@hidden @command{gawk}, variabile @code{RT} in
address@hidden @code{RT}, variabile
address@hidden record, fine dei
address@hidden differenze tra @command{awk} e @command{gawk}, separatori di
record
address@hidden espressioni regolari, come separatori di record
address@hidden record, separatori di, espressioni regolari come
address@hidden separatori di record, espressioni regolari come
+Dopo che @`e stata determinata la fine di un record, @command{gawk}
+imposta la variabile @code{RT} al testo nell'input che corrisponde a
address@hidden
+
address@hidden gawk divisione record
address@hidden Divisione dei record con @command{gawk}
+
address@hidden estensioni comuni, @code{RS} come espressione regolare
address@hidden comuni, address@hidden @code{RS} come espressione regolare
+Quando si usa @command{gawk},
+il valore di @code{RS} non @`e limitato a una stringa costituita da un solo
+carattere, ma address@hidden essere qualsiasi espressione regolare
address@hidden
+(@pxrefil{Espressioni regolari}). @value{COMMONEXT}
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}). @value{COMMONEXT}
address@hidden ifnottex
+In generale, ogni record termina alla stringa address@hidden vicina che
corrisponde
+all'espressione regolare; il record successivo inizia alla fine della stringa
+che corrisponde. Questa regola generale @`e in address@hidden applicata anche
nel caso
+normale, in cui @code{RS} contiene solo un ritorno a capo: un record
+termina all'inizio della prossima stringa che corrisponde (il prossimo
+ritorno a capo nell'input), e il record seguente inizia subito dopo la
+fine di questa stringa (al primo carattere della riga seguente).
+Il ritorno a capo, poich@'e corrisponde a @code{RS}, non appartiene a
+nessuno dei due record.
+
+Quando @code{RS} @`e un singolo carattere, @code{RT}
+contiene lo stesso singolo carattere. Peraltro, quando @code{RS} @`e
+un'espressione regolare, @code{RT} contiene l'effettivo testo in input
+corrispondente all'espressione regolare.
+
+Se il file in input termina senza che vi sia un testo che corrisponda a
address@hidden, @command{gawk} imposta @code{RT} alla stringa nulla.
+
+Il seguente esempio illustra entrambe queste caratteristiche.
+In quest'esempio @code{RS} @`e impostato a un'espressione regolare che
+cerca sia un ritorno a capo che una serie di una o address@hidden lettere
+maiuscole con uno spazio vuoto opzionale iniziale e/o finale:
+
address@hidden
+$ @kbd{echo record 1 AAAA record 2 BBBB record 3 |}
+> @kbd{gawk 'BEGIN @{ RS = "\n|( *[[:upper:]]+ *)" @}}
+> @address@hidden print "Record =", $0,"e RT = [" RT "]" @}'}
address@hidden Record = record 1 e RT = [ AAAA ]
address@hidden Record = record 2 e RT = [ BBBB ]
address@hidden Record = record 3 e RT = [
address@hidden ]
address@hidden example
+
address@hidden
+Le parentesi quadre racchiudono il contenuto di @code{RT}, rendendo visibile
+lo spazio vuoto iniziale e quello finale. L'ultimo valore di
address@hidden @`e un ritorno a capo.
address@hidden sed semplice} per un esempio address@hidden utile
+su @code{RS} come espressione regolare e su @code{RT}.
+
+Se si imposta @code{RS} a un'espressione regolare che consente del testo
+finale opzionale, come @samp{RS = "abc(XYZ)?"} @`e possibile, per via di
+limitazioni dell'implementazione, che @command{gawk} possa trovare la parte
+iniziale dell'espressione regolare, ma non la parte finale, in modo
+particolare se il testo di input che potrebbe avere una corrispondenza con la
+parte finale @`e piuttosto lungo. @command{gawk} cerca di evitare questo
+problema, ma al momento non ci sono garanzie che questo funzioni sempre.
+
address@hidden NOTA
+Si ricordi che in @command{awk}, i metacaratteri di ancoraggio @samp{^} e
address@hidden trovano l'inizio e la fine di una @emph{stringa}, e non l'inizio
e la
+fine di una @emph{riga}. Come risultato, qualcosa come
address@hidden = "^[[:upper:]]"} address@hidden solo corrispondere all'inizio
di un file.
+Questo perch@'e @command{gawk} vede il file in input come un'unica lunga
stringa
+in cui possono essere presenti dei caratteri di ritorno a capo.
address@hidden meglio address@hidden evitare metacaratteri di ancoraggio nel
valore di @code{RS}.
address@hidden quotation
+
address@hidden differenze tra @command{awk} e @command{gawk}, variabili
@code{RS}/@code{RT}
+L'uso di @code{RS} come espressione regolare e la variabile @code{RT} sono
+estensioni @command{gawk}; non sono disponibili in
address@hidden compatibile
+(@pxref{Opzioni}).
+In address@hidden compatibile, solo il primo carattere del valore di
address@hidden determina la fine del record.
+
address@hidden sidebar, @code{RS = "\0"} non @`e portabile
address@hidden
address@hidden
+<sidebar><title>@code{RS = "\0"} non @`e portabile</title>
address@hidden docbook
+
address@hidden address@hidden, file di dati come un unico record
+Ci sono casi in cui capita di dover trattare un intero @value{DF} come
+un record unico. L'unico modo di far questo @`e quello di dare a @code{RS}
+un valore che non ricorre nel file in input. address@hidden @`e difficile da
fare in modo
+generale, address@hidden@dotless{i}} che un programma possa
+funzionare con file in input arbitrari.
+
+Si potrebbe pensare che per i file di testo il carattere @sc{NUL}, che
+consiste di un carattere con tutti i bit uguali a zero, sia un buon valore da
+usare per @code{RS} in questo caso:
+
address@hidden
+BEGIN @{ RS = "\0" @} # l'intero file diventa un record?
address@hidden example
+
address@hidden differenze tra @command{awk} e @command{gawk}, stringhe,
memorizzazione
address@hidden di fatto lo accetta, e usa il carattere @sc{NUL}
+come separatore di record.
+Questo funziona per certi file speciali, come @file{/proc/environ} su sistemi
+GNU/Linux, dove il carattere @sc{NUL} @`e di fatto un separatore di record..
+Comunque, quest'uso @emph{non} @`e portabile sulla maggior parte delle
+implementazioni di @command{awk}.
+
address@hidden angolo buio, stringhe, memorizzazione
+Quasi tutte le altre implementazioni di @command{awk} @footnote{Almeno quelle
+che ci sono note.} memorizzano internamente le stringhe come stringhe
+in stile C. Le stringhe in stile C usano il carattere @sc{NUL} come
+terminatore di stringa. In effetti, questo significa che
address@hidden = "\0"} @`e lo stesso di @samp{RS = ""}.
address@hidden
+
+Capita che recenti versioni di @command{mawk} possano usare i carattere
address@hidden come separatore di record. Comunque questo @`e un caso
particolare:
address@hidden non consente di includere caratteri @sc{NUL} nelle stringhe.
+(address@hidden potrebbe cambiare in una versione futura di @command{mawk}.)
+
address@hidden record, trattare un file come un solo
address@hidden trattare un file, come un solo record
address@hidden readfile} per un modo interessante di leggere
+file interi. Se si usa @command{gawk}, si veda
address@hidden di estensione Readfile} per un'altra opzione.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @address@hidden = "\0"} non @`e portabile}
+
+
address@hidden address@hidden, file di dati come un unico record
+Ci sono casi in cui capita di dover trattare un intero @value{DF} come
+un record unico. L'unico modo di far questo @`e quello di dare a @code{RS}
+un valore che non ricorre nel file in input. address@hidden @`e difficile da
fare in modo
+generale, address@hidden@dotless{i}} che un programma possa
+funzionare con file in input arbitrari.
+
+Si potrebbe pensare che per i file di testo il carattere @sc{NUL}, che
+consiste di un carattere con tutti i bit uguali a zero, sia un buon valore da
+usare per @code{RS} in questo caso:
+
address@hidden
+BEGIN @{ RS = "\0" @} # l'intero file diventa un record?
address@hidden example
+
address@hidden differenze tra @command{awk} e @command{gawk}, stringhe,
memorizzazione
address@hidden di fatto lo accetta, e usa il carattere @sc{NUL}
+come separatore di record.
+Questo funziona per certi file speciali, come @file{/proc/environ} su sistemi
+GNU/Linux, dove il carattere @sc{NUL} @`e di fatto un separatore di record..
+Comunque, quest'uso @emph{non} @`e portabile sulla maggior parte delle
+implementazioni di @command{awk}.
+
address@hidden angolo buio, stringhe, memorizzazione
+Quasi tutte le altre implementazioni di @command{awk} @footnote{Almeno quelle
+che ci sono note.} memorizzano internamente le stringhe come stringhe
+in stile C. Le stringhe in stile C usano il carattere @sc{NUL} come
+terminatore di stringa. In effetti, questo significa che
address@hidden = "\0"} @`e lo stesso di @samp{RS = ""}.
address@hidden
+
+Capita che recenti versioni di @command{mawk} possano usare i carattere
address@hidden come separatore di record. Comunque questo @`e un caso
particolare:
address@hidden non consente di includere caratteri @sc{NUL} nelle stringhe.
+(address@hidden potrebbe cambiare in una versione futura di @command{mawk}.)
+
address@hidden record, trattare un file come un solo
address@hidden trattare un file, come un solo record
address@hidden readfile} per un modo interessante di leggere
+file interi. Se si usa @command{gawk}, si veda
address@hidden di estensione Readfile} per un'altra opzione.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Campi
address@hidden Un'introduzione ai campi
+
address@hidden esaminare i campi
address@hidden campi
address@hidden accesso ai campi
address@hidden campi, esame dei
+Quando @command{awk} legge un record in input, il record @`e
+automaticamente @dfn{analizzato} o separato da @command{awk} in "pezzi"
+chiamati @dfn{campi}. Per default, i campi sono separati da
address@hidden vuoti}, come le parole in una riga stampata.
+Uno spazio vuoto in @command{awk} @`e qualsiasi stringa composta da uno o
address@hidden
+spazi, segni di tabulazione o ritorni a capo;
+altri caratteri, come interruzione di pagina, tabulazione verticale, etc., che
+sono considerati spazi vuoti in altri linguaggi, @emph{non} sono considerati
+tali da @command{awk}.
+
+Lo scopo dei campi @`e quello di rendere address@hidden conveniente per
l'utente far
+riferimento a questi frammenti dei record. Non @`e necessario usarli---si
address@hidden
+operare sull'intero record, se si vuole---ma i campi sono address@hidden che
rende
address@hidden@dotless{i}} potenti dei semplici programmi @command{awk}.
+
address@hidden operatore di campo @code{$}
address@hidden @code{$} (dollaro), operatore di campo @code{$}
address@hidden dollaro (@code{$}), operatore di campo @code{$}
address@hidden operatore di campo, dollaro come
+Si usa il simbolo del dollaro (@samp{$})
+per far riferimento a un campo in un programma @command{awk},
+seguito dal numero del campo desiderato. Quindi, @code{$1}
+si riferisce al primo campo, @code{$2} al secondo, e
address@hidden@dotless{i}} via.
+(Diversamente che nelle shell Unix, i numeri di campo non sono limitati a una
+sola cifra; @code{$127} @`e il centoventisettesimo campo nel record.)
+Per esempio, supponiamo che la seguente sia una riga in input:
+
address@hidden
+Questo pare essere un esempio proprio carino.
address@hidden example
+
address@hidden
+Qui il primo campo, o @code{$1}, @`e @samp{Questo}, il secondo campo, o
address@hidden, @`e @samp{pare}, e via dicendo. Si noti che l'ultimo campo,
address@hidden, @`e @samp{carino.}. Poich@'e non ci sono spazi tra la
address@hidden e il @samp{.}, il punto @`e considerato parte del settimo
+campo.
+
address@hidden @code{NF}, variabile
address@hidden campi, numero dei
address@hidden @`e una variabile predefinita il cui valore @`e il numero di
campi nel
+record corrente. @command{awk} aggiorna automaticamente il valore di
address@hidden ogni volta che legge un record. Indipendentemente da quanti
campi
+ci possano essere, l'ultimo campo in un record address@hidden essere
rappresentato da
address@hidden address@hidden@dotless{i}}, @code{$NF} @`e lo stesso di
@code{$7}, che @`e @samp{carino.}.
+Se si cerca di far riferimento a un campo oltre l'ultimo
+(come @code{$8} quando il record ha solo sette campi), si ottiene
+la stringa nulla. (Se usato in un'operazione numerica si ottiene zero.)
+
+L'uso di @code{$0}, che sarebbe come un riferimento al campo ``numero zero'',
address@hidden un caso particolare: rappresenta l'intero record in input. Si
usa quando
+non si @`e interessati a un campo specifico. Vediamo qualche altro esempio:
+
address@hidden
+$ @kbd{awk '$1 ~ /li/ @{ print $0 @}' mail-list}
address@hidden Amelia 555-5553 amelia.zodiacusque@@gmail.com F
address@hidden Julie 555-6699 julie.perscrutabor@@skeeve.com F
address@hidden example
+
address@hidden
+Questo esempio stampa ogni record del file @file{mail-list} il cui primo campo
+contiene la stringa @samp{li}.
+
+Per converso, il seguente esempio cerca @samp{li} @emph{nell'intero record} e
+stampa il primo e l'ultimo campo di ogni record in input per cui @`e stata
+trovata una corrispondenza:
+
address@hidden
+$ @kbd{awk '/li/ @{ print $1, $NF @}' mail-list}
address@hidden Amelia F
address@hidden Broderick R
address@hidden Julie F
address@hidden Samuel A
address@hidden example
+
address@hidden Campi non costanti
address@hidden Numeri di campo variabili
address@hidden campi, numero dei
address@hidden numeri di campo
+
+Un numero di campo non @`e necessario che sia una costante. Nel linguaggio
address@hidden si address@hidden usare qualsiasi espressione dopo @samp{$} per
far
+riferimento a un campo. Il valore dell'espressione specifica il numero di
+campo. Se il valore @`e una stringa, piuttosto che un numero, viene convertito
+in un numero. Consideriamo questo esempio:
+
address@hidden
+awk '@{ print $NR @}'
address@hidden example
+
address@hidden
+Ricordiamo che @code{NR} @`e il numero dei record letti fino a questo punto:
uno
+nel primo record, due nel secondo, etc. address@hidden@dotless{i}}
quest'esempio stampa il primo
+campo del primo record, il secondo campo del secondo record, e
address@hidden@dotless{i}} via.
+Per il ventesimo record, @`e stampato il campo numero 20; molto probabilmente
il
+record ha meno di 20 campi, address@hidden stampa una riga vuota.
+Questo @`e un altro esempio sull'uso di espressioni come numeri di campo:
+
address@hidden
+awk '@{ print $(2*2) @}' mail-list
address@hidden example
+
address@hidden calcola l'espressione @samp{(2*2)} e usa il suo valore come
+numero del campo da stampare. Qui @samp{*} rappresenta la
+moltiplicazione, quindi l'espressione @samp{2*2} ha il valore quattro. Le
+parentesi vengono usate affinch@'e la moltiplicazione sia eseguita prima
+dell'operazione @samp{$}; sono necessarie ogni volta che c'@`e un operatore
address@hidden un @dfn{operatore binario}, come @samp{*} per la
+moltiplicazione, servono due operandi. La distinzione @`e necessaria poich@'e
address@hidden ha anche operatori unari (un operando) e ternari (tre
+operandi).}
+nell'espressione del numero di campo. Questo esempio, dunque, stampa il
+tipo di relazione (il quarto campo) per ogni riga del file
address@hidden (Tutti gli operatori di @command{awk} sono elencati, in
+ordine decrescente di precedenza, in
address@hidden)
+
+Se il numero di campo calcolato @`e zero, si ottiene l'intero record.
+Quindi, @samp{$(2-2)} ha lo stesso valore di @code{$0}. Numeri di campo
+negativi non sono consentiti; tentare di far riferimento a uno di essi
+normalmente fa terminare il programma. (Lo standard POSIX non chiarisce
+cosa succede quando si fa riferimento a un numero di campo negativo.
address@hidden avvisa di questo e fa terminare il programma. Altre
+implementazioni di @command{awk} possono comportarsi in modo diverso.)
+
+Come accennato in @ref{Campi},
address@hidden memorizza il numero di campi del record corrente nella variabile
+predefinita @code{NF} (@pxref{Variabili predefinite}). Quindi,
+l'espressione @code{$NF} non @`e una address@hidden address@hidden la diretta
+conseguenza della valutazione di @code{NF} e dell'uso di questo valore come
+numero di campo.
+
address@hidden Cambiare i campi
address@hidden Cambiare il contenuto di un campo
+
address@hidden campi, cambiare il contenuto dei
+Il contenuto di un campo, address@hidden@dotless{i}} come @`e visto da
@command{awk}, address@hidden essere
+cambiato all'interno di un programma @command{awk}; questo cambia quello che
address@hidden percepisce come record in input corrente. (Il reale file in
+input non viene toccato; @command{awk} non modifica @emph{mai} il file in
+input).
+Si consideri il seguente esempio e il suo output:
+
address@hidden
+$ @kbd{awk '@{ numero_pacchi = $3 ; $3 = $3 - 10}
+> @kbd{print numero_pacchi, $3 @}' inventory-shipped}
address@hidden 25 15
address@hidden 32 22
address@hidden 24 14
address@hidden
address@hidden example
+
address@hidden
+Il programma per prima cosa salva il valore originale del campo tre nella
+variabile @code{numero_pacchi}.
+Il segno @samp{-} rappresenta la sottrazione, address@hidden@dotless{i}}
questo programma riassegna
+il campo tre, @code{$3}, come il valore originale del campo meno dieci:
address@hidden - 10}. (@xref{Operatori aritmetici}.)
+Poi stampa il valore originale e quello nuovo del campo tre.
+(Qualcuno nel magazzino ha fatto un errore ricorrente nell'inventariare le
+scatole rosse.)
+
+Perch@'e questo funzioni, il testo in @code{$3} deve poter essere riconosciuto
+come un numero; la stringa di caratteri dev'essere convertita in un numero
+affich@'e il computer possa eseguire operazioni aritmetiche su di essa. Il
+numero che risulta dalla sottrazione viene nuovamente convertito in
+una stringa di caratteri che quindi diventa il campo tre.
address@hidden
+
+Quando il valore di un campo @`e cambiato (come percepito da @command{awk}), il
+testo del record in input viene ricalcolato per contenere il nuovo campo al
+posto di quello vecchio. In altre parole, @code{$0} cambia per riflettere il
+campo modificato. Questo programma
+stampa una copia del file in input, con 10 sottratto dal secondo campo di ogni
+riga:
+
address@hidden
+$ @kbd{awk '@{ $2 = $2 - 10; print $0 @}' inventory-shipped}
address@hidden Jan 3 25 15 115
address@hidden Feb 5 32 24 226
address@hidden Mar 5 24 34 228
address@hidden
address@hidden example
+
address@hidden possibile inoltre assegnare contenuti a campi che sono fuori
+intervallo. Per esempio:
+
address@hidden
+$ @kbd{awk '@{ $6 = ($5 + $4 + $3 + $2)}
+> @kbd{ print $6 @}' inventory-shipped}
address@hidden 168
address@hidden 297
address@hidden 301
address@hidden
address@hidden example
+
address@hidden aggiungere, campi
address@hidden campi, aggiungere
address@hidden
+Abbiamo appena creato @code{$6}, il cui valore @`e la somma dei campi
address@hidden, @code{$3}, @code{$4} e @code{$5}. Il segno @samp{+}
+rappresenta l'addizione. Per il file @file{inventory-shipped}, @code{$6}
+rappresenta il numero totale di pacchi spediti in un determinato mese.
+
+La creazione di un nuovo campo cambia la copia interna di @command{awk} nel
+record in input corrente, che @`e il valore di @code{$0}.
address@hidden@dotless{i}}, se si scrive
address@hidden $0} dopo aver aggiunto un campo, il record stampato include il
+nuovo campo, col numero di separatori di campo appropriati tra esso e i
+campi originariamente presenti.
+
address@hidden @code{OFS}, variabile
address@hidden output, separatore di campo, si veda @code{OFS}, variabile
address@hidden campo, separatori di, si veda anche @code{OFS}
address@hidden separatori di campo, si veda anche @code{OFS}
+Questa ridefinizione influenza ed @`e influenzata da
address@hidden (il numero dei campi; @pxref{Campi}).
+Per esempio, il valore di @code{NF} @`e impostato al numero del campo
address@hidden
+elevato che @`e stato creato.
+Il formato preciso di @code{$0} @`e influenzato anche da una address@hidden che
+non @`e ancora stata trattata: il @dfn{separatore di campo di output},
address@hidden, usato per separare i campi (@pxref{Separatori di output}).
+
+Si noti, comunque, che il mero @emph{riferimento} a un campo fuori
+intervallo @emph{non} cambia il valore di @code{$0} o di @code{NF}.
+Far riferimento a un campo fuori intervallo produce solo una stringa nulla.
+Per esempio:
+
address@hidden
+if ($(NF+1) != "")
+ print "non @`e possibile"
+else
+ print "@`e tutto normale"
address@hidden example
+
address@hidden
+dovrebbe stampare @address@hidden tutto normale}, perch@'e @code{NF+1} @`e
certamente
+fuori intervallo. (@xref{Istruzione if}
+per maggiori informazioni sulle istruzioni @code{if-else} di @command{awk}.
address@hidden di variabile e confronti}
+per maggiori informazioni sull'operatore @samp{!=}.)
+
address@hidden importante notare che facendo un assegnamento a un campo
esistente cambia
+il valore di @code{$0} ma non cambia il valore di @code{NF},
+anche qualora si assegni a un campo la stringa nulla. Per esempio:
+
address@hidden
+$ @kbd{echo a b c d | awk '@{ OFS = ":"; $2 = ""}
+> @kbd{print $0; print NF @}'}
address@hidden a::c:d
address@hidden 4
address@hidden example
+
address@hidden
+Il campo @`e ancora address@hidden@dotless{i}}; ha solo un valore vuoto,
delimitato dai due "due punti"
+tra @samp{a} e @samp{c}.
+Questo esempio mostra cosa succede se si crea un nuovo campo:
+
address@hidden
+$ @kbd{echo a b c d | awk '@{ OFS = ":"; $2 = ""; $6 = "nuovo"}
+> @kbd{print $0; print NF @}'}
address@hidden a::c:d::nuovo
address@hidden 6
address@hidden example
+
address@hidden
+Il campo intermedio, @code{$5}, @`e creato con un valore vuoto
+(indicato dalla seconda coppia di due punti adiacenti),
+e @code{NF} @`e aggiornato col valore sei.
+
address@hidden angolo buio, variabile @code{NF}, decremento
address@hidden @code{NF}, variable, decremento
+Decrementando @code{NF} si eliminano i campi
+dopo il nuovo valore di @code{NF} e si ricalcola @code{$0}.
address@hidden
+Vediamo un esempio:
+
address@hidden
+$ @kbd{echo a b c d e f | awk '@{ print "NF =", NF;}
+> @kbd{ NF = 3; print $0 @}'}
address@hidden NF = 6
address@hidden a b c
address@hidden example
+
address@hidden address@hidden, variabile @address@hidden decremento
address@hidden ATTENZIONE
+Alcune versioni di @command{awk} non
+ricostruiscono @code{$0} quando @code{NF} viene diminuito.
address@hidden quotation
+
+Infine, ci sono casi in cui conviene forzare
address@hidden a ricostruire l'intero record, usando i valori correnti
+dei campi e @code{OFS}. Per far address@hidden, si usa
+l'apparentemente innocuo assegnamento:
+
address@hidden
+$1 = $1 # forza la ricostruzione del record
+print $0 # o qualsiasi altra cosa con $0
address@hidden example
+
address@hidden
+Questo forza @command{awk} a ricostruire il record. Aggiungere un commento
+rende tutto address@hidden chiaro, come abbiamo appena visto.
+
+C'@`e un rovescio della medaglia nella relazione tra @code{$0} e
+i campi. Qualsiasi assegnamento a @code{$0} fa address@hidden@dotless{i}} che
il record sia
+rianalizzato (sintatticamente) e ridiviso in campi usando il valore
address@hidden di @code{FS}. Questo si applica anche a qualsiasi funzione
+predefinita che aggiorna @code{$0}, come @code{sub()} e @code{gsub()}
+(@pxref{Funzioni per stringhe}).
+
address@hidden sidebar, Comprendere @code{$0}
address@hidden
address@hidden
+<sidebar><title>Comprendere @code{$0}</title>
address@hidden docbook
+
+
address@hidden importante ricordare che @code{$0} @`e @emph{l'intero}
+record, esattamente com'@`e stato letto dall'input, compresi tutti gli spazi
+vuoti iniziali e finali, e l'esatto spazio vuoto (o altri caratteri) che
+separa i campi.
+
address@hidden un errore comune tentare di cambiare il separatore di campo in
un record
+semplicemente impostando @code{FS} e @code{OFS}, e poi
+aspettarsi che un semplice @samp{print} or @samp{print $0} stampi il record
+modificato.
+
+Questo non funziona, poich@'e non @`e stato fatto niente per cambiare quello
+stesso record. Invece, si deve forzare la ricostruzione del record,
+tipicamente con un'istruzione come @samp{$1 = $1}, come descritto
+in precedenza.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Comprendere @code{$0}}
+
+
+
address@hidden importante ricordare che @code{$0} @`e @emph{l'intero}
+record, esattamente com'@`e stato letto dall'input, compresi tutti gli spazi
+vuoti iniziali e finali, e l'esatto spazio vuoto (o altri caratteri) che
+separa i campi.
+
address@hidden un errore comune tentare di cambiare il separatore di campo in
un record
+semplicemente impostando @code{FS} e @code{OFS}, e poi
+aspettarsi che un semplice @samp{print} or @samp{print $0} stampi il record
+modificato.
+
+Questo non funziona, poich@'e non @`e stato fatto niente per cambiare quello
+stesso record. Invece, si deve forzare la ricostruzione del record,
+tipicamente con un'istruzione come @samp{$1 = $1}, come descritto
+in precedenza.
address@hidden cartouche
address@hidden ifnotdocbook
+
+
address@hidden Separatori di campo
address@hidden Specificare come vengono separati i campi
+
address@hidden
+* Separatori di campo di default:: Come di solito sono separati i campi.
+* Separare campi con @dfn{regexp}:: Usare @dfn{regexp} come separatori.
+* Campi di un solo carattere:: Fare di ogni carattere un campo
+ separato.
+* Separatori campo da riga di comando:: Assegnare @code{FS} dalla riga di
+ comando.
+* Campo intera riga:: Far address@hidden@dotless{i}} che la
riga intera sia un
+ campo solo.
+* Sommario sulla separazione campi:: Alcuni punti finali e una tavola di
+ sommario.
address@hidden menu
+
address@hidden @code{FS}, variabile
address@hidden campi, separare
address@hidden campo, separatori di
+Il @dfn{separatore di campo}, che @`e un carattere singolo o un'espressione
+regolare, controlla il modo in cui @command{awk} suddivide un record in input
+in campi. @command{awk} fa una scansione del record in input per trovare i
+caratteri che individuano il separatore; i campi sono il testo compreso tra i
+separatori trovati.
+
+Nell'esempio che segue, usiamo il simbolo del punto elenco (@bullet{}) per
+rappresentare gli spazi nell'output.
+Se il separatore di campo @`e @samp{oo}, la seguente riga:
+
address@hidden
+moo goo gai pan
address@hidden example
+
address@hidden
address@hidden suddivisa in tre campi: @samp{m}, @address@hidden, e
address@hidden@address@hidden
+Notare gli spazi iniziali nei valori del secondo e del terzo campo.
+
address@hidden risoluzione di problemi, @command{awk} usa @code{FS} anzich@'e
@code{IFS}
address@hidden problemi, risoluzione di, @command{awk} usa @code{FS} anzich@'e
@code{IFS}
+Il separatore di campo @`e rappresentato dalla variable predefinita @code{FS}.
+I programmatori di shell notino: @command{awk} @emph{non} usa il
+nome @code{IFS} che @`e usato dalle shell conformi a POSIX (come
+la Unix Bourne shell, @command{sh}, o Bash).
+
address@hidden @code{FS}, variabile, cambiare il valore di una
+Il valore di @code{FS} si address@hidden cambiare nel programma @command{awk}
con
+l'operatore di assegnamento, @samp{=} (@pxref{Operatori di assegnamento}).
+Spesso il momento giusto per far address@hidden @`e all'inizio dell'esecuzione
+prima che sia stato elaborato qualsiasi input, address@hidden@dotless{i}} che
il primo record
+sia letto col separatore appropriato. Per far questo, si usa il modello di
+ricerca speciale
address@hidden
+(@pxref{BEGIN/END}).
+Per esempio, qui impostiamo il valore di @code{FS} alla stringa
address@hidden","}:
+
address@hidden
+awk 'BEGIN @{ FS = "," @} ; @{ print $2 @}'
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca
address@hidden
+Data la riga in input:
+
address@hidden
+John Q. Smith, 29 Oak St., Walamazoo, MI 42139
address@hidden example
+
address@hidden
+questo programma @command{awk} estrae e stampa la stringa
address@hidden@address@hidden@bullet{}St.}.
+
address@hidden separatori di campo, scelta dei
address@hidden espressioni regolari come separatori di campo
address@hidden separatori di campo, espressioni regolari come
+A volte i dati in input contengono caratteri separatori che non
+separano i campi nel modo in cui ci si sarebbe atteso. Per esempio, il
+nome della persona dell'esempio che abbiamo appena usato potrebbe avere un
+titolo o un suffisso annesso, come:
+
address@hidden
+John Q. Smith, LXIX, 29 Oak St., Walamazoo, MI 42139
address@hidden example
+
address@hidden
+Lo stesso programma estrarrebbe @address@hidden invece di
address@hidden@address@hidden@bullet{}St.}.
+Se ci si aspetta che il programma stampi l'indirizzo,
+si address@hidden sorpresi. La morale @`e quella di scegliere la struttura
dei dati
+e i caratteri di separazione attentamente per evitare questi problemi.
+(Se i dati non sono in una forma facile da elaborare, address@hidden darsi che
+si possano manipolare con un programma @command{awk} separato.)
+
+
address@hidden Separatori di campo di default
address@hidden Lo spazio vuoto normalmente separa i campi
+
address@hidden spazi vuoti, come separatori di campo
+I campi sono separati normalmente da spazi vuoti
+(spazi, tabulazioni e ritorni a capo), non solo da spazi singoli. Due spazi
+in una riga non delimitano un campo vuoto. Il valore di default del separatore
+di campo @code{FS} @`e una stringa contenente un singolo spazio,
@address@hidden" "}}.
+Se @command{awk} interpretasse questo valore nel modo usuale, ogni carattere
+di spazio separerebbe campi, quindi due spazi in una riga creerebbero un campo
+vuoto tra di essi. Il motivo per cui questo non succede @`e perch@'e un
singolo
+spazio come valore di @code{FS} @`e un caso particolare: @`e preso per
specificare
+il modo di default di delimitare i campi.
+
+Se @code{FS} @`e qualsiasi altro carattere singolo, come @code{","}, ogni
+ricorrenza di quel carattere separa due campi. Due ricorrenze consecutive
+delimitano un campo vuoto. Se il carattere si trova all'inizio o alla fine
+della riga, anche quello delimita un campo vuoto. Il carattere di spazio @`e
+il solo carattere singolo che non segue queste
+regole.
+
address@hidden Separare campi con @dfn{regexp}
address@hidden Usare @dfn{regexp} come separatori di campo
+
address@hidden espressioni regolari, come separatori di campo
address@hidden separatori di campo, espressioni regolari come
+La precedente @value{SUBSECTION}
+ha illustrato l'uso di caratteri singoli o di stringhe semplici come
+valore di @code{FS}.
address@hidden in generale, il valore di @code{FS} address@hidden essere una
stringa contenente
+qualsiasi espressione regolare. Se questo @`e il caso, ogni corrispondenza nel
+record con l'espressione regolare separa campi. Per esempio, l'assegnamento:
+
address@hidden
+FS = ", \t"
address@hidden example
+
address@hidden
+trasforma ogni parte di una riga in input che consiste di una virgola seguita
+da uno spazio e una tabulazione in un separatore di campo.
address@hidden
+(@samp{\t}
address@hidden una @dfn{sequenza di protezione} che sta per un segno di
tabulazione;
address@hidden di protezione},
+per l'elenco completo di sequenze di protezione simili.)
address@hidden ifinfo
+
+Per un esempio meno banale di espressione regolare, si provi a usare spazi
+singoli per separare campi nel modo in cui sono usate le virgole. @code{FS}
address@hidden essere impostato a @address@hidden"[@ ]"}} (parentesi quadra
sinistra, spazio,
+parentesi quadra destra). Quest'espressione regolare corrisponde a uno spazio
address@hidden
+singolo e niente address@hidden (@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+singolo e niente address@hidden (@pxref{Espressioni regolari}).
address@hidden ifnottex
+C'@`e una differenza importante tra i due casi di @samp{FS = @w{" "}}
+(uno spazio singolo) e @samp{FS = @w{"[ \t\n]+"}}
+(un'espressione regolare che individua uno o address@hidden spazi, tabulazioni
o
+ritorni a capo). Per entrambi i valori di @code{FS}, i campi sono
+separati da @dfn{serie} (ricorrenze adiacenti multiple) di spazi, tabulazioni
+e/o ritorni a capo. Comunque, quando il valore di @code{FS} @`e
address@hidden@code{" "}}, @command{awk} prima toglie lo spazio vuoto iniziale
e finale
+dal record e poi stabilisce dove sono i campi.
+Per esempio, la seguente @dfn{pipeline} stampa @samp{b}:
+
address@hidden
+$ @kbd{echo ' a b c d ' | awk '@{ print $2 @}'}
address@hidden b
address@hidden example
+
address@hidden
+Invece la @dfn{pipeline} che segue stampa @samp{a} (notare lo spazio extra
+intorno a ogni lettera):
+
address@hidden
+$ @kbd{echo ' a b c d ' | awk 'BEGIN @{ FS = "[ \t\n]+" @}}
+> @address@hidden print $2 @}'}
address@hidden a
address@hidden example
+
address@hidden
address@hidden @cindex null strings
address@hidden stringhe nulle
address@hidden stringhe vuote, si veda stringhe nulle
+In questo caso, il primo campo @`e nullo, o vuoto.
+Il taglio degli spazi vuoti iniziale e finale ha luogo anche
+ogniqualvolta @code{$0} @`e ricalcolato.
+Per esempio, si consideri questa @dfn{pipeline}:
+
address@hidden
+$ @kbd{echo ' a b c d' | awk '@{ print; $2 = $2; print @}'}
address@hidden a b c d
address@hidden a b c d
address@hidden example
+
address@hidden
+La prima istruzione @code{print} stampa il record address@hidden@dotless{i}}
come @`e stato letto,
+con lo spazio vuoto intatto. L'assegnamento a @code{$2} ricostruisce
address@hidden concatenando insieme @code{$1} fino a @code{$NF},
+separati dal valore di @code{OFS} (che @`e uno spazio per default).
+Poich@'e lo spazio vuoto iniziale @`e stato ignorato quando si @`e trovato
address@hidden, esso non fa parte del nuovo @code{$0}. Alla fine, l'ultima
+istruzione @code{print} stampa il nuovo @code{$0}.
+
address@hidden @code{FS}, contenente @code{^}
address@hidden @code{^} (circonflesso), in @code{FS}
address@hidden angolo buio, @code{^}, in @code{FS}
+C'@`e un'ulteriore sottigliezza da considerare quando si usano le espressioni
+regolari per separare i campi.
+Non @`e ben specificato nello standard POSIX, n@'e altrove, cosa
+significhi @samp{^} nella divisione dei campi. Il @samp{^} cerca
+corrispondenze solo all'inizio dell'intero record? Oppure ogni separatore di
+campo @`e una nuova stringa? Di fatto versioni differenti di @command{awk}
+rispondono a questo quesito in modo diverso, e non si dovrebbe far affidamento
+su alcun comportamento specifico nei propri programmi.
address@hidden
+
address@hidden Brian Kernighan, @command{awk} di
+Di sicuro, BWK @command{awk} individua con @samp{^}
+solo l'inizio del record. Anche @command{gawk}
+funziona in questo modo. Per esempio:
+
address@hidden
+$ @kbd{echo 'xxAA xxBxx C' |}
+> @kbd{gawk -F '(^x+)|( +)' '@{ for (i = 1; i <= NF; i++)}
+> @kbd{ printf "-->%s<--\n", $i @}'}
address@hidden --><--
address@hidden -->AA<--
address@hidden -->xxBxx<--
address@hidden -->C<--
address@hidden example
+
address@hidden Campi di un solo carattere
address@hidden Fare di ogni carattere un campo separato
+
address@hidden estensioni comuni, campi di un solo carattere
address@hidden comuni, estensioni, campi di un solo carattere
address@hidden differenze tra @command{awk} e @command{gawk}, campi di un solo
carattere
address@hidden singolo carattere, campi
address@hidden campi di un solo carattere
+Ci sono casi in cui si abbia la address@hidden di analizzare ciascun carattere
di un
+record separatamente. Questo si address@hidden fare in @command{gawk}
semplicemente
+assegnando la stringa nulla (@code{""}) a @code{FS}. @value{COMMONEXT}
+In questo caso,
+ogni singolo carattere nel record diventa un campo separato.
+Per esempio:
+
address@hidden
+$ @kbd{echo a b | gawk 'BEGIN @{ FS = "" @}}
+> @address@hidden
+> @kbd{for (i = 1; i <= NF; i = i + 1)}
+> @kbd{print "Il campo", i, "@`e", $i}
+> @address@hidden'}
address@hidden Il campo 1 @`e a
address@hidden Il campo 2 @`e
address@hidden Il campo 3 @`e b
address@hidden example
+
address@hidden angolo buio, @code{FS} come stringa nulla
address@hidden @code{FS}, variabile, come stringa nulla
+Tradizionalmente, il comportamento di @code{FS} quando @`e impostato a
address@hidden""} non @`e stato definito. In questo caso, la maggior parte
delle
+versioni UNIX di @command{awk} trattano l'intero record come se avesse un
+unico campo.
address@hidden
+In address@hidden di address@hidden
+(@pxref{Opzioni}),
+se @code{FS} @`e la stringa nulla, anche @command{gawk}
+si comporta in questo modo.
+
address@hidden Separatori campo da riga di comando
address@hidden Impostare @code{FS} dalla riga di comando
address@hidden @option{-F}, opzione sulla riga di comando
address@hidden separatore di campo, specificare sulla riga di comando
address@hidden riga di comando, impostare @code{FS} sulla
address@hidden @code{FS}, variabile, impostare da riga di comando
+
address@hidden address@hidden essere impostata sulla riga di comando. Per far
questo si usa
+l'opzione @option{-F}. Per esempio:
+
address@hidden
+awk -F, '@var{programma}' @var{i-file-di-input}
address@hidden example
+
address@hidden
+imposta @code{FS} al carattere @samp{,}. Si noti che l'opzione richiede
+un carattere maiuscolo @samp{F} anzich@'e minuscolo @samp{f}. Quest'ultima
+opzione (@option{-f}) serve a specificare il file contenente un programma
address@hidden
+
+Il valore usato per l'argomento di @option{-F} @`e elaborato esattamente nello
+stesso modo degli assegnamenti alla variabile predefinita @code{FS}. Qualsiasi
+carattere speciale nel separatore di campo dev'essere protetto in modo
+appropriato. Per esempio, per usare un @samp{\} come separatore di campo
+sulla riga di comando, si dovrebbe battere:
+
address@hidden
+# equivale a FS = "\\"
+awk -F\\\\ '@dots{}' file @dots{}
address@hidden example
+
address@hidden
address@hidden @code{\} (barra inversa), come separatore di campo
address@hidden barra inversa (@code{\}), come separatore di campo
+Poich@'e @samp{\} @`e usato nella shell per proteggere caratteri, a
@command{awk}
+arriva @samp{-F\\}. Quindi @command{awk} elabora @samp{\\} per caratteri di
+protezione (@pxref{Sequenze di protezione}), producendo alla fine
+un unico @samp{\} da usare come separatore di campo.
+
address@hidden @cindex historical features
+Come caso particolare, in address@hidden di address@hidden
+(@pxref{Opzioni}),
+se l'argomento di @option{-F} @`e @samp{t}, @code{FS} @`e impostato al
+carattere di tabulazione. Se si immette @samp{-F\t} nella
+shell, senza che sia tra apici, @samp{\} viene cancellata,
address@hidden@dotless{i}} @command{awk}
+conclude che si vuole realmente che i campi siano separati da tabulazioni e
+non da delle @samp{t}. Si usi @samp{-v FS="t"} o @samp{-F"[t]"} sulla riga di
+comando se si vuole separare i campi con delle @samp{t}.
+Quando non si @`e in address@hidden di address@hidden si deve usare @samp{-F
'\t'} per
+specificare che le tabulazioni separano i campi.
+
+Come esempio, usiamo un file di programma @command{awk} chiamato
address@hidden che contiene il criterio di ricerca @code{/edu/} e l'azione
address@hidden $1}:
+
address@hidden
+/edu/ @{ print $1 @}
address@hidden example
+
+Impostiamo inoltre @code{FS} al carattere @samp{-} ed eseguiamo il programma
+sul file @file{mail-list}. Il seguente comando stampa un elenco dei nomi
+delle persone che lavorano all'address@hidden o che la frequentano, e le prime
tre
+cifre dei loro numeri di telefono:
+
address@hidden
+$ @kbd{awk -F- -f edu.awk mail-list}
address@hidden Fabius 555
address@hidden Samuel 555
address@hidden Jean
address@hidden example
+
address@hidden
+Si noti la terza riga di output. La terza riga
+nel file originale @`e simile a questa:
+
address@hidden
+Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden example
+
+Il @samp{-} che fa parte del nome della persona @`e stato usato come
+separatore di campo, al posto del @samp{-} presente nel numero di telefono,
+che ci si aspettava venisse usato.
+Questo lascia intuire il motivo per cui si deve stare attenti nella scelta
+dei separatori di campo e di record.
+
address@hidden Unix @command{awk}, file di password, separatori di campo e
+Forse l'uso address@hidden comune di un solo carattere come separatore di
campo avviene
+quando si elabora il file delle password di un sistema Unix. Su molti sistemi
+Unix, ogni utente @`e descritto da un elemento nel file delle password del
+sistema, che contiene una riga singola per ogni utente. In queste righe le
+informazioni sono separate da dei caratteri ":". Il
+primo campo @`e il nome di login dell'utente e il secondo @`e la password
+dell'utente criptata o oscurata (una password oscurata @`e indicata dalla
+presenza di una sola @samp{x} nel secondo campo). Una riga nel file delle
+password potrebbe essere simile a questa:
+
address@hidden Robbins, Arnold
address@hidden
+arnold:x:2076:10:Arnold Robbins:/home/arnold:/bin/bash
address@hidden example
+
+Il seguente programma esamina il file delle password di sistema e stampa le
+voci relative agli utenti il cui nome completo non @`e presente nel file:
+
address@hidden
+awk -F: '$5 == ""' /etc/passwd
address@hidden example
+
address@hidden Campo intera riga
address@hidden Fare di una riga intera un campo solo
+
+Occasionalmente, @`e utile trattare l'intera riga in input come un solo campo.
+Questo si address@hidden fare facilmente e in modo portabile semplicemente
impostando
address@hidden a @code{"\n"} (un ritorno a capo)address@hidden ad
+Andrew Schorr per questo suggerimento.}
+
address@hidden
+awk -F'\n' '@var{programma}' @var{file @dots{}}
address@hidden example
+
address@hidden
+In questo caso, @code{$1} coincide con @code{$0}.
+
+
address@hidden sidebar, Cambiare @code{FS} non incide sui campi
address@hidden
address@hidden
+<sidebar><title>Cambiare @code{FS} non incide sui campi</title>
address@hidden docbook
+
+
address@hidden POSIX @command{awk}, separatori di campo e
address@hidden separatore di campo, POSIX e il
+Secondo lo standard POSIX, si suppone che @command{awk} si comporti
+come se ogni record sia stato diviso in campi nel momento in cui @`e stato
+letto. In particolare, address@hidden vuol dire che se si cambia il valore di
address@hidden dopo che un record @`e stato letto, il valore dei campi (cio@'e
+la loro suddivisione) address@hidden ancora quello ottenuto usando il
precedente
+valore di @code{FS}, non quello nuovo.
+
address@hidden angolo buio, separatori di campo
address@hidden @command{sed}, programma di address@hidden
address@hidden programma di address@hidden @command{sed}
address@hidden editori di flusso
+Comunque, molte delle address@hidden vecchie implementazioni di @command{awk}
non
+funzionano in questo modo. Invece, rimandano la divisione dei campi
+fino a quando si fa effettivamente riferimento a un campo. I campi sono
+divisi usando il valore @emph{corrente} di @code{FS}!
address@hidden
+Questo comportamento address@hidden essere di difficile
+identificazione. Il seguente esempio illustra la differenza
+tra i due metodi. Lo script
+
address@hidden
+sed 1q /etc/passwd | awk '@{ FS = ":" ; print $1 @}'
address@hidden example
+
address@hidden
+normalmente stampa:
+
address@hidden
address@hidden root
address@hidden example
+
address@hidden
+su un'implementazione non standard di @command{awk}, mentre @command{gawk}
+stampa l'intera prima riga del file, qualcosa come:
+
address@hidden
+root:x:0:0:Root:/:
address@hidden example
+
+(Il comando @address@hidden programma di address@hidden @command{sed} @`e un
+``editore di flusso''. Anche il suo comportamento @`e definito dallo standard
+POSIX.} appena visto stampa solo la prima riga di @file{/etc/passwd}.)
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Cambiare @code{FS} non incide sui campi}
+
+
+
address@hidden POSIX @command{awk}, separatori di campo e
address@hidden separatore di campo, POSIX e il
+Secondo lo standard POSIX, si suppone che @command{awk} si comporti
+come se ogni record sia stato diviso in campi nel momento in cui @`e stato
+letto. In particolare, address@hidden vuol dire che se si cambia il valore di
address@hidden dopo che un record @`e stato letto, il valore dei campi (cio@'e
+la loro suddivisione) address@hidden ancora quello ottenuto usando il
precedente
+valore di @code{FS}, non quello nuovo.
+
address@hidden angolo buio, separatori di campo
address@hidden @command{sed}, programma di address@hidden
address@hidden programma di address@hidden @command{sed}
address@hidden editori di flusso
+Comunque, molte delle address@hidden vecchie implementazioni di @command{awk}
non
+funzionano in questo modo. Invece, rimandano la divisione dei campi
+fino a quando si fa effettivamente riferimento a un campo. I campi sono
+divisi usando il valore @emph{corrente} di @code{FS}!
address@hidden
+Questo comportamento address@hidden essere di difficile
+identificazione. Il seguente esempio illustra la differenza
+tra i due metodi. Lo script
+
address@hidden
+sed 1q /etc/passwd | awk '@{ FS = ":" ; print $1 @}'
address@hidden example
+
address@hidden
+normalmente stampa:
+
address@hidden
address@hidden root
address@hidden example
+
address@hidden
+su un'implementazione non standard di @command{awk}, mentre @command{gawk}
+stampa l'intera prima riga del file, qualcosa come:
+
address@hidden
+root:x:0:0:Root:/:
address@hidden example
+
+(Il comando @address@hidden programma di address@hidden @command{sed} @`e un
+``editore di flusso''. Anche il suo comportamento @`e definito dallo standard
+POSIX.} appena visto stampa solo la prima riga di @file{/etc/passwd}.)
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Sommario sulla separazione campi
address@hidden Sommario sulla separazione dei campi
+
address@hidden importante ricordare che quando si assegna una costante stringa
+come valore di @code{FS}, questa subisce una normale elaborazione di stringa
+da parte di @command{awk}. Per esempio, con Unix @command{awk} e
address@hidden, l'assegnamento @samp{FS = "\.."} assegna la stringa di
+caratteri @code{".."}
+a @code{FS} (la barra inversa @`e tolta). Questo crea un'espressione regolare
+che significa ``i campi sono separati da ricorrenze di due caratteri
+qualsiasi''. Se invece si vuole che i campi siano separati da un punto
+seguito da un qualsiasi carattere singolo, si deve usare @samp{FS = "\\.."}.
+
+Il seguente elenco riassume come i campi vengono divisi, in base al valore
+di @code{FS} (@samp{==} significa address@hidden uguale a''):
+
address@hidden @code
address@hidden FS == " "
+I campi sono separati da serie di spazi vuoti. Gli spazi vuoti iniziale e
+finale sono ignorati. Questo @`e il comportamento di default.
+
address@hidden FS == @var{qualsiasi altro carattere singolo}
+I campi sono separati da ogni ricorrenza del carattere. Ricorrenze
+successive multiple delimitano campi vuoti, e lo stesso fanno le ricorrenze
+iniziali e finali del carattere.
+Il carattere address@hidden essere anche un metacarattere di espressione
regolare, che
+non @`e necessario proteggere.
+
address@hidden FS == @var{espressione regolare}
+I campi sono separati da ricorrenze di caratteri che corrispondono alla
address@hidden regolare}. Corrispondenze iniziali e finali della
address@hidden delimitano campi vuoti.
address@hidden FS == ""
+Ogni sinngolo carattere nel record diventa un campo separato.
+(Questa @`e un'estensione comune; non @`e specificata dallo standard POSIX.)
address@hidden table
+
address@hidden sidebar, @code{FS} e @code{IGNORECASE}
address@hidden
address@hidden
+<sidebar><title>@code{FS} e @code{IGNORECASE}</title>
address@hidden docbook
+
+La variabile @code{IGNORECASE}
+(@pxref{Variabili modificabili dall'utente})
+influisce sulla divisione del campo @emph{solo} quando il valore di @code{FS}
address@hidden un'espressione regolare. Non ha nessun effetto quando @code{FS}
@`e un
+singolo carattere, anche se quel carattere @`e una lettera. Quindi, nel
+seguente codice:
+
address@hidden
+FS = "c"
+IGNORECASE = 1
+$0 = "aCa"
+print $1
address@hidden example
+
address@hidden
+L'output @`e @samp{aCa}. Se si vuol veramente dividere i campi su un carattere
+alfabetico ignorandone il maiuscolo/minuscolo, si deve usare un'espressione
+regolare che lo address@hidden in automatico (p.es., @samp{FS = "[c]"}). In
questo
+caso, @code{IGNORECASE} address@hidden effetto.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @address@hidden e @code{IGNORECASE}}
+
+
+La variabile @code{IGNORECASE}
+(@pxref{Variabili modificabili dall'utente})
+influisce sulla divisione del campo @emph{solo} quando il valore di @code{FS}
address@hidden un'espressione regolare. Non ha nessun effetto quando @code{FS}
@`e un
+singolo carattere, anche se quel carattere @`e una lettera. Quindi, nel
+seguente codice:
+
address@hidden
+FS = "c"
+IGNORECASE = 1
+$0 = "aCa"
+print $1
address@hidden example
+
address@hidden
+L'output @`e @samp{aCa}. Se si vuol veramente dividere i campi su un carattere
+alfabetico ignorandone il maiuscolo/minuscolo, si deve usare un'espressione
+regolare che lo address@hidden in automatico (p.es., @samp{FS = "[c]"}). In
questo
+caso, @code{IGNORECASE} address@hidden effetto.
address@hidden cartouche
address@hidden ifnotdocbook
+
+
address@hidden Dimensione costante
address@hidden Leggere campi di larghezza costante
+
+
address@hidden campi di larghezza costante
address@hidden larghezza costante, campi di
address@hidden address@hidden avanzate, campi di larghezza costante
address@hidden O'Reilly doesn't like it as a note the first thing in the
section.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta una address@hidden avanzata
+di @command{gawk}. Se si @`e un utente alle prime armi di @command{awk},
+la si address@hidden saltare in prima lettura.
+
address@hidden fornisce una address@hidden per il trattamento di campi
+a larghezza fissa senza un separatore di campo distintivo. Per esempio,
+dati di questo tipo si trovano nell'input per vecchi programmi Fortran dove
+dei numeri sono elencati uno dopo l'altro, o nell'output di programmi che
+non prevedono che il loro output sia dato in input ad altri programmi.
+
+Un esempio di quest'ultimo caso @`e una tabella dove tutte le colonne sono
+allineate usando un numero variabile di spazi e dove @emph{i campi vuoti
+sono solo spazi}. Chiaramente, la normale divisione in campi di
address@hidden basata su @code{FS} non funziona bene in questa situazione.
+Sebbene un programma @command{awk}
+portabile possa usare una serie di chiamate @code{substr()} su @code{$0}
+(@pxref{Funzioni per stringhe}),
+questo @`e scomodo e inefficiente se il numero dei campi @`e elevato.
+
address@hidden risoluzione di problemi, errori fatali, specificare larghezza
dei campi
address@hidden problemi, risoluzione di, errori fatali, specificare larghezza
dei campi
address@hidden @command{w}, programma di address@hidden
address@hidden programma di address@hidden @command{w}
address@hidden @code{FIELDWIDTHS}, variabile
address@hidden @command{gawk}, variabile @code{FIELDWIDTHS} in
+La suddivisione di un record in input in campi a larghezza fissa viene
+specificata assegnando una stringa contenente numeri separati da spazi alla
+variabile predefinita @code{FIELDWIDTHS}. Ogni numero specifica la larghezza
+del campo, @emph{comprese} le colonne tra i campi. Se si vogliono ignorare le
+colonne tra i campi si address@hidden specificare la loro larghezza come un
campo
+separato che address@hidden poi ignorato.
address@hidden un errore fatale definire una larghezza di campo che abbia un
valore
+negativo. I dati seguenti costituiscono l'output del programma di
address@hidden
+Unix @command{w}. @`E utile per spiegare l'uso di @code{FIELDWIDTHS}:
+
address@hidden
address@hidden
+ 10:06pm up 21 days, 14:04, 23 users
+User tty login@ idle JCPU PCPU what
+hzuo ttyV0 8:58pm 9 5 vi p24.tex
+hzang ttyV3 6:37pm 50 -csh
+eklye ttyV5 9:53pm 7 1 em thes.tex
+dportein ttyV6 8:17pm 1:47 -csh
+gierd ttyD3 10:00pm 1 elm
+dave ttyD4 9:47pm 4 4 w
+brent ttyp0 26Jun91 4:46 26:46 4:41 bash
+dave ttyq4 26Jun9115days 46 46 wnewmail
address@hidden group
address@hidden example
+
+Il seguente programma prende l'input sopra mostrato, converte il tempo di
address@hidden
+in numero di secondi, e stampa i primi due campi e il tempo di address@hidden
+calcolato:
+
address@hidden
+BEGIN @{ FIELDWIDTHS = "9 6 10 6 7 7 35" @}
+NR > 2 @{
+ inat = $4
+ sub(/^ +/, "", inat) # togli spazi prima del valore
+ if (inat == "")
+ inat = 0
+ if (inat ~ /:/) @{
+ split(inat, t, ":")
+ inat = t[1] * 60 + t[2]
+ @}
+ if (inat ~ /days/)
+ inat *= 24 * 60 * 60
+
+ print $1, $2, inat
address@hidden
address@hidden example
+
address@hidden NOTA
+Questo programma usa diverse address@hidden di @command{awk} non
+ancora trattate.
address@hidden quotation
+
+L'esecuzione del programma sui dati produce il seguente risultato:
+
address@hidden
+hzuo ttyV0 0
+hzang ttyV3 50
+eklye ttyV5 0
+dportein ttyV6 107
+gierd ttyD3 1
+dave ttyD4 0
+brent ttyp0 286
+dave ttyq4 1296000
address@hidden example
+
+Un altro esempio (forse address@hidden pratico) di dati di input con larghezza
costante @`e
+l'input da un mazzo di schede elettorali. In alcune parti degli Stati Uniti,
+i votanti marcano le loro scelte perforando delle schede elettroniche.
+
+Queste schede vengono poi elaborate per contare i voti espressi per ogni
+singolo candidato o su ogni determinato quesito. Siccome un votante
address@hidden
+scegliere di non votare su alcune questioni, qualsiasi colonna della scheda
address@hidden essere vuota. Un programma @command{awk} per elaborare tali
dati potrebbe
+usare la address@hidden @code{FIELDWIDTHS} per semplificare la lettura dei
dati.
+(Naturalmente, riuscire a eseguire @command{gawk} su un sistema con lettori di
+schede @`e un'altra storia!)
+
address@hidden @command{gawk}, separazione in campi e
+L'assegnazione di un valore a @code{FS} fa address@hidden@dotless{i}} che
@command{gawk} usi @code{FS}
+per separare nuovamente i campi. Si address@hidden usare @samp{FS = FS} per
ottenere
+questo effetto, senza dover conoscere il valore corrente di @code{FS}.
+Per vedere quale tipo di separazione sia in atto,
+si address@hidden usare @code{PROCINFO["FS"]}
+(@pxref{Variabili auto-assegnate}).
+Il suo valore @`e @code{"FS"} se si usa la normale separazione in campi,
+o @code{"FIELDWIDTHS"} se si usa la separazione in campi a larghezza fissa:
+
address@hidden
+if (PROCINFO["FS"] == "FS")
+ @var{separazione in campi address@hidden
+else if (PROCINFO["FS"] == "FIELDWIDTHS")
+ @var{separazione in campi a larghezza address@hidden
+else
+ @var{separazione dei campi in base al address@hidden @ii{(si veda
address@hidden
+la @value{SECTION} successiva)}
address@hidden ifnotinfo
address@hidden
+il @value{SECTION} successivo)}
address@hidden ifinfo
address@hidden example
+
+Quest'informazione @`e utile quando si scrive una funzione che
+necessita di cambiare temporaneamente @code{FS} o @code{FIELDWIDTHS},
+leggere alcuni record, e poi ripristinare le impostazioni originali
+(@pxref{Funzioni Passwd},
+per un esempio di tale funzione).
+
address@hidden Separazione in base al contenuto
address@hidden Definire i campi in base al contenuto
+
address@hidden O'Reilly doesn't like it as a note the first thing in the
section.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta una address@hidden avanzata
+di @command{gawk}. Se si @`e un utente alle prime armi di @command{awk},
+la si address@hidden saltare in prima lettura.
+
address@hidden address@hidden avanzate, specificare il contenuto dei campi
+Normalmente, quando si usa @code{FS}, @command{gawk} definisce i campi come
+le parti del record che si trovano tra due separatori di campo. In altre
+parole, @code{FS} definisce cosa un campo @emph{non @`e}, invece di cosa
address@hidden@`e}.
+Tuttavia, ci sono casi in cui effettivamente si ha bisogno di definire i campi
+in base a cosa essi sono, e non in base a cosa non sono.
+
+Il caso address@hidden emblematico @`e quello dei dati cosiddetti
@dfn{comma-separated
+value} (CSV). Molti fogli elettronici, per esempio, possono esportare i dati
+in file di testo, dove ogni record termina con un ritorno a capo e i campi
+sono separati tra loro da virgole. Se le virgole facessero solo da separatore
+fra i dati non ci sarebbero problemi. Il problema sorge se uno dei campi
+contiene una virgola @emph{al suo interno}.
+In queste situazioni, la maggioranza dei programmi include il campo fra
+doppi address@hidden formato CSV non ha avuto, per molti anni, una
+definizione standard formale.
address@hidden://www.ietf.org/rfc/rfc4180.txt, RFC 4180}
+standardizza le pratiche address@hidden comuni.}
address@hidden@dotless{i}}, potremmo avere dei dati di questo tipo:
+
address@hidden
address@hidden file eg/misc/addresses.csv
+Robbins,Arnold,"1234 A Pretty Street, NE",MyTown,MyState,12345-6789,USA
address@hidden endfile
address@hidden example
+
address@hidden @command{gawk}, variabile @code{FPAT} in
address@hidden @code{FPAT}, variabile
+La variabile @code{FPAT} offre una soluzione per casi come questo.
+Il valore di @code{FPAT} dovrebbe essere una stringa formata da un'espressione
+regolare. L'espressione regolare descrive il contenuto di ciascun campo.
+
+Nel caso dei dati CSV visti prima, ogni campo @`e ``qualsiasi cosa che non
+sia una virgola,'' oppure ``doppi apici, seguiti da qualsiasi cosa che non
+siano doppi apici, e doppi apici di chiusura''. Se fosse scritta come una
+costante @dfn{regexp}
address@hidden
+(@pxrefil{Espressioni regolari}),
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}),
address@hidden ifnottex
+sarebbe @code{/([^,]+)|("[^"]+")/}.
+Dovendola scrivere come stringa si devono proteggere i doppi apici,
+e quindi si deve scrivere:
+
address@hidden
+FPAT = "([^,]+)|(\"[^\"]+\")"
address@hidden example
+
+Come esempio pratico, si address@hidden vedere questo semplice programma che
analizza
+e divide i dati:
+
address@hidden
address@hidden file eg/misc/simple-csv.awk
+BEGIN @{
+ FPAT = "([^,]+)|(\"[^\"]+\")"
address@hidden
+
address@hidden
+ print "NF = ", NF
+ for (i = 1; i <= NF; i++) @{
+ printf("$%d = <%s>\n", i, $i)
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Eseguendolo, avendo in input la riga vista sopra, si ottiene:
+
address@hidden
+$ @kbd{gawk -f simple-csv.awk addresses.csv}
+NF = 7
+$1 = <Robbins>
+$2 = <Arnold>
+$3 = <"1234 A Pretty Street, NE">
+$4 = <MyTown>
+$5 = <MyState>
+$6 = <12345-6789>
+$7 = <USA>
address@hidden example
+
+Si noti la virgola contenuta nel valore del campo @code{$3}.
+
+Un semplice miglioramento se si elaborano dati CSV di questo tipo potrebbe
+essere quello di rimuovere i doppi apici, se presenti, con del codice di
+questo tipo:
+
address@hidden
+if (substr($i, 1, 1) == "\"") @{
+ len = length($i)
+ $i = substr($i, 2, len - 2) # Ottiene il testo tra doppi apici
address@hidden
address@hidden example
+
+Come per @code{FS}, la variabile @code{IGNORECASE}
+(@pxref{Variabili modificabili dall'utente}) ha effetto sulla separazione dei
+campi con @code{FPAT}.
+
+Se si assegna un valore a @code{FPAT} la divisione in campi non viene
+effettuata utilizzando @code{FS} o @code{FIELDWIDTHS}.
+Analogamente a @code{FIELDWIDTHS}, il valore di @code{PROCINFO["FS"]}
address@hidden @code{"FPAT"} se @`e in uso la suddivisione in campi in base al
contenuto.
+
address@hidden NOTA
+Alcuni programmi esportano dei dati CSV che contengono dei ritorni a capo al
+loro interno in campi rinchiusi tra doppi apici. @command{gawk} non @`e in
+grado di trattare questi dati. Malgrado esista una specifica ufficiale
+per i dati CSV, non c'@`e molto da fare; il meccanismo di @code{FPAT} fornisce
+una soluzione elegante per la maggioranza dei casi, e per gli sviluppatori di
address@hidden address@hidden address@hidden bastare.
address@hidden quotation
+
+Come visto, l'espressione regolare usata per @code{FPAT} richiede
+che ogni campo contenga almeno un carattere. Una semplice modifica
+(cambiare il primo @samp{+} con @samp{*}) permette che siano presenti dei
+campi vuoti:
+
address@hidden
+FPAT = "([^,]*)|(\"[^\"]+\")"
address@hidden example
+
address@hidden FIXME: 4/2015
address@hidden Consider use of FPAT = "([^,]*)|(\"[^\"]*\")"
address@hidden (star in latter part of value) to allow quoted strings to be
empty.
address@hidden Per email from Ed Morton <address@hidden>
+
+Infine, la funzione @code{patsplit()} rende la stessa address@hidden
disponibile
+per suddividere normali stringhe (@pxref{Funzioni per stringhe}).
+
+Per ricapitolare, @command{gawk} fornisce tre metodi indipendenti per
+suddividere in campi i record in input.
+Il meccanismo usato @`e determinato da quella tra le tre
address@hidden, @code{FIELDWIDTHS}, o @code{FPAT}---a cui
+sia stato assegnato un valore address@hidden recentemente.
+
address@hidden Righe multiple
address@hidden Record su righe multiple
+
address@hidden righe multiple, record su
address@hidden record multiriga
address@hidden input, record multiriga
address@hidden file, lettura dei record multiriga
address@hidden input, file in, si veda file in input
+In alcune banche-dati, una sola riga non address@hidden contenere in modo
adeguato
+tutte le informazioni di una voce. In questi casi si possono usare record
+multiriga.
+Il primo passo @`e quello di scegliere il formato dei dati.
+
address@hidden separatori di record, per record multiriga
+Una tecnica @`e quella di usare un carattere o una stringa non usuali per
+separare i record. Per esempio, si address@hidden usare il carattere di
interruzione di
+pagina (scritto @samp{\f} sia in @command{awk} che in C) per separarli,
+rendendo ogni record una pagina del file. Per far address@hidden, basta
impostare la
+variabile @code{RS} a @code{"\f"} (una stringa contenente il carattere di
+interruzione di pagina). Si potrebbe ugualmente usare qualsiasi altro
+carattere, sempre che non faccia parte dei dati di un record.
+
address@hidden @code{RS}, variabile, record multiriga e
+Un'altra tecnica @`e quella di usare righe vuote per separare i record.
+Per una particolare
+convenzione, una stringa nulla come valore di @code{RS} indica che i record
+sono separati da una o address@hidden righe vuote. Quando @code{RS} @`e
impostato alla
+stringa nulla, ogni record termina sempre alla prima riga vuota che @`e stata
+trovata. Il record successivo non inizia prima della successiva riga non
+vuota. Indipendentemente dal numero di righe vuote presenti in successione,
+esse costituiscono sempre un unico separatore di record.
+(Le righe vuote devono essere completamente vuote; righe che contengono
+spazi bianchi @emph{non} sono righe vuote.)
+
address@hidden stringa address@hidden lunga da sinistra, individuare la
address@hidden individuare la stringa address@hidden lunga da sinistra
+Si address@hidden ottenere lo stesso effetto di @samp{RS = ""} assegnando la
stringa
address@hidden"\n\n+"} a @code{RS}. Quest'espressione regolare individua
+il ritorno a capo alla fine del record e una o address@hidden righe vuote dopo
il
+record. In aggiunta, un'espressione regolare individua sempre la sequenza
address@hidden
+lunga possibile quando una tale stringa sia presente.
+(@address@hidden lungo da sinistra}).
+Quindi, il record successivo non inizia prima della successiva riga non
+vuota; indipendentemente dal numero di righe vuote presenti in una voce di
+banca-dati, esse sono considerate come un unico separatore di record.
+
address@hidden angolo buio, record multiriga
+Comunque, c'@`e una sostanziale differenza tra @samp{RS = ""} e @samp{RS =
+"\n\n+"}. Nel primo caso, i ritorni a capo iniziali nel @value{DF} di
+input vengono ignorati, e se un file termina senza righe vuote aggiuntive dopo
+l'ultimo record, il ritorno a capo viene rimosso dal record. Nel secondo
+caso, questa particolare elaborazione non viene fatta.
address@hidden
+
address@hidden separatore di campo, nei record multiriga
address@hidden @code{FS}, nei record multiriga
+Ora che l'input @`e separato in record, il secondo passo @`e quello di
separare i
+campi all'interno dei record. Un modo per farlo @`e quello di dividere in
+campi ognuna delle righe in input
+nel modo solito. Questo viene fatto per default tramite una
+speciale address@hidden Quando @code{RS} @`e impostato alla stringa nulla
address@hidden @code{FS} @`e impostato a un solo carattere, il carattere di
+ritorno a capo agisce @emph{sempre} come separatore di campo.
+Questo in aggiunta a tutte le separazioni di campo che risultano da
address@hidden@footnote{Quando @code{FS} @`e la stringa nulla (@code{""}), o
+un'espressione regolare, questa particolare address@hidden di @code{RS} non
+viene applicata; si applica al separatore di campo quando @`e costituito da un
+solo spazio:
address@hidden = @w{" "}}.}
+
+La motivazione originale per questa particolare eccezione probabilmente era
+quella di prevedere un comportamento che fosse utile nel caso di default
+(address@hidden, @code{FS} uguale a @address@hidden" "}}). Questa
address@hidden address@hidden
+costituire un problema se non si vuole che il carattere di ritorno a capo
+faccia da separatore tra i campi, perch@'e non c'@`e alcun modo per impedirlo.
+Tuttavia, si address@hidden aggirare il problema usando la funzione
@code{split()}
+per spezzare i record manualmente.
+(@pxref{Funzioni per stringhe}).
+Se si ha un separatore di campo costituito da un solo carattere, si
address@hidden
+aggirare la address@hidden speciale in modo diverso, trasformando @code{FS}
+in un'espressione regolare contenente
+quel carattere singolo. Per esempio, se il separatore di campo @`e
+un carattere di percentuale, al posto di
address@hidden = "%"}, si address@hidden usare @samp{FS = "[%]"}.
+
+Un altro modo per separare i campi @`e quello di
+mettere ciascun campo su una riga separata: per far questo basta impostare la
+variabile @code{FS} alla stringa @code{"\n"}.
+(Questo separatore di un solo carattere individua un singolo ritorno a capo.)
+Un esempio pratico di un @value{DF} organizzato in questo modo potrebbe essere
+un elenco di indirizzi, in cui delle righe vuote fungono da separatore fra
+record. Si consideri un elenco di indirizzi in un file chiamato
address@hidden, simile a questo:
+
address@hidden
+Jane Doe
+123 Main Street
+Anywhere, SE 12345-6789
+
+John Smith
+456 Tree-lined Avenue
+Smallville, MW 98765-4321
address@hidden
address@hidden example
+
address@hidden
+Un semplice programma per elaborare questo file @`e il seguente:
+
address@hidden
+# addrs.awk --- semplice programma per una lista di indirizzi postali
+
+# I record sono separati da righe bianche
+# Ogni riga @`e un campo.
+BEGIN @{ RS = "" ; FS = "\n" @}
+
address@hidden
+ print "Il nome @`e:", $1
+ print "L'indirizzo @`e:", $2
+ print "address@hidden e Stato sono:", $3
+ print ""
address@hidden
address@hidden example
+
+L'esecuzione del programma produce questo output:
+
address@hidden
+$ @kbd{awk -f addrs.awk addresses}
address@hidden Il nome @`e: Jane Doe
address@hidden L'indirizzo @`e: 123 Main Street
address@hidden address@hidden e Stato sono: Anywhere, SE 12345-6789
address@hidden
address@hidden Il nome @`e: John Smith
address@hidden L'indirizzo @`e: 456 Tree-lined Avenue
address@hidden address@hidden e Stato sono: Smallville, MW 98765-4321
address@hidden
address@hidden
address@hidden example
+
address@hidden labels}, per un programma address@hidden realistico per gestire
+elenchi di indirizzi. Il seguente elenco riassume come sono divisi i record,
+a seconda del valore assunto da
address@hidden
address@hidden
+(@samp{==} significa address@hidden uguale a.'')
address@hidden ifinfo
address@hidden
address@hidden:
address@hidden ifnotinfo
+
address@hidden @code
address@hidden RS == "\n"
+I record sono separati dal carattere di ritorno a capo (@samp{\n}). In
+effetti, ogni riga nel @value{DF} @`e un record separato, comprese le righe
+vuote. Questo @`e il comportamento di default.
+
address@hidden RS == @var{qualsiasi carattere singolo}
+I record sono separati da ogni ricorrenza del carattere specificato.
address@hidden
+ricorrenze adiacenti delimitano record vuoti.
+
address@hidden RS == ""
+I record sono separati da una o address@hidden righe vuote.
+Quando @code{FS} @`e un carattere singolo,
+il carattere di ritorno a capo
+serve sempre come separatore di campo, in aggiunta a qualunque valore possa
+avere @code{FS}. I ritorni a capo all'inizio e alla fine del file sono
+ignorati.
+
address@hidden RS == @var{regexp}
+I record sono separati da ricorrenze di caratteri corrispondenti a
address@hidden Le corrispondenze iniziali e finali di
address@hidden designano record vuoti.
+(Questa @`e un'estensione di @command{gawk}; non @`e specificata dallo
+standard POSIX.)
address@hidden table
+
address@hidden @command{gawk}, @code{RT} variabile in
address@hidden @code{RT}, variabile
+Se non @`e eseguito in address@hidden di address@hidden (@pxref{Opzioni}),
address@hidden imposta @code{RT} al testo di input corrispondente
+al valore specificato da @code{RS}.
+Ma se al termine del file in input non @`e stato trovato un testo che
+corrisponde a @code{RS}, @command{gawk} imposta @code{RT} alla stringa nulla.
+
address@hidden Getline
address@hidden Richiedere input usando @code{getline}
+
address@hidden @code{getline}, comando, input esplicito con
address@hidden input esplicito
+Finora abbiamo ottenuto i dati di input dal flusso di input principale di
address@hidden: lo standard input (normalmente la tastiera, a volte
+l'output di un altro programma) o i
+file indicati sulla riga di comando. Il linguaggio @command{awk} ha uno
+speciale comando predefinito chiamato @code{getline} che
address@hidden essere usato per leggere l'input sotto il diretto controllo
dell'utente.
+
+Il comando @code{getline} @`e usato in molti modi diversi e
address@hidden dovrebbe essere usato dai principianti.
+L'esempio che segue alla spiegazione del comando @code{getline}
+comprende del materiale che ancora non @`e stato trattato. Quindi, @`e meglio
+tornare indietro e studiare il comando @code{getline} @emph{dopo} aver rivisto
+il resto
address@hidden
+di questo @value{DOCUMENT}
address@hidden ifinfo
address@hidden
+di questo @value{DOCUMENT}
address@hidden ifhtml
address@hidden
address@hidden
+delle Parti I e II
address@hidden ifnothtml
address@hidden ifnotinfo
+e avere acquisito una buona conoscenza di come funziona @command{awk}.
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile, con comando @command{getline}
address@hidden differenze tra @command{awk} e @command{gawk}, comando
@code{getline}
address@hidden @code{getline}, comando, valori di ritorno
address@hidden @option{--sandbox}, opzione, ridirezione dell'input con
@code{getline}
+
+Il comando @code{getline} restituisce 1 se trova un record e 0 se
+trova la fine del file. Se si verifica qualche errore cercando di leggere
+un record, come un file che non address@hidden essere aperto, @code{getline}
+restituisce @minus{}1. In questo caso, @command{gawk} imposta la variabile
address@hidden a una stringa che descrive l'errore in questione.
+
+Se il messaggio di errore @code{ERRNO} indica che l'operazione di I/O
address@hidden
+essere ritentata e la variabile @code{PROCINFO["@var{input}", "RETRY"]} @`e
+impostata a 1, @code{getline} restituisce un codice di ritorno @minus{}2
+invece che @minus{}1, e si address@hidden provare a chiamare ulterioriormente
address@hidden @xref{Proseguire dopo errore in input} per ulteriori
+informazioni riguardo a questa address@hidden
+
+Negli esempi seguenti, @var{comando} sta per un valore di stringa che
+rappresenta un comando della shell.
+
address@hidden NOTA
+Quando @`e stata specificata l'opzione @option{--sandbox} (@pxref{Opzioni}),
+la lettura di input da file, @dfn{pipe} e coprocessi non @`e possibile.
address@hidden quotation
+
address@hidden
+* Getline semplice:: Usare @code{getline} senza argomenti.
+* Getline variabile:: Usare @code{getline} in una variabile.
+* Getline file:: Usare @code{getline} da un file.
+* Getline variabile file:: Usare @code{getline} in una variabile da un
+ file.
+* Getline @dfn{pipe}:: Usare @code{getline} da una @dfn{pipe}.
+* Getline variabile @dfn{pipe}:: Usare @code{getline} in una variabile da una
+ @dfn{pipe}.
+* Getline coprocesso:: Usare @code{getline} da un coprocesso.
+* Getline variabile coprocesso:: Usare @code{getline} in una variabile da un
+ coprocesso.
+* Note su getline:: Cose importanti da sapere su @code{getline}.
+* Sommario di getline:: Sommario delle varianti di @code{getline}.
address@hidden menu
+
address@hidden Getline semplice
address@hidden Usare @code{getline} senza argomenti
+
+Il comando @code{getline} address@hidden essere usato senza argomenti per
leggere l'input
+dal file in input corrente. Tutto quel che fa in questo caso @`e leggere il
+record in input successivo e dividerlo in campi. Questo @`e utile se @`e
+finita l'elaborarezione del record corrente, e si vogliono fare delle
+elaborazioni particolari sul record successivo @emph{proprio adesso}.
+Per esempio:
+
address@hidden
+# rimuovere il testo tra /* e */, compresi
address@hidden
+ if ((i = index($0, "/*")) != 0) @{
+ prima = substr($0, 1, i - 1) # la parte iniziale della stringa
+ dopo = substr($0, i + 2) # ... */ ...
+ j = index(dopo, "*/") # */ @`e nella parte finale?
+ if (j > 0) @{
+ dopo = substr(dopo, j + 2) # rimozione del commento
+ @} else @{
+ while (j == 0) @{
+ # passa ai record seguenti
+ if (getline <= 0) @{
+ print("Fine file inattesa o errore:", ERRNO) > "/dev/stderr"
+ exit
+ @}
+ # incrementare la riga usando la concatenazione di stringhe
+ dopo = dopo $0
+ j = index(dopo, "*/") # @`e */ nella parte finale?
+ if (j != 0) @{
+ dopo = substr(dopo, j + 2)
+ break
+ @}
+ @}
+ @}
+ # incrementare la riga di output usando la concatenazione
+ # di stringhe
+ $0 = prima dopo
+ @}
+ print $0
address@hidden
address@hidden example
+
address@hidden 8/2014: Here is some sample input:
address@hidden
+mon/*comment*/key
+rab/*commen
+t*/bit
+horse /*comment*/more text
+part 1 /*comment*/part 2 /*comment*/part 3
+no comment
address@hidden ignore
+
+Questo programma @command{awk} cancella i commenti in stile C
+(@samp{/* @dots{} */}) dall'input.
+Usa diverse address@hidden che non sono ancora state trattate, incluse la
+concatenazione di stringhe
+(@pxref{Concatenazione})
+e le funzioni predefinite @code{index()} e @code{substr()}
+(@pxref{Funzioni per stringhe}).
+Sostituendo @samp{print $0} con altre
+istruzioni, si possono effettuare elaborazioni address@hidden complesse
sull'input
+decommentato, come ricercare corrispondenze di un'espressione regolare.
+(Questo programma ha un piccolo problema: non funziona se c'@`e address@hidden
di un
+commento che inizia e finisce
+sulla stessa riga.)
+
+Questa forma del comando @code{getline} imposta @code{NF},
address@hidden, @code{FNR}, @code{RT} e il valore di @code{$0}.
+
address@hidden NOTA
+Il nuovo valore di @code{$0} @`e usato per verificare
+le espressioni di ricerca di ogni regola successiva. Il valore originale
+di @code{$0} che ha attivato la regola che ha eseguito la @code{getline}
+viene perso.
+A differenza di @code{getline}, l'istruzione @code{next} legge un nuovo record
+ma inizia a elaborarlo normalmente, a partire dalla prima
+regola presente nel programma. @xref{Istruzione next}.
address@hidden quotation
+
address@hidden Getline variabile
address@hidden Usare @code{getline} in una variabile
address@hidden @code{getline} in una variabile
address@hidden variabili, usare in comando @code{getline}
+
+Si address@hidden usare @samp{getline @var{var}} per leggere il record
successivo
+in input ad @command{awk} nella variabile @var{var}. Non vien fatta
+nessun'altra elaborazione.
+Per esempio, supponiamo che la riga successiva sia un commento o una stringa
+particolare, e la si voglia leggere senza innescare nessuna regola. Questa
+forma di @code{getline} permette di leggere quella riga e memorizzarla in una
+variabile in modo che il ciclo principale di @command{awk} che "legge una riga
+e controlla ogni regola" non la veda affatto.
+L'esempio seguente inverte tra loro a due a due le righe in input:
+
address@hidden
address@hidden
+ if ((getline tmp) > 0) @{
+ print tmp
+ print $0
+ @} else
+ print $0
address@hidden
address@hidden example
+
address@hidden
+Prende la seguente lista:
+
address@hidden
+wan
+tew
+free
+phore
address@hidden example
+
address@hidden
+e produce questo risultato:
+
address@hidden
+tew
+wan
+phore
+free
address@hidden example
+
+Il comando @code{getline} usato in questo modo imposta solo le variabili
address@hidden, @code{FNR} e @code{RT} (e, naturalmente, @var{var}).
+Il record non viene
+suddiviso in campi, e quindi i valori dei campi (compreso @code{$0}) e
+il valore di @code{NF} non cambiano.
+
address@hidden Getline file
address@hidden Usare @code{getline} da un file
+
address@hidden @code{getline} da un file
address@hidden input, ridirezione dell'
address@hidden ridirezione dell'input
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<} (I/O)
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<} (I/O)
address@hidden operatori di input/output
+Si usa @samp{getline < @var{file}} per leggere il record successivo da
address@hidden Qui, @var{file} @`e un'espressione di tipo stringa che
+specifica il @value{FN}. @samp{< @var{file}} @`e una cosidetta
address@hidden perch@'e richiede che l'input provenga da un posto
+differente. Per esempio, il seguente programma
+legge il suo record in input dal file @file{secondary.input} quando
+trova un primo campo con un valore uguale a 10 nel file in input
+corrente:
+
address@hidden
address@hidden
+ if ($1 == 10) @{
+ getline < "secondary.input"
+ print
+ @} else
+ print
address@hidden
address@hidden example
+
+Poich@'e non viene usato il flusso principale di input, i valori di @code{NR} e
address@hidden restano immutati. Comunque, il record in input viene diviso in
+modo normale, per cui vengono cambiati i valori di @code{$0} e degli altri
+campi, producendo un nuovo valore di @code{NF}.
+Viene impostato anche @code{RT}.
+
address@hidden POSIX @command{awk}, operatore @code{<} e
address@hidden Thanks to Paul Eggert for initial wording here
+Per lo standard POSIX, @samp{getline < @var{espressione}} @`e ambiguo se
address@hidden contiene operatori che non sono all'interno di parentesi,
+ad esclusione di @samp{$}; per esempio, @samp{getline < dir "/" file} @`e
+ambiguo perch@'e l'operatore di concatenazione (non ancora trattato;
address@hidden) non @`e posto tra parentesi.
+Si dovrebbe scrivere invece @samp{getline < (dir "/" file)}, se il
+programma dev'essere portabile su tutte le implementazioni di @command{awk}.
+
address@hidden Getline variabile file
address@hidden Usare @code{getline} in una variabile da un file
address@hidden variabili, usare in comando @code{getline}
+
+Si usa @samp{getline @var{var} < @var{file}} per leggere l'input
+dal file
address@hidden, e metterlo nella variabile @var{var}. Come prima, @var{file}
address@hidden un'espressione di tipo stringa che specifica il file dal quale
+legggere.
+
+In questa versione di @code{getline}, nessuna delle variabili predefinite @`e
+cambiata e il record non @`e diviso in campi. La sola variabile cambiata @`e
address@hidden@footnote{Questo non @`e completamente vero. @code{RT}
address@hidden essere
+cambiato se @code{RS} @`e un'espressione regolare.}
+Per esempio, il seguente programma copia tutti i file in input nell'output, ad
+eccezione dei record che dicono @address@hidden@@include @var{nomefile}}}.
+Tale record @`e sostituito dal contenuto del file
address@hidden:
+
address@hidden
address@hidden
+ if (NF == 2 && $1 == "@@include") @{
+ while ((getline line < $2) > 0)
+ print line
+ close($2)
+ @} else
+ print
address@hidden
address@hidden example
+
+Si noti come il nome del file in input aggiuntivo non compaia all'interno del
+programma; @`e preso direttamente dai dati, e precisamente dal secondo campo
+della riga di @code{@@include}.
+
+La funzione @code{close()} viene chiamata per assicurarsi che se nell'input
+appaiono due righe @code{@@include} identiche, l'intero file specificato sia
+incluso ogni volta.
address@hidden file e @dfn{pipe}}.
+
+Una carenza di questo programma @`e che non gestisce istruzioni
address@hidden@@include} nidificate
+(address@hidden, istruzioni @code{@@include} contenute nei file inclusi)
+nel modo in cui ci si aspetta che funzioni un vero preelaboratore di macro.
address@hidden igawk} per un programma
+che gestisce le istruzioni @code{@@include} nidificate.
+
address@hidden Getline @dfn{pipe}
address@hidden Usare @code{getline} da una @dfn{pipe}
+
address@hidden From private email, dated October 2, 1988. Used by permission,
March 2013.
address@hidden Kernighan, Brian
address@hidden
address@hidden'onniscienza ha molti aspetti positivi.
+Se non si address@hidden ottenerla, l'attenzione ai dettagli address@hidden
aiutare.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden @code{|} (barra verticale), operatore @code{|} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|} (I/O)
address@hidden input, @dfn{pipeline}
address@hidden @dfn{pipe}, input
address@hidden operatori, input/output
+L'output di un comando address@hidden anche essere convogliato in
@code{getline}, usando
address@hidden@var{comando} | getline}. In
+questo caso, la stringa @var{comando} viene eseguita come comando di shell e
+il suo output @`e passato ad @command{awk} per essere usato come input.
+Questa forma di @code{getline} legge un record alla volta dalla @dfn{pipe}.
+Per esempio, il seguente programma copia il suo input nel suo output,
+ad eccezione delle righe che iniziano con @samp{@@execute}, che sono
+sostituite dall'output prodotto dall'esecuzione del resto della riga
+costituito da un comando di shell.
+
address@hidden
address@hidden
+ if ($1 == "@@execute") @{
+ tmp = substr($0, 10) # Rimuove "@@execute"
+ while ((tmp | getline) > 0)
+ print
+ close(tmp)
+ @} else
+ print
address@hidden
address@hidden example
+
address@hidden
+La funzione @code{close()} viene chiamata per assicurarsi che, se appaiono
+nell'input due righe @samp{@@execute} identiche, il comando sia eseguito per
+ciascuna di esse.
address@hidden
address@hidden
address@hidden file e @dfn{pipe}}.
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden This example is unrealistic, since you could just use system
+Dato l'input:
+
address@hidden
+pippo
+pluto
+paperino
+@@execute who
+gastone
address@hidden example
+
address@hidden
+il programma potrebbe produrre:
+
address@hidden Robbins, Bill
address@hidden Robbins, Miriam
address@hidden Robbins, Arnold
address@hidden
+pippo
+pluto
+paperino
+arnold ttyv0 Jul 13 14:22
+miriam ttyp0 Jul 13 14:23 (murphy:0)
+bill ttyp1 Jul 13 14:23 (murphy:0)
+gastone
address@hidden example
+
address@hidden
+Si osservi che questo programma ha eseguito @command{who} e stampato il
+risultato. (Eseguendo questo programma, @`e chiaro che ciascun utente
address@hidden
+risultati diversi, a seconda di chi @`e collegato al sistema.)
+
+Questa variante di @code{getline} divide il record in campi, imposta il valore
+di @code{NF}, e ricalcola il valore di @code{$0}. I valori di
address@hidden e @code{FNR} non vengono cambiati.
+Viene impostato @code{RT}.
+
address@hidden POSIX @command{awk}, operatore I/O @code{|} e
address@hidden Thanks to Paul Eggert for initial wording here
+Per lo standard POSIX, @address@hidden | getline} @`e ambiguo se
address@hidden contiene operatori che non sono all'interno di parentesi,
+ad esclusione di @samp{$}. Per esempio,
address@hidden@w{"echo "} "date" | getline} @`e ambiguo perch@'e
+l'operatore di concatenazione non @`e tra parentesi. Si dovrebbe scrivere
+invece @samp{(@w{"echo "} "date") | getline}, se il programma dev'essere
+portabile su tutte le implementazioni di @command{awk}.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden NOTA
+Sfortunatamente, @command{gawk} non ha un comportamento uniforme nel
+trattare un costrutto come @address@hidden"echo "} "date" | getline}.
+La maggior parte delle versioni, compresa la versione corrente, lo tratta
+come @address@hidden("echo "} "date") | getline}.
+(Questo @`e anche il comportamento di BWK @command{awk}.)
+Alcune versioni invece lo trattano come
address@hidden@w{"echo "} ("date" | getline)}.
+(Questo @`e il comportamento di @command{mawk}.)
+In breve, per evitare problemi, @`e @emph{sempre} meglio usare parentesi
+esplicite.
address@hidden quotation
+
address@hidden Getline variabile @dfn{pipe}
address@hidden Usare @code{getline} in una variabile da una @dfn{pipe}
address@hidden variabili, usare in comando @code{getline}
+
+Quando si usa @address@hidden | getline @var{var}},
+l'output di @var{comando} @`e inviato tramite una @dfn{pipe} a
address@hidden ad una variabile @var{var}. Per esempio, il
+seguente programma legge la data e l'ora corrente nella variabile
address@hidden, usando il programma di address@hidden @command{date}, e poi lo
+stampa:
+
address@hidden
+BEGIN @{
+ "date" | getline current_time
+ close("date")
+ print "Report printed on " current_time
address@hidden
address@hidden example
+
+In questa versione di @code{getline}, nessuna delle variabili predefinite @`e
+cambiata e il record non @`e diviso in campi. In ogni caso, @code{RT} viene
+impostato.
+
address@hidden
address@hidden Thanks to Paul Eggert for initial wording here
+Per lo standard POSIX, @address@hidden | getline @var{var}} @`e ambiguo
+se @var{espressione} contiene operatori che non sono all'interno di parentesi
+ad esclusione di @samp{$}; per esempio,
address@hidden@w{"echo "} "date" | getline @var{var}} @`e ambiguo
+perch@'e l'operatore di concatenazione non @`e tra parentesi. Si dovrebbe
+scrivere invece @samp{(@w{"echo "} "date") | getline @var{var}} se il
+programma dev'essere portabile su tutte le implementazioni di @command{awk}.
address@hidden ifinfo
+
address@hidden Getline coprocesso
address@hidden Usare @code{getline} da un coprocesso
address@hidden coprocessi, @code{getline} da
address@hidden @code{getline}, comando, address@hidden usare dal
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|&} (I/O)
address@hidden operatori, input/output
address@hidden differenze tra @command{awk} e @command{gawk}, operatori di
input/output
+
+Leggere dell'input in @code{getline} da una @dfn{pipe} @`e un'operazione
+unidirezionale.
+Il comando avviato con @address@hidden | getline} invia dati
address@hidden programma @command{awk}.
+
+Occasionalmente, si potrebbe avere la address@hidden di inviare dei dati a un
altro
+programma che li elabori, per poi leggere il risultato che esso genera.
address@hidden permette di avviare un @dfn{coprocesso}, col quale sono
+possibili comunicazioni bidirezionali. Questo vien fatto con l'operatore
address@hidden|&}.
+Tipicamente, dapprima si inviano dati al coprocesso e poi si leggono
+i risultati da esso prodotto, come mostrato di seguito:
+
address@hidden
+print "@var{some query}" |& "db_server"
+"db_server" |& getline
address@hidden example
+
address@hidden
+esso invia una richiesta a @command{db_server} e poi legge i risultati.
+
+I valori di @code{NR} e
address@hidden non vengono cambiati,
+perch@'e non @`e cambiato il flusso principale.
+In ogni caso, il record @`e diviso in campi
+nel solito modo, cambiando address@hidden@dotless{i}} i valori di @code{$0},
degli altri campi,
+e di @code{NF} e @code{RT}.
+
+I coprocessi sono una address@hidden avanzata. Vengono trattati qui solo
perch@'e
address@hidden
+questa @`e la
address@hidden ifnotinfo
address@hidden
+questo @`e il
address@hidden ifinfo
address@hidden su @code{getline}.
address@hidden/O bidirezionale},
+dove i coprocessi vengono trattati address@hidden dettagliatamente.
+
address@hidden Getline variabile coprocesso
address@hidden Usare @code{getline} in una variabile da un coprocesso
address@hidden variabili, usare in comando @code{getline}
+
+Quando si usa @address@hidden |& getline @var{var}}, l'output dal
+coprocesso @var{comando} viene inviato tramite una @dfn{pipe} bidirezionale a
address@hidden e nella variabile @var{var}.
+
+In questa versione di @code{getline}, nessuna delle variabili predefinite
+viene cambiata e il record non viene diviso in campi. La sola variabile che
+cambia @`e @var{var}.
+In ogni caso, @code{RT} viene impostato.
+
address@hidden
+I coprocessi sono una address@hidden avanzata. Vengono trattati qui solo
perch@'e
+questo @`e il @value{SECTION} su @code{getline}.
address@hidden/O bidirezionale},
+dove i coprocessi vengono trattati address@hidden dettagliatamente.
address@hidden ifinfo
+
address@hidden Note su getline
address@hidden Cose importanti da sapere riguardo a @code{getline}
+Qui sono elencate diverse considerazioni su @code{getline}
+da tener presenti:
+
address@hidden @value{BULLET}
address@hidden
+Quando @code{getline} cambia il valore di @code{$0} e @code{NF},
address@hidden @emph{non} salta automaticamente all'inizio del
+programma per iniziare a provare il nuovo record su ogni criterio di ricerca.
+Comunque, il nuovo record viene provato su ogni regola successiva.
+
address@hidden differenze tra @command{awk} e @command{gawk}, limitazioni di
implementazione
address@hidden implementazione, problemi, @command{gawk}, limiti
address@hidden @command{awk}, implementazioni, limiti
address@hidden @command{gawk}, problemi di implementazioni, limiti
address@hidden
+Alcune tra le prime implementazioni di @command{awk} limitano a una sola il
+numero di @dfn{pipeline} che un programma @command{awk} address@hidden tenere
aperte.
+In @command{gawk}, non c'@`e questo limite.
+Si possono aprire tante @dfn{pipeline} (e coprocessi) quante ne permette il
+sistema operativo in uso.
+
address@hidden effetti collaterali, variabile @code{FILENAME}
address@hidden @code{FILENAME}, variabile, impostare con @code{getline}
address@hidden angolo buio, variabile @code{FILENAME}
address@hidden @code{getline}, comando, variabile @code{FILENAME} e
address@hidden @code{BEGIN}, criterio di ricerca, @code{getline} e
address@hidden
+Un interessante effetto collaterale si ha se si usa @code{getline}, senza
+una ridirezione, all'interno di una regola @code{BEGIN}. Poich@'e una
address@hidden non ridiretta legge dai @value{DF} specificati nella riga di
+comando, il primo comando @code{getline} fa address@hidden@dotless{i}} che
@command{awk} imposti
+il valore di @code{FILENAME}. Normalmente, @code{FILENAME} non ha ancora un
+valore all'interno delle regole @code{BEGIN}, perch@'e non si @`e ancora
+iniziato a elaborare il
address@hidden della riga di comando.
address@hidden
+(Si veda @ref{BEGIN/END};
+e @pxref{Variabili auto-assegnate}.)
+
address@hidden
+Usare @code{FILENAME} con @code{getline}
+(@samp{getline < FILENAME})
address@hidden essere fonte di
+confusione. @command{awk} apre un flusso separato di input, diverso dal
+file in input corrente. Comunque, poich@'e non si usa una variabile,
address@hidden e @code{NF} vengono aggiornati. Se si sta facendo questo, @`e
+probabilmente per sbaglio, e si dovrebbe rivedere quello che si sta cercando
+di fare.
+
address@hidden
address@hidden
+La prossima @value{SECTION}
address@hidden ifdocbook
address@hidden
address@hidden di getline},
address@hidden ifnotdocbook
+contiene una tabella che sintetizza le
+varianti di @code{getline} e le variabili da esse modificate.
address@hidden degno di nota che le varianti che non usano la ridirezione
+possono far address@hidden@dotless{i}} che @code{FILENAME} venga aggiornato se
chiedono ad
address@hidden di iniziare a leggere un nuovo file in input.
+
address@hidden
address@hidden Moore, Duncan
+Se la variabile assegnata @`e un'espressione con effetti collaterali, versioni
+differenti di @command{awk} si comportano in modo diverso quando trovano la
+fine-del-file [EOF]. Alcune versioni non valutano l'espressione; molte
+versioni (compreso @command{gawk}) lo fanno. Si veda un esempio, gentilmente
+fornito da Duncan Moore:
+
address@hidden
+Date: Sun, 01 Apr 2012 11:49:33 +0100
+From: Duncan Moore <duncan.moore@@gmx.com>
address@hidden ignore
+
address@hidden
+BEGIN @{
+ system("echo 1 > f")
+ while ((getline a[++c] < "f") > 0) @{ @}
+ print c
address@hidden
address@hidden example
+
address@hidden
+Qui l'effetto secondario @`e @samp{++c}. Se viene trovata la fine del file
address@hidden di assegnare l'elemento @code{a}, @code{c} @`e incrementato o no?
+
address@hidden tratta @code{getline} come una chiamata di funzione, e valuta
+l'espressione @samp{a[++c]} prima di cercare di leggere da @file{f}.
+Comunque, alcune versioni di @command{awk} valutano l'espressione solo
+se c'@`e un valore di stringa da assegnare.
address@hidden itemize
+
address@hidden Sommario di getline
address@hidden Sommario delle varianti di @code{getline}
address@hidden @code{getline}, comando, varianti
+
+La @ref{tabella-varianti-getline}
+riassume le otto varianti di @code{getline},
+elencando le variabili predefinite che sono impostate da ciascuna di esse,
+e se la variante @`e standard o @`e un'estensione di @command{gawk}.
+Nota: per ogni variante, @command{gawk} imposta la variabile predefinita
address@hidden
+
address@hidden Tabella,tabella-varianti-getline
address@hidden di @code{getline} e variabili impostate da ognuna}
address@hidden @columnfractions .33 .38 .27
address@hidden Variante @tab Effetto @tab @command{awk} / @command{gawk}
address@hidden @code{getline} @tab Imposta @code{$0}, @code{NF}, @code{FNR},
@code{NR}, e @code{RT} @tab @command{awk}
address@hidden @code{getline} @var{var} @tab Imposta @var{var}, @code{FNR},
@code{NR}, e @code{RT} @tab @command{awk}
address@hidden @code{getline <} @var{file} @tab Imposta @code{$0}, @code{NF}, e
@code{RT} @tab @command{awk}
address@hidden @code{getline @var{var} < @var{file}} @tab Imposta @var{var} e
@code{RT} @tab @command{awk}
address@hidden @var{comando} @code{| getline} @tab Imposta @code{$0},
@code{NF}, e @code{RT} @tab @command{awk}
address@hidden @var{comando} @code{| getline} @var{var} @tab Imposta @var{var}
e @code{RT} @tab @command{awk}
address@hidden @var{comando} @code{|& getline} @tab Imposta @code{$0},
@code{NF}, e @code{RT} @tab @command{gawk}
address@hidden @var{comando} @code{|& getline} @var{var} @tab Imposta @var{var}
e @code{RT} @tab @command{gawk}
address@hidden multitable
address@hidden float
+
address@hidden Timeout in lettura
address@hidden Leggere input entro un tempo limite
address@hidden tempo limite, leggere input
address@hidden @dfn{timeout}, si veda tempo limite
+
address@hidden differenze tra @command{awk} e @command{gawk}, tempo limite per
lettura
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
+Si address@hidden specificare un tempo limite in millisecondi per leggere
l'input dalla
+tastiera, da una @dfn{pipe} o da una comunicazione bidirezionale, compresi i
address@hidden TCP/IP. Questo address@hidden essere fatto per input, per
comando o per
+connessione, impostando un elemento speciale nel vettore @code{PROCINFO}
+(@pxref{Variabili auto-assegnate}):
+
address@hidden
+PROCINFO["nome_input", "READ_TIMEOUT"] = @var{tempo limite in millisecondi}
address@hidden example
+
+Se @`e impostato, @command{gawk} smette di attendere una risposta e restituisce
+insuccesso se non sono disponibili dati da leggere entro il limite di tempo
+specificato. Per esempio, un cliente TCP address@hidden decidere di
abbandonare se
+non riceve alcuna risposta dal server dopo un certo periodo di tempo:
+
address@hidden
+Service = "/inet/tcp/0/localhost/daytime"
+PROCINFO[Service, "READ_TIMEOUT"] = 100
+if ((Service |& getline) > 0)
+ print $0
+else if (ERRNO != "")
+ print ERRNO
address@hidden example
+
+Qui vediamo come ottenere dati interattivamente dall'address@hidden
+presuppone che lo standard input provenga dalla tastiera.} aspettando per
+non address@hidden di cinque secondi:
+
address@hidden
+PROCINFO["/dev/stdin", "READ_TIMEOUT"] = 5000
+while ((getline < "/dev/stdin") > 0)
+ print $0
address@hidden example
+
address@hidden termina l'operazione di lettura se l'input non
+arriva entro il periodo di tempo limite, restituisce insuccesso
+e imposta @code{ERRNO} a una stringa di valore adeguato.
+Un valore del tempo limite negativo o pari a zero equivale a non specificare
+affatto un tempo limite.
+
+Si address@hidden impostare un tempo limite anche per leggere dalla tastiera
nel ciclo
+implicito che legge i record in input e li confronta coi criteri di ricerca,
+come:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ PROCINFO["-", "READ_TIMEOUT"] = 5000 @}}
+> @address@hidden print "You entered: " $0 @}'}
address@hidden
address@hidden You entered: gawk
address@hidden example
+
+In questo caso, la mancata risposta entro cinque secondi address@hidden luogo
al seguente
+messaggio di errore:
+
address@hidden
address@hidden questo @`e l'output effettivo - Antonio
address@hidden gawk: linea com.:2: (FILENAME=- FNR=1) fatale: errore leggendo
address@hidden file in input `-': Connessione scaduta
address@hidden example
+
+Il tempo limite address@hidden essere impostato o cambiato in qualsiasi
momento, e address@hidden
+effetto al tentativo successivo di leggere dal dispositivo di input. Nel
+seguente esempio, partiamo con un valore di tempo limite di un secondo e
+lo riduciamo progressivamente di un decimo di secondo finch@'e l'attesa
+per l'input diventa illimitata.
+
address@hidden
+PROCINFO[Service, "READ_TIMEOUT"] = 1000
+while ((Service |& getline) > 0) @{
+ print $0
+ PROCINFO[Service, "READ_TIMEOUT"] -= 100
address@hidden
address@hidden example
+
address@hidden NOTA
+Non si deve dare per scontato che l'operazione di lettura si blocchi
+esattamente dopo che @`e stato stampato il decimo record. @`E possibile che
address@hidden legga e tenga in memoria i dati di address@hidden di un record
+la prima volta. Per questo, cambiare il valore del tempo
+limite come nell'esempio appena visto non @`e molto utile.
address@hidden quotation
+
+Se l'elemento di @code{PROCINFO} non @`e presente e la variabile d'ambiente
address@hidden esiste,
address@hidden usa il suo valore per inizializzare il valore di tempo limite.
+L'uso esclusivo della variabile d'ambiente per specificare il tempo limite
+ha lo svantaggio di non essere
+adattabile per ogni comando o per ogni connessione.
+
address@hidden considera errore un superamento di tempo limite anche se
+il tentativo di leggere dal dispositivo sottostante potrebbe riuscire
+in un tentativo successivo. Questa @`e una limitazione, e inoltre
+significa che non @`e possibile usarlo per ottenere input multipli,
+provenienti da due o address@hidden sorgenti. @xref{Proseguire dopo errore in
input}
+per una address@hidden che consente di tentare ulteriori operazioni di I/O.
+
+Assegnare un valore di tempo limite previene un blocco a tempo indeterminato
+legato a operazioni di lettura. Si tenga address@hidden presente che ci sono
altre
+situazioni in cui @command{gawk} address@hidden restare bloccato in attesa che
un
+dispositivo di input sia pronto. Un cliente di rete a volte address@hidden
impiegare
+molto tempo per stabilire una
+connessione prima di poter iniziare a leggere qualsiasi dato,
+oppure il tentativo di aprire un file speciale FIFO in lettura address@hidden
bloccarsi
+indefinitamente in attesa che qualche altro processo lo apra in scrittura.
+
address@hidden Proseguire dopo errore in input
address@hidden Elaborare ulteriore input dopo certi errori di I/O
address@hidden proseguire dopo errore in input
address@hidden errore in input, address@hidden di proseguire
+
address@hidden differenze tra @command{awk} e @command{gawk}, proseguire dopo
errore in input
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
+Qualora @command{gawk} incontri un errore durante la lettura dell'input,
+per default @code{getline} ha come codice di ritorno @minus{}1, e i
+successivi tentativi di leggere dallo stesso file restituiscono una
+indicazione di fine-file. @`E tuttavia possibile chiedere a
address@hidden di consentire un ulteriore tentativo di lettura in presenza
+di certi errori, impostando uno speciale elemento del vettore
address@hidden (@pxref{Variabili auto-assegnate}):
+
address@hidden
+PROCINFO["@var{nome_input_file}", "RETRY"] = 1
address@hidden example
+
+Quando un tale elemento esiste, @command{gawk} controlla il valore della
+variabile di sistema
+(nel linguaggio C)
address@hidden quando si verifica un errore di I/O.
+Se @code{errno} indica che un ulteriore tentativo di lettura address@hidden
+terminare con successo, @code{getline} ha come codice di ritorno @minus{}2
+e ulteriori chiamate a @code{getline} possono terminare correttamente.
+Questo vale per i seguenti valori di @code{errno}: @code{EAGAIN},
address@hidden, @code{EINTR}, e @code{ETIMEDOUT}.
+
+Questa address@hidden @`e utile quando si assegna un valore all'elemento
address@hidden"@var{nome_input_file}", "READ_TIMEOUT"]} o in situazioni
+in cui un descrittore di file sia stato configurato per comportarsi in
+modo non bloccante.
+
address@hidden Directory su riga di comando
address@hidden Directory sulla riga di comando
address@hidden differenze tra @command{awk} e @command{gawk}, directory sulla
riga di comando
address@hidden directory, riga di comando
address@hidden riga di comando, directory su
+
+Per lo standard POSIX, i file che compaiono sulla riga di comando di
address@hidden devono essere file di testo; @`e un errore fatale se non lo sono.
+La maggior parte delle versioni di @command{awk} genera un errore fatale
+quando trova una directory sulla riga di comando.
+
+Per default, @command{gawk} emette un avvertimento se c'@`e una directory sulla
+riga di comando, e in ogni caso la ignora. Questo rende address@hidden facile
usare
+metacaratteri di shell col proprio programma @command{awk}:
+
address@hidden
+$ @kbd{gawk -f whizprog.awk *} @ii{Le directory potrebbero far fallire il
programma}
address@hidden example
+
+Se viene data una delle opzioni @option{--posix}
+o @option{--traditional}, @command{gawk} considera invece
+una directory sulla riga di comando come un errore fatale.
+
address@hidden di estensione Readdir} per un modo di trattare le directory
+come dati usabili da un programma @command{awk}.
+
address@hidden 2
address@hidden Sommario di Input
address@hidden Sommario di Input
+
address@hidden @value{BULLET}
address@hidden
+L'input @`e diviso in record in base al valore di @code{RS}.
+Le address@hidden sono le seguenti:
+
address@hidden @columnfractions .28 .45 .40
address@hidden Valore di @code{RS} @tab Record separati da @dots{} @tab
@command{awk} / @command{gawk}
address@hidden Un carattere singolo @tab Quel carattere @tab @command{awk}
address@hidden La stringa nulla (@code{""}) @tab Serie di due o address@hidden
ritorni a capo @tab @command{awk}
address@hidden Un'espressione regolare @tab Testo corrispondente alla
@dfn{regexp} @tab @command{gawk}
address@hidden multitable
+
address@hidden
address@hidden indica quanti record sono stati letti dal file in input corrente;
address@hidden indica quanti record sono stati letti in totale.
+
address@hidden
address@hidden imposta @code{RT} al testo individuato da @code{RS}.
+
address@hidden
+Dopo la divisione dell'input in record, @command{awk} divide
+i record in singoli campi, chiamati @code{$1}, @code{$2} e
address@hidden@dotless{i}}
+via. @code{$0} @`e l'intero record, e @code{NF} indica quanti campi
+contiene. Il metodo di default per dividere i campi utilizza i
+caratteri di spazio vuoto.
+
address@hidden Si address@hidden far riferimento ai campi usando una variabile,
come in @code{$NF}.
+Ai campi possono anche essere assegnati dei valori, e questo implica che il
+valore di @code{$0} sia ricalcolato se ad esso si fa riferimento in seguito.
+Fare un assegnamento a un campo con un numero maggiore di @code{NF} crea il
+campo e ricostruisce il record, usando @code{OFS} per separare i campi.
+Incrementare @code{NF} fa la stessa cosa. Decrementare @code{NF} scarta dei
+campi e ricostruisce il record.
+
address@hidden
+Separare i campi @`e address@hidden complicato che separare i record.
+
address@hidden @columnfractions .40 .40 .20
address@hidden Valore del separatore di campo @tab Campi separati @dots{} @tab
@command{awk} / @command{gawk}
address@hidden @code{FS == " "} @tab Da serie di spazi vuoti @tab @command{awk}
address@hidden @code{FS == @var{un solo carattere}} @tab Da quel carattere @tab
@command{awk}
address@hidden @code{FS == @var{espr. reg.}} @tab Dal testo che corrisponde
alla @dfn{regexp} @tab @command{awk}
address@hidden @code{FS == ""} @tab address@hidden@dotless{i}} ogni singolo
carattere @`e un campo separato @tab @command{gawk}
address@hidden @code{FIELDWIDTHS == @var{lista di colonne}} @tab Basata sulla
posizione del carattere @tab @command{gawk}
address@hidden @code{FPAT == @var{regexp}} @tab Dal testo attorno al testo
corrispondente alla @dfn{regexp} @tab @command{gawk}
address@hidden multitable
+
address@hidden
+Usando @samp{FS = "\n"} l'intero record address@hidden un unico campo
+(nell'ipotesi che i record siano separati da caratteri di ritorno a capo).
+
address@hidden
address@hidden address@hidden essere impostato dalla riga di comando con
l'opzione
address@hidden
+Si address@hidden fare la stessa cosa usando un assegnamento di variabile da
riga di
+comando.
+
address@hidden
address@hidden"FS"]} permette di sapere come i campi sono separati.
+
address@hidden
address@hidden nelle sue diverse forme serve per leggere record aggiuntivi
+provenienti dal flusso di input di default, da un file, o da una @dfn{pipe}
+o da un coprocesso.
+
address@hidden
address@hidden@var{file}, "READ_TIMEOUT"]} si address@hidden usare per
impostare un
+tempo limite alle operazioni di lettura da @var{file}.
+
address@hidden
+Le directory sulla riga di comando generano un errore fatale per
address@hidden standard;
address@hidden le ignora se non @`e in address@hidden POSIX.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi su Input
address@hidden Esercizi
+
address@hidden
address@hidden
+Usando la variabile @code{FIELDWIDTHS} (@pxref{Dimensione costante}),
+scrivere un programma per leggere i dati delle elezioni, dove ogni record
+rappresenta i voti di un votante. Trovare un modo per definire quali colonne
+sono associate a ogni quesito elettorale, e stampare i voti totali,
+comprese le astensioni, per ciascun quesito.
address@hidden
+La @ref{Getline semplice}, ha illustrato un programma per rimuovere i commenti
+in stile C (@samp{/* @dots{} */}) dall'input. Quel programma
+non funziona se un commento termina in una riga e il successivo commento
+inizia nella stessa riga.
+Il problema si address@hidden risolvere con una semplice modifica. Quale?
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden Stampare
address@hidden Stampare in output
+
address@hidden stampare
address@hidden output, stampare, si veda stampare
+Una delle azioni che un programma fa address@hidden comunemente, @`e quella di
produrre
address@hidden, ossia scrivere in output l'input letto, tutto o in parte.
+Si address@hidden usare l'istruzione @code{print} per una stampa semplice, e
l'istruzione
address@hidden per una formattazione dell'output address@hidden sofisticata.
+L'istruzione @code{print} non ha un limite al numero di elementi quando
+calcola @emph{quali} valori stampare. Peraltro, con due eccezioni,
+non @`e possibile specificare @emph{come} stamparli: quante
+colonne, se usare una notazione esponenziale o no, etc.
+(Per le eccezioni, @pxref{Separatori di output} e
+la @ref{OFMT}.)
+Per stampare fornendo delle specifiche, @`e necessario usare
+l'istruzione @code{printf}
+(@pxref{Printf}).
+
address@hidden istruzione @code{print}
address@hidden istruzione @code{printf}
+Oltre alla stampa semplice e formattata, questo @value{CHAPTER}
+esamina anche le ridirezioni di I/O verso file e @dfn{pipe}, introduce
+i @value{FNS} speciali che @command{gawk} elabora internamente,
+e parla della funzione predefinita @code{close()}.
+
address@hidden
+* Print:: L'istruzione @code{print}.
+* Esempi su print:: Semplici esempi di
+ istruzioni @code{print}.
+* Separatori di output:: I separatori di output e come
+ modificarli.
+* OFMT:: Controllare l'output di numeri con
+ @code{print}.
+* Printf:: l'istruzione @code{printf}.
+* Ridirezione:: Come ridirigere l'output a diversi
+ file e @dfn{pipe}.
+* FD speciali:: I/O con FD [Descrittori File]
+ speciali.
+* File speciali:: Interpretazione nomi file in
+ @command{gawk}. @command{gawk}
+ Permette di accedere a descrittori
+ file address@hidden aperti a inizio esecuzione
+* Chiusura file e @dfn{pipe}:: Chiudere file in input e di output e
+ @dfn{pipe}.
+* Continuazione dopo errori:: Abilitare continuazione dopo errori
+ in output.
+* Sommario di Output:: Sommario di Output.
+* Esercizi su Output:: Esercizi.
address@hidden menu
+
address@hidden Print
address@hidden L'istruzione @code{print}
+
+L'istruzione @code{print} si usa per produrre dell'output formattato in
+maniera semplice, standardizzata. Si
+specificano solo le stringhe o i numeri
+da stampare, in una lista separata da virgole. Questi elementi sono stampati,
+separati tra loro da spazi singoli, e alla fine viene stampato un ritorno a
+capo. L'istruzione @`e simile a questa:
+
address@hidden
+print @var{elemento1}, @var{elemento2}, @dots{}
address@hidden example
+
address@hidden
+L'intera lista di elementi address@hidden facoltativamente essere racchiusa fra
+parentesi. Le parentesi sono obbligatorie se qualche espressione presente
+in uno degli elementi usa l'operatore relazionale @samp{>}, che potrebbe
+essere confuso con una ridirezione dell'output (@pxref{Ridirezione}).
+
+Gli elementi da stampare possono essere stringhe costanti o numeri, campi
+del record corrente (come @code{$1}), variabili, o quasiasi espressione
address@hidden I valori numerici sono convertiti in stringhe prima di essere
+stampati.
+
address@hidden record, stampare
address@hidden righe, vuote, stampare
address@hidden testo, stampare
+Una semplice istruzione @samp{print} senza specificare elementi equivale a
address@hidden $0}: stampa l'intero record corrente. Per stampare una riga
+vuota, si usa @samp{print ""}.
+Per stampare un testo che non cambia, si usi come elemento una costante
+stringa, per esempio @address@hidden"Non v'allarmate"}}. Dimenticandosi di
mettere
+i doppi apici, il testo @`e preso per un'espressione @command{awk},
+e probabilmente address@hidden emesso un messaggio di errore. Occorre tener
presente
+che tra ogni coppia di elementi viene stampato uno spazio.
+
+Si noti che l'istruzione @code{print} @`e un'istruzione, e non
+un'espressione: non @`e possibile usarla nella parte modello [di ricerca] di
+un'istruzione @dfn{criterio di ricerca--azione}, per esempio.
+
address@hidden Esempi su print
address@hidden Esempi di istruzioni @code{print}
+
+Ogni istruzione @code{print} produce almeno una riga in output. Comunque,
+non @`e limitata a una sola riga. Se il valore di un elemento @`e una stringa
+che contiene un ritorno a capo, il ritorno a capo @`e stampato insieme al
+resto della stringa. Una
+singola istruzione @code{print} address@hidden in questo modo generare un
numero
+qualsiasi di righe.
+
address@hidden ritorno a capo, stampare un
+Quel che segue @`e un esempio di stampa di una stringa che contiene al suo
+interno dei
address@hidden
+ritorni a capo
+(la @samp{\n} @`e una sequenza di protezione, che si usa per rappresentare il
+carattere di ritorno a capo; @pxref{Sequenze di protezione}):
address@hidden ifinfo
address@hidden
+ritorni a capo
+(la @samp{\n} @`e una sequenza di protezione, che si usa per rappresentare il
+carattere di ritorno a capo; @pxref{Sequenze di protezione}):
address@hidden ifhtml
address@hidden
address@hidden
+ritorni a capo:
address@hidden ifnothtml
address@hidden ifnotinfo
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "riga uno\nriga due\nriga tre" @}'}
address@hidden riga uno
address@hidden riga due
address@hidden riga tre
address@hidden example
+
address@hidden campi, stampare
+Il prossimo esempio, eseguito sul file @file{inventory-shipped},
+stampa i primi due campi di ogni record in input, separandoli con uno
+spazio:
+
address@hidden
+$ @kbd{awk '@{ print $1, $2 @}' inventory-shipped}
address@hidden Jan 13
address@hidden Feb 15
address@hidden Mar 15
address@hidden
address@hidden example
+
address@hidden istruzione @code{print}, virgole, omettere
address@hidden debug, istruzione @address@hidden omissione virgole
+Un errore frequente usando l'istruzione @code{print} @`e quello di tralasciare
+la virgola tra due elementi. Questo ha spesso come risultato la stampa di
+elementi attaccati tra loro, senza lo spazio di separazione. Il motivo per
+cui address@hidden accade @`e che la scrittura di due
+espressioni di stringa in @command{awk} ne indica la concatenazione. Qui si
+vede l'effetto dello stesso programma,
+senza le virgole:
+
address@hidden
+$ @kbd{awk '@{ print $1 $2 @}' inventory-shipped}
address@hidden Jan13
address@hidden Feb15
address@hidden Mar15
address@hidden
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, intestazioni, aggiungere
+Per chi non conosce il file @file{inventory-shipped} nessuno
+dei due output di esempio risulta molto comprensibile. Una riga iniziale di
+intestazione li renderebbe address@hidden chiari.
+Aggiungiamo qualche intestazione alla nostra tabella dei mesi
+(@code{$1}) e dei contenitori verdi spediti (@code{$2}). Lo facciamo usando
+una regola @code{BEGIN} (@pxref{BEGIN/END}) in modo che le intestazioni siano
+stampate una volta sola:
+
address@hidden
+awk 'BEGIN @{ print "Mese Contenitori"
+ print "----- -----------" @}
+ @{ print $1, $2 @}' inventory-shipped
address@hidden example
+
address@hidden
+Una volta eseguito, il programma stampa questo:
+
address@hidden
+Mese Contenitori
+----- -----------
+Jan 13
+Feb 15
+Mar 15
address@hidden
address@hidden example
+
address@hidden
+Il solo problema, in effetti, @`e che le intestazioni e i dati della tabella
+non sono allineati! Possiamo provvedere stampando alcuni spazi tra i due
+campi:
+
address@hidden
address@hidden
+awk 'BEGIN @{ print "Mese Contenitori"
+ print "----- -----------" @}
+ @{ print $1, " ", $2 @}' inventory-shipped
address@hidden group
address@hidden example
+
address@hidden istruzione @code{printf}, address@hidden allineamento
address@hidden colonne, allineamento
+Allineare le colonne in questo modo address@hidden diventare piuttosto
+complicato, quando ci sono parecchie colonne da tenere allineate. Contare gli
+spazi per due o tre colonne @`e semplice, ma oltre questo limite comincia a
+volerci molto tempo. Ecco perch@'e @`e disponibile l'istruzione @code{printf}
+(@pxref{Printf});
+una delle address@hidden che offre @`e quella di allineare colonne di dati.
+
address@hidden continuazione di riga, in istruzione @code{print}
address@hidden istruzione @code{print}, continuazione di riga e
address@hidden @code{print}, istruzione, continuazione di riga e
address@hidden NOTA
+Si address@hidden continuare su address@hidden righe sia l'istruzione
@code{print} che l'istruzione
address@hidden semplicemente mettendo un ritorno a capo dopo una virgola
+qualsiasi
+(@pxref{Istruzioni/Righe}).
address@hidden quotation
+
address@hidden Separatori di output
address@hidden I separatori di output e come modificarli
+
address@hidden variabile @code{OFS}
+Come detto sopra, un'istruzione @code{print} contiene una lista di elementi
+separati da virgole. Nell'output, gli elementi sono solitamente separati
+da spazi singoli. Non @`e detto tuttavia che debba sempre essere
address@hidden@dotless{i}}; uno
+spazio singolo @`e semplicemnte il valore di default. Qualsiasi stringa di
+caratteri address@hidden essere usata come
address@hidden di campo in output} impostando la variabile
+predefinita @code{OFS}. Il valore iniziale di questa variabile @`e
+la stringa @address@hidden" "}} (address@hidden, uno spazio singolo).
+
+L'output di un'istruzione @code{print} completa @`e detto un @dfn{record di
+output}. Ogni istruzione @code{print} stampa un record di output, e alla fine
+ci aggiunge una stringa detta @dfn{separatore record in output} (o
address@hidden). Il valore iniziale di @code{ORS} @`e la stringa @code{"\n"}
+(address@hidden, un carattere di ritorno a capo). Quindi, ogni istruzione
address@hidden normalmente genera [almeno] una riga a s@'e stante.
+
address@hidden output, record
address@hidden separatore di record in output, si veda @code{ORS}, variabile
address@hidden @code{ORS}, variabile
address@hidden @code{BEGIN}, criterio di ricerca, variabili
@code{OFS}/@code{ORS}, assegnare valori a
+Per cambiare il tipo di separazione in output di campi e record, si impostano
+valori differenti alle variabili @code{OFS} e @code{ORS}. Il posto
address@hidden
+indicato per farlo @`e nella regola @code{BEGIN}
+(@pxref{BEGIN/END}), in modo che l'assegnazione abbia effetto prima
+dell'elaborazione di ogni record in input. Questi valori si possono
+anche impostare dalla riga di comando, prima della lista dei file in input,
+oppure usando l'opzione della riga di comando @option{-v}
+(@pxref{Opzioni}).
+L'esempio seguente stampa il primo e il secondo campo di ogni record in input,
+separati da un punto e virgola, con una riga vuota aggiunta dopo ogni
+ritorno a capo:
+
+
address@hidden
+$ @kbd{awk 'BEGIN @{ OFS = ";"; ORS = "\n\n" @}}
+> @address@hidden print $1, $2 @}' mail-list}
address@hidden Amelia;555-5553
address@hidden
address@hidden Anthony;555-3412
address@hidden
address@hidden Becky;555-7685
address@hidden
address@hidden Bill;555-1675
address@hidden
address@hidden Broderick;555-0542
address@hidden
address@hidden Camilla;555-2912
address@hidden
address@hidden Fabius;555-1234
address@hidden
address@hidden Julie;555-6699
address@hidden
address@hidden Martin;555-6480
address@hidden
address@hidden Samuel;555-3430
address@hidden
address@hidden Jean-Paul;555-2127
address@hidden
address@hidden example
+
+Se il valore di @code{ORS} non contiene un ritorno a capo, l'output del
+programma viene scritto tutto su un'unica riga.
+
address@hidden OFMT
address@hidden Controllare l'output di numeri con @code{print}
address@hidden numerico, formato di output
address@hidden formati numerici di output
+Quando si stampano valori numerici con l'istruzione @code{print},
address@hidden converte internamente ogni numero in una stringa di caratteri
+e stampa quella stringa. @command{awk} usa la funzione @code{sprintf()}
+per effettuare questa conversione
+(@pxref{Funzioni per stringhe}).
+Per ora, basta dire che la funzione @code{sprintf()}
+accetta una @dfn{specifica di formato} che indica come formattare
+i numeri (o le stringhe), e che ci sono svariati modi per formattare i
+numeri. Le differenti specifiche di formato sono trattate address@hidden
+esaurientemente
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di controllo}.
+
address@hidden
address@hidden @code{OFMT}, variabile
address@hidden output, specificatore di address@hidden @code{OFMT}
+La variabile predefinita @code{OFMT} contiene la specifica di formato
+che @code{print} usa con @code{sprintf()} per convertire un numero in
+una stringa per poterla stampare.
+Il valore di default di @code{OFMT} @`e @code{"%.6g"}.
+Il modo in cui @code{print} stampa i numeri si address@hidden cambiare
+fornendo una specifica di formato differente
+per il valore di @code{OFMT}, come mostrato nell'esempio seguente:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{OFMT = "%.0f" # Stampa numeri come interi (arrotonda)}
+> @kbd{print 17.23, 17.54 @}'}
address@hidden 17 18
address@hidden example
+
address@hidden
address@hidden angolo buio, variabile @code{OFMT}
address@hidden POSIX @command{awk}, variabile @code{OFMT} e
address@hidden variabile @code{OFMT}, POSIX @command{awk} e
+Per lo standard POSIX, il comportamento di @command{awk} @`e indefinito
+se @code{OFMT} contiene qualcosa di diverso da una specifica di conversione
+di un numero a virgola mobile.
address@hidden
+
address@hidden Printf
address@hidden Usare l'istruzione @code{printf} per stampe sofisticate
+
address@hidden istruzione @code{printf}
address@hidden @code{printf}, istruzione
address@hidden output, formattato
address@hidden formattare l'output
+Per un controllo address@hidden ampio sul formato di output di quello fornito
da
address@hidden, si address@hidden usare @code{printf}.
+Con @code{printf} si address@hidden
+specificare lo spazio da utilizzare per ogni elemento, e anche le varie
+scelte di formattazione disponibile per i numeri (come la base da usare in
+output, se stampare con notazione esponenziale, se inserire un segno, e quante
+cifre stampare dopo il separatore decimale).
+
address@hidden
+* Printf Fondamenti:: Sintassi dell'istruzione
+ @code{printf}.
+* Lettere di controllo:: Lettere di controllo del formato.
+* Modificatori di formato:: Modificatori specifiche di formato.
+* Esempi su printf:: Numerosi esempi.
address@hidden menu
+
address@hidden Printf Fondamenti
address@hidden Sintassi dell'istruzione @code{printf}
+
address@hidden istruzione @code{printf}, sintassi dell'
address@hidden @code{printf}, sintassi dell'istruzione
+Una semplice istruzione @code{printf} @`e qualcosa di simile a questo:
+
address@hidden
+printf @var{formato}, @var{elemento1}, @var{elemento2}, @dots{}
address@hidden example
+
address@hidden
+Come nel caso di @code{print}, l'intera lista degli argomenti address@hidden
+facoltativamente essere racchiusa fra
+parentesi. Anche qui, le parentesi sono obbligatorie se l'espressione di
+qualche elemento usa l'operatore
+relazionale @samp{>}, che potrebbe
+essere confuso con una ridirezione dell'output (@pxref{Ridirezione}).
+
address@hidden specificatori di formato
+La differenza tra @code{printf} e @code{print} @`e l'argomento @var{formato}.
+Questo @`e un'espressione il cui valore @`e visto come una stringa;
+specifica come scrivere in output ognuno degli altri argomenti. @`E chiamata
address@hidden di formato}.
+
+La stringa di formato @`e molto simile a quella usata dalla funzione di
+libreria ISO C @code{printf()}. Buona parte del @var{formato} @`e testo da
+stampare address@hidden@dotless{i}} come @`e scritto.
+All'interno di questo testo ci sono degli @dfn{specificatori di formato},
+uno per ogni elemento da stampare.
+Ogni specificatore di formato richiede di stampare l'elemento successivo
+nella lista degli argomenti
+in quella posizione del formato.
+
+L'istruzione @code{printf} non aggiunge in automatico un ritorno a capo
+al suo output. Scrive solo quanto specificato dalla stringa di formato.
+Quindi, se serve un ritorno a capo, questo va incluso nella stringa di formato.
+Le variabili di separazione dell'output @code{OFS} e @code{ORS} non hanno
+effetto sulle istruzioni @code{printf}.
+Per esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{ORS = "\nAHI!\n"; OFS = "+"}
+> @kbd{msg = "Non v\47allarmate!"}
+> @kbd{printf "%s\n", msg}
+> @address@hidden'}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden
+Qui, n@'e il @samp{+} n@'e l'esclamazione @samp{AHI!} compaiono nel messaggio
+in output.
+
address@hidden Lettere di controllo
address@hidden Lettere di controllo del formato
address@hidden istruzione @code{printf}, lettere di controllo del formato
address@hidden @code{printf}, istruzione, lettere di controllo del formato
address@hidden specificatori di formato, istruzione @code{printf}
+
+Uno specificatore di formato inizia col carattere @samp{%} e termina con
+una @dfn{lettera di controllo del formato}; e dice all'istruzione
address@hidden come stampare un elemento. La lettera di controllo del
+formato specifica che @emph{tipo}
+di valore stampare. Il resto dello specificatore di formato @`e costituito da
address@hidden facoltativi che controllano @emph{come} stampare il valore,
+per esempio stabilendo la larghezza del campo. Ecco una lista delle
+lettere di controllo del formato:
+
address@hidden @asis for docbook to come out right
address@hidden @asis
address@hidden @code{%c}
+Stampa un numero come un carattere; quindi, @samp{printf "%c",
+65} stampa la lettera @samp{A}. L'output per un valore costituito da una
+stringa @`e il primo carattere della stringa stessa.
+
address@hidden angolo buio, caratteri di controllo del formato
address@hidden @command{gawk}, caratteri di controllo del formato
address@hidden NOTA
+Lo standard POSIX richiede che il primo carattere di una stringa sia stampato.
+In localizzazioni con caratteri multibyte, @command{gawk} tenta di
+convertire i primi byte della stringa in un carattere multibyte valido
+e poi di stampare la codifica multibyte di quel carattere.
+Analogamente, nella stampa di un valore numerico, @command{gawk} ammette che
+il valore appartenga all'intervallo numerico di valori che possono essere
+contenuti in un carattere multibyte.
+Se la conversione alla codifica multibyte non riesce, @command{gawk}
+usa gli ultimi otto bit della cifra (quelli meno significativi) come
+carattere da stampare.
+
+Altre versioni di @command{awk} generalmente si limitano a stampare
+il primo byte di una stringa o i valori numerici che possono essere
+rappresentati in un singolo byte (0--255).
address@hidden quotation
+
+
address@hidden @code{%d}, @code{%i}
+Stampa un numero intero in base decimale.
+Le due lettere di controllo sono equivalenti.
+(La specificazione @samp{%i} @`e ammessa per address@hidden con ISO C.)
+
address@hidden @code{%e}, @code{%E}
+Stampa un numero nella notazione scientifica (con uso di esponente).
+Per esempio:
+
address@hidden
+printf "%4.3e\n", 1950
address@hidden example
+
address@hidden
+stampa @samp{1.950e+03}, con un totale di quattro cifre significative, tre
+delle quali
+seguono il punto che separa la parte intera da quella decimale
+[in Italia si usa la virgola al posto del punto]
+(L'espressione @samp{4.3} rappresenta due modificatori,
+introdotti nella prossima @value{SUBSECTION}).
address@hidden usa @samp{E} invece di @samp{e} nell'output.
+
address@hidden @code{%f}
+Stampa un numero in notazione a virgola mobile.
+Per esempio:
+
address@hidden
+printf "%4.3f", 1950
address@hidden example
+
address@hidden
+stampa @samp{1950.000}, con un totale di quattro cifre significative, tre
+delle quali vengono dopo il punto decimale.
+(L'espressione @samp{4.3} rappresenta due modificatori,
+introdotti nella prossima @value{SUBSECTION}).
+
+In sistemi che implementano il formato a virgola mobile, come specificato
+dallo standard IEEE 754, il valore infinito negativo @`e rappresentato come
address@hidden o @samp{-infinity},
+e l'infinito positivo come
address@hidden o @samp{infinity}.
+Il valore speciale ``not a number'' [non @`e un numero] viene scritto come
address@hidden o @samp{nan}
+(@pxref{Definizioni matematiche}).
+
address@hidden @code{%F}
+Come @samp{%f}, ma i valori di infinito e di ``not a number'' sono scritti
+in lettere maiuscole.
+
+Il formato @samp{%F} @`e un'estensione POSIX allo standard ISO C; non tutti
+i sistemi lo prevedono. In tali casi,
address@hidden usa il formato @samp{%f}.
+
address@hidden @code{%g}, @code{%G}
+Stampa un numero usando o la notazione scientifica o quella a virgola
+mobile, scegliendo la forma address@hidden concisa; se il risultato @`e
stampato usando la
+notazione scientifica, @samp{%G} usa @samp{E} invece di @samp{e}.
+
address@hidden @code{%o}
+Stampa un numero intero in ottale, senza segno
+(@pxref{Numeri non-decimali}).
+
address@hidden @code{%s}
+Stampa una stringa.
+
address@hidden @code{%u}
+Stampa un numero intero decimale, senza segno.
+(Questo formato @`e poco usato, perch@'e tutti i numeri in @command{awk}
+sono a virgola mobile; @`e disponibile principalmente per address@hidden col
+linguaggio C.)
+
address@hidden @code{%x}, @code{%X}
+Stampa un intero esadecimale senza segno;
address@hidden usa le lettere da @samp{A} a @samp{F}
+invece che da @samp{a} a @samp{f}
+(@pxref{Numeri non-decimali}).
+
address@hidden @code{%%}
+Stampa un solo carattere @samp{%}.
+Questa notazione non serve per stampare alcun
+argomento e ignora eventuali modificatori.
address@hidden table
+
address@hidden angolo buio, caratteri di controllo del formato
address@hidden @command{gawk}, caratteri di controllo del formato
address@hidden NOTA
+Quando si usano lettere di controllo del formato per numeri interi
+per stampare valori esterni all'intervallo massimo disponibile nel
+linguaggio C per i numeri interi,
address@hidden usa lo
+specificatore di formato @samp{%g}. Se si specifica l'opzione @option{--lint}
+sulla riga di comando (@pxref{Opzioni}), @command{gawk}
+emette un messaggio di avvertimento. Altre versioni di @command{awk} possono
+stampare valori non validi, o comportarsi in modo completamente differente.
address@hidden
address@hidden quotation
+
address@hidden Modificatori di formato
address@hidden Modificatori per specifiche di formato @code{printf}
+
address@hidden istruzione @code{printf}, modificatori
address@hidden @code{printf}, istruzione, modificatori
address@hidden address@hidden in specificatori di formato
+Una specifica di formato address@hidden anche includere dei @dfn{modificatori}
che
+possono controllare che parte stampare del valore dell'elemento, e anche
+quanto spazio utilizzare per stamparlo.
+I modificatori sono posizionati tra il @samp{%} e la lettera che controlla
+il formato.
+Negli esempi seguenti address@hidden usato il simbolo del punto elenco
address@hidden'' per
+rappresentare
+spazi nell'output. Questi sono i modificatori previsti, nell'ordine in
+cui possono apparire:
+
address@hidden @asis
address@hidden differenze tra @command{awk} e @command{gawk}, tra istruzioni
@code{print} e @code{printf}
address@hidden istruzione @code{printf}, specificatori posizionali
address@hidden @code{printf}, istruzione, specificatori posizionali
address@hidden the code{} does NOT start a secondary
address@hidden specificatori posizionali, istruzione @code{printf}
address@hidden @address@hidden
+Una costante intera seguita da un @samp{$} @`e uno @dfn{specificatore
posizionale}.
+Normalmente, le specifiche di formato sono applicate agli argomenti
+nell'ordine in cui appaiono nella stringa di formato. Con uno specificatore
+posizionale, la specifica di formato @`e applicata a un argomento
+indicato per numero, invece che a quello che
+sarebbe il prossimo argomento nella lista. Gli specificatori posizionali
+iniziano a contare partendo da uno. Quindi:
+
address@hidden
+printf "%s %s\n", "Non", "v'allarmate"
+printf "%2$s %1$s\n", "v'allarmate", "Non"
address@hidden example
+
address@hidden
+stampa per due volte il famoso consiglio amichevole.
+
+A prima vista, questa address@hidden non sembra di grande address@hidden
+Si tratta in effetti di un'estensione @command{gawk}, pensata per essere
+usata nella traduzione di messaggi emessi in fase di esecuzione.
address@hidden di printf},
+che descrive come e perch@'e usare specificatori posizionali.
+Per ora li possiamo ignorare.
+
address@hidden - @code{-} (Segno meno)
+Il segno meno, usato prima del modificatore di larghezza (si veda
address@hidden avanti
+in questa lista),
+richiede di allineare a sinistra
+l'argomento mantenendo la larghezza specificata. Normalmente, l'argomento
address@hidden stampato allineato a destra, con la larghezza specificata.
Quindi:
+
address@hidden
+printf "%-6s", "pippo"
address@hidden example
+
address@hidden
+stampa @address@hidden
+
address@hidden @var{spazio}
+Applicabile a conversioni numeriche, richiede di inserire uno spazio prima
+dei valori positivi e un segno meno prima di quelli negativi.
+
address@hidden @code{+}
+Il segno address@hidden, usato prima del modificatore di larghezza (si veda
address@hidden avanti
+in questa lista),
+richiede di mettere sempre un segno nelle conversioni numeriche, anche se
+il dato da formattare ha valore positivo. Il @samp{+} prevale sul
+modificatore @dfn{spazio}.
+
address@hidden @code{#}
+Richiede di usare una ``forma alternativa'' per alcune lettere di controllo.
+Per @samp{%o}, preporre uno zero.
+Per @samp{%x} e @samp{%X}, preporre @samp{0x} o @samp{0X} se il
+numero @`e diverso da zero.
+Per @samp{%e}, @samp{%E}, @samp{%f}, e @samp{%F}, il risultato deve contenere
+sempre un separatore decimale.
+Per @code{%g} e @code{%G}, gli zeri finali non significativi non sono
+tolti dal numero stampato.
+
address@hidden @code{0}
+Uno @samp{0} (zero) iniziale serve a richiedere che l'output sia
+riempito con zeri (invece che con spazi), prima delle cifre significative.
+Questo si applica solo ai formati di output di tipo numerico.
+Questo @dfn{flag} ha un effetto solo se la larghezza del campo @`e maggiore
+di quella del valore da stampare.
+
address@hidden @code{'}
+Un carattere di apice singolo o un apostrofo @`e un'estensione POSIX allo
+standard ISO C.
+Indica che la parte intera di un valore a virgola mobile, o la parte intera
+di un valore decimale intero, ha un carattere di separazione delle migliaia.
address@hidden @`e applicabile solo alle localizzazioni che prevedono un tale
carattere.
+Per esempio:
+
address@hidden
+$ @kbd{cat migliaia.awk} @ii{Visualizza il programma sorgente}
address@hidden BEGIN @{ printf "%'d\n", 1234567 @}
+$ @kbd{LC_ALL=C gawk -f migliaia.awk}
address@hidden 1234567 @ii{Risultato nella localizzazione} "C"
+$ @kbd{LC_ALL=en_US.UTF-8 gawk -f migliaia.awk}
address@hidden 1,234,567 @ii{Risultato nella localizzazione UTF inglese
americana}
address@hidden example
+
address@hidden
+Per maggiori informazioni relative a localizzazioni e internazionalizzazioni,
+si veda @ref{Localizzazioni}.
+
address@hidden NOTA
+Il @dfn{flag} @samp{'} @`e una address@hidden interessante, ma utilizza un
+carattere che @`e fonte di complicazioni, perch@'e risulta difficila da usare
nei
+programmi scritti direttamente sulla riga di comando. Per informazioni sui
+metodi appropriati per gestire la cosa, si veda @ref{Protezione}.
address@hidden quotation
+
address@hidden @var{larghezza}
+Questo @`e un numero che specifica la larghezza minima che deve occupare un
+campo. L'inserimento di un numero tra il segno @samp{%} e il carattere
+di controllo del formato fa address@hidden@dotless{i}} che il campo si espanda
a quella larghezza.
+Il modo di default per fare questo @`e di aggiungere degli spazi a
+sinistra. Per esempio:
+
address@hidden
+printf "%6s", "pippo"
address@hidden example
+
address@hidden
+stampa @address@hidden
+
+il valore di @var{larghezza} indica la larghezza minima, non la massima. Se
+il valore dell'elemento richiede address@hidden caratteri della @var{larghezza}
+specificata, questa address@hidden essere aumentata secondo address@hidden
+Quindi, per esempio:
+
address@hidden
+printf "%6s", "pippo-pluto"
address@hidden example
+
address@hidden
+stampa @samp{pippo-pluto}.
+
+Anteponendo un segno meno alla @var{larghezza} si richiede che l'output sia
+esteso con spazi a destra, invece che a sinistra.
+
address@hidden @address@hidden
+Un punto, seguito da una costante intera
+specifica la precisione da usare nella stampa.
+Il tipo di precisione varia a seconda della lettera di controllo:
+
address@hidden @asis
address@hidden @code{%d}, @code{%i}, @code{%o}, @code{%u}, @code{%x}, @code{%X}
+Minimo numero di cifre da stampare.
+
address@hidden @code{%e}, @code{%E}, @code{%f}, @code{%F}
+Numero di cifre alla destra del separatore decimale.
+
address@hidden @code{%g}, @code{%G}
+Massimo numero di cifre significative.
+
address@hidden @code{%s}
+Massimo numero di caratteri della stringa che possono essere stampati.
address@hidden table
+
+Quindi, l'istruzione:
+
address@hidden
+printf "%.4s", "foobar"
address@hidden example
+
address@hidden
+stampa @samp{foob}.
address@hidden table
+
+Le address@hidden di @var{larghezza} e @var{precisione} dinamiche
(address@hidden,
address@hidden"%*.*s"}) disponibili nell'istruzione @code{printf} della
libreria C sono
+utilizzabili.
+Invece che fornire esplicitamente una @var{larghezza} e/o una @var{precisione}
+nella stringa di formato, queste sono fornite come parte della lista degli
+argomenti. Per esempio:
+
address@hidden
+w = 5
+p = 3
+s = "abcdefg"
+printf "%*.*s\n", w, p, s
address@hidden example
+
address@hidden
+equivale esattamente a:
+
address@hidden
+s = "abcdefg"
+printf "%5.3s\n", s
address@hidden example
+
address@hidden
+Entrambi i programmi stampano @address@hidden@address@hidden
+Versioni address@hidden datate di @command{awk} non consentivano questa
address@hidden
+Dovendo usare una di queste versioni, @`e possibile simulare questa
address@hidden usando la concatenazione per costruire una stringa di formato,
+come per esempio:
+
address@hidden
+w = 5
+p = 3
+s = "abcdefg"
+printf "%" w "." p "s\n", s
address@hidden example
+
address@hidden
+Questo codice non @`e di facile lettura, ma funziona.
+
address@hidden @cindex controlli @command @{lint}
address@hidden debug, errori fatali, @code{printf}, stringhe di formato
address@hidden POSIX @command{awk}, stringhe di formato @code{printf} e
+Chi programma in C probabilmente @`e abituato a specificare modificatori
+addizionali (@samp{h}, @samp{j}, @samp{l}, @samp{L}, @samp{t} e @samp{z}) nelle
+stringhe di formato di @code{printf}. Questi modificatori non sono validi
+in @command{awk}. La maggior parte della implementazioni di @command{awk} li
+ignora senza emettere messaggi. Se si specifica l'opzione @option{--lint}
+sulla riga di comando (@pxref{Opzioni}), @command{gawk} emette un messaggio
+di avvertimento quando li si usa. Se si specifica l'opzione @option{--posix},
+il loro uso genera un errore fatale.
+
address@hidden Esempi su printf
address@hidden Esempi d'uso di @code{printf}
+
+Il seguente semplice esempio mostra
+come usare @code{printf} per preparare una tabella allineata:
+
address@hidden
+awk '@{ printf "%-10s %s\n", $1, $2 @}' mail-list
address@hidden example
+
address@hidden
+Questo comando
+stampa i nomi delle persone (@code{$1}) nel file
address@hidden come una stringa di 10 caratteri allineati a sinistra.
+Stampa anche i numeri telefonici (@code{$2}) a fianco, sulla stessa riga.
+Il risultato @`e una tabella allineata, contenente due colonne, di nomi e
numeri
+telefonici, come si address@hidden vedere qui:
+
address@hidden
+$ @kbd{awk '@{ printf "%-10s %s\n", $1, $2 @}' mail-list}
address@hidden Amelia 555-5553
address@hidden Anthony 555-3412
address@hidden Becky 555-7685
address@hidden Bill 555-1675
address@hidden Broderick 555-0542
address@hidden Camilla 555-2912
address@hidden Fabius 555-1234
address@hidden Julie 555-6699
address@hidden Martin 555-6480
address@hidden Samuel 555-3430
address@hidden Jean-Paul 555-2127
address@hidden example
+
+In questo caso, i numeri telefonici debbono essere stampati come stringhe,
+poich@'e includono un trattino. Una stampa dei numeri telefonici come numeri
+semplici avrebbe visualizzato solo le prime tre cifre: @samp{555},
+e questo non sarebbe stato di grande address@hidden
+
+Non era necessario specificare una larghezza per i numeri telefonici poich@'e
+sono nell'ultima colonnna di ogni riga. Non c'@`e bisogno di avere un
+allineamento di spazi dopo di loro.
+
+La tabella avrebbe potuto essere resa address@hidden leggibile aggiungendo
+intestazioni in cima
+alle colonne. Questo si address@hidden fare usando una regola @code{BEGIN}
+(@pxref{BEGIN/END})
+in modo che le intestazioni siano stampate una sola volta, all'inizio del
+programma @command{awk}:
+
address@hidden
+awk 'BEGIN @{ print "Nome Numero"
+ print "---- ------" @}
+ @{ printf "%-10s %s\n", $1, $2 @}' mail-list
address@hidden example
+
+L'esempio precedente usa sia l'istruzione @code{print} che l'istruzione
address@hidden nello stesso programma. Si possono ottenere gli stessi
+risultati usando solo istruzioni @code{printf}:
+
address@hidden
+awk 'BEGIN @{ printf "%-10s %s\n", "Nome", "Numero"
+ printf "%-10s %s\n", "----", "------" @}
+ @{ printf "%-10s %s\n", $1, $2 @}' mail-list
address@hidden example
+
address@hidden
+Stampare ogni intestazione di colonna con la stessa specifica di formato
+usata per gli elementi delle colonne ci address@hidden la certezza che le
intestazioni
+sono allineate esattamente come le colonne.
+
+Il fatto che usiamo per tre volte la stessa specifica di formato si
address@hidden
+evidenziare memorizzandola in una variabile, address@hidden@dotless{i}}:
+
address@hidden
+awk 'BEGIN @{ format = "%-10s %s\n"
+ printf format, "Nome", "Numero"
+ printf format, "----", "------" @}
+ @{ printf format, $1, $2 @}' mail-list
address@hidden example
+
+
address@hidden Ridirezione
address@hidden Ridirigere l'output di @code{print} e @code{printf}
+
address@hidden output, ridirezione
address@hidden ridirezione dell'output
address@hidden @option{--sandbox}, opzione, ridirezione dell'output con
@code{print}, @code{printf}
+Finora, l'output di @code{print} e @code{printf} @`e stato diretto
+verso lo standard output,
+che di solito @`e lo schermo. Sia @code{print} che @code{printf} possono
+anche inviare il loro output in altre direzioni.
address@hidden quel che si chiama @dfn{ridirezione}.
+
address@hidden NOTA
+Quando si specifica @option{--sandbox} (@pxref{Opzioni}),
+la ridirezione dell'output verso file, @dfn{pipe} e coprocessi non @`e
+consentita.
address@hidden quotation
+
+Una ridirezione @`e posta dopo l'istruzione @code{print} o @code{printf}.
+Le ridirezioni in @command{awk} sono scritte come le ridirezioni nei
+comandi della shell, l'unica differenza @`e che si trovano all'interno di
+un programma @command{awk}.
+
address@hidden the commas here are part of the see also
address@hidden istruzione @code{print}, si veda anche ridirezione dell'output
address@hidden istruzione @code{printf}, si veda anche ridirezione dell'output
+Ci sono quattro forme di ridirezione dell'output:
+output scritto su un file,
+output aggiunto in fondo a un file,
+output che fa da input a un altro comando (usando una @dfn{pipe}) e
+output diretto a un coprocesso.
+Vengono descritti per l'istruzione @code{print},
+ma funzionano allo stesso modo per @code{printf}:
+
address@hidden @code
address@hidden @code{>} (parentesi acuta destra), operatore @code{>} (I/O)
address@hidden parentesi acuta destra (@code{>}), operatore @code{>} (I/O)
address@hidden operatori, input/output
address@hidden print @var{elementi} > @var{output-file}
+Questa ridirezione stampa gli elementi nel file di output chiamato
address@hidden Il @value{FN} @var{output-file} address@hidden essere
+una qualsiasi espressione. Il suo valore @`e trasformato in una stringa e
+quindi usato come
address@hidden
address@hidden (@pxrefil{Espressioni}).
address@hidden iftex
address@hidden
address@hidden (@pxref{Espressioni}).
address@hidden ifnottex
+Quando si usa questo tipo di ridirezione, il file @var{output-file} viene
+cancellato prima che su di esso sia stato scritto il primo record in uscita.
+Le successive scritture verso lo stesso file @var{output-file} non cancellano
address@hidden, ma continuano ad aggiungervi record.
+(Questo comportamento @`e differente da quello delle ridirezioni usate negli
+script della shell.)
+Se @var{output-file} non esiste, viene creato. Per esempio, ecco
+come un programma @command{awk} address@hidden scrivere una lista di nomi di
persone
+su un file di nome @file{lista-nomi}, e una lista di numeri telefonici
+su un altro file di nome @file{lista-telefoni}:
+
address@hidden
+$ @kbd{awk '@{ print $2 > "lista-telefoni"}
+> @kbd{print $1 > "lista-nomi" @}' mail-list}
+$ @kbd{cat lista-telefoni}
address@hidden 555-5553
address@hidden 555-3412
address@hidden
+$ @kbd{cat lista-nomi}
address@hidden Amelia
address@hidden Anthony
address@hidden
address@hidden example
+
address@hidden
+Ogni file in output contiene un nome o un numero su ogni riga.
+
address@hidden @code{>} (parentesi acuta destra), operatore @code{>>} (I/O)
address@hidden parentesi acuta destra (@code{>}), operatore @code{>>} (I/O)
address@hidden print @var{elementi} >> @var{output-file}
+Questa ridirezione stampa gli elementi in un file di output preesistente,
+di nome @var{output-file}. La differenza tra questa ridirezione e quella
+con un solo @samp{>} @`e che il precedente contenuto (se esiste) di
address@hidden non viene cancellato. Invece, l'output di @command{awk} @`e
+aggiunto in fondo al file.
+Se @var{output-file} non esiste, viene creato.
+
address@hidden @code{|} (barra verticale), operatore @code{|} (I/O)
address@hidden @dfn{pipe}, output
address@hidden output, a @dfn{pipe}
address@hidden print @var{elementi} | @var{comando}
address@hidden possibile inviare output a un altro programma usando una
@dfn{pipe}
+invece di inviarlo a un file. Questa ridirezione apre una @dfn{pipe} verso
address@hidden, e invia i valori di @var{elementi}, tramite questa
address@hidden, a un altro processo creato per eseguire @var{comando}.
+
+L'argomento @var{comando}, verso cui @`e rivolta la ridirezione, @`e in
address@hidden
+un'espressione
address@hidden Il suo valore @`e convertito in una stringa il cui contenuto
+costituisce un comando della shell che deve essere eseguito. Per esempio,
+il seguente programma produce due file, una lista non ordinata di nomi di
+persone e una lista ordinata in ordine alfabetico inverso:
+
address@hidden
+10/2000:
+This isn't the best style, since COMMAND is assigned for each
+record. It's done to avoid overfull hboxes in TeX. Leave it
+alone for now and let's hope no-one notices.
address@hidden ignore
+
address@hidden
+awk '@{ print $1 > "nomi.non.ordinati"
+ comando = "sort -r > nomi.ordinati"
+ print $1 | comando @}' mail-list
address@hidden example
+
+La lista non ordinata @`e scritta usando una ridirezione normale, mentre
+la lista ordinata @`e scritta inviando una @dfn{pipe} in input al programma
+di address@hidden @command{sort}.
+
+Il prossimo esempio usa la ridirezione per inviare un messaggio alla
+mailing list @code{bug-sistema}. Questo address@hidden tornare utile se si
hanno
+problemi con uno script @command{awk} eseguito periodicamente per la
+manutenzione del sistema:
+
address@hidden
+report = "mail bug-sistema"
+print("Script awk in errore:", $0) | report
+print("al record numero", FNR, "di", NOME_FILE) | report
+close(report)
address@hidden example
+
+La funzione @code{close()} @`e stata chiamata perch@'e @`e una buona idea
chiudere
+la @dfn{pipe} non appena tutto l'output da inviare alla @dfn{pipe} @`e stato
+inviato. @xref{Chiusura file e @dfn{pipe}}
+per maggiori informazioni.
+
+Questo esempio illustra anche l'uso di una variabile per rappresentare
+un @var{file} o un @var{comando}; non @`e necessario usare sempre
+una costante stringa. Usare una variabile @`e di solito una buona idea,
+perch@'e (se si vuole riusare lo stesso file o comando)
address@hidden richiede che il valore della stringa sia sempre scritto
+esattamente nello stesso modo.
+
address@hidden coprocessi
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden operatori, input/output
address@hidden differenze tra @command{awk} e @command{gawk}, operatori di
input/output
address@hidden print @var{elementi} |& @var{comando}
+Questa ridirezione stampa gli elementi nell'input di @var{comando}.
+La differenza tra questa ridirezione e quella
+con la sola @samp{|} @`e che l'output da @var{comando}
address@hidden essere letto tramite @code{getline}.
+Quindi, @var{comando} @`e un @dfn{coprocesso}, che lavora in parallelo al
+programma @command{awk}, ma @`e al suo servizio.
+
+Questa address@hidden @`e un'estensione @command{gawk}, e non @`e disponibile
in
+POSIX @command{awk}.
address@hidden
address@hidden coprocesso},
+per una breve spiegazione.
address@hidden/O bidirezionale}
+per un'esposizione address@hidden esauriente.
address@hidden ifnotdocbook
address@hidden
address@hidden coprocesso}
+per una breve spiegazione.
address@hidden/O bidirezionale}
+per un'esposizione address@hidden esauriente.
address@hidden ifdocbook
address@hidden table
+
+Ridirigere l'output usando @samp{>}, @samp{>>}, @samp{|} o @samp{|&}
+richiede al sistema di aprire un file, una @dfn{pipe} o un coprocesso solo se
+il particolare @var{file} o @var{comando} che si @`e specificato non @`e
address@hidden
+stato utilizzato in scrittura dal programma o se @`e stato chiuso
+dopo l'ultima scrittura.
+
address@hidden debug, stampare
address@hidden un errore comune usare la ridirezione @samp{>} per la prima
istruzione
address@hidden verso un file, e in seguito usare @samp{>>} per le successive
+scritture in output:
+
address@hidden
+# inizializza il file
+print "Non v'allarmate" > "guida.txt"
address@hidden
+# aggiungi in fondo al file
+print "Evitate generatori di address@hidden" >> "guide.txt"
address@hidden example
+
address@hidden
+Questo @`e il modo in cui le ridirezioni devono essere usate lavorando
+con la shell. Ma in @command{awk} address@hidden non @`e necessario. In casi
di questo
+genere, un programma dovrebbe
+usare @samp{>} per tutte le istruzioni @code{print}, perch@'e il file di
+output @`e aperto una sola volta.
+(Usando sia @samp{>} che @samp{>>} nello stesso programma, l'output @`e
prodotto
+nell'ordine atteso.
+Tuttavia il mischiare gli operatori per lo stesso file @`e sintomo di uno
+stile di programmazione inelegante, e address@hidden causare confusione in chi
legge
+il programma.)
+
address@hidden differenze tra @command{awk} e @command{gawk}, limitazioni di
implementazione
address@hidden problemi di implementazione, @command{gawk}, limitazioni
address@hidden @command{awk}, problemi di implementazione, @dfn{pipe}
address@hidden @command{gawk}, problemi di implementazione, @dfn{pipe}
address@hidden
+Come visto in precedenza
+(@pxref{Note su getline}),
+molte
address@hidden ifnotinfo
address@hidden
address@hidden
address@hidden
+Molte
address@hidden ifnothtml
address@hidden ifnotdocbook
address@hidden ifnottex
+tra le address@hidden vecchie implementazioni di
address@hidden limitano il numero di @dfn{pipeline} che un programma
address@hidden address@hidden mantenere aperte a una soltanto! In
@command{gawk}, non c'@`e
+un tale limite. @command{gawk} consente a un programma di
+aprire tante @dfn{pipeline} quante ne consente il sistema operativo su cui
+viene eseguito.
+
address@hidden sidebar, Inviare @dfn{pipe} alla @command{sh}
address@hidden
address@hidden
+<sidebar><title>Inviare @dfn{pipe} alla @command{sh}</title>
address@hidden docbook
+
address@hidden shell, inviare comandi tramite @dfn{pipe} alla
+
+Una maniera particolarmente efficace di usare la ridirezione @`e quella di
+preparare righe di comando da passare
+come @dfn{pipe} alla shell,
address@hidden Per esempio, si supponga di avere una lista di file provenienti
+da un sistema in cui tutti i
address@hidden sono memorizzari in maiuscolo, e di volerli rinominare
+in modo da avere nomi tutti in
+minuscolo. Il seguente programma @`e
+sia semplice che efficiente:
+
address@hidden @cindex @command{mv} utility
address@hidden
address@hidden printf("mv %s %s\n", $0, tolower($0)) | "sh" @}
+
+END @{ close("sh") @}
address@hidden example
+
+La funzione @code{tolower()} restituisce la stringa che gli viene passata
+come argomento con tutti i caratteri maiuscoli convertiti in minuscolo
+(@pxref{Funzioni per stringhe}).
+Il programma costruisce una lista di righe di comando,
+usando il programma di address@hidden @command{mv} per rinominare i file.
+Poi invia la lista alla shell per l'elaborazione.
+
address@hidden alla shell} per una funzione che address@hidden essere utile nel
generare
+righe di comando da passare alla shell.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Inviare @dfn{pipe} alla @command{sh}}
+
+
address@hidden shell, inviare comandi tramite @dfn{pipe} alla
+
+Una maniera particolarmente efficace di usare la ridirezione @`e quella di
+preparare righe di comando da passare
+come @dfn{pipe} alla shell,
address@hidden Per esempio, si supponga di avere una lista di file provenienti
+da un sistema in cui tutti i
address@hidden sono memorizzari in maiuscolo, e di volerli rinominare
+in modo da avere nomi tutti in
+minuscolo. Il seguente programma @`e
+sia semplice che efficiente:
+
address@hidden @cindex @command{mv} utility
address@hidden
address@hidden printf("mv %s %s\n", $0, tolower($0)) | "sh" @}
+
+END @{ close("sh") @}
address@hidden example
+
+La funzione @code{tolower()} restituisce la stringa che gli viene passata
+come argomento con tutti i caratteri maiuscoli convertiti in minuscolo
+(@pxref{Funzioni per stringhe}).
+Il programma costruisce una lista di righe di comando,
+usando il programma di address@hidden @command{mv} per rinominare i file.
+Poi invia la lista alla shell per l'elaborazione.
+
address@hidden alla shell} per una funzione che address@hidden essere utile nel
generare
+righe di comando da passare alla shell.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden FD speciali
address@hidden File speciali per flussi standard di dati pre-aperti
address@hidden standard input
address@hidden input, standard
address@hidden standard output
address@hidden output, standard
address@hidden errore, output
address@hidden standard error
address@hidden descrittori di file
address@hidden file, descrittori, si veda descrittori di file
+
+I programmi in esecuzione hanno convenzionalmente tre flussi di input e
+output a disposizione, address@hidden aperti per la lettura e la scrittura.
+Questi sono noti come
+lo @dfn{standard input}, lo @dfn{standard output} e lo @dfn{standard
+error output}. A questi flussi aperti (e a tutti gli altri file aperti o
address@hidden) si fa spesso riferimento usando il termine tecnico
address@hidden di file} [FD].
+
+Questi flussi sono, per default, associati alla tastiera e allo schermo,
+ma spesso sono ridiretti, nella shell, utilizzando gli operatori
address@hidden<}, @samp{<<}, @samp{>}, @samp{>>}, @samp{>&} e @samp{|}.
+Lo standard error @`e tipicamente usato per scrivere messaggi di errore;
+la ragione per cui ci sono due flussi distinti,
+standard output e standard error, @`e per poterli ridirigere indipendentemente
+l'uno dall'altro.
+
address@hidden differenze tra @command{awk} e @command{gawk}, messaggi di errore
address@hidden gestione errori
address@hidden errori, gestione degli
+Nelle tradizionali implementazioni di @command{awk}, il solo modo per
+scrivere un messaggio di errore allo
+standard error in un programma @command{awk} @`e il seguente:
+
address@hidden
+print "Ho trovato un errore grave!" | "cat 1>&2"
address@hidden example
+
address@hidden
+Con quest'istruzione si apre una @dfn{pipeline} verso un comando della shell
+che @`e in grado di accedere al flusso di standard error che eredita dal
+processo @command{awk}.
address@hidden 8/2014: Mike Brennan says not to cite this as inefficient. So,
fixed.
+Questo @`e molto poco elegante, e richiede anche di innescare un processo
+separato. Per questo chi scrive programmi @command{awk} spesso
+non usa questo metodo. Invece, invia i messaggi di errore allo
+schermo, in questo modo:
+
address@hidden
+print "Ho trovato un errore grave!" > "/dev/tty"
address@hidden example
+
address@hidden
+(@file{/dev/tty} @`e un file speciale fornito dal sistema operativo
+ed @`e connesso alla tastiera e allo schermo. Rappresenta il
+``terminale'',@footnote{``tty'' in @file{/dev/tty} @`e un'abbreviazione di
+``TeleTYpe'' [telescrivente], un terminale seriale.} che nei sistemi odierni
address@hidden una tastiera e uno schermo, e non una @dfn{console} seriale).
+Questo ha generalmente lo stesso effetto, ma non @`e sempre detto: sebbene il
+flusso di standard error sia solitamente diretto allo schermo, potrebbe
+essere stato
+ridiretto; se questo @`e il caso, scrivere verso lo schermo non serve. In
+effetti, se @command{awk} @`e chiamato da un lavoro che non @`e eseguito
+interattivamente,
address@hidden non avere a disposizione alcun terminale su cui scrivere.
+In quel caso, l'apertura di @file{/dev/tty} genera un errore.
+
address@hidden, BWK @command{awk}, e @command{mawk} mettono a disposizione
+speciali @value{FNS} per accedere ai tre flussi standard.
+Se il @value{FN} coincide con uno di questi nomi speciali, quando
address@hidden (o uno degli altri) ridirige l'input o l'output, usa
+direttamente il descrittore di file identificato dal @value{FN}. Questi
address@hidden sono gestiti address@hidden@dotless{i}} in tutti i sistemi
operativi nei quali
address@hidden @`e disponibile, e non solo in quelli che aderiscono allo
+standard POSIX:
+
address@hidden estensioni comuni, file speciale @code{/dev/stdin}
address@hidden estensioni comuni, file speciale @code{/dev/stdout}
address@hidden estensioni comuni, file speciale @code{/dev/stderr}
address@hidden @cindex comuni, address@hidden file speciale @code{/dev/stdin}
address@hidden @cindex comuni, address@hidden file speciale @code{/dev/stdout}
address@hidden @cindex comuni, address@hidden file speciale @code{/dev/stderr}
address@hidden nomi di file, flussi standard in @command{gawk}
address@hidden @code{/dev/@dots{}}, file speciali
address@hidden file, file speciali @code{/dev/@dots{}}
address@hidden @code{/dev/fd/@var{N}}, file speciali (in @command{gawk})
address@hidden @file
address@hidden /dev/stdin
+Lo standard input (descrittore di file 0).
+
address@hidden /dev/stdout
+Lo standard output (descrittore di file 1).
+
address@hidden /dev/stderr
+Lo standard error output (descrittore di file 2).
address@hidden table
+
+Usando questa address@hidden
+la maniera corretta di scrivere un messaggio di errore diviene quindi:
+
address@hidden
+print "Ho trovato un errore grave!" > "/dev/stderr"
address@hidden example
+
address@hidden debug, doppio apice con nomi di file
+Si noti l'uso di doppi apici per racchiudere il @value{FN}.
+Come per ogni altra ridirezione, il valore dev'essere una stringa.
address@hidden un errore comune omettere i doppi apici, il che conduce a
+risultati inattesi.
+
address@hidden non tratta questi @value{FNS} come speciali quando opera
+in address@hidden di address@hidden POSIX. Comunque, poich@'e BWK
@command{awk}
+li prevede, @command{gawk} li ammette anche quando viene
+invocato con l'opzione @option{--traditional} (@pxref{Opzioni}).
+
address@hidden File speciali
address@hidden @value{FFNS} speciali in @command{gawk}
address@hidden @command{gawk}, nomi di file in
+
+Oltre all'accesso a standard input, standard output e standard error,
address@hidden consente di accedere a ogni descrittore di file aperto.
+In address@hidden, ci sono dei @value{FNS} speciali riservati per accedere a
+reti TCP/IP.
+
address@hidden
+* Altri file ereditati:: Accedere ad altri file aperti con
+ @command{gawk}.
+* Reti speciali:: File speciali per comunicazioni con la rete.
+* Avvertimenti speciali:: Cose a cui prestare attenzione.
address@hidden menu
+
address@hidden Altri file ereditati
address@hidden Accedere ad altri file aperti con @command{gawk}
+
+Oltre ai valori speciali di @value{FNS}
address@hidden/dev/stdin}, @code{/dev/stdout} e @code{/dev/stderr}
address@hidden menzionati, @command{gawk} prevede una sintassi
+per accedere a ogni altro file aperto ereditato:
+
address@hidden @file
address@hidden /dev/fd/@var{N}
+Il file associato al descrittore di file @var{N}. Il file indicato deve
+essere aperto dal programma che inizia l'esecuzione di @command{awk}
+(tipicamente la shell). Se non sono state poste in essere iniziative
+speciali nella shell da cui @command{gawk} @`e stato invocato, solo i
+descrittori 0, 1, e 2 sono disponibili.
address@hidden table
+
+I @value{FNS} @file{/dev/stdin}, @file{/dev/stdout} e @file{/dev/stderr}
+sono essenzialmente alias per @file{/dev/fd/0}, @file{/dev/fd/1} e
address@hidden/dev/fd/2}, rispettivamente. Comunque, i primi nomi sono
address@hidden
+autoesplicativi.
+
+Si noti che l'uso di @code{close()} su un @value{FN} della forma
address@hidden"/dev/fd/@var{N}"}, per numeri di descrittore di file
+oltre il due, effettivamente chiude il descrittore di file specificato.
+
address@hidden Reti speciali
address@hidden File speciali per comunicazioni con la rete
address@hidden reti, address@hidden per
address@hidden TCP/IP, address@hidden per
+
+I programmi @command{gawk}
+possono aprire una connessione bidirezionale
+TCP/IP, fungendo o da @dfn{client} o da @dfn{server}.
+Questo avviene usando uno speciale @value{FN} della forma:
+
address@hidden
address@hidden/@var{tipo-rete}/@var{protocollo}/@var{porta-locale}/@var{host-remoto}/@var{porta-remota}}
address@hidden example
+
+il @var{tipo-rete} address@hidden essere @samp{inet}, @samp{inet4} o
@samp{inet6}.
+Il @var{protocollo} address@hidden essere @samp{tcp} o @samp{udp},
+e gli altri campi rappresentano gli altri dati essenziali
+necessari per realizzare una connessione di rete.
+Questi @value{FNS} sono usati con l'operatore @samp{|&} per comunicare
+con un coprocesso
+(@pxref{I/O bidirezionale}).
+Questa @`e una address@hidden avanzata, qui riferita solo per completezza.
+Una spiegazione esauriente address@hidden fornita nella
address@hidden TCP/IP}.
+
address@hidden Avvertimenti speciali
address@hidden Avvertimenti speciali sui @value{FNS}
+
+Sono qui elencate alcune cose da tener presente usando i
address@hidden speciali forniti da @command{gawk}:
+
address@hidden @value{BULLET}
address@hidden address@hidden compatibile di (@command{gawk}), nomi di file
address@hidden nomi di file, nella address@hidden compatibile di @command{gawk}
address@hidden
+Il riconoscimento dei @value{FNS} per i tre file standard pre-aperti
address@hidden disabilitato solo in address@hidden POSIX.
+
address@hidden
+Il riconoscimento degli altri @value{FNS} speciali @`e disabilitato se
address@hidden @`e in address@hidden compatibile
+(o @option{--traditional} o @option{--posix};
address@hidden).
+
address@hidden
address@hidden interpreta @emph{sempre}
+questi @value{FNS} speciali.
+Per esempio, se si usa @samp{/dev/fd/4}
+per l'output, si scrive realmente sul descrittore di file 4, e non su un nuovo
+descrittore di file generato duplicando (con @code{dup()}) il descrittore
+file 4. Solitamente questo non ha importanza; comunque, @`e importante
address@hidden chiudere alcun file correlato ai descrittori di file 0, 1 e 2.
+Se lo si fa, il comportamente risultante @`e imprevedibile.
address@hidden itemize
+
address@hidden Chiusura file e @dfn{pipe}
address@hidden Chiudere ridirezioni in input e in output
address@hidden output, file in, si veda file in output
address@hidden input, file in, chiusura
address@hidden output, file in, chiusura
address@hidden @dfn{pipe}, chiusura
address@hidden coprocessi, chiusura
address@hidden @code{getline}, comando, address@hidden usare dal
+
+Se lo stesso @value{FN} o lo stesso comando di shell @`e usato con
@code{getline}
address@hidden di una volta durante l'esecuzione di un programma @command{awk}
+(@pxref{Getline}),
+il file viene aperto (o il comando viene eseguito) solo la prima volta.
+A quel punto, il primo record in input @`e letto da quel file o comando.
+La prossima volta che lo stesso file o comando @`e usato con @code{getline},
+un altro record @`e letto da esso, e address@hidden@dotless{i}} via.
+
+Analogamente, quando un file o una @dfn{pipe} sono aperti in output,
address@hidden ricorda
+il @value{FN} o comando a essi associato, e le successive
+scritture verso lo stesso file o comando sono accodate alle precedenti
+scritture.
+Il file o la @dfn{pipe} rimangono aperti fino al termine dell'esecuzione
+di @command{awk}.
+
address@hidden
+Questo implica che sono necessari dei passi speciali per rileggere nuovamente
+lo stesso file dall'inizio, o per eseguire di nuovo un comando di shell
+(invece che leggere ulteriore output dal precedente comando). La funzione
address@hidden()} rende possibile fare queste cose:
+
address@hidden
+close(@var{NOME_FILE})
address@hidden example
+
address@hidden
+o:
+
address@hidden
+close(@var{comando})
address@hidden example
+
+l'argomento @var{NOME_FILE} o @var{comando} address@hidden essere qualsiasi
espressione,
+il cui valore dev'essere @emph{esattamente} uguale alla stringa
+usata per aprire il file o eseguire il comando (spazi e altri caratteri
+``irrilevanti'' inclusi). Per esempio, se si apre una @dfn{pipe}
address@hidden@dotless{i}}:
+
address@hidden
+"sort -r nomi" | getline pippo
address@hidden example
+
address@hidden
+essa va chiusa in questo modo:
+
address@hidden
+close("sort -r nomi")
address@hidden example
+
+Una volta eseguita questa chiamata di funzione, la successiva @code{getline}
+da quel file o comando, o la successiva @code{print} o @code{printf} verso quel
+file o comando, riaprono il file o eseguono nuovamente il comando.
+Poich@'e l'espressione da usare per chiudere un file o una @dfn{pipeline} deve
+essere uguale all'espressione usata per aprire il file o eseguire il comando,
address@hidden buona norma usare una variabile che contenga il @value{FN} o il
comando.
+Il precedente esempio cambia come segue:
+
address@hidden
+sortcom = "sort -r nomi"
+sortcom | getline pippo
address@hidden
+close(sortcom)
address@hidden example
+
address@hidden
+Questo aiuta a evitare nei programmi @command{awk} errori di battitura
+difficili da scoprire. Queste sono alcune delle ragioni per cui @`e bene
+chiudere un file di output:
+
address@hidden @value{BULLET}
address@hidden
+Scrivere un file e rileggerlo in seguito all'interno dello stesso programma
address@hidden Occorre chiudere il file dopo aver finito di scriverlo, e poi
+iniziare a rileggerlo con @code{getline}.
+
address@hidden
+Per scrivere numerosi file, uno dopo l'altro, nello stesso programma
address@hidden Se i file non vengono chiusi, prima o poi @command{awk}
address@hidden
+superare il limite di sistema per il numero di file aperti in un processo.
address@hidden meglio chiudere ogni file quando il programma ha finito di
scriverlo.
+
address@hidden
+Per terminare un comando. Quando l'output @`e ridiretto usando una @dfn{pipe},
+il comando che legge la @dfn{pipe} normalmente continua a tentare di leggere
+input finch@'e la @dfn{pipe} rimane aperta. Spesso questo vuol dire che
+il comando non address@hidden eseguire il compito a lui assegnato finch@'e la
@dfn{pipe}
+non viene chiusa. Per esempio, se l'output @`e ridiretto al programma
address@hidden, il messaggio non @`e effettivamente inviato finch@'e la
@dfn{pipe}
+non viene chiusa.
+
address@hidden
+Eseguire lo stesso programma una seconda volta, con gli stessi argomenti.
+Questo non equivale a fornire ulteriore input alla prima esecuzione!
+
+Per esempio, si supponga che una programma invii tramite una @dfn{pipe}
+dell'output al programma @command{mail}.
+Se invia parecchie linee ridirigendole a questa @dfn{pipe} senza chiuderla,
+queste costituiscono un solo messaggio di parecchie righe. Invece, se il
+programma chiude la @dfn{pipe} dopo ogni riga dell'output, allora ogni riga
+costituisce un messaggio separato.
address@hidden itemize
+
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{close()}
address@hidden address@hidden, funzione @code{close()}
address@hidden funzione @code{close()}, address@hidden
address@hidden @code{close()}, funzione, address@hidden
+Se si usano file in numero superiore a quelli che il sistema permette
+di mantenere aperti,
address@hidden tenta di riutilizzare i file aperti disponibili fra
+i @value{DF}. La address@hidden che @command{gawk} lo faccia dipende dalle
address@hidden del sistema operativo, e quindi non @`e detto che questo riesca
+sempre. @`E quindi sia una buona pratica
+che un buon suggerimento per la address@hidden quello di usare sempre
address@hidden()} sui file, una volta che si @`e finito di operare su di essi.
+In effetti, se si usano molte @dfn{pipe}, @`e fondamentale che i comandi
+vengano chiusi, una volta finita la loro elaborazione. Per esempio, si
+consideri qualcosa del tipo:
+
address@hidden
address@hidden
+ @dots{}
+ comando = ("grep " $1 " /qualche/file | un_mio_programma -q " $3)
+ while ((comando | getline) > 0) @{
+ @var{elabora output di} comando
+ @}
+ # qui serve close(comando)
address@hidden
address@hidden example
+
+Questo esempio crea una nuova @dfn{pipeline} a seconda dei dati contenuti in
address@hidden record.
+Senza la chiamata a @code{close()} indicata come commento, @command{awk}
+genera processi-figlio per eseguire i comandi, fino a che non finisce per
+esaurire i descrittori di file
+necessari per creare ulteriori @dfn{pipeline}.
+
+Sebbene ogni comando sia stato completato (come si deduce dal codice di
+fine-file restituito dalla @code{getline}), il processo-figlio non @`e
+terminato;@footnote{La terminologia tecnica @`e piuttosto macabra.
+Il processo-figlio terminato @`e chiamato ``zombie,'' e la pulizia alla fine
+dello stesso @`e chiamata ``reaping'' [mietitura].}
address@hidden Good old UNIX: give the marketing guys fits, that's the ticket
+inoltre, e questo @`e address@hidden che address@hidden ci interessa, il
descrittore di file
+per la @dfn{pipe} non @`e chiuso e liberato finch@'e non si chiama
address@hidden()} o finch@'e il programma @command{awk} non termina.
+
address@hidden()} non fa nulla (e non emette messaggi) se le viene fornito come
+argomento una stringa che non rappresenta un file, una @dfn{pipe} o un
+coprocesso che sia stato aperto mediante una ridirezione. In quel caso,
address@hidden()} restituisce un valore di ritorno negativo, che indica un
+errore. Inoltre, @command{gawk} imposta @code{ERRNO}
+a una stringa che indica il tipo di errore.
+
+Si noti anche che @samp{close(NOME_FILE)} non ha effetti ``magici'' sul ciclo
+implicito che legge ogni record dei file indicati nella riga di comando.
+Si tratta, con ogni address@hidden, della chiusura di un file che non era mai
+stato aperto con una ridirezione,
+e per questo @command{awk} silenziosamente non fa nulla, tranne impostare un
+codice di ritorno negativo.
+
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O),
@address@hidden chiusura
+Quando si usa l'operatore @samp{|&} per comunicare con un coprocesso,
address@hidden talora utile essere in grado di chiudere un lato della @dfn{pipe}
+bidirezionale, senza chiudere l'altro lato.
+Questo @`e possibile fornendo un secondo argomento a @code{close()}.
+Come in ogni altra invocazione di @code{close()},
+il primo argomento @`e il nome del comando o file speciale usato
+per iniziare il coprocesso.
+Il secondo argomento dovrebbe essere una stringa, con uno dei due valori
address@hidden"to"} [a] oppure @code{"from"} [da]. Maiuscolo/minuscolo non fa
+differenza. Poich@'e questa @`e una address@hidden avanzata, la trattazione
@`e
+rinviata alla
address@hidden/O bidirezionale},
+che ne parla address@hidden dettagliatamente e fornisce un esempio.
+
address@hidden sidebar, Usare il valore di ritorno di @code{close()}
address@hidden
address@hidden
+<sidebar><title>Usare il valore di ritorno di @code{close()}</title>
address@hidden docbook
+
address@hidden angolo buio, funzione @code{close()}
address@hidden funzione @code{close()}, valore di ritorno
address@hidden @code{close()}, funzione, valore di ritorno
address@hidden valore di address@hidden funzione @code{close()}
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{close()}
address@hidden Unix @command{awk}, funzione @code{close()} e
+
+In molte versioni di Unix @command{awk}, la funzione @code{close()}
address@hidden in address@hidden un'istruzione.
address@hidden
address@hidden un errore di sintassi tentare di usare il valore
+di ritorno da @code{close()}:
+
address@hidden
+comando = "@dots{}"
+comando | getline info
+retval = close(comando) # errore di sintassi in parecchi Unix awk
address@hidden example
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden variabile @code{ERRNO}, con funzione @command{close()}
address@hidden @code{ERRNO}, variabile, con funzione @command{close()}
address@hidden gestisce @code{close()} come una funzione.
+Il valore di ritorno @`e @minus{}1 se l'argomento designa un file
+che non era mai stato aperto con una ridirezione, o se c'@`e un problema di
+sistema nella chiusura del file o del processo.
+In tal caso, @command{gawk} imposta la variabile predefinita
address@hidden a una stringa che descrive il problema.
+
+In @command{gawk}, a partire dalla @value{PVERSION} 4.2,
+quando si chiude una @dfn{pipe} o un coprocesso (in input o in output),
+il valore di ritorno @`e quello restituito dal comando,
+come descritto in @address@hidden
+della @value{PVERSION} 4.2, il valore di ritorno dopo la chiusura di
+una @dfn{pipe} o di un coprocesso era una cifra di due byte (16-bit),
+contenente il valore restituito dalla chiamata di sistema @code{wait()}}.
+Altrimenti, @`e il valore di ritorno dalla chiamata alle funzione
+di sistema @code{close()} o alla funzione C @code{fclose()}
+se si sta chiudendo un file in input o in output, rispettivamente.
+Questo valore @`e zero se la chiusura riesce, o @minus{}1 se non riesce.
+
address@hidden Tabella,table-close-pipe-return-values
address@hidden di ritorno dalla @code{close()} di una @dfn{pipe}}
address@hidden @columnfractions .50 .50
address@hidden Situazione @tab Valore restituito da @code{close()}
address@hidden Uscita normale dal comando @tab Il codice di ritorno del comando
address@hidden Uscita dal comando per @dfn{signal} @tab 256 + numero del
segnale assassino
address@hidden Uscita dal comando per @dfn{signal} con @dfn{dump} @tab 512 +
numero del segnale assassino
address@hidden Errore di qualsiasi tipo @tab @minus{}1
address@hidden multitable
address@hidden float
+
+Lo standard POSIX @`e molto generico; dice che @code{close()}
+restituisce zero se @`e terminata correttamente, e un valore diverso da zero
+nell'altro caso. In generale,
+implementazioni differenti variano in quel che restituiscono chiudendo una
address@hidden; quindi, il valore di ritorno non address@hidden essere usato in
modo
+portabile.
address@hidden
+In address@hidden POSIX (@pxref{Opzioni}), @command{gawk} restituisce solo zero
+quando chiude una @dfn{pipe}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Usare il valore di ritorno di @code{close()}}
+
+
address@hidden angolo buio, funzione @code{close()}
address@hidden funzione @code{close()}, valore di ritorno
address@hidden @code{close()}, funzione, valore di ritorno
address@hidden valore di address@hidden funzione @code{close()}
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{close()}
address@hidden Unix @command{awk}, funzione @code{close()} e
+
+In molte versioni di Unix @command{awk}, la funzione @code{close()}
address@hidden in address@hidden un'istruzione.
address@hidden
address@hidden un errore di sintassi tentare di usare il valore
+di ritorno da @code{close()}:
+
address@hidden
+comando = "@dots{}"
+comando | getline info
+retval = close(comando) # errore di sintassi in parecchi Unix awk
address@hidden example
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden variabile @code{ERRNO}, con funzione @command{close()}
address@hidden @code{ERRNO}, variabile, con funzione @command{close()}
address@hidden gestisce @code{close()} come una funzione.
+Il valore di ritorno @`e @minus{}1 se l'argomento designa un file
+che non era mai stato aperto con una ridirezione, o se c'@`e un problema di
+sistema nella chiusura del file o del processo.
+In tal caso, @command{gawk} imposta la variabile predefinita
address@hidden a una stringa che descrive il problema.
+
+In @command{gawk}, a partire dalla @value{PVERSION} 4.2,
+quando si chiude una @dfn{pipe} o un coprocesso (in input o in output),
+il valore di ritorno @`e quello restituito dal comando,
+come descritto in @address@hidden
+della @value{PVERSION} 4.2, il valore di ritorno dopo la chiusura di
+una @dfn{pipe} o di un coprocesso era una cifra di due byte (16-bit),
+contenente il valore restituito dalla chiamata di sistema @code{wait()}}.
+Altrimenti, @`e il valore di ritorno dalla chiamata alle funzione
+di sistema @code{close()} o alla funzione C @code{fclose()}
+se si sta chiudendo un file in input o in output, rispettivamente.
+Questo valore @`e zero se la chiusura riesce, o @minus{}1 se non riesce.
+
address@hidden Tabella,table-close-pipe-return-values
address@hidden di ritorno dalla @code{close()} di una @dfn{pipe}}
address@hidden @columnfractions .50 .50
address@hidden Situazione @tab Valore restituito da @code{close()}
address@hidden Uscita normale dal comando @tab Il codice di ritorno del comando
address@hidden Uscita dal comando per @dfn{signal} @tab 256 + numero del
segnale assassino
address@hidden Uscita dal comando per @dfn{signal} con @dfn{dump} @tab 512 +
numero del segnale assassino
address@hidden Errore di qualsiasi tipo @tab @minus{}1
address@hidden multitable
address@hidden float
+
+Lo standard POSIX @`e molto generico; dice che @code{close()}
+restituisce zero se @`e terminata correttamente, e un valore diverso da zero
+nell'altro caso. In generale,
+implementazioni differenti variano in quel che restituiscono chiudendo una
address@hidden; quindi, il valore di ritorno non address@hidden essere usato in
modo
+portabile.
address@hidden
+In address@hidden POSIX (@pxref{Opzioni}), @command{gawk} restituisce solo zero
+quando chiude una @dfn{pipe}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Continuazione dopo errori
address@hidden Abilitare continuazione dopo errori in output
+
+Questa @value{SECTION} descrive una address@hidden specifica di @command{gawk}.
+
+In @command{awk} standard, l'output con @code{print} o @code{printf}
+a un file che non esiste, o qualche altro errore di I/O (come p.es.
+esaurire lo spazio disponibile su disco) @`e un errore fatale (termina
+l'esecuzione del programma).
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print "ciao" > "/file/non/esistente" @}'}
address@hidden gawk: riga com.:1: fatale: non riesco a ri-dirigere a
address@hidden `/file/non/esistente' (/file o directory non esistente)
address@hidden example
+
address@hidden rende possibile accorgersi che c'@`e stato un errore,
+permettendo di tentare di rimediare, o almeno di stampare un messaggio
+di errore prima di terminare il programma.
address@hidden possibile fare questo in due modi differenti:
+
address@hidden @bullet
address@hidden
+Per tutti i file in output, assegnando un valore qualsiasi a
address@hidden"NONFATAL"]}.
+
address@hidden
+Specificamente per un solo file, assegnando un valore qualsiasi a
address@hidden@var{nome_file}, "NONFATAL"]}.
address@hidden @`e il nome del file per il quale
+si desidera che l'errore di output non faccia terminare il programma.
address@hidden itemize
+
+Una volta abilitata la continuazione dopo un errore di output, si
address@hidden
+controllare la variabile @code{ERRNO} dopo ogni istruzione
address@hidden o @code{printf} diretta a quel file, per controllare che
+tutto sia andato a buon fine. @`E anche una buona idea inizializzare
address@hidden a zero prima di tentare l'operazione di scrittura.
+Per esempio:
+
address@hidden
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{ PROCINFO["NONFATAL"] = 1}
+> @kbd{ ERRNO = 0}
+> @kbd{ print "ciao" > "/file/non/esistente"}
+> @kbd{ if (ERRNO) @{}
+> @kbd{ print("Output non riuscito:", ERRNO) > "/dev/stderr"}
+> @kbd{ exit 1}
+> @kbd{ @}}
+> @address@hidden'}
address@hidden Output non riuscito: No such file or directory
address@hidden example
+
address@hidden non genera un errore fatale; permette invece
+al programma @command{awk} di rendersi conto del problema e di gestirlo.
+
+Questo meccanismo si applica anche allo standard output e allo standard error.
+Per lo standard output, si address@hidden usare @code{PROCINFO["-",
"NONFATAL"]}
+o @code{PROCINFO["/dev/stdout", "NONFATAL"]}.
+Per lo standard error, occorre
+usare @code{PROCINFO["/dev/stderr", "NONFATAL"]}.
+
+Se si tenta di aprire un @dfn{socket} TCP/IP (@pxref{Reti TCP/IP}),
address@hidden tenta di farlo per un certo numero di volte.
+La variabile d'ambiente @env{GAWK_SOCK_RETRIES}
+(@pxref{Altre variabili d'ambiente}) consente di alterare il numero di
+tentativi che @command{gawk} farebbe per default. Tuttavia,
+una volta abilitata la continuazione dopo un errore di I/O per un certo
address@hidden, @command{gawk} si limita a un solo tentativo,
+lasciando al codice del programma @command{awk} il compito di gestire
+l'eventuale problema.
+
address@hidden Sommario di Output
address@hidden Sommario.
+
address@hidden @value{BULLET}
address@hidden
+L'istruzione @code{print} stampa una lista di espressioni separate da virgole.
+Le espressioni sono separate tra loro dal valore di @code{OFS} e completate
+dal valore di @code{ORS}. @code{OFMT} fornisce il formato di conversione
+dei valori numerici per l'istruzione @code{print}.
+
address@hidden
+L'istruzione @code{printf} fornisce un controllo address@hidden preciso
sull'output,
+con lettere di controllo del formato per diversi tipi di dati e vari
+modificatori
+che cambiano il comportamento delle lettere di controllo del formato.
+
address@hidden
+L'output sia di @code{print} che di @code{printf} address@hidden essere
ridiretto a
+file, @dfn{pipe}, e coprocessi.
+
address@hidden
address@hidden fornisce @value{FNS} speciali per accedere allo
+standard input, standard output e standard error, e per comunicazioni di rete.
+
address@hidden
+Usare @code{close()} per chiudere file aperti, @dfn{pipe} e ridirezioni a
+coprocessi.
+Per i coprocessi, @`e possibile chiudere anche soltanto una delle due
+direzioni di comunicazione.
+
address@hidden
+Normalmente se si verificano errori eseguendo istruzioni @code{print} o
address@hidden, questi causano la fine del programma.
address@hidden consente di proseguire l'elaborazione anche in questo
+caso, o per un errore su qualsiasi file in output, o per un errore
+relativo a qualche file in particolare.
+Resta a carico del programma controllare se si sono verificati errori
+dopo l'esecuzione di ogni istruzione di output interessata.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi su Output
address@hidden Esercizi
+
address@hidden
address@hidden
+Riscrivere il programma:
+
address@hidden
+awk 'BEGIN @{ print "Mese Contenitori"
+ print "----- -----------" @}
+ @{ print $1, $2 @}' inventory-shipped
address@hidden example
+
address@hidden
+come
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di output}, usando un nuovo valore per @code{OFS}.
+
address@hidden
+Usare l'istruzione @code{printf} per allineare le intestazioni e i dati
+della tabella
+per il file di esempio @file{inventory-shipped} utilizzato nella @ref{Print}.
+
address@hidden
+Spiegare cosa succede se si dimenticano i doppi apici ridirigendo l'output,
+come nel caso che segue:
+
address@hidden
+BEGIN @{ print "Ho trovato un errore grave!" > /dev/stderr @}
address@hidden example
+
address@hidden enumerate
address@hidden EXCLUDE END
+
+
address@hidden Espressioni
address@hidden Espressioni
address@hidden espressioni
+
+Le espressioni sono i mattoni fondamentali dei modelli di ricerca e delle
+azioni di @command{awk}. Un'espressione genera un valore che si
address@hidden stampare, verificare o passare a una funzione. Oltre a
address@hidden, un'espressione
address@hidden assegnare un nuovo valore a una variabile o a un campo usando un
operatore
+di assegnamento.
+
+Un'espressione address@hidden servire come modello di ricerca o istruzione di
azione a
+s@'e stante. La maggior parte degli altri tipi di istruzione contengono una o
address@hidden espressioni che specificano i dati sui quali operare. Come in
altri
+linguaggi, le espressioni in @command{awk} possono includere variabili,
+riferimenti a vettori e a costanti, e chiamate di funzione, come pure
+combinazioni tra questi usando diversi operatori.
+
address@hidden
+* Valori:: Costanti, variabili ed espressioni regolari.
+* Tutti gli operatori:: Gli operatori di @command{gawk}.
+* Valori e condizioni di address@hidden:: Determinare Vero/Falso.
+* Chiamate di funzione:: Una chiamata di funzione address@hidden essere
+ un'espressione.
+* Precedenza:: Come si nidificano i vari operatori.
+* Localizzazioni:: Come la localizzazione influenza la
+ gestione dati.
+* Sommario delle espressioni:: Sommario delle espressioni.
address@hidden menu
+
address@hidden Valori
address@hidden Costanti, variabili e conversioni
+
+Le espressioni sono costruite a partire da valori e dalle operazioni eseguite
+su di essi. Questa @value{SECTION} descrive gli oggetti elementari
+che forniscono i valori usati nelle espressioni.
+
address@hidden
+* Costanti:: Costanti di tipo stringa, numeriche ed
+ espressioni regolari
+* Usare le costanti @dfn{regexp}:: Quando e come usare una costante
+ specificata tramite espressioni regolari
+* Variabili:: Le variabili permettono di
+ definire valori da usare in seguito.
+* Conversione:: La conversione di stringhe in numeri
+ e viceversa.
address@hidden menu
+
address@hidden Costanti
address@hidden Espressioni costanti
+
address@hidden costanti, tipi di
+
+Il tipo di espressione address@hidden semplice @`e una @dfn{costante}, che ha
sempre lo
+stesso valore. Ci sono tre tipi di costanti: numeriche, di stringa e di
+espressione regolare.
+
+Ognuna di esse si usa nel contesto appropriato quando occorre assegnare ai
+dati un valore che non address@hidden essere cambiato. Le costanti numeriche
possono
+avere forme diverse, ma sono memorizzate internamente sempre allo stesso modo.
+
address@hidden
+* Costanti scalari:: Costanti numeriche e stringhe.
+* Numeri non-decimali:: Cosa sono i numeri ottali ed esadecimali.
+* Costanti come espressioni regolari:: Costanti fornite tramite espressioni
+ regolari.
address@hidden menu
+
address@hidden Costanti scalari
address@hidden Costanti numeriche e stringhe
+
address@hidden costanti numeriche
address@hidden numeriche, costanti
+Una @dfn{costante numerica} @`e un numero. Questo numero address@hidden
essere un
+numero intero, una frazione decimale o un numero in notazione scientifica
+(esponenziale)address@hidden rappresentazione interna di tutti i numeri,
+compresi gli interi, usa numeri in virgola mobile a doppia precisione.
+Sui sistemi address@hidden moderni, questi sono nel formato standard IEEE 754.
address@hidden con precisione arbitraria}, per maggiori informazioni.}
+Ecco alcuni esempi di costanti numeriche che hanno tutte lo stesso
+valore:
+
address@hidden
+105
+1.05e+2
+1050e-1
address@hidden example
+
address@hidden costanti stringa
+Una @dfn{costante stringa} @`e formata da una sequenza di caratteri racchiusi
tra
+doppi apici. Per esempio:
+
address@hidden
+"pappagallo"
address@hidden example
+
address@hidden
address@hidden differenze tra @command{awk} e @command{gawk}, stringhe
address@hidden stringhe, limitazioni della lunghezza
+rappresenta la stringa il cui contenuto @`e la parola @samp{pappagallo}.
+Le stringhe in
address@hidden possono essere di qualsiasi lunghezza, e possono contenere
+tutti i possibili caratteri ASCII a otto bit, compreso il carattere ASCII
address@hidden (carattere con codice zero).
+Altre implementazioni di @command{awk} possono avere address@hidden con alcuni
+particolari codici di carattere.
+
address@hidden Numeri non-decimali
address@hidden Numeri ottali ed esadecimali
address@hidden ottali, numeri
address@hidden esadecimali, numeri
address@hidden numeri ottali
address@hidden numeri esadecimali
+
+In @command{awk}, tutti i numeri sono espressi nel sistema decimale
(address@hidden a
+base 10).
+Molti altri linguaggi di programmazione consentono di specificare i numeri in
+altre basi, spesso in ottale (base 8) e in esadecimale (base 16).
+Nel sistema ottale i numeri hanno la sequenza 0, 1, 2, 3, 4, 5, 6, 7, 10, 11,
+12, e address@hidden@dotless{i}} via. Come @samp{11} decimale @`e una volta
10 address@hidden 1, address@hidden@dotless{i}}
address@hidden ottale @`e una volta 8 address@hidden 1. Questo equivale a 9 nel
sistema decimale.
+Nell'esadecimale ci sono 16 cifre. Poich@'e l'usuale sistema numerico decimale
+ha solo dieci cifre (@address@hidden), le lettere da
address@hidden a @samp{f} rappresentano le cifre ulteriori.
+(normalmente @`e irrilevante se le lettere sono maiuscole o minuscole; gli
+esadecimali @samp{a} e @samp{A} hanno lo stesso valore).
address@hidden@dotless{i}}, @samp{11} esadecimale @`e 1 volta 16 address@hidden
1,
+il che equivale a 17 decimale.
+
+Guardando solamente un @samp{11} puro e semplice, non si capisce in quale base
+sia. address@hidden@dotless{i}}, in C, C++, e in altri linguaggi derivati da
C,
address@hidden such as PERL, but we won't mention that....
+c'@`e una speciale notazione per esprimere la base.
+I numeri ottali iniziano con uno @samp{0},
+e i numeri esadecimali iniziano con uno @samp{0x} o @samp{0X}:
+
address@hidden @code
address@hidden 11
+Valore decimale 11
+
address@hidden 011
+11 ottale, valore decimale 9
+
address@hidden 0x11
+11 esadecimale, valore decimale 17
address@hidden table
+
+Quest'esempio mostra le differenze:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "%d, %d, %d\n", 011, 11, 0x11 @}'}
address@hidden 9, 11, 17
address@hidden example
+
+Poter usare costanti ottali ed esadecimali nei propri programmi @`e molto utile
+quando si lavora con dati che non possono essere rappresentati
+convenientemente come caratteri o come numeri regolari, come i dati binari di
+vario tipo.
+
address@hidden @command{gawk}, numeri ottali e
address@hidden @command{gawk}, numeri esadecimali e
address@hidden permette l'uso di costanti ottali ed esadecimali nel testo di
+un programma. Comunque, se numeri non-decimali sono presenti tra i dati in
+input, essi non sono trattati in maniera speciale; trattarli in modo speciale
+per default significherebbe che vecchi programmi @command{awk} produrrebbero
+risultati errati.
+(Se si vuole che i numeri siano trattati in maniera speciale, si deve
+specificare l'opzione da riga di comando
address@hidden;
address@hidden non decimali}.)
+Se si devono gestire dati ottali o esadecimali,
+si address@hidden usare la funzione @code{strtonum()}
+(@pxref{Funzioni per stringhe})
+per convertire i dati in numeri.
+La maggior parte delle volte, le costanti ottali o esadecimali si usano quando
+si lavora con le funzioni predefinite di manipolazione di bit;
+si veda @ref{Funzioni a livello di bit}
+per maggiori informazioni.
+
+Diversamente da alcune tra le prime implementazioni di C, @samp{8} e @samp{9}
+non sono cifre valide nelle costanti ottali. Per esempio, @command{gawk}
+tratta @samp{018} come un 18 decimale:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print "021 @`e", 021 ; print 018 @}'}
address@hidden 021 @`e 17
address@hidden 18
address@hidden example
+
address@hidden address@hidden compatibile di (@command{gawk}), numeri ottali
address@hidden numeri ottali nella address@hidden compatibile di
(@command{gawk})
address@hidden address@hidden compatibile di (@command{gawk}), numeri
esadecimali
address@hidden numeri esadecimali nella address@hidden compatibile di
(@command{gawk})
address@hidden compatibile, address@hidden (@command{gawk}), numeri ottali
address@hidden compatibile, address@hidden (@command{gawk}), numeri esadecimali
+Le costanti ottali ed esadecimali nel codice sorgente sono un'estensione di
address@hidden Se @command{gawk} @`e in address@hidden compatibile
+(@pxref{Opzioni}),
+non sono disponibili.
+
address@hidden sidebar, La base di una costante non influisce sul suo valore
address@hidden
address@hidden
+<sidebar><title>La base di una costante non influisce sul suo valore</title>
address@hidden docbook
+
+
+Una volta che una costante numerica @`e stata
+convertita internamente in un numero [decimale],
address@hidden non considera address@hidden
+la forma originale della costante; viene sempre usato il valore
+interno. Questo ha delle precise conseguenze per la conversione dei
+numeri in stringhe:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "0x11 vale <%s>\n", 0x11 @}'}
address@hidden 0x11 vale <17>
address@hidden example
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{La base di una costante non influisce sul suo valore}
+
+
+
+Una volta che una costante numerica @`e stata
+convertita internamente in un numero [decimale],
address@hidden non considera address@hidden
+la forma originale della costante; viene sempre usato il valore
+interno. Questo ha delle precise conseguenze per la conversione dei
+numeri in stringhe:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "0x11 vale <%s>\n", 0x11 @}'}
address@hidden 0x11 vale <17>
address@hidden example
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Costanti come espressioni regolari
address@hidden Costanti fornite tramite espressioni regolari
+
address@hidden @dfn{regexp}, costanti
address@hidden costanti @dfn{regexp}
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
+Una @dfn{costante regexp} @`e la descrizione di un'espressione regolare
+delimitata
+da barre, come @address@hidden/^inizio e fine$/}}. La maggior parte delle
address@hidden usate nei programmi @command{awk} sono costanti, ma gli operatori
+di confronto @samp{~} e @samp{!~} possono confrontare anche @dfn{regexp}
+calcolate o dinamiche (che tipicamente sono solo stringhe ordinarie o
+variabili che contengono un'espressione regolare, ma potrebbero anche essere
+espressioni address@hidden complesse).
+
address@hidden Usare le costanti @dfn{regexp}
address@hidden Usare espressioni regolari come costanti
+
+Le costanti @dfn{regexp} sono costituite da testo che descrive un'espressione
+regolare, racchiusa fra barre (come p.e. @code{/la +risposta/}).
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta del comportamento di tali costanti in
+POSIX @command{awk} e in @command{gawk}, e prosegue descrivendo le
address@hidden @dfn{regexp} fortemente tipizzate}, che sono
+un'estensione @command{gawk}.
+
address@hidden
+* Costanti @dfn{regexp} normali:: Costanti @dfn{regexp} normali in
+ @command{awk}.
+* Costanti @dfn{regexp} forti:: Costanti @dfn{regexp} fortemente tipizzate.
address@hidden menu
+
address@hidden Costanti @dfn{regexp} normali
address@hidden Costanti @dfn{regexp} normali in @command{awk}.
+
address@hidden angolo buio, costanti @dfn{regexp}
+Quand'@`e usata a destra degli operatori @samp{~} o @samp{!~},
+una costante @dfn{regexp} rappresenta semplicemente l'espressione regolare che
+dev'essere confrontata. Comunque, le costanti @dfn{regexp} (come
@code{/pippo/})
+possono essere usate come semplici espressioni.
+Quando una
+costante @dfn{regexp} compare da sola, ha lo stesso significato di quando
+compare in un criterio di ricerca (address@hidden @samp{($0 ~ /pippo/)}).
address@hidden
address@hidden come criteri di ricerca}.
address@hidden vuol dire che i due frammenti di codice seguenti:
+
address@hidden
+if ($0 ~ /barfly/ || $0 ~ /camelot/)
+ print "trovato"
address@hidden example
+
address@hidden
+e:
+
address@hidden
+if (/barfly/ || /camelot/)
+ print "trovato"
address@hidden example
+
address@hidden
+sono esattamente equivalenti.
+Una conseguenza piuttosto bizzarra di questa regola @`e che la seguente
+espressione booleana @`e valida, ma non fa quel che probabilmente l'autore
+si aspettava:
+
address@hidden
+# Notare che /pippo/ @`e alla @emph{sinistra} della ~
+if (/pippo/ ~ $1) print "trovato pippo"
address@hidden example
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden @command{gawk}, costanti @dfn{regexp} e
address@hidden costanti @dfn{regexp}, in @command{gawk}
address@hidden
+Questo codice ``ovviamente'' intende verificare se @code{$1} contiene
+l'espressione regolare @code{/pippo/}. Ma in effetti l'espressione
address@hidden/pippo/ ~ $1} significa realmente @samp{($0 ~ /pippo/) ~ $1}. In
altre
+parole, prima confronta il record in input con l'espressione regolare
address@hidden/pippo/}. Il risultato @`e zero o uno, a seconda che il
confronto dia esito
+positivo o negativo. Questo risultato
address@hidden poi confrontato col primo campo nel record.
+Siccome @`e improbabile che qualcuno voglia mai fare realmente questo genere di
+test, @command{gawk} emette un avvertimento quando vede questo costrutto in
+un programma.
+Un'altra conseguenza di questa regola @`e che l'istruzione di assegnamento:
+
address@hidden
+confronta = /pippo/
address@hidden example
+
address@hidden
+assegna zero o uno alla variabile @code{confronta}, a seconda
+del contenuto del record in input corrente.
+
address@hidden differenze tra @command{awk} e @command{gawk}, costanti
@dfn{regexp}
address@hidden angolo buio, costanti @dfn{regexp}, come argomenti a funzioni
definite dall'utente
address@hidden
address@hidden
address@hidden
+Le espressioni regolari costanti possono essere usate anche come primo
+argomento delle
+funzioni @code{gensub()}, @code{sub()}, e @code{gsub()}, come secondo argomento
+della funzione @code{match()},
+e come terzo argomento delle funzioni @code{split()} e @code{patsplit()}
+(@pxref{Funzioni per stringhe}).
+Le moderne implementazioni di @command{awk}, incluso @command{gawk}, permettono
+di usare come terzo argomento di @code{split()} una costante @dfn{regexp}, ma
+alcune implementazioni address@hidden vecchie non lo consentono.
address@hidden
+Poich@'e alcune funzioni predefinite accettano costanti @dfn{regexp} come
+argomenti, address@hidden generare confusione l'uso di costanti @dfn{regexp}
come
+argomenti di funzioni definite dall'utente
+(@pxref{Funzioni definite dall'utente}). Per esempio:
+
address@hidden
+function mysub(modello, sostituzione, stringa, globale)
address@hidden
+ if (globale)
+ gsub(modello, sostituzione, stringa)
+ else
+ sub(modello, sostituzione, stringa)
+ return stringa
address@hidden
+
address@hidden
+ @dots{}
+ text = "salve! salve a te!"
+ mysub(/salve/, "ciao", text, 1)
+ @dots{}
address@hidden
address@hidden example
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
+In quest'esempio, il programmatore vuol passare una costante @dfn{regexp} alla
+funzione definita dall'utente @code{mysub()}, che a sua volta la passa o a
address@hidden()} o a @code{gsub()}. Comunque, quel che realmente succede @`e
che
+al parametro @code{modello} @`e assegnato un valore di uno o zero, a seconda
+che @code{$0} corrisponda a @code{/salve/} o no.
address@hidden emette un avvertimento quando vede una costante @dfn{regexp}
+usata come parametro di una funzione definita dall'utente, poich@'e
+passare un valore vero/falso in questo modo probabilmente non @`e quello che
+si intendeva fare.
+
address@hidden Costanti @dfn{regexp} forti
address@hidden Costanti @dfn{regexp} fortemente tipizzate
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden specifica di @command{gawk}.
+
+Come visto
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden
address@hidden
address@hidden ifdocbook
+precedente,
+le costanti @dfn{regexp} (@code{/@dots{}/}) hanno uno strano posto nel
+linguaggio @command{awk}. In molti contesti, si comportano come
+un'espressione:
address@hidden ~ /@dots{}/}. In altri contesti, denotano solo una @dfn{regexp}
da
+individuare. In nessun caso esse sono davvero ``cittadine di serie A'' del
+linguaggio. Ovvero, non @`e possibile definire una variabile scalare il cui
+tipo sia address@hidden'' nello stesso senso in cui si address@hidden definire
una
+variabile che sia un numero o una stringa:
+
address@hidden
+num = 42 @ii{Variabile numerica}
+str = "hi" @ii{Variabile di tipo stringa}
+re = /pippo/ @ii{Errore!} re @address@hidden il risultato di} $0 ~ /pippo/
address@hidden example
+
+Per alcuni casi di uso address@hidden avanzati,
+sarebbe bello poter avere costanti @dfn{regexp} che sono
address@hidden tipizzate}; in altre parole, che sostituiscono
+una @dfn{regexp} utile per effettuare dei confronti,
+e non una semplice espressione regolare.
+
address@hidden prevede questa address@hidden Un'espressione regolare
+fortemente tipizzata @`e molto simile a un'espressione regolare normale,
+tranne per il fatto di essere preceduta dal simbolo @samp{@@}:
+
address@hidden
+re = @@/foo/ @ii{variabile @dfn{regexp} fortemente tipizzata}
address@hidden example
+
+Le variabili @dfn{regexp} fortemente tipizzate @emph{non possono} essere
+usate in ogni istruzione in cui compare un'espressione regolare normale.
+perch@'e address@hidden renderebbe il linguaggio ancora address@hidden
fuorviante.
+Queste espressioni possono essere usate solo in alcuni contesti:
+
address@hidden @bullet
address@hidden
+Sul lato destro degli operatori @samp{~} e @samp{!~}:
address@hidden ~ @@/foo/}
+(@pxref{Uso di @dfn{regexp}}).
+
address@hidden
+Nella parte @code{case} di un'istruzione @code{switch}
+(@pxref{Istruzione switch}).
+
address@hidden
+Come argomento in una delle funzioni predefinite che possono utilizzare
+costanti @dfn{regexp}:
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()}
+e
address@hidden()}
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Come parametro in una chiamata a una funzione definita dall'utente
+(@pxref{Funzioni definite dall'utente}).
+
address@hidden
+Sul lato destro di un assegnamento di variabile:
address@hidden = @@/foo/}.
+In tal caso, @code{qualche_variabile} @`e di tipo @dfn{regexp}.
+Inoltre, @code{qualche_variabile}
address@hidden essere usata con gli operatori @samp{~} e @samp{!~}, passata a
una
+delle funzioni predefinite sopra elencate o passata come parametro
+a una funzione definita dall'utente.
address@hidden itemize
+
+Si address@hidden usare la funzione predefinita @code{typeof()}
+(@pxref{Funzioni per i tipi})
+per determinare se un parametro passato a una funzione
address@hidden una variabile di tipo @dfn{regexp}.
+
+La vera efficacia di questa address@hidden consiste nella address@hidden di
creare
+variabili il cui tipo @`e @dfn{regexp}. Tali variabili possono essere passate
+a funzioni definite dall'utente, senza gli inconvenenti che si hanno usando
+espressioni regolari calcolate, a partire da stringhe o da costanti di tipo
+stringa. Queste variabili possono anche essere passate utilizzando chiamate
+indirette a funzioni (@pxref{Chiamate indirette}) e alle funzioni predefinite
+che accettano costanti di tipo @dfn{regesp}.
+
+Quando sono usate per effettuare conversioni numeriche, le variabili
address@hidden fortemente tipizzate vengono convertite alla cifra zero.
+Quando sono usate per effettuare conversioni a stringhe, vengono convertite
+al valore di stringa del testo della @dfn{regexp} originale.
+
address@hidden Variabili
address@hidden Variabili
+
address@hidden variabili definite dall'utente
address@hidden definite dall'utente, variabili
+Le @dfn{variabili} consentono di memorizzare valori in un certo punto di un
+programma, per usarli address@hidden tardi in un'altra parte del programma.
Le variabili
+possono essere gestite interamente all'interno del testo del programma, ma
+ad esse possono essere assegnati valori sulla riga di comando, in fase di
+invocazione di @command{awk}.
+
address@hidden
+* Usare variabili:: Usare variabili nei propri programmi.
+* Opzioni di assegnamento:: Impostare variabili dalla riga di
+ comando, e un sommario della sintassi
+ della riga di comando.
+ Questo @`e un metodo di input avanzato.
address@hidden menu
+
address@hidden Usare variabili
address@hidden Usare variabili in un programma
+
+Le variabili permettono di dare nomi ai valori e di far riferimento ad essi in
+un secondo momento. Alcune variabili sono address@hidden state usate in molti
degli
+esempi.
+Il nome di una variabile dev'essere una sequenza di lettere, cifre o trattini
+bassi, e non deve iniziare con una cifra.
+Qui, una @dfn{lettera} @`e una qualsiasi delle 52 lettere maiuscole e minuscole
+dell'alfabeto inglese. Altri caratteri che possono essere definiti come
+lettere in localizzazioni non inglesi non sono validi nei nomi di variabile.
+Il maiuscolo o minuscolo sono significativi nei nomi di variabile;
address@hidden e @code{A} sono variabili diverse.
+
+Un nome di variabile @`e un'espressione valida in se stessa; rappresenta il
+valore corrente della variabile. I valori delle variabili possono essere
+modificati tramite @dfn{operatori di assegnamento}, @dfn{operatori di
+incremento} e @dfn{operatori di decremento}
+(@xref{Operatori di assegnamento}).
+Inoltre, le funzioni @code{sub()} e @code{gsub()} possono cambiare il valore
+di una variabile e le funzioni
address@hidden()}, @code{split()}, e @code{patsplit()} possono cambiare il
+contenuto dei loro parametri che sono
+costituiti da vettori
+(@pxref{Funzioni per stringhe}).
+
address@hidden variabili, predefinite
address@hidden variabili, inizializzazione
+Alcune variabili hanno un significato speciale predefinito, come @code{FS}
+(il separatore di campo) e @code{NF} (il numero di campi nel record di input
+corrente). @xref{Variabili predefinite} per un elenco delle variabili
+predefinite. Queste variabili predefinite possono essere usate e possono
+ricevere assegnamenti come tutte le altre variabili, ma i loro valori sono
+anche usati o cambiati automaticamente da @command{awk}. Tutti i nomi delle
+variabili predefinite sono in caratteri maiuscoli.
+
+Alle variabili in @command{awk} possono essere assegnati valori numerici o
+valori di stringa. Il tipo di valore che una variabile contiene
address@hidden cambiare
+durante la vita di un programma. Per default, le variabili sono inizializzate
+alla stringa nulla, che vale zero se viene convertita in un numero. Non c'@`e
+alcuna
address@hidden di inizializzare esplicitamente una variabile in @command{awk},
+come invece occorre fare in C e nella maggior parte dei linguaggi
+tradizionali.
+
address@hidden Opzioni di assegnamento
address@hidden Assegnare una variabile dalla riga di comando
address@hidden variabili, assegnare da riga di comando
address@hidden riga di comando, address@hidden assegnare da
+
+Si address@hidden impostare qualsiasi variabile @command{awk} includendo un
address@hidden di variabile} tra gli argomenti sulla riga di comando quando
+viene invocato @command{awk} (@pxref{Altri argomenti}).
+Tale assegnamento ha la seguente forma:
+
address@hidden
address@hidden@var{testo}
address@hidden example
+
address@hidden @option{-v}, opzione
address@hidden
+Con questo assegnamento, una variabile viene impostata o all'inizio
+dell'esecuzione di @command{awk} o tra la lettura di un file in input e il
+successivo file in input.
+Quando l'assegnamento @`e preceduto dall'opzione @option{-v},
+come nel seguente esempio:
+
address@hidden
+-v @address@hidden
address@hidden example
+
address@hidden
+la variabile @`e impostata proprio all'inizio, ancor prima che sia eseguita la
+regola @code{BEGIN}. L'opzione @option{-v} e il suo assegnamento
+deve precedere tutti gli argomenti @value{FN}, e anche il testo del programma.
+(@xref{Opzioni} per maggiori informazioni sull'opzione
address@hidden)
+In alternativa, l'assegnamento di variabile @`e effettuata in un momento
+determinato
+dalla posizione dell'opzione tra gli argomenti "file in input", address@hidden
dopo
+l'elaborazione del precedente argomento "file in input". Per esempio:
+
address@hidden
+awk '@{ print $n @}' n=4 inventory-shipped n=2 mail-list
address@hidden example
+
address@hidden
+stampa il valore del campo numero @code{n} per tutti i record in input. Prima
+che venga letto il primo file, la riga di comando imposta la variabile @code{n}
+al valore quattro. Questo fa address@hidden@dotless{i}} che venga stampato il
quarto campo delle righe
+del file @file{inventory-shipped}. Dopo la fine del primo file, ma prima
+che inizi il secondo file, @code{n} viene impostato a due, e quindi poi
+viene stampato il secondo campo delle righe di @file{mail-list}:
+
address@hidden
+$ @kbd{awk '@{ print $n @}' n=4 inventory-shipped n=2 mail-list}
address@hidden 15
address@hidden 24
address@hidden
address@hidden 555-5553
address@hidden 555-3412
address@hidden
address@hidden example
+
address@hidden angolo buio, argomenti da riga di comando
+Gli argomenti da riga di comando sono resi disponibili dal programma
address@hidden nel vettore @code{ARGV} per poter essere esaminati esplicitamente
+(@pxref{ARGC e ARGV}).
address@hidden elabora i valori degli assegnamenti da riga di comando per
+sequenze di protezione
+(@pxref{Sequenze di protezione}).
address@hidden
+
address@hidden Conversione
address@hidden Conversione di stringhe e numeri
+
+Le conversioni di numeri in stringhe e di stringhe in numeri sono generalmente
+semplici. Ci possono essere delle sottigliezze che bisogna tenere presenti;
+questa @value{SECTION} tratta di quest'importante sfaccettatura di
@command{awk}.
+
address@hidden
+* Stringhe e numeri:: Come @command{awk} converte tra
+ stringhe e numeri.
+* Localizzazione e conversioni:: Come la localizzazione address@hidden influire
+ sulle conversioni.
address@hidden menu
+
address@hidden Stringhe e numeri
address@hidden Come @command{awk} converte tra stringhe e numeri
+
address@hidden conversione da stringhe a numeri
address@hidden stringhe, conversione
address@hidden numeri, conversione in stringhe
address@hidden conversione da numeri a stringhe
+Le stringhe sono convertite in numeri e i numeri sono convertiti in stringhe,
+se il contesto del programma @command{awk} lo richiede. Per esempio, se il
+valore di @code{pippo} o @code{pluto} nell'espressione @samp{pippo + pluto}
address@hidden una stringa, viene convertita in un numero prima di eseguire
l'addizione.
+Se in una concatenazione di stringhe ci sono valori numerici, questi sono
+convertiti in stringhe. Si consideri il seguente esempio:
+
address@hidden
+due = 2; tre = 3
+print (due tre) + 4
address@hidden example
+
address@hidden
+Stampa il valore (numerico) di 27. I valori numerici delle
+variabili @code{due} e @code{tre} sono convertiti in stringhe e
+concatenati insieme. La stringa risultante @`e riconvertita nel
+numero 23, al quale poi viene aggiunto 4.
+
address@hidden stringhe nulle, conversione da tipo numerico a tipo stringa
address@hidden conversione di tipo variabile
address@hidden variabile, conversione di tipo
+Se, per qualche ragione, si vuole forzare la conversione di un numero in
+una stringa, basta concatenare a quel numero la stringa nulla, @code{""}.
+Per forzare la conversione di una stringa in un numero, basta aggiungere zero
+a quella stringa. Una stringa viene convertita in un numero interpretando
+qualsiasi prefisso numerico della stringa come numero:
address@hidden"2.5"} si converte in 2.5, @code{"1e3"} si converte in 1000, e
address@hidden"25fix"} ha un valore numerico di 25.
+Le stringhe che non possono essere interpretate come numeri validi vengono
+convertite al valore zero.
+
address@hidden @code{CONVFMT}, variabile
+Il modo esatto in cui i numeri sono convertiti in stringhe @`e controllato
dalla
+variabile predefinita di @command{awk} @code{CONVFMT}
+(@pxref{Variabili predefinite}). I numeri vengono convertiti usando la
+funzione @code{sprintf()}
+con @code{CONVFMT} come specificatore di formato
+(@pxref{Funzioni per stringhe}).
+
+Il valore di default di @code{CONVFMT} @`e @code{"%.6g"}, che crea un valore
con
+un massimo di sei cifre significative. Per alcune applicazioni potrebbe essere
+opportuno cambiare questo valore per ottenere una maggiore precisione.
+Sulla maggior parte delle macchine moderne
+normalmente bastano 17 cifre per esprimere esattamente il valore di un numero
+in virgola address@hidden casi eccezionali possono essere richieste fino
+a 752 cifre (!), non sembra che sia il caso di preoccuparsene qui.}
+
address@hidden angolo buio, variabile @code{CONVFMT}
+Si possono avere strani risultati se si imposta @code{CONVFMT} a una stringa
+che non indica a @code{sprintf()} come formattare i numeri in virgola mobile
+in un modo utile. Per esempio, se ci si dimentica la @samp{%} nel formato,
address@hidden converte tutti i numeri alla stessa stringa costante.
+
+Come caso particolare, per un numero intero, il risultato della conversione
+a una stringa @`e @emph{sempre} un numero intero, indipendentemente da quale
+sia il valore di @code{CONVFMT}. Dato il seguente fammento di codice:
+
address@hidden
+CONVFMT = "%2.2f"
+a = 12
+b = a ""
address@hidden example
+
address@hidden
address@hidden ha valore @code{"12"}, non @code{"12.00"}.
address@hidden
+
address@hidden sidebar, @command{awk} prima di POSIX usava @code{OFMT} per la
conversione di stringhe
address@hidden
address@hidden
+<sidebar><title>@command{awk} prima di POSIX usava @code{OFMT} per la
conversione di stringhe</title>
address@hidden docbook
+
address@hidden POSIX @command{awk}, variabile @code{OFMT} e
address@hidden @code{OFMT}, variabile
address@hidden address@hidden, nuovo @command{awk} vs.@: vecchio @command{awk}
address@hidden @command{awk}, nuovo vs.@: vecchio, variabile @code{OFMT}
+Prima dello standard POSIX, @command{awk} usava il valore di @code{OFMT} per
+convertire i numeri in stringhe. @code{OFMT} specifica il formato di output da
+usare per la stampa dei numeri con @code{print}. @code{CONVFMT} fu introdotto
+per separare la semantica della conversione dalla semantica della stampa. Sia
address@hidden che @code{OFMT} hanno lo stesso valore di dafault:
address@hidden"%.6g"}. Nella stragrande maggioranza dei casi, i vecchi
programmi di
address@hidden non cambiano questo comportamento.
address@hidden per maggiori informazioni sull'istruzione @code{print}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @address@hidden prima di POSIX usava @code{OFMT} per la
conversione di stringhe}
+
+
address@hidden POSIX @command{awk}, variabile @code{OFMT} e
address@hidden @code{OFMT}, variabile
address@hidden address@hidden, nuovo @command{awk} vs.@: vecchio @command{awk}
address@hidden @command{awk}, nuovo vs.@: vecchio, variabile @code{OFMT}
+Prima dello standard POSIX, @command{awk} usava il valore di @code{OFMT} per
+convertire i numeri in stringhe. @code{OFMT} specifica il formato di output da
+usare per la stampa dei numeri con @code{print}. @code{CONVFMT} fu introdotto
+per separare la semantica della conversione dalla semantica della stampa. Sia
address@hidden che @code{OFMT} hanno lo stesso valore di dafault:
address@hidden"%.6g"}. Nella stragrande maggioranza dei casi, i vecchi
programmi di
address@hidden non cambiano questo comportamento.
address@hidden per maggiori informazioni sull'istruzione @code{print}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Localizzazione e conversioni
address@hidden Le localizzazioni possono influire sulle conversioni
+
+Il luogo dove si @`e address@hidden avere importanza quando si tratta di
convertire numeri e
+stringhe. La lingua e i caratteri---la @dfn{localizzazione}---possono
+influire sui formati numerici. In particolare, per i programmi @command{awk},
+influiscono sui caratteri separatore decimale e separatore delle migliaia.
+La localizzazione @code{"C"}, e la maggior parte delle localizzazioni inglesi,
+usano il punto (@samp{.}) come separatore decimale e non prevedono un
+separatore delle
+migliaia. Tuttavia, molte (se non la maggior parte) delle localizzazioni
+europee e non inglesi usano la virgola (@samp{,}) come separatore dei decimali.
+Le localizzazioni europee spesso usano o lo spazio o il punto come separatore
+delle migliaia, all'occorrenza.
+
address@hidden angolo buio, carattere di separazione dei decimali nelle
localizzazioni
+Lo standard POSIX prevede che @command{awk} usi sempre il punto come separatore
+dei decimali nel codice sorgente del programma @command{awk}, e per
+gli assegnamenti di variabile da riga di comando (@pxref{Altri argomenti}).
+Tuttavia, nell'interpretazione dei dati in input, per l'output di
address@hidden e @code{printf}, e per la conversione da numeri a stringhe,
+viene usato il
+separatore decimale locale. @value{DARKCORNER} In ogni caso, i numeri nel
+codice sorgente e nei dati di input non possono avere un separatore delle
+migliaia. Di seguito sono riportati alcuni esempi che illustrano la differenza
+di comportamento, su un sistema GNU/Linux:
+
address@hidden
+$ @kbd{export POSIXLY_CORRECT=1} @ii{Forzare aderenza a
standard POSIX}
+$ @kbd{gawk 'BEGIN @{ printf "%g\n", 3.1415927 @}'}
address@hidden 3.14159
+$ @kbd{LC_ALL=en_DK.utf-8 gawk 'BEGIN @{ printf "%g\n", 3.1415927 @}'}
address@hidden 3,14159
+$ @kbd{echo 4,321 | gawk '@{ print $1 + 1 @}'}
address@hidden 5
+$ @kbd{echo 4,321 | LC_ALL=en_DK.utf-8 gawk '@{ print $1 + 1 @}'}
address@hidden 5,321
address@hidden example
+
address@hidden
+La localizzazione @code{en_DK.utf-8} @`e per l'inglese in Danimarca, dove
+le virgole fungono da separatore decimale. Nella localizzazione @code{"C"}
+normale, @command{gawk} tratta @samp{4,321} come 4, mentre nella localizzazione
+danese @`e trattato come numero completo comprendente la parte frazionaria,
+4.321.
+
+Alcune delle prime versioni di @command{gawk} si conformavano completamente con
+quest'aspetto dello standard. Tuttavia, molti utenti di localizzazioni non
+inglesi si lamentavano di questo comportamento, perch@'e i loro dati usavano il
+punto come separatore decimale, per cui fu ripristinato il comportamento di
+default che usava il punto come carattere di separazione decimale. Si
address@hidden
+usare l'opzione @option{--use-lc-numeric} (@pxref{Opzioni}) per forzare
address@hidden a usare il carattere separatore decimale della localizzazione.
+(@command{gawk} usa il separatore decimale della localizzazione anche quando
address@hidden in address@hidden POSIX, o con l'opzione @option{--posix} o con
la variabile
+d'ambiente @env{POSIXLY_CORRECT}, come appena visto.)
+
address@hidden descrive i casi in cui si usa il separatore decimale
+locale e quando si usa il punto. Alcune di queste address@hidden non sono
state
+ancora descritte.
+
address@hidden Tabella,table-locale-affects
address@hidden decimale locale o punto}
address@hidden @columnfractions .15 .25 .45
address@hidden Funzione @tab Default @tab @option{--posix} o
@option{--use-lc-numeric}
address@hidden @code{%'g} @tab Usa la localizzazione @tab Usa la localizzazione
address@hidden @code{%g} @tab Usa il punto @tab Usa la localizzazione
address@hidden Input @tab Usa il punto @tab Usa la localizzazione
address@hidden @code{strtonum()} @tab Usa il punto @tab Usa la localizzazione
address@hidden multitable
address@hidden float
+
+Infine, gli standard ufficiali correnti e la rappresentazione dei numeri
+in virgola mobile dello standard IEEE possono avere un effetto insolito ma
+importante sul modo in cui @command{gawk} converte alcuni valori di stringa
+speciali in
+numeri. I dettagli sono illustrati in @ref{Problemi virgola mobile POSIX}.
+
address@hidden Tutti gli operatori
address@hidden Operatori: fare qualcosa coi valori
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden introduce gli @dfn{operatori} che fanno uso
+dei valori forniti da costanti e variabili.
+
address@hidden
+* Operatori aritmetici:: Operazioni aritmetiche (@samp{+}, @samp{-},
+ etc.)
+* Concatenazione:: Concatenazione di stringhe.
+* Operatori di assegnamento:: Cambiare il valore di una variabile o di un
+ campo.
+* Operatori di incremento:: Incrementare il valore numerico di una
+ variabile.
address@hidden menu
+
address@hidden Operatori aritmetici
address@hidden Operatori aritmetici
address@hidden aritmetici, operatori
address@hidden operatori aritmetici
address@hidden @cindex addition
address@hidden @cindex subtraction
address@hidden @cindex multiplication
address@hidden @cindex division
address@hidden @cindex remainder
address@hidden @cindex quotient
address@hidden @cindex exponentiation
+
+Il linguaggio @command{awk} usa i comuni operatori aritmetici nella valutazione
+delle espressioni. Tutti questi operatori aritmetici seguono le normali regole
+di precedenza e funzionano come ci si aspetta.
+
+Il seguente esempio usa un file chiamato @file{grades}, che contiene
+una lista di nomi di studenti e anche i voti di tre verifiche per ogni studente
+(@`e una piccola classe):
+
address@hidden
+Pat 100 97 58
+Sandy 84 72 93
+Chris 72 92 89
address@hidden example
+
address@hidden
+Questo programma prende il file @file{grades} e stampa la media
+dei voti:
+
address@hidden
+$ @kbd{awk '@{ sum = $2 + $3 + $4 ; avg = sum / 3}
+> @kbd{print $1, avg @}' grades}
address@hidden Pat 85
address@hidden Sandy 83
address@hidden Chris 84.3333
address@hidden example
+
+La lista seguente elenca gli operatori aritmetici in @command{awk},
+in ordine di precedenza, da quella address@hidden alta a quella address@hidden
bassa:
+
address@hidden @code
address@hidden estensioni comuni, operatore @code{**}
address@hidden POSIX @command{awk}, operatori aritmetici e
address@hidden @var{x} ^ @var{y}
address@hidden @var{x} ** @var{y}
+Elevamento a potenza; @var{x} elevato alla potenza @var{y}. @samp{2 ^ 3}
+ha il valore otto; la sequenza di caratteri @samp{**} @`e equivalente a
address@hidden @value{COMMONEXT}
+
address@hidden - @var{x}
+Negazione.
+
address@hidden + @var{x}
address@hidden unario; l'espressione @`e convertita in un numero.
+
address@hidden @var{x} * @var{y}
+Moltiplicazione.
+
address@hidden risoluzione di problemi, divisione
address@hidden problemi, risoluzione di, divisione
address@hidden divisione
address@hidden @var{x} / @var{y}
+Divisione; poich@'e tutti i numeri in @command{awk} sono numeri in virgola
+mobile, il risultato @emph{non} @`e arrotondato all'address@hidden / 4} ha il
+valore di 0.75. (Un errore comune, specialmente tra i programmatori in C, @`e
+quello di dimenticare che @emph{tutti} i numeri in @command{awk} sono in
virgola mobile,
+e che la divisione di costanti rappresentate da numeri interi produce un
+numero reale, non un numero intero.)
+
address@hidden @var{x} % @var{y}
+Resto della divisione; subito dopo questa lista, l'argomento viene
+ulteriormente dettagliato.
+
address@hidden @var{x} + @var{y}
+Addizione.
+
address@hidden @var{x} - @var{y}
+Sottrazione.
address@hidden table
+
+Il address@hidden e il meno unari hanno la stessa precedenza,
+gli operatori di moltiplicazione hanno tutti la stessa precedenza, e
+l'addizione e la sottrazione hanno la stessa precedenza.
+
address@hidden differenze tra @command{awk} e @command{gawk}, operazione di
modulo-troncamento
address@hidden modulo-troncamento, operazione di
+Quando si calcola il resto di @address@hidden % @var{y}},
+il quoziente @`e troncato all'intero e
+moltiplicato per @var{y}. Questo risultato @`e sottratto da @var{x};
+quest'operazione @`e nota anche come ``modulo''. La seguente
+relazione @`e sempre verificata:
+
address@hidden
+b * int(a / b) + (a % b) == a
address@hidden example
+
+Un possibile effetto indesiderato di questa definizione di resto @`e che
address@hidden@var{x} % @var{y}} sia negativo se @var{x} @`e negativo.
address@hidden@dotless{i}}:
+
address@hidden
+-17 % 8 = -1
address@hidden example
+
+In altre implementazioni di @command{awk} il segno del resto
address@hidden essere dipendente dalla macchina.
address@hidden FIXME !!! what does posix say?
+
address@hidden address@hidden, operatore @code{**}
address@hidden @code{*} (asterisco), operatore @code{**}
address@hidden asterisco (@code{*}), operatore @code{**}
address@hidden NOTA
+Lo standard POSIX specifica solo l'uso di @samp{^}
+per l'elevamento a potenza.
+Per garantire la massima address@hidden @`e meglio non usare l'operatore
@samp{**}.
address@hidden quotation
+
address@hidden Concatenazione
address@hidden Concatenazione di stringhe
address@hidden Kernighan, Brian
address@hidden
address@hidden ci era sembrata una buona idea.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden operatori di stringa
address@hidden stringa, operatori di
address@hidden concatenare
+C'@`e una sola operazione di stringa: la concatenazione. Non ha un operatore
+specifico per rappresentarla. Piuttosto, la concatenazione @`e effettuata
+scrivendo le espressioni l'una vicino all'altra, senza alcun operatore.
+Per esempio:
+
address@hidden
+$ @kbd{awk '@{ print "Campo numero uno: " $1 @}' mail-list}
address@hidden Campo numero uno: Amelia
address@hidden Campo numero uno: Anthony
address@hidden
address@hidden example
+
+Senza lo spazio nella costante stringa dopo @samp{:}, la riga
+rimane unita. Per esempio:
+
address@hidden
+$ @kbd{awk '@{ print "Campo numero uno:" $1 @}' mail-list}
address@hidden Campo numero uno:Amelia
address@hidden Campo numero uno:Anthony
address@hidden
address@hidden example
+
address@hidden risoluzione di problemi, concatenazione di stringhe
address@hidden problemi, risoluzione di, concatenazione di stringhe
+Poich@'e la concatenazione di stringhe non ha un operatore esplicito, @`e
spesso
+necessario assicurarsi che venga effettuata al momento giusto usando le
+parentesi per racchiudere gli elementi da concatenare. Per esempio, ci si
+potrebbe aspettare che il
+seguente fammento di codice concateni @code{nome} e @code{file}:
+
address@hidden
+nome = "nome"
+file = "file"
+print "qualcosa di significativo" > nome file
address@hidden example
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden
+Questo produce un errore di sintassi in alcune versioni di
address@hidden per address@hidden@`o capitare che BWK
address@hidden, @command{gawk} e @command{mawk} lo interpretino nel modo giusto,
+ma non ci si dovrebbe fare affidamento.}
address@hidden necessario usare la seguente sintassi:
+
address@hidden
+print "qualcosa di significativo" > (nome file)
address@hidden example
+
address@hidden ordine di valutazione, concatenazione
address@hidden valutazione, ordine di, concatenazione
address@hidden effetti collaterali
+Si dovrebbero usare le parentesi attorno alle concatenazioni in tutti i
+contesti non comuni, come, per esempio, sul lato destro di @samp{=}.
+Bisogna stare attenti
+al tipo di espressioni usate nella concatenazione di stringhe. In particolare,
+l'ordine di valutazione di espressioni usate per la concatenazione non @`e
+definita nel linguaggio @command{awk}. Si consideri quest'esempio:
+
address@hidden
+BEGIN @{
+ a = "Non"
+ print (a " " (a = "v'allarmate"))
address@hidden
address@hidden example
+
address@hidden
+Non @`e definito se il secondo assegnamento ad @code{a} debba avvenire
+prima o dopo il recupero del valore di @code{a} per produrre il
+valore concatenato. Il risultato potrebbe essere sia @samp{Non v'allarmate},
+sia @samp{v'allarmate v'allarmate}.
address@hidden see test/nasty.awk for a worse example
+
+La precedenza della concatenazione, quando @`e in combinazione con altri
+operatori, @`e spesso controintuitiva. Si consideri questo esempio:
+
address@hidden
+> To: bug-gnu-utils@@gnu.org
+> CC: arnold@@gnu.org
+> Subject: gawk 3.0.4 bug with {print -12 " " -24}
+> From: Russell Schulz <address@hidden>
+> Date: Tue, 8 Feb 2000 19:56:08 -0700
+>
+> gawk 3.0.4 on NT gives me:
+>
+> prompt> cat bad.awk
+> BEGIN { print -12 " " -24; }
+>
+> prompt> gawk -f bad.awk
+> -12-24
+>
+> when I would expect
+>
+> -12 -24
+>
+> I have not investigated the source, or other implementations. The
+> bug is there on my NT and DOS versions 2.15.6 .
address@hidden ignore
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print -12 " " -24 @}'}
address@hidden -12-24
address@hidden example
+
+Quest'esempio, ``ovviamente'' concatena @minus{}12, uno spazio, e @minus{}24.
+Ma dov'@`e finito lo spazio?
+La risposta sta nella combinazione di precedenze di operatori e nelle regole di
+conversione automatica di @command{awk}. Per ottenere il risultato desiderato,
+si deve scrivere il programma in questo modo:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print -12 " " (-24) @}'}
address@hidden -12 -24
address@hidden example
+
+Questo forza il trattamento, da parte di @command{awk}, del @samp{-} del
address@hidden come operatore unario. Altrimenti @`e analizzato in questo modo:
+
address@hidden
+ @minus{}12 (@code{"@ "} @minus{} 24)
address@hidden @minus{}12 (0 @minus{} 24)
address@hidden @minus{}12 (@minus{}24)
address@hidden @address@hidden
address@hidden display
+
+Come si @`e detto precedentemente,
+quando si usa la concatenazione insieme ad altri operatori, @`e necessario
address@hidden le parentesi}. Altrimenti, non si address@hidden essere mai
completamente
+certi di quel che si ottiene.
+
address@hidden Operatori di assegnamento
address@hidden Espressioni di assegnamento
address@hidden operatori di assegnamento
address@hidden assegnamento, operatori di
address@hidden espressioni di assegnamento
address@hidden @code{=} (uguale), operatore @code{=}
address@hidden uguale (@code{=}), operatore @code{=}
+Un @dfn{assegnamento} @`e un'espressione che memorizza un valore (generalmente
+diverso da quello che la variabile aveva in precedenza) in una variabile.
+Per esempio, si assegni il valore uno alla variabile @code{z}:
+
address@hidden
+z = 1
address@hidden example
+
+Dopo l'esecuzione di quest'espressione, la variabile @code{z} ha il valore
+uno. Qualsiasi precedente valore di @code{z} prima dell'assegnamento
+viene dimenticato.
+
+Gli assegnamenti possono anche memorizzare valori di stringa. Il seguente
+esempio memorizza
+il valore @code{"questo cibo @`e buono"} nella variabile @code{messaggio}:
+
address@hidden
+cosa = "cibo"
+predicato = "buono"
+messaggio = "questo " cosa " @`e " predicato
address@hidden example
+
address@hidden
address@hidden effetti collaterali, espressioni di assegnamento
+Quest'esempio illustra anche la concatenazione di stringhe.
+Il segno @samp{=} @`e un @dfn{operatore di assegnamento}. @`E il
address@hidden semplice
+fra gli operatori di assegnamento perch@'e il valore dell'operando di destra
address@hidden memorizzato invariato.
+La maggior parte degli operatori (addizione, concatenazione e
address@hidden@dotless{i}} via) non
+fanno altro che calcolare un valore. Se il valore non viene poi utilizzato
non c'@`e alcun
+motivo per usare l'operatore. Un operatore di assegnamento @`e differente;
+produce un valore; anche se poi non lo si usa, l'assegnamento svolge ancora
+una funzione alterando la variabile. Chiamiamo questo
+un @dfn{effetto collaterale}.
+
address@hidden @dfn{lvalue/rvalue}
address@hidden @dfn{rvalue/lvalue}
address@hidden assegnamento, operatori di, @dfn{lvalue/rvalue}
address@hidden operatori di assegnamento
+L'operando di sinistra non dev'essere necessariamente una variabile
+(@pxref{Variabili}); address@hidden essere anche un campo
+(@pxref{Cambiare i campi}) o
address@hidden
+un elemento di un vettore (@pxrefil{Vettori}).
address@hidden iftex
address@hidden
+un elemento di un vettore (@pxref{Vettori}).
address@hidden ifnottex
+Questi operandi sono chiamati @dfn{lvalue}, il
+che significa che possono apparire sul lato sinistro di un operatore di
+assegnamento. L'operando sul lato destro address@hidden essere qualsiasi
espressione;
+produce un nuovo valore che l'assegnamento memorizza nella variabile, nel campo
+o nell'elemento di vettore specificati. Tali valori sono chiamati
address@hidden
+
address@hidden variabili, tipi di
address@hidden importante notare che le variabili @emph{non} hanno dei tipi
permanenti.
+Il tipo di una variabile @`e semplicemente quello di qualsiasi valore le sia
stato
+assegnato per ultimo. Nel seguente frammento di programma, la variabile
address@hidden ha dapprima un valore numerico, e in seguito un valore di
stringa:
+
address@hidden
+pippo = 1
+print pippo
+pippo = "pluto"
+print pippo
address@hidden example
+
address@hidden
+Quando il secondo assegnamento address@hidden a @code{pippo} un valore di
stringa, il fatto
+che avesse precedentemente un valore numerico viene dimenticato.
+
+Ai valori di stringa che non iniziano con una cifra viene assegnato il valore
+numerico zero. Dopo l'esecuzione del seguente codice, il valore di
@code{pippo} @`e
+cinque:
+
address@hidden
+pippo = "una stringa"
+pippo = pippo + 5
address@hidden example
+
address@hidden NOTA
+Usare una variabile sia come numero che come stringa address@hidden originare
confusione
+e denota uno stile di programmazione scadente. I due esempi precedenti
+illustrano come funziona @command{awk}, @emph{non} come si dovrebbero scrivere
+i programmi!
address@hidden quotation
+
+Un assegnamento @`e un'espressione, per cui ha un valore: lo stesso valore che
+le @`e stato assegnato. address@hidden@dotless{i}}, @samp{z = 1} @`e
un'espressione col valore uno.
+Una conseguenza di address@hidden @`e che si possono scrivere address@hidden
assegnamenti insieme,
+come:
+
address@hidden
+x = y = z = 5
address@hidden example
+
address@hidden
+Quest'esempio memorizza il valore cinque in tutte e tre le variabili,
+(@code{x}, @code{y} e @code{z}).
+Questo perch@'e il
+valore di @samp{z = 5}, che @`e cinque, @`e memorizzato in @code{y} e poi
+il valore di @samp{y = z = 5}, che @`e cinque, @`e memorizzato in @code{x}.
+
+Gli assegnamenti possono essere usati ovunque sia prevista un'espressione. Per
+esempio, @`e valido scrivere @samp{x != (y = 1)} per impostare @code{y} a
+uno, e poi verificare se @code{x} @`e uguale a uno. address@hidden questo
stile rende i
+programmi difficili da leggere; una tale nidificazione di assegnamenti dovrebbe
+essere evitata, eccetto forse in un programma usa-e-getta.
+
address@hidden @code{+} (address@hidden), operatore @code{+=}
address@hidden address@hidden (@code{+}), operatore @code{+=}
+Accanto a @samp{=}, ci sono diversi altri operatori di assegnamento che
+eseguono calcoli col vecchio valore di una variabile. Per esempio,
+l'operatore @samp{+=} calcola un nuovo valore aggiungendo il valore sul lato
+destro al vecchio valore di una variabile. address@hidden@dotless{i}}, il
seguente assegnamento
+aggiunge cinque al valore di @code{pippo}:
+
address@hidden
+pippo += 5
address@hidden example
+
address@hidden
+Questo @`e equivalente a:
+
address@hidden
+pippo = pippo + 5
address@hidden example
+
address@hidden
+Si usi la notazione che rende address@hidden chiaro il significato del
programma.
+
+Ci sono situazioni in cui usare @samp{+=} (o qualunque operatore di
+assegnamento) @emph{non} @`e la stessa cosa che ripetere semplicemente
l'operando
+di sinistra nell'espressione di destra. Per esempio:
+
address@hidden Rankin, Pat
address@hidden
+# Grazie a Pat Rankin per quest'esempio
+BEGIN @{
+ pippo[rand()] += 5
+ for (x in pippo)
+ print x, pippo[x]
+
+ pluto[rand()] = pluto[rand()] + 5
+ for (x in pluto)
+ print x, pluto[x]
address@hidden
address@hidden example
+
address@hidden operatori di assegnamento, ordine di valutazione
address@hidden assegnamento, operatori di, ordine di valutazione
address@hidden
address@hidden praticamente certo che gli indici di @code{pluto} siano
differenti, perch@'e
address@hidden()} restituisce valori differenti ogni volta che viene chiamata.
+(I vettori e la funzione @code{rand()} non sono ancora stati trattati.
address@hidden
address@hidden,
address@hidden iftex
address@hidden
address@hidden,
address@hidden ifnottex
+e
address@hidden
address@hidden numeriche}
address@hidden ifnotdocbook
address@hidden
address@hidden numeriche}
address@hidden ifdocbook
+per maggiori informazioni.)
+Quest'esempio illustra un fatto importante riguardo agli operatori di
+assegnamento: l'espressione di sinistra viene valutata @emph{una volta sola}.
+
+Dipende dall'implementazione stabilire quale espressione valutare per
+prima, se quella di sinistra o quella di destra.
+Si consideri quest'esempio:
+
address@hidden
+i = 1
+a[i += 2] = i + 1
address@hidden example
+
address@hidden
+Il valore di @code{a[3]} potrebbe essere sia due sia quattro.
+
+La @ref{table-assign-ops} elenca gli operatori di assegnamento aritmetici. In
+ogni caso, l'operando di destra @`e un'espressione il cui valore @`e
convertito in
+un numero.
+
address@hidden @code{-} (meno), operatore @code{-=}
address@hidden meno (@code{-}), operatore @code{-=}
address@hidden @code{*} (asterisco), operatore @code{*=}
address@hidden asterisco (@code{*}), operatore @code{*=}
address@hidden @code{/} (barra), operatore @code{/=}
address@hidden barra (@code{/}), operatore @code{/=}
address@hidden @code{%} (percento), operatore @code{%=}
address@hidden percento (@code{%}), operatore @code{%=}
address@hidden @code{^} (circonflesso), operatore @code{^=}
address@hidden circonflesso (@code{^}), operatore @code{^=}
address@hidden @code{*} (asterisco), operatore @code{**=}
address@hidden asterisco (@code{*}), operatore @code{**=}
address@hidden Tabella,table-assign-ops
address@hidden di assegnamento aritmetici}
address@hidden @columnfractions .30 .70
address@hidden Operatore @tab Effetto
address@hidden @var{lvalue} @code{+=} @var{incremento} @tab Aggiunge
@var{incremento} al valore di @var{lvalue}.
address@hidden @var{lvalue} @code{-=} @var{decremento} @tab Sottrae
@var{decremento} dal valore di @var{lvalue}.
address@hidden @var{lvalue} @code{*=} @var{coefficiente} @tab Moltiplica il
valore di @var{lvalue} per @var{coefficiente}.
address@hidden @var{lvalue} @code{/=} @var{divisore} @tab Divide il valore di
@var{lvalue} per @var{divisore}.
address@hidden @var{lvalue} @code{%=} @var{modulo} @tab Imposta @var{lvalue} al
resto della sua divisione per @var{modulo}.
address@hidden estensioni comuni, operatore @code{**=}
address@hidden estensioni address@hidden operatore @code{**=}
address@hidden @command{awk}, linguaggio, versione POSIX
address@hidden POSIX @command{awk}
address@hidden @var{lvalue} @code{^=} @var{esponente} @tab Eleva @var{lvalue}
alla potenza @var{esponente}.
address@hidden @var{lvalue} @code{**=} @var{esponente} @tab Eleva @var{lvalue}
alla potenza @var{esponente}. @value{COMMONEXT}
address@hidden multitable
address@hidden float
+
address@hidden POSIX @command{awk}, operatore @code{**=} e
address@hidden address@hidden, operatore @code{**=}
address@hidden NOTA
+Soltanto l'operatore @samp{^=} @`e definito da POSIX.
+Per avere la massima address@hidden, non usare l'operatore @samp{**=}.
address@hidden quotation
+
address@hidden sidebar, address@hidden sintattiche tra @samp{/=} e le
espressioni regolari
address@hidden
address@hidden
+<sidebar><title>address@hidden sintattiche tra @samp{/=} e le espressioni
regolari</title>
address@hidden docbook
+
address@hidden angolo buio, costanti @dfn{regexp}, operatore @code{/=} e
address@hidden @code{/} (barra), operatore @code{/=}, vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden barra (@code{/}), operatore @code{/=}, vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden @dfn{regexp}, costanti, @code{/address@hidden/}, operatore
@code{/=} e
+
address@hidden derived from email from "Nelson H. F. Beebe" <address@hidden>
address@hidden Date: Mon, 1 Sep 1997 13:38:35 -0600 (MDT)
+
address@hidden angolo buio, operatore @code{/=} vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden address@hidden sintattica: operatore @code{/=} vs. costante
@dfn{regexp} @code{/address@hidden/}
address@hidden sintattica, address@hidden: operatore @code{/=} vs. costante
@dfn{regexp} @code{/address@hidden/}
address@hidden @code{/=}, operatore, vs. costante @dfn{regexp}
@code{/address@hidden/}
+C'@`e un'address@hidden sintattica tra l'operatore di assegnamento @code{/=}
+e le costanti @dfn{regexp} il cui primo carattere sia @samp{=}.
address@hidden
+Questo @`e address@hidden evidente in alcune versioni commerciali di
@command{awk}.
+Per esempio:
+
address@hidden
+$ @kbd{awk /==/ /dev/null}
address@hidden awk: syntax error at source line 1
address@hidden context is
address@hidden >>> /= <<<
address@hidden awk: bailing out at source line 1
address@hidden example
+
address@hidden
+Un espediente @`e:
+
address@hidden
+awk '/[=]=/' /dev/null
address@hidden example
+
address@hidden non ha questo problema, e neppure lo hanno BWK @command{awk}
+e @command{mawk}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @address@hidden sintattiche tra @samp{/=} e le espressioni
regolari}
+
+
address@hidden angolo buio, costanti @dfn{regexp}, operatore @code{/=} e
address@hidden @code{/} (barra), operatore @code{/=}, vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden barra (@code{/}), operatore @code{/=}, vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden @dfn{regexp}, costanti, @code{/address@hidden/}, operatore
@code{/=} e
+
address@hidden derived from email from "Nelson H. F. Beebe" <address@hidden>
address@hidden Date: Mon, 1 Sep 1997 13:38:35 -0600 (MDT)
+
address@hidden angolo buio, operatore @code{/=} vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden address@hidden sintattica: operatore @code{/=} vs. costante
@dfn{regexp} @code{/address@hidden/}
address@hidden sintattica, address@hidden: operatore @code{/=} vs. costante
@dfn{regexp} @code{/address@hidden/}
address@hidden @code{/=}, operatore, vs. costante @dfn{regexp}
@code{/address@hidden/}
+C'@`e un'address@hidden sintattica tra l'operatore di assegnamento @code{/=}
+e le costanti @dfn{regexp} il cui primo carattere sia @samp{=}.
address@hidden
+Questo @`e address@hidden evidente in alcune versioni commerciali di
@command{awk}.
+Per esempio:
+
address@hidden
+$ @kbd{awk /==/ /dev/null}
address@hidden awk: syntax error at source line 1
address@hidden context is
address@hidden >>> /= <<<
address@hidden awk: bailing out at source line 1
address@hidden example
+
address@hidden
+Un espediente @`e:
+
address@hidden
+awk '/[=]=/' /dev/null
address@hidden example
+
address@hidden non ha questo problema, e neppure lo hanno BWK @command{awk}
+e @command{mawk}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Operatori di incremento
address@hidden Operatori di incremento e di decremento
+
address@hidden incremento, operatori di
address@hidden operatori di decremento/incremento
+Gli @dfn{operatori di incremento} e @dfn{decremento} incrementano o riducono il
+valore di una variabile di uno. Un operatore di assegnamento address@hidden
fare la
+stessa cosa, per cui gli operatori di incremento non aggiungono address@hidden
+al inguaggio @command{awk}; in ogni caso, sono delle convenienti abbreviazioni
+per operazioni molto comuni.
+
address@hidden effetti collaterali
address@hidden @code{+} (address@hidden), operatore @code{++}
address@hidden address@hidden (@code{+}), operatore @code{++}
address@hidden effetti collaterali, operatori di decremento/incremento
+L'operatore per aggiungere uno @`e @samp{++}. address@hidden essere usato per
incrementare
+una variabile prima o dopo aver stabilito il suo valore. Per
@dfn{preincrementare}
+una variabile @code{v}, si scrive @samp{++v}. Questo aggiunge uno al valore di
address@hidden; questo nuovo valore @`e anche il valore dell'espressione.
+(L'espressione di assegnamento @samp{v += 1} @`e totalmente equivalente.)
+Scrivendo @samp{++} dopo la variabile si specifica un @dfn{postincremento}.
+Questo incrementa il valore della variabile nello stesso modo; la differenza
@`e
+che il valore dell'espressione d'incremento @`e il @emph{vecchio} valore della
+variabile. address@hidden@dotless{i}}, se @code{pippo} ha il valore quattro,
l'espressione
address@hidden ha il valore quattro, ma cambia il valore di @code{pippo} in
cinque.
+In altre parole, l'operatore restituisce il vecchio valore della variabile, ma
+con l'effetto collaterale di incrementarlo.
+
+Il postincremento @samp{pippo++} @`e quasi come scrivere @samp{(pippo += 1) -
1}.
+Non @`e perfettamente equivalente perch@'e tutti i numeri in @command{awk}
sono in
+virgola mobile. In virgola mobile, @samp{pippo + 1 - 1} non @`e
necessariamente
+uguale a @code{pippo}, ma la differenza @`e molto piccola finch@'e si ha a che
+fare con numeri relativamente piccoli (inferiori a
address@hidden
address@hidden).
address@hidden iftex
address@hidden
+10e12).
address@hidden ifinfo
address@hidden
address@hidden
address@hidden).
address@hidden ifnotinfo
address@hidden ifnottex
+
address@hidden @code{$} (dollaro), incrementare campi e vettori
address@hidden dollaro (@code{$}), incrementare campi e vettori
+I campi di un record e gli elementi di un vettore vengono incrementati
+proprio come le
+variabili. (Si deve usare @samp{$(i++)} quando si deve fare un riferimento a
+un campo e incrementare una variabile allo stesso tempo. Le parentesi sono
+necessarie a causa della precedenza dell'operatore di riferimento @samp{$}.)
+
address@hidden decremento, operatori di
+L'operatore di decremento @samp{--} funziona proprio come @samp{++}, solo che
+sottrae uno anzich@'e aggiungerlo. Come @samp{++}, si address@hidden usare
prima di
address@hidden
+per predecrementare o dopo per postdecrementare.
+Quel che segue @`e un sommario delle espressioni di incremento e di
+decremento:
+
address@hidden @code
address@hidden @code{+} (address@hidden), operatore @code{++}
address@hidden address@hidden (@code{+}), operatore @code{++}
address@hidden address@hidden
+Incrementa @var{lvalue}, restituendo il nuovo valore come
+valore dell'espressione.
+
address@hidden @var{lvalue}++
+Incrementa @var{lvalue}, restituendo il @emph{vecchio} valore di @var{lvalue}
+come valore dell'espressione.
+
address@hidden @code{-} (meno), operatore @code{--}
address@hidden meno (@code{-}), operatore @code{--}
address@hidden address@hidden
+Decrementa @var{lvalue}, restituendo il nuovo valore come
+valore dell'espressione.
+(Quest'espressione @`e come
address@hidden@var{lvalue}}, ma invece di aggiungere, sottrae.)
+
address@hidden @var{lvalue}--
+Decrementa @var{lvalue}, restituendo il @emph{vecchio} valore di @var{lvalue}
+come valore dell'espressione.
+(Quest'espressione @`e come
address@hidden@var{lvalue}++}, ma invece di aggiungere, sottrae.)
address@hidden table
+
address@hidden sidebar, Ordine di valutazione degli operatori
address@hidden
address@hidden
+<sidebar><title>Ordine di valutazione degli operatori</title>
address@hidden docbook
+
address@hidden precedenza
address@hidden operatori, precedenza
address@hidden address@hidden, operatori
address@hidden valutazione, ordine di
address@hidden Marx, Groucho
address@hidden
address@hidden, quando faccio address@hidden@dotless{i}} mi fa address@hidden
+E allora non farlo!}
address@hidden Groucho Marx
address@hidden quotation
+
address@hidden
+Che cosa succede con qualcosa come questo?
+
address@hidden
+b = 6
+print b += b++
address@hidden example
+
address@hidden
+O con qualcosa di address@hidden strano ancora?
+
address@hidden
+b = 6
+b += ++b + b++
+print b
address@hidden example
+
address@hidden effetti collaterali
+In altre parole, quando hanno effetto i vari effetti collaterali previsti
+dagli operatori col suffisso (@samp{b++})? Quando gli effetti collaterali
+si verificano @`e @dfn{definito dall'implementazione}.
+Per dirla diversamente, questo @`e compito di ogni specifica versione di
address@hidden Il risultato del primo esempio address@hidden essere 12 o 13, e
del
+secondo address@hidden essere 22 o 23.
+
+In breve, @`e sconsigliato fare cose come questa e, in ogni caso,
+ogni cosa che possa incidere sulla address@hidden
+Si dovrebbero evitare cose come queste nei programmi.
address@hidden You'll sleep better at night and be able to look at yourself
address@hidden in the mirror in the morning.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Ordine di valutazione degli operatori}
+
+
address@hidden precedenza
address@hidden operatori, precedenza
address@hidden address@hidden, operatori
address@hidden valutazione, ordine di
address@hidden Marx, Groucho
address@hidden
address@hidden, quando faccio address@hidden@dotless{i}} mi fa address@hidden
+E allora non farlo!}
address@hidden Groucho Marx
address@hidden quotation
+
address@hidden
+Che cosa succede con qualcosa come questo?
+
address@hidden
+b = 6
+print b += b++
address@hidden example
+
address@hidden
+O con qualcosa di address@hidden strano ancora?
+
address@hidden
+b = 6
+b += ++b + b++
+print b
address@hidden example
+
address@hidden effetti collaterali
+In altre parole, quando hanno effetto i vari effetti collaterali previsti
+dagli operatori col suffisso (@samp{b++})? Quando gli effetti collaterali
+si verificano @`e @dfn{definito dall'implementazione}.
+Per dirla diversamente, questo @`e compito di ogni specifica versione di
address@hidden Il risultato del primo esempio address@hidden essere 12 o 13, e
del
+secondo address@hidden essere 22 o 23.
+
+In breve, @`e sconsigliato fare cose come questa e, in ogni caso,
+ogni cosa che possa incidere sulla address@hidden
+Si dovrebbero evitare cose come queste nei programmi.
address@hidden You'll sleep better at night and be able to look at yourself
address@hidden in the mirror in the morning.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Valori e condizioni di address@hidden
address@hidden Valori e condizioni di address@hidden
+
+In certi contesti, i valori delle espressioni servono anche come
+``valori di address@hidden''; address@hidden, determinano quale address@hidden
la direzione che il
+programma address@hidden durante la sua esecuzione. Questa
address@hidden descrive come @command{awk} definisce ``vero'' e ``falso''
+e come questi valori sono confrontati.
+
address@hidden
+* Valori di address@hidden:: Cos'@`e ``vero'' e cos'@`e ``falso''.
+* Tipi di variabile e confronti:: Come alle variabili si assegna il tipo e
+ l'effetto che questo ha sul confronto di
+ numeri e stringhe con @samp{<}, etc.
+* Operatori booleani:: Combinare espressioni di confronto usando
+ operatori booleani @samp{||} (``or''),
+ @samp{&&} (``and'') e @samp{!} (``not'').
+* Espressioni condizionali:: Le espressioni condizionali scelgono una fra
+ due sottoespressioni, a seconda del valore di
+ una terza sottoespressione.
address@hidden menu
+
address@hidden Valori di address@hidden
address@hidden Vero e falso in @command{awk}
address@hidden valori di address@hidden
address@hidden logico, valore, vero/falso
address@hidden falso, valore logico (zero o stringa nulla)
address@hidden vero, valore logico (diverso da zero e da stringa nulla)
+
address@hidden nulle, stringhe
+Molti linguaggi di programmazione hanno una particolare rappresentazione per i
+concetti di ``vero'' e ``falso.'' Questi linguaggi usano normalmente le
+costanti speciali @code{true} e @code{false}, o forse i loro equivalenti
+maiuscoli.
address@hidden @command{awk} @`e differente.
+Prende in prestito un concetto molto semplice di vero e falso dal linguaggio
+C. In @command{awk}, ogni valore numerico diverso da zero @emph{oppure}
+ogni valore di stringa non vuota @`e vero. Ogni altro valore (zero o la
stringa
+nulla, @code{""}) @`e falso. Il seguente programma stampa @samp{Uno strano
+valore di address@hidden tre volte:
+
address@hidden
+BEGIN @{
+ if (3.1415927)
+ print "Uno strano valore di address@hidden"
+ if ("Ottanta e sette anni or sono")
+ print "Uno strano valore di address@hidden"
+ if (j = 57)
+ print "Uno strano valore di address@hidden"
address@hidden
address@hidden example
+
address@hidden angolo buio, @code{"0"} @`e effettivamente vero
+C'@`e una conseguenza sorprendente della regola ``non zero o non nullo'':
+la costante di stringa @code{"0"} sta effettivamente per vero, perch@'e
address@hidden non nulla.
address@hidden
+
address@hidden Tipi di variabile e confronti
address@hidden Tipi di variabile ed espressioni di confronto
address@hidden
address@hidden Guida galattica @`e infallibile. @`E la address@hidden, spesso,
a essere inesatta.}
address@hidden Douglas Adams, @cite{Guida galattica per autostoppisti}
address@hidden quotation
address@hidden 2/2015: Antonio Colombo points out that this is really from
address@hidden The Restaurant at the End of the Universe. But I'm going to
address@hidden leave it alone.
+
address@hidden confronto, espressioni di
address@hidden espressioni di confronto
address@hidden espressioni, ricerca di corrispondenze, si veda espressioni di
confronto
address@hidden individuazione, espressioni di, si veda espressioni di confronto
address@hidden relazionali, operatori, si veda espressioni di confronto
address@hidden operatori relazionali, si veda espressioni di confronto
address@hidden variabile, tipi di
address@hidden variabili, tipi di, espressioni di confronto e
+Diversamente che in altri linguaggi di programmazione, le variabili di
address@hidden non hanno un tipo fisso. Possono essere sia un numero che una
+stringa, a seconda del valore loro assegnato.
+Vediamo ora come viene assegnato il tipo a una variabile, e come @command{awk}
+le confronta.
+
address@hidden
+* Tipi di variabile:: Tipo stringa rispetto a tipo numero.
+* Operatori di confronto:: Gli operatori di confronto.
+* Confronto POSIX di stringhe:: Confronto tra stringhe usando le
+ regole POSIX.
address@hidden menu
+
address@hidden Tipi di variabile
address@hidden Tipo stringa rispetto a tipo numero
+
+Per gli elementi scalari in @command{awk} (variabili, elementi di
+vettore e campi), il tipo degli stessi viene attribuito @emph{dinamicamente}.
address@hidden significa che il tipo di un elemento address@hidden cambiare nel
corso
+dell'esecuzione di un programma, da @dfn{untyped} (non ancora tipizzata),
+valore assunto prima che la variabile sia utilizzata,@address@hidden
+chiama queste variabili @dfn{unassigned} (non ancora assegnate), come si
+vede dall'esempio che segue.} a stringa oppure a numero, e in seguito
+da stringa a numero o da numero a stringa, nel prosieguo del programma.
+(@command{gawk} prevede anche degli scalari di tipo @dfn{regexp}, ma
+per ora possiamo ignorarli;
address@hidden @dfn{regexp} forti}.)
+
+Non si address@hidden fare molto riguardo alle variabili di tipo @dfn{untyped},
+oltre a constatare che ancora non @`e stato loro attribuito un tipo.
+Il seguente programma confronta la variabile @code{a} con i valori
address@hidden""} e @code{0}; il confronto address@hidden esito positivo se alla
+variabile @code{a} non @`e mai stato assegnato un valore.
+L'esempio usa la funzione predefinita @code{typeof()}
+(non ancora trattata; @pxref{Funzioni per i tipi}) per
+visualizzare il tipo della variabile @code{a}:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print (a == "" && a == 0 ?}
+> @kbd{"a non ha un tipo" : "a ha un tipo!") ; print typeof(a) @}'}
address@hidden a non ha un tipo
address@hidden unassigned
address@hidden example
+
+Una variabile scalare diviene di tipo numerico quando le viene assegnato un
+valore numerico, per mezzo di una costante numerica, o tramite un'altra
+variabile scalare di tipo numerico:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ a = 42 ; print typeof(a)}
+> @kbd{b = a ; print typeof(b) @}'}
+number
+number
address@hidden example
+
+Analogamente, una variabile scalare diviene di tipo stringa quando le
+viene assegnato come valore una stringa, per mezzo di una costante stringa,
+o tramite un'altra variabile scalare di tipo stringa:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ a = "quarantadue" ; print typeof(a)}
+> @kbd{b = a ; print typeof(b) @}'}
+string
+string
address@hidden example
+
+Fin qui, tutto semplice e chiaro. Cosa succede, address@hidden, quando
address@hidden deve trattare dati forniti dall'utente?
+Il primo caso da considerare @`e quello dei campi di dati in input.
+Quale dovrebbe essere l'output del seguente programma?
+
address@hidden
+echo ciao | awk '@{ printf("%s %s < 42\n", $1,
+ ($1 < 42 ? "@`e" : "non @`e")) @}'
address@hidden example
+
address@hidden
+Poich@'e @samp{ciao} @`e un dato di tipo alfabetico, @command{awk}
address@hidden solo
+effettuare un confronto di tipo stringa. Internamente, il numero @code{42}
+viene convertito in @code{"42"} e vengono confrontate le due stringhe di
+valore @code{"ciao"} e @code{"42"}. Questo @`e il risultato:
+
address@hidden
+$ @kbd{echo ciao | awk '@{ printf("%s %s < 42\n", $1,}
+> @kbd{ ($1 < 42 ? "@`e" : "non @`e")) @}'}
address@hidden ciao non @`e < 42
address@hidden example
+
+Tuttavia, cosa succede quando un dato utente @emph{assomiglia} a un
+numero?
+Da un lato, in address@hidden, il dato in input @`e formato da alcuni
caratteri, non da
+valori numerici in formato binario. Ma, d'altro lato, il dato sembra
+numerico, e @command{awk} dovrebbe davvero trattarlo come tale. E in effetti
+questo @`e address@hidden che avviene:
+
address@hidden
+$ @kbd{echo 37 | awk '@{ printf("%s %s < 42\n", $1,}
+> @kbd{ ($1 < 42 ? "@`e" : "non @`e")) @}'}
address@hidden 37 is < 42
address@hidden example
+
+Queste sono le regole seguite per determinare quando @command{awk}
+tratta dei dati in input come numeri, e quando li considera stringhe.
+
address@hidden numeriche, stringhe
address@hidden stringhe, numeriche
address@hidden POSIX @command{awk}, stringhe numeriche e
+Lo standard POSIX usa il concetto di @dfn{stringa numerica}, per dei dati
+in input che appaiono essere numerici. Il @samp{37} nell'esempio precedente
address@hidden una stringa numerica. Quindi, qual @`e il tipo di una stringa
numerica?
+Risposta: numerico.
+
+Il tipo di una variabile @`e importante perch@'e il tipo di due variabili
+determina il modo con cui le stesse vengono confrontate.
+La determinazione del tipo di variabile segue queste regole:
+
address@hidden @value{BULLET}
address@hidden
+Una costante numerica o il risultato di un'operazione numerica ha l'attributo
address@hidden
+
address@hidden
+Una costante di stringa o il risultato di un'operazione di stringa ha
+l'attributo @dfn{string}.
+
address@hidden
+Campi, input tramite @code{getline}, @code{FILENAME}, elementi di
address@hidden, elementi di @code{ENVIRON}, e gli elementi di un vettore
+creato da @code{match()}, @code{split()} e @code{patsplit()} che sono
+stringhe numeriche hanno l'attributo @address@hidden, una
+stringa numerica POSIX e una variabile tipo @dfn{strnum} di @command{gawk}
+sono equivalenti.}
+Altrimenti, hanno l'attributo @dfn{string}.
+Anche le variabili non inizializzate hanno l'attributo @var{strnum}.
+
address@hidden
+Gli attributi si trasmettono attraverso gli assegnamenti ma non vengono
+cambiati da nessun uso.
address@hidden (Although a use may cause the entity to acquire an additional
address@hidden value such that it has both a numeric and string value, this
leaves the
address@hidden attribute unchanged.)
address@hidden This is important but not relevant
address@hidden itemize
+
+L'ultima regola @`e particolarmente importante. Nel seguente programma,
address@hidden @`e di tipo numerico, anche se viene usata in un secondo momento
in
+un'operazione di stringa:
+
address@hidden
+BEGIN @{
+ a = 12.345
+ b = a " @`e un numero carino"
+ print b
address@hidden
address@hidden example
+
+Quando si confrontano due operandi, address@hidden essere usata sia il
confronto come
+stringa che il confronto numerico, a seconda degli attributi degli operandi,
+secondo questa matrice simmetrica:
+
address@hidden thanks to Karl Berry, address@hidden, for major help with TeX
tables
address@hidden
+\centerline{
+\vbox{\bigskip % space above the table (about 1 linespace)
+% Because we have vertical rules, we can't let TeX insert interline space
+% in its usual way.
+\offinterlineskip
+%
+% Define the table template. & separates columns, and \cr ends the
+% template (and each row). # is replaced by the text of that entry on
+% each row. The template for the first column breaks down like this:
+% \strut -- a way to make each line have the height and depth
+% of a normal line of type, since we turned off interline spacing.
+% \hfil -- infinite glue; has the effect of right-justifying in this case.
+% # -- replaced by the text (for instance, `STRNUM', in the last row).
+% \quad -- about the width of an `M'. Just separates the columns.
+%
+% The second column (\vrule#) is what generates the vertical rule that
+% spans table rows.
+%
+% The doubled && before the next entry means `repeat the following
+% template as many times as necessary on each line' -- in our case, twice.
+%
+% The template itself, \quad#\hfil, left-justifies with a little space before.
+%
+\halign{\strut\hfil#\quad&\vrule#&&\quad#\hfil\cr
+ &&STRING &NUMERIC &STRNUM\cr
+% The \omit tells TeX to skip inserting the template for this column on
+% this particular row. In this case, we only want a little extra space
+% to separate the heading row from the rule below it. the depth 2pt --
+% `\vrule depth 2pt' is that little space.
+\omit &depth 2pt\cr
+% This is the horizontal rule below the heading. Since it has nothing to
+% do with the columns of the table, we use \noalign to get it in there.
+\noalign{\hrule}
+% Like above, this time a little more space.
+\omit &depth 4pt\cr
+% The remaining rows have nothing special about them.
+STRING &&string &string &string\cr
+NUMERIC &&string &numeric &numeric\cr
+STRNUM &&string &numeric &numeric\cr
+}}}
address@hidden tex
address@hidden
address@hidden
address@hidden
+ +----------------------------------------------
+ | STRING NUMERIC STRNUM
+--------+----------------------------------------------
+ |
+STRING | string string string
+ |
+NUMERIC | string numeric numeric
+ |
+STRNUM | string numeric numeric
+--------+----------------------------------------------
address@hidden verbatim
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<informaltable>
+<tgroup cols="4">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<colspec colname="3" align="left"/>
+<colspec colname="4" align="left"/>
+<thead>
+<row>
+<entry/>
+<entry>STRING</entry>
+<entry>NUMERIC</entry>
+<entry>STRNUM</entry>
+</row>
+</thead>
+
+<tbody>
+<row>
+<entry><emphasis role="bold">STRING</emphasis></entry>
+<entry>string</entry>
+<entry>string</entry>
+<entry>string</entry>
+</row>
+
+<row>
+<entry><emphasis role="bold">NUMERIC</emphasis></entry>
+<entry>string</entry>
+<entry>numeric</entry>
+<entry>numeric</entry>
+</row>
+
+<row>
+<entry><emphasis role="bold">STRNUM</emphasis></entry>
+<entry>string</entry>
+<entry>numeric</entry>
+<entry>numeric</entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
+L'idea di base @`e che l'input dell'utente che appare come numerico---e
address@hidden l'input dell'utente---dovrebbe essere trattato come numerico,
anche
+se in address@hidden @`e un insieme di caratteri e quindi anche una stringa.
address@hidden@dotless{i}}, ad esempio, la costante di stringa @address@hidden"
+3.14"}},
+quando appare nel codice sorgente di un programma,
address@hidden una stringa---anche se sembra numerica---e non
+viene @emph{mai} trattato come numero
+ai fini di un confronto.
+
+In breve, quando un operando @`e una stringa ``pura'', come una costante di
+stringa, viene effettuato un confronto di stringa. In caso contrario viene
+effettuato un confronto numerico.
+(La differenza principale tra un numero e uno @dfn{strnum} @`e che per gli
address@hidden @command{gawk} conserva anche il valore originale della stringa
+che la variabile scalare aveva al momento in cui @`e stata letta.
+
+Questo punto merita di essere ulteriormente ribadito:
+l'input che appare essere un numero @address@hidden numerico.
+Tutto il resto dell'input @`e considerato essere una stringa.
+
address@hidden@dotless{i}}, la stringa in input di sei caratteri
@address@hidden +3.14}}
+riceve l'attributo @dfn{strnum}. Al contrario, la stringa di sei caratteri
address@hidden@code{" +3.14"}} che compaia nel testo di un programma rimane una
+costante di stringa. I seguenti esempi stampano @samp{1} quando il confronto
+fra due diverse costanti @`e vero, altrimenti stampano @samp{0}:
+
address@hidden 22.9.2014: Tested with mawk and BWK awk, got same results.
address@hidden
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == " +3.14") @}'} @ii{Vero}
address@hidden 1
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == "+3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == "3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == 3.14) @}'} @ii{Vero}
address@hidden 1
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == " +3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == "+3.14") @}'} @ii{Vero}
address@hidden 1
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == "3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == 3.14) @}'} @ii{Vero}
address@hidden 1
address@hidden example
+
+Per controllare il tipo di un campo in input (o di altro input immesso
+dall'utente, si address@hidden usare @code{typeof()}:
+
address@hidden
+$ @kbd{echo salve 37 | gawk '@{ print typeof($1), typeof($2) @}'}
address@hidden string strnum
address@hidden example
+
address@hidden Operatori di confronto
address@hidden Operatori di confronto
+
+Le @dfn{espressioni di confronto} confrontano stringhe o numeri per metterli in
+relazione tra di loro, come ad esempio nella relazione di uguaglianza. Sono
+scritte usando @dfn{operatori di relazione}, che sono un superinsieme di quelli
+in C. Sono descritti nella @ref{table-relational-ops}.
+
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<}
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<=}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>=}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>}
address@hidden @code{=} (uguale), operatore @code{==}
address@hidden uguale (@code{=}), operatore @code{==}
address@hidden @code{!} (punto esclamativo), operatore @code{!=}
address@hidden punto esclamativo (@code{!}), operatore @code{!=}
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @code{in}, operatore
address@hidden Tabella,table-relational-ops
address@hidden di relazione}
address@hidden @columnfractions .23 .77
address@hidden Espressione @tab Risultato
address@hidden @var{x} @code{<} @var{y} @tab Vero se @var{x} @`e minore di
@var{y}
address@hidden @var{x} @code{<=} @var{y} @tab Vero se @var{x} @`e minore o
uguale a @var{y}
address@hidden @var{x} @code{>} @var{y} @tab Vero se @var{x} @`e maggiore di
@var{y}
address@hidden @var{x} @code{>=} @var{y} @tab Vero se @var{x} @`e maggiore o
uguale a @var{y}
address@hidden @var{x} @code{==} @var{y} @tab Vero se @var{x} @`e uguale a
@var{y}
address@hidden @var{x} @code{!=} @var{y} @tab Vero se @var{x} @`e diverso da
@var{y}
address@hidden @var{x} @code{~} @var{y} @tab Vero se la stringa @var{x}
corrisponde alla @dfn{regexp} rappresentata da @var{y}
address@hidden @var{x} @code{!~} @var{y} @tab Vero se la stringa @var{x} non
corrisponde alla @dfn{regexp} rappresentata da @var{y}
address@hidden @var{indice} @code{in} @var{vettore} @tab Vero se il vettore
@var{vettore} ha un elemento con indice @var{indice}
address@hidden multitable
address@hidden float
+
+Le espressioni di confronto valgono uno se sono vere e zero se false.
+Quando si confrontano operandi di tipi diversi, gli operandi numerici sono
+convertiti in stringhe usando il valore di @code{CONVFMT}
+(@pxref{Conversione}).
+
+Il confronto tra stringhe avviene
+confrontando il primo carattere di ciascuna stringa, poi il secondo carattere,
+e address@hidden@dotless{i}} via. Quindi, @code{"10"} @`e minore di
@code{"9"}. Se vi sono due
+stringhe di cui una @`e il prefisso dell'altra, la stringa address@hidden
corta @`e minore di
+quella address@hidden lunga. address@hidden@dotless{i}}, @code{"abc"} @`e
minore di @code{"abcd"}.
+
address@hidden risoluzione di problemi, operatore @code{==}
address@hidden problemi, risoluzione di, operatore @code{==}
address@hidden molto facile sbagliarsi scrivendo l'operatore @samp{==} e
+omettendo uno dei due caratteri @samp{=}. Il risultato @`e sempre un codice
address@hidden valido, ma il programma non fa quel che si voleva:
+
address@hidden
+if (a = b) # oops! dovrebbe essere == b
+ @dots{}
+else
+ @dots{}
address@hidden example
+
address@hidden
+A meno che @code{b} non sia zero o la stringa nulla, la parte @code{if}
+del test ha sempre successo. Poich@'e gli operatori sono molto simili,
+questo tipo di errore @`e molto difficile da individuare
+rileggendo il codice sorgente.
+
+Il seguente elenco di espressioni illustra il tipo di confronti
+che @command{awk} effettua e il risultato di ciascun confronto:
+
address@hidden @code
address@hidden 1.5 <= 2.0
+Confronto numerico (vero)
+
address@hidden "abc" >= "xyz"
+Confronto tra stringhe (falso)
+
address@hidden 1.5 != " +2"
+Confronto tra stringhe (vero)
+
address@hidden "1e2" < "3"
+Confronto tra stringhe (vero)
+
address@hidden a = 2; b = "2"
address@hidden a == b
+Confronto tra stringhe (vero)
+
address@hidden a = 2; b = " +2"
address@hidden a == b
+Confronto tra stringhe (falso)
address@hidden table
+
+In quest'esempio:
+
address@hidden
+$ @kbd{echo 1e2 3 | awk '@{ print ($1 < $2) ? "vero" : "falso" @}'}
address@hidden falso
address@hidden example
+
address@hidden espressioni di confronto, stringa vs.@: @dfn{regexp}
address@hidden @cindex string comparison vs.@: regexp comparison
address@hidden @cindex regexp comparison vs.@: string comparison
address@hidden
+il risultato @`e @samp{falso} perch@'e sia @code{$1} che @code{$2}
+sono immessi dall'utente. Sono stringhe numeriche---quindi hanno entrambe
+l'attributo @dfn{strnum}, che richiede un confronto di tipo numerico.
+Lo scopo delle regole di confronto e dell'uso di stringhe numeriche @`e quello
+di cercare di produrre il comportamento "meno inaspettato possibile",
+pur "facendo la cosa giusta".
+
+I confronti di stringhe e i confronti di espressioni regolari sono molto
+diversi. Per esempio:
+
address@hidden
+x == "att"
address@hidden example
+
address@hidden
+ha il valore uno, ossia @`e vero, se la variabile @code{x}
address@hidden precisamente @samp{att}. Al contrario:
+
address@hidden
+x ~ /att/
address@hidden example
+
address@hidden
+ha il valore uno se @code{x} contiene @samp{att}, come
address@hidden"Oh, che matto che sono!"}.
+
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
+L'operando di destra degli operatori @samp{~} e @samp{!~} address@hidden
essere sia una
+costante @dfn{regexp} (@code{/address@hidden@code{/}) che un'espressione
ordinaria.
+In quest'ultimo caso, il valore dell'espressione come stringa @`e usato come
una
address@hidden dinamica (@pxref{Uso di @dfn{regexp}}; e
address@hidden regolari calcolate}).
+
address@hidden @command{awk}, costanti @dfn{regexp} e
address@hidden costanti @dfn{regexp}
address@hidden @dfn{regexp}, costanti
+Un'espressione regolare costante tra due barre @`e di per s@'e anche
+un'espressione. @code{/@var{regexp}/} @`e un'abbreviazione per la seguente
+espressione di confronto:
+
address@hidden
+$0 ~ /@var{regexp}/
address@hidden example
+
+Una particolare posizione dove @code{/pippo/} @emph{non} @`e un'abbreviazione
di
address@hidden ~ /pippo/} @`e quella in cui @`e l'operando di destra di
@samp{~} o
address@hidden
address@hidden le costanti @dfn{regexp}},
+dove questo punto @`e trattato in maggiore dettaglio.
+
address@hidden Confronto POSIX di stringhe
address@hidden Confronto tra stringhe usando l'ordine di collazione locale
+
+Lo standard POSIX diceva che il confronto di stringhe viene effettuato secondo
+l'@dfn{ordine di collazione} locale. Questo @`e l'ordine secondo il quale sono
+disposti i caratteri, come definito dalla localizzazione (per una trattazione
address@hidden dettagliata, @pxref{Localizzazioni}). Quest'ordine normalmente
@`e molto
+diverso dal risultato ottenuto quando si esegue un confronto rigorosamente
+"carattere per carattere"address@hidden, il confronto di stringhe
+dovrebbe funzionare come se le stringhe fossero confrontate usando la
+funzione @code{strcoll()} di C.}
+
+Poich@'e questo comportamento differisce sensibilmente dalla pratica corrente,
address@hidden lo implementava solo quando eseguito in address@hidden POSIX
+(@pxref{Opzioni}).
+Quest'esempio ilustra la differenza, in una localizzazione
address@hidden:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf("ABC < abc = %s\n",}
+> @kbd{("ABC" < "abc" ? "TRUE" : "FALSE")) @}'}
address@hidden ABC < abc = TRUE
+$ @kbd{gawk --posix 'BEGIN @{ printf("ABC < abc = %s\n",}
+> @kbd{("ABC" < "abc" ? "TRUE" : "FALSE")) @}'}
address@hidden ABC < abc = FALSE
address@hidden example
+Fortunatamente, dal mese di agosto 2016, un confronto basato sull'ordine
+di collazione locale non @`e address@hidden richiesto per gli operatori
@code{==} e
address@hidden@footnote{Si consulti il sito web
address@hidden://austingroupbugs.net/view.php?id=1070,
+dell'Austin Group}.} Tuttavia, un confronto basato sull'ordine di
+collazione locale @`e ancora richiesto per gli operatori @code{<},
address@hidden<=}, @code{>} e @code{>=}. POSIX, quindi, raccomanda quanto
+segue:
+
address@hidden
+Poich@'e l'operatore @code{==} controlla che se le stringhe sono identiche,
+e non se sono nell'ordine di collazione locale, le applicazioni che
+devono controllare se le stringhe sono nell'ordine di collazione locale
+possono usare:
+
address@hidden
+a <= b && a >= b
address@hidden example
address@hidden quotation
+
+A partire dalla @value{PVERSION} 4.2, @command{gawk} continua a usare
+l'ordine di collazione locale per @code{<}, @code{<=}, @code{>}
+e @code{>=} solo se eseguito nella address@hidden POSIX.
+
address@hidden Operatori booleani
address@hidden Espressioni booleane
address@hidden @dfn{and}, operatore logico-booleano
address@hidden @dfn{or}, operatore logico-booleano
address@hidden @dfn{not}, operatore logico-booleano
address@hidden espressioni booleane
address@hidden booleane, espressioni
address@hidden operatori booleani, si veda espressioni booleane
address@hidden booleani, operatori, si veda espressioni booleane
address@hidden logici, operatori, si veda espressioni booleane
address@hidden operatori logici, si veda espressioni booleane
+
+Un'@dfn{espressione booleana} @`e una combinazione di espressioni di confronto
o
+espressioni di ricerca, che usa gli operatori booleani "or"
+(@samp{||}), "and" (@samp{&&}), e "not" (@samp{!}), facendo uso di
+parentesi per controllare le nidificazioni. Il valore di address@hidden
+dell'espressione booleana @`e calcolato calcolando i valori di address@hidden
delle
+espressioni componenti. Le espressioni booleane sono conosciute anche come
address@hidden logiche}. I due termini sono equivalenti.
+
+Le espressioni booleane possono essere usate in tutti i casi in cui @`e
possibile
+usare espressioni di confronto e di ricerca di corrispondenze. Si possono
+usare nelle istruzioni @code{if}, @code{while}, @code{do} e @code{for}
+(@pxref{Istruzioni}).
+Hanno valori numerici (uno se vero, zero se falso) che entrano in gioco
+se il risultato di un'espressione booleana @`e memorizzato in una variabile o
+se @`e usato nei calcoli.
+
+Inoltre, ogni espressione booleana @`e anche un modello di ricerca valido,
address@hidden@dotless{i}}
+se ne address@hidden usare uno come modello di ricerca per controllare
l'esecuzione di
+regole. Gli operatori booleani sono:
+
address@hidden @code
address@hidden @var{booleano1} && @var{booleano2}
+Vero se @var{booleano1} e @var{booleano2} sono entrambi veri. Per esempio,
+la seguente istruzione stampa il record in input corrente se contiene
+sia @samp{edu} che @samp{li}:
+
address@hidden
+if ($0 ~ /edu/ && $0 ~ /li/) print
address@hidden example
+
address@hidden effetti collaterali, operatori booleani
+La sottoespressione @var{booleano2} viene valutata solo se @var{booleano1}
address@hidden vero. Questo address@hidden comportare una differenza laddove
@var{booleano2} contenga
+espressioni che hanno effetti collaterali. Nel caso di @samp{$0 ~ /pippo/ &&
+($2 == pluto++)}, la variabile @code{pluto} non viene incrementata se non c'@`e
+nessuna sottostringa @samp{pippo} nel record.
+
address@hidden @var{booleano1} || @var{booleano2}
+Vero se almeno uno tra @var{booleano1} e @var{booleano2} @`e vero.
+Per esempio, la seguente istruzione stampa tutti i record dell'input che
+contengono @samp{edu} @emph{oppure}
address@hidden:
+
address@hidden
+if ($0 ~ /edu/ || $0 ~ /li/) print
address@hidden example
+
+La sottoespressione @var{booleano2} viene valutata solo se @var{booleano1}
address@hidden falso. Questo address@hidden comportare una differenza quando
@var{booleano2} contiene
+espressioni che hanno effetti collaterali.
+(address@hidden, questo confronto non individua mai i record che contengono sia
address@hidden che @samp{li}: non appena @samp{edu} viene trovato,
+l'intero confronto @`e concluso positivamente.)
+
address@hidden ! @var{booleano}
+Vero se @var{booleano} @`e falso. Per esempio,
+il seguente programma stampa @samp{nessuna home!} nel
+caso insolito che la variabile d'ambiente @env{HOME}
+non sia stata definita:
+
address@hidden
+BEGIN @{ if (! ("HOME" in ENVIRON))
+ print "nessuna home!" @}
address@hidden example
+
+(L'operatore @code{in} @`e descritto in
address@hidden elementi}.)
address@hidden table
+
address@hidden cortocircuito, operatori
address@hidden operatori di cortocircuito
address@hidden @code{&} (e commerciale), operatore @code{&&}
address@hidden e commerciale (@code{&}), operatore @code{&&}
address@hidden @code{|} (barra verticale), operatore @code{||}
address@hidden barra verticale (@code{|}), operatore @code{||}
+Gli operatori @samp{&&} e @samp{||} sono chiamati operatori di
address@hidden per il modo in cui funzionano. La valutazione dell'intera
+espressione @`e "cortocircuitata" se il risultato address@hidden
address@hidden essere determinato
+prima di aver completato interamente la valutazione.
+
address@hidden continuazione di riga
+Le istruzioni che finiscono con @samp{&&} o @samp{||} si possono continuare
+semplicemente mettendo un ritorno a capo dopo di esse. address@hidden non si
address@hidden mettere
+un ritorno a capo @emph{prima} di questi operatori senza usare la
+continuazione tramite la barra inversa (@pxref{Istruzioni/Righe}).
+
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden ritorno a capo
address@hidden variabili di tipo indicatore address@hidden
address@hidden @dfn{flag} [indicatore], variabili
+Il valore reale di un'espressione che usa l'operatore @samp{!} @`e uno
+o zero, a seconda del valore di address@hidden dell'espressione a cui
address@hidden applicato.
+L'operatore @samp{!} spesso @`e utile per cambiare il senso di una variabile
+indicatore address@hidden da falso a vero e viceversa. Per esempio, il seguente
+programma @`e un modo per stampare righe poste tra due speciali righe
+delimitatrici:
+
address@hidden
+$1 == "START" @{ pertinente = ! pertinente; next @}
+pertinente @{ print @}
+$1 == "END" @{ pertinente = ! pertinente; next @}
address@hidden example
+
address@hidden
+La variabile @code{pertinente}, address@hidden@dotless{i}} come tutte le
variabili di @command{awk},
address@hidden inizializzata a zero, che vale anche "falso". Quando viene
trovata
+una riga il cui primo campo @`e @samp{START}, il valore di @code{pertinente}
+viene commutato a vero, usando @samp{!}. La regola nella riga seguente stampa
righe finch@'e
address@hidden resta vero. Quando viene trovata una riga il cui primo
+campo @`e @samp{END}, @code{pertinente} viene nuovamente commutata a
address@hidden programma ha un bug; stampa righe che iniziano con
address@hidden Come si address@hidden risolvere?}
+
address@hidden
+Scott Deifik points out that this program isn't robust against
+bogus input data, but the point is to illustrate the use of `!',
+so we'll leave well enough alone.
address@hidden ignore
+
address@hidden comunemente, l'operatore @samp{!} viene usato nelle condizioni
delle
+istruzioni @code{if} e @code{while}, dove ha address@hidden senso formulare
espressioni
+logiche in negativo:
+
address@hidden
+if (! @var{qualche condizione} || @var{qualche altra condizione}) @{
+ @address@hidden fai un'operazione a piacere @dots{}}
address@hidden
address@hidden example
+
address@hidden @code{next}, istruzione
address@hidden NOTA
+L'istruzione @code{next} viene trattata in
address@hidden next}.
address@hidden dice ad @command{awk} di tralasciare il resto delle regole,
+leggere il record successivo, e iniziare a elaborare le regole partendo
+nuovamente dalla prima.
+Il motivo @`e quello di evitare di stampare le righe delimitatrici
address@hidden e @samp{END}.
address@hidden quotation
+
address@hidden Espressioni condizionali
address@hidden Espressioni condizionali
address@hidden condizionali, espressioni
address@hidden espressioni condizionali
address@hidden espressioni, selezionare
+
+Un'@dfn{espressione condizionale} @`e un tipo particolare di espressione che ha
+tre operandi. Consente di usare il primo valore dell'espressione per
+scegliere una o l'altra delle due ulteriori espressioni.
+L'espressione condizionale in @command{awk} @`e la stessa di quella del
+linguaggio C, ovvero:
+
address@hidden
address@hidden ? @var{espr-se-vero} : @var{espr-se-falso}
address@hidden example
+
address@hidden
+Ci sono tre sottoespressioni. La prima, @var{selettore}, viene sempre
+calcolata per prima. Se @`e "vera" (non zero o non nulla), viene poi calcolata
address@hidden e il suo valore diventa il valore dell'intera espressione.
+Altrimenti, la seconda espressione che viene calcolata @`e @var{espr-se-falso}
+e il suo valore diventa il valore dell'intera espressione.
+Per esempio, la seguente espressione produce il valore assoluto di @code{x}:
+
address@hidden
+x >= 0 ? x : -x
address@hidden example
+
address@hidden effetti collaterali, espressioni condizionali
+Ogni volta che viene calcolata un'espressione condizionale, solo una delle
+espressioni @var{espr-se-vero} e @var{espr-se-falso} viene usata; l'altra
address@hidden ignorata. Questo @`e importante quando le espressioni hanno
effetti
+collaterali. Per esempio, quest'espressione condizionale esamina l'elemento
address@hidden del vettore @code{a} o del vettore @code{b}, e incrementa
@code{i}:
+
address@hidden
+x == y ? a[i++] : b[i++]
address@hidden example
+
address@hidden
+Questa istruzione garantisce che @code{i} sia incrementato una volta sola
+per ogni esecuzione dell'istruzione stessa, perch@'e ogni volta viene eseguita
+solo una delle due espressioni di incremento, mentre l'altra viene
+ignorata.
address@hidden
address@hidden,
address@hidden iftex
address@hidden
address@hidden,
address@hidden ifnottex
+per maggiori informazioni sui vettori.
+
address@hidden differenze tra @command{awk} e @command{gawk}, continuazione di
riga
address@hidden continuazione di riga, @command{gawk}
address@hidden @command{gawk}, continuazione di riga in
+Come estensione minore di @command{gawk},
+un'istruzione che usa @samp{?:} si address@hidden continuare mettendo
+semplicemente un ritorno a capo dopo i due caratteri.
+Tuttavia, se si mette un ritorno a capo @emph{prima} dei due
+caratteri, la continuazione non funziona, se non si aggiunge anche la barra
inversa
+(@pxref{Istruzioni/Righe}).
+Se viene specificata l'opzione @option{--posix}
+(@pxref{Opzioni}), quest'estensione @`e disabilitata.
+
address@hidden Chiamate di funzione
address@hidden Chiamate di funzione
address@hidden chiamata di funzione
+
+Una @dfn{funzione} @`e un nome per richiedere un particolare calcolo.
+Il nome permette di richiamare
+la funzione da qualsiasi punto del programma.
+Per esempio, la funzione @code{sqrt()} calcola la radice quadrata di un numero.
+
address@hidden funzioni predefinite
+Un certo numero di funzioni sono @dfn{predefinite}, ossia sono
+disponibili in ogni programma @command{awk}. La funzione @code{sqrt()} @`e una
+di queste. @xref{Funzioni predefinite} per un elenco di funzioni
+predefinite e per le loro rispettive descrizioni. In aggiunta, l'utente
address@hidden
+definire delle funzioni da usare nel proprio programma.
address@hidden definite dall'utente}
+per istruzioni su come farlo.
+Infine, @command{gawk} permette di scrivere funzioni in C o in C++ che possono
+essere chiamate dal proprio programma (@pxref{Estensioni dinamiche}).
+
address@hidden argomenti, nelle chiamate di funzione
+Una funzione viene utilizzata invocandola tramite un'espressione di
address@hidden di funzione}, che consiste nel nome della funzione seguito
+immediatamente da una lista di @dfn{argomenti} tra parentesi. Gli argomenti
+sono espressioni che forniscono i materiali grezzi su cui opera la funzione.
+Quando ci sono address@hidden argomenti, questi sono separati da virgole. Se
+non ci sono argomenti, basta scrivere @samp{()} dopo il nome della funzione.
+Gli esempi che seguono mostrano chiamate di funzione con e senza argomenti:
+
address@hidden
+sqrt(x^2 + y^2) @ii{un argomento}
+atan2(y, x) @ii{due argomenti}
+rand() @ii{nessun argomento}
address@hidden example
+
address@hidden risoluzione di problemi, sintassi della chiamata di funzione
address@hidden problemi, risoluzione di, sintassi della chiamata di funzione
address@hidden ATTENZIONE
+Non ci dev'essere nessuno spazio tra il nome della funzione e la parentesi
+aperta! Un nome di funzione definita dall'utente address@hidden essere
scambiata per
+il nome di una
+variabile: uno spazio renderebbe l'espressione simile alla concatenazione di
+una variabile con un'espressione racchiusa tra parentesi.
+Per le funzioni predefinite, lo spazio prima delle parentesi non crea problemi,
+ma @`e meglio non prendere l'abitudine di usare spazi per evitare errori con le
+funzioni definite dall'utente.
address@hidden quotation
+
+Ogni funzione richiede uno specifico numero di argomenti.
+Per esempio, la funzione @code{sqrt()} dev'essere chiamata con
+un solo argomento, il numero del quale si vuole estrarre la radice quadrata:
+
address@hidden
+sqrt(@var{argomento})
address@hidden example
+
+Alcune delle funzioni predefinite hanno uno o address@hidden argomenti
opzionali.
+Se questi argomenti non vengono forniti, le funzioni
+usano un valore di default appropriato.
address@hidden predefinite} per tutti i dettagli. Se sono omessi argomenti
+in chiamate a funzioni definite dall'utente, tali argomenti sono considerati
+essere variabili locali. Il valore di tali variabili locali
address@hidden la stringa nulla se usate in un contesto che richiede una
stringa
+di caratteri, e lo zero se @`e richiesto
+un valore numerico
+(@pxref{Funzioni definite dall'utente}).
+
+Come address@hidden avanzata, @command{gawk} prevede la address@hidden di
+effettuare chiamate di funzione
+indirette, il che permette di scegliere la funzione da chiamare al momento
+dell'esecuzione, invece che nel momento in cui si scrive il codice sorgente
+del programma.
+Si rimanda la trattazione di questa address@hidden
+a un secondo momento; si veda @ref{Chiamate indirette}.
+
address@hidden effetti collaterali, chiamate di funzione
+Come ogni altra espressione, la chiamata di funzione ha un valore, chiamato
+spesso @dfn{valore di ritorno}, che @`e calcolato dalla funzione
+in base agli argomenti dati. In quest'esempio, il valore di ritorno
+di @samp{sqrt(@var{argomento})} @`e la radice quadrata di @var{argomento}.
+Il seguente programma legge numeri, un numero per riga, e stampa
+la radice quadrata di ciascuno:
+
address@hidden
+$ @kbd{awk '@{ print "La radice quadrata di", $1, "@`e", sqrt($1) @}'}
address@hidden
address@hidden La radice quadrata di 1 @`e 1
address@hidden
address@hidden La radice quadrata di 3 @`e 1.73205
address@hidden
address@hidden La radice quadrata di 5 @`e 2.23607
address@hidden
address@hidden example
+
+Una funzione address@hidden avere anche effetti collaterali, come assegnare
+valori a certe variabili o effettuare operazioni di I/O.
+Questo programma mostra come la funzione @code{match()}
+(@pxref{Funzioni per stringhe})
+cambia le variabili @code{RSTART} e @code{RLENGTH}:
+
address@hidden
address@hidden
+ if (match($1, $2))
+ print RSTART, RLENGTH
+ else
+ print "non uguali"
address@hidden
address@hidden example
+
address@hidden
+Qui vediamo un'esecuzione di esempio:
+
address@hidden
+$ @kbd{awk -f matchit.awk}
address@hidden c+}
address@hidden 3 2
address@hidden pluto}
address@hidden non uguali
address@hidden e}
address@hidden 5 1
address@hidden example
+
address@hidden Precedenza
address@hidden Precedenza degli operatori (Come si nidificano gli operatori)
address@hidden precedenza
address@hidden operatori, precedenza
+
+La @dfn{precedenza degli operatori} determina come gli operatori vengono
+raggruppati quando diversi operatori appaiono uno vicino all'altro in
+un'espressione.
+Per esempio, @samp{*} ha una precedenza address@hidden alta di @samp{+};
address@hidden@dotless{i}},
address@hidden + b * c} moltiplica @code{b} e @code{c}, e poi aggiunge @code{a}
al
+prodotto (ovvero esegue @samp{a + (b * c)}).
+
+La normale precedenza degli operatori address@hidden essere cambiata usando
delle
+parentesi. Si possono vedere le regole di precedenza come un modo per
+indicare dove si sarebbero dovute mettere delle parentesi. Di fatto,
address@hidden cosa saggia usare sempre le parentesi
+in presenza di una combinazione di operatori insolita, perch@'e altre persone
+che leggono il programma potrebbero non ricordare quale sia la precedenza
+in quel particolare caso.
+Anche dei programmatori esperti a volte dimenticano le regole esatte,
+il che porta a commettere errori.
+Usare esplicitamente le parentesi previene qualunque errore
+di questo tipo.
+
+Quando vengono usati insieme operatori con uguale precedenza, quello
address@hidden a
+sinistra viene raggruppato per primo, ad eccezione degli operatori di
+assegnamento, condizionali e di elevamento a potenza, che vengono raggruppati
+nell'ordine opposto.
+Quindi, @samp{a - b + c} raggruppa come @samp{(a - b) + c} e
address@hidden = b = c} raggruppa come @samp{a = (b = c)}.
+
+Normalmente la precedenza degli operatori unari di prefisso non ha importanza,
+perch@'e c'@`e un solo modo di interpretarli: prima il address@hidden interno.
Quindi,
address@hidden significa @samp{$(++i)} e
address@hidden significa @samp{++($x)}. Tuttavia, quando un altro operatore
segue
+l'operando, la precedenza degli operatori unari address@hidden avere
importanza.
address@hidden significa @samp{($x)^2}, ma @samp{-x^2} significa
address@hidden(x^2)}, perch@'e @samp{-} ha precedenza address@hidden bassa
rispetto a @samp{^},
+mentre @samp{$} ha precedenza address@hidden alta.
+Inoltre, gli operatori non possono essere combinati in modo tale da violare le
+regole di precedenza; per esempio, @samp{$$0++--} non @`e un'espressione valida
+perch@'e il primo @samp{$} ha precedenza address@hidden alta di
address@hidden; per evitare il problema l'espressione address@hidden essere
scritta come
address@hidden($0++)--}.
+
+Questa lista illustra gli operatori di @command{awk}, in ordine di precedenza
+dalla address@hidden alta alla address@hidden bassa:
+
address@hidden @asis for docbook to come out right
address@hidden @asis
address@hidden @code{(address@hidden@code{)}
+Raggruppamento.
+
address@hidden @code{$} (dollaro), operatore di campo @code{$}
address@hidden dollaro (@code{$}), operatore di campo @code{$}
address@hidden @code{$}
+Riferimento a un campo.
+
address@hidden @code{+} (address@hidden), operatore @code{++}
address@hidden address@hidden (@code{+}), operatore @code{++}
address@hidden @code{-} (meno), operatore @code{--}
address@hidden meno (@code{-}), operatore @code{--}
address@hidden @code{++ --}
+Incremento, decremento.
+
address@hidden @code{^} (circonflesso), operatore @code{^}
address@hidden circonflesso (@code{^}), operatore @code{^}
address@hidden @code{*} (asterisco), operatore @code{**}
address@hidden asterisco (@code{*}), operatore @code{**}
address@hidden @code{^ **}
+Elevamento a potenza. Questi operatori sono raggruppati da destra verso
+sinistra.
+
address@hidden @code{+} (address@hidden), operatore @code{+}
address@hidden address@hidden (@code{+}), operatore @code{+}
address@hidden @code{-} (meno), operatore @code{-}
address@hidden meno (@code{-}), operatore @code{-}
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden @code{+ - !}
address@hidden, meno, ``not'' logico, unari.
+
address@hidden @code{*} (asterisco), operatore @code{*}, come operatore di
moltiplicazione
address@hidden asterisco (@code{*}), operatore @code{*}, come operatore di
moltiplicazione
address@hidden @code{/} (barra), operatore @code{/}
address@hidden barra (@code{/}), operatore @code{/}
address@hidden @code{%} (percento), operatore @code{%}
address@hidden percento (@code{%}), operatore @code{%}
address@hidden @code{* / %}
+Moltiplicazione, divisione, resto di una divisione.
+
address@hidden @code{+} (address@hidden), operatore @code{+}
address@hidden address@hidden (@code{+}), operatore @code{+}
address@hidden @code{-} (meno), operatore @code{-}
address@hidden meno (@code{-}), operatore @code{-}
address@hidden @code{+ -}
+Addizione, sottrazione.
+
address@hidden Concatenazione di stringhe
+Non c'@`e un simbolo speciale per la concatenazione.
+Gli operandi sono semplicemente scritti uno accanto all'altro.
+(@pxref{Concatenazione}).
+
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<}
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<=}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>=}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>}
address@hidden @code{=} (uguale), operatore @code{==}
address@hidden uguale (@code{=}), operatore @code{==}
address@hidden @code{!} (punto esclamativo), operatore @code{!=}
address@hidden punto esclamativo (@code{!}), operatore @code{!=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>>} (I/O)
address@hidden parentesi acuta destra (@code{>}), operatore @code{>>} (I/O)
address@hidden operatori, input/output
address@hidden @code{|} (barra verticale), operatore @code{|} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|} (I/O)
address@hidden operatori, input/output
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|&} (I/O)
address@hidden operatori, input/output
address@hidden @code{< <= == != > >= >> | |&}
+Operatori relazionali e ridirezione.
+Gli operatori relazionali e le ridirezioni hanno lo stesso livello di
+precedenza. I caratteri come @samp{>} servono sia come operatori relazionali
+che come ridirezioni; la distinzione tra i due significati dipende dal
+contesto.
+
address@hidden istruzione @code{print}, operatori I/O nell'
address@hidden istruzione @code{printf}, operatori I/O nell'
+Si noti che gli operatori di ridirezione I/O nelle istruzioni @code{print} e
address@hidden appartengono al livello dell'istruzione, non alle espressioni.
+La ridirezione non produce un'espressione che potrebbe essere l'operando di un
+altro operatore. Di conseguenza, non ha senso usare un operatore di
+ridirezione vicino a un altro operatore con precedenza address@hidden bassa
senza
+parentesi. Tali combinazioni generano errori di sintassi
+(p.es., @samp{print pippo > a ? b : c}).
+Il modo corretto di scrivere quest'istruzione @`e @samp{print pippo > (a ? b :
c)}.
+
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @code{~ !~}
+Corrispondenza, non corrispondenza.
+
address@hidden @code{in}, operatore
address@hidden @code{in}
+Appartenenza a un vettore.
+
address@hidden @code{&} (e commerciale), operatore @code{&&}
address@hidden e commerciale (@code{&}), operatore @code{&&}
address@hidden @code{&&}
+``and'' logico.
+
address@hidden @code{|} (barra verticale), operatore @code{||}
address@hidden barra verticale (@code{|}), operatore @code{||}
address@hidden @code{||}
+``or'' logico.
+
address@hidden @code{?} (punto interrogativo), operatore @code{?:}
address@hidden punto interrogativo (@code{?}), operatore @code{?:}
address@hidden @code{?:}
+Operatore condizionale. Questo operatore raggruppa da destra verso sinistra.
+
address@hidden @code{+} (address@hidden), operatore @code{+=}
address@hidden address@hidden (@code{+}), operatore @code{+=}
address@hidden @code{-} (meno), operatore @code{-=}
address@hidden meno (@code{-}), operatore @code{-=}
address@hidden @code{*} (asterisco), operatore @code{*=}
address@hidden asterisco (@code{*}), operatore @code{*=}
address@hidden @code{*} (asterisco), operatore @code{**=}
address@hidden asterisco (@code{*}), operatore @code{**=}
address@hidden @code{/} (barra), operatore @code{/=}
address@hidden barra (@code{/}), operatore @code{/=}
address@hidden @code{%} (percento), operatore @code{%=}
address@hidden percento (@code{%}), operatore @code{%=}
address@hidden @code{^} (circonflesso), operatore @code{^=}
address@hidden circonflesso (@code{^}), operatore @code{^=}
address@hidden @code{= += -= *= /= %= ^= **=}
+Assegnamento. Questi operatori raggruppano da destra verso sinistra.
address@hidden table
+
address@hidden POSIX @command{awk}, @code{**} e
address@hidden address@hidden, operatori, non in POSIX @command{awk}
address@hidden NOTA
+Gli operatori @samp{|&}, @samp{**} e @samp{**=} non sono definiti da POSIX.
+Per la massima address@hidden, @`e meglio non usarli.
address@hidden quotation
+
address@hidden Localizzazioni
address@hidden Il luogo fa la differenza
address@hidden localizzazione, definizione di
+
+I moderni sistemi prevedono la nozione di @dfn{localizzazione}: un modo per
+informare il sistema sulla serie di caratteri e sulla lingua locali.
+Lo standard ISO C definisce una localizzazione di default @code{"C"}, che @`e
+l'ambiente tipico a cui molti programmatori in C sono abituati.
+
+Un tempo, le impostazioni della localizzazione avevano influenza sulla
+ricerca di corrispondenze tramite @dfn{regexp}, ma ora non @`e address@hidden
address@hidden@dotless{i}}
+(@pxref{Intervalli e localizzazione}).
+
+La localizzazione address@hidden influire sulla separazione dei record. Per
il caso
+normale di @samp{RS = "\n"}, la localizzazione @`e generalmente irrilevante.
+Per altri separatori di record di un solo carattere, impostare
+la variabile d'ambiente @samp{LC_ALL=C}
+garantisce una migliore efficienza nella lettura dei record. Altrimenti,
address@hidden dovrebbe fare diverse chiamate di funzione, @emph{per ogni
+carattere in input}, per determinare la fine del record.
+
+La localizzazione address@hidden influire sulla formattazione delle date e
delle ore
+(@pxref{Funzioni di tempo}). Per esempio, un modo comune per abbreviare la
+data 4 settembre 2015, negli Stati Uniti @`e ``9/4/15.'' In molti paesi
+dell'Europa, invece, l'abbreviazione @`e "4.9.15". Quindi, la specifica di
+formato
address@hidden in una localizzazione @code{"US"} potrebbe produrre
@samp{9/4/15},
+mentre in una localizzazione @code{"EUROPA"}, potrebbe produrre @samp{4.9.15}.
+
+Secondo POSIX, anche il confronto tra stringhe @`e influenzato dalla
+localizzazione (come nelle espressioni regolari). I dettagli sono descritti in
address@hidden POSIX di stringhe}.
+
+Infine, la localizzazione influenza il valore del separatore decimale
+usato quando @command{gawk} analizza i dati in input. Questo @`e stato
+trattato nel dettaglio in @ref{Conversione}.
+
address@hidden Sommario delle espressioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Le espressioni sono gli elementi base dei calcoli eseguiti nei programmi.
+Sono costruite a partire da costanti, variabili, chiamate di funzione e dalla
+combinazione di vari tipi di valori tramite operatori.
+
address@hidden
address@hidden fornisce tre tipi di costanti: numerica, di stringa e
+di @dfn{regexp}. Le costanti numeriche in @command{gawk} si possono
+specificare nei sistemi ottale ed esadecimale (con base 8 e 16), e anche nel
+sistema decimale (base 10). In alcuni contesti, una costante @dfn{regexp}
+isolata come @code{/pippo/} ha lo stesso significato di @samp{$0 ~ /pippo/}.
+
address@hidden
+Le variabili contengono valori che possono essere usati diverse volte nei
+calcoli. Un certo numero di variabili predefinite forniscono informazioni al
+programma @command{awk}, mentre altre permettono il controllo del comportamento
+di @command{awk}.
+
address@hidden
+I numeri sono automaticamente convertiti in stringhe, e le stringhe in numeri,
+a seconda delle address@hidden di @command{awk}. I valori numerici sono
convertiti
+come se fossero formattati con @code{sprintf()} usando il formato contenuto in
address@hidden La localizzazione address@hidden influire sulle conversioni.
+
address@hidden
+In @command{awk} ci sono gli operatori aritmetici di uso comune (addizione,
+sottrazione, moltiplicazione, divisione, modulo), e il address@hidden e il
meno unari.
+Ci sono anche operatori di confronto, operatori booleani, una verifica
+dell'esistenza di una chiave in
+un vettore, e operatori per la ricerca di corrispondenze con espressioni
+regolari. La concatenazione di stringhe @`e effettuata mettendo due
espressioni
+una vicino all'altra; non c'@`e nessun operatore esplicito.
+L'operatore con tre operandi @samp{?:} fornisce una verifica ``if-else''
+all'interno delle espressioni.
+
address@hidden
+Gli operatori di assegnamento forniscono delle comode forme brevi per le comuni
+operazioni aritmetiche.
+
address@hidden
+In @command{awk}, un valore @`e considerato vero se @`e diverso da zero
address@hidden non nullo. Altrimenti, il valore @`e falso.
+
address@hidden
+Il tipo di una variabile viene impostata a ogni assegnamento e address@hidden
cambiare
+durante il suo ciclo di vita. Il tipo determina il comportamento della
+variabile nei confronti (di tipo stringa o numerici).
+
address@hidden
+Le chiamate di funzione restituiscono un valore che address@hidden essere
usato come parte
+di un'espressione address@hidden lunga. Le espressioni usate per passare
valori di
+parametro vengono valutate completamente prima di chiamare la funzione.
address@hidden fornisce funzioni predefinite e prevede quelle definite
+dall'utente; questo @`e descritto in
address@hidden
+
address@hidden
+La precedenza degli operatori specifica l'ordine secondo il quale vengono
+effettuate le operazioni, a meno che quest'ordine non sia esplicitamente
+alterato
+tramite parentesi. Le regole di precedenza degli operatori di @command{awk}
+sono compatibili con quelle del linguaggio C.
+
address@hidden
+La localizzazione address@hidden influire sul formato dei dati in uscita da un
programma
address@hidden, e occasionalmente sul formato dei dati letti in input.
+
address@hidden itemize
+
address@hidden Criteri di ricerca e azioni
address@hidden Criteri di ricerca, azioni e variabili
address@hidden criteri di ricerca
address@hidden @dfn{pattern}, si veda criteri di ricerca
address@hidden espressione di ricerca
+
+Come address@hidden visto, ogni istruzione @command{awk} consiste di un
criterio di
+ricerca address@hidden a cui @`e associata un'azione. Questo @value{CHAPTER}
+descrive come specificare criteri e azioni, cosa @`e possibile
+fare tramite le azioni e quali sono le variabili predefinite in
address@hidden
+
+Le regole @dfn{criterio di ricerca--azione} e le istruzioni che si possono
+dare all'interno delle azioni formano il nucleo centrale dei programmi
+scritti in @command{awk}.
+In un certo senso, tutto quanto si @`e visto finora costituisce le fondamenta
+sulle quali sono costruiti i programmi. @`E giunto il momento di iniziare a
+costruire qualcosa di utile.
+
address@hidden
+* Panoramica sui criteri di ricerca:: Come scrivere un criterio di ricerca.
+* Usare variabili di shell:: come usare variabili della shell in
+ @command{awk}.
+* Panoramica sulle azioni:: Come scrivere un'azione.
+* Istruzioni:: Descrizione dettagliata delle varie
+ istruzioni di controllo.
+* Variabili predefinite:: Sommario delle variabili predefinite.
+* Sommario criteri e azioni:: Sommario di criteri di ricerca e azioni.
address@hidden menu
+
address@hidden Panoramica sui criteri di ricerca
address@hidden Elementi di un criterio di ricerca
+
address@hidden
+* @dfn{regexp} come criteri di ricerca:: Usare espressioni regolari come
+ criteri di ricerca.
+* Espressioni come criteri di ricerca:: Qualsiasi espressione address@hidden
servire da
+ criterio di ricerca.
+* Intervalli:: Coppie di espressioni regolari per
+ delimitare una ricerca.
+* BEGIN/END:: Specificare regole di inizio e fine programma.
+* BEGINFILE/ENDFILE:: Due condizioni speciali per controlli avanzati.
+* Vuoto:: Il criterio di ricerca vuoto, che
+ corrisponde a ogni record.
address@hidden menu
+
address@hidden criteri di ricerca, tipi di
+I criteri di ricerca in @command{awk} controllano l'esecuzione di
+azioni: un'azione viene eseguita
+quando il criterio di ricerca associato ad essa @`e soddisfatto dal
+record in input corrente.
+La tabella seguente @`e un sommario dei tipi di criteri di ricerca in
address@hidden:
+
address@hidden @code
address@hidden /@var{espressione regolare}/
+Un'espressione regolare. @`E verificata quando il testo di un
+record in input corrisponde all'espressione regolare.
address@hidden
+(@xrefIl{Espressioni regolari}.)
address@hidden iftex
address@hidden
+(@xref{Espressioni regolari}.)
address@hidden ifnottex
+
address@hidden @var{espressione}
+Una singola espressione. @`E verificata quando il suo valore @`e
+diverso da zero (se di tipo numerico) o non nullo (se @`e una stringa).
+(@xref{Espressioni come criteri di ricerca}.)
+
address@hidden @var{inizio_interv}, @var{fine_interv}
+Una coppia di criteri di ricerca separati da una virgola, che specificano un
address@hidden di record.
+L'intervallo comprende sia il record iniziale che corrisponde a
@var{inizio_interv}
+sia il record finale che corrisponde a @var{fine_interv}.
+(@xref{Intervalli}.)
+
address@hidden BEGIN
address@hidden END
+Criteri di ricerca speciali che consentono azioni di inizializzazione o
+di pulizia in un programma @command{awk}.
+(@xref{BEGIN/END}.)
+
address@hidden BEGINFILE
address@hidden ENDFILE
+Criteri di ricerca speciali che consentono azioni di inizializzazione o di
+pulizia da eseguire all'inizio o alla fine di ogni file in input.
+(@xref{BEGINFILE/ENDFILE}.)
+
address@hidden @var{vuoto}
+Il criterio di ricerca vuoto corrisponde a ciascun record in input.
+(@xref{Vuoto}.)
address@hidden table
+
address@hidden @dfn{regexp} come criteri di ricerca
address@hidden Espressioni regolari come criteri di ricerca
address@hidden criteri di ricerca, espressioni come
address@hidden espressioni regolari, come criteri di ricerca
+
+Le espressioni regolari sono uno dei primi tipi di criteri di ricerca
+presentati in questo @value{DOCUMENT}.
+Questo tipo di criterio di ricerca @`e semplicemente una costante @dfn{regexp}
+posta nella parte @dfn{criterio di ricerca} di una regola. Equivale a
+scrivere @samp{$0 ~ /@var{criterio di ricerca}/}.
+Il criterio di ricerca @`e verificato quando il record in input corrisponde
+alla @dfn{regexp}.
+Per esempio:
+
address@hidden
+/pippo|pluto|paperino/ @{ personaggi_Disney++ @}
+END @{ print personaggi_Disney, "Personaggi Disney visti" @}
address@hidden example
+
address@hidden Espressioni come criteri di ricerca
address@hidden Espressioni come criteri di ricerca
address@hidden espressioni regolari, come criteri di ricerca
+
+Qualsiasi espressione @command{awk} address@hidden essere usata come un
criterio di
+ricerca @command{awk}.
+Il criterio di ricerca @`e verificato se il valore dell'espressione @`e diverso
+da zero (se @`e un numero), o non nullo (se @`e una stringa).
+L'espressione @`e ricalcolata ogni volta che la regola viene applicata a un
+nuovo record in input. Se l'espressione usa campi come @code{$1}, il suo
+valore dipende direttamente dal contenuto del record in input appena letto;
+altrimenti, dipende solo da quel che @`e accaduto fino a quel momento durante
+l'esecuzione del programma @command{awk}.
+
address@hidden espressioni di confronto, come criteri di ricerca
address@hidden criteri di ricerca, espressioni di confronto come
+Le espressioni di confronto, che usano gli operatori di confronto descritti in
address@hidden di variabile e confronti},
+sono un tipo di criterio di ricerca usato frequentemente.
+Anche le @dfn{regexp}, verificate o non verificate, sono tipi di espressioni
molto frequenti.
+L'operando a sinistra degli operatori @samp{~} e @samp{!~} @`e una stringa.
+L'operando di destra @`e un'espressione regolare costante delimitata da
+barre (@code{/@address@hidden/}) o qualsiasi espressione il cui valore come
+stringa @`e usato come un'espressione regolare dinamica
+(@pxref{Espressioni regolari calcolate}).
+L'esempio seguente stampa il secondo campo di ogni record in input
+il cui primo campo sia esattamente @samp{li}:
+
address@hidden @code{/} (barra), criteri di ricerca e
address@hidden barra (@code{/}), criteri di ricerca e
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden
+$ @kbd{awk '$1 == "li" @{ print $2 @}' mail-list}
address@hidden example
+
address@hidden
+(Il programma non stampa alcun output, perch@'e nessuna persona ha come nome
esattamente @samp{li}.)
+Si veda la differenza con il seguente confronto di espressione regolare, che
+individua invece qualsiasi record il cui primo campo @emph{contenga} @samp{li}:
+
address@hidden
+$ @kbd{awk '$1 ~ /li/ @{ print $2 @}' mail-list}
address@hidden 555-5553
address@hidden 555-6699
address@hidden example
+
address@hidden @dfn{regexp}, costanti, come criteri di ricerca
address@hidden criteri di ricerca, costanti @dfn{regexp} come
+Una costante @dfn{regexp} usata come criterio di ricerca @`e anche un
+caso speciale di criterio di ricerca costituito da un'espressione.
+All'espressione @code{/li/} viene assegnato il valore uno se @samp{li}
+viene trovato nel record in input corrente. Quindi, come criterio di ricerca,
address@hidden/li/} individua tutti i record che contengono la stringa
@samp{li}.
+
address@hidden espressioni booleane, come criteri di ricerca
+Anche le espressioni booleane sono frequentemente usate come criteri di
+ricerca. Se un criterio di ricerca
+individua o no un record in input dipende dalla verifica delle
+sottoespressioni da cui @`e composto.
+Per esempio, il seguente comando stampa tutti i record in
address@hidden che contengono sia @samp{edu} che @samp{li}:
+
address@hidden
+$ @kbd{awk '/edu/ && /li/' mail-list}
address@hidden Samuel 555-3430 samuel.lanceolis@@shu.edu A
address@hidden example
+
+Il seguente comando stampa tutti i record in
address@hidden che contengono @samp{edu} @emph{oppure} @samp{li}
+(o entrambi, naturalmente):
+
address@hidden
+$ @kbd{awk '/edu/ || /li/' mail-list}
address@hidden Amelia 555-5553 amelia.zodiacusque@@gmail.com F
address@hidden Broderick 555-0542 broderick.aliquotiens@@yahoo.com R
address@hidden Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
address@hidden Julie 555-6699 julie.perscrutabor@@skeeve.com F
address@hidden Samuel 555-3430 samuel.lanceolis@@shu.edu A
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden example
+
+Il seguente comando stampa tutti i record in
address@hidden che @emph{non} contengono la stringa @samp{li}:
+
address@hidden
+$ @kbd{awk '! /li/' mail-list}
address@hidden Anthony 555-3412 anthony.asserturo@@hotmail.com A
address@hidden Becky 555-7685 becky.algebrarum@@gmail.com A
address@hidden Bill 555-1675 bill.drowning@@hotmail.com A
address@hidden Camilla 555-2912 camilla.infusarum@@skynet.be R
address@hidden Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
address@hidden Martin 555-6480 martin.codicibus@@hotmail.com A
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, criteri di ricerca booleani e
address@hidden @code{END}, criterio di ricerca, criteri di ricerca booleani e
address@hidden @code{BEGINFILE}, criterio di ricerca, criteri di ricerca
booleani e
address@hidden @code{ENDFILE}, criterio di ricerca, criteri di ricerca booleani
e
+Le sottoespressioni di un'operatore booleano in un criterio di ricerca possono
+essere espressioni regolari costanti, confronti, o qualsiasi altra espressione
+di @command{awk}. Gli intervalli di ricerca
+non sono espressioni, e quindi non possono apparire all'interno di
+criteri di ricerca booleani. Analogamente, i criteri di ricerca speciali
address@hidden, @code{END}, @code{BEGINFILE} ed @code{ENDFILE},
+che non corrispondono ad alcun record in input, non sono espressioni e non
+possono essere usati all'interno di criteri di ricerca booleani.
+
+L'ordine di precedenza dei differenti operatori che possono essere usati nei
+criteri di ricerca @`e descritto in @ref{Precedenza}.
+
address@hidden Intervalli
address@hidden Specificare intervalli di record con i criteri di ricerca
+
address@hidden intervalli di ricerca
address@hidden criteri di ricerca, intervalli nei
address@hidden righe, individuare intervalli di
address@hidden @code{,} (virgola), negli intervalli di ricerca
address@hidden virgola (@code{,}), negli intervalli di ricerca
+Un @dfn{intervallo di ricerca} @`e composto da due criteri di ricerca
+separati da una virgola, nella forma
address@hidden@var{inizio_intervallo}, @var{fine_intervallo}}. @`E usato per
+individuare
+una serie di record consecutivi nei file in input. Il primo criterio di
+ricerca, @var{inizio_intervallo}, controlla dove inizia la serie di record,
+mentre @var{fine_intervallo} controlla dove finisce la serie stessa.
+L'esempio seguente:
+
address@hidden
+awk '$1 == "on", $1 == "off"' miofile
address@hidden example
+
address@hidden
+stampa ogni record in @file{miofile} incluso tra i due record che iniziano con
address@hidden/@samp{off}, estremi compresi.
+
+Un intervallo di ricerca inizia con la valutazione di
address@hidden per ogni record in input. Quando un record soddisfa
+la condizione @var{inizio_intervallo}, l'intervallo di ricerca @`e
address@hidden e l'intervallo di ricerca include anche quel
+record. Finch@'e l'intervallo di ricerca rimane attivo,
+automaticamente vengono trovate corrispondenze in ogni record in input letto.
+L'intervallo di ricerca verifica anche @var{fine_intervallo} per ogni
+record in input; quando la verifica ha successo, il
+criterio di ricerca viene @dfn{disattivato} a partire dal record seguente.
+Quindi il criterio di ricerca torna a controllare
address@hidden per ogni nuovo record.
+
address@hidden @code{if}, istruzione, address@hidden modificabili
+Il record che segnala l'inizio dell'intervallo
+di ricerca e quello che segnala la fine di quell'intervallo soddisfano
address@hidden il criterio di ricerca. Se non si vuole agire su tali record
+si possono scrivere istruzioni @code{if} nella parte @dfn{azione} della regola
+per distinguerli dai record che il programma @`e interessato a trattare.
+
address@hidden possibile che un criterio di ricerca sia attivato e disattivato
dallo
+stesso record. Se il record soddisfa entrambe le condizioni, l'azione @`e
+eseguita solo su quel record.
+Per esempio, si supponga che ci sia un testo tra due separatori identici
+(p.es., il simbolo @samp{%}), ognuno dei quali sia su una riga a parte, che
+dovrebbero essere ignorati. Un primo tentativo potrebbe essere quello di
+combinare un intervallo di ricerca che descrive il
+testo delimitato con l'istruzione
address@hidden
+(non ancora introdotta, @pxref{Istruzione next}).
+Con quest'istruzione @command{awk} non effettua alcuna azione sul record
+corrente e inizia di nuovo a elaborare il successivo record in input.
+Un tale programma @`e simile a questo:
+
address@hidden
+/^%$/,/^%$/ @{ next @}
+ @{ print @}
address@hidden example
+
address@hidden
address@hidden righe, saltare tra delimitatori
address@hidden @cindex @dfn{flag} variables
+Questo programma non funziona, perch@'e l'intervallo di ricerca @`e sia
attivato
+che disattivato dalla prima riga incontrata, quella costituita da un @samp{%}.
+Per ottenere l'effetto desiderato, si scriva il programma nella maniera che
+segue, utilizzando un @dfn{flag}:
+
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden
+/^%$/ @{ ignora = ! ignora; next @}
+ignora == 1 @{ next @} # ignora righe quando `ignora' @`e impostato a 1
address@hidden example
+
+In un intervallo di ricerca, la virgola (@samp{,}) ha la
+precedenza address@hidden bassa tra tutti gli operatori (address@hidden, @`e
l'ultima a essere
+valutata). Il programma seguente tenta di combinare un intervallo di
+ricerca con un altro controllo, address@hidden semplice:
+
address@hidden
+echo Yes | awk '/1/,/2/ || /Yes/'
address@hidden example
+
+L'intenzione in questo programma @`e quello di esprimere le condizioni
address@hidden(/1/,/2/) || /Yes/}.
+Tuttavia, @command{awk} lo interpreta come se fosse
address@hidden/1/, (/2/ || /Yes/)}.
+Questo comportamento non address@hidden essere cambiato o evitato; gli
intervalli di
+ricerca non si possono combinare con altri criteri di ricerca:
+
address@hidden
+$ @kbd{echo Yes | gawk '(/1/,/2/) || /Yes/'}
address@hidden gawk: riga com.:1: (/1/,/2/) || /Yes/
address@hidden gawk: riga com.:1: ^ syntax error
address@hidden example
+
address@hidden intervalli di ricerca, continuazione di riga e
+Come punto di secondaria importanza, nonostante sia stilisticamente poco
elegante,
+lo standard POSIX consente di andare a capo dopo la virgola
+in un intervallo di ricerca. @value{DARKCORNER}
address@hidden BEGIN/END
address@hidden I criteri di ricerca speciali @code{BEGIN} ed @code{END}
+
address@hidden @code{BEGIN}, criterio di ricerca
address@hidden @code{END}, criterio di ricerca
address@hidden criterio di ricerca @code{END}
+Tutti i criteri di ricerca fin qui descritti servono a individuare dei record
+in input.
+I criteri di ricerca speciali @code{BEGIN} ed @code{END} non hanno questo
scopo.
+Servono invece per effettuare azioni di inizializzazione o di pulizia nei
+programmi @command{awk}.
+Le regole @code{BEGIN} ed @code{END} devono prevedere azioni; non c'@`e
+un'azione di default per queste regole, perch@'e non c'@`e un record corrente
+quando sono invocate.
+Le regole @code{BEGIN} ed @code{END} sono spesso chiamate
+``blocchi @code{BEGIN} ed @code{END}'' da programmatori che usano @command{awk}
+da molto tempo.
+
address@hidden
+* Usare BEGIN/END:: Come e perch@'e usare regole BEGIN/END.
+* I/O e BEGIN/END:: Problemi di I/O nelle regole BEGIN/END.
address@hidden menu
+
address@hidden Usare BEGIN/END
address@hidden Azioni di inizializzazione e pulizia
+
address@hidden @code{BEGIN}, criterio di ricerca
address@hidden criterio di ricerca @code{BEGIN}
address@hidden @code{END}, criterio di ricerca
address@hidden criterio di ricerca @code{END}
+Una regola @code{BEGIN} @`e eseguita solo una volta, prima che sia letto il
+primo record in input. Analogamente, una regola @code{END} @`e eseguita
+solo una volta, dopo che tutto l'input @`e address@hidden stato letto. Per
esempio:
+
address@hidden
+$ @kbd{awk '}
+> @kbd{BEGIN @{ print "Analisi di \"li\"" @}}
+> @kbd{/li/ @{ ++n @}}
+> @kbd{END @{ print "\"li\" @`e presente in", n, "record." @}' mail-list}
address@hidden Analisi di "li"
address@hidden "li" @`e presente in 4 record.
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, operatori e
address@hidden @code{END}, criterio di ricerca, operatori e
address@hidden criterio di ricerca @code{END}, operatori e
+Questo programma trova il numero di record nel file in input
address@hidden che contengono la stringa @samp{li}. La regola @code{BEGIN}
+stampa un titolo per il rapporto. Non c'@`e bisogno di usare la regola
address@hidden per inizializzare il contatore @code{n} a zero, poich@'e
address@hidden lo fa
+automaticamente (@pxref{Variabili}).
+La seconda regola incrementa la variabile @code{n} ogni volta che si legge
+un record che soddisfa il criterio di ricerca @samp{li}. La regola @code{END}
+stampa il valore di @code{n} alla fine del programma.
+
+I criteri di ricerca speciali @code{BEGIN} ed @code{END} non possono essere
+usati negli intervalli,
+o con operatori booleani (in effetti, non possono essere combinati con nessun
+altro operatore).
+Un programma @command{awk} address@hidden avere molte regole @code{BEGIN} e/o
@code{END}.
+Queste sono eseguite nell'ordine in cui compaiono nel programma: tutte le
+regole @code{BEGIN} a inizio programma e tutte le regole @code{END}
+a fine programma.
+Le regole @code{BEGIN} ed @code{END} possono apparire in qualsiasi
+posizione all'interno del programma.
+Questa address@hidden @`e stata aggiunta nella versione 1987 di @command{awk}
ed
address@hidden inclusa nello standard POSIX.
+La versione originale (1978) di @command{awk} richiedeva che la regola
address@hidden fosse posta all'inizio del programma, e la regola
address@hidden alla fine del programma, e solo una regola per tipo era ammessa.
address@hidden non @`e address@hidden obbligatorio, ma @`e una buona idea
continuare a seguire questo
+modello per migliorare l'organizzazione e la address@hidden del programma.
+
+Regole multiple @code{BEGIN} ed @code{END} sono utili per scrivere funzioni
+di libreria, poich@'e ogni file di libreria address@hidden avere la sua
propria regola
address@hidden e/o @code{END} per fare la propria inizializzazione e/o pulizia.
+L'ordine in cui le funzioni di libreria sono menzionate nella riga dei comandi
+determina l'ordine in cui le rispettive regole @code{BEGIN} ed @code{END} sono
+eseguite. Per questo motivi, occorre prestare attenzione nello scrivere tali
+regole nei file di libreria, in modo che non sia importante
+l'ordine in cui tali regole vengono eseguite.
address@hidden per maggiori informazioni sull'uso di funzioni di libreria.
address@hidden
address@hidden di libreria},
address@hidden iftex
address@hidden
address@hidden di libreria},
address@hidden ifnottex
+per parecchie utili funzioni di libreria.
+
+Se un programma @command{awk} ha solo regole @code{BEGIN} e nessun'altra
+regola, il programma esce dopo aver eseguito le regole
address@hidden@footnote{La versione originale di @command{awk} continuava a
+leggere e ignorare i record in input fino alla fine del file.} Tuttavia, se
+una regola @code{END} esiste, l'intero input @`e letto, anche se non sono
+presenti altre regole nel programma. address@hidden viene fatto
necessariamente
+per permettere che
+la regola @code{END} faccia uso delle variabili @code{FNR} e @code{NR}.
+
address@hidden I/O e BEGIN/END
address@hidden Input/Output dalle regole @code{BEGIN} ed @code{END}
+
address@hidden input/output, dalle regole @code{BEGIN} ed @code{END}
+Ci sono parecchi punti (talora insidiosi) da tener presente se si fa dell'I/O
+all'interno di una regola @code{BEGIN} o @code{END}.
+Il primo ha a che fare con il valore di @code{$0} in una regola @code{BEGIN}.
+Poich@'e le regole @code{BEGIN} sono eseguite prima delle lettura di qualsiasi
+input, non c'@`e assolutamente alcun record in input, e quindi nessun campo,
+quando si eseguono delle regole @code{BEGIN}. I riferimento a @code{$0} e ai
+campi restituiscono una stringa nulla o zero, a seconda del contesto.
+Un modo per assegnare un valore effettivo a @code{$0} @`e di eseguire un
+comando @code{getline} senza indicare una variabile (@pxref{Getline}).
+Un altro modo @`e semplicemente quello di assegnare un valore a @code{$0}.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden differenze tra @command{awk} e @command{gawk}, criteri di
ricerca @code{BEGIN}/@code{END}
address@hidden POSIX @command{awk}, criteri di ricerca @code{BEGIN}/@code{END}
address@hidden @code{print}, istruzione, criteri di ricerca
@code{BEGIN}/@code{END} e
address@hidden @code{BEGIN}, criterio di ricerca, istruzione @code{print} e
address@hidden @code{END}, criterio di ricerca, istruzione @code{print} e
+Il secondo punto @`e simile al primo, ma in direzione opposta.
+Tradizionalmente, address@hidden che altro per problemi di implementazione,
@code{$0}
+e @code{NF} erano @emph{indefiniti} all'interno di una regola @code{END}.
+Lo standard POSIX prescrive che @code{NF} sia disponibile all'interno di una
+regola @code{END}. Contiene il numero di campi dell'ultimo record in input.
+Probabilmente per una svista, lo standard non specifica che @`e reso
+disponibile anche @code{$0}, sebbene possa apparire logico che sia
address@hidden@dotless{i}}.
+In effetti, BWK @command{awk}, @command{mawk} e @command{gawk} mantengono il
+valore di @code{$0} in modo che sia possibile usarlo all'interno delle regole
address@hidden Occorre peraltro tener presente che alcune altre implementazioni
+e parecchie tra le versioni address@hidden vecchie di Unix @command{awk} non si
+comportano address@hidden@dotless{i}}.
+
+Il terzo punto @`e una conseguenza dei primi due. Il significato di
address@hidden
+all'interno di una regola @code{BEGIN} o @code{END} @`e quello di sempre:
address@hidden $0}. Se @code{$0} @`e la stringa nulla, stampa una riga vuota.
+Molti programmatori di lungo corso di @command{awk} usano un semplice
address@hidden all'interno delle regole @code{BEGIN} ed @code{END},
+intendendo @address@hidden ""}}, contando sul fatto che @code{$0} sia una
+stringa nulla. Sebbene questo funzioni solitamente con le regole
address@hidden, @`e una pessima idea nelle regole @code{END},
+almeno in @command{gawk}. @`E anche stilisticamente inelegante, perch@'e se
+serve una riga vuota in output, il programma dovrebbe stamparne
+una esplicitamente.
+
address@hidden @code{next}, istruzione, criteri di ricerca
@code{BEGIN}/@code{END} e
address@hidden @code{nextfile}, istruzione, criteri di ricerca
@code{BEGIN}/@code{END} e
address@hidden @code{BEGIN}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
address@hidden @code{END}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
+Per finire, le istruzioni @code{next} e @code{nextfile} non sono consentite
+all'interno di una regola @code{BEGIN}, perch@'e il ciclo implicito
+leggi-un-record-e-confrontalo-con-le-regole non @`e ancora iniziato.
+Analogamente, tali istruzioni non sono valide all'interno di una regola
address@hidden, perch@'e tutto l'input @`e address@hidden stato letto.
+(@xref{Istruzione next} e
address@hidden
address@hidden nextfile}.)
address@hidden ifnotdocbook
address@hidden
address@hidden nextfile}.)
address@hidden ifdocbook
+
address@hidden BEGINFILE/ENDFILE
address@hidden I criteri di ricerca speciali @code{BEGINFILE} ed @code{ENDFILE}
address@hidden @code{BEGINFILE}, criterio di ricerca
address@hidden @code{ENDFILE}, criterio di ricerca
address@hidden differenze tra @command{awk} e @command{gawk}, criteri di
ricerca @code{BEGINFILE}/@code{ENDFILE}
+
+Questa @value{SECTION} descrive una address@hidden specifica di @command{gawk}.
+
+Due tipi speciali di criterio di ricerca, @code{BEGINFILE} ed @code{ENDFILE},
+forniscono
+degli ``agganci'' per intervenire durante il ciclo di elaborazione dei file
+specificati sulla riga di comando di @command{gawk}.
+Come con le regole @code{BEGIN} ed @code{END}
address@hidden
address@hidden
+(@pxref{BEGIN/END}),
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+(si veda la @value{SECTION} precedente),
address@hidden iftex
address@hidden
+(si veda la @value{SECTION} precedente),
address@hidden ifdocbook
+tutte le regole @code{BEGINFILE} in un programma sono riunite, mantenendole
+nell'ordine in cui sono lette da @command{gawk} e lo stesso viene fatto
+per tutte le regole @code{ENDFILE}.
+
+Il corpo delle regole @code{BEGINFILE} @`e eseguito subito prima che
address@hidden legga il primo record da un file. La variabile @code{FILENAME}
address@hidden impostata al nome del file corrente e @code{FNR} @`e impostata a
zero.
+
+La regola @code{BEGINFILE} address@hidden la address@hidden di eseguire due
compiti
+che sarebbe difficile o impossibile effettuare altrimenti:
+
address@hidden @value{BULLET}
address@hidden
+Si address@hidden verificare che il file sia leggibile. Di solito, se un file
presente
+nella riga dei comandi non address@hidden essere aperto in lettura, il
programma
address@hidden viene terminato. Comunque, questo si address@hidden evitare,
per poi
+passare a elaborare il file successivo specificato sulla riga dei comandi.
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile, con criterio di ricerca @code{BEGINFILE}
address@hidden @code{nextfile}, istruzione, criteri di ricerca
@code{BEGINFILE}/@code{ENDFILE} e
+Questo controllo @`e fattibile controllando se la variabile @code{ERRNO} @`e
+diversa dalla stringa nulla; se @`e questo il caso, @command{gawk} non @`e
+riuscito ad aprire il file. In questo caso il programma address@hidden
eseguire
+un'istruzione @code{nextfile}
+(@pxref{Istruzione nextfile}). In questo modo @command{gawk} salta
+completamente l'elaborazione di quel file.
+In caso contrario, @command{gawk} termina come al solito con un
+errore fatale.
+
address@hidden
+Se sono state scritte estensioni che modificano la gestione del record
+(tramite l'inserzione di un ``analizzatore di input'';
address@hidden di input}), @`e possibile richiamarle
+a questo punto, prima che @command{gawk} inizi a elaborare il file.
+(Questa @`e una address@hidden @emph{molto} avanzata, usata al momento solo dal
address@hidden://sourceforge.net/projects/gawkextlib, progetto
@code{gawkextlib}}.)
address@hidden itemize
+
+La regola @code{ENDFILE} @`e chiamata quando @command{gawk} ha finito di
+elaborare l'ultimo record di un file in input. Per l'ultimo file in input,
address@hidden chiamata prima di ogni regola @code{END}.
+La regola @code{ENDFILE} @`e eseguita anche per file in input vuoti.
+
+Normalmente, se si verifica un errore di lettura durante il normale
+ciclo di elaborazione dell'input,
+questo @`e considerato fatale (il programma termina). Tuttavia, se @`e
presente
+una regola @code{ENDFILE}, l'errore non @`e considerato fatale, ma viene
+impostato @code{ERRNO}. address@hidden permette di intercettare ed elaborare
errori
+di I/O a livello di programma @command{awk}.
+
address@hidden @code{next}, istruzione, criteri di ricerca
@code{BEGINFILE}/@code{ENDFILE} e
+L'istruzione @code{next} (@pxref{Istruzione next}) non @`e permessa all'interno
+di una regola @code{BEGINFILE} o @code{ENDFILE}. L'istruzione @code{nextfile}
address@hidden consentita solo all'interno di una regola @code{BEGINFILE}, non
all'interno
+di una regola @code{ENDFILE}.
+
address@hidden @code{getline}, comando, criteri di ricerca
@code{BEGINFILE}/@code{ENDFILE} e
+L'istruzione @code{getline} (@pxref{Getline}) @`e limitata all'interno sia di
address@hidden che di @code{ENDFILE}: solo le forme ridirette di
+di @code{getline} sono permesse.
+
address@hidden ed @code{ENDFILE} sono estensioni @command{gawk}.
+In molte altre implementazioni di @command{awk} o se @command{gawk} @`e in
address@hidden compatibile (@pxref{Opzioni}), non sono regole speciali.
+
address@hidden FIXME: For 4.2 maybe deal with this?
address@hidden
+Date: Tue, 17 May 2011 02:06:10 PDT
+From: address@hidden (Pat Rankin)
+Message-Id: <address@hidden>
+Subject: BEGINFILE
+To: address@hidden
+
+ The documentation for BEGINFILE states that FNR is 0, which seems
+pretty obvious. It doesn't mention what the value of $0 is, and that's
+not obvious. I think setting it to null before starting the BEGINFILE
+action would be preferable to leaving whatever was there in the last
+record of the previous file.
+
+ ENDFILE can retain the last record in $0. I guess it has to if
+the END rule's actions see that value too. But the beginning of a new
+file doesn't just mean that the old one has been closed; the old file
+is being superseded, so leaving the old data around feels wrong to me.
+[If the user wants to keep it on hand, he or she can use an ENDFILE
+rule to grab it before moving on to the next file.]
address@hidden ignore
+
address@hidden Vuoto
address@hidden Il criterio di ricerca vuoto
+
address@hidden vuoto, criterio di ricerca
address@hidden criteri di ricerca vuoti
+Un criterio di ricerca vuoto (address@hidden omesso) corrisponde a
address@hidden record in input. Per esempio, il programma:
+
address@hidden
+awk '@{ print $1 @}' mail-list
address@hidden example
+
address@hidden
+stampa il primo campo di ogni record.
+
address@hidden Usare variabili di shell
address@hidden Usare variabili di shell in programmi
address@hidden shell, variabili di
address@hidden programmi @command{awk}, variabili di shell in
address@hidden @cindex shell and @command{awk} interaction
+
+I programmi @command{awk} sono spesso usati come componenti di programmi
address@hidden
+ampi, scritti in un linguaggio di shell.
+Per esempio, @`e molto comune usare una variabile di shell per
+specificare un criterio di ricerca che il programma @command{awk} deve poi
+individuare.
+Ci sono due modi per rendere disponibile il valore di una variabile di shell
+all'interno di un programma @command{awk}.
+
address@hidden shell, uso di doppio apice
+Un modo comune @`e quello di usare i doppi apici per sostituire il valore della
+variabile nel progamma @command{awk} contenuto nello @dfn{script}:
+
+Per esempio, si consideri il programma seguente:
+
address@hidden
+printf "Immettere il criterio di ricerca: "
+read criterio_di_ricerca
+awk "/$criterio_di_ricerca/ "'@{ num_trov++ @}
+ END @{ print num_trov, "occorrenze trovate" @}' /nome/file/dati
address@hidden example
+
address@hidden
+Il programma @command{awk} consiste di due pezzi di testo tra apici
+che, concatenati insieme, formano il programma.
+La prima parte @`e tra doppi apici, per consentire la sostituzione della
+variabile di shell @code{criterio_di_ricerca} contenuta al loro interno.
+La seconda parte @`e racchiusa tra apici singoli.
+
+La sostituzione di variabile attraverso gli apici funziona, ma address@hidden
+facilmente generare address@hidden Richiede una buona comprensione delle
+regole per l'uso degli apici nella shell
+(@pxref{Protezione}),
+e spesso @`e difficile accoppiare i vari apici quando si legge il programma.
+
+Un metodo migliore @`e quello di usare la address@hidden di assegnamento delle
+variabili di @command{awk}
+(@pxref{Opzioni di assegnamento})
+per assegnare il valore di una variabile di shell a una variabile
+di @command{awk}.
+Poi si possono usare @dfn{regexp} dinamiche come criterio di ricerca
+(@pxref{Espressioni regolari calcolate}).
+Quanto segue mostra come sarebbe l'esempio precedente usando questa tecnica:
+
address@hidden
+printf "Immettere il criterio di ricerca: "
+read criterio_di_ricerca
+awk -v crit="$criterio_di_ricerca" '$0 ~ crit @{ num_trov++ @}
+ END @{ print num_trov, "occorrenze trovate" @}' /nome/file/dati
address@hidden example
+
address@hidden
+Adesso il programma @command{awk} @`e solo una stringa tra apici semplici.
+L'assegnamento @samp{-v crit="$criterio_di_ricerca"} richiede ancora doppi
+apici, per il caso in cui uno spazio vuoto sia presente nel valore di
address@hidden
+La variabile @command{awk} @code{crit} potrebbe avere come nome anche
address@hidden, ma address@hidden potrebbe essere causa di confusione.
+Usare una variabile permette una maggiore address@hidden, poich@'e la variabile
address@hidden essere usata in ogni parte del
+programma---per stamparla, per indicizzare un vettore, o per qualsiasi altro
+scopo---senza che sia necessario l'artificio di doverla inserire usando gli
+apici.
+
address@hidden Panoramica sulle azioni
address@hidden Azioni
address@hidden @cindex action, definition of
address@hidden @cindex curly braces
address@hidden @cindex action, curly braces
address@hidden @cindex action, separating statements
address@hidden azioni
+
+Un programma o script @command{awk} consiste in una serie di
+regole e definizioni di funzione frammiste tra loro. (Le funzioni sono
+descritte address@hidden avanti. @xref{Funzioni definite dall'utente}.)
+Una regola contiene un criterio di ricerca e un'azione; l'uno o l'altra
+(ma non tutt'e due) possono essere omessi. Lo scopo di una @dfn{azione} @`e
+di specificare cosa deve fare @command{awk} quando si trova una corrispondenza
+con il criterio di ricerca. Quindi, schematicamente, un programma
address@hidden @`e normalmente simile a questo:
+
address@hidden
address@hidden di ricerca}] @address@hidden @var{azione} @}}
+ @var{criterio di ricerca} address@hidden@{ @var{azione} @}}]
address@hidden
address@hidden @var{nome}(@var{argomenti}) @{ @dots{} @}}
address@hidden
address@hidden display
+
address@hidden @address@hidden@}} (parentesi graffe), azioni e
address@hidden parentesi graffe (@address@hidden@}}), azioni e
address@hidden separatori, per istruzioni in azioni
address@hidden a capo, separatore di istruzioni nelle azioni
address@hidden @code{;} (punto e virgola), separare istruzioni nelle azioni
address@hidden punto e virgola (@code{;}), separare istruzioni nelle azioni
+Un'azione consiste di una o address@hidden @dfn{istruzioni} @command{awk},
racchiuse
+fra parentesi graffe (@address@hidden@address@hidden@}}). Ogni istruzione
specifica
+una cosa da fare. Le istruzioni sono separate tra loro da dei ritorni a capo o
+da dei punti e virgola.
+Le parentesi graffe attorno a un'azione vanno usate anche se l'azione
+contiene una sola istruzione o se non contiene alcuna istruzione.
+Comunque, se si omette completamente l'azione, si possono omettere anche le
+parentesi graffe. Un'azione omessa @`e equivalente a specificare
address@hidden@{ print $0 @}}:
+
address@hidden
+/pippo/ @{ @} @ii{se si trova @code{pippo}, non fare nulla --- azione
vuota}
+/pippo/ @ii{se si trova @code{pippo}, stampa il record --- azione
omessa}
address@hidden example
+
+I seguenti tipi di istruzione sono disponibili in @command{awk}:
+
address@hidden @asis
address@hidden effetti collaterali delle istruzioni
address@hidden istruzioni, effetti collaterali delle
address@hidden Espressioni
+Servono per chiamare funzioni o assegnare valori a variabili
address@hidden
+(@pxrefil{Espressioni}). L'esecuzione
address@hidden iftex
address@hidden
+(@pxref{Espressioni}). L'esecuzione
address@hidden ifnottex
+di questo tipo di istruzione calcola semplicemente il valore dell'espressione.
address@hidden @`e utile quando l'espressione ha effetti collaterali
+(@pxref{Operatori di assegnamento}).
+
address@hidden Istruzioni di controllo
+Specificano il flusso di controllo dei programmi @command{awk}.
+Il linguaggio @command{awk} utilizza dei costrutti simili a quelli del C,
+(@code{if}, @code{for}, @code{while} e @code{do}), e anche alcune altre
+di tipo speciale (@pxref{Istruzioni}).
+
address@hidden Istruzioni composte
+Sono una o address@hidden istruzioni racchiuse tra parentesi graffe.
Un'istruzione
+composta
address@hidden usata per riunire un gruppo di istruzioni all'interno di
+un'istruzione @code{if}, @code{while}, @code{do} o @code{for}.
+
address@hidden Istruzioni di input
+Usano il comando @code{getline}
+(@pxref{Getline}).
+In @command{awk} sono anche disponibili le istruzioni @code{next}
+(@pxref{Istruzione next})
+e @code{nextfile}
+(@pxref{Istruzione nextfile}).
+
address@hidden Istruzioni di output
+Come @code{print} e @code{printf}.
address@hidden
address@hidden
address@hidden iftex
address@hidden
address@hidden
address@hidden ifnottex
+
address@hidden Istruzioni di cancellazione
+Per eliminare elementi di vettori.
address@hidden
address@hidden table
+
address@hidden Istruzioni
address@hidden Istruzioni di controllo nelle azioni
address@hidden istruzioni di controllo
address@hidden controllo, tramite istruzioni, in azioni
address@hidden azioni, istruzioni di controllo in
+
+Le @dfn{istruzioni di controllo}, come @code{if}, @code{while} e
address@hidden@dotless{i}} via,
+regolano il flusso di esecuzione nei programmi @command{awk}. Molte tra
+le istruzioni di controllo di @command{awk} sono modellate sulle
+corrispondenti istruzioni in C.
address@hidden istruzioni address@hidden istruzioni di controllo e
address@hidden composte, address@hidden istruzioni di controllo e
address@hidden corpo, nelle azioni
address@hidden @address@hidden@}} (parentesi graffe), istruzioni, raggruppare
address@hidden parentesi graffe (@address@hidden@}}), istruzioni, raggruppare
address@hidden a capo, separatore di istruzioni nelle azioni
address@hidden @code{;} (punto e virgola), separare istruzioni nelle azioni
address@hidden punto e virgola (@code{;}), separare istruzioni nelle azioni
+Tutte le istruzioni di controllo iniziano con parole chiave speciali, come
address@hidden e @code{while}, per distinguerle dalle semplici espressioni.
+Molte istruzioni di controllo contengono altre istruzioni. Per esempio,
+l'istruzione @code{if} contiene un'altra istruzione che address@hidden essere
eseguita
+oppure no. Le istruzioni contenute sono chiamate @dfn{corpo}.
+Per includere address@hidden di un'istruzione nel corpo, queste vanno
raggruppate
+in una sola @dfn{istruzione composta} tra parentesi graffe, e separate tra
+loro con dei ritorni a capo o dei punti e virgola.
+
address@hidden
+* Istruzione if:: Eseguire in maniera condizionale
+ istruzioni @command{awk}.
+* Istruzione while:: Eseguire il ciclo finch@'e @`e
+ verificata una condizione.
+* Istruzione do:: Eseguire l'azione specificata, continuare
+ a eseguire il ciclo
+ finch@'e @`e verificata una condizione.
+* Istruzione for:: Un'altra istruzione iterativa, che
+ permette di specificare clausole
+ iniziali e di incremento.
+* Istruzione switch :: Valutazione di quale insieme di
+ istruzioni eseguire, a seconda del
+ valore assunto da una variabile.
+* Istruzione break:: Uscire subito dal ciclo address@hidden interno
+ in cui ci si trova.
+* Istruzione continue:: Andare alla fine del ciclo address@hidden
interno
+ in cui ci si trova.
+* Istruzione next:: Smettere di elaborare il record corrente.
+* Istruzione nextfile:: Smettere di elaborare il file corrente.
+* Istruzione exit:: Interrompere l'esecuzione di @command{awk}.
address@hidden menu
+
address@hidden Istruzione if
address@hidden L'istruzione @address@hidden
+
address@hidden istruzione @code{if}
address@hidden @code{if}, istruzione
+L'istruzione @address@hidden @`e quella che serve in @command{awk}
+per prendere decisioni. @`E simile
+a questa:
+
address@hidden
address@hidden (@var{condizione}) @var{se-vera-fai}} address@hidden
@var{se-falsa-fai}}]
address@hidden display
+
address@hidden
+La @var{condizione} @`e un'espressione che controlla quel che fa il resto
+dell'istruzione. Se la @var{condizione} @`e vera, viene eseguita la
+parte @var{se-vera-fai}; altrimenti viene
+eseguita la parte @var{se-falsa-fai}.
+La parte @code{else} dell'istruzione @`e
+facoltativa. La condizione @`e considerata falsa se il suo valore @`e zero o
+la stringa nulla; altrimenti, la condizione @`e vera.
+Si consideri quanto segue:
+
address@hidden
+if (x % 2 == 0)
+ print "x @`e pari"
+else
+ print "x @`e dispari"
address@hidden example
+
+In questo esempio, se l'espressione @samp{x % 2 == 0} @`e vera (address@hidden,
+se il valore di @code{x} @`e esattamente divisibile per due), allora viene
+eseguita la prima istruzione
address@hidden; altrimenti, viene eseguita la seconda istruzione @code{print}.
+Se la parola chiave @code{else} sta sulla stessa riga di @var{se-vera-fai}
+e se @var{se-vera-fai} non @`e un'istruzione composta (address@hidden, non @`e
racchiusa
+tra parentesi graffe), allora un punto e virgola deve separare
address@hidden dalla parola chiave @code{else}.
+Per chiarire questo, l'esempio precedente si address@hidden riscrivere come:
+
address@hidden
+if (x % 2 == 0) print "x @`e pari"; else
+ print "x @`e dispari"
address@hidden example
+
address@hidden
+Se il @samp{;} @`e omesso, @command{awk} non address@hidden interpretare
l'istruzione e
+segnala un errore di sintassi. Non si dovrebbero scrivere programmi in
+questo modo, perch@'e a chi li legge potrebbe sfuggire la parola chiave
address@hidden se non @`e la prima parola della riga.
+
address@hidden Istruzione while
address@hidden L'istruzione @code{while}
address@hidden @code{while}, istruzione
address@hidden istruzione @code{while}
address@hidden cicli
address@hidden cicli, @code{while}
address@hidden cicli, si veda anche @code{while}, istruzione
+
+Nella programmazione, un @dfn{ciclo} @`e una parte di un programma che
address@hidden
+essere eseguita due o address@hidden volte consecutivamente.
+L'istruzione @code{while} @`e la address@hidden semplice istruzione iterativa
in
address@hidden Esegue ripetutamente un'istruzione finch@'e una data
+condizione @`e vera. Per esempio:
+
address@hidden
+while (@var{condizione})
+ @var{corpo-del-ciclo}
address@hidden example
+
address@hidden corpo, nei cicli
address@hidden
address@hidden @`e un'istruzione detta @dfn{corpo} del ciclo,
+e @var{condizione} @`e un'espressione che controlla per quante volte il ciclo
+deve continuare a essere ripetuto.
+La prima cosa che l'istruzione @code{while} fa @`e un controllo della
address@hidden
+Se la @var{condizione} @`e vera, viene eseguita l'istruzione
address@hidden
address@hidden
+(La @var{condizione} @`e vera quando il suo valore
address@hidden diverso da zero e non @`e la stringa nulla.)
address@hidden ifinfo
+Dopo che le istruzioni in @var{corpo-del-ciclo} sono state eseguite,
address@hidden @`e controllata nuovamente, e se @`e ancora vera,
address@hidden viene eseguito ancora. Questo processo @`e ripetuto
+finch@'e @var{condizione} rimane vera. Se la @var{condizione} @`e falsa fin
+dall'inizio, il corpo del ciclo
+non viene eseguito per nulla, e @command{awk} continua con l'istruzione
+che viene dopo il ciclo.
+Questo esempio stampa i primi tre campi di ogni record in input, uno per
+riga:
+
address@hidden
+awk '
address@hidden
+ i = 1
+ while (i <= 3) @{
+ print $i
+ i++
+ @}
address@hidden' inventory-shipped
address@hidden example
+
address@hidden
+Il corpo di questo ciclo @`e un'istruzione composta racchiusa tra parentesi
graffe,
+che contiene due istruzioni.
+Il ciclo funziona in questo modo: all'inizio, il valore di @code{i} @`e
+impostato a 1.
+Poi, l'istruzione @code{while} controlla se @code{i} @`e minore o uguale a
+tre. address@hidden @`e vero quando @code{i} @`e uguale a 1, quindi il campo
address@hidden viene stampato. Quindi l'istruzione @samp{i++} incrementa il
+valore di @code{i}
+e il ciclo viene ripetuto. Il ciclo termina quando @code{i} assume il
+valore quattro.
+
+Un ritorno a capo non @`e richiesto tra la condizione e il corpo del ciclo;
+tuttavia, se lo si mette, il programma @`e di address@hidden facile
comprensione,
+a meno che il corpo del ciclo non sia un'istruzione composta, oppure se @`e
+qualcosa di molto semplice. Neppure il ritorno a capo dopo la parentesi graffa
+aperta che inizia l'istruzione composta @`e necessario, ma il
+programma @`e di lettura address@hidden difficile se lo si omette.
+
address@hidden Istruzione do
address@hidden L'istruzione @address@hidden
address@hidden @address@hidden
address@hidden cicli, @address@hidden
+
+Il ciclo @code{do} @`e una variazione dell'istruzione di ciclo @code{while}.
+Il ciclo @code{do} esegue il @var{corpo-del-ciclo} una volta e poi ripete il
address@hidden finch@'e la @var{condizione} rimane vera. @`E simile a questo:
address@hidden
+do
+ @var{corpo-del-ciclo}
+while (@var{condizione})
address@hidden example
+
+Anche se la @var{condizione} @`e falsa fin dall'inizio, il
@var{corpo-del-ciclo}
+viene eseguito almeno una volta (e solo una volta, a meno che
+l'esecuzione di @var{corpo-del-ciclo}
+non renda vera la @var{condizione}). Si confronti con il corrispondente
address@hidden:
+
address@hidden
+while (@var{condizione})
+ @var{corpo-del-ciclo}
address@hidden example
+
address@hidden
+Quest'istruzione non esegue il @var{corpo-del-ciclo} neppure una volta, se
+la @var{condizione} @`e falsa fin dall'inizio. Il seguente @`e un esempio di
address@hidden:
+
address@hidden
address@hidden
+ i = 1
+ do @{
+ print $0
+ i++
+ @} while (i <= 10)
address@hidden
address@hidden example
+
address@hidden
+Questo programma stampa ogni record in input per 10 volte. Non si tratta,
+peraltro, di un esempio molto realistico, perch@'e in questo caso un semplice
address@hidden sarebbe sufficiente. Questa osservazione riflette un'esperienza
+reale; solo occasionalmente @`e davvero necessario usare un @code{do}.
+
address@hidden Istruzione for
address@hidden L'istruzione @code{for}
address@hidden istruzione @code{for}
address@hidden @code{for}, istruzione
address@hidden cicli, @code{for}, iterativi
+
+L'istruzione @code{for} rende address@hidden agevole contare le iterazioni di
un ciclo.
+La forma generale dell'istruzione @code{for} @`e simile a questa:
+
address@hidden
+for (@var{inizializzazione}; @var{condizione}; @var{incremento})
+ @var{corpo-del-ciclo}
address@hidden example
+
address@hidden
+La parti @var{inizializzazione}, @var{condizione} e @var{incremento} sono
+espressioni @command{awk} a piacere, e @var{corpo-del-ciclo} indica qualsiasi
+istruzione @command{awk}.
+
+L'istruzione @code{for} comincia con l'esecuzione di @var{inizializzazione}.
+Poi, finch@'e
+la @var{condizione} @`e vera, esegue ripetutamente @var{corpo-del-ciclo},
+e quindi @var{incremento}. Tipicamente, @var{inizializzazione} imposta una
+variabile a zero o a uno, @var{incremento} aggiunge uno alla stessa e
address@hidden ne confronta il valore rispetto al numero desiderato di
+iterazioni.
+Per esempio:
+
address@hidden
+awk '
address@hidden
+ for (i = 1; i <= 3; i++)
+ print $i
address@hidden' inventory-shipped
address@hidden example
+
address@hidden
+Questo programma stampa i primi tre campi di ogni record in input, mettendo
+un campo su ogni riga.
+
+Non @`e possibile impostare
address@hidden di una variabile nella parte di
address@hidden senza usare un'istruzione di assegnamento multiplo,
+come @samp{x = y = 0}. address@hidden ha senso solo se tutti i valori iniziali
+sono uguali. (Ma @`e possibile inizializzare ulteriori variabili scrivendo
+i relativi assegnamenti come istruzioni separate @emph{prima} del ciclo
address@hidden)
+
address@hidden @cindex comma operator, not supported
+Lo stesso vale per la parte @var{incremento}. Se serve incrementare ulteriori
+variabili, questo va fatto con istruzioni separate alla fine del ciclo.
+L'espressione composta del linguaggio C, che usa l'operatore virgola [,]
+del C, sarebbe
+utile in questo contesto, ma non @`e
+prevista in @command{awk}.
+
+Molto spesso, @var{incremento} @`e un'espressione di incremento, come
+nell'esempio precedente. Ma questo non @`e obbligatorio; address@hidden
trattarsi di
+un'espressione qualsiasi. Per esempio,
+la seguente istruzione stampa tutte le potenze di due comprese
+tra 1 e 100:
+
address@hidden
+for (i = 1; i <= 100; i *= 2)
+ print i
address@hidden example
+
+Se non @`e necessaria, ognuna delle tre espressioni fra
+parentesi che segue la parola chiave @code{for} address@hidden essere omessa.
Quindi,
address@hidden@samp{for (; x > 0;)}} @`e equivalente a @address@hidden (x >
0)}}. Se la
address@hidden @`e omessa del tutto, @`e ritenuta sempre vera, producendo
+un @dfn{ciclo infinito} (address@hidden, un ciclo che non finisce mai).
+
+Molto spesso, un ciclo @code{for} @`e un'abbreviazione per un ciclo
@code{while},
+come si address@hidden vedere qui:
+
address@hidden
address@hidden
+while (@var{condizione}) @{
+ @var{corpo-del-ciclo}
+ @var{incremento}
address@hidden
address@hidden example
+
address@hidden cicli, istruzione @code{continue} e
address@hidden
+La sola eccezione @`e quando l'istruzione @code{continue}
+(@pxref{Istruzione continue}) @`e usata
+all'interno del ciclo. Se si modifica un'istruzione @code{for}
+sostituendola con un'istruzione @code{while}
address@hidden address@hidden cambiare l'effetto dell'istruzione
@code{continue} posta all'interno
+del ciclo.
+
+Il linguaggio @command{awk} ha un'istruzione @code{for} oltre all'istruzione
address@hidden perch@'e un ciclo @code{for} @`e spesso address@hidden semplice
da scrivere,
+e viene in mente address@hidden naturalmente.
+Contare il numero di iterazioni @`e
+molto frequente nei cicli. address@hidden essere address@hidden facile
pensare a questo conto come
+parte del ciclo, piuttosto che come qualcosa da fare all'interno del ciclo.
+
address@hidden @code{in}, operatore
address@hidden operatore @code{in}
+Esiste una versione alternativa al ciclo @code{for}, per esaminare tutti
+gli indici di un vettore:
+
address@hidden
+for (i in vettore)
+ @var{fai qualcosa con} vettore[i]
address@hidden example
+
address@hidden
address@hidden un intero vettore}
+per maggiori informazioni su questa versione del ciclo @code{for}.
+
address@hidden Istruzione switch
address@hidden L'istruzione @code{switch}
address@hidden @code{switch}, istruzione
address@hidden @code{case}, parola chiave
address@hidden parola chiave @code{case}
address@hidden @code{default}, parola chiave
address@hidden parola chiave @code{default}
+
+Questa @value{SECTION} descrive una address@hidden disponibile solo in
address@hidden
+Se @command{gawk} @`e in address@hidden compatibile (@pxref{Opzioni}),
+la address@hidden non @`e disponibile.
+
+L'istruzione @code{switch} consente di valutare un'espressione e di
+eseguire istruzioni se il valore trovato corrisponde a uno dei @code{case}
[casi] previsti.
+Le istruzioni @code{case} sono esaminate per cercare una corrispondenza
+nell'ordine in cui i casi sono definiti nel programma. Se nessuno dei
@code{case}
+corrisponde al valore dell'espressione, viene eseguita la sezione
address@hidden, se @`e stata specificata.
+
+Ogni @code{case} contiene una singola costante, che address@hidden essere un
numero,
+una stringa, o
+una @dfn{regexp}. Viene valutata l'espressione @code{switch}, e poi la
+costante di ogni @code{case} viene confrontata
+di volta in volta con il valore risultante.
+Il tipo di costante determina quale address@hidden il confronto: per i tipi
numerici o
+stringa si seguono le regole abituali. Per una costante @dfn{regexp} viene
+effettuato un confronto tra l'espressione e il valore di tipo stringa
+dell'espressione originale.
+Il formato generale dell'istruzione @code{switch} @`e simile a questo:
+
address@hidden
+switch (@var{espressione}) @{
+case @var{valore o espressione regolare}:
+ @var{corpo-del-caso}
+default:
+ @var{corpo-del-default}
address@hidden
address@hidden example
+
+Il flusso di controllo
+dell'istruzione @code{switch} funziona come per il linguaggio C. Una volta
+stabilita una corrispondenza con un dato caso, le istruzione che formano il
+corpo del caso sono eseguite, fino a che non venga trovata un'istruzione
address@hidden,
address@hidden, @code{next}, @code{nextfile} o @code{exit},
+o fino alla fine dell'istruzione @code{switch} medesima. Per esempio:
+
address@hidden
+while ((c = getopt(ARGC, ARGV, "aksx")) != -1) @{
+ switch (c) @{
+ case "a":
+ # stampa la dimensione di tutti i file
+ all_files = TRUE;
+ break
+ case "k":
+ BLOCK_SIZE = 1024 # in blocchi da 1 Kbyte
+ break
+ case "s":
+ # fa solo le somme
+ sum_only = TRUE
+ break
+ case "x":
+ # non esce dal filesystem
+ fts_flags = or(fts_flags, FTS_XDEV)
+ break
+ case "?":
+ default:
+ uso()
+ break
+ @}
address@hidden
address@hidden example
+
+Si noti che se nessuna delle istruzioni specificate qui arresta l'esecuzione
+di un'istruzione @code{case} per la quale @`e stata trovata una corrispondenza;
+l'esecuzione continua fino al successivo @code{case} finch@'e
+non viene interrotta. In questo esempio, il
address@hidden per @code{"?"} esegue quello di @code{default}, che consiste nel
+chiamare una funzione di nome @code{uso()}.
+(La funzione @code{getopt()} qui chiamata @`e descritta in
address@hidden getopt}.)
+
address@hidden Istruzione break
address@hidden L'istruzione @code{break}
address@hidden @code{break}, istruzione
address@hidden istruzione @code{break}
address@hidden cicli, uscita
address@hidden cicli, istruzione @code{break} e
+
+L'istruzione @code{break} esce dal ciclo address@hidden interno @code{for},
address@hidden o @code{do} dentro al quale si trova. L'esempio seguente
+trova, se esiste, il divisore address@hidden piccolo di un dato numero intero,
oppure
+dichiara che si tratta di un numero primo:
+
address@hidden
+# trova il divisore address@hidden piccolo di num
address@hidden
+ num = $1
+ for (divisore = 2; divisore * divisore <= num; divisore++) @{
+ if (num % divisore == 0)
+ break
+ @}
+ if (num % divisore == 0)
+ printf "Il address@hidden piccolo divisore di %d @`e %d\n", num,
divisore
+ else
+ printf "%d @`e un numero primo\n", num
address@hidden
address@hidden example
+
+Quando il resto della divisione @`e zero nella prima istruzione @code{if},
address@hidden immediatamente esce, a causa del @dfn{break}, dal ciclo
address@hidden in cui @`e contenuto. address@hidden vuol dire
+che @command{awk} prosegue immediatamente fino all'istruzione che viene dopo
+il ciclo, e continua l'elaborazione. (L'istruzione @code{break} @`e molto
+differente dall'istruzione @code{exit},
+la quale termina l'intero programma @command{awk}.
address@hidden exit}.)
+
+Il seguente programma mostra come la @var{condizione} di un'istruzione
address@hidden o @code{while} potrebbe essere sostituita da un'istruzione
address@hidden all'interno di un @code{if}:
+
address@hidden
+# trova il divisore address@hidden piccolo di num
address@hidden
+ num = $1
+ for (divisore = 2; ; divisore++) @{
+ if (num % divisore == 0) @{
+ printf "Il address@hidden piccolo divisore di %d @`e %d\n", num,
divisore
+ break
+ @}
+ if (divisore * divisore > num) @{
+ printf "%d @`e un numero primo\n", num
+ break
+ @}
+ @}
address@hidden
address@hidden example
+
+L'istruzione @code{break} @`e usata anche per terminare l'esecuzione di
+un'istruzione @code{switch}.
+Questo argomento @`e trattato in @ref{Istruzione switch}.
+
address@hidden @cindex @code{break}, outside of loops
address@hidden @cindex historical features
address@hidden @cindex @command{awk} language, POSIX version
address@hidden POSIX @command{awk}, @code{break} e
address@hidden angolo buio, istruzione @code{break}
address@hidden @command{gawk}, istruzione @code{break} in
address@hidden Brian Kernighan, @command{awk} di
+L'istruzione @code{break} non ha significato se
+usata fuori dal corpo di un ciclo o di un'istruzione @code{switch}.
+Tuttavia, anche se la cosa non @`e mai stata documentata,
+le prime implementazioni di @command{awk} consideravano l'istruzione
@code{break}
+esterna a un ciclo come un'istruzione @code{next}
+(@pxref{Istruzione next}).
address@hidden
+Versioni recenti di BWK @command{awk} non consentono address@hidden un tale
uso,
+e lo stesso fa @command{gawk}.
+
address@hidden Istruzione continue
address@hidden L'istruzione @code{continue}
+
address@hidden @code{continue}, istruzione
address@hidden istruzione @code{continue}
+Analogamente a @code{break}, l'istruzione @code{continue} @`e usata solo
+all'interno di cicli @code{for}, @code{while} e @code{do}. L'istruzione
+ignora il resto del corpo del ciclo, facendo address@hidden@dotless{i}} che la
successiva iterazione
+del ciclo inizi immediatamente. Questo comportamento @`e differente da quello
+di @code{break}, che esce completamente dal ciclo.
+
+L'istruzione @code{continue} in un ciclo @code{for} fa
address@hidden@dotless{i}} che @command{awk}
+ignori il resto del corpo del ciclo e prosegua l'esecuzione con l'espressione
address@hidden dell'istruzione @code{for}. Il seguente programma
address@hidden un esempio di address@hidden:
+
address@hidden
+BEGIN @{
+ for (x = 0; x <= 20; x++) @{
+ if (x == 5)
+ continue
+ printf "%d ", x
+ @}
+ print ""
address@hidden
address@hidden example
+
address@hidden
+Questo programma stampa tutti i numeri da 0 a 20---tranne il 5, in cui
+l'istruzione @code{printf} @`e saltata. Siccome l'incremento @samp{x++}
+non viene saltato, @code{x} non rimane fermo al valore 5. Si confronti il
ciclo
address@hidden dell'esempio precedente con il seguente ciclo @code{while}:
+
address@hidden
+BEGIN @{
+ x = 0
+ while (x <= 20) @{
+ if (x == 5)
+ continue
+ printf "%d ", x
+ x++
+ @}
+ print ""
address@hidden
address@hidden example
+
address@hidden
+Questo programma inizia un ciclo infinito dopo che @code{x} ha assunto il
+valore 5, poich@'e l'istruzione di incremento (@samp{x++}) non @`e mai
raggiunta.
+
address@hidden @cindex @code{continue}, fuori da un ciclo
address@hidden @cindex address@hidden del passato
address@hidden @cindex linguaggio @command{awk}, versione POSIX
address@hidden POSIX @command{awk}, istruzione @code{continue} e
address@hidden angolo buio, istruzione @code{continue}
address@hidden @command{gawk}, istruzione @code{continue} in
address@hidden Brian Kernighan, @command{awk} di
+L'istruzione @code{continue} non ha un significato speciale se appare in
+un'istruzione @code{switch}, e non ha alcun significato se usata fuori dal
+corpo di un ciclo. Le prime versioni di @command{awk} trattavano le
+istruzioni @code{continue} che erano fuori da un ciclo allo stesso modo con
+cui trattavano l'istruzione @code{break}
+fuori da un ciclo: come se fosse un'istruzione @code{next}
address@hidden FOR_PRINT
+(trattata nella @value{SECTION} seguente).
address@hidden ifset
address@hidden FOR_PRINT
+(@pxref{Istruzione next}).
address@hidden ifclear
address@hidden
+Versioni recenti di BWK @command{awk} non consentono address@hidden un tale
uso,
+e lo stesso vale per @command{gawk}.
+
address@hidden Istruzione next
address@hidden L'istruzione @code{next}
address@hidden @code{next}, istruzione
address@hidden istruzione @code{next}
+
+L'istruzione @code{next} fa address@hidden@dotless{i}} che @command{awk}
termini immediatamente
+l'elaborazione del record corrente e proceda a elaborare il record successivo.
address@hidden vuol dire che nessuna delle eventuali regole successive viene
eseguita
+per il record corrente e che il resto delle azioni presenti nella
+regola correntemente in esecuzione non viene eseguito.
+
+Si confronti quanto sopra con quel che fa la funzione @code{getline}
+(@pxref{Getline}). Anch'essa fa address@hidden@dotless{i}} che @command{awk}
legga il record
+successivo immediatamente, ma non altera il flusso del controllo in alcun
+modo (address@hidden, il resto dell'azione in esecuzione prosegue con il nuovo
record
+in input).
+
address@hidden @command{awk}, programmi, eseguire
+Al livello address@hidden alto, l'esecuzione di un programma @command{awk} @`e
un ciclo
+che legge un record in input e quindi confronta il criterio di ricerca di
+ciascuna regola con il record stesso. Se si vede questo ciclo come un
address@hidden il cui corpo contiene le regole, l'istruzione @code{next} @`e
analoga
+a un'istruzione @code{continue}. Salta, address@hidden, alla fine del corpo
di questo
+ciclo implicito
+ed esegue l'incremento (ovvero legge un altro record).
+
+Per esempio, si supponga che un programma @command{awk} agisca solo su record
+che hanno quattro campi, e che non dovrebbe terminare con un errore se trova
+dei record in input non validi. Per evitare di complicare il resto del
+programma, si address@hidden scrivere una regola ``filtro'' a inizio
programma, come
+mostrato in questo esempio:
+
address@hidden
+NF != 4 @{
+ printf("%s:%d: salto: NF != 4\n", FILENAME, FNR) > "/dev/stderr"
+ next
address@hidden
address@hidden example
+
address@hidden
+Siccome @`e presente un @code{next},
+le regole successive del programma non elaboreranno i record non validi.
+Il messaggio @`e ridiretto al flusso in output
address@hidden error}, sul quale vanno scritti i messaggi di errore.
+Per maggiori dettagli, si veda
address@hidden speciali}.
+
+Se l'istruzione @code{next} provoca il raggiungimento della fine del file
+in input, vengono eseguite le eventuali regole @code{END} presenti.
address@hidden/END}.
+
+L'istruzione @code{next} non @`e consentita all'interno delle regole
address@hidden ed @code{ENDFILE}.
address@hidden/ENDFILE}.
+
address@hidden @cindex @command{awk} language, POSIX version
address@hidden @cindex @code{next}, inside a user-defined function
address@hidden @code{BEGIN}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
address@hidden @code{END}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
address@hidden POSIX @command{awk}, istruzioni @code{next}/@code{nextfile} e
address@hidden @code{next}, istruzione, in funzioni definite dall'utente
address@hidden funzioni definite dall'utente, istruzioni
@code{next}/@code{nextfile} e
+Secondo lo standard POSIX, il comportamento di @command{awk} @`e indefinito
+se @code{next} @`e usato in una regola @code{BEGIN} o @code{END}.
address@hidden considera questo come un errore di sintassi. Sebbene POSIX
+non proibisca di usarlo,
+molte altre implementazioni di @command{awk} non consentono che l'istruzione
address@hidden sia usata all'interno del corpo di funzioni.
+(@pxref{Funzioni definite dall'utente}).
+Come tutte le altre istruzioni @code{next}, un'istruzione @code{next}
all'interno del
+corpo di una funzione legge il record successivo e inizia a elaborarlo
+a partire dalla prima regola del programma.
+
address@hidden Istruzione nextfile
address@hidden L'istruzione @code{nextfile}
address@hidden @code{nextfile}, istruzione
address@hidden istruzione @code{nextfile}
+
+L'istruzione @code{nextfile}
address@hidden simile all'istruzione @code{next}.
+Tuttavia, invece di terminare l'elaborazione del record corrente, l'istruzione
address@hidden richiede ad @command{awk} di terminare di elaborare il
address@hidden corrente.
+
+Alla fine dell'esecuzione dell'istruzione @code{nextfile},
address@hidden @`e
+aggiornato per contenere il nome del successivo @value{DF} elencato sulla riga
+di comando, @code{FNR} @`e reimpostato a uno, e l'elaborazione riparte con
+la prima regola del programma.
+Se l'istruzione @code{nextfile} raggiunge la fine dei file in input,
+vengono eseguite le eventuali regole @code{END} presenti.
+Un'eccezione a questo si ha se @code{nextfile} @`e invocata durante
+l'esecuzione di qualche istruzione all'interno di una regola @code{END};
+in questo caso, il programma viene terminato immediatamente.
address@hidden/END}.
+
+L'istruzione @code{nextfile} @`e utile quando ci sono parecchi @value{DF} da
+elaborare, ma non @`e necessario elaborare ogni record in ogni file.
+Senza @code{nextfile},
+per passare al successivo @value{DF}, un programma
+dovrebbe continuare a leggere i record che non gli servono. L'istruzione
address@hidden @`e una maniera molto address@hidden efficiente per ottenere lo
stesso
+risultato.
+
+In @command{gawk}, l'esecuzione di @code{nextfile} produce ulteriori effetti:
+le eventuali regole @code{ENDFILE}
+sono eseguite se @command{gawk} non
+si trova correntemente all'interno di una regola @code{END} o
address@hidden; @code{ARGIND} @`e
+incrementato e le eventuali regole @code{BEGINFILE} sono eseguite.
+(@code{ARGIND} non @`e stato ancora trattato.
address@hidden predefinite}.)
+
+In @command{gawk}, @code{nextfile} @`e utile all'interno di una regola
address@hidden per evitare di elaborare un file che altrimenti causerebbe
+un errore fatale in @command{gawk}.
+In questo caso, le regole @code{ENDFILE} non vengono eseguite.
address@hidden/ENDFILE}.
+
+Sebbene possa sembrare che @samp{close(FILENAME)} ottenga lo stesso
+risultato di @code{nextfile}, non @`e address@hidden@dotless{i}}.
@code{close()}
address@hidden essere usato solo per chiudere file, @dfn{pipe} e coprocessi che
siano
+stati aperti tramite ridirezioni. Non ha niente a che vedere con
+l'elaborazione principale che
address@hidden fa dei file elencati in @code{ARGV}.
+
address@hidden NOTA
+Per molti anni, @code{nextfile} @`e stata
+un'estensione comune. A settembre 2012 si @`e deciso di
+includerla nello standard POSIX.
+Si veda @uref{http://austingroupbugs.net/view.php?id=607, il sito web
dell'Austin Group}.
address@hidden quotation
+
address@hidden funzioni definite dall'utente, istruzioni
@code{next}/@code{nextfile} e
address@hidden @code{nextfile}, in funzioni definite dall'utente
address@hidden Brian Kernighan, @command{awk} di
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
+Le versioni correnti di BWK @command{awk} e @command{mawk}
+entrambe prevedono @code{nextfile}. Tuttavia, non sono consentite istruzioni
address@hidden all'interno del corpo delle funzioni
+(@pxref{Funzioni definite dall'utente}).
address@hidden lo permette; una @code{nextfile} all'interno del corpo di una
+funzione legge il primo record del file
+successivo e inizia l'elaborazione dello stesso
+a partire dalla prima regola del programma, esattamente come farebbe
+qualsiasi altra istruzione @code{nextfile}.
+
address@hidden Istruzione exit
address@hidden L'istruzione @code{exit}
+
address@hidden @code{exit}, istruzione
address@hidden istruzione @code{exit}
+L'istruzione @code{exit} fa address@hidden@dotless{i}} che @command{awk}
termini immediatamente
+l'esecuzione della regola corrente e che termini di elaborare l'input;
+qualsiasi input ancora da elaborare @`e ignorato. L'istruzione @code{exit} @`e
+scritta come segue:
+
address@hidden
address@hidden address@hidden di ritorno}]
address@hidden display
+
address@hidden @code{BEGIN}, criterio di ricerca, istruzione @code{exit} e
address@hidden criterio di ricerca @code{BEGIN}, istruzione @code{exit} e
address@hidden @code{END}, criterio di ricerca, istruzione @code{exit} e
address@hidden criterio di ricerca @code{END}, istruzione @code{exit} e
+Quando un'istruzione @code{exit} @`e eseguita all'interno di una regola
@code{BEGIN},
+il programma termina completamente l'elaborazione. Nessun record in input
+viene letto. Tuttavia, se una regola @code{END} @`e presente, come parte
+dell'esecuzione dell'istruzione @code{exit},
+la regola @code{END} viene eseguita
+(@pxref{BEGIN/END}).
+Se @code{exit} @`e usata nel corpo di una regola @code{END},
+il programma termina immediatamente.
+
+Un'istruzione @code{exit} che non fa parte di una regola @code{BEGIN} o
@code{END}
+termina l'esecuzione di qualsiasi ulteriore regola applicabile al record
+corrente, salta la lettura di qualsiasi record in input, ed esegue
+le eventuali regole @code{END}. @command{gawk} salta anche le eventuali regole
address@hidden, che non vengono eseguite.
+
+In questo caso,
+se non si desidera che la regola @code{END} venga eseguita, si deve impostare
+una variabile a un valore diverso da zero, prima di invocare l'istruzione
address@hidden e controllarne il valore nella regola @code{END}.
address@hidden assert}
+per un esempio di questo tipo.
+
address@hidden angolo buio, istruzione @code{exit}
+Se si specifica un argomento all'istruzione @code{exit}, il suo valore @`e
+usato come codice di ritorno finale dell'elaborazione @command{awk}. Se non
+viene specificato alcun argomento,
address@hidden fa terminare @command{awk} con un codice di ritorno di
+``successo''.
+Nel caso in cui un argomento
+sia specificato in una prima istruzione @code{exit} e poi @code{exit} sia
+chiamato una seconda volta all'interno di una regola @code{END} senza alcun
+argomento, @command{awk} usa il valore di ritorno specificato in precedenza.
address@hidden
address@hidden di ritorno} per maggiori informazioni.
+
address@hidden convenzioni di programmazione, istruzione @code{exit}
+Per esempio, si supponga che si sia verificata una condizione di errore
+difficile o impossibile da gestire. Convenzionalmente, i programmi la
+segnalano terminando con un codice di ritorno diverso da zero. Un programma
address@hidden address@hidden farlo usando un'istruzione @code{exit} con un
argomento
+diverso da zero, come mostrato nell'esempio seguente:
+
address@hidden
+BEGIN @{
+ if (("date" | getline data_corrente) <= 0) @{
+ print "Non riesco a ottenere la data dal sistema" > "/dev/stderr"
+ exit 1
+ @}
+ print "la data corrente @`e", data_corrente
+ close("date")
address@hidden
address@hidden example
+
address@hidden NOTA
+Per una completa address@hidden, i codici di ritorno dovrebbero essere compresi
+tra zero e 126, estremi compresi.
+Valori negativi e valori maggiori o uguali a 127, possono non generare
+risultati coerenti tra loro in sistemi operativi diversi.
address@hidden quotation
+
+
address@hidden Variabili predefinite
address@hidden Variabili predefinite
address@hidden predefinite, variabili
address@hidden variabili predefinite
+
+La maggior parte delle variabili @command{awk} sono disponibili per essere
+usate dall'utente secondo le proprie esigenze;
+queste variabili non cambiano mai di valore a meno che il
+programma non assegni loro dei valori, e non hanno alcuna influenza sul
+programma a meno che non si decida di utilizzarle nel programma.
+Tuttavia, alcune variabili in @command{awk} hanno dei significati speciali
+predefiniti.
address@hidden tiene conto di alcune di queste automaticamente, in modo da
+rendere possibile la richiesta ad @command{awk} di fare certe cose nella
+maniera desiderata. Altre variabili sono impostate automaticamente da
address@hidden, in modo da poter comunicare al programma in esecuzione
+informazioni sul modo di procedere interno di @command{awk}.
+
address@hidden @command{gawk}, variabili predefinite e
+Questa @value{SECTION} documenta tutte le variabili predefinite di
address@hidden; molte di queste variabili sono anche documentate nei
address@hidden che descrivono le loro aree di influenza.
+
address@hidden
+* Variabili modificabili dall'utente:: Variabili predefinite modificabili per
+ controllare @command{awk}.
+* Variabili auto-assegnate:: Variabili predefinite con cui
+ @command{awk} fornisce informazioni.
+* ARGC e ARGV:: Modi di usare @code{ARGC} e @code{ARGV}.
address@hidden menu
+
address@hidden Variabili modificabili dall'utente
address@hidden Variabili predefinite modificabili per controllare @command{awk}
address@hidden variabili predefinite, modificabili dall'utente
address@hidden modificabili dall'utente, variabili
+
+La seguente @`e una lista alfabetica di variabili che @`e possibile modificare
per
+controllare come @command{awk} gestisce alcuni compiti.
+
+Le variabili che sono specifiche di @command{gawk} sono contrassegnate da un
+cancelletto (@samp{#}). Queste variabili sono estensioni @command{gawk}.
+In altre implementazioni di @command{awk}, o se @command{gawk} @`e eseguito in
address@hidden compatibile
+(@pxref{Opzioni}), non hanno un significato speciale. (Eventuali eccezioni
+sono menzionate nella descrizione di ogni variabile.)
+
address@hidden @code
address@hidden @code{BINMODE}, variabile
address@hidden variabile @code{BINMODE}
address@hidden binario, input/output
address@hidden input/output binario
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{BINMODE}
address@hidden BINMODE #
+Su sistemi non-POSIX, questa variabile specifica l'uso della address@hidden
binaria
+per tutto l'I/O. I valori numerici di uno, due o tre specificano che i file
+in input, i file di output o tutti i file, rispettivamente, devono usare I/O
+binario.
+Un valore numerico inferiore a zero @`e trattato come zero e un valore
+numerico maggiore di tre @`e trattato
+come tre. Alternativamente, le stringhe @code{"r"} o @code{"w"} specificano
+che i file in input e i file in output,
+rispettivamente, devono usare
+I/O binario. Una stringa @code{"rw"} o @code{"wr"} indica che tutti i file
+devono usare I/O binario. Ogni altro valore di stringa @`e trattato come
address@hidden"rw"}, ma @command{gawk} genera un messaggio di avvertimento.
address@hidden @`e descritto in maggior
+dettaglio in @ref{Uso su PC}. @command{mawk} (@pxref{Altre versioni})
+prevede questa variabile, ma consente solo valori numerici.
+
address@hidden @code{CONVFMT}, variabile
address@hidden variabile @code{CONVFMT}
address@hidden POSIX @command{awk}, variabile @code{CONVFMT} e
address@hidden numeri, conversione in stringhe
address@hidden stringhe, conversione in numeri
address@hidden @code{CONVFMT}
+Una stringa che controlla la conversione di numeri in
+stringhe (@pxref{Conversione}).
+In effetti @`e la stringa passata come primo argomento alla funzione
address@hidden()}
+(@pxref{Funzioni per stringhe}).
+Il suo valore di default @`e @code{"%.6g"}.
address@hidden @`e stata introdotta dallo standard POSIX.
+
address@hidden @command{gawk}, variabile @code{FIELDWIDTHS} in
address@hidden @code{FIELDWIDTHS}, variabile
address@hidden variabile @code{FIELDWIDTHS}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{FIELDWIDTHS}
address@hidden separatori di campo, variabile @code{FIELDWIDTHS} e
address@hidden campo, separatori di, variabile @code{FIELDWIDTHS} e
address@hidden FIELDWIDTHS #
+Una lista di posizioni di colonna, separate da spazi, per dire a
address@hidden
+come dividere campi in input posti su colonne fisse.
+Assegnando un valore a @code{FIELDWIDTHS}, le variabili @code{FS} e
address@hidden
address@hidden vengono usate per effettuare la divisione in campi.
address@hidden costante} per maggiori informazioni.
+
address@hidden @command{gawk}, variabile @code{FPAT} in
address@hidden @code{FPAT}, variabile
address@hidden variabile @code{FPAT}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{FPAT}
address@hidden separatori di campo, variabile @code{FPAT} e
address@hidden campo, separatori di, variabile @code{FPAT} e
address@hidden FPAT #
+Un'espressione regolare (di tipo stringa) per dire a @command{gawk}
+di creare i campi utilizzando come delimitatore il testo che corrisponde
+all'espressione regolare.
+Assegnando un valore a @code{FPAT}
+le variabili @code{FS} e @code{FIELDWIDTHS}
address@hidden vengono usate per effettuare la divisione in campi.
address@hidden in base al contenuto} per maggiori informazioni.
+
address@hidden @code{FS}, variabile
address@hidden variabile @code{FS}
address@hidden campo, separatori di
address@hidden separatori di campo
address@hidden FS
+Il separatore dei campi in input (@pxref{Separatori di campo}).
+Il valore address@hidden essere una stringa di un solo carattere o
un'espressione
+regolare composta da address@hidden caratteri che individua il separatore tra
i campi
+dei record in input. Se il suo valore
address@hidden la stringa nulla (@code{""}),
+ogni singolo carattere del record costituisce un campo.
+(Questo comportamente @`e un'estensione @command{gawk}. POSIX @command{awk} non
+specifica il comportamento quando @code{FS} @`e la stringa nulla.
+Nonostante questo, alcune altre versioni di @command{awk} trattano @code{""}
+in modo speciale.)
+
address@hidden POSIX @command{awk}, variabile @code{FS} e
+Il valore di default @`e @address@hidden" "}}, una stringa consistente in un
singolo
+spazio. In via eccezionale, questo valore significa che qualsiasi sequenza
+di spazi, TAB, e/o ritorni a capo costituisce
+un solo separatore.
+Inoltre eventuali spazi, TAB e ritorni a capo all'inizio e alla fine
+del record in input vengono ignorati.
+
+Si address@hidden impostare il valore di @code{FS} sulla riga dei comandi
usando
+l'opzione @option{-F}:
+
address@hidden
+awk -F, '@var{programma}' @var{file-in-input}
address@hidden example
+
address@hidden @command{gawk}, separatori di campo e
+Se @command{gawk} sta usando @code{FIELDWIDTHS} o @code{FPAT}
+per separare i campi,
+assegnare un valore a @code{FS} fa address@hidden@dotless{i}} che
@command{gawk} torni alla
+separazione dei campi normale, fatta utilizzando la variabile @code{FS}.
+Un modo semplice per fare questo
address@hidden semplicemente quello di scrivere l'istruzione
address@hidden = FS}, aggiungendo magari un commento esplicativo.
+
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden @code{IGNORECASE}, variabile
address@hidden variabile @code{IGNORECASE}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{IGNORECASE}
address@hidden maiuscolo/minuscolo e confronti tra stringhe
address@hidden maiuscolo/minuscolo e @dfn{regexp}
address@hidden espressioni regolari, maiuscolo/minuscolo
address@hidden IGNORECASE #
+Se la variabile @code{IGNORECASE} @`e diversa da zero o dalla stringa nulla,
+tutti i confronti tra stringhe
+e tutti i confronti tra espressioni regolari sono insensibili
+alle differenze maiuscolo/minuscolo.
+Questo vale per il confronto tra @dfn{regexp}
+usando @samp{~} e @samp{!~}, per le funzioni @code{gensub()},
address@hidden()}, @code{index()}, @code{match()}, @code{patsplit()},
address@hidden()} e @code{sub()},
+per la determinazione della fine record con @code{RS} e per la divisione
+in campi con @code{FS} e @code{FPAT}.
+Tuttavia, il valore di @code{IGNORECASE} @emph{non} influenza gli indici
+dei vettori
+e non influenza la separazione dei campi qualora si usi un separatore di campo
+costituito da un unico carattere.
address@hidden
+
address@hidden @command{gawk}, variabile @code{LINT} in
address@hidden @code{LINT}, variabile
address@hidden variabile @code{LINT}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{LINT}
address@hidden @dfn{lint}, controlli
address@hidden controlli @dfn{lint}
address@hidden 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}
+(@pxref{Opzioni}).
+Con un valore di @code{"fatal"}, gli avvertimenti di @dfn{lint} generano un
errore
+fatale.
+Con un valore di @code{"invalid"}, sono inviati solo gli avvertimenti
+per cose che sono effettivamente non valide. (Questa parte non funziona
+ancora perfettamente.)
+Ogni altro valore @dfn{vero} stampa avvertimenti non fatali.
+Se @code{LINT} ha per valore @dfn{falso} nessun avvertimento @dfn{lint} viene
+stampato.
+
+Questa variabile @`e un'estensione @command{gawk}. Non ha un valore speciale
+per altre implementazioni di @command{awk}. A differenza di altre variabili
+speciali, modificare il valore di @code{LINT} altera la produzione di
+avvertimenti @dfn{lint} anche se @command{gawk} @`e in address@hidden
compatibile.
+Analogamente a come le opzioni
address@hidden e @option{--traditional} controllano in maniera indipendente
+diversi aspetti del comportamente di @command{gawk}, il controllo
+degli avvertimenti di @dfn{lint} durante l'esecuzione del programma @`e
indipendente
+dall'implementazione @command{awk} in esecuzione.
+
address@hidden @code{OFMT}, variabile
address@hidden variabile @code{OFMT}
address@hidden numeri, conversione in stringhe
address@hidden stringhe, conversione in numeri
address@hidden OFMT
address@hidden questa la stringa che controlla la conversione di numeri in
+stringhe (@pxref{Conversione}) quando li
+si stampa con l'istruzione
address@hidden Funziona passandola
+ come primo argomento alla funzione @code{sprintf()}
+(@pxref{Funzioni per stringhe}).
+Il suo valore di default @`e @code{"%.6g"}. Le prime versioni di @command{awk}
+usavano @code{OFMT} per specificare il formato da usare per convertire
+numeri in stringhe in espressioni generali; questo compito @`e ora svolto
+da @code{CONVFMT}.
+
address@hidden @code{sprintf()}, funzione, variabile @code{OFMT} e
address@hidden funzione @code{sprintf()}, variabile @code{OFMT} e
address@hidden @code{print}, istruzione, variabile @code{OFMT} e
address@hidden istruzione @code{print}, variabile @code{OFMT} e
address@hidden variabile @code{OFS}
address@hidden @code{OFS}, variabile
address@hidden campo, separatori di
address@hidden separatori di campo
address@hidden OFS
address@hidden il separatore dei campi in output (@pxref{Separatori di
output}). @`E address@hidden
+che viene stampato in output per separare i campi stampati da un'istruzione
@code{print}.
+Il suo valore di default @`e @address@hidden" "}}, una stringa costituita da
un solo
+spazio.
+
address@hidden @code{ORS}, variabile
address@hidden variabile @code{ORS}
address@hidden ORS
+Il separatore dei record in output. Viene stampato alla fine di ogni
+istruzione @code{print}. Il suo valore di default @`e @code{"\n"},
+il carattere di ritorno a capo.
+(@xref{Separatori di output}.)
+
address@hidden @code{PREC}, variabile
address@hidden variabile @code{PREC}
address@hidden PREC #
+La precisione disponibile nei numeri a virgola mobile a precisione arbitraria,
+per default 53 bit (@pxref{Impostare la precisione}).
+
address@hidden @code{ROUNDMODE}, variabile
address@hidden variabile @code{ROUNDMODE}
address@hidden ROUNDMODE #
+La address@hidden di arrotondamento da usare per operazioni aritmetiche a
precisione
+arbitraria svolte sui numeri, per default @code{"N"}
+(@code{roundTiesToEven} nello standard
+IEEE 754; @pxref{Impostare modi di arrotondare}).
+
address@hidden @code{RS}, variabile
address@hidden variabile @code{RS}
address@hidden separatori di record
address@hidden record, separatori di
address@hidden @code{RS}
+Il separatore tra record in input. Il suo valore di default @`e una stringa
+contenente il solo carattere di ritorno a capo, il che significa che un record
in input
+consiste di una sola riga di testo.
+Il suo valore address@hidden essere anche la stringa nulla, nel qual caso i
record sono
+separati da una o address@hidden righe vuote.
+Se invece @`e una @dfn{regexp}, i record sono separati da
+corrispondenze alla @dfn{regexp} nel testo in input.
+(@xref{Record}.)
+
+La address@hidden che @code{RS} sia un'espressione regolare
address@hidden un'estensione @command{gawk}.
+In molte altre implementazioni @command{awk}, oppure
+se @command{gawk} @`e in address@hidden compatibile
+(@pxref{Opzioni}),
address@hidden usato solo il primo carattere del valore di @code{RS}.
+
address@hidden @code{SUBSEP}, variabile
address@hidden variabile @code{SUBSEP}
address@hidden separatori di indici
address@hidden indici, separatori di
address@hidden @code{SUBSEP}
+Il separatore di indici. Ha il valore di default di
address@hidden"\034"} ed @`e usato per separare le parti di cui sono composti
gli indici
+di un vettore multidimensionale. Quindi, l'espressione
address@hidden@w{pippo["A", "B"]}}
+in address@hidden accede a @code{pippo["A\034B"]}
+(@pxref{Vettori multidimensionali}).
+
address@hidden @command{gawk}, variabile @code{TEXTDOMAIN} in
address@hidden @code{TEXTDOMAIN}, variabile
address@hidden variabile @code{TEXTDOMAIN}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{TEXTDOMAIN}
address@hidden internazionalizzazione, localizzazione
address@hidden TEXTDOMAIN #
+Usata per l'internazionalizzazione di programmi a livello di
address@hidden Imposta il dominio di testo (@dfn{text domain}) di default per
costanti stringa
+marcate in maniera speciale nel codice sorgente, e anche per le funzioni
address@hidden()}, @code{dcngettext()} e @code{bindtextdomain()}
address@hidden
+(@pxrefil{Internazionalizzazione}).
address@hidden iftex
address@hidden
+(@pxref{Internazionalizzazione}).
address@hidden ifnottex
+Il valore di default di @code{TEXTDOMAIN} @`e @code{"messages"}.
address@hidden table
+
address@hidden Variabili auto-assegnate
address@hidden Variabili predefinite con cui @command{awk} fornisce informazioni
+
address@hidden predefinite, variabili, che forniscono informazioni
address@hidden variabili predefinite, che forniscono informazioni
+Quella che segue @`e una lista in ordine alfabetico di variabili che
address@hidden imposta automaticamente in determinate situazioni per
+fornire informazioni a un programma.
+
+Le variabili specifiche di @command{gawk} sono contrassegnate da un
+cancelletto (@samp{#}). Queste variabili sono estensioni @command{gawk}.
+In altre implementazioni di @command{awk} o se @command{gawk} @`e in
address@hidden compatibile (@pxref{Opzioni}), non hanno un significato speciale:
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{ARGC}/@code{ARGV}, variabili
address@hidden argomenti, riga di comando
address@hidden riga di comando, argomenti
address@hidden @code{ARGC}, @code{ARGV}
+Gli argomenti della riga di comando disponibili ai programmi @command{awk}
+sono memorizzati in un vettore di nome
address@hidden @code{ARGC} @`e il numero di argomenti presenti sulla
+riga di comando.
address@hidden argomenti}.
+A differenza di quasi tutti i vettori di @command{awk},
address@hidden @`e indicizzato da 0 a @code{ARGC} @minus{} 1.
+Lo si address@hidden vedere nell'esempio seguente:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{for (i = 0; i < ARGC; i++)}
+> @kbd{print ARGV[i]}
+> @address@hidden' inventory-shipped mail-list}
address@hidden awk
address@hidden inventory-shipped
address@hidden mail-list
address@hidden example
+
address@hidden
address@hidden contiene @samp{awk}, @code{ARGV[1]}
+contiene @samp{inventory-shipped} e @code{ARGV[2]} contiene
address@hidden Il valore di @code{ARGC} @`e tre, ossia uno in address@hidden
+dell'indice dell'ultimo elemento di @code{ARGV}, perch@'e gli elementi sono
+numerati a partire da zero.
+
address@hidden convenzioni di programmazione, variabili @code{ARGC}/@code{ARGV}
+I nomi @code{ARGC} e @code{ARGV}, come pure la convenzione di indicizzare
+il vettore da 0 a @code{ARGC} @minus{} 1, derivano dal modo in cui il
+linguaggio C accede agli argomenti presenti sulla riga di comando.
+
address@hidden angolo buio, valore di @code{ARGV[0]}
+Il valore di @code{ARGV[0]} address@hidden variare da sistema a sistema.
+Va anche notato che il programma @emph{non}
address@hidden incluso in @code{ARGV}, e non sono incluse neppure le eventuali
opzioni di
address@hidden specificate sulla riga di comando.
address@hidden e ARGV} per informazioni
+su come @command{awk} usa queste variabili.
address@hidden
+
address@hidden @code{ARGIND}, variabile
address@hidden variabile @code{ARGIND}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{ARGIND}
address@hidden @code{ARGIND #}
+L'indice in @code{ARGV} del file correntemente in elaborazione.
+Ogni volta che @command{gawk} apre un nuovo @value{DF} per elaborarlo, imposta
address@hidden all'indice in @code{ARGV} del @value{FN}.
+Quando @command{gawk} sta elaborando i file in input, il confronto
address@hidden == ARGV[ARGIND]} @`e sempre verificato.
+
address@hidden file, address@hidden variabile @code{ARGIND} e
+Questa variabile @`e utile nell'elaborazione dei file; consente di stabilire
+a che punto ci si trova nella lista
+di @value{DF}, e anche di distinguere tra successive occorrenze dello stesso
address@hidden sulla riga dei comandi.
+
address@hidden nomi di file, distinguere
+Anche se @`e possibile modificare il valore di @code{ARGIND} all'interno del
+programma @command{awk}, @command{gawk} automaticamente lo imposta a un nuovo
+valore quando viene aperto il file successivo.
+
address@hidden @code{ENVIRON}, vettore
address@hidden vettore @code{ENVIRON}
address@hidden variabili d'ambiente, nel vettore @code{ENVIRON}
address@hidden @code{ENVIRON}
+Un vettore associativo contenente i valori delle variabili d'ambiente.
+Gli indici del vettore sono i nomi delle variabili d'ambiente; gli elementi
+sono i valori della specifica variabile d'ambiente. Per esempio,
address@hidden"HOME"]} potrebbe valere @code{/home/arnold}.
+
+Per POSIX @command{awk}, le modifiche a questo vettore non cambiano
+le variabili d'ambiente passate a qualsivoglia programma che @command{awk}
address@hidden richiamare tramite una ridirezione
+o usando la funzione @code{system()}.
+
+Tuttavia, a partire dalla @value{PVERSION} 4.2, se non si @`e in
address@hidden compatibile POSIX, @command{gawk} aggiorna le proprie variabili
+d'ambiente, quando si modifica @code{ENVIRON}, e in questo modo sono
+modificate anche le variabili d'ambiente disponibili ai programmi richiamati.
+Un'attenzione speciale dovrebbe essere prestata alla modifica di
address@hidden"PATH"]}, che @`e il percorso di ricerca usato per trovare
+i programmi eseguibili.
+
+Queste modifiche possono anche influire sul programma @command{gawk}, poich@'e
+alcune funzioni predefinite possono tener conto di certe
+variabili d'ambiente.
+L'esempio address@hidden notevole di una tale situazione @`e @code{mktime()}
+(@pxref{Funzioni di tempo})
+che, in molti sistemi, tiene conto del valore della
+variabile d'ambiente @env{TZ}.
+
+Alcuni sistemi operativi possono non avere variabili d'ambiente.
+In tali sistemi, il vettore @code{ENVIRON} @`e vuoto (tranne che per
+le variabili
address@hidden@code{ENVIRON["AWKPATH"]}} e
address@hidden@code{ENVIRON["AWKLIBPATH"]}} eventualmente presenti;
address@hidden (Variabile)} e
address@hidden
address@hidden (Variabile)}).
address@hidden ifdocbook
address@hidden
address@hidden (Variabile)}).
address@hidden ifnotdocbook
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile
address@hidden variabile @code{ERRNO}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{ERRNO}
address@hidden gestione errori, variabile @code{ERRNO} e
address@hidden @code{ERRNO #}
+Se si verifica un errore di sistema durante una ridirezione per @code{getline},
+durante una lettura per @code{getline} o durante un'operazione di
address@hidden()}, la variabile
address@hidden contiene una stringa che descrive l'errore.
+
+Inoltre, @command{gawk} annulla @code{ERRNO} prima di aprire ogni
+file in input presente sulla riga di comando. Questo consente di controllare
+se il file @`e accessibile
+all'interno di un criterio di ricerca @code{BEGINFILE}
+(@pxref{BEGINFILE/ENDFILE}).
+
+Per il resto, @code{ERRNO} si comporta analogamente alla variabile C
address@hidden
+Tranne nel caso sopra accennato, @command{gawk} non annulla @emph{mai}
address@hidden (lo imposta a zero o a @code{""}). Quindi, ci si deve
+aspettare che il suo valore sia significativo solo quando un'operazione
+di I/O restituisce un valore che indica il fallimento dell'operazione, come
+per esempio quando @code{getline} restituisce @minus{}1. Si @`e, naturalmente,
+liberi di annullarla prima di effettuare un'operazione di I/O.
+
+Se il valore di @code{ERRNO} corrisponde a un errore di sistema della
+variabile C @code{errno}, @code{PROCINFO["errno"]} address@hidden impostato al
valore
+di @code{errno}. Per errori non di sistema, @code{PROCINFO["errno"]}
address@hidden
+impostata al valore zero.
+
address@hidden @code{FILENAME}, variabile
address@hidden variabile @code{FILENAME}
address@hidden angolo buio, variabile @code{FILENAME}
address@hidden @code{FILENAME}
+Il nome del file in input corrente. Quando non ci sono @value{DF}
+sulla riga dei comandi, @command{awk} legge dallo standard input e
address@hidden @`e impostato a @code{"-"}. @code{FILENAME} cambia ogni
+volta che si legge un nuovo file
address@hidden
+(@pxrefil{Leggere file}).
address@hidden iftex
address@hidden
+(@pxref{Leggere file}).
address@hidden ifnottex
+All'interno di una
+regola @code{BEGIN}, il valore di @code{FILENAME} @`e @code{""}, perch@'e non
si
+sta elaborando alcun file in address@hidden tra le prime implementazioni di
Unix
address@hidden inizializzavano @code{FILENAME} a @code{"-"}, anche se
+vi erano @value{DF} da elaborare. Un tale comportamento era incorretto e
+non ci si dovrebbe poter contare nei programmi.}
address@hidden Si noti, tuttavia,
+che l'uso di @code{getline} (@pxref{Getline}) all'interno di una regola
address@hidden address@hidden implicare l'assegnamento di un valore a
@code{FILENAME}.
+
address@hidden @code{FNR}, variabile
address@hidden variabile @code{FNR}
address@hidden @code{FNR}
+Il numero del record corrente nel file corrente. @command{awk} incrementa
address@hidden ogni volta che legge un nuovo record (@pxref{Record}).
address@hidden imposta nuovamente a zero @code{FNR} ogni volta che inizia a
+leggere un nuovo file in input.
+
address@hidden @code{NF}, variabile
address@hidden variabile @code{NF}
address@hidden @code{NF}
+Il numero di campi nel corrente record in input.
address@hidden @`e impostato ogni volta che si legge un nuovo record,
+quando un nuovo campo viene creato,
+o quando si modifica @code{$0} (@pxref{Campi}).
+
+A differenza di molte altre variabili descritte in questa @value{SUBSECTION},
+l'assegnamento di un valore a @code{NF} address@hidden potenzialmente
influenzare
+il funzionamento interno di @command{awk}. In particolare, assegnamenti
+a @code{NF} si possono usare per aggiungere o togliere campi dal
+record corrente. @xref{Cambiare i campi}.
+
address@hidden @code{FUNCTAB}, vettore
address@hidden vettore @code{FUNCTAB}
address@hidden @command{gawk}, vettore @code{FUNCTAB} in
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{FUNCTAB}
address@hidden @code{FUNCTAB #}
+Un vettore i cui indici e i corrispondenti valori sono i nomi di tutte le
+funzioni predefinite, definite dall'utente ed estese, presenti nel programma.
+
address@hidden NOTA
+Il tentativo di usare l'istruzione @code{delete} per eliminare il vettore
address@hidden genera un errore fatale. Genera un errore fatale anche
+ogni tentativo di impostare un elemento di @code{FUNCTAB}.
address@hidden quotation
+
address@hidden @code{NR}, variabile
address@hidden variabile @code{NR}
address@hidden @code{NR}
+Il numero di record in input che @command{awk} ha elaborato dall'inizio
+dell'esecuzione del programma
+(@pxref{Record}).
address@hidden incrementa @code{NR} ogni volta che legge un nuovo record.
+
address@hidden @command{gawk}, vettore @code{PROCINFO} in
address@hidden @code{PROCINFO}, vettore
address@hidden vettore @code{PROCINFO}
address@hidden differenze tra @command{awk} e @command{gawk}, vettore
@code{PROCINFO}
address@hidden @code{PROCINFO #}
+Gli elementi di questo vettore danno accesso a informazioni sul
+programma @command{awk} in esecuzione.
+I seguenti elementi (elencati in ordine alfabetico)
+sono sicuramente sempre disponibili:
+
address@hidden @code
address@hidden effettivo, @dfn{ID di gruppo} dell'utente di @command{gawk}
address@hidden PROCINFO["egid"]
+Il valore restituito dalla chiamata di sistema @code{getegid()}.
+
address@hidden PROCINFO["errno"]
+Il valore della variabile C @code{ERRNO} quando @code{ERRNO} @`e impostato
+al messaggio di errore a essa associato.
+
address@hidden PROCINFO["euid"]
address@hidden @dfn{ID effettivo} dell'utente di @command{gawk}
+Il valore restituito dalla chiamata di sistema @code{geteuid()}.
+
address@hidden PROCINFO["FS"]
+Questo elemento vale
address@hidden"FS"} se @`e in uso la separazione in campi con @code{FS},
address@hidden"FIELDWIDTHS"} se @`e in uso quella con @code{FIELDWIDTHS},
+oppure @code{"FPAT"} se @`e in uso l'individuazione di campo con @code{FPAT}.
+
address@hidden PROCINFO["gid"]
address@hidden @dfn{ID di gruppo} dell'utente @command{gawk}
+Il valore restituito dalla chiamata di sistema @code{getgid()} .
+
address@hidden PROCINFO["identifiers"]
address@hidden programma, identificativi in un
address@hidden identificativi in un programma
+Un sottovettore, indicizzato dai nomi di tutti gli identificativi usati
+all'interno del programma @command{awk}. Un @dfn{identificativo} @`e
+semplicemente il nome di una variabile
+(scalare o vettoriale), una funzione predefinita, una funzione definita
+dall'utente, o una funzione contenuta in un'estensione.
+Per ogni identificativo, il valore dell'elemento @`e uno dei seguenti:
+
address@hidden @code
address@hidden "array"
+L'identificativo @`e un vettore.
+
address@hidden "builtin"
+L'identificativo @`e una funzione predefinita.
+
address@hidden "extension"
+L'identificativo @`e una funzione in un'estensione caricata tramite
address@hidden@@load} o con l'opzione @option{-l}.
+
address@hidden "scalar"
+L'identificativo @`e uno scalare.
+
address@hidden "untyped"
+L'identificativo non ha ancora un tipo (potrebbe essere usato come scalare o
+come vettore; @command{gawk} non @`e ancora in grado di dirlo).
+
address@hidden "user"
+L'identificativo @`e una funzione definita dall'utente.
address@hidden table
+
address@hidden
+I valori riportano address@hidden che @command{gawk} sa sugli identificativi
+dopo aver finito l'analisi iniziale del programma; questi valori @emph{non}
+vengono address@hidden aggiornati durante l'esecuzione del programma.
+
address@hidden PROCINFO["pgrpid"]
address@hidden @dfn{process group ID} del programma @command{gawk}
+Il @dfn{ID di gruppo del processo} del programma corrente.
+
address@hidden PROCINFO["pid"]
address@hidden @dfn{process ID} del programma @command{gawk}
+Il @dfn{process ID} del programma corrente.
+
address@hidden PROCINFO["ppid"]
address@hidden @dfn{parent process ID} del programma @command{gawk}
+Il @dfn{ID di processo del padre} del programma corrente.
+
address@hidden PROCINFO["strftime"]
+La stringa col formato di default usato per la funzione @code{strftime()}.
+Assegnando un nuovo valore a questo elemento si cambia quello di default.
address@hidden di tempo}.
+
address@hidden PROCINFO["uid"]
+Il valore restituito dalla chiamata di sistema @code{getuid()}.
+
address@hidden PROCINFO["version"]
address@hidden versione di @command{gawk}
address@hidden @command{gawk}, versione di
+La versione di @command{gawk}.
address@hidden table
+
+I seguenti elementi addizionali del vettore
+sono disponibili per fornire informazioni sulle librerie MPFR e GMP,
+se la versione in uso di @command{gawk} consente il calcolo con precisione
+arbitraria
+(@pxref{Calcolo con precisione arbitraria}):
+
address@hidden @code
address@hidden PROCINFO["gmp_version"]
address@hidden versione della libreria GNU MP
+La versione della libreria GNU MP.
+
address@hidden versione della libreria GNU MPFR
address@hidden PROCINFO["mpfr_version"]
+La versione della libreria GNU MPFR.
+
address@hidden PROCINFO["prec_max"]
address@hidden precisione massima consentita dalla libreria MPFR
+La massima precisione consentita da MPFR.
+
address@hidden PROCINFO["prec_min"]
address@hidden precisione minima richiesta dalla libreria MPFR
+La precisione minima richiesta da MPFR.
address@hidden table
+
+I seguenti elementi addizionali del vettore
+sono disponibili per fornire
+informazioni sulla versione dell'estensione API, se la versione
+di @command{gawk} prevede il caricamento dinamico di funzioni di estensione
address@hidden
+(@pxrefil{Estensioni dinamiche}):
address@hidden iftex
address@hidden
+(@pxref{Estensioni dinamiche}):
address@hidden ifnottex
+
address@hidden @code
address@hidden PROCINFO["api_major"]
address@hidden versione dell'estensione API @command{gawk}
address@hidden estensione API, numero di versione
+La versione principale dell'estensione API.
+
address@hidden PROCINFO["api_minor"]
+La versione secondaria dell'estensione API.
address@hidden table
+
address@hidden gruppi supplementari Unix con @command{gawk}
+Su alcuni sistemi, ci possono essere elementi nel vettore, da @code{"group1"}
+fino a @code{"address@hidden"}. @var{N} @`e il numero di
+gruppi supplementari che il processo [Unix] possiede. Si usi l'operatore
address@hidden per verificare la presenza di questi elementi
+(@pxref{Visitare elementi}).
+
+I seguenti elementi consentono di modificare il comportamento di
address@hidden:
+
address@hidden PROCINFO["NONFATAL"]
+Se questo elemento esiste, gli errori di I/O per tutte le ridirezioni
+consentono la prosecuzizone del programma.
address@hidden dopo errori}.
+
address@hidden PROCINFO["@var{nome_output}", "NONFATAL"]
+Gli errori in output per il file @var{nome_output}
+consentono la prosecuzizone del programma.
address@hidden dopo errori}.
+
address@hidden @code
address@hidden PROCINFO["@var{comando}", "pty"]
+Per una comunicazione bidirezionale con @var{comando}, si usi una pseudo-tty
+invece di impostare una @dfn{pipe} bidirezionale.
address@hidden/O bidirezionale} per ulteriori informazioni.
+
address@hidden PROCINFO["@var{input_name}", "READ_TIMEOUT"]
+Imposta un tempo limite per leggere dalla ridirezione di input
@var{input_name}.
address@hidden in lettura} per ulteriori informazioni.
+
address@hidden PROCINFO["sorted_in"]
+Se questo elemento esiste in @code{PROCINFO}, il suo valore controlla
+l'ordine in cui gli indici dei vettori saranno elaborati nei cicli
address@hidden (@var{indice} in @var{vettore})}.
+Questa @`e una address@hidden avanzata, la cui descrizione completa
address@hidden vista
address@hidden avanti; si veda
address@hidden un intero vettore}.
address@hidden table
+
address@hidden @code{RLENGTH}, variabile
address@hidden variabile @code{RLENGTH}
address@hidden @code{RLENGTH}
+La lunghezza della sottostringa individuata dalla funzione
address@hidden()}
+(@pxref{Funzioni per stringhe}).
address@hidden viene impostata quando si richiama la funzione @code{match()}.
+Il suo
+valore @`e la lunghezza della stringa individuata, oppure @minus{}1 se non @`e
+stata trovata alcuna corrispondenza.
+
address@hidden @code{RSTART}, variabile
address@hidden variabile @code{RSTART}
address@hidden @code{RSTART}
+L'indice, in caratteri, da cui parte la sottostringa che @`e individuata dalla
+funzione @code{match()}
+(@pxref{Funzioni per stringhe}).
address@hidden viene impostata quando si richiama la funzione @code{match()}.
+Il suo
+valore @`e la posizione nella stringa da cui inizia la sottostringa
+individuata, oppure zero, se non @`e stata trovata alcuna corrispondenza.
+
address@hidden @command{gawk}, variabile @code{RT} in
address@hidden @code{RT}, variabile
address@hidden variabile @code{RT}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{RT}
address@hidden @code{RT #}
+Il testo in input che corrisponde al testo individuato da @code{RS},
+il separatore di record. Questa variabile viene impostata dopo aver letto
+ciascun record.
+
address@hidden @command{gawk}, vettore @code{SYMTAB} in
address@hidden @code{SYMTAB}, vettore
address@hidden vettore @code{SYMTAB}
address@hidden differenze tra @command{awk} e @command{gawk}, vettore
@code{SYMTAB}
address@hidden @code{SYMTAB #}
+Un vettore i cui indici sono i nomi di tutte le variabili globali e i vettori
+definiti nel programma. @code{SYMTAB} rende visibile al
+programmatore @command{awk} la tabella dei simboli di @command{gawk}.
+Viene preparata nella fase di analisi iniziale del programma @command{gawk}
+ed @`e completata prima di cominciare a eseguire il programma.
+
+Il vettore address@hidden essere usato per accedere indirettamente, in lettura
o in
+scrittura, al valore di una variabile:
+
address@hidden
+pippo = 5
+SYMTAB["pippo"] = 4
+print pippo # stampa 4
address@hidden example
+
address@hidden
+La funzione @code{isarray()} (@pxref{Funzioni per i tipi}) si address@hidden
usare per
+controllare se un elemento in @code{SYMTAB} @`e un vettore.
+Inoltre, non @`e possibile usare l'istruzione @code{delete} con il vettore
address@hidden
+
address@hidden possibile aggiungere a @code{SYMTAB} un elemento che non sia un
+identificativo address@hidden esistente:
+
address@hidden
+SYMTAB["xxx"] = 5
+print SYMTAB["xxx"]
address@hidden example
+
address@hidden
+Il risultato @`e quello previsto: in questo caso @code{SYMTAB} si comporta
+come un normale vettore. La sola differenza @`e che non @`e poi possibile
+cancellare @code{SYMTAB["xxx"]}.
+
address@hidden Schorr, Andrew
+Il vettore @code{SYMTAB} @`e address@hidden interessante di quel che sembra.
Andrew
+Schorr fa notare che effettivamente consente di ottenere dei puntatori ai dati
+in @command{awk}. Si consideri quest'esempio:
+
address@hidden
+# Moltiplicazione indiretta di una qualsiasi variabile per un
+# numero a piacere e restituzione del risultato
+
+function multiply(variabile, numero)
address@hidden
+ return SYMTAB[variabile] *= numero
address@hidden
address@hidden example
+
address@hidden
+Si potrebbe usare in questo modo:
+
address@hidden
+BEGIN @{
+ risposta = 10.5
+ multiply("risposta", 4)
+ print "La risposta @`e", risposta
address@hidden
address@hidden example
+
address@hidden
+Eseguendo, il risultato @`e:
+
address@hidden
+$ @kbd{gawk -f risposta.awk}
address@hidden La risposta @`e 42
address@hidden example
+
address@hidden NOTA
+Per evitare seri paradossi temporali,
address@hidden non parlare dei grossi problemi di implementazione.}
+n@'e @code{FUNCTAB} n@'e @code{SYMTAB}
+sono disponibili come elementi all'interno del vettore @code{SYMTAB}.
address@hidden quotation
address@hidden table
+
address@hidden sidebar, Modificare @code{NR} e @code{FNR}
address@hidden
address@hidden
+<sidebar><title>Modificare @code{NR} e @code{FNR}</title>
address@hidden docbook
+
address@hidden @code{NR}, variabile, modifica di
address@hidden variabile @code{NR}, modifica di
address@hidden @code{FNR}, variabile, modifica di
address@hidden variabile @code{FNR}, modifica di
address@hidden angolo buio, variabili @code{FNR}/@code{NR}
address@hidden incrementa le variabili @code{NR} e @code{FNR}
+ogni volta che legge un record, invece che impostarle al valore assoluto del
+numero di record letti. address@hidden significa che un programma
address@hidden
+modificare queste variabili e i valori address@hidden@dotless{i}} assegnati
sono incrementati per
+ogni record.
address@hidden
+Si consideri l'esempio seguente:
+
address@hidden
+$ @kbd{echo '1}
+> @kbd{2}
+> @kbd{3}
+> @kbd{4' | awk 'NR == 2 @{ NR = 17 @}}
+> @address@hidden print NR @}'}
address@hidden 1
address@hidden 17
address@hidden 18
address@hidden 19
address@hidden example
+
address@hidden
+Prima che @code{FNR} venisse aggiunto al linguaggio @command{awk}
+(@pxref{V7/SVR3.1}),
+molti programmi @command{awk} usavano questa address@hidden per
+contare il numero di record in un file impostando a zero @code{NR} al cambiare
+di @code{FILENAME}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Modificare @code{NR} e @code{FNR}}
+
+
address@hidden @code{NR}, variabile, modifica di
address@hidden variabile @code{NR}, modifica di
address@hidden @code{FNR}, variabile, modifica di
address@hidden variabile @code{FNR}, modifica di
address@hidden angolo buio, variabili @code{FNR}/@code{NR}
address@hidden incrementa le variabili @code{NR} e @code{FNR}
+ogni volta che legge un record, invece che impostarle al valore assoluto del
+numero di record letti. address@hidden significa che un programma
address@hidden
+modificare queste variabili e i valori address@hidden@dotless{i}} assegnati
sono incrementati per
+ogni record.
address@hidden
+Si consideri l'esempio seguente:
+
address@hidden
+$ @kbd{echo '1}
+> @kbd{2}
+> @kbd{3}
+> @kbd{4' | awk 'NR == 2 @{ NR = 17 @}}
+> @address@hidden print NR @}'}
address@hidden 1
address@hidden 17
address@hidden 18
address@hidden 19
address@hidden example
+
address@hidden
+Prima che @code{FNR} venisse aggiunto al linguaggio @command{awk}
+(@pxref{V7/SVR3.1}),
+molti programmi @command{awk} usavano questa address@hidden per
+contare il numero di record in un file impostando a zero @code{NR} al cambiare
+di @code{FILENAME}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden ARGC e ARGV
address@hidden Usare @code{ARGC} e @code{ARGV}
address@hidden @code{ARGC}/@code{ARGV}, variabili, come usarle
address@hidden variabili @code{ARGC}/@code{ARGV}, come usarle
address@hidden argomenti, riga di comando
address@hidden riga di comando, argomenti
+
address@hidden
+La
address@hidden iftex
address@hidden auto-assegnate}
+conteneva il programma seguente che visualizzava le informazioni contenute
+in @code{ARGC} e @code{ARGV}:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{for (i = 0; i < ARGC; i++)}
+> @kbd{print ARGV[i]}
+> @address@hidden' inventory-shipped mail-list}
address@hidden awk
address@hidden inventory-shipped
address@hidden mail-list
address@hidden example
+
address@hidden
+In questo esempio, @code{ARGV[0]} contiene @samp{awk}, @code{ARGV[1]}
+contiene @samp{inventory-shipped} e @code{ARGV[2]} contiene
address@hidden
+Si noti che il nome del programma @command{awk} non @`e incluso in @code{ARGV}.
+Le altre opzioni della riga di comando, con i relativi argomenti,
+sono parimenti non presenti, compresi anche gli assegnamenti di
+variabile fatti tramite l'opzione @option{-v}
+(@pxref{Opzioni}).
+I normali assegnamenti di variabile sulla riga dei comandi @emph{sono}
+trattati come argomenti e quindi inseriti nel vettore @code{ARGV}.
+Dato il seguente programma in un file di nome @file{vediargomenti.awk}:
+
address@hidden
+BEGIN @{
+ printf "A=%d, B=%d\n", A, B
+ for (i = 0; i < ARGC; i++)
+ printf "\tARGV[%d] = %s\n", i, ARGV[i]
address@hidden
+END @{ printf "A=%d, B=%d\n", A, B @}
address@hidden example
+
address@hidden
+la sua esecuzione produce il seguente risultato:
+
address@hidden
+$ @kbd{awk -v A=1 -f vediargomenti.awk B=2 /dev/null}
address@hidden A=1, B=0
address@hidden ARGV[0] = awk
address@hidden ARGV[1] = B=2
address@hidden ARGV[2] = /dev/null
address@hidden A=1, B=2
address@hidden example
+
+Un programma address@hidden modificare @code{ARGC} e gli elementi di
@code{ARGV}.
+Ogni volta che @command{awk} arriva alla fine di un file in input, usa
+il successivo elemento nel vettore @code{ARGV} come nome del successivo file
+in input. Cambiando il contenuto di quella stringa, un programma
address@hidden
+modificare la lista dei file che sono letti.
+Si usi @code{"-"} per rappresentare lo standard input. Assegnando ulteriori
+elementi e incrementando @code{ARGC}
+verranno letti ulteriori file.
+
+Se il valore di @code{ARGC} viene diminuto, vengono ignorati i file in input
+posti alla fine della lista. Memorizzando il valore originale di @code{ARGC}
+da qualche altra parte, un programma address@hidden gestire gli argomenti
+ignorati come se fossero qualcosa di diverso dai @value{FN}.
+
+Per eliminare un file che sia in mezzo alla lista, si imposti in @code{ARGV}
+la stringa nulla
+(@code{""}) al posto del nome del file in questione. Come address@hidden
+speciale, @command{awk} ignora valori di @value{FN} che siano stati
+rimpiazzati con la stringa nulla.
+Un'altra address@hidden @`e quella
+di usare l'istruzione @code{delete} per
+togliere elementi da @code{ARGV} (@pxref{Cancellazione}).
+
+Tutte queste azioni sono tipicamente eseguite nella regola @code{BEGIN},
+prima di iniziare l'elaborazione vera e propria dell'input.
address@hidden split} e
address@hidden
address@hidden tee}
address@hidden ifnotdocbook
address@hidden
address@hidden tee}
address@hidden ifdocbook
+per esempi
+su ognuno dei modi per togliere elementi dal vettore @code{ARGV}.
+
+Per passare direttamente delle opzioni a un programma scritto in
address@hidden, si devono terminare le opzioni di @command{awk} con
address@hidden e poi inserire le opzioni destinate al programma @command{awk},
+come mostrato qui di seguito:
+
address@hidden
+awk -f mio_programma.awk -- -v -q file1 file2 @dots{}
address@hidden example
+
+Il seguente frammento di programma ispeziona @code{ARGV} per esaminare, e
+poi rimuovere, le opzioni sulla riga di comando viste sopra:
+
address@hidden
+BEGIN @{
+ for (i = 1; i < ARGC; i++) @{
+ if (ARGV[i] == "-v")
+ verbose = 1
+ else if (ARGV[i] == "-q")
+ debug = 1
+ else if (ARGV[i] ~ /^-./) @{
+ e = sprintf("%s: opzione non riconosciuta -- %c",
+ ARGV[0], substr(ARGV[i], 2, 1))
+ print e > "/dev/stderr"
+ @} else
+ break
+ delete ARGV[i]
+ @}
address@hidden
address@hidden example
+
address@hidden differenze tra @command{awk} e @command{gawk}, variabili
@code{ARGC}/@code{ARGV}
+Terminare le opzioni di @command{awk} con @option{--} non @`e
+necessario in @command{gawk}. A meno che non si specifichi @option{--posix},
address@hidden inserisce, senza emettere messaggi, ogni opzione non
+riconosciuta
+nel vettore @code{ARGV} perch@'e sia trattata dal programma @command{awk}.
+Dopo aver trovato un'opzione non riconosciuta, @command{gawk} non cerca
+ulteriori opzioni, anche se ce ne fossero di riconoscibili.
+La riga dei comandi precedente sarebbe
+con @command{gawk}:
+
address@hidden
+gawk -f mio_programma.awk -q -v file1 file2 @dots{}
address@hidden example
+
address@hidden
+Poich@'e @option{-q} non @`e un'opzione valida per @command{gawk},
quest'opzione
+e l'opzione @option{-v} che segue sono passate al programma @command{awk}.
+(@xref{Funzione getopt} per una funzione di libreria @command{awk}
+che analizza le opzioni della riga di comando.)
+
+Nel progettare un programma, si dovrebbero scegliere opzioni che non
+siano in conflitto con quelle di @command{gawk}, perch@'e ogni opzioni
+accettata da @command{gawk} address@hidden elaborata prima di passare il resto
+della riga dei comandi al programma @command{awk}.
+Usare @samp{#!} con l'opzione @option{-E} address@hidden essere utile in
questo caso
+(@address@hidden eseguibili}
+e
address@hidden
address@hidden).
address@hidden ifnotdocbook
address@hidden
address@hidden).
address@hidden ifdocbook
+
address@hidden Sommario criteri e azioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Coppie @dfn{criterio di ricerca--azione} sono gli elementi base di un
+programma @command{awk}. I criteri di ricerca possono essere espressioni
+normali, espressioni di intervallo, o costanti @dfn{regexp}; possono anche
+essere i criteri speciali @code{BEGIN}, @code{END},
address@hidden o @code{ENDFILE}; o essere omessi. L'azione viene eseguita
+se il record corrente soddisfa il criterio di ricerca. Criteri di ricerca
+vuoti (omessi) corrispondono a
+tutti i record in input.
+
address@hidden
+L'I/O effettuato nelle azioni delle regole @code{BEGIN} ed @code{END}
+ha alcuni vincoli.
+Questo vale a maggior ragione per le regole @code{BEGINFILE} ed
address@hidden Queste ultime due forniscono degli ``agganci'' per interagire
+con l'elaborazione dei file fatta da @command{gawk},
+consentendo di risolvere situazioni che altrimenti genererebbero degli
+errori fatali (ad esempio per un file che non si @`e autorizzati
+a leggere).
+
address@hidden
+Le variabili di shell possono essere usate nei programmi @command{awk}
+prestando la dovuta attenzione all'uso degli apici.
address@hidden address@hidden facile passare una variabile di shell ad
address@hidden usando l'opzione @option{-v} e una variabile @command{awk}.
+
address@hidden
+Le azioni sono formate da istruzioni racchiuse tra parentesi graffe.
+Le istruzioni sono composte da
+espressioni, istruzioni di controllo,
+istruzioni composte,
+istruzioni di input/output e istruzioni di cancellazione.
+
address@hidden
+Le istruzioni di controllo in @command{awk} sono @address@hidden,
address@hidden, @code{for} e @address@hidden @command{gawk}
+aggiunge l'istruzione @code{switch}. Ci sono due tipi di istruzione
address@hidden: uno per eseguire dei cicli, e l'altro per esaminare un vettore.
+
address@hidden
+Le istruzioni @code{break} e @code{continue} permettono di uscire
+velocemente da un ciclo, o di passare alla successiva iterazione dello
+stesso (o di uscire da un'istruzione @code{switch}).
+
address@hidden
+Le istruzioni @code{next} e @code{nextfile} permettono, rispettivamente,
+di passare al record successivo, ricominciando l'elaborazione dalla prima
+regola del programma, o di passare al successivo file in input, sempre
+ripartendo dalla prima regola del programma.
+
address@hidden
+L'istruzione @code{exit} termina il programma. Quando @`e eseguita
+dall'interno di un'azione (o nel corpo di una funzione), trasferisce
+il controlla alle eventuali istruzioni @code{END}. Se @`e eseguita nel corpo
+di un'istruzione @code{END}, il programma @`e terminato
+immediatamente. @`E possibile specificare un valore numerico da usare come
+codice di ritorno di @command{awk}.
+
address@hidden
+Alcune variabili predefinite permettono di controllare @command{awk},
+principalmente per l'I/O. Altre variabili trasmettono informazioni
+da @command{awk} al programma.
+
address@hidden
+I vettori @code{ARGC} e @code{ARGV} rendono disponibili al programma gli
+argomenti della riga di comando. Una loro modifica all'interno di una regola
address@hidden permette di controllare come @command{awk} address@hidden i
@value{DF}
+in input.
+
address@hidden itemize
+
address@hidden Vettori
address@hidden Vettori in @command{awk}
address@hidden vettori
+
+Un @dfn{vettore} @`e una tabella di valori chiamati @dfn{elementi}. Gli
+elementi di un vettore sono individuati dai loro @dfn{indici}. Gli indici
+possono essere numeri o stringhe.
+
+Questo @value{CHAPTER} descrive come funzionano i vettori in @command{awk},
+come usare gli elementi di un vettore, come visitare tutti gli elementi
+di un vettore, e come rimuovere elementi da un vettore.
+Descrive anche come @command{awk} simula vettori multidimensionali,
+oltre ad alcuni aspetti meno ovvii sull'uso dei vettori.
+Il @value{CHAPTER} prosegue illustrando la address@hidden di ordinamento dei
+vettori di @command{gawk}, e termina con una breve descrizione della
address@hidden
+di @command{gawk} di consentire veri vettori di vettori.
+
address@hidden
+* Fondamenti sui vettori:: Informazioni di base sui vettori.
+* Indici numerici di vettore:: Come usare numeri come indici in
+ @command{awk}.
+* Indici non inizializzati:: Usare variabili non inizializzate come indici.
+* Cancellazione:: L'istruzione @code{delete} toglie un elemento
+ da un vettore.
+* Vettori multidimensionali:: Emulare vettori multidimensionali in
+ @command{awk}.
+* Vettori di vettori:: Vettori multidimensionali veri.
+* Sommario dei vettori:: Sommario dei vettori.
address@hidden menu
+
address@hidden Fondamenti sui vettori
address@hidden Informazioni di base sui vettori
+
+Questa @value{SECTION} espone le nozioni fondamentali: elaborare gli elementi
+di un vettore uno alla volta, e visitare sequenzialmente tutti gli elementi
+di un vettore.
+
address@hidden
+* Introduzione ai vettori:: Introduzione ai vettori
+* Visitare elementi:: Come esaminare un elemento di un vettore.
+* Impostare elementi:: Come cambiare un elemento di un vettore.
+* Esempio di vettore:: Esempio semplice di vettore
+* Visitare un intero vettore:: Variazione dell'istruzione @code{for}. Esegue
+ un ciclo attraverso gli indici degli elementi
+ contenuti in un vettore.
+* Controllare visita:: Controllare l'ordine in cui i vettori sono
+ visitati.
address@hidden menu
+
address@hidden Introduzione ai vettori
address@hidden Introduzione ai vettori
+
address@hidden Wall, Larry
address@hidden
address@hidden sequenzialmente un vettore associativo @`e come tentare di
+lapidare qualcuno usando una mitragliatrice Uzi carica.}
address@hidden Larry Wall
address@hidden quotation
+
+Il linguaggio @command{awk} mette a disposizione vettori monodimensionali per
+memorizzare gruppi di stringhe o di numeri correlati fra loro. Ogni vettore di
address@hidden deve avere un nome. I nomi dei vettori hanno la stessa sintassi
+dei nomi di variabile; qualsiasi nome valido di variabile potrebbe essere anche
+un valido nome di vettore. Un nome address@hidden non address@hidden essere
usato in entrambi i
+modi (come vettore e come variabile) nello stesso programma @command{awk}.
+
+I vettori in @command{awk} assomigliano superficialmente ai vettori in altri
+linguaggi di programmazione, ma ci sono differenze fondamentali. In
address@hidden, non @`e necessario specificare la dimensione di un vettore prima
+di iniziare a usarlo. In address@hidden, qualsiasi numero o stringa
address@hidden essere usato
+come indice di un vettore, non solo numeri interi consecutivi.
+
+Nella maggior parte degli altri linguaggi, i vettori devono essere
address@hidden prima dell'uso, specificando quanti elementi o componenti
+contengono. In questi linguaggi, la dichiarazione causa l'allocazione, per
+questi elementi, di un blocco di memoria contiguo.
+Normalmente, un indice di un vettore dev'essere un intero non negativo.
+Per esempio, l'indice zero specifica il primo elemento nel vettore, che @`e
+effettivamente memorizzato all'inizio di un blocco di memoria. L'indice uno
+specifica il secondo elemento, che @`e memorizzato subito dopo il primo
elemento,
+e address@hidden@dotless{i}} via. @`E impossibile aggiungere ulteriori
elementi al vettore, perch@'e
+esso address@hidden contenere solo il numero di elementi dichiarato.
+(Alcuni linguaggi consentono indici iniziali e finali arbitrari---p.es.,
address@hidden .. address@hidden la dimensione del vettore rimane fissa una
volta che
+il vettore sia stato dichiarato.)
+
address@hidden 1/2015: Do not put the numeric values into @code. Array element
address@hidden values are no different than scalar variable values.
+Un vettore contiguo di quattro elementi potrebbe essere come quello in
address@hidden
address@hidden,
address@hidden ifnotdocbook
address@hidden
+come mostrato in @inlineraw{docbook, <xref linkend="vettore-elementi"/>}:
address@hidden ifdocbook
+concettualmente, se i valori degli elementi sono 8, @code{"pippo"},
address@hidden""} e 30.
+
address@hidden
address@hidden Figura,vettore-elementi
address@hidden vettore contiguo}
address@hidden SMALLPRINT
address@hidden @image{vettore-elementi, 11cm, , Un vettore contiguo}
address@hidden ifset
address@hidden SMALLPRINT
address@hidden @image{vettore-elementi, , , Un vettore contiguo}
address@hidden ifclear
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="vettore-elementi" float="0">
+<title>Un vettore contiguo</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="vettore-elementi.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
address@hidden
+Vengono memorizzati solo i valori; gli indici sono definiti implicitamente
+dall'ordine dei valori. Qui, 8 @`e il valore il cui indice @`e zero, perch@'e 8
+appare nella posizione con zero elementi prima di essa.
+
address@hidden vettori, indicizzazione
address@hidden indicizzare i vettori
address@hidden associativi, vettori
address@hidden vettori associativi
+I vettori in @command{awk} non sono di questo tipo: sono invece
address@hidden
address@hidden significa che ogni vettore @`e un insieme di coppie, ognuna
costituita
+da un indice e dal corrispondente valore dell'elemento del vettore:
+
address@hidden
address@hidden extra empty column to indent it right
address@hidden @columnfractions .1 .1 .1
address@hidden @tab Indice @tab Valore
address@hidden @tab @code{3} @tab @code{30}
address@hidden @tab @code{1} @tab @code{"pippo"}
address@hidden @tab @code{0} @tab @code{8}
address@hidden @tab @code{2} @tab @code{""}
address@hidden multitable
address@hidden ifnotdocbook
+
address@hidden
+<informaltable>
+<tgroup cols="2">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<thead>
+<row>
+<entry>Indice</entry>
+<entry>Valore</entry>
+</row>
+</thead>
+
+<tbody>
+<row>
+<entry><literal>3</literal></entry>
+<entry><literal>30</literal></entry>
+</row>
+
+<row>
+<entry><literal>1</literal></entry>
+<entry><literal>"pippo"</literal></entry>
+</row>
+
+<row>
+<entry><literal>0</literal></entry>
+<entry><literal>8</literal></entry>
+</row>
+
+<row>
+<entry><literal>2</literal></entry>
+<entry><literal>""</literal></entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
address@hidden
+Le coppie sono elencate in ordine casuale perch@'e il loro ordinamento @`e
address@hidden'ordine address@hidden variare nelle diverse implementazioni
+di @command{awk}, che tipicamente usa tabelle @dfn{hash} per memorizzare
+elementi e valori del vettore.}
+
+Un vantaggio dei vettori associativi @`e che si possono aggiungere nuove coppie
+in qualsiasi momento. Per esempio, supponiamo di aggiungere al vettore un
+decimo elemento il cui valore sia @address@hidden"numero dieci"}}. Il
risultato address@hidden:
+
address@hidden
address@hidden extra empty column to indent it right
address@hidden @columnfractions .1 .1 .3
address@hidden @tab Indice @tab Valore
address@hidden @tab @code{10} @tab @code{"numero dieci"}
address@hidden @tab @code{3} @tab @code{30}
address@hidden @tab @code{1} @tab @code{"pippo"}
address@hidden @tab @code{0} @tab @code{8}
address@hidden @tab @code{2} @tab @code{""}
address@hidden multitable
address@hidden ifnotdocbook
+
address@hidden
+<informaltable>
+<tgroup cols="2">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<thead>
+<row>
+<entry>Indice</entry>
+<entry>Valore</entry>
+</row>
+</thead>
+<tbody>
+
+<row>
+<entry><literal>10</literal></entry>
+<entry><literal>"numero dieci"</literal></entry>
+</row>
+
+<row>
+<entry><literal>3</literal></entry>
+<entry><literal>30</literal></entry>
+</row>
+
+<row>
+<entry><literal>1</literal></entry>
+<entry><literal>"pippo"</literal></entry>
+</row>
+
+<row>
+<entry><literal>0</literal></entry>
+<entry><literal>8</literal></entry>
+</row>
+
+<row>
+<entry><literal>2</literal></entry>
+<entry><literal>""</literal></entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
address@hidden
address@hidden sparsi, vettori
address@hidden vettori sparsi
+Ora il vettore @`e @dfn{sparso}, il che significa semplicemente che non sono
+usati alcuni indici. Ha gli elementi 0, 1, 2, 3 e 10, ma mancano gli
+elementi 4, 5, 6, 7, 8 e 9.
+
+Un'altra caratteristica dei vettori associativi @`e che gli indici non devono
+essere necessariamente interi non negativi. Qualsiasi numero, o anche una
+stringa, address@hidden essere un indice. Per esempio, il seguente @`e un
vettore che
+traduce delle parole dall'inglese all'italiano:
+
address@hidden
address@hidden @columnfractions .1 .1 .1
address@hidden @tab Indice @tab Valore
address@hidden @tab @code{"dog"} @tab @code{"cane"}
address@hidden @tab @code{"cat"} @tab @code{"gatto"}
address@hidden @tab @code{"one"} @tab @code{"uno"}
address@hidden @tab @code{1} @tab @code{"uno"}
address@hidden multitable
address@hidden ifnotdocbook
+
address@hidden
+<informaltable>
+<tgroup cols="2">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<thead>
+<row>
+<entry>Indice</entry>
+<entry>Valore</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><literal>"dog"</literal></entry>
+<entry><literal>"cane"</literal></entry>
+</row>
+
+<row>
+<entry><literal>"cat"</literal></entry>
+<entry><literal>"gatto"</literal></entry>
+</row>
+
+<row>
+<entry><literal>"one"</literal></entry>
+<entry><literal>"uno"</literal></entry>
+</row>
+
+<row>
+<entry><literal>1</literal></entry>
+<entry><literal>"uno"</literal></entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
address@hidden
+Qui abbiamo deciso di tradurre il numero uno sia nella forma letterale che in
+quella numerica, per illustrare che un singolo vettore address@hidden avere
come indici
+sia numeri che stringhe.
+(In effetti, gli indici dei vettori sono sempre stringhe.
+Ci sono alcune sottigliezze su come funzionano i numeri quando sono usati come
+indici dei vettori; questo address@hidden trattato in maggior dettaglio nella
address@hidden numerici di vettore}.)
+Qui sopra, il numero @code{1} non @`e tra doppi apici, perch@'e @command{awk}
+lo converte automaticamente in una stringa.
+
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden maiuscolo/minuscolo, distinzione, indici dei vettori e
address@hidden vettori, ordinamento, variabile @code{IGNORECASE} e
address@hidden @code{IGNORECASE}, variabile, e indici dei vettori
address@hidden variabile @code{IGNORECASE}, e indici dei vettori
+Il valore di @code{IGNORECASE} non ha alcun effetto sull'indicizzazione dei
+vettori. Lo stesso valore di stringa usato per memorizzare un elemento di un
+vettore address@hidden essere usato per richiamarlo.
+Quando @command{awk} crea un vettore (p.es., con la funzione predefinita
address@hidden()}), gli indici di quel vettore sono numeri interi consecutivi
+a partire da uno.
+(@xref{Funzioni per stringhe}.)
+
+I vettori di @command{awk} sono efficienti: il tempo necessario per accedere a
+un elemento @`e indipendente dal numero di elementi nel vettore.
+
address@hidden Visitare elementi
address@hidden Come esaminare un elemento di un vettore
address@hidden vettori, esaminare elementi
address@hidden vettore, elementi di un
address@hidden elementi di un vettore
+
+Il modo principale di usare un vettore @`e quello di esaminare uno dei suoi
+elementi. Un @dfn{riferimento al vettore} @`e un'espressione come questa:
+
address@hidden
address@hidden@var{espressione-indice}]
address@hidden example
+
address@hidden
+Qui, @var{vettore} @`e il nome di un vettore. L'espressione
address@hidden @`e l'indice dell'elemento del vettore che si vuol
+esaminare.
+
address@hidden 1/2015: Having the 4.3 in @samp is a little iffy. It's
essentially
address@hidden an expression though, so leave be. It's to early in the
discussion
address@hidden to mention that it's really a string.
+Il valore del riferimento al vettore @`e il valore corrente di quell'elemento
+del vettore. Per esempio, @code{pippo[4.3]} @`e un'espressione che richiama
+l'elemento del vettore @code{pippo} il cui indice @`e @samp{4.3}.
+
address@hidden vettori, elementi non assegnati
address@hidden elementi di vettore non assegnati
address@hidden elementi di vettore vuoti
+Un riferimento a un elemento di un vettore il cui indice non esiste ancora
+restituisce un valore uguale a @code{""}, la stringa nulla. Questo comprende
+elementi a cui non @`e stato assegnato un valore ed elementi che sono stati
+eliminati (@pxref{Cancellazione}).
+
address@hidden elementi inesistenti di un vettore
address@hidden vettori, elementi che non esistono
address@hidden NOTA
+Un riferimento a un elemento inesistente crea @emph{automaticamente}
+quell'elemento di vettore, con la stringa nulla come valore. (In certi casi,
address@hidden @`e indesiderabile, perch@'e potrebbe sprecare memoria
all'interno di
address@hidden)
+
+I programmatori principianti di @command{awk} fanno spesso l'errore di
+verificare se un elemento esiste controllando se il valore @`e vuoto:
+
address@hidden
+# Verifica se "pippo" esiste in a: @ii{Non corretto!}
+if (a["pippo"] != "") @dots{}
address@hidden example
+
address@hidden
+Questo @`e sbagliato per due motivi. Primo, @emph{crea} @code{a["pippo"]}
+se ancora non esisteva! Secondo, assegnare a un elemento di un vettore la
+stringa vuota come valore @`e un'operazione valida (anche se un po' insolita).
address@hidden quotation
+
address@hidden @cindex arrays, @code{in} operator and
address@hidden @code{in}, operatore, verificare se un elemento esiste in un
vettore
+Per determinare se un elemento con un dato indice esiste in un vettore,
+si usi la seguente espressione:
+
address@hidden
address@hidden in @var{vettore}
address@hidden example
+
address@hidden effetti collaterali, indicizzazione di vettori
address@hidden
+Quest'espressione verifica se lo specifico indice @var{indice} esiste, senza
+l'effetto collaterale di creare quell'elemento nel caso che esso non sia
+presente. L'espressione ha il valore uno (vero) se
address@hidden@address@hidden
+esiste e zero (falso) se non esiste.
address@hidden (Qui usiamo @var{indx}, perch@'e @samp{index} @`e il nome di una
funzione
address@hidden predefinita.)
+Per esempio, quest'istruzione verifica se il vettore @code{frequenze}
+contiene l'indice @samp{2}:
+
address@hidden
+if (2 in frequenze)
+ print "L'indice 2 @`e presente."
address@hidden example
+
+Si noti che questo @emph{non} verifica se il vettore
address@hidden contiene un elemento il cui @emph{valore} @`e 2.
+Il solo modo far questo @`e quello di passare in rassegna tutti gli
+elementi. Inoltre, questo @emph{non} crea @code{frequenze[2]}, mentre la
+seguente alternativa (non corretta) lo fa:
+
address@hidden
+if (frequenze[2] != "")
+ print "L'indice 2 @`e presente."
address@hidden example
+
address@hidden Impostare elementi
address@hidden Assegnare un valore a elementi di un vettore
address@hidden vettori, elementi, assegnare valori
address@hidden elementi di vettori, assegnare valori
+
+Agli elementi di un vettore possono essere assegnati valori proprio come
+alle variabili di @command{awk}:
+
address@hidden
address@hidden@var{espressione-indice}] = @var{valore}
address@hidden example
+
address@hidden
address@hidden @`e il nome di un vettore. L'espressione
address@hidden @`e l'indice dell'elemento del vettore a cui @`e
+assegnato il valore. L'espressione @var{valore} @`e il valore da assegnare
+a quell'elemento del vettore.
+
address@hidden Esempio di vettore
address@hidden Esempio semplice di vettore
address@hidden vettori, un esempio sull'uso
+
+Il seguente programma prende una lista di righe, ognuna delle quali inizia con
+un numero di riga, e le stampa in ordine di numero di riga. I numeri di riga
+non sono ordinati al momento della lettura, ma sono invece in ordine sparso.
+Questo programma ordina le righe mediante la creazione di un vettore che usa
+i numeri di riga come indici. Il programma stampa poi le righe
+ordinate secondo il loro numero. @`E un programma molto semplice e non @`e in
+grado di gestire numeri ripetuti, salti di riga o righe che non
+iniziano con un numero:
+
address@hidden
address@hidden file eg/misc/arraymax.awk
address@hidden
+ if ($1 > massimo)
+ massimo = $1
+ vett[$1] = $0
address@hidden
+
+END @{
+ for (x = 1; x <= massimo; x++)
+ print vett[x]
address@hidden
address@hidden endfile
address@hidden example
+
+La prima regola tiene traccia del numero di riga address@hidden grande visto
+durante la lettura;
+memorizza anche ogni riga nel vettore @code{vett}, usando come indice
+il numero di riga.
+La seconda regola viene eseguita dopo che @`e stato letto tutto l'input, per
+stampare tutte le righe.
+Quando questo programma viene eseguito col seguente input:
+
address@hidden
address@hidden file eg/misc/arraymax.data
+5 Io sono l'uomo Cinque
+2 Chi sei? Il nuovo numero due!
+4 . . . E quattro a terra
+1 Chi @`e il numero uno?
+3 Sei il tre.
address@hidden endfile
address@hidden example
+
address@hidden
+Il suo output @`e:
+
address@hidden
+1 Chi @`e il numero uno?
+2 Chi sei? Il nuovo numero due!
+3 Sei il tre.
+4 . . . E quattro a terra
+5 Io sono l'uomo Cinque
address@hidden example
+
+Se un numero di riga appare address@hidden di una volta, l'ultima riga con
quel dato
+numero prevale sulle altre.
+Le righe non presenti nel vettore
+si possono saltare con un semplice perfezionamento della
+regola @code{END} del programma, in questo modo:
+
address@hidden
+END @{
+ for (x = 1; x <= massimo; x++)
+ if (x in vett)
+ print vett[x]
address@hidden
address@hidden example
+
address@hidden Visitare un intero vettore
address@hidden Visitare tutti gli elementi di un vettore
address@hidden elementi di vettori, visitare
address@hidden visitare vettori
address@hidden vettori, visitare
address@hidden cicli, @code{for}, visita di un vettore
+
+Nei programmi che usano vettori, @`e spesso necessario usare un ciclo che
+esegue un'azione su ciascun elemento di un vettore. In altri linguaggi, dove
+i vettori sono contigui e gli indici sono limitati ai numeri interi
+non negativi,
+questo @`e facile: tutti gli indici validi possono essere visitati partendo
+dall'indice address@hidden basso e arrivando a quello address@hidden alto.
Questa tecnica non
address@hidden applicabile in @command{awk}, perch@'e qualsiasi numero o
stringa address@hidden
+fare da indice in un vettore. address@hidden @command{awk} ha un tipo
speciale di
+istruzione @code{for} per visitare un vettore:
+
address@hidden
+for (@var{variabile} in @var{vettore})
+ @var{corpo}
address@hidden example
+
address@hidden
address@hidden @code{in}, operatore, uso in cicli
address@hidden operatore @code{in}, uso in cicli
+Questo ciclo esegue @var{corpo} una volta per ogni indice in @var{vettore} che
+il programma ha usato precedentemente, con la variabile @var{variabile}
+impostata a quell'indice.
+
address@hidden vettori, istruzione @code{for} e
address@hidden @code{for}, istruzione, esecuzione di cicli su un vettore
+Il seguente programma usa questa forma dell'istruzione @code{for}. La
+prima regola visita i record in input e tiene nota di quali parole appaiono
+(almeno una volta) nell'input, memorizzando un 1 nel vettore @code{usate} con
+la parola come indice. La seconda regola visita gli elementi di
address@hidden per trovare tutte le parole distinte che appaiono nell'input.
+Il programma stampa poi ogni parola che @`e address@hidden lunga di 10
caratteri e
+anche il numero di tali parole.
address@hidden per stringhe}
+per maggiori informazioni sulla funzione predefinita @code{length()}.
+
address@hidden
+# Registra un 1 per ogni parola usata almeno una volta
address@hidden
+ for (i = 1; i <= NF; i++)
+ usate[$i] = 1
address@hidden
+
+# Trova il numero di parole distinte lunghe address@hidden di 10 caratteri
+END @{
+ for (x in usate) @{
+ if (length(x) > 10) @{
+ ++numero_parole_lunghe
+ print x
+ @}
+ @}
+ print numero_parole_lunghe, "parole address@hidden lunghe di 10 caratteri"
address@hidden
address@hidden example
+
address@hidden
address@hidden utilizzo parole}
+per un esempio di questo tipo address@hidden dettagliato.
+
address@hidden vettori, elementi di, ordine di accesso da parte dell'operatore
@code{in}
address@hidden elementi di vettori, ordine di accesso da parte dell'operatore
@code{in}
address@hidden @code{in}, operatore, ordine di accesso dei vettori
address@hidden operatore @code{in}, ordine di accesso dei vettori
+L'ordine nel quale gli elementi del vettore sono esaminati da quest'istruzione
address@hidden determinato dalla disposizione interna degli elementi del
vettore all'interno
+di @command{awk} e nell'@command{awk} standard non address@hidden essere
controllato
+o cambiato. Questo address@hidden portare a dei problemi se vengono aggiunti
nuovi
+elementi al @var{vettore} dall'istruzione eseguendo il corpo del ciclo;
+non @`e prevedibile se il ciclo @code{for} li address@hidden raggiungere.
Similmente,
+modificare @var{variabile} all'interno del ciclo potrebbe produrre strani
+risultati. @`E meglio evitare di farlo.
+
+Di sicuro, @command{gawk} imposta la lista di elementi su cui eseguire
+l'iterazione prima che inizi il ciclo, e non la cambia in corso d'opera.
+Ma non tutte le versioni di @command{awk} fanno address@hidden@dotless{i}}. Si
consideri questo
+programma, chiamato @file{vediciclo.awk}:
+
address@hidden
+BEGIN @{
+ a["questo"] = "questo"
+ a["@`e"] = "@`e"
+ a["un"] = "un"
+ a["ciclo"] = "ciclo"
+ for (i in a) @{
+ j++
+ a[j] = j
+ print i
+ @}
address@hidden
address@hidden example
+
+Ecco quel che accade quando viene eseguito con @command{gawk} (e
@command{mawk}):
+
address@hidden
+$ @kbd{gawk -f vediciclo.awk}
address@hidden questo
address@hidden ciclo
address@hidden un
address@hidden @`e
address@hidden example
+
+Se si usa invece BWK @command{awk}:
+
address@hidden
+$ @kbd{nawk -f vediciclo.awk}
address@hidden ciclo
address@hidden questo
address@hidden @`e
address@hidden un
address@hidden 1
address@hidden example
+
address@hidden Controllare visita
address@hidden Visita di vettori in ordine predefinito con @command{gawk}
+
+Questa @value{SUBSECTION} descrive una address@hidden disponibile solo in
address@hidden
+
+Per default, quando un ciclo @code{for} visita un vettore, l'ordine
address@hidden indeterminato, il che vuol dire che l'implementazione di
@command{awk}
+determina l'ordine in cui il vettore viene attraversato.
+Quest'ordine normalmente @`e basato sull'implementazione interna dei vettori
+e varia da una versione di @command{awk} alla successiva.
+
address@hidden vettori, ordine di visita, controllo dell'
address@hidden controllare l'ordine di visita dei vettori
+Spesso, tuttavia, servirebbe fare qualcosa di semplice, come
+``visitare il vettore confrontando gli indici in ordine crescente,''
+o ``visitare il vettore confrontando i valori in ordine decrescente.''
address@hidden fornisce due meccanismi che permettono di farlo.
+
address@hidden @value{BULLET}
address@hidden
+Assegnare a @code{PROCINFO["sorted_in"]} un valore a scelta fra
+alcuni valori predefiniti.
+Si vedano address@hidden sotto i valori ammessi.
+
address@hidden
+Impostare @code{PROCINFO["sorted_in"]} al nome di una funzione definita
+dall'utente, da usare per il confronto tra gli elementi di un vettore. Questa
address@hidden avanzata address@hidden descritta in seguito in @ref{Ordinamento
di vettori}.
address@hidden itemize
+
address@hidden @code{PROCINFO}, valori di @code{sorted_in}
+Sono disponibili i seguenti valori speciali per @code{PROCINFO["sorted_in"]}:
+
address@hidden @code
address@hidden "@@unsorted"
+Lasciare gli elementi del vettore in ordine arbitrario
+(questo @`e il comportamento di default di @command{awk}).
+
address@hidden "@@ind_str_asc"
+Ordinare in ordine crescente di indice, confrontando tra loro gli indici
+come stringhe; questo @`e l'ordinamento address@hidden normale.
+(Internamente, gli indici dei vettori sono sempre stringhe, per cui con
address@hidden = 1} l'indice @`e la stringa @code{"10"} e non il numero 10.)
+
address@hidden "@@ind_num_asc"
+Ordinare in ordine crescente di indice, ma nell'elaborazione gli indici vengono
+trattati come numeri. Gli indici con valore non numerico verranno posizionati
+come se fossero uguali a zero.
+
address@hidden "@@val_type_asc"
+Ordinare secondo il valore degli elementi in ordine crescente (invece che in
+base agli indici). L'ordinamento @`e in base al tipo assegnato all'elemento
+(@pxref{Tipi di variabile e confronti}).
+Tutti i valori numerici precedono tutti i valori di tipo stringa,
+che a loro volta vengono prima dei sottovettori.
+(I sottovettori non sono ancora stati descritti;
address@hidden di vettori}.)
+
address@hidden "@@val_str_asc"
+Ordinare secondo il valore degli elementi in ordine crescente (invece che in
+base agli indici). I valori scalari sono confrontati come stringhe.
+I sottovettori, se presenti, vengono per ultimi.
+
address@hidden "@@val_num_asc"
+Ordinare secondo il valore degli elementi in ordine crescente (invece che in
+base agli indici). I valori scalari sono confrontati come numeri.
+I sottovettori, se presenti, vengono per ultimi.
+Quando i valori numerici coincidono, vengono usati i valori di tipo stringa
+per stabilire un ordinamento: address@hidden garantisce risultati coerenti tra
differenti
+versioni della funzione C @code{qsort()},@footnote{Quando due elementi
+risultano uguali, la funzione C @code{qsort()} non garantisce
+che dopo l'ordinamento venga rispettato il loro ordine relativo originale.
+Usando il valore di stringa per stabilire un ordinamento univoco quando i
+valori numerici sono uguali assicura che il comportamento di @command{gawk}
+sia coerente in differenti ambienti.} che @command{gawk} usa internamente
+per effettuare l'ordinamento.
+
address@hidden "@@ind_str_desc"
+Ordinare come fa @code{"@@ind_str_asc"}, ma gli
+indici di tipo stringa sono ordinati dal address@hidden alto al address@hidden
basso.
+
address@hidden "@@ind_num_desc"
+Ordinare come fa @code{"@@ind_num_asc"}, ma gli
+indici numerici sono ordinati dal address@hidden alto al address@hidden basso.
+
address@hidden "@@val_type_desc"
+Ordinare come fa @code{"@@val_type_asc"}, ma i valori
+degli elementi, a seconda del tipo, sono ordinati dal address@hidden alto al
address@hidden basso.
+I sottovettori, se presenti, vengono per primi.
+
address@hidden "@@val_str_desc"
+Ordinare come fa @code{"@@val_str_asc"}, ma i valori degli
+elementi, trattati come stringhe, sono ordinati dal address@hidden alto al
address@hidden basso.
+I sottovettori, se presenti, vengono per primi.
+
address@hidden "@@val_num_desc"
+Ordinare come fa @code{"@@val_num_asc"}, ma i valori degli
+elementi, trattati come numeri, sono ordinati dal address@hidden alto al
address@hidden basso.
+I sottovettori, se presenti, vengono per primi.
address@hidden table
+
+L'ordine in cui il vettore @`e visitato viene determinato prima di iniziare
+l'esecuzione del ciclo @code{for}. Cambiare @code{PROCINFO["sorted_in"]}
+all'interno del corpo del ciclo non influisce sul ciclo stesso.
+Per esempio:
+
address@hidden
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{ a[4] = 4}
+> @kbd{ a[3] = 3}
+> @kbd{ for (i in a)}
+> @kbd{ print i, a[i]}
+> @address@hidden'}
address@hidden 4 4
address@hidden 3 3
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{ PROCINFO["sorted_in"] = "@@ind_str_asc"}
+> @kbd{ a[4] = 4}
+> @kbd{ a[3] = 3}
+> @kbd{ for (i in a)}
+> @kbd{ print i, a[i]}
+> @address@hidden'}
address@hidden 3 3
address@hidden 4 4
address@hidden example
+
+Quando si ordina un vettore in base al valore dei suoi elementi, se viene
+trovato un valore che @`e un sottovettore, questo @`e considerato
address@hidden grande di
+qualsiasi stringa o valore numerico, indipendentemente da quel che contiene
+lo stesso sottovettore, e tutti i sottovettori sono trattati come se fossero
+l'uno uguale all'altro. Il loro ordine reciproco @`e determinato dai loro
+indici, visti come stringhe.
+
+Di seguito sono elencati alcuni punti da tener presenti sulla visita
+ordinata dei vettori:
+
address@hidden @value{BULLET}
address@hidden
+Il valore di @code{PROCINFO["sorted_in"]} @`e globale. address@hidden, ha
effetto su tutti
+i cicli @code{for} relativi a qualsiasi vettore. Se si deve cambiarlo
+all'interno del proprio codice, si dovrebbe vedere se era address@hidden stato
+definito in precedenza, e salvare il valore relativo, per ripristinarlo
+successivamente:
+
address@hidden
address@hidden
+if ("sorted_in" in PROCINFO) @{
+ ordine_salvato = PROCINFO["sorted_in"]
+ PROCINFO["sorted_in"] = "@@val_str_desc" # o qualcos'altro
address@hidden
address@hidden
+if (ordine_salvato)
+ PROCINFO["sorted_in"] = ordine_salvato
address@hidden example
+
address@hidden
+Come address@hidden accennato, l'ordine di visita di default del vettore
address@hidden rappresentato da @code{"@@unsorted"}. Si address@hidden
ottenere il comportamento di
+default anche assegnando la stringa nulla a @code{PROCINFO["sorted_in"]} o
+semplicemente eliminando l'elemento @code{"sorted_in"} dal vettore
address@hidden con l'istruzione @code{delete}.
+(L'istruzione @code{delete} non @`e stata ancora descritta;
@pxref{Cancellazione}.)
address@hidden itemize
+
+Inoltre, @command{gawk} fornisce funzioni predefinite per l'ordinamento
+dei vettori; si veda @ref{Funzioni di ordinamento di vettori}.
+
address@hidden Indici numerici di vettore
address@hidden Usare numeri per indicizzare i vettori
+
address@hidden numeri, come indici di vettore
address@hidden vettori, indici numerici di
address@hidden indici di vettori, numeri come
address@hidden @code{CONVFMT}, variabile, e indici di vettore
+Un aspetto importante da ricordare riguardo ai vettori @`e che
address@hidden indici dei vettori sono sempre stringhe}.
+Quando un valore numerico @`e usato come indice,
+viene convertito in un valore di tipo stringa prima di essere usato per
+l'indicizzazione (@pxref{Conversione}).
address@hidden vuol dire che il valore della variabile predefinita
@code{CONVFMT} address@hidden
+influire su come un programma ha accesso agli elementi di un vettore.
+Per esempio:
+
address@hidden
+xyz = 12.153
+dati[xyz] = 1
+CONVFMT = "%2.2f"
+if (xyz in dati)
+ printf "%s @`e in dati\n", xyz
+else
+ printf "%s non @`e in dati\n", xyz
address@hidden example
+
address@hidden
+Il risultato @`e @samp{12.15 non @`e in dati}. La prima istruzione
address@hidden a
address@hidden un valore numerico. L'assegnamento a @code{dati[xyz]}
+indicizza @code{dati} col valore di tipo stringa @code{"12.153"}
+(usando il valore di conversione di default @code{CONVFMT}, @code{"%.6g"}).
+Quindi, all'elemento del vettore @code{dati["12.153"]} @`e assegnato il valore
+uno. Il programma cambia poi
+il valore di @code{CONVFMT}. La verifica @samp{(xyz in dati)} genera un nuovo
+valore di stringa da @code{xyz}---questa volta @code{"12.15"}---perch@'e il
+valore di @code{CONVFMT} consente solo due cifre decimali. Questa
+verifica address@hidden esito negativo, perch@'e @code{"12.15"} @`e diverso da
@code{"12.153"}.
+
address@hidden convertire numeri interi che sono indici di vettore
address@hidden numeri interi, indici di vettore
+Secondo le regole di conversione
+(@pxref{Conversione}), i valori numerici interi
+vengono convertiti in stringhe sempre come interi, indipendentemente dal
+valore che potrebbe avere @code{CONVFMT}. E infatti il caso
+seguente produce il risultato atteso:
+
address@hidden
+for (i = 1; i <= maxsub; i++)
+ @ii{fa qualcosa con} vettore[i]
address@hidden example
+
+La regola ``i valori numerici interi si convertono sempre in stringhe intere''
+ha un'altra conseguenza per l'indicizzazione dei vettori.
+Le costanti ottali ed esadecimali
address@hidden
+(@pxref{Numeri non-decimali})
address@hidden ifnotdocbook
address@hidden
+(trattate in @ref{Numeri non-decimali})
address@hidden ifdocbook
+vengono convertite internamente in numeri, e la loro forma originale
+non viene address@hidden ricordata. address@hidden significa, per esempio, che
address@hidden,
address@hidden e
address@hidden fanno riferimento tutti allo stesso
+elemento!
+
+Come molte cose in @command{awk}, molto spesso le cose
+funzionano come ci si aspetta. @`E utile comunque avere una
+conoscenza precisa delle regole applicate, poich@'e a volte possono avere
+effetti difficili da individuare sui programmi.
+
address@hidden Indici non inizializzati
address@hidden Usare variabili non inizializzate come indici
+
address@hidden variabili non inizializzate, come indici di vettore
address@hidden non inizializzate, variabili, come indici di vettore
address@hidden indici di vettore, variabili non inizializzate come
address@hidden vettori, indici, variabili non inizializzate come
+Supponiamo che sia necessario scrivere un programma
+per stampare i dati di input in ordine inverso.
+Un tentativo ragionevole per far address@hidden (con qualche dato di
+prova) potrebbe essere qualcosa di questo tipo:
+
address@hidden
+$ @kbd{echo 'riga 1}
+> @kbd{riga 2}
+> @kbd{riga 3' | awk '@{ l[righe] = $0; ++righe @}}
+> @kbd{END @{}
+> @kbd{for (i = righe - 1; i >= 0; i--)}
+> @kbd{print l[i]}
+> @address@hidden'}
address@hidden riga 3
address@hidden riga 2
address@hidden example
+
+Sfortunatamente, la prima riga di dati in input non appare
+nell'output!
+
+A prima vista, verrebbe da dire che questo programma avrebbe dovuto
+funzionare. La variabile @code{righe}
+non @`e inizializzata, e le variabili non inizializzate hanno il valore
numerico
+zero. address@hidden@dotless{i}}, @command{awk} dovrebbe aver stampato il
valore @code{l[0]}.
+
+Qui il problema @`e che gli indici per i vettori di @command{awk} sono
address@hidden stringhe. Le variabili non inizializzate, quando sono usate come
+stringhe, hanno il valore @code{""}, e non zero. Quindi, @samp{riga 1}
+finisce per essere memorizzata in @code{l[""]}.
+La seguente variante del programma funziona correttamente:
+
address@hidden
address@hidden l[righe++] = $0 @}
+END @{
+ for (i = righe - 1; i >= 0; i--)
+ print l[i]
address@hidden
address@hidden example
+
+Qui, @samp{++} forza @code{righe} a essere di tipo numerico, rendendo
+quindi il ``vecchio valore'' uno zero numerico. Questo viene poi convertito
+in @code{"0"} come l'indice del vettore.
+
address@hidden nulle, stringhe, come indici di vettore
address@hidden stringhe nulle, come indici di vettore
address@hidden angolo buio, indici di vettori
address@hidden @dfn{lint}, controlli, indici di vettori
address@hidden controlli @dfn{lint}, indici di vettori
+Anche se la cosa address@hidden sembrare strana, la stringa nulla
+(@code{""}) @`e un indice di vettore valido.
address@hidden
+Se viene fornita l'opzione @option{--lint} sulla riga di comando
address@hidden), @command{gawk} avvisa quando la stringa nulla viene usata
+come indice.
+
address@hidden Cancellazione
address@hidden L'istruzione @code{delete}
address@hidden @code{delete}, istruzione
address@hidden istruzione @code{delete}
address@hidden eliminare elementi di vettori
address@hidden vettori, elementi, eliminazione di
address@hidden elementi di vettori, eliminazione di
+
+Per rimuovere un singolo elemento da un vettore si usa l'istruzione
address@hidden:
+
address@hidden
+delete @address@hidden
address@hidden example
+
+Una volta che un elemento di un vettore @`e stato eliminato, il valore che
aveva
+quell'elemento non @`e address@hidden disponibile. @`E come se quell'elemento
non sia
+mai stato referenziato oppure come se non gli sia mai stato assegnato un
+valore. Il seguente @`e un esempio di eliminazione di elementi da un vettore:
+
address@hidden
+for (i in frequenze)
+ delete frequenze[i]
address@hidden example
+
address@hidden
+Quest'esempio rimuove tutti gli elementi dal vettore @code{frequenze}. Una
+volta che un elemento @`e stato eliminato, una successiva istruzione @code{for}
+che visiti il vettore non address@hidden quell'elemento, e l'uso dell'operatore
address@hidden per controllare la presenza di quell'elemento restituisce zero
(address@hidden
+falso):
+
address@hidden
+delete pippo[4]
+if (4 in pippo)
+ print "Questo non address@hidden mai stampato"
address@hidden example
+
address@hidden nulle, stringhe, ed eliminazione di elementi di un vettore
address@hidden stringhe nulle, ed eliminazione di elementi di un vettore
address@hidden importante notare che eliminare un elemento @emph{non} @`e la
stessa cosa
+che assegnargli un valore nullo (la stringa vuota, @code{""}).
+Per esempio:
+
address@hidden
+pippo[4] = ""
+if (4 in pippo)
+ print "Questo viene stampato, anche se pippo[4] @`e vuoto"
address@hidden example
+
address@hidden @dfn{lint}, controlli, elementi di vettori
address@hidden controlli @dfn{lint}, elementi di vettori
address@hidden elementi di vettori, controlli @dfn{lint} per
+Non @`e un errore eliminare un elemento che non esiste.
+Tuttavia, se viene data l'opzione @option{--lint} sulla riga di comando
+(@pxref{Opzioni}),
address@hidden emette un messaggio di avvertimento quando viene eliminato un
+elemento che non @`e presente in un vettore.
+
address@hidden comuni, estensioni, @code{delete} per eliminare interi vettori
address@hidden estensioni address@hidden @code{delete} per eliminare interi
vettori
address@hidden vettori, eliminare l'intero contenuto
address@hidden eliminare interi vettori
address@hidden @code{delete}, @var{vettore}
address@hidden differenze tra @command{awk} e @command{gawk}, elementi dei
vettori, eliminazione
+Tutti gli elementi di un vettore possono essere eliminati con una singola
+istruzione omettendo l'indice nell'istruzione @code{delete},
+in questo modo:
+
+
address@hidden
+delete @var{vettore}
address@hidden example
+
+L'uso di questa versione dell'istruzione @code{delete} @`e circa tre volte
address@hidden
+efficiente dell'equivalente ciclo che elimina gli elementi uno
+alla volta.
+
+Questa forma dell'istruzione @code{delete} @`e ammessa anche
+da BWK @command{awk} e da @command{mawk}, e anche da
+diverse altre implementazioni.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden NOTA
+Per molti anni, l'uso di @code{delete} senza un indice era un'estensione
+comune. A settembre 2012 si @`e deciso di includerla nello
+standard POSIX. Si veda @uref{http://austingroupbugs.net/view.php?id=544,
+il sito dell'Austin Group}.
address@hidden quotation
+
address@hidden address@hidden, eliminazione di elementi di un vettore
address@hidden Brennan, Michael
+La seguente istruzione fornisce un modo portabile, anche se non evidente,
+per svuotare un vettore:@footnote{Un ringraziamento a Michael
+Brennan per la segnalazione.}
+
address@hidden
+split("", vettore)
address@hidden example
+
address@hidden @code{split()}, funzione, eliminazione di elementi di vettori
address@hidden funzione @code{split()}, eliminazione di elementi di vettori
+La funzione @code{split()}
+(@pxref{Funzioni per stringhe})
+dapprima svuota il vettore indicato. La chiamata chiede di dividere
+la stringa nulla. Poich@'e non c'@`e nulla da dividere, la
+funzione si limita a svuotare il vettore e poi termina.
+
address@hidden ATTENZIONE
+L'eliminazione di tutti gli elementi di un vettore non cambia il suo tipo; non
+si address@hidden svuotare un vettore e poi usare il nome del vettore come
scalare
+(address@hidden, come una variabile semplice). Per esempio, questo non @`e
consentito:
+
address@hidden
+a[1] = 3
+delete a
+a = 3
address@hidden example
address@hidden quotation
+
address@hidden Vettori multidimensionali
address@hidden Vettori multidimensionali
+
address@hidden
+* Visitare vettori multidimensionali:: Visitare vettori multidimensionali.
address@hidden menu
+
address@hidden indici di vettori multidimensionali
address@hidden vettori multidimensionali
address@hidden multidimensionali, vettori
+Un @dfn{vettore multidimensionale} @`e un vettore in cui un elemento @`e
+identificato da un insieme di indici invece che da un indice singolo. Per
+esempio, un vettore bidimenisonale richiede due indici. Il modo consueto (in
+molti linguaggi, compreso @command{awk}) per far riferimento a un elemento di
+un vettore multidimensionale chiamato @code{griglia} @`e con
address@hidden@var{x},@var{y}]}.
+
address@hidden @code{SUBSEP}, variabile, e vettori multidimensionali
address@hidden variabile @code{SUBSEP}, e vettori multidimensionali
+I vettori multidimensionali sono resi disponibili in @command{awk} attraverso
+la concatenazione di address@hidden indici in una stringa;
address@hidden converte gli indici in stringhe
+(@pxref{Conversione}) e
+le concatena assieme, inserendo un separatore tra ognuna di loro. Ne
+risulta una sola stringa che include i valori di ogni indice. La
+stringa address@hidden@dotless{i}} composta viene usata come un singolo indice
in un vettore
+ordinario monodimensionale. Il separatore usato @`e il valore della variabile
+predefinita @code{SUBSEP}.
+
+Per esempio, supponiamo di valutare l'espressione @samp{pippo[5,12] = "valore"}
+quando il valore di @code{SUBSEP} @`e @code{"@@"}. I numeri 5 e 12 vengono
+convertiti in stringhe che sono poi
+concatenate con un @samp{@@} tra di essi, dando @code{"5@@12"}; di conseguenza,
+l'elemento del vettore @code{pippo["5@@12"]} @`e impostato a @code{"valore"}.
+
+Una volta che il valore dell'elemento @`e memorizzato, @command{awk}
+ignora se sia stato memorizzato con un solo indice o con una
+serie di indici. Le due espressioni @samp{pippo[5,12]} e
address@hidden@samp{pippo[5 SUBSEP 12]}} sono sempre equivalenti.
+
+Il valore di default di @code{SUBSEP} @`e la stringa @code{"\034"},
+che contiene un carattere non stampabile che difficilmente appare in
+un programma di @command{awk} e nella maggior parte dei dati di input.
+Il vantaggio di scegliere un carattere improbabile discende dal fatto che i
+valori degli indici che contengono una stringa corrispondente a @code{SUBSEP}
+possono portare a stringhe risultanti ambigue. Supponendo che
address@hidden valga @code{"@@"}, @address@hidden"a@@b", "c"]}} e
address@hidden@samp{pippo["a", "b@@c"]}} risultano indistinguibili perch@'e
entrambi
+sarebbero in address@hidden memorizzati come @samp{pippo["a@@b@@c"]}.
+
address@hidden @code{in}, operatore, verificare se un elemento esiste in un
vettore multidimensionale
+Per verificare se una determinata sequenza di indici esiste in un vettore
+multidimensionale, si usa lo stesso operatore (@code{in}) che viene usato
+per i vettori monodimensionali. Si scrive l'intera sequenza di indici tra
+parentesi, separati da virgole, come operando di sinistra:
+
address@hidden
+if ((@var{indice1}, @var{indice2}, @dots{}) in @var{vettore})
+ @dots{}
address@hidden example
+
+Qui vediamo un esempio, avendo in input un vettore bidimensionale
+di campi, ruota questo vettore di 90 gradi in senso orario e stampa il
+risultato. Si suppone che tutte le righe in input contengano lo stesso
+numero di elementi:
+
address@hidden
address@hidden
+ if (max_nf < NF)
+ max_nf = NF
+ max_nr = NR
+ for (x = 1; x <= NF; x++)
+ vettore[x, NR] = $x
address@hidden
+
+END @{
+ for (x = 1; x <= max_nf; x++) @{
+ for (y = max_nr; y >= 1; --y)
+ printf("%s ", vettore[x, y])
+ printf("\n")
+ @}
address@hidden
address@hidden example
+
address@hidden
+Dato l'input:
+
address@hidden
+1 2 3 4 5 6
+2 3 4 5 6 1
+3 4 5 6 1 2
+4 5 6 1 2 3
address@hidden example
+
address@hidden
+il programma produce il seguente output:
+
address@hidden
+4 3 2 1
+5 4 3 2
+6 5 4 3
+1 6 5 4
+2 1 6 5
+3 2 1 6
address@hidden example
+
address@hidden Visitare vettori multidimensionali
address@hidden Visitare vettori multidimensionali
+
+Non c'@`e un'istruzione @code{for} particolare per visitare un
+vettore ``multidimensionale''. Non ce ne address@hidden essere una, perch@'e
address@hidden in address@hidden non ha
+vettori o elementi multidimensionali: c'@`e solo una address@hidden
+multidimensionale per @emph{accedere} a un vettore.
+
address@hidden indici di vettori multidimensionali, visitare gli
address@hidden vettori, multidimensionali, visitare
address@hidden visitare vettori multidimensionali
+Comunque, se un programma ha un vettore al quale si accede sempre in
address@hidden multidimensionale, si address@hidden ottenere il risultato di
visitarlo
+combinando l'istruzione di visita @code{for}
+(@pxref{Visitare un intero vettore}) con la funzione
+interna @code{split()}
+(@pxref{Funzioni per stringhe}).
+Si procede nel seguente modo:
+
address@hidden
+for (indice_combinato in vettore) @{
+ split(indice_combinato, indici_separati, SUBSEP)
+ @dots{}
address@hidden
address@hidden example
+
address@hidden
+Questo imposta la variabile @code{indice_combinato} a ogni
+concatenazione di indici contenuta nel vettore, e la suddivide
+nei singoli indici separandoli
+in corrispondenza del valore di
address@hidden I singoli indici diventano poi gli elementi
+del vettore @code{indici_separati}.
+
address@hidden, se un valore @`e stato precedentemente memorizzato in
address@hidden, "pippo"]}, esiste in @code{vettore} un elemento con indice
address@hidden"1\034pippo"} (ricordare che il valore di default di @code{SUBSEP}
address@hidden il carattere con codice ottale 034).
+Prima o poi, l'istruzione @code{for} trova quell'indice e fa un'iterazione
+con la variabile @code{indice_combinato} impostata a @code{"1\034pippo"}.
+Poi viene chiamata la funzione @code{split()} in questo modo:
+
address@hidden
+split("1\034pippo", indici_separati, "\034")
address@hidden example
+
address@hidden
+Il risultato @`e quello di impostare @code{indici_separati[1]} a @code{"1"} e
address@hidden a @code{"pippo"}. Ecco fatto!
+La sequenza originale degli indici separati @`e ripristinata.
+
+
address@hidden Vettori di vettori
address@hidden Vettori di vettori
address@hidden vettori di vettori
+
address@hidden migliora l'accesso ai vettori multidimensionali di
address@hidden standard e mette a disposizione dei veri vettori di vettori.
+Agli elementi di un sottovettore si fa riferimento tramite il loro indice
+racchiuso tra parentesi quadre, proprio come gli elementi del vettore
+principale. Per esempio, quel che segue crea un sottovettore con due elementi
+all'indice @code{1} del vettore principale @code{a}:
+
address@hidden
+a[1][1] = 1
+a[1][2] = 2
address@hidden example
+
+Questo simula un vero vettore bidimensionale. Ogni elemento di un sottovettore
address@hidden contenere un altro sottovettore come valore, che a sua volta
address@hidden
+contenere anche ulteriori vettori. In questo modo, si possono creare vettori
+di tre o address@hidden dimensioni.
+Gli indici possono essere costituiti da qualunque espressione di
address@hidden, compresi dei
+valori scalari separati da virgole (address@hidden, un indice
multidimensionale simulato
+di @command{awk}). Quindi, la seguente espressione @`e valida in
address@hidden:
+
address@hidden
+a[1][3][1, "nome"] = "barney"
address@hidden example
+
+Ogni sottovettore e il vettore principale possono essere di diversa lunghezza.
+Di fatto, gli elementi di un vettore o un suo sottovettore non devono essere
+necessariamente tutti dello stesso tipo. address@hidden significa che il
vettore
+principale come anche uno qualsiasi dei suoi sottovettori address@hidden essere
+non rettangolare,
+o avere una struttura frastagliata. Si address@hidden assegnare un valore
scalare
+all'indice @code{4} del vettore principale @code{a}, anche se @code{a[1]}
address@hidden esso stesso un vettore e non uno scalare:
+
address@hidden
+a[4] = "Un elemento in un vettore frastagliato"
address@hidden example
+
+I termini @dfn{dimensione}, @dfn{riga} e @dfn{colonna} sono privi di
+significato quando sono applicati
+a questo tipo di vettore, ma d'ora in poi useremo ``dimensione'' per indicare
+il numero massimo di indici necessario per far riferimento a un elemento
+esistente. Il tipo di ogni elemento che @`e address@hidden stato assegnato non
address@hidden essere
+cambiato assegnando un valore di tipo diverso. Prima si deve eliminare
+l'elemento corrente, per togliere completamente dalla memoria di
address@hidden ogni riferimento a quell'indice:
+
address@hidden
+delete a[4]
+a[4][5][6][7] = "Un elemento in un vettore quadridimensionale"
address@hidden example
+
address@hidden
+Le due istruzioni rimuovono il valore scalare dall'indice @code{4} e
+inseriscono poi un
+sottovettore interno a tre indici contenente uno scalare. Si address@hidden
anche
+eliminare un intero sottovettore o un sottovettore di sottovettori:
+
address@hidden
+delete a[4][5]
+a[4][5] = "Un elemento nel sottovettore a[4]"
address@hidden example
+
+Si deve address@hidden ricordare che non @`e consentito eliminare il vettore
principale
address@hidden e poi usarlo come scalare.
+
+Le funzioni predefinite che accettano come argomenti dei vettori possono
+essere usate
+anche con i sottovettori. Per esempio, il seguente frammento di codice usa
address@hidden()} (@pxref{Funzioni per stringhe})
+per determinare il numero di elementi nel vettore principale @code{a}
+e nei suoi sottovettori:
+
address@hidden
+print length(a), length(a[1]), length(a[1][3])
address@hidden example
+
address@hidden
+Il risultato per il nostro vettore principale @code{a} @`e il seguente:
+
address@hidden
+2, 3, 1
address@hidden example
+
address@hidden
+L'espressione @address@hidden in @var{vettore}}
+(@pxref{Visitare elementi}) funziona allo stesso modo sia per
+i vettori regolari in stile @command{awk}
+che per i vettori di vettori. Per esempio, le espressioni @samp{1 in a},
address@hidden in a[1]} e @samp{(1, "nome") in a[1][3]} risultano tutte di
valore
+uno (vero) per il nostro vettore @code{a}.
+
+L'istruzione @samp{for (elemento in vettore)} (@pxref{Visitare un intero
vettore})
address@hidden essere nidificata per visitare tutti gli
+elementi di un vettore di vettori che abbia una struttura rettangolare. Per
+stampare il contenuto (valori scalari) di un vettore di vettori bidimensionale
+(address@hidden nel quale ogni elemento di primo livello @`e esso stesso un
+vettore, non necessariamente di lunghezza uguale agli altri)
+si address@hidden usare il seguente codice:
+
address@hidden
+for (i in vettore)
+ for (j in vettore[i])
+ print vettore[i][j]
address@hidden example
+
+La funzione @code{isarray()} (@pxref{Funzioni per i tipi})
+permette di verificare se un elemento di un vettore @`e esso stesso un vettore:
+
address@hidden
+for (i in vettore) @{
+ if (isarray(vettore[i]) @{
+ for (j in vettore[i]) @{
+ print vettore[i][j]
+ @}
+ @}
+ else
+ print vettore[i]
address@hidden
address@hidden example
+
+Se la struttura di un vettore di vettori frastagliato @`e nota in anticipo,
+si address@hidden spesso trovare il modo per visitarlo usando istruzioni di
controllo.
+Per esempio,
+il seguente codice stampa gli elementi del nostro vettore principale @code{a}:
+
address@hidden
+for (i in a) @{
+ for (j in a[i]) @{
+ if (j == 3) @{
+ for (k in a[i][j])
+ print a[i][j][k]
+ @} else
+ print a[i][j]
+ @}
address@hidden
address@hidden example
+
address@hidden
address@hidden vettori} per una funzione definita dall'utente che
+``visita'' un vettore di vettori di dimensioni arbitrarie.
+
+Si ricordi che un riferimento a un elemento di un vettore non
+inizializzato genera un elemento con valore uguale a @code{""}, la stringa
+nulla. Questo ha
+un'importante implicazione quando s'intende usare un sottovettore come
+argomento di una funzione, come illustrato nel seguente esempio:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ split("a b c d", b[1]); print b[1][1] @}'}
address@hidden gawk: riga com.:1: fatale: split: secondo argomento
address@hidden non-vettoriale
address@hidden example
+
+Il modo per aggirare quest'ostacolo @`e quello di definire prima @code{b[1]}
+come vettore creando un indice arbitrario:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ b[1][1] = ""; split("a b c d", b[1]); print b[1][1] @}'}
address@hidden a
address@hidden example
+
address@hidden Sommario dei vettori
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
address@hidden standard dispone di vettori associativi monodimensionali
+(vettori indicizzati da valori di tipo stringa). Tutti i vettori sono
+associativi; gli indici numerici vengono convertiti automaticamente in
+stringhe.
+
address@hidden
+Agli elementi dei vettori si fa riferimento come
address@hidden@address@hidden Fare riferimento a un elemento lo
+crea se questo non esiste ancora.
+
address@hidden
+Il modo corretto per vedere se un vettore ha un elemento con un dato indice
address@hidden quello di usare l'operatore @code{in}: @address@hidden in
@var{vettore}}.
+
address@hidden
+Si usa @samp{for (@var{indice} in @var{vettore}) @dots{}} per visitare
+ogni singolo elemento di un vettore. Nel corpo del ciclo,
address@hidden assume via via il valore dell'indice di ogni elemento del
vettore.
+
address@hidden
+L'ordine in cui il ciclo @samp{for (@var{indice} in @var{vettore})}
+attraversa un vettore non @`e definito in POSIX @command{awk} e varia a seconda
+dell'implementazione. @command{gawk} consente di controllare l'ordinamento
+di visita
+assegnando speciali valori predefiniti a @code{PROCINFO["sorted_in"]}.
+
address@hidden
+Si usa @samp{delete @address@hidden per eliminare un singolo
+elemento di un vettore.
+Per eliminare tutti gli elementi di un vettore,
+si usa @samp{delete @var{vettore}}.
+Quest'ultima address@hidden @`e stata per molti anni un'estensione comune
+e ora @`e standard, ma potrebbe non essere disponibile in tutte le
+versioni commerciali di @command{awk}.
+
address@hidden
address@hidden standard simula vettori multidimensionali ammettendo
address@hidden indici
+separati da virgole. I loro valori sono concatenati in un'unica
+stringa, separati dal valore di @code{SUBSEP}. Il modo di creazione
+dell'indice non viene immagazzinato; address@hidden@dotless{i}},
+cambiare @code{SUBSEP} potrebbe avere conseguenze inaspettate. Si
address@hidden usare
address@hidden(@var{sub1}, @var{sub2}, @dots{}) in @var{vettore}} per vedere se
+un certo indice multidimensionale esiste in @var{vettore}.
+
address@hidden
address@hidden consente di avere a disposizione veri vettori di vettori.
+Si usa una coppia
+di parentesi quadre per ogni dimensione in tali vettori:
address@hidden, per esempio. Gli elementi del vettore possono
+poi essere valori scalari (numeri o stringhe) o altri vettori.
+
address@hidden
+Si usa la funzione predefinita @code{isarray()} per determinare se un elemento
+di un vettore @`e esso stesso un sottovettore.
+
address@hidden itemize
+
address@hidden Funzioni
address@hidden Funzioni
+
address@hidden funzioni predefinite
address@hidden predefinite, funzioni
+Questo @value{CHAPTER} descrive le funzioni predefinite di @command{awk},
+che sono di tre tipi: numeriche, di stringa, e di I/O.
address@hidden mette a disposizione ulteriori tipi di funzioni
+per gestire valori che rappresentano marcature temporali, per manipolare bit,
per
+ordinare vettori, per fornire informazioni sui tipi di variabile,
+per internazionalizzare e localizzare i address@hidden
+un'introduzione alle tematiche suddette, si address@hidden consultare
l'articolo
+"Localizzazione dei programmi" nel
address@hidden://www.pluto.it/files/journal/pj0404/l10n.html, sito pluto.it.}}
+
+Oltre alle funzioni predefinite, @command{awk} consente di
+scrivere nuove funzioni utilizzabili all'interno di un programma.
+La seconda address@hidden di questo @value{CHAPTER} descrive le funzioni
address@hidden dall'utente}.
+Vengono infine descritte le chiamate indirette a una funzione, un'estensione
+specifica di @command{gawk} che consente di stabilire durante l'esecuzione del
+programma quale funzione chiamare.
+
address@hidden
+* Funzioni predefinite:: Riepilogo delle funzioni predefinite.
+* Funzioni definite dall'utente:: Descrizione dettagliata delle funzioni
+ definite dall'utente.
+* Chiamate indirette:: Scegliere la funzione da chiamare in
+ fase di esecuzione del programma.
+* Sommario delle funzioni:: Sommario delle funzioni.
address@hidden menu
+
address@hidden Funzioni predefinite
address@hidden Funzioni predefinite
+
+Le funzioni @dfn{predefinite} sono sempre disponibili per essere chiamate
+da un programma @command{awk}. Questa @value{SECTION} definisce tutte le
+funzioni predefinite di @command{awk}; di alcune di queste si fa menzione
+in altre @value{SECTIONS},
+ma sono comunque riassunte anche qui per address@hidden
+
address@hidden
+* Chiamare funzioni predefinite:: Come chiamare funzioni predefinite.
+* Funzioni numeriche:: Funzioni che trattano numeri, comprese
+ @code{int()}, @code{sin()} e @code{rand()}.
+* Funzioni per stringhe:: Funzioni di manipolazione di stringhe,
+ come @code{split()}, @code{match()}
+ e @code{sprintf()}.
+* Funzioni di I/O:: Funzioni per i file e per i comandi
+ della shell.
+* Funzioni di tempo:: Funzione per gestire marcature temporali.
+* Funzioni a livello di bit:: Funzioni per operazioni di
+ manipolazione bit.
+* Funzioni per i tipi:: Funzioni per informazioni sul tipo
+ di una variabile.
+* Funzioni di internazionalizzazione:: Funzioni per tradurre stringhe.
address@hidden menu
+
address@hidden Chiamare funzioni predefinite
address@hidden Chiamare funzioni predefinite
+
+Per chiamare una delle funzioni predefinite di @command{awk},
+si scrive il nome della funzione seguito dai suoi argomenti racchiusi
+tra parentesi. Per esempio, @samp{atan2(y + z, 1)}
address@hidden una chiamata alla funzione @code{atan2()} e ha due argomenti.
+
address@hidden convenzioni di programmazione, nelle chiamate di funzione
address@hidden spazio bianco, nelle chiamate di funzione
+La presenza di spazi bianchi tra il nome della funzione predefinita
+e la parentesi aperta @`e consentita, ma @`e buona norma quella di evitare
+di inserire spazi bianchi in quella posizione.
+Le funzioni definite dall'utente non consentono che vi siano spazi bianchi
+fra nome funzione e aperta parentesi,
+ed @`e address@hidden semplice evitare errori seguendo una semplice
convenzione che
+resta sempre valida: non inserire spazi dopo il nome di una funzione.
+
address@hidden risoluzione di problemi, @command{gawk}, errori address@hidden
argomenti di funzione e
address@hidden problemi, risoluzione di, @command{gawk}, errori address@hidden
argomenti di funzione e
address@hidden @command{gawk}, argomenti di funzione e
address@hidden differenze tra @command{awk} e @command{gawk}, argomenti di
funzione (@command{gawk})
+Ogni funzione predefinita accetta un certo numero di argomenti.
+In alcuni casi, gli argomenti possono essere omessi. I valori di default per
+gli argomenti omessi variano
+da funzione a funzione e sono descritti insieme a
+ciascuna funzione. In alcune implementazioni di @command{awk}, gli
+eventuali argomenti in address@hidden specificati per le funzioni predefinite
sono
+ignorati. Tuttavia, in @command{gawk},
address@hidden un errore fatale fornire argomenti in address@hidden a una
funzione predefinita.
+
+Quando si richiama una funzione viene calcolato, prima di effettuare la
+chiamata, il valore assunto dalle espressioni che descrivono i parametri
+da passare alla funzione.
+Per esempio, nel seguente frammento di codice:
+
address@hidden
+i = 4
+j = sqrt(i++)
address@hidden example
+
address@hidden ordine di valutazione, funzioni
address@hidden funzioni predefinite, ordine di valutazione
address@hidden predefinite, funzioni, ordine di valutazione
address@hidden
+la variabile @code{i} @`e incrementata al valore cinque prima di chiamare
+la funzione @code{sqrt()} alla quale viene fornito come parametro il valore
+quattro.
+L'ordine di valutazione delle espressioni usate come parametri per la
+funzione @`e indefinito. Per questo motivo, si deve evitare di scrivere
+programmi che presuppongono che i parametri siano valutati da sinistra a
+destra o da destra a sinistra. Per esempio:
+
address@hidden
+i = 5
+j = atan2(++i, i *= 2)
address@hidden example
+
+Se l'ordine di valutazione @`e da sinistra a destra, @code{i} assume dapprima
+il valore 6, e quindi il valore 12, e la funzione @code{atan2()} @`e chiamata
+con i due argomenti 6 e 12. Ma se l'ordine di valutazione @`e da destra a
+sinistra, @code{i} assume dapprima il valore 10, e poi il valore 11, e la
+funzione @code{atan2()} @`e chiamata con i due argomenti 11 e 10.
+
address@hidden Funzioni numeriche
address@hidden Funzioni numeriche
address@hidden funzioni numeriche
address@hidden numeriche, funzioni
+
+La seguente lista descrive tutte le
+funzioni predefinite che hanno a che fare con i numeri.
+I parametri facoltativi sono racchiusi tra parentesi address@hidden ([ ]):}
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{atan2(@var{y}, @var{x})}
address@hidden
address@hidden arcotangente
+Restituisce l'arcotangente di @address@hidden / @var{x}} in radianti.
+Si address@hidden usare @samp{pi = atan2(0, -1)} per ottenere il valore di
address@hidden greco.
+
address@hidden @code{cos(@var{x})}
address@hidden
address@hidden coseno
+Restituisce il coseno di @var{x}, con @var{x} in radianti.
+
address@hidden @code{exp(@var{x})}
address@hidden
address@hidden esponenziale
+Restituisce l'esponenziale di @var{x} (@code{e ^ @var{x}}) o un messaggio
+di errore se @var{x} @`e fuori dall'intervallo consentito.
+L'intervallo entro il quale address@hidden variare @var{x}
+dipende dalla rappresentazione dei numeri in virgola mobile nella macchina in
+uso.
+
address@hidden @code{int(@var{x})}
address@hidden
address@hidden arrotondamento all'intero address@hidden vicino
+Restituisce l'intero address@hidden vicino a @var{x}, situato tra @var{x} e
zero,
+troncato togliendo i decimali.
+Per esempio, @code{int(3)} @`e 3, @code{int(3.9)} @`e 3, @code{int(-3.9)}
address@hidden @minus{}3, e @code{int(-3)} @`e ancora @minus{}3.
+
address@hidden @code{intdiv(@var{numeratore}, @var{denominatore},
@var{risultato})}
address@hidden
address@hidden funzione @code{intdiv}
+Esegue una divisione tra numeri interi, simile alla funzione standard C
+che ha lo stesso nome. Dapprima, il @code{numeratore} e il
address@hidden vengono troncati, eliminando la parte decimale,
+per trasformarli in numeri interi.
+Il vettore @code{risultato} viene dapprima svuotato, e poi viene impostato
+l'elemento @code{risultato["quotient"]} al risultato della divisione
address@hidden / denominatore}, troncato a numero intero
+mediante l'eliminazione dei decimali,
+e viene impostato l'elemento @code{risultato["remainder"]} al
+risultato dell'operazione @samp{numeratore % denominatore}, troncato a
+numero intero allo stesso modo del risultato. Questa funzione @`e
+rivolta principalmente a chi usa numeri interi di lunghezza arbitraria;
+consente di evitare la creazione di numeri in virgola mobile
+di precisione arbitaria usando la address@hidden MPFR
+(@pxref{Interi a precisione arbitraria}).
+
+Questa funzione @`e un'estensione @code{gawk}. Non @`e disponibile in
address@hidden compatibile (@pxref{Opzioni}).
+
address@hidden @code{log(@var{x})}
address@hidden
address@hidden logaritmo
+Restituisce il logaritmo naturale di @var{x}, se @var{x} @`e positivo;
+altrimenti, restituisce @code{NaN} (``not a number'') sui sistemi che
+implementano lo standard IEEE 754.
+Inoltre, @command{gawk} stampa un messaggio di avvertimento qualora @code{x}
+sia negativo.
+
address@hidden @code{rand()}
address@hidden
address@hidden numeri casuali, funzioni @code{rand()}/@code{srand()}
+Restituisce un numero casuale. I valori di @code{rand()} sono
+uniformemente distribuiti tra zero e uno.
+Il valore potrebbe essere zero ma non @`e mai address@hidden versione C di
address@hidden()} in molti sistemi Unix
+produce notoriamente delle sequenze piuttosto mediocri di numeri casuali.
+Tuttavia, non @`e prescritto che un'implementazione di @command{awk}
+debba usare la funzione @code{rand()} del linguaggio C per implementare
+la versione @command{awk} di @code{rand()}.
+In effetti, @command{gawk} usa, per generare numeri casuali,
+la funzione @code{random()} di BSD, che @`e
+notevolmente migliore di @code{rand()}}
+
+Spesso servono dei numeri casuali interi invece che frazionari.
+La seguente funzione definita dall'utente address@hidden essere usata per
ottenere
+un numero casuale non negativo inferiore a @var{n}:
+
address@hidden
+function randint(n)
address@hidden
+ return int(n * rand())
address@hidden
address@hidden example
+
address@hidden
+La moltiplicazione produce un numero casuale maggiore o uguale a zero e
+minore di @code{n}. Tramite @code{int()}, questo risultato diventa
+un intero tra zero e @code{n} @minus{} 1, estremi inclusi.
+
+Il seguente esempio usa una funzione simile per generate interi casuali
+fra uno e @var{n}. Il programma stampa un numero casuale per
+ogni record in input:
+
address@hidden
+# funzione per simulare un tiro di dado.
+function roll(n) @{ return 1 + int(rand() * n) @}
+
+# Tira 3 dadi a sei facce e
+# stampa il numero di punti.
address@hidden
+ printf("%d punteggio\n", roll(6) + roll(6) + roll(6))
address@hidden
address@hidden example
+
address@hidden inizializzazione generazione di numeri casuali
address@hidden numeri casuali, inizializzazione generazione di
address@hidden numeri casuali, seme di
address@hidden ATTENZIONE
+Nella maggior parte delle implementazioni di @command{awk}, compreso
address@hidden,
address@hidden()} inizia a generare numeri casuali partendo sempre
+dallo stesso numero, o @dfn{seme}, per ogni invocazione di
address@hidden@address@hidden
+usa un seme differente ogni volta.} @`E per questo motivo che
+un programma genera sempre gli stessi risultati ogni volta che lo si esegue.
+I numeri sono casuali all'interno di una singola esecuzione di @command{awk}
+ma "prevedibili" in ogni successiva esecuzione.
address@hidden torna utile in fase di test, ma se si desidera che
+un programma generi sequenze differenti di numeri casuali ogni volta
+che @`e chiamato, occorre impostare il seme a un valore che cambi
+per ogni esecuzione. Per fare questo, @`e prevista la funzione @code{srand()}.
address@hidden quotation
+
address@hidden @code{sin(@var{x})}
address@hidden
address@hidden seno
+Restituisce il seno di @var{x}, con @var{x} espresso in radianti.
+
address@hidden @code{sqrt(@var{x})}
address@hidden
address@hidden radice quadrata
+Restituisce la radice quadrata positiva di @var{x}.
address@hidden stampa un messaggio di avvertimento
+se @var{x} @`e un numero negativo. Quindi, @code{sqrt(4)} vale 2.
+
address@hidden @code{srand(address@hidden@code{)}
address@hidden
+Imposta al valore @var{x} il numero di partenza, o seme,
+utilizzato per generare numeri casuali.
+
+Ogni seme genera una sequenza particolare di numeri address@hidden
+numeri casuali generati da un computer non sono veramente casuali.
+Tecnicamente sono conosciuti come numeri @dfn{pseudo-casuali}. address@hidden
vuol dire
+che, anche se i numeri in una sequenza sembrano casuali, @`e possibile
+in address@hidden generare la stessa sequenza di numeri casuali address@hidden
e address@hidden volte.}
+Quindi, impostando il seme allo stesso valore una seconda volta,
+viene prodotta ancora la stessa sequenza di numeri casuali.
+
address@hidden ATTENZIONE
+Differenti implementazioni di @command{awk} usano internamente differenti
+generatori di numeri casuali. Non si deve dare per scontato che lo stesso
+programma @command{awk}
+generi la stessa serie di numeri casuali se viene eseguito da differenti
+versioni di @command{awk}.
address@hidden quotation
+
+Se si omette l'argomento @var{x}, scrivendo @samp{srand()}, viene usato
+come seme la data e ora corrente. @`E questo il modo per ottenere numeri
+casuali che sono veramente imprevedibili.
+
+Il valore restituito da @code{srand()} @`e quello del seme precedente.
+Questo per facilitare il monitoraggio dei semi, nel caso occorra riprodurre
+in maniera coerente delle sequenze di numeri casuali.
+
+POSIX non specifica quale debba essere il seme iniziale, che quindi varia
+a seconda delle implementazioni @command{awk}.
address@hidden table
+
address@hidden Funzioni per stringhe
address@hidden Funzioni di manipolazione di stringhe
address@hidden funzioni di manipolazione di stringhe
+
+Le funzioni in questa @value{SECTION} leggono o modificano il testo di
+una o address@hidden stringhe.
+
address@hidden implementa la localizzazione
+(@pxref{Localizzazioni}) ed effettua
+ogni manipolazione di stringhe trattando ogni singolo @emph{carattere}, non
+ogni singolo @emph{byte}.
+Questa distinzione @`e particolarmente importante da comprendere per
+quelle localizzazioni in cui un singolo carattere address@hidden essere
rappresentato
+da address@hidden di un byte.
+Quindi, per esempio, la funzione @code{length()} restituisce il numero di
+caratteri in una stringa, e non il numero di byte usato per rappresentare quei
+caratteri. Allo stesso modo, @code{index()} restituisce indici di caratteri, e
+non indici di byte.
+
address@hidden ATTENZIONE
+Un certo numero di funzioni riguarda indici all'interno di stringhe. Per
+queste funzioni, il primo carattere di una stringa @`e alla posizione
+(all'indice) uno. Questo comportamento @`e differente da quello del C e dei
+linguaggi che da esso discendono, nei quali il primo carattere @`e alla
posizione
+zero. @`E importante ricordarlo quando si fanno calcoli sugli indici, in
+particolare se si ha address@hidden con il linguaggio C.
address@hidden quotation
+
+Nella lista seguente, i parametri facoltativi sono racchiusi tra parentesi
address@hidden ([ ]).}
+Parecchie funzioni operano sostituzioni in una stringa; la spiegazione
+completa di address@hidden @`e contenuta nella descrizione della funzione
@code{sub()},
+che si trova quasi alla fine di questa lista, ordinata alfabeticamente.
+
+Le funzioni specifiche di @command{gawk} sono contrassegnate col simbolo
+del cancelletto (@samp{#}). Tali funzioni non sono disponibili in
address@hidden
+compatibile (@pxref{Opzioni}):
+
+
address@hidden
+* Dettagli ostici:: address@hidden di quel che si vorrebbe sapere su
@samp{\}
+ e @samp{&} con @code{sub()}, @code{gsub()}, e
+ @code{gensub()}.
address@hidden menu
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{asort(address@hidden address@hidden,} @var{destinazione}
address@hidden,} @var{come} ] address@hidden) #}
address@hidden @code{asorti(address@hidden address@hidden,} @var{destinazione}
address@hidden,} @var{come} ] address@hidden) #}
address@hidden
address@hidden vettori, ordinamento dei
address@hidden ordinamento di vettori
address@hidden vettori, determinare il numero degli elementi
address@hidden
address@hidden ordinamento vettori per indici
address@hidden vettori, ordinamento per indici
address@hidden indici di vettori, ordinamento per
+Queste due funzioni sono abbastanza simili, e quindi sono descritte
+insieme.
+
address@hidden NOTA
+La seguente descrizione ignora il terzo argomento, @var{come}, perch@'e
+richiede la conoscenza di address@hidden di cui non si @`e ancora parlato. Per
+questo motivo la seguente trattazione @`e volutamente semplificata. (In
seguito
+l'argomento address@hidden trattato in maniera address@hidden esauriente; si
veda @ref{Funzioni di
+ordinamento di vettori} per la descrizione completa.)
address@hidden quotation
+
+Entrambe le funzioni restituiscono il numero di elementi nel vettore
@var{sorgente}.
+Con @command{asort()}, @command{gawk} ordina i valori di @var{sorgente}
+e rimpiazza gli indici dei valori ordinati di @var{sorgente} con
+numeri interi sequenziali, a partire da uno. Se si specifica il vettore
+opzionale @var{destinazione},
address@hidden @`e copiato in @var{destinazione}. @var{destinazione}
+viene quindi ordinato, lasciando immodificati gli indici di @var{sorgente}.
+
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
+Nel confronto tra stringhe, la variabile @code{IGNORECASE} influenza
+l'ordinamento
+(@pxref{Funzioni di ordinamento di vettori}). Se il vettore
address@hidden contiene sottovettori come valori
+(@pxref{Vettori di vettori}), questi saranno alla fine, dopo tutti i valori
+scalari.
+I sottovettori @emph{non} vengono ordinati ricorsivamente.
+
+Per esempio, se i contenuti del vettore @code{a} sono i seguenti:
+
address@hidden
+a["ultimo"] = "de"
+a["primo"] = "sac"
+a["mediano"] = "cul"
address@hidden example
+
address@hidden
+Una chiamata a @code{asort()}:
+
address@hidden
+asort(a)
address@hidden example
+
address@hidden
+genera i seguenti contenuti di @code{a}:
+
address@hidden
+a[1] = "cul"
+a[2] = "de"
+a[3] = "sac"
address@hidden example
+
+La funzione @code{asorti()} si comporta in maniera simile ad @code{asort()};
+tuttavia l'ordinamento avviene in base agli @emph{indici}, e non in base ai
+valori. Quindi, nell'esempio seguente, a partire dallo stesso insieme iniziale
+di indici e valori nel vettore @code{a}, la chiamata di @samp{asorti(a)}
+produrrebbe:
+
address@hidden
+a[1] = "mediano"
+a[2] = "primo"
+a[3] = "ultimo"
address@hidden example
+
address@hidden @code{gensub(@var{regexp}, @var{rimpiazzo}, @var{come}}
address@hidden, @address@hidden) #}
address@hidden
address@hidden cercare e rimpiazzare in stringhe
address@hidden sostituzione in stringa
+Ricerca nella stringa @var{obiettivo} delle corrispondenze
+all'espressione regolare @var{regexp}.
+Se @var{come} @`e una stringa che inizia
+con @samp{g} o @samp{G} (abbreviazione di ``global''), sostituisce
+ogni occorrenza di @var{regexp} con la stringa
address@hidden Altrimenti, @var{come} @`e visto come un numero che indica
+quale corrispondenza di @var{regexp} va rimpiazzata. Se non si specifica
+il nome dell'@var{obiettivo}, si
+opera su @code{$0}. La funzione restituisce come risultato la stringa
+modificata, e la stringa originale di partenza @emph{non} viene modificata.
+
address@hidden()} @`e una funzione generale di sostituzione. Mira a fornire
address@hidden address@hidden rispetto alle funzioni standard @code{sub()} e
address@hidden()}.
+
address@hidden()} prevede una address@hidden ulteriore, non disponibile in
address@hidden()} o @code{gsub()}: la address@hidden di specificare componenti
di
+una @dfn{regexp} nel testo da sostituire. Questo @`e fatto utilizzando delle
+parentesi nella @dfn{regexp} per designare i componenti, e quindi inserendo
address@hidden@var{N}} nel testo di rimpiazzo, dove @var{N} @`e una cifra da 1
a 9.
+Per esempio:
+
address@hidden
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{a = "abc def"}
+> @kbd{b = gensub(/(.+) (.+)/, "\\2 \\1", "g", a)}
+> @kbd{print b}
+> @address@hidden'}
address@hidden def abc
address@hidden example
+
address@hidden
+Come con @code{sub()}, occorre battere due barre inverse, per ottenerne
+una come componente della stringa.
+Nel testo di rimpiazzo, la sequenza @samp{\0} rappresenta l'intero testo
+corrispondente, e lo stesso vale per
+il carattere @samp{&}.
+
+Il seguente esempio mostra come @`e possibile usare il terzo argomento
+per controllare quale corrispondenza
+della @dfn{regexp} sia da modificare:
+
address@hidden
+$ @kbd{echo a b c a b c |}
+> @kbd{gawk '@{ print gensub(/a/, "AA", 2) @}'}
address@hidden a b c AA b c
address@hidden example
+
+In questo caso, @code{$0} @`e la stringa obiettivo di default.
address@hidden()} restituisce la nuova stringa come risultato, e questa
address@hidden passata direttamente a @code{print} per essere stampata.
+
address@hidden @cindex avvertimenti automatici
address@hidden @cindex automatici, avvertimenti
+Se l'argomento @var{come} @`e una stringa che non inizia con @samp{g} o
address@hidden, o se @`e un numero minore o uguale a zero, si effettua solo una
+sostituzione. Se @var{come} @`e zero, @command{gawk} emette
+un messaggio di avvertimento.
+
+Se @var{regexp} non viene trovata in @var{obiettivo}, il valore
+restituito da @code{gensub()}
address@hidden il valore originale e non modificato di @var{obiettivo}.
+
address@hidden @code{gsub(@var{regexp}, @var{rimpiazzo}} address@hidden,
@address@hidden)}
address@hidden
+Ricerca in @var{obiettivo}
address@hidden le sottostringhe corrispondenti al criterio di ricerca, le
address@hidden lunghe possibili partendo da sinistra, @emph{non sovrapposte tra
loro},
+e le sostituisce con @var{rimpiazzo}.
+La lettera @samp{g} in @code{gsub()} significa
+``global'', e richiede di sostituire dappertutto. Per esempio:
+
address@hidden
address@hidden gsub(/Inghilterra/, "Regno Unito"); print @}
address@hidden example
+
address@hidden
+sostituisce tutte le occorrenze della stringa @samp{Inghilterra} con
address@hidden Unito} in tutti i record in input.
+
+La funzione @code{gsub()} restituisce il numero di sostituzioni effettuate.
+Se la variabile da cercare e modificare (@var{obiettivo}) @`e omessa,
+viene usato l'intero record in input.
+Come in @code{sub()}, i caratteri @samp{&} e @samp{\} sono speciali,
+e il terzo argomento dev'essere modificabile.
+
address@hidden @code{index(@var{dove}, @var{cosa})}
address@hidden
address@hidden ricerca in stringhe
address@hidden trovare sottostringhe in una stringa
+Ricerca nella stringa @var{dove} la prima occorrenza della stringa @var{cosa},
+e restituisce la posizione in caratteri dell'inizio di quest'occorrenza nella
+stringa @var{dove}. Si consideri il seguente esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print index("noccioline", "oli") @}'}
address@hidden 6
address@hidden example
+
address@hidden
+Se @var{cosa} non viene trovato, @code{index()} restituisce zero.
+
address@hidden angolo buio, @dfn{regexp} come secondo argomento di
@code{index()}
+In BWK @command{awk} e @command{gawk},
address@hidden un errore fatale usare una costante @dfn{regexp} per @var{cosa}.
+Altre implementazioni lo consentono, considerando semplicemente
+la costante @dfn{regexp} come un'espressione che significa
address@hidden ~ /@dfn{regexp}/}. @value{DARKCORNER}
+
address@hidden @code{length(address@hidden@code{)}
address@hidden
address@hidden stringa, lunghezza di una
address@hidden lunghezza di una stringa
+Restituisce il numero di caratteri in @var{stringa}. Se
address@hidden @`e un numero, viene restituita la lunghezza della stringa
+di cifre che rappresenta quel numero. Per esempio, @code{length("abcde")} @`e
+cinque.
+Invece, @code{length(15 * 35)} restituisce tre. In questo esempio,
address@hidden
address@hidden @cdot 35 = 525},
address@hidden iftex
address@hidden
address@hidden
+15 * 35 = 525,
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+15 ⋅ 35 = 525,
address@hidden docbook
+e 525 @`e quindi convertito alla stringa @code{"525"}, che @`e composta da
+tre caratteri.
+
address@hidden lunghezza di un record in input
address@hidden record in input, lunghezza di un
+Se non si specifica alcun argomento, @code{length()} restituisce la
+lunghezza di @code{$0}.
+
address@hidden @cindex historical features
address@hidden address@hidden, funzione @code{length()}
address@hidden POSIX @command{awk}, funzione @code{length()} e
address@hidden NOTA
+In alcune delle prime versioni di @command{awk}, la funzione @code{length()}
+poteva essere richiamata senza alcuna parentesi. Farlo @`e considerata
+una cattiva abitudine, sebbene il POSIX standard 2008 lo consenta
esplicitamente,
+per address@hidden con la vecchia prassi. Per garantire la massima
address@hidden ai programmi, @`e meglio mettere sempre le parentesi.
address@hidden quotation
+
address@hidden angolo buio, funzione @code{length()}
+Se @code{length()} @`e chiamata con una variabile che non @`e stata usata,
address@hidden considera la variabile come uno scalare. Altre
+implementazioni di @command{awk} non assegnano nessun tipo alla variabile.
address@hidden
+Si consideri:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print length(x) ; x[1] = 1 @}'}
address@hidden 0
address@hidden gawk: riga com.:1: fatale: tentativo di usare
address@hidden scalare 'x' come vettore
+
+$ @kbd{nawk 'BEGIN @{ print length(x) ; x[1] = 1 @}'}
address@hidden 0
address@hidden example
+
address@hidden
+Se @option{--lint} @`e
+stato specificato sulla riga di comando, @command{gawk} emette un
+avvertimento a questo riguardo.
+
address@hidden estensioni comuni, @code{length()} applicato a un vettore
address@hidden comuni, address@hidden @code{length()} applicato a un vettore
address@hidden differenze tra @command{gawk} e @command{awk}
address@hidden numero di elementi di un vettore
address@hidden vettore, determinare il numero degli elementi
+In @command{gawk} e in parecchie altre implementazioni @command{awk},
+se l'argomento @`e un vettore, la funzione @code{length()} restituisce il
numero
+di elementi nel vettore. @value{COMMONEXT}
address@hidden @`e meno utile di quel che sembra a prima vista, in quanto
+non @`e affatto detto che il vettore abbia come indici i numeri da 1 al
+numero di elementi che contiene.
+Se @option{--lint} @`e
+stato specificato sulla riga di comando,
+(@pxref{Opzioni}),
address@hidden avvisa che l'uso di un vettore come argomento non
address@hidden portabile.
+Se si specifica l'opzione @option{--posix}, l'uso di un vettore come
+argomento genera un errore fatale
address@hidden
+(@pxrefil{Vettori}).
address@hidden iftex
address@hidden
+(@pxref{Vettori}).
address@hidden ifnottex
+
address@hidden @code{match(@var{stringa}, @var{regexp}} address@hidden,
@address@hidden)}
address@hidden
address@hidden stringa, ricercare espressioni regolari in una
address@hidden ricerca @dfn{regexp} in stringhe
+Ricerca in @var{stringa} la
+sottostringa address@hidden lunga, a partire da sinistra, che corrisponde
+all'espressione regolare @var{regexp} e restituisce la posizione
+del carattere (indice) con cui inizia la sottostringa (uno, se
+la corrispondenza parte dall'inizio di @var{stringa}). Se non viene
+trovata alcuna corrispondenza, restituisce zero.
+
+L'argomento @var{regexp} address@hidden essere sia una costante @dfn{regexp}
+(@code{/address@hidden@code{/}) che una costante stringa
(@code{"address@hidden@code{"}).
+In quest'ultimo caso, la stringa @`e trattata come una @dfn{regexp}
+per la quale cercare una corrispondenza.
address@hidden regolari calcolate} per una
+spiegazione sulla differenza tra le due forme e sulle loro
+implicazioni riguardo al modo per scrivere correttamente un programma.
+
+L'ordine dei primi due argomenti @`e l'opposto di molte altre funzioni che
+trattano stringhe e che hanno a che fare con espressioni regolari, come
address@hidden()} e @code{gsub()}. Potrebbe essere di aiuto ricordare che
+per @code{match()}, l'ordine @`e lo stesso che per l'operatore @samp{~} :
address@hidden@var{stringa} ~ @var{regexp}}.
+
address@hidden @code{RSTART}, variabile, funzione @code{match()} e
address@hidden variabile @code{RSTART}, funzione @code{match()} e
address@hidden @code{RLENGTH}, variabile, funzione @code{match()} e
address@hidden variabile @code{RLENGTH}, funzione @code{match()} e
address@hidden funzione @code{match()}, variabili @code{RSTART}/@code{RLENGTH}
address@hidden @code{match()}, funzione, variabili @code{RSTART}/@code{RLENGTH}
+La funzione @code{match()} imposta la variabile predefinita @code{RSTART}
+all'indice.
+Imposta anche la variabile predefinita @code{RLENGTH} alla
+lunghezza in caratteri della sottostringa individuata. Se non viene
+trovata alcuna corrispondenza, @code{RSTART} @`e impostata a zero, e
address@hidden a @minus{}1.
+
+Per esempio:
+
address@hidden
address@hidden file eg/misc/findpat.awk
address@hidden
+ if ($1 == "TROVA")
+ regexp = $2
+ else @{
+ dove = match($0, regexp)
+ if (dove != 0)
+ print "Corrispondenza di", regexp, "alla posiz.", \
+ dove, "in", $0
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Questo programma ricerca delle righe che corrispondono all'espressione
+regolare contenuta nella variabile
address@hidden Quest'espressione regolare address@hidden essere modificata.
Se la
+prima parola in una riga @`e @samp{TROVA}, @code{regexp} diventa la
+seconda parola su quella riga. Quindi, dato:
+
address@hidden
address@hidden file eg/misc/findpat.data
+TROVA or+e
+Il mio programma corre
+ma non troppo velocemente
+TROVA Melvin
+JF+KM
+Questa riga appartiene a Reality Engineering Co.
+Melvin @`e passato da qui.
address@hidden endfile
address@hidden example
+
address@hidden
address@hidden stampa:
+
address@hidden
+Corrispondenza di or+e alla posiz. 19 in Il mio programma corre
+Corrispondenza di Melvin alla posiz. 1 in Melvin @`e passato da qui.
address@hidden example
+
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{match()}
+Se @var{vettore} esiste address@hidden, viene cancellato, e quindi l'elemento
numero
+zero di @var{vettore} @`e impostato all'intera parte di @var{stringa}
+individuata da @var{regexp}. Se @var{regexp} contiene parentesi,
+gli elementi aventi per indici numeri interi in @var{vettore} sono
+impostati per contenere ognuno la parte di @var{stringa} individuata dalla
+corrispondente sottoespressione delimitata da parentesi.
+Per esempio:
+
address@hidden
+$ @kbd{echo pippoooopaperpluttttttt |}
+> @kbd{gawk '@{ match($0, /(pippo+).+(plut*)/, vett)}
+> @kbd{print vett[1], vett[2] @}'}
address@hidden pippoooo pluttttttt
address@hidden example
+
+Inoltre,
+sono disponibili indici multidimensionali che contengono
+la posizione di partenza e la lunghezza di ogni sottoespressione
+individuata:
+
address@hidden
+$ @kbd{echo pippoooopaperpluttttttt |}
+> @kbd{gawk '@{ match($0, /(pippo+).+(plut*)/, vett)}
+> @kbd{print vett[1], vett[2]}
+> @kbd{print vett[1, "start"], vett[1, "length"]}
+> @kbd{print vett[2, "start"], vett[2, "length"]}
+> @address@hidden'}
address@hidden pippoooo pluttttttt
address@hidden 1 8
address@hidden 14 10
address@hidden example
+
+Possono non esserci indici che individuino inizio e posizione
+per ogni sottoespressione
+fra parentesi, perch@'e non tutte potrebbero aver individuato del testo;
+quindi, andrebbero esaminati usando l'operatore @code{in}
+(@pxref{Visitare elementi}).
+
address@hidden risoluzione di problemi, funzione @code{match()}
address@hidden problemi, risoluzione di, funzione @code{match()}
+L'argomento @var{vettore} di @code{match()} @`e un'estensione
address@hidden In address@hidden compatibile
+(@pxref{Opzioni}),
+l'impiego di un terzo argomento causa un errore fatale.
+
address@hidden @code{patsplit(@var{stringa}, @var{vettore}} address@hidden,
@var{regexpdelim}} address@hidden, @var{separatori}} ] address@hidden) #}
address@hidden
address@hidden dividere in un vettore una stringa
address@hidden creare un vettore da una stringa
+Divide
address@hidden in parti definite da @var{regexpdelim}
+e memorizza i pezzi in @var{vettore} e le stringhe di separazione nel
+vettore @var{separatori}. Il primo pezzo @`e memorizzato in
address@hidden@var{vettore}[1]}, il secondo pezzo in @address@hidden, e
address@hidden@dotless{i}} via. Il terzo argomento, @var{regexpdelim}, @`e
+una @dfn{regexp} che descrive i campi in @var{stringa} (allo stesso modo in
+cui @code{FPAT} @`e una @dfn{regexp} che descrive i campi nei record
+in input).
address@hidden essere una costante @dfn{regexp} o una stringa.
+Se @var{regexpdelim} @`e omesso, viene usato il valore di @code{FPAT}.
address@hidden()} restituisce il numero di elementi creati.
address@hidden@address@hidden @`e
+la stringa che separa
+l'elemento @address@hidden@var{i}]} e @address@hidden@var{i}+1]}.
+Ogni separatore iniziale address@hidden in @address@hidden
+
+La funzione @code{patsplit()} divide delle stringhe in pezzi in modo
+simile a quello con cui le righe in input vengono divise in campi
+usando @code{FPAT}
+(@pxref{Separazione in base al contenuto}).
+
+Prima di dividere la stringa, @code{patsplit()} cancella ogni elemento che
+fosse eventualmente presente
+nei vettori @var{vettore} e @var{separatori}.
+
address@hidden @code{split(@var{stringa}, @var{vettore}} address@hidden,
@var{separacampo}} address@hidden, @var{separatori}} ] address@hidden)}
address@hidden
+Divide @var{stringa} in pezzi separati da @var{separacampo}
+e memorizza i pezzi in @var{vettore} e le stringhe di separazione nel
+vettore @var{separatori}. Il primo pezzo @`e memorizzato in
address@hidden@var{vettore}[1]}, il secondo pezzo in @address@hidden, e
address@hidden@dotless{i}} via. Il valore della stringa specificata nel terzo
argomento,
address@hidden, @`e una @dfn{regexp} che indica come dividere @var{stringa}
+(analogamente a come @code{FS} address@hidden essere un @dfn{regexp} che
indica dove
+dividere i record in input).
+Se @var{separacampo} @`e omesso, si usa il valore di @code{FS}.
address@hidden()} restituisce il numero di elementi creati.
address@hidden @`e un'estensione @command{gawk}, in cui
address@hidden@address@hidden
address@hidden la stringa che separa @address@hidden@var{i}]} e
address@hidden@address@hidden
+Se @var{separacampo} @`e uno spazio bianco, ogni eventuale spazio bianco
+a inizio stringa viene messo in @address@hidden e ogni
+eventuale spazio bianco a fine stringa viene messo in
address@hidden@address@hidden, dove @var{n} @`e il valore restituito da
address@hidden()} (address@hidden il numero di elementi in @var{vettore}).
+
+La funzione @code{split()} divide le stringhe in pezzi in modo simile
+a quello con cui le righe in input sono divise in campi. Per esempio:
+
address@hidden
+split("cul-de-sac", a, "-", separatori)
address@hidden example
+
address@hidden
address@hidden stringhe, divisione, esempio
+divide la stringa @code{"cul-de-sac"} in tre campi usando @samp{-} come
+separatore. Il vettore @code{a} ha i seguenti contenuti:
+
address@hidden
+a[1] = "cul"
+a[2] = "de"
+a[3] = "sac"
address@hidden example
+
+e imposta il contenuto del vettore @code{separatori} come segue:
+
address@hidden
+seps[1] = "-"
+seps[2] = "-"
address@hidden example
+
address@hidden
+Il valore restituito da questa chiamata a @code{split()} @`e tre.
+
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{split()}
+Come nella divisione in campi dei record in input, quando il valore di
address@hidden @`e @address@hidden" "}}, gli spazi bianchi a inizio e fine
stringa
+vengono ignorati nell'assegnare valori agli elementi di @var{vettore} ma non
nel
+vettore @var{separatori}, e gli elementi sono separati da uno o address@hidden
spazi
+bianchi. Inoltre, come nel caso della divisione dei record in input, se
address@hidden @`e la stringa nulla, ogni singolo carattere nella stringa
+costituisce un elemento del vettore.
address@hidden
+
+Si noti, tuttavia, che @code{RS} non influisce sul comportamento di
address@hidden()}.
+Anche se @samp{RS = ""} fa address@hidden@dotless{i}} che il carattere di
ritorno a capo sia un
+separatore di campo,
+questo non influenza il modo in cui @code{split()} divide le stringhe.
+
address@hidden angolo buio, funzione @code{split()}
+Recenti implementazioni di @command{awk}, incluso @command{gawk},
+consentono che il terzo argomento sia una costante @dfn{regexp}
+(@address@hidden/address@hidden@code{/}})
+o anche una stringa. @value{DARKCORNER}
+Anche lo standard POSIX permette questo.
address@hidden regolari calcolate} per la spiegazione della differenza
+tra l'uso di una costante stringa e l'uso di una costante @dfn{regexp},
+sulle loro implicazioni riguardo a come scrivere correttamente un programma.
+
+Prima di dividere la stringa, @code{split()} cancella ogni elemento
+eventualmente address@hidden presente
+nei vettori @var{vettore} e @var{separatori}.
+
+Se @var{stringa} @`e la stringa nulla, il vettore non ha elementi.
+(Quindi, in questo modo si address@hidden cancellare un intero vettore con una
sola
+istruzione).
address@hidden)
+
+Se in @var{stringa} non viene trovato @var{separacampo} (ma la stringa
+non @`e la stringa nulla),
address@hidden ha solo un elemento. Il valore di quell'elemento @`e la
address@hidden originale.
+
+In address@hidden POSIX (@pxref{Opzioni}), il quarto argomento non @`e
disponibile.
+
address@hidden @code{sprintf(@var{formato}, @var{espressione1}, @dots{})}
address@hidden
address@hidden formattare stringhe
address@hidden stringhe, formattazione
+Restituisce (senza stamparla) la stringa che @code{printf} avrebbe
+stampato con gli stessi argomenti
+(@pxref{Printf}).
+Per esempio:
+
address@hidden
+pival = sprintf("pi = %.2f (approx.)", 22/7)
address@hidden example
+
address@hidden
+assegna la stringa @address@hidden = 3.14 (approx.)}} alla variabile
@code{pival}.
+
address@hidden
address@hidden conversione di una stringa in un numero
address@hidden stringhe, conversione in numeri
address@hidden @code{strtonum(@var{stringa}) #}
+Esamina @var{stringa} e restituisce il suo valore numerico. Se
address@hidden inizia con la cifra @samp{0}, @code{strtonum()} presuppone
+che @var{stringa} sia un numero ottale. Se @var{stringa} inizia con
address@hidden o @samp{0X}, @code{strtonum()} presuppone che @var{stringa} sia
un
+numero esadecimale.
+Per esempio:
+
address@hidden
+$ @kbd{echo 0x11 |}
+> @kbd{gawk '@{ printf "%d\n", strtonum($1) @}'}
address@hidden 17
address@hidden example
+
+Usare la funzione @code{strtonum()} @emph{non} @`e lo stesso che aggiungere
+zero al valore di una stringa;
+la conversione automatica di stringhe in numeri
+si applica solo a dati decimali, non a quelli ottali o
address@hidden nel caso si usi l'opzione
address@hidden, il che non @`e consigliato.
address@hidden non decimali} per ulteriori informazioni.}
+
+Si noti anche che @code{strtonum()} usa il separatore decimale della
+localizzazione corrente per riconoscere i numeri
+(@pxref{Localizzazioni}).
+
address@hidden @code{sub(@var{regexp}, @var{rimpiazzo}} address@hidden,
@address@hidden)}
address@hidden
address@hidden rimpiazzare in una stringa
address@hidden stringa, rimpiazzare in una
+Ricerca in @var{obiettivo}, che @`e visto come una stringa,
+la prima sottostringa address@hidden lunga possibile,
+a partire da sinistra, che corrisponde all'espressione regolare @var{regexp}.
+Modifica l'intera stringa sostituendo il testo individuato con
address@hidden
+La stringa address@hidden@dotless{i}} modificata diventa il nuovo valore di
@var{obiettivo}.
+Restituisce il numero di sostituzioni fatte (zero o uno).
+
+L'argomento @var{regexp} address@hidden essere o una costante @dfn{regexp}
+(@code{/address@hidden@code{/}) o una constante stringa
(@code{"address@hidden@code{"}).
+In quest'ultimo caso, la stringa @`e trattata come una @dfn{regexp}
+da individuare.
address@hidden regolari calcolate} per la spiegazione della differenza tra
+le due forme, delle loro implicazioni riguardo al modo di scrivere
+correttamente un programma.
+
+Questa funzione @`e particolare perch@'e @var{obiettivo} non @`e semplicemente
usato
+per calcolare un valore, e non basta che sia un'espressione qualsiasi:
+dev'essere una variabile, un campo, o un elemento di vettore in cui
address@hidden()} possa memorizzare un valore modificato. Se questo argomento
@`e
+omesso, il comportamento di default @`e
+quello di usare e modificare
address@hidden@footnote{Si noti che questo significa che il record
address@hidden dapprima
+ricostruito, usando il valore di @code{OFS} se qualche campo @`e stato
cambiato,
+e che i campi saranno aggiornati dopo la sostituzione, anche se l'operazione in
+s@'e non cambia il record (@`e una ``no-op'') come @samp{sub(/^/, "")}.} Per
+esempio:
+
address@hidden
+str = "acqua, acqua dappertutto"
+sub(/cqu/, "vari", str)
address@hidden example
+
address@hidden
+modifica @code{stringa} facendola divenire
address@hidden@samp{avaria, acqua dappertutto}},
+rimpiazzando l'occorrenza address@hidden lunga,
+a partire da sinistra, di @samp{cqu} con @samp{vari}.
+
+Se il carattere speciale @samp{&} compare in @var{rimpiazzo}, designa
+l'esatta sottostringa individuata da @var{regexp}. (Se
address@hidden address@hidden individuare address@hidden di una stringa, questa
sottostringa
address@hidden assumere valori diversi.) Per esempio:
+
address@hidden
address@hidden sub(/candidato/, "& e sua moglie"); print @}
address@hidden example
+
address@hidden
+cambia la prima occorrenza di @samp{candidato} a @samp{candidato
+e sua moglie} in ogni riga in input.
+Ecco un altro esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{str = "daabaaa"}
+> @kbd{sub(/a+/, "C&C", str)}
+> @kbd{print str}
+> @address@hidden'}
address@hidden dCaaCbaaa
address@hidden example
+
address@hidden
+questo mostra come @samp{&} possa rappresentare una stringa variabile
+e illustra anche la regola
+``a partire da sinistra, la address@hidden lunga'' nell'individuazione di
@dfn{regexp}
+(@address@hidden lungo da sinistra}).
+
+L'effetto di questo carattere speciale (@samp{&}) address@hidden essere
neutralizzato
+anteponendogli una barra inversa nella stringa. Come al solito, per
+inserire una barra inversa nella
+stringa, occorre scrivere due barre inverse. Quindi, occorre scrivere
address@hidden&} in una costante stringa per includere un carattere @samp{&}
+nel rimpiazzo.
+Per esempio, quanto segue mostra come rimpiazzare il primo @samp{|} su
+ogni riga con un @samp{&}:
+
address@hidden
address@hidden sub(/\|/, "\\&"); print @}
address@hidden example
+
address@hidden @code{sub()}, funzione, argomenti di
address@hidden funzione @code{sub()}, argomenti di
address@hidden @code{gsub()}, funzione, argomenti di
address@hidden funzione @code{gsub()}, argomenti di
+Come address@hidden accennato, il terzo argomento di @code{sub()} dev'essere
+una variabile, un campo, o un elemento di vettore.
+Alcune versioni di @command{awk} accettano come terzo argomento
+un'espressione che non @`e un @dfn{lvalue}. In tal caso, @code{sub()}
+cerca ugualmente l'espressione e restituisce zero o uno, ma il risultato
+della sostituzione (se ce n'@`e uno) viene scartato perch@'e non c'@`e un posto
+dove memorizzarlo. Tali versioni di @command{awk} accettano espressioni
+come le seguente:
+
address@hidden
+sub(/USA/, "Stati Uniti", "gli USA e il Canada")
address@hidden example
+
address@hidden
address@hidden risoluzione di problemi, funzioni @code{gsub()}/@code{sub()}
address@hidden problemi, risoluzione di, funzioni @code{gsub()}/@code{sub()}
+Per address@hidden storica, @command{gawk} accetta un tale codice erroneo.
+Tuttavia, l'uso di qualsiasi altra espressione non modificabile
+come terzo parametro causa un errore fatale, e il programma
+non viene portato a termine.
+
+Infine, se la @var{regexp} non @`e una costante @dfn{regexp}, @`e convertita
+in una stringa, e quindi il valore di quella stringa @`e trattato come
+la @dfn{regexp} da individuare.
+
address@hidden @code{substr(@var{stringa}, @var{inizio}} address@hidden,
@var{lunghezza}} address@hidden)}
address@hidden
address@hidden sottostringa
+Restituisce una sottostringa di @var{stringa} lunga @var{lunghezza} caratteri,
+iniziando dal carattere numero @var{inizio}. Il primo carattere di una
+stringa @`e il carattere numero address@hidden @`e differente da
+C e C++, in cui il primo carattere ha il numero zero.}
+Per esempio, @code{substr("Washington", 5, 3)} restituisce @code{"ing"}.
+
+Se @var{lunghezza} non @`e presente, @code{substr()} restituisce l'intero
+suffisso di
address@hidden a partire dal carattere numero @var{inizio}. Per esempio,
address@hidden("Washington", 5)} restituisce @code{"ington"}. L'intero
+suffisso @`e restituito anche
+se @var{lunghezza} @`e maggiore del numero di caratteri disponibili
+nella stringa, a partire dal carattere @var{inizio}.
+
address@hidden Brian Kernighan, @command{awk} di
+Se @var{inizio} @`e minore di uno, @code{substr()} lo tratta come se
+fosse uno. (POSIX non specifica cosa fare in questo caso:
+BWK @command{awk} si comporta address@hidden@dotless{i}}, e quindi
@command{gawk} fa lo stesso.)
+Se @var{inizio} @`e maggiore del numero di caratteri
+nella stringa, @code{substr()} restituisce la stringa nulla.
+Analogamente, se @var{lunghezza} @`e presente ma minore o uguale a zero,
+viene restituita la stringa nulla.
+
address@hidden risoluzione di problemi, funzione @code{substr()}
address@hidden problemi, risoluzione di, funzione @code{substr()}
+La stringa restituita da @code{substr()} @emph{non address@hidden essere
+assegnata. Quindi, @`e un errore tentare di modificare una porzione di
+una stringa, come si vede nel seguente esempio:
+
address@hidden
+stringa = "abcdef"
+# tentare di ottenere "abCDEf", non @`e possibile
+substr(stringa, 3, 3) = "CDE"
address@hidden example
+
address@hidden
address@hidden anche un errore usare @code{substr()} come terzo argomento
+di @code{sub()} o @code{gsub()}:
+
address@hidden
+gsub(/xyz/, "pdq", substr($0, 5, 20)) # SBAGLIATO
address@hidden example
+
address@hidden address@hidden, funzione @code{substr()}
+(Alcune versioni commerciali di @command{awk} consentono un tale uso di
address@hidden()}, ma un tale codice non @`e portabile.)
+
+Se si devono sostituire pezzi di una stringa,
+si combini @code{substr()}
+con una concatenazione di stringa, nel modo seguente:
+
address@hidden
+stringa = "abcdef"
address@hidden
+stringa = substr(stringa, 1, 2) "CDE" substr(stringa, 6)
address@hidden example
+
address@hidden maiuscolo/minuscolo, conversione da/a
address@hidden stringhe, convertire maiuscolo/minuscolo
address@hidden @code{tolower(@var{stringa})}
address@hidden
address@hidden convertire stringa in minuscolo
+Restituisce una copia di @var{stringa}, con ogni carattere maiuscolo
+nella stringa rimpiazzato dal suo corrispondente carattere minuscolo.
+I caratteri non alfabetici non vengono modificati. Per esempio,
address@hidden("MaIuScOlO MiNuScOlO 123")} restituisce
address@hidden"maiuscolo minuscolo 123"}.
+
address@hidden @code{toupper(@var{stringa})}
address@hidden
address@hidden convertire stringa in maiuscolo
+Restituisce una copia di @var{stringa}, con ogni carattere minuscolo
+nella stringa rimpiazzato dal suo corrispondente carattere maiuscolo.
+I caratteri non alfabetici non vengono modificati. Per esempio,
address@hidden("MaIuScOlO MiNuScOlO 123")} restituisce
address@hidden"MAIUSCOLO MINUSCOLO 123"}.
address@hidden table
+
address@hidden sidebar, Individuare la stringa nulla
address@hidden
address@hidden
+<sidebar><title>Individuare la stringa nulla</title>
address@hidden docbook
+
address@hidden individuare la stringa nulla
address@hidden stringa nulla, individuare la
address@hidden @code{*} (asterisco), operatore @code{*}, individuare la stringa
nulla
address@hidden asterisco (@code{*}), operatore @code{*}, individuare la stringa
nulla
+
+In @command{awk}, l'operatore @samp{*} address@hidden individuare la stringa
nulla.
+Questo @`e particolarmente importante per le funzioni @code{sub()},
address@hidden()} e @code{gensub()}. Per esempio:
+
address@hidden
+$ @kbd{echo abc | awk '@{ gsub(/m*/, "X"); print @}'}
address@hidden XaXbXcX
address@hidden example
+
address@hidden
+Sebbene questo sia abbastanza sensato, address@hidden suscitare una certa
sorpresa.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Individuare la stringa nulla}
+
+
address@hidden individuare la stringa nulla
address@hidden stringa nulla, individuare la
address@hidden @code{*} (asterisco), operatore @code{*}, individuare la stringa
nulla
address@hidden asterisco (@code{*}), operatore @code{*}, individuare la stringa
nulla
+
+In @command{awk}, l'operatore @samp{*} address@hidden individuare la stringa
nulla.
+Questo @`e particolarmente importante per le funzioni @code{sub()},
address@hidden()} e @code{gensub()}. Per esempio:
+
address@hidden
+$ @kbd{echo abc | awk '@{ gsub(/m*/, "X"); print @}'}
address@hidden XaXbXcX
address@hidden example
+
address@hidden
+Sebbene questo sia abbastanza sensato, address@hidden suscitare una certa
sorpresa.
address@hidden cartouche
address@hidden ifnotdocbook
+
+
address@hidden Dettagli ostici
address@hidden Ulteriori dettagli su @samp{\} e @samp{&} con @code{sub()},
@code{gsub()} e @code{gensub()}
+
address@hidden protezione caratteri nelle funzioni
@code{gsub()}/@code{gensub()}/@code{sub()}
address@hidden funzione @code{sub()}, protezione caratteri
address@hidden @code{sub()}, funzione, protezione caratteri
address@hidden funzione @code{gsub()}, protezione caratteri
address@hidden @code{gsub()}, funzione, protezione caratteri
address@hidden funzione @code{gensub()} (@command{gawk}), protezione caratteri
address@hidden @code{gensub()}, funzione (@command{gawk}), protezione caratteri
address@hidden @code{\} (barra inversa),
@code{gsub()}/@code{gensub()}/@code{sub()} funzioni e
address@hidden barra inversa (@code{\}),
@code{gsub()}/@code{gensub()}/@code{sub()} funzioni e
address@hidden @code{&} (e commerciale), funzioni
@code{gsub()}/@code{gensub()}/@code{sub()} e
address@hidden e commerciale (@code{&}), funzioni
@code{gsub()}/@code{gensub()}/@code{sub()} e
+
address@hidden ATTENZIONE
+Si dice che questa sottosezione possa causare dei mal di testa.
+In prima lettura address@hidden essere benissimo saltata.
address@hidden quotation
+
+Quando si usa @code{sub()}, @code{gsub()} o @code{gensub()}, e si
+desidera includere delle
+barre inverse e delle "e commerciali" (@code{&}) nel testo da sostituire
address@hidden necessario ricordare che ci sono parecchi livelli di
address@hidden caratteri} in gioco.
+
+Anzitutto, vi @`e il livello @dfn{lessicale}, quello in cui @command{awk}
+legge un programma e ne costruisce una copia interna da eseguire.
+Poi c'@`e il momento dell'esecuzione, quello in cui @command{awk}
+esamina effettivamente la stringa da sostituire, per determinare cosa
+fare.
+
address@hidden Brian Kernighan, @command{awk} di
+In entrambi i livelli, @command{awk} ricerca un dato insieme di caratteri
+che possono venire dopo una
+barra inversa. A livello lessicale, cerca le sequenze di protezione
+elencate in @ref{Sequenze di protezione}.
+Quindi, per ogni @samp{\} che @command{awk} elabora al momento
+dell'esecuzione, occorre immetterne due a livello lessicale.
+Quando un carattere che non ha address@hidden di una sequenza di protezione
+segue una @samp{\}, sia BWK @command{awk} che @command{gawk} semplicemente
+rimuovono la @samp{\} stessa e
+mettono il carattere seguente nella stringa. Quindi, per esempio,
address@hidden"a\qb"} @`e trattato come se si fosse scritto @code{"aqb"}.
+
+Al momento dell'esecuzione, le varie funzioni gestiscono sequenze di
address@hidden e @samp{&} in maniera differente. La situazione @`e (purtroppo)
+piuttosto complessa.
+Storicamente, le funzioni @code{sub()} e @code{gsub()} trattavano la
+sequenza di due caratteri @samp{\&} in maniera speciale; questa sequenza
+era rimpiazzata nel testo
+generato da un singolo carattere @samp{&}. Ogni altra @samp{\} contenuta
+nella stringa @var{rimpiazzo} che non era posta prima di una @samp{&} era
+lasciata passare senza modifiche.
+Questo @`e illustrato nella @ref{table-sub-escapes}.
+
address@hidden Thank to Karl Berry for help with the TeX stuff.
address@hidden Tabella,table-sub-escapes
address@hidden storica delle sequenze di protezione per @code{sub()} e
@code{gsub()}}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
+ @code{\&}! @code{&}!Il testo individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\\\&}! @code{\\&}!I caratteri @samp{\&}_cr
+ @code{\\\\\&}! @code{\\&}!I caratteri @samp{\&}_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\\&}_cr
+ @code{\\q}! @code{\q}!I caratteri @samp{\q}_cr
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden Immissione @tab @code{sub()} vede @tab @code{sub()} genera
address@hidden @code{\&} @tab @code{&} @tab Il testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\\\&} @tab @code{\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\\&} @tab @code{\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\\&}
address@hidden @code{\\q} @tab @code{\q} @tab I caratteri @samp{\q}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+ Immissione @code{sub()} vede @code{sub()} genera
+ --------------- ------------- ---------------
+ @code{\&} @code{&} Il testo individuato
+ @code{\\&} @code{\&} La lettera @samp{&}
+ @code{\\\&} @code{\&} La lettera @samp{&}
+ @code{\\\\&} @code{\\&} Le lettere @samp{\&}
+ @code{\\\\\&} @code{\\&} Le lettere @samp{\&}
address@hidden&} @code{\\\&} Le lettere
@samp{\\&}
+ @code{\\q} @code{\q} Le lettere @samp{\q}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
address@hidden
+Questa tabella mostra l'elaborazione a livello lessicale, in cui
+un numero dispari di barre inverse diventa un numero pari al momento
+dell'esecuzione,
+e mostra anche l'elaborazione in fase di esecuzione fatta da @code{sub()}.
+(Per amor di address@hidden le tavole che ancora seguono mostrano solo il caso
+di un numero pari di barre inverse immesso a livello lessicale.)
+
+Il problema con l'approccio storico @`e che non c'@`e modo di ottenere
+un carattere @samp{\} seguito dal testo individuato.
+
+Parecchie edizioni dello standard POSIX hanno provato a risolvere questo
+problema, senza riuscirci. I dettagli sono irrilevanti in questo contesto.
+
+A un certo punto, il manutentore di @command{gawk} ha presentato una
+proposta per una revisione dello standard per tornare
+a regole che corrispondano address@hidden da vicino alla prassi originalmente
seguita.
+Le regole proposte hanno dei casi speciali che rendono possibile
+produrre una @samp{\} prima del
+testo individuato. Questo si address@hidden vedere nella
address@hidden
+
address@hidden Tabella,table-sub-proposed
address@hidden @command{gawk} per @code{sub()} e barra inversa}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\&}_cr
address@hidden&}! @code{\\&}!Il carattere @samp{\}, seguito dal testo
individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\q}! @code{\q}!I caratteri @samp{\q}_cr
+ @code{\\\\}! @address@hidden
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden Immissione @tab @code{sub()} vede @tab @code{sub()} genera
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\&} @tab @code{\\&} @tab Il carattere @samp{\},
seguito dal testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\q} @tab @code{\q} @tab I caratteri @samp{\q}
address@hidden @code{\\\\} @tab @code{\\} @tab @code{\\}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+Immissione @code{sub()} vede @code{sub()} genera
+--------- ---------- ---------------
address@hidden&} @code{\\\&} Il carattere @samp{\&}
+ @code{\\\\&} @code{\\&} Il carattere @samp{\}, seguito
dal testo individuato
+ @code{\\&} @code{\&} Il carattere @samp{&}
+ @code{\\q} @code{\q} I caratteri @samp{\q}
+ @code{\\\\} @code{\\} @code{\\}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
+In breve, al momento dell'esecuzione, ci sono ora tre sequenze speciali
+di caratteri (@samp{\\\&}, @samp{\\&}, e @samp{\&}) mentre tradizionalmente
+ce n'era una sola. Tuttavia, come nel caso storico, ogni @samp{\} che
+non fa parte di una di queste tre sequenze non @`e speciale e appare
+nell'output address@hidden@dotless{i}} come @`e scritto.
+
address@hidden 3.0 e 3.1 seguono queste regole per @code{sub()} e
address@hidden()}. La revisione dello standard POSIX ha richiesto molto
address@hidden tempo
+di quel che ci si attendeva. Inoltre, la proposta del manutentore di
address@hidden @`e andata persa durante il processo di standardizzazione. Le
+regole finali risultanti sono un po' address@hidden semplici. I risultati
sono simili,
+tranne che in un caso.
+
address@hidden POSIX @command{awk}, funzioni @code{gsub()}/@code{sub()} e
+Le regole POSIX stabiliscono che @samp{\&} nella stringa di rimpiazzo
+produca il carattere @samp{&}, @samp{\\} produce il carattere @samp{\},
+e che @samp{\} seguito da qualsiasi carattere non @`e speciale; la @samp{\}
address@hidden messa direttamente nell'output.
+Queste regole sono presentate nella @ref{table-posix-sub}.
+
address@hidden Tabella,table-posix-sub
address@hidden POSIX per @code{sub()} e @code{gsub()}}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\&}_cr
address@hidden&}! @code{\\&}!Il carattere @samp{\}, seguito dal testo
individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\q}! @code{\q}!I caratteri @samp{\q}_cr
+ @code{\\\\}! @address@hidden
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden @tab @code{sub()} vede @tab @code{sub()} genera
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\&} @tab @code{\\&} @tab Il carattere @samp{\},
seguito dal testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab I caratteri @samp{&}
address@hidden @code{\\q} @tab @code{\q} @tab I caratteri @samp{\q}
address@hidden @code{\\\\} @tab @code{\\} @tab @code{\}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+Immissione @code{sub()} vede @code{sub()} genera
+--------- ---------- ---------------
address@hidden&} @code{\\\&} I caratteri @samp{\&}
+ @code{\\\\&} @code{\\&} Il carattere @samp{\}, seguito
dal testo individuato
+ @code{\\&} @code{\&} Il carattere @samp{&}
+ @code{\\q} @code{\q} I caratteri @samp{\q}
+ @code{\\\\} @code{\\} @code{\}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
+Il solo caso in cui la differenza @`e rilevante @`e l'ultimo: @samp{\\\\}
address@hidden visto come @samp{\\} e produce @samp{\} invece che @samp{\\}.
+
+A partire dalla @value{PVERSION} 3.1.4, @command{gawk} ha seguito le regole
+POSIX quando si specifica @option{--posix} (@pxref{Opzioni}). Altrimenti, ha
+continuato a seguire le regole proposte [a POSIX], poich@'e questa @`e stato il
+comportamento seguito per parecchi anni.
+
+Quando la @value{PVERSION} 4.0.0 @`e stata rilasciata, il manutentore di
address@hidden
+ha stabilito come default le regole POSIX, interrompendo
address@hidden@dotless{i}} oltre
+un decennio di address@hidden
+all'address@hidden decisione si @`e dimostrata piuttosto avventata,
+anche se una nota in questa sezione avvertiva che la successiva versione
+principale di @command{gawk} avrebbe adottato le regole POSIX.}
+Inutile dire che questa non @`e stata una buona idea, e quindi dalla
address@hidden 4.0.1, @command{gawk} ha ripreso il suo comportamento
+tradizionale, seguendo le regole POSIX solo quando si specifica l'opzione
address@hidden
+
+Le regole per @code{gensub()} sono molto address@hidden semplici. Al momento
+dell'esecuzione, quando @command{gawk} vede una @samp{\}, se il carattere
+seguente @`e una cifra,
+il testo individuato dalla corrispondente sottoespressione tra parentesi
address@hidden inserito nell'output generato. Altrimenti, qualsiasi carattere
segua la
address@hidden viene inserito nel testo generato, mentre la @samp{\} va persa,
+come si vede nella @ref{table-gensub-escapes}.
+
address@hidden Tabella,table-gensub-escapes
address@hidden sequenze di protezione in @code{gensub()}}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
+ @code{&}! @code{&}!Il testo individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\\\}! @code{\\}!Il carattere @samp{\}_cr
+ @code{\\\\&}! @code{\\&}!Il carattere @samp{\}, seguito dal testo
individuato_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\&}_cr
+ @code{\\q}! @code{\q}!Il carattere @samp{q}_cr
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden Immissione @tab @code{gensub()} vede @tab @code{gensub()} genera
address@hidden @code{&} @tab @code{&} @tab Il testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\\\} @tab @code{\\} @tab Il carattere @samp{\}
address@hidden @code{\\\\&} @tab @code{\\&} @tab Il carattere @samp{\},
seguito dal testo individuato
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\q} @tab @code{\q} @tab Il carattere @samp{q}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+ Immissione @code{gensub()} vede @code{gensub()} genera
+ --------- ------------- ------------------
+ @code{&} @code{&} Il testo individuato
+ @code{\\&} @code{\&} Il carattere @samp{&}
+ @code{\\\\} @code{\\} Il carattere @samp{\}
+ @code{\\\\&} @code{\\&} Il carattere @samp{\},
seguito dal testo individuato
address@hidden&} @code{\\\&} I caratteri @samp{\&}
+ @code{\\q} @code{\q} Il carattere @samp{q}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
+A causa della address@hidden dell'elaborazione a livello lessicale e in fase
+di esecuzione, e dei casi speciali di @code{sub()} e @code{gsub()},
+si raccomanda l'uso di @command{gawk} e di @code{gensub()} quando ci siano
+da fare delle sostituzioni.
+
address@hidden Funzioni di I/O
address@hidden Funzioni di Input/Output
address@hidden input/output, funzioni di
address@hidden funzioni di input/output
+
+Le seguenti funzioni riguardano l'input/output (I/O).
+I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @asis
address@hidden @code{close(address@hidden address@hidden,} @address@hidden)}
address@hidden
address@hidden file, chiusura
address@hidden chiudere un file o un coprocesso
+Chiude il file @var{nome_file} in input o in output. Alternativamente,
+l'argomento address@hidden essere un comando della shell usato per creare un
+coprocesso, o per ridirigere
+verso o da una @dfn{pipe}; questo coprocesso o @dfn{pipe} viene chiuso.
address@hidden file e @dfn{pipe}}
+per ulteriori informazioni.
+
+Quando si chiude un coprocesso, address@hidden talora essere utile chiudere
dapprima
+un lato della @dfn{pipe} bidirezionale e quindi chiudere l'altro.
+Questo si address@hidden fare fornendo un secondo argomento a @code{close()}.
+Questo secondo argomento (@var{come})
+dovrebbe essere una delle due stringhe @code{"to"} o @code{"from"},
+che indicano quale lato della @dfn{pipe} chiudere. La stringa address@hidden
essere
+scritta indifferentemente in maiuscolo o in minuscolo.
address@hidden/O bidirezionale},
+che tratta questa address@hidden con maggior dettaglio e mostra un esempio.
+
+Si noti che il secondo argomento di @code{close()} @`e
+un'estensione @command{gawk}; non @`e disponibile in address@hidden compatibile
+(@pxref{Opzioni}).
+
address@hidden @code{fflush(address@hidden@code{)}
address@hidden
address@hidden scrivere su disco i buffer di output contenuti in memoria
+Scrive su disco ogni output contenuto in memoria, associato con
address@hidden, che @`e o un
+file aperto in scrittura o un comando della shell che ridirige output a
+una @dfn{pipe} o a un coprocesso.
+
address@hidden buffer, scrivere su disco un
address@hidden memoria tampone, scrivere su disco
address@hidden output, bufferizzazione
address@hidden output, nella memoria tampone (buffer)
+Molti programmi di address@hidden @dfn{bufferizzano} il loro output
(address@hidden,
+accumulano in memoria record da scrivere in un file su disco o sullo
+schermo, fin quando non arriva il momento giusto per inviare i
+dati al dispositivo di output).
+Questo @`e spesso address@hidden efficiente che scrivere
+ogni particella di informazione non appena diventa disponibile. Tuttavia,
+qualche volta @`e necessario forzare un programma a @dfn{svuotare}
+i suoi buffer (address@hidden, inviare l'informazione alla sua destinazione,
+anche se un buffer non @`e pieno).
+Questo @`e lo scopo della funzione @code{fflush()}; anche
address@hidden scrive il suo output in un buffer, e la funzione @code{fflush()}
+forza @command{gawk} a svuotare i suoi buffer.
+
address@hidden estensioni comuni, funzione @code{fflush()}
address@hidden Brian Kernighan, @command{awk} di
+Brian Kernighan ha aggiunto @code{fflush()} al suo @command{awk} nell'aprile
+1992. Per due decenni @`e rimasta un'estensione comune. A Dicembre
+2012 @`e stata accettata e inclusa nello standard POSIX.
+Si veda @uref{http://austingroupbugs.net/view.php?id=634, il sito Web
dell'Austin Group}.
+
+POSIX standardizza @code{fflush()} come segue: se non c'@`e alcun
+argomento, o se l'argomento @`e la stringa nulla (@address@hidden""}}),
address@hidden svuota i buffer di @emph{tutti} i file in output e di
address@hidden le @dfn{pipe}.
+
address@hidden NOTA
+Prima della @value{PVERSION} 4.0.2, @command{gawk}
+avrebbe svuotato solo i buffer dello standard output se non era
+specificato alcun argomento,
+e svuotato tutti i buffer dei file in output e delle @dfn{pipe} se
+l'argomento era la stringa nulla.
+Questo @`e stato modificato per essere compatibile con l'@command{awk} di
+Kernighan, nella speranza che standardizzare questa
address@hidden in POSIX sarebbe stato address@hidden agevole (come poi @`e
effettivamente
+successo).
+
+Con @command{gawk},
+si address@hidden usare @samp{fflush("/dev/stdout")} se si desidera solo
svuotare i
+buffer dello standard output.
address@hidden quotation
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden risoluzione di problemi, funzione @code{fflush()}
address@hidden problemi, risoluzione di, funzione @code{fflush()}
address@hidden()} restituisce zero se il buffer @`e svuotato con successo;
+altrimenti, restituisce un valore diverso da zero. (@command{gawk}
+restituisce @minus{}1.)
+Nel caso in cui tutti i buffer vadano svuotati, il valore restituito @`e zero
+solo se tutti i buffer sono stati svuotati con successo. Altrimenti,
address@hidden @minus{}1, e @command{gawk} avvisa riguardo al @var{nome_file}
+che ha problemi.
+
address@hidden invia anche un messaggio di avvertimento se si tenta di svuotare
i
+buffer di un file o @dfn{pipe} che era stato aperto in lettura
+(p.es. con @code{getline}),
+o se @var{nome_file} non @`e un file, una @dfn{pipe}, o un coprocesso aperto.
+in tal caso, @code{fflush()} restituisce ancora @minus{}1.
+
address@hidden sidebar, Bufferizzazione interattiva e non interattiva
address@hidden
address@hidden
+<sidebar><title>Bufferizzazione interattiva e non interattiva</title>
address@hidden docbook
+
address@hidden bufferizzazione, interattiva vs.@: non interattiva
+
+A complicare ulteriormente le cose, i problemi di bufferizzazione possono
+peggiorare se il programma eseguito
address@hidden @dfn{interattivo} (address@hidden, se
+comunica con un utente seduto davanti a una tastiera)address@hidden programma
address@hidden interattivo se il suo standard output @`e connesso a un
dispositivo
+terminale. Ai giorni nostri, questo vuol dire davanti a uno
+schermo e a una tastiera.}
+
address@hidden Thanks to address@hidden for this example, and for
address@hidden motivating me to write this section.
+I programmi interattivi normalmente @dfn{bufferizzano per riga} il loro
+output (address@hidden, scrivono in output una riga alla volta). I programmi
+non-interattivi attendono di aver riempito un buffer, il che address@hidden
voler dire
+anche parecchie righe di output.
+Ecco un esempio della differenza:
+
address@hidden
+$ @kbd{awk '@{ print $1 + $2 @}'}
address@hidden 1}
address@hidden 2
address@hidden 3}
address@hidden 5
address@hidden
address@hidden example
+
address@hidden
+Ogni riga di output @`e stampata immediatamente. Si confronti questo
+comportamente con quello di questo esempio:
+
address@hidden
+$ @kbd{awk '@{ print $1 + $2 @}' | cat}
address@hidden 1}
address@hidden 3}
address@hidden
address@hidden 2
address@hidden 5
address@hidden example
+
address@hidden
+In questo caso, nessun output viene stampato finch@'e non @`e stato battuto il
address@hidden, perch@'e l'output @`e bufferizzato e inviato tramite
address@hidden al comando @command{cat} in un colpo solo.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Bufferizzazione interattiva e non interattiva}
+
+
address@hidden bufferizzazione, interattiva vs.@: non interattiva
+
+A complicare ulteriormente le cose, i problemi di bufferizzazione possono
+peggiorare se il programma eseguito
address@hidden @dfn{interattivo} (address@hidden, se
+comunica con un utente seduto davanti a una tastiera)address@hidden programma
address@hidden interattivo se il suo standard output @`e connesso a un
dispositivo
+terminale. Ai giorni nostri, questo vuol dire davanti a uno
+schermo e a una tastiera.}
+
address@hidden Thanks to address@hidden for this example, and for
address@hidden motivating me to write this section.
+I programmi interattivi normalmente @dfn{bufferizzano per riga} il loro
+output (address@hidden, scrivono in output una riga alla volta). I programmi
+non-interattivi attendono di aver riempito un buffer, il che address@hidden
voler dire
+anche parecchie righe di output.
+Ecco un esempio della differenza:
+
address@hidden
+$ @kbd{awk '@{ print $1 + $2 @}'}
address@hidden 1}
address@hidden 2
address@hidden 3}
address@hidden 5
address@hidden
address@hidden example
+
address@hidden
+Ogni riga di output @`e stampata immediatamente. Si confronti questo
+comportamente con quello di questo esempio:
+
address@hidden
+$ @kbd{awk '@{ print $1 + $2 @}' | cat}
address@hidden 1}
address@hidden 3}
address@hidden
address@hidden 2
address@hidden 5
address@hidden example
+
address@hidden
+In questo caso, nessun output viene stampato finch@'e non @`e stato battuto il
address@hidden, perch@'e l'output @`e bufferizzato e inviato tramite
address@hidden al comando @command{cat} in un colpo solo.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden @code{system(@var{comando})}
address@hidden
address@hidden chiamare comandi di shell
address@hidden interagire con altri programmi
+Esegue il comando del sistema operativo @var{comando} e quindi
+ritorna al programma @command{awk}.
+Restituisce il codice ritorno di @var{comando}.
+
+Per esempio, inserendo il seguente frammento di codice in un programma
address@hidden:
+
address@hidden
+END @{
+ system("date | mail -s 'awk completato' root")
address@hidden
address@hidden example
+
address@hidden
+all'amministratore di sistema viene inviato un messaggio di posta quando
+il programma @command{awk} termina di elaborare l'input e inizia
+l'elaborazione da eseguire alla fine dell'input.
+
+Si noti che la ridirezione di @code{print} o @code{printf} in una
address@hidden @`e spesso sufficiente per ottenere lo stesso risultato.
+Se @`e necessario eseguire parecchi comandi, @`e address@hidden efficiente
+stamparli verso una @dfn{pipe} diretta alla shell:
+
address@hidden
+while (@var{ancora lavoro da fare})
+ print @var{comando} | "/bin/sh"
+close("/bin/sh")
address@hidden example
+
address@hidden
address@hidden risoluzione di problemi, funzione @code{system()}
address@hidden problemi, risoluzione di, funzione @code{system()}
address@hidden @option{--sandbox}, opzione, disabilitare la funzione
@code{system()}
address@hidden opzione @option{--sandbox}, disabilitare la funzione
@code{system()}
+Tuttavia, nel caso che il programma @command{awk} sia interattivo,
address@hidden()} @`e utile per eseguire grossi programmi autonomi,
+come ad esempio la shell o un programma di modifica testi.
+Alcuni sistemi operativi non consentono di implementare la funzione
address@hidden()}.
+Richiamare @code{system()} in sistemi in cui non @`e disponibile provoca
+un errore fatale.
+
address@hidden NOTA
+Quando si specifica l'opzione @option{--sandbox}, la funzione @code{system()}
@`e
+disabilitata (@pxref{Opzioni}).
address@hidden quotation
+
+Nei sistemi aderenti allo standard POSIX, il codice di ritorno di un
+comando @`e un numero contenuto in 16 bit. Il valore del codice di ritorno
+passato alla funzione C @code{exit()} alla fine del programma @`e contenuto
+negli 8 bit di valore address@hidden alto dei 16 bit (la address@hidden
sinistra) che compongono
+il numero. I bit di valore address@hidden basso (la address@hidden destra)
indicano se il
+processo @`e stato terminato da un segnale (bit 7), e, se questo @`e il caso,
+il numero del segnale che ha provocato la terminazione (bit 0--6).
+
+Tradizionalmente, la funzione @code{system()} di @command{awk} si @`e
+semplicemente limitata a restituire il valore del codice di ritorno
+diviso per 256 (ossia la address@hidden sinistra del numero di 16 bit, spostata
+a destra). In una situazione normale questo equivale a utilizzare il
+codice di ritornodi @code{system()}, ma nel caso in cui il programma sia
+stato terminato da un segnale, il valore diventa un numero frazionale a
+virgola address@hidden uno scambio di messaggi privato il Dr.@:
+Kernighan mi ha comunicato che questo modo di procedere @`e probabilmente
+errato.} POSIX stabilisce che la chiamata a @code{system()} dall'interno
+di @command{awk} dovrebbe restituire l'intero valore a 16 bit.
+
address@hidden si trova in qualche modo a address@hidden strada.
+I valori del codice di ritorno sono descritti nella
address@hidden
+
address@hidden Tabella,table-system-return-values
address@hidden codici di ritorno da chiamata a @code{system()}}
address@hidden @columnfractions .40 .60
address@hidden Situazione @tab Valore codice di ritorno da @code{system()}
address@hidden @option{--traditional} @tab Valore dalla funzione C
@code{system()}/256
address@hidden @option{--posix} @tab Valore dalla funzione C @code{system()}
address@hidden Uscita normale dal comando @tab Codice di ritorno del comando
address@hidden Terminazione da un segnale @tab 256 + numero segnale "assassino"
address@hidden Terminazione da un segnale con dump memoria @tab 512 + numero
segnale "assassino"
address@hidden Qualsiasi tipo di errore @tab @minus{}1
address@hidden multitable
address@hidden float
address@hidden table
+
address@hidden sidebar, Controllare la bufferizzazione dell'output con
@code{system()}
address@hidden
address@hidden
+<sidebar><title>Controllare la bufferizzazione dell'output con
@code{system()}</title>
address@hidden docbook
+
address@hidden buffer, scrivere su disco un
address@hidden bufferizzazione, dell'input/output
address@hidden output, bufferizzazione
address@hidden bufferizzazione, dell'output
+
+La funzione @code{fflush()} consente un controllo esplicito sulla
+bufferizzazione dell'output per singoli file e @dfn{pipe}.
+Tuttavia, il suo utilizzo non @`e portabile su molte delle meno recenti
+implementazioni di @command{awk}. Un metodo alternativo per forzare la
+scrittura dell'output @`e una chiamata a
address@hidden()} che abbia come argomento la stringa nulla:
+
address@hidden
+system("") # scrive l'output su disco
address@hidden example
+
address@hidden
address@hidden tratta questo uso della funzione @code{system()} come un
+caso speciale, e si guarda bene dall'invocare la shell (o un altro
+interprete di comandi) con un comando nullo.
+Quindi, con @command{gawk}, questa maniera di procedere non @`e solo utile,
+ma @`e anche efficiente.
+Questo metodo dovrebbe funzionare anche con
+altre implementazioni di @command{awk}, ma non @`e detto che eviti una
+invocazione non necessaria della shell. (Altre implementazioni potrebbero
+limitarsi a forzare la scrittura del buffer associato con lo
+standard output, e non necessariamente di tutto l'output bufferizzato.)
+
+Avendo in mente le attese di un programmatore, sarebbe sensato che
address@hidden()} forzi la scrittura su disco di tutto l'output disponibile.
+Il programma seguente:
+
address@hidden
+BEGIN @{
+ print "prima riga stampata"
+ system("echo system echo")
+ print "seconda riga stampata"
address@hidden
address@hidden example
+
address@hidden
+deve stampare:
+
address@hidden
+prima riga stampata
+system echo
+seconda riga stampata
address@hidden example
+
address@hidden
+e non:
+
address@hidden
+system echo
+prima riga stampata
+seconda riga stampata
address@hidden example
+
+Se @command{awk} non forzasse la scrittura dei suoi buffer prima di
+invocare @code{system()}, l'output sarebbe quest'ultimo (quello non voluto).
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Controllare la bufferizzazione dell'output con
@code{system()}}
+
+
address@hidden buffer, scrivere su disco un
address@hidden bufferizzazione, dell'input/output
address@hidden output, bufferizzazione
address@hidden bufferizzazione, dell'output
+
+La funzione @code{fflush()} consente un controllo esplicito sulla
+bufferizzazione dell'output per singoli file e @dfn{pipe}.
+Tuttavia, il suo utilizzo non @`e portabile su molte delle meno recenti
+implementazioni di @command{awk}. Un metodo alternativo per forzare la
+scrittura dell'output @`e una chiamata a
address@hidden()} che abbia come argomento la stringa nulla:
+
address@hidden
+system("") # scrive l'output su disco
address@hidden example
+
address@hidden
address@hidden tratta questo uso della funzione @code{system()} come un
+caso speciale, e si guarda bene dall'invocare la shell (o un altro
+interprete di comandi) con un comando nullo.
+Quindi, con @command{gawk}, questa maniera di procedere non @`e solo utile,
+ma @`e anche efficiente.
+Questo metodo dovrebbe funzionare anche con
+altre implementazioni di @command{awk}, ma non @`e detto che eviti una
+invocazione non necessaria della shell. (Altre implementazioni potrebbero
+limitarsi a forzare la scrittura del buffer associato con lo
+standard output, e non necessariamente di tutto l'output bufferizzato.)
+
+Avendo in mente le attese di un programmatore, sarebbe sensato che
address@hidden()} forzi la scrittura su disco di tutto l'output disponibile.
+Il programma seguente:
+
address@hidden
+BEGIN @{
+ print "prima riga stampata"
+ system("echo system echo")
+ print "seconda riga stampata"
address@hidden
address@hidden example
+
address@hidden
+deve stampare:
+
address@hidden
+prima riga stampata
+system echo
+seconda riga stampata
address@hidden example
+
address@hidden
+e non:
+
address@hidden
+system echo
+prima riga stampata
+seconda riga stampata
address@hidden example
+
+Se @command{awk} non forzasse la scrittura dei suoi buffer prima di
+invocare @code{system()}, l'output sarebbe quest'ultimo (quello non voluto).
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Funzioni di tempo
address@hidden Funzioni per gestire marcature temporali
address@hidden funzioni di tempo
+
address@hidden marcature temporali
address@hidden data e ora, si veda marcature temporali
address@hidden @dfn{log} (registro), file di, marcature temporali nei
address@hidden registro (@dfn{log}), file di, marcature temporali nel
address@hidden file di registro (@dfn{log}), marcature temporali nei
address@hidden @command{gawk}, data e ora (marcature temporali)
address@hidden POSIX @command{awk}, marcature temporali e
+I programmi @command{awk} sono frequentemente usati per elaborare file di
+registro [file con estensione .log], che contengono l'informazione sulla data e
+l'ora (marcatura temporale) in cui un particolare record @`e stato registrato
sul log.
+Molti programmi registrano questa informazione nel formato restituito
+dalla chiamata di sistema @code{time()}, la quale misura il numero di secondi
+trascorsi a partire da una certa data iniziale (Epoca). Nei sistemi aderenti
+allo standard POSIX, questo @`e il numero di secondi a partire dal primo
gennaio
+1970, ora di Greenwich (1970-01-01 00:00:00 UTC), senza includere i secondi
address@hidden FOR_PRINT
address@hidden
address@hidden@xrefIl{Glossario},
address@hidden iftex
address@hidden
address@hidden@xref{Glossario},
address@hidden ifnottex
+in particolare le voci ``Epoca'' e ``UTC.''}
address@hidden ifclear
address@hidden FOR_PRINT
+intercalari.
address@hidden ifset
+Tutti i sistemi noti aderenti allo standard POSIX gestiscono le marcature
+temporali da 0 fino a
address@hidden
address@hidden - 1},
address@hidden iftex
address@hidden
+2^31 - 1,
address@hidden ifinfo
address@hidden
address@hidden
address@hidden @minus{} 1,
address@hidden ifnotinfo
address@hidden ifnottex
+il che @`e sufficiente per rappresentare date e ore fino a inizio 2038
+(2038-01-19 03:14:07 UTC). Molti sistemi supportano una maggiore estensione
+di date, compresi dei valori negativi per rappresentare delle date
+anteriori all'Epoca.
+
address@hidden @command{date}, programma di address@hidden GNU
address@hidden programma di address@hidden @command{date} GNU
address@hidden tempo, ottenerlo
+Per facilitare l'elaborazione di tali file di registro, e per produrre
+dei rapporti utili, @command{gawk} prevede le seguenti funzioni per
+lavorare con le marcature temporali. Si tratta di estensioni @command{gawk};
+non sono previste nello standard address@hidden comando di address@hidden GNU
address@hidden address@hidden fare anche molte delle cose qui descritte.
address@hidden essere
+preferibile usarlo per semplici operazioni relative a data e ora in semplici
+script della shell.} Tuttavia, anche versioni recenti di @command{mawk}
+(@pxref{Altre versioni}) prevedono queste funzioni. I parametri facoltativi
+sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{mktime(@var{specifiche_data}} address@hidden,
@var{utc-flag}} address@hidden)}
address@hidden
address@hidden generare data e ora
+Trasforma @var{specifiche_data} in una marcatura temporale nello stesso formato
+restituito da @code{systime()}. @`E simile alla funzione omonima
+in ISO C. L'argomento, @var{specifiche_data}, @`e una stringa della forma
address@hidden@code{"@var{AAAA} @var{MM} @var{GG} @var{HH} @var{MM} @var{SS}
address@hidden"}}.
+La stringa consiste di sei o sette numeri che rappresentano,
+rispettivamente,
+l'anno in quattro cifre, il mese da 1 a 12, il giorno del mese
+da 1 a 31, l'ora del giorno da 0 a 23, il minuto da 0 a
+59, il secondo da 0 a 60,@footnote{Occasionalmente ci sono dei
+minuti in un anno con un secondo intercalare, il che spiega perch@'e i
+secondi possono arrivare fino a 60.}
+e un'indicazione opzionale relativa all'ora legale.
+
+I valori di questi numeri possono non essere negli intervalli specificati; per
+esempio, un'ora di @minus{}1 sta a indicare 1 ora prima di mezzanotte.
+Viene adottato il calendario gregoriano con l'origine posta all'anno zero,
+con l'anno 0 che viene prima dell'anno 1 e l'anno @minus{}1 che viene prima
+dell'anno 0. Se il flag @var{utc-flag} @`e specificato ed @`e diverso da zero
+e dalla stringa nulla, si suppone che l'ora sia quella del fuso orario UTC;
+altrimenti l'ora @`e considerata essere quella del fuso orario locale. Se
+l'indicatore dell'ora legale @`e positivo, si presuppone che l'ora sia quella
+legale; se @`e 0, l'ora considerata @`e quella di Greenwich (standard time); se
+invece @`e negativo (questo @`e il default), @code{mktime()} tenta di
+determinare se @`e in vigore l'ora legale o no, nel momento specificato.
+
+Se @var{specifiche_data} non contiene elementi in numero sufficiente, o se
+la data e ora risultante sono fuori dall'intervallo previsto,
address@hidden()} restituisce @minus{}1.
+
address@hidden @command{gawk}, vettore @code{PROCINFO} in
address@hidden @code{PROCINFO}, vettore
address@hidden vettore @code{PROCINFO}
address@hidden @code{strftime(address@hidden address@hidden,} @var{data_e_ora}
address@hidden,} @var{utc}] ] address@hidden)}
address@hidden
address@hidden formato stringa marcature temporali
address@hidden formato stringa data e ora
address@hidden data e ora, formato stringa
address@hidden marcature temporali, formato stringa
+Formatta la data e ora specificata da @var{data_e_ora} in base alle indicazioni
+contenute nella stringa @var{formato} e restituisce il risultato.
address@hidden simile alla funzione omonima in ISO C.
+Se @var{utc} @`e presente ed @`e diverso da zero o dalla stringa nulla,
+il valore @`e formattato come UTC (Tempo Coordinato Universale,
address@hidden noto come GMT o Tempo Medio di Greenwich).
+Altrimenti, il valore @`e formattato per il fuso orario locale.
+La stringa @var{data_e_ora} @`e nello stesso formato del valore restituito
+dalla funzione @code{systime()}. Se non si specifica l'argomento
address@hidden, @command{gawk} usa l'ora del giorno corrente per la
+formattazione.
+Omettendo l'argomento @var{formato}, @code{strftime()} usa
+il valore di @code{PROCINFO["strftime"]} come stringa di formattazione
+(@pxref{Variabili predefinite}).
+Il valore di default della stringa @`e
address@hidden@w{"%a %b %e %H:%M:%S %Z %Y"}}. Questa stringa di formattazione
+produce lo stesso output del programma di address@hidden equivalente
address@hidden
+Si address@hidden assegnare un nuovo valore a @code{PROCINFO["strftime"]} per
+modificare la formattazione di default; si veda
+la lista che segue per le varie direttive di formattazione.
+
address@hidden @code{systime()}
address@hidden
address@hidden marcature temporali
address@hidden data e ora, si veda marcature temporali
address@hidden data e ora corrente del sistema
+Restituisce l'ora corrente come numero di secondi a partire dall'Epoca
+del sistema. Sui sistemi aderenti allo standard POSIX, questo @`e il numero
+di secondi trascorsi a partire dal primo gennaio 1970, ora di Greenwich
+(1970-01-01 00:00:00 UTC), senza includere i secondi intercalari.
address@hidden table
+
+La funzione @code{systime()} consente di confrontare una marcatura temporale
+in un file di registro con la data e ora correnti. In particolare, @`e facile
+determinare quanto tempo prima un particolare record @`e stato registrato.
address@hidden anche possibile produrre record di registro usando il formato
+``secondi a partire dall'Epoca''.
+
address@hidden conversione di date in marcature temporali
address@hidden date, conversione in marcature temporali
address@hidden marcature temporali, conversione date nelle
+La funzione @code{mktime()} consente di convertire una rappresentazione in
+forma testuale di una data e ora in una marcatura temporale.
+Questo semplifica i confronti prima/dopo tra differenti date e ore, in
+particolare quando si abbia a che fare con date e ore provenienti da una
+fonte esterna, come un file di registro.
+
+La funzione @code{strftime()} permette di trasformare facilmente una marcatura
+temporale in un'informazione intelligibile. @`E analoga come tipo alla
funzione
address@hidden()} (@pxref{Funzioni per stringhe}), nel senso che copia
+letteralmente address@hidden che non @`e una specifica di formato nella
stringa che viene
+restituita, mentre sostituisce i valori di data e ora a seconda delle
+specifiche di formato contenute nella stringa @var{formato}.
+
address@hidden specificatori di formato, funzione @code{strftime()} di
(@command{gawk})
address@hidden formato, specificatori di, funzione @code{strftime()} di
(@command{gawk})
+Per @code{strftime()} lo standard
+1999 ISO address@hidden,
+non tutte le funzioni @code{strftime()} dei vari sistemi operativi
+ammettono tutte le conversioni qui elencate.}
+consente le seguenti specifiche di formattazione delle date:
+
address@hidden @code
address@hidden %a
+Il nome abbreviato del giorno della settimana nella lingua locale.
+
address@hidden %A
+Il nome completo del giorno della settimana nella lingua locale.
+
address@hidden %b
+Il nome abbreviato del mese dell'anno nella lingua locale.
+
address@hidden %B
+Il nome completo del mese dell'anno nella lingua locale.
+
address@hidden %c
+Il formato ``appropriato'' della rappresentazione della data e ora
+nella lingua locale.
+(Questo @`e @samp{%A %B %d %T %Y} per la localizzazione @code{"C"}.)
+
address@hidden %C
+La parte che designa il secolo nell'anno corrente.
+Si ottiene dividendo per 100 l'anno, e
+troncando verso il basso
+all'intero address@hidden vicino.
+
address@hidden %d
+Il giorno del mese come numero decimale (01--31).
+
address@hidden %D
+Equivale a specificare @samp{%m/%d/%y}.
+
address@hidden %e
+Il giorno del mese, preceduto da uno spazio se di tratta di una cifra sola.
+
address@hidden %F
+Equivale a specificare @samp{%Y-%m-%d}.
+Questo @`e il formato ISO 8601 della data.
+
address@hidden %g
+L'anno (ultime due cifre) ricavato prendendo il resto della divisione per 100
+dell'anno a cui appartiene la settimana, secondo ISO 8601, come numero decimale
+(00--99). Per esempio, il primo gennaio 2012, fa parte della settimana 53 del
+2011. Quindi, l'anno relativo al numero di settimana ISO di quella data @`e
2011
+(ossia 11), anche se la data in s@'e @`e nel 2012. Analogamente, il 31
dicembre
+2012, @`e nella prima settimana del 2013. Quindi, l'anno relativo al numero di
+settimana ISO di quella data @`e 2013 (ossia 13), anche se la data in s@'e @`e
nel
+2012.
+
address@hidden %G
+L'anno intero relativo al numero di settimana ISO, come numero decimale.
+
address@hidden %h
+Equivalente a @samp{%b}.
+
address@hidden %H
+L'ora (in un orologio a 24 ore) come numero decimale (00--23).
+
address@hidden %I
+L'ora (in un orologio a 12 ore) come numero decimale (01--12).
+
address@hidden %j
+Il giorno dell'anno come numero decimale (001--366).
+
address@hidden %m
+Il mese come numero decimale (01--12).
+
address@hidden %M
+Il minuto come numero decimale (00--59).
+
address@hidden %n
+Un carattere di ritorno a capo (ASCII LF).
+
address@hidden %p
+L'equivalente nella lingua locale delle designazioni AM/PM
+(mattino/pomerigggio) associate a un orologio a 12 ore.
+
address@hidden %r
+L'ora locale nel formato a 12 ore.
+(Questo @`e @samp{%I:%M:%S %p} nella localizzazione @code{"C"}.)
+
address@hidden %R
+Equivalente a specificare @samp{%H:%M}.
+
address@hidden %S
+Il secondo come numero decimale (00--60).
+
address@hidden %t
+Un carattere di tabulazione [TAB].
+
address@hidden %T
+Equivalente a specificare @samp{%H:%M:%S}.
+
address@hidden %u
+Il numero del giorno della settimana come numero decimale (1--7).
address@hidden@dotless{i}} @`e il giorno numero 1.
+
address@hidden %U
+Il numero di settimana dell'anno (con la prima domenica dell'anno presa
+come primo giorno della prima settimana) come numero decimale (00--53).
+
address@hidden @cindex ISO 8601
address@hidden %V
+Il numero di settimana dell'anno (con il primo address@hidden@dotless{i}}
dell'anno preso
+come primo giorno della prima settimana) come numero decimale (01--53).
+Il metodo per determinare il numero di settimana @`e quello specificato
+dallo standard ISO 8601.
+(In pratica: se la settimana che contiene il primo gennaio ha quattro o
address@hidden giorni nel nuovo anno, allora
address@hidden la settimana numero uno; altrimenti @`e l'ultima settimana
+[52 o 53] dell'anno
+precedente, e la settimana successiva @`e la settimana numero uno.)
+
address@hidden %w
+Il giorno della settimana come numero decimale (0--6).
+Domenica @`e il giorno zero.
+
address@hidden %W
+Il numero di settimana dell'anno (con il primo address@hidden@dotless{i}} come
primo giorno
+della settimana numero uno)
+come numero decimale (00--53).
+
address@hidden %x
+Il formato ``appropriato'' della rappresentazione della data
+nella lingua locale.
+(Questo @`e @samp{%A %B %d %Y} nella localizzazione @code{"C"}.)
+
address@hidden %X
+Il formato ``appropriato'' della rappresentazione della data.
+(Questo @`e @samp{%T} nella localizzazione @code{"C"}.)
+
address@hidden %y
+L'anno modulo 100 (le ultime due cifre) come numero decimale (00--99).
+
address@hidden %Y
+L'anno come numero decimale (p.es., 2015).
+
address@hidden @cindex RFC 822
address@hidden @cindex RFC 1036
address@hidden %z
+La differenza di fuso orario [rispetto all'ora di Greenwich] in formato
address@hidden@var{OOMM}} (p.es., il
+formato necessario per produrre intestazioni di data conformi agli standard
+RFC 822/RFC 1036).
+
address@hidden %Z
+Il nome o l'abbreviazione della zona di fuso orario (@dfn{time zone}); se il
fuso
+orario non @`e determinabile, @`e impostata alla stringa nulla.
+
address@hidden %Ec %EC %Ex %EX %Ey %EY %Od %Oe %OH
address@hidden %OI %Om %OM %OS %Ou %OU %OV %Ow %OW %Oy
+``notazioni alternative'' di specifica
+in cui solo la seconda lettera (@samp{%c}, @samp{%C} e
address@hidden@dotless{i}} via) @`e
address@hidden questo risulta incomprensibile, non @`e il
+caso di preoccuparsi; queste notazioni hanno lo scopo di facilitare
+la ``internazionalizzazione'' dei programmi.
+Altre address@hidden di internazionalizzazione sono descritte in
address@hidden
+(Queste facilitano la address@hidden con il programma di address@hidden
+POSIX @command{date}.)
+
address@hidden %%
+Un singolo carattere @samp{%}.
address@hidden table
+
+Se uno specificatore di conversione non @`e tra quelli elencati sopra, il
+comportamento @`e address@hidden @`e perch@'e ISO C lascia
+indefinito il comportamento della versione C di @code{strftime()} e
address@hidden usa la versione di sistema di @code{strftime()},
+se disponibile.
+Tipicamente, lo specificatore di conversione "non previsto" non appare
+nella stringa risultante, o appare address@hidden@dotless{i}} come @`e
scritto.}
+
+Per sistemi che non aderiscono completamente agli standard
address@hidden utilizza una copia di
address@hidden()} dalla libreria C di GNU.
+Sono disponibili tutte le specifiche di formato sopra elencate.
+Se la detta versione @`e
+usata per compilare @command{gawk} (@pxref{Installazione}),
+sono disponibili anche le seguenti ulteriori specifiche di formato:
+
address@hidden @code
address@hidden %k
+L'ora (in un orologio a 24 ore) come numero decimale (0--23).
+I numeri di una sola cifra sono preceduti da uno spazio bianco.
+
address@hidden %l
+L'ora (in un orologio a 12 ore) come numero decimale (1--12).
+I numeri di una sola cifra sono preceduti da uno spazio bianco.
+
address@hidden
address@hidden %N
+Il nome dell'``Imperatore/Era''.
+Equivalente a @samp{%C}.
+
address@hidden %o
+L'anno dell'``Imperatore/Era''.
+Equivalente a @samp{%y}.
address@hidden ignore
+
address@hidden %s
+L'ora espressa in numero di secondi a partire dall'Epoca.
+
address@hidden
address@hidden %v
+La data in formato VMS (p.es., @samp{20-JUN-1991}).
address@hidden ignore
address@hidden table
+
+In aggiunta a address@hidden, le notazioni alternative sono riconosciute, ma al
+loro posto sono usate quelle normali.
+
address@hidden @code{date}, programma di address@hidden POSIX
address@hidden programma di address@hidden POSIX @code{date}
address@hidden POSIX @command{awk}, programma di address@hidden @code{date} e
+Il seguente esempio @`e un'implementazione @command{awk} del
+programma di address@hidden POSIX @command{date}.
+Normalmente, il programma di address@hidden @command{date} stampa la
+data e l'ora corrente nel formato ben noto. Tuttavia, se si
+specifica al comando un argomento che inizia con un @samp{+}, @command{date}
+copia i caratteri che non sono specifiche di formato nello standard output
+e interpreta l'ora corrente secondo gli specificatori di formato
+contenuti nella stringa. Per esempio:
+
address@hidden
+$ @kbd{date '+Oggi @`e %A, %d %B %Y.'}
address@hidden Oggi @`e address@hidden@dotless{i}}, 22 settembre 2014.
address@hidden example
+
+Ecco la versione @command{gawk} del programma di address@hidden @command{date}.
address@hidden all'interno di uno script di shell per gestire l'opzione
@option{-u},
+che richiede che @command{date} sia eseguito come se il fuso orario
+fosse impostato a UTC:
+
address@hidden
+#! /bin/sh
+#
+# date --- simula il comando POSIX 'date'
+
+case $1 in
+-u) TZ=UTC0 # usare UTC
+ export TZ
+ shift ;;
+esac
+
+gawk 'BEGIN @{
+ formato = PROCINFO["strftime"]
+ codice_di_ritorno = 0
+
+ if (ARGC > 2)
+ codice_di_ritorno = 1
+ else if (ARGC == 2) @{
+ formato = ARGV[1]
+ if (formato ~ /^\+/)
+ formato = substr(formato, 2) # togli il + iniziale
+ @}
+ print strftime(formato)
+ exit codice_di_ritorno
address@hidden' "$@@"
address@hidden example
+
address@hidden Funzioni a livello di bit
address@hidden Funzioni per operazioni di manipolazione bit
address@hidden bit, funzioni per la manipolazione di
address@hidden manipolazione di bit, funzioni per la
address@hidden funzioni per la manipolazione di bit
address@hidden bit, operazioni sui
address@hidden AND, operazione sui bit
address@hidden OR, operazione sui bit
address@hidden XOR, operazione sui bit
address@hidden operazioni sui bit
address@hidden
address@hidden posso spiegarlo per te, ma non posso capirlo per te.}
address@hidden Anonimo
address@hidden quotation
+
+Molti linguaggi consentono di eseguire operazioni @dfn{bit a bit}
+su due numeri interi. In altre parole, l'operazione @`e eseguita
+su ogni successiva coppia di bit presi da ognuno dei due operandi.
+Tre operazioni comuni sono AND, OR e XOR bit a bit.
+Queste operazioni sono descritte nella @ref{table-bitwise-ops}.
+
address@hidden 11/2014: Postprocessing turns the docbook informaltable
address@hidden into a table. Hurray for scripting!
address@hidden Tabella,table-bitwise-ops
address@hidden a livello di bit}
address@hidden
address@hidden
address@hidden
address@hidden
+ Operatore booleano
+ | AND | OR | XOR
+ |---+---+---+---+---+---
+Operandi | 0 | 1 | 0 | 1 | 0 | 1
+----------+---+---+---+---+---+---
+ 0 | 0 0 | 0 1 | 0 1
+ 1 | 0 1 | 1 1 | 1 0
address@hidden verbatim
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+\centerline{
+\vbox{\bigskip % space above the table (about 1 linespace)
+% Because we have vertical rules, we can't let TeX insert interline space
+% in its usual way.
+\offinterlineskip
+\halign{\strut\hfil#\quad\hfil % operands
+ &\vrule#&\quad#\quad % rule, 0 (of and)
+ &\vrule#&\quad#\quad % rule, 1 (of and)
+ &\vrule# % rule between and and or
+ &\quad#\quad % 0 (of or)
+ &\vrule#&\quad#\quad % rule, 1 (of of)
+ &\vrule# % rule between or and xor
+ &\quad#\quad % 0 of xor
+ &\vrule#&\quad#\quad % rule, 1 of xor
+ \cr
+&\omit&\multispan{11}\hfil\bf Operatore booleano\hfil\cr
+\noalign{\smallskip}
+& &\multispan3\hfil AND\hfil&&\multispan3\hfil OR\hfil
+ &&\multispan3\hfil XOR\hfil\cr
+\bf Operandi&&0&&1&&0&&1&&0&&1\cr
+\noalign{\hrule}
+\omit&height 2pt&&\omit&&&&\omit&&&&\omit\cr
+\noalign{\hrule height0pt}% without this the rule does not extend; why?
+0&&0&\omit&0&&0&\omit&1&&0&\omit&1\cr
+1&&0&\omit&1&&1&\omit&1&&1&\omit&0\cr
+}}}
address@hidden tex
+
address@hidden
+<informaltable>
+
+<tgroup cols="7" colsep="1">
+<colspec colname="c1"/>
+<colspec colname="c2"/>
+<colspec colname="c3"/>
+<colspec colname="c4"/>
+<colspec colname="c5"/>
+<colspec colname="c6"/>
+<colspec colname="c7"/>
+<spanspec spanname="optitle" namest="c2" nameend="c7" align="center"/>
+<spanspec spanname="andspan" namest="c2" nameend="c3" align="center"/>
+<spanspec spanname="orspan" namest="c4" nameend="c5" align="center"/>
+<spanspec spanname="xorspan" namest="c6" nameend="c7" align="center"/>
+
+<tbody>
+<row>
+<entry colsep="0"></entry>
+<entry spanname="optitle"><emphasis role="bold">Operatore
booleano</emphasis></entry>
+</row>
+
+<row rowsep="1">
+<entry rowsep="0"></entry>
+<entry spanname="andspan">AND</entry>
+<entry spanname="orspan">OR</entry>
+<entry spanname="xorspan">XOR</entry>
+</row>
+
+<row rowsep="1">
+<entry ><emphasis role="bold">Operandi</emphasis></entry>
+<entry colsep="0">0</entry>
+<entry colsep="1">1</entry>
+<entry colsep="0">0</entry>
+<entry colsep="1">1</entry>
+<entry colsep="0">0</entry>
+<entry colsep="1">1</entry>
+</row>
+
+<row>
+<entry align="center">0</entry>
+<entry colsep="0">0</entry>
+<entry>0</entry>
+<entry colsep="0">0</entry>
+<entry>1</entry>
+<entry colsep="0">0</entry>
+<entry>1</entry>
+</row>
+
+<row>
+<entry align="center">1</entry>
+<entry colsep="0">0</entry>
+<entry>1</entry>
+<entry colsep="0">1</entry>
+<entry>1</entry>
+<entry colsep="0">1</entry>
+<entry>0</entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
address@hidden docbook
address@hidden float
+
address@hidden bit, complemento a livello di
address@hidden complemento a livello di bit
+Come si vede, il risultato di un'operazione di AND @`e 1 solo quando
address@hidden i bit sono 1.
+Il risultato di un'operazione di OR @`e 1 se @emph{almeno un} bit @`e 1.
+Il risultato di un'operazione di XOR @`e 1 se l'uno o l'altro
+bit @`e 1, ma non tutti e due.
+La successiva operazione @`e il @dfn{complemento}; il complemento di 1 @`e 0 e
+il complemento di 0 @`e 1. Quindi, quest'operazione ``inverte'' tutti i bit
+di un dato valore.
+
address@hidden bit, spostamento di
address@hidden spostamento a sinistra, bit a bit
address@hidden spostamento a destra, bit a bit
address@hidden spostamento, bit a bit
+Infine, due altre operazioni comuni consistono nello spostare i bit
+a sinistra o a destra.
+Per esempio, se si ha una stringa di bit @samp{10111001} e la si sposta
+a destra di tre bit, si ottiene @address@hidden esempio
+presuppone che degli zeri riempiano le posizioni a sinistra.
+Per @command{gawk}, @`e sempre
address@hidden@dotless{i}}, ma in alcuni linguaggi @`e possibile che le
posizioni a sinistra
+siano riempite con degli uno.}
+Partendo nuovamente da @samp{10111001} e spostandolo a sinistra di tre
+bit, si ottiene @samp{11001000}. La lista seguente descrive
+le funzioni predefinite di @command{gawk} che rendono disponibili
+le operazioni a livello di bit.
+I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @command{gawk}, operazioni a livello di bit in
address@hidden @code
address@hidden
address@hidden AND, operazione sui bit
address@hidden @code{and(address@hidden@code{,} @var{v2} address@hidden,}
@address@hidden)}
+Restituisce l'AND bit a bit degli argomenti.
+Gli argomenti devono essere almeno due.
+
address@hidden
address@hidden complemento a livello di bit
address@hidden @code{compl(@var{val})}
+Restituisce il complemento bit a bit di @var{val}.
+
address@hidden
address@hidden spostamento a sinistra
address@hidden @code{lshift(@var{val}, @var{contatore})}
+Restituisce il valore di @var{val}, spostato a sinistra di
address@hidden bit.
+
address@hidden
address@hidden OR, operazione sui bit
address@hidden @code{or(address@hidden@code{,} @var{v2} address@hidden,}
@address@hidden)}
+Restituisce l'OR bit a bit degli argomenti.
+Gli argomenti devono essere almeno due.
+
address@hidden
address@hidden spostamento a destra
address@hidden @code{rshift(@var{val}, @var{contatore})}
+Restituisce il valore di @var{val}, spostato a destra
+di @var{contatore} bit.
+
address@hidden
address@hidden XOR, operazione sui bit
address@hidden @code{xor(address@hidden@code{,} @var{v2} address@hidden,}
@address@hidden)}
+Restituisce il XOR bit a bit degli argomenti.
+Gli argomenti devono essere almeno due.
address@hidden table
+
address@hidden ATTENZIONE
+A partire dalla versione di @command{gawk} @value{PVERSION} 4.2, gli operandi
+negativi non sono consentiti per nessuna di queste funzioni. Un operando
+negativo produce un errore fatale. Si veda la nota a lato
+``Attenzione. Non @`e tutto oro quel che luccica!'' per maggiori informazioni
sul perch@'e.
address@hidden quotation
+
+Ecco una funzione definita dall'utente (@pxref{Funzioni definite dall'utente})
+che illustra l'uso di queste funzioni:
+
address@hidden @code{bits2str()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{bits2str()}
address@hidden @code{testbits.awk}, programma
address@hidden programma @code{testbits.awk}
address@hidden
address@hidden
address@hidden file eg/lib/bits2str.awk
+# bits2str --- decodifica un byte in una serie di 0/1 leggibili
+
+function bits2str(byte, dati, maschera)
address@hidden
+ if (byte == 0)
+ return "0"
+
+ maschera = 1
+ for (; byte != 0; stringa = rshift(stringa, 1))
+ dati = (and(byte, maschera) ? "1" : "0") dati
+
+ while ((length(dati) % 8) != 0)
+ dati = "0" dati
+
+ return dati
address@hidden
address@hidden endfile
address@hidden group
+
address@hidden this is a hack to make testbits.awk self-contained
address@hidden
address@hidden file eg/prog/testbits.awk
+# bits2str --- turn a byte into readable 1's and 0's
+
+function bits2str(bits, data, mask)
address@hidden
+ if (bits == 0)
+ return "0"
+
+ mask = 1
+ for (; bits != 0; bits = rshift(bits, 1))
+ data = (and(bits, mask) ? "1" : "0") data
+
+ while ((length(data) % 8) != 0)
+ data = "0" data
+
+ return data
address@hidden
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/testbits.awk
+BEGIN @{
+ printf "123 = %s\n", bits2str(123)
+ printf "0123 = %s\n", bits2str(0123)
+ printf "0x99 = %s\n", bits2str(0x99)
+ comp = compl(0x99)
+ printf "compl(0x99) = %#x = %s\n", comp, bits2str(comp)
+ shift = lshift(0x99, 2)
+ printf "lshift(0x99, 2) = %#x = %s\n", shift, bits2str(shift)
+ shift = rshift(0x99, 2)
+ printf "rshift(0x99, 2) = %#x = %s\n", shift, bits2str(shift)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Questo programma produce il seguente output quando viene eseguito:
+
address@hidden
+$ @kbd{gawk -f testbits.awk}
address@hidden 123 = 01111011
address@hidden 0123 = 01010011
address@hidden 0x99 = 10011001
address@hidden compl(0x99) = 0x3fffffffffff66 =
001111111111111111111111111111111
address@hidden 11111111111111101100110
address@hidden lshift(0x99, 2) = 0x264 = 0000001001100100
address@hidden rshift(0x99, 2) = 0x26 = 00100110
address@hidden example
+
address@hidden conversione da stringhe a numeri
address@hidden stringhe, conversione
address@hidden numeri, conversione in stringhe
address@hidden conversione da numeri a stringhe
address@hidden numero visto come stringa di bit
+La funzione @code{bits2str()} trasforma un numero binario in una stringa.
+Inizializzando @code{maschera} a uno otteniamo
+un valore binario in cui il bit address@hidden a destra @`e impostato a
+uno. Usando questa maschera,
+la funzione continua a controllare il bit address@hidden a destra.
+l'operazione di AND tra la maschera e il valore indica se il
+bit address@hidden a destra @`e uno oppure no. Se questo @`e il caso, un
@code{"1"}
address@hidden concatenato all'inizio della stringa.
+Altrimenti, @`e concatenato uno @code{"0"}.
+Il valore @`e quindi spostato a destra di un bit e il ciclo continua
+finch@'e non ci sono address@hidden bit.
+
+Se il valore iniziale @`e zero, viene restituito semplicemente uno @code{"0"}.
+Altrimenti, alla fine, al valore ottenuto vengono aggiunti degli zeri a
+sinistra, per arrivare a stringhe
+di lunghezza multipla di 8, ossia contenenti un numero intero di byte.
+Questo @`e tipico dei computer moderni.
+
+Il codice principale nella regola @code{BEGIN} mostra la differenza tra
+i valori decimale e ottale dello stesso numero.
+(@pxref{Numeri non-decimali}),
+e poi mostra i risultati delle funzioni
address@hidden()}, @code{lshift()} e @code{rshift()}.
+
address@hidden sidebar, Attenzione. Non @`e tutto oro quel che luccica!
address@hidden
address@hidden
+<sidebar><title>Attenzione. Non @`e tutto oro quel che luccica!</title>
address@hidden docbook
+
+
+In altri linguaggi, le operazioni "bit a bit" sono eseguite su valori interi,
+non su valori a virgola mobile. Come regola generale, tali operazioni
+funzionano meglio se eseguite su interi senza segno.
+
address@hidden tenta di trattare gli argomenti delle funzioni
+"bit a bit" come interi senza segno. Per questo motivo, gli argomenti negativi
+provocano un errore fatale.
+
+In una normale operazione, per tutte queste funzioni, prima il valore a virgola
+mobile a doppia precisione viene convertito nel tipo intero senza segno di C
address@hidden ampio, poi viene eseguita l'operazione "bit a bit". Se il
risultato non
address@hidden essere rappresentato esattamente come un tipo @code{double} di C,
+vengono rimossi i bit iniziali diversi da zero uno alla volta finch@'e
+non sono rappresentati esattamente. Il risultato @`e poi nuovamente convertito
+in un tipo @code{double} di address@hidden essere address@hidden chiari,
+la conseguenza @`e che @command{gawk} address@hidden memorizzare solo un
determinato
+intervallo di valori interi; i numeri al di fuori di questo intervallo vengono
+ridotti per rientrare all'interno dell'intervallo.}
+
+Comunque, quando si usa il calcolo con precisione arbitraria con l'opzione
address@hidden (@pxref{Calcolo con precisione arbitraria}), il risultato
address@hidden
+essere diverso. Questo @`e particolarmente evidente con la funzione
@code{compl()}:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print compl(42) @}'}
address@hidden 9007199254740949
+$ @kbd{gawk -M 'BEGIN @{ print compl(42) @}'}
address@hidden -43
address@hidden example
+
+Quel che avviene diventa chiaro quando si stampano i risultati
+in notazione esadecimale:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "%#x\n", compl(42) @}'}
address@hidden 0x1fffffffffffd5
+$ @kbd{gawk -M 'BEGIN @{ printf "%#x\n", compl(42) @}'}
address@hidden 0xffffffffffffffd5
address@hidden example
+
+Quando si usa l'opzione @option{-M}, nel dettaglio, @command{gawk} usa
+gli interi a precisione arbitraria di GNU MP che hanno almeno 64 bit di
precisione.
+Quando non si usa l'opzione @option{-M}, @command{gawk} memorizza i valori
+interi come regolari valori a virgola mobile con doppia precisione, che
+mantengono solo 53 bit di precisione. Inoltre, la libreria GNU MP tratta
+(o almeno sembra che tratti) il bit iniziale come un bit con segno;
address@hidden il
+risultato con @option{-M} in questo caso @`e un numero negativo.
+
+In breve, usare @command{gawk} per qualsiasi tipo di operazione "bit a bit",
+tranne le address@hidden semplici, probabilmente @`e una cattiva idea; caveat
emptor!
+
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Attenzione. Non @`e tutto oro quel che luccica!}
+
+
+
+In altri linguaggi, le operazioni "bit a bit" sono eseguite su valori interi,
+non su valori a virgola mobile. Come regola generale, tali operazioni
+funzionano meglio se eseguite su interi senza segno.
+
address@hidden tenta di trattare gli argomenti delle funzioni
+"bit a bit" come interi senza segno. Per questo motivo, gli argomenti negativi
+provocano un errore fatale.
+
+In una normale operazione, per tutte queste funzioni, prima il valore a virgola
+mobile a doppia precisione viene convertito nel tipo intero senza segno di C
address@hidden ampio, poi viene eseguita l'operazione "bit a bit". Se il
risultato non
address@hidden essere rappresentato esattamente come un tipo @code{double} di C,
+vengono rimossi i bit iniziali diversi da zero uno alla volta finch@'e
+non sono rappresentati esattamente. Il risultato @`e poi nuovamente convertito
+in un tipo @code{double} di address@hidden essere address@hidden chiari,
+la conseguenza @`e che @command{gawk} address@hidden memorizzare solo un
determinato
+intervallo di valori interi; i numeri al di fuori di questo intervallo vengono
+ridotti per rientrare all'interno dell'intervallo.}
+
+Comunque, quando si usa il calcolo con precisione arbitraria con l'opzione
address@hidden (@pxref{Calcolo con precisione arbitraria}), il risultato
address@hidden
+essere diverso. Questo @`e particolarmente evidente con la funzione
@code{compl()}:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print compl(42) @}'}
address@hidden 9007199254740949
+$ @kbd{gawk -M 'BEGIN @{ print compl(42) @}'}
address@hidden -43
address@hidden example
+
+Quel che avviene diventa chiaro quando si stampano i risultati
+in notazione esadecimale:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "%#x\n", compl(42) @}'}
address@hidden 0x1fffffffffffd5
+$ @kbd{gawk -M 'BEGIN @{ printf "%#x\n", compl(42) @}'}
address@hidden 0xffffffffffffffd5
address@hidden example
+
+Quando si usa l'opzione @option{-M}, nel dettaglio, @command{gawk} usa
+gli interi a precisione arbitraria di GNU MP che hanno almeno 64 bit di
precisione.
+Quando non si usa l'opzione @option{-M}, @command{gawk} memorizza i valori
+interi come regolari valori a virgola mobile con doppia precisione, che
+mantengono solo 53 bit di precisione. Inoltre, la libreria GNU MP tratta
+(o almeno sembra che tratti) il bit iniziale come un bit con segno;
address@hidden il
+risultato con @option{-M} in questo caso @`e un numero negativo.
+
+In breve, usare @command{gawk} per qualsiasi tipo di operazione "bit a bit",
+tranne le address@hidden semplici, probabilmente @`e una cattiva idea; caveat
emptor!
+
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Funzioni per i tipi
address@hidden Funzioni per conoscere il tipo di una variabile
+
address@hidden prevede due funzioni che permettono di conoscere
+il tipo di una variabile.
+Questo @`e necessario per scrivere del codice che visiti ogni elemento di un
+vettore di vettori
+(@pxref{Vettori di vettori}) e in altri contesti.
+
address@hidden @code
address@hidden
address@hidden scalare o vettore
address@hidden isarray(@var{x})
+Restituisce il valore 'vero' se @var{x} @`e un vettore. Altrimenti, restituisce
+'falso'.
+
address@hidden
address@hidden variabile, tipo di una
address@hidden tipo di una variabile
address@hidden typeof(@var{x})
+Restituisce una delle stringhe seguenti, a seconda del tipo di @var{x}:
+
address@hidden nested table
address@hidden @code
address@hidden "array"
address@hidden @`e un vettore.
+
address@hidden "regexp"
address@hidden @`e una @dfn{regexp} fortemente tipizzata
+(@pxref{Costanti @dfn{regexp} forti}).
+
address@hidden "number"
address@hidden @`e un numero.
+
address@hidden "string"
address@hidden @`e una stringa.
+
address@hidden "strnum"
address@hidden @`e un numero che ha avuto origine da un input dell'utente,
+come un campo o il risultato di una chiamata a @code{split()}.
+(address@hidden, @var{x} ha l'attributo @dfn{strnum};
address@hidden di variabile}.)
+
address@hidden "unassigned"
address@hidden @`e una variabile scalare a cui non @`e ancora stato assegnato
un valore.
+Per esempio:
+
address@hidden
+BEGIN @{
+ # crea a[1] ma non gli attribuisce alcun valore
+ a[1]
+ print typeof(a[1]) # unassigned
address@hidden
address@hidden example
+
address@hidden "untyped"
address@hidden non @`e stata usata per nulla; address@hidden diventare uno
scalare o un
+vettore.
+Per esempio:
+
address@hidden
+BEGIN @{
+ print typeof(x) # x non @`e mai stato usato --> untyped
+ mk_arr(x)
+ print typeof(x) # x ora @`e un vettore --> array
address@hidden
+
+function mk_arr(a) @{ a[1] = 1 @}
address@hidden example
+
address@hidden table
address@hidden table
+
address@hidden()} torna utile in due occasioni. La prima @`e quando
+si visita un vettore multidimensionale: si address@hidden stabilire se un
elemento @`e
+un vettore oppure no. La seconda @`e all'interno del corpo di una funzione
+definita dall'utente (argomento non ancora trattato;
address@hidden definite dall'utente}), per determinare se un parametro
address@hidden un vettore oppure no.
+
address@hidden NOTA
+Usare @code{isarray()} a livello globale per controllare le variabili
+non ha alcun senso. Si suppone infatti che chi scrive il programma
+sappia se una variabile @`e un vettore oppure no. E in
+effetti, per come funziona @command{gawk}, se si passa una variabile
+che non sia stata usata in precedenza a @code{isarray()}, @command{gawk}
+la crea al volo, assegnandole il tipo scalare.
address@hidden quotation
+
+La funzione @code{typeof()} @`e generale; consente di determinare
+se una variabile o un parametro di funzione @`e uno scalare, un vettore,
+o una @dfn{regexp} fortemente tipizzata.
+
+L'uso di @code{isarray()} @`e deprecato; si dovrebbe usare @code{typeof()}
+al suo posto. Si dovrebbe sostituire ogni uso esistente di
address@hidden(var)} nei programmi esistenti con
address@hidden(var) == "array"}.
+
address@hidden Funzioni di internazionalizzazione
address@hidden Funzioni per tradurre stringhe
address@hidden @command{gawk}, funzioni di traduzione di stringhe
address@hidden funzioni di traduzione di stringhe
address@hidden traduzione di stringhe, funzioni di
address@hidden internazionalizzazione
address@hidden programmi @command{awk}, internazionalizzare
+
address@hidden prevede strumenti per internazionalizzare i programmi
address@hidden
+Questi sono costituiti dalle funzioni descritte nella lista seguente.
+Le descrizioni sono volutamente concise.
address@hidden,
+per un'esposizione completa.
+I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @asis
address@hidden
address@hidden impostare directory con catalogo messaggi tradotti
address@hidden messaggi tradotti, impostare directory con catalogo
address@hidden @code{bindtextdomain(@var{directory}} address@hidden,}
@address@hidden)}
+Imposta la directory in cui
address@hidden trova i file di traduzione dei messaggi, nel caso in cui
+non siano o non possano essere messi nelle directory ``standard''
+(p.es., durante la fase di test di un programma).
+Restituisce la directory alla quale @var{dominio} @`e ``connesso.''
+
+Il default per @var{dominio} @`e il valore di @code{TEXTDOMAIN}.
+Se @var{directory} @`e la stringa nulla (@code{""}),
address@hidden()} restituisce la connessione corrente per il
address@hidden dato.
+
address@hidden
address@hidden traduzione di stringhe
address@hidden @code{dcgettext(@var{stringa}} address@hidden,} @var{dominio}
address@hidden,} @var{categoria}] address@hidden)}
+Restituisce la traduzione di @var{stringa} nel
+dominio linguistico @var{dominio} per la categoria di localizzazione
address@hidden
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
+
address@hidden
address@hidden @code{dcngettext(@var{stringa1}, @var{stringa2}, @var{numero}}
address@hidden,} @var{dominio} address@hidden,} @var{categoria}]
address@hidden)}
+Restituisce la forma plurale usata per @var{numero} nella
+traduzione di @var{stringa1} e @var{stringa2} nel dominio di testo
address@hidden per la categoria di localizzazione @var{categoria}.
address@hidden @`e la variante al singolare in inglese di un messaggio e
address@hidden @`e la variante al plurare in inglese dello stesso messaggio.
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
address@hidden table
+
address@hidden Funzioni definite dall'utente
address@hidden Funzioni definite dall'utente
+
address@hidden funzioni definite dall'utente
address@hidden utente, funzioni definite dall'
+Programmi @command{awk} complessi spesso possono essere semplificati
+definendo delle apposite funzioni personali.
+Le funzioni definite dall'utente sono richiamate allo stesso modo di quelle
+predefinite
+(@pxref{Chiamate di funzione}),
+ma dipende dall'utente la loro definizione
+(address@hidden, dire ad @command{awk} cosa dovrebbero fare queste funzioni).
+
address@hidden
+* Sintassi delle definizioni:: Come scrivere definizioni e cosa
+ significano.
+* Esempio di funzione:: Un esempio di definizione di
+ funzione e spiegazione della stessa.
+* Precisazioni sulle funzioni:: Cose a cui prestare attenzione.
+* Istruzione return:: Specificare il valore che una
+ funzione restituisce.
+* Variabili di tipo dinamico:: Come cambiare tipo a una variabile in
+ fase di esecuzione del programma.
address@hidden menu
+
address@hidden Sintassi delle definizioni
address@hidden Come scrivere definizioni e cosa significano
+
address@hidden
address@hidden al vero affermare che la sintassi di awk per la definizione
+di variabili locali @`e semplicemente atroce.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden funzioni, definizione di
address@hidden definizione di funzioni
+Definizioni di funzioni possono stare in una posizione qualsiasi tra le regole
+di un programma @command{awk}. Quindi, la forma generale di un
+programma @command{awk} @`e estesa per
+permettere l'inclusione di regole @emph{e} la definizione di funzioni
+create dall'utente.
+Non @`e necessario che la definizione di una funzione sia posta prima
+del richiamo della stessa. Questo dipende dal fatto che @command{awk}
+legge l'intero programma, prima di iniziare ad eseguirlo.
+
+La definizione di una funzione chiamata @var{nome} @`e simile a questa:
+
address@hidden
address@hidden @address@hidden(address@hidden@code{)}
address@hidden@{}
+ @var{corpo-della-funzione}
address@hidden@}}
address@hidden display
+
address@hidden nomi di funzione
address@hidden funzioni, nomi di
address@hidden limitazioni nei nomi di funzione
address@hidden nomi di funzione, limitazioni nei
address@hidden
+Qui, @var{nome} @`e il nome della funzione da definire. Un nome di funzione
+valido @`e come un nome di variabile valido: una sequenza di
+lettere, cifre e trattini bassi che non inizia con una cifra.
+Anche qui, solo le 52 lettere inglesi maiuscole e minuscole possono
+essere usate in un nome di funzione.
+All'interno di un singolo programma @command{awk}, un dato nome address@hidden
essere
+usato una sola volta: per una variabile, o per un vettore,
+o per una funzione.
+
address@hidden @`e una lista opzionale degli argomenti della funzione
+e dei nomi delle variabili locali,
+separati da virgole. Quando la funzione viene chiamata,
+i nomi degli argomenti sono usati per contenere il valore degli argomenti
+passati con la chiamata.
+
+Una funzione non address@hidden avere due parametri con lo stesso nome, e
neanche un
+parametro con lo stesso nome della funzione stessa.
+
address@hidden ATTENZIONE
+Secondo lo standard POSIX, i parametri di funzione
+non possono avere lo stesso nome di una delle speciali variabili predefinite
+(@pxref{Variabili predefinite}), e un parametro di funzione non address@hidden
avere
+lo stesso nome di un'altra funzione.
+Non tutte le versioni di @command{awk} applicano queste limitazioni.
address@hidden applica solo la prima di queste restrizioni.
+Se viene specificata l'opzione @option{--posix} (@pxref{Opzioni}),
+anche la seconda restrizione viene applicata.
address@hidden quotation
+
+Le variabili locali si comportano come la stringa vuota
+se vengono utilizzate dove @`e richiesto il valore di una stringa,
+e valgono zero se utilizzate dove @`e richiesto un valore numerico.
+Questo @`e lo stesso comportamento delle variabili regolari a cui non sia
+stato ancora assegnato un valore. (Ci sono ulteriori informazioni riguardo
+alle variabili locali;
address@hidden di tipo dinamico}.)
+
+Il @var{corpo-della-funzione} @`e composto da istruzioni @command{awk}.
+Questa @`e la parte address@hidden importante della definizione, perch@'e dice
quello che
+la funzione dovrebbe realmente
address@hidden I nomi di argomento esistono per consentire al corpo della
+funzione di gestire gli argomenti;
+le variabili locali esistono per consentire al corpo della funzione di
+memorizzare dei valori temporanei.
+
+I nomi di argomento non sono sintatticamente distinti da quelli delle
+variabili locali. Invece, il numero di argomenti forniti quando la
+funzione viene chiamata determina quanti degli argomenti passati sono delle
+variabili. Quindi, se tre valori di argomento sono specificati, i primi
+tre nomi in @var{lista-parametri}
+sono degli argomenti e i rimanenti sono delle variabili locali.
+
+Ne consegue che se il numero di argomenti richiesto non @`e lo stesso in
+tutte le chiamate alla funzione, alcuni dei nomi in @var{lista-parametri}
+possono essere in alcuni casi degli argomenti e in altri casi
+delle variabili locali. Un'altra angolatura da cui guardare questo fatto
address@hidden che gli argomenti omessi assumono come valore di default la
stringa nulla.
+
address@hidden convenzioni di programmazione, nella scrittura di funzioni
address@hidden funzioni, convenzioni di programmazione, nella scrittura di
+Solitamente, quando si scrive una funzione, si sa quanti nomi si intendono
+usare per gli argomenti e quanti si vogliono usare come variabili locali.
address@hidden una convenzione in uso quella di aggiungere alcuni spazi extra
tra gli
+argomenti e le variabili locali, per documentare come va utilizzata quella
+funzione.
+
address@hidden variabili nascoste
address@hidden nascondere valori di variabile
+Durante l'esecuzione del corpo della funzione, gli argomenti e i valori
+delle variabili locali
+nascondono, o @dfn{oscurano}, qualsiasi variabile dello stesso nome usata
+nel resto del programma. Le variabili oscurate non sono accessibili
+nel corpo della funzione, perch@'e non c'@`e modo di accedere a esse
+mentre i loro nomi sono stati "occupati" dagli argomenti e dalla variabili
+locali. Tutte le altre variabili usate nel programma @command{awk}
+possono essere accedute o impostate normalmente nel corpo della funzione.
+
+Gli argomenti e le variabili locali esistono solo finch@'e il corpo della
+funzione @`e in esecuzione. Una volta che l'esecuzione @`e terminata,
+ritornano accessibili le variabili che erano oscurate
+durante l'esecuzione della funzione.
+
address@hidden ricorsive, funzioni
address@hidden funzioni ricorsive
+Il corpo della funzione address@hidden contenere espressioni che chiamano altre
+funzioni. Tali espressioni possono perfino chiamare direttamente, o
+indirettamente tramite un'altra funzione, la funzione stessa.
+Quando questo succede, la funzione @`e detta @dfn{ricorsiva}.
+Il fatto che una funzione richiami se stessa @`e detto @dfn{ricorsione}.
+
+Tutte le funzioni predefinite restituiscono un valore al loro chiamante.
+Anche le funzioni definite dall'utente possono farlo, usando
+l'istruzione @code{return},
+che @`e descritta in dettaglio nella @ref{Istruzione return}.
+Molti dei successivi esempi in questa @value{SECTION} usano
+l'istruzione @code{return}.
+
address@hidden estensioni comuni, parola chiave @code{func}
address@hidden @cindex @command{awk} language, POSIX version
address@hidden @cindex POSIX @command{awk}
address@hidden POSIX @command{awk}, parola chiave @code{function} in
+In molte implementazioni di @command{awk}, compreso @command{gawk},
+la parola chiave @code{function} address@hidden essere
+abbreviata come @code{func}. @value{COMMONEXT}
+Tuttavia, POSIX specifica solo l'uso della parola chiave
address@hidden Questo ha alcune implicazioni di carattere pratico.
+Se @command{gawk} @`e in address@hidden POSIX-compatibile
+(@pxref{Opzioni}), la seguente
+istruzione @emph{non} definisce una funzione:
+
address@hidden
+func foo() @{ a = sqrt($1) ; print a @}
address@hidden example
+
address@hidden
+Invece, definisce una regola che, per ogni record, concatena il valore
+della variabile @samp{func} con il valore restituito dalla funzione @samp{foo}.
+Se la stringa risultante @`e diversa dalla stringa nulla, l'azione viene
eseguita.
+Questo non @`e con ogni address@hidden quello che si desidera.
+(@command{awk} accetta questo input come
+sintatticamente valido, perch@'e le funzioni, nei programmi @command{awk}
+possono essere usate prima che siano state address@hidden
+programma in address@hidden non address@hidden eseguito, perch@'e @code{foo()}
address@hidden
+essere una funzione non definita.})
+
address@hidden address@hidden, nella definizione di funzioni
+Per essere certi che un programma @command{awk} sia portabile,
+va sempre usata la parola chiave
address@hidden per definire una funzione.
+
address@hidden Esempio di funzione
address@hidden Un esempio di definizione di funzione
address@hidden esempio di definizione di funzione
address@hidden funzione, esempio di definizione di
+
+
+Ecco un esempio di funzione definita dall'utente, di nome
address@hidden()}, che
+ha come input un numero e lo stampa in un formato specifico:
+
address@hidden
+function stampa_num(numero)
address@hidden
+ printf "%6.3g\n", numero
address@hidden
address@hidden example
+
address@hidden
+Per comprenderne il funzionamento, ecco una regola @command{awk} che usa
+la funzione @code{stampa_num()}:
+
address@hidden
+$3 > 0 @{ stampa_num($3) @}
address@hidden example
+
address@hidden
+Questo programma stampa, nel nostro formato speciale, tutti i terzi campi
+nei record in input che
+contengono un numero positivo. Quindi, dato il seguente input:
+
address@hidden
+ 1.2 3.4 5.6 7.8
+ 9.10 11.12 -13.14 15.16
+17.18 19.20 21.22 23.24
address@hidden example
+
address@hidden
+questo programma, usando la nostra funzione per formattare i risultati, stampa:
+
address@hidden
+ 5.6
+ 21.2
address@hidden example
+
+La funzione seguente cancella tutti gli elementi in un vettore
+(si ricordi che gli spazi bianchi in soprannumero stanno a indicare
+l'inizio della lista delle variabili locali):
+
address@hidden
+function cancella_vettore(a, i)
address@hidden
+ for (i in a)
+ delete a[i]
address@hidden
address@hidden example
+
+Quando si lavora con vettori, @`e spesso necessario cancellare
+tutti gli elementi in un vettore e ripartire con una nuova lista di elementi
+(@pxref{Cancellazione}).
+Invece di dover ripetere
+questo ciclo ogni volta che si deve cancellare
+un vettore, un programma address@hidden limitarsi a effettuare una chiamata
+a @code{cancella_vettore()}.
+(Questo garantisce la address@hidden L'uso di @samp{delete @var{vettore}}
+per cancellare
+il contenuto di un intero vettore @`e un'aggiunta relativamente
address@hidden la fine del 2012.}
+allo standard POSIX.)
+
+Quello che segue @`e un esempio di una funzione ricorsiva. Prende come
+parametro di input una stringa e restituisce la stringa in ordine inverso.
+Le funzioni ricorsive devono sempre avere un test che interrompa la
+ricorsione.
+In questo caso, la ricorsione termina quando la stringa in input @`e
address@hidden vuota:
+
address@hidden 8/2014: Thanks to Mike Brennan for the improved formulation
address@hidden @code{rev()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{rev()}
address@hidden
+function rev(stringa)
address@hidden
+ if (stringa == "")
+ return ""
+
+ return (rev(substr(stringa, 2)) substr(stringa, 1, 1))
address@hidden
address@hidden example
+
+Se questa funzione @`e in un file di nome @file{rev.awk}, si address@hidden
provare
address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{echo "Non v'allarmate!" |}
+> @kbd{gawk -e '@{ print rev($0) @}' -f rev.awk}
address@hidden !etamralla'v noN
address@hidden example
+
+La funzione C @code{ctime()} prende una marcatura temporale e la restituisce
+come una stringa,
+formattata come address@hidden sappiamo.
+Il seguente esempio usa la funzione predefinita @code{strftime()}
+(@pxref{Funzioni di tempo})
+per creare una versione @command{awk} di @code{ctime()}:
+
address@hidden @code{ctime()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{ctime()}
address@hidden
address@hidden file eg/lib/ctime.awk
+# ctime.awk
+#
+# versione awk della funzione C ctime(3)
+
+function ctime(ts, format)
address@hidden
+ format = "%a %e %b %Y, %H.%M.%S, %Z"
+
+ if (ts == 0)
+ ts = systime() # usare data e ora correnti per default
+ return strftime(format, ts)
address@hidden
address@hidden endfile
address@hidden example
+
+Si potrebbe pensare che la funzione @code{ctime()} possa usare
address@hidden"strftime"]}
+come stringa di formato. Sarebbe un errore, perch@'e si suppone che
address@hidden()} restituisca data e ora formattati in maniera standard,
+e qualche codice a livello utente potrebbe aver modificato in precedenza
address@hidden"strftime"]}.
+
address@hidden Precisazioni sulle funzioni
address@hidden Chiamare funzioni definite dall'utente
+
address@hidden funzioni definite dall'utente, chiamare
address@hidden chiamare funzioni definite dall'utente
address@hidden una funzione} significa richiedere l'esecuzione di una
+funzione, la quale svolge il compito per cui @`e stata scritta.
+La chiamata di una funzione @`e un'espressione e il suo valore @`e quello
+restituito dalla funzione.
+
address@hidden
+* Chiamare una funzione:: Non usare spazi.
+* Campo di address@hidden variabili:: Variabili locali e globali.
+* Parametri per valore/riferimento:: Passaggio parametri.
address@hidden menu
+
address@hidden Chiamare una funzione
address@hidden Scrivere una chiamata di funzione
+
+Una chiamata di funzione consiste nel nome della funzione seguito dagli
+argomenti racchiusi tra parentesi. Gli argomenti specificati nella chiamata
+sono costituiti da espressioni @command{awk}. Ogni volta che si esegue una
+chiamata queste espressioni vengono ricalcolate, e i loro valori diventano gli
+argomenti passati alla funzione. Per esempio, ecco una chiamata a
address@hidden()} con tre argomenti (il primo dei quali @`e una concatenazione
di
+stringhe):
+
address@hidden
+pippo(x y, "perdere", 4 * z)
address@hidden example
+
address@hidden ATTENZIONE
+Caratteri bianchi (spazi e TAB) non sono permessi tra il nome della funzione e
+la parentesi aperta che apre la lista degli argomenti. Se per errore si
+lasciano dei caratteri bianchi, @command{awk} li interpreterebbe come se
+s'intendesse concatenare una variabile con un'espressione tra parentesi.
+Tuttavia, poich@'e si @`e usato un nome di funzione e non un nome di variabile,
+verrebbe emesso un messaggio di errore.
address@hidden quotation
+
address@hidden Campo di address@hidden variabili
address@hidden Variabili locali e globali.
+
address@hidden variabili locali, in una funzione
address@hidden locali, variabili, per una funzione
+Diversamente da molti altri linguaggi, non c'@`e modo di
+rendere locale una variabile in un blocco @address@hidden @dots{}
@address@hidden di
address@hidden, ma si address@hidden rendere locale una variabile di una
funzione. @`E
+buona norma farlo quando una variabile serve solo all'interno di quella
+particolare funzione.
+
+Per rendere locale una variabile per una funzione, basta dichiarare la
+variabile come argomento della funzione dopo gli argomenti richiesti dalla
+funzione (@pxref{Sintassi delle definizioni}). Si consideri il seguente
+esempio, dove la variabile @code{i} @`e una variabile globale usata sia dalla
+funzione @code{pippo()} che dalla funzione @code{pluto()}:
+
address@hidden
+function pluto()
address@hidden
+ for (i = 0; i < 3; i++)
+ print "in pluto i=" i
address@hidden
+
+function pippo(j)
address@hidden
+ i = j + 1
+ print "in pippo i=" i
+ pluto()
+ print "in pippo i=" i
address@hidden
+
+BEGIN @{
+ i = 10
+ print "in BEGIN i=" i
+ pippo(0)
+ print "in BEGIN i=" i
address@hidden
address@hidden example
+
+L'esecuzione di questo script produce quanto segue, perch@'e la stessa
+variabile @code{i} @`e usata sia nelle
+funzioni @code{pippo()} e @code{pluto()} sia a livello della
+regola @code{BEGIN}:
+
address@hidden
+in BEGIN i=10
+in pippo i=1
+in pluto i=0
+in pluto i=1
+in pluto i=2
+in pippo i=3
+in BEGIN i=3
address@hidden example
+
+Se si vuole che @code{i} sia una variabile locale sia per
address@hidden()} che per @code{pluto()}, occorre procedere in questo modo
+(gli spazi extra prima della @code{i} sono una convenzione di codifica
+che serve a ricordare che @code{i} @`e una variabile locale, non
+un argomento):
+
address@hidden
+function pluto( i)
address@hidden
+ for (i = 0; i < 3; i++)
+ print "in pluto i=" i
address@hidden
+
+function pippo(j, i)
address@hidden
+ i = j + 1
+ print "in pippo i=" i
+ pluto()
+ print "in pippo i=" i
address@hidden
+
+BEGIN @{
+ i = 10
+ print "in BEGIN i=" i
+ pippo(0)
+ print "in BEGIN i=" i
address@hidden
address@hidden example
+
+L'esecuzione della versione corretta dello script produce il seguente
+output:
+
address@hidden
+in BEGIN i=10
+in pippo i=1
+in pluto i=0
+in pluto i=1
+in pluto i=2
+in pippo i=1
+in BEGIN i=10
address@hidden example
+
+Oltre a valori scalari (stringhe e numeri), si possono usare anche
+vettori locali. Usando come parametro il nome di un vettore, @command{awk}
+lo considera come tale, e lo tratta come locale alla funzione.
+Inoltre, chiamate ricorsive creano nuovi vettori.
+Si consideri questo esempio:
+
address@hidden
+function qualche_funz(p1, a)
address@hidden
+ if (p1++ > 3)
+ return
+
+ a[p1] = p1
+
+ qualche_funz(p1)
+
+ printf("Al livello %d, indice %d %s trova in a\n",
+ p1, (p1 - 1), (p1 - 1) in a ? "si" : "non si")
+ printf("Al livello %d, indice %d %s trova in a\n",
+ p1, p1, p1 in a ? "si" : "non si")
+ print ""
address@hidden
+
+BEGIN @{
+ qualche_funz(1)
address@hidden
address@hidden example
+
+Quando viene eseguito, questo programma produce il seguente output:
+
address@hidden
+Al livello 4, indice 3 non si trova in a
+Al livello 4, indice 4 si trova in a
+
+Al livello 3, indice 2 non si trova in a
+Al livello 3, indice 3 si trova in a
+
+Al livello 2, indice 1 non si trova in a
+Al livello 2, indice 2 si trova in a
address@hidden example
+
address@hidden Parametri per valore/riferimento
address@hidden Passare parametri di funzione per valore o per riferimento
+
+In @command{awk}, quando si definisce una funzione, non c'@`e modo di
+dichiarare esplicitamente se gli argomenti sono passati @dfn{per valore}
+o @dfn{per riferimento}.
+
+Invece, il modo con cui i parametri sono passati @`e determinato
+durante l'esecuzione del programma,
+quando la funzione @`e chiamata, nel rispetto della regola seguente:
+se l'argomento @`e una variabile di tipo vettoriale, questa @`e passata
+per riferimento. Altrimenti, l'argomento @`e passato per valore.
+
address@hidden chiamare per valore
+Passare un argomento per valore significa che quando una funzione @`e chiamata,
+le viene fornita una @emph{copia} del valore di quell'argomento. Il chiamante
address@hidden usare una variabile il cui valore calcolato viene passato come
argomento, ma la
+funzione chiamata non la riconosce come variabile; riconosce solo il valore
+assunto dall'argomento. Per esempio, scrivendo il seguente codice:
+
address@hidden
+pippo = "pluto"
+z = mia_funzione(pippo)
address@hidden example
+
address@hidden
+non si deve pensare che l'argomento passato a @code{mia_funzione()} sia ``la
+variabile @code{pippo}.'' Invece, @`e corretto considerare l'argomento come la
+stringa il cui valore @`e @code{"pluto"}.
+Se la funzione @code{mia_funzione()} altera i valori delle sue variabili
+locali, address@hidden non influisce su nessun'altra variabile. Quindi, se
address@hidden()} fa questo:
+
address@hidden
+function mia_funzione(stringa)
address@hidden
+ print stringa
+ stringa = "zzz"
+ print stringa
address@hidden
address@hidden example
+
address@hidden
+cambiando address@hidden@dotless{i}} il valore della variabile che @`e il suo
primo argomento, ossia
address@hidden, il valore di @code{pippo} per il chiamante @emph{non} viene
+modificato. Il ruolo svolto da @code{pippo} nella chiamata di
address@hidden()} termina quando il suo valore (@code{"pluto"}) viene
+calcolato. Se la variabile @code{stringa} esiste anche al di fuori di
address@hidden()}, il corpo della funzione non address@hidden modificare questo
valore
+esterno, perch@'e esso rimane oscurato durante l'esecuzione di
address@hidden()} e non address@hidden quindi essere visto o modificato.
+
address@hidden chiamare per riferimento
address@hidden vettori, come parametri di funzione
address@hidden funzioni, vettori come parametri di
+Tuttavia, quando sono dei vettori a fungere da parametri alle funzioni, questi
address@hidden vengono copiati. Invece, il vettore stesso @`e reso disponibile
per
+essere manipolato direttamente dalla funzione. Questo @`e quel che si dice
+solitamente una @dfn{chiamata per riferimento}. Le modifiche effettuate su un
+vettore passato come parametro all'interno del corpo di una funzione
address@hidden visibili all'esterno della funzione.
+
address@hidden NOTA
+Modificare un vettore passato come parametro all'interno di una funzione
address@hidden essere molto pericoloso se non si sta attenti a quel che si sta
facendo.
+Per esempio:
+
address@hidden
+function cambialo(vettore, ind, nvalore)
address@hidden
+ vettore[ind] = nvalore
address@hidden
+
+BEGIN @{
+ a[1] = 1; a[2] = 2; a[3] = 3
+ cambialo(a, 2, "due")
+ printf "a[1] = %s, a[2] = %s, a[3] = %s\n",
+ a[1], a[2], a[3]
address@hidden
address@hidden example
+
address@hidden
+stampa @samp{a[1] = 1, a[2] = due, a[3] = 3}, perch@'e
address@hidden()} memorizza @code{"due"} nel secondo elemento di @code{a}.
address@hidden quotation
+
address@hidden indefinite, funzioni
address@hidden funzioni indefinite
+Alcune implementazioni di @command{awk} consentono di chiamare una
+funzione che non @`e stata definita.
+Viene solo emesso un messaggio che descrive il problema al momento
+dell'esecuzione, se il programma tenta di chiamare quella funzione.
+Per esempio:
+
address@hidden
+BEGIN @{
+ if (0)
+ pippo()
+ else
+ pluto()
address@hidden
+function pluto() @{ @dots{} @}
+# si noti che `pippo' non @`e definito
address@hidden example
+
address@hidden
+Poich@'e la condizione dell'istruzione @samp{if} non address@hidden mai
verificata
+in questo caso,
+non @`e un problema reale il fatto che
+che @code{pippo()} non sia stato definito. Solitamente, tuttavia,
address@hidden un problema se un programma chiama una funzione indefinita.
+
address@hidden @dfn{lint}, controlli, funzione indefinita
address@hidden controlli @dfn{lint} per funzione indefinita
address@hidden funzione indefinita, controlli @dfn{lint} per
+
+Se si specifica l'opzione @option{--lint}
+(@pxref{Opzioni}),
address@hidden elenca le chiamate a funzioni indefinite.
+
address@hidden address@hidden, istruzione @code{next} in funzioni definite
dall'utente
address@hidden @code{next}, istruzione, in funzioni definite dall'utente
+Alcune implementazione di @command{awk} emettono un messaggio di errore
+se si usa l'istruzione @code{next}
+o @code{nextfile}
+(@pxref{Istruzione next}, e
address@hidden
address@hidden nextfile})
address@hidden ifdocbook
address@hidden
address@hidden nextfile})
address@hidden ifnotdocbook
+all'interno di una funzione definita dall'utente.
address@hidden non ha questa limitazione.
+
address@hidden Istruzione return
address@hidden L'istruzione @code{return}
address@hidden @code{return}, address@hidden in funzioni definite dall'utente
address@hidden istruzione @address@hidden in funzioni definite dall'utente
+
+Come visto in parecchi esempi precedenti,
+il corpo di una funzione definita dall'utente address@hidden contenere
un'istruzione
address@hidden
+Quest'istruzione restituisce il controllo a quella parte del
+del programma @command{awk} che ha effettuato la chiamata.
address@hidden anche essere usata per restituire un valore da usare nel resto
del
+programma @command{awk}.
+Questo @`e un esempio:
+
address@hidden
address@hidden address@hidden
address@hidden display
+
+La parte @var{espressione} @`e facoltativa.
+Probabilmente per una svista, POSIX non definisce qual @`e il valore
+restituito, se si omette @var{espressione}. Tecnicamente parlando, questo
+rende il valore restituito indefinito, e quindi, indeterminato.
+In pratica, tuttavia, tutte le versioni di @command{awk} restituiscono
+semplicemente la stringa nulla, che vale zero se usata
+in un contesto che richiede un numero.
+
+Un'istruzione @code{return} senza una @var{espressione} @`e considerata
presente
+alla fine di ogni definizione di funzione.
+Quindi, se il flusso di esecuzione raggiunge la fine del corpo della
+funzione, tecnicamente la funzione
+restituisce un valore indeterminato.
+In pratica, restituisce la stringa nulla. @command{awk}
address@hidden emette alcun messaggio di avvertimento se si usa
+il valore restituito di una tale funzione.
+
+Talvolta address@hidden capitare di scrivere una funzione per quello che fa,
non per
+quello che restituisce. Una tale funzione corrisponde a una funzione
address@hidden in C, C++, o Java, o a una @code{procedure} in Ada.
+Quindi, address@hidden essere corretto non
+restituire alcun valore; basta fare attenzione a non usare poi il
+valore restituito da una tale funzione.
+
+Quello che segue @`e un esempio di una funzione definita dall'utente
+che restituisce un valore che @`e
+il numero address@hidden alto presente tra gli elementi di un vettore:
+
address@hidden
+function massimo(vettore, i, max)
address@hidden
+ for (i in vettore) @{
+ if (max == "" || vettore[i] > max)
+ max = vettore[i]
+ @}
+ return max
address@hidden
address@hidden example
+
address@hidden programmazione, convenzioni di, parametri di funzione
address@hidden convenzioni di programmazione, parametri di funzione
address@hidden
+La chiamata a @code{massimo()} ha un solo argomento, che @`e il nome di
+un vettore. Le variabili locali @code{i} e @code{max} non vanno intese
+come argomenti; nulla vieta di passare address@hidden di un argomento
+a @code{massimo()} ma i risultati sarebbero strani. Gli spazi extra prima
+di @code{i} nella lista dei parametri della funzione indicano che @code{i} e
address@hidden sono variabili locali.
address@hidden consigliabile seguire questa convenzione quando si definiscono
delle funzioni.
+
+Il programma seguente usa la funzione @code{massimo()}. Carica un vettore,
+richiama @code{massimo()}, e quindi elenca il numero massimo contenuto in
+quel vettore:
+
address@hidden
+function massimo(vettore, i, max)
address@hidden
+ for (i in vettore) @{
+ if (max == "" || vettore[i] > max)
+ max = vettore[i]
+ @}
+ return max
address@hidden
+
+# Carica tutti i campi di ogni record in numeri.
address@hidden
+ for (i = 1; i <= NF; i++)
+ numeri[NR, i] = $i
address@hidden
+
+END @{
+ print massimo(numeri)
address@hidden
address@hidden example
+
+Dato il seguente input:
+
address@hidden
+ 1 5 23 8 16
+44 3 5 2 8 26
+256 291 1396 2962 100
+-6 467 998 1101
+99385 11 0 225
address@hidden example
+
address@hidden
+il programma trova (come si address@hidden immaginare) che 99.385 @`e il
+valore address@hidden alto contenuto nel vettore.
+
address@hidden Variabili di tipo dinamico
address@hidden Funzioni e loro effetti sul tipo di una variabile
+
address@hidden @`e un linguaggio molto fluido.
address@hidden possible che @command{awk} non sia in grado di stabilire se un
+identificativo rappresenta una variabile scalare o un vettore,
+prima dell'effettiva esecuzione di un programma.
+Ecco un esempio di programma commentato:
+
address@hidden
+function pippo(a)
address@hidden
+ a[1] = 1 # il parametro @`e un vettore
address@hidden
+
+BEGIN @{
+ b = 1
+ pippo(b) # non valido: errore fatale, tipi variabile in conflitto
+
+ pippo(x) # x non inizializzato, diventa un vettore dinamicamente
+ x = 1 # a questo punto, non permesso: errore in esecuzione
address@hidden
address@hidden example
+
+In questo esempio, la prima chiamata a @code{pippo()} genera
+un errore fatale, quindi @command{awk} non address@hidden a segnalare il
secondo
+errore. Se si commenta la prima chiamata e si riesegue il
+programma, a quel punto @command{awk} address@hidden con un messaggio
+relativo al secondo errore.
+Solitamente queste cose non causano grossi problemi, ma @`e bene
+esserne a conoscenza.
+
address@hidden Chiamate indirette
address@hidden Chiamate indirette di funzione
+
address@hidden indiretta, chiamata di funzione
address@hidden chiamata indiretta di funzione
address@hidden funzione, puntatori a
address@hidden puntatori a funzioni
address@hidden differenze tra @command{awk} e @command{gawk}, chiamata
indiretta di funzione
+
+Questa sezione descrive un'estensione avanzata, specifica di @command{gawk}.
+
+Spesso address@hidden essere utile ritardare la scelta della funzione da
chiamare
+fino al momento in cui il programma viene eseguito.
+Per esempio, potrebbero esserci diversi tipi di record in input, ciascuno
+dei quali dovrebbe essere elaborato in maniera differente.
+
+Solitamente, si userebbe una serie di istruzioni @address@hidden
+per decidere quale funzione chiamare. Usando la chiamata @dfn{indiretta}
+a una funzione, si address@hidden assegnare il nome della funzione da chiamare
a
+una variabile di tipo stringa, e usarla per chiamare la funzione.
+Vediamo un esempio.
+
+Si supponga di avere un file con i punteggi ottenuti negli esami per i
+corsi che si stanno seguendo, e che si desideri ottenere la somma e la
+media dei punteggi ottenuti.
+Il primo campo @`e il nome del corso. I campi seguenti sono i nomi delle
+funzioni da chiamare per elaborare i dati, fino a un campo ``separatore''
address@hidden:}. Dopo il separatore, fino alla fine del record,
+ci sono i vari risultati numerici di ogni test.
+
+Ecco il file iniziale:
+
address@hidden
address@hidden file eg/data/class_data1
+Biologia_101 somma media dati: 87.0 92.4 78.5 94.9
+Chimica_305 somma media dati: 75.2 98.3 94.7 88.2
+Inglese_401 somma media dati: 100.0 95.6 87.1 93.4
address@hidden endfile
address@hidden example
+
+Per elaborare i dati, si potrebbe iniziare a scrivere:
+
address@hidden
address@hidden
+ corso = $1
+ for (i = 2; $i != "dati:"; i++) @{
+ if ($i == "somma")
+ somma() # elabora l'intero record
+ else if ($i == "media")
+ media()
+ @dots{} # e address@hidden@dotless{i}} via
+ @}
address@hidden
address@hidden example
+
address@hidden
+Questo stile di programmazione funziona, ma address@hidden essere scomodo.
+Con la chiamata @dfn{indiretta} di funzione, si address@hidden richiedere a
@command{gawk}
+di usare il @emph{valore} di una variabile come @emph{nome} della funzione da
+chiamare.
+
address@hidden @code{@@}, notazione per la chiamata indiretta di funzioni
address@hidden chiamata indiretta di funzioni, notazione @code{@@}
+La sintassi @`e simile a quella di una normale chiamata di funzione:
+un identificativo, seguito immediatamente da una parentesi aperta,
+qualche argomento, e una parentesi chiusa, con l'aggiunta di un carattere
address@hidden@@} all'inizio:
+
address@hidden
+quale_funzione = "somma"
+risultato = @@quale_funzione() # chiamata della funzione somma()
address@hidden example
+
+Ecco un intero programma che elabora i dati mostrati sopra,
+usando la chiamata indiretta di funzioni:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# chiamataindiretta.awk --- esempio di chiamata indiretta di funzioni
address@hidden endfile
address@hidden
address@hidden file eg/prog/indirectcall.awk
+#
+# Arnold Robbins, address@hidden, Public Domain
+# January 2009
address@hidden endfile
address@hidden ignore
+
address@hidden file eg/prog/indirectcall.awk
+# media --- calcola la media dei valori dei campi $primo - $ultimo
+
+function media(primo, ultimo, somma, i)
address@hidden
+ somma = 0;
+ for (i = primo; i <= ultimo; i++)
+ somma += $i
+
+ return somma / (ultimo - primo + 1)
address@hidden
+
+# somma --- restituisce la somma dei valori dei campi $primo - $ultimo
+
+function somma(primo, ultimo, totale, i)
address@hidden
+ max = 0;
+ for (i = primo; i <= ultimo; i++)
+ totale += $i
+
+ return totale
address@hidden
address@hidden endfile
address@hidden example
+
+Queste due funzioni presuppongono che si lavori con dei campi; quindi,
+i parametri @code{primo} e @code{ultimo} indicano da quale campo iniziare
+e fino a quale arrivare.
+Per il resto, eseguono i calcoli richiesti, che sono i soliti:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# Per ogni record,
+# stampa il nome del corso e le statistiche richieste
address@hidden
+ nome_corso = $1
+ gsub(/_/, " ", nome_corso) # Rimpiazza _ con spazi
+
+ # trova campo da cui iniziare
+ for (i = 1; i <= NF; i++) @{
+ if ($i == "dati:") @{
+ inizio = i + 1
+ break
+ @}
+ @}
+
+ printf("%s:\n", nome_corso)
+ for (i = 2; $i != "dati:"; i++) @{
+ quale_funzione = $i
+ printf("\t%s: <%s>\n", $i, @@quale_funzione(inizio, NF) "")
+ @}
+ print ""
address@hidden
address@hidden endfile
address@hidden example
+
+Questo @`e il ciclo principale eseguito per ogni record.
+Stampa il nome del corso (con le
+lineette basse sostituite da spazi). Trova poi l'inizio dei dati veri
+e propri, salvandolo in @code{inizio}.
+L'ultima parte del codice esegue un ciclo per ogni nome di funzione
+(da @code{$2} fino al separatore, @samp{dati:}), chiamando la funzione
+il cui nome @`e specificato nel campo. La chiamata di funzione indiretta
+compare come parametro nella chiamata a @code{printf}.
+(La stringa di formattazione di @code{printf} usa @samp{%s} come
+specificatore di formato, affinch@'e sia possibile usare funzioni
+che restituiscano sia stringhe che numeri. Si noti che il risultato
+della chiamata indiretta @`e concatenato con la stringa nulla, in modo da
+farlo considerare un valore di tipo stringa).
+
+Ecco il risultato dell'esecuzione del programma:
+
address@hidden
+$ @kbd{gawk -f chiamataindiretta.awk dati_dei_corsi}
address@hidden Biologia 101:
address@hidden somma: <352.8>
address@hidden media: <88.2>
address@hidden
address@hidden Chimica 305:
address@hidden somma: <356.4>
address@hidden media: <89.1>
address@hidden
address@hidden Inglese 401:
address@hidden somma: <376.1>
address@hidden media: <94.025>
address@hidden example
+
+La address@hidden di usare la chiamata indiretta di funzioni @`e
address@hidden potente
+di quel che si possa pensare inizialmente.
+I linguaggi C e C++ forniscono ``puntatori di funzione'' che
+sono un metodo per chiamare una funzione scelta al momento dell'esecuzione.
+Uno dei address@hidden noti usi di questa address@hidden @`e
+la funzione C @code{qsort()}, che ordina un vettore usando il famoso
+algoritmo noto come ``quicksort''
+(si veda @uref{http://en.wikipedia.org/wiki/Quicksort, l'articolo di Wikipedia}
+per ulteriori informazioni). Per usare questa funzione, si specifica un
+puntatore a una funzione di confronto. Questo meccanismo consente
+di ordinare dei dati arbitrari in una maniera arbitraria.
+
+Si address@hidden fare qualcosa di simile usando @command{gawk},
address@hidden@dotless{i}}:
+
address@hidden
address@hidden file eg/lib/quicksort.awk
+# quicksort.awk --- Algoritmo di quicksort, con funzione di confronto
+# fornita dall'utente
address@hidden endfile
address@hidden
address@hidden file eg/lib/quicksort.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# January 2009
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/quicksort.awk
+
+# quicksort --- Algoritmo di quicksort di C.A.R. Hoare.
+# Si veda Wikipedia o quasi ogni libro
+# che tratta di algoritmi o di informatica.
address@hidden endfile
address@hidden
address@hidden file eg/lib/quicksort.awk
+#
+# Adattato da B.W. Kernighan & D.M. Ritchie
+# The C Programming Language
+# (Englewood Cliffs, NJ: Prentice Hall, 1988)
+# Seconda Edizione, pagina 110
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/quicksort.awk
+
+function quicksort(dati, sinistra, destra, minore_di, i, ultimo)
address@hidden
+ if (sinistra >= destra) # non fa nulla se il vettore contiene
+ return # meno di due elementi
+
+ quicksort_scambia(dati, sinistra, int((sinistra + destra) / 2))
+ ultimo = sinistra
+ for (i = sinistra + 1; i <= destra; i++)
+ if (@@minore_di(dati[i], dati[sinistra]))
+ quicksort_scambia(dati, ++ultimo, i)
+ quicksort_scambia(dati, sinistra, ultimo)
+ quicksort(dati, sinistra, ultimo - 1, minore_di)
+ quicksort(dati, ultimo + 1, destra, minore_di)
address@hidden
+
+# quicksort_scambia --- funzione ausiliaria per quicksort,
+# sarebbe meglio fosse nel programma principale
+
+function quicksort_scambia(dati, i, j, salva)
address@hidden
+ salva = dati[i]
+ dati[i] = dati[j]
+ dati[j] = salva
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{quicksort()} riceve il vettore @code{dati}, gli
+indici iniziali e finali da ordinare
+(@code{sinistra} e @code{destra}), e il nome di una funzione che
+esegue un confronto ``minore di''. Viene quindi eseguito
+l'algoritmo di quicksort.
+
+Per fare uso della funzione di ordinamento, torniamo all'esempio
+precedente. La prima cosa da fare @`e di scrivere qualche funzione
+di confronto:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# num_min --- confronto numerico per minore di
+
+function num_min(sinistra, destra)
address@hidden
+ return ((sinistra + 0) < (destra + 0))
address@hidden
+
+# num_magg_o_ug --- confronto numerico per maggiore o uguale
+
+function num_magg_o_ug(sinistra, destra)
address@hidden
+ return ((sinistra + 0) >= (destra + 0))
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{num_magg_o_ug()} serve per ottenere un ordinamento
+decrescente (dal numero address@hidden alto al address@hidden basso); quando
@`e usato
+per eseguire un test per ``minore di'', in address@hidden fa l'opposto
+(maggiore o uguale a), il che conduce a ottenere dati ordinati
+in ordine decrescente.
+
+Poi serve una funzione di ordinamento.
+Come parametri ha i numeri del campo iniziale e di quello finale,
+e il nome della funzione di confronto.
+Costruisce un vettore con
+i dati e richiama appropriatamente @code{quicksort()}; quindi formatta i
+risultati mettendoli in un'unica stringa:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# ordina --- ordina i dati a seconda di `confronta'
+# e li restituisce come un'unica stringa
+
+function ordina(primo, ultimo, confronta, dati, i, risultato)
address@hidden
+ delete dati
+ for (i = 1; primo <= ultimo; primo++) @{
+ dati[i] = $primo
+ i++
+ @}
+
+ quicksort(dati, 1, i-1, confronta)
+
+ risultato = dati[1]
+ for (i = 2; i in dati; i++)
+ risultato = risultato " " dati[i]
+
+ return risultato
address@hidden
address@hidden endfile
address@hidden example
+
+Per finire, le due funzioni di ordinamento chiamano la funzione
address@hidden()}, passandole i nomi delle due funzioni di confronto:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# ascendente --- ordina i dati in ordine crescente
+# e li restituisce sotto forma di stringa
+
+function ascendente(primo, ultimo)
address@hidden
+ return ordina(primo, ultimo, "num_min")
address@hidden
+
+# discendente --- ordina i dati in ordine decrescente
+# e li restituisce sotto forma di stringa
+
+function discendente(primo, ultimo)
address@hidden
+ return ordina(primo, ultimo, "num_magg_o_ug")
address@hidden
address@hidden endfile
address@hidden example
+
+Ecco una versione estesa del @value{DF}:
+
address@hidden
address@hidden file eg/data/class_data2
+Biologia_101 somma media ordina discendente dati: 87.0 92.4 78.5 94.9
+Chimica_305 somma media ordina discendente dati: 75.2 98.3 94.7 88.2
+Inglese_401 somma media ordina discendente dati: 100.0 95.6 87.1 93.4
address@hidden endfile
address@hidden example
+
+Per finire, questi sono i risultati quando si esegue il programma
+in questa versione migliorata:
+
address@hidden
+$ @kbd{gawk -f quicksort.awk -f indirettacall.awk class_data2}
address@hidden Biologia 101:
address@hidden somma: <352.8>
address@hidden media: <88.2>
address@hidden ascendente: <78.5 87.0 92.4 94.9>
address@hidden discendente: <94.9 92.4 87.0 78.5>
address@hidden
address@hidden Chimica 305:
address@hidden somma: <356.4>
address@hidden media: <89.1>
address@hidden ascendente: <75.2 88.2 94.7 98.3>
address@hidden discendente: <98.3 94.7 88.2 75.2>
address@hidden
address@hidden Inglese 401:
address@hidden somma: <376.1>
address@hidden media: <94.025>
address@hidden ascendente: <87.1 93.4 95.6 100.0>
address@hidden discendente: <100.0 95.6 93.4 87.1>
address@hidden example
+
+Un altro esempio in cui le chiamate indirette di funzione sono utili
address@hidden costituito dall'elaborazione di vettori. La descrizione si
address@hidden trovare
address@hidden vettori}.
+
+Occorre ricordarsi di anteporre il carattere @samp{@@} prima di una
+chiamata indiretta di funzione.
+
+A partire dalla @value{PVERSION} 4.1.2 di @command{gawk}, le chiamate
+indirette di funzione
+possono anche essere usate per chiamare funzioni predefinite e con
+funzioni di estensione
+(@pxref{Estensioni dinamiche}). Ci sono alcune limitazioni nel richiamare
+in maniera indiretta delle funzioni predefinite, come qui dettagliato:
+
address@hidden @value{BULLET}
address@hidden
+Non si address@hidden passare una costante @dfn{regexp} a una funzione
predefinita
+effettuando una chiamata di funzione address@hidden
+limitazione potrebbe cambiare in una futura versione;
+per appurarlo, si controlli la documentazione che accompagna
+la versione in uso di @command{gawk}.}
+Quanto sopra vale per le funzioni
address@hidden()}, @code{gsub()}, @code{gensub()}, @code{match()},
address@hidden()} e @code{patsplit()}.
+
address@hidden
+Nel chiamare @code{sub()} o @code{gsub()}, sono accettati solo due argomenti,
+poich@'e queste funzioni sono atipiche, in quanto aggiornano il loro terzo
+argomento. Questo significa che address@hidden sempre aggiornato l'argomento
di
+default, @code{$0}.
address@hidden itemize
+
address@hidden fa del suo meglio per rendere efficiente la chiamata indiretta
+di funzioni. Per esempio, nel ciclo seguente:
+
address@hidden
+for (i = 1; i <= n; i++)
+ @@quale_funzione()
address@hidden example
+
address@hidden
address@hidden ricerca solo una volta quale funzione chiamare.
+
address@hidden Sommario delle funzioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
address@hidden include delle funzioni predefinite e consente all'utente
+di definire le sue proprie funzioni.
+
address@hidden
+POSIX @command{awk} include tre tipi di funzioni predefinite: numeriche, di
+stringa, e di I/O. @command{gawk} prevede funzioni per ordinare vettori, per
+lavorare con valori che rappresentano marcature temporali,
+per la manipolazione di bit,
+per determinare il tipo di una variabile (vettoriale piuttosto che scalare), e
+programmi per l'internazionalizzazione e la localizzazione. @command{gawk}
+prevede anche parecchie estensioni ad alcune funzioni standard, tipicamente
+nella forma di ulteriori argomenti.
+
address@hidden
+Le funzioni accettano zero o address@hidden argomenti e restituiscono un
valore. Le
+espressioni che specificano il valore di ogni argomento sono valutate
+completamente prima della chiamata
+a una funzione. L'ordine di valutazione di questi argomenti non @`e definito.
+Il valore restituito dalla funzione address@hidden essere ignorato.
+
address@hidden
+La gestione delle barre inverse in @code{sub()} e @code{gsub()} non @`e
+semplice.
address@hidden address@hidden semplice nella funzione di @command{gawk}
@code{gensub()},
+ma anche questa funzione richiede attenzione quando la si usa.
+
address@hidden
+Le funzioni definite dall'utente consentono importanti address@hidden ma hanno
+anche alcune ineleganze sintattiche. In una chiamata di funzione non si
address@hidden
+inserire alcuno spazio tra il nome della funzione e la parentesi sinistra
+aperta che inizia la lista degli argomenti. Inoltre, non c'@`e nessuna
+prescrizione per le variabili locali, e per questo la
+convenzione in uso @`e di aggiungere parametri extra, e di separarli
visivamente
+dai parametri veri e propri inserendo degli spazi bianchi prima di essi.
+
address@hidden
+Le funzioni definite dall'utente possono chiamare altre
+funzioni definite dall'utente (oltre a quelle predefinite)
+e possono chiamare se stesse ricorsivamente. I parametri di funzione
+``nascondono'' qualsiasi variabile globale che abbia lo stesso nome.
+Non si address@hidden usare il nome di una variabile riservata (p.es.
@code{ARGC})
+come nome di un parametro in funzioni definite dall'utente.
+
address@hidden
+I valori scalari sono passati alle funzioni definite dall'utente
+per valore. I parametri che sono dei vettori sono passati alle funzioni
+per riferimento; ogni modifica fatta dalla funzione a un parametro che
+sia un vettore @`e quindi visibile dopo aver eseguito quella funzione.
+
address@hidden
+L'istruzione @code{return} serve per tornare indietro da una funzione definita
+dall'utente. Un'espressione opzionale diviene il valore restituito dalla
+funzione. Una funzione address@hidden solo restituire valori di tipo scalare.
+
address@hidden
+Se una variabile che non @`e stata mai usata @`e passata a una funzione
+definita dall'utente, il modo con cui quella funzione elabora la variabile
+ne address@hidden determinare il tipo: o scalare o vettoriale.
+
address@hidden
address@hidden consente la chiamata indiretta di funzioni usando una sintassi
+speciale. Impostando una variabile al nome di una funzione, si address@hidden
+determinare al momento dell'esecuzione che funzione address@hidden chiamata in
un certo
+punto del programma. Questo equivale a usare un puntatore a una funzione nei
+linguaggi C e C++.
+
address@hidden itemize
+
+
address@hidden
address@hidden @value{PART2}Risoluzione di problemi con @command{awk}
address@hidden ifnotinfo
+
address@hidden
+La Parte II mostra come usare @command{awk} e @command{gawk} per risolvere
+problemi. Qui c'@`e il codice di molti programmi, da leggere e da cui si
address@hidden
+imparare. @`E composta dai seguenti capitoli:
+
address@hidden @value{BULLET}
address@hidden
address@hidden di libreria}
+
address@hidden
address@hidden di esempio}
address@hidden itemize
address@hidden ifdocbook
+
address@hidden Funzioni di libreria
address@hidden Una libreria di funzioni @command{awk}
address@hidden libreria di funzioni @command{awk}
address@hidden funzioni di libreria
address@hidden funzioni definite dall'utente, libreria di
+
address@hidden
+La
address@hidden iftex
address@hidden definite dall'utente} descrive come scrivere le proprie
+funzioni @command{awk} personali. Scrivere funzioni @`e importante, perch@'e
+consente di incapsulare in un unico contenitore algoritmi e azioni di
+programma. Semplifica la programmazione, rendendo lo sviluppo di un programma
address@hidden gestibile, e rendendo i programmi address@hidden leggibili.
+
address@hidden Kernighan, Brian
address@hidden Plauger, P.J.@:
+Nel loro autorevole libro del 1976,
address@hidden Tools},@footnote{Purtroppo, a distanza di oltre 35 anni,
+molte delle
+lezioni impartite da questo libro devono ancora essere apprese da un gran
+numero di programmatori professionisti.}
+Brian Kernighan e P.J.@: Plauger hanno scritto:
+
address@hidden
+A programmare bene non s'impara dai concetti generali, ma vedendo come
+programmi complessi possono essere resi puliti, facili da leggere,
+facili da manutenere e modificare,
+strutturati in modo comprensibile, efficienti e affidabili,
+applicando il buon senso e delle buone pratiche di programmazione.
+Lo studio attento e l'imitazione di buoni programmi conduce a una migliore
+scrittura.
address@hidden quotation
+
+In effetti, loro reputavano quest'idea tanto importante da mettere questa
+frase sulla copertina del libro. Poich@'e credo fermamente che la loro
+affermazione sia corretta, questo @value{CHAPTER} e
address@hidden
+il
address@hidden iftex
address@hidden di esempio}
+forniscono una corposa raccolta di codice da leggere e, si spera, da cui
+imparare.
+
+Questo @value{CHAPTER} illustra una libreria di utili funzioni @command{awk}.
+Molti dei programmi descritti nel seguito di questo @value{DOCUMENT}
+usano queste funzioni.
+Le funzioni sono illustrate progressivamente, dalla address@hidden semplice
alla address@hidden
+complessa.
+
address@hidden Texinfo
address@hidden
+La
address@hidden iftex
address@hidden extract}
+illustra un programma che si address@hidden usare per estrarre il codice
sorgente
+degli esempi di funzioni di libreria e di programmi dal sorgente Texinfo
+di questo @value{DOCUMENT}.
+(Questo @`e address@hidden stato fatto durante la preparazione della
distribuzione
+di @command{gawk}.)
+
address@hidden FOR_PRINT
+Chi avesse scritto una o address@hidden funzioni @command{awk} utili e di uso
+generale, e volesse metterle a disposizione della address@hidden degli utenti
di
address@hidden, address@hidden leggere le informazioni contenute in
address@hidden contribuire}.
address@hidden ifclear
+
address@hidden address@hidden, programmi di esempio
+I programmi contenuti in questo @value{CHAPTER} e in
address@hidden di esempio},
+utilizzano anche le address@hidden specifiche di @command{gawk}.
+Riscrivere questi programmi per implementazioni di @command{awk} diverse
address@hidden piuttosto semplice:
+
address@hidden @value{BULLET}
address@hidden
+I messaggi di errore diagnostici sono inviati a @file{/dev/stderr}.
+Usare @samp{| "cat 1>&2"} al posto di @samp{> "/dev/stderr"} se il sistema
+in uso non ha un @file{/dev/stderr}, o se non @`e possibile usare
address@hidden
+
address@hidden
+Alcuni programmi usano @code{nextfile}
+(@pxref{Istruzione nextfile})
+per evitare di leggere gli input ancora non letti dal file in input corrente.
+
address@hidden
address@hidden 12/2000: Thanks to Nelson Beebe for pointing out the output
issue.
address@hidden distinzione maiuscolo/minuscolo, programmi di esempio
address@hidden @code{IGNORECASE}, variabile, nei programmi di esempio
address@hidden variabile @code{IGNORECASE}, nei programmi di esempio
+Infine, alcuni dei programmi scelgono di ignorare la distinzione tra maiuscolo
e
+minuscolo nei loro input, assegnando il valore uno a @code{IGNORECASE}.
+Si address@hidden ottenere quasi lo stesso address@hidden risultati non sono
identici.
+L'output del record trasformato address@hidden tutto in minuscolo, mentre
address@hidden preserva il contenuto originale del record in input.}
+aggiungendo la seguente regola
+all'inizio del programma:
+
address@hidden
+# ignora maiuscolo/minuscolo
address@hidden $0 = tolower($0) @}
address@hidden example
+
address@hidden
+Inoltre, si verifichi che tutte le @dfn{regexp} e le costanti
+di tipo stringa usate nei confronti utilizzano solo lettere minuscole.
address@hidden itemize
+
address@hidden
+* Nomi di variabili di libreria:: Che nomi @`e meglio dare alle variabili
+ private globali nelle funzioni di libreria.
+* Funzioni di tipo generale:: Funzioni di uso generale.
+* Gestione File Dati:: Funzioni per gestire file-dati specificati
+ sulla riga di comando.
+* Funzione getopt:: Una funzione per trattare argomenti presenti
+ sulla riga di comando.
+* Funzioni Passwd:: Funzioni per ottenete informazioni
+ sull'utente [da /etc/passwd].
+* Funzioni Group:: Funzioni per ottenete informazioni
+ sul gruppo [da /etc/group].
+* Visitare vettori:: Una funzione per visitare vettori di vettori.
+* Sommario funzioni di libreria:: Sommario funzioni di libreria
+* Esercizi con le librerie:: Esercizi.
address@hidden menu
+
address@hidden Nomi di variabili di libreria
address@hidden Dare un nome a variabili globali in funzioni di libreria
+
address@hidden nomi di vettore/variabile
address@hidden nomi di funzione
address@hidden questioni sui nomi permessi
address@hidden nomi permessi, questioni sui
address@hidden programmi @command{awk}, documentazione
address@hidden documentazione, di programmi @command{awk}
+Per come si @`e sviluppato il linguaggio @command{awk}, le variabili sono
+o @dfn{globali} (usabili dall'intero programma) o @dfn{locali} (usabili solo
+in una specifica funzione). Non c'@`e uno stato intermedio analogo alle
+variabili @code{statiche} in C.
+
address@hidden variabili globali, per funzioni di libreria
address@hidden globali, variabili, per funzioni di libreria
address@hidden private, variabili
address@hidden variabili private
+Le funzioni di libreria hanno spesso address@hidden di avere variabili globali
da
+usare per conservare informazioni di stato tra successive chiamate alla
+funzione; per esempio, la variabile di @code{getopt()} @code{_opti}
+(@pxref{Funzione getopt}).
+Tali variabili vengono dette @dfn{private}, poich@'e le sole funzioni che
+devono usarle sono quelle della libreria.
+
+Quando si scrive una funzione di libreria, si dovrebbe cercare di scegliere per
+le variabili private dei nomi che non entrano in conflitto con nessuna delle
+variabili usate da un'altra funzione di libreria o dal programma principale di
+un utente. Per esempio, un nome come @code{i} o @code{j} non @`e una buona
+scelta, perch@'e i programmi a livello utente usano spesso nomi di variabile
come
+questi per le proprie elaborazioni.
+
address@hidden convenzioni di programmazione, nomi di variabili private
address@hidden programmazione, convenzioni di, nomi di variabili private
+I programmi di esempio mostrati in questo @value{CHAPTER} usano per le
+loro variabili private nomi che iniziano con un trattino basso(@samp{_}).
+Generalmente gli utenti
+non usano trattini bassi iniziali nei nomi di variabile,
address@hidden@dotless{i}} questa convenzione
+riduce le address@hidden che il nome di variabile coincida con un nome usato
+nel programma dell'utente.
+
address@hidden @code{_} (trattino basso), nei nomi di variabili private
address@hidden trattino basso (@code{_}), nei nomi di variabili private
+Inoltre, parecchie funzioni di libreria usano un prefisso che suggerisce
+quale funzione o gruppo di funzioni usa quelle variabili; per esempio,
address@hidden()} nelle routine che consultano la lista degli utenti
+(@pxref{Funzioni Passwd}).
+L'uso di questa convenzione viene raccomandata, poich@'e riduce ulteriormente
la
address@hidden di conflitti accidentali tra nomi di variabile. Si noti che
questa
+convenzione address@hidden anche essere usata per i nomi di variabile e per i
nomi delle
+funzioni address@hidden tutte le routine di libreria si sarebbero
+potute riscrivere usando questa convenzione, address@hidden non @`e stato
fatto, per far
+vedere come lo stile di programmazione in @command{awk} si @`e evoluto e
+per fornire alcuni spunti per questa spiegazione.}
+
+Come nota finale sui nomi delle variabili, se una funzione rende
+disponibile una variabile globale per essere usata da un programma principale,
address@hidden una buona convenzione quella di far iniziare i nomi di queste
variabili con
+una lettera maiuscola; per esempio, @code{Opterr} e @code{Optind} di
address@hidden()}
+(@pxref{Funzione getopt}).
+La lettera maiuscola iniziale indica che la variabile @`e globale,
+mentre il fatto che
+il nome della variabile non @`e tutto in lettere maiuscole indica che la
variabile
+non @`e una delle variabili predefinite di @command{awk}, come @code{FS}.
+
address@hidden @option{--dump-variables}, opzione, uso per funzioni di libreria
address@hidden opzione @option{--dump-variables}, uso per funzioni di libreria
address@hidden importante anche che @emph{tutte} le variabili nelle funzioni di
libreria
+che non abbiano la address@hidden di essere
+conservate per tutta la durata del
+programma siano, di fatto, dichiarate
+come address@hidden'opzione da riga di comando di @command{gawk}
address@hidden @`e utile per verificare questo.} Se address@hidden non viene
+fatto, la variabile potrebbe essere usata accidentalmente nel programma
+dell'utente, conducendo a errori che sono molto difficili da scoprire:
+
address@hidden
+function lib_func(x, y, l1, l2)
address@hidden
+ @dots{}
+ # qualche_var dovrebbe essere locale ma per una svista non lo @`e
+ @var{uso della variabile} qualche_var
+ @dots{}
address@hidden
address@hidden example
+
address@hidden vettori associativi, funzioni di libreria e
address@hidden libreria di funzioni @command{awk}, vettori associativi e
address@hidden funzioni, libreria di, vettori associativi e
address@hidden Tcl
+Una differente convenzione, comune nella address@hidden Tcl, @`e quella di
usare un
+solo vettore associativo che contiene i valori necessari alle funzioni di
+libreria, o ``package.'' Questo riduce significativamente il numero degli
+effettivi nomi globali in uso. Per esempio, le funzioni descritte in
address@hidden Passwd}
+potrebbero aver usato gli elementi di vettore
address@hidden@w{PW_data["inizializzato"]}},
address@hidden@w{PW_data["totale"]}}, @address@hidden"contatore"]}}, e
address@hidden@w{PW_data["awklib"]}}, al posto di @address@hidden,
address@hidden@w{_pw_totale}},
address@hidden@w{_pw_awklib}} e
address@hidden@w{_pw_contatore}}.
+
+Le convenzioni illustrate in questa @value{SECTION} sono esattamente
+quello che indica il termine: convenzioni. Non si @`e obbligati a scrivere
+i propri programmi in questo modo: @`e solo auspicabile che lo si faccia.
+
address@hidden Funzioni di tipo generale
address@hidden Programmazione di tipo generale
+
+Questa @value{SECTION} illustra diverse funzioni che sono di uso generale nella
+programmazione.
+
address@hidden
+* Funzione strtonum:: Da usare se non @`e disponibile la funzione
+ predefinita @code{strtonum()}.
+* Funzione assert:: Una funzione per controllare affermazioni
+ in programmi @command{awk}.
+* Funzione round:: Una funzione per eseguire arrotondamenti
+ se @code{sprintf()} non lo fa correttamente.
+* Funzione random Cliff:: Il generatore Cliff di numeri casuali.
+* Funzioni ordinali:: Funzioni per usare caratteri come numeri
+ e viceversa.
+* Funzione join:: Una funzione per fondere un vettore
+ in una stringa.
+* Funzione getlocaltime:: Una funzione per ottenere data e ora nel
+ formato desiderato.
+* Funzione readfile:: Una funzione per leggere un file intero in
+ un colpo solo.
+* Apici alla shell:: Una funzione per passare stringhe
+ con apici alla shell.
address@hidden menu
+
address@hidden Funzione strtonum
address@hidden Conversione di stringhe in numeri
+
+La funzione @code{strtonum()} (@pxref{Funzioni per stringhe})
address@hidden un'estensione @command{gawk}. La seguente funzione
+fornisce un'implementazione per altre versioni di @command{awk}:
+
address@hidden
address@hidden file eg/lib/strtonum.awk
+# mystrtonum --- converte stringhe in numeri
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/strtonum.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# February, 2004
+# Revised June, 2014
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/strtonum.awk
+function mystrtonum(str, ret, n, i, k, c)
address@hidden
+ if (str ~ /^0[0-7]*$/) @{
+ # ottale
+ n = length(str)
+ ret = 0
+ for (i = 1; i <= n; i++) @{
+ c = substr(str, i, 1)
+ # index() restituisce 0 se c non @`e nella stringa,
+ # e anche se c == "0"
+ k = index("1234567", c)
+
+ ret = ret * 8 + k
+ @}
+ @} else if (str ~ /^0[xX][[:xdigit:]]+$/) @{
+ # esadecimale
+ str = substr(str, 3) # via 0x iniziale
+ n = length(str)
+ ret = 0
+ for (i = 1; i <= n; i++) @{
+ c = substr(str, i, 1)
+ c = tolower(c)
+ # index() restituisce 0 se c non @`e nella stringa,
+ # e anche se c == "0"
+ k = index("123456789abcdef", c)
+
+ ret = ret * 16 + k
+ @}
+ @} else if (str ~ \
+ /^[-+]?([0-9]+([.][0-9]*([Ee][0-9]+)?)?|([.][0-9]+([Ee][-+]?[0-9]+)?))$/) @{
+ # numero decimale, eventualmente in virgola mobile
+ ret = str + 0
+ @} else
+ ret = "NON-UN-NUMERO"
+
+ return ret
address@hidden
+
+# BEGIN @{ # dati per un test
+# a[1] = "25"
+# a[2] = ".31"
+# a[3] = "0123"
+# a[4] = "0xdeadBEEF"
+# a[5] = "123.45"
+# a[6] = "1.e3"
+# a[7] = "1.32"
+# a[8] = "1.32E2"
+#
+# for (i = 1; i in a; i++)
+# print a[i], strtonum(a[i]), mystrtonum(a[i])
+# @}
address@hidden endfile
address@hidden example
+
+La funzione cerca dapprima numeri ottali in stile C (base 8).
+Se la stringa in input corrisponde all'espressione regolare che descrive i
+numeri ottali, @code{mystrtonum()} esegue il ciclo per ogni carattere presente
+nella stringa. Imposta @code{k} all'indice in @code{"1234567"} della cifra
+ottale corrente.
+Il valore di ritorno address@hidden lo stesso numero della cifra, o zero
+se il carattere non c'@`e, il che address@hidden per ogni cifra @samp{0}.
+Questo si address@hidden fare, perch@'e il test di @dfn{regexp}
nell'istruzione @code{if}
+assicura che vengano scelti per
+essere convertiti solo dei numeri ottali.
+
+Una logica simile si applica al codice che ricerca e converte un
+valore esadecimale, che inizia con @samp{0x} o @samp{0X}.
+L'uso di @code{tolower()} semplifica il calcolo per trovare
+il valore numerico corretto per ogni cifra esadecimale.
+
+Infine, se la stringa corrisponde alla (piuttosto complicata) @dfn{regexp} per
+un intero decimale regolare o per un numero in virgola mobile, il calcolo
address@hidden = str + 0} fa address@hidden@dotless{i}} che @command{awk}
converta il valore in un
+numero.
+
address@hidden incluso un programma di verifica commentato, in modo che la
funzione possa
+essere verificata con @command{gawk} e il risultato confrontato con la funzione
+predefinita @code{strtonum()}.
+
address@hidden Funzione assert
address@hidden Asserzioni
+
address@hidden asserzioni
address@hidden @code{assert()}, funzione (libreria C)
address@hidden funzione @code{assert()} (libreria C)
address@hidden libreria di funzioni @command{awk}, asserzioni
address@hidden funzioni, libreria di, asserzioni
address@hidden @command{awk}, asserzioni in programmi lunghi
+Quando si scrivono grossi programmi, spesso @`e utile sapere se
+una condizione o una serie di condizioni @`e verificata oppure no.
+Prima di procedere
+con un determinato calcolo, si fa un'affermazione su cosa si crede sia
+vero. Tale affermazione @`e nota come
address@hidden Il linguaggio C fornisce un file di intestazione
address@hidden<assert.h>} e una corrispondente macro @code{assert()} che un
+programmatore address@hidden utilizzare per fare asserzioni.
+Se l'asserzione risulta falsa, la macro @code{assert()} predispone la
+stampa di un messaggio diagnostico che descrive la condizione che
+sarebbe dovuta essere vera ma che non lo era, e poi fa terminare
+il programma.
+In C, l'uso di @code{assert()} @`e simile a questo:
+
address@hidden
+#include <assert.h>
+
+int myfunc(int a, double b)
address@hidden
+ assert(a <= 5 && b >= 17.1);
+ @dots{}
address@hidden
address@hidden example
+
+Se l'asserzione @`e falsa, il programma stampa un messaggio simile a questo:
+
address@hidden
+prog.c:5: asserzione falsa: `a <= 5 && b >= 17.1'
address@hidden example
+
address@hidden @code{assert()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{assert()}
+Il linguaggio C rende possibile trasformare questa condizione in una stringa
+da
+usare per stampare il messaggio di diagnosi. address@hidden in @command{awk}
non @`e
+possibile, per cui la funzione @code{assert()} scritta in @command{awk}
+richiede anche una descrizione
+della condizione da verificare, in formato stringa.
+La funzione @`e la seguente:
+
address@hidden
address@hidden file eg/lib/assert.awk
+# assert --- Verifica una condizione. Se questa @`e falsa esce.
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/assert.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May, 1993
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/assert.awk
+function assert(condizione, stringa)
address@hidden
+ if (! condizione) @{
+ printf("%s:%d: asserzione falsa: %s\n",
+ FILENAME, FNR, stringa) > "/dev/stderr"
+ _assert_exit = 1
+ exit 1
+ @}
address@hidden
+
address@hidden
+END @{
+ if (_assert_exit)
+ exit 1
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+La funzione @code{assert()} verifica il parametro @code{condizione}. Se
address@hidden falso, stampa un messaggio sullo standard error, usando il
parametro
address@hidden per descrivere la condizione non verificata. Poi imposta la
+variabile @code{_assert_exit} a uno ed esegue l'istruzione @code{exit}.
+L'istruzione @code{exit} salta alla regola @code{END}. Se la regola @code{END}
+trova vera la variabile @code{_assert_exit}, esce immediatamente.
+
+Lo scopo della verifica nella regola @code{END} @`e quello di evitare che venga
+eseguita qualsiasi altra eventuale regola @code{END}.
+Quando un'asserzione non @`e
+verificata, il programma dovrebbe uscire immediatamente.
+Se nessuna asserzione
+fallisce, @code{_assert_exit} @`e ancora falso quando la regola @code{END} @`e
+eseguita normalmente, e le eventuali altre regole @code{END} del programma
+vengono eseguite.
+Affinch@'e tutto questo funzioni correttamente, @file{assert.awk} dev'essere il
+primo file sorgente che viene letto da @command{awk}.
+La funzione address@hidden essere usata in un programma nel seguente modo:
+
address@hidden
+function miafunz(a, b)
address@hidden
+ assert(a <= 5 && b >= 17.1, "a <= 5 && b >= 17.1")
+ @dots{}
address@hidden
address@hidden example
+
address@hidden
+Se l'asserzione non @`e verificata, si address@hidden un messaggio simile a
questo:
+
address@hidden
+mydata:1357: asserzione falsa: a <= 5 && b >= 17.1
address@hidden example
+
address@hidden @code{END}, criterio di ricerca, funzione definita dall'utente
@code{assert()} e
address@hidden criterio di ricerca @code{END}, funzione definita dall'utente
@code{assert()} e
+C'@`e un piccolo problema con questa versione di @code{assert()}.
+Come visto, una regola @code{END} viene automaticamente aggiunta al programma
+che chiama @code{assert()}. Normalmente, se un programma consiste
+solo di una regola @code{BEGIN}, i file in input e/o lo standard input non
+vengono letti. Tuttavia, ora che il programma ha una regola @code{END},
address@hidden tenta di leggere i @value{DF} in input o lo standard input
+(@pxref{Usare BEGIN/END}), provocando molto probabilmente la sospensione del
+programma come se rimanesse in attesa di input.
+
address@hidden @code{BEGIN}, criterio di ricerca, funzione definita dall'utente
@code{assert()} e
address@hidden criterio di ricerca @code{BEGIN}, funzione definita dall'utente
@code{assert()} e
+C'@`e un modo per aggirare questo problema:
+assicurarsi che la regola @code{BEGIN} termini sempre
+con un'istruzione @code{exit}.
+
address@hidden Funzione round
address@hidden Arrotondamento di numeri
+
address@hidden arrotondare numeri
address@hidden numeri, arrotondamento di
address@hidden libreria di funzioni @command{awk}, arrotondamento di numeri
address@hidden funzioni, libreria di, arrotondamento di numeri
address@hidden @code{print}, istruzione, funzione @code{sprintf()} e
address@hidden istruzione @code{print}, funzione @code{sprintf()} e
address@hidden @code{printf}, istruzione, funzione @code{sprintf()} e
address@hidden istruzione @code{printf}, funzione @code{sprintf()} e
address@hidden @code{sprintf()}, funzione, istruzioni
@code{print}/@code{printf} e
address@hidden funzione @code{sprintf()}, istruzioni @code{print}/@code{printf}
e
+Il modo in cui @code{printf} e @code{sprintf()}
+(@pxref{Printf})
+effettuano l'arrotondamento spesso dipende dalla subroutine C @code{sprintf()}
+del sistema. Su molte macchine, l'arrotondamento di @code{sprintf()} @`e
address@hidden, il che significa che non sempre arrotonda un .5 finale per
+eccesso, contrariamente alle normali aspettative. Nell'arrotondamento
+statistico, .5 arrotonda alla cifra pari, anzich@'e sempre per eccesso,
address@hidden@dotless{i}}
+1.5 arrotonda a 2 e 4.5 arrotonda a 4. address@hidden significa che se si sta
usando un
+formato che fa arrotondamenti (p.es. @code{"%.0f"}), si dovrebbe controllare
+quello che fa il sistema che si sta usando. La seguente funzione esegue un
+arrotondamento tradizionale; potrebbe essere utile nel caso in cui
+l'istruzione @code{printf}
+di @command{awk} che si sta usando faccia degli arrotondamenti statistici:
+
address@hidden @code{round()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{round()}
address@hidden
address@hidden file eg/lib/round.awk
+# round.awk --- effettua arrotondamento tradizionale
address@hidden endfile
address@hidden
address@hidden file eg/lib/round.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# August, 1996
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/round.awk
+
+function round(x, ival, aval, frazione)
address@hidden
+ ival = int(x) # parte intera, int() fa un troncamento
+
+ # vedere se c'@`e la parte frazionale
+ if (ival == x) # nessuna parte frazionale
+ return ival # nessun decimale
+
+ if (x < 0) @{
+ aval = -x # valore assoluto
+ ival = int(aval)
+ frazione = aval - ival
+ if (frazione >= .5)
+ return int(x) - 1 # -2.5 --> -3
+ else
+ return int(x) # -2.3 --> -2
+ @} else @{
+ frazione = x - ival
+ if (frazione >= .5)
+ return ival + 1
+ else
+ return ival
+ @}
address@hidden
address@hidden endfile
address@hidden don't include test harness in the file that gets installed
+
+# codice per testare, commentato
+# @{ print $0, round($0) @}
address@hidden example
+
address@hidden Funzione random Cliff
address@hidden Il generatore di numeri casuali Cliff
address@hidden numeri casuali, generatore Cliff
address@hidden Cliff, generatore di numeri casuali
address@hidden casuali, numeri, generatore Cliff di
address@hidden funzioni, libreria di, numeri casuali Cliff
+
+Il
address@hidden://mathworld.wolfram.com/CliffRandomNumberGenerator.html,
generatore di numeri casuali Cliff}
address@hidden un generatore di numeri casuali molto semplice che ``passa il
test della sfera
+del rumore per la address@hidden non mostrando di avere alcuna struttura.''
address@hidden programmato in modo molto semplice, in meno di 10 righe di codice
address@hidden:
+
address@hidden @code{cliff_rand()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{cliff_rand()}
address@hidden
address@hidden file eg/lib/cliff_rand.awk
+# cliff_rand.awk --- generare numeri casuali con algoritmo di Cliff
address@hidden endfile
address@hidden
address@hidden file eg/lib/cliff_rand.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# December 2000
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/cliff_rand.awk
+
+BEGIN @{ _cliff_seme = 0.1 @}
+
+function cliff_rand()
address@hidden
+ _cliff_seme = (100 * log(_cliff_seme)) % 1
+ if (_cliff_seme < 0)
+ _cliff_seme = - _cliff_seme
+ return _cliff_seme
address@hidden
address@hidden endfile
address@hidden example
+
+Questo algoritmo richiede un ``seme'' iniziale di 0,1. Ogni nuovo valore
+usa il seme corrente come input per il calcolo.
+Se la funzione predefinita @code{rand()}
+(@pxref{Funzioni numeriche})
+non @`e abbastanza casuale, si address@hidden tentare di usare al suo posto
questa funzione.
+
address@hidden Funzioni ordinali
address@hidden Tradurre tra caratteri e numeri
+
address@hidden libreria di funzioni @command{awk}, valori di carattere come
numeri
address@hidden funzioni, libreria di, valori di carattere come numeri
address@hidden carattere, valore come numero
address@hidden numeri, come valori di carattere
+Un'implementazione commerciale di @command{awk} fornisce una funzione
+predefinita @code{ord()}, che prende un carattere e restituisce il valore
+numerico per quel carattere nella rappresentazione dei caratteri
+di quella particolare macchina. Se la
+stringa passata a @code{ord()} ha address@hidden di un carattere, viene usato
solo il
+primo.
+
+L'inverso di questa funzione @`e @code{chr()} (dalla funzione con lo stesso
nome
+in Pascal), che, dato un numero, restituisce il corrispondente carattere.
+Entrambe le funzioni si possono scrivere molto bene usando @command{awk};
+non vi @`e nessun reale motivo per inglobarle come funzioni predefinite
address@hidden:
+
address@hidden @code{ord()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{ord()}
address@hidden @code{chr()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{chr()}
address@hidden @code{_ord_init()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{_ord_init()}
address@hidden
address@hidden file eg/lib/ord.awk
+# ord.awk --- implementa ord e chr
+
+# Identificatori globali:
+# _ord_: valori numerici indicizzati da caratteri
+# _ord_init: funzione per inizializzare _ord_
address@hidden endfile
address@hidden
address@hidden file eg/lib/ord.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# 16 January, 1992
+# 20 July, 1992, revised
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/ord.awk
+
+BEGIN @{ _ord_init() @}
+
+function _ord_init( basso, alto, i, t)
address@hidden
+ basso = sprintf("%c", 7) # BEL @`e ascii 7
+ if (basso == "\a") @{ # ascii regolare
+ basso = 0
+ alto = 127
+ @} else if (sprintf("%c", 128 + 7) == "\a") @{
+ # ascii, con il primo bit a 1 (mark)
+ basso = 128
+ alto = 255
+ @} else @{ # ebcdic(!)
+ basso = 0
+ alto = 255
+ @}
+
+ for (i = basso; i <= alto; i++) @{
+ t = sprintf("%c", i)
+ _ord_[t] = i
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden serie di caratteri (codifiche dei caratteri da parte della
macchina)
address@hidden ASCII
address@hidden EBCDIC
address@hidden Unicode
address@hidden bit di address@hidden (in ASCII)
address@hidden @dfn{mark}, bit di address@hidden (in ASCII)
+Alcune spiegazioni riguardo ai numeri usati da @code{_ord_init()}
+non guastano.
+La serie di caratteri address@hidden importante oggi in uso @`e nota come
address@hidden situazione sta address@hidden
+cambiando: molti sistemi usano Unicode, una serie di caratteri molto ampia
+che comprende ASCII al suo interno.
+Nei sistemi che supportano interamente Unicode,
+un carattere address@hidden occupare fino a 32 bit, facendo diventare
+i semplici test usati qui eccessivamente complessi.}
+Sebbene un byte a
+8 bit possa contenere 256 valori distinti (da 0 a 255), ASCII definisce solo i
+caratteri che usano i valori da 0 a address@hidden
address@hidden stato esteso in molti paesi per usare i valori da 128 a 255
includendo
+i caratteri specifici del paese. Se il sistema in uso si avvale di queste
+estensioni, si address@hidden semplificare @code{_ord_init()} per eseguire un
ciclo da
+0 a 255.} Nel lontano passato,
+almeno un produttore di microcomputer
address@hidden Pr1me, blech
+ha usato ASCII, ma con una address@hidden di tipo @dfn{mark}, address@hidden
con il bit address@hidden a
+sinistra sempre a 1. Questo significa che su questi sistemi i caratteri
+ASCII hanno valori numerici da 128 a 255.
+Infine, i grandi elaboratori centrali usano la serie di caratteri EBCDIC, che
+prevede tutti i 256 valori.
+Ci sono altre serie di caratteri in uso su alcuni sistemi address@hidden
vecchi, ma non
+vale la pena di considerarli:
+
address@hidden
address@hidden file eg/lib/ord.awk
+function ord(str, c)
address@hidden
+ # solo il primo carattere @`e d'interesse
+ c = substr(str, 1, 1)
+ return _ord_[c]
address@hidden
+
+function chr(c)
address@hidden
+ # trasforma c in un numero aggiungendo uno 0
+ return sprintf("%c", c + 0)
address@hidden
address@hidden endfile
+
+#### programma di verifica ####
+# BEGIN @{
+# for (;;) @{
+# printf("immetti un carattere: ")
+# if (getline var <= 0)
+# break
+# printf("ord(%s) = %d\n", var, ord(var))
+# @}
+# @}
address@hidden endfile
address@hidden example
+
+Un ovvio miglioramento a queste funzioni @`e quello di spostare il codice per
la
+funzione @address@hidden nel corpo della regola @code{BEGIN}.
+Il programma @`e
+stato scritto inizialmente in questo modo per address@hidden di sviluppo.
+C'@`e un ``programma di verifica'' in una regola @code{BEGIN}, per verificare
+la funzione. @`E commentato, per poter essere eventualmente usato in
produzione.
+
address@hidden Funzione join
address@hidden Trasformare un vettore in una sola stringa
+
address@hidden libreria di funzioni @command{awk}, trasformare vettori in
stringhe
address@hidden funzioni, libreria di, trasformare vettori in stringhe
address@hidden stringhe, trasformare vettori in
address@hidden vettori, trasformare in stringhe
+Quando si fanno elaborazioni su stringhe, spesso @`e utile poter unire
+tutte le stringhe di un vettore in una lunga stringa. La funzione seguente,
address@hidden()}, svolge questo compito. address@hidden utilizzata nel
seguito in diversi
+programmi applicativi
address@hidden
+(@pxrefil{Programmi di esempio}).
address@hidden iftex
address@hidden
+(@pxref{Programmi di esempio}).
address@hidden ifnottex
+
+La buona progettazione di una funzione @`e importante; la funzione dev'essere
+generale, ma potrebbe anche avere un ragionevole comportamento di default.
+Viene chiamata con un vettore e anche con gli indici iniziale e finale degli
+elementi del vettore da riunire.
+Questo presuppone che gli indici del vettore
+siano numerici---una supposizione logica, dato che il vettore probabilmente @`e
+stato creato con @code{split()}
+(@pxref{Funzioni per stringhe}):
+
address@hidden @code{join()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{join()}
address@hidden
address@hidden file eg/lib/join.awk
+# join.awk --- trasforma un vettore in una stringa
address@hidden endfile
address@hidden
address@hidden file eg/lib/join.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/join.awk
+
+function join(vettore, iniz, fine, separ, risultato, i)
address@hidden
+ if (separ == "")
+ separ = " "
+ else if (separ == SUBSEP) # valore magico
+ separ = ""
+ risultato = vettore[iniz]
+ for (i = iniz + 1; i <= fine; i++)
+ risultato = risultato separ vettore[i]
+ return risultato
address@hidden
address@hidden endfile
address@hidden example
+
+Un ulteriore argomento opzionale @`e il separatore da usare quando si uniscono
+nuovamente le stringhe. Se il chiamante fornisce un valore non nullo,
address@hidden()} usa quello; se non viene fornito,
+per default ha un valore nullo.
+In questo caso, @code{join()} usa uno spazio singolo come separatore
+di default
+per le stringhe. Se il valore @`e uguale a @code{SUBSEP},
address@hidden()} unisce le stringhe senza un separatore tra di esse.
address@hidden serve come valore ``magico'' per indicare che potrebbe non
esserci
+un separatore tra le stringhe address@hidden bello
+se @command{awk} avesse un operatore di assegnamento per la concatenazione.
+La mancanza di un esplicito operatore per la concatenazione rende le operazioni
+sulle stringhe address@hidden difficili di quanto potrebbero essere.}
+
address@hidden Funzione getlocaltime
address@hidden Gestione dell'ora del giorno
+
address@hidden libreria di funzioni @command{awk}, gestire ora del giorno
(marcature temporali)
address@hidden funzioni, libreria di, gestione delle ore del giorno
address@hidden data e ora, formattate
address@hidden marcature temporali, formattate
address@hidden ora del giorno, gestire
+Le funzioni @code{systime()} e @code{strftime()} descritte nella
address@hidden di tempo}
+forniscono la address@hidden minima necessaria per visualizzare l'ora del
giorno
+in una forma intelligibile. Sebbene @code{strftime()} offra un'ampia gamma di
+formattazioni, i formati di controllo non sono facili da ricordare o
+intuitivamente ovvii quando si legge un programma.
+
+La seguente funzione, @code{getlocaltime()}, riempie un vettore fornito
+dall'utente con informazioni sul tempo preformattate. Restituisce una stringa
+con data e ora corrente formattata come nel programma di address@hidden
@command{date}:
+
address@hidden @code{getlocaltime()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getlocaltime()}
address@hidden
address@hidden file eg/lib/gettime.awk
+# getlocaltime.awk --- ottiene l'ora del giorno in un formato usabile
address@hidden endfile
address@hidden
address@hidden file eg/lib/gettime.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain, May 1993
+#
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/gettime.awk
+
+# Restituisce una stringa nel formato dell'output di date(1)
+# Riempie l'argomento del vettore time con valori individuali:
+# time["second"] -- secondi (0 - 59)
+# time["minute"] -- minuti (0 - 59)
+# time["hour"] -- ore (0 - 23)
+# time["althour"] -- ore (0 - 12)
+# time["monthday"] -- giorno del mese (1 - 31)
+# time["month"] -- mese dell'anno (1 - 12)
+# time["monthname"] -- nome del mese
+# time["shortmonth"] -- nome breve del mese
+# time["year"] -- anno modulo 100 (0 - 99)
+# time["fullyear"] -- anno completo
+# time["weekday"] -- giorno della settimana (domenica = 0)
+# time["altweekday"] -- giorno della settimana
(address@hidden@dotless{i}} = 0)
+# time["dayname"] -- nome del giorno della settimana
+# time["shortdayname"] -- nome breve del giorno della settimana
+# time["yearday"] -- giorno dell'anno (0 - 365)
+# time["timezone"] -- abbreviazione del nome della zona di fuso orario
+# time["ampm"] -- designazione di AM o PM
+# time["weeknum"] -- numero della settimana, domenica primo giorno
+# time["altweeknum"] -- numero della settimana,
address@hidden@dotless{i}} primmo giorno
+
+function getlocaltime(ora, ret, adesso, i)
address@hidden
+ # ottiene data e ora una volta sola,
+ # evitando chiamate di sistema non necessarie
+ adesso = systime()
+
+ # restituisce l'output in stile date(1)
address@hidden lun 8 giu 2015, 20.39.38, CEST
address@hidden "%a %e %b %Y , %H.%M.%S, %Z"
+ ret = strftime("%a %e %b %Y, %H.%M.%S, %Z", adesso)
+
+ # clear out target array
+ delete time
+
+ # immette i valori, forzando i valori numerici
+ # a essere numerici aggiungendo uno 0
+ time["second"] = strftime("%S", adesso) + 0
+ time["minute"] = strftime("%M", adesso) + 0
+ time["hour"] = strftime("%H", adesso) + 0
+ time["althour"] = strftime("%I", adesso) + 0
+ time["monthday"] = strftime("%d", adesso) + 0
+ time["month"] = strftime("%m", adesso) + 0
+ time["monthname"] = strftime("%B", adesso)
+ time["shortmonth"] = strftime("%b", adesso)
+ time["year"] = strftime("%y", adesso) + 0
+ time["fullyear"] = strftime("%Y", adesso) + 0
+ time["weekday"] = strftime("%w", adesso) + 0
+ time["altweekday"] = strftime("%u", adesso) + 0
+ time["dayname"] = strftime("%A", adesso)
+ time["shortdayname"] = strftime("%a", adesso)
+ time["yearday"] = strftime("%j", adesso) + 0
+ time["timezone"] = strftime("%Z", adesso)
+ time["ampm"] = strftime("%p", adesso)
+ time["weeknum"] = strftime("%U", adesso) + 0
+ time["altweeknum"] = strftime("%W", adesso) + 0
+
+ return ret
address@hidden
address@hidden endfile
address@hidden example
+
+Gli indici di stringa sono address@hidden facili da usare e leggere rispetto ai
+vari formati
+richiesti da @code{strftime()}. Il programma @code{alarm} illustrato in
address@hidden alarm}
+usa questa funzione.
+Una progettazione address@hidden generica della funzione @code{getlocaltime()}
+avrebbe permesso all'utente di fornire un valore di data e ora
+opzionale da usare al posto della data/ora corrente.
+
address@hidden Funzione readfile
address@hidden Leggere un intero file in una sola volta
+
+Spesso @`e conveniente avere il contenuto di un intero file disponibile
+in memoria, visto
+come un'unica stringa. Un modo chiaro e semplice per far address@hidden
potrebbe essere
+questo:
+
address@hidden
+function readfile(file, temp, contenuto)
address@hidden
+ if ((getline temp < file) < 0)
+ return
+
+ contenuto = temp
+ while (getline temp < file) > 0)
+ contenuto = contenuto RT tmp
+
+ close(file)
+ return contenuto
address@hidden
address@hidden example
+
+Questa funzione legge da @code{file} un record alla volta, ricostruendo
+l'intero contenuto del file nella variabile locale @code{contenuto}.
+Funziona, ma non @`e detto che sia efficiente.
+
+La funzione seguente, basata su un suggerimento di Denis Shirokov,
+legge l'intero contenuto del file in un colpo solo:
+
address@hidden @code{readfile()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{readfile()}
address@hidden
address@hidden file eg/lib/readfile.awk
+# readfile.awk --- legge un intero file in un colpo solo
address@hidden endfile
address@hidden
address@hidden file eg/lib/readfile.awk
+#
+# Idea originale di Denis Shirokov, cosmogen@@gmail.com, aprile 2013
+#
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/readfile.awk
+
+function readfile(file, temp, salva_rs)
address@hidden
+ salva_rs = RS
+ RS = "^$"
+ getline temp < file
+ close(file)
+ RS = salva_rs
+
+ return temp
address@hidden
address@hidden endfile
address@hidden example
+
+Funziona impostando @code{RS} a @samp{^$}, un'espressione regolare che
+non trova nessuna corrispondenza se il file ha un contenuto.
address@hidden
+legge i dati dal file contenuto in @code{temp}, tentando di trovare una
+corrispondenza con @code{RS}.
+La ricerca dopo ogni lettura non ha mai successo, ma termina
+rapidamente, e quindi @command{gawk} inserisce in
address@hidden l'intero contenuto del file.
+(@xref{Record} per informazioni su @code{RT} e @code{RS}.)
+
+Se @code{file} @`e vuoto, il valore di ritorno @`e la stringa vuota.
+Quindi, il codice chiamante address@hidden usare qualcosa simile a questo:
+
address@hidden
+contenuto = readfile("/qualche/percorso")
+if (length(contenuto) == 0)
+ # file vuoto @dots{}
address@hidden example
+
+La verifica serve a determinare se il file @`e vuoto o no. Una verifica
+equivalente potrebbe essere @samp{contenuto == ""}.
+
address@hidden di estensione Readfile} per una funzione di estensione
+anch'essa finalizzata a leggere un intero file in memoria.
+
address@hidden Apici alla shell
address@hidden Stringhe con apici da passare alla shell
+
address@hidden included by permission
address@hidden
+Date: Sun, 27 Jul 2014 17:16:16 -0700
+Message-ID: <address@hidden>
+Subject: Useful awk function
+From: Mike Brennan <address@hidden>
+To: Arnold Robbins <address@hidden>
address@hidden ignore
+
+Michael Brennan propone il seguente modello di programma,
+da lui usato spesso:
+
address@hidden
+#! /bin/sh
+
+awkp='
+ @dots{}
+ '
+
address@hidden | awk "$awkp" | /bin/sh
address@hidden example
+
+Per esempio, un suo programma chiamato @address@hidden
+file con suffisso @dfn{flac} contengono normalmente dei brani musicali.
address@hidden @`e un programma che permette di modificare
+le informazioni address@hidden contenute all'inizio di un file di tipo
address@hidden ha questa forma:
+
address@hidden
+$ @kbd{flac-edit -song="Whoope! That's Great" file.flac}
address@hidden example
+
address@hidden genera in output il seguente script, da passare alla
+shell (@file{/bin/sh}) per essere eseguito:
+
address@hidden
+chmod +w file.flac
+metaflac --remove-tag=TITLE file.flac
+LANG=en_US.88591 metaflac --set-tag=TITLE='Whoope! That'"'"'s Great' file.flac
+chmod -w file.flac
address@hidden example
+
+Si noti la address@hidden di gestire gli apici nello script da passare alla
shell.
+La funzione
address@hidden()} li prepara nel formato richiesto.
address@hidden @`e la stringa di un solo
+carattere @code{"'"} e @code{QSINGLE} @`e la stringa di tre caratteri
address@hidden"\"'\""}:
+
address@hidden
address@hidden file eg/lib/shellquote.awk
+# shell_quote --- pone tra apici un argomento da passare alla shell
address@hidden endfile
address@hidden
address@hidden file eg/lib/shellquote.awk
+#
+# Michael Brennan
+# brennan@@madronabluff.com
+# September 2014
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/shellquote.awk
+
+function shell_quote(s, # parametro
+ SINGLE, QSINGLE, i, X, n, ret) # variabili locali
address@hidden
+ if (s == "")
+ return "\"\""
+
+ SINGLE = "\x27" # apice singolo
+ QSINGLE = "\"\x27\"" # apice singolo incapsulato
+ n = split(s, X, SINGLE)
+
+ ret = SINGLE X[1] SINGLE
+ for (i = 2; i <= n; i++)
+ ret = ret QSINGLE SINGLE X[i] SINGLE
+
+ return ret
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Gestione File Dati
address@hidden Gestione di @value{DF}
+
address@hidden file, gestione di
address@hidden gestione di file
address@hidden libreria di funzioni @command{awk}, gestire file di dati
address@hidden funzioni, libreria di, gestire file di dati
+Questa @value{SECTION} presenta funzioni utili per gestire
address@hidden da riga di comando.
+
address@hidden
+* Funzione filetrans:: Una funzione per gestire il passaggio da un
+ file in input al successivo.
+* Funzione rewind:: Una funzione per rileggere il file in input.
+* Controllo di file:: Controllare che i file in input siano
+ accessibili.
+* File vuoti:: Controllare se i file in input sono vuoti.
+* Ignorare assegnamenti di variabili:: Trattare assegnamenti di variabili.
+ come nomi di file.
address@hidden menu
+
address@hidden Funzione filetrans
address@hidden Trovare i limiti dei @value{DF}
+
address@hidden file, gestione di, limiti dei file-dati
address@hidden file, inizializzazione e pulizia
+Ognuna delle regole @code{BEGIN} ed @code{END} viene eseguita esattamente
+solo una volta, rispettivamente all'inizio e alla fine del programma
address@hidden (@pxref{BEGIN/END}).
+Una volta noi (gli autori di @command{gawk}) siamo venuti in contatto
+con un utente che
+erroneamemnte pensava che le regole @code{BEGIN} venissero eseguite all'inizio
+di ogni @value{DF} e le regole @code{END} alla fine di ogni @value{DF}.
+
+Quando lo abbiamo informato che
+non era address@hidden@dotless{i}}, ci ha chiesto di aggiungere un nuovo
criterio di ricerca speciale
+a @command{gawk}, chiamato @code{BEGIN_FILE} e @code{END_FILE}, che avesse il
+comportamento desiderato. Ci ha fornito anche il codice per far questo.
+
+Non @`e stato necessario aggiungere a @command{gawk} questi criteri di ricerca
+speciali; il lavoro si address@hidden fare tranquillamente usando
@command{awk}, come
+illustrato nel seguente programma di libreria. @`E strutturato in modo da
+chiamare due funzioni fornite dall'utente, @code{a_inizio_file()} e
address@hidden()}, all'inizio e alla fine di ogni @value{DF}. Oltre a risolvere
+il problema in sole nove(!) righe di codice,
+questa soluzione @`e @emph{portabile}; il
+programma funziona con qualsiasi implementazione di @command{awk}:
+
address@hidden
+# transfile.awk
+#
+# Dare all'utente un aggancio per il passaggio
+# da un file in input a quello successivo
+#
+# L'utente deve fornire le funzioni a_inizio_file() ed a_fine_file()
+# ciascuna delle quali @`e invocata
+# quando il file, rispettivamente,
+# inizia e finisce.
address@hidden #
address@hidden # Arnold Robbins, arnold@@skeeve.com, Public Domain
address@hidden # January 1992
+
+FILENAME != _nome_file_vecchio @{
+ if (_nome_file_vecchio != "")
+ a_fine_file(_nome_file_vecchio)
+ _nome_file_vecchio = FILENAME
+ a_inizio_file(FILENAME)
address@hidden
+
+END @{ a_fine_file(FILENAME) @}
address@hidden example
+
+Questo file [transfile.awk] dev'essere caricato prima del programma
+``principale'' dell'utente,
+in modo che la regola ivi contenuta venga eseguita per prima.
+
+Questa regola dipende dalla variabile di @command{awk} @code{FILENAME}, che
+cambia automaticamente per ogni nuovo @value{DF}. Il @value{FN} corrente viene
+salvato in una variabile privata, @code{_nome_file_vecchio}. Se
@code{FILENAME} non @`e
+uguale a @code{_nome_file_vecchio}, inizia l'elaborazioone di un nuovo
@value{DF} ed
address@hidden necessario chiamare @code{a_fine_file()} per il vecchio file.
Poich@'e
address@hidden()} dovrebbe essere chiamato solo se un file @`e stato elaborato,
il
+programma esegue prima un controllo per assicurarsi che
@code{_nome_file_vecchio} non
+sia la stringa nulla. Il programma assegna poi il valore corrente di
address@hidden a @code{_nome_file_vecchio} e chiama @code{a_inizio_file()} per
il file.
+Poich@'e, come tutte le variabili di @command{awk}, @code{_nome_file_vecchio}
@`e
+inizializzato alla stringa nulla, questa regola viene eseguita correttamente
+anche per il primo @value{DF}.
+
+Il programma contiene anche una regola @code{END} per completare l'elaborazione
+per l'ultimo file. Poich@'e questa regola @code{END} viene prima di qualsiasi
+regola @code{END} contenuta nel programma ``principale'',
address@hidden()} viene
+chiamata per prima. Ancora una volta, l'address@hidden di poter avere
address@hidden regole
address@hidden ed @code{END} dovrebbe risultare chiara.
+
address@hidden @code{a_inizio_file()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{a_inizio_file()}
address@hidden @code{a_fine_file()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{a_fine_file()}
+Se lo stesso @value{DF} compare due volte di fila sulla riga di comando,
address@hidden()} e @code{a_inizio_file()} non vengono eseguite alla fine del
primo
+passaggio e all'inizio del secondo passaggio.
+La versione seguente risolve il problema:
+
address@hidden
address@hidden file eg/lib/ftrans.awk
+# ftrans.awk --- gestisce il passaggio da un file dati al successivo
+#
+# L'utente deve fornire le funzioni a_inizio_file() ed a_fine_file()
address@hidden endfile
address@hidden
address@hidden file eg/lib/ftrans.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# November 1992
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/ftrans.awk
+
+FNR == 1 @{
+ if (_filename_ != "")
+ a_fine_file(_filename_)
+ _filename_ = FILENAME
+ a_inizio_file(FILENAME)
address@hidden
+
+END @{ a_fine_file(_filename_) @}
address@hidden endfile
address@hidden example
+
address@hidden
+La
address@hidden iftex
address@hidden wc}
+mostra come utilizzare questa funzione di libreria e come address@hidden
+semplifichi la scrittura del programma principale.
+
address@hidden sidebar, Allora perch@'e @command{gawk} ha @code{BEGINFILE} e
@code{ENDFILE}?
address@hidden
address@hidden
+<sidebar><title>Allora perch@'e @command{gawk} ha @code{BEGINFILE} e
@code{ENDFILE}?</title>
address@hidden docbook
+
+
+Ci si address@hidden, probabilmente: perch@'e, se le funzioni
@code{a_inizio_file()} e
address@hidden()} possono eseguire il compito, @command{gawk} prevede i
+criteri di
+ricerca @code{BEGINFILE} e @code{ENDFILE}?
+
+Buona domanda. Normalmente, se @command{awk} non riesce ad aprire un file,
+questo fatto
+provoca un errore fatale immediato. In tal caso, per una funzione definita
+dall'utente non vi @`e alcun modo di affrontare il problema, giacch@'e la
+chiamata verrebbe effettuata
+solo dopo aver aperto il file e letto il primo record.
+Quindi, la ragione principale di @code{BEGINFILE} @`e quella di dare un
+``aggancio'' per gestire i file che non posso essere elaborati.
address@hidden esiste per simmetria, e perch@'e consente facilmente
+una pulizia "file per file". Per maggiori informazioni si faccia
+riferimento alla @ref{BEGINFILE/ENDFILE}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Allora perch@'e @command{gawk} ha @code{BEGINFILE} e
@code{ENDFILE}?}
+
+
+
+Ci si address@hidden, probabilmente: perch@'e, se le funzioni
@code{a_inizio_file()} e
address@hidden()} possono eseguire il compito, @command{gawk} prevede i
+criteri di
+ricerca @code{BEGINFILE} e @code{ENDFILE}?
+
+Buona domanda. Normalmente, se @command{awk} non riesce ad aprire un file,
+questo fatto
+provoca un errore fatale immediato. In tal caso, per una funzione definita
+dall'utente non vi @`e alcun modo di affrontare il problema, giacch@'e la
+chiamata verrebbe effettuata
+solo dopo aver aperto il file e letto il primo record.
+Quindi, la ragione principale di @code{BEGINFILE} @`e quella di dare un
+``aggancio'' per gestire i file che non posso essere elaborati.
address@hidden esiste per simmetria, e perch@'e consente facilmente
+una pulizia "file per file". Per maggiori informazioni si faccia
+riferimento alla @ref{BEGINFILE/ENDFILE}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Funzione rewind
address@hidden Rileggere il file corrente
+
address@hidden file, leggere un
address@hidden file, rileggere un
+Un'altra richiesta per una nuova funzione predefinita @`e stata per
+una funzione per rileggere il file corrente.
+L'utente che l'ha richiesta non voleva dover usare @code{getline}
+(@pxref{Getline})
+all'interno di un ciclo.
+
+Comunque, se non si @`e nella regola @code{END}, @`e piuttosto facile
+fare in modo di chiudere il corrente file in input immediatamente
+e ricominciare a leggerlo dall'inizio.
+In mancanza di un nome migliore, chiameremo la funzione @code{rewind()}:
+
address@hidden @code{rewind()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{rewind()}
address@hidden
address@hidden file eg/lib/rewind.awk
+# rewind.awk --- ricarica il file corrente e ricomincia a leggerlo
address@hidden endfile
address@hidden
address@hidden file eg/lib/rewind.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# September 2000
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/rewind.awk
+
+function rewind( i)
address@hidden
+ # sposta in alto i rimanenti argomenti
+ for (i = ARGC; i > ARGIND; i--)
+ ARGV[i] = ARGV[i-1]
+
+ # assicurarsi che gawk sappia raggiungerli
+ ARGC++
+
+ # fa address@hidden@dotless{i}} che il file corrente sia il prossimo a
essere letto
+ ARGV[ARGIND+1] = FILENAME
+
+ # do it
+ nextfile
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{rewind()} dipende dalla variabile @code{ARGIND}
+(@pxref{Variabili auto-assegnate}), che @`e specifica di @command{gawk}.
Dipende anche
+dalla parola chiave @code{nextfile} (@pxref{Istruzione nextfile}).
address@hidden, non si dovrebbe chiamarla da una regola @code{ENDFILE}.
+(Non sarebbe peraltro necessario, perch@'e @command{gawk} legge il file
+successivo non appena la regola @code{ENDFILE} finisce!)
+
+Occorre prestare attenzione quando si chiama @code{rewind()}. Si
address@hidden
+provocare una ricorsione infinita se non si sta attenti. Ecco un
+esempio di uso:
+
address@hidden
+$ @kbd{cat dati}
address@hidden a
address@hidden b
address@hidden c
address@hidden d
address@hidden e
+
+$ cat @kbd{test.awk}
address@hidden FNR == 3 && ! riavvolto @{
address@hidden riavvolto = 1
address@hidden rewind()
address@hidden @}
address@hidden
address@hidden @{ print FILENAME, FNR, $0 @}
+
+$ @kbd{gawk -f rewind.awk -f test.awk dati }
address@hidden data 1 a
address@hidden data 2 b
address@hidden data 1 a
address@hidden data 2 b
address@hidden data 3 c
address@hidden data 4 d
address@hidden data 5 e
address@hidden example
+
address@hidden Controllo di file
address@hidden Controllare che i @value{DF} siano leggibili
+
address@hidden risoluzione di problemi, address@hidden file-dati
address@hidden address@hidden, address@hidden controllare la
address@hidden file, non elaborare
+Normalmente, se si fornisce ad @command{awk} un @value{DF} che non @`e
leggibile,
+il programma
+si arresta con un errore fatale. Ci sono casi in cui sarebbe preferibile
+ignorare semplicemente questi file e address@hidden criterio di
+ricerca speciale @code{BEGINFILE} (@pxref{BEGINFILE/ENDFILE}) fornisce un
+meccanismo alternativo per trattare i file che non sono leggibili.
+Tuttavia, il codice qui proposto fornisce una soluzione portabile.}
+Si address@hidden far questo facendo precedere il proprio programma
@command{awk} dal
+seguente programma:
+
address@hidden @code{readable.awk}, programma
address@hidden
address@hidden file eg/lib/readable.awk
+# readable.awk --- file di libreria per saltare file non leggibili
address@hidden endfile
address@hidden
address@hidden file eg/lib/readable.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# October 2000
+# December 2010
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/readable.awk
+
+BEGIN @{
+ for (i = 1; i < ARGC; i++) @{
+ if (ARGV[i] ~ /^[a-zA-Z_][a-zA-Z0-9_]*=.*/ \
+ || ARGV[i] == "-" || ARGV[i] == "/dev/stdin")
+ continue # assegnamento di variabile o standard input
+ else if ((getline aperdere < ARGV[i]) < 0) # file non leggibile
+ delete ARGV[i]
+ else
+ close(ARGV[i])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden risoluzione di problemi, funzione @code{getline}
address@hidden comando @code{getline}, risoluzione di problemi
address@hidden @code{getline}, comando, risoluzione di problemi
+Questo codice funziona, perch@'e l'errore di @code{getline} non @`e fatale.
+Rimuovendo l'elemento da @code{ARGV} con @code{delete}
+si tralascia il file (perch@'e non @`e address@hidden nella lista).
+Si veda anche @ref{ARGC e ARGV}.
+
+Poich@'e per i nomi delle variabili @command{awk} si possono usare solo lettere
+dell'alfabeto inglese, di proposito il controllo con espressioni regolari
+non usa classi di
+carattere come @samp{[:alpha:]} e @samp{[:alnum:]}
+(@pxref{Espressioni tra parentesi quadre}).
+
address@hidden File vuoti
address@hidden Ricerca di file di lunghezza zero
+
+Tutte le implementazioni note di @command{awk} ignorano senza
+mandare alcun messaggio i file di
+lunghezza zero. Questo @`e un effetto collaterale del ciclo implicito di
address@hidden "leggi un record e confrontalo con le regole": quando
address@hidden cerca di leggere un record da un file vuoto, riceve
immediatamente
+un'indicazione di fine-file address@hidden, chiude il file,
+e prosegue con il
+successivo @value{DF} presente nella riga di comando, @emph{senza}
+eseguire alcun codice
+di programma @command{awk} a livello di utente.
+
+Usando la variabile @code{ARGIND} di @command{gawk}
+(@pxref{Variabili predefinite}), @`e possibile accorgersi quando un @value{DF}
address@hidden stato saltato. Simile al file di libreria illustrato in
address@hidden filetrans}, il seguente file di libreria chiama una funzione
+di nome @code{zerofile()} che l'utente deve fornire. Gli argomenti passati
+sono il @value{FN} e la posizione del file in @code{ARGV}:
+
address@hidden @code{zerofile.awk}, programma
address@hidden
address@hidden file eg/lib/zerofile.awk
+# zerofile.awk --- file di libreria per elaborare file in input vuoti
address@hidden endfile
address@hidden
address@hidden file eg/lib/zerofile.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# June 2003
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/zerofile.awk
+
+BEGIN @{ Argind = 0 @}
+
+ARGIND > Argind + 1 @{
+ for (Argind++; Argind < ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
+
+ARGIND != Argind @{ Argind = ARGIND @}
+
+END @{
+ if (ARGIND > Argind)
+ for (Argind++; Argind <= ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
address@hidden endfile
address@hidden example
+
+La variabile definita dall'utente @code{Argind} permette al programma
address@hidden
+di tracciare il suo percorso all'interno di @code{ARGV}. Ogniqualvolta il
+programma rileva che @code{ARGIND} @`e maggiore di @samp{Argind + 1}, vuol dire
+che uno o address@hidden file vuoti sono stati tralasciati. L'azione chiama
poi
address@hidden()} per ogni file che @`e stato saltato, incrementando
+ogni volta @code{Argind}.
+
+La regola @samp{Argind != ARGIND} tiene semplicemente aggiornato @code{Argind}
+nel caso che non ci siano file vuoti.
+
+Infine, la regola @code{END} prende in considerazione il caso di un qualsiasi
+file vuoto alla fine degli argomenti nella riga di comando. Si noti che nella
+condizione del ciclo @code{for}, la verifica usa l'operatore @samp{<=}, non
address@hidden<}.
+
address@hidden Ignorare assegnamenti di variabili
address@hidden Trattare assegnamenti di variabile come @value{FNS}
+
address@hidden assegnamenti di variabile, visti come nomi di file
address@hidden file, nomi di, assegnamenti di variabile visti come
address@hidden nomi di file, assegnamenti di variabile visti come
+Occasionalmente, potrebbe essere address@hidden opportuno che @command{awk}
non elabori gli
+assegnamenti di variabile presenti sulla riga di comando
+(@pxref{Opzioni di assegnamento}).
+In particolare, se si ha un @value{FN} che contiene un carattere @samp{=},
address@hidden tratta il @value{FN} come un assegnamento e non lo elabora.
+
+Alcuni utenti hanno suggerito un'opzione aggiuntiva da riga di comando per
address@hidden per disabilitare gli assegnamenti dati sulla riga di comando.
+Comunque, poche righe di codice di programmazione in un file di libreria
+hanno lo stesso effetto:
+
address@hidden @code{noassign.awk}, programma
address@hidden programma @code{noassign.awk}
address@hidden
address@hidden file eg/lib/noassign.awk
+# noassign.awk --- file di libreria per evitare la address@hidden
+# di una speciale opzione per disabilitare gli assegnamenti da
+# riga di comando
address@hidden endfile
address@hidden
address@hidden file eg/lib/noassign.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# October 1999
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/noassign.awk
+
+function disable_assigns(argc, argv, i)
address@hidden
+ for (i = 1; i < argc; i++)
+ if (argv[i] ~ /^[a-zA-Z_][a-zA-Z0-9_]*=.*/)
+ argv[i] = ("./" argv[i])
address@hidden
+
+BEGIN @{
+ if (Disabilita_variabili)
+ disable_assigns(ARGC, ARGV)
address@hidden
address@hidden endfile
address@hidden example
+
+Il programma va poi eseguito in questo modo:
+
address@hidden
+awk -v Disabilita_variabili=1 -f noassign.awk -f vostro_programma.awk *
address@hidden example
+
+La funzione esegue un ciclo che esamina ogni argomento.
+Antepone @samp{./} a
+qualsiasi argomento che abbia la forma di un assegnamento
+di variabile, trasformando address@hidden@dotless{i}} quell'argomento in un
@value{FN}.
+
+L'uso di @code{Disabilita_variabili} consente di disabilitare assegnamenti di
+variabile dati sulla riga di comando al momento dell'invocazione,
+assegnando alla variabile un valore @dfn{vero}.
+Se non viene impostata la variabile @`e inizializzata a zero (address@hidden
address@hidden), e gli argomenti sulla riga di comando
+non vengono modificati.
+
address@hidden Funzione getopt
address@hidden Elaborare opzioni specificate sulla riga di comando
+
address@hidden libreria di funzioni @command{awk}, opzioni sulla riga di comando
address@hidden funzioni, libreria di, opzioni sulla riga di comando
address@hidden riga di comando, opzioni, elaborazione di
address@hidden opzioni sulla riga di comando, elaborazione di
address@hidden funzioni, libreria di, libreria C
address@hidden argomenti, elaborazione di
+La maggior parte dei programmi di address@hidden su sistemi compatibili con
POSIX
+prevedono opzioni presenti sulla riga di comando che possono essere usate per
+cambiare il modo in cui un programma si comporta. @command{awk} @`e un
esempio di
+tali programmi (@pxref{Opzioni}).
+Spesso le opzioni hanno degli @dfn{argomenti} (address@hidden, dati che
servono al
+programma per eseguire correttamente le opzioni specificate
+sulla riga di comando).
+Per esempio, l'opzione @option{-F} di @command{awk} richiede di usare la
stringa
+specificata
+come separatore di campo. La prima occorrenza, sulla riga di comando, di
address@hidden o di una stringa che non inizia con @samp{-} segnala la fine
+delle opzioni.
+
address@hidden @code{getopt()}, funzione (libreria C)
address@hidden funzione @code{getopt()} (libreria C)
+I moderni sistemi Unix hanno una funzione C chiamata @code{getopt()} per
+elaborare gli argomenti presenti
+sulla riga di comando. Il programmatore fornisce una
+stringa che descrive le opzioni, ognuna delle quali consiste di
+una sola lettera. Se un'opzione richiede un
+argomento, nella stringa l'opzione @`e seguita da due punti.
+A @code{getopt()} vengono anche
+passati il numero e i valori degli argomenti presenti sulla riga di comando
+e viene chiamata in un ciclo.
address@hidden()} scandisce gli argomenti della riga di comando cercando
+le lettere delle opzioni.
+A ogni passaggio del ciclo restituisce un carattere
+singolo che rappresenta la successiva lettera di opzione trovata, o @samp{?}
+se viene trovata un'opzione non prevista.
+Quando restituisce @minus{}1, non ci sono ulteriori
+opzioni da trattare sulla riga di comando.
+
+Quando si usa @code{getopt()}, le opzioni che non prevedono argomenti
+possono essere raggruppate.
+Inoltre, le opzioni che hanno argomenti richiedono obbligatoriamente che
+l'argomento sia specificato.
+L'argomento address@hidden seguire immediatamente la lettera
+dell'opzione, o address@hidden costituire un argomento separato sulla riga di
comando.
+
+Dato un ipotetico programma che ha tre opzioni sulla riga di comando,
address@hidden, @option{-b} e @option{-c}, dove
address@hidden richiede un argomento, tutti i seguenti sono modi validi per
+invocare il programma:
+
address@hidden
+programma -a -b pippo -c dati1 dati2 dati3
+programma -ac -bpippo -- dati1 dati2 dati3
+programma -acbpippo dati1 dati2 dati3
address@hidden example
+
+Si noti che quando l'argomento @`e raggruppato con la sua opzione,
+la parte rimanente
+dell'argomento @`e considerato come argomento dell'opzione.
+In quest'esempio, @option{-acbpippo} indica che tutte le opzioni
address@hidden, @option{-b} e @option{-c} sono presenti,
+e che @samp{pippo} @`e l'argomento dell'opzione @option{-b}.
+
address@hidden()} fornisce quattro variabili esterne a disposizione del
+programmatore:
+
address@hidden @code
address@hidden optind
+L'indice nel vettore dei valori degli argomenti (@code{argv}) dove si
address@hidden
+trovare il primo argomento sulla riga di comando che non sia un'opzione.
+
address@hidden optarg
+Il valore (di tipo stringa) dell'argomento di un'opzione.
+
address@hidden opterr
+Solitamente @code{getopt()} stampa un messaggio di errore quando trova
un'opzione
+non valida. Impostando @code{opterr} a zero si disabilita questa
address@hidden
+(un'applicazione potrebbe voler stampare un proprio messaggio di errore.)
+
address@hidden optopt
+La lettera che rappresenta l'opzione sulla riga di comando.
address@hidden table
+
+Il seguente frammento di codice C mostra come @code{getopt()} potrebbe
+elaborare gli argomenti della riga di comando per @command{awk}:
+
address@hidden
+int
+main(int argc, char *argv[])
address@hidden
+ @dots{}
+ /* stampa un appropriato messaggio */
+ opterr = 0;
+ while ((c = getopt(argc, argv, "v:f:F:W:")) != -1) @{
+ switch (c) @{
+ case 'f': /* file */
+ @dots{}
+ break;
+ case 'F': /* separatore di campo */
+ @dots{}
+ break;
+ case 'v': /* assegnamento di variabile */
+ @dots{}
+ break;
+ case 'W': /* estensione */
+ @dots{}
+ break;
+ case '?':
+ default:
+ messaggio_di_aiuto();
+ break;
+ @}
+ @}
+ @dots{}
address@hidden
address@hidden example
+
+Incidentalmente, @command{gawk} al suo interno usa la funzione GNU
address@hidden()} per elaborare sia le normali opzioni che quelle lunghe
+in stile GNU
+(@pxref{Opzioni}).
+
+L'astrazione fornita da @code{getopt()} @`e molto utile ed @`e piuttosto comoda
+anche nei programmi @command{awk}. Di seguito si riporta una versione
address@hidden di @code{getopt()}. Questa funzione mette in evidenza uno dei
+maggiori punti deboli di @command{awk}, che @`e quello di essere molto carente
+nella manipolazione di caratteri singoli. Sono necessarie ripetute chiamate a
address@hidden()} per accedere a caratteri singoli.
+(@pxref{Funzioni per stringhe})address@hidden funzione
address@hidden stata scritta prima che @command{gawk} acquisisse la
address@hidden di
+dividere le stringhe in caratteri singoli usando @code{""} come separatore.
address@hidden stata lasciata address@hidden@dotless{i}}, poich@'e l'uso di
@code{substr()} @`e address@hidden portabile.}
+
+La spiegazione della funzione viene data
+man mano che si elencano i pezzi di codice che la compongono:
+
address@hidden @code{getopt()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getopt()}
address@hidden
address@hidden file eg/lib/getopt.awk
+# getopt.awk --- imita in awk la funzione di libreria C getopt(3)
address@hidden endfile
address@hidden
address@hidden file eg/lib/getopt.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+#
+# Initial version: March, 1991
+# Revised: May, 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/getopt.awk
+
+# Variabili esterne:
+# Optind -- indice in ARGV del primo argomento che non @`e un'opzione
+# Optarg -- valore di tipo stringa dell'argomento dell'opzione corrente
+# Opterr -- se diverso da zero, viene stampato un messaggio diagnostico
+# Optopt -- lettera dell'opzione corrente
+
+# Restituisce:
+# -1 alla fine delle opzioni
+# "?" per un'opzione non riconosciuta
+# <c> un carattere che rappresenta l'opzione corrente
+
+# Dati privati:
+# _opti -- indice in un'opzione multipla, p.es., -abc
address@hidden endfile
address@hidden example
+
+La funzione inizia con commenti che elencano e descrivono le variabili globali
+utilizzate, spiegano quali sono i valori di ritorno, il loro significato, e
+ogni altra variabile che @`e
+``esclusiva'' a questa funzione di libreria. Tale
+documentazione @`e essenziale per qualsiasi programma, e in modo particolare
per
+le funzioni di libreria.
+
+La funzione @code{getopt()} dapprima controlla che sia stata effettivamente
+chiamata con una stringa di opzioni (il parametro @code{opzioni}). Se
address@hidden ha lunghezza zero, @code{getopt()} restituisce immediatamente
address@hidden:
+
address@hidden @code{getopt()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getopt()}
address@hidden
address@hidden file eg/lib/getopt.awk
+function getopt(argc, argv, opzioni, unaopz, i)
address@hidden
+ if (length(opzioni) == 0) # nessuna opzione specificata
+ return -1
+
address@hidden
+ if (argv[Optind] == "--") @{ # fatto tutto
+ Optind++
+ _opti = 0
+ return -1
address@hidden group
+ @} else if (argv[Optind] !~ /^-[^:[:space:]]/) @{
+ _opti = 0
+ return -1
+ @}
address@hidden endfile
address@hidden example
+
+Il successivo controllo cerca la fine delle opzioni. Due trattini
+(@option{--}) marcano la fine delle opzioni da riga di comando, e lo stesso
+fa qualsiasi
+argomento sulla riga di comando che non inizi con @samp{-}. @code{Optind} @`e
+usato per scorrere il vettore degli argomenti presenti sulla riga di comando;
+mantiene il suo valore attraverso chiamate successive a @code{getopt()},
perch@'e
address@hidden una variabile globale.
+
+L'espressione regolare che viene usata, @address@hidden/^-[^:[:space:]/}},
+chiede di cercare un
address@hidden seguito da qualsiasi cosa che non sia uno spazio vuoto o un
carattere
+di due punti. Se l'argomento corrente sulla riga di comando non corrisponde a
+quest'espressione regolare, vuol dire che non si tratta di un'opzione, e
+quindi viene terminata l'elaborazione delle opzioni. Continuando:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+ if (_opti == 0)
+ _opti = 2
+ unaopz = substr(argv[Optind], _opti, 1)
+ Optopt = unaopz
+ i = index(opzioni, unaopz)
+ if (i == 0) @{
+ if (Opterr)
+ printf("%c -- opzione non ammessa\n", unaopz) > "/dev/stderr"
+ if (_opti >= length(argv[Optind])) @{
+ Optind++
+ _opti = 0
+ @} else
+ _opti++
+ return "?"
+ @}
address@hidden endfile
address@hidden example
+
+La variabile @code{_opti} tiene traccia della posizione nell'argomento
+della riga di comando correntemente in esame
+(@code{argv[Optind]}). Se opzioni multiple sono
+raggruppate con un @samp{-} (p.es., @option{-abx}), @`e necessario
+restituirle all'utente una per volta.
+
+Se @code{_opti} @`e uguale a zero, viene impostato a due, ossia all'indice
+nella
+stringa del successivo carattere da esaminare (@samp{-}, che @`e alla
+posizione uno viene ignorato).
+La variabile @code{unaopz} contiene il carattere,
+ottenuto con @code{substr()}. Questo @`e salvato in @code{Optopt} per essere
+usato dal programma principale.
+
+Se @code{unaopz} non @`e nella stringa delle opzioni @code{opzioni},
+si tratta di un'opzione
+non valida. Se @code{Opterr} @`e diverso da zero, @code{getopt()} stampa un
+messaggio di errore sullo @dfn{standard error} che @`e simile al messaggio
+emesso dalla versione C di @code{getopt()}.
+
+Poich@'e l'opzione non @`e valida, @`e necessario tralasciarla e passare al
successivo
+carattere di opzione. Se @code{_opti} @`e maggiore o uguale alla lunghezza
+dell'argomento corrente della riga di comando, @`e necessario passare al
+successivo argomento, in modo che @code{Optind} venga incrementato e
address@hidden sia reimpostato a zero. In caso contrario, @code{Optind} viene
+lasciato com'@`e e @code{_opti} viene soltanto incrementato.
+
+In ogni caso, poich@'e l'opzione non @`e valida, @code{getopt()} restituisce
address@hidden"?"}. Il programma principale address@hidden esaminare
@code{Optopt} se serve
+conoscere quale lettera di opzione @`e quella non valida. Proseguendo:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+ if (substr(opzioni, i + 1, 1) == ":") @{
+ # ottiene un argomento di opzione
+ if (length(substr(argv[Optind], _opti + 1)) > 0)
+ Optarg = substr(argv[Optind], _opti + 1)
+ else
+ Optarg = argv[++Optind]
+ _opti = 0
+ @} else
+ Optarg = ""
address@hidden endfile
address@hidden example
+
+Se l'opzione richiede un argomento, la lettera di opzione @`e seguita da due
punti
+nella stringa @code{opzioni}. Se rimangono altri caratteri nell'argomento
+corrente sulla riga di comando (@code{argv[Optind]}), il resto di quella
stringa
+viene assegnato a @code{Optarg}. Altrimenti, viene usato il successivo
+argomento sulla riga di comando (@samp{-xFOO} piuttosto che
address@hidden@w{-x FOO}}). In
+entrambi i casi, @code{_opti} viene reimpostato a zero, perch@'e non ci sono
altri
+caratteri da esaminare nell'argomento corrente sulla riga di comando.
+Continuando:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+ if (_opti == 0 || _opti >= length(argv[Optind])) @{
+ Optind++
+ _opti = 0
+ @} else
+ _opti++
+ return unaopz
address@hidden
address@hidden endfile
address@hidden example
+
+Infine, se @code{_opti} @`e zero o maggiore della lunghezza dell'argomento
+corrente sulla riga di comando, significa che l'elaborazione di
+quest'elemento in @code{argv} @`e
+terminata, quindi @code{Optind} @`e incrementato per
+puntare al successivo elemento in @code{argv}. Se nessuna delle condizioni @`e
+vera, viene incrementato solo @code{_opti}, cosicch@'e la successiva lettera di
+opzione address@hidden essere elaborata con la successiva chiamata a
@code{getopt()}.
+
+La regola @code{BEGIN} inizializza sia @code{Opterr} che @code{Optind} a uno.
address@hidden viene impostato a uno, perch@'e il comportamento di default per
address@hidden()} @`e quello di stampare un messaggio diagnostico dopo aver
visto
+un'opzione non valida. @code{Optind} @`e impostato a uno, perch@'e non
+c'@`e alcun motivo
+per considerare il nome del programma, che @`e in @code{ARGV[0]}:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+BEGIN @{
+ Opterr = 1 # il default @`e eseguire una diagnosi
+ Optind = 1 # salta ARGV[0]
+
+ # programma di controllo
+ if (_getopt_test) @{
+ while ((_go_c = getopt(ARGC, ARGV, "ab:cd")) != -1)
+ printf("c = <%c>, Optarg = <%s>\n",
+ _go_c, Optarg)
+ printf("argomenti che non sono opzioni:\n")
+ for (; Optind < ARGC; Optind++)
+ printf("\tARGV[%d] = <%s>\n",
+ Optind, ARGV[Optind])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Il resto della regola @code{BEGIN} @`e un semplice programma di controllo. Qui
+sotto si riportano i risultati di
+due esecuzioni di prova
+del programma di controllo:
+
address@hidden
+$ @kbd{awk -f getopt.awk -v _getopt_test=1 -- -a -cbARG bax -x}
address@hidden c = <a>, Optarg = <>
address@hidden c = <c>, Optarg = <>
address@hidden c = <b>, Optarg = <ARG>
address@hidden argomenti che non sono opzioni:
address@hidden ARGV[3] = <bax>
address@hidden ARGV[4] = <-x>
+
+$ @kbd{awk -f getopt.awk -v _getopt_test=1 -- -a -x -- xyz abc}
address@hidden c = <a>, Optarg = <>
address@hidden x -- opzione non ammessa
address@hidden c = <?>, Optarg = <>
address@hidden argomenti che non sono opzioni:
address@hidden ARGV[4] = <xyz>
address@hidden ARGV[5] = <abc>
address@hidden example
+
+In entrambe le esecuzioni, il primo @option{--} fa terminare gli argomenti dati
+ad @command{awk}, in modo che @command{awk} non tenti di interpretare le
opzioni
address@hidden, etc. come sue opzioni.
+
address@hidden NOTA
+Dopo che @code{getopt()} @`e terminato,
+il codice a livello utente deve eliminare tutti gli elementi
+di @code{ARGV} da
+1 a @code{Optind}, in modo che @command{awk} non tenti di elaborare le opzioni
+sulla riga di comando come @value{FNS}.
address@hidden quotation
+
+Usare @samp{#!} con l'opzione @option{-E} address@hidden essere d'aiuto per
evitare
+conflitti tra le opzioni del proprio programma e quelle di @command{gawk},
+poich@'e l'opzione @option{-E} fa address@hidden@dotless{i}} che
@command{gawk} abbandoni
+l'elaborazione di ulteriori opzioni.
+(@address@hidden eseguibili} e
address@hidden
address@hidden).
address@hidden ifnotdocbook
address@hidden
address@hidden).
address@hidden ifdocbook
+
+Molti degli esempi presentati in
address@hidden di esempio},
+usano @code{getopt()} per elaborare i propri argomenti.
+
address@hidden Funzioni Passwd
address@hidden Leggere la lista degli utenti
+
address@hidden libreria di funzioni @command{awk}, leggere la lista degli utenti
address@hidden funzioni, libreria di, leggera la lista degli utenti
address@hidden utenti, leggere la lista degli
address@hidden lista degli address@hidden leggere la
address@hidden @code{PROCINFO}, vettore
address@hidden vettore @code{PROCINFO}
+Il vettore @code{PROCINFO}
+(@pxref{Variabili predefinite})
address@hidden accesso ai numeri ID reale ed effettivo dell'utente e del gruppo
e, se
+disponibili, alla serie di gruppi ulteriori a cui l'utente appartiene.
+Comunque, poich@'e questi sono numeri, non forniscono informazioni molto utili
per
+l'utente medio. Bisogna trovare un modo per reperire informazioni
+sull'utente associate con i numeri ID dell'utente e del gruppo. Questa
address@hidden illustra una raccolta di funzioni per ottenere le informazioni
+dalla lista gli utenti. @xref{Funzioni Group} per una raccolta di
+funzioni simili per ottenere informazioni dalla lista dei gruppi.
+
address@hidden @code{getpwent()}, funzione (libreria C)
address@hidden funzione @code{getpwent()} (libreria C)
address@hidden @code{getpwent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwent()}
address@hidden utenti, informazioni riguardo agli, ottenere
address@hidden login, informazioni
address@hidden account, informazioni sugli
address@hidden password, file delle
address@hidden file delle password
+Lo standard POSIX non definisce il file dove sono mantenute le informazioni
+degli utenti. Invece, fornisce il file d'intestazione @code{<pwd.h>}
+e diverse @dfn{subroutine} del linguaggio C per ottenere informazioni sugli
+utenti. La funzione primaria @`e @code{getpwent()}, che sta per ``get password
+entry''. La ``password'' proviene dal file originale della lista
+degli utenti, @file{/etc/passwd}, che contiene le informazioni sugli utenti
+assieme alle password criptate (da cui il nome)address@hidden @`e
+vero per le versioni address@hidden antiche di Unix. In quelle address@hidden
recenti,
+la @dfn{password} di ogni utente @`e stata trasferita nel file
@file{/etc/shadow},
+un file non accessibile dall'utente normale. La struttura del file
address@hidden/etc/passwd} @`e rimasta la stessa, ma al posto del campo
@dfn{password}
+c'@`e una @code{x}.}
+
address@hidden @command{pwcat}, programma
+Sebbene un programma @command{awk} possa semplicemente leggere
address@hidden/etc/passwd} direttamente, questo file address@hidden non
contenere tutte le
+informazioni su tutti gli utenti del address@hidden spesso che le
+informazioni sulla password siano memorizzate in una lista in rete.} Per
+essere sicuri di poter produrre una versione leggibile e completa della banca
+dati degli utenti, @`e necessario scrivere un piccolo programma in C che chiama
address@hidden()}. @code{getpwent()} viene definita in modo da restituire un
+puntatore a una @code{struct passwd}. Ogni volta che viene chiamata,
+restituisce l'elemento successivo della lista. Quando non ci sono
address@hidden
+elementi, restituisce @code{NULL}, il puntatore nullo. Quando accade
address@hidden, il
+programma C dovrebbe chiamare @code{endpwent()} per chiudere la lista..
+Quel che segue @`e @command{pwcat}, un programma in C che ``concatena'' la
+lista delle password:
+
address@hidden
address@hidden file eg/lib/pwcat.c
+/*
+ * pwcat.c
+ *
+ * Genera una versione stampabile della lista delle password.
+ */
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+/*
+ * Arnold Robbins, arnold@@skeeve.com, May 1993
+ * Public Domain
+ * December 2010, move to ANSI C definition for main().
+ */
+
+#if HAVE_CONFIG_H
+#include <config.h>
+#endif
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+#include <stdio.h>
+#include <pwd.h>
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+#if defined (STDC_HEADERS)
+#include <stdlib.h>
+#endif
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+int
+main(int argc, char **argv)
address@hidden
+ struct passwd *p;
+
+ while ((p = getpwent()) != NULL)
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+#ifdef ZOS_USS
+ printf("%s:%ld:%ld:%s:%s\n",
+ p->pw_name, (long) p->pw_uid,
+ (long) p->pw_gid, p->pw_dir, p->pw_shell);
+#else
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+ printf("%s:%s:%ld:%ld:%s:%s:%s\n",
+ p->pw_name, p->pw_passwd, (long) p->pw_uid,
+ (long) p->pw_gid, p->pw_gecos, p->pw_dir, p->pw_shell);
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+#endif
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+
+ endpwent();
+ return 0;
address@hidden
address@hidden endfile
address@hidden example
+
+Se non si conosce il linguaggio C, non @`e il caso di preoccuparsi.
+L'output di @command{pwcat} @`e la lista degli utenti, nel formato
+tradizionale del file @file{/etc/passwd} con campi separati da due punti.
+I campi sono:
+
address@hidden @asis
address@hidden Login name
+Il nome di login dell'utente.
+
address@hidden Encrypted password
+La password criptata dell'utente. address@hidden non essere disponibile su
alcuni sistemi.
+
address@hidden User-ID
+L'ID numerico dell'utente.
+(Su alcuni sistemi, @`e un numero di formato @code{long} [32bit]
+del linguaggio C, e non nel formato @code{int} [16bit].
+Quindi, lo cambieremo in @code{long} per sicurezza.)
+
address@hidden Group-ID
+L'ID di gruppo numerico dell'utente.
+(Valgono le stesse considerazioni su @code{long} al posto di @code{int}.)
+
address@hidden Full name
+Il nome completo dell'utente, e talora altre informazioni associate
+all'utente.
+
address@hidden Home directory
+La directory di login (o ``home'') (nota ai programmatori di shell come
address@hidden).
+
address@hidden Login shell
+Il programma che viene eseguito quando l'utente effettua l'accesso. Questo @`e
+comunemente una shell, come Bash.
address@hidden table
+
+Di seguito si riportano alcune righe di un possibile output di @command{pwcat}:
+
address@hidden Jacobs, Andrew
address@hidden Robbins, Arnold
address@hidden Robbins, Miriam
address@hidden
+$ @kbd{pwcat}
address@hidden root:x:0:1:Operator:/:/bin/sh
address@hidden nobody:x:65534:65534::/:
address@hidden daemon:x:1:1::/:
address@hidden sys:x:2:2::/:/bin/csh
address@hidden bin:x:3:3::/bin:
address@hidden arnold:x:2076:10:Arnold Robbins:/home/arnold:/bin/sh
address@hidden miriam:x:112:10:Miriam Robbins:/home/miriam:/bin/sh
address@hidden andy:x:113:10:Andy Jacobs:/home/andy:/bin/sh
address@hidden
address@hidden example
+
+Dopo quest'introduzione, di seguito si riporta un gruppo di funzioni per
+ottenere informazioni sugli utenti. Ci sono diverse funzioni, che
+corrispondono alle omonime funzioni C:
+
address@hidden @code{_pw_init()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{_pw_init()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+# passwd.awk --- accedere alle informazioni del file delle password
address@hidden endfile
address@hidden
address@hidden file eg/lib/passwdawk.in
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised October 2000
+# Revised December 2010
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/passwdawk.in
+
+BEGIN @{
+ # modificare per adattarlo al sistema in uso
+ _pw_awklib = "/usr/local/libexec/awk/"
address@hidden
+
+function _pw_init( oldfs, oldrs, olddol0, pwcat, using_fw, using_fpat)
address@hidden
+ if (_pw_inizializzato)
+ return
+
+ oldfs = FS
+ oldrs = RS
+ olddol0 = $0
+ using_fw = (PROCINFO["FS"] == "FIELDWIDTHS")
+ using_fpat = (PROCINFO["FS"] == "FPAT")
+ FS = ":"
+ RS = "\n"
+
+ pwcat = _pw_awklib "pwcat"
+ while ((pwcat | getline) > 0) @{
+ _pw_byname[$1] = $0
+ _pw_byuid[$3] = $0
+ _pw_bycount[++_pw_totale] = $0
+ @}
+ close(pwcat)
+ _pw_contatore = 0
+ _pw_inizializzato = 1
+ FS = oldfs
+ if (using_fw)
+ FIELDWIDTHS = FIELDWIDTHS
+ else if (using_fpat)
+ FPAT = FPAT
+ RS = oldrs
+ $0 = olddol0
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, programma @code{pwcat}
address@hidden criterio di ricerca @code{BEGIN}, programma @code{pwcat}
+La regola @code{BEGIN} imposta una variabile privata col nome
+della directory in cui si
+trova @command{pwcat}.
+Poich@'e @`e destinata a essere usata da una routine di
+libreria di @command{awk}, si @`e scelto di metterla in
address@hidden/usr/local/libexec/awk}; comunque, in un altro sistema potrebbe
+essere messa in una directory differente.
+
+La funzione @code{_pw_init()} mette tre copie delle informazioni sull'utente in
+tre vettori associativi. I vettori sono indicizzati per nome-utente
+(@code{_pw_byname}), per numero di ID-utente (@code{_pw_byuid}), e per ordine
di
+occorrenza (@code{_pw_bycount}).
+La variabile @code{_pw_inizializzato} @`e usata per
+efficienza, poich@'e in questo modo @code{_pw_init()}
+viene chiamata solo una volta.
+
address@hidden @code{PROCINFO}, vettore, verificare la divisione in campi
address@hidden vettore @code{PROCINFO}, verificare la divisione in campi
address@hidden @code{getline}, comando, funzione definita dall'utente,
@code{_pw_init()}
address@hidden comando @code{getline}, funzione definita dall'utente,
@code{_pw_init()}
+Poich@'e questa funzione usa @code{getline} per leggere informazioni da
address@hidden, dapprima salva i valori di @code{FS}, @code{RS} e @code{$0}.
+Annota nella variabile @code{using_fw} se la suddivisione in campi
+usando @code{FIELDWIDTHS} @`e attiva o no.
+Far questo @`e necessario, poich@'e queste funzioni potrebbero essere chiamate
da
+qualsiai parte all'interno di un programma dell'utente, e l'utente
address@hidden
+suddividere i record in campi a suo piacimento.
address@hidden rende possibile ripristinare il corretto meccanismo di
suddivisione dei
+campi in un secondo momento. La verifica address@hidden restituire solo
@dfn{vero} per
address@hidden
+Il risultato address@hidden essere @dfn{falso} se si usa
address@hidden o @code{FPAT},
+o in qualche altra implementazione di @command{awk}.
+
+Il codice che controlla se si sta usando @code{FPAT}, utilizzando
address@hidden e @code{PROCINFO["FS"]}, @`e simile.
+
+La parte principale della funzione usa un ciclo per leggere le righe della
+lista, suddividere le righe in campi, e poi memorizzare la riga
+all'interno di ogni vettore a seconda delle address@hidden Quando il ciclo @`e
+completato, @address@hidden()}} fa pulizia chiudendo la @dfn{pipe},
+impostando @address@hidden a uno, e ripristinando @code{FS}
+(e @code{FIELDWIDTHS} o @code{FPAT}
+se necessario), @code{RS} e @code{$0}.
+L'uso di @address@hidden address@hidden spiegato a breve.
+
address@hidden @code{getpwnam()}, funzione (libreria C)
address@hidden funzione @code{getpwnam()} (libreria C)
+La funzione @code{getpwnam()} ha un nome utente come argomento di tipo
+stringa. Se
+quell'utente @`e presente nella lista, restituisce la riga appropriata.
+Altrimenti, il riferimento a un elemento inesistente del vettore
+aggiunge al vettore stesso un elemento il cui valore @`e la stringa nulla:
+
address@hidden @code{getpwnam()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwnam()}
address@hidden
address@hidden
address@hidden file eg/lib/passwdawk.in
+function getpwnam(nome)
address@hidden
+ _pw_init()
+ return _pw_byname[nome]
address@hidden
address@hidden endfile
address@hidden group
address@hidden example
+
address@hidden @code{getpwuid()}, funzione (libreria C)
address@hidden funzione @code{getpwuid()} (libreria C)
+In modo simile, la funzione @code{getpwuid()} ha per argomento
+il numero ID di un utente.
+Se un utente con quel numero si trova nella lista, restituisce la riga
+appropriata. Altrimenti restituisce la stringa nulla:
+
address@hidden @code{getpwuid()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwuid()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+function getpwuid(uid)
address@hidden
+ _pw_init()
+ return _pw_byuid[uid]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getpwent()}, funzione (libreria C)
address@hidden funzione @code{getpwent()} (libreria C)
+La funzione @code{getpwent()} scorre semplicemnte la lista, un elemento
+alla volta. Usa @code{_pw_contatore} per tener traccia della posizione
corrente
+nel vettore @code{_pw_bycount}:
+
address@hidden @code{getpwent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwent()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+function getpwent()
address@hidden
+ _pw_init()
+ if (_pw_contatore < _pw_totale)
+ return _pw_bycount[++_pw_contatore]
+ return ""
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{endpwent()}, funzione (libreria C)
address@hidden funzione @code{endpwent()} (libreria C)
+La funzione @address@hidden()}} reimposta @address@hidden a zero,
+in modo che chiamate successive a @code{getpwent()} ricomincino da capo:
+
address@hidden @code{endpwent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{endpwent()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+function endpwent()
address@hidden
+ _pw_contatore = 0
address@hidden
address@hidden endfile
address@hidden example
+
+In questa serie di funzioni, il fatto che ogni subroutine chiami
address@hidden@w{_pw_init()}}
+per inizializzare il vettore della lista utenti risponde a una precisa
+scelta progettuale.
+Il lavoro necessario per eseguire un processo separato che generi la
+lista degli utenti, e l'I/O per esaminarla, si ha solo se il programma
+principale dell'utente chiama effettivamente una di queste funzioni.
+Se questo
+file di libreria viene caricato assieme a un programma dell'utente, ma non
+viene mai chiamata nessuna delle routine, non c'@`e nessun lavoro aggiuntivo
+richiesto in fase di esecuzione.
+(L'alternativa @`e quella di spostare il corpo di @address@hidden()}}
+all'interno di una regola @code{BEGIN}, che esegua sempre @command{pwcat}.
+Questo semplifica il codice ma richiede di eseguire un processo extra
+il cui risultato potrebbe non essere mai utilizzato dal programma.)
+
+A sua volta, chiamare ripetutamente @code{_pw_init()} non @`e troppo
+dispendioso, perch@'e la
+variabile @code{_pw_inizializzato} permette di evitare di leggere
+i dati relativi agli utenti address@hidden di una
+volta. Se la preoccupazione @`e quella di minimizzare il tempo di
+esecuzione del programma @command{awk},
+il controllo di @code{_pw_inizializzato} potrebbe essere spostato
+al di fuori di @code{_pw_init()} e duplicato in tutte le altre funzioni.
+In pratica, questo non @`e necessario, poich@'e la maggior parte dei
+programmi di @command{awk}
address@hidden I/address@hidden programmi si distinguono tradizionalemente in
+CPU-bound e I/O-bound. Quelli CPU-bound effettuano elaborazioni che non
+richiedono molta address@hidden di I/O, come ad esempio la preparazione di una
+tavola di numeri primi. Quelli I/O bound leggono dei file, ma richiedono
+poca address@hidden di elaborazione per ogni record letto.},
+e una tale modifica complicherebbe inutilmente il codice.
+
+Il programma @command{id} in @ref{Programma id}
+usa queste funzioni.
+
address@hidden Funzioni Group
address@hidden Leggere la lista dei gruppi
+
address@hidden libreria di funzioni @command{awk}, leggere la lista dei gruppi
address@hidden funzioni, libreria di, leggere la lista dei gruppi
address@hidden gruppi, lista dei, leggere la
address@hidden lista dei gruppi, leggere la
address@hidden @code{PROCINFO}, vettore, e appartenenza a gruppi
address@hidden @code{getgrent()}, funzione (libreria C)
address@hidden funzione @code{getgrent()} (libreria C)
address@hidden @code{getgrent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrent()}
address@hidden address@hidden informazioni su
address@hidden account, informazioni sugli
address@hidden gruppi, file dei
address@hidden file dei gruppi
+Molto di quel che @`e stato detto
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden Passwd}
+vale anche per la lista dei gruppi. Sebbene questa sia tradizionalmente
+contenuta in
+un file ben noto (@file{/etc/group}) in un altrettanto noto formato,
+lo standard
+POSIX prevede solo una serie di routine della libreria C
+(@code{<grp.h>} e @code{getgrent()})
+per accedere a tali informazioni.
+Anche se il file suddetto @`e disponibile, potrebbe non contenere delle
+informazioni
+complete. address@hidden, come per la lista degli utenti, @`e necessario
avere un
+piccolo programma in C che genera la lista dei gruppi come suo output.
address@hidden, un programma in C che fornisce la lista dei gruppi,
address@hidden il seguente:
+
address@hidden @command{grcat}, programma C
address@hidden programma C, @command{grcat}
address@hidden
address@hidden file eg/lib/grcat.c
+/*
+ * grcat.c
+ *
+ * Genera una versione stampabile della lista dei gruppi.
+ */
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+/*
+ * Arnold Robbins, arnold@@skeeve.com, May 1993
+ * Public Domain
+ * December 2010, move to ANSI C definition for main().
+ */
+
+/* Per OS/2, non fare nulla. */
+#if HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#if defined (STDC_HEADERS)
+#include <stdlib.h>
+#endif
+
+#ifndef HAVE_GETGRENT
+int main() { return 0; }
+#else
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/grcat.c
+#include <stdio.h>
+#include <grp.h>
+
+int
+main(int argc, char **argv)
address@hidden
+ struct group *g;
+ int i;
+
+ while ((g = getgrent()) != NULL) @{
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+#ifdef ZOS_USS
+ printf("%s:%ld:", g->gr_name, (long) g->gr_gid);
+#else
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/grcat.c
+ printf("%s:%s:%ld:", g->gr_name, g->gr_passwd,
+ (long) g->gr_gid);
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+#else
+ printf("%s:*:%ld:", g->gr_name, (long) g->gr_gid);
+#endif
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/grcat.c
+ for (i = 0; g->gr_mem[i] != NULL; i++) @{
+ printf("%s", g->gr_mem[i]);
address@hidden
+ if (g->gr_mem[i+1] != NULL)
+ putchar(',');
+ @}
address@hidden group
+ putchar('\n');
+ @}
+ endgrent();
+ return 0;
address@hidden
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+#endif /* HAVE_GETGRENT */
address@hidden endfile
address@hidden ignore
address@hidden example
+
+Ciascuna riga nella lista dei gruppi rappresenta un gruppo. I campi sono
+separati da due punti e rappresentano le seguenti informazioni:
+
address@hidden @asis
address@hidden Nome del gruppo
+Il nome del gruppo.
+
address@hidden Password del gruppo
+La password del gruppo criptata. In pratica, questo campo non viene mai usato;
+normalmente @`e vuoto o impostato a @samp{x}.
+
address@hidden Numero ID del gruppo
+Il numero ID del gruppo in formato numerico;
+l'associazione del nome al numero dev'essere univoca all'interno di questo
file.
+(Su alcuni sistemi, @`e un numero nel formato @code{long} [32bit]
+del linguaggio C, e non nel formato @code{int} [16bit].
+Quindi, lo cambieremo in @code{long} per sicurezza.)
+
address@hidden Lista dei membri del gruppo
+Una lista di nomi utente separati da virgole.
+Questi utenti sono i membri del gruppo.
+I sistemi Unix moderni consentono agli utenti di appartenere a
+diversi gruppi simultaneamente. Se il sistema in uso @`e uno di questi, ci
sono
+elementi in @code{PROCINFO} che vanno da @code{"group1"} fino a
address@hidden"address@hidden"} per quei numeri di ID di gruppo.
+(Si noti che @code{PROCINFO} @`e un'estensione @command{gawk};
address@hidden predefinite}.)
address@hidden table
+
+Di seguito si riporta quel che @command{grcat} potrebbe produrre:
+
address@hidden
+$ @kbd{grcat}
address@hidden wheel:x:0:arnold
address@hidden nogroup:x:65534:
address@hidden daemon:x:1:
address@hidden kmem:x:2:
address@hidden staff:x:10:arnold,miriam,andy
address@hidden other:x:20:
address@hidden
address@hidden example
+
+Qui ci sono le funzioni per ottenere informazioni relative alla lista dei
+gruppi. Ce ne sono diverse, costruite sul modello delle omonime funzioni della
+libreria C:
+
address@hidden @code{getline}, comando, funzione definita dall'utente,
@code{_gr_init()}
address@hidden comando @code{getline}, funzione definita dall'utente,
@code{_gr_init()}
address@hidden @code{_gr_init()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{_gr_init()}
address@hidden
address@hidden file eg/lib/groupawk.in
+# group.awk --- funzioni per il trattamento del file dei gruppi
address@hidden endfile
address@hidden
address@hidden file eg/lib/groupawk.in
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised October 2000
+# Revised December 2010
address@hidden endfile
address@hidden ignore
address@hidden line break on _gr_init for smallbook
address@hidden file eg/lib/groupawk.in
+
+BEGIN @{
+ # Modificare in base alla struttura del proprio sistema
+ _gr_awklib = "/usr/local/libexec/awk/"
address@hidden
+
+function _gr_init( oldfs, oldrs, olddol0, grcat,
+ using_fw, using_fpat, n, a, i)
address@hidden
+ if (_gr_inizializzato)
+ return
+
+ oldfs = FS
+ oldrs = RS
+ olddol0 = $0
+ using_fw = (PROCINFO["FS"] == "FIELDWIDTHS")
+ using_fpat = (PROCINFO["FS"] == "FPAT")
+ FS = ":"
+ RS = "\n"
+
+ grcat = _gr_awklib "grcat"
+ while ((grcat | getline) > 0) @{
+ if ($1 in _gr_byname)
+ _gr_byname[$1] = _gr_byname[$1] "," $4
+ else
+ _gr_byname[$1] = $0
+ if ($3 in _gr_bygid)
+ _gr_bygid[$3] = _gr_bygid[$3] "," $4
+ else
+ _gr_bygid[$3] = $0
+
+ n = split($4, a, "[ \t]*,[ \t]*")
+ for (i = 1; i <= n; i++)
+ if (a[i] in _gr_groupsbyuser)
+ _gr_groupsbyuser[a[i]] = _gr_groupsbyuser[a[i]] " " $1
+ else
+ _gr_groupsbyuser[a[i]] = $1
+
+ _gr_bycount[++_gr_contatore] = $0
+ @}
+ close(grcat)
+ _gr_contatore = 0
+ _gr_inizializzato++
+ FS = oldfs
+ if (using_fw)
+ FIELDWIDTHS = FIELDWIDTHS
+ else if (using_fpat)
+ FPAT = FPAT
+ RS = oldrs
+ $0 = olddol0
address@hidden
address@hidden endfile
address@hidden example
+
+La regola @code{BEGIN} imposta una variabile privata con il nome della
+directory in cui si trova @command{grcat}.
+Poich@'e @`e destinata a essere usata da una routine di
+libreria di @command{awk}, si @`e scelto di metterla in
address@hidden/usr/local/libexec/awk}; comunque, in un altro sistema potrebbe
+essere messa in una directory differente.
+
+Queste routine seguono le stesse linee generali delle routine per formare la
+lista degli utenti (@pxref{Funzioni Passwd}).
+La variabile @address@hidden @`e usata per
+essere sicuri che la lista venga letta una volta sola.
+La funzione @address@hidden()}} dapprima salva @code{FS},
address@hidden e
address@hidden, e poi imposta @code{FS} e @code{RS} ai valori da usare nel
+passare in rassegna le informazioni di gruppo. Inoltre
+viene annotato se si stanno usando @code{FIELDWIDTHS} o @code{FPAT}, per
+poter poi
+ripristinare il meccanismo di suddivisione in campi appropriato.
+
+Le informazioni sui gruppi sono memorizzate in diversi vettori associativi.
+I vettori sono indicizzati per nome di gruppo (@address@hidden), per
+numero ID del gruppo (@address@hidden), e per posizione nella lista
+(@address@hidden). C'@`e un vettore aggiuntivo indicizzato per nome utente
+(@address@hidden), che @`e una lista, separata da spazi, dei
+gruppi ai quali ciascun utente appartiene.
+
+Diversamente dalla lista degli utenti, @`e possibile avere address@hidden
record
+nella lista per lo stesso gruppo. Questo @`e frequente quando un gruppo ha
+un gran numero di membri. Un paio di tali voci potrebbero essere come queste:
+
address@hidden
+tvpeople:x:101:johnny,jay,arsenio
+tvpeople:x:101:david,conan,tom,joan
address@hidden example
+
+Per questo motivo, @code{_gr_init()} controlla se un nome di gruppo o un numero
+di ID di gruppo @`e stato address@hidden visto. Se address@hidden@dotless{i}}
fosse, i nomi utente vanno
+semplicemente concatenati con la precedente lista di address@hidden'@`e un
+piccolo problema col codice appena illustrato. Supponiamo che la prima volta
+non ci siano nomi. Questo codice aggiunge i nomi con una virgola iniziale.
+Inoltre non controlla che ci sia un @code{$4}.}
+
+Infine, @code{_gr_init()} chiude la @dfn{pipe} a @command{grcat}, ripristina
address@hidden (e @code{FIELDWIDTHS} o @code{FPAT}, se necessario), @code{RS} e
address@hidden, inizializza @code{_gr_contatore} a zero
+(per essere usato address@hidden tardi), e rende @code{_gr_inizializzato}
diverso da zero.
+
address@hidden @code{getgrnam()}, funzione (libreria C)
address@hidden funzione @code{getgrnam()} (libreria C)
+La funzione @code{getgrnam()} ha come argomento un nome di gruppo, e se quel
+gruppo esiste, viene restituito.
+
+Altrimenti, il riferimento a un elemento inesistente del vettore
+aggiunge al vettore stesso un elemento il cui valore @`e la stringa nulla:
+
address@hidden @code{getgrnam()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrnam()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgrnam(group)
address@hidden
+ _gr_init()
+ return _gr_byname[group]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getgrgid()}, funzione (libreria C)
address@hidden funzione @code{getgrgid()} (libreria C)
+La funzione @code{getgrgid()} @`e simile; ha come argomento un numero ID di
+gruppo e controlla le informazioni assiciate con quell'ID di gruppo:
+
address@hidden @code{getgrgid()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrgid()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgrgid(gid)
address@hidden
+ _gr_init()
+ return _gr_bygid[gid]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getgruser()}, funzione (libreria C)
address@hidden funzione @code{getgruser()} (libreria C)
+La funzione @code{getgruser()} non ha un equivalente in C. Ha come argomento un
+nome-utente e restituisce l'elenco dei gruppi di cui l'utente @`e membro:
+
address@hidden @code{getgruser()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgruser()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgruser(user)
address@hidden
+ _gr_init()
+ return _gr_groupsbyuser[user]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getgrent()}, funzione (libreria C)
address@hidden funzione @code{getgrent()} (libreria C)
+La funzione @code{getgrent()} scorre la lista un elemento alla volta.
+Usa @code{_gr_contatore} per ricordare la posizione corrente nella lista:
+
address@hidden @code{getgrent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrent()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgrent()
address@hidden
+ _gr_init()
+ if (++_gr_contatore in _gr_bycount)
+ return _gr_bycount[_gr_contatore]
+ return ""
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{endgrent()}, funzione (libreria C)
address@hidden funzione @code{endgrent()} (libreria C)
+La funzione @code{endgrent()} reimposta @code{_gr_contatore} a zero in modo che
address@hidden()} possa ricominciare da capo:
+
address@hidden @code{endgrent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{endgrent()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function endgrent()
address@hidden
+ _gr_contatore = 0
address@hidden
address@hidden endfile
address@hidden example
+
+Come con le routine per la lista degli utenti, ogni funzione chiama
address@hidden()} per inizializzare i vettori.
address@hidden@dotless{i}} facendo si address@hidden il solo
+lavoro aggiuntivo di eseguire @command{grcat} se queste funzioni vengono
+usate (rispetto a spostare il corpo di @code{_gr_init()} all'interno della
+regola @code{BEGIN}).
+
+La maggior parte del lavoro consiste nell'ispezionare la lista e nel
+costruire i vari vettori associativi. Le funzioni che l'utente chiama sono
+di per s@'e molto semplici, poich@'e si appoggiano sui vettori associativi di
address@hidden per fare il lavoro.
+
+Il programma @command{id} in @ref{Programma id}
+usa queste funzioni.
+
address@hidden Visitare vettori
address@hidden Attraversare vettori di vettori
+
address@hidden
+La
address@hidden iftex
address@hidden di vettori} trattava come @command{gawk}
+avere a disposizione vettori di vettori. In particolare, qualsiasi elemento di
+un vettore address@hidden essere uno scalare o un altro vettore. La funzione
address@hidden()} (@pxref{Funzioni per i tipi})
+permette di distinguere un vettore
+da uno scalare.
+La seguente funzione, @code{walk_array()}, attraversa ricorsivamente
+un vettore, stampando gli indici e i valori di ogni elemento.
+Viene chiamata col vettore e con una stringa che contiene il nome
+del vettore:
+
address@hidden @code{walk_array()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{walk_array()}
address@hidden
address@hidden file eg/lib/walkarray.awk
+function walk_array(vett, nome, i)
address@hidden
+ for (i in vett) @{
+ if (isarray(vett[i]))
+ walk_array(vett[i], (nome "[" i "]"))
+ else
+ printf("%s[%s] = %s\n", nome, i, vett[i])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Funziona eseguendo un ciclo su ogni elemento del vettore. Se un dato elemento
address@hidden esso stesso un vettore, la funzione chiama s@'e stessa
ricorsivamente,
+passando il sottovettore e una nuova stringa che rappresenta l'indice corrente.
+In caso contrario, la funzione stampa semplicemente il nome, l'indice e il
+valore dell'elemento.
+Qui di seguito si riporta un programma principale che ne mostra l'uso:
+
address@hidden
+BEGIN @{
+ a[1] = 1
+ a[2][1] = 21
+ a[2][2] = 22
+ a[3] = 3
+ a[4][1][1] = 411
+ a[4][2] = 42
+
+ walk_array(a, "a")
address@hidden
address@hidden example
+
+Quando viene eseguito, il programma produce il seguente output:
+
address@hidden
+$ @kbd{gawk -f walk_array.awk}
address@hidden a[1] = 1
address@hidden a[2][1] = 21
address@hidden a[2][2] = 22
address@hidden a[3] = 3
address@hidden a[4][1][1] = 411
address@hidden a[4][2] = 42
address@hidden example
+
+La funzione appena illustrata stampa semplicemente il nome e il valore
+di ogni elemento costituito da un vettore scalare. Comunque @`e facile
+generalizzarla, passandole il nome di una funzione da chiamare
+quando si attraversa un vettore. La funzione modificata @`e simile a questa:
+
address@hidden
address@hidden file eg/lib/processarray.awk
+function process_array(vett, nome, elab, do_arrays, i, nuovo_nome)
address@hidden
+ for (i in vett) @{
+ nuovo_nome = (nome "[" i "]")
+ if (isarray(vett[i])) @{
+ if (do_arrays)
+ @@elab(nuovo_nome, vett[i])
+ process_array(vett[i], nuovo_nome, elab, do_arrays)
+ @} else
+ @@elab(nuovo_nome, vett[i])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Gli argomenti sono i seguenti:
+
address@hidden @code
address@hidden vett
+Il vettore.
+
address@hidden nome
+Il nome del vettore (una stringa).
+
address@hidden elab
+Il nome della funzione da chiamare.
+
address@hidden do_arrays
+Se vale @dfn{vero}, la funzione address@hidden gestire elementi che sono
sottovettori.
address@hidden table
+
+Se devono essere elaborati sottovettori, questo vien fatto prima di
+attraversarne altri.
+
+Quando viene eseguita con la seguente struttura, la funzione produce lo stesso
+risultato della precedente versione di @code{walk_array()}:
+
address@hidden
+BEGIN @{
+ a[1] = 1
+ a[2][1] = 21
+ a[2][2] = 22
+ a[3] = 3
+ a[4][1][1] = 411
+ a[4][2] = 42
+
+ process_array(a, "a", "do_print", 0)
address@hidden
+
+function do_print(nome, elemento)
address@hidden
+ printf "%s = %s\n", nome, elemento
address@hidden
address@hidden example
+
address@hidden Sommario funzioni di libreria
address@hidden Riassunto
+
address@hidden @value{BULLET}
address@hidden
+Leggere i programmi @`e un eccellente metodo per imparare la "buona
+programmazione". Le funzioni e i programmi contenuti in questo @value{CHAPTER}
+e nel successivo si propongo questo obiettivo.
+
address@hidden
+Quando si scrivono funzioni di libreria di uso generale, si deve stare attenti
+ai nomi da dare alle variabili globali, facendo in modo che non entrino in
+conflitto con le variabili di un programma dell'utente.
+
address@hidden
+Le funzioni descritte qui appartengono alle seguenti categorie:
+
address@hidden nested list
address@hidden @asis
address@hidden Problemi generali
+Conversione di numeri in stringhe, verifica delle asserzioni, arrotondamenti,
+generazione di numeri casuali, conversione di caratteri in numeri, unione di
+stringhe, ottenimento di informazioni su data e ora facilmente usabili,
+e lettura di un intero file in una volta sola
+
address@hidden Gestione dei @value{DF}
+Annotazione dei limiti di un @value{DF}, rilettura del file corrente,
+ricerca di
+file leggibili, ricerca di file di lunghezza zero, e trattamento degli
+assegnamenti di variabili fatti sulla riga comando come @value{FNS}
+
address@hidden Elaborazione di opzioni sulla riga di comando
+Una versione @command{awk} della funzione del C standard @code{getopt()}
+
address@hidden Lettura dei file degli utenti e dei gruppi
+Due serie di routine equivalenti alle versioni disponibili nella libreria
+del linguaggio C
+
address@hidden Attraversamento di vettori di vettori
+Due funzioni che attraversano un vettore di vettori fino in fondo
address@hidden table
address@hidden end nested list
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi con le librerie
address@hidden Esercizi
+
address@hidden
address@hidden
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden vuoti}, abbiamo illustrato il programma @file{zerofile.awk},
+che fa uso della variabile di @command{gawk} @code{ARGIND}. Questo problema
address@hidden
+essere risolto senza dipendere da @code{ARGIND}? Se
address@hidden@dotless{i}}, come?
+
address@hidden
+# zerofile2.awk --- same thing, portably
+
+BEGIN @{
+ ARGIND = Argind = 0
+ for (i = 1; i < ARGC; i++)
+ Fnames[ARGV[i]]++
+
address@hidden
+FNR == 1 @{
+ while (ARGV[ARGIND] != FILENAME)
+ ARGIND++
+ Seen[FILENAME]++
+ if (Seen[FILENAME] == Fnames[FILENAME])
+ do
+ ARGIND++
+ while (ARGV[ARGIND] != FILENAME)
address@hidden
+ARGIND > Argind + 1 @{
+ for (Argind++; Argind < ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
+ARGIND != Argind @{
+ Argind = ARGIND
address@hidden
+END @{
+ if (ARGIND < ARGC - 1)
+ ARGIND = ARGC - 1
+ if (ARGIND > Argind)
+ for (Argind++; Argind <= ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
address@hidden ignore
+
address@hidden
+Come esercizio collegato, rivedere quel codice per gestire il caso in cui un
+valore contenuto in @code{ARGV} sia un assegnamento di variabile.
+
address@hidden
address@hidden June 13 2015: Antonio points out that this is answered in the
text. Ooops.
address@hidden
address@hidden vettori} ha illustrato una funzione che ispezionava un vettore
+multidimensionale per stamparlo. Comunque, ispezionare un vettore ed elaborare
+ogni elemento @`e un'operazione generica. Generalizzare la funzione
address@hidden()} agggiungendo un parametro aggiuntivo chiamato
address@hidden
+
+Quindi, all'interno del ciclo, invece di stampare l'indice e il valore
+dell'elemento del vettore, usare la sintassi della chiamata indiretta a una
+funzione (@pxref{Chiamate indirette})
+su @code{elab}, passandole l'indice e il valore.
+
+Nel chiamare @code{walk_array()}, si passa il nome di una
+funzione definita dall'utente che aspetta di ricevere un indice e un valore
+per poi elaborare l'elemento.
+
+Verificare la nuova versione stampando il vettore; si dovrebbe ottenere un
+output identico a quello della versione originale.
address@hidden ignore
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden Programmi di esempio
address@hidden Programmi utili scritti in @command{awk}
address@hidden @command{awk}, programmi, esempi di
address@hidden programmi @command{awk}, esempi di
address@hidden esempi di programmi @command{awk}
+
address@hidden FULLXREF ON
address@hidden
+Il
address@hidden iftex
address@hidden di libreria},
+ha prospettato l'idea che la lettura di programmi scritti in un certo
+linguaggio possa aiutare a imparare quel linguaggio. Questo
address@hidden ripropone lo stesso tema, presentando una miscellanea di
+programmi @command{awk} per il piacere di leggerli.
address@hidden FULLXREF OFF
address@hidden
+Ci sono tre @value{SECTIONS}.
+La prima spiega come eseguire i programmi descritti in questo
address@hidden
+
+La seconda illustra la versione @command{awk}
+di parecchi comuni programmi di address@hidden disponibili in POSIX.
+Si presuppone che si abbia address@hidden una certa address@hidden con questi
programmi,
+e che quindi i problemi a loro legati siano facilmente comprensibili.
+Riscrivendo questi programmi in @command{awk},
+ci si address@hidden focalizzare sulle address@hidden di @command{awk} nella
+risoluzione dei problemi di programmazione.
+
+La terza sezione @`e una collezione di programmi interessanti.
+Essi mirano a risolvere un certo numero di differenti problemi di
+manipolazione e di gestione dati. Molti dei programmi sono brevi, per
+evidenziare la address@hidden di @command{awk} di fare molte cose usando solo
+poche righe di codice.
address@hidden ifnotinfo
+
+Molti di questi programmi usano le funzioni di libreria che sono state
presentate
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria}.
+
address@hidden
+* Eseguire esempi:: Come eseguire questi esempi.
+* Cloni:: Cloni di programmi di address@hidden comuni.
+* Programmi vari:: Alcuni interessanti programmi in
+ @command{awk}.
+* Sommario dei programmi:: Sommario dei programmi.
+* Esercizi sui programmi:: Esercizi.
address@hidden menu
+
address@hidden Eseguire esempi
address@hidden Come eseguire i programmi di esempio.
+
+
+Per eseguire un dato programma, si procederebbe tipicamente
address@hidden@dotless{i}}:
+
address@hidden
+awk -f @var{programma} -- @var{opzioni} @var{file}
address@hidden example
+
address@hidden
+Qui, @var{programma} @`e il nome del programma @command{awk} (p.es.
address@hidden), @var{opzioni} sono le opzioni sulla riga di comando
+per il programma che iniziano con un @samp{-}, e @var{file} sono i
address@hidden in input.
+
+Se il sistema prevede il meccanismo @samp{#!} di specifica di un
address@hidden
+(@address@hidden eseguibili}),
+si address@hidden invece eseguire direttamente un programma:
+
address@hidden
+cut.awk -c1-8 i_miei_file > risultati
address@hidden example
+
+Se @command{awk} non @`e @command{gawk}, address@hidden invece essere
necessario usare:
+
address@hidden
+cut.awk -- -c1-8 i_miei_file > risultati
address@hidden example
+
address@hidden Cloni
address@hidden Reinventare la ruota per divertimento e profitto
address@hidden programmi POSIX, implementazione in @command{awk}
address@hidden POSIX, programmi, implementazione in @command{awk}
+
+Questa @value{SECTION} presenta un certo numero di programmi di address@hidden
+POSIX implementati in @command{awk}. Riscrivere questi programmi in
address@hidden @`e spesso divertente,
+perch@'e gli algoritmi possono essere espressi molto chiaramente, e il codice
address@hidden normalmente molto semplice e conciso. address@hidden @`e
possibile perch@'e @command{awk}
+facilita molto le cose al programmatore.
+
+Va precisato che questi programmi non sono necessariamente scritti per
+sostituire le versioni installate sul sistema in uso.
+Inoltre, nessuno di questi programmi @`e del tutto aderente ai address@hidden
recenti
+standard POSIX. Questo non @`e un problema; il loro scopo
address@hidden di illustrare la programmazione in linguaggio @command{awk} che
serve nel
+``mondo reale''.
+
+I programmi sono presentati in ordine alfabetico.
+
address@hidden
+* Programma cut:: Il programma di address@hidden @command{cut}.
+* Programma egrep:: Il programma di address@hidden
@command{egrep}.
+* Programma id:: Il programma di address@hidden @command{id}.
+* Programma split:: Il programma di address@hidden
@command{split}.
+* Programma tee:: Il programma di address@hidden @command{tee}.
+* Programma uniq:: Il programma di address@hidden
@command{uniq}.
+* Programma wc:: Il programma di address@hidden @command{wc}.
address@hidden menu
+
address@hidden Programma cut
address@hidden Ritagliare campi e colonne
+
address@hidden @command{cut}, programma di address@hidden
address@hidden programma di address@hidden @command{cut}
address@hidden campi, ritagliare
address@hidden colonne, ritagliare
+Il programma di address@hidden @command{cut} seleziona, o ``taglia''
(@dfn{cut}),
+caratteri o campi dal suo standard input e li
+spedisce al suo standard output.
+I campi sono separati da caratteri TAB per default,
+ma @`e possibile fornire un'opzione dalla riga di comando per cambiare il campo
address@hidden (address@hidden, il carattere che separa i campi). La
definizione di
+campo di @command{cut} @`e meno generale di quella di @command{awk}.
+
+Un uso comune del comando @command{cut} potrebbe essere quello di estrarre
+i nomi degli utenti correntemente collegati al sistema, a partire
+dall'output del comando @command{who}. Per esempio, la seguente
+pipeline genera una lista in ordine alfabetico, senza doppioni, degli utenti
+correntemente collegati al sistema:
+
address@hidden
+who | cut -c1-8 | sort | uniq
address@hidden example
+
+Le opzioni per @command{cut} sono:
+
address@hidden @code
address@hidden -c @var{lista}
+Usare @var{lista} come lista di caratteri da ritagliare. Elementi
+all'interno della lista
+possono essere separati da virgole, e intervalli di caratteri possono essere
+separated da trattini. La lista
address@hidden,15,22-35} specifica i caratteri da 1 a 8, 15, e da 22 a 35.
+
address@hidden -f @var{lista}
+Usare @var{lista} come lista di campi da ritagliare.
+
address@hidden -d @var{delimitatore}
+Usare @var{delimitatore} come carattere che separa i campi invece del
+carattere TAB.
+
address@hidden -s
+Evita la stampa di righe che non contengono il delimitatore di campo.
address@hidden table
+
+L'implementazione @command{awk} del comando @command{cut} usa la funzione
+di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e la funzione di libreria @code{join()}
+(@pxref{Funzione join}).
+
+Il programma inizia con un commento che descrive le opzioni, le funzioni
+di libreria necessarie, e una funzione @code{sintassi()} che stampa un
+messaggio ed esce. @code{sintassi()} @`e chiamato se si specificano degli
+argomenti non validi:
+
address@hidden @code{cut.awk}, programma
address@hidden programma @code{cut.awk}
address@hidden
address@hidden file eg/prog/cut.awk
+# cut.awk --- implementa cut in awk
address@hidden endfile
address@hidden
address@hidden file eg/prog/cut.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/cut.awk
+
+# Opzioni:
+# -f lista Ritagliare campi
+# -d c Carattere di delimitazione di campo
+# -c lista Ritagliare caratteri
+#
+# -s Sopprimere righe che non contengono il delimitatore
+#
+# Richiede le funzioni di libreria getopt() e join()
+
address@hidden
+function sintassi()
address@hidden
+ print("sintassi: cut [-f lista] [-d c] [-s] [file...]") > "/dev/stderr"
+ print("sintassi: cut [-c lista] [file...]") > "/dev/stderr"
+ exit 1
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, eseguire programmi
@command{awk} e
address@hidden criterio di ricerca @code{BEGIN}, eseguire programmi
@command{awk} e
address@hidden @code{FS}, variabile, eseguire programmi @command{awk} e
address@hidden variabile @code{FS}, eseguire programmi @command{awk} e
+Subito dopo c'@`e una regola @code{BEGIN} che analizza le opzioni della riga
+di comando.
+Questa regola imposta @code{FS} a un solo carattere TAB, perch@'e quello @`e
+il separatore di campo di @command{cut} per default.
+La regola poi imposta il separatore di campo in output allo stesso valore
+del separatore di campo in input. Un ciclo che usa @code{getopt()} esamina
+le opzioni della riga di comando. Una e una sola delle variabili
address@hidden o @code{per_caratteri} @`e impostata a "vero", per indicare
+che l'elaborazione address@hidden fatta per campi o per caratteri,
rispettivamente.
+Quando si ritaglia per caratteri, il separatore di campo in output @`e
+impostato alla stringa nulla:
+
address@hidden
address@hidden file eg/prog/cut.awk
+BEGIN @{
+ FS = "\t" # default
+ OFS = FS
+ while ((c = getopt(ARGC, ARGV, "sf:c:d:")) != -1) @{
+ if (c == "f") @{
+ per_campi = 1
+ lista_campi = Optarg
+ @} else if (c == "c") @{
+ per_caratteri = 1
+ lista_campi = Optarg
+ OFS = ""
+ @} else if (c == "d") @{
+ if (length(Optarg) > 1) @{
+ printf("cut: usa il primo carattere di %s" \
+ " come delimitatore\n", Optarg) > "/dev/stderr"
+ Optarg = substr(Optarg, 1, 1)
+ @}
+ fs = FS = Optarg
+ OFS = FS
+ if (FS == " ") # mette specifica in formato awk
+ FS = "[ ]"
+ @} else if (c == "s")
+ sopprimi = 1
+ else
+ sintassi()
+ @}
+
+ # Toglie opzioni da riga di comando
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
address@hidden endfile
address@hidden example
+
address@hidden separatori di campo, spazi come
address@hidden spazi come separatori di campo
+Nella scrittura del codice si deve porre particolare attenzione quando il
+delimitatore di campo @`e uno spazio. Usare
+un semplice spazio (@address@hidden" "}}) come valore per @code{FS} @`e
+sbagliato: @command{awk} separerebbe i campi con serie di spazi,
+TAB, e/o ritorni a capo, mentre devono essere separati solo da uno spazio.
+Per far questo, salviamo il carattere di spazio originale nella variabile
address@hidden per un uso futuro; dopo aver impostato @code{FS} a @code{"[ ]"}
non
address@hidden possibile usarlo direttamente per vedere se il carattere
delimitatore di
+campo @`e nella stringa.
+
+Si ricordi anche che dopo che si @`e finito di usare @code{getopt()}
+(come descritto nella @ref{Funzione getopt}),
address@hidden necessario
+eliminare tutti gli elementi del vettore @code{ARGV} da 1 a @code{Optind},
+in modo che @command{awk} non tenti di elaborare le opzioni della riga di
comando
+come @value{FNS}.
+
+Dopo aver elaborato le opzioni della riga di comando, il programma verifica
+che le opzioni siano coerenti. Solo una tra le opzioni @option{-c}
+e @option{-f} dovrebbe essere presente, ed entrambe richiedono una lista di
+campi. Poi il programma chiama
address@hidden()} oppure @code{prepara_lista_caratteri()} per
+preparare la lista dei campi o dei caratteri:
+
address@hidden
address@hidden file eg/prog/cut.awk
+ if (per_campi && per_caratteri)
+ sintassi()
+
+ if (per_campi == 0 && per_caratteri == 0)
+ per_campi = 1 # default
+
+ if (lista_campi == "") @{
+ print "cut: specificare lista per -c o -f" > "/dev/stderr"
+ exit 1
+ @}
+
+ if (per_campi)
+ prepara_lista_campi()
+ else
+ prepara_lista_caratteri()
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden()} pone la lista campi, usando la virgola come
+separatore, in un vettore. Poi, per
+ogni elemento del vettore, controlla che esso non sia un intervallo. Se @`e
+un intervallo, lo fa diventare un elenco. La funzione controlla l'intervallo
+specificato, per assicurarsi che il primo numero sia minore del secondo.
+Ogni numero nella lista @`e aggiunto al vettore @code{lista_c}, che
+semplicemente elenca i campi che saranno stampati. Viene usata la normale
+separazione in campi di @command{awk}. Il programma lascia ad @command{awk}
+il compito di separare i campi:
+
address@hidden
address@hidden file eg/prog/cut.awk
+function prepara_lista_campi( n, m, i, j, k, f, g)
address@hidden
+ n = split(lista_campi, f, ",")
+ j = 1 # indice in lista_c
+ for (i = 1; i <= n; i++) @{
+ if (index(f[i], "-") != 0) @{ # un intervallo
+ m = split(f[i], g, "-")
address@hidden
+ if (m != 2 || g[1] >= g[2]) @{
+ printf("cut: lista campi errata: %s\n",
+ f[i]) > "/dev/stderr"
+ exit 1
+ @}
address@hidden group
+ for (k = g[1]; k <= g[2]; k++)
+ lista_c[j++] = k
+ @} else
+ lista_c[j++] = f[i]
+ @}
+ ncampi = j - 1
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{prepara_lista_caratteri()} @`e address@hidden complicata di
address@hidden()}.
+L'idea qui @`e di usare la variabile di @command{gawk} @code{FIELDWIDTHS}
+(@pxref{Dimensione costante}),
+che descrive input a larghezza costante. Quando si usa una lista di
+caratteri questo @`e proprio il nostro caso.
+
+Impostare @code{FIELDWIDTHS} @`e address@hidden complicato che semplicemente
elencare
+i campi da stampare. Si deve tener traccia dei campi da
+stampare e anche dei caratteri che li separano, che vanno saltati.
+Per esempio, supponiamo che si vogliano i caratteri da 1 a 8, 15,
+e da 22 a 35. Per questo si specifica @samp{-c 1-8,15,22-35}. Il valore che
+corrisponde a questo nella variabile @code{FIELDWIDTHS} @`e
address@hidden@w{"8 6 1 6 14"}}. Questi sono cinque campi, e quelli da stampare
+sono @code{$1}, @code{$3}, e @code{$5}.
+I campi intermedi sono @dfn{riempitivo} (@dfn{filler}),
+ossia @`e address@hidden che separa i dati che si desidera estrarre.
address@hidden lista i campi da stampare, e @code{t} traccia l'elenco
+completo dei campi, inclusi i riempitivi:
+
address@hidden
address@hidden file eg/prog/cut.awk
+function prepara_lista_caratteri( campo, i, j, f, g, n, m, t,
+ filler, ultimo, lungo)
address@hidden
+ campo = 1 # contatore totale campi
+ n = split(lista_campi, f, ",")
+ j = 1 # indice in lista_c
+ for (i = 1; i <= n; i++) @{
+ if (index(f[i], "-") != 0) @{ # intervallo
+ m = split(f[i], g, "-")
+ if (m != 2 || g[1] >= g[2]) @{
+ printf("cut: lista caratteri errata: %s\n",
+ f[i]) > "/dev/stderr"
+ exit 1
+ @}
+ lungo = g[2] - g[1] + 1
+ if (g[1] > 1) # calcola lunghezza del riempitivo
+ filler = g[1] - ultimo - 1
+ else
+ filler = 0
address@hidden
+ if (filler)
+ t[campo++] = filler
address@hidden group
+ t[campo++] = lungo # lunghezza del campo
+ ultimo = g[2]
+ lista_c[j++] = campo - 1
+ @} else @{
+ if (f[i] > 1)
+ filler = f[i] - ultimo - 1
+ else
+ filler = 0
+ if (filler)
+ t[campo++] = filler
+ t[campo++] = 1
+ ultimo = f[i]
+ lista_c[j++] = campo - 1
+ @}
+ @}
+ FIELDWIDTHS = join(t, 1, campo - 1)
+ ncampi = j - 1
address@hidden
address@hidden endfile
address@hidden example
+
+Poi viene la regola che elabora i dati. Se l'opzione @option{-s} @`e stata
+specificata, il flag @code{sopprimi}
address@hidden vero. La prima istruzione
address@hidden accerta che il record in input abbia il separatore di
+campo. Se @command{cut} sta elaborando dei campi, e @code{sopprimi} @`e vero,
+e il carattere di separazione dei campi non @`e presente nel record, il
+record @`e ignorato.
+
+Se il record @`e valido, @command{gawk} ha address@hidden separato i dati in
campi,
+usando il carattere in @code{FS} o usando campi a lunghezza fissa
+e @code{FIELDWIDTHS}. Il ciclo scorre attraverso la lista di campi che
+si dovrebbero stampare. Il campo corrispondente @`e stampato se contiene dati.
+Se il campo successivo contiene pure dei dati, il carattere di separazione @`e
+scritto tra i due campi:
+
address@hidden
address@hidden file eg/prog/cut.awk
address@hidden
+ if (per_campi && sopprimi && index($0, fs) == 0)
+ next
+
+ for (i = 1; i <= ncampi; i++) @{
+ if ($lista_c[i] != "") @{
+ printf "%s", $lista_c[i]
+ if (i < ncampi && $lista_c[i+1] != "")
+ printf "%s", OFS
+ @}
+ @}
+ print ""
address@hidden
address@hidden endfile
address@hidden example
+
+Questa versione di @command{cut} utilizza la variabile @code{FIELDWIDTHS} di
address@hidden per ritagliare in base alla posizione dei caratteri. @`E
+possibile, in altre implementazioni di @command{awk} usare @code{substr()}
+(@pxref{Funzioni per stringhe}), ma
+la cosa @`e molto address@hidden complessa.
+La variabile @code{FIELDWIDTHS} fornisce una soluzione elegante al problema
+di suddividere la riga in input in singoli caratteri.
+
+
address@hidden Programma egrep
address@hidden Ricercare espressioni regolari nei file
+
address@hidden espressioni regolari, ricerca di
address@hidden ricercare, in file, espressioni regolari
address@hidden file, ricercare espressioni regolari nei
address@hidden @command{egrep}, programma di address@hidden
address@hidden programma di address@hidden @command{egrep}
+Il programma di address@hidden @command{egrep} ricerca occorrenze di
espressioni
+regolari all'interno di file. Usa
+espressioni regolari che sono quasi identiche a quelle disponibili in
address@hidden
address@hidden (@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
address@hidden (@pxref{Espressioni regolari}).
address@hidden ifnottex
+Si richiama address@hidden@dotless{i}}:
+
address@hidden
address@hidden address@hidden @code{'@var{espressione}'} @var{file} @dots{}
address@hidden display
+
address@hidden @`e un'espressione regolare. Normalmente, l'espressione
+regolare @`e protetta da apici per impedire alla shell di espandere ogni
+carattere speciale come @value{FN}.
+Normalmente, @command{egrep} stampa le righe per cui @`e stata trovata una
+corrispondenza. Se nella riga di comando si richiede di operare su
address@hidden di un
address@hidden, ogni riga in output @`e preceduta dal nome del file, e dal segno
+due punti.
+
+Le opzioni di @command{egrep} sono le seguenti:
+
address@hidden @code
address@hidden -c
+Stampa un contatore delle righe che corrispondono al criterio di ricerca,
+e non le righe stesse.
+
address@hidden -s
+Funziona in silenzio. Non si produce alcun output ma il codice di ritorno
+indica se il criterio di ricerca ha trovato almeno una corrispondenza.
+
address@hidden -v
+Inverte il senso del test. @command{egrep} stampa le righe che
address@hidden soddisfano il criterio di ricerca ed esce con successo se il
+criterio di ricerca non @`e soddisfatto.
+
address@hidden -i
+Ignora maiuscolo/minuscolo sia nel criterio di ricerca che nei dati in input.
+
address@hidden -l
+Stampa (elenca) solo i nomi dei file che corrispondono, e non le righe trovate.
+
address@hidden -e @var{espressione}
+Usa @var{espressione} come @dfn{regexp} da ricercare. Il motivo per cui
address@hidden prevista l'opzione @option{-e} @`e di
+permettere dei criteri di ricerca che
+inizino con un @samp{-}.
address@hidden table
+
+Questa versione usa la funzione di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e il programma di libreria che gestisce il passaggio da un file dati
+al successivo
+(@pxref{Funzione filetrans}).
+
+Il programma inizia con un commento descrittivo e poi c'@`e una regola
address@hidden
+che elabora gli argomenti della riga di comando usando @code{getopt()}.
+L'opzione @option{-i} (ignora maiuscolo/minuscolo) @`e particolarmente facile
+da implementare con @command{gawk}; basta usare la variabile predefinita
address@hidden
+(@pxref{Variabili predefinite}):
+
address@hidden @code{egrep.awk}, programma
address@hidden programma @code{egrep.awk}
address@hidden
address@hidden file eg/prog/egrep.awk
+# egrep.awk --- simula egrep in awk
+#
address@hidden endfile
address@hidden
address@hidden file eg/prog/egrep.awk
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/egrep.awk
+# Opzioni:
+# -c conta le righe trovate
+# -s sileziosa: genera solo il codice di ritorno
+# -v inverte test, successo se @dfn{regexp} non presente
+# -i ignora maiuscolo/minuscolo
+# -l stampa solo nomi file
+# -e espressione da ricercare
+#
+# Richiede la funzione getopt() e il programma di libreria
+# che gestisce il passaggio da un file dati al successivo
+
+BEGIN @{
+ while ((c = getopt(ARGC, ARGV, "ce:svil")) != -1) @{
+ if (c == "c")
+ conta_e_basta++
+ else if (c == "s")
+ non_stampare++
+ else if (c == "v")
+ inverti_test++
+ else if (c == "i")
+ IGNORECASE = 1
+ else if (c == "l")
+ solo_nomi_file++
+ else if (c == "e")
+ criterio_di_ricerca = Optarg
+ else
+ sintassi()
+ @}
address@hidden endfile
address@hidden example
+
+Nel seguito c'@`e il codice che gestisce il comportamento specifico di
address@hidden Se non @`e fornito esplicitamente alcun criterio di ricerca
+tramite l'opzione @option{-e}, si usa il primo argomento sulla riga di
+comando che non sia un'opzione.
+Gli argomenti della riga di comando di @command{awk} fino ad
address@hidden vengono cancellati,
+in modo che @command{awk} non tenti di elaborarli come file. Se
+non @`e stato specificato alcun nome di file, si usa lo standard input, e se
address@hidden presente address@hidden di un nome di file, lo si annota, in
modo che i @value{FNS}
+vengano scritti prima di ogni riga di output corrispondente:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+ if (criterio_di_ricerca == "")
+ criterio_di_ricerca = ARGV[Optind++]
+
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
+ if (Optind >= ARGC) @{
+ ARGV[1] = "-"
+ ARGC = 2
+ @} else if (ARGC - Optind > 1)
+ servono_nomi_file++
+
+# if (IGNORECASE)
+# criterio_di_ricerca = tolower(criterio_di_ricerca)
address@hidden
address@hidden endfile
address@hidden example
+
+Le ultime due righe sono solo dei commenti, in quanto non necessarie in
address@hidden Per altre versioni di
address@hidden, potrebbe essere necessario utilizzarle come istruzioni
+effettive (togliendo il "#").
+
+Il prossimo insieme di righe dovrebbe essere decommentato
+se non si sta usando @command{gawk}.
+Questa regola converte in minuscolo tutti i caratteri della riga in input,
+se @`e stata specificata l'opzione @address@hidden, qui si
+introduce un errore subdolo; se una corrispondenza viene trovata, viene
+inviata in output la riga tradotta, non quella originale.}
+La regola @`e
+commentata perch@'e non @`e necessaria se si usa @command{gawk}:
+
address@hidden
address@hidden file eg/prog/egrep.awk
address@hidden
+# if (IGNORECASE)
+# $0 = tolower($0)
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{a_inizio_file()} @`e chiamata dalla regola in
@file{ftrans.awk}
+quando ogni nuovo file viene elaborato. In questo caso, non c'@`e molto da
fare;
+ci si limita a inizializzare una variabile @code{contatore_file} a zero.
address@hidden serve a ricordare quante righe nel file corrente
+corrispondono al criterio di ricerca.
+Scegliere come nome di parametro @code{da_buttare} indica che sappiamo che
address@hidden()} @`e chiamata con un parametro, ma che noi non siamo
+interessati al suo valore:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+function a_inizio_file(da_buttare)
address@hidden
+ contatore_file = 0
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{endfile()} viene chiamata dopo l'elaborazione di ogni file.
+Ha influenza sull'output solo quando l'utente desidera un contatore del
+numero di righe che sono state individuate. @code{non_stampare} @`e vero nel
+caso si desideri solo il codice di
+ritorno. @code{conta_e_basta} @`e vero se si desiderano solo i contatori
+delle righe trovate. @command{egrep}
+quindi stampa i contatori solo se
+sia la stampa che il conteggio delle righe sono stati abilitati.
+Il formato di output deve tenere conto del numero di file sui quali si
+opera. Per finire, @code{contatore_file} @`e aggiunto a @code{totale}, in
+modo da stabilire qual @`e il numero totale di righe che ha soddisfatto il
+criterio di ricerca:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+function endfile(file)
address@hidden
+ if (! non_stampare && conta_e_basta) @{
+ if (servono_nomi_file)
+ print file ":" contatore_file
+ else
+ print contatore_file
+ @}
+
+ totale += contatore_file
address@hidden
address@hidden endfile
address@hidden example
+
+Si potrebbero usare i criteri di ricerca speciali @code{BEGINFILE} ed
address@hidden
+(@pxref{BEGINFILE/ENDFILE}),
+ma in quel caso il programma funzionerebbe solo usando @command{gawk}.
+Inoltre, questo esempio @`e stato scritto prima che a @command{gawk} venissero
+aggiunti i criteri speciali @code{BEGINFILE} ed @code{ENDFILE}.
+
+La regola seguente fa il grosso del lavoro per trovare righe corrispondenti
+al criterio di ricerca fornito. La variabile
address@hidden @`e vera se la riga @`e individuata dal criterio di ricerca.
+Se l'utente chiede invece le righe che non corrispondono, il senso di
address@hidden @`e invertito, usando l'operatore @samp{!}.
address@hidden @`e incrementato con il valore di
address@hidden, che vale uno o zero, a seconda che la corrispondenza sia
+stata trovata oppure no. Se la riga non corrisponde, l'istruzione
address@hidden passa ad esaminare il record successivo.
+
+Vengono effettuati anche altri controlli, ma soltanto se non
+si sceglie di contare le righe. Prima di tutto, se l'utente desidera solo
+il codice di ritorno (@code{non_stampare} @`e vero), @`e sufficiente sapere
+che @emph{una} riga nel file corrisponde, e si address@hidden passare al file
successivo
+usando @code{nextfile}. Analogamente, se stiamo solo stampando @value{FNS},
+possiamo stampare il @value{FN}, e quindi saltare al file successivo con
address@hidden
+Infine, ogni riga viene stampata, preceduta, se necessario, dal @value{FN} e
+dai due punti:
+
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden
address@hidden file eg/prog/egrep.awk
address@hidden
+ corrisponde = ($0 ~ criterio_di_ricerca)
+ if (inverti_test)
+ corrisponde = ! corrisponde
+
+ contatore_file += corrisponde # 1 o 0
+
+ if (! corrisponde)
+ next
+
+ if (! conta_e_basta) @{
+ if (non_stampare)
+ nextfile
+
+ if (solo_nomi_file) @{
+ print nome_file
+ nextfile
+ @}
+
+ if (servono_nomi_file)
+ print nome_file ":" $0
+ else
+ print
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+La regola @code{END} serve a produrre il codice di ritorno corretto. Se
+non ci sono corrispondenze, il codice di ritorno @`e uno; altrimenti, @`e zero:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+END @{
+ exit (totale == 0)
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{sintassi()} stampa un messaggio per l'utente, nel caso
+siano state specificate opzioni non valide, e quindi esce:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+function sintassi()
address@hidden
+ print("sintassi: egrep [-csvil] [-e criterio_di_ricerca] [file ...]")\
+ > "/dev/stderr"
+ print("\n\tegrep [-csvil] criterio_di_ricerca [file ...]") > "/dev/stderr"
+ exit 1
address@hidden
address@hidden endfile
address@hidden example
+
+
address@hidden Programma id
address@hidden Stampare informazioni sull'utente
+
address@hidden stampare informazioni utente
address@hidden utenti, informazioni riguardo agli, stampare
address@hidden @command{id}, programma di address@hidden
address@hidden programma di address@hidden @command{id}
+Il programma di address@hidden @command{id} elenca i numeri identificativi (ID)
+reali ed effettivi di un utente, e l'insieme dei gruppi a cui l'utente
+appartiene, se ve ne sono.
address@hidden stampa i numeri identificativi di utente e di gruppo solo se
+questi sono differenti da quelli reali. Se possibile, @command{id} elenca
+anche i corrispondenti nomi di utente e di gruppo.
+L'output potrebbe essere simile a questo:
+
address@hidden
+$ @kbd{id}
address@hidden uid=1000(arnold) gid=1000(arnold)
groups=1000(arnold),4(adm),7(lp),27(sudo)
address@hidden example
+
address@hidden @code{PROCINFO}, vettore, e @dfn{process ID} di utente e di
gruppo
+Questa informazione @`e parte di address@hidden che @`e reso disponibile dal
vettore
address@hidden di @command{gawk} (@pxref{Variabili predefinite}).
+Comunque, il programma di address@hidden @command{id} fornisce un output
address@hidden
+comprensibile che non una semplice lista di numeri.
+
+Ecco una versione semplice di @command{id} scritta in @command{awk}.
+Usa le funzioni di libreria che riguardano il database degli utenti
+(@pxref{Funzioni Passwd})
+e le funzioni di libreria che riguardano il database dei gruppi
+(@pxref{Funzioni Group})
+contenute
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria}.
+
+Il programma @`e abbastanza semplice. Tutto il lavoro @`e svolto nella regola
address@hidden I numeri ID di utente e di gruppo sono ottenuti da
address@hidden
+Il codice @`e ripetitivo. La riga nel database degli utenti che descrive
+l'ID reale dell'utente @`e divisa in parti, separate tra loro da @samp{:}.
+Il nome @`e il primo campo. Un codice analogo @`e usato per l'ID effettivo, e
+per i numeri che descrivono i gruppi:
+
address@hidden @code{id.awk}, programma
address@hidden programma @code{id.awk}
address@hidden
address@hidden file eg/prog/id.awk
+# id.awk --- implement id in awk
+#
+# Richiede funzioni di libreria per utente e gruppo
address@hidden endfile
address@hidden
address@hidden file eg/prog/id.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised February 1996
+# Revised May 2014
+# Revised September 2014
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/id.awk
+# l'output @`e:
+# uid=12(pippo) euid=34(pluto) gid=3(paperino) \
+# egid=5(paperina) groups=9(nove),2(due),1(uno)
+
address@hidden
+BEGIN @{
+ uid = PROCINFO["uid"]
+ euid = PROCINFO["euid"]
+ gid = PROCINFO["gid"]
+ egid = PROCINFO["egid"]
address@hidden group
+
+ printf("uid=%d", uid)
+ pw = getpwuid(uid)
+ stampa_primo_campo(pw)
+
+ if (euid != uid) @{
+ printf(" euid=%d", euid)
+ pw = getpwuid(euid)
+ stampa_primo_campo(pw)
+ @}
+
+ printf(" gid=%d", gid)
+ pw = getgrgid(gid)
+ stampa_primo_campo(pw)
+
+ if (egid != gid) @{
+ printf(" egid=%d", egid)
+ pw = getgrgid(egid)
+ stampa_primo_campo(pw)
+ @}
+
+ for (i = 1; ("group" i) in PROCINFO; i++) @{
+ if (i == 1)
+ printf(" gruppi=")
+ group = PROCINFO["group" i]
+ printf("%d", group)
+ pw = getgrgid(group)
+ stampa_primo_campo(pw)
+ if (("group" (i+1)) in PROCINFO)
+ printf(",")
+ @}
+
+ print ""
address@hidden
+
+function stampa_primo_campo(str, a)
address@hidden
+ if (str != "") @{
+ split(str, a, ":")
+ printf("(%s)", a[1])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Il test incluso nel ciclo @code{for} @`e degno di nota.
+Ogni ulteriore gruppo nel vettore @code{PROCINFO} ha come indice da
address@hidden"group1"} a @code{"address@hidden"} dove il numero
address@hidden @`e il numero totale di gruppi ulteriori).
+Tuttavia, non si sa quanti di questi gruppi ci siano per un dato utente.
+
+Questo ciclo inizia da uno, concatena il valore di ogni iterazione con
address@hidden"group"}, e poi usando l'istruzione @code{in} verifica se quella
+chiave @`e nel vettore (@pxref{Visitare elementi}). Quando @code{i} @`e
+incrementato oltre l'ultimo gruppo presente nel vettore, il ciclo termina.
+
+Il ciclo funziona correttamente anche se @emph{non} ci sono ulteriori
+gruppi; in quel caso la condizione risulta falsa fin dal primo controllo, e
+il corpo del ciclo non viene mai eseguito.
+
+La funzione @code{stampa_primo_campo()} semplicemente incapsula quelle parti di
+codice che vengono usate ripetutamente, rendendo il programma address@hidden
conciso e
+ordinato.
+In particolare, inserendo in questa funzione il test per la stringa nulla
+consente di risparmiare parecchie righe di programma.
+
+
address@hidden Programma split
address@hidden Suddividere in pezzi un file grosso
+
address@hidden FIXME: One day, update to current POSIX version of split
+
address@hidden file, splitting
address@hidden @code{split}, programma di address@hidden
address@hidden programma di address@hidden @code{split}
+Il programma @command{split} divide grossi file di testo in pezzi
address@hidden piccoli.
+La sua sintassi @`e la seguente:@footnote{Questo @`e la sintassi tradizionale.
+La versione POSIX del comando ha una sintassi differente, ma per lo scopo di
+questo programma @command{awk} la cosa non ha importanza.}
+
address@hidden
address@hidden address@hidden@var{contatore}}] address@hidden address@hidden
address@hidden display
+
+Per default,
+i file di output avranno nome @file{xaa}, @file{xab}, e
address@hidden@dotless{i}} via. Ogni file
+contiene 1.000 righe, con la probabile
+eccezione dell'ultimo file. Per
+cambiare il numero di righe in ogni file, va indicato un numero sulla riga
+di comando, preceduto da un segno meno (p.es., @samp{-500} per file con 500
+righe ognuno invece che 1.000). Per modificare i nomi dei file di output in
+qualcosa del tipo
address@hidden, @file{miofileab}, e address@hidden@dotless{i}} via, va indicato
un argomento
+ulteriore che specifica il prefisso del @value{FN}.
+
+Ecco una versione di @command{split} in @command{awk}. Usa le funzioni
address@hidden()} e @code{chr()} descritte nella
address@hidden ordinali}.
+
+Il programma dapprima imposta i suoi valori di default, e poi controlla che
+non siano stati specificati troppi argomenti. Quindi esamina gli argomenti
+uno alla volta. Il primo
+argomento potrebbe essere un segno meno seguito da un numero. Poich@'e il
+numero in questione address@hidden apparire negativo, lo si fa diventare
positivo, e
+viene usato per contare le righe. Il nome del @value{DF} @`e per ora ignorato
+e l'ultimo argomento @`e usato come prefisso per i @value{FNS} in output:
+
address@hidden @code{split.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{split.awk}
address@hidden
address@hidden file eg/prog/split.awk
+# split.awk --- comando split scritto in awk
+#
+# Richiede le funzioni di libreria ord() e chr()
address@hidden endfile
address@hidden
address@hidden file eg/prog/split.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised slightly, May 2014
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/split.awk
+# sintassi: split [-contatore] [file] [nome_in_output]
+
+BEGIN @{
+ outfile = "x" # default
+ contatore = 1000
+ if (ARGC > 4)
+ sintassi()
+
+ i = 1
+ if (i in ARGV && ARGV[i] ~ /^-[[:digit:]]+$/) @{
+ contatore = -ARGV[i]
+ ARGV[i] = ""
+ i++
+ @}
+ # testa argv nel caso che si legga da stdin invece che da file
+ if (i in ARGV)
+ i++ # salta nome file-dati
+ if (i in ARGV) @{
+ outfile = ARGV[i]
+ ARGV[i] = ""
+ @}
+
+ s1 = s2 = "a"
+ out = (outfile s1 s2)
address@hidden
address@hidden endfile
address@hidden example
+
+La regola seguente fa il grosso del lavoro. @code{contatore_t}
+(contatore temporaneo) tiene conto di
+quante righe sono state stampate sul file di output finora. Se questo
+numero supera il valore di @code{contatore}, @`e ora di chiudere il file
+corrente e di iniziare a scriverne uno nuovo.
+Le variabili @code{s1} e @code{s2} sono usate per creare i suffissi
+da apporre a @value{FN}. Se entrambi arrivano al valore @samp{z}, il file
address@hidden troppo grosso. Altrimenti, @code{s1} passa alla successiva
lettera
+dell'alfabeto e @code{s2} ricomincia da @samp{a}:
+
address@hidden else on separate line here for page breaking
address@hidden
address@hidden file eg/prog/split.awk
address@hidden
+ if (++contatore_t > contatore) @{
+ close(out)
+ if (s2 == "z") @{
+ if (s1 == "z") @{
+ printf("split: %s @`e troppo grosso da suddividere\n",
+ nome_file) > "/dev/stderr"
+ exit 1
+ @}
+ s1 = chr(ord(s1) + 1)
+ s2 = "a"
+ @}
address@hidden
+ else
+ s2 = chr(ord(s2) + 1)
address@hidden group
+ out = (outfile s1 s2)
+ contatore_t = 1
+ @}
+ print > out
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+La funzione @code{sintassi()} stampa solo un messaggio di errore ed esce:
+
address@hidden
address@hidden file eg/prog/split.awk
+function sintassi()
address@hidden
+ print("sintassi: split [-num] [file] [nome_in_output]") > "/dev/stderr"
+ exit 1
address@hidden
address@hidden endfile
address@hidden example
+
+Questo programma @`e un po' approssimativo; conta sul fatto che @command{awk}
chiuda
+automaticamente l'ultimo file invece di farlo in una regola @code{END}.
+Un altro presupposto del programma @`e che le lettere dell'alfabeto siano
+in posizioni consecutive nella codifica in uso, il che non @`e vero per i
+sistemi che usano la codifica EBCDIC.
+
address@hidden FOR_PRINT
+Si potrebbe pensare a come eliminare l'uso di
address@hidden()} e @code{chr()}; la cosa si address@hidden fare in modo tale
da risolvere
+anche il problema posto dalla codifica EBCDIC.
address@hidden ifset
+
+
address@hidden Programma tee
address@hidden Inviare l'output su address@hidden di un file
+
address@hidden file, address@hidden duplicare l'output su
address@hidden output, duplicarlo su address@hidden file
address@hidden @code{tee}, programma di address@hidden
address@hidden programma di address@hidden @code{tee}
+Il programma @code{tee} @`e noto come @dfn{pipe fitting} (tubo secondario).
address@hidden copia il suo standard input al suo standard output e inoltre lo
+duplica scrivendo sui file indicati nella riga di comando. La sua sintassi
address@hidden la seguente:
+
address@hidden
address@hidden address@hidden @var{file} @dots{}
address@hidden display
+
+L'opzione @option{-a} chiede a @code{tee} di aggiungere in fondo al file
+indicato, invece che riscriverlo dall'inizio.
+
+La regola @code{BEGIN} dapprima fa una copia di tutti gli argomenti presenti
+sulla riga di comando, in un vettore di nome @code{copia}.
address@hidden non serve, e quindi non viene copiato.
address@hidden non address@hidden usare @code{ARGV} direttamente, perch@'e
@command{awk} tenta
+di elaborare ogni @value{FN} in @code{ARGV} come dati in input.
+
address@hidden flag, variabili di tipo
address@hidden variabili di tipo indicatore address@hidden
+Se il primo argomento @`e @option{-a}, la variabile flag
address@hidden viene impostata a vero, e sia @code{ARGV[1]} che
address@hidden vengono cancellati. Se @code{ARGC} @`e minore di due, nessun
address@hidden @`e stato fornito, e @code{tee} stampa un messaggio di sintassi
ed
+esce.
+Infine, @command{awk} viene obbligato a leggere lo standard input
+impostando @code{ARGV[1]} al valore @code{"-"} e @code{ARGC} a due:
+
address@hidden @code{tee.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{tee.awk}
address@hidden
address@hidden file eg/prog/tee.awk
+# tee.awk --- tee in awk
+#
+# Copia lo standard input a tutti i file di output indicati.
+# Aggiunge in fondo se viene data l'opzione -a.
+#
address@hidden endfile
address@hidden
address@hidden file eg/prog/tee.awk
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised December 1995
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/tee.awk
+BEGIN @{
+ for (i = 1; i < ARGC; i++)
+ copia[i] = ARGV[i]
+
+ if (ARGV[1] == "-a") @{
+ append = 1
+ delete ARGV[1]
+ delete copia[1]
+ ARGC--
+ @}
+ if (ARGC < 2) @{
+ print "sintassi: tee [-a] file ..." > "/dev/stderr"
+ exit 1
+ @}
+ ARGV[1] = "-"
+ ARGC = 2
address@hidden
address@hidden endfile
address@hidden example
+
+La seguente regola @`e sufficiente da sola a eseguire il lavoro. Poich@'e non
@`e
+presente alcun criterio di ricerca, la regola @`e eseguita per ogni riga di
+input. Il corpo della regola si limita a stampare la riga su ogni file
+indicato nella riga di comando, e poi sullo standard output:
+
address@hidden
address@hidden file eg/prog/tee.awk
address@hidden
+ # spostare l'if fuori dal ciclo ne velocizza l'esecuzione
+ if (append)
+ for (i in copia)
+ print >> copia[i]
+ else
+ for (i in copia)
+ print > copia[i]
+ print
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
address@hidden anche possibile scrivere il ciclo address@hidden@dotless{i}}:
+
address@hidden
+for (i in copia)
+ if (append)
+ print >> copia[i]
+ else
+ print > copia[i]
address@hidden example
+
address@hidden
+Questa forma @`e address@hidden concisa, ma anche meno efficiente.
L'@samp{if} @`e
+eseguito per ogni record e per ogni file di output. Duplicando il corpo
+del ciclo, l'@samp{if} @`e eseguito solo una volta per ogni record in input.
+Se ci sono
address@hidden record in input e @var{M} file di output, il primo metodo esegue
solo
address@hidden istruzioni @samp{if}, mentre il secondo esegue
address@hidden@address@hidden istruzioni @samp{if}.
+
+Infine, la regola @code{END} fa pulizia, chiudendo tutti i file di output:
+
address@hidden
address@hidden file eg/prog/tee.awk
+END @{
+ for (i in copia)
+ close(copia[i])
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma uniq
address@hidden Stampare righe di testo non duplicate
+
address@hidden FIXME: One day, update to current POSIX version of uniq
+
address@hidden stampare righe di testo non duplicate
address@hidden address@hidden stampare, righe non duplicate di
address@hidden @command{uniq}, programma di address@hidden
address@hidden programma di address@hidden @command{uniq}
+Il programma di address@hidden @command{uniq} legge righe di dati ordinati sul
suo
+standard input, e per default rimuove righe duplicate. In altre parole,
+stampa solo righe uniche; da cui il
+nome. @command{uniq} ha diverse opzioni. La sintassi @`e la seguente:
+
address@hidden
address@hidden address@hidden address@hidden@var{n}}]] address@hidden@var{n}}]
address@hidden address@hidden
address@hidden display
+
+Le opzioni per @command{uniq} sono:
+
address@hidden @code
address@hidden -d
+Stampa solo righe ripetute (duplicate).
+
address@hidden -u
+Stampa solo righe non ripetute (uniche).
+
address@hidden -c
+Contatore righe. Quest'opzione annulla le opzioni @option{-d} e @option{-u}.
+Sia le righe ripetute che quelle non ripetute vengono contate.
+
address@hidden address@hidden
+Salta @var{n} campi prima di confrontare le righe. La definizione di campo
address@hidden simile al default di @command{awk}: caratteri non bianchi,
separati da
+sequenze di spazi e/o TAB.
+
address@hidden address@hidden
+Salta @var{n} caratteri prima di confrontare le righe. Eventuali campi
+specificati con @address@hidden sono saltati prima.
+
address@hidden @var{file_input}
+I dati sono letti dal file in input specificato sulla riga di comando, invece
+che dallo standard input.
+
address@hidden @var{file_output}
+L'output generato @`e scritto sul file di output specificato, invece che sullo
+standard output.
address@hidden table
+
+Normalmente @command{uniq} si comporta come se siano state specificate entrambe
+le opzioni @option{-d} e @option{-u}.
+
address@hidden usa la
+funzione di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e la funzione di libreria @code{join()}
+(@pxref{Funzione join}).
+
+Il programma inizia con una funzione @code{sintassi()} e poi con una breve
+spiegazione delle opzioni e del loro significato, sotto forma di commenti.
+La regola @code{BEGIN} elabora gli argomenti della riga di comando e le
+opzioni. Viene usato un artificio per poter impiegare @code{getopt()} con
+opzioni della forma @samp{-25},
+trattando quest'opzione come la lettera di opzione @samp{2} con
+l'argomento @samp{5}. Se si specificano due o address@hidden cifre
(@code{Optarg}
+sembra essere numerico), @code{Optarg} @`e concatenato con la cifra che
+costituisce l'opzione e poi al risultato @`e addizionato zero, per trasformarlo
+in un numero. Se c'@`e solo una cifra nell'opzione, @code{Optarg} non @`e
+necessario. In tal caso, @code{Optind} dev'essere decrementata, in modo che
address@hidden()} la elabori quando viene nuovamente richiamato. Questo codice
address@hidden sicuramente un po' intricato.
+
+Se non sono specificate opzioni, per default si stampano sia le righe
+ripetute che quelle non ripetute. Il file di output, se specificato, @`e
+assegnato a @code{file_output}. In precedenza, @code{file_output} @`e
+inizializzato allo standard output, @file{/dev/stdout}:
+
address@hidden @code{uniq.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{uniq.awk}
address@hidden
address@hidden file eg/prog/uniq.awk
address@hidden
+# uniq.awk --- implementa uniq in awk
+#
+# Richiede le funzioni di libreria getopt() e join()
address@hidden group
address@hidden endfile
address@hidden
address@hidden file eg/prog/uniq.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/uniq.awk
+
+function sintassi()
address@hidden
+ print("sintassi: uniq [-udc [-n]] [+n] [ in [ out ]]") > "/dev/stderr"
+ exit 1
address@hidden
+
+# -c contatore di righe. prevale su -d e -u
+# -d solo righe ripetute
+# -u solo righe non ripetute
+# -n salta n campi
+# +n salta n caratteri, salta prima eventuali campi
+
+BEGIN @{
+ contatore = 1
+ file_output = "/dev/stdout"
+ opts = "udc0:1:2:3:4:5:6:7:8:9:"
+ while ((c = getopt(ARGC, ARGV, opts)) != -1) @{
+ if (c == "u")
+ solo_non_ripetute++
+ else if (c == "d")
+ solo_ripetute++
+ else if (c == "c")
+ conta_record++
+ else if (index("0123456789", c) != 0) @{
+ # getopt() richiede argomenti per le opzioni
+ # questo consente di gestire cose come -5
+ if (Optarg ~ /^[[:digit:]]+$/)
+ contatore_file = (c Optarg) + 0
+ else @{
+ contatore_file = c + 0
+ Optind--
+ @}
+ @} else
+ sintassi()
+ @}
+
+ if (ARGV[Optind] ~ /^\+[[:digit:]]+$/) @{
+ conta_caratteri = substr(ARGV[Optind], 2) + 0
+ Optind++
+ @}
+
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
+
+ if (solo_ripetute == 0 && solo_non_ripetute == 0)
+ solo_ripetute = solo_non_ripetute = 1
+
+ if (ARGC - Optind == 2) @{
+ file_output = ARGV[ARGC - 1]
+ ARGV[ARGC - 1] = ""
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione seguente, @code{se_sono_uguali()}, confronta la riga corrente,
address@hidden, con la riga precedente, @code{ultima}. Gestisce il salto di
+campi e caratteri. Se non sono stati richiesti n@'e contatori di campo n@'e
+contatori di carattere, @code{se_sono_uguali()} restituisce uno o zero a
+seconda del risultato di un semplice confronto tra le stringhe @code{ultima}
+e @code{$0}.
+
+In caso contrario, le cose si complicano. Se devono essere saltati dei campi,
+ogni riga viene suddivisa in un vettore, usando @code{split()}
+(@pxref{Funzioni per stringhe}); i campi desiderati sono poi nuovamente uniti
in
+un'unica riga usando @code{join()}. Le righe ricongiunte vengono
+immagazzinate in @code{campi_ultima} e @code{campi_corrente}. Se non ci
+sono campi da saltare, @code{campi_ultima} e @code{campi_corrente} sono
+impostati a @code{ultima} e @code{$0}, rispettivamente. Infine, se
+occorre saltare dei caratteri, si usa @code{substr()} per eliminare i primi
address@hidden caratteri in @code{campi_ultima} e
address@hidden Le due stringhe sono poi confrontare e
address@hidden()} restituisce il risultato del confronto:
+
address@hidden
address@hidden file eg/prog/uniq.awk
+function se_sono_uguali( n, m, campi_ultima, campi_corrente,\
+vettore_ultima, vettore_corrente)
address@hidden
+ if (contatore_file == 0 && conta_caratteri == 0)
+ return (ultima == $0)
+
+ if (contatore_file > 0) @{
+ n = split(ultima, vettore_ultima)
+ m = split($0, vettore_corrente)
+ campi_ultima = join(vettore_ultima, contatore_file+1, n)
+ campi_corrente = join(vettore_corrente, contatore_file+1, m)
+ @} else @{
+ campi_ultima = ultima
+ campi_corrente = $0
+ @}
+ if (conta_caratteri) @{
+ campi_ultima = substr(campi_ultima, conta_caratteri + 1)
+ campi_corrente = substr(campi_corrente, conta_caratteri + 1)
+ @}
+
+ return (campi_ultima == campi_corrente)
address@hidden
address@hidden endfile
address@hidden example
+
+Le due regole seguenti sono il corpo del programma. La prima @`e eseguita solo
+per la prima riga dei dati. Imposta @code{ultima} al record corrente
address@hidden, in modo che le righe di testo successive abbiano qualcosa con
cui
+essere confrontate.
+
+La seconda regola fa il lavoro. La variabile @code{uguale} vale uno o zero,
+a seconda del risultato del confronto effettuato in @code{se_sono_uguali()}.
+Se @command{uniq} sta contando le righe ripetute, e le righe sono uguali,
+viene incrementata la variabile @code{contatore}.
+Altrimenti, viene stampata la riga e azzerato @code{contatore},
+perch@'e le due righe non sono uguali.
+
+Se @command{uniq} non sta contando, e se le righe sono uguali,
address@hidden @`e incrementato.
+Non viene stampato niente, perch@'e l'obiettivo @`e quello di rimuovere i
duplicati.
+Altrimenti, se @command{uniq} sta contando le righe ripetute e viene trovata
address@hidden
+di una riga, o se @command{uniq} sta contando le righe non ripetute
+e viene trovata solo una riga, questa riga viene stampata, e @code{contatore}
@`e
+azzerato.
+
+Infine, una logica simile @`e usata nella regola @code{END} per stampare
+l'ultima riga di dati in input:
+
address@hidden
address@hidden file eg/prog/uniq.awk
+NR == 1 @{
+ ultima = $0
+ next
address@hidden
+
address@hidden
+ uguale = se_sono_uguali()
+
+ if (conta_record) @{ # prevale su -d e -u
+ if (uguale)
+ contatore++
+ else @{
+ printf("%4d %s\n", contatore, ultima) > file_output
+ ultima = $0
+ contatore = 1 # reset
+ @}
+ next
+ @}
+
+ if (uguale)
+ contatore++
+ else @{
+ if ((solo_ripetute && contatore > 1) ||
+ (solo_non_ripetute && contatore == 1))
+ print ultima > file_output
+ ultima = $0
+ contatore = 1
+ @}
address@hidden
+
+END @{
+ if (conta_record)
+ printf("%4d %s\n", contatore, ultima) > file_output
+ else if ((solo_ripetute && contatore > 1) ||
+ (solo_non_ripetute && contatore == 1))
+ print ultima > file_output
+ close(file_output)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden FIXME: Include this?
address@hidden
+This program does not follow our recommended convention of naming
+global variables with a leading capital letter. Doing that would
+make the program a little easier to follow.
address@hidden ignore
+
address@hidden FOR_PRINT
+La logica per scegliere quali righe stampare rappresenta una @dfn{macchina a
+stati}, che @`e ``un dispositivo che address@hidden trovarsi in una tra un
dato numero di
+condizioni stabili, a seconda della sua condizione precedente e del valore
+corrente dei suoi input.''@footnote{Questa @`e la definizione trovata
+cercando @code{define: state machine} in Google.}
+Brian Kernighan suggerisce che
+``un approccio alternativo alle macchine a stati @`e quello di mettere l'input
+in un vettore, e poi usare gli indici. @`E quasi sempre address@hidden facile
da
+programmare e, per molti input in cui si address@hidden usare questo metodo,
+altrettanto veloce.'' Si consideri come riscrivere la logica di questo
+programma per seguite questo suggerimento.
address@hidden ifset
+
+
+
address@hidden Programma wc
address@hidden Contare cose
+
address@hidden FIXME: One day, update to current POSIX version of wc
+
address@hidden contare
address@hidden file in input, contare elementi nel
address@hidden parole, contare le
address@hidden caratteri, contare i
address@hidden righe, contare le
address@hidden @command{wc}, programma di address@hidden
address@hidden programma di address@hidden @command{wc}
+Il programma di address@hidden @command{wc} (@dfn{word count}, contatore di
parole)
+conta righe, parole, e caratteri in uno o address@hidden file in input. La sua
sintassi
address@hidden la seguente:
+
address@hidden
address@hidden address@hidden address@hidden @dots{}]
address@hidden display
+
+Se nessun file @`e specificato sulla riga di comando, @command{wc} legge il suo
+standard input. Se ci sono address@hidden file, stampa anche il contatore
totale di
+tutti i file. Le opzioni e il loro significato sono i seguenti:
+
address@hidden @code
address@hidden -l
+Conta solo le righe.
+
address@hidden -w
+Conta solo le parole.
+Una ``parola'' @`e una sequenza contigua di caratteri non bianchi, separata da
+spazi e/o TAB. Fortunatamente, questo @`e il modo normale in cui @command{awk}
+separa i campi nei suoi record in input.
+
address@hidden -c
+Conta solo i caratteri.
address@hidden table
+
+Implementare @command{wc} in @command{awk} @`e particolarmente elegante,
+perch@'e @command{awk} fa molto lavoro al posto nostro; divide le righe in
+parole (address@hidden, campi) e le conta, conta le righe (address@hidden, i
record),
+e address@hidden facilmente dire quanto @`e lunga una riga.
+
+Questo programma usa la funzione di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e le funzioni di passaggio da un file all'altro
+(@pxref{Funzione filetrans}).
+
+Questa versione ha una differenza significativa rispetto alle versioni
+tradizionali di @command{wc}: stampa sempre i contatori rispettando l'ordine
+righe, parole e caratteri. Le versioni tradizionali rilevano l'ordine in cui
+sono specificate le opzioni @option{-l}, @option{-w} e @option{-c} sulla riga
+di comando, e stampano i contatori in quell'ordine.
+
+La regola @code{BEGIN} si occupa degli argomenti. La variabile
address@hidden @`e vera se address@hidden di un file @`e presente sulla
+riga di comando:
+
address@hidden @code{wc.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{wc.awk}
address@hidden
address@hidden file eg/prog/wc.awk
+# wc.awk --- conta righe, parole, caratteri
address@hidden endfile
address@hidden
address@hidden file eg/prog/wc.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/wc.awk
+
+# Opzioni:
+# -l conta solo righe
+# -w conta solo parole
+# -c conta solo caratteri
+#
+# Il default @`e di contare righe, parole, caratteri
+#
+# Richiede le funzioni di libreria getopt()
+# e il programma di libreria che gestisce
+# il passaggio da un file dati al successivo
+
+BEGIN @{
+ # consente a getopt() di stampare un messaggio se si specificano
+ # opzioni non valide. Noi le ignoriamo
+ while ((c = getopt(ARGC, ARGV, "lwc")) != -1) @{
+ if (c == "l")
+ conta_righe = 1
+ else if (c == "w")
+ conta_parole = 1
+ else if (c == "c")
+ conta_caratteri = 1
+ @}
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
+
+ # se nessuna opzione @`e specificata, conta tutto
+ if (! conta_righe && ! conta_parole && ! conta_caratteri)
+ conta_righe = conta_parole = conta_caratteri = 1
+
+ stampa_totale = (ARGC - i > 1)
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{a_inizio_file()} @`e semplice; si limita ad azzerare i
contatori
+di righe, parole e caratteri, e salva il valore corrente di @value{FN} in
address@hidden:
+
address@hidden
address@hidden file eg/prog/wc.awk
+function a_inizio_file(file)
address@hidden
+ righe = parole = caratteri = 0
+ nome_file = FILENAME
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{a_fine_file()} aggiunge i numeri del file corrente al totale
+di righe, parole, e caratteri. Poi stampa i numeri relativi al file appena
+letto. La funzione
address@hidden()} azzera i numeri relativi al @value{DF} seguente:
+
address@hidden
address@hidden file eg/prog/wc.awk
+function a_fine_file(file)
address@hidden
+ totale_righe += righe
+ totale_parole += parole
+ totale_caratteri += caratteri
+ if (conta_righe)
+ printf "\t%d", righe
address@hidden
+ if (conta_parole)
+ printf "\t%d", parole
address@hidden group
+ if (conta_caratteri)
+ printf "\t%d", caratteri
+ printf "\t%s\n", nome_file
address@hidden
address@hidden endfile
address@hidden example
+
+C'@`e una regola che viene eseguita per ogni riga. Aggiunge la lunghezza del
record
address@hidden uno, a @address@hidden@'e @command{gawk} gestisce le
+localizzazioni in cui un carattere address@hidden occupare address@hidden di
un byte, questo codice
+conta i caratteri, non i byte.}
+Aggiungere uno alla lunghezza del record
address@hidden necessario, perch@'e il carattere di ritorno a capo, che separa
i record
+(il valore di @code{RS}) non @`e parte del record stesso, e quindi non @`e
+incluso nella sua lunghezza. Poi, @code{righe} @`e incrementata per ogni riga
+letta, e @code{parole} @`e incrementato con il valore @code{NF}, che @`e il
+numero di ``parole'' su questa riga:
+
address@hidden
address@hidden file eg/prog/wc.awk
+# per ogni riga...
address@hidden
+ caratteri += length($0) + 1 # aggiunge un ritorno a capo
+ righe++
+ parole += NF
address@hidden
address@hidden endfile
address@hidden example
+
+Infine, la regola @code{END} si limita a stampare i totali per tutti i file:
+
address@hidden
address@hidden file eg/prog/wc.awk
+END @{
+ if (stampa_totale) @{
+ if (conta_righe)
+ printf "\t%d", totale_righe
+ if (conta_parole)
+ printf "\t%d", totale_parole
+ if (conta_caratteri)
+ printf "\t%d", totale_caratteri
+ print "\ttotale"
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programmi vari
address@hidden Un paniere di programmi @command{awk}
+
+Questa @value{SECTION} @`e un ``paniere'' che contiene vari programmi.
+Si spera che siano interessanti e divertenti.
+
address@hidden
+* Programma dupword:: Trovare parole duplicate in un documento.
+* Programma alarm:: Un programma di sveglia.
+* Programma translate:: Un programma simile al programma di
address@hidden
+ @command{tr}.
+* Programma labels:: Stampare etichette per lettere.
+* Programma utilizzo parole:: Un programma per produrre un contatore
+ dell'uso di parole in un testo.
+* Programma riordino diario:: Eliminare righe doppie da un file di
+ cronologia.
+* Programma extract :: Estrarre programmi da file sorgenti Texinfo.
+* Programma sed semplice:: Un semplice editor di flusso.
+* Programma igawk:: Un programma per fornire ad
+ @command{awk} la address@hidden di includere
+ file.
+* Programma anagram:: Trovare anagrammi da una lista di parole.
+* Programma signature:: La gente fa cose stupefacenti se ha troppo
+ tempo libero.
address@hidden menu
+
address@hidden Programma dupword
address@hidden Trovare parole duplicate in un documento
+
address@hidden parole duplicate, ricerca di
address@hidden ricerca di parole
address@hidden address@hidden ricerca in
+Un errore comune quando si scrive un testo lungo @`e quello di ripetere
+accidentalmente delle parole. Tipicamente lo si address@hidden vedere in
testi del tipo
+``questo questo programma fa quanto address@hidden'' Quando il testo @`e
pubblicato in rete, spesso
+le parole duplicate sono poste tra il termine di
address@hidden
+di
address@hidden iftex
+una riga e l'inizio di un'altra, il che rende difficile scoprirle.
address@hidden as here!
+
+Questo programma, @file{dupword.awk}, legge un file una riga alla volta
+e cerca le occorrenze adiacenti della stessa parola. Conserva anche
+l'ultima parola di ogni riga (nella variabile @code{precedente}) per
+confrontarla con la prima parola sulla riga successiva.
+
address@hidden Texinfo
+Le prime due istruzioni fanno address@hidden@dotless{i}} che la riga sia tutta
in minuscolo,
+in modo che, per esempio, ``Il'' e ``il'' risultino essere la stessa parola.
+L'istruzione successiva sostituisce i caratteri che sono non alfanumerici e
+diversi dagli
+spazi bianchi con degli spazi, in modo che neppure la punteggiatura influenzi
+i confronti.
+I caratteri sono rimpiazzati da spazi in modo che i controlli di formattazione
+non creino parole prive di senso (p.es., l'espressione Texinfo
address@hidden@@address@hidden@}} diventa @samp{codeNF}, se ci si limita a
eliminare la
+punteggiatura). Il record @`e poi
+suddiviso di nuovo in campi, producendo address@hidden@dotless{i}} solo la
lista delle parole
+presenti sulla riga, esclusi eventuali campi nulli.
+
+Se, dopo aver rimosso tutta la punteggiatura, non rimane alcun campo, il
+record corrente @`e saltato. In caso contrario, il programma esegue il ciclo
+per ogni parola, confrontandola con quella che la precede:
+
address@hidden @code{dupword.awk}, programma
address@hidden programma @code{dupword.awk}
address@hidden
address@hidden file eg/prog/dupword.awk
+# dupword.awk --- trova parole duplicate in un testo
address@hidden endfile
address@hidden
address@hidden file eg/prog/dupword.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# December 1991
+# Revised October 2000
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/dupword.awk
address@hidden
+ $0 = tolower($0)
+ gsub(/[^[:alnum:][:blank:]]/, " ");
+ $0 = $0 # divide di nuovo in campi
+ if (NF == 0)
+ next
+ if ($1 == prec)
+ printf("%s:%d: duplicato %s\n",
+ nome_file, FNR, $1)
+ for (i = 2; i <= NF; i++)
+ if ($i == $(i-1))
+ printf("%s:%d: duplicato %s\n",
+ nome_file, FNR, $i)
+ prec = $NF
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma alarm
address@hidden Un programma di sveglia
address@hidden insonnia, cura per
address@hidden Robbins, Arnold
address@hidden
address@hidden cura contro l'insonnia @`e efficace quanto una sveglia che
suona.}
address@hidden Arnold Robbins
address@hidden quotation
address@hidden Quanstrom, Erik
address@hidden
+Date: Sat, 15 Feb 2014 16:47:09 -0500
+Subject: Re: 9atom install question
+Message-ID: <address@hidden>
+From: Erik Quanstrom <address@hidden>
+To: Aharon Robbins <address@hidden>
+
+yes.
+
+- erik
+
+Aharon Robbins <address@hidden> wrote:
+
+>> sleep is for web developers.
+>
+>Can I quote you, in the gawk manual?
+>
+>Thanks,
+>
+>Arnold
address@hidden ignore
address@hidden
address@hidden sonno @`e per sviluppatori web.}
address@hidden Erik Quanstrom
address@hidden quotation
+
address@hidden tempo, sveglia, programma di esempio
address@hidden sveglia, programma di esempio
+Il seguente programma @`e un semplice programma di ``sveglia''.
+Si address@hidden specificare un'ora del giorno e un messaggio opzionale.
All'ora
+specificata, il programma stampa il messaggio sullo standard output. Inoltre,
+si address@hidden specificare il numero di volte in cui il messaggio va
ripetuto, e
+anche un intervallo di tempo (ritardo) tra ogni ripetizione.
+
+Questo programma usa la funzione @code{getlocaltime()}
address@hidden
+dalla
address@hidden iftex
address@hidden
+da
address@hidden ifnottex
address@hidden getlocaltime}.
+
+Tutto il lavoro @`e svolto nella regola @code{BEGIN}. La prima parte @`e
+il controllo degli argomenti e l'impostazione dei valori di default:
+l'intervallo prima di ripetere, il contatore, e il messaggio da stampare.
+Se l'utente ha fornito un messaggio che non contiene il carattere ASCII BEL
+(noto come carattere ``campanello'', @code{"\a"}), questo viene aggiunto al
+messaggio. (Su molti sistemi, stampare il carattere ASCII BEL genera un suono
+udibile. Quindi, quando la sveglia suona, il sistema richiama l'attenzione
+su di s@'e nel caso che l'utente non stia guardando il computer.)
+Per amor di address@hidden, questo programma usa un'istruzione @code{switch}
+(@pxref{Istruzione switch}), ma l'elaborazione potrebbe anche essere fatta
+con una serie di istruzioni @address@hidden
+Ecco il programma:
+
address@hidden @code{alarm.awk}, programma
address@hidden programma @code{alarm.awk}
address@hidden
address@hidden file eg/prog/alarm.awk
+# alarm.awk --- impostare una sveglia
+#
+# Richiede la funzione di libreria getlocaltime()
address@hidden endfile
address@hidden
address@hidden file eg/prog/alarm.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised December 2010
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/alarm.awk
+# sintassi: alarm a_che_ora [ "messaggio" [ contatore [ ritardo ] ] ]
+
+BEGIN @{
+ # Controllo iniziale address@hidden argomenti
+ sintassi1 = "sintassi: alarm a_che_ora ['messaggio' [contatore [ritardo]]]"
+ sintassi2 = sprintf("\t(%s) formato ora: ::= hh:mm", ARGV[1])
+
+ if (ARGC < 2) @{
+ print sintassi1 > "/dev/stderr"
+ print sintassi2 > "/dev/stderr"
+ exit 1
+ @}
+ switch (ARGC) @{
+ case 5:
+ ritardo = ARGV[4] + 0
+ # vai al caso seguente
+ case 4:
+ contatore = ARGV[3] + 0
+ # vai al caso seguente
+ case 3:
+ messaggio = ARGV[2]
+ break
+ default:
+ if (ARGV[1] !~ /[[:digit:]]?[[:digit:]]:[[:digit:address@hidden@}/) @{
+ print sintassi1 > "/dev/stderr"
+ print sintassi2 > "/dev/stderr"
+ exit 1
+ @}
+ break
+ @}
+
+ # imposta i valori di default per quando arriva l'ora desiderata
+ if (ritardo == 0)
+ ritardo = 180 # 3 minuti
address@hidden
+ if (contatore == 0)
+ contatore = 5
address@hidden group
+ if (messaggio == "")
+ messaggio = sprintf("\aAdesso sono le %s!\a", ARGV[1])
+ else if (index(message, "\a") == 0)
+ messaggio = "\a" messaggio "\a"
address@hidden endfile
address@hidden example
+
+La successiva @value{SECTION} di codice scompone l'ora specificata in ore e
+minuti, la converte (se @`e il caso) al formato 24-ore, e poi calcola il
+relativo numero di secondi dalla mezzanotte. Poi trasforma l'ora corrente in
+un contatore dei secondi dalla
+mezzanotte. La differenza tra i due @`e il tempo di attesa che deve passare
+prima di far scattare la sveglia:
+
address@hidden
address@hidden file eg/prog/alarm.awk
+ # scomponi ora della sveglia
+ split(ARGV[1], ore_minuti, ":")
+ ora = ore_minuti[1] + 0 # trasforma in numero
+ minuto = ore_minuti[2] + 0 # trasforma in numero
+
+ # ottiene ora corrente divisa in campi
+ getlocaltime(adesso)
+
+ # se l'ora desiderata @`e in formato 12-ore ed @`e nel pomeriggio
+ # (p.es., impostare `alarm 5:30' alle 9 del mattino
+ # vuol dire far suonare la sveglia alle 5:30 pomeridiane)
+ # aggiungere 12 all'ora richiesta
+ if (hour < 12 && adesso["hour"] > ora)
+ ora += 12
+
+ # imposta l'ora in secondi dalla mezzanotte
+ sveglia = (ora * 60 * 60) + (minuto * 60)
+
+ # ottieni l'ora corrente in secondi dalla mezzanotte
+ corrente = (now["hour"] * 60 * 60) + \
+ (now["minute"] * 60) + now["second"]
+
+ # quanto restare appisolati
+ sonno = sveglia - corrente
+ if (sonno <= 0) @{
+ print "alarm: l'ora @`e nel passato!" > "/dev/stderr"
+ exit 1
+ @}
address@hidden endfile
address@hidden example
+
address@hidden @command{sleep}, programma di address@hidden
address@hidden programma di address@hidden @command{sleep}
+Infine, il programma usa la funzione @code{system()}
+(@pxref{Funzioni di I/O})
+per chiamare il programma di address@hidden @command{sleep}. Il programma di
address@hidden
address@hidden non fa altro che aspettare per il numero di secondi
+specificato. Se il codice di ritorno restituito @`e diverso da zero, il
+programma suppone che @command{sleep} sia stato interrotto ed esce. Se
address@hidden @`e terminato con un codice di ritorno corretto, (zero), il
+programma stampa il messaggio in un ciclo, utilizzando ancora @command{sleep}
+per ritardare per il numero di secondi necessario:
+
address@hidden
address@hidden file eg/prog/alarm.awk
+ # zzzzzz..... esci se sleep @`e interrotto
+ if (system(sprintf("sleep %d", sonno)) != 0)
+ exit 1
+
+ # @`e ora di avvisare!
+ command = sprintf("sleep %d", ritardo)
+ for (i = 1; i <= contatore; i++) @{
+ print messaggio
+ # se il comando sleep @`e interrotto, esci
+ if (system(command) != 0)
+ break
+ @}
+
+ exit 0
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma translate
address@hidden Rimpiazzare o eliminare caratteri
+
address@hidden caratteri, rimpiazzare
address@hidden rimpiazzare caratteri
address@hidden @command{tr}, programma di address@hidden
address@hidden programma di address@hidden @command{tr}
+Il programma di address@hidden di sistema @command{tr} rimpiazza caratteri.
Per
+esempio, @`e spesso usato per trasformare lettere maiuscole in lettere
minuscole
+in vista di ulteriori elaborazioni:
+
address@hidden
address@hidden dei dati} | tr 'A-Z' 'a-z' | @var{elaborare dei dati} @dots{}
address@hidden example
+
address@hidden richiede due liste di address@hidden alcuni sistemi
address@hidden datati, incluso Solaris, la versione di sistema di @command{tr}
address@hidden
+richiedere che le liste siano scritte come espressioni di intervallo,
+racchiuse in parentesi quadre
+(@samp{[a-z]}) e tra apici, per evitare che la shell effettui
+espansioni di @value{FN}. Questo non @`e un miglioramento.} Quando
+si elabora l'input, il primo carattere della prima lista @`e rimpiazzato con il
+primo carattere della seconda lista, il secondo carattere della prima lista @`e
+rimpiazzato con il secondo carattere della seconda lista, e
address@hidden@dotless{i}} via. Se ci
+sono address@hidden caratteri nella lista ``da'' che in quella ``a'', l'ultimo
carattere
+della lista ``a'' @`e usato per i restanti caratteri della lista ``da''.
+
+In un lontano passato,
address@hidden early or mid-1989!
+un utente propose di aggiungere una funzione di traslitterazione a
address@hidden
address@hidden Wishing to avoid gratuitous new features,
address@hidden at least theoretically
+Il programma seguente @`e stato scritto per dimostrare che la traslitterazione
+di caratteri poteva essere fatta con una funzione definita dall'utente.
+Questo programma non @`e address@hidden@dotless{i}} completo come il programma
di address@hidden di sistema
address@hidden, ma svolge buona parte dello stesso lavoro.
+
+Il programma @command{translate} @`e stato scritto molto prima che
@command{gawk}
+fosse in grado di separare ciascun carattere di una stringa in elementi
+distinti di un vettore. Questo @`e il motivo per cui usa ripetutamente le
+funzioni predefinite @code{substr()}, @code{index()}, e @code{gsub()}
+(@pxref{Funzioni per stringhe}).
+Ci sono due funzioni. La prima, @code{traduci_stringa()},
+richiede tre argomenti:
+
address@hidden @code
address@hidden da
+Una lista di caratteri da cui traslitterare
+
address@hidden a
+Una lista di caratteri a cui traslitterare
+
address@hidden stringa
+La stringa su cui effettuare la traslitterazione
address@hidden table
+
+I vettori associativi facilitano molto la parte di traslitterazione.
address@hidden contiene i caratteri ``a'', indicizzato dai
+caratteri ``da''. Poi un semplice
+ciclo scandisce @code{da}, un carattere alla volta. Per ogni carattere
+in @code{da}, se il carattere compare in @code{stringa}
address@hidden rimpiazzato con il corrispondente carattere @code{a}.
+
+La funzione @code{traducilo()} chiama @code{traduci_stringa()}, usando
@code{$0}
+come stringa. Il programma principale imposta due variabili globali,
@code{DA} e
address@hidden, dalla riga di comando, e poi modifica @code{ARGV} in modo che
address@hidden legga dallo standard input.
+
+Infine, la regola di elaborazione si limita a chiamare @code{traducilo()}
+per ogni record:
+
address@hidden @code{translate.awk}, programma
address@hidden programma @code{translate.awk}
address@hidden
address@hidden file eg/prog/translate.awk
+# translate.awk --- fa cose simili al comando tr
address@hidden endfile
address@hidden
address@hidden file eg/prog/translate.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# August 1989
+# February 2009 - bug fix
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/translate.awk
+# Bug: non gestisce cose del tipo tr A-Z a-z; deve essere
+# descritto carattere per carattere.
+# Tuttavia, se `a' @`e address@hidden corto di `da',
+# l'ultimo carattere in `a' @`e usato per il resto di `da'.
+
+function traduci_stringa(da, a, stringa, lf, lt, lstringa, vettore_trad,
+ i, c, risultato)
address@hidden
+ lf = length(da)
+ lt = length(a)
+ lstringa = length(stringa)
+ for (i = 1; i <= lt; i++)
+ vettore_trad[substr(da, i, 1)] = substr(a, i, 1)
+ if (lt < lf)
+ for (; i <= lf; i++)
+ vettore_trad[substr(da, i, 1)] = substr(a, lt, 1)
+ for (i = 1; i <= lstringa; i++) @{
+ c = substr(stringa, i, 1)
+ if (c in vettore_trad)
+ c = vettore_trad[c]
+ risultato = risultato c
+ @}
+ return risultato
address@hidden
+
+function traducilo(da, a)
address@hidden
+ return $0 = traduci_stringa(da, a, $0)
address@hidden
+
+# programma principale
+BEGIN @{
address@hidden
+ if (ARGC < 3) @{
+ print "sintassi: translate da a" > "/dev/stderr"
+ exit
+ @}
address@hidden group
+ DA = ARGV[1]
+ A = ARGV[2]
+ ARGC = 2
+ ARGV[1] = "-"
address@hidden
+
address@hidden
+ traducilo(DA, A)
+ print
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden possibile effettuare la traslitterazione di caratteri in una
funzione a
+livello utente, ma non @`e detto che sia efficiente, e noi (sviluppatori
+di @command{gawk}) abbiamo iniziato a prendere in considerazione l'aggiunta di
una funzione.
+Tuttavia, poco dopo aver scritto questo programma, abbiamo saputo che Brian
+Kernighan aveva aggiunto le funzioni @code{toupper()} e @code{tolower()} alla
+sua versione di @command{awk} (@pxref{Funzioni per stringhe}). Queste
+funzioni gestiscono la maggior parte dei casi in cui serva la traslitterazione
+di caratteri, e quindi abbiamo deciso di limitarci ad aggiungere le stesse
+funzioni a @command{gawk}, e di disinteressarci del resto.
+
+Un miglioramento ovvio a questo programma sarebbe di impostare il vettore
address@hidden solo una volta, in una regola @code{BEGIN}. Tuttavia,
address@hidden
+presuppone che le liste ``da'' e ``a'' non cambino mai durante tutta
+l'esecuzione del programma.
+
+Un altro miglioramento ovvio @`e di consentire l'uso di intervalli, come
address@hidden, come consentito dal programma di address@hidden @command{tr}.
Si address@hidden
+trarre ispirazione dal codice di @file{cut.awk} (@pxref{Programma cut}).
+
+
address@hidden Programma labels
address@hidden Stampare etichette per lettere
+
address@hidden stampare etichette per lettera
address@hidden etichette per address@hidden stampare
+Ecco un programma ``del mondo-reale''@footnote{``Del mondo-reale'' @`e definito
+come ``un programma effettivamente usato per realizzare qualcosa''.}.
+Questo script legge elenchi di nomi e indirizzi, e genera etichette per
+lettera. Ogni pagina di etichette contiene 20 etichette, su due file da 10
+etichette l'una. Gli indirizzi non possono contenere address@hidden di cinque
righe di
+dati. Ogni indirizzo @`e separato dal successivo da una riga bianca.
+
+L'idea di base @`e di leggere dati per 20 etichette. Ogni riga di ogni
etichetta
address@hidden immagazzinata nel vettore @code{riga}. L'unica regola si occupa
di riempire
+il vettore @code{riga} e di stampare la pagina dopo che sono state lette 20
+etichette.
+
+La regola @code{BEGIN} si limita a impostare @code{RS} alla stringa vuota, in
+modo che @command{awk} divida un record dal successivo quando incontra una riga
+bianca.
+(@pxref{Record}).
+Inoltre imposta @code{LIMITE_LINEE} a 100,
+perch@'e 100 @`e il massimo numero di righe sulla pagina
address@hidden
+(@math{20 @cdot 5 = 100}).
address@hidden iftex
address@hidden
address@hidden
+(20 * 5 = 100).
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+(20 ⋅ 5 = 100).
address@hidden docbook
+
+Il grosso del lavoro @`e svolto nella funzione @code{stampa_pagina()}.
+Le righe che compongono le etichette sono immagazzinate sequenzialmente nel
vettore
address@hidden Ma occorre stamparle in
+orizzontale: @code{riga[1]} a fianco di @code{riga[6]}, @code{riga[2]} a
+fianco di @code{riga[7]}, e address@hidden@dotless{i}} via. Questo si
address@hidden fare utilizzando due
+cicli. Quello address@hidden esterno, controllato dalla variabile @code{i},
gestisce 10
+righe di dati, ovvero la stampa di due etichette una a fianco dell'altra.
+Il ciclo address@hidden interno
+controllato dalla variabile @code{j}, gestisce le singole righe che compongono
+ognuno degli indirizzi.
+Poich@'e @code{j} varia da 0 a 4, @samp{i+j} @`e la riga @code{j}-esima
+dell'indirizzo di sinistra, e @samp{i+j+5} @`e quella stampata alla sua destra.
+L'output @`e simile a quello mostrato qui sotto:
+
address@hidden
+riga 1 riga 6
+riga 2 riga 7
+riga 3 riga 8
+riga 4 riga 9
+riga 5 riga 10
address@hidden
address@hidden example
+
address@hidden
+La stringa di formato per @code{printf} @samp{%-41s} allinea a
+sinistra i dati, e li stampa in un campo di lunghezza fissa.
+
+Come nota finale, un'ulteriore riga bianca extra viene stampata alle righe 21 e
+61, per mantenere entro i bordi l'output sulle etichette. address@hidden
dipende dalla
+particolare marca di etichette in uso quando il programma @`e stato scritto.
+Si noti anche che ci sono due righe bianche a inizio pagina e due righe
+bianche a fine pagina.
+
+La regola @code{END} si occupa di stampare l'ultima pagina di
+etichette; @`e improbabile che il numero di indirizzi da stampare sia un
+multiplo esatto di 20:
+
address@hidden @code{labels.awk}, programma
address@hidden programma @code{labels.awk}
address@hidden
address@hidden file eg/prog/labels.awk
+# labels.awk --- stampare etichette per lettera
address@hidden endfile
address@hidden
address@hidden file eg/prog/labels.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# June 1992
+# December 2010, minor edits
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/labels.awk
+
+# Ogni etichetta @`e 5 righe di dati, qualcuna delle quali address@hidden
essere bianca.
+# I fogli con le etichetta hanno 2 righe bianche in cima alla pagina e altre 2
+# a fine pagina.
+
+BEGIN @{ RS = "" ; LIMITE_LINEE = 100 @}
+
+function stampa_pagina( i, j)
address@hidden
+ if (NUMEROrighe <= 0)
+ return
+
+ printf "\n\n" # in cima
+
+ for (i = 1; i <= NUMEROrighe; i += 10) @{
+ if (i == 21 || i == 61)
+ print ""
+ for (j = 0; j < 5; j++) @{
+ if (i + j > LIMITE_LINEE)
+ break
+ printf " %-41s %s\n", riga[i+j], riga[i+j+5]
+ @}
+ print ""
+ @}
+
+ printf "\n\n" # in fondo
+
+ delete riga
address@hidden
+
+# regola principale
address@hidden
+ if (contatore >= 20) @{
+ stampa_pagina()
+ contatore = 0
+ NUMEROrighe = 0
+ @}
+ n = split($0, a, "\n")
+ for (i = 1; i <= n; i++)
+ riga[++NUMEROrighe] = a[i]
+ for (; i <= 5; i++)
+ riga[++NUMEROrighe] = ""
+ contatore++
address@hidden
+
+END @{
+ stampa_pagina()
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma utilizzo parole
address@hidden Generare statistiche sulla frequenza d'uso delle parole
+
address@hidden parole, statistica utilizzo delle
address@hidden statistica utilizzo delle parole
+
+Quando si lavora con una grande address@hidden di testo, address@hidden essere
interessante
+sapere quanto spesso ricorrono le diverse parole. Per esempio, un autore
address@hidden
+fare un uso eccessivo di certe parole, e in questo caso si potrebbero
+trovare sinonimi da sostituire a
+parole che appaiono troppo spesso.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden spiega come
+scrivere un programma per contare le parole e presentare in un formato
+utile le informazioni relative alla loro frequenza.
+
+A prima vista, un programma come questo sembrerebbe essere sufficiente:
+
address@hidden
+# wordfreq-first-try.awk --- stampa lista frequenze utilizzo parole
+
address@hidden
+ for (i = 1; i <= NF; i++)
+ freq[$i]++
address@hidden
+
+END @{
+ for (word in freq)
+ printf "%s\t%d\n", word, freq[word]
address@hidden
address@hidden example
+
+Il programma si affida al meccanismo con cui @command{awk} divide i campi per
+default, per suddividere ogni riga in ``parole'' e usa un vettore associativo
+di nome @code{freq}, che ha per indici le singole parole, per contare il
+numero di volte che ogni parola viene usata. Nella regola @code{END}, stampa i
+contatori.
+
+Questo programma ha parecchi problemi che lo rendono praticamente inutile
+su file di testo reali:
+
address@hidden @value{BULLET}
address@hidden
+Il linguaggio @command{awk} considera i caratteri maiuscoli e minuscoli come
+distinti (non equivalenti). Quindi, ``barista'' e ``Barista'' sono
+considerate parole differenti. Questo non @`e un comportamento auspicabile,
+perch@'e le parole iniziano con la lettera maiuscola se sono a inizio frase in
+un testo normale, e un analizzatore di frequenze dovrebbe ignorare la
+distinzione maiuscolo/minuscolo.
+
address@hidden
+Le parole sono individuate usando la convenzione @command{awk} secondo cui i
+campi sono separati solo da spazi bianchi. Altri caratteri nell'input
+(tranne il ritorno a capo) non hanno alcun particolare significato per
address@hidden Questo significa che i segni di interpunzione sono visti come
+parte di una parola.
+
address@hidden
+L'output non @`e scritto in alcun ordine utile. Si @`e probabilmente
address@hidden
+interessati a sapere quali parole ricorrono address@hidden di frequente, o ad
avere
+una tabella in ordine alfabetico che mostra quante volte ricorre ogni parola.
address@hidden itemize
+
address@hidden @command{sort}, programma di address@hidden
address@hidden programma di address@hidden @command{sort}
+Il primo problema si address@hidden risolvere usando @code{tolower()} per
rimuovere la
+distinzione maiuscolo/minuscolo. Il secondo problema si address@hidden
risolvere usando
address@hidden()} per rimuovere i caratteri di interpunzione. Infine, per
+risolvere il terzo problema si address@hidden usare il programma di
address@hidden
address@hidden per elaborare l'output dello script @command{awk}. Ecco la
+nuova versione del programma:
+
address@hidden @code{wordfreq.awk}, programma
address@hidden programma @code{wordfreq.awk}
address@hidden
address@hidden file eg/prog/wordfreq.awk
+# wordfreq.awk --- stampa la lista con la frequenza delle parole
+
address@hidden
+ $0 = tolower($0) # togli maiuscolo/minuscolo
+ # togli interpunzione
+ gsub(/[^[:alnum:]_[:blank:]]/, "", $0)
+ for (i = 1; i <= NF; i++)
+ freq[$i]++
address@hidden
+
address@hidden endfile
+END @{
+ for (word in freq)
+ printf "%s\t%d\n", word, freq[word]
address@hidden
address@hidden example
+
+La @dfn{regexp} @code{/[^[:alnum:]_[:blank:]]/} si poteva scrivere come
address@hidden/[[:punct:]]/}, ma in questo modo il caratteri trattino basso
sarebbe
+stato rimosso, mentre si desidera conservarlo.
+
+Supponendo di aver salvato questo programma in un file di nome
address@hidden,
+e che i dati siano in @file{file1}, il seguente comando con @dfn{pipeline}:
+
address@hidden
+awk -f wordfreq.awk file1 | sort -k 2nr
address@hidden example
+
address@hidden
+produce una tabella delle parole che appaiono in @file{file1} in ordine
+descrescente di frequenza.
+
+Il programma @command{awk} da solo gestisce adeguatamente i dati e produce
+una tabella delle frequenza che non @`e ordinata.
+L'output di @command{awk} @`e poi messo in ordine dal programma di
address@hidden
address@hidden e stampato sullo schermo.
+
+Le opzioni passate a @command{sort}
+richiedono un ordinamento che usi come chiave il secondo campo di ogni riga
+in input (saltando il primo campo), che le chiavi di ordinamento siano
+trattate come address@hidden numeriche
+(altrimenti @samp{15} sarebbe stampato prima di @samp{5}), e che l'ordinamento
+sia fatto in ordine decrescente (inverso).
+
+Il comando @command{sort} potrebbe anche essere richiamato dall'interno del
+programma, cambiando l'azione da fare nella regola @code{END} a:
+
address@hidden
address@hidden file eg/prog/wordfreq.awk
+END @{
+ sort = "sort -k 2nr"
+ for (word in freq)
+ printf "%s\t%d\n", word, freq[word] | sort
+ close(sort)
address@hidden
address@hidden endfile
address@hidden example
+
+Questa maniera di ordinare dev'essere usata su sistemi che non hanno delle
+vere e proprie @dfn{pipe} a livello di riga di comando (o di procedura di
+comandi).
+Si veda la documentazione generale riguardo al sistema operativo per maggiori
+informazioni su come usare il programma @command{sort}.
+
address@hidden Programma riordino diario
address@hidden Eliminare duplicati da un file non ordinato
+
address@hidden righe, address@hidden rimuovere
address@hidden rimuovere righe duplicate
+Il programma @command{uniq}
+(@pxref{Programma uniq})
+rimuove righe duplicate da dati @emph{ordinati}.
+
+Si supponga, tuttavia, di dover rimuovere righe duplicate da un @value{DF},
+ma di voler conservare l'ordine in cui le righe sono state scritte. Un buon
+esempio di questo tipo potrebbe essere un file della cronologia dei comandi
+della shell. Il file della cronologia dei comandi
+mantiene copia di tutti i comandi che sono stati dati, e non @`e
+insolito ripetere un comando molte volte di fila. Occasionalmente si
+potrebbe voler compattare la cronologia togliendo le righe duplicate.
+Tuttavia sarebbe opportuno mantenere l'ordine originale dei comandi.
+
+Questo semplice programma fa questo. Usa due vettori. Il vettore @code{dati}
+ha come indice il testo di ogni riga.
+Per ogni riga, @code{dati[$0]} @`e incrementato di uno.
+Se una particolare riga non @`e stata ancora vista, @code{dati[$0]} @`e zero.
+In tal caso, il testo della riga @`e immagazzinato in @code{righe[contatore]}.
+Ogni elemento del vettore @code{righe} @`e un comando unico, e gli
+indici di @code{righe} indicano l'ordine in cui quelle righe sono state
+incontrate.
+La regola @code{END} stampa semplicemente le righe, in ordine:
+
address@hidden Rakitzis, Byron
address@hidden @code{histsort.awk}, programma
address@hidden programma @code{histsort.awk}
address@hidden
address@hidden file eg/prog/histsort.awk
+# histsort.awk --- compatta un file della cronologia dei comandi della shell
+# Grazie a Byron Rakitzis per l'idea generale
address@hidden endfile
address@hidden
address@hidden file eg/prog/histsort.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/histsort.awk
+
address@hidden
address@hidden
+ if (dati[$0]++ == 0)
+ righe[++contatore] = $0
address@hidden
address@hidden group
+
address@hidden
+END @{
+ for (i = 1; i <= contatore; i++)
+ print righe[i]
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+Questo programma address@hidden essere un punto di partenza per generare altre
+informazioni utili.
+Per esempio, usando la seguente istruzione @code{print} nella regola
address@hidden permette di sapere quante volte viene usato un certo comando:
+
address@hidden
+print dati[righe[i]], righe[i]
address@hidden example
+
address@hidden
+Questo si address@hidden fare perch@'e @code{dati[$0]} @`e incrementato ogni
volta che una
+riga @`e stata trovata.
+
address@hidden Programma extract
address@hidden Estrarre programmi da un file sorgente Texinfo
+
address@hidden Texinfo, estrarre programma da file sorgente
address@hidden estrarre programma da file sorgente Texinfo
address@hidden file Texinfo, estrarre programma da
address@hidden
+Sia questo capitolo che il precedente
+(@ref{Funzioni di libreria})
+presentano un numero elevato di programmi @command{awk}.
address@hidden ifnotinfo
address@hidden
+I nodi
address@hidden di libreria},
+e @ref{Programmi di esempio},
+sono nodi al livello address@hidden elevato, e
+contengono nodi che descrivono un numero elevato di programmi @command{awk}.
address@hidden ifinfo
+Se si vuole fare pratica con questi programmi, @`e fastidioso doverli
+digitare di nuovo manualmente. @`E per questo che abbiamo pensato a un
programma
+in grado di estrarre parti di un file in input Texinfo e metterli in file
+separati.
+
address@hidden Texinfo
+Questo @value{DOCUMENT} @`e scritto in
@uref{http://www.gnu.org/software/texinfo/, Texinfo},
+il programma di formattazione di documenti del progetto GNU.
+Un solo file sorgente Texinfo address@hidden essere usato per produrre sia la
+documentazione stampata, usando @TeX{}, sia quella online.
address@hidden
+(Texinfo @`e esaurientemente documentato nel libro
address@hidden GNU Documentation Format},
+disponibile alla Free Software Foundation,
+e anche @uref{http://www.gnu.org/software/texinfo/manual/texinfo/, online}.)
address@hidden ifnotinfo
address@hidden
+(Il linguaggio Texinfo @`e descritto esaurientemente, a partire da
address@hidden, , Texinfo, texinfo,Texinfo---The GNU Documentation Format}.)
address@hidden ifinfo
+
+Per quel che ci riguarda, @`e sufficiente sapere tre cose riguardo ai file di
+input Texinfo:
+
address@hidden @value{BULLET}
address@hidden
+Il simbolo ``chiocciola'' (@samp{@@}) @`e speciale per
+Texinfo, proprio come la barra inversa (@samp{\}) lo @`e per il linguaggio C
+o per @command{awk}. I simboli @samp{@@} sono rappresentati nel sorgente
+Texinfo come @samp{@@@@}.
+
address@hidden
+I commenti iniziano con @samp{@@c} o con @samp{@@comment}.
+Il programma di estrazione file funziona usando dei commenti speciali che
+sono posti all'inizio di una riga.
+
address@hidden
+Righe contenenti comandi @samp{@@group} e @samp{@@end group} racchiudono testi
+di esempio che non dovrebbero andare a cavallo di due pagine.
+(Sfortunatamente, @TeX{} non @`e sempre in grado di fare le cose in maniera
+esatta, e quindi va un po' aiutato).
address@hidden itemize
+
+Il programma seguente, @file{extract.awk}, legge un file sorgente Texinfo
+e fa due cose, basandosi sui commenti speciali.
+Dopo aver visto il commento @address@hidden@@c system @dots{}}},
+esegue un comando, usando il testo del comando contenuto nella
+riga di controllo e passandolo alla funzione @code{system()}
+(@pxref{Funzioni di I/O}).
+Dopo aver trovato il commento @samp{@@c file @var{nome_file}}, ogni riga
+successiva @`e spedita al file @var{nome_file}, fino a che si trova un
+commento @samp{@@c endfile}.
+Le regole in @file{extract.awk} sono soddisfatte sia quando incontrano
address@hidden@@c} che quando incontrano @samp{@@comment} e quindi la parte
address@hidden @`e opzionale.
+Le righe che contengono @samp{@@group} e @samp{@@end group} sono semplicemente
+ignorate.
address@hidden usa la funzione di libreria @code{join()}
+(@pxref{Funzione join}).
+
+I programmi di esempio nel sorgente Texinfo online di @address@hidden
+(@file{gawktexi.in}) sono stati tutti inseriti tra righe @samp{file} e righe
address@hidden La distribuzione di @command{gawk} usa una copia di
address@hidden per estrarre i programmi di esempio e per installarne
+molti in una particolare directory dove @command{gawk} li address@hidden
trovare.
+Il file Texinfo ha un aspetto simile a questo:
+
address@hidden
address@hidden
+Questo programma ha una regola @@address@hidden@}
+che stampa un messaggio scherzoso:
+
+@@example
+@@c file esempi/messages.awk
+BEGIN @@@{ print "Non v'allarmate!" @@@}
+@@c endfile
+@@end example
+
+Stampa anche qualche avviso conclusivo:
+
+@@example
+@@c file esempi/messages.awk
+END @@@{ print "Evitate sempre gli archeologi annoiati!" @@@}
+@@c endfile
+@@end example
address@hidden
address@hidden example
+
+Il programma @file{extract.awk} inizia con l'impostare @code{IGNORECASE} a
+uno, in modo che un miscuglio di lettere maiuscole e minuscole nelle direttive
+non faccia differenza.
+
+La prima regola gestisce le chiamate a @code{system()}, controllando che sia
+stato fornito un comando (@code{NF} dev'essere almeno tre) e controllando
+anche che il comando termini con un codice di ritorno uguale a zero, che sta
+a significare che tutto @`e andato bene:
+
address@hidden @code{extract.awk}, programma
address@hidden programma @code{extract.awk}
address@hidden
address@hidden file eg/prog/extract.awk
+# extract.awk --- estrae file ed esegue programmi dal file Texinfo
address@hidden endfile
address@hidden
address@hidden file eg/prog/extract.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised September 2000
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/extract.awk
+
+BEGIN @{ IGNORECASE = 1 @}
+
+/^@@c(omment)?[ \t]+system/ @{
+ if (NF < 3) @{
+ e = ("extract: " FILENAME ":" FNR)
+ e = (e ": riga `system' con formato errato")
+ print e > "/dev/stderr"
+ next
+ @}
+ $1 = ""
+ $2 = ""
+ stat = system($0)
+ if (stat != 0) @{
+ e = ("extract: " FILENAME ":" FNR)
+ e = (e ": attenzione: system ha restituito " stat)
+ print e > "/dev/stderr"
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+La variabile @code{e} @`e stata usata per far address@hidden@dotless{i}} che
la regola
+sia agevolemente contenuta nella @value{PAGE}.
+
+La seconda regola gestisce il trasferimento di dati in un file. Verifica che
+nella direttiva sia stato fornito un @value{FN}.
+Se il nome del file non @`e quello del file corrente, il file
+corrente viene chiuso. Mantenere aperto il file corrente finch@'e non si trova
+un nuovo nome file permette di usare la ridirezione @samp{>} per stampare i
+contenuti nel file, semplificando la gestione dei file aperti.
+
+Il ciclo @code{for} esegue il lavoro. Legge le righe usando @code{getline}
+(@pxref{Getline}).
+Se si raggiunge una fine-file inattesa, viene chiamata la funzione
address@hidden@w{fine_file_inattesa()}}. Se la riga @`e una riga ``endfile'',
+il ciclo viene abbandonato.
+Se la riga inizia con @samp{@@group} o @samp{@@end group}, la riga viene
+ignorata, e si passa a quella seguente. Allo stesso modo, eventuali commenti
+all'interno degli esempi vengono ignorati.
+
+Il grosso del lavoro @`e nelle poche righe che seguono. Se la riga non ha
+simboli @samp{@@}, il programma la address@hidden
+stampare address@hidden@dotless{i}} com'@`e. Altrimenti, ogni @samp{@@} a
inizio parola dev'essere
+eliminato.
+Per rimuovere i simboli @samp{@@}, la riga viene divisa nei singoli elementi
+del vettore @code{a}, usando la funzione @code{split()}
+(@pxref{Funzioni per stringhe}).
+Il simbolo @samp{@@} @`e usato come carattere di separazione.
+Ogni elemento del vettore @code{a} che risulti vuoto indica due caratteri
address@hidden@@} contigui nella riga originale. Per ogni due elementi vuoti
+(@samp{@@@@} nel file originale), va inserito un solo simbolo @samp{@@} nel
+file in output.
+
+Una volta terminato di esaminare il vettore, viene chiamata la funzione
@code{join()}
+specificando nella chiamata il valore di @code{SUBSEP}
+(@pxref{Vettori multidimensionali}),
+per riunire nuovamente i pezzi in una riga sola.
+La riga @`e poi stampata nel file di output:
+
address@hidden
address@hidden file eg/prog/extract.awk
+/^@@c(omment)?[ \t]+file/ @{
+ if (NF != 3) @{
+ e = ("extract: " FILENAME ":" FNR ": riga `file' con formato errato")
+ print e > "/dev/stderr"
+ next
+ @}
+ if ($3 != file_corrente) @{
+ if (file_corrente != "")
+ close(file_corrente)
+ file_corrente = $3
+ @}
+
+ for (;;) @{
+ if ((getline riga) <= 0)
+ fine_file_inattesa()
+ if (riga ~ /^@@c(omment)?[ \t]+endfile/)
+ break
+ else if (riga ~ /^@@(end[ \t]+)?group/)
+ continue
+ else if (riga ~ /^@@c(omment+)?[ \t]+/)
+ continue
+ if (index(riga, "@@") == 0) @{
+ print riga > file_corrente
+ continue
+ @}
+ n = split(riga, a, "@@")
+ # if a[1] == "", vuol dire riga che inizia per @@,
+ # non salvare un @@
+ for (i = 2; i <= n; i++) @{
+ if (a[i] == "") @{ # era un @@@@
+ a[i] = "@@"
+ if (a[i+1] == "")
+ i++
+ @}
+ @}
+ print join(a, 1, n, SUBSEP) > file_corrente
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden importante notare l'uso della ridirezione @samp{>} .
+L'output fatto usando @samp{>} apre il file solo la prima volta; il file resta
+poi aperto, e ogni scrittura successiva @`e aggiunta in fondo al file.
+(@pxref{Ridirezione}).
address@hidden rende possibile mischiare testo del programm e commenti
esplicativi
+(come @`e stato fatto qui) nello stesso file sorgente, senza nessun problema.
+Il file viene chiuso solo quando viene trovato un nuovo nome di
address@hidden oppure alla fine del file in input.
+
+Per finire, la funzione @address@hidden()}} stampa un
+appropriato messaggio di errore ed esce.
+La regola @code{END} gestisce la pulizia finale, chiudendo il file aperto:
+
address@hidden
address@hidden file eg/prog/extract.awk
address@hidden
+function fine_file_inattesa()
address@hidden
+ printf("extract: %s:%d: fine-file inattesa, o errore\n",
+ FILENAME, FNR) > "/dev/stderr"
+ exit 1
address@hidden
address@hidden group
+
+END @{
+ if (file_corrente)
+ close(file_corrente)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma sed semplice
address@hidden Un semplice editor di flusso
+
address@hidden @command{sed}, programma di address@hidden
address@hidden programma di address@hidden @command{sed}
address@hidden editori di flusso
address@hidden flusso, editori di
+Il programma di address@hidden @command{sed} @`e un @dfn{editore di flusso},
+ovvero un programma che legge un flusso di dati, lo modifica, e scrive il file
address@hidden@dotless{i}} modificato.
address@hidden spesso usato per fare modifiche generalizzate a un grosso file,
o a un
+flusso di dati generato da una @dfn{pipeline} di comandi.
+Sebbene @command{sed} sia un programma piuttosto complesso di suo, l'uso che
+se ne fa solitamente @`e di effettuare delle sostituzioni globali attraverso
+una @dfn{pipeline}:
+
address@hidden
address@hidden < dati.originali | sed 's/vecchio/nuovo/g' | @var{comando2} >
risultato
address@hidden example
+
+Qui, @samp{s/vecchio/nuovo/g} chiede a @command{sed} di ricercare la
address@hidden @samp{vecchio} in ogni riga di input e di sostituirla
+dappertutto con il testo @samp{nuovo} (address@hidden, in tutte le occorrenze
di
+ciascuna riga). Questo @`e simile a quello che fa la funzione di @command{awk}
address@hidden()}
+(@pxref{Funzioni per stringhe}).
+
+Il programma seguente, @file{awksed.awk}, accetta almeno due argomenti dalla
+riga di comando: l'espressione da ricercare e il testo con cui rimpiazzarla.
+Ogni ulteriore argomento @`e considerato
+come un nome di @value{DF} da elaborare. Se non ne viene fornito alcuno, si
+usa lo standard input:
+
address@hidden Brennan, Michael
address@hidden @command{awksed.awk}, programma
address@hidden programma @command{awksed.awk}
address@hidden @cindex simple stream editor
address@hidden @cindex stream editor, simple
address@hidden
address@hidden file eg/prog/awksed.awk
+# awksed.awk --- fa s/pippo/pluto/g usando solo print
+# Ringraziamenti a Michael Brennan per l'idea
address@hidden endfile
address@hidden
address@hidden file eg/prog/awksed.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# August 1995
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/awksed.awk
+
+function sintassi()
address@hidden
+ print "sintassi: awksed espressione rimpiazzo [file...]" > "/dev/stderr"
+ exit 1
address@hidden
+
+BEGIN @{
+ # valida argomenti
+ if (ARGC < 3)
+ sintassi()
+
+ RS = ARGV[1]
+ ORS = ARGV[2]
+
+ # non usare argomenti come nomi di file
+ ARGV[1] = ARGV[2] = ""
address@hidden
+
address@hidden
+# guarda, mamma, senza mani!
address@hidden
+ if (RT == "")
+ printf "%s", $0
+ else
+ print
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+Il programma fa assegnamento sulla address@hidden di @command{gawk} di avere
come
address@hidden una @dfn{regexp},
+e anche sul fatto che @code{RT} viene impostato al testo che effettivamente
+delimita il record (@pxref{Record}).
+
+L'idea @`e di usare @code{RS} come espressione da ricercare. @command{gawk}
+automaticamente imposta @code{$0} al testo che compare tra due corrispondenze
+all'espressione di ricerca.
+Questo @`e appunto il testo che vogliamo conservare inalterato. Quindi,
+impostando @code{ORS} al testo che si vuole sostituire, una semplice
+istruzione @code{print} scrive il testo che si vuole mantenere, seguito dal
+testo che si vuole invece sostituire.
+
+C'@`e un problema in questo schema, ossia cosa fare se l'ultimo record
+non termina con un testo che corrisponde a @code{RS}. Usando un'istruzione
address@hidden incondizionatamente stampa il testo da sostituire, il che non
address@hidden corretto.
+Tuttavia, se il file non termina con del testo che corrisponde a @code{RS},
address@hidden @`e impostata alla stringa nulla. In tal caso, si
address@hidden stampare
address@hidden usando @code{printf}
+(@pxref{Printf}).
+
+La regola @code{BEGIN} gestisce la preparazione, controllando che ci sia
+il numero giusto di argomenti e chiamando @code{sintassi()} se c'@`e un
problema.
+Poi imposta @code{RS} e @code{ORS} dagli argomenti della riga di comando e
+imposta @code{ARGV[1]} e @code{ARGV[2]} alla stringa nulla, per impedire che
+vengano considerati dei @value{FNS}
+(@pxref{ARGC e ARGV}).
+
+La funzione @code{sintassi()} stampa un messaggio di errore ed esce.
+Per finire, l'unica regola gestisce lo schema di stampa delineato
address@hidden sopra,
+usando @code{print} o @code{printf} come richiesto, a seconda del valore di
address@hidden
+
address@hidden Programma igawk
address@hidden Una maniera facile per usare funzioni di libreria
+
address@hidden libreria di funzioni @command{awk}, programma di esempio per
usare
address@hidden funzioni, librerie di, programma di esempio per usare
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden file}, abbiamo visto come @command{gawk} preveda la
address@hidden di includere file. Tuttavia, questa @`e un'estensione
@command{gawk}.
+Questa @value{SECTION} evidenzia l'address@hidden di rendere l'inclusione di
+file disponibile per @command{awk} standard, e mostra come farlo utilizzando
+una combinazione di programmazione di shell e di @command{awk}.
+
+Usare funzioni di libreria in @command{awk} address@hidden presentare molti
vantaggi.
+Incoraggia il riutilizzo di codice e la scrittura di funzioni di tipo
+generale. I programmi sono address@hidden snelli e quindi address@hidden
comprensibili.
+Tuttavia, usare funzioni di libreria @`e facile solo in fase di scrittura di
+programmi @command{awk}; @`e invece complicato al momento di eseguirli,
+rendendo necessario specificare molte opzioni @option{-f}. Se @command{gawk}
+non @`e disponibile, non lo sono neppure la variabile d'ambiente @env{AWKPATH}
e
+la address@hidden di conservare funzioni @command{awk} in una directory di
+libreria (@pxref{Opzioni}).
+Sarebbe bello poter scrivere programmi nel modo seguente:
+
address@hidden
+# funzioni di libreria
+@@include getopt.awk
+@@include join.awk
address@hidden
+
+# programma principale
+BEGIN @{
+ while ((c = getopt(ARGC, ARGV, "a:b:cde")) != -1)
+ @dots{}
+ @dots{}
address@hidden
address@hidden example
+
+Il programma seguente, @file{igawk.sh}, fornisce questo servizio.
+Simula la ricerca da parte di @command{gawk} della variabile d'ambiente
address@hidden e permette anche delle inclusioni @dfn{nidificate}
(address@hidden,
+un file che @`e stato incluso tramite
address@hidden@@include} address@hidden contenere ulteriori istruzioni
@code{@@include}).
address@hidden tenta di includere ogni file una volta sola, in modo che delle
+inclusioni nidificate non contengano accidentalmente una funzione di libreria
address@hidden di una volta.
+
address@hidden dovrebbe comportarsi esternamente proprio come @command{gawk}.
+Questo vuol dire che dovrebbe accettare sulla riga di comando tutti gli
+argomenti di @command{gawk}, compresa
+la address@hidden di specificare address@hidden file
+sorgenti tramite l'opzione @option{-f}
+e la address@hidden di mescolare istruzioni da riga di comando e file di
sorgenti di
+libreria.
+
+Il programma @`e scritto usando il linguaggio della Shell POSIX
+(@command{sh})address@hidden spiegazione dettagliata del linguaggio della
address@hidden non rientra negli intenti di questo libro. Qualche spiegazione
+sommaria viene fornita, ma se si desidera una comprensione address@hidden
dettagliata, si
+dovrebbe consultare un buon libro sulla programmazione della shell.}
+Il funzionamento @`e il seguente:
+
address@hidden
address@hidden
+Esegue un ciclo attraverso gli argomenti, salvando tutto address@hidden che
non si presenta come
+codice sorgente @command{awk}, per quando il programma espanso address@hidden
eseguito.
+
address@hidden
+Per ogni argomento che rappresenta del codice @command{awk}, mette l'argomento
+in una variabile di shell che address@hidden espansa. Ci sono due casi:
+
address@hidden a
address@hidden
+Un testo letterale, fornito con l'opzione @option{-e} o @option{--source}.
+Questo testo viene aggiunto direttamente in fondo.
+
address@hidden
address@hidden sorgenti, forniti con l'opzione @option{-f}. Usiamo il
trucchetto
+di aggiungere @samp{@@include @var{nome_file}} in fondo ai contenuti della
+variabile di shell. Poich@'e il programma di inclusione dei file funziona
+allo stesso modo in cui funziona @command{gawk}, ne risulta che il file viene
+incluso nel programma al punto giusto.
address@hidden enumerate
+
address@hidden
+Esegue un programma (naturalmente @command{awk}) sui contenuti della variabile
+di shell per espandere le istruzioni
address@hidden@@include}. Il programma espanso @`e messo in una seconda
variabile di
+shell.
+
address@hidden
+Esegue il programma espanso richiamando @command{gawk} e tutti gli altri
+argomenti originalmente forniti dall'utente sulla riga di comando (come p.es.
+dei nomi di @value{DF}).
address@hidden enumerate
+
+Questo programma usa variabili di shell in address@hidden: per immagazzinare
+argomenti della riga di comando e
+il testo del programma @command{awk} che address@hidden il programma
dell'utente,
+per il programma originale dell'utente e per il programma espanso. Questo
+modo di procedere risolve potenziali
+problemi che potrebbero presentarsi se si usassero invece dei file temporanei,
+ma rende lo script un po' address@hidden complicato.
+
+La parte iniziale del programma attiva il tracciamento della shell se il primo
+argomento @`e @samp{debug}.
+
+La parte successiva esegue un ciclo che esamina ogni argomento della riga di
+comando.
+Ci sono parecchi casi da esaminare:
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @option{--}
+Quest'opzione termina gli argomenti per @command{igawk}. Tutto quel che segue
+dovrebbe essere passato al programma @command{awk} dell'utente senza essere
+preso in considerazione.
+
address@hidden @option{-W}
+Questo indica che l'opzione successiva @`e propria di @command{gawk}. Per
+facilitare l'elaborazione degli argomenti, l'opzione @option{-W} @`e aggiunta
+davanti agli argomenti rimanenti, e il
+ciclo continua. (Questo @`e un trucco di programmazione della @command{sh}.
+Non @`e il caso di preoccuparsene se non si ha address@hidden con il comando
address@hidden)
+
address@hidden @option{-v}, @option{-F}
+Queste opzioni sono conservate e lasciate da gestire a @command{gawk}.
+
address@hidden @option{-f}, @option{--file}, @option{--file=}, @option{-Wfile=}
+Il @value{FN} @`e aggiunto alla variabile di shell @code{programma}, insieme
+a un'istruzione @code{@@include}.
+Il programma di address@hidden @command{expr} @`e usato per eliminare la parte
+iniziale dell'argomento (p.es., @samp{--file=}).
+(La sintassi tipica di @command{sh} richiederebbe di usare il comando
address@hidden e il programma di address@hidden @command{sed} per far questo.
+Sfortunatamente, alcune versioni di @command{echo} valutano le sequenze
+di protezione contenute nei loro argomenti, e questo potrebbe finire per
+alterare il testo del programma.
+L'uso di @command{expr} evita questo problema.)
+
address@hidden @option{--source}, @option{--source=}, @option{-Wsource=}
+Il testo sorgente @`e aggiunto in fondo a @code{programma}.
+
address@hidden @option{--version}, @option{-Wversion}
address@hidden stampa il proprio numero di versione, esegue
address@hidden --version} per ottenere l'informazione relativa alla versione di
address@hidden, ed esce.
address@hidden table
+
+Se nessuno degli argomenti
address@hidden, @option{--file}, @option{-Wfile}, @option{--source},
+o @option{-Wsource} @`e stato fornito, il primo argomento che non @`e
un'opzione
+dovrebbe essere il programma @command{awk}. Se non ci sono argomenti rimasti
+sulla riga di comando, @command{igawk} stampa un messaggio di errore ed esce.
+Altrimenti, il primo argomento @`e aggiunto in fondo a @code{programma}.
+In qualsiasi caso, dopo che gli argomenti sono stati elaborati,
+la variabile di shell
address@hidden contiene il testo completo del programma originale
address@hidden
+
+Il programma @`e il seguente:
+
address@hidden @code{igawk.sh}, programma
address@hidden programma @code{igawk.sh}
address@hidden
address@hidden file eg/prog/igawk.sh
+#! /bin/sh
+# igawk --- come gawk ma abilita l'uso di @@include
address@hidden endfile
address@hidden
address@hidden file eg/prog/igawk.sh
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# July 1993
+# December 2010, minor edits
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/igawk.sh
+
+if [ "$1" = debug ]
+then
+ set -x
+ shift
+fi
+
+# Un ritorno a capo letterale,
+# per formattare correttamente il testo del programma
+n='
+'
+
+# Inizializza delle variabili alla stringa nulla
+programma=
+opts=
+
+while [ $# -ne 0 ] # ciclo sugli argomenti
+do
+ case $1 in
+ --) shift
+ break ;;
+
+ -W) shift
+ # Il costrutto address@hidden'messaggio qui'@} stampa un
+ # messaggio diagnostico se $x @`e la stringa nulla
+ set -- -W"address@hidden@@?'manca operando'@}"
+ continue ;;
+
+ -[vF]) opts="$opts $1 'address@hidden'manca operando'@}'"
+ shift ;;
+
+ -[vF]*) opts="$opts '$1'" ;;
+
+ -f) programma="$programma$n@@include address@hidden'manca operando'@}"
+ shift ;;
+
+ -f*) f=$(expr "$1" : '-f\(.*\)')
+ programma="$programma$n@@include $f" ;;
+
+ -[W-]file=*)
+ f=$(expr "$1" : '-.file=\(.*\)')
+ programma="$programma$n@@include $f" ;;
+
+ -[W-]file)
+ programma="$programma$n@@include address@hidden'manca operando'@}"
+ shift ;;
+
+ -[W-]source=*)
+ t=$(expr "$1" : '-.source=\(.*\)')
+ programma="$programma$n$t" ;;
+
+ -[W-]source)
+ programma="address@hidden'manca operando'@}"
+ shift ;;
+
+ -[W-]version)
+ echo igawk: version 3.0 1>&2
+ gawk --version
+ exit 0 ;;
+
+ -[W-]*) opts="$opts '$1'" ;;
+
+ *) break ;;
+ esac
+ shift
+done
+
+if [ -z "$programma" ]
+then
+ address@hidden'manca programma'@}
+ shift
+fi
+
+# A questo punto, `programma' contiene il programma.
address@hidden endfile
address@hidden example
+
+Il programma @command{awk} che elabora le direttive @code{@@include}
address@hidden immagazzinato nella variabile di shell @code{progr_che_espande}.
address@hidden serve
+a mantenere leggibile lo script. Questo programma @command{awk} legge
+tutto il programma dell'utente, una riga per volta, usando @code{getline}
+(@pxref{Getline}). I @value{FNS} in input e le istruzioni @code{@@include}
+sono gestiti usando una pila. Man mano che viene trovata una @code{@@include},
+il valore corrente di @value{FN} @`e
+``spinto'' sulla pila e il file menzionato nella direttiva @code{@@include}
+diventa il @value{FN} corrente. Man mano che un file @`e finito,
+la pila viene ``disfatta'', e il precedente file in input diventa nuovamente il
+file in input corrente. Il processo viene iniziato ponendo il file originale
+come primo file sulla pila.
+
+La funzione @code{percorso()} trova qual @`e il percorso completo di un file.
+Simula il comportamento di @command{gawk} quando utilizza la variabile
+d'ambiente @env{AWKPATH}
+(@pxref{AWKPATH (Variabile)}).
+Se un @value{FN} contiene una @samp{/}, non viene effettuata la ricerca del
+percorso. Analogamente, se il
address@hidden @`e @code{"-"}, viene usato senza alcuna modifica. Altrimenti,
+il @value{FN} @`e concatenato col nome di ogni directory nella lista dei
+percorsi, e vien fatto un tentativo per aprire il @value{FN}
address@hidden@dotless{i}} generato.
+Il solo modo di controllare se un file @`e leggibile da @command{awk} @`e di
+andare avanti e tentare di leggerlo con
address@hidden; questo @`e quel che
address@hidden()} address@hidden alcune versioni molto datate di
address@hidden, il test @samp{getline da_buttare < t} address@hidden ripetersi
in un ciclo
+infinito se il file esiste ma @`e vuoto.}
+Se il file address@hidden essere letto, viene chiuso e viene restituito il
valore di
address@hidden:
+
address@hidden
+An alternative way to test for the file's existence would be to call
address@hidden("test -r " t)}, which uses the @command{test} utility to
+see if the file exists and is readable. The disadvantage to this method
+is that it requires creating an extra process and can thus be slightly
+slower.
address@hidden ignore
+
address@hidden
address@hidden file eg/prog/igawk.sh
+progr_che_espande='
+
+function percorso(file, i, t, da_buttare)
address@hidden
+ if (index(file, "/") != 0)
+ return file
+
+ if (file == "-")
+ return file
+
+ for (i = 1; i <= n_dir; i++) @{
+ t = (lista_percorsi[i] "/" file)
address@hidden
+ if ((getline da_buttare < t) > 0) @{
+ # found it
+ close(t)
+ return t
+ @}
address@hidden group
+ @}
+ return ""
address@hidden
address@hidden endfile
address@hidden example
+
+Il programma principale @`e contenuto all'interno di una regola @code{BEGIN}.
+La prima cosa che fa @`e di impostare il vettore @code{lista_percorsi} usato
+dalla funzione @code{percorso()}. Dopo aver diviso la lista usando come
+delimitatore @samp{:}, gli elementi nulli sono sostituiti da @code{"."},
+che rappresenta la directory corrente:
+
address@hidden
address@hidden file eg/prog/igawk.sh
+BEGIN @{
+ percorsi = ENVIRON["AWKPATH"]
+ n_dir = split(percorsi, lista_percorsi, ":")
+ for (i = 1; i <= n_dir; i++) @{
+ if (lista_percorsi[i] == "")
+ lista_percorsi[i] = "."
+ @}
address@hidden endfile
address@hidden example
+
+La pila @`e inizializzata con @code{ARGV[1]}, che address@hidden
@code{"/dev/stdin"}.
+Il ciclo principale viene subito dopo. Le righe in input sono lette una dopo
+l'altra. Righe che non iniziano con @code{@@include} sono stampate
address@hidden@dotless{i}} come
+sono.
+Se la riga inizia con @code{@@include}, il @value{FN} @`e in @code{$2}.
+La funzione @code{percorso()} @`e chiamata per generare il percorso completo.
+Se questo non riesce, il programma stampa un messaggio di errore e continua.
+
+Subito dopo occorre controllare se il file sia address@hidden stato incluso.
Il vettore
address@hidden @`e indicizzato dal nome completo di ogni @value{FN} incluso
+e tiene traccia per noi di questa informazione. Se un file viene visto
address@hidden
+volte, viene stampato un messaggio di avvertimento. Altrimenti il nuovo
address@hidden @`e aggiunto alla pila e l'elaborazione continua.
+
+Infine, quando @code{getline} giunge alla fine del file in input, il file
+viene chiuso, e la pila viene elaborata. Quando @code{indice_pila} @`e minore
+di zero, il programma @`e terminato:
+
address@hidden
address@hidden file eg/prog/igawk.sh
+ indice_pila = 0
+ input[indice_pila] = ARGV[1] # ARGV[1] @`e il primo file
+
+ for (; indice_pila >= 0; indice_pila--) @{
+ while ((getline < input[indice_pila]) > 0) @{
+ if (tolower($1) != "@@include") @{
+ print
+ continue
+ @}
+ cammino = percorso($2)
address@hidden
+ if (cammino == "") @{
+ printf("igawk: %s:%d: non riesco a trovare %s\n",
+ input[indice_pila], FNR, $2) > "/dev/stderr"
+ continue
+ @}
address@hidden group
+ if (! (cammino in gia_fatto)) @{
+ gia_fatto[cammino] = input[indice_pila]
+ input[++indice_pila] = cammino # aggiungilo alla pila
+ @} else
+ print $2, "incluso in", input[indice_pila],
+ "era address@hidden incluso in",
+ gia_fatto[cammino] > "/dev/stderr"
+ @}
+ close(input[indice_pila])
+ @}
address@hidden' # l'apice chiude la variabile `progr_che_espande'
+
+programma_elaborato=$(gawk -- "$progr_che_espande" /dev/stdin << EOF
+$programma
+EOF
+)
address@hidden endfile
address@hidden example
+
+Il costrutto di shell @address@hidden << @var{marcatore}} @`e chiamato
address@hidden document} (@dfn{documento sul posto}). Ogni riga presente nello
+script di shell fino al @var{marcatore} @`e passato in input a @var{comando}.
+La shell elabora i contenuti dell'@dfn{here document} sostituendo, dove serve,
+variabili e comandi (ed eventualmente altre cose, a seconda della shell
+in uso).
+
+Il costrutto di shell @samp{$(@dots{})} @`e chiamato @dfn{sostituzione di
comando}.
+L'output del comando posto all'interno delle parentesi @`e sostituito
+nella riga di comando.
+Poich@'e il risultato @`e usato in un assegnamento di variabile,
+viene salvato come un'unica stringa di caratteri, anche se il risultato
+contiene degli spazi bianchi.
+
+Il programma espanso @`e salvato nella variabile @code{programma_elaborato}.
+Il tutto avviene secondo le fasi seguenti:
+
address@hidden
address@hidden
+Si esegue @command{gawk} con il programma che gestisce le @code{@@include}
+(il valore della variabile di shell
address@hidden) leggendo lo standard input.
+
address@hidden
+Lo standard input contiene il programma dell'utente,
+nella variabile di shell @code{programma}.
+L'input @`e passato a @command{gawk} tramite un @dfn{here document}.
+
address@hidden
+I risultati di questo processo sono salvati nella variabile di shell
address@hidden usando la sostituzione di comando.
address@hidden enumerate
+
+L'ultima fase @`e la chiamata a @command{gawk} con il programma espanso,
+insieme alle opzioni originali e agli argomenti della riga di comando che
+l'utente aveva fornito:
+
address@hidden
address@hidden file eg/prog/igawk.sh
+eval gawk $opts -- '"$programma_elaborato"' '"$@@"'
address@hidden endfile
address@hidden example
+
+Il comando @command{eval} @`e una struttura della shell che riesegue
+l'elaborazione dei parametri della riga di comando. Gli apici proteggono le
+parti restanti.
+
+Questa versione di @command{igawk} @`e la quinta versione di questo programma.
+Ci sono quattro semplificazioni migliorative:
+
address@hidden @value{BULLET}
address@hidden
+L'uso di @code{@@include} anche per i file specificati tramite l'opzione
address@hidden consente di semplificare di molto la preparazione del programma
+iniziale @command{awk}; tutta l'elaborazione delle istruzioni @code{@@include}
address@hidden essere svolta in una sola volta.
+
address@hidden
+Non tentare di salvare la riga letta tramite @code{getline} all'interno della
+funzione @code{percorso()} quando si controlla se il file @`e accessibile
+per il successivo uso nel programma principale semplifica notevolmente
+le cose.
+
address@hidden
+Usare un ciclo di @code{getline} nella regola @code{BEGIN} rende possibile
+fare tutto in un solo posto. Non @`e necessario programmare un ulteriore ciclo
+per elaborare le istruzioni @code{@@include} nidificate.
+
address@hidden
+Invece di salvare il programma espanso in un file temporaneo, assegnarlo a
+una variabile di shell evita alcuni potenziali problemi di sicurezza.
address@hidden address@hidden ha lo svantaggio di basare lo script su
address@hidden del
+linguaggio @command{sh}, il che rende address@hidden difficile la comprensione
a chi non
+abbia address@hidden con il comando
address@hidden
address@hidden itemize
+
+Inoltre, questo programma dimostra come spesso valga la pena di utilizzare
+insieme la programmazione della @command{sh} e quella di @command{awk}.
+Solitamente, si address@hidden fare parecchio senza dover ricorrere alla
programmazione
+di basso livello in C o C++, ed @`e spesso address@hidden facile fare certi
tipi di
+manipolazioni di stringhe e argomenti usando la shell, piuttosto che
address@hidden
+
+Infine, @command{igawk} dimostra che non @`e sempre necessario aggiungere nuove
address@hidden a un programma; queste possono spesso essere aggiunte in
address@hidden@command{gawk}
address@hidden in grado di elaborare istruzioni @code{@@include} al suo stesso
interno, per
+permettere l'uso di programmi @command{awk} come script Web CGI.}
+
+
address@hidden Programma anagram
address@hidden Trovare anagrammi da una lista di parole
+
address@hidden anagrammi, trovare
+Un'interessante sfida per il programmatore @`e quella di cercare
@dfn{anagrammi} in una
+lista di parole (come
address@hidden/usr/share/dict/italian} presente in molti sistemi GNU/Linux).
+Una parola @`e un anagramma di un'altra se entrambe le parole contengono
+le stesse lettere
+(p.es., ``branzino'' e ``bronzina'').
+
+La Colonna 2, Problema C, della seconda edizione del libro di Jon Bentley
address@hidden Pearls}, presenta un algoritmo elegante.
+L'idea @`e di assegnare a parole che sono anagrammi l'una dell'altra una
+firma comune, e poi di ordinare tutte le parole in base alla loro
+firma e di stamparle.
+Il Dr.@: Bentley fa notare che prendere tutte le lettere di ogni parola ed
+elencarle in ordine alfabetico produce queste firme comuni.
+
+Il programma seguente usa vettori di vettori per riunire
+parole con la stessa firma, e l'ordinamento di vettori per stampare le
+parole trovate in ordine alfabetico:
+
address@hidden @code{anagram.awk}, programma
address@hidden programma @code{anagram.awk}
address@hidden
address@hidden file eg/prog/anagram.awk
+# anagram.awk --- Un'implementazione dell'algoritmo per trovare anagrammi
+# dalla seconda edizione
+# del libro di Jon Bentley "Programming Pearls".
+# Addison Wesley, 2000, ISBN 0-201-65788-0.
+# Colonna 2, Problema C, sezione 2.8, pp 18-20.
address@hidden endfile
address@hidden
address@hidden file eg/prog/anagram.awk
+#
+# Questo programma richiede gawk 4.0 o una versione successiva.
+# address@hidden di gawk richieste:
+# - veri vettori multidimensionali
+# - split() con separatore "" per separare ogni singolo carattere
+# - le funzioni asort() e asorti()
+#
+# Vedere http://savannah.gnu.org/projects/gawk.
+#
+# Arnold Robbins
+# arnold@@skeeve.com
+# Public Domain
+# January, 2011
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/anagram.awk
+
+/'s$/ @{ next @} # Salta i genitivi sassoni
address@hidden endfile
address@hidden example
+
+Il programma inizia con un'intestazione, e poi una regola per saltare
+i genitivi sassoni eventualmente contenuti nel file che contiene la lista di
+parole. La regola
+successiva costruisce la struttura dei dati. Il primo indice del vettore
address@hidden rappresentato dalla firma; il secondo @`e la parola stessa:
+
address@hidden
address@hidden file eg/prog/anagram.awk
address@hidden
+ chiave = da_parola_a_chiave($1) # costruisce la firma
+ data[chiave][$1] = $1 # Immagazzina parola con questa firma
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{da_parola_a_chiave()} crea la firma.
+Divide la parola in lettere singole, mette in ordine alfabetico le lettere,
+e poi le rimette ancora insieme:
+
address@hidden
address@hidden file eg/prog/anagram.awk
+# da_parola_a_chiave --- divide parole in lettere, ordina e riunisce
+
+function da_parola_a_chiave(parola, a, i, n, risultato)
address@hidden
+ n = split(parola, a, "")
+ asort(a)
+
+ for (i = 1; i <= n; i++)
+ risultato = risultato a[i]
+
+ return risultato
address@hidden
address@hidden endfile
address@hidden example
+
+Infine, la regola @code{END} percorre tutto il vettore e stampa
+le liste degli anagrammi. L'output @`e poi passato al
+comando di sistema @command{sort} perch@'e altrimenti gli
+anagrammi sarebbero elencati in ordine arbitrario:
+
address@hidden
address@hidden file eg/prog/anagram.awk
+END @{
+ sort = "sort"
+ for (chiave in data) @{
+ # ordina parole con la stessa chiave
+ n_parole = asorti(data[chiave], parole)
+ if (n_parole == 1)
+ continue
+
+ # e stampa. Problema minore: uno spazio extra a fine di ogni riga
+ for (j = 1; j <= n_parole; j++)
+ printf("%s ", parole[j]) | sort
+ print "" | sort
+ @}
+ close(sort)
address@hidden
address@hidden endfile
address@hidden example
+
+Ecco una piccola parte dell'output quando il programma @`e eseguito:
+
address@hidden
+$ @kbd{gawk -f anagram.awk /usr/share/dict/italian | grep '^b'}
address@hidden
+baraste bastare serbata
+barasti basarti
+baratro tabarro
+barattoli ribaltato tribolata
+barbieri birberia
+barche brache
+barcollerei corbelleria
+bare erba
+bareremmo brameremo
+barili librai
address@hidden
address@hidden example
+
+
address@hidden Programma signature
address@hidden E ora per qualcosa di completamente differente
+
address@hidden @code{signature}, programma
address@hidden programma @code{signature}
address@hidden Brini, Davide
+Il programma seguente @`e stato scritto da Davide Brini
address@hidden (@email{dave_br@@gmx.com})
+ed @`e pubblicato sul
@uref{http://backreference.org/2011/02/03/obfuscated-awk/,
+suo sito web}.
+Serve come sua firma nel gruppo Usenet @code{comp.lang.awk}.
+Questi sono i termini da lui stabiliti per il copyright:
+
address@hidden
+Copyright @copyright{} 2008 Davide Brini
+
+Copying and distribution of the code published in this page, with or without
+modification, are permitted in any medium without royalty provided the
copyright
+notice and this notice are preserved.
address@hidden quotation
+
+Ecco il programma:
+
address@hidden
+awk 'address@hidden"~"~"~";o="=="=="==";o+=+o;x=O""O;while(X++<=x+o+o)c=c"%c";
+printf c,(x-O)*(x-O),x*(x-o)-o,x*(x-O)+x-O-o,+x*(x-O)-x+o,X*(o*o+O)+x-O,
+X*(X-x)-o*o,(x+X)*o*o+o,x*(X-x)-O-O,x-O+(O+o+X+x)*(o+O),X*X-X*(x-O)-x+O,
+O+X*(o*(o+O)+O),+x+O+X*o,x*(x-o),(o+X+x)*o*o-(x-O-O),O+(X-x)*(X+O),address@hidden'
address@hidden example
address@hidden genera l'email del tizio:
address@hidden address@hidden
+
address@hidden Johansen, Chris
+Viene lasciato al lettore il piacere di stabilire cosa fa il programma.
+(Se si @`e sull'orlo della disperazione nel tentativo di comprensione, si veda
+la spiegazione di Chris Johansen,
+che @`e contenuta nel file sorgente Texinfo di questo @value{DOCUMENT}.)
+
address@hidden
+To: "Arnold Robbins" <address@hidden>
+Date: Sat, 20 Aug 2011 13:50:46 -0400
+Subject: The GNU Awk User's Guide, Section 13.3.11
+From: "Chris Johansen" <address@hidden>
+Message-ID: <address@hidden>
+
+Arnold, tu non mi conosci, ma c'@`e un sottile legame tra noi. Mia moglie @`e
+Barbara A. Field, FAIA, GIT '65 (B. Arch.).
+
+Ho un paio di copie cartacee di "Effective Awk Programming" da
+anni, ed ora sto leggendo di nuovo la versione Kindle di "The GNU Awk User's
+Guide". Quando sono arrivato alla sezione 13.3.11, ho riformattato e
+brevemente commentato lo script di firma di Davide Brin per comprenderne il
funzionamento.
+
+Mi pare che questo possa avere un valore pedagogico come esempio
+(sia pure imperfetto) del significato di spazi bianchi e commenti, e un
+punto di partenza per una tale discussione. Sicuramente ha aiutato _me_ a
+capire quel che succede. Se vuoi
+usarlo, com'@`e o modificato, sentiti libero di farlo (a condizione di
+rispettare i vincoli posti da Davide, naturalmente, che credo siano stati
+da me rispettati).
+
+Se dovessi includere questa spiegazione in una futura edizione, la inserirei
+a una certa distanza dalla sezione 13.3.11, diciamo come una nota o come
+un'appendice, in modo da non rivelare immediatamente la soluzione dell'enigma.
+
+Cordiali saluti,
+--
+Chris Johansen {johansen at main dot nc dot us}
+ . . . collapsing the probability wave function, sending ripples of
+certainty through the space-time continuum.
+
+
+#! /usr/bin/gawk -f
+
+# Da "13.3.11 E ora per qualcosa di completamente differente"
+#
http://www.gnu.org/software/gawk/manual/html_node/Signature-Program.html#Signature-Program
+
+# Copyright é 2008 Davide Brini
+
+# Copying and distribution of the code published in this page, with
+# or without modification, are permitted in any medium without
+# royalty provided the copyright notice and this notice are preserved.
+
+BEGIN {
+ O = "~" ~ "~"; # 1
+ o = "==" == "=="; # 1
+ o += +o; # 2
+ x = O "" O; # 11
+
+
+ while ( X++ <= x + o + o ) c = c "%c";
+
+ # O vale 1
+ # o vale 2
+ # x vale 11
+ # X vale 17
+ # c vale "%c%c%c%c%c%c%c%c%c%c%c%c%c%c%c%c"
+
+ printf c,
+ ( x - O )*( x - O), # 100 d
+ x*( x - o ) - o, # 97 a
+ x*( x - O ) + x - O - o, # 118 v
+ +x*( x - O ) - x + o, # 101 e
+ X*( o*o + O ) + x - O, # 95 _
+ X*( X - x ) - o*o, # 98 b
+ ( x + X )*o*o + o, # 114 r
+ x*( X - x ) - O - O, # 64 @
+ x - O + ( O + o + X + x )*( o + O ), # 103 g
+ X*X - X*( x - O ) - x + O, # 109 m
+ O + X*( o*( o + O ) + O ), # 120 x
+ +x + O + X*o, # 46 .
+ x*( x - o), # 99 c
+ ( o + X + x )*o*o - ( x - O - O ), # 111 0
+ O + ( X - x )*( X + O ), # 109 m
+ x - O # 10 \n
+}
address@hidden ignore
+
address@hidden Sommario dei programmi
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+I programmi illustrati in questo @value{CHAPTER}
+ripropongo la tesi secondo cui leggere programmi @`e una maniera eccellente
+per imparare a fare della buona programmazione.
+
address@hidden
+Usare @samp{#!} per rendere i programmi @command{awk} direttamente eseguibili
+ne rende address@hidden semplice l'uso. In alternativa, si address@hidden
invocare un
+programma usando @samp{awk -f @dots{}}.
+
address@hidden
+Reimplementare programmi POSIX standard in @command{awk} @`e un esercizio
+piacevole; il potere espressivo di @command{awk} consente di scrivere tali
+programmi usando relativamente poche righe di codice, nonostante i programmi
+risultanti siano funzionalmente completi e utilizzabili.
+
address@hidden
+Una delle debolezze della versione standard di @command{awk} riguarda il
+lavorare con singoli caratteri. La address@hidden di usare @code{split()} con
+la stringa nulla come separatore address@hidden semplificare considerevolmente
tale
+compito.
+
address@hidden
+Gli esempi proposti dimostrano l'address@hidden delle funzioni di libreria
introdotte
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria}
+per un numero (sia pur piccolo) di programmi reali.
+
address@hidden
+Oltre a reinventare la ruota POSIX, altri programmi risolvono una serie di
+problemi interessanti, come trovare delle parole duplicate in un testo,
+stampare etichette per lettere, e trovare anagrammi.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi sui programmi
address@hidden Esercizi
+
address@hidden
address@hidden
+Riscrivere @file{cut.awk} (@pxref{Programma cut})
+usando @code{split()} con @code{""} come separatore.
+
address@hidden
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden egrep}, @`e detto che @samp{egrep -i} potrebbe essere
+simulato in versioni di @command{awk} che non prevedono @code{IGNORECASE}
+usando @code{tolower()} sulla riga e nei criteri di ricerca. In una nota a
address@hidden di pagina @`e anche detto che questa soluzione ha un problema:
in output
+viene scritta la riga tradotta (a lettere minuscole), e non quella originale.
+Risolvere questo problema.
address@hidden Exercise: Fix this, w/array and new line as key to original line
+
address@hidden
+La versione POSIX di @command{id} accetta opzioni che controllano quali
+informazioni stampare. Modificare la versione @command{awk}
+(@pxref{Programma id}) per accettare gli stessi argomenti e funzionare allo
+stesso modo.
+
address@hidden
+Il programma @code{split.awk} (@pxref{Programma split}) presuppone che le
+lettere siano contigue nella codifica dei caratteri,
+il che non @`e vero per sistemi che usano la codifica EBCDIC.
+Risolvere questo problema.
+(Suggerimento: Considerare un modo diverso di analizzare l'alfabeto,
+senza appoggiarsi sulle funzioni @code{ord()} e @code{chr()}.)
+
address@hidden
+Nel programma @file{uniq.awk} (@pxref{Programma uniq}, la
+logica per scegliere quali righe stampare rappresenta una
address@hidden a stati},
+ossia ``un dispositivo che address@hidden essere in uno di un insieme di stati
+stabili, a seconda dello stato in cui si trovava in precedenza, e del
+valore corrente dei suoi
+input.''@footnote{Questo @`e la definizione trovata usando
address@hidden: state machine} come chiave di ricerca in Google.}
+Brian Kernighan suggerisce che
+``un approccio alternativo alle macchine a stati @`e di leggere tutto l'input
+e metterlo in un vettore, e quindi usare gli indici. @`E quasi sempre
address@hidden
+semplice da programmare, e per la maggior parte degli input in cui si
address@hidden
+usare, altrettanto veloce in esecuzione.'' Riscrivere la logica del
+programma seguendo questa indicazione.
+
+
address@hidden
+Perch@'e il programma @file{wc.awk} (@pxref{Programma wc}) non address@hidden
+limitarsi a usare il valore di @code{FNR} nella funziona @code{a_fine_file()}?
+Suggerimento: Esaminare il codice
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden filetrans}.
+
address@hidden
address@hidden can't just use the value of @code{FNR} in
address@hidden()}. If you examine the code in @ref{Filetrans Function},
+you will see that @code{FNR} has already been reset by the time
address@hidden()} is called.
address@hidden ignore
+
address@hidden
+La manipolazione di singoli caratteri nel programma @command{translate}
+(@pxref{Programma translate}) @`e farraginosa usando le funzione standard
address@hidden Poich@'e @command{gawk} address@hidden dividere stringhe in
caratteri
+singoli usando come separatore @code{""}, come si potrebbe usare questa
address@hidden per semplificare il programma?
+
address@hidden
+Il programma @file{extract.awk} (@pxref{Programma extract}) @`e stato
+scritto prima che @command{gawk} avesse a disposizione la funzione
address@hidden()}. Usarla per semplificare il codice.
+
address@hidden
+Si confronti la address@hidden di esecuzione del programma @file{awksed.awk}
+(@pxref{Programma sed semplice}) con il address@hidden diretto:
+
address@hidden
+BEGIN @{
+ stringa = ARGV[1]
+ rimpiazzo = ARGV[2]
+ ARGV[1] = ARGV[2] = ""
address@hidden
+
address@hidden gsub(stringa, rimpiazzo); print @}
address@hidden example
+
address@hidden
+Quali sono vantaggi e svantaggi di @file{awksed.awk} rispetto al vero
+programma di address@hidden @command{sed}?
+
address@hidden
+ Advantage: egrep regexps
+ speed (?)
+ Disadvantage: no & in replacement text
+
+Others?
address@hidden ignore
+
address@hidden
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden igawk}, si @`e detto che non tentando di salvare la riga
+letta con @code{getline} nella funzione @code{percorso()}, mentre si
+controlla l'address@hidden del file da usare nel programma principale,
+semplifica notevolmente le cose. Quale problema @`e peraltro generato
address@hidden@dotless{i}}
+facendo?
address@hidden answer, reading from "-" o /dev/stdin
+
address@hidden percorso di ricerca per file sorgente
address@hidden ricerca, percorso di, per file sorgente
address@hidden file sorgente, percorso di ricerca per
address@hidden directory, ricerca
address@hidden
+Come ulteriore esempio dell'idea che non sempre @`e necessario aggiungere
+nuove address@hidden a un programma, si consideri l'idea di avere due file in
+una directory presente nel percorso di ricerca:
+
address@hidden @file
address@hidden default.awk
+Questo file contiene un insieme di funzioni di libreria di default, come
address@hidden()} e @code{assert()}.
+
address@hidden sito.awk
+Questo file contiene funzioni di libreria che sono specifiche di
+un sito o di un'installazione; address@hidden, funzioni sviluppate localmente.
+Mantenere due file separati consente a @file{default.awk} di essere
+modificato in seguito a nuove versioni di @command{gawk}, senza che
+l'amministratore di sistema debba ogni volta aggiornarlo aggiungendo le
+funzioni locali.
address@hidden table
+
+Un utente
address@hidden Karl Berry, address@hidden, 10/95
+ha suggerito che @command{gawk} venga modificato per leggere automaticamente
+questi file alla partenza. Piuttosto, sarebbe molto semplice
+modificare @command{igawk} per farlo. Poich@'e @command{igawk} @`e capace di
+elaborare direttive @code{@@include}
+nidificate, @file{default.awk} potrebbe contenere semplicemente la lista di
+direttive @code{@@include} con le funzioni di libreria desiderate.
+Fare questa modifica.
+
address@hidden
+Modificare @file{anagram.awk} (@pxref{Programma anagram}), per evitare di
+usare il programma di address@hidden esterno @command{sort}.
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden
address@hidden @value{PART3}Andare oltre @command{awk} con @command{gawk}
address@hidden ifnotinfo
+
address@hidden
+La Parte III riguarda address@hidden proprie di @command{gawk}.
+Contiene i seguenti capitoli:
+
address@hidden @value{BULLET}
address@hidden
address@hidden@`a avanzate}
+
address@hidden
address@hidden
+
address@hidden
address@hidden
+
address@hidden
address@hidden con precisione arbitraria}
+
address@hidden
address@hidden dinamiche}
address@hidden itemize
address@hidden ifdocbook
+
address@hidden address@hidden avanzate
address@hidden address@hidden avanzate di @command{gawk}
address@hidden @command{gawk}, address@hidden avanzate
address@hidden avanzate, address@hidden, di @command{gawk}
address@hidden
+Contributed by: Peter Langston <address@hidden>
+
+ Found in Steve English's "signature" line:
+
+"Write documentation as if whoever reads it is a violent psychopath
+who knows where you live."
address@hidden ignore
address@hidden Langston, Peter
address@hidden English, Steve
address@hidden
address@hidden la documentazione supponendo che chiunque la address@hidden sia
uno psicopatico
+violento, che conosce il vostro indirizzo di casa.}
address@hidden Steve English, citato da Peter Langston
address@hidden quotation
+
+Questo @value{CHAPTER} tratta delle address@hidden avanzate in @command{gawk}.
address@hidden un po' come un ``pacco sorpresa'' di argomenti che non sono
collegati tra di
+loro in altro modo.
+Per prima cosa, vediamo un'opzione da riga di comando che consente a
address@hidden di riconoscere i numeri non-decimali nei dati in input, e non
+soltanto nei programmi @command{awk}.
+Poi vengono illustrate delle address@hidden speciali di @command{gawk} per
+l'ordinamento di vettori. Quindi viene trattato dettagliatamente l'I/O
+bidirezionale, di cui si @`e fatto cenno in precedenti parti di questo
address@hidden, assieme ai fondamenti sulle reti TCP/IP.
+Infine, vediamo come @command{gawk}
address@hidden tracciare il @dfn{profilo} di un programma @command{awk},
address@hidden@dotless{i}} che si
+possa ritoccarlo per migliorarne le prestazioni.
+
address@hidden FULLXREF ON
+Altre address@hidden avanzate vengono trattate separatamente dedicando un
address@hidden per ciascuna di esse:
+
address@hidden @value{BULLET}
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden, parla di come internazionalizzare
+i propri programmi @command{awk}, in modo che parlino address@hidden lingue
+nazionali.
+
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden, descrive il debugger dalla riga di comando disponibile
+all'interno di
address@hidden per individuare errori nei programmi @command{awk}.
+
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden con precisione arbitraria}, illustra come si address@hidden usare
address@hidden per eseguire calcoli con precisione arbitraria.
+
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden dinamiche},
+tratta della address@hidden di aggiungere dinamicamente nuove funzioni
predefinite a
address@hidden
address@hidden itemize
address@hidden FULLXREF OFF
+
address@hidden
+* Dati non decimali:: Consentire dati di input non decimali.
+* Ordinamento di vettori:: Modi per controllare la visita di un vettore
+ e il suo ordinamento.
+* I/O bidirezionale:: Comunicazione bidirezionale con un altro
+ processo.
+* Reti TCP/IP:: Usare @command{gawk} per programmazione di
rete.
+* Profilare:: Profilare i propri programmi @command{awk}.
+* Sommario address@hidden avanzate:: Sommario delle address@hidden avanzate.
address@hidden menu
+
address@hidden Dati non decimali
address@hidden Consentire dati di input non decimali
address@hidden opzione @option{--non-decimal-data}
address@hidden @cindex address@hidden avanzate, dati di input non decimali
address@hidden input, dati non decimali
address@hidden costanti, non decimali
+
+Se si esegue @command{gawk} con l'opzione @option{--non-decimal-data},
+si possono avere valori in base diversa da dieci nei dati di input:
+
address@hidden
+$ @kbd{echo 0123 123 0x123 |}
+> @kbd{gawk --non-decimal-data '@{ printf "%d, %d, %d\n", $1, $2, $3 @}'}
address@hidden 83, 123, 291
address@hidden example
+
+Affinch@'e questa address@hidden sia disponibile, i programmi devono essere
+scritti in modo che @command{gawk} tratti i dati come valori numerici:
+
address@hidden
+$ @kbd{echo 0123 123 0x123 | gawk '@{ print $1, $2, $3 @}'}
address@hidden 0123 123 0x123
address@hidden example
+
address@hidden
+L'istruzione @code{print} tratta le sue espressioni come se fossero stringhe.
+Sebbene i campi possano comportarsi come numeri, quando necessario,
+essi rimangono sempre stringhe, per cui @code{print} non cerca di elaborarli
+come se fossero numeri. Si deve aggiungere zero a un campo affich@'e venga
+considerato come un numero. Per esempio:
+
address@hidden
+$ @kbd{echo 0123 123 0x123 | gawk --non-decimal-data '}
+> @address@hidden print $1, $2, $3}
+> @kbd{print $1 + 0, $2 + 0, $3 + 0 @}'}
address@hidden 0123 123 0x123
address@hidden 83 123 291
address@hidden example
+
+Poich@'e capita comunemente di avere dati di tipo decimale con degli zeri
iniziali,
+e poich@'e l'uso di questa address@hidden address@hidden portare a risultati
inattesi, il
+comportamento di default @`e quello lasciarla disabilitata. Se si vuole, la si
+deve richiedere esplicitamente.
+
address@hidden programmazione, convenzioni di, opzione @code{--non-decimal-data}
address@hidden @option{--non-decimal-data}, opzione, funzione @code{strtonum()}
e
address@hidden @code{strtonum()}, funzione (@command{gawk}), opzione
@code{--non-decimal-data} e
address@hidden ATTENZIONE
address@hidden'uso di questa opzione non @`e consigliata.}
address@hidden provocare errori molto seri eseguendo vecchi programmi.
+Al suo posto @`e meglio usare la funzione @code{strtonum()} per convertire i
dati
+(@pxref{Funzioni per stringhe}).
+Questo rende i programmi address@hidden facili da scrivere e address@hidden
facili da leggere, e
+porta a risultati meno inattesi.
+
+Quest'opzione potrebbe sparire dalle versioni future di @command{gawk}.
address@hidden quotation
+
address@hidden Ordinamento di vettori
address@hidden Controllare la visita di un vettore e il suo ordinamento
+
address@hidden permette di controllare l'ordine con cui un ciclo
address@hidden (@var{indice} in @var{vettore})}
+attraversa un vettore.
+
+Inoltre, due funzioni predefinite, @code{asort()} e @code{asorti()},
+permettono di mettere in ordine i vettori sulla base, rispettivamente, dei
+valori e degli indici del vettore. Queste due funzioni danno anche il
+controllo sui criteri in base ai quali riordinare gli elementi del vettore.
+
address@hidden
+* Controllare visita vettori:: Come usare PROCINFO["sorted_in"].
+* Funzioni di ordinamento di vettori:: Come usare @code{asort()} e
@code{asorti()}.
address@hidden menu
+
address@hidden Controllare visita vettori
address@hidden Controllare visita vettori
+
+Per default, l'ordine secondo il quale un ciclo @samp{for (@var{indice} in
address@hidden)} scorre un vettore non @`e definito; in genere si basa
+sull'implementazione interna dei vettori all'interno di @command{awk}.
+
+Spesso, tuttavia, si vorrebbe poter eseguire un ciclo sugli elementi in un
+determinato ordine scelto dall'utente programmatore. Con @command{gawk}
+si address@hidden fare.
+
address@hidden
+La
address@hidden iftex
address@hidden visita} parla di come si possono assegnare valori speciali
+predefiniti a @code{PROCINFO["sorted_in"]} per controllare l'ordine secondo il
+quale @command{gawk} attraversa un vettore
+durante un ciclo @code{for}.
+
+Inoltre, il valore di @code{PROCINFO["sorted_in"]} address@hidden essere un
nome di
address@hidden @`e il motivo per cui gli ordinamenti predefiniti
+iniziano con il carattere @samp{@@}, che non address@hidden essere usato in un
+identificatore.}
+Questo consente di scorrere un vettore sulla base di un qualsiasi criterio
+personalizzato. Gli elementi del vettore vengono ordinati in accordo col valore
+ritornato da questa funzione. La funzione che fa il confronto dovrebbe essere
+definita con almeno quattro argomenti:
+
address@hidden
+function confronta(i1, v1, i2, v2)
address@hidden
+ @var{confronta gli elementi 1 e 2 in qualche modo}
+ @var{return < 0; 0; o > 0}
address@hidden
address@hidden example
+
+Qui, @code{i1} e @code{i2} sono gli indici, e @code{v1} e @code{v2}
+sono i corrispondenti valori dei due elementi che si stanno confrontando.
address@hidden oppure @code{v2}, o entrambi, possono essere vettori se il
vettore
+che si sta visitando contiene sottovettori come valori.
+(@xref{Vettori di vettori} per maggiori informazioni sui sottovettori.)
+I tre possibili valori di ritorno sono interpretati nel seguente modo:
+
address@hidden @code
address@hidden confronta(i1, v1, i2, v2) < 0
+L'indice @code{i1} viene prima dell'indice @code{i2} durante l'avanzamento
+del ciclo.
+
address@hidden confronta(i1, v1, i2, v2) == 0
+Gli indici @code{i1} e @code{i2}
+sono equivalenti, ma l'ordine tra loro non @`e definito.
+
address@hidden confronta(i1, v1, i2, v2) > 0
+L'indice @code{i1} viene dopo l'indice @code{i2} durante l'avanzamento del
+ciclo.
address@hidden table
+
+La prima funzione di confronto address@hidden essere usata per scorrere un
vettore
+secondo l'ordine numerico degli indici:
+
address@hidden
+function cfr_ind_num(i1, v1, i2, v2)
address@hidden
+ # confronto di indici numerici, ordine crescente
+ return (i1 - i2)
address@hidden
address@hidden example
+
+La seconda funzione scorre un vettore secondo l'ordine delle stringhe
+dei valori degli elementi piuttosto che secondo gli indici:
+
address@hidden
+function cfr_val_str(i1, v1, i2, v2)
address@hidden
+ # confronto di valori di stringa, ordine crescente
+ v1 = v1 ""
+ v2 = v2 ""
+ if (v1 < v2)
+ return -1
+ return (v1 != v2)
address@hidden
address@hidden example
+
+La terza funzione di confronto restituisce dapprima tutti i numeri, e dopo
+questi le stringhe numeriche senza spazi iniziali o finali, durante
+l'avanzamento del ciclo:
+
address@hidden
+function cfr_val_num_str(i1, v1, i2, v2, n1, n2)
address@hidden
+ # confronto mettendo i numeri prima dei valori di stringa,
+ # ordine crescente
+ n1 = v1 + 0
+ n2 = v2 + 0
+ if (n1 == v1)
+ return (n2 == v2) ? (n1 - n2) : -1
+ else if (n2 == v2)
+ return 1
+ return (v1 < v2) ? -1 : (v1 != v2)
address@hidden
address@hidden example
+
+Qui vediamo un programma principale che mostra come @command{gawk}
+si comporta usando ciascuna delle funzioni precedenti:
+
address@hidden
+BEGIN @{
+ data["uno"] = 10
+ data["due"] = 20
+ data[10] = "uno"
+ data[100] = 100
+ data[20] = "due"
+
+ f[1] = "cfr_ind_num"
+ f[2] = "cfr_val_str"
+ f[3] = "cfr_val_num_str"
+ for (i = 1; i <= 3; i++) @{
+ printf("Funzione di ordinamento: %s\n", f[i])
+ PROCINFO["sorted_in"] = f[i]
+ for (j in data)
+ printf("\tdata[%s] = %s\n", j, data[j])
+ print ""
+ @}
address@hidden
address@hidden example
+
+I risultati dell'esecuzione del programma sono questi:
+
address@hidden
+$ @kbd{gawk -f compdemo.awk}
address@hidden Funzione di ordinamento: cfr_ind_num @ii{Ordinamento per indice
numerico}
address@hidden data[uno] = 10
address@hidden data[due] = 20 @ii{Entrambe le stringhe sono
numericamente zero}
address@hidden data[10] = uno
address@hidden data[20] = due
address@hidden data[100] = 100
address@hidden
address@hidden Funzione di ordinamento: cfr_val_str @ii{Ordinamento per valore
degli}
address@hidden @ii{elementi come
stringhe}
address@hidden data[uno] = 10
address@hidden data[100] = 100 @ii{La stringa 100 @`e minore della
stringa 20}
address@hidden data[due] = 20
address@hidden data[20] = due
address@hidden data[10] = uno
address@hidden
address@hidden Funzione di ordinamento: cfr_val_num_str @ii{Ordinamento con
tutti i}
address@hidden @ii{valori numerici prima di tutte le
stringhe}
address@hidden data[uno] = 10
address@hidden data[due] = 20
address@hidden data[100] = 100
address@hidden data[20] = due
address@hidden data[10] = uno
address@hidden example
+
+Si provi a ordinare gli elementi di un file delle password del sistema
GNU/Linux
+in base al nome d'accesso dell'utente. Il seguente programma ordina i record
+secondo una specifica posizione del campo e address@hidden essere usato per
questo scopo:
+
address@hidden
+# passwd-sort.awk --- semplice programma per ordinare in base alla
+# posizione del campo
+# la posizione del campo @`e specificata dalla variabile globale POS
+
+function per_campo(i1, v1, i2, v2)
address@hidden
+ # confronto per valore, come stringa, e in ordine crescente
+ return v1[POS] < v2[POS] ? -1 : (v1[POS] != v2[POS])
address@hidden
+
address@hidden
+ for (i = 1; i <= NF; i++)
+ a[NR][i] = $i
address@hidden
+
+END @{
+ PROCINFO["sorted_in"] = "per_campo"
+ if (POS < 1 || POS > NF)
+ POS = 1
+ for (i in a) @{
+ for (j = 1; j <= NF; j++)
+ printf("%s%c", a[i][j], j < NF ? ":" : "")
+ print ""
+ @}
address@hidden
address@hidden example
+
+Il primo campo di ogni elemento del file delle password @`e il nome d'accesso
+dell'utente, e i campi sono separati tra loro da due punti.
+Ogni record definisce un sottovettore,
+con ogni campo come elemento nel sottovettore.
+L'esecuzione del programma produce
+il seguente output:
+
address@hidden
+$ @kbd{gawk -v POS=1 -F: -f sort.awk /etc/passwd}
address@hidden adm:x:3:4:adm:/var/adm:/sbin/nologin
address@hidden apache:x:48:48:Apache:/var/www:/sbin/nologin
address@hidden avahi:x:70:70:Avahi daemon:/:/sbin/nologin
address@hidden
address@hidden example
+
+Il confronto normalmente dovrebbe restituire sempre lo stesso valore quando
+vien dato come argomento un preciso paio di elementi del vettore. Se viene
+restituito un risultato non coerente, l'ordine @`e indefinito. Questo
+comportamento address@hidden essere sfruttato per introdurre un ordinamento
casuale in
+dati apparentemente ordinati:
+
address@hidden
+function ordina_a_caso(i1, v1, i2, v2)
address@hidden
+ # ordine casuale (attenzione: potrebbe non finire mai!)
+ return (2 - 4 * rand())
address@hidden
address@hidden example
+
+Come address@hidden accennato, l'ordine degli indici @`e arbitrario se due
elementi
+risultano uguali. Normalmente questo non @`e un problema, ma lasciare che
+elementi di uguale valore compaiano in ordine arbitrario address@hidden essere
un
+problema, specialmente quando si confrontano valori di elementi di un elenco.
+L'ordine parziale di elementi uguali address@hidden cambiare quando il vettore
viene
+visitato di nuovo, se nel vettore vengono aggiunti o rimossi elementi. Un modo
+per superare l'ostacolo quando si confrontano elementi con valori uguali @`e
+quello di includere gli indici nelle regole di confronto. Si noti che questo
+potrebbe rendere meno efficiente l'attraversamento del ciclo, per cui si
+consiglia di farlo solo se necessario. Le seguenti funzioni di confronto
+impongono un ordine deterministico, e si basano sul fatto che gli indici
+(di stringa) di due elementi non sono mai uguali:
address@hidden
+function per_numero(i1, v1, i2, v2)
address@hidden
+ # confronto di valori numerici (e indici), ordine decrescente
+ return (v1 != v2) ? (v2 - v1) : (i2 - i1)
address@hidden
+
+function per_stringa(i1, v1, i2, v2)
address@hidden
+ # confronto di valori di stringa (e indici), ordine decrescente
+ v1 = v1 i1
+ v2 = v2 i2
+ return (v1 > v2) ? -1 : (v1 != v2)
address@hidden
address@hidden example
+
address@hidden Avoid using the term ``stable'' when describing the
unpredictable behavior
address@hidden if two items compare equal. Usually, the goal of a "stable
algorithm"
address@hidden is to maintain the original order of the items, which is a
meaningless
address@hidden concept for a list constructed from a hash.
+
+Una funzione di confronto personalizzata spesso address@hidden semplificare
+l'attraversamento del
+ciclo ordinato, e il solo limite @`e il cielo, quando si va a progettare
+una funzione di questo tipo.
+
+Quando i confronti tra stringhe son fatti durante un'operazione di ordinamento,
+per valori di elementi che, uno o entrambi, non sono numeri, o per
+indici di elementi gestiti come stringhe, il valore di @code{IGNORECASE}
+(@pxref{Variabili predefinite}) controlla se
+i confronti trattano corrispondenti lettere maiuscole e minuscole
+come equivalenti o come distinte.
+
+Un'altra cosa da tenere a mente @`e che nel caso di sottovettori, i valori
degli
+elementi possono essere a loro volta dei vettori; una funzione di confronto in
+produzione dovrebbe usare la funzione @code{isarray()}
+(@pxref{Funzioni per i tipi})
+per controllare address@hidden, e scegliere un ordinamento preciso per i
sottovettori.
+
+Tutti gli ordinamenti basati su @code{PROCINFO["sorted_in"]}
+sono disabilitati in address@hidden POSIX,
+perch@'e il vettore @code{PROCINFO} in questo caso non @`e speciale.
+
+Come nota a margine, si @`e visto che ordinare gli indici del vettore prima di
+scorrere il vettore porta a un incremento variabile dal 15% al 20% del tempo di
+esecuzione dei programmi @command{awk}. Per questo motivo l'attraversamento
+ordinato di vettori non @`e il default.
+
address@hidden The @command{gawk}
address@hidden maintainers believe that only the people who wish to use a
address@hidden feature should have to pay for it.
+
address@hidden Funzioni di ordinamento di vettori
address@hidden Ordinare valori e indici di un vettore con @command{gawk}
+
address@hidden vettori, ordinamento dei
address@hidden
address@hidden @code{asort()}, funzione (@command{gawk}), ordinamento di vettori
address@hidden funzione @code{asort()} (@command{gawk}), ordinamento di vettori
address@hidden
address@hidden @code{asorti()}, funzione (@command{gawk}), ordinamento di
vettori
address@hidden funzione @code{asorti()} (@command{gawk}), ordinamento di vettori
address@hidden @code{sort()}, funzione, ordinamento di vettori
address@hidden funzione @code{sort()}, ordinamento di vettori
+Nella maggior parte delle implementazioni di @command{awk}, ordinare un vettore
+richiede una funzione @code{sort()}. Questo address@hidden essere istruttivo
per provare
+diversi algoritmi di ordinamento, ma normalmente non @`e questo lo scopo del
+programma. In @command{gawk} ci sono le funzioni predefinite @code{asort()} e
address@hidden()} (@pxref{Funzioni per stringhe}) per i vettori ordinati.
+Per esempio:
+
address@hidden
address@hidden il vettore} dati
+n = asort(dati)
+for (i = 1; i <= n; i++)
+ @var{fare qualcosa con} dati[i]
address@hidden example
+
+Dopo la chiamata ad @code{asort()}, il vettore @code{dati} @`e indicizzato da 1
+a @var{n}, il numero totale di elementi in @code{dati}.
+(Questo conteggio @`e il valore di ritorno di @code{asort()}).
address@hidden @value{LEQ} @code{dati[2]} @value{LEQ} @code{dati[3]}, e
address@hidden@dotless{i}}
+via. Il confronto di default @`e basato sul tipo di elementi
+(@pxref{Tipi di variabile e confronti}).
+Tutti i valori numerici vengono prima dei valori di stringa,
+che a loro volta vengono prima di tutti i sottovettori.
+
address@hidden effetti collaterali, funzione @code{asort()}
address@hidden funzione @code{asort()}, effetti collaterali
+Un effetto collaterale rilevante nel chiamare @code{asort()} @`e che
address@hidden indici originali del vettore vengono persi irreparabilmente}.
+Poich@'e questo non sempre @`e opportuno, @code{asort()} accetta un
+secondo argomento:
+
address@hidden
address@hidden the array} orig
+n = asort(orig, dest)
+for (i = 1; i <= n; i++)
+ @var{fai qualcosaa con} dest[i]
address@hidden example
+
+In questo caso, @command{gawk} copia il vettore @code{orig} nel vettore
address@hidden e ordina @code{dest}, distruggendo i suoi indici.
+Tuttavia il vettore @code{orig} non viene modificato.
+
+Spesso, address@hidden di cui si ha bisogno @`e di ordinare per i valori degli
address@hidden invece che per i valori degli elementi. Per far questo si usa la
+funzione @code{asorti()}. L'interfaccia e il comportamento sono identici a
+quelli di @code{asort()}, solo che per l'ordinamento vengono usati i valori
+degli indici, che diventano i valori del vettore risultato:
+
address@hidden
address@hidden orig[$0] = una_funz($0) @}
+
+END @{
+ n = asorti(orig, dest)
+ for (i = 1; i <= n; i++) @{
+ @ii{Lavora direttamente con gli indici ordinati:}
+ @var{fa qualcosa con} dest[i]
+ @dots{}
+ @ii{Accede al vettore originale attraverso gli indici ordinati:}
+ @var{fa qualcosa con} orig[dest[i]]
+ @}
address@hidden
address@hidden example
+
+Fin qui, tutto bene. Ora inizia la parte interessante. Sia @code{asort()}
+che @code{asorti()} accettano un terzo argomento di stringa per controllare il
+confronto di elementi del vettore. Quando abbiamo introdotto @code{asort()} e
address@hidden()} nella @ref{Funzioni per stringhe}, abbiamo ignorato questo
terzo
+argomento; comunque, @`e giunto il momento di descrivere come questo argomento
+influenza queste due funzioni.
+
+Fondamentalmente, il terzo argomento specifica come dev'essere ordinato il
+vettore. Ci sono due address@hidden Come per @code{PROCINFO["sorted_in"]},
+quest'argomento address@hidden essere uno degli argomenti predefiniti che
@command{gawk}
+fornisce (@pxref{Controllare visita}), o address@hidden essere il nome di una
funzione
+definita dall'utente (@pxref{Controllare visita vettori}).
+
+Nell'ultimo caso, @emph{la funzione address@hidden confrontare gli elementi in
qualunque
+modo si voglia}, prendendo in considerazione solo gli indici, solo i valori,
+o entrambi. Questo @`e estremamente potente.
+
+Una volta che il vettore @`e ordinato, @code{asort()} prende i @emph{valori}
nel
+loro ordine finale e li usa per riempire il vettore risultato, mentre
address@hidden()} prende gli @emph{indici} nel loro ordine finale e li usa per
+riempire il vettore risultato.
+
address@hidden conteggio riferimenti, ordinamento vettori
address@hidden NOTA
+Copiare indici ed elementi non @`e dispendioso in termini di memoria.
+Internamente, @command{gawk} mantiene un @dfn{conteggio dei riferimenti} ai
+dati. Per esempio, dopo che @code{asort()} copia il primo vettore nel
+secondo, in memoria c'@`e ancora una sola copia dei dati degli elementi
+del vettore originale, ed entrambi i vettori accedono all'unica copia di
+valori che esiste in memoria.
address@hidden quotation
+
address@hidden Document It And Call It A Feature. Sigh.
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden vettori, ordinamento, variabile @code{IGNORECASE} e
address@hidden @code{IGNORECASE}, variabile, e funzioni di ordinamento dei
vettori
address@hidden variabile @code{IGNORECASE}, e funzioni di ordinamento dei
vettori
+Poich@'e @code{IGNORECASE} influenza i confronti tra stringhe, il valore di
address@hidden influisce anche sull'ordinamento sia con @code{asort()} che
+con @code{asorti()}.
+Si noti inoltre che l'ordinamento della localizzazione @emph{non} entra in
+gioco; i confronti sono basati solamente sul valore dei
address@hidden@`o @`e vero perch@'e il confronto basato sulla localizzazione
+avviene solo quando si @`e in address@hidden POSIX-compatibile, e poich@'e
@code{asort()}
+e @code{asorti()} sono estensioni di @command{gawk}, esse non sono disponibili
+in quel caso.}
+
+L'esempio seguente mostra l'uso di una funzione di confronto usata con
address@hidden()}. La funzione di confronto, @code{confronta_in_minuscolo()},
+trasforma gli elementi da confrontare in lettere minuscole, in modo da avere
+confronti che non dipendono da maiuscolo/minuscolo.
+
address@hidden
+# confronta_in_minuscolo --- confronta stringhe ignorando maiuscolo/minuscolo
+
+function confronta_in_minuscolo(i1, v1, i2, v2, l, r)
address@hidden
+ l = tolower(v1)
+ r = tolower(v2)
+
+ if (l < r)
+ return -1
+ else if (l == r)
+ return 0
+ else
+ return 1
address@hidden
address@hidden example
+
+E questo programma address@hidden essere usato per provarla:
+
address@hidden
+# programma di test
+
+BEGIN @{
+ Letters = "abcdefghijklmnopqrstuvwxyz" \
+ "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+ split(Letters, data, "")
+
+ asort(data, risultato, "confronta_in_minuscolo")
+
+ j = length(risultato) # numero elementi del vettore "risultato"
+ for (i = 1; i <= j; i++) @{
+ printf("%s", risultato[i])
+ if (i % (j/2) == 0)
+ # a address@hidden, la stampa del vettore va a capo
+ printf("\n")
+ else
+ printf(" ")
+ @}
address@hidden
address@hidden example
+
+Se si esegue il programma, si ottiene:
+
address@hidden
+$ @kbd{gawk -f confronta_in_minuscolo.awk}
address@hidden A a B b c C D d e E F f g G H h i I J j k K l L M m
address@hidden n N O o p P Q q r R S s t T u U V v w W X x y Y z Z
address@hidden example
+
address@hidden I/O bidirezionale
address@hidden Comunicazioni bidirezionali con un altro processo
+
address@hidden 8/2014. Neither Mike nor BWK saw this as relevant. Commenting it
out.
address@hidden
address@hidden Brennan, Michael
address@hidden programmers, attractiveness of
address@hidden
address@hidden Path:
cssun.mathcs.emory.edu!gatech!newsxfer3.itd.umich.edu!news-peer.sprintlink.net!news-sea-19.sprintlink.net!news-in-west.sprintlink.net!news.sprintlink.net!Sprint!204.94.52.5!news.whidbey.com!brennan
+From: brennan@@whidbey.com (Mike Brennan)
+Newsgroups: comp.lang.awk
+Subject: Re: Learn the SECRET to Attract Women Easily
+Date: 4 Aug 1997 17:34:46 GMT
address@hidden Organization: WhidbeyNet
address@hidden Lines: 12
+Message-ID: <5s53rm$eca@@news.whidbey.com>
address@hidden References: <address@hidden>
address@hidden Reply-To: address@hidden
address@hidden NNTP-Posting-Host: asn202.whidbey.com
address@hidden X-Newsreader: slrn (0.9.4.1 UNIX)
address@hidden Xref: cssun.mathcs.emory.edu comp.lang.awk:5403
+
+On 3 Aug 1997 13:17:43 GMT, Want More Dates???
+<tracy78@@kilgrona.com> wrote:
+>Learn the SECRET to Attract Women Easily
+>
+>The SCENT(tm) Pheromone Sex Attractant For Men to Attract Women
+
+The scent of awk programmers is a lot more attractive to women than
+the scent of perl programmers.
+--
+Mike Brennan
address@hidden brennan@@whidbey.com
address@hidden smallexample
address@hidden ignore
+
address@hidden address@hidden avanzate, address@hidden comunicare con
address@hidden processi, comunicazioni bidirezionali con
+Spesso @`e utile poter
+inviare dati a un programma separato che
+li elabori e in seguito leggere il risultato. Questo address@hidden essere
sempre
+fatto con file temporanei:
+
address@hidden
+# Scrivere i dati per l'elaborazione
+filetemp = ("mieidati." PROCINFO["pid"])
+while (@var{non dipendente dai dati})
+ print @var{dati} | ("sottoprogramma > " filetemp)
+close("sottoprogramma > " filetemp)
+
+# Legge il risultato, rimuove filetemp quando ha finito
+while ((getline nuovidati < filetemp) > 0)
+ @var{elabora} nuovidati @var{secondo le esigenze}
+close(filetemp)
+system("rm " filetemp)
address@hidden example
+
address@hidden
+Questo funziona, ma non @`e elegante. Tra le altre cose, richiede che il
+programma venga eseguito in una directory che non address@hidden essere
condivisa tra gli
+utenti; per esempio, @file{/tmp} non address@hidden esserlo, poich@'e potrebbe
accadere che
+un altro utente stia usando un file temporaneo con lo stesso
address@hidden Brennan suggerisce l'uso di @command{rand()} per
+generare @value{FNS} unici. Questo @`e un punto valido; tuttavia, i file
+temporanei rimangono address@hidden difficili da usare delle @dfn{pipe}
bidirezionali.} @c 8/2014
+
address@hidden coprocessi
address@hidden input/output bidirezionale
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|&} (I/O)
address@hidden @command{csh}, comando, operatore @code{|&}, confronto con
address@hidden comando @command{csh}, operatore @code{|&}, confronto con
+Comunque, con @command{gawk}, @`e possibile aprire una @dfn{pipe}
address@hidden
+verso un altro processo. Il secondo processo @`e chiamato @dfn{coprocesso},
+poich@'e viene eseguito in parallelo con @command{gawk}. La connessione
+bidirezionale viene creata usando l'operatore @samp{|&} (preso in prestito
+dalla shell Korn, @command{ksh}):@footnote{Questo @`e molto diverso dallo
stesso
+operatore nella C shell e in Bash.}
+
address@hidden
+do @{
+ print @var{dati} |& "sottoprogramma"
+ "sottoprogramma" |& getline risultato
address@hidden while (@var{ci sono ancora dati da elaborare})
+close("sottoprogramma")
address@hidden example
+
+La prima volta che viene eseguita un'operazione I/O usando l'operatore
address@hidden|&},
address@hidden crea una @dfn{pipeline} bidirezionale verso un processo figlio
+che esegue l'altro programma. L'output creato con @code{print} o con
address@hidden viene scritto nello standard input del programma, e il contenuto
+dello standard output del programma address@hidden essere letto dal programma
address@hidden usando @code{getline}.
+Come accade coi processi avviati con @samp{|}, il sottoprogramma address@hidden
+essere un qualsiasi programma, o una @dfn{pipeline} di programmi, che
address@hidden essere
+avviato dalla shell.
+
+Ci sono alcune avvertenze da tenere presenti:
+
address@hidden @value{BULLET}
address@hidden
+Per come funziona internamente @command{gawk}, lo standard error
+dei coprocessi va nello stesso posto dove va lo standard error del
+genitore @command{gawk}. Non @`e possibile leggere lo standard error del
+figlio separatamente.
+
address@hidden stalli
address@hidden abbracci mortali
address@hidden @dfn{deadlocks}, vedi stalli
address@hidden bufferizzazione, dell'input/output
address@hidden input/output, bufferizzazione
address@hidden @code{getline}, comando, stalli e
address@hidden
+La permanenza in memoria (bufferizzazione) dell'I/O del sottoprocesso potrebbe
+essere un problema. @command{gawk} automaticamente scrive su disco tutto
+l'output spedito tramite la @dfn{pipe} al coprocesso.
+Tuttavia, se il coprocesso non scrive su disco il suo output,
address@hidden potrebbe bloccarsi mentre esegue una @code{getline} per leggere
+il risultato del coprocesso. Questo address@hidden portare a una situazione
+conosciuta come @dfn{stallo} (@dfn{deadlock}, abbraccio mortale), in cui
ciascun
+processo rimane in attesa
+che l'altro processo faccia qualcosa.
address@hidden itemize
+
address@hidden @code{close()}, funzione, @dfn{pipe} bidirezionali e
address@hidden funzione @code{close()}, @dfn{pipe} bidirezionali e
address@hidden possibile chiudere una @dfn{pipe} bidirezionale con un
coprocesso solo in una
+direzione, fornendo un secondo argomento, @code{"to"} o @code{"from"}, alla
+funzione @code{close()} (@pxref{Chiusura file e @dfn{pipe}}).
+Queste stringhe dicono a @command{gawk} di chiudere la @dfn{pipe},
rispettivamente
+nella direzione che invia i dati al coprocesso e nella direzione che legge da
+esso.
+
address@hidden @command{sort}, programma di address@hidden, coprocessi e
address@hidden programma di address@hidden @command{sort}, coprocessi e
+Questo @`e particolarmente necessario per usare il programma di address@hidden
+di sistema @command{sort} come parte di un coprocesso;
address@hidden deve leggere @emph{tutti} i dati di input
+prima di poter produrre un qualsiasi output.
+Il programma @command{sort} non riceve un'indicazione di fine-file
+(end-of-file) finch@'e @command{gawk} non chiude l'address@hidden in scrittura
della
address@hidden
+
+Una volta terminata la scrittura dei dati sul programma @command{sort},
+si address@hidden chiudere il lato @code{"to"} della @dfn{pipe}, e quindi
iniziare a leggere
+i dati ordinati via @code{getline}.
+Per esempio:
+
address@hidden
+BEGIN @{
+ comando = "LC_ALL=C sort"
+ n = split("abcdefghijklmnopqrstuvwxyz", a, "")
+
+ for (i = n; i > 0; i--)
+ print a[i] |& comando
+ close(comando, "to")
+
+ while ((comando |& getline line) > 0)
+ print "ricevuto", line
+ close(comando)
address@hidden
address@hidden example
+
+Questo programma scrive le lettere dell'alfabeto in ordine inverso, uno per
+riga, attraverso la @dfn{pipe} bidirezionale verso @command{sort}. Poi chiude
la
+direzione di scrittura della @dfn{pipe}, in modo che @command{sort} riceva
+un'indicazione di fine-file. Questo fa in modo che @command{sort} ordini i
+dati e scriva i dati ordinati nel programma @command{gawk}. Una volta che
+tutti i dati sono stati letti, @command{gawk} termina il coprocesso ed esce.
+
+Come nota a margine, l'assegnamento @samp{LC_ALL=C} nel comando @command{sort}
+assicura che @command{sort} usi l'ordinamento tradizionale di Unix (ASCII).
address@hidden non @`e strettamente necessario in questo caso, ma @`e bene
sapere come farlo.
+
+Occorre prestare attenzione quando si chiude il lato @code{"from"} di una
address@hidden bidirezionale; in tal caso @command{gawk} attende che il
+processo-figlio termini, il che address@hidden causare lo stallo del programma
address@hidden in esecuzione. (Per questo motivo, questa particolare
address@hidden @`e molto meno usata, in pratica, di quella che consente la
address@hidden di chiudere il lato @code{"to"} della @dfn{pipe}.)
+
address@hidden ATTENZIONE
+Normalmente,
address@hidden un errore fatale (che fa terminare il programma @command{awk})
+scrivere verso il lato @code{"to"} di una @dfn{pipe} bidirezionale che
address@hidden stata chiusa, e lo stesso vale se si legge dal lato @code{"from"}
+di una @dfn{pipe} bidirezionale che sia stata chiusa.
+
address@hidden possibile impostare @code{PROCINFO["@var{comando}", "NONFATAL"]}
+per far address@hidden@dotless{i}} che tali operazioni non provochino la fine
del programma
address@hidden Se lo si fa, @`e necessario controllare il valore
+di @code{ERRNO} dopo ogni istruzione @code{print}, @code{printf},
+o @code{getline}.
address@hidden dopo errori} per ulteriori informazioni.
address@hidden quotation
+
address@hidden @command{gawk}, vettore @code{PROCINFO} in
address@hidden @code{PROCINFO}, vettore, e comunicazioni attraverso le @dfn{pty}
+Per le comunicazioni bidirezionali si possono anche usare delle pseudo
@dfn{tty}
+(@dfn{pty}) al posto delle @dfn{pipe}, se il sistema in uso le prevede.
+Questo vien fatto, a seconda del comando da usare, impostando un elemento
+speciale nel vettore @code{PROCINFO}
+(@pxref{Variabili auto-assegnate}),
+in questo modo:
+
address@hidden
+comando = "sort -nr" # comando, salvato in una variabile
+PROCINFO[comando, "pty"] = 1 # aggiorna PROCINFO
+print @dots{} |& comando # avvia la @dfn{pipe} bidirezionale
address@hidden
address@hidden example
+
address@hidden
+Se il sistema in uso non ha le @dfn{pty}, o se tutte le @dfn{pty} del sistema
+sono in uso, @command{gawk} automaticamente torna a usare le @dfn{pipe}
+regolari.
+
+Usare le @dfn{pty} in genere evita i problemi di stallo del buffer descritti
+precedentemente, in cambio di un piccolo calo di prestazioni. address@hidden
dipende
+dal fatto che la gestione delle @dfn{tty} @`e fatta una riga per volta.
+Su sistemi che hanno il comando @command{stdbuf} (parte del pacchetto
address@hidden://www.gnu.org/software/coreutils/coreutils.html,
+GNU Coreutils}), si address@hidden usare tale programma, invece delle
@dfn{pty}.
+
+Si noti anche che le @dfn{pty} non sono completamente trasparenti.
+Alcuni codici di controllo binari, come @kbd{Ctrl-d} per indicare la
+condizione di file-file, sono interpetati dal gestore di @dfn{tty}
+e non sono passati all'applicazione.
+
address@hidden ATTENZIONE
+In ultima analisi, i coprocessi danno adito alla address@hidden di uno
address@hidden (deadlock) tra @command{gawk} e il programma in esecuzione
+nel coprocesso. address@hidden address@hidden succedere se si inviano
``troppi'' dati al
+coprocesso, prima di leggere dati inviati dallo stesso; entrambi i
+processi sono bloccati sulla scrittura dei dati, e nessuno dei due
address@hidden disponibile a leggere quelli che sono address@hidden stati
scritti dall'altro.
+Non c'@`e modo di evitare completamente una tale situazione; occorre una
+programmazione attenta, insieme alla conoscenza del comportamento del
+coprocesso.
address@hidden quotation
+
address@hidden Reti TCP/IP
address@hidden Usare @command{gawk} per la programmazione di rete
address@hidden address@hidden avanzate, programmazione di rete
address@hidden avanzate, address@hidden, programmazione di rete
address@hidden reti, programmazione di
address@hidden TCP/IP
address@hidden @code{/inet/@dots{}}, file speciali (in @command{gawk})
address@hidden file speciali @code{/inet/@dots{}} (in @command{gawk})
address@hidden @code{/inet4/@dots{}}, file speciali (in @command{gawk})
address@hidden file speciali @code{/inet4/@dots{}} (in @command{gawk})
address@hidden @code{/inet6/@dots{}}, file speciali (in @command{gawk})
address@hidden file speciali @code{/inet6/@dots{}} (in @command{gawk})
address@hidden @code{EMRED}
address@hidden
address@hidden
address@hidden:@*
+@ @ @ @ @i{A host is a host from coast to coast,@*
+@ @ @ @ and nobody talks to a host that's close,@*
+@ @ @ @ unless the host that isn't address@hidden
+@ @ @ @ is busy, hung, or dead.}
+
address@hidden:@*
+@ @ @ @ @i{Un computer @`e un computer lontano o vicino,@*
+@ @ @ @ e nessuno parla con un computer vicino,@*
+@ @ @ @ a meno che il computer address@hidden
+@ @ @ @ sia occupato, fuori linea, o spento.}
address@hidden Mike O'Brien (noto anche come Mr.@: Protocol)
address@hidden quotation
address@hidden ifnotdocbook
+
address@hidden
+<blockquote>
+<attribution>Mike O'Brien (aka Mr. Protocol)</attribution>
+<literallayout class="normal"><literal>EMRED</literal>:
+ <emphasis>A host is a host from coast to
coast,</emphasis>
+ <emphasis>and no-one can talk to host that's
close,</emphasis>
+ <emphasis>unless the host that isn't close</emphasis>
+ <emphasis>is busy, hung, or
dead.</emphasis></literallayout>
+</blockquote>
address@hidden docbook
+
+Oltre a poter aprire una @dfn{pipeline} bidirezionale verso un coprocesso
+sullo stesso sistema
+(@pxref{I/O bidirezionale}),
address@hidden possibile attivare una connessione bidirezionale verso un altro
processo
+o verso un altro sistema attraverso una connessione di rete IP.
+
+Si address@hidden pensare a questo semplicemente come a una @dfn{pipeline}
bidirezionale
address@hidden lunga} verso un coprocesso.
+Il modo in cui @command{gawk} stabilisce quando usare una rete TCP/IP @`e
+mediante il riconoscimento di speciali @value{FNS} che iniziano con
address@hidden/inet/}, con @samp{/inet4/} o con @samp{/inet6/}.
+
+La sintassi completa del @value{FN} speciale @`e
address@hidden/@var{tipo-rete}/@var{protocollo}/@var{porta-locale}/@var{host-remoto}/@var{porta-remota}}.
+I componenti sono:
+
address@hidden @var
address@hidden tipo-rete
+Specifica il tipo di connessione a internet da stabilire.
+Si usa @samp{/inet4/} per usare solo IPv4, e
address@hidden/inet6/} per usare solo IPv6.
+Il semplice @samp{/inet/} (che usualmente @`e l'unica opzione) usa
+il tipo di default del sistema, quasi certamente IPv4.
+
address@hidden protocollo
+Il protocollo da usare sull'IP. Questo dev'essere o @samp{tcp} o
address@hidden, per una connessione IP rispettivamente TCP o UDP.
+TCP dovrebbe venir usato per la maggior parte delle applicazioni.
+
address@hidden porta-locale
address@hidden @code{getaddrinfo()}, funzione (libreria C)
address@hidden funzione @code{getaddrinfo()} (libreria C)
+Il numero di porta TCP o UDP da usare. Si usa un numero di porta di valore
address@hidden quando si vuole che sia il sistema a scegliere una porta.
+Questo @`e quel che si dovrebbe fare quando si scrive un'applicazione
+cliente TCP o UDP.
+Si address@hidden usare anche un nome di un servizio noto, come @samp{smtp}
+o @samp{http}, nel qual caso @command{gawk} tenta di determinare
+il numero di porta predefinito usando la funzione C @code{getaddrinfo()}.
+
address@hidden host-remoto
+L'indirizzo IP o il nome di dominio completamente qualificato dell'host
+internet al quale ci si vuol connettere.
+
address@hidden porta-remota
+Il numero di porta TCP o UDP da usare sul particolare @var{host remoto}.
+Anche in questo caso, si usi @samp{0} se non ci sono preferenze,
+o alternativamente, un nome di servizio comunemente noto.
address@hidden table
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile
address@hidden variabile @code{ERRNO}
address@hidden NOTA
+Un insuccesso nell'apertura di un socket bidirezionale address@hidden luogo
alla
+segnalazione di un errore non fatale al codice chiamante.
+Il valore di @code{ERRNO} indica l'errore (@pxref{Variabili auto-assegnate}).
address@hidden quotation
+
+Si consideri il seguente esempio molto semplice:
+
address@hidden
+BEGIN @{
+ Servizio = "/inet/tcp/0/localhost/daytime"
+ Servizio |& getline
+ print $0
+ close(Servizio)
address@hidden
address@hidden example
+
+Questo programma legge la data e l'ora corrente dal server @code{daytime}
+TCP del sistema locale.
+Stampa poi il risultato e chiude la connessione.
+
+Poich@'e questo tema @`e molto ampio, l'uso di @command{gawk} per
+la programmazione TCP/IP viene documentato separatamente.
address@hidden
+Si veda
address@hidden, , General Introduction, gawkinet, @value{GAWKINETTITLE}},
address@hidden ifinfo
address@hidden
+Si veda
address@hidden://www.gnu.org/software/gawk/manual/gawkinet/,
address@hidden@value{GAWKINETTITLE}}},
+che fa parte della distribuzione @command{gawk},
address@hidden ifnotinfo
+per una introduzione e trattazione molto address@hidden completa e con molti
+esempi.
+
address@hidden NOTA
address@hidden address@hidden aprire solo socket diretti. Al momento non c'@`e
alcun modo
+per accedere ai servizi disponibili su Secure Socket Layer
+(SSL); questo comprende qualsiasi servizio web il cui URL inizia con
address@hidden://}.
address@hidden quotation
+
+
address@hidden Profilare
address@hidden Profilare i propri programmi @command{awk}
address@hidden @command{awk}, programmi, profilare
address@hidden profilare programmi @command{awk}
address@hidden @code{awkprof.out}, file
address@hidden file @code{awkprof.out}
+
address@hidden possibile tener traccia dell'esecuzione dei propri programmi
@command{awk}.
address@hidden si address@hidden fare passando l'opzione @option{--profile} a
@command{gawk}.
+Al termine dell'esecuzione, @command{gawk} crea un profilo del programma in un
+file chiamato @file{awkprof.out}. A causa dell'address@hidden di profilazione
+l'esecuzione del programma @`e address@hidden lenta fino al 45% rispetto al
normale.
+
address@hidden @option{--profile}, opzione
address@hidden opzione @option{--profile}
+Come mostrato nel seguente esempio,
+l'opzione @option{--profile} address@hidden essere usata per cambiare il nome
del file
+su cui @command{gawk} address@hidden il profilo:
+
address@hidden
+gawk --profile=mioprog.prof -f mioprog.awk dati1 dati2
address@hidden example
+
address@hidden
+Nell'esempio precedente, @command{gawk} mette il profilo in
address@hidden anzich@'e in @file{awkprof.out}.
+
+Vediamo ora una sessione d'esempio che mostra un semplice programma
address@hidden, i suoi dati in input, e il risultato dell'esecuzione di
address@hidden con l'opzione @option{--profile}. Innanzitutto, il
+programma @command{awk}:
+
address@hidden
+BEGIN @{ print "Prima regola BEGIN" @}
+
+END @{ print "Prima regola END" @}
+
+/pippo/ @{
+ print "trovato /pippo/, perbacco"
+ for (i = 1; i <= 3; i++)
+ sing()
address@hidden
+
address@hidden
+ if (/pippo/)
+ print "l'if @`e vero"
+ else
+ print "l'else @`e vero"
address@hidden
+
+BEGIN @{ print "Seconda regola BEGIN" @}
+
+END @{ print "Seconda regola END" @}
+
+function sing( ignora)
address@hidden
+ print "Devo essere io!"
address@hidden
address@hidden example
+
+Questi sono i dati in input:
+
address@hidden
+pippo
+pluto
+paperino
+pippo
+cianfrusaglie
address@hidden example
+
+E questo @`e il file @file{awkprof.out} che @`e il risultato dell'esecuzione
+del profilatore di @command{gawk} su questo programma e sui dati (quest'esempio
+dimostra anche che i programmatori di @command{awk} a volte si alzano molto
+presto al mattino per lavorare):
+
address@hidden @code{BEGIN}, criterio di ricerca, e profilatura
address@hidden criterio di ricerca @code{BEGIN}, e profilatura
address@hidden @code{END}, criterio di ricerca, e profilatura
address@hidden criterio di ricerca @code{END}, e profilatura
address@hidden
+ # profilo gawk, creato Mon Sep 29 05:16:21 2014
+
+ # BEGIN regola(e)
+
+ BEGIN @{
+ 1 print "Prima regola BEGIN"
+ @}
+
+ BEGIN @{
+ 1 print "Seconda regola BEGIN"
+ @}
+
+ # Regola(e)
+
+ 5 /pippo/ @{ # 2
+ 2 print "trovato /pippo/, perbacco"
+ 6 for (i = 1; i <= 3; i++) @{
+ 6 sing()
+ @}
+ @}
+
+ 5 @{
+ 5 if (/pippo/) @{ # 2
+ 2 print "l'if @`e vero"
+ 3 @} else @{
+ 3 print "l'else @`e vero"
+ @}
+ @}
+
+ # END regola(e)
+
+ END @{
+ 1 print "Prima regola END"
+ @}
+
+ END @{
+ 1 print "Seconda regola END"
+ @}
+
+
+ # Funzioni, in ordine alfabetico
+
+ 6 function sing(ignora)
+ @{
+ 6 print "Devo essere io!"
+ @}
address@hidden example
+
+Quest'esempio illustra molte caratteristiche fondamentali dell'output
+della profilazione.
+Queste sono:
+
address@hidden @value{BULLET}
address@hidden
+Il programma viene stampato nell'ordine: regole @code{BEGIN},
+regole @code{BEGINFILE},
+regole criterio di ricerca--azione,
+regole @code{ENDFILE}, regole @code{END}, e funzioni, elencate
+in ordine alfabetico.
+Le regole @code{BEGIN} ed @code{END} multiple conservano le loro
+distinte address@hidden, address@hidden@dotless{i}} come le regole
@code{BEGINFILE} ed @code{ENDFILE}
+multiple.
+
address@hidden criteri di ricerca, conteggi, in un profilo
address@hidden
+Le regole criterio di ricerca--azione hanno due conteggi.
+Il primo conteggio, a sinistra della regola, mostra quante volte
+il criterio di ricerca della regola @`e stato @emph{testato}.
+Il secondo conteggio, alla destra della parentesi graffa aperta,
+all'interno di un commento,
+mostra quante volte l'azione della regola @`e stata @emph{eseguita}.
+La differenza tra i due indica quante volte il criterio di ricerca della regola
address@hidden stato valutato come falso.
+
address@hidden
+Analogamente,
+il conteggio per un'istruzione @address@hidden mostra quante volte
+la condizione @`e stata testata.
+Alla destra della parentesi graffa sinistra aperta per il corpo di @code{if}
+c'@`e un conteggio che mostra quante volte la condizione @`e stata trovata
vera.
+Il conteggio per @code{else} indica
+quante volte la verifica non ha avuto successo.
+
address@hidden cicli, conteggi per l'intestazione, in un profilo
address@hidden
+Il conteggio per un ciclo (come @code{for}
+o @code{while}) mostra quante volte il test del ciclo @`e stato eseguito.
+(Per questo motivo, non si address@hidden solamente guardare il conteggio
sulla prima
+istruzione in una regola per determinare quante volte la regola @`e stata
+eseguita. Se la prima istruzione @`e un ciclo, il conteggio @`e ingannevole.)
+
address@hidden funzioni definite dall'utente, conteggi, in un profilo
address@hidden definite dall'utente, funzioni, conteggi, in un profilo
address@hidden
+Per le funzioni definite dall'utente, il conteggio vicino alla parola chiave
address@hidden indica quante volte la funzione @`e stata chiamata.
+I conteggi vicino alle istruzioni nel corpo mostrano quante volte
+quelle istruzioni sono state eseguite.
+
address@hidden @address@hidden@}} (parentesi graffe)
address@hidden parentesi graffe (@address@hidden@}})
address@hidden
+L'impaginazione usa lo stile ``K&R'' con le tabulazioni.
+Le parentesi graffe sono usate dappertutto, anche dove il corpo di un
address@hidden, di un @code{else} o di un ciclo @`e formato da un'unica
istruzione.
+
address@hidden @code{()} (parentesi), in un profilo
address@hidden parentesi (@code{()}), in un profilo
address@hidden
+Le parentesi vengono usate solo dov'@`e necessario, come si rileva dalla
+struttura del programma e dalle regole di precedenza.
+Per esempio, @samp{(3 + 5) * 4} significa sommare tre e cinque, quindi
+moltiplicare il totale per quattro. Di contro, @samp{3 + 5 * 4} non ha
+parentesi, e significa @samp{3 + (5 * 4)}.
+
address@hidden
address@hidden
+All string concatenations are parenthesized too.
+(This could be made a bit smarter.)
address@hidden ignore
+
address@hidden
+Le parentesi vengono usate attorno agli argomenti di @code{print}
+e @code{printf} solo quando l'istruzione
address@hidden o @code{printf} @`e seguita da una ridirezione.
+Similarmente, se
+l'oggetto di una ridirezione non @`e uno scalare, viene messo tra parentesi.
+
address@hidden
address@hidden mette dei commenti iniziali
+davanti alle regole @code{BEGIN} ed @code{END},
+alle regole @code{BEGINFILE} ed @code{ENDFILE},
+alle regole criterio_di_ricerca--azione e alle funzioni.
+
address@hidden itemize
+
+La versione profilata del proprio programma potrebbe non apparire esattamente
+come quella scritta durante la stesura del programma. Questo perch@'e
address@hidden crea la versione profilata facendo una ``stampa elegante'' della
+sua rappresentazione interna del programma. Un vantaggio di address@hidden
@`e che
address@hidden address@hidden produrre una rappresentazione standard.
+Inoltre, cose come:
+
address@hidden
+/pippo/
address@hidden example
+
address@hidden
+appaiono come:
+
address@hidden
+/pippo/ @{
+ print $0
address@hidden
address@hidden example
+
address@hidden
+che @`e corretto, ma probabilmente inatteso.
+
address@hidden profilare programmi @command{awk}, dinamicamente
address@hidden @command{gawk}, programma, profilazione dinamica
address@hidden profilazione dinamica
+Oltre a creare profili una volta completato il programma,
address@hidden address@hidden generare un profilo mentre @`e in esecuzione.
+Questo @`e utile se il proprio programma @command{awk} entra in un ciclo
+infinito e si vuol vedere cosa @`e stato eseguito.
+Per usare questa address@hidden, bisogna eseguire @command{gawk} con l'opzione
address@hidden in background:
+
address@hidden
+$ @kbd{gawk --profile -f mioprog &}
+[1] 13992
address@hidden example
+
address@hidden @command{kill}, address@hidden profilazione dinamica e
address@hidden comando @address@hidden profilazione dinamica e
address@hidden @code{USR1}, segnale, per profilazione dinamica
address@hidden @code{SIGUSR1}, segnale, per profilazione dinamica
address@hidden segnali @code{USR1}/@code{SIGUSR1}, per profilazione
address@hidden
+La shell stampa un numero di job e il numero di ID del relativo processo;
+in questo caso, 13992. Si usi il comando @command{kill} per inviare il
+segnale @code{USR1} a @command{gawk}:
+
address@hidden
+$ @kbd{kill -USR1 13992}
address@hidden example
+
address@hidden
+Come al solito, la versione profilata del programma @`e scritta nel file
address@hidden, o in un file differente se ne viene specificato uno
+con l'opzione @option{--profile}.
+
+Assieme al profilo regolare, come mostrato in precedenza, il file del profilo
+include una traccia di ogni funzione attiva:
+
address@hidden
+# `Stack' (Pila) Chiamate Funzione:
+
+# 3. paperino
+# 2. pluto
+# 1. pippo
+# -- main --
address@hidden example
+
+Si address@hidden inviare a @command{gawk} il segnale @code{USR1} quante volte
si vuole.
+Ogni volta, il profilo e la traccia della chiamata alla funzione vengono
+aggiunte in fondo al file di profilo creato.
+
address@hidden @code{HUP}, segnale, per profilazione dinamica
address@hidden @code{SIGHUP}, segnale, per profilazione dinamica
address@hidden segnali @code{HUP}/@code{SIGHUP}, per profilazione
+Se si usa il segnale @code{HUP} invece del segnale @code{USR1}, @command{gawk}
+genera il profilo e la traccia della chiamata alla funzione ed esce.
+
address@hidden @code{INT}, segnale (MS-Windows)
address@hidden @code{SIGINT}, segnale (MS-Windows)
address@hidden segnali @code{INT}/@code{SIGINT} (MS-Windows)
address@hidden @code{QUIT}, segnale (MS-Windows)
address@hidden @code{SIGQUIT}, segnale (MS-Windows)
address@hidden segnali @code{QUIT}/@code{SIGQUIT} (MS-Windows)
+Quando @command{gawk} viene eseguito sui sistemi MS-Windows, usa i segnali
address@hidden e @code{QUIT} per generare il profilo, e nel
+caso del segnale @code{INT}, @command{gawk} esce. Questo perch@'e
+questi sistemi non prevedono il comando @command{kill}, per cui gli unici
+segnali che si possono trasmettere a un programma sono quelli generati dalla
+tastiera. Il segnale @code{INT} @`e generato dalle combinazioni di tasti
address@hidden o @kbd{Ctrl-BREAK}, mentre il segnale
address@hidden @`e generato dalla combinazione di tasti @kbd{Ctrl-\}.
+
+Infine, @command{gawk} accetta anche un'altra opzione, @option{--pretty-print}.
+Quando viene chiamato in questo modo, @command{gawk} fa una ``stampa elegante''
+del programma nel file @file{awkprof.out}, senza conteggi sull'esecuzione.
+
address@hidden NOTA
+Una volta, l'opzione @option{--pretty-print} eseguiva anche il programma.
+Ora non address@hidden
address@hidden quotation
+
+C'@`e una differenza significativa tra l'output creato durante la
profilazione, e
+quello creato durante la stampa elegante. L'output della stampa elegante
+preserva i commenti originali che erano nel programma, anche se la loro
+posizione address@hidden non corrispondere esattamente alle posizioni
originali che
+avevano nel codice address@hidden@command{gawk} fa del suo meglio
+per mantenere la distinzione tra commenti posti dopo delle istruzioni e
+commenti su righe a s@'e stanti. Per limiti insiti nell'implementazione,
+non sempre questo address@hidden avvenire in maniera corretta, in particolare
nel
+caso di istruzioni @code{switch}. I manutentori di @command{gawk}
+sperano di poter migliorare la situazione in una futura versione.}
+
+Comunque, per una precisa scelta progettuale, l'output della profilazione
address@hidden i commenti del programma originale. Questo permette di
+concentrarsi sui dati del conteggio di esecuzione ed evita la tentazione di
+usare il profilatore per creare una stampa elegante.
+
+Oltre a address@hidden, l'output stampato in modo elegante non ha
l'indentazione iniziale
+che ha l'output della profilazione. Questo rende agevole la stampa elegante
+del proprio codice una volta completato lo sviluppo, usando poi il risultato
+come versione finale del programma.
+
+Poich@'e la rappresentazione interna del programma @`e formattata per
+essere aderente al programma @command{awk} in questione, la profilatura
+e la formattazione graziosa (opzione @option{--pretty-print}) disabilitano
+automaticamente le optimizzazioni di default di @command{gawk}.
+
+La formattazione elegante mantiene anche il formato originale delle
+costanti numeriche; se sono stati usati dei valori ottali o esadecimali
+nel codice sorgente, questi compariranno nell'output nello stesso
+formato con cui sono stati inseriti.
+
address@hidden Sommario address@hidden avanzate
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+L'opzione @option{--non-decimal-data} fa address@hidden@dotless{i}} che
@command{gawk} tratti
+i dati di input che hanno l'aspetto ottale ed esadecimale come valori ottali ed
+esadecimali. L'opzione dovrebbe essere usata con prudenza o non usata affatto;
address@hidden preferibile l'uso di @code{strtonum()}.
+Si noti che quest'opzione potrebbe sparire nelle prossime versioni di
address@hidden
+
address@hidden
+Si address@hidden prendere il completo controllo dell'ordinamento nello
scorrere il
+vettore con @samp{for (@var{indice} in @var{vettore})}, impostando
address@hidden"sorted_in"]} al nome di una funzione definita dall'utente che
+fa il confronto tra elementi del vettore basandosi su indice e valore.
+
address@hidden
+Analogamente, si address@hidden fornire il nome di una funzione di confronto
definita
+dall'utente come terzo argomento di @code{asort()} o di @command{asorti()} per
+controllare come queste funzioni ordinano i vettori. O si address@hidden
fornire una delle
+stringhe di controllo predefinite che funzionano per
address@hidden"sorted_in"]}.
+
address@hidden
+Si address@hidden usare l'operatore @samp{|&} per creare una @dfn{pipe}
bidirezionale
+verso un coprocesso. Si legge dal coprocesso con @code{getline}, ci si
+scrive sopra con @code{print} o con @code{printf}. Usare @code{close()}
+per bloccare il coprocesso completamente o, se necessario, chiudere le
+comunicazioni bidirezionali in una direzione.
+
address@hidden
+Usando degli speciali @value{FNS} con l'operatore @samp{|&}, si address@hidden
aprire una
+connessione TCP/IP (o UDP/IP) verso host remoti su internet. @command{gawk}
+supporta sia IPv4 che IPv6.
+
address@hidden
+Si possono generare profili del proprio programma con i conteggi del numero
+di esecuzione di ogni singola
+istruzione. Questo address@hidden essere d'aiuto nel determinare quali parti
del programma
+potrebbero portar via la maggior parte del tempo, consentendo
address@hidden@dotless{i}} di
+aggiustarli address@hidden agevolmente. Inviando il segnale @code{USR1}
durante la
+profilazione @command{gawk} scrive il profilo, includendo la
+stack della chiamata alla funzione e prosegue nell'elaborazione.
+
address@hidden
+Si address@hidden anche fare solo una ``stampa elegante'' del programma.
+
address@hidden itemize
address@hidden Internazionalizzazione
address@hidden Internazionalizzazione con @command{gawk}
+
+Tanto tempo fa i produttori di computer
+scrivevano software che comunicava solo in inglese.
+Col passare del tempo, i venditori di hardware e di software si sono
+resi conto che se i loro sistemi avessero comunicato anche nelle lingue
+materne di paesi dove non si parlava inglese,
address@hidden avrebbe avuto come risultato un incremento delle vendite.
+Per questo motivo, l'internazionalizzazione e la localizzazione
+di programmi e sistemi software @`e divenuta una pratica comune.
+
address@hidden internazionalizzazione, localizzazione
address@hidden @command{gawk}, internazionalizzazione e, si veda
internazionalizzazione
address@hidden internazionalizzazione, localizzazione, @command{gawk} e
+Per molti anni la address@hidden di fornire l'internazionalizzazione
+era sostanzialmente limitata ai programmi scritti in C e C++.
+Questo @value{CHAPTER} descrive la libreria @dfn{ad hoc} utilizzata da
address@hidden
+per l'internazionalizzazione e anche il modo in cui le address@hidden che
+consentono l'internazionalizzazione sono rese disponibili da @command{gawk}
+a ogni programma scritto in @command{awk}.
+La address@hidden dell'internazionalizzazione a livello di programma
address@hidden offre ulteriore address@hidden agli sviluppatori di software:
+non sono address@hidden obbligati a scrivere in C o C++ quando
l'internazionalizzazione
address@hidden necessaria in un programma.
+
address@hidden
+* I18N e L10N:: Internazionalizzazione e localizzazione.
+* Utilizzare @command{gettext}:: Come funziona il comando GNU
@command{gettext}.
+* I18N per programmatore:: address@hidden per il programmatore.
+* I18N per traduttore:: address@hidden per il traduttore.
+* Esempio I18N:: Un semplice esempio di internazionalizzazione.
+* Gawk internazionalizzato:: Anche @command{gawk} @`e internazionalizzato.
+* Sommario I18N:: Sommario dell'internazionalizzazione.
address@hidden menu
+
address@hidden I18N e L10N
address@hidden Internazionalizzazione e localizzazione
+
address@hidden internazionalizzazione di programmi @command{awk}
address@hidden localizzazione, si veda address@hidden localizzazione
address@hidden localizzazione
address@hidden significa scrivere (o modificare) un programma
+una volta sola,
+in maniera tale che possa usare address@hidden di una lingua senza
+bisogno di ulteriori modifiche al file sorgente.
address@hidden
+significa fornire i dati necessari perch@'e un programma
+internazionalizzato sia in grado di funzionare con una data lingua.
+Questi termini si riferiscono comunemente a address@hidden quali la lingua
+usata per stampare messaggi di errore, quella usata per leggere
+risposte, e alle informazioni
+relative al modo di leggere e di stampare dati di tipo numerico o valutario.
+
address@hidden Utilizzare @command{gettext}
address@hidden Il comando GNU @command{gettext}
+
address@hidden internazionalizzare un programma
address@hidden @command{gettext}, libreria
address@hidden libreria @command{gettext}
address@hidden usa il comando GNU @command{gettext} per rendere disponibili
+le proprie address@hidden di internazionalizzazione.
+L'attenzione del comando GNU @command{gettext} @`e rivolta principalmente
+ai messaggi: stringhe di caratteri stampate da un programma, sia
+direttamente sia usando la formattazione prevista dalle istruzioni
address@hidden o @code{sprintf()address@hidden alcuni sistemi operativi,
+la relativa versione di @command{gawk}
+non supporta il comando GNU @command{gettext}.
+Per questo motivo, queste address@hidden non sono disponibili nel caso
+si stia lavorando con uno di questi sistemi operativi. Siamo spiacenti.}
+
address@hidden address@hidden, libreria @command{gettext} e
+Quando si usa il comando GNU @command{gettext}, ogni applicazione ha il
+proprio @dfn{dominio di testo}. Questo @`e un nome unico come,
+p.es., @samp{kpilot} o @samp{gawk},
+che identifica l'applicazione.
+Un'applicazione completa address@hidden avere address@hidden componenti:
programmi scritti
+in C o C++, come pure script di @command{sh} o di @command{awk}.
+Tutti i componenti usano lo stesso dominio di testo.
+
+Per andare sul concreto, si supponga di scrivere un'applicazione
+chiamata @command{guide}. L'internazionalizzazione per quest'applicazione
address@hidden essere implementata seguendo nell'ordine i passi qui delineati:
+
address@hidden
address@hidden
+Il programmatore esamina i sorgenti di tutti i componenti dell'applicazione
address@hidden e prende nota di ogni stringa che potrebbe aver bisogno
+di traduzione.
+Per esempio, @code{"`-F': option required"} @`e una stringa che sicuramente
+necessita di una traduzione.
+Una tabella che contenga stringhe che sono nomi di opzioni @emph{non}
+necessita di traduzione.
+(P.es., l'opzione di @command{gawk} @option{--profile}
+dovrebbe restare immutata, a prescindere dalla lingua locale).
+
address@hidden @code{textdomain()}, funzione (libreria C)
address@hidden funzione @code{textdomain()} (libreria C)
address@hidden
+Il programmatore indica il dominio di testo dell'applicazione
+(@command{"guide"}) alla libreria @command{gettext},
+chiamando la funzione @code{textdomain()}.
+
address@hidden @code{.pot}, file
address@hidden file @code{.pot}
address@hidden @dfn{portable object template} (.pot), file
address@hidden file, @dfn{portable object template} (.pot)
address@hidden
+I messaggi dell'applicazione che vanno tradotti sono estratti dal codice
+sorgente e messi in un file di tipo
address@hidden object template}
+[modello di oggetto portabile]
+di nome @file{guide.pot},
+che elenca le stringhe e le relative traduzioni.
+Le traduzioni sono inizialmente vuote
+(esiste la struttura che definisce la stringa tradotta, ma la stringa
+tradotta @`e una stringa nulla).
+Il messaggio originale (normalmente in inglese) @`e utilizzato come chiave
+di riferimento per le traduzioni.
+
address@hidden @code{.po}, file
address@hidden file @code{.po}
address@hidden @dfn{portable object} file (.po)
address@hidden file, @dfn{portable object} (.po)
address@hidden
+Per ogni lingua per cui sia disponibile un traduttore, il file
address@hidden @`e copiato in un file di tipo
address@hidden object}
+[oggetto portabile]
+(dal suffisso @code{.po})
+e le traduzioni sono effettuate su quel file,
+che viene distribuito con l'applicazione.
+Per esempio, potrebbe esserci un file @file{it.po} per la traduzione italiana.
+
address@hidden @code{.gmo}, file
address@hidden file @code{.gmo}
address@hidden @dfn{message object} file (.mo)
address@hidden file, @dfn{message object} (.mo)
address@hidden
+Il file @file{.po} di ogni lingua @`e convertito in un formato binario,
+detto @dfn{message object} (file @file{.gmo}).
+Un file di tipo @dfn{message object} contiene i messaggi originali e le loro
+traduzioni in un formato binario che facilita il ritrovamento delle
+traduzioni quando l'applicazione viene eseguita.
+
address@hidden
+Quando @command{guide} @`e compilato e installato, i file binari contenenti le
+traduzioni sono installati in una directory standard.
+
address@hidden @code{bindtextdomain()}, funzione (libreria C)
address@hidden funzione @code{bindtextdomain()} (libreria C)
address@hidden
+Durante la fase di prova e sviluppo, @`e possibile chiedere a @command{gettext}
+di usare un file @file{.gmo} in una directory diversa da quella standard,
+usando la funzione @code{bindtextdomain()}.
+
address@hidden @code{.gmo}, file, specificare la directory di
address@hidden file @code{.gmo}, specificare la directory di
address@hidden @dfn{message object} file (.mo), specificare la directory di
address@hidden file, @dfn{message object} (.mo), specificare la directory di
address@hidden
+Quando viene eseguito, il programma @command{awk} @command{guide} cerca ogni
+stringa da tradurre facendo una chiamata a @code{gettext()}. La stringa
+ricevuta in ritorno @`e la stringa tradotta, se @`e stata trovata, o la stringa
+originale, se una traduzione non @`e disponibile.
+
address@hidden
+Se necessario, @`e possibile procurarsi dei messaggi tradotti da un dominio di
+testo diverso da quello proprio dell'applicazione, senza dover altalenare fra
+questo secondo dominio e quello dell'applicazione.
address@hidden enumerate
+
address@hidden @code{gettext()}, funzione (libreria C)
address@hidden funzione @code{gettext()} (libreria C)
+In C (o C++), la marcatura della stringa la ricerca dinamica
+della traduzione si fanno inserendo ogni stringa da tradurre in una chiamata
+a @code{gettext()}:
+
address@hidden
+printf("%s", gettext("Don't Panic!\n"));
address@hidden example
+
+Gli strumenti software che estraggono messaggi dal codice sorgente
+individuano tutte le stringhe racchiuse nelle chiamate a @code{gettext()}.
+
address@hidden @code{_} (trattino basso), macro C
address@hidden trattino basso (@code{_}), macro C
+Gli sviluppatori del comando GNU @command{gettext}, riconoscendo che
+continuare a immettere @samp{gettext(@dots{})} @`e sia faticoso che poco
+elegante da vedere, usano la macro @samp{_} (un trattino basso) per
+facilitare la cosa:
+
address@hidden
+/* Nel file di intestazione standard: */
+#define _(str) gettext(str)
+
+/* Nel testo del programma: */
+printf("%s", _("Don't Panic!\n"));
address@hidden example
+
address@hidden internazionalizzazione, localizzazione, categorie di
localizzazione
address@hidden @command{gettext}, libreria, categorie di localizzazione
address@hidden libreria @command{gettext}, categorie di localizzazione
address@hidden categorie di localizzazione
address@hidden
+Questo permette di ridurre la digitazione extra a solo tre caratteri per
+ogni stringa da tradurre e inoltre migliora di molto la address@hidden
+
+Ci sono @dfn{categorie} di localizzazione per tipi diversi di informazioni
+legate a una particolare localizzazione.
+Le categorie di localizzazione note a @command{gettext} sono:
+
address@hidden @code
address@hidden @code{LC_MESSAGES}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_MESSAGES}
address@hidden LC_MESSAGES
+Testo dei messaggi. Questa @`e la categoria di default usata all'interno di
address@hidden, ma @`e possibile specificarne esplicitamente una differente,
+se necessario. (Questo non @`e quasi mai necessario.)
+
address@hidden ordinare caratteri in lingue differenti
address@hidden @code{LC_COLLATE}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_COLLATE}
address@hidden LC_COLLATE
+Informazioni sull'ordinamento alfabetico (address@hidden, come caratteri
diversi e/o
+gruppi di carattere sono ordinati in un dato linguaggio).
address@hidden ad esempio i vari caratteri accentati in italiano, vanno ordinati
address@hidden insieme alla loro lettera "principale" (e @`e @'e).
+
address@hidden @code{LC_CTYPE}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_CTYPE}
address@hidden LC_CTYPE
+Informazioni sui singoli caratteri (alfabetico, numerico, maiuscolo
+o minuscolo, etc.), come pure sulla codifica dei caratteri.
address@hidden
+In June 2001 Bruno Haible wrote:
+- Description of LC_CTYPE: It determines both
+ 1. character encoding,
+ 2. character type information.
+ (For example, in both KOI8-R and ISO-8859-5 the character type information
+ is the same - cyrillic letters could as 'alpha' - but the encoding is
+ different.)
address@hidden ignore
+Quest'informazione @`e utilizzata per stabilire le classi di caratteri come
+definite nello standard POSIX, nelle espressioni regolari,
+come p. es. @code{/[[:alnum:]]/}
+(@pxref{Espressioni tra parentesi quadre}).
+
address@hidden informazioni di tipo monetario, localizzazione
address@hidden monete, simboli di, nella localizzazione
address@hidden simboli di monete, nella localizzazione
address@hidden monete, rappresentazioni di, nella localizzazione
address@hidden rappresentazioni di monete, nella localizzazione
address@hidden @code{LC_MONETARY}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_MONETARY}
address@hidden LC_MONETARY
+Le informazioni di tipo monetario, quali il simbolo della moneta, e se
+il simbolo va prima o dopo il valore numerico.
+
address@hidden @code{LC_NUMERIC}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_NUMERIC}
address@hidden LC_NUMERIC
+Informazioni di tipo numerico, quali il carattere da usare per separare le
+cifre decimali e quello per separare le address@hidden americani usano
+una virgola ogni tre cifre decimali, e un punto per separare la parte decimale
+di un numero, mentre molti europei (fra cui gli italiani) fanno esattamente
+l'opposto: 1,234.56 invece che 1.234,56.}
+
address@hidden tempo, localizzazione e
address@hidden date, informazioni relative alla localizzazione
address@hidden @code{LC_TIME}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_TIME}
address@hidden LC_TIME
+Informazioni relative alle date e alle ore,
+come l'uso di ore nel formato a 12 ore oppure a 24 ore, il mese stampato
+prima o dopo il giorno in una data, le abbreviazioni dei mesi nella lingua
+locale, e address@hidden@dotless{i}} via.
+
address@hidden @code{LC_ALL}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_ALL}
address@hidden LC_ALL
+Tutte le categorie viste sopra. (Non molto utile nel contesto del comando
address@hidden)
address@hidden table
+
address@hidden NOTA
address@hidden @env{LANGUAGE}, variabile d'ambiente
address@hidden variabile d'ambiente @env{LANGUAGE}
+Come descritto in @ref{Localizzazioni}, le variabili d'ambiente
+che hanno lo stesso nome delle categorie di localizzazione
+(@env{LC_CTYPE}, @env{LC_ALL}, etc.) influenzano il comportamento di
address@hidden (e quello di altri programmi di address@hidden).
+
+Solitamente, queste variabili influenzano anche il modo con cui
+la libreria @code{gettext} trova le traduzioni. Tuttavia, la
+variabile d'ambiente @env{LANGUAGE} prevale sulle variabili
+della famiglia @address@hidden Molti sistemi GNU/Linux possono
+aver definito questa variabile senza esplicitamente notificarlo
+all'utente, e questo potrebbe far address@hidden@dotless{i}} che
@command{gawk} non riesca a
+trovare le traduzioni corrette. Se si incontra questa situazione,
+occorre controllare se la variabile d'ambiente @env{LANGUAGE} @`e
+definita, e, in questo caso, va usato il comando @command{unset}
+per rimuoverla.
address@hidden quotation
+
+Per il test di traduzioni dei messaggi inviati da @command{gawk} stesso, si
address@hidden
+impostare la variabile d'ambiente @env{GAWK_LOCALE_DIR}. Si veda la
+documentazione per la funzione C @code{bindtextdomain()}, e si veda anche
address@hidden variabili d'ambiente}.
+
address@hidden I18N per programmatore
address@hidden Internazionalizzare programmi @command{awk}
address@hidden programmi @command{awk}, internazionalizzare
address@hidden internazionalizzazione di programmi @command{awk}
+
address@hidden prevede le seguenti variabili per l'internazionalizzazione:
+
address@hidden @code
address@hidden @code{TEXTDOMAIN}, variabile
address@hidden variabile @code{TEXTDOMAIN}
address@hidden TEXTDOMAIN
+Questa variabile indica il dominio di testo dell'applicazione.
+Per address@hidden con il comando GNU @command{gettext}, il valore di default
address@hidden @code{"messages"}.
+
address@hidden internazionalizzazione, localizzazione, stringhe marcate
address@hidden stringhe, marcare per localizzazione
address@hidden _"questo @`e un messaggio da tradurre"
+Costanti di tipo stringa marcate con un trattino basso iniziale
+sono candidate per essere tradotte al momento dell'esecuzione del
+programma @command{gawk}.
+Costanti di tipo stringa non precedute da un trattino basso non
+verranno tradotte.
address@hidden table
+
address@hidden fornisce le seguenti funzioni al servizio
+dell'internazionalizzazione:
+
address@hidden @code
address@hidden
address@hidden @code{dcgettext(@var{string}} address@hidden,} @var{dominio}
address@hidden,} @address@hidden)}
+Restituisce la traduzione di @var{stringa} nel
+dominio di testo @var{dominio} per la categoria di localizzazione
@var{categoria}.
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
+
+Se si assegna un valore a @var{categoria}, dev'essere una stringa uguale a
+una delle categorie di localizzazione note, descritte
address@hidden
+nella precedente @value{SECTION}.
address@hidden ifnotinfo
address@hidden
address@hidden @command{gettext}}.
address@hidden ifinfo
+Si deve anche specificare un dominio di testo. Si usi @code{TEXTDOMAIN} se
+si desidera usare il dominio corrente.
+
address@hidden ATTENZIONE
+L'ordine degli argomenti per la versione @command{awk}
+della funzione @code{dcgettext()} @`e differente, per una scelta di progetto,
+dall'ordine degli argomenti passati alla funzione C che ha lo stesso nome.
+L'ordine della versione @command{awk} @`e stato scelto per amore di
address@hidden e per consentire di avere dei valori di default per gli
+argomenti che fossero il address@hidden possibile simili, come stile, a quello
di
address@hidden
address@hidden quotation
+
address@hidden
address@hidden @code{dcngettext(@var{stringa1}, @var{stringa2}, @var{numero}}
address@hidden,} @var{dominio} address@hidden,} @address@hidden)}
+Restituisce la forma, singolare o plurale, da usare a seconda del valore
+di @var{numero} per la
+traduzione di @var{stringa1} e @var{stringa2} nel dominio di testo
address@hidden per la categoria di localizzazione @var{categoria}.
address@hidden @`e la variante al singolare in inglese di un messaggio,
+e @var{stringa2} @`e la variante al plurale in inglese dello stesso messaggio.
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
+
+Valgono le stesse osservazioni riguardo all'ordine degli argomenti
+fatte a proposito della funzione @code{dcgettext()}.
+
address@hidden @code{.gmo}, file, specificare la directory di
address@hidden file @code{.gmo}, specificare la directory di
address@hidden @dfn{message object} file (.mo), specificare la directory di
address@hidden file, @dfn{message object} (.mo), specificare la directory di
address@hidden
address@hidden @code{bindtextdomain(@var{directory}} address@hidden,}
@var{dominio} address@hidden)}
+Cambia la directory nella quale
address@hidden va a cercare i file @file{.gmo}, per il caso in cui questi
+non possano risiedere nelle posizioni standard
+(p.es., in fase di test).
+Restituisce la directory alla quale @var{dominio} @`e ``collegato''.
+
+Il @var{dominio} di default @`e il valore di @code{TEXTDOMAIN}.
+Se l'argomento @var{directory} @`e impostato alla stringa nulla (@code{""}),
address@hidden()} restituisce il collegamento corrente applicabile
+al @var{dominio} specificato.
address@hidden table
+
+Per usare queste address@hidden in un programma @command{awk},
+va seguita la procedura qui indicata:
+
address@hidden
address@hidden @code{BEGIN}, criterio di ricerca, variabile @code{TEXTDOMAIN} e
address@hidden criterio di ricerca @code{BEGIN}, variabile @code{TEXTDOMAIN} e
address@hidden @code{TEXTDOMAIN}, variabile, criterio di ricerca @code{BEGIN} e
address@hidden variabile @code{TEXTDOMAIN}, criterio di ricerca @code{BEGIN} e
address@hidden
+Impostare la variabile @code{TEXTDOMAIN} al dominio di testo del
+programma. @`E meglio fare address@hidden all'interno di una regola
@code{BEGIN}
+(@pxref{BEGIN/END}),
+ma si address@hidden anche fare dalla riga di comando, usando l'opzione
@option{-v}
+(@pxref{Opzioni}):
+
address@hidden
+BEGIN @{
+ TEXTDOMAIN = "guide"
+ @dots{}
address@hidden
address@hidden example
+
address@hidden @code{_} (trattino basso), stringa traducibile
address@hidden trattino basso (@code{_}), stringa traducibile
address@hidden
+Marcare tutte le stringhe traducibili anteponendo loro un
+trattino basso (@samp{_}). Il trattino @emph{deve} essere adiacente ai
+doppi apici di apertura della stringa. Per esempio:
+
address@hidden
+print _"hello, world"
+x = _"you goofed"
+printf(_"Number of users is %d\n", nusers)
address@hidden example
+
address@hidden
+Se le stringhe da visualizzare sono create dinamicamente, @`e ancora possibile
+tradurle, usando la funzione predefinita @code{dcgettext()}:@footnote{I miei
+ringraziamenti a Bruno Haible per questo esempio.}
+
address@hidden
+if (assonnato)
+ messaggio = dcgettext("%d clienti mi scocciano\n", "adminprog")
+else
+ messaggio = dcgettext("mi diverto con %d clienti\n", "adminprog")
+printf(messaggio, numero_clienti)
address@hidden example
+
+In questo esempio, la chiamata a @code{dcgettext()} specifica un diverso
+dominio di testo (@code{"adminprog"}) in cui trovare il
+messaggio, ma usa la categoria di default @code{"LC_MESSAGES"}.
+
+Il precedente esempio funziona solo se @code{numero_clienti} @`e un numero
maggiore
+di uno.
+Per questo esempio sarebbe address@hidden appropriato usare la funzione
@code{dcngettext()}:
+
address@hidden
+if (assonnato)
+ messaggio = dcngettext("%d cliente mi scoccia\n",
+ "%d clienti mi scocciano\n",
+ numero_clienti, "adminprog")
+else
+ messaggio = dcngettext("mi diverto con %d cliente\n",
+ "mi diverto con %d clienti\n",
+ numero_clienti, "adminprog")
+printf(messaggio, numero_clienti)
address@hidden example
+
+
address@hidden @code{LC_MESSAGES}, categoria di localizzazione, funzione
@code{bindtextdomain()} di (@command{gawk})
address@hidden
+In fase di sviluppo, si address@hidden scegliere di tenere il file @file{.gmo}
+in una directory a parte, solo per provarlo. address@hidden si fa
+con la funzione predefinita @code{bindtextdomain()}:
+
address@hidden
+BEGIN @{
+ TEXTDOMAIN = "guide" # dominio di testo regolare
+ if (Testing) @{
+ # dove trovare il file in prova
+ bindtextdomain("testdir")
+ # joe si occupa del programma adminprog
+ bindtextdomain("../joe/testdir", "adminprog")
+ @}
+ @dots{}
address@hidden
address@hidden example
+
address@hidden enumerate
+
address@hidden I18N}
+per un programma di esempio che illustra i passi da seguire per creare
+e usare traduzioni nei programmi @command{awk}.
+
address@hidden I18N per traduttore
address@hidden Traduzione dei programmi @command{awk}
+
address@hidden @code{.po}, file
address@hidden file @code{.po}
address@hidden @dfn{portable object} file (.po)
address@hidden file, @dfn{portable object} (.po)
+Dopo aver marcato le stringhe che si desidera tradurre in un programma,
+queste vanno estratte per creare il file iniziale @file{.pot}.
+Durante la traduzione, @`e spesso utile modificare l'ordine nel quale
+gli argomenti passati a @code{printf} vengono stampati.
+
+L'opzione da riga di comando @option{--gen-pot} di @command{gawk} serve a
+estrarre i messaggi, ed @`e esposta qui di seguito.
+Dopo di che, address@hidden illustrata la address@hidden di modificare l'ordine
+in cui l'istruzione @code{printf} stampa gli argomenti che le sono passati
+in fase di esecuzione.
+
address@hidden
+* Estrazione di stringhe:: Estrarre stringhe marcate.
+* Ordinamento di printf:: Riordinare argomenti @code{printf}
+* address@hidden nell'I18N:: Problemi di address@hidden a livello di
@command{awk}.
address@hidden menu
+
address@hidden Estrazione di stringhe
address@hidden Estrarre stringhe marcate
address@hidden stringhe, estrazione di
address@hidden stringhe marcate, estrazione di
address@hidden @option{--gen-pot}, opzione
address@hidden opzione @option{--gen-pot}
address@hidden opzioni sulla riga di comando, estrazione stringhe
address@hidden riga di comando, opzioni, estrazione stringhe
address@hidden stringhe marcate, estrazione di (internazionalizzazione)
address@hidden marcate, estrazione di stringhe (internazionalizzazione)
address@hidden estrazione di stringhe marcate (internazionalizzazione)
+
address@hidden @option{--gen-pot}, opzione
address@hidden opzione @option{--gen-pot}
+Una volta che il programma @command{awk} funziona, e tutte le stringhe
+sono state marcate ed @`e stato impostato (e forse fissato) il dominio di
+testo, @`e ora di preparare le traduzioni.
+Per prima cosa, usando l'opzione di riga di comando @option{--gen-pot},
+si crea il file iniziale @file{.pot}:
+
address@hidden
+gawk --gen-pot -f guide.awk > guide.pot
address@hidden example
+
address@hidden @code{xgettext}, programma di address@hidden
address@hidden programma di address@hidden @code{xgettext}
+Quando viene chiamato specificando @option{--gen-pot}, @command{gawk} non
+esegue il programma. Il programma viene esaminato come al solito, e tutte
+le stringhe che sono state marcate per essere tradotte vengono scritte nello
+standard output, nel formato di un file Portable Object di GNU
address@hidden
+L'output comprende anche quelle stringhe costanti che appaiono come primo
+argomento della funzione @code{dcgettext()} o come primo e secondo
+argomento della funzione @code{dcngettext()address@hidden comando di
address@hidden
address@hidden che fa parte del pacchetto distribuito come
address@hidden @`e in grado di gestire i file di tipo @file{.awk}.}
+Il file @file{.pot} address@hidden@dotless{i}} generato
+andrebbe distribuito insieme al programma @command{awk}; i traduttori
+potranno eventualmente utilizzarlo per preparare delle traduzioni, le quali
+potranno a loro volta essere distribuite.
address@hidden I18N}
+per una lista esauriente dei passi necessari per creare e testare
+traduzioni per il programma @command{guide}.
+
address@hidden Ordinamento di printf
address@hidden Riordinare argomenti di @code{printf}
+
address@hidden @code{printf}, istruzione, specificatori di posizione
address@hidden istruzione @code{printf}, specificatori posizionali
address@hidden posizionali, specificatori, istruzione @code{printf}
address@hidden specificatori posizionali, istruzione @code{printf}
+Le stringhe di formattazione per @code{printf} e @code{sprintf()}
+(@pxref{Printf})
+hanno un problema speciale con le traduzioni.
+Si consideri il seguente esempio:@footnote{Questo esempio @`e preso in
+prestito dal manuale del comando GNU @command{gettext}.}
+
address@hidden
+printf(_"String `%s' has %d characters\n",
+ string, length(string)))
address@hidden example
+
+Una possibile traduzione in italiano di questo messaggio potrebbe essere:
+
address@hidden
+"%d @`e la lunghezza della stringa `%s'\n"
address@hidden example
+
+Il problema dovrebbe essere ovvio: l'ordine delle specifiche di
+formattazione @`e differente da quello originale!
address@hidden()}, che pure address@hidden restituire la stringa tradotta
+in fase di esecuzione, non @`e in grado di cambiare l'ordine degli argomenti
+nella chiamata a @code{printf}.
+
+Per risolvere questo problema, gli specificatori di formato di @code{printf}
+possono avere un elemento in address@hidden, facoltativo, detto
@dfn{specificatore
+posizionale}. Per esempio:
+
address@hidden
+"%2$d @`e la lunghezza della stringa `%1$s'\n"
address@hidden example
+
+Qui, lo specificatore posizionale consiste in un numero intero, che indica
+quale argomento utilizzare, seguito da un carattere @samp{$}.
+I numeri partono da uno, e la stringa di formattazione vera e propria
address@hidden @`e inclusa. Quindi, nell'esempio seguente, @samp{stringa} @`e
+il primo argomento e @samp{length(stringa)} @`e il secondo:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{stringa = "Non v\47allarmate!"}
+> @kbd{printf "%2$d caratteri compongono \"%1$s\"\n",}
+> @kbd{stringa, length(stringa)}
+> @address@hidden'}
address@hidden 16 caratteri compongono "Non v\47allarmate!"
address@hidden example
+
+Se presenti, gli specificatori posizionali precedono, nella specifica di
+formato, i flag, la larghezza del campo e/o la precisione.
+
+Gli specificatori posizionali possono essere usati anche se si specifica una
+larghezza dinamica dei campi, e della address@hidden di precisione:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{printf("%*.*s\n", 10, 20, "hello")}
+> @kbd{printf("%3$*2$.*1$s\n", 20, 10, "hello")}
+> @address@hidden'}
address@hidden hello
address@hidden hello
address@hidden example
+
address@hidden NOTA
+Se si usa @samp{*} con uno specificatore posizionale, il carattere @samp{*}
+viene per primo, seguito dal numero che indica la posizione, a sua volta
+seguito dal @samp{$}.
address@hidden address@hidden parere poco intuitivo.
address@hidden quotation
+
address@hidden istruzione @code{printf}, specificatori posizionali, frammisti a
formati standard
address@hidden @code{printf}, istruzione, specificatori posizionali, frammisti
a formati standard
address@hidden specificatori posizionali, istruzione @code{printf}, frammisti a
formati standard
address@hidden formato, specificatori di, frammisti a specificatori posizionali
non standard
address@hidden specificatori di formato, frammisti a specificatori posizionali
non standard
address@hidden non consente di mischiare specificatori di formato standard
+con altri contenenti degli specificatori posizionali in una stessa stringa di
+formato:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "%d %3$s\n", 1, 2, "ciao" @}'}
address@hidden gawk: riga com.:1: fatale: `count$' va usato per tutti
address@hidden i formati o per nessuno
address@hidden example
+
address@hidden NOTA
+Ci sono alcuni casi patologici in cui @command{gawk} potrebbe non inviare
+alcun messaggio diagnostico, anche quando sarebbe necessario.
+In tali casi, l'output address@hidden non essere quello atteso.
+Rimane sempre una pessima idea quella di tentare di mischiare i formati,
+anche se @command{gawk} non riesce ad accorgersene.
address@hidden quotation
+
+Sebbene gli specificatori posizionali possano essere usati direttamente nei
+programmi @command{awk}, il motivo per cui sono stati introdotti @`e perch@'e
+siano d'aiuto nel produrre traduzioni corrette della stringa di
+formattazione in lingue differenti da quella nella quale il programma @`e stato
+originariamente scritto.
+
address@hidden address@hidden nell'I18N
address@hidden Problemi di address@hidden a livello di @command{awk}
+
address@hidden address@hidden, internazionalizzazione e
address@hidden internazionalizzazione, localizzazione, address@hidden e
+Le address@hidden di internazionalizzazione di @command{gawk} sono state
+appositamente implementate per avere il minimo impatto possibile sulla
address@hidden, verso altre versioni di @command{awk}, dei programmi
address@hidden che ne fanno uso.
+Si consideri questo programma:
+
address@hidden
+BEGIN @{
+ TEXTDOMAIN = "guide"
+ if (Test_Guide) # da impostare tramite -v
+ bindtextdomain("/test/guide/messages")
+ print _"don't panic!"
address@hidden
address@hidden example
+
address@hidden
+Per il modo in cui @`e scritto, non address@hidden con altre versioni di
address@hidden
+Tuttavia, @`e in address@hidden quasi portabile, e richiede modifiche minime:
+
address@hidden @value{BULLET}
address@hidden @code{TEXTDOMAIN}, variabile, address@hidden e
address@hidden variabile @code{TEXTDOMAIN}, address@hidden e
address@hidden
+Le assegnazioni di valori a @code{TEXTDOMAIN} non avranno effetto alcuno,
+perch@'e @code{TEXTDOMAIN} non @`e una variabile speciale in altre
+implementazioni di @command{awk}.
+
address@hidden
+Versioni Non-GNU di @command{awk} considerano le stringhe marcate
+come la concatenazione di una variabile di nome @code{_} con la stringa che
+viene subito address@hidden @`e
+un buon materiale per una gara di address@hidden @command{awk}''.}
+Tipicamente, la variabile @code{_} ha come valore la stringa nulla
+(@code{""}), il che produce come risultato la stringa
+originale.
+
address@hidden
+Definendo delle funzioni ``fittizie'' per sostituire @code{dcgettext()},
address@hidden()} e @code{bindtextdomain()}, il programma @command{awk}
address@hidden essere reso eseguibile, ma
+tutti i messaggi verranno inviati nella lingua originale del programma.
+Per esempio:
+
address@hidden @code{bindtextdomain()}, funzione (@command{gawk}),
address@hidden e
address@hidden funzione @code{bindtextdomain()} (@command{gawk}),
address@hidden e
address@hidden @code{dcgettext()}, funzione (@command{gawk}), address@hidden e
address@hidden funzione @code{dcgettext()} (@command{gawk}), address@hidden e
address@hidden @code{dcngettext()}, funzione (@command{gawk}), address@hidden e
address@hidden funzione @code{dcngettext()} (@command{gawk}), address@hidden e
address@hidden
address@hidden file eg/lib/libintl.awk
+function bindtextdomain(dir, domain)
address@hidden
+ return dir
address@hidden
+
+function dcgettext(string, domain, category)
address@hidden
+ return string
address@hidden
+
+function dcngettext(string1, string2, number, domain, category)
address@hidden
+ return (number == 1 ? string1 : string2)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+L'uso di specificazioni posizionali in @code{printf} o
address@hidden()} @emph{non} @`e portabile.
+Per supportare @code{gettext()} nella programmazione in linguaggio C,
+molte versioni C di @code{sprintf()} supportano specificatori posizionali.
+Ma la cosa funziona solo se nella chiamata di funzione sono stati specificati
+argomenti a sufficienza. Molte
+versioni di @command{awk} passano i formati e gli argomenti di @code{printf},
+senza modificarli, alla funzione di libreria in linguaggio C @code{sprintf()},
+ma solo un formato e un argomento alla volta. Quel che succede se si usa una
+specificazione posizionale resta indeterminato.
+Tuttavia, poich@'e le specificazioni posizionali sono usate principalmente
+per le stringhe di formattazione @emph{tradotte}, e poich@'e le versioni
+non-GNU di @command{awk} non utilizzano mai le stringhe tradotte,
address@hidden non
+dovrebbe, in pratica, causare problemi.
address@hidden itemize
+
address@hidden Esempio I18N
address@hidden Un semplice esempio di internazionalizzazione.
+
+Vediamo ora un esempio dettagliato di come internazionalizzare e localizzare
+un semplice programma @command{awk}, usando come nostro programma sorgente
+originale il file @file{guide.awk}:
+
address@hidden
address@hidden file eg/prog/guide.awk
+BEGIN @{
+ TEXTDOMAIN = "guide"
+ bindtextdomain(".") # per la fase di test
+ print _"Don't Panic"
+ print _"The Answer Is", 42
+ print "Pardon me, Zaphod who?"
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Eseguire @samp{gawk --gen-pot} per creare il file @file{.pot}:
+
address@hidden
+$ @kbd{gawk --gen-pot -f guide.awk > guide.pot}
address@hidden example
+
address@hidden
+Questo produce:
+
address@hidden
address@hidden file eg/data/guide.po
+#: guide.awk:4
+msgid "Don't Panic"
+msgstr ""
+
+#: guide.awk:5
+msgid "The Answer Is"
+msgstr ""
+
address@hidden endfile
address@hidden example
+
+Questo modello di @dfn{portable object} va salvato e riutilizzato per ogni
+lingua in cui l'applicazione viene tradotta. La stringa @code{msgid} @`e
+seguita dalla stringa originale da tradurre, e la stringa @code{msgstr}
address@hidden la traduzione.
+
address@hidden NOTA
+Le stringhe non aventi come prefisso un trattino basso non sono inserite
+nel file @file{guide.pot}.
address@hidden quotation
+
+Successivamente, i messaggi devono essere tradotti.
+Questa @`e una traduzione in un ipotetico dialetto dell'inglese,
+chiamato ``Mellow'':@footnote{Forse sarebbe meglio chiamarlo
+``Hippy.'' Meglio non indagare oltre.}
+
address@hidden
address@hidden
+$ @kbd{cp guide.pot guide-mellow.po}
address@hidden traduzioni al file} guide-mellow.po @dots{}
address@hidden group
address@hidden example
+
address@hidden
+Ecco le traduzioni:
+
address@hidden
address@hidden file eg/data/guide-mellow.po
+#: guide.awk:4
+msgid "Don't Panic"
+msgstr "Hey man, relax!"
+
+#: guide.awk:5
+msgid "The Answer Is"
+msgstr "Like, the scoop is"
+
address@hidden endfile
address@hidden example
+
address@hidden Linux
address@hidden GNU/Linux
+Il passo successivo @`e di creare la directory che contenga il file binario
+con le traduzioni dei messaggi (file .mo [message object]) e
+creare in quella directory il file @file{guide.mo}.
+Si presume che il file in questione debba essere usato nella localizzazione
address@hidden, perch@'e si deve usare un nome di localizzazione che sia
+noto alle routine del comando C @command{gettext}.
+La disposizione delle directory qui utilizzata @`e standard per il comando
+GNU @command{gettext} sui sistemi GNU/Linux. Altre versioni di
address@hidden possono usare una disposizione differente:
+
address@hidden
+$ @kbd{mkdir en_US.UTF-8 en_US.UTF-8/LC_MESSAGES}
address@hidden example
+
address@hidden @code{.po}, file, conversione in @code{.mo}
address@hidden file @code{.po}, conversione in @code{.mo}
address@hidden @code{.mo}, file, conversione da @code{.po}
address@hidden file @code{.mo}, conversione da @code{.po}
address@hidden @dfn{portable object} file (.po), conversione in @dfn{message
object} file
address@hidden file, @dfn{portable object} (.po), conversione in @dfn{message
object} file
address@hidden @dfn{message object} file (.mo), conversione da @dfn{portable
object} file
address@hidden file, @dfn{message object} (.mo), conversione da @dfn{portable
object} file
address@hidden @command{msgfmt}, programma di address@hidden
address@hidden programma di address@hidden @command{msgfmt}
+Il programma di address@hidden @command{msgfmt} effettua la conversione dal
file
+leggibile, in formato testo, @file{.po} nel file, in formato binario,
address@hidden
+Per default, @command{msgfmt} crea un file di nome @file{messages}.
+A questo file dev'essere assegnato un nome appropriato, e va messo nella
+directory predisposta (usando l'opzione @option{-o}) in modo che
address@hidden sia in grado di trovarlo:
+
address@hidden
+$ @kbd{msgfmt guide-mellow.po -o en_US.UTF-8/LC_MESSAGES/guide.mo}
address@hidden example
+
+Infine, eseguiamo il programma per provare se funziona:
+
address@hidden
+$ @kbd{gawk -f guide.awk}
address@hidden Hey man, relax!
address@hidden Like, the scoop is 42
address@hidden Pardon me, Zaphod who?
address@hidden example
+
+Se le tre funzioni che rimpiazzano @code{dcgettext()}, @code{dcngettext()},
+e @code{bindtextdomain()}
+(@address@hidden nell'I18N})
+sono contenute in un file di nome @file{libintl.awk},
address@hidden possibile eseguire @file{guide.awk} senza modificarlo, nel modo
seguente:
+
address@hidden
+$ @kbd{gawk --posix -f guide.awk -f libintl.awk}
address@hidden Don't Panic
address@hidden The Answer Is 42
address@hidden Pardon me, Zaphod who?
address@hidden example
+
address@hidden Gawk internazionalizzato
address@hidden @command{gawk} stesso @`e internazionalizzato
+
+Il comando @command{gawk} stesso @`e stato internazionalizzato
+usando il pacchetto GNU @command{gettext}.
+(GNU @command{gettext} @`e descritto in
+maniera esauriente in
address@hidden
address@hidden, , GNU @command{gettext} utilities, gettext, GNU
@command{gettext} utilities}.)
address@hidden ifinfo
address@hidden
address@hidden://www.gnu.org/software/gettext/manual/,
address@hidden @command{gettext} utilities}}.)
address@hidden ifnotinfo
+Al momento in cui questo libro @`e stato scritto, la versione address@hidden
recente di
+GNU @command{gettext} @`e
address@hidden://ftp.gnu.org/gnu/gettext/gettext-0.19.4.tar.gz,
address@hidden 0.19.4}.
+
+Se esiste una traduzione dei messaggi di @command{gawk},
address@hidden invia messaggi, avvertimenti, ed errori fatali
+utilizzando la lingua locale.
+
address@hidden Sommario I18N
address@hidden Sommario
address@hidden @value{BULLET}
address@hidden
+Internazionalizzazione significa scrivere un programma in modo che
+possa interagire in molte lingue senza che sia necessario cambiare il codice
+sorgente.
+Localizzazione significa fornire i dati necessari perch@'e un programma
+internazionalizzato possa interagire usando una determinata lingua.
+
address@hidden
address@hidden usa il comando GNU @command{gettext} per consentire
+l'internazionalizzazione e la localizzazione di programmi @command{awk}.
+Un dominio di testo di un programma identifica il programma, e consente di
+raggruppare tutti i messaggi e gli altri dati del programma in un solo posto.
+
address@hidden
+Si marcano le stringhe in un programma da tradurre preponendo loro un
+trattino basso. Una volta fatto questo, queste stringhe sono estratte
+in un file @file{.pot}. Questo file @`e copiato, per ogni lingua, in un file
address@hidden e i file @file{.po} sono
+compilati in file @file{.gmo} che saranno usati in fase di
+esecuzione del programma.
+
address@hidden
address@hidden possibile usare specificazioni posizionali con le istruzioni
address@hidden()} e @code{printf} per modificare la posizione del valore
+degli argomenti nelle stringhe di formato e nell'output. address@hidden @`e
utile nella
+traduzione di stringhe di
+formattazione dei messaggi.
+
address@hidden
+Le address@hidden di internazionalizzazione sono state progettate in modo
+da poter essere facilmente gestite in un programma @command{awk} standard.
+
address@hidden
+Anche il comando @command{gawk} @`e stato internazionalizzato e viene
+distribuito con traduzioni in molte lingue dei messaggi inviati in fase di
+esecuzione.
+
address@hidden itemize
+
+
address@hidden Debugger
address@hidden Effettuare il debug dei programmi @command{awk}
address@hidden debug dei programmi @command{awk}
+
address@hidden The original text for this chapter was contributed by Efraim
Yawitz.
address@hidden FIXME: Add more indexing.
+
+Sarebbe bello se i programmi per il calcolatore funzionassero perfettamente la
+prima volta che vengono eseguiti, ma nella vita reale questo accade raramente,
+qualunque sia la address@hidden dei programmi. address@hidden la maggior
parte dei
+linguaggi di programmazione hanno a disposizione degli strumenti che facilitano
+la ricerca di errori (@dfn{debugging}) nei programmi, e @command{awk} non fa
+eccezione.
+
+Il @dfn{debugger} di @command{gawk} @`e di proposito costruito sul modello del
+debugger da riga di comando
address@hidden://www.gnu.org/software/gdb/, GNU Debugger (GDB)}.
+Se si ha address@hidden con GDB, address@hidden facile imparare come usare
@command{gawk}
+per eseguire il debug dei propri programmi.
+
address@hidden
+* Debugging:: Introduzione al debugger di @command{gawk}.
+* Esempio di sessione di debug:: Esempio di sessione di debug.
+* Lista dei comandi di debug:: Principali comandi di debug.
+* Supporto per Readline:: Supporto per Readline.
+* Limitazioni:: Limitazioni e piani per il futuro.
+* Sommario sul debug:: Sommario sul debug.
address@hidden menu
+
address@hidden Debugging
address@hidden Introduzione al debugger di @command{gawk}
+
+Questa @value{SECTION}, dopo un'introduzione sul debug in generale, inizia
+la trattazione del debug in @command{gawk}.
+
address@hidden
+* Nozioni sul debug:: address@hidden sul debug.
+* Terminologia nel debug:: Ulteriori nozioni sul debug.
+* Debug di Awk:: Eseguire il debug di Awk.
address@hidden menu
+
address@hidden Nozioni sul debug
address@hidden address@hidden sul debug
+
+(Se si sono usati dei debugger in altri linguaggi, si address@hidden andare
direttamente
+alla @ref{Debug di Awk}.)
+
+Naturalmente, un programma di debug non address@hidden correggere gli errori
al posto del
+programmatore, perch@'e non address@hidden sapere quello che il programmatore
o gli utenti
+considerano un ``bug'' e non una address@hidden''. (Talvolta, anche noi umani
+abbiamo address@hidden nel determinarlo.)
+In quel caso, cosa ci si address@hidden aspettare da un tale strumento? La
risposta
+dipende dal linguaggio su cui si effettua il debug, comunque in generale ci si
address@hidden attendere almeno questo:
+
address@hidden @value{BULLET}
address@hidden
+La address@hidden di osservare l'esecuzione delle istruzioni di un programma
una
+per una, dando al programmatore l'address@hidden di pensare a quel che accade a
+una scala temporale di secondi, minuti od ore, piuttosto che alla scala dei
+nanosecondi alla quale normalmente viene eseguito il codice.
+
address@hidden
+L'address@hidden, non solo di osservare passivamente le operazioni del
progamma,
+ma di controllarlo e tentare diversi percorsi di esecuzione, senza dover
+modificare i file sorgenti.
+
address@hidden
+La address@hidden di vedere i valori o i dati nel programma in qualsiasi punto
+dell'esecuzione, e anche di cambiare i dati al volo, per vedere come questo
+influisca su address@hidden che accade dopo. (Questo include spesso la
address@hidden di
+esaminare le strutture interne dei dati oltre alle variabili che
+sono state effettivamente definite nel codice del programma.)
+
address@hidden
+La address@hidden di ottenere ulteriori informazioni sullo stato del programma
+o anche sulle sue strutture interne.
address@hidden itemize
+
+Tutti questi strumenti sono di grande aiuto e permettono di usare
l'address@hidden
+che si possiede e la comprensione che si ha degli obiettivi del programma
+per trovare dove si verificano i problemi (o, in alternativa, per
+comprendere meglio la logica di un programma funzionante, di cui si sia
+l'autore, o anche di un programma scritto da altri).
+
address@hidden Terminologia nel debug
address@hidden Concetti fondamentali sul debug
+
+Prima di entrare nei dettagli, dobbiamo introdurre diversi
+importanti concetti che valgono per tutti i debugger.
+La seguente lista definisce i termini usati nel resto di
+questo @value{CHAPTER}:
+
address@hidden @dfn
address@hidden @dfn{stack frame}
address@hidden Stack frame
+Durante la loro esecuzione i programmi normalmente chiamano delle funzioni.
+Una funzione address@hidden a sua volta chiamarne un'altra, o address@hidden
richiamare se stessa
+(ricorsione). La
+catena di funzioni chiamate (il programma principale chiama A, che chiama B,
+che chiama C) address@hidden essere vista come una pila di funzioni in
esecuzione: la
+funzione correntemente in esecuzione @`e quella in cima alla pila, e quando
+questa finisce (ritorna al chiamante),
+quella immediatamente sotto diventa la funzione
+attiva. Tale pila (@dfn{stack}) @`e chiamata @dfn{call stack} (pila delle
chiamate).
+
+Per ciascuna funzione della pila delle chiamate (@dfn{call stack}), il sistema
+mantiene un'area di dati che contiene i parametri della funzione, le variabili
+locali e i valori di ritorno, e anche ogni altra informazione ``contabile''
+necessaria per gestire la pila delle chiamate. Quest'area di dati @`e chiamata
address@hidden frame}.
+
+Anche @command{gawk} segue questo modello, e permette l'accesso alla pila
+delle chiamate e a ogni @dfn{stack frame}. @`E possibile esaminare la pila
+delle chiamate, e anche sapere da dove ciascuna funzione sulla pila @`e stata
+invocata. I comandi che stampano la pila delle chiamate stampano anche le
+informazioni su ogni @dfn{stack frame} (come vedremo address@hidden avanti in
dettaglio).
+
address@hidden Punto d'interruzione
address@hidden breakpoint
address@hidden punto d'interruzione
+Durante le operazioni di debug, spesso si preferisce lasciare che il programma
+venga eseguito finch@'e non raggiunge un certo punto, e da quel punto in poi si
+continua l'esecuzione un'istruzione alla volta. Il modo per farlo @`e quello
di
+impostare un @dfn{punto d'interruzione} all'interno del programma. Un punto
+d'interruzione @`e il punto dove l'esecuzione del programma dovrebbe
+interrompersi (fermarsi), in modo da assumere il controllo dell'esecuzione del
+programma. Si possono aggiungere e togliere quanti punti d'interruzione si
+vogliono.
+
address@hidden Punto d'osservazione
address@hidden @dfn{watchpoint}
address@hidden punto d'osservazione
+Un punto d'osservazione @`e simile a un punto d'interruzione. La differenza
@`e
+che i punti d'interruzione sono orientati attorno al codice; fermano il
+programma quando viene raggiunto un certo punto nel codice. Un punto
+d'osservazione, invece, fa fermare il programma quando @`e stato
+cambiato il @emph{valore di un dato}. Questo @`e utile, poich@'e a volte
succede
+che una variabile riceva un valore errato, ed @`e difficile rintracciare il
punto
+dove address@hidden accade solo leggendo il codice sorgente.
+Usando un punto d'osservazione, si address@hidden fermare il programma in
qualunque punto
+vi sia un'assegnazione di variabile, e di solito si individua il codice che
+genera l'errore abbastanza velocemente.
address@hidden table
+
address@hidden Debug di Awk
address@hidden Il debug di @command{awk}
+
+Il debug di un programma @command{awk} ha delle address@hidden proprie, che
+non sono presenti in programmi scritti in altri linguaggi.
+
+Prima di tutto, il fatto che i programmi @command{awk} ricevano generalmente
+l'input riga per riga da uno o address@hidden file e operino su tali righe
usando regole
+specifiche, rende particolarmente agevole organizzare l'esame
+dell'esecuzione del programma facendo riferimento a tali regole.
+Come vedremo, ogni
+regola @command{awk} viene trattata quasi come una chiamata di funzione, col
+proprio specifico blocco di istruzioni.
+
+Inoltre, poich@'e @command{awk} @`e un linguaggio deliberatamente molto
+conciso, @`e facile perdere di vista tutto address@hidden che avviene
``dentro''
+ogni riga di codice @command{awk}. Il debugger address@hidden
l'address@hidden di
+guardare le singole istruzioni primitive la cui esecuzione @`e innescata
+dai comandi di alto livello di @command{awk}.
+
address@hidden Esempio di sessione di debug
address@hidden Esempio di sessione di debug di @command{gawk}
address@hidden esempio di sessione di debug
address@hidden debug, esempio di sessione
+
+Per illustrare l'uso di @command{gawk} come debugger, vediamo un esempio di
+sessione di debug. Come esempio address@hidden usata l'implementazione
@command{awk}
+del comando POSIX @command{uniq} descritta in precedenza (@pxref{Programma
+uniq}).
+
address@hidden
+* Invocazione del debugger:: Come far partire il debugger.
+* Trovare il bug:: Trovare il bug.
address@hidden menu
+
address@hidden Invocazione del debugger
address@hidden Come avviare il debugger
address@hidden avviare il debugger
address@hidden debugger, come avviarlo
address@hidden debugger, comandi del, si veda comando del debugger
+
+Per avviare il debugger in @command{gawk} si richiama il comando esattamente
+come al solito, specificando solo un'opzione aggiuntiva,
address@hidden, o la corrispondente opzione breve @option{-D}.
+I file (o il file) che contengono
+il programma e ogni codice ulteriore sono immessi sulla riga di comando come
+argomenti a una o address@hidden opzioni @option{-f}. (@command{gawk} non @`e
progettato per
+eseguire il debug di programmi scritti sulla riga di comando, ma solo per
+quello di programmi che risiedono su file.)
+Nel nostro caso, il debugger address@hidden invocato in questo modo:
+
address@hidden
+$ @kbd{gawk -D -f getopt.awk -f join.awk -f uniq.awk -1 file_di_input}
address@hidden example
+
address@hidden
+dove entrambi i file @file{getopt.awk} e @file{uniq.awk} sono in
@env{$AWKPATH}.
+(Gli utenti esperti di GDB o debugger simili dovrebbero tener presente che
+questa sintassi @`e leggermente differente da quello che sono abituati a usare.
+Col debugger di @command{gawk}, si danno gli argomenti per eseguire il
+programma nella riga di comando al debugger piuttosto che come parte del
+comando @code{run} al prompt del debugger.)
+L'opzione @option{-1} @`e un'opzione per @file{uniq.awk}.
+
+Invece di eseguire direttamente il programma sul @file{file_di_input}, come
address@hidden farebbe normalmente, il debugger semplicemente carica
+i file sorgenti del programma, li compila internamente, e poi mostra
+la riga d'invito:
+
address@hidden
+gawk>
address@hidden example
+
address@hidden
+da dove si possono impartire i comandi al debugger. Sin qui non @`e
+stato ancora eseguito nessun codice.
+
address@hidden Trovare il bug
address@hidden Trovare il bug
+
+Poniamo di avere un problema usando (una versione difettosa di)
address@hidden nella address@hidden ``salta-campi'', perch@'e sembra che non
+catturi le righe che dovrebbero essere identiche dopo aver saltato il primo
+campo, come:
+
address@hidden
+awk, ecco un programma meraviglioso!
+gawk, ecco un programma meraviglioso!
address@hidden example
+
+Questo potrebbe accadere se noi pensassimo (come in C) che i campi in un record
+siano numerati prendendo come base lo zero, per cui, invece di scrivere:
+
address@hidden
+campi_ultima = join(vettore_ultima, contatore_file+1, n)
+campi_corrente = join(vettore_corrente, contatore_file+1, m)
address@hidden example
+
address@hidden
+abbiamo scritto:
+
address@hidden
+campi_ultima = join(vettore_ultima, contatore_file, n)
+campi_corrente = join(vettore_corrente, contatore_file, m)
address@hidden example
+
+La prima cosa da fare quando si tenta di indagare su un problema come questo
@`e
+quella di mettere un punto d'interruzione (@dfn{breakpoint}) nel programma, in
modo
+da poterlo vedere al lavoro e catturare quello che non va. Una posizione
+ragionevole per un punto d'interruzione in @file{uniq.awk} @`e all'inizio della
+funzione @code{se_sono_uguali()}, che confronta la riga corrente con la
precedente.
+Per impostare il punto d'interruzione, usare il comando @code{b}
(@dfn{breakpoint}):
+
address@hidden
+gawk> @kbd{b se_sono_uguali}
address@hidden Breakpoint 1 impostato al file `uniq.awk', riga 63
address@hidden example
+
+Il debugger mostra il file e il numero di riga dove si trova il punto
+d'interruzione. Ora bisogna immettere @samp{r} o @samp{run} e il programma
+viene eseguito fino al primo punto d'interruzione:
+
address@hidden
+gawk> @kbd{r}
address@hidden Partenza del programma:
address@hidden Mi fermo in Rule ...
address@hidden Breakpoint 1, se_sono_uguali(n, m, campi_ultima, campi_corrente,
address@hidden vettore_ultima, vettore_corrente)
address@hidden a `uniq.awk':63
address@hidden 63 if (contatore_file == 0 && conta_caratteri == 0)
+gawk>
address@hidden example
+
+Ora possiamo osservare cosa accade all'interno del nostro programma.
+Prima di tutto, vediamo come siamo arrivati a questo punto. Sulla riga di
+comando battiamo @samp{bt} (che sta per ``backtrace''), e il debugger risponde
+con un listato degli @dfn{stack frame} correnti:
+
address@hidden
+gawk> @kbd{bt}
address@hidden #0 se_sono_uguali(n, m, campi_ultima, campi_corrente,
address@hidden vettore_ultima, vettore_corrente)
address@hidden a `uniq.awk':63
address@hidden #1 in main() a `uniq.awk':88
address@hidden example
+
+Questo ci dice che la funzione @code{se_sono_uguali()} @`e stata chiamata
+dal programma principale alla riga 88 del file @file{uniq.awk}. (Questo non
+sorprende, perch@'e @`e questa l'unica chiamata a @code{se_sono_uguali()} nel
+programma, address@hidden in programmi
address@hidden complessi, sapere chi ha chiamato una funzione e con quali
parametri address@hidden
+essere la chiave per trovare l'origine del problema.)
+
+Ora che siamo in @code{se_sono_uguali()}, possiamo iniziare a guardare i
valori di
+alcune variabili. Immaginiamo di battere @samp{p n}
+(@code{p} sta per @dfn{print} [stampa]). Ci aspetteremo di vedere il valore di
address@hidden, un parametro di @code{se_sono_uguali()}. In address@hidden, il
debugger
+ci address@hidden:
+
address@hidden
+gawk> @kbd{p n}
address@hidden n = untyped variable
address@hidden example
+
address@hidden
+In questo caso, @code{n} @`e una variabile locale non inizializzata, perch@'e
la
+funzione @`e stata chiamata senza argomenti (@pxref{Chiamate di funzione}).
+
+Una variabile address@hidden utile da visualizzare potrebbe essere la seguente:
+
address@hidden
+gawk> @kbd{p $0}
address@hidden $0 = "gawk, ecco un programma meraviglioso!"
address@hidden example
+
address@hidden
+All'inizio questo potrebbe lasciare un tantino perplessi, perch@'e @`e la
seconda
+riga dell'input del test. Vediamo @code{NR}:
+
address@hidden
+gawk> @kbd{p NR}
address@hidden NR = 2
address@hidden example
+
address@hidden
+Come si address@hidden vedere, @code{se_sono_uguali()} @`e stata chiamata solo
per la seconda
+riga del file. Naturalmente, address@hidden accade perch@'e il nostro
programma contiene
+una regola per @samp{NR == 1}:
+
address@hidden
+NR == 1 @{
+ ultima = $0
+ next
address@hidden
address@hidden example
+
+Bene, controlliamo che questa funzioni correttamente:
+
address@hidden
+gawk> @kbd{p ultima}
address@hidden ultima = "awk, ecco un programma meraviglioso!"
address@hidden example
+
+Tutto address@hidden che @`e stato fatto fin qui ha verificato che il
programma funziona
+come previsto fino alla chiamata a @code{se_sono_uguali()} compresa; quindi
+il problema dev'essere all'interno di questa funzione. Per indagare
+ulteriormente, iniziamo a ``scorrere una ad una'' le righe di
address@hidden()}. Cominciamo col battere @samp{n} (per ``next''
+[successivo]):
+
address@hidden
+gawk> @kbd{n}
address@hidden 66 if (contatore_file > 0) @{
address@hidden example
+
+Questo ci dice che @command{gawk} ora @`e pronto per eseguire la riga 66, che
+decide se assegnare alle righe il trattamento speciale ``salta-campi''
+indicato dall'opzione sulla riga di comando @option{-1}. (Si noti che abbiamo
+saltato da dov'eravamo prima, alla riga 63, a qui, perch@'e la condizione nella
+riga 63, @samp{if (contatore_file == 0 && conta_caratteri == 0)}, era falsa.)
+
+Continuando a scorrere le righe, ora raggiungiamo la divisione del record
+corrente e dell'ultimo:
+
address@hidden
+gawk> @kbd{n}
address@hidden 67 n = split(ultima, vettore_ultima)
+gawk> @kbd{n}
address@hidden 68 m = split($0, vettore_corrente)
address@hidden example
+
+A questo punto, potremmo stare a vedere in quante parti il nostro record
address@hidden stato suddiviso, quindi proviamo a osservare:
+
address@hidden
+gawk> @kbd{p n m vettore_ultima vettore_corrente}
address@hidden n = 5
address@hidden m = untyped variable
address@hidden vettore_ultima = array, 5 elements
address@hidden vettore_corrente = untyped variable
address@hidden example
+
address@hidden
+(Il comando @code{p} address@hidden accettare address@hidden argomenti,
analogamente
+all'istruzione di @command{awk} @code{print}.)
+
+Questo ci lascia piuttosto perplessi. Tutto address@hidden che abbiamo
trovato @`e che ci
+sono cinque elementi in @code{vettore_ultima}; @code{m} e
@code{vettore_corrente} non hanno valori
+perch@'e siamo alla riga 68 che non @`e ancora stata eseguita. Questa
+informazione @`e abbastanza utile (ora sappiamo che nessuna delle parole @`e
stata
+lasciata fuori accidentalmente), ma sarebbe desiderabile vedere i valori
+del vettore.
+
+Una prima address@hidden @`e quella di usare degli indici:
+
address@hidden
+gawk> @kbd{p vettore_ultima[0]}
address@hidden "0" non presente nel vettore `vettore_ultima'
address@hidden example
+
address@hidden
+Oops!
+
address@hidden
+gawk> @kbd{p vettore_ultima[1]}
address@hidden vettore_ultima["1"] = "awk,"
address@hidden example
+
+Questo metodo sarebbe piuttosto lento per un vettore con 100 elementi, per cui
address@hidden fornisce una scorciatoia (che fa venire in mente un altro
+linguaggio che non nominiamo):
+
address@hidden
+gawk> @kbd{p @@vettore_ultima}
address@hidden vettore_ultima["1"] = "awk,"
address@hidden vettore_ultima["2"] = "ecco"
address@hidden vettore_ultima["3"] = "un"
address@hidden vettore_ultima["4"] = "programma"
address@hidden vettore_ultima["5"] = "meraviglioso!"
address@hidden example
+
+Finora, sembra che tutto vada bene. Facciamo un altro passo,
+o anche due:
+
address@hidden
+gawk> @kbd{n}
address@hidden 69 campi_ultima = join(vettore_ultima,
contatore_file, n)
+gawk> @kbd{n}
address@hidden 70 campi_corrente = join(vettore_corrente,
contatore_file, m)
address@hidden example
+
+Bene, eccoci arrivati al nostro errore (ci spiace di aver rovinato la
+sorpresa).
+Quel che avevamo in mente era di unire i campi a partire dal secondo per
+creare il record virtuale da confrontare, e se il primo campo aveva il numero
+zero, questo avrebbe funzionato. Vediamo quel che abbiamo finora:
+
address@hidden
+gawk> @kbd{p campi_ultima campi_corrente}
address@hidden campi_ultima = "awk, ecco un programma meraviglioso!"
address@hidden campi_corrente = "gawk, ecco un programma meraviglioso!"
address@hidden example
+
+Ehi! queste frasi suonano piuttosto familiari! Sono esattamente i nostri
+record di input originali, inalterati. Pensandoci un po' (il cervello umano
@`e
+ancora il miglior strumento di debug), ci si rende conto che eravamo fuori di
+uno!
+
+Usciamo dal debugger:
+
address@hidden
+gawk> @kbd{q}
address@hidden Il programma @`e in esecuzione. Esco comunque (y/n)? @kbd{y}
address@hidden example
+
address@hidden
+Quindi modifichiamo con un editore di testo:
+
address@hidden
+campi_ultima = join(vettore_ultima, contatore_file+1, n)
+campi_corrente = join(vettore_corrente, contatore_file+1, m)
address@hidden example
+
address@hidden
+e il problema @`e risolto!
+
address@hidden Lista dei comandi di debug
address@hidden I principali comandi di debug
+
+L'insieme dei comandi del debugger di @command{gawk} address@hidden essere
diviso nelle
+seguenti categorie:
+
address@hidden @value{BULLET}
+
address@hidden
+Controllo di punti d'interruzione
+
address@hidden
+Controllo di esecuzione
+
address@hidden
+Vedere e modificare dati
+
address@hidden
+Lavorare con le pile
+
address@hidden
+Ottenere informazioni
+
address@hidden
+Comandi vari
address@hidden itemize
+
+Ciascuna di esse @`e trattata nelle sottosezioni che seguono.
+Nelle descrizioni seguenti, i comandi che possono essere abbreviati
+mostrano l'abbreviazione su una seconda riga di descrizione.
+Un nome di comando del debugger address@hidden essere anche troncato se la
parte address@hidden scritta
+non @`e ambigua. Il debugger ha la address@hidden predefinita di ripetere
+automaticamente il precedente comando semplicemente battendo @kbd{Invio}.
+Questo vale per i comandi @code{list}, @code{next}, @code{nexti},
address@hidden, @code{stepi} e @code{continue} quando sono eseguiti senza
+argomenti.
+
address@hidden
+* Controllo dei breakpoint:: Controllo dei punti d'interruzione.
+* Controllo esecuzione debugger:: Controllo di esecuzione.
+* Vedere e modificare dati:: Vedere e modificare dati.
+* Stack di esecuzione:: Lavorare con le pile.
+* Informazioni sul debugger:: Ottenere informazioni sullo stato del
+ programma e del debugger.
+* Comandi vari del debugger:: Comandi vari del debugger.
address@hidden menu
+
address@hidden Controllo dei breakpoint
address@hidden Controllo dei punti d'interruzione
+
+Come abbiamo address@hidden visto, la prima cosa che si dovrebbe fare in una
sessione di
+debug @`e quella di definire dei punti d'interruzione, poich@'e altrimenti il
+programma address@hidden eseguito come se non fosse sotto il debugger. I
comandi per
+controllare i punti d'interruzione sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{b} (alias per @code{break})
address@hidden comando del debugger, @code{break}
address@hidden @code{break}, comando del debugger
address@hidden @code{b}, comando del debugger (alias per @code{break})
address@hidden impostare un punto d'interruzione
address@hidden breakpoint, impostare
address@hidden punto d'interruzione (breakpoint), impostare
address@hidden @code{break} address@hidden@code{:address@hidden |
@var{funzione}] address@hidden"@var{espressione}"}]
address@hidden @code{b} address@hidden@code{:address@hidden | @var{funzione}]
address@hidden"@var{espressione}"}]
+Senza argomenti, imposta un punto d'interruzione alla prossima istruzione
+da eseguire nello @dfn{stack frame} selezionato.
+Gli argomenti possono essere uno dei seguenti:
+
address@hidden @asis for docbook
address@hidden nested table
address@hidden @asis
address@hidden @var{n}
+Imposta un punto d'interruzione alla riga numero @var{n} nel file sorgente
+corrente.
+
address@hidden @address@hidden:address@hidden
+Imposta un punto d'interruzione alla riga numero @var{n} nel file sorgente
address@hidden
+
address@hidden @var{funzione}
+Imposta un punto d'interruzione all'ingresso (la prima istruzione eseguibile)
+della funzione @var{funzione}.
address@hidden table
+
+A ogni punto d'interruzione @`e assegnato un numero che address@hidden essere
usato per
+cancellarlo dalla lista dei punti d'interruzione usando il comando
address@hidden
+
+Specificando un punto d'interruzione, si address@hidden fornire anche una
condizione.
+Questa @`e
+un'espressione @command{awk} (racchiusa tra doppi apici) che il debugger
+valuta ogni volta che viene raggiunto quel punto d'interruzione. Se la
+condizione @`e vera, il debugger ferma l'esecuzione e rimane in attesa di un
+comando. Altrimenti, continua l'esecuzione del programma.
+
address@hidden comando del debugger, @code{clear}
address@hidden @code{clear}, comando del debugger
address@hidden cancellare punto d'interruzione da una determinata posizione
address@hidden punto d'interruzione in una determinata posizione, come
cancellare
address@hidden breakpoint, come cancellare
address@hidden @code{clear} address@hidden@code{:address@hidden |
@var{funzione}]
+Senza argomenti, cancella ogni eventuale punto d'interruzione all'istruzione
+successiva
+da eseguirsi nello @dfn{stack frame} selezionato. Se il programma si ferma in
+un punto d'interruzione, quel punto d'interruzione viene cancellato in modo
+che il programma non si fermi address@hidden in quel punto.
+Gli argomenti possono essere uno tra i seguenti:
+
address@hidden nested table
address@hidden @asis
address@hidden @var{n}
+Cancella il punto (o i punti) d'interruzione impostato/i alla riga @var{n} nel
+file sorgente corrente.
+
address@hidden @address@hidden:address@hidden
+Cancella il punto (o i punti) d'interruzione impostato/i alla riga @var{n} nel
+file sorgente @var{nome-file}.
+
address@hidden @var{funzione}
+Cancella il punto (o i punti) d'interruzione impostato/i all'ingresso della
+funzione @var{funzione}.
address@hidden table
+
address@hidden comando del debugger, @code{condition}
address@hidden @code{condition}, comando del debugger
address@hidden condizione dei punti d'interruzione
address@hidden @code{condition} @var{n} @code{"@var{espressione}"}
+Aggiunge una condizione al punto d'interruzione o al punto d'osservazione
+esistente @var{n}. La condizione @`e un'espressione @command{awk}
address@hidden tra doppi apici} che il debugger valuta ogni volta che viene
+raggiunto il punto d'interruzione o il punto d'osservazione. Se la condizione
@`e
+vera, il debugger ferma l'esecuzione e attende l'immissione di un comando.
+Altrimenti, il debugger continua l'esecuzione del programma. Se l'espressione
+della condizione non viene specificata, tutte le condizioni esistenti vengono
+rimosse (address@hidden, il punto d'interruzione o di osservazione viene
considerato
+incondizionato).
+
address@hidden comando del debugger, @code{d} (alias per @code{delete})
address@hidden comando del debugger, @code{delete}
address@hidden @code{delete}, comando del debugger
address@hidden @code{d}, comando del debugger (alias per @code{delete})
address@hidden cancellare punto d'interruzione per numero
address@hidden punto d'interruzione, cancellare per numero
address@hidden @code{delete} address@hidden n2} @dots{}] address@hidden@var{m}]
address@hidden @code{d} address@hidden n2} @dots{}] address@hidden@var{m}]
+Cancella i punti d'interruzione specificati o un intervallo di punti
+d'interruzione. Se non vengono forniti argomenti, cancella tutti i
+punti d'interruzione esistenti.
+
address@hidden comando del debugger, @code{disable}
address@hidden @code{disable}, comando del debugger
address@hidden disabilitare punto d'interruzione
address@hidden punto d'interruzione, come disabilitare o abilitare
address@hidden @code{disable} address@hidden n2} @dots{} | @address@hidden
+Disabilita punti d'interruzione specificati o un intervallo di essi. Senza
+argomenti, disabilita tutti i punti d'interruzione.
+
address@hidden comando del debugger, @code{e} (alias per @code{enable})
address@hidden comando del debugger, @code{enable}
address@hidden @code{enable}, comando del debugger
address@hidden @code{e}, comando del debugger (alias per @code{enable})
address@hidden abilitare un punto d'interruzione
address@hidden @code{enable} address@hidden | @code{once}] address@hidden n2}
@dots{}] address@hidden@var{m}]
address@hidden @code{e} address@hidden | @code{once}] address@hidden n2}
@dots{}] address@hidden@var{m}]
+Abilita specifici punti d'interruzione o un intervallo di essi. Senza
+argomenti, abilita tutti i punti d'interruzione.
+Opzionalmente, si address@hidden specificare come abilitare i punti
d'interruzione:
+
address@hidden nested table
address@hidden @code
address@hidden del
+Abilita dei punti d'interruzione @dfn{una tantum}, poi li cancella quando il
+programma si ferma in quel punto.
+
address@hidden once
+Abilita dei punti d'interruzione @dfn{una tantum}, poi li cancella quando il
+programma si ferma in quel punto.
address@hidden table
+
address@hidden comando del debugger, @code{ignore}
address@hidden @code{ignore}, comando del debugger
address@hidden ignorare un punto d'interruzione
address@hidden @code{ignore} @var{n} @var{contatore}
+Ignora il punto d'interruzione numero @var{n} le successive
address@hidden volte in cui viene raggiunto.
+
address@hidden comando del debugger, @code{t} (alias per @code{tbreak})
address@hidden comando del debugger, @code{tbreak}
address@hidden @code{tbreak}, comando del debugger
address@hidden @code{t}, comando del debugger (alias per @code{tbreak})
address@hidden punto d'interruzione temporaneo
address@hidden temporaneo, punto d'interruzione
address@hidden @code{tbreak} address@hidden@code{:address@hidden |
@var{funzione}]
address@hidden @code{t} address@hidden@code{:address@hidden | @var{funzione}]
+Imposta un punto d'interruzione temporaneo (abilitato solo per la prima volta
+che viene raggiunto). Gli argomenti sono gli stessi di @code{break}.
address@hidden table
+
address@hidden Controllo esecuzione debugger
address@hidden Controllo di esecuzione
+
+Dopo che i punti d'interruzione sono pronti, si address@hidden iniziare
l'esecuzione del
+programma, osservando il suo comportamento. Ci sono address@hidden comandi per
+controllare l'esecuzione del programma di quelli visti nei precedenti esempi:
+
address@hidden @asis
address@hidden comando del debugger, @code{commands}
address@hidden @code{commands}, comando del debugger
address@hidden comando del debugger, @code{silent}
address@hidden @code{silent}, comando del debugger
address@hidden comando del debugger, @code{end}
address@hidden @code{end}, comando del debugger
address@hidden punto d'interruzione, comandi
address@hidden comandi da eseguire al punto d'interruzione
address@hidden @code{commands} address@hidden
address@hidden @code{silent}
address@hidden @dots{}
address@hidden @code{end}
+Imposta una lista di comandi da eseguire subito dopo l'arresto del programma in
+un punto d'interruzione o di osservazione. @var{n} @`e il numero del punto
+d'interruzione o di osservazione. Se non si specifica un numero, viene usato
+l'ultimo numero che @`e stato specificato. I comandi veri e propri seguono,
+a cominciare dalla riga successiva, e hanno termine col comando @code{end}.
+Se il comando @code{silent} @`e nella lista, i consueti messaggi sull'arresto
del
+programma a un punto d'interruzione e la riga sorgente non vengono stampati.
+Qualsiasi comando nella lista che riprende l'esecuzione (p.es.,
address@hidden) pone fine alla lista (un @code{end} implicito), e i comandi
+successivi vengono ignorati.
+Per esempio:
+
address@hidden
+gawk> @kbd{commands}
+> @kbd{silent}
+> @kbd{printf "Un punto d'interruzione silenzioso; i = %d\n", i}
+> @kbd{info locals}
+> @kbd{set i = 10}
+> @kbd{continue}
+> @kbd{end}
+gawk>
address@hidden example
+
address@hidden comando del debugger, @code{c} (alias per @code{continue})
address@hidden comando del debugger, @code{continue}
address@hidden @code{continue}, comando del debugger
address@hidden @code{continue} address@hidden
address@hidden @code{c} address@hidden
+Riprende l'esecuzione del programma. Se si riparte da un punto d'interruzione
+e viene specificato @var{contatore}, il punto d'interruzione in quella
+posizione viene ignorato per le prossime @var{contatore} volte prima di
+fermarsi nuovamente.
+
address@hidden comando del debugger, @code{finish}
address@hidden @code{finish}, comando del debugger
address@hidden @code{finish}
+Esegue fino a quando lo stack frame selezionato completa l'esecuzione.
+Stampa il valore restituito.
+
address@hidden comando del debugger, @code{n} (alias per @code{next})
address@hidden comando del debugger, @code{next}
address@hidden @code{next}, comando del debugger
address@hidden @code{n}, comando del debugger (alias per @code{next})
address@hidden esecuzione di un solo passo, nel debugger
address@hidden @code{next} address@hidden
address@hidden @code{n} address@hidden
+Continua l'esecuzione alla successiva riga sorgente, saltando le chiamate di
+funzione. L'argomento @var{contatore} controlla il numero di ripetizioni
+dell'azione, come in @code{step}.
+
address@hidden comando del debugger, @code{ni} (alias per @code{nexti})
address@hidden comando del debugger, @code{nexti}
address@hidden @code{nexti}, comando del debugger
address@hidden @code{ni}, comando del debugger (alias for @code{nexti})
address@hidden @code{nexti} address@hidden
address@hidden @code{ni} address@hidden
+Esegue una o @var{contatore} istruzioni, comprese le chiamate di funzione.
+
address@hidden comando del debugger, @code{return}
address@hidden @code{return}, comando del debugger
address@hidden @code{return} address@hidden
+Cancella l'esecuzione di una chiamata di funzione. Se @var{valore} (una
+stringa o un numero) viene specificato, @`e usato come valore di ritorno della
+funzione. Se usato in un frame diverso da quello address@hidden interno (la
funzione
+correntemente in esecuzione; address@hidden, il frame numero 0), ignora tutti
i frame
address@hidden interni di quello selezionato, e il chiamante del frame
selezionato
+diventa il frame address@hidden interno.
+
address@hidden comando del debugger, @code{r} (alias per @code{run})
address@hidden comando del debugger, @code{run}
address@hidden @code{run}, comando del debugger
address@hidden @code{r}, comando del debugger (alias per @code{run})
address@hidden @code{run}
address@hidden @code{r}
+Avvia/riavvia l'esecuzione del programma. Quando il programma viene riavviato,
+il debugger mantiene i punti d'interruzione e di osservazione, la cronologia
+dei comandi, la visualizzazione automatica di variabili, e le opzioni del
+debugger.
+
address@hidden comando del debugger, @code{s} (alias per @code{step})
address@hidden comando del debugger, @code{step}
address@hidden @code{step}, comando del debugger
address@hidden @code{s}, comando del debugger (alias per @code{step})
address@hidden @code{step} address@hidden
address@hidden @code{s} address@hidden
+Continua l'esecuzione finch@'e il controllo non raggiunge una diversa riga del
+sorgente nello @dfn{stack frame} corrente, eseguendo ogni funzione chiamata
+all'interno della riga. Se viene fornito l'argomento @var{contatore},
+esegue il numero di istruzioni specificate prima di fermarsi, a meno che non
+s'imbatta in un punto d'interruzione o di osservazione.
+
address@hidden comando del debugger, @code{si} (alias per @code{stepi})
address@hidden comando del debugger, @code{stepi}
address@hidden @code{stepi}, comando del debugger
address@hidden @code{si}, comando del debugger (alias per @code{stepi})
address@hidden @code{stepi} address@hidden
address@hidden @code{si} address@hidden
+Esegue una o @var{contatore} istruzioni, comprese le chiamate di funzione.
+(Per una spiegazione su cosa s'intende per ``istruzione'' in @command{gawk},
+si veda l'output mostrato sotto @code{dump} nella
address@hidden vari del debugger}.)
+
address@hidden comando del debugger, @code{u} (alias per @code{until})
address@hidden comando del debugger, @code{until}
address@hidden @code{until}, comando del debugger
address@hidden @code{u}, comando del debugger (alias per @code{until})
address@hidden @code{until} address@hidden@code{:address@hidden |
@var{funzione}]
address@hidden @code{u} address@hidden@code{:address@hidden | @var{funzione}]
+Senza argomenti, prosegue l'esecuzione finch@'e non viene raggiunta una riga
+dopo la riga corrente nello @dfn{stack frame} corrente.
+Se viene specificato un argomento,
+prosegue l'esecuzione finch@'e non viene raggiunto il punto specificato, o
+lo @dfn{stack frame} corrente non termina l'esecuzione.
address@hidden table
+
address@hidden Vedere e modificare dati
address@hidden Vedere e modificare dati
+
+I comandi per vedere e modificare variabili all'interno di @command{gawk} sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{display}
address@hidden @code{display}, comando del debugger
address@hidden @code{display} address@hidden | @address@hidden
+Aggiunge la variabile @var{var} (o il campo @address@hidden) alla lista di
+visualizzazione. Il valore della variabile o del campo @`e visualizzato ogni
+volta che il programma s'interrompe.
+Ogni variabile aggiunta alla lista @`e identificata da un numero univoco:
+
address@hidden
+gawk> @kbd{display x}
address@hidden 10: x = 1
address@hidden example
+
address@hidden
+La riga qui sopra mostra il numero di elemento assegnato, il nome della
+variabile e il suo
+valore corrente. Se la variabile di display fa riferimento a un parametro di
+funzione, @`e cancellata silenziosamente dalla lista non appena l'esecuzione
+raggiunge un contesto dove la variabile con quel nome non esiste address@hidden
+Senza argomenti, @code{display} mostra i valori correnti degli elementi della
+lista.
+
address@hidden comando del debugger, @code{eval}
address@hidden @code{eval}, comando del debugger
address@hidden valutare espressioni, nel debugger
address@hidden @code{eval "@var{istruzioni awk}"}
+Valuta @var{istruzioni awk} nel contesto del programma in esecuzione.
+Si address@hidden fare qualsiasi cosa che un programma @command{awk} farebbe:
assegnare
+valori a variabili, chiamare funzioni, e address@hidden@dotless{i}} via.
+
address@hidden @code{eval} @var{param}, @dots{}
address@hidden @var{istruzioni awk}
address@hidden @code{end}
+Questa forma di @code{eval} @`e simile alla precedente, solo che permette di
+definire
+``variabili locali'' che esistono nel contesto delle @var{istruzioni awk},
+invece di usare variabili o parametri di funzione address@hidden definiti nel
programma.
+
address@hidden comando del debugger, @code{p} (alias per @code{print})
address@hidden comando del debugger, @code{print}
address@hidden @code{print}, comando del debugger
address@hidden @code{p}, comando del debugger (alias per @code{print})
address@hidden stampare variabili, nel debugger
address@hidden @code{print} @address@hidden,} @var{var2} @dots{}]
address@hidden @code{p} @address@hidden,} @var{var2} @dots{}]
+Stampa i valori di una o address@hidden variabili o campi di @command{gawk}.
+I campi devono essere indicizzati usando delle costanti:
+
address@hidden
+gawk> @kbd{print $3}
address@hidden example
+
address@hidden
+Questo stampa il terzo campo del record di input (se il campo specificato non
+esiste, stampa il @samp{campo nullo}). Una variabile address@hidden essere un
elemento di
+un vettore, avente come indice una
+stringa di valore costante. Per stampare
+il contenuto di un vettore, si deve anteporre il simbolo @samp{@@} al nome del
+vettore:
+
address@hidden
+gawk> @kbd{print @@a}
address@hidden example
+
address@hidden
+L'esempio stampa gli indici e i corrispondenti valori di tutti gli elementi
+del vettore @code{a}.
+
address@hidden comando del debugger, @code{printf}
address@hidden @code{printf}, comando del debugger
address@hidden @code{printf} @var{formato} address@hidden,} @var{arg} @dots{}]
+Stampa un testo formattato. Il @var{formato} address@hidden includere sequenze
di
+protezione, come @samp{\n}
+(@pxref{Sequenze di protezione}).
+Non viene stampato nessun ritorno a capo che non sia stato specificato
+esplicitamente.
+
address@hidden comando del debugger, @code{set}
address@hidden @code{set}, comando del debugger
address@hidden assegnare valori a variabili, nel debugger
address@hidden @code{set} @address@hidden@var{valore}
+Assegna un valore costante (numero o stringa) a una variabile o a un campo di
address@hidden
+I valori di stringa devono essere racchiusi tra doppi apici
+(@code{"address@hidden@code{"}).
+
+Si possono impostare anche delle variabili speciali di @command{awk}, come
address@hidden, @code{NF}, @code{NR}, e address@hidden@dotless{i}} via.
+
address@hidden comando del debugger, @code{w} (alias per @code{watch})
address@hidden comando del debugger, @code{watch}
address@hidden @code{watch}, comando del debugger
address@hidden @code{w}, comando del debugger (alias per @code{watch})
address@hidden impostare un punto d'osservazione
address@hidden @code{watch} @var{var} | @address@hidden
address@hidden"@var{espressione}"}]
address@hidden @code{w} @var{var} | @address@hidden
address@hidden"@var{espressione}"}]
+Aggiunge la variabile @var{var} (o il campo @address@hidden) alla lista dei
+punti d'osservazione. Il debugger quindi interrompe il programma ogni volta
+che il valore della variabile o del campo cambia. A ogni elemento osservato
+viene assegnato un numero che address@hidden essere usato per cancellarlo
dalla lista
+usando il comando @code{unwatch} [non-osservare address@hidden
+
+Definendo un punto d'osservazione, si address@hidden anche porre una
condizione, che @`e
+un'espressione @command{awk} (racchiusa tra doppi apici) che il debugger valuta
+ogni volta che viene raggiunto il punto d'osservazione. Se la condizione @`e
+vera, il debugger interrompe l'esecuzione e rimane in attesa di un comando.
+Altrimenti, @command{gawk} prosegue nell'esecuzione del programma.
+
address@hidden comando del debugger, @code{undisplay}
address@hidden @code{undisplay}, comando del debugger
address@hidden interruzione visualizzazioni automatiche, nel debugger
address@hidden @code{undisplay} address@hidden
+Rimuove l'elemento numero @var{n} (o tutti gli elementi, se non vi sono
+argomenti) dalla lista delle visualizzazioni automatiche.
+
address@hidden comando del debugger, @code{unwatch}
address@hidden @code{unwatch}, comando del debugger
address@hidden cancellare punto d'osservazione
address@hidden @code{unwatch} address@hidden
+Rimuove l'elemento numero @var{n} (o tutti gli elementi, se non vi sono
+argomenti) dalla lista dei punti d'osservazione.
+
address@hidden table
+
address@hidden Stack di esecuzione
address@hidden Lavorare con lo stack
+
+Ogni volta che si esegue un programma che contiene chiamate di funzione,
address@hidden mantiene una pila contenente la lista delle chiamate di funzione
+che hanno portato al punto in cui il programma si trova in ogni momento. @`E
+possibile vedere a che punto si trova il programma, e anche muoversi
+all'interno della pila per vedere qual era lo stato delle cose nelle funzioni
+che hanno chiamato quella in cui ci si trova. I comandi per far questo sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{bt} (alias per @code{backtrace})
address@hidden comando del debugger, @code{backtrace}
address@hidden comando del debugger, @code{where} (alias per @code{backtrace})
address@hidden @code{backtrace}, comando del debugger
address@hidden @code{bt}, comando del debugger (alias per @code{backtrace})
address@hidden @code{where}, comando del debugger
address@hidden @code{where}, comando del debugger (alias per @code{backtrace})
address@hidden chiamate, @dfn{stack} (pila) delle, mostrare nel debugger
address@hidden @dfn{stack} (pila) delle chiamate, mostrare nel debugger
address@hidden pila (@dfn{stack}) delle chiamate, mostrare nel debugger
address@hidden tracciatura a ritroso, mostrare nel debugger
address@hidden @code{backtrace} address@hidden
address@hidden @code{bt} address@hidden
address@hidden @code{where} address@hidden
+Stampa a ritroso una traccia di tutte le chiamate di funzione (stack frame), o
+i dei @var{contatore} frame address@hidden interni se @var{contatore} > 0.
Stampa i
address@hidden frame address@hidden esterni se @var{contatore} < 0. La
tracciatura a
+ritroso mostra il nome e gli argomenti di ciascuna funzione, il sorgente
address@hidden, e il numero di riga. L'alias @code{where} per @code{backtrace}
+viene mantenuto per i vecchi utenti di GDB che potrebbero essere abituati a
+quel comando.
+
address@hidden comando del debugger, @code{down}
address@hidden @code{down}, comando del debugger
address@hidden @code{down} address@hidden
+Sposta @var{contatore} (default 1) frame sotto la pila verso il frame
address@hidden interno.
+Poi seleziona e stampa il frame.
+
address@hidden comando del debugger, @code{f} (alias per @code{frame})
address@hidden comando del debugger, @code{frame}
address@hidden @code{frame}, comando del debugger
address@hidden @code{f}, comando del debugger (alias per @code{frame})
address@hidden @code{frame} address@hidden
address@hidden @code{f} address@hidden
+Seleziona e stampa lo @dfn{stack frame} @var{n}. Il frame 0 @`e quello
+correntemente in esecuzione, o il frame @address@hidden interno}, (chiamata di
+funzione); il frame 1 @`e il frame che ha chiamato quello address@hidden
interno. Il frame
+col numero address@hidden alto @`e quello per il programma principale. Le
informazioni
+stampate comprendono il numero di frame, i nomi delle funzioni e degli
+argomenti, i file sorgenti e le righe sorgenti.
+
address@hidden comando del debugger, @code{up}
address@hidden @code{up}, comando del debugger
address@hidden @code{up} address@hidden
+Sposta @var{contatore} (default 1) frame sopra la pila verso il frame
address@hidden
+esterno. Poi seleziona e stampa il frame.
address@hidden table
+
address@hidden Informazioni sul debugger
address@hidden Ottenere informazioni sullo stato del programma e del debugger
+
+Oltre che vedere i valori delle variabili, spesso si ha address@hidden di
ottenere
+informazioni di altro tipo sullo stato del programma e dello stesso ambiente di
+debug. Il debugger di @command{gawk} ha un comando che fornisce
+quest'informazione, chiamato convenientemente @code{info}. @code{info}
address@hidden usato con uno dei tanti argomenti che dicono esattamente quel
che si vuol
+sapere:
+
address@hidden @asis
address@hidden comando del debugger, @code{i} (alias per @code{info})
address@hidden comando del debugger, @code{info}
address@hidden @code{info}, comando del debugger
address@hidden @code{i}, comando del debugger (alias per @code{info})
address@hidden @code{info} @var{cosa}
address@hidden @code{i} @var{cosa}
+Il valore di @var{cosa} dovrebbe essere uno dei seguenti:
+
address@hidden nested table
address@hidden @code
address@hidden args
address@hidden mostrare argomenti delle funzioni, nel debugger
address@hidden debugger, mostrare argomenti delle funzioni
+Elenca gli argomenti del frame selezionato.
+
address@hidden break
address@hidden mostrare punti d'interruzione, nel debugger
address@hidden debugger, mostrare punti d'interruzione
+Elenca tutti i punti d'interruzione attualmente impostati.
+
address@hidden display
address@hidden visualizzazioni automatiche, nel debugger
address@hidden debugger, visualizzazioni automatiche
+Elenca tutti gli elementi della lista delle visualizzazioni automatiche.
+
address@hidden frame
address@hidden descrizione degli @dfn{stack frame} delle chiamate, nel debugger
address@hidden debugger, descrizione degli @dfn{stack frame} delle chiamate
address@hidden una descrizione degli @dfn{stack frame} selezionati.
+
address@hidden functions
address@hidden elencare definizioni delle funzioni, nel debugger
address@hidden debugger, elencare definizioni delle funzioni
+Elenca tutte le definizioni delle funzioni compresi i @value{FNS} e
+i numeri di riga.
+
address@hidden locals
address@hidden mostrare variabili locali, nel debugger
address@hidden debugger, mostrare variabili locali
+Elenca le variabili locali dei frame selezionati.
+
address@hidden source
address@hidden mostrare il nome del file sorgente corrente, nel debugger
address@hidden debugger, mostrare il nome del file sorgente corrente
+Stampa il nome del file sorgente corrente. Ogni volta che il programma si
+interrompe, il file sorgente corrente @`e il file che contiene l'istruzione
+corrente. Quando il debugger viene avviato per la prima volta, il file
+sorgente corrente @`e il primo file incluso attraverso l'opzione @option{-f}.
+Il comando @samp{list @var{nome-file}:@var{numero-riga}} address@hidden essere
usato in
+qualsiasi momento per cambiare il sorgente corrente.
+
address@hidden sources
address@hidden mostrare tutti i file sorgente, nel debugger
address@hidden debugger, mostrare tutti i file sorgenti
+Elenca tutti i sorgenti del programma.
+
address@hidden variables
address@hidden elencare tutte le variabili locali, nel debugger
address@hidden debugger, elencare tutte le variabili locali
+Elenca tutte le variabili locali.
+
address@hidden watch
address@hidden mostrare i punti d'osservazione, nel debugger
address@hidden debugger, mostrare i punti d'osservazione
+Elenca tutti gli elementi della lista dei punti d'osservazione.
address@hidden table
address@hidden table
+
+Ulteriori comandi permettono di avere il controllo sul debugger, la
address@hidden di
+salvare lo stato del debugger e la address@hidden di eseguire comandi del
debugger
+da un file. I comandi sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{o} (alias per @code{option})
address@hidden comando del debugger, @code{option}
address@hidden @code{option}, comando del debugger
address@hidden @code{o}, comando del debugger (alias per @code{option})
address@hidden visualizzare le opzioni del debugger
address@hidden debugger, opzioni del
address@hidden @code{option} address@hidden@address@hidden
address@hidden @code{o} address@hidden@address@hidden
+Senza argomenti, visualizza le opzioni del debugger disponibili e i loro valori
+correnti. @samp{option @var{nome}} mostra il valore corrente dell'opzione
address@hidden@dotless{i}} denominata. @samp{option @address@hidden assegna
+un nuovo valore all'opzione.
+Le opzioni disponibili sono:
+
address@hidden nested table
address@hidden asis for docbook
address@hidden @asis
address@hidden @code{history_size}
address@hidden debugger, dimensione della cronologia
+Imposta il numero massimo di righe da mantenere nel file della cronologia
address@hidden/.gawk_history}. Il valore di default @`e 100.
+
address@hidden @code{listsize}
address@hidden debugger, numero di righe nella lista di default
+Specifica il numero di righe che @code{list} deve stampare. Il valore di
+default @`e 15.
+
address@hidden @code{outfile}
address@hidden ridirezionare l'output di @command{gawk}, nel debugger
address@hidden debugger, ridirezionare l'output di @command{gawk}
+Invia l'output di @command{gawk} in un file; l'output del debugger @`e
+visualizzato comunque anche
+nello standard output. Assegnare come valore stringa vuota (@code{""})
+reimposta l'output solo allo standard output.
+
address@hidden @code{prompt}
address@hidden debugger, prompt
+Cambia la riga per l'immissione dei comandi del debugger. Il valore di
+default @`e @address@hidden> }}.
+
address@hidden @code{save_history} address@hidden | @code{off}]
address@hidden debugger, file della cronologia
+Salva la cronologia dei comandi nel file @file{./.gawk_history}.
+L'impostazione di default @`e @code{on}.
+
address@hidden @code{save_options} address@hidden | @code{off}]
address@hidden salvataggio opzioni debugger
address@hidden debugger, salvataggio opzioni
+Salva le opzioni correnti nel file @file{./.gawkrc} all'uscita.
+L'impostazione di default @`e @code{on}.
+Le opzioni sono lette di nuovo all'avvio della sessione successiva.
+
address@hidden @code{trace} address@hidden | @code{off}]
address@hidden istruzioni, tener traccia delle, nel debugger
address@hidden debugger, tener traccia delle istruzioni
+Attiva o disattiva il tracciamento delle istruzioni. L'impostazione di default
address@hidden @code{off}.
address@hidden table
+
address@hidden @code{save} @var{nome-file}
+Salva i comandi eseguiti nella sessione corrente nel @value{FN} indicato,
+in modo da poterli ripetere in seguito usando il comando @command{source}.
+
address@hidden @code{source} @var{nome-file}
address@hidden debugger, leggere comandi da un file
+Esegue comandi contenuti in un file; un errore in un comando non impedisce
+l'esecuzione dei comandi successivi. In un file di comandi sono consentiti
+i commenti (righe che iniziano con @samp{#}).
+Le righe vuote vengono ignorate; esse @emph{non}
+ripetono l'ultimo comando.
+Non si address@hidden riavviare il programma mettendo address@hidden di un
comando @code{run}
+nel file. Inoltre, la lista dei comandi address@hidden includere altri comandi
address@hidden; in ogni caso, il debugger di @command{gawk} non richiama lo
+stesso file address@hidden di una volta per evitare ricorsioni infinite.
+
+Oltre al comando @code{source}, o al posto di esso, si possono usare le opzioni
+sulla riga di comando @option{-D @var{file}} o @address@hidden
+per eseguire comandi da un file in maniera non interattiva
+(@pxref{Opzioni}).
address@hidden table
+
address@hidden Comandi vari del debugger
address@hidden Comandi vari del debugger
+
+Ci sono alcuni altri comandi che non rientrano nelle precedenti categorie,
+come i seguenti:
+
address@hidden @asis
address@hidden comando del debugger, @code{dump}
address@hidden @code{dump}, comando del debugger
address@hidden @code{dump} address@hidden
+Riversa il @dfn{byte code} del programma nello standard output o nel file
+definito in @var{nome-file}. Questo stampa una rappresentazione delle
+istruzioni interne che @command{gawk} esegue per implementare i comandi
address@hidden in un programma. address@hidden address@hidden essere molto
istruttivo, come
+dimostra il seguente riversamento parziale del codice offuscato di
+Davide Brini (@pxref{Programma signature}):
+
address@hidden FIXME: This will need updating if num-handler branch is ever
merged in.
address@hidden
+gawk> @kbd{dump}
address@hidden # BEGIN
address@hidden
address@hidden [ 1:0xfcd340] Op_rule : [in_rule = BEGIN]
[source_file = brini.awk]
address@hidden [ 1:0xfcc240] Op_push_i : "~" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc2a0] Op_push_i : "~" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc280] Op_match :
address@hidden [ 1:0xfcc1e0] Op_store_var : O
address@hidden [ 1:0xfcc2e0] Op_push_i : "==" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc340] Op_push_i : "==" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc320] Op_equal :
address@hidden [ 1:0xfcc200] Op_store_var : o
address@hidden [ 1:0xfcc380] Op_push : o
address@hidden [ 1:0xfcc360] Op_plus_i : 0 [MALLOC|NUMCUR|NUMBER]
address@hidden [ 1:0xfcc220] Op_push_lhs : o [do_reference = true]
address@hidden [ 1:0xfcc300] Op_assign_plus :
address@hidden [ :0xfcc2c0] Op_pop :
address@hidden [ 1:0xfcc400] Op_push : O
address@hidden [ 1:0xfcc420] Op_push_i : "" [MALLOC|STRING|STRCUR]
address@hidden [ :0xfcc4a0] Op_no_op :
address@hidden [ 1:0xfcc480] Op_push : O
address@hidden [ :0xfcc4c0] Op_concat : [expr_count = 3] [concat_flag
= 0]
address@hidden [ 1:0xfcc3c0] Op_store_var : x
address@hidden [ 1:0xfcc440] Op_push_lhs : X [do_reference = true]
address@hidden [ 1:0xfcc3a0] Op_postincrement :
address@hidden [ 1:0xfcc4e0] Op_push : x
address@hidden [ 1:0xfcc540] Op_push : o
address@hidden [ 1:0xfcc500] Op_plus :
address@hidden [ 1:0xfcc580] Op_push : o
address@hidden [ 1:0xfcc560] Op_plus :
address@hidden [ 1:0xfcc460] Op_leq :
address@hidden [ :0xfcc5c0] Op_jmp_false : [target_jmp = 0xfcc5e0]
address@hidden [ 1:0xfcc600] Op_push_i : "%c" [MALLOC|STRING|STRCUR]
address@hidden [ :0xfcc660] Op_no_op :
address@hidden [ 1:0xfcc520] Op_assign_concat : c
address@hidden [ :0xfcc620] Op_jmp : [target_jmp = 0xfcc440]
address@hidden
address@hidden
address@hidden
address@hidden [ 2:0xfcc5a0] Op_K_printf : [expr_count = 17]
[redir_type = ""]
address@hidden [ :0xfcc140] Op_no_op :
address@hidden [ :0xfcc1c0] Op_atexit :
address@hidden [ :0xfcc640] Op_stop :
address@hidden [ :0xfcc180] Op_no_op :
address@hidden [ :0xfcd150] Op_after_beginfile :
address@hidden [ :0xfcc160] Op_no_op :
address@hidden [ :0xfcc1a0] Op_after_endfile :
+gawk>
address@hidden smallexample
+
address@hidden comando del debugger, @code{exit}
address@hidden @code{exit}, comando del debugger
address@hidden uscire dal debugger
address@hidden debugger, uscire dal
address@hidden @code{exit}
+Esce dal debugger.
+Si veda la voce @samp{quit}, address@hidden avanti in quest'elenco.
+
address@hidden comando del debugger, @code{h} (alias per @code{help})
address@hidden comando del debugger, @code{help}
address@hidden @code{help}, comando del debugger
address@hidden @code{h}, comando del debugger (alias per @code{help})
address@hidden @code{help}
address@hidden @code{h}
+Stampa una lista di tutti i comandi del debugger di @command{gawk} con un breve
+sommario su come usarli. @samp{help @var{comando}} stampa l'informazione sul
+comando @var{comando}.
+
address@hidden comando del debugger, @code{l} (alias per @code{list})
address@hidden comando del debugger, @code{list}
address@hidden @code{list}, comando del debugger
address@hidden @code{l}, comando del debugger (alias per @code{list})
address@hidden @code{list} address@hidden | @code{+} | @var{n} |
@address@hidden:address@hidden | @address@hidden | @var{funzione}]
address@hidden @code{l} address@hidden | @code{+} | @var{n} |
@address@hidden:address@hidden | @address@hidden | @var{funzione}]
+Stampa le righe specificate (per default 15) dal file sorgente corrente
+o il file chiamato @var{nome-file}. I possibili argomenti di @code{list}
+sono i seguenti:
+
address@hidden nested table
address@hidden @asis
address@hidden @code{-} (Meno)
+Stampa righe prima delle ultime righe stampate.
+
address@hidden @code{+}
+Stampa righe dopo le ultime righe stampate.
address@hidden senza argomenti fa la stessa cosa.
+
address@hidden @var{n}
+Stampa righe centrate attorno alla riga numero @var{n}.
+
address@hidden @address@hidden
+Stampa righe dalla numero @var{n} alla numero @var{m}.
+
address@hidden @address@hidden:address@hidden
+Stampa righe centrate attorno alla riga numero @var{n} nel file sorgente
address@hidden Questo comando address@hidden cambiare il file sorgente corrente.
+
address@hidden @var{funzione}
+Stampa righe centrate attorno all'inizio della funzione @var{function}.
+Questo comando address@hidden cambiare il file sorgente corrente.
address@hidden table
+
address@hidden comando del debugger, @code{q} (alias per @code{quit})
address@hidden comando del debugger, @code{quit}
address@hidden @code{quit}, comando del debugger
address@hidden @code{q}, comando del debugger (alias per @code{quit})
address@hidden uscire dal debugger
address@hidden debugger, uscire dal
address@hidden @code{quit}
address@hidden @code{q}
+Esce dal debugger. Fare il debug @`e divertente, ma noi tutti a volte
+dobbiamo far fronte ad altri impegni nella vita, e talvolta troviamo il bug
+e possiamo tranquillamente passare a quello successivo! Come abbiamo visto
+prima, se si sta eseguendo un programma, il debugger avverte quando si batte
address@hidden o @samp{quit}, in modo da essere sicuri di voler realmente
abbandonare
+il debug.
+
address@hidden comando del debugger, @code{trace}
address@hidden @code{trace}, comando del debugger
address@hidden @code{trace} address@hidden | @code{off}]
+Abilita o disabilita la stampa continua delle istruzioni che si stanno per
+eseguire, assieme alle righe di @command{awk} che implementano.
+L'impostazione di default @`e @code{off}.
+
address@hidden auspicabile che la maggior parte dei ``codici operativi'' (o
``opcode'')
+in queste istruzioni siano sufficientemente autoesplicativi, e l'uso di
address@hidden e @code{nexti} mentre @code{trace} @`e abilitato li
address@hidden
+familiari.
+
address@hidden table
+
address@hidden Supporto per Readline
address@hidden Supporto per Readline
address@hidden completamento dei comandi nel debugger
address@hidden espansione della cronologia, nel debugger
address@hidden debugger, completamento dei comandi nel
+
+Se @command{gawk} @`e compilato con
address@hidden://cnswww.cns.cwru.edu/php/chet/readline/readline.html, la
libreria
+GNU Readline}, ci si address@hidden avvantaggiare delle sue address@hidden
riguardanti il
+completamento dei comandi della libreria e l'espansione della cronologia. Sono
+disponibili i seguenti tipi di completamento:
+
address@hidden @asis
address@hidden Completamentto dei comandi
+Nomi dei comandi.
+
address@hidden Completamento del @value{FN} del sorgente
address@hidden dei sorgenti. I relativi comandi sono
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden Completamento di argomento
+Argomenti di un comando non numerici.
+I relativi comandi sono @code{enable} e @code{info}.
+
address@hidden Completamento del nome di variabile
+Interessa i nomi delle variabili globali, e gli argomenti di funzione nel
+contesto corrente se
+il programma @`e in esecuzione. I relativi comandi sono
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden table
+
address@hidden Limitazioni
address@hidden Limitazioni
+
+Si spera che il lettore trovi il debugger di @command{gawk} utile e piacevole
+da usare, ma come accade per ogni programma, specialmente nelle sue prime
+versioni, ha ancora delle limitazioni. Quelle di cui @`e bene essere al
corrente sono:
+
address@hidden @value{BULLET}
address@hidden
+Nella versione presente, il debugger non address@hidden una spiegazione
dettagliata
+dell'errore che
+si @`e commesso quando si immette qualcosa che il debugger ritiene sbagliato.
+La risposta invece @`e solamente @samp{syntax error}. Quando si arriva a
capire
+l'errore commesso, tuttavia, ci si address@hidden come un vero guru.
+
address@hidden
address@hidden NOTE: no comma after the ref{} on purpose, due to following
address@hidden parenthetical remark.
+Se si studiano i ``dump'' dei codici operativi
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden vari del debugger}
+(o se si ha address@hidden address@hidden con i comandi interni di
@command{gawk}),
+ci si address@hidden conto che gran parte della manipolaziona interna di dati
+in @command{gawk}, address@hidden@dotless{i}} come in molti interpreti, @`e
fatta su di una pila.
address@hidden, @code{Op_pop}, e simili sono il pane quotidiano di
+gran parte del codice di @command{gawk}.
+
+Sfortunatamente, al momento, il debugger di @command{gawk} non consente
+di esaminare i contenuti della pila.
address@hidden, i risultati intermedi della valutazione delle espressioni sono
sulla
+pila, ma non @`e possibile stamparli. Invece, possono essere stampate solo
+quelle variabili che sono state definite nel programma. Naturalmente, un
+espediente per cercare di rimediare @`e di usare address@hidden variabili
esplicite in
+fase di debug e
+poi cambiarle di nuovo per ottenere un codice forse address@hidden difficile da
+comprendere, ma address@hidden ottimizzato.
+
address@hidden
+Non c'@`e alcun modo per guardare ``dentro'' al processo della compilazione
delle
+espressioni regolari per vedere se corrispondono a quel che si intendeva.
+Come programmatore
+di @command{awk}, ci si aspetta che chi legge conosca il significato di
address@hidden/[^[:alnum:][:blank:]]/}.
+
address@hidden
+Il debugger di @command{gawk} @`e progettato per essere usato eseguendo un
+programma (con tutti i suoi parametri) dalla riga di comando, come descritto
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden del debugger}. Non c'@`e alcun modo (al momento) di modificare
+o di ``entrare dentro'' l'esecuzione di un programma.
+Questo sembra ragionevole per un linguaggio che @`e usato principalmente per
+eseguire programmi piccoli e che non richiedono molto tempo di esecuzione.
+
address@hidden
+Il debugger di @command{gawk} accetta solo codice sorgente fornito con
+l'opzione @option{-f}.
address@hidden itemize
+
address@hidden
address@hidden 11/2016: This no longer applies after all the type cleanup work
that's been done.
+C'@`e un altro punto che vale la pena di trattare. I debugger convenzionali
+vengono eseguiti in un processo (e quindi in una parte di memoria)
+separato dal programma su cui eseguono il debug (il @dfn{debuggato}, se
+si vuole).
+
+Il debugger di @command{gawk} @`e diverso; @`e parte integrante di
@command{gawk}.
address@hidden rende possibile, in rari casi, che @command{gawk} diventi un
eccellente
+dimostratore del principio d'indeterminazione di Heisenberg, secondo il quale
+il solo atto di osservare una cosa address@hidden modificarla. Si consideri il
seguente
+esempio:@footnote{Grazie a Hermann Peifer per quest'esempio.}
+
address@hidden
+$ @kbd{cat test.awk}
address@hidden @{ print typeof($1), typeof($2) @}
+$ @kbd{cat test.data}
address@hidden abc 123
+$ @kbd{gawk -f test.awk test.data}
address@hidden strnum strnum
address@hidden example
+
+Questo @`e quel che ci si aspetta: il campo data ha l'attributo STRNUM
+(@pxref{Tipi di variabile}). Ora vediamo cosa accade quando questo programma
+viene eseguito sotto il debugger:
+
address@hidden
+$ @kbd{gawk -D -f test.awk test.data}
+gawk> @kbd{w $1} @ii{Imposta un punto d'osservazione su} $1
address@hidden Watchpoint 1: $1
+gawk> @kbd{w $2} @ii{Imposta il punto d'osservazione su} $2
address@hidden Watchpoint 2: $2
+gawk> @kbd{r} @ii{Avvia il programma}
address@hidden Partenza del programma:
address@hidden Mi fermo in Rule ...
address@hidden Watchpoint 1: $1 @ii{Scatta punto d'osservazione}
address@hidden Old value: ""
address@hidden New value: "abc"
address@hidden main() a `test.awk':1
address@hidden 1 @{ print typeof($1), typeof($2) @}
+gawk> @kbd{n} @ii{Prosegui @dots{}}
address@hidden Watchpoint 2: $2 @ii{Scatta punto d'osservazione}
address@hidden Old value: ""
address@hidden New value: "123"
address@hidden main() a `test.awk':1
address@hidden 1 @{ print typeof($1), typeof($2) @}
+gawk> @kbd{n} @ii{Prende il risultato da} typeof()
address@hidden strnum number @ii{Il risultato per} $2 @ii{non @`e
corretto}
address@hidden "normally" o "abnormally" @`e in inglese senza address@hidden di
modifiche.
address@hidden Programma completato normally, valore in uscita: 0
+gawk> @kbd{quit}
address@hidden example
+
+In questo caso, la richiesta di confrontare il nuovo valore di @code{$2}
+con quello vecchio ha richiesto che @command{gawk} lo valutasse e
+stabilisse che era proprio un numero, e questo @`e riflesso nel risultato di
address@hidden()}.
+
+Casi come questi in cui il debugger non @`e trasparente rispetto all'esecuzione
+del programma dovrebbero essere rari. Nel caso che se ne trovi uno, si
+prega di segnalarlo (@pxref{Bug}).
address@hidden ignore
+
address@hidden
+Look forward to a future release when these and other missing features may
+be added, and of course feel free to try to add them yourself!
address@hidden ignore
+
address@hidden Sommario sul debug
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Raramente i programmi funzionano bene al primo colpo. Trovare gli errori
+che contengono
+viene chiamato @dfn{debugging}, e un programma che aiuta a trovarli @`e un
address@hidden @command{gawk} ha un debugger incorporato che funziona in
+modo molto simile al debugger GNU, GDB.
+
address@hidden
+I debugger possono eseguire il programma un'istruzione per volta, esaminare e
+cambiare i
+valori delle variabili e dei vettori, e fanno tante altre cose per
+permettere di comprendere cosa sta facendo effettivamente il programma in un
+dato momento (a differenza del comportamento atteso).
+
address@hidden
+Come la maggior parte dei debugger, il debugger di @command{gawk} funziona in
+termini di stack frame, e si possono inserire sia punti d'interruzione
+(interruzioni a un certo punto del codice) sia punti d'osservazione
+(interruzioni quando il valore di un dato cambia).
+
address@hidden
+La serie di comandi del debugger @`e abbastanza completa, e permette di
+monitorare i
+punti d'interruzione, l'esecuzione, la visualizzazione e la
+modifica dei dati, di lavorare con le pile, ottenere informazioni, e di
+svolgere altri compiti.
+
address@hidden
+Se la libreria GNU Readline @`e disponibile al momento della compilazione di
address@hidden, viene usata dal debugger per fornire la cronologia della riga
+di comando e delle modifiche apportate durante il debug.
+
address@hidden
+Normalmente, il debugger non influenza il programma che sta controllando,
+ma questo address@hidden succedere occasionalmente.
+
address@hidden itemize
+
address@hidden Calcolo con precisione arbitraria
address@hidden Calcolo con precisione arbitraria con @command{gawk}
address@hidden precisione arbitraria
address@hidden precisione multipla
address@hidden precisione infinita
address@hidden virgola mobile, numeri address@hidden precisione arbitraria
+
+In questo @value{CHAPTER} si introducono alcuni concetti base su come i
+computer
+eseguono i calcoli e si definiscono alcuni termini importanti.
+Si continua poi descrivendo il calcolo in virgola mobile,
+che @`e quello che @command{awk} usa per tutte le sue operazioni aritmetiche,
+e si prosegue con
+una trattazione del calcolo in virgola mobile con precisione arbitraria,
+una address@hidden disponibile solo in @command{gawk}. Si passa poi a
+illustrare i numeri interi a precisione arbitraria e si conclude con una
+descrizione di alcuni punti sui quali @command{gawk} e lo standard POSIX non
+sono esattamente in accordo.
+
address@hidden NOTA
+La maggior parte degli utenti di @command{gawk} address@hidden saltare senza
patemi
+d'animo
+questo capitolo. Tuttavia, se si vogliono eseguire calcoli scientifici con
address@hidden, questo @`e il luogo adatto per imparare a farlo.
address@hidden quotation
+
address@hidden
+* Aritmetica del computer:: Una rapida introduzione alla matematica del
+ computer.
+* Definizioni matematiche:: Definizione dei termini usati.
+* address@hidden MPFR:: address@hidden MPFR in @command{gawk}.
+* Cautela col calcolo in VM:: Cose da sapere.
+* Interi a precisione arbitraria:: Calcolo con numeri interi a precisione
+ arbitraria con @command{gawk}.
+* Problemi virgola mobile POSIX:: Confronto tra standard e uso corrente.
+* Sommario virgola mobile:: Sommario della trattazione della
+ virgola mobile.
address@hidden menu
+
address@hidden Aritmetica del computer
address@hidden Una descrizione generale dell'aritmetica del computer
+
+Sinora, abbiamo avuto a che fare con dati come numeri o stringhe. Ultimamente,
+comunque, i computer rappresentano ogni cosa in termini di @dfn{cifre binarie},
+o @dfn{bit}. Una cifra decimale address@hidden assumere uno di 10 valori: da
zero a
+nove. Una cifra binaria address@hidden assumere uno di due valori: zero o
uno. Usando
+il sistema binario, i computer (e i programmi per computer) possono
+rappresentare e manipolare dati numerici e dati costituiti da caratteri. In
+generale, tanti address@hidden bit @`e possibile usare per rappresentare una
determinata
+cosa, tanto maggiore address@hidden l'intervallo dei possibili valori che essa
address@hidden
+assumere.
+
+I moderni calcolatori possono eseguire calcoli numerici in almeno due modi, e
+spesso anche di address@hidden Ogni tipo di calcolo usa una diversa
rappresentazione
+(organizzazione dei bit) dei numeri. Le address@hidden di calcolo che ci
interessano
+sono:
+
address@hidden @asis
address@hidden Calcolo decimale
+Questo @`e il tipo di calcolo che s'impara alle scuole elementari, usando
+carta e penna (o anche una calcolatrice). In teoria, i numeri possono avere un
+numero arbitrario di cifre su ambo i lati del separatore decimale, e il
+risultato di un'operazione @`e sempre esatto.
+
+Alcuni sistemi moderni possono eseguire calcoli decimali direttamente,
+tramite apposite istruzioni disponibili
+nell'hardware dell'elaboratore, ma normalmente si ha address@hidden di una
speciale
+libreria software che consenta di effettuare le operazioni desiderate.
+Ci sono anche librerie che svolgono i calcoli decimali interamente
+per via software.
+
+Anche se alcuni utenti si aspettano che @command{gawk} effettui delle
+operazioni usando numeri in base decimale,@footnote{Non sappiamo perch@'e se
+lo aspettino, ma @`e address@hidden@dotless{i}}.} non @`e questo quello che
succede.
+
address@hidden La matematica coi numeri interi
+A scuola ci hanno insegnato che i valori interi erano quei numeri privi di una
+parte frazionaria, come 1, 42, o @minus{}17.
+Il vantaggio dei numeri interi @`e che essi rappresentano dei valori in maniera
+esatta. Lo svantaggio @`e che i numeri rappresentabili sono limitati.
+
address@hidden senza segno, interi
address@hidden segno, interi senza
address@hidden interi senza segno
+Nei calcolatori, i valori interi sono di due tipi: @dfn{con segno} e
address@hidden segno}. I valori con segno possono essere negativi o positivi,
+mentre i valori senza segno sono sempre maggiori o uguali a zero.
+
+Nei sistemi informatici, il calcolo con valori interi @`e esatto, ma il
possibile
+campo di variazione dei valori @`e limitato. L'elaborazione con numeri interi
@`e
address@hidden veloce di quella con numeri a virgola mobile.
+
address@hidden La matematica coi numeri a virgola mobile
+I numeri a virgola mobile rappresentano quelli che a scuola sono chiamati
+numeri ``reali'' (address@hidden, quelli che hanno una parte frazionaria, come
+3.1415927). Il vantaggio dei numeri a virgola mobile @`e che essi possono
+rappresentare uno spettro di valori molto address@hidden ampio di quello
rappresentato dai
+numeri interi. Lo svantaggio @`e che ci sono numeri che essi non possono
+rappresentare in modo esatto.
+
+I computer moderni possono eseguire calcoli su valori a virgola mobile
+nell'hardware dell'elaboratore, entro un intervallo di valori limitato.
+Ci sono inoltre librerie di programmi che consentono calcoli, usando numeri a
+virgola mobile, di precisione arbitraria.
+
+POSIX @command{awk} usa numeri a virgola mobile a @dfn{doppia precisione},
+che possono gestire address@hidden cifre rispetto ai numeri a virgola mobile a
address@hidden precisione}. @command{gawk} ha inoltre address@hidden, descritte
+in dettaglio address@hidden sotto, che lo mettono in grado di eseguire
+calcoli con i numeri a virgola mobile con precisione arbitraria.
address@hidden table
+
+I calcolatori operano con valori interi e a virgola mobile su diversi
+intervalli. I valori interi normalmente hanno una dimensione di 32 bit o 64
bit.
+I valori a virgola mobile a singola precisione occupano 32 bit, mentre i
+valori a virgola mobile a doppia precisione occupano 64 bit. I valori a
+virgola mobile sono sempre con segno. Il possibile campo di variazione dei
+valori @`e mostrato in @ref{table-numeric-ranges}.
+
address@hidden Tabella,table-numeric-ranges
address@hidden dei valori per diverse rappresentazioni numeriche}
address@hidden @columnfractions .34 .33 .33
address@hidden Rappresentazione numerica @tab Valore minimo @tab Valore massimo
address@hidden Interi con segno a 32-bit @tab @minus{}2.147.483.648 @tab
2.147.483.647
address@hidden Interi senza segno a 32-bit @tab 0 @tab 4.294.967.295
address@hidden Interi con segno a 64-bit @tab @minus{}9.223.372.036.854.775.808
@tab 9.223.372.036.854.775.807
address@hidden Interi senza segno a 64-bit @tab 0 @tab
18.446.744.073.709.551.615
address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab
@math{1,175494^{-38}} @tab @math{3,402823^{38}}
address@hidden Virgola mobile, doppia precisione (circa) @tab
@math{2,225074^{-308}} @tab @math{1,797693^{308}}
address@hidden iftex
address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab 1,175494e-38
@tab 3,402823e38
address@hidden Virgola mobile, doppia precisione (circa) @tab 2,225074e-308
@tab 1,797693e308
address@hidden ifinfo
address@hidden
address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab 1,address@hidden
@tab 3,address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab 2,address@hidden
@tab 1,address@hidden
address@hidden ifnotinfo
address@hidden ifnottex
address@hidden multitable
address@hidden float
+
address@hidden Definizioni matematiche
address@hidden Altre cose da sapere
+
+Il resto di questo @value{CHAPTER} usa un certo numero di termini. Di seguito
+vengono date alcune definizioni informali che dovrebbero essere utili
+per la lettura di questo documento:
+
address@hidden @dfn
address@hidden Accuratezza
+L'accuratezza del calcolo sui numeri a virgola mobile indica di quanto si
+avvicina il calcolo al valore reale (calcolato con carta e penna).
+
address@hidden Errore
+La differenza tra quello che il risultato di un calcolo ``dovrebbe dare''
+e quello che effettivamente address@hidden @`E meglio minimizzare l'errore
quanto address@hidden
+possibile.
+
address@hidden Esponente
+L'ordine di grandezza di un valore;
+alcuni bit in un valore a virgola mobile contengono l'esponente.
+
address@hidden Inf
+Un valore speciale che rappresenta l'infinito. Le operazioni tra un qualsiasi
+numero e l'infinito danno infinito.
+
address@hidden Mantissa
+Un valore a virgola mobile @`e formato dalla mantissa moltiplicata per 10
+alla potenza dell'esponente. Per esempio, in @code{1,2345e67},
+la mantissa @`e @code{1,2345}.
+
address@hidden address@hidden di arrotondamento
+Come i numeri vanno arrotondati, per eccesso o per difetto, quando necessario.
+Maggiori dettagli verranno forniti in seguito.
+
address@hidden NaN
+``Not a number'' (Non un Numero)address@hidden a Michael
+Brennan per questa descrizione, che abbiamo parafrasato, e per gli esempi.} Un
+valore speciale che risulta da un calcolo che non ha risposta come numero
+reale. In tal caso, i programmi possono o ricevere un'eccezione di virgola
+mobile, o restituire @code{NaN} come risultato. Lo standard IEEE 754
+consiglia che i sistemi restituiscano @code{NaN}. Alcuni esempi:
+
address@hidden @code
address@hidden sqrt(-1)
+La radice quadrata di @minus{}1 ha senso nell'insieme dei numeri complessi,
+ma non nell'insieme dei numeri reali,
+per cui il risultato @`e @code{NaN}.
+
address@hidden log(-8)
+Il logaritmo di @minus{}8 @`e fuori dal dominio di @code{log()},
+per cui il risultato @`e @code{NaN}.
address@hidden table
+
address@hidden Normalizzato (formato)
+Come la mantissa (vedi oltre in questa lista) @`e usualmente memorizzata. Il
+valore viene aggiustato in modo che il primo bit sia sempre uno,
+e in questo modo l'uno iniziale @`e supposto presente (per come viene
+generato il numero), ma non @`e memorizzato fisicamente.
+Questo fornisce un bit di precisione in address@hidden
+
address@hidden Precisione
+Il numero di bit usati per rappresentare un numero a virgola mobile.
address@hidden sono i bit, e maggiore @`e l'intervallo di cifre che si possono
+rappresentare.
+Le precisioni binaria e decimale sono legate in modo approssimativo, secondo
+la formula:
+
address@hidden
address@hidden
address@hidden = 3.322 @cdot dps}
address@hidden iftex
address@hidden
address@hidden
address@hidden = 3.322 * @var{dps}
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>prec</emphasis> = 3.322 ⋅ <emphasis>dps</emphasis>
address@hidden docbook
address@hidden display
+
address@hidden
+Qui, @emph{prec} indica la precisione binaria
+(misurata in bit) e @emph{dps} (abbreviazione di "decimal places")
+indica le cifre decimali.
+
address@hidden address@hidden
address@hidden://en.wikipedia.org/wiki/Numerical_stability,
+l'articolo di Wikipedia sulla address@hidden numerica}:
+``I calcoli per i quali si address@hidden dimostrare che non amplificano gli
errori di
+approssimazione sono chiamati @dfn{numericamente stabili}.''
address@hidden table
+
+Si veda @uref{http://en.wikipedia.org/wiki/Accuracy_and_precision,
+l'articolo di Wikipedia su accuratezza e precisione} per maggiori informazioni
+su questi due termini.
+
+Sui computer moderni, l'address@hidden di calcolo in virgola mobile usa la
+rappresentazione e le operazioni definite dallo standard IEEE 754.
+Tre dei tipi definiti nello standard IEEE 754 sono:
+32-bit singola precisione,
+64-bit doppia precisione e
+128-bit quadrupla precisione.
+Lo standard specifica anche formati a precisione estesa
+per consentire una maggiore precisione e campi di variazione degli esponenti
address@hidden ampi. (@command{awk} usa solo il formato a 64-bit doppia
precisione.)
+
address@hidden elenca la precisione e i valori di campo
+dell'esponente per i principali formati binari IEEE 754.
+
address@hidden Tabella,table-ieee-formats
address@hidden per i principali formati IEEE}
address@hidden @columnfractions .20 .20 .20 .20 .20
address@hidden Nome @tab Bit totali @tab Precisione @tab Esponente minimo @tab
Esponente massimo
address@hidden Singola @tab 32 @tab 24 @tab @minus{}126 @tab +127
address@hidden Doppia @tab 64 @tab 53 @tab @minus{}1022 @tab +1023
address@hidden Quadrupla @tab 128 @tab 113 @tab @minus{}16382 @tab +16383
address@hidden multitable
address@hidden float
+
address@hidden NOTA
+I numeri che descrivono la precisione includono la cifra 1 iniziale
+implicita, il che equivale ad avere un bit in address@hidden nella mantissa.
address@hidden quotation
+
address@hidden address@hidden MPFR
address@hidden address@hidden per il calcolo a precisione arbitraria in
@command{gawk}
+
+Per default, @command{gawk} usa i valori in virgola mobile a doppia precisione
+disponibili nell'hardware del sistema su cui viene eseguito.
+Tuttavia, se @`e stato compilato in modo da includere questa address@hidden
+ed @`e stata specificata
+l'opzione da riga di comando @option{-M}, @command{gawk} usa le librerie
address@hidden://www.mpfr.org, GNU MPFR} e @uref{http://gmplib.org, GNU MP}
(GMP)
+per effettuare calcoli sui numeri con una precisione arbitraria.
+Si address@hidden verificare se il supporto a MPFR @`e disponibile in questo
modo:
+
address@hidden
+$ @kbd{gawk --version}
address@hidden GNU Awk 4.1.2, API: 1.1 (GNU MPFR 3.1.0-p3, GNU MP 5.0.2)
address@hidden Copyright (C) 1989, 1991-2015 Free Software Foundation.
address@hidden
address@hidden example
+
address@hidden
+(I numeri di versione visualizzati possono essere diversi. Non importa;
+l'importante @`e che siano presenti GNU MPFR e GNU MP
+nel testo restituito.)
+
+Inoltre, ci sono alcuni elementi disponibili nel vettore @code{PROCINFO}
+per fornire informazioni sulle librerie MPFR e GMP
+(@pxref{Variabili auto-assegnate}).
+
+La libreria MPFR address@hidden un controllo accurato sulle precisioni e sulle
address@hidden di
+arrotondamento, e address@hidden risultati correttamente arrotondati,
riproducibili e
+indipendenti dalla piattaforma. Con l'opzione da riga di comando @option{-M},
+tutti gli operatori aritmetici e le funzioni in virgola mobile possono
+produrre risultati a ogni livello di precisione supportato da MPFR.
+
+Due variabili predefinite, @code{PREC} e @code{ROUNDMODE},
+danno il controllo sulla precisione di elaborazione e sulla address@hidden di
+arrotondamento. La precisione e la address@hidden di arrotondamento sono
impostate
+a livello globale per ogni operazione da eseguire.
address@hidden la precisione} e
address@hidden
+la
address@hidden iftex
address@hidden modi di arrotondare}
+per maggiori informazioni.
+
address@hidden Cautela col calcolo in VM
address@hidden Calcolo in virgola mobile: @dfn{Caveat Emptor}!
+
address@hidden
address@hidden'ora di matematica @`e ostica!}
address@hidden Teen Talk Barbie, luglio 1992
address@hidden quotation
+
+Questa @value{SECTION} fornisce un quadro dettagliato dei problemi che
+si presentano quando si eseguono molti calcoli in virgola
address@hidden'@`e un saggio molto bello
address@hidden://www.validlab.com/goldberg/paper.pdf, sul calcolo in
+virgola mobile} di David Goldberg, ``What Every Computer Scientist Should Know
+About Floating-Point Arithmetic,''
address@hidden Computing Surveys} @strong{23}, 1 (1991-03): 5-48. Vale la pena
di
+leggerlo, se si @`e interessati a scendere nei dettagli, address@hidden
richiede delle
+conoscenze informatiche.}
+Le spiegazioni fornite valgono sia per il calcolo in virgola mobile
+effettuato direttamente dall'hardware del computer, sia per quello
+ottenuto tramite il software per la precisione arbitraria.
+
address@hidden ATTENZIONE
+Le informazioni fornite in questa sede sono deliberatamente di tipo generale.
+Se si devono eseguire calcoli complessi col computer, si dovrebbero prima
+ottenere ulteriori informazioni, e non basarsi solo su quanto qui detto.
address@hidden quotation
+
address@hidden
+* Inesattezza nei calcoli:: La matematica in virgola mobile non @`e
+ esatta.
+* Ottenere la precisione:: Ottenere address@hidden precisione richiede
qualche
+ sforzo.
+* Tentare di arrotondare:: Aggiungere cifre di precisione e arrotondare.
+* Impostare la precisione:: Come impostare la precisione.
+* Impostare modi di arrotondare:: Impostare le address@hidden di
arrotondamento.
address@hidden menu
+
address@hidden Inesattezza nei calcoli
address@hidden La matematica in virgola mobile non @`e esatta
+
+Le rappresentazioni e i calcoli con numeri a virgola mobile binari sono
+inesatti. Semplici valori come 0,1 non possono essere rappresentati in modo
+preciso usando numeri a virgola mobile binari, e la limitata precisione dei
+numeri a virgola mobile significa che piccoli cambiamenti nell'ordine delle
+operazioni o la precisione di memorizzazione di operazioni
+intermedie address@hidden cambiare il
+risultato. Per rendere la situazione address@hidden difficile, nel calcolo in
virgola
+mobile con precisione arbitraria, si address@hidden impostare la precisione
prima di
+eseguire un calcolo, address@hidden non si address@hidden sapere con certezza
quale address@hidden
+il numero di cifre decimali esatte nel risultato finale.
+
address@hidden
+* Rappresentazioni inesatte:: I numeri non sono rappresentati esattamente.
+* Confronti tra valori in VM:: Come confrontare valori in virgola mobile.
+* Gli errori si sommano:: Gli errori diventano sempre maggiori.
address@hidden menu
+
address@hidden Rappresentazioni inesatte
address@hidden Molti numeri non possono essere rappresentati esattamente
+
address@hidden, prima di iniziare a scrivere del codice, si dovrebbe pensare
+al risultato che si vuole effettivamente ottenere e a cosa realmente accade.
+Si considerino i due numeri nel seguente esempio:
+
address@hidden
+x = 0.875 # 1/2 + 1/4 + 1/8
+y = 0.425
address@hidden example
+
+Diversamente dal numero in @code{y}, il numero memorizzato in @code{x}
address@hidden rappresentabile esattamente nel formato binario, perch@'e
address@hidden essere
+scritto come somma finita di una o address@hidden frazioni i cui denominatori
sono tutti
+multipli di due.
+Quando @command{gawk} legge un numero a virgola mobile dal sorgente di un
+programma, arrotonda automaticamente quel numero alla precisione, quale che
+sia, supportata dal computer in uso. Se si tenta di stampare il contenuto
+numerico di una variabile usando una stringa di formato in uscita di
address@hidden"%.17g"}, il valore restituito address@hidden non essere lo
stesso numero assegnato
+a quella variabile:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ x = 0.875; y = 0.425}
+> @kbd{ printf("%0.17g, %0.17g\n", x, y) @}'}
address@hidden 0.875, 0.42499999999999999
address@hidden example
+
+Spesso l'errore @`e talmente piccolo da non essere neppure notato, e se @`e
stato
+notato, si address@hidden sempre specificare il grado di precisione si vuole
nell'output.
+In genere questo @`e una stringa di formato come @code{"%.15g"} che, se usata
+nell'esempio precedente, address@hidden luogo a un output identico all'input.
+
address@hidden Confronti tra valori in VM
address@hidden Fare attenzione quando si confrontano valori
+
+Poich@'e la rappresentazione interna del computer
address@hidden discostarsi, sia pur di poco, dal valore
+esatto, confrontare dei valori a virgola mobile per vedere se sono esattamente
+uguali @`e generalmente una pessima idea. Questo @`e un esempio in cui tale
+confronto non funziona come dovrebbe:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print (0.1 + 12.2 == 12.3) @}'}
address@hidden 0
address@hidden example
+
+Il metodo generalmente seguito per confrontare valori a virgola mobile
+consiste nel controllare se la differenza tra loro @`e minore di un certo
valore
+(chiamato @dfn{delta}, o @dfn{tolleranza}). Quel che si deve decidere @`e qual
address@hidden il valore minimo di delta
+adeguato. Il codice per far address@hidden @`e qualcosa del genere:
+
address@hidden
+delta = 0.00001 # per esempio
+differenza = abs(a) - abs(b) # sottrazione dei due valori
+if (differenza < delta)
+ # va bene
+else
+ # non va bene
address@hidden example
+
address@hidden
+(Si presuppone che sia stata definita in qualche parte del programma una
+semplice funzione che restituisce il valore assoluto di un numero,
+chiamata @code{abs()}.)
+
address@hidden Gli errori si sommano
address@hidden Gli errori diventano sempre maggiori
+
+La perdita di accuratezza in un singolo calcolo con numeri a virgola mobile
+generalmente non dovrebbe destare preoccupazione. Tuttavia, se si calcola un
+valore che @`e una sequenza di operazioni in virgola mobile, l'errore si
address@hidden
+accumulare e influire sensibilmente sul risultato del calcolo stesso.
+Qui sotto vediamo un tentativo di calcolare il valore di @value{PI} usando
+una delle sue rappresentazioni
+come somma di una serie di numeri:
+
address@hidden
+BEGIN @{
+ x = 1.0 / sqrt(3.0)
+ n = 6
+ for (i = 1; i < 30; i++) @{
+ n = n * 2.0
+ x = (sqrt(x * x + 1) - 1) / x
+ printf("%.15f\n", n * x)
+ @}
address@hidden
address@hidden example
+
+Quando viene eseguito, gli errori iniziali si propagano nei calcoli
+successivi, facendo terminare il ciclo prematuramente dopo un tentativo di
+divisione per zero:
+
address@hidden
+$ @kbd{gawk -f pi.awk}
address@hidden 3.215390309173475
address@hidden 3.159659942097510
address@hidden 3.146086215131467
address@hidden 3.142714599645573
address@hidden
address@hidden 3.224515243534819
address@hidden 2.791117213058638
address@hidden 0.000000000000000
address@hidden gawk: pi.awk:6: fatale: tentativo di dividere per zero
address@hidden example
+
+Ecco un altro esempio in cui l'inaccuratezza nelle rappresentazioni interne
+porta a un risultato inatteso:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{for (d = 1.1; d <= 1.5; d += 0.1) # esegue il ciclo cinque volte (?)}
+> @kbd{i++}
+> @kbd{print i}
+> @address@hidden'}
address@hidden 4
address@hidden example
+
address@hidden Ottenere la precisione
address@hidden Ottenere la precisione voluta
+
address@hidden il calcolo con precisione arbitraria dare risultati esatti? Non
ci sono
+risposte facili. Le regole standard dell'algebra spesso non valgono
+nei calcoli con precisione arbitraria.
+Tra le altre cose, le leggi distributiva e associativa non sono rispettate
+completamente, e l'ordine dell'operazione address@hidden essere importante per
+il calcolo.
+Errori di arrotondamento, perdite di precisione che si accumulano, e
+valori molto vicini allo zero sono spesso causa di problemi.
+
+Quando @command{gawk} verifica l'eguaglianza delle espressioni
address@hidden + 12.2} e @samp{12.3} usando l'aritmetica a doppia precisione
della
+macchina, decide che non sono uguali! (@xref{Confronti tra valori in VM}.)
+Si address@hidden ottenere il risultato cercato aumentando la precisione; 56
bit in
+questo caso sono sufficienti:
+
address@hidden
+$ @kbd{gawk -M -v PREC=56 'BEGIN @{ print (0.1 + 12.2 == 12.3) @}'}
address@hidden 1
address@hidden example
+
+Se aggiungere address@hidden bit @`e una buona cosa, aggiungerne ancora di
address@hidden
address@hidden meglio?
+Ecco cosa succede se si usa un valore di @code{PREC} ancora address@hidden
alto:
+
address@hidden
+$ @kbd{gawk -M -v PREC=201 'BEGIN @{ print (0.1 + 12.2 == 12.3) @}'}
address@hidden 0
address@hidden example
+
+Non @`e un bug di @command{gawk} o della libreria MPFR.
address@hidden facile dimenticare che il numero finito di bit usato per
memorizzare il
+valore spesso @`e solo un'approssimazione dopo un opportuno arrotondamento. Il
+test di uguaglianza riesce se e solo se @emph{tutti} i bit dei due operandi
+sono esattamente gli stessi. Poich@'e questo non @`e necessariamente vero dopo
un
+calcolo in virgola mobile con una determinata precisione e con una
address@hidden di
+arrotondamento valida, un test di eguaglianza convenzionale potrebbe non
+riuscire. Invece, il test riesce confrontando i due numeri per vedere se la
+differenza tra di loro rientra in un delta accettabile.
+
+In applicazioni dove sono sufficienti fino a 15 cifre decimali,
+il calcolo in doppia precisione eseguito dall'hardware del computer
address@hidden essere una buona soluzione,
+e in genere @`e address@hidden veloce. address@hidden bisogna tener presente
che ogni operazione in
+virgola mobile address@hidden subire un nuovo errore di arrotondamento con
conseguenze
+catastrofiche, come si @`e visto nel precedente tentativo di calcolare il
valore
+di @value{PI}.
+In tali casi una precisione supplementare address@hidden aumentare la
address@hidden e
+l'accuratezza del calcolo.
+
+Oltre a address@hidden, bisogna tenere conto del fatto che
+addizioni ripetute non sono necessariamente equivalenti a una moltiplicazione
+nell'aritmetica in virgola mobile. Nell'esempio visto in
address@hidden errori si sommano}:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{for (d = 1.1; d <= 1.5; d += 0.1) # ciclo eseguito cinque volte (?)}
+> @kbd{i++}
+> @kbd{print i}
+> @address@hidden'}
address@hidden 4
address@hidden example
+
address@hidden
+non @`e detto che, scegliendo per @code{PREC} un valore arbitrariamente alto,
si
+riesca a ottenere il risultato corretto. La riformulazione del problema in
+questione @`e spesso il modo corretto di comportari in tali situazioni.
+
address@hidden Tentare di arrotondare
address@hidden Tentare di aggiungere bit di precisione e arrotondare
+
+Invece dell'aritmetica in virgola mobile con precisione arbitraria,
+spesso tutto address@hidden di cui si ha bisogno @`e un aggiustamento della
logica
+o di un diverso ordine delle operazioni nei calcoli.
+La address@hidden e l'accuratezza del calcolo di @value{PI}
+nel primo esempio possono essere migliorata usando la seguente semplice
+trasformazione algebrica:
+
address@hidden
+(sqrt(x * x + 1) - 1) / x @equiv{} x / (sqrt(x * x + 1) + 1)
address@hidden example
+
address@hidden
+Dopo aver fatto questo cambiamento, il programma converge verso
address@hidden in meno di 30 iterazioni:
+
address@hidden
+$ @kbd{gawk -f pi2.awk}
address@hidden 3.215390309173473
address@hidden 3.159659942097501
address@hidden 3.146086215131436
address@hidden 3.142714599645370
address@hidden 3.141873049979825
address@hidden
address@hidden 3.141592653589797
address@hidden 3.141592653589797
address@hidden example
+
address@hidden Impostare la precisione
address@hidden Impostare la precisione
+
address@hidden usa una precisione di lavoro a livello globale; non tiene
+traccia della precisione e accuratezza dei singoli numeri. Eseguendo
+un'operazione aritmetica o chiamando una funzione predefinita, il risultato
+viene arrotondato alla precisione di lavoro. La precisione di lavoro di default
address@hidden di 53 bit, modificabile usando la variabile predefinita
@code{PREC}. Si address@hidden
+anche impostare il valore a una delle stringhe predefinite (non importa se
+scritte in maiuscolo o minuscolo) elencate in
address@hidden,
+per emulare un formato binario che segue lo standard IEEE 754.
+
address@hidden Tabella,table-predefined-precision-strings
address@hidden di precisione predefinita per @code{PREC}}
address@hidden address@hidden"double"}} {12345678901234567890123456789012345}
address@hidden @code{PREC} @tab formato binario IEEE 754
address@hidden @code{"half"} @tab 16-bit mezza precisione
address@hidden @code{"single"} @tab 32-bit singole precisione di base
address@hidden @code{"double"} @tab 64-bit doppia precisione di base
address@hidden @code{"quad"} @tab 128-bit quadrupla precisione di base
address@hidden @code{"oct"} @tab 256-bit ottupla precisione
address@hidden multitable
address@hidden float
+
+Il seguente esempio illustra gli effetti del cambiamento di precisione
+sulle operazioni aritmetiche:
+
address@hidden
+$ @kbd{gawk -M -v PREC=100 'BEGIN @{ x = 1.0e-400; print x + 0}
+> @kbd{PREC = "double"; print x + 0 @}'}
address@hidden 1e-400
address@hidden 0
address@hidden example
+
address@hidden ATTENZIONE
+Diffidare delle costanti in virgola mobile! Quando si legge una costante in
+virgola mobile dal codice sorgente di un programma, @command{gawk} usa la
+precisione di default (quella del formato @code{double} di C), a meno che non
+venga richiesto, tramite la variabile speciale @code{PREC} fornita
+sulla riga di comando, di memorizzarla internamente come un numero MPFR.
+Cambiare la precisione tramite @code{PREC} nel testo del programma @emph{non}
+cambia la precisione di una costante.
+
+Se si deve rappresentare una costante in virgola mobile con una precisione
+maggiore di quella di default e non @`e possibile usare un assegnamento a
address@hidden da riga di comando, si dovrebbe definire la costante o come
+stringa, o come numero razionale, ove possibile. L'esempio seguente illustra le
+differenze tra i diversi modi di stampare una costante in virgola mobile:
+
address@hidden
+$ @kbd{gawk -M 'BEGIN @{ PREC = 113; printf("%0.25f\n", 0.1) @}'}
address@hidden 0.1000000000000000055511151
+$ @kbd{gawk -M -v PREC=113 'BEGIN @{ printf("%0.25f\n", 0.1) @}'}
address@hidden 0.1000000000000000000000000
+$ @kbd{gawk -M 'BEGIN @{ PREC = 113; printf("%0.25f\n", "0.1") @}'}
address@hidden 0.1000000000000000000000000
+$ @kbd{gawk -M 'BEGIN @{ PREC = 113; printf("%0.25f\n", 1/10) @}'}
address@hidden 0.1000000000000000000000000
address@hidden example
address@hidden quotation
+
address@hidden Impostare modi di arrotondare
address@hidden Impostare la address@hidden di arrotondamento
+
+La variabile @code{ROUNDMODE} permette di controllare a livello di programma
+la address@hidden di arrotondamento.
+La corrispondenza tra @code{ROUNDMODE} e le address@hidden di arrotondamento
IEEE
address@hidden mostrata in @ref{table-gawk-rounding-modes}.
+
address@hidden Tabella,table-gawk-rounding-modes
address@hidden@`a di arrotondamento in @command{gawk} }
address@hidden @columnfractions .45 .30 .25
address@hidden address@hidden di arrotondamento @tab Nome IEEE @tab
@code{ROUNDMODE}
address@hidden Arrotonda al address@hidden vicino, o a un numero pari @tab
@code{roundTiesToEven} @tab @code{"N"} o @code{"n"}
address@hidden Arrotonda verso infinito @tab @code{roundTowardPositive} @tab
@code{"U"} o @code{"u"}
address@hidden Arrotonda verso meno infinito @tab @code{roundTowardNegative}
@tab @code{"D"} o @code{"d"}
address@hidden Arrotonda verso zero (troncamento) @tab @code{roundTowardZero}
@tab @code{"Z"} o @code{"z"}
address@hidden Arrotonda al address@hidden vicino, o per eccesso @tab
@code{roundTiesToAway} @tab @code{"A"} o @code{"a"}
address@hidden multitable
address@hidden float
+
address@hidden ha @code{"N"} come valore di default, ovvero si usa la
address@hidden di arrotondamento IEEE 754 @code{roundTiesToEven}.
+In @ref{table-gawk-rounding-modes}, il valore @code{"A"} seleziona
address@hidden Questo @`e applicabile solo se la versione in uso
+della libreria MPFR lo supporta; altrimenti, l'impostazione di @code{ROUNDMODE}
+ad @code{"A"} non ha alcun effetto.
+
+La address@hidden di default @code{roundTiesToEven} @`e la address@hidden
preferita, ma allo
+stesso tempo
+la meno intuitiva. Questo metodo fa la cosa ovvia per la maggior parte dei
+valori, arrotondandoli per eccesso o per difetto alla cifra address@hidden
prossima.
+Per esempio, arrotondando 1.132 alle due cifre decimali si ottiene 1.13,
+e 1.157 viene arrotondato a 1.16.
+
+Tuttavia, se si deve arrotondare un valore posto esattamente a address@hidden
strada,
+le cose non funzionano come probabilmente si insegna a scuola.
+In questo caso, il numero @`e arrotondato alla cifra @emph{pari}
address@hidden prossima.
address@hidden@dotless{i}} arrotondando 0.125 alle due cifre si arrotonda per
difetto a 0.12,
+ma arrotondando 0.6875 alle tre cifre si arrotonda per eccesso a 0.688.
+Probabilmente ci si @`e address@hidden imbattuti in questa address@hidden di
arrotondamento
+usando @code{printf} per formattare numeri a virgola mobile.
+Per esempio:
+
address@hidden
+BEGIN @{
+ x = -4.5
+ for (i = 1; i < 10; i++) @{
+ x += 1.0
+ printf("%4.1f => %2.0f\n", x, x)
+ @}
address@hidden
address@hidden example
+
address@hidden
+produce il seguente output quando viene eseguito sul sistema
+dell'autore:@address@hidden possibile che l'output sia completamente diverso,
se la
+libreria C presente nel sistema in uso non si conforma, per @code{printf},
+alla regola IEEE 754
+di arrotondamento al valore pari in caso di equidistanza.}
+
address@hidden
+-3.5 => -4
+-2.5 => -2
+-1.5 => -2
+-0.5 => 0
+ 0.5 => 0
+ 1.5 => 2
+ 2.5 => 2
+ 3.5 => 4
+ 4.5 => 4
address@hidden example
+
+La teoria che sta dietro alla regola
address@hidden @`e che gli arrotondamenti di
+valori equidistanti in eccesso e in difetto si distribuiscono address@hidden o
meno
+uniformemente, con la possibile conseguenza che errori di arrotondamento
+ripetuti tendono ad annullarsi a vicenda. Questa @`e la address@hidden di
+arrotondamento di default per funzioni e operatori di calcolo secondo IEEE 754.
+
+Le altre address@hidden di arrotondamento sono usate raramente. Gli
arrotondamenti
+verso l'infinito (@code{roundTowardPositive}) e verso il meno infinito
+(@code{roundTowardNegative}) vengono spesso usati per eseguire calcoli su
+intervalli, dove si adotta questa address@hidden di arrotondamento per
calcolare
+i limiti superiore e inferiore per l'intervallo di valori in uscita.
+La address@hidden
address@hidden address@hidden essere usata per convertire numeri a virgola
mobile
+in numeri interi. La address@hidden di arrotondamento @code{roundTiesToAway}
+arrotonda il risultato al numero address@hidden vicino, e in caso di
equidistanza
+arrotonda per eccesso.
+
+Qualche esperto di analisi numerica address@hidden che la scelta dello stile di
+arrotondamento ha un grandissimo impatto sul risultato finale, e address@hidden
+di attendere sino al risultato finale dopo ogni arrotondamento. Invece,
+spesso si possono evitare problemi legati a errori di arrotondamento
+impostando all'inizio la precisione a un valore sufficientemente maggiore
+della precisione desiderata, in modo che il cumulo degli errori di
+arrotondamento non influisca sul
+risultato finale. Se si ha il dubbio che i risultati del calcolo contengano
+un'accumulazione di errori di arrotondamento, occorre, per accertare la cosa,
+controllare se si verifica una differenza significativa nell'output
+cambiando la address@hidden di arrotondamento.
+
address@hidden Interi a precisione arbitraria
address@hidden Aritmetica dei numeri interi a precisione arbitraria con
@command{gawk}
address@hidden numeri interi a precisione arbitraria
address@hidden interi a precisione arbitraria
address@hidden precisione arbitraria, interi a
+
+Quando viene specificata l'opzione @option{-M},
address@hidden esegue tutti i calcoli sui numeri interi usando gli interi a
+precisione arbitraria della libreria GMP. Qualsiasi numero che appaia come un
+intero in un sorgente o in un @value{DF} @`e memorizzato come intero a
precisione
+arbitraria. La dimensione del numero intero ha come limite solo la memoria
+disponibile. Per esempio, il seguente programma calcola
address@hidden
address@hidden,
address@hidden iftex
address@hidden
+5^4^3^2,
address@hidden ifinfo
address@hidden
address@hidden
address@hidden@address@hidden,
address@hidden ifnotinfo
address@hidden ifnottex
+il cui risultato @`e oltre i limiti degli ordinari valori a virgola mobile a
+doppia precisione dei processori:
+
address@hidden
+$ @kbd{gawk -M 'BEGIN @{}
+> @kbd{x = 5^4^3^2}
+> @kbd{print "numero di cifre =", length(x)}
+> @kbd{print substr(x, 1, 20), "...", substr(x, length(x) - 19, 20)}
+> @address@hidden'}
address@hidden numero di cifre = 183231
address@hidden 62060698786608744707 ... 92256259918212890625
address@hidden example
+
+Se invece si dovesse calcolare lo stesso valore usando valori a virgola mobile
+con precisione arbitraria, la precisione necessaria per il risultato corretto
+(usando
+la formula
address@hidden
address@hidden = 3.322 @cdot dps})
+sarebbe @math{3.322 @cdot 183231},
address@hidden iftex
address@hidden
address@hidden
address@hidden = 3.322 * dps})
+sarebbe 3.322 x 183231,
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>prec</emphasis> = 3.322 ⋅ <emphasis>dps</emphasis>)
+would be
+<emphasis>prec</emphasis> = 3.322 ⋅ 183231,
address@hidden docbook
+o 608693.
+
+Il risultato di un'operazione aritmetica tra un intero e un valore a virgola
+mobile @`e un valore a virgola mobile con precisione uguale alla precisione di
+lavoro. Il seguente programma calcola l'ottavo termine nella successione di
address@hidden, Eric W.
address@hidden's Sequence}. From MathWorld---A Wolfram Web Resource
address@hidden(@url{http://mathworld.wolfram.com/SylvestersSequence.html}).}}
+usando una ricorrenza:
+
address@hidden
+$ @kbd{gawk -M 'BEGIN @{}
+> @kbd{s = 2.0}
+> @kbd{for (i = 1; i <= 7; i++)}
+> @kbd{s = s * (s - 1) + 1}
+> @kbd{print s}
+> @address@hidden'}
address@hidden 113423713055421845118910464
address@hidden example
+
+Il risultato mostrato differisce dal numero effettivo,
+113.423.713.055.421.844.361.000.443,
+perch@'e la precisione di default di 53 bit non @`e suffciente per
rappresentare
+esattamente il risultato in virgola mobile. Si address@hidden o aumentare la
precisione
+(in questo caso bastano 100 bit), o sostituire la costante in virgola mobile
address@hidden con un intero, per eseguire tutti i calcoli usando l'aritmetica
con
+gli interi per ottenere l'output corretto.
+
+A volte @command{gawk} deve convertire implicitamente un intero con precisione
+arbitraria in un valore a virgola mobile con precisione arbitraria.
address@hidden si rende necessario
+principalmente perch@'e la libreria MPFR non sempre prevede l'interfaccia
+necessaria per elaborare interi a precisione arbitraria o numeri di tipo
+eterogeneo come richiesto da un'operazione o funzione. In tal caso, la
+precisione viene impostata al minimo valore necessario per una conversione
+esatta, e non viene usata la precisione di lavoro. Se
+questo non @`e quello di cui si ha bisogno o che si vuole, si address@hidden
ricorrere a un
+sotterfugio e convertire preventivamente l'intero in un valore a virgola
+mobile, come qui di seguito:
+
address@hidden
+gawk -M 'BEGIN @{ n = 13; print (n + 0.0) % 2.0 @}'
address@hidden example
+
+Si address@hidden evitare completamente questo passaggio specificando il
numero come
+valore a virgola mobile fin dall'inizio:
+
address@hidden
+gawk -M 'BEGIN @{ n = 13.0; print n % 2.0 @}'
address@hidden example
+
+Si noti che, per questo specifico esempio, probabilmente @`e meglio
+semplicemente specificare:
+
address@hidden
+gawk -M 'BEGIN @{ n = 13; print n % 2 @}'
address@hidden example
+
+Dividendo due interi a precisione arbitraria con @samp{/} o con @samp{%}, il
+risultato @`e tipicamente un valore a virgola mobile con precisione arbitraria
+(a meno che il risultato non sia un numero intero esatto).
+Per eseguire divisioni intere o calcolare moduli con interi a precisione
+arbitraria, usare la funzione predefinita
address@hidden()} (@pxref{Funzioni numeriche}).
+
+Si address@hidden simulare la funzione @code{intdiv()} in @command{awk}
standard
+usando questa funzione definita dall'utente:
+
address@hidden
address@hidden file eg/lib/intdiv.awk
+# intdiv --- fa una divisione intera
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/intdiv.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# July, 2014
+#
+# Name changed from div() to intdiv()
+# April, 2015
+
address@hidden endfile
+
address@hidden ignore
address@hidden file eg/lib/intdiv.awk
+function intdiv(numerator, denominator, result)
address@hidden
+ split("", result)
+
+ numerator = int(numerator)
+ denominator = int(denominator)
+ result["quotient"] = int(numerator / denominator)
+ result["remainder"] = int(numerator % denominator)
+
+ return 0.0
address@hidden
address@hidden endfile
address@hidden example
+
+Il seguente programma d'esempio, proposto da Katie Wasserman,
+usa @code{intdiv()} per
+calcolare le cifre di @value{PI} al numero di cifre significative
+che si @`e scelto di impostare:
+
address@hidden
address@hidden file eg/prog/pi.awk
+# pi.awk --- calcola le cifre di pi
address@hidden endfile
address@hidden endfile
address@hidden
address@hidden file eg/prog/pi.awk
+#
+# Katie Wasserman, katie@@wass.net
+# August 2014
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/pi.awk
+
+BEGIN @{
+ cifre = 100000
+ due = 2 * 10 ^ cifre
+ pi = due
+ for (m = cifre * 4; m > 0; --m) @{
+ d = m * 2 + 1
+ x = pi * m
+ intdiv(x, d, risultato)
+ pi = risultato["quotient"]
+ pi = pi + due
+ @}
+ print pi
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Date: Wed, 20 Aug 2014 10:19:11 -0400
+To: address@hidden
+From: Katherine Wasserman <address@hidden>
+Subject: Re: computation of digits of pi?
+
+Arnold,
+
+>The program that you sent to compute the digits of pi using div(). Is
+>that some standard algorithm that every math student knows? If so,
+>what's it called?
+
+It's not that well known but it's not that obscure either
+
+It's Euler's modification to Newton's method for calculating pi.
+
+Take a look at lines (23) - (25) here:
http://mathworld.wolfram.com/PiFormulas.htm
+
+The algorithm I wrote simply expands the multiply by 2 and works from the
innermost expression outwards. I used this to program HP calculators because
it's quite easy to modify for tiny memory devices with smallish word sizes.
+
+http://www.hpmuseum.org/cgi-sys/cgiwrap/hpmuseum/articles.cgi?read=899
+
+-Katie
address@hidden ignore
+
+Quando gli fu chiesto dell'algoritmo usato, Katie rispose:
+
address@hidden
+Non @`e quello address@hidden noto ma nemmeno quello address@hidden
incomprensibile.
address@hidden la variante di Eulero al metodo di Newton per il calcolo del Pi
greco.
+Si vedano le righe (23) - (25) nel sito:
address@hidden://mathworld.wolfram.com/PiFormulas.html}.
+
+L'algoritmo che ho scritto semplicemente espande il moltiplicare per 2 e
+lavora dall'espressione address@hidden interna verso l'esterno. Ho usato
questo per
+programmare delle calcolatrici HP perch@'e @`e piuttosto facile da adattare ai
+dispositivi di scarsa memoria con dimensioni di parola piuttosto piccole.
+Si veda
address@hidden://www.hpmuseum.org/cgi-sys/cgiwrap/hpmuseum/articles.cgi?read=899}.
address@hidden quotation
+
address@hidden Problemi virgola mobile POSIX
address@hidden Confronto tra standard e uso corrente
+
+Per diverso tempo, @command{awk} ha convertito le stringhe dall'aspetto non
+numerico nel valore numerico zero, quando richiesto. Per di address@hidden, la
+definizione originaria del linguaggio e lo standard POSIX originale prevedevano
+che @command{awk} riconoscesse solo i numeri decimali (base 10), e non i numeri
+ottali (base 8) o esadecimali (base 16).
+
+Le modifiche nel linguaggio degli standard POSIX 2001 e 2004 possono essere
+interpretate nel senso che @command{awk} debba fornire delle address@hidden
+aggiuntive. Queste sono:
+
address@hidden @value{BULLET}
address@hidden
+Interpretazione del valore dei dati a virgola mobile specificati in notazione
+esadecimale (p.es., @code{0xDEADBEEF}). (Da notare: valore dei dati letti,
address@hidden costanti facenti parte del codice sorgente.)
+
address@hidden
+Supporto per i valori a virgola mobile speciali IEEE 754 ``not a number''
+(NaN), address@hidden infinito (``inf'') e meno infinito (address@hidden'').
+In particolare, il formato per questi valori @`e quello specificato dallo
+standard C ISO 1999, che non distingue maiuscole/minuscole e address@hidden
consentire
+caratteri aggiuntivi dipendenti dall'implementazione dopo il @samp{nan}, e
+consentire o @samp{inf} o @samp{infinity}.
address@hidden itemize
+
+Il primo problema @`e che entrambe le modifiche sono deviazioni evidenti
+dalla prassi consolidata:
+
address@hidden @value{BULLET}
address@hidden
+Il manutentore di @command{gawk} crede che supportare i valori a virgola mobile
+esadecimali, nello specifico, sia sbagliato, e che non sia mai stata intenzione
+dell'autore originale di introdurlo nel linguaggio.
+
address@hidden
+Consentire che stringhe completamente alfabetiche abbiano valori numerici
+validi @`e anch'essa una deviazione molto marcata dalla prassi consolidata.
address@hidden itemize
+
+Il secondo problema @`e che il manutentore di @command{gawk} crede che questa
+interpretazione dello standard, che richiede una certa dimestichezza col
+linguaggio giuridico per essere compresa, non sempre @`e stata
+colta dai normali sviluppatori. In altre parole, ``Sappiamo come siete
+arrivati sin qui, ma non pensiamo che questo sia il posto dove volete essere.''
+
+Recependo queste argomentazioni, e cercando nel contempo di assicurare la
address@hidden con le versioni precedenti dello standard, lo standard POSIX 2008
+ha aggiunto delle formulazioni esplicite per consentire l'uso da parte di
address@hidden, solo a richiesta, dei valori a virgola mobile esadecimali e
+dei valori speciali
address@hidden a number}'' e infinito.
+
+Sebbene il manutentore di @command{gawk} continui a credere che introdurre
+queste address@hidden sia sconsigliabile, address@hidden nonostante, sui
sistemi che
+supportano i valori in virgola mobile IEEE, sembra giusto fornire
address@hidden
address@hidden di usare i valori NaN e infinito. La soluzione implementata
+in @command{gawk} @`e questa:
+
address@hidden @value{BULLET}
address@hidden
+Se @`e stata specificata l'opzione da riga di comando @option{--posix},
address@hidden non
+interviene. I valori di stringa sono passati direttamente alla funzione
address@hidden()} della libreria di sistema, e se quest'ultima restituisce
+senza errori un valore numerico,
+esso viene address@hidden'avete voluto, tenetevelo.}
+Per definizione, i risultati non sono portabili su diversi sistemi;
+e sono anche piuttosto sorprendenti:
+
address@hidden
+$ @kbd{echo nanny | gawk --posix '@{ print $1 + 0 @}'}
address@hidden nan
+$ @kbd{echo 0xDeadBeef | gawk --posix '@{ print $1 + 0 @}'}
address@hidden 3735928559
address@hidden example
+
address@hidden
+Senza l'opzione @option{--posix}, @command{gawk} interpreta i quattro valori
di stringa
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+in modo speciale, producendo i corrispondenti valori numerici speciali.
+Il segno iniziale serve per segnalare a @command{gawk} (e all'utente)
+che il valore @`e realmente numerico. I numeri a virgola mobile esadecimali
+non sono consentiti (a meno di non usare anche @option{--non-decimal-data},
+che @emph{non} @`e consigliabile). Per esempio:
+
address@hidden
+$ @kbd{echo nanny | gawk '@{ print $1 + 0 @}'}
address@hidden 0
+$ @kbd{echo +nan | gawk '@{ print $1 + 0 @}'}
address@hidden nan
+$ @kbd{echo 0xDeadBeef | gawk '@{ print $1 + 0 @}'}
address@hidden 0
address@hidden example
+
address@hidden ignora la distinzione maiuscole/minuscole nei quattro valori
+speciali. address@hidden@dotless{i}}, @samp{+nan} e @samp{+NaN} sono la stessa
cosa.
address@hidden itemize
+
address@hidden Sommario virgola mobile
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+La maggior parte dell'aritmetica al calcolatore @`e fatta usando numeri interi
+oppure
+valori a virgola mobile. L'@command{awk} standard usa valori a virgola mobile
+a doppia precisione.
+
address@hidden
+Nei primi anni '90 Barbie disse erroneamente, ``L'ora di matematica @`e
+ostica!'' Sebbene la matematica non sia ostica, l'aritmetica a virgola
+mobile non @`e proprio come la
+matematica ``carta e penna'', e bisogna prestare attenzione:
+
address@hidden nested list
address@hidden @value{MINUS}
address@hidden
+Non tutti i numeri possono essere rappresentati in modo esatto.
+
address@hidden
+Per confrontare dei valori bisognerebbe usare un delta, invece di farlo
+direttamente con @samp{==} e @samp{!=}.
+
address@hidden
+Gli errori si accumulano.
+
address@hidden
+Le operazioni non sempre sono esattamente associative o distributive.
address@hidden itemize
+
address@hidden
+Aumentare l'accuratezza address@hidden essere d'aiuto, ma non @`e una panacea.
+
address@hidden
+Spesso, aumentare la precisione e poi arrotondare al numero di cifre
+desiderato produce risultati soddisfacenti.
+
address@hidden
+Specificare l'opzione @option{-M} (o @option{--bignum}) per abilitare
+il calcolo MPFR.
+Usare @code{PREC} per impostare la precisione in bit, e
address@hidden per impostare la address@hidden di arrotondamento tra quelle
+previste nello standard IEEE 754.
+
address@hidden
+Specificando l'opzione @option{-M}, @command{gawk} esegue calcoli su interi a
precisione
+arbitraria usando la libreria GMP. In tal modo si ha una maggiore
address@hidden e
+una address@hidden efficiente allocazione dello spazio rispetto all'uso di
MPFR per
+eseguire gli stessi calcoli.
+
address@hidden
+Ci sono diverse aree per quanto attiene ai numeri a virgola mobile in cui
address@hidden @`e in disaccordo con lo standard POSIX.
address@hidden importante averlo ben presente.
+
address@hidden
+In generale, non vi @`e alcun bisogno di essere eccessivamente diffidenti
verso i
+risultati del calcolo in virgola mobile. La lezione da ricordare @`e che
+il calcolo in virgola mobile @`e sempre address@hidden complesso di quello che
si fa con
+carta e penna. Per trarre vantaggio dalla potenza del calcolo in virgola
+mobile, bisogna conoscere i suoi limiti e stare all'interno di essi.
+Per la maggior parte degli usi occasionali del calcolo in virgola mobile, si
+possono ottenere i risultati attesi semplicemente arrotondando la
+visualizzazione dei risultati finali al giusto numero di cifre decimali
+significative.
+
address@hidden
+Come consiglio generale, evitare di rappresentare dati numerici in maniera
+tale da far sembrare che la precisione sia maggiore di quella effettivamente
+necessaria.
+
address@hidden itemize
+
address@hidden Estensioni dinamiche
address@hidden Scrivere estensioni per @command{gawk}
address@hidden estensioni caricate dinamicamente
address@hidden dinamiche, estensioni
+
address@hidden possibile aggiungere nuove funzioni, scritte in C o C++, a
@command{gawk}
+usando librerie caricate dinamicamente. Questa address@hidden @`e disponibile
+su sistemi che supportano le funzioni C @code{dlopen()} e @code{dlsym()}.
+Questo @value{CHAPTER} descrive come creare estensioni usando codice scritto
+in C o C++.
+
+Chi @`e completamente digiuno di programmazione in C address@hidden
tranquillamente
+saltare questo @value{CHAPTER}, ma potrebbe valer la pena di dare un'occhiata
+alla documentazione sulle estensioni che sono installate insieme a
address@hidden (@pxref{Esempi di estensione}),
+e alle informazioni sul progetto @code{gawkextlib} (@pxref{gawkextlib}).
+Gli esempi di estensione sono automaticamente compilati e installati quando
+si installa @command{gawk}.
+
address@hidden NOTA
+Se si specifica l'opzione @option{--sandbox}, le estensioni non sono
+disponibili
+(@pxref{Opzioni}).
address@hidden quotation
+
address@hidden
+* Introduzione alle estensioni:: Cos'@`e un'estensione.
+* Licenza delle estensioni:: Una nota riguardo al tipo di licenza.
+* Panoramica sul meccanismo delle estensioni:: Una panoramica sul meccanismo
+ delle estensioni.
+* Descrizione dell'API delle estensioni:: Una descrizione completa dell'API.
+* Trovare le estensioni:: Come @command{gawk} trova le estensioni
+ compilate.
+* Esempio di estensione:: Esempio di codice C di un'estensione.
+* Esempi di estensione:: Le estensioni di esempio incluse con
+ @command{gawk}.
+* gawkextlib:: Il progetto @code{gawkextlib}.
+* Sommario delle estensioni:: Sommario delle estensioni.
+* Esercizi sulle estensioni:: Esercizi.
address@hidden menu
+
address@hidden Introduzione alle estensioni
address@hidden Cos'@`e un'estensione
+
address@hidden plug-in
+Un'@dfn{estensione} (talora chiamata @dfn{plug-in}) @`e un frammento di codice
+compilato esternamente che @command{gawk} address@hidden caricare in fase di
esecuzione
+per ottenere address@hidden ulteriori, che vanno ad aggiungersi a quelle di
address@hidden descritte nel resto di questo @value{DOCUMENT}.
+
+Le estensioni sono utili perch@'e consentono (ovviamente) di estendere le
address@hidden di @command{gawk}. Per esempio, possono permettere l'uso di
address@hidden di sistema} (come @code{chdir()} per cambiare directory)
+e di altre routine di libreria C potenzialmente utili. Come per la maggior
+parte del software, ``il cielo @`e il limite''; se si riesce a immaginare
+qualcosa che si vuol fare e che @`e possibile programmare in C o C++,
+si address@hidden scrivere un'estensione che lo faccia!
+
+Le estensioni sono scritte in C o C++, usando l'API (@dfn{Application
+Programming Interface}) definita per questo scopo dagli sviluppatori di
address@hidden Il resto di questo @value{CHAPTER} descrive
+le address@hidden offerte dall'API e come usarle,
+e illustra una piccola estensione di esempio. Inoltre, sono documentati
+gli esempi di estensione inclusi nella distribuzione di @command{gawk}
+e viene descritto il progetto @code{gawkextlib}.
address@hidden FOR_PRINT
address@hidden delle estensioni}, per una disamina degli obiettivi e del
+progetto del meccanismo delle estensioni.
address@hidden ifclear
address@hidden FOR_PRINT
+Si veda
@uref{http://www.gnu.org/software/gawk/manual/html_node/estensione-Design.html}
+per una disamina degli obiettivi e del
+progetto del meccanismo delle estensioni.
address@hidden ifset
+
address@hidden Licenza delle estensioni
address@hidden Tipo di licenza delle estensioni
+
+Ogni estensione dinamica dev'essere distribuita in base a una licenza che sia
+compatibile con la licenza GNU GPL (@pxref{Copia}).
+
+Per far sapere a @command{gawk} che la licenza @`e quella corretta,
+l'estensione deve definire il simbolo globale
address@hidden Se tale simbolo non @`e stato definito,
address@hidden termina con un messaggio di errore fatale al momento del
+caricamente dell'estensione.
+
+Il tipo dichiarato per il suddetto simbolo dev'essere @code{int}. Esso non
+deve tuttavia essere presente in ogni sezione allocata.
+Il controllo in essere si limita a constatare che quel simbolo esiste a
+livello globale.
+Qualcosa del genere address@hidden essere sufficiente:
+
address@hidden
+int plugin_is_GPL_compatible;
address@hidden example
+
address@hidden Panoramica sul meccanismo delle estensioni
address@hidden Una panoramica sul funzionamento ad alto livello
+
+La comunicazione tra
address@hidden e un'estensione @`e bidirezionale. Dapprima, quando
+un'estensione @`e caricata, @command{gawk} le passa un puntatore a una
struttura
+(@code{struct}) i cui campi sono dei puntatori di funzione.
address@hidden
+Questo si address@hidden vedere in @ref{figura-carica-estensione}.
address@hidden ifnotdocbook
address@hidden
+Questo si address@hidden vedere in @inlineraw{docbook, <xref
linkend="figura-carica-estensione"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-carica-estensione
address@hidden dell'estensione}
address@hidden SMALLPRINT
address@hidden @image{api-figura1, , , Caricamento dell'estensione}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{api-figura1, 11cm, , Caricamento dell'estensione}
address@hidden ifset
+
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-carica-estensione" float="0">
+<title>Caricamento dell'estensione</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="api-figura1.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
+L'estensione @`e in grado di chiamare funzioni all'interno di @command{gawk}
+utilizzando questi puntatori a funzione, in fase di esecuzione, senza aver
+bisogno di accedere (in fase di compilazione), ai simboli di @command{gawk}.
+Uno di questi puntatori a funzione punta a una funzione che serve per
+``registrare'' nuove funzioni.
address@hidden
+Questo @`e mostrato in @ref{figura-registrare-una-nuova-funzione}.
address@hidden ifnotdocbook
address@hidden
+Questo @`e shown in @inlineraw{docbook, <xref
linkend="figura-registrare-una-nuova-funzione"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-registrare-una-nuova-funzione
address@hidden una nuova funzione}
address@hidden SMALLPRINT
address@hidden @image{api-figura2, , , Registrare una nuova funzione}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{api-figura2, 11cm , , Registrare una nuova funzione}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-registrare-una-nuova-funzione" float="0">
+<title>Registering a new function</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="api-figura2.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
+Nella direzione opposta, l'estensione registra le sue nuove funzioni
+con @command{gawk} passando dei puntatori che puntano alle funzioni che
+implementano la nuova address@hidden, (p.es. @code{do_chdir()}).
@command{gawk}
+associa il puntatore a funzione con un nome ed @`e in grado di chiamarlo in
+seguito, usando una convenzione di chiamata predefinita.
address@hidden
+Questo @`e mostrato in @ref{figura-chiamata-nuova-funzione}.
address@hidden ifnotdocbook
address@hidden
+Questo @`e mostrato in @inlineraw{docbook, <xref
linkend="figura-chiamata-nuova-funzione"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-chiamata-nuova-funzione
address@hidden della nuova funzione}
address@hidden SMALLPRINT
address@hidden @image{api-figura3, , , Chiamata della nuova funzione}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{api-figura3,11cm , , Chiamata della nuova funzione}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-chiamata-nuova-funzione" float="0">
+<title>Chiamata della nuova funzione</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="api-figura3.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
+La funzione @address@hidden()}, a sua volta, utilizza i puntatori a
+funzione nella struttura (@code{struct}) API per svolgere il proprio compito,
+come aggiornare variabili o vettori, stampare messaggi, impostare la
+variabile @code{ERRNO}, e address@hidden@dotless{i}} via.
+
+Delle macro di servizio rendono la chiamata effettuata utilizzando
+i puntatori simile a quella delle funzioni normali, in modo che il codice
+sorgente delle estensioni rimanga sufficientemente leggibile e comprensibile.
+
+Sebbene tutto address@hidden possa sembrare piuttosto complesso, il risultato
@`e che il
+codice sorgente dell'estensione @`e abbastanza intuitivo da scrivere e da
+leggere. Lo si address@hidden constatare nell'estensione di esempio
address@hidden
+(@pxref{Esempio di estensione}), come pure nel codice @file{testext.c},
+che testa l'interfaccia di programmazione (API).
+
+Ecco alcuni ulteriori dettagli:
+
address@hidden @value{BULLET}
address@hidden
+L'API fornisce accesso ai valori delle variabili @command{gawk}
address@hidden@var{xxx}}, che memorizzano opzioni della riga di comando come
address@hidden, @code{do_profiling}, e address@hidden@dotless{i}} via
(@pxref{Variabili dell'estensione API}).
+Questi valori sono solo informativi: un'estensione non address@hidden
modificarli
+all'interno di @command{gawk}. Oltre a address@hidden, il tentativo di
assegnare loro
+dei valori produce un errore quando l'estensione viene compilata.
+
address@hidden
+L'API fornisce anche i numeri che identificano la specifica versione di
address@hidden, in modo che un'estensione possa controllare se il
+comando @command{gawk} che l'ha caricata @`e in grado di supportare le
address@hidden utilizzate nell'estensione. (Discrepanze tra le versioni
+``non dovrebbero'' accadere, ma si sa come vanno @emph{queste} cose.)
address@hidden dell'estensione} per ulteriori dettagli.
address@hidden itemize
+
address@hidden Descrizione dell'API delle estensioni
address@hidden Una descrizione completa dell'API
address@hidden estensioni, API delle
address@hidden API, delle estensioni
+
+Il codice sorgente scritto in C o C++ per un'estensione deve includere il
+file di intestazione
address@hidden, che dichiara le funzioni e definisce i tipi di dati
+usati per comunicare con @command{gawk}.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
+(non breve) @value{SECTION} descrive l'API in detttaglio.
+
address@hidden
+* Intro funzioni API delle estensioni:: Introduzione alle funzioni dell'API.
+* Tipi di dati generali:: I tipi di dati.
+* Funzioni di allocazione memoria:: Funzioni per allocare memoria.
+* Funzioni di costruzione:: Funzioni per creare valori.
+* Funzioni di registrazione:: Funzioni per registrare cose con
+ @command{gawk}.
+* Stampare messaggi:: Funzioni per stampare messaggi.
+* Aggiornare @code{ERRNO}:: Funzioni per aggiornare @code{ERRNO}.
+* Richiedere valori:: Come ottenere un valore.
+* Accedere ai parametri:: Funzioni per accedere ai parametri.
+* Accedere alla tabella simboli:: Funzioni per accedere alle variabili
+ globali
+* Manipolazione di vettori:: Funzioni per lavorare coi vettori.
+* Ridirezione API:: Come accedere alla ridirezioni e
+ modificarle.
+* Variabili dell'estensione API:: Variabili fornite dall'API.
+* Codice predefinito di un'estensione API:: Codice predefinito di
+ interfaccia API.
+* Modifiche dalla versione API 1:: Modifiche dalla versione 1 dell'API.
address@hidden menu
+
address@hidden Intro funzioni API delle estensioni
address@hidden Introduzione alle funzioni dell'API
+
+L'accesso a address@hidden interne a @command{gawk} @`e effettuato
+con una chiamata che usa i puntatori a funzione resi disponibili
+all'estensione.
+
+Puntatori a funzioni API sono previsti per i seguenti tipi di operazioni:
+
address@hidden @value{BULLET}
address@hidden
+Allocare, riallocare e liberare memoria.
+
address@hidden
+Registrare funzioni. Si possono registrare:
+
address@hidden nested list
address@hidden @value{MINUS}
address@hidden
+Funzioni di estensione
address@hidden
+Funzioni ausiliarie di pulizia (@dfn{callbacks})
address@hidden
+Una stringa di caratteri che identifica la versione
address@hidden
+Funzioni per analizzare l'input
address@hidden
+Funzioni per modificare l'output
address@hidden
+Processori bidirezionali
address@hidden itemize
+
+Tutti questi elementi sono spiegati dettagliatamente nel resto di questo
@value{CHAPTER}.
+
address@hidden
+Stampare messaggi fatali, di avvertimento e quelli generati dall'opzione
+``lint''.
+
address@hidden
+Modificare @code{ERRNO} o annullarne il valore.
+
address@hidden
+Accedere a parametri, compresa la address@hidden di definire come vettore
+un parametro ancora indefinito.
+
address@hidden
+Accedere alla "tabella dei simboli": procurarsi il valore di una variabile
+globale, crearne una nuova o modificarne una address@hidden esistente.
+
address@hidden
+Creare ed eliminare valori nascosti; address@hidden rende possibile usare un
+particolare valore per address@hidden di una variabile, e address@hidden
migliorare parecchio
+le prestazioni.
+
address@hidden
+Manipolare vettori:
+
address@hidden @value{MINUS}
address@hidden
+Ritrovare il valore di elementi del vettore, aggiungerne di nuovi,
+cancellare e modificare elementi esistenti.
+
address@hidden
+Ottenere il numero di elementi presenti in un vettore
+
address@hidden
+Creare un nuovo vettore
+
address@hidden
+Cancellare un intero vettore
+
address@hidden
+Appiattire un vettore per poter facilmente eseguire un ciclo, in stile C,
+su tutti i suoi indici ed elementi
address@hidden itemize
+
address@hidden
+Accedere a ridirezioni e manipolarle.
+
address@hidden itemize
+
+Alcune osservazioni riguardo all'uso dell'API:
+
address@hidden @value{BULLET}
address@hidden
+I seguenti tipi di variabili, macro e/o funzioni sono resi disponibili
+nel file @file{gawkapi.h}. Perch@'e siano utilizzabili, i rispettivi file di
+intestazione standard indicati devono essere stati specificati @emph{prima}
+di includere @file{gawkapi.h}:
+
address@hidden FIXME: Make this as a float at some point.
address@hidden address@hidden()}, @code{memcpy()}} address@hidden<sys/types.h>}}
address@hidden Elemento C @tab File d'intestazione
address@hidden @code{EOF} @tab @code{<stdio.h>}
address@hidden valori di @code{errno} @tab @code{<errno.h>}
address@hidden @code{FILE} @tab @code{<stdio.h>}
address@hidden @code{NULL} @tab @code{<stddef.h>}
address@hidden @code{memcpy()} @tab @code{<string.h>}
address@hidden @code{memset()} @tab @code{<string.h>}
address@hidden @code{size_t} @tab @code{<sys/types.h>}
address@hidden @code{struct stat} @tab @code{<sys/stat.h>}
address@hidden multitable
+
+Per ragioni di address@hidden, specialmente per sistemi
+che non sono interamente aderenti agli standard, occorre assicurarsi di
+includere i file corretti nel modo corretto. Questa richiesta mira
+a mantenere il file @file{gawkapi.h} ordinato, invece che farlo diventare
+un'accozzaglia di problemi di address@hidden, quale si address@hidden vedere
in alcune
+parti del codice sorgente di @command{gawk}.
+
address@hidden
+Il file @file{gawkapi.h} address@hidden essere incluso address@hidden volte,
senza conseguenze
+negative. Tuttavia sarebbe meglio evitare di farlo, per uno
+stile di programmazione migliore.
+
address@hidden
+Sebbene l'API usi solo address@hidden ISO C 90, c'@`e un'eccezione; le funzione
+``costruttrici'' usano la parola chiave @code{inline}. Se il compilatore in
+uso non supporta questa parola chiave, si dovrebbe specificare sulla
+riga di comando il parametro @samp{-Dinline=''} oppure usare gli strumenti
+Autotools GNU e includere un file
address@hidden nel codice sorgente delle estensioni.
+
address@hidden
+Tutti i puntatori messi a disposizione da @command{gawk} puntano ad aree
+di memoria gestite da @command{gawk} e dovrebbero essere trattati
+dall'estensione come in sola lettura. Le aree di memoria che contengono
@emph{tutte} le stringhe passate a
address@hidden dall'estensione @emph{devono} provenire da una chiamata a
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()},
+e sono gestite da @command{gawk} da quel punto in avanti.
+
address@hidden
+L'API definisce parecchie semplici @code{struct} che mappano dei valori
+come sono visti da @command{awk}. Un valore address@hidden essere un numero
@code{double}
+(a virgola mobile, in doppia precisione), una stringa o un
+vettore (come @`e il caso per i vettori multidimensionali o nella creazione di
+un nuovo vettore).
+
+I valori di tipo stringa sono costituiti da un puntatore e da una lunghezza,
+poich@'e nella stringa possono essere presenti dei caratteri @sc{nul}
+(zeri binari, che normalmente marcano la fine di una stringa).
+
address@hidden NOTA
+Di proposito, @command{gawk} immagazzina le stringhe usando la codifica
+multibyte correntemente in uso (come definita dalle variabili d'ambiente
address@hidden@var{xxx}}) e non usando dei caratteri larghi (ovvero due byte per
+ogni carattere). address@hidden riflette il modo con cui @command{gawk}
memorizza le
+stringhe internamente, e anche il modo in cui i caratteri sono
+verosimilmente letti dai file in input e scritti nei file in output.
address@hidden quotation
+
address@hidden NOTA
+I valori di una stringa passati a un'estensione da @command{gawk} hanno
+sempre un carattere @sc{nul} alla fine (come delimitatore). Quindi @`e
+possibile usare senza inconvenienti tali valori di stringa per chiamare
+funzioni di libreria standard e routine di sistema. Tuttavia, poich@'e
address@hidden consente che all'interno di una stringa di dati possano
+essere presenti caratteri @sc{nul}, si dovrebbe controllare che la
+lunghezza di ogni stringa passata un'estensione coincida con il valore
+restituito dalla funzione @code{strlen()} per la stringa stessa.
address@hidden quotation
+
address@hidden
+Per ottenere un valore (p.es. quello di un parametro o quello di una
+variabile globale, oppure di un elemento di un vettore), l'estensione chiede
+un tipo specifico di variabile (numero, stringa,
+scalare, @dfn{value cookie} [si veda address@hidden avanti], vettore o
``undefined'').
+Quando la richiesta @`e
+``undefined,'' il valore restituito address@hidden quello originale della
variabile in
+questione.
+
+In ogni caso, se la richiesta e il tipo effettivo della variabile non
+corrispondono, la funzione di accesso restituisce ``false'' e fornisce il
+tipo proprio della variabile, in modo che l'estensione possa, p.es.,
+stampare un messaggio di errore
+(del tipo ``ricevuto uno scalare, invece del vettore previsto'').
+
address@hidden This is documented in the header file and needs some expanding
upon.
address@hidden The table there should be presented here
address@hidden itemize
+
+Si possono chiamare le funzioni dell'API usando i puntatori a funzione
+direttamente, ma l'interfaccia non @`e molto elegante. Per permettere al
+codice sorgente delle estensioni di assomigliare di address@hidden a un codice
normale,
+il file di intestazione @file{gawkapi.h} definisce parecchie
+macro da usare nel codice sorgente dell'estensione.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden presenta le macro come se si trattasse di funzioni.
+
address@hidden Tipi di dati generali
address@hidden I tipi di dati di impiego generale
+
address@hidden Robbins, Arnold
address@hidden Ramey, Chet
address@hidden
address@hidden un vero rapporto di amore/odio con le @dfn{unioni}.}
address@hidden Arnold Robbins
address@hidden quotation
+
address@hidden
address@hidden @`e address@hidden che contraddistingue le @dfn{unioni}: il
compilatore @`e
+in grado di accomodare le cose in modo da far coesistere amore e odio.}
address@hidden Chet Ramey
address@hidden quotation
+
+L'estensione API definisce un certo numero di semplici tipi di dato e
+strutture di uso generale. Ulteriori strutture di dati, address@hidden
specializzate,
+saranno introdotte
address@hidden
+nelle successive
address@hidden ifnotinfo
address@hidden
+nei successivi
address@hidden ifinfo
address@hidden, insieme alle funzioni che ne fanno uso.
+
+I tipi di dati e le strutture di uso generale sono le seguenti:
+
address@hidden @code
address@hidden typedef void *awk_ext_id_t;
+Un valore di questo tipo @`e trasmesso da @command{gawk} a un'estensione nel
+momento in cui viene caricata. Tale valore dev'essere restituito
+a @command{gawk} come primo parametro di ogni funzione API.
+
address@hidden #define awk_const @dots{}
+Questa macro genera delle @samp{costanti} nel momento in cui si compila
+un'estensione, e non genera nulla quando si compila il comando @command{gawk}
+vero e proprio. address@hidden rende alcuni
+campi nelle strutture dei dati dell'API non alterabili dal codice sorgente
+dell'estensione, ma consente al comando @command{gawk} di usarle secondo
address@hidden
+
address@hidden typedef enum awk_bool @{
address@hidden @ @ @ @ awk_false = 0,
address@hidden @ @ @ @ awk_true
address@hidden @} awk_bool_t;
+Un semplice tipo di variabile booleana.
+
address@hidden typedef struct awk_string @{
address@hidden @ @ @ @ char *str;@ @ @ @ @ /* dati veri e propri */
address@hidden @ @ @ @ size_t len;@ @ @ @ /* lunghezza degli stessi, in
caratteri */
address@hidden @} awk_string_t;
+Questo rappresenta una stringa modificabile. @command{gawk} @`e responsabile
+per la gestione della memoria utilizzata, se ha fornito il valore della
+stringa. Altrimenti, assume il possesso della memoria in questione.
address@hidden memoria dev'essere resa disponibile chiamando una delle funzioni
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}!}
+
+Come address@hidden detto, la rappresentazione delle stringhe in memoria usa
la codifica
+multibyte corrente.
+
address@hidden typedef enum @{
address@hidden @ @ @ @ AWK_UNDEFINED,
address@hidden @ @ @ @ AWK_NUMBER,
address@hidden @ @ @ @ AWK_STRING,
address@hidden @ @ @ @ AWK_REGEX,
address@hidden @ @ @ @ AWK_STRNUM,
address@hidden @ @ @ @ AWK_ARRAY,
address@hidden @ @ @ @ AWK_SCALAR,@ @ @ @ @ @ @ @ @ /* accesso opaco a una
variabile */
address@hidden @ @ @ @ AWK_VALUE_COOKIE@ @ @ @ /* per aggiornare un valore
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ address@hidden
creato */
address@hidden @} awk_valtype_t;
+L'elenco @code{enum} indica di che tipo @`e un certo valore.
address@hidden usato nella seguente struttura @code{struct}.
+
address@hidden typedef struct awk_value @{
address@hidden @ @ @ @ awk_valtype_t val_type;
address@hidden @ @ @ @ union @{
address@hidden @ @ @ @ @ @ @ @ awk_string_t@ @ @ @ @ @ @ s;
address@hidden @ @ @ @ @ @ @ @ double@ @ @ @ @ @ @ @ @ @ @ @ @ d;
address@hidden @ @ @ @ @ @ @ @ awk_array_t@ @ @ @ @ @ @ @ a;
address@hidden @ @ @ @ @ @ @ @ awk_scalar_t@ @ @ @ @ @ @ scl;
address@hidden @ @ @ @ @ @ @ @ awk_value_cookie_t@ vc;
address@hidden @ @ @ @ @} u;
address@hidden @} awk_value_t;
+Un ``valore di @command{awk}''.
+Il campo @code{val_type} indica che tipo di valore @code{union} contiene,
+e ogni campo @`e del tipo appropriato.
+
address@hidden #define str_value@ @ @ @ @ @ u.s
address@hidden #define strnum_value@ @ @ str_value
address@hidden #define regex_value@ @ @ @ str_value
address@hidden #define num_value@ @ @ @ @ @ u.d
address@hidden #define array_cookie@ @ @ u.a
address@hidden #define scalar_cookie@ @ u.scl
address@hidden #define value_cookie@ @ @ u.vc
+L'uso di queste macro rende address@hidden facile da seguire l'accesso ai
campi di
address@hidden
+
address@hidden typedef void *awk_scalar_t;
+La variabili scalari possono essere rappresentate da un tipo opaco. Questi
+valori sono ottenuti da @command{gawk} e in seguito gli vengono restituiti.
+Questo argomento @`e discusso in maniera generale nel testo che segue questa
+lista, e address@hidden in dettaglio
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden simboli tramite cookie}.
+
address@hidden typedef void *awk_value_cookie_t;
+Un address@hidden cookie}'' @`e un tipo di variabile opaca, e
+rappresenta un valore nascosto.
+Anche questo argomento @`e discusso in maniera generale nel testo che segue
+questa lista, e address@hidden in dettaglio
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden nascosti}.
+
address@hidden table
+
+I valori di tipo scalare in @command{awk} sono numeri, stringhe, @dfn{strnum}
+o @dfn{regexp} fortemente tipizzate.
+La struttura @code{awk_value_t} rappresenta valori.
+Il campo @code{val_type} indica cosa contiene @code{union}.
+
+Rappresentare numeri @`e facile: l'API usa una variabile C di tipo
address@hidden Le stringhe richiedono
+uno sforzo maggiore. Poich@'e
address@hidden consente che le stringhe contengano dei byte @sc{nul}
+(a zeri binari) nel valore di una stringa, una stringa dev'essere
+rappresentata da una coppia di campi che contengono il puntatore al dato vero
+e proprio e la lunghezza della stringa.
address@hidden questo @`e il tipo @code{awk_string_t}.
+
+Un valore di tipo @dfn{strnum} (stringa numerica) @`e rappresentato come una
+stringa e consiste di dati in input forniti dall'utente che appaiono essere
+numerici.
+Quando una funzione di estensione crea un valore di tipo @dfn{strnum}, il
+risultato @`e una stringa che viene marcata come immessa dall'utente. La
+successiva analisi da parte di @command{gawk} address@hidden poi a determinare
se
+la stringa appare essere un numero, e va quindi trattata come @dfn{strnum},
+invece che come una normale stringa di caratteri.
+
address@hidden @`e utile nei casi un cui una funzione di estensione desideri
fare qualcosa
+di paragonabile alla funzione @code{split}, la quale imposta l'attributo
+di @dfn{strnum} agli elementi di vettore che crea.
+Per esempio, un'estensione che implementi la divisione di record CSV
+(Comma Separated Values, i cui elementi sono delimitati da virgole)
+potrebbe voler usare questa address@hidden Un'altra situazione in cui
address@hidden
address@hidden utile @`e quello di una funzione che richieda campi-dati ad una
banca di
+dati. La funzione @code{PQgetvalue()} della banca dati PostgreSQ, per
+esempio, restituisce una stringa che address@hidden essere numerica o di tipo
carattere,
+a seconda del contesto.
+
+I valori di @dfn{regexp} fortemente tipizzate
+(@pxref{Costanti @dfn{regexp} forti} non sono molto utili nelle funzioni di
+estensione. Le funzioni di estensione possono stabilire di averli ricevuti,
+e crearne, attribuendo valori di tipo scalare. In alternativa, @`e possibile
+esaminare il testo della @dfn{regexp} utilizzando campi @code{regex_value.str}
+e @code{regex_value.len}.
+
+Identificativi (address@hidden, nomi di variabili globali) possono essere
+associati sia a valori scalari che a vettori. Inoltre, @command{gawk}
+consente veri vettori di vettori, in cui ogni singolo elemento di un vettore
address@hidden a sua volta essere un vettore. La spiegazione dei vettori @`e
rinviata
address@hidden
+alla
address@hidden iftex
address@hidden
+a
address@hidden ifnottex
address@hidden di vettori}.
+
+La varie macro sopra elencate facilitano l'uso degli elementi delle
address@hidden come se
+fossero campi in una @code{struct}; @`e questa una pratica comunemente adottata
+nella scrittura di programmi in C. Questo tipo di codice @`e address@hidden
semplice da
+scrivere e da leggere, ma resta una address@hidden @emph{del programmatore}
+assicurarsi che il campo @code{val_type} rifletta correttamente il tipo
+del valore contenuto nella struttura @code{awk_value_t}.
+
+Dal punti di vista concettuale, i primi tre campi dell'@code{union} (numero,
+stringa, e vettore) sono sufficienti per lavorare con i valori @command{awk}.
+Tuttavia, poich@'e l'API fornisce routine per ottenere e modificare
+il valore di una variabile scalare globale usando solo il nome della
+variabile, si ha qui una perdita di efficienza: @command{gawk} deve cercare
+la variabile ogni volta che questa @`e utilizzata e modificata. Questo
address@hidden un probelma reale, non solo un problema teorico.
+
+Per questo motivo, se si sa che una certa estensione address@hidden molto tempo
+a leggere e/o modificare il valore di una o address@hidden variabili scalari,
si address@hidden
+ottenere uno @dfn{scalar address@hidden veda
address@hidden://catb.org/jargon/html/C/cookie.html, la voce ``cookie''
+nello Jargon file}
+per una definizione di @dfn{cookie}, e
address@hidden://catb.org/jargon/html/M/magic-cookie.html, la voce ``magic
cookie''
+sempre nello Jargon file} per un bell'esempio.
address@hidden FOR_PRINT
+Si veda anche la voce ``Cookie'' nel @ref{Glossario}.
address@hidden ifclear
address@hidden://jhanc.altervista.org/jargon/Intro.html, @`E disponibile in rete
+anche una traduzione italiana dello Jargon file}]
+}
+per quella variabile, e poi usare
+il @dfn{cookie} per ottenere il valore della variabile o per modificarne il
+valore.
+Il tipo @code{awk_scalar_t} contiene uno @dfn{scalar cookie}, e la macro
address@hidden fornisce accesso al valore di quel tipo
+nella struttura @code{awk_value_t}.
+Dato uno @dfn{scalar cookie}, @command{gawk} address@hidden trovare o
modificare
+direttamente il valore, come richiesto, senza bisogno di andarlo
+a cercare ogni volta.
+
+Il tipo @code{awk_value_cookie_t} e la macro @code{value_cookie} sono simili.
+Se si pensa di dover usare
+lo stesso @emph{valore} numerico o la stessa @emph{stringa} per una o
address@hidden
+variabili, si address@hidden creare il valore una volta per tutte, mettendo da
parte un
address@hidden@dfn{value cookie}} per quel valore, e in seguito specificare quel
address@hidden cookie} quando si desidera impostare il valore di una variabile.
address@hidden consente di risparmiare spazio in memoria all'interno del
processo
+di @command{gawk} e riduce il tempo richiesto per creare il valore.
+
address@hidden Funzioni di allocazione memoria
address@hidden Funzioni per allocare memoria e macro di servizio
address@hidden allocare memoria per estensioni
address@hidden memoria, allocare per estensioni
address@hidden estensioni, allocare memoria per
+
+L'API fornisce alcune funzioni per effettuare @dfn{allocazioni di memoria}
+che possono essere passate a @command{gawk}, e anche un certo numero di
+macro che possono tornare utili.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden le presenta come prototipi di funzione, nel modo
+con cui il codice dell'estensione potrebbe usarle:
+
address@hidden @code
address@hidden void *gawk_malloc(size_t size);
+Chiama la versione corretta di @code{malloc()} per allocare memoria,
+che address@hidden in seguito essere messa a disposizione di @command{gawk}.
+
address@hidden void *gawk_calloc(size_t nmemb, size_t size);
+Chiama la versione corretta di @code{calloc()} per allocare memoria che
+che address@hidden in seguito essere messa a disposizione di @command{gawk}.
+
address@hidden void *gawk_realloc(void *ptr, size_t size);
+Chiama la versione corretta di @code{realloc()} per allocare memoria
+che address@hidden in seguito essere messa a disposizione di @command{gawk}.
+
address@hidden void gawk_free(void *ptr);
+Chiama la versione corretta di @code{free()} per liberare memoria che
+era stata allocata con
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
address@hidden table
+
+L'API deve fornire queste funzioni perch@'e @`e possibile
+che un'estensione sia stata compilata e costruita usando una versione
+diversa della libreria C rispetto a quella usata per il programma eseguibile
address@hidden@footnote{Questo succede address@hidden spesso nei sistemi
MS-Windows,
+ma address@hidden capitare anche in sistemi di tipo Unix.}
+Se @command{gawk} usasse la propria versione di @code{free()} per liberare
+della memoria acquisita tramite una differente versione di @code{malloc()},
+il risultato sarebbe molto probabilmente differente da quello atteso.
+
+Due macro di address@hidden possono essere usate per allocare memoria
+tramite @code{gawk_malloc()} e
address@hidden()}. Se l'allocazione non riesce, @command{gawk}
+termina l'esecuzione con un messaggio di errore fatale.
+Queste macro dovrebbero essere usate come se fossero dei richiami a
+procedure che non restituiscono un codice di ritorno:
+
address@hidden @code
address@hidden #define emalloc(pointer, type, size, message) @dots{}
+Gli argomenti per questa macro sono i seguenti:
+
address@hidden nested table
address@hidden @code
address@hidden pointer
+La variabile di tipo puntatore che address@hidden alla memoria allocata.
+
address@hidden type
+Il tipo della variabile puntatore. Questo @`e usato per definire il tipo
+quando si chiama @code{gawk_malloc()}.
+
address@hidden size
+Il numero totale di byte da allocare.
+
address@hidden message
+Un messaggio da anteporre all'eventuale messaggio di errore fatale.
+Questo @`e solitamente il nome della funzione che sta usando la macro.
address@hidden table
+
address@hidden
+Per esempio, si potrebbe allocare il valore di una stringa
address@hidden@dotless{i}}:
+
address@hidden
+awk_value_t risultato;
+char *message;
+const char greet[] = "non v'allarmate!";
+
+emalloc(message, char *, sizeof(greet), "myfunc");
+strcpy(message, greet);
+make_malloced_string(message, strlen(message), & risultato);
address@hidden example
+
address@hidden #define erealloc(pointer, type, size, message) @dots{}
+Questo @`e simile a @code{emalloc()}, ma chiama @code{gawk_realloc()}
+invece che @code{gawk_malloc()}.
+Gli argomenti sono gli stessi della macro @code{emalloc()}.
address@hidden table
+
address@hidden Funzioni di costruzione
address@hidden Funzioni per creare valori
+
+L'API fornisce varie funzioni di @dfn{costruzione} per creare
+valori di tipo stringa e di tipo numerico, e anche varie macro di
address@hidden
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden le presenta tutte come prototipi di funzione, nel
+modo in cui il codice sorgente di
+un'estensione le userebbe:
+
address@hidden @code
address@hidden static inline awk_value_t *
address@hidden make_const_string(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione mette il valore di una stringa nella variabile
address@hidden puntata da @code{risultato}. La funzione presuppone che
address@hidden sia una costante stringa C
+(o altri dati che formano una stringa), e automaticamente crea una
address@hidden dei dati che address@hidden immagazzinata in @code{risultato}.
+Viene restituito il puntatore @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_malloced_string(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione mette il valore di una stringa nella variabile
address@hidden puntata da @code{risultato}. Si presuppone che
address@hidden sia un valore @samp{char *}
+che punta a dati ottenuti in precedenza per mezzo di
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
+L'idea @`e che questi dati siano comunicati direttamente a @command{gawk},
+che se ne assume la address@hidden
+Viene restituito il puntatore @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_null_string(awk_value_t *risultato);
+Questa funzione specializzata crea una stringa nulla (il valore ``undefined'')
+nella variabile @code{awk_value_t} puntata da @code{risultato}.
+Viene restituito il puntatore @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_number(double num, awk_value_t *risultato);
+Questa funzione crea semplicemente un valore numerico nella variabile
address@hidden, puntata da @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_const_user_input(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione @`e identica a @code{make_const_string()}, ma la stringa @`e
+marcata come input dell'utente, che address@hidden essere trattata come
@dfn{strnum}
+se il contenuto della stringa appare essere numerico.
+
address@hidden static inline awk_value_t *
address@hidden make_malloced_user_input(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione @`e identica a @code{make_malloced_string()}, ma la stringa @`e
+marcata come input dell'utente, che address@hidden essere trattata come
@dfn{strnum}
+se il contenuto della stringa appare essere numerico.
+
address@hidden static inline awk_value_t *
address@hidden make_const_regex(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione crea un valore di @dfn{regexp} fortemente tipizzata, allocando
una
+copia della stringa.
address@hidden @`e l'espressione regolare, di lunghezza @code{lunghezza}.
+
address@hidden static inline awk_value_t *
address@hidden make_malloced_regex(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione crea un valore di @dfn{regexp} fortemente tipizzata.
address@hidden @`e l'espressione regolare, di lunghezza @code{lunghezza}.
+Si aspetta che @code{stringa} sia un valore di tipo @samp{char *} che punta a
+dati ottenuti in precedenza tramite una chiamata a
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
+
address@hidden table
+
address@hidden Funzioni di registrazione
address@hidden Funzioni di registrazione
address@hidden registrazione di estensione
address@hidden estensione, registrazione di
+
+Questa @value{SECTION} descrive le funzioni dell'API per
+registrare parti di un'estensione con @command{gawk}.
+
address@hidden
+* Funzioni di estensione:: Registrare funzioni di estensione.
+* Funzioni di exit callback:: Registrare una exit di callback.
+* Stringa di versione Estensioni:: Registrare una stringa di versione.
+* Analizzatori di input:: Registrare un analizzatore di input.
+* Processori di output:: Registrare un processore di output.
+* Processori bidirezionali:: Registrare un processore bidirezionale.
address@hidden menu
+
address@hidden Funzioni di estensione
address@hidden Registrare funzioni di estensione
+
+Le funzioni di estensione sono descritte dal seguente tracciato record:
+
address@hidden
+typedef struct awk_ext_func @{
+@ @ @ @ const char *name;
+@ @ @ @ awk_value_t *(*const function)(int num_actual_args,
+@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_value_t *risultato,
+@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ struct
awk_ext_func *finfo);
+@ @ @ @ const size_t max_expected_args;
+@ @ @ @ const size_t min_required_args;
+@ @ @ @ awk_bool_t suppress_lint;
+@ @ @ @ void *data; /* puntatore di tipo opaco
+@ @ @ @ a ogni informazione ulteriore */
address@hidden awk_ext_func_t;
address@hidden example
+
+I campi sono:
+
address@hidden @code
address@hidden const char *name;
+Il nome della nuova funzione.
+Il codice sorgente a livello di @command{awk} richiama la funzione usando
+questo nome.
+Il nome @`e una normale stringa di caratteri del linguaggio C.
+
+I nomi di funzione devono rispettare le stesse regole che valgono per gli
+identificativi @command{awk}.
address@hidden, devono iniziare o con una lettera dell'alfabeto inglese o con un
+trattino basso, che possono essere seguiti da un numero qualsiasi di
+lettere, cifre o trattini bassi.
+L'uso di maiuscolo/minuscolo @`e significativo.
+
address@hidden awk_value_t *(*const function)(int num_actual_args,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_value_t *risultato,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
struct awk_ext_func *finfo);
+Questo @`e un puntatore alla funzione C che fornisce la address@hidden per cui
address@hidden stata scritta l'estensione.
+La funzione deve riempire l'area di memoria puntata da @code{*risultato} con
+un numero, con una stringa, oppure con una @dfn{regexp}.
address@hidden diventa il proprietario di tutte le stringhe di memoria.
+Come address@hidden detto sopra, la stringa di memoria @emph{deve} essere
stata ottenuta
+usando @code{gawk_malloc()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
+
+L'argomento @code{num_actual_args} dice alla funzione scritta in C quanti
+parametri sono stati effettivamente passati dal codice chiamante all'interno
+di @command{awk}.
+
+La funzione deve restituire il valore di @code{risultato}.
+Questo @`e per address@hidden del codice chiamante all'interno di
address@hidden
+
address@hidden size_t max_expected_args;
+Questo @`e il massimo numero di argomenti che la funzione si aspetta di
+ricevere.
+Se chiamata con un numero di argomenti maggiore di questo, e se @`e stato
+richiesto il controllo @dfn{lint}, @command{gawk} stampa un messaggio di
+avvertimento. Per ulteriori informazioni, si veda la descrizione di
address@hidden, address@hidden avanti in questa lista.
+
address@hidden const size_t min_required_args;
+Questo @`e il minimo numero di argomenti che la funzione si aspetta di
+ricevere.
+Se @`e chiamata con un numero inferiore di argomenti, @command{gawk}
+stampa un messaggio di errore fatale ed esce.
+
address@hidden awk_bool_t suppress_lint;
+Questo @dfn{flag} dice a @command{gawk} di non stampare un messaggio
address@hidden se @`e stato richiesto un controllo @dfn{lint} e se sono stati
+forniti address@hidden argomenti di quelli attesi. Una funzione di estensione
address@hidden
+stabilire se @command{gawk} ha address@hidden stampato almeno uno di tali
messaggi
+controllando se @samp{num_actual_args > finfo->max_expected_args}.
+In tal caso, se la funzione non desidera la stampa di ulteriori messaggi,
+dovrebbe impostare @code{finfo->suppress_lint} a @code{awk_true}.
+
address@hidden void *data;
+Questo @`e un puntatore di tipo opaco a tutti quei dati che una funzione
+di estensione desidera avere disponibili al momento della chiamata.
+Passando alla funzione di estensione la struttura @code{awk_ext_func_t}
+e avendo al suo interno questo puntatore disponibile, rende possibile
+scrivere un'unica funzione C o C++ che implementa address@hidden di una
funzione
+di estensione a livello @command{awk}.
address@hidden table
+
+Una volta preparato un record che descrive l'estensione, la funzione di
+estensione va registrata con @command{gawk} usando questa funzione dell'API:
+
address@hidden @code
address@hidden awk_bool_t add_ext_func(const char *namespace, awk_ext_func_t
*func);
+Questa funzione restituisce il valore @dfn{true} se ha successo,
+oppure @dfn{false} in caso contrario.
+Il parametro @code{namespace} non @`e usato per ora; dovrebbe puntare a una
+stringa vuota (@code{""}). Il puntatore @code{func} @`e l'indirizzo di una
address@hidden che rappresenta la funzione stessa, come descritto sopra.
+
address@hidden non modifica address@hidden che @`e puntato da @code{func}, ma la
+funzione di estensione stessa riceve questo puntatore e address@hidden
modificarlo
+e farlo puntare altrove, quindi il puntatore non @`e stato dichiarato
+di tipo costante (@code{const}).
address@hidden table
+
+La combinazione di @code{min_required_args}, @code{max_expected_args},
+e @code{suppress_lint} address@hidden ingenerare confusione. Ecco delle
linee-guida
+sul da farsi.
+
address@hidden @asis
address@hidden Un numero qualsiasi di argomenti @`e valido
+Impostare @code{min_required_args} and @code{max_expected_args} a zero e
+impostare @code{suppress_lint} ad @code{awk_true}.
+
address@hidden Un numero minimo di argomenti @`e richiesto, ma non c'@`e un
limite al numero massimo
+Impostare @code{min_required_args} al minimo richiesto.
+Impostare @code{max_expected_args} a zero e
+impostare @code{suppress_lint} ad @code{awk_true}.
+
address@hidden Un numero minino di argomenti @`e richiesto, ma c'@`e un limite
al numero massimo
+Impostare @code{min_required_args} al minimo richiesto.
+Impostare @code{max_expected_args} al massimo atteso.
+Impostare @code{suppress_lint} ad @code{awk_false}.
+
address@hidden Un numero minino di argomenti @`e richiesto, ma c'@`e un numero
massimo non superabile
+Impostare @code{min_required_args} al minimo richiesto.
+Impostare @code{max_expected_args} al massimo atteso.
+Impostare @code{suppress_lint} ad @code{awk_false}.
+Nella funzione di estensione, controllare che @code{num_actual_args} non
+ecceda @code{f->max_expected_args}. Se il massimo @`e superato, stampare
+un messaggio di errore fatale.
address@hidden table
+
address@hidden Funzioni di exit callback
address@hidden Registrare una funzione @dfn{exit callback}
+
+Una funzione @dfn{exit callback} @`e una funzione che @command{gawk} invoca
+prima di completare l'esecuzione del programma.
+Siffatte funzioni sono utili se ci sono dei compiti generali di ``pulizia''
+che dovrebbero essere effettuati nell'estensione (come chiudere connessioni a
+un @dfn{database} o rilasciare altre risorse).
+Si address@hidden registrare una tale
+funzione con @command{gawk} per mezzo della seguente funzione:
+
address@hidden @code
address@hidden void awk_atexit(void (*funcp)(void *data, int exit_status),
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ void *arg0);
+I parametri sono:
+
address@hidden nested table
address@hidden @code
address@hidden funcp
+Un puntatore alla funzione da chiamare prima che @command{gawk} completi
+l'esecuzione. Il parametro @code{data}
address@hidden il valore originale di @code{arg0}.
+Il parametro @code{exit_status} @`e il valore del codice di ritorno che
address@hidden intende passare alla chiamata di sistema @code{exit()}
+(che termina l'esecuzione del programma).
+
address@hidden arg0
+Un puntatore a un'area dati privata che @command{gawk} mantiene perch@'e
+sia poi passata alla funzione puntata da @code{funcp}.
address@hidden table
address@hidden table
+
+Le funzioni @dfn{exit callback} sono chiamate in ordine inverso rispetto
+a quello con cui @`e stata fatta la registrazione con @command{gawk}
+(LIFO: Last In, First Out).
+
address@hidden Stringa di versione Estensioni
address@hidden Registrare una stringa di versione per un'estensione
+
+Si address@hidden registrare una stringa di versione che indica il nome e la
versione
+di una data estensione a @command{gawk}, come segue:
+
address@hidden @code
address@hidden void register_ext_version(const char *version);
+Registra la stringa puntata da @code{version} con @command{gawk}.
+Si noti che @command{gawk} @emph{non} copia la stringa @code{version}, e
+quindi questa stringa non dovrebbe essere modificata.
address@hidden table
+
address@hidden stampa tutte le stringhe con le versioni di estensione
+registrate, quando viene invocato specificando l'opzione @option{--version}.
+
address@hidden Analizzatori di input
address@hidden Analizzatori di input personalizzati
address@hidden personalizzato, analizzatore di input
address@hidden analizzatore di input personalizzato
address@hidden input, analizzatore di, personalizzato
+
+Per default, @command{gawk} legge file di testo come input. Il valore della
+variabile @code{RS} @`e usato per determinare la fine di un record, e subito
+dopo la variabile @code{FS} (o @code{FIELDWIDTHS} o @code{FPAT}) viene usata
+per suddividerlo in campi
address@hidden
+(@pxrefil{Leggere file}).
address@hidden iftex
address@hidden
+(@pxref{Leggere file}).
address@hidden ifnottex
+Viene inoltre impostato il valore di @code{RT}
+(@pxref{Variabili predefinite}).
+
+Se lo si desidera, @`e possibile fornire un analizzatore di input
+personalizzato. Il compito di un analizzatore di input @`e di restituire un
+record al codice di @command{gawk}, che poi lo address@hidden, accompagnato,
+se necessario, da indicatori del valore e della lunghezza dei dati da usare
+per @code{RT}.
+
+Per fornire un analizzatore personalizzato di input, occorre innanzitutto
+rendere disponibili due funzioni (dove @var{XXX} @`e un nome che fa da prefisso
+all'estensione intera):
+
address@hidden @code
address@hidden awk_bool_t @var{XXX}_can_take_file(const awk_input_buf_t *iobuf);
+Questa funzione esamina l'informazione disponibile in @code{iobuf}
+(che vedremo tra poco). Basandosi su tale informazione,
+decide se l'analizzatore di input personalizzato address@hidden usato per
questo file.
+Se questo @`e il caso, dovrebbe restituire @dfn{true}. Altrimenti,
address@hidden
address@hidden Nessuno stato (valori di variabili, etc.) dovrebbe venire
+modificato all'interno di @command{gawk}.
+
address@hidden awk_bool_t @var{XXX}_take_control_of(awk_input_buf_t *iobuf);
+Quando @command{gawk} decide di passare il controllo del file a questo
+analizzatore di input, address@hidden questa funzione.
+Questa funzione a sua volta deve assegnare un valore ad alcuni campi
+nella struttura @code{awk_input_buf_t} e assicurarsi che
+alcune condizioni siano verificate. Dovrebbe poi restituire @dfn{true}.
+Se si verifica un errore di qualche tipo, i campi in questione non dovrebbero
+venire riempiti, e la funzione dovrebbe restituire @dfn{false}; in questo caso
address@hidden non address@hidden address@hidden l'analizzatore personalizzato
di input.
+I dettagli sono descritti address@hidden avanti.
address@hidden table
+
+L'estensione dovrebbe raccogliere queste funzioni all'interno di una
+struttura @code{awk_input_parser_t}, simile a questa:
+
address@hidden
+typedef struct awk_input_parser @{
+ const char *name; /* nome dell'analizzatore */
+ awk_bool_t (*can_take_file)(const awk_input_buf_t *iobuf);
+ awk_bool_t (*take_control_of)(awk_input_buf_t *iobuf);
+ awk_const struct awk_input_parser *awk_const next; /* per uso
+ di gawk */
address@hidden awk_input_parser_t;
address@hidden example
+
+I campi sono:
+
address@hidden @code
address@hidden const char *name;
+Il nome dell'analizzatore di input. Questa @`e una normale stringa di
caratteri
+del linguaggio C.
+
address@hidden awk_bool_t (*can_take_file)(const awk_input_buf_t *iobuf);
+Un puntatore alla funzione @address@hidden()}.
+
address@hidden awk_bool_t (*take_control_of)(awk_input_buf_t *iobuf);
+Un puntatore alla funzione @address@hidden()}.
+
address@hidden awk_const struct input_parser *awk_const next;
+Questa struttura @`e per uso di @command{gawk};
+per questo motivo @`e marcata @code{awk_const} in modo che l'estensione non
+possa modificarla.
address@hidden table
+
+I passi da seguire sono i seguenti:
+
address@hidden
address@hidden
+Creare una variabile @code{static awk_input_parser_t} e inizializzarla
+adeguatamente.
+
address@hidden
+Quando l'estensione @`e caricata, registrare l'analizzatore personalizzato di
+input con @command{gawk} usando la funzione API @code{register_input_parser()}
+(descritta address@hidden sotto).
address@hidden enumerate
+
+La definizione di una struttura @code{awk_input_buf_t} @`e simile a questa:
+
address@hidden
+typedef struct awk_input @{
+ const char *name; /* nome file */
+ int fd; /* descrittore di file */
+#define INVALID_HANDLE (-1)
+ void *opaque; /* area dati privata
+ per l'analizzatore di input */
+ int (*get_record)(char **out, struct awk_input *iobuf,
+ int *errcode, char **rt_start, size_t *rt_len);
+ ssize_t (*read_func)();
+ void (*close_func)(struct awk_input *iobuf);
+ struct stat sbuf; /* buffer per stat */
address@hidden awk_input_buf_t;
address@hidden example
+
+I campi si possono dividere in due categorie: quelli che sono usati (almeno
+inizialmente) da @address@hidden()}, e quelli che sono usati da
address@hidden@var{XXX}_take_control_of()}. Il primo gruppo di campi, e il
loro uso,
address@hidden address@hidden@dotless{i}} definito:
+
address@hidden @code
address@hidden const char *name;
+Il nome del file.
+
address@hidden int fd;
+Un descrittore di file per il file. Se @command{gawk} riesce ad aprire
+il file, il valore di @code{fd} @emph{non} address@hidden uguale a
address@hidden [descrittore non valido]. In caso contrario,
+quello address@hidden il valore.
+
address@hidden struct stat sbuf;
+Se il descrittore di file @`e valido, @command{gawk} address@hidden riempito i
campi di
+questa struttura invocando la chiamata di sistema @code{fstat()}.
address@hidden table
+
+La funzione @address@hidden()} dovrebbe esaminare i campi di
+cui sopra e decidere se l'analizzatore di input vada usato per il file.
+La decisione address@hidden dipendere da uno stato di @command{gawk} (il valore
+di una variabile definita in precedenza dall'estensione e impostata dal
+codice @command{awk}), dal nome del
+file, dal fatto che il descrittore di file sia valido o no,
+dalle informazioni contenute in @code{struct stat} o da una qualsiasi
+combinazione di questi fattori.
+
+Una volta che @address@hidden()} restituisce @dfn{true}, e
address@hidden ha deciso di usare l'analizzatore personalizzato, viene
+chiamata la funzione @address@hidden()}. Tale funzione
+si occupa di riempire il campo @code{get_record} oppure il campo
address@hidden nella struttura @code{awk_input_buf_t}. La funzione si
+assicura inoltre che @code{fd} @emph{not} sia impostato al valore
address@hidden L'elenco seguente descrive i campi che
+possono essere riempiti da @address@hidden()}:
+
address@hidden @code
address@hidden void *opaque;
+Questo campo @`e usato per contenere qualiasi informazione di stato sia
+necessaria per l'analizzatore di input
+riguardo a questo file. Il campo @`e ``opaco'' per @command{gawk}.
+L'analizzatore di input non @`e obbligato a usare questo puntatore.
+
address@hidden int@ (*get_record)(char@ **out,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ struct@ awk_input *iobuf,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ int *errcode,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ char **rt_start,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ size_t *rt_len);
+Questo puntatore a funzione dovrebbe puntare a una funzione che crea i record
+in input. Tale funzione @`e il nucleo centrale dell'analizzatore di input.
+Il suo modo di operare @`e descritto nel testo che segue questo elenco.
+
address@hidden ssize_t (*read_func)();
+Questo puntatore a funzione dovrebbe puntare a una funzione che ha lo
+stesso comportamento della chiamata di sistema standard POSIX @code{read()}.
address@hidden in alternativa al puntatore a @code{get_record}. Il relativo
comportamento
address@hidden pure descritto nel testo che segue quest'elenco.
+
address@hidden void (*close_func)(struct awk_input *iobuf);
+Questo puntatore a funzione dovrebbe puntare a una funzione che fa
+la ``pulizia finale''. Dovrebbe liberare ogni risorsa allocata da
address@hidden@var{XXX}_take_control_of()}. address@hidden anche chiudere il
file. Se lo fa,
+dovrebbe impostare il campo @code{fd} a @code{INVALID_HANDLE}.
+
+Se @code{fd} @`e ancora diverso da @code{INVALID_HANDLE} dopo la chiamata a
+questa funzione, @command{gawk} invoca la normale chiamata di sistema
address@hidden()}.
+
+Avere una funzione di ``pulizia'' @`e facoltativo. Se l'analizzatore di input
+non ne ha bisogno, basta non impostare questo campo. In questo caso,
address@hidden invoca la normale chiamata di sistema @code{close()} per il
+descrittore di file, che, quindi, dovrebbe essere valido.
address@hidden table
+
+La funzione @address@hidden()} svolge il lavoro di creazione dei
+record in input. I parametri sono i seguenti:
+
address@hidden @code
address@hidden char **out
+Questo @`e un puntatore a una variabile @code{char *} che @`e impostatata in
modo
+da puntare al record. @command{gawk} usa una sua copia locale dei dati,
+quindi l'estensione deve gestire la relativa area di memoria.
+
address@hidden struct awk_input *iobuf
+Questa @`e la struttura @code{awk_input_buf_t} per il file. I campi dovrebbero
+essere usati per leggere i dati (@code{fd}) e per gestire lo stato privato
+(@code{opaque}), se necessario.
+
address@hidden int *errcode
+Se si verifica un errore, @code{*errcode} dovrebbe essere impostato a un
+valore appropriato tra quelli contenuti in @code{<errno.h>}.
+
address@hidden char **rt_start
address@hidden size_t *rt_len
+Se il concetto ``fine record'' @`e applicabile,
address@hidden dovrebbe essere impostato per puntare ai dati da usare come
address@hidden, e @code{*rt_len} dovrebbe essere impostata alla lunghezza di
quel
+campo. In caso contrario, @code{*rt_len} dovrebbe essere impostata a zero.
address@hidden usa una sua copia di questi dati, quindi l'estensione deve
+gestire tale memoria.
address@hidden table
+
+Il codice di ritorno @`e la lunghezza del buffer puntato da
address@hidden oppure @code{EOF}, se @`e stata raggiunta la fine del file o se
+si @`e verificato un errore.
+
+Poich@'e @code{errcode} @`e sicuramente un puntatore valido, non c'@`e
+bisogno di controllare che il valore sia @code{NULL}. @command{gawk}
+imposta @code{*errcode} a zero, quindi non c'@`e bisogno di impostarlo, a meno
+che non si verifichi un errore.
+
+In presenza di un errore, la funzione dovrebbe restituire @code{EOF} e
+impostare @code{*errcode} a un valore maggiore di zero. In questo caso, se
address@hidden non @`e uguale a zero, @command{gawk} automaticamente aggiorna
+la variabile @code{ERRNO} usando il valore contenuto in @code{*errcode}.
+(In generale, impostare @samp{*errcode = errno} dovrebbe essere la
+cosa giusta da fare.)
+
+Invece di fornire una funzione che restituisce un record in input,
address@hidden possibile fornirne una che semplicemente legge dei byte, e lascia
+che sia @command{gawk} ad analizzare i dati per farne dei record. In questo
+caso, i dati dovrebbero essere restituiti nella codifica multibyte propria
+della localizzazione corrente.
+Una siffatta funzione dovrebbe imitare il comportamento della chiamata di
+sistema @code{read()}, e riempire il puntatore @code{read_func} con
+il proprio indirizzo nella struttura @code{awk_input_buf_t}.
+
+Per default, @command{gawk} imposta il puntatore @code{read_func} in modo che
+punti alla chiamata di sistema @code{read()}. In questo modo l'estensione
+non deve preoccuparsi di impostare esplicitamente questo campo.
+
address@hidden NOTA
+Occorre decidere per l'uno o per l'altro metodo: o una funzione che
+restituisce un record o una che restituisce dei dati grezzi. Nel dettaglio,
+se si fornisce una funzione che prepara un record, @command{gawk} la
address@hidden, e non address@hidden mai la funzione che fa una lettura grezza.
address@hidden quotation
+
address@hidden viene distribuito con un'estensione di esempio che legge
+delle directory, restituendo un record per ogni elemento contenuto nella
+directory (@pxref{Esempio di estensione Readdir}. Questo codice sorgente
address@hidden
+essere usato come modello per scrivere un analizzatore di input
+personalizzato.
+
+Quando si scrive un analizzatore di input, si dovrebbe progettare (e
+documentare) il modo con cui si suppone che interagisca con il codice
address@hidden Si address@hidden scegliere di utilizzarlo per tutte le
letture, e
+intervenire solo quando @`e necessario, (come fa l'estensione di
+esempio @code{readdir}). Oppure lo si address@hidden utilizzare a seconda del
+valore preso da una variabile @command{awk}, come fa l'estensione XML
+inclusa nel progetto @code{gawkextlib} (@pxref{gawkextlib}).
+In quest'ultimo caso, il codice in una regola @code{BEGINFILE}
address@hidden controllare @code{FILENAME} ed @code{ERRNO} per decidere se
+attivare un analizzatore di input (@pxref{BEGINFILE/ENDFILE}) oppure no.
+
+Un analizzatore di input va registrato usando la seguente funzione:
+
address@hidden @code
address@hidden void register_input_parser(awk_input_parser_t *input_parser);
+Registra l'analizzatore di input puntato da @code{input_parser} con
address@hidden
address@hidden table
+
address@hidden Processori di output
address@hidden Registrare un processore di output
address@hidden personalizzato, processore di output
address@hidden processore di output personalizzato
address@hidden output, processore di, personalizzato
+
address@hidden processore di output
address@hidden output, processore di
+Un @dfn{processore di output} @`e l'immagine riflessa di un
+analizzatore di input.
+Consente a un'estensione di prendere il controllo dell'output
+indirizzato verso un file
+che sia stato aperto con gli operatori di ridirezione di I/O
address@hidden>} o @samp{>>} (@pxref{Ridirezione}).
+
+Il processore di output @`e molto simile, come struttura,
+all'analizzatore di input:
+
address@hidden
+typedef struct awk_output_wrapper @{
+ const char *name; /* nome del processore */
+ awk_bool_t (*can_take_file)(const awk_output_buf_t *outbuf);
+ awk_bool_t (*take_control_of)(awk_output_buf_t *outbuf);
+ awk_const struct awk_output_wrapper *awk_const next; /* per gawk */
address@hidden awk_output_wrapper_t;
address@hidden example
+
+I campi sono i seguenti:
+
address@hidden @code
address@hidden const char *name;
+Questo @`e il nome del processore di output.
+
address@hidden awk_bool_t (*can_take_file)(const awk_output_buf_t *outbuf);
+Questo @`e il puntatore a una funzione che esamina l'informazione contenuta
+nella struttura @code{awk_output_buf_t} puntata da @code{outbuf}.
+Dovrebbe restituire @dfn{true} se il processore di output vuole elaborare
+il file, e @dfn{false} in caso contrario.
+Nessuno stato (valori di variabili, etc.) dovrebbe essere modificato
+all'interno di @command{gawk}.
+
address@hidden awk_bool_t (*take_control_of)(awk_output_buf_t *outbuf);
+La funzione puntata da questo campo viene chiamata quando @command{gawk}
+decide di consentire al processore di output di prendere il controllo del file.
+Dovrebbe riempire in maniera appropriata dei campi nella struttura
address@hidden, come descritto sotto, e restituire @dfn{true} se
+ha successo, @dfn{false} in caso contrario.
+
address@hidden awk_const struct output_wrapper *awk_const next;
+Questa struttura @`e per uso di @command{gawk};
+per questo motivo @`e marcata @code{awk_const} in modo che l'estensione non
+possa modificarlo.
address@hidden table
+
+La struttura @code{awk_output_buf_t} @`e simile a questa:
+
address@hidden
+typedef struct awk_output_buf @{
+ const char *name; /* nome del file in output */
+ const char *mode; /* argomento @dfn{mode} per fopen */
+ FILE *fp; /* puntatore stdio file */
+ awk_bool_t redirected; /* @dfn{true} se un processore @`e attivo */
+ void *opaque; /* per uso del processore di output */
+ size_t (*gawk_fwrite)(const void *buf, size_t size, size_t count,
+ FILE *fp, void *opaque);
+ int (*gawk_fflush)(FILE *fp, void *opaque);
+ int (*gawk_ferror)(FILE *fp, void *opaque);
+ int (*gawk_fclose)(FILE *fp, void *opaque);
address@hidden awk_output_buf_t;
address@hidden example
+
+Anche qui, l'estensione address@hidden le funzioni @address@hidden()}
+e @address@hidden()} che esaminano e aggiornano
+campi dati in @code{awk_output_buf_t}.
+I campi dati sono i seguenti:
+
address@hidden @code
address@hidden const char *name;
+Il nome del file in output.
+
address@hidden const char *mode;
+La stringa @dfn{mode} (come sarebbe usata nel secondo argomento della
+chiamata di sistema @code{fopen()})
+con cui il file era stato aperto.
+
address@hidden FILE *fp;
+Il puntatore @code{FILE} da @code{<stdio.h>}. @command{gawk} apre il file
+prima di controllare se esiste un processore di output.
+
address@hidden awk_bool_t redirected;
+Questo campo dev'essere impostato a @dfn{true} dalla funzione
address@hidden@var{XXX}_take_control_of()}.
+
address@hidden void *opaque;
+Questo puntatore @`e opaco per @command{gawk}. L'estensione dovrebbe usarlo
+per contenere un puntatore a qualsiasi dato privato associato al file.
+
address@hidden size_t (*gawk_fwrite)(const void *buf, size_t size, size_t count,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ FILE *fp, void
*opaque);
address@hidden int (*gawk_fflush)(FILE *fp, void *opaque);
address@hidden int (*gawk_ferror)(FILE *fp, void *opaque);
address@hidden int (*gawk_fclose)(FILE *fp, void *opaque);
+Questi puntatori dovrebbero essere impostati per puntare a funzioni
+la cui azione sia equivalente a quella delle funzioni di @code{<stdio.h>},
+se questo @`e cio che si desidera.
address@hidden usa questi puntatori a funzione per @emph{tutti} gli output.
address@hidden inizializza i puntatori per puntare a funzioni interne
+``di passaggio'' che si limitano a chiamare le funzioni normali di
address@hidden<stdio.h>}, e quindi un'estensione deve ridefinire solo le
funzioni
+appropriate per fare il lavoro richiesto.
address@hidden table
+
+La funzione @address@hidden()} dovrebbe decidere in base ai
+campi @code{name} e @code{mode}, e a ogni altro ulteriore indicatore di stato
+(p.es., valori di variabili @command{awk}) adatto allo scopo.
+
+Quando @command{gawk} chiama @address@hidden()}, la funzione
+dovrebbe riempire i rimanenti campi
+in modo opportuno, tranne che per @code{fp}, che dovrebbe essere usato
+normalmente.
+
+Il processore di output va registrato usando la seguente funzione:
+
address@hidden @code
address@hidden void register_output_wrapper(awk_output_wrapper_t
*output_wrapper);
+Registra il processore di output puntato da @code{output_wrapper} con
address@hidden
address@hidden table
+
address@hidden Processori bidirezionali
address@hidden Registrare un processore bidirezionale
address@hidden personalizzato, processore bidirezionale
address@hidden processore bidirezionale personalizzato
address@hidden bidirezionale, processore personalizzato
+
+Un @dfn{processore bidirezionale} combina un analizzatore di input e
+un processore di output per un I/O
+bidirezionale usando l'operatore @samp{|&} (@pxref{Ridirezione}).
+Le strutture @code{awk_input_parser_t} e @code{awk_output_buf_t}
+sono usate nella maniera address@hidden descritta precedentemente.
+
+Un processore bidirezionale @`e rappresentato dalla struttura seguente:
+
address@hidden
+typedef struct awk_two_way_processor @{
+ const char *name; /* nome del processore bidirezionale */
+ awk_bool_t (*can_take_two_way)(const char *name);
+ awk_bool_t (*take_control_of)(const char *name,
+ awk_input_buf_t *inbuf,
+ awk_output_buf_t *outbuf);
+ awk_const struct awk_two_way_processor *awk_const next; /* per gawk */
address@hidden awk_two_way_processor_t;
address@hidden example
+
+I campi sono i seguenti:
+
address@hidden @code
address@hidden const char *name;
+Il nome del processore bidirezionale.
+
address@hidden awk_bool_t (*can_take_two_way)(const char *name);
+La funzione puntata da questo campo dovrebbe restituire @dfn{true} se
+vuole gestire l'I/O bidirezionale per questo @value{FN}.
+La funzione non dovrebbe modificare alcuno stato (valori di variabili, etc.)
+all'interno di @command{gawk}.
+
address@hidden awk_bool_t (*take_control_of)(const char *name,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_input_buf_t *inbuf,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_output_buf_t *outbuf);
+La funzione puntata da questo campo dovrebbe riempire le strutture
address@hidden e @code{awk_output_buf_t} puntate da @code{inbuf} e
address@hidden, rispettivamente. Queste strutture sono address@hidden state
descritte
+in precedenza.
+
address@hidden awk_const struct two_way_processor *awk_const next;
+Questa struttura @`e per uso di @command{gawk};
+per questo motivo @`e marcata @code{awk_const} in modo che l'estensione non
+possa modificarla.
address@hidden table
+
+Come per l'analizzatore di input e il processore di output, vanno fornite le
+funzione address@hidden@dotless{i}}, ci penso io'' e ``per questo, fai tu'',
address@hidden@var{XXX}_can_take_two_way()} e @address@hidden()}.
+
+Il processore bidirezionale va registrato usando la seguente funzione:
+
address@hidden @code
address@hidden void register_two_way_processor(awk_two_way_processor_t
*two_way_processor);
+Registra il processore bidirezionale puntato da @code{two_way_processor} con
address@hidden
address@hidden table
+
address@hidden Stampare messaggi
address@hidden Stampare messaggi dalle estensioni
address@hidden stampare messaggi dalle estensioni
address@hidden messaggi, stampare dalle estensioni
address@hidden estensioni, stampare messaggi dalle
+
address@hidden possibile stampare diversi tipi di messaggi di avvertimento da
+un'estensione, come qui spiegato. Si noti che, per queste funzioni,
+si deve fornire l'ID di estensione ricevuto da @command{gawk}
+al momento in cui l'estensione @`e stata caricata:@footnote{Poich@'e l'API usa
solo
address@hidden previste dal
+compilatore ISO C 90, non @`e possibile usare le macro di tipo variadico
+(che accettano un numero variabile di argomenti) disponibili nel compilatore
+ISO C 99, che nasconderebbero quel parametro. Un vero peccato!}
+
address@hidden @code
address@hidden void fatal(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio e poi @command{gawk} termina immediatamente l'esecuzione.
+
address@hidden void nonfatal(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio di errore non-fatale.
+
address@hidden void warning(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio di avvertimento.
+
address@hidden void lintwarn(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio di avvertimento ``lint''. Normalmente questo equivale a
+stampare un messaggio di avvertimento, ma se @command{gawk} era stato
+invocato specificando l'opzione @samp{--lint=fatal},
+gli avvertimenti di @dfn{lint} diventano messaggi di errore fatali.
address@hidden table
+
+Tutte queste funzioni sono per il resto simili alla famiglia di funzioni
address@hidden()} del linguaggio C, dove il parametro @code{format} @`e una
+stringa contenente dei caratteri normali e delle istruzioni di formattazione,
+mischiati tra loro.
+
address@hidden Aggiornare @code{ERRNO}
address@hidden Funzioni per aggiornare @code{ERRNO}
+
+Le seguenti funzioni consentono l'aggiornamento della variabile
address@hidden:
+
address@hidden @code
address@hidden void update_ERRNO_int(int errno_val);
+Imposta @code{ERRNO} alla stringa equivalente del codice di errore
+in @code{errno_val}. Il valore dovrebbe essere uno dei codici di errore
+definiti in @code{<errno.h>}, e @command{gawk} lo trasforma in una stringa
+(qualora possibile, tradotta) usando la funzione C @code{strerror()}.
+
address@hidden void update_ERRNO_string(const char *string);
+Imposta @code{ERRNO} direttamente usando il valore della stringa specificata.
address@hidden fa una copia del valore di @code{stringa}.
+
address@hidden void unset_ERRNO(void);
+Annulla il valore di @code{ERRNO}.
address@hidden table
+
address@hidden Richiedere valori
address@hidden Richiedere valori
+
+Tutte le funzioni che restituiscono valori da @command{gawk}
+funzionano allo stesso modo. Si fornisce un campo @code{awk_valtype_t}
+per indicare il tipo di valore che ci si aspetta. Se il valore disponibile
+corrisponde a quello richiesto, la funzione restituisce @dfn{true} e riempie
+il campo del risultato @code{awk_value_t}.
+Altrimenti, la funzione restituisce @dfn{false}, e il campo @code{val_type}
+indica il tipo di valore disponibile.
+A quel punto si address@hidden, a seconda di quel che richiede la situazione,
+stampare un messaggio di errore oppure ripetere la
+richiesta specificando il tipo di valore che risulta disponibile. Questo
+comportamento @`e riassunto nella
address@hidden
+
address@hidden Tabella,table-value-types-returned
address@hidden di valori restituiti dall'API}
address@hidden
+<informaltable>
+<tgroup cols="8">
+ <colspec colname="c1"/>
+ <colspec colname="c2"/>
+ <colspec colname="c3"/>
+ <colspec colname="c4"/>
+ <colspec colname="c5"/>
+ <colspec colname="c6"/>
+ <colspec colname="c7"/>
+ <colspec colname="c8"/>
+ <spanspec spanname="hspan" namest="c3" nameend="c8" align="center"/>
+ <thead>
+ <row><entry></entry><entry spanname="hspan"><para>Tipo di valore
reale</para></entry></row>
+ <row>
+ <entry></entry>
+ <entry></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Regexp</para></entry>
+ <entry><para>Vettore</para></entry>
+ <entry><para>Indefinito</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Stringa</emphasis></para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Strnum</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Numero</emphasis></para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry><para><emphasis role="bold">Tipo</emphasis></para></entry>
+ <entry><para><emphasis role="bold">Regexp</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>Regexp</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry><para><emphasis role="bold">Richiesto</emphasis></para></entry>
+ <entry><para><emphasis role="bold">Vettore</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>Vettore</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Scalare</emphasis></para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Indefinito</emphasis></para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Regexp</para></entry>
+ <entry><para>Vettore</para></entry>
+ <entry><para>Indefinito</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">@dfn{Value
cookie}</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ </tbody>
+</tgroup>
+</informaltable>
address@hidden docbook
+
address@hidden
address@hidden
address@hidden @columnfractions .50 .50
address@hidden @tab Tipo di valore reale
address@hidden multitable
address@hidden 10/2014: Thanks to Karl Berry for this bit to reduce the space:
address@hidden
+\vglue-1.1\baselineskip
address@hidden tex
address@hidden @multitable @columnfractions .166 .166 .198 .15 .15 .166
address@hidden SMALLPRINT
address@hidden {Richiesto} {Indefinito} {Numero} {Numero} {Scalar} {Regexp}
{Vettore} {Indefinito}
address@hidden @tab @tab Stringa @tab Strnum @tab Numero @tab Regexp @tab
Vettore @tab Indefinito
address@hidden @tab @b{Stringa} @tab Stringa @tab Stringa @tab Stringa @tab
Stringa @tab false @tab false
address@hidden @tab @b{Strnum} @tab false @tab Strnum @tab Strnum @tab false
@tab false @tab false
address@hidden @tab @b{Numero} @tab Numero @tab Numero @tab Numero @tab false
@tab false @tab false
address@hidden @b{Tipo} @tab @b{Regexp} @tab false @tab false @tab false @tab
Regexp @tab false @tab false
address@hidden @b{Richiesto} @tab @b{Vettore} @tab false @tab false @tab false
@tab false @tab Vettore @tab false
address@hidden @tab @b{Scalar} @tab Scalar @tab Scalar @tab Scalar @tab Scalar
@tab false @tab false
address@hidden @tab @b{Indefinito} @tab Stringa @tab Strnum @tab Numero @tab
Regexp @tab Vettore @tab Indefinito
address@hidden @tab @b{Value cookie} @tab false @tab false @tab false @tab
false @tab false @tab false
address@hidden multitable
address@hidden ifclear
+
address@hidden SMALLPRINT
address@hidden
address@hidden {Richiesto} {Value cookie} {Num.} {Num.} {Scal.} {Regexp}
{Vett.} {Indef.}
address@hidden @tab @tab String @tab Strn. @tab Num. @tab Regexp @tab Vett.
@tab Indef.
address@hidden @tab @b{Stringa} @tab String @tab String @tab String @tab String
@tab false @tab false
address@hidden @tab @b{Strnum} @tab false @tab Strn. @tab Strn. @tab false @tab
false @tab false
address@hidden @tab @b{Numero} @tab Num. @tab Num. @tab Num. @tab false @tab
false @tab false
address@hidden @b{Tipo} @tab @b{Regexp} @tab false @tab false @tab false @tab
Regexp @tab false @tab false
address@hidden @b{Richiesto} @tab @b{Vettore} @tab false @tab false @tab false
@tab false @tab Vett. @tab false
address@hidden @tab @b{Scalar} @tab Scal. @tab Scal. @tab Scal. @tab Scal. @tab
false @tab false
address@hidden @tab @b{Indefinito} @tab String @tab Strn. @tab Num. @tab Regexp
@tab Vett. @tab Indef.
address@hidden @tab @b{Value cookie} @tab false @tab false @tab false @tab
false @tab false @tab false
address@hidden multitable
address@hidden smallformat
address@hidden ifset
address@hidden ifnotdocbook
address@hidden ifnotplaintext
address@hidden
address@hidden
+
+-------------------------------------------------------+
+ | Tipo di valore reale:
|
+
+--------+--------+--------+--------+-------+-----------+
+ | Stringa| Strnum | Numero | Regexp |Vettore|
Indefinito|
++-----------+-----------+--------+--------+--------+--------+-------+-----------+
+| | Stringa | Stringa| Stringa| Stringa| Stringa| false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Strnum | false | Strnum | Strnum | false | false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Numero | Numero | Numero | Numero | false | false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Regexp | false | false | false | Regexp | false | false
|
+| Tipo
+-----------+--------+--------+--------+--------+-------+-----------+
+|Richiesto: | Vettore | false | false | false | false |Vettore| false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Scalare | Scalare| Scalare| Scalare| Scalare| false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Indefinito| Stringa| Strnum | Numero | Regexp |Vettore|
Indefinito|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Value- | false | false | false | false | false | false
|
+| | Cookie | | | | | |
|
++-----------+-----------+--------+--------+--------+--------+-------+-----------+
address@hidden verbatim
address@hidden ifplaintext
address@hidden float
+
address@hidden Accedere ai parametri
address@hidden Accedere ai parametri e aggiornarli
+
+Due funzioni consentono di accedere agli argomenti (parametri)
+passati all'estensione. Esse sono:
+
address@hidden @code
address@hidden awk_bool_t get_argument(size_t count,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_valtype_t
wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_value_t
*risultato);
+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.
+In quest'ultimo caso,
address@hidden@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
address@hidden@dotless{i}} via.
address@hidden indica il tipo di valore atteso.
+
address@hidden awk_bool_t set_argument(size_t count, awk_array_t array);
+Converte un parametro di tipo indefinito in un vettore; address@hidden
permette la
+chiamata per riferimento per i vettori. Restituisce @dfn{false} se
@code{count} @`e troppo elevato,
+o se il tipo di argomento @`e diverso da @dfn{undefined}.
address@hidden di vettori}
+per ulteriori informazioni riguardo alla creazione di vettori.
address@hidden table
+
address@hidden Accedere alla tabella simboli
address@hidden Accedere alla Tabella dei simboli
address@hidden accedere alle variabili globali dalle estensioni
address@hidden variabili globali, accesso dalle estensioni
address@hidden estensioni, accesso alle variabili globali
+
+Due insiemi di routine permettono di accedere alle variabili globali,
+e un insieme consente di creare e rilasciare dei valori nascosti.
+
address@hidden
+* Tabella simboli per nome:: Accedere alle variabili per nome.
+* Tabella simboli tramite cookie:: Accedere alle variabili per ``cookie''.
+* Valori nascosti:: Creare e usare valori nascosti.
address@hidden menu
+
address@hidden Tabella simboli per nome
address@hidden Accedere alle variabili per nome e aggiornarle
+
+Le routine che seguono permettono di raggiungere e aggiornare
+le variabili globali a livello di @command{awk} per nome. Nel gergo dei
+compilatori, gli identificativi di vario tipo sono noti come @dfn{simboli},
+da cui il prefisso ``sym'' nei nomi delle routine. La struttura di dati che
+contiene informazioni sui simboli @`e chiamata @dfn{Tabella dei simboli}
+(@dfn{Symbol table}).
+Le funzioni sono le seguenti:
+
address@hidden @code
address@hidden awk_bool_t sym_lookup(const char *name,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_valtype_t wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_value_t
*risultato);
+Riempie la struttura @code{awk_value_t} puntata da @code{risultato}
+con il valore della variabile il cui nome @`e nella stringa @code{name},
+che @`e una normale stringa di caratteri C.
address@hidden 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.
+In quest'ultimo caso, @code{risultato>val_type} indica il tipo effettivo
+della variabile
+(@pxref{table-value-types-returned}).
+
address@hidden awk_bool_t sym_update(const char *name, awk_value_t *valore);
+Aggiorna la variabile il cui nome @`e contenuto nella stringa @code{name},
+che @`e una normale stringa di caratteri C.
+La variabile @`e aggiunta alla Tabella dei simboli di @command{gawk},
+se non @`e address@hidden presente. Restituisce @dfn{true} se tutto @`e
andato bene, e
address@hidden in caso contrario.
+
+La modifica del tipo (da scalare a vettoriale o viceversa) di una variabile
address@hidden esistente @emph{non} @`e consentito, e questa routine non
address@hidden neppure
+essere usata per aggiornare un vettore.
+Questa routine non address@hidden essere usata per modificare nessuna delle
variabili
+predefinite (come @code{ARGC} o @code{NF}).
address@hidden table
+
+Un'estensione address@hidden andare a cercare il valore delle variabili
speciali di
address@hidden
+Tuttavia, con l'eccezione del vettore @code{PROCINFO}, un'estensione
+non address@hidden cambiare alcuna di queste variabili.
+
address@hidden Tabella simboli tramite cookie
address@hidden Accedere alle variabili per ``cookie'' e aggiornarle
+
+Uno @dfn{scalar cookie} @`e un puntatore nascosto (@dfn{opaque handle}) che
+fornisce accesso a una
+variabile globale o a un vettore. Si tratta di un'ottimizzazione, per evitare
+di ricercare variabili nella Tabella dei simboli di @command{gawk} ogni volta
+che un accesso @`e necessario. Questo
+argomento @`e address@hidden stato trattato in precedenza, nella
address@hidden di dati generali}.
+
+Le funzioni seguenti servono per gestire gli @dfn{scalar cookie}:
+
address@hidden @code
address@hidden awk_bool_t sym_lookup_scalar(awk_scalar_t cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_valtype_t wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_value_t *risultato);
+Ottiene il valore corrente di uno @dfn{scalar cookie}.
+Una volta ottenuto lo @dfn{scalar cookie} usando @code{sym_lookup()}, si
address@hidden usare questa funzione per accedere al valore della variabile in
modo
address@hidden efficiente.
+Restituisce @dfn{false} se il valore non @`e disponibile.
+
address@hidden awk_bool_t sym_update_scalar(awk_scalar_t cookie, awk_value_t
*valore);
+Aggiorna il valore associato con uno @dfn{scalar cookie}.
+Restituisce @dfn{false} se il nuovo valore non @`e del tipo
address@hidden, @code{AWK_STRNUM}, @code{AWK_REGEX} o @code{AWK_NUMBER}.
+Anche in questo caso, le variabili predefinite non possono essere aggiornate.
address@hidden table
+
+Non @`e immediatamente evidente come si lavora con gli @dfn{scalar cookie} o
+quale sia la loro vera @i{ragion d'essere}. In teoria, le routine
address@hidden()} e @code{sym_update()} sono tutto address@hidden che occorre
per
+lavorare con le variabili. Per esempio, ci potrebbe essere un codice che
+ricerca il valore di una variabile, valuta una condizione, e potrebbe
+poi cambiare il valore della variabile a seconda dei risultati della
+valutazione in modo simile a questo:
+
address@hidden
+/* do_magic --- fai qualcosa di veramente grande */
+
+static awk_value_t *
+do_magic(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t valore;
+
+ if ( sym_lookup("MAGIC_VAR", AWK_NUMBER, & valore)
+ && qualche_condizione(valore.num_valore)) @{
+ valore.num_valore += 42;
+ sym_update("MAGIC_VAR", & valore);
+ @}
+
+ return make_number(0.0, risultato);
address@hidden
address@hidden example
+
address@hidden
+Questo codice sembra (ed @`e) semplice e immediato. Qual @`e il problema?
+
+Beh, si consideri cosa succede se un qualche codice a livello di @command{awk}
+associato con l'estensione richiama la funzione @code{magic()}
+(implementata in linguaggio C da @code{do_magic()}), una volta per ogni
+record, mentre si stanno elaborando
+file contenenti migliaia o milioni di record.
+La variabile @code{MAGIC_VAR} viene ricercata nella Tabella dei simboli una o
due
+volte per ogni richiamo della funzione!
+
+La ricerca all'interno della Tabella dei simboli @`e in address@hidden una
pura perdita
+di tempo; @`e molto address@hidden efficiente
+ottenere un @dfn{value cookie} che rappresenta la variabile, e usarlo per
+ottenere il valore della variabile e aggiornarlo a seconda della
address@hidden@footnote{La differenza @`e misurabile e indubbiamente reale.
+Fidatevi.}
+
+Quindi, la maniera per usare i valori-cookie @`e la seguente. Per prima
+cosa, la variabile di estensione va messa nella Tabella dei simboli di
address@hidden usando @code{sym_update()}, come al solito. Poi si deve ottenere
+uno @dfn{scalar cookie} per la
+variabile usando @code{sym_lookup()}:
+
address@hidden
+static awk_scalar_t magic_var_cookie; /* cookie per MAGIC_VAR */
+
+static void
+inizializza_estensione()
address@hidden
+ awk_value_t valore;
+
+ /* immettere il valore iniziale */
+ sym_update("MAGIC_VAR", make_number(42.0, & valore));
+
+ /* ottenere il @dfn{value cookie} */
+ sym_lookup("MAGIC_VAR", AWK_SCALAR, & valore);
+
+ /* salvarlo per dopo */
+ magic_var_cookie = valore.scalar_cookie;
+ @dots{}
address@hidden
address@hidden example
+
+Dopo aver fatto questo, si usino le routine descritte in questa @value{SECTION}
+per ottenere e modificare
+il valore usando il @dfn{value cookie}. Quindi, @code{do_magic()} diviene ora
+qualcosa del tipo:
+
address@hidden
+/* do_magic --- fai qualcosa di veramente grande */
+
+static awk_value_t *
+do_magic(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t valore;
+
+ if ( sym_lookup_scalar(magic_var_cookie, AWK_NUMBER, & valore)
+ && qualche_condizione(valore.num_valore)) @{
+ valore.num_valore += 42;
+ sym_update_scalar(magic_var_cookie, & valore);
+ @}
+ @dots{}
+
+ return make_number(0.0, risultato);
address@hidden
address@hidden example
+
address@hidden NOTA
+Il codice appena visto omette il controllo di eventuali errori, per
+amor di address@hidden Il codice dell'estensione dovrebbe essere
address@hidden complesso
+e controllare attentamente i valori
+restituiti dalle funzioni dell'API.
address@hidden quotation
+
address@hidden Valori nascosti
address@hidden Creare e usare valori nascosti
+
+Le routine in questa @value{SECTION} permettono di creare e rilasciare
+valori nascosti. Come gli @dfn{scalar cookie}, in teoria i valori nascosti
+non sono necessari. Si possono creare numeri e stringhe usando
+le funzioni descritte
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di costruzione}. Si possono poi assegnare
+quei valori a delle variabili usando @code{sym_update()}
+o @code{sym_update_scalar()}, come si preferisce.
+
+Tuttavia, si address@hidden comprendere l'address@hidden di avere dei valori
nascosti
+se si pone mente al fatto che la memoria di @emph{ogni} valore di stringa
address@hidden essere ottenuta tramite @code{gawk_malloc()},
address@hidden()} o @code{gawk_realloc()}.
+Se ci sono 20 variabili, e tutte hanno per valore la stessa stringa,
+si devono creare 20 copie identiche della address@hidden valori
+numerici creano molti meno problemi, in quanto richiedono solo una variabile
+C @code{double} (8 byte) per contenerli.}
+
+Chiaramente @`e address@hidden efficiente, se possibile, creare il valore una
sola volta,
+e fare in modo che @command{gawk} utilizzi quell'unico valore per molte
+variabili. Questo @`e address@hidden che la routine in
address@hidden
+questa
address@hidden ifnotinfo
address@hidden
+questo
address@hidden ifinfo
address@hidden permette
+di fare. Le funzioni sono le seguenti:
+
address@hidden @code
address@hidden awk_bool_t create_value(awk_value_t *valore, awk_value_cookie_t
*risultato);
+Crea una stringa o un valore numerico nascosti, da @code{valore}, in
+vista di un successivo assegnamento di valore. Sono consentiti solo valori di
+tipo @code{AWK_NUMBER}, @code{AWK_REGEX} ed @code{AWK_STRING}.
+Ogni altro tipo @`e rifiutato.
+Il tipo @code{AWK_UNDEFINED} potrebbe essere consentito, ma in questo caso
+l'efficienza del programma ne soffrirebbe.
+
address@hidden awk_bool_t release_value(awk_value_cookie_t vc);
+Libera la memoria associata con un @dfn{value cookie} ottenuto mediante
address@hidden()}.
address@hidden table
+
+Si usano i @dfn{value cookie} in modo dimile a quello con cui si usano gli
address@hidden cookie}.
+Nella routine di inizializzazione dell'estensione, si crea il
address@hidden cookie}:
+
address@hidden
+static awk_value_cookie_t answer_cookie; /* static @dfn{value cookie} */
+
+static void
+inizializza_estensione()
address@hidden
+ awk_value_t value;
+ char *long_string;
+ size_t long_string_len;
+
+ /* codice precedente */
+ @dots{}
+ /* @dots{} riempire long_string e long_string_len @dots{} */
+ make_malloced_string(long_string, long_string_len, & value);
+ create_value(& value, & answer_cookie); /* creare cookie */
+ @dots{}
address@hidden
address@hidden example
+
+Una volta che il valore @`e creato, si address@hidden usare come valore per un
numero
+qualsiasi di variabili:
+
address@hidden
+static awk_value_t *
+do_magic(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t new_value;
+
+ @dots{} /* come in precedenza */
+
+ value.val_type = AWK_VALUE_COOKIE;
+ value.value_cookie = answer_cookie;
+ sym_update("VAR1", & value);
+ sym_update("VAR2", & value);
+ @dots{}
+ sym_update("VAR100", & value);
+ @dots{}
address@hidden
address@hidden example
+
address@hidden
+Usare @dfn{value cookie} in questo modo permette di risparmiare parecchia
+memoria, poich@'e tutte le variabili da @code{VAR1} a @code{VAR100} condividono
+lo stesso valore.
+
+Ci si potrebbe chiedere, ``Questa condivisione crea problemi?
+Cosa succede se il codice @command{awk} assegna un nuovo valore a @code{VAR1};
+sono modificate anche tutte le altre variabili?''
+
+Buona domanda! La risposta @`e che no, non @`e un problema.
+Internamente, @command{gawk} usa
address@hidden contatore dei riferimenti alle stringhe}. Questo significa
+che molte variabili possono condividere lo stesso valore di tipo stringa,
+e @command{gawk} mantiene traccia del loro uso. Quando il valore di
+una variabile viene modificato, @command{gawk} semplicemente diminuisce di
+uno il contatore dei riferimenti del vecchio valore, e aggiorna la variabile
+perch@'e usi il nuovo valore.
+
+Infine, come parte della pulizia al termine del programma
+(@pxref{Funzioni di exit callback})
+si deve liberare ogni valore nascosto che era stato creato, usando
+la funzione @code{release_value()}.
+
address@hidden Manipolazione di vettori
address@hidden Manipolazione di vettori
address@hidden vettori, manipolazione nelle estensioni
address@hidden estensioni, manipolazione di vettori
+
+La struttura di dati address@hidden'accordo, l'unica struttura di dati.}
+in @command{awk} @`e il vettore associativo
address@hidden
+(@pxrefil{Vettori}).
address@hidden iftex
address@hidden
+(@pxref{Vettori}).
address@hidden ifnottex
+Le estensioni devono essere in grado di manipolare vettori @command{awk}.
+L'API fornisce varie strutture di dati per lavorare con vettori,
+funzioni per lavorare con singoli elementi di un vettore, e funzioni per
+lavorare con interi vettori. @`E prevista anche la address@hidden di
+``appiattire'' un vettore in modo da rendere facile a un programma scritto in
+C la ``visita'' di tutti gli elementi del vettore.
+Le strutture dati per i vettori sono facilmente integrabili con le
+strutture dati per variabili scalari, per facilitare sia l'elaborazione, sia
+la creazione di @dfn{veri} vettori di vettori (@pxref{Tipi di dati generali}).
+
address@hidden
+* Tipi di dati per i vettori:: Tipi dati per lavorare coi vettori.
+* Funzioni per i vettori:: Funzioni per lavorare coi vettori.
+* Appiattimento di vettori:: Come appiattire i vettori.
+* Creazione di vettori:: Come creare e popolare vettori.
address@hidden menu
+
address@hidden Tipi di dati per i vettori
address@hidden Tipi di dati per i vettori
+
+I tipi di dato associati con i vettori sono i seguenti:
+
address@hidden @code
address@hidden typedef void *awk_array_t;
+Se si richiede il valore di una variabile contenuta in un vettore, si ottiene
+un valore del tipo @code{awk_array_t}. Questo valore @`e
address@hidden@address@hidden anche un
+``cookie,'' ma gli sviluppatori di @command{gawk} hanno preferito non abusare
+di questo termine.} per l'estensione; identifica in maniera univoca il
+vettore ma address@hidden solo essere usato come parametro di una funzione
dell'API,
+o essere ricevuto da una funzione dell'API. Questo @`e molto simile al modo
+in cui i valori @samp{FILE *} sono usati con le routine di libreria di
address@hidden<stdio.h>}.
+
address@hidden typedef struct awk_element @{
address@hidden @ @ @ @ /* puntatore di servizio
address@hidden @ @ @ @ a lista collegata, non usato da gawk */
address@hidden @ @ @ @ struct awk_element *next;
address@hidden @ @ @ @ enum @{
address@hidden @ @ @ @ @ @ @ @ AWK_ELEMENT_DEFAULT = 0,@ @ /* impostato da gawk
*/
address@hidden @ @ @ @ @ @ @ @ AWK_ELEMENT_DELETE = 1@ @ @ @ /* impostato
dall'estensione */
address@hidden @ @ @ @ @} flags;
address@hidden @ @ @ @ awk_value_t index;
address@hidden @ @ @ @ awk_value_t value;
address@hidden @} awk_element_t;
address@hidden @`e un elemento di vettore ``appiattito''.
address@hidden produce un vettore di questo tipo all'interno della struttura
address@hidden (si veda poco address@hidden avanti).
+Singoli elementi di vettore possono essere marcati per essere cancellati.
+Nuovi elementi del vettore devono essere aggiunti individualmente, uno per
+volta, usando una funzione API apposita. I campi sono i seguenti:
+
address@hidden nested table
address@hidden @code
address@hidden struct awk_element *next;
+Questo puntatore @`e presente come ausilio a chi scrive un'estensione.
+Permette a un'estensione di creare una lista collegata (@dfn{linked list}) di
+nuovi elementi che possono essere aggiunti a un vettore con un
+singolo ciclo che percorre tutta la lista.
+
address@hidden enum @{ @dots{} @} flags;
+Un insieme di valori di flag che passano informazione tra l'estensione
+e @command{gawk}. Per ora c'@`e solo un flag disponibile:
address@hidden
+Se lo si imposta, @command{gawk} elimina l'elemento in questione dal vettore
+originale, dopo che il vettore ``appiattito'' @`e stato rilasciato.
+
address@hidden index
address@hidden value
+L'indice e il valore di un elemento, rispettivamente.
address@hidden la memoria puntata da @code{index} e @code{valore} appartiene
+a @command{gawk}.
address@hidden table
+
address@hidden typedef struct awk_flat_array @{
address@hidden @ @ @ @ awk_const void *awk_const opaque1;@ @ @ @ /* per uso di
gawk */
address@hidden @ @ @ @ awk_const void *awk_const opaque2;@ @ @ @ /* per uso di
gawk */
address@hidden @ @ @ @ awk_const size_t count;@ @ @ @ @ /* quanti elementi nel
vettore */
address@hidden @ @ @ @ awk_element_t elements[1];@ @ /* saranno ``appiattiti''
*/
address@hidden @} awk_flat_array_t;
+Questo @`e un vettore appiattito. Quando un'estensione ottiene da
address@hidden questa struttura, il vettore @code{elements} ha una dimensione
+reale di @code{count} elementi.
+I puntatori @code{opaque1} e @code{opaque2} sono per uso di @command{gawk};
+come tali, sono marcati come @code{awk_const} in modo che l'estensione non
+possa modificarli.
address@hidden table
+
address@hidden Funzioni per i vettori
address@hidden Funzioni per lavorare coi vettori
+
+Le funzioni seguenti permettono di gestire singoli elementi di un vettore:
+
address@hidden @code
address@hidden awk_bool_t get_element_count(awk_array_t a_cookie, size_t
*count);
+Per il vettore rappresentato da @code{a_cookie}, restituisce in @code{*count}
+il numero di elementi in esso contenuti. Ogni sottovettore @`e conteggiato
come
+se fosse un solo elemento.
+Restituisce @dfn{false} se si verifica un errore.
+
address@hidden awk_bool_t get_array_element(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const
awk_value_t *const index,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_valtype_t wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
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}.
address@hidden specifica il tipo di valore che si vuole ritrovare.
+Restituisce @dfn{false} se @code{wanted} 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} address@hidden essere numerico, nel qual caso
@command{gawk}
+lo converte in una stringa. Usare valori non interi @`e possibile, ma
+richiede di comprendere il modo con cui tali valori sono convertiti in stringhe
+(@pxref{Conversione}); per questo motivo, @`e meglio usare numeri interi.
+
+Come per @emph{tutte} le stringhe passate a @command{gawk} da
+un'estensione, la memoria che contiene il valore della stringa con chiave
address@hidden deve essere stata acquisita utilizzando le funzioni
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}, e
address@hidden address@hidden (al momento opportuno) la relativa memoria.
+
address@hidden awk_bool_t set_array_element(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const@
awk_value_t *const index,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const@
awk_value_t *const value);
+Nel vettore rappresentato da @code{a_cookie}, crea o modifica
+l'elemento il cui indice @`e contenuto in @code{index}.
+I vettori @code{ARGV} ed @code{ENVIRON} non possono essere modificati,
+mentre il vettore @code{PROCINFO} @`e modificabile.
+
address@hidden awk_bool_t set_array_element_by_elem(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
@ @ @ @ @ awk_element_t element);
+Come @code{set_array_element()}, ma prende l'indice @code{index} e
+il valore @code{value} da @code{element}. Questa @`e una macro di
address@hidden
+
address@hidden awk_bool_t del_array_element(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const
awk_value_t* const index);
+Elimina dal vettore, rappresentato da @code{a_cookie}, l'elemento con
+l'indice specificato.
+Restituisce @dfn{true} se l'elemento @`e stato rimosso o @dfn{false} se
+l'elemento non era presente nel vettore.
address@hidden table
+
+Le seguenti funzioni operano sull'intero vettore:
+
address@hidden @code
address@hidden awk_array_t create_array(void);
+Crea un nuovo vettore a cui si possono aggiungere elementi.
address@hidden di vettori} per una trattazione su come
+creare un nuovo vettore e aggiungervi elementi.
+
address@hidden awk_bool_t clear_array(awk_array_t a_cookie);
+Svuota il vettore rappresentato da @code{a_cookie}.
+Restituisce @dfn{false} in presenza di qualche tipo di problema, @dfn{true}
+in caso contrario. Il vettore non viene eliminato ma, dopo aver chiamato
+questa funzione, resta privo di elementi. Questo @`e equivalente a usare
+l'istruzione @code{delete} (@pxref{Cancellazione}).
+
address@hidden awk_bool_t flatten_array_typed(awk_array_t a_cookie,
awk_flat_array_t **data, awk_valtype_t index_type, awk_valtype_t value_type);
+Per il vettore rappresentato da @code{a_cookie}, crea una struttura
address@hidden e la riempie con indici e valori del tipo richiesto.
+Imposta il puntatore il cui indirizzo @`e passato in @code{data} per puntare a
+questa struttura.
+Restituisce @dfn{true} se tutto va bene o @dfn{false} in caso contrario.
address@hidden FOR_PRINT
+Si veda la prossima @value{SECTION}
address@hidden ifset
address@hidden FOR_PRINT
address@hidden di vettori},
address@hidden ifclear
+per una trattazione su come appiattire un vettore per poterci lavorare.
+
address@hidden awk_bool_t flatten_array(awk_array_t a_cookie, awk_flat_array_t
**data);
+Per il vettore rappresentato da @code{a_cookie}, crea una struttura
address@hidden e la riempie con indici di tipo @code{AWK_STRING} e
+valori @code{AWK_UNDEFINED}.
+Questa funzione @`e resa obsoleta da @code{flatten_array_typed()}.
address@hidden fornita come macro, e mantenuta per convenienza e per
address@hidden a
+livello di codice sorgente con la precedente versione dell'API.
+
address@hidden awk_bool_t release_flattened_array(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
@ @ @ awk_flat_array_t *data);
+Quando si @`e finito di lavorare con un vettore appiattito, si liberi la
+memoria usando questa funzione. Occorre fornire sia il cookie del vettore
+originale, sia l'indirizzo della struttura da liberare,
address@hidden
+La funzione restituisce @dfn{true} se tutto va bene, @dfn{false} in caso
contrario.
address@hidden table
+
address@hidden Appiattimento di vettori
address@hidden Lavorare con tutti gli elementi di un vettore
+
address@hidden un vettore vuol dire creare una struttura che
+rappresenta l'intero vettore in modo da facilitare la visita
+dell'intero vettore da parte del codice in C . Parte del codice in
address@hidden/testext.c} fa questo, ed @`e anche un bell'esempio
+di come utilizzare l'API.
+
+Questa parte del codice sorgente address@hidden descritta un po' per volta.
+Ecco, per iniziare, lo script @command{gawk} che richiama l'estensione di test:
+
address@hidden
+@@load "testext"
+BEGIN @{
+ n = split("blacky rusty sophie raincloud lucky", pets)
+ printf("pets ha %d elementi\n", length(pets))
+ ret = dump_array_and_delete("pets", "3")
+ printf("dump_array_and_delete(pets) ha restituito %d\n", ret)
+ if ("3" in pets)
+ printf("dump_array_and_delete() NON ha rimosso l'indice \"3\"!\n")
+ else
+ printf("dump_array_and_delete() ha rimosso l'indice \"3\"!\n")
+ print ""
address@hidden
address@hidden example
+
address@hidden
+Questo codice crea un vettore usando la funzione @code{split()}
+(@pxref{Funzioni per stringhe})
+e poi chiama @code{dump_array_and_delete()}. Questa funzione ricerca
+il vettore il cui nome @`e passato come primo argomento, ed
+elimina l'elemento il cui indice @`e passato come secondo argomento.
+Il codice @command{awk} stampa poi il valore restituito e controlla che
+l'elemento sia stato effettivamente cancellato. Ecco il codice C che
+costituisce la funzione
address@hidden()}. @`E stato leggermente modificato per facilitare
+l'esposizione.
+
+La prima parte dichiara variabili, imposta il valore di ritorno di default
+in @code{risultato}, e controlla che la funzione
+sia stata chiamata con il numero corretto di argomenti:
+
address@hidden
+static awk_value_t *
+dump_array_and_delete(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t valore, valore2, valore3;
+ awk_flat_array_t *flat_array;
+ size_t count;
+ char *name;
+ int i;
+
+ assert(risultato != NULL);
+ make_number(0.0, risultato);
+
+ if (nargs != 2) @{
+ printf("dump_array_and_delete: nargs errato "
+ "(%d dovrebbe essere 2)\n", nargs);
+ goto out;
+ @}
address@hidden example
+
+La funzione poi prosegue un passo per volta, come segue. Il primo passo @`e
+ricuperare il nome del vettore, passato come primo argomento, seguito dal
+vettore stesso. Se una di queste operazioni non riesce, viene stampato un
+messaggio di errore e si ritorna al chiamante:
+
address@hidden
+ /* trasforma in un vettore piatto il vettore
+ passato come argomento e lo stampa */
+ if (get_argument(0, AWK_STRING, & value)) @{
+ name = valore.str_value.str;
+ if (sym_lookup(name, AWK_array, & value2))
+ printf("dump_array_and_delete: sym_lookup di %s effettuato\n",
+ name);
+ else @{
+ printf("dump_array_and_delete: sym_lookup di %s non riuscito\n",
+ name);
+ goto out;
+ @}
+ @} else @{
+ printf("dump_array_and_delete: get_argument(0) non riuscito\n");
+ goto out;
+ @}
address@hidden example
+
+Per controllo, e per assicurarsi che il codice C veda
+lo stesso numero di elementi del codice @command{awk},
+il secondo passo @`e quello di ottenere il numero di elementi nel vettore
+e stamparlo:
+
address@hidden
+ if (! get_element_count(valore2.array_cookie, & count)) @{
+ printf("dump_array_and_delete: get_element_count non riuscito\n");
+ goto out;
+ @}
+
+ printf("dump_array_and_delete: il vettore in input ha %lu elementi\n",
+ (unsigned long) count);
address@hidden example
+
+Il terzo passo @`e quello di appiattire il vettore, e quindi
+controllare che il numero di elementi nella struttura @code{awk_flat_array_t}
+sia uguale a quello appena trovato:
+
address@hidden
+ if (! flatten_array_typed(valore2.array_cookie, & flat_array,
+ AWK_STRING, AWK_UNDEFINED)) @{
+ printf("dump_array_and_delete: non sono riuscito ad appiattire \
+il vettore\n");
+ goto out;
+ @}
+
+ if (flat_array->count != count) @{
+ printf("dump_array_and_delete: flat_array->count (%lu)"
+ " != count (%lu)\n",
+ (unsigned long) flat_array->count,
+ (unsigned long) count);
+ goto out;
+ @}
address@hidden example
+
+Il quarto passo @`e ritrovare l'indice dell'elemento
+da eliminare, che era stato passato come secondo argomento.
+Va tenuto presente che i contatori di argomenti passati a @code{get_argument()}
+partono da zero, e che quindi il secondo argomento @`e quello numero uno:
+
address@hidden
+ if (! get_argument(1, AWK_STRING, & value3)) @{
+ printf("dump_array_and_delete: get_argument(1) non riuscito\n");
+ goto out;
+ @}
address@hidden example
+
+Il quinto passo @`e quello in cui si fa il ``vero lavoro''. La funzione esegue
+un ciclo su ogni elemento nel vettore, stampando i valori degli indici e
+degli elementi. Inoltre, dopo aver trovato, tramite l'indice, l'elemento
+che si vorrebbe eliminare, la funzione imposta il @dfn{bit}
address@hidden nel campo @code{flags}
+dell'elemento. Quando il vettore @`e stato interamente percorso,
@command{gawk}
+visita il vettore appiattito, ed elimina ogni elemento in cui il relativo
address@hidden della flag sia impostato:
+
address@hidden
+ for (i = 0; i < flat_array->count; i++) @{
+ printf("\t%s[\"%.*s\"] = %s\n",
+ name,
+ (int) flat_array->elements[i].index.str_value.len,
+ flat_array->elements[i].index.str_value.str,
+ valrep2str(& flat_array->elements[i].valore));
+
+ if (strcmp(valore3.str_value.str,
+ flat_array->elements[i].index.str_value.str) == 0) @{
+ flat_array->elements[i].flags |= AWK_ELEMENT_DELETE;
+ printf("dump_array_and_delete: ho marcato l'elemento \"%s\" "
+ "per eliminazione\n",
+ flat_array->elements[i].index.str_value.str);
+ @}
+ @}
address@hidden example
+
+Il sesto passo @`e liberare il vettore appiattito. Questo segnala a
address@hidden che l'estensione non sta address@hidden usando il vettore,
+e che dovrebbe eliminare gli elementi marcati per l'eliminazione.
address@hidden libera anche ogni area di memoria che era stata allocata,
+e quindi non si dovrebbe address@hidden usare il puntatore (@code{flat_array}
in
+questo codice) dopo aver chiamato @code{release_flattened_array()}:
+
address@hidden
+ if (! release_flattened_array(valore2.array_cookie, flat_array)) @{
+ printf("dump_array_and_delete: non riesco a liberare \
+il vettore appiattito\n");
+ goto out;
+ @}
address@hidden example
+
+Infine, poich@'e tutto @`e andato bene, la funzione imposta il codice di
ritorno
+a "successo", e lo restituisce quando esce:
+
address@hidden
+ make_number(1.0, risultato);
+out:
+ return risultato;
address@hidden
address@hidden example
+
+Ecco l'output ottenuto eseguendo questa parte del test:
+
address@hidden
+pets ha 5 elementi
+dump_array_and_delete: sym_lookup di pets effettuato
+dump_array_and_delete: il vettore in input ha 5 elementi
+ pets["1"] = "blacky"
+ pets["2"] = "rusty"
+ pets["3"] = "sophie"
+dump_array_and_delete: ho marcato l'elemento "3" per eliminazione
+ pets["4"] = "raincloud"
+ pets["5"] = "lucky"
+dump_array_and_delete(pets) ha restituito 1
+dump_array_and_delete() ha rimosso l'indice "3"!
address@hidden example
+
address@hidden Creazione di vettori
address@hidden Come creare e popolare vettori
+
+Oltre a lavorare con vettori creati da codice @command{awk}, si possono
+creare vettori a cui aggiungere elementi secondo le esigenze, che poi
+il codice @command{awk} address@hidden utilizzare e manipolare.
+
+Ci sono due punti importanti da tener presente quando di creano vettori dal
+codice di un'estensione:
+
address@hidden @value{BULLET}
address@hidden
+Il vettore appena creato deve essere subito messo nella Tabella dei simboli di
address@hidden Solo dopo aver fatto questo @`e possibile aggiungere elementi
+al vettore.
+
address@hidden
+Strictly speaking, this is required only
+for arrays that will have subarrays as elements; however it is
+a good idea to always do this. This restriction may be relaxed
+in a subsequent revision of the API.
address@hidden ignore
+
+Analogamente, se si installa un nuovo vettore come sottovettore di
+un vettore address@hidden esistente,
+occorre prima aggiungere il nuovo vettore al suo "genitore" per poter poi
+aggiungere degli elementi allo stesso.
+
+Quindi, il modo giusto per costruire un vettore @`e di lavorare ``dall'alto
+verso il basso''. Creare il vettore, e subito aggiungerlo alla Tabella dei
+simboli di @command{gawk} usando @code{sym_update()}, o installarlo come
+elemento in un vettore address@hidden esistente usando
@code{set_array_element()}.
+Un esempio di codice @`e fornito address@hidden sotto.
+
address@hidden
+Per come funziona internamente @command{gawk}, dopo aver usato
address@hidden()} per definire un vettore
+in @command{gawk}, si deve innanzitutto ricuperare il @dfn{cookie}
+del vettore dal valore passato a @command{sym_update()}, in questo modo:
+
address@hidden
+awk_value_t val;
+awk_array_t new_array;
+
+new_array = create_array();
+val.val_type = AWK_ARRAY;
+val.array_cookie = new_array;
+
+/* aggiunge il vettore alla Tabella dei simboli */
+sym_update("array", & val);
+
+new_array = val.array_cookie; /* QUESTO @`E OBBLIGATORIO */
address@hidden example
+
+Se si sta installando un vettore come sottovettore, occorre anche
+ricuperare il @dfn{cookie} del vettore dopo aver chiamato @code{set_element()}.
address@hidden itemize
+
+Il seguente codice C @`e una semplice estensione di test per creare un vettore
+con due elementi normali e con un sottovettore. Le direttive iniziali
address@hidden e le solite dichiarazione di variabili sono state omesse per
+amor di address@hidden
+(@pxref{Codice predefinito di un'estensione API}).
+Il primo passo @`e creare un nuovo vettore e poi aggiungerlo alla
+Tabella dei simboli:
+
address@hidden
address@hidden
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <stdio.h>
+#include <assert.h>
+#include <errno.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+
+#include <sys/types.h>
+#include <sys/stat.h>
+
+#include "gawkapi.h"
+
+static const gawk_api_t *api; /* per far funzionare le macro di
address@hidden */
+static awk_ext_id_t *ext_id;
+static const char *ext_version = "testarray extension: version 1.0";
+
+int plugin_is_GPL_compatible;
+
address@hidden ignore
+/* create_new_array --- creare un vettore denominato */
+
+static void
+create_new_array()
address@hidden
+ awk_array_t a_cookie;
+ awk_array_t sottovettore;
+ awk_value_t index, valore;
+
+ a_cookie = create_array();
+ valore.val_type = AWK_array;
+ valore.array_cookie = a_cookie;
+
+ if (! sym_update("new_array", & value))
+ printf("create_new_array: sym_update(\"nuovo_vettore\") \
+non riuscito!\n");
+ a_cookie = valore.array_cookie;
address@hidden example
+
address@hidden
+Si noti come @code{a_cookie} @`e reimpostato dal campo @code{array_cookie}
+nella struttura @code{valore}.
+
+Il secondo passo aggiunge due elementi normali a @code{nuovo_vettore}:
+
address@hidden
+ (void) make_const_string("salve", 5, & index);
+ (void) make_const_string("mondo", 5, & value);
+ if (! set_array_element(a_cookie, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
+
+ (void) make_const_string("risposta", 8, & index);
+ (void) make_number(42.0, & value);
+ if (! set_array_element(a_cookie, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
address@hidden example
+
+Il terzo passo @`e creare il sottovettore e aggiungerlo al vettore:
+
address@hidden
+ (void) make_const_string("sottovettore", 12, & index);
+ sottovettore = create_array();
+ valore.val_type = AWK_array;
+ valore.array_cookie = subarray;
+ if (! set_array_element(a_cookie, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
+ sottovettore = valore.array_cookie;
address@hidden example
+
+Il passo finale @`e di aggiungere al sottovettore un suo proprio elemento:
+
address@hidden
+ (void) make_const_string("pippo", 5, & index);
+ (void) make_const_string("pluto", 5, & value);
+ if (! set_array_element(sottovettore, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
address@hidden
address@hidden
+static awk_ext_func_t func_table[] = @{
+ @{ NULL, NULL, 0 @}
address@hidden;
+
+/* init_testarray --- funzione ulteriore di inizializzazione */
+
+static awk_bool_t init_testarray(void)
address@hidden
+ create_new_array();
+
+ return awk_true;
address@hidden
+
+static awk_bool_t (*init_func)(void) = init_testarray;
+
+dl_load_func(func_table, testarray, "")
address@hidden ignore
address@hidden example
+
+Ecco uno script di esempio che carica l'estensione
+e quindi stampa il valore di tutti gli elementi del vettore,
+invocando nuovamente se stessa nel caso che un particolare
+elemento sia a sua volta un vettore:
+
address@hidden
+@@load "subarray"
+
+function dumparray(name, vettore, i)
address@hidden
+ for (i in vettore)
+ if (isarray(vettore[i]))
+ dumparray(name "[\"" i "\"]", vettore[i])
+ else
+ printf("%s[\"%s\"] = %s\n", name, i, vettore[i])
address@hidden
+
+BEGIN @{
+ dumparray("new_array", new_array);
address@hidden
address@hidden example
+
+Ecco il risultato dell'esecuzione dello script:
+
address@hidden
+$ @kbd{AWKLIBPATH=$PWD ./gawk -f subarray.awk}
address@hidden new_array["sottovettore"]["pippo"] = pluto
address@hidden new_array["salve"] = mondo
address@hidden new_array["risposta"] = 42
address@hidden example
+
address@hidden
+(@xref{Trovare le estensioni} per ulteriori dettagli sulla
+variabile d'ambiente @env{AWKLIBPATH}.)
+
address@hidden Ridirezione API
address@hidden Accedere alle ridirezioni e modificarle
+
+La seguente funzione consente alle estensioni di accedere e di manipolare
+delle ridirezioni.
+
address@hidden @code
address@hidden awk_bool_t get_file(const char *name,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ size_t name_len,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const char *tipofile,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ int fd,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const awk_input_buf_t
**ibufp,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const awk_output_buf_t
**obufp);
+Ricerca il file @code{name} nella tabella interna di ridirezione di
address@hidden
+Se @code{name} @`e @code{NULL} o @code{name_len} @`e zero, restituisce
+i dati del file in input correntemente aperto il cui nome @`e memorizzato in
address@hidden
+(Questa chiamata non usa l'argomento @code{filetype}, che, quindi,
address@hidden essere
+lasciato indefinito).
+Se il file non @`e address@hidden aperto, tenta di aprirlo.
+L'argomento @code{filetype} deve terminare con uno zero binario, e dovrebbe
+dovrebbe avere uno di questi valori:
+
address@hidden @code
address@hidden ">"
+Un file aperto in output.
+
address@hidden ">>"
+Un file aperto in output, record aggiunti a fine file,
+dopo quelli address@hidden esistenti address@hidden
+
address@hidden "<"
+Un file aperto in input.
+
address@hidden "|>"
+Una @dfn{pipe} aperta in output.
+
address@hidden "|<"
+Una @dfn{pipe} aperta in input.
+
address@hidden "|&"
+Un coprocesso bidirezionale.
address@hidden table
+
+In caso di errore, restituisce il valore @address@hidden
+Altrimenti, restituisce
address@hidden@dfn{awk_true}}, insieme a ulteriori informazioni sulla
ridirezione
+nei puntatori @code{ibufp} e @code{obufp}.
+Per ridirezioni di input il valore @code{*ibufp} non dovrebbe essere
address@hidden, mentre @code{*obufp} dovrebbe essere @code{NULL}.
+Per ridirezioni di output,
+il valore di @code{*obufp} non dovrebbe essere @code{NULL}, e @code{*ibufp}
+dovrebbe essere @code{NULL}. Per coprocessi bidirezionali, nessuno dei due
+valori dovrebbe essere @code{NULL}.
+
+Normalmente, l'estensione @`e interessata a @code{(*ibufp)->fd}
+e/o @code{fileno((*obufp)->fp)}. Se il file non @`e address@hidden
+aperto, e l'argomento @code{fd} non @`e negativo, @command{gawk}
address@hidden quel descrittore di file invece di aprire il file nella
+maniera solita. Se l'@code{fd} non @`e negativo, ma il file esiste
address@hidden,
address@hidden ignora l'@code{fd} e restituisce il file esistente. @`E
address@hidden del chiamante notare che n@'e l'@code{fd} nella struttura
+restituita @code{awk_input_buf_t}, n@'e l'@code{fd} nella struttura restituita
address@hidden contiene il valore richiesto.
+
+Si noti che fornire un descrittore di file @emph{non} @`e al momento supportato
+per le @dfn{pipe}. Tuttavia, l'utilizzo di un descrittore di file
+dovrebbe essere possibile per @dfn{socket} in input, output,
+aggiunta-a-fine-file (append), e bidirezionale (coprocessi).
+Se @code{filetype} @`e bidirezionale, @command{gawk} presuppone che sia un
address@hidden Si noti che nel caso
+bidirezionale i descrittori di file in input e output possono essere
+differenti.
+Per essere sicuri che tutto sia andato bene, si deve controllare che uno dei
due
+corrisponda alla richiesta.
address@hidden table
+
+Si prevede che questa funzione API address@hidden usata per parallelizzare
l'I/O
+e rendere disponibile una libreria per i @dfn{socket}.
+
address@hidden Variabili dell'estensione API
address@hidden Variabili fornite dall'API
+
+L'API fornisce due insiemi di variabili. Il primo insieme contiene
+informazioni sulla versione dell'API (sia la versione dell'estensione
+compilata, che quella di @command{gawk}). Il secondo
+insieme contiene informazioni su come @command{gawk} @`e stato invocato.
+
address@hidden
+* Versione dell'estensione:: Informazioni sulla versione API.
+* Variabili informative di estens. API:: Variabili che forniscono informationi
+ sull'invocazione di @command{gawk}.
address@hidden menu
+
address@hidden Versione dell'estensione
address@hidden Costanti e variabili della versione dell'API
address@hidden API, versione
address@hidden versione dell'estensione API @command{gawk}
address@hidden estensione @command{gawk}, versione API
+
+L'API fornisce sia un numero di versione ``principale'' che uno ``secondario''.
+Le versioni dell'API sono disponibili al momento della compilazione, come
+definizioni per il preprocessore C, a supporto della compilazione
+condizionale, e come elencazione di costanti per facilitare il debug:
+
address@hidden Tabella,gawk-api-version
address@hidden delle versioni API gawk}
address@hidden address@hidden Version}} address@hidden address@hidden
address@hidden versione API @tab Definiz. Preprocessore C @tab Costante di
elenco
address@hidden Major @tab @code{gawk_api_major_version} @tab
@code{GAWK_API_MAJOR_VERSION}
address@hidden Minor @tab @code{gawk_api_minor_version} @tab
@code{GAWK_API_MINOR_VERSION}
address@hidden multitable
address@hidden float
+
+La versione secondaria aumenta quando nuove funzioni sono aggiunte all'API.
+Tali nuove funzioni sono sempre aggiunte alla fine della @code{struct}
dell'API.
+
+La versione principale aumenta (e la versione secondaria torna a zero) se
+qualche tipo di dati cambia dimensione o si modifica l'ordine dei campi, o se
+qualcuna delle funzioni esistenti cambia il livello di versione.
+
address@hidden capitare che un'estensione sia stata compilata con una versione
+dell'API ma caricata da una versione di @command{gawk} che ne usa una
+differente. Per questo motivo, la versione principale e quella secondaria
+dell'API della versione in uso di @command{gawk} sono incluse nella
address@hidden dell'API come costanti intere in sola lettura:
+
address@hidden @code
address@hidden api->major_version
+La versione principale di @command{gawk} in esecuzione.
+
address@hidden api->minor_version
+La versione secondaria di @command{gawk} in esecuzione.
address@hidden table
+
+Dipende dall'estensione decidere se ci sono address@hidden con l'API.
+Tipicamente, basta un controllo di questo tipo:
+
address@hidden
+if (api->major_version != GAWK_API_MAJOR_VERSION
+ || api->minor_version < GAWK_API_MINOR_VERSION) @{
+ fprintf(stderr, "estensione_pippo: discordanza di versione \
+con gawk!\n");
+ fprintf(stderr, "\tLa mia versione (%d, %d), versione gawk \
+(%d, %d)\n",
+ GAWK_API_MAJOR_VERSION, GAWK_API_MINOR_VERSION,
+ api->major_version, api->minor_version);
+ exit(1);
address@hidden
address@hidden example
+
+Questo codice @`e incluso nella macro generica @code{dl_load_func()}
+presente in @file{gawkapi.h} (trattata
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden predefinito di un'estensione API}).
+
address@hidden Variabili informative di estens. API
address@hidden Variabili informative
address@hidden API, variabili informative dell'estensione
address@hidden variabili informative dell'API
address@hidden estensione API, variabili informative
+
+L'API fornisce accesso a parecchie variabili che descrivono
+se le opzioni della riga di comando corrispondenti sono state specificate
+quando @command{gawk} @`e stato chiamato. Le variabili sono:
+
address@hidden @code
address@hidden do_debug
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--debug}.
+
address@hidden do_lint
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--lint}.
+
address@hidden do_mpfr
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--bignum}.
+
address@hidden do_profile
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--profile}.
+
address@hidden do_sandbox
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--sandbox}.
+
address@hidden do_traditional
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--traditional}.
address@hidden table
+
+Il valore di @code{do_lint} address@hidden cambiare se il codice @command{awk}
+modifica la variabile predefinita @code{LINT} (@pxref{Variabili predefinite}).
+Gli altri valori non dovrebbero cambiare durante l'esecuzione.
+
address@hidden Codice predefinito di un'estensione API
address@hidden Codice predefinito di interfaccia API
+
+Come address@hidden detto (@pxref{Panoramica sul meccanismo delle estensioni}),
+le definizioni di funzioni qui presentate sono in address@hidden delle macro.
+Per usare queste macro, l'estensione deve fornire una piccola address@hidden di
+codice predefinito (variabili e
+funzioni) nella parte iniziale del file sorgente, usando dei nomi
+standard, come descritto qui sotto. Il codice predefinito in questione @`e
+anche descritto nel file di intestazione @file{gawkapi.h}:
+
address@hidden
+/* Codice predefinito: */
+int plugin_is_GPL_compatible;
+
+static gawk_api_t *const api;
+static awk_ext_id_t ext_id;
+static const char *ext_version = NULL; /* o @dots{} = "qualche stringa" */
+
+static awk_ext_func_t func_table[] = @{
+ @{ "name", do_name, 1, 0, awk_false, NULL @},
+ /* @dots{} */
address@hidden;
+
+/* O: */
+
+static awk_bool_t (*init_func)(void) = NULL;
+
+/* OPPURE: */
+
+static awk_bool_t
+init_mia_estensione(void)
address@hidden
+ @dots{}
address@hidden
+
+static awk_bool_t (*init_func)(void) = init_mia_estensione;
+
+dl_load_func(func_table, qualche_nome, "name_space_in_quotes")
address@hidden example
+
+Queste variabili e funzioni sono:
+
address@hidden @code
address@hidden int plugin_is_GPL_compatible;
+Qui si dichiara che l'estensione @`e compatibile con
address@hidden FOR_PRINT
+la licenza GNU GPL (@pxref{Copia}).
+
address@hidden ifclear
address@hidden FOR_PRINT
+la licenza GNU GPL.
address@hidden ifset
+Se l'estensione non ha questa variabile, non address@hidden caricata da
@command{gawk}
+(@pxref{Licenza delle estensioni}).
+
address@hidden static gawk_api_t *const api;
+Questa variabile globale @code{static} dovrebbe essere impostata per
+puntare al puntatore
address@hidden che @command{gawk} passa alla funzione (dell'estensione)
address@hidden()}. Questa variabile @`e usata da tutte le macro.
+
address@hidden static awk_ext_id_t ext_id;
+Questa variabile globale @code{static} dovrebbe essere impostata al valore
address@hidden che @command{gawk} passa alla funzione @code{dl_load()}.
+Questa variabile @`e usata da tutte le macro.
+
address@hidden static const char *ext_version = NULL; /* o @dots{} = "qualche
stringa" */
+Questa variabile globale @code{static} dovrebbe essere impostata
+a @code{NULL} oppure puntare a una stringa che contiene il nome e la
+versione dell'estensione.
+
address@hidden static awk_ext_func_t func_table[] = @{ @dots{} @};
+Questo @`e un vettore di una o address@hidden strutture @code{awk_ext_func_t},
+come descritto in precedenza (@pxref{Funzioni di estensione}).
address@hidden essere usato in seguito per address@hidden chiamate a
address@hidden()}.
+
address@hidden Use @var{OR} for docbook
address@hidden static awk_bool_t (*init_func)(void) = NULL;
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @var{OR}
address@hidden static awk_bool_t init_mia_estensione(void) @{ @dots{} @}
address@hidden static awk_bool_t (*init_func)(void) = init_mia_estensione;
+Se qualche lavoro di inizializzazione @`e necessario, si dovrebbe definire una
+funzione all'uopo (crea variabili, apre file, etc.)
+e poi definire il puntatore @code{init_func} che punti alla funzione
+stessa.
+La funzione dovrebbe restituire @address@hidden se non va a buon fine
+o @code{awktrue} se tutto va bene.
+
+Se un'inizializzazione non @`e necessaria, si definisca il puntatore e
+lo si inizializzi a @code{NULL}.
+
address@hidden dl_load_func(func_table, qualche_nome,
"nome_spazio_tra_doppi_apici")
+Questa macro genera una funzione @code{dl_load()} che address@hidden
+tutte le inizializzazioni necessarie.
address@hidden table
+
+Lo scopo di tutte le variabili e dei vettori @`e di far
address@hidden@dotless{i}} che la
+funzione @code{dl_load()} (richiamata dalla macro @code{dl_load_func()})
+faccia tutto il lavoro standard necessario, qui descritto:
+
address@hidden 1
address@hidden
+Controlla le versioni dell'API. Se la versione principale dell'estensione
+non corrisponde a quella di @command{gawk} o se la versione secondaria
+dell'estensione @`e maggiore di quella di @command{gawk}, stampa un messaggio
+di errore fatale ed esce.
+
address@hidden
+Carica le funzioni definite in @code{func_table}.
+Se qualche caricamento non riesce, stampa un messaggio di
+avvertimento ma continua l'esecuzione.
+
address@hidden
+Se il puntatore @code{init_func} non @`e @code{NULL}, chiama la
+funzione da esso puntata. Se questa restituisce @code{awk_false}, stampa un
+messaggio di avvertimento.
+
address@hidden
+Se @code{ext_version} non @`e @code{NULL}, registra la
+stringa di versione con @command{gawk}.
address@hidden enumerate
+
address@hidden Modifiche dalla versione API 1
address@hidden Modifiche dalla versione 1 dell'API
+
+La versione API corrente @emph{non} @`e compatibile a livello binario con la
+versione 1 dell'API.
+Le funzioni di estensione vanno ricompilate per poterle usare con la versione
+corrente di @command{gawk}.
+
+Fortunatamente, fatti salvi alcuni possibili avvertimenti a livello di
+compilazione, l'API rimane compatibile a livello di codice sorgente con la
+precedente versione API. Le differenze address@hidden rilevanti sono gli
ulteriori
+campi nella struttura @code{awk_ext_func_t}, e l'aggiunta del terzo argomento
+nella funzione di implementazione in linguaggio C.
+
address@hidden Trovare le estensioni
address@hidden Come @command{gawk} trova le estensioni compilate
address@hidden estensioni, percorso di ricerca per
address@hidden estensioni, come trovarle
address@hidden trovare le estensioni
address@hidden percorso di ricerca per estensioni
+
+Le estensioni compilate vanno installate in una directory dove
address@hidden possa trovarle. Se @command{gawk} @`e configurato e
+installato nella maniera di default, la directory dove trovare le
+estensioni @`e @file{/usr/local/lib/gawk}. Si address@hidden anche
specificare un
+percorso di ricerca contenente una lista di directory da esaminare per la
+ricerca di estensioni compilate.
address@hidden (Variabile)} per ulteriori dettagli.
+
address@hidden Esempio di estensione
address@hidden Esempio: alcune funzioni per i file
address@hidden estensione, esempio
address@hidden esempio di estensione
+
address@hidden
address@hidden qualunque posto vai, address@hidden tu sei.}
address@hidden Buckaroo Banzai
address@hidden quotation
+
address@hidden It's enough to show chdir and stat, no need for fts
+
+Due utili funzioni che non sono in @command{awk} sono @code{chdir()} (per
+permettere a un programma @command{awk} di cambiare directory di lavoro) e
address@hidden()}
+(per far address@hidden@dotless{i}} che un programma @command{awk} possa
raccogliere informazioni
+su un dato file).
+Per illustrare l'azione dell'API, questa @value{SECTION} fornisce
+queste funzioni a @command{gawk} in un'estensione.
+
address@hidden
+* Descrizione interna file:: Quello che le nuove funzioni faranno
+* Operazioni interne file:: Codice per gestire file all'interno
+* Usare operazioni interne file:: Come usare un'estensione esterna
address@hidden menu
+
address@hidden Descrizione interna file
address@hidden Usare @code{chdir()} e @code{stat()}
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden mostra come usare le nuove funzioni a
+livello di @command{awk} una volta che siano state integrate nell'interprete
+del programma @command{gawk} in esecuzione. Usare @code{chdir()} @`e molto
+semplice. Richiede un solo argomento, la nuova directory su cui
+posizionarsi:
+
address@hidden
+@@load "filefuncs"
address@hidden
+newdir = "/home/arnold/funstuff"
+ret = chdir(newdir)
+if (ret < 0) @{
+ printf("non riesco a passare a %s: %s\n", newdir, ERRNO) > "/dev/stderr"
+ exit 1
address@hidden
address@hidden
address@hidden example
+
+Il valore restituito @`e negativo se la chiamata a @code{chdir()} non @`e
riuscita,
+ed @code{ERRNO} (@pxref{Variabili predefinite}) @`e impostato a una stringa
+che descrive l'errore.
+
+Usare @code{stat()} @`e un po' address@hidden complicato. La funzione scritta
in C
address@hidden()} riempie una struttura che ha una certa address@hidden di
informazioni.
+La maniera corretta per immagazzinarle in @command{awk} @`e quella di riempire
+un vettore associativo con le informazioni appropriate:
+
address@hidden broke printf for page breaking
address@hidden
+file = "/home/arnold/.profile"
+ret = stat(file, fdata)
+if (ret < 0) @{
+ printf("non @`e stato possibile eseguire @command{stat} per %s: %s\n",
+ file, ERRNO) > "/dev/stderr"
+ exit 1
address@hidden
+printf("dimensione di %s @`e %d byte\n", file, fdata["size"])
address@hidden example
+
+La funzione @code{stat()} svuota sempre il vettore che contiene i dati,
+anche nel caso che la chiamata a @code{stat()} non riesca. I seguenti
+elementi vengono restituiti dalla funzione:
+
address@hidden @code
address@hidden "name"
+Il nome del file oggetto della chiamata a @code{stat()}.
+
address@hidden "dev"
address@hidden "ino"
+I numeri di @dfn{device} e di @dfn{inode}, rispettivamente.
+
address@hidden "mode"
+Il modo del file, in formato numerico. Questo include sia il tipo di file che
+i suoi permessi di accesso.
+
address@hidden "nlink"
+Il numero di collegamenti fisici del file (stesso file con diversi nomi).
+
address@hidden "uid"
address@hidden "gid"
+Gli identificativi di utente e di gruppo del possessore del file.
+
address@hidden "size"
+La dimensione in byte del file.
+
address@hidden "blocks"
+Il numero di blocchi su disco realmente occupati dal file. Questo
address@hidden non
+essere
+proporzionale alla dimensione del file se il file ha delle lacune
+[ossia se solo alcune parti del file esistono veramente, il resto
+non @`e ancora stato riempito].
+
address@hidden "atime"
address@hidden "mtime"
address@hidden "ctime"
+La data e ora dell'ultimo accesso, modifica, e aggiornamento dell'@dfn{inode},
+rispettivamente. Questi sono delle marcature temporali numeriche
+(misurate in secondi dal
+01 gennaio 1970), che possono essere formattate dalla funzione
address@hidden()}
+(@pxref{Funzioni di tempo}).
+
address@hidden "pmode"
+La address@hidden stampabile (``printable mode'') del file.
+Questo @`e una stringa che rappresenta
+il tipo del file e i permessi di accesso, come sono visualizzati da
address@hidden -l}---per esempio, @code{"drwxr-xr-x"}.
+
address@hidden "type"
+Una stringa stampabile che descrive il tipo di file. Il valore @`e uno dei
+seguenti:
+
address@hidden @code
address@hidden "blockdev"
address@hidden "chardev"
+Il file @`e un dispositico a blocchi o a caratteri (``file speciale'').
+
address@hidden
address@hidden "door"
+The file is a Solaris ``door'' (special file used for
+interprocess communications).
address@hidden ignore
+
address@hidden "directory"
+Il file @`e una directory.
+
address@hidden "fifo"
+Il file @`e una @dfn{pipe} denominata (nota anche come FIFO [First In First
+Out]).
+
address@hidden "file"
+Il file @`e un file normale.
+
address@hidden "@dfn{socket}"
+Il file @`e un @dfn{socket} @code{AF_UNIX} (``Unix domain'') nel
+filesystem.
+
address@hidden "symlink"
+Il file @`e un collegamento simbolico.
address@hidden table
+
address@hidden 5/2013: Thanks to Corinna Vinschen for this information.
address@hidden "devbsize"
+La dimensione di un blocco per l'elemento indicizzato da @code{"blocks"}.
+Questa informazione @`e derivata dalla costante @code{DEV_BSIZE}
+definita in @code{<sys/param.h>} nella maggior parte dei sistemi,
+o dalla costante @code{S_BLKSIZE} in @code{<sys/stat.h>} nei sistemi BSD.
+Per alcuni altri sistemi il valore si basa su una conoscenza @dfn{a priori}
+delle caratteristiche di un particolare sistema.
+Se non si riesce a determinare il valore, viene
+restituito quello di default, che @`e 512.
address@hidden table
+
+Possono essere presenti diversi altri elementi, a seconda del
+sistema operativo e del tipo di file.
+Si address@hidden controllarne la presenza dal programma @command{awk} per
mezzo
+dell'operatore @code{in}
+(@pxref{Visitare elementi}):
+
address@hidden @code
address@hidden "blksize"
+La dimensione preferita di un blocco per effettuare operazioni di I/O sul file.
+Questo campo non @`e presente nella struttura C @code{stat} di tutti i sistemi
+che rispettano lo standard POSIX.
+
address@hidden "linkval"
+Se il file @`e un collegamento simbolico, questo elemento @`e il nome del
+file puntato dal collegamento simbolico (address@hidden, il valore del
collegamento).
+
address@hidden "rdev"
address@hidden "major"
address@hidden "minor"
+Se il file @`e un dispositivo a blocchi o a caratteri, questi valori
+rappresentano il numero del dispositivo e, rispettivamente, le componenti
+principale e secondaria di quel numero.
address@hidden table
+
address@hidden Operazioni interne file
address@hidden Codice C per eseguire @code{chdir()} e @code{stat()}
+
+Questo @`e il codice C per queste address@hidden versione qui
+presentata @`e
+lievemente modificata per amor di address@hidden Si veda
@file{extension/filefuncs.c}
+nella distribuzione @command{gawk} per la versione completa.}
+
+Il file include alcuni file di intestazione standard, e poi il file di
+intestazione @file{gawkapi.h}, che fornisce le definizioni dell'API.
+A queste seguono le dichiarazioni di variabili, necessarie
+per usare le macro dell'API e il codice predefinito
+(@pxref{Codice predefinito di un'estensione API}):
+
address@hidden
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <stdio.h>
+#include <assert.h>
+#include <errno.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+
+#include <sys/types.h>
+#include <sys/stat.h>
+
+#include "gawkapi.h"
+
+#include "gettext.h"
+#define _(msgid) gettext(msgid)
+#define N_(msgid) msgid
+
+#include "gawkfts.h"
+#include "stack.h"
+
+static const gawk_api_t *api; /* per consentire il funzionamento
+ delle macro di address@hidden */
+static awk_ext_id_t *ext_id;
+static awk_bool_t init_filefuncs(void);
+static awk_bool_t (*init_func)(void) = init_filefuncs;
+static const char *ext_version = "filefuncs extension: version 1.0";
+
+int plugin_is_GPL_compatible;
address@hidden example
+
address@hidden programmazione, convenzioni di, estensioni @command{gawk}
address@hidden estensioni @command{gawk}, convenzioni di programmazione
+Per convenzione, per una funzione @command{awk} di nome @code{pippo()},
+la funzione C che la implementa @`e chiamata @code{do_pippo()}. La funzione
+dovrebbe avere due argomenti. Il primo @`e un numero @code{int}, chiamato
address@hidden, che rappresenta il numero di argomenti passato alla funzione.
+Il secondo @`e un puntatore a una struttura @code{awk_value_t}, normalmente
+chiamata @code{risultato}:
+
address@hidden
+/* do_chdir --- fornisce funzione chdir()
+ caricata dinamicamente per gawk */
+
+static awk_value_t *
+do_chdir(int nargs, awk_value_t *risultato, struct awk_ext_func *non_usata)
address@hidden
+ awk_value_t newdir;
+ int ret = -1;
+
+ assert(risultato != NULL);
address@hidden example
+
+La variabile @code{newdir}
+rappresenta la nuova directory nella quale cambiare, che @`e ottenuta
+tramite la funzione @code{get_argument()}. Si noti che il primo argomento @`e
+quello numero zero.
+
+Se l'argomento @`e stato trovato con successo, la funzione invoca la chiamata
di
+sistema @code{chdir()}. In caso contrario, se la @code{chdir()} non riesce,
+viene aggiornata la variabile @code{ERRNO}:
+
address@hidden
+ if (get_argument(0, AWK_STRING, & newdir)) @{
+ ret = chdir(newdir.str_value.str);
+ if (ret < 0)
+ update_ERRNO_int(errno);
+ @}
address@hidden example
+
+Infine, la funzione restituisce il codice di ritorno da @code{chdir} a
+livello di @command{awk}:
+
address@hidden
+ return make_number(ret, risultato);
address@hidden
address@hidden example
+
+L'estensione @code{stat()} @`e address@hidden impegnativa. Dapprima abbiamo
+una funzione che trasforma la stringa di autorizzazione numerica
+(@dfn{mode}) in una rappresentazione stampabile
+(p.es., il codice ottale @code{0644} diviene @samp{-rw-r--r--}). Questa
+parte @`e qui omessa per address@hidden
+
address@hidden
+/* format_mode --- trasforma il campo @dfn{mode} di @dfn{stat}
+ in qualcosa di leggibile */
+
+static char *
+format_mode(unsigned long fmode)
address@hidden
+ @dots{}
address@hidden
address@hidden example
+
+Viene poi una funzione per leggere dei collegamenti simbolici, anche questa
+omessa per address@hidden:
+
address@hidden
+/* read_symlink --- legge un collegamento simbolico in un buffer
+ allocato.
+ @dots{} */
+
+static char *
+read_symlink(const char *fname, size_t bufsize, ssize_t *linksize)
address@hidden
+ @dots{}
address@hidden
address@hidden example
+
+Due funzioni ausiliarie semplificano l'immissione di valori nel
+vettore che address@hidden il risultato della chiamata a @code{stat()}:
+
address@hidden
+/* array_set --- imposta un elemento di un vettore */
+
+static void
+array_set(awk_array_t vettore, const char *sub, awk_value_t *valore)
address@hidden
+ awk_value_t index;
+
+ set_array_element(vettore,
+ make_const_string(sub, strlen(sub), & index),
+ valore);
+
address@hidden
+
+/* array_set_numeric --- imposta un elemento di un vettore con un
+ numero */
+
+static void
+array_set_numeric(awk_array_t vettore, const char *sub, double num)
address@hidden
+ awk_value_t tmp;
+
+ array_set(vettore, sub, make_number(num, & tmp));
address@hidden
address@hidden example
+
+La seguente funzione fa il grosso del lavoro per riempire il vettore dei
+risultati @code{awk_array_t} con valori ottenuti
+da una @code{struct stat} valida. Questo lavoro @`e fatto in una funzione
+separata per supportare sia la funzione
address@hidden()} per @command{gawk}, che l'estensione @code{fts()},
+che @`e inclusa nello stesso file, ma non
+ @`e mostrata qui
+(@pxref{Esempio di estensione funzioni file}).
+
+La prima parte della funzione @`e la dichiarazione delle variabili,
+compresa una tabella per tradurre i tipi di file in stringhe:
+
address@hidden
+/* fill_stat_array --- fa il lavoro di riempire un
+ vettore con informazioni da stat */
+
+static int
+fill_stat_array(const char *name, awk_array_t vettore, struct stat *sbuf)
address@hidden
+ char *pmode; /* @dfn{mode} stampabile */
+ const char *type = "unknown";
+ awk_value_t tmp;
+ static struct ftype_map @{
+ unsigned int mask;
+ const char *type;
+ @} ftype_map[] = @{
+ @{ S_IFREG, "file" @},
+ @{ S_IFBLK, "blockdev" @},
+ @{ S_IFCHR, "chardev" @},
+ @{ S_IFDIR, "directory" @},
+#ifdef S_IFSOCK
+ @{ S_IFSOCK, "socket" @},
+#endif
+#ifdef S_IFIFO
+ @{ S_IFIFO, "fifo" @},
+#endif
+#ifdef S_IFLNK
+ @{ S_IFLNK, "symlink" @},
+#endif
+#ifdef S_IFDOOR /* Stranezza Solaris */
+ @{ S_IFDOOR, "door" @},
+#endif /* S_IFDOOR */
+ @};
+ int j, k;
address@hidden example
+
+Il vettore di destinazione @`e svuotato di elementi, e poi il codice riempie
+i vari elementi prendendoli dai valori presenti in @code{struct stat}:
address@hidden
+ /* svuota il vettore */
+ clear_array(vettore);
+
+ /* riempie il vettore */
+ array_set(vettore, "name", make_const_string(name, strlen(name),
+ & tmp));
+ array_set_numeric(vettore, "dev", sbuf->st_dev);
+ array_set_numeric(vettore, "ino", sbuf->st_ino);
+ array_set_numeric(vettore, "mode", sbuf->st_mode);
+ array_set_numeric(vettore, "nlink", sbuf->st_nlink);
+ array_set_numeric(vettore, "uid", sbuf->st_uid);
+ array_set_numeric(vettore, "gid", sbuf->st_gid);
+ array_set_numeric(vettore, "size", sbuf->st_size);
+ array_set_numeric(vettore, "blocks", sbuf->st_blocks);
+ array_set_numeric(vettore, "atime", sbuf->st_atime);
+ array_set_numeric(vettore, "mtime", sbuf->st_mtime);
+ array_set_numeric(vettore, "ctime", sbuf->st_ctime);
+
+ /* per dispositivi a blocchi o carattere, aggiunge rdev,
+ e il numero principale e secondario */
+ if (S_ISBLK(sbuf->st_mode) || S_ISCHR(sbuf->st_mode)) @{
+ array_set_numeric(vettore, "rdev", sbuf->st_rdev);
+ array_set_numeric(vettore, "major", major(sbuf->st_rdev));
+ array_set_numeric(vettore, "minor", minor(sbuf->st_rdev));
+ @}
address@hidden example
+
address@hidden
+L'ultima parte della funzione fa alcune aggiunte selettive
+al vettore di destinazione, a seconda che siano disponibili o no
+certi campi e/o il tipo del file. Viene poi restituito zero, per indicare che
+tutto @`e andato bene:
+
address@hidden
+#ifdef HAVE_STRUCT_STAT_ST_BLKSIZE
+ array_set_numeric(vettore, "blksize", sbuf->st_blksize);
+#endif /* HAVE_STRUCT_STAT_ST_BLKSIZE */
+
+ pmode = format_mode(sbuf->st_mode);
+ array_set(vettore, "pmode", make_const_string(pmode, strlen(pmode),
+ & tmp));
+
+ /* per collegamenti simbolici, si aggiunge un campo linkval */
+ if (S_ISLNK(sbuf->st_mode)) @{
+ char *buf;
+ ssize_t linksize;
+
+ if ((buf = read_symlink(name, sbuf->st_size,
+ & linksize)) != NULL)
+ array_set(vettore, "linkval",
+ make_malloced_string(buf, linksize, & tmp));
+ else
+ warning(ext_id, _("stat: non riesco a leggere il \
+collegamento simbolico `%s'"),
+ name);
+ @}
+
+ /* aggiunge il tipo di campo */
+ type = "unknown"; /* non dovrebbe succedere */
+ for (j = 0, k = sizeof(ftype_map)/sizeof(ftype_map[0]); j < k; j++) @{
+ if ((sbuf->st_mode & S_IFMT) == ftype_map[j].mask) @{
+ type = ftype_map[j].type;
+ break;
+ @}
+ @}
+
+ array_set(vettore, "type", make_const_string(type, strlen(type), & tmp));
+
+ return 0;
address@hidden
address@hidden example
+
+Del terzo argomento passato a @code{stat()} non si era ancora parlato.
+Questo argomento @`e facoltativo. Se presente, dice a @code{do_stat()} di
+usare la chiamata di sistema @code{stat()} invece della chiamata di sistema
address@hidden()}. Questo avviene attraverso un puntatore a funzione:
address@hidden
address@hidden @`e inizializzato per puntare a @code{lstat()} (invece che a
address@hidden()}) per ottenere le informazioni relative al file, nel caso che
+il file in questione sia un
+collegamento simbolico. Tuttavia, se il terzo argomento @`e specificato,
address@hidden viene modificato in modo da puntare a @code{stat()}.
+
+Ecco la funzione @code{do_stat()}, che inizia con la dichiarazione delle
+variabili e un controllo degli argomenti passati dal chiamante:
+
address@hidden
+/* do_stat --- fornisce una funzione stat() per gawk */
+
+static awk_value_t *
+do_stat(int nargs, awk_value_t *risultato, struct awk_ext_func *non_usata)
address@hidden
+ awk_value_t file_param, array_param;
+ char *name;
+ awk_array_t vettore;
+ int ret;
+ struct stat sbuf;
+ /* per default si usa lstat() */
+ int (*statfunc)(const char *path, struct stat *sbuf) = lstat;
+
+ assert(risultato != NULL);
address@hidden example
+
+A questo punto inizia l'elaborazione vera e propria. Per prima cosa, la
+funzione esamina gli argomenti.
+Poi, ottiene le informazioni relative al file. Se la funzione chiamata
+(@code{lstat()} o @code{stat()}) restituisce un errore, il codice imposta
address@hidden e torna al chiamante:
+
address@hidden
+ /* file @`e il primo argomento,
+ il vettore per contenere i risultati @`e il secondo */
+ if ( ! get_argument(0, AWK_STRING, & file_param)
+ || ! get_argument(1, AWK_ARRAY, & array_param)) @{
+ warning(ext_id, _("stat: parametri errati"));
+ return make_number(-1, risultato);
+ @}
+
+ if (nargs == 3) @{
+ statfunc = stat;
+ @}
+
+ name = file_param.str_value.str;
+ vettore = array_param.array_cookie;
+
+ /* svuota sempre il vettore all'inizio */
+ clear_array(vettore);
+
+ /* chiama stat per il file;
+ in caso di errore,
+ imposta ERRNO e ritorna */
+ ret = statfunc(name, & sbuf);
+ if (ret < 0) @{
+ update_ERRNO_int(errno);
+ return make_number(ret, risultato);
+ @}
address@hidden example
+
+Il lavoro noioso @`e svolto da @code{fill_stat_array()}, visto in
+precedenza. Alla fine, la funzione restituisce il codice di ritorno
+impostato da @code{fill_stat_array()}:
+
address@hidden
+ ret = fill_stat_array(name, vettore, & sbuf);
+
+ return make_number(ret, risultato);
address@hidden
address@hidden example
+
+Infine, @`e necessario fornire la ``colla'' che aggrega
+le nuove funzioni a @command{gawk}.
+
+L'estensione @code{filefuncs} comprende anche una funzione
address@hidden()}, qui omessa
+(@pxref{Esempio di estensione funzioni file}).
address@hidden anche prevista una funzione di
+inizializzazione:
+
address@hidden
+/* init_filefuncs --- routine di initializazione */
+
+static awk_bool_t
+init_filefuncs(void)
address@hidden
+ @dots{}
address@hidden
address@hidden example
+
+Siamo quasi alla fine. Serve un vettore di strutture @code{awk_ext_func_t}
+per caricare ogni funzione in @command{gawk}:
+
address@hidden
+static awk_ext_func_t func_table[] = @{
+ @{ "chdir", do_chdir, 1, 1, awk_false, NULL @},
+ @{ "stat", do_stat, 3, 2, awk_false, NULL @},
+ @dots{}
address@hidden;
address@hidden example
+
+Ogni estensione deve avere una routine di nome @code{dl_load()} per caricare
+tutto address@hidden che occorre caricare. La cosa address@hidden semplice
@`e di usare la macro
address@hidden()} in @code{gawkapi.h}:
+
address@hidden
+/* definizione della funzione dl_load()
+ usando la macro standard */
+
+dl_load_func(func_table, filefuncs, "")
address@hidden example
+
+Abbiamo finito!
+
address@hidden Usare operazioni interne file
address@hidden Integrare le estensioni
+
address@hidden @command{gawk}, aggiungere address@hidden a
address@hidden address@hidden, aggiungere a @command{gawk}
address@hidden aggiungere address@hidden a @command{gawk}
+Dopo aver scritto il codice, dev'essere possibile aggiungerlo in fase
+di esecuzione all'interprete @command{gawk}. Per prima cosa, il codice
+va compilato. Supponendo che le funzioni siano in
+un file di nome @file{filefuncs.c}, e che @var{idir} sia la posizione
+del file di intestazione @file{gawkapi.h},
+i seguenti address@hidden pratica, si potrebbe decidere di usare
+i comandi GNU Autotools (Automake, Autoconf, Libtool, e @command{gettext})
+per configurare e costruire le librerie necessarie. L'esposizione di come
address@hidden address@hidden essere fatto esula dal tema di questo
@value{DOCUMENT}.
address@hidden per i puntatori a siti Internet che permettono di accedere
+a questi strumenti.} creano una libreria condivisa GNU/Linux:
+
address@hidden
+$ @kbd{gcc -fPIC -shared -DHAVE_CONFIG_H -c -O -g address@hidden filefuncs.c}
+$ @kbd{gcc -o filefuncs.so -shared filefuncs.o}
address@hidden example
+
+Una volta creata la libreria, questa viene caricata usando la parola
+chiave @code{@@load}:
+
address@hidden
+# file testff.awk
+@@load "filefuncs"
+
+BEGIN @{
+ "pwd" | getline curdir # salva la directory corrente
+ close("pwd")
+
+ chdir("/tmp")
+ system("pwd") # verifica l'avvenuto cambio di directory
+ chdir(curdir) # torna indietro
+
+ print "Info per testff.awk"
+ ret = stat("testff.awk", data)
+ print "ret =", ret
+ for (i in data)
+ printf "data[\"%s\"] = %s\n", i, data[i]
+ print "testff.awk modified:",
+ strftime("%m %d %Y %H:%M:%S", data["mtime"])
+
+ print "\nInfo per JUNK"
+ ret = stat("JUNK", data)
+ print "ret =", ret
+ for (i in data)
+ printf "data[\"%s\"] = %s\n", i, data[i]
+ print "JUNK modified:", strftime("%m %d %Y %H:%M:%S", data["mtime"])
address@hidden
address@hidden example
+
+La variabile d'ambiente @env{AWKLIBPATH} dice a
address@hidden dove @`e possibile trovare le estensioni (@pxref{Trovare le
estensioni}).
+La variabile viene impostata alla directory corrente, e quindi viene eseguito
+il programma:
+
address@hidden
+$ @kbd{AWKLIBPATH=$PWD gawk -f testff.awk}
address@hidden /tmp
address@hidden Info per testff.awk
address@hidden ret = 0
address@hidden data["blksize"] = 4096
address@hidden data["devbsize"] = 512
address@hidden data["mtime"] = 1412004710
address@hidden data["mode"] = 33204
address@hidden data["type"] = file
address@hidden data["dev"] = 2053
address@hidden data["gid"] = 1000
address@hidden data["ino"] = 10358899
address@hidden data["ctime"] = 1412004710
address@hidden data["blocks"] = 8
address@hidden data["nlink"] = 1
address@hidden data["name"] = testff.awk
address@hidden data["atime"] = 1412004716
address@hidden data["pmode"] = -rw-rw-r--
address@hidden data["size"] = 666
address@hidden data["uid"] = 1000
address@hidden testff.awk modified: 09 29 2014 18:31:50
address@hidden
address@hidden Info per JUNK
address@hidden ret = -1
address@hidden JUNK modified: 01 01 1970 02:00:00
address@hidden example
+
address@hidden Esempi di estensione
address@hidden Le estensioni di esempio incluse nella distribuzione
@command{gawk}
address@hidden estensioni distribuite con @command{gawk}
+
+Questa @value{SECTION} fornisce una breve panoramica degli esempi di
+estensione inclusi nella distribuzione di @command{gawk}. Alcune di esse
+sono destinate per l'uso in produzione (p.es., le estensioni
address@hidden, @code{readdir}, e
address@hidden). Altre sono state scritte principalmente per mostrare come
+si usa l'estensione API.
+
address@hidden
+* Esempio di estensione funzioni file:: L'esempio che usa funzioni file.
+* Esempio di estensione Fnmatch:: Un'interfaccia a @code{fnmatch()}.
+* Esempio di estensione Fork:: Un'interfaccia a @code{fork()} e
+ altre funzioni di processo.
+* Esempio di estensione Inplace:: Consentire modifica diretta dei file.
+* Esempio di estensione Ord:: Conversioni a valore e a stringa di
+ caratteri.
+* Esempio di estensione Readdir:: Un'interfaccia a @code{readdir()}.
+* Esempio di estensione Revout:: Semplice post-processore per
+ invertire la stringa in output.
+* Esempio di estensione Rev2way:: Processore bidirezionale per
+ invertire la stringa in output.
+* Esempio di estensione Rwarray:: Serializzare il vettore in un
+ file.
+* Esempio di estensione Readfile:: Leggere un intero file in una stringa.
+* Esempio di estensione Time:: Un'interfaccia a @code{gettimeofday()}
+ e @code{sleep()}.
+* Esempio di estensione API Test:: Test per la API.
address@hidden menu
+
address@hidden Esempio di estensione funzioni file
address@hidden Funzioni relative ai file
+
+L'estensione @code{filefuncs} include tre funzioni diverse, come descritto
sotto.
+L'uso @`e il seguente:
+
address@hidden @asis
address@hidden @code{@@load "filefuncs"}
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{chdir()}, estensione
address@hidden estensione @code{chdir()}
address@hidden @code{risultato = chdir("/qualche/directory")}
+La funzione @code{chdir()} invoca a sua volta la chiamata di sistema
address@hidden()} per cambiare la directory corrente. Restituisce zero
+se tutto va bene o un valore minore di zero in caso di errore.
+In quest'ultimo caso, viene aggiornata la variabile @code{ERRNO}.
+
address@hidden @code{stat()}, estensione
address@hidden estensione @code{stat()}
address@hidden @code{risultato = stat("/qualche/percorso", statdata}
address@hidden, address@hidden)}
+La funzione @code{stat()} invoca a sua volta la chiamata di sistema
address@hidden()}.
+Restituisce zero se tutto va bene o un valore minore di zero in caso di
+errore.
+In quest'ultimo caso, viene aggiornata la variabile @code{ERRNO}.
+
+Per default, viene usata la chiamata di sistema @code{lstat()}.
+Tuttavia, se alla funzione viene passato un terzo argomento, questa invoca
+invece @code{stat()}.
+
+In tutti i casi, il vettore @code{statdata} viene preventivamente svuotato.
+Quando la chiamata a @code{stat()} riesce, viene riempito il vettore
address@hidden con le informazioni ottenute dal fileystem, come segue:
+
address@hidden @columnfractions .15 .50 .20
address@hidden Indice @tab Campo in @code{struct stat} @tab Tipo file
address@hidden @code{"name"} @tab Il @value{FN} @tab Tutti
address@hidden @code{"dev"} @tab @code{st_dev} @tab Tutti
address@hidden @code{"ino"} @tab @code{st_ino} @tab Tutti
address@hidden @code{"mode"} @tab @code{st_mode} @tab Tutti
address@hidden @code{"nlink"} @tab @code{st_nlink} @tab Tutti
address@hidden @code{"uid"} @tab @code{st_uid} @tab Tutti
address@hidden @code{"gid"} @tab @code{st_gid} @tab Tutti
address@hidden @code{"size"} @tab @code{st_size} @tab Tutti
address@hidden @code{"atime"} @tab @code{st_atime} @tab Tutti
address@hidden @code{"mtime"} @tab @code{st_mtime} @tab Tutti
address@hidden @code{"ctime"} @tab @code{st_ctime} @tab Tutti
address@hidden @code{"rdev"} @tab @code{st_rdev} @tab Dispositivi
address@hidden @code{"major"} @tab @code{st_major} @tab Dispositivi
address@hidden @code{"minor"} @tab @code{st_minor} @tab Dispositivi
address@hidden @code{"blksize"} @tab @code{st_blksize} @tab Tutti
address@hidden @code{"pmode"} @tab Una versione leggibile del valore
dell'autorizzazione,
+come quello stampato dal comando
address@hidden (per esempio, @code{"-rwxr-xr-x"}) @tab Tutti
address@hidden @code{"linkval"} @tab Il valore del collegamento simbolico @tab
+Collegamenti simbolici
address@hidden @code{"type"} @tab Il tipo del file in formato address@hidden
essere
address@hidden"file"},
address@hidden"blockdev"},
address@hidden"chardev"},
address@hidden"directory"},
address@hidden"socket"},
address@hidden"fifo"},
address@hidden"symlink"},
address@hidden"door"}
+o
address@hidden"unknown"}
+(non tutti i sistemi supportano tutti i tipi file) @tab Tutti
address@hidden multitable
+
address@hidden @code{fts()}, estensione
address@hidden estensione @code{fts()}
address@hidden @code{flags = or(FTS_PHYSICAL, ...)}
address@hidden @code{risultato = fts(pathlist, flags, filedata)}
+Percorre gli alberi di file elencati in @code{pathlist} e riempie il vettore
address@hidden, come descritto qui di seguito. @code{flags} @`e l'operazione
address@hidden @dfn{bit} a @dfn{bit} di parecchi valori predefiniti, pure
descritti
address@hidden sotto.
+Restituisce zero in assenza di errori, in caso contrario restituisce @minus{}1.
address@hidden table
+
+La funzione @code{fts()} invoca a sua volta la routine di libreria C
address@hidden()} per percorrere gerarchie di file. Invece di restituire i dati
+relativi ai file uno per volta in sequenza,
+riempie un vettore multidimensionale con i dati di ogni file e directory
+che risiedono nelle gerarchie richieste.
+
+Gli argomenti sono i seguenti:
+
address@hidden @code
address@hidden pathlist
+Un vettore di @value{FNS}. Sono usati i valori dei singoli elementi;
+gli indici che puntano a tali valori vengono ignorati.
+
address@hidden flags
+Questo dovrebbe essere l'@dfn{OR} @dfn{bit} a @dfn{bit} di uno o
address@hidden dei
+seguenti valori dei flag costanti predefiniti.
+Almeno uno dei due flag @code{FTS_LOGICAL}
+o @code{FTS_PHYSICAL} dev'essere impostato; in caso contrario
address@hidden()} restituisce una segnalazione di errore e imposta @code{ERRNO}.
+I flag sono:
+
address@hidden nested table
address@hidden @code
address@hidden FTS_LOGICAL
+Passa in rassegna i file in modo ``logico'', e quindi l'informazione restituita
+per un collegamento simbolico @`e quella relativa al file puntato, e non al
+collegamento simbolico stesso. Questo flag @`e mutuamente esclusivo con
address@hidden
+
address@hidden FTS_PHYSICAL
+Passa in rassegna i file in modo ``fisico'', e quindi l'informazione restituita
+per un collegamento simbolico @`e quella relativa al collegamento simbolico
+stesso. Questo flag @`e mutuamente esclusivo con @code{FTS_LOGICAL}.
+
address@hidden FTS_NOCHDIR
+Per migliorare le prestazioni, la routine di libreria C @code{fts()}
+cambia directory mentre percorre una gerarchia di file. Questo flag
+disabilita quell'ottimizzazione.
+
address@hidden FTS_COMFOLLOW
+Si accede al file puntato da un collegamento simbolico esistente in
@code{pathlist},
+anche se @code{FTS_LOGICAL} non @`e stato impostato.
+
address@hidden FTS_SEEDOT
+Per default, la routine di libreria C @code{fts()} non restituisce
+informazioni per i file
address@hidden"."} (punto) e @file{".."} (punto-punto). Quest'opzione richiede
+l'informazione anche per @file{".."}. (L'estensione ritorna sempre
+l'informazione per @file{"."}; maggiori dettagli address@hidden sotto.)
+
address@hidden FTS_XDEV
+Mentre si percorre un filesystem, non passare mai a un filesystem montato
+diverso da quello in cui si opera.
address@hidden address@hidden succedere nel caso di collegamenti simbolici, che
contengono un nome di file
address@hidden che si trova da tutt'altra parte
address@hidden lrwxrwxrwx 1 root root 6 ago 6 2015 /aca -> /d/aca
address@hidden /d/aca:
address@hidden /dev/sda6 115234344 15648380 93709280 15% /d
address@hidden / (e il collegamento simbolico /aca)
address@hidden /dev/sda1 37308224 13573368 21816644 39% /
address@hidden table
+
address@hidden filedata
+Il vettore @code{filedata} contiene i risultati.
+La funzione @code{fts()} lo svuota all'inizio. In seguito viene creato
+un elemento in @code{filedata} per ogni elemento in @code{pathlist}.
+L'indice @`e il nome della directory o del file specificato in @code{pathlist}.
+L'elemento puntato da questo indice @`e a sua volta un vettore. Ci sono due
+casi:
+
address@hidden nested table
address@hidden @emph
address@hidden Il percorso @`e un file
+In questo caso, il vettore contiene due o tre elementi:
+
address@hidden doubly nested table
address@hidden @code
address@hidden "path"
+Il percorso completo di questo file, a partire dalla directory radice
(``root'')
+indicata nel vettore @code{pathlist}.
+
address@hidden "stat"
+Questo elemento @`e esso stesso un vettore, contenente le stesse informazioni
+fornite dalla funzione @code{stat()} vista in precedenza a proposito del suo
+argomento
address@hidden L'elemento address@hidden non essere presente se la chiamata
+di sistema @code{stat()} per il file non @`e riuscita.
+
address@hidden "error"
+Se qualche tipo di errore si verifica durante l'elaborazione, il vettore
address@hidden anche un elemento con chiave @code{"error"}, che @`e una stringa
+che descrive l'errore.
address@hidden table
+
address@hidden Il percorso @`e una directory
+In questo caso, nel vettore viene creato un elemento per ogni elemento
+contenuto nella directory. Se un elemento della directory @`e un
+file, l'azione del programma @`e la stessa descritta sopra per un file.
+Se invece la directory contiene delle sottodirectory, l'elemento creato
+nel vettore @`e (ricorsivamente) a sua volta un vettore che descrive la
+sottodirectory. Se fra i flag @`e stato
+specificato il flag @code{FTS_SEEDOT},
+ci address@hidden anche un elemento di nome
address@hidden".."}. Questo elemento address@hidden un vettore contenente i
dati restituiti
+da un'invocazione di @code{stat()}.
+
+Inoltre, ci address@hidden un elemento il cui indice @`e @code{"."}.
+Questo elemento @`e un vettore contenente gli stessi due o tre elementi che
+sono messi a disposizione per un file: @code{"path"}, @code{"stat"},
+ed @code{"error"}.
address@hidden table
address@hidden table
+
+La funzione @code{fts()} restituisce zero in assenza di errori.
+in caso contrario, restituisce @minus{}1.
+
address@hidden NOTA
+L'estensione @code{fts()} non imita esattamente l'interfaccia fornita dalla
+routine di libreria C @code{fts()}, ma sceglie di fornire un'interfaccia
+basata sui vettori associativi, che @`e address@hidden adeguata per l'uso da
parte di un
+programma @command{awk}. Questo
+implica la mancanza di una funzione di
+confronto, poich@'e @command{gawk} address@hidden
+prevede la address@hidden di mettere facilmente nell'ordine desiderato gli
+elementi di un vettore.
+Anche se un'interfaccia modellata su @code{fts_read()} avrebbe potuto essere
+fornita, @`e sembrato address@hidden naturale mettere a disposizione un vettore
+multidimensionale, che rappresenta la gerarchia dei file e le informazioni
+relative a ognuno di essi.
address@hidden quotation
+
+Si veda il file @file{test/fts.awk} nella distribuzione di @command{gawk}
+per un esempio di uso dell'estensione @code{fts()}.
+
address@hidden Esempio di estensione Fnmatch
address@hidden Un'interfaccia a @code{fnmatch()}
+
+Quest'estensione fornisce un'interfaccia per utilizzare la funzione di
+libreria C @code{fnmatch()}. Si usa address@hidden@dotless{i}}:
+
address@hidden @code
address@hidden @@load "fnmatch"
address@hidden questo il modo per caricare l'estensione.
+
address@hidden @code{fnmatch()}, estensione
address@hidden estensione @code{fnmatch()}
address@hidden risultato = fnmatch(pattern, stringa, flags)
+Il valore restituito @`e zero se tutto va bene, oppure @code{FNM_NOMATCH}
+se la funzione non ha trovato alcuna corrispondenza, o
+un valore differente, diverso da zero, se si @`e verificato un errore.
address@hidden table
+
+Oltre a rendere disponibile la funzione @code{fnmatch()}, l'estensione
+di @code{fnmatch} definisce una costante (@code{FNM_NOMATCH}), e un vettore
+con dei valori di flag, di nome @code{FNM}.
+
+Gli argomenti per @code{fnmatch()} sono:
+
address@hidden @code
address@hidden pattern
+L'espressione regolare con cui confrontare @value{FN}
+
address@hidden stringa
+La stringa @value{FN}
+
address@hidden flags
address@hidden valere zero o essere l'@dfn{OR} @dfn{bit} a @dfn{bit} di uno o
address@hidden flag
+nel vettore @code{FNM}
address@hidden table
+
+I flag sono i seguenti:
+
address@hidden @columnfractions .40 .60
address@hidden Elemento del vettore @tab Flag corrispondente definito da
@code{fnmatch()}
address@hidden @code{FNM["CASEFOLD"]} @tab @code{FNM_CASEFOLD}
address@hidden @code{FNM["FILE_NAME"]} @tab @code{FNM_FILE_NAME}
address@hidden @code{FNM["LEADING_DIR"]} @tab @code{FNM_LEADING_DIR}
address@hidden @code{FNM["NOESCAPE"]} @tab @code{FNM_NOESCAPE}
address@hidden @code{FNM["PATHNAME"]} @tab @code{FNM_PATHNAME}
address@hidden @code{FNM["PERIOD"]} @tab @code{FNM_PERIOD}
address@hidden multitable
+
+Ecco un esempio:
+
address@hidden
+@@load "fnmatch"
address@hidden
+flags = or(FNM["PERIOD"], FNM["NOESCAPE"])
+if (fnmatch("*.a", "pippo.c", flags) == FNM_NOMATCH)
+ print "nessuna corrispondenza"
address@hidden example
+
address@hidden Esempio di estensione Fork
address@hidden Un'interfaccia a @code{fork()}, @code{wait()}, e @code{waitpid()}
+
+L'estensione @code{fork} mette a disposizione tre funzioni, come segue:
+
address@hidden @code
address@hidden @@load "fork"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{fork()}, estensione
address@hidden estensione @code{fork()}
address@hidden pid = fork()
+Questa funzione crea un nuovo processo. Il valore restituito @`e zero nel
+processo ``figlio'' e il numero che identifica il nuovo processo
+(@dfn{pid}) nel processo ``padre'', o @minus{}1
+in caso di errore. In quest'ultimo caso, @code{ERRNO} indica il problema.
+Nel processo figlio, gli elementi @code{PROCINFO["pid"]} e
address@hidden"ppid"]} vengono aggiornati per riflettere i valori corretti.
+
address@hidden @code{waitpid()}, estensione
address@hidden estensione @code{waitpid()}
address@hidden ret = waitpid(pid)
+Questa funzione ha un unico argomento numerico, l'identificativo del processo
+di cui aspettare l'esito. Il valore di ritorno @`e quello restituito dalla
+chiamata di sistema @code{waitpid()}.
+
address@hidden @code{wait()}, estensione
address@hidden estensione @code{wait()}
address@hidden ret = wait()
+Questa funzione attende che il primo processo ``figlio'' termini.
+Il valore restituito @`e quello della chiamata di sistema @code{wait()}.
address@hidden table
+
+Non c'@`e una funzione corrispondente alla chiamata di sistema @code{exec()}.
+
+Ecco un esempio:
+
address@hidden
+@@load "fork"
address@hidden
+if ((pid = fork()) == 0)
+ print "salve dal processo figlio"
+else
+ print "salve dal processo padre"
address@hidden example
+
address@hidden Esempio di estensione Inplace
address@hidden Consentire la modifica in loco dei file
+
address@hidden @code{inplace}, estensione
address@hidden estensione @code{inplace}
+L'estensione @code{inplace} svolge un lavoro simile a quello
+dell'opzione @option{-i} nel programma di address@hidden GNU @command{sed},
+che svolge delle funzioni di modifica ``al volo'' su ogni file in input.
+Viene usato il file @file{inplace.awk}, caricato dinamicamente, per richiamare
+l'estensione in maniera corretta:
+
address@hidden
address@hidden file eg/lib/inplace.awk
address@hidden
+# inplace --- carica e richiama l'estensione inplace.
+
+@@load "inplace"
+
+# @`E buona cosa impostare INPLACE_SUFFIX in modo da fare
+# una copia di backup.
+# Per esempio, si potrebbe impostare INPLACE_SUFFIX a .bak
+# sulla riga di comando, o in una regola BEGIN.
+
+# Per default, ogni file specificato sulla riga di comando
+# address@hidden modificato sovrascrivendo il file originale.
+# Ma @`e possibile evitarlo specificando l'argomento inplace=0
+# davanti al nome del file che non si desidera elaborare in questo modo.
+# Si address@hidden poi abilitare di nuovo l'aggiornamento diretto del file
+# sulla riga di comando, specificando inplace=1 prima del file
+# che si vuole modificare direttamente.
+
+# N.B. La funzione inplace_end() @`e invocata nelle regole
+# BEGINFILE ed END, in modo che ogni eventuale azione
+# in una regola ENDFILE address@hidden ridiretta come previsto.
+
+BEGIN @{
+ inplace = 1 # abilitato per default
address@hidden
+
+BEGINFILE @{
+ if (_inplace_filename != "")
+ inplace_end(_inplace_filename, INPLACE_SUFFIX)
+ if (inplace)
+ inplace_begin(_inplace_filename = FILENAME, INPLACE_SUFFIX)
+ else
+ _inplace_filename = ""
address@hidden
+
+END @{
+ if (_inplace_filename != "")
+ inplace_end(_inplace_filename, INPLACE_SUFFIX)
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+Per ogni file elaborato, l'estensione ridirige lo
+standard output verso un file temporaneo definito in modo da avere lo stesso
+proprietario e le stesse autorizzazioni del file originale. Dopo che il file
address@hidden stato elaborato, l'estensione riporta lo standard output alla sua
+destinazione originale.
+Se @code{INPLACE_SUFFIX} non @`e una stringa vuota, il file originale @`e
+collegato a un @value{FN} di backup, creato aggiungendo il
+suffisso al nome originale.
+Infine, il file temporaneo @`e rinominato in modo da essere lo stesso del
address@hidden originario.
+
+Si noti che l'uso di questa address@hidden address@hidden essere controllato
+specificando @samp{inplace=0} sulla riga di comando, prima del nome del file
+che non dovrebbe essere elaborato come appena descritto. Si address@hidden
richiedere
+ancora l'aggiornamento diretto di un file, specificando l'argomento
address@hidden davanti al nome del file da elaborare in maniera diretta.
+
+La variabile @code{_inplace_filename} serve per tener traccia del nome del
+file corrente, in modo da non eseguire la funzione @code{inplace_end()} prima
+di aver elaborato il primo file.
+
+Se si verifica un errore, l'estensione emette un messaggio di errore fatale
+per terminare l'elaborazione immediatamente, senza danneggiare il
+file originale.
+
+Ecco alcuni semplici esempi:
+
address@hidden
+$ @kbd{gawk -i inplace '@{ gsub(/pippo/, "pluto") @}; @{ print @}' file1 file2
file3}
address@hidden example
+
+Per mantenere una copia di backup del file originale, si provi a fare
address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{gawk -i inplace -v INPLACE_SUFFIX=.bak '@{ gsub(/pippo/, "pluto") @}}
+> @address@hidden print @}' file1 file2 file3}
address@hidden example
+
+Si noti che, anche se l'estensione tenta di mantenere il proprietario e i
+permessi di accesso del file originario, non viene tentata la copia degli
+ulteriori permessi di accesso
+(@dfn{ACL - Access Control Lists}) del file originale.
+
+Se il programma termina prima del previsto, come potrebbe succedere se riceve
+dal sistema un segnale non gestito, address@hidden lasciare come residuo un
file
+temporaneo.
+
address@hidden Esempio di estensione Ord
address@hidden Caratteri e valori numerici: @code{ord()} e @code{chr()}
+
+L'estensione @code{ordchr} aggiunge due funzioni, di nome
address@hidden()} e @code{chr()}, come segue:
+
address@hidden @code
address@hidden @@load "ordchr"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{ord()}, estensione
address@hidden estensione @code{Ord}
address@hidden numero = ord(stringa)
+Restituisce il valore numerico del primo carattere in @code{stringa}.
+
address@hidden @code{Chr}, estensione
address@hidden estensione @code{Chr}
address@hidden char = chr(number)
+Restituisce una stringa il cui primo carattere @`e quello rappresentato
+da @code{number}.
address@hidden table
+
+Queste funzioni sono ispirate alle funzioni del linguaggio Pascal
+dallo stesso nome. Ecco un esempio:
+
address@hidden
+@@load "ordchr"
address@hidden
+printf("Il valore numerico di 'A' @`e %d\n", ord("A"))
+printf("Il valore come stringa di 65 @`e %s\n", chr(65))
address@hidden example
+
address@hidden Esempio di estensione Readdir
address@hidden Leggere directory
+
+L'estensione @code{readdir} aggiunge un analizzatore di input
+per esaminare directory.
+L'uso @`e il seguente:
+
address@hidden @code{readdir}, estensione
address@hidden estensione @code{readdir}
address@hidden
+@@load "readdir"
address@hidden example
+
+Quando quest'estensione @`e in uso, invece che saltare le
+directory presenti sulla riga di comando, (o accedute tramite @code{getline}),
+queste sono lette, e ogni elemento della directory @`e restituito come
+un record.
+
+Il record consiste di tre campi. I primi due sono il numero di @dfn{inode} e
+il @value{FN}, separati fra loro da una barra.
+Nei sistemi in cui l'elemento di directory contiene il tipo del file,
+il record ha un terzo campo (pure separato da una barra), composto da una
+sola lettera, che indica il tipo del file. Le lettere e i tipi di file a cui
+corrispondono sono mostrate in @ref{table-readdir-file-types}.
+
address@hidden Tabella,table-readdir-file-types
address@hidden file restituiti dall'estensione @code{readdir}}
address@hidden @columnfractions .1 .9
address@hidden Lettera @tab Tipo di file
address@hidden @code{b} @tab Dispositivo a blocchi
address@hidden @code{c} @tab Dispositivo a caratteri
address@hidden @code{d} @tab Directory
address@hidden @code{f} @tab File normale
address@hidden @code{l} @tab Collegamento simbolico
address@hidden @code{p} @tab @dfn{pipe} con nome (FIFO)
address@hidden @code{s} @tab @dfn{socket}
address@hidden @code{u} @tab Tutto il resto (sconosciuto)
address@hidden multitable
address@hidden float
+
+Nei sistemi che non contengono l'informazione sul tipo del file, il terzo
+campo @`e sempre @samp{u}.
+
address@hidden NOTA
+Nei sistemi GNU/Linux, ci sono fileystem che non supportano il campo
address@hidden (si veda la pagina di manuale @i{readdir}(3)), e in questo caso
+il tipo di file @`e sempre @samp{u}. Si address@hidden usare l'estensione
address@hidden per chiamare @code{stat()} e ottenere l'informazione
+corretta sul tipo di file.
address@hidden quotation
+
+Ecco un esempio:
+
address@hidden
+@@load "readdir"
address@hidden
+BEGIN @{ FS = "/" @}
address@hidden print "@value{FN} @`e", $2 @}
address@hidden example
+
address@hidden Esempio di estensione Revout
address@hidden Invertire la stringa in output
+
+L'estensione @code{revoutput} aggiunge un semplice processore
+di output che inverte i caratteri di ogni riga in output. Serve a dimostrare
+come @`e possibile scrivere un processore di output, anche se address@hidden
essere
+a prima vista vagamente divertente.
+Ecco un esempio:
+
address@hidden @code{revoutput}, estensione
address@hidden estensione @code{revoutput}
address@hidden
+@@load "revoutput"
+
+BEGIN @{
+ REVOUT = 1
+ print "non v'allarmate" > "/dev/stdout"
address@hidden
address@hidden example
+
+L'output di questo programma @`e @samp{etamralla'v non}.
+
address@hidden Esempio di estensione Rev2way
address@hidden Esempio di I/O bidirezionale
+
+L'estensione @code{revtwoway} aggiunge un semplice processore
+bidirezionale che inverte i caratteri di ogni riga che riceve, per farla
+poi rileggere dal programma @command{awk}. Il motivo per cui @`e stata scritta
address@hidden quello di mostrare come si scrive un processore bidirezionale,
anche se address@hidden
+sembrare un programma vagamente divertente.
+Il seguente esempio mostra come usarlo:
+
address@hidden @code{revtwoway}, estensione
address@hidden estensione @code{revtwoway}
address@hidden
+@@load "revtwoway"
+
+BEGIN @{
+ cmd = "/specchio/magico"
+ print "non v'allarmate" |& cmd
+ cmd |& getline risultato
+ print risultato
+ close(cmd)
address@hidden
address@hidden example
+
+L'output di questo programma
address@hidden
+anche in questo caso @`e:
address@hidden ifnotinfo
address@hidden
address@hidden:
address@hidden ifinfo
address@hidden'v non}.
+
address@hidden Esempio di estensione Rwarray
address@hidden Scaricare e ricaricare un vettore
+
+L'estensione @code{rwarray} aggiunge due funzioni,
+di nome @code{writea()} e @code{reada()}, come segue:
+
address@hidden @code
address@hidden @@load "rwarray"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{writea()}, estensione
address@hidden estensione @code{writea()}
address@hidden ret = writea(file, vettore)
+Questa funzione ha come argomento una stringa, che @`e il nome del file
+sul quale scaricare il vettore, e il vettore stesso @`e il secondo argomento.
address@hidden()} @`e in grado di gestire vettori di vettori. Restituisce il
+valore uno se completa il lavoro o zero se non va a buon fine.
+
address@hidden @code{reada()}, estensione
address@hidden estensione @code{reada()}
address@hidden ret = reada(file, vettore)
address@hidden()} @`e la funzione inversa di @code{writea()};
+legge il file il cui nome @`e fornito come primo argomento, riempiendo 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.
address@hidden table
+
+Il vettore creato da @code{reada()} @`e identico a quello scritto da
address@hidden()} nel senso che i contenuti sono gli stessi. Tuttavia,
+per come @`e strutturata la funzione, l'ordine di attraversamento del vettore
+ricreato @`e quasi certamente differente da quello del vettore originale.
+Poich@'e l'ordine di attraversamento di un vettore @`e, per default, indefinito
+in @command{awk}, questo non @`e (tecnicamente) un problema. Se serve che
+l'attraversamento del vettore avvenga in un ordine preciso, si possono usare
+le address@hidden di ordinamento di un vettore disponibili in @command{gawk}
+(@pxref{Ordinamento di vettori}).
+
+Il file contiene dati in formato binario. Tutti i valori interi sono scritti
+in @dfn{network byte address@hidden@`e, nella maniera con cui sarebbero
+normalmente scritti in un testo, con le cifre address@hidden significative del
+numero contenute nella parte sinistra, e quelle meno significative
+nella parte destra della rappresentazione binaria del numero.}.
+Tuttavia, i valori in virgola mobile a doppia precisione sono scritti come
+dati binari nativi. Quindi, vettori che contengono solo dati in formato
+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.
+
+Ecco un esempio:
+
address@hidden
+@@load "rwarray"
address@hidden
+ret = writea("scaricato.bin", vettore)
address@hidden
+ret = reada("scaricato.bin", vettore)
address@hidden example
+
address@hidden Esempio di estensione Readfile
address@hidden Leggere un intero file in una stringa
+
+L'estensione @code{readfile} aggiunge una sola funzione
+di nome @code{readfile()}, e un analizzatore di input:
+
address@hidden @code
address@hidden @@load "readfile"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{readfile()}, estensione
address@hidden estensione @code{readfile()}
address@hidden risultato = readfile("/qualche/persorso")
+L'argomento @`e il nome del file da leggere. Il valore restituito @`e una
+stringa contenente l'intero contenuto del file richiesto. In caso di errore,
+la funzione restituisce la stringa vuota e imposta @code{ERRNO}.
+
address@hidden BEGIN @{ PROCINFO["readfile"] = 1 @}
+Inoltre, l'estensione aggiunge un analizzatore di input che @`e attivato se
+l'elemento @code{PROCINFO["readfile"]} esiste.
+Quando l'analizzatore @`e attivato, ogni file in input @`e restituito
interamente
+come @code{$0}.
+La variabile @code{RT} @`e impostata alla stringa nulla.
address@hidden table
+
+Ecco un esempio:
+
address@hidden
+@@load "readfile"
address@hidden
+contents = readfile("/percorso/del/file");
+if (contents == "" && ERRNO != "") @{
+ print("problema in lettura file", ERRNO) > "/dev/stderr"
+ ...
address@hidden
address@hidden example
+
address@hidden Esempio di estensione Time
address@hidden Funzioni dell'estensione time
+
+L'estensione @code{time} aggiunge due funzioni, di nome
address@hidden()} e @code{sleep()}, come segue:
+
address@hidden @code
address@hidden @@load "time"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{gettimeofday()}, estensione
address@hidden estensione @code{gettimeofday()}
address@hidden ora_corrente = gettimeofday()
+Restituisce il numero di secondi trascorsi dalle ore 00:00 del giorno
+01/01/1970 UTC come valore a virgola mobile.
+Se questa informazione non @`e disponibile nella piattaforma in uso,
+restituisce @minus{}1 e imposta @code{ERRNO}. Il valore fornito dovrebbe
+avere la precisione di una frazione di
+secondo, ma la precisione effettiva address@hidden variare a seconda della
+piattaforma.
+Se la chiamata di sistema standard C @code{gettimeofday()} @`e disponibile
+nella piattaforma in uso, questo @`e il valore restituito. In caso contrario,
+se si sta lavorando con MS-Windows, la chiamata di sistema @`e fatta a
address@hidden()}.
+
address@hidden @code{sleep()}, estensione
address@hidden estensione @code{sleep()}
address@hidden risultato = sleep(@var{secondi})
+Il programma @command{gawk} resta inattivo (dorme) per i @var{secondi}
+specificati. Se @var{secondi} ha un valore negativo,
+o la chiamata di sistema non riesce, restituisce @minus{}1 e imposta
@code{ERRNO}.
+In caso contrario, restituisce zero dopo aver lasciato trascorrere
+la address@hidden di tempo indicata.
+Si noti che @var{secondi} address@hidden essere un numero a virgola mobile
(non solo un
+numero intero).
+Dettagli di implementazione: a seconda della address@hidden nel sistema in uso,
+questa funzione tenta di usare @code{nanosleep()} o @code{select()} per
+ottenere il tempo di attesa richiesto.
address@hidden table
+
address@hidden Esempio di estensione API Test
address@hidden Test per la API
address@hidden @code{testext}, estensione
address@hidden estensione @code{testext}
+
+L'estensione @code{testext} controlla la address@hidden di
+parti dell'API delle estensioni che non sono utilizzate negli altri esempi.
+Il file @file{extension/testext.c}
+contiene sia il codice C per l'estensione che il codice @command{awk}
+(tra i commenti del codice C) per eseguire i test. L'ambiente di test
+estrae il codice sorgente @command{awk} ed esegue i test. Si veda il file
+sorgente per maggiori informazioni.
+
address@hidden gawkextlib
address@hidden Il progetto @code{gawkextlib}
address@hidden @code{gawkextlib}, estensioni
address@hidden estensioni, @code{gawkextlib}
address@hidden estensioni, dove trovarle
+
address@hidden @code{gawkextlib}, progetto
address@hidden progetto @code{gawkextlib}
+Il progetto @uref{http://sourceforge.net/projects/gawkextlib/,
@code{gawkextlib}}
+fornisce varie estensioni per @command{gawk}, compresa una per
+l'elaborazione dei file XML. Questa @`e un'evoluzione del progetto noto come
address@hidden (XML @command{gawk}).
+
+Al momento della stesura di questo testo, ci sono otto estensioni:
+
address@hidden @value{BULLET}
address@hidden
+Estensione @code{errno}
+
address@hidden
+Estensione GD graphics library
+
address@hidden
+Estensione libreria MPFR
+(fornisce l'accesso a varie funzioni MPFR non previste dal supporto nativo
+di MPFR disponibile in @command{gawk})
+
address@hidden
+Estensione PDF
+
address@hidden
+Estensione PostgreSQL
+
address@hidden
+Estensione Redis
+
address@hidden
+Estensione Select
+
address@hidden
+Estensione analizzatore XML, usando la libreria di analisi XML
address@hidden://expat.sourceforge.net, Expat}
address@hidden itemize
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
+Si address@hidden scaricare il codice del progetto @code{gawkextlib}
+usando il codice sorgente mantenuto tramite
address@hidden://git-scm.com, Git}.
+Il comando per farlo @`e il seguente:
+
address@hidden
+git clone git://git.code.sf.net/p/gawkextlib/code gawkextlib-code
address@hidden example
+
address@hidden Expat, libreria per analizzare XML
address@hidden XML, Expat, libreria per analizzare
+Per poter compilare e usare l'estensione XML, @`e necessario installare
+la libreria di analisi XML @uref{http://expat.sourceforge.net, Expat}.
+
+Inoltre, @`e necessario installare gli strumenti GNU Autotools
+(@uref{http://www.gnu.org/software/autoconf, Autoconf},
address@hidden://www.gnu.org/software/automake, Automake},
address@hidden://www.gnu.org/software/libtool, Libtool}
+e
address@hidden://www.gnu.org/software/gettext, GNU @command{gettext}}).
+
+La semplice procedura per compilare e testare @code{gawkextlib} @`e la
seguente.
+Dapprima, occorre compilare e installare @command{gawk}:
+
address@hidden
+cd .../percorso/del/sorgente/gawk
+./configure --prefix=/tmp/newgawk @ii{Installa in /tmp/newgawk per ora}
+make && make check @ii{Compila e controlla che tutto sia a
posto}
+make install @ii{Installa gawk}
address@hidden example
+
+Poi, dal sito @url{http://sourceforge.net/projects/gawkextlib/files} si deve
+scaricare @code{gawkextlib} e le estensioni che si vogliono installare.
+Il file @file{README} del sito spiega come compilare il codice. Se si @`e
+installato @command{gawk} in una posizione non-standard, occorre
+specificare @code{./configure address@hidden/percorso/del/programma/gawk}}
+per far address@hidden@dotless{i}} che venga trovato.
address@hidden essere necessario usare il programma di address@hidden
@command{sudo}
+per installare sia @command{gawk} che @code{gawkextlib}, a seconda di come
+funziona il sistema su cui si lavora.
+
+Chi scrive un'estensione e desidera condividerla con altri utenti
address@hidden, address@hidden prendere in considerazione l'idea di farlo
attraverso
+il progetto @code{gawkextlib}.
+Si veda il sito web del progetto per maggiori informazioni.
+
address@hidden Sommario delle estensioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Si possono scrivere estensioni (dette anche @dfn{plug-in})
+per @command{gawk}
+nel linguaggio C o C++ usando l'interfaccia di programmazione applicativa
+(API) definita dagli sviluppatori di
address@hidden
+
address@hidden
+Le estensioni devono avere una licenza compatibile con la
+GNU General Public License (GPL), e devono dichiararlo definendo un'apposita
+variabile di nome
address@hidden
+
address@hidden
+La comunicazione tra @command{gawk} e un'estensione @`e bidirezionale.
address@hidden passa all'estensione una struttura (@code{struct}) che contiene
+vari campi di dati e puntatori a funzione. L'estensione address@hidden poi
chiamare
+funzioni all'interno di @command{gawk} tramite dei puntatori a funzioni
+per svolgere alcuni compiti.
+
address@hidden
+Uno di questi compiti @`e di ``registrare'' il nome e l'implementazione di
+nuove funzioni a livello di @command{awk} con @command{gawk}.
+L'implementazione ha la forma di un puntatore del linguaggio C,
+cui @`e associato un dato livello di versione.
+Per convenzione, le funzioni di implementazione hanno nome
address@hidden@var{XXXX}()} per una funzione a livello di @command{awk} di nome
address@hidden@var{XXXX}()}.
+
address@hidden
+L'API @`e definita in un file di intestazione di nome @file{gawkapi.h}.
+Occorre includere alcuni file di intestazione standard @emph{prima} di
+includere tale intestazione nel codice sorgente.
+
address@hidden
+Vengono forniti dei puntatori a funzioni dell'API per i seguenti tipi di
+operazioni:
+
address@hidden @value{BULLET}
address@hidden
+Allocare, riallocare, e liberare memoria
+
address@hidden
+Registrare funzioni (si possono registrare
+funzioni di estensione,
+funzioni ausiliarie di pulizia (@dfn{callbacks}),
+una stringa di versione,
+degli analizzatori di input,
+dei processori di output,
+e dei processori bidirezionali)
+
address@hidden
+Stampare messaggi fatali, non fatali, di avvertimento, e avvertimenti ``lint''
+
address@hidden
+Aggiornare @code{ERRNO} o annullarlo
+
address@hidden
+Accedere a parametri, come pure convertire un parametro di tipo non definito
+in un vettore
+
address@hidden
+Accedere alla tabella dei simboli (ricuperare il valore di una
+variabile globale, crearne una nuova o modificarne una esistente)
+
address@hidden
+Creare e rilasciare valori nascosti; questo consente di usare in modo
+efficiente lo stesso valore per address@hidden variabili e address@hidden
migliorare di molto le
+prestazioni del programma
+
address@hidden
+Manipolare vettori
+(ricuperare, aggiungere, cancellare e modificare elementi;
+ottenere il numero di elementi in un vettore;
+creare un nuovo vettore;
+svuotare un vettore;
+e
+appiattire un vettore per poterlo percorrere facilmente con un ciclo in
+stile C, visitando tutti i suoi indici ed elementi)
address@hidden itemize
+
address@hidden
+L'API definisce diversi tipi di dati standard per rappresentare
+valori di variabili, elementi di vettore e vettori presenti in @command{awk}.
+
address@hidden
+L'API fornisce funzioni di servizio per definire dei valori.
+Sono anche disponibili funzioni di gestione della memoria, per assicurare
+la address@hidden fra memoria allocata da @command{gawk} e memoria allocata da
+un'estensione.
+
address@hidden
address@hidden la memoria passata da @command{gawk} a un'estensione dev'essere
+considerata come in sola lettura dall'estensione.
+
address@hidden
address@hidden la memoria passata da un'estensione a @command{gawk} deve
+essere ottenuta dalle funzioni di allocazione della memoria previste
+dall'API. @command{gawk} @`e responsabile per la gestione di quella memoria e
+la libera quando @`e il momento per farlo.
+
address@hidden
+L'API fornisce informazioni sulla versione di @command{gawk} in
+esecuzione, in modo che un'estensione possa verificare la propria
address@hidden
+con la versione di @command{gawk} da cui @`e stata caricata.
+
address@hidden
address@hidden address@hidden facile iniziare a programmare una nuova
estensione usando il
+codice predefinito descritto in questo @value{CHAPTER}. Alcune macro nel
+file di intestazione @file{gawkapi.h} rendono la cosa address@hidden agevole.
+
address@hidden
+La distribuzione di @command{gawk} comprende un numero di piccoli ma utili
+esempi di estensione. Il progetto @code{gawkextlib} include diverse altre
+estensioni, di maggiori dimensioni.
+Per chi desideri scrivere un'estensione e metterla a disposizione della
address@hidden degli utenti di @command{gawk}, il progetto @code{gawkextlib}
address@hidden il posto adatto per farlo.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi sulle estensioni
address@hidden Esercizi
+
address@hidden
address@hidden
+Aggiungere funzioni per rendere disponibili chiamate di sistema come
address@hidden()}, @code{chmod()} e @code{umask()} nelle estensioni che
+operano con i file viste
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden interne file}.
+
address@hidden Idea from comp.lang.awk, February 2015
address@hidden
+Scrivere un analizzatore di input che stampi un prompt se l'input proviene
+da un dispositivo che sia un ``terminale''. Si address@hidden usare la
funzione
address@hidden()} per sapere se il file in input @`e un terminale.
+(Suggerimento: questa funzione
+normalmente usa parecchie risorse quando @`e richiamata; si tenti di chiamarla
+una volta sola.)
+Il contenuto del prompt dovrebbe provenire da una variabile che sia possibile
+impostare a livello di codice @command{awk}.
+Si address@hidden inviare il prompt allo standard error. Tuttavia,
+per ottenere risultati migliori, @`e meglio aprire un nuovo descrittore di file
+(o puntatore a un file)
+sul file @file{/dev/tty} e stampare il prompt su quel file, nel caso
+in cui lo standard error sia stato ridiretto.
+
+Perch@'e lo standard error @`e una scelta migliore dello
+standard output per scrivere il prompt?
+Quale meccanismo di lettura andrebbe sostituito, quello che legge un record
+o quello che legge dei semplici byte?
+
address@hidden
+(Difficile.)
+Come si potrebbero gestire degli insiemi di nomi (@dfn{namespaces})
+in @command{gawk}, in modo
+che i nomi di funzione presenti in estensioni differenti non siano in conflitto
+tra loro?
+Chi riesce a trovare uno schema di buona address@hidden @`e pregato di
contattare il
+manutentore di @command{gawk}, per metterlo al corrente.
+
address@hidden
+Si scriva uno script di shell che funga da interfaccia per
+l'estensione ``inplace'', vista
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di estensione Inplace},
+in modo che il comportamento sia simile a quello del comando @samp{sed -i}.
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden
address@hidden @value{PART4}Appendici
address@hidden ifnotinfo
+
address@hidden
+
address@hidden FOR_PRINT
+La Parte IV contiene le appendici (come pure le due licenze che proteggono
+il codice sorgente di @command{gawk} e questo @value{DOCUMENT},
+rispettivamente) e inoltre il Glossario:
address@hidden ifclear
+
address@hidden FOR_PRINT
+La Parte IV contiene tre appendici, l'ultima delle quali @`e la licenza
+che protegge il codice sorgente di @command{gawk}:
address@hidden ifset
+
address@hidden @value{BULLET}
address@hidden
address@hidden del linguaggio}
+
address@hidden
address@hidden
+
address@hidden FOR_PRINT
address@hidden
address@hidden
+
address@hidden
address@hidden fondamentali}
+
address@hidden
address@hidden
address@hidden ifclear
+
address@hidden
address@hidden
+
address@hidden FOR_PRINT
address@hidden
address@hidden per Documentazione Libera GNU (FDL)}
address@hidden ifclear
address@hidden itemize
address@hidden ifdocbook
+
address@hidden Storia del linguaggio
address@hidden L'evoluzione del linguaggio @command{awk}
+
+Questo @value{DOCUMENT} descrive l'implementazione GNU di @command{awk}
+conforme alle specifiche POSIX. Molti degli utenti di lunga data di
address@hidden hanno imparato a programmare in @command{awk} usando
+l'implementazione originale di @command{awk} presente nella versione 7 di
+Unix. (Questa versione @`e servita da base per la versione Berkeley Unix di
address@hidden, attraverso la versione 4.3BSD-Reno. Successive versioni di
+Berkeley Unix e, per un certo periodo, alcuni sistemi derivati da
+4.4BSD-Lite, hanno usato varie versioni di @command{gawk} come loro
address@hidden) Questo @value{CHAPTER} descrive in breve l'evoluzione
+del linguaggio @command{awk}, facendo riferimento ad altre parti del
address@hidden dove si possono trovare ulteriori informazioni.
+
address@hidden FOR_PRINT
+Per amor di address@hidden, sono state omesse in questa edizione informazioni
+sulla storia delle address@hidden di @command{gawk}. Si possono trovare nella
address@hidden://www.gnu.org/software/gawk/manual/html_node/Feature-History.html,
+documentazione online}.
address@hidden ifset
+
address@hidden
+* V7/SVR3.1:: Le principali differenze tra V7 e System V
+ Release 3.1.
+* SVR4:: Differenze minori tra System V
+ Release 3.1 e 4.
+* POSIX:: Nuove address@hidden per lo standard POSIX.
+* BTL:: Nuove address@hidden dalla versione
+ di @command{awk} di Brian Kernighan.
+* POSIX/GNU:: Le estensioni in @command{gawk} non
+ previste in @command{awk} POSIX.
+* Storia delle address@hidden:: La storia delle address@hidden di
+ @command{gawk}.
+* Estensioni comuni:: Sommario Estensioni comuni.
+* Intervalli e localizzazione:: Come le localizzazioni influiscono sugli
+ intervalli delle espressioni regolari.
+* Contributori:: I maggiori contributori a @command{gawk}.
+* Sommario della storia:: Sommario della storia.
address@hidden menu
+
address@hidden V7/SVR3.1
address@hidden Differenze importanti tra V7 e System V Release 3.1
address@hidden @command{awk}, versioni di
address@hidden @command{awk}, versioni di, differenze tra V7 e SVR3.1
+
+Il liguaggio @command{awk} si @`e evoluto considerevolmente tra Unix versione
+7 (1978) e la nuova implementazione disponibile a partire da Unix System V
+Release 3.1 (1987). Questa @value{SECTION} riassume le differenze e indica
+dove @`e possibile trovare ulteriori dettagli:
+
address@hidden @value{BULLET}
address@hidden
+La address@hidden di inserire @samp{;} per separare address@hidden regole su
una riga
+(@pxref{Istruzioni/Righe})
+
address@hidden
+Funzioni definite dall'utente e istruzione @code{return}
+(@pxref{Funzioni definite dall'utente})
+
address@hidden
+L'istruzione @code{delete} (@pxref{Cancellazione})
+
address@hidden
+L'istruzione @address@hidden
+(@pxref{Istruzione do})
+
address@hidden
+Le funzioni predefinite @code{atan2()}, @code{cos()}, @code{sin()},
@code{rand()} e
address@hidden()} (@pxref{Funzioni numeriche})
+
address@hidden
+Le funzioni predefinite @code{gsub()}, @code{sub()} e @code{match()}
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Le funzioni predefinite @code{close()} e @code{system()}
+(@pxref{Funzioni di I/O})
+
address@hidden
+Le variabili predefinite @code{ARGC}, @code{ARGV}, @code{FNR}, @code{RLENGTH},
address@hidden e @code{SUBSEP} (@pxref{Variabili predefinite})
+
address@hidden
address@hidden di modificare @code{$0} (@pxref{Cambiare i campi})
+
address@hidden
+L'espressione condizionale che fa uso dell'operatore ternario @samp{?:}
+(@pxref{Espressioni condizionali})
+
address@hidden
+L'espressione @address@hidden in @var{vettore}} esterna alle istruzioni
address@hidden (@pxref{Visitare elementi})
+
address@hidden
+L'operatore esponenziale @samp{^}
+(@pxref{Operatori aritmetici}) e il relativo operatore di assegnamento
address@hidden (@pxref{Operatori di assegnamento})
+
address@hidden
+Precedenze tra operatori compatibili con quelle del linguaggio C, che
+rendono non funzionanti alcuni vecchi programmi @command{awk}
(@pxref{Precedenza})
+
address@hidden
+La address@hidden di usare @dfn{regexp} come valori di @code{FS}
+(@pxref{Separatori di campo}) e come
+terzo argomento per la funzione @code{split()}
+(@pxref{Funzioni per stringhe}), invece di usare solo il primo carattere
+di @code{FS}
+
address@hidden
address@hidden dinamiche come operandi degli operatori @samp{~} e @samp{!~}
+(@pxref{Espressioni regolari calcolate})
+
address@hidden
+Le sequenze di protezione @samp{\b}, @samp{\f} e @samp{\r}
+(@pxref{Sequenze di protezione})
+
address@hidden
+La ridirezione dell'input per la funzione @code{getline}
+(@pxref{Getline})
+
address@hidden
+La address@hidden di avere address@hidden regole @code{BEGIN} ed @code{END}
+(@pxref{BEGIN/END})
+
address@hidden
+Vettori multidimensionali
+(@pxref{Vettori multidimensionali})
address@hidden itemize
+
address@hidden SVR4
address@hidden Differenze tra le versioni System V Release 3.1 e SVR4
+
address@hidden @command{awk}, versioni di, differenze tra SVR3.1 e SVR4
+La versione per Unix System V Release 4 (1989) di @command{awk} ha aggiunto
+queste address@hidden (alcune delle quali introdotte da @command{gawk}):
+
address@hidden @value{BULLET}
address@hidden
+Il vettore @code{ENVIRON} (@pxref{Variabili predefinite})
address@hidden gawk and MKS awk
+
address@hidden
+La address@hidden di specificare address@hidden opzioni @option{-f} sulla riga
di comando
+(@pxref{Opzioni})
address@hidden MKS awk
address@hidden Mortice Kern Systems, ditta produttrice di una versione
commerciale di awk
+
address@hidden
+L'opzione @option{-v} per assegnare variabili prima di iniziare
+l'esecuzione del programma
+(@pxref{Opzioni})
address@hidden GNU, Bell Laboratories & MKS together
+
address@hidden
+La notazione @option{--} per indicare la fine delle opzioni sulla riga di
+comando
+
address@hidden
+Le sequenze di protezione @samp{\a}, @samp{\v} e @samp{\x}
+(@pxref{Sequenze di protezione})
address@hidden GNU, for ANSI C compat
+
address@hidden
+Un valore di ritorno definito per la funzione predefinita @code{srand()}
+(@pxref{Funzioni numeriche})
+
address@hidden
+Le funzioni predefinite per stringhe @code{toupper()} e @code{tolower()}
+per la conversione maiuscolo/minuscolo
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Una specificazione address@hidden accurata per la lettera @samp{%c} di
controllo del
+formato nella funzione @code{printf}
+(@pxref{Lettere di controllo})
+
address@hidden
+La address@hidden di decidere dinamicamente la larghezza di un campo e la
+precisione da usare (@code{"%*.*d"}) nella lista degli argomenti passati a
address@hidden e @code{sprintf()}
+(@pxref{Lettere di controllo})
+
address@hidden
+L'uso di costanti @dfn{regexp}, p.es. @code{/pippo/}, come espressioni,
+che equivalgono a usare l'operatore di ricerca di una
+corrispondenza, p.es. @samp{$0 ~ /pippo/}
+(@pxref{Usare le costanti @dfn{regexp}})
+
address@hidden
+Gestione di sequenze di protezione nell'assegnamento di variabili
+effettuato tramite la riga di comando
+(@pxref{Opzioni di assegnamento})
address@hidden itemize
+
address@hidden POSIX
address@hidden Differenze tra versione SVR4 e POSIX di @command{awk}
address@hidden @command{awk}, versioni di, differenze tra SVR4 e POSIX
@command{awk}
address@hidden POSIX @command{awk}, differenze tra versioni @command{awk}
+
+Lo standard POSIX Command Language and Utilities per @command{awk} (1992)
+ha introdotto le seguenti modifiche al linguaggio:
+
address@hidden @value{BULLET}
address@hidden
+L'uso dell'opzione @option{-W} per opzioni specifiche a una data
+implementazione
+(@pxref{Opzioni})
+
address@hidden
+L'uso di @code{CONVFMT} per controllare la conversione di numeri
+in stringhe (@pxref{Conversione})
+
address@hidden
+Il concetto di stringa numerica e regole di confronto address@hidden precise
da seguire
+al riguardo (@pxref{Tipi di variabile e confronti})
+
address@hidden
+L'uso di variabili predefinite come nomi di parametri delle funzioni @`e
vietato
+(@pxref{Sintassi delle definizioni})
+
address@hidden
+Una documentazione address@hidden completa di molte tra le address@hidden del
linguaggio
+precedentemente non documentate
address@hidden itemize
+
+Nel 2012, un certo numero di estensioni che erano address@hidden comunemente
+disponibili da parecchi anni sono state finalmente aggiunte allo standard
+POSIX. Ecco l'elenco:
+
address@hidden @value{BULLET}
address@hidden
+La funzione predefinita @code{fflush()} per forzare la scrittura dei buffer
+in output
+(@pxref{Funzioni di I/O})
+
address@hidden
+L'istruzione @code{nextfile}
+(@pxref{Istruzione nextfile})
+
address@hidden
+La address@hidden di eliminare completamente un vettore con l'istruzione
address@hidden @var{vettore}}
+(@pxref{Cancellazione})
+
address@hidden itemize
+
address@hidden comuni} per una lista delle estensioni comuni
+non previste nello standard POSIX.
+
+Lo standard POSIX 2008 @`e reperibile online a:
address@hidden://www.opengroup.org/onlinepubs/9699919799/}.
+
+
address@hidden BTL
address@hidden Estensioni nell'@command{awk} di Brian Kernighan
+
address@hidden @command{awk}, versioni di, si veda anche Brian Kernighan,
@command{awk} di
address@hidden estensioni, Brian Kernighan @command{awk}
address@hidden Brian Kernighan, @command{awk} di, estensioni
address@hidden Kernighan, Brian
+Brian Kernighan
+ha reso disponibile la sua versione nel suo sito.
+(@pxref{Altre versioni}).
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive estensioni comuni disponibili per la
+prima volta nella sua versione di @command{awk}:
+
address@hidden @value{BULLET}
address@hidden
+Gli operatori @samp{**} e @samp{**=}
+(@pxref{Operatori aritmetici}
+e
address@hidden di assegnamento})
+
address@hidden
+L'uso di @code{func} come abbreviazione di @code{function}
+(@pxref{Sintassi delle definizioni})
+
address@hidden
+La funzione predefinita @code{fflush()} per forzare la scrittura dei buffer
+in output
+(@pxref{Funzioni di I/O})
+
address@hidden
address@hidden
+The @code{SYMTAB} array, that allows access to @command{awk}'s internal symbol
+table. This feature was never documented for his @command{awk}, largely because
+it is somewhat shakily implemented. For instance, you cannot access arrays
+or array elements through it
address@hidden ignore
address@hidden itemize
+
address@hidden comuni} per una lista completa delle estensioni
+disponibile nel suo @command{awk}.
+
address@hidden POSIX/GNU
address@hidden Estensioni di @command{gawk} non in POSIX @command{awk}
+
address@hidden address@hidden compatibile di (@command{gawk}), estensioni nella
address@hidden estensioni nella address@hidden compatibile di (@command{gawk})
address@hidden estensioni, in @command{gawk}, non in POSIX @command{awk}
address@hidden POSIX, estensioni @command{gawk} non incluse in
+L'implementazione GNU di @command{gawk} aggiunge molte address@hidden
+Queste possono essere disabilitate completamente sia con l'opzione
address@hidden che con l'opzione
address@hidden
+(@pxref{Opzioni}).
+
+Alcune address@hidden sono state introdotte e successivamente tolte
+con il passare del tempo.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden
+sintetizza le ulteriori address@hidden rispetto a POSIX @command{awk} che sono
+presenti nella versione corrente di @command{gawk}.
+
address@hidden @value{BULLET}
+
address@hidden
+Ulteriori variabili predefinite:
+
address@hidden @value{MINUS}
address@hidden
+Le variabili
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+(@pxref{Variabili predefinite})
address@hidden itemize
+
address@hidden
+File speciali verso cui ridirigere l'I/O:
+
address@hidden @value{MINUS}
address@hidden
+I file @file{/dev/stdin}, @file{/dev/stdout}, @file{/dev/stderr} e i
address@hidden speciali @file{/dev/fd/@var{N}}
+(@pxref{File speciali})
+
address@hidden
+I file speciali @file{/inet}, @file{/inet4} e @file{/inet6} per
+interagire con la rete TCP/IP usando @samp{|&} per specificare quale
+versione usare del protocollo IP
+(@pxref{Reti TCP/IP})
address@hidden itemize
+
address@hidden
+Differenze e/o aggiunte al linguaggio:
+
address@hidden @value{MINUS}
address@hidden
+La sequenza di protezione @samp{\x}
+(@pxref{Sequenze di protezione})
+
address@hidden
+Supporto completo per @dfn{regexp} sia POSIX che GNU
address@hidden
+(@pxrefil{Espressioni regolari})
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari})
address@hidden ifnottex
+
address@hidden
+La address@hidden che @code{FS} e il terzo
+argomento di @code{split()} siano la stringa nulla
+(@pxref{Campi di un solo carattere})
+
address@hidden
+La address@hidden che @code{RS} sia una @dfn{regexp}
+(@pxref{Record})
+
address@hidden
+La address@hidden di usare costanti ottali ed esadecimali nei programmi
+scritti in @command{awk}
+(@pxref{Numeri non-decimali})
+
address@hidden
+L'operatore @samp{|&} per poter effettuare I/O bidirezionale verso un
+coprocesso
+(@pxref{I/O bidirezionale})
+
address@hidden
+Chiamate indirette di funzione
+(@pxref{Chiamate indirette})
+
address@hidden
+La address@hidden di ignorare directory specificate sulla riga di comando,
+emettendo un messaggio di avvertimento
+(@pxref{Directory su riga di comando})
+
address@hidden
+Errori in output usando @code{print} e @code{printf} non provocano
+necessariamente la fine del programma
+(@pxref{Continuazione dopo errori})
address@hidden itemize
+
address@hidden
+Nuove parole chiave:
+
address@hidden @value{MINUS}
address@hidden
+I criteri di ricerca speciali @code{BEGINFILE} ed @code{ENDFILE}
+(@pxref{BEGINFILE/ENDFILE})
+
address@hidden
+L'istruzione @code{switch}
+(@pxref{Istruzione switch})
address@hidden itemize
+
address@hidden
+Differenze in funzioni standard di @command{awk}:
+
address@hidden @value{MINUS}
address@hidden
+Il secondo argomento opzionale di @code{close()} che consente di chiudere
+un solo lato dell'I/O di una @dfn{pipe} bidirezionale aperta verso un
+coprocesso (@pxref{I/O bidirezionale})
+
address@hidden
+Aderenza allo standard POSIX per le funzioni @code{gsub()} e @code{sub()}
+se @`e stata specificata l'opzione @option{--posix}
+
address@hidden
+La funzione @code{length()} accetta come argomento il nome di un vettore
+e restituisce il numero di elementi nel vettore
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Il terzo argomento opzionale della funzione @code{match()}
+per contenere eventuali sottoespressioni individuate all'interno di una
address@hidden
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Specificatori posizionali nei formati di @code{printf} per facilitare
+le traduzioni di messaggi
+(@pxref{Ordinamento di printf})
+
address@hidden
+L'aggiunta di un quarto argomento opzionale alla funzione @code{split()},
+per designare un vettore che contenga il testo dei separatori di campo
+(@pxref{Funzioni per stringhe})
address@hidden itemize
+
address@hidden
+Ulteriori funzioni presenti solo in @command{gawk}:
+
address@hidden @value{MINUS}
address@hidden
+Le funzioni @code{gensub()}, @code{patsplit()} e @code{strtonum()}
+per una gestione di testi address@hidden potente
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Le funzioni @code{asort()} e @code{asorti()} per l'ordinamento di vettori
+(@pxref{Ordinamento di vettori})
+
address@hidden
+Le funzioni @code{mktime()}, @code{systime()} e @code{strftime()}
+per lavorare con date e ore
+(@pxref{Funzioni di tempo})
+
address@hidden
+Le funzioni
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()}
+e
address@hidden()}
+per la manipolazione a livello di bit
+(@pxref{Funzioni a livello di bit})
address@hidden In 4.1, and(), or() and xor() grew the ability to take > 2
arguments
+
address@hidden
+La funzione @code{isarray()} per controllare se una variabile @`e un vettore
+oppure no
+(@pxref{Funzioni per i tipi})
+
address@hidden
+Le funzioni @code{bindtextdomain()}, @code{dcgettext()}
+e @code{dcngettext()} per l'internazionalizzazione
+(@pxref{I18N per programmatore})
+
address@hidden
+La funzione @code{intdiv()} per effettuare divisioni a numeri interi e
+ottenere il resto della divisione
+(@pxref{Funzioni numeriche})
address@hidden itemize
+
address@hidden
+Modifiche e/o aggiunte alle opzioni della riga di comando:
+
address@hidden @value{MINUS}
address@hidden
+La variabile d'ambiente @env{AWKPATH} per specificare un percorso di ricerca
+per l'opzione @option{-f} della riga di comando
+(@pxref{Opzioni})
+
address@hidden
+La variabile d'ambiente @env{AWKLIBPATH} per specificare un percorso di ricerca
+per l'opzione @option{-l} della riga di comando
+(@pxref{Opzioni})
+
address@hidden
+Le opzioni brevi
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+. Inoltre, la
address@hidden di usare opzioni in formato lungo (stile GNU) che iniziano
+con @option{--}
+e le opzioni lunghe
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+and
address@hidden
+(@pxref{Opzioni}).
address@hidden itemize
+
address@hidden new ports
+
address@hidden
+Il supporto per i seguenti sistemi obsoleti @`e stato rimosso dal codice
+sorgente e dalla documentazione di @command{gawk} @value{PVERSION} 4.0:
+
address@hidden nested table
address@hidden @value{MINUS}
address@hidden
+Amiga
+
address@hidden
+Atari
+
address@hidden
+BeOS
+
address@hidden
+Cray
+
address@hidden
+MIPS RiscOS
+
address@hidden
+MS-DOS con il compilatore Microsoft
+
address@hidden
+MS-Windows con il compilatore Microsoft
+
address@hidden
+NeXT
+
address@hidden
+SunOS 3.x, Sun 386 (Road Runner)
+
address@hidden
+Tandem (non-POSIX)
+
address@hidden
+Compilatore pre-standard VAX C per VAX/VMS
+
address@hidden
+GCC per VAX e Alpha non @`e stato verificato da parecchio tempo.
+
address@hidden itemize
+
address@hidden
+Il supporto per i seguenti sistemi obsoleti @`e stato rimosso dal codice
+di @command{gawk} @value{PVERSION} 4.1:
+
address@hidden nested table
address@hidden @value{MINUS}
address@hidden
+Ultrix
address@hidden itemize
+
address@hidden
+Il supporto per i seguenti sistemi obsoleti @`e stato rimosso dal codice
+sorgente e dalla documentazione di
address@hidden @value{PVERSION} 4.2:
+
address@hidden nested table
address@hidden @value{MINUS}
address@hidden
+MirBSD
+
address@hidden
+GNU/Linux su Alpha
address@hidden itemize
+
address@hidden itemize
+
address@hidden XXX ADD MORE STUFF HERE
+
+
address@hidden This does not need to be in the formal book.
address@hidden FOR_PRINT
address@hidden Storia delle address@hidden
address@hidden Storia delle address@hidden di @command{gawk}
+
address@hidden
+See the thread:
+https://groups.google.com/forum/#!topic/comp.lang.awk/SAUiRuff30c
+This motivated me to add this section.
address@hidden ignore
+
address@hidden
+I've tried to follow this general order, esp.@: for the 3.0 and 3.1 sections:
+ variables
+ special files
+ language changes (e.g., hex constants)
+ differences in standard awk functions
+ new gawk functions
+ new keywords
+ new command-line options
+ behavioral changes
+ new ports
+Within each category, be alphabetical.
address@hidden ignore
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive le address@hidden in @command{gawk}
+in aggiunta a quelle di POSIX @command{awk},
+nell'ordine in cui sono state rese disponibili in @command{gawk}.
+
+La versione 2.10 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+La variabile d'ambiente @env{AWKPATH} per specificare un percorso di ricerca
+per l'opzione @option{-f} della riga di comando
+(@pxref{Opzioni})
+
address@hidden
+La variabile @code{IGNORECASE} e i suoi effetti
+(@pxref{Maiuscolo-Minuscolo}).
+
address@hidden
+I file @file{/dev/stdin}, @file{/dev/stdout}, @file{/dev/stderr} e i
address@hidden speciali @file{/dev/fd/@var{N}}
+(@pxref{File speciali})
address@hidden itemize
+
+La versione 2.13 di @command{gawk} ha ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+La variabile @code{FIELDWIDTHS} e i suoi effetti
+(@pxref{Dimensione costante}).
+
address@hidden
+Le funzioni predefinite @code{systime()} e @code{strftime()} per ottenere
+e stampare data e ora
+(@pxref{Funzioni di tempo}).
+
address@hidden
+Ulteriori opzioni dalla riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{-W lint} per fornire controlli su possibili errori e per
+la address@hidden, sia a livello di codice sorgente che in fase di esecuzione.
+
address@hidden
+L'opzione @option{-W compat} per inibire le estensioni GNU.
+
address@hidden
+L'opzione @option{-W posix} per richiedere una stretta aderenza allo
+standard POSIX.
address@hidden itemize
address@hidden itemize
+
+La versione 2.14 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+L'istruzione @code{next file} per passare immediatamente al successivo
address@hidden (@pxref{Istruzione nextfile}).
address@hidden itemize
+
+La versione 2.15 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+Nuove variabili (@pxref{Variabili predefinite}):
+
address@hidden @value{MINUS}
address@hidden
address@hidden, che permette di controllare la posizione di @code{FILENAME}
+nel vettore @code{ARGV}.
+
address@hidden
address@hidden, che contiene il messaggio di errore del sistema quando
address@hidden restituisce @minus{}1 o @code{close()} non termina con successo.
address@hidden itemize
+
address@hidden
+I @value{FNS} speciali @file{/dev/pid}, @file{/dev/ppid}, @file{/dev/pgrpid}
+e @file{/dev/user}. Questo supporto @`e stato rimosso in seguito.
+
address@hidden
+La address@hidden di cancellare un intero vettore in una sola istruzione
+con @samp{delete @var{vettore}}
+(@pxref{Cancellazione}).
+
address@hidden
+Modifiche nelle opzioni della riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+La address@hidden di usare opzioni in formato lungo (in stile GNU) che iniziano
+con @option{--}.
+
address@hidden
+L'opzione @option{--source} per combinare codice sorgente immesso nella riga
+di comando e codice sorgente proveniente da file di libreria.
address@hidden itemize
address@hidden itemize
+
+La versione 3.0 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+Variabili nuove o modificate:
+
address@hidden @value{MINUS}
address@hidden
address@hidden modificato, diventa applicabile al confronto tra stringhe,
+come pure alle operazioni su @dfn{regexp}
+(@pxref{Maiuscolo-Minuscolo}).
+
address@hidden
address@hidden, che contiene il testo in input che @`e stato individuato da
@code{RS}
+(@pxref{Record}).
address@hidden itemize
+
address@hidden
+Supporto completo sia per le @dfn{regexp} POSIX sia per quelle GNU
address@hidden
+(@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}).
address@hidden ifnottex
+
address@hidden
+La funzione @code{gensub()} per migliorare la manipolazione di testi
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+La funzione @code{strftime()} prevede un formato di data e ora di default,
+in modo da poter essere chiamata senza alcun argomento.
+(@pxref{Funzioni di tempo}).
+
address@hidden
+La address@hidden che @code{FS} e il terzo argomento della funzione
address@hidden()} siano delle stringhe nulle
+(@pxref{Campi di un solo carattere}).
+
address@hidden
+La address@hidden che @code{RS} sia una @dfn{regexp}
+(@pxref{Record}).
+
address@hidden
+L'istruzione @code{next file} @`e diventata @code{nextfile}
+(@pxref{Istruzione nextfile}).
+
address@hidden
+La funzione @code{fflush()} di
+BWK @command{awk}
+(BWK allora lavorava ai Bell Laboratories;
address@hidden di I/O}).
+
address@hidden
+Nuove opzioni della riga di comando:
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{--lint-old} per
+ottenere messaggi relativi a costrutti non disponibili
+nell'implementazione di @command{awk} per Unix Version 7
+(@pxref{V7/SVR3.1}).
+
address@hidden
+L'opzione @option{-m} da BWK @command{awk}. (Brian lavorava
+ancora ai Bell Laboratories all'epoca.) Quest'opzione @`e stata in seguito
+rimossa, sia dal suo @command{awk} che da @command{gawk}.
+
address@hidden
+L'opzione @option{--re-interval} per consentire di specificare
+espressioni di intervallo nelle @dfn{regexp}
+(@pxref{Operatori di espressioni regolari}).
+
address@hidden
+L'opzione @option{--traditional} aggiunta come maniera address@hidden intuitiva
+per richiedere l'opzione
address@hidden (@pxref{Opzioni}).
address@hidden itemize
+
address@hidden
+L'uso di GNU Autoconf per controllare il processo di configurazione
+(@pxref{Installazione veloce}).
+
address@hidden
+Supporto per Amiga.
+Questo supporto @`e stato rimosso in seguito.
+
address@hidden itemize
+
+La versione 3.1 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+Nuove variabili
+(@pxref{Variabili predefinite}):
+
address@hidden @value{MINUS}
address@hidden
address@hidden, per sistemi non aderenti allo standard POSIX,
+che consente I/O binario per file in input e/o output
+(@pxref{Uso su PC}).
+
address@hidden
address@hidden, che controlla dinamicamente gli avvertimenti emessi da
@dfn{lint}.
+
address@hidden
address@hidden, un vettore che fornisce informazioni correlate con il
+processo in esecuzione.
+
address@hidden
address@hidden, per impostare il dominio testuale in cui internazionalizzare
+un'applicazione (@pxref{Internazionalizzazione}).
address@hidden itemize
+
address@hidden
+La address@hidden di usare costanti ottali ed esadecimali nel codice
+sorgente di programmi @command{awk}.
+(@pxref{Numeri non-decimali}).
+
address@hidden
+L'operatore @samp{|&} per effettuare I/O bidirezionale verso un
+coprocesso
+(@pxref{I/O bidirezionale}).
+
address@hidden
+I file speciali @file{/inet} per interagire con reti TCP/IP usando @samp{|&}
+(@pxref{Reti TCP/IP}).
+
address@hidden
+Il secondo argomento opzionale della funzione @code{close()} per permettere di
+chiudere uno dei lati di una @dfn{pipe} bidirezionale aperta con un coprocesso
+(@pxref{I/O bidirezionale}).
+
address@hidden
+Il terzo argomento opzionale della funzione @code{match()} per
+avere a disposizione le diverse sottoespressioni individuate all'interno
+di una @dfn{regexp}
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Specificatori posizionali nelle stringhe di formato di @code{printf} per
+facilitare la traduzione di messaggi
+(@pxref{Ordinamento di printf}).
+
address@hidden
+Alcune nuove funzioni predefinite:
+
address@hidden @value{MINUS}
address@hidden
+Le funzioni @code{asort()} e @code{asorti()} per l'ordinamento di vettori
+(@pxref{Ordinamento di vettori}).
+
address@hidden
+Le funzioni @code{bindtextdomain()}, @code{dcgettext()} e @code{dcngettext()}
+per l'internationalizzazione
+(@pxref{I18N per programmatore}).
+
address@hidden
+La funzione @code{extension()} e la address@hidden di aggiungere
+nuove funzioni predefinite dinamicamente
address@hidden
+(@pxrefil{Estensioni dinamiche}).
address@hidden iftex
address@hidden
+(@pxref{Estensioni dinamiche}).
address@hidden ifnottex
+
address@hidden
+La funzione @code{mktime()} per generare date e ore
+(@pxref{Funzioni di tempo}).
+
address@hidden
+Le funzioni @code{and()}, @code{or()}, @code{xor()}, @code{compl()},
address@hidden()}, @code{rshift()} e @code{strtonum()}
+(@pxref{Funzioni a livello di bit}).
address@hidden itemize
+
address@hidden
address@hidden @code{next file} statement
+Il supporto per @samp{next file} scritto come due parole @`e stato rimosso
+completamente
+(@pxref{Istruzione nextfile}).
+
address@hidden
+Ulteriori opzioni sulla riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{--dump-variables} per stampare una lista di tutte le
+variabili globali.
+
address@hidden
+L'opzione @option{--exec}, da usare in script CGI [Common Gateway Interface].
+
address@hidden
+L'opzione della riga di comando @option{--gen-po} e l'uso di un trattino
+basso a inizio stringa, per segnalare stringhe che dovrebbero essere tradotte
+(@pxref{Estrazione di stringhe}).
+
address@hidden
+L'opzione @option{--non-decimal-data} per consentire di avere dati in input
+di tipo non decimale
+(@pxref{Dati non decimali}).
+
address@hidden
+L'opzione @option{--profile} e @command{pgawk}, la
+versione profilatrice di @command{gawk}, per produrre profili di esecuzione
+di programmi @command{awk}
+(@pxref{Profilare}).
+
address@hidden
+L'opzione @option{--use-lc-numeric} per richiedere a @command{gawk}
+di usare il carattere di separazione decimale proprio della localizzazione
+nell'elaborazione dei dati in input
+(@pxref{Conversione}).
address@hidden itemize
+
address@hidden
+L'uso di GNU Automake a supporto della standardizzazione del processo
+di configurazione
+(@pxref{Installazione veloce}).
+
address@hidden
+L'uso di GNU @command{gettext} per i messaggi emessi da @command{gawk}
+(@pxref{Gawk internazionalizzato}).
+
address@hidden
+Supporto per BeOS. Rimosso in seguito.
+
address@hidden
+Supporto per Tandem. Rimosso in seguito.
+
address@hidden
+La versione per Atari ufficialmente non @`e address@hidden supportata e in
seguito
address@hidden stata completamente rimossa.
+
address@hidden
+Modifiche al codice sorgente per usare definizioni di funzione secondo lo
+stile di codifica dello standard ISO C.
+
address@hidden
+Aderenza alla specifica POSIX per le funzioni @code{sub()} e @code{gsub()}
+(@pxref{Dettagli ostici}).
+
address@hidden
+La funzione @code{length()} @`e stata estesa per accettare un vettore come
+argomento, e restituire in tal caso il numero di elementi nel vettore
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+La funzione @code{strftime()} accetta un terzo argomento per
+dare la address@hidden di stampare data e ora nel formato UTC
+(@pxref{Funzioni di tempo}).
address@hidden itemize
+
+La versione 4.0 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
+
address@hidden
+Aggiunta di variabili:
+
address@hidden @value{MINUS}
address@hidden
address@hidden, che permette di specificare una @dfn{regexp} che individua
+i campi, invece che individuare il separatore tra i campi
+(@pxref{Separazione in base al contenuto}).
+
address@hidden
+Se esiste l'elemento di vettore @code{PROCINFO["sorted_in"]}, il ciclo
address@hidden(indice in pippo)} ordina
+gli indici, prima di iniziare il ciclo. Il valore di questo elemento
+permette di controllare l'ordinamento degli indici prima di iniziare il
+ciclo che li visita tutti
+(@pxref{Controllare visita}).
+
address@hidden
address@hidden"strftime"]}, che contiene la stringa di formato
+di default per @code{strftime()}
+(@pxref{Funzioni di tempo}).
address@hidden itemize
+
address@hidden
+I file speciali @file{/dev/pid}, @file{/dev/ppid}, @file{/dev/pgrpid}
+e @file{/dev/user} sono stati rimossi.
+
address@hidden
+Il supporto per IPv6 @`e stato aggiunto attraverso il file speciale
address@hidden/inet6}.
+Il file speciale @file{/inet4} consente di operare con IPv4 e @file{/inet}
+opera con il default di sistema, che probabilmente @`e IPv4
+(@pxref{Reti TCP/IP}).
+
address@hidden
+L'uso delle sequenze di protezione @samp{\s} e @samp{\S} nelle espressioni
+regolari
+(@pxref{Operatori di @dfn{regexp} GNU}).
+
address@hidden
+Le espressioni di intervallo sono consentite per default nelle espressioni
+regolari
+(@pxref{Operatori di espressioni regolari}).
+
address@hidden
+La classi di caratteri POSIX sono consentite anche se si @`e specificata
+l'opzione @option{--traditional}
+(@pxref{Operatori di espressioni regolari}).
+
address@hidden
address@hidden e @code{continue} non sono address@hidden consentiti fuori da un
ciclo,
+anche se si @`e specificata l'opzione @option{--traditional}
+(@pxref{Istruzione break} e anche la
address@hidden continue}).
+
address@hidden
address@hidden()}, @code{nextfile} e @samp{delete @var{array}}
+sono consentite anche se @`e stata specificata l'opzione @option{--posix} o
address@hidden, poich@'e questi costrutti sono ora inclusi
+nello standard POSIX.
+
address@hidden
+Un terzo argomento facoltativo per le funzioni @code{asort()} e @code{asorti()}
+permette di specificare il tipo di ordinamento desiderato
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Il comportamento di @code{fflush()} @`e stato modificato per corrispondere
+a quello di BWK @command{awk}
+e per lo standard POSIX; ora sia @samp{fflush()} che @samp{fflush("")}
+forzano la scrittura di tutte le ridirezioni in output aperte
+(@pxref{Funzioni di I/O}).
+
address@hidden
+La funzione @code{isarray()}
+determina se un elemento @`e un vettore oppure no
+per rendere possibile la visita di vettori di vettori
+(@pxref{Funzioni per i tipi}).
+
address@hidden
+La funzione @code{patsplit()} che
+fornisce le stesse address@hidden di @code{FPAT}, per suddividere delle
stringhe
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Un quarto argomento opzionale per la funzione @code{split()},
+che indica un vettore destinato a contenere i valori dei separatori
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Vettori di vettori
+(@pxref{Vettori di vettori}).
+
address@hidden
+I criteri di ricerca speciali @code{BEGINFILE} ed @code{ENDFILE}
+(@pxref{BEGINFILE/ENDFILE}).
+
address@hidden
+Chiamate indirette di funzioni
+(@pxref{Chiamate indirette}).
+
address@hidden
+Le istruzioni @code{switch} / @code{case} sono disponibili per default
+(@pxref{Istruzione switch}).
+
address@hidden
+Modifiche nelle opzioni della riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+Le opzioni @option{-b} e @option{--characters-as-bytes},
+che impediscono che @command{gawk} tratti l'input come composto da una
+stringa di caratteri multibyte.
+
address@hidden
+Rimozione delle opzioni ridondanti (in notazione lunga) @option{--compat},
address@hidden e @option{--usage}.
+
address@hidden
+L'opzione @option{--gen-po} @`e stata finalmente rinominata
address@hidden per correttezza.
+
address@hidden
+L'opzione @option{--sandbox} che disabilita alcune address@hidden [per operare
+in un ambiente "protetto"].
+
address@hidden
+Tutte le opzioni in notazione lunga hanno acquisito opzioni corrispondenti
+in notazione breve, per poter essere usate negli script di shell @samp{#!}.
address@hidden itemize
+
address@hidden
+I nomi di directory che appaiono sulla riga di comando generano adesso
+un messaggio di errore, ma non interrompono l'elaborazione, a meno che non
+siano state specificate le opzioni @option{--posix} o @option{--traditional}
+(@pxref{Directory su riga di comando}).
+
address@hidden
+Il codice interno di @command{gawk} @`e stato riscritto, aggiungendo la
+versione per il debug @command{dgawk},
+con un possibile miglioramento nei tempi di esecuzione
address@hidden
+(@pxrefil{Debugger}).
address@hidden iftex
address@hidden
+(@pxref{Debugger}).
address@hidden ifnottex
+
address@hidden
+In aderenza agli standard di codifica GNU, le estensioni dinamiche devono
+definire un simbolo globale che indica che sono compatibili con la
+licenza GPL
+(@pxref{Licenza delle estensioni}).
+
address@hidden
+In address@hidden POSIX, i confronti tra stringhe usano le funzioni di
+libreria @code{strcoll()} / @code{wcscoll()}
+(@pxref{Confronto POSIX di stringhe}).
+
address@hidden
+L'opzione per usare @dfn{socket} in maniera @dfn{raw} (nativa) @`e stata
+rimossa, perch@'e non era mai stata implementata
+(@pxref{Reti TCP/IP}).
+
address@hidden
+Intervalli nella forma @samp{[d-h]} sono elaborati come se fossero scritti
+nella localizzazione C, a prescindere da che tipo di @dfn{regexp} @`e usata,
+anche se era stata specificata l'opzione
address@hidden
+(@pxref{Intervalli e localizzazione}).
+
address@hidden
address@hidden stato rimosso il supporto per i seguenti sistemi:
+
address@hidden @value{MINUS}
address@hidden
+Atari
+
address@hidden
+Amiga
+
address@hidden
+BeOS
+
address@hidden
+Cray
+
address@hidden
+MIPS RiscOS
+
address@hidden
+MS-DOS con Compilatore Microsoft
+
address@hidden
+MS-Windows con Compilatore Microsoft
+
address@hidden
+NeXT
+
address@hidden
+SunOS 3.x, Sun 386 (Road Runner)
+
address@hidden
+Tandem (non-POSIX)
+
address@hidden
+Compilatore pre-standard VAX C per VAX/VMS
address@hidden itemize
address@hidden itemize
+
+La versione 4.1 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
+
address@hidden
+Tre nuovi vettori:
address@hidden, @code{FUNCTAB} e @code{PROCINFO["identifiers"]}
+(@pxref{Variabili auto-assegnate}).
+
address@hidden
+I tre comandi eseguibili @command{gawk}, @command{pgawk} e @command{dgawk},
+sono diventati uno solo, con il solo nome @command{gawk}. Di conseguenza
+le opzioni sulla riga di comando sono state modificate.
+
address@hidden
+Modifiche delle opzioni da riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{-D} attiva il debugger.
+
address@hidden
+Le opzioni @option{-i} e @option{--include}
+caricano dei file di libreria @command{awk}.
+
address@hidden
+Le opzioni @option{-l} e @option{--load} caricano estensioni dinamiche
+compilate.
+
address@hidden
+Le opzioni @option{-M} e @option{--bignum} abilitano la libreria MPFR per
+il calcolo con un numero arbitrario di cifre significative.
+
address@hidden
+L'opzione @option{-o} serve solo a ottenere in output una stampa formattata
+elegantemente del programma da eseguire.
+
address@hidden
+L'opzione @option{-p} @`e usata per "profilare" l'esecuzione del programma.
+
address@hidden
+L'opzione @option{-R} @`e stata rimossa.
address@hidden itemize
+
address@hidden
+Supporto per il calcolo ad alta precisione con MPFR
+(@pxref{Calcolo con precisione arbitraria}).
+
address@hidden
+Le funzioni @code{and()}, @code{or()} e @code{xor()} sono state modificate
+per ammettere un numero qualsiasi di argomenti, con un minimo di due
+(@pxref{Funzioni a livello di bit}).
+
+
address@hidden
+L'interfaccia che rende possibile l'estensione dinamica @`e stata rifatta
+completamente
address@hidden
+(@pxrefil{Estensioni dinamiche}).
address@hidden iftex
address@hidden
+(@pxref{Estensioni dinamiche}).
address@hidden ifnottex
+
address@hidden
+La funzione @code{getline} ridiretta @`e stata resa possibile all'interno di
address@hidden ed @code{ENDFILE}
+(@pxref{BEGINFILE/ENDFILE}).
+
address@hidden
+Il comando @code{where} @`e stato aggiunto al debugger
+(@pxref{Stack di esecuzione}).
+
address@hidden
+Il supporto per Ultrix @`e stato rimosso.
+
address@hidden itemize
+
+La versione 4.2 ha introdotto le seguenti address@hidden:
+
address@hidden @bullet
address@hidden
+Differenze apportate alle variabili di ambiente (@code{ENVIRON}) sono riflesse
in quelle
+rese disponibili a @command{gawk} e in quelle di programmi che siano da esso
richiamati.
address@hidden auto-assegnate}.
+
address@hidden
+L'opzione @option{--pretty-print} non esegue address@hidden, dopo averlo
stampato,
+il programma @command{awk}.
address@hidden
+
address@hidden
+Il programma @command{igawk} e le relative pagine di manuale non sono
address@hidden installati come parte dell'installazione di @command{gawk}.
address@hidden igawk}.
+
address@hidden
+La funzione @code{intdiv()}.
address@hidden numeriche}.
+
address@hidden
+Il massimo numero di cifre esadecimali permesse nelle sequenze di
+protezione @samp{\x} @`e ora limitato a due.
address@hidden di protezione}.
+
address@hidden
address@hidden e @code{printf} non terminano il programma dopo alcuni
+errori di output.
address@hidden dopo errori}.
+
address@hidden
+Per molti anni, lo standard POSIX richiedeva che la separazione dei campi
+di un record fosse fatta per default
+quando si incontrano spazi e TAB, e questo @`e il comportamento di
address@hidden se si specifica l'opzione @option{--posix}. Dal 2013
+il comportamento originario @`e stato ripristinato, e ora
+il default per separare i campi con l'opzione @option{--posix} ammette
+anche il ritorno a capo come separatore di campi.
+
address@hidden
+Il supporto per MirBSD @`e stato rimosso.
+
address@hidden
+Il supporto per GNU/Linux sull'architettura Alpha @`e stato rimosso.
address@hidden itemize
+
address@hidden XXX ADD MORE STUFF HERE
address@hidden ifclear
+
address@hidden Estensioni comuni
address@hidden Sommario Estensioni Comuni
+
address@hidden estensioni, Brian Kernighan @command{awk}
address@hidden estensioni, @command{mawk}
+La tabella seguente dettaglia le estensioni comuni supportate
+da @command{gawk}, da Brian Kernighan @command{awk} e da @command{mawk},
+le tre versioni liberamente disponibili address@hidden usate di @command{awk}
+(@pxref{Altre versioni}).
+
address@hidden {File speciale @file{/dev/stderr}} {BWK @command{awk} }
address@hidden address@hidden {Standard attuale}
address@hidden address@hidden @tab BWK @command{awk} @tab @command{mawk} @tab
@command{gawk} @tab Standard attuale
address@hidden Sequenza di protezione @samp{\x} @tab X @tab X @tab X @tab
address@hidden Stringa nulla come @code{FS} @tab X @tab X @tab X @tab
address@hidden File speciale @file{/dev/stdin} @tab X @tab X @tab X @tab
address@hidden File speciale @file{/dev/stdout} @tab X @tab X @tab X @tab
address@hidden File speciale @file{/dev/stderr} @tab X @tab X @tab X @tab
address@hidden @code{delete} senza indici @tab X @tab X @tab X @tab X
address@hidden Funzione @code{fflush()} @tab X @tab X @tab X @tab X
address@hidden @code{length()} di un vettore @tab X @tab X @tab X @tab
address@hidden Istruzione @code{nextfile} @tab X @tab X @tab X @tab X
address@hidden Operatori @code{**} e @code{**=} @tab X @tab @tab X @tab
address@hidden Parola chiave @code{func} @tab X @tab @tab X @tab
address@hidden Variabile @code{BINMODE} @tab @tab X @tab X @tab
address@hidden @code{RS} come @dfn{regexp} @tab @tab X @tab X @tab
address@hidden Funzioni gestione data/ora @tab @tab X @tab X @tab
address@hidden multitable
+
address@hidden Intervalli e localizzazione
address@hidden Intervalli @dfn{regexp} e localizzazione: una lunga e triste
storia
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive la storia confusionaria degli intervalli
+all'interno di espressioni regolari, le loro relazioni con la localizzazione,
+e l'effetto da address@hidden determinato su diverse versioni di
@command{gawk}.
+
+Gli strumenti originali Unix aventi a che fare con espressioni regolari
+stabilivano che intervalli di caratteri (come @samp{[a-z]}) individuavano
+un carattere qualsiasi tra il primo carattere dell'intervallo e l'ultimo
+carattere dello stesso, entrambi inclusi. L'ordinamento era basato sul
+valore numerico di ogni carattere come era rappresentato all'interno
+del computer, nell'insieme di caratteri proprio di ogni macchina.
+Quindi, su sistemi che adottano la codifica ASCII, @samp{[a-z]} individua
+tutte le lettere minuscole, e solo
+quelle, in quanto i valori numerici che rappresentano le lettere dalla
address@hidden fino alla @samp{z} sono contigui. (In un sistema che adotta la
+codifica EBCDIC, l'intervallo @samp{[a-z]} comprende anche ulteriori
+caratteri non alfabetici.)
+
+Quasi tutti i testi di introduzione allo Unix spiegavano che le espressioni
+di intervallo funzionavano in questo modo, e in particolare insegnavano che
+la maniera ``corretta'' per individuare le lettere minuscole era con
address@hidden e che @samp{[A-Z]} era il modo ``corretto'' per individuare le
+lettere maiuscole.
+E, in effetti, era proprio address@hidden@address@hidden la vita era semplice.}
+
+Lo standard POSIX 1992 introduceva l'idea di localizzazione
+(@pxref{Localizzazioni}).
+Poich@'e molte localizzazioni comprendono altre lettere, oltre alle 26
+lettere dell'alfabeto inglese, lo standard POSIX introduceva le classi
+di carattere (@pxref{Espressioni tra parentesi quadre}) per permettere
+l'individuazione di differenti insiemi di caratteri, in aggiunta a quelli
+tradizionali presenti nell'insieme di caratteri ASCII.
+
+Tuttavia, lo standard @emph{ha modificato} l'interpretazione delle
+espressioni di intervallo.
+Nelle localizzazioni @code{"C"} e @code{"POSIX"},
+un'espressione di intervallo come
address@hidden @`e ancora equivalente a @samp{[abcdxyz]}, secondo l'ordine
+della codifica ASCII.
+Ma in tutte le altre localizzazioni l'ordinamento @`e basato su quel che
+si chiama @dfn{ordine di collazione}.
+
+Cosa vuol dire?
+In molte localizzazioni, le lettere @samp{A} e @samp{a} vengono entrambe
+prima di @samp{B}.
+In altre parole, queste localizzazioni ordinano i caratteri nel modo in cui
+sono ordinati in un dizionario,
+e @samp{[a-dx-z]} non @`e detto che equivalga a @samp{[abcdxyz]};
+invece, potrebbe essere equivalente a @samp{[ABCXYabcdxyz]}, per fare un
+esempio.
+
+Su questo punto @`e opportuno insistere: molta documentazione afferma che
+si dovrebbe usare @samp{[a-z]} per identificare un carattere minuscolo.
+Ma su sistemi con localizzazioni
+non-ASCII, un tale intervallo potrebbe includere tutti i caratteri maiuscoli
+tranne @samp{A} o @samp{Z}! Questo ha continuato a essere una fonte di
+equivoci perfino nel ventunesimo secolo.
+
+Per dare un'idea del tipo di problemi, l'esempio seguente usa la funzione
address@hidden()}, che effettua una sostituzione di testo all'interno di una
+stringa (@pxref{Funzioni per stringhe}). Qui, l'idea @`e quella di rimuovere
+i caratteri maiuscoli a fine stringa:
+
address@hidden
+$ @kbd{echo qualcosa1234abc | gawk-3.1.8 '@{ sub("[A-Z]*$", ""); print @}'}
address@hidden qualcosa1234a
address@hidden example
+
address@hidden
+Questo non @`e l'output che ci si aspettava, perch@'e, il @samp{bc} alla fine
di
address@hidden non dovrebbe essere individuato da @samp{[A-Z]*}.
+Un tale risultato dipende dalle impostazioni di localizzazione (e quindi
+potrebbe non succedere sul sistema che si sta usando).
+
address@hidden Unicode
+Considerazioni simili valgono per altri intervalli. Per esempio, @samp{["-/]}
address@hidden perfettamente valido in ASCII, ma non @`e valido in molte
localizzazioni
+Unicode, p.es. in @code{en_US.UTF-8}.
+
+Il codice delle prime versioni di @command{gawk} per individuare le
address@hidden non teneva conto della localizzazione, e quindi gli
+intervalli potevano essere interpretati in maniera tradizionale.
+
+Quando @command{gawk} ha iniziato a usare metodi di ricerca di @dfn{regexp}
+che tengono conto della localizzazione, sono iniziati i problemi;
+a maggior ragione in quanto sia GNU/Linux che i venditori di versioni
+commerciali di Unix
+avevano iniziato a implementare localizzazioni non-ASCII,
address@hidden per default}. La domanda che forse si udiva address@hidden
spesso
+era del tipo: ``Perch@'e @samp{[A-Z]} individua lettere minuscole?!?''
+
address@hidden Berry, Karl
+Questa situazione @`e in essere da circa 10 anni, se non di address@hidden, e
+il manutentore di @command{gawk} si @`e stufato di continuare a spiegare che
address@hidden stava semplicemente implementando quelli che sono gli
+standard, e che il problema stava nella localizzazione dell'utente. Nella
+fase di sviluppo della @value{PVERSION} 4.0, @command{gawk} @`e stato
modificato
+in modo da trattare sempre gli
+intervalli "come si faceva prima di POSIX", a meno che non si specifichi
+l'opzione @option{--posix} (@pxref{Opzioni})address@hidden
address@hidden address@hidden@dotless{i}} che @`e nata la Campagna per
l'Interpretazione Razionale degli
+Intervalli (in inglese, RRI address@hidden Range Interpretation}]).
+Un certo
+numero di strumenti GNU hanno address@hidden implementato questa modifica, o
+lo faranno presto. Grazie a Karl Berry per aver coniato la frase
+``Rational Range Interpretation''.}
+
+Fortunatamente, un po' prima del rilascio definitivo della versione 4.0 di
address@hidden, il manutentore ha appreso che lo standard 2008 aveva
+modificato la definizione di intervallo, e che, al di fuori delle
+localizzazioni @code{"C"} e @code{"POSIX"}, il significato di espressione
+di intervallo era ora
address@hidden@footnote{Si veda
address@hidden://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_03_05,
lo standard}
+e
address@hidden://pubs.opengroup.org/onlinepubs/9699919799/xrat/V4_xbd_chap09.html#tag_21_09_03_05,
le motivazioni}.}
+
+Adottando questo simpatico termine tecnico, lo standard permette agli
+implementatori di implementare gli intervalli nella maniera che preferiscono.
+Il manutentore di @command{gawk} ha deciso di implementare la regola pre-POSIX
+sia per l'individuazione di default delle @dfn{regexp} sia quando si
+specificano le opzioni @option{--traditional} o @option{--posix}.
+In ogni caso @command{gawk} aderisce allo standard POSIX.
+
address@hidden Contributori
address@hidden I principali contributori a @command{gawk}
address@hidden @command{gawk}, lista di contributori a
address@hidden
address@hidden sempre il merito, se un merito va riconosciuto.}
address@hidden Anonimo
address@hidden quotation
+
+Questa @value{SECTION} elenca le persone che hanno maggiormente contribuito
+allo sviluppo di @command{gawk} e/o alla stesura di questo @value{DOCUMENT},
+in ordine approssimativamente cronologico:
+
address@hidden @value{BULLET}
address@hidden
address@hidden Aho, Alfred
address@hidden Weinberger, Peter
address@hidden Kernighan, Brian
+Il Dr.@: Alfred V.@: Aho,
+il Dr.@: Peter J.@: Weinberger, e
+il Dr.@: Brian W.@: Kernighan, tutti dei Bell Laboratories,
+hanno progettato e implementato @command{awk} per Unix,
+da cui @command{gawk} trae la maggioranza delle sue address@hidden
+
address@hidden
address@hidden Rubin, Paul
+Paul Rubin,
+autore del progetto e dell'implementazione iniziale del 1986, ha
+scritto la prima bozza (di circa 40 pagine) di questo @value{DOCUMENT}.
+
address@hidden
address@hidden Fenlason, Jay
+Jay Fenlason
+ha completato l'implementazione iniziale.
+
address@hidden
address@hidden Close, Diane
+Diane Close
+ha rivisto la prima bozza di questo @value{DOCUMENT}, portandolo alla
+lunghezza di circa 90 pagine.
+
address@hidden
address@hidden Stallman, Richard
+Richard Stallman
+ha aiutato a completare l'implementazione e la bozza iniziale di questo
address@hidden
address@hidden anche il fondatore della FSF e del progetto GNU.
+
address@hidden
address@hidden Woods, John
+John Woods
+ha scritto porzioni di codice (volti principalmente alla correzione di
+errori) nella versione iniziale di @command{gawk}.
+
address@hidden
address@hidden Trueman, David
+Nel 1988,
+David Trueman
+si @`e fatto carico della manutenzione principale di @command{gawk},
+rendendolo compatibile col ``nuovo'' @command{awk} e
+migliorandone parecchio la address@hidden di esecuzione.
+
address@hidden
address@hidden Kwok, Conrad
address@hidden Garfinkle, Scott
address@hidden Williams, Kent
+Conrad Kwok,
+Scott Garfinkle
+e
+Kent Williams
+hanno per primi portato il programma all'ambiente MS-DOS, usando varie
+versioni del compilatore MSC.
+
address@hidden
address@hidden Rankin, Pat
+Pat Rankin
+ha portato il programma all'ambiente VMS, preparando anche la relativa
+documentazione.
+
address@hidden
address@hidden Peterson, Hal
+Hal Peterson
address@hidden stato di aiuto nel portare @command{gawk} nei sistemy Cray.
+(L'ambiente Cray non @`e address@hidden supportato.)
+
address@hidden
address@hidden Rommel, Kai Uwe
+Kai Uwe Rommel
+ha portato per primo il programma all'ambiente OS/2, preparando anche
+la relativa documentazione.
+
address@hidden
address@hidden Jaegermann, Michal
+Michal Jaegermann
+ha portato il programma all'ambiente Atari, preparando anche la relativa
+documentazione.
+(L'ambiente Atari non @`e address@hidden supportato.)
+Michal continua a effettuare controlli di address@hidden,
+e ha molto contribuito a consentire a @command{gawk}
+di funzionare su sistemi diversi da quelli a 32 bit.
+
address@hidden
address@hidden Fish, Fred
+Fred Fish
+ha portato il programma all'ambiente Amiga, preparando anche la relativa
+documentazione.
+(Purtroppo Fred non @`e address@hidden tra noi, e questo ambiente non @`e
address@hidden supportato.)
+
address@hidden
address@hidden Deifik, Scott
+Scott Deifik
+si @`e occupato della manutenzione per MS-DOS usando il compilatore DJGPP.
+
address@hidden
address@hidden Zaretskii, Eli
+Eli Zaretskii
+si occupa della manutenzione della versione per MS-Windows, nell'ambiente
+MinGW.
+
address@hidden
address@hidden Grigera, Juan
+Juan Grigera
address@hidden autore di una versione di @command{gawk} per sistemi Windows32.
+(Questa versione non @`e address@hidden supportata.)
+
address@hidden
address@hidden Hankerson, Darrel
+Per molti anni, il
+Dr.@: Darrel Hankerson
+ha fatto da coordinatore per le varie versioni che giravano su diverse
+piattaforme PC e ha creato distribuzioni binarie per vari sistemi operativi
+che girano sui PC.
+Il suo aiuto @`e stato importante per mantenere aggiornata la documentazione
+per le diverse piattaforme PC.
+
address@hidden
address@hidden Zoulas, Christos
+Christos Zoulas
+ha scritto la funzione predefinita @code{extension()} per aggiungere
+dinamicamente nuove funzioni.
+(Questa address@hidden @`e divenuta obsoleta a partire da @command{gawk} 4.1.)
+
address@hidden
address@hidden Kahrs, J@"urgen
+J@"urgen Kahrs
+ha scritto la prima versione del codice per interagire con la rete
+TCP/IP, con la relativa documentazione, e fornito le ragioni per l'aggiunta
+dell'operatore @samp{|&}.
+
address@hidden
address@hidden Davies, Stephen
+Stephen Davies
+ha portato per la prima volta il programma all'ambiente Tandem, preparando
+anche la relativa documentazione.
+(Tuttavia, questa versione non @`e address@hidden supportata.)
+Stephen @`e anche stato determinante nel lavoro iniziale per integrare il
codice
+interno di gestione dei byte nel
+complesso del codice di @command{gawk}.
+
address@hidden
address@hidden Woehlke, Matthew
+Matthew Woehlke
+ha migliorato l'aderenza allo standard POSIX nei sistemi Tandem che
+implementano lo standard.
+
address@hidden
address@hidden Brown, Martin
+Martin Brown
+ha portato il programma all'ambiente BeOS, preparando anche la relativa
+documentazione.
+(L'ambiente BeOS non @`e address@hidden supportato.)
+
address@hidden
address@hidden Peters, Arno
+Arno Peters
+ha fatto il lavoro iniziale necessario per consentire alla configurazione
+di @command{gawk} di usare GNU Automake e GNU @command{gettext}.
+
address@hidden
address@hidden Broder, Alan J.@:
+Alan J.@: Broder
+ha scritto la prima versione della funzione @code{asort()} e anche
+il codice per gestire il terzo argomento opzionale della funzione
address@hidden()}.
+
address@hidden
address@hidden Buening, Andreas
+Andreas Buening
+ha aggiornato la versione di @command{gawk} per OS/2.
+
address@hidden
address@hidden Hasegawa, Isamu
+Isamu Hasegawa,
+dell'IBM in Giappone, ha contribuito con il supporto per i caratteri multibyte.
+
address@hidden
address@hidden Benzinger, Michael
+Michael Benzinger ha sviluppato il codice iniziale per l'istruzione
address@hidden
+
address@hidden
address@hidden McPhee, Patrick
+Patrick T.J.@: McPhee ha sviluppato il codice per il caricamento
+dinamico negli ambienti Windows32.
+(Questa address@hidden non @`e address@hidden supportata.)
+
address@hidden
address@hidden Wallin, Anders
+Anders Wallin ha aiutato a continuare il supporto della versione VMS
+di @command{gawk} per parecchi anni.
+
address@hidden
address@hidden Gordon, Assaf
+Assaf Gordon ha scritto il codice per implementare
+l'opzione @option{--sandbox}.
+
address@hidden
address@hidden Haque, John
+John Haque @`e autore dei seguenti contributi:
+
address@hidden @value{MINUS}
address@hidden
+Le modifiche per convertire @command{gawk}
+in un interprete di codice a livello di byte, compreso il debugger
+
address@hidden
+L'aggiunta di veri vettori di vettori
+
address@hidden
+Le modifiche ulteriori per il supporto del calcolo a precisione
+arbitraria
+
address@hidden
+Il testo iniziale di
address@hidden con precisione arbitraria}
+
address@hidden
+Il lavoro per unificare le tre varianti del programma @command{gawk},
+in vista della versione 4.1
+
address@hidden
+I miglioramenti alla gestione interna dei vettori per i vettori i cui
+indici sono dei numeri interi
+
address@hidden
+A John, insieme a Pat Rankin, si devono i miglioramenti alla address@hidden
+di ordinamento dei vettori.
address@hidden itemize
+
address@hidden Papadopoulos, Panos
address@hidden
+Panos Papadopoulos ha scritto il testo originale per
address@hidden file}.
+
address@hidden
address@hidden Yawitz, Efraim
+Efraim Yawitz ha scritto il testo originale per il @ref{Debugger}.
+
address@hidden
address@hidden Schorr, Andrew
+Lo sviluppo dell'estensione API rilasciata per la prima volta con
address@hidden 4.1 @`e stata principalmente guidata da
+Arnold Robbins e Andrew Schorr, con notevoli contributi dal
+resto del team di sviluppo.
+
address@hidden Malmberg, John E.
address@hidden
+John Malmberg ha apportato miglioramenti significativi alla versione
+OpenVMS e alla relativa documentazione.
+
address@hidden
address@hidden Colombo, Antonio
+Antonio Giovanni Colombo ha riscritto diversi esempi, che non erano
address@hidden
+attuali, contenuti nei primi capitoli, e gliene sono estremamente grato.
+
address@hidden
address@hidden Robbins, Arnold
+Arnold Robbins
+ha lavorato su @command{gawk} dal 1988, dapprima
+aiutando David Trueman e in seguito, dal 1994 circa, come
+manutentore principale.
address@hidden itemize
+
address@hidden Sommario della storia
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Il linguaggio @command{awk} si @`e evoluto col passare degli anni. La prima
+versione risale a Unix V7, circa 1978. Nel 1987, per la versione Unix
+System V Release 3.1, sono state fatte al linguaggio delle modifiche
+importanti, inclusa la address@hidden di avere funzioni definite dall'utente.
+Ulteriori modifiche sono state fatte per la versione System V Release 4, nel
+1989.
+Dopo di allora, sono state apportate ulteriori modifiche minori,
+per implementare lo standard POSIX.
+
address@hidden
+L'@command{awk} di Brian Kernighan prevede un piccolo numero di estensioni
+implementate di comune accordo con altre versioni di @command{awk}.
+
address@hidden
address@hidden prevede un elevato numero di estensioni rispetto
+a POSIX @command{awk}.
+Queste estensioni possono essere disabilitate specificando l'opzione
address@hidden o @option{--posix}.
+
address@hidden
+L'interazione tra localizzazioni POSIX e individuazione di @dfn{regexp}
+in @command{gawk} @`e stata causa di malintesi nel corso degli anni. Oggi
address@hidden implementa l'Interpretazione Razionale degli Intervalli
+(@dfn{Rational Range Interpretation}), dove
+intervalli nella forma @samp{[a-z]} individuano @emph{solo} i caratteri
+numericamente compresi tra
address@hidden e @samp{z} nella rappresentazione nativa dei caratteri in quella
+particolare macchina. Normalmente quella in uso @`e quella ASCII,
+ma address@hidden essere EBCDIC sui sistemi IBM S/390.
+
address@hidden
+Molte persone hanno contribuito allo sviluppo di @command{gawk} nel corso
+degli anni. Spero che l'elenco fornito in questo @value{CHAPTER} sia
+esauriente e attribuisca il giusto riconoscimento quando questo @`e dovuto.
+
address@hidden itemize
+
address@hidden Installazione
address@hidden Installare @command{gawk}
+
address@hidden last two commas are part of see also
address@hidden sistemi operativi, si veda anche GNU/address@hidden sistemi
operativi per address@hidden Unix
address@hidden @command{gawk}, installare
address@hidden installare @command{gawk}
+Quest'appendice contiene istruzioni per installare @command{gawk} sulle
+varie piattaforme supportate dagli sviluppatori. Lo sviluppatore
+principale supporta GNU/Linux (e Unix), mentre le altre piattaforme sono
+sono curate da altri sviluppatori.
address@hidden
+per gli indirizzi di posta elettronica di chi effettua la manutenzione
+della versione specifica di una particolare piattaforma.
+
address@hidden
+* Distribuzione di Gawk:: Contenuto della distribuzione di @command{gawk}.
+* Installazione Unix:: Installare @command{gawk} su varie versioni
+ di Unix.
+* Installazione non-Unix:: Installazioni su altri Sistemi Operativi.
+* Bug:: Notificare problemi e bug.
+* Altre versioni:: Altre implementazioni di @command{awk}
+ liberamente disponibili.
+* Sommario dell'installazione:: Sommario dell'installazione.
address@hidden menu
+
address@hidden Distribuzione di Gawk
address@hidden La distribuzione di @command{gawk}
address@hidden codice sorgente di @command{gawk}
address@hidden sorgente, codice, @command{gawk}
+
+Questa @value{SECTION} spiega come ottenere la distribuzione
+di @command{gawk}, come scompattarla, e cosa @`e contenuto nei vari file
+e nelle sottodirectory risultanti.
+
address@hidden
+* Scaricare:: Come ottenere la distribuzione.
+* Scompattazione:: Come estrarre la distribuzione.
+* Contenuti della distribuzione:: Cosa c'@`e nella distribuzione.
address@hidden menu
+
address@hidden Scaricare
address@hidden Ottenere la distribuzione di @command{gawk}
address@hidden @command{gawk}, codice address@hidden ottenere il
address@hidden codice sorgente di @command{gawk}, ottenere il
+Ci sono due modi per ottenere del software GNU:
+
address@hidden @value{BULLET}
address@hidden
+Copiarlo da qualcuno che ce l'abbia address@hidden
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden
+Ottenere @command{gawk}
+dal sito Internet
address@hidden, nella directory @file{/gnu/gawk}.
address@hidden possibile accedere al sito sia via @command{ftp} anonimo che via
@code{http}.
+Se si dispone del programma @command{wget}, si address@hidden utilizzarlo
digitando un
+comando simile a questo:
+
address@hidden
+wget http://ftp.gnu.org/gnu/gawk/address@hidden@value{PATCHLEVEL}.tar.gz
address@hidden example
address@hidden itemize
+
+L'archivio che contiene il software GNU @`e disponibile in vari cloni
+(@dfn{mirror}) in tutto il mondo.
+La lista aggiornata dei siti clone @`e disponibile nel
address@hidden://www.gnu.org/order/ftp.html, sito web principale della FSF}.
+Si tenti di usare uno dei siti-clone; dovrebbero essere meno trafficati, ed @`e
+possibile che ce ne sia uno address@hidden vicino.
+
+Si address@hidden anche scaricare la distribuzione del sorgente di
@command{gawk}
+dal deposito Git ufficiale; per maggiori informazioni, si veda
address@hidden ai sorgenti}.
+
address@hidden Scompattazione
address@hidden Scompattare la distribuzione
address@hidden @`e distribuito sotto forma di parecchi file @code{tar}
+compressi con differenti programmi di compressione: @command{gzip},
address@hidden
+e @command{xz}. Per amor di address@hidden, il resto di queste istruzioni
+presuppone che si stia usando quella compressa col programma GNU Gzip
+(@command{gzip}).
+
+Una volta che si ha a disposizione la distribuzione (p.es.,
address@hidden@address@hidden),
+va usato @code{gzip} per scompattare il file e quindi @code{tar} per estrarne i
+file. Si address@hidden usare la seguente @dfn{pipe} per produrre la
distribuzione
address@hidden:
+
address@hidden
+gzip -d -c address@hidden@value{PATCHLEVEL}.tar.gz | tar -xvpf -
address@hidden example
+
+In un sistema che abbia la versione GNU di @command{tar}, si
address@hidden far effettuare la scompattazione direttamente a @command{tar}:
+
address@hidden
+tar -xvpzf address@hidden@value{PATCHLEVEL}.tar.gz
address@hidden example
+
address@hidden
+L'estrazione dei file dall'archivio
+crea una directory di nome @address@hidden@value{PATCHLEVEL}}
+nella directory corrente.
+
+Il @value{FN} della distribuzione @`e nella forma
address@hidden@address@hidden@var{P}.tar.gz}.
+La @var{V} rappresenta la versione maggiore di @command{gawk},
+la @var{R} rappresenta il rilascio corrente della versione @var{V}, e
+la @var{P} rappresenta un @dfn{patch level}, che sta a indicare che
+correzioni a errori minori sono state incluse nel rilascio.
+Il @dfn{patch level} corrente @`e @value{PATCHLEVEL}, ma quando ci si procura
+una distribuzione, address@hidden ottenuta quella con il livello
address@hidden alto di
+versione, rilascio e @dfn{patch}.
+(Si noti, comunque, che livelli di @dfn{patch} maggiori o uguali a 70
+denotano versioni ``beta'', ossia versioni non destinate a essere usate
+in produzione; non si dovrebbero utilizzare tali versioni, se non si @`e
+disposti a sperimentare.)
+Se non si sta usando un sistema Unix o GNU/Linux, i modi per ottenere
+e scompattare la distribuzione di @command{gawk} sono differenti.
+Si dovrebbe sentire un esperto di quel sistema.
+
address@hidden Contenuti della distribuzione
address@hidden Contenuti della distribuzione @command{gawk}
address@hidden @command{gawk}, distribuzione di
address@hidden distribuzione di @command{gawk}
+
+La distribuzione di @command{gawk} contiene un certo numero di file
+sorgente in C, di file di documentazione, di sottodirectory, e di file
+utilizzati durante il processo di configurazione
+(@pxref{Installazione Unix}),
+come pure parecchie sottodirectory relative a diversi sistemi operativi
+non-Unix:
+
address@hidden @asis
address@hidden Vari file @samp{.c}, @samp{.y} e @samp{.h}
+Questi file contengono il codice sorgente vero e proprio di @command{gawk}.
address@hidden table
+
address@hidden @file
address@hidden support/*
+Intestazioni C e file sorgente per routine che @command{gawk}
+usa, ma che non sono parte della sua address@hidden
+fondamentale. Per esempio, analisi di argomenti, controlli
+di corrispondenze di espressioni regolari, e routine per
+generare numeri casuali sono tutti mantenuti qui.
+
address@hidden ABOUT-NLS
+Un file contenente informazioni sul comando GNU @command{gettext} e
+sulle traduzioni.
+
address@hidden AUTHORS
+Un file con alcune informazioni su chi ha scritto @command{gawk}.
+Esiste solo per placare i pedanti della Free Software Foundation.
+
address@hidden README
address@hidden README_d/README.*
+File descrittivi: vari @file{README} ("leggimi") per @command{gawk} sotto Unix
e per
+tutte le varie altre combinazioni hardware e software.
+
address@hidden INSTALL
+Un file che fornisce una panoramica sul processo di configurazione e
installazione.
+
address@hidden ChangeLog
+Una lista dettagliata delle modifiche apportate al codice sorgente,
+ai problemi risolti e ai miglioramenti introdotti.
+
address@hidden ChangeLog.0
+Una lista meno recente di modifiche al codice sorgente.
+
address@hidden NEWS
+Una lista di modifiche a @command{gawk} a partire dall'ultimo rilascio
+o @dfn{patch}.
+
address@hidden NEWS.0
+Una lista meno recente di modifiche a @command{gawk}.
+
address@hidden COPYING
+La @dfn{GNU General Public License}.
+
address@hidden POSIX.STD
+Una descrizione di comportamenti nello standard POSIX per @command{awk} che
+sono lasciati indefiniti, o ai quali @command{gawk} non address@hidden
conformarsi
+pienamente, come pure una lista di specifiche che lo standard POSIX dovrebbe
+contenere, ma che non sono presenti.
+
address@hidden intelligenza artificiale, @command{gawk} e
address@hidden @command{gawk} e l'intelligenza artificiale
address@hidden doc/awkforai.txt
+Puntatori alla bozza originale di un breve articolo
+che spiega perch@'e @command{gawk} @`e un linguaggio adatto alla
+programmazione nel campo dell'intelligenza artificiale (AI).
+
address@hidden doc/bc_notes
+Una breve descrizione della struttura interna a livello di byte di
address@hidden [``byte code''].
+
address@hidden doc/README.card
address@hidden doc/ad.block
address@hidden doc/awkcard.in
address@hidden doc/cardfonts
address@hidden doc/colors
address@hidden doc/macros
address@hidden doc/no.colors
address@hidden doc/setter.outline
+Il sorgente @command{troff} per una scheda di riferimento a cinque colori
+di @command{awk}.
+Per ottenere la versione a colori @`e richiesta una versione recente di
address@hidden, come la versione GNU di @command{troff} (@command{groff}).
+Si veda il file @file{README.card} per istruzioni su come comportarsi se @`e
+disponibile solo una versione address@hidden vecchia di @command{troff}.
+
address@hidden doc/gawk.1
+Il sorgente @command{troff} di una pagina di manuale address@hidden
+che descrive @command{gawk}.
+Questa pagina @`e distribuita a beneficio degli utenti Unix.
+
address@hidden Texinfo
address@hidden doc/gawktexi.in
address@hidden doc/sidebar.awk
+Il file sorgente Texinfo di questo @value{DOCUMENT}.
+Dovrebbe venire elaborato da @file{doc/sidebar.awk}
+prima di essere elaborato con @command{texi2dvi} o @command{texi2pdf}
+per produrre un documento stampato, o
+con @command{makeinfo} per produrre un file Info o HTML.
+Il @file{Makefile} si occupa di questa elaborazione e produce
+la versione stampabile tramite i comandi
address@hidden o @command{texi2pdf}.
+
address@hidden doc/gawk.texi
+Il file prodotto elaborando @file{gawktexi.in}
+tramite @file{sidebar.awk}.
+
address@hidden doc/gawk.info
+Il file Info generato per questo @value{DOCUMENT}.
+
address@hidden doc/gawkinet.texi
+Il file sorgente Texinfo per
address@hidden
address@hidden, , Introduzione generale, gawkinet, @value{GAWKINETTITLE}}.
address@hidden ifinfo
address@hidden
address@hidden@value{GAWKINETTITLE}}.
address@hidden ifnotinfo
+Dovrebbe venire elaborato con @TeX{}
+(tramite @command{texi2dvi} o @command{texi2pdf})
+per produrre un documento stampato o
+con @command{makeinfo} per produrre un file Info o HTML.
+
address@hidden doc/gawkinet.info
+Il file Info generato per
address@hidden@value{GAWKINETTITLE}}.
+
address@hidden doc/igawk.1
+Il sorgente @command{troff} per una pagina di manuale relativa al
+programma @command{igawk} descritto
address@hidden
+in
address@hidden ifnottex
address@hidden
+nella
address@hidden iftex
address@hidden igawk}.
+(Poich@'e @command{gawk} prevede ora internamente l'uso della direttiva
address@hidden@@include},
+n@'e @command{igawk} n@'e @file{igawk.1} sono effettivamente installati.)
+
address@hidden doc/Makefile.in
+Il file in input usato durante la procedura di configurazione per
+generare l'effettivo @file{Makefile} da usare per creare la documentazione.
+
address@hidden Makefile.am
address@hidden */Makefile.am
+File usati dal software GNU Automake per generare
+il file @file{Makefile.in} usato da Autoconf e dallo script
address@hidden
+
address@hidden Makefile.in
address@hidden aclocal.m4
address@hidden bisonfix.awk
address@hidden config.guess
address@hidden configh.in
address@hidden configure.ac
address@hidden configure
address@hidden custom.h
address@hidden depcomp
address@hidden install-sh
address@hidden missing_d/*
address@hidden mkinstalldirs
address@hidden m4/*
+Questi file e sottodirectory sono usati per configurare e compilare
address@hidden per vari sistemi Unix. L'uso di molti tra questi file @`e
spiegato
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden Unix}. I rimanenti hanno una funzione di supporto
+per l'infrastruttura.
+
address@hidden po/*
+La directory @file{po} contiene la traduzione in varie lingue
+dei messaggi emessi da @command{gawk}.
+
address@hidden awklib/extract.awk
address@hidden awklib/Makefile.am
address@hidden awklib/Makefile.in
address@hidden awklib/eg/*
+La directory @file{awklib} contiene una copia di @file{extract.awk}
+(@pxref{Programma extract}),
+che address@hidden essere usato per estrarre i programmi di esempio dal file
sorgente
+Texinfo di questo @value{DOCUMENT}. Contiene anche un file
address@hidden, che
address@hidden usa per generare un @file{Makefile}.
address@hidden @`e usato da GNU Automake per creare @file{Makefile.in}.
+Le funzioni di libreria descritte
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria},
+sono incluse come file pronti per l'uso nella distribuzione @command{gawk}.
+Essi sono installati come parte della procedura di installazione.
+I rimanenti programmi contenuti in questo @value{DOCUMENT} sono disponibili
+nelle appropriate sottodirectory di @file{awklib/eg}.
+
address@hidden extension/*
+Il codice sorgente, le pagine di manuale, e i file di infrastruttura per
+gli esempi di estensione incluse con @command{gawk}.
address@hidden dinamiche}, per ulteriori dettagli.
+
address@hidden extras/*
+Ulteriori file, non-essenziali. Al momento, questa directory contiene
+alcuni file da eseguire al momento di iniziare una sessione,
+da installare nella directory @file{/etc/profile.d}
+per essere di aiuto nella gestione delle variabili di ambiente
address@hidden e @env{AWKLIBPATH}.
address@hidden da usare a inizio sessione}, per ulteriori informazioni.
+
address@hidden posix/*
+File necessari per compilare @command{gawk} su sistemi conformi allo
+standard POSIX.
+
address@hidden pc/*
+File necessari per compilare @command{gawk} sotto MS-Windows
+(@pxref{Installazione su PC} per i dettagli).
+
address@hidden vms/*
+File necessari per compilare @command{gawk} sotto Vax/VMS e OpenVMS
+(@pxref{Installazione su VMS} per i dettagli).
+
address@hidden test/*
+Una serie di test per
address@hidden Si address@hidden usare @samp{make check} dalla directory
principale
+di @command{gawk} per provare se la serie di test funziona con la
+versione in uso di @command{gawk}.
+Se @command{gawk} supera senza errori @samp{make check}, si address@hidden
essere
+sicuri che sia stato installato e configurato correttamente su un dato
+sistema.
address@hidden table
+
address@hidden Installazione Unix
address@hidden Compilare e installare @command{gawk} su sistemi di tipo Unix
+
+Normalmente, si address@hidden compilare e installare @command{gawk} immettendo
+solo un paio di comandi. Comunque, se si ci si trova in un sistema
+insolito, address@hidden essere necessario
+dover configurare @command{gawk} per quel dato sistema.
+
address@hidden
+* Installazione veloce:: Compilare @command{gawk} sotto Unix.
+* File da usare a inizio sessione:: Funzioni di personalizzazione della
+ shell.
+* Ulteriori opzioni di configurazione:: Altre opzioni utilizzabili in fase di
+ compilazione.
+* Filosofia della configurazione:: Come si suppone che tutto funzioni.
address@hidden menu
+
address@hidden Installazione veloce
address@hidden Compilare @command{gawk} per sistemi di tipo Unix
+
+Questi normali passi di installazione dovrebbero essere sufficienti in
+tutti i moderni sistemi in commercio derivati da Unix, ossia
+GNU/Linux, sistemi basati su BSD, e l'ambiente Cygwin sotto MS-Windows.
+
+Dopo aver estratto la distribuzione di @command{gawk}, posizionarsi con
address@hidden nella directory
address@hidden@address@hidden Come per la maggior parte dei
+programmi GNU, occorre configurare @command{gawk} per il sistema in uso,
+eseguendo il programma @command{configure}. Questo programma @`e
+uno script della shell Bourne, che @`e stato generato automaticamente
+usando il comando GNU Autoconf.
address@hidden
+(Il software Autoconf @`e
+descritto in dettaglio in
address@hidden Automatic Configuration Scripts},
+che address@hidden essere trovato in rete sul sito
address@hidden://www.gnu.org/software/autoconf/manual/index.html,
+della Free Software Foundation}.)
address@hidden ifnotinfo
address@hidden
+(Il software Autoconf @`e descritto in dettaglio a partire da
address@hidden, , Autoconf, autoconf,Autoconf---Generating Automatic
Configuration Scripts}.)
address@hidden ifinfo
+
+Per configurare @command{gawk} basta eseguire @command{configure}:
+
address@hidden
+sh ./configure
address@hidden example
+
+Questo produce i file @file{Makefile} e @file{config.h} adatti al sistema
+in uso.
+Il file @file{config.h} descrive varie situazioni relative al sistema in uso.
address@hidden possibile modificare il @file{Makefile} per
+cambiare la variabile @code{CFLAGS}, che controlla
+le opzioni di riga di comando da passare al compilatore C (come i livelli
+di ottimizzazione o la richiesta di generare informazioni per il @dfn{debug}).
+
+In alternativa, si possono specificare dei valori a piacere per
+molte delle variabili di @command{make} sulla riga di comando,
+come @code{CC} e @code{CFLAGS}, quando
+ si chiama il programma
address@hidden:
+
address@hidden
+CC=cc CFLAGS=-g sh ./configure
address@hidden example
+
address@hidden
+Si veda il file @file{INSTALL} nella distribuzione di @command{gawk} per
+tutti i dettagli.
+
+Dopo aver eseguito @command{configure} ed eventualmente modificato
address@hidden,
+va dato il comando:
+
address@hidden
+make
address@hidden example
+
address@hidden
+Poco dopo, si dovrebbe avere a disposizione una versione eseguibile
+di @command{gawk}.
+Questo @`e tutto!
+Per verificare se @command{gawk} funziona correttamente,
+va dato il comando @samp{make check}. Tutti i test dovrebbero terminare con
+successo.
+Se questi passi non producono il risultato desiderato, o se qualche
+test fallisce, controllare i file nella directory @file{README_d}
+per determinare se quello che @`e capitato @`e un problema noto.
+Se il problema capitato non @`e descritto address@hidden@dotless{i}},
+inviare una segnalazione di @dfn{bug} (@pxref{Bug}).
+
+Naturalmente, dopo aver compilato @command{gawk}, verosimilmente
address@hidden installato. Per fare address@hidden, occorre eseguire il comando
address@hidden install}, disponendo delle autorizzazioni necessarie.
+Come acquisirle varia da sistema a sistema, ma su molti sistemi si
address@hidden
+usare il comando @command{sudo} per ottenerle. Il comando da immettere
+diventa in questo caso @samp{sudo make install}. @`E probabile che sia
+necessario fornire una password, ed essere stati messi nella lista degli
+utenti che possono utilizzare il comando @command{sudo}.
+
address@hidden File da usare a inizio sessione
address@hidden File di inizializzazione della shell
+
+La distribuzione contiene i file da usare a inizio sessione
address@hidden e
address@hidden, che contengono funzioni che possono essere di aiuto
+nel gestire le variabili di ambiente
address@hidden e @env{AWKLIBPATH}.
+Su un sistema Fedora GNU/Linux, questi file dovrebbero essere installati
+nella directory @file{/etc/profile.d};
+su altre piattaforme, la posizione corretta address@hidden essere differente.
+
address@hidden @command
+
address@hidden @command{gawkpath_default}, funzione della shell
address@hidden funzione della shell @command{gawkpath_default}
address@hidden gawkpath_default
+Ripristina la variabile d'ambiente @env{AWKPATH} al suo valore di default.
+
address@hidden @command{gawkpath_prepend}, funzione della shell
address@hidden funzione della shell @command{gawkpath_prepend}
address@hidden gawkpath_prepend
+Aggiunge l'argomento all'inizio della variabile d'ambiente @env{AWKPATH}.
+
address@hidden @command{gawkpath_append}, funzione della shell
address@hidden funzione della shell @command{gawkpath_append}
address@hidden gawkpath_append
+Aggiunge l'argomento alla fine della variabile d'ambiente @env{AWKPATH}.
+
address@hidden @command{gawklibpath_default}, funzione della shell
address@hidden funzione della shell @command{gawklibpath_default}
address@hidden gawklibpath_default
+Reimposta la variabile d'ambiente @env{AWKLIBPATH} al suo valore di default.
+
address@hidden @command{gawklibpath_prepend}, funzione della shell
address@hidden funzione della shell @command{gawklibpath_prepend}
address@hidden gawklibpath_prepend
+Aggiunge l'argomento all'inizio della variabile d'ambiente
address@hidden
+
address@hidden @command{gawklibpath_append}, funzione della shell
address@hidden funzione della shell @command{gawklibpath_append}
address@hidden gawklibpath_append
+Aggiunge l'argomento alla fine della variabile d'ambiente
address@hidden
+
address@hidden table
+
+
address@hidden Ulteriori opzioni di configurazione
address@hidden Ulteriori opzioni di configurazione
address@hidden @command{gawk}, configurazione, opzioni di
address@hidden configurazione di @command{gawk}, opzioni di
+
+Ci sono parecchie altre opzioni che si possono utilizzare sulla riga
+di comando di @command{configure}
+quando si compila @command{gawk} a partire dai sorgenti, tra cui:
+
address@hidden @code
+
address@hidden @option{--disable-extensions}, opzione di configurazione
address@hidden opzione di configurazione @code{--disable-extensions}
address@hidden --disable-extensions
+Richiede di non configurare e generare le estensioni di esempio nella
+directory @file{extension}. Questo @`e utile quando si genera
address@hidden per essere eseguito su un'altra piattaforma.
+L'azione di default @`e di controllare dinamicamente se le estensioni
+possono essere configurate e compilate.
+
address@hidden @option{--disable-lint}, opzione di configurazione
address@hidden opzione di configurazione @code{--disable-lint}
address@hidden --disable-lint
+Disabilita i controlli @dfn{lint} all'interno di @command{gawk}. Le opzioni
address@hidden e @option{--lint-old}
+(@pxref{Opzioni})
+sono accettate, ma non fanno nulla, e non emettono alcun messaggio di
+avvertimento.
+Analogamente, se si imposta la variabile @code{LINT}
+(@pxref{Variabili modificabili dall'utente})
+questa non ha alcun effetto sul programma @command{awk} in esecuzione.
+
+Se si specifica l'opzione del compilatore GNU Compiler Collection (GCC) che
+elimina il codice non eseguito, quest'opzione riduce di quasi
+23K byte la dimensione del programma eseguibile @command{gawk}
+su sistemi GNU/Linux x86_64. I risultati su altri sistemi e con
+altri compilatori sono probabilmente diversi.
+L'uso di questa opzione address@hidden apportare qualche piccolo miglioramento
nei
+tempi di esecuzione di un programma.
+
address@hidden ATTENZIONE
+Se si usa quest'opzione alcuni dei test di address@hidden non avranno successo.
+Quest'opzione address@hidden essere rimossa in futuro.
address@hidden quotation
+
address@hidden @option{--disable-nls}, opzione di configurazione
address@hidden opzione di configurazione @code{--disable-nls}
address@hidden --disable-nls
+Non attiva la traduzione automatica dei messaggi.
address@hidden normalmente non @`e consigliabile, ma address@hidden apportare
qualche lieve
+miglioramento nei tempi di esecuzione di un programma.
+
address@hidden @option{--with-whiny-user-strftime}, opzione di configurazione
address@hidden opzione di configurazione @code{--with-whiny-user-strftime}
address@hidden --with-whiny-user-strftime
+Forza l'uso della versione della funzione C @code{strftime()} inclusa nella
+distribuzione di @command{gawk}, per i sistemi in cui la funzione stessa
+non sia disponibile.
address@hidden table
+
+Si usi il comando @samp{./configure --help} per ottenere la lista completa
+delle opzioni disponibili in @command{configure}.
+
address@hidden Filosofia della configurazione
address@hidden Il processo di configurazione
+
address@hidden @command{gawk}, configurazione di
address@hidden configurazione di @command{gawk}
+Questa @value{SECTION} interessa solo a chi abbia un minimo di address@hidden
con
+il linguaggio C e con i sistemi operativi di tipo Unix.
+
+Il codice sorgente di @command{gawk}, in generale, cerca di aderire, nei limiti
+del possibile, a degli standard formali. address@hidden significa che
@command{gawk} usa
+routine di libreria che sono specificate nello standard ISO C e nello standard
+POSIX per le interfacce dei sistemi operativi. Il codice sorgente di
address@hidden richiede l'uso di un compilatore ISO C (standard 1990).
+
+Molti sistemi Unix non aderiscono completamente n@'e allo standard ISO n@'e a
+quello POSIX. La sottodirectory @file{missing_d} nella distribuzione di
address@hidden contiene delle versioni sostitutive per quelle funzioni che
address@hidden
+frequentemente risultano essere non disponibili.
+
+Il file @file{config.h} creato da @command{configure} contiene definizioni che
+elencano address@hidden del particolare sistema operativo nel quale si tenta di
+compilare @command{gawk}. Le tre cose descritte da questo file sono: quali
+file di intestazione sono disponibili, in modo da poterli includere
correttamente,
+quali funzioni (presumibilmente) standard sono realmente disponibili nelle
+librerie C, e varie informazioni assortite riguardo al sistema operativo
+corrente. Per esempio, address@hidden non esserci l'elemento
@code{st_blksize} nella
+struttura @code{stat}. In questo caso, @samp{HAVE_STRUCT_STAT_ST_BLKSIZE} @`e
+indefinito.
+
address@hidden @code{custom.h}, file
address@hidden possible che il compilatore C del sistema in uso "tragga in
inganno"
address@hidden address@hidden succedere nel caso in cui non viene restituito
+un errore se una funzione di libreria non @`e disponibile. Per superare questo
+problema, si address@hidden modificare il file @file{custom.h}. Basta usare
una direttiva
address@hidden appropriata per il sistema corrente, e definire, tramite
address@hidden, tutte le costanti che @command{configure} avrebbe dovuto
+definire, ma non @`e riuscito a farlo, oppure, usando @code{#undef} annullare
le
+costanti che @command{configure} ha definito, ma non avrebbe dovuto farlo. Il
+file @file{custom.h} @`e automaticamente incluso dal file @file{config.h}.
+
address@hidden anche possibile che il programma @command{configure} generato da
Autoconf non
+funzioni in un dato sistema per una ragione differente. Se c'@`e un problema,
si
+tenga presente che il file @file{configure.ac} @`e quello preso in input da
+Autoconf. @`E possibile modificare questo file e generare una nuova versione
di
address@hidden che funzioni sul sistema corrente (@pxref{Bug} per
+informazioni su come segnalare problemi nella configurazione di
address@hidden). Lo stesso meccanismo si address@hidden usare per inviare
aggiornamenti
+al file @file{configure.ac} e/o a @file{custom.h}.
+
address@hidden Installazione non-Unix
address@hidden Installazione su altri Sistemi Operativi
+
+Questa @value{SECTION} descrive come installare @command{gawk} su
+vari sistemi non-Unix.
+
address@hidden
+* Installazione su PC:: Installare e compilare @command{gawk}
+ su Microsoft Windows.
+* Installazione su VMS:: Installare @command{gawk} su VMS.
address@hidden menu
+
address@hidden Installazione su PC
address@hidden Installazione su MS-Windows
+
address@hidden PC, @command{gawk} su sistemi operativi
address@hidden sistemi operativi per PC, @command{gawk} su
address@hidden installare @command{gawk} su sistemi operativi per PC
+Questa @value{SECTION} tratta dell'installazione e uso di @command{gawk}
+su macchine con architettura Intel che eseguono qualsiasi versione di
+MS-Windows.
+In questa @value{SECTION}, il termine ``Windows32''
+si riferisce a una qualsiasi versione di Microsoft Windows
+95/98/ME/NT/2000/XP/Vista/7/8/10.
+
+Si veda anche il file @file{README_d/README.pc} nella distribuzione.
+
address@hidden
+* Installazione binaria su PC:: Installare una distribuzione pronta
+ all'uso.
+* Compilazione su PC:: Compilare @command{gawk} per Windows32.
+* Uso su PC:: Eseguire @command{gawk} su Windows32.
+* Cygwin:: Compilare ed eseguire @command{gawk}
+ per Cygwin.
+* MSYS:: Usare @command{gawk} nell'ambiente MSYS.
address@hidden menu
+
address@hidden Installazione binaria su PC
address@hidden Installare una distribuzione predisposta per sistemi MS-Windows
+
+La sola distribuzione binaria predisposta supportata per i sistem MS-Windows
address@hidden quella messa a disposizione da Eli Zaretskii
address@hidden://sourceforge.net/projects/ezwinports/, progetto ``ezwinports''}.
+Si parta da address@hidden@dotless{i}} per installare il comando
@command{gawk} precompilato.
+
address@hidden Compilazione su PC
address@hidden Compilare @command{gawk} per sistemi operativi di PC
+
address@hidden address@hidden essere compilato per Windows32, usando MinGW
+(per Windows32).
+Il file @file{README_d/README.pc} nella distribuzione @command{gawk}
+contiene ulteriori annotazioni, e il file @file{pc/Makefile} contiene
+informazioni importanti sulle opzioni di compilazione.
+
address@hidden compilare @command{gawk} per MS-Windows
+Per compilare @command{gawk} per Windows32, occorre copiare i file
+dalla directory @file{pc} (@emph{tranne} il file @file{ChangeLog}) alla
+directory che contiene il resto dei sorgenti di @command{gawk}, e quindi
+chiamare @command{make}, specificando il nome appropriato di obiettivo come
+argomento, per generare @command{gawk}. Il @file{Makefile} copiato dalla
+directory @file{pc} contiene una sezione di configurazione con commenti, e
address@hidden
+essere necessario modificarlo perch@'e funzioni con il programma di
address@hidden
address@hidden corrente.
+
+Il @file{Makefile} contiene un certo numero di alternative, che permettono di
+generare @command{gawk} per diverse
+versioni MS-DOS e Windows32. Se il comando @command{make} @`e richiamato senza
+specificare alcun argomento viene stampata una lista delle alternative
+disponibili. Per esempio,
+per generare un codice binario di @command{gawk} nativo per MS-Windows
+usando gli strumenti MinGW, scrivere @samp{make mingw32}.
+
address@hidden Uso su PC
address@hidden Usare @command{gawk} su sistemi operativi PC
address@hidden PC, @command{gawk} su sistemi operativi
address@hidden sistemi operativi PC, @command{gawk} su
+
+Sotto MS-Windows, gli ambienti Cygwin e MinGW consentono di usare
+sia l'operatore @samp{|&} che le operazioni su rete TCP/IP
+(@pxref{Reti TCP/IP}).
+
address@hidden percorso di ricerca
address@hidden percorso di ricerca per file sorgente
address@hidden @command{gawk}, versione MS-Windows di
address@hidden @code{;} (punto e virgola), @env{AWKPATH} variabile e
address@hidden punto e virgola (@code{;}), @env{AWKPATH} variabile e
address@hidden @env{AWKPATH}, variabile d'ambiente
address@hidden variabile d'ambiente @env{AWKPATH}
+Le versioni MS-Windows di @command{gawk} ricercano i file di
+programma come descritto in @ref{AWKPATH (Variabile)}. Comunque, gli elementi
+della variabile @env{AWKPATH} sono separati tra di loro da un punto e virgola
+(anzich@'e da due punti (@code{:})).
+Se @env{AWKPATH} @`e non impostata o ha per valore la stringa nulla, il
percorso
+di ricerca di default @`e @address@hidden;c:/lib/awk;c:/gnu/lib/awk}}.
+
address@hidden estensioni comuni, variabile @code{BINMODE}
address@hidden @cindex extensions, address@hidden @code{BINMODE} variable
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{BINMODE}
address@hidden @code{BINMODE}, variabile
address@hidden variabile @code{BINMODE}
+Sotto MS-Windows,
address@hidden (come molti altri programmi di trattamento testi) converte
+automaticamente la stringa di fine riga @samp{\r\n} in @samp{\n} leggendo
dall'input
+e @samp{\n} in @samp{\r\n} scrivendo sull'output.
+La variabile speciale @code{BINMODE} @value{COMMONEXT} permette di controllare
+come avvengono queste conversioni, ed @`e interpretata come segue:
+
address@hidden @value{BULLET}
address@hidden
+Se @code{BINMODE} @`e @code{"r"} o uno,
+la address@hidden binaria @`e impostata
+in lettura (address@hidden, nessuna conversione in lettura).
+
address@hidden
+Se @code{BINMODE} @`e @code{"w"} o due,
+la address@hidden binaria @`e impostata
+in scrittura (address@hidden, nessuna conversione in scrittura).
+
address@hidden
+Se @code{BINMODE} @`e @code{"rw"} o @code{"wr"} o tre,
+la address@hidden binaria @`e impostata sia in lettura che in scrittura.
+
address@hidden
address@hidden@var{stringa-non-nulla}} equivale a specificare
address@hidden (address@hidden, nessuna conversione in
+lettura e scrittura). Tuttavia, @command{gawk} emette un messaggio di
+avviso se la stringa non @`e @code{"rw"} o @code{"wr"}.
address@hidden itemize
+
address@hidden
+La address@hidden di trattamento dello standard input e standard output sono
+impostate una volta sola
+(dopo aver letto la riga di comando, ma prima di iniziare a elaborare
+qualsiasi programma @command{awk}).
+L'impostazione di @code{BINMODE} per standard input o
+standard output va fatta usando
+un'appropriata opzione @samp{-v address@hidden sulla riga di comando.
address@hidden @`e impostato nel momento in cui un file o @dfn{pipe} @`e aperto
+e non address@hidden essere cambiato in corso di elaborazione.
+
+Il nome @code{BINMODE} @`e stato scelto in analogia con @command{mawk}
+(@pxref{Altre versioni}).
address@hidden e @command{gawk} gestiscono @code{BINMODE} in maniera simile;
+tuttavia, @command{mawk} prevede un'opzione @samp{-W address@hidden e una
+variabile d'ambiente che address@hidden impostare @code{BINMODE}, @code{RS}, e
@code{ORS}.
+I file @file{binmode[1-3].awk} (nella directory @file{gnu/lib/awk} in alcune
+delle distribuzioni binarie address@hidden predisposte) sono stati inclusi per
rendere
+disponibile l'opzione di @command{mawk} @samp{-W address@hidden Questi
+possono essere modificati o ignorati; in particolare, quale sia l'impostazione
+di @code{RS} che address@hidden meno ``sorprese'' rimane una questione aperta.
address@hidden usa @samp{RS = "\r\n"} se si imposta la address@hidden binaria in
+lettura, il che @`e appropriato per file che abbiano i caratteri di fine riga
in
+stile MS-DOS.
+
+Per chiarire, gli esempi seguenti impostano la address@hidden binaria in
+scrittura per lo standard output e altri file, e impostano @code{ORS} in modo
+da ottenere la fine riga ``normale'' in stile MS-DOS:
+
address@hidden
+gawk -v BINMODE=2 -v ORS="\r\n" @dots{}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+gawk -v BINMODE=w -f binmode2.awk @dots{}
address@hidden example
+
address@hidden
+Questi comandi danno lo stesso risultato dell'opzione
address@hidden BINMODE=2} in @command{mawk}.
+Quanto segue modifica il separatore di record a @code{"\r\n"} e imposta
+la address@hidden binaria in lettura, senza modificare le letture da standard
input:
+
address@hidden
+gawk -v RS="\r\n" -e "BEGIN @{ BINMODE = 1 @}" @dots{}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+gawk -f binmode1.awk @dots{}
address@hidden example
+
address@hidden
+Usando i caratteri di protezione appropriati, nel primo
+esempio l'impostazione di @code{RS} address@hidden essere spostata in una
regola
address@hidden
+
address@hidden Cygwin
address@hidden Usare @command{gawk} in ambiente Cygwin
address@hidden compilare @command{gawk} per Cygwin
address@hidden Cygwin, compilare @command{gawk} per
+
address@hidden address@hidden essere compilato e usato
address@hidden@dotless{i}} com'@`e'' sotto MS-Windows se
+si opera all'interno dell'ambiente @uref{http://www.cygwin.com, Cygwin}.
+Questo ambiente consente un'eccellente simulazione di GNU/Linux, con l'uso di
+Bash, GCC, GNU Make, e altri programmi GNU. La compilazione e l'installazione
+per Cygwin @`e la stessa usata nei sistemi di tipo Unix:
+
address@hidden
+tar -xvpzf address@hidden@value{PATCHLEVEL}.tar.gz
+cd address@hidden@value{PATCHLEVEL}
+./configure
+make && make check
address@hidden example
+
+In confronto a un sistema GNU/Linux sulla stessa macchina, l'esecuzione
+del passo di @samp{configure} sotto Cygwin richiede molto address@hidden
tempo. Tuttavia
+si conclude regolarmente, e poi @samp{make} funziona come ci si aspetta.
+
address@hidden MSYS
address@hidden Usare @command{gawk} in ambiente MSYS
+
+Nell'ambiente MSYS sotto MS-Windows, @command{gawk} automaticamente usa la
address@hidden binaria per leggere e scrivere file. Non @`e quindi necessario
usare la
+variabile @code{BINMODE}.
+
+Questo address@hidden causare problemi con altri componenti di tipo Unix che
sono stati
+resi disponibile in MS-Windows, che si aspettano che @command{gawk} faccia
+automaticamente la conversione di @code{"\r\n"}, mentre
address@hidden@dotless{i}} non @`e.
+
address@hidden Installazione su VMS
address@hidden Compilare e installare @command{gawk} su Vax/VMS e OpenVMS
+
address@hidden based on material from Pat Rankin <address@hidden>
address@hidden now address@hidden
address@hidden now address@hidden
+
address@hidden @command{gawk}, versione VMS di
address@hidden installare @command{gawk} su VMS
address@hidden VMS, installare @command{gawk} su
+Questa @value{SUBSECTION} descrive come compilare e installare @command{gawk}
+sotto VMS. Il termine classico ``VMS'' @`e usato qui anche per designare
+OpenVMS.
+
address@hidden
+* Compilazione su VMS:: Come compilare @command{gawk} su VMS.
+* Estensioni dinamiche su VMS:: Compilare estensioni dinamiche
+ di @command{gawk} su VMS.
+* Dettagli installazione su VMS:: Come installare @command{gawk} su VMS.
+* Esecuzione su VMS:: Come eseguire @command{gawk} su VMS.
+* GNV su VMS:: Il progetto VMS GNV.
+* Vecchio Gawk su VMS:: Una versione non aggiornata arriva
+ con alcune versioni di VMS.
address@hidden menu
+
address@hidden Compilazione su VMS
address@hidden Compilare @command{gawk} su VMS
address@hidden compilare @command{gawk} per VMS
address@hidden VMS, compilare @command{gawk} per
+
+Per compilare @command{gawk} sotto VMS, esiste una procedura di comandi
address@hidden che esegue tutti i comandi @code{CC} e @code{LINK} necessari.
C'@`e
+anche un @file{Makefile} da usare con i programmi di address@hidden @code{MMS}
e
address@hidden A partire della directory che contiene i file sorgente, si usi:
+
address@hidden
+$ @kbd{@@[.vms]vmsbuild.com}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+$ @kbd{MMS/DESCRIPTION=[.vms]descrip.mms gawk}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+$ @kbd{MMK/DESCRIPTION=[.vms]descrip.mms gawk}
address@hidden example
+
+Il comando @command{MMK} @`e un quasi-clone, a codice aperto e gratuito, di
address@hidden, che gestisce in maniera migliore i volumi ODS-5 con @value{FNS}
+a caratteri maiuscoli e minuscoli. @command{MMK} @`e disponibile da
address@hidden://github.com/endlesssoftware/mmk}.
+
+Avendo a che fare con volumi ODS-5 e con l'analisi sintattica estesa abilitata,
+il nome del parametro che specifica l'obiettivo address@hidden dover essere
scritto
+digitando esattamente le lettere maiuscole e minuscole.
+
address@hidden @`e stato testato sotto VAX/VMS 7.3 e Alpha/VMS 7.3-1 usando il
+compilatore Compaq C V6.4, e sotto Alpha/VMS 7.3, Alpha/VMS 7.3-2, e IA64/VMS
+8.3. Le compilazioni address@hidden recenti hanno usato il compilatore HP C
V7.3 su Alpha
+VMS 8.3 e su VMS 8.4, sia Alpha che IA64, hanno usato il compilatore HP C
address@hidden'architettura IA64 @`e anche nota come ``Itanium''.}
+
address@hidden su VMS} per informazioni su come compilare
address@hidden come un kit PCSI compatible con il prodotto GNV.
+
address@hidden Estensioni dinamiche su VMS
address@hidden Compilare estensioni dinamiche di @command{gawk} in VMS
+
+Le estensioni che sono state rese disponibile su VMS possono essere
+costruite dando uno dei comandi seguenti:
+
address@hidden
+$ @kbd{MMS/DESCRIPTION=[.vms]descrip.mms extensions}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+$ @kbd{MMK/DESCRIPTION=[.vms]descrip.mms extensions}
address@hidden example
+
address@hidden usa @code{AWKLIBPATH} come una variabile d'ambiente
+oppure come un nome logico per trovare le estensioni dinamiche.
+
+Le estensioni dinamiche devono essere compilate con le stesse opzioni del
+compilatore usate per compilare @command{gawk} riguardanti numeri in virgola
+mobile, dimensione dei puntatori e trattamento dei nomi simbolici. I computer
+con architettura Alpha e Itanium dovrebbero usare i numeri in virgola mobile
+col formato IEEE. La dimensione dei puntatori @`e 32 bit, e il trattamento
dei nomi
+simbolici dovrebbe richiedere il rispetto esatto di maiuscole/minuscole, con le
+abbreviazioni CRC per simboli address@hidden lunghi di 32 bit.
+
+Per Alpha e Itanium:
+
address@hidden
+/name=(as_is,short)
+/float=ieee/ieee_mode=denorm_results
address@hidden example
+
+Per VAX:
+
address@hidden
+/name=(as_is,short)
address@hidden example
+
+Le macro da usare al momento della compilazione devono essere definite prima di
+includere il primo file di intestazione proveniente da VMS, come segue:
+
address@hidden
+#if (__CRTL_VER >= 70200000) && !defined (__VAX)
+#define _LARGEFILE 1
+#endif
+
+#ifndef __VAX
+#ifdef __CRTL_VER
+#if __CRTL_VER >= 80200000
+#define _USE_STD_STAT 1
+#endif
+#endif
+#endif
address@hidden example
+
+Se si scrivono delle estensioni utente da eseguire su VMS, vanno fornite anche
+queste definizioni. Il file @file{config.h} creato quando si compila
address@hidden su VMS lo fa address@hidden; se invece si usa qualche altro file
simile,
+occorre ricordarsi di includerlo prima di qualsiasi file di intestazione
+proveniente da VMS.
+
address@hidden Dettagli installazione su VMS
address@hidden Installare @command{gawk} su VMS
+
+Per usare @command{gawk}, tutto address@hidden che serve @`e un comando
``esterno'', che @`e
+un simbolo @code{DCL} il cui valore inizia col segno del dollaro.
+Per esempio:
+
address@hidden
+$ @kbd{GAWK :== $disk1:[gnubin]gawk}
address@hidden example
+
address@hidden
+Si sostituisca la posizione corrente di @command{gawk.exe} a
address@hidden:[gnubin]}. Il simbolo dovrebbe essere posto nel file
address@hidden di ogni utente che desideri eseguire @command{gawk},
+in modo che sia definito ogni volta che l'utente inizia una sessione.
+Alternativamente, il simbolo address@hidden essere messo nella procedura di
sistema
address@hidden,
+in modo da permettere a tutti gli utenti di eseguire @command{gawk}.
+
+Se @command{gawk} @`e stato installato da un kit PCSI nell'albero di
+directory @file{GNV$GNU:}, il programma address@hidden come nome
address@hidden:[bin]gnv$gawk.exe}, e il file di aiuto address@hidden chiamato
address@hidden:[vms_help]gawk.hlp}.
+
+Il kit PCSI installa anche un file @file{GNV$GNU:[vms_bin]gawk_verb.cld}
+che address@hidden essere usato per aggiungere @command{gawk} e @command{awk}
+alla lista dei comandi DCL.
+
+Per farlo solo nella sessione corrente si address@hidden usare:
+
address@hidden
+$ @kbd{set command gnv$gnu:[vms_bin]gawk_verb.cld}
address@hidden example
+
+Oppure il sistemista VMS address@hidden usare
@file{GNV$GNU:[vms_bin]gawk_verb.cld} per
+aggiungere @command{gawk} e @command{awk} alla tabella @samp{DCLTABLES}
+valida per tutto il sistema.
+
+La sintassi DCL @`e documentata nel file @file{gawk.hlp}.
+
+In alternativa, l'elemento @file{gawk.hlp} address@hidden essere caricato in
una
+libreria di aiuto VMS:
+
address@hidden
+$ @kbd{LIBRARY/HELP sys$help:helplib [.vms]gawk.hlp}
address@hidden example
+
address@hidden
+(Una libreria specifica dell'installazione potrebbe venir usata invece
+della libreria standard VMS library @samp{HELPLIB}.) Dopo aver installato
+il testo di aiuto, il comando:
+
address@hidden
+$ @kbd{HELP GAWK}
address@hidden example
+
address@hidden
+fornisce informazioni sia sull'implementazione di @command{gawk}
+sia sul linguaggio di programmazione @command{awk}.
+
+Il nome logico @samp{AWK_LIBRARY} address@hidden designare una posizione di
default per i
+file di programma @command{awk}. Riguardo all'opzione @option{-f}, se il
address@hidden specificato non contiene un dispositivo o un percorso di
directory,
address@hidden cerca dapprima nella directory corrente, poi nella directory
+specificata dalla traduzione di @samp{AWK_LIBRARY} se il file non @`e stato
+trovato. Se, dopo aver cercato in entrambe queste directory, il file non @`e
+ancora stato trovato, @command{gawk} appone il suffisso @samp{.awk} al
address@hidden e ritenta la ricerca del file. Se @samp{AWK_LIBRARY} non @`e
+definita, si usa per essa il valore di default @samp{SYS$LIBRARY:}.
+
address@hidden Esecuzione su VMS
address@hidden Eseguire @command{gawk} su VMS
+
+L'elaborazione della riga di comando e le convenzioni per proteggere i
+caratteri sono significativamente differenti in VMS, e quindi gli esempi
+presenti in questo @value{DOCUMENT} o provenienti da altre fonti necessitano
+piccole modifiche. Le modifiche, tuttavia, @emph{sono} veramente piccole, e
+tutti i programmi @command{awk} dovrebbero funzionare correttamente.
+
+Ecco un paio di semplici test:
+
address@hidden
+$ @kbd{gawk -- "BEGIN @{print ""Hello, World!""@}"}
+$ @kbd{gawk -"W" version}
+! ma anche -"W version" o "-W version"
address@hidden example
+
address@hidden
+Si noti che il testo con caratteri maiuscoli e misti maiuscoli/minuscoli
+dev'essere incluso tra doppi apici.
+
+La versione VMS di @command{gawk} comprende un'interfaccia in stile @code{DCL},
+oltre a quella originale, di tipo shell (si veda il file di aiuto per ulteriori
+dettagli). Un effetto indesiderato della duplice analisi della riga
+di comando @`e che se c'@`e solo un unico parametro (come nel programma con le
+righe contenenti doppi apici), il comando diviene ambiguo. Per evitare questo
+inconveniente, il flag, normalmente non necessario, @option{--} @`e necessario
+per forzare un esame dei parametri in stile Unix, piuttosto che nella
address@hidden
address@hidden Se qualsiasi altra opzione preceduta dal segno @option{-} (o
address@hidden
+parametri, per esempio, address@hidden @value{DF} in input) @`e presente, non
c'@`e address@hidden,
+e l'opzione @option{--} address@hidden essere omessa.
+
address@hidden exit, codice di ritorno, in VMS
+Il valore di @code{exit} @`e un valore in stile Unix e viene trasformato in
+una condizione VMS all'uscita del programma.
+
+I bit di address@hidden di VMS saranno impostati a partire dal valore
dell'istruzione
address@hidden Un errore grave @`e indicato da 1, e VMS imposta la condizione
address@hidden Un errore fatale @`e indicato da 2, e VMS imposta la condizione
address@hidden Ogni altro valore imposta la condizione @code{SUCCESS}. Il
+valore d'uscita @`e codificato per aderire agli standard di codifica VMS e
address@hidden
+un @code{C_FACILITY_NO} di @code{0x350000} con il codice costante @code{0xA000}
+aggiunto al numero spostato a sinistra di 3 bit per far posto al codice di
address@hidden
+
+Per estrarre il codice reale di ritorno dell'istruzione @code{exit}
+di @command{gawk} dalla condizione impostata da VMS, si usi:
+
address@hidden
+unix_status = (vms_status .and. %x7f8) / 8
address@hidden example
+
address@hidden
+Un programma C che usa @code{exec()} per chiamare @command{gawk}
address@hidden il valore originale della exit in stile Unix.
+
+Precedenti versioni di @command{gawk} per VMS consideravano un codice di
+ritorno a Unix di 0 come 1, un errore come 2, un errore fatale come 4, e tutti
+gli altri valori erano restituiti immodificati. Questa era una violazione
+rispetto alle specifiche di codifica delle condizioni di uscita di VMS.
+
address@hidden numeri in virgola mobile, VAX/VMS
address@hidden VAX/VMS, numeri in virgola mobile,
+L'aritmetica in virgola mobile VAX/VMS usa un arrotondamento statistico.
address@hidden round}.
+
+VMS restituisce data e ora in formato GMT, a meno che non siano stati impostati
+i nomi logici @code{SYS$TIMEZONE_RULE} o @code{TZ}. Precedenti versioni di
+VMS, come VAX/VMS 7.3, non impostano questi nomi logici.
+
address@hidden @cindex directory search
address@hidden @cindex path, search
address@hidden percorso di ricerca
address@hidden percorso di ricerca per file sorgente
+Il percorso di ricerca di default, nella ricerca dei file di programma per
address@hidden specificati dall'opzione @option{-f}, @`e
address@hidden"SYS$DISK:[],AWK_LIBRARY:"}. Il nome logico @env{AWKPATH}
address@hidden essere
+usato per sostituire questo di default. Il formato di @env{AWKPATH} @`e una
lista
+di directory, separate da virgola. Nel definirla, il valore dovrebbe essere
+incluso tra doppi apici, in modo che consenta una sola traduzione, e non una
+lista di ricerca multitraduzione @code{RMS}.
+
address@hidden ridirezione in VMS
+
+Questa restrizione vale anche se si esegue @command{gawk} sotto GNV,
+in quanto la ridirezione @`e sempre verso un comando DCL.
+
+Se si ridirigono dati verso un comando o un programma di address@hidden VMS,
+l'implementazione corrente richiede la creazione di un comando VMS esterno che
+esegua un file di comandi, prima di invocare @command{gawk}.
+(Questa restrizione potrebbe essere rimossa in una futura versione di
address@hidden per VMS.)
+
+Senza un tale file di comandi, i dati in input saranno presenti anche
+in output, prima dei dati di output veri e propri.
+
address@hidden consente la simulazione di comandi POSIX non disponibili in VMS
+o l'uso di programmi di address@hidden GNV.
+
+L'esempio seguente mostra come ridirigere dati da @command{gawk} verso il
+comando VMS @command{sort}.
+
address@hidden
+$ sort = "@@device:[dir]vms_gawk_sort.com"
address@hidden example
+
+Il file di comandi deve avere il formato dell'esempio seguente.
+
+La prima riga serve a evitare che i dati in input siano presenti anche
+nell'output. Dev'essere nel formato mostrato nell'esempio.
+
+La riga seguente crea un comando esterno che prevale sul comando esterno
+superiore, che serve a prevenire una ricorsione infinita di file di comandi.
+
+Il penultimo comando ridirige @code{sys$input} su @code{sys$command},
+per poter ottenere i dati che sono ridiretti verso il comando.
+
+L'ultima riga esegue il comando vero e proprio. Dev'essere l'ultimo
+comando, perch@'e i dati ridiretti da @command{gawk} saranno letti
+quando il file di comandi finisce di essere eseguito.
+
address@hidden
+$!'f$verify(0,0)'
+$ sort := sort
+$ define/user sys$input sys$command:
+$ sort sys$input: sys$output:
address@hidden example
+
+
address@hidden GNV su VMS
address@hidden Il progetto VMS GNV
+
+Il pacchetto VMS GNV fornisce un ambiente di sviluppo simile
+a POSIX tramite una collezione di strumenti @dfn{open source}.
+Il @command{gawk} presente nel pacchetto base GNV @`e una vecchia versione.
+Attualmente, il progetto GNV @`e in fase di riorganizzazione, con l'obiettivo
+di offrire pacchetti PCSI separati per ogni componente.
+Si veda @address@hidden://sourceforge.net/p/gnv/wiki/InstallingGNVPackages/}.}
+
+La procedura normale per compilare @command{gawk} produce un programma
+adatto a essere usato con GNV.
+
+Il file @file{vms/gawk_build_steps.txt} nella distribuzione documenta
+la procedura per compilare un pacchetto PCSI compatible con GNV.
+
address@hidden
address@hidden The VMS POSIX product, also known as POSIX for OpenVMS, is long
defunct
address@hidden and building gawk for it has not been tested in many years, but
these
address@hidden old instructions might still work if anyone is still using it.
+
address@hidden VMS POSIX
address@hidden Compilare e usare @command{gawk} su VMS POSIX
+
+Le istruzioni appena viste vanno ignorate, sebbene @file{vms/gawk.hlp}
+dovrebbe ancora essere reso disponibile in una libreria di aiuto.
+L'albero del codice sorgente dovrebbe essere scompattato in un sottosistema
+contenitore di file, e non nel normale @dfn{filesystem} VMS.
+Occorre accertarsi che i due script, @file{configure} e
address@hidden/posix-cc.sh}, siano eseguibile; si usi @samp{chmod +x} per farlo,
+se necessario. Poi vanno eseguiti i seguenti due comandi:
+
address@hidden
+psx> @kbd{CC=vms/posix-cc.sh configure}
+psx> @kbd{make CC=c89 gawk}
address@hidden example
+
address@hidden
+Il primo comando costruisce i file @file{config.h} e @file{Makefile},
+a partire da dei modelli, usando uno script per fare
address@hidden@dotless{i}} che il
+compilatore C soddisfi le aspettative di @command{configure}. Il secondo
+comando compila e collega @command{gawk} chiamando direttamente il
+compilatore C; gli eventuali messaggi di @command{make} che dicono di non
+riuscire a ridefinire @code{CC} vanno ignorati. @command{configure}
+impiega molto tempo a completarsi, ma in compenso continua a fornire
+messaggi che permettono di seguirne l'avanzamento.
+
+Questo @`e stato testato con VAX/VMS V6.2, VMS POSIX V2.0, e DEC C V5.2.
+
+Una volta installato, @command{gawk} funziona come ogni altro programma
+di address@hidden della shell. A differenza della normale versione VMS di
address@hidden, neesuna manipolazione speciale della riga di comando @`e
+necessaria nell'ambiente VMS POSIX.
address@hidden ignore
+
address@hidden Vecchio Gawk su VMS
address@hidden Vecchia versione di @command{gawk} su sistemi VMS
+
+
address@hidden Thanks to "gerard labadie" <address@hidden>
+
+Alcune versioni di VMS includono una vecchia versione di @command{gawk}.
+Per utilizzarla, occorre definire un simbolo, come segue:
+
address@hidden
+$ @kbd{gawk :== $sys$common:[syshlp.examples.tcpip.snmp]gawk.exe}
address@hidden example
+
+La versione appare essere la @value{PVERSION} 2.15.6, che @`e molto vecchia.
+Si raccomanda di compilare e usare la versione corrente.
+
address@hidden Bug
address@hidden Segnalazione di problemi e bug
address@hidden archeologi
address@hidden
address@hidden c'@`e niente di address@hidden pericoloso di un archeologo
annoiato.}
address@hidden Douglas Adams, @cite{Guida galattica per autostoppisti}
address@hidden quotation
address@hidden the radio show, not the book. :-)
+
address@hidden debug, @command{gawk}, segnalare bug
address@hidden risoluzione problemi @command{gawk}, segnalare bug
+Se si incontrano problemi con @command{gawk} o se si ritiene di aver trovato un
+bug, si raccomanda di segnalarlo agli sviluppatori;
+non c'@`e un impegno preciso a intervenire, ma c'@`e una buona address@hidden
che ci
+si sforzi di risolverlo.
+
address@hidden
+* Indirizzo Bug:: Dove inviare le segnalazioni.
+* Usenet:: Dove non inviare le segnalazioni.
+* Manutentori:: Manutentori di version non-*nix.
address@hidden menu
+
address@hidden Indirizzo Bug
address@hidden Segnalare Bug
+
+Prima di segnalare un bug, occorre assicurarsi che sia davvero un bug. La
+documentazione va riletta attentamente, per controllare se dice che @`e
possibile
+fare quel che si sta tentando di fare. Se non @`e chiaro se sia possibile
+fare quella particolare cosa o no, occorre segnalarlo; in questo caso si tratta
+di un bug nella documentazione!
+
+Prima di segnalare un bug o di tentare di risolverlo personalmente, si tenti
+di isolarlo preparando un programma @command{awk} il address@hidden piccolo
possibile, con
+un @value{DF} in input che possa riprodurre il problema. Dopo averlo fatto, si
+spedisca il programma e il @value{DF}, insieme a informazioni sul tipo di
+sistema Unix in uso, il compilatore usato per compilare @command{gawk}, e i
+risultati esatti che @command{gawk} ha prodotto. Inoltre andrebbe specificato
+cosa ci si aspettava che il programma facesse; questo @`e di aiuto per decidere
+se il problema @`e un problema di documentazione.
+
address@hidden importante includere il numero di versione di @command{gawk} in
uso.
+Questa informazione si address@hidden ottenere con il comando @samp{gawk
--version}.
+
address@hidden @code{bug-gawk@@gnu.org} indirizzo per la segnalazione dei bug
address@hidden email, indirizzo per segnalare bug, @code{bug-gawk@@gnu.org}
address@hidden indirizzo email per segnalare bug, @code{bug-gawk@@gnu.org}
address@hidden bug, segnalare, indirizzo email, @code{bug-gawk@@gnu.org}
address@hidden segnalare bug, indirizzo email, @code{bug-gawk@@gnu.org}
+Una volta pronta la descrizione precisa del problema, si spedisca un messaggio
+di posta elettronica a @EMAIL{bug-gawk@@gnu.org,bug-gawk at gnu dot org}.
+
+I manutentori di @command{gawk} sono i destinatari, e riceveranno la
+segnalazione di errore. Sebbene sia possibile spedire messaggi direttamente ai
+manutentori, @`e preferibile usare l'indirizzo sopra fornito perch@'e quella
+mailing list rimane in archivio presso il Progetto GNU. @emph{Tutti i messaggi
+devono essere in inglese. @`E questo il solo linguaggio che tutti i manutentori
+conoscono.} Inoltre, occorre accertarsi di spedire tutti i messaggi in formato
address@hidden, e non (o non soltanto) in formato HTML.
+
address@hidden NOTA
+Molte distribuzioni di GNU/Linux e i vari sistemi operativi basati su
+BSD hanno un loro proprio canale per segnalare i bug. Se si segnala un
+bug usando il canale della distribuzione, una copia del messaggio andrebbe
+inviata anche a @EMAIL{bug-gawk@@gnu.org,bug-gawk at gnu dot org}.
+
+Questo per due ragioni. La prima @`e che, sebbene alcune distribuzioni
inoltrino
+i messaggi sui problemi ``verso l'alto'' alla mailing list GNU, molte non lo
+fanno, e quindi c'@`e una buona address@hidden che i manutentori di
@command{gawk}
+non vedano affatto il messaggio relativo al bug! La seconda ragione @`e che la
+posta diretta alla mailing list GNU @`e archiviata, e il poter disporre di ogni
+cosa all'interno del progetto GNU consente di avere a disposizione tutte le
+informazioni rilevanti senza dover dipendere da altre organizzazioni.
address@hidden quotation
+
+Suggerimenti non correlati a bug sono pure sempre benvenuti. Se si hanno
+domande riguardo a qualcosa di non chiaro nella documentazione o a proposito
+di address@hidden oscure, si scriva alla mailing list dei bug; si
address@hidden
+a essere di aiuto nei limiti del possibile.
+
address@hidden Usenet
address@hidden Non segnalare bug a USENET!
+
address@hidden
address@hidden Date: Sun, 17 May 2015 19:50:14 -0400
address@hidden From: Chet Ramey <address@hidden>
address@hidden Reply-To: address@hidden
address@hidden Organization: ITS, Case Western Reserve University
address@hidden To: Aharon Robbins <address@hidden>
address@hidden CC: address@hidden
+Ho iniziato a ignorare Usenet un paio di anni fa, e non me ne sono mai
+pentito. @`E come quando si parla di sport alla radio---ci si sente
address@hidden intelligenti per aver lasciato perdere.
address@hidden Chet Ramey
address@hidden quotation
+
address@hidden @code{comp.lang.awk} gruppo di discussione
address@hidden newsgroup @code{comp.lang.awk}
address@hidden gruppo di discussione @code{comp.lang.awk}
+Siete pregati di @emph{non} provare a notificare bug di @command{gawk}
+scrivendo al gruppo di discussione Usenet/Internet @code{comp.lang.awk}.
+Sebbene alcuni degli sviluppatori di @command{gawk} leggano talora i
+messaggi di questo gruppo di discussione, il manutentore principale di
address@hidden non lo fa address@hidden Quindi @`e praticamente certo che un
+messaggio inviato address@hidden @emph{non} sia da lui letto.
+La procedura qui descritta @`e la sola maniera ufficialmente riconosciuta
+per notificare problemi. Davvero!
+
address@hidden
+And another one:
+
+Date: Thu, 11 Jun 2015 09:00:56 -0400
+From: Chet Ramey <address@hidden>
+
+My memory was imperfect. Back in June 2009, I wrote:
+
+"That's the nice thing about open source, right? You can take your ball
+and run to another section of the playground. Then, if you like mixing
+metaphors, you can throw rocks from there."
address@hidden ignore
+
address@hidden Manutentori
address@hidden Notificare problemi per versioni non-Unix
+
+Se si riscontrano bug in una delle versioni non-Unix di @command{gawk}, una
+copia del messaggio inviato alla mailing list dei bug andrebbe spedita alla
+persona che si occupa di quella versione. I manutentori sono elencati nella
+lista seguente, come pure nel file @file{README} nella distribuzione
address@hidden Le informazioni nel file @file{README} dovrebbero essere
+considerate come le address@hidden aggiornate, se risultano in conflitto con
questo
address@hidden
+
+Le persone che si occupano delle varie versioni di @command{gawk} sono:
+
address@hidden put the index entries outside the table, for docbook
address@hidden Buening, Andreas
address@hidden Deifik, Scott
address@hidden Malmberg, John E.
address@hidden Pitts, Dave
address@hidden G., Daniel Richard
address@hidden Robbins, Arnold
address@hidden Zaretskii, Eli
address@hidden SMALLPRINT
address@hidden {MS-Windows}
{123456789012345678901234567890123456789001234567890}
address@hidden ifset
address@hidden SMALLPRINT
address@hidden {MS-Windows con MinGW}
{123456789012345678901234567890123456789001234567890}
address@hidden ifclear
address@hidden Unix e sistemi POSIX @tab Arnold Robbins,
@EMAIL{arnold@@skeeve.com,arnold at skeeve dot com}
+
address@hidden @item MS-DOS con DJGPP @tab Scott Deifik,
@EMAIL{scottd.mail@@sbcglobal.net,scottd dot mail at sbcglobal dot net}
+
address@hidden MS-Windows con MinGW @tab Eli Zaretskii,
@EMAIL{eliz@@gnu.org,eliz at gnu dot org}
+
address@hidden Leave this in the document on purpose.
address@hidden OS/2 is not mentioned anywhere else though.
address@hidden OS/2 @tab Andreas Buening,
@EMAIL{andreas.buening@@nexgo.de,andreas dot buening at nexgo dot de}
+
address@hidden VMS @tab John Malmberg, @EMAIL{wb8tyw@@qsl.net,wb8tyw at qsl.net}
+
address@hidden z/OS (OS/390) @tab Daniel Richard G.@:
@EMAIL{skunk@@iSKUNK.ORG,skunk at iSKUNK.ORG}
address@hidden @tab Dave Pitts (Maintainer Emeritus),
@EMAIL{dpitts@@cozx.com,dpitts at cozx dot com}
address@hidden multitable
+
+Se il problema riscontrato @`e riproducibile anche sotto Unix,
+si dovrebbe spedire una copia del messaggio anche alla mailing list
address@hidden@@gnu.org,bug-gawk at gnu dot org}.
+
+La versione generata usando gli strumenti DJGPP non @`e address@hidden
supportata;
+il codice relativo address@hidden nella distribuzione ancora per qualche tempo,
+nel caso che qualche volontario desideri prenderla in carico.
+Se questo non dovesse succedere, la parte di codice relativa questa
+versione address@hidden rimossa dalla distribuzione.
+
address@hidden Altre versioni
address@hidden Altre implementazioni di @command{awk} liberamente disponibili
address@hidden @command{awk}, implementazioni di
address@hidden implementazioni di @command{awk}
address@hidden
+From: emory!amc.com!brennan (Michael Brennan)
+Subject: C++ comments in awk programs
+To: address@hidden (Arnold Robbins)
+Date: Wed, 4 Sep 1996 08:11:48 -0700 (PDT)
+
address@hidden ignore
address@hidden Brennan, Michael
address@hidden
address@hidden
address@hidden@`E piuttosto divertente mettere commenti simili nel vostro
codice awk:address@hidden
+@ @ @ @ @ @ @code{// Funzionano i commenti in stile C++? Risposta:
address@hidden@dotless{i}}! certo}
address@hidden Michael Brennan
address@hidden quotation
address@hidden ifnotdocbook
+
address@hidden
+<blockquote><attribution>Michael Brennan</attribution>
+<literallayout><emphasis>
address@hidden piuttosto divertente mettere commenti simili nel vostro codice
awk.
+</emphasis>
+ <literal>
+// Funzionano i commenti in stile C++? Risposta: address@hidden@dotless{i}}!
certo
+</literal></literallayout>
+</blockquote>
address@hidden docbook
+
+Ci sono alcune altre implementazioni di @command{awk} disponibili
+gratuitamente.
+Questa @value{SECTION} descrive in breve dove @`e possibile trovarle:
+
address@hidden @asis
address@hidden Kernighan, Brian
address@hidden sorgente, codice, Brian Kernighan @command{awk}
address@hidden codice sorgente, Brian Kernighan @command{awk}
address@hidden @command{awk}, versioni di, si veda anche Brian Kernighan,
@command{awk} di
address@hidden Brian Kernighan, @command{awk} di, codice sorgente
address@hidden Unix @command{awk}
+Brian Kernighan, uno degli sviluppatori originali di Unix @command{awk},
+ha reso disponibile liberamente la sua implementazione di @command{awk}.
+Si address@hidden scaricare questa versione dalla
address@hidden://www.cs.princeton.edu/~bwk, sua pagina principale}.
address@hidden disponibile in parecchi formati compressi:
+
address@hidden @asis
address@hidden Archivio Shell
address@hidden://www.cs.princeton.edu/~bwk/btl.mirror/awk.shar}
+
address@hidden File @command{tar} compresso
address@hidden://www.cs.princeton.edu/~bwk/btl.mirror/awk.tar.gz}
+
address@hidden File Zip
address@hidden://www.cs.princeton.edu/~bwk/btl.mirror/awk.zip}
address@hidden table
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
address@hidden anche disponbile in GitHub:
+
address@hidden
+git clone git://github.com/onetrueawk/awk bwkawk
address@hidden example
+
address@hidden
+Questo comando crea una copia del deposito @uref{http://git-scm.com, Git}
+in una directory chiamata @file{bwkawk}. Se si omette questo argomento della
+riga di comando @command{git}, la copia del deposito @`e creata nella
+directory di nome @file{awk}.
+
+Questa versione richiede un compilatore ISO C (standard 1990); il compilatore
+C contenuto in GCC (la collezione di compilatori GNU) @`e address@hidden che
sufficiente.
+
address@hidden comuni}
+per una lista di estensioni in questo @command{awk} che non sono in
+POSIX @command{awk}.
+
+Incidentalmente, Dan Bornstein ha creato un deposito Git che contiene tutte le
+versioni di BWK @command{awk} che @`e riuscito a trovare. @`E disponibile in
address@hidden://github.com/danfuzz/one-true-awk}.
+
address@hidden Brennan, Michael
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden codice sorgente, @command{mawk}
address@hidden @command{mawk}
+Michael Brennan ha scritto un'implementazione indipendente di @command{awk},
+di nome @command{mawk}. @`E disponibile sotto la licenza
address@hidden FOR_PRINT
+GPL (@pxref{Copia}),
address@hidden ifclear
address@hidden FOR_PRINT
+GPL,
address@hidden ifset
+proprio come @command{gawk}.
+
+Il sito di distribuzione originale di @command{mawk} non contiene
address@hidden
+il codice sorgente. Una copia @`e disponibile in
address@hidden://www.skeeve.com/gawk/mawk1.3.3.tar.gz}.
+
+Dal 2009 @`e Thomas Dickey a occuparsi della manutenzione di @command{mawk}.
+Le informazioni di base sono disponibili nella
address@hidden://www.invisible-island.net/mawk, pagine web del progetto}.
+Il puntatore URL da cui scaricare @`e
address@hidden://invisible-island.net/datafiles/release/mawk.tar.gz}.
+
+Una volta scaricato,
+per scompattare questo file address@hidden essere usato @command{gunzip}.
+L'installazione @`e simile a quella di @command{gawk}
+(@pxref{Installazione Unix}).
+
address@hidden comuni}
+per una lista di estensioni in @command{mawk} che non sono in POSIX
@command{awk}.
+
address@hidden Sumner, Andrew
address@hidden @command{awka}, compilatore per @command{awk}
address@hidden compilatore per @command{awk}, @command{awka}
address@hidden sorgente, codice, @command{awka}
address@hidden codice sorgente di @command{awka}
address@hidden @command{awka}
+Scritto da Andrew Sumner,
address@hidden traduce i programmi @command{awk} in C, li compila,
+e prepara il codice eseguibile usando una libreria di funzioni che
+implementano le address@hidden di base di @command{awk}.
+Comprende anche un certo numero di estensioni.
+
+Il traduttore di @command{awk} @`e rilasciato sotto la licenza GPL, e la
+relativa libreria sotto la licenza LGPL.
+
+Per ottenere @command{awka}, si visiti
+il sito @url{http://sourceforge.net/projects/awka}.
address@hidden You can reach Andrew Sumner at @email{andrew@@zbcom.net}.
address@hidden andrewsumner@@yahoo.net
+
+Il progetto sembra essere stato congelato; non ci sono state modifiche nel
+codice sorgente dal 2001 circa.
+
address@hidden Beebe, Nelson H.F.@:
address@hidden @command{pawk} (versione con profilatura di Brian Kernighan
@command{awk})
address@hidden codice sorgente, @command{pawk}
address@hidden sorgente, codice, @command{pawk}
address@hidden @command{pawk}
+Nelson H.F.@: Beebe all'address@hidden dello Utah ha modificato
+BWK @command{awk} per fornire informazioni di temporizzazione e profilatura.
+Questo @`e differente dall'usare @command{gawk} con l'opzione
@option{--profile}
+(@pxref{Profilare})
+nel senso che fornisce un profilo basato sul consumo di CPU, non sul
+numero di esecuzioni di una data riga di codice.
+Sia address@hidden trovare sia in
address@hidden://ftp.math.utah.edu/pub/pawk/pawk-20030606.tar.gz}
+che in
address@hidden://www.math.utah.edu/pub/pawk/pawk-20030606.tar.gz}.
+
address@hidden BusyBox @command{awk}
address@hidden BusyBox Awk
address@hidden codice sorgente, BusyBox Awk
address@hidden sorgente, codice, BusyBox Awk
+BusyBox @`e un programma distribuito con licenza GPL che fornisce versioni
+ridotte di parecchie piccole applicazioni, all'interno di un singolo modulo
+eseguibile. @`E stato ideato per sistemi
+integrati.
+Include un'implementazione completa di POSIX @command{awk}. Quando lo si
+compila occorre prestare attenzione a non eseguire @samp{make install},
perch@'e
+in questo modo si andrebbero a sostituire copie di altre applicazioni nella
+directory @file{/usr/local/bin} del sistema corrente. Per ulteriori
+informazioni, si veda @uref{http://busybox.net, la pagina principale del
progetto}.
+
address@hidden OpenSolaris
address@hidden Solaris, versione POSIX @command{awk}
address@hidden codice sorgente, Solaris @command{awk}
address@hidden sorgente, codice, Solaris @command{awk}
address@hidden POSIX @command{awk} per OpenSolaris
+Le versioni di @command{awk} in @file{/usr/xpg4/bin} e @file{/usr/xpg6/bin} su
+Solaris sono @dfn{grosso modo} conformi allo standard POSIX. Sono basate sul
+comando @command{awk} preparato per i PC dalla ditta Mortice Kern. @`E stato
+possibile compilare e far funzionare questo codice sotto GNU/Linux dopo 1--2
+ore di lavoro. Rendere questo codice address@hidden generalmente portabile
(usando gli
+strumenti GNU Autoconf e/o Automake) richiederebbe ulteriore lavoro, che non
@`e
+stato fin qui compiuto, almeno per quel che risulta a chi scrive.
+
address@hidden Illumos
address@hidden Illumos, @command{awk} conforme a POSIX e
address@hidden codice sorgente, Illumos @command{awk}
address@hidden sorgente, codice, Illumos @command{awk}
+Il codice sorgente era un tempo disponibile dal sito web OpenSolaris.
+Tuttavia, il progetto @`e terminato, e il sito web chiuso. Fortunatamente,
+il progetto
address@hidden://wiki.illumos.org/display/illumos/illumos+Home, Illumos}
+mette a disposizione questa implementazione. Si possono vedere i singoli file
in
address@hidden://github.com/joyent/illumos-joyent/blob/master/usr/src/cmd/awk_xpg4}.
+
address@hidden @command{jawk}
address@hidden Java, implementazione di @command{awk}
address@hidden implementazione Java di @command{awk}
address@hidden codice sorgente, @command{jawk}
address@hidden sorgente, codice, @command{jawk}
address@hidden @command{jawk}
+Questo @`e un interprete per @command{awk} scritto in Java. Dichiara di
+essere un interprete completo, anche se, poich@'e usa address@hidden di Java
+per l'I/O e per la ricerca di @dfn{regexp}, il linguaggio che supporta
address@hidden differente da @command{awk} POSIX.
+Ulteriori informazioni sono disponibili sulla
address@hidden://jawk.sourceforge.net, pagina principale del progetto}.
+
address@hidden Libmawk
address@hidden @command{libmawk}
address@hidden codice sorgente, @command{libmawk}
address@hidden sorgente, codice, @command{libmawk}
+Questo @`e un interprete @command{awk} incorporabile, derivato da
address@hidden Per ulteriori informazioni, si veda
address@hidden://repo.hu/projects/libmawk/}.
+
address@hidden @code{pawk}
address@hidden codice sorgente, @command{pawk} (versione Python)
address@hidden sorgente, codice, @command{pawk} (versione Python)
address@hidden @code{pawk}, implementazione simile ad @command{awk} per Python
+Questo @`e un modulo Python che intende introdurre address@hidden di tipo
address@hidden in Python. Si veda @uref{https://github.com/alecthomas/pawk} per
+ulteriori informazioni. (Questo programma non @`e correlato con la versione
+modificata da Nelson Beebe di BWK @command{awk}, descritta prima.)
+
address@hidden @w{QSE @command{awk}}
address@hidden QSE @command{awk}
address@hidden codice sorgente, QSE @command{awk}
address@hidden sorgente, codice, QSE @command{awk}
+Questo @`e un interprete di @command{awk} incorporabile. Per ulteriori
+informazioni, si veda
address@hidden://code.google.com/p/qse/} e @uref{http://awk.info/?tools/qse}.
+
address@hidden @command{QTawk}
address@hidden QuikTrim Awk
address@hidden codice sorgente, QuikTrim Awk
address@hidden sorgente, codice, QuikTrim Awk
+Questa @`e un'implementazione indipendente di @command{awk} distribuita con la
+licenza GPL. Ha un gran numero di estensioni rispetto ad @command{awk}
+standard, e address@hidden non essere sintatticamente compatibile al 100% con
esso. Si
+veda @uref{http://www.quiktrim.org/QTawk.html} per ulteriori informazioni,
+compreso il manuale. Il puntatore per scaricare QuikTrim non punta all'ultima
+versione: si veda @uref{http://www.quiktrim.org/#AdditionalResources} per un
+puntatore alla versione corrente.
+
+Il progetto sembra essere fermo; non ci sono nuove versioni del codice
+a partire dal 2014 circa.
+
address@hidden Altre versioni
+Si veda anche [in inglese] la sezione ``Versions and implementations''
+della voce di
address@hidden://en.wikipedia.org/wiki/Awk_language#Versions_and_implementations,
+Wikipedia} su @command{awk} per informazioni su ulteriori versioni.
+
address@hidden table
+
address@hidden Sommario dell'installazione
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+La distribuzione di @command{gawk} @`e disponibile dal sito principale
+di distribuzione del Progetto GNU
address@hidden La maniera canonica per scaricarlo e installarlo @`e:
+
address@hidden
+wget http://ftp.gnu.org/gnu/gawk/address@hidden@value{PATCHLEVEL}.tar.gz
+tar -xvpzf address@hidden@value{PATCHLEVEL}.tar.gz
+cd address@hidden@value{PATCHLEVEL}
+./configure && make && make check
address@hidden example
+
address@hidden
address@hidden address@hidden essere installato anche su sistemi non-POSIX. I
sistemi
+correntemente supportati sono MS-Windows, usando
+MSYS, MinGW, e Cygwin,
+e sia Vax/VMS che OpenVMS. Le istruzioni per ognuno di questi sistemi sono
+incluse in questa @value{APPENDIX}.
+
address@hidden
+Le segnalazioni di errori (bug) dovrebbero essere spedite tramite email a
address@hidden@@gnu.org}. Le segnalazioni di errore dovrebbero essere scritte
+in inglese e dovrebbero specificare la versione di @command{gawk} in uso, come
address@hidden stata compilata, un breve programma e un @value{DF} che
permettono di
+riprodurre il problema.
+
address@hidden
+Ci sono alcune altre implementazioni di @command{awk} disponibili
+gratuitamente. Molte rispettano lo standard POSIX; altre un po' meno.
+
address@hidden itemize
+
+
address@hidden FOR_PRINT
address@hidden Note
address@hidden Note di implementazione
address@hidden @command{gawk}, problemi di implementazione
address@hidden problemi di implementazione, @command{gawk}
+
+Quest'appendice contiene informazioni che interessano soprattutto le persone
+che aggiornano e mantengono @command{gawk}. L'intero contenuto si applica
+specificatamente a @command{gawk} e non ad altre implementazioni.
+
address@hidden
+* address@hidden di address@hidden:: Come inibire alcune estensioni di
+ @command{gawk}.
+* Aggiunte:: Fare aggiunte a @command{gawk}.
+* Future estensioni:: Nuove address@hidden che potranno
+ essere implementate in futuro.
+* Limitazioni dell'implementazione:: Alcune limitazioni
+ dell'implementazione.
+* Progetto delle estensioni:: Note di progetto sull'estensione API.
+* Meccanismo delle vecchie estensioni:: Alcune address@hidden per le vecchie
+ estensioni.
+* Sommario delle note:: Sommario delle note di
+ implementazione.
address@hidden menu
+
address@hidden address@hidden di address@hidden
address@hidden address@hidden all'indietro e debug
address@hidden @command{gawk}, problemi di implementazione, address@hidden
all'indietro
address@hidden @command{gawk}, problemi di implementazione, debug
address@hidden risoluzione di problemi, @command{gawk}
address@hidden problemi, risoluzione di, @command{gawk}
address@hidden problemi di address@hidden @command{gawk}, debug
+
address@hidden/GNU},
+per un compendio delle estensioni GNU per il linguaggio e il programma
address@hidden Tutte queste address@hidden possono essere inibite invocando
address@hidden con l'opzione @option{--traditional} o con l'opzione
address@hidden
+
+Se @command{gawk} @`e stato compilato per il debug con @samp{-DDEBUG}, @`e
+possibile specificare un'ulteriore opzione sulla riga di comando:
+
address@hidden @code
address@hidden -Y
address@hidden --parsedebug
+Stampa l'informazione contenuta nella pila di analisi, durante la fase di
+analisi iniziale del programma.
address@hidden table
+
+Quest'opzione @`e utile solo a chi sviluppa @command{gawk} e non all'utente
+occasionale. @`E probabile che non sia neppure disponibile nella versione di
address@hidden che si sta usando, perch@'e rallenta l'esecuzione del programma.
+
address@hidden Aggiunte
address@hidden Fare aggiunte a @command{gawk}
+
+Se si desidera migliorare @command{gawk} in maniera significativa, c'@`e la
+massima address@hidden di farlo. @`E questo lo scopo del software libero; il
codice
+sorgente @`e disponibile, ed @`e possibile modificarlo a piacere
+(@pxref{Copia}).
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta di come @`e possibile modificare @command{gawk},
+ed espone alcune considerazioni che si dovrebbero tenere presenti.
+
address@hidden
+* Accedere ai sorgenti:: Accedere al deposito dei sorgenti Git.
+* Aggiungere codice:: Aggiungere codice al programma
+ principale @command{gawk}.
+* Nuovi sistemi:: Portare @command{gawk} su un nuovo sistema
+ operativo.
+* File derivati:: Perch@'e i file derivati sono tenuti
+ nel deposito @command{git}.
address@hidden menu
+
address@hidden Accedere ai sorgenti
address@hidden Accedere al deposito dei sorgenti Git di @command{gawk}
+
+Poich@'e @command{gawk} @`e Software Libero, il codice sorgente @`e sempre
+disponibile.
address@hidden
+La
address@hidden iftex
address@hidden di Gawk} descrive come scaricare e installare
+le versioni ufficiali rilasciate di @command{gawk}.
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
+Peraltro, se si intende modificare @command{gawk} e mettere a disposizione le
+modifiche, @`e preferibile lavorare sulla versione in via di sviluppo. Per far
address@hidden @`e necessario accedere al deposito del codice sorgente di
@command{gawk}.
+Il codice @`e mantenuto usando il @uref{http://git-scm.com, sistema distribuito
+di controllo delle versioni Git}. address@hidden necessario installarlo se
non @`e address@hidden
+presente nel sistema. Quando @command{git} @`e disponibile, va usato il
comando:
+
address@hidden
+git clone git://git.savannah.gnu.org/gawk.git
address@hidden example
+
address@hidden
+Questo comando scarica in locale una copia esatta del deposito dei
+sorgenti di @command{gawk}. Se si sta usando un @dfn{firewall}
+che non consente l'uso del protocollo nativo di Git, @`e possibile accedere
+ugualmente al deposito usando il comando:
+
address@hidden
+git clone http://git.savannah.gnu.org/r/gawk.git
address@hidden example
+
+Una volta modificato il sorgente, @`e posibile usare @samp{git diff} per
+produrre una @dfn{patch}, e spedirla al manutentore di @command{gawk}; si veda
address@hidden, per come farlo.
+
+In passato era disponibile un'interfaccia Git--CVS
+utilizzabile da persone che non avevano a disposizione Git. Purtroppo,
+quest'interfaccia non funziona address@hidden, ma si potrebbe avere maggior
fortuna usando
+un sistema di controllo versioni address@hidden moderno, come Bazaar, che @`e
dotato di
+un'estensione Git per lavorare con depositi di sorgenti Git.
+
address@hidden Aggiungere codice
address@hidden Aggiungere nuove address@hidden
+
address@hidden @command{gawk}, aggiungere address@hidden a
address@hidden address@hidden, aggiungere a @command{gawk}
address@hidden aggiungere address@hidden a @command{gawk}
+Ognuno @`e libero di aggiungere tutte le nuove address@hidden che vuole a
address@hidden Comunque, se si desidera che tali modifiche siano incorporate
+nella distribuzione di @command{gawk}, ci sono parecchi passi da fare per
+rendere possibile la loro inclusione:
+
address@hidden 1
address@hidden
+Prima di inserire la nuova address@hidden all'interno di @command{gawk},
+prendere in considerazione la address@hidden di scriverla sotto forma di
+estensione (@pxref{Estensioni dinamiche}).
+Se address@hidden non @`e possibile, continuare con i passi rimanenti
descritti in questa
+lista.
+
address@hidden
+Essere disposti a firmare un documento liberatorio appropriato.
+Se l'FSF deve poter distribuire le modifiche, queste vanno dichiarate
+di pubblico dominio, tramite la firma di un documento apposito, oppure
+attribuendo il copyright delle modifiche all'FSF.
+Entrambe queste azioni sono semplici da fare, e @emph{molte} persone
address@hidden
+l'hanno fatto. Se ci sono domande da fare, mettersi in contatto con me
+(@pxref{Bug}),
+oppure @EMAIL{assign@@gnu.org,assign chiocciola gnu punto org}.
+
address@hidden
+Utilizzare l'ultima versione.
address@hidden molto address@hidden semplice per me integrare modifiche se sono
basate sull'ultima
+versione disponibile di @command{gawk} o, meglio ancora, sull'ultimo codice
+sorgente presente nel deposito Git. Se la versione di @command{gawk} @`e molto
+vecchia, potrei non essere affatto in grado di integrare le modifiche.
+(@xref{Scaricare},
+per informazioni su come ottenere l'ultima versione di @command{gawk}.)
+
address@hidden
address@hidden
+Seguire gli @cite{Standard di codifica GNU}.
address@hidden ifnotinfo
address@hidden
+Si veda @inforef{Top, , Version, standards, Standard di Codifica GNU}.
address@hidden ifinfo
+Questo documento descrive come dovrebbe essere scritto il software GNU.
+Se non lo si @`e letto, @`e bene farlo, preferibilmente @emph{prima}
+di iniziare a modificare @command{gawk}.
+(Gli @cite{Standard di codifica GNU} sono disponibili nel sito web del
address@hidden://www.gnu.org/prep/standards/, Progetto GNU}.
+Sono disponibili anche versioni in formato Texinfo, Info, e DVI.)
+
address@hidden @command{gawk}, stile di codifica in
address@hidden
+Usare lo stile di codifica @command{gawk}.
+Il codice sorgente in C di @command{gawk} segue le istruzioni dello
address@hidden di codifica GNU}, con qualche piccola eccezione. Il codice @`e
+formattato usando lo stile tradizionale ``K&R'', in particolare per
address@hidden che
+riguarda il posizionamento delle parentesi graffe e l'uso del carattere TAB.
+In breve, le regole di codifica per @command{gawk}
+sono le seguenti:
+
address@hidden @value{BULLET}
address@hidden
+Usare intestazioni di funzione (prototipi) in stile ANSI/ISO quando
+si definiscono delle funzioni.
+
address@hidden
+Mettere il nome della funzione all'inizio della riga in cui la si sta
definendo.
+
address@hidden
+Usare @samp{#elif} invece di nidificare istruzioni @samp{#if} all'interno
+di un'istruzione @samp{#else}.
+
address@hidden
+Mettere il tipo di codice di ritorno della funzione, anche se @`e @code{int},
+sulla riga immediatamente sopra quella che contiene il nome e gli argomenti
+della funzione.
+
address@hidden
+Mettere degli spazi attorno alle parentesi usate nelle strutture di controllo
+(@code{if}, @code{while}, @code{for}, @code{do}, @code{switch}
+e @code{return}).
+
address@hidden
+Non mettere spazi davanti alle parentesi usate nelle chiamate di funzione.
+
address@hidden
+Mettere spazi attorno a tutti gli operatori C e dopo le virgole,
+nelle chiamate di funzione.
+
address@hidden
+Non usare l'operatore @dfn{virgola} per produrre degli effetti collaterali
+multipli, tranne che nelle parti di inizializzazione e incremento dei cicli
address@hidden, e nel corpo delle macro.
+
address@hidden
+Usare dei caratteri TAB per l'indentazione, e non dei semplici spazi.
+
address@hidden
+Usare lo stile ``K&R'' per formattare le parti di programma incluse fra
+parentesi graffe.
+
address@hidden
+Usare confronti con @code{NULL} e @code{'\0'} per le condizioni
+contenute nelle istruzioni @code{if}, @code{while} e @code{for}, e anche
+nelle varie clausole @code{case} delle istruzioni @code{switch}, invece
+del semplice puntatore o il semplice valore del carattere.
+
address@hidden
+Usare i valori @code{true} e @code{false} per le variabili @code{booleane},
+la costante simbolica @code{NULL} per i valori dei puntatori,
+e la costante carattere @code{'\0'} quando @`e il caso, invece dei valori
@code{1}
+e @code{0}.
+
address@hidden
+Fornire un commento descrittivo di una riga per ogni funzione.
+
address@hidden
+Non usare la funzione @code{alloca()} per allocare memoria dalla @dfn{stack}.
+Il farlo genera dei problemi di address@hidden che non giustificano il
vantaggio
+secondario di non doversi preoccupare di liberare la memoria. Usare invece
address@hidden()} e @code{free()}.
+
address@hidden
+Non usare confronti nella forma @samp{! strcmp(a, b)} o simili.
+Come disse una volta Henry Spencer, address@hidden()} non @`e una funzione
+booleana!'' Usare invece @samp{strcmp(a, b) == 0}.
+
address@hidden
+Per aggiungere nuovi valori a @dfn{flag} binari, usare costanti esadecimali
+esplicite (@code{0x001}, @code{0x002}, @code{0x004}, etc.) invece che
+spostare di un bit a sinistra in incrementi successivi
+(@samp{(1<<0)}, @samp{(1<<1)}, etc.).
address@hidden itemize
+
address@hidden NOTA
+Qualora fossi costretto a riformattare completamente il codice per
+farlo aderire allo stile di codifica usato in @command{gawk}, potrei anche
+decidere di ignorare del tutto le modifiche proposte.
address@hidden quotation
+
address@hidden Texinfo
address@hidden
+Aggiornare la documentazione.
+Insieme col nuovo codice, fornire nuove sezioni e/o capitoli per questo
address@hidden Per quanto possibile, usare il formato Texinfo, invece
+di fornire soltanto del testo ASCII non formattato (sebbene un semplice testo
+sia address@hidden meglio che nessuna documentazione). Le convenzioni da
seguire in
address@hidden@value{TITLE}} sono elencate dopo la parole chiave @samp{@@bye}
alla fine
+del file sorgente Texinfo. Se possibile, aggiornare anche la pagina di manuale
+in formato @command{man}.
+
+Si address@hidden anche firmare un documento liberatorio relativo alle
+modifiche apportate alla documentazione.
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
address@hidden
+Inviare le modifiche come file di differenze nel formato contestuale unificato.
+Usare @samp{diff -u -r -N} per confrontare i sorgenti originali dell'albero
+di sorgenti @command{gawk} con la versione proposta.
+Si raccomanda di usare la versione GNU di @command{diff} o, ancora meglio,
address@hidden diff} o @samp{git format-patch}.
+Per inviare le modifiche proposte spedire l'output prodotto da @command{diff}.
+(@xref{Bug}, per l'indirizzo di posta elettronica.)
+
+L'uso di questo formato rende semplice per me l'applicazione delle modifiche
+alla versione principale del sorgente di @command{gawk} (usando il programma di
address@hidden @code{patch}). Se invece tocca a me applicare le modifiche a
mano,
+con un editor di testo, potrei decidere di non farlo, specialmente
+se le modifiche sono molte.
+
address@hidden
+Includere una descrizione da aggiungere al file @file{ChangeLog} riguardo alla
+modifica da voi proposta. Questo serve a minimizzare l'address@hidden a me
+richiesta, rendendo address@hidden facile per me l'accettazione delle
modifiche, che
+diventa address@hidden semplice se si include anche questa parte nel file di
differenze
+(nel formato @dfn{diff}).
address@hidden enumerate
+
+Sebbene questa possa sembrare una richiesta molto esigente, si tenga presente
+che, anche se il nuovo codice non @`e opera mia, tocca poi a me manutenerlo e
+correggere eventuali errori. Se non @`e possibile per me farlo senza perderci
+troppo tempo, potrei anche lasciar perdere la modifica.
+
address@hidden Nuovi sistemi
address@hidden Portare @command{gawk} su un nuovo Sistema Operativo
address@hidden address@hidden, @command{gawk}
address@hidden sistemi operativi, portare @command{gawk} su altri
+
address@hidden portare @command{gawk}
+Se si vuol portare @command{gawk} su di un nuovo sistema operativo, sono
+necessari parecchi passi:
+
address@hidden 1
address@hidden
+Seguire le linee-guida contenute
address@hidden
+in @ref{Aggiungere codice},
address@hidden ifinfo
address@hidden
+nella precedente @value{SECTION}
address@hidden ifnotinfo
+relative allo stile di codifica, all'invio delle differenze proposte, etc.
+
address@hidden
+Essere disposti a firmare un documento liberatorio appropriato.
+Se l'FSF deve poter distribuire le modifiche, queste vanno dichiarate
+di pubblico dominio, tramite la firma di un documento apposito, oppure
+attribuendo il copyright delle modifiche all'FSF.
+Entrambe queste azioni sono semplici da fare, e @emph{molte} persone
address@hidden
+l'hanno fatto. Se ci sono domande da fare, scrivere a me
+oppure all'indirizzo @email{gnu@@gnu.org}.
+
address@hidden
+Nel realizzare un @dfn{port}, tener presente che il codice
+deve coesistere pacificamente con il resto di @command{gawk} e con le
+versioni per altri sistemi operativi.
+Evitare modifiche non necessarie alla parte di codice che @`e indipendente
+dal sistema operativo. Se possibile, evitare di disseminare @samp{#ifdef},
+utili solo per il proprio @dfn{port}, all'interno del codice sorgente.
+
+Se le modifiche necessarie per un particolare sistema coinvolgono una parte
+troppo rilevante del codice, @`e probabile che io non le accetti.
+In questo caso si possono, naturalmente, distribuire le modifiche per
+proprio conto, basta che si rispettino i vincoli della GPL
+(@pxref{Copia}).
+
address@hidden
+Un certo numero di file che fanno parte della distribuzione di @command{gawk}
+sono mantenuti da terze persone e non dagli sviluppatori di @command{gawk}.
+Quindi, non si dovrebbero cambiare, se non per ragioni molto
+valide; vale a dire, modifiche a questi file non sono impossibili, ma
+le modifiche a questi file saranno controllate con estrema attenzione.
+I file sono
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden
+Un certo numero di altri file sono prodotti dagli Autotool [comandi di
+configurazione] di GNU (Autoconf, Automake, e GNU @command{gettext}).
+Neppure questi file dovrebbero essere modificati, se non per ragioni molto
+valide. I file sono
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden
+Essere disponibili a continuare a manutenere il @dfn{port}.
+I sistemi operativi non-Unix sono supportati da volontari che tengono
+aggiornato il codice necessario per compilare ed eseguire @command{gawk}
+nei loro sistemi. Se nessuno @`e disponibile a tener aggiornato un @dfn{port},
+questo diventa non address@hidden supportato, e address@hidden essere
necessario rimuoverlo dalla
+distribuzione.
+
address@hidden
+Fornire un appropriato file @file{gawkmisc.???}.
+Ogni @dfn{port} ha il proprio @file{gawkmisc.???} che implementa alcune
+funzioni specifiche per quel sistema operativo. Questa @`e una soluzione
address@hidden
+pulita, rispetto a una address@hidden di @samp{#ifdef} sparsi nel codice. Il
file
address@hidden nella directory principale dei sorgenti include gli
+appropriati file @file{gawkmisc.???} da ogni sottodirectory. Anche
+quest'ultimo file va aggiornato.
+
+Ogni file @file{gawkmisc.???} del @dfn{port} ha un suffisso esplicativo
+del tipo di macchina o del sistema operativo in questione---per esempio,
address@hidden/gawkmisc.pc} e @file{vms/gawkmisc.vms}. L'uso di suffissi
distinti
+invece di un semplice @file{gawkmisc.c}, rende possibile spostare file da
+una sottodirectory propria del @dfn{port} nella sottodirectory principale,
+senza cancellare incidentalmente il file @file{gawkmisc.c} vero e proprio.
+(Al momento, questo rappresenta un problema solo per i @dfn{port} ai
+sistemi operativi dei PC.)
+
address@hidden
+Fornire un @file{Makefile} e ogni altro file sorgente o di intestazione in C
+che sia necessario per il proprio sistema operativo. Tutto il codice dovrebbe
+stare in una sottodirectory a parte, il cui nome sia lo stesso, o
+sia indicativo, del proprio sistema operativo o del tipo di computer.
+Se possibile, tentare di strutturare il codice in modo che non sia necessario
+spostare file dalla propria sottodirectory nella directory principale del
+codice sorgente. Se address@hidden non @`e possibile, evitare nel modo
address@hidden assoluto di
+usare nomi per i file che siano duplicati di nomi di file presenti nella
+directory principale del codice sorgente.
+
address@hidden
+Aggiornare la documentazione.
+Scrivere una sezione (o address@hidden sezioni) per questo @value{DOCUMENT}
+che descriva i passi di installazione e compilazione necessari per compilare
+e/o installare @command{gawk} per il sistema desiderato.
address@hidden enumerate
+
+Seguire queste indicazioni facilita molto l'integrazione delle
+modifiche in @command{gawk} e la loro felice coesistenza con il codice di
+altri sistemi operativi address@hidden presenti.
+
+Nel codice che viene fornito e tenuto aggiornato, si possono
+tranquillamente usare uno stile di codifica e una disposizione delle
+parentesi graffe di proprio gradimento.
+
address@hidden File derivati
address@hidden Perch@'e i file generati sono tenuti in Git
+
address@hidden Git, uso per il codice sorgente di @command{gawk}
address@hidden From emails written March 22, 2012, to the gawk developers list.
+
+Se si esaminano i sorgenti di @command{gawk} nel deposito Git
+si address@hidden che sono inclusi file generati automaticamente dagli
strumenti
+dell'infrastruttura GNU, come @file{Makefile.in} generato da Automake e
+anche @file{configure} proveniente da Autoconf.
+
+Questo comportamento @`e differente da quello di molti progetti di
+Libero Software che non memorizzano i file derivati, per mantenere
address@hidden
+sgombro il deposito Git, rendendo address@hidden@dotless{i}} address@hidden
facile comprendere quali sono le
+modifiche sostanziali confrontando differenti versioni, nel tentativo di
+capire cosa @`e cambiato tra una modifica e la precedente.
+
+Tuttavia, ci sono parecchie ragioni per le quali il manutentore di
address@hidden preferisce mantenere ogni cosa nel deposito Git.
+
+Innanzitutto, perch@'e in questo modo @`e facile generare completamente ogni
+data versione, senza doversi preoccupare di avere a disposizione altri
+strumenti (address@hidden vecchi, probabilmente obsoleti, e in qualche caso
+perfino impossibili da trovare).
+
+Come esempio estremo, se solo si pensa di tentare di compilare, diciamo, la
+versione Unix V7 di @command{awk}, ci si accorge che non solo @`e necessario
+scaricare e ricompilare la versione V7 del comando @command{yacc} per farlo, ma
+anche che serve la versione V7 del comando @command{lex}. E quest'ultima @`e
+praticamente impossibile farla funzionare in un sistema GNU/Linux dei giorni
address@hidden abbiamo provato. @`E stata un'esperienza dolorosa.}
+
+(Oppure, diciamo che la versione 1.2 di @command{gawk} richiede il comando
address@hidden come funzionava nel 1989, e non @`e presente il file
address@hidden [generato tramite @command{bison}] nel deposito Git. Che cosa
+ci garantisce di riuscire a trovare quella versione di @command{bison}? O che
address@hidden riesca a generarlo?)
+
+Se il deposito Git comprende tutti i file derivati,
address@hidden facile, dopo averli scaricati, ricostruire il programma.
(Oppure @`e @address@hidden
+facile}, a seconda di quanto si vuole risalire indietro nel tempo).
+
+E qui arriviamo alla seconda (e address@hidden valida) ragione per cui tutti i
file
+devono essere proprio nel deposito Git. Domandiamoci a chi ci si rivolge:
+agli sviluppatori di @command{gawk}, oppure a un utilizzatore che intende
+solo scaricare una data versione e provarla?
+
+Il manutentore di @command{gawk} desidera che per tutti gli utenti
address@hidden interessati sia possibile limitarsi a clonare il deposito sul
+proprio computer, selezionare la variante che lo interessa e costruirla. Senza
+doversi preoccupare di avere a disposizione le versioni corrette degli Autotool
address@hidden un programma GNU che (secondo noi) @`e estremamente difficile
+da estrarre dal deposito Git e compilare. Per esempio, in un vecchio (ma
+ancora funzionante) PowerPC Macintosh, con il sistema operativo Mac Os X 10.5,
address@hidden stato necessario scaricare e compilare una tonnellata di
software,
+incominciando dallo stesso programma Git, per riuscire a lavorare con l'ultima
+versione del codice. Non @`e un'esperienza piacevole e, specie sui vecchi
+sistemi, @`e una notevole perdita di tempo.
+
+Neppure partire dall'ultimo archivio @command{tar} compresso @`e stata una
+passeggiata: i manutentori avevano eliminato i file compressi in formato
address@hidden e @file{.bz2} sostituendoli con file di tipo @file{.tar.xz}.
+Bisognava quindi per prima cosa scaricare e compilare @command{xz}}.
+A questo serve il file @file{bootstrap.sh}. Va a "toccare"
+[tramite il comando @command{touch}] vari altri file nell'ordine richiesto
+in modo che
+
address@hidden
+# La formula canonica per compilare il software GNU:
+./bootstrap.sh && ./configure && make
address@hidden example
+
address@hidden
+tutto @emph{funzioni senza problemi}.
+
+Questo @`e estremamente importante per i rami
address@hidden e @address@hidden@var{Y}-stable}.
+
+Inoltre, il manutentore di @command{gawk} potrebbe sostenere che
address@hidden @`e importante anche per gli sviluppatori di @command{gawk}.
Tentando di
+scaricare il ramo @address@hidden ramo (non address@hidden presente) creato da
+uno degli altri sviluppatori, e che non includeva i file generati.} per
+compilarlo, non ci address@hidden@dotless{i}}. (Mancava il file
@file{ltmain.sh}, ed egli non
+aveva idea di come crearlo, e c'erano anche ulteriori problemi.)
+
+La cosa lo address@hidden in uno stato di frustrazione @emph{estrema}.
Riguardo a quel
+ramo, il manutentore @`e in una posizione non differente da quella di un utente
+generico che voglia tentare di compilare @code{gawk-4.1-stable} o @code{master}
+dal deposito Git.
+
+Quindi, il manutentore ritiene che sia non solo importante, ma cruciale, che
+per ogni dato ramo la formula canonica evocata prima
address@hidden senza problemi}.
+
address@hidden Added 9/2014:
+Una terza ragione per avere tutti i file @`e che senza di essi, usare @samp{git
+bisect} per tentare di trovare quale modifica ha introdotto un errore diventa
+estremamente difficile. Il manutentore ha tentato di farlo su un altro
+progetto che richiede di eseguire @dfn{script} di inizializzazione allo scopo
+di creare lo @dfn{script} @command{configure} e address@hidden@dotless{i}}
via; @`e stata un'esperienza
+veramente dolorosa. Se invece il deposito Git contiene tutto il necessario,
+usare @command{git bisect} al suo interno @`e molto facile.
+
address@hidden So - that's my reasoning and philosophy.
+
+Quali sono, quindi, alcune delle conseguenze e/o delle cose da fare?
+
address@hidden 1
address@hidden
+Non importa se ci sono file differenti nei diversi rami
+prodotti da versioni differenti degli Autotool.
+
address@hidden A
address@hidden
+Spetta al manutentore integrarli tra loro, e se ne address@hidden lui.
+
address@hidden
address@hidden facile per lui eseguire @samp{git diff x y > /tmp/diff1 ; gvim
/tmp/diff1}
+per rimuovere le differenze che non sono rilevanti ai fini della revisione
+del codice sorgente.
address@hidden enumerate
+
address@hidden
+Sarebbe sicuramente d'aiuto se tutti usassero le stesse versioni degli Autotool
+GNU che lui usa, che in generale sono le ultime versioni rilasciate di
+Automake,
+Autoconf,
address@hidden
+e
+GNU @command{gettext}.
+
address@hidden
+If it would help if I sent out an ``I just upgraded to version x.y
+of tool Z'' kind of message to this list, I can do that. Up until
+now it hasn't been a real issue since I'm the only one who's been
+dorking with the configuration machinery.
address@hidden ignore
+
address@hidden @enumerate A
address@hidden @item
+Installare a partire dal sorgente @`e abbastanza facile. @`E il modo con cui
il
+manutentore ha lavorato per anni (e ancora lavora).
+Egli aveva @file{/usr/local/bin} all'inizio del suo @env{PATH} e dava i
+seguenti comandi:
+
address@hidden
+wget http://ftp.gnu.org/gnu/@var{package}/@address@hidden@address@hidden
+tar -xpzvf @address@hidden@address@hidden
+cd @address@hidden@address@hidden
+./configure && make && make check
+make install # come utente root
address@hidden example
+
address@hidden @item
address@hidden
+These days the maintainer uses Ubuntu 12.04 which is medium current, but
+he is already doing the above for Automake, Autoconf, and @command{bison}.
address@hidden ignore
+
address@hidden
+(C. Rant: Recent Linux versions with GNOME 3 really suck. What
+ are all those people thinking? Fedora 15 was such a bust it drove
+ me to Ubuntu, but Ubuntu 11.04 and 11.10 are totally unusable from
+ a UI perspective. Bleah.)
address@hidden ignore
address@hidden @end enumerate
+
address@hidden
address@hidden
+If someone still feels really strongly about all this, then perhaps they
+can have two branches, one for their development with just the clean
+changes, and one that is buildable (xgawk and xgawk-buildable, maybe).
+Or, as I suggested in another mail, make commits in pairs, the first with
+the "real" changes and the second with "everything else needed for
+ building".
address@hidden ignore
address@hidden enumerate
+
+La maggior parte del testo precedente fa parte di messaggi scritti
+originalmente dal manutentore agli altri sviluppatori @command{gawk}.
+Da uno degli sviluppatori @`e stata avanzata l'obiezione
address@hidden che chi scarica il sorgente da Git
+non @`e un utente finale''.
+
+Tuttavia, questo non @`e esatto. Ci sono ``utenti avanzati di @command{awk}''
+che possono installare @command{gawk} (usando la formula canonica vista sopra)
+ma che non conoscono il linguaggio C. Quindi, i rami address@hidden rilevanti
+dovrebbero essere sempre compilabili.
+
address@hidden stato proposto poi di lanciare ogni notte uno @dfn{script}
tramite il
+programma di address@hidden @command{cron} per creare archivi in formato
@command{tar}
+contenenti tutto ``il codice sorgente.'' Il problema in questo caso @`e che
+ci sono differenti alberi di sorgenti, che corrispondono ai vari rami!
+Quindi gli archivi notturni in questione non sono una risposta valida, anche
+per il fatto che il deposito Git address@hidden rimanere senza alcuna modifica
+significativa per settimane intere.
+
+Fortunatamente, il server Git address@hidden rispondere a questa esigenza.
Per ogni
+dato ramo chiamato @var{nome-ramo}, basta usare:
+
address@hidden
+wget http://git.savannah.gnu.org/cgit/gawk.git/snapshot/address@hidden
address@hidden example
+
address@hidden
+per ottenere una copia utilizzabile del ramo in questione.
+
address@hidden Future estensioni
address@hidden Probabili estensioni future
address@hidden
+From emory!scalpel.netlabs.com!lwall Tue Oct 31 12:43:17 1995
+Return-Path: <emory!scalpel.netlabs.com!lwall>
+Message-Id: <address@hidden>
+To: address@hidden (Arnold D. Robbins)
+Subject: Re: May I quote you?
+In-Reply-To: Your message of "Tue, 31 Oct 95 09:11:00 EST."
+ <address@hidden>
+Date: Tue, 31 Oct 95 09:32:46 -0800
+From: Larry Wall <emory!scalpel.netlabs.com!lwall>
+
+: Greetings. I am working on the release of gawk 3.0. Part of it will be a
+: thoroughly updated manual. One of the sections deals with planned future
+: extensions and enhancements. I have the following at the beginning
+: of it:
+:
+: @cindex PERL
+: @cindex Wall, Larry
+: @display
+: @i{AWK is a language similar to PERL, only considerably more elegant.} @*
+: Arnold Robbins
+: @sp 1
+: @i{Hey!} @*
+: Larry Wall
+: @end display
+:
+: Before I actually release this for publication, I wanted to get your
+: permission to quote you. (Hopefully, in the spirit of much of GNU, the
+: implied humor is visible... :-)
+
+I think that would be fine.
+
+Larry
address@hidden ignore
address@hidden Perl
address@hidden Wall, Larry
address@hidden Robbins, Arnold
address@hidden
address@hidden @`e un linguaggio simile a PERL, solo che @`e notevolmente
address@hidden elegante.}
address@hidden Arnold Robbins
address@hidden quotation
+
address@hidden
address@hidden
address@hidden Larry Wall
address@hidden quotation
+
+Il file @file{TODO} nel ramo @code{master} del deposito Git di @command{gawk}
+contiene un elenco di possibili futuri miglioramenti. Alcuni di questi
+riguardano il codice sorgente, e altri possibili nuove address@hidden
+Consultare quel file per esaminare la lista.
address@hidden,
+se si @`e interessati a intraprendere qualcuno dei progetti address@hidden
elencati.
+
address@hidden Limitazioni dell'implementazione
address@hidden Alcune limitazioni dell'implementazione
+
+La tabella seguente specifica i limiti di @command{gawk} in un sistema di
+tipo Unix (sebbene anche tra questi ci potrebbero essere variazioni). Altri
+sistemi operativi possono avere limiti differenti.
+
address@hidden @columnfractions .40 .60
address@hidden Caratteristica @tab Limiti
address@hidden Caratteri in una classe di caratteri @tab 2^(numero di bit per
byte)
address@hidden Lunghezza di un record in input @tab @code{MAX_INT}
address@hidden Lunghezza di un record in output @tab Illimitata
address@hidden Lunghezza di una riga di codice sorgente @tab Illimitata
address@hidden Numero di campi in un record @tab @code{MAX_LONG}
address@hidden Numero di ridirezioni di file @tab Illimitata
address@hidden Numero di record in input in un singolo file @tab @code{MAX_LONG}
address@hidden Numero totale di record in input @tab @code{MAX_LONG}
address@hidden Numero di ridirezioni via @dfn{pipe} @tab min(numero processi
per utente, numero di file aperti)
address@hidden Valori numerici @tab Numeri a virgola mobile in doppia
precisione (se non si usa la address@hidden MPFR)
address@hidden Dimensione di un campo @tab @code{MAX_INT}
address@hidden Dimensione di una stringa letterale @tab @code{MAX_INT}
address@hidden Dimensione di una stringa di @dfn{printf} @tab @code{MAX_INT}
address@hidden multitable
+
address@hidden Progetto delle estensioni
address@hidden Note di progetto dell'estensione API
+
+Questa @value{SECTION} documenta l'architettura dell'estensione API,
+inclusa una trattazione sommaria della progettazione e dei problemi che
+andavano risolti.
+
+La prima versione delle estensioni per @command{gawk} @`e stata sviluppata
+a address@hidden degli anni '90, e distribuita con la versione 3.1 di
@command{gawk},
+verso la fine degli anni '90.
+Il meccanismo e l'architettura sono rimasti gli stessi per quasi 15 anni,
+fino al 2012.
+
+Il vecchio meccanismo delle estensioni usava tipi di dati e funzioni dello
+stesso @command{gawk}, con un ``abile trucco'' per installare le funzioni
+di estensione.
+
+La distribuzione @command{gawk} conteneva alcuni esempi di estensioni, solo
+poche delle quali erano realmente utili. Tuttavia era chiaro fin da
+principio che il meccanismo di estensione era un'aggiunta improvvisata, e
+non era realmente ben concepito.
+
address@hidden
+* Problemi con le vecchie estensioni:: Problemi col vecchio meccanismo.
+* Obiettivi delle estensioni:: Obiettivi del nuovo meccanismo.
+* Altre scelte progettuali per le estensioni:: Qualche altra scelta
progettuale.
+* Futuri sviluppi delle estensioni:: address@hidden di crescita futura.
address@hidden menu
+
address@hidden Problemi con le vecchie estensioni
address@hidden Problemi con le vecchie estensioni
+
+Il vecchio meccanismo delle estensioni presentava parecchi problemi:
+
address@hidden @value{BULLET}
address@hidden
+Dipendeva eccessivamente dalla struttura interna di @command{gawk}. Ogni volta
+che la struttura @address@hidden struttura di dati fondamentale
+all'interno di @command{gawk}.} veniva modificata, ogni estensione doveva
+essere ricompilata. Inoltre, la scrittura di estensioni richiedeva una
+certa address@hidden con le funzioni interne di @command{gawk}. Esisteva
+un po' di documentazione in questo @value{DOCUMENT}, ma era ridotta al minimo.
+
address@hidden
+Per poter utilizzare servizi di @command{gawk} da un'estensione era necessario
+disporre di address@hidden del @dfn{linker}
+normalmente disponibili in ambiente di tipo Unix, ma non implementate
+nei sistemi MS-Windows; chi voleva utilizzare estensioni in
+MS-Windows doveva aggiungerle al modulo eseguibile di @command{gawk},
+anche se MS-Windows supporta il caricamento dinamico di oggetti condivisi.
+
address@hidden
+L'API di tanto in tanto veniva modificata, in parallelo ai cambiamenti di
address@hidden; nessuna address@hidden tra le versioni @`e stata mai prevista o
+resa disponibile.
address@hidden itemize
+
+Nonostante questi inconvenienti, gli sviluppatori del progetto @command{xgawk}
+si basarono su @command{gawk} per sviluppare parecchie estensioni
+significative. Inoltre, migliorarono le address@hidden, in @command{gawk}, di
+includere file e di accedere a oggetti condivisi.
+
+Una nuova API @`e rimasta un desiderio per lungo tempo, ma solo nel 2012
+il manutentore di @command{gawk} e gli sviluppatori di @command{xgawk}
+iniziarono finalmente a lavorare insieme. Ulteriori informazioni riguardanti
+il progetto @command{xgawk} sono forniti nella @ref{gawkextlib}.
+
address@hidden Obiettivi delle estensioni
address@hidden Obiettivi per un nuovo meccanismo
+
+Alcuni obiettivi per la nuova API sono:
+
address@hidden @value{BULLET}
address@hidden
+L'API dovrebbe essere indipendente dalla struttura interna di @command{gawk}.
+Le modifiche alla struttura interna di @command{gawk} dovrebbero essere
+irrilevanti per chi scrive una funzione di estensione.
+
address@hidden
+L'API dovrebbe consentire una address@hidden @emph{binaria} [ossia a livello
+di codice eseguibile, e non solo a livello di codice sorgente] tra diverse
+versioni di @command{gawk}, se la stessa API rimane invariata.
+
address@hidden
+L'API dovrebbe consentire che le estensioni scritte in C o C++ abbiano
+all'incirca la stessa ``struttura'', per il codice awk,
+di quella che hanno le funzioni di @command{awk}. Questo vuol dire che le
+estensioni dovrebbero avere:
+
address@hidden @value{MINUS}
address@hidden
+La address@hidden di accedere ai parametri delle funzioni.
+
address@hidden
+La address@hidden di trasformare un parametro indefinito in un vettore
+(chiamata per riferimento address@hidden reference}]).
+
address@hidden
+La address@hidden di creare, leggere e aggiornare variabili globali.
+
address@hidden
+Un accesso facile a tutti gli elementi di un vettore simultaneamente
+(``appiattimento del vettore'') in modo da poter visitare tutti gli elementi
+del vettore in una maniera semplice per un programma scritto in C.
+
address@hidden
+La address@hidden di creare vettori (compresi i veri "vettori di vettori" di
address@hidden).
address@hidden itemize
address@hidden itemize
+
+Alcuni ulteriori obiettivi rilevanti sono:
+
address@hidden @value{BULLET}
address@hidden
+L'API dovrebbe usare solo address@hidden disponibili nella specifica ISO C 90,
in
+modo da consentire estensioni scritte con una vasta gamma di compilatori C e
+C++. L'intestazione dovrebbe includere le appropriate direttive
address@hidden __cplusplus} e @samp{extern "C"}, in modo da poter utilizzare un
+compilatore C++. (Se si usa C++, il sistema operativo in uso dev'essere in
+grado di invocare dei costruttori e dei distruttori, poich@'e @command{gawk}
@`e un
+programma scritto in C. Al momento in cui queste note sono scritte, la cosa
+non @`e stata verificata).
+
address@hidden
+Il meccanismo API non dovrebbe aver bisogno di accedere ai simboli di
address@hidden@footnote{I @dfn{simboli} sono le variabili e le funzioni
+definite all'interno di @command{gawk}. Accedere a questi simboli da parte
+di codice esterno a @command{gawk} caricato dinamicamente al momento
+dell'esecuzione @`e problematico in ambiente MS-Windows.} da parte del
address@hidden statico, usato in fase di compilazione, o di quello dinamico,
+in modo da rendere possibile la creazione di estensioni che funzionino anche
+in ambiente MS-Windows.
address@hidden itemize
+
+In fase di sviluppo, @`e apparso evidente che dovevano essere disponibili alle
+estensioni anche altre address@hidden, che sono state
+successivamente implementate:
+
address@hidden @value{BULLET}
address@hidden
+Le estensioni dovrebbero essere in grado di agganciarsi al meccanismo di
+ridirezione dell'I/O di @command{gawk}. In particolare, gli sviluppatori di
address@hidden hanno programmato un cosiddetto ``gancio aperto'' (@dfn{open
+hook}) per gestire autonomamente la lettura dei record. In fase di sviluppo,
+questo meccanismo @`e stato generalizzato, per consentire alle estensioni di
+agganciarsi sia all'elaborazione dell'input, che a quella dell'output, nonch@'e
+all'I/O bidirezionale.
+
address@hidden
+Un'estensione dovrebbe poter rendere disponibile una funzione di ``call back''
+(richiamo) per effettuare operazioni di pulizia all'uscita di @command{gawk}.
+
address@hidden
+Un'estensione dovrebbe poter rendere disponibile una stringa di versione
address@hidden@dotless{i}} che l'opzione @option{--version}
+di @command{gawk} possa informare anche sulle versioni delle estensioni.
address@hidden itemize
+
+Il vincolo di evitare di accedere ai simboli di @command{gawk} address@hidden
parere a
+prima vista piuttosto difficile da rispettare.
+
+Un tipo di architettura, apparentemente usato da Perl e Ruby e forse da altri
+programmi, potrebbe consistere nel mettere il codice principale di
address@hidden in una libreria, limitando il programma di address@hidden
address@hidden a una piccola funzione @code{main()} in C che richiamerebbe
+dinamicamente la libreria.
+
+Questo inverte i ruoli del programma principale e della sua estensione, e
+complica sia la compilazione che l'installazione, trasformando la semplice
+copia del programma eseguibile @command{gawk} da un sistema all'altro (o da una
+posizione all'altra all'interno dello stesso sistema) in un'operazione ad alto
+rischio.
+
+Pat Rankin ha suggerito la soluzione che @`e stata adottata.
address@hidden sul meccanismo delle estensioni}, per maggiori dettagli.
+
address@hidden Altre scelte progettuali per le estensioni
address@hidden Altre scelte progettuali
+
+Per una scelta progettuale arbitraria, le estensioni possono accedere ai valori
+delle variabili e dei vettori predefiniti (come @code{ARGV} e @code{FS}), ma
+non possono modificarli, con la sola eccezione di @code{PROCINFO}.
+
+Il motivo di questa scelta @`e di impedire a una funzione di estensione di
+alterare il flusso di un programma @command{awk} togliendogli il controllo.
+Mentre una vera funzione di @command{awk} address@hidden fare quel che vuole, a
+discrezione del programmatore, una funzione di estensione dovrebbe fornire un
+servizio, o rendere disponibile un'API C da utilizzare all'interno di
address@hidden, senza interferire con le variabili @code{FS} o @code{ARGC} e
address@hidden
+
+Inoltre, diverrebbe facile avviarsi su un sentiero scivoloso. Quante
address@hidden di @command{gawk} dovrebbero essere disponibili alle estensioni?
+Devono poter usare @code{getline}? Oppure richiamare @code{gsub()} o compilare
+espressioni regolari? Oppure richiamare funzioni interne di @command{awk}?
+(@emph{Questo} potrebbe creare molta confusione.)
+
+Per evitare questi problemi, gli sviluppatori di @command{gawk} hanno scelto di
+iniziare con le address@hidden address@hidden semplici e di base, che sono
comunque
+veramente utili.
+
+Sebbene @command{gawk} consenta cose interessanti come l'MPFR,
+e vettori indicizzati internamente con numeri interi,
+un'altra decisione @`e stata quella di non rendere disponibili all'API queste
address@hidden, per amor di address@hidden e per restare fedeli alla
tradizionale
+semantica di @command{awk}. (In effetti, i vettori indicizzati internamente
+con numeri interi sono talmente trasparenti che non sono neppure documentati!)
+
+In address@hidden, tutte le funzioni nell'API controllano che i puntatori ai
parametri
+passati loro in input non siano @code{NULL}. Se lo sono, viene emesso un
+messaggio di errore. (@`E bene che il codice di estensione verifichi
+che i puntatori ricevuti da @command{gawk} non siano @code{NULL}.
address@hidden non
+dovrebbe succedere, ma gli sviluppatori di @command{gawk} sono solo degli
+esseri umani, e capita anche a loro di commettere degli errori, di tanto in
+tanto.)
+
+Col tempo, l'API si address@hidden certamente; gli sviluppatori di
@command{gawk}
+si aspettano che questo avvenga in base alle address@hidden degli utenti. Per
ora,
+l'API disponbile sembra fornire un insieme di address@hidden minimo, eppure
+potente, per creare estensioni.
+
address@hidden Futuri sviluppi delle estensioni
address@hidden address@hidden di sviluppo futuro
+
+L'API address@hidden ancora essere ampliata, in due modi:
+
address@hidden @value{BULLET}
address@hidden
address@hidden passa un ``identificativo di estensione'' all'estensione in fase
+di caricamente dell'estensione. L'estensione a sua volta restituisce questo
+identificativo a @command{gawk} a ogni chiamata di funzione. Questo meccanismo
+consente a @command{gawk} di identificare l'estensione che lo chiama, se la
+cosa dovesse risultare necessaria.
+
address@hidden
+Analogamente, l'estensione passa uno ``spazio dei nomi'' a @command{gawk}
+in fase di registrazione di ogni funzione estesa. Questo @`e fatto in vista di
+un possibile futuro meccanismo per raggruppare funzioni di estensione, e per
+evitare in questo modo possibili conflitti nei nomi di funzione.
address@hidden itemize
+
+Naturalmente, al momento in cui queste righe sono state scritte, nessuna
+decisione @`e stata presa riguardo ai punti sopra descritti.
+
address@hidden Meccanismo delle vecchie estensioni
address@hidden address@hidden per le vecchie estensioni
+
address@hidden
+Il
address@hidden iftex
address@hidden dinamiche}, descrive le API supportate e i meccanismi
+per scrivere estensioni per @command{gawk}. Quest'API @`e stata introdotta
+nella @value{PVERSION} 4.1. Peraltro, address@hidden da molti anni
@command{gawk}
+metteva a disposizione un meccanismo di estensione che richiedeva una
address@hidden con la struttura interna di @command{gawk} e che non era stato
+progettato altrettanto bene.
+
+Per garantire un periodo di transizione, @command{gawk} @value{PVERSION} 4.1
+continua a supportare il meccanismo di estensione originale.
+Questo address@hidden disponibile per la durata di una sola versione
principale.
+Il supporto address@hidden, e address@hidden rimosso dal codice sorgente, al
rilascio
+della prossima versione principale.
+
+In breve, le estensioni in stile originale dovrebbero essere compilate
+includendo il file di intestazione @file{awk.h} nel codice sorgente
+dell'estensione. Inoltre, va definito l'identificativo @samp{GAWK} durante la
+preparazione (si usi @samp{-DGAWK} con compilatori in stile Unix). Se non lo
+si fa, le definizioni in @file{gawkapi.h} risulteranno in conflitto con quelle
+in @file{awk.h} e l'estensione non address@hidden compilabile.
+
+Come nelle versioni precedenti, un'estensione vecchio stile address@hidden
caricata
+usando la funzione predefinita @code{extension()} (che non viene ulteriormente
+documentata). Questa funzione, a sua volta, trova e carica il file oggetto
+condiviso che contiene l'estensione e chiama la sua routine C @code{dl_load()}.
+
+Poich@'e le estensioni in stile originale e quelle nello stile nuovo usano
+differenti routine di inizializzazione(@code{dl_load()} e @code{dlload()},
+rispettivamente), esse possono tranquillamente essere installate nella stessa
+directory (il cui nome deve essere contenuto nella variabile @env{AWKLIBPATH})
+senza problemi di conflitti.
+
+Il @dfn{team} di sviluppo di @command{gawk} raccomanda caldamente di convertire
+ogni estensione del vecchio tipo ancora in uso, in modo da utilizzare la nuova
+API descritta
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden dinamiche}.
+
address@hidden Sommario delle note
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Le estensioni di @command{gawk} possono essere disabilitata sia con
+l'opzione @option{--traditional} che con l'opzione @option{--posix}.
+L'opzione @option{--parsedebug} @`e disponibile se @command{gawk} @`e stato
+compilato con @samp{-DDEBUG}.
+
address@hidden
+Il codice sorgente di @command{gawk} @`e conservato in un deposito Git
+pubblicamente accessibile. Tutti possono scaricarlo e visualizzare il
+codice sorgente.
+
address@hidden
+I contributi a @command{gawk} sono benvenuti. Seguire le istruzioni
+delineate in questo @value{CHAPTER} address@hidden address@hidden agevole
integrare
+i contributi degli utenti nel codice principale.
+Questo vale sia per il contributo di nuove address@hidden che per il
address@hidden a ulteriori sistemi operativi.
+
address@hidden
address@hidden ha alcuni limiti: generalmente quelli imposti
+dall'architettura hardware della macchina.
+
address@hidden
+La progettazione dell'estensione API @`e volta a risolvere alcuni problemi
+riscontrati nel precedente meccanismo di estensione, ad abilitare
address@hidden richieste dal progetto @code{xgawk}, e a fornire una
address@hidden binaria in futuro.
+
address@hidden
+Il precedente meccanismo di estensione @`e ancora supportato
+nella @value{PVERSION} 4.1
+di @command{gawk}, ma address@hidden @emph{rimosso} nella prossima versione
principale.
+
address@hidden itemize
+
+
address@hidden Concetti fondamentali
address@hidden Concetti fondamentali di programmazione
address@hidden programmazione, concetti di
address@hidden programmazione, concetti di
+
+Quest'@value{APPENDIX} si propone di definire alcuni dei concetti
+e termini fondamentali usati nel resto di questo @value{DOCUMENT}.
+Poich@'e questo @value{DOCUMENT} @`e dedicato ad @command{awk},
+e non riguarda la programmazione al computer in generale, la trattazione
address@hidden necessariamente piuttosto generica e semplificata.
+(Se serve qualcosa di address@hidden approfondito, ci sono molti
+altri testi introduttivi che si possono consultare.)
+
address@hidden
+* Fondamenti ad alto livello:: Una visione dall'alto.
+* Fondamenti sui tipi di dati:: Una velocissima introduzione ai tipi di dati.
address@hidden menu
+
address@hidden Fondamenti ad alto livello
address@hidden Quel che fa un programma
+
address@hidden elaborazione dati
+Al livello address@hidden fondamentale, il compito di un programma @`e di
elaborare
+alcuni dati in input e produrre dei risultati.
address@hidden
+Si veda la @ref{figura-generica-flusso}.
address@hidden ifnotdocbook
address@hidden
+Si veda la @inlineraw{docbook, <xref linkend="figura-generica-flusso"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-generica-flusso
address@hidden generico di un programma}
address@hidden SMALLPRINT
address@hidden @image{programma-generico, , , Flusso generico di un programma}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{programma-generico, 11cm, , Flusso generico di un
programma}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-generica-flusso" float="0">
+<title>Flusso generico di un programma</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="programma-generico.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
address@hidden programmi compilati
address@hidden programmi interpretati
+Il ``programma'' nella figura address@hidden essere sia un programma
address@hidden programmi compilati sono normalmente scritti
+in linguaggi di programmazione di livello address@hidden basso, come C, C++, o
Ada,
+e quindi tradotti, o @dfn{compilati}, in una forma che
+il computer address@hidden eseguire direttamente.}
+(come @command{ls}),
+sia un programma @dfn{interpretato}. In quest'ultimo caso, un programma
+direttamente eseguibile dal computer, come @command{awk}, legge il
+programma, e quindi usa le istruzioni in esso contenute per elaborare i dati.
+
address@hidden programmazione, passi fondamentali
+Quando si scrive un programma, esso @`e composto normalmente
+dai seguenti insiemi di istruzioni di base,
address@hidden
+come si vede nella @ref{figura-flusso-elaborazione}:
address@hidden ifnotdocbook
address@hidden
+come si vede nella @inlineraw{docbook, <xref
linkend="figura-flusso-elaborazione"/>}:
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-flusso-elaborazione
address@hidden di un programma generico}
address@hidden SMALLPRINT
address@hidden @image{flusso-elaborazione, , , Fasi di un programma generico}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{flusso-elaborazione, 11cm , , Fasi di un programma
generico}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figura id="figura-flusso-elaborazione" float="0">
+<title>Fasi di un programma generico</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="flusso-elaborazione.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
address@hidden @asis
address@hidden Inizializzazione
+Queste sono le cose da fare prima di iniziare la reale elaborazione dei
+dati, per esempio controllare gli argomenti con cui @`e stato invocato il
+programma, inizializzare dei dati di cui si address@hidden aver bisogno per la
+successiva elaborazione, e address@hidden@dotless{i}} via.
+Questa fase corrisponde alla regola @code{BEGIN} di @command{awk}
+(@pxref{BEGIN/END}).
+
+Nella preparazione di una torta, questa fase corrisponde a quella di
+tirar fuori tutti i contenitori in cui mischiare gli ingredienti, e la
+teglia in cui cuocerla, e nell'assicurarsi di avere a disposizione tutti gli
+ingredienti necessari.
+
address@hidden Elaborazione
+Questa fase @`e quella in cui si svolge il lavoro vero e proprio. Il programma
+legge i dati, raggruppati in ``pezzi logici'', e li elabora secondo
address@hidden
+
+In quasi tutti i linguaggi di programmazione, la lettura dei dati va gestita
+manualmente, controllando dopo ogni lettura se @`e
+rimasto ancora qualcosa d'altro da leggere. Il paradigma @dfn{criterio di
+ricerca--azione} di @command{awk}
address@hidden
+(@pxrefil{Per iniziare})
address@hidden iftex
address@hidden
+(@pxref{Per iniziare})
address@hidden ifnottex
+gestisce automaticamente la parte di lettura dati.
+
+Nella preparazione di una torta, l'elaborazione corrisponde all'address@hidden
+vera e propria: rompere le uova, mescolare la farina, l'acqua e gli altri
+ingredienti, e quindi mettere la torta a cuocere nel forno.
+
address@hidden Pulizia
+Una volta elaborati tutti i dati, ci sono address@hidden da svolgere prima di
aver
+finito. Questa fase corrisponde alla regola @code{END} di @command{awk}.
+(@pxref{BEGIN/END}).
+
+Dopo che la torta @`e stata tirata fuori dal forno, va fatta raffreddare e
+avvolta in una pellicola trasparente per evitare che qualcuno la assaggi,
+e inoltre vanno lavati i contenitori e le posate.
address@hidden table
+
address@hidden Algoritmi
+Un @dfn{algoritmo} @`e la descrizione dettagliata della procedura necessaria
per
+svolgere un compito o per elaborare dati. Lo si address@hidden paragonare
alla ricetta
+per preparare una torta. I programmi sono il modo con cui un
+algoritmo viene eseguito da un computer.
+Spesso @`e compito del programmatore sia sviluppare un algoritmo, sia
+programmarlo.
+
address@hidden record
address@hidden campi
+I ``pezzi logici'' nominati precedentemente sono chiamati @dfn{record}
+(registrazioni), in analogia con le registrazioni del personale di una ditta,
+degli studenti di una scuola, o dei pazienti di un dottore.
+Ogni record @`e composto di molte parti, per esempio nome, cognome, data di
+nascita, indirizzo, e address@hidden@dotless{i}} via. Le parti di cui @`e
composto un record sono
+chiamate @dfn{campi} del record.
+
+L'atto di leggere i dati @`e noto come @dfn{input}, e quello di generare
+risultati @`e, come facilmente prevedibile, chiamato @dfn{output}. Spesso i
due
+sono riuniti sotto il nome di ``input/output'' e, ancor address@hidden spesso,
con
+l'abbreviazione ``I/O''. (In inglese ``input'' e ``output'' sono spesso usati
+come verbi, nel gergo informatico, al posto di leggere e scrivere.)
+
address@hidden guidato-dai-dati, linguaggio di programmazione
address@hidden linguaggio di programmazione, guidato dai dati
address@hidden gestisce la lettura dei dati, come anche la divisione in
+record e campi. Lo scopo del programma dell'utente @`e di dire ad
@command{awk}
+cosa fare con i dati. Questo vien fatto descrivendo @dfn{modelli} da
+ricercare nei dati e @dfn{azioni} da eseguire qualora si siano trovati questi
+modelli. Questa caratteristica dei programmi @command{awk}, di essere
address@hidden, di solito li rende address@hidden facili sia da scrivere che da
+leggere.
+
address@hidden Fondamenti sui tipi di dati
address@hidden Valore dei dati in un computer
+
address@hidden variabili
+In un programma si tiene traccia di informazioni e valori in contenitori
+chiamati @dfn{variabili}. Una variabile @`e solo un nome per designare un
certo
+valore, come @code{nome}, @code{cognome}, @code{indirizzo}, e
address@hidden@dotless{i}} via.
address@hidden ha molte variabili predefinite, e ha dei nomi speciali per
+designare il record in input corrente e i campi che compongono il record
+stesso. Si possono inoltre raggruppare molti valori associati tra di loro
+sotto un unico nome, utilizzando un vettore.
+
address@hidden valori numerici
address@hidden valori tipo stringa
address@hidden valori scalari
address@hidden scalari, valori
+I dati, in particolare in @command{awk}, possono avere valori numerici, come 42
+o 3.1415927, o avere come valore delle stringhe. Un valore di tipo stringa @`e
+essenzialmente qualsiasi cosa che non sia un numero, per esempio un nome. Le
+stringhe sono talora chiamate @dfn{dati di tipo carattere}, poich@'e
memorizzano
+i singoli caratteri che le formano. Le singole variabili, come pure le
+variabili numeriche e di tipo stringa, sono definite come valori
address@hidden Raggruppamenti di valori, come i vettori, non sono scalari.
+
address@hidden
+La
address@hidden iftex
address@hidden del computer}, ha fornito un'introduzione di base ai tipi
+numerici (interi e a virgola mobile) e a come questi sono usati in un computer.
+Si consiglia di rileggere quelle informazioni, comprese le numerose avvertente
address@hidden esposte.
+
address@hidden stringhe nulle
+Mentre @`e probabile che ci si sia abituati all'idea di un numero senza un
valore
+(address@hidden, allo zero), richiede un po' address@hidden di riflessione
abituarsi all'idea di
+dati di tipo carattere a lunghezza zero. Nonostante address@hidden, questo
tipo di dato
+esiste. @`E chiamato @dfn{stringa nulla}. La stringa nulla @`e un dato di
tipo
+carattere che non ha un valore. In altre parole, @`e vuoto. Si scrive
address@hidden@dotless{i}} nei
+programmi @command{awk}: @code{""}.
+
+Gli esseri umani sono abituati a usare il sistema decimale, address@hidden a
base 10.
+In base 10, i numeri vanno da 0 a 9, e poi ``vengono riportati'' nella
+colonna successiva. (Chi si ricorda la scuola elementare? 42 = 4 x 10 + 2.)
+
+Ma esistono anche altre basi per i numeri. I computer normalmente usano
+la base 2 o @dfn{binaria}, la base 8 o @dfn{ottale}, e la base 16 o
address@hidden Nella numerazione binaria, ogni colonna rappresenta il
+doppio del valore della colonna alla sua destra. Ogni colonna address@hidden
contenere
+solo uno 0 o un 1. Quindi, il numero binario 1010 rappresenta (1 x 8) + (0 x
+4) + (1 x 2) + (0 x 1), ossia il numero decimale 10. Le numerazioni ottale ed
+esadecimale sono trattate address@hidden ampiamente
address@hidden
+in
address@hidden ifnottex
address@hidden
+nella
address@hidden iftex
address@hidden non-decimali}.
+
+Al livello address@hidden basso possibile, i computer memorizzano i valori
come gruppi di
+cifre binarie, o @dfn{bit}. I computer moderni raggruppano i bit in gruppi di
+otto, detti @dfn{byte}. Applicazioni avanzate talora hanno address@hidden di
+manipolare i bit direttamente, e @command{gawk} @`e dotato di apposite
funzioni.
+
+I programmi sono scritti nei linguaggi di programmazione. Esistono centinaia,
+se non migliaia, di linguaggi di programmazione. Uno dei address@hidden
diffusi @`e il
+linguaggio di programmazione C. Il linguaggio C ha esercitato un'influsso
+molto forte nella progettazione del linguaggio @command{awk}.
+
address@hidden Kernighan, Brian
address@hidden Ritchie, Dennis
+Ci sono state parecchie versioni di C. La prima @`e spesso designata come
+``K&R'' C, dalle iniziali di Brian Kernighan e Dennis Ritchie,
+gli autori del primo libro sul C. (Dennis Ritchie ha creato il linguaggio,
+e Brian Kernighan @`e stato uno dei creatori di @command{awk}.)
+
+A address@hidden degli anni '80 @`e iniziato uno sforzo rivolto a produrre uno
+standard internazionale per il C. Questo lavoro ha raggiunto un punto di
+arrivo nel 1989 con la produzione dello standard ANSI per il C.
+Questo standard @`e diventato uno standard ISO nel 1990.
+Nel 1999, uno standard ISO C revisionato @`e stato approvato e pubblicato.
+Dove @`e opportuno, POSIX @command{awk} @`e compatible con lo standard
+ISO C del 1999.
+
+
address@hidden Glossario
address@hidden Glossario
+
address@hidden @asis
address@hidden Abbraccio mortale
+La situazione in cui due processi che comunicano tra loro sono entrambi
bloccati, in
+attesa che l'altro processo faccia qualcosa.
+
address@hidden Ada, linguaggio di programmazione
address@hidden linguaggio di programmazione, Ada
address@hidden Ada
+Un linguaggio di programmazione originalmente definito dal Department of
+Defense U.S.A.@: per la programmazione integrata. @`E stato progettato per
+favorire dei buoni metodi da seguire nell'ingegneria del software.
+
address@hidden Ambiente
+Si veda ``Variabili d'ambiente''.
+
address@hidden @`Ancora
+I metacaratteri @dfn{regexp} @samp{^} e @samp{$}, che richiedono che la
+corrispondenza che si sta cercando si trovi all'inizio o alla fine di una
+stringa, rispettivamente.
+
address@hidden angolo buio
address@hidden Angolo buio
+Un'area del linguaggio le cui specifiche spesso non erano (o ancora non
+sono) chiare, col risultato di ottenere un comportamente inatteso o non
+desiderabile.
+Tali aree sono segnalate in questo @value{DOCUMENT} con
address@hidden
+il disegno di una torcia a margine
address@hidden iftex
address@hidden
+``(a.b.)'' nel testo
address@hidden ifnottex
+e sono riportate nell'indice analitico sotto la voce ``angolo buio''.
+
address@hidden ANSI
address@hidden ANSI
+L'American National Standards Institute. Questo ente produce
+parecchi standard, e tra questi gli standard per i linguaggi di
+programmazione C e C++.
+Questi standard spesso diventano anche internazionali. Si veda anche
+``ISO''.
+
address@hidden Argomento
+Un argomento address@hidden essere due cose differenti. address@hidden essere
un'opzione o un
address@hidden passato a un comando mentre lo si invoca dalla riga dei comandi,
+oppure address@hidden essere qualcosa passato a una @dfn{funzione} all'interno
di un
+programma, per esempio all'interno di @command{awk}.
+
+In quest'ultimo caso, un argomento address@hidden essere passato a una
funzione in
+due modi. Nel primo modo @`e passato come valore alla funzione chiamata,
+ossia una copia del valore della variabile @`e reso disponibile alla funzione
+chiamata, ma la variabile originale non address@hidden essere modificata dalla
+funzione stessa. Nel secondo modo l'argomento @`e passato per riferimento,
+ossia un puntatore alla variabile in questione @`e passato alla funzione, che
address@hidden quindi modificarla direttamente. In @command{awk} le variabili
scalari
+sono passate per valore, e i vettori sono passati per riferimento.
+Si veda ``Passaggio per valore/riferimento''.
+
address@hidden Arrotondamento
+Arrotondare il risultato di un'operazione aritmetica address@hidden essere
difficile.
+C'@`e address@hidden di un modo di arrotondare, e in @command{gawk} @`e
possibile scegliere
+quale metodo dovrebbe essere usato all'interno di un programma.
address@hidden modi di arrotondare}.
+
address@hidden Assegnamento
+Un'espressione @command{awk} che cambia il valore di qualche variabile o
+dato oggetto di @command{awk}. Un oggetto a cui si address@hidden assegnare
un valore
address@hidden detto un @dfn{lvalue}. I valori
+assegnati sono chiamati @dfn{rvalue}.
address@hidden di assegnamento}.
+
address@hidden Spencer, Henry
address@hidden @command{sed}, programma di address@hidden
address@hidden programma di address@hidden @command{sed}
address@hidden incredibile assembler (@command{aaa}) scritto in @command{awk}
address@hidden Assembler incredibilmente scritto in @command{awk}
+Henry Spencer dell'address@hidden di Toronto ha scritto un assembler adatto a
+molti diversi hardware, usando solo @dfn{script} @command{sed} e
address@hidden @`E lungo migliaia di righe, e include
+la descrizione dell'hardware di
+numerosi micro-computer a 8 bit. @`E un
+buon esempio di programma per cui sarebbe stato
+meglio utilizzare un altro linguaggio.
+Si address@hidden scaricare da @uref{http://awk.info/?awk100/aaa}.
+
address@hidden Asserzione
+Un'istruzione in un programma che afferma che una condizione @`e verificata in
+un dato punto di un programma.
+Utile per ragionare su come si suppone funzioni un programma.
+
address@hidden Azione
+Una serie di istruzioni @command{awk} associate a una regola. Se
+l'espressione di ricerca della regola individua un record in input,
address@hidden esegue su quel record l'azione relativa. Le azioni sono
+sempre racchiuse tra parentesi graffe.
+(@xref{Panoramica sulle azioni}).
+
address@hidden Bash
+La versione GNU della shell standard
address@hidden
+(il @address@hidden @b{SH}ell).
address@hidden ifnotinfo
address@hidden
+(il Bourne-Again SHell).
address@hidden ifinfo
+Si veda anche ``Bourne Shell''.
+
address@hidden Binario
+Notazione a base due, che usa le cifre @address@hidden Poich@'e
+i circuiti elettronici funzionano ``naturalmente'' in base 2
+(basta pensare a Off/On), ogni cosa all'interno di un computer @`e
+calcolata usando la base 2. Ciascuna cifra rappresenta la presenza
+(o l'assenza) di una potenza di 2 ed @`e chiamata un @dfn{bit}.
address@hidden@dotless{i}}, per esempio, il numero in base due @code{10101}
rappresenta il
+numero in base decimale 21, ((1 x 16) + (1 x 4) + (1 x 1)).
+
+Poich@'e i numeri in base due diventano rapidamente molto lunghi
+sia da leggere che da scrivere, normalmente li si unisce a gruppi di tre
+(ossia, sono visti come numeri ottali) o a gruppi di quattro (ossia, sono
+visti come numeri esadecimali). Non c'@`e un modo diretto per inserire
+numeri a base due in un programma C. Se necessario, tali numeri vengono
+solitamente inseriti come numeri ottali o esadecimali.
+Il numero di cifre in base due contenuto nei registri usati per
+rappresentare i numeri interi all'interno dei computer @`e un'indicazione
+approssimativa della potenza di calcolo del computer stesso. La maggior
+parte dei computer oggi usa 64 bit per rappresentare i numeri interi nei
+registri di calcolo, ma registri a 32 bit, 16 bit e 8 bit sono stati
+largamente in uso in passato.
address@hidden non-decimali}.
+
address@hidden McIlroy, Doug
address@hidden biscotto della fortuna
address@hidden Biscotto della fortuna
+Una particolare perla di saggezza, segno, detto o ricordo
+prodotto da (o presentato a) un programma. (Con vivi ringraziamenti al Prof.
+Doug McIlroy).
address@hidden
+From: Doug McIlroy <address@hidden>
+Date: Sat, 13 Oct 2012 19:55:25 -0400
+To: address@hidden
+Subject: Re: origin of the term "cookie"?
+
+I believe the term "cookie", for a more or less inscrutable
+saying or crumb of information, was injected into Unix
+jargon by Bob Morris, who used the word quite frequently.
+It had no fixed meaning as it now does in browsers.
+
+The word had been around long before it was recognized in
+the 8th edition glossary (earlier editions had no glossary):
+
+cookie a peculiar goodie, token, saying or remembrance
+returned by or presented to a program. [I would say that
+"returned by" would better read "produced by", and assume
+responsibility for the inexactitude.]
+
+Doug McIlroy
+
+From: Doug McIlroy <address@hidden>
+Date: Sun, 14 Oct 2012 10:08:43 -0400
+To: address@hidden
+Subject: Re: origin of the term "cookie"?
+
+> Can I forward your email to Eric Raymond, for possible addition to the
+> Jargon File?
+
+Sure. I might add that I don't know how "cookie" entered Morris's
+vocabulary. Certainly "values of beta give rise to dom!" (see google)
+was an early, if not the earliest Unix cookie. The fact that it was
+found lying around on a model 37 teletype (which had Greek beta in
+its type box) suggests that maybe it was seen to be like milk and
+cookies laid out for Santa Claus. Morris was wont to make such
+connections.
+
+Doug
address@hidden ignore
+
address@hidden Bit
+Abbreviazione di ``Binary Digit'' [cifra binaria].
+Tutti i valori nella memoria di un computer sono rappresentati nella forma di
+cifre binarie: valori che sono zero o uno.
+Gruppi di bit possono essere interpretati differentemente---come numeri
+interi, numeri a virgola mobile, dati di tipo carattere, indirizzi di altri
+oggetti contenuti in memoria, o altri dati ancora.
address@hidden permette di lavorare con numeri a virgola mobile e stringhe.
address@hidden permette di manipolare bit con le funzioni predefinite
+descritte
address@hidden
+in
address@hidden ifnottex
address@hidden
+nella
address@hidden iftex
address@hidden a livello di bit}.
+
+I computer sono spesso definiti dal numero di bit che usano per rappresentare
+valori interi. Molti sistemi sono a 32-bit, ma i sistemi a 64-bit sono sempre
address@hidden numerosi, mentre i sistemi a 16-bit [e quelli a 8-bit] sono
praticamente
+scomparsi.
+
address@hidden Bourne Shell
+La shell standard (@file{/bin/sh}) in Unix e nei sistemi derivati da Unix,
+Originariamente scritto da Steven R.@: Bourne dei Bell Laboratories.
+Molte shell (Bash, @command{ksh}, @command{pdksh}, @command{zsh}) sono
+generalmente compatibili con la Bourne shell, anche quando offrono ulteriori
address@hidden
+
address@hidden C
+Il linguaggio di programmazione di sistema con cui @`e scritta la maggior parte
+del software GNU. Il linguaggio di programmazione @command{awk} ha una
+sintassi simile a quella del C, e
+questo @value{DOCUMENT} puntualizza, quando serve, le somiglianze esistenti
+fra @command{awk} e C.
+
+In generale, @command{gawk} tenta di essere ragionevolmente simile alla
+versione 1990 del C ISO.
+
address@hidden C Shell
+La C Shell (@command{csh} o la sua versione migliorata @command{tcsh}) @`e una
+shell Unix creata da Bill Joy verso la fine degli anni '70. La C shell si
+differenzia dalla altre shell per le sue address@hidden interattive, e per lo
+stile complessivo, che @`e abbastanza simile a quello del linguaggio C.
+La C shell non @`e compatibile all'indietro con la Bourne Shell, e per questo
+motivo un'attenzione speciale @`e necessaria se si convertono alla C shell
+degli script scritti per altre shell Unix, in particolare per address@hidden
che
+concerne la gestione delle variaili di shell.
+Si veda anche ``Bourne Shell''.
+
address@hidden C++
+Un linguaggio di programmazione molto diffuso, orientato agli oggetti,
+derivato dal C.
+
address@hidden Campo
+Quando @command{awk} legge un record in input, suddivide il record in parti
+separate da spazi vuoti (o da una @dfn{regexp} che individua il separatore,
+modificabile reimpostando la variabile predefinita @code{FS}). Tali parti
+sono dette campi. Se le parti sono di lunghezza fissa, si address@hidden
usare la
+variabile predefinita @code{FIELDWIDTHS} per descriverne le lunghezze.
+Se si desidera specificare i contenuti dei campi, piuttosto che il separatore
+fra i campi, si address@hidden usare la variabile predefinita @code{FPAT} per
farlo.
+(@xref{Separatori di campo},
address@hidden
+la
address@hidden iftex
address@hidden costante},
+e
address@hidden
+la
address@hidden iftex
address@hidden in base al contenuto}).
+
address@hidden ASCII
address@hidden ISO 8859-1
address@hidden ISO Latin-1
address@hidden caratteri (codifiche macchina di caratteri)
address@hidden insiemi di caratteri (codifiche macchina di caratteri)
address@hidden Unicode
address@hidden Caratteri
+L'insieme di codici numerici usati da un computer per rappresentare i
+caratteri (lettere, numeri, segni d'interpunzione, etc.) di un particolare
+paese o address@hidden L'insieme di caratteri address@hidden comunemente in
uso oggi @`e
+l'ASCII (American Standard Code for Information Interchange). Molti paesi
+europei usano un'estensione dell'ASCII
+nota come ISO-8859-1 (ISO Latin-1).
+L'insieme di caratteri @uref{http://www.unicode.org, Unicode} sta guadagnando
address@hidden e affermandosi come standard, e il suo uso @`e particolarmente
esteso
+nei sistemi GNU/Linux.
+
address@hidden Kernighan, Brian
address@hidden Bentley, Jon
address@hidden @command{chem}, programma di address@hidden
address@hidden programma di address@hidden @command{chem}
address@hidden CHEM
+Un preprocessore per @command{pic} che legge descrizioni di molecole
+e produce l'input a @command{pic} che serve a disegnarle.
address@hidden stato scritto in @command{awk}
+da Brian Kernighan e Jon Bentley, ed @`e disponibile in
address@hidden://netlib.org/typesetting/chem}.
+
address@hidden Classe di caratteri
+Si veda ``Espressione tra parentesi quadre''.
+
address@hidden programmi compilati
address@hidden Compilatore
+Un programma che traduce codici sorgente scritti in qualche linguaggio
+in codici eseguibili su un particolare computer. Il codice oggetto risultante
address@hidden quindi essere eseguito direttamente dal computer.
+Si veda anche ``Interprete''.
+
address@hidden Concatenazione
+Concatenare due stringhe significa unirle, producendo una nuova stringa.
+Per esempio, la stringa @samp{pippo} concatenata con
+la stringa @samp{pluto} produce la stringa @samp{pippopluto}.
+(@xref{Concatenazione}).
+
address@hidden Contatore di riferimenti
+Un meccanismo interno di @command{gawk} per minimizzare la address@hidden di
+memoria necessaria per contenere il valore delle variabili di tipo
+stringa. Se il valore assunto da una variabile @`e usato in address@hidden di
un
+posto nel programma, solo una copia del valore stesso @`e tenuta in
+memoria, e il contatore di riferimenti ad esso associato @`e aumentato di
+uno quando lo stesso valore @`e usato da un'ulteriore variabile, e diminuito
+di uno quando la variabile relativa non @`e address@hidden utilizzata. Quando
il
+contatore di riferimenti va a zero, la parte di memoria utilizzata per
+contenere il valore della variuabile @`e liberato.
+
address@hidden Coprocesso
+Un programma subordinato con il quale @`e possibile una comunicazione
+bidirezionale dal programma principale.
+
address@hidden Dati oggetto
+Sono costituiti da numeri e stringhe di caratteri. I numeri sono convertiti
+in stringhe e viceversa, a seconda delle address@hidden
+(@xref{Conversione}).
+
address@hidden Debugger
+Un programma che serve agli sviluppatori per rimuovere ``bug'' (de-bug) dai
+loro programmi.
+
address@hidden Dominio di testo
+Un nome unico che identifica un'applicazione.
+Usato per raggruppare messaggi che sono tradotti in fase di esecuzione
+nel linguaggio locale.
+
address@hidden Doppia precisione
+Una rappresentazione di numeri all'interno del computer che ha una parte
+espressa sotto forma di frazione. I numeri a doppia precisione hanno
address@hidden
+cifre decimali che quelli a singola precisione, ma le operazioni che la
+usano consumano address@hidden risorse di quelle
+eseguite in singola precisione. La doppia precisione @`e il formato con cui
address@hidden memorizza i valori numerici. Nel linguaggio C @`e il tipo di
+dati detto @code{double}.
+
address@hidden Editore di flusso
+Un programma che legge record da un flusso in input e li elabora uno o
address@hidden alla volta. Questo @`e diverso da quel che farebbe un programma
batch
+il quale potrebbe leggere completamente i file in input, prima di
+iniziare a fare alcunch@'e, ed @`e diverso anche da un programma interattivo,
che
+richiede input dall'utente [tipicamente, una riga alla volta].
+
address@hidden Effetto collaterale
+Un effetto collaterale ha luogo quando un'espressione ha un effetto ulteriore,
+invece di produrre solo un valore. Espressioni di assegnamento,
+incremento e decremento, e invocazioni di funzioni hanno effetti collaterali.
+(@xref{Operatori di assegnamento}).
+
address@hidden epoch, definizione di
address@hidden Epoca [Inizio del tempo in Unix]
+la data usata come ``inizio del tempo'' per i campi che contengono date.
+I valori del tempo nella maggior parte dei dei sistemi sono rappresentati
+in numero di secondi trascorsi dall'Epoca, con funzioni di libreria
+che consentono di convertire tali valori nei formati normali di data e ora.
+
+L'Epoca nei sistemi Unix e POSIX parte dal primo gennaio 1970 alle ore
+00:00:00 UTC.
+Si veda anche ``GMT'' e ``UTC''.
+
address@hidden Esadecimale
+Notazione per l'aritmetica in base 16, che usa le cifre @address@hidden e
+le lettere @address@hidden, con @samp{A}
+che rappresenta 10, @samp{B} che rappresenta 11, e address@hidden@dotless{i}}
via, fino a
address@hidden per 15.
+I numeri esadecimali sono scritti in C prefissandoli con @samp{0x},
+per indicarne la base. Quindi, @code{0x12} @`e 18 ((1 x 16) + 2).
address@hidden non-decimali}.
+
address@hidden Espressione booleana
address@hidden@dotless{i}} detta dal nome del matematico inglese George Boole.
+Si veda anche ``Espressione logica''.
+
address@hidden Espressione condizionale
+Un'espressione che usa l'operatore ternario @samp{?:}, come p.es.
address@hidden@var{expr1} ? @var{expr2} : @var{expr3}}. Dell'espressione
address@hidden viene calcolato il valore; se risulta verificata, il valore
+dell'intera espressione diviene quello di @var{expr2}; altrimenti il valore @`e
+quello di @var{expr3}. In ogni caso, solo una delle due espressioni
address@hidden e @var{expr3}
+viene calcolata. (@xref{Espressioni condizionali}).
+
address@hidden Espressione di confronto
+Una relazione che @`e vera o falsa, del tipo di @samp{a < b}.
+Espressioni di confronto sono usate nelle istruzioni
address@hidden, @code{while}, @code{do}, @code{for}
+e nelle espressioni di ricerca per scegliere quale record in input elaborare.
+(@xref{Tipi di variabile e confronti}).
+
address@hidden Espressione di intervallo
+Una parte di un'espressione regolare che permette di specificare
+corrispondenze multiple di qualche parte della @dfn{regexp}. Le espressioni di
+intervallo non erano originariamente ammesse nei programmi @command{awk}.
+
address@hidden Espressione di ricerca address@hidden
address@hidden (detta anche "criterio di ricerca" o "modello di ricerca")
+Le espressioni di ricerca individuano per @command{awk} a quali record in
+input sono applicabili determinate
+regole.
+
+Un'espressione di ricerca [pattern] @`e un'espressione condizionale specifica
+che viene confrontata con ogni record
+in input. Se la corrispondenza esiste, si dice che il modello @dfn{individua}
+il record in input. Una tipica espressione di ricerca potrebbe confrontare
+il record in input con un'espressione regolare.
+(@xref{Panoramica sui criteri di ricerca}).
+
address@hidden Espressione logica
+Un'espressione che usa gli operatori logici AND, OR e NOT,
+scritti come @samp{&&}, @samp{||}, e @samp{!} in @command{awk}.
+Spesso chiamate espressioni booleane, dal nome del matematico che per primo
+ha sistematizzato questo tipo di logica matematica.
+
address@hidden Espressione regolare
+un'espressione regolare (abbreviabile come address@hidden'') @`e un modello che
+descrive un assieme di stringhe, potenzialmente illimitato. Per esempio
+l'espressione regolare
address@hidden corrisponde a qualsiasi stringa che inizia con la lettera
address@hidden e termina con le lettere @samp{xp}. In @command{awk}, le
espressioni
+regolari sono usate nei modelli [pattern] e nelle espressioni condizionali.
+Le espressioni regolari possono contenere sequenze di protezione.
address@hidden
+(@xrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+(@xref{Espressioni regolari}).
address@hidden ifnottex
+
address@hidden Espressione regolare calcolata
+Si veda ``Espressioni regolari dinamiche''.
+
address@hidden Espressione regolare costante
+Un'espressione regolare costante @`e un'espressione regolare scritta tra barre,
+come @code{/pippo/}. A una tale espressione viene assegnato un valore quando
+si scrive un programma @command{awk} e non address@hidden essere modificata in
fase di
+esecuzione del programma. (@xref{Uso di @dfn{regexp}}.)
+
address@hidden Espressione regolare dinamica
+Un'espressione regolare dinamica @`e un'espressione regolare scritta come
+un'espressione normale. Potrebbe essere una costante stringa, come
address@hidden"pippo"}, ma potrebbe anche essere un'espressione il cui valore
@`e variabile
+(@xref{Espressioni regolari calcolate}).
+
address@hidden Espressione tra parentesi quadre
+All'interno di una @dfn{espressione regolare}, un'espressione racchiusa
+fra parentesi quadre sta a indicare che un singolo carattere appartiene
+a una specifica classe di caratteri. Un'espressione tra parentesi quadre
address@hidden contenere una lista di uno o address@hidden caratteri, come
@samp{[abc]}, un
+intervallo di caratteri, come @samp{[A-Z]}, o un nome, delimitato da
address@hidden:}, che designa un insieme di caratteri conosciuto, come
address@hidden:digit:]}. La forma di espressione tra parentesi quadre
+racchiusa tra @samp{:} @`e indipendente dalla rappresentazione binaria dei
+caratteri stessi, che potrebbe utilizzare le codifiche ASCII, EBCDIC, o
+Unicode, a seconda dell'architettura del computer, e della localizzazione.
+Si veda anche ``Espressioni regolari''.
+
address@hidden Espressione tra parentesi quadre complementata
+La negazione di una @dfn{espressione tra parentesi quadre}. Tutto
address@hidden che
address@hidden @`e descritto da una data espressione tra parentesi quadre.
+Il simbolo @samp{^} precede l'espressione tra parentesi quadre che viene
+negata. Per esempio: @samp{[[^:digit:]}
+designa qualsiasi carattere che non sia una cifra. @samp{[^bad]}
+designa qualsiasi carattere che non sia una delle lettere @samp{b}, @samp{a},
+o @samp{d}.
+Si veda ``Espressione tra parentesi quadre''.
+
address@hidden Estensione
+Una address@hidden aggiunta o una modifica a un linguaggio di programmazione
+o a un programma di address@hidden, non definita dallo standard di quel
linguaggio
+o di quel programma di address@hidden
address@hidden ha molte estensioni rispetto al POSIX @command{awk} (fin
+troppe).
+
address@hidden FDL
+Free Documentation License. Si veda ``Licenza Documentazione Libera''.
+
address@hidden File speciale
+Un @value{FN} interpretato internamente da @command{gawk}, invece che
+gestito direttamente dal sistema operativo in cui viene eseguito
address@hidden esempio, @file{/dev/stderr}.
+(@xref{File speciali}).
+
address@hidden Flag [Indicatore]
+Una variabile [di tipo booleano] che, se verificata, indica la presenza o
+l'assenza di qualche condizione.
+
address@hidden Formato
+Le stringhe di formato controllano il modo in cui le funzioni
address@hidden()}, @code{sprintf()} e l'istruzione @code{printf} visualizzano
+l'output che producono. Inoltre, le conversioni da numeri a stringhe sono
+controllate dalle stringhe di formato contenute nelle variabili predefinite
address@hidden e @code{OFMT}. (@xref{Lettere di controllo}).
+
address@hidden formattatore incredibilmente duttile (@command{awf})
address@hidden programma @command{awf} (formattatore incredibilmente duttile)
address@hidden Formattatore incredibilmente duttile (@command{awf})
+Henry Spencer all'address@hidden di Toronto ha scritto un formattatore che
+accetta un ampio sottoassieme dei comandi di formattazione @samp{nroff -ms}
+e @samp{nroff -man} usando
address@hidden e @command{sh}.
+Si address@hidden scaricare da @uref{http://awk.info/?tools/awf}.
+
address@hidden Fortran
+Abbreviazione di FORmula TRANslator (traduttore di formule), @`e uno dei primi
+linguaggi di programmazione, pensato per il calcolo scientifico.
address@hidden stato ideato da John Backus ed @`e disponibile a partire dal
1957. @`E ancora
+in uso ai giorni nostri.
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden Stallman, Richard
address@hidden Free Software Foundation
+Un'organizzazione senza fini di lucro dedicata alla
+produzione e distribuzione di software liberamente distribuibile.
address@hidden stata fondata da Richard M.@: Stallman, l'autore dell'originale
editor
+Emacs. GNU Emacs @`e la versione di Emacs maggiormente usata oggigiorno.
+
address@hidden FSF
+Si veda ``Free Software Foundation''.
+
address@hidden Funzione
+Una parte di un programma @command{awk} che si address@hidden chiamare da
qualsiasi
+punto del programma, per eseguire un compito. @command{awk} ha parecchie
+funzioni predefinite.
+Gli utenti possono definire essi stessi delle funzioni in qualsiasi parte
+del programma. Le funzioni possono essere ricorsive, ossia possono
+chiamare se stesse.
address@hidden
address@hidden
address@hidden iftex
address@hidden
address@hidden
address@hidden ifnottex
+In @command{gawk} @`e anche possibile avere funzioni condivise tra diversi
+programmi, incluse secondo address@hidden usando la direttiva
address@hidden@@include}
+(@pxref{Includere file}).
+In @command{gawk} il nome della funzione da chiamare address@hidden essere
generato
+in fase di esecuzione, ossia in maniera dinamica.
+L'estensione API di @command{gawk} fornisce funzioni di costruzione
+(@pxref{Funzioni di costruzione}).
+
address@hidden Funzioni predefinite
+Il linguaggio @command{awk} fornisce funzioni predefinite, che compiono
+calcoli vari, di tipo numerico, di input/output e di tipo carattere. Esempi
+sono @code{sqrt()} ([square root], la radice quadrata di un numero) e
address@hidden()} (che estrae una sottostringa da una stringa).
address@hidden fornisce funzioni per la gestione di data e ora,
+le operazioni a livello di bit, l'ordinamento di
+vettori, il controllo di tipo [di variabile] e la traduzione di stringhe
+in fase di esecuzione di progranna.
+(@xref{Funzioni predefinite}).
+
address@hidden @command{gawk}
+L'implementazione GNU di @command{awk}.
+
address@hidden GPL (General Public License)
address@hidden General Public License (GPL)
address@hidden GNU General Public License
address@hidden General Public License
+Un documento che descrive le condizioni alle quali @command{gawk} e i suoi
+file sorgenti possono essere distribuiti. (@xref{Copia}).
+
address@hidden GMT
+``Greenwich Mean Time''.
+Il termine tradizionalmente usato per UTC.
address@hidden la datazione usata internamente dai sistemi Unix e POSIX.
+Si veda anche ``Epoca'' e ``UTC''.
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden Progetto GNU
address@hidden GNU
+``GNU's not Unix'' (GNU non @`e Unix).
+Un progetto della Free Software Foundation, ancora in corso, che mira a creare
+un ambiente di calcolo completo, liberamente distribuibile, aderente allo
+standard POSIX.
+
address@hidden GNU/Linux
+Una variante del sistema GNU che usa il kernel Linux,
+invece del kernel proprio della Free Software Foundation, noto come Hurd.
+Il kernel Linux @`e un clone di Unix stabile, efficiente, completo di tutte le
address@hidden, ed @`e stato portato su varie architetture hardware.
address@hidden molto diffuso su sistemi del tipo dei Personal Computer, ma
funziona bene
+anche in parecchi altri computer.
+Il codice sorgente del kernel Linux @`e disponibile nei termini della GNU
General
+Public License, la qual cosa @`e forse il suo aspetto address@hidden rilevante.
+
address@hidden GPL
+Si veda ``General Public License''.
+
address@hidden Graffe
+I caratteri @address@hidden e @address@hidden Le parentesi graffe sono usate
in
address@hidden per delimitare azioni, istruzioni composte, e il codice che
+costituisce le funzioni.
+
address@hidden Guidato dai dati
+Una descrizione dei programmi @command{awk}, nei quali si specifica quali sono
+i dati che si vogliono elaborare, e cosa fare quando si trovano tali dati.
+
address@hidden I/O
+Abbreviazione per ``Input/Output,'' ovvero il trasferimento di dati da e verso
+un programma in esecuzione.
+
address@hidden Individuazione
+L'azione che consiste nel confrontare una stringa con un'espressione regolare.
+Se la @dfn{regexp} descrive qualcosa che @`e contenuto nella stringa, si dice
che
+la @dfn{individua}.
+
address@hidden Internazionalizzazione
+La procedura con cui si scrive o si modifica un programma
+in modo che possa inviare messaggi in lingue differenti, senza richiedere
+ulteriori modifiche al codice sorgente.
+
address@hidden Intero
+Un numero intero, address@hidden un numero che non ha una parte frazionaria.
+
address@hidden programmi interpretati
address@hidden Interprete
+Un programma che accetta come input del codice sorgente, e usa le
+istruzione contenute nello stesso per elaborare dati e fornire risultati.
address@hidden @`e tipicamente (ma non sempre) implementato come un interprete.
+Si veda anche ``Compilatore''.
+
address@hidden Intervallo (nelle righe di input)
+Una sequenza di righe consecutive nel/nei file in input. Un'espressione di
+ricerca address@hidden specificare intervalli di righe di input da far
elaborare ad
address@hidden oppure address@hidden specificare singole righe.
+(@xref{Panoramica sui criteri di ricerca}).
+
address@hidden ISO
address@hidden ISO
+Acronimo di International Organization for Standardization.
+Questo ente elabora degli standard internazionali in vari settori, inclusi i
+linguaggi di programmazione, come il C e il C++.
+In ambito informatico, standard importanti come quelli per il C, C++, e POSIX
+sono allo stesso tempo standard nazionali americani e standard internazionali
+ISO.
+In questo @value{DOCUMENT} lo Standard C @`e chiamato ``ISO C''.
+Si veda @uref{http://www.iso.org/iso/home/about.htm, il sito web ISO} per
+ulteriori informazioni sul nome dell'ente e sul suo acronimo di tre lettere,
+che rimane lo stesso in tutte le lingue.
+
address@hidden Istruzione
+Un'espressione all'interno di un programma @command{awk} nella parte
+"azione" di una regola @dfn{criterio di ricerca--azione}, o all'interno
+di una funzione @command{awk}. Un'espressione address@hidden essere un
assegnamento
+di variabile, un'operazione su un vettore, un ciclo, etc.
+
address@hidden Istruzione composta
+Una serie di istruzioni @command{awk}, racchiuse tra parentesi graffe.
+Le istruzioni composte possono essere nidificate [possono esserci
address@hidden livelli
+di parentesi graffe].
+(@xref{Istruzioni}).
+
address@hidden Istruzione di controllo
+Un'istruzione di controllo @`e un'istruzione per eseguire una data operazione
+o un insieme di operazioni all'interno di un programma @command{awk},
+se una determinata condizione @`e verificata.
+Istruzioni di controllo sono: @code{if}, @code{for}, @code{while}, e @code{do}
+(@pxref{Istruzioni}).
+
address@hidden Java, linguaggio di programmazione
address@hidden linguaggio di programmazione, Java
address@hidden Java
+Un moderno linguaggio di programmazione originalmente sviluppato da Sun
+Microsystems (ora Oracle) che prevede la programmazione orientata agli
+oggetti. Sebbene normalmente sia implementato compilando le istruzioni
+per una macchina virtuale standard (la JVM---Java Virtual Machine) il
+linguaggio address@hidden essere compilato per essere eseguito in maniera
nativa.
+
address@hidden Korn Shell
+La Korn Shell (@command{ksh}) @`e una shell Unix sviluppata da David Korn,
+presso i Bell Laboratories, nei primi anni '80. La Korn shell @`e
+compatibile all'indietro con la Bourne shell e comprende molte address@hidden
+presenti nella C Shell.
+Si veda anche ``Bourne Shell''.
+
address@hidden LDL
+Si veda ``Licenza Documentazione Libera''.
+
address@hidden LGPL (Lesser General Public License)
address@hidden Lesser General Public License (LGPL)
address@hidden GNU Lesser General Public License
address@hidden Lesser General Public License
+Questo documento descrive i termini nei quali possono essere distribuiti
+degli archivi contenenti librerie in formato eseguibile o oggetti condivisi,
+e il relativo codice sorgente.
+
address@hidden LGPL
+Si veda ``Lesser General Public License''.
+
address@hidden Licenza Documentazione Libera
+Questo documento descrive i termini in base ai quali questo @value{DOCUMENT}
address@hidden pubblicato e address@hidden essere copiato.
+(@xref{Licenza per Documentazione Libera GNU (FDL)}).
+
address@hidden Linguaggio @command{awk}
+Il linguaggio in cui i programmi @command{awk} sono scritti.
+
address@hidden Linux
+Si veda ``GNU/Linux''.
+
address@hidden Lista di caratteri
+Si veda ``Espressione tra parentesi quadre''.
+
address@hidden Localizzazioni
+La address@hidden che fornisce i dati necessari perch@'e un programma
+internazionalizzato interagisca con l'utente in un particolare linguaggio.
+
address@hidden @dfn{Lvalue}
+[left-value, ossia valore a sinistra] Un'espressione che address@hidden stare
alla
+sinistra di un operatore di assegnamento.
+Nella maggior parte dei linguaggi, gli @dfn{lvalue} possono essere variabili o
+elementi di un vettore. In @command{awk}, un designatore di campo
address@hidden anche
+essere usato come un @dfn{lvalue}.
+
address@hidden Marcatura temporale
+Un valore nel formato ``secondi a partire dall'epoch'' usato dai sistemi Unix
+e POSIX. Usato per le funzioni @command{gawk}
address@hidden()}, @code{strftime()}, e @code{systime()}.
+Si veda anche ``Epoca,'' ``GMT,'' e ``UTC''.
+
address@hidden Metacaratteri
+Caratteri usati all'interno di una @dfn{regexp} e che non rappresentano se
+stessi.
+Servono invece per rappresentare operazioni con espressioni regolari, come
+per esempio delle ripetizioni, dei raggruppamenti, o delle alternanze.
+
address@hidden Nidificazione
+Una nidificazione si riscontra dove l'informazione @`e organizzata a strati,
+o dove degli oggetti contengono altri oggetti simili.
+In @command{gawk} la direttiva @code{@@include}
address@hidden essere nidificata. La nidificazione ``naturale'' delle operazioni
+aritmetiche e logiche address@hidden essere modificato attraverso l'uso di
parentesi.
+(@pxref{Precedenza}).
+
address@hidden No-op
+Un'operazione che non fa nulla.
+
address@hidden Numero
+Un dato oggetto il cui valore @`e numerico. Le implementazioni di @command{awk}
+usano numeri a virgola mobile in doppia precisione per rappresentare i numeri.
+Le primissime implementazioni di @command{awk} usavano numeri a virgola mobile
+in singola precisione.
+
address@hidden Numero a virgola mobile
+Spesso descritto, in termini matematici, come un numero ``razionale'' o reale,
address@hidden soltanto un numero che address@hidden avere una parte
frazionaria.
+Si veda anche ``Doppia precisione'' e ``Singola precisione''.
+
address@hidden Operatori di espressioni regolari
+Si veda ``Metacaratteri''.
+
address@hidden Ottale
+Notazione avente come base 8, nella quale le cifre sono @address@hidden
+I numeri ottali in C sono scritti premettendo uno @samp{0},
+per indicare la base. Quindi, @code{013} @`e 11 ((1 x 8) + 3).
address@hidden non-decimali}.
+
address@hidden Parentesi Graffe
+Si veda ``Graffe''.
+
address@hidden Parola chiave
+nel linguaggio @command{awk}, una parola chiave (keyword) @`e una parola
+che ha un significato speciale. Queste parole sono riservate e non possono
+essere usate come nomi di variabili.
+
+Le parole chiave di @command{gawk} sono:
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
address@hidden,
address@hidden@dots{}while},
address@hidden,
address@hidden,
address@hidden@dots{}in},
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+e
address@hidden
+
address@hidden PEBKAC
+Un acronimo inglese che descrive qual @`e probabilmente la causa
address@hidden frequente
+di problemi nell'uso di un computer. (@dfn{Problem Exists Between Keyboard and
+Chair} [il problema si trova tra la tastiera e la sedia].)
+
address@hidden Percorso di ricerca
+In @command{gawk}, una lista di directory in cui cercare file contenenti del
+codice sorgente per @command{awk}.
+Nella shell, una lista di directory in cui ricercare un programma eseguibile.
+
address@hidden Plug-in
+Si veda ``Estensione''.
+
address@hidden POSIX
+Il nome di una serie di standard che specificano l'interfaccia di un Sistema
+Operativo Portabile (Portable Operating System). La ``IX'' specifica
+che questi standard sono stati originati dallo Unix.
+Lo standard address@hidden rilevante per gli utenti @command{awk} @`e lo
address@hidden Standard for Information Technology, Standard 1003.1-2008}.
+Lo standard POSIX 2008 address@hidden essere trovato in rete all'indirizzo:
address@hidden://www.opengroup.org/onlinepubs/9699919799/}.
+
address@hidden Precedenza
+L'ordine in cui le operazioni sono eseguite quando si usano degli operatori
+se non si stabiliscono precedenze per mezzo di parentesi.
+
address@hidden Private
+Variabili e/o funzioni che sono riservate all'uso esclusivo di funzioni di
+libreria, e non per il programma principale @command{awk}. Un'attenzione
+particolare va prestata quando si desigano tali variabili e funzioni.
+(@xref{Nomi di variabili di libreria}).
+
address@hidden Programma @command{awk}
+Un programma @command{awk} consiste in una serie di @dfn{espressioni di
+ricerca} e @dfn{azioni}, che formano delle @dfn{regole}. Per ogni record in
+input a un progranna, le regole del programma sono elaborate nell'ordine in
+cui sono scritte. I programmi
address@hidden possono anche contenere definizioni di funzioni.
+
address@hidden Record
+Si veda ``Record in input'' e ``Record in output''.
+
address@hidden Record in input
+Una singola parte di dati letta da @command{awk}. Solitamente, un
+record in input di @command{awk} consiste in una linea di testo.
+(@xref{Record}).
+
address@hidden Record in output
+Un singolo pezzo di dati scritto da @command{awk}. Solitamente, un
+record in output di @command{awk} consiste di una o address@hidden righe di
testo.
address@hidden
+
address@hidden Ricorsione
+Quando una funzione chiama se stessa, direttamente o indirettamente.
+Se questo @`e chiaro, si address@hidden passare a leggere la definizione
successiva.
+Altrimenti, si veda la voce ``Ricorsione''.
+
address@hidden @dfn{regexp}
+Si veda ``Espressione regolare''.
+
address@hidden Regola
+Un segmento di un programma @command{awk} che specifica come trattare singoli
+record in input. Una regola consiste in una @dfn{espressione di ricerca} e in
+una @dfn{azione}.
address@hidden legge un record in input; poi, per ogni regola, se il record in
+input soddisfa l'espressione di ricerca della regola, @command{awk} esegue
+l'azione specificata dalla regola.
+Altrimenti, la regola non ha alcun effetto su quel record in input.
+
address@hidden Ridirezione
+Ridirezione significa ricevere input da quaclosa che non sia il flusso dello
+standard input, o dirigere output a qualcosa di diverso dal flusso dello
+standard output.
+
+Si address@hidden ridirigere input all'istruzione @code{getline} usando gli
operatori
address@hidden<}, @samp{|}, e @samp{|&}.
+Si address@hidden ridirigere l'output delle istruzioni @code{print} e
@code{printf} verso
+un file o un comando di sistema, usando gli operatori @samp{>}, @samp{>>},
address@hidden|}, e @samp{|&}.
+(@xref{Getline},
+e @ref{Ridirezione}).
+
address@hidden @dfn{Rvalue}
+[right-value, ossia valore a destra] Un valore che address@hidden apparire
alla destra
+di un operatore di assegnazione.
+In @command{awk}, essenzialmente ogni espressione ha un valore.
+Ognuno di questi valori @`e un @dfn{rvalue}.
+
address@hidden Scalare
+Un valore singolo, sia numerico che di tipo stringa.
+Le variabili normali sono scalari; i vettori e le funzioni non lo sono.
+
address@hidden Scorciatoia
+La natura degli operatori logici @command{awk} @samp{&&} e @samp{||}.
+Se il valore dell'intera espressione in cui sono contenuti @`e determinabile
+valutando solo una parte iniziale dell'espressione, la parte seguente non @`e
+presa in considerazione.
+(@xref{Operatori booleani}).
+
address@hidden @dfn{Script} @command{awk}
+Un altro nome per designare un programma @command{awk}.
+
address@hidden @command{sed}
+Si veda ``Editore di flusso''.
+
address@hidden Seme
+Il valore iniziale, o il punto di partenza, di una sequenza di numeri casuali.
+
address@hidden Sequenze di protezione
+Una speciale sequenza di caratteri usata per descrivere caratteri non
+stampabili, come @samp{\n} (ritorno a capo) o @samp{\033} per il carattere
+ASCII ESC (Escape). (@xref{Sequenze di protezione}).
+
address@hidden Shell
+Il programma che interpreta i comandi nei sistemi Unix e in quelli che
+rispettano lo standard POSIX.
+La shell funziona sia interattivamente che come un linguaggio di
+programmazione, che elabora file sequenziali, detti @dfn{script} di shell.
+
address@hidden Singola precisione
+Una rappresentazione di numeri all'interno del computer che ha una parte
+espressa sotto forma di frazione. I numeri a singola precisione hanno meno
+cifre significative di quelli a doppia precisione, ma le operazioni relative
+richiedono talora meno risorse elaborative da parte del computer.
+Questo tipo di numero @`e quello usato da alcune tra le prime versioni di
address@hidden per memorizzare valori numerici. Nel linguaggio C, sono numeri
+di tipo @code{float}.
+
address@hidden Spazio
+Il carattere generato premendo la barra spaziatrice sulla tastiera.
+
address@hidden Spazio vuoto
+Una sequenza di spazi, TAB, o caratteri di ritorno a capo presenti in un
+record in input o in una stringa.
+
address@hidden Stringa
+Un dato che consiste in una sequenza di caratteri, come @samp{Io sono una
+stringa}. Le costanti stringa sono scritte tra doppi apici nel linguaggio
address@hidden e possono contenere sequenze di protezione
+(@xref{Sequenze di protezione}).
+
address@hidden Stringa nulla
+Una stringa che non contiene alcun carattere. @`E rappresentabile
+esplicitamente nei programmi @command{awk} mettendo due caratteri di
+doppio apice uno dietro all'altro (@code{""}). La si address@hidden inserire
nei dati
+in input mettendo due separatori di campo uno dietro all'altro.
+
address@hidden Stringa vuota
+Si veda ``Stringa nulla''.
+
address@hidden Tab
+Il carattere generato premendo il tasto @kbd{TAB} sulla tastiera.
+Normalmente address@hidden generare sino a otto spazi in output.
+
address@hidden Linux
address@hidden GNU/Linux
address@hidden Unix
address@hidden sistemi operativi basati su BSD
address@hidden NetBSD
address@hidden FreeBSD
address@hidden OpenBSD
address@hidden Unix
+Un sistema operativo per computer originalmente sviluppato nei primi anni '70
+presso gli AT&T Bell Laboratories. Inizialmente si diffuse nelle
address@hidden
+di tutto il mondo e in seguito si estese agli ambienti del mondo del lavoro
+come un sistema per lo sviluppo del software e come server di rete.
+Ci sono parecchie versioni di Unix a pagamento, come pure parecchi sistemi
+operativi modellati su Unix e il cui codice sorgente @`e liberamente
+disponibile. (come GNU/Linux, @uref{http://www.netbsd.org, NetBSD},
address@hidden://www.freebsd.org, FreeBSD}, e
address@hidden://www.openbsd.org, OpenBSD}).
+
address@hidden UTC
+L'abbreviazione comune per ``Universal Coordinated Time'' (tempo coordinato
+universale). Questa @`e l'ora standard di Greenwich, (UK), usata come tempo
+di riferimento per i calcoli relativi a marcature temporali.
+Si veda anche ``Epoca'' e ``GMT''.
+
address@hidden Variabile
+Un nome per designare un valore. In @command{awk}, le variabili possono
+essere degli scalari o dei vettori.
+
address@hidden Variabili d'ambiente
+Una collezione di stringhe, in formato @address@hidden@var{valore}}, che
+ogni programma ha a disposizione. Gli utenti in generale assegnano valori
+alle variabili d'ambiente per fornire informazioni a vari programmi.
+Esempi tipici sono le variabili d'ambiente @env{HOME} e @env{PATH}.
+
address@hidden Variabili predefinite
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+e
address@hidden
+sono le variabili con un significato speciale in @command{awk}.
+In address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+e
address@hidden
+sono le variabili con un significato speciale in @command{gawk}.
+Se i loro valori sono modificati, il contesto di esecuzione di @command{awk}
+cambia.
+(@xref{Variabili predefinite}).
+
address@hidden Vettore
+Un raggruppamento di molti valori con uno stesso nome.
+La maggior parte dei linguaggi fornisce solo vettori sequenziali.
address@hidden fornisce vettori associativi.
+
address@hidden Vettore associativo
+Un vettore i cui indici possono essere numeri o stringhe, e non solamente
+interi sequenziali compresi in un intervallo prestabilito.
+
address@hidden table
+
address@hidden ifclear
+
address@hidden The GNU General Public License.
+
address@hidden Copia
address@hidden Licenza Pubblica Generale GNU (GPL)
address@hidden
address@hidden Versione 3, 29 Giugno 2007
address@hidden ifnotdocbook
address@hidden
+<subtitle>Versione 3, 29 Giugno 2007</subtitle>
address@hidden docbook
+
address@hidden This file is intended to be included within another document,
address@hidden hence no sectioning command or @node.
+
address@hidden
+Copyright @copyright{} 2007 Free Software Foundation, Inc.
@url{http://fsf.org/}
+
+This is an unofficial translation of the GNU General Public License into
+Italian. It was not published by the Free Software Foundation, and does not
+legally state the distribution terms for software that uses the GNU GPLâonly
+the original English text of the GNU GPL does that. However, we hope that this
+translation will help Italian speakers understand the GNU GPL better.
+
+Questa @`e una traduzione non ufficiale in italiano della GNU General Public
+License. Questa traduzione non @`e stata pubblicata dalla Free Software
+Foundation, e non stabilisce i termini legali di distribuzione del software
+che usa la GNU GPL. Soltanto la versione originale in inglese della GNU GPL
+fa address@hidden Ciononostante, speriamo che questa traduzione possa aiutare
gli utenti
+di lingua italiana a comprendere un po' meglio la GNU GPL.
+
+A chiunque @`e permesso copiare e ridistribuire copie esatte di questo
documento
+di licenza, ma non @`e in alcun modo consentito apportarvi modifiche.
address@hidden display
+
address@hidden fakenode --- for prepinfo
address@hidden Preambolo
+
+La GNU General Public License @`e una licenza libera e basata su copyleft per
+software e altri tipi di opere.
+
+Le licenze della maggior parte del software e di altre opere materiali sono
+pensate per togliere la address@hidden di condividere e modificare tali opere.
Al
+contrario, la GNU General Public License ha l'obiettivo di garantire la
address@hidden di condividere e modificare tutte le versioni di un programma e
di
+fare in modo che esso rimanga software libero per tutti gli utenti. Noi, Free
+Software Foundation, usiamo la GNU General Public License per la maggior parte
+del nostro software; essa viene applicata anche a qualunque altro software
+rilasciato dall'autore sotto questa licenza. Chiunque address@hidden
utilizzare questa
+licenza per i suoi programmi.
+
+Quando parliamo di software libero (free software), ci riferiamo al concetto
+di address@hidden, non al prezzo. Le nostre General Public License sono
progettate
+per garantire che chiunque abbia la address@hidden di distribuire copie di
software
+libero (anche dietro pagamento di un prezzo, se lo desidera), che chiunque
+riceva o possa ricevere il codice sorgente se lo vuole, che chiunque possa
+apportare modifiche al software o utilizzarne delle porzioni in altri software
+liberi, e che chiunque sappia che ha il diritto di fare tutte queste cose col
+software libero.
+
+Per proteggere i vostri diritti, abbiamo la address@hidden di impedire che
altri vi
+neghino questi diritti o vi obblighino a rinunciarvi. Pertanto, chiunque
+distribuisce o modifica software rilasciato con questa licenza assume dei
+precisi doveri: il dovere di rispettare la address@hidden degli altri.
+
+Per esempio, chi distribuisce copie di un programma rilasciato sotto questa
+licenza, sia gratis che dietro pagamento di un prezzo, e' obbligato a
+riconoscere a chi riceve il software esattamente gli stessi diritti che ha
+ricevuto. Deve garantire che chi riceva il software abbia o possa avere
+accesso al codice sorgente. E deve chiaramente far conoscere ai destinatari
+del software queste condizioni, address@hidden@dotless{i}} che essi conoscano
quali sono i loro
+diritti.
+
+Gli sviluppatori che usano la GNU GPL proteggono i vostri diritti in due modi:
+(1) Rivendicando il copyright sul software, e (2) offrendovi questa licenza
+che vi garantisce il diritto legale di copiarlo e/o di modificarlo.
+
+Al fine di proteggere gli sviluppatori e gli autori, la GPL spiega chiaramente
+che non c'@`e nessuna garanzia per questo software libero. Nell'interesse degli
+utenti e degli autori, la GPL impone che le versioni modificate del software
+vengano esplicitamente marcate come ``modificate'', in maniera tale che
+eventuali problemi non vengano erroneamente attribuiti agli autori delle
+versioni precedenti.
+
+Alcuni dispositivi sono progettati per negare agli utenti l'installazione o
+l'esecuzione di versioni modificate del software che gira sugli stessi, anche
+se il costruttore si riserva la address@hidden di farlo. address@hidden @`e
fondamentalmente
+incompatibile con l'obiettivo di garantire la address@hidden degli utenti di
+modificare il software. Una ripetizione sistematica di tali abusi avviene nel
+campo dei dispositivi per usi individuali, e address@hidden rende questi abusi
ancora address@hidden
+inaccettabili. Pertanto, abbiamo realizzato questa versione della GPL al fine
+di proibire queste pratiche. Se problemi simili dovessero sorgere in altri
+ambiti, saremo pronti ad estendere queste misure a questi nuovi ambiti in
+versioni future della GPL, nella maniera che si address@hidden necessaria per
+difendere la address@hidden degli utenti.
+
+In conclusione, tutti i programmi sono costantemente minacciati dai brevetti
+sul software. Gli Stati non dovrebbero permettere ai brevetti sul software di
+limitare lo sviluppo e l'utilizzo di software per computer, ma nei Paesi in
+cui address@hidden avviene noi vogliamo evitare in particolare il pericolo che
i brevetti
+sul software applicati ad un programma libero possano renderlo, a tutti gli
+effetti, proprietario. Per impedire address@hidden, la GPL assicura che non
@`e possibile
+utilizzare i brevetti sul software per rendere un programma non libero.
+
+I termini e le condizioni esatte per la copia, la distribuzione e la modifica
+del software sono riportate di seguito.
+
address@hidden fakenode --- for prepinfo
address@hidden TERMINI E CONDIZIONI
+
address@hidden 0
address@hidden Definizioni
+
+``Questa Licenza'' si riferisce alla versione 3 della GNU General Public
+License.
+
+``Copyright'' indica anche leggi simili al copyright che riguardano altri tipi
+di opere, come le maschere per la produzione di semiconduttori.
+
+``Il Programma'' indica qualunque opera che sia soggetta a copyright e che sia
+rilasciata sotto questa Licenza. I detentori della licenza sono indicati come
+``tu'' o ``voi''. Licenziatari e destinatari possono essere individui o
+organizzazioni.
+
+``Modificare'' un'opera significa copiare o adattare tutta o parte dell'opera
in
+una maniera che richieda un permesso di copyright, e non indica la semplice
+azione di fare una esatta copia dell'opera. L'opera risultante viene chiamata
+``versione modificata'' dell'opera precedente, oppure viene detta opera
``basata
+sulla'' opera precedente.
+
+Una ``opera coperta da questa licenza'' indica il Programma originale non
+modificato oppure un'opera basata sul Programma.
+
+``Propagare'' un'opera significa fare qualunque cosa con essa che, in mancanza
+di un esplicito permesso, ti renda direttamente o indirettamente perseguibile
+per violazione secondo le vigenti normative sul copyright, ad eccezione della
+semplice esecuzione del Programma su un computer o della modifica di una copia
+privata. La Propagazione include la copia, la distribuzione (con o senza
+modifiche), la messa a disposizione al pubblico e, in alcuni stati, altre
address@hidden simili e connesse.
+
+``Distribuire'' un'opera indica qualunque forma di propagazione che permetta a
+terze parti di effettuare o ricevere delle copie. La mera interazione con un
+utente attraverso una rete di computer, senza che ci sia alcun trasferimento
+di una copia, non @`e considerata ``Distribuzione''.
+
+Una interfaccia utente interattiva fornisce delle ``Adeguate Informazioni
+Legali'' soltanto nel caso in cui include una apposita address@hidden, resa
+adeguatamente visibile, che (1) visualizzi un'adeguata informazione di
+copyright, e (2) informi l'utente che non c'@`e alcuna garanzia sull'opera
+(eccetto nel caso in cui delle garanzie sono espressamente fornite), dica che
+il licenziatario address@hidden distribuire l'opera utilizzando questa
Licenza, indichi
+come @`e possibile prendere visione di una copia di questa Licenza. Se
+l'interfaccia presenta una lista di comandi o di opzioni, come per esempio un
address@hidden, una delle opzioni fornite nella lista deve rispettare questa
condizione.
+
address@hidden Codice Sorgente
+
+Il ``codice sorgente'' di un'opera indica la forma address@hidden indicata
dell'opera per
+effettuare modifiche su di essa. Il ``codice oggetto'' indica qualunque forma
+dell'opera che non sia codice sorgente.
+
+Una ``Interfaccia Standard'' @`e una interfaccia che risponde ad uno standard
+ufficiale definito da un ente di standardizzazione riconosciuto o, nel caso di
+interfacce specifiche per un particolare linguaggio di programmazione, una
+interfaccia che @`e largamente utilizzata dagli sviluppatori per sviluppare in
+tale linguaggio.
+
+Le ``Librerie di Sistema'' di un eseguibile includono qualsiasi cosa, eccetto
+l'opera nel suo insieme, che (a) sia inclusa nella normale forma di
+pacchettizzazione di un ``Componente Principale'', ma che non @`e parte di quel
+Componente Principale, e (b) che serva solo a consentire l'uso dell'opera con
+quel Componente Principale, o per implementare una Interfaccia Standard per la
+quale esista una implementazione disponibile al pubblico in forma sorgente. Un
+``Componente Principale'', in questo contesto, @`e un componente essenziale
+(kernel, gestore di finestre eccetera) dello specifico sistema operativo
+(ammesso che ce ne sia uno) sul quale l'eseguibile esegue, o un compilatore
+utilizzato per produrre il programma, o un interprete di codice oggetto
+utilizzato per eseguire il programma.
+
+Il ``Sorgente Corrispondente'' per un'opera in forma di codice oggetto @`e il
+codice sorgente necessario per generare, installare e (per un programma
+eseguibile) eseguire il codice oggetto e per modificare l'opera, inclusi gli
+script per controllare le suddette address@hidden di generazione,
installazione ed
+esecuzione. Non sono incluse le Librerie di Sistema usate dal programma, o gli
+strumenti di address@hidden generica o i programmi liberamente accessibili che
sono
+utilizzati, senza modifiche, per portare a termine le suddette address@hidden
ma che
+non fanno parte dell'opera. Per esempio, il sorgente corrispondente include i
+file con le definizioni delle interfacce associati ai file sorgente
+dell'opera, e il codice sorgente delle librerie condivise e sottoprogrammi
+collegati dinamicamente specificatamente necessari per il programma, ad
+esempio a causa di stretta comunicazione dati o di controllo di flusso tra
+questi sottoprogrammi e altre parti del programma.
+
+Il Sorgente Corrispondente non include qualunque cosa che l'utente possa
+rigenerare automaticamente da altre parti del Sorgente Corrispondente stesso.
+
+Il Sorgente Corrispondente di un'opera in forma di codice sorgente @`e l'opera
+stessa.
+
address@hidden Principali Diritti
+
+Tutti i diritti garantiti da questa Licenza sono garantiti per la durata del
+copyright sul Programma, e sono irrevocabili ammesso che le suddette
+condizioni siano rispettate. Questa Licenza afferma esplicitamente il tuo
+permesso illimitato di eseguire il Programma non modificato. Il risultato
+dell'esecuzione di un programma coperto da questa Licenza @`e a sua volta
+coperto da questa Licenza solo se il risultato stesso, a causa del suo
+contenuto, @`e un'opera coperta da questa Licenza. Questa Licenza riconosce il
+tuo diritto all'uso legittimo o altri diritti equivalenti, come stabilito
+dalla legislazione sul copyright.
+
+Puoi creare, eseguire e propagare programmi coperti da questa Licenza che tu
+non distribuisci, senza alcuna condizione fino a quando la tua Licenza rimane
+valida. Puoi distribuire opere coperte da questa Licenza ad altri al solo
+scopo di ottenere che essi facciano delle modifiche al programma
+esclusivamente per te, o che ti forniscano dei servizi per l'esecuzione di
+queste opere, ammesso che tu rispetti i termini di questa Licenza nel
+distribuire tutto il materiale per il quale non detieni il copyright. Coloro i
+quali creano o eseguono per conto tuo un programma coperto da questa Licenza
+lo fanno esclusivamente in tua vece, sotto la tua direzione e il tuo
+controllo, in maniera tale che sia proibito a costoro effettuare copie di
+materiale di cui detieni il copyright al di fuori della relazione che
+intrattengono nei tuoi confronti.
+
+Distribuire opere coperte da licenza in qualunque altra circostanza @`e
+consentito soltanto alle condizioni espresse in seguito. Non @`e consentito
+sottolicenziare le opere: la sezione 10 lo rende non necessario.
+
address@hidden Protezione dei diritti legali degli utenti dalle leggi
anti-elusione
+
+Nessun programma protetto da questa Licenza address@hidden essere considerato
parte di
+una misura tecnologica di restrizione che sottosta ad alcuna delle leggi che
+soddisfano l'articolo 11 del ``WIPO copyright treaty'' adottato il 20 Dicembre
+1996, o a simili leggi che proibiscono o limitano l'elusione di tali misure
+tecnologiche di restrizione.
+
+Quando distribuisci un programma coperto da questa Licenza, rifiuti tutti i
+poteri legali atti a proibire l'elusione di misure tecnologiche di restrizione
+ammesso che tale elusione sia effettuata nell'esercizio dei diritti garantiti
+da questa Licenza riguardo al programma coperto da questa Licenza, e rinunci
+all'intenzione di limitare l'address@hidden o la modifica del programma per far
+valere, contro i diritti degli utenti del programma, diritti legali tuoi o di
+terze parti che impediscano l'elusione di misure tecnologiche di restrizione.
+
address@hidden Distribuzione di Copie Esatte
+
+Ti @`e permesso distribuire copie esatte del codice sorgente del Programma come
+lo hai ricevuto, con qualunque mezzo, ammesso che tu aggiunga in maniera
+appropriata su ciascuna copia una appropriata nota di copyright; che tu lasci
+intatti tutti gli avvisi che affermano che questa Licenza e tutte le clausole
+non-permissive aggiunte in accordo con la sezione 7 sono valide per il codice
+che distribuisci; che tu lasci intatti tutti gli avvisi circa l'assenza di
+garanzia; che tu fornisca a tutti i destinatari una copia di questa Licenza
+assieme al Programma.
+
+Puoi richiedere il pagamento di un prezzo o di nessun prezzo per ciascuna
+copia che distribuisci, e puoi offrire supporto o garanzia a pagamento.
+
address@hidden Distribuzione di Versioni modificate del sorgente
+
+Puoi distribuire un'opera basata sul Programma, o le modifiche per produrla a
+partire dal Programma, nella forma di codice sorgente secondo i termini della
+sezione 4, ammesso che tu rispetti anche tutte le seguenti condizioni:
+
address@hidden a
address@hidden
+L'opera deve recare con address@hidden delle informazioni adeguate che
affermino che tu
+l'hai modificata, indicando la data di modifica.
+
address@hidden
+L'opera deve recare informazioni adeguate che affermino che essa @`e rilasciata
+sotto questa Licenza e sotto le condizioni aggiuntive secondo quanto indicato
+dalla Sezione 7. Questa condizione modifica la condizione espressa alla
+sezione 4 di ``lasciare intatti tutti gli avvisi''.
+
address@hidden
+Devi rilasciare l'intera opera, nel suo complesso, sotto questa Licenza a
+chiunque venga in possesso di una copia di essa. Questa Licenza address@hidden
pertanto
+applicata, assieme ad eventuali clausole aggiunte in osservanza della Sezione
+7, all'opera nel suo complesso, a tutte le sue parti, indipendentemente da
+come esse siano pacchettizzate. Questa Licenza nega il permesso di licenziare
+l'opera in qualunque altro modo, ma non rende nullo un tale permesso ammesso
+che tu lo abbia ricevuto separatamente.
+
address@hidden
+Se l'opera ha delle interfacce utente interattive, ciascuna deve mostrare
+delle Adeguate Informazioni Legali; altrimenti, se il Programma ha delle
+interfacce interattive che non visualizzano delle Adeguate Informazioni
+Legali, il tuo programma non @`e obbligato a visualizzarle.
address@hidden enumerate
+
+La giustapposizione di un'opera coperta da questa Licenza assieme ad altre
+opere separate e indipendenti, che non sono per loro natura estensioni del
+Programma, e che non sono combinate con esso a formare un altro programma
address@hidden
+grande, dentro o in uno stesso supporto di memorizzazione a lungo termine o di
+distribuzione, @`e semplicemente detto ``aggregato'' se la raccolta e il suo
+copyright non sono utilizzati per limitare l'accesso o i diritti legali degli
+utenti della raccolta stessa oltre address@hidden che ciascun singolo
programma consente.
+L'inclusione di un programma coperto da questa Licenza in un aggregato non
+comporta l'applicazione di questa Licenza alle altre parti dell'aggregato.
+
address@hidden Distribuzione in formato non-sorgente
+
+Puoi distribuire un programma coperto da questa Licenza in formato di codice
+oggetto secondo i termini delle sezioni 4 e 5, ammesso che tu fornisca anche
+il Sorgente Corrispondente in formato comprensibile da un computer sotto i
+termini di questa stessa Licenza, in uno dei seguenti modi:
+
address@hidden a
address@hidden
+Distribuendo il codice oggetto in, o contenuto in, un prodotto fisico (inclusi
+i mezzi fisici di distribuzione), accompagnato dal Sorgente Corrispondente su
+un supporto fisico duraturo comunemente utilizzato per lo scambio di software.
+
address@hidden
+Distribuendo il codice oggetto in, o contenuto in, un prodotto fisico (inclusi
+i mezzi fisici di distribuzione), accompagnato da un'offerta scritta, valida
+per almeno tre anni e valida per tutto il tempo durante il quale tu offri
+ricambi o supporto per quel modello di prodotto, di fornire a chiunque
+possieda il codice oggetto (1) una copia del Sorgente Corrispondente di tutto
+il software contenuto nel prodotto che @`e coperto da questa Licenza, su un
+supporto fisico duraturo comunemente utilizzato per lo scambio di software, ad
+un prezzo non superiore al costo ragionevole per effettuare fisicamente tale
+distribuzione del sorgente, oppure (2) accesso alla copia del Sorgente
+Corrispondente attraverso un server di rete senza alcun costo aggiuntivo.
+
address@hidden
+Distribuendo copie singole del codice oggetto assieme ad una copia
+dell'offerta scritta di fornire il Sorgente Corrispondente. Questa
address@hidden
address@hidden permessa soltanto occasionalmente e per fini non commerciali, e
solo se tu
+hai ricevuto il codice oggetto assieme ad una tale offerta, in accordo alla
+sezione 6b.
+
address@hidden
+Distribuendo il codice oggetto mediante accesso da un luogo designato (gratis
+o dietro pagamento di un prezzo), e offrendo un accesso equivalente al
+Sorgente Corrispondente alla stessa maniera a partire dallo stesso luogo senza
+costi aggiuntivi. Non devi obbligare i destinatari a copiare il Sorgente
+Corrispondente assieme al codice oggetto. Se il luogo dal quale copiare il
+codice oggetto @`e un server di rete, il Sorgente Corrispondente
address@hidden trovarsi su
+un server differente (gestito da te o da terze parti) che fornisca
address@hidden equivalenti per la copia, a patto che tu fornisca delle
+indicazioni chiare accanto al codice oggetto che indichino dove trovare il
+Sorgente Corrispondente. Indipendentemente da quale server ospiti il Sorgente
+Corrispondente, tu rimani obbligato ad assicurare che esso rimanga disponibile
+per tutto il tempo necessario a soddisfare queste condizioni.
+
address@hidden
+Distribuendo il codice oggetto mediante trasmissione peer-to-peer, a patto che
+tu informi gli altri peer circa il luogo in cui il codice oggetto e il
+Sorgente Corrispondente sono gratuitamente offerti al pubblico secondo i
+termini della sezione 6d.
+
address@hidden enumerate
+
+Una porzione separabile del codice oggetto, il cui sorgente @`e escluso dal
+Sorgente Corrispondente e trattato come Libreria di Sistema, non deve essere
+obbligatoriamente inclusa nella distribuzione del codice oggetto del
+programma.
+
+Un ``Prodotto Utente'' @`e un (1) ``prodotto consumer'', address@hidden
qualunque address@hidden
+personale tangibile che @`e normalmente utilizzata per scopi personali,
+familiari o domestici, oppure (2) qualunque cosa progettata o venduta per
+essere utilizzata in ambiente domestico. Nella classificazione di un prodotto
+come ``prodotto consumer'', i casi dubbi andranno risolti in favore dell'ambito
+di applicazione. Per un dato prodotto ricevuto da un dato utente, ``normalmente
+utilizzato'' si riferisce ad un uso tipico o comune di quella classe di
+prodotti, indipendentemente dallo stato dell'utente specifico o dal modo in
+cui l'utente specifico utilizza, o si aspetta o ci si aspetta che utilizzi, il
+prodotto. Un prodotto @`e un ``prodotto consumer'' indipendentemente dal fatto
che
+abbia usi commerciali, industriali o diversi da quelli ``consumer'', a meno che
+questi usi non rappresentino il solo modo utile di utilizzare il prodotto in
+questione.
+
+Le ``Informazioni di Installazione'' per un Prodotto Utente sono i metodi, le
+procedure, le chiavi di autorizzazioni o altre informazioni necessarie per
+installare ed eseguire versioni modificate di un programma coperto da questa
+Licenza all'interno di un Prodotto Utente, a partire da versioni modificate
+dei suoi Sorgenti Corrispondenti. Tali informazioni devono essere sufficienti
+ad assicurare che il funzionamento del codice oggetto modificato non sia in
+nessun caso proibito o ostacolato per il solo fatto che sono state apportate
+delle modifiche.
+
+Se distribuisci un codice oggetto secondo le condizioni di questa sezione in,
+o assieme, o specificatamente per l'uso in o con un Prodotto Utente, e la
+distribuzione avviene come parte di una transazione nella quale il diritto di
+possesso e di uso del Prodotto Utente viene trasferito al destinatario per
+sempre o per un periodo prefissato (indipendentemente da come la transazione
+sia caratterizzata), il Sorgente Corrispondente distribuito secondo le
+condizioni di questa sezione deve essere accompagnato dalle Informazioni di
+Installazione. Questa condizione non @`e richiesta se address@hidden tu
address@hidden una terza parte
+ha la address@hidden di installare versioni modificate del codice oggetto sul
+Prodotto Utente (per esempio, se il programma @`e installato su una ROM)
+
+La condizione che richiede di fornire delle Informazioni di Installazione non
+implica che venga fornito supporto, garanzia o aggiornamenti per un programma
+che @`e stato modificato o installato dal destinatario, o per il Prodotto
Utente
+in cui esso @`e stato modificato o installato. L'accesso ad una rete
address@hidden essere
+negato se le modifiche apportate impattano materialmente sull'address@hidden
+della rete o se violano le regole e i protocolli di comunicazione attraverso
+la rete.
+
+Il Sorgente Corrispondente distribuito, e le Informazioni di Installazione
+fornite, in accordo con questa sezione, devono essere in un formato che sia
+pubblicamente documentato (e con una implementazione pubblicamente disponibile
+in formato di codice sorgente), e non devono richiedere speciali password o
+chiavi per essere spacchettate, lette o copiate.
+
address@hidden Condizioni Aggiuntive
+
+Le ``Condizioni Aggiuntive'' sono condizioni che completano le condizioni di
+questa Licenza permettendo delle eccezioni a una o address@hidden delle
condizioni sopra
+elencate. Le condizioni aggiuntive che sono applicabili all'intero Programma
+devono essere considerate come se fossero incluse in questa Licenza, a patto
+che esse siano valide secondo le normative vigenti. Se alcune condizioni
+aggiuntive fanno riferimento soltanto ad alcune parti del Programma, quelle
+parti possono essere utilizzate separatamente sotto le stesse condizioni, ma
+l'intero Programma rimane sottoposto a questa Licenza senza riferimento ad
+alcuna condizione aggiuntiva.
+
+Quando distribuisci una copia di un programma coperto da questa Licenza, puoi,
+a tua discrezione, eliminare qualunque condizione aggiuntiva dalla copia, o da
+parte di essa. (Le Condizioni Aggiuntive possono essere scritte in maniera
+tale da richiedere la loro rimozione in certi casi di modifica del Programma).
+Puoi aggiungere Condizioni Aggiuntive su materiale, aggiunto da te ad un'opera
+coperta da questa Licenza, per il quale hai o puoi garantire un'adeguata
+licenza di copyright.
+
+Indipendentemente da qualunque altra condizione di questa Licenza, e per il
+materiale che aggiungi ad un'opera coperta da questa Licenza, puoi (se
+autorizzato dai legittimi detentori del copyright per il suddetto materiale)
+aggiungere alle condizioni di questa Licenza delle condizioni che:
+
address@hidden a
address@hidden
+Negano la garanzia o limitano la address@hidden del Programma in maniera
+differente da quanto riportato nelle sezioni 15 e 16 di questa Licenza; oppure
+
address@hidden
+Richiedono il mantenimento di specifiche e circostanziate informative legali o
+di note di attribuzione ad autori nel materiale o assieme alle Adeguate
+Informazioni Legali mostrate dal Programma che lo contiene; oppure
+
address@hidden
+Proibiscono di fornire informazioni errate o ingannevoli sull'origine e la
+provenienza del materiale in oggetto, o richiedono che versioni modificate di
+tale materiale siano appositamente marcate in maniera differente rispetto alla
+versione originale; oppure
+
address@hidden
+Limitano l'utilizzo per scopi pubblicitari del nome dei detentori del
+copyright o degli autori del materiale; oppure
+
address@hidden
+Rifiutano di garantire diritti secondo le leggi sulla address@hidden
intellettuale
+circa l'uso di nomi, marchi di fabbrica o similari; oppure
+
address@hidden
+Richiedono l'indennizzo dei detentori del copyright o degli autori del
+materiale in oggetto da parte di chi distribuisce il materiale (o versioni
+modificate dello stesso) con impegni contrattuali circa la address@hidden nei
+confronti del destinatario, per qualunque address@hidden che questi impegni
+contrattuali dovessero imporre direttamente ai suddetti detentori del
+copyright e autori.
address@hidden enumerate
+
+Tutte le altre condizioni addizionali non-permissive sono considerate
+``ulteriori restrizioni'', secondo il significato specificato alla sezione 10.
+Se il Programma o parti di esso contengono, all'atto della ricezione dello
+stesso, informative che specificano che esso @`e soggetto a questa Licenza
+assieme ad una condizione che @`e una ``ulteriore restrizione'', puoi rimuovere
+quest'ultima condizione. Se un documento di licenza contiene ulteriori
+restrizioni ma permette di rilicenziare o distribuire il Programma con questa
+Licenza, puoi aggiungere al Programma del materiale coperto dalle condizioni
+di quel documento di licenza, a patto che le ulteriori restrizioni non
+compaiano nelle versioni rilicenziate o ridistribuite.
+
+Se aggiungi ad un Programma coperto da questa Licenza delle condizioni
+aggiuntive in accordo con questa sezione, devi aggiungere anche, nei file
+sorgenti corrispondenti, un avviso che riassuma le condizioni aggiuntive
+applicate a quei file, ovvero un avviso che specifichi dove @`e possibile
+trovare copia delle condizioni aggiunte.
+
+Tutte le Condizioni aggiuntive, permissive o non-permissive, devono essere
+espresse nella forma di una licenza scritta e separata, o espresse
+esplicitamente come eccezioni; in entrambi i casi valgono le condizioni
+succitate.
+
address@hidden Cessazione di Licenza
+
+Non puoi propagare o modificare un programma coperto da questa Licenza in
+maniera diversa da quanto espressamente consentito da questa Licenza.
+Qualunque tentativo di propagare o modificare altrimenti il Programma @`e
nullo,
+e provoca l'immediata cessazione dei diritti garantiti da questa Licenza
+(compresi tutte le eventuali licenze di brevetto garantite ai sensi del terzo
+paragrafo della sezione 11).
+
+In ogni caso, se cessano tutte le violazioni di questa Licenza, allora la tua
+licenza da parte di un dato detentore del copyright viene ripristinata (a) in
+via cautelativa, a meno che e fino a quando il detentore del copyright non
+cessa esplicitamente e definitivamente la tua licenza, e (b) in via permanente
+se il detentore del copyright non ti notifica in alcun modo la violazione
+entro 60 giorni dalla cessazione della licenza.
+
+Inoltre, la tua licenza da parte di un dato detentore del copyright viene
+ripristinata in maniera permanente se il detentore del copyright ti notifica
+la violazione in maniera adeguata, se questa @`e la prima volta che ricevi una
+notifica di violazione di questa Licenza (per qualunque Programma) dallo
+stesso detentore di copyright, e se rimedi alla violazione entro 30 giorni
+dalla data di ricezione della notifica di violazione.
+
+La cessazione dei tuoi diritti come specificato in questa sezione non provoca
+la cessazione delle licenze di terze parti che abbiano ricevuto copie o
+diritti da te secondo questa Licenza. Se i tuoi diritti cessano e non sono
+ristabiliti in via permanente, non hai diritto di ricevere nuove licenze per
+lo stesso materiale, secondo quanto stabilito nella sezione 10.
+
address@hidden L'ottenimento di copie non richiede l'accettazione della Licenza
+
+Non sei obbligato ad accettare i termini di questa Licenza al solo fine di
+ottenere o eseguire una copia del Programma. Similmente, propagazioni
+collaterali di un Programma coperto da questa Licenza che occorrono come
+semplice conseguenza dell'utilizzo di trasmissioni peer-to-peer per la
+ricezione di una copia non richiedono l'accettazione della Licenza. In ogni
+caso, solo e soltanto questa Licenza ti garantiscono il permesso di propagare
+e modificare qualunque programma coperto da questa Licenza. Queste azioni
+violano le leggi sul copyright nel caso in cui tu non accetti questa Licenza.
+Pertanto, modificando o propagando un programma coperto da questa Licenza,
+indichi implicitamente la tua accettazione della Licenza.
+
address@hidden Licenza Automatica per i successivi destinatari
+
+Ogni qual volta distribuisci un programma coperto da questa Licenza, il
+destinatario riceve automaticamente una licenza, dal detentore originario del
+copyright, di eseguire, modificare e propagare il programma, nel rispetto di
+questa Licenza. Non sei ritenuto responsabile del rispetto di questa Licenza
+da parte di terze parti.
+
+Una ``transazione d'address@hidden'' @`e una transazione che trasferisce il
controllo di
+una organizzazione, o sostanzialmente di tutti i suoi beni, che suddivide una
+organizzazione o che fonde address@hidden organizzazioni. Se la propagazione
di un
+programma coperto da questa Licenza @`e conseguente ad una transazione di
address@hidden, ciascuna parte che ha ruolo nella transazione e che riceve una
copia
+del programma riceve allo stesso tempo qualsiasi licenza sul programma che i
+predecessori della parte possedevano o potevano rilasciare nel rispetto del
+paragrafo precedente, e in address@hidden il diritto di possesso del Sorgente
+Corrispondente del programma dal predecessore in interesse, se il predecessore
+lo possiede o se address@hidden ottenerlo senza troppe address@hidden
+
+Non puoi imporre nessuna ulteriore restrizione sull'esercizio dei diritti
+garantiti o affermati da questa Licenza. Per esempio, non puoi imporre un
+prezzo di licenza, una royalty, o altri costi per l'esercizio dei diritti
+garantiti da questa Licenza, a non puoi dar corso ad una controversia (ivi
+incluse le controversie incrociate o la difesa in cause legali) affermando che
+siano stati violati dei brevetti a causa della produzione, dell'uso, della
+vendita, della messa in vendita o dell'importazione del Programma o di sue
+parti.
+
address@hidden Brevetti
+
+Un ``contribuente'' @`e un detentore di copyright che autorizza l'uso secondo
+questa Licenza di un Programma o di un'opera basata sul Programma. L'opera
address@hidden@dotless{i}} licenziata viene chiamata ``versione del
contribuente''.
+
+I ``diritti essenziali di brevetto'' da parte di un contribuente sono tutti i
+diritti di brevetto che appartengono o che sono controllati dal contribuente,
+che siano address@hidden acquisiti o che saranno acquisiti in futuro, che
possano essere
+violati in qualche maniera, consentita da questa Licenza, generando,
+modificando o vendendo la versione del contribuente, ma non includono i
+diritti che possano essere violati soltanto come conseguenza di ulteriori
+modifiche alla versione del contribuente. In relazione a questa definizione,
+il termine ``controllo'' include il diritto di garantire sottolicenze di
+brevetto in maniera consistente con le condizioni di questa Licenza.
+
+Ciascun contribuente ti garantisce la licenza di brevetto sui diritti
+essenziali di brevetto del contribuente stesso non-esclusiva, valida in tutto
+il mondo, esente da royalty, di creare, usare, vendere, offrire in vendita,
+importare e altrimenti eseguire, modificare e propagare i contenuti della
+versione del contribuente.
+
+Nei tre paragrafi successivi, con ``licenza di brevetto'' si intende qualunque
+accordo o contratto, comunque denominato, di non rivendicazione di un brevetto
+(come per esempio un permesso esplicito di utilizzare un brevetto o un accordo
+di rinuncia alla persecuzione per violazione di brevetto). ``Garantire'' una
+tale licenza di brevetto ad una parte significa portare a termine un tale
+accordo o contratto di non rivendicazione di brevetto contro la parte.
+
+Se distribuisci un programma coperto da questa Licenza, confidando
+consapevolmente su una licenza di brevetto, e il Sorgente Corrispondente per
+il programma non @`e reso disponibile per la copia, senza alcun onere
aggiuntivo
+e comunque nel rispetto delle condizioni di questa Licenza, attraverso un
+server di rete pubblicamente accessibile o tramite altri mezzi facilmente
+accessibili, allora devi (1) fare in modo che il Sorgente Corrispondente sia
+reso disponibile come sopra, oppure (2) fare in modo di rinunciare ai benefici
+della licenza di brevetto per quel particolare programma, oppure (3)
+adoperarti, in maniera consistente con le condizioni di questa Licenza, per
+estendere la licenza di brevetto a tutti i destinatari successivi. ``Confidare
+consapevolmente'' significa che tu sei attualmente cosciente che, eccettuata la
+licenza di brevetto, la distribuzione da parte tua di un programma protetto da
+questa Licenza in un paese, o l'utilizzo in un paese del programma coperto da
+questa Licenza da parte di un destinatario, address@hidden violare uno o
address@hidden brevetti in
+quel paese che tu hai ragione di ritenere validi.
+
+Se, come conseguenza o in connessione con una singola transazione o con un
+dato accordo, distribuisci, o fai in modo di distribuire, un programma coperto
+da questa Licenza, e garantisci una licenza di brevetto per alcune delle parti
+che ricevono il Programma autorizzandole ad utilizzare, propagare, modificare
+o distribuire una specifica copia del Programma, allora la licenza di brevetto
+che fornisci @`e automaticamente estesa a tutti i destinatari del Programma
+coperto da questa Licenza e delle opere basate sul Programma.
+
+Una licenza di brevetto @`e ``discriminatoria'' se non include nell'ambito
della
+sua copertura, proibisce l'esercizio, o @`e vincolata al non-esercizio di uno o
address@hidden dei diritti che sono specificatamente garantiti da questa
Licenza. Non
+puoi distribuire un Programma coperto da questa Licenza se sei parte di un
+accordo con una terza parte la cui address@hidden comprende la distribuzione di
+software, secondo il quale tu sei costretto ad un pagamento alla parte terza
+in funzione della tua address@hidden di distribuzione del Programma, e in
+conseguenza del quale la parte terza garantisce, a qualunque delle parti che
+riceveranno il Programma da te, una licenza di brevetto discriminatoria (a)
+assieme a copie del Programma coperto da questa Licenza distribuite da te (o
+ad altre copie fatte da codeste copie), oppure (b) principalmente per e in
+connessione con specifici prodotti o raccolte di prodotti che contengono il
+Programma, a meno che l'accordo non sia stato stipulato, o le licenze di
+brevetto non siano state rilasciate, prima del 28 Marzo 2007.
+
+Nessuna parte di questa Licenza address@hidden essere interpretata come atta
ad escludere
+o limitare gli effetti di qualunque altra licenza o altri meccanismi di difesa
+dalla violazione che possano altrimenti essere resi disponibili dalla
+normativa vigente in materia di brevetti.
+
address@hidden Nessuna resa di address@hidden altrui
+
+Se ti vengono imposte delle condizioni (da un ordine giudiziario, da un
+accordo o da qualunque altra address@hidden) che contraddicono le condizioni di
+questa Licenza, non sei in nessun modo esonerato dal rispetto delle condizioni
+di questa Licenza. Se non puoi distribuire un Programma coperto da questa
+Licenza per sottostare simultaneamente agli obblighi derivanti da questa
+Licenza e ad altri obblighi pertinenti, allora non puoi distribuire il
+Programma per nessun motivo. Per esempio, se accetti delle condizioni che ti
+obbligano a richiedere il pagamento di una royalty per le distribuzioni
+successivamente effettuate da coloro ai quali hai distribuito il Programma,
+l'unico modo per soddisfare sia queste condizioni che questa Licenza @`e
evitare
+del tutto la distribuzione del Programma.
+
address@hidden Utilizzo con la GNU Affero General Public License
+
+Indipendentemente da qualunque altra condizione espressa da questa Licenza,
+hai il permesso di collegare o combinare qualunque Programma coperto da questa
+Licenza con un'opera rilasciata sotto la versione 3 della licenza GNU Affero
+General Public License, ottenendo un singolo Programma derivato, e di
+distribuire il Programma risultante. Le condizioni di questa Licenza
+continuano a valere per le parti riguardanti il Programma che sono coperte da
+questa Licenza, mentre le condizioni speciali della GNU Affero General Public
+License, sezione 13, riguardanti l'interazione mediante rete, saranno
+applicate al Programma address@hidden@dotless{i}} risultante.
+
address@hidden Versioni rivedute di questa Licenza
+
+La Free Software Foundation address@hidden pubblicare delle versioni rivedute
e/o delle
+nuove versioni della GNU General Public License di tanto in tanto. Tali
+versioni saranno simili, nello spirito, alla presente versione, ma potranno
+differire nei dettagli al fine di affrontare nuovi problemi e nuove
+situazioni.
+
+A ciascuna versione viene assegnato un numero identificativo di versione. Se
+il Programma specifica che si applica a address@hidden stesso una certa
versione della GNU
+General Public License, ``o qualunque altra versione successiva'', hai la
address@hidden di sottostare alle condizioni di quella specifica versione o di
+qualunque altra versione successiva pubblicata dalla Free Software Foundation.
+Se il Programma non specifica un numero di versione della GNU General Public
+License, puoi scegliere qualunque versione della GNU General Public License
+pubblicata dalla Free Software Foundation.
+
+Se il Programma specifica che un sostituto o un procuratore address@hidden
decidere quali
+versioni future della GNU General Public License posso essere utilizzate,
+allora tale scelta di accettazione di una data versione ti autorizza, in
+maniera permanente, ad utilizzare quella versione della Licenza per il
+Programma.
+
+Versioni successive della Licenza possono garantire diritti aggiuntivi o
+leggermente differenti. Ad ogni modo, nessun obbligo aggiuntivo viene imposto
+agli autori o ai detentori di copyright come conseguenza della tua scelta di
+adottare una versione successiva della Licenza.
+
address@hidden Rinuncia alla Garanzia
+
+NON C'@`E NESSUNA GARANZIA PER IL PROGRAMMA, PER QUANTO CONSENTITO DALLE
+VIGENTI NORMATIVE. ECCETTO QUANDO ALTRIMENTI STABILITO PER ISCRITTO, I
+DETENTORI DEL COPYRIGHT E/O LE ALTRE PARTI FORNISCONO IL PROGRAMMA
address@hidden COME
address@hidden'' SENZA GARANZIA DI ALCUN TIPO, N@'E ESPRESSA N@'E IMPLICITA,
INCLUSE, MA NON
+LIMITATE A, LE GARANZIE DI address@hidden O DI address@hidden PER UN
+PARTICOLARE SCOPO. L'INTERO RISCHIO CONCERNENTE LA address@hidden E LE
PRESTAZIONI
+DEL PROGRAMMA @`E DEL LICENZIATARIO. SE IL PROGRAMMA DOVESSE RISULTARE
+DIFETTOSO, IL LICENZIATARIO SI ASSUME I COSTI DI MANUTENZIONE, RIPARAZIONE O
+CORREZIONE.
+
address@hidden Limitazione di address@hidden
+
+IN NESSUN CASO, A MENO CHE NON SIA RICHIESTO DALLA NORMATIVA VIGENTE O
+CONCORDATO PER ISCRITTO, I DETENTORI DEL COPYRIGHT, O QUALUNQUE ALTRA PARTE
+CHE MODIICA E/O DISTRIBUISCE IL PROGRAMMA SECONDO LE CONDIZIONI PRECEDENTI,
+POSSONO ESSERE RITENUTI RESPONSABILI NEI CONFRONTI DEL LICENZIATARIO PER
+DANNI, INCLUSO QUALUNQUE DANNEGGIAMENTO GENERICO, SPECIALE, INCIDENTALE O
+CONSEQUENZIALE DOVUTO ALL'USO O ALL'address@hidden D'USO DEL PROGRAMMA
+(INCLUSI, MA NON LIMITATI A, LE PERDITE DI DATI, LA CORRUZIONE DI DATI, LE
+PERDITE SOSTENUTE DAL LICENZIATARIO O DA TERZE PARTI O L'address@hidden DEL
+PROGRAMMA A FUNZIONARE ASSIEME AD ALTRI PROGRAMMI), ANCHE NEL CASO IN CUI IL
+DETENTORE O LE ALTRE PARTI SIANO STATI AVVISATI CIRCA LA address@hidden DI TALI
+DANNEGGIAMENTI.
+
address@hidden Interpretazione delle Sezioni 15 e 16
+
+Se la dichiarazione di garanzia e la limitazione di address@hidden fornite
+precedentemente non hanno effetto legale in un paese a causa delle loro
+condizioni, le corti di giustizia devono applicare la norma locale che
address@hidden si
+avvicini al rifiuto assoluto di qualsivoglia address@hidden civile relativa al
+Programma, a meno che una garanzia o una assunzione di address@hidden scritta
+non accompagni una copia del programma ottenuta dietro pagamento.
address@hidden enumerate
+
address@hidden fakenode --- for prepinfo
address@hidden FINE DEI TERMINI E DELLE CONDIZIONI
+
address@hidden fakenode --- for prepinfo
address@hidden Come applicare queste condizioni di Licenza ai vostri programmi
+
+Se sviluppi un nuovo programma, e vuoi che esso sia della massima
address@hidden, il
+modo migliore @`e renderlo software libero in modo che chiunque possa
+ridistribuirlo e modificarlo secondo i termini di questa Licenza.
+
+Per fare address@hidden, allega le seguenti note informative al programma. Il
modo
+migliore @`e inserirle all'inizio di ciascun file sorgente, al fine di
rimarcare
+adeguatamente la mancanza di garanzia; ciascun file dovrebbe inoltre contenere
+la dichiarazione di copyright e un riferimento al posto in cui @`e possibile
+ottenere la versione completa delle note informative.
+
address@hidden
address@hidden<una riga con nome del programma e breve descrizione di
address@hidden che fa.>}
+Copyright (C) @var{<anno>} @var{<nome dell'autore>}
+
+Questo software @`e libero; lo puoi distribuire e/o modificare alle condizioni
+stabilite nella 'GNU General Public License' pubblicata dalla Free Software
+Foundation; fai riferimento alla versione 3 della Licenza, o (a tua scelta)
+a una qualsiasi versione successiva.
+
+Questo programma @`e distribuito con la speranza che sia utile, ma SENZA
+ALCUNA GARANZIA; senza neppure la garanzia implicita di address@hidden o
address@hidden AD UN PARTICOLARE SCOPO. Si veda la 'GNU General Public License'
per
+ulteriori dettagli.
+
+Dovresti aver ricevuto una copia della GNU General Public License assieme a
+questo programma; se non @`e address@hidden@dotless{i}}, si veda
address@hidden://www.gnu.org/licenses/}.
address@hidden smallexample
+
+Inoltre, aggiungi le informazioni necessarie a contattarti via posta ordinaria
+o via posta elettronica.
+
+Se il programma interagisce mediante terminale, fai in modo che visualizzi,
+quando viene avviato in address@hidden interattiva, un breve messaggio come
quello
+che segue:
+
address@hidden
address@hidden<programma>} Copyright (C) @var{<anno>} @var{<nome dell'autore>}
+Questo programma non ha ALCUNA GARANZIA; per dettagli usare il comando
address@hidden w}.
+Questo @`e software libero, e ognuno @`e libero di ridistribuirlo
+sotto certe condizioni; usare il comando @samp{show c} per i dettagli.
address@hidden smallexample
+
+Gli ipotetici comandi @samp{show w} e @samp{show c} devono visualizzare le
parti
+corrispondenti della GNU General Public License. Naturalmente i comandi del
+tuo programma potrebbero essere differenti; per una interfaccia di tipo GUI,
+dovresti usare un bottone ``About'' o ``Info''.
+
+Devi inoltre fare in modo che il tuo datore di lavoro (se lavori come
+programmatore presso terzi) o la tua scuola, eventualmente, firmino una
+``rinuncia al copyright'' sul programma, se necessario. Per maggiori
+informazioni su questo punto, e su come applicare e rispettare la GNU GPL,
+consultare la pagina @url{http://www.gnu.org/licenses/}.
+
+La GNU General Public License non consente di incorporare il programma
+all'interno di software proprietario. Se il tuo programma @`e una libreria di
+funzioni, potresti ritenere address@hidden opportuno consentire il
collegamento tra
+software proprietario e la tua libreria. Se @`e questo address@hidden che
vuoi, allora
+utilizza la GNU Lesser General Public License anzich@'e questa Licenza, ma
prima
+leggi @url{http://www.gnu.org/philosophy/why-not-lgpl.html}.
+
address@hidden FOR_PRINT
address@hidden The GNU Free Documentation License.
address@hidden Licenza per Documentazione Libera GNU (FDL)
address@hidden Licenza per Documentazione Libera GNU (FDL)
address@hidden
address@hidden Versione 1.3, 3 Novembre 2008
address@hidden ifnotdocbook
+
address@hidden
+<subtitle>Versione 1.3, 3 Novembre 2008 </subtitle>
address@hidden docbook
+
address@hidden FDL (Free Documentation License)
address@hidden Free Documentation License (FDL)
address@hidden GNU Free Documentation License
+
address@hidden This file is intended to be included within another document,
address@hidden hence no sectioning command or @node.
+
address@hidden
+Copyright @copyright{} 2000, 2001, 2002, 2007, 2008 Free Software Foundation,
Inc.
address@hidden://fsf.org}
+
+This is an unofficial translation of the GNU Free Documentation License into
+Italian. It was not published by the Free Software Foundation, and does not
+legally state the distribution terms for software that uses the GNU FDLâonly
+the original English text of the GNU FDL does that. However, we hope that this
+translation will help Italian speakers understand the GNU FDL better.
+
+Questa @`e una traduzione non ufficiale della GNU Free Documentation License
+in italiano. Non @`e una pubblicazione della Free Software Foundation, e non
+ha address@hidden legale per i termini di distribuzione della documentazione
che
+usa la GNU FDL; solo il testo originale inglese della GNU FDL ha tale
address@hidden Comunque, speriamo che questa traduzione aiuti chi parla
+italiano a comprendere meglio la GNU FDL.
+
+A chiunque @`e permesso copiare e ridistribuire copie esatte di questo
documento
+di licenza, ma non @`e in alcun modo consentito apportarvi modifiche.
+
address@hidden display
+
address@hidden 0
address@hidden
+PREAMBOLO
+
+Lo scopo di questa licenza @`e di rendere @dfn{liberi} un manuale, un testo o
+altri documenti funzionali e utili, nel senso di assicurare a tutti la
address@hidden effettiva di copiarli e ridistribuirli, con o senza modifiche,
con
+o senza fini di lucro. In secondo luogo questa licenza prevede per autori
+ed editori il modo per ottenere il giusto riconoscimento del proprio
+lavoro, preservandoli dall'essere considerati responsabili per modifiche
+apportate da altri.
+
+Questa licenza garantisce il ``copyleft'': questo significa che i lavori che
+derivano dal documento originale devono essere ugualmente liberi. @`E il
+complemento alla Licenza Pubblica Generale GNU, che @`e una licenza di tipo
+``copyleft'' pensata per il software libero.
+
+Questa licenza @`e stata progettata appositamente per l'uso con manuali di
+software libero, perch@'e il software libero ha bisogno di documentazione
+libera: un programma libero dovrebbe accompagnarsi a manuali che
+forniscano le stesse address@hidden del software. Questa licenza non @`e
limitata
+alla manualistica del software; address@hidden essere utilizzata per ogni
testo che
+tratti un qualsiasi argomento e al di address@hidden dell'avvenuta
pubblicazione
+cartacea. Si raccomanda l'uso di questa licenza principalmente per opere
+che abbiano fini didattici o per manuali.
+
address@hidden
address@hidden E DEFINIZIONI
+
+Questa licenza si applica a qualsiasi manuale o altra opera, su ogni tipo
+di supporto, che contenga la nota, posta dal detentore del copyright, che
+attesti la address@hidden di distribuzione secondo i termini di questa
+licenza. Tale nota permette universalmente, senza pagamento di diritti e
+senza limiti di durata di utilizzare il lavoro secondo le condizioni qui
+specificate. Con ``documento'', nel seguito ci si riferisce a qualsiasi
+manuale o opera. Ogni fruitore @`e un destinatario della licenza ed @`e ad
+esso che si fa riferimento. Si conviene che la licenza viene accettata se
+si copia, modifica o distribuisce il lavoro in una maniera tale da
+richiedere il permesso secondo le leggi sul copyright.
+
+Una ``versione modificata'' del documento @`e ogni opera contenente il
+documento stesso o parte di esso, sia riprodotto alla lettera che con
+modifiche, oppure traduzioni in un'altra lingua.
+
+Una ``sezione secondaria'' @`e un'appendice cui si fa riferimento o una
+premessa del documento e riguarda esclusivamente il rapporto dell'editore
+o dell'autore del documento con l'argomento generale del documento stesso
+(o argomenti affini) e non contiene nulla che possa essere compreso
+nell'argomento principale. (address@hidden, se il documento @`e in parte un
manuale
+di matematica, una sezione secondaria non address@hidden contenere spiegazioni
di
+matematica). Il rapporto con l'argomento address@hidden essere un tema
collegato
+storicamente con il soggetto principale o con soggetti affini, o essere
+costituito da argomentazioni legali, commerciali, filosofiche, etiche o
+politiche pertinenti.
+
+Le ``sezioni non modificabili'' sono alcune sezioni secondarie i cui titoli
+sono esplicitamente elencati come titoli delle sezioni non modificabili
+nella nota che indica che il documento @`e realizzato sotto questa licenza.
+Se una sezione non rientra nella precedente definizione di sezione
+secondaria, allora non @`e permesso che venga definita come non
+modificabile. Il documento address@hidden anche non contenere sezioni non
+modificabili. Se nel documento non vengono indicate sezioni non
+modificabili, allora significa che non ve ne sono.
+
+I ``testi di copertina'' sono dei brevi brani di testo che sono elencati,
+nella prima o quarta pagina di copertina, nella nota che indica che il
+documento @`e rilasciato sotto questa licenza. Il testo sulla prima di
+copertina address@hidden essere composto al massimo di 5 parole mentre quello
sulla
+quarta di copertina address@hidden essere al massimo di 25 parole.
+
+Una copia ``trasparente'' indica una copia leggibile da un calcolatore,
+codificata in un formato le cui specifiche sono disponibili pubblicamente,
+tale che il suo contenuto possa essere modificato in modo semplice con
+generici editor di testi o (per immagini composte da pixel) con generici
+editor di immagini o (per i disegni) con qualche editor di disegni
+ampiamente diffuso; la copia deve essere adatta al trattamento per la
+formattazione o per la conversione in una address@hidden di formati atti alla
+successiva formattazione. Una copia fatta in un formato di file, per il
+resto trasparente, i cui marcatori o assenza di tali sono stati progettati
+per intralciare o scoraggiare modifiche future da parte dei lettori non @`e
+trasparente. Un formato immagine non @`e trasparente se viene usato per
+rappresentare una notevole address@hidden di testo. Una copia non
``trasparente''
+viene detta ``opaca''.
+
+Esempi di formati adatti per copie trasparenti sono l'@sc{ASCII} puro senza
+marcatori, il formato di ingresso per Texinfo, il formato di ingresso per
address@hidden, @acronym{SGML} o @acronym{XML} accoppiati ad una @acronym{DTD}
+pubblica e disponibile, e i formati conformi agli standard @acronym{HTML}
+semplice, Postscript e @acronym{PDF} progettati per essere modificati
+manualmente. Esempio di formati immagine trasparenti includono il
address@hidden, @acronym{XCF} e @acronym{JPG}. I formati opachi includono i
+formati proprietari che possono essere letti e modificati solo con word
+processor proprietari, @acronym{SGML} o @acronym{XML} per cui non @`e in
+genere disponibile la @acronym{DTD} o gli strumenti per il trattamento, e i
+formati @acronym{HTML}, Postscript e @acronym{PDF} generati automaticamente
+da qualche word processor esclusivamente come output.
+
+La ``pagina del titolo'' di un libro stampato indica la pagina del titolo
+stessa, address@hidden qualche pagina seguente per quanto necessario a
contenere in
+modo leggibile, il materiale che la licenza prevede che compaia nella
+pagina del titolo. Per opere in formati in cui non sia contemplata
+esplicitamente la pagina del titolo, con ``pagina del titolo'' si intende il
+testo prossimo al titolo dell'opera, precedente l'inizio del corpo del
+testo.
+
+Il termine ``editore'' indica qualunque persona o address@hidden che
distribuisce al
+pubblico copie del documento.
+
+Una sezione ``Intitolata XYZ'' significa una sottosezione con nome del
+documento il cui titolo sia precisamente XYZ o che contenga XYZ in
+parentesi dopo il testo che traduce XYZ in un'altra lingua (in questo caso
+XYZ sta per uno specifico nome di sezione menzionato sotto, come per i
+``Riconoscimenti'', ``Dediche'', ``Approvazioni'', o ``Storia''). Secondo
questa
+definizione, ``preservare il titolo'' di tale sezione quando si modifica il
+documento, significa che essa rimane una sezione ``Intitolata XYZ''.
+
+Il Documento address@hidden includere dei limiti alla garanzia accanto alla
nota
+affermante l'applicazione di questa licenza al documento. Questi limiti
+alla garanzia sono da considerare da includere come riferimento a questa
+licenza, ma solo per quanto riguarda le limitazioni alla garanzia: ogni
+altra implicazione che questi limiti alla garanzia possono avere @`e da
+considerarsi nulla e non ha effetto sul significato di questa licenza.
+
address@hidden
+COPIE LETTERALI
+
+Si address@hidden copiare e distribuire il documento con qualsiasi mezzo, con
o senza
+fini di lucro, purch@'e tutte le copie contengano questa licenza, le note di
+copyright e l'avviso che questa licenza si applica al documento, e che non
+si aggiungano altre condizioni al di fuori di quelle della licenza stessa.
+Non si possono usare misure tecniche per impedire o controllare la lettura
+o la produzione di copie successive alle copie che si producono o
+distribuiscono. Si possono comunque accettare compensi per la copiatura.
+Se si distribuiscono un numero sufficiente di copie si devono seguire
+anche le condizioni della sezione 3.
+
+Alle stesse condizioni sopra menzionate si possono prestare copie e
+mostrarle pubblicamente.
+
address@hidden
+COPIARE IN NOTEVOLI address@hidden
+
+Se si pubblicano a mezzo stampa (o in formati che tipicamente posseggono
+copertine) address@hidden di 100 copie del documento, e la nota della licenza
+richiede uno o address@hidden testi di copertina, si devono includere nelle
copie, in
+modo chiaro e leggibile, tutti i testi di copertina indicati: il testo
+della prima di copertina in prima di copertina e il testo di quarta di
+copertina in quarta di copertina. Ambedue devono identificare l'editore
+che pubblica il documento. La prima di copertina deve presentare il titolo
+completo con tutte le parole che lo compongono egualmente visibili ed
+evidenti. Si address@hidden aggiungere altro materiale alle copertine. Il
copiare con
+modifiche limitate alle sole copertine, purch@'e si preservino il titolo e
+le altre condizioni viste in precedenza, @`e considerato alla stregua di
+copiare alla lettera.
+
+Se il testo richiesto per le copertine @`e troppo voluminoso per essere
+riprodotto in modo leggibile, se ne address@hidden mettere una prima parte (per
+quanto ragionevolmente address@hidden stare) in copertina, e continuare il
resto
+nelle pagine immediatamente seguenti.
+
+Se si pubblicano o distribuiscono copie opache del documento in numero
+superiore a 100, si deve anche includere una copia trasparente leggibile
+da un calcolatore in ogni copia oppure menzionare in ogni copia opaca un
+indirizzo di rete di calcolatori pubblicamente accessibile che utilizzi un
+protocollo di rete standard pubblico, da cui si possa scaricare
+liberamente una copia trasparente completa del documento, senza materiale
+aggiuntivo. Se si adotta quest'ultima opzione, si deve prestare la giusta
+attenzione, nel momento in cui si inizia la distribuzione in address@hidden
+elevata di copie opache, ad assicurarsi che la copia trasparente rimanga
+accessibile all'indirizzo stabilito fino ad almeno un anno dopo l'ultima
+distribuzione (direttamente o attraverso distributori o rivenditori) di
+quell'edizione al pubblico.
+
address@hidden caldamente consigliato, bench@'e non obbligatorio, contattare
l'autore del
+documento prima di distribuirne un numero considerevole di copie, per
+metterlo in grado di fornire una versione aggiornata del documento.
+
address@hidden
+MODIFICHE
+
+Si possono copiare e distribuire versioni modificate del documento
+rispettando le condizioni delle precedenti sezioni 2 e 3, purch@'e la
+versione modificata sia realizzata seguendo questa stessa licenza, con la
+versione modificata che svolga il ruolo del ``documento'',
address@hidden@dotless{i}} da estendere
+la licenza sulla distribuzione e la modifica a chiunque ne possieda una
+copia. Inoltre nelle versioni modificate si deve:
+
address@hidden A
address@hidden
+Usare nella pagina del titolo (e nelle copertine se ce ne sono) un titolo
+diverso da quello del documento, e da quelli di versioni precedenti (che
+devono essere elencati nella sezione storia del documento ove presenti).
+Si address@hidden usare lo stesso titolo di una versione precedente se
l'editore di
+quella versione originale ne ha dato il permesso.
+
address@hidden
+Elencare nella pagina del titolo, come autori, una o address@hidden persone o
gruppi
+responsabili in address@hidden di autori delle modifiche nella versione
+modificata, insieme ad almeno cinque tra i principali autori del documento
+(tutti gli autori principali se sono meno di cinque), a meno che questi
+non abbiano acconsentito a liberarvi da quest'obbligo.
+
address@hidden
+Dichiarare nella pagina del titolo il nome dell'editore della versione
+modificata in address@hidden di editore.
+
address@hidden
+Conservare tutte le note di copyright
+del documento originale.
+
address@hidden
+Aggiungere un'appropriata nota di copyright per
+le modifiche di seguito alle altre note di copyright.
+
address@hidden
+Includere, immediatamente dopo la nota di copyright, una nota di licenza
+che dia pubblicamente il permesso di usare la versione modificata nei
+termini di questa licenza, nella forma mostrata nell'Addendum alla fine di
+questo testo.
+
address@hidden
+Preservare in tale nota di licenza l'elenco completo di sezioni non
+modificabili e testi di copertina richiesti come previsto dalla licenza
+del documento.
+
address@hidden
+Includere una copia non modificata di questa licenza.
+
address@hidden
+Conservare la sezione intitolata ``Storia'', e il suo titolo, e aggiungere
+a questa un elemento che riporti almeno il titolo, l'anno, i nuovi autori,
+e gli editori della versione modificata come figurano nella pagina del
+titolo. Se non ci sono sezioni intitolate ``Storia'' nel documento,
+crearne una che riporti il titolo, gli autori, gli editori del documento
+come figurano nella pagina del titolo, quindi aggiungere un elemento che
+descriva la versione modificata come detto in precedenza.
+
address@hidden
+Conservare l'indirizzo in rete riportato nel documento, se c'@`e, al fine
+del pubblico accesso ad una copia trasparente, e possibilmente l'indirizzo
+in rete per le precedenti versioni su cui ci si @`e basati. Questi possono
+essere collocati nella sezione ``Storia''. Si address@hidden omettere un
indirizzo di
+rete per un'opera pubblicata almeno quattro anni prima del documento
+stesso, o se l'originario editore della versione cui ci si riferisce ne
address@hidden
+il permesso.
+
address@hidden
+In ogni sezione di ``Ringraziamenti'' o ``Dediche'', si conservi il titolo
+della sezione, e all'interno della sezione tutta la sostanza e il tono di
+ognuno dei ringraziamenti ai contributori e/o le dediche ivi contenute.
+
address@hidden
+Si conservino inalterate le sezioni non modificabili del documento, nei
+propri testi e nei propri titoli. I numeri della sezione o equivalenti non
+sono considerati parte del titolo della sezione.
+
address@hidden
+Si cancelli ogni sezione intitolata ``Approvazioni''. Tale sezione non
address@hidden
+essere inclusa nella versione modificata.
+
address@hidden
+Non si cambi il titolo di sezioni esistenti in ``Approvazioni'' o in modo
+tale che si possa creare confusione con i titoli di sezioni non
+modificabili.
+
address@hidden
+Si conservino tutti i limiti alla garanzia.
address@hidden enumerate
+
+
+
+Se la versione modificata comprende nuove sezioni di primaria
+importanza o appendici che ricadono in ``sezioni secondarie'', e non
+contengono materiale copiato dal documento, si ha address@hidden di rendere non
+modificabili quante sezioni si voglia. Per fare address@hidden si aggiunga il
loro
+titolo alla lista delle sezioni non modificabili nella nota di licenza
+della versione modificata. Questi titoli devono essere distinti dai titoli
+di ogni altra sezione.
+
+Si address@hidden aggiungere una sezione intitolata ``Approvazioni'', a patto
che non
+contenga altro che le approvazioni alla versione modificata prodotte da
+vari soggetti--per esempio, affermazioni di revisione o che il testo @`e
+stato approvato da una organizzazione come la definizione normativa di uno
+standard.
+
+Si address@hidden aggiungere un brano fino a cinque parole come testo di prima
di
+copertina e un brano fino a 25 parole come testo di quarta di copertina,
+alla fine dell'elenco dei testi di copertina nella versione modificata.
+Solamente un brano del testo di prima di copertina e uno del testo di
+quarta di copertina possono essere aggiunti (anche con adattamenti) da
+ciascuna persona o organizzazione. Se il documento include address@hidden un
testo di
+copertina per la stessa copertina, precedentemente aggiunto o adattato da
+qualunque fruitore o dalla stessa organizzazione nel nome della quale si
+agisce, non se ne address@hidden aggiungere un altro, ma si address@hidden
rimpiazzare il
+vecchio ottenendo l'esplicita autorizzazione dall'editore precedente che
+aveva aggiunto il testo di copertina.
+
+L'autore/i e l'editore/i del documento non danno, tramite questa licenza,
+il permesso di usare i loro nomi per pubblicizzare o asserire, anche
+implicitamente, la loro approvazione di ogni versione modificata.
+
address@hidden
+COMBINAZIONE DI DOCUMENTI
+
+Si address@hidden combinare il documento con altri pubblicati con questa
licenza,
+seguendo i termini definiti nella precedente sezione 4 per le versioni
+modificate, a patto che si includa l'insieme di tutte le sezioni non
+modificabili di tutti i documenti originali, senza modifiche, e si
+elenchino tutte come sezioni non modificabili della combinazione di
+documenti nella licenza della stessa, mantenendo tutti i limiti alla
+garanzia.
+
+Nella combinazione @`e necessaria una sola copia di questa licenza, e
address@hidden
+sezioni non modificabili possono essere rimpiazzate da una singola copia
+se identiche. Se ci sono address@hidden sezioni non modificabili con lo stesso
nome
+ma contenuti differenti, si renda unico il titolo di ciascuna sezione
+aggiungendovi, alla fine e tra parentesi, il nome dell'autore o editore
+della sezione, se noti, o altrimenti un numero distintivo. Si facciano gli
+stessi aggiustamenti ai titoli delle sezioni nell'elenco delle sezioni non
+modificabili nella nota di copyright della combinazione.
+
+Nella combinazione si devono unire le varie sezioni intitolate ``Storia''
+nei vari documenti originali di partenza per formare una unica sezione
+intitolata ``Storia''; allo stesso modo si unisca ogni sezione intitolata
+``Ringraziamenti'', e ogni sezione intitolata ``Dediche''. Si devono eliminare
+tutte le sezioni intitolate ``Approvazioni''.
+
address@hidden
+RACCOLTE DI DOCUMENTI
+
+Si address@hidden produrre una raccolta che consista del documento e di altri
+documenti rilasciati sotto questa licenza, e rimpiazzare le singole copie
+di questa licenza nei vari documenti con una sola inclusa nella raccolta,
+solamente se si seguono le regole fissate da questa licenza per le copie
+alla lettera come se si applicassero a ciascun documento.
+
+Si address@hidden estrarre un singolo documento da tale raccolta e distribuirlo
+separatamente sotto questa licenza, solo se si inserisce una copia di
+questa licenza nel documento estratto e se si seguono tutte le altre
+regole fissate da questa licenza per le copie alla lettera del documento.
+
address@hidden
+AGGREGAZIONE A LAVORI INDIPENDENTI
+
+Un'unione del documento o sue derivazioni con altri documenti o lavori
+separati o indipendenti, all'interno di, o a formare un, archivio o un
+supporto, per la memorizzazione o la distribuzione, viene chiamato un
+``aggregato'' se il copyright risultante dall'unione non viene usato per
+limitare i diritti legali degli utilizzatori oltre a address@hidden che viene
+permesso dai singoli lavori. Quando il documento viene incluso in un
+aggregato, questa licenza non si applica ad altri lavori nell'aggregato
+che non siano essi stessi dei lavori derivati dal documento.
+
+Se le esigenze del testo di copertina della sezione 3 sono applicabili a
+queste copie del documento allora, se il documento @`e inferiore alla
address@hidden
+dell'intero aggregato i testi di copertina del documento possono essere
+piazzati in copertine che delimitano il documento all'interno
+dell'aggregato, o dell'equivalente elettronico delle copertine se il
+documento @`e in un formato elettronico. Altrimenti devono apparire nella
+copertina dell'intero aggregato.
+
address@hidden
+TRADUZIONE
+
+La traduzione @`e considerata un tipo di modifica, di conseguenza si possono
+distribuire traduzioni del documento nei termini della sezione 4.
+Rimpiazzare sezioni non modificabili con traduzioni richiede un
+particolare permesso da parte dei detentori del copyright, ma @`e possibile
+includere la traduzione di parti o di tutte le sezioni non modificabili in
+aggiunta alle versioni originali di queste sezioni. @`E possibile includere
+una traduzione di questa licenza, di tutte le avvertenze del documento e
+di tutti i limiti di garanzia, a condizione che si includa anche la
+versione originale in inglese della licenza completa, comprese le
+avvertenze e limitazioni di garanzia. In caso di discordanza tra la
+traduzione e la versione originale inglese di questa licenza o avvertenza
+o limitazione di garanzia, prevale sempre la versione originale inglese.
+
+Se una sezione del documento viene titolata ``Riconoscimenti'', ``Dediche'', o
+``Storia'', il requisito (sezione 4) di preservare il titolo (sezione 1)
address@hidden tipicamente il cambiamento del titolo.
+
address@hidden
+CESSAZIONE DELLA LICENZA
+
+Non si address@hidden sublicenziare il documento, copiarlo, modificarlo, o
+distribuirlo al di fuori dei termini espressamente previsti da questa
+licenza. Ogni altro tentativo di applicare una licenza al documento,
+copiarlo, modificarlo, o distribuirlo @`e nullo e pone fine automaticamente
+ai diritti previsti da questa licenza.
+
+In ogni caso, se cessano tutte le violazioni di questa Licenza, allora la
+specifica licenza di un particolare detentore del copyright viene
+ripristinata (a) in via provvisoria, a meno che e fino a quando il
+detentore del copyright non faccia estinguere esplicitamente e
+definitivamente la licenza, e (b) in via permanente se il detentore del
+copyright non notifica in alcun modo la violazione entro 60 giorni dalla
+cessazione della licenza.
+
+Inoltre, la licenza di un dato detentore del copyright viene ripristinata
+in maniera permanente se quest'ultimo notifica la violazione in maniera
+adeguata, se si tratta della prima volta che si riceve una notifica di
+violazione della licenza (per qualsiasi opera) dallo stesso detentore di
+copyright, e se la violazione viene corretta entro 30 giorni dalla data di
+ricezione della notifica di violazione.
+
+La cessazione dei diritti come specificato in questa sezione non provoca
+la cessazione delle licenze di terze parti che abbiano ricevuto copie o
+diritti secondo questa licenza. Se i diritti sono cessati e non sono stati
+ristabiliti in via permanente, la ricezione di una copia dello stesso
+materiale, in tutto o in parte, non address@hidden alcun diritto ad
utilizzarlo.
+
address@hidden
+REVISIONI FUTURE DI QUESTA LICENZA
+
+La Free Software Foundation address@hidden occasionalmente pubblicare versioni
nuove
+o rivedute della Licenza per Documentazione Libera GNU. Le nuove versioni
+saranno simili nello spirito alla versione attuale ma potrebbero
+differirne in qualche dettaglio per affrontare nuovi problemi e concetti.
+Si veda @uref{http://www.gnu.org/copyleft/}.
+
+Ad ogni versione della licenza viene dato un numero che la distingue. Se
+il documento specifica che si riferisce ad una versione particolare della
+licenza ``o ogni versione successiva'', si ha la address@hidden di seguire
+termini e condizioni sia della versione specificata che di ogni versione
+successiva pubblicata (non come bozza) dalla Free Software Foundation. Se
+il documento non specifica un numero di versione particolare di questa
+licenza, si address@hidden scegliere ogni versione pubblicata (non come bozza)
dalla
+Free Software Foundation. Se il documento specifica che un delegato
address@hidden
+decidere quale futura versione di questa licenza address@hidden essere
utilizzata,
+allora la dichiarazione pubblica di accettazione della versione, da parte
+del delegato, autorizza in maniera permanente a scegliere tale versione
+per il documento.
+
address@hidden
+CAMBIO DI LICENZA
+
+Il termine ``sito per la collaborazione massiva multiautore'' (o ``sito
+MMC'')
+indica qualsiasi server web che pubblica opere sottoponibili a copyright e
+fornisce a chiunque appositi strumenti per modificare tali opere. Un wiki
+pubblico modificabile da chiunque @`e un esempio di server in questione. Una
+``collaborazione massiva multiautore'' (o ``MMC'') contenuta nel sito indica
+un qualunque insieme di opere sottoponibili a copyright pubblicate sul
+sito MMC.
+
+Il termine ``CC-BY-SA'' indica la licenza Creative Commons Attribution-Share
+Alike 3.0 pubblicata dalla Creative Commons Corporation, un'organizzazione
+senza fini di lucro con sede principale a San Francisco, California, come
+anche le future versioni di tale licenza pubblicate dalla stessa
+organizzazione.
+
+``Incorporare'' significa pubblicare o ripubblicare un documento in tutto o
+in parte, come parte di un altro documento.
+
+Una MMC @`e ``qualificata a cambiare questa licenza'' se ha adottato questa
+licenza e se tutte le opere precedentemente pubblicate con questa licenza
+altrove rispetto alla MMC e successivamente incorporate del tutto o in
+parte nella MMC (1) non hanno testo di copertina o sezioni invarianti e
+(2) sono state incorporate prima del 1° Novembre 2008.
+
+L'operatore di un sito MMC address@hidden ripubblicare un MMC contenuto nel
sito con
+una CC-BY-SA nello stesso sito in qualsiasi momento prima del 1° Agosto
+2009, da parte di una MMC qualificata a cambiare questa licenza.
+
address@hidden enumerate
+
address@hidden fakenode --- for prepinfo
address@hidden ADDENDUM: Come usare questa licenza per i vostri documenti
+
+Per applicare questa licenza ad un documento che si @`e scritto, si includa
+una copia della licenza nel documento e si inserisca la seguente nota di
+copyright appena dopo la pagina del titolo:
+
address@hidden
address@hidden
+ Copyright (C) @var{<anno>} @var{<il vostro nome>}
+ @`E permesso copiare, distribuire e/o modificare questo documento
+ seguendo i termini della ``Licenza per documentazione libera GNU'', versione
1.3
+ o ogni versione successiva pubblicata dalla Free Software Foundation;
+ senza sezioni non modificabili, senza testi di prima di copertina e di
quarta di copertina.
+ Una copia della licenza @`e inclusa nella sezione intitolata
+ ``Licenza per la documentazione libera GNU''.
address@hidden group
address@hidden smallexample
+
+Se ci sono sezioni non modificabili, testi di prima di copertina e di
+quarta di copertina, scrivere nella parte address@hidden di copertina'' il
testo seguente:
+
address@hidden
address@hidden
+ con le seguenti sezioni non modificabili @var{lista dei loro titoli},
+ con i seguenti testi di prima di copertina @var{elenco},
+ e con i seguenti testi di quarta di copertina @var{elenco},
address@hidden group
address@hidden smallexample
+
+Se esistono delle sezioni non modificabili ma non i testi di copertina, o
+qualche altra combinazione dei tre elementi sopra riportati, fondere
+assieme le due alternative in modo da conformarsi alla situazione descritta.
+
+Se il vostro documento contiene esempi non banali di programma in codice
+sorgente si raccomanda di rilasciare gli esempi contemporaneamente
+applicandovi anche una licenza di software libero di vostra scelta, come
+per esempio la Licenza Pubblica Generica GNU, al fine di permetterne l'uso
+come software libero.
+
address@hidden ifclear
+
address@hidden
address@hidden Indice analitico
address@hidden Indice analitico
address@hidden ifnotdocbook
address@hidden cp
+
address@hidden
+
+Unresolved Issues:
+------------------
+1. From ADR.
+
+ Robert J. Chassell points out that awk programs should have some indication
+ of how to use them. It would be useful to perhaps have a "programming
+ style" section of the manual that would include this and other tips.
+
+Consistency issues:
+ /.../ regexps are in @code, not @samp
+ ".." strings are in @code, not @samp
+ no @print before @dots
+ values of expressions in the text (@code{x} has the value 15),
+ should be in roman, not @code
+ Use TAB and not tab
+ Use ESC and not ESCAPE
+ Use space and not blank to describe the space bar's character
+ The term "blank" is thus basically reserved for "blank lines" etc.
+ To make dark corners work, the @value{DARKCORNER} has to be outside
+ closing `.' of a sentence and after (pxref{...}).
+ " " should have an @w{} around it
+ Use "non-" only with language names or acronyms, or the words bug and
option and null
+ Use @command{ftp} when talking about anonymous ftp
+ Use uppercase and lowercase, not "upper-case" and "lower-case"
+ or "upper case" and "lower case"
+ Use "single precision" and "double precision", not "single-precision"
or "double-precision"
+ Use alphanumeric, not alpha-numeric
+ Use POSIX-compliant, not POSIX compliant
+ Use --foo, not -Wfoo when describing long options
+ Use "Bell Laboratories", but not "Bell Labs".
+ Use "behavior" instead of "behaviour".
+ Use "coprocess" instead of "co-process".
+ Use "zeros" instead of "zeroes".
+ Use "nonzero" not "non-zero".
+ Use "runtime" not "run time" or "run-time".
+ Use "command-line" as an adjective and "command line" as a noun.
+ Use "online" not "on-line".
+ Use "whitespace" not "white space".
+ Use "Input/Output", not "input/output". Also "I/O", not "i/o".
+ Use "lefthand"/"righthand", not "left-hand"/"right-hand".
+ Use "workaround", not "work-around".
+ Use "startup"/"cleanup", not "start-up"/"clean-up"
+ Use "filesystem", not "file system"
+ Use @code{do}, and not @address@hidden, except where
+ actually discussing the do-while.
+ Use "versus" in text and "vs." in index entries
+ Use @code{"C"} for the C locale, not ``C'' or @samp{C}.
+ The words "a", "and", "as", "between", "for", "from", "in", "of",
+ "on", "that", "the", "to", "with", and "without",
+ should not be capitalized in @chapter, @section etc.
+ "Into" and "How" should.
+ Search for @dfn; make sure important items are also indexed.
+ "e.g." should always be followed by a comma.
+ "i.e." should always be followed by a comma.
+ The numbers zero through ten should be spelled out, except when
+ talking about file descriptor numbers. > 10 and < 0, it's
+ ok to use numbers.
+ For most cases, do NOT put a comma before "and", "or" or "but".
+ But exercise taste with this rule.
+ Don't show the awk command with a program in quotes when it's
+ just the program. I.e.
+
+ {
+ ....
+ }
+
+ not
+ awk '{
+ ...
+ }'
+
+ Do show it when showing command-line arguments, data files, etc, even
+ if there is no output shown.
+
+ Use numbered lists only to show a sequential series of steps.
+
+ Use @code{xxx} for the xxx operator in indexing statements, not @samp.
+ Use MS-Windows not MS Windows
+ Use MS-DOS not MS DOS
+ Use an empty set of parentheses after built-in and awk function names.
+ Use "multiFOO" without a hyphen.
+ Use "time zone" as two words, not "timezone".
+
+Date: Wed, 13 Apr 94 15:20:52 -0400
+From: address@hidden (Richard Stallman)
+To: address@hidden
+Subject: A reminder: no pathnames in GNU
+
+It's a GNU convention to use the term "file name" for the name of a
+file, never "pathname". We use the term "path" for search paths,
+which are lists of file names. Using it for a single file name as
+well is potentially confusing to users.
+
+So please check any documentation you maintain, if you think you might
+have used "pathname".
+
+Note that "file name" should be two words when it appears as ordinary
+text. It's ok as one word when it's a metasyntactic variable, though.
+
+------------------------
+ORA uses filename, thus the macro.
+
+Suggestions:
+------------
+
+Better sidebars can almost sort of be done with:
+
+ @ifdocbook
+ @macro @sidebar{title, content}
+ @inlinefmt{docbook, <sidebar><title>}
+ \title\
+ @inlinefmt{docbook, </title>}
+ \content\
+ @inlinefmt{docbook, </sidebar>}
+ @end macro
+ @end ifdocbook
+
+
+ @ifnotdocbook
+ @macro @sidebar{title, content}
+ @cartouche
+ @center @b{\title\}
+
+ \content\
+ @end cartouche
+ @end macro
+ @end ifnotdocbook
+
+But to use it you have to say
+
+ @sidebar{Title Here,
+ @include file-with-content
+ }
+
+which sorta sucks.
+
+TODO:
+Check that all dark corners are indexed properly.
+
diff --git a/doc/it/gawk.texi b/doc/it/gawk.texi
new file mode 100644
index 0000000..ea3fd2f
--- /dev/null
+++ b/doc/it/gawk.texi
@@ -0,0 +1,46902 @@
+% ****************************************************
+% * DO NOT MODIFY THIS FILE!!!! *
+% * It was generated from gawktexi.in by sidebar.awk *
+% * Edit gawktexi.in instead. *
+% ****************************************************
+\language=30
+\input texinfo @c -*-texinfo-*-
address@hidden vim: filetype=texinfo
address@hidden %**start of header (This is for running Texinfo on a region.)
address@hidden gawk-it.info
address@hidden Guida Utente di GNU Awk
address@hidden it
address@hidden %**end of header (This is for running Texinfo on a region.)
+
address@hidden Creazione e manipolazione di testi
address@hidden
+* Gawk: (gawk). Un linguaggio per scandire ed elaborare testi.
address@hidden direntry
address@hidden Programmi di address@hidden individuale
address@hidden
+* awk: (gawk)Avviare gawk. Scansione e processo di testi.
address@hidden direntry
+
address@hidden Enable better indexing, requires texindex from Texinfo 6 or
later.
address@hidden
+\global\usebracesinindexestrue
address@hidden tex
+
address@hidden FOR_PRINT
address@hidden
+\gdef\xrefprintnodename#1{``#1''}
address@hidden tex
address@hidden ifset
+
address@hidden FOR_PRINT
address@hidden With early 2014 texinfo.tex, restore PDF links and colors
address@hidden
+\gdef\linkcolor{0.5 0.09 0.12} % Dark Red
+\gdef\urlcolor{0.5 0.09 0.12} % Also
+\global\urefurlonlylinktrue
address@hidden tex
address@hidden ifclear
+
address@hidden
address@hidden BULLET @bullet{}
address@hidden MINUS @minus{}
address@hidden ifnotdocbook
+
address@hidden
address@hidden BULLET
address@hidden MINUS
address@hidden ifdocbook
+
address@hidden xref-automatic-section-title
+
address@hidden The following information should be updated here only!
address@hidden This sets the edition of the document, the version of gawk it
address@hidden applies to and all the info about who's publishing this edition
+
address@hidden These apply across the board.
address@hidden Aggiornata alla versione del 3 marzo 2017
address@hidden UPDATE-MONTH gennaio 2017
address@hidden VERSION 4.1
address@hidden PATCHLEVEL 4
+
address@hidden added Italian hyphenation stuff
address@hidden o-met-te-re o-met-ten-do}
+
address@hidden GAWKINETTITLE TCP/IP Internetworking with @command{gawk}
address@hidden FOR_PRINT
address@hidden TITLE Programmare efficacemente in awk
address@hidden ifset
address@hidden FOR_PRINT
address@hidden TITLE GAWK: Programmare efficacemente in AWK
address@hidden ifclear
address@hidden SUBTITLE Una Guida Utente per GNU Awk
address@hidden EDITION 4.1
+
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden SMALLPRINT
address@hidden DARKCORNER @address@hidden,1cm}, @image{rflashlight,1cm}}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden DARKCORNER @address@hidden,0.7cm}, @image{rflashlight,0.7cm}}
address@hidden ifset
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden iftex
address@hidden
address@hidden DOCUMENT File Info
address@hidden CHAPTER nodo principale
address@hidden APPENDIX nodo principale
address@hidden SECTION nodo secondario
address@hidden SECTIONS nodi secondari
address@hidden SUBSECTION nodo
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE videata
address@hidden ifinfo
address@hidden
address@hidden DOCUMENT Documento
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE videata
address@hidden ifhtml
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden ifdocbook
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden ifxml
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden ifplaintext
+
address@hidden
address@hidden empty on purpose
address@hidden PART1
address@hidden PART2
address@hidden PART3
address@hidden PART4
address@hidden ifdocbook
+
address@hidden
address@hidden PART1 Parte I:@*
address@hidden PART2 Parte II:@*
address@hidden PART3 Parte III:@*
address@hidden PART4 Parte IV:@*
address@hidden ifnotdocbook
+
address@hidden some special symbols
address@hidden
address@hidden LEQ @address@hidden
address@hidden PI @address@hidden
address@hidden iftex
address@hidden
address@hidden LEQ @inlineraw{docbook, ≤}
address@hidden PI @inlineraw{docbook, &pgr;}
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden LEQ <=
address@hidden PI @i{pi}
address@hidden ifnotdocbook
address@hidden ifnottex
+
address@hidden
address@hidden
address@hidden ii{text}
address@hidden
address@hidden macro
address@hidden ifnotdocbook
address@hidden ifnottex
+
address@hidden
address@hidden ii{text}
address@hidden,<lineannotation>\text\</lineannotation>}
address@hidden macro
address@hidden ifdocbook
+
address@hidden FOR_PRINT
address@hidden FN nome-file
address@hidden FFN Nome-file
address@hidden for Italian plurals {FN}s
address@hidden FNS nomi-file
address@hidden FFNS Nomi-file
address@hidden DF file-dati
address@hidden DDF File-dati
address@hidden PVERSION versione
address@hidden ifclear
address@hidden FOR_PRINT
address@hidden FN nome-file
address@hidden FFN Nome-File
address@hidden for Italian plurals {FN}s
address@hidden FNS nomi-file
address@hidden FFNS Nomi-file
address@hidden DF file-dati
address@hidden DDF File-dati
address@hidden PVERSION Versione
address@hidden ifset
+
address@hidden For HTML, spell out email addresses, to avoid problems with
address@hidden address harvesters for spammers.
address@hidden
address@hidden EMAIL{real,spelled}
+``\spelled\''
address@hidden macro
address@hidden ifhtml
address@hidden
address@hidden EMAIL{real,spelled}
address@hidden
address@hidden macro
address@hidden ifnothtml
+
address@hidden Indexing macros
address@hidden
+
address@hidden cindexawkfunc{name}
address@hidden @code{\name\}
address@hidden macro
+
address@hidden cindexgawkfunc{name}
address@hidden @code{\name\}
address@hidden macro
+
address@hidden ifinfo
+
address@hidden
+
address@hidden cindexawkfunc{name}
address@hidden @code{\name\()}, funzione
address@hidden macro
+
address@hidden cindexgawkfunc{name}
address@hidden @code{\name\()}, funzione (@command{gawk})
address@hidden macro
address@hidden ifnotinfo
+
address@hidden
+Some comments on the layout for TeX.
+1. Use at least texinfo.tex 2016-02-05.07.
address@hidden ignore
+
address@hidden merge the function and variable indexes into the concept index
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden ifinfo
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden iftex
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden ifxml
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden ifdocbook
+
address@hidden If "finalout" is commented out, the printed output will show
address@hidden black boxes that mark lines that are too long. Thus, it is
address@hidden unwise to comment it out when running a master in case there are
address@hidden overfulls which are deemed okay.
+
address@hidden
address@hidden
address@hidden iftex
+
address@hidden
address@hidden
+<para>
+“To boldly go where no man has gone before”
+(“Per arrivare address@hidden dove nessun uomo @`e mai giunto
prima”)
address@hidden un Marchio Registrato della Paramount Pictures
Corporation.</para>
+
+<para>Titolo originale:</para>
address@hidden: Effective AWK address@hidden
address@hidden User's Guide for GNU Awk}
+
+<para>Published by:</para>
+<literallayout class="normal">Free Software Foundation
+51 Franklin Street, Fifth Floor -- Boston, MA 02110-1301 USA
+Tel.: +1-617-542-5942 Fax: +1-617-542-2652 Email: <email>gnu@@gnu.org</email>
+URL: <ulink
url="http://www.gnu.org";>http://www.gnu.org/</ulink></literallayout>
+
+<literallayout class="normal">Copyright © 1989, 1991, 1992, 1993,
1996–2005, 2007, 2009–2017
+Free Software Foundation, Inc.
+All Rights Reserved.
+</literallayout>
+
+</para>Traduzione e revisione:<para>
+<literallayout class="normal">
+Antonio Giovanni Colombo -- <email>azc100(chiocciola)gmail(punto)com</email>
+Marco Curreli -- <email>marcocurreli(chiocciola)tiscali(punto)it</email>
+(Italian Linux Documentation Project (<ulink
url="http://www.pluto.it/ildp";>http://www.pluto.it/ildp/</ulink>)
+</literallayout>
+
+<para>Pubblicato da:</para>
+<literallayout class="normal">Free Software Foundation
+Email: <email>gnu@@gnu.org</email>
+URL: <ulink url="http://www.gnu.org";>http://www.gnu.org/</ulink>
+
+e da:
+Italian Linux Documentation Project (ILDP)
+Email: <emailildp@@pluto.it
+URL: <ulink
url="http://www.pluto.it/ildp";>http://www.pluto.it/ildp/</ulink></literallayout>
+
+<literallayout class="normal">Copyright © 2016
+Free Software Foundation, Inc.
+All Rights Reserved.
+</literallayout>
address@hidden docbook
+
address@hidden
address@hidden
+Copyright @copyright{} 2017 -- Free Software Foundation, Inc.
address@hidden iftex
address@hidden ifnotdocbook
address@hidden 2
+Questa @`e l'Edizione @value{EDITION} di @address@hidden: @value{SUBTITLE}},
+per la versione @address@hidden (o successiva)
+dell'implementazione GNU di AWK.
address@hidden
address@hidden
address@hidden
+(Titolo originale: @i{Gawk: Effective AWK Programming: A User's Guide for GNU
Awk.)}
address@hidden ifnotdocbook
address@hidden ifnotxml
address@hidden ifnottex
+
address@hidden garantito il permesso di copiare, distribuire e/o modificare
questo
+documento seguendo i termini della Licenza per Documentazione Libera
+GNU, Versione 1.3 o ogni versione successiva pubblicata dalla Free
+Software Foundation; con le Sezioni Non Modificabili ``GNU General
+Public License'', con i testi di copertina ``Un Manuale GNU'', e con i
+testi di quarta di copertina come in (a) address@hidden avanti.
address@hidden FOR_PRINT
+Una copia della licenza @`e acclusa nella sezione intitolata
+"Licenza per Documentazione Libera GNU".
address@hidden ifclear
address@hidden FOR_PRINT
+Una copia della licenza
+si address@hidden trovare in internet all'indirizzo
address@hidden://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html,
+il sito web del Progetto GNU}.
address@hidden ifset
+
address@hidden a
address@hidden
+Il testo di quarta di copertina della FSF @`e: address@hidden garantito il
permesso di
+copiare e modificare questo manuale GNU.''
address@hidden enumerate
address@hidden copying
+
address@hidden Comment out the "smallbook" for technical review. Saves
address@hidden considerable paper. Remember to turn it back on *before*
address@hidden starting the page-breaking work.
+
address@hidden 4/2002: Karl Berry recommends commenting out this and the
address@hidden address@hidden odd', and letting users use `texi2dvi -t'
address@hidden if they want to waste paper.
address@hidden @smallbook
+
+
address@hidden Uncomment this for the release. Leaving it off saves paper
address@hidden during editing and review.
address@hidden odd
+
address@hidden GNU Awk
address@hidden
address@hidden @value{TITLE}
address@hidden @value{SUBTITLE}
address@hidden Edizione @value{EDITION}
address@hidden @value{UPDATE-MONTH}
address@hidden Arnold D. Robbins
+
address@hidden
address@hidden Include the Distribution inside the titlepage environment so
address@hidden that headings are turned off. Headings on and off do not work.
+
address@hidden
address@hidden 0pt plus 1filll
+``To boldly go where no man has gone before''
+(``Per arrivare address@hidden dove nessun uomo @`e mai giunto prima'')
address@hidden un Marchio Registrato della Paramount Pictures Corporation. @*
address@hidden sorry, i couldn't resist
address@hidden 1
+Titolo originale:@*
address@hidden: Effective AWK address@hidden
address@hidden User's Guide for GNU Awk}
address@hidden 0
+Published by @strong{Free Software address@hidden
+51 Franklin Street, Fifth Floor -- Boston, MA 02110-1301 USA @*
+Tel.: +1-617-542-5942 -- Fax: +1-617-542-2652 -- Email: @email{gnu@@gnu.org} @*
+URL: @uref{http://www.gnu.org/}
address@hidden 0
address@hidden This one is correct for gawk 3.1.0 from the FSF
+ISBN 1-882114-28-0
address@hidden 0
+Copyright @copyright{} 1989, 1991, 1992, 1993, 1996--2005, 2007, 2009--2017 @*
+Free Software Foundation, Inc.
address@hidden 1
+Traduzione e revisione:@*
+Antonio Giovanni Colombo -- @email{azc100(chiocciola)gmail(punto)address@hidden
+Marco Curreli -- @email{marcocurreli(chiocciola)tiscali(punto)address@hidden
+(Italian Linux Documentation Project -- @uref{http://www.pluto.it/ildp})
address@hidden 1
+Pubblicato da:
+Free Software address@hidden
+Email: @email{gnu@@gnu.org}; URL: @uref{http://www.gnu.org/}
+
+e da:
+Italian Linux Documentation Project (ILDP)@*
+Email: @email{ildp@@pluto.it}; URL: @uref{http://www.pluto.it/ildp}
+
address@hidden
address@hidden 1
address@hidden ifnotdocbook
address@hidden titlepage
+
address@hidden Thanks to Bob Chassell for directions on doing dedications.
address@hidden
address@hidden off
address@hidden
address@hidden }
address@hidden 9
+
address@hidden SMALLPRINT
address@hidden @i{Ai miei genitori, per il loro amore, e per lo splendido
esempio che mi hanno dato.}
address@hidden 1
address@hidden @i{A mia moglie, Miriam, per avermi reso completo.
+Grazie per aver costruito la tua vita insieme a me.}
address@hidden 1
address@hidden @i{Ai nostri figli, Chana, Rivka, Nachum e Malka, per aver
arricchito le nostre vite in misura incalcolabile.}
address@hidden ifclear
+
address@hidden SMALLPRINT
address@hidden @i{Ai miei genitori, per il loro amore,}
address@hidden @i{ e per lo splendido esempio che mi hanno dato.}
address@hidden 1
address@hidden @i{A mia moglie, Miriam, per avermi reso completo.} @*
address@hidden @i{ Grazie per aver costruito la tua vita insieme a me.}
address@hidden 1
address@hidden @i{Ai nostri figli, Chana, Rivka, Nachum e Malka,}
address@hidden @i{per aver arricchito le nostre vite in misura incalcolabile.}
address@hidden ifset
+
address@hidden 1
address@hidden }
address@hidden
address@hidden }
address@hidden
address@hidden on
address@hidden iftex
+
address@hidden
+<dedication>
+<para>Ai miei genitori, per il loro amore, e per lo splendido
+esempio che mi hanno dato.</para>
+<para>A mia moglie Miriam, per avermi reso completo.
+Grazie per aver costruito la tua vita insieme con me.</para>
+<para>Ai nostri figli Chana, Rivka, Nachum e Malka,
+per aver arricchito le nostre vite in misura incalcolabile.</para>
+</dedication>
address@hidden docbook
+
address@hidden
address@hidden off
address@hidden @thispage@ @ @ @address@hidden @| @|
address@hidden @| @| @address@hidden@ @ @ @thispage
address@hidden iftex
+
address@hidden
address@hidden
address@hidden
address@hidden Top
address@hidden Introduzione Generale
address@hidden Preface node should come right after the Top
address@hidden node, in `unnumbered' sections, then the chapter, `What is gawk'.
address@hidden Licensing nodes are appendices, they're not central to AWK.
+
+Questo file documenta @command{awk}, un programma che si address@hidden usare
per
+selezionare dei record determinati in un file ed eseguire azioni su di essi.
+
address@hidden
+Copyright dell'edizione originale @copyright{} 1989, 1991, 1992, 1993,
1996--2005, 2007, 2009--2017 @*
+Free Software Foundation, Inc.
+
address@hidden
+Copyright dell'edizione italiana @copyright{} 2016 -- Free Software
Foundation, Inc.
+
+
address@hidden
+
address@hidden ifnotdocbook
address@hidden ifnotxml
address@hidden ifnottex
+
address@hidden
+* Introduzione3:: Alcune parole gentili riguardo a questo
+ @value{DOCUMENT}.
+* Introduzione4:: Ulteriori parole gentili.
+* Prefazione:: Di cosa tratta questo @value{DOCUMENT};
+ breve storia e ringraziamenti.
+* Per iniziare:: Un'introduzione elementare all'uso di
+ @command{awk}. Come eseguire un programma
+ @command{awk}. Sintassi della riga di
+ comando.
+* Invocare Gawk:: Come eseguire @command{gawk}.
+* Espressioni regolari:: Tutto quel che c'@`e da sapere
+ sull'individuazione di stringhe tramite
+ espressioni regolari.
+* Leggere file:: Come leggere file e manipolare campi.
+* Stampare:: Come stampare usando @command{awk}.
+ Descrizione delle istruzioni @code{print} e
+ @code{printf}. @`E descritta inoltre la
+ ridirezione dell'output.
+* Espressioni:: Le espressioni sono i componenti elementari
+ delle istruzioni.
+* Criteri di ricerca e azioni:: Panoramica sui criteri di ricerca e sulle
+ azioni.
+* Vettori:: La descrizione e l'uso dei vettori. Sono
+ inoltre descritte le istruzioni di controllo
+ relative ai vettori.
+* Funzioni:: Funzioni predefinite e definite dall'utente.
+* Funzioni di libreria:: Una libreria di funzioni di @command{awk}.
+* Programmi di esempio:: Molti programmi @command{awk} con
+ spiegazioni dettagliate.
+* address@hidden avanzate:: Roba per utenti sofisticati, propria di
+ @command{gawk}.
+* Internazionalizzazione:: Come far address@hidden@dotless{i}} che
@command{gawk} parli la
+ vostra lingua.
+* Debugger:: Il debugger di @command{gawk}.
+* Calcolo con precisione arbitraria:: Calcolo con precisione arbitraria in
+ @command{gawk}.
+* Estensioni dinamiche:: Aggiungere nuove funzioni predefinite di
+ @command{gawk}.
+* Storia del linguaggio:: L'evoluzione del linguaggio @command{awk}.
+* Installazione:: Installare @command{gawk} in vari sistemi
+ operativi.
+* Note:: Note riguardo ad aggiunte a @command{gawk}
+ e possibili futuri sviluppi.
+* Concetti fondamentali:: Velocissima introduzione alla
+ programmazione.
+* Glossario:: Spiegazione di alcuni termini poco
+ familiari.
+* Copia:: Il vostro diritto a copiare e distribuire
+ @command{gawk}.
+* Licenza per Documentazione Libera GNU (FDL):: La licenza per questo
+ @value{DOCUMENT}.
+* Indice analitico:: Indice dei concetti e delle variabili.
+
address@hidden
+* Storia:: La storia di @command{gawk} e
+ @command{awk}.
+* Nomi:: Che nome usare per trovare
+ @command{awk}.
+* Questo manuale:: Uso di questo @value{DOCUMENT}.
+ Comprende esempi di file in input
+ utilizzabili.
+* Convenzioni:: Convenzioni tipografiche.
+* Storia del manuale:: Breve storia del progetto GNU e di
+ questo @value{DOCUMENT}.
+* Come contribuire:: Un aiuto per la salvezza del mondo.
+* Ringraziamenti:: Ringraziamenti.
+* Eseguire gawk:: Come eseguire programmi
+ @command{gawk}; comprende la sintassi
+ della riga di comando.
+* Monouso:: Eseguire un breve programma
+ @command{awk} di tipo usa-e-getta.
+* Leggere dal terminale:: Senza uso di file in input (input
+ immesso da tastiera).
+* Lunghi:: Mettere programmi @command{awk}
+ permanenti in file.
+* @dfn{Script} eseguibili:: Preparare programmi @command{awk}
+ da eseguire come @dfn{script}.
+* Commenti:: Aggiungere documentazione a programmi
+ @command{gawk}.
+* Protezione:: Ulteriore discussione di problemi
+ connessi alle protezioni nella shell.
+* Doppi apici in DOS:: Doppi apici in file .BAT Windows
+* File dati di esempio:: File di dati di esempio da usare nei
+ programmi @command{awk} illustrati in
+ questo @value{DOCUMENT}.
+* Molto semplice:: Un esempio molto semplice.
+* Due regole:: Un esempio meno semplice di programma
+ di una riga, che usa due regole.
+* Maggiore sofisticazione:: Un esempio address@hidden complesso.
+* Istruzioni/Righe:: Suddividere o riunire istruzioni
+ su [una o address@hidden righe.
+* Altre address@hidden:: Altre address@hidden di
@command{awk}.
+* Quando:: Quando usare @command{gawk} e quando
+ usare altre cose.
+* Sommario dell'introduzione:: Sommario dell'introduzione.
+* Riga di comando:: Come eseguire @command{awk}.
+* Opzioni:: Opzioni sulla riga di comando e loro
+ significato.
+* Altri argomenti:: Nomi dei file in input e assegnamento
+ di valori a variabili.
+* Specificare lo standard input:: Come specificare lo standard input
+ insieme ad altri file.
+* Variabili d'ambiente:: Le variabili d'ambiente usate da
+ @command{gawk}.
+* AWKPATH (Variabile):: Ricerca di programmi @command{awk}
+ in una lista di directory.
+* AWKLIBPATH (Variabile):: Ricerca di librerie condivise
+ @command{awk} in una lista di
+ directory.
+* Altre variabili d'ambiente:: Le variabili d'ambiente.
+* Codice di ritorno:: Il codice di ritorno all'uscita
+ da @command{gawk}.
+* Includere file:: Come includere altri file nel
+ proprio programma.
+* Caricare librerie condivise:: Caricare librerie condivise nel
+ proprio programma.
+* Parti obsolete:: Opzioni e/o address@hidden obsolete.
+* Non documentato:: Opzioni e address@hidden non
documentate.
+* Sommario invocazione:: Sommario di come eseguire
+ @command{awk}.
+* Uso di @dfn{regexp}:: Come usare le espressioni regolari.
+* Sequenze di protezione:: Come scrivere caratteri non stampabili.
+* Operatori di espressioni regolari:: Operatori di espressioni regolari.
+* Espressioni tra parentesi quadre:: Cosa possono contenere @samp{[...]}.
+* address@hidden lungo da sinistra:: Quanto @`e lungo il testo
individuato.
+* Espressioni regolari calcolate:: Usare @dfn{regexp} dinamiche.
+* Operatori di @dfn{regexp} GNU:: Operatori propri del software GNU.
+* Maiuscolo-Minuscolo:: Fare confronti ignorando
+ maiuscolo/minuscolo.
+* Sommario espressioni regolari:: Sommario delle espressioni regolari.
+* Record:: Controllare come i dati sono suddivisi
+ in record.
+* awk divisione record:: Divisione dei record con @command{awk}
+ standard.
+* gawk divisione record:: Divisione dei record con
@command{gawk}.
+* Campi:: Un'introduzione ai campi.
+* Campi non costanti:: Numeri di campo variabili.
+* Cambiare i campi:: Cambiare il contenuto di un campo.
+* Separatori di campo:: I separatori di campo, e come
+ cambiarli.
+* Separatori di campo di default:: Come di solito sono separati i campi.
+* Separare campi con @dfn{regexp}:: Usare @dfn{regexp} come separatori.
+* Campi di un solo carattere:: Fare di ogni carattere un campo
+ separato.
+* Separatori campo da riga di comando:: Impostare @code{FS} dalla riga di
+ comando.
+* Campo intera riga:: Fare di una riga intera un campo
+ solo.
+* Sommario sulla separazione campi:: Alcuni punti finali e una tavola di
+ sommario.
+* Dimensione costante:: Leggere campi di larghezza costante.
+* Separazione in base al contenuto:: Definire campi dal loro Contenuto.
+* Righe multiple:: Record su righe multiple
+* Getline:: Richiedere input usando @code{getline}.
+* Getline semplice:: Usare @code{getline} senza argomenti.
+* Getline variabile:: Usare @code{getline} in una variabile.
+* Getline file:: Usare @code{getline} da un file.
+* Getline variabile file:: Usare @code{getline} in una variabile
+ da un file.
+* Getline @dfn{pipe}:: Usare @code{getline} da una @dfn{pipe}.
+* Getline variabile @dfn{pipe}:: Usare @code{getline} in una variabile
+ da una @dfn{pipe}.
+* Getline coprocesso:: Usare @code{getline} da un coprocesso.
+* Getline variabile coprocesso:: Usare @code{getline} in una variabile
+ da un coprocesso.
+* Note su getline:: Cose importanti da sapere su
+ @code{getline}.
+* Sommario di getline:: Sommario delle varianti di
+ @code{getline}.
+* Timeout in lettura:: Leggere input entro un tempo limite.
+* Proseguire dopo errore in input:: Rielaborare input dopo certi errori.
+* Directory su riga di comando:: Cosa accade se si mette una directory
+ sulla riga di comando.
+* Sommario di Input:: Sommario di Input.
+* Esercizi su Input:: Esercizi.
+* Print:: L'istruzione @code{print}.
+* Esempi su print:: Semplici esempi di
+ istruzioni @code{print}.
+* Separatori di output:: I separatori di output e come
+ modificarli.
+* OFMT:: Controllare l'output di numeri con
+ @code{print}.
+* Printf:: L'istruzione @code{printf}.
+* Printf Fondamenti:: Sintassi dell'istruzione
+ @code{printf}.
+* Lettere di controllo:: Lettere di controllo del formato.
+* Modificatori di formato:: Modificatori specifiche di formato.
+* Esempi su printf:: Numerosi esempi.
+* Ridirezione:: Come ridirigere l'output a diversi
+ file e @dfn{pipe}.
+* FD speciali:: File speciali per I/O.
+* File speciali:: Interpretazione @value{FNS} in
+ @command{gawk}. @command{gawk}
+ permette di accedere a descrittori di
+ file ereditati.
+* Altri file ereditati:: Accedere ad altri file aperti con
+ @command{gawk}.
+* Reti speciali:: File speciali per comunicazioni con
+ la rete.
+* Avvertimenti speciali:: Cose a cui prestare attenzione.
+* Chiusura file e @dfn{pipe}:: Chiudere file in input e di output e
+ @dfn{pipe}.
+* Continuazione dopo errori:: Abilitare continuazione dopo errori
+ in output.
+* Sommario di Output:: Sommario di Output.
+* Esercizi su Output:: Esercizi.
+* Valori:: Costanti, variabili ed espressioni
+ regolari.
+* Costanti:: Costanti di tipo stringa, numeriche ed
+ espressioni regolari.
+* Costanti scalari:: Costanti numeriche e stringhe.
+* Numeri non-decimali:: Cosa sono i numeri ottali ed
+ esadecimali.
+* Costanti come espressioni regolari:: Costanti fornite tramite espressioni
+ regolari.
+* Usare le costanti @dfn{regexp}:: Quando e come usare una costante
+ specificata tramite espressioni
+ regolari
+* Costanti @dfn{regexp} normali:: Costanti @dfn{regexp} normali in
+ @command{awk}.
+* Costanti @dfn{regexp} forti:: Costanti @dfn{regexp} fortemente
+ tipizzate.
+* Variabili:: Le variabili permettono di
+ definire valori da usare in seguito.
+* Usare variabili:: Usare variabili nei propri programmi.
+* Opzioni di assegnamento:: Impostare variabili dalla riga di
+ comando, e un sommario della sintassi
+ della riga di comando.
+ Questo @`e un metodo di input avanzato.
+* Conversione:: La conversione di stringhe in numeri
+ e viceversa.
+* Stringhe e numeri:: Come @command{awk} converte tra
+ stringhe e numeri.
+* Localizzazione e conversioni:: Come la localizzazione address@hidden
influire
+ sulle conversioni.
+* Tutti gli operatori:: Gli operatori di @command{gawk}.
+* Operatori aritmetici:: Operazioni aritmetiche (@samp{+},
+ @samp{-}, etc.)
+* Concatenazione:: Concatenazione di stringhe.
+* Operatori di assegnamento:: Cambiare il valore di una variabile
+ o di un campo.
+* Operatori di incremento:: Incrementare il valore numerico di una
+ variabile.
+* Valori e condizioni di address@hidden:: Determinare Vero/Falso.
+* Valori di address@hidden:: Cosa @`e ``vero'' e cosa @`e
``falso''.
+* Tipi di variabile e confronti:: Come alle variabili si assegna il tipo
+ e l'effetto che questo ha sul confronto
+ di numeri e stringhe con @samp{<}, etc.
+* Tipi di variabile:: Tipo stringa rispetto a tipo numero.
+* Operatori di confronto:: Gli operatori di confronto.
+* Confronto POSIX di stringhe:: Confronto tra stringhe usando le
+ regole POSIX.
+* Operatori booleani:: Combinare espressioni di confronto
+ usando operatori booleani @samp{||}
+ (``or''), @samp{&&} (``and'') e
+ @samp{!} (``not'').
+* Espressioni condizionali:: Le espressioni condizionali scelgono
+ una tra due sottoespressioni, a
+ seconda del valore di una terza
+ sottoespressione.
+* Chiamate di funzione:: Una chiamata di funzione @`e
+ un'espressione.
+* Precedenza:: Come si nidificano i vari operatori.
+* Localizzazioni:: Come la localizzazione influenza la
+ gestione dati.
+* Sommario delle espressioni:: Sommario delle espressioni.
+* Panoramica sui criteri di ricerca:: Come scrivere un criterio di ricerca.
+* @dfn{regexp} come criteri di ricerca:: Espressioni regolari come criteri
+ di ricerca.
+* Espressioni come criteri di ricerca:: Qualsiasi espressione address@hidden
servire da
+ criterio di ricerca.
+* Intervalli:: Specificare intervalli di record con i
+ criteri di ricerca.
+* BEGIN/END:: Specificare regole di inizio e fine
+ programma.
+* Usare BEGIN/END:: Come e perch@'e usare regole BEGIN/END.
+* I/O e BEGIN/END:: Problemi di I/O nelle regole BEGIN/END.
+* BEGINFILE/ENDFILE:: Due condizioni speciali per controlli
+ avanzati.
+* Vuoto:: Il criterio di ricerca vuoto, che
+ corrisponde a ogni record.
+* Usare variabili di shell:: Come usare variabili di shell in
+ @command{awk}.
+* Panoramica sulle azioni:: Cosa costituisce un'azione.
+* Istruzioni:: Descrizione dettagliata delle varie
+ istruzioni di controllo.
+* Istruzione if:: Eseguire in maniera condizionale
+ istruzioni @command{awk}.
+* Istruzione while:: Eseguire il ciclo, finch@'e @`e
+ verificata una condizione.
+* Istruzione do:: Eseguire l'azione specificata,
continuare
+ a eseguire il ciclo
+ finch@'e @`e verificata una condizione.
+* Istruzione for:: Un'altra istruzione iterativa, che
+ permette di specificare clausole
+ iniziali e di incremento.
+* Istruzione switch:: Valutazione di quale insieme di
+ istruzioni eseguire, a seconda del
+ valore assunto da una variabile.
+* Istruzione break:: Uscire subito dal ciclo address@hidden
interno
+ in cui ci si trova.
+* Istruzione continue:: Andare alla fine del ciclo
address@hidden interno
+ in cui ci si trova.
+* Istruzione next:: Smettere di elaborare il record
+ corrente.
+* Istruzione nextfile:: Smettere di elaborare il file
+ corrente.
+* Istruzione exit:: Interrompere l'esecuzione di
@command{awk}.
+* Variabili predefinite:: Sommario delle variabili predefinite.
+* Variabili modificabili dall'utente:: Variabili predefinite modificabili per
+ controllare @command{awk}.
+* Variabili auto-assegnate:: Variabili predefinite con cui
+ @command{awk} fornisce informazioni.
+* ARGC e ARGV:: Modi di usare @code{ARGC} e
+ @code{ARGV}.
+* Sommario criteri e azioni:: Sommario criteri e azioni.
+* Fondamenti sui vettori:: Informazioni di base sui vettori.
+* Introduzione ai vettori:: Introduzione ai vettori.
+* Visitare elementi:: Come esaminare un elemento di un
+ vettore.
+* Impostare elementi:: Come cambiare un elemento di un
+ vettore.
+* Esempio di vettore:: Esempio semplice di vettore
+* Visitare un intero vettore:: Variazione dell'istruzione
+ @code{for}. Cicla attraverso gli
+ indici degli elementi contenuti in
+ un vettore.
+* Controllare visita:: Controllare l'ordine in cui i vettori
+ sono visitati.
+* Indici numerici di vettore:: Come usare numeri come indici in
+ @command{awk}.
+* Indici non inizializzati:: Usare variabili non inizializzate
+ come indici.
+* Cancellazione:: L'istruzione @code{delete} toglie un
+ elemento da un vettore.
+* Vettori multidimensionali:: Emulare vettori multidimensionali in
+ @command{awk}.
+* Visitare vettori multidimensionali:: Visitare vettori multidimensionali.
+* Vettori di vettori:: Vettori multidimensionali veri.
+* Sommario dei vettori:: Sommario dei vettori.
+* Funzioni predefinite:: Riepilogo delle funzioni predefinite.
+* Chiamare funzioni predefinite:: Come chiamare funzioni predefinite.
+* Funzioni numeriche:: Funzioni che trattano numeri, comprese
+ @code{int()}, @code{sin()}
+ e @code{rand()}.
+* Funzioni per stringhe:: Funzioni di manipolazione di stringhe,
+ come @code{split()}, @code{match()}
+ e @code{sprintf()}.
+* Dettagli ostici:: address@hidden di quel che si vorrebbe
sapere su
+ @samp{\} e @samp{&} con @code{sub()},
+ @code{gsub()}, e @code{gensub()}.
+* Funzioni di I/O:: Funzioni per i file e per i comandi
+ della shell.
+* Funzioni di tempo:: Funzione per gestire marcature
temporali.
+* Funzioni a livello di bit:: Funzioni per operazioni di
+ manipolazione bit.
+* Funzioni per i tipi:: Funzioni per conoscere il tipo
+ di una variabile.
+* Funzioni di internazionalizzazione:: Funzioni per tradurre stringhe.
+* Funzioni definite dall'utente:: Descrizione dettagliata delle funzioni
+ definite dall'utente.
+* Sintassi delle definizioni:: Come scrivere definizioni e cosa
+ significano.
+* Esempio di funzione:: Un esempio di definizione di
+ funzione e spiegazione della stessa.
+* Precisazioni sulle funzioni:: Cose a cui prestare attenzione.
+* Chiamare una funzione:: Non usare spazi.
+* Campo di address@hidden variabili:: Variabili locali e globali.
+* Parametri per valore/riferimento:: Passaggio parametri.
+* Istruzione return:: Specificare il valore che una
+ funzione restituisce.
+* Variabili di tipo dinamico:: Come cambiare tipo a una variabile in
+ fase di esecuzione del programma.
+* Chiamate indirette:: Scegliere la funzione da chiamare in
+ fase di esecuzione del programma.
+* Sommario delle funzioni:: Sommario delle funzioni.
+* Nomi di variabili di libreria:: Che nomi @`e meglio dare alle variabili
+ private globali nelle funzioni di
+ libreria
+* Funzioni di tipo generale:: Funzioni di uso generale.
+* Funzione strtonum:: Da usare se non @`e disponibile la
+ funzione predefinita
+ @code{strtonum()}.
+* Funzione assert:: Una funzione per controllare
+ affermazioni in programmi
+ @command{awk}.
+* Funzione round:: Una funzione per eseguire
+ arrotondamenti se @code{sprintf()}
+ non lo fa correttamente.
+* Funzione random Cliff:: Il generatore Cliff di numeri casuali.
+* Funzioni ordinali:: Funzioni per usare caratteri come
+ numeri e viceversa.
+* Funzione join:: Una funzione per raccogliere un
+ vettore in una stringa.
+* Funzione getlocaltime:: Una funzione per ottenere data e
+ ora nel formato desiderato.
+* Funzione readfile:: Una funzione per leggere un file
+ intero in un colpo solo.
+* Apici alla shell:: Una funzione per passare stringhe
+ con apici alla shell.
+* Gestione File Dati:: Funzioni for gestire file dati
+ specificati sulla riga di comando,
+* Funzione filetrans:: Una funzione per gestire il passaggio
+ da un file in input al successivo.
+* Funzione rewind:: Una funzione per rileggere il file
+ di input.
+* Controllo di file:: Controllare che i file in input siano
+ accessibili.
+* File vuoti:: Controllare se i file in input sono
+ vuoti.
+* Ignorare assegnamenti di variabili:: Trattare assegnamenti di variabili
+ come nomi di file.
+* Funzione getopt:: Una funzione per trattare argomenti
+ presenti sulla riga di comando.
+* Funzioni Passwd:: Funzioni per ottenete informazioni
+ sull'utente [da /etc/passwd].
+* Funzioni Group:: Funzioni per ottenete informazioni
+ sul gruppo [da /etc/group].
+* Visitare vettori:: Una funzione per visitare vettori
+ di vettori.
+* Sommario funzioni di libreria:: Sommario funzioni di libreria.
+* Esercizi con le librerie:: Esercizi.
+* Eseguire esempi:: Come eseguire i programmi di esempio.
+* Cloni:: Cloni di programmi di address@hidden
comuni.
+* Programma cut:: Il programma di address@hidden
@command{cut}.
+* Programma egrep:: Il programma di address@hidden
@command{egrep}.
+* Programma id:: Il programma di address@hidden
@command{id}.
+* Programma split:: Il programma di address@hidden
@command{split}.
+* Programma tee:: Il programma di address@hidden
@command{tee}.
+* Programma uniq:: Il programma di address@hidden
@command{uniq}.
+* Programma wc:: Il programma di address@hidden
@command{wc}.
+* Programmi vari:: Alcuni interessanti programmi in
+ @command{awk}
+* Programma dupword:: Trovare parole duplicate in un
+ documento.
+* Programma alarm:: Un programma di sveglia.
+* Programma translate:: Un programma simile al comando di
+ address@hidden @command{tr}.
+* Programma labels:: Stampare etichette per lettere.
+* Programma utilizzo parole:: Un programma per produrre un contatore
+ dell'utilizzo di parole in un testo.
+* Programma riordino diario:: Eliminare righe doppie da un file di
+ cronologia.
+* Programma extract:: Estrarre programmi da file sorgenti
+ Texinfo.
+* Programma sed semplice:: Un semplice editor di flusso.
+* Programma igawk:: Un programma per fornire ad
+ @command{awk} la address@hidden di
+ includere file.
+* Programma anagram:: Trovare anagrammi da una lista di
+ parole.
+* Programma signature:: La gente fa cose stupefacenti se ha
+ troppo tempo libero.
+* Sommario dei programmi:: Sommario dei programmi.
+* Esercizi sui programmi:: Esercizi.
+* Dati non decimali:: Consentire dati di input in base
+ diversa da 10.
+* Ordinamento di vettori:: Modi per controllare la visita di un
+ vettore e il suo ordinamento.
+* Controllare visita vettori:: Come usare PROCINFO["sorted_in"].
+* Funzioni di ordinamento di vettori:: Come usare @code{asort()} e
+ @code{asorti()}.
+* I/O bidirezionale:: Comunicazione nei due sensi con un
+ altro processo.
+* Reti TCP/IP:: Usare @command{gawk} per
+ programmazione di rete.
+* Profilare:: Profilare i propri programmi
+ @command{awk}.
+* Sommario address@hidden avanzate:: Sommario address@hidden avanzate.
+* I18N e L10N:: Internazionalizzazione e localiz.
+* Utilizzare @command{gettext}:: Come funziona GNU @code{gettext}.
+* I18N per programmatore:: address@hidden per il programmatore.
+* I18N per traduttore:: address@hidden per il traduttore.
+* Estrazione di stringhe:: Estrarre stringhe marcate.
+* Ordinamento di printf:: Riordinare argomenti @code{printf}
+ [nelle stringhe da tradurre].
+* address@hidden nell'I18N:: Problemi di address@hidden a livello
di
+ @command{awk}.
+* Esempio I18N:: Un semplice esempio di
+ internazionalizzazione.
+* Gawk internazionalizzato:: @command{gawk} stesso @`e
+ internazionalizzato.
+* Sommario I18N:: Sommario sull'internazionalizzazione.
+* Debugging:: Introduzione al debugger di
+ @command{gawk}.
+* Nozioni sul debug:: address@hidden sul debug.
+* Terminologia nel debug:: Concetti fondamentali sul debug.
+* Debug di Awk:: Il debug di @command{awk}.
+* Esempio di sessione di debug:: Esempio di sessione di debug di
+ @command{gawk}.
+* Invocazione del debugger:: Come avviare il debugger.
+* Trovare il bug:: Trovare il bug.
+* Lista dei comandi di debug:: I principali comandi di debug.
+* Controllo dei breakpoint:: Controllo dei punti d'interruzione.
+* Controllo esecuzione debugger:: Controllo di esecuzione.
+* Vedere e modificare dati:: Vedere e modificare dati.
+* Stack di esecuzione:: Lavorare con lo stack.
+* Informazioni sul debugger:: Ottenere informazioni sullo stato
+ del programma e del debugger.
+* Comandi vari del debugger:: Comandi vari del debugger.
+* Supporto per Readline:: Supporto per Readline.
+* Limitazioni:: Limitazioni.
+* Sommario sul debug:: Sommario sul debug.
+* Aritmetica del computer:: Una rapida introduzione alla
matematica del
+ computer.
+* Definizioni matematiche:: Altre cose da sapere.
+* address@hidden MPFR:: address@hidden per il calcolo a
+ precisione arbitraria in @command{gawk}
+* Cautela col calcolo in VM:: Cose da sapere.
+* Inesattezza nei calcoli:: La matematica in virgola mobile non @`e
+ esatta.
+* Rappresentazioni inesatte:: Molti numeri non sono rappresentati
+ esattamente.
+* Confronti tra valori in VM:: Come confrontare valori in virgola
mobile.
+* Gli errori si sommano:: Gli errori diventano sempre maggiori.
+* Ottenere la precisione:: Ottenere la precisione voluta.
+* Tentare di arrotondare:: Tentare di aggiungere bit di
precisione e
+ arrotondare.
+* Impostare la precisione:: Impostare la precisione.
+* Impostare modi di arrotondare:: Impostare la address@hidden di
+ arrotondamento.
+* Interi a precisione arbitraria:: Aritmetica dei numeri interi a
precisione
+ arbitraria con @command{gawk}.
+* Problemi virgola mobile POSIX:: Confronto tra standard e uso corrente.
+* Sommario virgola mobile:: Sommario della trattazione della
+ virgola mobile.
+* Introduzione alle estensioni:: Cos'@`e un'estensione.
+* Licenza delle estensioni:: tipo di licenza delle estensioni.
+* Panoramica sul meccanismo delle estensioni:: Come funziona a grandi linee.
+* Descrizione dell'API delle estensioni:: Una descrizione completa dell'API.
+* Intro funzioni API delle estensioni:: Introduzione alle funzioni dell'API.
+* Tipi di dati generali:: I tipi di dati.
+* Funzioni di allocazione memoria:: Funzioni per allocare memoria.
+* Funzioni di costruzione:: Funzioni per creare valori.
+* Funzioni di registrazione:: Funzioni per registrare cose con
+ @command{gawk}.
+* Funzioni di estensione:: Registrare funzioni di estensione.
+* Funzioni di exit callback:: Registrare una exit di callback.
+* Stringa di versione Estensioni:: Registrare una stringa di versione.
+* Analizzatori di input:: Registrare un analizzatore di input.
+* Processori di output:: Registrare un processore di output.
+* Processori bidirezionali:: Registrare un processore
+ bidirezionale.
+* Stampare messaggi:: Stampare messaggi dalle estensioni.
+* Aggiornare @code{ERRNO}:: Funzioni per aggiornare @code{ERRNO}.
+* Richiedere valori:: Come ottenere un valore.
+* Accedere ai parametri:: Funzioni per acceder ai parametri.
+* Accedere alla tabella simboli:: Funzioni per accedere alle variabili
+ globali.
+* Tabella simboli per nome:: Accedere e aggiornare variabili per
nome.
+* Tabella simboli tramite cookie:: Accedere alle variabili per ``cookie''.
+* Valori nascosti:: Creare e usare valori nascosti.
+* Manipolazione di vettori:: Funzioni per lavorare coi vettori.
+* Tipi di dati per i vettori:: Tipi dati per lavorare coi vettori.
+* Funzioni per i vettori:: Funzioni per lavorare coi vettori.
+* Appiattimento di vettori:: Come appiattire i vettori.
+* Creazione di vettori:: Come creare e popolare vettori.
+* Ridirezione API:: Come accedere alla ridirezioni e
+ modificarle.
+* Variabili dell'estensione API:: Variabili fornite dall'API.
+* Versione dell'estensione:: Informazioni sulla versione API.
+* Variabili informative di estens. API:: Variabili che forniscono informazioni
+ sull'invocazione di @command{gawk}.
+* Codice predefinito di un'estensione API:: Codice predefinito di interfaccia
API.
+* Modifiche dalla versione API 1:: Modifiche dalla versione 1 dell'API.
+* Trovare le estensioni:: Come @command{gawk} trova le
+ estensioni compilate.
+* Esempio di estensione:: Esempio di codice C di un'estensione.
+* Descrizione interna file:: Quello che le nuove funzioni faranno.
+* Operazioni interne file:: Codice per gestire file all'interno.
+* Usare operazioni interne file:: Come usare un'estensione esterna.
+* Esempi di estensione:: Le estensioni di esempio incluse con
+ @command{gawk}.
+* Esempio di estensione funzioni file:: Funzioni relative ai file.
+* Esempio di estensione Fnmatch:: Un'interfaccia a @code{fnmatch()}.
+* Esempio di estensione Fork:: Un'interfaccia a @code{fork()} e
+ altre funzioni di processo.
+* Esempio di estensione Inplace:: Consentire modifica file input
+ nell'estensione.
+* Esempio di estensione Ord:: Conversioni di caratteri in valori
+ numerici e viceversa.
+* Esempio di estensione Readdir:: Un'interfaccia a @code{readdir()}.
+* Esempio di estensione Revout:: Invertire la stringa in output.
+* Esempio di estensione Rev2way:: Esempio di I/O bidirezionale.
+* Esempio di estensione Rwarray:: Scaricare e ricaricare un vettore.
+* Esempio di estensione Readfile:: Leggere un intero file in una stringa.
+* Esempio di estensione Time:: Un'interfaccia a @code{gettimeofday()}
+ e @code{sleep()}.
+* Esempio di estensione API Test:: Test per la API.
+* gawkextlib:: Il progetto @code{gawkextlib}.
+* Sommario delle estensioni:: Sommario delle estensioni.
+* Esercizi sulle estensioni:: Esercizi.
+* V7/SVR3.1:: Le principali differenze tra V7 e
+ System V Release 3.1.
+* SVR4:: Differenze minori tra System V
+ Release 3.1 e 4.
+* POSIX:: Nuove address@hidden per lo standard
+ POSIX.
+* BTL:: Nuove address@hidden dalla versione
+ di @command{awk} di Brian Kernighan.
+* POSIX/GNU:: Le estensioni in @command{gawk} non
+ previste in @command{awk} POSIX.
+* Storia delle address@hidden:: Storia delle address@hidden di
+ @command{gawk}.
+* Estensioni comuni:: Sommario Estensioni comuni.
+* Intervalli e localizzazione:: Come le localizzazioni influiscono
+ sugli intervalli delle espressioni
+ regolari.
+* Contributori:: I maggiori contributori a
+ @command{gawk}.
+* Sommario della storia:: Sommario della storia.
+* Distribuzione di Gawk:: Contenuto della distribuzione di
+ @command{gawk}.
+* Scaricare:: Come ottenere la distribuzione.
+* Scompattazione:: Come estrarre la distribuzione.
+* Contenuti della distribuzione:: Cosa c'@`e nella distribuzione.
+* Installazione Unix:: Installare @command{gawk} su
+ varie versioni di Unix.
+* Installazione veloce:: Compilare @command{gawk} sotto Unix.
+* File da usare a inizio sessione:: Funzioni di personalizzazione shell.
+* Ulteriori opzioni di configurazione:: Altre opzioni utilizzabili in fase
+ di compilazione.
+* Filosofia della configurazione:: Come si suppone che funzioni.
+* Installazione non-Unix:: Installazioni su altri Sistemi
+ Operativi.
+* Installazione su PC:: Installare e compilare
+ @command{gawk} su Microsoft Windows.
+* Installazione binaria su PC:: Installare una distribuzione pronta
+ all'uso.
+* Compilazione su PC:: Compilare @command{gawk} per
+ Windows32.
+* Uso su PC:: Eseguire @command{gawk} su Windows32.
+* Cygwin:: Compilare ed eseguire @command{gawk}
+ per Cygwin.
+* MSYS:: Usare @command{gawk} nell'ambiente
+ MSYS.
+* Installazione su VMS:: Installare @command{gawk} su VMS.
+* Compilazione su VMS:: Come compilare @command{gawk} su
+ VMS.
+* Estensioni dinamiche su VMS:: Compilare estensioni dinamiche
+ di @command{gawk} su VMS.
+* Dettagli installazione su VMS:: Come installare @command{gawk} su
+ VMS.
+* Esecuzione su VMS:: Come eseguire @command{gawk} su VMS.
+* GNV su VMS:: Il progetto GNV di VMS.
+* Vecchio Gawk su VMS:: Una versione non aggiornata arriva
+ con alcune versioni di VMS.
+* Bug:: Notificare problemi e bug.
+* Indirizzo Bug:: Dove notificare problemi.
+* Usenet:: Dove non notificare problemi.
+* Manutentori:: Manutentori di version non-*nix.
+* Altre versioni:: Altre implementazioni di
+ @command{awk} liberamente
+ disponibili.
+* Sommario dell'installazione:: Sommario dell'installazione.
+* address@hidden di address@hidden:: Come inibire alcune estensioni
di
+ @command{gawk}.
+* Aggiunte:: Fare aggiunte a @command{gawk}.
+* Accedere ai sorgenti:: Accedere al deposito sorgenti Git.
+* Aggiungere codice:: Aggiungere codice al programma
+ principale @command{gawk}.
+* Nuovi sistemi:: Rendere disponibile @command{gawk}
+ a un nuovo sistema operativo.
+* File derivati:: Perch@'e i file ancillari sono tenuti
+ nel deposito @command{git}.
+* Future estensioni:: Nuove address@hidden che potranno
+ essere implementate in futuro.
+* Limitazioni dell'implementazione:: Alcune limitazioni
+ dell'implementazione.
+* Progetto delle estensioni:: Note di progetto sull'estensione API.
+* Problemi con le vecchie estensioni:: Problemi con la precedente
+ implementazione di estensioni.
+* Obiettivi delle estensioni:: Obiettivi del nuovo meccanismo.
+* Altre scelte progettuali per le estensioni:: Qualche altra scelta
progettuale.
+* Futuri sviluppi delle estensioni:: address@hidden di crescita futura.
+* Meccanismo delle vecchie estensioni:: Problemi con le vecchie estensioni.
+* Sommario delle note:: Sommario delle note di
+ implementazione.
+* Fondamenti ad alto livello:: Una visione dall'alto.
+* Fondamenti sui tipi di dati:: Una velocissima introduzione ai tipi
+ di dati.
address@hidden detailmenu
address@hidden menu
+
address@hidden dedication for Info file
address@hidden
+Ai miei genitori, per il loro amore, e per lo splendido
+esempio che mi hanno dato.
address@hidden 1
+A mia moglie Miriam, per avermi reso completo.
+Grazie per aver costruito la tua vita insieme a me.
address@hidden 1
+Ai nostri figli Chana, Rivka, Nachum e Malka,
+per aver arricchito le nostre vite in misura incalcolabile.
address@hidden ifinfo
+
address@hidden SMALLPRINT
address@hidden 10
address@hidden ifset
+
address@hidden
address@hidden
+
address@hidden SMALLPRINT
address@hidden 11
address@hidden ifset
+
address@hidden Introduzione3
address@hidden Introduzione alla Terza Edizione
+
address@hidden This bit is post-processed by a script which turns the chapter
address@hidden tag into a preface tag, and moves this stuff to before the title.
address@hidden Bleah.
address@hidden
+ <prefaceinfo>
+ <author>
+ <firstname>Michael</firstname>
+ <surname>Brennan</surname>
+ <!-- can't put mawk into command tags. sigh. -->
+ <affiliation><jobtitle>Autore di mawk</jobtitle></affiliation>
+ </author>
+ <date>Marzo 2001</date>
+ </prefaceinfo>
address@hidden docbook
+
+Arnold Robbins e io siamo buoni amici. Ci siamo conosciuti
address@hidden 11 years ago
+nel 1990 per un insieme di
+circostanze---e per il nostro linguaggio di programmazione preferito, AWK.
+Tutto era iniziato un paio d'anni prima.
+Avevo appena iniziato un nuovo lavoro e avevo notato un computer Unix
scollegato
+che giaceva in un angolo.
+Nessuno sapeva come usarlo, tanto meno io. Comunque,
+qualche giorno address@hidden tardi, stava funzionando, con
+me come @code{root} e solo e unico utente.
+Quel giorno, iniziai la transizione da statistico a programmatore Unix.
+
+In uno dei miei giri per biblioteche e librerie alla ricerca di libri sullo
+Unix, trovai il libro, dalla copertina grigia, su AWK, noto anche come @:
+Alfred V.@: Aho, Brian W.@: Kernighan e
+Peter J.@: Weinberger, @cite{The AWK Programming Language}, (Addison-Wesley,
+1988). Il semplice paradigma di programmazione di AWK
+---trovare un'espressione di ricerca nell'input e di conseguenza compiere
+un'azione---riduceva spesso
+complesse e tediose manipolazioni di dati a poche righe di codice. Ero
+entusiasta di cimentarmi nella programmazione in AWK.
+
address@hidden, l'@command{awk} sul mio computer era una versione limitata del
+linguaggio descritto nel libro grigio. Scoprii che il mio computer aveva il
+``vecchio @command{awk}'' mentre il libro descriveva il ``nuovo
address@hidden''
+Imparai che non era un caso isolato; la vecchia versione si rifiutava di farsi
da
+parte o di cedere il suo nome. Se un sistema aveva un nuovo @command{awk},
+questo era chiamato invariabilmente @command{nawk}, e pochi sistemi lo avevano.
+Il miglior modo per ottenere un nuovo @command{awk} era quello di scaricare via
address@hidden il codice sorgente di @command{gawk} da @code{prep.ai.mit.edu}.
address@hidden era una versione del nuovo @command{awk} scritta da David Trueman
+e Arnold, e disponibile sotto la GNU General Public License.
+
+Per inciso, ora non @`e
address@hidden address@hidden@dotless{i}} difficile trovare un nuovo
@command{awk}. @command{gawk} viene
+fornito con GNU/Linux, e si possono scaricare i binari e il codice sorgente per
+quasi tutti i sistemi; mia moglie usa @command{gawk} nella sua stazione di
lavoro VMS.
+
+Il mio sistema Unix non era inizialmente collegato a una presa di corrente; a
+maggior ragione non era collegato a una rete. address@hidden@dotless{i}},
ignaro dell'esistenza di
address@hidden e in generale della address@hidden di Unix, e desiderando un
nuovo
address@hidden, ne scrissi uno mio, chiamato @command{mawk}. Prima di aver
+finito, scoprii l'esistenza di @command{gawk},
+ma era troppo tardi per fermarmi, address@hidden@dotless{i}} alla fine inviai
un messaggio
+a un newsgroup @code{comp.sources}.
+
+Qualche giorno dopo ricevetti un cordiale messaggio di posta elettronica
+da Arnold che si presentava.
+Propose di scambiarci progetti e algoritmi, e
address@hidden una bozza dello standard POSIX, che mi permise di
+aggiornare @command{mawk} per includere le estensioni al linguaggio
+aggiunte dopo la pubblicazione di @cite{The AWK Programming Language}.
+
+Francamente, se i nostri ruoli fossero stati
+invertiti, io non sarei stato address@hidden@dotless{i}} disponibile e
probabilmente non ci
+saremmo mai incontrati. Sono felice che l'incontro sia avvenuto.
+Lui @`e un vero esperto tra gli esperti di AWK e una persona squisita.
+Arnold mette a disposizione della Free Software Foundation parti significative
+della sua esperienza e del suo tempo.
+
+Questo libro @`e il manuale di riferimento di @command{gawk}, ma
sostanzialmente
address@hidden un libro sulla programmazione in AWK che
address@hidden un vasto pubblico.
address@hidden un riferimento completo al linguaggio AWK come definito dalla
versione del
+1987 di Bell Laboratories e codificato nelle POSIX Utilities
+standard del 1992.
+
+D'altra parte, un programmatore AWK alle prime armi address@hidden studiare
+una address@hidden di programmi pratici che permettono di apprezzare
+la potenza dei concetti di base di AWK:
+flusso di controllo guidato dai dati, ricerca di corrispondenze tramite
+espressioni regolari e vettori associativi.
+Chi desidera qualcosa di nuovo address@hidden provare l'interfaccia di
@command{gawk}
+verso i protocolli di rete attraverso i file speciali @file{/inet}.
+
+I programmi in questo libro evidenziano come un programma AWK sia
+generalmente molto address@hidden piccolo e veloce da sviluppare
+di uno equivalente scritto in C.
+Di conseguenza, @`e spesso conveniente creare un prototipo di un
+algoritmo o di un progetto in AWK per arrivare a eseguirlo in breve tempo e
+scoprire prima i problemi che possono presentarsi. Spesso, l'efficienza di
+questa versione iniziale interpretata @`e sufficiente e il prototipo
+AWK diventa il prodotto finale.
+
+Il nuovo comando @command{pgawk} (profiling @command{gawk}) produce
+conteggi sull'esecuzione delle istruzioni del programma.
+Recentemente ho fatto un tentativo con un algoritmo che, a fronte di
address@hidden
address@hidden
address@hidden ifnotdocbook
address@hidden
address@hidden
address@hidden ifdocbook
+righe di input, produceva il risultato in un tempo
address@hidden
+$\sim\! Cn^2$,
address@hidden tex
address@hidden
address@hidden
+~ C n^2,
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>∼ Cn<superscript>2</superscript></emphasis>
address@hidden docbook
+mentre in teoria
+avrebbe dovuto terminare in un tempo
address@hidden
+$\sim\! Cn\log n$.
address@hidden tex
address@hidden
address@hidden
+~ C n log n.
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>∼ Cn log n</emphasis>
address@hidden docbook
+Dopo qualche minuto di attenta lettura
+del profilo in @file{awkprof.out}, ho ricondotto il problema a
+una singola riga di codice. @command{pgawk} @`e una gradita integrazione
+ai miei strumenti di programmatore.
+
+Arnold ha condensato in questo libro oltre un decennio di esperienza nell'uso
di
+programmi AWK e nello sviluppo di @command{gawk}. Se si vuole usare
+AWK o imparare ad usarlo, @`e consigliabile leggere questo libro.
+
address@hidden
address@hidden Brennan, Michael
address@hidden
+Michael Brennan
+Autore di @command{mawk}
+Marzo 2001
address@hidden display
address@hidden ifnotdocbook
+
address@hidden Introduzione4
address@hidden Introduzione alla Quarta Edizione
+
address@hidden This bit is post-processed by a script which turns the chapter
address@hidden tag into a preface tag, and moves this stuff to before the title.
address@hidden Bleah.
address@hidden
+ <prefaceinfo>
+ <author>
+ <firstname>Michael</firstname>
+ <surname>Brennan</surname>
+ <!-- can't put mawk into command tags. sigh. -->
+ <affiliation><jobtitle>Autore di mawk</jobtitle></affiliation>
+ </author>
+ <date>Ottobre 2014</date>
+ </prefaceinfo>
address@hidden docbook
+
+Ci sono cose che non cambiano. Tredici anni fa scrivevo:
+``Se si vuole usare AWK o imparare ad usarlo, @`e consigliabile
+leggere questo libro.''
+Era vero allora e rimane vero anche oggi.
+
+Imparare a usare un linguaggio di programmazione richiede qualcosa di
address@hidden
+che padroneggiarne la sintassi. Occorre comprendere come
+usare le address@hidden del linguaggio per risolvere problemi pratici di
+programmazione. Uno dei punti address@hidden importanti di questo libro @`e
che
+fornisce molti esempi che mostrano come utilizzare AWK.
+
+Altre cose, invece, cambiano. I nostri computer sono diventati molto
address@hidden
+veloci e la loro memoria @`e molto address@hidden estesa.
+Per questa ragione, la address@hidden di esecuzione e l'uso efficiente della
+memoria, caratteristiche di un linguaggio di livello elevato, hanno minore
+rilevanza.
+Scrivere un programma prototipo in AWK per poi riscriverlo in C per
+migliorare l'utilizzo delle risorse capita sempre meno, perch@'e sempre
address@hidden
+spesso il prototipo @`e abbastanza veloce anche per essere messo in produzione.
+
+Naturalmente, ci sono tipi di calcoli che sono effettuati address@hidden
agevolmente
+da programmi scritti in C o C++.
+Con @command{gawk} 4.1 e successive versioni, non @`e necessario
+decidere se scrivere un programma in AWK oppure in C/C++. Si address@hidden
scrivere
+buona parte del programma in AWK e le parti che richiedono
+specificamente il C/C++ possono essere scritte in C/C++ e quindi il tutto
address@hidden essere eseguito come un programma unico, con il modulo
@command{gawk}
+che carica dinamicamente il modulo C/C++ in fase di esecuzione.
address@hidden Chapter 16
address@hidden
+Il
address@hidden iftex
address@hidden dinamiche},
+spiega la procedura in gran
+dettaglio, e, come prevedibile, riporta molti esempi che sono di aiuto per
+approfondire anche gli aspetti address@hidden complessi.
+
address@hidden per me un piacere programmare in AWK ed @`e stato divertente
(ri)leggere
+questo libro. Penso che address@hidden lo stesso per voi.
+
address@hidden
address@hidden Brennan, Michael
address@hidden
+Michael Brennan
+Autore di @command{mawk}
+Ottobre 2014
address@hidden display
address@hidden ifnotdocbook
address@hidden Prefazione
address@hidden Prefazione
address@hidden I saw a comment somewhere that the preface should describe the
book itself,
address@hidden and the introduction should describe what the book covers.
address@hidden
address@hidden 12/2000: Chuck wants the preface & intro combined.
+
address@hidden This bit is post-processed by a script which turns the chapter
address@hidden tag into a preface tag, and moves this stuff to before the title.
address@hidden Bleah.
address@hidden
+ <prefaceinfo>
+ <author>
+ <firstname>Arnold</firstname>
+ <surname>Robbins</surname>
+ <affiliation><jobtitle>Nof Ayalon</jobtitle></affiliation>
+ <affiliation><jobtitle>Israel</jobtitle></affiliation>
+ </author>
+ <date>Febbraio 2015</date>
+ </prefaceinfo>
address@hidden docbook
+
+Lavorando con file di testo capita di dover eseguire alcuni tipi ripetitivi di
+operazioni. Si potrebbe voler estrarre alcune righe e scartare il resto, o fare
+modifiche laddove siano verificate certe condizioni, lasciando inalterato il
+resto del file. Questi compiti risultano spesso address@hidden agevoli usando
address@hidden Il programma di address@hidden @command{awk} interpreta un
linguaggio
+di programmazione specializzato che rende facile eseguire semplici
address@hidden
+di riformattazione di dati.
+
address@hidden Brian Kernighan, @command{awk} di
+L'implementazione GNU di @command{awk} @`e chiamata @command{gawk}; se
+invocato con le opzioni o con le variabili d'ambiente appropriate,
+(@pxref{Opzioni}), @`e pienamente
+compatibile con le specifiche
address@hidden standard POSIX 2008 @`e accessibile in rete all'indirizzo
address@hidden@url{http://www.opengroup.org/onlinepubs/9699919799/}.}}
+del linguaggio @command{awk}
+e con la versione Unix di @command{awk} mantenuta
+da Brian Kernighan.
address@hidden implica che tutti i programmi
address@hidden scritti correttamente dovrebbero funzionare con @command{gawk}.
address@hidden nella maggior parte dei casi non si distingue tra @command{gawk}
e
+altre implementazioni di @command{awk}.
+
address@hidden @command{awk}, POSIX e, si veda anche POSIX @command{awk}
address@hidden @command{awk}, POSIX e
address@hidden POSIX, @command{awk} e
address@hidden @command{gawk}, @command{awk} e
address@hidden @command{awk}, @command{gawk} e
address@hidden @command{awk}, uso di
+Usando @command{awk} potete:
+
address@hidden @value{BULLET}
address@hidden
+Gestire piccole basi di dati personali
+
address@hidden
+Generare rapporti
+
address@hidden
+Validare dati
+
address@hidden
+Produrre indici ed effettuare altre operazioni per la preparazione di documenti
+
address@hidden
+Sperimentare algoritmi che possono essere adattati in seguito ad altri
+linguaggi per computer
address@hidden itemize
+
address@hidden @command{awk}, si veda anche @command{gawk}
address@hidden @command{gawk}, si veda anche @command{awk}
address@hidden @command{gawk}, uso di
+Inoltre,
address@hidden
+fornisce strumenti che rendono facile:
+
address@hidden @value{BULLET}
address@hidden
+Estrarre frammenti di dati per l'elaborazione
+
address@hidden
+Ordinare dati
+
address@hidden
+Effettuare semplici comunicazioni di rete
+
address@hidden
+Creare il profilo di esecuzione ed effettuare il debug
+di programmi @command{awk}.
+
address@hidden
+Estendere il linguaggio con funzioni scritte in C o C++.
address@hidden itemize
+
+Questo @value{DOCUMENT} spiega il linguaggio @command{awk} e come lo si
address@hidden
+usare efficacemente. @`E richiesta una address@hidden coi comandi di sistema
+di base, come @command{cat} e @command{ls},@footnote{Questi programmi di
address@hidden sono disponibili sui sistemi conformi a POSIX, come pure sui
sistemi
+tradizionali basati su Unix. Se si usa qualche altro sistema operativo, si
+deve comunque avere address@hidden con i concetti di ridirezione I/O e di
address@hidden address@hidden@dotless{i}} come con le address@hidden di base
della shell, come la
+ridirezione, l'input/output (I/O) e le @dfn{pipe}.
+
address@hidden GNU @command{awk}, si veda @command{gawk}
+Implementazioni del linguaggio @command{awk} sono disponibili per diversi
+sistemi operativi di computer. Questo @value{DOCUMENT}, oltre a descrivere il
+linguaggio @command{awk} in generale, descrive anche la specifica
+implementazione di @command{awk} chiamata @command{gawk} (che sta per
+``GNU @command{awk}''). @command{gawk} funziona su una vasta gamma di sistemi
+Unix, dai PC basati su architettura Intel fino
+a sistemi di potenza molto maggiore.
address@hidden @`e stato portato anche su Mac OS X,
+Microsoft Windows
+(tutte le versioni),
+e address@hidden altro sistema operativo obsoleto su cui
address@hidden era stato portato non @`e address@hidden mantenuto e il codice
specifico
+per quei sistemi @`e stato rimosso.}
+
address@hidden
+* Storia:: La storia di @command{gawk} e
+ @command{awk}.
+* Nomi:: Che nome usare per trovare
+ @command{awk}.
+* Questo manuale:: Uso di questo @value{DOCUMENT}.
+ Comprende esempi di file in input
+ utilizzabili.
+* Convenzioni:: Convenzioni tipografiche.
+* Storia del manuale:: Breve storia del Progetto GNU e di
+ questo @value{DOCUMENT}.
address@hidden FOR_PRINT
+* Aggiornamenti:: Come tenersi al corrente.
address@hidden ifset
+* Come contribuire:: Un aiuto per la salvezza del mondo.
+* Ringraziamenti:: Ringraziamenti.
address@hidden menu
+
address@hidden Storia
address@hidden La storia di @command{gawk} e @command{awk}
address@hidden ricetta per un linguaggio di programmazione
address@hidden linguaggio di programmazione, ricetta per un
address@hidden programmazione, ricetta per un linguaggio di
address@hidden sidebar, Ricetta per un linguaggio di programmazione
address@hidden
address@hidden
+<sidebar><title>Ricetta per un linguaggio di programmazione</title>
address@hidden docbook
+
+
address@hidden {2 parti di} {1 parte di @code{egrep}} {1 parte di
@code{snobol}}
address@hidden @tab 1 parte di @code{egrep} @tab 1 parte di @code{snobol}
address@hidden @tab 2 parti di @code{ed} @tab 3 parti di C
address@hidden multitable
+
+Mescolare bene tutte le parti usando @code{lex} e @code{yacc}.
+Preparare una concisa documentazione e distribuire.
+
+Dopo otto anni, aggiungere un'altra parte di @code{egrep} e altre due
+parti di C. Documentare molto bene e distribuire.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Ricetta per un linguaggio di programmazione}
+
+
+
address@hidden {2 parti di} {1 parte di @code{egrep}} {1 parte di
@code{snobol}}
address@hidden @tab 1 parte di @code{egrep} @tab 1 parte di @code{snobol}
address@hidden @tab 2 parti di @code{ed} @tab 3 parti di C
address@hidden multitable
+
+Mescolare bene tutte le parti usando @code{lex} e @code{yacc}.
+Preparare una concisa documentazione e distribuire.
+
+Dopo otto anni, aggiungere un'altra parte di @code{egrep} e altre due
+parti di C. Documentare molto bene e distribuire.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Aho, Alfred
address@hidden Weinberger, Peter
address@hidden Kernighan, Brian
address@hidden @command{awk}, storia di
+Il nome @command{awk} deriva dalle iniziali dei suoi progettisti: Alfred V.@:
+Aho, Peter J.@: Weinberger e Brian W.@: Kernighan. La versione originale di
address@hidden fu scritta nel 1977 negli AT&T Bell Laboratories.
+Nel 1985, una nuova versione rese il linguaggio di programmazione
address@hidden potente, introducendo le funzioni definite dall'utente, flussi
di input
+multipli ed espressioni regolari calcolate.
+Questa nuova versione ebbe larga diffusione con Unix System V
+Release 3.1 (1987).
+La versione in System V Release 4 (1989) ha aggiunto alcune nuove
address@hidden
+e ha fatto pulizia nel comportamento di alcuni degli ``punti oscuri'' del
+linguaggio. Le specifiche per @command{awk} nello standard POSIX Command
+Language and Utilities ha in seguito reso address@hidden chiaro il linguaggio.
Sia i
+progettisti di @command{gawk} che quelli dell'originale @command{awk} dei Bell
+Laboratories hanno collaborato alla formulazione delle specifiche POSIX.
+
address@hidden Rubin, Paul
address@hidden Fenlason, Jay
address@hidden Trueman, David
+Paul Rubin ha scritto @command{gawk}, nel 1986.
+Jay Fenlason l'ha completata, seguendo i consigli di Richard Stallman.
+Anche John Woods ha fornito parti del codice. Nel 1988 e 1989, David Trueman,
+col mio aiuto, ha rivisto completamente @command{gawk} per la address@hidden
+col address@hidden recente @command{awk}.
+Intorno al 1994, sono divenuto il manutentore principale.
+Lo sviluppo corrente @`e incentrato sulla correzione degli errori, sul
+miglioramento delle prestazioni, sulla address@hidden agli standard e,
+occasionalmente, su nuove address@hidden
+
+Nel maggio 1997, J@"urgen Kahrs address@hidden@dotless{i}} la address@hidden
di un accesso alla
+rete da @command{awk}, e con un piccolo aiuto da parte mia, address@hidden ad
+aggiungere address@hidden a @command{gawk} per fare questo. A quel tempo,
+lui scrisse anche il grosso di
address@hidden@value{GAWKINETTITLE}}
+(un documento separato, disponibile come parte della distribuzione
address@hidden). Il suo codice alla fine venne integrato nella distribuzione
+principale di @command{gawk} con la versione 3.1 di @command{gawk}.
+
+John Haque ha riscritto la parte interna di @command{gawk}, mentre metteva a
+punto un debugger a livello di @command{awk}. Questa versione divenne
+disponibile come @command{gawk} versione 4.0 nel 2011.
+
address@hidden
+per un elenco completo di quelli che hanno fornito contributi importanti a
address@hidden
+
address@hidden Nomi
address@hidden Una rosa, con ogni altro nome...
+
address@hidden @command{awk}, nuovo e vecchio
+Il linguaggio @command{awk} si @`e evoluto nel corso degli anni. Tutti i
+dettagli si trovano in @ref{Storia del linguaggio}.
+Il linguaggio descritto in questo @value{DOCUMENT}
+viene spesso citato come ``nuovo @command{awk}''.
+Per analogia, la versione originale di @command{awk} @`e citata
+come ``vecchio @command{awk}.''
+
+Su molti sistemi di uso corrente, eseguendo il programma di address@hidden
address@hidden, si invoca qualche versione del nuovo
address@hidden@footnote{Solo i sistemi Solaris usano ancora un
+vecchio @command{awk} per il programma di address@hidden predefinito
address@hidden Una versione address@hidden moderna di @command{awk} si trova
+nella directory @file{/usr/xpg6/bin} su questi sistemi.} Se
+il comando @command{awk} nel sistema in uso @`e il vecchio, il
+risultato che vedrete per il programma di test che segue @`e
+del tipo:
+
address@hidden
+$ @kbd{awk 1 /dev/null}
address@hidden awk: syntax error near line 1
address@hidden awk: bailing out near line 1
address@hidden example
+
address@hidden
+Se questo @`e il caso, dovreste cercare una versione del nuovo @command{awk},
+o semplicemente installare @command{gawk}!
+
+All'interno di questo @value{DOCUMENT}, quando si fa riferimento a
address@hidden del linguaggio che dovrebbe essere disponibile in ogni
+implementazione completa di @command{awk} POSIX, viene usato il termine
address@hidden Quando si fa riferimento a una address@hidden specifica
+dell'implementazione GNU, viene usato i termine @command{gawk}.
+
address@hidden Questo manuale
address@hidden Uso di questo @value{DOCUMENT}
address@hidden @command{awk}, descrizione dei termini
+
+Il termine @command{awk} si riferisce sia a uno specifico programma sia al
+linguaggio che si usa per dire al programma stesso cosa deve fare. Quando
dobbiamo
+essere precisi, chiamiamo il linguaggio ``il linguaggio @command{awk},''
+e il programma ``l'address@hidden @command{awk}.''
+Questo @value{DOCUMENT} spiega
+sia come scrivere programmi nel linguaggio @command{awk} che come
+eseguire l'address@hidden @command{awk}.
+Il termine ``programma @command{awk}'' si riferisce a un programma scritto
+dall'utente nel linguaggio di programmazione @command{awk}.
+
address@hidden @command{gawk}, @command{awk} e
address@hidden @command{awk}, @command{gawk} e
address@hidden POSIX @command{awk}
+In primo luogo, questo @value{DOCUMENT} spiega le address@hidden di
@command{awk}
+come definite nello standard POSIX, e lo fa nel contesto dell'implementazione
address@hidden Oltre a questo, cerca anche di descrivere le differenze
+significative tra @command{gawk}
+e altre
address@hidden FOR_PRINT
+implementazioni @address@hidden queste differenze
+si trovano nell'indice alla
+voce ``differenze tra @command{awk} e @command{gawk}.''}
address@hidden ifclear
address@hidden FOR_PRINT
+implementazioni @command{awk}.
address@hidden ifset
+Infine, vien fatta rilevare ogni address@hidden di @command{gawk} non
+inclusa nello standard POSIX per @command{awk}.
+
address@hidden
+Questo @value{DOCUMENT} ha il difficile compito di essere tanto una guida
+introduttiva che un manuale di riferimento. I neofiti possono
+tranquillamente saltare i dettagli che sembrano loro troppo complessi.
+Possono anche ignorare i molti riferimenti incrociati, preparati avendo in
+mente gli utenti esperti e per le versioni Info e
address@hidden://www.gnu.org/software/gawk/manual/, HTML}
+del @value{DOCUMENT}.
address@hidden ifnotinfo
+
+Ci sono dei riquadri
+sparsi in tutto il @value{DOCUMENT}.
+Aggiungono una spiegazione address@hidden completa su punti importanti, ma che
+probabilmente non sono di interesse in sede di prima lettura.
address@hidden FOR_PRINT
+Si trovano tutti nell'indice analitico, alla voce ``sidebar.'' @c non c'e
riquadro nell'indice analitico
address@hidden ifclear
+
+La maggior parte delle volte, gli esempi usano programmi @command{awk}
completi.
+Alcune delle @value{SECTIONS} address@hidden avanzate mostrano solo la parte
del programma
address@hidden che illustra il concetto che si sta descrivendo.
+
+Sebbene questo @value{DOCUMENT} sia destinato soprattutto alle persone che non
+hanno una precedente conoscenza di @command{awk}, esso contiene anche tante
+informazioni che anche gli esperti di @command{awk} troveranno utili.
+In particolare, dovrebbero essere d'interesse la descrizione di POSIX
address@hidden e i programmi di esempio
address@hidden
+in
address@hidden ifnottex
address@hidden
+nel
address@hidden iftex
address@hidden di libreria} e
address@hidden
address@hidden
+in
address@hidden ifnottex
address@hidden ifnotdocbook
address@hidden
+nel
address@hidden iftex
address@hidden di esempio}.
+
+Questo @value{DOCUMENT} @`e suddiviso in diverse parti, come segue:
+
address@hidden FULLXREF ON
+
address@hidden @value{BULLET}
address@hidden
+La Parte I descrive il linguaggio @command{awk} e il programma @command{gawk}
+nel dettaglio.
+Inizia con le nozioni di base, e continua con tutte le caratteristiche di
address@hidden Contiene i seguenti capitoli:
+
address@hidden nested
address@hidden @value{MINUS}
address@hidden
address@hidden iniziare},
+fornisce le nozioni minime indispensabili per iniziare a usare @command{awk}.
+
address@hidden
address@hidden Gawk},
+descrive come eseguire @command{gawk}, il significato delle sue
+opzioni da riga di comando e come trovare i file sorgenti del programma
address@hidden
+
address@hidden
address@hidden regolari},
+introduce le espressioni regolari in generale, e in particolare le
address@hidden
+disponibili in @command{awk} POSIX e @command{gawk}.
+
address@hidden
address@hidden file},
+descrive come @command{awk} legge i dati inseriti dall'utente.
+Introduce i concetti di record e campi, e anche il
+comando @code{getline}.
+Contiene una prima descrizione della ridirezione I/O, e una breve descrizione
+dell'I/O di rete.
+
address@hidden
address@hidden,
+descrive come i programmi @command{awk} possono produrre output con
address@hidden e @code{printf}.
+
address@hidden
address@hidden,
+descrive le espressioni, che sono i componenti elementari di base
+per portare a termine la maggior parte delle operazioni in un programma.
+
address@hidden
address@hidden di ricerca e azioni},
+descrive come scrivere espressioni di ricerca per individuare corrispondenze
nei
+record, le azioni da eseguire quando si @`e trovata una corrispondenza
+in un record, e le variabili predefinite di @command{awk} e
address@hidden
+
address@hidden
address@hidden,
+tratta dell'unica struttura di dati di @command{awk}: il vettore associativo.
+Vengono trattati anche l'eliminazione di elementi del vettore e di interi
+vettori, e l'ordinamento dei vettori in @command{gawk}.
+Il @value{CHAPTER} descrive inoltre come @command{gawk} fornisce vettori di
+vettori.
+
address@hidden
address@hidden,
+descrive le funzioni predefinite fornite da @command{awk} e
address@hidden, e spiega come definire funzioni personalizzate. Viene
+anche spiegato come @command{gawk} permetta di invocare funzioni in
+maniera indiretta.
address@hidden itemize
+
address@hidden
+La Parte II illustra come usare @command{awk} e @command{gawk} per la
+risoluzione di problemi. Qui ci sono molti programmi da leggere e da cui
imparare.
+Questa parte contiene i seguenti capitoli:
+
address@hidden nested
address@hidden @value{MINUS}
address@hidden
address@hidden di libreria},
+fornisce diverse funzioni pensate per
+essere usate dai programmi scritti in @command{awk}.
+
address@hidden
address@hidden di esempio},
+fornisce molti programmi @command{awk} di esempio.
address@hidden itemize
+
+La lettura di questi due capitoli permette di capire come
address@hidden address@hidden risolvere problemi pratici.
+
address@hidden
+La Parte III si concentra sulle address@hidden specifiche di @command{gawk}.
+Contiene i seguenti capitoli:
+
address@hidden nested
address@hidden @value{MINUS}
address@hidden
address@hidden@`a avanzate},
+descrive diverse address@hidden avanzate.
+Di particolare rilevanza sono
+la address@hidden di controllare l'ordine di visita dei vettori,
+quella di instaurare comunicazioni bidirezionali con altri processi,
+di effettuare connessioni di rete TCP/IP, e di
+profilare i propri programmi @command{awk}.
+
address@hidden
address@hidden,
+descrive address@hidden speciali per tradurre i messaggi
+di programma in diverse lingue in fase di esecuzione.
+
address@hidden
address@hidden, descrive il debugger di @command{gawk}.
+
address@hidden
address@hidden con precisione arbitraria},
+illustra le address@hidden di calcolo avanzate.
+
address@hidden
address@hidden dinamiche},
+descrive come aggiungere nuove variabili e
+funzioni a @command{gawk} scrivendo estensioni in C o C++.
address@hidden itemize
+
address@hidden
address@hidden FOR_PRINT
+La Parte IV contiene le appendici, il Glossario, e due licenze relative,
+rispettivamente, al codice sorgente di @command{gawk} e a questo
address@hidden Contiene le seguenti appendici:
address@hidden ifclear
+
address@hidden FOR_PRINT
+La Parte IV contiene le seguenti appendici,
+che includono la Licenza per Documentazione Libera GNU:
address@hidden ifset
+
address@hidden @value{MINUS}
address@hidden
address@hidden del linguaggio},
+descrive l'evoluzione del linguaggio @command{awk} dalla sua prima versione
+fino a oggi. Descrive anche come @command{gawk}
+ha acquisito nuove address@hidden col passare del tempo.
+
address@hidden
address@hidden,
+descrive come ottenere @command{gawk}, come compilarlo
+sui sistemi compatibili con POSIX,
+e come compilarlo e usarlo su diversi sistemi
+non conformi allo standard POSIX. Spiega anche come segnalare gli errori
+di @command{gawk} e dove si possono ottenere altre implementazioni
+di @command{awk} liberamente disponibili.
+
address@hidden FOR_PRINT
address@hidden
address@hidden,
+presenta la licenza applicabile al codice sorgente @command{gawk}.
address@hidden ifset
+
address@hidden FOR_PRINT
address@hidden
address@hidden,
+descrive come disabilitare le estensioni @command{gawk},
+come contribuire scrivendo del nuovo codice per @command{gawk},
+e alcune possibili direzioni per il futuro sviluppo di @command{gawk}.
+
address@hidden
address@hidden fondamentali},
+fornisce del materiale di riferimento a livello elementare per chi
+sia completamente digiuno di programmazione informatica.
+
+Il @ref{Glossario}, definisce quasi tutti i termini significativi
+usati all'interno di questo @value{DOCUMENT}. Se si incontrano termini
+coi quali non si ha address@hidden, questo @`e il posto dove cercarli.
+
address@hidden
address@hidden, e
address@hidden per Documentazione Libera GNU (FDL)},
+presentano le licenze che si applicano, rispettivamente, al codice sorgente
+di @command{gawk} e a questo @value{DOCUMENT}.
address@hidden ifclear
address@hidden itemize
address@hidden itemize
+
address@hidden FOR_PRINT
+La versione di questo @value{DOCUMENT} distribuita con @command{gawk}
+contiene ulteriori appendici e altro materiale.
+Per ragioni di spazio, per questa edizione a stampa abbiamo tralasciato alcune
+delle appendici. Si possono trovare in rete ai seguenti indirizzi:
+
address@hidden @value{BULLET}
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/Notes.html,
+L'appendice sulle note di implementazione}
+descrive come disabilitare le estensioni @command{gawk}, come contribuire
+scrivendo del nuovo codice per @command{gawk}, dove reperire informazioni
+su alcune possibili future direzioni dello sviluppo di @command{gawk}, e
+sulle decisioni di progetto che hanno influito sulle estensioni API.
+
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/Basic-Concepts.html,
+L'appendice sui concetti fondamentali}
+fornisce del materiale di riferimento a livello elementare per chi sia
completamente a
+digiuno di programmazione informatica.
+
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/Glossary.html,
+Il Glossario}
+definisce la maggior parte, se non tutti, i termini significativi usati
+nel corso del libro. Se si incontrano termini con cui non si ha
address@hidden,
+questo @`e il posto dove cercarli.
+
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html,
la licenza GNU FDL}
address@hidden la licenza che vale per questo @value{DOCUMENT}.
address@hidden itemize
+
address@hidden ok not to use CHAPTER / SECTION here
+Alcuni dei capitoli hanno sezioni con esercizi; queste sono anche
+state omesse dall'edizione a stampa ma sono disponibili online.
address@hidden ifset
+
address@hidden FULLXREF OFF
+
address@hidden Convenzioni
address@hidden Convenzioni tipografiche
+
address@hidden Texinfo
+Questo @value{DOCUMENT} @`e scritto in
@uref{http://www.gnu.org/software/texinfo/, Texinfo},
+il linguaggio di formattazione della documentazione GNU. Viene usato un unico
+file sorgente Texinfo per produrre sia la versione a stampa della
documentazione
+sia quella online.
address@hidden
+A causa di address@hidden, le convenzioni tipografiche
+sono leggermente diverse da quelle presenti in altri libri che potete aver
letto.
address@hidden ifnotinfo
address@hidden
+Questo @value{SECTION} documenta brevemente le convenzioni tipografiche usate
in Texinfo.
address@hidden ifinfo
+
+Gli esempi da immettere sulla riga di comando sono preceduti dai
+comuni prompt di shell primario e secondario, @samp{$} e @samp{>}.
+L'input che si inserisce viene mostrato @kbd{in questo modo}.
address@hidden 8/2014: @print{} is stripped from the texi to make docbook.
address@hidden FOR_PRINT
+L'output del comando @`e preceduto dal glifo address@hidden'', che
+in genere rappresenta lo standard output del comando.
address@hidden ifclear
address@hidden FOR_PRINT
+L'output del comando, normalmente il suo standard output, @`e stampato
address@hidden questo modo}.
address@hidden ifset
+Messaggi di errore e altri output sullo standard error del comando sono
+preceduti dal glifo address@hidden''. Per esempio:
+
address@hidden
+$ @kbd{echo ciao su stdout}
address@hidden ciao su stdout
+$ @kbd{echo salve su stderr 1>&2}
address@hidden salve su stderr
address@hidden example
+
address@hidden
+Nel testo, quasi tutto address@hidden che riguarda la programmazione,
+per esempio i nomi dei comandi,
+appare in @code{questo font}. I frammenti
+di codice appaiono nello stesso font e tra apici, @samp{in questo modo}.
address@hidden che viene sostituito dall'utente o dal programmatore
+appare in @var{questo font}.
+Le opzioni sono stampate address@hidden@dotless{i}}: @option{-f}.
+I @value{FNS} sono indicati in questo modo: @file{/percorso/al/file}.
address@hidden FOR_PRINT
+Certe cose sono
+evidenziate @emph{in questo modo}, e se un punto dev'essere reso in modo
address@hidden
+marcato, viene evidenziato @strong{in questo modo}.
address@hidden ifclear
+La prima occorrenza di un
+nuovo termine @`e usualmente la sua @dfn{definizione} e appare nello stesso
+font della precedente occorrenza di ``definizione'' in questa frase.
address@hidden ifnotinfo
+
+I caratteri che si battono sulla tastiera sono scritti come @kbd{questi}. In
+particolare, ci sono caratteri speciali chiamati ``caratteri di controllo''.
+Questi sono caratteri che vengono battuti tenendo premuti il tasto
address@hidden e un altro tasto contemporaneamente.
+Per esempio, @kbd{Ctrl-d} @`e battuto premendo e tenendo premuto il tasto
address@hidden, poi premendo il tasto @kbd{d} e infine rilasciando entrambi i
+tasti.
+
+Per amor di address@hidden, in questo @value{DOCUMENT}, la versione di Brian
+Kernighan di @command{awk} address@hidden citata come ``BWK @command{awk}.''
+(@xref{Altre versioni} per informazioni su questa e altre versioni.)
+
address@hidden FOR_PRINT
address@hidden NOTA
+Note interessanti sono stampate in questo modo.
address@hidden quotation
+
address@hidden ATTENZIONE
+Note di avviso o raccomandazioni di cautela sono stampate in questo modo.
address@hidden quotation
address@hidden ifset
+
address@hidden fakenode --- for prepinfo
address@hidden Angoli Bui
address@hidden Kernighan, Brian
address@hidden
address@hidden angoli bui sono essenzialmente frattali---per quanto vengano
+illuminati, ce n'@`e sempre uno address@hidden piccolo e address@hidden buio.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden a.b., si veda angolo buio
address@hidden angolo buio
+Fino allo standard POSIX (e @address@hidden),
+molte caratteristiche di @command{awk} erano poco documentate o
+non documentate affatto. Le descrizioni di queste caratteristiche
+(chiamate spesso ``angoli bui'') sono segnalate in questo @value{DOCUMENT} con
address@hidden
+il disegno di una torcia elettrica nel margine, come mostrato qui.
address@hidden
address@hidden iftex
address@hidden
+``(a.b.)''.
address@hidden ifnottex
address@hidden FOR_PRINT
+Appaiono anche nell'indice sotto la voce ``angolo buio.''
address@hidden ifclear
+
+Ma come osservato nella citazione d'apertura, ogni trattazione degli
+angoli bui @`e per definizione incompleta.
+
address@hidden e.c., si veda estensioni comuni
+Estensioni al linguaggio standard di @command{awk} disponibili in
address@hidden di una
+implementazione di @command{awk} sono segnate
address@hidden FOR_PRINT
address@hidden,'' ed elencate nell'indice sotto ``estensioni comuni''
+e ``comuni, estensioni''.
address@hidden ifclear
address@hidden FOR_PRINT
address@hidden'' per ``estensioni comuni.''
address@hidden ifset
+
address@hidden Storia del manuale
address@hidden Breve storia del Progetto GNU e di questo @value{DOCUMENT}
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden Stallman, Richard
+La Free Software Foundation (FSF) @`e un'organizzazione senza scopo di lucro
+dedita alla produzione e distribuzione di software liberamente distribuibile.
address@hidden stata fondata da Richard M.@: Stallman, l'autore della prima
versione
+dell'editor Emacs. GNU Emacs @`e oggi la versione di Emacs address@hidden
largamente usata.
+
address@hidden Progetto GNU
address@hidden GNU, Progetto
address@hidden GPL (General Public License)
address@hidden General Public License, si veda GPL
address@hidden documentazione, online
+Il Progetto address@hidden sta per ``GNU's Not Unix.''}
address@hidden un progetto della Free Software
+Foundation in continuo sviluppo per creare un ambiente per computer completo,
liberamente
+distribuibile, conforme allo standard POSIX.
+La FSF usa la GNU General Public License (GPL) per assicurare che
+il codice sorgente del loro software sia sempre
+disponibile all'utente finale.
address@hidden FOR_PRINT
+Una copia della GPL @`e inclusa
address@hidden
+in questo @value{DOCUMENT}
address@hidden ifnotinfo
+per la consultazione
+(@pxref{Copia}).
address@hidden ifclear
+La GPL si applica al codice sorgente in linguaggio C per @command{gawk}.
+Per saperne di address@hidden sulla FSF e sul Progetto GNU,
+si veda @uref{http://www.gnu.org, la pagina principale del Progetto GNU}.
+Questo @value{DOCUMENT} si address@hidden leggere anche dal
address@hidden://www.gnu.org/software/gawk/manual/, sito di GNU}.
+
address@hidden FOR_PRINT
+Una shell, un editor (Emacs), compilatori ottimizzanti C, C++ e
+Objective-C altamente portabili, un debugger simbolico e dozzine di grandi e
+piccoli programmi di address@hidden (come @command{gawk}), sono stati
completati e
+sono liberamente disponibili. Il kernel del sistema operativo GNU (noto come
+HURD), @`e stato rilasciato ma @`e ancora allo stato di sviluppo iniziale.
+
address@hidden Linux
address@hidden GNU/Linux
address@hidden sistemi operativi basati su BSD
+In attesa che il sistema operativo GNU venga address@hidden completatamente
+sviluppato, si dovrebbe prendere in considerazione l'uso di GNU/Linux, un
+sistema operativo liberamente distribuibile e basato su Unix disponibile
+per Intel, Power Architecture,
+Sun SPARC, IBM S/390, e altri
address@hidden terminologia ``GNU/Linux'' @`e spiegata
+nel @ref{Glossario}.}
+Molte distribuzioni GNU/Linux sono
+scaricabili da internet.
address@hidden ifclear
+
address@hidden
+Il @value{DOCUMENT} @`e realmente libero---almeno, l'informazione che contiene
address@hidden libera per chiunque---. Il codice sorgente del
@value{DOCUMENT}, leggibile
+elettronicamente, viene fornito con @command{gawk}.
address@hidden FOR_PRINT
+(Dare un'occhiata alla Free Documentation
+License in @ref{Licenza per Documentazione Libera GNU (FDL)}.)
address@hidden ifclear
address@hidden ifnotinfo
+
address@hidden Close, Diane
+Il @value{DOCUMENT} in s@'e ha address@hidden avuto parecchie edizioni in
passato.
+Paul Rubin ha scritto la prima bozza di @cite{The GAWK Manual};, che era
+lunga una quarantina di pagine.
+Diane Close e Richard Stallman l'hanno migliorata arrivando alla
+versione che era
+lunga una novantina di pagine, e descriveva solo la versione originale
+``vecchia'' di @command{awk}.
+Ho iniziato a lavorare con quella versione nell'autunno del 1988.
+Mentre ci stavo lavorando,
+la FSF ha pubblicato parecchie versioni preliminari, numerate address@hidden).
+Nel 1996, l'edizione 1.0 fu rilasciata assieme a @command{gawk} 3.0.0.
+La FSF ha pubblicato le prime due edizioni col
+titolo @cite{GAWK: The GNU Awk User's Guide}.
address@hidden FOR_PRINT
+SSC ha pubblicato due edizioni del @value{DOCUMENT} col
+titolo @cite{Effective awk Programming}, e O'Reilly ha pubblicato
+la terza edizione nel 2001
address@hidden ifset
+
+Questa edizione mantiene la struttra di base delle edizioni precedenti.
+Per l'edizione FSF 4.0, il contenuto era stato accuratamente rivisto
+e aggiornato. Tutti i riferimenti a versioni di @command{gawk} anteriori alla
+versione 4.0 sono stati eliminati.
+Di particolare interesse in quella edizione era l'aggiunta del @ref{Debugger}.
+
+Per l'edizione FSF
address@hidden FOR_PRINT
address@hidden,
address@hidden ifclear
address@hidden FOR_PRINT
address@hidden
+(la quarta edizione, come pubblicata da O'Reilly),
address@hidden ifset
+il contenuto @`e stato riorganizzato in parti,
+e le aggiunte address@hidden importanti sono
address@hidden
+il
address@hidden iftex
address@hidden con precisione arbitraria}, e
address@hidden
+il
address@hidden iftex
address@hidden dinamiche}.
+
+Questo @value{DOCUMENT} address@hidden certamente ad evolversi. Se si trovano
+errori nel @value{DOCUMENT}, si prega di segnalarli! @xref{Bug}
+per informazioni su come inviare le segnalazione di problemi elettronicamente.
address@hidden FOR_PRINT
address@hidden Restare aggiornati
address@hidden Come restare aggiornati
+
+Potreste avere una versione di @command{gawk} address@hidden recente di quella
+descritta qui. Per vedere cosa @`e cambiato,
+dovreste prima guardare il file @file{NEWS} nella distribuzione di
address@hidden, che fornisce un sommario ad alto livello dei
+cambiamenti in ciascuna versione.
+
+You can then look at the @uref{http://www.gnu.org/software/gawk/manual/,
+online version} of this @value{DOCUMENT} to read about any new features.
address@hidden ifset
+
address@hidden FOR_PRINT
address@hidden Come contribuire
address@hidden Come collaborare
+
+Come manutentore di GNU @command{awk}, un tempo pensai che sarei stato in grado
+di gestire una raccolta di programmi @command{awk} pubblicamente disponibili e
+avevo anche esortato a collaborare. Rendere disponibili le cose su Internet
+aiuta a contenere la distribuzione @command{gawk} entro dimensioni gestibili.
+
+L'iniziale raccolta di materiale, come questo, @`e tuttora disponibile
+su @uref{ftp://ftp.freefriends.org/arnold/Awkstuff}.
+
+Chi fosse @emph{seriamente} interessato a contribuire nell'implementazione
+di un sito Internet dedicato ad argomenti riguardanti il
+linguaggio @command{awk}, @`e pregato di contattarmi.
+
address@hidden
+Nella speranza di
+fare qualcosa di address@hidden esteso, acquisii il dominio @code{awk.info}.
+
+Tuttavia, mi accorsi che non potevo dedicare abbastanza tempo per la gestione
+del codice inviato dai collaboratori: l'archivio non cresceva e il dominio
+rimase in disuso per diversi anni.
+
+Alla fine del 2008, un volontario si assunse il compito di mettere a punto
+un sito web collegato ad @address@hidden://awk.info}---e fece un
+lavoro molto ben fatto.
+
+Se qualcuno ha scritto un programma @command{awk} interessante, o un'estensione
+a @command{gawk} che vuole condividere col resto del mondo, @`e invitato a
+consultare la pagina @uref{http://awk.info/?contribute} per sapere come
+inviarlo per contribuire al sito web.
+
+Mentre scrivo, questo sito @`e in cerca di un responsabile; se qualcuno @`e
+interessato mi contatti.
address@hidden ignore
+
address@hidden
+Altri collegamenti:
+
+http://www.reddit.com/r/linux/comments/dtect/composing_music_in_awk/
address@hidden ignore
address@hidden ifclear
+
address@hidden Ringraziamenti
address@hidden Ringraziamenti
+
+La bozza iniziale di @cite{The GAWK Manual} riportava i seguenti
ringraziamenti:
+
address@hidden
+Molte persone devono essere ringraziate per la loro assistenza nella produzione
+di questo manuale. Jay Fenlason ha contribuito con molte idee e programmi di
+esempio. Richard Mlynarik e Robert Chassell hanno fatto utili osservazioni
+sulle bozze di questo manuale. Lo scritto
address@hidden Supplemental Document for AWK} di John W.@: Pierce, del
+Chemistry Department di UC San Diego, fa il punto su diverse questioni
rilevanti
+sia per l'implementazione di @command{awk} che per questo manuale, che
+altrimenti ci sarebbero sfuggite.
address@hidden quotation
+
address@hidden Stallman, Richard
+Vorrei ringraziare Richard M.@: Stallman, per la sua visione di un mondo
+migliore e per il suo coraggio nel fondare la FSF e nel dare inizio al
+Progetto GNU.
+
address@hidden FOR_PRINT
+Edizioni precedenti di questo @value{DOCUMENT} riportavano i seguenti
+ringraziamenti:
address@hidden ifclear
address@hidden FOR_PRINT
+La precedente edizione di questo @value{DOCUMENT} riportava
+i seguenti ringraziamenti:
address@hidden ifset
+
address@hidden
+Le seguenti persone (in ordine alfabetico)
+hanno inviato commenti utili riguardo alle diverse
+versioni di questo libro:
+Rick Adams,
+Dr.@: Nelson H.F. Beebe,
+Karl Berry,
+Dr.@: Michael Brennan,
+Rich Burridge,
+Claire Cloutier,
+Diane Close,
+Scott Deifik,
+Christopher (``Topher'') Eliot,
+Jeffrey Friedl,
+Dr.@: Darrel Hankerson,
+Michal Jaegermann,
+Dr.@: Richard J.@: LeBlanc,
+Michael Lijewski,
+Pat Rankin,
+Miriam Robbins,
+Mary Sheehan,
+e
+Chuck Toporek.
+
address@hidden Berry, Karl
address@hidden Chassell, Robert J.@:
address@hidden @cindex Texinfo
+Robert J.@: Chassell ha dato preziosissimi consigli
+sull'uso di Texinfo.
+Merita anche un particolare ringraziamento per avermi
+convinto a @emph{non} dare a questo @value{DOCUMENT}
+il titolo @cite{How to Gawk Politely}. [Un gioco di parole in inglese che
address@hidden
+significare sia
address@hidden usare Gawk educatamente}
+che @cite{Come curiosare educatamente}].
+Karl Berry ha aiutato in modo significativo con la parte @TeX{} di Texinfo.
+
address@hidden Hartholz, Marshall
address@hidden Hartholz, Elaine
address@hidden Schreiber, Bert
address@hidden Schreiber, Rita
+Vorrei ringraziare Marshall ed Elaine Hartholz di Seattle e il Dr.@: Bert e
Rita
+Schreiber di Detroit per i lunghi periodi di vacanza trascorsi in tutta
address@hidden in casa loro, che mi hanno permesso di fare importanti progressi
+nella scrittura di questo @value{DOCUMENT} e con lo stesso @command{gawk}.
+
address@hidden Hughes, Phil
+Phil Hughes di SSC
+ha contribuito in modo molto importante prestandomi il suo portatile col
sistema
+GNU/Linux, non una volta, ma due, il che mi ha permesso di fare tantissimo
lavoro
+mentre ero fuori casa.
+
address@hidden Trueman, David
+David Trueman merita un riconoscimento speciale; ha fatto un lavoro da
sentinella
+durante lo sviluppo di @command{gawk} affinch@'e funzioni bene e senza errori.
+Sebbene non sia address@hidden impegnato con @command{gawk},
+lavorare con lui a questo progetto @`e stato un vero piacere.
+
address@hidden Drepper, Ulrich
address@hidden GNITS mailing list
address@hidden mailing list, GNITS
+Gli intrepidi membri della lista GNITS, con una particolare menzione per Ulrich
+Drepper, hanno fornito un aiuto prezioso e commenti per il progetto
+delle address@hidden di internazionalizzazione.
+
+Chuck Toporek, Mary Sheehan, e Claire Cloutier della O'Reilly & Associates
hanno
+fornito un'assistenza editoriale rilevante per questo @value{DOCUMENT} per la
+versione 3.1 di @command{gawk}.
address@hidden quotation
+
address@hidden Beebe, Nelson H.F.@:
address@hidden Buening, Andreas
address@hidden Collado, Manuel
address@hidden Colombo, Antonio
address@hidden Davies, Stephen
address@hidden Deifik, Scott
address@hidden Demaille, Akim
address@hidden G., Daniel Richard
address@hidden Hankerson, Darrel
address@hidden Jaegermann, Michal
address@hidden Kahrs, J@"urgen
address@hidden Kasal, Stepan
address@hidden Malmberg, John E.
address@hidden Pitts, Dave
address@hidden Ramey, Chet
address@hidden Rankin, Pat
address@hidden Schorr, Andrew
address@hidden Vinschen, Corinna
address@hidden Zaretskii, Eli
+
+Dr.@: Nelson Beebe,
+Andreas Buening,
+Dr.@: Manuel Collado,
+Antonio Colombo,
+Stephen Davies,
+Scott Deifik,
+Akim Demaille,
+Daniel Richard G.,
+Darrel Hankerson,
+Michal Jaegermann,
+J@"urgen Kahrs,
+Stepan Kasal,
+John Malmberg,
+Dave Pitts,
+Chet Ramey,
+Pat Rankin,
+Andrew Schorr,
+Corinna Vinschen,
+ed Eli Zaretskii
+(in ordine alfabetico)
+costituiscono l'attuale ``gruppo di lavoro sulla address@hidden'' di
address@hidden Senza il loro duro lavoro e il loro aiuto,
address@hidden non sarebbe stato neanche lontanamente il buon programma che @`e
+oggi. @`E stato e continua a essere un piacere lavorare con questo gruppo
+di ottimi collaboratori.
+
+Notevoli contributi di codice e documentazione sono arrivati da
+parecchie persone. @xref{Contributori} per l'elenco completo.
+
address@hidden FOR_PRINT
address@hidden Oram, Andy
+Grazie ad Andy Oram della O'Reilly Media per aver iniziato
+la quarta edizione e per il suo aiuto in corso d'opera.
+Grazie a Jasmine Kwityn per il suo lavoro di revisione.
address@hidden ifset
+
+Grazie a Michael Brennan per le Prefazioni.
+
address@hidden Duman, Patrice
address@hidden Berry, Karl
+Grazie a Patrice Dumas per il nuovo programma @command{makeinfo}.
+Grazie a Karl Berry, che continua a lavorare per tenere
+aggiornato il linguaggio di marcatura Texinfo.
+
address@hidden Kernighan, Brian
address@hidden Brennan, Michael
address@hidden Day, Robert P.J.@:
+Robert P.J.@: Day, Michael Brennan e Brian Kernighan hanno gentilmente
+fatto da revisiori per l'edizione 2015 di questo @value{DOCUMENT}. Le loro
+osservazioni hanno contribuito a migliorare la stesura finale.
+
+Vorrei ringraziare Brian Kernighan per la sua preziosa assistenza durante
+la fase di collaudo e di debug di @command{gawk} e
+per l'aiuto in corso d'opera e i consigli nel chiarire diversi punti sul
+linguaggio. Non avremmo proprio fatto un address@hidden@dotless{i}} buon
lavoro su @command{gawk} e
+sulla sua documentazione senza il suo aiuto.
+
+Brian @`e un fuoriclasse sia come programmatore che come autore di manuali
+tecnici. @`E mio dovere ringraziarlo (una volta di address@hidden) per la sua
costante
+amicizia e per essere stato per me un modello da seguire ormai da quasi
+30 anni! Averlo come revisiore @`e per me un privilegio eccitante, ma @`e
+stata anche un'esperienza che mi ha fatto sentire molto address@hidden
+
address@hidden Robbins, Miriam
address@hidden Robbins, Jean
address@hidden Robbins, Harry
address@hidden D-o
+Devo ringraziare la mia meravigliosa moglie, Miriam, per la sua pazienza nel
+corso delle molte versioni di questo progetto, per la correzione delle bozze e
+per aver condiviso con me il computer.
+Vorrei ringraziare i miei genitori per il loro amore, e per la gentilezza con
cui
+mi hanno cresciuto ed educato.
+Infine, devo riconoscere la mia gratitudine a D-o, per le molte address@hidden
+che mi ha offerto, e anche per i doni che mi ha elargito, con cui trarre
+vantaggio da quelle address@hidden
address@hidden
address@hidden 2
address@hidden
+Arnold Robbins @*
+Nof Ayalon @*
+Israel @*
+Febbraio 2015
address@hidden ifnotdocbook
+
address@hidden
address@hidden @value{PART1}Il Linguaggio @command{awk}
address@hidden ifnotinfo
+
address@hidden
address@hidden Il Linguaggio @command{awk}
+
+La Parte I descrive il linguaggio @command{awk} e il programma @command{gawk}
+nel dettaglio. Inizia con le nozioni di base, e continua con tutte le
address@hidden di @command{awk}. Sono incluse anche molte, ma non tutte, le
address@hidden di @command{gawk}. Questa parte contiene i
+seguenti capitoli:
+
address@hidden @value{BULLET}
address@hidden
address@hidden iniziare}
+
address@hidden
address@hidden Gawk}
+
address@hidden
address@hidden regolari}
+
address@hidden
address@hidden file}
+
address@hidden
address@hidden
+
address@hidden
address@hidden
+
address@hidden
address@hidden e azioni}
+
address@hidden
address@hidden
+
address@hidden
address@hidden
address@hidden itemize
address@hidden ifdocbook
address@hidden Per iniziare
address@hidden Per iniziare con @command{awk}
address@hidden @cindex @dfn{script}, definizione di
address@hidden @cindex rule, definizione di
address@hidden @cindex program, definizione di
address@hidden @cindex basic function of @command{awk}
address@hidden @command{awk}, funzione di
+
+Il compito fondamentale di @command{awk} @`e quello di ricercare righe (o
+altre address@hidden di testo) in file che corrispondano a certi criteri di
ricerca.
+Quando una riga corrisponde a uno dei criteri, @command{awk} esegue su
+quella riga le azioni specificate per quel criterio. @command{awk} continua
+a elaborare righe in input in questo modo, finch@'e non raggiunge la fine delle
+righe nei file in input.
+
address@hidden @command{awk}, uso di
address@hidden linguaggi di address@hidden guidati-dai-dati/procedurali
address@hidden @command{awk}, programmi
+I programmi scritti in @command{awk} sono differenti dai programmi scritti
+nella maggior parte degli altri linguaggi,
+poich@'e i programmi @command{awk} sono @dfn{guidati dai dati} (ovvero,
+richiedono di descrivere i dati sui quali si vuole operare, e in seguito
+che cosa fare una volta che tali dati siano stati individuati).
+La maggior parte degli altri linguaggi sono @dfn{procedurali}; si deve
+descrivere, in maniera molto dettagliata, ogni passo che il programma
+deve eseguire. Lavorando con linguaggi procedurali, solitamente @`e
+molto address@hidden difficile descrivere chiaramente i dati che il programma
+deve elaborare.
+Per questa ragione i programmi @command{awk} sono spesso piacevolmente
+facili da leggere e da scrivere.
+
address@hidden programma, definizione di
address@hidden regola, definizione di
+Quando si esegue @command{awk}, va specificato un
address@hidden @command{awk} che
+dice ad @command{awk} cosa fare. Il programma consiste di una serie di
address@hidden (address@hidden anche contenere @dfn{definizioni di funzioni},
+una address@hidden avanzata che per ora ignoreremo;
address@hidden definite dall'utente}). Ogni regola specifica un
+criterio di ricerca e un'azione da effettuare
+una volta che viene trovato un record corrispondente.
+
+Sintatticamente, una regola consiste in un @dfn{criterio di ricerca}, seguito
+da una @dfn{azione}.
+L'azione @`e racchiusa tra parentesi graffe per separarla dal criterio di
+ricerca.
+Per separare regole, basta andare a capo. Quindi un programma
address@hidden ha una struttura simile a questa:
+
address@hidden
address@hidden @{ @var{azione} @}
address@hidden @{ @var{azione} @}
address@hidden
address@hidden example
+
address@hidden
+* Eseguire gawk:: Come iniziare a eseguire programmi
+ @command{gawk}; comprende la sintassi
+ della riga di comando.
+* File dati di esempio:: File di dati di esempio da usare nei
+ programmi @command{awk} illustrati in
+ questo @value{DOCUMENT}.
+* Molto semplice:: Un esempio molto semplice.
+* Due regole:: Un esempio meno semplice di programma
+ di una riga, che usa due regole.
+* Maggiore sofisticazione:: Un esempio address@hidden complesso.
+* Istruzioni/Righe:: Suddividere o riunire istruzioni
+ su [una o address@hidden righe.
+* Altre address@hidden:: Altre address@hidden di @command{awk}.
+* Quando:: Quando usare @command{gawk} e quando
+ usare altre cose.
+* Sommario dell'introduzione:: Sommario dell'introduzione.
address@hidden menu
+
address@hidden Eseguire gawk
address@hidden Come iniziare a eseguire programmi @command{gawk}
+
address@hidden programmi @command{awk}, eseguire
+Ci sono vari modi di eseguire un programma @command{awk}. Se il programma @`e
+corto, @`e address@hidden facile includerlo nel comando con cui si invoca
@command{awk},
address@hidden@dotless{i}}:
+
address@hidden
+awk '@var{programma}' @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden riga di comando, formati
+Quando il programma @`e lungo, di solito @`e meglio metterlo in un file
+ed eseguirlo con un comando come questo:
+
address@hidden
+awk -f @var{file-di-programma} @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden si occupa di entrambe queste address@hidden insieme
+a parecchie varianti di ciascuna di esse.
+
address@hidden
+* Monouso:: Eseguire un breve programma
+ @command{awk} di tipo usa-e-getta.
+* Leggere dal terminale:: Senza uso di file in input (input
+ immesso da tastiera).
+* Lunghi:: Mettere programmi @command{awk}
+ permanenti in file.
+* @dfn{Script} eseguibili:: Preparare programmi @command{awk}
+ da eseguire come @dfn{script}.
+* Commenti:: Aggiungere documentazione a programmi
+ @command{gawk}.
+* Protezione:: Ulteriore discussione di problemi
+ connessi all'uso di apici nella shell.
address@hidden menu
+
address@hidden Monouso
address@hidden Eseguire un breve programma @command{awk} usa-e-getta
+
+Una volta acquisita address@hidden con @command{awk}, address@hidden spesso di
+preparare semplici
+programmi nel momento in cui servono. In questo caso si address@hidden
scrivere
+il programma come primo argomento del comando @command{awk},
address@hidden@dotless{i}}:
+
address@hidden
+awk '@var{programma}' @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden
+dove @var{programma} consiste in una serie di criteri di ricerca e di
+azioni, come descritto precedentemente.
+
address@hidden apice singolo (@code{'})
address@hidden @code{'} (apice singolo)
+Questo formato di comando chiede alla @dfn{shell}, ossia all'interpretatore
+dei comandi, di richiamare @command{awk} e di usare il @var{programma} per
+trattare record nei file in input.
+Il @var{programma} @`e incluso tra apici in modo che
+la shell non interpreti qualche carattere destinato ad @command{awk} come
+carattere speciale
+della shell. Gli apici fanno inoltre address@hidden@dotless{i}} che la shell
tratti tutto il
address@hidden come un solo argomento per @command{awk}, e permettono che
address@hidden sia address@hidden lungo di una riga.
+
address@hidden shell, @dfn{script}
address@hidden programmi @command{awk}, eseguire, da @dfn{script} di shell
+Questo formato @`e utile anche per eseguire programmi @command{awk} di
+dimensioni piccole o medie da @dfn{script} di shell, perch@'e non richiede
+un file separato che contenga il programma @command{awk}. Uno @dfn{script}
+di shell @`e address@hidden affidabile, perch@'e non ci sono altri file che
possono
+venirsi a trovare fuori posto.
+
address@hidden avanti in questo capitolo,
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden
address@hidden
address@hidden ifdocbook
address@hidden semplice},
+si vedranno esempi di parecchi programmi,
+brevi, scritti sulla riga di comando.
+
address@hidden Leggere dal terminale
address@hidden Senza uso di file in input (input immesso da tastiera)
+
address@hidden standard input
address@hidden input, standard
address@hidden file in input, eseguire @command{awk} senza usarli
+Si address@hidden anche eseguire @command{awk} senza indicare alcun file in
input. Se
+si immette la seguente riga di comando:
+
address@hidden
+awk '@var{programma}'
address@hidden example
+
address@hidden
address@hidden prende come input del @var{programma} lo @dfn{standard input},
+che di solito significa qualsiasi cosa venga immesso dalla tastiera.
address@hidden prosegue finch@'e non si segnala una fine-file battendo
@kbd{Ctrl-d}.
+(In sistemi operativi non-POSIX, il carattere di fine-file address@hidden
essere diverso.)
+
address@hidden input, file in, si veda file in input
address@hidden file in input, eseguire @command{awk} senza usarli
address@hidden programmi @command{awk}, eseguire, senza file in input
+Per esempio, il seguente programma stampa un consiglio da amico
+(dalla @cite{Guida galattica per gli autostoppisti} di Douglas Adams ),
+per non lasciarsi spaventare dalle address@hidden della programmazione per
+computer:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Non v\47allarmate!" @}'}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden esegue le istruzioni associate a @code{BEGIN} prima di leggere
+qualsiasi input. Se non ci sono altre istruzioni nel proprio programma, come
+in questo caso, @command{awk} si ferma, invece di tentare di leggere input che
+non sa come elaborare.
+Il @samp{\47} @`e un modo straordinario (spiegato address@hidden avanti) per
inserire un
+apice singolo nel programma, senza dover ricorrere a fastidiosi meccanismi
+di protezione della shell.
+
address@hidden NOTA
+Se si usa Bash come shell, si dovrebbe digitare il comando @samp{set +H} prima
+eseguire questo programma interattivamente, per non avere una cronologia dei
+comandi nello stile della C shell, che tratta il @samp{!} come un carattere
+speciale. Si raccomanda di inserire quel comando nel proprio file di
+personalizzazione della shell.
address@hidden quotation
+
+Il seguente semplice programma @command{awk}
+emula il comando @command{cat}; ovvero copia qualsiasi cosa si
+batta sulla tastiera nel suo standard output (perch@'e succede @`e spiegato fra
+poco):
+
address@hidden
+$ @kbd{awk '@{ print @}'}
address@hidden @`e il tempo per tutti gli uomini buoni}
address@hidden Ora @`e il tempo per tutti gli uomini buoni
address@hidden venire in aiuto al loro paese.}
address@hidden di venire in aiuto al loro paese.
address@hidden sono sedici lustri e sette anni, ...}
address@hidden Or sono sedici lustri e sette anni, ...
address@hidden, io preoccupato?}
address@hidden Cosa, io preoccupato?
address@hidden
address@hidden example
+
address@hidden Lunghi
address@hidden Eseguire programmi lunghi
+
address@hidden programmi @command{awk}, eseguire
address@hidden programmi @command{awk}, lunghi
address@hidden file, programmi @command{awk} in
+Talora i programmi @command{awk} sono molto lunghi. In tali situazioni
+conviene mettere il programma in un file separato. Per dire ad
address@hidden di usare quel file come programma, digitare:
+
address@hidden
+awk -f @var{file-sorgente} @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden @option{-f}, opzione
address@hidden riga di comando, opzione @option{-f}
+L'opzione @option{-f} dice al comando @command{awk} di ottenere il programma
address@hidden dal file @var{file-sorgente} (@pxref{Opzioni}).
+Ogni @value{FN} address@hidden essere usato come @var{file-sorgente}. Per
esempio, si
+potrebbe mettere il programma:
+
address@hidden
+BEGIN @{ print \"Non v'allarmate!\" @}
address@hidden example
+
address@hidden
+nel file @file{consiglio}. Allora questo comando:
+
address@hidden
+awk -f consiglio
address@hidden example
+
address@hidden
address@hidden equivalente al comando:
+
address@hidden
+awk 'BEGIN @{ print \"Non v\47allarmate!\" @}'
address@hidden example
+
address@hidden protezione, nella riga di comando di @command{gawk}
address@hidden
+Questo @`e address@hidden stato spiegato prima
+(@pxref{Leggere dal terminale}).
+Si noti che normalmente non serve mettere apici singoli nel @value{FN} che si
+fornisce con @option{-f}, perch@'e di solito i @value{FNS} non contengono
+caratteri che sono speciali per la shell. Si noti che in @file{consiglio},
+il programma @command{awk} non ha dei doppi apici che lo delimitano. I
+doppi apici sono necessari solo per programmi scritti direttamente sulla riga
+di comando di @command{awk}.
+(Inoltre, se il programma si trova in un file, @`e possibile usare un apice
+singolo all'interno del programma, invece del magico @samp{\47}.)
+
address@hidden apice singolo (@code{'}), nella riga di comando di @command{gawk}
address@hidden @code{'} (apice singolo), nella riga di comando di @command{gawk}
+Per identificare chiaramente un file di programma @command{awk} come tale,
+si address@hidden aggiungere il suffisso @file{.awk} al @value{FN}.
address@hidden non
+cambia l'esecuzione del programma @command{awk} ma semplifica
+la ``manutenzione''.
+
address@hidden @dfn{Script} eseguibili
address@hidden Programmi @command{awk} da eseguire come @dfn{script}
address@hidden programmi @command{awk}
address@hidden @code{#} (cancelletto), @code{#!} (@dfn{script} eseguibili)
address@hidden Unix, @dfn{script} @command{awk} e
address@hidden cancelletto (@code{#}), @code{#!} (@dfn{script} eseguibili)
+
+Una volta familiarizzato con @command{awk}, si potrebbero scrivere
address@hidden che richiamano @command{awk}, usando il meccanismo di
address@hidden @samp{#!}. address@hidden @`e
+possibile in molti sistemi address@hidden meccanismo @samp{#!}
+funziona nei sistemi
+GNU/Linux, in quelli basati su BSD e nei sistemi Unix a pagamento.}
+Per esempio, si potrebbe modificare il file @file{consiglio} e farlo divenire:
+
address@hidden
+#! /bin/awk -f
+
+BEGIN @{ print \"Non v'allarmate!\" @}
address@hidden example
+
address@hidden
+Dopo aver reso eseguibile questo file (con il comando @command{chmod}),
+digitare semplicemente @samp{consiglio}
+al prompt della shell e il sistema si address@hidden a eseguire @command{awk}
+come se si fosse digitato @samp{awk -f consiglio}:
+
address@hidden
+$ @kbd{chmod +x consiglio}
+$ @kbd{consiglio}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden
+(Si suppone che la directory corrente sia tra quelle contenute nella variabile
+che indica il "percorso" di ricerca [solitamente @code{$PATH}]. In caso
+contrario si potrebbe aver bisogno di digitare @samp{./consiglio} nella
+shell.)
+
address@hidden @command{awk} autocontenuti sono utili se si vuol scrivere un
+programma che gli utenti possono richiamare senza dover essere informati che
+il programma @`e scritto in @command{awk}.
+
address@hidden sidebar, Comprendere @samp{#!}
address@hidden
address@hidden
+<sidebar><title>Comprendere @samp{#!}</title>
address@hidden docbook
+
address@hidden address@hidden, @code{#!} (@dfn{script} eseguibili)
+
address@hidden @`e un linguaggio @dfn{interpretato}. address@hidden significa
che il
+comando @command{awk} legge il programma dell'utente e poi elabora i dati
+secondo le istruzioni contenute nel programma (diversamente da un linguaggio
address@hidden come il C, dove il programma viene prima compilato in codice
+macchina che @`e eseguito direttamente dal processore del sistema). Il
+programma di address@hidden @command{awk} @`e address@hidden chiamato
@dfn{interpretatore}.
+Molti linguaggi moderni sono interpretati.
+
+La riga che inizia con @samp{#!} lista l'intero @value{FN} di un
+interpretatore
+da richiamare, con degli argomenti facoltativi che saranno passati a
+quell'interpretatore sulla riga di comando. Il sistema operativo quindi
+richiama l'interpretatore con gli argomenti dati e con l'intera lista di
+argomenti con cui era stato invocato il programma. Il primo argomento nella
+lista @`e l'intero @value{FN} del programma @command{awk}. Il resto della
lista
+degli argomenti contiene opzioni per @command{awk}, oppure @value{DF}, o
+entrambi. (Si noti che in molti sistemi @command{awk} address@hidden essere
trovato in
address@hidden/usr/bin} invece che in @file{/bin}.)
+
+Alcuni sistemi limitano la lunghezza del nome del programma interpretarore a
+32 caratteri. Spesso, si address@hidden rimediare utilizzando un collegamento
simbolico.
+
+Non si dovrebbero mettere altri argomenti oltre al primo nella riga @samp{#!}
+dopo il percorso del comando @command{awk}. Non funziona. Il sistema
+operativo tratta il resto della riga come un argomento solo, e lo passa ad
address@hidden
address@hidden@dotless{i}} facendo il comportamento address@hidden poco chiaro;
con ogni address@hidden un
+messaggio di errore di qualche tipo da @command{awk}.
+
address@hidden variabili @code{ARGC}/@code{ARGV}, address@hidden e
address@hidden address@hidden, variabile @code{ARGV}
+Infine, il valore di @code{ARGV[0]}
+(@pxref{Variabili predefinite})
address@hidden variare a seconda del sistema operativo.
+Alcuni sistemi ci mettono @samp{awk}, altri il nome completo del percorso
+di @command{awk} (ad. es. @file{/bin/awk}), e altri ancora mettono il nome
+dello @dfn{script} dell'utente (@samp{consiglio}). @value{DARKCORNER}
+Non bisogna fidarsi del valore di @code{ARGV[0]}
+per ottenere il nome del proprio @dfn{script}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Comprendere @samp{#!}}
+
+
address@hidden address@hidden, @code{#!} (@dfn{script} eseguibili)
+
address@hidden @`e un linguaggio @dfn{interpretato}. address@hidden significa
che il
+comando @command{awk} legge il programma dell'utente e poi elabora i dati
+secondo le istruzioni contenute nel programma (diversamente da un linguaggio
address@hidden come il C, dove il programma viene prima compilato in codice
+macchina che @`e eseguito direttamente dal processore del sistema). Il
+programma di address@hidden @command{awk} @`e address@hidden chiamato
@dfn{interpretatore}.
+Molti linguaggi moderni sono interpretati.
+
+La riga che inizia con @samp{#!} lista l'intero @value{FN} di un
+interpretatore
+da richiamare, con degli argomenti facoltativi che saranno passati a
+quell'interpretatore sulla riga di comando. Il sistema operativo quindi
+richiama l'interpretatore con gli argomenti dati e con l'intera lista di
+argomenti con cui era stato invocato il programma. Il primo argomento nella
+lista @`e l'intero @value{FN} del programma @command{awk}. Il resto della
lista
+degli argomenti contiene opzioni per @command{awk}, oppure @value{DF}, o
+entrambi. (Si noti che in molti sistemi @command{awk} address@hidden essere
trovato in
address@hidden/usr/bin} invece che in @file{/bin}.)
+
+Alcuni sistemi limitano la lunghezza del nome del programma interpretarore a
+32 caratteri. Spesso, si address@hidden rimediare utilizzando un collegamento
simbolico.
+
+Non si dovrebbero mettere altri argomenti oltre al primo nella riga @samp{#!}
+dopo il percorso del comando @command{awk}. Non funziona. Il sistema
+operativo tratta il resto della riga come un argomento solo, e lo passa ad
address@hidden
address@hidden@dotless{i}} facendo il comportamento address@hidden poco chiaro;
con ogni address@hidden un
+messaggio di errore di qualche tipo da @command{awk}.
+
address@hidden variabili @code{ARGC}/@code{ARGV}, address@hidden e
address@hidden address@hidden, variabile @code{ARGV}
+Infine, il valore di @code{ARGV[0]}
+(@pxref{Variabili predefinite})
address@hidden variare a seconda del sistema operativo.
+Alcuni sistemi ci mettono @samp{awk}, altri il nome completo del percorso
+di @command{awk} (ad. es. @file{/bin/awk}), e altri ancora mettono il nome
+dello @dfn{script} dell'utente (@samp{consiglio}). @value{DARKCORNER}
+Non bisogna fidarsi del valore di @code{ARGV[0]}
+per ottenere il nome del proprio @dfn{script}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Commenti
address@hidden Documentare programmi @command{gawk}.
address@hidden @code{#} (cancelletto), commentare
address@hidden cancelletto (@code{#}), commentare
address@hidden commentare
address@hidden programmi @command{awk}, documentazione
+
+Un @dfn{commento} @`e del testo incluso in un programma per aiutare le
+persone che lo leggeranno; non @`e parte del programma eseguibile vero e
+proprio. I commenti possono spiegare cosa fa il programma e come funziona.
+Quasi tutti i linguaggi di programmazione possono contenere commenti, poich@'e
+i programmi sono solitamente difficili da comprendere senza di essi.
+
+Nel linguaggio @command{awk}, un commento inizia con il segno del
+cancelletto (@samp{#}) e continua fino alla fine della riga.
+Il @samp{#} non deve necessariamente essere il primo carattere della riga.
+Il linguaggio @command{awk} ignora il resto di una riga dopo il carattere
+cancelletto.
+Per esempio, potremmo mettere quel che segue in @file{consiglio}:
+
address@hidden
+# Questo programma stampa uno scherzoso consiglio amichevole.
+# Aiuta a far passare la paura del computer agli utenti novelli.
+BEGIN @{ print "Non v'allarmate!" @}
address@hidden example
+
+Si possono mettere dei commenti nei programmi @command{awk} usa-e-getta da
+digitare direttamente da tastiera, ma address@hidden solitmanete non serve
molto; il
+fine di un commento @`e di aiutare l'utente o qualcun altro a comprendere il
+programma, quando lo rilegge in un secondo tempo.
+
address@hidden protezione, per piccoli programmi awk
address@hidden apice singolo (@code{'}), vs.@: apostrofo
address@hidden @code{'} (apice singolo), vs.@: apostrofo
address@hidden ATTENZIONE
+Come detto in
address@hidden,
+si possono includere programmi di dimensioni da piccole a medie tra apici
+singoli, per mantenere compatti i propri @dfn{script} di shell
+autocontenuti. Nel far questo, @emph{non} bisogna inserire un apostrofo
+(ossia un apice singolo) in un commento, (o in qualsiasi altra parte del
+vostro programma). La shell interpreta gli apici singoli come delimitatori
+di chiusura dell'intero programma. Di conseguenza, solitamente la shell
+emette un messaggio riguardo ad apici presenti in numero dispari, e se
address@hidden viene comunque eseguito, @`e probabile che stampi strani
+messaggi di errori di sintassi.
+Per esempio, nel caso seguente:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Ciao" @} # un'idea brillante'}
+>
address@hidden example
+
+La shell considera il secondo apice singolo come delimitatore del testo
+precedente, e trova che un nuovo testo tra apici ha inizio verso la fine
+della riga di comando. A causa di address@hidden emette una richiesta
secondaria di
+input, e si mette in attesa di ulteriore input.
+Con il comando @command{awk} Unix, se si chiude l'ulteriore stringa tra
+apici singoli il risultato @`e il seguente:
+
address@hidden
+$ @kbd{awk '@{ print "Ciao" @} # un'idea brillante'}
+> @kbd{'}
address@hidden awk: fatale: non riesco ad aprire file `brillante'
address@hidden in lettura (File o directory non esistente)
address@hidden example
+
address@hidden @code{\} (barra inversa)
address@hidden barra inversa (@code{\})
+Mettere una barra inversa prima dell'apice singolo in @samp{un'idea} non
+risolverebbe, poich@'e le barre inverse non sono speciali all'interno di apici
+singoli.
+La prossima @value{SUBSECTION} descrive le regole di protezione della shell.
address@hidden quotation
+
address@hidden Protezione
address@hidden Uso di apici nella shell.
address@hidden shell, uso di apici, regole per
+
address@hidden
+* Doppi apici in DOS:: Passaggio di apici in file .BAT Windows.
address@hidden menu
+
+Per programmi @command{awk} di lunghezza da corta a media spesso conviene
+digitare il programma sulla riga di comando @command{awk}.
+La maniera migliore per farlo @`e racchiudere l'intero programma tra apici
+singoli.
+Questo vale sia che si digiti il programma interattivamente su
+richiesta della shell, sia che lo si scriva come parte di uno @dfn{script}
+di shell di maggiori dimensioni:
+
address@hidden
+awk '@var{testo del programma}' @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden shell, uso di apici, regole per
address@hidden Bourne shell, uso di apici, regole per la
+Quando si lavora con la shell, non guasta avere una conoscenza
+di base sulle regole per l'uso di apici nella shell. Le regole
+seguenti valgono solo per shell in stile Bourne (come Bash, la
+Bourne-Again shell). Se si usa la C shell, si avranno regole differenti.
+
+Prima di immergerci nelle regole, introduciamo un concetto che ricorre
+in tutto questo @value{DOCUMENT}, che @`e quello della stringa @dfn{null},
+o vuota.
+
+La stringa nulla @`e una variabile, di tipo carattere, che non ha un valore.
+In altre parole, @`e vuota. Nei programmi @command{awk} si scrive
address@hidden@dotless{i}}:
address@hidden""}. Nella shell la si address@hidden scrivere usando apici sia
singoli
+che doppi: @code{""} oppure @code{''}. Sebbena la stringa nulla non contenga
+alcun carattere, essa esiste lo stesso. Si consideri questo comando:
+
address@hidden
+$ @kbd{echo ""}
address@hidden example
+
address@hidden
+Qui, il comando @command{echo} riceve un solo argomento, anche se
+quell'argomento non contiene alcun carattere. Nel resto di questo
address@hidden, usiamo indifferentemente i termini @dfn{stringa nulla}
+e @dfn{stringa vuota}. Ora, proseguiamo con le regole relative agli apici:
+
+
address@hidden @value{BULLET}
address@hidden
+Elementi tra apici possono essere concatenati con elementi non tra apici.
+La shell converte il tutto in un singolo argomento da passare
+al comando.
+
address@hidden
+Mettere una barra inversa (@samp{\}) prima di qualsiasi singolo carattere
+lo protegge. La shell toglie la barra inversa e passa il carattere
+protetto al comando.
+
address@hidden
address@hidden @code{\} (barra inversa), nei comandi di shell
address@hidden barra inversa (@code{\}), nei comandi di shell
address@hidden apice singolo (@code{'}), nei comandi di shell
address@hidden @code{'} (apice singolo), nei comandi di shell
+Gli apici singoli proteggono qualsiasi cosa sia inclusa tra un apice di
+apertura e uno di chiusura.
+La shell non interpreta il testo protetto, il quale viene passato
address@hidden@dotless{i}} com'@`e
+al comando.
address@hidden @emph{impossibile} inserire un apice singolo in un testo
racchiuso fra
+apici singoli. Potete trovare in
address@hidden
+un esempio di cosa succede se si prova a farlo.
+
address@hidden
address@hidden doppio apice (@code{"}), nei comandi shell
address@hidden @code{"} (doppio apice), nei comandi shell
+I doppi apici proteggono la maggior parte di quel che @`e racchiuso tra i
+doppi apici di apertura e quelli di chiusura.
+La shell effettua almeno la sostituzione di variabili e di comandi
+sul testo racchiuso tra doppi apici.
+Shell differenti possono fare ulteriori tipi di elaborazione
+sul testo racchiuso tra doppi apici.
+
+Poich@'e alcuni caratteri all'interno di un testo racchiuso tra doppi apici
+sono interpretati dalla shell, essi devono essere @dfn{protetti} all'interno
+del testo stesso. Sono da tener presenti i caratteri
address@hidden, @samp{`}, @samp{\}, e @samp{"}, tutti i quali devono essere
+preceduti da una barra inversa quando ricorrono all'interno di un testo
+racchiuso tra doppi apici, per poter essere passati letteralmente al
+programma. (La barra inversa viene tolta prima del passaggio al programma.)
+Quindi, l'esempio visto
address@hidden
+precedentemente
address@hidden ifnotinfo
+in @ref{Leggere dal terminale}:
+
address@hidden
+awk 'BEGIN @{ print "Non v\47allarmate!" @}'
address@hidden example
+
address@hidden
+si potrebbe scrivere invece address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{awk "BEGIN @{ print \"Non v'allarmate!\" @}"}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden apice singolo (@code{'}), con doppio apice
address@hidden @code{'} (apice singolo), con doppio apice
+Va notato che l'apice singolo non @`e speciale all'interno di un testo
+racchiuso tra doppi apici.
+
address@hidden
+Le stringhe nulle sono rimosse se presenti come parte di un argomento
+non-nullo sulla riga di comando, mentre oggetti esplicitamente nulli
+sono mantenuti come tali.
+Per esempio, per richiedere che il separatore di campo @code{FS} sia
+impostato alla stringa nulla, digitare:
+
address@hidden
+awk -F "" '@var{programma}' @var{file} # corretto
address@hidden example
+
address@hidden
address@hidden stringa nulla come argomento a @command{gawk}, protezione della
+Non @`e invece da usare:
+
address@hidden
+awk -F"" '@var{programma}' @var{file} # errato!
address@hidden example
+
address@hidden
+Nel secondo caso, @command{awk} tenta di usare il nome del programma come
+valore di @code{FS}, e il primo @value{FN} come testo del programma!
address@hidden come minimo genera un errore di sintassi, e un comportamento
confuso nel
+caso peggiore.
address@hidden itemize
+
address@hidden protezione, nella riga di comando di @command{gawk}, trucchi per
+Mischiare apici singoli e doppi @`e difficile. Occorre utilizzare
+trucchi della shell per gli apici, come questi:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un apice singolo. <'"'"'>" @}'}
address@hidden Questo @`e un apice singolo. <'>
address@hidden example
+
address@hidden
+Questo programma stampa tre stringhe tra apici concatenate tra loro.
+La prima e la terza sono rinchiuse tra apici singoli, la seconda tra apici
+doppi.
+
+Quanto sopra address@hidden essere ``semplificato'' address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un apice singolo <'\''>" @}'}
address@hidden Questo @`e un apice singolo <'>
address@hidden example
+
address@hidden
+A voi la scelta del address@hidden leggibile dei due.
+
+Un'altra opzione @`e quella di usare doppi apici, proteggendo i doppi apici
+inclusi, a livello @command{awk}:
+
address@hidden
+$ @kbd{awk "BEGIN @{ print \"Questo @`e un apice singolo <'>\" @}"}
address@hidden Questo @`e un apice singolo <'>
address@hidden example
+
address@hidden
+Quest'opzione @`e fastidiosa anche perch@'e il doppio apice, la barra inversa e
+il simbolo del dollaro sono molto comuni nei programmi @command{awk}
address@hidden
+avanzati.
+
+Una terza opzione @`e quella di usare le sequenze ottali equivalenti
+(@pxref{Sequenze di protezione})
+per i caratteri
+apice singolo e doppio, address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un apice singolo <\47>" @}'}
address@hidden Questo @`e un apice singolo <'>
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un doppio apice <\42>" @}'}
address@hidden Questo @`e un doppio apice <">
address@hidden example
+
address@hidden
+Questo funziona bene, ma sai dovrebbe commentare chiaramente quel che
+il testo protetto significa.
+
+Una quarta address@hidden @`e di usare assegnamenti di variabili sulla riga di
+comando, address@hidden@dotless{i}}:
+
address@hidden
address@hidden awk -v sq="'" 'BEGIN @{ print "Questo @`e un apice singolo <" sq
">" @}'}
address@hidden Questo @`e un apice singolo <'>
address@hidden example
+
+(Qui, le due stringhe costanti e il valore di @code{sq} sono concatenati in
+un'unica stringa che @`e stampata da @code{print}.)
+
+Se servono veramente sia gli apici singoli che quelli doppi nel proprio
+programma @command{awk}, @`e probabilmente meglio tenerlo in un file separato,
+dove la shell non interferisce, e si address@hidden scrivere quello che si
vuole.
+
address@hidden Doppi apici in DOS
address@hidden Doppi apici in file .BAT Windows
+
address@hidden
+Date: Wed, 21 May 2008 09:58:43 +0200 (CEST)
+From: address@hidden
+Subject: (g)awk "contribution"
+To: address@hidden
+Message-id: <address@hidden>
+
+Hello Arnold,
+
+maybe you can help me out. Found your email on the GNU/awk online manual
+pages.
+
+I've searched hard to figure out how, on Windows, to print double quotes.
+Couldn't find it in the Quotes area, nor on google or elsewhere. Finally i
+figured out how to do this myself.
+
+How to print all lines in a file surrounded by double quotes (on Windows):
+
+gawk "{ print \"\042\" $0 \"\042\" }" <file>
+
+Maybe this is a helpfull tip for other (Windows) gawk users. However, i
+don't have a clue as to where to "publish" this tip! Do you?
+
+Kind regards,
+
+Jeroen Brink
address@hidden ignore
+
+Sebbene questo @value{DOCUMENT} in generale si preoccupi solo di sistemi POSIX
+e della shell POSIX, il problema che stiamo per vedere emerge abbastanza
+spesso presso parecchi utenti, e per questo ne parliamo.
+
address@hidden Brink, Jeroen
+Le ``shell'' nei sistemi Microsoft Windows usaso il carattere doppio apice
+per protezione, e rendono difficile o impossibile inserire un carattere
+doppio apice in uno @dfn{script} scritto su una riga di comando.
+l'esempio che segue, per il quale ringraziamo Jeroen Brink, mostra come
+stampare tutte le righe di un file, racchiudendole tra doppi apici:
+
address@hidden
+gawk "@{ print \"\042\" $0 \"\042\" @}" @var{file}
address@hidden example
+
+
address@hidden File dati di esempio
address@hidden @value{DDF} per gli esempi
+
address@hidden input file, esempi
address@hidden file di @code{mail-list}
+Molti degli esempi in questo @value{DOCUMENT} hanno come input due @value{DF}
+di esempio. Il primo, @file{mail-list}, contiene una lista di nomi di
+persone, insieme ai loro indirizzi email e a informazioni riguardanti le
+persone stesse.
+Il secondo @value{DF}, di nome @file{inventory-shipped}, contiene
+informazioni riguardo a consegne mensili. In entrambi i file,
+ogni riga @`e considerata come un @dfn{record}.
+
+Nel @file{mail-list}, ogni record contiene il nome di una persona,
+il suo numero di telefono, il suo indirizzo email, e un codice che indica
+la sua relazione con l'autore della lista.
+Le colonne sono allineate usando degli spazi.
+Una @samp{A} nell'ultima colonna indica che quella persona @`e un conoscente
+[Acquaintance]. Una @samp{F} nell'ultima colonna significa che quella
+persona @`e un amico [Friend]. Una @samp{R} vuol dire che quella persona @`e
+un parente [Relative]:
+
address@hidden
address@hidden system if test ! -d eg ; then mkdir eg ; fi
address@hidden system if test ! -d eg/lib ; then mkdir eg/lib ; fi
address@hidden system if test ! -d eg/data ; then mkdir eg/data ; fi
address@hidden system if test ! -d eg/prog ; then mkdir eg/prog ; fi
address@hidden system if test ! -d eg/misc ; then mkdir eg/misc ; fi
address@hidden file eg/data/mail-list
+Amelia 555-5553 amelia.zodiacusque@@gmail.com F
+Anthony 555-3412 anthony.asserturo@@hotmail.com A
+Becky 555-7685 becky.algebrarum@@gmail.com A
+Bill 555-1675 bill.drowning@@hotmail.com A
+Broderick 555-0542 broderick.aliquotiens@@yahoo.com R
+Camilla 555-2912 camilla.infusarum@@skynet.be R
+Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
+Julie 555-6699 julie.perscrutabor@@skeeve.com F
+Martin 555-6480 martin.codicibus@@hotmail.com A
+Samuel 555-3430 samuel.lanceolis@@shu.edu A
+Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden endfile
address@hidden example
+
address@hidden file @code{inventory-shipped}
+Il @value{DF} @file{inventory-shipped} contiene
+informazioni sulle consegne effettuate durante l'anno.
+Ogni record contiene il mese, il numero di contenitori verdi spediti,
+il numero di scatole rosse spedite, il numero di borse arancione spedite,
+e il numero di pacchetti blu spediti, in quest'ordine.
+Ci sono 16 record, relativi ai dodici mesi dello scorso anno e ai primi
+quattro mesi dell'anno in corso.
+Una riga vuota separa i data relativi a ciascun anno:
+
address@hidden
address@hidden file eg/data/inventory-shipped
+Jan 13 25 15 115
+Feb 15 32 24 226
+Mar 15 24 34 228
+Apr 31 52 63 420
+May 16 34 29 208
+Jun 31 42 75 492
+Jul 24 34 67 436
+Aug 15 34 47 316
+Sep 13 55 37 277
+Oct 29 54 68 525
+Nov 20 87 82 577
+Dec 17 35 61 401
+
+Jan 21 36 64 620
+Feb 26 58 80 652
+Mar 24 75 70 495
+Apr 21 70 74 514
address@hidden endfile
address@hidden example
+
+Questi file di esempio sono inclusi nella distribuzione @command{gawk},
+nella directory @file{awklib/eg/data}.
+
address@hidden Molto semplice
address@hidden Alcuni esempi molto semplici
+
+I seguenti comandi eseguono un semplice programma @command{awk} che cerca
+nel file in input @file{mail-list} la stringa di caratteri @samp{li} (una
+sequenza di caratteri @`e solitamente chiamato una @dfn{stringa};
+il termine @dfn{stringa} @`e basato su un uso linguistico, del tipo
+``una stringa di perle'' o ``una stringa di luci decorative''):
+
address@hidden
+awk '/li/ @{ print $0 @}' mail-list
address@hidden example
+
address@hidden
+Quando si incontra una riga che contiene @samp{li}, la si stampa, perch@'e
address@hidden@samp{print $0}} significa "stampa la riga corrente". (Lo
scrivere solo
address@hidden ha lo stesso significato, quindi avremmo anche potuto
+limitarci a fare address@hidden@dotless{i}}).
+
+Si address@hidden notato che delle barre (@samp{/}) delimitano la stringa
@samp{li}
+nel programma @command{awk}. Le barre indicano che @samp{li} @`e il
+modello da ricercare. Questo tipo di notazione @`e definita come
address@hidden regolare}, e address@hidden trattata address@hidden avanti in
maggior dettaglio
address@hidden
+(@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}).
address@hidden ifnottex
+Il modello address@hidden corrispondere anche solo a una parte di una parola.
+Ci sono
+apici singoli che racchiudono il programma @command{awk} in modo che la
+shell non interpreti alcuna parte di esso come un carattere speciale della
+shell.
+
+Questo @`e quello che il programma stampa:
+
address@hidden
+$ @kbd{awk '/li/ @{ print $0 @}' mail-list}
address@hidden Amelia 555-5553 amelia.zodiacusque@@gmail.com F
address@hidden Broderick 555-0542 broderick.aliquotiens@@yahoo.com R
address@hidden Julie 555-6699 julie.perscrutabor@@skeeve.com F
address@hidden Samuel 555-3430 samuel.lanceolis@@shu.edu A
address@hidden example
+
address@hidden azioni, default
address@hidden criteri di ricerca, default
+In una regola @command{awk}, il criterio di selezione o l'azione possono
+essere omessi, ma non entrambi. Se il criterio @`e omesso, l'azione viene
+applicata a @emph{ogni} riga dell'input.
+Se l'azione viene omessa, per default si stampano tutte le righe che
+sono individuate dal criterio di selezione.
+
address@hidden azioni, omesse
+Quindi, si potrebbe omettere l'azione (l'istruzione @code{print} e le
+graffe) nell'esempio precedente e il risultato sarebbe lo stesso:
address@hidden stampa tutte le righe che corrispondono al criterio di
+ricerca @samp{li}. Per confronto, omettendo l'istruzione @code{print} ma
+lasciando le graffe si richiede un'azione nulla, che non fa nulla
(address@hidden non
+stampa alcuna riga).
+
address@hidden programmi @command{awk}, esempi molto corti
+Molti programmi @command{awk} pratici sono lunghi solo una o due righe.
+Qui sotto troviamo una collezione di programmi utili e corti, per iniziare.
+Alcuni di questi programmi contengono elementi del linguaggio che non sono
+ancora stati spiegati. (La descrizione del programma fornisce una buona
+idea di quel che si vuole ottenere, ma occorre leggere il resto del
address@hidden per divenire esperti in @command{awk}!)
+Molti degli esempi usano un @value{DF} di nome @file{data}. Questo serve solo
+a indicare la posizione del nome; se questi programmi devono venir usati per
+se stessi, sostituire i propri @value{FNS} al posto di @file{data}.
+Per futura memoria, si noti che spesso c'@`e address@hidden di un modo per
fare qualcosa
+in @command{awk}. In un altro momento, si potrebbe tornare a guardare questi
+esempi per vedere se si riescono a trovare modi differenti per fare le stesse
+cose mostrate qui appresso:
+
address@hidden @value{BULLET}
address@hidden
+Stampare ogni riga lunga address@hidden di 80 caratteri:
+
address@hidden
+awk 'length($0) > 80' data
address@hidden example
+
+L'unica regola presente ha un'espressione di relazione come modello
+e non ha azione---quindi applica l'azione di default, stampando il record.
+
address@hidden
+Stampare la lunghezza della riga in input address@hidden lunga:
+
address@hidden
+awk '@{ if (length($0) > max) max = length($0) @}
+ END @{ print max @}' data
address@hidden example
+
+Il codice associato a @code{END} viene eseguito dopo che tutto
+l'input @`e stato letto; @`e l'altra faccia della medaglia di @code{BEGIN}.
+
address@hidden programma @command{expand}
address@hidden @command{expand}, programma
address@hidden
+Stampare la lunghezza della riga address@hidden lunga in @file{data}:
+
address@hidden
+expand data | awk '@{ if (x < length($0)) x = length($0) @}
+ END @{ print "la lunghezza massima di una riga @`e" x @}'
address@hidden example
+
+Questo esempio @`e leggermente diverso da quello precedente:
+l'input @`e l'output del comando @command{expand}, che cambia i TAB
+in spazi, in modo che le larghezze confrontate siano quelle che sarebbero
+qualora le si stampasse, e non il numero dei caratteri di input su ogni
+riga. [il carattere TAB occupa un byte nel file, ma address@hidden generare
fino a
+otto spazi bianchi in fase di stampa.]
+
address@hidden
+Stampare ogni riga che abbia almeno un campo:
+
address@hidden
+awk 'NF > 0' data
address@hidden example
+
+Questa @`e una maniera facile per eliminare le righe vuote dal file (o
+piuttosto, per creare un nuovo file, simile al vecchio, ma nel quale le
+linee vuote sono state tolte).
+
address@hidden
+Stampare sette numeri casuali compresi tra 0 e 100, inclusi:
+
address@hidden
+awk 'BEGIN @{ for (i = 1; i <= 7; i++)
+ print int(101 * rand()) @}'
address@hidden example
+
address@hidden
+Stampare il numero totale di byte usato da un @var{elenco-file}:
+
address@hidden
+ls -l @var{elenco-file} | awk '@{ x += $5 @}
+ END @{ print "byte totali: " x @}'
address@hidden example
+
address@hidden
+Stampare il numero totale di kilobyte usati da @var{elenco-file}:
+
address@hidden Don't use \ continuation, not discussed yet
address@hidden Remember that awk does floating point division,
address@hidden no need for (x+1023) / 1024
address@hidden
+ls -l @var{elenco-file} | awk '@{ x += $5 @}
+ END @{ print "K-byte totali:", x / 1024 @}'
address@hidden example
+
address@hidden
+Stampare una lista in ordine alfabetico di tutti gli utenti del sistema
+[Unix]:
+
address@hidden
+awk -F: '@{ print $1 @}' /etc/passwd | sort
address@hidden example
+
address@hidden
+Contare le righe in un file:
+
address@hidden
+awk 'END @{ print NR @}' data
address@hidden example
+
address@hidden
+Stampare le righe pari nel @value{DF}:
+
address@hidden
+awk 'NR % 2 == 0' data
address@hidden example
+
+Se aveste usato invece l'espressione @samp{NR % 2 == 1},
+il programma avrebbe stampato le righe dispari.
address@hidden itemize
+
address@hidden Due regole
address@hidden Un esempio che usa due regole
address@hidden programmi @command{awk}
+
+Il programma @command{awk} legge il file in input una riga alla volta.
+Per ogni riga @command{awk} controlla la corrispondenza con ogni regola.
+Se viene trovata address@hidden di una corrispondenza, vengono eseguite
altrettante
+azioni, nell'ordine in cui appaiono nel programma @command{awk}.
+Se non viene trovata nessuna corrispondenza, non viene eseguita alcuna azione.
+
+Dopo aver elaborato tutte le regole che hanno corrispondenza con la riga (e
+pu@'o darsi che nessuna corrisponda), @command{awk} legge la riga successiva.
Comunque
address@hidden next},
address@hidden
+e @ref{Istruzione Nextfile}.)
address@hidden ifdocbook
address@hidden
+e anche @pxref{Istruzione nextfile}.)
address@hidden ifnotdocbook
+Si prosegue address@hidden@dotless{i}} finch@'e il programma raggiunge la fine
del file.
+Per esempio, il seguente programma @command{awk} contiene due regole:
+
address@hidden
+/12/ @{ print $0 @}
+/21/ @{ print $0 @}
address@hidden example
+
address@hidden
+La prima regola ha la stringa @samp{12} da cercare e
address@hidden $0} come
+azione. La seconda regola ha la
+stringa @samp{21} da cercare e ha ancora @samp{print $0} come azione.
+L'azione di ciascuna regola @`e racchiusa in una coppia di parentesi graffe.
+
+Questo programma stampa ogni riga che contiene la stringa
address@hidden @emph{oppure} la stringa @samp{21}. Se una riga contiene
entrambe
+le stringhe, @`e stampata due volte, una volta per ogni regola.
+
+Questo @`e address@hidden che capita se eseguiamo questo programma sui nostri
@value{DF},
address@hidden e @file{inventory-shipped}:
+
address@hidden
+$ @kbd{awk '/12/ @{ print $0 @}}
+> @kbd{/21/ @{ print $0 @}' mail-list inventory-shipped}
address@hidden Anthony 555-3412 anthony.asserturo@@hotmail.com A
address@hidden Camilla 555-2912 camilla.infusarum@@skynet.be R
address@hidden Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden Jan 21 36 64 620
address@hidden Apr 21 70 74 514
address@hidden example
+
address@hidden
+Si noti che la riga che inizia con @samp{Jean-Paul}
+nel file @file{mail-list}
address@hidden stata stampata due volte, una volta per ogni regola.
+
address@hidden Maggiore sofisticazione
address@hidden Un esempio address@hidden complesso
+
+Dopo aver imparato a eseguire alcuni semplici compiti, vediamo cosa possono
+fare i tipici programmi @command{awk}.
+Questo esempio mostra come @command{awk} address@hidden essere usato per
riassumere,
+selezionare e riordinare l'output di un altro comando. Sono usate
address@hidden di cui non si @`e ancora parlato, quindi non ci si deve
preoccupare
+se alcuni dettagli risulteranno oscuri:
+
address@hidden
+ls -l | awk '$6 == "Nov" @{ somma += $5 @}
+ END @{ print somma @}'
address@hidden example
+
address@hidden comando @command{ls}
+Questo comando stampa il numero totale di byte in tutti i file contenuti
+nella directory corrente, la cui data di modifica @`e novembre (di qualsiasi
+anno). La parte @address@hidden -l}} dell'esempio @`e un comando di sistema
che
+fornisce un elenco dei file in una directory, con anche la dimensione di
+ogni file e la data di ultima modifica. Il suo output @`e del tipo:
+
address@hidden
+-rw-r--r-- 1 arnold user 1933 Nov 7 13:05 Makefile
+-rw-r--r-- 1 arnold user 10809 Nov 7 13:03 awk.h
+-rw-r--r-- 1 arnold user 983 Apr 13 12:14 awk.tab.h
+-rw-r--r-- 1 arnold user 31869 Jun 15 12:20 awkgram.y
+-rw-r--r-- 1 arnold user 22414 Nov 7 13:03 awk1.c
+-rw-r--r-- 1 arnold user 37455 Nov 7 13:03 awk2.c
+-rw-r--r-- 1 arnold user 27511 Dec 9 13:07 awk3.c
+-rw-r--r-- 1 arnold user 7989 Nov 7 13:03 awk4.c
address@hidden example
+
address@hidden
address@hidden continuazione di riga, nella C shell
+Il primo campo contiene le autorizzazioni di lettura/scrittura [r/w], il
+secondo il numero dei collegamenti al file address@hidden il numero di nomi
con cui
+il file @`e conosciuto], e il terzo campo identifica il proprietario del file.
+Il quarto campo identifica il gruppo a cui appartiene il file.
+Il quinto campo contiene la dimensione del file, in byte.
+Il sesto, settimo e ottavo campo contengono il mese, il giorno e l'ora,
+rispettivamente, in cui il file @`e stato modificato. Infine, il nono campo
+contiene il @value{FN}.
+
address@hidden @cindex automatic initialization
address@hidden inizializzazione automatica
+L'espressione @samp{$6 == "Nov"} nel nostro programma @command{awk} controlla
+se il sesto campo dell'output di @address@hidden -l}} corrisponda alla stringa
address@hidden Ogni volta che una riga ha la stringa
address@hidden come suo sesto campo, @command{awk} esegue l'azione
address@hidden += $5}. Questo aggiunge il quinto campo (la dimensione del file)
+alla variabile @code{somma}. Come risultato, quando @command{awk} ha finito
+di leggere tutte le righe in input, @code{somma} contiene la somma totale
+delle dimensioni dei file che corrispondono al criterio di ricerca.
+(address@hidden funziona contando sul fatto che le variabili @command{awk} sono
+automaticamente inizializzate a zero.)
+
+Dopo che l'ultima riga dell'output di @command{ls} @`e stata elaborata, la
+regola @code{END} viene eseguita e viene stampato il valore di @code{somma}.
+In questo esempio, il valore di @code{somma} @`e 80600.
+
+Queste tecniche address@hidden avanzate di @command{awk} sono trattate in
address@hidden
+successive (@pxref{Panoramica sulle azioni}). Prima di poter passare a una
+programmazione address@hidden avanzata con @command{awk}, @`e necessario
sapere come
address@hidden interpreta i file in input e visualizza quelli in output.
+Modificando campi e usando l'istruzione @code{print} @`e possibile produrre
+dei rapporti molto utili ed esteticamente gradevoli.
+
address@hidden Istruzioni/Righe
address@hidden Istruzioni e righe in @command{awk}
address@hidden interruzioni di riga
address@hidden andare a capo
+
+Molto spesso, ogni riga di un programma @command{awk} @`e un'istruzione a s@'e
+stante o una regola isolata, come:
+
address@hidden
+awk '/12/ @{ print $0 @}
+ /21/ @{ print $0 @}' mail-list inventory-shipped
address@hidden example
+
address@hidden @command{gawk}, andare a capo
+Comunque, @command{gawk} ignora i ritorni a capo dopo ognuno di questi
+simboli e istruzioni:
+
address@hidden
+, @{ ? : || && do else
address@hidden example
+
address@hidden
+Un ritorno a capo in ogni altro punto del programma @`e considerato come la
+fine di un'address@hidden @samp{?} e i @samp{:} elencati sopra sono
+usati nell'espressione condizionale in tre parti descritta in
address@hidden condizionali}.
+Il cambio di riga dopo @samp{?} e i @samp{:} @`e un'estensione minore in
address@hidden; specificando @option{--posix} come opzione
+(@pxref{Opzioni}), quest'estensione non @`e valida.}
+
address@hidden @code{\} (barra inversa), continuazione di riga e
address@hidden barra inversa (@code{\}), continuazione di riga e
+Volendo dividere una sola istruzione su due righe in un punto in cui
+andando a capo sarebbe considerata conclusa, @`e possibile @dfn{continuare}
+nella riga successiva terminando la prima riga con un carattere di
+barra inversa (@samp{\}). La barra inversa dev'essere l'ultimo carattere
+sulla riga, per essere riconosciuto come un carattere di continuazione.
+Una barra inversa @`e consentita in ogni parte dell'istruzione, anche in mezzo
+a una stringa o a un'espressione regolare. Per esempio:
+
address@hidden
+awk '/Questa espressione regolare @`e troppo lunga, quindi\
+ la continuiamo sulla riga seguente/ @{ print $1 @}'
address@hidden example
+
address@hidden
address@hidden address@hidden, continuazione di riga con barra inversa e
+Non abbiamo quasi mai usato la continuazione tramite barra inversa nei nostri
+programmi di esempio. @command{gawk} non pone limiti alla lunghezza di
+una riga, quindi la continuazione tramite barra inversa non @`e mai
strettamente
+necessaria; serve soltanto a migliorare la address@hidden del programma.
+Per la stessa ragione, ma anche per amore di chiarezza, abbiamo tenuto
+concise molte istruzioni nei programmi presentati in questo @value{DOCUMENT}.
+La continuazione tramite barra inversa @`e molto utile quando il proprio
+programma @command{awk} si trova in un file sorgente separato, invece di
+essere immesso nella riga di comando. Si noti anche che molte implementazioni
+di @command{awk} presentano delle differenze su dove @`e possibile usare
+la continuazione tramite barra inversa. Per esempio, potrebbero non
+consentire di spezzare una costante di tipo stringa usando la continuazione
+tramite barra inversa. Quindi, per ottenere la massima address@hidden dei
+propri programmi @command{awk}, @`e meglio non spezzare le righe nel
+mezzo di un'espressione regolare o di una stringa.
address@hidden 10/2000: gawk, mawk, and current bell labs awk allow it,
address@hidden solaris 2.7 nawk does not. Solaris /usr/xpg4/bin/awk does
though! sigh.
+
address@hidden comando @command{csh}
address@hidden barra inversa (@code{\}), continuazione di riga e, in
@command{csh}
address@hidden @code{\} (barra inversa), continuazione di riga e, in
@command{csh}
address@hidden ATTENZIONE
address@hidden continuazione tramite barra inversa non funziona come sopra
descritto
+nella C shell.} Funziona per programmi @command{awk} contenuti in file e
+per programmi sulla riga di comando, @emph{ammesso} che si stia usando una
+shell conforme a POSIX, come la Unix Bourne shell o Bash. Ma la C shell si
+comporta in maniera diversa! In quel caso, occorre usare due barre inverse
+consecutive, in fondo alla riga. Si noti anche che quando si usa la C shell
address@hidden andata a capo nel vostro programma @command{awk} deve essere
+indicata con una barra inversa. Per esempio:
+
address@hidden
+% @kbd{awk 'BEGIN @{ \}
+? @kbd{ print \\}
+? @kbd{ "ciao, mondo" \}
+? @address@hidden'}
address@hidden ciao, mondo
address@hidden example
+
address@hidden
+Qui, il @samp{%} e il @samp{?} sono i prompt primario e secondario della
+C shell, analogamente a quelli usati nella shell standard @samp{$} e @samp{>}.
+
+Si confronti l'esempio precedente, come viene scritto in una shell conforme
+a POSIX:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{print \}
+> @kbd{"ciao, mondo"}
+> @address@hidden'}
address@hidden ciao, mondo
address@hidden example
address@hidden quotation
+
address@hidden @`e un linguaggio orientato alla riga. L'azione relativa a ogni
+regola deve iniziare sulla stessa riga del criterio di selezione. Per avere
+criterio di selezione e azione su righe separate, si
address@hidden usare la continuazione tramite barra inversa; non si
address@hidden fare
+diversamente.
+
address@hidden barra inversa (@code{\}), continuazione di riga, commenti e
address@hidden @code{\} (barra inversa), continuazione di riga, commenti e
address@hidden commenti, continuazione di riga con barra inversa e i
+Un'altra cosa da tener presente @`e che la continuazione tramite barra inversa
e
+i commenti non possono essere frammisti. Non appena @command{awk} incontra
+un @samp{#} che inizia un commento, ignora @emph{tutto} il resto della riga.
+Per esempio:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print "Non allarmarti" # una amichevole \}
+> @kbd{ regola BEGIN}
+> @address@hidden'}
address@hidden gawk: riga com.:2: regola BEGIN
address@hidden gawk: riga com.:2: ^ syntax error
address@hidden example
+
address@hidden
+In questo caso, parrebbe che la barra inversa continui il commento sulla riga
+successiva. Invece, la combinazione barra inversa-ritorno a capo non viene
+per nulla notata, in quanto ``nascosta'' all'interno del commento. Quindi,
+il @code{BEGIN} @`e marcato come errore di sintassi.
+
address@hidden istruzioni multiple
address@hidden @code{;} (punto e virgola), separare istruzioni nelle azioni
address@hidden punto e virgola (@code{;}), separare istruzioni nelle azioni
+Quando le istruzioni @command{awk} all'interno di una regola sono brevi, si
+potrebbe metterne address@hidden d'una su una riga sola. address@hidden @`e
possibile separando le
+istruzioni con un punto e virgola (@samp{;}).
+Questo vale anche per le regole stesse.
+Quindi, il programma visto all'inizio di
address@hidden
+questa
address@hidden ifnotinfo
address@hidden
+questo
address@hidden ifinfo
address@hidden
+poteva essere scritto anche address@hidden@dotless{i}}:
+
address@hidden
+/12/ @{ print $0 @} ; /21/ @{ print $0 @}
address@hidden example
+
address@hidden NOTA BENE
+La address@hidden che address@hidden regole coesistano sulla stessa riga, se
sono separate
+da un punto e virgola, non esisteva nel linguaggio @command{awk} originale;
address@hidden stata aggiunta per congruenza con quanto @`e consentito per le
istruzioni
+all'interno di un'azione.
address@hidden quotation
+
address@hidden Altre address@hidden
address@hidden Altre address@hidden di @command{awk}
+
address@hidden variabili
+Il linguaggio @command{awk} mette a disposizione un numero di variabili
address@hidden, o @dfn{predefinite}, che il programma dell'utente
address@hidden usare
+per ottenere informazioni da @command{awk}. Ci sono pure altre variabili
+che il programma address@hidden impostare, per definire come @command{awk} deve
+gestire i dati.
+
+Inoltre, @command{awk} mette a disposizione parecchie funzioni predefinite
address@hidden per effettuare calcoli di tipo comune e operazioni che
+agiscono sulle stringhe di caratteri.
address@hidden mette a disposizione funzioni predefinite per gestire le
+marcature temporali, per effettuare manipolazioni a livello di bit, per
+tradurre stringhe al momento dell'esecuzione del programma
+(internazionalizzazione), per determinare qual @`e il tipo di una variabile,
+e per ordinare dei vettori.
+
+Nel seguito della presentazione del linguaggio @command{awk}, saranno
+introdotte molte delle variabili e parecchie funzioni. Esse sono
+descritte sistematicamente in @ref{Variabili predefinite} e in
address@hidden
+
address@hidden Quando
address@hidden Quando usare @command{gawk}
+
address@hidden @command{awk}, uso di
+Ora che abbiamo visto qualcosa di quel che @command{awk} @`e in grado di fare,
+ci si address@hidden chiedere come @command{awk} potrebbe tornare utile.
Usando
+programmi di address@hidden, criteri di ricerca sofisticati, separatori
+di campo, istruzioni aritmetiche, e altri criteri di selezione, @`e possibile
+produrre degli output molto address@hidden complessi. Il linguaggio
@command{awk} @`e
+molto utile per fornire dei tabulati partendo da grandi address@hidden di dati
+grezzi, per esempio riassumendo informazioni dall'output di altri
+programmi di address@hidden come @command{ls}.
+(@xref{Maggiore sofisticazione}.)
+
+I programmi scritti con @command{awk} sono normalmente molto address@hidden
+corti dei loro equivalenti in altri linguaggi. address@hidden rende i
programmi
address@hidden facili da comporre e da utilizzare. Spesso i programmi
address@hidden possono essere scritti al volo a terminale, usati una volta sola
+e buttati via. Poich@'e i programmi @command{awk} sono interpretati, si
address@hidden
+evitare la (normalmente laboriosa) parte di compilazione nel ciclo tipico
+dello sviluppo software, ossia edita-compila-prova-correggi.
+
address@hidden Brian Kernighan, @command{awk} di
+In @command{awk} sono stati scritti programmi complessi, compreso un assembler
+completo, pluri-piattaforma per
address@hidden FOR_PRINT
address@hidden
+microprocessori a 8-bit (@pxrefil{Glossario}, per maggiori informazioni),
address@hidden iftex
address@hidden
+microprocessori a 8-bit (@pxref{Glossario}, per maggiori informazioni),
address@hidden ifnottex
address@hidden ifclear
address@hidden FOR_PRINT
+microprocessori a 8-bit,
address@hidden ifset
+e un assembler di microcodice per un computer dedicato esclusivamente
+al linguaggio Prolog.
+Le address@hidden dell'originale @command{awk} erano messe a dura prova
+da programmi di questa address@hidden, ma le versioni moderne sono
address@hidden robuste.
+
address@hidden programmi @command{awk}, complessi
+Se capita di scrivere programmi @command{awk} address@hidden lunghi di,
diciamo,
+qualche centinaio di righe, si potrebbe considerare la address@hidden di usare
+un linguaggio di programmazione differente da @command{awk}.
+La shell consente di ricercare stringhe ed espressioni regolari; inoltre
+consente di usare in maniera efficace i comandi di address@hidden del sistema.
+Python offre un piacevole equilibrio tra la address@hidden di una
programmazione
+ad alto livello, e la address@hidden di interagire a livello di sistema
address@hidden linguaggi di @dfn{script} popolari comprendono Ruby
+e Perl.}
+
address@hidden Sommario dell'introduzione
address@hidden Sommario
+
address@hidden FIXME: Review this chapter for summary of builtin functions
called.
address@hidden @value{BULLET}
address@hidden
+I programmi in @command{awk} consistono di coppie di
address@hidden di address@hidden
+
address@hidden
+Un'@var{azione} senza una @var{condizione di ricerca} viene sempre eseguita.
+L'@var{azione} di default per una condizione mancante @`e @address@hidden
print $0 @}}.
+
address@hidden
+Usare
address@hidden '@var{programma}' @var{file}}
+oppure
address@hidden -f @var{file-programma} @var{file}}
+per eseguire @command{awk}.
+
address@hidden
+Si address@hidden usare la notazione speciale @samp{#!} nella prima riga per
creare
+programmi @command{awk} che siano eseguibili direttamente.
+
address@hidden
+I commenti nei programmi @command{awk} iniziano con @samp{#} e continuano
+fino alla fine della stessa riga.
+
address@hidden
+Prestare attenzione ai problemi con gli apici nei programmi @command{awk}
+che facciano parte di uno @dfn{script} della shell (o di un file .BAT di
+MS-Windows).
+
address@hidden
+Si address@hidden usare la continuazione tramite barra inversa per continuare
righe di
+codice sorgente. Le righe sono continuate automaticamente dopo i simboli
+virgola, parentesi aperta, punto interrogativo, punto e virgola,
address@hidden||}, @samp{&&}, @code{do} ed @code{else}.
address@hidden itemize
address@hidden Invocare Gawk
address@hidden Eseguire @command{awk} e @command{gawk}
+
+Questo @value{CHAPTER} tratta di come eseguire @command{awk}, delle opzioni da
+riga di comando, sia quelle dello standard POSIX che quelle specifiche di
address@hidden, e di cosa fanno @command{awk} e @command{gawk} con gli
+argomenti che non sono opzioni.
+Prosegue poi spiegando come @command{gawk} cerca i file sorgenti,
+leggendo lo standard input assieme ad altri file, le variabili d'ambiente di
address@hidden, lo stato di ritorno di @command{gawk}, l'uso dei file inclusi,
+e opzioni e/o address@hidden obsolete e non documentate.
+
+Molte delle opzioni e address@hidden qui descritte sono trattate con
+maggior dettaglio nei capitoli successivi del @value{DOCUMENT}; gli argomenti
+presenti in questo @value{CHAPTER} che al momento non interessano si possono
+tranquillamente saltare.
+
address@hidden
+* Riga di comando:: Come eseguire @command{awk}.
+* Opzioni:: Opzioni sulla riga di comando e loro
+ significato.
+* Altri argomenti:: Nomi dei file in input e assegnamento di
+ valori a variabili.
+* Specificare lo standard input:: Come specificare lo standard input insieme ad
+ altri file.
+* Variabili d'ambiente:: Le variabili d'ambiente usate da
+ @command{gawk}.
+* Codice di ritorno:: Il codice di ritorno all'uscita da
+ @command{gawk}.
+* Includere file:: Come includere altri file nel proprio
+ programma.
+* Caricare librerie condivise:: Caricare librerie condivise nel
+ proprio programma.
+* Parti obsolete:: Opzioni e/o address@hidden obsolete.
+* Non documentato:: Opzioni e address@hidden non documentate.
+* Sommario invocazione:: Sommario invocazione.
address@hidden menu
+
address@hidden Riga di comando
address@hidden Come eseguire @command{awk}
address@hidden riga di comando, eseguire @command{awk} da
address@hidden @command{awk}, eseguire
address@hidden argomenti, riga di comando, eseguire @command{awk}
address@hidden opzioni sulla riga di comando, eseguire @command{awk}
+
+Ci sono due modi di eseguire @command{awk}: con un programma esplicito o con
+uno o address@hidden file di programma. Qui @`e mostrata la sintassi di
entrambi; le voci
+racchiuse tra address@hidden sono opzionali:
+
address@hidden
address@hidden address@hidden @option{-f} @var{file_di _programma}
address@hidden @var{file} @dots{}
address@hidden address@hidden address@hidden @code{'@var{programma}'}
@var{file} @dots{}
address@hidden display
+
address@hidden GNU, opzioni estese
address@hidden estese, opzioni
address@hidden opzioni estese
+In aggiunta alle tradizionali opzioni di una sola lettera in stile POSIX,
address@hidden consente anche le opzioni estese GNU.
+
address@hidden angolo buio, invocare @command{awk}
address@hidden @dfn{lint}, controlli con programma vuoto
address@hidden possibile invocare @command{awk} con un programma vuoto:
+
address@hidden
+awk '' file_dati_1 file_dati_2
address@hidden example
+
address@hidden @option{--lint}, opzione
address@hidden
+Fare address@hidden@dotless{i}} ha comunque poco senso; @command{awk} termina
+silenziosamente quando viene fornito un programma vuoto.
address@hidden
+Se @`e stato specificato @option{--lint} sulla riga di comando,
address@hidden emette un avviso che avverte
+che il programma @`e vuoto.
+
address@hidden Opzioni
address@hidden Opzioni sulla riga di comando
address@hidden opzioni sulla riga di comando
address@hidden riga di comando, opzioni
address@hidden GNU, opzioni estese
address@hidden opzioni estese
+
+Le opzioni sono precedute da un trattino e consistono in un unico carattere.
+Le opzioni estese in stile GNU sono precedute da un doppio trattino e
+consistono in una parola
+chiave. La parola chiave address@hidden essere abbreviata, a condizione che
+l'abbreviazione identifichi univocamente l'opzione. Se l'opzione prevede un
+argomento, la parola chiave @`e immediatamente seguita da un segno di uguale
+(@samp{=}) e dal valore dell'argomento, oppure la parola chiave e il valore
+dell'argomento sono separati da spazi.
+Se un'opzione con un valore viene immessa address@hidden di una volta,
+l'ultimo valore @`e quello che conta.
+
address@hidden POSIX @command{awk}, opzioni estese GNU e
+Ogni opzione estesa di @command{gawk} ha una corrispondente opzione
+breve in stile POSIX.
+Le opzioni estese e brevi sono
+intercambiabili in tutti i contesti.
+L'elenco seguente descrive le opzioni richieste dallo standard POSIX:
+
address@hidden @code
address@hidden -F @var{fs}
address@hidden --field-separator @var{fs}
address@hidden @option{-F}, opzione
address@hidden @option{--field-separator}, opzione
address@hidden @code{FS}, variabile, l'opzione @code{--field-separator} e
+Imposta la variabile @code{FS} a @var{fs}
+(@pxref{Separatori di campo}).
+
address@hidden -f @var{file-sorgente}
address@hidden --file @var{file-sorgente}
address@hidden @option{-f}, opzione
address@hidden @option{--file}, opzione
address@hidden @command{awk}, programmi, collocazione dei
+Legge il sorgente del programma @command{awk} da @var{file-sorgente}
+anzich@'e prenderlo dal primo argomento che non @`e un'opzione.
+Quest'opzione address@hidden essere data address@hidden volte; il programma
@command{awk}
address@hidden formato dalla concatenazione del contenuto di ogni
address@hidden specificato.
+
address@hidden -v @address@hidden
address@hidden --assign @address@hidden
address@hidden @option{-v}, opzione
address@hidden @option{--assign}, opzione
address@hidden variabili, impostazione
+Imposta la variabile @var{var} al valore @var{val} @emph{prima} che inizi
+l'esecuzione del programma. Tali valori di variabile sono disponibili
+all'interno della regola @code{BEGIN}
+(@pxref{Altri argomenti}).
+
+L'opzione @option{-v} address@hidden impostare una sola variabile per volta,
ma address@hidden
+essere usata address@hidden di una volta, impostando ogni volta una variabile
+differente, in questo modo:
address@hidden @w{-v pippo=1} @w{-v pluto=2} @dots{}}.
+
address@hidden predefinite, variabili, opzione @address@hidden impostare con
address@hidden variabili predefinite, impostare con opzione @code{-v}
address@hidden ATTENZIONE
+Usare @option{-v} per impostare valori di variabili predefinite
address@hidden condurre a risultati sorprendenti. @command{awk} address@hidden
i
+valori di quelle variabili secondo le sue address@hidden, anche ignorando
+eventuali valori iniziali che possono essere stati assegnati.
address@hidden quotation
+
address@hidden -W @var{gawk-opt}
address@hidden @option{-W}, opzione
+Fornisce un'opzione specifica dell'implementazione. Questa @`e la convenzione
+POSIX per fornire opzioni specifiche dell'implementazione.
+Queste opzioni
+hanno anche una corrispondente opzione estesa scritta in stile GNU.
+Si noti che le opzioni estese possono essere abbreviate, sempre che
+le abbreviazioni siano univoche.
+L'elenco completo delle opzioni specifiche di @command{gawk} @`e riportato di
+seguito.
+
address@hidden --
address@hidden riga di comando, opzioni, fine delle
address@hidden opzioni sulla riga di comando, fine delle
+Segnale della fine delle opzioni da riga di comando. I seguenti argomenti
+non sono trattati come opzioni anche se iniziano con @samp{-}. Questa
+interpretazione di @option{--} segue le convenzioni POSIX per l'analisi degli
+argomenti.
+
address@hidden @code{-} (meno), nomi di file che iniziano con
address@hidden meno (@code{-}), nomi di file che iniziano con
address@hidden utile se si hanno @value{FNS} che iniziano con @samp{-},
+o negli @dfn{script} di shell, se si hanno @value{FNS} che devono essere
+specificati dall'utente che potrebbero iniziare con @samp{-}.
address@hidden utile anche per passare opzioni al programma @command{awk};
+si veda @ref{Funzione getopt}.
address@hidden table
+
+L'elenco che segue descrive le opzioni specifiche di @command{gawk}:
+
address@hidden Have to use @asis here to get docbook to come out right.
address@hidden @asis
address@hidden @option{-b}
address@hidden @option{--characters-as-bytes}
address@hidden @option{-b}, opzione
address@hidden @option{--characters-as-bytes}, opzione
+Fa address@hidden@dotless{i}} che @command{gawk} tratti tutti i dati in input
come caratteri di un solo
+byte. In aggiunta, tutto l'output scritto con @code{print} o @code{printf}
+viene trattato come composto da caratteri contenuti in un solo byte.
+
+Normalmente, @command{gawk} segue lo standard POSIX e cerca di elaborare i suoi
+dati di input in accordo con la localizzazione corrente
+(@pxref{Localizzazioni}).
+Questo spesso address@hidden comportare la conversione di caratteri multibyte
in
+caratteri estesi (internamente), e address@hidden
+creare problemi o confusione se i dati di input non contengono caratteri
+multibyte validi. Quest'opzione @`e una maniera facile di dire a
@command{gawk}:
address@hidden le mani dai miei dati!''.
+
address@hidden @option{-c}
address@hidden @option{--traditional}
address@hidden @option{-c}, opzione
address@hidden @option{--traditional}, opzione
address@hidden address@hidden compatibile di (@command{gawk}), specificare
+Specifica la @address@hidden di address@hidden, nella quale le estensioni GNU
al
+linguaggio @command{awk} sono disabilitate; in questo modo @command{gawk} si
+comporta proprio come la versione di BWK @command{awk}.
+
address@hidden/GNU},
+che riassume le estensioni.
address@hidden FOR_PRINT
+Si veda anche
address@hidden@`a di address@hidden
address@hidden ifclear
+
address@hidden @option{-C}
address@hidden @option{--copyright}
address@hidden @option{-C}, opzione
address@hidden @option{--copyright}, opzione
address@hidden GPL (General Public License), stampare
+Stampa la versione ridotta della General Public License ed esce.
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-d}, opzione
address@hidden @option{--dump-variables}, opzione
address@hidden fornire una lista di tutte le variabili del programma
address@hidden @file{awkvars.out}, file
address@hidden file @file{awkvars.out}
address@hidden variabili globali, stampare una lista delle
+Stampa una lista ordinata di variabili globali, i loro tipi, e i valori finali
+in @var{file}. Se non viene fornito alcun @var{file}, stampa questa lista
+in un file chiamato @file{awkvars.out} nella directory corrente.
+Non sono consentiti spazi tra @option{-d} e @var{file}, se
address@hidden viene specificato.
+
address@hidden risoluzione di problemi, address@hidden variabili globali
address@hidden problemi, risoluzione di, address@hidden variabili globali
+Avere una lista di tutte le variabili globali @`e un buon modo per cercare
+refusi nei propri programmi.
+Si address@hidden usare quest'opzione anche se si ha un grosso programma con
tantissime
+funzioni, e si vuol essere sicuri che le funzioni non usino
+inavvertitamente variabili globali che sarebbero dovute essere locali
+(questo @`e un errore particolarmente facile da fare con nomi di variabile
+semplici come @code{i}, @code{j}, etc.).
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-D}, opzione
address@hidden @option{--debug}, opzione
address@hidden @command{awk}, debug, abilitare
+Abilita l'esecuzione del debug di programmi @command{awk}
+(@pxref{Debugging}).
+Per default, il debugger legge i comandi interattivamente dalla tastiera
+(standard input).
+L'argomento opzionale @var{file} consente di specificare un file con una lista
+di comandi per il debugger da eseguire in maniera non interattiva.
+Non sono consentiti spazi tra @option{-D} e @var{file}, se
address@hidden viene indicato.
+
address@hidden @option{-e} @var{testo-del-programma}
address@hidden @option{--source} @var{testo-del-programma}
address@hidden @option{-e}, opzione
address@hidden @option{--source}, opzione
address@hidden codice sorgente, combinare
+Fornisce del codice sorgente nel @var{testo-del-programma}.
+Quest'opzione consente di combinare il codice sorgente contenuto in file
+col codice sorgente immesso sulla riga di comando.
+Questo @`e particolarmente utile quando si hanno funzioni di libreria che si
+vogliono usare dai programmi da riga di comando
+(@pxref{AWKPATH (Variabile)}).
+
address@hidden @option{-E} @var{file}
address@hidden @option{--exec} @var{file}
address@hidden @option{-E}, opzione
address@hidden @option{--exec}, opzione
address@hidden @command{awk}, programmi, collocazione dei
address@hidden CGI, @command{awk} @dfn{script} per
+Simile a @option{-f}, legge il testo del programma @command{awk} da
address@hidden Ci sono due differenze rispetto a @option{-f}:
+
address@hidden @value{BULLET}
address@hidden
+Quest'opzione fa terminare l'elaborazione delle opzioni; qualsiasi
+altra cosa sulla riga di comando viene inoltrata direttamente al programma
address@hidden
+
address@hidden
+Le variabili da riga di comando della forma
address@hidden@address@hidden non sono ammesse.
address@hidden itemize
+
+Quest'opzione @`e particolarmente necessaria per le applicazioni World Wide Web
+CGI che passano argomenti attraverso le URL; l'uso di quest'opzione impedisce
+a un utente malintenzionato (o ad altri) di passare opzioni, assegnamenti o
+codice sorgente @command{awk} (con @option{-e}) all'applicazione
address@hidden maggiori dettagli,
+si veda la Sezione 4.4 di @uref{http://www.ietf.org/rfc/rfc3875,
+RFC 3875}. Si veda anche
address@hidden://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html,
+note esplicative spedite alla mailing list @command{gawk} bug}.}
+Quest'opzione dovrebbe essere usata
+con @dfn{script} @samp{#!}
+(@address@hidden eseguibili}), in questo modo:
+
address@hidden
+#! /usr/local/bin/gawk -E
+
address@hidden programma awk @`e qui @dots{}}
address@hidden example
+
address@hidden @option{-g}
address@hidden @option{--gen-pot}
address@hidden @option{-g}, opzione
address@hidden @option{--gen-pot}, opzione
address@hidden address@hidden, generare file oggetto
address@hidden file oggetto portabili, generare
+Analizza il programma sorgente e
+genera un file GNU @command{gettext} @dfn{portable object template} sullo
+standard output per tutte le costanti di tipo stringa che sono state marcate
+come da tradurre.
address@hidden,
+per informazioni su quest'opzione.
+
address@hidden @option{-h}
address@hidden @option{--help}
address@hidden @option{-h}, opzione
address@hidden @option{--help}, opzione
address@hidden GNU, opzioni estese, stampare una lista di
address@hidden opzioni, stampare una lista di
address@hidden stampa, lista di opzioni
+Stampa un messaggio sull'``uso'' riassumendo le opzioni brevi ed estese
+accettate da @command{gawk} ed esce.
+
address@hidden @option{-i} @var{file-sorgente}
address@hidden @option{--include} @var{file-sorgente}
address@hidden @option{-i}, opzione
address@hidden @option{--include}, opzione
address@hidden @command{awk}, programmi, collocazione dei
+Legge una libreria di sorgenti @command{awk} da @var{file-sorgente}.
+Quest'opzione @`e del tutto equivalente a usare la direttiva @code{@@include}
+all'interno del proprio programma. @`E molto simile all'opzione
address@hidden, ma ci sono due differenze importanti. Primo, quando viene usata
+l'opzione @option{-i}, il sorgente del programma non viene caricato se @`e
+stato caricato in precedenza, mentre con @option{-f}, @command{gawk} carica
+sempre il file. Secondo, poich@'e quest'opzione @`e pensata per essere usata
+con librerie di codice, @command{gawk} non riconosce tali file come
+costituenti l'input del programma principale. address@hidden@dotless{i}},
dopo l'elaborazione di
+un argomento @option{-i}, @command{gawk} si aspetta di trovare il codice
+sorgente principale attraverso l'opzione @option{-f} o sulla riga di comando.
+
address@hidden @option{-l} @var{ext}
address@hidden @option{--load} @var{ext}
address@hidden @option{-l}, opzione
address@hidden @option{--load}, opzione
address@hidden caricare estensioni
+Carica un'estensione dinamica denominata @var{ext}. Le estensioni sono
+memorizzate come librerie condivise di sistema.
+Quest'opzione ricerca la libreria usando la variabile d'ambiente
address@hidden Il suffisso corretto per la piattaforma in uso address@hidden
+fornito per default, address@hidden non @`e necessario specificarlo nel nome
+dell'estensione. La routine di inizializzazione dell'estensione dovrebbe
+essere denominata @code{dl_load()}. Un'alternativa @`e quella di usare la
+direttiva @code{@@load} all'interno del programma per caricare una libreria
+condivisa. Questa address@hidden avanzata @`e descritta in dettaglio in
address@hidden dinamiche}.
+
address@hidden @address@hidden
address@hidden @address@hidden@var{valore}]
address@hidden @option{-l}, opzione
address@hidden @option{--lint}, opzione
address@hidden @dfn{lint}, controlli, emissione di avvertimenti
address@hidden avvertimenti, emissione di
+Emette messaggi d'avvertimento relativi a costrutti dubbi o non portabili ad
+altre implementazioni di @command{awk}.
+Non sono consentiti spazi tra @option{-L} e @var{valore}, se
+viene indicato il @var{valore}.
+Alcuni avvertimenti vengono emessi quando @command{gawk} legge preliminarmente
+il programma. Altri vengono emessi quando il programma viene eseguito.
+Con l'argomento opzionale @samp{fatal}, gli avvertimenti @dfn{lint} sono
considerati
+come errori gravi. Potrebbe essere una misura drastica, address@hidden il suo
uso
address@hidden certamente lo sviluppo di programmi @command{awk} address@hidden
corretti.
+Con l'argomento opzionale @samp{invalid}, vengono emessi solo gli avvertimenti
+relativi a quello che @`e effettivamente non valido (address@hidden non ancora
+completamente implementata).
+
+Alcuni avvertimenti vengono stampati solo una volta, anche se i costrutti dubbi
+per i quali vengono emessi avvisi ricorrono diverse volte nel programma
address@hidden address@hidden, nell'eliminazione dei problemi rilevati da
address@hidden, bisogna porre attenzione a cercare tutte le occorrenze di ogni
+costrutto inappropriato. Siccome i programmi @command{awk} generalmente sono
+brevi, questa non @`e un'operazione gravosa.
+
address@hidden @option{-M}
address@hidden @option{--bignum}
address@hidden @option{-M}, opzione
address@hidden @option{--bignum}, opzione
+Chiede il calcolo con precisione arbitraria sui numeri. Quest'opzione non ha
+alcun effetto se @command{gawk} non @`e compilato per l'uso delle librerie GNU
+MPFR e MP
+(@pxref{Calcolo con precisione arbitraria}).
+
address@hidden @option{-n}
address@hidden @option{--non-decimal-data}
address@hidden @option{-n}, opzione
address@hidden @option{--non-decimal-data}, opzione
address@hidden address@hidden valori, abilitare l'interpretazione di
address@hidden address@hidden valori, abilitare l'interpretazione di
address@hidden risoluzione di problemi, opzione @code{--non-decimal-data}
+Abilita l'interpretazione automatica di valori ottali ed esadecimali
+nei dati di input
+(@pxref{Dati non decimali}).
+
address@hidden ATTENZIONE
+Quest'opzione address@hidden generare gravi malfunzionamenti nei vecchi
programmi.
+Usare con cautela. Si noti anche che
+quest'opzione potrebbe non essere address@hidden disponibile in una futura
versione di
address@hidden
address@hidden quotation
+
address@hidden @option{-N}
address@hidden @option{--use-lc-numeric}
address@hidden @option{-N}, opzione
address@hidden @option{--use-lc-numeric}, opzione
+Forza l'uso del carattere di separazione decimale della localizzazione
+quando analizza i dati in input
+(@pxref{Localizzazioni}).
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-o}, opzione
address@hidden @option{--pretty-print}, opzione
+Consente la stampa di una versione formattata elegantemente dei programmi
address@hidden Implica l'opzione @option{--no-optimize}.
+Per default il programma di output viene creato in un file
+chiamato @file{awkprof.out} (@pxref{Profilare}).
+L'argomento opzionale @var{file} consente di specificare un
address@hidden differente per l'output.
+Non sono consentiti spazi tra @option{-o} e @var{file}, se
address@hidden viene indicato.
+
address@hidden NOTA
+Nel passato, quest'opzione eseguiva anche il programma.
+Ora non @`e address@hidden address@hidden@dotless{i}}.
address@hidden quotation
+
address@hidden @option{-O}
address@hidden @option{--optimize}
address@hidden @option{--optimize}, opzione
address@hidden @option{-O}, opzione
+Abilita le ottimizzazioni di default nella rappresentazione interna del
+programma. Attualmente, questo comprende delle semplificazioni nell'uso
+di costanti e l'eliminazione delle code di chiamata nelle funzioni
+ricorsive [sostituzione della chiamata di funzione con dei salti
+diretti alla funzione].
+
+Queste ottimizzazioni sono abilitate per default.
+Quest'opzione rimane disponibile per address@hidden all'indietro.
+Tuttavia address@hidden essere usata per annullare l'effetto di una precedente
+opzione @option{-s} (si veda address@hidden sotto in questa lista).
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-p}, opzione
address@hidden @option{--profile}, opzione
address@hidden @command{awk}, profilatura, abilitare la
+Abilita la creazione del profilo di esecuzione di programmi @command{awk}
+(@pxref{Profilare}).
+Implicitamente viene forzata l'opzione @option{--no-optimize}.
+Per default, i profili vengono creati in un file chiamato @file{awkprof.out}.
+L'argomento opzionale @var{file} consente di specificare un altro
address@hidden per il file del profilo.
+Non sono consentiti spazi tra @option{-p} e @var{file}, se
+viene indicato un @var{file}.
+
+Il profilo contiene il numero di esecuzioni di ogni istruzione sul margine
+sinistro e il conteggio delle chiamate di funzione per ogni funzione.
+
address@hidden @option{-P}
address@hidden @option{--posix}
address@hidden @option{-P}, opzione
address@hidden @option{--posix}, opzione
address@hidden POSIX, address@hidden
address@hidden @command{gawk}, address@hidden disabilitare
+Opera in address@hidden POSIX rigorosa. Disabilita tutte le estensioni di
address@hidden (proprio come @option{--traditional}) e
+disabilita tutte le estensioni non consentite da POSIX.
+
address@hidden comuni}, per un sommario delle estensioni
+di @command{gawk} che sono disabilitate da quest'opzione.
+Inoltre,
+vengono applicate le seguenti
+restrizioni:
+
address@hidden @value{BULLET}
+
address@hidden ritorno a capo
address@hidden spazi vuoti, ritorno a capo invece che
address@hidden
+I ritorni a capo non sono consentiti dopo @samp{?} o @samp{:}
+(@pxref{Espressioni condizionali}).
+
+
address@hidden @code{FS}, variabile, come carattere TAB
address@hidden
+Specificando @samp{-Ft} sulla riga di comando non si imposta il valore
+della variabile @code{FS} a un singolo carattere TAB
+(@pxref{Separatori di campo}).
+
address@hidden localizzazione, separatore decimale della
address@hidden separatore decimale, carattere, specifico della localizzazione
address@hidden
+Il carattere di separatore decimale della localizzazione @`e usato per
analizzare
+i dati di input
+(@pxref{Localizzazioni}).
address@hidden itemize
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden @option{--traditional}, opzione, e opzione @code{--posix}
address@hidden @option{--posix}, opzione, e opzione @code{--traditional}
+Se si forniscono entrambe le opzioni @option{--traditional} e @option{--posix}
+sulla riga di comando, @option{--posix} ha la precedenza. Se vengono fornite
+entrambe le opzioni @command{gawk} emette un avviso.
+
address@hidden @option{-r}
address@hidden @option{--re-interval}
address@hidden @option{-r}, opzione
address@hidden @option{--re-interval}, opzione
address@hidden espressioni regolari, espressioni di intervallo e
+Consente le espressioni di intervallo
+(@pxref{Operatori di espressioni regolari})
+nelle espressioni regolari.
+Questo @`e ora il comportamento di default di @command{gawk}.
+Tuttavia, quest'opzione rimane (sia per address@hidden
+che per l'uso in combinazione con @option{--traditional}).
+
address@hidden @option{-s}
address@hidden @option{--no-optimize}
address@hidden @option{--no-optimize}, opzione
address@hidden opzione @option{--no-optimize}
address@hidden @option{-s}, opzione,
address@hidden opzione @option{-s}
+Disabilita le opzioni di ottimizzazione di default di @command{gawk}
+effettuate sulla rappresentazione interna del programma.
+
address@hidden @option{-S}
address@hidden @option{--sandbox}
address@hidden @option{-S}, opzione
address@hidden @option{--sandbox}, opzione
address@hidden sandbox, address@hidden
address@hidden prova, address@hidden di
+Disabilita la funzione @code{system()},
+la ridirezione dell'input con @code{getline},
+la ridirezione dell'output con @code{print} e @code{printf},
+e le estensioni dinamiche.
address@hidden particolarmente utile quando si vogliono eseguire @dfn{script}
@command{awk}
+da sorgenti dubbie e si vuol essere ricuri che gli @dfn{script} non abbiano
+accesso al sistema (oltre al @value{DF} di input specificato).
+
address@hidden @option{-t}
address@hidden @option{--lint-old}
address@hidden @option{-L}, opzione
address@hidden @option{--lint-old}, opzione
+Avvisa su costrutti che non sono disponibili nella versione originale di
address@hidden dalla versione 7 di Unix
+(@pxref{V7/SVR3.1}).
+
address@hidden @option{-V}
address@hidden @option{--version}
address@hidden @option{-V}, opzione
address@hidden @option{--version}, opzione
address@hidden @command{gawk}, versioni di, informazioni address@hidden stampa
+Stampa informazioni sulla versione di questa specifica copia di @command{gawk}.
+Consente di determinare se la copia di @command{gawk} in uso @`e aggiornata
+rispetto a quello che @`e attualmente in distribuzione da parte della Free
+Software Foundation.
address@hidden utile anche per la segnalazione di bug
+(@pxref{Bug}).
address@hidden table
+
+Ogni altra opzione, se @`e stato specificato il testo di un programma
address@hidden contrassegnata come non valida con un messaggio di avvertimento,
+altrimenti @`e ignorata.
+
address@hidden @option{-F}, opzione, opzione @option{-Ft} imposta @code{FS} a
TAB
+In address@hidden di address@hidden, come caso particolare, se il valore di
@var{fs}
+fornito all'opzione @option{-F} @`e @samp{t}, @code{FS} @`e impostata al
carattere
+TAB (@code{"\t"}). Questo @`e vero solo per @option{--traditional} e non
+per @option{--posix}
+(@pxref{Separatori di campo}).
+
address@hidden @option{-f}, opzione, usi multipli
+L'opzione @option{-f} address@hidden essere usata address@hidden di una volta
nella riga di comando.
+In questo caso, @command{awk} legge il sorgente del suo programma da tutti i
+file indicati, come se fossere concatenati assieme a formare un unico grande
+file.
+Questo @`e utile per creare librerie di funzioni di @command{awk}. Queste
+funzioni possono venir scritte una volta e in seguito recuperate da una
+posizione standard, invece di doverle includere in ogni singolo programma.
+L'opzione @option{-i} @`e simile in questo senso.
+(Come indicato in
address@hidden delle definizioni},
+i nomi di funzione devono essere univoci).
+
+Con @command{awk} standard, le funzioni di libreria si possono ancora usare,
+anche se il programma @`e immesso dalla tastiera,
+specificando @samp{-f /dev/tty}. Dopo aver scritto il programma,
+premere @kbd{Ctrl-d} (il carattere di fine file) per terminarlo.
+(Si potrebbe anche usare @samp{-f -} per leggere il sorgente del programma
+dallo standard input, ma poi non si address@hidden usare lo standard input
come sorgente
+di dati).
+
+Siccome @`e scomodo usare il meccanismo di @command{awk} standard per combinare
+file sorgenti e programmi @command{awk} da riga di comando, @command{gawk}
+fornisce l'opzione @option{-e}. Questo non richiede di evitare l'uso dello
+standard input per immettere codice sorgente; consente di combinare
+facilmente codice sorgente da riga di comando e da libreria
+(@pxref{AWKPATH (Variabile)}).
+Come per @option{-f}, le opzioni @option{-e} e @option{-i}
+si possono usare address@hidden volte nella riga di comando.
+
address@hidden @option{-e}, opzione
+Se non sono specificate opzioni @option{-f} o @option{-e}, @command{gawk}
+usa il primo argomento che non @`e un'opzione come testo del
+codice sorgente del programma.
+
address@hidden @env{POSIXLY_CORRECT}, variabile d'ambiente
address@hidden @dfn{lint}, controlli, variabile d'ambiente @env{POSIXLY_CORRECT}
address@hidden POSIX, address@hidden
+Se la variabile d'ambiente @env{POSIXLY_CORRECT} esiste,
address@hidden si comporta in address@hidden POSIX rigorosa, esattamente come se
+fosse stata fornita l'opzione @option{--posix}.
+Molti programi GNU cercano questa variabile d'ambiente per eliminare
+estensioni che confliggono con POSIX, ma @command{gawk} si comporta in modo
+diverso: sopprime tutte le estensioni, anche quelle che non confliggono con
+POSIX, e funziona rigorosamente in address@hidden POSIX.
+Se viene fornita l'opzione @option{--lint} sulla riga di comando e
address@hidden passa alla address@hidden POSIX a causa di @env{POSIXLY_CORRECT},
+viene emesso un messaggio di avvertimento indicando che @`e attiva la
address@hidden POSIX. Normalmente questa variabile si imposta nel file di avvio
+della shell a livello utente.
+Per una shell compatibile con Bourne (come Bash), queste righe andranno
+aggiunte nel file @file{.profile} della directory "home" dell'utente:
+
address@hidden
+POSIXLY_CORRECT=true
+export POSIXLY_CORRECT
address@hidden example
+
address@hidden @command{csh}, comando, variabile d'ambiente
@env{POSIXLY_CORRECT}
+Per una shell compatibile con C,@footnote{Non raccomandato.}
+questa riga address@hidden aggiunta nel file @file{.login} nella directory
"home"
+dell'utente:
+
address@hidden
+setenv POSIXLY_CORRECT true
address@hidden example
+
address@hidden address@hidden, variabile d'ambiente @env{POSIXLY_CORRECT}
+Avere @env{POSIXLY_CORRECT} impostata non @`e raccomandato per l'uso
quotidiano,
+ma @`e utile per provare la address@hidden dei programmi su altri
+ambienti.
+
address@hidden Altri argomenti
address@hidden Altri argomenti della riga di comando
address@hidden riga di comando, argomenti
address@hidden argomenti, riga di comando
+
+Qualsiasi altro argomento sulla riga di comando @`e trattato normalmente come
+file in input da elaborare nell'ordine con cui @`e specificato. Comunque, un
+argomento che ha la forma @address@hidden@var{valore}}, assegna
+il valore @var{valore} alla variabile @var{var}---non specifica affatto
+un file. (Si veda @ref{Opzioni di assegnamento}.) Nel seguente esempio,
address@hidden @`e un assegnamento di variabile, non un @value{FN}:
+
address@hidden
+awk -f programma.awk file1 count=1 file2
address@hidden example
+
address@hidden @command{gawk}, variabile @code{ARGIND} in
address@hidden @code{ARGIND}, variabile, argomenti da riga di comando
address@hidden @code{ARGV}, vettore, indicizzare all'interno di
address@hidden @code{ARGC}/@code{ARGV}, variabili, argomenti da riga di comando
+Tutti gli argomenti da riga di comando sono resi disponibili al programma
address@hidden nel vettore @code{ARGV} (@pxref{Variabili predefinite}).
Opzioni da
+riga di comando e il testo del programma (se presente) sono esclusi da
address@hidden Tutti gli altri argomenti, compresi gli assegnamenti di
+variabile, sono inclusi. Come ogni elemento di @code{ARGV} viene elaborato,
address@hidden imposta @code{ARGIND} all'indice in @code{ARGV}
+dell'elemento corrente.
+
address@hidden FIXME: One day, move the ARGC and ARGV node closer to here.
+La modifica di @code{ARGC} e @code{ARGV} nel proprio programma @command{awk}
+consente di controllare come @command{awk} elabora i file in input; questo @`e
+descritto address@hidden dettagliatamente in @ref{ARGC e ARGV}.
+
address@hidden file in input, assegnamenti di variabile e
address@hidden assegnamenti di variabile e file in input
+La distinzione tra argomenti che sono @value{FN} e argomenti di assegnamento
+di variabili vien fatta quando @command{awk} deve aprire il successivo file di
+input.
+A quel punto dell'esecuzione, controlla la variabile @value{FN} per vedere se
address@hidden piuttosto un assegnamento di variabile; se
address@hidden@dotless{i}} @`e, @command{awk} imposta la
+variabile invece di leggere un file.
+
+Dunque, le variabili ricevono effettivamente i valori loro assegnati dopo che
+tutti i file precedentemente specificati sono stati letti. In particolare, i
+valori delle variabili assegnati in questo modo @emph{non} sono disponibili
+all'interno di una regola @code{BEGIN}
+(@pxref{BEGIN/END}),
+poich@'e tali regole vengono eseguite prima che @command{awk} cominci a
+esaminare la lista degli argomenti.
+
address@hidden angolo buio, sequenze di protezione
+I valori delle variabili dati sulla riga di comando sono elaborati per
+rimuovere sequenze di protezione (@pxref{Sequenze di protezione}).
address@hidden
+
+In alcune implementazioni di @command{awk} molto vecchie, quando un
+assegnamento di variabile capitava prima di un qualsiasi @value{FN},
+l'assegnamento avveniva @emph{prima} che fosse stata eseguita la regola
address@hidden Il comportamento di @command{awk} era in questo modo
+ambiguo; alcuni assegnamenti da riga di comando erano disponibili
+all'interno della regola @code{BEGIN}, mentre altri no. Sfortunatamente,
+alcune applicazioni finivano per essere dipendenti da questa
address@hidden''. Quando @command{awk} fu modificato per essere address@hidden
+coerente, fu aggiunta l'opzione @option{-v} a beneficio delle
+applicazioni che dipendevano dal vecchio comportamento.
+
+La address@hidden dell'assegnamento di variabile @`e molto utile per assegnare
+valori a variabili come @code{RS}, @code{OFS}, e @code{ORS}, che controllano i
+formati di input e di output, prima di effettuare la scansione dei @value{DF}.
address@hidden utile anche per effettuare passaggi multipli su un o stesso
address@hidden Per esempio:
+
address@hidden file, passaggi multipli su
address@hidden
+awk 'pass == 1 @{ @var{pass 1 stuff} @}
+ pass == 2 @{ @var{pass 2 stuff} @}' pass=1 mydata pass=2 mydata
address@hidden example
+
+Una volta disponibile la address@hidden per assegnare una variabile, l'opzione
address@hidden per impostare il valore di @code{FS} non @`e address@hidden
strettamente
+necessaria. Rimane per address@hidden all'indietro.
+
address@hidden Specificare lo standard input
address@hidden Come specificare lo standard input insieme ad altri file
+
+Capita spesso di voler leggere lo standard input assieme ad altri file.
+Per esempio, leggere un file, leggere lo standard input derivante da una
address@hidden, e poi leggere un altro file.
+
+Il modo di indicare lo standard input, con tutte le versioni di @command{awk},
address@hidden quello di usare un segno meno o trattino da solo, @samp{-}. Per
esempio:
+
address@hidden
address@hidden | awk -f ilmioprogramma.awk file1 - file2
address@hidden example
+
address@hidden
+In questo caso, @command{awk} legge prima @file{file1}, poi legge
+l'output di @var{qualche_comando}, e infile legge
address@hidden
+
+Si address@hidden anche usare @code{"-"} per indicare lo standard input quando
si leggono
+i file con @code{getline} (@pxref{Getline file}).
+
+In aggiunta, @command{gawk} consente di specificare il
address@hidden speciale @file{/dev/stdin}, sia sulla riga di comando che
+quando si usa @code{getline}.
+Anche qualche altra versione di @command{awk} include questa address@hidden,
+ma non @`e standard.
+(Alcuni sistemi operativi prevedono un file @file{/dev/stdin}
+nel filesystem; comunque, @command{gawk} elabora sempre
+questo @value{FN} per conto suo [ossia non importa se il sistema
+operativo rende disponibile il file o no].)
+
address@hidden Variabili d'ambiente
address@hidden Le variabili d'ambiente usate da @command{gawk}
address@hidden variabili d'ambiente usate da @command{gawk}
+
+Diverse variabili d'ambiente influiscono sul comportamento
+di @command{gawk}.
+
address@hidden
+* AWKPATH (Variabile):: Ricerca di programmi @command{awk}
+ in una lista di directory.
+* AWKLIBPATH (Variabile):: Ricerca di librerie condivise
+ @command{awk} su varie directory.
+* Altre variabili d'ambiente:: Le variabili d'ambiente.
address@hidden menu
+
address@hidden AWKPATH (Variabile)
address@hidden Ricerca di programmi @command{awk} in una lista di directory.
address@hidden @env{AWKPATH}, variabile d'ambiente
address@hidden directory, ricerca di file sorgente
address@hidden percorso di ricerca per file sorgente
address@hidden ricerca, percorso di, per file sorgente
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
d'ambiente @env{AWKPATH}
address@hidden
+Il precedente @value{SECTION} ha descritto come i file di programma di
address@hidden possono essere specificati sulla riga di comando con
+l'opzione @option{-f}.
address@hidden ifinfo
+Nella maggior parte delle implementazioni di @command{awk} si deve indicare il
+percorso completo di ogni file di programma, a meno che il file non
+sia nella directory corrente. Con @command{gawk}, invece, se la
+variabile @value{FN} impostata con le opzioni @option{-f} o @option{-i} non
+contiene un separatore di directory @samp{/}, @command{gawk} cerca un file con
+quel nome in un elenco di directory (chiamato @dfn{percorso di ricerca}),
+scorrendole una per una.
+
+Il percorso di ricerca @`e una stringa di nomi di directory separati da due
address@hidden e virgola in MS-Windows.}. @command{gawk} prende
+il percorso di ricerca dalla variabile d'ambiente @env{AWKPATH}. Se questa
+variabile non esiste, o se ha un come valore la stringa nulla,
address@hidden usa un percorso di default (descritto tra poco).
+
+La address@hidden del percorso di ricerca @`e particolarmente utile per
costruire
+librerie di funzioni di @command{awk}. I file di libreria possono essere messi
+in una directory standard inclusa nel percorso di ricerca
+e richiamati sulla riga di comando con un
address@hidden breve. Altrimenti, si dovrebbe scrivere l'intero @value{FN} per
+ciascun file.
+
+Usando l'opzione @option{-i}, o l'opzione @option{-f}, i programmi di
address@hidden scritti sulla riga di comando possono usare le address@hidden
+contenute nei file di libreria di @command{awk}
address@hidden
+(@pxrefil{Funzioni di libreria}).
address@hidden iftex
address@hidden
+(@pxref{Funzioni di libreria}).
address@hidden ifnottex
+La ricerca del percorso non viene eseguita se @command{gawk} @`e in
address@hidden di
address@hidden, sia con l'opzione @option{--traditional} che con l'opzione
address@hidden
address@hidden
+
+Se il file del codice sorgente non viene trovato con una prima ricerca,
+il percorso viene cercato di nuovo dopo aver aggiunto il suffisso
address@hidden al @value{FN}.
+
+Il meccanismo di ricerca del percorso di @command{gawk} @`e simile a quello
+della shell.
+(Si veda @uref{http://www.gnu.org/software/bash/manual/,
address@hidden Bourne-Again SHell manual}}.)
+Un elemento nullo nel percorso indica la directory corrente.
+(Un elemento nullo @`e indicato iniziando o terminando il percorso con un segno
+di @samp{:} oppure mettendo due @samp{:} consecutivi address@hidden::}].)
+
address@hidden NOTA
+Per includere la directory corrente nel percorso di ricerca, si address@hidden
+aggiungere @file{.} come un elemento del percorso di ricerca, oppure
+inserire un elemento nullo.
+
+Diverse passate versioni di @command{gawk} avrebbero effettuato anche una
+ricerca esplicita nella directory corrente, prima o dopo aver esaminato il
+percorso di ricerca. A partire dalla @value{PVERSION} 4.1.2, questo non
+vale address@hidden; se si desidera una ricerca nella directory corrente, @`e
+necessario aggiungere @file{.} esplicitamente, oppure aggiungendo un
+elemento nullo al percorso di ricerca.
address@hidden quotation
+
+Il valore di default di @env{AWKPATH} @`e
address@hidden:/usr/local/share/address@hidden versione di @command{gawk}
+che state usando potrebbe usare una directory diversa; address@hidden dipende
da come
address@hidden @`e stato compilato e installato. La directory effettiva @`e il
+valore di @code{$(datadir)} generato quando @`e stato configurato
address@hidden Non @`e comunque il caso di preoccuparsi per questo.}
+Poich@'e @file{.} @`e incluso all'inizio, @command{gawk} cerca dapprima nella
+directory corrente, e poi in @file{/usr/local/share/awk}.
+In pratica, questo vuol dire che solo raramente ci address@hidden bisogno di
cambiare
+il valore di @env{AWKPATH}.
+
address@hidden da usare a inizio sessione}, per informazioni su funzioni che
possono
+essere di aiuto per gestire la variabile @env{AWKPATH}.
+
address@hidden memorizza il valore del percorso di ricerca in uso in
address@hidden"AWKPATH"]}. Questo consente di aver accesso al valore del
+percorso di ricerca in uso all'interno di un programma @command{awk}.
+
+Sebbene la variabile @code{ENVIRON["AWKPATH"]} possa
+essere cambiata anche all'interno di
+un programma @command{awk}, questo non modifica il comportamento del
+programma in esecuzione. Questo comportamento ha una sua logica: la variabile
+d'ambiente @env{AWKPATH} @`e usata per trovare i file sorgenti del programma;
una
+volta che il programma @`e in esecuzione, tutti i file sono stati trovati,
+e @command{gawk} non ha address@hidden bisogno di usare @env{AWKPATH}.
+
address@hidden AWKLIBPATH (Variabile)
address@hidden Ricerca di librerie condivise @command{awk} su varie directory.
address@hidden @env{AWKLIBPATH}, variabile d'ambiente
address@hidden directory, ricerca di estensioni caricabili
address@hidden percorso di ricerca per estensioni
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
d'ambiente @code{AWKLIBPATH}
+
+La variabile d'ambiente @env{AWKLIBPATH} @`e simile alla variabile
@env{AWKPATH},
+ma @`e usata per ricercare estensioni caricabili (memorizzate come
+librerie condivise di sistema) specificate con l'opzione @option{-l},
+anzich@'e file sorgenti. Se l'estensione non viene trovata, il percorso viene
+cercato nuovamente dopo aver aggiunto il suffisso per la libreria condivisa
+appropriato per la piattaforma. Per esempio, sui sistemi GNU/Linux viene usato
+il suffisso @samp{.so}. Il percorso di ricerca specificato @`e usato anche
+attraverso la direttiva @code{@@load}
+(@pxref{Caricare librerie condivise}).
+
+Se la variabile d'ambiente @env{AWKLIBPATH} non esiste, o se ha come valore
+la stringa nulla, @command{gawk} usa un percorso di ricerca di default;
+questo normalmente vale @samp{/usr/local/lib/gawk}, anche se il suo valore
address@hidden essere diverso, a seconda di come @`e stato installato
@command{gawk}.
+
address@hidden da usare a inizio sessione}, per informazioni su funzioni che
possono
+essere di aiuto per gestire la variabile @env{AWKPATH}.
+
address@hidden memorizza il valore del percorso di ricerca in uso in
address@hidden"AWKLIBPATH"]}. Questo consente di aver accesso al valore del
+percorso di ricerca in uso all'interno di un programma @command{awk}.
+
address@hidden Altre variabili d'ambiente
address@hidden Le variabili d'ambiente.
+
+Molte altre variabili d'ambiente influenzano il comportamento di
address@hidden, ma esse sono address@hidden specializzate. Quelle dell'elenco
seguente
+sono quelle address@hidden utili agli utenti normali:
+
address@hidden @env
address@hidden GAWK_MSEC_SLEEP
+Specifica l'intervallo tra due tentativi di riconnessione,
+in millisecondi. Sui sistemi che non prevedono
+la chiamata di sistema @code{usleep()},
+il valore @`e arrotondato a un numero intero di secondi .
+
address@hidden GAWK_READ_TIMEOUT
+Specifica per quanto tempo, in millisecondi, @command{gawk}
+aspetta l'input prima di emettere un messaggio di errore.
+
address@hidden GAWK_SOCK_RETRIES
+Controlla il numero di volte che @command{gawk} cerca di
+ristabilire una connessione bidirezionale TCP/IP (@dfn{socket}) prima di
+rinunciare a farlo.
address@hidden TCP/IP}.
+Si noti che quando @`e attiva l'opzione di continuazione dopo errori di I/O
+(@pxref{Continuazione dopo errori}),
address@hidden tenta di aprire un @dfn{socket} TCP/IP soltanto una volta.
+
address@hidden POSIXLY_CORRECT
+Provoca il passaggio di @command{gawk} alla address@hidden di address@hidden
POSIX,
+disabilitando tutte le estensioni tradizionali e GNU.
address@hidden
address@hidden table
+
+Le variabili d'ambiente nell'elenco che segue sono utili
+soprattutto agli sviluppatori di @command{gawk} per il collaudo e la messa
+a punto del programma. Sono soggette a cambiamenti. Le variabili sono:
+
address@hidden @env
address@hidden AWKBUFSIZE
+Questa variabile riguarda solo @command{gawk} installato su sistemi
+conformi a POSIX.
+Col valore di @samp{exact}, @command{gawk} usa la dimensione di ogni file di
+input come dimensione del buffer di memoria da allocare per I/O. Altrimenti,
+il valore dovrebbe essere un numero, e @command{gawk} usa questo numero come
+dimensione del buffer da allocare. (Quando questa variabile non @`e impostata,
address@hidden usa la address@hidden piccola tra le dimensioni del file e la
dimensione
+del blocco di ``default'', che normalmente @`e la dimensione del blocco I/O
+del filesystem).
+
address@hidden AWK_HASH
+Se questa variabile @`e impostata con un valore di @samp{gst}, @command{gawk}
+usa la funzione hash di GNU Smalltalk per gestire i vettori.
+Questa funzione address@hidden essere leggermente address@hidden veloce della
funzione standard.
address@hidden AWKREADFUNC
+Se questa variabile esiste, @command{gawk} legge i file sorgenti una riga per
+volta, anzich@'e a blocchi. Questa variabile @`e presente
+per problemi di debug su filesystem di sistemi operativi non POSIX,
+dove l'I/O @`e elaborato a record, non a blocchi.
+
address@hidden GAWK_MSG_SRC
+Se questa variabile esiste, @command{gawk} include il @value{FN} e il
+numero di riga all'interno del codice sorgente @command{gawk}
+dal quale sono stati generati i messaggi di avvertimento o
+i messaggi di errore grave. Il suo intento @`e quello di aiutare a isolare
+l'origine di un messaggio, poich@'e ci possono essere address@hidden righe di
codice che
+producono lo stesso messaggio di avvertimento o di errore.
+
address@hidden GAWK_LOCALE_DIR
+Specifica la posizione dei file oggetto compilati contenenti la traduzione dei
+messaggi emessi da @command{gawk} stesso. Questa variabile @`e passata alla
+funzione @code{bindtextdomain()} nella fase di partenza di @command{gawk}.
+
address@hidden GAWK_NO_DFA
+Se questa variabile esiste, @command{gawk} non usa il riconoscitore di
+espressioni regolari ASFD [automa a stati finiti deterministico] per i tipi di
+test di corrispondenza. Questo address@hidden causare un rallentamento di
@command{gawk}.
+Il suo intento @`e quello di aiutare a isolare le differenze tra i due
+riconoscitori di espressioni regolari che @command{gawk} usa internamente (non
+dovrebbero esserci differenze, ma a volte la teoria non coincide con la
+pratica).
+
address@hidden GAWK_STACKSIZE
+Specifica di quanto @command{gawk} dovrebbe accrescere il suo stack di
+valutazione interno, all'occorrenza.
+
address@hidden INT_CHAIN_MAX
+Specifica il numero massimo previsto di elementi che @command{gawk} mantiene
+su una catena hash per gestire i vettori indicizzati da numeri interi.
+
address@hidden STR_CHAIN_MAX
+Specifica il numero massimo previsto di elementi che @command{gawk} mantiene
+su una catena hash per gestire i vettori indicizzati da stringhe.
+
address@hidden TIDYMEM
+Se questa variabile esiste, @command{gawk} usa le chiamate di libreria
address@hidden()} della @dfn{GNU C library} per aiutare a scoprire
+possibili sprechi di memoria.
address@hidden table
+
address@hidden Codice di ritorno
address@hidden Il codice di ritorno all'uscita da @command{gawk}
+
address@hidden codice di ritorno, di @command{gawk}
address@hidden stato d'uscita, di @command{gawk}
+Se l'istruzione @code{exit} viene usata con un valore
+(@pxref{Istruzione exit}), @command{gawk} termina l'esecuzione con il valore
+numerico specificato.
+
+Altrimenti, se non ci sono stati problemi durante l'esecuzione,
address@hidden esce col valore della costante C
address@hidden, che normalmente @`e zero.
+
+Se si verifica un errore, @command{gawk} esce col valore della
+costante C @code{EXIT_FAILURE}, che normalmente @`e uguale a uno.
+
+Se @command{gawk} esce a causa di un errore grave, il codice di ritorno
address@hidden due. Sui sistemi non POSIX questo valore address@hidden essere
mappato
+a @code{EXIT_FAILURE}.
+
address@hidden Includere file
address@hidden Come includere altri file nel proprio programma
+
address@hidden Panos Papadopoulos <address@hidden> contributed the original
address@hidden text for this section.
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
address@hidden @code{@@include}, direttiva
address@hidden direttiva @code{@@include}
address@hidden includere file, direttiva @code{@@include}
+La direttiva @code{@@include} address@hidden essere usata per leggere file
sorgenti
+di @command{awk} esterni. Questo address@hidden la address@hidden di
suddividere file
+sorgenti di @command{awk} di grandi dimensioni in porzioni address@hidden
piccole e address@hidden
+maneggevoli, e anche di riutilizzare codice @command{awk} di uso comune
+da diversi @dfn{script} @command{awk}. In altre parole, si possono
+raggruppare funzioni di @command{awk} usate per eseguire determinati compiti
+all'interno di file esterni. Questi file possono essere usati proprio come
+librerie di funzioni, usando la direttiva @code{@@include} assieme alla
+variabile d'ambiente @env{AWKPATH}. Si noti che i file sorgenti possono
+venire inclusi anche usando l'opzione @option{-i}.
+
+Vediamolo con un esempio.
+Iniziamo con due @dfn{script} @command{awk} (banali), che chiameremo
address@hidden e @file{test2}. Questo @`e lo @dfn{script} @file{test1}:
+
address@hidden
+BEGIN @{
+ print "Questo @`e lo script test1."
address@hidden
address@hidden example
+
address@hidden
+e questo @`e @file{test2}:
+
address@hidden
+@@include "test1"
+BEGIN @{
+ print "Questo @`e lo script test2."
address@hidden
address@hidden example
+
+L'esecuzione di @command{gawk} con @file{test2}
+produce il seguente risultato:
+
address@hidden
+$ @kbd{gawk -f test2}
address@hidden Questo @`e lo script test1.
address@hidden Questo @`e lo script test2.
address@hidden example
+
address@hidden esegue lo @dfn{script} @file{test2}, il quale include
address@hidden, usando la direttiva @code{@@include}.
address@hidden@dotless{i}}, per includere file sorgenti di @command{awk}
esterni, basta usare
address@hidden@@include} seguito dal nome del file da includere,
+racchiuso tra doppi apici.
+
address@hidden NOTA
+Si tenga presente che questo @`e un costrutto del linguaggio e che @value{FN}
+non address@hidden essere una variabile di tipo stringa, ma solo una costante
di tipo
+letterale racchiusa tra doppi apici.
address@hidden quotation
+
+I file da includere possono essere nidificati; p.es., dato un terzo
address@hidden, che chiameremo @file{test3}:
+
address@hidden
+@@include "test2"
+BEGIN @{
+ print "Questo @`e lo script test3."
address@hidden
address@hidden example
+
address@hidden
+L'esecuzione di @command{gawk} con lo @dfn{script} @file{test3} produce i
+seguenti risultati:
+
address@hidden
+$ @kbd{gawk -f test3}
address@hidden Questo @`e lo script test1.
address@hidden Questo @`e lo script test2.
address@hidden Questo @`e lo script test3.
address@hidden example
+
+Il @value{FN}, naturalmente, address@hidden essere un nome di percorso.
+Per esempio:
+
address@hidden
+@@include "../funzioni_di_i_o"
address@hidden example
+
address@hidden
+e:
+
address@hidden
+@@include "/usr/awklib/network"
address@hidden example
+
address@hidden
+sono entrambi percorsi validi. La variabile d'ambiente @env{AWKPATH}
address@hidden
+rivestire grande importanza quando si usa @code{@@include}. Le stesse
+regole per l'uso della variabile d'ambiente @env{AWKPATH} nelle ricerche
+da riga di comando
+(@pxref{AWKPATH (Variabile)}) si applicano anche a
address@hidden@@include}.
+
+Questo @`e di grande aiuto nella costruzione di librerie di funzioni di
address@hidden Se si ha uno @dfn{script} di grandi dimensioni contenente
+utili funzioni @command{awk} di uso comune, lo si address@hidden suddividere
in file
+di libreria e mettere questi file in una directory dedicata. In seguito si
+possono includere queste ``librerie'' usando il percorso completo dei
+file, o impostando opportunamente la variabile d'ambiente @env{AWKPATH} e
+quindi usando @code{@@include} con la sola parte del percorso completo che
+designa il file. Naturalmente,
+si possono tenere i file di libreria in address@hidden di una directory;
address@hidden @`e complesso l'ambiente di lavoro, address@hidden
+directory possono essere necessarie per organizzare i file da includere.
+
+Vista la address@hidden di specificare opzioni @option{-f} multiple, il
+meccanismo @code{@@include} non @`e strettamente necessario.
+Comunque, la direttiva @code{@@include} address@hidden essere d'aiuto nel
costruire
+programmi @command{gawk} autosufficienti, riducendo address@hidden@dotless{i}}
la address@hidden
+di scrivere righe di comando complesse e tediose.
+In particolare, @code{@@include} @`e molto utile per scrivere @dfn{script} CGI
+eseguibili da pagine web.
+
+Come @`e stato detto in @ref{AWKPATH (Variabile)}, i file sorgenti vengono
+sempre cercati nella directory corrente, prima di eseguire la ricerca in
address@hidden; questo si applica anche ai file indicati con
address@hidden@@include}.
+
address@hidden Caricare librerie condivise
address@hidden Caricare librerie condivise nel proprio programma
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
address@hidden @code{@@load}, direttiva
address@hidden direttiva @code{@@load}
address@hidden caricare estensioni, direttiva @code{@@load}
address@hidden estensioni, caricamento, direttiva @code{@@load}
+La direttiva @code{@@load} address@hidden essere usata per leggere estensioni
di
address@hidden esterne (memorizzate come librerie condivise di sistema).
+Questo consente di collegare del codice compilato che address@hidden offrire
prestazioni
+migliori o dare l'accesso a address@hidden estese non incluse nel linguaggio
address@hidden La variabile @env{AWKLIBPATH} viene usata per ricercare
+l'estensione. Usare @code{@@load} @'e del tutto equivalente a usare l'opzione
da
+riga di comando @option{-l}.
+
+Se l'estensione non viene trovata in @env{AWKLIBPATH}, viene effettuata
+un'altra ricerca dopo aver aggiunto al @value{FN} il suffisso della
+libreria condivisa comunemente in uso per la piattaforma corrente. Per
+esempio, sui sistemi GNU/Linux viene usato il suffisso @samp{.so}:
+
address@hidden
+$ @kbd{gawk '@@load "ordchr"; BEGIN @{print chr(65)@}'}
address@hidden A
address@hidden example
+
address@hidden
+Questo @`e equivalente all'esempio seguente:
+
address@hidden
+$ @kbd{gawk -lordchr 'BEGIN @{print chr(65)@}'}
address@hidden A
address@hidden example
+
address@hidden
+Per l'uso da riga di comando @`e address@hidden conveniente l'opzione
@option{-l},
+ma @code{@@load} @`e utile da inserire all'interno di un file sorgente di
address@hidden che richieda l'accesso a un'estensione.
+
address@hidden dinamiche}, descrive come scrivere estensioni (in C or C++)
+che possono essere caricate sia con @code{@@load} che con l'opzione
address@hidden @`E anche descritta l'estensione @code{ordchr}.
+
address@hidden Parti obsolete
address@hidden Opzioni e/o address@hidden obsolete
+
address@hidden update this section for each release!
+
address@hidden opzioni deprecate
address@hidden address@hidden deprecate
address@hidden obsolete, address@hidden
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive address@hidden o opzioni da riga di comando
+provenienti da precedenti versioni di @command{gawk} che non sono
address@hidden
+disponibili nella versione corrente, o che sono ancora utilizzabili ma sono
+deprecate (address@hidden significa che @emph{non} saranno presenti nella
prossima
+versione).
+
+I file speciali relativi ai processi @file{/dev/pid}, @file{/dev/ppid},
address@hidden/dev/pgrpid} e @file{/dev/user} erano deprecati, ma ancora
disponibili,
+in @command{gawk} 3.1. A partire dalla @value{PVERSION} 4.0, non sono
address@hidden interpretati da @command{gawk} in modo speciale (al loro posto
usare
+invece @code{PROCINFO}; si veda @ref{Variabili auto-assegnate}).
+
address@hidden
+This @value{SECTION}
+is thus essentially a place holder,
+in case some option becomes obsolete in a future version of @command{gawk}.
address@hidden ignore
+
address@hidden Non documentato
address@hidden Opzioni e address@hidden non documentate
address@hidden non documentate, address@hidden
address@hidden address@hidden non documentate
address@hidden Skywalker, Luke
address@hidden Kenobi, Obi-Wan
address@hidden Jedi, Cavalieri
address@hidden Cavalieri Jedi
address@hidden
address@hidden il codice sorgente, Luke!}
address@hidden Obi-Wan
address@hidden quotation
+
address@hidden conchiglie, mare
address@hidden
+Questa @value{SECTION} @`e stata lasciata intenzionalmente vuota.
address@hidden ifnotinfo
address@hidden
+Questo @value{SECTION} @`e stato lasciato intenzionalmente vuoto.
address@hidden ifinfo
+
address@hidden
address@hidden If these came out in the Info file or TeX document, then they
wouldn't
address@hidden be undocumented, would they?
+
address@hidden ha un'opzione non documentata:
+
address@hidden @code
address@hidden -W nostalgia
address@hidden --nostalgia
+Stampa il messaggio @samp{awk: bailing out near line 1} e termina
+con un errore grave.
+Quest'opzione @`e stata ispirata dal comportamento comune delle primissime
+versioni di @command{awk} Unix e da una maglietta [con la scritta].
+Il messaggio @emph{NON} viene tradotto in ambienti non inglesi.
address@hidden so there! nyah, nyah.
address@hidden table
+
+Le prime versioni di @command{awk} non richiedevano alcun separatore (a capo
+
+o @samp{;}) tra le regole nei programmi @command{awk}. Quindi,
+era normale vedere programmi di una riga come:
+
address@hidden
+awk '@{ sum += $1 @} END @{ print sum @}'
address@hidden example
+
address@hidden in address@hidden consente questo stile, ma la cosa non @`e
+documentata per non incoraggiare la pratica. Il modo corretto per scrivere
+quel programma @`e uno dei
+seguenti:
+
address@hidden
+awk '@{ sum += $1 @} ; END @{ print sum @}'
address@hidden example
+
address@hidden
+oppure:
+
address@hidden
+awk '@{ sum += $1 @}
+ END @{ print sum @}' data
address@hidden example
+
address@hidden
address@hidden/Righe}, per una spiegazione address@hidden ampia.
+
+Si possono inserire righe bianche dopo @samp{;} nei cicli @code{for}.
+Questa sembre essere stata una address@hidden a lungo non documentata in
address@hidden Unix.
+
+Analogamente, si possono usare istruzioni @code{print} o @code{printf}
+nelle parti @var{valore-iniziale} e @var{incremento} di un ciclo
address@hidden Questa @`e un'altra address@hidden a lungo non documentata in
address@hidden Unix.
+
address@hidden consente di usare come nomi di parametro dei
+nomi di funzioni predefinite che facciano parte delle estensioni
address@hidden, all'interno di funzioni definite dall'utente.
+Questo avviene per ``salvaguardare per il futuro'' vecchi programmi che
+utilizzino nomi di funzioni aggiunte da @command{gawk} dopo che questi
+programmi erano stati scritti.
+Le funzioni predefinite standard di command{awk}, per esempio
address@hidden()} o @code{substr()} @emph{non} ammettono questa address@hidden
+
+Il vettore @code{PROCINFO["argv"]} contiene tutti gli argomenti della
+riga di comando (una volta espansi i metacaratteri ed elaborata la
+ridirezione, nelle piattaforme in cui address@hidden dev'essere fatto
manualmente
+dal programma), con indici che vanno da 0 as @code{argc} @minus{} 1.
+Per esempio, @code{PROCINFO["argv"][0]} address@hidden il nome con cui @`e
+stato invocato @command{gawk}. L'esempio seguente mostra come @`e
+possibile usare questa address@hidden:
+
address@hidden
+awk '
+BEGIN @{
+ for (i = 0; i < length(PROCINFO["argv"]); i++)
+ print i, PROCINFO["argv"][i]
address@hidden'
address@hidden example
+
address@hidden da tener presente che questo vettore @`e diverso dal vettore
+standard @code{ARGV} che non comprende quegli argomenti della riga di
+comando che sono address@hidden stati elaborati da
address@hidden (@pxref{ARGC e ARGV}).
+
address@hidden ignore
+
address@hidden Sommario invocazione
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Per eseguire @command{awk} usare, o
address@hidden '@var{programma}' @var{file}}
+o
address@hidden -f @var{file-del-programma} @var{file}}.
+
address@hidden
+Le tre opzioni standard per tutte le versioni di @command{awk} sono
address@hidden, @option{-F} e @option{-v}. @command{gawk} fornisce queste e
+molte altre, come pure le opzioni estese corrispondenti scritte in stile GNU.
+
address@hidden
+Gli argomenti da riga di comando che non sono opzioni sono trattati normalmente
+come @value{FNS}, a meno che non abbiano la forma @address@hidden@var{valore}};
+nel qual caso vengono riconosciuti come assegnamenti di variabile da eseguire
+in quel punto
+nell'elaborazione dell'input.
+
address@hidden
+Tutti gli argomenti da riga di comando che non sono opzioni, escluso il testo
+del programma, vengono messe nel vettore @code{ARGV}. Modifiche a @code{ARGC}
+e @code{ARGV} influiscono su come @command{awk} elabora l'input.
+
address@hidden
+Si address@hidden usare un segno meno a s@'e stante (@samp{-}) per designare
lo standard
+input sulla riga di comando. @command{gawk} consente anche di usare il
address@hidden speciale @file{/dev/stdin}.
+
+
address@hidden
address@hidden tiene conto di diverse variabili d'ambiente;
address@hidden, @env{AWKLIBPATH} e @env{POSIXLY_CORRECT} sono le
address@hidden importanti.
+
address@hidden
+Lo stato d'uscita di @command{gawk} invia informazioni al programma che lo
+ha invocato. Usare l'istruzione @code{exit} dall'interno di un programma
address@hidden per impostare il codice di ritorno.
+
address@hidden
address@hidden consente di includere nel proprio programma file sorgenti di
address@hidden con la direttiva @code{@@include} o con le opzioni da riga di
+comando @option{-i} e @option{-f}.
+
address@hidden
address@hidden consente di caricare funzioni aggiuntive scritte in C
+o C++ con la direttiva @code{@@load} e/o con l'opzione @option{-l}
+(questa address@hidden avanzata @`e descritta address@hidden avanti, in
address@hidden dinamiche}).
address@hidden itemize
address@hidden Espressioni regolari
address@hidden Espressioni regolari
address@hidden @dfn{regexp}
address@hidden espressioni regolari
+
+Una @dfn{espressione regolare}, o @dfn{regexp}, @`e un modo per descrivere un
+insieme di stringhe.
+Poich@'e le espressioni regolari sono una parte fondamentale della
+programmazione in @command{awk}, il loro formato e il loro uso meritano un
address@hidden a s@'e stante.
+
address@hidden barra (@code{/}), per delimitare le espressioni regolari
address@hidden @code{/} (barra), per delimitare le espressioni regolari
+Un'espressione regolare racchiusa tra barre (@samp{/})
address@hidden un modello di ricerca @command{awk} che individua tutti i record
in input
+il cui testo corrisponde al modello stesso.
+L'espressione regolare address@hidden semplice @`e una sequenza di lettere o
di numeri, o
+di entrambi. Una tale @dfn{regexp} individua ogni stringa che contenga quella
+particolare sequenza.
+Quindi, la @dfn{regexp} @samp{pippo} individua ogni stringa che contenga
address@hidden In altre parole, al modello di ricerca @code{/pippo/}
corrisponde
+ogni record in input che contiene i cinque caratteri consecutivi @samp{pippo}
address@hidden qualsiasi parte} del record. Altri tipi di @dfn{regexp}
permettono
+di specificare classi di stringhe molto address@hidden complesse.
+
address@hidden
+All'inizio, gli esempi in questo @value{CHAPTER} sono semplici.
+Man mano che entriamo nei dettagli su
+come funzionano le espressioni regolari utilizzeremo formulazioni
address@hidden
+complesse.
address@hidden ifnotinfo
+
address@hidden
+* Uso di @dfn{regexp}:: Come usare le espressioni regolari.
+* Sequenze di protezione:: Come scrivere caratteri non stampabili.
+* Operatori di espressioni regolari:: Operatori di espressioni regolari.
+* Espressioni tra parentesi quadre:: Cosa possono contenere @samp{[...]}.
+* address@hidden lungo da sinistra:: Quanto @`e lungo il testo
individuato.
+* Espressioni regolari calcolate:: Usare @dfn{regexp} dinamiche.
+* Operatori di @dfn{regexp} GNU:: Operatori propri del software GNU.
+* Maiuscolo-Minuscolo:: Fare confronti ignorando
+ maiuscolo/minuscolo.
+* Sommario espressioni regolari:: Sommario delle espressioni regolari.
address@hidden menu
+
address@hidden Uso di @dfn{regexp}
address@hidden Uso di espressioni regolari
+
address@hidden espressioni regolari, come criteri di ricerca
+Un'espressione regolare address@hidden essere usata come modello di ricerca
+racchiudendola tra barre. L'espressione regolare @`e quindi confrontata
+con tutto il testo di ogni record (normalmente, basta che corrisponda a
+una parte qualsiasi del testo per risultare soddisfatta). Per esempio,
+il seguente programma stampa il secondo campo di ogni record in cui compaia
+la stringa @samp{li}, in qualsiasi parte del record:
+
address@hidden
+$ @kbd{awk '/li/ @{ print $2 @}' mail-list}
address@hidden 555-5553
address@hidden 555-0542
address@hidden 555-6699
address@hidden 555-3430
address@hidden example
+
address@hidden espressioni regolari, operatori
address@hidden operatori, ricerca in stringhe
address@hidden @cindex operators, @code{~}
address@hidden ricerca in stringhe, operatori
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @cindex operatori, @code{!~}
address@hidden @code{if}, istruzione, uso di espressioni regolari in
address@hidden @code{while}, istruzione, uso di espressioni regolari in
address@hidden @address@hidden, istruzione, uso di espressioni regolari in
address@hidden @cindex istruzione @code{if}
address@hidden @cindex istruzione @code{while}
address@hidden @cindex istruzione @code{do}
+Espressioni regolari possono anche essere usate in espressioni di confronto.
+Queste espressioni consentono di specificare le stringhe da riconoscere;
+non devono necessariamente comprendere l'intero record corrente. I due
+operatori @samp{~} e @samp{!~} confrontano espressioni regolari. Le
+espressioni che usano questi operatori possono essere usate come modelli di
+ricerca, o nelle istruzioni @code{if}, @code{while}, @code{for}, e @code{do}.
+(@xref{Istruzioni}.)
+Per esempio:
+
address@hidden
address@hidden ~ /@var{regexp}/
address@hidden example
+
address@hidden
address@hidden verificata se l'espressione @var{exp} (intesa come stringa)
+corrisponde a @var{regexp}. L'esempio che segue individua, o sceglie,
+tutti i record in input in cui la lettera maiuscola @samp{J} @`e presente da
+qualche parte nel primo campo:
+
address@hidden
+$ @kbd{awk '$1 ~ /J/' inventory-shipped}
address@hidden Jan 13 25 15 115
address@hidden Jun 31 42 75 492
address@hidden Jul 24 34 67 436
address@hidden Jan 21 36 64 620
address@hidden example
+
+Lo stesso risultato si address@hidden ottenere anche
address@hidden@dotless{i}}:
+
address@hidden
+awk '@{ if ($1 ~ /J/) print @}' inventory-shipped
address@hidden example
+
+Il prossimo esempio chiede che l'espressione @var{exp}
+(intesa come stringa)
address@hidden corrisponda a @var{regexp}:
+
address@hidden
address@hidden !~ /@var{regexp}/
address@hidden example
+
+L'esempio che segue individua o sceglie tutti i record in input il cui
+primo campo @emph{NON} contiene
+la lettera maiuscola @samp{J}:
+
address@hidden
+$ @kbd{awk '$1 !~ /J/' inventory-shipped}
address@hidden Feb 15 32 24 226
address@hidden Mar 15 24 34 228
address@hidden Apr 31 52 63 420
address@hidden May 16 34 29 208
address@hidden
address@hidden example
+
address@hidden @dfn{regexp}, costanti
address@hidden costanti @dfn{regexp}
address@hidden espressioni regolari, costanti, si veda costanti @dfn{regexp}
+Quando una @dfn{regexp} @`e racchiusa tra barre, come @code{/pippo/}, la
chiamiamo
+una @dfn{costante regexp}, proprio come @code{5.27} @`e una costante
+numerica e @code{"pippo"} @`e una costante [di tipo] stringa.
+
address@hidden Sequenze di protezione
address@hidden Sequenze di protezione
+
address@hidden sequenze di protezione, in stringhe
address@hidden barra inversa (@code{\}), in sequenze di protezione
address@hidden @code{\} (barra inversa), in sequenze di protezione
+Alcuni caratteri non possono essere inclusi letteralmente in costanti
+stringa (@code{"pippo"}) o in costanti @dfn{regexp} (@code{/pippo/}).
+Vanno invece rappresentati usando @dfn{sequenze di protezione},
+ossia sequenze di caratteri preceduti da una barra inversa (@samp{\}).
+Una sequenza di protezione address@hidden essere usata per includere un
carattere di
+"doppio apice" in una costante stringa. Poich@'e un semplice doppio apice
+termina la stringa, va usato @samp{\"} per richiedere che un doppio apice sia
+presente all'interno di una stringa. Per esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Egli le disse \"ciao!\"." @}'}
address@hidden Egli le disse "ciao!".
address@hidden example
+
+Lo stesso carattere di barra inversa @`e un altro carattere che non
address@hidden essere
+incluso normalmente; occorre scrivere @samp{\\} per inserire una barra
+inversa nella stringa o @dfn{regexp}. Quindi, la stringa costituita dai due
+caratteri @samp{"} e @samp{\} deve essere scritta come @code{"\"\\"}.
+
+Altre sequenze di protezione rappresentano caratteri non stampabili
+come TAB o il ritorno a capo. Anche se @`e possibile immettere la maggior
parte dei
+caratteri non stampabili direttamente in una costante stringa o
address@hidden, essi possono non essere di facile comprensione.
+
+La seguente lista elenca
+tutte le sequenze di protezione usate in @command{awk} e
+cosa rappresentano. Se non @`e detto altrimenti, tutte queste sequenze di
+protezione valgono sia per costanti stringa che per costanti @dfn{regexp}:
+
address@hidden @code
address@hidden \\
+Barra inversa letterale, @samp{\}.
+
address@hidden @cindex @command{awk} language, V.4 version
address@hidden @code{\} (barra inversa), @code{\a}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\a}, sequenza di protezione
address@hidden \a
+Il carattere ``campanello'', @kbd{Ctrl-g}, codice ASCII 7 (BEL).
+(Spesso genera qualche tipo di segnale sonoro udibile.)
+
address@hidden @code{\} (barra inversa), @code{\b}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\b}, sequenza di protezione
address@hidden \b
+Barra inversa, @kbd{Ctrl-h}, codice ASCII 8 (BS).
+
address@hidden @code{\} (barra inversa), @code{\f}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\f}, sequenza di protezione
address@hidden \f
+Nuova pagina, @kbd{Ctrl-l}, codice ASCII 12 (FF).
+
address@hidden @code{\} (barra inversa), @code{\n}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\n}, sequenza di protezione
address@hidden \n
+A capo, @kbd{Ctrl-j}, codice ASCII 10 (LF).
+
address@hidden @code{\} (barra inversa), @code{\r}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\r}, sequenza di protezione
address@hidden \r
+Ritorno del carrello, @kbd{Ctrl-m}, codice ASCII 13 (CR).
+
address@hidden @code{\} (barra inversa), @code{\t}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\t}, sequenza di protezione
address@hidden \t
+Tabulazione orizzontale, @kbd{Ctrl-i}, codice ASCII 9 (HT).
+
address@hidden @cindex @command{awk} language, V.4 version
address@hidden @code{\} (barra inversa), @code{\v}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\v}, sequenza di protezione
address@hidden \v
+Tabulazione verticale, @kbd{Ctrl-k}, codice ASCII 11 (VT).
+
address@hidden @code{\} (barra inversa), @address@hidden, sequenza di protezione
address@hidden barra inversa (@code{\}), @address@hidden, sequenza di protezione
address@hidden address@hidden
+Il valore ottale @var{nnn}, dove @var{nnn} address@hidden essere da 1 a 3
cifre ottali,
+tra @samp{0} e @samp{7}. Per esempio, il codice per il carattere ASCII ESC
+(escape) @`e @samp{\033}.
+
address@hidden @cindex @command{awk} language, V.4 version
address@hidden @cindex @command{awk} language, POSIX version
address@hidden @code{\} (barra inversa), @code{\x}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\x}, sequenza di protezione
address@hidden comuni, address@hidden @code{\x}, sequenza di protezione
address@hidden estensioni comuni, @code{\x}, sequenza di protezione
address@hidden address@hidden@dots{}
+Il valore esadecimale @var{hh}, dove @var{hh} indica una sequenza di cifre
+esadecimali (@address@hidden, e @address@hidden
+o @address@hidden). Dopo @samp{\x} @`e consentito un massimo di due cifre.
+Ogni ulteriore cifra esadecimale @`e considerata come una semplice
+lettera o numero. @value{COMMONEXT}
+(La sequenza di protezione @samp{\x} non @`e permessa in POSIX awk.)
+
address@hidden ATTENZIONE
+In ISO C, la sequenza di protezione continua fino a raggiungere il primo
+carattere che non sia una cifra esadecimale.
+In passato, @command{gawk} avrebbe continuato ad aggiungere
+cifre esadecimali al valore finch@'e non trovava una cifra non esadecimale
+oppure fino a raggiungere la fine della stringa.
+Comunque usare address@hidden di due cifre esadecimali produceva risultati
indefiniti.
+Dalla @value{PVERSION} 4.2,
+vengono elaborate solo due cifre.
address@hidden quotation
+
address@hidden @code{\} (barra inversa), @code{\/}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\/}, sequenza di protezione
address@hidden \/
+Una barra (necessario solo per costanti @dfn{regexp}).
+Questa sequenza si usa per inserire una costante @dfn{regexp}
+che contiene una barra
+(come @code{/.*:\/home\/[[:alnum:]]+:.*/}; la notazione @samp{[[:alnum:]]}
address@hidden spiegata address@hidden avanti,
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden tra parentesi quadre}).
+Poich@'e una @dfn{regexp} @`e racchiusa tra
+barre, si deve proteggere ogni barra che sia parte dell'espressione, per dire
+ad @command{awk} di andare avanti a scandire il resto della @dfn{regexp}.
+
address@hidden @code{\} (barra inversa), @code{\"}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\"}, sequenza di protezione
address@hidden \"
+Un doppio apice (necessario solo per costanti stringa).
+Questa sequenza si usa per inserire in una costante stringa il carattere
+doppio apice
+(come @code{"Egli le disse \"ciao!\"."}).
+Poich@'e la stringa @`e racchiusa tra
+doppi apici, si deve proteggere ogni doppio apice che sia parte della stringa
+per dire ad @command{awk} di andare avanti a elaborare il resto della stringa.
address@hidden table
+
+In @command{gawk}, parecchie altre sequenze di due caratteri inizianti con
+con una barra inversa hanno un significato speciale nelle @dfn{regexp}.
address@hidden di @dfn{regexp} GNU}.
+
+In una @dfn{regexp}, una barra inversa che preceda un carattere non presente
+nella lista precedente, e non elencato in
address@hidden di @dfn{regexp} GNU},
+significa che il carattere seguente dovrebbe essere preso letteralmente,
+anche se normalmente sarebbe un operatore di @dfn{regexp}. Per esempio,
address@hidden/a\+b/} individua i tre caratteri @samp{a+b}.
+
address@hidden barra inversa (@code{\}), in sequenze di protezione
address@hidden @code{\} (barra inversa), in sequenze di protezione
address@hidden address@hidden
+Per una completa address@hidden, non usare una barra inversa prima di qualsiasi
+carattere non incluso nella lista precedente, o che non sia un operatore.
address@hidden 11/2014: Moved so as to not stack sidebars
address@hidden sidebar, Barra inversa prima di un carattere normale
address@hidden
address@hidden
+<sidebar><title>Barra inversa prima di un carattere normale</title>
address@hidden docbook
+
address@hidden address@hidden, barra inversa in sequenze di protezione
address@hidden POSIX @command{awk}, barre inverse in costanti stringa
address@hidden barra inversa (@code{\}), in sequenze di protezione, POSIX e
address@hidden @code{\} (barra inversa), in sequenze di protezione, POSIX e
+
address@hidden risoluzione di problemi, barra inversa prima di caratteri non
speciali
address@hidden problemi, risoluzione di, barra inversa prima di caratteri non
speciali
+Se si mette una barra inversa in una costante stringa prima di qualcosa che
+non sia uno dei caratteri elencati sopra, POSIX @command{awk} di proposito
+lascia indefinito il comportamento. Ci sono due address@hidden:
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden Brian Kernighan, @command{awk} di
address@hidden @asis
address@hidden Togliere la barra inversa
+Questo @`e quel che sia BWK @command{awk} che @command{gawk} fanno.
+Per esempio, @code{"a\qc"} equivale a @code{"aqc"}.
+(Poich@'e questo @`e un errore che address@hidden capitare o non capitare con
la stessa
address@hidden, @command{gawk} lo segnala).
+Volendo usare come separatore di campo @samp{FS = @w{"[ \t]+\|[ \t]+"}}
+ossia delle barre verticali precedute e seguite da almeno uno spazio,
+occorre mettere due barre inverse nella stringa:
address@hidden = @w{"[ \t]+\\|[ \t]+"}}.)
address@hidden I did this! This is why I added the warning.
+
address@hidden @command{gawk}, sequenze di protezione
address@hidden Unix @command{awk}, barre inverse in sequenze di protezione
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden Tenere la barra inversa address@hidden@dotless{i}} com'@`e.
+Alcune altre implementazioni di @command{awk} fanno questo.
+In quelle implementazioni, immettere @code{"a\qc"} equivale a immettere
address@hidden"a\\qc"}.
address@hidden table
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Barra inversa prima di un carattere normale}
+
+
address@hidden address@hidden, barra inversa in sequenze di protezione
address@hidden POSIX @command{awk}, barre inverse in costanti stringa
address@hidden barra inversa (@code{\}), in sequenze di protezione, POSIX e
address@hidden @code{\} (barra inversa), in sequenze di protezione, POSIX e
+
address@hidden risoluzione di problemi, barra inversa prima di caratteri non
speciali
address@hidden problemi, risoluzione di, barra inversa prima di caratteri non
speciali
+Se si mette una barra inversa in una costante stringa prima di qualcosa che
+non sia uno dei caratteri elencati sopra, POSIX @command{awk} di proposito
+lascia indefinito il comportamento. Ci sono due address@hidden:
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden Brian Kernighan, @command{awk} di
address@hidden @asis
address@hidden Togliere la barra inversa
+Questo @`e quel che sia BWK @command{awk} che @command{gawk} fanno.
+Per esempio, @code{"a\qc"} equivale a @code{"aqc"}.
+(Poich@'e questo @`e un errore che address@hidden capitare o non capitare con
la stessa
address@hidden, @command{gawk} lo segnala).
+Volendo usare come separatore di campo @samp{FS = @w{"[ \t]+\|[ \t]+"}}
+ossia delle barre verticali precedute e seguite da almeno uno spazio,
+occorre mettere due barre inverse nella stringa:
address@hidden = @w{"[ \t]+\\|[ \t]+"}}.)
address@hidden I did this! This is why I added the warning.
+
address@hidden @command{gawk}, sequenze di protezione
address@hidden Unix @command{awk}, barre inverse in sequenze di protezione
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden Tenere la barra inversa address@hidden@dotless{i}} com'@`e.
+Alcune altre implementazioni di @command{awk} fanno questo.
+In quelle implementazioni, immettere @code{"a\qc"} equivale a immettere
address@hidden"a\\qc"}.
address@hidden table
address@hidden cartouche
address@hidden ifnotdocbook
+Ricapitolando:
+
address@hidden @value{BULLET}
address@hidden
+Le sequenze di protezione nella lista di cui sopra sono sempre elaborate
+per prime, sia per le costanti stringa che per le costanti @dfn{regexp}.
Questo
+viene fatto quasi subito, non appena @command{awk} legge il programma.
+
address@hidden
address@hidden elabora sia costanti @dfn{regexp} che @dfn{regexp} dinamiche
+(@pxref{Espressioni regolari calcolate}),
+per gli operatori speciali elencati in
address@hidden di @dfn{regexp} GNU}.
+
address@hidden
+Una barra inversa prima di ogni altro carattere richiede di trattare quel
+carattere letteralmente.
address@hidden itemize
+
address@hidden sidebar, Sequenze di protezione per metacaratteri
address@hidden
address@hidden
+<sidebar><title>Sequenze di protezione per metacaratteri</title>
address@hidden docbook
+
address@hidden metacaratteri, sequenze di protezione per
+
+Supponiamo che si usi una protezione ottale o esadecimale
+per rappresentare un metacarattere di @dfn{regexp}
+(si veda @ref{Operatori di espressioni regolari}).
address@hidden considera il carattere come un carattere letterale o
+come un operatore di @dfn{regexp}?
+
address@hidden angolo buio, sequenze di protezione, per metacaratteri
+Storicamente, tali caratteri erano considerati letteralmente.
address@hidden
+Invece, lo standard POSIX richiede che siano considerati
+come metacaratteri veri e propri, e questo @`e address@hidden che
@command{gawk} fa.
+In address@hidden compatibile (@pxref{Opzioni}),
address@hidden tratta i caratteri scritti come sequenze ottali ed esadecimali
+letteramente, quando sono usati in costanti @dfn{regexp}. Quindi,
address@hidden/a\52b/} @`e equivalente a @code{/a\*b/}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Sequenze di protezione per metacaratteri}
+
+
address@hidden metacaratteri, sequenze di protezione per
+
+Supponiamo che si usi una protezione ottale o esadecimale
+per rappresentare un metacarattere di @dfn{regexp}
+(si veda @ref{Operatori di espressioni regolari}).
address@hidden considera il carattere come un carattere letterale o
+come un operatore di @dfn{regexp}?
+
address@hidden angolo buio, sequenze di protezione, per metacaratteri
+Storicamente, tali caratteri erano considerati letteralmente.
address@hidden
+Invece, lo standard POSIX richiede che siano considerati
+come metacaratteri veri e propri, e questo @`e address@hidden che
@command{gawk} fa.
+In address@hidden compatibile (@pxref{Opzioni}),
address@hidden tratta i caratteri scritti come sequenze ottali ed esadecimali
+letteramente, quando sono usati in costanti @dfn{regexp}. Quindi,
address@hidden/a\52b/} @`e equivalente a @code{/a\*b/}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Operatori di espressioni regolari
address@hidden Operatori di espressioni regolari
address@hidden espressioni regolari, operatori
address@hidden metacaratteri in espressioni regolari
+
address@hidden possibile inserire in espressioni regolari dei caratteri
speciali,
+detti @dfn{operatori di espressioni regolari} o @dfn{metacaratteri}, per
+aumentarne il potere e la address@hidden
+
+Le sequenze di protezione descritte
address@hidden
+prima
address@hidden ifnotinfo
+in @ref{Sequenze di protezione}
+sono valide all'interno di una @dfn{regexp}. Sono precedute da una @samp{\} e
+sono riconosciute e convertite nei caratteri reali corrispondenti nella
+primissima fase dell'elaborazione delle @dfn{regexp}.
+
+Ecco una lista dei metacaratteri. Tutti i caratteri che non sono sequenze
+di protezione e che non sono elencati qui rappresentano se stessi:
+
address@hidden Use @asis so the docbook comes out ok. Sigh.
address@hidden @asis
address@hidden barra inversa (@code{\}), operatore @dfn{regexp}
address@hidden barra inversa (@code{\}), operatore @dfn{regexp}
address@hidden @code{\} (barra inversa), operatore @dfn{regexp}
address@hidden @code{\}
+Si usa per togliere il significato speciale a un carattere quando si effettuano
+confronti. Per esempio, @samp{\$}
+individua il carattere @samp{$}.
+
address@hidden espressioni regolari, ancore nelle
address@hidden Texinfo, inizi di capitolo nei file
address@hidden @code{^} (circonflesso), operatore @dfn{regexp}
address@hidden circonflesso (@code{^}), operatore @dfn{regexp}
address@hidden @code{^}
+Si usa per indicare l'inizio di una stringa. Per esempio, @samp{^@@chapter}
+individua @samp{@@chapter} all'inizio di una stringa e si address@hidden usare
per
+identificare inizi di capitoli in file sorgenti Texinfo.
+Il simbolo @samp{^} @`e conosciuto come @address@hidden, perch@'e @`ancora la
ricerca
+solo all'inizio della stringa.
+
address@hidden importante notare che @samp{^} non individua un inizio di riga
+(il punto subito dopo un ritorno a capo @samp{\n}) che si trovi all'interno
+di una stringa. La condizione non @`e verificata nell'esempio seguente:
+
address@hidden
+if ("riga1\nRIGA 2" ~ /^R/) @dots{}
address@hidden example
+
address@hidden @code{$} (dollaro), operatore @dfn{regexp}
address@hidden dollaro (@code{$}), operatore @dfn{regexp}
address@hidden @code{$}
+Simile a @samp{^}, ma serve a indicare la fine di una stringa.
+Per esempio, @samp{p$}
+individua un record che termina con la lettera @samp{p}. Il @samp{$} @`e
+un'@`ancora e non individua una fine di riga (il punto immediatamente prima
+di un carattere di ritorno a capo @samp{\n})
+contenuta in una stringa.
+La condizione nell'esempio seguente non @`e verificata:
+
address@hidden
+if ("riga1\nRIGA 2" ~ /1$/) @dots{}
address@hidden example
+
address@hidden @code{.} (punto), operatore @dfn{regexp}
address@hidden punto (@code{.}), operatore @dfn{regexp}
address@hidden @code{.} (punto)
+Individua un qualsiasi carattere,
address@hidden il carattere di ritorno a capo. Per esempio, @samp{.P}
+individua ogni carattere in una stringa che sia seguito da una @samp{P}.
+Usando la concatenazione, si address@hidden formare un'espressione regolare
come
address@hidden, che individua qualsiasi sequenza di tre caratteri che inizia con
address@hidden e finisce con @samp{A}.
+
address@hidden POSIX @command{awk}, uso del punto (@code{.})
+In address@hidden POSIX stretta (@pxref{Opzioni}),
address@hidden non individua il carattere @sc{nul},
+ossia il carattere con tutti i bit uguali a zero.
+In altri contesti, @sc{nul} @`e solo un carattere qualsiasi. Altre versioni
+di @command{awk} possono non essere in grado di individuare il carattere
address@hidden
+
address@hidden @code{[]} (parentesi quadre), operatore @dfn{regexp}
address@hidden parentesi quadre (@code{[]}), operatore @dfn{regexp}
address@hidden espressioni tra parentesi
address@hidden insiemi di caratteri, si veda anche espressioni tra parentesi
quadre
address@hidden liste di caratteri, si veda espressioni tra parentesi quadre
address@hidden classi di caratteri, si veda espressioni tra parentesi quadre
address@hidden @address@hidden@code{]}
+Questa @`e chiamata una @dfn{espressione tra parentesi address@hidden
+altri testi, un'espressione tra parentesi quadre potrebbe essere
+definita come @dfn{insieme di caratteri}, @dfn{classe di caratteri} o
+ @dfn{lista di caratteri}.}
+Individua @emph{uno} qualsiasi dei caratteri racchiusi tra
+parentesi quadre. Per esempio, @samp{[MVX]} individua uno qualsiasi
+dei caratteri @samp{M}, @samp{V}, o @samp{X} in una stringa. Una spiegazione
+esauriente di quel che si address@hidden mettere all'interno di un'espressione
tra
+parentesi quadre @`e data in
address@hidden tra parentesi quadre}.
+
address@hidden espressioni tra parentesi quadre, complementate
address@hidden @address@hidden@code{]}
+Questa @`e una @dfn{espressione tra parentesi quadre complementata}. Il primo
+carattere dopo la @samp{[} @emph{deve} essere un @samp{^}. Individua
+qualsiasi carattere
address@hidden quelli tra parentesi quadre. Per esempio, @samp{[^awk]}
+individua qualsiasi carattere che non sia una @samp{a}, @samp{w}, o @samp{k}.
+
address@hidden @code{|} (barra verticale)
address@hidden barra verticale (@code{|})
address@hidden @code{|}
+Questo @`e un @dfn{operatore alternativa} ed @`e usato per specificare delle
+alternative. La @samp{|} ha la precedenza address@hidden bassa tra tutti gli
operatori
+di espressioni regolari. Per esempio, @samp{^P|[aeiouy]} individua tutte le
+stringhe corrispondenti a @samp{^P} oppure a @samp{[aeiouy]}. address@hidden
significa
+che individua qualsiasi stringa che inizi con @samp{P} o contenga (in
+qualsiasi posizione al suo interno) una vocale inglese minuscola.
+
+L'alternativa si applica alle @dfn{regexp} address@hidden ampie individuabili
in ogni
+lato.
+
address@hidden @code{()} (parentesi), operatore @dfn{regexp}
address@hidden parentesi (@code{()}), operatore @dfn{regexp}
address@hidden @code{(address@hidden@code{)}
+Le parentesi sono usate per raggruppare, sia nelle espressioni regolari sia
+in quelle aritmetiche. Si possono usare per concatenare espressioni regolari
+che contengono l'operatore alternativa, @samp{|}. Per esempio,
address@hidden@@(samp|code)address@hidden@address@hidden individua sia
@samp{@@address@hidden@}} sia
address@hidden@@address@hidden@}}.
+(Queste sono sequenze in linguaggio Texinfo per controllare la formattazione.
+Il significato di @samp{+} @`e
+spiegato address@hidden avanti in questa lista.)
+
address@hidden @code{*} (asterisco), operatore @code{*}, come operatore
@dfn{regexp}
address@hidden asterisco (@code{*}), operatore @code{*}, come operatore
@dfn{regexp}
address@hidden @code{*}
+Questo simbolo richiede che la precedente espressione regolare sia
+ripetuta tante volte quanto serve per trovare una corrispondenza. Per
+esempio, @samp{ph*} applica il simbolo
address@hidden al carattere @samp{h} che lo precede immediatamente e ricerca
+corrispondenze costituite da una @samp{p} seguita da un numero qualsiasi di
address@hidden Viene individuata anche solo la @samp{p}, se non ci sono
address@hidden
+
+Ci sono due sfumature da capire sul funzionamento di @samp{*}.
+Primo, @samp{*} tiene conto solo del singolo componente dell'espressione
+regolare che lo precede (p.es., in @samp{ph*} vale solo per @samp{h}).
+Per fare address@hidden@dotless{i}} che @samp{*} si applichi a una
sottoespressione address@hidden estesa,
+occorre metterla tra parentesi:
address@hidden(ph)*} individua @samp{ph}, @samp{phph}, @samp{phphph} e
address@hidden@dotless{i}} via.
+
+Secondo, @samp{*} trova quante address@hidden ripetizioni siano possibili. Se
il testo
+da ricercare @`e @samp{phhhhhhhhhhhhhhooey}, @samp{ph*} individua tutte le
address@hidden
+
address@hidden @code{+} (address@hidden), operatore @dfn{regexp}
address@hidden address@hidden (@code{+}), operatore @dfn{regexp}
address@hidden @code{+}
+Questo simbolo @`e simile a @samp{*}, tranne per il fatto che l'espressione
+precedente deve essere trovata almeno una volta. Questo significa che
address@hidden individuerebbe @samp{why} e @samp{whhy}, ma non @samp{wy}, mentre
address@hidden li troverebbe tutti e tre.
+
address@hidden @code{?} (punto interrogativo), operatore @dfn{regexp}
address@hidden punto interrogativo (@code{?}), operatore @dfn{regexp}
address@hidden @code{?}
+Questo simbolo @`e simile a @samp{*}, tranne per il fatto che l'espressione che
+precede address@hidden essere trovata una volta sola oppure non trovata
+affatto. Per esempio, @samp{fe?d}
+individua @samp{fed} e @samp{fd}, ma nient'altro.
+
address@hidden espressioni di intervallo, (@dfn{regexp})
address@hidden @address@hidden@address@hidden@}}
address@hidden @address@hidden@address@hidden,@}}
address@hidden @address@hidden@address@hidden,address@hidden@address@hidden
+Uno o due numeri tra parentesi graffe rappresentano una
address@hidden di intervallo}.
+Se c'@`e un numero tra graffe, la @dfn{regexp} precedente @`e ripetuta
address@hidden volte.
+Se ci sono due numeri separati da una virgola, la @dfn{regexp} precedente @`e
+ripetuta da @var{n} a @var{m} volte.
+Se c'@`e un numero seguito da una virgola, allora la @dfn{regexp} precedente
address@hidden ripetuta almeno @var{n} volte:
+
address@hidden @code
address@hidden address@hidden@}y
+Riconosce @samp{whhhy}, ma non @samp{why} o @samp{whhhhy}.
+
address@hidden address@hidden,address@hidden
+Riconosce soltanto @samp{whhhy}, @samp{whhhhy}, o @samp{whhhhhy}.
+
address@hidden address@hidden,@}y
+Riconosce @samp{whhy}, @samp{whhhy} e address@hidden@dotless{i}} via.
address@hidden table
+
address@hidden POSIX @command{awk}, espressioni di intervallo in
+Le espressioni di intervallo non erano tradizionalmente disponibili in
address@hidden Sono state aggiunte come parte dello standard POSIX per
+rendere @command{awk} ed @command{egrep} coerenti tra di loro.
+
address@hidden @command{gawk}, espressioni di intervallo e
+In passato, poich@'e vecchi programmi possono usare @address@hidden e
@address@hidden in
+costanti @dfn{regexp},
address@hidden @emph{non} riconosceva espressioni di intervallo
+nelle @dfn{regexp}.
+
+Comunque, a partire dalla @value{PVERSION} 4.0,
address@hidden riconosce espressioni di intervallo per default.
address@hidden accade perch@'e la address@hidden con POSIX @`e ritenuta
address@hidden
+importante da molti utenti @command{gawk} rispetto alla address@hidden con
+dei vecchi programmi.
+
+Per programmi che usano @address@hidden e @address@hidden in costanti
@dfn{regexp},
address@hidden buona pratica proteggerli sempre con una barra inversa. Allora
le
+costanti @dfn{regexp} sono valide e si comportano come desiderato, usando
+qualsiasi versione di @address@hidden@`E meglio usare due barre inverse
+se si sta usando una costante stringa con un operatore @dfn{regexp} o una
+funzione.}
+
+Infine, quando @address@hidden e @address@hidden appaiono in costanti
@dfn{regexp}
+in un modo non interpretabile come espressione di intervallo
+(come in @code{/address@hidden@}/}), allora sono prese letteralmente.
address@hidden table
+
address@hidden precedenza, operatore @dfn{regexp}
address@hidden espressioni regolari, operatori, precedenza di
+Nelle espressioni regolari, gli operatori @samp{*}, @samp{+}, e @samp{?},
+come pure le parentesi graffe @address@hidden e @address@hidden,
+hanno
+la precedenza address@hidden alta, seguiti dalla concatenazione, e infine da
@samp{|}.
+Come nell'algebra, le parentesi possono cambiare il raggruppamento degli
+operatori.
address@hidden POSIX @command{awk}, espressioni regolari e
address@hidden @command{gawk}, espressioni regolari, precedenza
+In POSIX @command{awk} e in @command{gawk}, gli operatori @samp{*},
address@hidden, e @samp{?} rappresentano se stessi quando non c'@`e nulla
+nella @dfn{regexp} che li precede. Per esempio, @code{/+/} individua un
+semplice segno address@hidden Comunque, molte altre versioni di @command{awk}
+trattano una simile notazione come un errore di sintassi.
+
+Se @command{gawk} @`e in address@hidden compatibile (@pxref{Opzioni}), le
espressioni
+di intervallo non si possono usare nelle espressioni regolari.
+
address@hidden Espressioni tra parentesi quadre
address@hidden Usare espressioni tra parentesi quadre
address@hidden espressioni tra parentesi quadre
address@hidden espressioni tra parentesi quadre, espressioni di intervallo
address@hidden espressioni di intervallo, (@dfn{regexp})
address@hidden elenchi di caratteri in un'espressione regolare
address@hidden caratteri, elenchi di, in un'espressione regolare
+
+Come detto sopra, un'espressione tra parentesi quadre individua qualsiasi
+carattere incluso tra le parentesi quadre aperta e chiusa.
+
+All'interno di un'espressione tra parentesi quadre, una
address@hidden di intervallo} @`e formata da due caratteri separati da un
+trattino. Individua ogni singolo carattere compreso tra i due caratteri,
+ordinati secondo l'insieme di caratteri in uso nel sistema. Per esempio,
address@hidden @`e equivalente a @samp{[0123456789]}.
+(Si veda @ref{Intervalli e localizzazione} per una spiegazione di come
+lo standard POSIX e @command{gawk} sono cambiati nel corso degli anni.
+La cosa ha un interesse principalmente storico.)
+
+Con la crescente address@hidden dello
address@hidden://www.unicode.org, standard di caratteri Unicode},
+c'@`e un'ulteriore dettaglio da tenere in conto. Le sequenze di
+protezione ottali ed esadecimali utilizzabili per inserire
+valori all'interno di espressioni tra parentesi quadre
+sono considerate contenere solo caratteri
+che occupano un unico byte (caratteri il cui valore stia
+nell'intervallo 0--256). Per individuare un intervallo di
+caratteri in cui i punti di inizio e fine dell'intervello
+abbiano valori maggiori di 256, occorre immettere direttamente
+le codifiche multi-byte dei caratteri in questione.
+
address@hidden @code{\} (barra inversa), in espressioni tra parentesi quadre
address@hidden barra inversa (@code{\}), in espressioni tra parentesi quadre
address@hidden @code{^} (circonflesso), in espressioni tra parentesi quadre
address@hidden circonflesso (@code{^}), in espressioni tra parentesi quadre
address@hidden @code{-} (meno), in espressioni tra parentesi quadre
address@hidden meno (@code{-}), in espressioni tra parentesi quadre
+Per includere uno dei caratteri @samp{\}, @samp{]}, @samp{-}, o @samp{^} in
+un'espressione tra parentesi quadre, occorre inserire un @samp{\} prima del
+carattere stesso. Per esempio:
+
address@hidden
+[d\]]
address@hidden example
+
address@hidden
+individua sia @samp{d} che @samp{]}.
+Inoltre, se si mette una @samp{]} subito dopo la
address@hidden aperta, la parentesi quadra chiusa @`e considerata come uno dei
+caratteri da individuare.
+
address@hidden POSIX @command{awk}, espressioni tra parentesi quadre e
address@hidden espressioni regolari estese (ERE)
address@hidden ERE (espressioni regolari estese)
address@hidden @command{egrep}, programma di address@hidden
address@hidden programma di address@hidden @command{egrep}
+L'utilizzo di @samp{\} nelle espressioni tra parentesi quadre
address@hidden compatibile con altre implementazioni di @command{awk} ed @`e
anche richiesto
+da POSIX.
+Le espressioni regolari in @command{awk} sono un insieme address@hidden esteso
delle
+specificazioni POSIX per le espressioni regolari estese (ERE).
+Le ERE POSIX sono basate sulle espressioni regolari accettate dal
+tradizionale programma di address@hidden @command{egrep}.
+
address@hidden espressioni tra parentesi quadre, classi di caratteri
address@hidden POSIX @command{awk}, espressioni tra parentesi quadre e, classi
di caratteri
+Le @dfn{classi di caratteri} sono una address@hidden introdotta nello standard
+POSIX. Una classe di caratteri @`e una particolare notazione per descrivere
+liste di caratteri cha hanno un attributo specifico, ma i caratteri
+veri e propri possono variare da paese a paese e/o
+da insieme di caratteri a insieme di caratteri. Per esempio, la nozione di
+cosa sia un carattere alfabetico @`e diversa tra gli Stati Uniti e la Francia.
+
+Una classe di caratteri @`e valida solo in una @dfn{regexp} @emph{contenuta}
+tra le parentesi quadre di un'espressione tra parentesi quadre. Le classi di
+caratteri consistono di @samp{[:},
+una parola chiave che segnala la classe, e @samp{:]}. La
address@hidden elenca le classi di caratteri definite dallo
+standard POSIX.
+
address@hidden Tabella,tabella-caratteri-classe
address@hidden di caratteri POSIX}
address@hidden @columnfractions .15 .85
address@hidden Classe @tab Significato
address@hidden @code{[:alnum:]} @tab Caratteri alfanumerici.
address@hidden @code{[:alpha:]} @tab Caratteri alfabetici.
address@hidden @code{[:blank:]} @tab Caratteri spazio e TAB.
address@hidden @code{[:cntrl:]} @tab Caratteri di controllo.
address@hidden @code{[:digit:]} @tab Caratteri numerici.
address@hidden @code{[:graph:]} @tab Caratteri che sono stampabili e visibili.
+(Uno @dfn{spazio} @`e stampabile ma non visibile, mentre una @samp{a} @`e
l'uno e
+l'altro.)
address@hidden @code{[:lower:]} @tab Caratteri alfabetici minuscoli.
address@hidden @code{[:print:]} @tab Caratteri stampabili (caratteri che non
sono
+caratteri di controllo).
address@hidden @code{[:punct:]} @tab Caratteri di punteggiatura (caratteri che
non
+sono lettere, cifre, caratteri di controllo, o caratteri di spazio).
address@hidden @code{[:space:]} @tab Caratteri di spazio (come @dfn{spazio},
TAB, e
address@hidden, per citarne alcuni).
address@hidden @code{[:upper:]} @tab Caratteri alfabetici maiuscoli.
address@hidden @code{[:xdigit:]} @tab Caratteri che sono cifre esadecimali.
address@hidden multitable
address@hidden float
+
+Per esempio, prima dello standard POSIX, si doveva scrivere
address@hidden/[A-Za-z0-9]/} per individuare i
+caratteri alfanumerici. Se l'insieme
+di caratteri in uso comprendeva altri caratteri alfabetici, l'espressione
+non li avrebbe individuati.
+Con le classi di caratteri POSIX si address@hidden scrivere
address@hidden/[[:alnum:]]/} per designare i caratteri alfabetici e numerici
+dell'insieme di caratteri in uso.
+
address@hidden Thanks to
address@hidden Date: Tue, 01 Jul 2014 07:39:51 +0200
address@hidden From: Hermann Peifer <address@hidden>
+Alcuni programmi di address@hidden che cercano espressioni regolari prevedono
+una classe di caratteri, non standard,
address@hidden:ascii:]}; @command{awk} non la prevede. Tuttavia, @`e possibile
ottenere
+lo stesso risultato utilizzando @samp{[\x00-\x7F]}. Quest'espressione
+individua tutti i valori numerici tra zero e 127, che @`e l'intervallo definito
+dell'insieme di caratteri ASCII. Usando una lista di caratteri che esclude
+(@samp{[^\x00-\x7F]}) si individuano tutti i caratteri mono-byte che non
+sono nell'intervallo ASCII.
+
address@hidden espressioni tra parentesi quadre, elementi di collazione
address@hidden espressioni tra parentesi quadre, non-ASCII
address@hidden elementi di collazione
+In espressioni tra parentesi quadre possono apparire due ulteriori sequenze
+speciali. Riguardano insiemi di caratteri non-ASCII, che possono avere
+simboli singoli (chiamati @dfn{elementi di collazione}) che sono rappresentati
+con address@hidden di un carattere. Possono designare anche parecchi
caratteri che sono
+equivalenti tra loro ai fini della @dfn{collazione}, o dell'ordinamento.
+(Per esempio, in francese, la semplice ``e'' e la sua versione con accento
grave address@hidden''
+sono equivalenti). Queste sequenze sono:
+
address@hidden @asis
address@hidden espressioni tra parentesi quadre, elementi di collazione
address@hidden elementi di collazione
address@hidden elementi di collazione
+Elementi di collazione multi-byte racchiusi fra
address@hidden e @samp{.]}. Per esempio, se @samp{ch} @`e un elemento di
collazione,
address@hidden @`e una @dfn{regexp} che individua questo elemento di
+collazione, mentre @samp{[ch]} @`e una @dfn{regexp} che individua le lettere
address@hidden o @samp{h}.
+
address@hidden espressioni tra parentesi quadre, classi di equivalenza
address@hidden classi di equivalenza
+Sono nomi, specifici a una particolare localizzazione, per una lista di
+caratteri equivalenti tra loro. Il nome @`e racchiuso fra
address@hidden e @samp{=]}.
+Per esempio, il nome @samp{e} potrebbe essere usato per designare
+``e'', address@hidden'', address@hidden'', e ``@'e''. In questo caso,
@samp{[[=e=]]} @`e una @dfn{regexp}
+che corrisponde a @samp{e}, @address@hidden, @address@hidden e @samp{@'e}.
address@hidden table
+
+Queste address@hidden sono molto utili in localizzazioni non inglesi.
+
address@hidden internazionalizzazione, localizzazione, classi di caratteri
address@hidden @command{gawk}, classi di caratteri e
address@hidden POSIX @command{awk}, espressioni tra parentesi quadre e, classi
di caratteri
address@hidden ATTENZIONE
+Le funzioni di libreria che @command{gawk} usa per individuare le espressioni
+regolari per ora riconoscono solo le classi di caratteri POSIX;
+non riconoscono simboli di collazione o classi di equivalenza.
address@hidden quotation
address@hidden maybe one day ...
+
+In un'espressione tra parentesi quadre, una parentesi aperta (@samp{[})
+che non costituisca l'inizio della specificazione di una classe di
+caratteri, di simboli di collazione o di una classe di equivalenza
address@hidden interpretata letteralmente. Questo vale anche per @samp{.} e
@samp{*}.
+
address@hidden address@hidden lungo da sinistra
address@hidden Quanto @`e lungo il testo individuato?
+
address@hidden espressioni regolari, corrispondenza address@hidden a sinistra
address@hidden @cindex matching, leftmost longest
+Si consideri il caso seguente:
+
address@hidden
+echo aaaabcd | awk '@{ sub(/a+/, "<A>"); print @}'
address@hidden example
+
+Questo esempio usa la funzione @code{sub()} per modificare il record in input.
+(@code{sub()} sostituisce la prima ricorrenza in ogni testo individuato dal
+primo argomento con la stringa fornita come secondo argomento;
address@hidden per stringhe}.) Qui, la @dfn{regexp} @code{/a+/} richiede
+``uno o address@hidden caratteri @samp{a},'' e il testo da sostituire @`e
@samp{<A>}.
+
+L'input contiene quattro caratteri @samp{a}.
+Le espressioni regolari @command{awk} (e POSIX) individuano sempre
+la sequenza @address@hidden lunga}, partendo da sinistra, di caratteri in
input che
+corrispondono. Quindi, tutti e quattro i caratteri @samp{a} sono
+rimpiazzati con @samp{<A>} in questo esempio:
+
address@hidden
+$ @kbd{echo aaaabcd | awk '@{ sub(/a+/, "<A>"); print @}'}
address@hidden <A>bcd
address@hidden example
+
+Per semplici test corrisponde/non corrisponde, la cosa ha poca importanza.
+Ma se si sta controllando un testo o si fanno sostituzioni usando le funzioni
address@hidden()}, @code{sub()}, @code{gsub()} e @code{gensub()},
address@hidden invece molto importante.
address@hidden
address@hidden per stringhe},
+Per maggiori informazioni su queste funzioni.
address@hidden ifinfo
+Tenere in conto questo principio @`e importante anche quando si suddividono
+record e campi usando delle @dfn{regexp} (@pxref{Record},
+e anche @pxref{Separatori di campo}).
+
address@hidden Espressioni regolari calcolate
address@hidden Usare @dfn{regexp} dinamiche
+
address@hidden espressioni regolari calcolate
address@hidden espressioni regolari dinamiche
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @cindex operators, @code{~}
address@hidden @cindex operators, @code{!~}
+L'espressione a destra di un operatore @samp{~} o @samp{!~} non deve
+necessariamente essere una costante @dfn{regexp} (address@hidden, una stringa
di
+caratteri tra barre). address@hidden essere una qualsiasi
+espressione. L'espressione @`e valutata e convertita in una stringa
+se necessario; il contenuto della stringa @`e poi usato come una @dfn{regexp}.
+Una @dfn{regexp} calcolata in questo modo @`e detta una @dfn{regexp dinamica}
+o una @dfn{regexp calcolata}:
+
address@hidden
+BEGIN @{ @dfn{regexp}_numerica = "[[:digit:]]+" @}
+$0 ~ @dfn{regexp}_numerica @{ print @}
address@hidden example
+
address@hidden
+Questo @dfn{script} imposta @code{regexp_numerica} come una @dfn{regexp} che
+descrive una o address@hidden cifre, e poi controlla se un record in input
corrisponde a
+questa regexp.
+
address@hidden NOTA
+Usando gli operatori @samp{~} e @samp{!~}, si tenga presente che c'@`e
+una differenza tra una costante @dfn{regexp} racchiusa tra barre e una
+costante stringa racchiusa tra doppi apici.
+Se si intende utilizzare una costante stringa, occorre comprendere che
+la stringa @`e, in sostanza, scandita @emph{due volte}: la prima volta quando
address@hidden legge il programma, e la seconda volta quando va a
+confrontare la stringa a sinistra dell'operatore con il modello che sta
+alla sua destra. Questo vale per ogni espressione (come la
address@hidden, vista nel precedente esempio), non solo per le
+costanti stringa.
address@hidden quotation
+
address@hidden costanti @dfn{regexp}, barre vs.@: doppi apici
address@hidden @code{\} (barra inversa), in costanti @dfn{regexp}
address@hidden barra inversa (@code{\}), in costanti @dfn{regexp}
address@hidden @code{"} (doppio apice), in costanti @dfn{regexp}
address@hidden doppio apice (@code{"}), in costanti @dfn{regexp}
+Che differenza fa la doppia scansione di una stringa?
+La risposta ha a che vedere con le sequenze di protezione e particolarmente
+con le barre inverse. Per inserire una barra inversa in un'espressione
+regolare all'interno di una stringa, occorre inserire @emph{due} barre
+inverse.
+
+Per esempio, @code{/\*/} @`e una costante @dfn{regexp} per designare un
@samp{*}
+letterale.
address@hidden richiesta una sola barra inversa. Per fare lo stesso con una
stringa,
+occorre immettere @code{"\\*"}. La prima barra inversa protegge la
+seconda in modo che la stringa in address@hidden contenga i
+due caratteri @samp{\} e @samp{*}.
+
address@hidden risoluzione di problemi, costanti @dfn{regexp} vs.@: costanti
stringa
address@hidden problemi, risoluzione di, costanti @dfn{regexp} vs.@: costanti
stringa
address@hidden costanti @dfn{regexp}, vs.@: costanti stringa
address@hidden costanti stringa, vs.@: costanti @dfn{regexp}
+Dato che si possono usare sia costanti @dfn{regexp} che costanti stringa per
+descrivere espressioni regolari, qual @`e da preferire? La risposta @`e
+``costanti @dfn{regexp}'', per molti motivi:
+
address@hidden @value{BULLET}
address@hidden
+Le costanti stringa sono address@hidden complicate da scrivere e
address@hidden difficili
+da leggere. Usare costanti @dfn{regexp} rende i programmi
+meno inclini all'errore. Non comprendere la differenza tra i due tipi di
+costanti @`e una fonte frequente di errori.
+
address@hidden
address@hidden address@hidden efficiente usare costanti @dfn{regexp}.
@command{awk} address@hidden accorgersi
+che @`e stata fornita una @dfn{regexp} e memorizzarla internamente in una forma
+che rende la ricerca di corrispondenze address@hidden efficiente. Se si usa
una costante
+stringa, @command{awk} deve prima convertire la stringa nel suo formato
+interno e quindi eseguire la ricerca di corrispondenze.
+
address@hidden
+Usare costanti @dfn{regexp} @`e la forma migliore; lascia comprendere
+chiaramente che si vuole una corrispondenza con una @dfn{regexp}.
address@hidden itemize
+
address@hidden sidebar, Usare @code{\n} in espressioni tra parentesi quadre in
@dfn{regexp} dinamiche
address@hidden
address@hidden
+<sidebar><title>Usare @code{\n} in espressioni tra parentesi quadre in
@dfn{regexp} dinamiche</title>
address@hidden docbook
+
address@hidden espressioni regolari dinamiche, contenenti dei ritorni a capo
address@hidden ritorno a capo, in @dfn{regexp} dinamiche
+
+Alcune delle prime versioni di @command{awk} non consentono di usare il
+carattere di ritorno
+a capo all'interno di un'espressione tra parentesi quadre in @dfn{regexp}
+dinamiche:
+
address@hidden
+$ @kbd{awk '$0 ~ "[ \t\n]"'}
address@hidden awk: newline in character class [
address@hidden ]...
address@hidden source line number 1
address@hidden context is
address@hidden $0 ~ "[ >>> \t\n]" <<<
address@hidden example
+
address@hidden ritorno a capo, in costanti @dfn{regexp}
+Ma un ritorno a capo in una costante @dfn{regexp} non address@hidden alcun
problema:
+
address@hidden
+$ @kbd{awk '$0 ~ /[ \t\n]/'}
address@hidden una riga di esempio}
address@hidden ecco una riga di esempio
address@hidden
address@hidden example
+
address@hidden non ha questo problema, e non dovrebbe accadere spesso
+in pratica, ma val la pena di notarlo a futura memoria.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Usare @code{\n} in espressioni tra parentesi quadre in
@dfn{regexp} dinamiche}
+
+
address@hidden espressioni regolari dinamiche, contenenti dei ritorni a capo
address@hidden ritorno a capo, in @dfn{regexp} dinamiche
+
+Alcune delle prime versioni di @command{awk} non consentono di usare il
+carattere di ritorno
+a capo all'interno di un'espressione tra parentesi quadre in @dfn{regexp}
+dinamiche:
+
address@hidden
+$ @kbd{awk '$0 ~ "[ \t\n]"'}
address@hidden awk: newline in character class [
address@hidden ]...
address@hidden source line number 1
address@hidden context is
address@hidden $0 ~ "[ >>> \t\n]" <<<
address@hidden example
+
address@hidden ritorno a capo, in costanti @dfn{regexp}
+Ma un ritorno a capo in una costante @dfn{regexp} non address@hidden alcun
problema:
+
address@hidden
+$ @kbd{awk '$0 ~ /[ \t\n]/'}
address@hidden una riga di esempio}
address@hidden ecco una riga di esempio
address@hidden
address@hidden example
+
address@hidden non ha questo problema, e non dovrebbe accadere spesso
+in pratica, ma val la pena di notarlo a futura memoria.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Operatori di @dfn{regexp} GNU
address@hidden Operatori @dfn{regexp} propri di @command{gawk}
+
address@hidden This section adapted (long ago) from the regex-0.12 manual
+
address@hidden espressioni regolari, operatori, @command{gawk}
address@hidden @command{gawk}, espressioni regolari, operatori
address@hidden operatori, specifici per GNU
address@hidden espressioni regolari, operatori, per parole
address@hidden parola, definizione in @dfn{regexp}
+Il software GNU che ha a che fare con espressioni regolari comprende alcuni
+operatori @dfn{regexp} aggiuntivi. Questi
+operatori sono descritti in
address@hidden
+questa
address@hidden ifnotinfo
address@hidden
+questo
address@hidden ifinfo
address@hidden e sono specificamente
+per @command{gawk}; non sono disponibili in altre implementazioni di
address@hidden
+La maggior parte degli operatori aggiuntivi riguarda l'identificazione di
+parole. Ai nostri fini, una @dfn{parola} @`e una sequenza di uno o
address@hidden lettere,
+cifre, o trattini bassi (@samp{_}):
+
address@hidden @code
address@hidden @cindex operatori, @code{\s} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\s}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\s}, operatore (@command{gawk})
address@hidden \s
+Corrisponde a ogni carattere bianco.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[[:space:]]}}.
+
address@hidden @cindex operatori, @code{\S} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\S}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\S}, operatore (@command{gawk})
address@hidden \S
+Corrisponde a ogni carattere che non @`e uno spazio bianco.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[^[:space:]]}}.
+
address@hidden @cindex operatori, @code{\w} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\w}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\w}, operatore (@command{gawk})
address@hidden \w
+Corrisponde a ogni carattere che componga una parola; ovvero, corrisponde a
+ogni lettera, cifra, o trattino basso.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[[:alnum:]_]}}.
+
address@hidden @cindex operatori, @code{\W} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\W}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\W}, operatore (@command{gawk})
address@hidden \W
+Corrisponde a ogni carattere che non @`e parte di una parola.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[^[:alnum:]_]}}.
+
address@hidden @cindex operatori, @code{\<} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\<}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\<}, operatore (@command{gawk})
address@hidden \<
+Individua la stringa nulla all'inizio di una parola.
+Per esempio, @code{/\<via/} individua @samp{via} ma non
address@hidden
+
address@hidden @cindex operatori, @code{\>} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\>}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\>}, operatore (@command{gawk})
address@hidden \>
+Individua la stringa nulla alla fine di una parola.
+Per esempio, @code{/via\>/} individua @samp{via} ma non @samp{viadotto}.
+
address@hidden @cindex operatori, @code{\y} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\y}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\y}, operatore (@command{gawk})
address@hidden limite-di-parola, individuare il
address@hidden \y
+Individua la stringa nulla o alla fine o all'inizio di una parola.
+(address@hidden, il limite di una parola - @address@hidden in inglese).
+Per esempio, @samp{\yradar?\y}
+individua sia @samp{rada} che @samp{radar}, come parole separate.
+
address@hidden @cindex operatori, @code{\B} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\B}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\B}, operatore (@command{gawk})
address@hidden \B
+Individua la stringa nulla che ricorre all'interno di una parola.
+Per esempio,
address@hidden/\Bora\B/} individua @samp{Colorado}, ma non individua @samp{che
ora @`e}.
address@hidden @`e essenzialmente l'opposto di @samp{\y}.
address@hidden table
+
address@hidden buffer, operatori per
address@hidden espressioni regolari, operatori, per buffer
address@hidden operatori, ricerca in stringhe, per buffer
+Ci sono due altri operatori che operano sui buffer. In Emacs un
address@hidden @`e, naturalmente, un buffer di Emacs. In altri programmi GNU,
+fra cui @command{gawk}, le routine di libreria delle @dfn{regexp} considerano
+come buffer l'intera stringa su cui effettuare il confronto.
+Gli operatori sono:
+
address@hidden @code
address@hidden \`
address@hidden @cindex operatori, @code{\`} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\`}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\`}, operatore (@command{gawk})
+Individua la stringa nulla che occorre all'inizio di un buffer
+(di una stringa)
+
address@hidden @cindex operatori, @code{\'} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\'}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\'}, operatore (@command{gawk})
address@hidden \'
+Individua la stringa nulla che occorre alla fine di un buffer
+(di una stringa)
address@hidden table
+
address@hidden @code{^} (circonflesso), operatore @dfn{regexp}
address@hidden circonflesso (@code{^}), operatore @dfn{regexp}
address@hidden @code{?} (punto interrogativo), operatore @dfn{regexp}
address@hidden punto interrogativo (@code{?}), operatore @dfn{regexp}
+Poich@'e @samp{^} e @samp{$} si riferiscono sempre all'inizio e alla
+fine di stringhe, questi operatori non aggiungono nuove address@hidden
+ad @command{awk}. Sono inclusi per address@hidden con altro
+software GNU.
+
address@hidden @command{gawk}, operatore limite-di-parola
address@hidden limite-di-parola, operatore (@command{gawk})
address@hidden operatori, limite-di-parola (@command{gawk})
+In altro software GNU, l'operatore di limite-di-parola @`e @samp{\b}. Questo,
+comunque, @`e in conflitto con la definizione, nel linguaggio @command{awk},
+di @samp{\b} come
+backspace, quindi @command{gawk} usa una lettera differente.
+Un metodo alternativo sarebbe stato di richiedere due barre inverse negli
+operatori GNU, ma questo @`e stato ritenuto troppo arzigogolato. Il metodo
+corrente di usare @samp{\y} al posto del @samp{\b} di GNU sembra essere
+il male minore.
+
address@hidden espressioni regolari, @command{gawk}, opzioni sulla riga di
comando
address@hidden @command{gawk}, opzioni sulla riga di comando, ed espressioni
regolari
+Le varie opzioni sulla riga di comando
+(@pxref{Opzioni})
+controllano come @command{gawk} interpreta i caratteri nelle @dfn{regexp}:
+
address@hidden @asis
address@hidden Nessuna opzione
+Per default, @command{gawk} fornisce tutte le address@hidden delle
+regexp POSIX e gli
+operatori @dfn{regexp} GNU
address@hidden
+predecentemente descritti.
address@hidden ifnotinfo
address@hidden
address@hidden
+Sono descritti
+in @ref{Operatori di espressioni regolari}.
address@hidden ifnotdocbook
address@hidden ifnottex
+
address@hidden @code{--posix}
+Sono ammesse solo le @dfn{regexp} POSIX; gli operatori GNU non sono
+speciali (p.es., @samp{\w} individua una semplice lettera @samp{w}).
+Le espressioni di intervallo sono ammesse.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden @code{--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.
+I caratteri descritti usando sequenze di protezione ottali ed esadecimali sono
+trattati letteralmente, anche se rappresentano metacaratteri di @dfn{regexp}.
+
address@hidden @code{--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.
address@hidden table
+
address@hidden Maiuscolo-Minuscolo
address@hidden Fare confronti ignorando maiuscolo/minuscolo
+
address@hidden espressioni regolari, maiuscolo/minuscolo
address@hidden @dfn{regexp}, maiuscolo/minuscolo
address@hidden maiuscolo/minuscolo e @dfn{regexp}
+Il tipo di carattere (maiuscolo/minuscolo) @`e normalmente rilevante nelle
+espressioni regolari, sia nella ricerca di
+caratteri normali (address@hidden, non metacaratteri), sia all'interno di
espressioni
+fra parentesi. Quindi, una @samp{w} in un'espressione regolare individua
+solo una @samp{w} e non la corrispondente maiuscola @samp{W}.
+
+Il modo address@hidden semplice per richiedere una ricerca non sensibile al
+maiuscolo/minuscolo @`e di usare un'espressione tra parentesi quadre, per
+esempio @samp{[Ww]}. Comunque, questo address@hidden essere pesante se si usa
spesso,
+e address@hidden rendere le espressioni regolari di difficile lettura.
+Ci sono due alternative che potrebbero essere preferibili.
+
+Un modo per fare un confronto non sensibile a maiuscolo/minuscolo in un
+particolare punto del programma
address@hidden di convertire i dati in un solo tipo (o minuscole o maiuscole),
+usando le funzioni di stringa
+predefinite @code{tolower()} o @code{toupper()} (che non
+abbiamo ancora introdotto;
address@hidden per stringhe}).
+Per esempio:
+
address@hidden
+tolower($1) ~ /foo/ @{ @dots{} @}
address@hidden example
+
address@hidden
+converte il primo campo in minuscole, prima di fare un confronto.
+Questo funziona in ogni @command{awk} conforme allo standard POSIX.
+
address@hidden @command{gawk}, espressioni regolari, differenza
maiuscolo/minuscolo
address@hidden distinzione maiuscolo/minuscolo, @command{gawk}
address@hidden differenze tra @command{awk} e @command{gawk}, espressioni
regolari
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @code{IGNORECASE}, variabile, con operatori @code{~} e @code{!~}
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden @cindex variables, @code{IGNORECASE}
+Un altro metodo, proprio di @command{gawk}, @`e di impostare la variabile
address@hidden a un valore diverso da zero (@pxref{Variabili predefinite}).
+Quando @code{IGNORECASE} @`e diverso da zero, @emph{tutte} le operazioni con
+regexp e stringhe ignorano la distinzione maiuscolo/minuscolo.
+
+Il cambio del valore di @code{IGNORECASE} controlla dinamicamente la
address@hidden a maiuscolo/minuscolo del programma quando @`e in esecuzione.
+Il tipo di carattere (maiuscolo/minuscolo) @`e rilevante per default,
+poich@'e @code{IGNORECASE} (come la maggior parte delle variabili) @`e
+inizializzata a zero:
+
address@hidden
+x = "aB"
+if (x ~ /ab/) @dots{} # questo test non address@hidden verificato
+
+IGNORECASE = 1
+if (x ~ /ab/) @dots{} # adesso address@hidden verificato
address@hidden example
+
+In generale, non @`e possibile usare @code{IGNORECASE} per rendere certe regole
+non sensibili a maiuscolo/minuscolo e altre regole invece
address@hidden@dotless{i}}, perch@'e non c'@`e
+una maniera diretta per impostare
address@hidden solo per l'espressione di
+una particolare address@hidden esperti in C e C++ noteranno
+che questo @`e possible, usando qualcosa come
address@hidden = 1 && /foObAr/ @{ @dots{} @}}
+e
address@hidden = 0 || /foobar/ @{ @dots{} @}}.
+Comunque, questo @`e un po' tortuoso e non @`e raccomandato.}
+Per fare questo, si usino espressioni tra parentesi quadre oppure
address@hidden()}. Comunque, una cosa che si address@hidden fare con
@code{IGNORECASE}
+soltanto @`e di utilizzare o di ignorare la address@hidden a
maiuscolo/minuscolo
+per tutte le regole contemporaneamente.
+
address@hidden @`e impostabile dalla riga di comando o in una regola
address@hidden (@pxref{Altri argomenti}; e
address@hidden BEGIN/END}).
+Impostare @code{IGNORECASE} dalla riga di comando @`e un modo per rendere
+un programma insensibile a maiuscolo/minuscolo senza doverlo modificare.
+
address@hidden @cindex ISO 8859-1
address@hidden @cindex ISO Latin-1
+In localizzazioni multibyte,
+le equivalenze tra caratteri maiuscoli
+e minuscoli sono controllate usando i valori in formato esteso
+dell'insieme di caratteri della localizzazione.
+Per il resto, i caratteri sono controllati usando l'insieme di caratteri
+ISO-8859-1 (ISO Latin-1).
+Questo insieme di caratteri @`e un'estensione del tradizionale insieme con 128
+caratteri ASCII, che include anche molti caratteri adatti
+per le lingue address@hidden questo sembra oscuro,
+non c'@`e ragione di preoccuparsi; significa solo che @command{gawk} fa
+la cosa giusta.}
+
+Il valore di @code{IGNORECASE} non ha effetto se @command{gawk} @`e in
address@hidden compatibile (@pxref{Opzioni}).
+Il tipo di carattere (maiuscolo o minuscolo) @`e sempre rilevante in
address@hidden
+compatibile.
+
address@hidden Sommario espressioni regolari
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Le espressioni regolari descrivono insiemi di stringhe da confrontare.
+In @command{awk}, le costanti @dfn{regexp} sono scritte racchiuse
+fra barre: @code{/address@hidden@code{/}.
+
address@hidden
+Le costanti @dfn{regexp} possono essere usate da sole in modelli di ricerca e
+in espressioni condizionali, o come parte di espressioni di ricerca
+usando gli operatori @samp{~} e @samp{!~}.
+
address@hidden
+Le sequenze di protezione consentono di rappresentare caratteri non stampabili
+e consentono anche di rappresentare metacaratteri @dfn{regexp} come caratteri
+letterali per i quali cercare corrispondenze.
+
address@hidden
+Gli operatori @dfn{regexp} consentono raggruppamento, alternativa e
+ripetizione.
+
address@hidden
+Le espressioni tra parentesi quadre sono delle notazioni abbreviate per
+specificare insiemi di caratteri che possono avere corrispondenze in un
+punto particolare di una @dfn{regexp}.
+All'interno di espressioni tra parentesi quadre, le classi di caratteri POSIX
+consentono di specificare certi gruppi di caratteri in maniera indipendente
+dalla localizzazione.
+
address@hidden
+Le espressioni regolari individuano il testo address@hidden lungo possibile, a
partire
+da sinistra nella stringa in esame. Questo ha importanza nei casi in cui
+serve conoscere la lunghezza della corrispondenza, come nella sostituzione di
+testo e quando il separatore di record sia una @dfn{regexp}.
+
address@hidden
+Espressioni di ricerca possono usare @dfn{regexp} dinamiche, ossia, i valori
+delle stringhe sono considerato come espressioni regolari.
+
address@hidden
+La variabile @command{gawk} @code{IGNORECASE} consente di controllare la
+differenza maiuscolo/minuscolo nel confronto mediante @dfn{regexp}. In altre
+versioni di @command{awk}, vanno usate invece le funzioni @code{tolower()} o
address@hidden()}.
+
address@hidden itemize
+
address@hidden Leggere file
address@hidden Leggere file in input
+
address@hidden leggere file in input
address@hidden file in input, leggere
address@hidden file in input
address@hidden @code{FILENAME}, variabile
address@hidden variabile @code{FILENAME}
+Nel tipico programma @command{awk},
address@hidden legge tutto l'input sia dallo standard input
+(per default @`e la tastiera, ma spesso @`e una @dfn{pipe} da un altro comando)
+o da file i cui nomi vengono specificati sulla riga di comando di
address@hidden Se si specificano file in input, @command{awk} li legge
+nell'ordine, elaborando tutti i dati di uno prima di passare al successivo.
+Il nome del file in input corrente si trova nella variabile predefinita
address@hidden
+(@pxref{Variabili predefinite}).
+
address@hidden record
address@hidden campi
+L'input @`e letto in address@hidden chiamate @dfn{record}, e viene elaborato,
secondo le
+regole del programma, un record alla volta.
+Per default, ogni record @`e una riga. Ogni
+record @`e suddiviso automaticamente in "pezzi" chiamati @dfn{campi}.
+Questo rende address@hidden pratico far lavorare i programmi sulle parti di un
record.
+
address@hidden @code{getline}, comando
+In rare occasioni, si potrebbe aver bisogno di usare il comando
address@hidden Il comando @code{getline} @`e utile sia perch@'e address@hidden
procurare
+un input esplicito da un numero indeterminato di file, sia perch@'e non vanno
+specificati sulla riga di comando di @command{awk} i nomi dei file usati con
+getline (@pxref{Getline}).
+
address@hidden
+* Record:: Controllare come i dati sono suddivisi
+ in record.
+* Campi:: Un'introduzione ai campi.
+* Campi non costanti:: Numeri di campo variabili.
+* Cambiare i campi:: Cambiare il contenuto di un campo.
+* Separatori di campo:: I separatori di campo, e come
+ cambiarli.
+* Dimensione costante:: Leggere campi di larghezza costante.
+* Separazione in base al contenuto:: Definire campi dal loro contenuto.
+* Righe multiple:: Leggere record che sono su address@hidden
righe.
+* Getline:: Leggere file sotto il controllo del
+ programma, usando la funzione
+ @code{getline}.
+* Timeout in lettura:: Leggere input entro un tempo limite.
+* Proseguire dopo errore in input:: Elaborare ulteriore input dopo certi
+ errori di I/O.
+* Directory su riga di comando:: Cosa succede mettendo una directory
+ sulla riga di comando.
+* Sommario di Input:: Sommario di Input.
+* Esercizi su Input:: Esercizi.
address@hidden menu
+
address@hidden Record
address@hidden Controllare come i dati sono suddivisi in record
+
address@hidden input, suddividere in record
address@hidden record, suddividere l'input in
address@hidden @code{NR}, variabile
address@hidden @code{FNR}, variabile
address@hidden suddivide l'input per il programma in record e campi.
+Tiene traccia del numero di record address@hidden letti dal
+file in input corrente. Questo valore @`e memorizzato in una variabile
+predefinita chiamata @code{FNR} che @`e reimpostata a zero ogni volta che si
+inizia un nuovo file. Un'altra variabile predefinita, @code{NR}, registra il
+numero totale di record in input address@hidden letti da tutti i @value{DF}.
+Il suo valore iniziale @`e zero ma non viene mai reimpostata a zero
+automaticamente.
+
address@hidden
+* awk divisione record:: Come @command{awk} standard divide i record.
+* gawk divisione record:: Come @command{gawk} divide i record.
address@hidden menu
+
address@hidden awk divisione record
address@hidden Come @command{awk} standard divide i record.
+
address@hidden separatori di record
address@hidden record, separatori di
+I record sono separati da un carattere chiamato @dfn{separatore di record}.
+Per default, il separatore di record @`e il carattere di ritorno a capo.
+Questo @`e il motivo per cui i record sono, per default, righe singole.
+Per usare un diverso carattere come separatore di record
+basta assegnare quel carattere alla variabile predefinita @code{RS}.
+
address@hidden ritorno a capo, come separatore di record
address@hidden a capo, come separatore di record
address@hidden @code{RS}, variabile
+Come per ogni altra variabile,
+il valore di @code{RS} address@hidden essere cambiato nel programma
@command{awk}
+con l'operatore di assegnamento, @samp{=}
+(@pxref{Operatori di assegnamento}).
+Il nuovo separatore di record dovrebbe essere racchiuso tra doppi apici,
+per indicare una costante di stringa. Spesso il momento giusto per far questo
address@hidden all'inizio dell'esecuzione, prima che sia elaborato qualsiasi
input,
+in modo che il primo record sia letto col separatore appropriato.
+Per far address@hidden, si usa il criterio speciale @code{BEGIN}
+(@pxref{BEGIN/END}).
+Per esempio:
+
address@hidden
+awk 'BEGIN @{ RS = "u" @}
+ @{ print $0 @}' mail-list
address@hidden example
+
address@hidden
+cambia il valore di @code{RS} in @samp{u}, prima di leggere qualsiasi input.
+Il nuovo valore @`e una stringa il cui primo carattere @`e la lettera ``u'';
come
+risultato, i record sono separati dalla lettera ``u''. Poi viene letto il
+file in input, e la seconda regola nel programma @command{awk} (l'azione
+eseguita se non si specifica un criterio)
+stampa ogni record. Poich@'e ogni istruzione @code{print} aggiunge
+un ritorno a capo alla fine del suo output, questo programma
address@hidden copia l'input con ogni @samp{u} trasformato in un ritorno
+a capo. Qui vediamo il risultato dell'esecuzione del programma sul file
address@hidden:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ RS = "u" @}}
+> @address@hidden print $0 @}' mail-list}
address@hidden Amelia 555-5553 amelia.zodiac
address@hidden sq
address@hidden e@@gmail.com F
address@hidden Anthony 555-3412 anthony.assert
address@hidden ro@@hotmail.com A
address@hidden Becky 555-7685 becky.algebrar
address@hidden m@@gmail.com A
address@hidden Bill 555-1675 bill.drowning@@hotmail.com A
address@hidden Broderick 555-0542 broderick.aliq
address@hidden otiens@@yahoo.com R
address@hidden Camilla 555-2912 camilla.inf
address@hidden sar
address@hidden m@@skynet.be R
address@hidden Fabi
address@hidden s 555-1234 fabi
address@hidden s.
address@hidden ndevicesim
address@hidden s@@
address@hidden cb.ed
address@hidden F
address@hidden J
address@hidden lie 555-6699 j
address@hidden lie.perscr
address@hidden tabor@@skeeve.com F
address@hidden Martin 555-6480 martin.codicib
address@hidden s@@hotmail.com A
address@hidden Sam
address@hidden el 555-3430 sam
address@hidden el.lanceolis@@sh
address@hidden .ed
address@hidden A
address@hidden Jean-Pa
address@hidden l 555-2127 jeanpa
address@hidden l.campanor
address@hidden m@@ny
address@hidden .ed
address@hidden R
address@hidden
address@hidden example
+
address@hidden
+Si noti che la voce relativa al nome @samp{Bill} non @`e divisa.
+Nel @value{DF} originale
+(@pxref{File dati di esempio}),
+la riga appare in questo modo:
+
address@hidden
+Bill 555-1675 bill.drowning@@hotmail.com A
address@hidden example
+
address@hidden
+Essa non contiene nessuna @samp{u}, per cui non c'@`e alcun motivo di dividere
+il record, diversamente dalle altre, che hanno una o address@hidden ricorrenze
della
address@hidden Infatti, questo record @`e trattato come parte del record
precedente;
+il ritorno a capo che li separa nell'output @`e l'originale ritorno a capo nel
address@hidden, non quella aggiunta da @command{awk} quando ha stampato il
record!
+
address@hidden separatori di record, cambiare i
address@hidden record, separatori di
+Un altro modo per cambiare il separatore di record @`e sulla riga di comando,
+usando la address@hidden dell'assegnamento di variabile
+(@pxref{Altri argomenti}):
+
address@hidden
+awk '@{ print $0 @}' RS="u" mail-list
address@hidden example
+
address@hidden
+Questo imposta @code{RS} a @samp{u} prima di elaborare @file{mail-list}.
+
+Usando un carattere alfabetico come @samp{u} come separatore di record
address@hidden molto probabile che si ottengano risultati strani.
+Usando un carattere insolito come @samp{/} @`e address@hidden probabile
+che si ottenga un comportamento corretto nella maggioranza dei casi, ma non
+c'@`e nessuna garanzia. La morale @`e: conosci i tuoi dati!
+
+Quando si usano caratteri normali come separatore di record,
+c'@`e un caso insolito che capita quando @command{gawk}
address@hidden reso completamente conforme a POSIX (@pxref{Opzioni}).
+In quel caso, la seguente (estrema) @dfn{pipeline} stampa un sorprendente
address@hidden:
+
address@hidden
+$ echo | gawk --posix 'BEGIN @{ RS = "a" @} ; @{ print NF @}'
address@hidden 1
address@hidden example
+
+C'@`e un solo campo, consistente in un ritorno a capo. Il valore della
+variabile predefinita @code{NF} @`e il numero di campi nel record corrente.
+(Normalmente @command{gawk} tratta il ritorno a capo come uno spazio
+vuoto, stampando @samp{0} come risultato. Anche molte altre versioni di
address@hidden agiscono in questo modo.)
+
address@hidden angolo buio, file in input
+Il raggiungimento della fine di un file in input fa terminare il record di
+input corrente, anche se l'ultimo carattere nel file non @`e il carattere in
address@hidden @value{DARKCORNER}
+
address@hidden stringhe vuote
address@hidden stringhe nulle
address@hidden @cindex strings, empty, see null strings
+La stringa nulla @code{""} (una stringa che non contiene alcun carattere)
+ha un significato particolare come
+valore di @code{RS}. Significa che i record sono separati
+soltanto da una o address@hidden righe vuote.
address@hidden multiple} per maggiori dettagli.
+
+Se si cambia il valore di @code{RS} nel mezzo di un'esecuzione di
address@hidden, il nuovo valore @`e usato per delimitare i record successivi, ma
+non riguarda il record in corso di elaborazione e neppure quelli address@hidden
+elaborati.
+
address@hidden @command{gawk}, variabile @code{RT} in
address@hidden @code{RT}, variabile
address@hidden record, fine dei
address@hidden differenze tra @command{awk} e @command{gawk}, separatori di
record
address@hidden espressioni regolari, come separatori di record
address@hidden record, separatori di, espressioni regolari come
address@hidden separatori di record, espressioni regolari come
+Dopo che @`e stata determinata la fine di un record, @command{gawk}
+imposta la variabile @code{RT} al testo nell'input che corrisponde a
address@hidden
+
address@hidden gawk divisione record
address@hidden Divisione dei record con @command{gawk}
+
address@hidden estensioni comuni, @code{RS} come espressione regolare
address@hidden comuni, address@hidden @code{RS} come espressione regolare
+Quando si usa @command{gawk},
+il valore di @code{RS} non @`e limitato a una stringa costituita da un solo
+carattere, ma address@hidden essere qualsiasi espressione regolare
address@hidden
+(@pxrefil{Espressioni regolari}). @value{COMMONEXT}
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}). @value{COMMONEXT}
address@hidden ifnottex
+In generale, ogni record termina alla stringa address@hidden vicina che
corrisponde
+all'espressione regolare; il record successivo inizia alla fine della stringa
+che corrisponde. Questa regola generale @`e in address@hidden applicata anche
nel caso
+normale, in cui @code{RS} contiene solo un ritorno a capo: un record
+termina all'inizio della prossima stringa che corrisponde (il prossimo
+ritorno a capo nell'input), e il record seguente inizia subito dopo la
+fine di questa stringa (al primo carattere della riga seguente).
+Il ritorno a capo, poich@'e corrisponde a @code{RS}, non appartiene a
+nessuno dei due record.
+
+Quando @code{RS} @`e un singolo carattere, @code{RT}
+contiene lo stesso singolo carattere. Peraltro, quando @code{RS} @`e
+un'espressione regolare, @code{RT} contiene l'effettivo testo in input
+corrispondente all'espressione regolare.
+
+Se il file in input termina senza che vi sia un testo che corrisponda a
address@hidden, @command{gawk} imposta @code{RT} alla stringa nulla.
+
+Il seguente esempio illustra entrambe queste caratteristiche.
+In quest'esempio @code{RS} @`e impostato a un'espressione regolare che
+cerca sia un ritorno a capo che una serie di una o address@hidden lettere
+maiuscole con uno spazio vuoto opzionale iniziale e/o finale:
+
address@hidden
+$ @kbd{echo record 1 AAAA record 2 BBBB record 3 |}
+> @kbd{gawk 'BEGIN @{ RS = "\n|( *[[:upper:]]+ *)" @}}
+> @address@hidden print "Record =", $0,"e RT = [" RT "]" @}'}
address@hidden Record = record 1 e RT = [ AAAA ]
address@hidden Record = record 2 e RT = [ BBBB ]
address@hidden Record = record 3 e RT = [
address@hidden ]
address@hidden example
+
address@hidden
+Le parentesi quadre racchiudono il contenuto di @code{RT}, rendendo visibile
+lo spazio vuoto iniziale e quello finale. L'ultimo valore di
address@hidden @`e un ritorno a capo.
address@hidden sed semplice} per un esempio address@hidden utile
+su @code{RS} come espressione regolare e su @code{RT}.
+
+Se si imposta @code{RS} a un'espressione regolare che consente del testo
+finale opzionale, come @samp{RS = "abc(XYZ)?"} @`e possibile, per via di
+limitazioni dell'implementazione, che @command{gawk} possa trovare la parte
+iniziale dell'espressione regolare, ma non la parte finale, in modo
+particolare se il testo di input che potrebbe avere una corrispondenza con la
+parte finale @`e piuttosto lungo. @command{gawk} cerca di evitare questo
+problema, ma al momento non ci sono garanzie che questo funzioni sempre.
+
address@hidden NOTA
+Si ricordi che in @command{awk}, i metacaratteri di ancoraggio @samp{^} e
address@hidden trovano l'inizio e la fine di una @emph{stringa}, e non l'inizio
e la
+fine di una @emph{riga}. Come risultato, qualcosa come
address@hidden = "^[[:upper:]]"} address@hidden solo corrispondere all'inizio
di un file.
+Questo perch@'e @command{gawk} vede il file in input come un'unica lunga
stringa
+in cui possono essere presenti dei caratteri di ritorno a capo.
address@hidden meglio address@hidden evitare metacaratteri di ancoraggio nel
valore di @code{RS}.
address@hidden quotation
+
address@hidden differenze tra @command{awk} e @command{gawk}, variabili
@code{RS}/@code{RT}
+L'uso di @code{RS} come espressione regolare e la variabile @code{RT} sono
+estensioni @command{gawk}; non sono disponibili in
address@hidden compatibile
+(@pxref{Opzioni}).
+In address@hidden compatibile, solo il primo carattere del valore di
address@hidden determina la fine del record.
+
address@hidden sidebar, @code{RS = "\0"} non @`e portabile
address@hidden
address@hidden
+<sidebar><title>@code{RS = "\0"} non @`e portabile</title>
address@hidden docbook
+
address@hidden address@hidden, file di dati come un unico record
+Ci sono casi in cui capita di dover trattare un intero @value{DF} come
+un record unico. L'unico modo di far questo @`e quello di dare a @code{RS}
+un valore che non ricorre nel file in input. address@hidden @`e difficile da
fare in modo
+generale, address@hidden@dotless{i}} che un programma possa
+funzionare con file in input arbitrari.
+
+Si potrebbe pensare che per i file di testo il carattere @sc{NUL}, che
+consiste di un carattere con tutti i bit uguali a zero, sia un buon valore da
+usare per @code{RS} in questo caso:
+
address@hidden
+BEGIN @{ RS = "\0" @} # l'intero file diventa un record?
address@hidden example
+
address@hidden differenze tra @command{awk} e @command{gawk}, stringhe,
memorizzazione
address@hidden di fatto lo accetta, e usa il carattere @sc{NUL}
+come separatore di record.
+Questo funziona per certi file speciali, come @file{/proc/environ} su sistemi
+GNU/Linux, dove il carattere @sc{NUL} @`e di fatto un separatore di record..
+Comunque, quest'uso @emph{non} @`e portabile sulla maggior parte delle
+implementazioni di @command{awk}.
+
address@hidden angolo buio, stringhe, memorizzazione
+Quasi tutte le altre implementazioni di @command{awk} @footnote{Almeno quelle
+che ci sono note.} memorizzano internamente le stringhe come stringhe
+in stile C. Le stringhe in stile C usano il carattere @sc{NUL} come
+terminatore di stringa. In effetti, questo significa che
address@hidden = "\0"} @`e lo stesso di @samp{RS = ""}.
address@hidden
+
+Capita che recenti versioni di @command{mawk} possano usare i carattere
address@hidden come separatore di record. Comunque questo @`e un caso
particolare:
address@hidden non consente di includere caratteri @sc{NUL} nelle stringhe.
+(address@hidden potrebbe cambiare in una versione futura di @command{mawk}.)
+
address@hidden record, trattare un file come un solo
address@hidden trattare un file, come un solo record
address@hidden readfile} per un modo interessante di leggere
+file interi. Se si usa @command{gawk}, si veda
address@hidden di estensione Readfile} per un'altra opzione.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @address@hidden = "\0"} non @`e portabile}
+
+
address@hidden address@hidden, file di dati come un unico record
+Ci sono casi in cui capita di dover trattare un intero @value{DF} come
+un record unico. L'unico modo di far questo @`e quello di dare a @code{RS}
+un valore che non ricorre nel file in input. address@hidden @`e difficile da
fare in modo
+generale, address@hidden@dotless{i}} che un programma possa
+funzionare con file in input arbitrari.
+
+Si potrebbe pensare che per i file di testo il carattere @sc{NUL}, che
+consiste di un carattere con tutti i bit uguali a zero, sia un buon valore da
+usare per @code{RS} in questo caso:
+
address@hidden
+BEGIN @{ RS = "\0" @} # l'intero file diventa un record?
address@hidden example
+
address@hidden differenze tra @command{awk} e @command{gawk}, stringhe,
memorizzazione
address@hidden di fatto lo accetta, e usa il carattere @sc{NUL}
+come separatore di record.
+Questo funziona per certi file speciali, come @file{/proc/environ} su sistemi
+GNU/Linux, dove il carattere @sc{NUL} @`e di fatto un separatore di record..
+Comunque, quest'uso @emph{non} @`e portabile sulla maggior parte delle
+implementazioni di @command{awk}.
+
address@hidden angolo buio, stringhe, memorizzazione
+Quasi tutte le altre implementazioni di @command{awk} @footnote{Almeno quelle
+che ci sono note.} memorizzano internamente le stringhe come stringhe
+in stile C. Le stringhe in stile C usano il carattere @sc{NUL} come
+terminatore di stringa. In effetti, questo significa che
address@hidden = "\0"} @`e lo stesso di @samp{RS = ""}.
address@hidden
+
+Capita che recenti versioni di @command{mawk} possano usare i carattere
address@hidden come separatore di record. Comunque questo @`e un caso
particolare:
address@hidden non consente di includere caratteri @sc{NUL} nelle stringhe.
+(address@hidden potrebbe cambiare in una versione futura di @command{mawk}.)
+
address@hidden record, trattare un file come un solo
address@hidden trattare un file, come un solo record
address@hidden readfile} per un modo interessante di leggere
+file interi. Se si usa @command{gawk}, si veda
address@hidden di estensione Readfile} per un'altra opzione.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Campi
address@hidden Un'introduzione ai campi
+
address@hidden esaminare i campi
address@hidden campi
address@hidden accesso ai campi
address@hidden campi, esame dei
+Quando @command{awk} legge un record in input, il record @`e
+automaticamente @dfn{analizzato} o separato da @command{awk} in "pezzi"
+chiamati @dfn{campi}. Per default, i campi sono separati da
address@hidden vuoti}, come le parole in una riga stampata.
+Uno spazio vuoto in @command{awk} @`e qualsiasi stringa composta da uno o
address@hidden
+spazi, segni di tabulazione o ritorni a capo;
+altri caratteri, come interruzione di pagina, tabulazione verticale, etc., che
+sono considerati spazi vuoti in altri linguaggi, @emph{non} sono considerati
+tali da @command{awk}.
+
+Lo scopo dei campi @`e quello di rendere address@hidden conveniente per
l'utente far
+riferimento a questi frammenti dei record. Non @`e necessario usarli---si
address@hidden
+operare sull'intero record, se si vuole---ma i campi sono address@hidden che
rende
address@hidden@dotless{i}} potenti dei semplici programmi @command{awk}.
+
address@hidden operatore di campo @code{$}
address@hidden @code{$} (dollaro), operatore di campo @code{$}
address@hidden dollaro (@code{$}), operatore di campo @code{$}
address@hidden operatore di campo, dollaro come
+Si usa il simbolo del dollaro (@samp{$})
+per far riferimento a un campo in un programma @command{awk},
+seguito dal numero del campo desiderato. Quindi, @code{$1}
+si riferisce al primo campo, @code{$2} al secondo, e
address@hidden@dotless{i}} via.
+(Diversamente che nelle shell Unix, i numeri di campo non sono limitati a una
+sola cifra; @code{$127} @`e il centoventisettesimo campo nel record.)
+Per esempio, supponiamo che la seguente sia una riga in input:
+
address@hidden
+Questo pare essere un esempio proprio carino.
address@hidden example
+
address@hidden
+Qui il primo campo, o @code{$1}, @`e @samp{Questo}, il secondo campo, o
address@hidden, @`e @samp{pare}, e via dicendo. Si noti che l'ultimo campo,
address@hidden, @`e @samp{carino.}. Poich@'e non ci sono spazi tra la
address@hidden e il @samp{.}, il punto @`e considerato parte del settimo
+campo.
+
address@hidden @code{NF}, variabile
address@hidden campi, numero dei
address@hidden @`e una variabile predefinita il cui valore @`e il numero di
campi nel
+record corrente. @command{awk} aggiorna automaticamente il valore di
address@hidden ogni volta che legge un record. Indipendentemente da quanti
campi
+ci possano essere, l'ultimo campo in un record address@hidden essere
rappresentato da
address@hidden address@hidden@dotless{i}}, @code{$NF} @`e lo stesso di
@code{$7}, che @`e @samp{carino.}.
+Se si cerca di far riferimento a un campo oltre l'ultimo
+(come @code{$8} quando il record ha solo sette campi), si ottiene
+la stringa nulla. (Se usato in un'operazione numerica si ottiene zero.)
+
+L'uso di @code{$0}, che sarebbe come un riferimento al campo ``numero zero'',
address@hidden un caso particolare: rappresenta l'intero record in input. Si
usa quando
+non si @`e interessati a un campo specifico. Vediamo qualche altro esempio:
+
address@hidden
+$ @kbd{awk '$1 ~ /li/ @{ print $0 @}' mail-list}
address@hidden Amelia 555-5553 amelia.zodiacusque@@gmail.com F
address@hidden Julie 555-6699 julie.perscrutabor@@skeeve.com F
address@hidden example
+
address@hidden
+Questo esempio stampa ogni record del file @file{mail-list} il cui primo campo
+contiene la stringa @samp{li}.
+
+Per converso, il seguente esempio cerca @samp{li} @emph{nell'intero record} e
+stampa il primo e l'ultimo campo di ogni record in input per cui @`e stata
+trovata una corrispondenza:
+
address@hidden
+$ @kbd{awk '/li/ @{ print $1, $NF @}' mail-list}
address@hidden Amelia F
address@hidden Broderick R
address@hidden Julie F
address@hidden Samuel A
address@hidden example
+
address@hidden Campi non costanti
address@hidden Numeri di campo variabili
address@hidden campi, numero dei
address@hidden numeri di campo
+
+Un numero di campo non @`e necessario che sia una costante. Nel linguaggio
address@hidden si address@hidden usare qualsiasi espressione dopo @samp{$} per
far
+riferimento a un campo. Il valore dell'espressione specifica il numero di
+campo. Se il valore @`e una stringa, piuttosto che un numero, viene convertito
+in un numero. Consideriamo questo esempio:
+
address@hidden
+awk '@{ print $NR @}'
address@hidden example
+
address@hidden
+Ricordiamo che @code{NR} @`e il numero dei record letti fino a questo punto:
uno
+nel primo record, due nel secondo, etc. address@hidden@dotless{i}}
quest'esempio stampa il primo
+campo del primo record, il secondo campo del secondo record, e
address@hidden@dotless{i}} via.
+Per il ventesimo record, @`e stampato il campo numero 20; molto probabilmente
il
+record ha meno di 20 campi, address@hidden stampa una riga vuota.
+Questo @`e un altro esempio sull'uso di espressioni come numeri di campo:
+
address@hidden
+awk '@{ print $(2*2) @}' mail-list
address@hidden example
+
address@hidden calcola l'espressione @samp{(2*2)} e usa il suo valore come
+numero del campo da stampare. Qui @samp{*} rappresenta la
+moltiplicazione, quindi l'espressione @samp{2*2} ha il valore quattro. Le
+parentesi vengono usate affinch@'e la moltiplicazione sia eseguita prima
+dell'operazione @samp{$}; sono necessarie ogni volta che c'@`e un operatore
address@hidden un @dfn{operatore binario}, come @samp{*} per la
+moltiplicazione, servono due operandi. La distinzione @`e necessaria poich@'e
address@hidden ha anche operatori unari (un operando) e ternari (tre
+operandi).}
+nell'espressione del numero di campo. Questo esempio, dunque, stampa il
+tipo di relazione (il quarto campo) per ogni riga del file
address@hidden (Tutti gli operatori di @command{awk} sono elencati, in
+ordine decrescente di precedenza, in
address@hidden)
+
+Se il numero di campo calcolato @`e zero, si ottiene l'intero record.
+Quindi, @samp{$(2-2)} ha lo stesso valore di @code{$0}. Numeri di campo
+negativi non sono consentiti; tentare di far riferimento a uno di essi
+normalmente fa terminare il programma. (Lo standard POSIX non chiarisce
+cosa succede quando si fa riferimento a un numero di campo negativo.
address@hidden avvisa di questo e fa terminare il programma. Altre
+implementazioni di @command{awk} possono comportarsi in modo diverso.)
+
+Come accennato in @ref{Campi},
address@hidden memorizza il numero di campi del record corrente nella variabile
+predefinita @code{NF} (@pxref{Variabili predefinite}). Quindi,
+l'espressione @code{$NF} non @`e una address@hidden address@hidden la diretta
+conseguenza della valutazione di @code{NF} e dell'uso di questo valore come
+numero di campo.
+
address@hidden Cambiare i campi
address@hidden Cambiare il contenuto di un campo
+
address@hidden campi, cambiare il contenuto dei
+Il contenuto di un campo, address@hidden@dotless{i}} come @`e visto da
@command{awk}, address@hidden essere
+cambiato all'interno di un programma @command{awk}; questo cambia quello che
address@hidden percepisce come record in input corrente. (Il reale file in
+input non viene toccato; @command{awk} non modifica @emph{mai} il file in
+input).
+Si consideri il seguente esempio e il suo output:
+
address@hidden
+$ @kbd{awk '@{ numero_pacchi = $3 ; $3 = $3 - 10}
+> @kbd{print numero_pacchi, $3 @}' inventory-shipped}
address@hidden 25 15
address@hidden 32 22
address@hidden 24 14
address@hidden
address@hidden example
+
address@hidden
+Il programma per prima cosa salva il valore originale del campo tre nella
+variabile @code{numero_pacchi}.
+Il segno @samp{-} rappresenta la sottrazione, address@hidden@dotless{i}}
questo programma riassegna
+il campo tre, @code{$3}, come il valore originale del campo meno dieci:
address@hidden - 10}. (@xref{Operatori aritmetici}.)
+Poi stampa il valore originale e quello nuovo del campo tre.
+(Qualcuno nel magazzino ha fatto un errore ricorrente nell'inventariare le
+scatole rosse.)
+
+Perch@'e questo funzioni, il testo in @code{$3} deve poter essere riconosciuto
+come un numero; la stringa di caratteri dev'essere convertita in un numero
+affich@'e il computer possa eseguire operazioni aritmetiche su di essa. Il
+numero che risulta dalla sottrazione viene nuovamente convertito in
+una stringa di caratteri che quindi diventa il campo tre.
address@hidden
+
+Quando il valore di un campo @`e cambiato (come percepito da @command{awk}), il
+testo del record in input viene ricalcolato per contenere il nuovo campo al
+posto di quello vecchio. In altre parole, @code{$0} cambia per riflettere il
+campo modificato. Questo programma
+stampa una copia del file in input, con 10 sottratto dal secondo campo di ogni
+riga:
+
address@hidden
+$ @kbd{awk '@{ $2 = $2 - 10; print $0 @}' inventory-shipped}
address@hidden Jan 3 25 15 115
address@hidden Feb 5 32 24 226
address@hidden Mar 5 24 34 228
address@hidden
address@hidden example
+
address@hidden possibile inoltre assegnare contenuti a campi che sono fuori
+intervallo. Per esempio:
+
address@hidden
+$ @kbd{awk '@{ $6 = ($5 + $4 + $3 + $2)}
+> @kbd{ print $6 @}' inventory-shipped}
address@hidden 168
address@hidden 297
address@hidden 301
address@hidden
address@hidden example
+
address@hidden aggiungere, campi
address@hidden campi, aggiungere
address@hidden
+Abbiamo appena creato @code{$6}, il cui valore @`e la somma dei campi
address@hidden, @code{$3}, @code{$4} e @code{$5}. Il segno @samp{+}
+rappresenta l'addizione. Per il file @file{inventory-shipped}, @code{$6}
+rappresenta il numero totale di pacchi spediti in un determinato mese.
+
+La creazione di un nuovo campo cambia la copia interna di @command{awk} nel
+record in input corrente, che @`e il valore di @code{$0}.
address@hidden@dotless{i}}, se si scrive
address@hidden $0} dopo aver aggiunto un campo, il record stampato include il
+nuovo campo, col numero di separatori di campo appropriati tra esso e i
+campi originariamente presenti.
+
address@hidden @code{OFS}, variabile
address@hidden output, separatore di campo, si veda @code{OFS}, variabile
address@hidden campo, separatori di, si veda anche @code{OFS}
address@hidden separatori di campo, si veda anche @code{OFS}
+Questa ridefinizione influenza ed @`e influenzata da
address@hidden (il numero dei campi; @pxref{Campi}).
+Per esempio, il valore di @code{NF} @`e impostato al numero del campo
address@hidden
+elevato che @`e stato creato.
+Il formato preciso di @code{$0} @`e influenzato anche da una address@hidden che
+non @`e ancora stata trattata: il @dfn{separatore di campo di output},
address@hidden, usato per separare i campi (@pxref{Separatori di output}).
+
+Si noti, comunque, che il mero @emph{riferimento} a un campo fuori
+intervallo @emph{non} cambia il valore di @code{$0} o di @code{NF}.
+Far riferimento a un campo fuori intervallo produce solo una stringa nulla.
+Per esempio:
+
address@hidden
+if ($(NF+1) != "")
+ print "non @`e possibile"
+else
+ print "@`e tutto normale"
address@hidden example
+
address@hidden
+dovrebbe stampare @address@hidden tutto normale}, perch@'e @code{NF+1} @`e
certamente
+fuori intervallo. (@xref{Istruzione if}
+per maggiori informazioni sulle istruzioni @code{if-else} di @command{awk}.
address@hidden di variabile e confronti}
+per maggiori informazioni sull'operatore @samp{!=}.)
+
address@hidden importante notare che facendo un assegnamento a un campo
esistente cambia
+il valore di @code{$0} ma non cambia il valore di @code{NF},
+anche qualora si assegni a un campo la stringa nulla. Per esempio:
+
address@hidden
+$ @kbd{echo a b c d | awk '@{ OFS = ":"; $2 = ""}
+> @kbd{print $0; print NF @}'}
address@hidden a::c:d
address@hidden 4
address@hidden example
+
address@hidden
+Il campo @`e ancora address@hidden@dotless{i}}; ha solo un valore vuoto,
delimitato dai due "due punti"
+tra @samp{a} e @samp{c}.
+Questo esempio mostra cosa succede se si crea un nuovo campo:
+
address@hidden
+$ @kbd{echo a b c d | awk '@{ OFS = ":"; $2 = ""; $6 = "nuovo"}
+> @kbd{print $0; print NF @}'}
address@hidden a::c:d::nuovo
address@hidden 6
address@hidden example
+
address@hidden
+Il campo intermedio, @code{$5}, @`e creato con un valore vuoto
+(indicato dalla seconda coppia di due punti adiacenti),
+e @code{NF} @`e aggiornato col valore sei.
+
address@hidden angolo buio, variabile @code{NF}, decremento
address@hidden @code{NF}, variable, decremento
+Decrementando @code{NF} si eliminano i campi
+dopo il nuovo valore di @code{NF} e si ricalcola @code{$0}.
address@hidden
+Vediamo un esempio:
+
address@hidden
+$ @kbd{echo a b c d e f | awk '@{ print "NF =", NF;}
+> @kbd{ NF = 3; print $0 @}'}
address@hidden NF = 6
address@hidden a b c
address@hidden example
+
address@hidden address@hidden, variabile @address@hidden decremento
address@hidden ATTENZIONE
+Alcune versioni di @command{awk} non
+ricostruiscono @code{$0} quando @code{NF} viene diminuito.
address@hidden quotation
+
+Infine, ci sono casi in cui conviene forzare
address@hidden a ricostruire l'intero record, usando i valori correnti
+dei campi e @code{OFS}. Per far address@hidden, si usa
+l'apparentemente innocuo assegnamento:
+
address@hidden
+$1 = $1 # forza la ricostruzione del record
+print $0 # o qualsiasi altra cosa con $0
address@hidden example
+
address@hidden
+Questo forza @command{awk} a ricostruire il record. Aggiungere un commento
+rende tutto address@hidden chiaro, come abbiamo appena visto.
+
+C'@`e un rovescio della medaglia nella relazione tra @code{$0} e
+i campi. Qualsiasi assegnamento a @code{$0} fa address@hidden@dotless{i}} che
il record sia
+rianalizzato (sintatticamente) e ridiviso in campi usando il valore
address@hidden di @code{FS}. Questo si applica anche a qualsiasi funzione
+predefinita che aggiorna @code{$0}, come @code{sub()} e @code{gsub()}
+(@pxref{Funzioni per stringhe}).
+
address@hidden sidebar, Comprendere @code{$0}
address@hidden
address@hidden
+<sidebar><title>Comprendere @code{$0}</title>
address@hidden docbook
+
+
address@hidden importante ricordare che @code{$0} @`e @emph{l'intero}
+record, esattamente com'@`e stato letto dall'input, compresi tutti gli spazi
+vuoti iniziali e finali, e l'esatto spazio vuoto (o altri caratteri) che
+separa i campi.
+
address@hidden un errore comune tentare di cambiare il separatore di campo in
un record
+semplicemente impostando @code{FS} e @code{OFS}, e poi
+aspettarsi che un semplice @samp{print} or @samp{print $0} stampi il record
+modificato.
+
+Questo non funziona, poich@'e non @`e stato fatto niente per cambiare quello
+stesso record. Invece, si deve forzare la ricostruzione del record,
+tipicamente con un'istruzione come @samp{$1 = $1}, come descritto
+in precedenza.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Comprendere @code{$0}}
+
+
+
address@hidden importante ricordare che @code{$0} @`e @emph{l'intero}
+record, esattamente com'@`e stato letto dall'input, compresi tutti gli spazi
+vuoti iniziali e finali, e l'esatto spazio vuoto (o altri caratteri) che
+separa i campi.
+
address@hidden un errore comune tentare di cambiare il separatore di campo in
un record
+semplicemente impostando @code{FS} e @code{OFS}, e poi
+aspettarsi che un semplice @samp{print} or @samp{print $0} stampi il record
+modificato.
+
+Questo non funziona, poich@'e non @`e stato fatto niente per cambiare quello
+stesso record. Invece, si deve forzare la ricostruzione del record,
+tipicamente con un'istruzione come @samp{$1 = $1}, come descritto
+in precedenza.
address@hidden cartouche
address@hidden ifnotdocbook
+
+
address@hidden Separatori di campo
address@hidden Specificare come vengono separati i campi
+
address@hidden
+* Separatori di campo di default:: Come di solito sono separati i campi.
+* Separare campi con @dfn{regexp}:: Usare @dfn{regexp} come separatori.
+* Campi di un solo carattere:: Fare di ogni carattere un campo
+ separato.
+* Separatori campo da riga di comando:: Assegnare @code{FS} dalla riga di
+ comando.
+* Campo intera riga:: Far address@hidden@dotless{i}} che la
riga intera sia un
+ campo solo.
+* Sommario sulla separazione campi:: Alcuni punti finali e una tavola di
+ sommario.
address@hidden menu
+
address@hidden @code{FS}, variabile
address@hidden campi, separare
address@hidden campo, separatori di
+Il @dfn{separatore di campo}, che @`e un carattere singolo o un'espressione
+regolare, controlla il modo in cui @command{awk} suddivide un record in input
+in campi. @command{awk} fa una scansione del record in input per trovare i
+caratteri che individuano il separatore; i campi sono il testo compreso tra i
+separatori trovati.
+
+Nell'esempio che segue, usiamo il simbolo del punto elenco (@bullet{}) per
+rappresentare gli spazi nell'output.
+Se il separatore di campo @`e @samp{oo}, la seguente riga:
+
address@hidden
+moo goo gai pan
address@hidden example
+
address@hidden
address@hidden suddivisa in tre campi: @samp{m}, @address@hidden, e
address@hidden@address@hidden
+Notare gli spazi iniziali nei valori del secondo e del terzo campo.
+
address@hidden risoluzione di problemi, @command{awk} usa @code{FS} anzich@'e
@code{IFS}
address@hidden problemi, risoluzione di, @command{awk} usa @code{FS} anzich@'e
@code{IFS}
+Il separatore di campo @`e rappresentato dalla variable predefinita @code{FS}.
+I programmatori di shell notino: @command{awk} @emph{non} usa il
+nome @code{IFS} che @`e usato dalle shell conformi a POSIX (come
+la Unix Bourne shell, @command{sh}, o Bash).
+
address@hidden @code{FS}, variabile, cambiare il valore di una
+Il valore di @code{FS} si address@hidden cambiare nel programma @command{awk}
con
+l'operatore di assegnamento, @samp{=} (@pxref{Operatori di assegnamento}).
+Spesso il momento giusto per far address@hidden @`e all'inizio dell'esecuzione
+prima che sia stato elaborato qualsiasi input, address@hidden@dotless{i}} che
il primo record
+sia letto col separatore appropriato. Per far questo, si usa il modello di
+ricerca speciale
address@hidden
+(@pxref{BEGIN/END}).
+Per esempio, qui impostiamo il valore di @code{FS} alla stringa
address@hidden","}:
+
address@hidden
+awk 'BEGIN @{ FS = "," @} ; @{ print $2 @}'
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca
address@hidden
+Data la riga in input:
+
address@hidden
+John Q. Smith, 29 Oak St., Walamazoo, MI 42139
address@hidden example
+
address@hidden
+questo programma @command{awk} estrae e stampa la stringa
address@hidden@address@hidden@bullet{}St.}.
+
address@hidden separatori di campo, scelta dei
address@hidden espressioni regolari come separatori di campo
address@hidden separatori di campo, espressioni regolari come
+A volte i dati in input contengono caratteri separatori che non
+separano i campi nel modo in cui ci si sarebbe atteso. Per esempio, il
+nome della persona dell'esempio che abbiamo appena usato potrebbe avere un
+titolo o un suffisso annesso, come:
+
address@hidden
+John Q. Smith, LXIX, 29 Oak St., Walamazoo, MI 42139
address@hidden example
+
address@hidden
+Lo stesso programma estrarrebbe @address@hidden invece di
address@hidden@address@hidden@bullet{}St.}.
+Se ci si aspetta che il programma stampi l'indirizzo,
+si address@hidden sorpresi. La morale @`e quella di scegliere la struttura
dei dati
+e i caratteri di separazione attentamente per evitare questi problemi.
+(Se i dati non sono in una forma facile da elaborare, address@hidden darsi che
+si possano manipolare con un programma @command{awk} separato.)
+
+
address@hidden Separatori di campo di default
address@hidden Lo spazio vuoto normalmente separa i campi
+
address@hidden spazi vuoti, come separatori di campo
+I campi sono separati normalmente da spazi vuoti
+(spazi, tabulazioni e ritorni a capo), non solo da spazi singoli. Due spazi
+in una riga non delimitano un campo vuoto. Il valore di default del separatore
+di campo @code{FS} @`e una stringa contenente un singolo spazio,
@address@hidden" "}}.
+Se @command{awk} interpretasse questo valore nel modo usuale, ogni carattere
+di spazio separerebbe campi, quindi due spazi in una riga creerebbero un campo
+vuoto tra di essi. Il motivo per cui questo non succede @`e perch@'e un
singolo
+spazio come valore di @code{FS} @`e un caso particolare: @`e preso per
specificare
+il modo di default di delimitare i campi.
+
+Se @code{FS} @`e qualsiasi altro carattere singolo, come @code{","}, ogni
+ricorrenza di quel carattere separa due campi. Due ricorrenze consecutive
+delimitano un campo vuoto. Se il carattere si trova all'inizio o alla fine
+della riga, anche quello delimita un campo vuoto. Il carattere di spazio @`e
+il solo carattere singolo che non segue queste
+regole.
+
address@hidden Separare campi con @dfn{regexp}
address@hidden Usare @dfn{regexp} come separatori di campo
+
address@hidden espressioni regolari, come separatori di campo
address@hidden separatori di campo, espressioni regolari come
+La precedente @value{SUBSECTION}
+ha illustrato l'uso di caratteri singoli o di stringhe semplici come
+valore di @code{FS}.
address@hidden in generale, il valore di @code{FS} address@hidden essere una
stringa contenente
+qualsiasi espressione regolare. Se questo @`e il caso, ogni corrispondenza nel
+record con l'espressione regolare separa campi. Per esempio, l'assegnamento:
+
address@hidden
+FS = ", \t"
address@hidden example
+
address@hidden
+trasforma ogni parte di una riga in input che consiste di una virgola seguita
+da uno spazio e una tabulazione in un separatore di campo.
address@hidden
+(@samp{\t}
address@hidden una @dfn{sequenza di protezione} che sta per un segno di
tabulazione;
address@hidden di protezione},
+per l'elenco completo di sequenze di protezione simili.)
address@hidden ifinfo
+
+Per un esempio meno banale di espressione regolare, si provi a usare spazi
+singoli per separare campi nel modo in cui sono usate le virgole. @code{FS}
address@hidden essere impostato a @address@hidden"[@ ]"}} (parentesi quadra
sinistra, spazio,
+parentesi quadra destra). Quest'espressione regolare corrisponde a uno spazio
address@hidden
+singolo e niente address@hidden (@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+singolo e niente address@hidden (@pxref{Espressioni regolari}).
address@hidden ifnottex
+C'@`e una differenza importante tra i due casi di @samp{FS = @w{" "}}
+(uno spazio singolo) e @samp{FS = @w{"[ \t\n]+"}}
+(un'espressione regolare che individua uno o address@hidden spazi, tabulazioni
o
+ritorni a capo). Per entrambi i valori di @code{FS}, i campi sono
+separati da @dfn{serie} (ricorrenze adiacenti multiple) di spazi, tabulazioni
+e/o ritorni a capo. Comunque, quando il valore di @code{FS} @`e
address@hidden@code{" "}}, @command{awk} prima toglie lo spazio vuoto iniziale
e finale
+dal record e poi stabilisce dove sono i campi.
+Per esempio, la seguente @dfn{pipeline} stampa @samp{b}:
+
address@hidden
+$ @kbd{echo ' a b c d ' | awk '@{ print $2 @}'}
address@hidden b
address@hidden example
+
address@hidden
+Invece la @dfn{pipeline} che segue stampa @samp{a} (notare lo spazio extra
+intorno a ogni lettera):
+
address@hidden
+$ @kbd{echo ' a b c d ' | awk 'BEGIN @{ FS = "[ \t\n]+" @}}
+> @address@hidden print $2 @}'}
address@hidden a
address@hidden example
+
address@hidden
address@hidden @cindex null strings
address@hidden stringhe nulle
address@hidden stringhe vuote, si veda stringhe nulle
+In questo caso, il primo campo @`e nullo, o vuoto.
+Il taglio degli spazi vuoti iniziale e finale ha luogo anche
+ogniqualvolta @code{$0} @`e ricalcolato.
+Per esempio, si consideri questa @dfn{pipeline}:
+
address@hidden
+$ @kbd{echo ' a b c d' | awk '@{ print; $2 = $2; print @}'}
address@hidden a b c d
address@hidden a b c d
address@hidden example
+
address@hidden
+La prima istruzione @code{print} stampa il record address@hidden@dotless{i}}
come @`e stato letto,
+con lo spazio vuoto intatto. L'assegnamento a @code{$2} ricostruisce
address@hidden concatenando insieme @code{$1} fino a @code{$NF},
+separati dal valore di @code{OFS} (che @`e uno spazio per default).
+Poich@'e lo spazio vuoto iniziale @`e stato ignorato quando si @`e trovato
address@hidden, esso non fa parte del nuovo @code{$0}. Alla fine, l'ultima
+istruzione @code{print} stampa il nuovo @code{$0}.
+
address@hidden @code{FS}, contenente @code{^}
address@hidden @code{^} (circonflesso), in @code{FS}
address@hidden angolo buio, @code{^}, in @code{FS}
+C'@`e un'ulteriore sottigliezza da considerare quando si usano le espressioni
+regolari per separare i campi.
+Non @`e ben specificato nello standard POSIX, n@'e altrove, cosa
+significhi @samp{^} nella divisione dei campi. Il @samp{^} cerca
+corrispondenze solo all'inizio dell'intero record? Oppure ogni separatore di
+campo @`e una nuova stringa? Di fatto versioni differenti di @command{awk}
+rispondono a questo quesito in modo diverso, e non si dovrebbe far affidamento
+su alcun comportamento specifico nei propri programmi.
address@hidden
+
address@hidden Brian Kernighan, @command{awk} di
+Di sicuro, BWK @command{awk} individua con @samp{^}
+solo l'inizio del record. Anche @command{gawk}
+funziona in questo modo. Per esempio:
+
address@hidden
+$ @kbd{echo 'xxAA xxBxx C' |}
+> @kbd{gawk -F '(^x+)|( +)' '@{ for (i = 1; i <= NF; i++)}
+> @kbd{ printf "-->%s<--\n", $i @}'}
address@hidden --><--
address@hidden -->AA<--
address@hidden -->xxBxx<--
address@hidden -->C<--
address@hidden example
+
address@hidden Campi di un solo carattere
address@hidden Fare di ogni carattere un campo separato
+
address@hidden estensioni comuni, campi di un solo carattere
address@hidden comuni, estensioni, campi di un solo carattere
address@hidden differenze tra @command{awk} e @command{gawk}, campi di un solo
carattere
address@hidden singolo carattere, campi
address@hidden campi di un solo carattere
+Ci sono casi in cui si abbia la address@hidden di analizzare ciascun carattere
di un
+record separatamente. Questo si address@hidden fare in @command{gawk}
semplicemente
+assegnando la stringa nulla (@code{""}) a @code{FS}. @value{COMMONEXT}
+In questo caso,
+ogni singolo carattere nel record diventa un campo separato.
+Per esempio:
+
address@hidden
+$ @kbd{echo a b | gawk 'BEGIN @{ FS = "" @}}
+> @address@hidden
+> @kbd{for (i = 1; i <= NF; i = i + 1)}
+> @kbd{print "Il campo", i, "@`e", $i}
+> @address@hidden'}
address@hidden Il campo 1 @`e a
address@hidden Il campo 2 @`e
address@hidden Il campo 3 @`e b
address@hidden example
+
address@hidden angolo buio, @code{FS} come stringa nulla
address@hidden @code{FS}, variabile, come stringa nulla
+Tradizionalmente, il comportamento di @code{FS} quando @`e impostato a
address@hidden""} non @`e stato definito. In questo caso, la maggior parte
delle
+versioni UNIX di @command{awk} trattano l'intero record come se avesse un
+unico campo.
address@hidden
+In address@hidden di address@hidden
+(@pxref{Opzioni}),
+se @code{FS} @`e la stringa nulla, anche @command{gawk}
+si comporta in questo modo.
+
address@hidden Separatori campo da riga di comando
address@hidden Impostare @code{FS} dalla riga di comando
address@hidden @option{-F}, opzione sulla riga di comando
address@hidden separatore di campo, specificare sulla riga di comando
address@hidden riga di comando, impostare @code{FS} sulla
address@hidden @code{FS}, variabile, impostare da riga di comando
+
address@hidden address@hidden essere impostata sulla riga di comando. Per far
questo si usa
+l'opzione @option{-F}. Per esempio:
+
address@hidden
+awk -F, '@var{programma}' @var{i-file-di-input}
address@hidden example
+
address@hidden
+imposta @code{FS} al carattere @samp{,}. Si noti che l'opzione richiede
+un carattere maiuscolo @samp{F} anzich@'e minuscolo @samp{f}. Quest'ultima
+opzione (@option{-f}) serve a specificare il file contenente un programma
address@hidden
+
+Il valore usato per l'argomento di @option{-F} @`e elaborato esattamente nello
+stesso modo degli assegnamenti alla variabile predefinita @code{FS}. Qualsiasi
+carattere speciale nel separatore di campo dev'essere protetto in modo
+appropriato. Per esempio, per usare un @samp{\} come separatore di campo
+sulla riga di comando, si dovrebbe battere:
+
address@hidden
+# equivale a FS = "\\"
+awk -F\\\\ '@dots{}' file @dots{}
address@hidden example
+
address@hidden
address@hidden @code{\} (barra inversa), come separatore di campo
address@hidden barra inversa (@code{\}), come separatore di campo
+Poich@'e @samp{\} @`e usato nella shell per proteggere caratteri, a
@command{awk}
+arriva @samp{-F\\}. Quindi @command{awk} elabora @samp{\\} per caratteri di
+protezione (@pxref{Sequenze di protezione}), producendo alla fine
+un unico @samp{\} da usare come separatore di campo.
+
address@hidden @cindex historical features
+Come caso particolare, in address@hidden di address@hidden
+(@pxref{Opzioni}),
+se l'argomento di @option{-F} @`e @samp{t}, @code{FS} @`e impostato al
+carattere di tabulazione. Se si immette @samp{-F\t} nella
+shell, senza che sia tra apici, @samp{\} viene cancellata,
address@hidden@dotless{i}} @command{awk}
+conclude che si vuole realmente che i campi siano separati da tabulazioni e
+non da delle @samp{t}. Si usi @samp{-v FS="t"} o @samp{-F"[t]"} sulla riga di
+comando se si vuole separare i campi con delle @samp{t}.
+Quando non si @`e in address@hidden di address@hidden si deve usare @samp{-F
'\t'} per
+specificare che le tabulazioni separano i campi.
+
+Come esempio, usiamo un file di programma @command{awk} chiamato
address@hidden che contiene il criterio di ricerca @code{/edu/} e l'azione
address@hidden $1}:
+
address@hidden
+/edu/ @{ print $1 @}
address@hidden example
+
+Impostiamo inoltre @code{FS} al carattere @samp{-} ed eseguiamo il programma
+sul file @file{mail-list}. Il seguente comando stampa un elenco dei nomi
+delle persone che lavorano all'address@hidden o che la frequentano, e le prime
tre
+cifre dei loro numeri di telefono:
+
address@hidden
+$ @kbd{awk -F- -f edu.awk mail-list}
address@hidden Fabius 555
address@hidden Samuel 555
address@hidden Jean
address@hidden example
+
address@hidden
+Si noti la terza riga di output. La terza riga
+nel file originale @`e simile a questa:
+
address@hidden
+Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden example
+
+Il @samp{-} che fa parte del nome della persona @`e stato usato come
+separatore di campo, al posto del @samp{-} presente nel numero di telefono,
+che ci si aspettava venisse usato.
+Questo lascia intuire il motivo per cui si deve stare attenti nella scelta
+dei separatori di campo e di record.
+
address@hidden Unix @command{awk}, file di password, separatori di campo e
+Forse l'uso address@hidden comune di un solo carattere come separatore di
campo avviene
+quando si elabora il file delle password di un sistema Unix. Su molti sistemi
+Unix, ogni utente @`e descritto da un elemento nel file delle password del
+sistema, che contiene una riga singola per ogni utente. In queste righe le
+informazioni sono separate da dei caratteri ":". Il
+primo campo @`e il nome di login dell'utente e il secondo @`e la password
+dell'utente criptata o oscurata (una password oscurata @`e indicata dalla
+presenza di una sola @samp{x} nel secondo campo). Una riga nel file delle
+password potrebbe essere simile a questa:
+
address@hidden Robbins, Arnold
address@hidden
+arnold:x:2076:10:Arnold Robbins:/home/arnold:/bin/bash
address@hidden example
+
+Il seguente programma esamina il file delle password di sistema e stampa le
+voci relative agli utenti il cui nome completo non @`e presente nel file:
+
address@hidden
+awk -F: '$5 == ""' /etc/passwd
address@hidden example
+
address@hidden Campo intera riga
address@hidden Fare di una riga intera un campo solo
+
+Occasionalmente, @`e utile trattare l'intera riga in input come un solo campo.
+Questo si address@hidden fare facilmente e in modo portabile semplicemente
impostando
address@hidden a @code{"\n"} (un ritorno a capo)address@hidden ad
+Andrew Schorr per questo suggerimento.}
+
address@hidden
+awk -F'\n' '@var{programma}' @var{file @dots{}}
address@hidden example
+
address@hidden
+In questo caso, @code{$1} coincide con @code{$0}.
+
+
address@hidden sidebar, Cambiare @code{FS} non incide sui campi
address@hidden
address@hidden
+<sidebar><title>Cambiare @code{FS} non incide sui campi</title>
address@hidden docbook
+
+
address@hidden POSIX @command{awk}, separatori di campo e
address@hidden separatore di campo, POSIX e il
+Secondo lo standard POSIX, si suppone che @command{awk} si comporti
+come se ogni record sia stato diviso in campi nel momento in cui @`e stato
+letto. In particolare, address@hidden vuol dire che se si cambia il valore di
address@hidden dopo che un record @`e stato letto, il valore dei campi (cio@'e
+la loro suddivisione) address@hidden ancora quello ottenuto usando il
precedente
+valore di @code{FS}, non quello nuovo.
+
address@hidden angolo buio, separatori di campo
address@hidden @command{sed}, programma di address@hidden
address@hidden programma di address@hidden @command{sed}
address@hidden editori di flusso
+Comunque, molte delle address@hidden vecchie implementazioni di @command{awk}
non
+funzionano in questo modo. Invece, rimandano la divisione dei campi
+fino a quando si fa effettivamente riferimento a un campo. I campi sono
+divisi usando il valore @emph{corrente} di @code{FS}!
address@hidden
+Questo comportamento address@hidden essere di difficile
+identificazione. Il seguente esempio illustra la differenza
+tra i due metodi. Lo script
+
address@hidden
+sed 1q /etc/passwd | awk '@{ FS = ":" ; print $1 @}'
address@hidden example
+
address@hidden
+normalmente stampa:
+
address@hidden
address@hidden root
address@hidden example
+
address@hidden
+su un'implementazione non standard di @command{awk}, mentre @command{gawk}
+stampa l'intera prima riga del file, qualcosa come:
+
address@hidden
+root:x:0:0:Root:/:
address@hidden example
+
+(Il comando @address@hidden programma di address@hidden @command{sed} @`e un
+``editore di flusso''. Anche il suo comportamento @`e definito dallo standard
+POSIX.} appena visto stampa solo la prima riga di @file{/etc/passwd}.)
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Cambiare @code{FS} non incide sui campi}
+
+
+
address@hidden POSIX @command{awk}, separatori di campo e
address@hidden separatore di campo, POSIX e il
+Secondo lo standard POSIX, si suppone che @command{awk} si comporti
+come se ogni record sia stato diviso in campi nel momento in cui @`e stato
+letto. In particolare, address@hidden vuol dire che se si cambia il valore di
address@hidden dopo che un record @`e stato letto, il valore dei campi (cio@'e
+la loro suddivisione) address@hidden ancora quello ottenuto usando il
precedente
+valore di @code{FS}, non quello nuovo.
+
address@hidden angolo buio, separatori di campo
address@hidden @command{sed}, programma di address@hidden
address@hidden programma di address@hidden @command{sed}
address@hidden editori di flusso
+Comunque, molte delle address@hidden vecchie implementazioni di @command{awk}
non
+funzionano in questo modo. Invece, rimandano la divisione dei campi
+fino a quando si fa effettivamente riferimento a un campo. I campi sono
+divisi usando il valore @emph{corrente} di @code{FS}!
address@hidden
+Questo comportamento address@hidden essere di difficile
+identificazione. Il seguente esempio illustra la differenza
+tra i due metodi. Lo script
+
address@hidden
+sed 1q /etc/passwd | awk '@{ FS = ":" ; print $1 @}'
address@hidden example
+
address@hidden
+normalmente stampa:
+
address@hidden
address@hidden root
address@hidden example
+
address@hidden
+su un'implementazione non standard di @command{awk}, mentre @command{gawk}
+stampa l'intera prima riga del file, qualcosa come:
+
address@hidden
+root:x:0:0:Root:/:
address@hidden example
+
+(Il comando @address@hidden programma di address@hidden @command{sed} @`e un
+``editore di flusso''. Anche il suo comportamento @`e definito dallo standard
+POSIX.} appena visto stampa solo la prima riga di @file{/etc/passwd}.)
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Sommario sulla separazione campi
address@hidden Sommario sulla separazione dei campi
+
address@hidden importante ricordare che quando si assegna una costante stringa
+come valore di @code{FS}, questa subisce una normale elaborazione di stringa
+da parte di @command{awk}. Per esempio, con Unix @command{awk} e
address@hidden, l'assegnamento @samp{FS = "\.."} assegna la stringa di
+caratteri @code{".."}
+a @code{FS} (la barra inversa @`e tolta). Questo crea un'espressione regolare
+che significa ``i campi sono separati da ricorrenze di due caratteri
+qualsiasi''. Se invece si vuole che i campi siano separati da un punto
+seguito da un qualsiasi carattere singolo, si deve usare @samp{FS = "\\.."}.
+
+Il seguente elenco riassume come i campi vengono divisi, in base al valore
+di @code{FS} (@samp{==} significa address@hidden uguale a''):
+
address@hidden @code
address@hidden FS == " "
+I campi sono separati da serie di spazi vuoti. Gli spazi vuoti iniziale e
+finale sono ignorati. Questo @`e il comportamento di default.
+
address@hidden FS == @var{qualsiasi altro carattere singolo}
+I campi sono separati da ogni ricorrenza del carattere. Ricorrenze
+successive multiple delimitano campi vuoti, e lo stesso fanno le ricorrenze
+iniziali e finali del carattere.
+Il carattere address@hidden essere anche un metacarattere di espressione
regolare, che
+non @`e necessario proteggere.
+
address@hidden FS == @var{espressione regolare}
+I campi sono separati da ricorrenze di caratteri che corrispondono alla
address@hidden regolare}. Corrispondenze iniziali e finali della
address@hidden delimitano campi vuoti.
address@hidden FS == ""
+Ogni sinngolo carattere nel record diventa un campo separato.
+(Questa @`e un'estensione comune; non @`e specificata dallo standard POSIX.)
address@hidden table
+
address@hidden sidebar, @code{FS} e @code{IGNORECASE}
address@hidden
address@hidden
+<sidebar><title>@code{FS} e @code{IGNORECASE}</title>
address@hidden docbook
+
+La variabile @code{IGNORECASE}
+(@pxref{Variabili modificabili dall'utente})
+influisce sulla divisione del campo @emph{solo} quando il valore di @code{FS}
address@hidden un'espressione regolare. Non ha nessun effetto quando @code{FS}
@`e un
+singolo carattere, anche se quel carattere @`e una lettera. Quindi, nel
+seguente codice:
+
address@hidden
+FS = "c"
+IGNORECASE = 1
+$0 = "aCa"
+print $1
address@hidden example
+
address@hidden
+L'output @`e @samp{aCa}. Se si vuol veramente dividere i campi su un carattere
+alfabetico ignorandone il maiuscolo/minuscolo, si deve usare un'espressione
+regolare che lo address@hidden in automatico (p.es., @samp{FS = "[c]"}). In
questo
+caso, @code{IGNORECASE} address@hidden effetto.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @address@hidden e @code{IGNORECASE}}
+
+
+La variabile @code{IGNORECASE}
+(@pxref{Variabili modificabili dall'utente})
+influisce sulla divisione del campo @emph{solo} quando il valore di @code{FS}
address@hidden un'espressione regolare. Non ha nessun effetto quando @code{FS}
@`e un
+singolo carattere, anche se quel carattere @`e una lettera. Quindi, nel
+seguente codice:
+
address@hidden
+FS = "c"
+IGNORECASE = 1
+$0 = "aCa"
+print $1
address@hidden example
+
address@hidden
+L'output @`e @samp{aCa}. Se si vuol veramente dividere i campi su un carattere
+alfabetico ignorandone il maiuscolo/minuscolo, si deve usare un'espressione
+regolare che lo address@hidden in automatico (p.es., @samp{FS = "[c]"}). In
questo
+caso, @code{IGNORECASE} address@hidden effetto.
address@hidden cartouche
address@hidden ifnotdocbook
+
+
address@hidden Dimensione costante
address@hidden Leggere campi di larghezza costante
+
+
address@hidden campi di larghezza costante
address@hidden larghezza costante, campi di
address@hidden address@hidden avanzate, campi di larghezza costante
address@hidden O'Reilly doesn't like it as a note the first thing in the
section.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta una address@hidden avanzata
+di @command{gawk}. Se si @`e un utente alle prime armi di @command{awk},
+la si address@hidden saltare in prima lettura.
+
address@hidden fornisce una address@hidden per il trattamento di campi
+a larghezza fissa senza un separatore di campo distintivo. Per esempio,
+dati di questo tipo si trovano nell'input per vecchi programmi Fortran dove
+dei numeri sono elencati uno dopo l'altro, o nell'output di programmi che
+non prevedono che il loro output sia dato in input ad altri programmi.
+
+Un esempio di quest'ultimo caso @`e una tabella dove tutte le colonne sono
+allineate usando un numero variabile di spazi e dove @emph{i campi vuoti
+sono solo spazi}. Chiaramente, la normale divisione in campi di
address@hidden basata su @code{FS} non funziona bene in questa situazione.
+Sebbene un programma @command{awk}
+portabile possa usare una serie di chiamate @code{substr()} su @code{$0}
+(@pxref{Funzioni per stringhe}),
+questo @`e scomodo e inefficiente se il numero dei campi @`e elevato.
+
address@hidden risoluzione di problemi, errori fatali, specificare larghezza
dei campi
address@hidden problemi, risoluzione di, errori fatali, specificare larghezza
dei campi
address@hidden @command{w}, programma di address@hidden
address@hidden programma di address@hidden @command{w}
address@hidden @code{FIELDWIDTHS}, variabile
address@hidden @command{gawk}, variabile @code{FIELDWIDTHS} in
+La suddivisione di un record in input in campi a larghezza fissa viene
+specificata assegnando una stringa contenente numeri separati da spazi alla
+variabile predefinita @code{FIELDWIDTHS}. Ogni numero specifica la larghezza
+del campo, @emph{comprese} le colonne tra i campi. Se si vogliono ignorare le
+colonne tra i campi si address@hidden specificare la loro larghezza come un
campo
+separato che address@hidden poi ignorato.
address@hidden un errore fatale definire una larghezza di campo che abbia un
valore
+negativo. I dati seguenti costituiscono l'output del programma di
address@hidden
+Unix @command{w}. @`E utile per spiegare l'uso di @code{FIELDWIDTHS}:
+
address@hidden
address@hidden
+ 10:06pm up 21 days, 14:04, 23 users
+User tty login@ idle JCPU PCPU what
+hzuo ttyV0 8:58pm 9 5 vi p24.tex
+hzang ttyV3 6:37pm 50 -csh
+eklye ttyV5 9:53pm 7 1 em thes.tex
+dportein ttyV6 8:17pm 1:47 -csh
+gierd ttyD3 10:00pm 1 elm
+dave ttyD4 9:47pm 4 4 w
+brent ttyp0 26Jun91 4:46 26:46 4:41 bash
+dave ttyq4 26Jun9115days 46 46 wnewmail
address@hidden group
address@hidden example
+
+Il seguente programma prende l'input sopra mostrato, converte il tempo di
address@hidden
+in numero di secondi, e stampa i primi due campi e il tempo di address@hidden
+calcolato:
+
address@hidden
+BEGIN @{ FIELDWIDTHS = "9 6 10 6 7 7 35" @}
+NR > 2 @{
+ inat = $4
+ sub(/^ +/, "", inat) # togli spazi prima del valore
+ if (inat == "")
+ inat = 0
+ if (inat ~ /:/) @{
+ split(inat, t, ":")
+ inat = t[1] * 60 + t[2]
+ @}
+ if (inat ~ /days/)
+ inat *= 24 * 60 * 60
+
+ print $1, $2, inat
address@hidden
address@hidden example
+
address@hidden NOTA
+Questo programma usa diverse address@hidden di @command{awk} non
+ancora trattate.
address@hidden quotation
+
+L'esecuzione del programma sui dati produce il seguente risultato:
+
address@hidden
+hzuo ttyV0 0
+hzang ttyV3 50
+eklye ttyV5 0
+dportein ttyV6 107
+gierd ttyD3 1
+dave ttyD4 0
+brent ttyp0 286
+dave ttyq4 1296000
address@hidden example
+
+Un altro esempio (forse address@hidden pratico) di dati di input con larghezza
costante @`e
+l'input da un mazzo di schede elettorali. In alcune parti degli Stati Uniti,
+i votanti marcano le loro scelte perforando delle schede elettroniche.
+
+Queste schede vengono poi elaborate per contare i voti espressi per ogni
+singolo candidato o su ogni determinato quesito. Siccome un votante
address@hidden
+scegliere di non votare su alcune questioni, qualsiasi colonna della scheda
address@hidden essere vuota. Un programma @command{awk} per elaborare tali
dati potrebbe
+usare la address@hidden @code{FIELDWIDTHS} per semplificare la lettura dei
dati.
+(Naturalmente, riuscire a eseguire @command{gawk} su un sistema con lettori di
+schede @`e un'altra storia!)
+
address@hidden @command{gawk}, separazione in campi e
+L'assegnazione di un valore a @code{FS} fa address@hidden@dotless{i}} che
@command{gawk} usi @code{FS}
+per separare nuovamente i campi. Si address@hidden usare @samp{FS = FS} per
ottenere
+questo effetto, senza dover conoscere il valore corrente di @code{FS}.
+Per vedere quale tipo di separazione sia in atto,
+si address@hidden usare @code{PROCINFO["FS"]}
+(@pxref{Variabili auto-assegnate}).
+Il suo valore @`e @code{"FS"} se si usa la normale separazione in campi,
+o @code{"FIELDWIDTHS"} se si usa la separazione in campi a larghezza fissa:
+
address@hidden
+if (PROCINFO["FS"] == "FS")
+ @var{separazione in campi address@hidden
+else if (PROCINFO["FS"] == "FIELDWIDTHS")
+ @var{separazione in campi a larghezza address@hidden
+else
+ @var{separazione dei campi in base al address@hidden @ii{(si veda
address@hidden
+la @value{SECTION} successiva)}
address@hidden ifnotinfo
address@hidden
+il @value{SECTION} successivo)}
address@hidden ifinfo
address@hidden example
+
+Quest'informazione @`e utile quando si scrive una funzione che
+necessita di cambiare temporaneamente @code{FS} o @code{FIELDWIDTHS},
+leggere alcuni record, e poi ripristinare le impostazioni originali
+(@pxref{Funzioni Passwd},
+per un esempio di tale funzione).
+
address@hidden Separazione in base al contenuto
address@hidden Definire i campi in base al contenuto
+
address@hidden O'Reilly doesn't like it as a note the first thing in the
section.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta una address@hidden avanzata
+di @command{gawk}. Se si @`e un utente alle prime armi di @command{awk},
+la si address@hidden saltare in prima lettura.
+
address@hidden address@hidden avanzate, specificare il contenuto dei campi
+Normalmente, quando si usa @code{FS}, @command{gawk} definisce i campi come
+le parti del record che si trovano tra due separatori di campo. In altre
+parole, @code{FS} definisce cosa un campo @emph{non @`e}, invece di cosa
address@hidden@`e}.
+Tuttavia, ci sono casi in cui effettivamente si ha bisogno di definire i campi
+in base a cosa essi sono, e non in base a cosa non sono.
+
+Il caso address@hidden emblematico @`e quello dei dati cosiddetti
@dfn{comma-separated
+value} (CSV). Molti fogli elettronici, per esempio, possono esportare i dati
+in file di testo, dove ogni record termina con un ritorno a capo e i campi
+sono separati tra loro da virgole. Se le virgole facessero solo da separatore
+fra i dati non ci sarebbero problemi. Il problema sorge se uno dei campi
+contiene una virgola @emph{al suo interno}.
+In queste situazioni, la maggioranza dei programmi include il campo fra
+doppi address@hidden formato CSV non ha avuto, per molti anni, una
+definizione standard formale.
address@hidden://www.ietf.org/rfc/rfc4180.txt, RFC 4180}
+standardizza le pratiche address@hidden comuni.}
address@hidden@dotless{i}}, potremmo avere dei dati di questo tipo:
+
address@hidden
address@hidden file eg/misc/addresses.csv
+Robbins,Arnold,"1234 A Pretty Street, NE",MyTown,MyState,12345-6789,USA
address@hidden endfile
address@hidden example
+
address@hidden @command{gawk}, variabile @code{FPAT} in
address@hidden @code{FPAT}, variabile
+La variabile @code{FPAT} offre una soluzione per casi come questo.
+Il valore di @code{FPAT} dovrebbe essere una stringa formata da un'espressione
+regolare. L'espressione regolare descrive il contenuto di ciascun campo.
+
+Nel caso dei dati CSV visti prima, ogni campo @`e ``qualsiasi cosa che non
+sia una virgola,'' oppure ``doppi apici, seguiti da qualsiasi cosa che non
+siano doppi apici, e doppi apici di chiusura''. Se fosse scritta come una
+costante @dfn{regexp}
address@hidden
+(@pxrefil{Espressioni regolari}),
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}),
address@hidden ifnottex
+sarebbe @code{/([^,]+)|("[^"]+")/}.
+Dovendola scrivere come stringa si devono proteggere i doppi apici,
+e quindi si deve scrivere:
+
address@hidden
+FPAT = "([^,]+)|(\"[^\"]+\")"
address@hidden example
+
+Come esempio pratico, si address@hidden vedere questo semplice programma che
analizza
+e divide i dati:
+
address@hidden
address@hidden file eg/misc/simple-csv.awk
+BEGIN @{
+ FPAT = "([^,]+)|(\"[^\"]+\")"
address@hidden
+
address@hidden
+ print "NF = ", NF
+ for (i = 1; i <= NF; i++) @{
+ printf("$%d = <%s>\n", i, $i)
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Eseguendolo, avendo in input la riga vista sopra, si ottiene:
+
address@hidden
+$ @kbd{gawk -f simple-csv.awk addresses.csv}
+NF = 7
+$1 = <Robbins>
+$2 = <Arnold>
+$3 = <"1234 A Pretty Street, NE">
+$4 = <MyTown>
+$5 = <MyState>
+$6 = <12345-6789>
+$7 = <USA>
address@hidden example
+
+Si noti la virgola contenuta nel valore del campo @code{$3}.
+
+Un semplice miglioramento se si elaborano dati CSV di questo tipo potrebbe
+essere quello di rimuovere i doppi apici, se presenti, con del codice di
+questo tipo:
+
address@hidden
+if (substr($i, 1, 1) == "\"") @{
+ len = length($i)
+ $i = substr($i, 2, len - 2) # Ottiene il testo tra doppi apici
address@hidden
address@hidden example
+
+Come per @code{FS}, la variabile @code{IGNORECASE}
+(@pxref{Variabili modificabili dall'utente}) ha effetto sulla separazione dei
+campi con @code{FPAT}.
+
+Se si assegna un valore a @code{FPAT} la divisione in campi non viene
+effettuata utilizzando @code{FS} o @code{FIELDWIDTHS}.
+Analogamente a @code{FIELDWIDTHS}, il valore di @code{PROCINFO["FS"]}
address@hidden @code{"FPAT"} se @`e in uso la suddivisione in campi in base al
contenuto.
+
address@hidden NOTA
+Alcuni programmi esportano dei dati CSV che contengono dei ritorni a capo al
+loro interno in campi rinchiusi tra doppi apici. @command{gawk} non @`e in
+grado di trattare questi dati. Malgrado esista una specifica ufficiale
+per i dati CSV, non c'@`e molto da fare; il meccanismo di @code{FPAT} fornisce
+una soluzione elegante per la maggioranza dei casi, e per gli sviluppatori di
address@hidden address@hidden address@hidden bastare.
address@hidden quotation
+
+Come visto, l'espressione regolare usata per @code{FPAT} richiede
+che ogni campo contenga almeno un carattere. Una semplice modifica
+(cambiare il primo @samp{+} con @samp{*}) permette che siano presenti dei
+campi vuoti:
+
address@hidden
+FPAT = "([^,]*)|(\"[^\"]+\")"
address@hidden example
+
address@hidden FIXME: 4/2015
address@hidden Consider use of FPAT = "([^,]*)|(\"[^\"]*\")"
address@hidden (star in latter part of value) to allow quoted strings to be
empty.
address@hidden Per email from Ed Morton <address@hidden>
+
+Infine, la funzione @code{patsplit()} rende la stessa address@hidden
disponibile
+per suddividere normali stringhe (@pxref{Funzioni per stringhe}).
+
+Per ricapitolare, @command{gawk} fornisce tre metodi indipendenti per
+suddividere in campi i record in input.
+Il meccanismo usato @`e determinato da quella tra le tre
address@hidden, @code{FIELDWIDTHS}, o @code{FPAT}---a cui
+sia stato assegnato un valore address@hidden recentemente.
+
address@hidden Righe multiple
address@hidden Record su righe multiple
+
address@hidden righe multiple, record su
address@hidden record multiriga
address@hidden input, record multiriga
address@hidden file, lettura dei record multiriga
address@hidden input, file in, si veda file in input
+In alcune banche-dati, una sola riga non address@hidden contenere in modo
adeguato
+tutte le informazioni di una voce. In questi casi si possono usare record
+multiriga.
+Il primo passo @`e quello di scegliere il formato dei dati.
+
address@hidden separatori di record, per record multiriga
+Una tecnica @`e quella di usare un carattere o una stringa non usuali per
+separare i record. Per esempio, si address@hidden usare il carattere di
interruzione di
+pagina (scritto @samp{\f} sia in @command{awk} che in C) per separarli,
+rendendo ogni record una pagina del file. Per far address@hidden, basta
impostare la
+variabile @code{RS} a @code{"\f"} (una stringa contenente il carattere di
+interruzione di pagina). Si potrebbe ugualmente usare qualsiasi altro
+carattere, sempre che non faccia parte dei dati di un record.
+
address@hidden @code{RS}, variabile, record multiriga e
+Un'altra tecnica @`e quella di usare righe vuote per separare i record.
+Per una particolare
+convenzione, una stringa nulla come valore di @code{RS} indica che i record
+sono separati da una o address@hidden righe vuote. Quando @code{RS} @`e
impostato alla
+stringa nulla, ogni record termina sempre alla prima riga vuota che @`e stata
+trovata. Il record successivo non inizia prima della successiva riga non
+vuota. Indipendentemente dal numero di righe vuote presenti in successione,
+esse costituiscono sempre un unico separatore di record.
+(Le righe vuote devono essere completamente vuote; righe che contengono
+spazi bianchi @emph{non} sono righe vuote.)
+
address@hidden stringa address@hidden lunga da sinistra, individuare la
address@hidden individuare la stringa address@hidden lunga da sinistra
+Si address@hidden ottenere lo stesso effetto di @samp{RS = ""} assegnando la
stringa
address@hidden"\n\n+"} a @code{RS}. Quest'espressione regolare individua
+il ritorno a capo alla fine del record e una o address@hidden righe vuote dopo
il
+record. In aggiunta, un'espressione regolare individua sempre la sequenza
address@hidden
+lunga possibile quando una tale stringa sia presente.
+(@address@hidden lungo da sinistra}).
+Quindi, il record successivo non inizia prima della successiva riga non
+vuota; indipendentemente dal numero di righe vuote presenti in una voce di
+banca-dati, esse sono considerate come un unico separatore di record.
+
address@hidden angolo buio, record multiriga
+Comunque, c'@`e una sostanziale differenza tra @samp{RS = ""} e @samp{RS =
+"\n\n+"}. Nel primo caso, i ritorni a capo iniziali nel @value{DF} di
+input vengono ignorati, e se un file termina senza righe vuote aggiuntive dopo
+l'ultimo record, il ritorno a capo viene rimosso dal record. Nel secondo
+caso, questa particolare elaborazione non viene fatta.
address@hidden
+
address@hidden separatore di campo, nei record multiriga
address@hidden @code{FS}, nei record multiriga
+Ora che l'input @`e separato in record, il secondo passo @`e quello di
separare i
+campi all'interno dei record. Un modo per farlo @`e quello di dividere in
+campi ognuna delle righe in input
+nel modo solito. Questo viene fatto per default tramite una
+speciale address@hidden Quando @code{RS} @`e impostato alla stringa nulla
address@hidden @code{FS} @`e impostato a un solo carattere, il carattere di
+ritorno a capo agisce @emph{sempre} come separatore di campo.
+Questo in aggiunta a tutte le separazioni di campo che risultano da
address@hidden@footnote{Quando @code{FS} @`e la stringa nulla (@code{""}), o
+un'espressione regolare, questa particolare address@hidden di @code{RS} non
+viene applicata; si applica al separatore di campo quando @`e costituito da un
+solo spazio:
address@hidden = @w{" "}}.}
+
+La motivazione originale per questa particolare eccezione probabilmente era
+quella di prevedere un comportamento che fosse utile nel caso di default
+(address@hidden, @code{FS} uguale a @address@hidden" "}}). Questa
address@hidden address@hidden
+costituire un problema se non si vuole che il carattere di ritorno a capo
+faccia da separatore tra i campi, perch@'e non c'@`e alcun modo per impedirlo.
+Tuttavia, si address@hidden aggirare il problema usando la funzione
@code{split()}
+per spezzare i record manualmente.
+(@pxref{Funzioni per stringhe}).
+Se si ha un separatore di campo costituito da un solo carattere, si
address@hidden
+aggirare la address@hidden speciale in modo diverso, trasformando @code{FS}
+in un'espressione regolare contenente
+quel carattere singolo. Per esempio, se il separatore di campo @`e
+un carattere di percentuale, al posto di
address@hidden = "%"}, si address@hidden usare @samp{FS = "[%]"}.
+
+Un altro modo per separare i campi @`e quello di
+mettere ciascun campo su una riga separata: per far questo basta impostare la
+variabile @code{FS} alla stringa @code{"\n"}.
+(Questo separatore di un solo carattere individua un singolo ritorno a capo.)
+Un esempio pratico di un @value{DF} organizzato in questo modo potrebbe essere
+un elenco di indirizzi, in cui delle righe vuote fungono da separatore fra
+record. Si consideri un elenco di indirizzi in un file chiamato
address@hidden, simile a questo:
+
address@hidden
+Jane Doe
+123 Main Street
+Anywhere, SE 12345-6789
+
+John Smith
+456 Tree-lined Avenue
+Smallville, MW 98765-4321
address@hidden
address@hidden example
+
address@hidden
+Un semplice programma per elaborare questo file @`e il seguente:
+
address@hidden
+# addrs.awk --- semplice programma per una lista di indirizzi postali
+
+# I record sono separati da righe bianche
+# Ogni riga @`e un campo.
+BEGIN @{ RS = "" ; FS = "\n" @}
+
address@hidden
+ print "Il nome @`e:", $1
+ print "L'indirizzo @`e:", $2
+ print "address@hidden e Stato sono:", $3
+ print ""
address@hidden
address@hidden example
+
+L'esecuzione del programma produce questo output:
+
address@hidden
+$ @kbd{awk -f addrs.awk addresses}
address@hidden Il nome @`e: Jane Doe
address@hidden L'indirizzo @`e: 123 Main Street
address@hidden address@hidden e Stato sono: Anywhere, SE 12345-6789
address@hidden
address@hidden Il nome @`e: John Smith
address@hidden L'indirizzo @`e: 456 Tree-lined Avenue
address@hidden address@hidden e Stato sono: Smallville, MW 98765-4321
address@hidden
address@hidden
address@hidden example
+
address@hidden labels}, per un programma address@hidden realistico per gestire
+elenchi di indirizzi. Il seguente elenco riassume come sono divisi i record,
+a seconda del valore assunto da
address@hidden
address@hidden
+(@samp{==} significa address@hidden uguale a.'')
address@hidden ifinfo
address@hidden
address@hidden:
address@hidden ifnotinfo
+
address@hidden @code
address@hidden RS == "\n"
+I record sono separati dal carattere di ritorno a capo (@samp{\n}). In
+effetti, ogni riga nel @value{DF} @`e un record separato, comprese le righe
+vuote. Questo @`e il comportamento di default.
+
address@hidden RS == @var{qualsiasi carattere singolo}
+I record sono separati da ogni ricorrenza del carattere specificato.
address@hidden
+ricorrenze adiacenti delimitano record vuoti.
+
address@hidden RS == ""
+I record sono separati da una o address@hidden righe vuote.
+Quando @code{FS} @`e un carattere singolo,
+il carattere di ritorno a capo
+serve sempre come separatore di campo, in aggiunta a qualunque valore possa
+avere @code{FS}. I ritorni a capo all'inizio e alla fine del file sono
+ignorati.
+
address@hidden RS == @var{regexp}
+I record sono separati da ricorrenze di caratteri corrispondenti a
address@hidden Le corrispondenze iniziali e finali di
address@hidden designano record vuoti.
+(Questa @`e un'estensione di @command{gawk}; non @`e specificata dallo
+standard POSIX.)
address@hidden table
+
address@hidden @command{gawk}, @code{RT} variabile in
address@hidden @code{RT}, variabile
+Se non @`e eseguito in address@hidden di address@hidden (@pxref{Opzioni}),
address@hidden imposta @code{RT} al testo di input corrispondente
+al valore specificato da @code{RS}.
+Ma se al termine del file in input non @`e stato trovato un testo che
+corrisponde a @code{RS}, @command{gawk} imposta @code{RT} alla stringa nulla.
+
address@hidden Getline
address@hidden Richiedere input usando @code{getline}
+
address@hidden @code{getline}, comando, input esplicito con
address@hidden input esplicito
+Finora abbiamo ottenuto i dati di input dal flusso di input principale di
address@hidden: lo standard input (normalmente la tastiera, a volte
+l'output di un altro programma) o i
+file indicati sulla riga di comando. Il linguaggio @command{awk} ha uno
+speciale comando predefinito chiamato @code{getline} che
address@hidden essere usato per leggere l'input sotto il diretto controllo
dell'utente.
+
+Il comando @code{getline} @`e usato in molti modi diversi e
address@hidden dovrebbe essere usato dai principianti.
+L'esempio che segue alla spiegazione del comando @code{getline}
+comprende del materiale che ancora non @`e stato trattato. Quindi, @`e meglio
+tornare indietro e studiare il comando @code{getline} @emph{dopo} aver rivisto
+il resto
address@hidden
+di questo @value{DOCUMENT}
address@hidden ifinfo
address@hidden
+di questo @value{DOCUMENT}
address@hidden ifhtml
address@hidden
address@hidden
+delle Parti I e II
address@hidden ifnothtml
address@hidden ifnotinfo
+e avere acquisito una buona conoscenza di come funziona @command{awk}.
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile, con comando @command{getline}
address@hidden differenze tra @command{awk} e @command{gawk}, comando
@code{getline}
address@hidden @code{getline}, comando, valori di ritorno
address@hidden @option{--sandbox}, opzione, ridirezione dell'input con
@code{getline}
+
+Il comando @code{getline} restituisce 1 se trova un record e 0 se
+trova la fine del file. Se si verifica qualche errore cercando di leggere
+un record, come un file che non address@hidden essere aperto, @code{getline}
+restituisce @minus{}1. In questo caso, @command{gawk} imposta la variabile
address@hidden a una stringa che descrive l'errore in questione.
+
+Se il messaggio di errore @code{ERRNO} indica che l'operazione di I/O
address@hidden
+essere ritentata e la variabile @code{PROCINFO["@var{input}", "RETRY"]} @`e
+impostata a 1, @code{getline} restituisce un codice di ritorno @minus{}2
+invece che @minus{}1, e si address@hidden provare a chiamare ulterioriormente
address@hidden @xref{Proseguire dopo errore in input} per ulteriori
+informazioni riguardo a questa address@hidden
+
+Negli esempi seguenti, @var{comando} sta per un valore di stringa che
+rappresenta un comando della shell.
+
address@hidden NOTA
+Quando @`e stata specificata l'opzione @option{--sandbox} (@pxref{Opzioni}),
+la lettura di input da file, @dfn{pipe} e coprocessi non @`e possibile.
address@hidden quotation
+
address@hidden
+* Getline semplice:: Usare @code{getline} senza argomenti.
+* Getline variabile:: Usare @code{getline} in una variabile.
+* Getline file:: Usare @code{getline} da un file.
+* Getline variabile file:: Usare @code{getline} in una variabile da un
+ file.
+* Getline @dfn{pipe}:: Usare @code{getline} da una @dfn{pipe}.
+* Getline variabile @dfn{pipe}:: Usare @code{getline} in una variabile da una
+ @dfn{pipe}.
+* Getline coprocesso:: Usare @code{getline} da un coprocesso.
+* Getline variabile coprocesso:: Usare @code{getline} in una variabile da un
+ coprocesso.
+* Note su getline:: Cose importanti da sapere su @code{getline}.
+* Sommario di getline:: Sommario delle varianti di @code{getline}.
address@hidden menu
+
address@hidden Getline semplice
address@hidden Usare @code{getline} senza argomenti
+
+Il comando @code{getline} address@hidden essere usato senza argomenti per
leggere l'input
+dal file in input corrente. Tutto quel che fa in questo caso @`e leggere il
+record in input successivo e dividerlo in campi. Questo @`e utile se @`e
+finita l'elaborarezione del record corrente, e si vogliono fare delle
+elaborazioni particolari sul record successivo @emph{proprio adesso}.
+Per esempio:
+
address@hidden
+# rimuovere il testo tra /* e */, compresi
address@hidden
+ if ((i = index($0, "/*")) != 0) @{
+ prima = substr($0, 1, i - 1) # la parte iniziale della stringa
+ dopo = substr($0, i + 2) # ... */ ...
+ j = index(dopo, "*/") # */ @`e nella parte finale?
+ if (j > 0) @{
+ dopo = substr(dopo, j + 2) # rimozione del commento
+ @} else @{
+ while (j == 0) @{
+ # passa ai record seguenti
+ if (getline <= 0) @{
+ print("Fine file inattesa o errore:", ERRNO) > "/dev/stderr"
+ exit
+ @}
+ # incrementare la riga usando la concatenazione di stringhe
+ dopo = dopo $0
+ j = index(dopo, "*/") # @`e */ nella parte finale?
+ if (j != 0) @{
+ dopo = substr(dopo, j + 2)
+ break
+ @}
+ @}
+ @}
+ # incrementare la riga di output usando la concatenazione
+ # di stringhe
+ $0 = prima dopo
+ @}
+ print $0
address@hidden
address@hidden example
+
address@hidden 8/2014: Here is some sample input:
address@hidden
+mon/*comment*/key
+rab/*commen
+t*/bit
+horse /*comment*/more text
+part 1 /*comment*/part 2 /*comment*/part 3
+no comment
address@hidden ignore
+
+Questo programma @command{awk} cancella i commenti in stile C
+(@samp{/* @dots{} */}) dall'input.
+Usa diverse address@hidden che non sono ancora state trattate, incluse la
+concatenazione di stringhe
+(@pxref{Concatenazione})
+e le funzioni predefinite @code{index()} e @code{substr()}
+(@pxref{Funzioni per stringhe}).
+Sostituendo @samp{print $0} con altre
+istruzioni, si possono effettuare elaborazioni address@hidden complesse
sull'input
+decommentato, come ricercare corrispondenze di un'espressione regolare.
+(Questo programma ha un piccolo problema: non funziona se c'@`e address@hidden
di un
+commento che inizia e finisce
+sulla stessa riga.)
+
+Questa forma del comando @code{getline} imposta @code{NF},
address@hidden, @code{FNR}, @code{RT} e il valore di @code{$0}.
+
address@hidden NOTA
+Il nuovo valore di @code{$0} @`e usato per verificare
+le espressioni di ricerca di ogni regola successiva. Il valore originale
+di @code{$0} che ha attivato la regola che ha eseguito la @code{getline}
+viene perso.
+A differenza di @code{getline}, l'istruzione @code{next} legge un nuovo record
+ma inizia a elaborarlo normalmente, a partire dalla prima
+regola presente nel programma. @xref{Istruzione next}.
address@hidden quotation
+
address@hidden Getline variabile
address@hidden Usare @code{getline} in una variabile
address@hidden @code{getline} in una variabile
address@hidden variabili, usare in comando @code{getline}
+
+Si address@hidden usare @samp{getline @var{var}} per leggere il record
successivo
+in input ad @command{awk} nella variabile @var{var}. Non vien fatta
+nessun'altra elaborazione.
+Per esempio, supponiamo che la riga successiva sia un commento o una stringa
+particolare, e la si voglia leggere senza innescare nessuna regola. Questa
+forma di @code{getline} permette di leggere quella riga e memorizzarla in una
+variabile in modo che il ciclo principale di @command{awk} che "legge una riga
+e controlla ogni regola" non la veda affatto.
+L'esempio seguente inverte tra loro a due a due le righe in input:
+
address@hidden
address@hidden
+ if ((getline tmp) > 0) @{
+ print tmp
+ print $0
+ @} else
+ print $0
address@hidden
address@hidden example
+
address@hidden
+Prende la seguente lista:
+
address@hidden
+wan
+tew
+free
+phore
address@hidden example
+
address@hidden
+e produce questo risultato:
+
address@hidden
+tew
+wan
+phore
+free
address@hidden example
+
+Il comando @code{getline} usato in questo modo imposta solo le variabili
address@hidden, @code{FNR} e @code{RT} (e, naturalmente, @var{var}).
+Il record non viene
+suddiviso in campi, e quindi i valori dei campi (compreso @code{$0}) e
+il valore di @code{NF} non cambiano.
+
address@hidden Getline file
address@hidden Usare @code{getline} da un file
+
address@hidden @code{getline} da un file
address@hidden input, ridirezione dell'
address@hidden ridirezione dell'input
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<} (I/O)
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<} (I/O)
address@hidden operatori di input/output
+Si usa @samp{getline < @var{file}} per leggere il record successivo da
address@hidden Qui, @var{file} @`e un'espressione di tipo stringa che
+specifica il @value{FN}. @samp{< @var{file}} @`e una cosidetta
address@hidden perch@'e richiede che l'input provenga da un posto
+differente. Per esempio, il seguente programma
+legge il suo record in input dal file @file{secondary.input} quando
+trova un primo campo con un valore uguale a 10 nel file in input
+corrente:
+
address@hidden
address@hidden
+ if ($1 == 10) @{
+ getline < "secondary.input"
+ print
+ @} else
+ print
address@hidden
address@hidden example
+
+Poich@'e non viene usato il flusso principale di input, i valori di @code{NR} e
address@hidden restano immutati. Comunque, il record in input viene diviso in
+modo normale, per cui vengono cambiati i valori di @code{$0} e degli altri
+campi, producendo un nuovo valore di @code{NF}.
+Viene impostato anche @code{RT}.
+
address@hidden POSIX @command{awk}, operatore @code{<} e
address@hidden Thanks to Paul Eggert for initial wording here
+Per lo standard POSIX, @samp{getline < @var{espressione}} @`e ambiguo se
address@hidden contiene operatori che non sono all'interno di parentesi,
+ad esclusione di @samp{$}; per esempio, @samp{getline < dir "/" file} @`e
+ambiguo perch@'e l'operatore di concatenazione (non ancora trattato;
address@hidden) non @`e posto tra parentesi.
+Si dovrebbe scrivere invece @samp{getline < (dir "/" file)}, se il
+programma dev'essere portabile su tutte le implementazioni di @command{awk}.
+
address@hidden Getline variabile file
address@hidden Usare @code{getline} in una variabile da un file
address@hidden variabili, usare in comando @code{getline}
+
+Si usa @samp{getline @var{var} < @var{file}} per leggere l'input
+dal file
address@hidden, e metterlo nella variabile @var{var}. Come prima, @var{file}
address@hidden un'espressione di tipo stringa che specifica il file dal quale
+legggere.
+
+In questa versione di @code{getline}, nessuna delle variabili predefinite @`e
+cambiata e il record non @`e diviso in campi. La sola variabile cambiata @`e
address@hidden@footnote{Questo non @`e completamente vero. @code{RT}
address@hidden essere
+cambiato se @code{RS} @`e un'espressione regolare.}
+Per esempio, il seguente programma copia tutti i file in input nell'output, ad
+eccezione dei record che dicono @address@hidden@@include @var{nomefile}}}.
+Tale record @`e sostituito dal contenuto del file
address@hidden:
+
address@hidden
address@hidden
+ if (NF == 2 && $1 == "@@include") @{
+ while ((getline line < $2) > 0)
+ print line
+ close($2)
+ @} else
+ print
address@hidden
address@hidden example
+
+Si noti come il nome del file in input aggiuntivo non compaia all'interno del
+programma; @`e preso direttamente dai dati, e precisamente dal secondo campo
+della riga di @code{@@include}.
+
+La funzione @code{close()} viene chiamata per assicurarsi che se nell'input
+appaiono due righe @code{@@include} identiche, l'intero file specificato sia
+incluso ogni volta.
address@hidden file e @dfn{pipe}}.
+
+Una carenza di questo programma @`e che non gestisce istruzioni
address@hidden@@include} nidificate
+(address@hidden, istruzioni @code{@@include} contenute nei file inclusi)
+nel modo in cui ci si aspetta che funzioni un vero preelaboratore di macro.
address@hidden igawk} per un programma
+che gestisce le istruzioni @code{@@include} nidificate.
+
address@hidden Getline @dfn{pipe}
address@hidden Usare @code{getline} da una @dfn{pipe}
+
address@hidden From private email, dated October 2, 1988. Used by permission,
March 2013.
address@hidden Kernighan, Brian
address@hidden
address@hidden'onniscienza ha molti aspetti positivi.
+Se non si address@hidden ottenerla, l'attenzione ai dettagli address@hidden
aiutare.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden @code{|} (barra verticale), operatore @code{|} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|} (I/O)
address@hidden input, @dfn{pipeline}
address@hidden @dfn{pipe}, input
address@hidden operatori, input/output
+L'output di un comando address@hidden anche essere convogliato in
@code{getline}, usando
address@hidden@var{comando} | getline}. In
+questo caso, la stringa @var{comando} viene eseguita come comando di shell e
+il suo output @`e passato ad @command{awk} per essere usato come input.
+Questa forma di @code{getline} legge un record alla volta dalla @dfn{pipe}.
+Per esempio, il seguente programma copia il suo input nel suo output,
+ad eccezione delle righe che iniziano con @samp{@@execute}, che sono
+sostituite dall'output prodotto dall'esecuzione del resto della riga
+costituito da un comando di shell.
+
address@hidden
address@hidden
+ if ($1 == "@@execute") @{
+ tmp = substr($0, 10) # Rimuove "@@execute"
+ while ((tmp | getline) > 0)
+ print
+ close(tmp)
+ @} else
+ print
address@hidden
address@hidden example
+
address@hidden
+La funzione @code{close()} viene chiamata per assicurarsi che, se appaiono
+nell'input due righe @samp{@@execute} identiche, il comando sia eseguito per
+ciascuna di esse.
address@hidden
address@hidden
address@hidden file e @dfn{pipe}}.
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden This example is unrealistic, since you could just use system
+Dato l'input:
+
address@hidden
+pippo
+pluto
+paperino
+@@execute who
+gastone
address@hidden example
+
address@hidden
+il programma potrebbe produrre:
+
address@hidden Robbins, Bill
address@hidden Robbins, Miriam
address@hidden Robbins, Arnold
address@hidden
+pippo
+pluto
+paperino
+arnold ttyv0 Jul 13 14:22
+miriam ttyp0 Jul 13 14:23 (murphy:0)
+bill ttyp1 Jul 13 14:23 (murphy:0)
+gastone
address@hidden example
+
address@hidden
+Si osservi che questo programma ha eseguito @command{who} e stampato il
+risultato. (Eseguendo questo programma, @`e chiaro che ciascun utente
address@hidden
+risultati diversi, a seconda di chi @`e collegato al sistema.)
+
+Questa variante di @code{getline} divide il record in campi, imposta il valore
+di @code{NF}, e ricalcola il valore di @code{$0}. I valori di
address@hidden e @code{FNR} non vengono cambiati.
+Viene impostato @code{RT}.
+
address@hidden POSIX @command{awk}, operatore I/O @code{|} e
address@hidden Thanks to Paul Eggert for initial wording here
+Per lo standard POSIX, @address@hidden | getline} @`e ambiguo se
address@hidden contiene operatori che non sono all'interno di parentesi,
+ad esclusione di @samp{$}. Per esempio,
address@hidden@w{"echo "} "date" | getline} @`e ambiguo perch@'e
+l'operatore di concatenazione non @`e tra parentesi. Si dovrebbe scrivere
+invece @samp{(@w{"echo "} "date") | getline}, se il programma dev'essere
+portabile su tutte le implementazioni di @command{awk}.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden NOTA
+Sfortunatamente, @command{gawk} non ha un comportamento uniforme nel
+trattare un costrutto come @address@hidden"echo "} "date" | getline}.
+La maggior parte delle versioni, compresa la versione corrente, lo tratta
+come @address@hidden("echo "} "date") | getline}.
+(Questo @`e anche il comportamento di BWK @command{awk}.)
+Alcune versioni invece lo trattano come
address@hidden@w{"echo "} ("date" | getline)}.
+(Questo @`e il comportamento di @command{mawk}.)
+In breve, per evitare problemi, @`e @emph{sempre} meglio usare parentesi
+esplicite.
address@hidden quotation
+
address@hidden Getline variabile @dfn{pipe}
address@hidden Usare @code{getline} in una variabile da una @dfn{pipe}
address@hidden variabili, usare in comando @code{getline}
+
+Quando si usa @address@hidden | getline @var{var}},
+l'output di @var{comando} @`e inviato tramite una @dfn{pipe} a
address@hidden ad una variabile @var{var}. Per esempio, il
+seguente programma legge la data e l'ora corrente nella variabile
address@hidden, usando il programma di address@hidden @command{date}, e poi lo
+stampa:
+
address@hidden
+BEGIN @{
+ "date" | getline current_time
+ close("date")
+ print "Report printed on " current_time
address@hidden
address@hidden example
+
+In questa versione di @code{getline}, nessuna delle variabili predefinite @`e
+cambiata e il record non @`e diviso in campi. In ogni caso, @code{RT} viene
+impostato.
+
address@hidden
address@hidden Thanks to Paul Eggert for initial wording here
+Per lo standard POSIX, @address@hidden | getline @var{var}} @`e ambiguo
+se @var{espressione} contiene operatori che non sono all'interno di parentesi
+ad esclusione di @samp{$}; per esempio,
address@hidden@w{"echo "} "date" | getline @var{var}} @`e ambiguo
+perch@'e l'operatore di concatenazione non @`e tra parentesi. Si dovrebbe
+scrivere invece @samp{(@w{"echo "} "date") | getline @var{var}} se il
+programma dev'essere portabile su tutte le implementazioni di @command{awk}.
address@hidden ifinfo
+
address@hidden Getline coprocesso
address@hidden Usare @code{getline} da un coprocesso
address@hidden coprocessi, @code{getline} da
address@hidden @code{getline}, comando, address@hidden usare dal
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|&} (I/O)
address@hidden operatori, input/output
address@hidden differenze tra @command{awk} e @command{gawk}, operatori di
input/output
+
+Leggere dell'input in @code{getline} da una @dfn{pipe} @`e un'operazione
+unidirezionale.
+Il comando avviato con @address@hidden | getline} invia dati
address@hidden programma @command{awk}.
+
+Occasionalmente, si potrebbe avere la address@hidden di inviare dei dati a un
altro
+programma che li elabori, per poi leggere il risultato che esso genera.
address@hidden permette di avviare un @dfn{coprocesso}, col quale sono
+possibili comunicazioni bidirezionali. Questo vien fatto con l'operatore
address@hidden|&}.
+Tipicamente, dapprima si inviano dati al coprocesso e poi si leggono
+i risultati da esso prodotto, come mostrato di seguito:
+
address@hidden
+print "@var{some query}" |& "db_server"
+"db_server" |& getline
address@hidden example
+
address@hidden
+esso invia una richiesta a @command{db_server} e poi legge i risultati.
+
+I valori di @code{NR} e
address@hidden non vengono cambiati,
+perch@'e non @`e cambiato il flusso principale.
+In ogni caso, il record @`e diviso in campi
+nel solito modo, cambiando address@hidden@dotless{i}} i valori di @code{$0},
degli altri campi,
+e di @code{NF} e @code{RT}.
+
+I coprocessi sono una address@hidden avanzata. Vengono trattati qui solo
perch@'e
address@hidden
+questa @`e la
address@hidden ifnotinfo
address@hidden
+questo @`e il
address@hidden ifinfo
address@hidden su @code{getline}.
address@hidden/O bidirezionale},
+dove i coprocessi vengono trattati address@hidden dettagliatamente.
+
address@hidden Getline variabile coprocesso
address@hidden Usare @code{getline} in una variabile da un coprocesso
address@hidden variabili, usare in comando @code{getline}
+
+Quando si usa @address@hidden |& getline @var{var}}, l'output dal
+coprocesso @var{comando} viene inviato tramite una @dfn{pipe} bidirezionale a
address@hidden e nella variabile @var{var}.
+
+In questa versione di @code{getline}, nessuna delle variabili predefinite
+viene cambiata e il record non viene diviso in campi. La sola variabile che
+cambia @`e @var{var}.
+In ogni caso, @code{RT} viene impostato.
+
address@hidden
+I coprocessi sono una address@hidden avanzata. Vengono trattati qui solo
perch@'e
+questo @`e il @value{SECTION} su @code{getline}.
address@hidden/O bidirezionale},
+dove i coprocessi vengono trattati address@hidden dettagliatamente.
address@hidden ifinfo
+
address@hidden Note su getline
address@hidden Cose importanti da sapere riguardo a @code{getline}
+Qui sono elencate diverse considerazioni su @code{getline}
+da tener presenti:
+
address@hidden @value{BULLET}
address@hidden
+Quando @code{getline} cambia il valore di @code{$0} e @code{NF},
address@hidden @emph{non} salta automaticamente all'inizio del
+programma per iniziare a provare il nuovo record su ogni criterio di ricerca.
+Comunque, il nuovo record viene provato su ogni regola successiva.
+
address@hidden differenze tra @command{awk} e @command{gawk}, limitazioni di
implementazione
address@hidden implementazione, problemi, @command{gawk}, limiti
address@hidden @command{awk}, implementazioni, limiti
address@hidden @command{gawk}, problemi di implementazioni, limiti
address@hidden
+Alcune tra le prime implementazioni di @command{awk} limitano a una sola il
+numero di @dfn{pipeline} che un programma @command{awk} address@hidden tenere
aperte.
+In @command{gawk}, non c'@`e questo limite.
+Si possono aprire tante @dfn{pipeline} (e coprocessi) quante ne permette il
+sistema operativo in uso.
+
address@hidden effetti collaterali, variabile @code{FILENAME}
address@hidden @code{FILENAME}, variabile, impostare con @code{getline}
address@hidden angolo buio, variabile @code{FILENAME}
address@hidden @code{getline}, comando, variabile @code{FILENAME} e
address@hidden @code{BEGIN}, criterio di ricerca, @code{getline} e
address@hidden
+Un interessante effetto collaterale si ha se si usa @code{getline}, senza
+una ridirezione, all'interno di una regola @code{BEGIN}. Poich@'e una
address@hidden non ridiretta legge dai @value{DF} specificati nella riga di
+comando, il primo comando @code{getline} fa address@hidden@dotless{i}} che
@command{awk} imposti
+il valore di @code{FILENAME}. Normalmente, @code{FILENAME} non ha ancora un
+valore all'interno delle regole @code{BEGIN}, perch@'e non si @`e ancora
+iniziato a elaborare il
address@hidden della riga di comando.
address@hidden
+(Si veda @ref{BEGIN/END};
+e @pxref{Variabili auto-assegnate}.)
+
address@hidden
+Usare @code{FILENAME} con @code{getline}
+(@samp{getline < FILENAME})
address@hidden essere fonte di
+confusione. @command{awk} apre un flusso separato di input, diverso dal
+file in input corrente. Comunque, poich@'e non si usa una variabile,
address@hidden e @code{NF} vengono aggiornati. Se si sta facendo questo, @`e
+probabilmente per sbaglio, e si dovrebbe rivedere quello che si sta cercando
+di fare.
+
address@hidden
address@hidden
+La prossima @value{SECTION}
address@hidden ifdocbook
address@hidden
address@hidden di getline},
address@hidden ifnotdocbook
+contiene una tabella che sintetizza le
+varianti di @code{getline} e le variabili da esse modificate.
address@hidden degno di nota che le varianti che non usano la ridirezione
+possono far address@hidden@dotless{i}} che @code{FILENAME} venga aggiornato se
chiedono ad
address@hidden di iniziare a leggere un nuovo file in input.
+
address@hidden
address@hidden Moore, Duncan
+Se la variabile assegnata @`e un'espressione con effetti collaterali, versioni
+differenti di @command{awk} si comportano in modo diverso quando trovano la
+fine-del-file [EOF]. Alcune versioni non valutano l'espressione; molte
+versioni (compreso @command{gawk}) lo fanno. Si veda un esempio, gentilmente
+fornito da Duncan Moore:
+
address@hidden
+Date: Sun, 01 Apr 2012 11:49:33 +0100
+From: Duncan Moore <duncan.moore@@gmx.com>
address@hidden ignore
+
address@hidden
+BEGIN @{
+ system("echo 1 > f")
+ while ((getline a[++c] < "f") > 0) @{ @}
+ print c
address@hidden
address@hidden example
+
address@hidden
+Qui l'effetto secondario @`e @samp{++c}. Se viene trovata la fine del file
address@hidden di assegnare l'elemento @code{a}, @code{c} @`e incrementato o no?
+
address@hidden tratta @code{getline} come una chiamata di funzione, e valuta
+l'espressione @samp{a[++c]} prima di cercare di leggere da @file{f}.
+Comunque, alcune versioni di @command{awk} valutano l'espressione solo
+se c'@`e un valore di stringa da assegnare.
address@hidden itemize
+
address@hidden Sommario di getline
address@hidden Sommario delle varianti di @code{getline}
address@hidden @code{getline}, comando, varianti
+
+La @ref{tabella-varianti-getline}
+riassume le otto varianti di @code{getline},
+elencando le variabili predefinite che sono impostate da ciascuna di esse,
+e se la variante @`e standard o @`e un'estensione di @command{gawk}.
+Nota: per ogni variante, @command{gawk} imposta la variabile predefinita
address@hidden
+
address@hidden Tabella,tabella-varianti-getline
address@hidden di @code{getline} e variabili impostate da ognuna}
address@hidden @columnfractions .33 .38 .27
address@hidden Variante @tab Effetto @tab @command{awk} / @command{gawk}
address@hidden @code{getline} @tab Imposta @code{$0}, @code{NF}, @code{FNR},
@code{NR}, e @code{RT} @tab @command{awk}
address@hidden @code{getline} @var{var} @tab Imposta @var{var}, @code{FNR},
@code{NR}, e @code{RT} @tab @command{awk}
address@hidden @code{getline <} @var{file} @tab Imposta @code{$0}, @code{NF}, e
@code{RT} @tab @command{awk}
address@hidden @code{getline @var{var} < @var{file}} @tab Imposta @var{var} e
@code{RT} @tab @command{awk}
address@hidden @var{comando} @code{| getline} @tab Imposta @code{$0},
@code{NF}, e @code{RT} @tab @command{awk}
address@hidden @var{comando} @code{| getline} @var{var} @tab Imposta @var{var}
e @code{RT} @tab @command{awk}
address@hidden @var{comando} @code{|& getline} @tab Imposta @code{$0},
@code{NF}, e @code{RT} @tab @command{gawk}
address@hidden @var{comando} @code{|& getline} @var{var} @tab Imposta @var{var}
e @code{RT} @tab @command{gawk}
address@hidden multitable
address@hidden float
+
address@hidden Timeout in lettura
address@hidden Leggere input entro un tempo limite
address@hidden tempo limite, leggere input
address@hidden @dfn{timeout}, si veda tempo limite
+
address@hidden differenze tra @command{awk} e @command{gawk}, tempo limite per
lettura
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
+Si address@hidden specificare un tempo limite in millisecondi per leggere
l'input dalla
+tastiera, da una @dfn{pipe} o da una comunicazione bidirezionale, compresi i
address@hidden TCP/IP. Questo address@hidden essere fatto per input, per
comando o per
+connessione, impostando un elemento speciale nel vettore @code{PROCINFO}
+(@pxref{Variabili auto-assegnate}):
+
address@hidden
+PROCINFO["nome_input", "READ_TIMEOUT"] = @var{tempo limite in millisecondi}
address@hidden example
+
+Se @`e impostato, @command{gawk} smette di attendere una risposta e restituisce
+insuccesso se non sono disponibili dati da leggere entro il limite di tempo
+specificato. Per esempio, un cliente TCP address@hidden decidere di
abbandonare se
+non riceve alcuna risposta dal server dopo un certo periodo di tempo:
+
address@hidden
+Service = "/inet/tcp/0/localhost/daytime"
+PROCINFO[Service, "READ_TIMEOUT"] = 100
+if ((Service |& getline) > 0)
+ print $0
+else if (ERRNO != "")
+ print ERRNO
address@hidden example
+
+Qui vediamo come ottenere dati interattivamente dall'address@hidden
+presuppone che lo standard input provenga dalla tastiera.} aspettando per
+non address@hidden di cinque secondi:
+
address@hidden
+PROCINFO["/dev/stdin", "READ_TIMEOUT"] = 5000
+while ((getline < "/dev/stdin") > 0)
+ print $0
address@hidden example
+
address@hidden termina l'operazione di lettura se l'input non
+arriva entro il periodo di tempo limite, restituisce insuccesso
+e imposta @code{ERRNO} a una stringa di valore adeguato.
+Un valore del tempo limite negativo o pari a zero equivale a non specificare
+affatto un tempo limite.
+
+Si address@hidden impostare un tempo limite anche per leggere dalla tastiera
nel ciclo
+implicito che legge i record in input e li confronta coi criteri di ricerca,
+come:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ PROCINFO["-", "READ_TIMEOUT"] = 5000 @}}
+> @address@hidden print "You entered: " $0 @}'}
address@hidden
address@hidden You entered: gawk
address@hidden example
+
+In questo caso, la mancata risposta entro cinque secondi address@hidden luogo
al seguente
+messaggio di errore:
+
address@hidden
address@hidden questo @`e l'output effettivo - Antonio
address@hidden gawk: linea com.:2: (FILENAME=- FNR=1) fatale: errore leggendo
address@hidden file in input `-': Connessione scaduta
address@hidden example
+
+Il tempo limite address@hidden essere impostato o cambiato in qualsiasi
momento, e address@hidden
+effetto al tentativo successivo di leggere dal dispositivo di input. Nel
+seguente esempio, partiamo con un valore di tempo limite di un secondo e
+lo riduciamo progressivamente di un decimo di secondo finch@'e l'attesa
+per l'input diventa illimitata.
+
address@hidden
+PROCINFO[Service, "READ_TIMEOUT"] = 1000
+while ((Service |& getline) > 0) @{
+ print $0
+ PROCINFO[Service, "READ_TIMEOUT"] -= 100
address@hidden
address@hidden example
+
address@hidden NOTA
+Non si deve dare per scontato che l'operazione di lettura si blocchi
+esattamente dopo che @`e stato stampato il decimo record. @`E possibile che
address@hidden legga e tenga in memoria i dati di address@hidden di un record
+la prima volta. Per questo, cambiare il valore del tempo
+limite come nell'esempio appena visto non @`e molto utile.
address@hidden quotation
+
+Se l'elemento di @code{PROCINFO} non @`e presente e la variabile d'ambiente
address@hidden esiste,
address@hidden usa il suo valore per inizializzare il valore di tempo limite.
+L'uso esclusivo della variabile d'ambiente per specificare il tempo limite
+ha lo svantaggio di non essere
+adattabile per ogni comando o per ogni connessione.
+
address@hidden considera errore un superamento di tempo limite anche se
+il tentativo di leggere dal dispositivo sottostante potrebbe riuscire
+in un tentativo successivo. Questa @`e una limitazione, e inoltre
+significa che non @`e possibile usarlo per ottenere input multipli,
+provenienti da due o address@hidden sorgenti. @xref{Proseguire dopo errore in
input}
+per una address@hidden che consente di tentare ulteriori operazioni di I/O.
+
+Assegnare un valore di tempo limite previene un blocco a tempo indeterminato
+legato a operazioni di lettura. Si tenga address@hidden presente che ci sono
altre
+situazioni in cui @command{gawk} address@hidden restare bloccato in attesa che
un
+dispositivo di input sia pronto. Un cliente di rete a volte address@hidden
impiegare
+molto tempo per stabilire una
+connessione prima di poter iniziare a leggere qualsiasi dato,
+oppure il tentativo di aprire un file speciale FIFO in lettura address@hidden
bloccarsi
+indefinitamente in attesa che qualche altro processo lo apra in scrittura.
+
address@hidden Proseguire dopo errore in input
address@hidden Elaborare ulteriore input dopo certi errori di I/O
address@hidden proseguire dopo errore in input
address@hidden errore in input, address@hidden di proseguire
+
address@hidden differenze tra @command{awk} e @command{gawk}, proseguire dopo
errore in input
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
+Qualora @command{gawk} incontri un errore durante la lettura dell'input,
+per default @code{getline} ha come codice di ritorno @minus{}1, e i
+successivi tentativi di leggere dallo stesso file restituiscono una
+indicazione di fine-file. @`E tuttavia possibile chiedere a
address@hidden di consentire un ulteriore tentativo di lettura in presenza
+di certi errori, impostando uno speciale elemento del vettore
address@hidden (@pxref{Variabili auto-assegnate}):
+
address@hidden
+PROCINFO["@var{nome_input_file}", "RETRY"] = 1
address@hidden example
+
+Quando un tale elemento esiste, @command{gawk} controlla il valore della
+variabile di sistema
+(nel linguaggio C)
address@hidden quando si verifica un errore di I/O.
+Se @code{errno} indica che un ulteriore tentativo di lettura address@hidden
+terminare con successo, @code{getline} ha come codice di ritorno @minus{}2
+e ulteriori chiamate a @code{getline} possono terminare correttamente.
+Questo vale per i seguenti valori di @code{errno}: @code{EAGAIN},
address@hidden, @code{EINTR}, e @code{ETIMEDOUT}.
+
+Questa address@hidden @`e utile quando si assegna un valore all'elemento
address@hidden"@var{nome_input_file}", "READ_TIMEOUT"]} o in situazioni
+in cui un descrittore di file sia stato configurato per comportarsi in
+modo non bloccante.
+
address@hidden Directory su riga di comando
address@hidden Directory sulla riga di comando
address@hidden differenze tra @command{awk} e @command{gawk}, directory sulla
riga di comando
address@hidden directory, riga di comando
address@hidden riga di comando, directory su
+
+Per lo standard POSIX, i file che compaiono sulla riga di comando di
address@hidden devono essere file di testo; @`e un errore fatale se non lo sono.
+La maggior parte delle versioni di @command{awk} genera un errore fatale
+quando trova una directory sulla riga di comando.
+
+Per default, @command{gawk} emette un avvertimento se c'@`e una directory sulla
+riga di comando, e in ogni caso la ignora. Questo rende address@hidden facile
usare
+metacaratteri di shell col proprio programma @command{awk}:
+
address@hidden
+$ @kbd{gawk -f whizprog.awk *} @ii{Le directory potrebbero far fallire il
programma}
address@hidden example
+
+Se viene data una delle opzioni @option{--posix}
+o @option{--traditional}, @command{gawk} considera invece
+una directory sulla riga di comando come un errore fatale.
+
address@hidden di estensione Readdir} per un modo di trattare le directory
+come dati usabili da un programma @command{awk}.
+
address@hidden 2
address@hidden Sommario di Input
address@hidden Sommario di Input
+
address@hidden @value{BULLET}
address@hidden
+L'input @`e diviso in record in base al valore di @code{RS}.
+Le address@hidden sono le seguenti:
+
address@hidden @columnfractions .28 .45 .40
address@hidden Valore di @code{RS} @tab Record separati da @dots{} @tab
@command{awk} / @command{gawk}
address@hidden Un carattere singolo @tab Quel carattere @tab @command{awk}
address@hidden La stringa nulla (@code{""}) @tab Serie di due o address@hidden
ritorni a capo @tab @command{awk}
address@hidden Un'espressione regolare @tab Testo corrispondente alla
@dfn{regexp} @tab @command{gawk}
address@hidden multitable
+
address@hidden
address@hidden indica quanti record sono stati letti dal file in input corrente;
address@hidden indica quanti record sono stati letti in totale.
+
address@hidden
address@hidden imposta @code{RT} al testo individuato da @code{RS}.
+
address@hidden
+Dopo la divisione dell'input in record, @command{awk} divide
+i record in singoli campi, chiamati @code{$1}, @code{$2} e
address@hidden@dotless{i}}
+via. @code{$0} @`e l'intero record, e @code{NF} indica quanti campi
+contiene. Il metodo di default per dividere i campi utilizza i
+caratteri di spazio vuoto.
+
address@hidden Si address@hidden far riferimento ai campi usando una variabile,
come in @code{$NF}.
+Ai campi possono anche essere assegnati dei valori, e questo implica che il
+valore di @code{$0} sia ricalcolato se ad esso si fa riferimento in seguito.
+Fare un assegnamento a un campo con un numero maggiore di @code{NF} crea il
+campo e ricostruisce il record, usando @code{OFS} per separare i campi.
+Incrementare @code{NF} fa la stessa cosa. Decrementare @code{NF} scarta dei
+campi e ricostruisce il record.
+
address@hidden
+Separare i campi @`e address@hidden complicato che separare i record.
+
address@hidden @columnfractions .40 .40 .20
address@hidden Valore del separatore di campo @tab Campi separati @dots{} @tab
@command{awk} / @command{gawk}
address@hidden @code{FS == " "} @tab Da serie di spazi vuoti @tab @command{awk}
address@hidden @code{FS == @var{un solo carattere}} @tab Da quel carattere @tab
@command{awk}
address@hidden @code{FS == @var{espr. reg.}} @tab Dal testo che corrisponde
alla @dfn{regexp} @tab @command{awk}
address@hidden @code{FS == ""} @tab address@hidden@dotless{i}} ogni singolo
carattere @`e un campo separato @tab @command{gawk}
address@hidden @code{FIELDWIDTHS == @var{lista di colonne}} @tab Basata sulla
posizione del carattere @tab @command{gawk}
address@hidden @code{FPAT == @var{regexp}} @tab Dal testo attorno al testo
corrispondente alla @dfn{regexp} @tab @command{gawk}
address@hidden multitable
+
address@hidden
+Usando @samp{FS = "\n"} l'intero record address@hidden un unico campo
+(nell'ipotesi che i record siano separati da caratteri di ritorno a capo).
+
address@hidden
address@hidden address@hidden essere impostato dalla riga di comando con
l'opzione
address@hidden
+Si address@hidden fare la stessa cosa usando un assegnamento di variabile da
riga di
+comando.
+
address@hidden
address@hidden"FS"]} permette di sapere come i campi sono separati.
+
address@hidden
address@hidden nelle sue diverse forme serve per leggere record aggiuntivi
+provenienti dal flusso di input di default, da un file, o da una @dfn{pipe}
+o da un coprocesso.
+
address@hidden
address@hidden@var{file}, "READ_TIMEOUT"]} si address@hidden usare per
impostare un
+tempo limite alle operazioni di lettura da @var{file}.
+
address@hidden
+Le directory sulla riga di comando generano un errore fatale per
address@hidden standard;
address@hidden le ignora se non @`e in address@hidden POSIX.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi su Input
address@hidden Esercizi
+
address@hidden
address@hidden
+Usando la variabile @code{FIELDWIDTHS} (@pxref{Dimensione costante}),
+scrivere un programma per leggere i dati delle elezioni, dove ogni record
+rappresenta i voti di un votante. Trovare un modo per definire quali colonne
+sono associate a ogni quesito elettorale, e stampare i voti totali,
+comprese le astensioni, per ciascun quesito.
address@hidden
+La @ref{Getline semplice}, ha illustrato un programma per rimuovere i commenti
+in stile C (@samp{/* @dots{} */}) dall'input. Quel programma
+non funziona se un commento termina in una riga e il successivo commento
+inizia nella stessa riga.
+Il problema si address@hidden risolvere con una semplice modifica. Quale?
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden Stampare
address@hidden Stampare in output
+
address@hidden stampare
address@hidden output, stampare, si veda stampare
+Una delle azioni che un programma fa address@hidden comunemente, @`e quella di
produrre
address@hidden, ossia scrivere in output l'input letto, tutto o in parte.
+Si address@hidden usare l'istruzione @code{print} per una stampa semplice, e
l'istruzione
address@hidden per una formattazione dell'output address@hidden sofisticata.
+L'istruzione @code{print} non ha un limite al numero di elementi quando
+calcola @emph{quali} valori stampare. Peraltro, con due eccezioni,
+non @`e possibile specificare @emph{come} stamparli: quante
+colonne, se usare una notazione esponenziale o no, etc.
+(Per le eccezioni, @pxref{Separatori di output} e
+la @ref{OFMT}.)
+Per stampare fornendo delle specifiche, @`e necessario usare
+l'istruzione @code{printf}
+(@pxref{Printf}).
+
address@hidden istruzione @code{print}
address@hidden istruzione @code{printf}
+Oltre alla stampa semplice e formattata, questo @value{CHAPTER}
+esamina anche le ridirezioni di I/O verso file e @dfn{pipe}, introduce
+i @value{FNS} speciali che @command{gawk} elabora internamente,
+e parla della funzione predefinita @code{close()}.
+
address@hidden
+* Print:: L'istruzione @code{print}.
+* Esempi su print:: Semplici esempi di
+ istruzioni @code{print}.
+* Separatori di output:: I separatori di output e come
+ modificarli.
+* OFMT:: Controllare l'output di numeri con
+ @code{print}.
+* Printf:: l'istruzione @code{printf}.
+* Ridirezione:: Come ridirigere l'output a diversi
+ file e @dfn{pipe}.
+* FD speciali:: I/O con FD [Descrittori File]
+ speciali.
+* File speciali:: Interpretazione nomi file in
+ @command{gawk}. @command{gawk}
+ Permette di accedere a descrittori
+ file address@hidden aperti a inizio esecuzione
+* Chiusura file e @dfn{pipe}:: Chiudere file in input e di output e
+ @dfn{pipe}.
+* Continuazione dopo errori:: Abilitare continuazione dopo errori
+ in output.
+* Sommario di Output:: Sommario di Output.
+* Esercizi su Output:: Esercizi.
address@hidden menu
+
address@hidden Print
address@hidden L'istruzione @code{print}
+
+L'istruzione @code{print} si usa per produrre dell'output formattato in
+maniera semplice, standardizzata. Si
+specificano solo le stringhe o i numeri
+da stampare, in una lista separata da virgole. Questi elementi sono stampati,
+separati tra loro da spazi singoli, e alla fine viene stampato un ritorno a
+capo. L'istruzione @`e simile a questa:
+
address@hidden
+print @var{elemento1}, @var{elemento2}, @dots{}
address@hidden example
+
address@hidden
+L'intera lista di elementi address@hidden facoltativamente essere racchiusa fra
+parentesi. Le parentesi sono obbligatorie se qualche espressione presente
+in uno degli elementi usa l'operatore relazionale @samp{>}, che potrebbe
+essere confuso con una ridirezione dell'output (@pxref{Ridirezione}).
+
+Gli elementi da stampare possono essere stringhe costanti o numeri, campi
+del record corrente (come @code{$1}), variabili, o quasiasi espressione
address@hidden I valori numerici sono convertiti in stringhe prima di essere
+stampati.
+
address@hidden record, stampare
address@hidden righe, vuote, stampare
address@hidden testo, stampare
+Una semplice istruzione @samp{print} senza specificare elementi equivale a
address@hidden $0}: stampa l'intero record corrente. Per stampare una riga
+vuota, si usa @samp{print ""}.
+Per stampare un testo che non cambia, si usi come elemento una costante
+stringa, per esempio @address@hidden"Non v'allarmate"}}. Dimenticandosi di
mettere
+i doppi apici, il testo @`e preso per un'espressione @command{awk},
+e probabilmente address@hidden emesso un messaggio di errore. Occorre tener
presente
+che tra ogni coppia di elementi viene stampato uno spazio.
+
+Si noti che l'istruzione @code{print} @`e un'istruzione, e non
+un'espressione: non @`e possibile usarla nella parte modello [di ricerca] di
+un'istruzione @dfn{criterio di ricerca--azione}, per esempio.
+
address@hidden Esempi su print
address@hidden Esempi di istruzioni @code{print}
+
+Ogni istruzione @code{print} produce almeno una riga in output. Comunque,
+non @`e limitata a una sola riga. Se il valore di un elemento @`e una stringa
+che contiene un ritorno a capo, il ritorno a capo @`e stampato insieme al
+resto della stringa. Una
+singola istruzione @code{print} address@hidden in questo modo generare un
numero
+qualsiasi di righe.
+
address@hidden ritorno a capo, stampare un
+Quel che segue @`e un esempio di stampa di una stringa che contiene al suo
+interno dei
address@hidden
+ritorni a capo
+(la @samp{\n} @`e una sequenza di protezione, che si usa per rappresentare il
+carattere di ritorno a capo; @pxref{Sequenze di protezione}):
address@hidden ifinfo
address@hidden
+ritorni a capo
+(la @samp{\n} @`e una sequenza di protezione, che si usa per rappresentare il
+carattere di ritorno a capo; @pxref{Sequenze di protezione}):
address@hidden ifhtml
address@hidden
address@hidden
+ritorni a capo:
address@hidden ifnothtml
address@hidden ifnotinfo
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "riga uno\nriga due\nriga tre" @}'}
address@hidden riga uno
address@hidden riga due
address@hidden riga tre
address@hidden example
+
address@hidden campi, stampare
+Il prossimo esempio, eseguito sul file @file{inventory-shipped},
+stampa i primi due campi di ogni record in input, separandoli con uno
+spazio:
+
address@hidden
+$ @kbd{awk '@{ print $1, $2 @}' inventory-shipped}
address@hidden Jan 13
address@hidden Feb 15
address@hidden Mar 15
address@hidden
address@hidden example
+
address@hidden istruzione @code{print}, virgole, omettere
address@hidden debug, istruzione @address@hidden omissione virgole
+Un errore frequente usando l'istruzione @code{print} @`e quello di tralasciare
+la virgola tra due elementi. Questo ha spesso come risultato la stampa di
+elementi attaccati tra loro, senza lo spazio di separazione. Il motivo per
+cui address@hidden accade @`e che la scrittura di due
+espressioni di stringa in @command{awk} ne indica la concatenazione. Qui si
+vede l'effetto dello stesso programma,
+senza le virgole:
+
address@hidden
+$ @kbd{awk '@{ print $1 $2 @}' inventory-shipped}
address@hidden Jan13
address@hidden Feb15
address@hidden Mar15
address@hidden
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, intestazioni, aggiungere
+Per chi non conosce il file @file{inventory-shipped} nessuno
+dei due output di esempio risulta molto comprensibile. Una riga iniziale di
+intestazione li renderebbe address@hidden chiari.
+Aggiungiamo qualche intestazione alla nostra tabella dei mesi
+(@code{$1}) e dei contenitori verdi spediti (@code{$2}). Lo facciamo usando
+una regola @code{BEGIN} (@pxref{BEGIN/END}) in modo che le intestazioni siano
+stampate una volta sola:
+
address@hidden
+awk 'BEGIN @{ print "Mese Contenitori"
+ print "----- -----------" @}
+ @{ print $1, $2 @}' inventory-shipped
address@hidden example
+
address@hidden
+Una volta eseguito, il programma stampa questo:
+
address@hidden
+Mese Contenitori
+----- -----------
+Jan 13
+Feb 15
+Mar 15
address@hidden
address@hidden example
+
address@hidden
+Il solo problema, in effetti, @`e che le intestazioni e i dati della tabella
+non sono allineati! Possiamo provvedere stampando alcuni spazi tra i due
+campi:
+
address@hidden
address@hidden
+awk 'BEGIN @{ print "Mese Contenitori"
+ print "----- -----------" @}
+ @{ print $1, " ", $2 @}' inventory-shipped
address@hidden group
address@hidden example
+
address@hidden istruzione @code{printf}, address@hidden allineamento
address@hidden colonne, allineamento
+Allineare le colonne in questo modo address@hidden diventare piuttosto
+complicato, quando ci sono parecchie colonne da tenere allineate. Contare gli
+spazi per due o tre colonne @`e semplice, ma oltre questo limite comincia a
+volerci molto tempo. Ecco perch@'e @`e disponibile l'istruzione @code{printf}
+(@pxref{Printf});
+una delle address@hidden che offre @`e quella di allineare colonne di dati.
+
address@hidden continuazione di riga, in istruzione @code{print}
address@hidden istruzione @code{print}, continuazione di riga e
address@hidden @code{print}, istruzione, continuazione di riga e
address@hidden NOTA
+Si address@hidden continuare su address@hidden righe sia l'istruzione
@code{print} che l'istruzione
address@hidden semplicemente mettendo un ritorno a capo dopo una virgola
+qualsiasi
+(@pxref{Istruzioni/Righe}).
address@hidden quotation
+
address@hidden Separatori di output
address@hidden I separatori di output e come modificarli
+
address@hidden variabile @code{OFS}
+Come detto sopra, un'istruzione @code{print} contiene una lista di elementi
+separati da virgole. Nell'output, gli elementi sono solitamente separati
+da spazi singoli. Non @`e detto tuttavia che debba sempre essere
address@hidden@dotless{i}}; uno
+spazio singolo @`e semplicemnte il valore di default. Qualsiasi stringa di
+caratteri address@hidden essere usata come
address@hidden di campo in output} impostando la variabile
+predefinita @code{OFS}. Il valore iniziale di questa variabile @`e
+la stringa @address@hidden" "}} (address@hidden, uno spazio singolo).
+
+L'output di un'istruzione @code{print} completa @`e detto un @dfn{record di
+output}. Ogni istruzione @code{print} stampa un record di output, e alla fine
+ci aggiunge una stringa detta @dfn{separatore record in output} (o
address@hidden). Il valore iniziale di @code{ORS} @`e la stringa @code{"\n"}
+(address@hidden, un carattere di ritorno a capo). Quindi, ogni istruzione
address@hidden normalmente genera [almeno] una riga a s@'e stante.
+
address@hidden output, record
address@hidden separatore di record in output, si veda @code{ORS}, variabile
address@hidden @code{ORS}, variabile
address@hidden @code{BEGIN}, criterio di ricerca, variabili
@code{OFS}/@code{ORS}, assegnare valori a
+Per cambiare il tipo di separazione in output di campi e record, si impostano
+valori differenti alle variabili @code{OFS} e @code{ORS}. Il posto
address@hidden
+indicato per farlo @`e nella regola @code{BEGIN}
+(@pxref{BEGIN/END}), in modo che l'assegnazione abbia effetto prima
+dell'elaborazione di ogni record in input. Questi valori si possono
+anche impostare dalla riga di comando, prima della lista dei file in input,
+oppure usando l'opzione della riga di comando @option{-v}
+(@pxref{Opzioni}).
+L'esempio seguente stampa il primo e il secondo campo di ogni record in input,
+separati da un punto e virgola, con una riga vuota aggiunta dopo ogni
+ritorno a capo:
+
+
address@hidden
+$ @kbd{awk 'BEGIN @{ OFS = ";"; ORS = "\n\n" @}}
+> @address@hidden print $1, $2 @}' mail-list}
address@hidden Amelia;555-5553
address@hidden
address@hidden Anthony;555-3412
address@hidden
address@hidden Becky;555-7685
address@hidden
address@hidden Bill;555-1675
address@hidden
address@hidden Broderick;555-0542
address@hidden
address@hidden Camilla;555-2912
address@hidden
address@hidden Fabius;555-1234
address@hidden
address@hidden Julie;555-6699
address@hidden
address@hidden Martin;555-6480
address@hidden
address@hidden Samuel;555-3430
address@hidden
address@hidden Jean-Paul;555-2127
address@hidden
address@hidden example
+
+Se il valore di @code{ORS} non contiene un ritorno a capo, l'output del
+programma viene scritto tutto su un'unica riga.
+
address@hidden OFMT
address@hidden Controllare l'output di numeri con @code{print}
address@hidden numerico, formato di output
address@hidden formati numerici di output
+Quando si stampano valori numerici con l'istruzione @code{print},
address@hidden converte internamente ogni numero in una stringa di caratteri
+e stampa quella stringa. @command{awk} usa la funzione @code{sprintf()}
+per effettuare questa conversione
+(@pxref{Funzioni per stringhe}).
+Per ora, basta dire che la funzione @code{sprintf()}
+accetta una @dfn{specifica di formato} che indica come formattare
+i numeri (o le stringhe), e che ci sono svariati modi per formattare i
+numeri. Le differenti specifiche di formato sono trattate address@hidden
+esaurientemente
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di controllo}.
+
address@hidden
address@hidden @code{OFMT}, variabile
address@hidden output, specificatore di address@hidden @code{OFMT}
+La variabile predefinita @code{OFMT} contiene la specifica di formato
+che @code{print} usa con @code{sprintf()} per convertire un numero in
+una stringa per poterla stampare.
+Il valore di default di @code{OFMT} @`e @code{"%.6g"}.
+Il modo in cui @code{print} stampa i numeri si address@hidden cambiare
+fornendo una specifica di formato differente
+per il valore di @code{OFMT}, come mostrato nell'esempio seguente:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{OFMT = "%.0f" # Stampa numeri come interi (arrotonda)}
+> @kbd{print 17.23, 17.54 @}'}
address@hidden 17 18
address@hidden example
+
address@hidden
address@hidden angolo buio, variabile @code{OFMT}
address@hidden POSIX @command{awk}, variabile @code{OFMT} e
address@hidden variabile @code{OFMT}, POSIX @command{awk} e
+Per lo standard POSIX, il comportamento di @command{awk} @`e indefinito
+se @code{OFMT} contiene qualcosa di diverso da una specifica di conversione
+di un numero a virgola mobile.
address@hidden
+
address@hidden Printf
address@hidden Usare l'istruzione @code{printf} per stampe sofisticate
+
address@hidden istruzione @code{printf}
address@hidden @code{printf}, istruzione
address@hidden output, formattato
address@hidden formattare l'output
+Per un controllo address@hidden ampio sul formato di output di quello fornito
da
address@hidden, si address@hidden usare @code{printf}.
+Con @code{printf} si address@hidden
+specificare lo spazio da utilizzare per ogni elemento, e anche le varie
+scelte di formattazione disponibile per i numeri (come la base da usare in
+output, se stampare con notazione esponenziale, se inserire un segno, e quante
+cifre stampare dopo il separatore decimale).
+
address@hidden
+* Printf Fondamenti:: Sintassi dell'istruzione
+ @code{printf}.
+* Lettere di controllo:: Lettere di controllo del formato.
+* Modificatori di formato:: Modificatori specifiche di formato.
+* Esempi su printf:: Numerosi esempi.
address@hidden menu
+
address@hidden Printf Fondamenti
address@hidden Sintassi dell'istruzione @code{printf}
+
address@hidden istruzione @code{printf}, sintassi dell'
address@hidden @code{printf}, sintassi dell'istruzione
+Una semplice istruzione @code{printf} @`e qualcosa di simile a questo:
+
address@hidden
+printf @var{formato}, @var{elemento1}, @var{elemento2}, @dots{}
address@hidden example
+
address@hidden
+Come nel caso di @code{print}, l'intera lista degli argomenti address@hidden
+facoltativamente essere racchiusa fra
+parentesi. Anche qui, le parentesi sono obbligatorie se l'espressione di
+qualche elemento usa l'operatore
+relazionale @samp{>}, che potrebbe
+essere confuso con una ridirezione dell'output (@pxref{Ridirezione}).
+
address@hidden specificatori di formato
+La differenza tra @code{printf} e @code{print} @`e l'argomento @var{formato}.
+Questo @`e un'espressione il cui valore @`e visto come una stringa;
+specifica come scrivere in output ognuno degli altri argomenti. @`E chiamata
address@hidden di formato}.
+
+La stringa di formato @`e molto simile a quella usata dalla funzione di
+libreria ISO C @code{printf()}. Buona parte del @var{formato} @`e testo da
+stampare address@hidden@dotless{i}} come @`e scritto.
+All'interno di questo testo ci sono degli @dfn{specificatori di formato},
+uno per ogni elemento da stampare.
+Ogni specificatore di formato richiede di stampare l'elemento successivo
+nella lista degli argomenti
+in quella posizione del formato.
+
+L'istruzione @code{printf} non aggiunge in automatico un ritorno a capo
+al suo output. Scrive solo quanto specificato dalla stringa di formato.
+Quindi, se serve un ritorno a capo, questo va incluso nella stringa di formato.
+Le variabili di separazione dell'output @code{OFS} e @code{ORS} non hanno
+effetto sulle istruzioni @code{printf}.
+Per esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{ORS = "\nAHI!\n"; OFS = "+"}
+> @kbd{msg = "Non v\47allarmate!"}
+> @kbd{printf "%s\n", msg}
+> @address@hidden'}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden
+Qui, n@'e il @samp{+} n@'e l'esclamazione @samp{AHI!} compaiono nel messaggio
+in output.
+
address@hidden Lettere di controllo
address@hidden Lettere di controllo del formato
address@hidden istruzione @code{printf}, lettere di controllo del formato
address@hidden @code{printf}, istruzione, lettere di controllo del formato
address@hidden specificatori di formato, istruzione @code{printf}
+
+Uno specificatore di formato inizia col carattere @samp{%} e termina con
+una @dfn{lettera di controllo del formato}; e dice all'istruzione
address@hidden come stampare un elemento. La lettera di controllo del
+formato specifica che @emph{tipo}
+di valore stampare. Il resto dello specificatore di formato @`e costituito da
address@hidden facoltativi che controllano @emph{come} stampare il valore,
+per esempio stabilendo la larghezza del campo. Ecco una lista delle
+lettere di controllo del formato:
+
address@hidden @asis for docbook to come out right
address@hidden @asis
address@hidden @code{%c}
+Stampa un numero come un carattere; quindi, @samp{printf "%c",
+65} stampa la lettera @samp{A}. L'output per un valore costituito da una
+stringa @`e il primo carattere della stringa stessa.
+
address@hidden angolo buio, caratteri di controllo del formato
address@hidden @command{gawk}, caratteri di controllo del formato
address@hidden NOTA
+Lo standard POSIX richiede che il primo carattere di una stringa sia stampato.
+In localizzazioni con caratteri multibyte, @command{gawk} tenta di
+convertire i primi byte della stringa in un carattere multibyte valido
+e poi di stampare la codifica multibyte di quel carattere.
+Analogamente, nella stampa di un valore numerico, @command{gawk} ammette che
+il valore appartenga all'intervallo numerico di valori che possono essere
+contenuti in un carattere multibyte.
+Se la conversione alla codifica multibyte non riesce, @command{gawk}
+usa gli ultimi otto bit della cifra (quelli meno significativi) come
+carattere da stampare.
+
+Altre versioni di @command{awk} generalmente si limitano a stampare
+il primo byte di una stringa o i valori numerici che possono essere
+rappresentati in un singolo byte (0--255).
address@hidden quotation
+
+
address@hidden @code{%d}, @code{%i}
+Stampa un numero intero in base decimale.
+Le due lettere di controllo sono equivalenti.
+(La specificazione @samp{%i} @`e ammessa per address@hidden con ISO C.)
+
address@hidden @code{%e}, @code{%E}
+Stampa un numero nella notazione scientifica (con uso di esponente).
+Per esempio:
+
address@hidden
+printf "%4.3e\n", 1950
address@hidden example
+
address@hidden
+stampa @samp{1.950e+03}, con un totale di quattro cifre significative, tre
+delle quali
+seguono il punto che separa la parte intera da quella decimale
+[in Italia si usa la virgola al posto del punto]
+(L'espressione @samp{4.3} rappresenta due modificatori,
+introdotti nella prossima @value{SUBSECTION}).
address@hidden usa @samp{E} invece di @samp{e} nell'output.
+
address@hidden @code{%f}
+Stampa un numero in notazione a virgola mobile.
+Per esempio:
+
address@hidden
+printf "%4.3f", 1950
address@hidden example
+
address@hidden
+stampa @samp{1950.000}, con un totale di quattro cifre significative, tre
+delle quali vengono dopo il punto decimale.
+(L'espressione @samp{4.3} rappresenta due modificatori,
+introdotti nella prossima @value{SUBSECTION}).
+
+In sistemi che implementano il formato a virgola mobile, come specificato
+dallo standard IEEE 754, il valore infinito negativo @`e rappresentato come
address@hidden o @samp{-infinity},
+e l'infinito positivo come
address@hidden o @samp{infinity}.
+Il valore speciale ``not a number'' [non @`e un numero] viene scritto come
address@hidden o @samp{nan}
+(@pxref{Definizioni matematiche}).
+
address@hidden @code{%F}
+Come @samp{%f}, ma i valori di infinito e di ``not a number'' sono scritti
+in lettere maiuscole.
+
+Il formato @samp{%F} @`e un'estensione POSIX allo standard ISO C; non tutti
+i sistemi lo prevedono. In tali casi,
address@hidden usa il formato @samp{%f}.
+
address@hidden @code{%g}, @code{%G}
+Stampa un numero usando o la notazione scientifica o quella a virgola
+mobile, scegliendo la forma address@hidden concisa; se il risultato @`e
stampato usando la
+notazione scientifica, @samp{%G} usa @samp{E} invece di @samp{e}.
+
address@hidden @code{%o}
+Stampa un numero intero in ottale, senza segno
+(@pxref{Numeri non-decimali}).
+
address@hidden @code{%s}
+Stampa una stringa.
+
address@hidden @code{%u}
+Stampa un numero intero decimale, senza segno.
+(Questo formato @`e poco usato, perch@'e tutti i numeri in @command{awk}
+sono a virgola mobile; @`e disponibile principalmente per address@hidden col
+linguaggio C.)
+
address@hidden @code{%x}, @code{%X}
+Stampa un intero esadecimale senza segno;
address@hidden usa le lettere da @samp{A} a @samp{F}
+invece che da @samp{a} a @samp{f}
+(@pxref{Numeri non-decimali}).
+
address@hidden @code{%%}
+Stampa un solo carattere @samp{%}.
+Questa notazione non serve per stampare alcun
+argomento e ignora eventuali modificatori.
address@hidden table
+
address@hidden angolo buio, caratteri di controllo del formato
address@hidden @command{gawk}, caratteri di controllo del formato
address@hidden NOTA
+Quando si usano lettere di controllo del formato per numeri interi
+per stampare valori esterni all'intervallo massimo disponibile nel
+linguaggio C per i numeri interi,
address@hidden usa lo
+specificatore di formato @samp{%g}. Se si specifica l'opzione @option{--lint}
+sulla riga di comando (@pxref{Opzioni}), @command{gawk}
+emette un messaggio di avvertimento. Altre versioni di @command{awk} possono
+stampare valori non validi, o comportarsi in modo completamente differente.
address@hidden
address@hidden quotation
+
address@hidden Modificatori di formato
address@hidden Modificatori per specifiche di formato @code{printf}
+
address@hidden istruzione @code{printf}, modificatori
address@hidden @code{printf}, istruzione, modificatori
address@hidden address@hidden in specificatori di formato
+Una specifica di formato address@hidden anche includere dei @dfn{modificatori}
che
+possono controllare che parte stampare del valore dell'elemento, e anche
+quanto spazio utilizzare per stamparlo.
+I modificatori sono posizionati tra il @samp{%} e la lettera che controlla
+il formato.
+Negli esempi seguenti address@hidden usato il simbolo del punto elenco
address@hidden'' per
+rappresentare
+spazi nell'output. Questi sono i modificatori previsti, nell'ordine in
+cui possono apparire:
+
address@hidden @asis
address@hidden differenze tra @command{awk} e @command{gawk}, tra istruzioni
@code{print} e @code{printf}
address@hidden istruzione @code{printf}, specificatori posizionali
address@hidden @code{printf}, istruzione, specificatori posizionali
address@hidden the code{} does NOT start a secondary
address@hidden specificatori posizionali, istruzione @code{printf}
address@hidden @address@hidden
+Una costante intera seguita da un @samp{$} @`e uno @dfn{specificatore
posizionale}.
+Normalmente, le specifiche di formato sono applicate agli argomenti
+nell'ordine in cui appaiono nella stringa di formato. Con uno specificatore
+posizionale, la specifica di formato @`e applicata a un argomento
+indicato per numero, invece che a quello che
+sarebbe il prossimo argomento nella lista. Gli specificatori posizionali
+iniziano a contare partendo da uno. Quindi:
+
address@hidden
+printf "%s %s\n", "Non", "v'allarmate"
+printf "%2$s %1$s\n", "v'allarmate", "Non"
address@hidden example
+
address@hidden
+stampa per due volte il famoso consiglio amichevole.
+
+A prima vista, questa address@hidden non sembra di grande address@hidden
+Si tratta in effetti di un'estensione @command{gawk}, pensata per essere
+usata nella traduzione di messaggi emessi in fase di esecuzione.
address@hidden di printf},
+che descrive come e perch@'e usare specificatori posizionali.
+Per ora li possiamo ignorare.
+
address@hidden - @code{-} (Segno meno)
+Il segno meno, usato prima del modificatore di larghezza (si veda
address@hidden avanti
+in questa lista),
+richiede di allineare a sinistra
+l'argomento mantenendo la larghezza specificata. Normalmente, l'argomento
address@hidden stampato allineato a destra, con la larghezza specificata.
Quindi:
+
address@hidden
+printf "%-6s", "pippo"
address@hidden example
+
address@hidden
+stampa @address@hidden
+
address@hidden @var{spazio}
+Applicabile a conversioni numeriche, richiede di inserire uno spazio prima
+dei valori positivi e un segno meno prima di quelli negativi.
+
address@hidden @code{+}
+Il segno address@hidden, usato prima del modificatore di larghezza (si veda
address@hidden avanti
+in questa lista),
+richiede di mettere sempre un segno nelle conversioni numeriche, anche se
+il dato da formattare ha valore positivo. Il @samp{+} prevale sul
+modificatore @dfn{spazio}.
+
address@hidden @code{#}
+Richiede di usare una ``forma alternativa'' per alcune lettere di controllo.
+Per @samp{%o}, preporre uno zero.
+Per @samp{%x} e @samp{%X}, preporre @samp{0x} o @samp{0X} se il
+numero @`e diverso da zero.
+Per @samp{%e}, @samp{%E}, @samp{%f}, e @samp{%F}, il risultato deve contenere
+sempre un separatore decimale.
+Per @code{%g} e @code{%G}, gli zeri finali non significativi non sono
+tolti dal numero stampato.
+
address@hidden @code{0}
+Uno @samp{0} (zero) iniziale serve a richiedere che l'output sia
+riempito con zeri (invece che con spazi), prima delle cifre significative.
+Questo si applica solo ai formati di output di tipo numerico.
+Questo @dfn{flag} ha un effetto solo se la larghezza del campo @`e maggiore
+di quella del valore da stampare.
+
address@hidden @code{'}
+Un carattere di apice singolo o un apostrofo @`e un'estensione POSIX allo
+standard ISO C.
+Indica che la parte intera di un valore a virgola mobile, o la parte intera
+di un valore decimale intero, ha un carattere di separazione delle migliaia.
address@hidden @`e applicabile solo alle localizzazioni che prevedono un tale
carattere.
+Per esempio:
+
address@hidden
+$ @kbd{cat migliaia.awk} @ii{Visualizza il programma sorgente}
address@hidden BEGIN @{ printf "%'d\n", 1234567 @}
+$ @kbd{LC_ALL=C gawk -f migliaia.awk}
address@hidden 1234567 @ii{Risultato nella localizzazione} "C"
+$ @kbd{LC_ALL=en_US.UTF-8 gawk -f migliaia.awk}
address@hidden 1,234,567 @ii{Risultato nella localizzazione UTF inglese
americana}
address@hidden example
+
address@hidden
+Per maggiori informazioni relative a localizzazioni e internazionalizzazioni,
+si veda @ref{Localizzazioni}.
+
address@hidden NOTA
+Il @dfn{flag} @samp{'} @`e una address@hidden interessante, ma utilizza un
+carattere che @`e fonte di complicazioni, perch@'e risulta difficila da usare
nei
+programmi scritti direttamente sulla riga di comando. Per informazioni sui
+metodi appropriati per gestire la cosa, si veda @ref{Protezione}.
address@hidden quotation
+
address@hidden @var{larghezza}
+Questo @`e un numero che specifica la larghezza minima che deve occupare un
+campo. L'inserimento di un numero tra il segno @samp{%} e il carattere
+di controllo del formato fa address@hidden@dotless{i}} che il campo si espanda
a quella larghezza.
+Il modo di default per fare questo @`e di aggiungere degli spazi a
+sinistra. Per esempio:
+
address@hidden
+printf "%6s", "pippo"
address@hidden example
+
address@hidden
+stampa @address@hidden
+
+il valore di @var{larghezza} indica la larghezza minima, non la massima. Se
+il valore dell'elemento richiede address@hidden caratteri della @var{larghezza}
+specificata, questa address@hidden essere aumentata secondo address@hidden
+Quindi, per esempio:
+
address@hidden
+printf "%6s", "pippo-pluto"
address@hidden example
+
address@hidden
+stampa @samp{pippo-pluto}.
+
+Anteponendo un segno meno alla @var{larghezza} si richiede che l'output sia
+esteso con spazi a destra, invece che a sinistra.
+
address@hidden @address@hidden
+Un punto, seguito da una costante intera
+specifica la precisione da usare nella stampa.
+Il tipo di precisione varia a seconda della lettera di controllo:
+
address@hidden @asis
address@hidden @code{%d}, @code{%i}, @code{%o}, @code{%u}, @code{%x}, @code{%X}
+Minimo numero di cifre da stampare.
+
address@hidden @code{%e}, @code{%E}, @code{%f}, @code{%F}
+Numero di cifre alla destra del separatore decimale.
+
address@hidden @code{%g}, @code{%G}
+Massimo numero di cifre significative.
+
address@hidden @code{%s}
+Massimo numero di caratteri della stringa che possono essere stampati.
address@hidden table
+
+Quindi, l'istruzione:
+
address@hidden
+printf "%.4s", "foobar"
address@hidden example
+
address@hidden
+stampa @samp{foob}.
address@hidden table
+
+Le address@hidden di @var{larghezza} e @var{precisione} dinamiche
(address@hidden,
address@hidden"%*.*s"}) disponibili nell'istruzione @code{printf} della
libreria C sono
+utilizzabili.
+Invece che fornire esplicitamente una @var{larghezza} e/o una @var{precisione}
+nella stringa di formato, queste sono fornite come parte della lista degli
+argomenti. Per esempio:
+
address@hidden
+w = 5
+p = 3
+s = "abcdefg"
+printf "%*.*s\n", w, p, s
address@hidden example
+
address@hidden
+equivale esattamente a:
+
address@hidden
+s = "abcdefg"
+printf "%5.3s\n", s
address@hidden example
+
address@hidden
+Entrambi i programmi stampano @address@hidden@address@hidden
+Versioni address@hidden datate di @command{awk} non consentivano questa
address@hidden
+Dovendo usare una di queste versioni, @`e possibile simulare questa
address@hidden usando la concatenazione per costruire una stringa di formato,
+come per esempio:
+
address@hidden
+w = 5
+p = 3
+s = "abcdefg"
+printf "%" w "." p "s\n", s
address@hidden example
+
address@hidden
+Questo codice non @`e di facile lettura, ma funziona.
+
address@hidden @cindex controlli @command @{lint}
address@hidden debug, errori fatali, @code{printf}, stringhe di formato
address@hidden POSIX @command{awk}, stringhe di formato @code{printf} e
+Chi programma in C probabilmente @`e abituato a specificare modificatori
+addizionali (@samp{h}, @samp{j}, @samp{l}, @samp{L}, @samp{t} e @samp{z}) nelle
+stringhe di formato di @code{printf}. Questi modificatori non sono validi
+in @command{awk}. La maggior parte della implementazioni di @command{awk} li
+ignora senza emettere messaggi. Se si specifica l'opzione @option{--lint}
+sulla riga di comando (@pxref{Opzioni}), @command{gawk} emette un messaggio
+di avvertimento quando li si usa. Se si specifica l'opzione @option{--posix},
+il loro uso genera un errore fatale.
+
address@hidden Esempi su printf
address@hidden Esempi d'uso di @code{printf}
+
+Il seguente semplice esempio mostra
+come usare @code{printf} per preparare una tabella allineata:
+
address@hidden
+awk '@{ printf "%-10s %s\n", $1, $2 @}' mail-list
address@hidden example
+
address@hidden
+Questo comando
+stampa i nomi delle persone (@code{$1}) nel file
address@hidden come una stringa di 10 caratteri allineati a sinistra.
+Stampa anche i numeri telefonici (@code{$2}) a fianco, sulla stessa riga.
+Il risultato @`e una tabella allineata, contenente due colonne, di nomi e
numeri
+telefonici, come si address@hidden vedere qui:
+
address@hidden
+$ @kbd{awk '@{ printf "%-10s %s\n", $1, $2 @}' mail-list}
address@hidden Amelia 555-5553
address@hidden Anthony 555-3412
address@hidden Becky 555-7685
address@hidden Bill 555-1675
address@hidden Broderick 555-0542
address@hidden Camilla 555-2912
address@hidden Fabius 555-1234
address@hidden Julie 555-6699
address@hidden Martin 555-6480
address@hidden Samuel 555-3430
address@hidden Jean-Paul 555-2127
address@hidden example
+
+In questo caso, i numeri telefonici debbono essere stampati come stringhe,
+poich@'e includono un trattino. Una stampa dei numeri telefonici come numeri
+semplici avrebbe visualizzato solo le prime tre cifre: @samp{555},
+e questo non sarebbe stato di grande address@hidden
+
+Non era necessario specificare una larghezza per i numeri telefonici poich@'e
+sono nell'ultima colonnna di ogni riga. Non c'@`e bisogno di avere un
+allineamento di spazi dopo di loro.
+
+La tabella avrebbe potuto essere resa address@hidden leggibile aggiungendo
+intestazioni in cima
+alle colonne. Questo si address@hidden fare usando una regola @code{BEGIN}
+(@pxref{BEGIN/END})
+in modo che le intestazioni siano stampate una sola volta, all'inizio del
+programma @command{awk}:
+
address@hidden
+awk 'BEGIN @{ print "Nome Numero"
+ print "---- ------" @}
+ @{ printf "%-10s %s\n", $1, $2 @}' mail-list
address@hidden example
+
+L'esempio precedente usa sia l'istruzione @code{print} che l'istruzione
address@hidden nello stesso programma. Si possono ottenere gli stessi
+risultati usando solo istruzioni @code{printf}:
+
address@hidden
+awk 'BEGIN @{ printf "%-10s %s\n", "Nome", "Numero"
+ printf "%-10s %s\n", "----", "------" @}
+ @{ printf "%-10s %s\n", $1, $2 @}' mail-list
address@hidden example
+
address@hidden
+Stampare ogni intestazione di colonna con la stessa specifica di formato
+usata per gli elementi delle colonne ci address@hidden la certezza che le
intestazioni
+sono allineate esattamente come le colonne.
+
+Il fatto che usiamo per tre volte la stessa specifica di formato si
address@hidden
+evidenziare memorizzandola in una variabile, address@hidden@dotless{i}}:
+
address@hidden
+awk 'BEGIN @{ format = "%-10s %s\n"
+ printf format, "Nome", "Numero"
+ printf format, "----", "------" @}
+ @{ printf format, $1, $2 @}' mail-list
address@hidden example
+
+
address@hidden Ridirezione
address@hidden Ridirigere l'output di @code{print} e @code{printf}
+
address@hidden output, ridirezione
address@hidden ridirezione dell'output
address@hidden @option{--sandbox}, opzione, ridirezione dell'output con
@code{print}, @code{printf}
+Finora, l'output di @code{print} e @code{printf} @`e stato diretto
+verso lo standard output,
+che di solito @`e lo schermo. Sia @code{print} che @code{printf} possono
+anche inviare il loro output in altre direzioni.
address@hidden quel che si chiama @dfn{ridirezione}.
+
address@hidden NOTA
+Quando si specifica @option{--sandbox} (@pxref{Opzioni}),
+la ridirezione dell'output verso file, @dfn{pipe} e coprocessi non @`e
+consentita.
address@hidden quotation
+
+Una ridirezione @`e posta dopo l'istruzione @code{print} o @code{printf}.
+Le ridirezioni in @command{awk} sono scritte come le ridirezioni nei
+comandi della shell, l'unica differenza @`e che si trovano all'interno di
+un programma @command{awk}.
+
address@hidden the commas here are part of the see also
address@hidden istruzione @code{print}, si veda anche ridirezione dell'output
address@hidden istruzione @code{printf}, si veda anche ridirezione dell'output
+Ci sono quattro forme di ridirezione dell'output:
+output scritto su un file,
+output aggiunto in fondo a un file,
+output che fa da input a un altro comando (usando una @dfn{pipe}) e
+output diretto a un coprocesso.
+Vengono descritti per l'istruzione @code{print},
+ma funzionano allo stesso modo per @code{printf}:
+
address@hidden @code
address@hidden @code{>} (parentesi acuta destra), operatore @code{>} (I/O)
address@hidden parentesi acuta destra (@code{>}), operatore @code{>} (I/O)
address@hidden operatori, input/output
address@hidden print @var{elementi} > @var{output-file}
+Questa ridirezione stampa gli elementi nel file di output chiamato
address@hidden Il @value{FN} @var{output-file} address@hidden essere
+una qualsiasi espressione. Il suo valore @`e trasformato in una stringa e
+quindi usato come
address@hidden
address@hidden (@pxrefil{Espressioni}).
address@hidden iftex
address@hidden
address@hidden (@pxref{Espressioni}).
address@hidden ifnottex
+Quando si usa questo tipo di ridirezione, il file @var{output-file} viene
+cancellato prima che su di esso sia stato scritto il primo record in uscita.
+Le successive scritture verso lo stesso file @var{output-file} non cancellano
address@hidden, ma continuano ad aggiungervi record.
+(Questo comportamento @`e differente da quello delle ridirezioni usate negli
+script della shell.)
+Se @var{output-file} non esiste, viene creato. Per esempio, ecco
+come un programma @command{awk} address@hidden scrivere una lista di nomi di
persone
+su un file di nome @file{lista-nomi}, e una lista di numeri telefonici
+su un altro file di nome @file{lista-telefoni}:
+
address@hidden
+$ @kbd{awk '@{ print $2 > "lista-telefoni"}
+> @kbd{print $1 > "lista-nomi" @}' mail-list}
+$ @kbd{cat lista-telefoni}
address@hidden 555-5553
address@hidden 555-3412
address@hidden
+$ @kbd{cat lista-nomi}
address@hidden Amelia
address@hidden Anthony
address@hidden
address@hidden example
+
address@hidden
+Ogni file in output contiene un nome o un numero su ogni riga.
+
address@hidden @code{>} (parentesi acuta destra), operatore @code{>>} (I/O)
address@hidden parentesi acuta destra (@code{>}), operatore @code{>>} (I/O)
address@hidden print @var{elementi} >> @var{output-file}
+Questa ridirezione stampa gli elementi in un file di output preesistente,
+di nome @var{output-file}. La differenza tra questa ridirezione e quella
+con un solo @samp{>} @`e che il precedente contenuto (se esiste) di
address@hidden non viene cancellato. Invece, l'output di @command{awk} @`e
+aggiunto in fondo al file.
+Se @var{output-file} non esiste, viene creato.
+
address@hidden @code{|} (barra verticale), operatore @code{|} (I/O)
address@hidden @dfn{pipe}, output
address@hidden output, a @dfn{pipe}
address@hidden print @var{elementi} | @var{comando}
address@hidden possibile inviare output a un altro programma usando una
@dfn{pipe}
+invece di inviarlo a un file. Questa ridirezione apre una @dfn{pipe} verso
address@hidden, e invia i valori di @var{elementi}, tramite questa
address@hidden, a un altro processo creato per eseguire @var{comando}.
+
+L'argomento @var{comando}, verso cui @`e rivolta la ridirezione, @`e in
address@hidden
+un'espressione
address@hidden Il suo valore @`e convertito in una stringa il cui contenuto
+costituisce un comando della shell che deve essere eseguito. Per esempio,
+il seguente programma produce due file, una lista non ordinata di nomi di
+persone e una lista ordinata in ordine alfabetico inverso:
+
address@hidden
+10/2000:
+This isn't the best style, since COMMAND is assigned for each
+record. It's done to avoid overfull hboxes in TeX. Leave it
+alone for now and let's hope no-one notices.
address@hidden ignore
+
address@hidden
+awk '@{ print $1 > "nomi.non.ordinati"
+ comando = "sort -r > nomi.ordinati"
+ print $1 | comando @}' mail-list
address@hidden example
+
+La lista non ordinata @`e scritta usando una ridirezione normale, mentre
+la lista ordinata @`e scritta inviando una @dfn{pipe} in input al programma
+di address@hidden @command{sort}.
+
+Il prossimo esempio usa la ridirezione per inviare un messaggio alla
+mailing list @code{bug-sistema}. Questo address@hidden tornare utile se si
hanno
+problemi con uno script @command{awk} eseguito periodicamente per la
+manutenzione del sistema:
+
address@hidden
+report = "mail bug-sistema"
+print("Script awk in errore:", $0) | report
+print("al record numero", FNR, "di", NOME_FILE) | report
+close(report)
address@hidden example
+
+La funzione @code{close()} @`e stata chiamata perch@'e @`e una buona idea
chiudere
+la @dfn{pipe} non appena tutto l'output da inviare alla @dfn{pipe} @`e stato
+inviato. @xref{Chiusura file e @dfn{pipe}}
+per maggiori informazioni.
+
+Questo esempio illustra anche l'uso di una variabile per rappresentare
+un @var{file} o un @var{comando}; non @`e necessario usare sempre
+una costante stringa. Usare una variabile @`e di solito una buona idea,
+perch@'e (se si vuole riusare lo stesso file o comando)
address@hidden richiede che il valore della stringa sia sempre scritto
+esattamente nello stesso modo.
+
address@hidden coprocessi
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden operatori, input/output
address@hidden differenze tra @command{awk} e @command{gawk}, operatori di
input/output
address@hidden print @var{elementi} |& @var{comando}
+Questa ridirezione stampa gli elementi nell'input di @var{comando}.
+La differenza tra questa ridirezione e quella
+con la sola @samp{|} @`e che l'output da @var{comando}
address@hidden essere letto tramite @code{getline}.
+Quindi, @var{comando} @`e un @dfn{coprocesso}, che lavora in parallelo al
+programma @command{awk}, ma @`e al suo servizio.
+
+Questa address@hidden @`e un'estensione @command{gawk}, e non @`e disponibile
in
+POSIX @command{awk}.
address@hidden
address@hidden coprocesso},
+per una breve spiegazione.
address@hidden/O bidirezionale}
+per un'esposizione address@hidden esauriente.
address@hidden ifnotdocbook
address@hidden
address@hidden coprocesso}
+per una breve spiegazione.
address@hidden/O bidirezionale}
+per un'esposizione address@hidden esauriente.
address@hidden ifdocbook
address@hidden table
+
+Ridirigere l'output usando @samp{>}, @samp{>>}, @samp{|} o @samp{|&}
+richiede al sistema di aprire un file, una @dfn{pipe} o un coprocesso solo se
+il particolare @var{file} o @var{comando} che si @`e specificato non @`e
address@hidden
+stato utilizzato in scrittura dal programma o se @`e stato chiuso
+dopo l'ultima scrittura.
+
address@hidden debug, stampare
address@hidden un errore comune usare la ridirezione @samp{>} per la prima
istruzione
address@hidden verso un file, e in seguito usare @samp{>>} per le successive
+scritture in output:
+
address@hidden
+# inizializza il file
+print "Non v'allarmate" > "guida.txt"
address@hidden
+# aggiungi in fondo al file
+print "Evitate generatori di address@hidden" >> "guide.txt"
address@hidden example
+
address@hidden
+Questo @`e il modo in cui le ridirezioni devono essere usate lavorando
+con la shell. Ma in @command{awk} address@hidden non @`e necessario. In casi
di questo
+genere, un programma dovrebbe
+usare @samp{>} per tutte le istruzioni @code{print}, perch@'e il file di
+output @`e aperto una sola volta.
+(Usando sia @samp{>} che @samp{>>} nello stesso programma, l'output @`e
prodotto
+nell'ordine atteso.
+Tuttavia il mischiare gli operatori per lo stesso file @`e sintomo di uno
+stile di programmazione inelegante, e address@hidden causare confusione in chi
legge
+il programma.)
+
address@hidden differenze tra @command{awk} e @command{gawk}, limitazioni di
implementazione
address@hidden problemi di implementazione, @command{gawk}, limitazioni
address@hidden @command{awk}, problemi di implementazione, @dfn{pipe}
address@hidden @command{gawk}, problemi di implementazione, @dfn{pipe}
address@hidden
+Come visto in precedenza
+(@pxref{Note su getline}),
+molte
address@hidden ifnotinfo
address@hidden
address@hidden
address@hidden
+Molte
address@hidden ifnothtml
address@hidden ifnotdocbook
address@hidden ifnottex
+tra le address@hidden vecchie implementazioni di
address@hidden limitano il numero di @dfn{pipeline} che un programma
address@hidden address@hidden mantenere aperte a una soltanto! In
@command{gawk}, non c'@`e
+un tale limite. @command{gawk} consente a un programma di
+aprire tante @dfn{pipeline} quante ne consente il sistema operativo su cui
+viene eseguito.
+
address@hidden sidebar, Inviare @dfn{pipe} alla @command{sh}
address@hidden
address@hidden
+<sidebar><title>Inviare @dfn{pipe} alla @command{sh}</title>
address@hidden docbook
+
address@hidden shell, inviare comandi tramite @dfn{pipe} alla
+
+Una maniera particolarmente efficace di usare la ridirezione @`e quella di
+preparare righe di comando da passare
+come @dfn{pipe} alla shell,
address@hidden Per esempio, si supponga di avere una lista di file provenienti
+da un sistema in cui tutti i
address@hidden sono memorizzari in maiuscolo, e di volerli rinominare
+in modo da avere nomi tutti in
+minuscolo. Il seguente programma @`e
+sia semplice che efficiente:
+
address@hidden @cindex @command{mv} utility
address@hidden
address@hidden printf("mv %s %s\n", $0, tolower($0)) | "sh" @}
+
+END @{ close("sh") @}
address@hidden example
+
+La funzione @code{tolower()} restituisce la stringa che gli viene passata
+come argomento con tutti i caratteri maiuscoli convertiti in minuscolo
+(@pxref{Funzioni per stringhe}).
+Il programma costruisce una lista di righe di comando,
+usando il programma di address@hidden @command{mv} per rinominare i file.
+Poi invia la lista alla shell per l'elaborazione.
+
address@hidden alla shell} per una funzione che address@hidden essere utile nel
generare
+righe di comando da passare alla shell.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Inviare @dfn{pipe} alla @command{sh}}
+
+
address@hidden shell, inviare comandi tramite @dfn{pipe} alla
+
+Una maniera particolarmente efficace di usare la ridirezione @`e quella di
+preparare righe di comando da passare
+come @dfn{pipe} alla shell,
address@hidden Per esempio, si supponga di avere una lista di file provenienti
+da un sistema in cui tutti i
address@hidden sono memorizzari in maiuscolo, e di volerli rinominare
+in modo da avere nomi tutti in
+minuscolo. Il seguente programma @`e
+sia semplice che efficiente:
+
address@hidden @cindex @command{mv} utility
address@hidden
address@hidden printf("mv %s %s\n", $0, tolower($0)) | "sh" @}
+
+END @{ close("sh") @}
address@hidden example
+
+La funzione @code{tolower()} restituisce la stringa che gli viene passata
+come argomento con tutti i caratteri maiuscoli convertiti in minuscolo
+(@pxref{Funzioni per stringhe}).
+Il programma costruisce una lista di righe di comando,
+usando il programma di address@hidden @command{mv} per rinominare i file.
+Poi invia la lista alla shell per l'elaborazione.
+
address@hidden alla shell} per una funzione che address@hidden essere utile nel
generare
+righe di comando da passare alla shell.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden FD speciali
address@hidden File speciali per flussi standard di dati pre-aperti
address@hidden standard input
address@hidden input, standard
address@hidden standard output
address@hidden output, standard
address@hidden errore, output
address@hidden standard error
address@hidden descrittori di file
address@hidden file, descrittori, si veda descrittori di file
+
+I programmi in esecuzione hanno convenzionalmente tre flussi di input e
+output a disposizione, address@hidden aperti per la lettura e la scrittura.
+Questi sono noti come
+lo @dfn{standard input}, lo @dfn{standard output} e lo @dfn{standard
+error output}. A questi flussi aperti (e a tutti gli altri file aperti o
address@hidden) si fa spesso riferimento usando il termine tecnico
address@hidden di file} [FD].
+
+Questi flussi sono, per default, associati alla tastiera e allo schermo,
+ma spesso sono ridiretti, nella shell, utilizzando gli operatori
address@hidden<}, @samp{<<}, @samp{>}, @samp{>>}, @samp{>&} e @samp{|}.
+Lo standard error @`e tipicamente usato per scrivere messaggi di errore;
+la ragione per cui ci sono due flussi distinti,
+standard output e standard error, @`e per poterli ridirigere indipendentemente
+l'uno dall'altro.
+
address@hidden differenze tra @command{awk} e @command{gawk}, messaggi di errore
address@hidden gestione errori
address@hidden errori, gestione degli
+Nelle tradizionali implementazioni di @command{awk}, il solo modo per
+scrivere un messaggio di errore allo
+standard error in un programma @command{awk} @`e il seguente:
+
address@hidden
+print "Ho trovato un errore grave!" | "cat 1>&2"
address@hidden example
+
address@hidden
+Con quest'istruzione si apre una @dfn{pipeline} verso un comando della shell
+che @`e in grado di accedere al flusso di standard error che eredita dal
+processo @command{awk}.
address@hidden 8/2014: Mike Brennan says not to cite this as inefficient. So,
fixed.
+Questo @`e molto poco elegante, e richiede anche di innescare un processo
+separato. Per questo chi scrive programmi @command{awk} spesso
+non usa questo metodo. Invece, invia i messaggi di errore allo
+schermo, in questo modo:
+
address@hidden
+print "Ho trovato un errore grave!" > "/dev/tty"
address@hidden example
+
address@hidden
+(@file{/dev/tty} @`e un file speciale fornito dal sistema operativo
+ed @`e connesso alla tastiera e allo schermo. Rappresenta il
+``terminale'',@footnote{``tty'' in @file{/dev/tty} @`e un'abbreviazione di
+``TeleTYpe'' [telescrivente], un terminale seriale.} che nei sistemi odierni
address@hidden una tastiera e uno schermo, e non una @dfn{console} seriale).
+Questo ha generalmente lo stesso effetto, ma non @`e sempre detto: sebbene il
+flusso di standard error sia solitamente diretto allo schermo, potrebbe
+essere stato
+ridiretto; se questo @`e il caso, scrivere verso lo schermo non serve. In
+effetti, se @command{awk} @`e chiamato da un lavoro che non @`e eseguito
+interattivamente,
address@hidden non avere a disposizione alcun terminale su cui scrivere.
+In quel caso, l'apertura di @file{/dev/tty} genera un errore.
+
address@hidden, BWK @command{awk}, e @command{mawk} mettono a disposizione
+speciali @value{FNS} per accedere ai tre flussi standard.
+Se il @value{FN} coincide con uno di questi nomi speciali, quando
address@hidden (o uno degli altri) ridirige l'input o l'output, usa
+direttamente il descrittore di file identificato dal @value{FN}. Questi
address@hidden sono gestiti address@hidden@dotless{i}} in tutti i sistemi
operativi nei quali
address@hidden @`e disponibile, e non solo in quelli che aderiscono allo
+standard POSIX:
+
address@hidden estensioni comuni, file speciale @code{/dev/stdin}
address@hidden estensioni comuni, file speciale @code{/dev/stdout}
address@hidden estensioni comuni, file speciale @code{/dev/stderr}
address@hidden @cindex comuni, address@hidden file speciale @code{/dev/stdin}
address@hidden @cindex comuni, address@hidden file speciale @code{/dev/stdout}
address@hidden @cindex comuni, address@hidden file speciale @code{/dev/stderr}
address@hidden nomi di file, flussi standard in @command{gawk}
address@hidden @code{/dev/@dots{}}, file speciali
address@hidden file, file speciali @code{/dev/@dots{}}
address@hidden @code{/dev/fd/@var{N}}, file speciali (in @command{gawk})
address@hidden @file
address@hidden /dev/stdin
+Lo standard input (descrittore di file 0).
+
address@hidden /dev/stdout
+Lo standard output (descrittore di file 1).
+
address@hidden /dev/stderr
+Lo standard error output (descrittore di file 2).
address@hidden table
+
+Usando questa address@hidden
+la maniera corretta di scrivere un messaggio di errore diviene quindi:
+
address@hidden
+print "Ho trovato un errore grave!" > "/dev/stderr"
address@hidden example
+
address@hidden debug, doppio apice con nomi di file
+Si noti l'uso di doppi apici per racchiudere il @value{FN}.
+Come per ogni altra ridirezione, il valore dev'essere una stringa.
address@hidden un errore comune omettere i doppi apici, il che conduce a
+risultati inattesi.
+
address@hidden non tratta questi @value{FNS} come speciali quando opera
+in address@hidden di address@hidden POSIX. Comunque, poich@'e BWK
@command{awk}
+li prevede, @command{gawk} li ammette anche quando viene
+invocato con l'opzione @option{--traditional} (@pxref{Opzioni}).
+
address@hidden File speciali
address@hidden @value{FFNS} speciali in @command{gawk}
address@hidden @command{gawk}, nomi di file in
+
+Oltre all'accesso a standard input, standard output e standard error,
address@hidden consente di accedere a ogni descrittore di file aperto.
+In address@hidden, ci sono dei @value{FNS} speciali riservati per accedere a
+reti TCP/IP.
+
address@hidden
+* Altri file ereditati:: Accedere ad altri file aperti con
+ @command{gawk}.
+* Reti speciali:: File speciali per comunicazioni con la rete.
+* Avvertimenti speciali:: Cose a cui prestare attenzione.
address@hidden menu
+
address@hidden Altri file ereditati
address@hidden Accedere ad altri file aperti con @command{gawk}
+
+Oltre ai valori speciali di @value{FNS}
address@hidden/dev/stdin}, @code{/dev/stdout} e @code{/dev/stderr}
address@hidden menzionati, @command{gawk} prevede una sintassi
+per accedere a ogni altro file aperto ereditato:
+
address@hidden @file
address@hidden /dev/fd/@var{N}
+Il file associato al descrittore di file @var{N}. Il file indicato deve
+essere aperto dal programma che inizia l'esecuzione di @command{awk}
+(tipicamente la shell). Se non sono state poste in essere iniziative
+speciali nella shell da cui @command{gawk} @`e stato invocato, solo i
+descrittori 0, 1, e 2 sono disponibili.
address@hidden table
+
+I @value{FNS} @file{/dev/stdin}, @file{/dev/stdout} e @file{/dev/stderr}
+sono essenzialmente alias per @file{/dev/fd/0}, @file{/dev/fd/1} e
address@hidden/dev/fd/2}, rispettivamente. Comunque, i primi nomi sono
address@hidden
+autoesplicativi.
+
+Si noti che l'uso di @code{close()} su un @value{FN} della forma
address@hidden"/dev/fd/@var{N}"}, per numeri di descrittore di file
+oltre il due, effettivamente chiude il descrittore di file specificato.
+
address@hidden Reti speciali
address@hidden File speciali per comunicazioni con la rete
address@hidden reti, address@hidden per
address@hidden TCP/IP, address@hidden per
+
+I programmi @command{gawk}
+possono aprire una connessione bidirezionale
+TCP/IP, fungendo o da @dfn{client} o da @dfn{server}.
+Questo avviene usando uno speciale @value{FN} della forma:
+
address@hidden
address@hidden/@var{tipo-rete}/@var{protocollo}/@var{porta-locale}/@var{host-remoto}/@var{porta-remota}}
address@hidden example
+
+il @var{tipo-rete} address@hidden essere @samp{inet}, @samp{inet4} o
@samp{inet6}.
+Il @var{protocollo} address@hidden essere @samp{tcp} o @samp{udp},
+e gli altri campi rappresentano gli altri dati essenziali
+necessari per realizzare una connessione di rete.
+Questi @value{FNS} sono usati con l'operatore @samp{|&} per comunicare
+con un coprocesso
+(@pxref{I/O bidirezionale}).
+Questa @`e una address@hidden avanzata, qui riferita solo per completezza.
+Una spiegazione esauriente address@hidden fornita nella
address@hidden TCP/IP}.
+
address@hidden Avvertimenti speciali
address@hidden Avvertimenti speciali sui @value{FNS}
+
+Sono qui elencate alcune cose da tener presente usando i
address@hidden speciali forniti da @command{gawk}:
+
address@hidden @value{BULLET}
address@hidden address@hidden compatibile di (@command{gawk}), nomi di file
address@hidden nomi di file, nella address@hidden compatibile di @command{gawk}
address@hidden
+Il riconoscimento dei @value{FNS} per i tre file standard pre-aperti
address@hidden disabilitato solo in address@hidden POSIX.
+
address@hidden
+Il riconoscimento degli altri @value{FNS} speciali @`e disabilitato se
address@hidden @`e in address@hidden compatibile
+(o @option{--traditional} o @option{--posix};
address@hidden).
+
address@hidden
address@hidden interpreta @emph{sempre}
+questi @value{FNS} speciali.
+Per esempio, se si usa @samp{/dev/fd/4}
+per l'output, si scrive realmente sul descrittore di file 4, e non su un nuovo
+descrittore di file generato duplicando (con @code{dup()}) il descrittore
+file 4. Solitamente questo non ha importanza; comunque, @`e importante
address@hidden chiudere alcun file correlato ai descrittori di file 0, 1 e 2.
+Se lo si fa, il comportamente risultante @`e imprevedibile.
address@hidden itemize
+
address@hidden Chiusura file e @dfn{pipe}
address@hidden Chiudere ridirezioni in input e in output
address@hidden output, file in, si veda file in output
address@hidden input, file in, chiusura
address@hidden output, file in, chiusura
address@hidden @dfn{pipe}, chiusura
address@hidden coprocessi, chiusura
address@hidden @code{getline}, comando, address@hidden usare dal
+
+Se lo stesso @value{FN} o lo stesso comando di shell @`e usato con
@code{getline}
address@hidden di una volta durante l'esecuzione di un programma @command{awk}
+(@pxref{Getline}),
+il file viene aperto (o il comando viene eseguito) solo la prima volta.
+A quel punto, il primo record in input @`e letto da quel file o comando.
+La prossima volta che lo stesso file o comando @`e usato con @code{getline},
+un altro record @`e letto da esso, e address@hidden@dotless{i}} via.
+
+Analogamente, quando un file o una @dfn{pipe} sono aperti in output,
address@hidden ricorda
+il @value{FN} o comando a essi associato, e le successive
+scritture verso lo stesso file o comando sono accodate alle precedenti
+scritture.
+Il file o la @dfn{pipe} rimangono aperti fino al termine dell'esecuzione
+di @command{awk}.
+
address@hidden
+Questo implica che sono necessari dei passi speciali per rileggere nuovamente
+lo stesso file dall'inizio, o per eseguire di nuovo un comando di shell
+(invece che leggere ulteriore output dal precedente comando). La funzione
address@hidden()} rende possibile fare queste cose:
+
address@hidden
+close(@var{NOME_FILE})
address@hidden example
+
address@hidden
+o:
+
address@hidden
+close(@var{comando})
address@hidden example
+
+l'argomento @var{NOME_FILE} o @var{comando} address@hidden essere qualsiasi
espressione,
+il cui valore dev'essere @emph{esattamente} uguale alla stringa
+usata per aprire il file o eseguire il comando (spazi e altri caratteri
+``irrilevanti'' inclusi). Per esempio, se si apre una @dfn{pipe}
address@hidden@dotless{i}}:
+
address@hidden
+"sort -r nomi" | getline pippo
address@hidden example
+
address@hidden
+essa va chiusa in questo modo:
+
address@hidden
+close("sort -r nomi")
address@hidden example
+
+Una volta eseguita questa chiamata di funzione, la successiva @code{getline}
+da quel file o comando, o la successiva @code{print} o @code{printf} verso quel
+file o comando, riaprono il file o eseguono nuovamente il comando.
+Poich@'e l'espressione da usare per chiudere un file o una @dfn{pipeline} deve
+essere uguale all'espressione usata per aprire il file o eseguire il comando,
address@hidden buona norma usare una variabile che contenga il @value{FN} o il
comando.
+Il precedente esempio cambia come segue:
+
address@hidden
+sortcom = "sort -r nomi"
+sortcom | getline pippo
address@hidden
+close(sortcom)
address@hidden example
+
address@hidden
+Questo aiuta a evitare nei programmi @command{awk} errori di battitura
+difficili da scoprire. Queste sono alcune delle ragioni per cui @`e bene
+chiudere un file di output:
+
address@hidden @value{BULLET}
address@hidden
+Scrivere un file e rileggerlo in seguito all'interno dello stesso programma
address@hidden Occorre chiudere il file dopo aver finito di scriverlo, e poi
+iniziare a rileggerlo con @code{getline}.
+
address@hidden
+Per scrivere numerosi file, uno dopo l'altro, nello stesso programma
address@hidden Se i file non vengono chiusi, prima o poi @command{awk}
address@hidden
+superare il limite di sistema per il numero di file aperti in un processo.
address@hidden meglio chiudere ogni file quando il programma ha finito di
scriverlo.
+
address@hidden
+Per terminare un comando. Quando l'output @`e ridiretto usando una @dfn{pipe},
+il comando che legge la @dfn{pipe} normalmente continua a tentare di leggere
+input finch@'e la @dfn{pipe} rimane aperta. Spesso questo vuol dire che
+il comando non address@hidden eseguire il compito a lui assegnato finch@'e la
@dfn{pipe}
+non viene chiusa. Per esempio, se l'output @`e ridiretto al programma
address@hidden, il messaggio non @`e effettivamente inviato finch@'e la
@dfn{pipe}
+non viene chiusa.
+
address@hidden
+Eseguire lo stesso programma una seconda volta, con gli stessi argomenti.
+Questo non equivale a fornire ulteriore input alla prima esecuzione!
+
+Per esempio, si supponga che una programma invii tramite una @dfn{pipe}
+dell'output al programma @command{mail}.
+Se invia parecchie linee ridirigendole a questa @dfn{pipe} senza chiuderla,
+queste costituiscono un solo messaggio di parecchie righe. Invece, se il
+programma chiude la @dfn{pipe} dopo ogni riga dell'output, allora ogni riga
+costituisce un messaggio separato.
address@hidden itemize
+
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{close()}
address@hidden address@hidden, funzione @code{close()}
address@hidden funzione @code{close()}, address@hidden
address@hidden @code{close()}, funzione, address@hidden
+Se si usano file in numero superiore a quelli che il sistema permette
+di mantenere aperti,
address@hidden tenta di riutilizzare i file aperti disponibili fra
+i @value{DF}. La address@hidden che @command{gawk} lo faccia dipende dalle
address@hidden del sistema operativo, e quindi non @`e detto che questo riesca
+sempre. @`E quindi sia una buona pratica
+che un buon suggerimento per la address@hidden quello di usare sempre
address@hidden()} sui file, una volta che si @`e finito di operare su di essi.
+In effetti, se si usano molte @dfn{pipe}, @`e fondamentale che i comandi
+vengano chiusi, una volta finita la loro elaborazione. Per esempio, si
+consideri qualcosa del tipo:
+
address@hidden
address@hidden
+ @dots{}
+ comando = ("grep " $1 " /qualche/file | un_mio_programma -q " $3)
+ while ((comando | getline) > 0) @{
+ @var{elabora output di} comando
+ @}
+ # qui serve close(comando)
address@hidden
address@hidden example
+
+Questo esempio crea una nuova @dfn{pipeline} a seconda dei dati contenuti in
address@hidden record.
+Senza la chiamata a @code{close()} indicata come commento, @command{awk}
+genera processi-figlio per eseguire i comandi, fino a che non finisce per
+esaurire i descrittori di file
+necessari per creare ulteriori @dfn{pipeline}.
+
+Sebbene ogni comando sia stato completato (come si deduce dal codice di
+fine-file restituito dalla @code{getline}), il processo-figlio non @`e
+terminato;@footnote{La terminologia tecnica @`e piuttosto macabra.
+Il processo-figlio terminato @`e chiamato ``zombie,'' e la pulizia alla fine
+dello stesso @`e chiamata ``reaping'' [mietitura].}
address@hidden Good old UNIX: give the marketing guys fits, that's the ticket
+inoltre, e questo @`e address@hidden che address@hidden ci interessa, il
descrittore di file
+per la @dfn{pipe} non @`e chiuso e liberato finch@'e non si chiama
address@hidden()} o finch@'e il programma @command{awk} non termina.
+
address@hidden()} non fa nulla (e non emette messaggi) se le viene fornito come
+argomento una stringa che non rappresenta un file, una @dfn{pipe} o un
+coprocesso che sia stato aperto mediante una ridirezione. In quel caso,
address@hidden()} restituisce un valore di ritorno negativo, che indica un
+errore. Inoltre, @command{gawk} imposta @code{ERRNO}
+a una stringa che indica il tipo di errore.
+
+Si noti anche che @samp{close(NOME_FILE)} non ha effetti ``magici'' sul ciclo
+implicito che legge ogni record dei file indicati nella riga di comando.
+Si tratta, con ogni address@hidden, della chiusura di un file che non era mai
+stato aperto con una ridirezione,
+e per questo @command{awk} silenziosamente non fa nulla, tranne impostare un
+codice di ritorno negativo.
+
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O),
@address@hidden chiusura
+Quando si usa l'operatore @samp{|&} per comunicare con un coprocesso,
address@hidden talora utile essere in grado di chiudere un lato della @dfn{pipe}
+bidirezionale, senza chiudere l'altro lato.
+Questo @`e possibile fornendo un secondo argomento a @code{close()}.
+Come in ogni altra invocazione di @code{close()},
+il primo argomento @`e il nome del comando o file speciale usato
+per iniziare il coprocesso.
+Il secondo argomento dovrebbe essere una stringa, con uno dei due valori
address@hidden"to"} [a] oppure @code{"from"} [da]. Maiuscolo/minuscolo non fa
+differenza. Poich@'e questa @`e una address@hidden avanzata, la trattazione
@`e
+rinviata alla
address@hidden/O bidirezionale},
+che ne parla address@hidden dettagliatamente e fornisce un esempio.
+
address@hidden sidebar, Usare il valore di ritorno di @code{close()}
address@hidden
address@hidden
+<sidebar><title>Usare il valore di ritorno di @code{close()}</title>
address@hidden docbook
+
address@hidden angolo buio, funzione @code{close()}
address@hidden funzione @code{close()}, valore di ritorno
address@hidden @code{close()}, funzione, valore di ritorno
address@hidden valore di address@hidden funzione @code{close()}
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{close()}
address@hidden Unix @command{awk}, funzione @code{close()} e
+
+In molte versioni di Unix @command{awk}, la funzione @code{close()}
address@hidden in address@hidden un'istruzione.
address@hidden
address@hidden un errore di sintassi tentare di usare il valore
+di ritorno da @code{close()}:
+
address@hidden
+comando = "@dots{}"
+comando | getline info
+retval = close(comando) # errore di sintassi in parecchi Unix awk
address@hidden example
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden variabile @code{ERRNO}, con funzione @command{close()}
address@hidden @code{ERRNO}, variabile, con funzione @command{close()}
address@hidden gestisce @code{close()} come una funzione.
+Il valore di ritorno @`e @minus{}1 se l'argomento designa un file
+che non era mai stato aperto con una ridirezione, o se c'@`e un problema di
+sistema nella chiusura del file o del processo.
+In tal caso, @command{gawk} imposta la variabile predefinita
address@hidden a una stringa che descrive il problema.
+
+In @command{gawk}, a partire dalla @value{PVERSION} 4.2,
+quando si chiude una @dfn{pipe} o un coprocesso (in input o in output),
+il valore di ritorno @`e quello restituito dal comando,
+come descritto in @address@hidden
+della @value{PVERSION} 4.2, il valore di ritorno dopo la chiusura di
+una @dfn{pipe} o di un coprocesso era una cifra di due byte (16-bit),
+contenente il valore restituito dalla chiamata di sistema @code{wait()}}.
+Altrimenti, @`e il valore di ritorno dalla chiamata alle funzione
+di sistema @code{close()} o alla funzione C @code{fclose()}
+se si sta chiudendo un file in input o in output, rispettivamente.
+Questo valore @`e zero se la chiusura riesce, o @minus{}1 se non riesce.
+
address@hidden Tabella,table-close-pipe-return-values
address@hidden di ritorno dalla @code{close()} di una @dfn{pipe}}
address@hidden @columnfractions .50 .50
address@hidden Situazione @tab Valore restituito da @code{close()}
address@hidden Uscita normale dal comando @tab Il codice di ritorno del comando
address@hidden Uscita dal comando per @dfn{signal} @tab 256 + numero del
segnale assassino
address@hidden Uscita dal comando per @dfn{signal} con @dfn{dump} @tab 512 +
numero del segnale assassino
address@hidden Errore di qualsiasi tipo @tab @minus{}1
address@hidden multitable
address@hidden float
+
+Lo standard POSIX @`e molto generico; dice che @code{close()}
+restituisce zero se @`e terminata correttamente, e un valore diverso da zero
+nell'altro caso. In generale,
+implementazioni differenti variano in quel che restituiscono chiudendo una
address@hidden; quindi, il valore di ritorno non address@hidden essere usato in
modo
+portabile.
address@hidden
+In address@hidden POSIX (@pxref{Opzioni}), @command{gawk} restituisce solo zero
+quando chiude una @dfn{pipe}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Usare il valore di ritorno di @code{close()}}
+
+
address@hidden angolo buio, funzione @code{close()}
address@hidden funzione @code{close()}, valore di ritorno
address@hidden @code{close()}, funzione, valore di ritorno
address@hidden valore di address@hidden funzione @code{close()}
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{close()}
address@hidden Unix @command{awk}, funzione @code{close()} e
+
+In molte versioni di Unix @command{awk}, la funzione @code{close()}
address@hidden in address@hidden un'istruzione.
address@hidden
address@hidden un errore di sintassi tentare di usare il valore
+di ritorno da @code{close()}:
+
address@hidden
+comando = "@dots{}"
+comando | getline info
+retval = close(comando) # errore di sintassi in parecchi Unix awk
address@hidden example
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden variabile @code{ERRNO}, con funzione @command{close()}
address@hidden @code{ERRNO}, variabile, con funzione @command{close()}
address@hidden gestisce @code{close()} come una funzione.
+Il valore di ritorno @`e @minus{}1 se l'argomento designa un file
+che non era mai stato aperto con una ridirezione, o se c'@`e un problema di
+sistema nella chiusura del file o del processo.
+In tal caso, @command{gawk} imposta la variabile predefinita
address@hidden a una stringa che descrive il problema.
+
+In @command{gawk}, a partire dalla @value{PVERSION} 4.2,
+quando si chiude una @dfn{pipe} o un coprocesso (in input o in output),
+il valore di ritorno @`e quello restituito dal comando,
+come descritto in @address@hidden
+della @value{PVERSION} 4.2, il valore di ritorno dopo la chiusura di
+una @dfn{pipe} o di un coprocesso era una cifra di due byte (16-bit),
+contenente il valore restituito dalla chiamata di sistema @code{wait()}}.
+Altrimenti, @`e il valore di ritorno dalla chiamata alle funzione
+di sistema @code{close()} o alla funzione C @code{fclose()}
+se si sta chiudendo un file in input o in output, rispettivamente.
+Questo valore @`e zero se la chiusura riesce, o @minus{}1 se non riesce.
+
address@hidden Tabella,table-close-pipe-return-values
address@hidden di ritorno dalla @code{close()} di una @dfn{pipe}}
address@hidden @columnfractions .50 .50
address@hidden Situazione @tab Valore restituito da @code{close()}
address@hidden Uscita normale dal comando @tab Il codice di ritorno del comando
address@hidden Uscita dal comando per @dfn{signal} @tab 256 + numero del
segnale assassino
address@hidden Uscita dal comando per @dfn{signal} con @dfn{dump} @tab 512 +
numero del segnale assassino
address@hidden Errore di qualsiasi tipo @tab @minus{}1
address@hidden multitable
address@hidden float
+
+Lo standard POSIX @`e molto generico; dice che @code{close()}
+restituisce zero se @`e terminata correttamente, e un valore diverso da zero
+nell'altro caso. In generale,
+implementazioni differenti variano in quel che restituiscono chiudendo una
address@hidden; quindi, il valore di ritorno non address@hidden essere usato in
modo
+portabile.
address@hidden
+In address@hidden POSIX (@pxref{Opzioni}), @command{gawk} restituisce solo zero
+quando chiude una @dfn{pipe}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Continuazione dopo errori
address@hidden Abilitare continuazione dopo errori in output
+
+Questa @value{SECTION} descrive una address@hidden specifica di @command{gawk}.
+
+In @command{awk} standard, l'output con @code{print} o @code{printf}
+a un file che non esiste, o qualche altro errore di I/O (come p.es.
+esaurire lo spazio disponibile su disco) @`e un errore fatale (termina
+l'esecuzione del programma).
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print "ciao" > "/file/non/esistente" @}'}
address@hidden gawk: riga com.:1: fatale: non riesco a ri-dirigere a
address@hidden `/file/non/esistente' (/file o directory non esistente)
address@hidden example
+
address@hidden rende possibile accorgersi che c'@`e stato un errore,
+permettendo di tentare di rimediare, o almeno di stampare un messaggio
+di errore prima di terminare il programma.
address@hidden possibile fare questo in due modi differenti:
+
address@hidden @bullet
address@hidden
+Per tutti i file in output, assegnando un valore qualsiasi a
address@hidden"NONFATAL"]}.
+
address@hidden
+Specificamente per un solo file, assegnando un valore qualsiasi a
address@hidden@var{nome_file}, "NONFATAL"]}.
address@hidden @`e il nome del file per il quale
+si desidera che l'errore di output non faccia terminare il programma.
address@hidden itemize
+
+Una volta abilitata la continuazione dopo un errore di output, si
address@hidden
+controllare la variabile @code{ERRNO} dopo ogni istruzione
address@hidden o @code{printf} diretta a quel file, per controllare che
+tutto sia andato a buon fine. @`E anche una buona idea inizializzare
address@hidden a zero prima di tentare l'operazione di scrittura.
+Per esempio:
+
address@hidden
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{ PROCINFO["NONFATAL"] = 1}
+> @kbd{ ERRNO = 0}
+> @kbd{ print "ciao" > "/file/non/esistente"}
+> @kbd{ if (ERRNO) @{}
+> @kbd{ print("Output non riuscito:", ERRNO) > "/dev/stderr"}
+> @kbd{ exit 1}
+> @kbd{ @}}
+> @address@hidden'}
address@hidden Output non riuscito: No such file or directory
address@hidden example
+
address@hidden non genera un errore fatale; permette invece
+al programma @command{awk} di rendersi conto del problema e di gestirlo.
+
+Questo meccanismo si applica anche allo standard output e allo standard error.
+Per lo standard output, si address@hidden usare @code{PROCINFO["-",
"NONFATAL"]}
+o @code{PROCINFO["/dev/stdout", "NONFATAL"]}.
+Per lo standard error, occorre
+usare @code{PROCINFO["/dev/stderr", "NONFATAL"]}.
+
+Se si tenta di aprire un @dfn{socket} TCP/IP (@pxref{Reti TCP/IP}),
address@hidden tenta di farlo per un certo numero di volte.
+La variabile d'ambiente @env{GAWK_SOCK_RETRIES}
+(@pxref{Altre variabili d'ambiente}) consente di alterare il numero di
+tentativi che @command{gawk} farebbe per default. Tuttavia,
+una volta abilitata la continuazione dopo un errore di I/O per un certo
address@hidden, @command{gawk} si limita a un solo tentativo,
+lasciando al codice del programma @command{awk} il compito di gestire
+l'eventuale problema.
+
address@hidden Sommario di Output
address@hidden Sommario.
+
address@hidden @value{BULLET}
address@hidden
+L'istruzione @code{print} stampa una lista di espressioni separate da virgole.
+Le espressioni sono separate tra loro dal valore di @code{OFS} e completate
+dal valore di @code{ORS}. @code{OFMT} fornisce il formato di conversione
+dei valori numerici per l'istruzione @code{print}.
+
address@hidden
+L'istruzione @code{printf} fornisce un controllo address@hidden preciso
sull'output,
+con lettere di controllo del formato per diversi tipi di dati e vari
+modificatori
+che cambiano il comportamento delle lettere di controllo del formato.
+
address@hidden
+L'output sia di @code{print} che di @code{printf} address@hidden essere
ridiretto a
+file, @dfn{pipe}, e coprocessi.
+
address@hidden
address@hidden fornisce @value{FNS} speciali per accedere allo
+standard input, standard output e standard error, e per comunicazioni di rete.
+
address@hidden
+Usare @code{close()} per chiudere file aperti, @dfn{pipe} e ridirezioni a
+coprocessi.
+Per i coprocessi, @`e possibile chiudere anche soltanto una delle due
+direzioni di comunicazione.
+
address@hidden
+Normalmente se si verificano errori eseguendo istruzioni @code{print} o
address@hidden, questi causano la fine del programma.
address@hidden consente di proseguire l'elaborazione anche in questo
+caso, o per un errore su qualsiasi file in output, o per un errore
+relativo a qualche file in particolare.
+Resta a carico del programma controllare se si sono verificati errori
+dopo l'esecuzione di ogni istruzione di output interessata.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi su Output
address@hidden Esercizi
+
address@hidden
address@hidden
+Riscrivere il programma:
+
address@hidden
+awk 'BEGIN @{ print "Mese Contenitori"
+ print "----- -----------" @}
+ @{ print $1, $2 @}' inventory-shipped
address@hidden example
+
address@hidden
+come
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di output}, usando un nuovo valore per @code{OFS}.
+
address@hidden
+Usare l'istruzione @code{printf} per allineare le intestazioni e i dati
+della tabella
+per il file di esempio @file{inventory-shipped} utilizzato nella @ref{Print}.
+
address@hidden
+Spiegare cosa succede se si dimenticano i doppi apici ridirigendo l'output,
+come nel caso che segue:
+
address@hidden
+BEGIN @{ print "Ho trovato un errore grave!" > /dev/stderr @}
address@hidden example
+
address@hidden enumerate
address@hidden EXCLUDE END
+
+
address@hidden Espressioni
address@hidden Espressioni
address@hidden espressioni
+
+Le espressioni sono i mattoni fondamentali dei modelli di ricerca e delle
+azioni di @command{awk}. Un'espressione genera un valore che si
address@hidden stampare, verificare o passare a una funzione. Oltre a
address@hidden, un'espressione
address@hidden assegnare un nuovo valore a una variabile o a un campo usando un
operatore
+di assegnamento.
+
+Un'espressione address@hidden servire come modello di ricerca o istruzione di
azione a
+s@'e stante. La maggior parte degli altri tipi di istruzione contengono una o
address@hidden espressioni che specificano i dati sui quali operare. Come in
altri
+linguaggi, le espressioni in @command{awk} possono includere variabili,
+riferimenti a vettori e a costanti, e chiamate di funzione, come pure
+combinazioni tra questi usando diversi operatori.
+
address@hidden
+* Valori:: Costanti, variabili ed espressioni regolari.
+* Tutti gli operatori:: Gli operatori di @command{gawk}.
+* Valori e condizioni di address@hidden:: Determinare Vero/Falso.
+* Chiamate di funzione:: Una chiamata di funzione address@hidden essere
+ un'espressione.
+* Precedenza:: Come si nidificano i vari operatori.
+* Localizzazioni:: Come la localizzazione influenza la
+ gestione dati.
+* Sommario delle espressioni:: Sommario delle espressioni.
address@hidden menu
+
address@hidden Valori
address@hidden Costanti, variabili e conversioni
+
+Le espressioni sono costruite a partire da valori e dalle operazioni eseguite
+su di essi. Questa @value{SECTION} descrive gli oggetti elementari
+che forniscono i valori usati nelle espressioni.
+
address@hidden
+* Costanti:: Costanti di tipo stringa, numeriche ed
+ espressioni regolari
+* Usare le costanti @dfn{regexp}:: Quando e come usare una costante
+ specificata tramite espressioni regolari
+* Variabili:: Le variabili permettono di
+ definire valori da usare in seguito.
+* Conversione:: La conversione di stringhe in numeri
+ e viceversa.
address@hidden menu
+
address@hidden Costanti
address@hidden Espressioni costanti
+
address@hidden costanti, tipi di
+
+Il tipo di espressione address@hidden semplice @`e una @dfn{costante}, che ha
sempre lo
+stesso valore. Ci sono tre tipi di costanti: numeriche, di stringa e di
+espressione regolare.
+
+Ognuna di esse si usa nel contesto appropriato quando occorre assegnare ai
+dati un valore che non address@hidden essere cambiato. Le costanti numeriche
possono
+avere forme diverse, ma sono memorizzate internamente sempre allo stesso modo.
+
address@hidden
+* Costanti scalari:: Costanti numeriche e stringhe.
+* Numeri non-decimali:: Cosa sono i numeri ottali ed esadecimali.
+* Costanti come espressioni regolari:: Costanti fornite tramite espressioni
+ regolari.
address@hidden menu
+
address@hidden Costanti scalari
address@hidden Costanti numeriche e stringhe
+
address@hidden costanti numeriche
address@hidden numeriche, costanti
+Una @dfn{costante numerica} @`e un numero. Questo numero address@hidden
essere un
+numero intero, una frazione decimale o un numero in notazione scientifica
+(esponenziale)address@hidden rappresentazione interna di tutti i numeri,
+compresi gli interi, usa numeri in virgola mobile a doppia precisione.
+Sui sistemi address@hidden moderni, questi sono nel formato standard IEEE 754.
address@hidden con precisione arbitraria}, per maggiori informazioni.}
+Ecco alcuni esempi di costanti numeriche che hanno tutte lo stesso
+valore:
+
address@hidden
+105
+1.05e+2
+1050e-1
address@hidden example
+
address@hidden costanti stringa
+Una @dfn{costante stringa} @`e formata da una sequenza di caratteri racchiusi
tra
+doppi apici. Per esempio:
+
address@hidden
+"pappagallo"
address@hidden example
+
address@hidden
address@hidden differenze tra @command{awk} e @command{gawk}, stringhe
address@hidden stringhe, limitazioni della lunghezza
+rappresenta la stringa il cui contenuto @`e la parola @samp{pappagallo}.
+Le stringhe in
address@hidden possono essere di qualsiasi lunghezza, e possono contenere
+tutti i possibili caratteri ASCII a otto bit, compreso il carattere ASCII
address@hidden (carattere con codice zero).
+Altre implementazioni di @command{awk} possono avere address@hidden con alcuni
+particolari codici di carattere.
+
address@hidden Numeri non-decimali
address@hidden Numeri ottali ed esadecimali
address@hidden ottali, numeri
address@hidden esadecimali, numeri
address@hidden numeri ottali
address@hidden numeri esadecimali
+
+In @command{awk}, tutti i numeri sono espressi nel sistema decimale
(address@hidden a
+base 10).
+Molti altri linguaggi di programmazione consentono di specificare i numeri in
+altre basi, spesso in ottale (base 8) e in esadecimale (base 16).
+Nel sistema ottale i numeri hanno la sequenza 0, 1, 2, 3, 4, 5, 6, 7, 10, 11,
+12, e address@hidden@dotless{i}} via. Come @samp{11} decimale @`e una volta
10 address@hidden 1, address@hidden@dotless{i}}
address@hidden ottale @`e una volta 8 address@hidden 1. Questo equivale a 9 nel
sistema decimale.
+Nell'esadecimale ci sono 16 cifre. Poich@'e l'usuale sistema numerico decimale
+ha solo dieci cifre (@address@hidden), le lettere da
address@hidden a @samp{f} rappresentano le cifre ulteriori.
+(normalmente @`e irrilevante se le lettere sono maiuscole o minuscole; gli
+esadecimali @samp{a} e @samp{A} hanno lo stesso valore).
address@hidden@dotless{i}}, @samp{11} esadecimale @`e 1 volta 16 address@hidden
1,
+il che equivale a 17 decimale.
+
+Guardando solamente un @samp{11} puro e semplice, non si capisce in quale base
+sia. address@hidden@dotless{i}}, in C, C++, e in altri linguaggi derivati da
C,
address@hidden such as PERL, but we won't mention that....
+c'@`e una speciale notazione per esprimere la base.
+I numeri ottali iniziano con uno @samp{0},
+e i numeri esadecimali iniziano con uno @samp{0x} o @samp{0X}:
+
address@hidden @code
address@hidden 11
+Valore decimale 11
+
address@hidden 011
+11 ottale, valore decimale 9
+
address@hidden 0x11
+11 esadecimale, valore decimale 17
address@hidden table
+
+Quest'esempio mostra le differenze:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "%d, %d, %d\n", 011, 11, 0x11 @}'}
address@hidden 9, 11, 17
address@hidden example
+
+Poter usare costanti ottali ed esadecimali nei propri programmi @`e molto utile
+quando si lavora con dati che non possono essere rappresentati
+convenientemente come caratteri o come numeri regolari, come i dati binari di
+vario tipo.
+
address@hidden @command{gawk}, numeri ottali e
address@hidden @command{gawk}, numeri esadecimali e
address@hidden permette l'uso di costanti ottali ed esadecimali nel testo di
+un programma. Comunque, se numeri non-decimali sono presenti tra i dati in
+input, essi non sono trattati in maniera speciale; trattarli in modo speciale
+per default significherebbe che vecchi programmi @command{awk} produrrebbero
+risultati errati.
+(Se si vuole che i numeri siano trattati in maniera speciale, si deve
+specificare l'opzione da riga di comando
address@hidden;
address@hidden non decimali}.)
+Se si devono gestire dati ottali o esadecimali,
+si address@hidden usare la funzione @code{strtonum()}
+(@pxref{Funzioni per stringhe})
+per convertire i dati in numeri.
+La maggior parte delle volte, le costanti ottali o esadecimali si usano quando
+si lavora con le funzioni predefinite di manipolazione di bit;
+si veda @ref{Funzioni a livello di bit}
+per maggiori informazioni.
+
+Diversamente da alcune tra le prime implementazioni di C, @samp{8} e @samp{9}
+non sono cifre valide nelle costanti ottali. Per esempio, @command{gawk}
+tratta @samp{018} come un 18 decimale:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print "021 @`e", 021 ; print 018 @}'}
address@hidden 021 @`e 17
address@hidden 18
address@hidden example
+
address@hidden address@hidden compatibile di (@command{gawk}), numeri ottali
address@hidden numeri ottali nella address@hidden compatibile di
(@command{gawk})
address@hidden address@hidden compatibile di (@command{gawk}), numeri
esadecimali
address@hidden numeri esadecimali nella address@hidden compatibile di
(@command{gawk})
address@hidden compatibile, address@hidden (@command{gawk}), numeri ottali
address@hidden compatibile, address@hidden (@command{gawk}), numeri esadecimali
+Le costanti ottali ed esadecimali nel codice sorgente sono un'estensione di
address@hidden Se @command{gawk} @`e in address@hidden compatibile
+(@pxref{Opzioni}),
+non sono disponibili.
+
address@hidden sidebar, La base di una costante non influisce sul suo valore
address@hidden
address@hidden
+<sidebar><title>La base di una costante non influisce sul suo valore</title>
address@hidden docbook
+
+
+Una volta che una costante numerica @`e stata
+convertita internamente in un numero [decimale],
address@hidden non considera address@hidden
+la forma originale della costante; viene sempre usato il valore
+interno. Questo ha delle precise conseguenze per la conversione dei
+numeri in stringhe:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "0x11 vale <%s>\n", 0x11 @}'}
address@hidden 0x11 vale <17>
address@hidden example
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{La base di una costante non influisce sul suo valore}
+
+
+
+Una volta che una costante numerica @`e stata
+convertita internamente in un numero [decimale],
address@hidden non considera address@hidden
+la forma originale della costante; viene sempre usato il valore
+interno. Questo ha delle precise conseguenze per la conversione dei
+numeri in stringhe:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "0x11 vale <%s>\n", 0x11 @}'}
address@hidden 0x11 vale <17>
address@hidden example
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Costanti come espressioni regolari
address@hidden Costanti fornite tramite espressioni regolari
+
address@hidden @dfn{regexp}, costanti
address@hidden costanti @dfn{regexp}
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
+Una @dfn{costante regexp} @`e la descrizione di un'espressione regolare
+delimitata
+da barre, come @address@hidden/^inizio e fine$/}}. La maggior parte delle
address@hidden usate nei programmi @command{awk} sono costanti, ma gli operatori
+di confronto @samp{~} e @samp{!~} possono confrontare anche @dfn{regexp}
+calcolate o dinamiche (che tipicamente sono solo stringhe ordinarie o
+variabili che contengono un'espressione regolare, ma potrebbero anche essere
+espressioni address@hidden complesse).
+
address@hidden Usare le costanti @dfn{regexp}
address@hidden Usare espressioni regolari come costanti
+
+Le costanti @dfn{regexp} sono costituite da testo che descrive un'espressione
+regolare, racchiusa fra barre (come p.e. @code{/la +risposta/}).
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta del comportamento di tali costanti in
+POSIX @command{awk} e in @command{gawk}, e prosegue descrivendo le
address@hidden @dfn{regexp} fortemente tipizzate}, che sono
+un'estensione @command{gawk}.
+
address@hidden
+* Costanti @dfn{regexp} normali:: Costanti @dfn{regexp} normali in
+ @command{awk}.
+* Costanti @dfn{regexp} forti:: Costanti @dfn{regexp} fortemente tipizzate.
address@hidden menu
+
address@hidden Costanti @dfn{regexp} normali
address@hidden Costanti @dfn{regexp} normali in @command{awk}.
+
address@hidden angolo buio, costanti @dfn{regexp}
+Quand'@`e usata a destra degli operatori @samp{~} o @samp{!~},
+una costante @dfn{regexp} rappresenta semplicemente l'espressione regolare che
+dev'essere confrontata. Comunque, le costanti @dfn{regexp} (come
@code{/pippo/})
+possono essere usate come semplici espressioni.
+Quando una
+costante @dfn{regexp} compare da sola, ha lo stesso significato di quando
+compare in un criterio di ricerca (address@hidden @samp{($0 ~ /pippo/)}).
address@hidden
address@hidden come criteri di ricerca}.
address@hidden vuol dire che i due frammenti di codice seguenti:
+
address@hidden
+if ($0 ~ /barfly/ || $0 ~ /camelot/)
+ print "trovato"
address@hidden example
+
address@hidden
+e:
+
address@hidden
+if (/barfly/ || /camelot/)
+ print "trovato"
address@hidden example
+
address@hidden
+sono esattamente equivalenti.
+Una conseguenza piuttosto bizzarra di questa regola @`e che la seguente
+espressione booleana @`e valida, ma non fa quel che probabilmente l'autore
+si aspettava:
+
address@hidden
+# Notare che /pippo/ @`e alla @emph{sinistra} della ~
+if (/pippo/ ~ $1) print "trovato pippo"
address@hidden example
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden @command{gawk}, costanti @dfn{regexp} e
address@hidden costanti @dfn{regexp}, in @command{gawk}
address@hidden
+Questo codice ``ovviamente'' intende verificare se @code{$1} contiene
+l'espressione regolare @code{/pippo/}. Ma in effetti l'espressione
address@hidden/pippo/ ~ $1} significa realmente @samp{($0 ~ /pippo/) ~ $1}. In
altre
+parole, prima confronta il record in input con l'espressione regolare
address@hidden/pippo/}. Il risultato @`e zero o uno, a seconda che il
confronto dia esito
+positivo o negativo. Questo risultato
address@hidden poi confrontato col primo campo nel record.
+Siccome @`e improbabile che qualcuno voglia mai fare realmente questo genere di
+test, @command{gawk} emette un avvertimento quando vede questo costrutto in
+un programma.
+Un'altra conseguenza di questa regola @`e che l'istruzione di assegnamento:
+
address@hidden
+confronta = /pippo/
address@hidden example
+
address@hidden
+assegna zero o uno alla variabile @code{confronta}, a seconda
+del contenuto del record in input corrente.
+
address@hidden differenze tra @command{awk} e @command{gawk}, costanti
@dfn{regexp}
address@hidden angolo buio, costanti @dfn{regexp}, come argomenti a funzioni
definite dall'utente
address@hidden
address@hidden
address@hidden
+Le espressioni regolari costanti possono essere usate anche come primo
+argomento delle
+funzioni @code{gensub()}, @code{sub()}, e @code{gsub()}, come secondo argomento
+della funzione @code{match()},
+e come terzo argomento delle funzioni @code{split()} e @code{patsplit()}
+(@pxref{Funzioni per stringhe}).
+Le moderne implementazioni di @command{awk}, incluso @command{gawk}, permettono
+di usare come terzo argomento di @code{split()} una costante @dfn{regexp}, ma
+alcune implementazioni address@hidden vecchie non lo consentono.
address@hidden
+Poich@'e alcune funzioni predefinite accettano costanti @dfn{regexp} come
+argomenti, address@hidden generare confusione l'uso di costanti @dfn{regexp}
come
+argomenti di funzioni definite dall'utente
+(@pxref{Funzioni definite dall'utente}). Per esempio:
+
address@hidden
+function mysub(modello, sostituzione, stringa, globale)
address@hidden
+ if (globale)
+ gsub(modello, sostituzione, stringa)
+ else
+ sub(modello, sostituzione, stringa)
+ return stringa
address@hidden
+
address@hidden
+ @dots{}
+ text = "salve! salve a te!"
+ mysub(/salve/, "ciao", text, 1)
+ @dots{}
address@hidden
address@hidden example
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
+In quest'esempio, il programmatore vuol passare una costante @dfn{regexp} alla
+funzione definita dall'utente @code{mysub()}, che a sua volta la passa o a
address@hidden()} o a @code{gsub()}. Comunque, quel che realmente succede @`e
che
+al parametro @code{modello} @`e assegnato un valore di uno o zero, a seconda
+che @code{$0} corrisponda a @code{/salve/} o no.
address@hidden emette un avvertimento quando vede una costante @dfn{regexp}
+usata come parametro di una funzione definita dall'utente, poich@'e
+passare un valore vero/falso in questo modo probabilmente non @`e quello che
+si intendeva fare.
+
address@hidden Costanti @dfn{regexp} forti
address@hidden Costanti @dfn{regexp} fortemente tipizzate
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden specifica di @command{gawk}.
+
+Come visto
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden
address@hidden
address@hidden ifdocbook
+precedente,
+le costanti @dfn{regexp} (@code{/@dots{}/}) hanno uno strano posto nel
+linguaggio @command{awk}. In molti contesti, si comportano come
+un'espressione:
address@hidden ~ /@dots{}/}. In altri contesti, denotano solo una @dfn{regexp}
da
+individuare. In nessun caso esse sono davvero ``cittadine di serie A'' del
+linguaggio. Ovvero, non @`e possibile definire una variabile scalare il cui
+tipo sia address@hidden'' nello stesso senso in cui si address@hidden definire
una
+variabile che sia un numero o una stringa:
+
address@hidden
+num = 42 @ii{Variabile numerica}
+str = "hi" @ii{Variabile di tipo stringa}
+re = /pippo/ @ii{Errore!} re @address@hidden il risultato di} $0 ~ /pippo/
address@hidden example
+
+Per alcuni casi di uso address@hidden avanzati,
+sarebbe bello poter avere costanti @dfn{regexp} che sono
address@hidden tipizzate}; in altre parole, che sostituiscono
+una @dfn{regexp} utile per effettuare dei confronti,
+e non una semplice espressione regolare.
+
address@hidden prevede questa address@hidden Un'espressione regolare
+fortemente tipizzata @`e molto simile a un'espressione regolare normale,
+tranne per il fatto di essere preceduta dal simbolo @samp{@@}:
+
address@hidden
+re = @@/foo/ @ii{variabile @dfn{regexp} fortemente tipizzata}
address@hidden example
+
+Le variabili @dfn{regexp} fortemente tipizzate @emph{non possono} essere
+usate in ogni istruzione in cui compare un'espressione regolare normale.
+perch@'e address@hidden renderebbe il linguaggio ancora address@hidden
fuorviante.
+Queste espressioni possono essere usate solo in alcuni contesti:
+
address@hidden @bullet
address@hidden
+Sul lato destro degli operatori @samp{~} e @samp{!~}:
address@hidden ~ @@/foo/}
+(@pxref{Uso di @dfn{regexp}}).
+
address@hidden
+Nella parte @code{case} di un'istruzione @code{switch}
+(@pxref{Istruzione switch}).
+
address@hidden
+Come argomento in una delle funzioni predefinite che possono utilizzare
+costanti @dfn{regexp}:
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()}
+e
address@hidden()}
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Come parametro in una chiamata a una funzione definita dall'utente
+(@pxref{Funzioni definite dall'utente}).
+
address@hidden
+Sul lato destro di un assegnamento di variabile:
address@hidden = @@/foo/}.
+In tal caso, @code{qualche_variabile} @`e di tipo @dfn{regexp}.
+Inoltre, @code{qualche_variabile}
address@hidden essere usata con gli operatori @samp{~} e @samp{!~}, passata a
una
+delle funzioni predefinite sopra elencate o passata come parametro
+a una funzione definita dall'utente.
address@hidden itemize
+
+Si address@hidden usare la funzione predefinita @code{typeof()}
+(@pxref{Funzioni per i tipi})
+per determinare se un parametro passato a una funzione
address@hidden una variabile di tipo @dfn{regexp}.
+
+La vera efficacia di questa address@hidden consiste nella address@hidden di
creare
+variabili il cui tipo @`e @dfn{regexp}. Tali variabili possono essere passate
+a funzioni definite dall'utente, senza gli inconvenenti che si hanno usando
+espressioni regolari calcolate, a partire da stringhe o da costanti di tipo
+stringa. Queste variabili possono anche essere passate utilizzando chiamate
+indirette a funzioni (@pxref{Chiamate indirette}) e alle funzioni predefinite
+che accettano costanti di tipo @dfn{regesp}.
+
+Quando sono usate per effettuare conversioni numeriche, le variabili
address@hidden fortemente tipizzate vengono convertite alla cifra zero.
+Quando sono usate per effettuare conversioni a stringhe, vengono convertite
+al valore di stringa del testo della @dfn{regexp} originale.
+
address@hidden Variabili
address@hidden Variabili
+
address@hidden variabili definite dall'utente
address@hidden definite dall'utente, variabili
+Le @dfn{variabili} consentono di memorizzare valori in un certo punto di un
+programma, per usarli address@hidden tardi in un'altra parte del programma.
Le variabili
+possono essere gestite interamente all'interno del testo del programma, ma
+ad esse possono essere assegnati valori sulla riga di comando, in fase di
+invocazione di @command{awk}.
+
address@hidden
+* Usare variabili:: Usare variabili nei propri programmi.
+* Opzioni di assegnamento:: Impostare variabili dalla riga di
+ comando, e un sommario della sintassi
+ della riga di comando.
+ Questo @`e un metodo di input avanzato.
address@hidden menu
+
address@hidden Usare variabili
address@hidden Usare variabili in un programma
+
+Le variabili permettono di dare nomi ai valori e di far riferimento ad essi in
+un secondo momento. Alcune variabili sono address@hidden state usate in molti
degli
+esempi.
+Il nome di una variabile dev'essere una sequenza di lettere, cifre o trattini
+bassi, e non deve iniziare con una cifra.
+Qui, una @dfn{lettera} @`e una qualsiasi delle 52 lettere maiuscole e minuscole
+dell'alfabeto inglese. Altri caratteri che possono essere definiti come
+lettere in localizzazioni non inglesi non sono validi nei nomi di variabile.
+Il maiuscolo o minuscolo sono significativi nei nomi di variabile;
address@hidden e @code{A} sono variabili diverse.
+
+Un nome di variabile @`e un'espressione valida in se stessa; rappresenta il
+valore corrente della variabile. I valori delle variabili possono essere
+modificati tramite @dfn{operatori di assegnamento}, @dfn{operatori di
+incremento} e @dfn{operatori di decremento}
+(@xref{Operatori di assegnamento}).
+Inoltre, le funzioni @code{sub()} e @code{gsub()} possono cambiare il valore
+di una variabile e le funzioni
address@hidden()}, @code{split()}, e @code{patsplit()} possono cambiare il
+contenuto dei loro parametri che sono
+costituiti da vettori
+(@pxref{Funzioni per stringhe}).
+
address@hidden variabili, predefinite
address@hidden variabili, inizializzazione
+Alcune variabili hanno un significato speciale predefinito, come @code{FS}
+(il separatore di campo) e @code{NF} (il numero di campi nel record di input
+corrente). @xref{Variabili predefinite} per un elenco delle variabili
+predefinite. Queste variabili predefinite possono essere usate e possono
+ricevere assegnamenti come tutte le altre variabili, ma i loro valori sono
+anche usati o cambiati automaticamente da @command{awk}. Tutti i nomi delle
+variabili predefinite sono in caratteri maiuscoli.
+
+Alle variabili in @command{awk} possono essere assegnati valori numerici o
+valori di stringa. Il tipo di valore che una variabile contiene
address@hidden cambiare
+durante la vita di un programma. Per default, le variabili sono inizializzate
+alla stringa nulla, che vale zero se viene convertita in un numero. Non c'@`e
+alcuna
address@hidden di inizializzare esplicitamente una variabile in @command{awk},
+come invece occorre fare in C e nella maggior parte dei linguaggi
+tradizionali.
+
address@hidden Opzioni di assegnamento
address@hidden Assegnare una variabile dalla riga di comando
address@hidden variabili, assegnare da riga di comando
address@hidden riga di comando, address@hidden assegnare da
+
+Si address@hidden impostare qualsiasi variabile @command{awk} includendo un
address@hidden di variabile} tra gli argomenti sulla riga di comando quando
+viene invocato @command{awk} (@pxref{Altri argomenti}).
+Tale assegnamento ha la seguente forma:
+
address@hidden
address@hidden@var{testo}
address@hidden example
+
address@hidden @option{-v}, opzione
address@hidden
+Con questo assegnamento, una variabile viene impostata o all'inizio
+dell'esecuzione di @command{awk} o tra la lettura di un file in input e il
+successivo file in input.
+Quando l'assegnamento @`e preceduto dall'opzione @option{-v},
+come nel seguente esempio:
+
address@hidden
+-v @address@hidden
address@hidden example
+
address@hidden
+la variabile @`e impostata proprio all'inizio, ancor prima che sia eseguita la
+regola @code{BEGIN}. L'opzione @option{-v} e il suo assegnamento
+deve precedere tutti gli argomenti @value{FN}, e anche il testo del programma.
+(@xref{Opzioni} per maggiori informazioni sull'opzione
address@hidden)
+In alternativa, l'assegnamento di variabile @`e effettuata in un momento
+determinato
+dalla posizione dell'opzione tra gli argomenti "file in input", address@hidden
dopo
+l'elaborazione del precedente argomento "file in input". Per esempio:
+
address@hidden
+awk '@{ print $n @}' n=4 inventory-shipped n=2 mail-list
address@hidden example
+
address@hidden
+stampa il valore del campo numero @code{n} per tutti i record in input. Prima
+che venga letto il primo file, la riga di comando imposta la variabile @code{n}
+al valore quattro. Questo fa address@hidden@dotless{i}} che venga stampato il
quarto campo delle righe
+del file @file{inventory-shipped}. Dopo la fine del primo file, ma prima
+che inizi il secondo file, @code{n} viene impostato a due, e quindi poi
+viene stampato il secondo campo delle righe di @file{mail-list}:
+
address@hidden
+$ @kbd{awk '@{ print $n @}' n=4 inventory-shipped n=2 mail-list}
address@hidden 15
address@hidden 24
address@hidden
address@hidden 555-5553
address@hidden 555-3412
address@hidden
address@hidden example
+
address@hidden angolo buio, argomenti da riga di comando
+Gli argomenti da riga di comando sono resi disponibili dal programma
address@hidden nel vettore @code{ARGV} per poter essere esaminati esplicitamente
+(@pxref{ARGC e ARGV}).
address@hidden elabora i valori degli assegnamenti da riga di comando per
+sequenze di protezione
+(@pxref{Sequenze di protezione}).
address@hidden
+
address@hidden Conversione
address@hidden Conversione di stringhe e numeri
+
+Le conversioni di numeri in stringhe e di stringhe in numeri sono generalmente
+semplici. Ci possono essere delle sottigliezze che bisogna tenere presenti;
+questa @value{SECTION} tratta di quest'importante sfaccettatura di
@command{awk}.
+
address@hidden
+* Stringhe e numeri:: Come @command{awk} converte tra
+ stringhe e numeri.
+* Localizzazione e conversioni:: Come la localizzazione address@hidden influire
+ sulle conversioni.
address@hidden menu
+
address@hidden Stringhe e numeri
address@hidden Come @command{awk} converte tra stringhe e numeri
+
address@hidden conversione da stringhe a numeri
address@hidden stringhe, conversione
address@hidden numeri, conversione in stringhe
address@hidden conversione da numeri a stringhe
+Le stringhe sono convertite in numeri e i numeri sono convertiti in stringhe,
+se il contesto del programma @command{awk} lo richiede. Per esempio, se il
+valore di @code{pippo} o @code{pluto} nell'espressione @samp{pippo + pluto}
address@hidden una stringa, viene convertita in un numero prima di eseguire
l'addizione.
+Se in una concatenazione di stringhe ci sono valori numerici, questi sono
+convertiti in stringhe. Si consideri il seguente esempio:
+
address@hidden
+due = 2; tre = 3
+print (due tre) + 4
address@hidden example
+
address@hidden
+Stampa il valore (numerico) di 27. I valori numerici delle
+variabili @code{due} e @code{tre} sono convertiti in stringhe e
+concatenati insieme. La stringa risultante @`e riconvertita nel
+numero 23, al quale poi viene aggiunto 4.
+
address@hidden stringhe nulle, conversione da tipo numerico a tipo stringa
address@hidden conversione di tipo variabile
address@hidden variabile, conversione di tipo
+Se, per qualche ragione, si vuole forzare la conversione di un numero in
+una stringa, basta concatenare a quel numero la stringa nulla, @code{""}.
+Per forzare la conversione di una stringa in un numero, basta aggiungere zero
+a quella stringa. Una stringa viene convertita in un numero interpretando
+qualsiasi prefisso numerico della stringa come numero:
address@hidden"2.5"} si converte in 2.5, @code{"1e3"} si converte in 1000, e
address@hidden"25fix"} ha un valore numerico di 25.
+Le stringhe che non possono essere interpretate come numeri validi vengono
+convertite al valore zero.
+
address@hidden @code{CONVFMT}, variabile
+Il modo esatto in cui i numeri sono convertiti in stringhe @`e controllato
dalla
+variabile predefinita di @command{awk} @code{CONVFMT}
+(@pxref{Variabili predefinite}). I numeri vengono convertiti usando la
+funzione @code{sprintf()}
+con @code{CONVFMT} come specificatore di formato
+(@pxref{Funzioni per stringhe}).
+
+Il valore di default di @code{CONVFMT} @`e @code{"%.6g"}, che crea un valore
con
+un massimo di sei cifre significative. Per alcune applicazioni potrebbe essere
+opportuno cambiare questo valore per ottenere una maggiore precisione.
+Sulla maggior parte delle macchine moderne
+normalmente bastano 17 cifre per esprimere esattamente il valore di un numero
+in virgola address@hidden casi eccezionali possono essere richieste fino
+a 752 cifre (!), non sembra che sia il caso di preoccuparsene qui.}
+
address@hidden angolo buio, variabile @code{CONVFMT}
+Si possono avere strani risultati se si imposta @code{CONVFMT} a una stringa
+che non indica a @code{sprintf()} come formattare i numeri in virgola mobile
+in un modo utile. Per esempio, se ci si dimentica la @samp{%} nel formato,
address@hidden converte tutti i numeri alla stessa stringa costante.
+
+Come caso particolare, per un numero intero, il risultato della conversione
+a una stringa @`e @emph{sempre} un numero intero, indipendentemente da quale
+sia il valore di @code{CONVFMT}. Dato il seguente fammento di codice:
+
address@hidden
+CONVFMT = "%2.2f"
+a = 12
+b = a ""
address@hidden example
+
address@hidden
address@hidden ha valore @code{"12"}, non @code{"12.00"}.
address@hidden
+
address@hidden sidebar, @command{awk} prima di POSIX usava @code{OFMT} per la
conversione di stringhe
address@hidden
address@hidden
+<sidebar><title>@command{awk} prima di POSIX usava @code{OFMT} per la
conversione di stringhe</title>
address@hidden docbook
+
address@hidden POSIX @command{awk}, variabile @code{OFMT} e
address@hidden @code{OFMT}, variabile
address@hidden address@hidden, nuovo @command{awk} vs.@: vecchio @command{awk}
address@hidden @command{awk}, nuovo vs.@: vecchio, variabile @code{OFMT}
+Prima dello standard POSIX, @command{awk} usava il valore di @code{OFMT} per
+convertire i numeri in stringhe. @code{OFMT} specifica il formato di output da
+usare per la stampa dei numeri con @code{print}. @code{CONVFMT} fu introdotto
+per separare la semantica della conversione dalla semantica della stampa. Sia
address@hidden che @code{OFMT} hanno lo stesso valore di dafault:
address@hidden"%.6g"}. Nella stragrande maggioranza dei casi, i vecchi
programmi di
address@hidden non cambiano questo comportamento.
address@hidden per maggiori informazioni sull'istruzione @code{print}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @address@hidden prima di POSIX usava @code{OFMT} per la
conversione di stringhe}
+
+
address@hidden POSIX @command{awk}, variabile @code{OFMT} e
address@hidden @code{OFMT}, variabile
address@hidden address@hidden, nuovo @command{awk} vs.@: vecchio @command{awk}
address@hidden @command{awk}, nuovo vs.@: vecchio, variabile @code{OFMT}
+Prima dello standard POSIX, @command{awk} usava il valore di @code{OFMT} per
+convertire i numeri in stringhe. @code{OFMT} specifica il formato di output da
+usare per la stampa dei numeri con @code{print}. @code{CONVFMT} fu introdotto
+per separare la semantica della conversione dalla semantica della stampa. Sia
address@hidden che @code{OFMT} hanno lo stesso valore di dafault:
address@hidden"%.6g"}. Nella stragrande maggioranza dei casi, i vecchi
programmi di
address@hidden non cambiano questo comportamento.
address@hidden per maggiori informazioni sull'istruzione @code{print}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Localizzazione e conversioni
address@hidden Le localizzazioni possono influire sulle conversioni
+
+Il luogo dove si @`e address@hidden avere importanza quando si tratta di
convertire numeri e
+stringhe. La lingua e i caratteri---la @dfn{localizzazione}---possono
+influire sui formati numerici. In particolare, per i programmi @command{awk},
+influiscono sui caratteri separatore decimale e separatore delle migliaia.
+La localizzazione @code{"C"}, e la maggior parte delle localizzazioni inglesi,
+usano il punto (@samp{.}) come separatore decimale e non prevedono un
+separatore delle
+migliaia. Tuttavia, molte (se non la maggior parte) delle localizzazioni
+europee e non inglesi usano la virgola (@samp{,}) come separatore dei decimali.
+Le localizzazioni europee spesso usano o lo spazio o il punto come separatore
+delle migliaia, all'occorrenza.
+
address@hidden angolo buio, carattere di separazione dei decimali nelle
localizzazioni
+Lo standard POSIX prevede che @command{awk} usi sempre il punto come separatore
+dei decimali nel codice sorgente del programma @command{awk}, e per
+gli assegnamenti di variabile da riga di comando (@pxref{Altri argomenti}).
+Tuttavia, nell'interpretazione dei dati in input, per l'output di
address@hidden e @code{printf}, e per la conversione da numeri a stringhe,
+viene usato il
+separatore decimale locale. @value{DARKCORNER} In ogni caso, i numeri nel
+codice sorgente e nei dati di input non possono avere un separatore delle
+migliaia. Di seguito sono riportati alcuni esempi che illustrano la differenza
+di comportamento, su un sistema GNU/Linux:
+
address@hidden
+$ @kbd{export POSIXLY_CORRECT=1} @ii{Forzare aderenza a
standard POSIX}
+$ @kbd{gawk 'BEGIN @{ printf "%g\n", 3.1415927 @}'}
address@hidden 3.14159
+$ @kbd{LC_ALL=en_DK.utf-8 gawk 'BEGIN @{ printf "%g\n", 3.1415927 @}'}
address@hidden 3,14159
+$ @kbd{echo 4,321 | gawk '@{ print $1 + 1 @}'}
address@hidden 5
+$ @kbd{echo 4,321 | LC_ALL=en_DK.utf-8 gawk '@{ print $1 + 1 @}'}
address@hidden 5,321
address@hidden example
+
address@hidden
+La localizzazione @code{en_DK.utf-8} @`e per l'inglese in Danimarca, dove
+le virgole fungono da separatore decimale. Nella localizzazione @code{"C"}
+normale, @command{gawk} tratta @samp{4,321} come 4, mentre nella localizzazione
+danese @`e trattato come numero completo comprendente la parte frazionaria,
+4.321.
+
+Alcune delle prime versioni di @command{gawk} si conformavano completamente con
+quest'aspetto dello standard. Tuttavia, molti utenti di localizzazioni non
+inglesi si lamentavano di questo comportamento, perch@'e i loro dati usavano il
+punto come separatore decimale, per cui fu ripristinato il comportamento di
+default che usava il punto come carattere di separazione decimale. Si
address@hidden
+usare l'opzione @option{--use-lc-numeric} (@pxref{Opzioni}) per forzare
address@hidden a usare il carattere separatore decimale della localizzazione.
+(@command{gawk} usa il separatore decimale della localizzazione anche quando
address@hidden in address@hidden POSIX, o con l'opzione @option{--posix} o con
la variabile
+d'ambiente @env{POSIXLY_CORRECT}, come appena visto.)
+
address@hidden descrive i casi in cui si usa il separatore decimale
+locale e quando si usa il punto. Alcune di queste address@hidden non sono
state
+ancora descritte.
+
address@hidden Tabella,table-locale-affects
address@hidden decimale locale o punto}
address@hidden @columnfractions .15 .25 .45
address@hidden Funzione @tab Default @tab @option{--posix} o
@option{--use-lc-numeric}
address@hidden @code{%'g} @tab Usa la localizzazione @tab Usa la localizzazione
address@hidden @code{%g} @tab Usa il punto @tab Usa la localizzazione
address@hidden Input @tab Usa il punto @tab Usa la localizzazione
address@hidden @code{strtonum()} @tab Usa il punto @tab Usa la localizzazione
address@hidden multitable
address@hidden float
+
+Infine, gli standard ufficiali correnti e la rappresentazione dei numeri
+in virgola mobile dello standard IEEE possono avere un effetto insolito ma
+importante sul modo in cui @command{gawk} converte alcuni valori di stringa
+speciali in
+numeri. I dettagli sono illustrati in @ref{Problemi virgola mobile POSIX}.
+
address@hidden Tutti gli operatori
address@hidden Operatori: fare qualcosa coi valori
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden introduce gli @dfn{operatori} che fanno uso
+dei valori forniti da costanti e variabili.
+
address@hidden
+* Operatori aritmetici:: Operazioni aritmetiche (@samp{+}, @samp{-},
+ etc.)
+* Concatenazione:: Concatenazione di stringhe.
+* Operatori di assegnamento:: Cambiare il valore di una variabile o di un
+ campo.
+* Operatori di incremento:: Incrementare il valore numerico di una
+ variabile.
address@hidden menu
+
address@hidden Operatori aritmetici
address@hidden Operatori aritmetici
address@hidden aritmetici, operatori
address@hidden operatori aritmetici
address@hidden @cindex addition
address@hidden @cindex subtraction
address@hidden @cindex multiplication
address@hidden @cindex division
address@hidden @cindex remainder
address@hidden @cindex quotient
address@hidden @cindex exponentiation
+
+Il linguaggio @command{awk} usa i comuni operatori aritmetici nella valutazione
+delle espressioni. Tutti questi operatori aritmetici seguono le normali regole
+di precedenza e funzionano come ci si aspetta.
+
+Il seguente esempio usa un file chiamato @file{grades}, che contiene
+una lista di nomi di studenti e anche i voti di tre verifiche per ogni studente
+(@`e una piccola classe):
+
address@hidden
+Pat 100 97 58
+Sandy 84 72 93
+Chris 72 92 89
address@hidden example
+
address@hidden
+Questo programma prende il file @file{grades} e stampa la media
+dei voti:
+
address@hidden
+$ @kbd{awk '@{ sum = $2 + $3 + $4 ; avg = sum / 3}
+> @kbd{print $1, avg @}' grades}
address@hidden Pat 85
address@hidden Sandy 83
address@hidden Chris 84.3333
address@hidden example
+
+La lista seguente elenca gli operatori aritmetici in @command{awk},
+in ordine di precedenza, da quella address@hidden alta a quella address@hidden
bassa:
+
address@hidden @code
address@hidden estensioni comuni, operatore @code{**}
address@hidden POSIX @command{awk}, operatori aritmetici e
address@hidden @var{x} ^ @var{y}
address@hidden @var{x} ** @var{y}
+Elevamento a potenza; @var{x} elevato alla potenza @var{y}. @samp{2 ^ 3}
+ha il valore otto; la sequenza di caratteri @samp{**} @`e equivalente a
address@hidden @value{COMMONEXT}
+
address@hidden - @var{x}
+Negazione.
+
address@hidden + @var{x}
address@hidden unario; l'espressione @`e convertita in un numero.
+
address@hidden @var{x} * @var{y}
+Moltiplicazione.
+
address@hidden risoluzione di problemi, divisione
address@hidden problemi, risoluzione di, divisione
address@hidden divisione
address@hidden @var{x} / @var{y}
+Divisione; poich@'e tutti i numeri in @command{awk} sono numeri in virgola
+mobile, il risultato @emph{non} @`e arrotondato all'address@hidden / 4} ha il
+valore di 0.75. (Un errore comune, specialmente tra i programmatori in C, @`e
+quello di dimenticare che @emph{tutti} i numeri in @command{awk} sono in
virgola mobile,
+e che la divisione di costanti rappresentate da numeri interi produce un
+numero reale, non un numero intero.)
+
address@hidden @var{x} % @var{y}
+Resto della divisione; subito dopo questa lista, l'argomento viene
+ulteriormente dettagliato.
+
address@hidden @var{x} + @var{y}
+Addizione.
+
address@hidden @var{x} - @var{y}
+Sottrazione.
address@hidden table
+
+Il address@hidden e il meno unari hanno la stessa precedenza,
+gli operatori di moltiplicazione hanno tutti la stessa precedenza, e
+l'addizione e la sottrazione hanno la stessa precedenza.
+
address@hidden differenze tra @command{awk} e @command{gawk}, operazione di
modulo-troncamento
address@hidden modulo-troncamento, operazione di
+Quando si calcola il resto di @address@hidden % @var{y}},
+il quoziente @`e troncato all'intero e
+moltiplicato per @var{y}. Questo risultato @`e sottratto da @var{x};
+quest'operazione @`e nota anche come ``modulo''. La seguente
+relazione @`e sempre verificata:
+
address@hidden
+b * int(a / b) + (a % b) == a
address@hidden example
+
+Un possibile effetto indesiderato di questa definizione di resto @`e che
address@hidden@var{x} % @var{y}} sia negativo se @var{x} @`e negativo.
address@hidden@dotless{i}}:
+
address@hidden
+-17 % 8 = -1
address@hidden example
+
+In altre implementazioni di @command{awk} il segno del resto
address@hidden essere dipendente dalla macchina.
address@hidden FIXME !!! what does posix say?
+
address@hidden address@hidden, operatore @code{**}
address@hidden @code{*} (asterisco), operatore @code{**}
address@hidden asterisco (@code{*}), operatore @code{**}
address@hidden NOTA
+Lo standard POSIX specifica solo l'uso di @samp{^}
+per l'elevamento a potenza.
+Per garantire la massima address@hidden @`e meglio non usare l'operatore
@samp{**}.
address@hidden quotation
+
address@hidden Concatenazione
address@hidden Concatenazione di stringhe
address@hidden Kernighan, Brian
address@hidden
address@hidden ci era sembrata una buona idea.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden operatori di stringa
address@hidden stringa, operatori di
address@hidden concatenare
+C'@`e una sola operazione di stringa: la concatenazione. Non ha un operatore
+specifico per rappresentarla. Piuttosto, la concatenazione @`e effettuata
+scrivendo le espressioni l'una vicino all'altra, senza alcun operatore.
+Per esempio:
+
address@hidden
+$ @kbd{awk '@{ print "Campo numero uno: " $1 @}' mail-list}
address@hidden Campo numero uno: Amelia
address@hidden Campo numero uno: Anthony
address@hidden
address@hidden example
+
+Senza lo spazio nella costante stringa dopo @samp{:}, la riga
+rimane unita. Per esempio:
+
address@hidden
+$ @kbd{awk '@{ print "Campo numero uno:" $1 @}' mail-list}
address@hidden Campo numero uno:Amelia
address@hidden Campo numero uno:Anthony
address@hidden
address@hidden example
+
address@hidden risoluzione di problemi, concatenazione di stringhe
address@hidden problemi, risoluzione di, concatenazione di stringhe
+Poich@'e la concatenazione di stringhe non ha un operatore esplicito, @`e
spesso
+necessario assicurarsi che venga effettuata al momento giusto usando le
+parentesi per racchiudere gli elementi da concatenare. Per esempio, ci si
+potrebbe aspettare che il
+seguente fammento di codice concateni @code{nome} e @code{file}:
+
address@hidden
+nome = "nome"
+file = "file"
+print "qualcosa di significativo" > nome file
address@hidden example
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden
+Questo produce un errore di sintassi in alcune versioni di
address@hidden per address@hidden@`o capitare che BWK
address@hidden, @command{gawk} e @command{mawk} lo interpretino nel modo giusto,
+ma non ci si dovrebbe fare affidamento.}
address@hidden necessario usare la seguente sintassi:
+
address@hidden
+print "qualcosa di significativo" > (nome file)
address@hidden example
+
address@hidden ordine di valutazione, concatenazione
address@hidden valutazione, ordine di, concatenazione
address@hidden effetti collaterali
+Si dovrebbero usare le parentesi attorno alle concatenazioni in tutti i
+contesti non comuni, come, per esempio, sul lato destro di @samp{=}.
+Bisogna stare attenti
+al tipo di espressioni usate nella concatenazione di stringhe. In particolare,
+l'ordine di valutazione di espressioni usate per la concatenazione non @`e
+definita nel linguaggio @command{awk}. Si consideri quest'esempio:
+
address@hidden
+BEGIN @{
+ a = "Non"
+ print (a " " (a = "v'allarmate"))
address@hidden
address@hidden example
+
address@hidden
+Non @`e definito se il secondo assegnamento ad @code{a} debba avvenire
+prima o dopo il recupero del valore di @code{a} per produrre il
+valore concatenato. Il risultato potrebbe essere sia @samp{Non v'allarmate},
+sia @samp{v'allarmate v'allarmate}.
address@hidden see test/nasty.awk for a worse example
+
+La precedenza della concatenazione, quando @`e in combinazione con altri
+operatori, @`e spesso controintuitiva. Si consideri questo esempio:
+
address@hidden
+> To: bug-gnu-utils@@gnu.org
+> CC: arnold@@gnu.org
+> Subject: gawk 3.0.4 bug with {print -12 " " -24}
+> From: Russell Schulz <address@hidden>
+> Date: Tue, 8 Feb 2000 19:56:08 -0700
+>
+> gawk 3.0.4 on NT gives me:
+>
+> prompt> cat bad.awk
+> BEGIN { print -12 " " -24; }
+>
+> prompt> gawk -f bad.awk
+> -12-24
+>
+> when I would expect
+>
+> -12 -24
+>
+> I have not investigated the source, or other implementations. The
+> bug is there on my NT and DOS versions 2.15.6 .
address@hidden ignore
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print -12 " " -24 @}'}
address@hidden -12-24
address@hidden example
+
+Quest'esempio, ``ovviamente'' concatena @minus{}12, uno spazio, e @minus{}24.
+Ma dov'@`e finito lo spazio?
+La risposta sta nella combinazione di precedenze di operatori e nelle regole di
+conversione automatica di @command{awk}. Per ottenere il risultato desiderato,
+si deve scrivere il programma in questo modo:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print -12 " " (-24) @}'}
address@hidden -12 -24
address@hidden example
+
+Questo forza il trattamento, da parte di @command{awk}, del @samp{-} del
address@hidden come operatore unario. Altrimenti @`e analizzato in questo modo:
+
address@hidden
+ @minus{}12 (@code{"@ "} @minus{} 24)
address@hidden @minus{}12 (0 @minus{} 24)
address@hidden @minus{}12 (@minus{}24)
address@hidden @address@hidden
address@hidden display
+
+Come si @`e detto precedentemente,
+quando si usa la concatenazione insieme ad altri operatori, @`e necessario
address@hidden le parentesi}. Altrimenti, non si address@hidden essere mai
completamente
+certi di quel che si ottiene.
+
address@hidden Operatori di assegnamento
address@hidden Espressioni di assegnamento
address@hidden operatori di assegnamento
address@hidden assegnamento, operatori di
address@hidden espressioni di assegnamento
address@hidden @code{=} (uguale), operatore @code{=}
address@hidden uguale (@code{=}), operatore @code{=}
+Un @dfn{assegnamento} @`e un'espressione che memorizza un valore (generalmente
+diverso da quello che la variabile aveva in precedenza) in una variabile.
+Per esempio, si assegni il valore uno alla variabile @code{z}:
+
address@hidden
+z = 1
address@hidden example
+
+Dopo l'esecuzione di quest'espressione, la variabile @code{z} ha il valore
+uno. Qualsiasi precedente valore di @code{z} prima dell'assegnamento
+viene dimenticato.
+
+Gli assegnamenti possono anche memorizzare valori di stringa. Il seguente
+esempio memorizza
+il valore @code{"questo cibo @`e buono"} nella variabile @code{messaggio}:
+
address@hidden
+cosa = "cibo"
+predicato = "buono"
+messaggio = "questo " cosa " @`e " predicato
address@hidden example
+
address@hidden
address@hidden effetti collaterali, espressioni di assegnamento
+Quest'esempio illustra anche la concatenazione di stringhe.
+Il segno @samp{=} @`e un @dfn{operatore di assegnamento}. @`E il
address@hidden semplice
+fra gli operatori di assegnamento perch@'e il valore dell'operando di destra
address@hidden memorizzato invariato.
+La maggior parte degli operatori (addizione, concatenazione e
address@hidden@dotless{i}} via) non
+fanno altro che calcolare un valore. Se il valore non viene poi utilizzato
non c'@`e alcun
+motivo per usare l'operatore. Un operatore di assegnamento @`e differente;
+produce un valore; anche se poi non lo si usa, l'assegnamento svolge ancora
+una funzione alterando la variabile. Chiamiamo questo
+un @dfn{effetto collaterale}.
+
address@hidden @dfn{lvalue/rvalue}
address@hidden @dfn{rvalue/lvalue}
address@hidden assegnamento, operatori di, @dfn{lvalue/rvalue}
address@hidden operatori di assegnamento
+L'operando di sinistra non dev'essere necessariamente una variabile
+(@pxref{Variabili}); address@hidden essere anche un campo
+(@pxref{Cambiare i campi}) o
address@hidden
+un elemento di un vettore (@pxrefil{Vettori}).
address@hidden iftex
address@hidden
+un elemento di un vettore (@pxref{Vettori}).
address@hidden ifnottex
+Questi operandi sono chiamati @dfn{lvalue}, il
+che significa che possono apparire sul lato sinistro di un operatore di
+assegnamento. L'operando sul lato destro address@hidden essere qualsiasi
espressione;
+produce un nuovo valore che l'assegnamento memorizza nella variabile, nel campo
+o nell'elemento di vettore specificati. Tali valori sono chiamati
address@hidden
+
address@hidden variabili, tipi di
address@hidden importante notare che le variabili @emph{non} hanno dei tipi
permanenti.
+Il tipo di una variabile @`e semplicemente quello di qualsiasi valore le sia
stato
+assegnato per ultimo. Nel seguente frammento di programma, la variabile
address@hidden ha dapprima un valore numerico, e in seguito un valore di
stringa:
+
address@hidden
+pippo = 1
+print pippo
+pippo = "pluto"
+print pippo
address@hidden example
+
address@hidden
+Quando il secondo assegnamento address@hidden a @code{pippo} un valore di
stringa, il fatto
+che avesse precedentemente un valore numerico viene dimenticato.
+
+Ai valori di stringa che non iniziano con una cifra viene assegnato il valore
+numerico zero. Dopo l'esecuzione del seguente codice, il valore di
@code{pippo} @`e
+cinque:
+
address@hidden
+pippo = "una stringa"
+pippo = pippo + 5
address@hidden example
+
address@hidden NOTA
+Usare una variabile sia come numero che come stringa address@hidden originare
confusione
+e denota uno stile di programmazione scadente. I due esempi precedenti
+illustrano come funziona @command{awk}, @emph{non} come si dovrebbero scrivere
+i programmi!
address@hidden quotation
+
+Un assegnamento @`e un'espressione, per cui ha un valore: lo stesso valore che
+le @`e stato assegnato. address@hidden@dotless{i}}, @samp{z = 1} @`e
un'espressione col valore uno.
+Una conseguenza di address@hidden @`e che si possono scrivere address@hidden
assegnamenti insieme,
+come:
+
address@hidden
+x = y = z = 5
address@hidden example
+
address@hidden
+Quest'esempio memorizza il valore cinque in tutte e tre le variabili,
+(@code{x}, @code{y} e @code{z}).
+Questo perch@'e il
+valore di @samp{z = 5}, che @`e cinque, @`e memorizzato in @code{y} e poi
+il valore di @samp{y = z = 5}, che @`e cinque, @`e memorizzato in @code{x}.
+
+Gli assegnamenti possono essere usati ovunque sia prevista un'espressione. Per
+esempio, @`e valido scrivere @samp{x != (y = 1)} per impostare @code{y} a
+uno, e poi verificare se @code{x} @`e uguale a uno. address@hidden questo
stile rende i
+programmi difficili da leggere; una tale nidificazione di assegnamenti dovrebbe
+essere evitata, eccetto forse in un programma usa-e-getta.
+
address@hidden @code{+} (address@hidden), operatore @code{+=}
address@hidden address@hidden (@code{+}), operatore @code{+=}
+Accanto a @samp{=}, ci sono diversi altri operatori di assegnamento che
+eseguono calcoli col vecchio valore di una variabile. Per esempio,
+l'operatore @samp{+=} calcola un nuovo valore aggiungendo il valore sul lato
+destro al vecchio valore di una variabile. address@hidden@dotless{i}}, il
seguente assegnamento
+aggiunge cinque al valore di @code{pippo}:
+
address@hidden
+pippo += 5
address@hidden example
+
address@hidden
+Questo @`e equivalente a:
+
address@hidden
+pippo = pippo + 5
address@hidden example
+
address@hidden
+Si usi la notazione che rende address@hidden chiaro il significato del
programma.
+
+Ci sono situazioni in cui usare @samp{+=} (o qualunque operatore di
+assegnamento) @emph{non} @`e la stessa cosa che ripetere semplicemente
l'operando
+di sinistra nell'espressione di destra. Per esempio:
+
address@hidden Rankin, Pat
address@hidden
+# Grazie a Pat Rankin per quest'esempio
+BEGIN @{
+ pippo[rand()] += 5
+ for (x in pippo)
+ print x, pippo[x]
+
+ pluto[rand()] = pluto[rand()] + 5
+ for (x in pluto)
+ print x, pluto[x]
address@hidden
address@hidden example
+
address@hidden operatori di assegnamento, ordine di valutazione
address@hidden assegnamento, operatori di, ordine di valutazione
address@hidden
address@hidden praticamente certo che gli indici di @code{pluto} siano
differenti, perch@'e
address@hidden()} restituisce valori differenti ogni volta che viene chiamata.
+(I vettori e la funzione @code{rand()} non sono ancora stati trattati.
address@hidden
address@hidden,
address@hidden iftex
address@hidden
address@hidden,
address@hidden ifnottex
+e
address@hidden
address@hidden numeriche}
address@hidden ifnotdocbook
address@hidden
address@hidden numeriche}
address@hidden ifdocbook
+per maggiori informazioni.)
+Quest'esempio illustra un fatto importante riguardo agli operatori di
+assegnamento: l'espressione di sinistra viene valutata @emph{una volta sola}.
+
+Dipende dall'implementazione stabilire quale espressione valutare per
+prima, se quella di sinistra o quella di destra.
+Si consideri quest'esempio:
+
address@hidden
+i = 1
+a[i += 2] = i + 1
address@hidden example
+
address@hidden
+Il valore di @code{a[3]} potrebbe essere sia due sia quattro.
+
+La @ref{table-assign-ops} elenca gli operatori di assegnamento aritmetici. In
+ogni caso, l'operando di destra @`e un'espressione il cui valore @`e
convertito in
+un numero.
+
address@hidden @code{-} (meno), operatore @code{-=}
address@hidden meno (@code{-}), operatore @code{-=}
address@hidden @code{*} (asterisco), operatore @code{*=}
address@hidden asterisco (@code{*}), operatore @code{*=}
address@hidden @code{/} (barra), operatore @code{/=}
address@hidden barra (@code{/}), operatore @code{/=}
address@hidden @code{%} (percento), operatore @code{%=}
address@hidden percento (@code{%}), operatore @code{%=}
address@hidden @code{^} (circonflesso), operatore @code{^=}
address@hidden circonflesso (@code{^}), operatore @code{^=}
address@hidden @code{*} (asterisco), operatore @code{**=}
address@hidden asterisco (@code{*}), operatore @code{**=}
address@hidden Tabella,table-assign-ops
address@hidden di assegnamento aritmetici}
address@hidden @columnfractions .30 .70
address@hidden Operatore @tab Effetto
address@hidden @var{lvalue} @code{+=} @var{incremento} @tab Aggiunge
@var{incremento} al valore di @var{lvalue}.
address@hidden @var{lvalue} @code{-=} @var{decremento} @tab Sottrae
@var{decremento} dal valore di @var{lvalue}.
address@hidden @var{lvalue} @code{*=} @var{coefficiente} @tab Moltiplica il
valore di @var{lvalue} per @var{coefficiente}.
address@hidden @var{lvalue} @code{/=} @var{divisore} @tab Divide il valore di
@var{lvalue} per @var{divisore}.
address@hidden @var{lvalue} @code{%=} @var{modulo} @tab Imposta @var{lvalue} al
resto della sua divisione per @var{modulo}.
address@hidden estensioni comuni, operatore @code{**=}
address@hidden estensioni address@hidden operatore @code{**=}
address@hidden @command{awk}, linguaggio, versione POSIX
address@hidden POSIX @command{awk}
address@hidden @var{lvalue} @code{^=} @var{esponente} @tab Eleva @var{lvalue}
alla potenza @var{esponente}.
address@hidden @var{lvalue} @code{**=} @var{esponente} @tab Eleva @var{lvalue}
alla potenza @var{esponente}. @value{COMMONEXT}
address@hidden multitable
address@hidden float
+
address@hidden POSIX @command{awk}, operatore @code{**=} e
address@hidden address@hidden, operatore @code{**=}
address@hidden NOTA
+Soltanto l'operatore @samp{^=} @`e definito da POSIX.
+Per avere la massima address@hidden, non usare l'operatore @samp{**=}.
address@hidden quotation
+
address@hidden sidebar, address@hidden sintattiche tra @samp{/=} e le
espressioni regolari
address@hidden
address@hidden
+<sidebar><title>address@hidden sintattiche tra @samp{/=} e le espressioni
regolari</title>
address@hidden docbook
+
address@hidden angolo buio, costanti @dfn{regexp}, operatore @code{/=} e
address@hidden @code{/} (barra), operatore @code{/=}, vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden barra (@code{/}), operatore @code{/=}, vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden @dfn{regexp}, costanti, @code{/address@hidden/}, operatore
@code{/=} e
+
address@hidden derived from email from "Nelson H. F. Beebe" <address@hidden>
address@hidden Date: Mon, 1 Sep 1997 13:38:35 -0600 (MDT)
+
address@hidden angolo buio, operatore @code{/=} vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden address@hidden sintattica: operatore @code{/=} vs. costante
@dfn{regexp} @code{/address@hidden/}
address@hidden sintattica, address@hidden: operatore @code{/=} vs. costante
@dfn{regexp} @code{/address@hidden/}
address@hidden @code{/=}, operatore, vs. costante @dfn{regexp}
@code{/address@hidden/}
+C'@`e un'address@hidden sintattica tra l'operatore di assegnamento @code{/=}
+e le costanti @dfn{regexp} il cui primo carattere sia @samp{=}.
address@hidden
+Questo @`e address@hidden evidente in alcune versioni commerciali di
@command{awk}.
+Per esempio:
+
address@hidden
+$ @kbd{awk /==/ /dev/null}
address@hidden awk: syntax error at source line 1
address@hidden context is
address@hidden >>> /= <<<
address@hidden awk: bailing out at source line 1
address@hidden example
+
address@hidden
+Un espediente @`e:
+
address@hidden
+awk '/[=]=/' /dev/null
address@hidden example
+
address@hidden non ha questo problema, e neppure lo hanno BWK @command{awk}
+e @command{mawk}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @address@hidden sintattiche tra @samp{/=} e le espressioni
regolari}
+
+
address@hidden angolo buio, costanti @dfn{regexp}, operatore @code{/=} e
address@hidden @code{/} (barra), operatore @code{/=}, vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden barra (@code{/}), operatore @code{/=}, vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden @dfn{regexp}, costanti, @code{/address@hidden/}, operatore
@code{/=} e
+
address@hidden derived from email from "Nelson H. F. Beebe" <address@hidden>
address@hidden Date: Mon, 1 Sep 1997 13:38:35 -0600 (MDT)
+
address@hidden angolo buio, operatore @code{/=} vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden address@hidden sintattica: operatore @code{/=} vs. costante
@dfn{regexp} @code{/address@hidden/}
address@hidden sintattica, address@hidden: operatore @code{/=} vs. costante
@dfn{regexp} @code{/address@hidden/}
address@hidden @code{/=}, operatore, vs. costante @dfn{regexp}
@code{/address@hidden/}
+C'@`e un'address@hidden sintattica tra l'operatore di assegnamento @code{/=}
+e le costanti @dfn{regexp} il cui primo carattere sia @samp{=}.
address@hidden
+Questo @`e address@hidden evidente in alcune versioni commerciali di
@command{awk}.
+Per esempio:
+
address@hidden
+$ @kbd{awk /==/ /dev/null}
address@hidden awk: syntax error at source line 1
address@hidden context is
address@hidden >>> /= <<<
address@hidden awk: bailing out at source line 1
address@hidden example
+
address@hidden
+Un espediente @`e:
+
address@hidden
+awk '/[=]=/' /dev/null
address@hidden example
+
address@hidden non ha questo problema, e neppure lo hanno BWK @command{awk}
+e @command{mawk}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Operatori di incremento
address@hidden Operatori di incremento e di decremento
+
address@hidden incremento, operatori di
address@hidden operatori di decremento/incremento
+Gli @dfn{operatori di incremento} e @dfn{decremento} incrementano o riducono il
+valore di una variabile di uno. Un operatore di assegnamento address@hidden
fare la
+stessa cosa, per cui gli operatori di incremento non aggiungono address@hidden
+al inguaggio @command{awk}; in ogni caso, sono delle convenienti abbreviazioni
+per operazioni molto comuni.
+
address@hidden effetti collaterali
address@hidden @code{+} (address@hidden), operatore @code{++}
address@hidden address@hidden (@code{+}), operatore @code{++}
address@hidden effetti collaterali, operatori di decremento/incremento
+L'operatore per aggiungere uno @`e @samp{++}. address@hidden essere usato per
incrementare
+una variabile prima o dopo aver stabilito il suo valore. Per
@dfn{preincrementare}
+una variabile @code{v}, si scrive @samp{++v}. Questo aggiunge uno al valore di
address@hidden; questo nuovo valore @`e anche il valore dell'espressione.
+(L'espressione di assegnamento @samp{v += 1} @`e totalmente equivalente.)
+Scrivendo @samp{++} dopo la variabile si specifica un @dfn{postincremento}.
+Questo incrementa il valore della variabile nello stesso modo; la differenza
@`e
+che il valore dell'espressione d'incremento @`e il @emph{vecchio} valore della
+variabile. address@hidden@dotless{i}}, se @code{pippo} ha il valore quattro,
l'espressione
address@hidden ha il valore quattro, ma cambia il valore di @code{pippo} in
cinque.
+In altre parole, l'operatore restituisce il vecchio valore della variabile, ma
+con l'effetto collaterale di incrementarlo.
+
+Il postincremento @samp{pippo++} @`e quasi come scrivere @samp{(pippo += 1) -
1}.
+Non @`e perfettamente equivalente perch@'e tutti i numeri in @command{awk}
sono in
+virgola mobile. In virgola mobile, @samp{pippo + 1 - 1} non @`e
necessariamente
+uguale a @code{pippo}, ma la differenza @`e molto piccola finch@'e si ha a che
+fare con numeri relativamente piccoli (inferiori a
address@hidden
address@hidden).
address@hidden iftex
address@hidden
+10e12).
address@hidden ifinfo
address@hidden
address@hidden
address@hidden).
address@hidden ifnotinfo
address@hidden ifnottex
+
address@hidden @code{$} (dollaro), incrementare campi e vettori
address@hidden dollaro (@code{$}), incrementare campi e vettori
+I campi di un record e gli elementi di un vettore vengono incrementati
+proprio come le
+variabili. (Si deve usare @samp{$(i++)} quando si deve fare un riferimento a
+un campo e incrementare una variabile allo stesso tempo. Le parentesi sono
+necessarie a causa della precedenza dell'operatore di riferimento @samp{$}.)
+
address@hidden decremento, operatori di
+L'operatore di decremento @samp{--} funziona proprio come @samp{++}, solo che
+sottrae uno anzich@'e aggiungerlo. Come @samp{++}, si address@hidden usare
prima di
address@hidden
+per predecrementare o dopo per postdecrementare.
+Quel che segue @`e un sommario delle espressioni di incremento e di
+decremento:
+
address@hidden @code
address@hidden @code{+} (address@hidden), operatore @code{++}
address@hidden address@hidden (@code{+}), operatore @code{++}
address@hidden address@hidden
+Incrementa @var{lvalue}, restituendo il nuovo valore come
+valore dell'espressione.
+
address@hidden @var{lvalue}++
+Incrementa @var{lvalue}, restituendo il @emph{vecchio} valore di @var{lvalue}
+come valore dell'espressione.
+
address@hidden @code{-} (meno), operatore @code{--}
address@hidden meno (@code{-}), operatore @code{--}
address@hidden address@hidden
+Decrementa @var{lvalue}, restituendo il nuovo valore come
+valore dell'espressione.
+(Quest'espressione @`e come
address@hidden@var{lvalue}}, ma invece di aggiungere, sottrae.)
+
address@hidden @var{lvalue}--
+Decrementa @var{lvalue}, restituendo il @emph{vecchio} valore di @var{lvalue}
+come valore dell'espressione.
+(Quest'espressione @`e come
address@hidden@var{lvalue}++}, ma invece di aggiungere, sottrae.)
address@hidden table
+
address@hidden sidebar, Ordine di valutazione degli operatori
address@hidden
address@hidden
+<sidebar><title>Ordine di valutazione degli operatori</title>
address@hidden docbook
+
address@hidden precedenza
address@hidden operatori, precedenza
address@hidden address@hidden, operatori
address@hidden valutazione, ordine di
address@hidden Marx, Groucho
address@hidden
address@hidden, quando faccio address@hidden@dotless{i}} mi fa address@hidden
+E allora non farlo!}
address@hidden Groucho Marx
address@hidden quotation
+
address@hidden
+Che cosa succede con qualcosa come questo?
+
address@hidden
+b = 6
+print b += b++
address@hidden example
+
address@hidden
+O con qualcosa di address@hidden strano ancora?
+
address@hidden
+b = 6
+b += ++b + b++
+print b
address@hidden example
+
address@hidden effetti collaterali
+In altre parole, quando hanno effetto i vari effetti collaterali previsti
+dagli operatori col suffisso (@samp{b++})? Quando gli effetti collaterali
+si verificano @`e @dfn{definito dall'implementazione}.
+Per dirla diversamente, questo @`e compito di ogni specifica versione di
address@hidden Il risultato del primo esempio address@hidden essere 12 o 13, e
del
+secondo address@hidden essere 22 o 23.
+
+In breve, @`e sconsigliato fare cose come questa e, in ogni caso,
+ogni cosa che possa incidere sulla address@hidden
+Si dovrebbero evitare cose come queste nei programmi.
address@hidden You'll sleep better at night and be able to look at yourself
address@hidden in the mirror in the morning.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Ordine di valutazione degli operatori}
+
+
address@hidden precedenza
address@hidden operatori, precedenza
address@hidden address@hidden, operatori
address@hidden valutazione, ordine di
address@hidden Marx, Groucho
address@hidden
address@hidden, quando faccio address@hidden@dotless{i}} mi fa address@hidden
+E allora non farlo!}
address@hidden Groucho Marx
address@hidden quotation
+
address@hidden
+Che cosa succede con qualcosa come questo?
+
address@hidden
+b = 6
+print b += b++
address@hidden example
+
address@hidden
+O con qualcosa di address@hidden strano ancora?
+
address@hidden
+b = 6
+b += ++b + b++
+print b
address@hidden example
+
address@hidden effetti collaterali
+In altre parole, quando hanno effetto i vari effetti collaterali previsti
+dagli operatori col suffisso (@samp{b++})? Quando gli effetti collaterali
+si verificano @`e @dfn{definito dall'implementazione}.
+Per dirla diversamente, questo @`e compito di ogni specifica versione di
address@hidden Il risultato del primo esempio address@hidden essere 12 o 13, e
del
+secondo address@hidden essere 22 o 23.
+
+In breve, @`e sconsigliato fare cose come questa e, in ogni caso,
+ogni cosa che possa incidere sulla address@hidden
+Si dovrebbero evitare cose come queste nei programmi.
address@hidden You'll sleep better at night and be able to look at yourself
address@hidden in the mirror in the morning.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Valori e condizioni di address@hidden
address@hidden Valori e condizioni di address@hidden
+
+In certi contesti, i valori delle espressioni servono anche come
+``valori di address@hidden''; address@hidden, determinano quale address@hidden
la direzione che il
+programma address@hidden durante la sua esecuzione. Questa
address@hidden descrive come @command{awk} definisce ``vero'' e ``falso''
+e come questi valori sono confrontati.
+
address@hidden
+* Valori di address@hidden:: Cos'@`e ``vero'' e cos'@`e ``falso''.
+* Tipi di variabile e confronti:: Come alle variabili si assegna il tipo e
+ l'effetto che questo ha sul confronto di
+ numeri e stringhe con @samp{<}, etc.
+* Operatori booleani:: Combinare espressioni di confronto usando
+ operatori booleani @samp{||} (``or''),
+ @samp{&&} (``and'') e @samp{!} (``not'').
+* Espressioni condizionali:: Le espressioni condizionali scelgono una fra
+ due sottoespressioni, a seconda del valore di
+ una terza sottoespressione.
address@hidden menu
+
address@hidden Valori di address@hidden
address@hidden Vero e falso in @command{awk}
address@hidden valori di address@hidden
address@hidden logico, valore, vero/falso
address@hidden falso, valore logico (zero o stringa nulla)
address@hidden vero, valore logico (diverso da zero e da stringa nulla)
+
address@hidden nulle, stringhe
+Molti linguaggi di programmazione hanno una particolare rappresentazione per i
+concetti di ``vero'' e ``falso.'' Questi linguaggi usano normalmente le
+costanti speciali @code{true} e @code{false}, o forse i loro equivalenti
+maiuscoli.
address@hidden @command{awk} @`e differente.
+Prende in prestito un concetto molto semplice di vero e falso dal linguaggio
+C. In @command{awk}, ogni valore numerico diverso da zero @emph{oppure}
+ogni valore di stringa non vuota @`e vero. Ogni altro valore (zero o la
stringa
+nulla, @code{""}) @`e falso. Il seguente programma stampa @samp{Uno strano
+valore di address@hidden tre volte:
+
address@hidden
+BEGIN @{
+ if (3.1415927)
+ print "Uno strano valore di address@hidden"
+ if ("Ottanta e sette anni or sono")
+ print "Uno strano valore di address@hidden"
+ if (j = 57)
+ print "Uno strano valore di address@hidden"
address@hidden
address@hidden example
+
address@hidden angolo buio, @code{"0"} @`e effettivamente vero
+C'@`e una conseguenza sorprendente della regola ``non zero o non nullo'':
+la costante di stringa @code{"0"} sta effettivamente per vero, perch@'e
address@hidden non nulla.
address@hidden
+
address@hidden Tipi di variabile e confronti
address@hidden Tipi di variabile ed espressioni di confronto
address@hidden
address@hidden Guida galattica @`e infallibile. @`E la address@hidden, spesso,
a essere inesatta.}
address@hidden Douglas Adams, @cite{Guida galattica per autostoppisti}
address@hidden quotation
address@hidden 2/2015: Antonio Colombo points out that this is really from
address@hidden The Restaurant at the End of the Universe. But I'm going to
address@hidden leave it alone.
+
address@hidden confronto, espressioni di
address@hidden espressioni di confronto
address@hidden espressioni, ricerca di corrispondenze, si veda espressioni di
confronto
address@hidden individuazione, espressioni di, si veda espressioni di confronto
address@hidden relazionali, operatori, si veda espressioni di confronto
address@hidden operatori relazionali, si veda espressioni di confronto
address@hidden variabile, tipi di
address@hidden variabili, tipi di, espressioni di confronto e
+Diversamente che in altri linguaggi di programmazione, le variabili di
address@hidden non hanno un tipo fisso. Possono essere sia un numero che una
+stringa, a seconda del valore loro assegnato.
+Vediamo ora come viene assegnato il tipo a una variabile, e come @command{awk}
+le confronta.
+
address@hidden
+* Tipi di variabile:: Tipo stringa rispetto a tipo numero.
+* Operatori di confronto:: Gli operatori di confronto.
+* Confronto POSIX di stringhe:: Confronto tra stringhe usando le
+ regole POSIX.
address@hidden menu
+
address@hidden Tipi di variabile
address@hidden Tipo stringa rispetto a tipo numero
+
+Per gli elementi scalari in @command{awk} (variabili, elementi di
+vettore e campi), il tipo degli stessi viene attribuito @emph{dinamicamente}.
address@hidden significa che il tipo di un elemento address@hidden cambiare nel
corso
+dell'esecuzione di un programma, da @dfn{untyped} (non ancora tipizzata),
+valore assunto prima che la variabile sia utilizzata,@address@hidden
+chiama queste variabili @dfn{unassigned} (non ancora assegnate), come si
+vede dall'esempio che segue.} a stringa oppure a numero, e in seguito
+da stringa a numero o da numero a stringa, nel prosieguo del programma.
+(@command{gawk} prevede anche degli scalari di tipo @dfn{regexp}, ma
+per ora possiamo ignorarli;
address@hidden @dfn{regexp} forti}.)
+
+Non si address@hidden fare molto riguardo alle variabili di tipo @dfn{untyped},
+oltre a constatare che ancora non @`e stato loro attribuito un tipo.
+Il seguente programma confronta la variabile @code{a} con i valori
address@hidden""} e @code{0}; il confronto address@hidden esito positivo se alla
+variabile @code{a} non @`e mai stato assegnato un valore.
+L'esempio usa la funzione predefinita @code{typeof()}
+(non ancora trattata; @pxref{Funzioni per i tipi}) per
+visualizzare il tipo della variabile @code{a}:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print (a == "" && a == 0 ?}
+> @kbd{"a non ha un tipo" : "a ha un tipo!") ; print typeof(a) @}'}
address@hidden a non ha un tipo
address@hidden unassigned
address@hidden example
+
+Una variabile scalare diviene di tipo numerico quando le viene assegnato un
+valore numerico, per mezzo di una costante numerica, o tramite un'altra
+variabile scalare di tipo numerico:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ a = 42 ; print typeof(a)}
+> @kbd{b = a ; print typeof(b) @}'}
+number
+number
address@hidden example
+
+Analogamente, una variabile scalare diviene di tipo stringa quando le
+viene assegnato come valore una stringa, per mezzo di una costante stringa,
+o tramite un'altra variabile scalare di tipo stringa:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ a = "quarantadue" ; print typeof(a)}
+> @kbd{b = a ; print typeof(b) @}'}
+string
+string
address@hidden example
+
+Fin qui, tutto semplice e chiaro. Cosa succede, address@hidden, quando
address@hidden deve trattare dati forniti dall'utente?
+Il primo caso da considerare @`e quello dei campi di dati in input.
+Quale dovrebbe essere l'output del seguente programma?
+
address@hidden
+echo ciao | awk '@{ printf("%s %s < 42\n", $1,
+ ($1 < 42 ? "@`e" : "non @`e")) @}'
address@hidden example
+
address@hidden
+Poich@'e @samp{ciao} @`e un dato di tipo alfabetico, @command{awk}
address@hidden solo
+effettuare un confronto di tipo stringa. Internamente, il numero @code{42}
+viene convertito in @code{"42"} e vengono confrontate le due stringhe di
+valore @code{"ciao"} e @code{"42"}. Questo @`e il risultato:
+
address@hidden
+$ @kbd{echo ciao | awk '@{ printf("%s %s < 42\n", $1,}
+> @kbd{ ($1 < 42 ? "@`e" : "non @`e")) @}'}
address@hidden ciao non @`e < 42
address@hidden example
+
+Tuttavia, cosa succede quando un dato utente @emph{assomiglia} a un
+numero?
+Da un lato, in address@hidden, il dato in input @`e formato da alcuni
caratteri, non da
+valori numerici in formato binario. Ma, d'altro lato, il dato sembra
+numerico, e @command{awk} dovrebbe davvero trattarlo come tale. E in effetti
+questo @`e address@hidden che avviene:
+
address@hidden
+$ @kbd{echo 37 | awk '@{ printf("%s %s < 42\n", $1,}
+> @kbd{ ($1 < 42 ? "@`e" : "non @`e")) @}'}
address@hidden 37 is < 42
address@hidden example
+
+Queste sono le regole seguite per determinare quando @command{awk}
+tratta dei dati in input come numeri, e quando li considera stringhe.
+
address@hidden numeriche, stringhe
address@hidden stringhe, numeriche
address@hidden POSIX @command{awk}, stringhe numeriche e
+Lo standard POSIX usa il concetto di @dfn{stringa numerica}, per dei dati
+in input che appaiono essere numerici. Il @samp{37} nell'esempio precedente
address@hidden una stringa numerica. Quindi, qual @`e il tipo di una stringa
numerica?
+Risposta: numerico.
+
+Il tipo di una variabile @`e importante perch@'e il tipo di due variabili
+determina il modo con cui le stesse vengono confrontate.
+La determinazione del tipo di variabile segue queste regole:
+
address@hidden @value{BULLET}
address@hidden
+Una costante numerica o il risultato di un'operazione numerica ha l'attributo
address@hidden
+
address@hidden
+Una costante di stringa o il risultato di un'operazione di stringa ha
+l'attributo @dfn{string}.
+
address@hidden
+Campi, input tramite @code{getline}, @code{FILENAME}, elementi di
address@hidden, elementi di @code{ENVIRON}, e gli elementi di un vettore
+creato da @code{match()}, @code{split()} e @code{patsplit()} che sono
+stringhe numeriche hanno l'attributo @address@hidden, una
+stringa numerica POSIX e una variabile tipo @dfn{strnum} di @command{gawk}
+sono equivalenti.}
+Altrimenti, hanno l'attributo @dfn{string}.
+Anche le variabili non inizializzate hanno l'attributo @var{strnum}.
+
address@hidden
+Gli attributi si trasmettono attraverso gli assegnamenti ma non vengono
+cambiati da nessun uso.
address@hidden (Although a use may cause the entity to acquire an additional
address@hidden value such that it has both a numeric and string value, this
leaves the
address@hidden attribute unchanged.)
address@hidden This is important but not relevant
address@hidden itemize
+
+L'ultima regola @`e particolarmente importante. Nel seguente programma,
address@hidden @`e di tipo numerico, anche se viene usata in un secondo momento
in
+un'operazione di stringa:
+
address@hidden
+BEGIN @{
+ a = 12.345
+ b = a " @`e un numero carino"
+ print b
address@hidden
address@hidden example
+
+Quando si confrontano due operandi, address@hidden essere usata sia il
confronto come
+stringa che il confronto numerico, a seconda degli attributi degli operandi,
+secondo questa matrice simmetrica:
+
address@hidden thanks to Karl Berry, address@hidden, for major help with TeX
tables
address@hidden
+\centerline{
+\vbox{\bigskip % space above the table (about 1 linespace)
+% Because we have vertical rules, we can't let TeX insert interline space
+% in its usual way.
+\offinterlineskip
+%
+% Define the table template. & separates columns, and \cr ends the
+% template (and each row). # is replaced by the text of that entry on
+% each row. The template for the first column breaks down like this:
+% \strut -- a way to make each line have the height and depth
+% of a normal line of type, since we turned off interline spacing.
+% \hfil -- infinite glue; has the effect of right-justifying in this case.
+% # -- replaced by the text (for instance, `STRNUM', in the last row).
+% \quad -- about the width of an `M'. Just separates the columns.
+%
+% The second column (\vrule#) is what generates the vertical rule that
+% spans table rows.
+%
+% The doubled && before the next entry means `repeat the following
+% template as many times as necessary on each line' -- in our case, twice.
+%
+% The template itself, \quad#\hfil, left-justifies with a little space before.
+%
+\halign{\strut\hfil#\quad&\vrule#&&\quad#\hfil\cr
+ &&STRING &NUMERIC &STRNUM\cr
+% The \omit tells TeX to skip inserting the template for this column on
+% this particular row. In this case, we only want a little extra space
+% to separate the heading row from the rule below it. the depth 2pt --
+% `\vrule depth 2pt' is that little space.
+\omit &depth 2pt\cr
+% This is the horizontal rule below the heading. Since it has nothing to
+% do with the columns of the table, we use \noalign to get it in there.
+\noalign{\hrule}
+% Like above, this time a little more space.
+\omit &depth 4pt\cr
+% The remaining rows have nothing special about them.
+STRING &&string &string &string\cr
+NUMERIC &&string &numeric &numeric\cr
+STRNUM &&string &numeric &numeric\cr
+}}}
address@hidden tex
address@hidden
address@hidden
address@hidden
+ +----------------------------------------------
+ | STRING NUMERIC STRNUM
+--------+----------------------------------------------
+ |
+STRING | string string string
+ |
+NUMERIC | string numeric numeric
+ |
+STRNUM | string numeric numeric
+--------+----------------------------------------------
address@hidden verbatim
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<informaltable>
+<tgroup cols="4">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<colspec colname="3" align="left"/>
+<colspec colname="4" align="left"/>
+<thead>
+<row>
+<entry/>
+<entry>STRING</entry>
+<entry>NUMERIC</entry>
+<entry>STRNUM</entry>
+</row>
+</thead>
+
+<tbody>
+<row>
+<entry><emphasis role="bold">STRING</emphasis></entry>
+<entry>string</entry>
+<entry>string</entry>
+<entry>string</entry>
+</row>
+
+<row>
+<entry><emphasis role="bold">NUMERIC</emphasis></entry>
+<entry>string</entry>
+<entry>numeric</entry>
+<entry>numeric</entry>
+</row>
+
+<row>
+<entry><emphasis role="bold">STRNUM</emphasis></entry>
+<entry>string</entry>
+<entry>numeric</entry>
+<entry>numeric</entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
+L'idea di base @`e che l'input dell'utente che appare come numerico---e
address@hidden l'input dell'utente---dovrebbe essere trattato come numerico,
anche
+se in address@hidden @`e un insieme di caratteri e quindi anche una stringa.
address@hidden@dotless{i}}, ad esempio, la costante di stringa @address@hidden"
+3.14"}},
+quando appare nel codice sorgente di un programma,
address@hidden una stringa---anche se sembra numerica---e non
+viene @emph{mai} trattato come numero
+ai fini di un confronto.
+
+In breve, quando un operando @`e una stringa ``pura'', come una costante di
+stringa, viene effettuato un confronto di stringa. In caso contrario viene
+effettuato un confronto numerico.
+(La differenza principale tra un numero e uno @dfn{strnum} @`e che per gli
address@hidden @command{gawk} conserva anche il valore originale della stringa
+che la variabile scalare aveva al momento in cui @`e stata letta.
+
+Questo punto merita di essere ulteriormente ribadito:
+l'input che appare essere un numero @address@hidden numerico.
+Tutto il resto dell'input @`e considerato essere una stringa.
+
address@hidden@dotless{i}}, la stringa in input di sei caratteri
@address@hidden +3.14}}
+riceve l'attributo @dfn{strnum}. Al contrario, la stringa di sei caratteri
address@hidden@code{" +3.14"}} che compaia nel testo di un programma rimane una
+costante di stringa. I seguenti esempi stampano @samp{1} quando il confronto
+fra due diverse costanti @`e vero, altrimenti stampano @samp{0}:
+
address@hidden 22.9.2014: Tested with mawk and BWK awk, got same results.
address@hidden
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == " +3.14") @}'} @ii{Vero}
address@hidden 1
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == "+3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == "3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == 3.14) @}'} @ii{Vero}
address@hidden 1
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == " +3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == "+3.14") @}'} @ii{Vero}
address@hidden 1
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == "3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == 3.14) @}'} @ii{Vero}
address@hidden 1
address@hidden example
+
+Per controllare il tipo di un campo in input (o di altro input immesso
+dall'utente, si address@hidden usare @code{typeof()}:
+
address@hidden
+$ @kbd{echo salve 37 | gawk '@{ print typeof($1), typeof($2) @}'}
address@hidden string strnum
address@hidden example
+
address@hidden Operatori di confronto
address@hidden Operatori di confronto
+
+Le @dfn{espressioni di confronto} confrontano stringhe o numeri per metterli in
+relazione tra di loro, come ad esempio nella relazione di uguaglianza. Sono
+scritte usando @dfn{operatori di relazione}, che sono un superinsieme di quelli
+in C. Sono descritti nella @ref{table-relational-ops}.
+
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<}
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<=}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>=}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>}
address@hidden @code{=} (uguale), operatore @code{==}
address@hidden uguale (@code{=}), operatore @code{==}
address@hidden @code{!} (punto esclamativo), operatore @code{!=}
address@hidden punto esclamativo (@code{!}), operatore @code{!=}
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @code{in}, operatore
address@hidden Tabella,table-relational-ops
address@hidden di relazione}
address@hidden @columnfractions .23 .77
address@hidden Espressione @tab Risultato
address@hidden @var{x} @code{<} @var{y} @tab Vero se @var{x} @`e minore di
@var{y}
address@hidden @var{x} @code{<=} @var{y} @tab Vero se @var{x} @`e minore o
uguale a @var{y}
address@hidden @var{x} @code{>} @var{y} @tab Vero se @var{x} @`e maggiore di
@var{y}
address@hidden @var{x} @code{>=} @var{y} @tab Vero se @var{x} @`e maggiore o
uguale a @var{y}
address@hidden @var{x} @code{==} @var{y} @tab Vero se @var{x} @`e uguale a
@var{y}
address@hidden @var{x} @code{!=} @var{y} @tab Vero se @var{x} @`e diverso da
@var{y}
address@hidden @var{x} @code{~} @var{y} @tab Vero se la stringa @var{x}
corrisponde alla @dfn{regexp} rappresentata da @var{y}
address@hidden @var{x} @code{!~} @var{y} @tab Vero se la stringa @var{x} non
corrisponde alla @dfn{regexp} rappresentata da @var{y}
address@hidden @var{indice} @code{in} @var{vettore} @tab Vero se il vettore
@var{vettore} ha un elemento con indice @var{indice}
address@hidden multitable
address@hidden float
+
+Le espressioni di confronto valgono uno se sono vere e zero se false.
+Quando si confrontano operandi di tipi diversi, gli operandi numerici sono
+convertiti in stringhe usando il valore di @code{CONVFMT}
+(@pxref{Conversione}).
+
+Il confronto tra stringhe avviene
+confrontando il primo carattere di ciascuna stringa, poi il secondo carattere,
+e address@hidden@dotless{i}} via. Quindi, @code{"10"} @`e minore di
@code{"9"}. Se vi sono due
+stringhe di cui una @`e il prefisso dell'altra, la stringa address@hidden
corta @`e minore di
+quella address@hidden lunga. address@hidden@dotless{i}}, @code{"abc"} @`e
minore di @code{"abcd"}.
+
address@hidden risoluzione di problemi, operatore @code{==}
address@hidden problemi, risoluzione di, operatore @code{==}
address@hidden molto facile sbagliarsi scrivendo l'operatore @samp{==} e
+omettendo uno dei due caratteri @samp{=}. Il risultato @`e sempre un codice
address@hidden valido, ma il programma non fa quel che si voleva:
+
address@hidden
+if (a = b) # oops! dovrebbe essere == b
+ @dots{}
+else
+ @dots{}
address@hidden example
+
address@hidden
+A meno che @code{b} non sia zero o la stringa nulla, la parte @code{if}
+del test ha sempre successo. Poich@'e gli operatori sono molto simili,
+questo tipo di errore @`e molto difficile da individuare
+rileggendo il codice sorgente.
+
+Il seguente elenco di espressioni illustra il tipo di confronti
+che @command{awk} effettua e il risultato di ciascun confronto:
+
address@hidden @code
address@hidden 1.5 <= 2.0
+Confronto numerico (vero)
+
address@hidden "abc" >= "xyz"
+Confronto tra stringhe (falso)
+
address@hidden 1.5 != " +2"
+Confronto tra stringhe (vero)
+
address@hidden "1e2" < "3"
+Confronto tra stringhe (vero)
+
address@hidden a = 2; b = "2"
address@hidden a == b
+Confronto tra stringhe (vero)
+
address@hidden a = 2; b = " +2"
address@hidden a == b
+Confronto tra stringhe (falso)
address@hidden table
+
+In quest'esempio:
+
address@hidden
+$ @kbd{echo 1e2 3 | awk '@{ print ($1 < $2) ? "vero" : "falso" @}'}
address@hidden falso
address@hidden example
+
address@hidden espressioni di confronto, stringa vs.@: @dfn{regexp}
address@hidden @cindex string comparison vs.@: regexp comparison
address@hidden @cindex regexp comparison vs.@: string comparison
address@hidden
+il risultato @`e @samp{falso} perch@'e sia @code{$1} che @code{$2}
+sono immessi dall'utente. Sono stringhe numeriche---quindi hanno entrambe
+l'attributo @dfn{strnum}, che richiede un confronto di tipo numerico.
+Lo scopo delle regole di confronto e dell'uso di stringhe numeriche @`e quello
+di cercare di produrre il comportamento "meno inaspettato possibile",
+pur "facendo la cosa giusta".
+
+I confronti di stringhe e i confronti di espressioni regolari sono molto
+diversi. Per esempio:
+
address@hidden
+x == "att"
address@hidden example
+
address@hidden
+ha il valore uno, ossia @`e vero, se la variabile @code{x}
address@hidden precisamente @samp{att}. Al contrario:
+
address@hidden
+x ~ /att/
address@hidden example
+
address@hidden
+ha il valore uno se @code{x} contiene @samp{att}, come
address@hidden"Oh, che matto che sono!"}.
+
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
+L'operando di destra degli operatori @samp{~} e @samp{!~} address@hidden
essere sia una
+costante @dfn{regexp} (@code{/address@hidden@code{/}) che un'espressione
ordinaria.
+In quest'ultimo caso, il valore dell'espressione come stringa @`e usato come
una
address@hidden dinamica (@pxref{Uso di @dfn{regexp}}; e
address@hidden regolari calcolate}).
+
address@hidden @command{awk}, costanti @dfn{regexp} e
address@hidden costanti @dfn{regexp}
address@hidden @dfn{regexp}, costanti
+Un'espressione regolare costante tra due barre @`e di per s@'e anche
+un'espressione. @code{/@var{regexp}/} @`e un'abbreviazione per la seguente
+espressione di confronto:
+
address@hidden
+$0 ~ /@var{regexp}/
address@hidden example
+
+Una particolare posizione dove @code{/pippo/} @emph{non} @`e un'abbreviazione
di
address@hidden ~ /pippo/} @`e quella in cui @`e l'operando di destra di
@samp{~} o
address@hidden
address@hidden le costanti @dfn{regexp}},
+dove questo punto @`e trattato in maggiore dettaglio.
+
address@hidden Confronto POSIX di stringhe
address@hidden Confronto tra stringhe usando l'ordine di collazione locale
+
+Lo standard POSIX diceva che il confronto di stringhe viene effettuato secondo
+l'@dfn{ordine di collazione} locale. Questo @`e l'ordine secondo il quale sono
+disposti i caratteri, come definito dalla localizzazione (per una trattazione
address@hidden dettagliata, @pxref{Localizzazioni}). Quest'ordine normalmente
@`e molto
+diverso dal risultato ottenuto quando si esegue un confronto rigorosamente
+"carattere per carattere"address@hidden, il confronto di stringhe
+dovrebbe funzionare come se le stringhe fossero confrontate usando la
+funzione @code{strcoll()} di C.}
+
+Poich@'e questo comportamento differisce sensibilmente dalla pratica corrente,
address@hidden lo implementava solo quando eseguito in address@hidden POSIX
+(@pxref{Opzioni}).
+Quest'esempio ilustra la differenza, in una localizzazione
address@hidden:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf("ABC < abc = %s\n",}
+> @kbd{("ABC" < "abc" ? "TRUE" : "FALSE")) @}'}
address@hidden ABC < abc = TRUE
+$ @kbd{gawk --posix 'BEGIN @{ printf("ABC < abc = %s\n",}
+> @kbd{("ABC" < "abc" ? "TRUE" : "FALSE")) @}'}
address@hidden ABC < abc = FALSE
address@hidden example
+Fortunatamente, dal mese di agosto 2016, un confronto basato sull'ordine
+di collazione locale non @`e address@hidden richiesto per gli operatori
@code{==} e
address@hidden@footnote{Si consulti il sito web
address@hidden://austingroupbugs.net/view.php?id=1070,
+dell'Austin Group}.} Tuttavia, un confronto basato sull'ordine di
+collazione locale @`e ancora richiesto per gli operatori @code{<},
address@hidden<=}, @code{>} e @code{>=}. POSIX, quindi, raccomanda quanto
+segue:
+
address@hidden
+Poich@'e l'operatore @code{==} controlla che se le stringhe sono identiche,
+e non se sono nell'ordine di collazione locale, le applicazioni che
+devono controllare se le stringhe sono nell'ordine di collazione locale
+possono usare:
+
address@hidden
+a <= b && a >= b
address@hidden example
address@hidden quotation
+
+A partire dalla @value{PVERSION} 4.2, @command{gawk} continua a usare
+l'ordine di collazione locale per @code{<}, @code{<=}, @code{>}
+e @code{>=} solo se eseguito nella address@hidden POSIX.
+
address@hidden Operatori booleani
address@hidden Espressioni booleane
address@hidden @dfn{and}, operatore logico-booleano
address@hidden @dfn{or}, operatore logico-booleano
address@hidden @dfn{not}, operatore logico-booleano
address@hidden espressioni booleane
address@hidden booleane, espressioni
address@hidden operatori booleani, si veda espressioni booleane
address@hidden booleani, operatori, si veda espressioni booleane
address@hidden logici, operatori, si veda espressioni booleane
address@hidden operatori logici, si veda espressioni booleane
+
+Un'@dfn{espressione booleana} @`e una combinazione di espressioni di confronto
o
+espressioni di ricerca, che usa gli operatori booleani "or"
+(@samp{||}), "and" (@samp{&&}), e "not" (@samp{!}), facendo uso di
+parentesi per controllare le nidificazioni. Il valore di address@hidden
+dell'espressione booleana @`e calcolato calcolando i valori di address@hidden
delle
+espressioni componenti. Le espressioni booleane sono conosciute anche come
address@hidden logiche}. I due termini sono equivalenti.
+
+Le espressioni booleane possono essere usate in tutti i casi in cui @`e
possibile
+usare espressioni di confronto e di ricerca di corrispondenze. Si possono
+usare nelle istruzioni @code{if}, @code{while}, @code{do} e @code{for}
+(@pxref{Istruzioni}).
+Hanno valori numerici (uno se vero, zero se falso) che entrano in gioco
+se il risultato di un'espressione booleana @`e memorizzato in una variabile o
+se @`e usato nei calcoli.
+
+Inoltre, ogni espressione booleana @`e anche un modello di ricerca valido,
address@hidden@dotless{i}}
+se ne address@hidden usare uno come modello di ricerca per controllare
l'esecuzione di
+regole. Gli operatori booleani sono:
+
address@hidden @code
address@hidden @var{booleano1} && @var{booleano2}
+Vero se @var{booleano1} e @var{booleano2} sono entrambi veri. Per esempio,
+la seguente istruzione stampa il record in input corrente se contiene
+sia @samp{edu} che @samp{li}:
+
address@hidden
+if ($0 ~ /edu/ && $0 ~ /li/) print
address@hidden example
+
address@hidden effetti collaterali, operatori booleani
+La sottoespressione @var{booleano2} viene valutata solo se @var{booleano1}
address@hidden vero. Questo address@hidden comportare una differenza laddove
@var{booleano2} contenga
+espressioni che hanno effetti collaterali. Nel caso di @samp{$0 ~ /pippo/ &&
+($2 == pluto++)}, la variabile @code{pluto} non viene incrementata se non c'@`e
+nessuna sottostringa @samp{pippo} nel record.
+
address@hidden @var{booleano1} || @var{booleano2}
+Vero se almeno uno tra @var{booleano1} e @var{booleano2} @`e vero.
+Per esempio, la seguente istruzione stampa tutti i record dell'input che
+contengono @samp{edu} @emph{oppure}
address@hidden:
+
address@hidden
+if ($0 ~ /edu/ || $0 ~ /li/) print
address@hidden example
+
+La sottoespressione @var{booleano2} viene valutata solo se @var{booleano1}
address@hidden falso. Questo address@hidden comportare una differenza quando
@var{booleano2} contiene
+espressioni che hanno effetti collaterali.
+(address@hidden, questo confronto non individua mai i record che contengono sia
address@hidden che @samp{li}: non appena @samp{edu} viene trovato,
+l'intero confronto @`e concluso positivamente.)
+
address@hidden ! @var{booleano}
+Vero se @var{booleano} @`e falso. Per esempio,
+il seguente programma stampa @samp{nessuna home!} nel
+caso insolito che la variabile d'ambiente @env{HOME}
+non sia stata definita:
+
address@hidden
+BEGIN @{ if (! ("HOME" in ENVIRON))
+ print "nessuna home!" @}
address@hidden example
+
+(L'operatore @code{in} @`e descritto in
address@hidden elementi}.)
address@hidden table
+
address@hidden cortocircuito, operatori
address@hidden operatori di cortocircuito
address@hidden @code{&} (e commerciale), operatore @code{&&}
address@hidden e commerciale (@code{&}), operatore @code{&&}
address@hidden @code{|} (barra verticale), operatore @code{||}
address@hidden barra verticale (@code{|}), operatore @code{||}
+Gli operatori @samp{&&} e @samp{||} sono chiamati operatori di
address@hidden per il modo in cui funzionano. La valutazione dell'intera
+espressione @`e "cortocircuitata" se il risultato address@hidden
address@hidden essere determinato
+prima di aver completato interamente la valutazione.
+
address@hidden continuazione di riga
+Le istruzioni che finiscono con @samp{&&} o @samp{||} si possono continuare
+semplicemente mettendo un ritorno a capo dopo di esse. address@hidden non si
address@hidden mettere
+un ritorno a capo @emph{prima} di questi operatori senza usare la
+continuazione tramite la barra inversa (@pxref{Istruzioni/Righe}).
+
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden ritorno a capo
address@hidden variabili di tipo indicatore address@hidden
address@hidden @dfn{flag} [indicatore], variabili
+Il valore reale di un'espressione che usa l'operatore @samp{!} @`e uno
+o zero, a seconda del valore di address@hidden dell'espressione a cui
address@hidden applicato.
+L'operatore @samp{!} spesso @`e utile per cambiare il senso di una variabile
+indicatore address@hidden da falso a vero e viceversa. Per esempio, il seguente
+programma @`e un modo per stampare righe poste tra due speciali righe
+delimitatrici:
+
address@hidden
+$1 == "START" @{ pertinente = ! pertinente; next @}
+pertinente @{ print @}
+$1 == "END" @{ pertinente = ! pertinente; next @}
address@hidden example
+
address@hidden
+La variabile @code{pertinente}, address@hidden@dotless{i}} come tutte le
variabili di @command{awk},
address@hidden inizializzata a zero, che vale anche "falso". Quando viene
trovata
+una riga il cui primo campo @`e @samp{START}, il valore di @code{pertinente}
+viene commutato a vero, usando @samp{!}. La regola nella riga seguente stampa
righe finch@'e
address@hidden resta vero. Quando viene trovata una riga il cui primo
+campo @`e @samp{END}, @code{pertinente} viene nuovamente commutata a
address@hidden programma ha un bug; stampa righe che iniziano con
address@hidden Come si address@hidden risolvere?}
+
address@hidden
+Scott Deifik points out that this program isn't robust against
+bogus input data, but the point is to illustrate the use of `!',
+so we'll leave well enough alone.
address@hidden ignore
+
address@hidden comunemente, l'operatore @samp{!} viene usato nelle condizioni
delle
+istruzioni @code{if} e @code{while}, dove ha address@hidden senso formulare
espressioni
+logiche in negativo:
+
address@hidden
+if (! @var{qualche condizione} || @var{qualche altra condizione}) @{
+ @address@hidden fai un'operazione a piacere @dots{}}
address@hidden
address@hidden example
+
address@hidden @code{next}, istruzione
address@hidden NOTA
+L'istruzione @code{next} viene trattata in
address@hidden next}.
address@hidden dice ad @command{awk} di tralasciare il resto delle regole,
+leggere il record successivo, e iniziare a elaborare le regole partendo
+nuovamente dalla prima.
+Il motivo @`e quello di evitare di stampare le righe delimitatrici
address@hidden e @samp{END}.
address@hidden quotation
+
address@hidden Espressioni condizionali
address@hidden Espressioni condizionali
address@hidden condizionali, espressioni
address@hidden espressioni condizionali
address@hidden espressioni, selezionare
+
+Un'@dfn{espressione condizionale} @`e un tipo particolare di espressione che ha
+tre operandi. Consente di usare il primo valore dell'espressione per
+scegliere una o l'altra delle due ulteriori espressioni.
+L'espressione condizionale in @command{awk} @`e la stessa di quella del
+linguaggio C, ovvero:
+
address@hidden
address@hidden ? @var{espr-se-vero} : @var{espr-se-falso}
address@hidden example
+
address@hidden
+Ci sono tre sottoespressioni. La prima, @var{selettore}, viene sempre
+calcolata per prima. Se @`e "vera" (non zero o non nulla), viene poi calcolata
address@hidden e il suo valore diventa il valore dell'intera espressione.
+Altrimenti, la seconda espressione che viene calcolata @`e @var{espr-se-falso}
+e il suo valore diventa il valore dell'intera espressione.
+Per esempio, la seguente espressione produce il valore assoluto di @code{x}:
+
address@hidden
+x >= 0 ? x : -x
address@hidden example
+
address@hidden effetti collaterali, espressioni condizionali
+Ogni volta che viene calcolata un'espressione condizionale, solo una delle
+espressioni @var{espr-se-vero} e @var{espr-se-falso} viene usata; l'altra
address@hidden ignorata. Questo @`e importante quando le espressioni hanno
effetti
+collaterali. Per esempio, quest'espressione condizionale esamina l'elemento
address@hidden del vettore @code{a} o del vettore @code{b}, e incrementa
@code{i}:
+
address@hidden
+x == y ? a[i++] : b[i++]
address@hidden example
+
address@hidden
+Questa istruzione garantisce che @code{i} sia incrementato una volta sola
+per ogni esecuzione dell'istruzione stessa, perch@'e ogni volta viene eseguita
+solo una delle due espressioni di incremento, mentre l'altra viene
+ignorata.
address@hidden
address@hidden,
address@hidden iftex
address@hidden
address@hidden,
address@hidden ifnottex
+per maggiori informazioni sui vettori.
+
address@hidden differenze tra @command{awk} e @command{gawk}, continuazione di
riga
address@hidden continuazione di riga, @command{gawk}
address@hidden @command{gawk}, continuazione di riga in
+Come estensione minore di @command{gawk},
+un'istruzione che usa @samp{?:} si address@hidden continuare mettendo
+semplicemente un ritorno a capo dopo i due caratteri.
+Tuttavia, se si mette un ritorno a capo @emph{prima} dei due
+caratteri, la continuazione non funziona, se non si aggiunge anche la barra
inversa
+(@pxref{Istruzioni/Righe}).
+Se viene specificata l'opzione @option{--posix}
+(@pxref{Opzioni}), quest'estensione @`e disabilitata.
+
address@hidden Chiamate di funzione
address@hidden Chiamate di funzione
address@hidden chiamata di funzione
+
+Una @dfn{funzione} @`e un nome per richiedere un particolare calcolo.
+Il nome permette di richiamare
+la funzione da qualsiasi punto del programma.
+Per esempio, la funzione @code{sqrt()} calcola la radice quadrata di un numero.
+
address@hidden funzioni predefinite
+Un certo numero di funzioni sono @dfn{predefinite}, ossia sono
+disponibili in ogni programma @command{awk}. La funzione @code{sqrt()} @`e una
+di queste. @xref{Funzioni predefinite} per un elenco di funzioni
+predefinite e per le loro rispettive descrizioni. In aggiunta, l'utente
address@hidden
+definire delle funzioni da usare nel proprio programma.
address@hidden definite dall'utente}
+per istruzioni su come farlo.
+Infine, @command{gawk} permette di scrivere funzioni in C o in C++ che possono
+essere chiamate dal proprio programma (@pxref{Estensioni dinamiche}).
+
address@hidden argomenti, nelle chiamate di funzione
+Una funzione viene utilizzata invocandola tramite un'espressione di
address@hidden di funzione}, che consiste nel nome della funzione seguito
+immediatamente da una lista di @dfn{argomenti} tra parentesi. Gli argomenti
+sono espressioni che forniscono i materiali grezzi su cui opera la funzione.
+Quando ci sono address@hidden argomenti, questi sono separati da virgole. Se
+non ci sono argomenti, basta scrivere @samp{()} dopo il nome della funzione.
+Gli esempi che seguono mostrano chiamate di funzione con e senza argomenti:
+
address@hidden
+sqrt(x^2 + y^2) @ii{un argomento}
+atan2(y, x) @ii{due argomenti}
+rand() @ii{nessun argomento}
address@hidden example
+
address@hidden risoluzione di problemi, sintassi della chiamata di funzione
address@hidden problemi, risoluzione di, sintassi della chiamata di funzione
address@hidden ATTENZIONE
+Non ci dev'essere nessuno spazio tra il nome della funzione e la parentesi
+aperta! Un nome di funzione definita dall'utente address@hidden essere
scambiata per
+il nome di una
+variabile: uno spazio renderebbe l'espressione simile alla concatenazione di
+una variabile con un'espressione racchiusa tra parentesi.
+Per le funzioni predefinite, lo spazio prima delle parentesi non crea problemi,
+ma @`e meglio non prendere l'abitudine di usare spazi per evitare errori con le
+funzioni definite dall'utente.
address@hidden quotation
+
+Ogni funzione richiede uno specifico numero di argomenti.
+Per esempio, la funzione @code{sqrt()} dev'essere chiamata con
+un solo argomento, il numero del quale si vuole estrarre la radice quadrata:
+
address@hidden
+sqrt(@var{argomento})
address@hidden example
+
+Alcune delle funzioni predefinite hanno uno o address@hidden argomenti
opzionali.
+Se questi argomenti non vengono forniti, le funzioni
+usano un valore di default appropriato.
address@hidden predefinite} per tutti i dettagli. Se sono omessi argomenti
+in chiamate a funzioni definite dall'utente, tali argomenti sono considerati
+essere variabili locali. Il valore di tali variabili locali
address@hidden la stringa nulla se usate in un contesto che richiede una
stringa
+di caratteri, e lo zero se @`e richiesto
+un valore numerico
+(@pxref{Funzioni definite dall'utente}).
+
+Come address@hidden avanzata, @command{gawk} prevede la address@hidden di
+effettuare chiamate di funzione
+indirette, il che permette di scegliere la funzione da chiamare al momento
+dell'esecuzione, invece che nel momento in cui si scrive il codice sorgente
+del programma.
+Si rimanda la trattazione di questa address@hidden
+a un secondo momento; si veda @ref{Chiamate indirette}.
+
address@hidden effetti collaterali, chiamate di funzione
+Come ogni altra espressione, la chiamata di funzione ha un valore, chiamato
+spesso @dfn{valore di ritorno}, che @`e calcolato dalla funzione
+in base agli argomenti dati. In quest'esempio, il valore di ritorno
+di @samp{sqrt(@var{argomento})} @`e la radice quadrata di @var{argomento}.
+Il seguente programma legge numeri, un numero per riga, e stampa
+la radice quadrata di ciascuno:
+
address@hidden
+$ @kbd{awk '@{ print "La radice quadrata di", $1, "@`e", sqrt($1) @}'}
address@hidden
address@hidden La radice quadrata di 1 @`e 1
address@hidden
address@hidden La radice quadrata di 3 @`e 1.73205
address@hidden
address@hidden La radice quadrata di 5 @`e 2.23607
address@hidden
address@hidden example
+
+Una funzione address@hidden avere anche effetti collaterali, come assegnare
+valori a certe variabili o effettuare operazioni di I/O.
+Questo programma mostra come la funzione @code{match()}
+(@pxref{Funzioni per stringhe})
+cambia le variabili @code{RSTART} e @code{RLENGTH}:
+
address@hidden
address@hidden
+ if (match($1, $2))
+ print RSTART, RLENGTH
+ else
+ print "non uguali"
address@hidden
address@hidden example
+
address@hidden
+Qui vediamo un'esecuzione di esempio:
+
address@hidden
+$ @kbd{awk -f matchit.awk}
address@hidden c+}
address@hidden 3 2
address@hidden pluto}
address@hidden non uguali
address@hidden e}
address@hidden 5 1
address@hidden example
+
address@hidden Precedenza
address@hidden Precedenza degli operatori (Come si nidificano gli operatori)
address@hidden precedenza
address@hidden operatori, precedenza
+
+La @dfn{precedenza degli operatori} determina come gli operatori vengono
+raggruppati quando diversi operatori appaiono uno vicino all'altro in
+un'espressione.
+Per esempio, @samp{*} ha una precedenza address@hidden alta di @samp{+};
address@hidden@dotless{i}},
address@hidden + b * c} moltiplica @code{b} e @code{c}, e poi aggiunge @code{a}
al
+prodotto (ovvero esegue @samp{a + (b * c)}).
+
+La normale precedenza degli operatori address@hidden essere cambiata usando
delle
+parentesi. Si possono vedere le regole di precedenza come un modo per
+indicare dove si sarebbero dovute mettere delle parentesi. Di fatto,
address@hidden cosa saggia usare sempre le parentesi
+in presenza di una combinazione di operatori insolita, perch@'e altre persone
+che leggono il programma potrebbero non ricordare quale sia la precedenza
+in quel particolare caso.
+Anche dei programmatori esperti a volte dimenticano le regole esatte,
+il che porta a commettere errori.
+Usare esplicitamente le parentesi previene qualunque errore
+di questo tipo.
+
+Quando vengono usati insieme operatori con uguale precedenza, quello
address@hidden a
+sinistra viene raggruppato per primo, ad eccezione degli operatori di
+assegnamento, condizionali e di elevamento a potenza, che vengono raggruppati
+nell'ordine opposto.
+Quindi, @samp{a - b + c} raggruppa come @samp{(a - b) + c} e
address@hidden = b = c} raggruppa come @samp{a = (b = c)}.
+
+Normalmente la precedenza degli operatori unari di prefisso non ha importanza,
+perch@'e c'@`e un solo modo di interpretarli: prima il address@hidden interno.
Quindi,
address@hidden significa @samp{$(++i)} e
address@hidden significa @samp{++($x)}. Tuttavia, quando un altro operatore
segue
+l'operando, la precedenza degli operatori unari address@hidden avere
importanza.
address@hidden significa @samp{($x)^2}, ma @samp{-x^2} significa
address@hidden(x^2)}, perch@'e @samp{-} ha precedenza address@hidden bassa
rispetto a @samp{^},
+mentre @samp{$} ha precedenza address@hidden alta.
+Inoltre, gli operatori non possono essere combinati in modo tale da violare le
+regole di precedenza; per esempio, @samp{$$0++--} non @`e un'espressione valida
+perch@'e il primo @samp{$} ha precedenza address@hidden alta di
address@hidden; per evitare il problema l'espressione address@hidden essere
scritta come
address@hidden($0++)--}.
+
+Questa lista illustra gli operatori di @command{awk}, in ordine di precedenza
+dalla address@hidden alta alla address@hidden bassa:
+
address@hidden @asis for docbook to come out right
address@hidden @asis
address@hidden @code{(address@hidden@code{)}
+Raggruppamento.
+
address@hidden @code{$} (dollaro), operatore di campo @code{$}
address@hidden dollaro (@code{$}), operatore di campo @code{$}
address@hidden @code{$}
+Riferimento a un campo.
+
address@hidden @code{+} (address@hidden), operatore @code{++}
address@hidden address@hidden (@code{+}), operatore @code{++}
address@hidden @code{-} (meno), operatore @code{--}
address@hidden meno (@code{-}), operatore @code{--}
address@hidden @code{++ --}
+Incremento, decremento.
+
address@hidden @code{^} (circonflesso), operatore @code{^}
address@hidden circonflesso (@code{^}), operatore @code{^}
address@hidden @code{*} (asterisco), operatore @code{**}
address@hidden asterisco (@code{*}), operatore @code{**}
address@hidden @code{^ **}
+Elevamento a potenza. Questi operatori sono raggruppati da destra verso
+sinistra.
+
address@hidden @code{+} (address@hidden), operatore @code{+}
address@hidden address@hidden (@code{+}), operatore @code{+}
address@hidden @code{-} (meno), operatore @code{-}
address@hidden meno (@code{-}), operatore @code{-}
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden @code{+ - !}
address@hidden, meno, ``not'' logico, unari.
+
address@hidden @code{*} (asterisco), operatore @code{*}, come operatore di
moltiplicazione
address@hidden asterisco (@code{*}), operatore @code{*}, come operatore di
moltiplicazione
address@hidden @code{/} (barra), operatore @code{/}
address@hidden barra (@code{/}), operatore @code{/}
address@hidden @code{%} (percento), operatore @code{%}
address@hidden percento (@code{%}), operatore @code{%}
address@hidden @code{* / %}
+Moltiplicazione, divisione, resto di una divisione.
+
address@hidden @code{+} (address@hidden), operatore @code{+}
address@hidden address@hidden (@code{+}), operatore @code{+}
address@hidden @code{-} (meno), operatore @code{-}
address@hidden meno (@code{-}), operatore @code{-}
address@hidden @code{+ -}
+Addizione, sottrazione.
+
address@hidden Concatenazione di stringhe
+Non c'@`e un simbolo speciale per la concatenazione.
+Gli operandi sono semplicemente scritti uno accanto all'altro.
+(@pxref{Concatenazione}).
+
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<}
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<=}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>=}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>}
address@hidden @code{=} (uguale), operatore @code{==}
address@hidden uguale (@code{=}), operatore @code{==}
address@hidden @code{!} (punto esclamativo), operatore @code{!=}
address@hidden punto esclamativo (@code{!}), operatore @code{!=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>>} (I/O)
address@hidden parentesi acuta destra (@code{>}), operatore @code{>>} (I/O)
address@hidden operatori, input/output
address@hidden @code{|} (barra verticale), operatore @code{|} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|} (I/O)
address@hidden operatori, input/output
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|&} (I/O)
address@hidden operatori, input/output
address@hidden @code{< <= == != > >= >> | |&}
+Operatori relazionali e ridirezione.
+Gli operatori relazionali e le ridirezioni hanno lo stesso livello di
+precedenza. I caratteri come @samp{>} servono sia come operatori relazionali
+che come ridirezioni; la distinzione tra i due significati dipende dal
+contesto.
+
address@hidden istruzione @code{print}, operatori I/O nell'
address@hidden istruzione @code{printf}, operatori I/O nell'
+Si noti che gli operatori di ridirezione I/O nelle istruzioni @code{print} e
address@hidden appartengono al livello dell'istruzione, non alle espressioni.
+La ridirezione non produce un'espressione che potrebbe essere l'operando di un
+altro operatore. Di conseguenza, non ha senso usare un operatore di
+ridirezione vicino a un altro operatore con precedenza address@hidden bassa
senza
+parentesi. Tali combinazioni generano errori di sintassi
+(p.es., @samp{print pippo > a ? b : c}).
+Il modo corretto di scrivere quest'istruzione @`e @samp{print pippo > (a ? b :
c)}.
+
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @code{~ !~}
+Corrispondenza, non corrispondenza.
+
address@hidden @code{in}, operatore
address@hidden @code{in}
+Appartenenza a un vettore.
+
address@hidden @code{&} (e commerciale), operatore @code{&&}
address@hidden e commerciale (@code{&}), operatore @code{&&}
address@hidden @code{&&}
+``and'' logico.
+
address@hidden @code{|} (barra verticale), operatore @code{||}
address@hidden barra verticale (@code{|}), operatore @code{||}
address@hidden @code{||}
+``or'' logico.
+
address@hidden @code{?} (punto interrogativo), operatore @code{?:}
address@hidden punto interrogativo (@code{?}), operatore @code{?:}
address@hidden @code{?:}
+Operatore condizionale. Questo operatore raggruppa da destra verso sinistra.
+
address@hidden @code{+} (address@hidden), operatore @code{+=}
address@hidden address@hidden (@code{+}), operatore @code{+=}
address@hidden @code{-} (meno), operatore @code{-=}
address@hidden meno (@code{-}), operatore @code{-=}
address@hidden @code{*} (asterisco), operatore @code{*=}
address@hidden asterisco (@code{*}), operatore @code{*=}
address@hidden @code{*} (asterisco), operatore @code{**=}
address@hidden asterisco (@code{*}), operatore @code{**=}
address@hidden @code{/} (barra), operatore @code{/=}
address@hidden barra (@code{/}), operatore @code{/=}
address@hidden @code{%} (percento), operatore @code{%=}
address@hidden percento (@code{%}), operatore @code{%=}
address@hidden @code{^} (circonflesso), operatore @code{^=}
address@hidden circonflesso (@code{^}), operatore @code{^=}
address@hidden @code{= += -= *= /= %= ^= **=}
+Assegnamento. Questi operatori raggruppano da destra verso sinistra.
address@hidden table
+
address@hidden POSIX @command{awk}, @code{**} e
address@hidden address@hidden, operatori, non in POSIX @command{awk}
address@hidden NOTA
+Gli operatori @samp{|&}, @samp{**} e @samp{**=} non sono definiti da POSIX.
+Per la massima address@hidden, @`e meglio non usarli.
address@hidden quotation
+
address@hidden Localizzazioni
address@hidden Il luogo fa la differenza
address@hidden localizzazione, definizione di
+
+I moderni sistemi prevedono la nozione di @dfn{localizzazione}: un modo per
+informare il sistema sulla serie di caratteri e sulla lingua locali.
+Lo standard ISO C definisce una localizzazione di default @code{"C"}, che @`e
+l'ambiente tipico a cui molti programmatori in C sono abituati.
+
+Un tempo, le impostazioni della localizzazione avevano influenza sulla
+ricerca di corrispondenze tramite @dfn{regexp}, ma ora non @`e address@hidden
address@hidden@dotless{i}}
+(@pxref{Intervalli e localizzazione}).
+
+La localizzazione address@hidden influire sulla separazione dei record. Per
il caso
+normale di @samp{RS = "\n"}, la localizzazione @`e generalmente irrilevante.
+Per altri separatori di record di un solo carattere, impostare
+la variabile d'ambiente @samp{LC_ALL=C}
+garantisce una migliore efficienza nella lettura dei record. Altrimenti,
address@hidden dovrebbe fare diverse chiamate di funzione, @emph{per ogni
+carattere in input}, per determinare la fine del record.
+
+La localizzazione address@hidden influire sulla formattazione delle date e
delle ore
+(@pxref{Funzioni di tempo}). Per esempio, un modo comune per abbreviare la
+data 4 settembre 2015, negli Stati Uniti @`e ``9/4/15.'' In molti paesi
+dell'Europa, invece, l'abbreviazione @`e "4.9.15". Quindi, la specifica di
+formato
address@hidden in una localizzazione @code{"US"} potrebbe produrre
@samp{9/4/15},
+mentre in una localizzazione @code{"EUROPA"}, potrebbe produrre @samp{4.9.15}.
+
+Secondo POSIX, anche il confronto tra stringhe @`e influenzato dalla
+localizzazione (come nelle espressioni regolari). I dettagli sono descritti in
address@hidden POSIX di stringhe}.
+
+Infine, la localizzazione influenza il valore del separatore decimale
+usato quando @command{gawk} analizza i dati in input. Questo @`e stato
+trattato nel dettaglio in @ref{Conversione}.
+
address@hidden Sommario delle espressioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Le espressioni sono gli elementi base dei calcoli eseguiti nei programmi.
+Sono costruite a partire da costanti, variabili, chiamate di funzione e dalla
+combinazione di vari tipi di valori tramite operatori.
+
address@hidden
address@hidden fornisce tre tipi di costanti: numerica, di stringa e
+di @dfn{regexp}. Le costanti numeriche in @command{gawk} si possono
+specificare nei sistemi ottale ed esadecimale (con base 8 e 16), e anche nel
+sistema decimale (base 10). In alcuni contesti, una costante @dfn{regexp}
+isolata come @code{/pippo/} ha lo stesso significato di @samp{$0 ~ /pippo/}.
+
address@hidden
+Le variabili contengono valori che possono essere usati diverse volte nei
+calcoli. Un certo numero di variabili predefinite forniscono informazioni al
+programma @command{awk}, mentre altre permettono il controllo del comportamento
+di @command{awk}.
+
address@hidden
+I numeri sono automaticamente convertiti in stringhe, e le stringhe in numeri,
+a seconda delle address@hidden di @command{awk}. I valori numerici sono
convertiti
+come se fossero formattati con @code{sprintf()} usando il formato contenuto in
address@hidden La localizzazione address@hidden influire sulle conversioni.
+
address@hidden
+In @command{awk} ci sono gli operatori aritmetici di uso comune (addizione,
+sottrazione, moltiplicazione, divisione, modulo), e il address@hidden e il
meno unari.
+Ci sono anche operatori di confronto, operatori booleani, una verifica
+dell'esistenza di una chiave in
+un vettore, e operatori per la ricerca di corrispondenze con espressioni
+regolari. La concatenazione di stringhe @`e effettuata mettendo due
espressioni
+una vicino all'altra; non c'@`e nessun operatore esplicito.
+L'operatore con tre operandi @samp{?:} fornisce una verifica ``if-else''
+all'interno delle espressioni.
+
address@hidden
+Gli operatori di assegnamento forniscono delle comode forme brevi per le comuni
+operazioni aritmetiche.
+
address@hidden
+In @command{awk}, un valore @`e considerato vero se @`e diverso da zero
address@hidden non nullo. Altrimenti, il valore @`e falso.
+
address@hidden
+Il tipo di una variabile viene impostata a ogni assegnamento e address@hidden
cambiare
+durante il suo ciclo di vita. Il tipo determina il comportamento della
+variabile nei confronti (di tipo stringa o numerici).
+
address@hidden
+Le chiamate di funzione restituiscono un valore che address@hidden essere
usato come parte
+di un'espressione address@hidden lunga. Le espressioni usate per passare
valori di
+parametro vengono valutate completamente prima di chiamare la funzione.
address@hidden fornisce funzioni predefinite e prevede quelle definite
+dall'utente; questo @`e descritto in
address@hidden
+
address@hidden
+La precedenza degli operatori specifica l'ordine secondo il quale vengono
+effettuate le operazioni, a meno che quest'ordine non sia esplicitamente
+alterato
+tramite parentesi. Le regole di precedenza degli operatori di @command{awk}
+sono compatibili con quelle del linguaggio C.
+
address@hidden
+La localizzazione address@hidden influire sul formato dei dati in uscita da un
programma
address@hidden, e occasionalmente sul formato dei dati letti in input.
+
address@hidden itemize
+
address@hidden Criteri di ricerca e azioni
address@hidden Criteri di ricerca, azioni e variabili
address@hidden criteri di ricerca
address@hidden @dfn{pattern}, si veda criteri di ricerca
address@hidden espressione di ricerca
+
+Come address@hidden visto, ogni istruzione @command{awk} consiste di un
criterio di
+ricerca address@hidden a cui @`e associata un'azione. Questo @value{CHAPTER}
+descrive come specificare criteri e azioni, cosa @`e possibile
+fare tramite le azioni e quali sono le variabili predefinite in
address@hidden
+
+Le regole @dfn{criterio di ricerca--azione} e le istruzioni che si possono
+dare all'interno delle azioni formano il nucleo centrale dei programmi
+scritti in @command{awk}.
+In un certo senso, tutto quanto si @`e visto finora costituisce le fondamenta
+sulle quali sono costruiti i programmi. @`E giunto il momento di iniziare a
+costruire qualcosa di utile.
+
address@hidden
+* Panoramica sui criteri di ricerca:: Come scrivere un criterio di ricerca.
+* Usare variabili di shell:: come usare variabili della shell in
+ @command{awk}.
+* Panoramica sulle azioni:: Come scrivere un'azione.
+* Istruzioni:: Descrizione dettagliata delle varie
+ istruzioni di controllo.
+* Variabili predefinite:: Sommario delle variabili predefinite.
+* Sommario criteri e azioni:: Sommario di criteri di ricerca e azioni.
address@hidden menu
+
address@hidden Panoramica sui criteri di ricerca
address@hidden Elementi di un criterio di ricerca
+
address@hidden
+* @dfn{regexp} come criteri di ricerca:: Usare espressioni regolari come
+ criteri di ricerca.
+* Espressioni come criteri di ricerca:: Qualsiasi espressione address@hidden
servire da
+ criterio di ricerca.
+* Intervalli:: Coppie di espressioni regolari per
+ delimitare una ricerca.
+* BEGIN/END:: Specificare regole di inizio e fine programma.
+* BEGINFILE/ENDFILE:: Due condizioni speciali per controlli avanzati.
+* Vuoto:: Il criterio di ricerca vuoto, che
+ corrisponde a ogni record.
address@hidden menu
+
address@hidden criteri di ricerca, tipi di
+I criteri di ricerca in @command{awk} controllano l'esecuzione di
+azioni: un'azione viene eseguita
+quando il criterio di ricerca associato ad essa @`e soddisfatto dal
+record in input corrente.
+La tabella seguente @`e un sommario dei tipi di criteri di ricerca in
address@hidden:
+
address@hidden @code
address@hidden /@var{espressione regolare}/
+Un'espressione regolare. @`E verificata quando il testo di un
+record in input corrisponde all'espressione regolare.
address@hidden
+(@xrefIl{Espressioni regolari}.)
address@hidden iftex
address@hidden
+(@xref{Espressioni regolari}.)
address@hidden ifnottex
+
address@hidden @var{espressione}
+Una singola espressione. @`E verificata quando il suo valore @`e
+diverso da zero (se di tipo numerico) o non nullo (se @`e una stringa).
+(@xref{Espressioni come criteri di ricerca}.)
+
address@hidden @var{inizio_interv}, @var{fine_interv}
+Una coppia di criteri di ricerca separati da una virgola, che specificano un
address@hidden di record.
+L'intervallo comprende sia il record iniziale che corrisponde a
@var{inizio_interv}
+sia il record finale che corrisponde a @var{fine_interv}.
+(@xref{Intervalli}.)
+
address@hidden BEGIN
address@hidden END
+Criteri di ricerca speciali che consentono azioni di inizializzazione o
+di pulizia in un programma @command{awk}.
+(@xref{BEGIN/END}.)
+
address@hidden BEGINFILE
address@hidden ENDFILE
+Criteri di ricerca speciali che consentono azioni di inizializzazione o di
+pulizia da eseguire all'inizio o alla fine di ogni file in input.
+(@xref{BEGINFILE/ENDFILE}.)
+
address@hidden @var{vuoto}
+Il criterio di ricerca vuoto corrisponde a ciascun record in input.
+(@xref{Vuoto}.)
address@hidden table
+
address@hidden @dfn{regexp} come criteri di ricerca
address@hidden Espressioni regolari come criteri di ricerca
address@hidden criteri di ricerca, espressioni come
address@hidden espressioni regolari, come criteri di ricerca
+
+Le espressioni regolari sono uno dei primi tipi di criteri di ricerca
+presentati in questo @value{DOCUMENT}.
+Questo tipo di criterio di ricerca @`e semplicemente una costante @dfn{regexp}
+posta nella parte @dfn{criterio di ricerca} di una regola. Equivale a
+scrivere @samp{$0 ~ /@var{criterio di ricerca}/}.
+Il criterio di ricerca @`e verificato quando il record in input corrisponde
+alla @dfn{regexp}.
+Per esempio:
+
address@hidden
+/pippo|pluto|paperino/ @{ personaggi_Disney++ @}
+END @{ print personaggi_Disney, "Personaggi Disney visti" @}
address@hidden example
+
address@hidden Espressioni come criteri di ricerca
address@hidden Espressioni come criteri di ricerca
address@hidden espressioni regolari, come criteri di ricerca
+
+Qualsiasi espressione @command{awk} address@hidden essere usata come un
criterio di
+ricerca @command{awk}.
+Il criterio di ricerca @`e verificato se il valore dell'espressione @`e diverso
+da zero (se @`e un numero), o non nullo (se @`e una stringa).
+L'espressione @`e ricalcolata ogni volta che la regola viene applicata a un
+nuovo record in input. Se l'espressione usa campi come @code{$1}, il suo
+valore dipende direttamente dal contenuto del record in input appena letto;
+altrimenti, dipende solo da quel che @`e accaduto fino a quel momento durante
+l'esecuzione del programma @command{awk}.
+
address@hidden espressioni di confronto, come criteri di ricerca
address@hidden criteri di ricerca, espressioni di confronto come
+Le espressioni di confronto, che usano gli operatori di confronto descritti in
address@hidden di variabile e confronti},
+sono un tipo di criterio di ricerca usato frequentemente.
+Anche le @dfn{regexp}, verificate o non verificate, sono tipi di espressioni
molto frequenti.
+L'operando a sinistra degli operatori @samp{~} e @samp{!~} @`e una stringa.
+L'operando di destra @`e un'espressione regolare costante delimitata da
+barre (@code{/@address@hidden/}) o qualsiasi espressione il cui valore come
+stringa @`e usato come un'espressione regolare dinamica
+(@pxref{Espressioni regolari calcolate}).
+L'esempio seguente stampa il secondo campo di ogni record in input
+il cui primo campo sia esattamente @samp{li}:
+
address@hidden @code{/} (barra), criteri di ricerca e
address@hidden barra (@code{/}), criteri di ricerca e
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden
+$ @kbd{awk '$1 == "li" @{ print $2 @}' mail-list}
address@hidden example
+
address@hidden
+(Il programma non stampa alcun output, perch@'e nessuna persona ha come nome
esattamente @samp{li}.)
+Si veda la differenza con il seguente confronto di espressione regolare, che
+individua invece qualsiasi record il cui primo campo @emph{contenga} @samp{li}:
+
address@hidden
+$ @kbd{awk '$1 ~ /li/ @{ print $2 @}' mail-list}
address@hidden 555-5553
address@hidden 555-6699
address@hidden example
+
address@hidden @dfn{regexp}, costanti, come criteri di ricerca
address@hidden criteri di ricerca, costanti @dfn{regexp} come
+Una costante @dfn{regexp} usata come criterio di ricerca @`e anche un
+caso speciale di criterio di ricerca costituito da un'espressione.
+All'espressione @code{/li/} viene assegnato il valore uno se @samp{li}
+viene trovato nel record in input corrente. Quindi, come criterio di ricerca,
address@hidden/li/} individua tutti i record che contengono la stringa
@samp{li}.
+
address@hidden espressioni booleane, come criteri di ricerca
+Anche le espressioni booleane sono frequentemente usate come criteri di
+ricerca. Se un criterio di ricerca
+individua o no un record in input dipende dalla verifica delle
+sottoespressioni da cui @`e composto.
+Per esempio, il seguente comando stampa tutti i record in
address@hidden che contengono sia @samp{edu} che @samp{li}:
+
address@hidden
+$ @kbd{awk '/edu/ && /li/' mail-list}
address@hidden Samuel 555-3430 samuel.lanceolis@@shu.edu A
address@hidden example
+
+Il seguente comando stampa tutti i record in
address@hidden che contengono @samp{edu} @emph{oppure} @samp{li}
+(o entrambi, naturalmente):
+
address@hidden
+$ @kbd{awk '/edu/ || /li/' mail-list}
address@hidden Amelia 555-5553 amelia.zodiacusque@@gmail.com F
address@hidden Broderick 555-0542 broderick.aliquotiens@@yahoo.com R
address@hidden Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
address@hidden Julie 555-6699 julie.perscrutabor@@skeeve.com F
address@hidden Samuel 555-3430 samuel.lanceolis@@shu.edu A
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden example
+
+Il seguente comando stampa tutti i record in
address@hidden che @emph{non} contengono la stringa @samp{li}:
+
address@hidden
+$ @kbd{awk '! /li/' mail-list}
address@hidden Anthony 555-3412 anthony.asserturo@@hotmail.com A
address@hidden Becky 555-7685 becky.algebrarum@@gmail.com A
address@hidden Bill 555-1675 bill.drowning@@hotmail.com A
address@hidden Camilla 555-2912 camilla.infusarum@@skynet.be R
address@hidden Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
address@hidden Martin 555-6480 martin.codicibus@@hotmail.com A
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, criteri di ricerca booleani e
address@hidden @code{END}, criterio di ricerca, criteri di ricerca booleani e
address@hidden @code{BEGINFILE}, criterio di ricerca, criteri di ricerca
booleani e
address@hidden @code{ENDFILE}, criterio di ricerca, criteri di ricerca booleani
e
+Le sottoespressioni di un'operatore booleano in un criterio di ricerca possono
+essere espressioni regolari costanti, confronti, o qualsiasi altra espressione
+di @command{awk}. Gli intervalli di ricerca
+non sono espressioni, e quindi non possono apparire all'interno di
+criteri di ricerca booleani. Analogamente, i criteri di ricerca speciali
address@hidden, @code{END}, @code{BEGINFILE} ed @code{ENDFILE},
+che non corrispondono ad alcun record in input, non sono espressioni e non
+possono essere usati all'interno di criteri di ricerca booleani.
+
+L'ordine di precedenza dei differenti operatori che possono essere usati nei
+criteri di ricerca @`e descritto in @ref{Precedenza}.
+
address@hidden Intervalli
address@hidden Specificare intervalli di record con i criteri di ricerca
+
address@hidden intervalli di ricerca
address@hidden criteri di ricerca, intervalli nei
address@hidden righe, individuare intervalli di
address@hidden @code{,} (virgola), negli intervalli di ricerca
address@hidden virgola (@code{,}), negli intervalli di ricerca
+Un @dfn{intervallo di ricerca} @`e composto da due criteri di ricerca
+separati da una virgola, nella forma
address@hidden@var{inizio_intervallo}, @var{fine_intervallo}}. @`E usato per
+individuare
+una serie di record consecutivi nei file in input. Il primo criterio di
+ricerca, @var{inizio_intervallo}, controlla dove inizia la serie di record,
+mentre @var{fine_intervallo} controlla dove finisce la serie stessa.
+L'esempio seguente:
+
address@hidden
+awk '$1 == "on", $1 == "off"' miofile
address@hidden example
+
address@hidden
+stampa ogni record in @file{miofile} incluso tra i due record che iniziano con
address@hidden/@samp{off}, estremi compresi.
+
+Un intervallo di ricerca inizia con la valutazione di
address@hidden per ogni record in input. Quando un record soddisfa
+la condizione @var{inizio_intervallo}, l'intervallo di ricerca @`e
address@hidden e l'intervallo di ricerca include anche quel
+record. Finch@'e l'intervallo di ricerca rimane attivo,
+automaticamente vengono trovate corrispondenze in ogni record in input letto.
+L'intervallo di ricerca verifica anche @var{fine_intervallo} per ogni
+record in input; quando la verifica ha successo, il
+criterio di ricerca viene @dfn{disattivato} a partire dal record seguente.
+Quindi il criterio di ricerca torna a controllare
address@hidden per ogni nuovo record.
+
address@hidden @code{if}, istruzione, address@hidden modificabili
+Il record che segnala l'inizio dell'intervallo
+di ricerca e quello che segnala la fine di quell'intervallo soddisfano
address@hidden il criterio di ricerca. Se non si vuole agire su tali record
+si possono scrivere istruzioni @code{if} nella parte @dfn{azione} della regola
+per distinguerli dai record che il programma @`e interessato a trattare.
+
address@hidden possibile che un criterio di ricerca sia attivato e disattivato
dallo
+stesso record. Se il record soddisfa entrambe le condizioni, l'azione @`e
+eseguita solo su quel record.
+Per esempio, si supponga che ci sia un testo tra due separatori identici
+(p.es., il simbolo @samp{%}), ognuno dei quali sia su una riga a parte, che
+dovrebbero essere ignorati. Un primo tentativo potrebbe essere quello di
+combinare un intervallo di ricerca che descrive il
+testo delimitato con l'istruzione
address@hidden
+(non ancora introdotta, @pxref{Istruzione next}).
+Con quest'istruzione @command{awk} non effettua alcuna azione sul record
+corrente e inizia di nuovo a elaborare il successivo record in input.
+Un tale programma @`e simile a questo:
+
address@hidden
+/^%$/,/^%$/ @{ next @}
+ @{ print @}
address@hidden example
+
address@hidden
address@hidden righe, saltare tra delimitatori
address@hidden @cindex @dfn{flag} variables
+Questo programma non funziona, perch@'e l'intervallo di ricerca @`e sia
attivato
+che disattivato dalla prima riga incontrata, quella costituita da un @samp{%}.
+Per ottenere l'effetto desiderato, si scriva il programma nella maniera che
+segue, utilizzando un @dfn{flag}:
+
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden
+/^%$/ @{ ignora = ! ignora; next @}
+ignora == 1 @{ next @} # ignora righe quando `ignora' @`e impostato a 1
address@hidden example
+
+In un intervallo di ricerca, la virgola (@samp{,}) ha la
+precedenza address@hidden bassa tra tutti gli operatori (address@hidden, @`e
l'ultima a essere
+valutata). Il programma seguente tenta di combinare un intervallo di
+ricerca con un altro controllo, address@hidden semplice:
+
address@hidden
+echo Yes | awk '/1/,/2/ || /Yes/'
address@hidden example
+
+L'intenzione in questo programma @`e quello di esprimere le condizioni
address@hidden(/1/,/2/) || /Yes/}.
+Tuttavia, @command{awk} lo interpreta come se fosse
address@hidden/1/, (/2/ || /Yes/)}.
+Questo comportamento non address@hidden essere cambiato o evitato; gli
intervalli di
+ricerca non si possono combinare con altri criteri di ricerca:
+
address@hidden
+$ @kbd{echo Yes | gawk '(/1/,/2/) || /Yes/'}
address@hidden gawk: riga com.:1: (/1/,/2/) || /Yes/
address@hidden gawk: riga com.:1: ^ syntax error
address@hidden example
+
address@hidden intervalli di ricerca, continuazione di riga e
+Come punto di secondaria importanza, nonostante sia stilisticamente poco
elegante,
+lo standard POSIX consente di andare a capo dopo la virgola
+in un intervallo di ricerca. @value{DARKCORNER}
address@hidden BEGIN/END
address@hidden I criteri di ricerca speciali @code{BEGIN} ed @code{END}
+
address@hidden @code{BEGIN}, criterio di ricerca
address@hidden @code{END}, criterio di ricerca
address@hidden criterio di ricerca @code{END}
+Tutti i criteri di ricerca fin qui descritti servono a individuare dei record
+in input.
+I criteri di ricerca speciali @code{BEGIN} ed @code{END} non hanno questo
scopo.
+Servono invece per effettuare azioni di inizializzazione o di pulizia nei
+programmi @command{awk}.
+Le regole @code{BEGIN} ed @code{END} devono prevedere azioni; non c'@`e
+un'azione di default per queste regole, perch@'e non c'@`e un record corrente
+quando sono invocate.
+Le regole @code{BEGIN} ed @code{END} sono spesso chiamate
+``blocchi @code{BEGIN} ed @code{END}'' da programmatori che usano @command{awk}
+da molto tempo.
+
address@hidden
+* Usare BEGIN/END:: Come e perch@'e usare regole BEGIN/END.
+* I/O e BEGIN/END:: Problemi di I/O nelle regole BEGIN/END.
address@hidden menu
+
address@hidden Usare BEGIN/END
address@hidden Azioni di inizializzazione e pulizia
+
address@hidden @code{BEGIN}, criterio di ricerca
address@hidden criterio di ricerca @code{BEGIN}
address@hidden @code{END}, criterio di ricerca
address@hidden criterio di ricerca @code{END}
+Una regola @code{BEGIN} @`e eseguita solo una volta, prima che sia letto il
+primo record in input. Analogamente, una regola @code{END} @`e eseguita
+solo una volta, dopo che tutto l'input @`e address@hidden stato letto. Per
esempio:
+
address@hidden
+$ @kbd{awk '}
+> @kbd{BEGIN @{ print "Analisi di \"li\"" @}}
+> @kbd{/li/ @{ ++n @}}
+> @kbd{END @{ print "\"li\" @`e presente in", n, "record." @}' mail-list}
address@hidden Analisi di "li"
address@hidden "li" @`e presente in 4 record.
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, operatori e
address@hidden @code{END}, criterio di ricerca, operatori e
address@hidden criterio di ricerca @code{END}, operatori e
+Questo programma trova il numero di record nel file in input
address@hidden che contengono la stringa @samp{li}. La regola @code{BEGIN}
+stampa un titolo per il rapporto. Non c'@`e bisogno di usare la regola
address@hidden per inizializzare il contatore @code{n} a zero, poich@'e
address@hidden lo fa
+automaticamente (@pxref{Variabili}).
+La seconda regola incrementa la variabile @code{n} ogni volta che si legge
+un record che soddisfa il criterio di ricerca @samp{li}. La regola @code{END}
+stampa il valore di @code{n} alla fine del programma.
+
+I criteri di ricerca speciali @code{BEGIN} ed @code{END} non possono essere
+usati negli intervalli,
+o con operatori booleani (in effetti, non possono essere combinati con nessun
+altro operatore).
+Un programma @command{awk} address@hidden avere molte regole @code{BEGIN} e/o
@code{END}.
+Queste sono eseguite nell'ordine in cui compaiono nel programma: tutte le
+regole @code{BEGIN} a inizio programma e tutte le regole @code{END}
+a fine programma.
+Le regole @code{BEGIN} ed @code{END} possono apparire in qualsiasi
+posizione all'interno del programma.
+Questa address@hidden @`e stata aggiunta nella versione 1987 di @command{awk}
ed
address@hidden inclusa nello standard POSIX.
+La versione originale (1978) di @command{awk} richiedeva che la regola
address@hidden fosse posta all'inizio del programma, e la regola
address@hidden alla fine del programma, e solo una regola per tipo era ammessa.
address@hidden non @`e address@hidden obbligatorio, ma @`e una buona idea
continuare a seguire questo
+modello per migliorare l'organizzazione e la address@hidden del programma.
+
+Regole multiple @code{BEGIN} ed @code{END} sono utili per scrivere funzioni
+di libreria, poich@'e ogni file di libreria address@hidden avere la sua
propria regola
address@hidden e/o @code{END} per fare la propria inizializzazione e/o pulizia.
+L'ordine in cui le funzioni di libreria sono menzionate nella riga dei comandi
+determina l'ordine in cui le rispettive regole @code{BEGIN} ed @code{END} sono
+eseguite. Per questo motivi, occorre prestare attenzione nello scrivere tali
+regole nei file di libreria, in modo che non sia importante
+l'ordine in cui tali regole vengono eseguite.
address@hidden per maggiori informazioni sull'uso di funzioni di libreria.
address@hidden
address@hidden di libreria},
address@hidden iftex
address@hidden
address@hidden di libreria},
address@hidden ifnottex
+per parecchie utili funzioni di libreria.
+
+Se un programma @command{awk} ha solo regole @code{BEGIN} e nessun'altra
+regola, il programma esce dopo aver eseguito le regole
address@hidden@footnote{La versione originale di @command{awk} continuava a
+leggere e ignorare i record in input fino alla fine del file.} Tuttavia, se
+una regola @code{END} esiste, l'intero input @`e letto, anche se non sono
+presenti altre regole nel programma. address@hidden viene fatto
necessariamente
+per permettere che
+la regola @code{END} faccia uso delle variabili @code{FNR} e @code{NR}.
+
address@hidden I/O e BEGIN/END
address@hidden Input/Output dalle regole @code{BEGIN} ed @code{END}
+
address@hidden input/output, dalle regole @code{BEGIN} ed @code{END}
+Ci sono parecchi punti (talora insidiosi) da tener presente se si fa dell'I/O
+all'interno di una regola @code{BEGIN} o @code{END}.
+Il primo ha a che fare con il valore di @code{$0} in una regola @code{BEGIN}.
+Poich@'e le regole @code{BEGIN} sono eseguite prima delle lettura di qualsiasi
+input, non c'@`e assolutamente alcun record in input, e quindi nessun campo,
+quando si eseguono delle regole @code{BEGIN}. I riferimento a @code{$0} e ai
+campi restituiscono una stringa nulla o zero, a seconda del contesto.
+Un modo per assegnare un valore effettivo a @code{$0} @`e di eseguire un
+comando @code{getline} senza indicare una variabile (@pxref{Getline}).
+Un altro modo @`e semplicemente quello di assegnare un valore a @code{$0}.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden differenze tra @command{awk} e @command{gawk}, criteri di
ricerca @code{BEGIN}/@code{END}
address@hidden POSIX @command{awk}, criteri di ricerca @code{BEGIN}/@code{END}
address@hidden @code{print}, istruzione, criteri di ricerca
@code{BEGIN}/@code{END} e
address@hidden @code{BEGIN}, criterio di ricerca, istruzione @code{print} e
address@hidden @code{END}, criterio di ricerca, istruzione @code{print} e
+Il secondo punto @`e simile al primo, ma in direzione opposta.
+Tradizionalmente, address@hidden che altro per problemi di implementazione,
@code{$0}
+e @code{NF} erano @emph{indefiniti} all'interno di una regola @code{END}.
+Lo standard POSIX prescrive che @code{NF} sia disponibile all'interno di una
+regola @code{END}. Contiene il numero di campi dell'ultimo record in input.
+Probabilmente per una svista, lo standard non specifica che @`e reso
+disponibile anche @code{$0}, sebbene possa apparire logico che sia
address@hidden@dotless{i}}.
+In effetti, BWK @command{awk}, @command{mawk} e @command{gawk} mantengono il
+valore di @code{$0} in modo che sia possibile usarlo all'interno delle regole
address@hidden Occorre peraltro tener presente che alcune altre implementazioni
+e parecchie tra le versioni address@hidden vecchie di Unix @command{awk} non si
+comportano address@hidden@dotless{i}}.
+
+Il terzo punto @`e una conseguenza dei primi due. Il significato di
address@hidden
+all'interno di una regola @code{BEGIN} o @code{END} @`e quello di sempre:
address@hidden $0}. Se @code{$0} @`e la stringa nulla, stampa una riga vuota.
+Molti programmatori di lungo corso di @command{awk} usano un semplice
address@hidden all'interno delle regole @code{BEGIN} ed @code{END},
+intendendo @address@hidden ""}}, contando sul fatto che @code{$0} sia una
+stringa nulla. Sebbene questo funzioni solitamente con le regole
address@hidden, @`e una pessima idea nelle regole @code{END},
+almeno in @command{gawk}. @`E anche stilisticamente inelegante, perch@'e se
+serve una riga vuota in output, il programma dovrebbe stamparne
+una esplicitamente.
+
address@hidden @code{next}, istruzione, criteri di ricerca
@code{BEGIN}/@code{END} e
address@hidden @code{nextfile}, istruzione, criteri di ricerca
@code{BEGIN}/@code{END} e
address@hidden @code{BEGIN}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
address@hidden @code{END}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
+Per finire, le istruzioni @code{next} e @code{nextfile} non sono consentite
+all'interno di una regola @code{BEGIN}, perch@'e il ciclo implicito
+leggi-un-record-e-confrontalo-con-le-regole non @`e ancora iniziato.
+Analogamente, tali istruzioni non sono valide all'interno di una regola
address@hidden, perch@'e tutto l'input @`e address@hidden stato letto.
+(@xref{Istruzione next} e
address@hidden
address@hidden nextfile}.)
address@hidden ifnotdocbook
address@hidden
address@hidden nextfile}.)
address@hidden ifdocbook
+
address@hidden BEGINFILE/ENDFILE
address@hidden I criteri di ricerca speciali @code{BEGINFILE} ed @code{ENDFILE}
address@hidden @code{BEGINFILE}, criterio di ricerca
address@hidden @code{ENDFILE}, criterio di ricerca
address@hidden differenze tra @command{awk} e @command{gawk}, criteri di
ricerca @code{BEGINFILE}/@code{ENDFILE}
+
+Questa @value{SECTION} descrive una address@hidden specifica di @command{gawk}.
+
+Due tipi speciali di criterio di ricerca, @code{BEGINFILE} ed @code{ENDFILE},
+forniscono
+degli ``agganci'' per intervenire durante il ciclo di elaborazione dei file
+specificati sulla riga di comando di @command{gawk}.
+Come con le regole @code{BEGIN} ed @code{END}
address@hidden
address@hidden
+(@pxref{BEGIN/END}),
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+(si veda la @value{SECTION} precedente),
address@hidden iftex
address@hidden
+(si veda la @value{SECTION} precedente),
address@hidden ifdocbook
+tutte le regole @code{BEGINFILE} in un programma sono riunite, mantenendole
+nell'ordine in cui sono lette da @command{gawk} e lo stesso viene fatto
+per tutte le regole @code{ENDFILE}.
+
+Il corpo delle regole @code{BEGINFILE} @`e eseguito subito prima che
address@hidden legga il primo record da un file. La variabile @code{FILENAME}
address@hidden impostata al nome del file corrente e @code{FNR} @`e impostata a
zero.
+
+La regola @code{BEGINFILE} address@hidden la address@hidden di eseguire due
compiti
+che sarebbe difficile o impossibile effettuare altrimenti:
+
address@hidden @value{BULLET}
address@hidden
+Si address@hidden verificare che il file sia leggibile. Di solito, se un file
presente
+nella riga dei comandi non address@hidden essere aperto in lettura, il
programma
address@hidden viene terminato. Comunque, questo si address@hidden evitare,
per poi
+passare a elaborare il file successivo specificato sulla riga dei comandi.
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile, con criterio di ricerca @code{BEGINFILE}
address@hidden @code{nextfile}, istruzione, criteri di ricerca
@code{BEGINFILE}/@code{ENDFILE} e
+Questo controllo @`e fattibile controllando se la variabile @code{ERRNO} @`e
+diversa dalla stringa nulla; se @`e questo il caso, @command{gawk} non @`e
+riuscito ad aprire il file. In questo caso il programma address@hidden
eseguire
+un'istruzione @code{nextfile}
+(@pxref{Istruzione nextfile}). In questo modo @command{gawk} salta
+completamente l'elaborazione di quel file.
+In caso contrario, @command{gawk} termina come al solito con un
+errore fatale.
+
address@hidden
+Se sono state scritte estensioni che modificano la gestione del record
+(tramite l'inserzione di un ``analizzatore di input'';
address@hidden di input}), @`e possibile richiamarle
+a questo punto, prima che @command{gawk} inizi a elaborare il file.
+(Questa @`e una address@hidden @emph{molto} avanzata, usata al momento solo dal
address@hidden://sourceforge.net/projects/gawkextlib, progetto
@code{gawkextlib}}.)
address@hidden itemize
+
+La regola @code{ENDFILE} @`e chiamata quando @command{gawk} ha finito di
+elaborare l'ultimo record di un file in input. Per l'ultimo file in input,
address@hidden chiamata prima di ogni regola @code{END}.
+La regola @code{ENDFILE} @`e eseguita anche per file in input vuoti.
+
+Normalmente, se si verifica un errore di lettura durante il normale
+ciclo di elaborazione dell'input,
+questo @`e considerato fatale (il programma termina). Tuttavia, se @`e
presente
+una regola @code{ENDFILE}, l'errore non @`e considerato fatale, ma viene
+impostato @code{ERRNO}. address@hidden permette di intercettare ed elaborare
errori
+di I/O a livello di programma @command{awk}.
+
address@hidden @code{next}, istruzione, criteri di ricerca
@code{BEGINFILE}/@code{ENDFILE} e
+L'istruzione @code{next} (@pxref{Istruzione next}) non @`e permessa all'interno
+di una regola @code{BEGINFILE} o @code{ENDFILE}. L'istruzione @code{nextfile}
address@hidden consentita solo all'interno di una regola @code{BEGINFILE}, non
all'interno
+di una regola @code{ENDFILE}.
+
address@hidden @code{getline}, comando, criteri di ricerca
@code{BEGINFILE}/@code{ENDFILE} e
+L'istruzione @code{getline} (@pxref{Getline}) @`e limitata all'interno sia di
address@hidden che di @code{ENDFILE}: solo le forme ridirette di
+di @code{getline} sono permesse.
+
address@hidden ed @code{ENDFILE} sono estensioni @command{gawk}.
+In molte altre implementazioni di @command{awk} o se @command{gawk} @`e in
address@hidden compatibile (@pxref{Opzioni}), non sono regole speciali.
+
address@hidden FIXME: For 4.2 maybe deal with this?
address@hidden
+Date: Tue, 17 May 2011 02:06:10 PDT
+From: address@hidden (Pat Rankin)
+Message-Id: <address@hidden>
+Subject: BEGINFILE
+To: address@hidden
+
+ The documentation for BEGINFILE states that FNR is 0, which seems
+pretty obvious. It doesn't mention what the value of $0 is, and that's
+not obvious. I think setting it to null before starting the BEGINFILE
+action would be preferable to leaving whatever was there in the last
+record of the previous file.
+
+ ENDFILE can retain the last record in $0. I guess it has to if
+the END rule's actions see that value too. But the beginning of a new
+file doesn't just mean that the old one has been closed; the old file
+is being superseded, so leaving the old data around feels wrong to me.
+[If the user wants to keep it on hand, he or she can use an ENDFILE
+rule to grab it before moving on to the next file.]
address@hidden ignore
+
address@hidden Vuoto
address@hidden Il criterio di ricerca vuoto
+
address@hidden vuoto, criterio di ricerca
address@hidden criteri di ricerca vuoti
+Un criterio di ricerca vuoto (address@hidden omesso) corrisponde a
address@hidden record in input. Per esempio, il programma:
+
address@hidden
+awk '@{ print $1 @}' mail-list
address@hidden example
+
address@hidden
+stampa il primo campo di ogni record.
+
address@hidden Usare variabili di shell
address@hidden Usare variabili di shell in programmi
address@hidden shell, variabili di
address@hidden programmi @command{awk}, variabili di shell in
address@hidden @cindex shell and @command{awk} interaction
+
+I programmi @command{awk} sono spesso usati come componenti di programmi
address@hidden
+ampi, scritti in un linguaggio di shell.
+Per esempio, @`e molto comune usare una variabile di shell per
+specificare un criterio di ricerca che il programma @command{awk} deve poi
+individuare.
+Ci sono due modi per rendere disponibile il valore di una variabile di shell
+all'interno di un programma @command{awk}.
+
address@hidden shell, uso di doppio apice
+Un modo comune @`e quello di usare i doppi apici per sostituire il valore della
+variabile nel progamma @command{awk} contenuto nello @dfn{script}:
+
+Per esempio, si consideri il programma seguente:
+
address@hidden
+printf "Immettere il criterio di ricerca: "
+read criterio_di_ricerca
+awk "/$criterio_di_ricerca/ "'@{ num_trov++ @}
+ END @{ print num_trov, "occorrenze trovate" @}' /nome/file/dati
address@hidden example
+
address@hidden
+Il programma @command{awk} consiste di due pezzi di testo tra apici
+che, concatenati insieme, formano il programma.
+La prima parte @`e tra doppi apici, per consentire la sostituzione della
+variabile di shell @code{criterio_di_ricerca} contenuta al loro interno.
+La seconda parte @`e racchiusa tra apici singoli.
+
+La sostituzione di variabile attraverso gli apici funziona, ma address@hidden
+facilmente generare address@hidden Richiede una buona comprensione delle
+regole per l'uso degli apici nella shell
+(@pxref{Protezione}),
+e spesso @`e difficile accoppiare i vari apici quando si legge il programma.
+
+Un metodo migliore @`e quello di usare la address@hidden di assegnamento delle
+variabili di @command{awk}
+(@pxref{Opzioni di assegnamento})
+per assegnare il valore di una variabile di shell a una variabile
+di @command{awk}.
+Poi si possono usare @dfn{regexp} dinamiche come criterio di ricerca
+(@pxref{Espressioni regolari calcolate}).
+Quanto segue mostra come sarebbe l'esempio precedente usando questa tecnica:
+
address@hidden
+printf "Immettere il criterio di ricerca: "
+read criterio_di_ricerca
+awk -v crit="$criterio_di_ricerca" '$0 ~ crit @{ num_trov++ @}
+ END @{ print num_trov, "occorrenze trovate" @}' /nome/file/dati
address@hidden example
+
address@hidden
+Adesso il programma @command{awk} @`e solo una stringa tra apici semplici.
+L'assegnamento @samp{-v crit="$criterio_di_ricerca"} richiede ancora doppi
+apici, per il caso in cui uno spazio vuoto sia presente nel valore di
address@hidden
+La variabile @command{awk} @code{crit} potrebbe avere come nome anche
address@hidden, ma address@hidden potrebbe essere causa di confusione.
+Usare una variabile permette una maggiore address@hidden, poich@'e la variabile
address@hidden essere usata in ogni parte del
+programma---per stamparla, per indicizzare un vettore, o per qualsiasi altro
+scopo---senza che sia necessario l'artificio di doverla inserire usando gli
+apici.
+
address@hidden Panoramica sulle azioni
address@hidden Azioni
address@hidden @cindex action, definition of
address@hidden @cindex curly braces
address@hidden @cindex action, curly braces
address@hidden @cindex action, separating statements
address@hidden azioni
+
+Un programma o script @command{awk} consiste in una serie di
+regole e definizioni di funzione frammiste tra loro. (Le funzioni sono
+descritte address@hidden avanti. @xref{Funzioni definite dall'utente}.)
+Una regola contiene un criterio di ricerca e un'azione; l'uno o l'altra
+(ma non tutt'e due) possono essere omessi. Lo scopo di una @dfn{azione} @`e
+di specificare cosa deve fare @command{awk} quando si trova una corrispondenza
+con il criterio di ricerca. Quindi, schematicamente, un programma
address@hidden @`e normalmente simile a questo:
+
address@hidden
address@hidden di ricerca}] @address@hidden @var{azione} @}}
+ @var{criterio di ricerca} address@hidden@{ @var{azione} @}}]
address@hidden
address@hidden @var{nome}(@var{argomenti}) @{ @dots{} @}}
address@hidden
address@hidden display
+
address@hidden @address@hidden@}} (parentesi graffe), azioni e
address@hidden parentesi graffe (@address@hidden@}}), azioni e
address@hidden separatori, per istruzioni in azioni
address@hidden a capo, separatore di istruzioni nelle azioni
address@hidden @code{;} (punto e virgola), separare istruzioni nelle azioni
address@hidden punto e virgola (@code{;}), separare istruzioni nelle azioni
+Un'azione consiste di una o address@hidden @dfn{istruzioni} @command{awk},
racchiuse
+fra parentesi graffe (@address@hidden@address@hidden@}}). Ogni istruzione
specifica
+una cosa da fare. Le istruzioni sono separate tra loro da dei ritorni a capo o
+da dei punti e virgola.
+Le parentesi graffe attorno a un'azione vanno usate anche se l'azione
+contiene una sola istruzione o se non contiene alcuna istruzione.
+Comunque, se si omette completamente l'azione, si possono omettere anche le
+parentesi graffe. Un'azione omessa @`e equivalente a specificare
address@hidden@{ print $0 @}}:
+
address@hidden
+/pippo/ @{ @} @ii{se si trova @code{pippo}, non fare nulla --- azione
vuota}
+/pippo/ @ii{se si trova @code{pippo}, stampa il record --- azione
omessa}
address@hidden example
+
+I seguenti tipi di istruzione sono disponibili in @command{awk}:
+
address@hidden @asis
address@hidden effetti collaterali delle istruzioni
address@hidden istruzioni, effetti collaterali delle
address@hidden Espressioni
+Servono per chiamare funzioni o assegnare valori a variabili
address@hidden
+(@pxrefil{Espressioni}). L'esecuzione
address@hidden iftex
address@hidden
+(@pxref{Espressioni}). L'esecuzione
address@hidden ifnottex
+di questo tipo di istruzione calcola semplicemente il valore dell'espressione.
address@hidden @`e utile quando l'espressione ha effetti collaterali
+(@pxref{Operatori di assegnamento}).
+
address@hidden Istruzioni di controllo
+Specificano il flusso di controllo dei programmi @command{awk}.
+Il linguaggio @command{awk} utilizza dei costrutti simili a quelli del C,
+(@code{if}, @code{for}, @code{while} e @code{do}), e anche alcune altre
+di tipo speciale (@pxref{Istruzioni}).
+
address@hidden Istruzioni composte
+Sono una o address@hidden istruzioni racchiuse tra parentesi graffe.
Un'istruzione
+composta
address@hidden usata per riunire un gruppo di istruzioni all'interno di
+un'istruzione @code{if}, @code{while}, @code{do} o @code{for}.
+
address@hidden Istruzioni di input
+Usano il comando @code{getline}
+(@pxref{Getline}).
+In @command{awk} sono anche disponibili le istruzioni @code{next}
+(@pxref{Istruzione next})
+e @code{nextfile}
+(@pxref{Istruzione nextfile}).
+
address@hidden Istruzioni di output
+Come @code{print} e @code{printf}.
address@hidden
address@hidden
address@hidden iftex
address@hidden
address@hidden
address@hidden ifnottex
+
address@hidden Istruzioni di cancellazione
+Per eliminare elementi di vettori.
address@hidden
address@hidden table
+
address@hidden Istruzioni
address@hidden Istruzioni di controllo nelle azioni
address@hidden istruzioni di controllo
address@hidden controllo, tramite istruzioni, in azioni
address@hidden azioni, istruzioni di controllo in
+
+Le @dfn{istruzioni di controllo}, come @code{if}, @code{while} e
address@hidden@dotless{i}} via,
+regolano il flusso di esecuzione nei programmi @command{awk}. Molte tra
+le istruzioni di controllo di @command{awk} sono modellate sulle
+corrispondenti istruzioni in C.
address@hidden istruzioni address@hidden istruzioni di controllo e
address@hidden composte, address@hidden istruzioni di controllo e
address@hidden corpo, nelle azioni
address@hidden @address@hidden@}} (parentesi graffe), istruzioni, raggruppare
address@hidden parentesi graffe (@address@hidden@}}), istruzioni, raggruppare
address@hidden a capo, separatore di istruzioni nelle azioni
address@hidden @code{;} (punto e virgola), separare istruzioni nelle azioni
address@hidden punto e virgola (@code{;}), separare istruzioni nelle azioni
+Tutte le istruzioni di controllo iniziano con parole chiave speciali, come
address@hidden e @code{while}, per distinguerle dalle semplici espressioni.
+Molte istruzioni di controllo contengono altre istruzioni. Per esempio,
+l'istruzione @code{if} contiene un'altra istruzione che address@hidden essere
eseguita
+oppure no. Le istruzioni contenute sono chiamate @dfn{corpo}.
+Per includere address@hidden di un'istruzione nel corpo, queste vanno
raggruppate
+in una sola @dfn{istruzione composta} tra parentesi graffe, e separate tra
+loro con dei ritorni a capo o dei punti e virgola.
+
address@hidden
+* Istruzione if:: Eseguire in maniera condizionale
+ istruzioni @command{awk}.
+* Istruzione while:: Eseguire il ciclo finch@'e @`e
+ verificata una condizione.
+* Istruzione do:: Eseguire l'azione specificata, continuare
+ a eseguire il ciclo
+ finch@'e @`e verificata una condizione.
+* Istruzione for:: Un'altra istruzione iterativa, che
+ permette di specificare clausole
+ iniziali e di incremento.
+* Istruzione switch :: Valutazione di quale insieme di
+ istruzioni eseguire, a seconda del
+ valore assunto da una variabile.
+* Istruzione break:: Uscire subito dal ciclo address@hidden interno
+ in cui ci si trova.
+* Istruzione continue:: Andare alla fine del ciclo address@hidden
interno
+ in cui ci si trova.
+* Istruzione next:: Smettere di elaborare il record corrente.
+* Istruzione nextfile:: Smettere di elaborare il file corrente.
+* Istruzione exit:: Interrompere l'esecuzione di @command{awk}.
address@hidden menu
+
address@hidden Istruzione if
address@hidden L'istruzione @address@hidden
+
address@hidden istruzione @code{if}
address@hidden @code{if}, istruzione
+L'istruzione @address@hidden @`e quella che serve in @command{awk}
+per prendere decisioni. @`E simile
+a questa:
+
address@hidden
address@hidden (@var{condizione}) @var{se-vera-fai}} address@hidden
@var{se-falsa-fai}}]
address@hidden display
+
address@hidden
+La @var{condizione} @`e un'espressione che controlla quel che fa il resto
+dell'istruzione. Se la @var{condizione} @`e vera, viene eseguita la
+parte @var{se-vera-fai}; altrimenti viene
+eseguita la parte @var{se-falsa-fai}.
+La parte @code{else} dell'istruzione @`e
+facoltativa. La condizione @`e considerata falsa se il suo valore @`e zero o
+la stringa nulla; altrimenti, la condizione @`e vera.
+Si consideri quanto segue:
+
address@hidden
+if (x % 2 == 0)
+ print "x @`e pari"
+else
+ print "x @`e dispari"
address@hidden example
+
+In questo esempio, se l'espressione @samp{x % 2 == 0} @`e vera (address@hidden,
+se il valore di @code{x} @`e esattamente divisibile per due), allora viene
+eseguita la prima istruzione
address@hidden; altrimenti, viene eseguita la seconda istruzione @code{print}.
+Se la parola chiave @code{else} sta sulla stessa riga di @var{se-vera-fai}
+e se @var{se-vera-fai} non @`e un'istruzione composta (address@hidden, non @`e
racchiusa
+tra parentesi graffe), allora un punto e virgola deve separare
address@hidden dalla parola chiave @code{else}.
+Per chiarire questo, l'esempio precedente si address@hidden riscrivere come:
+
address@hidden
+if (x % 2 == 0) print "x @`e pari"; else
+ print "x @`e dispari"
address@hidden example
+
address@hidden
+Se il @samp{;} @`e omesso, @command{awk} non address@hidden interpretare
l'istruzione e
+segnala un errore di sintassi. Non si dovrebbero scrivere programmi in
+questo modo, perch@'e a chi li legge potrebbe sfuggire la parola chiave
address@hidden se non @`e la prima parola della riga.
+
address@hidden Istruzione while
address@hidden L'istruzione @code{while}
address@hidden @code{while}, istruzione
address@hidden istruzione @code{while}
address@hidden cicli
address@hidden cicli, @code{while}
address@hidden cicli, si veda anche @code{while}, istruzione
+
+Nella programmazione, un @dfn{ciclo} @`e una parte di un programma che
address@hidden
+essere eseguita due o address@hidden volte consecutivamente.
+L'istruzione @code{while} @`e la address@hidden semplice istruzione iterativa
in
address@hidden Esegue ripetutamente un'istruzione finch@'e una data
+condizione @`e vera. Per esempio:
+
address@hidden
+while (@var{condizione})
+ @var{corpo-del-ciclo}
address@hidden example
+
address@hidden corpo, nei cicli
address@hidden
address@hidden @`e un'istruzione detta @dfn{corpo} del ciclo,
+e @var{condizione} @`e un'espressione che controlla per quante volte il ciclo
+deve continuare a essere ripetuto.
+La prima cosa che l'istruzione @code{while} fa @`e un controllo della
address@hidden
+Se la @var{condizione} @`e vera, viene eseguita l'istruzione
address@hidden
address@hidden
+(La @var{condizione} @`e vera quando il suo valore
address@hidden diverso da zero e non @`e la stringa nulla.)
address@hidden ifinfo
+Dopo che le istruzioni in @var{corpo-del-ciclo} sono state eseguite,
address@hidden @`e controllata nuovamente, e se @`e ancora vera,
address@hidden viene eseguito ancora. Questo processo @`e ripetuto
+finch@'e @var{condizione} rimane vera. Se la @var{condizione} @`e falsa fin
+dall'inizio, il corpo del ciclo
+non viene eseguito per nulla, e @command{awk} continua con l'istruzione
+che viene dopo il ciclo.
+Questo esempio stampa i primi tre campi di ogni record in input, uno per
+riga:
+
address@hidden
+awk '
address@hidden
+ i = 1
+ while (i <= 3) @{
+ print $i
+ i++
+ @}
address@hidden' inventory-shipped
address@hidden example
+
address@hidden
+Il corpo di questo ciclo @`e un'istruzione composta racchiusa tra parentesi
graffe,
+che contiene due istruzioni.
+Il ciclo funziona in questo modo: all'inizio, il valore di @code{i} @`e
+impostato a 1.
+Poi, l'istruzione @code{while} controlla se @code{i} @`e minore o uguale a
+tre. address@hidden @`e vero quando @code{i} @`e uguale a 1, quindi il campo
address@hidden viene stampato. Quindi l'istruzione @samp{i++} incrementa il
+valore di @code{i}
+e il ciclo viene ripetuto. Il ciclo termina quando @code{i} assume il
+valore quattro.
+
+Un ritorno a capo non @`e richiesto tra la condizione e il corpo del ciclo;
+tuttavia, se lo si mette, il programma @`e di address@hidden facile
comprensione,
+a meno che il corpo del ciclo non sia un'istruzione composta, oppure se @`e
+qualcosa di molto semplice. Neppure il ritorno a capo dopo la parentesi graffa
+aperta che inizia l'istruzione composta @`e necessario, ma il
+programma @`e di lettura address@hidden difficile se lo si omette.
+
address@hidden Istruzione do
address@hidden L'istruzione @address@hidden
address@hidden @address@hidden
address@hidden cicli, @address@hidden
+
+Il ciclo @code{do} @`e una variazione dell'istruzione di ciclo @code{while}.
+Il ciclo @code{do} esegue il @var{corpo-del-ciclo} una volta e poi ripete il
address@hidden finch@'e la @var{condizione} rimane vera. @`E simile a questo:
address@hidden
+do
+ @var{corpo-del-ciclo}
+while (@var{condizione})
address@hidden example
+
+Anche se la @var{condizione} @`e falsa fin dall'inizio, il
@var{corpo-del-ciclo}
+viene eseguito almeno una volta (e solo una volta, a meno che
+l'esecuzione di @var{corpo-del-ciclo}
+non renda vera la @var{condizione}). Si confronti con il corrispondente
address@hidden:
+
address@hidden
+while (@var{condizione})
+ @var{corpo-del-ciclo}
address@hidden example
+
address@hidden
+Quest'istruzione non esegue il @var{corpo-del-ciclo} neppure una volta, se
+la @var{condizione} @`e falsa fin dall'inizio. Il seguente @`e un esempio di
address@hidden:
+
address@hidden
address@hidden
+ i = 1
+ do @{
+ print $0
+ i++
+ @} while (i <= 10)
address@hidden
address@hidden example
+
address@hidden
+Questo programma stampa ogni record in input per 10 volte. Non si tratta,
+peraltro, di un esempio molto realistico, perch@'e in questo caso un semplice
address@hidden sarebbe sufficiente. Questa osservazione riflette un'esperienza
+reale; solo occasionalmente @`e davvero necessario usare un @code{do}.
+
address@hidden Istruzione for
address@hidden L'istruzione @code{for}
address@hidden istruzione @code{for}
address@hidden @code{for}, istruzione
address@hidden cicli, @code{for}, iterativi
+
+L'istruzione @code{for} rende address@hidden agevole contare le iterazioni di
un ciclo.
+La forma generale dell'istruzione @code{for} @`e simile a questa:
+
address@hidden
+for (@var{inizializzazione}; @var{condizione}; @var{incremento})
+ @var{corpo-del-ciclo}
address@hidden example
+
address@hidden
+La parti @var{inizializzazione}, @var{condizione} e @var{incremento} sono
+espressioni @command{awk} a piacere, e @var{corpo-del-ciclo} indica qualsiasi
+istruzione @command{awk}.
+
+L'istruzione @code{for} comincia con l'esecuzione di @var{inizializzazione}.
+Poi, finch@'e
+la @var{condizione} @`e vera, esegue ripetutamente @var{corpo-del-ciclo},
+e quindi @var{incremento}. Tipicamente, @var{inizializzazione} imposta una
+variabile a zero o a uno, @var{incremento} aggiunge uno alla stessa e
address@hidden ne confronta il valore rispetto al numero desiderato di
+iterazioni.
+Per esempio:
+
address@hidden
+awk '
address@hidden
+ for (i = 1; i <= 3; i++)
+ print $i
address@hidden' inventory-shipped
address@hidden example
+
address@hidden
+Questo programma stampa i primi tre campi di ogni record in input, mettendo
+un campo su ogni riga.
+
+Non @`e possibile impostare
address@hidden di una variabile nella parte di
address@hidden senza usare un'istruzione di assegnamento multiplo,
+come @samp{x = y = 0}. address@hidden ha senso solo se tutti i valori iniziali
+sono uguali. (Ma @`e possibile inizializzare ulteriori variabili scrivendo
+i relativi assegnamenti come istruzioni separate @emph{prima} del ciclo
address@hidden)
+
address@hidden @cindex comma operator, not supported
+Lo stesso vale per la parte @var{incremento}. Se serve incrementare ulteriori
+variabili, questo va fatto con istruzioni separate alla fine del ciclo.
+L'espressione composta del linguaggio C, che usa l'operatore virgola [,]
+del C, sarebbe
+utile in questo contesto, ma non @`e
+prevista in @command{awk}.
+
+Molto spesso, @var{incremento} @`e un'espressione di incremento, come
+nell'esempio precedente. Ma questo non @`e obbligatorio; address@hidden
trattarsi di
+un'espressione qualsiasi. Per esempio,
+la seguente istruzione stampa tutte le potenze di due comprese
+tra 1 e 100:
+
address@hidden
+for (i = 1; i <= 100; i *= 2)
+ print i
address@hidden example
+
+Se non @`e necessaria, ognuna delle tre espressioni fra
+parentesi che segue la parola chiave @code{for} address@hidden essere omessa.
Quindi,
address@hidden@samp{for (; x > 0;)}} @`e equivalente a @address@hidden (x >
0)}}. Se la
address@hidden @`e omessa del tutto, @`e ritenuta sempre vera, producendo
+un @dfn{ciclo infinito} (address@hidden, un ciclo che non finisce mai).
+
+Molto spesso, un ciclo @code{for} @`e un'abbreviazione per un ciclo
@code{while},
+come si address@hidden vedere qui:
+
address@hidden
address@hidden
+while (@var{condizione}) @{
+ @var{corpo-del-ciclo}
+ @var{incremento}
address@hidden
address@hidden example
+
address@hidden cicli, istruzione @code{continue} e
address@hidden
+La sola eccezione @`e quando l'istruzione @code{continue}
+(@pxref{Istruzione continue}) @`e usata
+all'interno del ciclo. Se si modifica un'istruzione @code{for}
+sostituendola con un'istruzione @code{while}
address@hidden address@hidden cambiare l'effetto dell'istruzione
@code{continue} posta all'interno
+del ciclo.
+
+Il linguaggio @command{awk} ha un'istruzione @code{for} oltre all'istruzione
address@hidden perch@'e un ciclo @code{for} @`e spesso address@hidden semplice
da scrivere,
+e viene in mente address@hidden naturalmente.
+Contare il numero di iterazioni @`e
+molto frequente nei cicli. address@hidden essere address@hidden facile
pensare a questo conto come
+parte del ciclo, piuttosto che come qualcosa da fare all'interno del ciclo.
+
address@hidden @code{in}, operatore
address@hidden operatore @code{in}
+Esiste una versione alternativa al ciclo @code{for}, per esaminare tutti
+gli indici di un vettore:
+
address@hidden
+for (i in vettore)
+ @var{fai qualcosa con} vettore[i]
address@hidden example
+
address@hidden
address@hidden un intero vettore}
+per maggiori informazioni su questa versione del ciclo @code{for}.
+
address@hidden Istruzione switch
address@hidden L'istruzione @code{switch}
address@hidden @code{switch}, istruzione
address@hidden @code{case}, parola chiave
address@hidden parola chiave @code{case}
address@hidden @code{default}, parola chiave
address@hidden parola chiave @code{default}
+
+Questa @value{SECTION} descrive una address@hidden disponibile solo in
address@hidden
+Se @command{gawk} @`e in address@hidden compatibile (@pxref{Opzioni}),
+la address@hidden non @`e disponibile.
+
+L'istruzione @code{switch} consente di valutare un'espressione e di
+eseguire istruzioni se il valore trovato corrisponde a uno dei @code{case}
[casi] previsti.
+Le istruzioni @code{case} sono esaminate per cercare una corrispondenza
+nell'ordine in cui i casi sono definiti nel programma. Se nessuno dei
@code{case}
+corrisponde al valore dell'espressione, viene eseguita la sezione
address@hidden, se @`e stata specificata.
+
+Ogni @code{case} contiene una singola costante, che address@hidden essere un
numero,
+una stringa, o
+una @dfn{regexp}. Viene valutata l'espressione @code{switch}, e poi la
+costante di ogni @code{case} viene confrontata
+di volta in volta con il valore risultante.
+Il tipo di costante determina quale address@hidden il confronto: per i tipi
numerici o
+stringa si seguono le regole abituali. Per una costante @dfn{regexp} viene
+effettuato un confronto tra l'espressione e il valore di tipo stringa
+dell'espressione originale.
+Il formato generale dell'istruzione @code{switch} @`e simile a questo:
+
address@hidden
+switch (@var{espressione}) @{
+case @var{valore o espressione regolare}:
+ @var{corpo-del-caso}
+default:
+ @var{corpo-del-default}
address@hidden
address@hidden example
+
+Il flusso di controllo
+dell'istruzione @code{switch} funziona come per il linguaggio C. Una volta
+stabilita una corrispondenza con un dato caso, le istruzione che formano il
+corpo del caso sono eseguite, fino a che non venga trovata un'istruzione
address@hidden,
address@hidden, @code{next}, @code{nextfile} o @code{exit},
+o fino alla fine dell'istruzione @code{switch} medesima. Per esempio:
+
address@hidden
+while ((c = getopt(ARGC, ARGV, "aksx")) != -1) @{
+ switch (c) @{
+ case "a":
+ # stampa la dimensione di tutti i file
+ all_files = TRUE;
+ break
+ case "k":
+ BLOCK_SIZE = 1024 # in blocchi da 1 Kbyte
+ break
+ case "s":
+ # fa solo le somme
+ sum_only = TRUE
+ break
+ case "x":
+ # non esce dal filesystem
+ fts_flags = or(fts_flags, FTS_XDEV)
+ break
+ case "?":
+ default:
+ uso()
+ break
+ @}
address@hidden
address@hidden example
+
+Si noti che se nessuna delle istruzioni specificate qui arresta l'esecuzione
+di un'istruzione @code{case} per la quale @`e stata trovata una corrispondenza;
+l'esecuzione continua fino al successivo @code{case} finch@'e
+non viene interrotta. In questo esempio, il
address@hidden per @code{"?"} esegue quello di @code{default}, che consiste nel
+chiamare una funzione di nome @code{uso()}.
+(La funzione @code{getopt()} qui chiamata @`e descritta in
address@hidden getopt}.)
+
address@hidden Istruzione break
address@hidden L'istruzione @code{break}
address@hidden @code{break}, istruzione
address@hidden istruzione @code{break}
address@hidden cicli, uscita
address@hidden cicli, istruzione @code{break} e
+
+L'istruzione @code{break} esce dal ciclo address@hidden interno @code{for},
address@hidden o @code{do} dentro al quale si trova. L'esempio seguente
+trova, se esiste, il divisore address@hidden piccolo di un dato numero intero,
oppure
+dichiara che si tratta di un numero primo:
+
address@hidden
+# trova il divisore address@hidden piccolo di num
address@hidden
+ num = $1
+ for (divisore = 2; divisore * divisore <= num; divisore++) @{
+ if (num % divisore == 0)
+ break
+ @}
+ if (num % divisore == 0)
+ printf "Il address@hidden piccolo divisore di %d @`e %d\n", num,
divisore
+ else
+ printf "%d @`e un numero primo\n", num
address@hidden
address@hidden example
+
+Quando il resto della divisione @`e zero nella prima istruzione @code{if},
address@hidden immediatamente esce, a causa del @dfn{break}, dal ciclo
address@hidden in cui @`e contenuto. address@hidden vuol dire
+che @command{awk} prosegue immediatamente fino all'istruzione che viene dopo
+il ciclo, e continua l'elaborazione. (L'istruzione @code{break} @`e molto
+differente dall'istruzione @code{exit},
+la quale termina l'intero programma @command{awk}.
address@hidden exit}.)
+
+Il seguente programma mostra come la @var{condizione} di un'istruzione
address@hidden o @code{while} potrebbe essere sostituita da un'istruzione
address@hidden all'interno di un @code{if}:
+
address@hidden
+# trova il divisore address@hidden piccolo di num
address@hidden
+ num = $1
+ for (divisore = 2; ; divisore++) @{
+ if (num % divisore == 0) @{
+ printf "Il address@hidden piccolo divisore di %d @`e %d\n", num,
divisore
+ break
+ @}
+ if (divisore * divisore > num) @{
+ printf "%d @`e un numero primo\n", num
+ break
+ @}
+ @}
address@hidden
address@hidden example
+
+L'istruzione @code{break} @`e usata anche per terminare l'esecuzione di
+un'istruzione @code{switch}.
+Questo argomento @`e trattato in @ref{Istruzione switch}.
+
address@hidden @cindex @code{break}, outside of loops
address@hidden @cindex historical features
address@hidden @cindex @command{awk} language, POSIX version
address@hidden POSIX @command{awk}, @code{break} e
address@hidden angolo buio, istruzione @code{break}
address@hidden @command{gawk}, istruzione @code{break} in
address@hidden Brian Kernighan, @command{awk} di
+L'istruzione @code{break} non ha significato se
+usata fuori dal corpo di un ciclo o di un'istruzione @code{switch}.
+Tuttavia, anche se la cosa non @`e mai stata documentata,
+le prime implementazioni di @command{awk} consideravano l'istruzione
@code{break}
+esterna a un ciclo come un'istruzione @code{next}
+(@pxref{Istruzione next}).
address@hidden
+Versioni recenti di BWK @command{awk} non consentono address@hidden un tale
uso,
+e lo stesso fa @command{gawk}.
+
address@hidden Istruzione continue
address@hidden L'istruzione @code{continue}
+
address@hidden @code{continue}, istruzione
address@hidden istruzione @code{continue}
+Analogamente a @code{break}, l'istruzione @code{continue} @`e usata solo
+all'interno di cicli @code{for}, @code{while} e @code{do}. L'istruzione
+ignora il resto del corpo del ciclo, facendo address@hidden@dotless{i}} che la
successiva iterazione
+del ciclo inizi immediatamente. Questo comportamento @`e differente da quello
+di @code{break}, che esce completamente dal ciclo.
+
+L'istruzione @code{continue} in un ciclo @code{for} fa
address@hidden@dotless{i}} che @command{awk}
+ignori il resto del corpo del ciclo e prosegua l'esecuzione con l'espressione
address@hidden dell'istruzione @code{for}. Il seguente programma
address@hidden un esempio di address@hidden:
+
address@hidden
+BEGIN @{
+ for (x = 0; x <= 20; x++) @{
+ if (x == 5)
+ continue
+ printf "%d ", x
+ @}
+ print ""
address@hidden
address@hidden example
+
address@hidden
+Questo programma stampa tutti i numeri da 0 a 20---tranne il 5, in cui
+l'istruzione @code{printf} @`e saltata. Siccome l'incremento @samp{x++}
+non viene saltato, @code{x} non rimane fermo al valore 5. Si confronti il
ciclo
address@hidden dell'esempio precedente con il seguente ciclo @code{while}:
+
address@hidden
+BEGIN @{
+ x = 0
+ while (x <= 20) @{
+ if (x == 5)
+ continue
+ printf "%d ", x
+ x++
+ @}
+ print ""
address@hidden
address@hidden example
+
address@hidden
+Questo programma inizia un ciclo infinito dopo che @code{x} ha assunto il
+valore 5, poich@'e l'istruzione di incremento (@samp{x++}) non @`e mai
raggiunta.
+
address@hidden @cindex @code{continue}, fuori da un ciclo
address@hidden @cindex address@hidden del passato
address@hidden @cindex linguaggio @command{awk}, versione POSIX
address@hidden POSIX @command{awk}, istruzione @code{continue} e
address@hidden angolo buio, istruzione @code{continue}
address@hidden @command{gawk}, istruzione @code{continue} in
address@hidden Brian Kernighan, @command{awk} di
+L'istruzione @code{continue} non ha un significato speciale se appare in
+un'istruzione @code{switch}, e non ha alcun significato se usata fuori dal
+corpo di un ciclo. Le prime versioni di @command{awk} trattavano le
+istruzioni @code{continue} che erano fuori da un ciclo allo stesso modo con
+cui trattavano l'istruzione @code{break}
+fuori da un ciclo: come se fosse un'istruzione @code{next}
address@hidden FOR_PRINT
+(trattata nella @value{SECTION} seguente).
address@hidden ifset
address@hidden FOR_PRINT
+(@pxref{Istruzione next}).
address@hidden ifclear
address@hidden
+Versioni recenti di BWK @command{awk} non consentono address@hidden un tale
uso,
+e lo stesso vale per @command{gawk}.
+
address@hidden Istruzione next
address@hidden L'istruzione @code{next}
address@hidden @code{next}, istruzione
address@hidden istruzione @code{next}
+
+L'istruzione @code{next} fa address@hidden@dotless{i}} che @command{awk}
termini immediatamente
+l'elaborazione del record corrente e proceda a elaborare il record successivo.
address@hidden vuol dire che nessuna delle eventuali regole successive viene
eseguita
+per il record corrente e che il resto delle azioni presenti nella
+regola correntemente in esecuzione non viene eseguito.
+
+Si confronti quanto sopra con quel che fa la funzione @code{getline}
+(@pxref{Getline}). Anch'essa fa address@hidden@dotless{i}} che @command{awk}
legga il record
+successivo immediatamente, ma non altera il flusso del controllo in alcun
+modo (address@hidden, il resto dell'azione in esecuzione prosegue con il nuovo
record
+in input).
+
address@hidden @command{awk}, programmi, eseguire
+Al livello address@hidden alto, l'esecuzione di un programma @command{awk} @`e
un ciclo
+che legge un record in input e quindi confronta il criterio di ricerca di
+ciascuna regola con il record stesso. Se si vede questo ciclo come un
address@hidden il cui corpo contiene le regole, l'istruzione @code{next} @`e
analoga
+a un'istruzione @code{continue}. Salta, address@hidden, alla fine del corpo
di questo
+ciclo implicito
+ed esegue l'incremento (ovvero legge un altro record).
+
+Per esempio, si supponga che un programma @command{awk} agisca solo su record
+che hanno quattro campi, e che non dovrebbe terminare con un errore se trova
+dei record in input non validi. Per evitare di complicare il resto del
+programma, si address@hidden scrivere una regola ``filtro'' a inizio
programma, come
+mostrato in questo esempio:
+
address@hidden
+NF != 4 @{
+ printf("%s:%d: salto: NF != 4\n", FILENAME, FNR) > "/dev/stderr"
+ next
address@hidden
address@hidden example
+
address@hidden
+Siccome @`e presente un @code{next},
+le regole successive del programma non elaboreranno i record non validi.
+Il messaggio @`e ridiretto al flusso in output
address@hidden error}, sul quale vanno scritti i messaggi di errore.
+Per maggiori dettagli, si veda
address@hidden speciali}.
+
+Se l'istruzione @code{next} provoca il raggiungimento della fine del file
+in input, vengono eseguite le eventuali regole @code{END} presenti.
address@hidden/END}.
+
+L'istruzione @code{next} non @`e consentita all'interno delle regole
address@hidden ed @code{ENDFILE}.
address@hidden/ENDFILE}.
+
address@hidden @cindex @command{awk} language, POSIX version
address@hidden @cindex @code{next}, inside a user-defined function
address@hidden @code{BEGIN}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
address@hidden @code{END}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
address@hidden POSIX @command{awk}, istruzioni @code{next}/@code{nextfile} e
address@hidden @code{next}, istruzione, in funzioni definite dall'utente
address@hidden funzioni definite dall'utente, istruzioni
@code{next}/@code{nextfile} e
+Secondo lo standard POSIX, il comportamento di @command{awk} @`e indefinito
+se @code{next} @`e usato in una regola @code{BEGIN} o @code{END}.
address@hidden considera questo come un errore di sintassi. Sebbene POSIX
+non proibisca di usarlo,
+molte altre implementazioni di @command{awk} non consentono che l'istruzione
address@hidden sia usata all'interno del corpo di funzioni.
+(@pxref{Funzioni definite dall'utente}).
+Come tutte le altre istruzioni @code{next}, un'istruzione @code{next}
all'interno del
+corpo di una funzione legge il record successivo e inizia a elaborarlo
+a partire dalla prima regola del programma.
+
address@hidden Istruzione nextfile
address@hidden L'istruzione @code{nextfile}
address@hidden @code{nextfile}, istruzione
address@hidden istruzione @code{nextfile}
+
+L'istruzione @code{nextfile}
address@hidden simile all'istruzione @code{next}.
+Tuttavia, invece di terminare l'elaborazione del record corrente, l'istruzione
address@hidden richiede ad @command{awk} di terminare di elaborare il
address@hidden corrente.
+
+Alla fine dell'esecuzione dell'istruzione @code{nextfile},
address@hidden @`e
+aggiornato per contenere il nome del successivo @value{DF} elencato sulla riga
+di comando, @code{FNR} @`e reimpostato a uno, e l'elaborazione riparte con
+la prima regola del programma.
+Se l'istruzione @code{nextfile} raggiunge la fine dei file in input,
+vengono eseguite le eventuali regole @code{END} presenti.
+Un'eccezione a questo si ha se @code{nextfile} @`e invocata durante
+l'esecuzione di qualche istruzione all'interno di una regola @code{END};
+in questo caso, il programma viene terminato immediatamente.
address@hidden/END}.
+
+L'istruzione @code{nextfile} @`e utile quando ci sono parecchi @value{DF} da
+elaborare, ma non @`e necessario elaborare ogni record in ogni file.
+Senza @code{nextfile},
+per passare al successivo @value{DF}, un programma
+dovrebbe continuare a leggere i record che non gli servono. L'istruzione
address@hidden @`e una maniera molto address@hidden efficiente per ottenere lo
stesso
+risultato.
+
+In @command{gawk}, l'esecuzione di @code{nextfile} produce ulteriori effetti:
+le eventuali regole @code{ENDFILE}
+sono eseguite se @command{gawk} non
+si trova correntemente all'interno di una regola @code{END} o
address@hidden; @code{ARGIND} @`e
+incrementato e le eventuali regole @code{BEGINFILE} sono eseguite.
+(@code{ARGIND} non @`e stato ancora trattato.
address@hidden predefinite}.)
+
+In @command{gawk}, @code{nextfile} @`e utile all'interno di una regola
address@hidden per evitare di elaborare un file che altrimenti causerebbe
+un errore fatale in @command{gawk}.
+In questo caso, le regole @code{ENDFILE} non vengono eseguite.
address@hidden/ENDFILE}.
+
+Sebbene possa sembrare che @samp{close(FILENAME)} ottenga lo stesso
+risultato di @code{nextfile}, non @`e address@hidden@dotless{i}}.
@code{close()}
address@hidden essere usato solo per chiudere file, @dfn{pipe} e coprocessi che
siano
+stati aperti tramite ridirezioni. Non ha niente a che vedere con
+l'elaborazione principale che
address@hidden fa dei file elencati in @code{ARGV}.
+
address@hidden NOTA
+Per molti anni, @code{nextfile} @`e stata
+un'estensione comune. A settembre 2012 si @`e deciso di
+includerla nello standard POSIX.
+Si veda @uref{http://austingroupbugs.net/view.php?id=607, il sito web
dell'Austin Group}.
address@hidden quotation
+
address@hidden funzioni definite dall'utente, istruzioni
@code{next}/@code{nextfile} e
address@hidden @code{nextfile}, in funzioni definite dall'utente
address@hidden Brian Kernighan, @command{awk} di
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
+Le versioni correnti di BWK @command{awk} e @command{mawk}
+entrambe prevedono @code{nextfile}. Tuttavia, non sono consentite istruzioni
address@hidden all'interno del corpo delle funzioni
+(@pxref{Funzioni definite dall'utente}).
address@hidden lo permette; una @code{nextfile} all'interno del corpo di una
+funzione legge il primo record del file
+successivo e inizia l'elaborazione dello stesso
+a partire dalla prima regola del programma, esattamente come farebbe
+qualsiasi altra istruzione @code{nextfile}.
+
address@hidden Istruzione exit
address@hidden L'istruzione @code{exit}
+
address@hidden @code{exit}, istruzione
address@hidden istruzione @code{exit}
+L'istruzione @code{exit} fa address@hidden@dotless{i}} che @command{awk}
termini immediatamente
+l'esecuzione della regola corrente e che termini di elaborare l'input;
+qualsiasi input ancora da elaborare @`e ignorato. L'istruzione @code{exit} @`e
+scritta come segue:
+
address@hidden
address@hidden address@hidden di ritorno}]
address@hidden display
+
address@hidden @code{BEGIN}, criterio di ricerca, istruzione @code{exit} e
address@hidden criterio di ricerca @code{BEGIN}, istruzione @code{exit} e
address@hidden @code{END}, criterio di ricerca, istruzione @code{exit} e
address@hidden criterio di ricerca @code{END}, istruzione @code{exit} e
+Quando un'istruzione @code{exit} @`e eseguita all'interno di una regola
@code{BEGIN},
+il programma termina completamente l'elaborazione. Nessun record in input
+viene letto. Tuttavia, se una regola @code{END} @`e presente, come parte
+dell'esecuzione dell'istruzione @code{exit},
+la regola @code{END} viene eseguita
+(@pxref{BEGIN/END}).
+Se @code{exit} @`e usata nel corpo di una regola @code{END},
+il programma termina immediatamente.
+
+Un'istruzione @code{exit} che non fa parte di una regola @code{BEGIN} o
@code{END}
+termina l'esecuzione di qualsiasi ulteriore regola applicabile al record
+corrente, salta la lettura di qualsiasi record in input, ed esegue
+le eventuali regole @code{END}. @command{gawk} salta anche le eventuali regole
address@hidden, che non vengono eseguite.
+
+In questo caso,
+se non si desidera che la regola @code{END} venga eseguita, si deve impostare
+una variabile a un valore diverso da zero, prima di invocare l'istruzione
address@hidden e controllarne il valore nella regola @code{END}.
address@hidden assert}
+per un esempio di questo tipo.
+
address@hidden angolo buio, istruzione @code{exit}
+Se si specifica un argomento all'istruzione @code{exit}, il suo valore @`e
+usato come codice di ritorno finale dell'elaborazione @command{awk}. Se non
+viene specificato alcun argomento,
address@hidden fa terminare @command{awk} con un codice di ritorno di
+``successo''.
+Nel caso in cui un argomento
+sia specificato in una prima istruzione @code{exit} e poi @code{exit} sia
+chiamato una seconda volta all'interno di una regola @code{END} senza alcun
+argomento, @command{awk} usa il valore di ritorno specificato in precedenza.
address@hidden
address@hidden di ritorno} per maggiori informazioni.
+
address@hidden convenzioni di programmazione, istruzione @code{exit}
+Per esempio, si supponga che si sia verificata una condizione di errore
+difficile o impossibile da gestire. Convenzionalmente, i programmi la
+segnalano terminando con un codice di ritorno diverso da zero. Un programma
address@hidden address@hidden farlo usando un'istruzione @code{exit} con un
argomento
+diverso da zero, come mostrato nell'esempio seguente:
+
address@hidden
+BEGIN @{
+ if (("date" | getline data_corrente) <= 0) @{
+ print "Non riesco a ottenere la data dal sistema" > "/dev/stderr"
+ exit 1
+ @}
+ print "la data corrente @`e", data_corrente
+ close("date")
address@hidden
address@hidden example
+
address@hidden NOTA
+Per una completa address@hidden, i codici di ritorno dovrebbero essere compresi
+tra zero e 126, estremi compresi.
+Valori negativi e valori maggiori o uguali a 127, possono non generare
+risultati coerenti tra loro in sistemi operativi diversi.
address@hidden quotation
+
+
address@hidden Variabili predefinite
address@hidden Variabili predefinite
address@hidden predefinite, variabili
address@hidden variabili predefinite
+
+La maggior parte delle variabili @command{awk} sono disponibili per essere
+usate dall'utente secondo le proprie esigenze;
+queste variabili non cambiano mai di valore a meno che il
+programma non assegni loro dei valori, e non hanno alcuna influenza sul
+programma a meno che non si decida di utilizzarle nel programma.
+Tuttavia, alcune variabili in @command{awk} hanno dei significati speciali
+predefiniti.
address@hidden tiene conto di alcune di queste automaticamente, in modo da
+rendere possibile la richiesta ad @command{awk} di fare certe cose nella
+maniera desiderata. Altre variabili sono impostate automaticamente da
address@hidden, in modo da poter comunicare al programma in esecuzione
+informazioni sul modo di procedere interno di @command{awk}.
+
address@hidden @command{gawk}, variabili predefinite e
+Questa @value{SECTION} documenta tutte le variabili predefinite di
address@hidden; molte di queste variabili sono anche documentate nei
address@hidden che descrivono le loro aree di influenza.
+
address@hidden
+* Variabili modificabili dall'utente:: Variabili predefinite modificabili per
+ controllare @command{awk}.
+* Variabili auto-assegnate:: Variabili predefinite con cui
+ @command{awk} fornisce informazioni.
+* ARGC e ARGV:: Modi di usare @code{ARGC} e @code{ARGV}.
address@hidden menu
+
address@hidden Variabili modificabili dall'utente
address@hidden Variabili predefinite modificabili per controllare @command{awk}
address@hidden variabili predefinite, modificabili dall'utente
address@hidden modificabili dall'utente, variabili
+
+La seguente @`e una lista alfabetica di variabili che @`e possibile modificare
per
+controllare come @command{awk} gestisce alcuni compiti.
+
+Le variabili che sono specifiche di @command{gawk} sono contrassegnate da un
+cancelletto (@samp{#}). Queste variabili sono estensioni @command{gawk}.
+In altre implementazioni di @command{awk}, o se @command{gawk} @`e eseguito in
address@hidden compatibile
+(@pxref{Opzioni}), non hanno un significato speciale. (Eventuali eccezioni
+sono menzionate nella descrizione di ogni variabile.)
+
address@hidden @code
address@hidden @code{BINMODE}, variabile
address@hidden variabile @code{BINMODE}
address@hidden binario, input/output
address@hidden input/output binario
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{BINMODE}
address@hidden BINMODE #
+Su sistemi non-POSIX, questa variabile specifica l'uso della address@hidden
binaria
+per tutto l'I/O. I valori numerici di uno, due o tre specificano che i file
+in input, i file di output o tutti i file, rispettivamente, devono usare I/O
+binario.
+Un valore numerico inferiore a zero @`e trattato come zero e un valore
+numerico maggiore di tre @`e trattato
+come tre. Alternativamente, le stringhe @code{"r"} o @code{"w"} specificano
+che i file in input e i file in output,
+rispettivamente, devono usare
+I/O binario. Una stringa @code{"rw"} o @code{"wr"} indica che tutti i file
+devono usare I/O binario. Ogni altro valore di stringa @`e trattato come
address@hidden"rw"}, ma @command{gawk} genera un messaggio di avvertimento.
address@hidden @`e descritto in maggior
+dettaglio in @ref{Uso su PC}. @command{mawk} (@pxref{Altre versioni})
+prevede questa variabile, ma consente solo valori numerici.
+
address@hidden @code{CONVFMT}, variabile
address@hidden variabile @code{CONVFMT}
address@hidden POSIX @command{awk}, variabile @code{CONVFMT} e
address@hidden numeri, conversione in stringhe
address@hidden stringhe, conversione in numeri
address@hidden @code{CONVFMT}
+Una stringa che controlla la conversione di numeri in
+stringhe (@pxref{Conversione}).
+In effetti @`e la stringa passata come primo argomento alla funzione
address@hidden()}
+(@pxref{Funzioni per stringhe}).
+Il suo valore di default @`e @code{"%.6g"}.
address@hidden @`e stata introdotta dallo standard POSIX.
+
address@hidden @command{gawk}, variabile @code{FIELDWIDTHS} in
address@hidden @code{FIELDWIDTHS}, variabile
address@hidden variabile @code{FIELDWIDTHS}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{FIELDWIDTHS}
address@hidden separatori di campo, variabile @code{FIELDWIDTHS} e
address@hidden campo, separatori di, variabile @code{FIELDWIDTHS} e
address@hidden FIELDWIDTHS #
+Una lista di posizioni di colonna, separate da spazi, per dire a
address@hidden
+come dividere campi in input posti su colonne fisse.
+Assegnando un valore a @code{FIELDWIDTHS}, le variabili @code{FS} e
address@hidden
address@hidden vengono usate per effettuare la divisione in campi.
address@hidden costante} per maggiori informazioni.
+
address@hidden @command{gawk}, variabile @code{FPAT} in
address@hidden @code{FPAT}, variabile
address@hidden variabile @code{FPAT}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{FPAT}
address@hidden separatori di campo, variabile @code{FPAT} e
address@hidden campo, separatori di, variabile @code{FPAT} e
address@hidden FPAT #
+Un'espressione regolare (di tipo stringa) per dire a @command{gawk}
+di creare i campi utilizzando come delimitatore il testo che corrisponde
+all'espressione regolare.
+Assegnando un valore a @code{FPAT}
+le variabili @code{FS} e @code{FIELDWIDTHS}
address@hidden vengono usate per effettuare la divisione in campi.
address@hidden in base al contenuto} per maggiori informazioni.
+
address@hidden @code{FS}, variabile
address@hidden variabile @code{FS}
address@hidden campo, separatori di
address@hidden separatori di campo
address@hidden FS
+Il separatore dei campi in input (@pxref{Separatori di campo}).
+Il valore address@hidden essere una stringa di un solo carattere o
un'espressione
+regolare composta da address@hidden caratteri che individua il separatore tra
i campi
+dei record in input. Se il suo valore
address@hidden la stringa nulla (@code{""}),
+ogni singolo carattere del record costituisce un campo.
+(Questo comportamente @`e un'estensione @command{gawk}. POSIX @command{awk} non
+specifica il comportamento quando @code{FS} @`e la stringa nulla.
+Nonostante questo, alcune altre versioni di @command{awk} trattano @code{""}
+in modo speciale.)
+
address@hidden POSIX @command{awk}, variabile @code{FS} e
+Il valore di default @`e @address@hidden" "}}, una stringa consistente in un
singolo
+spazio. In via eccezionale, questo valore significa che qualsiasi sequenza
+di spazi, TAB, e/o ritorni a capo costituisce
+un solo separatore.
+Inoltre eventuali spazi, TAB e ritorni a capo all'inizio e alla fine
+del record in input vengono ignorati.
+
+Si address@hidden impostare il valore di @code{FS} sulla riga dei comandi
usando
+l'opzione @option{-F}:
+
address@hidden
+awk -F, '@var{programma}' @var{file-in-input}
address@hidden example
+
address@hidden @command{gawk}, separatori di campo e
+Se @command{gawk} sta usando @code{FIELDWIDTHS} o @code{FPAT}
+per separare i campi,
+assegnare un valore a @code{FS} fa address@hidden@dotless{i}} che
@command{gawk} torni alla
+separazione dei campi normale, fatta utilizzando la variabile @code{FS}.
+Un modo semplice per fare questo
address@hidden semplicemente quello di scrivere l'istruzione
address@hidden = FS}, aggiungendo magari un commento esplicativo.
+
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden @code{IGNORECASE}, variabile
address@hidden variabile @code{IGNORECASE}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{IGNORECASE}
address@hidden maiuscolo/minuscolo e confronti tra stringhe
address@hidden maiuscolo/minuscolo e @dfn{regexp}
address@hidden espressioni regolari, maiuscolo/minuscolo
address@hidden IGNORECASE #
+Se la variabile @code{IGNORECASE} @`e diversa da zero o dalla stringa nulla,
+tutti i confronti tra stringhe
+e tutti i confronti tra espressioni regolari sono insensibili
+alle differenze maiuscolo/minuscolo.
+Questo vale per il confronto tra @dfn{regexp}
+usando @samp{~} e @samp{!~}, per le funzioni @code{gensub()},
address@hidden()}, @code{index()}, @code{match()}, @code{patsplit()},
address@hidden()} e @code{sub()},
+per la determinazione della fine record con @code{RS} e per la divisione
+in campi con @code{FS} e @code{FPAT}.
+Tuttavia, il valore di @code{IGNORECASE} @emph{non} influenza gli indici
+dei vettori
+e non influenza la separazione dei campi qualora si usi un separatore di campo
+costituito da un unico carattere.
address@hidden
+
address@hidden @command{gawk}, variabile @code{LINT} in
address@hidden @code{LINT}, variabile
address@hidden variabile @code{LINT}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{LINT}
address@hidden @dfn{lint}, controlli
address@hidden controlli @dfn{lint}
address@hidden 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}
+(@pxref{Opzioni}).
+Con un valore di @code{"fatal"}, gli avvertimenti di @dfn{lint} generano un
errore
+fatale.
+Con un valore di @code{"invalid"}, sono inviati solo gli avvertimenti
+per cose che sono effettivamente non valide. (Questa parte non funziona
+ancora perfettamente.)
+Ogni altro valore @dfn{vero} stampa avvertimenti non fatali.
+Se @code{LINT} ha per valore @dfn{falso} nessun avvertimento @dfn{lint} viene
+stampato.
+
+Questa variabile @`e un'estensione @command{gawk}. Non ha un valore speciale
+per altre implementazioni di @command{awk}. A differenza di altre variabili
+speciali, modificare il valore di @code{LINT} altera la produzione di
+avvertimenti @dfn{lint} anche se @command{gawk} @`e in address@hidden
compatibile.
+Analogamente a come le opzioni
address@hidden e @option{--traditional} controllano in maniera indipendente
+diversi aspetti del comportamente di @command{gawk}, il controllo
+degli avvertimenti di @dfn{lint} durante l'esecuzione del programma @`e
indipendente
+dall'implementazione @command{awk} in esecuzione.
+
address@hidden @code{OFMT}, variabile
address@hidden variabile @code{OFMT}
address@hidden numeri, conversione in stringhe
address@hidden stringhe, conversione in numeri
address@hidden OFMT
address@hidden questa la stringa che controlla la conversione di numeri in
+stringhe (@pxref{Conversione}) quando li
+si stampa con l'istruzione
address@hidden Funziona passandola
+ come primo argomento alla funzione @code{sprintf()}
+(@pxref{Funzioni per stringhe}).
+Il suo valore di default @`e @code{"%.6g"}. Le prime versioni di @command{awk}
+usavano @code{OFMT} per specificare il formato da usare per convertire
+numeri in stringhe in espressioni generali; questo compito @`e ora svolto
+da @code{CONVFMT}.
+
address@hidden @code{sprintf()}, funzione, variabile @code{OFMT} e
address@hidden funzione @code{sprintf()}, variabile @code{OFMT} e
address@hidden @code{print}, istruzione, variabile @code{OFMT} e
address@hidden istruzione @code{print}, variabile @code{OFMT} e
address@hidden variabile @code{OFS}
address@hidden @code{OFS}, variabile
address@hidden campo, separatori di
address@hidden separatori di campo
address@hidden OFS
address@hidden il separatore dei campi in output (@pxref{Separatori di
output}). @`E address@hidden
+che viene stampato in output per separare i campi stampati da un'istruzione
@code{print}.
+Il suo valore di default @`e @address@hidden" "}}, una stringa costituita da
un solo
+spazio.
+
address@hidden @code{ORS}, variabile
address@hidden variabile @code{ORS}
address@hidden ORS
+Il separatore dei record in output. Viene stampato alla fine di ogni
+istruzione @code{print}. Il suo valore di default @`e @code{"\n"},
+il carattere di ritorno a capo.
+(@xref{Separatori di output}.)
+
address@hidden @code{PREC}, variabile
address@hidden variabile @code{PREC}
address@hidden PREC #
+La precisione disponibile nei numeri a virgola mobile a precisione arbitraria,
+per default 53 bit (@pxref{Impostare la precisione}).
+
address@hidden @code{ROUNDMODE}, variabile
address@hidden variabile @code{ROUNDMODE}
address@hidden ROUNDMODE #
+La address@hidden di arrotondamento da usare per operazioni aritmetiche a
precisione
+arbitraria svolte sui numeri, per default @code{"N"}
+(@code{roundTiesToEven} nello standard
+IEEE 754; @pxref{Impostare modi di arrotondare}).
+
address@hidden @code{RS}, variabile
address@hidden variabile @code{RS}
address@hidden separatori di record
address@hidden record, separatori di
address@hidden @code{RS}
+Il separatore tra record in input. Il suo valore di default @`e una stringa
+contenente il solo carattere di ritorno a capo, il che significa che un record
in input
+consiste di una sola riga di testo.
+Il suo valore address@hidden essere anche la stringa nulla, nel qual caso i
record sono
+separati da una o address@hidden righe vuote.
+Se invece @`e una @dfn{regexp}, i record sono separati da
+corrispondenze alla @dfn{regexp} nel testo in input.
+(@xref{Record}.)
+
+La address@hidden che @code{RS} sia un'espressione regolare
address@hidden un'estensione @command{gawk}.
+In molte altre implementazioni @command{awk}, oppure
+se @command{gawk} @`e in address@hidden compatibile
+(@pxref{Opzioni}),
address@hidden usato solo il primo carattere del valore di @code{RS}.
+
address@hidden @code{SUBSEP}, variabile
address@hidden variabile @code{SUBSEP}
address@hidden separatori di indici
address@hidden indici, separatori di
address@hidden @code{SUBSEP}
+Il separatore di indici. Ha il valore di default di
address@hidden"\034"} ed @`e usato per separare le parti di cui sono composti
gli indici
+di un vettore multidimensionale. Quindi, l'espressione
address@hidden@w{pippo["A", "B"]}}
+in address@hidden accede a @code{pippo["A\034B"]}
+(@pxref{Vettori multidimensionali}).
+
address@hidden @command{gawk}, variabile @code{TEXTDOMAIN} in
address@hidden @code{TEXTDOMAIN}, variabile
address@hidden variabile @code{TEXTDOMAIN}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{TEXTDOMAIN}
address@hidden internazionalizzazione, localizzazione
address@hidden TEXTDOMAIN #
+Usata per l'internazionalizzazione di programmi a livello di
address@hidden Imposta il dominio di testo (@dfn{text domain}) di default per
costanti stringa
+marcate in maniera speciale nel codice sorgente, e anche per le funzioni
address@hidden()}, @code{dcngettext()} e @code{bindtextdomain()}
address@hidden
+(@pxrefil{Internazionalizzazione}).
address@hidden iftex
address@hidden
+(@pxref{Internazionalizzazione}).
address@hidden ifnottex
+Il valore di default di @code{TEXTDOMAIN} @`e @code{"messages"}.
address@hidden table
+
address@hidden Variabili auto-assegnate
address@hidden Variabili predefinite con cui @command{awk} fornisce informazioni
+
address@hidden predefinite, variabili, che forniscono informazioni
address@hidden variabili predefinite, che forniscono informazioni
+Quella che segue @`e una lista in ordine alfabetico di variabili che
address@hidden imposta automaticamente in determinate situazioni per
+fornire informazioni a un programma.
+
+Le variabili specifiche di @command{gawk} sono contrassegnate da un
+cancelletto (@samp{#}). Queste variabili sono estensioni @command{gawk}.
+In altre implementazioni di @command{awk} o se @command{gawk} @`e in
address@hidden compatibile (@pxref{Opzioni}), non hanno un significato speciale:
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{ARGC}/@code{ARGV}, variabili
address@hidden argomenti, riga di comando
address@hidden riga di comando, argomenti
address@hidden @code{ARGC}, @code{ARGV}
+Gli argomenti della riga di comando disponibili ai programmi @command{awk}
+sono memorizzati in un vettore di nome
address@hidden @code{ARGC} @`e il numero di argomenti presenti sulla
+riga di comando.
address@hidden argomenti}.
+A differenza di quasi tutti i vettori di @command{awk},
address@hidden @`e indicizzato da 0 a @code{ARGC} @minus{} 1.
+Lo si address@hidden vedere nell'esempio seguente:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{for (i = 0; i < ARGC; i++)}
+> @kbd{print ARGV[i]}
+> @address@hidden' inventory-shipped mail-list}
address@hidden awk
address@hidden inventory-shipped
address@hidden mail-list
address@hidden example
+
address@hidden
address@hidden contiene @samp{awk}, @code{ARGV[1]}
+contiene @samp{inventory-shipped} e @code{ARGV[2]} contiene
address@hidden Il valore di @code{ARGC} @`e tre, ossia uno in address@hidden
+dell'indice dell'ultimo elemento di @code{ARGV}, perch@'e gli elementi sono
+numerati a partire da zero.
+
address@hidden convenzioni di programmazione, variabili @code{ARGC}/@code{ARGV}
+I nomi @code{ARGC} e @code{ARGV}, come pure la convenzione di indicizzare
+il vettore da 0 a @code{ARGC} @minus{} 1, derivano dal modo in cui il
+linguaggio C accede agli argomenti presenti sulla riga di comando.
+
address@hidden angolo buio, valore di @code{ARGV[0]}
+Il valore di @code{ARGV[0]} address@hidden variare da sistema a sistema.
+Va anche notato che il programma @emph{non}
address@hidden incluso in @code{ARGV}, e non sono incluse neppure le eventuali
opzioni di
address@hidden specificate sulla riga di comando.
address@hidden e ARGV} per informazioni
+su come @command{awk} usa queste variabili.
address@hidden
+
address@hidden @code{ARGIND}, variabile
address@hidden variabile @code{ARGIND}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{ARGIND}
address@hidden @code{ARGIND #}
+L'indice in @code{ARGV} del file correntemente in elaborazione.
+Ogni volta che @command{gawk} apre un nuovo @value{DF} per elaborarlo, imposta
address@hidden all'indice in @code{ARGV} del @value{FN}.
+Quando @command{gawk} sta elaborando i file in input, il confronto
address@hidden == ARGV[ARGIND]} @`e sempre verificato.
+
address@hidden file, address@hidden variabile @code{ARGIND} e
+Questa variabile @`e utile nell'elaborazione dei file; consente di stabilire
+a che punto ci si trova nella lista
+di @value{DF}, e anche di distinguere tra successive occorrenze dello stesso
address@hidden sulla riga dei comandi.
+
address@hidden nomi di file, distinguere
+Anche se @`e possibile modificare il valore di @code{ARGIND} all'interno del
+programma @command{awk}, @command{gawk} automaticamente lo imposta a un nuovo
+valore quando viene aperto il file successivo.
+
address@hidden @code{ENVIRON}, vettore
address@hidden vettore @code{ENVIRON}
address@hidden variabili d'ambiente, nel vettore @code{ENVIRON}
address@hidden @code{ENVIRON}
+Un vettore associativo contenente i valori delle variabili d'ambiente.
+Gli indici del vettore sono i nomi delle variabili d'ambiente; gli elementi
+sono i valori della specifica variabile d'ambiente. Per esempio,
address@hidden"HOME"]} potrebbe valere @code{/home/arnold}.
+
+Per POSIX @command{awk}, le modifiche a questo vettore non cambiano
+le variabili d'ambiente passate a qualsivoglia programma che @command{awk}
address@hidden richiamare tramite una ridirezione
+o usando la funzione @code{system()}.
+
+Tuttavia, a partire dalla @value{PVERSION} 4.2, se non si @`e in
address@hidden compatibile POSIX, @command{gawk} aggiorna le proprie variabili
+d'ambiente, quando si modifica @code{ENVIRON}, e in questo modo sono
+modificate anche le variabili d'ambiente disponibili ai programmi richiamati.
+Un'attenzione speciale dovrebbe essere prestata alla modifica di
address@hidden"PATH"]}, che @`e il percorso di ricerca usato per trovare
+i programmi eseguibili.
+
+Queste modifiche possono anche influire sul programma @command{gawk}, poich@'e
+alcune funzioni predefinite possono tener conto di certe
+variabili d'ambiente.
+L'esempio address@hidden notevole di una tale situazione @`e @code{mktime()}
+(@pxref{Funzioni di tempo})
+che, in molti sistemi, tiene conto del valore della
+variabile d'ambiente @env{TZ}.
+
+Alcuni sistemi operativi possono non avere variabili d'ambiente.
+In tali sistemi, il vettore @code{ENVIRON} @`e vuoto (tranne che per
+le variabili
address@hidden@code{ENVIRON["AWKPATH"]}} e
address@hidden@code{ENVIRON["AWKLIBPATH"]}} eventualmente presenti;
address@hidden (Variabile)} e
address@hidden
address@hidden (Variabile)}).
address@hidden ifdocbook
address@hidden
address@hidden (Variabile)}).
address@hidden ifnotdocbook
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile
address@hidden variabile @code{ERRNO}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{ERRNO}
address@hidden gestione errori, variabile @code{ERRNO} e
address@hidden @code{ERRNO #}
+Se si verifica un errore di sistema durante una ridirezione per @code{getline},
+durante una lettura per @code{getline} o durante un'operazione di
address@hidden()}, la variabile
address@hidden contiene una stringa che descrive l'errore.
+
+Inoltre, @command{gawk} annulla @code{ERRNO} prima di aprire ogni
+file in input presente sulla riga di comando. Questo consente di controllare
+se il file @`e accessibile
+all'interno di un criterio di ricerca @code{BEGINFILE}
+(@pxref{BEGINFILE/ENDFILE}).
+
+Per il resto, @code{ERRNO} si comporta analogamente alla variabile C
address@hidden
+Tranne nel caso sopra accennato, @command{gawk} non annulla @emph{mai}
address@hidden (lo imposta a zero o a @code{""}). Quindi, ci si deve
+aspettare che il suo valore sia significativo solo quando un'operazione
+di I/O restituisce un valore che indica il fallimento dell'operazione, come
+per esempio quando @code{getline} restituisce @minus{}1. Si @`e, naturalmente,
+liberi di annullarla prima di effettuare un'operazione di I/O.
+
+Se il valore di @code{ERRNO} corrisponde a un errore di sistema della
+variabile C @code{errno}, @code{PROCINFO["errno"]} address@hidden impostato al
valore
+di @code{errno}. Per errori non di sistema, @code{PROCINFO["errno"]}
address@hidden
+impostata al valore zero.
+
address@hidden @code{FILENAME}, variabile
address@hidden variabile @code{FILENAME}
address@hidden angolo buio, variabile @code{FILENAME}
address@hidden @code{FILENAME}
+Il nome del file in input corrente. Quando non ci sono @value{DF}
+sulla riga dei comandi, @command{awk} legge dallo standard input e
address@hidden @`e impostato a @code{"-"}. @code{FILENAME} cambia ogni
+volta che si legge un nuovo file
address@hidden
+(@pxrefil{Leggere file}).
address@hidden iftex
address@hidden
+(@pxref{Leggere file}).
address@hidden ifnottex
+All'interno di una
+regola @code{BEGIN}, il valore di @code{FILENAME} @`e @code{""}, perch@'e non
si
+sta elaborando alcun file in address@hidden tra le prime implementazioni di
Unix
address@hidden inizializzavano @code{FILENAME} a @code{"-"}, anche se
+vi erano @value{DF} da elaborare. Un tale comportamento era incorretto e
+non ci si dovrebbe poter contare nei programmi.}
address@hidden Si noti, tuttavia,
+che l'uso di @code{getline} (@pxref{Getline}) all'interno di una regola
address@hidden address@hidden implicare l'assegnamento di un valore a
@code{FILENAME}.
+
address@hidden @code{FNR}, variabile
address@hidden variabile @code{FNR}
address@hidden @code{FNR}
+Il numero del record corrente nel file corrente. @command{awk} incrementa
address@hidden ogni volta che legge un nuovo record (@pxref{Record}).
address@hidden imposta nuovamente a zero @code{FNR} ogni volta che inizia a
+leggere un nuovo file in input.
+
address@hidden @code{NF}, variabile
address@hidden variabile @code{NF}
address@hidden @code{NF}
+Il numero di campi nel corrente record in input.
address@hidden @`e impostato ogni volta che si legge un nuovo record,
+quando un nuovo campo viene creato,
+o quando si modifica @code{$0} (@pxref{Campi}).
+
+A differenza di molte altre variabili descritte in questa @value{SUBSECTION},
+l'assegnamento di un valore a @code{NF} address@hidden potenzialmente
influenzare
+il funzionamento interno di @command{awk}. In particolare, assegnamenti
+a @code{NF} si possono usare per aggiungere o togliere campi dal
+record corrente. @xref{Cambiare i campi}.
+
address@hidden @code{FUNCTAB}, vettore
address@hidden vettore @code{FUNCTAB}
address@hidden @command{gawk}, vettore @code{FUNCTAB} in
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{FUNCTAB}
address@hidden @code{FUNCTAB #}
+Un vettore i cui indici e i corrispondenti valori sono i nomi di tutte le
+funzioni predefinite, definite dall'utente ed estese, presenti nel programma.
+
address@hidden NOTA
+Il tentativo di usare l'istruzione @code{delete} per eliminare il vettore
address@hidden genera un errore fatale. Genera un errore fatale anche
+ogni tentativo di impostare un elemento di @code{FUNCTAB}.
address@hidden quotation
+
address@hidden @code{NR}, variabile
address@hidden variabile @code{NR}
address@hidden @code{NR}
+Il numero di record in input che @command{awk} ha elaborato dall'inizio
+dell'esecuzione del programma
+(@pxref{Record}).
address@hidden incrementa @code{NR} ogni volta che legge un nuovo record.
+
address@hidden @command{gawk}, vettore @code{PROCINFO} in
address@hidden @code{PROCINFO}, vettore
address@hidden vettore @code{PROCINFO}
address@hidden differenze tra @command{awk} e @command{gawk}, vettore
@code{PROCINFO}
address@hidden @code{PROCINFO #}
+Gli elementi di questo vettore danno accesso a informazioni sul
+programma @command{awk} in esecuzione.
+I seguenti elementi (elencati in ordine alfabetico)
+sono sicuramente sempre disponibili:
+
address@hidden @code
address@hidden effettivo, @dfn{ID di gruppo} dell'utente di @command{gawk}
address@hidden PROCINFO["egid"]
+Il valore restituito dalla chiamata di sistema @code{getegid()}.
+
address@hidden PROCINFO["errno"]
+Il valore della variabile C @code{ERRNO} quando @code{ERRNO} @`e impostato
+al messaggio di errore a essa associato.
+
address@hidden PROCINFO["euid"]
address@hidden @dfn{ID effettivo} dell'utente di @command{gawk}
+Il valore restituito dalla chiamata di sistema @code{geteuid()}.
+
address@hidden PROCINFO["FS"]
+Questo elemento vale
address@hidden"FS"} se @`e in uso la separazione in campi con @code{FS},
address@hidden"FIELDWIDTHS"} se @`e in uso quella con @code{FIELDWIDTHS},
+oppure @code{"FPAT"} se @`e in uso l'individuazione di campo con @code{FPAT}.
+
address@hidden PROCINFO["gid"]
address@hidden @dfn{ID di gruppo} dell'utente @command{gawk}
+Il valore restituito dalla chiamata di sistema @code{getgid()} .
+
address@hidden PROCINFO["identifiers"]
address@hidden programma, identificativi in un
address@hidden identificativi in un programma
+Un sottovettore, indicizzato dai nomi di tutti gli identificativi usati
+all'interno del programma @command{awk}. Un @dfn{identificativo} @`e
+semplicemente il nome di una variabile
+(scalare o vettoriale), una funzione predefinita, una funzione definita
+dall'utente, o una funzione contenuta in un'estensione.
+Per ogni identificativo, il valore dell'elemento @`e uno dei seguenti:
+
address@hidden @code
address@hidden "array"
+L'identificativo @`e un vettore.
+
address@hidden "builtin"
+L'identificativo @`e una funzione predefinita.
+
address@hidden "extension"
+L'identificativo @`e una funzione in un'estensione caricata tramite
address@hidden@@load} o con l'opzione @option{-l}.
+
address@hidden "scalar"
+L'identificativo @`e uno scalare.
+
address@hidden "untyped"
+L'identificativo non ha ancora un tipo (potrebbe essere usato come scalare o
+come vettore; @command{gawk} non @`e ancora in grado di dirlo).
+
address@hidden "user"
+L'identificativo @`e una funzione definita dall'utente.
address@hidden table
+
address@hidden
+I valori riportano address@hidden che @command{gawk} sa sugli identificativi
+dopo aver finito l'analisi iniziale del programma; questi valori @emph{non}
+vengono address@hidden aggiornati durante l'esecuzione del programma.
+
address@hidden PROCINFO["pgrpid"]
address@hidden @dfn{process group ID} del programma @command{gawk}
+Il @dfn{ID di gruppo del processo} del programma corrente.
+
address@hidden PROCINFO["pid"]
address@hidden @dfn{process ID} del programma @command{gawk}
+Il @dfn{process ID} del programma corrente.
+
address@hidden PROCINFO["ppid"]
address@hidden @dfn{parent process ID} del programma @command{gawk}
+Il @dfn{ID di processo del padre} del programma corrente.
+
address@hidden PROCINFO["strftime"]
+La stringa col formato di default usato per la funzione @code{strftime()}.
+Assegnando un nuovo valore a questo elemento si cambia quello di default.
address@hidden di tempo}.
+
address@hidden PROCINFO["uid"]
+Il valore restituito dalla chiamata di sistema @code{getuid()}.
+
address@hidden PROCINFO["version"]
address@hidden versione di @command{gawk}
address@hidden @command{gawk}, versione di
+La versione di @command{gawk}.
address@hidden table
+
+I seguenti elementi addizionali del vettore
+sono disponibili per fornire informazioni sulle librerie MPFR e GMP,
+se la versione in uso di @command{gawk} consente il calcolo con precisione
+arbitraria
+(@pxref{Calcolo con precisione arbitraria}):
+
address@hidden @code
address@hidden PROCINFO["gmp_version"]
address@hidden versione della libreria GNU MP
+La versione della libreria GNU MP.
+
address@hidden versione della libreria GNU MPFR
address@hidden PROCINFO["mpfr_version"]
+La versione della libreria GNU MPFR.
+
address@hidden PROCINFO["prec_max"]
address@hidden precisione massima consentita dalla libreria MPFR
+La massima precisione consentita da MPFR.
+
address@hidden PROCINFO["prec_min"]
address@hidden precisione minima richiesta dalla libreria MPFR
+La precisione minima richiesta da MPFR.
address@hidden table
+
+I seguenti elementi addizionali del vettore
+sono disponibili per fornire
+informazioni sulla versione dell'estensione API, se la versione
+di @command{gawk} prevede il caricamento dinamico di funzioni di estensione
address@hidden
+(@pxrefil{Estensioni dinamiche}):
address@hidden iftex
address@hidden
+(@pxref{Estensioni dinamiche}):
address@hidden ifnottex
+
address@hidden @code
address@hidden PROCINFO["api_major"]
address@hidden versione dell'estensione API @command{gawk}
address@hidden estensione API, numero di versione
+La versione principale dell'estensione API.
+
address@hidden PROCINFO["api_minor"]
+La versione secondaria dell'estensione API.
address@hidden table
+
address@hidden gruppi supplementari Unix con @command{gawk}
+Su alcuni sistemi, ci possono essere elementi nel vettore, da @code{"group1"}
+fino a @code{"address@hidden"}. @var{N} @`e il numero di
+gruppi supplementari che il processo [Unix] possiede. Si usi l'operatore
address@hidden per verificare la presenza di questi elementi
+(@pxref{Visitare elementi}).
+
+I seguenti elementi consentono di modificare il comportamento di
address@hidden:
+
address@hidden PROCINFO["NONFATAL"]
+Se questo elemento esiste, gli errori di I/O per tutte le ridirezioni
+consentono la prosecuzizone del programma.
address@hidden dopo errori}.
+
address@hidden PROCINFO["@var{nome_output}", "NONFATAL"]
+Gli errori in output per il file @var{nome_output}
+consentono la prosecuzizone del programma.
address@hidden dopo errori}.
+
address@hidden @code
address@hidden PROCINFO["@var{comando}", "pty"]
+Per una comunicazione bidirezionale con @var{comando}, si usi una pseudo-tty
+invece di impostare una @dfn{pipe} bidirezionale.
address@hidden/O bidirezionale} per ulteriori informazioni.
+
address@hidden PROCINFO["@var{input_name}", "READ_TIMEOUT"]
+Imposta un tempo limite per leggere dalla ridirezione di input
@var{input_name}.
address@hidden in lettura} per ulteriori informazioni.
+
address@hidden PROCINFO["sorted_in"]
+Se questo elemento esiste in @code{PROCINFO}, il suo valore controlla
+l'ordine in cui gli indici dei vettori saranno elaborati nei cicli
address@hidden (@var{indice} in @var{vettore})}.
+Questa @`e una address@hidden avanzata, la cui descrizione completa
address@hidden vista
address@hidden avanti; si veda
address@hidden un intero vettore}.
address@hidden table
+
address@hidden @code{RLENGTH}, variabile
address@hidden variabile @code{RLENGTH}
address@hidden @code{RLENGTH}
+La lunghezza della sottostringa individuata dalla funzione
address@hidden()}
+(@pxref{Funzioni per stringhe}).
address@hidden viene impostata quando si richiama la funzione @code{match()}.
+Il suo
+valore @`e la lunghezza della stringa individuata, oppure @minus{}1 se non @`e
+stata trovata alcuna corrispondenza.
+
address@hidden @code{RSTART}, variabile
address@hidden variabile @code{RSTART}
address@hidden @code{RSTART}
+L'indice, in caratteri, da cui parte la sottostringa che @`e individuata dalla
+funzione @code{match()}
+(@pxref{Funzioni per stringhe}).
address@hidden viene impostata quando si richiama la funzione @code{match()}.
+Il suo
+valore @`e la posizione nella stringa da cui inizia la sottostringa
+individuata, oppure zero, se non @`e stata trovata alcuna corrispondenza.
+
address@hidden @command{gawk}, variabile @code{RT} in
address@hidden @code{RT}, variabile
address@hidden variabile @code{RT}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{RT}
address@hidden @code{RT #}
+Il testo in input che corrisponde al testo individuato da @code{RS},
+il separatore di record. Questa variabile viene impostata dopo aver letto
+ciascun record.
+
address@hidden @command{gawk}, vettore @code{SYMTAB} in
address@hidden @code{SYMTAB}, vettore
address@hidden vettore @code{SYMTAB}
address@hidden differenze tra @command{awk} e @command{gawk}, vettore
@code{SYMTAB}
address@hidden @code{SYMTAB #}
+Un vettore i cui indici sono i nomi di tutte le variabili globali e i vettori
+definiti nel programma. @code{SYMTAB} rende visibile al
+programmatore @command{awk} la tabella dei simboli di @command{gawk}.
+Viene preparata nella fase di analisi iniziale del programma @command{gawk}
+ed @`e completata prima di cominciare a eseguire il programma.
+
+Il vettore address@hidden essere usato per accedere indirettamente, in lettura
o in
+scrittura, al valore di una variabile:
+
address@hidden
+pippo = 5
+SYMTAB["pippo"] = 4
+print pippo # stampa 4
address@hidden example
+
address@hidden
+La funzione @code{isarray()} (@pxref{Funzioni per i tipi}) si address@hidden
usare per
+controllare se un elemento in @code{SYMTAB} @`e un vettore.
+Inoltre, non @`e possibile usare l'istruzione @code{delete} con il vettore
address@hidden
+
address@hidden possibile aggiungere a @code{SYMTAB} un elemento che non sia un
+identificativo address@hidden esistente:
+
address@hidden
+SYMTAB["xxx"] = 5
+print SYMTAB["xxx"]
address@hidden example
+
address@hidden
+Il risultato @`e quello previsto: in questo caso @code{SYMTAB} si comporta
+come un normale vettore. La sola differenza @`e che non @`e poi possibile
+cancellare @code{SYMTAB["xxx"]}.
+
address@hidden Schorr, Andrew
+Il vettore @code{SYMTAB} @`e address@hidden interessante di quel che sembra.
Andrew
+Schorr fa notare che effettivamente consente di ottenere dei puntatori ai dati
+in @command{awk}. Si consideri quest'esempio:
+
address@hidden
+# Moltiplicazione indiretta di una qualsiasi variabile per un
+# numero a piacere e restituzione del risultato
+
+function multiply(variabile, numero)
address@hidden
+ return SYMTAB[variabile] *= numero
address@hidden
address@hidden example
+
address@hidden
+Si potrebbe usare in questo modo:
+
address@hidden
+BEGIN @{
+ risposta = 10.5
+ multiply("risposta", 4)
+ print "La risposta @`e", risposta
address@hidden
address@hidden example
+
address@hidden
+Eseguendo, il risultato @`e:
+
address@hidden
+$ @kbd{gawk -f risposta.awk}
address@hidden La risposta @`e 42
address@hidden example
+
address@hidden NOTA
+Per evitare seri paradossi temporali,
address@hidden non parlare dei grossi problemi di implementazione.}
+n@'e @code{FUNCTAB} n@'e @code{SYMTAB}
+sono disponibili come elementi all'interno del vettore @code{SYMTAB}.
address@hidden quotation
address@hidden table
+
address@hidden sidebar, Modificare @code{NR} e @code{FNR}
address@hidden
address@hidden
+<sidebar><title>Modificare @code{NR} e @code{FNR}</title>
address@hidden docbook
+
address@hidden @code{NR}, variabile, modifica di
address@hidden variabile @code{NR}, modifica di
address@hidden @code{FNR}, variabile, modifica di
address@hidden variabile @code{FNR}, modifica di
address@hidden angolo buio, variabili @code{FNR}/@code{NR}
address@hidden incrementa le variabili @code{NR} e @code{FNR}
+ogni volta che legge un record, invece che impostarle al valore assoluto del
+numero di record letti. address@hidden significa che un programma
address@hidden
+modificare queste variabili e i valori address@hidden@dotless{i}} assegnati
sono incrementati per
+ogni record.
address@hidden
+Si consideri l'esempio seguente:
+
address@hidden
+$ @kbd{echo '1}
+> @kbd{2}
+> @kbd{3}
+> @kbd{4' | awk 'NR == 2 @{ NR = 17 @}}
+> @address@hidden print NR @}'}
address@hidden 1
address@hidden 17
address@hidden 18
address@hidden 19
address@hidden example
+
address@hidden
+Prima che @code{FNR} venisse aggiunto al linguaggio @command{awk}
+(@pxref{V7/SVR3.1}),
+molti programmi @command{awk} usavano questa address@hidden per
+contare il numero di record in un file impostando a zero @code{NR} al cambiare
+di @code{FILENAME}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Modificare @code{NR} e @code{FNR}}
+
+
address@hidden @code{NR}, variabile, modifica di
address@hidden variabile @code{NR}, modifica di
address@hidden @code{FNR}, variabile, modifica di
address@hidden variabile @code{FNR}, modifica di
address@hidden angolo buio, variabili @code{FNR}/@code{NR}
address@hidden incrementa le variabili @code{NR} e @code{FNR}
+ogni volta che legge un record, invece che impostarle al valore assoluto del
+numero di record letti. address@hidden significa che un programma
address@hidden
+modificare queste variabili e i valori address@hidden@dotless{i}} assegnati
sono incrementati per
+ogni record.
address@hidden
+Si consideri l'esempio seguente:
+
address@hidden
+$ @kbd{echo '1}
+> @kbd{2}
+> @kbd{3}
+> @kbd{4' | awk 'NR == 2 @{ NR = 17 @}}
+> @address@hidden print NR @}'}
address@hidden 1
address@hidden 17
address@hidden 18
address@hidden 19
address@hidden example
+
address@hidden
+Prima che @code{FNR} venisse aggiunto al linguaggio @command{awk}
+(@pxref{V7/SVR3.1}),
+molti programmi @command{awk} usavano questa address@hidden per
+contare il numero di record in un file impostando a zero @code{NR} al cambiare
+di @code{FILENAME}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden ARGC e ARGV
address@hidden Usare @code{ARGC} e @code{ARGV}
address@hidden @code{ARGC}/@code{ARGV}, variabili, come usarle
address@hidden variabili @code{ARGC}/@code{ARGV}, come usarle
address@hidden argomenti, riga di comando
address@hidden riga di comando, argomenti
+
address@hidden
+La
address@hidden iftex
address@hidden auto-assegnate}
+conteneva il programma seguente che visualizzava le informazioni contenute
+in @code{ARGC} e @code{ARGV}:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{for (i = 0; i < ARGC; i++)}
+> @kbd{print ARGV[i]}
+> @address@hidden' inventory-shipped mail-list}
address@hidden awk
address@hidden inventory-shipped
address@hidden mail-list
address@hidden example
+
address@hidden
+In questo esempio, @code{ARGV[0]} contiene @samp{awk}, @code{ARGV[1]}
+contiene @samp{inventory-shipped} e @code{ARGV[2]} contiene
address@hidden
+Si noti che il nome del programma @command{awk} non @`e incluso in @code{ARGV}.
+Le altre opzioni della riga di comando, con i relativi argomenti,
+sono parimenti non presenti, compresi anche gli assegnamenti di
+variabile fatti tramite l'opzione @option{-v}
+(@pxref{Opzioni}).
+I normali assegnamenti di variabile sulla riga dei comandi @emph{sono}
+trattati come argomenti e quindi inseriti nel vettore @code{ARGV}.
+Dato il seguente programma in un file di nome @file{vediargomenti.awk}:
+
address@hidden
+BEGIN @{
+ printf "A=%d, B=%d\n", A, B
+ for (i = 0; i < ARGC; i++)
+ printf "\tARGV[%d] = %s\n", i, ARGV[i]
address@hidden
+END @{ printf "A=%d, B=%d\n", A, B @}
address@hidden example
+
address@hidden
+la sua esecuzione produce il seguente risultato:
+
address@hidden
+$ @kbd{awk -v A=1 -f vediargomenti.awk B=2 /dev/null}
address@hidden A=1, B=0
address@hidden ARGV[0] = awk
address@hidden ARGV[1] = B=2
address@hidden ARGV[2] = /dev/null
address@hidden A=1, B=2
address@hidden example
+
+Un programma address@hidden modificare @code{ARGC} e gli elementi di
@code{ARGV}.
+Ogni volta che @command{awk} arriva alla fine di un file in input, usa
+il successivo elemento nel vettore @code{ARGV} come nome del successivo file
+in input. Cambiando il contenuto di quella stringa, un programma
address@hidden
+modificare la lista dei file che sono letti.
+Si usi @code{"-"} per rappresentare lo standard input. Assegnando ulteriori
+elementi e incrementando @code{ARGC}
+verranno letti ulteriori file.
+
+Se il valore di @code{ARGC} viene diminuto, vengono ignorati i file in input
+posti alla fine della lista. Memorizzando il valore originale di @code{ARGC}
+da qualche altra parte, un programma address@hidden gestire gli argomenti
+ignorati come se fossero qualcosa di diverso dai @value{FN}.
+
+Per eliminare un file che sia in mezzo alla lista, si imposti in @code{ARGV}
+la stringa nulla
+(@code{""}) al posto del nome del file in questione. Come address@hidden
+speciale, @command{awk} ignora valori di @value{FN} che siano stati
+rimpiazzati con la stringa nulla.
+Un'altra address@hidden @`e quella
+di usare l'istruzione @code{delete} per
+togliere elementi da @code{ARGV} (@pxref{Cancellazione}).
+
+Tutte queste azioni sono tipicamente eseguite nella regola @code{BEGIN},
+prima di iniziare l'elaborazione vera e propria dell'input.
address@hidden split} e
address@hidden
address@hidden tee}
address@hidden ifnotdocbook
address@hidden
address@hidden tee}
address@hidden ifdocbook
+per esempi
+su ognuno dei modi per togliere elementi dal vettore @code{ARGV}.
+
+Per passare direttamente delle opzioni a un programma scritto in
address@hidden, si devono terminare le opzioni di @command{awk} con
address@hidden e poi inserire le opzioni destinate al programma @command{awk},
+come mostrato qui di seguito:
+
address@hidden
+awk -f mio_programma.awk -- -v -q file1 file2 @dots{}
address@hidden example
+
+Il seguente frammento di programma ispeziona @code{ARGV} per esaminare, e
+poi rimuovere, le opzioni sulla riga di comando viste sopra:
+
address@hidden
+BEGIN @{
+ for (i = 1; i < ARGC; i++) @{
+ if (ARGV[i] == "-v")
+ verbose = 1
+ else if (ARGV[i] == "-q")
+ debug = 1
+ else if (ARGV[i] ~ /^-./) @{
+ e = sprintf("%s: opzione non riconosciuta -- %c",
+ ARGV[0], substr(ARGV[i], 2, 1))
+ print e > "/dev/stderr"
+ @} else
+ break
+ delete ARGV[i]
+ @}
address@hidden
address@hidden example
+
address@hidden differenze tra @command{awk} e @command{gawk}, variabili
@code{ARGC}/@code{ARGV}
+Terminare le opzioni di @command{awk} con @option{--} non @`e
+necessario in @command{gawk}. A meno che non si specifichi @option{--posix},
address@hidden inserisce, senza emettere messaggi, ogni opzione non
+riconosciuta
+nel vettore @code{ARGV} perch@'e sia trattata dal programma @command{awk}.
+Dopo aver trovato un'opzione non riconosciuta, @command{gawk} non cerca
+ulteriori opzioni, anche se ce ne fossero di riconoscibili.
+La riga dei comandi precedente sarebbe
+con @command{gawk}:
+
address@hidden
+gawk -f mio_programma.awk -q -v file1 file2 @dots{}
address@hidden example
+
address@hidden
+Poich@'e @option{-q} non @`e un'opzione valida per @command{gawk},
quest'opzione
+e l'opzione @option{-v} che segue sono passate al programma @command{awk}.
+(@xref{Funzione getopt} per una funzione di libreria @command{awk}
+che analizza le opzioni della riga di comando.)
+
+Nel progettare un programma, si dovrebbero scegliere opzioni che non
+siano in conflitto con quelle di @command{gawk}, perch@'e ogni opzioni
+accettata da @command{gawk} address@hidden elaborata prima di passare il resto
+della riga dei comandi al programma @command{awk}.
+Usare @samp{#!} con l'opzione @option{-E} address@hidden essere utile in
questo caso
+(@address@hidden eseguibili}
+e
address@hidden
address@hidden).
address@hidden ifnotdocbook
address@hidden
address@hidden).
address@hidden ifdocbook
+
address@hidden Sommario criteri e azioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Coppie @dfn{criterio di ricerca--azione} sono gli elementi base di un
+programma @command{awk}. I criteri di ricerca possono essere espressioni
+normali, espressioni di intervallo, o costanti @dfn{regexp}; possono anche
+essere i criteri speciali @code{BEGIN}, @code{END},
address@hidden o @code{ENDFILE}; o essere omessi. L'azione viene eseguita
+se il record corrente soddisfa il criterio di ricerca. Criteri di ricerca
+vuoti (omessi) corrispondono a
+tutti i record in input.
+
address@hidden
+L'I/O effettuato nelle azioni delle regole @code{BEGIN} ed @code{END}
+ha alcuni vincoli.
+Questo vale a maggior ragione per le regole @code{BEGINFILE} ed
address@hidden Queste ultime due forniscono degli ``agganci'' per interagire
+con l'elaborazione dei file fatta da @command{gawk},
+consentendo di risolvere situazioni che altrimenti genererebbero degli
+errori fatali (ad esempio per un file che non si @`e autorizzati
+a leggere).
+
address@hidden
+Le variabili di shell possono essere usate nei programmi @command{awk}
+prestando la dovuta attenzione all'uso degli apici.
address@hidden address@hidden facile passare una variabile di shell ad
address@hidden usando l'opzione @option{-v} e una variabile @command{awk}.
+
address@hidden
+Le azioni sono formate da istruzioni racchiuse tra parentesi graffe.
+Le istruzioni sono composte da
+espressioni, istruzioni di controllo,
+istruzioni composte,
+istruzioni di input/output e istruzioni di cancellazione.
+
address@hidden
+Le istruzioni di controllo in @command{awk} sono @address@hidden,
address@hidden, @code{for} e @address@hidden @command{gawk}
+aggiunge l'istruzione @code{switch}. Ci sono due tipi di istruzione
address@hidden: uno per eseguire dei cicli, e l'altro per esaminare un vettore.
+
address@hidden
+Le istruzioni @code{break} e @code{continue} permettono di uscire
+velocemente da un ciclo, o di passare alla successiva iterazione dello
+stesso (o di uscire da un'istruzione @code{switch}).
+
address@hidden
+Le istruzioni @code{next} e @code{nextfile} permettono, rispettivamente,
+di passare al record successivo, ricominciando l'elaborazione dalla prima
+regola del programma, o di passare al successivo file in input, sempre
+ripartendo dalla prima regola del programma.
+
address@hidden
+L'istruzione @code{exit} termina il programma. Quando @`e eseguita
+dall'interno di un'azione (o nel corpo di una funzione), trasferisce
+il controlla alle eventuali istruzioni @code{END}. Se @`e eseguita nel corpo
+di un'istruzione @code{END}, il programma @`e terminato
+immediatamente. @`E possibile specificare un valore numerico da usare come
+codice di ritorno di @command{awk}.
+
address@hidden
+Alcune variabili predefinite permettono di controllare @command{awk},
+principalmente per l'I/O. Altre variabili trasmettono informazioni
+da @command{awk} al programma.
+
address@hidden
+I vettori @code{ARGC} e @code{ARGV} rendono disponibili al programma gli
+argomenti della riga di comando. Una loro modifica all'interno di una regola
address@hidden permette di controllare come @command{awk} address@hidden i
@value{DF}
+in input.
+
address@hidden itemize
+
address@hidden Vettori
address@hidden Vettori in @command{awk}
address@hidden vettori
+
+Un @dfn{vettore} @`e una tabella di valori chiamati @dfn{elementi}. Gli
+elementi di un vettore sono individuati dai loro @dfn{indici}. Gli indici
+possono essere numeri o stringhe.
+
+Questo @value{CHAPTER} descrive come funzionano i vettori in @command{awk},
+come usare gli elementi di un vettore, come visitare tutti gli elementi
+di un vettore, e come rimuovere elementi da un vettore.
+Descrive anche come @command{awk} simula vettori multidimensionali,
+oltre ad alcuni aspetti meno ovvii sull'uso dei vettori.
+Il @value{CHAPTER} prosegue illustrando la address@hidden di ordinamento dei
+vettori di @command{gawk}, e termina con una breve descrizione della
address@hidden
+di @command{gawk} di consentire veri vettori di vettori.
+
address@hidden
+* Fondamenti sui vettori:: Informazioni di base sui vettori.
+* Indici numerici di vettore:: Come usare numeri come indici in
+ @command{awk}.
+* Indici non inizializzati:: Usare variabili non inizializzate come indici.
+* Cancellazione:: L'istruzione @code{delete} toglie un elemento
+ da un vettore.
+* Vettori multidimensionali:: Emulare vettori multidimensionali in
+ @command{awk}.
+* Vettori di vettori:: Vettori multidimensionali veri.
+* Sommario dei vettori:: Sommario dei vettori.
address@hidden menu
+
address@hidden Fondamenti sui vettori
address@hidden Informazioni di base sui vettori
+
+Questa @value{SECTION} espone le nozioni fondamentali: elaborare gli elementi
+di un vettore uno alla volta, e visitare sequenzialmente tutti gli elementi
+di un vettore.
+
address@hidden
+* Introduzione ai vettori:: Introduzione ai vettori
+* Visitare elementi:: Come esaminare un elemento di un vettore.
+* Impostare elementi:: Come cambiare un elemento di un vettore.
+* Esempio di vettore:: Esempio semplice di vettore
+* Visitare un intero vettore:: Variazione dell'istruzione @code{for}. Esegue
+ un ciclo attraverso gli indici degli elementi
+ contenuti in un vettore.
+* Controllare visita:: Controllare l'ordine in cui i vettori sono
+ visitati.
address@hidden menu
+
address@hidden Introduzione ai vettori
address@hidden Introduzione ai vettori
+
address@hidden Wall, Larry
address@hidden
address@hidden sequenzialmente un vettore associativo @`e come tentare di
+lapidare qualcuno usando una mitragliatrice Uzi carica.}
address@hidden Larry Wall
address@hidden quotation
+
+Il linguaggio @command{awk} mette a disposizione vettori monodimensionali per
+memorizzare gruppi di stringhe o di numeri correlati fra loro. Ogni vettore di
address@hidden deve avere un nome. I nomi dei vettori hanno la stessa sintassi
+dei nomi di variabile; qualsiasi nome valido di variabile potrebbe essere anche
+un valido nome di vettore. Un nome address@hidden non address@hidden essere
usato in entrambi i
+modi (come vettore e come variabile) nello stesso programma @command{awk}.
+
+I vettori in @command{awk} assomigliano superficialmente ai vettori in altri
+linguaggi di programmazione, ma ci sono differenze fondamentali. In
address@hidden, non @`e necessario specificare la dimensione di un vettore prima
+di iniziare a usarlo. In address@hidden, qualsiasi numero o stringa
address@hidden essere usato
+come indice di un vettore, non solo numeri interi consecutivi.
+
+Nella maggior parte degli altri linguaggi, i vettori devono essere
address@hidden prima dell'uso, specificando quanti elementi o componenti
+contengono. In questi linguaggi, la dichiarazione causa l'allocazione, per
+questi elementi, di un blocco di memoria contiguo.
+Normalmente, un indice di un vettore dev'essere un intero non negativo.
+Per esempio, l'indice zero specifica il primo elemento nel vettore, che @`e
+effettivamente memorizzato all'inizio di un blocco di memoria. L'indice uno
+specifica il secondo elemento, che @`e memorizzato subito dopo il primo
elemento,
+e address@hidden@dotless{i}} via. @`E impossibile aggiungere ulteriori
elementi al vettore, perch@'e
+esso address@hidden contenere solo il numero di elementi dichiarato.
+(Alcuni linguaggi consentono indici iniziali e finali arbitrari---p.es.,
address@hidden .. address@hidden la dimensione del vettore rimane fissa una
volta che
+il vettore sia stato dichiarato.)
+
address@hidden 1/2015: Do not put the numeric values into @code. Array element
address@hidden values are no different than scalar variable values.
+Un vettore contiguo di quattro elementi potrebbe essere come quello in
address@hidden
address@hidden,
address@hidden ifnotdocbook
address@hidden
+come mostrato in @inlineraw{docbook, <xref linkend="vettore-elementi"/>}:
address@hidden ifdocbook
+concettualmente, se i valori degli elementi sono 8, @code{"pippo"},
address@hidden""} e 30.
+
address@hidden
address@hidden Figura,vettore-elementi
address@hidden vettore contiguo}
address@hidden SMALLPRINT
address@hidden @image{vettore-elementi, 11cm, , Un vettore contiguo}
address@hidden ifset
address@hidden SMALLPRINT
address@hidden @image{vettore-elementi, , , Un vettore contiguo}
address@hidden ifclear
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="vettore-elementi" float="0">
+<title>Un vettore contiguo</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="vettore-elementi.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
address@hidden
+Vengono memorizzati solo i valori; gli indici sono definiti implicitamente
+dall'ordine dei valori. Qui, 8 @`e il valore il cui indice @`e zero, perch@'e 8
+appare nella posizione con zero elementi prima di essa.
+
address@hidden vettori, indicizzazione
address@hidden indicizzare i vettori
address@hidden associativi, vettori
address@hidden vettori associativi
+I vettori in @command{awk} non sono di questo tipo: sono invece
address@hidden
address@hidden significa che ogni vettore @`e un insieme di coppie, ognuna
costituita
+da un indice e dal corrispondente valore dell'elemento del vettore:
+
address@hidden
address@hidden extra empty column to indent it right
address@hidden @columnfractions .1 .1 .1
address@hidden @tab Indice @tab Valore
address@hidden @tab @code{3} @tab @code{30}
address@hidden @tab @code{1} @tab @code{"pippo"}
address@hidden @tab @code{0} @tab @code{8}
address@hidden @tab @code{2} @tab @code{""}
address@hidden multitable
address@hidden ifnotdocbook
+
address@hidden
+<informaltable>
+<tgroup cols="2">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<thead>
+<row>
+<entry>Indice</entry>
+<entry>Valore</entry>
+</row>
+</thead>
+
+<tbody>
+<row>
+<entry><literal>3</literal></entry>
+<entry><literal>30</literal></entry>
+</row>
+
+<row>
+<entry><literal>1</literal></entry>
+<entry><literal>"pippo"</literal></entry>
+</row>
+
+<row>
+<entry><literal>0</literal></entry>
+<entry><literal>8</literal></entry>
+</row>
+
+<row>
+<entry><literal>2</literal></entry>
+<entry><literal>""</literal></entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
address@hidden
+Le coppie sono elencate in ordine casuale perch@'e il loro ordinamento @`e
address@hidden'ordine address@hidden variare nelle diverse implementazioni
+di @command{awk}, che tipicamente usa tabelle @dfn{hash} per memorizzare
+elementi e valori del vettore.}
+
+Un vantaggio dei vettori associativi @`e che si possono aggiungere nuove coppie
+in qualsiasi momento. Per esempio, supponiamo di aggiungere al vettore un
+decimo elemento il cui valore sia @address@hidden"numero dieci"}}. Il
risultato address@hidden:
+
address@hidden
address@hidden extra empty column to indent it right
address@hidden @columnfractions .1 .1 .3
address@hidden @tab Indice @tab Valore
address@hidden @tab @code{10} @tab @code{"numero dieci"}
address@hidden @tab @code{3} @tab @code{30}
address@hidden @tab @code{1} @tab @code{"pippo"}
address@hidden @tab @code{0} @tab @code{8}
address@hidden @tab @code{2} @tab @code{""}
address@hidden multitable
address@hidden ifnotdocbook
+
address@hidden
+<informaltable>
+<tgroup cols="2">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<thead>
+<row>
+<entry>Indice</entry>
+<entry>Valore</entry>
+</row>
+</thead>
+<tbody>
+
+<row>
+<entry><literal>10</literal></entry>
+<entry><literal>"numero dieci"</literal></entry>
+</row>
+
+<row>
+<entry><literal>3</literal></entry>
+<entry><literal>30</literal></entry>
+</row>
+
+<row>
+<entry><literal>1</literal></entry>
+<entry><literal>"pippo"</literal></entry>
+</row>
+
+<row>
+<entry><literal>0</literal></entry>
+<entry><literal>8</literal></entry>
+</row>
+
+<row>
+<entry><literal>2</literal></entry>
+<entry><literal>""</literal></entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
address@hidden
address@hidden sparsi, vettori
address@hidden vettori sparsi
+Ora il vettore @`e @dfn{sparso}, il che significa semplicemente che non sono
+usati alcuni indici. Ha gli elementi 0, 1, 2, 3 e 10, ma mancano gli
+elementi 4, 5, 6, 7, 8 e 9.
+
+Un'altra caratteristica dei vettori associativi @`e che gli indici non devono
+essere necessariamente interi non negativi. Qualsiasi numero, o anche una
+stringa, address@hidden essere un indice. Per esempio, il seguente @`e un
vettore che
+traduce delle parole dall'inglese all'italiano:
+
address@hidden
address@hidden @columnfractions .1 .1 .1
address@hidden @tab Indice @tab Valore
address@hidden @tab @code{"dog"} @tab @code{"cane"}
address@hidden @tab @code{"cat"} @tab @code{"gatto"}
address@hidden @tab @code{"one"} @tab @code{"uno"}
address@hidden @tab @code{1} @tab @code{"uno"}
address@hidden multitable
address@hidden ifnotdocbook
+
address@hidden
+<informaltable>
+<tgroup cols="2">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<thead>
+<row>
+<entry>Indice</entry>
+<entry>Valore</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><literal>"dog"</literal></entry>
+<entry><literal>"cane"</literal></entry>
+</row>
+
+<row>
+<entry><literal>"cat"</literal></entry>
+<entry><literal>"gatto"</literal></entry>
+</row>
+
+<row>
+<entry><literal>"one"</literal></entry>
+<entry><literal>"uno"</literal></entry>
+</row>
+
+<row>
+<entry><literal>1</literal></entry>
+<entry><literal>"uno"</literal></entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
address@hidden
+Qui abbiamo deciso di tradurre il numero uno sia nella forma letterale che in
+quella numerica, per illustrare che un singolo vettore address@hidden avere
come indici
+sia numeri che stringhe.
+(In effetti, gli indici dei vettori sono sempre stringhe.
+Ci sono alcune sottigliezze su come funzionano i numeri quando sono usati come
+indici dei vettori; questo address@hidden trattato in maggior dettaglio nella
address@hidden numerici di vettore}.)
+Qui sopra, il numero @code{1} non @`e tra doppi apici, perch@'e @command{awk}
+lo converte automaticamente in una stringa.
+
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden maiuscolo/minuscolo, distinzione, indici dei vettori e
address@hidden vettori, ordinamento, variabile @code{IGNORECASE} e
address@hidden @code{IGNORECASE}, variabile, e indici dei vettori
address@hidden variabile @code{IGNORECASE}, e indici dei vettori
+Il valore di @code{IGNORECASE} non ha alcun effetto sull'indicizzazione dei
+vettori. Lo stesso valore di stringa usato per memorizzare un elemento di un
+vettore address@hidden essere usato per richiamarlo.
+Quando @command{awk} crea un vettore (p.es., con la funzione predefinita
address@hidden()}), gli indici di quel vettore sono numeri interi consecutivi
+a partire da uno.
+(@xref{Funzioni per stringhe}.)
+
+I vettori di @command{awk} sono efficienti: il tempo necessario per accedere a
+un elemento @`e indipendente dal numero di elementi nel vettore.
+
address@hidden Visitare elementi
address@hidden Come esaminare un elemento di un vettore
address@hidden vettori, esaminare elementi
address@hidden vettore, elementi di un
address@hidden elementi di un vettore
+
+Il modo principale di usare un vettore @`e quello di esaminare uno dei suoi
+elementi. Un @dfn{riferimento al vettore} @`e un'espressione come questa:
+
address@hidden
address@hidden@var{espressione-indice}]
address@hidden example
+
address@hidden
+Qui, @var{vettore} @`e il nome di un vettore. L'espressione
address@hidden @`e l'indice dell'elemento del vettore che si vuol
+esaminare.
+
address@hidden 1/2015: Having the 4.3 in @samp is a little iffy. It's
essentially
address@hidden an expression though, so leave be. It's to early in the
discussion
address@hidden to mention that it's really a string.
+Il valore del riferimento al vettore @`e il valore corrente di quell'elemento
+del vettore. Per esempio, @code{pippo[4.3]} @`e un'espressione che richiama
+l'elemento del vettore @code{pippo} il cui indice @`e @samp{4.3}.
+
address@hidden vettori, elementi non assegnati
address@hidden elementi di vettore non assegnati
address@hidden elementi di vettore vuoti
+Un riferimento a un elemento di un vettore il cui indice non esiste ancora
+restituisce un valore uguale a @code{""}, la stringa nulla. Questo comprende
+elementi a cui non @`e stato assegnato un valore ed elementi che sono stati
+eliminati (@pxref{Cancellazione}).
+
address@hidden elementi inesistenti di un vettore
address@hidden vettori, elementi che non esistono
address@hidden NOTA
+Un riferimento a un elemento inesistente crea @emph{automaticamente}
+quell'elemento di vettore, con la stringa nulla come valore. (In certi casi,
address@hidden @`e indesiderabile, perch@'e potrebbe sprecare memoria
all'interno di
address@hidden)
+
+I programmatori principianti di @command{awk} fanno spesso l'errore di
+verificare se un elemento esiste controllando se il valore @`e vuoto:
+
address@hidden
+# Verifica se "pippo" esiste in a: @ii{Non corretto!}
+if (a["pippo"] != "") @dots{}
address@hidden example
+
address@hidden
+Questo @`e sbagliato per due motivi. Primo, @emph{crea} @code{a["pippo"]}
+se ancora non esisteva! Secondo, assegnare a un elemento di un vettore la
+stringa vuota come valore @`e un'operazione valida (anche se un po' insolita).
address@hidden quotation
+
address@hidden @cindex arrays, @code{in} operator and
address@hidden @code{in}, operatore, verificare se un elemento esiste in un
vettore
+Per determinare se un elemento con un dato indice esiste in un vettore,
+si usi la seguente espressione:
+
address@hidden
address@hidden in @var{vettore}
address@hidden example
+
address@hidden effetti collaterali, indicizzazione di vettori
address@hidden
+Quest'espressione verifica se lo specifico indice @var{indice} esiste, senza
+l'effetto collaterale di creare quell'elemento nel caso che esso non sia
+presente. L'espressione ha il valore uno (vero) se
address@hidden@address@hidden
+esiste e zero (falso) se non esiste.
address@hidden (Qui usiamo @var{indx}, perch@'e @samp{index} @`e il nome di una
funzione
address@hidden predefinita.)
+Per esempio, quest'istruzione verifica se il vettore @code{frequenze}
+contiene l'indice @samp{2}:
+
address@hidden
+if (2 in frequenze)
+ print "L'indice 2 @`e presente."
address@hidden example
+
+Si noti che questo @emph{non} verifica se il vettore
address@hidden contiene un elemento il cui @emph{valore} @`e 2.
+Il solo modo far questo @`e quello di passare in rassegna tutti gli
+elementi. Inoltre, questo @emph{non} crea @code{frequenze[2]}, mentre la
+seguente alternativa (non corretta) lo fa:
+
address@hidden
+if (frequenze[2] != "")
+ print "L'indice 2 @`e presente."
address@hidden example
+
address@hidden Impostare elementi
address@hidden Assegnare un valore a elementi di un vettore
address@hidden vettori, elementi, assegnare valori
address@hidden elementi di vettori, assegnare valori
+
+Agli elementi di un vettore possono essere assegnati valori proprio come
+alle variabili di @command{awk}:
+
address@hidden
address@hidden@var{espressione-indice}] = @var{valore}
address@hidden example
+
address@hidden
address@hidden @`e il nome di un vettore. L'espressione
address@hidden @`e l'indice dell'elemento del vettore a cui @`e
+assegnato il valore. L'espressione @var{valore} @`e il valore da assegnare
+a quell'elemento del vettore.
+
address@hidden Esempio di vettore
address@hidden Esempio semplice di vettore
address@hidden vettori, un esempio sull'uso
+
+Il seguente programma prende una lista di righe, ognuna delle quali inizia con
+un numero di riga, e le stampa in ordine di numero di riga. I numeri di riga
+non sono ordinati al momento della lettura, ma sono invece in ordine sparso.
+Questo programma ordina le righe mediante la creazione di un vettore che usa
+i numeri di riga come indici. Il programma stampa poi le righe
+ordinate secondo il loro numero. @`E un programma molto semplice e non @`e in
+grado di gestire numeri ripetuti, salti di riga o righe che non
+iniziano con un numero:
+
address@hidden
address@hidden file eg/misc/arraymax.awk
address@hidden
+ if ($1 > massimo)
+ massimo = $1
+ vett[$1] = $0
address@hidden
+
+END @{
+ for (x = 1; x <= massimo; x++)
+ print vett[x]
address@hidden
address@hidden endfile
address@hidden example
+
+La prima regola tiene traccia del numero di riga address@hidden grande visto
+durante la lettura;
+memorizza anche ogni riga nel vettore @code{vett}, usando come indice
+il numero di riga.
+La seconda regola viene eseguita dopo che @`e stato letto tutto l'input, per
+stampare tutte le righe.
+Quando questo programma viene eseguito col seguente input:
+
address@hidden
address@hidden file eg/misc/arraymax.data
+5 Io sono l'uomo Cinque
+2 Chi sei? Il nuovo numero due!
+4 . . . E quattro a terra
+1 Chi @`e il numero uno?
+3 Sei il tre.
address@hidden endfile
address@hidden example
+
address@hidden
+Il suo output @`e:
+
address@hidden
+1 Chi @`e il numero uno?
+2 Chi sei? Il nuovo numero due!
+3 Sei il tre.
+4 . . . E quattro a terra
+5 Io sono l'uomo Cinque
address@hidden example
+
+Se un numero di riga appare address@hidden di una volta, l'ultima riga con
quel dato
+numero prevale sulle altre.
+Le righe non presenti nel vettore
+si possono saltare con un semplice perfezionamento della
+regola @code{END} del programma, in questo modo:
+
address@hidden
+END @{
+ for (x = 1; x <= massimo; x++)
+ if (x in vett)
+ print vett[x]
address@hidden
address@hidden example
+
address@hidden Visitare un intero vettore
address@hidden Visitare tutti gli elementi di un vettore
address@hidden elementi di vettori, visitare
address@hidden visitare vettori
address@hidden vettori, visitare
address@hidden cicli, @code{for}, visita di un vettore
+
+Nei programmi che usano vettori, @`e spesso necessario usare un ciclo che
+esegue un'azione su ciascun elemento di un vettore. In altri linguaggi, dove
+i vettori sono contigui e gli indici sono limitati ai numeri interi
+non negativi,
+questo @`e facile: tutti gli indici validi possono essere visitati partendo
+dall'indice address@hidden basso e arrivando a quello address@hidden alto.
Questa tecnica non
address@hidden applicabile in @command{awk}, perch@'e qualsiasi numero o
stringa address@hidden
+fare da indice in un vettore. address@hidden @command{awk} ha un tipo
speciale di
+istruzione @code{for} per visitare un vettore:
+
address@hidden
+for (@var{variabile} in @var{vettore})
+ @var{corpo}
address@hidden example
+
address@hidden
address@hidden @code{in}, operatore, uso in cicli
address@hidden operatore @code{in}, uso in cicli
+Questo ciclo esegue @var{corpo} una volta per ogni indice in @var{vettore} che
+il programma ha usato precedentemente, con la variabile @var{variabile}
+impostata a quell'indice.
+
address@hidden vettori, istruzione @code{for} e
address@hidden @code{for}, istruzione, esecuzione di cicli su un vettore
+Il seguente programma usa questa forma dell'istruzione @code{for}. La
+prima regola visita i record in input e tiene nota di quali parole appaiono
+(almeno una volta) nell'input, memorizzando un 1 nel vettore @code{usate} con
+la parola come indice. La seconda regola visita gli elementi di
address@hidden per trovare tutte le parole distinte che appaiono nell'input.
+Il programma stampa poi ogni parola che @`e address@hidden lunga di 10
caratteri e
+anche il numero di tali parole.
address@hidden per stringhe}
+per maggiori informazioni sulla funzione predefinita @code{length()}.
+
address@hidden
+# Registra un 1 per ogni parola usata almeno una volta
address@hidden
+ for (i = 1; i <= NF; i++)
+ usate[$i] = 1
address@hidden
+
+# Trova il numero di parole distinte lunghe address@hidden di 10 caratteri
+END @{
+ for (x in usate) @{
+ if (length(x) > 10) @{
+ ++numero_parole_lunghe
+ print x
+ @}
+ @}
+ print numero_parole_lunghe, "parole address@hidden lunghe di 10 caratteri"
address@hidden
address@hidden example
+
address@hidden
address@hidden utilizzo parole}
+per un esempio di questo tipo address@hidden dettagliato.
+
address@hidden vettori, elementi di, ordine di accesso da parte dell'operatore
@code{in}
address@hidden elementi di vettori, ordine di accesso da parte dell'operatore
@code{in}
address@hidden @code{in}, operatore, ordine di accesso dei vettori
address@hidden operatore @code{in}, ordine di accesso dei vettori
+L'ordine nel quale gli elementi del vettore sono esaminati da quest'istruzione
address@hidden determinato dalla disposizione interna degli elementi del
vettore all'interno
+di @command{awk} e nell'@command{awk} standard non address@hidden essere
controllato
+o cambiato. Questo address@hidden portare a dei problemi se vengono aggiunti
nuovi
+elementi al @var{vettore} dall'istruzione eseguendo il corpo del ciclo;
+non @`e prevedibile se il ciclo @code{for} li address@hidden raggiungere.
Similmente,
+modificare @var{variabile} all'interno del ciclo potrebbe produrre strani
+risultati. @`E meglio evitare di farlo.
+
+Di sicuro, @command{gawk} imposta la lista di elementi su cui eseguire
+l'iterazione prima che inizi il ciclo, e non la cambia in corso d'opera.
+Ma non tutte le versioni di @command{awk} fanno address@hidden@dotless{i}}. Si
consideri questo
+programma, chiamato @file{vediciclo.awk}:
+
address@hidden
+BEGIN @{
+ a["questo"] = "questo"
+ a["@`e"] = "@`e"
+ a["un"] = "un"
+ a["ciclo"] = "ciclo"
+ for (i in a) @{
+ j++
+ a[j] = j
+ print i
+ @}
address@hidden
address@hidden example
+
+Ecco quel che accade quando viene eseguito con @command{gawk} (e
@command{mawk}):
+
address@hidden
+$ @kbd{gawk -f vediciclo.awk}
address@hidden questo
address@hidden ciclo
address@hidden un
address@hidden @`e
address@hidden example
+
+Se si usa invece BWK @command{awk}:
+
address@hidden
+$ @kbd{nawk -f vediciclo.awk}
address@hidden ciclo
address@hidden questo
address@hidden @`e
address@hidden un
address@hidden 1
address@hidden example
+
address@hidden Controllare visita
address@hidden Visita di vettori in ordine predefinito con @command{gawk}
+
+Questa @value{SUBSECTION} descrive una address@hidden disponibile solo in
address@hidden
+
+Per default, quando un ciclo @code{for} visita un vettore, l'ordine
address@hidden indeterminato, il che vuol dire che l'implementazione di
@command{awk}
+determina l'ordine in cui il vettore viene attraversato.
+Quest'ordine normalmente @`e basato sull'implementazione interna dei vettori
+e varia da una versione di @command{awk} alla successiva.
+
address@hidden vettori, ordine di visita, controllo dell'
address@hidden controllare l'ordine di visita dei vettori
+Spesso, tuttavia, servirebbe fare qualcosa di semplice, come
+``visitare il vettore confrontando gli indici in ordine crescente,''
+o ``visitare il vettore confrontando i valori in ordine decrescente.''
address@hidden fornisce due meccanismi che permettono di farlo.
+
address@hidden @value{BULLET}
address@hidden
+Assegnare a @code{PROCINFO["sorted_in"]} un valore a scelta fra
+alcuni valori predefiniti.
+Si vedano address@hidden sotto i valori ammessi.
+
address@hidden
+Impostare @code{PROCINFO["sorted_in"]} al nome di una funzione definita
+dall'utente, da usare per il confronto tra gli elementi di un vettore. Questa
address@hidden avanzata address@hidden descritta in seguito in @ref{Ordinamento
di vettori}.
address@hidden itemize
+
address@hidden @code{PROCINFO}, valori di @code{sorted_in}
+Sono disponibili i seguenti valori speciali per @code{PROCINFO["sorted_in"]}:
+
address@hidden @code
address@hidden "@@unsorted"
+Lasciare gli elementi del vettore in ordine arbitrario
+(questo @`e il comportamento di default di @command{awk}).
+
address@hidden "@@ind_str_asc"
+Ordinare in ordine crescente di indice, confrontando tra loro gli indici
+come stringhe; questo @`e l'ordinamento address@hidden normale.
+(Internamente, gli indici dei vettori sono sempre stringhe, per cui con
address@hidden = 1} l'indice @`e la stringa @code{"10"} e non il numero 10.)
+
address@hidden "@@ind_num_asc"
+Ordinare in ordine crescente di indice, ma nell'elaborazione gli indici vengono
+trattati come numeri. Gli indici con valore non numerico verranno posizionati
+come se fossero uguali a zero.
+
address@hidden "@@val_type_asc"
+Ordinare secondo il valore degli elementi in ordine crescente (invece che in
+base agli indici). L'ordinamento @`e in base al tipo assegnato all'elemento
+(@pxref{Tipi di variabile e confronti}).
+Tutti i valori numerici precedono tutti i valori di tipo stringa,
+che a loro volta vengono prima dei sottovettori.
+(I sottovettori non sono ancora stati descritti;
address@hidden di vettori}.)
+
address@hidden "@@val_str_asc"
+Ordinare secondo il valore degli elementi in ordine crescente (invece che in
+base agli indici). I valori scalari sono confrontati come stringhe.
+I sottovettori, se presenti, vengono per ultimi.
+
address@hidden "@@val_num_asc"
+Ordinare secondo il valore degli elementi in ordine crescente (invece che in
+base agli indici). I valori scalari sono confrontati come numeri.
+I sottovettori, se presenti, vengono per ultimi.
+Quando i valori numerici coincidono, vengono usati i valori di tipo stringa
+per stabilire un ordinamento: address@hidden garantisce risultati coerenti tra
differenti
+versioni della funzione C @code{qsort()},@footnote{Quando due elementi
+risultano uguali, la funzione C @code{qsort()} non garantisce
+che dopo l'ordinamento venga rispettato il loro ordine relativo originale.
+Usando il valore di stringa per stabilire un ordinamento univoco quando i
+valori numerici sono uguali assicura che il comportamento di @command{gawk}
+sia coerente in differenti ambienti.} che @command{gawk} usa internamente
+per effettuare l'ordinamento.
+
address@hidden "@@ind_str_desc"
+Ordinare come fa @code{"@@ind_str_asc"}, ma gli
+indici di tipo stringa sono ordinati dal address@hidden alto al address@hidden
basso.
+
address@hidden "@@ind_num_desc"
+Ordinare come fa @code{"@@ind_num_asc"}, ma gli
+indici numerici sono ordinati dal address@hidden alto al address@hidden basso.
+
address@hidden "@@val_type_desc"
+Ordinare come fa @code{"@@val_type_asc"}, ma i valori
+degli elementi, a seconda del tipo, sono ordinati dal address@hidden alto al
address@hidden basso.
+I sottovettori, se presenti, vengono per primi.
+
address@hidden "@@val_str_desc"
+Ordinare come fa @code{"@@val_str_asc"}, ma i valori degli
+elementi, trattati come stringhe, sono ordinati dal address@hidden alto al
address@hidden basso.
+I sottovettori, se presenti, vengono per primi.
+
address@hidden "@@val_num_desc"
+Ordinare come fa @code{"@@val_num_asc"}, ma i valori degli
+elementi, trattati come numeri, sono ordinati dal address@hidden alto al
address@hidden basso.
+I sottovettori, se presenti, vengono per primi.
address@hidden table
+
+L'ordine in cui il vettore @`e visitato viene determinato prima di iniziare
+l'esecuzione del ciclo @code{for}. Cambiare @code{PROCINFO["sorted_in"]}
+all'interno del corpo del ciclo non influisce sul ciclo stesso.
+Per esempio:
+
address@hidden
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{ a[4] = 4}
+> @kbd{ a[3] = 3}
+> @kbd{ for (i in a)}
+> @kbd{ print i, a[i]}
+> @address@hidden'}
address@hidden 4 4
address@hidden 3 3
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{ PROCINFO["sorted_in"] = "@@ind_str_asc"}
+> @kbd{ a[4] = 4}
+> @kbd{ a[3] = 3}
+> @kbd{ for (i in a)}
+> @kbd{ print i, a[i]}
+> @address@hidden'}
address@hidden 3 3
address@hidden 4 4
address@hidden example
+
+Quando si ordina un vettore in base al valore dei suoi elementi, se viene
+trovato un valore che @`e un sottovettore, questo @`e considerato
address@hidden grande di
+qualsiasi stringa o valore numerico, indipendentemente da quel che contiene
+lo stesso sottovettore, e tutti i sottovettori sono trattati come se fossero
+l'uno uguale all'altro. Il loro ordine reciproco @`e determinato dai loro
+indici, visti come stringhe.
+
+Di seguito sono elencati alcuni punti da tener presenti sulla visita
+ordinata dei vettori:
+
address@hidden @value{BULLET}
address@hidden
+Il valore di @code{PROCINFO["sorted_in"]} @`e globale. address@hidden, ha
effetto su tutti
+i cicli @code{for} relativi a qualsiasi vettore. Se si deve cambiarlo
+all'interno del proprio codice, si dovrebbe vedere se era address@hidden stato
+definito in precedenza, e salvare il valore relativo, per ripristinarlo
+successivamente:
+
address@hidden
address@hidden
+if ("sorted_in" in PROCINFO) @{
+ ordine_salvato = PROCINFO["sorted_in"]
+ PROCINFO["sorted_in"] = "@@val_str_desc" # o qualcos'altro
address@hidden
address@hidden
+if (ordine_salvato)
+ PROCINFO["sorted_in"] = ordine_salvato
address@hidden example
+
address@hidden
+Come address@hidden accennato, l'ordine di visita di default del vettore
address@hidden rappresentato da @code{"@@unsorted"}. Si address@hidden
ottenere il comportamento di
+default anche assegnando la stringa nulla a @code{PROCINFO["sorted_in"]} o
+semplicemente eliminando l'elemento @code{"sorted_in"} dal vettore
address@hidden con l'istruzione @code{delete}.
+(L'istruzione @code{delete} non @`e stata ancora descritta;
@pxref{Cancellazione}.)
address@hidden itemize
+
+Inoltre, @command{gawk} fornisce funzioni predefinite per l'ordinamento
+dei vettori; si veda @ref{Funzioni di ordinamento di vettori}.
+
address@hidden Indici numerici di vettore
address@hidden Usare numeri per indicizzare i vettori
+
address@hidden numeri, come indici di vettore
address@hidden vettori, indici numerici di
address@hidden indici di vettori, numeri come
address@hidden @code{CONVFMT}, variabile, e indici di vettore
+Un aspetto importante da ricordare riguardo ai vettori @`e che
address@hidden indici dei vettori sono sempre stringhe}.
+Quando un valore numerico @`e usato come indice,
+viene convertito in un valore di tipo stringa prima di essere usato per
+l'indicizzazione (@pxref{Conversione}).
address@hidden vuol dire che il valore della variabile predefinita
@code{CONVFMT} address@hidden
+influire su come un programma ha accesso agli elementi di un vettore.
+Per esempio:
+
address@hidden
+xyz = 12.153
+dati[xyz] = 1
+CONVFMT = "%2.2f"
+if (xyz in dati)
+ printf "%s @`e in dati\n", xyz
+else
+ printf "%s non @`e in dati\n", xyz
address@hidden example
+
address@hidden
+Il risultato @`e @samp{12.15 non @`e in dati}. La prima istruzione
address@hidden a
address@hidden un valore numerico. L'assegnamento a @code{dati[xyz]}
+indicizza @code{dati} col valore di tipo stringa @code{"12.153"}
+(usando il valore di conversione di default @code{CONVFMT}, @code{"%.6g"}).
+Quindi, all'elemento del vettore @code{dati["12.153"]} @`e assegnato il valore
+uno. Il programma cambia poi
+il valore di @code{CONVFMT}. La verifica @samp{(xyz in dati)} genera un nuovo
+valore di stringa da @code{xyz}---questa volta @code{"12.15"}---perch@'e il
+valore di @code{CONVFMT} consente solo due cifre decimali. Questa
+verifica address@hidden esito negativo, perch@'e @code{"12.15"} @`e diverso da
@code{"12.153"}.
+
address@hidden convertire numeri interi che sono indici di vettore
address@hidden numeri interi, indici di vettore
+Secondo le regole di conversione
+(@pxref{Conversione}), i valori numerici interi
+vengono convertiti in stringhe sempre come interi, indipendentemente dal
+valore che potrebbe avere @code{CONVFMT}. E infatti il caso
+seguente produce il risultato atteso:
+
address@hidden
+for (i = 1; i <= maxsub; i++)
+ @ii{fa qualcosa con} vettore[i]
address@hidden example
+
+La regola ``i valori numerici interi si convertono sempre in stringhe intere''
+ha un'altra conseguenza per l'indicizzazione dei vettori.
+Le costanti ottali ed esadecimali
address@hidden
+(@pxref{Numeri non-decimali})
address@hidden ifnotdocbook
address@hidden
+(trattate in @ref{Numeri non-decimali})
address@hidden ifdocbook
+vengono convertite internamente in numeri, e la loro forma originale
+non viene address@hidden ricordata. address@hidden significa, per esempio, che
address@hidden,
address@hidden e
address@hidden fanno riferimento tutti allo stesso
+elemento!
+
+Come molte cose in @command{awk}, molto spesso le cose
+funzionano come ci si aspetta. @`E utile comunque avere una
+conoscenza precisa delle regole applicate, poich@'e a volte possono avere
+effetti difficili da individuare sui programmi.
+
address@hidden Indici non inizializzati
address@hidden Usare variabili non inizializzate come indici
+
address@hidden variabili non inizializzate, come indici di vettore
address@hidden non inizializzate, variabili, come indici di vettore
address@hidden indici di vettore, variabili non inizializzate come
address@hidden vettori, indici, variabili non inizializzate come
+Supponiamo che sia necessario scrivere un programma
+per stampare i dati di input in ordine inverso.
+Un tentativo ragionevole per far address@hidden (con qualche dato di
+prova) potrebbe essere qualcosa di questo tipo:
+
address@hidden
+$ @kbd{echo 'riga 1}
+> @kbd{riga 2}
+> @kbd{riga 3' | awk '@{ l[righe] = $0; ++righe @}}
+> @kbd{END @{}
+> @kbd{for (i = righe - 1; i >= 0; i--)}
+> @kbd{print l[i]}
+> @address@hidden'}
address@hidden riga 3
address@hidden riga 2
address@hidden example
+
+Sfortunatamente, la prima riga di dati in input non appare
+nell'output!
+
+A prima vista, verrebbe da dire che questo programma avrebbe dovuto
+funzionare. La variabile @code{righe}
+non @`e inizializzata, e le variabili non inizializzate hanno il valore
numerico
+zero. address@hidden@dotless{i}}, @command{awk} dovrebbe aver stampato il
valore @code{l[0]}.
+
+Qui il problema @`e che gli indici per i vettori di @command{awk} sono
address@hidden stringhe. Le variabili non inizializzate, quando sono usate come
+stringhe, hanno il valore @code{""}, e non zero. Quindi, @samp{riga 1}
+finisce per essere memorizzata in @code{l[""]}.
+La seguente variante del programma funziona correttamente:
+
address@hidden
address@hidden l[righe++] = $0 @}
+END @{
+ for (i = righe - 1; i >= 0; i--)
+ print l[i]
address@hidden
address@hidden example
+
+Qui, @samp{++} forza @code{righe} a essere di tipo numerico, rendendo
+quindi il ``vecchio valore'' uno zero numerico. Questo viene poi convertito
+in @code{"0"} come l'indice del vettore.
+
address@hidden nulle, stringhe, come indici di vettore
address@hidden stringhe nulle, come indici di vettore
address@hidden angolo buio, indici di vettori
address@hidden @dfn{lint}, controlli, indici di vettori
address@hidden controlli @dfn{lint}, indici di vettori
+Anche se la cosa address@hidden sembrare strana, la stringa nulla
+(@code{""}) @`e un indice di vettore valido.
address@hidden
+Se viene fornita l'opzione @option{--lint} sulla riga di comando
address@hidden), @command{gawk} avvisa quando la stringa nulla viene usata
+come indice.
+
address@hidden Cancellazione
address@hidden L'istruzione @code{delete}
address@hidden @code{delete}, istruzione
address@hidden istruzione @code{delete}
address@hidden eliminare elementi di vettori
address@hidden vettori, elementi, eliminazione di
address@hidden elementi di vettori, eliminazione di
+
+Per rimuovere un singolo elemento da un vettore si usa l'istruzione
address@hidden:
+
address@hidden
+delete @address@hidden
address@hidden example
+
+Una volta che un elemento di un vettore @`e stato eliminato, il valore che
aveva
+quell'elemento non @`e address@hidden disponibile. @`E come se quell'elemento
non sia
+mai stato referenziato oppure come se non gli sia mai stato assegnato un
+valore. Il seguente @`e un esempio di eliminazione di elementi da un vettore:
+
address@hidden
+for (i in frequenze)
+ delete frequenze[i]
address@hidden example
+
address@hidden
+Quest'esempio rimuove tutti gli elementi dal vettore @code{frequenze}. Una
+volta che un elemento @`e stato eliminato, una successiva istruzione @code{for}
+che visiti il vettore non address@hidden quell'elemento, e l'uso dell'operatore
address@hidden per controllare la presenza di quell'elemento restituisce zero
(address@hidden
+falso):
+
address@hidden
+delete pippo[4]
+if (4 in pippo)
+ print "Questo non address@hidden mai stampato"
address@hidden example
+
address@hidden nulle, stringhe, ed eliminazione di elementi di un vettore
address@hidden stringhe nulle, ed eliminazione di elementi di un vettore
address@hidden importante notare che eliminare un elemento @emph{non} @`e la
stessa cosa
+che assegnargli un valore nullo (la stringa vuota, @code{""}).
+Per esempio:
+
address@hidden
+pippo[4] = ""
+if (4 in pippo)
+ print "Questo viene stampato, anche se pippo[4] @`e vuoto"
address@hidden example
+
address@hidden @dfn{lint}, controlli, elementi di vettori
address@hidden controlli @dfn{lint}, elementi di vettori
address@hidden elementi di vettori, controlli @dfn{lint} per
+Non @`e un errore eliminare un elemento che non esiste.
+Tuttavia, se viene data l'opzione @option{--lint} sulla riga di comando
+(@pxref{Opzioni}),
address@hidden emette un messaggio di avvertimento quando viene eliminato un
+elemento che non @`e presente in un vettore.
+
address@hidden comuni, estensioni, @code{delete} per eliminare interi vettori
address@hidden estensioni address@hidden @code{delete} per eliminare interi
vettori
address@hidden vettori, eliminare l'intero contenuto
address@hidden eliminare interi vettori
address@hidden @code{delete}, @var{vettore}
address@hidden differenze tra @command{awk} e @command{gawk}, elementi dei
vettori, eliminazione
+Tutti gli elementi di un vettore possono essere eliminati con una singola
+istruzione omettendo l'indice nell'istruzione @code{delete},
+in questo modo:
+
+
address@hidden
+delete @var{vettore}
address@hidden example
+
+L'uso di questa versione dell'istruzione @code{delete} @`e circa tre volte
address@hidden
+efficiente dell'equivalente ciclo che elimina gli elementi uno
+alla volta.
+
+Questa forma dell'istruzione @code{delete} @`e ammessa anche
+da BWK @command{awk} e da @command{mawk}, e anche da
+diverse altre implementazioni.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden NOTA
+Per molti anni, l'uso di @code{delete} senza un indice era un'estensione
+comune. A settembre 2012 si @`e deciso di includerla nello
+standard POSIX. Si veda @uref{http://austingroupbugs.net/view.php?id=544,
+il sito dell'Austin Group}.
address@hidden quotation
+
address@hidden address@hidden, eliminazione di elementi di un vettore
address@hidden Brennan, Michael
+La seguente istruzione fornisce un modo portabile, anche se non evidente,
+per svuotare un vettore:@footnote{Un ringraziamento a Michael
+Brennan per la segnalazione.}
+
address@hidden
+split("", vettore)
address@hidden example
+
address@hidden @code{split()}, funzione, eliminazione di elementi di vettori
address@hidden funzione @code{split()}, eliminazione di elementi di vettori
+La funzione @code{split()}
+(@pxref{Funzioni per stringhe})
+dapprima svuota il vettore indicato. La chiamata chiede di dividere
+la stringa nulla. Poich@'e non c'@`e nulla da dividere, la
+funzione si limita a svuotare il vettore e poi termina.
+
address@hidden ATTENZIONE
+L'eliminazione di tutti gli elementi di un vettore non cambia il suo tipo; non
+si address@hidden svuotare un vettore e poi usare il nome del vettore come
scalare
+(address@hidden, come una variabile semplice). Per esempio, questo non @`e
consentito:
+
address@hidden
+a[1] = 3
+delete a
+a = 3
address@hidden example
address@hidden quotation
+
address@hidden Vettori multidimensionali
address@hidden Vettori multidimensionali
+
address@hidden
+* Visitare vettori multidimensionali:: Visitare vettori multidimensionali.
address@hidden menu
+
address@hidden indici di vettori multidimensionali
address@hidden vettori multidimensionali
address@hidden multidimensionali, vettori
+Un @dfn{vettore multidimensionale} @`e un vettore in cui un elemento @`e
+identificato da un insieme di indici invece che da un indice singolo. Per
+esempio, un vettore bidimenisonale richiede due indici. Il modo consueto (in
+molti linguaggi, compreso @command{awk}) per far riferimento a un elemento di
+un vettore multidimensionale chiamato @code{griglia} @`e con
address@hidden@var{x},@var{y}]}.
+
address@hidden @code{SUBSEP}, variabile, e vettori multidimensionali
address@hidden variabile @code{SUBSEP}, e vettori multidimensionali
+I vettori multidimensionali sono resi disponibili in @command{awk} attraverso
+la concatenazione di address@hidden indici in una stringa;
address@hidden converte gli indici in stringhe
+(@pxref{Conversione}) e
+le concatena assieme, inserendo un separatore tra ognuna di loro. Ne
+risulta una sola stringa che include i valori di ogni indice. La
+stringa address@hidden@dotless{i}} composta viene usata come un singolo indice
in un vettore
+ordinario monodimensionale. Il separatore usato @`e il valore della variabile
+predefinita @code{SUBSEP}.
+
+Per esempio, supponiamo di valutare l'espressione @samp{pippo[5,12] = "valore"}
+quando il valore di @code{SUBSEP} @`e @code{"@@"}. I numeri 5 e 12 vengono
+convertiti in stringhe che sono poi
+concatenate con un @samp{@@} tra di essi, dando @code{"5@@12"}; di conseguenza,
+l'elemento del vettore @code{pippo["5@@12"]} @`e impostato a @code{"valore"}.
+
+Una volta che il valore dell'elemento @`e memorizzato, @command{awk}
+ignora se sia stato memorizzato con un solo indice o con una
+serie di indici. Le due espressioni @samp{pippo[5,12]} e
address@hidden@samp{pippo[5 SUBSEP 12]}} sono sempre equivalenti.
+
+Il valore di default di @code{SUBSEP} @`e la stringa @code{"\034"},
+che contiene un carattere non stampabile che difficilmente appare in
+un programma di @command{awk} e nella maggior parte dei dati di input.
+Il vantaggio di scegliere un carattere improbabile discende dal fatto che i
+valori degli indici che contengono una stringa corrispondente a @code{SUBSEP}
+possono portare a stringhe risultanti ambigue. Supponendo che
address@hidden valga @code{"@@"}, @address@hidden"a@@b", "c"]}} e
address@hidden@samp{pippo["a", "b@@c"]}} risultano indistinguibili perch@'e
entrambi
+sarebbero in address@hidden memorizzati come @samp{pippo["a@@b@@c"]}.
+
address@hidden @code{in}, operatore, verificare se un elemento esiste in un
vettore multidimensionale
+Per verificare se una determinata sequenza di indici esiste in un vettore
+multidimensionale, si usa lo stesso operatore (@code{in}) che viene usato
+per i vettori monodimensionali. Si scrive l'intera sequenza di indici tra
+parentesi, separati da virgole, come operando di sinistra:
+
address@hidden
+if ((@var{indice1}, @var{indice2}, @dots{}) in @var{vettore})
+ @dots{}
address@hidden example
+
+Qui vediamo un esempio, avendo in input un vettore bidimensionale
+di campi, ruota questo vettore di 90 gradi in senso orario e stampa il
+risultato. Si suppone che tutte le righe in input contengano lo stesso
+numero di elementi:
+
address@hidden
address@hidden
+ if (max_nf < NF)
+ max_nf = NF
+ max_nr = NR
+ for (x = 1; x <= NF; x++)
+ vettore[x, NR] = $x
address@hidden
+
+END @{
+ for (x = 1; x <= max_nf; x++) @{
+ for (y = max_nr; y >= 1; --y)
+ printf("%s ", vettore[x, y])
+ printf("\n")
+ @}
address@hidden
address@hidden example
+
address@hidden
+Dato l'input:
+
address@hidden
+1 2 3 4 5 6
+2 3 4 5 6 1
+3 4 5 6 1 2
+4 5 6 1 2 3
address@hidden example
+
address@hidden
+il programma produce il seguente output:
+
address@hidden
+4 3 2 1
+5 4 3 2
+6 5 4 3
+1 6 5 4
+2 1 6 5
+3 2 1 6
address@hidden example
+
address@hidden Visitare vettori multidimensionali
address@hidden Visitare vettori multidimensionali
+
+Non c'@`e un'istruzione @code{for} particolare per visitare un
+vettore ``multidimensionale''. Non ce ne address@hidden essere una, perch@'e
address@hidden in address@hidden non ha
+vettori o elementi multidimensionali: c'@`e solo una address@hidden
+multidimensionale per @emph{accedere} a un vettore.
+
address@hidden indici di vettori multidimensionali, visitare gli
address@hidden vettori, multidimensionali, visitare
address@hidden visitare vettori multidimensionali
+Comunque, se un programma ha un vettore al quale si accede sempre in
address@hidden multidimensionale, si address@hidden ottenere il risultato di
visitarlo
+combinando l'istruzione di visita @code{for}
+(@pxref{Visitare un intero vettore}) con la funzione
+interna @code{split()}
+(@pxref{Funzioni per stringhe}).
+Si procede nel seguente modo:
+
address@hidden
+for (indice_combinato in vettore) @{
+ split(indice_combinato, indici_separati, SUBSEP)
+ @dots{}
address@hidden
address@hidden example
+
address@hidden
+Questo imposta la variabile @code{indice_combinato} a ogni
+concatenazione di indici contenuta nel vettore, e la suddivide
+nei singoli indici separandoli
+in corrispondenza del valore di
address@hidden I singoli indici diventano poi gli elementi
+del vettore @code{indici_separati}.
+
address@hidden, se un valore @`e stato precedentemente memorizzato in
address@hidden, "pippo"]}, esiste in @code{vettore} un elemento con indice
address@hidden"1\034pippo"} (ricordare che il valore di default di @code{SUBSEP}
address@hidden il carattere con codice ottale 034).
+Prima o poi, l'istruzione @code{for} trova quell'indice e fa un'iterazione
+con la variabile @code{indice_combinato} impostata a @code{"1\034pippo"}.
+Poi viene chiamata la funzione @code{split()} in questo modo:
+
address@hidden
+split("1\034pippo", indici_separati, "\034")
address@hidden example
+
address@hidden
+Il risultato @`e quello di impostare @code{indici_separati[1]} a @code{"1"} e
address@hidden a @code{"pippo"}. Ecco fatto!
+La sequenza originale degli indici separati @`e ripristinata.
+
+
address@hidden Vettori di vettori
address@hidden Vettori di vettori
address@hidden vettori di vettori
+
address@hidden migliora l'accesso ai vettori multidimensionali di
address@hidden standard e mette a disposizione dei veri vettori di vettori.
+Agli elementi di un sottovettore si fa riferimento tramite il loro indice
+racchiuso tra parentesi quadre, proprio come gli elementi del vettore
+principale. Per esempio, quel che segue crea un sottovettore con due elementi
+all'indice @code{1} del vettore principale @code{a}:
+
address@hidden
+a[1][1] = 1
+a[1][2] = 2
address@hidden example
+
+Questo simula un vero vettore bidimensionale. Ogni elemento di un sottovettore
address@hidden contenere un altro sottovettore come valore, che a sua volta
address@hidden
+contenere anche ulteriori vettori. In questo modo, si possono creare vettori
+di tre o address@hidden dimensioni.
+Gli indici possono essere costituiti da qualunque espressione di
address@hidden, compresi dei
+valori scalari separati da virgole (address@hidden, un indice
multidimensionale simulato
+di @command{awk}). Quindi, la seguente espressione @`e valida in
address@hidden:
+
address@hidden
+a[1][3][1, "nome"] = "barney"
address@hidden example
+
+Ogni sottovettore e il vettore principale possono essere di diversa lunghezza.
+Di fatto, gli elementi di un vettore o un suo sottovettore non devono essere
+necessariamente tutti dello stesso tipo. address@hidden significa che il
vettore
+principale come anche uno qualsiasi dei suoi sottovettori address@hidden essere
+non rettangolare,
+o avere una struttura frastagliata. Si address@hidden assegnare un valore
scalare
+all'indice @code{4} del vettore principale @code{a}, anche se @code{a[1]}
address@hidden esso stesso un vettore e non uno scalare:
+
address@hidden
+a[4] = "Un elemento in un vettore frastagliato"
address@hidden example
+
+I termini @dfn{dimensione}, @dfn{riga} e @dfn{colonna} sono privi di
+significato quando sono applicati
+a questo tipo di vettore, ma d'ora in poi useremo ``dimensione'' per indicare
+il numero massimo di indici necessario per far riferimento a un elemento
+esistente. Il tipo di ogni elemento che @`e address@hidden stato assegnato non
address@hidden essere
+cambiato assegnando un valore di tipo diverso. Prima si deve eliminare
+l'elemento corrente, per togliere completamente dalla memoria di
address@hidden ogni riferimento a quell'indice:
+
address@hidden
+delete a[4]
+a[4][5][6][7] = "Un elemento in un vettore quadridimensionale"
address@hidden example
+
address@hidden
+Le due istruzioni rimuovono il valore scalare dall'indice @code{4} e
+inseriscono poi un
+sottovettore interno a tre indici contenente uno scalare. Si address@hidden
anche
+eliminare un intero sottovettore o un sottovettore di sottovettori:
+
address@hidden
+delete a[4][5]
+a[4][5] = "Un elemento nel sottovettore a[4]"
address@hidden example
+
+Si deve address@hidden ricordare che non @`e consentito eliminare il vettore
principale
address@hidden e poi usarlo come scalare.
+
+Le funzioni predefinite che accettano come argomenti dei vettori possono
+essere usate
+anche con i sottovettori. Per esempio, il seguente frammento di codice usa
address@hidden()} (@pxref{Funzioni per stringhe})
+per determinare il numero di elementi nel vettore principale @code{a}
+e nei suoi sottovettori:
+
address@hidden
+print length(a), length(a[1]), length(a[1][3])
address@hidden example
+
address@hidden
+Il risultato per il nostro vettore principale @code{a} @`e il seguente:
+
address@hidden
+2, 3, 1
address@hidden example
+
address@hidden
+L'espressione @address@hidden in @var{vettore}}
+(@pxref{Visitare elementi}) funziona allo stesso modo sia per
+i vettori regolari in stile @command{awk}
+che per i vettori di vettori. Per esempio, le espressioni @samp{1 in a},
address@hidden in a[1]} e @samp{(1, "nome") in a[1][3]} risultano tutte di
valore
+uno (vero) per il nostro vettore @code{a}.
+
+L'istruzione @samp{for (elemento in vettore)} (@pxref{Visitare un intero
vettore})
address@hidden essere nidificata per visitare tutti gli
+elementi di un vettore di vettori che abbia una struttura rettangolare. Per
+stampare il contenuto (valori scalari) di un vettore di vettori bidimensionale
+(address@hidden nel quale ogni elemento di primo livello @`e esso stesso un
+vettore, non necessariamente di lunghezza uguale agli altri)
+si address@hidden usare il seguente codice:
+
address@hidden
+for (i in vettore)
+ for (j in vettore[i])
+ print vettore[i][j]
address@hidden example
+
+La funzione @code{isarray()} (@pxref{Funzioni per i tipi})
+permette di verificare se un elemento di un vettore @`e esso stesso un vettore:
+
address@hidden
+for (i in vettore) @{
+ if (isarray(vettore[i]) @{
+ for (j in vettore[i]) @{
+ print vettore[i][j]
+ @}
+ @}
+ else
+ print vettore[i]
address@hidden
address@hidden example
+
+Se la struttura di un vettore di vettori frastagliato @`e nota in anticipo,
+si address@hidden spesso trovare il modo per visitarlo usando istruzioni di
controllo.
+Per esempio,
+il seguente codice stampa gli elementi del nostro vettore principale @code{a}:
+
address@hidden
+for (i in a) @{
+ for (j in a[i]) @{
+ if (j == 3) @{
+ for (k in a[i][j])
+ print a[i][j][k]
+ @} else
+ print a[i][j]
+ @}
address@hidden
address@hidden example
+
address@hidden
address@hidden vettori} per una funzione definita dall'utente che
+``visita'' un vettore di vettori di dimensioni arbitrarie.
+
+Si ricordi che un riferimento a un elemento di un vettore non
+inizializzato genera un elemento con valore uguale a @code{""}, la stringa
+nulla. Questo ha
+un'importante implicazione quando s'intende usare un sottovettore come
+argomento di una funzione, come illustrato nel seguente esempio:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ split("a b c d", b[1]); print b[1][1] @}'}
address@hidden gawk: riga com.:1: fatale: split: secondo argomento
address@hidden non-vettoriale
address@hidden example
+
+Il modo per aggirare quest'ostacolo @`e quello di definire prima @code{b[1]}
+come vettore creando un indice arbitrario:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ b[1][1] = ""; split("a b c d", b[1]); print b[1][1] @}'}
address@hidden a
address@hidden example
+
address@hidden Sommario dei vettori
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
address@hidden standard dispone di vettori associativi monodimensionali
+(vettori indicizzati da valori di tipo stringa). Tutti i vettori sono
+associativi; gli indici numerici vengono convertiti automaticamente in
+stringhe.
+
address@hidden
+Agli elementi dei vettori si fa riferimento come
address@hidden@address@hidden Fare riferimento a un elemento lo
+crea se questo non esiste ancora.
+
address@hidden
+Il modo corretto per vedere se un vettore ha un elemento con un dato indice
address@hidden quello di usare l'operatore @code{in}: @address@hidden in
@var{vettore}}.
+
address@hidden
+Si usa @samp{for (@var{indice} in @var{vettore}) @dots{}} per visitare
+ogni singolo elemento di un vettore. Nel corpo del ciclo,
address@hidden assume via via il valore dell'indice di ogni elemento del
vettore.
+
address@hidden
+L'ordine in cui il ciclo @samp{for (@var{indice} in @var{vettore})}
+attraversa un vettore non @`e definito in POSIX @command{awk} e varia a seconda
+dell'implementazione. @command{gawk} consente di controllare l'ordinamento
+di visita
+assegnando speciali valori predefiniti a @code{PROCINFO["sorted_in"]}.
+
address@hidden
+Si usa @samp{delete @address@hidden per eliminare un singolo
+elemento di un vettore.
+Per eliminare tutti gli elementi di un vettore,
+si usa @samp{delete @var{vettore}}.
+Quest'ultima address@hidden @`e stata per molti anni un'estensione comune
+e ora @`e standard, ma potrebbe non essere disponibile in tutte le
+versioni commerciali di @command{awk}.
+
address@hidden
address@hidden standard simula vettori multidimensionali ammettendo
address@hidden indici
+separati da virgole. I loro valori sono concatenati in un'unica
+stringa, separati dal valore di @code{SUBSEP}. Il modo di creazione
+dell'indice non viene immagazzinato; address@hidden@dotless{i}},
+cambiare @code{SUBSEP} potrebbe avere conseguenze inaspettate. Si
address@hidden usare
address@hidden(@var{sub1}, @var{sub2}, @dots{}) in @var{vettore}} per vedere se
+un certo indice multidimensionale esiste in @var{vettore}.
+
address@hidden
address@hidden consente di avere a disposizione veri vettori di vettori.
+Si usa una coppia
+di parentesi quadre per ogni dimensione in tali vettori:
address@hidden, per esempio. Gli elementi del vettore possono
+poi essere valori scalari (numeri o stringhe) o altri vettori.
+
address@hidden
+Si usa la funzione predefinita @code{isarray()} per determinare se un elemento
+di un vettore @`e esso stesso un sottovettore.
+
address@hidden itemize
+
address@hidden Funzioni
address@hidden Funzioni
+
address@hidden funzioni predefinite
address@hidden predefinite, funzioni
+Questo @value{CHAPTER} descrive le funzioni predefinite di @command{awk},
+che sono di tre tipi: numeriche, di stringa, e di I/O.
address@hidden mette a disposizione ulteriori tipi di funzioni
+per gestire valori che rappresentano marcature temporali, per manipolare bit,
per
+ordinare vettori, per fornire informazioni sui tipi di variabile,
+per internazionalizzare e localizzare i address@hidden
+un'introduzione alle tematiche suddette, si address@hidden consultare
l'articolo
+"Localizzazione dei programmi" nel
address@hidden://www.pluto.it/files/journal/pj0404/l10n.html, sito pluto.it.}}
+
+Oltre alle funzioni predefinite, @command{awk} consente di
+scrivere nuove funzioni utilizzabili all'interno di un programma.
+La seconda address@hidden di questo @value{CHAPTER} descrive le funzioni
address@hidden dall'utente}.
+Vengono infine descritte le chiamate indirette a una funzione, un'estensione
+specifica di @command{gawk} che consente di stabilire durante l'esecuzione del
+programma quale funzione chiamare.
+
address@hidden
+* Funzioni predefinite:: Riepilogo delle funzioni predefinite.
+* Funzioni definite dall'utente:: Descrizione dettagliata delle funzioni
+ definite dall'utente.
+* Chiamate indirette:: Scegliere la funzione da chiamare in
+ fase di esecuzione del programma.
+* Sommario delle funzioni:: Sommario delle funzioni.
address@hidden menu
+
address@hidden Funzioni predefinite
address@hidden Funzioni predefinite
+
+Le funzioni @dfn{predefinite} sono sempre disponibili per essere chiamate
+da un programma @command{awk}. Questa @value{SECTION} definisce tutte le
+funzioni predefinite di @command{awk}; di alcune di queste si fa menzione
+in altre @value{SECTIONS},
+ma sono comunque riassunte anche qui per address@hidden
+
address@hidden
+* Chiamare funzioni predefinite:: Come chiamare funzioni predefinite.
+* Funzioni numeriche:: Funzioni che trattano numeri, comprese
+ @code{int()}, @code{sin()} e @code{rand()}.
+* Funzioni per stringhe:: Funzioni di manipolazione di stringhe,
+ come @code{split()}, @code{match()}
+ e @code{sprintf()}.
+* Funzioni di I/O:: Funzioni per i file e per i comandi
+ della shell.
+* Funzioni di tempo:: Funzione per gestire marcature temporali.
+* Funzioni a livello di bit:: Funzioni per operazioni di
+ manipolazione bit.
+* Funzioni per i tipi:: Funzioni per informazioni sul tipo
+ di una variabile.
+* Funzioni di internazionalizzazione:: Funzioni per tradurre stringhe.
address@hidden menu
+
address@hidden Chiamare funzioni predefinite
address@hidden Chiamare funzioni predefinite
+
+Per chiamare una delle funzioni predefinite di @command{awk},
+si scrive il nome della funzione seguito dai suoi argomenti racchiusi
+tra parentesi. Per esempio, @samp{atan2(y + z, 1)}
address@hidden una chiamata alla funzione @code{atan2()} e ha due argomenti.
+
address@hidden convenzioni di programmazione, nelle chiamate di funzione
address@hidden spazio bianco, nelle chiamate di funzione
+La presenza di spazi bianchi tra il nome della funzione predefinita
+e la parentesi aperta @`e consentita, ma @`e buona norma quella di evitare
+di inserire spazi bianchi in quella posizione.
+Le funzioni definite dall'utente non consentono che vi siano spazi bianchi
+fra nome funzione e aperta parentesi,
+ed @`e address@hidden semplice evitare errori seguendo una semplice
convenzione che
+resta sempre valida: non inserire spazi dopo il nome di una funzione.
+
address@hidden risoluzione di problemi, @command{gawk}, errori address@hidden
argomenti di funzione e
address@hidden problemi, risoluzione di, @command{gawk}, errori address@hidden
argomenti di funzione e
address@hidden @command{gawk}, argomenti di funzione e
address@hidden differenze tra @command{awk} e @command{gawk}, argomenti di
funzione (@command{gawk})
+Ogni funzione predefinita accetta un certo numero di argomenti.
+In alcuni casi, gli argomenti possono essere omessi. I valori di default per
+gli argomenti omessi variano
+da funzione a funzione e sono descritti insieme a
+ciascuna funzione. In alcune implementazioni di @command{awk}, gli
+eventuali argomenti in address@hidden specificati per le funzioni predefinite
sono
+ignorati. Tuttavia, in @command{gawk},
address@hidden un errore fatale fornire argomenti in address@hidden a una
funzione predefinita.
+
+Quando si richiama una funzione viene calcolato, prima di effettuare la
+chiamata, il valore assunto dalle espressioni che descrivono i parametri
+da passare alla funzione.
+Per esempio, nel seguente frammento di codice:
+
address@hidden
+i = 4
+j = sqrt(i++)
address@hidden example
+
address@hidden ordine di valutazione, funzioni
address@hidden funzioni predefinite, ordine di valutazione
address@hidden predefinite, funzioni, ordine di valutazione
address@hidden
+la variabile @code{i} @`e incrementata al valore cinque prima di chiamare
+la funzione @code{sqrt()} alla quale viene fornito come parametro il valore
+quattro.
+L'ordine di valutazione delle espressioni usate come parametri per la
+funzione @`e indefinito. Per questo motivo, si deve evitare di scrivere
+programmi che presuppongono che i parametri siano valutati da sinistra a
+destra o da destra a sinistra. Per esempio:
+
address@hidden
+i = 5
+j = atan2(++i, i *= 2)
address@hidden example
+
+Se l'ordine di valutazione @`e da sinistra a destra, @code{i} assume dapprima
+il valore 6, e quindi il valore 12, e la funzione @code{atan2()} @`e chiamata
+con i due argomenti 6 e 12. Ma se l'ordine di valutazione @`e da destra a
+sinistra, @code{i} assume dapprima il valore 10, e poi il valore 11, e la
+funzione @code{atan2()} @`e chiamata con i due argomenti 11 e 10.
+
address@hidden Funzioni numeriche
address@hidden Funzioni numeriche
address@hidden funzioni numeriche
address@hidden numeriche, funzioni
+
+La seguente lista descrive tutte le
+funzioni predefinite che hanno a che fare con i numeri.
+I parametri facoltativi sono racchiusi tra parentesi address@hidden ([ ]):}
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{atan2(@var{y}, @var{x})}
address@hidden
address@hidden arcotangente
+Restituisce l'arcotangente di @address@hidden / @var{x}} in radianti.
+Si address@hidden usare @samp{pi = atan2(0, -1)} per ottenere il valore di
address@hidden greco.
+
address@hidden @code{cos(@var{x})}
address@hidden
address@hidden coseno
+Restituisce il coseno di @var{x}, con @var{x} in radianti.
+
address@hidden @code{exp(@var{x})}
address@hidden
address@hidden esponenziale
+Restituisce l'esponenziale di @var{x} (@code{e ^ @var{x}}) o un messaggio
+di errore se @var{x} @`e fuori dall'intervallo consentito.
+L'intervallo entro il quale address@hidden variare @var{x}
+dipende dalla rappresentazione dei numeri in virgola mobile nella macchina in
+uso.
+
address@hidden @code{int(@var{x})}
address@hidden
address@hidden arrotondamento all'intero address@hidden vicino
+Restituisce l'intero address@hidden vicino a @var{x}, situato tra @var{x} e
zero,
+troncato togliendo i decimali.
+Per esempio, @code{int(3)} @`e 3, @code{int(3.9)} @`e 3, @code{int(-3.9)}
address@hidden @minus{}3, e @code{int(-3)} @`e ancora @minus{}3.
+
address@hidden @code{intdiv(@var{numeratore}, @var{denominatore},
@var{risultato})}
address@hidden
address@hidden funzione @code{intdiv}
+Esegue una divisione tra numeri interi, simile alla funzione standard C
+che ha lo stesso nome. Dapprima, il @code{numeratore} e il
address@hidden vengono troncati, eliminando la parte decimale,
+per trasformarli in numeri interi.
+Il vettore @code{risultato} viene dapprima svuotato, e poi viene impostato
+l'elemento @code{risultato["quotient"]} al risultato della divisione
address@hidden / denominatore}, troncato a numero intero
+mediante l'eliminazione dei decimali,
+e viene impostato l'elemento @code{risultato["remainder"]} al
+risultato dell'operazione @samp{numeratore % denominatore}, troncato a
+numero intero allo stesso modo del risultato. Questa funzione @`e
+rivolta principalmente a chi usa numeri interi di lunghezza arbitraria;
+consente di evitare la creazione di numeri in virgola mobile
+di precisione arbitaria usando la address@hidden MPFR
+(@pxref{Interi a precisione arbitraria}).
+
+Questa funzione @`e un'estensione @code{gawk}. Non @`e disponibile in
address@hidden compatibile (@pxref{Opzioni}).
+
address@hidden @code{log(@var{x})}
address@hidden
address@hidden logaritmo
+Restituisce il logaritmo naturale di @var{x}, se @var{x} @`e positivo;
+altrimenti, restituisce @code{NaN} (``not a number'') sui sistemi che
+implementano lo standard IEEE 754.
+Inoltre, @command{gawk} stampa un messaggio di avvertimento qualora @code{x}
+sia negativo.
+
address@hidden @code{rand()}
address@hidden
address@hidden numeri casuali, funzioni @code{rand()}/@code{srand()}
+Restituisce un numero casuale. I valori di @code{rand()} sono
+uniformemente distribuiti tra zero e uno.
+Il valore potrebbe essere zero ma non @`e mai address@hidden versione C di
address@hidden()} in molti sistemi Unix
+produce notoriamente delle sequenze piuttosto mediocri di numeri casuali.
+Tuttavia, non @`e prescritto che un'implementazione di @command{awk}
+debba usare la funzione @code{rand()} del linguaggio C per implementare
+la versione @command{awk} di @code{rand()}.
+In effetti, @command{gawk} usa, per generare numeri casuali,
+la funzione @code{random()} di BSD, che @`e
+notevolmente migliore di @code{rand()}}
+
+Spesso servono dei numeri casuali interi invece che frazionari.
+La seguente funzione definita dall'utente address@hidden essere usata per
ottenere
+un numero casuale non negativo inferiore a @var{n}:
+
address@hidden
+function randint(n)
address@hidden
+ return int(n * rand())
address@hidden
address@hidden example
+
address@hidden
+La moltiplicazione produce un numero casuale maggiore o uguale a zero e
+minore di @code{n}. Tramite @code{int()}, questo risultato diventa
+un intero tra zero e @code{n} @minus{} 1, estremi inclusi.
+
+Il seguente esempio usa una funzione simile per generate interi casuali
+fra uno e @var{n}. Il programma stampa un numero casuale per
+ogni record in input:
+
address@hidden
+# funzione per simulare un tiro di dado.
+function roll(n) @{ return 1 + int(rand() * n) @}
+
+# Tira 3 dadi a sei facce e
+# stampa il numero di punti.
address@hidden
+ printf("%d punteggio\n", roll(6) + roll(6) + roll(6))
address@hidden
address@hidden example
+
address@hidden inizializzazione generazione di numeri casuali
address@hidden numeri casuali, inizializzazione generazione di
address@hidden numeri casuali, seme di
address@hidden ATTENZIONE
+Nella maggior parte delle implementazioni di @command{awk}, compreso
address@hidden,
address@hidden()} inizia a generare numeri casuali partendo sempre
+dallo stesso numero, o @dfn{seme}, per ogni invocazione di
address@hidden@address@hidden
+usa un seme differente ogni volta.} @`E per questo motivo che
+un programma genera sempre gli stessi risultati ogni volta che lo si esegue.
+I numeri sono casuali all'interno di una singola esecuzione di @command{awk}
+ma "prevedibili" in ogni successiva esecuzione.
address@hidden torna utile in fase di test, ma se si desidera che
+un programma generi sequenze differenti di numeri casuali ogni volta
+che @`e chiamato, occorre impostare il seme a un valore che cambi
+per ogni esecuzione. Per fare questo, @`e prevista la funzione @code{srand()}.
address@hidden quotation
+
address@hidden @code{sin(@var{x})}
address@hidden
address@hidden seno
+Restituisce il seno di @var{x}, con @var{x} espresso in radianti.
+
address@hidden @code{sqrt(@var{x})}
address@hidden
address@hidden radice quadrata
+Restituisce la radice quadrata positiva di @var{x}.
address@hidden stampa un messaggio di avvertimento
+se @var{x} @`e un numero negativo. Quindi, @code{sqrt(4)} vale 2.
+
address@hidden @code{srand(address@hidden@code{)}
address@hidden
+Imposta al valore @var{x} il numero di partenza, o seme,
+utilizzato per generare numeri casuali.
+
+Ogni seme genera una sequenza particolare di numeri address@hidden
+numeri casuali generati da un computer non sono veramente casuali.
+Tecnicamente sono conosciuti come numeri @dfn{pseudo-casuali}. address@hidden
vuol dire
+che, anche se i numeri in una sequenza sembrano casuali, @`e possibile
+in address@hidden generare la stessa sequenza di numeri casuali address@hidden
e address@hidden volte.}
+Quindi, impostando il seme allo stesso valore una seconda volta,
+viene prodotta ancora la stessa sequenza di numeri casuali.
+
address@hidden ATTENZIONE
+Differenti implementazioni di @command{awk} usano internamente differenti
+generatori di numeri casuali. Non si deve dare per scontato che lo stesso
+programma @command{awk}
+generi la stessa serie di numeri casuali se viene eseguito da differenti
+versioni di @command{awk}.
address@hidden quotation
+
+Se si omette l'argomento @var{x}, scrivendo @samp{srand()}, viene usato
+come seme la data e ora corrente. @`E questo il modo per ottenere numeri
+casuali che sono veramente imprevedibili.
+
+Il valore restituito da @code{srand()} @`e quello del seme precedente.
+Questo per facilitare il monitoraggio dei semi, nel caso occorra riprodurre
+in maniera coerente delle sequenze di numeri casuali.
+
+POSIX non specifica quale debba essere il seme iniziale, che quindi varia
+a seconda delle implementazioni @command{awk}.
address@hidden table
+
address@hidden Funzioni per stringhe
address@hidden Funzioni di manipolazione di stringhe
address@hidden funzioni di manipolazione di stringhe
+
+Le funzioni in questa @value{SECTION} leggono o modificano il testo di
+una o address@hidden stringhe.
+
address@hidden implementa la localizzazione
+(@pxref{Localizzazioni}) ed effettua
+ogni manipolazione di stringhe trattando ogni singolo @emph{carattere}, non
+ogni singolo @emph{byte}.
+Questa distinzione @`e particolarmente importante da comprendere per
+quelle localizzazioni in cui un singolo carattere address@hidden essere
rappresentato
+da address@hidden di un byte.
+Quindi, per esempio, la funzione @code{length()} restituisce il numero di
+caratteri in una stringa, e non il numero di byte usato per rappresentare quei
+caratteri. Allo stesso modo, @code{index()} restituisce indici di caratteri, e
+non indici di byte.
+
address@hidden ATTENZIONE
+Un certo numero di funzioni riguarda indici all'interno di stringhe. Per
+queste funzioni, il primo carattere di una stringa @`e alla posizione
+(all'indice) uno. Questo comportamento @`e differente da quello del C e dei
+linguaggi che da esso discendono, nei quali il primo carattere @`e alla
posizione
+zero. @`E importante ricordarlo quando si fanno calcoli sugli indici, in
+particolare se si ha address@hidden con il linguaggio C.
address@hidden quotation
+
+Nella lista seguente, i parametri facoltativi sono racchiusi tra parentesi
address@hidden ([ ]).}
+Parecchie funzioni operano sostituzioni in una stringa; la spiegazione
+completa di address@hidden @`e contenuta nella descrizione della funzione
@code{sub()},
+che si trova quasi alla fine di questa lista, ordinata alfabeticamente.
+
+Le funzioni specifiche di @command{gawk} sono contrassegnate col simbolo
+del cancelletto (@samp{#}). Tali funzioni non sono disponibili in
address@hidden
+compatibile (@pxref{Opzioni}):
+
+
address@hidden
+* Dettagli ostici:: address@hidden di quel che si vorrebbe sapere su
@samp{\}
+ e @samp{&} con @code{sub()}, @code{gsub()}, e
+ @code{gensub()}.
address@hidden menu
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{asort(address@hidden address@hidden,} @var{destinazione}
address@hidden,} @var{come} ] address@hidden) #}
address@hidden @code{asorti(address@hidden address@hidden,} @var{destinazione}
address@hidden,} @var{come} ] address@hidden) #}
address@hidden
address@hidden vettori, ordinamento dei
address@hidden ordinamento di vettori
address@hidden vettori, determinare il numero degli elementi
address@hidden
address@hidden ordinamento vettori per indici
address@hidden vettori, ordinamento per indici
address@hidden indici di vettori, ordinamento per
+Queste due funzioni sono abbastanza simili, e quindi sono descritte
+insieme.
+
address@hidden NOTA
+La seguente descrizione ignora il terzo argomento, @var{come}, perch@'e
+richiede la conoscenza di address@hidden di cui non si @`e ancora parlato. Per
+questo motivo la seguente trattazione @`e volutamente semplificata. (In
seguito
+l'argomento address@hidden trattato in maniera address@hidden esauriente; si
veda @ref{Funzioni di
+ordinamento di vettori} per la descrizione completa.)
address@hidden quotation
+
+Entrambe le funzioni restituiscono il numero di elementi nel vettore
@var{sorgente}.
+Con @command{asort()}, @command{gawk} ordina i valori di @var{sorgente}
+e rimpiazza gli indici dei valori ordinati di @var{sorgente} con
+numeri interi sequenziali, a partire da uno. Se si specifica il vettore
+opzionale @var{destinazione},
address@hidden @`e copiato in @var{destinazione}. @var{destinazione}
+viene quindi ordinato, lasciando immodificati gli indici di @var{sorgente}.
+
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
+Nel confronto tra stringhe, la variabile @code{IGNORECASE} influenza
+l'ordinamento
+(@pxref{Funzioni di ordinamento di vettori}). Se il vettore
address@hidden contiene sottovettori come valori
+(@pxref{Vettori di vettori}), questi saranno alla fine, dopo tutti i valori
+scalari.
+I sottovettori @emph{non} vengono ordinati ricorsivamente.
+
+Per esempio, se i contenuti del vettore @code{a} sono i seguenti:
+
address@hidden
+a["ultimo"] = "de"
+a["primo"] = "sac"
+a["mediano"] = "cul"
address@hidden example
+
address@hidden
+Una chiamata a @code{asort()}:
+
address@hidden
+asort(a)
address@hidden example
+
address@hidden
+genera i seguenti contenuti di @code{a}:
+
address@hidden
+a[1] = "cul"
+a[2] = "de"
+a[3] = "sac"
address@hidden example
+
+La funzione @code{asorti()} si comporta in maniera simile ad @code{asort()};
+tuttavia l'ordinamento avviene in base agli @emph{indici}, e non in base ai
+valori. Quindi, nell'esempio seguente, a partire dallo stesso insieme iniziale
+di indici e valori nel vettore @code{a}, la chiamata di @samp{asorti(a)}
+produrrebbe:
+
address@hidden
+a[1] = "mediano"
+a[2] = "primo"
+a[3] = "ultimo"
address@hidden example
+
address@hidden @code{gensub(@var{regexp}, @var{rimpiazzo}, @var{come}}
address@hidden, @address@hidden) #}
address@hidden
address@hidden cercare e rimpiazzare in stringhe
address@hidden sostituzione in stringa
+Ricerca nella stringa @var{obiettivo} delle corrispondenze
+all'espressione regolare @var{regexp}.
+Se @var{come} @`e una stringa che inizia
+con @samp{g} o @samp{G} (abbreviazione di ``global''), sostituisce
+ogni occorrenza di @var{regexp} con la stringa
address@hidden Altrimenti, @var{come} @`e visto come un numero che indica
+quale corrispondenza di @var{regexp} va rimpiazzata. Se non si specifica
+il nome dell'@var{obiettivo}, si
+opera su @code{$0}. La funzione restituisce come risultato la stringa
+modificata, e la stringa originale di partenza @emph{non} viene modificata.
+
address@hidden()} @`e una funzione generale di sostituzione. Mira a fornire
address@hidden address@hidden rispetto alle funzioni standard @code{sub()} e
address@hidden()}.
+
address@hidden()} prevede una address@hidden ulteriore, non disponibile in
address@hidden()} o @code{gsub()}: la address@hidden di specificare componenti
di
+una @dfn{regexp} nel testo da sostituire. Questo @`e fatto utilizzando delle
+parentesi nella @dfn{regexp} per designare i componenti, e quindi inserendo
address@hidden@var{N}} nel testo di rimpiazzo, dove @var{N} @`e una cifra da 1
a 9.
+Per esempio:
+
address@hidden
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{a = "abc def"}
+> @kbd{b = gensub(/(.+) (.+)/, "\\2 \\1", "g", a)}
+> @kbd{print b}
+> @address@hidden'}
address@hidden def abc
address@hidden example
+
address@hidden
+Come con @code{sub()}, occorre battere due barre inverse, per ottenerne
+una come componente della stringa.
+Nel testo di rimpiazzo, la sequenza @samp{\0} rappresenta l'intero testo
+corrispondente, e lo stesso vale per
+il carattere @samp{&}.
+
+Il seguente esempio mostra come @`e possibile usare il terzo argomento
+per controllare quale corrispondenza
+della @dfn{regexp} sia da modificare:
+
address@hidden
+$ @kbd{echo a b c a b c |}
+> @kbd{gawk '@{ print gensub(/a/, "AA", 2) @}'}
address@hidden a b c AA b c
address@hidden example
+
+In questo caso, @code{$0} @`e la stringa obiettivo di default.
address@hidden()} restituisce la nuova stringa come risultato, e questa
address@hidden passata direttamente a @code{print} per essere stampata.
+
address@hidden @cindex avvertimenti automatici
address@hidden @cindex automatici, avvertimenti
+Se l'argomento @var{come} @`e una stringa che non inizia con @samp{g} o
address@hidden, o se @`e un numero minore o uguale a zero, si effettua solo una
+sostituzione. Se @var{come} @`e zero, @command{gawk} emette
+un messaggio di avvertimento.
+
+Se @var{regexp} non viene trovata in @var{obiettivo}, il valore
+restituito da @code{gensub()}
address@hidden il valore originale e non modificato di @var{obiettivo}.
+
address@hidden @code{gsub(@var{regexp}, @var{rimpiazzo}} address@hidden,
@address@hidden)}
address@hidden
+Ricerca in @var{obiettivo}
address@hidden le sottostringhe corrispondenti al criterio di ricerca, le
address@hidden lunghe possibili partendo da sinistra, @emph{non sovrapposte tra
loro},
+e le sostituisce con @var{rimpiazzo}.
+La lettera @samp{g} in @code{gsub()} significa
+``global'', e richiede di sostituire dappertutto. Per esempio:
+
address@hidden
address@hidden gsub(/Inghilterra/, "Regno Unito"); print @}
address@hidden example
+
address@hidden
+sostituisce tutte le occorrenze della stringa @samp{Inghilterra} con
address@hidden Unito} in tutti i record in input.
+
+La funzione @code{gsub()} restituisce il numero di sostituzioni effettuate.
+Se la variabile da cercare e modificare (@var{obiettivo}) @`e omessa,
+viene usato l'intero record in input.
+Come in @code{sub()}, i caratteri @samp{&} e @samp{\} sono speciali,
+e il terzo argomento dev'essere modificabile.
+
address@hidden @code{index(@var{dove}, @var{cosa})}
address@hidden
address@hidden ricerca in stringhe
address@hidden trovare sottostringhe in una stringa
+Ricerca nella stringa @var{dove} la prima occorrenza della stringa @var{cosa},
+e restituisce la posizione in caratteri dell'inizio di quest'occorrenza nella
+stringa @var{dove}. Si consideri il seguente esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print index("noccioline", "oli") @}'}
address@hidden 6
address@hidden example
+
address@hidden
+Se @var{cosa} non viene trovato, @code{index()} restituisce zero.
+
address@hidden angolo buio, @dfn{regexp} come secondo argomento di
@code{index()}
+In BWK @command{awk} e @command{gawk},
address@hidden un errore fatale usare una costante @dfn{regexp} per @var{cosa}.
+Altre implementazioni lo consentono, considerando semplicemente
+la costante @dfn{regexp} come un'espressione che significa
address@hidden ~ /@dfn{regexp}/}. @value{DARKCORNER}
+
address@hidden @code{length(address@hidden@code{)}
address@hidden
address@hidden stringa, lunghezza di una
address@hidden lunghezza di una stringa
+Restituisce il numero di caratteri in @var{stringa}. Se
address@hidden @`e un numero, viene restituita la lunghezza della stringa
+di cifre che rappresenta quel numero. Per esempio, @code{length("abcde")} @`e
+cinque.
+Invece, @code{length(15 * 35)} restituisce tre. In questo esempio,
address@hidden
address@hidden @cdot 35 = 525},
address@hidden iftex
address@hidden
address@hidden
+15 * 35 = 525,
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+15 ⋅ 35 = 525,
address@hidden docbook
+e 525 @`e quindi convertito alla stringa @code{"525"}, che @`e composta da
+tre caratteri.
+
address@hidden lunghezza di un record in input
address@hidden record in input, lunghezza di un
+Se non si specifica alcun argomento, @code{length()} restituisce la
+lunghezza di @code{$0}.
+
address@hidden @cindex historical features
address@hidden address@hidden, funzione @code{length()}
address@hidden POSIX @command{awk}, funzione @code{length()} e
address@hidden NOTA
+In alcune delle prime versioni di @command{awk}, la funzione @code{length()}
+poteva essere richiamata senza alcuna parentesi. Farlo @`e considerata
+una cattiva abitudine, sebbene il POSIX standard 2008 lo consenta
esplicitamente,
+per address@hidden con la vecchia prassi. Per garantire la massima
address@hidden ai programmi, @`e meglio mettere sempre le parentesi.
address@hidden quotation
+
address@hidden angolo buio, funzione @code{length()}
+Se @code{length()} @`e chiamata con una variabile che non @`e stata usata,
address@hidden considera la variabile come uno scalare. Altre
+implementazioni di @command{awk} non assegnano nessun tipo alla variabile.
address@hidden
+Si consideri:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print length(x) ; x[1] = 1 @}'}
address@hidden 0
address@hidden gawk: riga com.:1: fatale: tentativo di usare
address@hidden scalare 'x' come vettore
+
+$ @kbd{nawk 'BEGIN @{ print length(x) ; x[1] = 1 @}'}
address@hidden 0
address@hidden example
+
address@hidden
+Se @option{--lint} @`e
+stato specificato sulla riga di comando, @command{gawk} emette un
+avvertimento a questo riguardo.
+
address@hidden estensioni comuni, @code{length()} applicato a un vettore
address@hidden comuni, address@hidden @code{length()} applicato a un vettore
address@hidden differenze tra @command{gawk} e @command{awk}
address@hidden numero di elementi di un vettore
address@hidden vettore, determinare il numero degli elementi
+In @command{gawk} e in parecchie altre implementazioni @command{awk},
+se l'argomento @`e un vettore, la funzione @code{length()} restituisce il
numero
+di elementi nel vettore. @value{COMMONEXT}
address@hidden @`e meno utile di quel che sembra a prima vista, in quanto
+non @`e affatto detto che il vettore abbia come indici i numeri da 1 al
+numero di elementi che contiene.
+Se @option{--lint} @`e
+stato specificato sulla riga di comando,
+(@pxref{Opzioni}),
address@hidden avvisa che l'uso di un vettore come argomento non
address@hidden portabile.
+Se si specifica l'opzione @option{--posix}, l'uso di un vettore come
+argomento genera un errore fatale
address@hidden
+(@pxrefil{Vettori}).
address@hidden iftex
address@hidden
+(@pxref{Vettori}).
address@hidden ifnottex
+
address@hidden @code{match(@var{stringa}, @var{regexp}} address@hidden,
@address@hidden)}
address@hidden
address@hidden stringa, ricercare espressioni regolari in una
address@hidden ricerca @dfn{regexp} in stringhe
+Ricerca in @var{stringa} la
+sottostringa address@hidden lunga, a partire da sinistra, che corrisponde
+all'espressione regolare @var{regexp} e restituisce la posizione
+del carattere (indice) con cui inizia la sottostringa (uno, se
+la corrispondenza parte dall'inizio di @var{stringa}). Se non viene
+trovata alcuna corrispondenza, restituisce zero.
+
+L'argomento @var{regexp} address@hidden essere sia una costante @dfn{regexp}
+(@code{/address@hidden@code{/}) che una costante stringa
(@code{"address@hidden@code{"}).
+In quest'ultimo caso, la stringa @`e trattata come una @dfn{regexp}
+per la quale cercare una corrispondenza.
address@hidden regolari calcolate} per una
+spiegazione sulla differenza tra le due forme e sulle loro
+implicazioni riguardo al modo per scrivere correttamente un programma.
+
+L'ordine dei primi due argomenti @`e l'opposto di molte altre funzioni che
+trattano stringhe e che hanno a che fare con espressioni regolari, come
address@hidden()} e @code{gsub()}. Potrebbe essere di aiuto ricordare che
+per @code{match()}, l'ordine @`e lo stesso che per l'operatore @samp{~} :
address@hidden@var{stringa} ~ @var{regexp}}.
+
address@hidden @code{RSTART}, variabile, funzione @code{match()} e
address@hidden variabile @code{RSTART}, funzione @code{match()} e
address@hidden @code{RLENGTH}, variabile, funzione @code{match()} e
address@hidden variabile @code{RLENGTH}, funzione @code{match()} e
address@hidden funzione @code{match()}, variabili @code{RSTART}/@code{RLENGTH}
address@hidden @code{match()}, funzione, variabili @code{RSTART}/@code{RLENGTH}
+La funzione @code{match()} imposta la variabile predefinita @code{RSTART}
+all'indice.
+Imposta anche la variabile predefinita @code{RLENGTH} alla
+lunghezza in caratteri della sottostringa individuata. Se non viene
+trovata alcuna corrispondenza, @code{RSTART} @`e impostata a zero, e
address@hidden a @minus{}1.
+
+Per esempio:
+
address@hidden
address@hidden file eg/misc/findpat.awk
address@hidden
+ if ($1 == "TROVA")
+ regexp = $2
+ else @{
+ dove = match($0, regexp)
+ if (dove != 0)
+ print "Corrispondenza di", regexp, "alla posiz.", \
+ dove, "in", $0
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Questo programma ricerca delle righe che corrispondono all'espressione
+regolare contenuta nella variabile
address@hidden Quest'espressione regolare address@hidden essere modificata.
Se la
+prima parola in una riga @`e @samp{TROVA}, @code{regexp} diventa la
+seconda parola su quella riga. Quindi, dato:
+
address@hidden
address@hidden file eg/misc/findpat.data
+TROVA or+e
+Il mio programma corre
+ma non troppo velocemente
+TROVA Melvin
+JF+KM
+Questa riga appartiene a Reality Engineering Co.
+Melvin @`e passato da qui.
address@hidden endfile
address@hidden example
+
address@hidden
address@hidden stampa:
+
address@hidden
+Corrispondenza di or+e alla posiz. 19 in Il mio programma corre
+Corrispondenza di Melvin alla posiz. 1 in Melvin @`e passato da qui.
address@hidden example
+
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{match()}
+Se @var{vettore} esiste address@hidden, viene cancellato, e quindi l'elemento
numero
+zero di @var{vettore} @`e impostato all'intera parte di @var{stringa}
+individuata da @var{regexp}. Se @var{regexp} contiene parentesi,
+gli elementi aventi per indici numeri interi in @var{vettore} sono
+impostati per contenere ognuno la parte di @var{stringa} individuata dalla
+corrispondente sottoespressione delimitata da parentesi.
+Per esempio:
+
address@hidden
+$ @kbd{echo pippoooopaperpluttttttt |}
+> @kbd{gawk '@{ match($0, /(pippo+).+(plut*)/, vett)}
+> @kbd{print vett[1], vett[2] @}'}
address@hidden pippoooo pluttttttt
address@hidden example
+
+Inoltre,
+sono disponibili indici multidimensionali che contengono
+la posizione di partenza e la lunghezza di ogni sottoespressione
+individuata:
+
address@hidden
+$ @kbd{echo pippoooopaperpluttttttt |}
+> @kbd{gawk '@{ match($0, /(pippo+).+(plut*)/, vett)}
+> @kbd{print vett[1], vett[2]}
+> @kbd{print vett[1, "start"], vett[1, "length"]}
+> @kbd{print vett[2, "start"], vett[2, "length"]}
+> @address@hidden'}
address@hidden pippoooo pluttttttt
address@hidden 1 8
address@hidden 14 10
address@hidden example
+
+Possono non esserci indici che individuino inizio e posizione
+per ogni sottoespressione
+fra parentesi, perch@'e non tutte potrebbero aver individuato del testo;
+quindi, andrebbero esaminati usando l'operatore @code{in}
+(@pxref{Visitare elementi}).
+
address@hidden risoluzione di problemi, funzione @code{match()}
address@hidden problemi, risoluzione di, funzione @code{match()}
+L'argomento @var{vettore} di @code{match()} @`e un'estensione
address@hidden In address@hidden compatibile
+(@pxref{Opzioni}),
+l'impiego di un terzo argomento causa un errore fatale.
+
address@hidden @code{patsplit(@var{stringa}, @var{vettore}} address@hidden,
@var{regexpdelim}} address@hidden, @var{separatori}} ] address@hidden) #}
address@hidden
address@hidden dividere in un vettore una stringa
address@hidden creare un vettore da una stringa
+Divide
address@hidden in parti definite da @var{regexpdelim}
+e memorizza i pezzi in @var{vettore} e le stringhe di separazione nel
+vettore @var{separatori}. Il primo pezzo @`e memorizzato in
address@hidden@var{vettore}[1]}, il secondo pezzo in @address@hidden, e
address@hidden@dotless{i}} via. Il terzo argomento, @var{regexpdelim}, @`e
+una @dfn{regexp} che descrive i campi in @var{stringa} (allo stesso modo in
+cui @code{FPAT} @`e una @dfn{regexp} che descrive i campi nei record
+in input).
address@hidden essere una costante @dfn{regexp} o una stringa.
+Se @var{regexpdelim} @`e omesso, viene usato il valore di @code{FPAT}.
address@hidden()} restituisce il numero di elementi creati.
address@hidden@address@hidden @`e
+la stringa che separa
+l'elemento @address@hidden@var{i}]} e @address@hidden@var{i}+1]}.
+Ogni separatore iniziale address@hidden in @address@hidden
+
+La funzione @code{patsplit()} divide delle stringhe in pezzi in modo
+simile a quello con cui le righe in input vengono divise in campi
+usando @code{FPAT}
+(@pxref{Separazione in base al contenuto}).
+
+Prima di dividere la stringa, @code{patsplit()} cancella ogni elemento che
+fosse eventualmente presente
+nei vettori @var{vettore} e @var{separatori}.
+
address@hidden @code{split(@var{stringa}, @var{vettore}} address@hidden,
@var{separacampo}} address@hidden, @var{separatori}} ] address@hidden)}
address@hidden
+Divide @var{stringa} in pezzi separati da @var{separacampo}
+e memorizza i pezzi in @var{vettore} e le stringhe di separazione nel
+vettore @var{separatori}. Il primo pezzo @`e memorizzato in
address@hidden@var{vettore}[1]}, il secondo pezzo in @address@hidden, e
address@hidden@dotless{i}} via. Il valore della stringa specificata nel terzo
argomento,
address@hidden, @`e una @dfn{regexp} che indica come dividere @var{stringa}
+(analogamente a come @code{FS} address@hidden essere un @dfn{regexp} che
indica dove
+dividere i record in input).
+Se @var{separacampo} @`e omesso, si usa il valore di @code{FS}.
address@hidden()} restituisce il numero di elementi creati.
address@hidden @`e un'estensione @command{gawk}, in cui
address@hidden@address@hidden
address@hidden la stringa che separa @address@hidden@var{i}]} e
address@hidden@address@hidden
+Se @var{separacampo} @`e uno spazio bianco, ogni eventuale spazio bianco
+a inizio stringa viene messo in @address@hidden e ogni
+eventuale spazio bianco a fine stringa viene messo in
address@hidden@address@hidden, dove @var{n} @`e il valore restituito da
address@hidden()} (address@hidden il numero di elementi in @var{vettore}).
+
+La funzione @code{split()} divide le stringhe in pezzi in modo simile
+a quello con cui le righe in input sono divise in campi. Per esempio:
+
address@hidden
+split("cul-de-sac", a, "-", separatori)
address@hidden example
+
address@hidden
address@hidden stringhe, divisione, esempio
+divide la stringa @code{"cul-de-sac"} in tre campi usando @samp{-} come
+separatore. Il vettore @code{a} ha i seguenti contenuti:
+
address@hidden
+a[1] = "cul"
+a[2] = "de"
+a[3] = "sac"
address@hidden example
+
+e imposta il contenuto del vettore @code{separatori} come segue:
+
address@hidden
+seps[1] = "-"
+seps[2] = "-"
address@hidden example
+
address@hidden
+Il valore restituito da questa chiamata a @code{split()} @`e tre.
+
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{split()}
+Come nella divisione in campi dei record in input, quando il valore di
address@hidden @`e @address@hidden" "}}, gli spazi bianchi a inizio e fine
stringa
+vengono ignorati nell'assegnare valori agli elementi di @var{vettore} ma non
nel
+vettore @var{separatori}, e gli elementi sono separati da uno o address@hidden
spazi
+bianchi. Inoltre, come nel caso della divisione dei record in input, se
address@hidden @`e la stringa nulla, ogni singolo carattere nella stringa
+costituisce un elemento del vettore.
address@hidden
+
+Si noti, tuttavia, che @code{RS} non influisce sul comportamento di
address@hidden()}.
+Anche se @samp{RS = ""} fa address@hidden@dotless{i}} che il carattere di
ritorno a capo sia un
+separatore di campo,
+questo non influenza il modo in cui @code{split()} divide le stringhe.
+
address@hidden angolo buio, funzione @code{split()}
+Recenti implementazioni di @command{awk}, incluso @command{gawk},
+consentono che il terzo argomento sia una costante @dfn{regexp}
+(@address@hidden/address@hidden@code{/}})
+o anche una stringa. @value{DARKCORNER}
+Anche lo standard POSIX permette questo.
address@hidden regolari calcolate} per la spiegazione della differenza
+tra l'uso di una costante stringa e l'uso di una costante @dfn{regexp},
+sulle loro implicazioni riguardo a come scrivere correttamente un programma.
+
+Prima di dividere la stringa, @code{split()} cancella ogni elemento
+eventualmente address@hidden presente
+nei vettori @var{vettore} e @var{separatori}.
+
+Se @var{stringa} @`e la stringa nulla, il vettore non ha elementi.
+(Quindi, in questo modo si address@hidden cancellare un intero vettore con una
sola
+istruzione).
address@hidden)
+
+Se in @var{stringa} non viene trovato @var{separacampo} (ma la stringa
+non @`e la stringa nulla),
address@hidden ha solo un elemento. Il valore di quell'elemento @`e la
address@hidden originale.
+
+In address@hidden POSIX (@pxref{Opzioni}), il quarto argomento non @`e
disponibile.
+
address@hidden @code{sprintf(@var{formato}, @var{espressione1}, @dots{})}
address@hidden
address@hidden formattare stringhe
address@hidden stringhe, formattazione
+Restituisce (senza stamparla) la stringa che @code{printf} avrebbe
+stampato con gli stessi argomenti
+(@pxref{Printf}).
+Per esempio:
+
address@hidden
+pival = sprintf("pi = %.2f (approx.)", 22/7)
address@hidden example
+
address@hidden
+assegna la stringa @address@hidden = 3.14 (approx.)}} alla variabile
@code{pival}.
+
address@hidden
address@hidden conversione di una stringa in un numero
address@hidden stringhe, conversione in numeri
address@hidden @code{strtonum(@var{stringa}) #}
+Esamina @var{stringa} e restituisce il suo valore numerico. Se
address@hidden inizia con la cifra @samp{0}, @code{strtonum()} presuppone
+che @var{stringa} sia un numero ottale. Se @var{stringa} inizia con
address@hidden o @samp{0X}, @code{strtonum()} presuppone che @var{stringa} sia
un
+numero esadecimale.
+Per esempio:
+
address@hidden
+$ @kbd{echo 0x11 |}
+> @kbd{gawk '@{ printf "%d\n", strtonum($1) @}'}
address@hidden 17
address@hidden example
+
+Usare la funzione @code{strtonum()} @emph{non} @`e lo stesso che aggiungere
+zero al valore di una stringa;
+la conversione automatica di stringhe in numeri
+si applica solo a dati decimali, non a quelli ottali o
address@hidden nel caso si usi l'opzione
address@hidden, il che non @`e consigliato.
address@hidden non decimali} per ulteriori informazioni.}
+
+Si noti anche che @code{strtonum()} usa il separatore decimale della
+localizzazione corrente per riconoscere i numeri
+(@pxref{Localizzazioni}).
+
address@hidden @code{sub(@var{regexp}, @var{rimpiazzo}} address@hidden,
@address@hidden)}
address@hidden
address@hidden rimpiazzare in una stringa
address@hidden stringa, rimpiazzare in una
+Ricerca in @var{obiettivo}, che @`e visto come una stringa,
+la prima sottostringa address@hidden lunga possibile,
+a partire da sinistra, che corrisponde all'espressione regolare @var{regexp}.
+Modifica l'intera stringa sostituendo il testo individuato con
address@hidden
+La stringa address@hidden@dotless{i}} modificata diventa il nuovo valore di
@var{obiettivo}.
+Restituisce il numero di sostituzioni fatte (zero o uno).
+
+L'argomento @var{regexp} address@hidden essere o una costante @dfn{regexp}
+(@code{/address@hidden@code{/}) o una constante stringa
(@code{"address@hidden@code{"}).
+In quest'ultimo caso, la stringa @`e trattata come una @dfn{regexp}
+da individuare.
address@hidden regolari calcolate} per la spiegazione della differenza tra
+le due forme, delle loro implicazioni riguardo al modo di scrivere
+correttamente un programma.
+
+Questa funzione @`e particolare perch@'e @var{obiettivo} non @`e semplicemente
usato
+per calcolare un valore, e non basta che sia un'espressione qualsiasi:
+dev'essere una variabile, un campo, o un elemento di vettore in cui
address@hidden()} possa memorizzare un valore modificato. Se questo argomento
@`e
+omesso, il comportamento di default @`e
+quello di usare e modificare
address@hidden@footnote{Si noti che questo significa che il record
address@hidden dapprima
+ricostruito, usando il valore di @code{OFS} se qualche campo @`e stato
cambiato,
+e che i campi saranno aggiornati dopo la sostituzione, anche se l'operazione in
+s@'e non cambia il record (@`e una ``no-op'') come @samp{sub(/^/, "")}.} Per
+esempio:
+
address@hidden
+str = "acqua, acqua dappertutto"
+sub(/cqu/, "vari", str)
address@hidden example
+
address@hidden
+modifica @code{stringa} facendola divenire
address@hidden@samp{avaria, acqua dappertutto}},
+rimpiazzando l'occorrenza address@hidden lunga,
+a partire da sinistra, di @samp{cqu} con @samp{vari}.
+
+Se il carattere speciale @samp{&} compare in @var{rimpiazzo}, designa
+l'esatta sottostringa individuata da @var{regexp}. (Se
address@hidden address@hidden individuare address@hidden di una stringa, questa
sottostringa
address@hidden assumere valori diversi.) Per esempio:
+
address@hidden
address@hidden sub(/candidato/, "& e sua moglie"); print @}
address@hidden example
+
address@hidden
+cambia la prima occorrenza di @samp{candidato} a @samp{candidato
+e sua moglie} in ogni riga in input.
+Ecco un altro esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{str = "daabaaa"}
+> @kbd{sub(/a+/, "C&C", str)}
+> @kbd{print str}
+> @address@hidden'}
address@hidden dCaaCbaaa
address@hidden example
+
address@hidden
+questo mostra come @samp{&} possa rappresentare una stringa variabile
+e illustra anche la regola
+``a partire da sinistra, la address@hidden lunga'' nell'individuazione di
@dfn{regexp}
+(@address@hidden lungo da sinistra}).
+
+L'effetto di questo carattere speciale (@samp{&}) address@hidden essere
neutralizzato
+anteponendogli una barra inversa nella stringa. Come al solito, per
+inserire una barra inversa nella
+stringa, occorre scrivere due barre inverse. Quindi, occorre scrivere
address@hidden&} in una costante stringa per includere un carattere @samp{&}
+nel rimpiazzo.
+Per esempio, quanto segue mostra come rimpiazzare il primo @samp{|} su
+ogni riga con un @samp{&}:
+
address@hidden
address@hidden sub(/\|/, "\\&"); print @}
address@hidden example
+
address@hidden @code{sub()}, funzione, argomenti di
address@hidden funzione @code{sub()}, argomenti di
address@hidden @code{gsub()}, funzione, argomenti di
address@hidden funzione @code{gsub()}, argomenti di
+Come address@hidden accennato, il terzo argomento di @code{sub()} dev'essere
+una variabile, un campo, o un elemento di vettore.
+Alcune versioni di @command{awk} accettano come terzo argomento
+un'espressione che non @`e un @dfn{lvalue}. In tal caso, @code{sub()}
+cerca ugualmente l'espressione e restituisce zero o uno, ma il risultato
+della sostituzione (se ce n'@`e uno) viene scartato perch@'e non c'@`e un posto
+dove memorizzarlo. Tali versioni di @command{awk} accettano espressioni
+come le seguente:
+
address@hidden
+sub(/USA/, "Stati Uniti", "gli USA e il Canada")
address@hidden example
+
address@hidden
address@hidden risoluzione di problemi, funzioni @code{gsub()}/@code{sub()}
address@hidden problemi, risoluzione di, funzioni @code{gsub()}/@code{sub()}
+Per address@hidden storica, @command{gawk} accetta un tale codice erroneo.
+Tuttavia, l'uso di qualsiasi altra espressione non modificabile
+come terzo parametro causa un errore fatale, e il programma
+non viene portato a termine.
+
+Infine, se la @var{regexp} non @`e una costante @dfn{regexp}, @`e convertita
+in una stringa, e quindi il valore di quella stringa @`e trattato come
+la @dfn{regexp} da individuare.
+
address@hidden @code{substr(@var{stringa}, @var{inizio}} address@hidden,
@var{lunghezza}} address@hidden)}
address@hidden
address@hidden sottostringa
+Restituisce una sottostringa di @var{stringa} lunga @var{lunghezza} caratteri,
+iniziando dal carattere numero @var{inizio}. Il primo carattere di una
+stringa @`e il carattere numero address@hidden @`e differente da
+C e C++, in cui il primo carattere ha il numero zero.}
+Per esempio, @code{substr("Washington", 5, 3)} restituisce @code{"ing"}.
+
+Se @var{lunghezza} non @`e presente, @code{substr()} restituisce l'intero
+suffisso di
address@hidden a partire dal carattere numero @var{inizio}. Per esempio,
address@hidden("Washington", 5)} restituisce @code{"ington"}. L'intero
+suffisso @`e restituito anche
+se @var{lunghezza} @`e maggiore del numero di caratteri disponibili
+nella stringa, a partire dal carattere @var{inizio}.
+
address@hidden Brian Kernighan, @command{awk} di
+Se @var{inizio} @`e minore di uno, @code{substr()} lo tratta come se
+fosse uno. (POSIX non specifica cosa fare in questo caso:
+BWK @command{awk} si comporta address@hidden@dotless{i}}, e quindi
@command{gawk} fa lo stesso.)
+Se @var{inizio} @`e maggiore del numero di caratteri
+nella stringa, @code{substr()} restituisce la stringa nulla.
+Analogamente, se @var{lunghezza} @`e presente ma minore o uguale a zero,
+viene restituita la stringa nulla.
+
address@hidden risoluzione di problemi, funzione @code{substr()}
address@hidden problemi, risoluzione di, funzione @code{substr()}
+La stringa restituita da @code{substr()} @emph{non address@hidden essere
+assegnata. Quindi, @`e un errore tentare di modificare una porzione di
+una stringa, come si vede nel seguente esempio:
+
address@hidden
+stringa = "abcdef"
+# tentare di ottenere "abCDEf", non @`e possibile
+substr(stringa, 3, 3) = "CDE"
address@hidden example
+
address@hidden
address@hidden anche un errore usare @code{substr()} come terzo argomento
+di @code{sub()} o @code{gsub()}:
+
address@hidden
+gsub(/xyz/, "pdq", substr($0, 5, 20)) # SBAGLIATO
address@hidden example
+
address@hidden address@hidden, funzione @code{substr()}
+(Alcune versioni commerciali di @command{awk} consentono un tale uso di
address@hidden()}, ma un tale codice non @`e portabile.)
+
+Se si devono sostituire pezzi di una stringa,
+si combini @code{substr()}
+con una concatenazione di stringa, nel modo seguente:
+
address@hidden
+stringa = "abcdef"
address@hidden
+stringa = substr(stringa, 1, 2) "CDE" substr(stringa, 6)
address@hidden example
+
address@hidden maiuscolo/minuscolo, conversione da/a
address@hidden stringhe, convertire maiuscolo/minuscolo
address@hidden @code{tolower(@var{stringa})}
address@hidden
address@hidden convertire stringa in minuscolo
+Restituisce una copia di @var{stringa}, con ogni carattere maiuscolo
+nella stringa rimpiazzato dal suo corrispondente carattere minuscolo.
+I caratteri non alfabetici non vengono modificati. Per esempio,
address@hidden("MaIuScOlO MiNuScOlO 123")} restituisce
address@hidden"maiuscolo minuscolo 123"}.
+
address@hidden @code{toupper(@var{stringa})}
address@hidden
address@hidden convertire stringa in maiuscolo
+Restituisce una copia di @var{stringa}, con ogni carattere minuscolo
+nella stringa rimpiazzato dal suo corrispondente carattere maiuscolo.
+I caratteri non alfabetici non vengono modificati. Per esempio,
address@hidden("MaIuScOlO MiNuScOlO 123")} restituisce
address@hidden"MAIUSCOLO MINUSCOLO 123"}.
address@hidden table
+
address@hidden sidebar, Individuare la stringa nulla
address@hidden
address@hidden
+<sidebar><title>Individuare la stringa nulla</title>
address@hidden docbook
+
address@hidden individuare la stringa nulla
address@hidden stringa nulla, individuare la
address@hidden @code{*} (asterisco), operatore @code{*}, individuare la stringa
nulla
address@hidden asterisco (@code{*}), operatore @code{*}, individuare la stringa
nulla
+
+In @command{awk}, l'operatore @samp{*} address@hidden individuare la stringa
nulla.
+Questo @`e particolarmente importante per le funzioni @code{sub()},
address@hidden()} e @code{gensub()}. Per esempio:
+
address@hidden
+$ @kbd{echo abc | awk '@{ gsub(/m*/, "X"); print @}'}
address@hidden XaXbXcX
address@hidden example
+
address@hidden
+Sebbene questo sia abbastanza sensato, address@hidden suscitare una certa
sorpresa.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Individuare la stringa nulla}
+
+
address@hidden individuare la stringa nulla
address@hidden stringa nulla, individuare la
address@hidden @code{*} (asterisco), operatore @code{*}, individuare la stringa
nulla
address@hidden asterisco (@code{*}), operatore @code{*}, individuare la stringa
nulla
+
+In @command{awk}, l'operatore @samp{*} address@hidden individuare la stringa
nulla.
+Questo @`e particolarmente importante per le funzioni @code{sub()},
address@hidden()} e @code{gensub()}. Per esempio:
+
address@hidden
+$ @kbd{echo abc | awk '@{ gsub(/m*/, "X"); print @}'}
address@hidden XaXbXcX
address@hidden example
+
address@hidden
+Sebbene questo sia abbastanza sensato, address@hidden suscitare una certa
sorpresa.
address@hidden cartouche
address@hidden ifnotdocbook
+
+
address@hidden Dettagli ostici
address@hidden Ulteriori dettagli su @samp{\} e @samp{&} con @code{sub()},
@code{gsub()} e @code{gensub()}
+
address@hidden protezione caratteri nelle funzioni
@code{gsub()}/@code{gensub()}/@code{sub()}
address@hidden funzione @code{sub()}, protezione caratteri
address@hidden @code{sub()}, funzione, protezione caratteri
address@hidden funzione @code{gsub()}, protezione caratteri
address@hidden @code{gsub()}, funzione, protezione caratteri
address@hidden funzione @code{gensub()} (@command{gawk}), protezione caratteri
address@hidden @code{gensub()}, funzione (@command{gawk}), protezione caratteri
address@hidden @code{\} (barra inversa),
@code{gsub()}/@code{gensub()}/@code{sub()} funzioni e
address@hidden barra inversa (@code{\}),
@code{gsub()}/@code{gensub()}/@code{sub()} funzioni e
address@hidden @code{&} (e commerciale), funzioni
@code{gsub()}/@code{gensub()}/@code{sub()} e
address@hidden e commerciale (@code{&}), funzioni
@code{gsub()}/@code{gensub()}/@code{sub()} e
+
address@hidden ATTENZIONE
+Si dice che questa sottosezione possa causare dei mal di testa.
+In prima lettura address@hidden essere benissimo saltata.
address@hidden quotation
+
+Quando si usa @code{sub()}, @code{gsub()} o @code{gensub()}, e si
+desidera includere delle
+barre inverse e delle "e commerciali" (@code{&}) nel testo da sostituire
address@hidden necessario ricordare che ci sono parecchi livelli di
address@hidden caratteri} in gioco.
+
+Anzitutto, vi @`e il livello @dfn{lessicale}, quello in cui @command{awk}
+legge un programma e ne costruisce una copia interna da eseguire.
+Poi c'@`e il momento dell'esecuzione, quello in cui @command{awk}
+esamina effettivamente la stringa da sostituire, per determinare cosa
+fare.
+
address@hidden Brian Kernighan, @command{awk} di
+In entrambi i livelli, @command{awk} ricerca un dato insieme di caratteri
+che possono venire dopo una
+barra inversa. A livello lessicale, cerca le sequenze di protezione
+elencate in @ref{Sequenze di protezione}.
+Quindi, per ogni @samp{\} che @command{awk} elabora al momento
+dell'esecuzione, occorre immetterne due a livello lessicale.
+Quando un carattere che non ha address@hidden di una sequenza di protezione
+segue una @samp{\}, sia BWK @command{awk} che @command{gawk} semplicemente
+rimuovono la @samp{\} stessa e
+mettono il carattere seguente nella stringa. Quindi, per esempio,
address@hidden"a\qb"} @`e trattato come se si fosse scritto @code{"aqb"}.
+
+Al momento dell'esecuzione, le varie funzioni gestiscono sequenze di
address@hidden e @samp{&} in maniera differente. La situazione @`e (purtroppo)
+piuttosto complessa.
+Storicamente, le funzioni @code{sub()} e @code{gsub()} trattavano la
+sequenza di due caratteri @samp{\&} in maniera speciale; questa sequenza
+era rimpiazzata nel testo
+generato da un singolo carattere @samp{&}. Ogni altra @samp{\} contenuta
+nella stringa @var{rimpiazzo} che non era posta prima di una @samp{&} era
+lasciata passare senza modifiche.
+Questo @`e illustrato nella @ref{table-sub-escapes}.
+
address@hidden Thank to Karl Berry for help with the TeX stuff.
address@hidden Tabella,table-sub-escapes
address@hidden storica delle sequenze di protezione per @code{sub()} e
@code{gsub()}}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
+ @code{\&}! @code{&}!Il testo individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\\\&}! @code{\\&}!I caratteri @samp{\&}_cr
+ @code{\\\\\&}! @code{\\&}!I caratteri @samp{\&}_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\\&}_cr
+ @code{\\q}! @code{\q}!I caratteri @samp{\q}_cr
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden Immissione @tab @code{sub()} vede @tab @code{sub()} genera
address@hidden @code{\&} @tab @code{&} @tab Il testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\\\&} @tab @code{\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\\&} @tab @code{\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\\&}
address@hidden @code{\\q} @tab @code{\q} @tab I caratteri @samp{\q}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+ Immissione @code{sub()} vede @code{sub()} genera
+ --------------- ------------- ---------------
+ @code{\&} @code{&} Il testo individuato
+ @code{\\&} @code{\&} La lettera @samp{&}
+ @code{\\\&} @code{\&} La lettera @samp{&}
+ @code{\\\\&} @code{\\&} Le lettere @samp{\&}
+ @code{\\\\\&} @code{\\&} Le lettere @samp{\&}
address@hidden&} @code{\\\&} Le lettere
@samp{\\&}
+ @code{\\q} @code{\q} Le lettere @samp{\q}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
address@hidden
+Questa tabella mostra l'elaborazione a livello lessicale, in cui
+un numero dispari di barre inverse diventa un numero pari al momento
+dell'esecuzione,
+e mostra anche l'elaborazione in fase di esecuzione fatta da @code{sub()}.
+(Per amor di address@hidden le tavole che ancora seguono mostrano solo il caso
+di un numero pari di barre inverse immesso a livello lessicale.)
+
+Il problema con l'approccio storico @`e che non c'@`e modo di ottenere
+un carattere @samp{\} seguito dal testo individuato.
+
+Parecchie edizioni dello standard POSIX hanno provato a risolvere questo
+problema, senza riuscirci. I dettagli sono irrilevanti in questo contesto.
+
+A un certo punto, il manutentore di @command{gawk} ha presentato una
+proposta per una revisione dello standard per tornare
+a regole che corrispondano address@hidden da vicino alla prassi originalmente
seguita.
+Le regole proposte hanno dei casi speciali che rendono possibile
+produrre una @samp{\} prima del
+testo individuato. Questo si address@hidden vedere nella
address@hidden
+
address@hidden Tabella,table-sub-proposed
address@hidden @command{gawk} per @code{sub()} e barra inversa}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\&}_cr
address@hidden&}! @code{\\&}!Il carattere @samp{\}, seguito dal testo
individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\q}! @code{\q}!I caratteri @samp{\q}_cr
+ @code{\\\\}! @address@hidden
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden Immissione @tab @code{sub()} vede @tab @code{sub()} genera
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\&} @tab @code{\\&} @tab Il carattere @samp{\},
seguito dal testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\q} @tab @code{\q} @tab I caratteri @samp{\q}
address@hidden @code{\\\\} @tab @code{\\} @tab @code{\\}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+Immissione @code{sub()} vede @code{sub()} genera
+--------- ---------- ---------------
address@hidden&} @code{\\\&} Il carattere @samp{\&}
+ @code{\\\\&} @code{\\&} Il carattere @samp{\}, seguito
dal testo individuato
+ @code{\\&} @code{\&} Il carattere @samp{&}
+ @code{\\q} @code{\q} I caratteri @samp{\q}
+ @code{\\\\} @code{\\} @code{\\}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
+In breve, al momento dell'esecuzione, ci sono ora tre sequenze speciali
+di caratteri (@samp{\\\&}, @samp{\\&}, e @samp{\&}) mentre tradizionalmente
+ce n'era una sola. Tuttavia, come nel caso storico, ogni @samp{\} che
+non fa parte di una di queste tre sequenze non @`e speciale e appare
+nell'output address@hidden@dotless{i}} come @`e scritto.
+
address@hidden 3.0 e 3.1 seguono queste regole per @code{sub()} e
address@hidden()}. La revisione dello standard POSIX ha richiesto molto
address@hidden tempo
+di quel che ci si attendeva. Inoltre, la proposta del manutentore di
address@hidden @`e andata persa durante il processo di standardizzazione. Le
+regole finali risultanti sono un po' address@hidden semplici. I risultati
sono simili,
+tranne che in un caso.
+
address@hidden POSIX @command{awk}, funzioni @code{gsub()}/@code{sub()} e
+Le regole POSIX stabiliscono che @samp{\&} nella stringa di rimpiazzo
+produca il carattere @samp{&}, @samp{\\} produce il carattere @samp{\},
+e che @samp{\} seguito da qualsiasi carattere non @`e speciale; la @samp{\}
address@hidden messa direttamente nell'output.
+Queste regole sono presentate nella @ref{table-posix-sub}.
+
address@hidden Tabella,table-posix-sub
address@hidden POSIX per @code{sub()} e @code{gsub()}}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\&}_cr
address@hidden&}! @code{\\&}!Il carattere @samp{\}, seguito dal testo
individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\q}! @code{\q}!I caratteri @samp{\q}_cr
+ @code{\\\\}! @address@hidden
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden @tab @code{sub()} vede @tab @code{sub()} genera
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\&} @tab @code{\\&} @tab Il carattere @samp{\},
seguito dal testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab I caratteri @samp{&}
address@hidden @code{\\q} @tab @code{\q} @tab I caratteri @samp{\q}
address@hidden @code{\\\\} @tab @code{\\} @tab @code{\}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+Immissione @code{sub()} vede @code{sub()} genera
+--------- ---------- ---------------
address@hidden&} @code{\\\&} I caratteri @samp{\&}
+ @code{\\\\&} @code{\\&} Il carattere @samp{\}, seguito
dal testo individuato
+ @code{\\&} @code{\&} Il carattere @samp{&}
+ @code{\\q} @code{\q} I caratteri @samp{\q}
+ @code{\\\\} @code{\\} @code{\}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
+Il solo caso in cui la differenza @`e rilevante @`e l'ultimo: @samp{\\\\}
address@hidden visto come @samp{\\} e produce @samp{\} invece che @samp{\\}.
+
+A partire dalla @value{PVERSION} 3.1.4, @command{gawk} ha seguito le regole
+POSIX quando si specifica @option{--posix} (@pxref{Opzioni}). Altrimenti, ha
+continuato a seguire le regole proposte [a POSIX], poich@'e questa @`e stato il
+comportamento seguito per parecchi anni.
+
+Quando la @value{PVERSION} 4.0.0 @`e stata rilasciata, il manutentore di
address@hidden
+ha stabilito come default le regole POSIX, interrompendo
address@hidden@dotless{i}} oltre
+un decennio di address@hidden
+all'address@hidden decisione si @`e dimostrata piuttosto avventata,
+anche se una nota in questa sezione avvertiva che la successiva versione
+principale di @command{gawk} avrebbe adottato le regole POSIX.}
+Inutile dire che questa non @`e stata una buona idea, e quindi dalla
address@hidden 4.0.1, @command{gawk} ha ripreso il suo comportamento
+tradizionale, seguendo le regole POSIX solo quando si specifica l'opzione
address@hidden
+
+Le regole per @code{gensub()} sono molto address@hidden semplici. Al momento
+dell'esecuzione, quando @command{gawk} vede una @samp{\}, se il carattere
+seguente @`e una cifra,
+il testo individuato dalla corrispondente sottoespressione tra parentesi
address@hidden inserito nell'output generato. Altrimenti, qualsiasi carattere
segua la
address@hidden viene inserito nel testo generato, mentre la @samp{\} va persa,
+come si vede nella @ref{table-gensub-escapes}.
+
address@hidden Tabella,table-gensub-escapes
address@hidden sequenze di protezione in @code{gensub()}}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
+ @code{&}! @code{&}!Il testo individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\\\}! @code{\\}!Il carattere @samp{\}_cr
+ @code{\\\\&}! @code{\\&}!Il carattere @samp{\}, seguito dal testo
individuato_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\&}_cr
+ @code{\\q}! @code{\q}!Il carattere @samp{q}_cr
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden Immissione @tab @code{gensub()} vede @tab @code{gensub()} genera
address@hidden @code{&} @tab @code{&} @tab Il testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\\\} @tab @code{\\} @tab Il carattere @samp{\}
address@hidden @code{\\\\&} @tab @code{\\&} @tab Il carattere @samp{\},
seguito dal testo individuato
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\q} @tab @code{\q} @tab Il carattere @samp{q}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+ Immissione @code{gensub()} vede @code{gensub()} genera
+ --------- ------------- ------------------
+ @code{&} @code{&} Il testo individuato
+ @code{\\&} @code{\&} Il carattere @samp{&}
+ @code{\\\\} @code{\\} Il carattere @samp{\}
+ @code{\\\\&} @code{\\&} Il carattere @samp{\},
seguito dal testo individuato
address@hidden&} @code{\\\&} I caratteri @samp{\&}
+ @code{\\q} @code{\q} Il carattere @samp{q}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
+A causa della address@hidden dell'elaborazione a livello lessicale e in fase
+di esecuzione, e dei casi speciali di @code{sub()} e @code{gsub()},
+si raccomanda l'uso di @command{gawk} e di @code{gensub()} quando ci siano
+da fare delle sostituzioni.
+
address@hidden Funzioni di I/O
address@hidden Funzioni di Input/Output
address@hidden input/output, funzioni di
address@hidden funzioni di input/output
+
+Le seguenti funzioni riguardano l'input/output (I/O).
+I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @asis
address@hidden @code{close(address@hidden address@hidden,} @address@hidden)}
address@hidden
address@hidden file, chiusura
address@hidden chiudere un file o un coprocesso
+Chiude il file @var{nome_file} in input o in output. Alternativamente,
+l'argomento address@hidden essere un comando della shell usato per creare un
+coprocesso, o per ridirigere
+verso o da una @dfn{pipe}; questo coprocesso o @dfn{pipe} viene chiuso.
address@hidden file e @dfn{pipe}}
+per ulteriori informazioni.
+
+Quando si chiude un coprocesso, address@hidden talora essere utile chiudere
dapprima
+un lato della @dfn{pipe} bidirezionale e quindi chiudere l'altro.
+Questo si address@hidden fare fornendo un secondo argomento a @code{close()}.
+Questo secondo argomento (@var{come})
+dovrebbe essere una delle due stringhe @code{"to"} o @code{"from"},
+che indicano quale lato della @dfn{pipe} chiudere. La stringa address@hidden
essere
+scritta indifferentemente in maiuscolo o in minuscolo.
address@hidden/O bidirezionale},
+che tratta questa address@hidden con maggior dettaglio e mostra un esempio.
+
+Si noti che il secondo argomento di @code{close()} @`e
+un'estensione @command{gawk}; non @`e disponibile in address@hidden compatibile
+(@pxref{Opzioni}).
+
address@hidden @code{fflush(address@hidden@code{)}
address@hidden
address@hidden scrivere su disco i buffer di output contenuti in memoria
+Scrive su disco ogni output contenuto in memoria, associato con
address@hidden, che @`e o un
+file aperto in scrittura o un comando della shell che ridirige output a
+una @dfn{pipe} o a un coprocesso.
+
address@hidden buffer, scrivere su disco un
address@hidden memoria tampone, scrivere su disco
address@hidden output, bufferizzazione
address@hidden output, nella memoria tampone (buffer)
+Molti programmi di address@hidden @dfn{bufferizzano} il loro output
(address@hidden,
+accumulano in memoria record da scrivere in un file su disco o sullo
+schermo, fin quando non arriva il momento giusto per inviare i
+dati al dispositivo di output).
+Questo @`e spesso address@hidden efficiente che scrivere
+ogni particella di informazione non appena diventa disponibile. Tuttavia,
+qualche volta @`e necessario forzare un programma a @dfn{svuotare}
+i suoi buffer (address@hidden, inviare l'informazione alla sua destinazione,
+anche se un buffer non @`e pieno).
+Questo @`e lo scopo della funzione @code{fflush()}; anche
address@hidden scrive il suo output in un buffer, e la funzione @code{fflush()}
+forza @command{gawk} a svuotare i suoi buffer.
+
address@hidden estensioni comuni, funzione @code{fflush()}
address@hidden Brian Kernighan, @command{awk} di
+Brian Kernighan ha aggiunto @code{fflush()} al suo @command{awk} nell'aprile
+1992. Per due decenni @`e rimasta un'estensione comune. A Dicembre
+2012 @`e stata accettata e inclusa nello standard POSIX.
+Si veda @uref{http://austingroupbugs.net/view.php?id=634, il sito Web
dell'Austin Group}.
+
+POSIX standardizza @code{fflush()} come segue: se non c'@`e alcun
+argomento, o se l'argomento @`e la stringa nulla (@address@hidden""}}),
address@hidden svuota i buffer di @emph{tutti} i file in output e di
address@hidden le @dfn{pipe}.
+
address@hidden NOTA
+Prima della @value{PVERSION} 4.0.2, @command{gawk}
+avrebbe svuotato solo i buffer dello standard output se non era
+specificato alcun argomento,
+e svuotato tutti i buffer dei file in output e delle @dfn{pipe} se
+l'argomento era la stringa nulla.
+Questo @`e stato modificato per essere compatibile con l'@command{awk} di
+Kernighan, nella speranza che standardizzare questa
address@hidden in POSIX sarebbe stato address@hidden agevole (come poi @`e
effettivamente
+successo).
+
+Con @command{gawk},
+si address@hidden usare @samp{fflush("/dev/stdout")} se si desidera solo
svuotare i
+buffer dello standard output.
address@hidden quotation
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden risoluzione di problemi, funzione @code{fflush()}
address@hidden problemi, risoluzione di, funzione @code{fflush()}
address@hidden()} restituisce zero se il buffer @`e svuotato con successo;
+altrimenti, restituisce un valore diverso da zero. (@command{gawk}
+restituisce @minus{}1.)
+Nel caso in cui tutti i buffer vadano svuotati, il valore restituito @`e zero
+solo se tutti i buffer sono stati svuotati con successo. Altrimenti,
address@hidden @minus{}1, e @command{gawk} avvisa riguardo al @var{nome_file}
+che ha problemi.
+
address@hidden invia anche un messaggio di avvertimento se si tenta di svuotare
i
+buffer di un file o @dfn{pipe} che era stato aperto in lettura
+(p.es. con @code{getline}),
+o se @var{nome_file} non @`e un file, una @dfn{pipe}, o un coprocesso aperto.
+in tal caso, @code{fflush()} restituisce ancora @minus{}1.
+
address@hidden sidebar, Bufferizzazione interattiva e non interattiva
address@hidden
address@hidden
+<sidebar><title>Bufferizzazione interattiva e non interattiva</title>
address@hidden docbook
+
address@hidden bufferizzazione, interattiva vs.@: non interattiva
+
+A complicare ulteriormente le cose, i problemi di bufferizzazione possono
+peggiorare se il programma eseguito
address@hidden @dfn{interattivo} (address@hidden, se
+comunica con un utente seduto davanti a una tastiera)address@hidden programma
address@hidden interattivo se il suo standard output @`e connesso a un
dispositivo
+terminale. Ai giorni nostri, questo vuol dire davanti a uno
+schermo e a una tastiera.}
+
address@hidden Thanks to address@hidden for this example, and for
address@hidden motivating me to write this section.
+I programmi interattivi normalmente @dfn{bufferizzano per riga} il loro
+output (address@hidden, scrivono in output una riga alla volta). I programmi
+non-interattivi attendono di aver riempito un buffer, il che address@hidden
voler dire
+anche parecchie righe di output.
+Ecco un esempio della differenza:
+
address@hidden
+$ @kbd{awk '@{ print $1 + $2 @}'}
address@hidden 1}
address@hidden 2
address@hidden 3}
address@hidden 5
address@hidden
address@hidden example
+
address@hidden
+Ogni riga di output @`e stampata immediatamente. Si confronti questo
+comportamente con quello di questo esempio:
+
address@hidden
+$ @kbd{awk '@{ print $1 + $2 @}' | cat}
address@hidden 1}
address@hidden 3}
address@hidden
address@hidden 2
address@hidden 5
address@hidden example
+
address@hidden
+In questo caso, nessun output viene stampato finch@'e non @`e stato battuto il
address@hidden, perch@'e l'output @`e bufferizzato e inviato tramite
address@hidden al comando @command{cat} in un colpo solo.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Bufferizzazione interattiva e non interattiva}
+
+
address@hidden bufferizzazione, interattiva vs.@: non interattiva
+
+A complicare ulteriormente le cose, i problemi di bufferizzazione possono
+peggiorare se il programma eseguito
address@hidden @dfn{interattivo} (address@hidden, se
+comunica con un utente seduto davanti a una tastiera)address@hidden programma
address@hidden interattivo se il suo standard output @`e connesso a un
dispositivo
+terminale. Ai giorni nostri, questo vuol dire davanti a uno
+schermo e a una tastiera.}
+
address@hidden Thanks to address@hidden for this example, and for
address@hidden motivating me to write this section.
+I programmi interattivi normalmente @dfn{bufferizzano per riga} il loro
+output (address@hidden, scrivono in output una riga alla volta). I programmi
+non-interattivi attendono di aver riempito un buffer, il che address@hidden
voler dire
+anche parecchie righe di output.
+Ecco un esempio della differenza:
+
address@hidden
+$ @kbd{awk '@{ print $1 + $2 @}'}
address@hidden 1}
address@hidden 2
address@hidden 3}
address@hidden 5
address@hidden
address@hidden example
+
address@hidden
+Ogni riga di output @`e stampata immediatamente. Si confronti questo
+comportamente con quello di questo esempio:
+
address@hidden
+$ @kbd{awk '@{ print $1 + $2 @}' | cat}
address@hidden 1}
address@hidden 3}
address@hidden
address@hidden 2
address@hidden 5
address@hidden example
+
address@hidden
+In questo caso, nessun output viene stampato finch@'e non @`e stato battuto il
address@hidden, perch@'e l'output @`e bufferizzato e inviato tramite
address@hidden al comando @command{cat} in un colpo solo.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden @code{system(@var{comando})}
address@hidden
address@hidden chiamare comandi di shell
address@hidden interagire con altri programmi
+Esegue il comando del sistema operativo @var{comando} e quindi
+ritorna al programma @command{awk}.
+Restituisce il codice ritorno di @var{comando}.
+
+Per esempio, inserendo il seguente frammento di codice in un programma
address@hidden:
+
address@hidden
+END @{
+ system("date | mail -s 'awk completato' root")
address@hidden
address@hidden example
+
address@hidden
+all'amministratore di sistema viene inviato un messaggio di posta quando
+il programma @command{awk} termina di elaborare l'input e inizia
+l'elaborazione da eseguire alla fine dell'input.
+
+Si noti che la ridirezione di @code{print} o @code{printf} in una
address@hidden @`e spesso sufficiente per ottenere lo stesso risultato.
+Se @`e necessario eseguire parecchi comandi, @`e address@hidden efficiente
+stamparli verso una @dfn{pipe} diretta alla shell:
+
address@hidden
+while (@var{ancora lavoro da fare})
+ print @var{comando} | "/bin/sh"
+close("/bin/sh")
address@hidden example
+
address@hidden
address@hidden risoluzione di problemi, funzione @code{system()}
address@hidden problemi, risoluzione di, funzione @code{system()}
address@hidden @option{--sandbox}, opzione, disabilitare la funzione
@code{system()}
address@hidden opzione @option{--sandbox}, disabilitare la funzione
@code{system()}
+Tuttavia, nel caso che il programma @command{awk} sia interattivo,
address@hidden()} @`e utile per eseguire grossi programmi autonomi,
+come ad esempio la shell o un programma di modifica testi.
+Alcuni sistemi operativi non consentono di implementare la funzione
address@hidden()}.
+Richiamare @code{system()} in sistemi in cui non @`e disponibile provoca
+un errore fatale.
+
address@hidden NOTA
+Quando si specifica l'opzione @option{--sandbox}, la funzione @code{system()}
@`e
+disabilitata (@pxref{Opzioni}).
address@hidden quotation
+
+Nei sistemi aderenti allo standard POSIX, il codice di ritorno di un
+comando @`e un numero contenuto in 16 bit. Il valore del codice di ritorno
+passato alla funzione C @code{exit()} alla fine del programma @`e contenuto
+negli 8 bit di valore address@hidden alto dei 16 bit (la address@hidden
sinistra) che compongono
+il numero. I bit di valore address@hidden basso (la address@hidden destra)
indicano se il
+processo @`e stato terminato da un segnale (bit 7), e, se questo @`e il caso,
+il numero del segnale che ha provocato la terminazione (bit 0--6).
+
+Tradizionalmente, la funzione @code{system()} di @command{awk} si @`e
+semplicemente limitata a restituire il valore del codice di ritorno
+diviso per 256 (ossia la address@hidden sinistra del numero di 16 bit, spostata
+a destra). In una situazione normale questo equivale a utilizzare il
+codice di ritornodi @code{system()}, ma nel caso in cui il programma sia
+stato terminato da un segnale, il valore diventa un numero frazionale a
+virgola address@hidden uno scambio di messaggi privato il Dr.@:
+Kernighan mi ha comunicato che questo modo di procedere @`e probabilmente
+errato.} POSIX stabilisce che la chiamata a @code{system()} dall'interno
+di @command{awk} dovrebbe restituire l'intero valore a 16 bit.
+
address@hidden si trova in qualche modo a address@hidden strada.
+I valori del codice di ritorno sono descritti nella
address@hidden
+
address@hidden Tabella,table-system-return-values
address@hidden codici di ritorno da chiamata a @code{system()}}
address@hidden @columnfractions .40 .60
address@hidden Situazione @tab Valore codice di ritorno da @code{system()}
address@hidden @option{--traditional} @tab Valore dalla funzione C
@code{system()}/256
address@hidden @option{--posix} @tab Valore dalla funzione C @code{system()}
address@hidden Uscita normale dal comando @tab Codice di ritorno del comando
address@hidden Terminazione da un segnale @tab 256 + numero segnale "assassino"
address@hidden Terminazione da un segnale con dump memoria @tab 512 + numero
segnale "assassino"
address@hidden Qualsiasi tipo di errore @tab @minus{}1
address@hidden multitable
address@hidden float
address@hidden table
+
address@hidden sidebar, Controllare la bufferizzazione dell'output con
@code{system()}
address@hidden
address@hidden
+<sidebar><title>Controllare la bufferizzazione dell'output con
@code{system()}</title>
address@hidden docbook
+
address@hidden buffer, scrivere su disco un
address@hidden bufferizzazione, dell'input/output
address@hidden output, bufferizzazione
address@hidden bufferizzazione, dell'output
+
+La funzione @code{fflush()} consente un controllo esplicito sulla
+bufferizzazione dell'output per singoli file e @dfn{pipe}.
+Tuttavia, il suo utilizzo non @`e portabile su molte delle meno recenti
+implementazioni di @command{awk}. Un metodo alternativo per forzare la
+scrittura dell'output @`e una chiamata a
address@hidden()} che abbia come argomento la stringa nulla:
+
address@hidden
+system("") # scrive l'output su disco
address@hidden example
+
address@hidden
address@hidden tratta questo uso della funzione @code{system()} come un
+caso speciale, e si guarda bene dall'invocare la shell (o un altro
+interprete di comandi) con un comando nullo.
+Quindi, con @command{gawk}, questa maniera di procedere non @`e solo utile,
+ma @`e anche efficiente.
+Questo metodo dovrebbe funzionare anche con
+altre implementazioni di @command{awk}, ma non @`e detto che eviti una
+invocazione non necessaria della shell. (Altre implementazioni potrebbero
+limitarsi a forzare la scrittura del buffer associato con lo
+standard output, e non necessariamente di tutto l'output bufferizzato.)
+
+Avendo in mente le attese di un programmatore, sarebbe sensato che
address@hidden()} forzi la scrittura su disco di tutto l'output disponibile.
+Il programma seguente:
+
address@hidden
+BEGIN @{
+ print "prima riga stampata"
+ system("echo system echo")
+ print "seconda riga stampata"
address@hidden
address@hidden example
+
address@hidden
+deve stampare:
+
address@hidden
+prima riga stampata
+system echo
+seconda riga stampata
address@hidden example
+
address@hidden
+e non:
+
address@hidden
+system echo
+prima riga stampata
+seconda riga stampata
address@hidden example
+
+Se @command{awk} non forzasse la scrittura dei suoi buffer prima di
+invocare @code{system()}, l'output sarebbe quest'ultimo (quello non voluto).
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Controllare la bufferizzazione dell'output con
@code{system()}}
+
+
address@hidden buffer, scrivere su disco un
address@hidden bufferizzazione, dell'input/output
address@hidden output, bufferizzazione
address@hidden bufferizzazione, dell'output
+
+La funzione @code{fflush()} consente un controllo esplicito sulla
+bufferizzazione dell'output per singoli file e @dfn{pipe}.
+Tuttavia, il suo utilizzo non @`e portabile su molte delle meno recenti
+implementazioni di @command{awk}. Un metodo alternativo per forzare la
+scrittura dell'output @`e una chiamata a
address@hidden()} che abbia come argomento la stringa nulla:
+
address@hidden
+system("") # scrive l'output su disco
address@hidden example
+
address@hidden
address@hidden tratta questo uso della funzione @code{system()} come un
+caso speciale, e si guarda bene dall'invocare la shell (o un altro
+interprete di comandi) con un comando nullo.
+Quindi, con @command{gawk}, questa maniera di procedere non @`e solo utile,
+ma @`e anche efficiente.
+Questo metodo dovrebbe funzionare anche con
+altre implementazioni di @command{awk}, ma non @`e detto che eviti una
+invocazione non necessaria della shell. (Altre implementazioni potrebbero
+limitarsi a forzare la scrittura del buffer associato con lo
+standard output, e non necessariamente di tutto l'output bufferizzato.)
+
+Avendo in mente le attese di un programmatore, sarebbe sensato che
address@hidden()} forzi la scrittura su disco di tutto l'output disponibile.
+Il programma seguente:
+
address@hidden
+BEGIN @{
+ print "prima riga stampata"
+ system("echo system echo")
+ print "seconda riga stampata"
address@hidden
address@hidden example
+
address@hidden
+deve stampare:
+
address@hidden
+prima riga stampata
+system echo
+seconda riga stampata
address@hidden example
+
address@hidden
+e non:
+
address@hidden
+system echo
+prima riga stampata
+seconda riga stampata
address@hidden example
+
+Se @command{awk} non forzasse la scrittura dei suoi buffer prima di
+invocare @code{system()}, l'output sarebbe quest'ultimo (quello non voluto).
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Funzioni di tempo
address@hidden Funzioni per gestire marcature temporali
address@hidden funzioni di tempo
+
address@hidden marcature temporali
address@hidden data e ora, si veda marcature temporali
address@hidden @dfn{log} (registro), file di, marcature temporali nei
address@hidden registro (@dfn{log}), file di, marcature temporali nel
address@hidden file di registro (@dfn{log}), marcature temporali nei
address@hidden @command{gawk}, data e ora (marcature temporali)
address@hidden POSIX @command{awk}, marcature temporali e
+I programmi @command{awk} sono frequentemente usati per elaborare file di
+registro [file con estensione .log], che contengono l'informazione sulla data e
+l'ora (marcatura temporale) in cui un particolare record @`e stato registrato
sul log.
+Molti programmi registrano questa informazione nel formato restituito
+dalla chiamata di sistema @code{time()}, la quale misura il numero di secondi
+trascorsi a partire da una certa data iniziale (Epoca). Nei sistemi aderenti
+allo standard POSIX, questo @`e il numero di secondi a partire dal primo
gennaio
+1970, ora di Greenwich (1970-01-01 00:00:00 UTC), senza includere i secondi
address@hidden FOR_PRINT
address@hidden
address@hidden@xrefIl{Glossario},
address@hidden iftex
address@hidden
address@hidden@xref{Glossario},
address@hidden ifnottex
+in particolare le voci ``Epoca'' e ``UTC.''}
address@hidden ifclear
address@hidden FOR_PRINT
+intercalari.
address@hidden ifset
+Tutti i sistemi noti aderenti allo standard POSIX gestiscono le marcature
+temporali da 0 fino a
address@hidden
address@hidden - 1},
address@hidden iftex
address@hidden
+2^31 - 1,
address@hidden ifinfo
address@hidden
address@hidden
address@hidden @minus{} 1,
address@hidden ifnotinfo
address@hidden ifnottex
+il che @`e sufficiente per rappresentare date e ore fino a inizio 2038
+(2038-01-19 03:14:07 UTC). Molti sistemi supportano una maggiore estensione
+di date, compresi dei valori negativi per rappresentare delle date
+anteriori all'Epoca.
+
address@hidden @command{date}, programma di address@hidden GNU
address@hidden programma di address@hidden @command{date} GNU
address@hidden tempo, ottenerlo
+Per facilitare l'elaborazione di tali file di registro, e per produrre
+dei rapporti utili, @command{gawk} prevede le seguenti funzioni per
+lavorare con le marcature temporali. Si tratta di estensioni @command{gawk};
+non sono previste nello standard address@hidden comando di address@hidden GNU
address@hidden address@hidden fare anche molte delle cose qui descritte.
address@hidden essere
+preferibile usarlo per semplici operazioni relative a data e ora in semplici
+script della shell.} Tuttavia, anche versioni recenti di @command{mawk}
+(@pxref{Altre versioni}) prevedono queste funzioni. I parametri facoltativi
+sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{mktime(@var{specifiche_data}} address@hidden,
@var{utc-flag}} address@hidden)}
address@hidden
address@hidden generare data e ora
+Trasforma @var{specifiche_data} in una marcatura temporale nello stesso formato
+restituito da @code{systime()}. @`E simile alla funzione omonima
+in ISO C. L'argomento, @var{specifiche_data}, @`e una stringa della forma
address@hidden@code{"@var{AAAA} @var{MM} @var{GG} @var{HH} @var{MM} @var{SS}
address@hidden"}}.
+La stringa consiste di sei o sette numeri che rappresentano,
+rispettivamente,
+l'anno in quattro cifre, il mese da 1 a 12, il giorno del mese
+da 1 a 31, l'ora del giorno da 0 a 23, il minuto da 0 a
+59, il secondo da 0 a 60,@footnote{Occasionalmente ci sono dei
+minuti in un anno con un secondo intercalare, il che spiega perch@'e i
+secondi possono arrivare fino a 60.}
+e un'indicazione opzionale relativa all'ora legale.
+
+I valori di questi numeri possono non essere negli intervalli specificati; per
+esempio, un'ora di @minus{}1 sta a indicare 1 ora prima di mezzanotte.
+Viene adottato il calendario gregoriano con l'origine posta all'anno zero,
+con l'anno 0 che viene prima dell'anno 1 e l'anno @minus{}1 che viene prima
+dell'anno 0. Se il flag @var{utc-flag} @`e specificato ed @`e diverso da zero
+e dalla stringa nulla, si suppone che l'ora sia quella del fuso orario UTC;
+altrimenti l'ora @`e considerata essere quella del fuso orario locale. Se
+l'indicatore dell'ora legale @`e positivo, si presuppone che l'ora sia quella
+legale; se @`e 0, l'ora considerata @`e quella di Greenwich (standard time); se
+invece @`e negativo (questo @`e il default), @code{mktime()} tenta di
+determinare se @`e in vigore l'ora legale o no, nel momento specificato.
+
+Se @var{specifiche_data} non contiene elementi in numero sufficiente, o se
+la data e ora risultante sono fuori dall'intervallo previsto,
address@hidden()} restituisce @minus{}1.
+
address@hidden @command{gawk}, vettore @code{PROCINFO} in
address@hidden @code{PROCINFO}, vettore
address@hidden vettore @code{PROCINFO}
address@hidden @code{strftime(address@hidden address@hidden,} @var{data_e_ora}
address@hidden,} @var{utc}] ] address@hidden)}
address@hidden
address@hidden formato stringa marcature temporali
address@hidden formato stringa data e ora
address@hidden data e ora, formato stringa
address@hidden marcature temporali, formato stringa
+Formatta la data e ora specificata da @var{data_e_ora} in base alle indicazioni
+contenute nella stringa @var{formato} e restituisce il risultato.
address@hidden simile alla funzione omonima in ISO C.
+Se @var{utc} @`e presente ed @`e diverso da zero o dalla stringa nulla,
+il valore @`e formattato come UTC (Tempo Coordinato Universale,
address@hidden noto come GMT o Tempo Medio di Greenwich).
+Altrimenti, il valore @`e formattato per il fuso orario locale.
+La stringa @var{data_e_ora} @`e nello stesso formato del valore restituito
+dalla funzione @code{systime()}. Se non si specifica l'argomento
address@hidden, @command{gawk} usa l'ora del giorno corrente per la
+formattazione.
+Omettendo l'argomento @var{formato}, @code{strftime()} usa
+il valore di @code{PROCINFO["strftime"]} come stringa di formattazione
+(@pxref{Variabili predefinite}).
+Il valore di default della stringa @`e
address@hidden@w{"%a %b %e %H:%M:%S %Z %Y"}}. Questa stringa di formattazione
+produce lo stesso output del programma di address@hidden equivalente
address@hidden
+Si address@hidden assegnare un nuovo valore a @code{PROCINFO["strftime"]} per
+modificare la formattazione di default; si veda
+la lista che segue per le varie direttive di formattazione.
+
address@hidden @code{systime()}
address@hidden
address@hidden marcature temporali
address@hidden data e ora, si veda marcature temporali
address@hidden data e ora corrente del sistema
+Restituisce l'ora corrente come numero di secondi a partire dall'Epoca
+del sistema. Sui sistemi aderenti allo standard POSIX, questo @`e il numero
+di secondi trascorsi a partire dal primo gennaio 1970, ora di Greenwich
+(1970-01-01 00:00:00 UTC), senza includere i secondi intercalari.
address@hidden table
+
+La funzione @code{systime()} consente di confrontare una marcatura temporale
+in un file di registro con la data e ora correnti. In particolare, @`e facile
+determinare quanto tempo prima un particolare record @`e stato registrato.
address@hidden anche possibile produrre record di registro usando il formato
+``secondi a partire dall'Epoca''.
+
address@hidden conversione di date in marcature temporali
address@hidden date, conversione in marcature temporali
address@hidden marcature temporali, conversione date nelle
+La funzione @code{mktime()} consente di convertire una rappresentazione in
+forma testuale di una data e ora in una marcatura temporale.
+Questo semplifica i confronti prima/dopo tra differenti date e ore, in
+particolare quando si abbia a che fare con date e ore provenienti da una
+fonte esterna, come un file di registro.
+
+La funzione @code{strftime()} permette di trasformare facilmente una marcatura
+temporale in un'informazione intelligibile. @`E analoga come tipo alla
funzione
address@hidden()} (@pxref{Funzioni per stringhe}), nel senso che copia
+letteralmente address@hidden che non @`e una specifica di formato nella
stringa che viene
+restituita, mentre sostituisce i valori di data e ora a seconda delle
+specifiche di formato contenute nella stringa @var{formato}.
+
address@hidden specificatori di formato, funzione @code{strftime()} di
(@command{gawk})
address@hidden formato, specificatori di, funzione @code{strftime()} di
(@command{gawk})
+Per @code{strftime()} lo standard
+1999 ISO address@hidden,
+non tutte le funzioni @code{strftime()} dei vari sistemi operativi
+ammettono tutte le conversioni qui elencate.}
+consente le seguenti specifiche di formattazione delle date:
+
address@hidden @code
address@hidden %a
+Il nome abbreviato del giorno della settimana nella lingua locale.
+
address@hidden %A
+Il nome completo del giorno della settimana nella lingua locale.
+
address@hidden %b
+Il nome abbreviato del mese dell'anno nella lingua locale.
+
address@hidden %B
+Il nome completo del mese dell'anno nella lingua locale.
+
address@hidden %c
+Il formato ``appropriato'' della rappresentazione della data e ora
+nella lingua locale.
+(Questo @`e @samp{%A %B %d %T %Y} per la localizzazione @code{"C"}.)
+
address@hidden %C
+La parte che designa il secolo nell'anno corrente.
+Si ottiene dividendo per 100 l'anno, e
+troncando verso il basso
+all'intero address@hidden vicino.
+
address@hidden %d
+Il giorno del mese come numero decimale (01--31).
+
address@hidden %D
+Equivale a specificare @samp{%m/%d/%y}.
+
address@hidden %e
+Il giorno del mese, preceduto da uno spazio se di tratta di una cifra sola.
+
address@hidden %F
+Equivale a specificare @samp{%Y-%m-%d}.
+Questo @`e il formato ISO 8601 della data.
+
address@hidden %g
+L'anno (ultime due cifre) ricavato prendendo il resto della divisione per 100
+dell'anno a cui appartiene la settimana, secondo ISO 8601, come numero decimale
+(00--99). Per esempio, il primo gennaio 2012, fa parte della settimana 53 del
+2011. Quindi, l'anno relativo al numero di settimana ISO di quella data @`e
2011
+(ossia 11), anche se la data in s@'e @`e nel 2012. Analogamente, il 31
dicembre
+2012, @`e nella prima settimana del 2013. Quindi, l'anno relativo al numero di
+settimana ISO di quella data @`e 2013 (ossia 13), anche se la data in s@'e @`e
nel
+2012.
+
address@hidden %G
+L'anno intero relativo al numero di settimana ISO, come numero decimale.
+
address@hidden %h
+Equivalente a @samp{%b}.
+
address@hidden %H
+L'ora (in un orologio a 24 ore) come numero decimale (00--23).
+
address@hidden %I
+L'ora (in un orologio a 12 ore) come numero decimale (01--12).
+
address@hidden %j
+Il giorno dell'anno come numero decimale (001--366).
+
address@hidden %m
+Il mese come numero decimale (01--12).
+
address@hidden %M
+Il minuto come numero decimale (00--59).
+
address@hidden %n
+Un carattere di ritorno a capo (ASCII LF).
+
address@hidden %p
+L'equivalente nella lingua locale delle designazioni AM/PM
+(mattino/pomerigggio) associate a un orologio a 12 ore.
+
address@hidden %r
+L'ora locale nel formato a 12 ore.
+(Questo @`e @samp{%I:%M:%S %p} nella localizzazione @code{"C"}.)
+
address@hidden %R
+Equivalente a specificare @samp{%H:%M}.
+
address@hidden %S
+Il secondo come numero decimale (00--60).
+
address@hidden %t
+Un carattere di tabulazione [TAB].
+
address@hidden %T
+Equivalente a specificare @samp{%H:%M:%S}.
+
address@hidden %u
+Il numero del giorno della settimana come numero decimale (1--7).
address@hidden@dotless{i}} @`e il giorno numero 1.
+
address@hidden %U
+Il numero di settimana dell'anno (con la prima domenica dell'anno presa
+come primo giorno della prima settimana) come numero decimale (00--53).
+
address@hidden @cindex ISO 8601
address@hidden %V
+Il numero di settimana dell'anno (con il primo address@hidden@dotless{i}}
dell'anno preso
+come primo giorno della prima settimana) come numero decimale (01--53).
+Il metodo per determinare il numero di settimana @`e quello specificato
+dallo standard ISO 8601.
+(In pratica: se la settimana che contiene il primo gennaio ha quattro o
address@hidden giorni nel nuovo anno, allora
address@hidden la settimana numero uno; altrimenti @`e l'ultima settimana
+[52 o 53] dell'anno
+precedente, e la settimana successiva @`e la settimana numero uno.)
+
address@hidden %w
+Il giorno della settimana come numero decimale (0--6).
+Domenica @`e il giorno zero.
+
address@hidden %W
+Il numero di settimana dell'anno (con il primo address@hidden@dotless{i}} come
primo giorno
+della settimana numero uno)
+come numero decimale (00--53).
+
address@hidden %x
+Il formato ``appropriato'' della rappresentazione della data
+nella lingua locale.
+(Questo @`e @samp{%A %B %d %Y} nella localizzazione @code{"C"}.)
+
address@hidden %X
+Il formato ``appropriato'' della rappresentazione della data.
+(Questo @`e @samp{%T} nella localizzazione @code{"C"}.)
+
address@hidden %y
+L'anno modulo 100 (le ultime due cifre) come numero decimale (00--99).
+
address@hidden %Y
+L'anno come numero decimale (p.es., 2015).
+
address@hidden @cindex RFC 822
address@hidden @cindex RFC 1036
address@hidden %z
+La differenza di fuso orario [rispetto all'ora di Greenwich] in formato
address@hidden@var{OOMM}} (p.es., il
+formato necessario per produrre intestazioni di data conformi agli standard
+RFC 822/RFC 1036).
+
address@hidden %Z
+Il nome o l'abbreviazione della zona di fuso orario (@dfn{time zone}); se il
fuso
+orario non @`e determinabile, @`e impostata alla stringa nulla.
+
address@hidden %Ec %EC %Ex %EX %Ey %EY %Od %Oe %OH
address@hidden %OI %Om %OM %OS %Ou %OU %OV %Ow %OW %Oy
+``notazioni alternative'' di specifica
+in cui solo la seconda lettera (@samp{%c}, @samp{%C} e
address@hidden@dotless{i}} via) @`e
address@hidden questo risulta incomprensibile, non @`e il
+caso di preoccuparsi; queste notazioni hanno lo scopo di facilitare
+la ``internazionalizzazione'' dei programmi.
+Altre address@hidden di internazionalizzazione sono descritte in
address@hidden
+(Queste facilitano la address@hidden con il programma di address@hidden
+POSIX @command{date}.)
+
address@hidden %%
+Un singolo carattere @samp{%}.
address@hidden table
+
+Se uno specificatore di conversione non @`e tra quelli elencati sopra, il
+comportamento @`e address@hidden @`e perch@'e ISO C lascia
+indefinito il comportamento della versione C di @code{strftime()} e
address@hidden usa la versione di sistema di @code{strftime()},
+se disponibile.
+Tipicamente, lo specificatore di conversione "non previsto" non appare
+nella stringa risultante, o appare address@hidden@dotless{i}} come @`e
scritto.}
+
+Per sistemi che non aderiscono completamente agli standard
address@hidden utilizza una copia di
address@hidden()} dalla libreria C di GNU.
+Sono disponibili tutte le specifiche di formato sopra elencate.
+Se la detta versione @`e
+usata per compilare @command{gawk} (@pxref{Installazione}),
+sono disponibili anche le seguenti ulteriori specifiche di formato:
+
address@hidden @code
address@hidden %k
+L'ora (in un orologio a 24 ore) come numero decimale (0--23).
+I numeri di una sola cifra sono preceduti da uno spazio bianco.
+
address@hidden %l
+L'ora (in un orologio a 12 ore) come numero decimale (1--12).
+I numeri di una sola cifra sono preceduti da uno spazio bianco.
+
address@hidden
address@hidden %N
+Il nome dell'``Imperatore/Era''.
+Equivalente a @samp{%C}.
+
address@hidden %o
+L'anno dell'``Imperatore/Era''.
+Equivalente a @samp{%y}.
address@hidden ignore
+
address@hidden %s
+L'ora espressa in numero di secondi a partire dall'Epoca.
+
address@hidden
address@hidden %v
+La data in formato VMS (p.es., @samp{20-JUN-1991}).
address@hidden ignore
address@hidden table
+
+In aggiunta a address@hidden, le notazioni alternative sono riconosciute, ma al
+loro posto sono usate quelle normali.
+
address@hidden @code{date}, programma di address@hidden POSIX
address@hidden programma di address@hidden POSIX @code{date}
address@hidden POSIX @command{awk}, programma di address@hidden @code{date} e
+Il seguente esempio @`e un'implementazione @command{awk} del
+programma di address@hidden POSIX @command{date}.
+Normalmente, il programma di address@hidden @command{date} stampa la
+data e l'ora corrente nel formato ben noto. Tuttavia, se si
+specifica al comando un argomento che inizia con un @samp{+}, @command{date}
+copia i caratteri che non sono specifiche di formato nello standard output
+e interpreta l'ora corrente secondo gli specificatori di formato
+contenuti nella stringa. Per esempio:
+
address@hidden
+$ @kbd{date '+Oggi @`e %A, %d %B %Y.'}
address@hidden Oggi @`e address@hidden@dotless{i}}, 22 settembre 2014.
address@hidden example
+
+Ecco la versione @command{gawk} del programma di address@hidden @command{date}.
address@hidden all'interno di uno script di shell per gestire l'opzione
@option{-u},
+che richiede che @command{date} sia eseguito come se il fuso orario
+fosse impostato a UTC:
+
address@hidden
+#! /bin/sh
+#
+# date --- simula il comando POSIX 'date'
+
+case $1 in
+-u) TZ=UTC0 # usare UTC
+ export TZ
+ shift ;;
+esac
+
+gawk 'BEGIN @{
+ formato = PROCINFO["strftime"]
+ codice_di_ritorno = 0
+
+ if (ARGC > 2)
+ codice_di_ritorno = 1
+ else if (ARGC == 2) @{
+ formato = ARGV[1]
+ if (formato ~ /^\+/)
+ formato = substr(formato, 2) # togli il + iniziale
+ @}
+ print strftime(formato)
+ exit codice_di_ritorno
address@hidden' "$@@"
address@hidden example
+
address@hidden Funzioni a livello di bit
address@hidden Funzioni per operazioni di manipolazione bit
address@hidden bit, funzioni per la manipolazione di
address@hidden manipolazione di bit, funzioni per la
address@hidden funzioni per la manipolazione di bit
address@hidden bit, operazioni sui
address@hidden AND, operazione sui bit
address@hidden OR, operazione sui bit
address@hidden XOR, operazione sui bit
address@hidden operazioni sui bit
address@hidden
address@hidden posso spiegarlo per te, ma non posso capirlo per te.}
address@hidden Anonimo
address@hidden quotation
+
+Molti linguaggi consentono di eseguire operazioni @dfn{bit a bit}
+su due numeri interi. In altre parole, l'operazione @`e eseguita
+su ogni successiva coppia di bit presi da ognuno dei due operandi.
+Tre operazioni comuni sono AND, OR e XOR bit a bit.
+Queste operazioni sono descritte nella @ref{table-bitwise-ops}.
+
address@hidden 11/2014: Postprocessing turns the docbook informaltable
address@hidden into a table. Hurray for scripting!
address@hidden Tabella,table-bitwise-ops
address@hidden a livello di bit}
address@hidden
address@hidden
address@hidden
address@hidden
+ Operatore booleano
+ | AND | OR | XOR
+ |---+---+---+---+---+---
+Operandi | 0 | 1 | 0 | 1 | 0 | 1
+----------+---+---+---+---+---+---
+ 0 | 0 0 | 0 1 | 0 1
+ 1 | 0 1 | 1 1 | 1 0
address@hidden verbatim
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+\centerline{
+\vbox{\bigskip % space above the table (about 1 linespace)
+% Because we have vertical rules, we can't let TeX insert interline space
+% in its usual way.
+\offinterlineskip
+\halign{\strut\hfil#\quad\hfil % operands
+ &\vrule#&\quad#\quad % rule, 0 (of and)
+ &\vrule#&\quad#\quad % rule, 1 (of and)
+ &\vrule# % rule between and and or
+ &\quad#\quad % 0 (of or)
+ &\vrule#&\quad#\quad % rule, 1 (of of)
+ &\vrule# % rule between or and xor
+ &\quad#\quad % 0 of xor
+ &\vrule#&\quad#\quad % rule, 1 of xor
+ \cr
+&\omit&\multispan{11}\hfil\bf Operatore booleano\hfil\cr
+\noalign{\smallskip}
+& &\multispan3\hfil AND\hfil&&\multispan3\hfil OR\hfil
+ &&\multispan3\hfil XOR\hfil\cr
+\bf Operandi&&0&&1&&0&&1&&0&&1\cr
+\noalign{\hrule}
+\omit&height 2pt&&\omit&&&&\omit&&&&\omit\cr
+\noalign{\hrule height0pt}% without this the rule does not extend; why?
+0&&0&\omit&0&&0&\omit&1&&0&\omit&1\cr
+1&&0&\omit&1&&1&\omit&1&&1&\omit&0\cr
+}}}
address@hidden tex
+
address@hidden
+<informaltable>
+
+<tgroup cols="7" colsep="1">
+<colspec colname="c1"/>
+<colspec colname="c2"/>
+<colspec colname="c3"/>
+<colspec colname="c4"/>
+<colspec colname="c5"/>
+<colspec colname="c6"/>
+<colspec colname="c7"/>
+<spanspec spanname="optitle" namest="c2" nameend="c7" align="center"/>
+<spanspec spanname="andspan" namest="c2" nameend="c3" align="center"/>
+<spanspec spanname="orspan" namest="c4" nameend="c5" align="center"/>
+<spanspec spanname="xorspan" namest="c6" nameend="c7" align="center"/>
+
+<tbody>
+<row>
+<entry colsep="0"></entry>
+<entry spanname="optitle"><emphasis role="bold">Operatore
booleano</emphasis></entry>
+</row>
+
+<row rowsep="1">
+<entry rowsep="0"></entry>
+<entry spanname="andspan">AND</entry>
+<entry spanname="orspan">OR</entry>
+<entry spanname="xorspan">XOR</entry>
+</row>
+
+<row rowsep="1">
+<entry ><emphasis role="bold">Operandi</emphasis></entry>
+<entry colsep="0">0</entry>
+<entry colsep="1">1</entry>
+<entry colsep="0">0</entry>
+<entry colsep="1">1</entry>
+<entry colsep="0">0</entry>
+<entry colsep="1">1</entry>
+</row>
+
+<row>
+<entry align="center">0</entry>
+<entry colsep="0">0</entry>
+<entry>0</entry>
+<entry colsep="0">0</entry>
+<entry>1</entry>
+<entry colsep="0">0</entry>
+<entry>1</entry>
+</row>
+
+<row>
+<entry align="center">1</entry>
+<entry colsep="0">0</entry>
+<entry>1</entry>
+<entry colsep="0">1</entry>
+<entry>1</entry>
+<entry colsep="0">1</entry>
+<entry>0</entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
address@hidden docbook
address@hidden float
+
address@hidden bit, complemento a livello di
address@hidden complemento a livello di bit
+Come si vede, il risultato di un'operazione di AND @`e 1 solo quando
address@hidden i bit sono 1.
+Il risultato di un'operazione di OR @`e 1 se @emph{almeno un} bit @`e 1.
+Il risultato di un'operazione di XOR @`e 1 se l'uno o l'altro
+bit @`e 1, ma non tutti e due.
+La successiva operazione @`e il @dfn{complemento}; il complemento di 1 @`e 0 e
+il complemento di 0 @`e 1. Quindi, quest'operazione ``inverte'' tutti i bit
+di un dato valore.
+
address@hidden bit, spostamento di
address@hidden spostamento a sinistra, bit a bit
address@hidden spostamento a destra, bit a bit
address@hidden spostamento, bit a bit
+Infine, due altre operazioni comuni consistono nello spostare i bit
+a sinistra o a destra.
+Per esempio, se si ha una stringa di bit @samp{10111001} e la si sposta
+a destra di tre bit, si ottiene @address@hidden esempio
+presuppone che degli zeri riempiano le posizioni a sinistra.
+Per @command{gawk}, @`e sempre
address@hidden@dotless{i}}, ma in alcuni linguaggi @`e possibile che le
posizioni a sinistra
+siano riempite con degli uno.}
+Partendo nuovamente da @samp{10111001} e spostandolo a sinistra di tre
+bit, si ottiene @samp{11001000}. La lista seguente descrive
+le funzioni predefinite di @command{gawk} che rendono disponibili
+le operazioni a livello di bit.
+I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @command{gawk}, operazioni a livello di bit in
address@hidden @code
address@hidden
address@hidden AND, operazione sui bit
address@hidden @code{and(address@hidden@code{,} @var{v2} address@hidden,}
@address@hidden)}
+Restituisce l'AND bit a bit degli argomenti.
+Gli argomenti devono essere almeno due.
+
address@hidden
address@hidden complemento a livello di bit
address@hidden @code{compl(@var{val})}
+Restituisce il complemento bit a bit di @var{val}.
+
address@hidden
address@hidden spostamento a sinistra
address@hidden @code{lshift(@var{val}, @var{contatore})}
+Restituisce il valore di @var{val}, spostato a sinistra di
address@hidden bit.
+
address@hidden
address@hidden OR, operazione sui bit
address@hidden @code{or(address@hidden@code{,} @var{v2} address@hidden,}
@address@hidden)}
+Restituisce l'OR bit a bit degli argomenti.
+Gli argomenti devono essere almeno due.
+
address@hidden
address@hidden spostamento a destra
address@hidden @code{rshift(@var{val}, @var{contatore})}
+Restituisce il valore di @var{val}, spostato a destra
+di @var{contatore} bit.
+
address@hidden
address@hidden XOR, operazione sui bit
address@hidden @code{xor(address@hidden@code{,} @var{v2} address@hidden,}
@address@hidden)}
+Restituisce il XOR bit a bit degli argomenti.
+Gli argomenti devono essere almeno due.
address@hidden table
+
address@hidden ATTENZIONE
+A partire dalla versione di @command{gawk} @value{PVERSION} 4.2, gli operandi
+negativi non sono consentiti per nessuna di queste funzioni. Un operando
+negativo produce un errore fatale. Si veda la nota a lato
+``Attenzione. Non @`e tutto oro quel che luccica!'' per maggiori informazioni
sul perch@'e.
address@hidden quotation
+
+Ecco una funzione definita dall'utente (@pxref{Funzioni definite dall'utente})
+che illustra l'uso di queste funzioni:
+
address@hidden @code{bits2str()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{bits2str()}
address@hidden @code{testbits.awk}, programma
address@hidden programma @code{testbits.awk}
address@hidden
address@hidden
address@hidden file eg/lib/bits2str.awk
+# bits2str --- decodifica un byte in una serie di 0/1 leggibili
+
+function bits2str(byte, dati, maschera)
address@hidden
+ if (byte == 0)
+ return "0"
+
+ maschera = 1
+ for (; byte != 0; stringa = rshift(stringa, 1))
+ dati = (and(byte, maschera) ? "1" : "0") dati
+
+ while ((length(dati) % 8) != 0)
+ dati = "0" dati
+
+ return dati
address@hidden
address@hidden endfile
address@hidden group
+
address@hidden this is a hack to make testbits.awk self-contained
address@hidden
address@hidden file eg/prog/testbits.awk
+# bits2str --- turn a byte into readable 1's and 0's
+
+function bits2str(bits, data, mask)
address@hidden
+ if (bits == 0)
+ return "0"
+
+ mask = 1
+ for (; bits != 0; bits = rshift(bits, 1))
+ data = (and(bits, mask) ? "1" : "0") data
+
+ while ((length(data) % 8) != 0)
+ data = "0" data
+
+ return data
address@hidden
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/testbits.awk
+BEGIN @{
+ printf "123 = %s\n", bits2str(123)
+ printf "0123 = %s\n", bits2str(0123)
+ printf "0x99 = %s\n", bits2str(0x99)
+ comp = compl(0x99)
+ printf "compl(0x99) = %#x = %s\n", comp, bits2str(comp)
+ shift = lshift(0x99, 2)
+ printf "lshift(0x99, 2) = %#x = %s\n", shift, bits2str(shift)
+ shift = rshift(0x99, 2)
+ printf "rshift(0x99, 2) = %#x = %s\n", shift, bits2str(shift)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Questo programma produce il seguente output quando viene eseguito:
+
address@hidden
+$ @kbd{gawk -f testbits.awk}
address@hidden 123 = 01111011
address@hidden 0123 = 01010011
address@hidden 0x99 = 10011001
address@hidden compl(0x99) = 0x3fffffffffff66 =
001111111111111111111111111111111
address@hidden 11111111111111101100110
address@hidden lshift(0x99, 2) = 0x264 = 0000001001100100
address@hidden rshift(0x99, 2) = 0x26 = 00100110
address@hidden example
+
address@hidden conversione da stringhe a numeri
address@hidden stringhe, conversione
address@hidden numeri, conversione in stringhe
address@hidden conversione da numeri a stringhe
address@hidden numero visto come stringa di bit
+La funzione @code{bits2str()} trasforma un numero binario in una stringa.
+Inizializzando @code{maschera} a uno otteniamo
+un valore binario in cui il bit address@hidden a destra @`e impostato a
+uno. Usando questa maschera,
+la funzione continua a controllare il bit address@hidden a destra.
+l'operazione di AND tra la maschera e il valore indica se il
+bit address@hidden a destra @`e uno oppure no. Se questo @`e il caso, un
@code{"1"}
address@hidden concatenato all'inizio della stringa.
+Altrimenti, @`e concatenato uno @code{"0"}.
+Il valore @`e quindi spostato a destra di un bit e il ciclo continua
+finch@'e non ci sono address@hidden bit.
+
+Se il valore iniziale @`e zero, viene restituito semplicemente uno @code{"0"}.
+Altrimenti, alla fine, al valore ottenuto vengono aggiunti degli zeri a
+sinistra, per arrivare a stringhe
+di lunghezza multipla di 8, ossia contenenti un numero intero di byte.
+Questo @`e tipico dei computer moderni.
+
+Il codice principale nella regola @code{BEGIN} mostra la differenza tra
+i valori decimale e ottale dello stesso numero.
+(@pxref{Numeri non-decimali}),
+e poi mostra i risultati delle funzioni
address@hidden()}, @code{lshift()} e @code{rshift()}.
+
address@hidden sidebar, Attenzione. Non @`e tutto oro quel che luccica!
address@hidden
address@hidden
+<sidebar><title>Attenzione. Non @`e tutto oro quel che luccica!</title>
address@hidden docbook
+
+
+In altri linguaggi, le operazioni "bit a bit" sono eseguite su valori interi,
+non su valori a virgola mobile. Come regola generale, tali operazioni
+funzionano meglio se eseguite su interi senza segno.
+
address@hidden tenta di trattare gli argomenti delle funzioni
+"bit a bit" come interi senza segno. Per questo motivo, gli argomenti negativi
+provocano un errore fatale.
+
+In una normale operazione, per tutte queste funzioni, prima il valore a virgola
+mobile a doppia precisione viene convertito nel tipo intero senza segno di C
address@hidden ampio, poi viene eseguita l'operazione "bit a bit". Se il
risultato non
address@hidden essere rappresentato esattamente come un tipo @code{double} di C,
+vengono rimossi i bit iniziali diversi da zero uno alla volta finch@'e
+non sono rappresentati esattamente. Il risultato @`e poi nuovamente convertito
+in un tipo @code{double} di address@hidden essere address@hidden chiari,
+la conseguenza @`e che @command{gawk} address@hidden memorizzare solo un
determinato
+intervallo di valori interi; i numeri al di fuori di questo intervallo vengono
+ridotti per rientrare all'interno dell'intervallo.}
+
+Comunque, quando si usa il calcolo con precisione arbitraria con l'opzione
address@hidden (@pxref{Calcolo con precisione arbitraria}), il risultato
address@hidden
+essere diverso. Questo @`e particolarmente evidente con la funzione
@code{compl()}:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print compl(42) @}'}
address@hidden 9007199254740949
+$ @kbd{gawk -M 'BEGIN @{ print compl(42) @}'}
address@hidden -43
address@hidden example
+
+Quel che avviene diventa chiaro quando si stampano i risultati
+in notazione esadecimale:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "%#x\n", compl(42) @}'}
address@hidden 0x1fffffffffffd5
+$ @kbd{gawk -M 'BEGIN @{ printf "%#x\n", compl(42) @}'}
address@hidden 0xffffffffffffffd5
address@hidden example
+
+Quando si usa l'opzione @option{-M}, nel dettaglio, @command{gawk} usa
+gli interi a precisione arbitraria di GNU MP che hanno almeno 64 bit di
precisione.
+Quando non si usa l'opzione @option{-M}, @command{gawk} memorizza i valori
+interi come regolari valori a virgola mobile con doppia precisione, che
+mantengono solo 53 bit di precisione. Inoltre, la libreria GNU MP tratta
+(o almeno sembra che tratti) il bit iniziale come un bit con segno;
address@hidden il
+risultato con @option{-M} in questo caso @`e un numero negativo.
+
+In breve, usare @command{gawk} per qualsiasi tipo di operazione "bit a bit",
+tranne le address@hidden semplici, probabilmente @`e una cattiva idea; caveat
emptor!
+
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Attenzione. Non @`e tutto oro quel che luccica!}
+
+
+
+In altri linguaggi, le operazioni "bit a bit" sono eseguite su valori interi,
+non su valori a virgola mobile. Come regola generale, tali operazioni
+funzionano meglio se eseguite su interi senza segno.
+
address@hidden tenta di trattare gli argomenti delle funzioni
+"bit a bit" come interi senza segno. Per questo motivo, gli argomenti negativi
+provocano un errore fatale.
+
+In una normale operazione, per tutte queste funzioni, prima il valore a virgola
+mobile a doppia precisione viene convertito nel tipo intero senza segno di C
address@hidden ampio, poi viene eseguita l'operazione "bit a bit". Se il
risultato non
address@hidden essere rappresentato esattamente come un tipo @code{double} di C,
+vengono rimossi i bit iniziali diversi da zero uno alla volta finch@'e
+non sono rappresentati esattamente. Il risultato @`e poi nuovamente convertito
+in un tipo @code{double} di address@hidden essere address@hidden chiari,
+la conseguenza @`e che @command{gawk} address@hidden memorizzare solo un
determinato
+intervallo di valori interi; i numeri al di fuori di questo intervallo vengono
+ridotti per rientrare all'interno dell'intervallo.}
+
+Comunque, quando si usa il calcolo con precisione arbitraria con l'opzione
address@hidden (@pxref{Calcolo con precisione arbitraria}), il risultato
address@hidden
+essere diverso. Questo @`e particolarmente evidente con la funzione
@code{compl()}:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print compl(42) @}'}
address@hidden 9007199254740949
+$ @kbd{gawk -M 'BEGIN @{ print compl(42) @}'}
address@hidden -43
address@hidden example
+
+Quel che avviene diventa chiaro quando si stampano i risultati
+in notazione esadecimale:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "%#x\n", compl(42) @}'}
address@hidden 0x1fffffffffffd5
+$ @kbd{gawk -M 'BEGIN @{ printf "%#x\n", compl(42) @}'}
address@hidden 0xffffffffffffffd5
address@hidden example
+
+Quando si usa l'opzione @option{-M}, nel dettaglio, @command{gawk} usa
+gli interi a precisione arbitraria di GNU MP che hanno almeno 64 bit di
precisione.
+Quando non si usa l'opzione @option{-M}, @command{gawk} memorizza i valori
+interi come regolari valori a virgola mobile con doppia precisione, che
+mantengono solo 53 bit di precisione. Inoltre, la libreria GNU MP tratta
+(o almeno sembra che tratti) il bit iniziale come un bit con segno;
address@hidden il
+risultato con @option{-M} in questo caso @`e un numero negativo.
+
+In breve, usare @command{gawk} per qualsiasi tipo di operazione "bit a bit",
+tranne le address@hidden semplici, probabilmente @`e una cattiva idea; caveat
emptor!
+
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Funzioni per i tipi
address@hidden Funzioni per conoscere il tipo di una variabile
+
address@hidden prevede due funzioni che permettono di conoscere
+il tipo di una variabile.
+Questo @`e necessario per scrivere del codice che visiti ogni elemento di un
+vettore di vettori
+(@pxref{Vettori di vettori}) e in altri contesti.
+
address@hidden @code
address@hidden
address@hidden scalare o vettore
address@hidden isarray(@var{x})
+Restituisce il valore 'vero' se @var{x} @`e un vettore. Altrimenti, restituisce
+'falso'.
+
address@hidden
address@hidden variabile, tipo di una
address@hidden tipo di una variabile
address@hidden typeof(@var{x})
+Restituisce una delle stringhe seguenti, a seconda del tipo di @var{x}:
+
address@hidden nested table
address@hidden @code
address@hidden "array"
address@hidden @`e un vettore.
+
address@hidden "regexp"
address@hidden @`e una @dfn{regexp} fortemente tipizzata
+(@pxref{Costanti @dfn{regexp} forti}).
+
address@hidden "number"
address@hidden @`e un numero.
+
address@hidden "string"
address@hidden @`e una stringa.
+
address@hidden "strnum"
address@hidden @`e un numero che ha avuto origine da un input dell'utente,
+come un campo o il risultato di una chiamata a @code{split()}.
+(address@hidden, @var{x} ha l'attributo @dfn{strnum};
address@hidden di variabile}.)
+
address@hidden "unassigned"
address@hidden @`e una variabile scalare a cui non @`e ancora stato assegnato
un valore.
+Per esempio:
+
address@hidden
+BEGIN @{
+ # crea a[1] ma non gli attribuisce alcun valore
+ a[1]
+ print typeof(a[1]) # unassigned
address@hidden
address@hidden example
+
address@hidden "untyped"
address@hidden non @`e stata usata per nulla; address@hidden diventare uno
scalare o un
+vettore.
+Per esempio:
+
address@hidden
+BEGIN @{
+ print typeof(x) # x non @`e mai stato usato --> untyped
+ mk_arr(x)
+ print typeof(x) # x ora @`e un vettore --> array
address@hidden
+
+function mk_arr(a) @{ a[1] = 1 @}
address@hidden example
+
address@hidden table
address@hidden table
+
address@hidden()} torna utile in due occasioni. La prima @`e quando
+si visita un vettore multidimensionale: si address@hidden stabilire se un
elemento @`e
+un vettore oppure no. La seconda @`e all'interno del corpo di una funzione
+definita dall'utente (argomento non ancora trattato;
address@hidden definite dall'utente}), per determinare se un parametro
address@hidden un vettore oppure no.
+
address@hidden NOTA
+Usare @code{isarray()} a livello globale per controllare le variabili
+non ha alcun senso. Si suppone infatti che chi scrive il programma
+sappia se una variabile @`e un vettore oppure no. E in
+effetti, per come funziona @command{gawk}, se si passa una variabile
+che non sia stata usata in precedenza a @code{isarray()}, @command{gawk}
+la crea al volo, assegnandole il tipo scalare.
address@hidden quotation
+
+La funzione @code{typeof()} @`e generale; consente di determinare
+se una variabile o un parametro di funzione @`e uno scalare, un vettore,
+o una @dfn{regexp} fortemente tipizzata.
+
+L'uso di @code{isarray()} @`e deprecato; si dovrebbe usare @code{typeof()}
+al suo posto. Si dovrebbe sostituire ogni uso esistente di
address@hidden(var)} nei programmi esistenti con
address@hidden(var) == "array"}.
+
address@hidden Funzioni di internazionalizzazione
address@hidden Funzioni per tradurre stringhe
address@hidden @command{gawk}, funzioni di traduzione di stringhe
address@hidden funzioni di traduzione di stringhe
address@hidden traduzione di stringhe, funzioni di
address@hidden internazionalizzazione
address@hidden programmi @command{awk}, internazionalizzare
+
address@hidden prevede strumenti per internazionalizzare i programmi
address@hidden
+Questi sono costituiti dalle funzioni descritte nella lista seguente.
+Le descrizioni sono volutamente concise.
address@hidden,
+per un'esposizione completa.
+I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @asis
address@hidden
address@hidden impostare directory con catalogo messaggi tradotti
address@hidden messaggi tradotti, impostare directory con catalogo
address@hidden @code{bindtextdomain(@var{directory}} address@hidden,}
@address@hidden)}
+Imposta la directory in cui
address@hidden trova i file di traduzione dei messaggi, nel caso in cui
+non siano o non possano essere messi nelle directory ``standard''
+(p.es., durante la fase di test di un programma).
+Restituisce la directory alla quale @var{dominio} @`e ``connesso.''
+
+Il default per @var{dominio} @`e il valore di @code{TEXTDOMAIN}.
+Se @var{directory} @`e la stringa nulla (@code{""}),
address@hidden()} restituisce la connessione corrente per il
address@hidden dato.
+
address@hidden
address@hidden traduzione di stringhe
address@hidden @code{dcgettext(@var{stringa}} address@hidden,} @var{dominio}
address@hidden,} @var{categoria}] address@hidden)}
+Restituisce la traduzione di @var{stringa} nel
+dominio linguistico @var{dominio} per la categoria di localizzazione
address@hidden
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
+
address@hidden
address@hidden @code{dcngettext(@var{stringa1}, @var{stringa2}, @var{numero}}
address@hidden,} @var{dominio} address@hidden,} @var{categoria}]
address@hidden)}
+Restituisce la forma plurale usata per @var{numero} nella
+traduzione di @var{stringa1} e @var{stringa2} nel dominio di testo
address@hidden per la categoria di localizzazione @var{categoria}.
address@hidden @`e la variante al singolare in inglese di un messaggio e
address@hidden @`e la variante al plurare in inglese dello stesso messaggio.
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
address@hidden table
+
address@hidden Funzioni definite dall'utente
address@hidden Funzioni definite dall'utente
+
address@hidden funzioni definite dall'utente
address@hidden utente, funzioni definite dall'
+Programmi @command{awk} complessi spesso possono essere semplificati
+definendo delle apposite funzioni personali.
+Le funzioni definite dall'utente sono richiamate allo stesso modo di quelle
+predefinite
+(@pxref{Chiamate di funzione}),
+ma dipende dall'utente la loro definizione
+(address@hidden, dire ad @command{awk} cosa dovrebbero fare queste funzioni).
+
address@hidden
+* Sintassi delle definizioni:: Come scrivere definizioni e cosa
+ significano.
+* Esempio di funzione:: Un esempio di definizione di
+ funzione e spiegazione della stessa.
+* Precisazioni sulle funzioni:: Cose a cui prestare attenzione.
+* Istruzione return:: Specificare il valore che una
+ funzione restituisce.
+* Variabili di tipo dinamico:: Come cambiare tipo a una variabile in
+ fase di esecuzione del programma.
address@hidden menu
+
address@hidden Sintassi delle definizioni
address@hidden Come scrivere definizioni e cosa significano
+
address@hidden
address@hidden al vero affermare che la sintassi di awk per la definizione
+di variabili locali @`e semplicemente atroce.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden funzioni, definizione di
address@hidden definizione di funzioni
+Definizioni di funzioni possono stare in una posizione qualsiasi tra le regole
+di un programma @command{awk}. Quindi, la forma generale di un
+programma @command{awk} @`e estesa per
+permettere l'inclusione di regole @emph{e} la definizione di funzioni
+create dall'utente.
+Non @`e necessario che la definizione di una funzione sia posta prima
+del richiamo della stessa. Questo dipende dal fatto che @command{awk}
+legge l'intero programma, prima di iniziare ad eseguirlo.
+
+La definizione di una funzione chiamata @var{nome} @`e simile a questa:
+
address@hidden
address@hidden @address@hidden(address@hidden@code{)}
address@hidden@{}
+ @var{corpo-della-funzione}
address@hidden@}}
address@hidden display
+
address@hidden nomi di funzione
address@hidden funzioni, nomi di
address@hidden limitazioni nei nomi di funzione
address@hidden nomi di funzione, limitazioni nei
address@hidden
+Qui, @var{nome} @`e il nome della funzione da definire. Un nome di funzione
+valido @`e come un nome di variabile valido: una sequenza di
+lettere, cifre e trattini bassi che non inizia con una cifra.
+Anche qui, solo le 52 lettere inglesi maiuscole e minuscole possono
+essere usate in un nome di funzione.
+All'interno di un singolo programma @command{awk}, un dato nome address@hidden
essere
+usato una sola volta: per una variabile, o per un vettore,
+o per una funzione.
+
address@hidden @`e una lista opzionale degli argomenti della funzione
+e dei nomi delle variabili locali,
+separati da virgole. Quando la funzione viene chiamata,
+i nomi degli argomenti sono usati per contenere il valore degli argomenti
+passati con la chiamata.
+
+Una funzione non address@hidden avere due parametri con lo stesso nome, e
neanche un
+parametro con lo stesso nome della funzione stessa.
+
address@hidden ATTENZIONE
+Secondo lo standard POSIX, i parametri di funzione
+non possono avere lo stesso nome di una delle speciali variabili predefinite
+(@pxref{Variabili predefinite}), e un parametro di funzione non address@hidden
avere
+lo stesso nome di un'altra funzione.
+Non tutte le versioni di @command{awk} applicano queste limitazioni.
address@hidden applica solo la prima di queste restrizioni.
+Se viene specificata l'opzione @option{--posix} (@pxref{Opzioni}),
+anche la seconda restrizione viene applicata.
address@hidden quotation
+
+Le variabili locali si comportano come la stringa vuota
+se vengono utilizzate dove @`e richiesto il valore di una stringa,
+e valgono zero se utilizzate dove @`e richiesto un valore numerico.
+Questo @`e lo stesso comportamento delle variabili regolari a cui non sia
+stato ancora assegnato un valore. (Ci sono ulteriori informazioni riguardo
+alle variabili locali;
address@hidden di tipo dinamico}.)
+
+Il @var{corpo-della-funzione} @`e composto da istruzioni @command{awk}.
+Questa @`e la parte address@hidden importante della definizione, perch@'e dice
quello che
+la funzione dovrebbe realmente
address@hidden I nomi di argomento esistono per consentire al corpo della
+funzione di gestire gli argomenti;
+le variabili locali esistono per consentire al corpo della funzione di
+memorizzare dei valori temporanei.
+
+I nomi di argomento non sono sintatticamente distinti da quelli delle
+variabili locali. Invece, il numero di argomenti forniti quando la
+funzione viene chiamata determina quanti degli argomenti passati sono delle
+variabili. Quindi, se tre valori di argomento sono specificati, i primi
+tre nomi in @var{lista-parametri}
+sono degli argomenti e i rimanenti sono delle variabili locali.
+
+Ne consegue che se il numero di argomenti richiesto non @`e lo stesso in
+tutte le chiamate alla funzione, alcuni dei nomi in @var{lista-parametri}
+possono essere in alcuni casi degli argomenti e in altri casi
+delle variabili locali. Un'altra angolatura da cui guardare questo fatto
address@hidden che gli argomenti omessi assumono come valore di default la
stringa nulla.
+
address@hidden convenzioni di programmazione, nella scrittura di funzioni
address@hidden funzioni, convenzioni di programmazione, nella scrittura di
+Solitamente, quando si scrive una funzione, si sa quanti nomi si intendono
+usare per gli argomenti e quanti si vogliono usare come variabili locali.
address@hidden una convenzione in uso quella di aggiungere alcuni spazi extra
tra gli
+argomenti e le variabili locali, per documentare come va utilizzata quella
+funzione.
+
address@hidden variabili nascoste
address@hidden nascondere valori di variabile
+Durante l'esecuzione del corpo della funzione, gli argomenti e i valori
+delle variabili locali
+nascondono, o @dfn{oscurano}, qualsiasi variabile dello stesso nome usata
+nel resto del programma. Le variabili oscurate non sono accessibili
+nel corpo della funzione, perch@'e non c'@`e modo di accedere a esse
+mentre i loro nomi sono stati "occupati" dagli argomenti e dalla variabili
+locali. Tutte le altre variabili usate nel programma @command{awk}
+possono essere accedute o impostate normalmente nel corpo della funzione.
+
+Gli argomenti e le variabili locali esistono solo finch@'e il corpo della
+funzione @`e in esecuzione. Una volta che l'esecuzione @`e terminata,
+ritornano accessibili le variabili che erano oscurate
+durante l'esecuzione della funzione.
+
address@hidden ricorsive, funzioni
address@hidden funzioni ricorsive
+Il corpo della funzione address@hidden contenere espressioni che chiamano altre
+funzioni. Tali espressioni possono perfino chiamare direttamente, o
+indirettamente tramite un'altra funzione, la funzione stessa.
+Quando questo succede, la funzione @`e detta @dfn{ricorsiva}.
+Il fatto che una funzione richiami se stessa @`e detto @dfn{ricorsione}.
+
+Tutte le funzioni predefinite restituiscono un valore al loro chiamante.
+Anche le funzioni definite dall'utente possono farlo, usando
+l'istruzione @code{return},
+che @`e descritta in dettaglio nella @ref{Istruzione return}.
+Molti dei successivi esempi in questa @value{SECTION} usano
+l'istruzione @code{return}.
+
address@hidden estensioni comuni, parola chiave @code{func}
address@hidden @cindex @command{awk} language, POSIX version
address@hidden @cindex POSIX @command{awk}
address@hidden POSIX @command{awk}, parola chiave @code{function} in
+In molte implementazioni di @command{awk}, compreso @command{gawk},
+la parola chiave @code{function} address@hidden essere
+abbreviata come @code{func}. @value{COMMONEXT}
+Tuttavia, POSIX specifica solo l'uso della parola chiave
address@hidden Questo ha alcune implicazioni di carattere pratico.
+Se @command{gawk} @`e in address@hidden POSIX-compatibile
+(@pxref{Opzioni}), la seguente
+istruzione @emph{non} definisce una funzione:
+
address@hidden
+func foo() @{ a = sqrt($1) ; print a @}
address@hidden example
+
address@hidden
+Invece, definisce una regola che, per ogni record, concatena il valore
+della variabile @samp{func} con il valore restituito dalla funzione @samp{foo}.
+Se la stringa risultante @`e diversa dalla stringa nulla, l'azione viene
eseguita.
+Questo non @`e con ogni address@hidden quello che si desidera.
+(@command{awk} accetta questo input come
+sintatticamente valido, perch@'e le funzioni, nei programmi @command{awk}
+possono essere usate prima che siano state address@hidden
+programma in address@hidden non address@hidden eseguito, perch@'e @code{foo()}
address@hidden
+essere una funzione non definita.})
+
address@hidden address@hidden, nella definizione di funzioni
+Per essere certi che un programma @command{awk} sia portabile,
+va sempre usata la parola chiave
address@hidden per definire una funzione.
+
address@hidden Esempio di funzione
address@hidden Un esempio di definizione di funzione
address@hidden esempio di definizione di funzione
address@hidden funzione, esempio di definizione di
+
+
+Ecco un esempio di funzione definita dall'utente, di nome
address@hidden()}, che
+ha come input un numero e lo stampa in un formato specifico:
+
address@hidden
+function stampa_num(numero)
address@hidden
+ printf "%6.3g\n", numero
address@hidden
address@hidden example
+
address@hidden
+Per comprenderne il funzionamento, ecco una regola @command{awk} che usa
+la funzione @code{stampa_num()}:
+
address@hidden
+$3 > 0 @{ stampa_num($3) @}
address@hidden example
+
address@hidden
+Questo programma stampa, nel nostro formato speciale, tutti i terzi campi
+nei record in input che
+contengono un numero positivo. Quindi, dato il seguente input:
+
address@hidden
+ 1.2 3.4 5.6 7.8
+ 9.10 11.12 -13.14 15.16
+17.18 19.20 21.22 23.24
address@hidden example
+
address@hidden
+questo programma, usando la nostra funzione per formattare i risultati, stampa:
+
address@hidden
+ 5.6
+ 21.2
address@hidden example
+
+La funzione seguente cancella tutti gli elementi in un vettore
+(si ricordi che gli spazi bianchi in soprannumero stanno a indicare
+l'inizio della lista delle variabili locali):
+
address@hidden
+function cancella_vettore(a, i)
address@hidden
+ for (i in a)
+ delete a[i]
address@hidden
address@hidden example
+
+Quando si lavora con vettori, @`e spesso necessario cancellare
+tutti gli elementi in un vettore e ripartire con una nuova lista di elementi
+(@pxref{Cancellazione}).
+Invece di dover ripetere
+questo ciclo ogni volta che si deve cancellare
+un vettore, un programma address@hidden limitarsi a effettuare una chiamata
+a @code{cancella_vettore()}.
+(Questo garantisce la address@hidden L'uso di @samp{delete @var{vettore}}
+per cancellare
+il contenuto di un intero vettore @`e un'aggiunta relativamente
address@hidden la fine del 2012.}
+allo standard POSIX.)
+
+Quello che segue @`e un esempio di una funzione ricorsiva. Prende come
+parametro di input una stringa e restituisce la stringa in ordine inverso.
+Le funzioni ricorsive devono sempre avere un test che interrompa la
+ricorsione.
+In questo caso, la ricorsione termina quando la stringa in input @`e
address@hidden vuota:
+
address@hidden 8/2014: Thanks to Mike Brennan for the improved formulation
address@hidden @code{rev()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{rev()}
address@hidden
+function rev(stringa)
address@hidden
+ if (stringa == "")
+ return ""
+
+ return (rev(substr(stringa, 2)) substr(stringa, 1, 1))
address@hidden
address@hidden example
+
+Se questa funzione @`e in un file di nome @file{rev.awk}, si address@hidden
provare
address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{echo "Non v'allarmate!" |}
+> @kbd{gawk -e '@{ print rev($0) @}' -f rev.awk}
address@hidden !etamralla'v noN
address@hidden example
+
+La funzione C @code{ctime()} prende una marcatura temporale e la restituisce
+come una stringa,
+formattata come address@hidden sappiamo.
+Il seguente esempio usa la funzione predefinita @code{strftime()}
+(@pxref{Funzioni di tempo})
+per creare una versione @command{awk} di @code{ctime()}:
+
address@hidden @code{ctime()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{ctime()}
address@hidden
address@hidden file eg/lib/ctime.awk
+# ctime.awk
+#
+# versione awk della funzione C ctime(3)
+
+function ctime(ts, format)
address@hidden
+ format = "%a %e %b %Y, %H.%M.%S, %Z"
+
+ if (ts == 0)
+ ts = systime() # usare data e ora correnti per default
+ return strftime(format, ts)
address@hidden
address@hidden endfile
address@hidden example
+
+Si potrebbe pensare che la funzione @code{ctime()} possa usare
address@hidden"strftime"]}
+come stringa di formato. Sarebbe un errore, perch@'e si suppone che
address@hidden()} restituisca data e ora formattati in maniera standard,
+e qualche codice a livello utente potrebbe aver modificato in precedenza
address@hidden"strftime"]}.
+
address@hidden Precisazioni sulle funzioni
address@hidden Chiamare funzioni definite dall'utente
+
address@hidden funzioni definite dall'utente, chiamare
address@hidden chiamare funzioni definite dall'utente
address@hidden una funzione} significa richiedere l'esecuzione di una
+funzione, la quale svolge il compito per cui @`e stata scritta.
+La chiamata di una funzione @`e un'espressione e il suo valore @`e quello
+restituito dalla funzione.
+
address@hidden
+* Chiamare una funzione:: Non usare spazi.
+* Campo di address@hidden variabili:: Variabili locali e globali.
+* Parametri per valore/riferimento:: Passaggio parametri.
address@hidden menu
+
address@hidden Chiamare una funzione
address@hidden Scrivere una chiamata di funzione
+
+Una chiamata di funzione consiste nel nome della funzione seguito dagli
+argomenti racchiusi tra parentesi. Gli argomenti specificati nella chiamata
+sono costituiti da espressioni @command{awk}. Ogni volta che si esegue una
+chiamata queste espressioni vengono ricalcolate, e i loro valori diventano gli
+argomenti passati alla funzione. Per esempio, ecco una chiamata a
address@hidden()} con tre argomenti (il primo dei quali @`e una concatenazione
di
+stringhe):
+
address@hidden
+pippo(x y, "perdere", 4 * z)
address@hidden example
+
address@hidden ATTENZIONE
+Caratteri bianchi (spazi e TAB) non sono permessi tra il nome della funzione e
+la parentesi aperta che apre la lista degli argomenti. Se per errore si
+lasciano dei caratteri bianchi, @command{awk} li interpreterebbe come se
+s'intendesse concatenare una variabile con un'espressione tra parentesi.
+Tuttavia, poich@'e si @`e usato un nome di funzione e non un nome di variabile,
+verrebbe emesso un messaggio di errore.
address@hidden quotation
+
address@hidden Campo di address@hidden variabili
address@hidden Variabili locali e globali.
+
address@hidden variabili locali, in una funzione
address@hidden locali, variabili, per una funzione
+Diversamente da molti altri linguaggi, non c'@`e modo di
+rendere locale una variabile in un blocco @address@hidden @dots{}
@address@hidden di
address@hidden, ma si address@hidden rendere locale una variabile di una
funzione. @`E
+buona norma farlo quando una variabile serve solo all'interno di quella
+particolare funzione.
+
+Per rendere locale una variabile per una funzione, basta dichiarare la
+variabile come argomento della funzione dopo gli argomenti richiesti dalla
+funzione (@pxref{Sintassi delle definizioni}). Si consideri il seguente
+esempio, dove la variabile @code{i} @`e una variabile globale usata sia dalla
+funzione @code{pippo()} che dalla funzione @code{pluto()}:
+
address@hidden
+function pluto()
address@hidden
+ for (i = 0; i < 3; i++)
+ print "in pluto i=" i
address@hidden
+
+function pippo(j)
address@hidden
+ i = j + 1
+ print "in pippo i=" i
+ pluto()
+ print "in pippo i=" i
address@hidden
+
+BEGIN @{
+ i = 10
+ print "in BEGIN i=" i
+ pippo(0)
+ print "in BEGIN i=" i
address@hidden
address@hidden example
+
+L'esecuzione di questo script produce quanto segue, perch@'e la stessa
+variabile @code{i} @`e usata sia nelle
+funzioni @code{pippo()} e @code{pluto()} sia a livello della
+regola @code{BEGIN}:
+
address@hidden
+in BEGIN i=10
+in pippo i=1
+in pluto i=0
+in pluto i=1
+in pluto i=2
+in pippo i=3
+in BEGIN i=3
address@hidden example
+
+Se si vuole che @code{i} sia una variabile locale sia per
address@hidden()} che per @code{pluto()}, occorre procedere in questo modo
+(gli spazi extra prima della @code{i} sono una convenzione di codifica
+che serve a ricordare che @code{i} @`e una variabile locale, non
+un argomento):
+
address@hidden
+function pluto( i)
address@hidden
+ for (i = 0; i < 3; i++)
+ print "in pluto i=" i
address@hidden
+
+function pippo(j, i)
address@hidden
+ i = j + 1
+ print "in pippo i=" i
+ pluto()
+ print "in pippo i=" i
address@hidden
+
+BEGIN @{
+ i = 10
+ print "in BEGIN i=" i
+ pippo(0)
+ print "in BEGIN i=" i
address@hidden
address@hidden example
+
+L'esecuzione della versione corretta dello script produce il seguente
+output:
+
address@hidden
+in BEGIN i=10
+in pippo i=1
+in pluto i=0
+in pluto i=1
+in pluto i=2
+in pippo i=1
+in BEGIN i=10
address@hidden example
+
+Oltre a valori scalari (stringhe e numeri), si possono usare anche
+vettori locali. Usando come parametro il nome di un vettore, @command{awk}
+lo considera come tale, e lo tratta come locale alla funzione.
+Inoltre, chiamate ricorsive creano nuovi vettori.
+Si consideri questo esempio:
+
address@hidden
+function qualche_funz(p1, a)
address@hidden
+ if (p1++ > 3)
+ return
+
+ a[p1] = p1
+
+ qualche_funz(p1)
+
+ printf("Al livello %d, indice %d %s trova in a\n",
+ p1, (p1 - 1), (p1 - 1) in a ? "si" : "non si")
+ printf("Al livello %d, indice %d %s trova in a\n",
+ p1, p1, p1 in a ? "si" : "non si")
+ print ""
address@hidden
+
+BEGIN @{
+ qualche_funz(1)
address@hidden
address@hidden example
+
+Quando viene eseguito, questo programma produce il seguente output:
+
address@hidden
+Al livello 4, indice 3 non si trova in a
+Al livello 4, indice 4 si trova in a
+
+Al livello 3, indice 2 non si trova in a
+Al livello 3, indice 3 si trova in a
+
+Al livello 2, indice 1 non si trova in a
+Al livello 2, indice 2 si trova in a
address@hidden example
+
address@hidden Parametri per valore/riferimento
address@hidden Passare parametri di funzione per valore o per riferimento
+
+In @command{awk}, quando si definisce una funzione, non c'@`e modo di
+dichiarare esplicitamente se gli argomenti sono passati @dfn{per valore}
+o @dfn{per riferimento}.
+
+Invece, il modo con cui i parametri sono passati @`e determinato
+durante l'esecuzione del programma,
+quando la funzione @`e chiamata, nel rispetto della regola seguente:
+se l'argomento @`e una variabile di tipo vettoriale, questa @`e passata
+per riferimento. Altrimenti, l'argomento @`e passato per valore.
+
address@hidden chiamare per valore
+Passare un argomento per valore significa che quando una funzione @`e chiamata,
+le viene fornita una @emph{copia} del valore di quell'argomento. Il chiamante
address@hidden usare una variabile il cui valore calcolato viene passato come
argomento, ma la
+funzione chiamata non la riconosce come variabile; riconosce solo il valore
+assunto dall'argomento. Per esempio, scrivendo il seguente codice:
+
address@hidden
+pippo = "pluto"
+z = mia_funzione(pippo)
address@hidden example
+
address@hidden
+non si deve pensare che l'argomento passato a @code{mia_funzione()} sia ``la
+variabile @code{pippo}.'' Invece, @`e corretto considerare l'argomento come la
+stringa il cui valore @`e @code{"pluto"}.
+Se la funzione @code{mia_funzione()} altera i valori delle sue variabili
+locali, address@hidden non influisce su nessun'altra variabile. Quindi, se
address@hidden()} fa questo:
+
address@hidden
+function mia_funzione(stringa)
address@hidden
+ print stringa
+ stringa = "zzz"
+ print stringa
address@hidden
address@hidden example
+
address@hidden
+cambiando address@hidden@dotless{i}} il valore della variabile che @`e il suo
primo argomento, ossia
address@hidden, il valore di @code{pippo} per il chiamante @emph{non} viene
+modificato. Il ruolo svolto da @code{pippo} nella chiamata di
address@hidden()} termina quando il suo valore (@code{"pluto"}) viene
+calcolato. Se la variabile @code{stringa} esiste anche al di fuori di
address@hidden()}, il corpo della funzione non address@hidden modificare questo
valore
+esterno, perch@'e esso rimane oscurato durante l'esecuzione di
address@hidden()} e non address@hidden quindi essere visto o modificato.
+
address@hidden chiamare per riferimento
address@hidden vettori, come parametri di funzione
address@hidden funzioni, vettori come parametri di
+Tuttavia, quando sono dei vettori a fungere da parametri alle funzioni, questi
address@hidden vengono copiati. Invece, il vettore stesso @`e reso disponibile
per
+essere manipolato direttamente dalla funzione. Questo @`e quel che si dice
+solitamente una @dfn{chiamata per riferimento}. Le modifiche effettuate su un
+vettore passato come parametro all'interno del corpo di una funzione
address@hidden visibili all'esterno della funzione.
+
address@hidden NOTA
+Modificare un vettore passato come parametro all'interno di una funzione
address@hidden essere molto pericoloso se non si sta attenti a quel che si sta
facendo.
+Per esempio:
+
address@hidden
+function cambialo(vettore, ind, nvalore)
address@hidden
+ vettore[ind] = nvalore
address@hidden
+
+BEGIN @{
+ a[1] = 1; a[2] = 2; a[3] = 3
+ cambialo(a, 2, "due")
+ printf "a[1] = %s, a[2] = %s, a[3] = %s\n",
+ a[1], a[2], a[3]
address@hidden
address@hidden example
+
address@hidden
+stampa @samp{a[1] = 1, a[2] = due, a[3] = 3}, perch@'e
address@hidden()} memorizza @code{"due"} nel secondo elemento di @code{a}.
address@hidden quotation
+
address@hidden indefinite, funzioni
address@hidden funzioni indefinite
+Alcune implementazioni di @command{awk} consentono di chiamare una
+funzione che non @`e stata definita.
+Viene solo emesso un messaggio che descrive il problema al momento
+dell'esecuzione, se il programma tenta di chiamare quella funzione.
+Per esempio:
+
address@hidden
+BEGIN @{
+ if (0)
+ pippo()
+ else
+ pluto()
address@hidden
+function pluto() @{ @dots{} @}
+# si noti che `pippo' non @`e definito
address@hidden example
+
address@hidden
+Poich@'e la condizione dell'istruzione @samp{if} non address@hidden mai
verificata
+in questo caso,
+non @`e un problema reale il fatto che
+che @code{pippo()} non sia stato definito. Solitamente, tuttavia,
address@hidden un problema se un programma chiama una funzione indefinita.
+
address@hidden @dfn{lint}, controlli, funzione indefinita
address@hidden controlli @dfn{lint} per funzione indefinita
address@hidden funzione indefinita, controlli @dfn{lint} per
+
+Se si specifica l'opzione @option{--lint}
+(@pxref{Opzioni}),
address@hidden elenca le chiamate a funzioni indefinite.
+
address@hidden address@hidden, istruzione @code{next} in funzioni definite
dall'utente
address@hidden @code{next}, istruzione, in funzioni definite dall'utente
+Alcune implementazione di @command{awk} emettono un messaggio di errore
+se si usa l'istruzione @code{next}
+o @code{nextfile}
+(@pxref{Istruzione next}, e
address@hidden
address@hidden nextfile})
address@hidden ifdocbook
address@hidden
address@hidden nextfile})
address@hidden ifnotdocbook
+all'interno di una funzione definita dall'utente.
address@hidden non ha questa limitazione.
+
address@hidden Istruzione return
address@hidden L'istruzione @code{return}
address@hidden @code{return}, address@hidden in funzioni definite dall'utente
address@hidden istruzione @address@hidden in funzioni definite dall'utente
+
+Come visto in parecchi esempi precedenti,
+il corpo di una funzione definita dall'utente address@hidden contenere
un'istruzione
address@hidden
+Quest'istruzione restituisce il controllo a quella parte del
+del programma @command{awk} che ha effettuato la chiamata.
address@hidden anche essere usata per restituire un valore da usare nel resto
del
+programma @command{awk}.
+Questo @`e un esempio:
+
address@hidden
address@hidden address@hidden
address@hidden display
+
+La parte @var{espressione} @`e facoltativa.
+Probabilmente per una svista, POSIX non definisce qual @`e il valore
+restituito, se si omette @var{espressione}. Tecnicamente parlando, questo
+rende il valore restituito indefinito, e quindi, indeterminato.
+In pratica, tuttavia, tutte le versioni di @command{awk} restituiscono
+semplicemente la stringa nulla, che vale zero se usata
+in un contesto che richiede un numero.
+
+Un'istruzione @code{return} senza una @var{espressione} @`e considerata
presente
+alla fine di ogni definizione di funzione.
+Quindi, se il flusso di esecuzione raggiunge la fine del corpo della
+funzione, tecnicamente la funzione
+restituisce un valore indeterminato.
+In pratica, restituisce la stringa nulla. @command{awk}
address@hidden emette alcun messaggio di avvertimento se si usa
+il valore restituito di una tale funzione.
+
+Talvolta address@hidden capitare di scrivere una funzione per quello che fa,
non per
+quello che restituisce. Una tale funzione corrisponde a una funzione
address@hidden in C, C++, o Java, o a una @code{procedure} in Ada.
+Quindi, address@hidden essere corretto non
+restituire alcun valore; basta fare attenzione a non usare poi il
+valore restituito da una tale funzione.
+
+Quello che segue @`e un esempio di una funzione definita dall'utente
+che restituisce un valore che @`e
+il numero address@hidden alto presente tra gli elementi di un vettore:
+
address@hidden
+function massimo(vettore, i, max)
address@hidden
+ for (i in vettore) @{
+ if (max == "" || vettore[i] > max)
+ max = vettore[i]
+ @}
+ return max
address@hidden
address@hidden example
+
address@hidden programmazione, convenzioni di, parametri di funzione
address@hidden convenzioni di programmazione, parametri di funzione
address@hidden
+La chiamata a @code{massimo()} ha un solo argomento, che @`e il nome di
+un vettore. Le variabili locali @code{i} e @code{max} non vanno intese
+come argomenti; nulla vieta di passare address@hidden di un argomento
+a @code{massimo()} ma i risultati sarebbero strani. Gli spazi extra prima
+di @code{i} nella lista dei parametri della funzione indicano che @code{i} e
address@hidden sono variabili locali.
address@hidden consigliabile seguire questa convenzione quando si definiscono
delle funzioni.
+
+Il programma seguente usa la funzione @code{massimo()}. Carica un vettore,
+richiama @code{massimo()}, e quindi elenca il numero massimo contenuto in
+quel vettore:
+
address@hidden
+function massimo(vettore, i, max)
address@hidden
+ for (i in vettore) @{
+ if (max == "" || vettore[i] > max)
+ max = vettore[i]
+ @}
+ return max
address@hidden
+
+# Carica tutti i campi di ogni record in numeri.
address@hidden
+ for (i = 1; i <= NF; i++)
+ numeri[NR, i] = $i
address@hidden
+
+END @{
+ print massimo(numeri)
address@hidden
address@hidden example
+
+Dato il seguente input:
+
address@hidden
+ 1 5 23 8 16
+44 3 5 2 8 26
+256 291 1396 2962 100
+-6 467 998 1101
+99385 11 0 225
address@hidden example
+
address@hidden
+il programma trova (come si address@hidden immaginare) che 99.385 @`e il
+valore address@hidden alto contenuto nel vettore.
+
address@hidden Variabili di tipo dinamico
address@hidden Funzioni e loro effetti sul tipo di una variabile
+
address@hidden @`e un linguaggio molto fluido.
address@hidden possible che @command{awk} non sia in grado di stabilire se un
+identificativo rappresenta una variabile scalare o un vettore,
+prima dell'effettiva esecuzione di un programma.
+Ecco un esempio di programma commentato:
+
address@hidden
+function pippo(a)
address@hidden
+ a[1] = 1 # il parametro @`e un vettore
address@hidden
+
+BEGIN @{
+ b = 1
+ pippo(b) # non valido: errore fatale, tipi variabile in conflitto
+
+ pippo(x) # x non inizializzato, diventa un vettore dinamicamente
+ x = 1 # a questo punto, non permesso: errore in esecuzione
address@hidden
address@hidden example
+
+In questo esempio, la prima chiamata a @code{pippo()} genera
+un errore fatale, quindi @command{awk} non address@hidden a segnalare il
secondo
+errore. Se si commenta la prima chiamata e si riesegue il
+programma, a quel punto @command{awk} address@hidden con un messaggio
+relativo al secondo errore.
+Solitamente queste cose non causano grossi problemi, ma @`e bene
+esserne a conoscenza.
+
address@hidden Chiamate indirette
address@hidden Chiamate indirette di funzione
+
address@hidden indiretta, chiamata di funzione
address@hidden chiamata indiretta di funzione
address@hidden funzione, puntatori a
address@hidden puntatori a funzioni
address@hidden differenze tra @command{awk} e @command{gawk}, chiamata
indiretta di funzione
+
+Questa sezione descrive un'estensione avanzata, specifica di @command{gawk}.
+
+Spesso address@hidden essere utile ritardare la scelta della funzione da
chiamare
+fino al momento in cui il programma viene eseguito.
+Per esempio, potrebbero esserci diversi tipi di record in input, ciascuno
+dei quali dovrebbe essere elaborato in maniera differente.
+
+Solitamente, si userebbe una serie di istruzioni @address@hidden
+per decidere quale funzione chiamare. Usando la chiamata @dfn{indiretta}
+a una funzione, si address@hidden assegnare il nome della funzione da chiamare
a
+una variabile di tipo stringa, e usarla per chiamare la funzione.
+Vediamo un esempio.
+
+Si supponga di avere un file con i punteggi ottenuti negli esami per i
+corsi che si stanno seguendo, e che si desideri ottenere la somma e la
+media dei punteggi ottenuti.
+Il primo campo @`e il nome del corso. I campi seguenti sono i nomi delle
+funzioni da chiamare per elaborare i dati, fino a un campo ``separatore''
address@hidden:}. Dopo il separatore, fino alla fine del record,
+ci sono i vari risultati numerici di ogni test.
+
+Ecco il file iniziale:
+
address@hidden
address@hidden file eg/data/class_data1
+Biologia_101 somma media dati: 87.0 92.4 78.5 94.9
+Chimica_305 somma media dati: 75.2 98.3 94.7 88.2
+Inglese_401 somma media dati: 100.0 95.6 87.1 93.4
address@hidden endfile
address@hidden example
+
+Per elaborare i dati, si potrebbe iniziare a scrivere:
+
address@hidden
address@hidden
+ corso = $1
+ for (i = 2; $i != "dati:"; i++) @{
+ if ($i == "somma")
+ somma() # elabora l'intero record
+ else if ($i == "media")
+ media()
+ @dots{} # e address@hidden@dotless{i}} via
+ @}
address@hidden
address@hidden example
+
address@hidden
+Questo stile di programmazione funziona, ma address@hidden essere scomodo.
+Con la chiamata @dfn{indiretta} di funzione, si address@hidden richiedere a
@command{gawk}
+di usare il @emph{valore} di una variabile come @emph{nome} della funzione da
+chiamare.
+
address@hidden @code{@@}, notazione per la chiamata indiretta di funzioni
address@hidden chiamata indiretta di funzioni, notazione @code{@@}
+La sintassi @`e simile a quella di una normale chiamata di funzione:
+un identificativo, seguito immediatamente da una parentesi aperta,
+qualche argomento, e una parentesi chiusa, con l'aggiunta di un carattere
address@hidden@@} all'inizio:
+
address@hidden
+quale_funzione = "somma"
+risultato = @@quale_funzione() # chiamata della funzione somma()
address@hidden example
+
+Ecco un intero programma che elabora i dati mostrati sopra,
+usando la chiamata indiretta di funzioni:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# chiamataindiretta.awk --- esempio di chiamata indiretta di funzioni
address@hidden endfile
address@hidden
address@hidden file eg/prog/indirectcall.awk
+#
+# Arnold Robbins, address@hidden, Public Domain
+# January 2009
address@hidden endfile
address@hidden ignore
+
address@hidden file eg/prog/indirectcall.awk
+# media --- calcola la media dei valori dei campi $primo - $ultimo
+
+function media(primo, ultimo, somma, i)
address@hidden
+ somma = 0;
+ for (i = primo; i <= ultimo; i++)
+ somma += $i
+
+ return somma / (ultimo - primo + 1)
address@hidden
+
+# somma --- restituisce la somma dei valori dei campi $primo - $ultimo
+
+function somma(primo, ultimo, totale, i)
address@hidden
+ max = 0;
+ for (i = primo; i <= ultimo; i++)
+ totale += $i
+
+ return totale
address@hidden
address@hidden endfile
address@hidden example
+
+Queste due funzioni presuppongono che si lavori con dei campi; quindi,
+i parametri @code{primo} e @code{ultimo} indicano da quale campo iniziare
+e fino a quale arrivare.
+Per il resto, eseguono i calcoli richiesti, che sono i soliti:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# Per ogni record,
+# stampa il nome del corso e le statistiche richieste
address@hidden
+ nome_corso = $1
+ gsub(/_/, " ", nome_corso) # Rimpiazza _ con spazi
+
+ # trova campo da cui iniziare
+ for (i = 1; i <= NF; i++) @{
+ if ($i == "dati:") @{
+ inizio = i + 1
+ break
+ @}
+ @}
+
+ printf("%s:\n", nome_corso)
+ for (i = 2; $i != "dati:"; i++) @{
+ quale_funzione = $i
+ printf("\t%s: <%s>\n", $i, @@quale_funzione(inizio, NF) "")
+ @}
+ print ""
address@hidden
address@hidden endfile
address@hidden example
+
+Questo @`e il ciclo principale eseguito per ogni record.
+Stampa il nome del corso (con le
+lineette basse sostituite da spazi). Trova poi l'inizio dei dati veri
+e propri, salvandolo in @code{inizio}.
+L'ultima parte del codice esegue un ciclo per ogni nome di funzione
+(da @code{$2} fino al separatore, @samp{dati:}), chiamando la funzione
+il cui nome @`e specificato nel campo. La chiamata di funzione indiretta
+compare come parametro nella chiamata a @code{printf}.
+(La stringa di formattazione di @code{printf} usa @samp{%s} come
+specificatore di formato, affinch@'e sia possibile usare funzioni
+che restituiscano sia stringhe che numeri. Si noti che il risultato
+della chiamata indiretta @`e concatenato con la stringa nulla, in modo da
+farlo considerare un valore di tipo stringa).
+
+Ecco il risultato dell'esecuzione del programma:
+
address@hidden
+$ @kbd{gawk -f chiamataindiretta.awk dati_dei_corsi}
address@hidden Biologia 101:
address@hidden somma: <352.8>
address@hidden media: <88.2>
address@hidden
address@hidden Chimica 305:
address@hidden somma: <356.4>
address@hidden media: <89.1>
address@hidden
address@hidden Inglese 401:
address@hidden somma: <376.1>
address@hidden media: <94.025>
address@hidden example
+
+La address@hidden di usare la chiamata indiretta di funzioni @`e
address@hidden potente
+di quel che si possa pensare inizialmente.
+I linguaggi C e C++ forniscono ``puntatori di funzione'' che
+sono un metodo per chiamare una funzione scelta al momento dell'esecuzione.
+Uno dei address@hidden noti usi di questa address@hidden @`e
+la funzione C @code{qsort()}, che ordina un vettore usando il famoso
+algoritmo noto come ``quicksort''
+(si veda @uref{http://en.wikipedia.org/wiki/Quicksort, l'articolo di Wikipedia}
+per ulteriori informazioni). Per usare questa funzione, si specifica un
+puntatore a una funzione di confronto. Questo meccanismo consente
+di ordinare dei dati arbitrari in una maniera arbitraria.
+
+Si address@hidden fare qualcosa di simile usando @command{gawk},
address@hidden@dotless{i}}:
+
address@hidden
address@hidden file eg/lib/quicksort.awk
+# quicksort.awk --- Algoritmo di quicksort, con funzione di confronto
+# fornita dall'utente
address@hidden endfile
address@hidden
address@hidden file eg/lib/quicksort.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# January 2009
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/quicksort.awk
+
+# quicksort --- Algoritmo di quicksort di C.A.R. Hoare.
+# Si veda Wikipedia o quasi ogni libro
+# che tratta di algoritmi o di informatica.
address@hidden endfile
address@hidden
address@hidden file eg/lib/quicksort.awk
+#
+# Adattato da B.W. Kernighan & D.M. Ritchie
+# The C Programming Language
+# (Englewood Cliffs, NJ: Prentice Hall, 1988)
+# Seconda Edizione, pagina 110
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/quicksort.awk
+
+function quicksort(dati, sinistra, destra, minore_di, i, ultimo)
address@hidden
+ if (sinistra >= destra) # non fa nulla se il vettore contiene
+ return # meno di due elementi
+
+ quicksort_scambia(dati, sinistra, int((sinistra + destra) / 2))
+ ultimo = sinistra
+ for (i = sinistra + 1; i <= destra; i++)
+ if (@@minore_di(dati[i], dati[sinistra]))
+ quicksort_scambia(dati, ++ultimo, i)
+ quicksort_scambia(dati, sinistra, ultimo)
+ quicksort(dati, sinistra, ultimo - 1, minore_di)
+ quicksort(dati, ultimo + 1, destra, minore_di)
address@hidden
+
+# quicksort_scambia --- funzione ausiliaria per quicksort,
+# sarebbe meglio fosse nel programma principale
+
+function quicksort_scambia(dati, i, j, salva)
address@hidden
+ salva = dati[i]
+ dati[i] = dati[j]
+ dati[j] = salva
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{quicksort()} riceve il vettore @code{dati}, gli
+indici iniziali e finali da ordinare
+(@code{sinistra} e @code{destra}), e il nome di una funzione che
+esegue un confronto ``minore di''. Viene quindi eseguito
+l'algoritmo di quicksort.
+
+Per fare uso della funzione di ordinamento, torniamo all'esempio
+precedente. La prima cosa da fare @`e di scrivere qualche funzione
+di confronto:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# num_min --- confronto numerico per minore di
+
+function num_min(sinistra, destra)
address@hidden
+ return ((sinistra + 0) < (destra + 0))
address@hidden
+
+# num_magg_o_ug --- confronto numerico per maggiore o uguale
+
+function num_magg_o_ug(sinistra, destra)
address@hidden
+ return ((sinistra + 0) >= (destra + 0))
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{num_magg_o_ug()} serve per ottenere un ordinamento
+decrescente (dal numero address@hidden alto al address@hidden basso); quando
@`e usato
+per eseguire un test per ``minore di'', in address@hidden fa l'opposto
+(maggiore o uguale a), il che conduce a ottenere dati ordinati
+in ordine decrescente.
+
+Poi serve una funzione di ordinamento.
+Come parametri ha i numeri del campo iniziale e di quello finale,
+e il nome della funzione di confronto.
+Costruisce un vettore con
+i dati e richiama appropriatamente @code{quicksort()}; quindi formatta i
+risultati mettendoli in un'unica stringa:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# ordina --- ordina i dati a seconda di `confronta'
+# e li restituisce come un'unica stringa
+
+function ordina(primo, ultimo, confronta, dati, i, risultato)
address@hidden
+ delete dati
+ for (i = 1; primo <= ultimo; primo++) @{
+ dati[i] = $primo
+ i++
+ @}
+
+ quicksort(dati, 1, i-1, confronta)
+
+ risultato = dati[1]
+ for (i = 2; i in dati; i++)
+ risultato = risultato " " dati[i]
+
+ return risultato
address@hidden
address@hidden endfile
address@hidden example
+
+Per finire, le due funzioni di ordinamento chiamano la funzione
address@hidden()}, passandole i nomi delle due funzioni di confronto:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# ascendente --- ordina i dati in ordine crescente
+# e li restituisce sotto forma di stringa
+
+function ascendente(primo, ultimo)
address@hidden
+ return ordina(primo, ultimo, "num_min")
address@hidden
+
+# discendente --- ordina i dati in ordine decrescente
+# e li restituisce sotto forma di stringa
+
+function discendente(primo, ultimo)
address@hidden
+ return ordina(primo, ultimo, "num_magg_o_ug")
address@hidden
address@hidden endfile
address@hidden example
+
+Ecco una versione estesa del @value{DF}:
+
address@hidden
address@hidden file eg/data/class_data2
+Biologia_101 somma media ordina discendente dati: 87.0 92.4 78.5 94.9
+Chimica_305 somma media ordina discendente dati: 75.2 98.3 94.7 88.2
+Inglese_401 somma media ordina discendente dati: 100.0 95.6 87.1 93.4
address@hidden endfile
address@hidden example
+
+Per finire, questi sono i risultati quando si esegue il programma
+in questa versione migliorata:
+
address@hidden
+$ @kbd{gawk -f quicksort.awk -f indirettacall.awk class_data2}
address@hidden Biologia 101:
address@hidden somma: <352.8>
address@hidden media: <88.2>
address@hidden ascendente: <78.5 87.0 92.4 94.9>
address@hidden discendente: <94.9 92.4 87.0 78.5>
address@hidden
address@hidden Chimica 305:
address@hidden somma: <356.4>
address@hidden media: <89.1>
address@hidden ascendente: <75.2 88.2 94.7 98.3>
address@hidden discendente: <98.3 94.7 88.2 75.2>
address@hidden
address@hidden Inglese 401:
address@hidden somma: <376.1>
address@hidden media: <94.025>
address@hidden ascendente: <87.1 93.4 95.6 100.0>
address@hidden discendente: <100.0 95.6 93.4 87.1>
address@hidden example
+
+Un altro esempio in cui le chiamate indirette di funzione sono utili
address@hidden costituito dall'elaborazione di vettori. La descrizione si
address@hidden trovare
address@hidden vettori}.
+
+Occorre ricordarsi di anteporre il carattere @samp{@@} prima di una
+chiamata indiretta di funzione.
+
+A partire dalla @value{PVERSION} 4.1.2 di @command{gawk}, le chiamate
+indirette di funzione
+possono anche essere usate per chiamare funzioni predefinite e con
+funzioni di estensione
+(@pxref{Estensioni dinamiche}). Ci sono alcune limitazioni nel richiamare
+in maniera indiretta delle funzioni predefinite, come qui dettagliato:
+
address@hidden @value{BULLET}
address@hidden
+Non si address@hidden passare una costante @dfn{regexp} a una funzione
predefinita
+effettuando una chiamata di funzione address@hidden
+limitazione potrebbe cambiare in una futura versione;
+per appurarlo, si controlli la documentazione che accompagna
+la versione in uso di @command{gawk}.}
+Quanto sopra vale per le funzioni
address@hidden()}, @code{gsub()}, @code{gensub()}, @code{match()},
address@hidden()} e @code{patsplit()}.
+
address@hidden
+Nel chiamare @code{sub()} o @code{gsub()}, sono accettati solo due argomenti,
+poich@'e queste funzioni sono atipiche, in quanto aggiornano il loro terzo
+argomento. Questo significa che address@hidden sempre aggiornato l'argomento
di
+default, @code{$0}.
address@hidden itemize
+
address@hidden fa del suo meglio per rendere efficiente la chiamata indiretta
+di funzioni. Per esempio, nel ciclo seguente:
+
address@hidden
+for (i = 1; i <= n; i++)
+ @@quale_funzione()
address@hidden example
+
address@hidden
address@hidden ricerca solo una volta quale funzione chiamare.
+
address@hidden Sommario delle funzioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
address@hidden include delle funzioni predefinite e consente all'utente
+di definire le sue proprie funzioni.
+
address@hidden
+POSIX @command{awk} include tre tipi di funzioni predefinite: numeriche, di
+stringa, e di I/O. @command{gawk} prevede funzioni per ordinare vettori, per
+lavorare con valori che rappresentano marcature temporali,
+per la manipolazione di bit,
+per determinare il tipo di una variabile (vettoriale piuttosto che scalare), e
+programmi per l'internazionalizzazione e la localizzazione. @command{gawk}
+prevede anche parecchie estensioni ad alcune funzioni standard, tipicamente
+nella forma di ulteriori argomenti.
+
address@hidden
+Le funzioni accettano zero o address@hidden argomenti e restituiscono un
valore. Le
+espressioni che specificano il valore di ogni argomento sono valutate
+completamente prima della chiamata
+a una funzione. L'ordine di valutazione di questi argomenti non @`e definito.
+Il valore restituito dalla funzione address@hidden essere ignorato.
+
address@hidden
+La gestione delle barre inverse in @code{sub()} e @code{gsub()} non @`e
+semplice.
address@hidden address@hidden semplice nella funzione di @command{gawk}
@code{gensub()},
+ma anche questa funzione richiede attenzione quando la si usa.
+
address@hidden
+Le funzioni definite dall'utente consentono importanti address@hidden ma hanno
+anche alcune ineleganze sintattiche. In una chiamata di funzione non si
address@hidden
+inserire alcuno spazio tra il nome della funzione e la parentesi sinistra
+aperta che inizia la lista degli argomenti. Inoltre, non c'@`e nessuna
+prescrizione per le variabili locali, e per questo la
+convenzione in uso @`e di aggiungere parametri extra, e di separarli
visivamente
+dai parametri veri e propri inserendo degli spazi bianchi prima di essi.
+
address@hidden
+Le funzioni definite dall'utente possono chiamare altre
+funzioni definite dall'utente (oltre a quelle predefinite)
+e possono chiamare se stesse ricorsivamente. I parametri di funzione
+``nascondono'' qualsiasi variabile globale che abbia lo stesso nome.
+Non si address@hidden usare il nome di una variabile riservata (p.es.
@code{ARGC})
+come nome di un parametro in funzioni definite dall'utente.
+
address@hidden
+I valori scalari sono passati alle funzioni definite dall'utente
+per valore. I parametri che sono dei vettori sono passati alle funzioni
+per riferimento; ogni modifica fatta dalla funzione a un parametro che
+sia un vettore @`e quindi visibile dopo aver eseguito quella funzione.
+
address@hidden
+L'istruzione @code{return} serve per tornare indietro da una funzione definita
+dall'utente. Un'espressione opzionale diviene il valore restituito dalla
+funzione. Una funzione address@hidden solo restituire valori di tipo scalare.
+
address@hidden
+Se una variabile che non @`e stata mai usata @`e passata a una funzione
+definita dall'utente, il modo con cui quella funzione elabora la variabile
+ne address@hidden determinare il tipo: o scalare o vettoriale.
+
address@hidden
address@hidden consente la chiamata indiretta di funzioni usando una sintassi
+speciale. Impostando una variabile al nome di una funzione, si address@hidden
+determinare al momento dell'esecuzione che funzione address@hidden chiamata in
un certo
+punto del programma. Questo equivale a usare un puntatore a una funzione nei
+linguaggi C e C++.
+
address@hidden itemize
+
+
address@hidden
address@hidden @value{PART2}Risoluzione di problemi con @command{awk}
address@hidden ifnotinfo
+
address@hidden
+La Parte II mostra come usare @command{awk} e @command{gawk} per risolvere
+problemi. Qui c'@`e il codice di molti programmi, da leggere e da cui si
address@hidden
+imparare. @`E composta dai seguenti capitoli:
+
address@hidden @value{BULLET}
address@hidden
address@hidden di libreria}
+
address@hidden
address@hidden di esempio}
address@hidden itemize
address@hidden ifdocbook
+
address@hidden Funzioni di libreria
address@hidden Una libreria di funzioni @command{awk}
address@hidden libreria di funzioni @command{awk}
address@hidden funzioni di libreria
address@hidden funzioni definite dall'utente, libreria di
+
address@hidden
+La
address@hidden iftex
address@hidden definite dall'utente} descrive come scrivere le proprie
+funzioni @command{awk} personali. Scrivere funzioni @`e importante, perch@'e
+consente di incapsulare in un unico contenitore algoritmi e azioni di
+programma. Semplifica la programmazione, rendendo lo sviluppo di un programma
address@hidden gestibile, e rendendo i programmi address@hidden leggibili.
+
address@hidden Kernighan, Brian
address@hidden Plauger, P.J.@:
+Nel loro autorevole libro del 1976,
address@hidden Tools},@footnote{Purtroppo, a distanza di oltre 35 anni,
+molte delle
+lezioni impartite da questo libro devono ancora essere apprese da un gran
+numero di programmatori professionisti.}
+Brian Kernighan e P.J.@: Plauger hanno scritto:
+
address@hidden
+A programmare bene non s'impara dai concetti generali, ma vedendo come
+programmi complessi possono essere resi puliti, facili da leggere,
+facili da manutenere e modificare,
+strutturati in modo comprensibile, efficienti e affidabili,
+applicando il buon senso e delle buone pratiche di programmazione.
+Lo studio attento e l'imitazione di buoni programmi conduce a una migliore
+scrittura.
address@hidden quotation
+
+In effetti, loro reputavano quest'idea tanto importante da mettere questa
+frase sulla copertina del libro. Poich@'e credo fermamente che la loro
+affermazione sia corretta, questo @value{CHAPTER} e
address@hidden
+il
address@hidden iftex
address@hidden di esempio}
+forniscono una corposa raccolta di codice da leggere e, si spera, da cui
+imparare.
+
+Questo @value{CHAPTER} illustra una libreria di utili funzioni @command{awk}.
+Molti dei programmi descritti nel seguito di questo @value{DOCUMENT}
+usano queste funzioni.
+Le funzioni sono illustrate progressivamente, dalla address@hidden semplice
alla address@hidden
+complessa.
+
address@hidden Texinfo
address@hidden
+La
address@hidden iftex
address@hidden extract}
+illustra un programma che si address@hidden usare per estrarre il codice
sorgente
+degli esempi di funzioni di libreria e di programmi dal sorgente Texinfo
+di questo @value{DOCUMENT}.
+(Questo @`e address@hidden stato fatto durante la preparazione della
distribuzione
+di @command{gawk}.)
+
address@hidden FOR_PRINT
+Chi avesse scritto una o address@hidden funzioni @command{awk} utili e di uso
+generale, e volesse metterle a disposizione della address@hidden degli utenti
di
address@hidden, address@hidden leggere le informazioni contenute in
address@hidden contribuire}.
address@hidden ifclear
+
address@hidden address@hidden, programmi di esempio
+I programmi contenuti in questo @value{CHAPTER} e in
address@hidden di esempio},
+utilizzano anche le address@hidden specifiche di @command{gawk}.
+Riscrivere questi programmi per implementazioni di @command{awk} diverse
address@hidden piuttosto semplice:
+
address@hidden @value{BULLET}
address@hidden
+I messaggi di errore diagnostici sono inviati a @file{/dev/stderr}.
+Usare @samp{| "cat 1>&2"} al posto di @samp{> "/dev/stderr"} se il sistema
+in uso non ha un @file{/dev/stderr}, o se non @`e possibile usare
address@hidden
+
address@hidden
+Alcuni programmi usano @code{nextfile}
+(@pxref{Istruzione nextfile})
+per evitare di leggere gli input ancora non letti dal file in input corrente.
+
address@hidden
address@hidden 12/2000: Thanks to Nelson Beebe for pointing out the output
issue.
address@hidden distinzione maiuscolo/minuscolo, programmi di esempio
address@hidden @code{IGNORECASE}, variabile, nei programmi di esempio
address@hidden variabile @code{IGNORECASE}, nei programmi di esempio
+Infine, alcuni dei programmi scelgono di ignorare la distinzione tra maiuscolo
e
+minuscolo nei loro input, assegnando il valore uno a @code{IGNORECASE}.
+Si address@hidden ottenere quasi lo stesso address@hidden risultati non sono
identici.
+L'output del record trasformato address@hidden tutto in minuscolo, mentre
address@hidden preserva il contenuto originale del record in input.}
+aggiungendo la seguente regola
+all'inizio del programma:
+
address@hidden
+# ignora maiuscolo/minuscolo
address@hidden $0 = tolower($0) @}
address@hidden example
+
address@hidden
+Inoltre, si verifichi che tutte le @dfn{regexp} e le costanti
+di tipo stringa usate nei confronti utilizzano solo lettere minuscole.
address@hidden itemize
+
address@hidden
+* Nomi di variabili di libreria:: Che nomi @`e meglio dare alle variabili
+ private globali nelle funzioni di libreria.
+* Funzioni di tipo generale:: Funzioni di uso generale.
+* Gestione File Dati:: Funzioni per gestire file-dati specificati
+ sulla riga di comando.
+* Funzione getopt:: Una funzione per trattare argomenti presenti
+ sulla riga di comando.
+* Funzioni Passwd:: Funzioni per ottenete informazioni
+ sull'utente [da /etc/passwd].
+* Funzioni Group:: Funzioni per ottenete informazioni
+ sul gruppo [da /etc/group].
+* Visitare vettori:: Una funzione per visitare vettori di vettori.
+* Sommario funzioni di libreria:: Sommario funzioni di libreria
+* Esercizi con le librerie:: Esercizi.
address@hidden menu
+
address@hidden Nomi di variabili di libreria
address@hidden Dare un nome a variabili globali in funzioni di libreria
+
address@hidden nomi di vettore/variabile
address@hidden nomi di funzione
address@hidden questioni sui nomi permessi
address@hidden nomi permessi, questioni sui
address@hidden programmi @command{awk}, documentazione
address@hidden documentazione, di programmi @command{awk}
+Per come si @`e sviluppato il linguaggio @command{awk}, le variabili sono
+o @dfn{globali} (usabili dall'intero programma) o @dfn{locali} (usabili solo
+in una specifica funzione). Non c'@`e uno stato intermedio analogo alle
+variabili @code{statiche} in C.
+
address@hidden variabili globali, per funzioni di libreria
address@hidden globali, variabili, per funzioni di libreria
address@hidden private, variabili
address@hidden variabili private
+Le funzioni di libreria hanno spesso address@hidden di avere variabili globali
da
+usare per conservare informazioni di stato tra successive chiamate alla
+funzione; per esempio, la variabile di @code{getopt()} @code{_opti}
+(@pxref{Funzione getopt}).
+Tali variabili vengono dette @dfn{private}, poich@'e le sole funzioni che
+devono usarle sono quelle della libreria.
+
+Quando si scrive una funzione di libreria, si dovrebbe cercare di scegliere per
+le variabili private dei nomi che non entrano in conflitto con nessuna delle
+variabili usate da un'altra funzione di libreria o dal programma principale di
+un utente. Per esempio, un nome come @code{i} o @code{j} non @`e una buona
+scelta, perch@'e i programmi a livello utente usano spesso nomi di variabile
come
+questi per le proprie elaborazioni.
+
address@hidden convenzioni di programmazione, nomi di variabili private
address@hidden programmazione, convenzioni di, nomi di variabili private
+I programmi di esempio mostrati in questo @value{CHAPTER} usano per le
+loro variabili private nomi che iniziano con un trattino basso(@samp{_}).
+Generalmente gli utenti
+non usano trattini bassi iniziali nei nomi di variabile,
address@hidden@dotless{i}} questa convenzione
+riduce le address@hidden che il nome di variabile coincida con un nome usato
+nel programma dell'utente.
+
address@hidden @code{_} (trattino basso), nei nomi di variabili private
address@hidden trattino basso (@code{_}), nei nomi di variabili private
+Inoltre, parecchie funzioni di libreria usano un prefisso che suggerisce
+quale funzione o gruppo di funzioni usa quelle variabili; per esempio,
address@hidden()} nelle routine che consultano la lista degli utenti
+(@pxref{Funzioni Passwd}).
+L'uso di questa convenzione viene raccomandata, poich@'e riduce ulteriormente
la
address@hidden di conflitti accidentali tra nomi di variabile. Si noti che
questa
+convenzione address@hidden anche essere usata per i nomi di variabile e per i
nomi delle
+funzioni address@hidden tutte le routine di libreria si sarebbero
+potute riscrivere usando questa convenzione, address@hidden non @`e stato
fatto, per far
+vedere come lo stile di programmazione in @command{awk} si @`e evoluto e
+per fornire alcuni spunti per questa spiegazione.}
+
+Come nota finale sui nomi delle variabili, se una funzione rende
+disponibile una variabile globale per essere usata da un programma principale,
address@hidden una buona convenzione quella di far iniziare i nomi di queste
variabili con
+una lettera maiuscola; per esempio, @code{Opterr} e @code{Optind} di
address@hidden()}
+(@pxref{Funzione getopt}).
+La lettera maiuscola iniziale indica che la variabile @`e globale,
+mentre il fatto che
+il nome della variabile non @`e tutto in lettere maiuscole indica che la
variabile
+non @`e una delle variabili predefinite di @command{awk}, come @code{FS}.
+
address@hidden @option{--dump-variables}, opzione, uso per funzioni di libreria
address@hidden opzione @option{--dump-variables}, uso per funzioni di libreria
address@hidden importante anche che @emph{tutte} le variabili nelle funzioni di
libreria
+che non abbiano la address@hidden di essere
+conservate per tutta la durata del
+programma siano, di fatto, dichiarate
+come address@hidden'opzione da riga di comando di @command{gawk}
address@hidden @`e utile per verificare questo.} Se address@hidden non viene
+fatto, la variabile potrebbe essere usata accidentalmente nel programma
+dell'utente, conducendo a errori che sono molto difficili da scoprire:
+
address@hidden
+function lib_func(x, y, l1, l2)
address@hidden
+ @dots{}
+ # qualche_var dovrebbe essere locale ma per una svista non lo @`e
+ @var{uso della variabile} qualche_var
+ @dots{}
address@hidden
address@hidden example
+
address@hidden vettori associativi, funzioni di libreria e
address@hidden libreria di funzioni @command{awk}, vettori associativi e
address@hidden funzioni, libreria di, vettori associativi e
address@hidden Tcl
+Una differente convenzione, comune nella address@hidden Tcl, @`e quella di
usare un
+solo vettore associativo che contiene i valori necessari alle funzioni di
+libreria, o ``package.'' Questo riduce significativamente il numero degli
+effettivi nomi globali in uso. Per esempio, le funzioni descritte in
address@hidden Passwd}
+potrebbero aver usato gli elementi di vettore
address@hidden@w{PW_data["inizializzato"]}},
address@hidden@w{PW_data["totale"]}}, @address@hidden"contatore"]}}, e
address@hidden@w{PW_data["awklib"]}}, al posto di @address@hidden,
address@hidden@w{_pw_totale}},
address@hidden@w{_pw_awklib}} e
address@hidden@w{_pw_contatore}}.
+
+Le convenzioni illustrate in questa @value{SECTION} sono esattamente
+quello che indica il termine: convenzioni. Non si @`e obbligati a scrivere
+i propri programmi in questo modo: @`e solo auspicabile che lo si faccia.
+
address@hidden Funzioni di tipo generale
address@hidden Programmazione di tipo generale
+
+Questa @value{SECTION} illustra diverse funzioni che sono di uso generale nella
+programmazione.
+
address@hidden
+* Funzione strtonum:: Da usare se non @`e disponibile la funzione
+ predefinita @code{strtonum()}.
+* Funzione assert:: Una funzione per controllare affermazioni
+ in programmi @command{awk}.
+* Funzione round:: Una funzione per eseguire arrotondamenti
+ se @code{sprintf()} non lo fa correttamente.
+* Funzione random Cliff:: Il generatore Cliff di numeri casuali.
+* Funzioni ordinali:: Funzioni per usare caratteri come numeri
+ e viceversa.
+* Funzione join:: Una funzione per fondere un vettore
+ in una stringa.
+* Funzione getlocaltime:: Una funzione per ottenere data e ora nel
+ formato desiderato.
+* Funzione readfile:: Una funzione per leggere un file intero in
+ un colpo solo.
+* Apici alla shell:: Una funzione per passare stringhe
+ con apici alla shell.
address@hidden menu
+
address@hidden Funzione strtonum
address@hidden Conversione di stringhe in numeri
+
+La funzione @code{strtonum()} (@pxref{Funzioni per stringhe})
address@hidden un'estensione @command{gawk}. La seguente funzione
+fornisce un'implementazione per altre versioni di @command{awk}:
+
address@hidden
address@hidden file eg/lib/strtonum.awk
+# mystrtonum --- converte stringhe in numeri
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/strtonum.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# February, 2004
+# Revised June, 2014
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/strtonum.awk
+function mystrtonum(str, ret, n, i, k, c)
address@hidden
+ if (str ~ /^0[0-7]*$/) @{
+ # ottale
+ n = length(str)
+ ret = 0
+ for (i = 1; i <= n; i++) @{
+ c = substr(str, i, 1)
+ # index() restituisce 0 se c non @`e nella stringa,
+ # e anche se c == "0"
+ k = index("1234567", c)
+
+ ret = ret * 8 + k
+ @}
+ @} else if (str ~ /^0[xX][[:xdigit:]]+$/) @{
+ # esadecimale
+ str = substr(str, 3) # via 0x iniziale
+ n = length(str)
+ ret = 0
+ for (i = 1; i <= n; i++) @{
+ c = substr(str, i, 1)
+ c = tolower(c)
+ # index() restituisce 0 se c non @`e nella stringa,
+ # e anche se c == "0"
+ k = index("123456789abcdef", c)
+
+ ret = ret * 16 + k
+ @}
+ @} else if (str ~ \
+ /^[-+]?([0-9]+([.][0-9]*([Ee][0-9]+)?)?|([.][0-9]+([Ee][-+]?[0-9]+)?))$/) @{
+ # numero decimale, eventualmente in virgola mobile
+ ret = str + 0
+ @} else
+ ret = "NON-UN-NUMERO"
+
+ return ret
address@hidden
+
+# BEGIN @{ # dati per un test
+# a[1] = "25"
+# a[2] = ".31"
+# a[3] = "0123"
+# a[4] = "0xdeadBEEF"
+# a[5] = "123.45"
+# a[6] = "1.e3"
+# a[7] = "1.32"
+# a[8] = "1.32E2"
+#
+# for (i = 1; i in a; i++)
+# print a[i], strtonum(a[i]), mystrtonum(a[i])
+# @}
address@hidden endfile
address@hidden example
+
+La funzione cerca dapprima numeri ottali in stile C (base 8).
+Se la stringa in input corrisponde all'espressione regolare che descrive i
+numeri ottali, @code{mystrtonum()} esegue il ciclo per ogni carattere presente
+nella stringa. Imposta @code{k} all'indice in @code{"1234567"} della cifra
+ottale corrente.
+Il valore di ritorno address@hidden lo stesso numero della cifra, o zero
+se il carattere non c'@`e, il che address@hidden per ogni cifra @samp{0}.
+Questo si address@hidden fare, perch@'e il test di @dfn{regexp}
nell'istruzione @code{if}
+assicura che vengano scelti per
+essere convertiti solo dei numeri ottali.
+
+Una logica simile si applica al codice che ricerca e converte un
+valore esadecimale, che inizia con @samp{0x} o @samp{0X}.
+L'uso di @code{tolower()} semplifica il calcolo per trovare
+il valore numerico corretto per ogni cifra esadecimale.
+
+Infine, se la stringa corrisponde alla (piuttosto complicata) @dfn{regexp} per
+un intero decimale regolare o per un numero in virgola mobile, il calcolo
address@hidden = str + 0} fa address@hidden@dotless{i}} che @command{awk}
converta il valore in un
+numero.
+
address@hidden incluso un programma di verifica commentato, in modo che la
funzione possa
+essere verificata con @command{gawk} e il risultato confrontato con la funzione
+predefinita @code{strtonum()}.
+
address@hidden Funzione assert
address@hidden Asserzioni
+
address@hidden asserzioni
address@hidden @code{assert()}, funzione (libreria C)
address@hidden funzione @code{assert()} (libreria C)
address@hidden libreria di funzioni @command{awk}, asserzioni
address@hidden funzioni, libreria di, asserzioni
address@hidden @command{awk}, asserzioni in programmi lunghi
+Quando si scrivono grossi programmi, spesso @`e utile sapere se
+una condizione o una serie di condizioni @`e verificata oppure no.
+Prima di procedere
+con un determinato calcolo, si fa un'affermazione su cosa si crede sia
+vero. Tale affermazione @`e nota come
address@hidden Il linguaggio C fornisce un file di intestazione
address@hidden<assert.h>} e una corrispondente macro @code{assert()} che un
+programmatore address@hidden utilizzare per fare asserzioni.
+Se l'asserzione risulta falsa, la macro @code{assert()} predispone la
+stampa di un messaggio diagnostico che descrive la condizione che
+sarebbe dovuta essere vera ma che non lo era, e poi fa terminare
+il programma.
+In C, l'uso di @code{assert()} @`e simile a questo:
+
address@hidden
+#include <assert.h>
+
+int myfunc(int a, double b)
address@hidden
+ assert(a <= 5 && b >= 17.1);
+ @dots{}
address@hidden
address@hidden example
+
+Se l'asserzione @`e falsa, il programma stampa un messaggio simile a questo:
+
address@hidden
+prog.c:5: asserzione falsa: `a <= 5 && b >= 17.1'
address@hidden example
+
address@hidden @code{assert()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{assert()}
+Il linguaggio C rende possibile trasformare questa condizione in una stringa
+da
+usare per stampare il messaggio di diagnosi. address@hidden in @command{awk}
non @`e
+possibile, per cui la funzione @code{assert()} scritta in @command{awk}
+richiede anche una descrizione
+della condizione da verificare, in formato stringa.
+La funzione @`e la seguente:
+
address@hidden
address@hidden file eg/lib/assert.awk
+# assert --- Verifica una condizione. Se questa @`e falsa esce.
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/assert.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May, 1993
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/assert.awk
+function assert(condizione, stringa)
address@hidden
+ if (! condizione) @{
+ printf("%s:%d: asserzione falsa: %s\n",
+ FILENAME, FNR, stringa) > "/dev/stderr"
+ _assert_exit = 1
+ exit 1
+ @}
address@hidden
+
address@hidden
+END @{
+ if (_assert_exit)
+ exit 1
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+La funzione @code{assert()} verifica il parametro @code{condizione}. Se
address@hidden falso, stampa un messaggio sullo standard error, usando il
parametro
address@hidden per descrivere la condizione non verificata. Poi imposta la
+variabile @code{_assert_exit} a uno ed esegue l'istruzione @code{exit}.
+L'istruzione @code{exit} salta alla regola @code{END}. Se la regola @code{END}
+trova vera la variabile @code{_assert_exit}, esce immediatamente.
+
+Lo scopo della verifica nella regola @code{END} @`e quello di evitare che venga
+eseguita qualsiasi altra eventuale regola @code{END}.
+Quando un'asserzione non @`e
+verificata, il programma dovrebbe uscire immediatamente.
+Se nessuna asserzione
+fallisce, @code{_assert_exit} @`e ancora falso quando la regola @code{END} @`e
+eseguita normalmente, e le eventuali altre regole @code{END} del programma
+vengono eseguite.
+Affinch@'e tutto questo funzioni correttamente, @file{assert.awk} dev'essere il
+primo file sorgente che viene letto da @command{awk}.
+La funzione address@hidden essere usata in un programma nel seguente modo:
+
address@hidden
+function miafunz(a, b)
address@hidden
+ assert(a <= 5 && b >= 17.1, "a <= 5 && b >= 17.1")
+ @dots{}
address@hidden
address@hidden example
+
address@hidden
+Se l'asserzione non @`e verificata, si address@hidden un messaggio simile a
questo:
+
address@hidden
+mydata:1357: asserzione falsa: a <= 5 && b >= 17.1
address@hidden example
+
address@hidden @code{END}, criterio di ricerca, funzione definita dall'utente
@code{assert()} e
address@hidden criterio di ricerca @code{END}, funzione definita dall'utente
@code{assert()} e
+C'@`e un piccolo problema con questa versione di @code{assert()}.
+Come visto, una regola @code{END} viene automaticamente aggiunta al programma
+che chiama @code{assert()}. Normalmente, se un programma consiste
+solo di una regola @code{BEGIN}, i file in input e/o lo standard input non
+vengono letti. Tuttavia, ora che il programma ha una regola @code{END},
address@hidden tenta di leggere i @value{DF} in input o lo standard input
+(@pxref{Usare BEGIN/END}), provocando molto probabilmente la sospensione del
+programma come se rimanesse in attesa di input.
+
address@hidden @code{BEGIN}, criterio di ricerca, funzione definita dall'utente
@code{assert()} e
address@hidden criterio di ricerca @code{BEGIN}, funzione definita dall'utente
@code{assert()} e
+C'@`e un modo per aggirare questo problema:
+assicurarsi che la regola @code{BEGIN} termini sempre
+con un'istruzione @code{exit}.
+
address@hidden Funzione round
address@hidden Arrotondamento di numeri
+
address@hidden arrotondare numeri
address@hidden numeri, arrotondamento di
address@hidden libreria di funzioni @command{awk}, arrotondamento di numeri
address@hidden funzioni, libreria di, arrotondamento di numeri
address@hidden @code{print}, istruzione, funzione @code{sprintf()} e
address@hidden istruzione @code{print}, funzione @code{sprintf()} e
address@hidden @code{printf}, istruzione, funzione @code{sprintf()} e
address@hidden istruzione @code{printf}, funzione @code{sprintf()} e
address@hidden @code{sprintf()}, funzione, istruzioni
@code{print}/@code{printf} e
address@hidden funzione @code{sprintf()}, istruzioni @code{print}/@code{printf}
e
+Il modo in cui @code{printf} e @code{sprintf()}
+(@pxref{Printf})
+effettuano l'arrotondamento spesso dipende dalla subroutine C @code{sprintf()}
+del sistema. Su molte macchine, l'arrotondamento di @code{sprintf()} @`e
address@hidden, il che significa che non sempre arrotonda un .5 finale per
+eccesso, contrariamente alle normali aspettative. Nell'arrotondamento
+statistico, .5 arrotonda alla cifra pari, anzich@'e sempre per eccesso,
address@hidden@dotless{i}}
+1.5 arrotonda a 2 e 4.5 arrotonda a 4. address@hidden significa che se si sta
usando un
+formato che fa arrotondamenti (p.es. @code{"%.0f"}), si dovrebbe controllare
+quello che fa il sistema che si sta usando. La seguente funzione esegue un
+arrotondamento tradizionale; potrebbe essere utile nel caso in cui
+l'istruzione @code{printf}
+di @command{awk} che si sta usando faccia degli arrotondamenti statistici:
+
address@hidden @code{round()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{round()}
address@hidden
address@hidden file eg/lib/round.awk
+# round.awk --- effettua arrotondamento tradizionale
address@hidden endfile
address@hidden
address@hidden file eg/lib/round.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# August, 1996
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/round.awk
+
+function round(x, ival, aval, frazione)
address@hidden
+ ival = int(x) # parte intera, int() fa un troncamento
+
+ # vedere se c'@`e la parte frazionale
+ if (ival == x) # nessuna parte frazionale
+ return ival # nessun decimale
+
+ if (x < 0) @{
+ aval = -x # valore assoluto
+ ival = int(aval)
+ frazione = aval - ival
+ if (frazione >= .5)
+ return int(x) - 1 # -2.5 --> -3
+ else
+ return int(x) # -2.3 --> -2
+ @} else @{
+ frazione = x - ival
+ if (frazione >= .5)
+ return ival + 1
+ else
+ return ival
+ @}
address@hidden
address@hidden endfile
address@hidden don't include test harness in the file that gets installed
+
+# codice per testare, commentato
+# @{ print $0, round($0) @}
address@hidden example
+
address@hidden Funzione random Cliff
address@hidden Il generatore di numeri casuali Cliff
address@hidden numeri casuali, generatore Cliff
address@hidden Cliff, generatore di numeri casuali
address@hidden casuali, numeri, generatore Cliff di
address@hidden funzioni, libreria di, numeri casuali Cliff
+
+Il
address@hidden://mathworld.wolfram.com/CliffRandomNumberGenerator.html,
generatore di numeri casuali Cliff}
address@hidden un generatore di numeri casuali molto semplice che ``passa il
test della sfera
+del rumore per la address@hidden non mostrando di avere alcuna struttura.''
address@hidden programmato in modo molto semplice, in meno di 10 righe di codice
address@hidden:
+
address@hidden @code{cliff_rand()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{cliff_rand()}
address@hidden
address@hidden file eg/lib/cliff_rand.awk
+# cliff_rand.awk --- generare numeri casuali con algoritmo di Cliff
address@hidden endfile
address@hidden
address@hidden file eg/lib/cliff_rand.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# December 2000
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/cliff_rand.awk
+
+BEGIN @{ _cliff_seme = 0.1 @}
+
+function cliff_rand()
address@hidden
+ _cliff_seme = (100 * log(_cliff_seme)) % 1
+ if (_cliff_seme < 0)
+ _cliff_seme = - _cliff_seme
+ return _cliff_seme
address@hidden
address@hidden endfile
address@hidden example
+
+Questo algoritmo richiede un ``seme'' iniziale di 0,1. Ogni nuovo valore
+usa il seme corrente come input per il calcolo.
+Se la funzione predefinita @code{rand()}
+(@pxref{Funzioni numeriche})
+non @`e abbastanza casuale, si address@hidden tentare di usare al suo posto
questa funzione.
+
address@hidden Funzioni ordinali
address@hidden Tradurre tra caratteri e numeri
+
address@hidden libreria di funzioni @command{awk}, valori di carattere come
numeri
address@hidden funzioni, libreria di, valori di carattere come numeri
address@hidden carattere, valore come numero
address@hidden numeri, come valori di carattere
+Un'implementazione commerciale di @command{awk} fornisce una funzione
+predefinita @code{ord()}, che prende un carattere e restituisce il valore
+numerico per quel carattere nella rappresentazione dei caratteri
+di quella particolare macchina. Se la
+stringa passata a @code{ord()} ha address@hidden di un carattere, viene usato
solo il
+primo.
+
+L'inverso di questa funzione @`e @code{chr()} (dalla funzione con lo stesso
nome
+in Pascal), che, dato un numero, restituisce il corrispondente carattere.
+Entrambe le funzioni si possono scrivere molto bene usando @command{awk};
+non vi @`e nessun reale motivo per inglobarle come funzioni predefinite
address@hidden:
+
address@hidden @code{ord()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{ord()}
address@hidden @code{chr()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{chr()}
address@hidden @code{_ord_init()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{_ord_init()}
address@hidden
address@hidden file eg/lib/ord.awk
+# ord.awk --- implementa ord e chr
+
+# Identificatori globali:
+# _ord_: valori numerici indicizzati da caratteri
+# _ord_init: funzione per inizializzare _ord_
address@hidden endfile
address@hidden
address@hidden file eg/lib/ord.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# 16 January, 1992
+# 20 July, 1992, revised
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/ord.awk
+
+BEGIN @{ _ord_init() @}
+
+function _ord_init( basso, alto, i, t)
address@hidden
+ basso = sprintf("%c", 7) # BEL @`e ascii 7
+ if (basso == "\a") @{ # ascii regolare
+ basso = 0
+ alto = 127
+ @} else if (sprintf("%c", 128 + 7) == "\a") @{
+ # ascii, con il primo bit a 1 (mark)
+ basso = 128
+ alto = 255
+ @} else @{ # ebcdic(!)
+ basso = 0
+ alto = 255
+ @}
+
+ for (i = basso; i <= alto; i++) @{
+ t = sprintf("%c", i)
+ _ord_[t] = i
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden serie di caratteri (codifiche dei caratteri da parte della
macchina)
address@hidden ASCII
address@hidden EBCDIC
address@hidden Unicode
address@hidden bit di address@hidden (in ASCII)
address@hidden @dfn{mark}, bit di address@hidden (in ASCII)
+Alcune spiegazioni riguardo ai numeri usati da @code{_ord_init()}
+non guastano.
+La serie di caratteri address@hidden importante oggi in uso @`e nota come
address@hidden situazione sta address@hidden
+cambiando: molti sistemi usano Unicode, una serie di caratteri molto ampia
+che comprende ASCII al suo interno.
+Nei sistemi che supportano interamente Unicode,
+un carattere address@hidden occupare fino a 32 bit, facendo diventare
+i semplici test usati qui eccessivamente complessi.}
+Sebbene un byte a
+8 bit possa contenere 256 valori distinti (da 0 a 255), ASCII definisce solo i
+caratteri che usano i valori da 0 a address@hidden
address@hidden stato esteso in molti paesi per usare i valori da 128 a 255
includendo
+i caratteri specifici del paese. Se il sistema in uso si avvale di queste
+estensioni, si address@hidden semplificare @code{_ord_init()} per eseguire un
ciclo da
+0 a 255.} Nel lontano passato,
+almeno un produttore di microcomputer
address@hidden Pr1me, blech
+ha usato ASCII, ma con una address@hidden di tipo @dfn{mark}, address@hidden
con il bit address@hidden a
+sinistra sempre a 1. Questo significa che su questi sistemi i caratteri
+ASCII hanno valori numerici da 128 a 255.
+Infine, i grandi elaboratori centrali usano la serie di caratteri EBCDIC, che
+prevede tutti i 256 valori.
+Ci sono altre serie di caratteri in uso su alcuni sistemi address@hidden
vecchi, ma non
+vale la pena di considerarli:
+
address@hidden
address@hidden file eg/lib/ord.awk
+function ord(str, c)
address@hidden
+ # solo il primo carattere @`e d'interesse
+ c = substr(str, 1, 1)
+ return _ord_[c]
address@hidden
+
+function chr(c)
address@hidden
+ # trasforma c in un numero aggiungendo uno 0
+ return sprintf("%c", c + 0)
address@hidden
address@hidden endfile
+
+#### programma di verifica ####
+# BEGIN @{
+# for (;;) @{
+# printf("immetti un carattere: ")
+# if (getline var <= 0)
+# break
+# printf("ord(%s) = %d\n", var, ord(var))
+# @}
+# @}
address@hidden endfile
address@hidden example
+
+Un ovvio miglioramento a queste funzioni @`e quello di spostare il codice per
la
+funzione @address@hidden nel corpo della regola @code{BEGIN}.
+Il programma @`e
+stato scritto inizialmente in questo modo per address@hidden di sviluppo.
+C'@`e un ``programma di verifica'' in una regola @code{BEGIN}, per verificare
+la funzione. @`E commentato, per poter essere eventualmente usato in
produzione.
+
address@hidden Funzione join
address@hidden Trasformare un vettore in una sola stringa
+
address@hidden libreria di funzioni @command{awk}, trasformare vettori in
stringhe
address@hidden funzioni, libreria di, trasformare vettori in stringhe
address@hidden stringhe, trasformare vettori in
address@hidden vettori, trasformare in stringhe
+Quando si fanno elaborazioni su stringhe, spesso @`e utile poter unire
+tutte le stringhe di un vettore in una lunga stringa. La funzione seguente,
address@hidden()}, svolge questo compito. address@hidden utilizzata nel
seguito in diversi
+programmi applicativi
address@hidden
+(@pxrefil{Programmi di esempio}).
address@hidden iftex
address@hidden
+(@pxref{Programmi di esempio}).
address@hidden ifnottex
+
+La buona progettazione di una funzione @`e importante; la funzione dev'essere
+generale, ma potrebbe anche avere un ragionevole comportamento di default.
+Viene chiamata con un vettore e anche con gli indici iniziale e finale degli
+elementi del vettore da riunire.
+Questo presuppone che gli indici del vettore
+siano numerici---una supposizione logica, dato che il vettore probabilmente @`e
+stato creato con @code{split()}
+(@pxref{Funzioni per stringhe}):
+
address@hidden @code{join()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{join()}
address@hidden
address@hidden file eg/lib/join.awk
+# join.awk --- trasforma un vettore in una stringa
address@hidden endfile
address@hidden
address@hidden file eg/lib/join.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/join.awk
+
+function join(vettore, iniz, fine, separ, risultato, i)
address@hidden
+ if (separ == "")
+ separ = " "
+ else if (separ == SUBSEP) # valore magico
+ separ = ""
+ risultato = vettore[iniz]
+ for (i = iniz + 1; i <= fine; i++)
+ risultato = risultato separ vettore[i]
+ return risultato
address@hidden
address@hidden endfile
address@hidden example
+
+Un ulteriore argomento opzionale @`e il separatore da usare quando si uniscono
+nuovamente le stringhe. Se il chiamante fornisce un valore non nullo,
address@hidden()} usa quello; se non viene fornito,
+per default ha un valore nullo.
+In questo caso, @code{join()} usa uno spazio singolo come separatore
+di default
+per le stringhe. Se il valore @`e uguale a @code{SUBSEP},
address@hidden()} unisce le stringhe senza un separatore tra di esse.
address@hidden serve come valore ``magico'' per indicare che potrebbe non
esserci
+un separatore tra le stringhe address@hidden bello
+se @command{awk} avesse un operatore di assegnamento per la concatenazione.
+La mancanza di un esplicito operatore per la concatenazione rende le operazioni
+sulle stringhe address@hidden difficili di quanto potrebbero essere.}
+
address@hidden Funzione getlocaltime
address@hidden Gestione dell'ora del giorno
+
address@hidden libreria di funzioni @command{awk}, gestire ora del giorno
(marcature temporali)
address@hidden funzioni, libreria di, gestione delle ore del giorno
address@hidden data e ora, formattate
address@hidden marcature temporali, formattate
address@hidden ora del giorno, gestire
+Le funzioni @code{systime()} e @code{strftime()} descritte nella
address@hidden di tempo}
+forniscono la address@hidden minima necessaria per visualizzare l'ora del
giorno
+in una forma intelligibile. Sebbene @code{strftime()} offra un'ampia gamma di
+formattazioni, i formati di controllo non sono facili da ricordare o
+intuitivamente ovvii quando si legge un programma.
+
+La seguente funzione, @code{getlocaltime()}, riempie un vettore fornito
+dall'utente con informazioni sul tempo preformattate. Restituisce una stringa
+con data e ora corrente formattata come nel programma di address@hidden
@command{date}:
+
address@hidden @code{getlocaltime()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getlocaltime()}
address@hidden
address@hidden file eg/lib/gettime.awk
+# getlocaltime.awk --- ottiene l'ora del giorno in un formato usabile
address@hidden endfile
address@hidden
address@hidden file eg/lib/gettime.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain, May 1993
+#
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/gettime.awk
+
+# Restituisce una stringa nel formato dell'output di date(1)
+# Riempie l'argomento del vettore time con valori individuali:
+# time["second"] -- secondi (0 - 59)
+# time["minute"] -- minuti (0 - 59)
+# time["hour"] -- ore (0 - 23)
+# time["althour"] -- ore (0 - 12)
+# time["monthday"] -- giorno del mese (1 - 31)
+# time["month"] -- mese dell'anno (1 - 12)
+# time["monthname"] -- nome del mese
+# time["shortmonth"] -- nome breve del mese
+# time["year"] -- anno modulo 100 (0 - 99)
+# time["fullyear"] -- anno completo
+# time["weekday"] -- giorno della settimana (domenica = 0)
+# time["altweekday"] -- giorno della settimana
(address@hidden@dotless{i}} = 0)
+# time["dayname"] -- nome del giorno della settimana
+# time["shortdayname"] -- nome breve del giorno della settimana
+# time["yearday"] -- giorno dell'anno (0 - 365)
+# time["timezone"] -- abbreviazione del nome della zona di fuso orario
+# time["ampm"] -- designazione di AM o PM
+# time["weeknum"] -- numero della settimana, domenica primo giorno
+# time["altweeknum"] -- numero della settimana,
address@hidden@dotless{i}} primmo giorno
+
+function getlocaltime(ora, ret, adesso, i)
address@hidden
+ # ottiene data e ora una volta sola,
+ # evitando chiamate di sistema non necessarie
+ adesso = systime()
+
+ # restituisce l'output in stile date(1)
address@hidden lun 8 giu 2015, 20.39.38, CEST
address@hidden "%a %e %b %Y , %H.%M.%S, %Z"
+ ret = strftime("%a %e %b %Y, %H.%M.%S, %Z", adesso)
+
+ # clear out target array
+ delete time
+
+ # immette i valori, forzando i valori numerici
+ # a essere numerici aggiungendo uno 0
+ time["second"] = strftime("%S", adesso) + 0
+ time["minute"] = strftime("%M", adesso) + 0
+ time["hour"] = strftime("%H", adesso) + 0
+ time["althour"] = strftime("%I", adesso) + 0
+ time["monthday"] = strftime("%d", adesso) + 0
+ time["month"] = strftime("%m", adesso) + 0
+ time["monthname"] = strftime("%B", adesso)
+ time["shortmonth"] = strftime("%b", adesso)
+ time["year"] = strftime("%y", adesso) + 0
+ time["fullyear"] = strftime("%Y", adesso) + 0
+ time["weekday"] = strftime("%w", adesso) + 0
+ time["altweekday"] = strftime("%u", adesso) + 0
+ time["dayname"] = strftime("%A", adesso)
+ time["shortdayname"] = strftime("%a", adesso)
+ time["yearday"] = strftime("%j", adesso) + 0
+ time["timezone"] = strftime("%Z", adesso)
+ time["ampm"] = strftime("%p", adesso)
+ time["weeknum"] = strftime("%U", adesso) + 0
+ time["altweeknum"] = strftime("%W", adesso) + 0
+
+ return ret
address@hidden
address@hidden endfile
address@hidden example
+
+Gli indici di stringa sono address@hidden facili da usare e leggere rispetto ai
+vari formati
+richiesti da @code{strftime()}. Il programma @code{alarm} illustrato in
address@hidden alarm}
+usa questa funzione.
+Una progettazione address@hidden generica della funzione @code{getlocaltime()}
+avrebbe permesso all'utente di fornire un valore di data e ora
+opzionale da usare al posto della data/ora corrente.
+
address@hidden Funzione readfile
address@hidden Leggere un intero file in una sola volta
+
+Spesso @`e conveniente avere il contenuto di un intero file disponibile
+in memoria, visto
+come un'unica stringa. Un modo chiaro e semplice per far address@hidden
potrebbe essere
+questo:
+
address@hidden
+function readfile(file, temp, contenuto)
address@hidden
+ if ((getline temp < file) < 0)
+ return
+
+ contenuto = temp
+ while (getline temp < file) > 0)
+ contenuto = contenuto RT tmp
+
+ close(file)
+ return contenuto
address@hidden
address@hidden example
+
+Questa funzione legge da @code{file} un record alla volta, ricostruendo
+l'intero contenuto del file nella variabile locale @code{contenuto}.
+Funziona, ma non @`e detto che sia efficiente.
+
+La funzione seguente, basata su un suggerimento di Denis Shirokov,
+legge l'intero contenuto del file in un colpo solo:
+
address@hidden @code{readfile()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{readfile()}
address@hidden
address@hidden file eg/lib/readfile.awk
+# readfile.awk --- legge un intero file in un colpo solo
address@hidden endfile
address@hidden
address@hidden file eg/lib/readfile.awk
+#
+# Idea originale di Denis Shirokov, cosmogen@@gmail.com, aprile 2013
+#
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/readfile.awk
+
+function readfile(file, temp, salva_rs)
address@hidden
+ salva_rs = RS
+ RS = "^$"
+ getline temp < file
+ close(file)
+ RS = salva_rs
+
+ return temp
address@hidden
address@hidden endfile
address@hidden example
+
+Funziona impostando @code{RS} a @samp{^$}, un'espressione regolare che
+non trova nessuna corrispondenza se il file ha un contenuto.
address@hidden
+legge i dati dal file contenuto in @code{temp}, tentando di trovare una
+corrispondenza con @code{RS}.
+La ricerca dopo ogni lettura non ha mai successo, ma termina
+rapidamente, e quindi @command{gawk} inserisce in
address@hidden l'intero contenuto del file.
+(@xref{Record} per informazioni su @code{RT} e @code{RS}.)
+
+Se @code{file} @`e vuoto, il valore di ritorno @`e la stringa vuota.
+Quindi, il codice chiamante address@hidden usare qualcosa simile a questo:
+
address@hidden
+contenuto = readfile("/qualche/percorso")
+if (length(contenuto) == 0)
+ # file vuoto @dots{}
address@hidden example
+
+La verifica serve a determinare se il file @`e vuoto o no. Una verifica
+equivalente potrebbe essere @samp{contenuto == ""}.
+
address@hidden di estensione Readfile} per una funzione di estensione
+anch'essa finalizzata a leggere un intero file in memoria.
+
address@hidden Apici alla shell
address@hidden Stringhe con apici da passare alla shell
+
address@hidden included by permission
address@hidden
+Date: Sun, 27 Jul 2014 17:16:16 -0700
+Message-ID: <address@hidden>
+Subject: Useful awk function
+From: Mike Brennan <address@hidden>
+To: Arnold Robbins <address@hidden>
address@hidden ignore
+
+Michael Brennan propone il seguente modello di programma,
+da lui usato spesso:
+
address@hidden
+#! /bin/sh
+
+awkp='
+ @dots{}
+ '
+
address@hidden | awk "$awkp" | /bin/sh
address@hidden example
+
+Per esempio, un suo programma chiamato @address@hidden
+file con suffisso @dfn{flac} contengono normalmente dei brani musicali.
address@hidden @`e un programma che permette di modificare
+le informazioni address@hidden contenute all'inizio di un file di tipo
address@hidden ha questa forma:
+
address@hidden
+$ @kbd{flac-edit -song="Whoope! That's Great" file.flac}
address@hidden example
+
address@hidden genera in output il seguente script, da passare alla
+shell (@file{/bin/sh}) per essere eseguito:
+
address@hidden
+chmod +w file.flac
+metaflac --remove-tag=TITLE file.flac
+LANG=en_US.88591 metaflac --set-tag=TITLE='Whoope! That'"'"'s Great' file.flac
+chmod -w file.flac
address@hidden example
+
+Si noti la address@hidden di gestire gli apici nello script da passare alla
shell.
+La funzione
address@hidden()} li prepara nel formato richiesto.
address@hidden @`e la stringa di un solo
+carattere @code{"'"} e @code{QSINGLE} @`e la stringa di tre caratteri
address@hidden"\"'\""}:
+
address@hidden
address@hidden file eg/lib/shellquote.awk
+# shell_quote --- pone tra apici un argomento da passare alla shell
address@hidden endfile
address@hidden
address@hidden file eg/lib/shellquote.awk
+#
+# Michael Brennan
+# brennan@@madronabluff.com
+# September 2014
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/shellquote.awk
+
+function shell_quote(s, # parametro
+ SINGLE, QSINGLE, i, X, n, ret) # variabili locali
address@hidden
+ if (s == "")
+ return "\"\""
+
+ SINGLE = "\x27" # apice singolo
+ QSINGLE = "\"\x27\"" # apice singolo incapsulato
+ n = split(s, X, SINGLE)
+
+ ret = SINGLE X[1] SINGLE
+ for (i = 2; i <= n; i++)
+ ret = ret QSINGLE SINGLE X[i] SINGLE
+
+ return ret
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Gestione File Dati
address@hidden Gestione di @value{DF}
+
address@hidden file, gestione di
address@hidden gestione di file
address@hidden libreria di funzioni @command{awk}, gestire file di dati
address@hidden funzioni, libreria di, gestire file di dati
+Questa @value{SECTION} presenta funzioni utili per gestire
address@hidden da riga di comando.
+
address@hidden
+* Funzione filetrans:: Una funzione per gestire il passaggio da un
+ file in input al successivo.
+* Funzione rewind:: Una funzione per rileggere il file in input.
+* Controllo di file:: Controllare che i file in input siano
+ accessibili.
+* File vuoti:: Controllare se i file in input sono vuoti.
+* Ignorare assegnamenti di variabili:: Trattare assegnamenti di variabili.
+ come nomi di file.
address@hidden menu
+
address@hidden Funzione filetrans
address@hidden Trovare i limiti dei @value{DF}
+
address@hidden file, gestione di, limiti dei file-dati
address@hidden file, inizializzazione e pulizia
+Ognuna delle regole @code{BEGIN} ed @code{END} viene eseguita esattamente
+solo una volta, rispettivamente all'inizio e alla fine del programma
address@hidden (@pxref{BEGIN/END}).
+Una volta noi (gli autori di @command{gawk}) siamo venuti in contatto
+con un utente che
+erroneamemnte pensava che le regole @code{BEGIN} venissero eseguite all'inizio
+di ogni @value{DF} e le regole @code{END} alla fine di ogni @value{DF}.
+
+Quando lo abbiamo informato che
+non era address@hidden@dotless{i}}, ci ha chiesto di aggiungere un nuovo
criterio di ricerca speciale
+a @command{gawk}, chiamato @code{BEGIN_FILE} e @code{END_FILE}, che avesse il
+comportamento desiderato. Ci ha fornito anche il codice per far questo.
+
+Non @`e stato necessario aggiungere a @command{gawk} questi criteri di ricerca
+speciali; il lavoro si address@hidden fare tranquillamente usando
@command{awk}, come
+illustrato nel seguente programma di libreria. @`E strutturato in modo da
+chiamare due funzioni fornite dall'utente, @code{a_inizio_file()} e
address@hidden()}, all'inizio e alla fine di ogni @value{DF}. Oltre a risolvere
+il problema in sole nove(!) righe di codice,
+questa soluzione @`e @emph{portabile}; il
+programma funziona con qualsiasi implementazione di @command{awk}:
+
address@hidden
+# transfile.awk
+#
+# Dare all'utente un aggancio per il passaggio
+# da un file in input a quello successivo
+#
+# L'utente deve fornire le funzioni a_inizio_file() ed a_fine_file()
+# ciascuna delle quali @`e invocata
+# quando il file, rispettivamente,
+# inizia e finisce.
address@hidden #
address@hidden # Arnold Robbins, arnold@@skeeve.com, Public Domain
address@hidden # January 1992
+
+FILENAME != _nome_file_vecchio @{
+ if (_nome_file_vecchio != "")
+ a_fine_file(_nome_file_vecchio)
+ _nome_file_vecchio = FILENAME
+ a_inizio_file(FILENAME)
address@hidden
+
+END @{ a_fine_file(FILENAME) @}
address@hidden example
+
+Questo file [transfile.awk] dev'essere caricato prima del programma
+``principale'' dell'utente,
+in modo che la regola ivi contenuta venga eseguita per prima.
+
+Questa regola dipende dalla variabile di @command{awk} @code{FILENAME}, che
+cambia automaticamente per ogni nuovo @value{DF}. Il @value{FN} corrente viene
+salvato in una variabile privata, @code{_nome_file_vecchio}. Se
@code{FILENAME} non @`e
+uguale a @code{_nome_file_vecchio}, inizia l'elaborazioone di un nuovo
@value{DF} ed
address@hidden necessario chiamare @code{a_fine_file()} per il vecchio file.
Poich@'e
address@hidden()} dovrebbe essere chiamato solo se un file @`e stato elaborato,
il
+programma esegue prima un controllo per assicurarsi che
@code{_nome_file_vecchio} non
+sia la stringa nulla. Il programma assegna poi il valore corrente di
address@hidden a @code{_nome_file_vecchio} e chiama @code{a_inizio_file()} per
il file.
+Poich@'e, come tutte le variabili di @command{awk}, @code{_nome_file_vecchio}
@`e
+inizializzato alla stringa nulla, questa regola viene eseguita correttamente
+anche per il primo @value{DF}.
+
+Il programma contiene anche una regola @code{END} per completare l'elaborazione
+per l'ultimo file. Poich@'e questa regola @code{END} viene prima di qualsiasi
+regola @code{END} contenuta nel programma ``principale'',
address@hidden()} viene
+chiamata per prima. Ancora una volta, l'address@hidden di poter avere
address@hidden regole
address@hidden ed @code{END} dovrebbe risultare chiara.
+
address@hidden @code{a_inizio_file()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{a_inizio_file()}
address@hidden @code{a_fine_file()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{a_fine_file()}
+Se lo stesso @value{DF} compare due volte di fila sulla riga di comando,
address@hidden()} e @code{a_inizio_file()} non vengono eseguite alla fine del
primo
+passaggio e all'inizio del secondo passaggio.
+La versione seguente risolve il problema:
+
address@hidden
address@hidden file eg/lib/ftrans.awk
+# ftrans.awk --- gestisce il passaggio da un file dati al successivo
+#
+# L'utente deve fornire le funzioni a_inizio_file() ed a_fine_file()
address@hidden endfile
address@hidden
address@hidden file eg/lib/ftrans.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# November 1992
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/ftrans.awk
+
+FNR == 1 @{
+ if (_filename_ != "")
+ a_fine_file(_filename_)
+ _filename_ = FILENAME
+ a_inizio_file(FILENAME)
address@hidden
+
+END @{ a_fine_file(_filename_) @}
address@hidden endfile
address@hidden example
+
address@hidden
+La
address@hidden iftex
address@hidden wc}
+mostra come utilizzare questa funzione di libreria e come address@hidden
+semplifichi la scrittura del programma principale.
+
address@hidden sidebar, Allora perch@'e @command{gawk} ha @code{BEGINFILE} e
@code{ENDFILE}?
address@hidden
address@hidden
+<sidebar><title>Allora perch@'e @command{gawk} ha @code{BEGINFILE} e
@code{ENDFILE}?</title>
address@hidden docbook
+
+
+Ci si address@hidden, probabilmente: perch@'e, se le funzioni
@code{a_inizio_file()} e
address@hidden()} possono eseguire il compito, @command{gawk} prevede i
+criteri di
+ricerca @code{BEGINFILE} e @code{ENDFILE}?
+
+Buona domanda. Normalmente, se @command{awk} non riesce ad aprire un file,
+questo fatto
+provoca un errore fatale immediato. In tal caso, per una funzione definita
+dall'utente non vi @`e alcun modo di affrontare il problema, giacch@'e la
+chiamata verrebbe effettuata
+solo dopo aver aperto il file e letto il primo record.
+Quindi, la ragione principale di @code{BEGINFILE} @`e quella di dare un
+``aggancio'' per gestire i file che non posso essere elaborati.
address@hidden esiste per simmetria, e perch@'e consente facilmente
+una pulizia "file per file". Per maggiori informazioni si faccia
+riferimento alla @ref{BEGINFILE/ENDFILE}.
+
address@hidden
+</sidebar>
address@hidden docbook
address@hidden ifdocbook
+
address@hidden
address@hidden
address@hidden @b{Allora perch@'e @command{gawk} ha @code{BEGINFILE} e
@code{ENDFILE}?}
+
+
+
+Ci si address@hidden, probabilmente: perch@'e, se le funzioni
@code{a_inizio_file()} e
address@hidden()} possono eseguire il compito, @command{gawk} prevede i
+criteri di
+ricerca @code{BEGINFILE} e @code{ENDFILE}?
+
+Buona domanda. Normalmente, se @command{awk} non riesce ad aprire un file,
+questo fatto
+provoca un errore fatale immediato. In tal caso, per una funzione definita
+dall'utente non vi @`e alcun modo di affrontare il problema, giacch@'e la
+chiamata verrebbe effettuata
+solo dopo aver aperto il file e letto il primo record.
+Quindi, la ragione principale di @code{BEGINFILE} @`e quella di dare un
+``aggancio'' per gestire i file che non posso essere elaborati.
address@hidden esiste per simmetria, e perch@'e consente facilmente
+una pulizia "file per file". Per maggiori informazioni si faccia
+riferimento alla @ref{BEGINFILE/ENDFILE}.
address@hidden cartouche
address@hidden ifnotdocbook
+
address@hidden Funzione rewind
address@hidden Rileggere il file corrente
+
address@hidden file, leggere un
address@hidden file, rileggere un
+Un'altra richiesta per una nuova funzione predefinita @`e stata per
+una funzione per rileggere il file corrente.
+L'utente che l'ha richiesta non voleva dover usare @code{getline}
+(@pxref{Getline})
+all'interno di un ciclo.
+
+Comunque, se non si @`e nella regola @code{END}, @`e piuttosto facile
+fare in modo di chiudere il corrente file in input immediatamente
+e ricominciare a leggerlo dall'inizio.
+In mancanza di un nome migliore, chiameremo la funzione @code{rewind()}:
+
address@hidden @code{rewind()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{rewind()}
address@hidden
address@hidden file eg/lib/rewind.awk
+# rewind.awk --- ricarica il file corrente e ricomincia a leggerlo
address@hidden endfile
address@hidden
address@hidden file eg/lib/rewind.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# September 2000
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/rewind.awk
+
+function rewind( i)
address@hidden
+ # sposta in alto i rimanenti argomenti
+ for (i = ARGC; i > ARGIND; i--)
+ ARGV[i] = ARGV[i-1]
+
+ # assicurarsi che gawk sappia raggiungerli
+ ARGC++
+
+ # fa address@hidden@dotless{i}} che il file corrente sia il prossimo a
essere letto
+ ARGV[ARGIND+1] = FILENAME
+
+ # do it
+ nextfile
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{rewind()} dipende dalla variabile @code{ARGIND}
+(@pxref{Variabili auto-assegnate}), che @`e specifica di @command{gawk}.
Dipende anche
+dalla parola chiave @code{nextfile} (@pxref{Istruzione nextfile}).
address@hidden, non si dovrebbe chiamarla da una regola @code{ENDFILE}.
+(Non sarebbe peraltro necessario, perch@'e @command{gawk} legge il file
+successivo non appena la regola @code{ENDFILE} finisce!)
+
+Occorre prestare attenzione quando si chiama @code{rewind()}. Si
address@hidden
+provocare una ricorsione infinita se non si sta attenti. Ecco un
+esempio di uso:
+
address@hidden
+$ @kbd{cat dati}
address@hidden a
address@hidden b
address@hidden c
address@hidden d
address@hidden e
+
+$ cat @kbd{test.awk}
address@hidden FNR == 3 && ! riavvolto @{
address@hidden riavvolto = 1
address@hidden rewind()
address@hidden @}
address@hidden
address@hidden @{ print FILENAME, FNR, $0 @}
+
+$ @kbd{gawk -f rewind.awk -f test.awk dati }
address@hidden data 1 a
address@hidden data 2 b
address@hidden data 1 a
address@hidden data 2 b
address@hidden data 3 c
address@hidden data 4 d
address@hidden data 5 e
address@hidden example
+
address@hidden Controllo di file
address@hidden Controllare che i @value{DF} siano leggibili
+
address@hidden risoluzione di problemi, address@hidden file-dati
address@hidden address@hidden, address@hidden controllare la
address@hidden file, non elaborare
+Normalmente, se si fornisce ad @command{awk} un @value{DF} che non @`e
leggibile,
+il programma
+si arresta con un errore fatale. Ci sono casi in cui sarebbe preferibile
+ignorare semplicemente questi file e address@hidden criterio di
+ricerca speciale @code{BEGINFILE} (@pxref{BEGINFILE/ENDFILE}) fornisce un
+meccanismo alternativo per trattare i file che non sono leggibili.
+Tuttavia, il codice qui proposto fornisce una soluzione portabile.}
+Si address@hidden far questo facendo precedere il proprio programma
@command{awk} dal
+seguente programma:
+
address@hidden @code{readable.awk}, programma
address@hidden
address@hidden file eg/lib/readable.awk
+# readable.awk --- file di libreria per saltare file non leggibili
address@hidden endfile
address@hidden
address@hidden file eg/lib/readable.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# October 2000
+# December 2010
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/readable.awk
+
+BEGIN @{
+ for (i = 1; i < ARGC; i++) @{
+ if (ARGV[i] ~ /^[a-zA-Z_][a-zA-Z0-9_]*=.*/ \
+ || ARGV[i] == "-" || ARGV[i] == "/dev/stdin")
+ continue # assegnamento di variabile o standard input
+ else if ((getline aperdere < ARGV[i]) < 0) # file non leggibile
+ delete ARGV[i]
+ else
+ close(ARGV[i])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden risoluzione di problemi, funzione @code{getline}
address@hidden comando @code{getline}, risoluzione di problemi
address@hidden @code{getline}, comando, risoluzione di problemi
+Questo codice funziona, perch@'e l'errore di @code{getline} non @`e fatale.
+Rimuovendo l'elemento da @code{ARGV} con @code{delete}
+si tralascia il file (perch@'e non @`e address@hidden nella lista).
+Si veda anche @ref{ARGC e ARGV}.
+
+Poich@'e per i nomi delle variabili @command{awk} si possono usare solo lettere
+dell'alfabeto inglese, di proposito il controllo con espressioni regolari
+non usa classi di
+carattere come @samp{[:alpha:]} e @samp{[:alnum:]}
+(@pxref{Espressioni tra parentesi quadre}).
+
address@hidden File vuoti
address@hidden Ricerca di file di lunghezza zero
+
+Tutte le implementazioni note di @command{awk} ignorano senza
+mandare alcun messaggio i file di
+lunghezza zero. Questo @`e un effetto collaterale del ciclo implicito di
address@hidden "leggi un record e confrontalo con le regole": quando
address@hidden cerca di leggere un record da un file vuoto, riceve
immediatamente
+un'indicazione di fine-file address@hidden, chiude il file,
+e prosegue con il
+successivo @value{DF} presente nella riga di comando, @emph{senza}
+eseguire alcun codice
+di programma @command{awk} a livello di utente.
+
+Usando la variabile @code{ARGIND} di @command{gawk}
+(@pxref{Variabili predefinite}), @`e possibile accorgersi quando un @value{DF}
address@hidden stato saltato. Simile al file di libreria illustrato in
address@hidden filetrans}, il seguente file di libreria chiama una funzione
+di nome @code{zerofile()} che l'utente deve fornire. Gli argomenti passati
+sono il @value{FN} e la posizione del file in @code{ARGV}:
+
address@hidden @code{zerofile.awk}, programma
address@hidden
address@hidden file eg/lib/zerofile.awk
+# zerofile.awk --- file di libreria per elaborare file in input vuoti
address@hidden endfile
address@hidden
address@hidden file eg/lib/zerofile.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# June 2003
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/zerofile.awk
+
+BEGIN @{ Argind = 0 @}
+
+ARGIND > Argind + 1 @{
+ for (Argind++; Argind < ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
+
+ARGIND != Argind @{ Argind = ARGIND @}
+
+END @{
+ if (ARGIND > Argind)
+ for (Argind++; Argind <= ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
address@hidden endfile
address@hidden example
+
+La variabile definita dall'utente @code{Argind} permette al programma
address@hidden
+di tracciare il suo percorso all'interno di @code{ARGV}. Ogniqualvolta il
+programma rileva che @code{ARGIND} @`e maggiore di @samp{Argind + 1}, vuol dire
+che uno o address@hidden file vuoti sono stati tralasciati. L'azione chiama
poi
address@hidden()} per ogni file che @`e stato saltato, incrementando
+ogni volta @code{Argind}.
+
+La regola @samp{Argind != ARGIND} tiene semplicemente aggiornato @code{Argind}
+nel caso che non ci siano file vuoti.
+
+Infine, la regola @code{END} prende in considerazione il caso di un qualsiasi
+file vuoto alla fine degli argomenti nella riga di comando. Si noti che nella
+condizione del ciclo @code{for}, la verifica usa l'operatore @samp{<=}, non
address@hidden<}.
+
address@hidden Ignorare assegnamenti di variabili
address@hidden Trattare assegnamenti di variabile come @value{FNS}
+
address@hidden assegnamenti di variabile, visti come nomi di file
address@hidden file, nomi di, assegnamenti di variabile visti come
address@hidden nomi di file, assegnamenti di variabile visti come
+Occasionalmente, potrebbe essere address@hidden opportuno che @command{awk}
non elabori gli
+assegnamenti di variabile presenti sulla riga di comando
+(@pxref{Opzioni di assegnamento}).
+In particolare, se si ha un @value{FN} che contiene un carattere @samp{=},
address@hidden tratta il @value{FN} come un assegnamento e non lo elabora.
+
+Alcuni utenti hanno suggerito un'opzione aggiuntiva da riga di comando per
address@hidden per disabilitare gli assegnamenti dati sulla riga di comando.
+Comunque, poche righe di codice di programmazione in un file di libreria
+hanno lo stesso effetto:
+
address@hidden @code{noassign.awk}, programma
address@hidden programma @code{noassign.awk}
address@hidden
address@hidden file eg/lib/noassign.awk
+# noassign.awk --- file di libreria per evitare la address@hidden
+# di una speciale opzione per disabilitare gli assegnamenti da
+# riga di comando
address@hidden endfile
address@hidden
address@hidden file eg/lib/noassign.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# October 1999
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/noassign.awk
+
+function disable_assigns(argc, argv, i)
address@hidden
+ for (i = 1; i < argc; i++)
+ if (argv[i] ~ /^[a-zA-Z_][a-zA-Z0-9_]*=.*/)
+ argv[i] = ("./" argv[i])
address@hidden
+
+BEGIN @{
+ if (Disabilita_variabili)
+ disable_assigns(ARGC, ARGV)
address@hidden
address@hidden endfile
address@hidden example
+
+Il programma va poi eseguito in questo modo:
+
address@hidden
+awk -v Disabilita_variabili=1 -f noassign.awk -f vostro_programma.awk *
address@hidden example
+
+La funzione esegue un ciclo che esamina ogni argomento.
+Antepone @samp{./} a
+qualsiasi argomento che abbia la forma di un assegnamento
+di variabile, trasformando address@hidden@dotless{i}} quell'argomento in un
@value{FN}.
+
+L'uso di @code{Disabilita_variabili} consente di disabilitare assegnamenti di
+variabile dati sulla riga di comando al momento dell'invocazione,
+assegnando alla variabile un valore @dfn{vero}.
+Se non viene impostata la variabile @`e inizializzata a zero (address@hidden
address@hidden), e gli argomenti sulla riga di comando
+non vengono modificati.
+
address@hidden Funzione getopt
address@hidden Elaborare opzioni specificate sulla riga di comando
+
address@hidden libreria di funzioni @command{awk}, opzioni sulla riga di comando
address@hidden funzioni, libreria di, opzioni sulla riga di comando
address@hidden riga di comando, opzioni, elaborazione di
address@hidden opzioni sulla riga di comando, elaborazione di
address@hidden funzioni, libreria di, libreria C
address@hidden argomenti, elaborazione di
+La maggior parte dei programmi di address@hidden su sistemi compatibili con
POSIX
+prevedono opzioni presenti sulla riga di comando che possono essere usate per
+cambiare il modo in cui un programma si comporta. @command{awk} @`e un
esempio di
+tali programmi (@pxref{Opzioni}).
+Spesso le opzioni hanno degli @dfn{argomenti} (address@hidden, dati che
servono al
+programma per eseguire correttamente le opzioni specificate
+sulla riga di comando).
+Per esempio, l'opzione @option{-F} di @command{awk} richiede di usare la
stringa
+specificata
+come separatore di campo. La prima occorrenza, sulla riga di comando, di
address@hidden o di una stringa che non inizia con @samp{-} segnala la fine
+delle opzioni.
+
address@hidden @code{getopt()}, funzione (libreria C)
address@hidden funzione @code{getopt()} (libreria C)
+I moderni sistemi Unix hanno una funzione C chiamata @code{getopt()} per
+elaborare gli argomenti presenti
+sulla riga di comando. Il programmatore fornisce una
+stringa che descrive le opzioni, ognuna delle quali consiste di
+una sola lettera. Se un'opzione richiede un
+argomento, nella stringa l'opzione @`e seguita da due punti.
+A @code{getopt()} vengono anche
+passati il numero e i valori degli argomenti presenti sulla riga di comando
+e viene chiamata in un ciclo.
address@hidden()} scandisce gli argomenti della riga di comando cercando
+le lettere delle opzioni.
+A ogni passaggio del ciclo restituisce un carattere
+singolo che rappresenta la successiva lettera di opzione trovata, o @samp{?}
+se viene trovata un'opzione non prevista.
+Quando restituisce @minus{}1, non ci sono ulteriori
+opzioni da trattare sulla riga di comando.
+
+Quando si usa @code{getopt()}, le opzioni che non prevedono argomenti
+possono essere raggruppate.
+Inoltre, le opzioni che hanno argomenti richiedono obbligatoriamente che
+l'argomento sia specificato.
+L'argomento address@hidden seguire immediatamente la lettera
+dell'opzione, o address@hidden costituire un argomento separato sulla riga di
comando.
+
+Dato un ipotetico programma che ha tre opzioni sulla riga di comando,
address@hidden, @option{-b} e @option{-c}, dove
address@hidden richiede un argomento, tutti i seguenti sono modi validi per
+invocare il programma:
+
address@hidden
+programma -a -b pippo -c dati1 dati2 dati3
+programma -ac -bpippo -- dati1 dati2 dati3
+programma -acbpippo dati1 dati2 dati3
address@hidden example
+
+Si noti che quando l'argomento @`e raggruppato con la sua opzione,
+la parte rimanente
+dell'argomento @`e considerato come argomento dell'opzione.
+In quest'esempio, @option{-acbpippo} indica che tutte le opzioni
address@hidden, @option{-b} e @option{-c} sono presenti,
+e che @samp{pippo} @`e l'argomento dell'opzione @option{-b}.
+
address@hidden()} fornisce quattro variabili esterne a disposizione del
+programmatore:
+
address@hidden @code
address@hidden optind
+L'indice nel vettore dei valori degli argomenti (@code{argv}) dove si
address@hidden
+trovare il primo argomento sulla riga di comando che non sia un'opzione.
+
address@hidden optarg
+Il valore (di tipo stringa) dell'argomento di un'opzione.
+
address@hidden opterr
+Solitamente @code{getopt()} stampa un messaggio di errore quando trova
un'opzione
+non valida. Impostando @code{opterr} a zero si disabilita questa
address@hidden
+(un'applicazione potrebbe voler stampare un proprio messaggio di errore.)
+
address@hidden optopt
+La lettera che rappresenta l'opzione sulla riga di comando.
address@hidden table
+
+Il seguente frammento di codice C mostra come @code{getopt()} potrebbe
+elaborare gli argomenti della riga di comando per @command{awk}:
+
address@hidden
+int
+main(int argc, char *argv[])
address@hidden
+ @dots{}
+ /* stampa un appropriato messaggio */
+ opterr = 0;
+ while ((c = getopt(argc, argv, "v:f:F:W:")) != -1) @{
+ switch (c) @{
+ case 'f': /* file */
+ @dots{}
+ break;
+ case 'F': /* separatore di campo */
+ @dots{}
+ break;
+ case 'v': /* assegnamento di variabile */
+ @dots{}
+ break;
+ case 'W': /* estensione */
+ @dots{}
+ break;
+ case '?':
+ default:
+ messaggio_di_aiuto();
+ break;
+ @}
+ @}
+ @dots{}
address@hidden
address@hidden example
+
+Incidentalmente, @command{gawk} al suo interno usa la funzione GNU
address@hidden()} per elaborare sia le normali opzioni che quelle lunghe
+in stile GNU
+(@pxref{Opzioni}).
+
+L'astrazione fornita da @code{getopt()} @`e molto utile ed @`e piuttosto comoda
+anche nei programmi @command{awk}. Di seguito si riporta una versione
address@hidden di @code{getopt()}. Questa funzione mette in evidenza uno dei
+maggiori punti deboli di @command{awk}, che @`e quello di essere molto carente
+nella manipolazione di caratteri singoli. Sono necessarie ripetute chiamate a
address@hidden()} per accedere a caratteri singoli.
+(@pxref{Funzioni per stringhe})address@hidden funzione
address@hidden stata scritta prima che @command{gawk} acquisisse la
address@hidden di
+dividere le stringhe in caratteri singoli usando @code{""} come separatore.
address@hidden stata lasciata address@hidden@dotless{i}}, poich@'e l'uso di
@code{substr()} @`e address@hidden portabile.}
+
+La spiegazione della funzione viene data
+man mano che si elencano i pezzi di codice che la compongono:
+
address@hidden @code{getopt()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getopt()}
address@hidden
address@hidden file eg/lib/getopt.awk
+# getopt.awk --- imita in awk la funzione di libreria C getopt(3)
address@hidden endfile
address@hidden
address@hidden file eg/lib/getopt.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+#
+# Initial version: March, 1991
+# Revised: May, 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/getopt.awk
+
+# Variabili esterne:
+# Optind -- indice in ARGV del primo argomento che non @`e un'opzione
+# Optarg -- valore di tipo stringa dell'argomento dell'opzione corrente
+# Opterr -- se diverso da zero, viene stampato un messaggio diagnostico
+# Optopt -- lettera dell'opzione corrente
+
+# Restituisce:
+# -1 alla fine delle opzioni
+# "?" per un'opzione non riconosciuta
+# <c> un carattere che rappresenta l'opzione corrente
+
+# Dati privati:
+# _opti -- indice in un'opzione multipla, p.es., -abc
address@hidden endfile
address@hidden example
+
+La funzione inizia con commenti che elencano e descrivono le variabili globali
+utilizzate, spiegano quali sono i valori di ritorno, il loro significato, e
+ogni altra variabile che @`e
+``esclusiva'' a questa funzione di libreria. Tale
+documentazione @`e essenziale per qualsiasi programma, e in modo particolare
per
+le funzioni di libreria.
+
+La funzione @code{getopt()} dapprima controlla che sia stata effettivamente
+chiamata con una stringa di opzioni (il parametro @code{opzioni}). Se
address@hidden ha lunghezza zero, @code{getopt()} restituisce immediatamente
address@hidden:
+
address@hidden @code{getopt()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getopt()}
address@hidden
address@hidden file eg/lib/getopt.awk
+function getopt(argc, argv, opzioni, unaopz, i)
address@hidden
+ if (length(opzioni) == 0) # nessuna opzione specificata
+ return -1
+
address@hidden
+ if (argv[Optind] == "--") @{ # fatto tutto
+ Optind++
+ _opti = 0
+ return -1
address@hidden group
+ @} else if (argv[Optind] !~ /^-[^:[:space:]]/) @{
+ _opti = 0
+ return -1
+ @}
address@hidden endfile
address@hidden example
+
+Il successivo controllo cerca la fine delle opzioni. Due trattini
+(@option{--}) marcano la fine delle opzioni da riga di comando, e lo stesso
+fa qualsiasi
+argomento sulla riga di comando che non inizi con @samp{-}. @code{Optind} @`e
+usato per scorrere il vettore degli argomenti presenti sulla riga di comando;
+mantiene il suo valore attraverso chiamate successive a @code{getopt()},
perch@'e
address@hidden una variabile globale.
+
+L'espressione regolare che viene usata, @address@hidden/^-[^:[:space:]/}},
+chiede di cercare un
address@hidden seguito da qualsiasi cosa che non sia uno spazio vuoto o un
carattere
+di due punti. Se l'argomento corrente sulla riga di comando non corrisponde a
+quest'espressione regolare, vuol dire che non si tratta di un'opzione, e
+quindi viene terminata l'elaborazione delle opzioni. Continuando:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+ if (_opti == 0)
+ _opti = 2
+ unaopz = substr(argv[Optind], _opti, 1)
+ Optopt = unaopz
+ i = index(opzioni, unaopz)
+ if (i == 0) @{
+ if (Opterr)
+ printf("%c -- opzione non ammessa\n", unaopz) > "/dev/stderr"
+ if (_opti >= length(argv[Optind])) @{
+ Optind++
+ _opti = 0
+ @} else
+ _opti++
+ return "?"
+ @}
address@hidden endfile
address@hidden example
+
+La variabile @code{_opti} tiene traccia della posizione nell'argomento
+della riga di comando correntemente in esame
+(@code{argv[Optind]}). Se opzioni multiple sono
+raggruppate con un @samp{-} (p.es., @option{-abx}), @`e necessario
+restituirle all'utente una per volta.
+
+Se @code{_opti} @`e uguale a zero, viene impostato a due, ossia all'indice
+nella
+stringa del successivo carattere da esaminare (@samp{-}, che @`e alla
+posizione uno viene ignorato).
+La variabile @code{unaopz} contiene il carattere,
+ottenuto con @code{substr()}. Questo @`e salvato in @code{Optopt} per essere
+usato dal programma principale.
+
+Se @code{unaopz} non @`e nella stringa delle opzioni @code{opzioni},
+si tratta di un'opzione
+non valida. Se @code{Opterr} @`e diverso da zero, @code{getopt()} stampa un
+messaggio di errore sullo @dfn{standard error} che @`e simile al messaggio
+emesso dalla versione C di @code{getopt()}.
+
+Poich@'e l'opzione non @`e valida, @`e necessario tralasciarla e passare al
successivo
+carattere di opzione. Se @code{_opti} @`e maggiore o uguale alla lunghezza
+dell'argomento corrente della riga di comando, @`e necessario passare al
+successivo argomento, in modo che @code{Optind} venga incrementato e
address@hidden sia reimpostato a zero. In caso contrario, @code{Optind} viene
+lasciato com'@`e e @code{_opti} viene soltanto incrementato.
+
+In ogni caso, poich@'e l'opzione non @`e valida, @code{getopt()} restituisce
address@hidden"?"}. Il programma principale address@hidden esaminare
@code{Optopt} se serve
+conoscere quale lettera di opzione @`e quella non valida. Proseguendo:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+ if (substr(opzioni, i + 1, 1) == ":") @{
+ # ottiene un argomento di opzione
+ if (length(substr(argv[Optind], _opti + 1)) > 0)
+ Optarg = substr(argv[Optind], _opti + 1)
+ else
+ Optarg = argv[++Optind]
+ _opti = 0
+ @} else
+ Optarg = ""
address@hidden endfile
address@hidden example
+
+Se l'opzione richiede un argomento, la lettera di opzione @`e seguita da due
punti
+nella stringa @code{opzioni}. Se rimangono altri caratteri nell'argomento
+corrente sulla riga di comando (@code{argv[Optind]}), il resto di quella
stringa
+viene assegnato a @code{Optarg}. Altrimenti, viene usato il successivo
+argomento sulla riga di comando (@samp{-xFOO} piuttosto che
address@hidden@w{-x FOO}}). In
+entrambi i casi, @code{_opti} viene reimpostato a zero, perch@'e non ci sono
altri
+caratteri da esaminare nell'argomento corrente sulla riga di comando.
+Continuando:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+ if (_opti == 0 || _opti >= length(argv[Optind])) @{
+ Optind++
+ _opti = 0
+ @} else
+ _opti++
+ return unaopz
address@hidden
address@hidden endfile
address@hidden example
+
+Infine, se @code{_opti} @`e zero o maggiore della lunghezza dell'argomento
+corrente sulla riga di comando, significa che l'elaborazione di
+quest'elemento in @code{argv} @`e
+terminata, quindi @code{Optind} @`e incrementato per
+puntare al successivo elemento in @code{argv}. Se nessuna delle condizioni @`e
+vera, viene incrementato solo @code{_opti}, cosicch@'e la successiva lettera di
+opzione address@hidden essere elaborata con la successiva chiamata a
@code{getopt()}.
+
+La regola @code{BEGIN} inizializza sia @code{Opterr} che @code{Optind} a uno.
address@hidden viene impostato a uno, perch@'e il comportamento di default per
address@hidden()} @`e quello di stampare un messaggio diagnostico dopo aver
visto
+un'opzione non valida. @code{Optind} @`e impostato a uno, perch@'e non
+c'@`e alcun motivo
+per considerare il nome del programma, che @`e in @code{ARGV[0]}:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+BEGIN @{
+ Opterr = 1 # il default @`e eseguire una diagnosi
+ Optind = 1 # salta ARGV[0]
+
+ # programma di controllo
+ if (_getopt_test) @{
+ while ((_go_c = getopt(ARGC, ARGV, "ab:cd")) != -1)
+ printf("c = <%c>, Optarg = <%s>\n",
+ _go_c, Optarg)
+ printf("argomenti che non sono opzioni:\n")
+ for (; Optind < ARGC; Optind++)
+ printf("\tARGV[%d] = <%s>\n",
+ Optind, ARGV[Optind])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Il resto della regola @code{BEGIN} @`e un semplice programma di controllo. Qui
+sotto si riportano i risultati di
+due esecuzioni di prova
+del programma di controllo:
+
address@hidden
+$ @kbd{awk -f getopt.awk -v _getopt_test=1 -- -a -cbARG bax -x}
address@hidden c = <a>, Optarg = <>
address@hidden c = <c>, Optarg = <>
address@hidden c = <b>, Optarg = <ARG>
address@hidden argomenti che non sono opzioni:
address@hidden ARGV[3] = <bax>
address@hidden ARGV[4] = <-x>
+
+$ @kbd{awk -f getopt.awk -v _getopt_test=1 -- -a -x -- xyz abc}
address@hidden c = <a>, Optarg = <>
address@hidden x -- opzione non ammessa
address@hidden c = <?>, Optarg = <>
address@hidden argomenti che non sono opzioni:
address@hidden ARGV[4] = <xyz>
address@hidden ARGV[5] = <abc>
address@hidden example
+
+In entrambe le esecuzioni, il primo @option{--} fa terminare gli argomenti dati
+ad @command{awk}, in modo che @command{awk} non tenti di interpretare le
opzioni
address@hidden, etc. come sue opzioni.
+
address@hidden NOTA
+Dopo che @code{getopt()} @`e terminato,
+il codice a livello utente deve eliminare tutti gli elementi
+di @code{ARGV} da
+1 a @code{Optind}, in modo che @command{awk} non tenti di elaborare le opzioni
+sulla riga di comando come @value{FNS}.
address@hidden quotation
+
+Usare @samp{#!} con l'opzione @option{-E} address@hidden essere d'aiuto per
evitare
+conflitti tra le opzioni del proprio programma e quelle di @command{gawk},
+poich@'e l'opzione @option{-E} fa address@hidden@dotless{i}} che
@command{gawk} abbandoni
+l'elaborazione di ulteriori opzioni.
+(@address@hidden eseguibili} e
address@hidden
address@hidden).
address@hidden ifnotdocbook
address@hidden
address@hidden).
address@hidden ifdocbook
+
+Molti degli esempi presentati in
address@hidden di esempio},
+usano @code{getopt()} per elaborare i propri argomenti.
+
address@hidden Funzioni Passwd
address@hidden Leggere la lista degli utenti
+
address@hidden libreria di funzioni @command{awk}, leggere la lista degli utenti
address@hidden funzioni, libreria di, leggera la lista degli utenti
address@hidden utenti, leggere la lista degli
address@hidden lista degli address@hidden leggere la
address@hidden @code{PROCINFO}, vettore
address@hidden vettore @code{PROCINFO}
+Il vettore @code{PROCINFO}
+(@pxref{Variabili predefinite})
address@hidden accesso ai numeri ID reale ed effettivo dell'utente e del gruppo
e, se
+disponibili, alla serie di gruppi ulteriori a cui l'utente appartiene.
+Comunque, poich@'e questi sono numeri, non forniscono informazioni molto utili
per
+l'utente medio. Bisogna trovare un modo per reperire informazioni
+sull'utente associate con i numeri ID dell'utente e del gruppo. Questa
address@hidden illustra una raccolta di funzioni per ottenere le informazioni
+dalla lista gli utenti. @xref{Funzioni Group} per una raccolta di
+funzioni simili per ottenere informazioni dalla lista dei gruppi.
+
address@hidden @code{getpwent()}, funzione (libreria C)
address@hidden funzione @code{getpwent()} (libreria C)
address@hidden @code{getpwent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwent()}
address@hidden utenti, informazioni riguardo agli, ottenere
address@hidden login, informazioni
address@hidden account, informazioni sugli
address@hidden password, file delle
address@hidden file delle password
+Lo standard POSIX non definisce il file dove sono mantenute le informazioni
+degli utenti. Invece, fornisce il file d'intestazione @code{<pwd.h>}
+e diverse @dfn{subroutine} del linguaggio C per ottenere informazioni sugli
+utenti. La funzione primaria @`e @code{getpwent()}, che sta per ``get password
+entry''. La ``password'' proviene dal file originale della lista
+degli utenti, @file{/etc/passwd}, che contiene le informazioni sugli utenti
+assieme alle password criptate (da cui il nome)address@hidden @`e
+vero per le versioni address@hidden antiche di Unix. In quelle address@hidden
recenti,
+la @dfn{password} di ogni utente @`e stata trasferita nel file
@file{/etc/shadow},
+un file non accessibile dall'utente normale. La struttura del file
address@hidden/etc/passwd} @`e rimasta la stessa, ma al posto del campo
@dfn{password}
+c'@`e una @code{x}.}
+
address@hidden @command{pwcat}, programma
+Sebbene un programma @command{awk} possa semplicemente leggere
address@hidden/etc/passwd} direttamente, questo file address@hidden non
contenere tutte le
+informazioni su tutti gli utenti del address@hidden spesso che le
+informazioni sulla password siano memorizzate in una lista in rete.} Per
+essere sicuri di poter produrre una versione leggibile e completa della banca
+dati degli utenti, @`e necessario scrivere un piccolo programma in C che chiama
address@hidden()}. @code{getpwent()} viene definita in modo da restituire un
+puntatore a una @code{struct passwd}. Ogni volta che viene chiamata,
+restituisce l'elemento successivo della lista. Quando non ci sono
address@hidden
+elementi, restituisce @code{NULL}, il puntatore nullo. Quando accade
address@hidden, il
+programma C dovrebbe chiamare @code{endpwent()} per chiudere la lista..
+Quel che segue @`e @command{pwcat}, un programma in C che ``concatena'' la
+lista delle password:
+
address@hidden
address@hidden file eg/lib/pwcat.c
+/*
+ * pwcat.c
+ *
+ * Genera una versione stampabile della lista delle password.
+ */
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+/*
+ * Arnold Robbins, arnold@@skeeve.com, May 1993
+ * Public Domain
+ * December 2010, move to ANSI C definition for main().
+ */
+
+#if HAVE_CONFIG_H
+#include <config.h>
+#endif
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+#include <stdio.h>
+#include <pwd.h>
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+#if defined (STDC_HEADERS)
+#include <stdlib.h>
+#endif
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+int
+main(int argc, char **argv)
address@hidden
+ struct passwd *p;
+
+ while ((p = getpwent()) != NULL)
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+#ifdef ZOS_USS
+ printf("%s:%ld:%ld:%s:%s\n",
+ p->pw_name, (long) p->pw_uid,
+ (long) p->pw_gid, p->pw_dir, p->pw_shell);
+#else
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+ printf("%s:%s:%ld:%ld:%s:%s:%s\n",
+ p->pw_name, p->pw_passwd, (long) p->pw_uid,
+ (long) p->pw_gid, p->pw_gecos, p->pw_dir, p->pw_shell);
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+#endif
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+
+ endpwent();
+ return 0;
address@hidden
address@hidden endfile
address@hidden example
+
+Se non si conosce il linguaggio C, non @`e il caso di preoccuparsi.
+L'output di @command{pwcat} @`e la lista degli utenti, nel formato
+tradizionale del file @file{/etc/passwd} con campi separati da due punti.
+I campi sono:
+
address@hidden @asis
address@hidden Login name
+Il nome di login dell'utente.
+
address@hidden Encrypted password
+La password criptata dell'utente. address@hidden non essere disponibile su
alcuni sistemi.
+
address@hidden User-ID
+L'ID numerico dell'utente.
+(Su alcuni sistemi, @`e un numero di formato @code{long} [32bit]
+del linguaggio C, e non nel formato @code{int} [16bit].
+Quindi, lo cambieremo in @code{long} per sicurezza.)
+
address@hidden Group-ID
+L'ID di gruppo numerico dell'utente.
+(Valgono le stesse considerazioni su @code{long} al posto di @code{int}.)
+
address@hidden Full name
+Il nome completo dell'utente, e talora altre informazioni associate
+all'utente.
+
address@hidden Home directory
+La directory di login (o ``home'') (nota ai programmatori di shell come
address@hidden).
+
address@hidden Login shell
+Il programma che viene eseguito quando l'utente effettua l'accesso. Questo @`e
+comunemente una shell, come Bash.
address@hidden table
+
+Di seguito si riportano alcune righe di un possibile output di @command{pwcat}:
+
address@hidden Jacobs, Andrew
address@hidden Robbins, Arnold
address@hidden Robbins, Miriam
address@hidden
+$ @kbd{pwcat}
address@hidden root:x:0:1:Operator:/:/bin/sh
address@hidden nobody:x:65534:65534::/:
address@hidden daemon:x:1:1::/:
address@hidden sys:x:2:2::/:/bin/csh
address@hidden bin:x:3:3::/bin:
address@hidden arnold:x:2076:10:Arnold Robbins:/home/arnold:/bin/sh
address@hidden miriam:x:112:10:Miriam Robbins:/home/miriam:/bin/sh
address@hidden andy:x:113:10:Andy Jacobs:/home/andy:/bin/sh
address@hidden
address@hidden example
+
+Dopo quest'introduzione, di seguito si riporta un gruppo di funzioni per
+ottenere informazioni sugli utenti. Ci sono diverse funzioni, che
+corrispondono alle omonime funzioni C:
+
address@hidden @code{_pw_init()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{_pw_init()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+# passwd.awk --- accedere alle informazioni del file delle password
address@hidden endfile
address@hidden
address@hidden file eg/lib/passwdawk.in
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised October 2000
+# Revised December 2010
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/passwdawk.in
+
+BEGIN @{
+ # modificare per adattarlo al sistema in uso
+ _pw_awklib = "/usr/local/libexec/awk/"
address@hidden
+
+function _pw_init( oldfs, oldrs, olddol0, pwcat, using_fw, using_fpat)
address@hidden
+ if (_pw_inizializzato)
+ return
+
+ oldfs = FS
+ oldrs = RS
+ olddol0 = $0
+ using_fw = (PROCINFO["FS"] == "FIELDWIDTHS")
+ using_fpat = (PROCINFO["FS"] == "FPAT")
+ FS = ":"
+ RS = "\n"
+
+ pwcat = _pw_awklib "pwcat"
+ while ((pwcat | getline) > 0) @{
+ _pw_byname[$1] = $0
+ _pw_byuid[$3] = $0
+ _pw_bycount[++_pw_totale] = $0
+ @}
+ close(pwcat)
+ _pw_contatore = 0
+ _pw_inizializzato = 1
+ FS = oldfs
+ if (using_fw)
+ FIELDWIDTHS = FIELDWIDTHS
+ else if (using_fpat)
+ FPAT = FPAT
+ RS = oldrs
+ $0 = olddol0
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, programma @code{pwcat}
address@hidden criterio di ricerca @code{BEGIN}, programma @code{pwcat}
+La regola @code{BEGIN} imposta una variabile privata col nome
+della directory in cui si
+trova @command{pwcat}.
+Poich@'e @`e destinata a essere usata da una routine di
+libreria di @command{awk}, si @`e scelto di metterla in
address@hidden/usr/local/libexec/awk}; comunque, in un altro sistema potrebbe
+essere messa in una directory differente.
+
+La funzione @code{_pw_init()} mette tre copie delle informazioni sull'utente in
+tre vettori associativi. I vettori sono indicizzati per nome-utente
+(@code{_pw_byname}), per numero di ID-utente (@code{_pw_byuid}), e per ordine
di
+occorrenza (@code{_pw_bycount}).
+La variabile @code{_pw_inizializzato} @`e usata per
+efficienza, poich@'e in questo modo @code{_pw_init()}
+viene chiamata solo una volta.
+
address@hidden @code{PROCINFO}, vettore, verificare la divisione in campi
address@hidden vettore @code{PROCINFO}, verificare la divisione in campi
address@hidden @code{getline}, comando, funzione definita dall'utente,
@code{_pw_init()}
address@hidden comando @code{getline}, funzione definita dall'utente,
@code{_pw_init()}
+Poich@'e questa funzione usa @code{getline} per leggere informazioni da
address@hidden, dapprima salva i valori di @code{FS}, @code{RS} e @code{$0}.
+Annota nella variabile @code{using_fw} se la suddivisione in campi
+usando @code{FIELDWIDTHS} @`e attiva o no.
+Far questo @`e necessario, poich@'e queste funzioni potrebbero essere chiamate
da
+qualsiai parte all'interno di un programma dell'utente, e l'utente
address@hidden
+suddividere i record in campi a suo piacimento.
address@hidden rende possibile ripristinare il corretto meccanismo di
suddivisione dei
+campi in un secondo momento. La verifica address@hidden restituire solo
@dfn{vero} per
address@hidden
+Il risultato address@hidden essere @dfn{falso} se si usa
address@hidden o @code{FPAT},
+o in qualche altra implementazione di @command{awk}.
+
+Il codice che controlla se si sta usando @code{FPAT}, utilizzando
address@hidden e @code{PROCINFO["FS"]}, @`e simile.
+
+La parte principale della funzione usa un ciclo per leggere le righe della
+lista, suddividere le righe in campi, e poi memorizzare la riga
+all'interno di ogni vettore a seconda delle address@hidden Quando il ciclo @`e
+completato, @address@hidden()}} fa pulizia chiudendo la @dfn{pipe},
+impostando @address@hidden a uno, e ripristinando @code{FS}
+(e @code{FIELDWIDTHS} o @code{FPAT}
+se necessario), @code{RS} e @code{$0}.
+L'uso di @address@hidden address@hidden spiegato a breve.
+
address@hidden @code{getpwnam()}, funzione (libreria C)
address@hidden funzione @code{getpwnam()} (libreria C)
+La funzione @code{getpwnam()} ha un nome utente come argomento di tipo
+stringa. Se
+quell'utente @`e presente nella lista, restituisce la riga appropriata.
+Altrimenti, il riferimento a un elemento inesistente del vettore
+aggiunge al vettore stesso un elemento il cui valore @`e la stringa nulla:
+
address@hidden @code{getpwnam()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwnam()}
address@hidden
address@hidden
address@hidden file eg/lib/passwdawk.in
+function getpwnam(nome)
address@hidden
+ _pw_init()
+ return _pw_byname[nome]
address@hidden
address@hidden endfile
address@hidden group
address@hidden example
+
address@hidden @code{getpwuid()}, funzione (libreria C)
address@hidden funzione @code{getpwuid()} (libreria C)
+In modo simile, la funzione @code{getpwuid()} ha per argomento
+il numero ID di un utente.
+Se un utente con quel numero si trova nella lista, restituisce la riga
+appropriata. Altrimenti restituisce la stringa nulla:
+
address@hidden @code{getpwuid()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwuid()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+function getpwuid(uid)
address@hidden
+ _pw_init()
+ return _pw_byuid[uid]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getpwent()}, funzione (libreria C)
address@hidden funzione @code{getpwent()} (libreria C)
+La funzione @code{getpwent()} scorre semplicemnte la lista, un elemento
+alla volta. Usa @code{_pw_contatore} per tener traccia della posizione
corrente
+nel vettore @code{_pw_bycount}:
+
address@hidden @code{getpwent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwent()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+function getpwent()
address@hidden
+ _pw_init()
+ if (_pw_contatore < _pw_totale)
+ return _pw_bycount[++_pw_contatore]
+ return ""
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{endpwent()}, funzione (libreria C)
address@hidden funzione @code{endpwent()} (libreria C)
+La funzione @address@hidden()}} reimposta @address@hidden a zero,
+in modo che chiamate successive a @code{getpwent()} ricomincino da capo:
+
address@hidden @code{endpwent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{endpwent()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+function endpwent()
address@hidden
+ _pw_contatore = 0
address@hidden
address@hidden endfile
address@hidden example
+
+In questa serie di funzioni, il fatto che ogni subroutine chiami
address@hidden@w{_pw_init()}}
+per inizializzare il vettore della lista utenti risponde a una precisa
+scelta progettuale.
+Il lavoro necessario per eseguire un processo separato che generi la
+lista degli utenti, e l'I/O per esaminarla, si ha solo se il programma
+principale dell'utente chiama effettivamente una di queste funzioni.
+Se questo
+file di libreria viene caricato assieme a un programma dell'utente, ma non
+viene mai chiamata nessuna delle routine, non c'@`e nessun lavoro aggiuntivo
+richiesto in fase di esecuzione.
+(L'alternativa @`e quella di spostare il corpo di @address@hidden()}}
+all'interno di una regola @code{BEGIN}, che esegua sempre @command{pwcat}.
+Questo semplifica il codice ma richiede di eseguire un processo extra
+il cui risultato potrebbe non essere mai utilizzato dal programma.)
+
+A sua volta, chiamare ripetutamente @code{_pw_init()} non @`e troppo
+dispendioso, perch@'e la
+variabile @code{_pw_inizializzato} permette di evitare di leggere
+i dati relativi agli utenti address@hidden di una
+volta. Se la preoccupazione @`e quella di minimizzare il tempo di
+esecuzione del programma @command{awk},
+il controllo di @code{_pw_inizializzato} potrebbe essere spostato
+al di fuori di @code{_pw_init()} e duplicato in tutte le altre funzioni.
+In pratica, questo non @`e necessario, poich@'e la maggior parte dei
+programmi di @command{awk}
address@hidden I/address@hidden programmi si distinguono tradizionalemente in
+CPU-bound e I/O-bound. Quelli CPU-bound effettuano elaborazioni che non
+richiedono molta address@hidden di I/O, come ad esempio la preparazione di una
+tavola di numeri primi. Quelli I/O bound leggono dei file, ma richiedono
+poca address@hidden di elaborazione per ogni record letto.},
+e una tale modifica complicherebbe inutilmente il codice.
+
+Il programma @command{id} in @ref{Programma id}
+usa queste funzioni.
+
address@hidden Funzioni Group
address@hidden Leggere la lista dei gruppi
+
address@hidden libreria di funzioni @command{awk}, leggere la lista dei gruppi
address@hidden funzioni, libreria di, leggere la lista dei gruppi
address@hidden gruppi, lista dei, leggere la
address@hidden lista dei gruppi, leggere la
address@hidden @code{PROCINFO}, vettore, e appartenenza a gruppi
address@hidden @code{getgrent()}, funzione (libreria C)
address@hidden funzione @code{getgrent()} (libreria C)
address@hidden @code{getgrent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrent()}
address@hidden address@hidden informazioni su
address@hidden account, informazioni sugli
address@hidden gruppi, file dei
address@hidden file dei gruppi
+Molto di quel che @`e stato detto
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden Passwd}
+vale anche per la lista dei gruppi. Sebbene questa sia tradizionalmente
+contenuta in
+un file ben noto (@file{/etc/group}) in un altrettanto noto formato,
+lo standard
+POSIX prevede solo una serie di routine della libreria C
+(@code{<grp.h>} e @code{getgrent()})
+per accedere a tali informazioni.
+Anche se il file suddetto @`e disponibile, potrebbe non contenere delle
+informazioni
+complete. address@hidden, come per la lista degli utenti, @`e necessario
avere un
+piccolo programma in C che genera la lista dei gruppi come suo output.
address@hidden, un programma in C che fornisce la lista dei gruppi,
address@hidden il seguente:
+
address@hidden @command{grcat}, programma C
address@hidden programma C, @command{grcat}
address@hidden
address@hidden file eg/lib/grcat.c
+/*
+ * grcat.c
+ *
+ * Genera una versione stampabile della lista dei gruppi.
+ */
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+/*
+ * Arnold Robbins, arnold@@skeeve.com, May 1993
+ * Public Domain
+ * December 2010, move to ANSI C definition for main().
+ */
+
+/* Per OS/2, non fare nulla. */
+#if HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#if defined (STDC_HEADERS)
+#include <stdlib.h>
+#endif
+
+#ifndef HAVE_GETGRENT
+int main() { return 0; }
+#else
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/grcat.c
+#include <stdio.h>
+#include <grp.h>
+
+int
+main(int argc, char **argv)
address@hidden
+ struct group *g;
+ int i;
+
+ while ((g = getgrent()) != NULL) @{
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+#ifdef ZOS_USS
+ printf("%s:%ld:", g->gr_name, (long) g->gr_gid);
+#else
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/grcat.c
+ printf("%s:%s:%ld:", g->gr_name, g->gr_passwd,
+ (long) g->gr_gid);
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+#else
+ printf("%s:*:%ld:", g->gr_name, (long) g->gr_gid);
+#endif
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/grcat.c
+ for (i = 0; g->gr_mem[i] != NULL; i++) @{
+ printf("%s", g->gr_mem[i]);
address@hidden
+ if (g->gr_mem[i+1] != NULL)
+ putchar(',');
+ @}
address@hidden group
+ putchar('\n');
+ @}
+ endgrent();
+ return 0;
address@hidden
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+#endif /* HAVE_GETGRENT */
address@hidden endfile
address@hidden ignore
address@hidden example
+
+Ciascuna riga nella lista dei gruppi rappresenta un gruppo. I campi sono
+separati da due punti e rappresentano le seguenti informazioni:
+
address@hidden @asis
address@hidden Nome del gruppo
+Il nome del gruppo.
+
address@hidden Password del gruppo
+La password del gruppo criptata. In pratica, questo campo non viene mai usato;
+normalmente @`e vuoto o impostato a @samp{x}.
+
address@hidden Numero ID del gruppo
+Il numero ID del gruppo in formato numerico;
+l'associazione del nome al numero dev'essere univoca all'interno di questo
file.
+(Su alcuni sistemi, @`e un numero nel formato @code{long} [32bit]
+del linguaggio C, e non nel formato @code{int} [16bit].
+Quindi, lo cambieremo in @code{long} per sicurezza.)
+
address@hidden Lista dei membri del gruppo
+Una lista di nomi utente separati da virgole.
+Questi utenti sono i membri del gruppo.
+I sistemi Unix moderni consentono agli utenti di appartenere a
+diversi gruppi simultaneamente. Se il sistema in uso @`e uno di questi, ci
sono
+elementi in @code{PROCINFO} che vanno da @code{"group1"} fino a
address@hidden"address@hidden"} per quei numeri di ID di gruppo.
+(Si noti che @code{PROCINFO} @`e un'estensione @command{gawk};
address@hidden predefinite}.)
address@hidden table
+
+Di seguito si riporta quel che @command{grcat} potrebbe produrre:
+
address@hidden
+$ @kbd{grcat}
address@hidden wheel:x:0:arnold
address@hidden nogroup:x:65534:
address@hidden daemon:x:1:
address@hidden kmem:x:2:
address@hidden staff:x:10:arnold,miriam,andy
address@hidden other:x:20:
address@hidden
address@hidden example
+
+Qui ci sono le funzioni per ottenere informazioni relative alla lista dei
+gruppi. Ce ne sono diverse, costruite sul modello delle omonime funzioni della
+libreria C:
+
address@hidden @code{getline}, comando, funzione definita dall'utente,
@code{_gr_init()}
address@hidden comando @code{getline}, funzione definita dall'utente,
@code{_gr_init()}
address@hidden @code{_gr_init()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{_gr_init()}
address@hidden
address@hidden file eg/lib/groupawk.in
+# group.awk --- funzioni per il trattamento del file dei gruppi
address@hidden endfile
address@hidden
address@hidden file eg/lib/groupawk.in
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised October 2000
+# Revised December 2010
address@hidden endfile
address@hidden ignore
address@hidden line break on _gr_init for smallbook
address@hidden file eg/lib/groupawk.in
+
+BEGIN @{
+ # Modificare in base alla struttura del proprio sistema
+ _gr_awklib = "/usr/local/libexec/awk/"
address@hidden
+
+function _gr_init( oldfs, oldrs, olddol0, grcat,
+ using_fw, using_fpat, n, a, i)
address@hidden
+ if (_gr_inizializzato)
+ return
+
+ oldfs = FS
+ oldrs = RS
+ olddol0 = $0
+ using_fw = (PROCINFO["FS"] == "FIELDWIDTHS")
+ using_fpat = (PROCINFO["FS"] == "FPAT")
+ FS = ":"
+ RS = "\n"
+
+ grcat = _gr_awklib "grcat"
+ while ((grcat | getline) > 0) @{
+ if ($1 in _gr_byname)
+ _gr_byname[$1] = _gr_byname[$1] "," $4
+ else
+ _gr_byname[$1] = $0
+ if ($3 in _gr_bygid)
+ _gr_bygid[$3] = _gr_bygid[$3] "," $4
+ else
+ _gr_bygid[$3] = $0
+
+ n = split($4, a, "[ \t]*,[ \t]*")
+ for (i = 1; i <= n; i++)
+ if (a[i] in _gr_groupsbyuser)
+ _gr_groupsbyuser[a[i]] = _gr_groupsbyuser[a[i]] " " $1
+ else
+ _gr_groupsbyuser[a[i]] = $1
+
+ _gr_bycount[++_gr_contatore] = $0
+ @}
+ close(grcat)
+ _gr_contatore = 0
+ _gr_inizializzato++
+ FS = oldfs
+ if (using_fw)
+ FIELDWIDTHS = FIELDWIDTHS
+ else if (using_fpat)
+ FPAT = FPAT
+ RS = oldrs
+ $0 = olddol0
address@hidden
address@hidden endfile
address@hidden example
+
+La regola @code{BEGIN} imposta una variabile privata con il nome della
+directory in cui si trova @command{grcat}.
+Poich@'e @`e destinata a essere usata da una routine di
+libreria di @command{awk}, si @`e scelto di metterla in
address@hidden/usr/local/libexec/awk}; comunque, in un altro sistema potrebbe
+essere messa in una directory differente.
+
+Queste routine seguono le stesse linee generali delle routine per formare la
+lista degli utenti (@pxref{Funzioni Passwd}).
+La variabile @address@hidden @`e usata per
+essere sicuri che la lista venga letta una volta sola.
+La funzione @address@hidden()}} dapprima salva @code{FS},
address@hidden e
address@hidden, e poi imposta @code{FS} e @code{RS} ai valori da usare nel
+passare in rassegna le informazioni di gruppo. Inoltre
+viene annotato se si stanno usando @code{FIELDWIDTHS} o @code{FPAT}, per
+poter poi
+ripristinare il meccanismo di suddivisione in campi appropriato.
+
+Le informazioni sui gruppi sono memorizzate in diversi vettori associativi.
+I vettori sono indicizzati per nome di gruppo (@address@hidden), per
+numero ID del gruppo (@address@hidden), e per posizione nella lista
+(@address@hidden). C'@`e un vettore aggiuntivo indicizzato per nome utente
+(@address@hidden), che @`e una lista, separata da spazi, dei
+gruppi ai quali ciascun utente appartiene.
+
+Diversamente dalla lista degli utenti, @`e possibile avere address@hidden
record
+nella lista per lo stesso gruppo. Questo @`e frequente quando un gruppo ha
+un gran numero di membri. Un paio di tali voci potrebbero essere come queste:
+
address@hidden
+tvpeople:x:101:johnny,jay,arsenio
+tvpeople:x:101:david,conan,tom,joan
address@hidden example
+
+Per questo motivo, @code{_gr_init()} controlla se un nome di gruppo o un numero
+di ID di gruppo @`e stato address@hidden visto. Se address@hidden@dotless{i}}
fosse, i nomi utente vanno
+semplicemente concatenati con la precedente lista di address@hidden'@`e un
+piccolo problema col codice appena illustrato. Supponiamo che la prima volta
+non ci siano nomi. Questo codice aggiunge i nomi con una virgola iniziale.
+Inoltre non controlla che ci sia un @code{$4}.}
+
+Infine, @code{_gr_init()} chiude la @dfn{pipe} a @command{grcat}, ripristina
address@hidden (e @code{FIELDWIDTHS} o @code{FPAT}, se necessario), @code{RS} e
address@hidden, inizializza @code{_gr_contatore} a zero
+(per essere usato address@hidden tardi), e rende @code{_gr_inizializzato}
diverso da zero.
+
address@hidden @code{getgrnam()}, funzione (libreria C)
address@hidden funzione @code{getgrnam()} (libreria C)
+La funzione @code{getgrnam()} ha come argomento un nome di gruppo, e se quel
+gruppo esiste, viene restituito.
+
+Altrimenti, il riferimento a un elemento inesistente del vettore
+aggiunge al vettore stesso un elemento il cui valore @`e la stringa nulla:
+
address@hidden @code{getgrnam()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrnam()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgrnam(group)
address@hidden
+ _gr_init()
+ return _gr_byname[group]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getgrgid()}, funzione (libreria C)
address@hidden funzione @code{getgrgid()} (libreria C)
+La funzione @code{getgrgid()} @`e simile; ha come argomento un numero ID di
+gruppo e controlla le informazioni assiciate con quell'ID di gruppo:
+
address@hidden @code{getgrgid()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrgid()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgrgid(gid)
address@hidden
+ _gr_init()
+ return _gr_bygid[gid]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getgruser()}, funzione (libreria C)
address@hidden funzione @code{getgruser()} (libreria C)
+La funzione @code{getgruser()} non ha un equivalente in C. Ha come argomento un
+nome-utente e restituisce l'elenco dei gruppi di cui l'utente @`e membro:
+
address@hidden @code{getgruser()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgruser()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgruser(user)
address@hidden
+ _gr_init()
+ return _gr_groupsbyuser[user]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getgrent()}, funzione (libreria C)
address@hidden funzione @code{getgrent()} (libreria C)
+La funzione @code{getgrent()} scorre la lista un elemento alla volta.
+Usa @code{_gr_contatore} per ricordare la posizione corrente nella lista:
+
address@hidden @code{getgrent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrent()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgrent()
address@hidden
+ _gr_init()
+ if (++_gr_contatore in _gr_bycount)
+ return _gr_bycount[_gr_contatore]
+ return ""
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{endgrent()}, funzione (libreria C)
address@hidden funzione @code{endgrent()} (libreria C)
+La funzione @code{endgrent()} reimposta @code{_gr_contatore} a zero in modo che
address@hidden()} possa ricominciare da capo:
+
address@hidden @code{endgrent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{endgrent()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function endgrent()
address@hidden
+ _gr_contatore = 0
address@hidden
address@hidden endfile
address@hidden example
+
+Come con le routine per la lista degli utenti, ogni funzione chiama
address@hidden()} per inizializzare i vettori.
address@hidden@dotless{i}} facendo si address@hidden il solo
+lavoro aggiuntivo di eseguire @command{grcat} se queste funzioni vengono
+usate (rispetto a spostare il corpo di @code{_gr_init()} all'interno della
+regola @code{BEGIN}).
+
+La maggior parte del lavoro consiste nell'ispezionare la lista e nel
+costruire i vari vettori associativi. Le funzioni che l'utente chiama sono
+di per s@'e molto semplici, poich@'e si appoggiano sui vettori associativi di
address@hidden per fare il lavoro.
+
+Il programma @command{id} in @ref{Programma id}
+usa queste funzioni.
+
address@hidden Visitare vettori
address@hidden Attraversare vettori di vettori
+
address@hidden
+La
address@hidden iftex
address@hidden di vettori} trattava come @command{gawk}
+avere a disposizione vettori di vettori. In particolare, qualsiasi elemento di
+un vettore address@hidden essere uno scalare o un altro vettore. La funzione
address@hidden()} (@pxref{Funzioni per i tipi})
+permette di distinguere un vettore
+da uno scalare.
+La seguente funzione, @code{walk_array()}, attraversa ricorsivamente
+un vettore, stampando gli indici e i valori di ogni elemento.
+Viene chiamata col vettore e con una stringa che contiene il nome
+del vettore:
+
address@hidden @code{walk_array()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{walk_array()}
address@hidden
address@hidden file eg/lib/walkarray.awk
+function walk_array(vett, nome, i)
address@hidden
+ for (i in vett) @{
+ if (isarray(vett[i]))
+ walk_array(vett[i], (nome "[" i "]"))
+ else
+ printf("%s[%s] = %s\n", nome, i, vett[i])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Funziona eseguendo un ciclo su ogni elemento del vettore. Se un dato elemento
address@hidden esso stesso un vettore, la funzione chiama s@'e stessa
ricorsivamente,
+passando il sottovettore e una nuova stringa che rappresenta l'indice corrente.
+In caso contrario, la funzione stampa semplicemente il nome, l'indice e il
+valore dell'elemento.
+Qui di seguito si riporta un programma principale che ne mostra l'uso:
+
address@hidden
+BEGIN @{
+ a[1] = 1
+ a[2][1] = 21
+ a[2][2] = 22
+ a[3] = 3
+ a[4][1][1] = 411
+ a[4][2] = 42
+
+ walk_array(a, "a")
address@hidden
address@hidden example
+
+Quando viene eseguito, il programma produce il seguente output:
+
address@hidden
+$ @kbd{gawk -f walk_array.awk}
address@hidden a[1] = 1
address@hidden a[2][1] = 21
address@hidden a[2][2] = 22
address@hidden a[3] = 3
address@hidden a[4][1][1] = 411
address@hidden a[4][2] = 42
address@hidden example
+
+La funzione appena illustrata stampa semplicemente il nome e il valore
+di ogni elemento costituito da un vettore scalare. Comunque @`e facile
+generalizzarla, passandole il nome di una funzione da chiamare
+quando si attraversa un vettore. La funzione modificata @`e simile a questa:
+
address@hidden
address@hidden file eg/lib/processarray.awk
+function process_array(vett, nome, elab, do_arrays, i, nuovo_nome)
address@hidden
+ for (i in vett) @{
+ nuovo_nome = (nome "[" i "]")
+ if (isarray(vett[i])) @{
+ if (do_arrays)
+ @@elab(nuovo_nome, vett[i])
+ process_array(vett[i], nuovo_nome, elab, do_arrays)
+ @} else
+ @@elab(nuovo_nome, vett[i])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Gli argomenti sono i seguenti:
+
address@hidden @code
address@hidden vett
+Il vettore.
+
address@hidden nome
+Il nome del vettore (una stringa).
+
address@hidden elab
+Il nome della funzione da chiamare.
+
address@hidden do_arrays
+Se vale @dfn{vero}, la funzione address@hidden gestire elementi che sono
sottovettori.
address@hidden table
+
+Se devono essere elaborati sottovettori, questo vien fatto prima di
+attraversarne altri.
+
+Quando viene eseguita con la seguente struttura, la funzione produce lo stesso
+risultato della precedente versione di @code{walk_array()}:
+
address@hidden
+BEGIN @{
+ a[1] = 1
+ a[2][1] = 21
+ a[2][2] = 22
+ a[3] = 3
+ a[4][1][1] = 411
+ a[4][2] = 42
+
+ process_array(a, "a", "do_print", 0)
address@hidden
+
+function do_print(nome, elemento)
address@hidden
+ printf "%s = %s\n", nome, elemento
address@hidden
address@hidden example
+
address@hidden Sommario funzioni di libreria
address@hidden Riassunto
+
address@hidden @value{BULLET}
address@hidden
+Leggere i programmi @`e un eccellente metodo per imparare la "buona
+programmazione". Le funzioni e i programmi contenuti in questo @value{CHAPTER}
+e nel successivo si propongo questo obiettivo.
+
address@hidden
+Quando si scrivono funzioni di libreria di uso generale, si deve stare attenti
+ai nomi da dare alle variabili globali, facendo in modo che non entrino in
+conflitto con le variabili di un programma dell'utente.
+
address@hidden
+Le funzioni descritte qui appartengono alle seguenti categorie:
+
address@hidden nested list
address@hidden @asis
address@hidden Problemi generali
+Conversione di numeri in stringhe, verifica delle asserzioni, arrotondamenti,
+generazione di numeri casuali, conversione di caratteri in numeri, unione di
+stringhe, ottenimento di informazioni su data e ora facilmente usabili,
+e lettura di un intero file in una volta sola
+
address@hidden Gestione dei @value{DF}
+Annotazione dei limiti di un @value{DF}, rilettura del file corrente,
+ricerca di
+file leggibili, ricerca di file di lunghezza zero, e trattamento degli
+assegnamenti di variabili fatti sulla riga comando come @value{FNS}
+
address@hidden Elaborazione di opzioni sulla riga di comando
+Una versione @command{awk} della funzione del C standard @code{getopt()}
+
address@hidden Lettura dei file degli utenti e dei gruppi
+Due serie di routine equivalenti alle versioni disponibili nella libreria
+del linguaggio C
+
address@hidden Attraversamento di vettori di vettori
+Due funzioni che attraversano un vettore di vettori fino in fondo
address@hidden table
address@hidden end nested list
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi con le librerie
address@hidden Esercizi
+
address@hidden
address@hidden
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden vuoti}, abbiamo illustrato il programma @file{zerofile.awk},
+che fa uso della variabile di @command{gawk} @code{ARGIND}. Questo problema
address@hidden
+essere risolto senza dipendere da @code{ARGIND}? Se
address@hidden@dotless{i}}, come?
+
address@hidden
+# zerofile2.awk --- same thing, portably
+
+BEGIN @{
+ ARGIND = Argind = 0
+ for (i = 1; i < ARGC; i++)
+ Fnames[ARGV[i]]++
+
address@hidden
+FNR == 1 @{
+ while (ARGV[ARGIND] != FILENAME)
+ ARGIND++
+ Seen[FILENAME]++
+ if (Seen[FILENAME] == Fnames[FILENAME])
+ do
+ ARGIND++
+ while (ARGV[ARGIND] != FILENAME)
address@hidden
+ARGIND > Argind + 1 @{
+ for (Argind++; Argind < ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
+ARGIND != Argind @{
+ Argind = ARGIND
address@hidden
+END @{
+ if (ARGIND < ARGC - 1)
+ ARGIND = ARGC - 1
+ if (ARGIND > Argind)
+ for (Argind++; Argind <= ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
address@hidden ignore
+
address@hidden
+Come esercizio collegato, rivedere quel codice per gestire il caso in cui un
+valore contenuto in @code{ARGV} sia un assegnamento di variabile.
+
address@hidden
address@hidden June 13 2015: Antonio points out that this is answered in the
text. Ooops.
address@hidden
address@hidden vettori} ha illustrato una funzione che ispezionava un vettore
+multidimensionale per stamparlo. Comunque, ispezionare un vettore ed elaborare
+ogni elemento @`e un'operazione generica. Generalizzare la funzione
address@hidden()} agggiungendo un parametro aggiuntivo chiamato
address@hidden
+
+Quindi, all'interno del ciclo, invece di stampare l'indice e il valore
+dell'elemento del vettore, usare la sintassi della chiamata indiretta a una
+funzione (@pxref{Chiamate indirette})
+su @code{elab}, passandole l'indice e il valore.
+
+Nel chiamare @code{walk_array()}, si passa il nome di una
+funzione definita dall'utente che aspetta di ricevere un indice e un valore
+per poi elaborare l'elemento.
+
+Verificare la nuova versione stampando il vettore; si dovrebbe ottenere un
+output identico a quello della versione originale.
address@hidden ignore
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden Programmi di esempio
address@hidden Programmi utili scritti in @command{awk}
address@hidden @command{awk}, programmi, esempi di
address@hidden programmi @command{awk}, esempi di
address@hidden esempi di programmi @command{awk}
+
address@hidden FULLXREF ON
address@hidden
+Il
address@hidden iftex
address@hidden di libreria},
+ha prospettato l'idea che la lettura di programmi scritti in un certo
+linguaggio possa aiutare a imparare quel linguaggio. Questo
address@hidden ripropone lo stesso tema, presentando una miscellanea di
+programmi @command{awk} per il piacere di leggerli.
address@hidden FULLXREF OFF
address@hidden
+Ci sono tre @value{SECTIONS}.
+La prima spiega come eseguire i programmi descritti in questo
address@hidden
+
+La seconda illustra la versione @command{awk}
+di parecchi comuni programmi di address@hidden disponibili in POSIX.
+Si presuppone che si abbia address@hidden una certa address@hidden con questi
programmi,
+e che quindi i problemi a loro legati siano facilmente comprensibili.
+Riscrivendo questi programmi in @command{awk},
+ci si address@hidden focalizzare sulle address@hidden di @command{awk} nella
+risoluzione dei problemi di programmazione.
+
+La terza sezione @`e una collezione di programmi interessanti.
+Essi mirano a risolvere un certo numero di differenti problemi di
+manipolazione e di gestione dati. Molti dei programmi sono brevi, per
+evidenziare la address@hidden di @command{awk} di fare molte cose usando solo
+poche righe di codice.
address@hidden ifnotinfo
+
+Molti di questi programmi usano le funzioni di libreria che sono state
presentate
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria}.
+
address@hidden
+* Eseguire esempi:: Come eseguire questi esempi.
+* Cloni:: Cloni di programmi di address@hidden comuni.
+* Programmi vari:: Alcuni interessanti programmi in
+ @command{awk}.
+* Sommario dei programmi:: Sommario dei programmi.
+* Esercizi sui programmi:: Esercizi.
address@hidden menu
+
address@hidden Eseguire esempi
address@hidden Come eseguire i programmi di esempio.
+
+
+Per eseguire un dato programma, si procederebbe tipicamente
address@hidden@dotless{i}}:
+
address@hidden
+awk -f @var{programma} -- @var{opzioni} @var{file}
address@hidden example
+
address@hidden
+Qui, @var{programma} @`e il nome del programma @command{awk} (p.es.
address@hidden), @var{opzioni} sono le opzioni sulla riga di comando
+per il programma che iniziano con un @samp{-}, e @var{file} sono i
address@hidden in input.
+
+Se il sistema prevede il meccanismo @samp{#!} di specifica di un
address@hidden
+(@address@hidden eseguibili}),
+si address@hidden invece eseguire direttamente un programma:
+
address@hidden
+cut.awk -c1-8 i_miei_file > risultati
address@hidden example
+
+Se @command{awk} non @`e @command{gawk}, address@hidden invece essere
necessario usare:
+
address@hidden
+cut.awk -- -c1-8 i_miei_file > risultati
address@hidden example
+
address@hidden Cloni
address@hidden Reinventare la ruota per divertimento e profitto
address@hidden programmi POSIX, implementazione in @command{awk}
address@hidden POSIX, programmi, implementazione in @command{awk}
+
+Questa @value{SECTION} presenta un certo numero di programmi di address@hidden
+POSIX implementati in @command{awk}. Riscrivere questi programmi in
address@hidden @`e spesso divertente,
+perch@'e gli algoritmi possono essere espressi molto chiaramente, e il codice
address@hidden normalmente molto semplice e conciso. address@hidden @`e
possibile perch@'e @command{awk}
+facilita molto le cose al programmatore.
+
+Va precisato che questi programmi non sono necessariamente scritti per
+sostituire le versioni installate sul sistema in uso.
+Inoltre, nessuno di questi programmi @`e del tutto aderente ai address@hidden
recenti
+standard POSIX. Questo non @`e un problema; il loro scopo
address@hidden di illustrare la programmazione in linguaggio @command{awk} che
serve nel
+``mondo reale''.
+
+I programmi sono presentati in ordine alfabetico.
+
address@hidden
+* Programma cut:: Il programma di address@hidden @command{cut}.
+* Programma egrep:: Il programma di address@hidden
@command{egrep}.
+* Programma id:: Il programma di address@hidden @command{id}.
+* Programma split:: Il programma di address@hidden
@command{split}.
+* Programma tee:: Il programma di address@hidden @command{tee}.
+* Programma uniq:: Il programma di address@hidden
@command{uniq}.
+* Programma wc:: Il programma di address@hidden @command{wc}.
address@hidden menu
+
address@hidden Programma cut
address@hidden Ritagliare campi e colonne
+
address@hidden @command{cut}, programma di address@hidden
address@hidden programma di address@hidden @command{cut}
address@hidden campi, ritagliare
address@hidden colonne, ritagliare
+Il programma di address@hidden @command{cut} seleziona, o ``taglia''
(@dfn{cut}),
+caratteri o campi dal suo standard input e li
+spedisce al suo standard output.
+I campi sono separati da caratteri TAB per default,
+ma @`e possibile fornire un'opzione dalla riga di comando per cambiare il campo
address@hidden (address@hidden, il carattere che separa i campi). La
definizione di
+campo di @command{cut} @`e meno generale di quella di @command{awk}.
+
+Un uso comune del comando @command{cut} potrebbe essere quello di estrarre
+i nomi degli utenti correntemente collegati al sistema, a partire
+dall'output del comando @command{who}. Per esempio, la seguente
+pipeline genera una lista in ordine alfabetico, senza doppioni, degli utenti
+correntemente collegati al sistema:
+
address@hidden
+who | cut -c1-8 | sort | uniq
address@hidden example
+
+Le opzioni per @command{cut} sono:
+
address@hidden @code
address@hidden -c @var{lista}
+Usare @var{lista} come lista di caratteri da ritagliare. Elementi
+all'interno della lista
+possono essere separati da virgole, e intervalli di caratteri possono essere
+separated da trattini. La lista
address@hidden,15,22-35} specifica i caratteri da 1 a 8, 15, e da 22 a 35.
+
address@hidden -f @var{lista}
+Usare @var{lista} come lista di campi da ritagliare.
+
address@hidden -d @var{delimitatore}
+Usare @var{delimitatore} come carattere che separa i campi invece del
+carattere TAB.
+
address@hidden -s
+Evita la stampa di righe che non contengono il delimitatore di campo.
address@hidden table
+
+L'implementazione @command{awk} del comando @command{cut} usa la funzione
+di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e la funzione di libreria @code{join()}
+(@pxref{Funzione join}).
+
+Il programma inizia con un commento che descrive le opzioni, le funzioni
+di libreria necessarie, e una funzione @code{sintassi()} che stampa un
+messaggio ed esce. @code{sintassi()} @`e chiamato se si specificano degli
+argomenti non validi:
+
address@hidden @code{cut.awk}, programma
address@hidden programma @code{cut.awk}
address@hidden
address@hidden file eg/prog/cut.awk
+# cut.awk --- implementa cut in awk
address@hidden endfile
address@hidden
address@hidden file eg/prog/cut.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/cut.awk
+
+# Opzioni:
+# -f lista Ritagliare campi
+# -d c Carattere di delimitazione di campo
+# -c lista Ritagliare caratteri
+#
+# -s Sopprimere righe che non contengono il delimitatore
+#
+# Richiede le funzioni di libreria getopt() e join()
+
address@hidden
+function sintassi()
address@hidden
+ print("sintassi: cut [-f lista] [-d c] [-s] [file...]") > "/dev/stderr"
+ print("sintassi: cut [-c lista] [file...]") > "/dev/stderr"
+ exit 1
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, eseguire programmi
@command{awk} e
address@hidden criterio di ricerca @code{BEGIN}, eseguire programmi
@command{awk} e
address@hidden @code{FS}, variabile, eseguire programmi @command{awk} e
address@hidden variabile @code{FS}, eseguire programmi @command{awk} e
+Subito dopo c'@`e una regola @code{BEGIN} che analizza le opzioni della riga
+di comando.
+Questa regola imposta @code{FS} a un solo carattere TAB, perch@'e quello @`e
+il separatore di campo di @command{cut} per default.
+La regola poi imposta il separatore di campo in output allo stesso valore
+del separatore di campo in input. Un ciclo che usa @code{getopt()} esamina
+le opzioni della riga di comando. Una e una sola delle variabili
address@hidden o @code{per_caratteri} @`e impostata a "vero", per indicare
+che l'elaborazione address@hidden fatta per campi o per caratteri,
rispettivamente.
+Quando si ritaglia per caratteri, il separatore di campo in output @`e
+impostato alla stringa nulla:
+
address@hidden
address@hidden file eg/prog/cut.awk
+BEGIN @{
+ FS = "\t" # default
+ OFS = FS
+ while ((c = getopt(ARGC, ARGV, "sf:c:d:")) != -1) @{
+ if (c == "f") @{
+ per_campi = 1
+ lista_campi = Optarg
+ @} else if (c == "c") @{
+ per_caratteri = 1
+ lista_campi = Optarg
+ OFS = ""
+ @} else if (c == "d") @{
+ if (length(Optarg) > 1) @{
+ printf("cut: usa il primo carattere di %s" \
+ " come delimitatore\n", Optarg) > "/dev/stderr"
+ Optarg = substr(Optarg, 1, 1)
+ @}
+ fs = FS = Optarg
+ OFS = FS
+ if (FS == " ") # mette specifica in formato awk
+ FS = "[ ]"
+ @} else if (c == "s")
+ sopprimi = 1
+ else
+ sintassi()
+ @}
+
+ # Toglie opzioni da riga di comando
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
address@hidden endfile
address@hidden example
+
address@hidden separatori di campo, spazi come
address@hidden spazi come separatori di campo
+Nella scrittura del codice si deve porre particolare attenzione quando il
+delimitatore di campo @`e uno spazio. Usare
+un semplice spazio (@address@hidden" "}}) come valore per @code{FS} @`e
+sbagliato: @command{awk} separerebbe i campi con serie di spazi,
+TAB, e/o ritorni a capo, mentre devono essere separati solo da uno spazio.
+Per far questo, salviamo il carattere di spazio originale nella variabile
address@hidden per un uso futuro; dopo aver impostato @code{FS} a @code{"[ ]"}
non
address@hidden possibile usarlo direttamente per vedere se il carattere
delimitatore di
+campo @`e nella stringa.
+
+Si ricordi anche che dopo che si @`e finito di usare @code{getopt()}
+(come descritto nella @ref{Funzione getopt}),
address@hidden necessario
+eliminare tutti gli elementi del vettore @code{ARGV} da 1 a @code{Optind},
+in modo che @command{awk} non tenti di elaborare le opzioni della riga di
comando
+come @value{FNS}.
+
+Dopo aver elaborato le opzioni della riga di comando, il programma verifica
+che le opzioni siano coerenti. Solo una tra le opzioni @option{-c}
+e @option{-f} dovrebbe essere presente, ed entrambe richiedono una lista di
+campi. Poi il programma chiama
address@hidden()} oppure @code{prepara_lista_caratteri()} per
+preparare la lista dei campi o dei caratteri:
+
address@hidden
address@hidden file eg/prog/cut.awk
+ if (per_campi && per_caratteri)
+ sintassi()
+
+ if (per_campi == 0 && per_caratteri == 0)
+ per_campi = 1 # default
+
+ if (lista_campi == "") @{
+ print "cut: specificare lista per -c o -f" > "/dev/stderr"
+ exit 1
+ @}
+
+ if (per_campi)
+ prepara_lista_campi()
+ else
+ prepara_lista_caratteri()
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden()} pone la lista campi, usando la virgola come
+separatore, in un vettore. Poi, per
+ogni elemento del vettore, controlla che esso non sia un intervallo. Se @`e
+un intervallo, lo fa diventare un elenco. La funzione controlla l'intervallo
+specificato, per assicurarsi che il primo numero sia minore del secondo.
+Ogni numero nella lista @`e aggiunto al vettore @code{lista_c}, che
+semplicemente elenca i campi che saranno stampati. Viene usata la normale
+separazione in campi di @command{awk}. Il programma lascia ad @command{awk}
+il compito di separare i campi:
+
address@hidden
address@hidden file eg/prog/cut.awk
+function prepara_lista_campi( n, m, i, j, k, f, g)
address@hidden
+ n = split(lista_campi, f, ",")
+ j = 1 # indice in lista_c
+ for (i = 1; i <= n; i++) @{
+ if (index(f[i], "-") != 0) @{ # un intervallo
+ m = split(f[i], g, "-")
address@hidden
+ if (m != 2 || g[1] >= g[2]) @{
+ printf("cut: lista campi errata: %s\n",
+ f[i]) > "/dev/stderr"
+ exit 1
+ @}
address@hidden group
+ for (k = g[1]; k <= g[2]; k++)
+ lista_c[j++] = k
+ @} else
+ lista_c[j++] = f[i]
+ @}
+ ncampi = j - 1
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{prepara_lista_caratteri()} @`e address@hidden complicata di
address@hidden()}.
+L'idea qui @`e di usare la variabile di @command{gawk} @code{FIELDWIDTHS}
+(@pxref{Dimensione costante}),
+che descrive input a larghezza costante. Quando si usa una lista di
+caratteri questo @`e proprio il nostro caso.
+
+Impostare @code{FIELDWIDTHS} @`e address@hidden complicato che semplicemente
elencare
+i campi da stampare. Si deve tener traccia dei campi da
+stampare e anche dei caratteri che li separano, che vanno saltati.
+Per esempio, supponiamo che si vogliano i caratteri da 1 a 8, 15,
+e da 22 a 35. Per questo si specifica @samp{-c 1-8,15,22-35}. Il valore che
+corrisponde a questo nella variabile @code{FIELDWIDTHS} @`e
address@hidden@w{"8 6 1 6 14"}}. Questi sono cinque campi, e quelli da stampare
+sono @code{$1}, @code{$3}, e @code{$5}.
+I campi intermedi sono @dfn{riempitivo} (@dfn{filler}),
+ossia @`e address@hidden che separa i dati che si desidera estrarre.
address@hidden lista i campi da stampare, e @code{t} traccia l'elenco
+completo dei campi, inclusi i riempitivi:
+
address@hidden
address@hidden file eg/prog/cut.awk
+function prepara_lista_caratteri( campo, i, j, f, g, n, m, t,
+ filler, ultimo, lungo)
address@hidden
+ campo = 1 # contatore totale campi
+ n = split(lista_campi, f, ",")
+ j = 1 # indice in lista_c
+ for (i = 1; i <= n; i++) @{
+ if (index(f[i], "-") != 0) @{ # intervallo
+ m = split(f[i], g, "-")
+ if (m != 2 || g[1] >= g[2]) @{
+ printf("cut: lista caratteri errata: %s\n",
+ f[i]) > "/dev/stderr"
+ exit 1
+ @}
+ lungo = g[2] - g[1] + 1
+ if (g[1] > 1) # calcola lunghezza del riempitivo
+ filler = g[1] - ultimo - 1
+ else
+ filler = 0
address@hidden
+ if (filler)
+ t[campo++] = filler
address@hidden group
+ t[campo++] = lungo # lunghezza del campo
+ ultimo = g[2]
+ lista_c[j++] = campo - 1
+ @} else @{
+ if (f[i] > 1)
+ filler = f[i] - ultimo - 1
+ else
+ filler = 0
+ if (filler)
+ t[campo++] = filler
+ t[campo++] = 1
+ ultimo = f[i]
+ lista_c[j++] = campo - 1
+ @}
+ @}
+ FIELDWIDTHS = join(t, 1, campo - 1)
+ ncampi = j - 1
address@hidden
address@hidden endfile
address@hidden example
+
+Poi viene la regola che elabora i dati. Se l'opzione @option{-s} @`e stata
+specificata, il flag @code{sopprimi}
address@hidden vero. La prima istruzione
address@hidden accerta che il record in input abbia il separatore di
+campo. Se @command{cut} sta elaborando dei campi, e @code{sopprimi} @`e vero,
+e il carattere di separazione dei campi non @`e presente nel record, il
+record @`e ignorato.
+
+Se il record @`e valido, @command{gawk} ha address@hidden separato i dati in
campi,
+usando il carattere in @code{FS} o usando campi a lunghezza fissa
+e @code{FIELDWIDTHS}. Il ciclo scorre attraverso la lista di campi che
+si dovrebbero stampare. Il campo corrispondente @`e stampato se contiene dati.
+Se il campo successivo contiene pure dei dati, il carattere di separazione @`e
+scritto tra i due campi:
+
address@hidden
address@hidden file eg/prog/cut.awk
address@hidden
+ if (per_campi && sopprimi && index($0, fs) == 0)
+ next
+
+ for (i = 1; i <= ncampi; i++) @{
+ if ($lista_c[i] != "") @{
+ printf "%s", $lista_c[i]
+ if (i < ncampi && $lista_c[i+1] != "")
+ printf "%s", OFS
+ @}
+ @}
+ print ""
address@hidden
address@hidden endfile
address@hidden example
+
+Questa versione di @command{cut} utilizza la variabile @code{FIELDWIDTHS} di
address@hidden per ritagliare in base alla posizione dei caratteri. @`E
+possibile, in altre implementazioni di @command{awk} usare @code{substr()}
+(@pxref{Funzioni per stringhe}), ma
+la cosa @`e molto address@hidden complessa.
+La variabile @code{FIELDWIDTHS} fornisce una soluzione elegante al problema
+di suddividere la riga in input in singoli caratteri.
+
+
address@hidden Programma egrep
address@hidden Ricercare espressioni regolari nei file
+
address@hidden espressioni regolari, ricerca di
address@hidden ricercare, in file, espressioni regolari
address@hidden file, ricercare espressioni regolari nei
address@hidden @command{egrep}, programma di address@hidden
address@hidden programma di address@hidden @command{egrep}
+Il programma di address@hidden @command{egrep} ricerca occorrenze di
espressioni
+regolari all'interno di file. Usa
+espressioni regolari che sono quasi identiche a quelle disponibili in
address@hidden
address@hidden (@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
address@hidden (@pxref{Espressioni regolari}).
address@hidden ifnottex
+Si richiama address@hidden@dotless{i}}:
+
address@hidden
address@hidden address@hidden @code{'@var{espressione}'} @var{file} @dots{}
address@hidden display
+
address@hidden @`e un'espressione regolare. Normalmente, l'espressione
+regolare @`e protetta da apici per impedire alla shell di espandere ogni
+carattere speciale come @value{FN}.
+Normalmente, @command{egrep} stampa le righe per cui @`e stata trovata una
+corrispondenza. Se nella riga di comando si richiede di operare su
address@hidden di un
address@hidden, ogni riga in output @`e preceduta dal nome del file, e dal segno
+due punti.
+
+Le opzioni di @command{egrep} sono le seguenti:
+
address@hidden @code
address@hidden -c
+Stampa un contatore delle righe che corrispondono al criterio di ricerca,
+e non le righe stesse.
+
address@hidden -s
+Funziona in silenzio. Non si produce alcun output ma il codice di ritorno
+indica se il criterio di ricerca ha trovato almeno una corrispondenza.
+
address@hidden -v
+Inverte il senso del test. @command{egrep} stampa le righe che
address@hidden soddisfano il criterio di ricerca ed esce con successo se il
+criterio di ricerca non @`e soddisfatto.
+
address@hidden -i
+Ignora maiuscolo/minuscolo sia nel criterio di ricerca che nei dati in input.
+
address@hidden -l
+Stampa (elenca) solo i nomi dei file che corrispondono, e non le righe trovate.
+
address@hidden -e @var{espressione}
+Usa @var{espressione} come @dfn{regexp} da ricercare. Il motivo per cui
address@hidden prevista l'opzione @option{-e} @`e di
+permettere dei criteri di ricerca che
+inizino con un @samp{-}.
address@hidden table
+
+Questa versione usa la funzione di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e il programma di libreria che gestisce il passaggio da un file dati
+al successivo
+(@pxref{Funzione filetrans}).
+
+Il programma inizia con un commento descrittivo e poi c'@`e una regola
address@hidden
+che elabora gli argomenti della riga di comando usando @code{getopt()}.
+L'opzione @option{-i} (ignora maiuscolo/minuscolo) @`e particolarmente facile
+da implementare con @command{gawk}; basta usare la variabile predefinita
address@hidden
+(@pxref{Variabili predefinite}):
+
address@hidden @code{egrep.awk}, programma
address@hidden programma @code{egrep.awk}
address@hidden
address@hidden file eg/prog/egrep.awk
+# egrep.awk --- simula egrep in awk
+#
address@hidden endfile
address@hidden
address@hidden file eg/prog/egrep.awk
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/egrep.awk
+# Opzioni:
+# -c conta le righe trovate
+# -s sileziosa: genera solo il codice di ritorno
+# -v inverte test, successo se @dfn{regexp} non presente
+# -i ignora maiuscolo/minuscolo
+# -l stampa solo nomi file
+# -e espressione da ricercare
+#
+# Richiede la funzione getopt() e il programma di libreria
+# che gestisce il passaggio da un file dati al successivo
+
+BEGIN @{
+ while ((c = getopt(ARGC, ARGV, "ce:svil")) != -1) @{
+ if (c == "c")
+ conta_e_basta++
+ else if (c == "s")
+ non_stampare++
+ else if (c == "v")
+ inverti_test++
+ else if (c == "i")
+ IGNORECASE = 1
+ else if (c == "l")
+ solo_nomi_file++
+ else if (c == "e")
+ criterio_di_ricerca = Optarg
+ else
+ sintassi()
+ @}
address@hidden endfile
address@hidden example
+
+Nel seguito c'@`e il codice che gestisce il comportamento specifico di
address@hidden Se non @`e fornito esplicitamente alcun criterio di ricerca
+tramite l'opzione @option{-e}, si usa il primo argomento sulla riga di
+comando che non sia un'opzione.
+Gli argomenti della riga di comando di @command{awk} fino ad
address@hidden vengono cancellati,
+in modo che @command{awk} non tenti di elaborarli come file. Se
+non @`e stato specificato alcun nome di file, si usa lo standard input, e se
address@hidden presente address@hidden di un nome di file, lo si annota, in
modo che i @value{FNS}
+vengano scritti prima di ogni riga di output corrispondente:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+ if (criterio_di_ricerca == "")
+ criterio_di_ricerca = ARGV[Optind++]
+
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
+ if (Optind >= ARGC) @{
+ ARGV[1] = "-"
+ ARGC = 2
+ @} else if (ARGC - Optind > 1)
+ servono_nomi_file++
+
+# if (IGNORECASE)
+# criterio_di_ricerca = tolower(criterio_di_ricerca)
address@hidden
address@hidden endfile
address@hidden example
+
+Le ultime due righe sono solo dei commenti, in quanto non necessarie in
address@hidden Per altre versioni di
address@hidden, potrebbe essere necessario utilizzarle come istruzioni
+effettive (togliendo il "#").
+
+Il prossimo insieme di righe dovrebbe essere decommentato
+se non si sta usando @command{gawk}.
+Questa regola converte in minuscolo tutti i caratteri della riga in input,
+se @`e stata specificata l'opzione @address@hidden, qui si
+introduce un errore subdolo; se una corrispondenza viene trovata, viene
+inviata in output la riga tradotta, non quella originale.}
+La regola @`e
+commentata perch@'e non @`e necessaria se si usa @command{gawk}:
+
address@hidden
address@hidden file eg/prog/egrep.awk
address@hidden
+# if (IGNORECASE)
+# $0 = tolower($0)
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{a_inizio_file()} @`e chiamata dalla regola in
@file{ftrans.awk}
+quando ogni nuovo file viene elaborato. In questo caso, non c'@`e molto da
fare;
+ci si limita a inizializzare una variabile @code{contatore_file} a zero.
address@hidden serve a ricordare quante righe nel file corrente
+corrispondono al criterio di ricerca.
+Scegliere come nome di parametro @code{da_buttare} indica che sappiamo che
address@hidden()} @`e chiamata con un parametro, ma che noi non siamo
+interessati al suo valore:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+function a_inizio_file(da_buttare)
address@hidden
+ contatore_file = 0
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{endfile()} viene chiamata dopo l'elaborazione di ogni file.
+Ha influenza sull'output solo quando l'utente desidera un contatore del
+numero di righe che sono state individuate. @code{non_stampare} @`e vero nel
+caso si desideri solo il codice di
+ritorno. @code{conta_e_basta} @`e vero se si desiderano solo i contatori
+delle righe trovate. @command{egrep}
+quindi stampa i contatori solo se
+sia la stampa che il conteggio delle righe sono stati abilitati.
+Il formato di output deve tenere conto del numero di file sui quali si
+opera. Per finire, @code{contatore_file} @`e aggiunto a @code{totale}, in
+modo da stabilire qual @`e il numero totale di righe che ha soddisfatto il
+criterio di ricerca:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+function endfile(file)
address@hidden
+ if (! non_stampare && conta_e_basta) @{
+ if (servono_nomi_file)
+ print file ":" contatore_file
+ else
+ print contatore_file
+ @}
+
+ totale += contatore_file
address@hidden
address@hidden endfile
address@hidden example
+
+Si potrebbero usare i criteri di ricerca speciali @code{BEGINFILE} ed
address@hidden
+(@pxref{BEGINFILE/ENDFILE}),
+ma in quel caso il programma funzionerebbe solo usando @command{gawk}.
+Inoltre, questo esempio @`e stato scritto prima che a @command{gawk} venissero
+aggiunti i criteri speciali @code{BEGINFILE} ed @code{ENDFILE}.
+
+La regola seguente fa il grosso del lavoro per trovare righe corrispondenti
+al criterio di ricerca fornito. La variabile
address@hidden @`e vera se la riga @`e individuata dal criterio di ricerca.
+Se l'utente chiede invece le righe che non corrispondono, il senso di
address@hidden @`e invertito, usando l'operatore @samp{!}.
address@hidden @`e incrementato con il valore di
address@hidden, che vale uno o zero, a seconda che la corrispondenza sia
+stata trovata oppure no. Se la riga non corrisponde, l'istruzione
address@hidden passa ad esaminare il record successivo.
+
+Vengono effettuati anche altri controlli, ma soltanto se non
+si sceglie di contare le righe. Prima di tutto, se l'utente desidera solo
+il codice di ritorno (@code{non_stampare} @`e vero), @`e sufficiente sapere
+che @emph{una} riga nel file corrisponde, e si address@hidden passare al file
successivo
+usando @code{nextfile}. Analogamente, se stiamo solo stampando @value{FNS},
+possiamo stampare il @value{FN}, e quindi saltare al file successivo con
address@hidden
+Infine, ogni riga viene stampata, preceduta, se necessario, dal @value{FN} e
+dai due punti:
+
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden
address@hidden file eg/prog/egrep.awk
address@hidden
+ corrisponde = ($0 ~ criterio_di_ricerca)
+ if (inverti_test)
+ corrisponde = ! corrisponde
+
+ contatore_file += corrisponde # 1 o 0
+
+ if (! corrisponde)
+ next
+
+ if (! conta_e_basta) @{
+ if (non_stampare)
+ nextfile
+
+ if (solo_nomi_file) @{
+ print nome_file
+ nextfile
+ @}
+
+ if (servono_nomi_file)
+ print nome_file ":" $0
+ else
+ print
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+La regola @code{END} serve a produrre il codice di ritorno corretto. Se
+non ci sono corrispondenze, il codice di ritorno @`e uno; altrimenti, @`e zero:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+END @{
+ exit (totale == 0)
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{sintassi()} stampa un messaggio per l'utente, nel caso
+siano state specificate opzioni non valide, e quindi esce:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+function sintassi()
address@hidden
+ print("sintassi: egrep [-csvil] [-e criterio_di_ricerca] [file ...]")\
+ > "/dev/stderr"
+ print("\n\tegrep [-csvil] criterio_di_ricerca [file ...]") > "/dev/stderr"
+ exit 1
address@hidden
address@hidden endfile
address@hidden example
+
+
address@hidden Programma id
address@hidden Stampare informazioni sull'utente
+
address@hidden stampare informazioni utente
address@hidden utenti, informazioni riguardo agli, stampare
address@hidden @command{id}, programma di address@hidden
address@hidden programma di address@hidden @command{id}
+Il programma di address@hidden @command{id} elenca i numeri identificativi (ID)
+reali ed effettivi di un utente, e l'insieme dei gruppi a cui l'utente
+appartiene, se ve ne sono.
address@hidden stampa i numeri identificativi di utente e di gruppo solo se
+questi sono differenti da quelli reali. Se possibile, @command{id} elenca
+anche i corrispondenti nomi di utente e di gruppo.
+L'output potrebbe essere simile a questo:
+
address@hidden
+$ @kbd{id}
address@hidden uid=1000(arnold) gid=1000(arnold)
groups=1000(arnold),4(adm),7(lp),27(sudo)
address@hidden example
+
address@hidden @code{PROCINFO}, vettore, e @dfn{process ID} di utente e di
gruppo
+Questa informazione @`e parte di address@hidden che @`e reso disponibile dal
vettore
address@hidden di @command{gawk} (@pxref{Variabili predefinite}).
+Comunque, il programma di address@hidden @command{id} fornisce un output
address@hidden
+comprensibile che non una semplice lista di numeri.
+
+Ecco una versione semplice di @command{id} scritta in @command{awk}.
+Usa le funzioni di libreria che riguardano il database degli utenti
+(@pxref{Funzioni Passwd})
+e le funzioni di libreria che riguardano il database dei gruppi
+(@pxref{Funzioni Group})
+contenute
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria}.
+
+Il programma @`e abbastanza semplice. Tutto il lavoro @`e svolto nella regola
address@hidden I numeri ID di utente e di gruppo sono ottenuti da
address@hidden
+Il codice @`e ripetitivo. La riga nel database degli utenti che descrive
+l'ID reale dell'utente @`e divisa in parti, separate tra loro da @samp{:}.
+Il nome @`e il primo campo. Un codice analogo @`e usato per l'ID effettivo, e
+per i numeri che descrivono i gruppi:
+
address@hidden @code{id.awk}, programma
address@hidden programma @code{id.awk}
address@hidden
address@hidden file eg/prog/id.awk
+# id.awk --- implement id in awk
+#
+# Richiede funzioni di libreria per utente e gruppo
address@hidden endfile
address@hidden
address@hidden file eg/prog/id.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised February 1996
+# Revised May 2014
+# Revised September 2014
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/id.awk
+# l'output @`e:
+# uid=12(pippo) euid=34(pluto) gid=3(paperino) \
+# egid=5(paperina) groups=9(nove),2(due),1(uno)
+
address@hidden
+BEGIN @{
+ uid = PROCINFO["uid"]
+ euid = PROCINFO["euid"]
+ gid = PROCINFO["gid"]
+ egid = PROCINFO["egid"]
address@hidden group
+
+ printf("uid=%d", uid)
+ pw = getpwuid(uid)
+ stampa_primo_campo(pw)
+
+ if (euid != uid) @{
+ printf(" euid=%d", euid)
+ pw = getpwuid(euid)
+ stampa_primo_campo(pw)
+ @}
+
+ printf(" gid=%d", gid)
+ pw = getgrgid(gid)
+ stampa_primo_campo(pw)
+
+ if (egid != gid) @{
+ printf(" egid=%d", egid)
+ pw = getgrgid(egid)
+ stampa_primo_campo(pw)
+ @}
+
+ for (i = 1; ("group" i) in PROCINFO; i++) @{
+ if (i == 1)
+ printf(" gruppi=")
+ group = PROCINFO["group" i]
+ printf("%d", group)
+ pw = getgrgid(group)
+ stampa_primo_campo(pw)
+ if (("group" (i+1)) in PROCINFO)
+ printf(",")
+ @}
+
+ print ""
address@hidden
+
+function stampa_primo_campo(str, a)
address@hidden
+ if (str != "") @{
+ split(str, a, ":")
+ printf("(%s)", a[1])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Il test incluso nel ciclo @code{for} @`e degno di nota.
+Ogni ulteriore gruppo nel vettore @code{PROCINFO} ha come indice da
address@hidden"group1"} a @code{"address@hidden"} dove il numero
address@hidden @`e il numero totale di gruppi ulteriori).
+Tuttavia, non si sa quanti di questi gruppi ci siano per un dato utente.
+
+Questo ciclo inizia da uno, concatena il valore di ogni iterazione con
address@hidden"group"}, e poi usando l'istruzione @code{in} verifica se quella
+chiave @`e nel vettore (@pxref{Visitare elementi}). Quando @code{i} @`e
+incrementato oltre l'ultimo gruppo presente nel vettore, il ciclo termina.
+
+Il ciclo funziona correttamente anche se @emph{non} ci sono ulteriori
+gruppi; in quel caso la condizione risulta falsa fin dal primo controllo, e
+il corpo del ciclo non viene mai eseguito.
+
+La funzione @code{stampa_primo_campo()} semplicemente incapsula quelle parti di
+codice che vengono usate ripetutamente, rendendo il programma address@hidden
conciso e
+ordinato.
+In particolare, inserendo in questa funzione il test per la stringa nulla
+consente di risparmiare parecchie righe di programma.
+
+
address@hidden Programma split
address@hidden Suddividere in pezzi un file grosso
+
address@hidden FIXME: One day, update to current POSIX version of split
+
address@hidden file, splitting
address@hidden @code{split}, programma di address@hidden
address@hidden programma di address@hidden @code{split}
+Il programma @command{split} divide grossi file di testo in pezzi
address@hidden piccoli.
+La sua sintassi @`e la seguente:@footnote{Questo @`e la sintassi tradizionale.
+La versione POSIX del comando ha una sintassi differente, ma per lo scopo di
+questo programma @command{awk} la cosa non ha importanza.}
+
address@hidden
address@hidden address@hidden@var{contatore}}] address@hidden address@hidden
address@hidden display
+
+Per default,
+i file di output avranno nome @file{xaa}, @file{xab}, e
address@hidden@dotless{i}} via. Ogni file
+contiene 1.000 righe, con la probabile
+eccezione dell'ultimo file. Per
+cambiare il numero di righe in ogni file, va indicato un numero sulla riga
+di comando, preceduto da un segno meno (p.es., @samp{-500} per file con 500
+righe ognuno invece che 1.000). Per modificare i nomi dei file di output in
+qualcosa del tipo
address@hidden, @file{miofileab}, e address@hidden@dotless{i}} via, va indicato
un argomento
+ulteriore che specifica il prefisso del @value{FN}.
+
+Ecco una versione di @command{split} in @command{awk}. Usa le funzioni
address@hidden()} e @code{chr()} descritte nella
address@hidden ordinali}.
+
+Il programma dapprima imposta i suoi valori di default, e poi controlla che
+non siano stati specificati troppi argomenti. Quindi esamina gli argomenti
+uno alla volta. Il primo
+argomento potrebbe essere un segno meno seguito da un numero. Poich@'e il
+numero in questione address@hidden apparire negativo, lo si fa diventare
positivo, e
+viene usato per contare le righe. Il nome del @value{DF} @`e per ora ignorato
+e l'ultimo argomento @`e usato come prefisso per i @value{FNS} in output:
+
address@hidden @code{split.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{split.awk}
address@hidden
address@hidden file eg/prog/split.awk
+# split.awk --- comando split scritto in awk
+#
+# Richiede le funzioni di libreria ord() e chr()
address@hidden endfile
address@hidden
address@hidden file eg/prog/split.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised slightly, May 2014
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/split.awk
+# sintassi: split [-contatore] [file] [nome_in_output]
+
+BEGIN @{
+ outfile = "x" # default
+ contatore = 1000
+ if (ARGC > 4)
+ sintassi()
+
+ i = 1
+ if (i in ARGV && ARGV[i] ~ /^-[[:digit:]]+$/) @{
+ contatore = -ARGV[i]
+ ARGV[i] = ""
+ i++
+ @}
+ # testa argv nel caso che si legga da stdin invece che da file
+ if (i in ARGV)
+ i++ # salta nome file-dati
+ if (i in ARGV) @{
+ outfile = ARGV[i]
+ ARGV[i] = ""
+ @}
+
+ s1 = s2 = "a"
+ out = (outfile s1 s2)
address@hidden
address@hidden endfile
address@hidden example
+
+La regola seguente fa il grosso del lavoro. @code{contatore_t}
+(contatore temporaneo) tiene conto di
+quante righe sono state stampate sul file di output finora. Se questo
+numero supera il valore di @code{contatore}, @`e ora di chiudere il file
+corrente e di iniziare a scriverne uno nuovo.
+Le variabili @code{s1} e @code{s2} sono usate per creare i suffissi
+da apporre a @value{FN}. Se entrambi arrivano al valore @samp{z}, il file
address@hidden troppo grosso. Altrimenti, @code{s1} passa alla successiva
lettera
+dell'alfabeto e @code{s2} ricomincia da @samp{a}:
+
address@hidden else on separate line here for page breaking
address@hidden
address@hidden file eg/prog/split.awk
address@hidden
+ if (++contatore_t > contatore) @{
+ close(out)
+ if (s2 == "z") @{
+ if (s1 == "z") @{
+ printf("split: %s @`e troppo grosso da suddividere\n",
+ nome_file) > "/dev/stderr"
+ exit 1
+ @}
+ s1 = chr(ord(s1) + 1)
+ s2 = "a"
+ @}
address@hidden
+ else
+ s2 = chr(ord(s2) + 1)
address@hidden group
+ out = (outfile s1 s2)
+ contatore_t = 1
+ @}
+ print > out
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+La funzione @code{sintassi()} stampa solo un messaggio di errore ed esce:
+
address@hidden
address@hidden file eg/prog/split.awk
+function sintassi()
address@hidden
+ print("sintassi: split [-num] [file] [nome_in_output]") > "/dev/stderr"
+ exit 1
address@hidden
address@hidden endfile
address@hidden example
+
+Questo programma @`e un po' approssimativo; conta sul fatto che @command{awk}
chiuda
+automaticamente l'ultimo file invece di farlo in una regola @code{END}.
+Un altro presupposto del programma @`e che le lettere dell'alfabeto siano
+in posizioni consecutive nella codifica in uso, il che non @`e vero per i
+sistemi che usano la codifica EBCDIC.
+
address@hidden FOR_PRINT
+Si potrebbe pensare a come eliminare l'uso di
address@hidden()} e @code{chr()}; la cosa si address@hidden fare in modo tale
da risolvere
+anche il problema posto dalla codifica EBCDIC.
address@hidden ifset
+
+
address@hidden Programma tee
address@hidden Inviare l'output su address@hidden di un file
+
address@hidden file, address@hidden duplicare l'output su
address@hidden output, duplicarlo su address@hidden file
address@hidden @code{tee}, programma di address@hidden
address@hidden programma di address@hidden @code{tee}
+Il programma @code{tee} @`e noto come @dfn{pipe fitting} (tubo secondario).
address@hidden copia il suo standard input al suo standard output e inoltre lo
+duplica scrivendo sui file indicati nella riga di comando. La sua sintassi
address@hidden la seguente:
+
address@hidden
address@hidden address@hidden @var{file} @dots{}
address@hidden display
+
+L'opzione @option{-a} chiede a @code{tee} di aggiungere in fondo al file
+indicato, invece che riscriverlo dall'inizio.
+
+La regola @code{BEGIN} dapprima fa una copia di tutti gli argomenti presenti
+sulla riga di comando, in un vettore di nome @code{copia}.
address@hidden non serve, e quindi non viene copiato.
address@hidden non address@hidden usare @code{ARGV} direttamente, perch@'e
@command{awk} tenta
+di elaborare ogni @value{FN} in @code{ARGV} come dati in input.
+
address@hidden flag, variabili di tipo
address@hidden variabili di tipo indicatore address@hidden
+Se il primo argomento @`e @option{-a}, la variabile flag
address@hidden viene impostata a vero, e sia @code{ARGV[1]} che
address@hidden vengono cancellati. Se @code{ARGC} @`e minore di due, nessun
address@hidden @`e stato fornito, e @code{tee} stampa un messaggio di sintassi
ed
+esce.
+Infine, @command{awk} viene obbligato a leggere lo standard input
+impostando @code{ARGV[1]} al valore @code{"-"} e @code{ARGC} a due:
+
address@hidden @code{tee.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{tee.awk}
address@hidden
address@hidden file eg/prog/tee.awk
+# tee.awk --- tee in awk
+#
+# Copia lo standard input a tutti i file di output indicati.
+# Aggiunge in fondo se viene data l'opzione -a.
+#
address@hidden endfile
address@hidden
address@hidden file eg/prog/tee.awk
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised December 1995
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/tee.awk
+BEGIN @{
+ for (i = 1; i < ARGC; i++)
+ copia[i] = ARGV[i]
+
+ if (ARGV[1] == "-a") @{
+ append = 1
+ delete ARGV[1]
+ delete copia[1]
+ ARGC--
+ @}
+ if (ARGC < 2) @{
+ print "sintassi: tee [-a] file ..." > "/dev/stderr"
+ exit 1
+ @}
+ ARGV[1] = "-"
+ ARGC = 2
address@hidden
address@hidden endfile
address@hidden example
+
+La seguente regola @`e sufficiente da sola a eseguire il lavoro. Poich@'e non
@`e
+presente alcun criterio di ricerca, la regola @`e eseguita per ogni riga di
+input. Il corpo della regola si limita a stampare la riga su ogni file
+indicato nella riga di comando, e poi sullo standard output:
+
address@hidden
address@hidden file eg/prog/tee.awk
address@hidden
+ # spostare l'if fuori dal ciclo ne velocizza l'esecuzione
+ if (append)
+ for (i in copia)
+ print >> copia[i]
+ else
+ for (i in copia)
+ print > copia[i]
+ print
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
address@hidden anche possibile scrivere il ciclo address@hidden@dotless{i}}:
+
address@hidden
+for (i in copia)
+ if (append)
+ print >> copia[i]
+ else
+ print > copia[i]
address@hidden example
+
address@hidden
+Questa forma @`e address@hidden concisa, ma anche meno efficiente.
L'@samp{if} @`e
+eseguito per ogni record e per ogni file di output. Duplicando il corpo
+del ciclo, l'@samp{if} @`e eseguito solo una volta per ogni record in input.
+Se ci sono
address@hidden record in input e @var{M} file di output, il primo metodo esegue
solo
address@hidden istruzioni @samp{if}, mentre il secondo esegue
address@hidden@address@hidden istruzioni @samp{if}.
+
+Infine, la regola @code{END} fa pulizia, chiudendo tutti i file di output:
+
address@hidden
address@hidden file eg/prog/tee.awk
+END @{
+ for (i in copia)
+ close(copia[i])
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma uniq
address@hidden Stampare righe di testo non duplicate
+
address@hidden FIXME: One day, update to current POSIX version of uniq
+
address@hidden stampare righe di testo non duplicate
address@hidden address@hidden stampare, righe non duplicate di
address@hidden @command{uniq}, programma di address@hidden
address@hidden programma di address@hidden @command{uniq}
+Il programma di address@hidden @command{uniq} legge righe di dati ordinati sul
suo
+standard input, e per default rimuove righe duplicate. In altre parole,
+stampa solo righe uniche; da cui il
+nome. @command{uniq} ha diverse opzioni. La sintassi @`e la seguente:
+
address@hidden
address@hidden address@hidden address@hidden@var{n}}]] address@hidden@var{n}}]
address@hidden address@hidden
address@hidden display
+
+Le opzioni per @command{uniq} sono:
+
address@hidden @code
address@hidden -d
+Stampa solo righe ripetute (duplicate).
+
address@hidden -u
+Stampa solo righe non ripetute (uniche).
+
address@hidden -c
+Contatore righe. Quest'opzione annulla le opzioni @option{-d} e @option{-u}.
+Sia le righe ripetute che quelle non ripetute vengono contate.
+
address@hidden address@hidden
+Salta @var{n} campi prima di confrontare le righe. La definizione di campo
address@hidden simile al default di @command{awk}: caratteri non bianchi,
separati da
+sequenze di spazi e/o TAB.
+
address@hidden address@hidden
+Salta @var{n} caratteri prima di confrontare le righe. Eventuali campi
+specificati con @address@hidden sono saltati prima.
+
address@hidden @var{file_input}
+I dati sono letti dal file in input specificato sulla riga di comando, invece
+che dallo standard input.
+
address@hidden @var{file_output}
+L'output generato @`e scritto sul file di output specificato, invece che sullo
+standard output.
address@hidden table
+
+Normalmente @command{uniq} si comporta come se siano state specificate entrambe
+le opzioni @option{-d} e @option{-u}.
+
address@hidden usa la
+funzione di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e la funzione di libreria @code{join()}
+(@pxref{Funzione join}).
+
+Il programma inizia con una funzione @code{sintassi()} e poi con una breve
+spiegazione delle opzioni e del loro significato, sotto forma di commenti.
+La regola @code{BEGIN} elabora gli argomenti della riga di comando e le
+opzioni. Viene usato un artificio per poter impiegare @code{getopt()} con
+opzioni della forma @samp{-25},
+trattando quest'opzione come la lettera di opzione @samp{2} con
+l'argomento @samp{5}. Se si specificano due o address@hidden cifre
(@code{Optarg}
+sembra essere numerico), @code{Optarg} @`e concatenato con la cifra che
+costituisce l'opzione e poi al risultato @`e addizionato zero, per trasformarlo
+in un numero. Se c'@`e solo una cifra nell'opzione, @code{Optarg} non @`e
+necessario. In tal caso, @code{Optind} dev'essere decrementata, in modo che
address@hidden()} la elabori quando viene nuovamente richiamato. Questo codice
address@hidden sicuramente un po' intricato.
+
+Se non sono specificate opzioni, per default si stampano sia le righe
+ripetute che quelle non ripetute. Il file di output, se specificato, @`e
+assegnato a @code{file_output}. In precedenza, @code{file_output} @`e
+inizializzato allo standard output, @file{/dev/stdout}:
+
address@hidden @code{uniq.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{uniq.awk}
address@hidden
address@hidden file eg/prog/uniq.awk
address@hidden
+# uniq.awk --- implementa uniq in awk
+#
+# Richiede le funzioni di libreria getopt() e join()
address@hidden group
address@hidden endfile
address@hidden
address@hidden file eg/prog/uniq.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/uniq.awk
+
+function sintassi()
address@hidden
+ print("sintassi: uniq [-udc [-n]] [+n] [ in [ out ]]") > "/dev/stderr"
+ exit 1
address@hidden
+
+# -c contatore di righe. prevale su -d e -u
+# -d solo righe ripetute
+# -u solo righe non ripetute
+# -n salta n campi
+# +n salta n caratteri, salta prima eventuali campi
+
+BEGIN @{
+ contatore = 1
+ file_output = "/dev/stdout"
+ opts = "udc0:1:2:3:4:5:6:7:8:9:"
+ while ((c = getopt(ARGC, ARGV, opts)) != -1) @{
+ if (c == "u")
+ solo_non_ripetute++
+ else if (c == "d")
+ solo_ripetute++
+ else if (c == "c")
+ conta_record++
+ else if (index("0123456789", c) != 0) @{
+ # getopt() richiede argomenti per le opzioni
+ # questo consente di gestire cose come -5
+ if (Optarg ~ /^[[:digit:]]+$/)
+ contatore_file = (c Optarg) + 0
+ else @{
+ contatore_file = c + 0
+ Optind--
+ @}
+ @} else
+ sintassi()
+ @}
+
+ if (ARGV[Optind] ~ /^\+[[:digit:]]+$/) @{
+ conta_caratteri = substr(ARGV[Optind], 2) + 0
+ Optind++
+ @}
+
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
+
+ if (solo_ripetute == 0 && solo_non_ripetute == 0)
+ solo_ripetute = solo_non_ripetute = 1
+
+ if (ARGC - Optind == 2) @{
+ file_output = ARGV[ARGC - 1]
+ ARGV[ARGC - 1] = ""
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione seguente, @code{se_sono_uguali()}, confronta la riga corrente,
address@hidden, con la riga precedente, @code{ultima}. Gestisce il salto di
+campi e caratteri. Se non sono stati richiesti n@'e contatori di campo n@'e
+contatori di carattere, @code{se_sono_uguali()} restituisce uno o zero a
+seconda del risultato di un semplice confronto tra le stringhe @code{ultima}
+e @code{$0}.
+
+In caso contrario, le cose si complicano. Se devono essere saltati dei campi,
+ogni riga viene suddivisa in un vettore, usando @code{split()}
+(@pxref{Funzioni per stringhe}); i campi desiderati sono poi nuovamente uniti
in
+un'unica riga usando @code{join()}. Le righe ricongiunte vengono
+immagazzinate in @code{campi_ultima} e @code{campi_corrente}. Se non ci
+sono campi da saltare, @code{campi_ultima} e @code{campi_corrente} sono
+impostati a @code{ultima} e @code{$0}, rispettivamente. Infine, se
+occorre saltare dei caratteri, si usa @code{substr()} per eliminare i primi
address@hidden caratteri in @code{campi_ultima} e
address@hidden Le due stringhe sono poi confrontare e
address@hidden()} restituisce il risultato del confronto:
+
address@hidden
address@hidden file eg/prog/uniq.awk
+function se_sono_uguali( n, m, campi_ultima, campi_corrente,\
+vettore_ultima, vettore_corrente)
address@hidden
+ if (contatore_file == 0 && conta_caratteri == 0)
+ return (ultima == $0)
+
+ if (contatore_file > 0) @{
+ n = split(ultima, vettore_ultima)
+ m = split($0, vettore_corrente)
+ campi_ultima = join(vettore_ultima, contatore_file+1, n)
+ campi_corrente = join(vettore_corrente, contatore_file+1, m)
+ @} else @{
+ campi_ultima = ultima
+ campi_corrente = $0
+ @}
+ if (conta_caratteri) @{
+ campi_ultima = substr(campi_ultima, conta_caratteri + 1)
+ campi_corrente = substr(campi_corrente, conta_caratteri + 1)
+ @}
+
+ return (campi_ultima == campi_corrente)
address@hidden
address@hidden endfile
address@hidden example
+
+Le due regole seguenti sono il corpo del programma. La prima @`e eseguita solo
+per la prima riga dei dati. Imposta @code{ultima} al record corrente
address@hidden, in modo che le righe di testo successive abbiano qualcosa con
cui
+essere confrontate.
+
+La seconda regola fa il lavoro. La variabile @code{uguale} vale uno o zero,
+a seconda del risultato del confronto effettuato in @code{se_sono_uguali()}.
+Se @command{uniq} sta contando le righe ripetute, e le righe sono uguali,
+viene incrementata la variabile @code{contatore}.
+Altrimenti, viene stampata la riga e azzerato @code{contatore},
+perch@'e le due righe non sono uguali.
+
+Se @command{uniq} non sta contando, e se le righe sono uguali,
address@hidden @`e incrementato.
+Non viene stampato niente, perch@'e l'obiettivo @`e quello di rimuovere i
duplicati.
+Altrimenti, se @command{uniq} sta contando le righe ripetute e viene trovata
address@hidden
+di una riga, o se @command{uniq} sta contando le righe non ripetute
+e viene trovata solo una riga, questa riga viene stampata, e @code{contatore}
@`e
+azzerato.
+
+Infine, una logica simile @`e usata nella regola @code{END} per stampare
+l'ultima riga di dati in input:
+
address@hidden
address@hidden file eg/prog/uniq.awk
+NR == 1 @{
+ ultima = $0
+ next
address@hidden
+
address@hidden
+ uguale = se_sono_uguali()
+
+ if (conta_record) @{ # prevale su -d e -u
+ if (uguale)
+ contatore++
+ else @{
+ printf("%4d %s\n", contatore, ultima) > file_output
+ ultima = $0
+ contatore = 1 # reset
+ @}
+ next
+ @}
+
+ if (uguale)
+ contatore++
+ else @{
+ if ((solo_ripetute && contatore > 1) ||
+ (solo_non_ripetute && contatore == 1))
+ print ultima > file_output
+ ultima = $0
+ contatore = 1
+ @}
address@hidden
+
+END @{
+ if (conta_record)
+ printf("%4d %s\n", contatore, ultima) > file_output
+ else if ((solo_ripetute && contatore > 1) ||
+ (solo_non_ripetute && contatore == 1))
+ print ultima > file_output
+ close(file_output)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden FIXME: Include this?
address@hidden
+This program does not follow our recommended convention of naming
+global variables with a leading capital letter. Doing that would
+make the program a little easier to follow.
address@hidden ignore
+
address@hidden FOR_PRINT
+La logica per scegliere quali righe stampare rappresenta una @dfn{macchina a
+stati}, che @`e ``un dispositivo che address@hidden trovarsi in una tra un
dato numero di
+condizioni stabili, a seconda della sua condizione precedente e del valore
+corrente dei suoi input.''@footnote{Questa @`e la definizione trovata
+cercando @code{define: state machine} in Google.}
+Brian Kernighan suggerisce che
+``un approccio alternativo alle macchine a stati @`e quello di mettere l'input
+in un vettore, e poi usare gli indici. @`E quasi sempre address@hidden facile
da
+programmare e, per molti input in cui si address@hidden usare questo metodo,
+altrettanto veloce.'' Si consideri come riscrivere la logica di questo
+programma per seguite questo suggerimento.
address@hidden ifset
+
+
+
address@hidden Programma wc
address@hidden Contare cose
+
address@hidden FIXME: One day, update to current POSIX version of wc
+
address@hidden contare
address@hidden file in input, contare elementi nel
address@hidden parole, contare le
address@hidden caratteri, contare i
address@hidden righe, contare le
address@hidden @command{wc}, programma di address@hidden
address@hidden programma di address@hidden @command{wc}
+Il programma di address@hidden @command{wc} (@dfn{word count}, contatore di
parole)
+conta righe, parole, e caratteri in uno o address@hidden file in input. La sua
sintassi
address@hidden la seguente:
+
address@hidden
address@hidden address@hidden address@hidden @dots{}]
address@hidden display
+
+Se nessun file @`e specificato sulla riga di comando, @command{wc} legge il suo
+standard input. Se ci sono address@hidden file, stampa anche il contatore
totale di
+tutti i file. Le opzioni e il loro significato sono i seguenti:
+
address@hidden @code
address@hidden -l
+Conta solo le righe.
+
address@hidden -w
+Conta solo le parole.
+Una ``parola'' @`e una sequenza contigua di caratteri non bianchi, separata da
+spazi e/o TAB. Fortunatamente, questo @`e il modo normale in cui @command{awk}
+separa i campi nei suoi record in input.
+
address@hidden -c
+Conta solo i caratteri.
address@hidden table
+
+Implementare @command{wc} in @command{awk} @`e particolarmente elegante,
+perch@'e @command{awk} fa molto lavoro al posto nostro; divide le righe in
+parole (address@hidden, campi) e le conta, conta le righe (address@hidden, i
record),
+e address@hidden facilmente dire quanto @`e lunga una riga.
+
+Questo programma usa la funzione di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e le funzioni di passaggio da un file all'altro
+(@pxref{Funzione filetrans}).
+
+Questa versione ha una differenza significativa rispetto alle versioni
+tradizionali di @command{wc}: stampa sempre i contatori rispettando l'ordine
+righe, parole e caratteri. Le versioni tradizionali rilevano l'ordine in cui
+sono specificate le opzioni @option{-l}, @option{-w} e @option{-c} sulla riga
+di comando, e stampano i contatori in quell'ordine.
+
+La regola @code{BEGIN} si occupa degli argomenti. La variabile
address@hidden @`e vera se address@hidden di un file @`e presente sulla
+riga di comando:
+
address@hidden @code{wc.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{wc.awk}
address@hidden
address@hidden file eg/prog/wc.awk
+# wc.awk --- conta righe, parole, caratteri
address@hidden endfile
address@hidden
address@hidden file eg/prog/wc.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/wc.awk
+
+# Opzioni:
+# -l conta solo righe
+# -w conta solo parole
+# -c conta solo caratteri
+#
+# Il default @`e di contare righe, parole, caratteri
+#
+# Richiede le funzioni di libreria getopt()
+# e il programma di libreria che gestisce
+# il passaggio da un file dati al successivo
+
+BEGIN @{
+ # consente a getopt() di stampare un messaggio se si specificano
+ # opzioni non valide. Noi le ignoriamo
+ while ((c = getopt(ARGC, ARGV, "lwc")) != -1) @{
+ if (c == "l")
+ conta_righe = 1
+ else if (c == "w")
+ conta_parole = 1
+ else if (c == "c")
+ conta_caratteri = 1
+ @}
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
+
+ # se nessuna opzione @`e specificata, conta tutto
+ if (! conta_righe && ! conta_parole && ! conta_caratteri)
+ conta_righe = conta_parole = conta_caratteri = 1
+
+ stampa_totale = (ARGC - i > 1)
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{a_inizio_file()} @`e semplice; si limita ad azzerare i
contatori
+di righe, parole e caratteri, e salva il valore corrente di @value{FN} in
address@hidden:
+
address@hidden
address@hidden file eg/prog/wc.awk
+function a_inizio_file(file)
address@hidden
+ righe = parole = caratteri = 0
+ nome_file = FILENAME
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{a_fine_file()} aggiunge i numeri del file corrente al totale
+di righe, parole, e caratteri. Poi stampa i numeri relativi al file appena
+letto. La funzione
address@hidden()} azzera i numeri relativi al @value{DF} seguente:
+
address@hidden
address@hidden file eg/prog/wc.awk
+function a_fine_file(file)
address@hidden
+ totale_righe += righe
+ totale_parole += parole
+ totale_caratteri += caratteri
+ if (conta_righe)
+ printf "\t%d", righe
address@hidden
+ if (conta_parole)
+ printf "\t%d", parole
address@hidden group
+ if (conta_caratteri)
+ printf "\t%d", caratteri
+ printf "\t%s\n", nome_file
address@hidden
address@hidden endfile
address@hidden example
+
+C'@`e una regola che viene eseguita per ogni riga. Aggiunge la lunghezza del
record
address@hidden uno, a @address@hidden@'e @command{gawk} gestisce le
+localizzazioni in cui un carattere address@hidden occupare address@hidden di
un byte, questo codice
+conta i caratteri, non i byte.}
+Aggiungere uno alla lunghezza del record
address@hidden necessario, perch@'e il carattere di ritorno a capo, che separa
i record
+(il valore di @code{RS}) non @`e parte del record stesso, e quindi non @`e
+incluso nella sua lunghezza. Poi, @code{righe} @`e incrementata per ogni riga
+letta, e @code{parole} @`e incrementato con il valore @code{NF}, che @`e il
+numero di ``parole'' su questa riga:
+
address@hidden
address@hidden file eg/prog/wc.awk
+# per ogni riga...
address@hidden
+ caratteri += length($0) + 1 # aggiunge un ritorno a capo
+ righe++
+ parole += NF
address@hidden
address@hidden endfile
address@hidden example
+
+Infine, la regola @code{END} si limita a stampare i totali per tutti i file:
+
address@hidden
address@hidden file eg/prog/wc.awk
+END @{
+ if (stampa_totale) @{
+ if (conta_righe)
+ printf "\t%d", totale_righe
+ if (conta_parole)
+ printf "\t%d", totale_parole
+ if (conta_caratteri)
+ printf "\t%d", totale_caratteri
+ print "\ttotale"
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programmi vari
address@hidden Un paniere di programmi @command{awk}
+
+Questa @value{SECTION} @`e un ``paniere'' che contiene vari programmi.
+Si spera che siano interessanti e divertenti.
+
address@hidden
+* Programma dupword:: Trovare parole duplicate in un documento.
+* Programma alarm:: Un programma di sveglia.
+* Programma translate:: Un programma simile al programma di
address@hidden
+ @command{tr}.
+* Programma labels:: Stampare etichette per lettere.
+* Programma utilizzo parole:: Un programma per produrre un contatore
+ dell'uso di parole in un testo.
+* Programma riordino diario:: Eliminare righe doppie da un file di
+ cronologia.
+* Programma extract :: Estrarre programmi da file sorgenti Texinfo.
+* Programma sed semplice:: Un semplice editor di flusso.
+* Programma igawk:: Un programma per fornire ad
+ @command{awk} la address@hidden di includere
+ file.
+* Programma anagram:: Trovare anagrammi da una lista di parole.
+* Programma signature:: La gente fa cose stupefacenti se ha troppo
+ tempo libero.
address@hidden menu
+
address@hidden Programma dupword
address@hidden Trovare parole duplicate in un documento
+
address@hidden parole duplicate, ricerca di
address@hidden ricerca di parole
address@hidden address@hidden ricerca in
+Un errore comune quando si scrive un testo lungo @`e quello di ripetere
+accidentalmente delle parole. Tipicamente lo si address@hidden vedere in
testi del tipo
+``questo questo programma fa quanto address@hidden'' Quando il testo @`e
pubblicato in rete, spesso
+le parole duplicate sono poste tra il termine di
address@hidden
+di
address@hidden iftex
+una riga e l'inizio di un'altra, il che rende difficile scoprirle.
address@hidden as here!
+
+Questo programma, @file{dupword.awk}, legge un file una riga alla volta
+e cerca le occorrenze adiacenti della stessa parola. Conserva anche
+l'ultima parola di ogni riga (nella variabile @code{precedente}) per
+confrontarla con la prima parola sulla riga successiva.
+
address@hidden Texinfo
+Le prime due istruzioni fanno address@hidden@dotless{i}} che la riga sia tutta
in minuscolo,
+in modo che, per esempio, ``Il'' e ``il'' risultino essere la stessa parola.
+L'istruzione successiva sostituisce i caratteri che sono non alfanumerici e
+diversi dagli
+spazi bianchi con degli spazi, in modo che neppure la punteggiatura influenzi
+i confronti.
+I caratteri sono rimpiazzati da spazi in modo che i controlli di formattazione
+non creino parole prive di senso (p.es., l'espressione Texinfo
address@hidden@@address@hidden@}} diventa @samp{codeNF}, se ci si limita a
eliminare la
+punteggiatura). Il record @`e poi
+suddiviso di nuovo in campi, producendo address@hidden@dotless{i}} solo la
lista delle parole
+presenti sulla riga, esclusi eventuali campi nulli.
+
+Se, dopo aver rimosso tutta la punteggiatura, non rimane alcun campo, il
+record corrente @`e saltato. In caso contrario, il programma esegue il ciclo
+per ogni parola, confrontandola con quella che la precede:
+
address@hidden @code{dupword.awk}, programma
address@hidden programma @code{dupword.awk}
address@hidden
address@hidden file eg/prog/dupword.awk
+# dupword.awk --- trova parole duplicate in un testo
address@hidden endfile
address@hidden
address@hidden file eg/prog/dupword.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# December 1991
+# Revised October 2000
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/dupword.awk
address@hidden
+ $0 = tolower($0)
+ gsub(/[^[:alnum:][:blank:]]/, " ");
+ $0 = $0 # divide di nuovo in campi
+ if (NF == 0)
+ next
+ if ($1 == prec)
+ printf("%s:%d: duplicato %s\n",
+ nome_file, FNR, $1)
+ for (i = 2; i <= NF; i++)
+ if ($i == $(i-1))
+ printf("%s:%d: duplicato %s\n",
+ nome_file, FNR, $i)
+ prec = $NF
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma alarm
address@hidden Un programma di sveglia
address@hidden insonnia, cura per
address@hidden Robbins, Arnold
address@hidden
address@hidden cura contro l'insonnia @`e efficace quanto una sveglia che
suona.}
address@hidden Arnold Robbins
address@hidden quotation
address@hidden Quanstrom, Erik
address@hidden
+Date: Sat, 15 Feb 2014 16:47:09 -0500
+Subject: Re: 9atom install question
+Message-ID: <address@hidden>
+From: Erik Quanstrom <address@hidden>
+To: Aharon Robbins <address@hidden>
+
+yes.
+
+- erik
+
+Aharon Robbins <address@hidden> wrote:
+
+>> sleep is for web developers.
+>
+>Can I quote you, in the gawk manual?
+>
+>Thanks,
+>
+>Arnold
address@hidden ignore
address@hidden
address@hidden sonno @`e per sviluppatori web.}
address@hidden Erik Quanstrom
address@hidden quotation
+
address@hidden tempo, sveglia, programma di esempio
address@hidden sveglia, programma di esempio
+Il seguente programma @`e un semplice programma di ``sveglia''.
+Si address@hidden specificare un'ora del giorno e un messaggio opzionale.
All'ora
+specificata, il programma stampa il messaggio sullo standard output. Inoltre,
+si address@hidden specificare il numero di volte in cui il messaggio va
ripetuto, e
+anche un intervallo di tempo (ritardo) tra ogni ripetizione.
+
+Questo programma usa la funzione @code{getlocaltime()}
address@hidden
+dalla
address@hidden iftex
address@hidden
+da
address@hidden ifnottex
address@hidden getlocaltime}.
+
+Tutto il lavoro @`e svolto nella regola @code{BEGIN}. La prima parte @`e
+il controllo degli argomenti e l'impostazione dei valori di default:
+l'intervallo prima di ripetere, il contatore, e il messaggio da stampare.
+Se l'utente ha fornito un messaggio che non contiene il carattere ASCII BEL
+(noto come carattere ``campanello'', @code{"\a"}), questo viene aggiunto al
+messaggio. (Su molti sistemi, stampare il carattere ASCII BEL genera un suono
+udibile. Quindi, quando la sveglia suona, il sistema richiama l'attenzione
+su di s@'e nel caso che l'utente non stia guardando il computer.)
+Per amor di address@hidden, questo programma usa un'istruzione @code{switch}
+(@pxref{Istruzione switch}), ma l'elaborazione potrebbe anche essere fatta
+con una serie di istruzioni @address@hidden
+Ecco il programma:
+
address@hidden @code{alarm.awk}, programma
address@hidden programma @code{alarm.awk}
address@hidden
address@hidden file eg/prog/alarm.awk
+# alarm.awk --- impostare una sveglia
+#
+# Richiede la funzione di libreria getlocaltime()
address@hidden endfile
address@hidden
address@hidden file eg/prog/alarm.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised December 2010
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/alarm.awk
+# sintassi: alarm a_che_ora [ "messaggio" [ contatore [ ritardo ] ] ]
+
+BEGIN @{
+ # Controllo iniziale address@hidden argomenti
+ sintassi1 = "sintassi: alarm a_che_ora ['messaggio' [contatore [ritardo]]]"
+ sintassi2 = sprintf("\t(%s) formato ora: ::= hh:mm", ARGV[1])
+
+ if (ARGC < 2) @{
+ print sintassi1 > "/dev/stderr"
+ print sintassi2 > "/dev/stderr"
+ exit 1
+ @}
+ switch (ARGC) @{
+ case 5:
+ ritardo = ARGV[4] + 0
+ # vai al caso seguente
+ case 4:
+ contatore = ARGV[3] + 0
+ # vai al caso seguente
+ case 3:
+ messaggio = ARGV[2]
+ break
+ default:
+ if (ARGV[1] !~ /[[:digit:]]?[[:digit:]]:[[:digit:address@hidden@}/) @{
+ print sintassi1 > "/dev/stderr"
+ print sintassi2 > "/dev/stderr"
+ exit 1
+ @}
+ break
+ @}
+
+ # imposta i valori di default per quando arriva l'ora desiderata
+ if (ritardo == 0)
+ ritardo = 180 # 3 minuti
address@hidden
+ if (contatore == 0)
+ contatore = 5
address@hidden group
+ if (messaggio == "")
+ messaggio = sprintf("\aAdesso sono le %s!\a", ARGV[1])
+ else if (index(message, "\a") == 0)
+ messaggio = "\a" messaggio "\a"
address@hidden endfile
address@hidden example
+
+La successiva @value{SECTION} di codice scompone l'ora specificata in ore e
+minuti, la converte (se @`e il caso) al formato 24-ore, e poi calcola il
+relativo numero di secondi dalla mezzanotte. Poi trasforma l'ora corrente in
+un contatore dei secondi dalla
+mezzanotte. La differenza tra i due @`e il tempo di attesa che deve passare
+prima di far scattare la sveglia:
+
address@hidden
address@hidden file eg/prog/alarm.awk
+ # scomponi ora della sveglia
+ split(ARGV[1], ore_minuti, ":")
+ ora = ore_minuti[1] + 0 # trasforma in numero
+ minuto = ore_minuti[2] + 0 # trasforma in numero
+
+ # ottiene ora corrente divisa in campi
+ getlocaltime(adesso)
+
+ # se l'ora desiderata @`e in formato 12-ore ed @`e nel pomeriggio
+ # (p.es., impostare `alarm 5:30' alle 9 del mattino
+ # vuol dire far suonare la sveglia alle 5:30 pomeridiane)
+ # aggiungere 12 all'ora richiesta
+ if (hour < 12 && adesso["hour"] > ora)
+ ora += 12
+
+ # imposta l'ora in secondi dalla mezzanotte
+ sveglia = (ora * 60 * 60) + (minuto * 60)
+
+ # ottieni l'ora corrente in secondi dalla mezzanotte
+ corrente = (now["hour"] * 60 * 60) + \
+ (now["minute"] * 60) + now["second"]
+
+ # quanto restare appisolati
+ sonno = sveglia - corrente
+ if (sonno <= 0) @{
+ print "alarm: l'ora @`e nel passato!" > "/dev/stderr"
+ exit 1
+ @}
address@hidden endfile
address@hidden example
+
address@hidden @command{sleep}, programma di address@hidden
address@hidden programma di address@hidden @command{sleep}
+Infine, il programma usa la funzione @code{system()}
+(@pxref{Funzioni di I/O})
+per chiamare il programma di address@hidden @command{sleep}. Il programma di
address@hidden
address@hidden non fa altro che aspettare per il numero di secondi
+specificato. Se il codice di ritorno restituito @`e diverso da zero, il
+programma suppone che @command{sleep} sia stato interrotto ed esce. Se
address@hidden @`e terminato con un codice di ritorno corretto, (zero), il
+programma stampa il messaggio in un ciclo, utilizzando ancora @command{sleep}
+per ritardare per il numero di secondi necessario:
+
address@hidden
address@hidden file eg/prog/alarm.awk
+ # zzzzzz..... esci se sleep @`e interrotto
+ if (system(sprintf("sleep %d", sonno)) != 0)
+ exit 1
+
+ # @`e ora di avvisare!
+ command = sprintf("sleep %d", ritardo)
+ for (i = 1; i <= contatore; i++) @{
+ print messaggio
+ # se il comando sleep @`e interrotto, esci
+ if (system(command) != 0)
+ break
+ @}
+
+ exit 0
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma translate
address@hidden Rimpiazzare o eliminare caratteri
+
address@hidden caratteri, rimpiazzare
address@hidden rimpiazzare caratteri
address@hidden @command{tr}, programma di address@hidden
address@hidden programma di address@hidden @command{tr}
+Il programma di address@hidden di sistema @command{tr} rimpiazza caratteri.
Per
+esempio, @`e spesso usato per trasformare lettere maiuscole in lettere
minuscole
+in vista di ulteriori elaborazioni:
+
address@hidden
address@hidden dei dati} | tr 'A-Z' 'a-z' | @var{elaborare dei dati} @dots{}
address@hidden example
+
address@hidden richiede due liste di address@hidden alcuni sistemi
address@hidden datati, incluso Solaris, la versione di sistema di @command{tr}
address@hidden
+richiedere che le liste siano scritte come espressioni di intervallo,
+racchiuse in parentesi quadre
+(@samp{[a-z]}) e tra apici, per evitare che la shell effettui
+espansioni di @value{FN}. Questo non @`e un miglioramento.} Quando
+si elabora l'input, il primo carattere della prima lista @`e rimpiazzato con il
+primo carattere della seconda lista, il secondo carattere della prima lista @`e
+rimpiazzato con il secondo carattere della seconda lista, e
address@hidden@dotless{i}} via. Se ci
+sono address@hidden caratteri nella lista ``da'' che in quella ``a'', l'ultimo
carattere
+della lista ``a'' @`e usato per i restanti caratteri della lista ``da''.
+
+In un lontano passato,
address@hidden early or mid-1989!
+un utente propose di aggiungere una funzione di traslitterazione a
address@hidden
address@hidden Wishing to avoid gratuitous new features,
address@hidden at least theoretically
+Il programma seguente @`e stato scritto per dimostrare che la traslitterazione
+di caratteri poteva essere fatta con una funzione definita dall'utente.
+Questo programma non @`e address@hidden@dotless{i}} completo come il programma
di address@hidden di sistema
address@hidden, ma svolge buona parte dello stesso lavoro.
+
+Il programma @command{translate} @`e stato scritto molto prima che
@command{gawk}
+fosse in grado di separare ciascun carattere di una stringa in elementi
+distinti di un vettore. Questo @`e il motivo per cui usa ripetutamente le
+funzioni predefinite @code{substr()}, @code{index()}, e @code{gsub()}
+(@pxref{Funzioni per stringhe}).
+Ci sono due funzioni. La prima, @code{traduci_stringa()},
+richiede tre argomenti:
+
address@hidden @code
address@hidden da
+Una lista di caratteri da cui traslitterare
+
address@hidden a
+Una lista di caratteri a cui traslitterare
+
address@hidden stringa
+La stringa su cui effettuare la traslitterazione
address@hidden table
+
+I vettori associativi facilitano molto la parte di traslitterazione.
address@hidden contiene i caratteri ``a'', indicizzato dai
+caratteri ``da''. Poi un semplice
+ciclo scandisce @code{da}, un carattere alla volta. Per ogni carattere
+in @code{da}, se il carattere compare in @code{stringa}
address@hidden rimpiazzato con il corrispondente carattere @code{a}.
+
+La funzione @code{traducilo()} chiama @code{traduci_stringa()}, usando
@code{$0}
+come stringa. Il programma principale imposta due variabili globali,
@code{DA} e
address@hidden, dalla riga di comando, e poi modifica @code{ARGV} in modo che
address@hidden legga dallo standard input.
+
+Infine, la regola di elaborazione si limita a chiamare @code{traducilo()}
+per ogni record:
+
address@hidden @code{translate.awk}, programma
address@hidden programma @code{translate.awk}
address@hidden
address@hidden file eg/prog/translate.awk
+# translate.awk --- fa cose simili al comando tr
address@hidden endfile
address@hidden
address@hidden file eg/prog/translate.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# August 1989
+# February 2009 - bug fix
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/translate.awk
+# Bug: non gestisce cose del tipo tr A-Z a-z; deve essere
+# descritto carattere per carattere.
+# Tuttavia, se `a' @`e address@hidden corto di `da',
+# l'ultimo carattere in `a' @`e usato per il resto di `da'.
+
+function traduci_stringa(da, a, stringa, lf, lt, lstringa, vettore_trad,
+ i, c, risultato)
address@hidden
+ lf = length(da)
+ lt = length(a)
+ lstringa = length(stringa)
+ for (i = 1; i <= lt; i++)
+ vettore_trad[substr(da, i, 1)] = substr(a, i, 1)
+ if (lt < lf)
+ for (; i <= lf; i++)
+ vettore_trad[substr(da, i, 1)] = substr(a, lt, 1)
+ for (i = 1; i <= lstringa; i++) @{
+ c = substr(stringa, i, 1)
+ if (c in vettore_trad)
+ c = vettore_trad[c]
+ risultato = risultato c
+ @}
+ return risultato
address@hidden
+
+function traducilo(da, a)
address@hidden
+ return $0 = traduci_stringa(da, a, $0)
address@hidden
+
+# programma principale
+BEGIN @{
address@hidden
+ if (ARGC < 3) @{
+ print "sintassi: translate da a" > "/dev/stderr"
+ exit
+ @}
address@hidden group
+ DA = ARGV[1]
+ A = ARGV[2]
+ ARGC = 2
+ ARGV[1] = "-"
address@hidden
+
address@hidden
+ traducilo(DA, A)
+ print
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden possibile effettuare la traslitterazione di caratteri in una
funzione a
+livello utente, ma non @`e detto che sia efficiente, e noi (sviluppatori
+di @command{gawk}) abbiamo iniziato a prendere in considerazione l'aggiunta di
una funzione.
+Tuttavia, poco dopo aver scritto questo programma, abbiamo saputo che Brian
+Kernighan aveva aggiunto le funzioni @code{toupper()} e @code{tolower()} alla
+sua versione di @command{awk} (@pxref{Funzioni per stringhe}). Queste
+funzioni gestiscono la maggior parte dei casi in cui serva la traslitterazione
+di caratteri, e quindi abbiamo deciso di limitarci ad aggiungere le stesse
+funzioni a @command{gawk}, e di disinteressarci del resto.
+
+Un miglioramento ovvio a questo programma sarebbe di impostare il vettore
address@hidden solo una volta, in una regola @code{BEGIN}. Tuttavia,
address@hidden
+presuppone che le liste ``da'' e ``a'' non cambino mai durante tutta
+l'esecuzione del programma.
+
+Un altro miglioramento ovvio @`e di consentire l'uso di intervalli, come
address@hidden, come consentito dal programma di address@hidden @command{tr}.
Si address@hidden
+trarre ispirazione dal codice di @file{cut.awk} (@pxref{Programma cut}).
+
+
address@hidden Programma labels
address@hidden Stampare etichette per lettere
+
address@hidden stampare etichette per lettera
address@hidden etichette per address@hidden stampare
+Ecco un programma ``del mondo-reale''@footnote{``Del mondo-reale'' @`e definito
+come ``un programma effettivamente usato per realizzare qualcosa''.}.
+Questo script legge elenchi di nomi e indirizzi, e genera etichette per
+lettera. Ogni pagina di etichette contiene 20 etichette, su due file da 10
+etichette l'una. Gli indirizzi non possono contenere address@hidden di cinque
righe di
+dati. Ogni indirizzo @`e separato dal successivo da una riga bianca.
+
+L'idea di base @`e di leggere dati per 20 etichette. Ogni riga di ogni
etichetta
address@hidden immagazzinata nel vettore @code{riga}. L'unica regola si occupa
di riempire
+il vettore @code{riga} e di stampare la pagina dopo che sono state lette 20
+etichette.
+
+La regola @code{BEGIN} si limita a impostare @code{RS} alla stringa vuota, in
+modo che @command{awk} divida un record dal successivo quando incontra una riga
+bianca.
+(@pxref{Record}).
+Inoltre imposta @code{LIMITE_LINEE} a 100,
+perch@'e 100 @`e il massimo numero di righe sulla pagina
address@hidden
+(@math{20 @cdot 5 = 100}).
address@hidden iftex
address@hidden
address@hidden
+(20 * 5 = 100).
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+(20 ⋅ 5 = 100).
address@hidden docbook
+
+Il grosso del lavoro @`e svolto nella funzione @code{stampa_pagina()}.
+Le righe che compongono le etichette sono immagazzinate sequenzialmente nel
vettore
address@hidden Ma occorre stamparle in
+orizzontale: @code{riga[1]} a fianco di @code{riga[6]}, @code{riga[2]} a
+fianco di @code{riga[7]}, e address@hidden@dotless{i}} via. Questo si
address@hidden fare utilizzando due
+cicli. Quello address@hidden esterno, controllato dalla variabile @code{i},
gestisce 10
+righe di dati, ovvero la stampa di due etichette una a fianco dell'altra.
+Il ciclo address@hidden interno
+controllato dalla variabile @code{j}, gestisce le singole righe che compongono
+ognuno degli indirizzi.
+Poich@'e @code{j} varia da 0 a 4, @samp{i+j} @`e la riga @code{j}-esima
+dell'indirizzo di sinistra, e @samp{i+j+5} @`e quella stampata alla sua destra.
+L'output @`e simile a quello mostrato qui sotto:
+
address@hidden
+riga 1 riga 6
+riga 2 riga 7
+riga 3 riga 8
+riga 4 riga 9
+riga 5 riga 10
address@hidden
address@hidden example
+
address@hidden
+La stringa di formato per @code{printf} @samp{%-41s} allinea a
+sinistra i dati, e li stampa in un campo di lunghezza fissa.
+
+Come nota finale, un'ulteriore riga bianca extra viene stampata alle righe 21 e
+61, per mantenere entro i bordi l'output sulle etichette. address@hidden
dipende dalla
+particolare marca di etichette in uso quando il programma @`e stato scritto.
+Si noti anche che ci sono due righe bianche a inizio pagina e due righe
+bianche a fine pagina.
+
+La regola @code{END} si occupa di stampare l'ultima pagina di
+etichette; @`e improbabile che il numero di indirizzi da stampare sia un
+multiplo esatto di 20:
+
address@hidden @code{labels.awk}, programma
address@hidden programma @code{labels.awk}
address@hidden
address@hidden file eg/prog/labels.awk
+# labels.awk --- stampare etichette per lettera
address@hidden endfile
address@hidden
address@hidden file eg/prog/labels.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# June 1992
+# December 2010, minor edits
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/labels.awk
+
+# Ogni etichetta @`e 5 righe di dati, qualcuna delle quali address@hidden
essere bianca.
+# I fogli con le etichetta hanno 2 righe bianche in cima alla pagina e altre 2
+# a fine pagina.
+
+BEGIN @{ RS = "" ; LIMITE_LINEE = 100 @}
+
+function stampa_pagina( i, j)
address@hidden
+ if (NUMEROrighe <= 0)
+ return
+
+ printf "\n\n" # in cima
+
+ for (i = 1; i <= NUMEROrighe; i += 10) @{
+ if (i == 21 || i == 61)
+ print ""
+ for (j = 0; j < 5; j++) @{
+ if (i + j > LIMITE_LINEE)
+ break
+ printf " %-41s %s\n", riga[i+j], riga[i+j+5]
+ @}
+ print ""
+ @}
+
+ printf "\n\n" # in fondo
+
+ delete riga
address@hidden
+
+# regola principale
address@hidden
+ if (contatore >= 20) @{
+ stampa_pagina()
+ contatore = 0
+ NUMEROrighe = 0
+ @}
+ n = split($0, a, "\n")
+ for (i = 1; i <= n; i++)
+ riga[++NUMEROrighe] = a[i]
+ for (; i <= 5; i++)
+ riga[++NUMEROrighe] = ""
+ contatore++
address@hidden
+
+END @{
+ stampa_pagina()
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma utilizzo parole
address@hidden Generare statistiche sulla frequenza d'uso delle parole
+
address@hidden parole, statistica utilizzo delle
address@hidden statistica utilizzo delle parole
+
+Quando si lavora con una grande address@hidden di testo, address@hidden essere
interessante
+sapere quanto spesso ricorrono le diverse parole. Per esempio, un autore
address@hidden
+fare un uso eccessivo di certe parole, e in questo caso si potrebbero
+trovare sinonimi da sostituire a
+parole che appaiono troppo spesso.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden spiega come
+scrivere un programma per contare le parole e presentare in un formato
+utile le informazioni relative alla loro frequenza.
+
+A prima vista, un programma come questo sembrerebbe essere sufficiente:
+
address@hidden
+# wordfreq-first-try.awk --- stampa lista frequenze utilizzo parole
+
address@hidden
+ for (i = 1; i <= NF; i++)
+ freq[$i]++
address@hidden
+
+END @{
+ for (word in freq)
+ printf "%s\t%d\n", word, freq[word]
address@hidden
address@hidden example
+
+Il programma si affida al meccanismo con cui @command{awk} divide i campi per
+default, per suddividere ogni riga in ``parole'' e usa un vettore associativo
+di nome @code{freq}, che ha per indici le singole parole, per contare il
+numero di volte che ogni parola viene usata. Nella regola @code{END}, stampa i
+contatori.
+
+Questo programma ha parecchi problemi che lo rendono praticamente inutile
+su file di testo reali:
+
address@hidden @value{BULLET}
address@hidden
+Il linguaggio @command{awk} considera i caratteri maiuscoli e minuscoli come
+distinti (non equivalenti). Quindi, ``barista'' e ``Barista'' sono
+considerate parole differenti. Questo non @`e un comportamento auspicabile,
+perch@'e le parole iniziano con la lettera maiuscola se sono a inizio frase in
+un testo normale, e un analizzatore di frequenze dovrebbe ignorare la
+distinzione maiuscolo/minuscolo.
+
address@hidden
+Le parole sono individuate usando la convenzione @command{awk} secondo cui i
+campi sono separati solo da spazi bianchi. Altri caratteri nell'input
+(tranne il ritorno a capo) non hanno alcun particolare significato per
address@hidden Questo significa che i segni di interpunzione sono visti come
+parte di una parola.
+
address@hidden
+L'output non @`e scritto in alcun ordine utile. Si @`e probabilmente
address@hidden
+interessati a sapere quali parole ricorrono address@hidden di frequente, o ad
avere
+una tabella in ordine alfabetico che mostra quante volte ricorre ogni parola.
address@hidden itemize
+
address@hidden @command{sort}, programma di address@hidden
address@hidden programma di address@hidden @command{sort}
+Il primo problema si address@hidden risolvere usando @code{tolower()} per
rimuovere la
+distinzione maiuscolo/minuscolo. Il secondo problema si address@hidden
risolvere usando
address@hidden()} per rimuovere i caratteri di interpunzione. Infine, per
+risolvere il terzo problema si address@hidden usare il programma di
address@hidden
address@hidden per elaborare l'output dello script @command{awk}. Ecco la
+nuova versione del programma:
+
address@hidden @code{wordfreq.awk}, programma
address@hidden programma @code{wordfreq.awk}
address@hidden
address@hidden file eg/prog/wordfreq.awk
+# wordfreq.awk --- stampa la lista con la frequenza delle parole
+
address@hidden
+ $0 = tolower($0) # togli maiuscolo/minuscolo
+ # togli interpunzione
+ gsub(/[^[:alnum:]_[:blank:]]/, "", $0)
+ for (i = 1; i <= NF; i++)
+ freq[$i]++
address@hidden
+
address@hidden endfile
+END @{
+ for (word in freq)
+ printf "%s\t%d\n", word, freq[word]
address@hidden
address@hidden example
+
+La @dfn{regexp} @code{/[^[:alnum:]_[:blank:]]/} si poteva scrivere come
address@hidden/[[:punct:]]/}, ma in questo modo il caratteri trattino basso
sarebbe
+stato rimosso, mentre si desidera conservarlo.
+
+Supponendo di aver salvato questo programma in un file di nome
address@hidden,
+e che i dati siano in @file{file1}, il seguente comando con @dfn{pipeline}:
+
address@hidden
+awk -f wordfreq.awk file1 | sort -k 2nr
address@hidden example
+
address@hidden
+produce una tabella delle parole che appaiono in @file{file1} in ordine
+descrescente di frequenza.
+
+Il programma @command{awk} da solo gestisce adeguatamente i dati e produce
+una tabella delle frequenza che non @`e ordinata.
+L'output di @command{awk} @`e poi messo in ordine dal programma di
address@hidden
address@hidden e stampato sullo schermo.
+
+Le opzioni passate a @command{sort}
+richiedono un ordinamento che usi come chiave il secondo campo di ogni riga
+in input (saltando il primo campo), che le chiavi di ordinamento siano
+trattate come address@hidden numeriche
+(altrimenti @samp{15} sarebbe stampato prima di @samp{5}), e che l'ordinamento
+sia fatto in ordine decrescente (inverso).
+
+Il comando @command{sort} potrebbe anche essere richiamato dall'interno del
+programma, cambiando l'azione da fare nella regola @code{END} a:
+
address@hidden
address@hidden file eg/prog/wordfreq.awk
+END @{
+ sort = "sort -k 2nr"
+ for (word in freq)
+ printf "%s\t%d\n", word, freq[word] | sort
+ close(sort)
address@hidden
address@hidden endfile
address@hidden example
+
+Questa maniera di ordinare dev'essere usata su sistemi che non hanno delle
+vere e proprie @dfn{pipe} a livello di riga di comando (o di procedura di
+comandi).
+Si veda la documentazione generale riguardo al sistema operativo per maggiori
+informazioni su come usare il programma @command{sort}.
+
address@hidden Programma riordino diario
address@hidden Eliminare duplicati da un file non ordinato
+
address@hidden righe, address@hidden rimuovere
address@hidden rimuovere righe duplicate
+Il programma @command{uniq}
+(@pxref{Programma uniq})
+rimuove righe duplicate da dati @emph{ordinati}.
+
+Si supponga, tuttavia, di dover rimuovere righe duplicate da un @value{DF},
+ma di voler conservare l'ordine in cui le righe sono state scritte. Un buon
+esempio di questo tipo potrebbe essere un file della cronologia dei comandi
+della shell. Il file della cronologia dei comandi
+mantiene copia di tutti i comandi che sono stati dati, e non @`e
+insolito ripetere un comando molte volte di fila. Occasionalmente si
+potrebbe voler compattare la cronologia togliendo le righe duplicate.
+Tuttavia sarebbe opportuno mantenere l'ordine originale dei comandi.
+
+Questo semplice programma fa questo. Usa due vettori. Il vettore @code{dati}
+ha come indice il testo di ogni riga.
+Per ogni riga, @code{dati[$0]} @`e incrementato di uno.
+Se una particolare riga non @`e stata ancora vista, @code{dati[$0]} @`e zero.
+In tal caso, il testo della riga @`e immagazzinato in @code{righe[contatore]}.
+Ogni elemento del vettore @code{righe} @`e un comando unico, e gli
+indici di @code{righe} indicano l'ordine in cui quelle righe sono state
+incontrate.
+La regola @code{END} stampa semplicemente le righe, in ordine:
+
address@hidden Rakitzis, Byron
address@hidden @code{histsort.awk}, programma
address@hidden programma @code{histsort.awk}
address@hidden
address@hidden file eg/prog/histsort.awk
+# histsort.awk --- compatta un file della cronologia dei comandi della shell
+# Grazie a Byron Rakitzis per l'idea generale
address@hidden endfile
address@hidden
address@hidden file eg/prog/histsort.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/histsort.awk
+
address@hidden
address@hidden
+ if (dati[$0]++ == 0)
+ righe[++contatore] = $0
address@hidden
address@hidden group
+
address@hidden
+END @{
+ for (i = 1; i <= contatore; i++)
+ print righe[i]
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+Questo programma address@hidden essere un punto di partenza per generare altre
+informazioni utili.
+Per esempio, usando la seguente istruzione @code{print} nella regola
address@hidden permette di sapere quante volte viene usato un certo comando:
+
address@hidden
+print dati[righe[i]], righe[i]
address@hidden example
+
address@hidden
+Questo si address@hidden fare perch@'e @code{dati[$0]} @`e incrementato ogni
volta che una
+riga @`e stata trovata.
+
address@hidden Programma extract
address@hidden Estrarre programmi da un file sorgente Texinfo
+
address@hidden Texinfo, estrarre programma da file sorgente
address@hidden estrarre programma da file sorgente Texinfo
address@hidden file Texinfo, estrarre programma da
address@hidden
+Sia questo capitolo che il precedente
+(@ref{Funzioni di libreria})
+presentano un numero elevato di programmi @command{awk}.
address@hidden ifnotinfo
address@hidden
+I nodi
address@hidden di libreria},
+e @ref{Programmi di esempio},
+sono nodi al livello address@hidden elevato, e
+contengono nodi che descrivono un numero elevato di programmi @command{awk}.
address@hidden ifinfo
+Se si vuole fare pratica con questi programmi, @`e fastidioso doverli
+digitare di nuovo manualmente. @`E per questo che abbiamo pensato a un
programma
+in grado di estrarre parti di un file in input Texinfo e metterli in file
+separati.
+
address@hidden Texinfo
+Questo @value{DOCUMENT} @`e scritto in
@uref{http://www.gnu.org/software/texinfo/, Texinfo},
+il programma di formattazione di documenti del progetto GNU.
+Un solo file sorgente Texinfo address@hidden essere usato per produrre sia la
+documentazione stampata, usando @TeX{}, sia quella online.
address@hidden
+(Texinfo @`e esaurientemente documentato nel libro
address@hidden GNU Documentation Format},
+disponibile alla Free Software Foundation,
+e anche @uref{http://www.gnu.org/software/texinfo/manual/texinfo/, online}.)
address@hidden ifnotinfo
address@hidden
+(Il linguaggio Texinfo @`e descritto esaurientemente, a partire da
address@hidden, , Texinfo, texinfo,Texinfo---The GNU Documentation Format}.)
address@hidden ifinfo
+
+Per quel che ci riguarda, @`e sufficiente sapere tre cose riguardo ai file di
+input Texinfo:
+
address@hidden @value{BULLET}
address@hidden
+Il simbolo ``chiocciola'' (@samp{@@}) @`e speciale per
+Texinfo, proprio come la barra inversa (@samp{\}) lo @`e per il linguaggio C
+o per @command{awk}. I simboli @samp{@@} sono rappresentati nel sorgente
+Texinfo come @samp{@@@@}.
+
address@hidden
+I commenti iniziano con @samp{@@c} o con @samp{@@comment}.
+Il programma di estrazione file funziona usando dei commenti speciali che
+sono posti all'inizio di una riga.
+
address@hidden
+Righe contenenti comandi @samp{@@group} e @samp{@@end group} racchiudono testi
+di esempio che non dovrebbero andare a cavallo di due pagine.
+(Sfortunatamente, @TeX{} non @`e sempre in grado di fare le cose in maniera
+esatta, e quindi va un po' aiutato).
address@hidden itemize
+
+Il programma seguente, @file{extract.awk}, legge un file sorgente Texinfo
+e fa due cose, basandosi sui commenti speciali.
+Dopo aver visto il commento @address@hidden@@c system @dots{}}},
+esegue un comando, usando il testo del comando contenuto nella
+riga di controllo e passandolo alla funzione @code{system()}
+(@pxref{Funzioni di I/O}).
+Dopo aver trovato il commento @samp{@@c file @var{nome_file}}, ogni riga
+successiva @`e spedita al file @var{nome_file}, fino a che si trova un
+commento @samp{@@c endfile}.
+Le regole in @file{extract.awk} sono soddisfatte sia quando incontrano
address@hidden@@c} che quando incontrano @samp{@@comment} e quindi la parte
address@hidden @`e opzionale.
+Le righe che contengono @samp{@@group} e @samp{@@end group} sono semplicemente
+ignorate.
address@hidden usa la funzione di libreria @code{join()}
+(@pxref{Funzione join}).
+
+I programmi di esempio nel sorgente Texinfo online di @address@hidden
+(@file{gawktexi.in}) sono stati tutti inseriti tra righe @samp{file} e righe
address@hidden La distribuzione di @command{gawk} usa una copia di
address@hidden per estrarre i programmi di esempio e per installarne
+molti in una particolare directory dove @command{gawk} li address@hidden
trovare.
+Il file Texinfo ha un aspetto simile a questo:
+
address@hidden
address@hidden
+Questo programma ha una regola @@address@hidden@}
+che stampa un messaggio scherzoso:
+
+@@example
+@@c file esempi/messages.awk
+BEGIN @@@{ print "Non v'allarmate!" @@@}
+@@c endfile
+@@end example
+
+Stampa anche qualche avviso conclusivo:
+
+@@example
+@@c file esempi/messages.awk
+END @@@{ print "Evitate sempre gli archeologi annoiati!" @@@}
+@@c endfile
+@@end example
address@hidden
address@hidden example
+
+Il programma @file{extract.awk} inizia con l'impostare @code{IGNORECASE} a
+uno, in modo che un miscuglio di lettere maiuscole e minuscole nelle direttive
+non faccia differenza.
+
+La prima regola gestisce le chiamate a @code{system()}, controllando che sia
+stato fornito un comando (@code{NF} dev'essere almeno tre) e controllando
+anche che il comando termini con un codice di ritorno uguale a zero, che sta
+a significare che tutto @`e andato bene:
+
address@hidden @code{extract.awk}, programma
address@hidden programma @code{extract.awk}
address@hidden
address@hidden file eg/prog/extract.awk
+# extract.awk --- estrae file ed esegue programmi dal file Texinfo
address@hidden endfile
address@hidden
address@hidden file eg/prog/extract.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised September 2000
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/extract.awk
+
+BEGIN @{ IGNORECASE = 1 @}
+
+/^@@c(omment)?[ \t]+system/ @{
+ if (NF < 3) @{
+ e = ("extract: " FILENAME ":" FNR)
+ e = (e ": riga `system' con formato errato")
+ print e > "/dev/stderr"
+ next
+ @}
+ $1 = ""
+ $2 = ""
+ stat = system($0)
+ if (stat != 0) @{
+ e = ("extract: " FILENAME ":" FNR)
+ e = (e ": attenzione: system ha restituito " stat)
+ print e > "/dev/stderr"
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+La variabile @code{e} @`e stata usata per far address@hidden@dotless{i}} che
la regola
+sia agevolemente contenuta nella @value{PAGE}.
+
+La seconda regola gestisce il trasferimento di dati in un file. Verifica che
+nella direttiva sia stato fornito un @value{FN}.
+Se il nome del file non @`e quello del file corrente, il file
+corrente viene chiuso. Mantenere aperto il file corrente finch@'e non si trova
+un nuovo nome file permette di usare la ridirezione @samp{>} per stampare i
+contenuti nel file, semplificando la gestione dei file aperti.
+
+Il ciclo @code{for} esegue il lavoro. Legge le righe usando @code{getline}
+(@pxref{Getline}).
+Se si raggiunge una fine-file inattesa, viene chiamata la funzione
address@hidden@w{fine_file_inattesa()}}. Se la riga @`e una riga ``endfile'',
+il ciclo viene abbandonato.
+Se la riga inizia con @samp{@@group} o @samp{@@end group}, la riga viene
+ignorata, e si passa a quella seguente. Allo stesso modo, eventuali commenti
+all'interno degli esempi vengono ignorati.
+
+Il grosso del lavoro @`e nelle poche righe che seguono. Se la riga non ha
+simboli @samp{@@}, il programma la address@hidden
+stampare address@hidden@dotless{i}} com'@`e. Altrimenti, ogni @samp{@@} a
inizio parola dev'essere
+eliminato.
+Per rimuovere i simboli @samp{@@}, la riga viene divisa nei singoli elementi
+del vettore @code{a}, usando la funzione @code{split()}
+(@pxref{Funzioni per stringhe}).
+Il simbolo @samp{@@} @`e usato come carattere di separazione.
+Ogni elemento del vettore @code{a} che risulti vuoto indica due caratteri
address@hidden@@} contigui nella riga originale. Per ogni due elementi vuoti
+(@samp{@@@@} nel file originale), va inserito un solo simbolo @samp{@@} nel
+file in output.
+
+Una volta terminato di esaminare il vettore, viene chiamata la funzione
@code{join()}
+specificando nella chiamata il valore di @code{SUBSEP}
+(@pxref{Vettori multidimensionali}),
+per riunire nuovamente i pezzi in una riga sola.
+La riga @`e poi stampata nel file di output:
+
address@hidden
address@hidden file eg/prog/extract.awk
+/^@@c(omment)?[ \t]+file/ @{
+ if (NF != 3) @{
+ e = ("extract: " FILENAME ":" FNR ": riga `file' con formato errato")
+ print e > "/dev/stderr"
+ next
+ @}
+ if ($3 != file_corrente) @{
+ if (file_corrente != "")
+ close(file_corrente)
+ file_corrente = $3
+ @}
+
+ for (;;) @{
+ if ((getline riga) <= 0)
+ fine_file_inattesa()
+ if (riga ~ /^@@c(omment)?[ \t]+endfile/)
+ break
+ else if (riga ~ /^@@(end[ \t]+)?group/)
+ continue
+ else if (riga ~ /^@@c(omment+)?[ \t]+/)
+ continue
+ if (index(riga, "@@") == 0) @{
+ print riga > file_corrente
+ continue
+ @}
+ n = split(riga, a, "@@")
+ # if a[1] == "", vuol dire riga che inizia per @@,
+ # non salvare un @@
+ for (i = 2; i <= n; i++) @{
+ if (a[i] == "") @{ # era un @@@@
+ a[i] = "@@"
+ if (a[i+1] == "")
+ i++
+ @}
+ @}
+ print join(a, 1, n, SUBSEP) > file_corrente
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden importante notare l'uso della ridirezione @samp{>} .
+L'output fatto usando @samp{>} apre il file solo la prima volta; il file resta
+poi aperto, e ogni scrittura successiva @`e aggiunta in fondo al file.
+(@pxref{Ridirezione}).
address@hidden rende possibile mischiare testo del programm e commenti
esplicativi
+(come @`e stato fatto qui) nello stesso file sorgente, senza nessun problema.
+Il file viene chiuso solo quando viene trovato un nuovo nome di
address@hidden oppure alla fine del file in input.
+
+Per finire, la funzione @address@hidden()}} stampa un
+appropriato messaggio di errore ed esce.
+La regola @code{END} gestisce la pulizia finale, chiudendo il file aperto:
+
address@hidden
address@hidden file eg/prog/extract.awk
address@hidden
+function fine_file_inattesa()
address@hidden
+ printf("extract: %s:%d: fine-file inattesa, o errore\n",
+ FILENAME, FNR) > "/dev/stderr"
+ exit 1
address@hidden
address@hidden group
+
+END @{
+ if (file_corrente)
+ close(file_corrente)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma sed semplice
address@hidden Un semplice editor di flusso
+
address@hidden @command{sed}, programma di address@hidden
address@hidden programma di address@hidden @command{sed}
address@hidden editori di flusso
address@hidden flusso, editori di
+Il programma di address@hidden @command{sed} @`e un @dfn{editore di flusso},
+ovvero un programma che legge un flusso di dati, lo modifica, e scrive il file
address@hidden@dotless{i}} modificato.
address@hidden spesso usato per fare modifiche generalizzate a un grosso file,
o a un
+flusso di dati generato da una @dfn{pipeline} di comandi.
+Sebbene @command{sed} sia un programma piuttosto complesso di suo, l'uso che
+se ne fa solitamente @`e di effettuare delle sostituzioni globali attraverso
+una @dfn{pipeline}:
+
address@hidden
address@hidden < dati.originali | sed 's/vecchio/nuovo/g' | @var{comando2} >
risultato
address@hidden example
+
+Qui, @samp{s/vecchio/nuovo/g} chiede a @command{sed} di ricercare la
address@hidden @samp{vecchio} in ogni riga di input e di sostituirla
+dappertutto con il testo @samp{nuovo} (address@hidden, in tutte le occorrenze
di
+ciascuna riga). Questo @`e simile a quello che fa la funzione di @command{awk}
address@hidden()}
+(@pxref{Funzioni per stringhe}).
+
+Il programma seguente, @file{awksed.awk}, accetta almeno due argomenti dalla
+riga di comando: l'espressione da ricercare e il testo con cui rimpiazzarla.
+Ogni ulteriore argomento @`e considerato
+come un nome di @value{DF} da elaborare. Se non ne viene fornito alcuno, si
+usa lo standard input:
+
address@hidden Brennan, Michael
address@hidden @command{awksed.awk}, programma
address@hidden programma @command{awksed.awk}
address@hidden @cindex simple stream editor
address@hidden @cindex stream editor, simple
address@hidden
address@hidden file eg/prog/awksed.awk
+# awksed.awk --- fa s/pippo/pluto/g usando solo print
+# Ringraziamenti a Michael Brennan per l'idea
address@hidden endfile
address@hidden
address@hidden file eg/prog/awksed.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# August 1995
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/awksed.awk
+
+function sintassi()
address@hidden
+ print "sintassi: awksed espressione rimpiazzo [file...]" > "/dev/stderr"
+ exit 1
address@hidden
+
+BEGIN @{
+ # valida argomenti
+ if (ARGC < 3)
+ sintassi()
+
+ RS = ARGV[1]
+ ORS = ARGV[2]
+
+ # non usare argomenti come nomi di file
+ ARGV[1] = ARGV[2] = ""
address@hidden
+
address@hidden
+# guarda, mamma, senza mani!
address@hidden
+ if (RT == "")
+ printf "%s", $0
+ else
+ print
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+Il programma fa assegnamento sulla address@hidden di @command{gawk} di avere
come
address@hidden una @dfn{regexp},
+e anche sul fatto che @code{RT} viene impostato al testo che effettivamente
+delimita il record (@pxref{Record}).
+
+L'idea @`e di usare @code{RS} come espressione da ricercare. @command{gawk}
+automaticamente imposta @code{$0} al testo che compare tra due corrispondenze
+all'espressione di ricerca.
+Questo @`e appunto il testo che vogliamo conservare inalterato. Quindi,
+impostando @code{ORS} al testo che si vuole sostituire, una semplice
+istruzione @code{print} scrive il testo che si vuole mantenere, seguito dal
+testo che si vuole invece sostituire.
+
+C'@`e un problema in questo schema, ossia cosa fare se l'ultimo record
+non termina con un testo che corrisponde a @code{RS}. Usando un'istruzione
address@hidden incondizionatamente stampa il testo da sostituire, il che non
address@hidden corretto.
+Tuttavia, se il file non termina con del testo che corrisponde a @code{RS},
address@hidden @`e impostata alla stringa nulla. In tal caso, si
address@hidden stampare
address@hidden usando @code{printf}
+(@pxref{Printf}).
+
+La regola @code{BEGIN} gestisce la preparazione, controllando che ci sia
+il numero giusto di argomenti e chiamando @code{sintassi()} se c'@`e un
problema.
+Poi imposta @code{RS} e @code{ORS} dagli argomenti della riga di comando e
+imposta @code{ARGV[1]} e @code{ARGV[2]} alla stringa nulla, per impedire che
+vengano considerati dei @value{FNS}
+(@pxref{ARGC e ARGV}).
+
+La funzione @code{sintassi()} stampa un messaggio di errore ed esce.
+Per finire, l'unica regola gestisce lo schema di stampa delineato
address@hidden sopra,
+usando @code{print} o @code{printf} come richiesto, a seconda del valore di
address@hidden
+
address@hidden Programma igawk
address@hidden Una maniera facile per usare funzioni di libreria
+
address@hidden libreria di funzioni @command{awk}, programma di esempio per
usare
address@hidden funzioni, librerie di, programma di esempio per usare
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden file}, abbiamo visto come @command{gawk} preveda la
address@hidden di includere file. Tuttavia, questa @`e un'estensione
@command{gawk}.
+Questa @value{SECTION} evidenzia l'address@hidden di rendere l'inclusione di
+file disponibile per @command{awk} standard, e mostra come farlo utilizzando
+una combinazione di programmazione di shell e di @command{awk}.
+
+Usare funzioni di libreria in @command{awk} address@hidden presentare molti
vantaggi.
+Incoraggia il riutilizzo di codice e la scrittura di funzioni di tipo
+generale. I programmi sono address@hidden snelli e quindi address@hidden
comprensibili.
+Tuttavia, usare funzioni di libreria @`e facile solo in fase di scrittura di
+programmi @command{awk}; @`e invece complicato al momento di eseguirli,
+rendendo necessario specificare molte opzioni @option{-f}. Se @command{gawk}
+non @`e disponibile, non lo sono neppure la variabile d'ambiente @env{AWKPATH}
e
+la address@hidden di conservare funzioni @command{awk} in una directory di
+libreria (@pxref{Opzioni}).
+Sarebbe bello poter scrivere programmi nel modo seguente:
+
address@hidden
+# funzioni di libreria
+@@include getopt.awk
+@@include join.awk
address@hidden
+
+# programma principale
+BEGIN @{
+ while ((c = getopt(ARGC, ARGV, "a:b:cde")) != -1)
+ @dots{}
+ @dots{}
address@hidden
address@hidden example
+
+Il programma seguente, @file{igawk.sh}, fornisce questo servizio.
+Simula la ricerca da parte di @command{gawk} della variabile d'ambiente
address@hidden e permette anche delle inclusioni @dfn{nidificate}
(address@hidden,
+un file che @`e stato incluso tramite
address@hidden@@include} address@hidden contenere ulteriori istruzioni
@code{@@include}).
address@hidden tenta di includere ogni file una volta sola, in modo che delle
+inclusioni nidificate non contengano accidentalmente una funzione di libreria
address@hidden di una volta.
+
address@hidden dovrebbe comportarsi esternamente proprio come @command{gawk}.
+Questo vuol dire che dovrebbe accettare sulla riga di comando tutti gli
+argomenti di @command{gawk}, compresa
+la address@hidden di specificare address@hidden file
+sorgenti tramite l'opzione @option{-f}
+e la address@hidden di mescolare istruzioni da riga di comando e file di
sorgenti di
+libreria.
+
+Il programma @`e scritto usando il linguaggio della Shell POSIX
+(@command{sh})address@hidden spiegazione dettagliata del linguaggio della
address@hidden non rientra negli intenti di questo libro. Qualche spiegazione
+sommaria viene fornita, ma se si desidera una comprensione address@hidden
dettagliata, si
+dovrebbe consultare un buon libro sulla programmazione della shell.}
+Il funzionamento @`e il seguente:
+
address@hidden
address@hidden
+Esegue un ciclo attraverso gli argomenti, salvando tutto address@hidden che
non si presenta come
+codice sorgente @command{awk}, per quando il programma espanso address@hidden
eseguito.
+
address@hidden
+Per ogni argomento che rappresenta del codice @command{awk}, mette l'argomento
+in una variabile di shell che address@hidden espansa. Ci sono due casi:
+
address@hidden a
address@hidden
+Un testo letterale, fornito con l'opzione @option{-e} o @option{--source}.
+Questo testo viene aggiunto direttamente in fondo.
+
address@hidden
address@hidden sorgenti, forniti con l'opzione @option{-f}. Usiamo il
trucchetto
+di aggiungere @samp{@@include @var{nome_file}} in fondo ai contenuti della
+variabile di shell. Poich@'e il programma di inclusione dei file funziona
+allo stesso modo in cui funziona @command{gawk}, ne risulta che il file viene
+incluso nel programma al punto giusto.
address@hidden enumerate
+
address@hidden
+Esegue un programma (naturalmente @command{awk}) sui contenuti della variabile
+di shell per espandere le istruzioni
address@hidden@@include}. Il programma espanso @`e messo in una seconda
variabile di
+shell.
+
address@hidden
+Esegue il programma espanso richiamando @command{gawk} e tutti gli altri
+argomenti originalmente forniti dall'utente sulla riga di comando (come p.es.
+dei nomi di @value{DF}).
address@hidden enumerate
+
+Questo programma usa variabili di shell in address@hidden: per immagazzinare
+argomenti della riga di comando e
+il testo del programma @command{awk} che address@hidden il programma
dell'utente,
+per il programma originale dell'utente e per il programma espanso. Questo
+modo di procedere risolve potenziali
+problemi che potrebbero presentarsi se si usassero invece dei file temporanei,
+ma rende lo script un po' address@hidden complicato.
+
+La parte iniziale del programma attiva il tracciamento della shell se il primo
+argomento @`e @samp{debug}.
+
+La parte successiva esegue un ciclo che esamina ogni argomento della riga di
+comando.
+Ci sono parecchi casi da esaminare:
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @option{--}
+Quest'opzione termina gli argomenti per @command{igawk}. Tutto quel che segue
+dovrebbe essere passato al programma @command{awk} dell'utente senza essere
+preso in considerazione.
+
address@hidden @option{-W}
+Questo indica che l'opzione successiva @`e propria di @command{gawk}. Per
+facilitare l'elaborazione degli argomenti, l'opzione @option{-W} @`e aggiunta
+davanti agli argomenti rimanenti, e il
+ciclo continua. (Questo @`e un trucco di programmazione della @command{sh}.
+Non @`e il caso di preoccuparsene se non si ha address@hidden con il comando
address@hidden)
+
address@hidden @option{-v}, @option{-F}
+Queste opzioni sono conservate e lasciate da gestire a @command{gawk}.
+
address@hidden @option{-f}, @option{--file}, @option{--file=}, @option{-Wfile=}
+Il @value{FN} @`e aggiunto alla variabile di shell @code{programma}, insieme
+a un'istruzione @code{@@include}.
+Il programma di address@hidden @command{expr} @`e usato per eliminare la parte
+iniziale dell'argomento (p.es., @samp{--file=}).
+(La sintassi tipica di @command{sh} richiederebbe di usare il comando
address@hidden e il programma di address@hidden @command{sed} per far questo.
+Sfortunatamente, alcune versioni di @command{echo} valutano le sequenze
+di protezione contenute nei loro argomenti, e questo potrebbe finire per
+alterare il testo del programma.
+L'uso di @command{expr} evita questo problema.)
+
address@hidden @option{--source}, @option{--source=}, @option{-Wsource=}
+Il testo sorgente @`e aggiunto in fondo a @code{programma}.
+
address@hidden @option{--version}, @option{-Wversion}
address@hidden stampa il proprio numero di versione, esegue
address@hidden --version} per ottenere l'informazione relativa alla versione di
address@hidden, ed esce.
address@hidden table
+
+Se nessuno degli argomenti
address@hidden, @option{--file}, @option{-Wfile}, @option{--source},
+o @option{-Wsource} @`e stato fornito, il primo argomento che non @`e
un'opzione
+dovrebbe essere il programma @command{awk}. Se non ci sono argomenti rimasti
+sulla riga di comando, @command{igawk} stampa un messaggio di errore ed esce.
+Altrimenti, il primo argomento @`e aggiunto in fondo a @code{programma}.
+In qualsiasi caso, dopo che gli argomenti sono stati elaborati,
+la variabile di shell
address@hidden contiene il testo completo del programma originale
address@hidden
+
+Il programma @`e il seguente:
+
address@hidden @code{igawk.sh}, programma
address@hidden programma @code{igawk.sh}
address@hidden
address@hidden file eg/prog/igawk.sh
+#! /bin/sh
+# igawk --- come gawk ma abilita l'uso di @@include
address@hidden endfile
address@hidden
address@hidden file eg/prog/igawk.sh
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# July 1993
+# December 2010, minor edits
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/igawk.sh
+
+if [ "$1" = debug ]
+then
+ set -x
+ shift
+fi
+
+# Un ritorno a capo letterale,
+# per formattare correttamente il testo del programma
+n='
+'
+
+# Inizializza delle variabili alla stringa nulla
+programma=
+opts=
+
+while [ $# -ne 0 ] # ciclo sugli argomenti
+do
+ case $1 in
+ --) shift
+ break ;;
+
+ -W) shift
+ # Il costrutto address@hidden'messaggio qui'@} stampa un
+ # messaggio diagnostico se $x @`e la stringa nulla
+ set -- -W"address@hidden@@?'manca operando'@}"
+ continue ;;
+
+ -[vF]) opts="$opts $1 'address@hidden'manca operando'@}'"
+ shift ;;
+
+ -[vF]*) opts="$opts '$1'" ;;
+
+ -f) programma="$programma$n@@include address@hidden'manca operando'@}"
+ shift ;;
+
+ -f*) f=$(expr "$1" : '-f\(.*\)')
+ programma="$programma$n@@include $f" ;;
+
+ -[W-]file=*)
+ f=$(expr "$1" : '-.file=\(.*\)')
+ programma="$programma$n@@include $f" ;;
+
+ -[W-]file)
+ programma="$programma$n@@include address@hidden'manca operando'@}"
+ shift ;;
+
+ -[W-]source=*)
+ t=$(expr "$1" : '-.source=\(.*\)')
+ programma="$programma$n$t" ;;
+
+ -[W-]source)
+ programma="address@hidden'manca operando'@}"
+ shift ;;
+
+ -[W-]version)
+ echo igawk: version 3.0 1>&2
+ gawk --version
+ exit 0 ;;
+
+ -[W-]*) opts="$opts '$1'" ;;
+
+ *) break ;;
+ esac
+ shift
+done
+
+if [ -z "$programma" ]
+then
+ address@hidden'manca programma'@}
+ shift
+fi
+
+# A questo punto, `programma' contiene il programma.
address@hidden endfile
address@hidden example
+
+Il programma @command{awk} che elabora le direttive @code{@@include}
address@hidden immagazzinato nella variabile di shell @code{progr_che_espande}.
address@hidden serve
+a mantenere leggibile lo script. Questo programma @command{awk} legge
+tutto il programma dell'utente, una riga per volta, usando @code{getline}
+(@pxref{Getline}). I @value{FNS} in input e le istruzioni @code{@@include}
+sono gestiti usando una pila. Man mano che viene trovata una @code{@@include},
+il valore corrente di @value{FN} @`e
+``spinto'' sulla pila e il file menzionato nella direttiva @code{@@include}
+diventa il @value{FN} corrente. Man mano che un file @`e finito,
+la pila viene ``disfatta'', e il precedente file in input diventa nuovamente il
+file in input corrente. Il processo viene iniziato ponendo il file originale
+come primo file sulla pila.
+
+La funzione @code{percorso()} trova qual @`e il percorso completo di un file.
+Simula il comportamento di @command{gawk} quando utilizza la variabile
+d'ambiente @env{AWKPATH}
+(@pxref{AWKPATH (Variabile)}).
+Se un @value{FN} contiene una @samp{/}, non viene effettuata la ricerca del
+percorso. Analogamente, se il
address@hidden @`e @code{"-"}, viene usato senza alcuna modifica. Altrimenti,
+il @value{FN} @`e concatenato col nome di ogni directory nella lista dei
+percorsi, e vien fatto un tentativo per aprire il @value{FN}
address@hidden@dotless{i}} generato.
+Il solo modo di controllare se un file @`e leggibile da @command{awk} @`e di
+andare avanti e tentare di leggerlo con
address@hidden; questo @`e quel che
address@hidden()} address@hidden alcune versioni molto datate di
address@hidden, il test @samp{getline da_buttare < t} address@hidden ripetersi
in un ciclo
+infinito se il file esiste ma @`e vuoto.}
+Se il file address@hidden essere letto, viene chiuso e viene restituito il
valore di
address@hidden:
+
address@hidden
+An alternative way to test for the file's existence would be to call
address@hidden("test -r " t)}, which uses the @command{test} utility to
+see if the file exists and is readable. The disadvantage to this method
+is that it requires creating an extra process and can thus be slightly
+slower.
address@hidden ignore
+
address@hidden
address@hidden file eg/prog/igawk.sh
+progr_che_espande='
+
+function percorso(file, i, t, da_buttare)
address@hidden
+ if (index(file, "/") != 0)
+ return file
+
+ if (file == "-")
+ return file
+
+ for (i = 1; i <= n_dir; i++) @{
+ t = (lista_percorsi[i] "/" file)
address@hidden
+ if ((getline da_buttare < t) > 0) @{
+ # found it
+ close(t)
+ return t
+ @}
address@hidden group
+ @}
+ return ""
address@hidden
address@hidden endfile
address@hidden example
+
+Il programma principale @`e contenuto all'interno di una regola @code{BEGIN}.
+La prima cosa che fa @`e di impostare il vettore @code{lista_percorsi} usato
+dalla funzione @code{percorso()}. Dopo aver diviso la lista usando come
+delimitatore @samp{:}, gli elementi nulli sono sostituiti da @code{"."},
+che rappresenta la directory corrente:
+
address@hidden
address@hidden file eg/prog/igawk.sh
+BEGIN @{
+ percorsi = ENVIRON["AWKPATH"]
+ n_dir = split(percorsi, lista_percorsi, ":")
+ for (i = 1; i <= n_dir; i++) @{
+ if (lista_percorsi[i] == "")
+ lista_percorsi[i] = "."
+ @}
address@hidden endfile
address@hidden example
+
+La pila @`e inizializzata con @code{ARGV[1]}, che address@hidden
@code{"/dev/stdin"}.
+Il ciclo principale viene subito dopo. Le righe in input sono lette una dopo
+l'altra. Righe che non iniziano con @code{@@include} sono stampate
address@hidden@dotless{i}} come
+sono.
+Se la riga inizia con @code{@@include}, il @value{FN} @`e in @code{$2}.
+La funzione @code{percorso()} @`e chiamata per generare il percorso completo.
+Se questo non riesce, il programma stampa un messaggio di errore e continua.
+
+Subito dopo occorre controllare se il file sia address@hidden stato incluso.
Il vettore
address@hidden @`e indicizzato dal nome completo di ogni @value{FN} incluso
+e tiene traccia per noi di questa informazione. Se un file viene visto
address@hidden
+volte, viene stampato un messaggio di avvertimento. Altrimenti il nuovo
address@hidden @`e aggiunto alla pila e l'elaborazione continua.
+
+Infine, quando @code{getline} giunge alla fine del file in input, il file
+viene chiuso, e la pila viene elaborata. Quando @code{indice_pila} @`e minore
+di zero, il programma @`e terminato:
+
address@hidden
address@hidden file eg/prog/igawk.sh
+ indice_pila = 0
+ input[indice_pila] = ARGV[1] # ARGV[1] @`e il primo file
+
+ for (; indice_pila >= 0; indice_pila--) @{
+ while ((getline < input[indice_pila]) > 0) @{
+ if (tolower($1) != "@@include") @{
+ print
+ continue
+ @}
+ cammino = percorso($2)
address@hidden
+ if (cammino == "") @{
+ printf("igawk: %s:%d: non riesco a trovare %s\n",
+ input[indice_pila], FNR, $2) > "/dev/stderr"
+ continue
+ @}
address@hidden group
+ if (! (cammino in gia_fatto)) @{
+ gia_fatto[cammino] = input[indice_pila]
+ input[++indice_pila] = cammino # aggiungilo alla pila
+ @} else
+ print $2, "incluso in", input[indice_pila],
+ "era address@hidden incluso in",
+ gia_fatto[cammino] > "/dev/stderr"
+ @}
+ close(input[indice_pila])
+ @}
address@hidden' # l'apice chiude la variabile `progr_che_espande'
+
+programma_elaborato=$(gawk -- "$progr_che_espande" /dev/stdin << EOF
+$programma
+EOF
+)
address@hidden endfile
address@hidden example
+
+Il costrutto di shell @address@hidden << @var{marcatore}} @`e chiamato
address@hidden document} (@dfn{documento sul posto}). Ogni riga presente nello
+script di shell fino al @var{marcatore} @`e passato in input a @var{comando}.
+La shell elabora i contenuti dell'@dfn{here document} sostituendo, dove serve,
+variabili e comandi (ed eventualmente altre cose, a seconda della shell
+in uso).
+
+Il costrutto di shell @samp{$(@dots{})} @`e chiamato @dfn{sostituzione di
comando}.
+L'output del comando posto all'interno delle parentesi @`e sostituito
+nella riga di comando.
+Poich@'e il risultato @`e usato in un assegnamento di variabile,
+viene salvato come un'unica stringa di caratteri, anche se il risultato
+contiene degli spazi bianchi.
+
+Il programma espanso @`e salvato nella variabile @code{programma_elaborato}.
+Il tutto avviene secondo le fasi seguenti:
+
address@hidden
address@hidden
+Si esegue @command{gawk} con il programma che gestisce le @code{@@include}
+(il valore della variabile di shell
address@hidden) leggendo lo standard input.
+
address@hidden
+Lo standard input contiene il programma dell'utente,
+nella variabile di shell @code{programma}.
+L'input @`e passato a @command{gawk} tramite un @dfn{here document}.
+
address@hidden
+I risultati di questo processo sono salvati nella variabile di shell
address@hidden usando la sostituzione di comando.
address@hidden enumerate
+
+L'ultima fase @`e la chiamata a @command{gawk} con il programma espanso,
+insieme alle opzioni originali e agli argomenti della riga di comando che
+l'utente aveva fornito:
+
address@hidden
address@hidden file eg/prog/igawk.sh
+eval gawk $opts -- '"$programma_elaborato"' '"$@@"'
address@hidden endfile
address@hidden example
+
+Il comando @command{eval} @`e una struttura della shell che riesegue
+l'elaborazione dei parametri della riga di comando. Gli apici proteggono le
+parti restanti.
+
+Questa versione di @command{igawk} @`e la quinta versione di questo programma.
+Ci sono quattro semplificazioni migliorative:
+
address@hidden @value{BULLET}
address@hidden
+L'uso di @code{@@include} anche per i file specificati tramite l'opzione
address@hidden consente di semplificare di molto la preparazione del programma
+iniziale @command{awk}; tutta l'elaborazione delle istruzioni @code{@@include}
address@hidden essere svolta in una sola volta.
+
address@hidden
+Non tentare di salvare la riga letta tramite @code{getline} all'interno della
+funzione @code{percorso()} quando si controlla se il file @`e accessibile
+per il successivo uso nel programma principale semplifica notevolmente
+le cose.
+
address@hidden
+Usare un ciclo di @code{getline} nella regola @code{BEGIN} rende possibile
+fare tutto in un solo posto. Non @`e necessario programmare un ulteriore ciclo
+per elaborare le istruzioni @code{@@include} nidificate.
+
address@hidden
+Invece di salvare il programma espanso in un file temporaneo, assegnarlo a
+una variabile di shell evita alcuni potenziali problemi di sicurezza.
address@hidden address@hidden ha lo svantaggio di basare lo script su
address@hidden del
+linguaggio @command{sh}, il che rende address@hidden difficile la comprensione
a chi non
+abbia address@hidden con il comando
address@hidden
address@hidden itemize
+
+Inoltre, questo programma dimostra come spesso valga la pena di utilizzare
+insieme la programmazione della @command{sh} e quella di @command{awk}.
+Solitamente, si address@hidden fare parecchio senza dover ricorrere alla
programmazione
+di basso livello in C o C++, ed @`e spesso address@hidden facile fare certi
tipi di
+manipolazioni di stringhe e argomenti usando la shell, piuttosto che
address@hidden
+
+Infine, @command{igawk} dimostra che non @`e sempre necessario aggiungere nuove
address@hidden a un programma; queste possono spesso essere aggiunte in
address@hidden@command{gawk}
address@hidden in grado di elaborare istruzioni @code{@@include} al suo stesso
interno, per
+permettere l'uso di programmi @command{awk} come script Web CGI.}
+
+
address@hidden Programma anagram
address@hidden Trovare anagrammi da una lista di parole
+
address@hidden anagrammi, trovare
+Un'interessante sfida per il programmatore @`e quella di cercare
@dfn{anagrammi} in una
+lista di parole (come
address@hidden/usr/share/dict/italian} presente in molti sistemi GNU/Linux).
+Una parola @`e un anagramma di un'altra se entrambe le parole contengono
+le stesse lettere
+(p.es., ``branzino'' e ``bronzina'').
+
+La Colonna 2, Problema C, della seconda edizione del libro di Jon Bentley
address@hidden Pearls}, presenta un algoritmo elegante.
+L'idea @`e di assegnare a parole che sono anagrammi l'una dell'altra una
+firma comune, e poi di ordinare tutte le parole in base alla loro
+firma e di stamparle.
+Il Dr.@: Bentley fa notare che prendere tutte le lettere di ogni parola ed
+elencarle in ordine alfabetico produce queste firme comuni.
+
+Il programma seguente usa vettori di vettori per riunire
+parole con la stessa firma, e l'ordinamento di vettori per stampare le
+parole trovate in ordine alfabetico:
+
address@hidden @code{anagram.awk}, programma
address@hidden programma @code{anagram.awk}
address@hidden
address@hidden file eg/prog/anagram.awk
+# anagram.awk --- Un'implementazione dell'algoritmo per trovare anagrammi
+# dalla seconda edizione
+# del libro di Jon Bentley "Programming Pearls".
+# Addison Wesley, 2000, ISBN 0-201-65788-0.
+# Colonna 2, Problema C, sezione 2.8, pp 18-20.
address@hidden endfile
address@hidden
address@hidden file eg/prog/anagram.awk
+#
+# Questo programma richiede gawk 4.0 o una versione successiva.
+# address@hidden di gawk richieste:
+# - veri vettori multidimensionali
+# - split() con separatore "" per separare ogni singolo carattere
+# - le funzioni asort() e asorti()
+#
+# Vedere http://savannah.gnu.org/projects/gawk.
+#
+# Arnold Robbins
+# arnold@@skeeve.com
+# Public Domain
+# January, 2011
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/anagram.awk
+
+/'s$/ @{ next @} # Salta i genitivi sassoni
address@hidden endfile
address@hidden example
+
+Il programma inizia con un'intestazione, e poi una regola per saltare
+i genitivi sassoni eventualmente contenuti nel file che contiene la lista di
+parole. La regola
+successiva costruisce la struttura dei dati. Il primo indice del vettore
address@hidden rappresentato dalla firma; il secondo @`e la parola stessa:
+
address@hidden
address@hidden file eg/prog/anagram.awk
address@hidden
+ chiave = da_parola_a_chiave($1) # costruisce la firma
+ data[chiave][$1] = $1 # Immagazzina parola con questa firma
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{da_parola_a_chiave()} crea la firma.
+Divide la parola in lettere singole, mette in ordine alfabetico le lettere,
+e poi le rimette ancora insieme:
+
address@hidden
address@hidden file eg/prog/anagram.awk
+# da_parola_a_chiave --- divide parole in lettere, ordina e riunisce
+
+function da_parola_a_chiave(parola, a, i, n, risultato)
address@hidden
+ n = split(parola, a, "")
+ asort(a)
+
+ for (i = 1; i <= n; i++)
+ risultato = risultato a[i]
+
+ return risultato
address@hidden
address@hidden endfile
address@hidden example
+
+Infine, la regola @code{END} percorre tutto il vettore e stampa
+le liste degli anagrammi. L'output @`e poi passato al
+comando di sistema @command{sort} perch@'e altrimenti gli
+anagrammi sarebbero elencati in ordine arbitrario:
+
address@hidden
address@hidden file eg/prog/anagram.awk
+END @{
+ sort = "sort"
+ for (chiave in data) @{
+ # ordina parole con la stessa chiave
+ n_parole = asorti(data[chiave], parole)
+ if (n_parole == 1)
+ continue
+
+ # e stampa. Problema minore: uno spazio extra a fine di ogni riga
+ for (j = 1; j <= n_parole; j++)
+ printf("%s ", parole[j]) | sort
+ print "" | sort
+ @}
+ close(sort)
address@hidden
address@hidden endfile
address@hidden example
+
+Ecco una piccola parte dell'output quando il programma @`e eseguito:
+
address@hidden
+$ @kbd{gawk -f anagram.awk /usr/share/dict/italian | grep '^b'}
address@hidden
+baraste bastare serbata
+barasti basarti
+baratro tabarro
+barattoli ribaltato tribolata
+barbieri birberia
+barche brache
+barcollerei corbelleria
+bare erba
+bareremmo brameremo
+barili librai
address@hidden
address@hidden example
+
+
address@hidden Programma signature
address@hidden E ora per qualcosa di completamente differente
+
address@hidden @code{signature}, programma
address@hidden programma @code{signature}
address@hidden Brini, Davide
+Il programma seguente @`e stato scritto da Davide Brini
address@hidden (@email{dave_br@@gmx.com})
+ed @`e pubblicato sul
@uref{http://backreference.org/2011/02/03/obfuscated-awk/,
+suo sito web}.
+Serve come sua firma nel gruppo Usenet @code{comp.lang.awk}.
+Questi sono i termini da lui stabiliti per il copyright:
+
address@hidden
+Copyright @copyright{} 2008 Davide Brini
+
+Copying and distribution of the code published in this page, with or without
+modification, are permitted in any medium without royalty provided the
copyright
+notice and this notice are preserved.
address@hidden quotation
+
+Ecco il programma:
+
address@hidden
+awk 'address@hidden"~"~"~";o="=="=="==";o+=+o;x=O""O;while(X++<=x+o+o)c=c"%c";
+printf c,(x-O)*(x-O),x*(x-o)-o,x*(x-O)+x-O-o,+x*(x-O)-x+o,X*(o*o+O)+x-O,
+X*(X-x)-o*o,(x+X)*o*o+o,x*(X-x)-O-O,x-O+(O+o+X+x)*(o+O),X*X-X*(x-O)-x+O,
+O+X*(o*(o+O)+O),+x+O+X*o,x*(x-o),(o+X+x)*o*o-(x-O-O),O+(X-x)*(X+O),address@hidden'
address@hidden example
address@hidden genera l'email del tizio:
address@hidden address@hidden
+
address@hidden Johansen, Chris
+Viene lasciato al lettore il piacere di stabilire cosa fa il programma.
+(Se si @`e sull'orlo della disperazione nel tentativo di comprensione, si veda
+la spiegazione di Chris Johansen,
+che @`e contenuta nel file sorgente Texinfo di questo @value{DOCUMENT}.)
+
address@hidden
+To: "Arnold Robbins" <address@hidden>
+Date: Sat, 20 Aug 2011 13:50:46 -0400
+Subject: The GNU Awk User's Guide, Section 13.3.11
+From: "Chris Johansen" <address@hidden>
+Message-ID: <address@hidden>
+
+Arnold, tu non mi conosci, ma c'@`e un sottile legame tra noi. Mia moglie @`e
+Barbara A. Field, FAIA, GIT '65 (B. Arch.).
+
+Ho un paio di copie cartacee di "Effective Awk Programming" da
+anni, ed ora sto leggendo di nuovo la versione Kindle di "The GNU Awk User's
+Guide". Quando sono arrivato alla sezione 13.3.11, ho riformattato e
+brevemente commentato lo script di firma di Davide Brin per comprenderne il
funzionamento.
+
+Mi pare che questo possa avere un valore pedagogico come esempio
+(sia pure imperfetto) del significato di spazi bianchi e commenti, e un
+punto di partenza per una tale discussione. Sicuramente ha aiutato _me_ a
+capire quel che succede. Se vuoi
+usarlo, com'@`e o modificato, sentiti libero di farlo (a condizione di
+rispettare i vincoli posti da Davide, naturalmente, che credo siano stati
+da me rispettati).
+
+Se dovessi includere questa spiegazione in una futura edizione, la inserirei
+a una certa distanza dalla sezione 13.3.11, diciamo come una nota o come
+un'appendice, in modo da non rivelare immediatamente la soluzione dell'enigma.
+
+Cordiali saluti,
+--
+Chris Johansen {johansen at main dot nc dot us}
+ . . . collapsing the probability wave function, sending ripples of
+certainty through the space-time continuum.
+
+
+#! /usr/bin/gawk -f
+
+# Da "13.3.11 E ora per qualcosa di completamente differente"
+#
http://www.gnu.org/software/gawk/manual/html_node/Signature-Program.html#Signature-Program
+
+# Copyright é 2008 Davide Brini
+
+# Copying and distribution of the code published in this page, with
+# or without modification, are permitted in any medium without
+# royalty provided the copyright notice and this notice are preserved.
+
+BEGIN {
+ O = "~" ~ "~"; # 1
+ o = "==" == "=="; # 1
+ o += +o; # 2
+ x = O "" O; # 11
+
+
+ while ( X++ <= x + o + o ) c = c "%c";
+
+ # O vale 1
+ # o vale 2
+ # x vale 11
+ # X vale 17
+ # c vale "%c%c%c%c%c%c%c%c%c%c%c%c%c%c%c%c"
+
+ printf c,
+ ( x - O )*( x - O), # 100 d
+ x*( x - o ) - o, # 97 a
+ x*( x - O ) + x - O - o, # 118 v
+ +x*( x - O ) - x + o, # 101 e
+ X*( o*o + O ) + x - O, # 95 _
+ X*( X - x ) - o*o, # 98 b
+ ( x + X )*o*o + o, # 114 r
+ x*( X - x ) - O - O, # 64 @
+ x - O + ( O + o + X + x )*( o + O ), # 103 g
+ X*X - X*( x - O ) - x + O, # 109 m
+ O + X*( o*( o + O ) + O ), # 120 x
+ +x + O + X*o, # 46 .
+ x*( x - o), # 99 c
+ ( o + X + x )*o*o - ( x - O - O ), # 111 0
+ O + ( X - x )*( X + O ), # 109 m
+ x - O # 10 \n
+}
address@hidden ignore
+
address@hidden Sommario dei programmi
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+I programmi illustrati in questo @value{CHAPTER}
+ripropongo la tesi secondo cui leggere programmi @`e una maniera eccellente
+per imparare a fare della buona programmazione.
+
address@hidden
+Usare @samp{#!} per rendere i programmi @command{awk} direttamente eseguibili
+ne rende address@hidden semplice l'uso. In alternativa, si address@hidden
invocare un
+programma usando @samp{awk -f @dots{}}.
+
address@hidden
+Reimplementare programmi POSIX standard in @command{awk} @`e un esercizio
+piacevole; il potere espressivo di @command{awk} consente di scrivere tali
+programmi usando relativamente poche righe di codice, nonostante i programmi
+risultanti siano funzionalmente completi e utilizzabili.
+
address@hidden
+Una delle debolezze della versione standard di @command{awk} riguarda il
+lavorare con singoli caratteri. La address@hidden di usare @code{split()} con
+la stringa nulla come separatore address@hidden semplificare considerevolmente
tale
+compito.
+
address@hidden
+Gli esempi proposti dimostrano l'address@hidden delle funzioni di libreria
introdotte
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria}
+per un numero (sia pur piccolo) di programmi reali.
+
address@hidden
+Oltre a reinventare la ruota POSIX, altri programmi risolvono una serie di
+problemi interessanti, come trovare delle parole duplicate in un testo,
+stampare etichette per lettere, e trovare anagrammi.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi sui programmi
address@hidden Esercizi
+
address@hidden
address@hidden
+Riscrivere @file{cut.awk} (@pxref{Programma cut})
+usando @code{split()} con @code{""} come separatore.
+
address@hidden
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden egrep}, @`e detto che @samp{egrep -i} potrebbe essere
+simulato in versioni di @command{awk} che non prevedono @code{IGNORECASE}
+usando @code{tolower()} sulla riga e nei criteri di ricerca. In una nota a
address@hidden di pagina @`e anche detto che questa soluzione ha un problema:
in output
+viene scritta la riga tradotta (a lettere minuscole), e non quella originale.
+Risolvere questo problema.
address@hidden Exercise: Fix this, w/array and new line as key to original line
+
address@hidden
+La versione POSIX di @command{id} accetta opzioni che controllano quali
+informazioni stampare. Modificare la versione @command{awk}
+(@pxref{Programma id}) per accettare gli stessi argomenti e funzionare allo
+stesso modo.
+
address@hidden
+Il programma @code{split.awk} (@pxref{Programma split}) presuppone che le
+lettere siano contigue nella codifica dei caratteri,
+il che non @`e vero per sistemi che usano la codifica EBCDIC.
+Risolvere questo problema.
+(Suggerimento: Considerare un modo diverso di analizzare l'alfabeto,
+senza appoggiarsi sulle funzioni @code{ord()} e @code{chr()}.)
+
address@hidden
+Nel programma @file{uniq.awk} (@pxref{Programma uniq}, la
+logica per scegliere quali righe stampare rappresenta una
address@hidden a stati},
+ossia ``un dispositivo che address@hidden essere in uno di un insieme di stati
+stabili, a seconda dello stato in cui si trovava in precedenza, e del
+valore corrente dei suoi
+input.''@footnote{Questo @`e la definizione trovata usando
address@hidden: state machine} come chiave di ricerca in Google.}
+Brian Kernighan suggerisce che
+``un approccio alternativo alle macchine a stati @`e di leggere tutto l'input
+e metterlo in un vettore, e quindi usare gli indici. @`E quasi sempre
address@hidden
+semplice da programmare, e per la maggior parte degli input in cui si
address@hidden
+usare, altrettanto veloce in esecuzione.'' Riscrivere la logica del
+programma seguendo questa indicazione.
+
+
address@hidden
+Perch@'e il programma @file{wc.awk} (@pxref{Programma wc}) non address@hidden
+limitarsi a usare il valore di @code{FNR} nella funziona @code{a_fine_file()}?
+Suggerimento: Esaminare il codice
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden filetrans}.
+
address@hidden
address@hidden can't just use the value of @code{FNR} in
address@hidden()}. If you examine the code in @ref{Filetrans Function},
+you will see that @code{FNR} has already been reset by the time
address@hidden()} is called.
address@hidden ignore
+
address@hidden
+La manipolazione di singoli caratteri nel programma @command{translate}
+(@pxref{Programma translate}) @`e farraginosa usando le funzione standard
address@hidden Poich@'e @command{gawk} address@hidden dividere stringhe in
caratteri
+singoli usando come separatore @code{""}, come si potrebbe usare questa
address@hidden per semplificare il programma?
+
address@hidden
+Il programma @file{extract.awk} (@pxref{Programma extract}) @`e stato
+scritto prima che @command{gawk} avesse a disposizione la funzione
address@hidden()}. Usarla per semplificare il codice.
+
address@hidden
+Si confronti la address@hidden di esecuzione del programma @file{awksed.awk}
+(@pxref{Programma sed semplice}) con il address@hidden diretto:
+
address@hidden
+BEGIN @{
+ stringa = ARGV[1]
+ rimpiazzo = ARGV[2]
+ ARGV[1] = ARGV[2] = ""
address@hidden
+
address@hidden gsub(stringa, rimpiazzo); print @}
address@hidden example
+
address@hidden
+Quali sono vantaggi e svantaggi di @file{awksed.awk} rispetto al vero
+programma di address@hidden @command{sed}?
+
address@hidden
+ Advantage: egrep regexps
+ speed (?)
+ Disadvantage: no & in replacement text
+
+Others?
address@hidden ignore
+
address@hidden
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden igawk}, si @`e detto che non tentando di salvare la riga
+letta con @code{getline} nella funzione @code{percorso()}, mentre si
+controlla l'address@hidden del file da usare nel programma principale,
+semplifica notevolmente le cose. Quale problema @`e peraltro generato
address@hidden@dotless{i}}
+facendo?
address@hidden answer, reading from "-" o /dev/stdin
+
address@hidden percorso di ricerca per file sorgente
address@hidden ricerca, percorso di, per file sorgente
address@hidden file sorgente, percorso di ricerca per
address@hidden directory, ricerca
address@hidden
+Come ulteriore esempio dell'idea che non sempre @`e necessario aggiungere
+nuove address@hidden a un programma, si consideri l'idea di avere due file in
+una directory presente nel percorso di ricerca:
+
address@hidden @file
address@hidden default.awk
+Questo file contiene un insieme di funzioni di libreria di default, come
address@hidden()} e @code{assert()}.
+
address@hidden sito.awk
+Questo file contiene funzioni di libreria che sono specifiche di
+un sito o di un'installazione; address@hidden, funzioni sviluppate localmente.
+Mantenere due file separati consente a @file{default.awk} di essere
+modificato in seguito a nuove versioni di @command{gawk}, senza che
+l'amministratore di sistema debba ogni volta aggiornarlo aggiungendo le
+funzioni locali.
address@hidden table
+
+Un utente
address@hidden Karl Berry, address@hidden, 10/95
+ha suggerito che @command{gawk} venga modificato per leggere automaticamente
+questi file alla partenza. Piuttosto, sarebbe molto semplice
+modificare @command{igawk} per farlo. Poich@'e @command{igawk} @`e capace di
+elaborare direttive @code{@@include}
+nidificate, @file{default.awk} potrebbe contenere semplicemente la lista di
+direttive @code{@@include} con le funzioni di libreria desiderate.
+Fare questa modifica.
+
address@hidden
+Modificare @file{anagram.awk} (@pxref{Programma anagram}), per evitare di
+usare il programma di address@hidden esterno @command{sort}.
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden
address@hidden @value{PART3}Andare oltre @command{awk} con @command{gawk}
address@hidden ifnotinfo
+
address@hidden
+La Parte III riguarda address@hidden proprie di @command{gawk}.
+Contiene i seguenti capitoli:
+
address@hidden @value{BULLET}
address@hidden
address@hidden@`a avanzate}
+
address@hidden
address@hidden
+
address@hidden
address@hidden
+
address@hidden
address@hidden con precisione arbitraria}
+
address@hidden
address@hidden dinamiche}
address@hidden itemize
address@hidden ifdocbook
+
address@hidden address@hidden avanzate
address@hidden address@hidden avanzate di @command{gawk}
address@hidden @command{gawk}, address@hidden avanzate
address@hidden avanzate, address@hidden, di @command{gawk}
address@hidden
+Contributed by: Peter Langston <address@hidden>
+
+ Found in Steve English's "signature" line:
+
+"Write documentation as if whoever reads it is a violent psychopath
+who knows where you live."
address@hidden ignore
address@hidden Langston, Peter
address@hidden English, Steve
address@hidden
address@hidden la documentazione supponendo che chiunque la address@hidden sia
uno psicopatico
+violento, che conosce il vostro indirizzo di casa.}
address@hidden Steve English, citato da Peter Langston
address@hidden quotation
+
+Questo @value{CHAPTER} tratta delle address@hidden avanzate in @command{gawk}.
address@hidden un po' come un ``pacco sorpresa'' di argomenti che non sono
collegati tra di
+loro in altro modo.
+Per prima cosa, vediamo un'opzione da riga di comando che consente a
address@hidden di riconoscere i numeri non-decimali nei dati in input, e non
+soltanto nei programmi @command{awk}.
+Poi vengono illustrate delle address@hidden speciali di @command{gawk} per
+l'ordinamento di vettori. Quindi viene trattato dettagliatamente l'I/O
+bidirezionale, di cui si @`e fatto cenno in precedenti parti di questo
address@hidden, assieme ai fondamenti sulle reti TCP/IP.
+Infine, vediamo come @command{gawk}
address@hidden tracciare il @dfn{profilo} di un programma @command{awk},
address@hidden@dotless{i}} che si
+possa ritoccarlo per migliorarne le prestazioni.
+
address@hidden FULLXREF ON
+Altre address@hidden avanzate vengono trattate separatamente dedicando un
address@hidden per ciascuna di esse:
+
address@hidden @value{BULLET}
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden, parla di come internazionalizzare
+i propri programmi @command{awk}, in modo che parlino address@hidden lingue
+nazionali.
+
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden, descrive il debugger dalla riga di comando disponibile
+all'interno di
address@hidden per individuare errori nei programmi @command{awk}.
+
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden con precisione arbitraria}, illustra come si address@hidden usare
address@hidden per eseguire calcoli con precisione arbitraria.
+
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden dinamiche},
+tratta della address@hidden di aggiungere dinamicamente nuove funzioni
predefinite a
address@hidden
address@hidden itemize
address@hidden FULLXREF OFF
+
address@hidden
+* Dati non decimali:: Consentire dati di input non decimali.
+* Ordinamento di vettori:: Modi per controllare la visita di un vettore
+ e il suo ordinamento.
+* I/O bidirezionale:: Comunicazione bidirezionale con un altro
+ processo.
+* Reti TCP/IP:: Usare @command{gawk} per programmazione di
rete.
+* Profilare:: Profilare i propri programmi @command{awk}.
+* Sommario address@hidden avanzate:: Sommario delle address@hidden avanzate.
address@hidden menu
+
address@hidden Dati non decimali
address@hidden Consentire dati di input non decimali
address@hidden opzione @option{--non-decimal-data}
address@hidden @cindex address@hidden avanzate, dati di input non decimali
address@hidden input, dati non decimali
address@hidden costanti, non decimali
+
+Se si esegue @command{gawk} con l'opzione @option{--non-decimal-data},
+si possono avere valori in base diversa da dieci nei dati di input:
+
address@hidden
+$ @kbd{echo 0123 123 0x123 |}
+> @kbd{gawk --non-decimal-data '@{ printf "%d, %d, %d\n", $1, $2, $3 @}'}
address@hidden 83, 123, 291
address@hidden example
+
+Affinch@'e questa address@hidden sia disponibile, i programmi devono essere
+scritti in modo che @command{gawk} tratti i dati come valori numerici:
+
address@hidden
+$ @kbd{echo 0123 123 0x123 | gawk '@{ print $1, $2, $3 @}'}
address@hidden 0123 123 0x123
address@hidden example
+
address@hidden
+L'istruzione @code{print} tratta le sue espressioni come se fossero stringhe.
+Sebbene i campi possano comportarsi come numeri, quando necessario,
+essi rimangono sempre stringhe, per cui @code{print} non cerca di elaborarli
+come se fossero numeri. Si deve aggiungere zero a un campo affich@'e venga
+considerato come un numero. Per esempio:
+
address@hidden
+$ @kbd{echo 0123 123 0x123 | gawk --non-decimal-data '}
+> @address@hidden print $1, $2, $3}
+> @kbd{print $1 + 0, $2 + 0, $3 + 0 @}'}
address@hidden 0123 123 0x123
address@hidden 83 123 291
address@hidden example
+
+Poich@'e capita comunemente di avere dati di tipo decimale con degli zeri
iniziali,
+e poich@'e l'uso di questa address@hidden address@hidden portare a risultati
inattesi, il
+comportamento di default @`e quello lasciarla disabilitata. Se si vuole, la si
+deve richiedere esplicitamente.
+
address@hidden programmazione, convenzioni di, opzione @code{--non-decimal-data}
address@hidden @option{--non-decimal-data}, opzione, funzione @code{strtonum()}
e
address@hidden @code{strtonum()}, funzione (@command{gawk}), opzione
@code{--non-decimal-data} e
address@hidden ATTENZIONE
address@hidden'uso di questa opzione non @`e consigliata.}
address@hidden provocare errori molto seri eseguendo vecchi programmi.
+Al suo posto @`e meglio usare la funzione @code{strtonum()} per convertire i
dati
+(@pxref{Funzioni per stringhe}).
+Questo rende i programmi address@hidden facili da scrivere e address@hidden
facili da leggere, e
+porta a risultati meno inattesi.
+
+Quest'opzione potrebbe sparire dalle versioni future di @command{gawk}.
address@hidden quotation
+
address@hidden Ordinamento di vettori
address@hidden Controllare la visita di un vettore e il suo ordinamento
+
address@hidden permette di controllare l'ordine con cui un ciclo
address@hidden (@var{indice} in @var{vettore})}
+attraversa un vettore.
+
+Inoltre, due funzioni predefinite, @code{asort()} e @code{asorti()},
+permettono di mettere in ordine i vettori sulla base, rispettivamente, dei
+valori e degli indici del vettore. Queste due funzioni danno anche il
+controllo sui criteri in base ai quali riordinare gli elementi del vettore.
+
address@hidden
+* Controllare visita vettori:: Come usare PROCINFO["sorted_in"].
+* Funzioni di ordinamento di vettori:: Come usare @code{asort()} e
@code{asorti()}.
address@hidden menu
+
address@hidden Controllare visita vettori
address@hidden Controllare visita vettori
+
+Per default, l'ordine secondo il quale un ciclo @samp{for (@var{indice} in
address@hidden)} scorre un vettore non @`e definito; in genere si basa
+sull'implementazione interna dei vettori all'interno di @command{awk}.
+
+Spesso, tuttavia, si vorrebbe poter eseguire un ciclo sugli elementi in un
+determinato ordine scelto dall'utente programmatore. Con @command{gawk}
+si address@hidden fare.
+
address@hidden
+La
address@hidden iftex
address@hidden visita} parla di come si possono assegnare valori speciali
+predefiniti a @code{PROCINFO["sorted_in"]} per controllare l'ordine secondo il
+quale @command{gawk} attraversa un vettore
+durante un ciclo @code{for}.
+
+Inoltre, il valore di @code{PROCINFO["sorted_in"]} address@hidden essere un
nome di
address@hidden @`e il motivo per cui gli ordinamenti predefiniti
+iniziano con il carattere @samp{@@}, che non address@hidden essere usato in un
+identificatore.}
+Questo consente di scorrere un vettore sulla base di un qualsiasi criterio
+personalizzato. Gli elementi del vettore vengono ordinati in accordo col valore
+ritornato da questa funzione. La funzione che fa il confronto dovrebbe essere
+definita con almeno quattro argomenti:
+
address@hidden
+function confronta(i1, v1, i2, v2)
address@hidden
+ @var{confronta gli elementi 1 e 2 in qualche modo}
+ @var{return < 0; 0; o > 0}
address@hidden
address@hidden example
+
+Qui, @code{i1} e @code{i2} sono gli indici, e @code{v1} e @code{v2}
+sono i corrispondenti valori dei due elementi che si stanno confrontando.
address@hidden oppure @code{v2}, o entrambi, possono essere vettori se il
vettore
+che si sta visitando contiene sottovettori come valori.
+(@xref{Vettori di vettori} per maggiori informazioni sui sottovettori.)
+I tre possibili valori di ritorno sono interpretati nel seguente modo:
+
address@hidden @code
address@hidden confronta(i1, v1, i2, v2) < 0
+L'indice @code{i1} viene prima dell'indice @code{i2} durante l'avanzamento
+del ciclo.
+
address@hidden confronta(i1, v1, i2, v2) == 0
+Gli indici @code{i1} e @code{i2}
+sono equivalenti, ma l'ordine tra loro non @`e definito.
+
address@hidden confronta(i1, v1, i2, v2) > 0
+L'indice @code{i1} viene dopo l'indice @code{i2} durante l'avanzamento del
+ciclo.
address@hidden table
+
+La prima funzione di confronto address@hidden essere usata per scorrere un
vettore
+secondo l'ordine numerico degli indici:
+
address@hidden
+function cfr_ind_num(i1, v1, i2, v2)
address@hidden
+ # confronto di indici numerici, ordine crescente
+ return (i1 - i2)
address@hidden
address@hidden example
+
+La seconda funzione scorre un vettore secondo l'ordine delle stringhe
+dei valori degli elementi piuttosto che secondo gli indici:
+
address@hidden
+function cfr_val_str(i1, v1, i2, v2)
address@hidden
+ # confronto di valori di stringa, ordine crescente
+ v1 = v1 ""
+ v2 = v2 ""
+ if (v1 < v2)
+ return -1
+ return (v1 != v2)
address@hidden
address@hidden example
+
+La terza funzione di confronto restituisce dapprima tutti i numeri, e dopo
+questi le stringhe numeriche senza spazi iniziali o finali, durante
+l'avanzamento del ciclo:
+
address@hidden
+function cfr_val_num_str(i1, v1, i2, v2, n1, n2)
address@hidden
+ # confronto mettendo i numeri prima dei valori di stringa,
+ # ordine crescente
+ n1 = v1 + 0
+ n2 = v2 + 0
+ if (n1 == v1)
+ return (n2 == v2) ? (n1 - n2) : -1
+ else if (n2 == v2)
+ return 1
+ return (v1 < v2) ? -1 : (v1 != v2)
address@hidden
address@hidden example
+
+Qui vediamo un programma principale che mostra come @command{gawk}
+si comporta usando ciascuna delle funzioni precedenti:
+
address@hidden
+BEGIN @{
+ data["uno"] = 10
+ data["due"] = 20
+ data[10] = "uno"
+ data[100] = 100
+ data[20] = "due"
+
+ f[1] = "cfr_ind_num"
+ f[2] = "cfr_val_str"
+ f[3] = "cfr_val_num_str"
+ for (i = 1; i <= 3; i++) @{
+ printf("Funzione di ordinamento: %s\n", f[i])
+ PROCINFO["sorted_in"] = f[i]
+ for (j in data)
+ printf("\tdata[%s] = %s\n", j, data[j])
+ print ""
+ @}
address@hidden
address@hidden example
+
+I risultati dell'esecuzione del programma sono questi:
+
address@hidden
+$ @kbd{gawk -f compdemo.awk}
address@hidden Funzione di ordinamento: cfr_ind_num @ii{Ordinamento per indice
numerico}
address@hidden data[uno] = 10
address@hidden data[due] = 20 @ii{Entrambe le stringhe sono
numericamente zero}
address@hidden data[10] = uno
address@hidden data[20] = due
address@hidden data[100] = 100
address@hidden
address@hidden Funzione di ordinamento: cfr_val_str @ii{Ordinamento per valore
degli}
address@hidden @ii{elementi come
stringhe}
address@hidden data[uno] = 10
address@hidden data[100] = 100 @ii{La stringa 100 @`e minore della
stringa 20}
address@hidden data[due] = 20
address@hidden data[20] = due
address@hidden data[10] = uno
address@hidden
address@hidden Funzione di ordinamento: cfr_val_num_str @ii{Ordinamento con
tutti i}
address@hidden @ii{valori numerici prima di tutte le
stringhe}
address@hidden data[uno] = 10
address@hidden data[due] = 20
address@hidden data[100] = 100
address@hidden data[20] = due
address@hidden data[10] = uno
address@hidden example
+
+Si provi a ordinare gli elementi di un file delle password del sistema
GNU/Linux
+in base al nome d'accesso dell'utente. Il seguente programma ordina i record
+secondo una specifica posizione del campo e address@hidden essere usato per
questo scopo:
+
address@hidden
+# passwd-sort.awk --- semplice programma per ordinare in base alla
+# posizione del campo
+# la posizione del campo @`e specificata dalla variabile globale POS
+
+function per_campo(i1, v1, i2, v2)
address@hidden
+ # confronto per valore, come stringa, e in ordine crescente
+ return v1[POS] < v2[POS] ? -1 : (v1[POS] != v2[POS])
address@hidden
+
address@hidden
+ for (i = 1; i <= NF; i++)
+ a[NR][i] = $i
address@hidden
+
+END @{
+ PROCINFO["sorted_in"] = "per_campo"
+ if (POS < 1 || POS > NF)
+ POS = 1
+ for (i in a) @{
+ for (j = 1; j <= NF; j++)
+ printf("%s%c", a[i][j], j < NF ? ":" : "")
+ print ""
+ @}
address@hidden
address@hidden example
+
+Il primo campo di ogni elemento del file delle password @`e il nome d'accesso
+dell'utente, e i campi sono separati tra loro da due punti.
+Ogni record definisce un sottovettore,
+con ogni campo come elemento nel sottovettore.
+L'esecuzione del programma produce
+il seguente output:
+
address@hidden
+$ @kbd{gawk -v POS=1 -F: -f sort.awk /etc/passwd}
address@hidden adm:x:3:4:adm:/var/adm:/sbin/nologin
address@hidden apache:x:48:48:Apache:/var/www:/sbin/nologin
address@hidden avahi:x:70:70:Avahi daemon:/:/sbin/nologin
address@hidden
address@hidden example
+
+Il confronto normalmente dovrebbe restituire sempre lo stesso valore quando
+vien dato come argomento un preciso paio di elementi del vettore. Se viene
+restituito un risultato non coerente, l'ordine @`e indefinito. Questo
+comportamento address@hidden essere sfruttato per introdurre un ordinamento
casuale in
+dati apparentemente ordinati:
+
address@hidden
+function ordina_a_caso(i1, v1, i2, v2)
address@hidden
+ # ordine casuale (attenzione: potrebbe non finire mai!)
+ return (2 - 4 * rand())
address@hidden
address@hidden example
+
+Come address@hidden accennato, l'ordine degli indici @`e arbitrario se due
elementi
+risultano uguali. Normalmente questo non @`e un problema, ma lasciare che
+elementi di uguale valore compaiano in ordine arbitrario address@hidden essere
un
+problema, specialmente quando si confrontano valori di elementi di un elenco.
+L'ordine parziale di elementi uguali address@hidden cambiare quando il vettore
viene
+visitato di nuovo, se nel vettore vengono aggiunti o rimossi elementi. Un modo
+per superare l'ostacolo quando si confrontano elementi con valori uguali @`e
+quello di includere gli indici nelle regole di confronto. Si noti che questo
+potrebbe rendere meno efficiente l'attraversamento del ciclo, per cui si
+consiglia di farlo solo se necessario. Le seguenti funzioni di confronto
+impongono un ordine deterministico, e si basano sul fatto che gli indici
+(di stringa) di due elementi non sono mai uguali:
address@hidden
+function per_numero(i1, v1, i2, v2)
address@hidden
+ # confronto di valori numerici (e indici), ordine decrescente
+ return (v1 != v2) ? (v2 - v1) : (i2 - i1)
address@hidden
+
+function per_stringa(i1, v1, i2, v2)
address@hidden
+ # confronto di valori di stringa (e indici), ordine decrescente
+ v1 = v1 i1
+ v2 = v2 i2
+ return (v1 > v2) ? -1 : (v1 != v2)
address@hidden
address@hidden example
+
address@hidden Avoid using the term ``stable'' when describing the
unpredictable behavior
address@hidden if two items compare equal. Usually, the goal of a "stable
algorithm"
address@hidden is to maintain the original order of the items, which is a
meaningless
address@hidden concept for a list constructed from a hash.
+
+Una funzione di confronto personalizzata spesso address@hidden semplificare
+l'attraversamento del
+ciclo ordinato, e il solo limite @`e il cielo, quando si va a progettare
+una funzione di questo tipo.
+
+Quando i confronti tra stringhe son fatti durante un'operazione di ordinamento,
+per valori di elementi che, uno o entrambi, non sono numeri, o per
+indici di elementi gestiti come stringhe, il valore di @code{IGNORECASE}
+(@pxref{Variabili predefinite}) controlla se
+i confronti trattano corrispondenti lettere maiuscole e minuscole
+come equivalenti o come distinte.
+
+Un'altra cosa da tenere a mente @`e che nel caso di sottovettori, i valori
degli
+elementi possono essere a loro volta dei vettori; una funzione di confronto in
+produzione dovrebbe usare la funzione @code{isarray()}
+(@pxref{Funzioni per i tipi})
+per controllare address@hidden, e scegliere un ordinamento preciso per i
sottovettori.
+
+Tutti gli ordinamenti basati su @code{PROCINFO["sorted_in"]}
+sono disabilitati in address@hidden POSIX,
+perch@'e il vettore @code{PROCINFO} in questo caso non @`e speciale.
+
+Come nota a margine, si @`e visto che ordinare gli indici del vettore prima di
+scorrere il vettore porta a un incremento variabile dal 15% al 20% del tempo di
+esecuzione dei programmi @command{awk}. Per questo motivo l'attraversamento
+ordinato di vettori non @`e il default.
+
address@hidden The @command{gawk}
address@hidden maintainers believe that only the people who wish to use a
address@hidden feature should have to pay for it.
+
address@hidden Funzioni di ordinamento di vettori
address@hidden Ordinare valori e indici di un vettore con @command{gawk}
+
address@hidden vettori, ordinamento dei
address@hidden
address@hidden @code{asort()}, funzione (@command{gawk}), ordinamento di vettori
address@hidden funzione @code{asort()} (@command{gawk}), ordinamento di vettori
address@hidden
address@hidden @code{asorti()}, funzione (@command{gawk}), ordinamento di
vettori
address@hidden funzione @code{asorti()} (@command{gawk}), ordinamento di vettori
address@hidden @code{sort()}, funzione, ordinamento di vettori
address@hidden funzione @code{sort()}, ordinamento di vettori
+Nella maggior parte delle implementazioni di @command{awk}, ordinare un vettore
+richiede una funzione @code{sort()}. Questo address@hidden essere istruttivo
per provare
+diversi algoritmi di ordinamento, ma normalmente non @`e questo lo scopo del
+programma. In @command{gawk} ci sono le funzioni predefinite @code{asort()} e
address@hidden()} (@pxref{Funzioni per stringhe}) per i vettori ordinati.
+Per esempio:
+
address@hidden
address@hidden il vettore} dati
+n = asort(dati)
+for (i = 1; i <= n; i++)
+ @var{fare qualcosa con} dati[i]
address@hidden example
+
+Dopo la chiamata ad @code{asort()}, il vettore @code{dati} @`e indicizzato da 1
+a @var{n}, il numero totale di elementi in @code{dati}.
+(Questo conteggio @`e il valore di ritorno di @code{asort()}).
address@hidden @value{LEQ} @code{dati[2]} @value{LEQ} @code{dati[3]}, e
address@hidden@dotless{i}}
+via. Il confronto di default @`e basato sul tipo di elementi
+(@pxref{Tipi di variabile e confronti}).
+Tutti i valori numerici vengono prima dei valori di stringa,
+che a loro volta vengono prima di tutti i sottovettori.
+
address@hidden effetti collaterali, funzione @code{asort()}
address@hidden funzione @code{asort()}, effetti collaterali
+Un effetto collaterale rilevante nel chiamare @code{asort()} @`e che
address@hidden indici originali del vettore vengono persi irreparabilmente}.
+Poich@'e questo non sempre @`e opportuno, @code{asort()} accetta un
+secondo argomento:
+
address@hidden
address@hidden the array} orig
+n = asort(orig, dest)
+for (i = 1; i <= n; i++)
+ @var{fai qualcosaa con} dest[i]
address@hidden example
+
+In questo caso, @command{gawk} copia il vettore @code{orig} nel vettore
address@hidden e ordina @code{dest}, distruggendo i suoi indici.
+Tuttavia il vettore @code{orig} non viene modificato.
+
+Spesso, address@hidden di cui si ha bisogno @`e di ordinare per i valori degli
address@hidden invece che per i valori degli elementi. Per far questo si usa la
+funzione @code{asorti()}. L'interfaccia e il comportamento sono identici a
+quelli di @code{asort()}, solo che per l'ordinamento vengono usati i valori
+degli indici, che diventano i valori del vettore risultato:
+
address@hidden
address@hidden orig[$0] = una_funz($0) @}
+
+END @{
+ n = asorti(orig, dest)
+ for (i = 1; i <= n; i++) @{
+ @ii{Lavora direttamente con gli indici ordinati:}
+ @var{fa qualcosa con} dest[i]
+ @dots{}
+ @ii{Accede al vettore originale attraverso gli indici ordinati:}
+ @var{fa qualcosa con} orig[dest[i]]
+ @}
address@hidden
address@hidden example
+
+Fin qui, tutto bene. Ora inizia la parte interessante. Sia @code{asort()}
+che @code{asorti()} accettano un terzo argomento di stringa per controllare il
+confronto di elementi del vettore. Quando abbiamo introdotto @code{asort()} e
address@hidden()} nella @ref{Funzioni per stringhe}, abbiamo ignorato questo
terzo
+argomento; comunque, @`e giunto il momento di descrivere come questo argomento
+influenza queste due funzioni.
+
+Fondamentalmente, il terzo argomento specifica come dev'essere ordinato il
+vettore. Ci sono due address@hidden Come per @code{PROCINFO["sorted_in"]},
+quest'argomento address@hidden essere uno degli argomenti predefiniti che
@command{gawk}
+fornisce (@pxref{Controllare visita}), o address@hidden essere il nome di una
funzione
+definita dall'utente (@pxref{Controllare visita vettori}).
+
+Nell'ultimo caso, @emph{la funzione address@hidden confrontare gli elementi in
qualunque
+modo si voglia}, prendendo in considerazione solo gli indici, solo i valori,
+o entrambi. Questo @`e estremamente potente.
+
+Una volta che il vettore @`e ordinato, @code{asort()} prende i @emph{valori}
nel
+loro ordine finale e li usa per riempire il vettore risultato, mentre
address@hidden()} prende gli @emph{indici} nel loro ordine finale e li usa per
+riempire il vettore risultato.
+
address@hidden conteggio riferimenti, ordinamento vettori
address@hidden NOTA
+Copiare indici ed elementi non @`e dispendioso in termini di memoria.
+Internamente, @command{gawk} mantiene un @dfn{conteggio dei riferimenti} ai
+dati. Per esempio, dopo che @code{asort()} copia il primo vettore nel
+secondo, in memoria c'@`e ancora una sola copia dei dati degli elementi
+del vettore originale, ed entrambi i vettori accedono all'unica copia di
+valori che esiste in memoria.
address@hidden quotation
+
address@hidden Document It And Call It A Feature. Sigh.
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden vettori, ordinamento, variabile @code{IGNORECASE} e
address@hidden @code{IGNORECASE}, variabile, e funzioni di ordinamento dei
vettori
address@hidden variabile @code{IGNORECASE}, e funzioni di ordinamento dei
vettori
+Poich@'e @code{IGNORECASE} influenza i confronti tra stringhe, il valore di
address@hidden influisce anche sull'ordinamento sia con @code{asort()} che
+con @code{asorti()}.
+Si noti inoltre che l'ordinamento della localizzazione @emph{non} entra in
+gioco; i confronti sono basati solamente sul valore dei
address@hidden@`o @`e vero perch@'e il confronto basato sulla localizzazione
+avviene solo quando si @`e in address@hidden POSIX-compatibile, e poich@'e
@code{asort()}
+e @code{asorti()} sono estensioni di @command{gawk}, esse non sono disponibili
+in quel caso.}
+
+L'esempio seguente mostra l'uso di una funzione di confronto usata con
address@hidden()}. La funzione di confronto, @code{confronta_in_minuscolo()},
+trasforma gli elementi da confrontare in lettere minuscole, in modo da avere
+confronti che non dipendono da maiuscolo/minuscolo.
+
address@hidden
+# confronta_in_minuscolo --- confronta stringhe ignorando maiuscolo/minuscolo
+
+function confronta_in_minuscolo(i1, v1, i2, v2, l, r)
address@hidden
+ l = tolower(v1)
+ r = tolower(v2)
+
+ if (l < r)
+ return -1
+ else if (l == r)
+ return 0
+ else
+ return 1
address@hidden
address@hidden example
+
+E questo programma address@hidden essere usato per provarla:
+
address@hidden
+# programma di test
+
+BEGIN @{
+ Letters = "abcdefghijklmnopqrstuvwxyz" \
+ "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+ split(Letters, data, "")
+
+ asort(data, risultato, "confronta_in_minuscolo")
+
+ j = length(risultato) # numero elementi del vettore "risultato"
+ for (i = 1; i <= j; i++) @{
+ printf("%s", risultato[i])
+ if (i % (j/2) == 0)
+ # a address@hidden, la stampa del vettore va a capo
+ printf("\n")
+ else
+ printf(" ")
+ @}
address@hidden
address@hidden example
+
+Se si esegue il programma, si ottiene:
+
address@hidden
+$ @kbd{gawk -f confronta_in_minuscolo.awk}
address@hidden A a B b c C D d e E F f g G H h i I J j k K l L M m
address@hidden n N O o p P Q q r R S s t T u U V v w W X x y Y z Z
address@hidden example
+
address@hidden I/O bidirezionale
address@hidden Comunicazioni bidirezionali con un altro processo
+
address@hidden 8/2014. Neither Mike nor BWK saw this as relevant. Commenting it
out.
address@hidden
address@hidden Brennan, Michael
address@hidden programmers, attractiveness of
address@hidden
address@hidden Path:
cssun.mathcs.emory.edu!gatech!newsxfer3.itd.umich.edu!news-peer.sprintlink.net!news-sea-19.sprintlink.net!news-in-west.sprintlink.net!news.sprintlink.net!Sprint!204.94.52.5!news.whidbey.com!brennan
+From: brennan@@whidbey.com (Mike Brennan)
+Newsgroups: comp.lang.awk
+Subject: Re: Learn the SECRET to Attract Women Easily
+Date: 4 Aug 1997 17:34:46 GMT
address@hidden Organization: WhidbeyNet
address@hidden Lines: 12
+Message-ID: <5s53rm$eca@@news.whidbey.com>
address@hidden References: <address@hidden>
address@hidden Reply-To: address@hidden
address@hidden NNTP-Posting-Host: asn202.whidbey.com
address@hidden X-Newsreader: slrn (0.9.4.1 UNIX)
address@hidden Xref: cssun.mathcs.emory.edu comp.lang.awk:5403
+
+On 3 Aug 1997 13:17:43 GMT, Want More Dates???
+<tracy78@@kilgrona.com> wrote:
+>Learn the SECRET to Attract Women Easily
+>
+>The SCENT(tm) Pheromone Sex Attractant For Men to Attract Women
+
+The scent of awk programmers is a lot more attractive to women than
+the scent of perl programmers.
+--
+Mike Brennan
address@hidden brennan@@whidbey.com
address@hidden smallexample
address@hidden ignore
+
address@hidden address@hidden avanzate, address@hidden comunicare con
address@hidden processi, comunicazioni bidirezionali con
+Spesso @`e utile poter
+inviare dati a un programma separato che
+li elabori e in seguito leggere il risultato. Questo address@hidden essere
sempre
+fatto con file temporanei:
+
address@hidden
+# Scrivere i dati per l'elaborazione
+filetemp = ("mieidati." PROCINFO["pid"])
+while (@var{non dipendente dai dati})
+ print @var{dati} | ("sottoprogramma > " filetemp)
+close("sottoprogramma > " filetemp)
+
+# Legge il risultato, rimuove filetemp quando ha finito
+while ((getline nuovidati < filetemp) > 0)
+ @var{elabora} nuovidati @var{secondo le esigenze}
+close(filetemp)
+system("rm " filetemp)
address@hidden example
+
address@hidden
+Questo funziona, ma non @`e elegante. Tra le altre cose, richiede che il
+programma venga eseguito in una directory che non address@hidden essere
condivisa tra gli
+utenti; per esempio, @file{/tmp} non address@hidden esserlo, poich@'e potrebbe
accadere che
+un altro utente stia usando un file temporaneo con lo stesso
address@hidden Brennan suggerisce l'uso di @command{rand()} per
+generare @value{FNS} unici. Questo @`e un punto valido; tuttavia, i file
+temporanei rimangono address@hidden difficili da usare delle @dfn{pipe}
bidirezionali.} @c 8/2014
+
address@hidden coprocessi
address@hidden input/output bidirezionale
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|&} (I/O)
address@hidden @command{csh}, comando, operatore @code{|&}, confronto con
address@hidden comando @command{csh}, operatore @code{|&}, confronto con
+Comunque, con @command{gawk}, @`e possibile aprire una @dfn{pipe}
address@hidden
+verso un altro processo. Il secondo processo @`e chiamato @dfn{coprocesso},
+poich@'e viene eseguito in parallelo con @command{gawk}. La connessione
+bidirezionale viene creata usando l'operatore @samp{|&} (preso in prestito
+dalla shell Korn, @command{ksh}):@footnote{Questo @`e molto diverso dallo
stesso
+operatore nella C shell e in Bash.}
+
address@hidden
+do @{
+ print @var{dati} |& "sottoprogramma"
+ "sottoprogramma" |& getline risultato
address@hidden while (@var{ci sono ancora dati da elaborare})
+close("sottoprogramma")
address@hidden example
+
+La prima volta che viene eseguita un'operazione I/O usando l'operatore
address@hidden|&},
address@hidden crea una @dfn{pipeline} bidirezionale verso un processo figlio
+che esegue l'altro programma. L'output creato con @code{print} o con
address@hidden viene scritto nello standard input del programma, e il contenuto
+dello standard output del programma address@hidden essere letto dal programma
address@hidden usando @code{getline}.
+Come accade coi processi avviati con @samp{|}, il sottoprogramma address@hidden
+essere un qualsiasi programma, o una @dfn{pipeline} di programmi, che
address@hidden essere
+avviato dalla shell.
+
+Ci sono alcune avvertenze da tenere presenti:
+
address@hidden @value{BULLET}
address@hidden
+Per come funziona internamente @command{gawk}, lo standard error
+dei coprocessi va nello stesso posto dove va lo standard error del
+genitore @command{gawk}. Non @`e possibile leggere lo standard error del
+figlio separatamente.
+
address@hidden stalli
address@hidden abbracci mortali
address@hidden @dfn{deadlocks}, vedi stalli
address@hidden bufferizzazione, dell'input/output
address@hidden input/output, bufferizzazione
address@hidden @code{getline}, comando, stalli e
address@hidden
+La permanenza in memoria (bufferizzazione) dell'I/O del sottoprocesso potrebbe
+essere un problema. @command{gawk} automaticamente scrive su disco tutto
+l'output spedito tramite la @dfn{pipe} al coprocesso.
+Tuttavia, se il coprocesso non scrive su disco il suo output,
address@hidden potrebbe bloccarsi mentre esegue una @code{getline} per leggere
+il risultato del coprocesso. Questo address@hidden portare a una situazione
+conosciuta come @dfn{stallo} (@dfn{deadlock}, abbraccio mortale), in cui
ciascun
+processo rimane in attesa
+che l'altro processo faccia qualcosa.
address@hidden itemize
+
address@hidden @code{close()}, funzione, @dfn{pipe} bidirezionali e
address@hidden funzione @code{close()}, @dfn{pipe} bidirezionali e
address@hidden possibile chiudere una @dfn{pipe} bidirezionale con un
coprocesso solo in una
+direzione, fornendo un secondo argomento, @code{"to"} o @code{"from"}, alla
+funzione @code{close()} (@pxref{Chiusura file e @dfn{pipe}}).
+Queste stringhe dicono a @command{gawk} di chiudere la @dfn{pipe},
rispettivamente
+nella direzione che invia i dati al coprocesso e nella direzione che legge da
+esso.
+
address@hidden @command{sort}, programma di address@hidden, coprocessi e
address@hidden programma di address@hidden @command{sort}, coprocessi e
+Questo @`e particolarmente necessario per usare il programma di address@hidden
+di sistema @command{sort} come parte di un coprocesso;
address@hidden deve leggere @emph{tutti} i dati di input
+prima di poter produrre un qualsiasi output.
+Il programma @command{sort} non riceve un'indicazione di fine-file
+(end-of-file) finch@'e @command{gawk} non chiude l'address@hidden in scrittura
della
address@hidden
+
+Una volta terminata la scrittura dei dati sul programma @command{sort},
+si address@hidden chiudere il lato @code{"to"} della @dfn{pipe}, e quindi
iniziare a leggere
+i dati ordinati via @code{getline}.
+Per esempio:
+
address@hidden
+BEGIN @{
+ comando = "LC_ALL=C sort"
+ n = split("abcdefghijklmnopqrstuvwxyz", a, "")
+
+ for (i = n; i > 0; i--)
+ print a[i] |& comando
+ close(comando, "to")
+
+ while ((comando |& getline line) > 0)
+ print "ricevuto", line
+ close(comando)
address@hidden
address@hidden example
+
+Questo programma scrive le lettere dell'alfabeto in ordine inverso, uno per
+riga, attraverso la @dfn{pipe} bidirezionale verso @command{sort}. Poi chiude
la
+direzione di scrittura della @dfn{pipe}, in modo che @command{sort} riceva
+un'indicazione di fine-file. Questo fa in modo che @command{sort} ordini i
+dati e scriva i dati ordinati nel programma @command{gawk}. Una volta che
+tutti i dati sono stati letti, @command{gawk} termina il coprocesso ed esce.
+
+Come nota a margine, l'assegnamento @samp{LC_ALL=C} nel comando @command{sort}
+assicura che @command{sort} usi l'ordinamento tradizionale di Unix (ASCII).
address@hidden non @`e strettamente necessario in questo caso, ma @`e bene
sapere come farlo.
+
+Occorre prestare attenzione quando si chiude il lato @code{"from"} di una
address@hidden bidirezionale; in tal caso @command{gawk} attende che il
+processo-figlio termini, il che address@hidden causare lo stallo del programma
address@hidden in esecuzione. (Per questo motivo, questa particolare
address@hidden @`e molto meno usata, in pratica, di quella che consente la
address@hidden di chiudere il lato @code{"to"} della @dfn{pipe}.)
+
address@hidden ATTENZIONE
+Normalmente,
address@hidden un errore fatale (che fa terminare il programma @command{awk})
+scrivere verso il lato @code{"to"} di una @dfn{pipe} bidirezionale che
address@hidden stata chiusa, e lo stesso vale se si legge dal lato @code{"from"}
+di una @dfn{pipe} bidirezionale che sia stata chiusa.
+
address@hidden possibile impostare @code{PROCINFO["@var{comando}", "NONFATAL"]}
+per far address@hidden@dotless{i}} che tali operazioni non provochino la fine
del programma
address@hidden Se lo si fa, @`e necessario controllare il valore
+di @code{ERRNO} dopo ogni istruzione @code{print}, @code{printf},
+o @code{getline}.
address@hidden dopo errori} per ulteriori informazioni.
address@hidden quotation
+
address@hidden @command{gawk}, vettore @code{PROCINFO} in
address@hidden @code{PROCINFO}, vettore, e comunicazioni attraverso le @dfn{pty}
+Per le comunicazioni bidirezionali si possono anche usare delle pseudo
@dfn{tty}
+(@dfn{pty}) al posto delle @dfn{pipe}, se il sistema in uso le prevede.
+Questo vien fatto, a seconda del comando da usare, impostando un elemento
+speciale nel vettore @code{PROCINFO}
+(@pxref{Variabili auto-assegnate}),
+in questo modo:
+
address@hidden
+comando = "sort -nr" # comando, salvato in una variabile
+PROCINFO[comando, "pty"] = 1 # aggiorna PROCINFO
+print @dots{} |& comando # avvia la @dfn{pipe} bidirezionale
address@hidden
address@hidden example
+
address@hidden
+Se il sistema in uso non ha le @dfn{pty}, o se tutte le @dfn{pty} del sistema
+sono in uso, @command{gawk} automaticamente torna a usare le @dfn{pipe}
+regolari.
+
+Usare le @dfn{pty} in genere evita i problemi di stallo del buffer descritti
+precedentemente, in cambio di un piccolo calo di prestazioni. address@hidden
dipende
+dal fatto che la gestione delle @dfn{tty} @`e fatta una riga per volta.
+Su sistemi che hanno il comando @command{stdbuf} (parte del pacchetto
address@hidden://www.gnu.org/software/coreutils/coreutils.html,
+GNU Coreutils}), si address@hidden usare tale programma, invece delle
@dfn{pty}.
+
+Si noti anche che le @dfn{pty} non sono completamente trasparenti.
+Alcuni codici di controllo binari, come @kbd{Ctrl-d} per indicare la
+condizione di file-file, sono interpetati dal gestore di @dfn{tty}
+e non sono passati all'applicazione.
+
address@hidden ATTENZIONE
+In ultima analisi, i coprocessi danno adito alla address@hidden di uno
address@hidden (deadlock) tra @command{gawk} e il programma in esecuzione
+nel coprocesso. address@hidden address@hidden succedere se si inviano
``troppi'' dati al
+coprocesso, prima di leggere dati inviati dallo stesso; entrambi i
+processi sono bloccati sulla scrittura dei dati, e nessuno dei due
address@hidden disponibile a leggere quelli che sono address@hidden stati
scritti dall'altro.
+Non c'@`e modo di evitare completamente una tale situazione; occorre una
+programmazione attenta, insieme alla conoscenza del comportamento del
+coprocesso.
address@hidden quotation
+
address@hidden Reti TCP/IP
address@hidden Usare @command{gawk} per la programmazione di rete
address@hidden address@hidden avanzate, programmazione di rete
address@hidden avanzate, address@hidden, programmazione di rete
address@hidden reti, programmazione di
address@hidden TCP/IP
address@hidden @code{/inet/@dots{}}, file speciali (in @command{gawk})
address@hidden file speciali @code{/inet/@dots{}} (in @command{gawk})
address@hidden @code{/inet4/@dots{}}, file speciali (in @command{gawk})
address@hidden file speciali @code{/inet4/@dots{}} (in @command{gawk})
address@hidden @code{/inet6/@dots{}}, file speciali (in @command{gawk})
address@hidden file speciali @code{/inet6/@dots{}} (in @command{gawk})
address@hidden @code{EMRED}
address@hidden
address@hidden
address@hidden:@*
+@ @ @ @ @i{A host is a host from coast to coast,@*
+@ @ @ @ and nobody talks to a host that's close,@*
+@ @ @ @ unless the host that isn't address@hidden
+@ @ @ @ is busy, hung, or dead.}
+
address@hidden:@*
+@ @ @ @ @i{Un computer @`e un computer lontano o vicino,@*
+@ @ @ @ e nessuno parla con un computer vicino,@*
+@ @ @ @ a meno che il computer address@hidden
+@ @ @ @ sia occupato, fuori linea, o spento.}
address@hidden Mike O'Brien (noto anche come Mr.@: Protocol)
address@hidden quotation
address@hidden ifnotdocbook
+
address@hidden
+<blockquote>
+<attribution>Mike O'Brien (aka Mr. Protocol)</attribution>
+<literallayout class="normal"><literal>EMRED</literal>:
+ <emphasis>A host is a host from coast to
coast,</emphasis>
+ <emphasis>and no-one can talk to host that's
close,</emphasis>
+ <emphasis>unless the host that isn't close</emphasis>
+ <emphasis>is busy, hung, or
dead.</emphasis></literallayout>
+</blockquote>
address@hidden docbook
+
+Oltre a poter aprire una @dfn{pipeline} bidirezionale verso un coprocesso
+sullo stesso sistema
+(@pxref{I/O bidirezionale}),
address@hidden possibile attivare una connessione bidirezionale verso un altro
processo
+o verso un altro sistema attraverso una connessione di rete IP.
+
+Si address@hidden pensare a questo semplicemente come a una @dfn{pipeline}
bidirezionale
address@hidden lunga} verso un coprocesso.
+Il modo in cui @command{gawk} stabilisce quando usare una rete TCP/IP @`e
+mediante il riconoscimento di speciali @value{FNS} che iniziano con
address@hidden/inet/}, con @samp{/inet4/} o con @samp{/inet6/}.
+
+La sintassi completa del @value{FN} speciale @`e
address@hidden/@var{tipo-rete}/@var{protocollo}/@var{porta-locale}/@var{host-remoto}/@var{porta-remota}}.
+I componenti sono:
+
address@hidden @var
address@hidden tipo-rete
+Specifica il tipo di connessione a internet da stabilire.
+Si usa @samp{/inet4/} per usare solo IPv4, e
address@hidden/inet6/} per usare solo IPv6.
+Il semplice @samp{/inet/} (che usualmente @`e l'unica opzione) usa
+il tipo di default del sistema, quasi certamente IPv4.
+
address@hidden protocollo
+Il protocollo da usare sull'IP. Questo dev'essere o @samp{tcp} o
address@hidden, per una connessione IP rispettivamente TCP o UDP.
+TCP dovrebbe venir usato per la maggior parte delle applicazioni.
+
address@hidden porta-locale
address@hidden @code{getaddrinfo()}, funzione (libreria C)
address@hidden funzione @code{getaddrinfo()} (libreria C)
+Il numero di porta TCP o UDP da usare. Si usa un numero di porta di valore
address@hidden quando si vuole che sia il sistema a scegliere una porta.
+Questo @`e quel che si dovrebbe fare quando si scrive un'applicazione
+cliente TCP o UDP.
+Si address@hidden usare anche un nome di un servizio noto, come @samp{smtp}
+o @samp{http}, nel qual caso @command{gawk} tenta di determinare
+il numero di porta predefinito usando la funzione C @code{getaddrinfo()}.
+
address@hidden host-remoto
+L'indirizzo IP o il nome di dominio completamente qualificato dell'host
+internet al quale ci si vuol connettere.
+
address@hidden porta-remota
+Il numero di porta TCP o UDP da usare sul particolare @var{host remoto}.
+Anche in questo caso, si usi @samp{0} se non ci sono preferenze,
+o alternativamente, un nome di servizio comunemente noto.
address@hidden table
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile
address@hidden variabile @code{ERRNO}
address@hidden NOTA
+Un insuccesso nell'apertura di un socket bidirezionale address@hidden luogo
alla
+segnalazione di un errore non fatale al codice chiamante.
+Il valore di @code{ERRNO} indica l'errore (@pxref{Variabili auto-assegnate}).
address@hidden quotation
+
+Si consideri il seguente esempio molto semplice:
+
address@hidden
+BEGIN @{
+ Servizio = "/inet/tcp/0/localhost/daytime"
+ Servizio |& getline
+ print $0
+ close(Servizio)
address@hidden
address@hidden example
+
+Questo programma legge la data e l'ora corrente dal server @code{daytime}
+TCP del sistema locale.
+Stampa poi il risultato e chiude la connessione.
+
+Poich@'e questo tema @`e molto ampio, l'uso di @command{gawk} per
+la programmazione TCP/IP viene documentato separatamente.
address@hidden
+Si veda
address@hidden, , General Introduction, gawkinet, @value{GAWKINETTITLE}},
address@hidden ifinfo
address@hidden
+Si veda
address@hidden://www.gnu.org/software/gawk/manual/gawkinet/,
address@hidden@value{GAWKINETTITLE}}},
+che fa parte della distribuzione @command{gawk},
address@hidden ifnotinfo
+per una introduzione e trattazione molto address@hidden completa e con molti
+esempi.
+
address@hidden NOTA
address@hidden address@hidden aprire solo socket diretti. Al momento non c'@`e
alcun modo
+per accedere ai servizi disponibili su Secure Socket Layer
+(SSL); questo comprende qualsiasi servizio web il cui URL inizia con
address@hidden://}.
address@hidden quotation
+
+
address@hidden Profilare
address@hidden Profilare i propri programmi @command{awk}
address@hidden @command{awk}, programmi, profilare
address@hidden profilare programmi @command{awk}
address@hidden @code{awkprof.out}, file
address@hidden file @code{awkprof.out}
+
address@hidden possibile tener traccia dell'esecuzione dei propri programmi
@command{awk}.
address@hidden si address@hidden fare passando l'opzione @option{--profile} a
@command{gawk}.
+Al termine dell'esecuzione, @command{gawk} crea un profilo del programma in un
+file chiamato @file{awkprof.out}. A causa dell'address@hidden di profilazione
+l'esecuzione del programma @`e address@hidden lenta fino al 45% rispetto al
normale.
+
address@hidden @option{--profile}, opzione
address@hidden opzione @option{--profile}
+Come mostrato nel seguente esempio,
+l'opzione @option{--profile} address@hidden essere usata per cambiare il nome
del file
+su cui @command{gawk} address@hidden il profilo:
+
address@hidden
+gawk --profile=mioprog.prof -f mioprog.awk dati1 dati2
address@hidden example
+
address@hidden
+Nell'esempio precedente, @command{gawk} mette il profilo in
address@hidden anzich@'e in @file{awkprof.out}.
+
+Vediamo ora una sessione d'esempio che mostra un semplice programma
address@hidden, i suoi dati in input, e il risultato dell'esecuzione di
address@hidden con l'opzione @option{--profile}. Innanzitutto, il
+programma @command{awk}:
+
address@hidden
+BEGIN @{ print "Prima regola BEGIN" @}
+
+END @{ print "Prima regola END" @}
+
+/pippo/ @{
+ print "trovato /pippo/, perbacco"
+ for (i = 1; i <= 3; i++)
+ sing()
address@hidden
+
address@hidden
+ if (/pippo/)
+ print "l'if @`e vero"
+ else
+ print "l'else @`e vero"
address@hidden
+
+BEGIN @{ print "Seconda regola BEGIN" @}
+
+END @{ print "Seconda regola END" @}
+
+function sing( ignora)
address@hidden
+ print "Devo essere io!"
address@hidden
address@hidden example
+
+Questi sono i dati in input:
+
address@hidden
+pippo
+pluto
+paperino
+pippo
+cianfrusaglie
address@hidden example
+
+E questo @`e il file @file{awkprof.out} che @`e il risultato dell'esecuzione
+del profilatore di @command{gawk} su questo programma e sui dati (quest'esempio
+dimostra anche che i programmatori di @command{awk} a volte si alzano molto
+presto al mattino per lavorare):
+
address@hidden @code{BEGIN}, criterio di ricerca, e profilatura
address@hidden criterio di ricerca @code{BEGIN}, e profilatura
address@hidden @code{END}, criterio di ricerca, e profilatura
address@hidden criterio di ricerca @code{END}, e profilatura
address@hidden
+ # profilo gawk, creato Mon Sep 29 05:16:21 2014
+
+ # BEGIN regola(e)
+
+ BEGIN @{
+ 1 print "Prima regola BEGIN"
+ @}
+
+ BEGIN @{
+ 1 print "Seconda regola BEGIN"
+ @}
+
+ # Regola(e)
+
+ 5 /pippo/ @{ # 2
+ 2 print "trovato /pippo/, perbacco"
+ 6 for (i = 1; i <= 3; i++) @{
+ 6 sing()
+ @}
+ @}
+
+ 5 @{
+ 5 if (/pippo/) @{ # 2
+ 2 print "l'if @`e vero"
+ 3 @} else @{
+ 3 print "l'else @`e vero"
+ @}
+ @}
+
+ # END regola(e)
+
+ END @{
+ 1 print "Prima regola END"
+ @}
+
+ END @{
+ 1 print "Seconda regola END"
+ @}
+
+
+ # Funzioni, in ordine alfabetico
+
+ 6 function sing(ignora)
+ @{
+ 6 print "Devo essere io!"
+ @}
address@hidden example
+
+Quest'esempio illustra molte caratteristiche fondamentali dell'output
+della profilazione.
+Queste sono:
+
address@hidden @value{BULLET}
address@hidden
+Il programma viene stampato nell'ordine: regole @code{BEGIN},
+regole @code{BEGINFILE},
+regole criterio di ricerca--azione,
+regole @code{ENDFILE}, regole @code{END}, e funzioni, elencate
+in ordine alfabetico.
+Le regole @code{BEGIN} ed @code{END} multiple conservano le loro
+distinte address@hidden, address@hidden@dotless{i}} come le regole
@code{BEGINFILE} ed @code{ENDFILE}
+multiple.
+
address@hidden criteri di ricerca, conteggi, in un profilo
address@hidden
+Le regole criterio di ricerca--azione hanno due conteggi.
+Il primo conteggio, a sinistra della regola, mostra quante volte
+il criterio di ricerca della regola @`e stato @emph{testato}.
+Il secondo conteggio, alla destra della parentesi graffa aperta,
+all'interno di un commento,
+mostra quante volte l'azione della regola @`e stata @emph{eseguita}.
+La differenza tra i due indica quante volte il criterio di ricerca della regola
address@hidden stato valutato come falso.
+
address@hidden
+Analogamente,
+il conteggio per un'istruzione @address@hidden mostra quante volte
+la condizione @`e stata testata.
+Alla destra della parentesi graffa sinistra aperta per il corpo di @code{if}
+c'@`e un conteggio che mostra quante volte la condizione @`e stata trovata
vera.
+Il conteggio per @code{else} indica
+quante volte la verifica non ha avuto successo.
+
address@hidden cicli, conteggi per l'intestazione, in un profilo
address@hidden
+Il conteggio per un ciclo (come @code{for}
+o @code{while}) mostra quante volte il test del ciclo @`e stato eseguito.
+(Per questo motivo, non si address@hidden solamente guardare il conteggio
sulla prima
+istruzione in una regola per determinare quante volte la regola @`e stata
+eseguita. Se la prima istruzione @`e un ciclo, il conteggio @`e ingannevole.)
+
address@hidden funzioni definite dall'utente, conteggi, in un profilo
address@hidden definite dall'utente, funzioni, conteggi, in un profilo
address@hidden
+Per le funzioni definite dall'utente, il conteggio vicino alla parola chiave
address@hidden indica quante volte la funzione @`e stata chiamata.
+I conteggi vicino alle istruzioni nel corpo mostrano quante volte
+quelle istruzioni sono state eseguite.
+
address@hidden @address@hidden@}} (parentesi graffe)
address@hidden parentesi graffe (@address@hidden@}})
address@hidden
+L'impaginazione usa lo stile ``K&R'' con le tabulazioni.
+Le parentesi graffe sono usate dappertutto, anche dove il corpo di un
address@hidden, di un @code{else} o di un ciclo @`e formato da un'unica
istruzione.
+
address@hidden @code{()} (parentesi), in un profilo
address@hidden parentesi (@code{()}), in un profilo
address@hidden
+Le parentesi vengono usate solo dov'@`e necessario, come si rileva dalla
+struttura del programma e dalle regole di precedenza.
+Per esempio, @samp{(3 + 5) * 4} significa sommare tre e cinque, quindi
+moltiplicare il totale per quattro. Di contro, @samp{3 + 5 * 4} non ha
+parentesi, e significa @samp{3 + (5 * 4)}.
+
address@hidden
address@hidden
+All string concatenations are parenthesized too.
+(This could be made a bit smarter.)
address@hidden ignore
+
address@hidden
+Le parentesi vengono usate attorno agli argomenti di @code{print}
+e @code{printf} solo quando l'istruzione
address@hidden o @code{printf} @`e seguita da una ridirezione.
+Similarmente, se
+l'oggetto di una ridirezione non @`e uno scalare, viene messo tra parentesi.
+
address@hidden
address@hidden mette dei commenti iniziali
+davanti alle regole @code{BEGIN} ed @code{END},
+alle regole @code{BEGINFILE} ed @code{ENDFILE},
+alle regole criterio_di_ricerca--azione e alle funzioni.
+
address@hidden itemize
+
+La versione profilata del proprio programma potrebbe non apparire esattamente
+come quella scritta durante la stesura del programma. Questo perch@'e
address@hidden crea la versione profilata facendo una ``stampa elegante'' della
+sua rappresentazione interna del programma. Un vantaggio di address@hidden
@`e che
address@hidden address@hidden produrre una rappresentazione standard.
+Inoltre, cose come:
+
address@hidden
+/pippo/
address@hidden example
+
address@hidden
+appaiono come:
+
address@hidden
+/pippo/ @{
+ print $0
address@hidden
address@hidden example
+
address@hidden
+che @`e corretto, ma probabilmente inatteso.
+
address@hidden profilare programmi @command{awk}, dinamicamente
address@hidden @command{gawk}, programma, profilazione dinamica
address@hidden profilazione dinamica
+Oltre a creare profili una volta completato il programma,
address@hidden address@hidden generare un profilo mentre @`e in esecuzione.
+Questo @`e utile se il proprio programma @command{awk} entra in un ciclo
+infinito e si vuol vedere cosa @`e stato eseguito.
+Per usare questa address@hidden, bisogna eseguire @command{gawk} con l'opzione
address@hidden in background:
+
address@hidden
+$ @kbd{gawk --profile -f mioprog &}
+[1] 13992
address@hidden example
+
address@hidden @command{kill}, address@hidden profilazione dinamica e
address@hidden comando @address@hidden profilazione dinamica e
address@hidden @code{USR1}, segnale, per profilazione dinamica
address@hidden @code{SIGUSR1}, segnale, per profilazione dinamica
address@hidden segnali @code{USR1}/@code{SIGUSR1}, per profilazione
address@hidden
+La shell stampa un numero di job e il numero di ID del relativo processo;
+in questo caso, 13992. Si usi il comando @command{kill} per inviare il
+segnale @code{USR1} a @command{gawk}:
+
address@hidden
+$ @kbd{kill -USR1 13992}
address@hidden example
+
address@hidden
+Come al solito, la versione profilata del programma @`e scritta nel file
address@hidden, o in un file differente se ne viene specificato uno
+con l'opzione @option{--profile}.
+
+Assieme al profilo regolare, come mostrato in precedenza, il file del profilo
+include una traccia di ogni funzione attiva:
+
address@hidden
+# `Stack' (Pila) Chiamate Funzione:
+
+# 3. paperino
+# 2. pluto
+# 1. pippo
+# -- main --
address@hidden example
+
+Si address@hidden inviare a @command{gawk} il segnale @code{USR1} quante volte
si vuole.
+Ogni volta, il profilo e la traccia della chiamata alla funzione vengono
+aggiunte in fondo al file di profilo creato.
+
address@hidden @code{HUP}, segnale, per profilazione dinamica
address@hidden @code{SIGHUP}, segnale, per profilazione dinamica
address@hidden segnali @code{HUP}/@code{SIGHUP}, per profilazione
+Se si usa il segnale @code{HUP} invece del segnale @code{USR1}, @command{gawk}
+genera il profilo e la traccia della chiamata alla funzione ed esce.
+
address@hidden @code{INT}, segnale (MS-Windows)
address@hidden @code{SIGINT}, segnale (MS-Windows)
address@hidden segnali @code{INT}/@code{SIGINT} (MS-Windows)
address@hidden @code{QUIT}, segnale (MS-Windows)
address@hidden @code{SIGQUIT}, segnale (MS-Windows)
address@hidden segnali @code{QUIT}/@code{SIGQUIT} (MS-Windows)
+Quando @command{gawk} viene eseguito sui sistemi MS-Windows, usa i segnali
address@hidden e @code{QUIT} per generare il profilo, e nel
+caso del segnale @code{INT}, @command{gawk} esce. Questo perch@'e
+questi sistemi non prevedono il comando @command{kill}, per cui gli unici
+segnali che si possono trasmettere a un programma sono quelli generati dalla
+tastiera. Il segnale @code{INT} @`e generato dalle combinazioni di tasti
address@hidden o @kbd{Ctrl-BREAK}, mentre il segnale
address@hidden @`e generato dalla combinazione di tasti @kbd{Ctrl-\}.
+
+Infine, @command{gawk} accetta anche un'altra opzione, @option{--pretty-print}.
+Quando viene chiamato in questo modo, @command{gawk} fa una ``stampa elegante''
+del programma nel file @file{awkprof.out}, senza conteggi sull'esecuzione.
+
address@hidden NOTA
+Una volta, l'opzione @option{--pretty-print} eseguiva anche il programma.
+Ora non address@hidden
address@hidden quotation
+
+C'@`e una differenza significativa tra l'output creato durante la
profilazione, e
+quello creato durante la stampa elegante. L'output della stampa elegante
+preserva i commenti originali che erano nel programma, anche se la loro
+posizione address@hidden non corrispondere esattamente alle posizioni
originali che
+avevano nel codice address@hidden@command{gawk} fa del suo meglio
+per mantenere la distinzione tra commenti posti dopo delle istruzioni e
+commenti su righe a s@'e stanti. Per limiti insiti nell'implementazione,
+non sempre questo address@hidden avvenire in maniera corretta, in particolare
nel
+caso di istruzioni @code{switch}. I manutentori di @command{gawk}
+sperano di poter migliorare la situazione in una futura versione.}
+
+Comunque, per una precisa scelta progettuale, l'output della profilazione
address@hidden i commenti del programma originale. Questo permette di
+concentrarsi sui dati del conteggio di esecuzione ed evita la tentazione di
+usare il profilatore per creare una stampa elegante.
+
+Oltre a address@hidden, l'output stampato in modo elegante non ha
l'indentazione iniziale
+che ha l'output della profilazione. Questo rende agevole la stampa elegante
+del proprio codice una volta completato lo sviluppo, usando poi il risultato
+come versione finale del programma.
+
+Poich@'e la rappresentazione interna del programma @`e formattata per
+essere aderente al programma @command{awk} in questione, la profilatura
+e la formattazione graziosa (opzione @option{--pretty-print}) disabilitano
+automaticamente le optimizzazioni di default di @command{gawk}.
+
+La formattazione elegante mantiene anche il formato originale delle
+costanti numeriche; se sono stati usati dei valori ottali o esadecimali
+nel codice sorgente, questi compariranno nell'output nello stesso
+formato con cui sono stati inseriti.
+
address@hidden Sommario address@hidden avanzate
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+L'opzione @option{--non-decimal-data} fa address@hidden@dotless{i}} che
@command{gawk} tratti
+i dati di input che hanno l'aspetto ottale ed esadecimale come valori ottali ed
+esadecimali. L'opzione dovrebbe essere usata con prudenza o non usata affatto;
address@hidden preferibile l'uso di @code{strtonum()}.
+Si noti che quest'opzione potrebbe sparire nelle prossime versioni di
address@hidden
+
address@hidden
+Si address@hidden prendere il completo controllo dell'ordinamento nello
scorrere il
+vettore con @samp{for (@var{indice} in @var{vettore})}, impostando
address@hidden"sorted_in"]} al nome di una funzione definita dall'utente che
+fa il confronto tra elementi del vettore basandosi su indice e valore.
+
address@hidden
+Analogamente, si address@hidden fornire il nome di una funzione di confronto
definita
+dall'utente come terzo argomento di @code{asort()} o di @command{asorti()} per
+controllare come queste funzioni ordinano i vettori. O si address@hidden
fornire una delle
+stringhe di controllo predefinite che funzionano per
address@hidden"sorted_in"]}.
+
address@hidden
+Si address@hidden usare l'operatore @samp{|&} per creare una @dfn{pipe}
bidirezionale
+verso un coprocesso. Si legge dal coprocesso con @code{getline}, ci si
+scrive sopra con @code{print} o con @code{printf}. Usare @code{close()}
+per bloccare il coprocesso completamente o, se necessario, chiudere le
+comunicazioni bidirezionali in una direzione.
+
address@hidden
+Usando degli speciali @value{FNS} con l'operatore @samp{|&}, si address@hidden
aprire una
+connessione TCP/IP (o UDP/IP) verso host remoti su internet. @command{gawk}
+supporta sia IPv4 che IPv6.
+
address@hidden
+Si possono generare profili del proprio programma con i conteggi del numero
+di esecuzione di ogni singola
+istruzione. Questo address@hidden essere d'aiuto nel determinare quali parti
del programma
+potrebbero portar via la maggior parte del tempo, consentendo
address@hidden@dotless{i}} di
+aggiustarli address@hidden agevolmente. Inviando il segnale @code{USR1}
durante la
+profilazione @command{gawk} scrive il profilo, includendo la
+stack della chiamata alla funzione e prosegue nell'elaborazione.
+
address@hidden
+Si address@hidden anche fare solo una ``stampa elegante'' del programma.
+
address@hidden itemize
address@hidden Internazionalizzazione
address@hidden Internazionalizzazione con @command{gawk}
+
+Tanto tempo fa i produttori di computer
+scrivevano software che comunicava solo in inglese.
+Col passare del tempo, i venditori di hardware e di software si sono
+resi conto che se i loro sistemi avessero comunicato anche nelle lingue
+materne di paesi dove non si parlava inglese,
address@hidden avrebbe avuto come risultato un incremento delle vendite.
+Per questo motivo, l'internazionalizzazione e la localizzazione
+di programmi e sistemi software @`e divenuta una pratica comune.
+
address@hidden internazionalizzazione, localizzazione
address@hidden @command{gawk}, internazionalizzazione e, si veda
internazionalizzazione
address@hidden internazionalizzazione, localizzazione, @command{gawk} e
+Per molti anni la address@hidden di fornire l'internazionalizzazione
+era sostanzialmente limitata ai programmi scritti in C e C++.
+Questo @value{CHAPTER} descrive la libreria @dfn{ad hoc} utilizzata da
address@hidden
+per l'internazionalizzazione e anche il modo in cui le address@hidden che
+consentono l'internazionalizzazione sono rese disponibili da @command{gawk}
+a ogni programma scritto in @command{awk}.
+La address@hidden dell'internazionalizzazione a livello di programma
address@hidden offre ulteriore address@hidden agli sviluppatori di software:
+non sono address@hidden obbligati a scrivere in C o C++ quando
l'internazionalizzazione
address@hidden necessaria in un programma.
+
address@hidden
+* I18N e L10N:: Internazionalizzazione e localizzazione.
+* Utilizzare @command{gettext}:: Come funziona il comando GNU
@command{gettext}.
+* I18N per programmatore:: address@hidden per il programmatore.
+* I18N per traduttore:: address@hidden per il traduttore.
+* Esempio I18N:: Un semplice esempio di internazionalizzazione.
+* Gawk internazionalizzato:: Anche @command{gawk} @`e internazionalizzato.
+* Sommario I18N:: Sommario dell'internazionalizzazione.
address@hidden menu
+
address@hidden I18N e L10N
address@hidden Internazionalizzazione e localizzazione
+
address@hidden internazionalizzazione di programmi @command{awk}
address@hidden localizzazione, si veda address@hidden localizzazione
address@hidden localizzazione
address@hidden significa scrivere (o modificare) un programma
+una volta sola,
+in maniera tale che possa usare address@hidden di una lingua senza
+bisogno di ulteriori modifiche al file sorgente.
address@hidden
+significa fornire i dati necessari perch@'e un programma
+internazionalizzato sia in grado di funzionare con una data lingua.
+Questi termini si riferiscono comunemente a address@hidden quali la lingua
+usata per stampare messaggi di errore, quella usata per leggere
+risposte, e alle informazioni
+relative al modo di leggere e di stampare dati di tipo numerico o valutario.
+
address@hidden Utilizzare @command{gettext}
address@hidden Il comando GNU @command{gettext}
+
address@hidden internazionalizzare un programma
address@hidden @command{gettext}, libreria
address@hidden libreria @command{gettext}
address@hidden usa il comando GNU @command{gettext} per rendere disponibili
+le proprie address@hidden di internazionalizzazione.
+L'attenzione del comando GNU @command{gettext} @`e rivolta principalmente
+ai messaggi: stringhe di caratteri stampate da un programma, sia
+direttamente sia usando la formattazione prevista dalle istruzioni
address@hidden o @code{sprintf()address@hidden alcuni sistemi operativi,
+la relativa versione di @command{gawk}
+non supporta il comando GNU @command{gettext}.
+Per questo motivo, queste address@hidden non sono disponibili nel caso
+si stia lavorando con uno di questi sistemi operativi. Siamo spiacenti.}
+
address@hidden address@hidden, libreria @command{gettext} e
+Quando si usa il comando GNU @command{gettext}, ogni applicazione ha il
+proprio @dfn{dominio di testo}. Questo @`e un nome unico come,
+p.es., @samp{kpilot} o @samp{gawk},
+che identifica l'applicazione.
+Un'applicazione completa address@hidden avere address@hidden componenti:
programmi scritti
+in C o C++, come pure script di @command{sh} o di @command{awk}.
+Tutti i componenti usano lo stesso dominio di testo.
+
+Per andare sul concreto, si supponga di scrivere un'applicazione
+chiamata @command{guide}. L'internazionalizzazione per quest'applicazione
address@hidden essere implementata seguendo nell'ordine i passi qui delineati:
+
address@hidden
address@hidden
+Il programmatore esamina i sorgenti di tutti i componenti dell'applicazione
address@hidden e prende nota di ogni stringa che potrebbe aver bisogno
+di traduzione.
+Per esempio, @code{"`-F': option required"} @`e una stringa che sicuramente
+necessita di una traduzione.
+Una tabella che contenga stringhe che sono nomi di opzioni @emph{non}
+necessita di traduzione.
+(P.es., l'opzione di @command{gawk} @option{--profile}
+dovrebbe restare immutata, a prescindere dalla lingua locale).
+
address@hidden @code{textdomain()}, funzione (libreria C)
address@hidden funzione @code{textdomain()} (libreria C)
address@hidden
+Il programmatore indica il dominio di testo dell'applicazione
+(@command{"guide"}) alla libreria @command{gettext},
+chiamando la funzione @code{textdomain()}.
+
address@hidden @code{.pot}, file
address@hidden file @code{.pot}
address@hidden @dfn{portable object template} (.pot), file
address@hidden file, @dfn{portable object template} (.pot)
address@hidden
+I messaggi dell'applicazione che vanno tradotti sono estratti dal codice
+sorgente e messi in un file di tipo
address@hidden object template}
+[modello di oggetto portabile]
+di nome @file{guide.pot},
+che elenca le stringhe e le relative traduzioni.
+Le traduzioni sono inizialmente vuote
+(esiste la struttura che definisce la stringa tradotta, ma la stringa
+tradotta @`e una stringa nulla).
+Il messaggio originale (normalmente in inglese) @`e utilizzato come chiave
+di riferimento per le traduzioni.
+
address@hidden @code{.po}, file
address@hidden file @code{.po}
address@hidden @dfn{portable object} file (.po)
address@hidden file, @dfn{portable object} (.po)
address@hidden
+Per ogni lingua per cui sia disponibile un traduttore, il file
address@hidden @`e copiato in un file di tipo
address@hidden object}
+[oggetto portabile]
+(dal suffisso @code{.po})
+e le traduzioni sono effettuate su quel file,
+che viene distribuito con l'applicazione.
+Per esempio, potrebbe esserci un file @file{it.po} per la traduzione italiana.
+
address@hidden @code{.gmo}, file
address@hidden file @code{.gmo}
address@hidden @dfn{message object} file (.mo)
address@hidden file, @dfn{message object} (.mo)
address@hidden
+Il file @file{.po} di ogni lingua @`e convertito in un formato binario,
+detto @dfn{message object} (file @file{.gmo}).
+Un file di tipo @dfn{message object} contiene i messaggi originali e le loro
+traduzioni in un formato binario che facilita il ritrovamento delle
+traduzioni quando l'applicazione viene eseguita.
+
address@hidden
+Quando @command{guide} @`e compilato e installato, i file binari contenenti le
+traduzioni sono installati in una directory standard.
+
address@hidden @code{bindtextdomain()}, funzione (libreria C)
address@hidden funzione @code{bindtextdomain()} (libreria C)
address@hidden
+Durante la fase di prova e sviluppo, @`e possibile chiedere a @command{gettext}
+di usare un file @file{.gmo} in una directory diversa da quella standard,
+usando la funzione @code{bindtextdomain()}.
+
address@hidden @code{.gmo}, file, specificare la directory di
address@hidden file @code{.gmo}, specificare la directory di
address@hidden @dfn{message object} file (.mo), specificare la directory di
address@hidden file, @dfn{message object} (.mo), specificare la directory di
address@hidden
+Quando viene eseguito, il programma @command{awk} @command{guide} cerca ogni
+stringa da tradurre facendo una chiamata a @code{gettext()}. La stringa
+ricevuta in ritorno @`e la stringa tradotta, se @`e stata trovata, o la stringa
+originale, se una traduzione non @`e disponibile.
+
address@hidden
+Se necessario, @`e possibile procurarsi dei messaggi tradotti da un dominio di
+testo diverso da quello proprio dell'applicazione, senza dover altalenare fra
+questo secondo dominio e quello dell'applicazione.
address@hidden enumerate
+
address@hidden @code{gettext()}, funzione (libreria C)
address@hidden funzione @code{gettext()} (libreria C)
+In C (o C++), la marcatura della stringa la ricerca dinamica
+della traduzione si fanno inserendo ogni stringa da tradurre in una chiamata
+a @code{gettext()}:
+
address@hidden
+printf("%s", gettext("Don't Panic!\n"));
address@hidden example
+
+Gli strumenti software che estraggono messaggi dal codice sorgente
+individuano tutte le stringhe racchiuse nelle chiamate a @code{gettext()}.
+
address@hidden @code{_} (trattino basso), macro C
address@hidden trattino basso (@code{_}), macro C
+Gli sviluppatori del comando GNU @command{gettext}, riconoscendo che
+continuare a immettere @samp{gettext(@dots{})} @`e sia faticoso che poco
+elegante da vedere, usano la macro @samp{_} (un trattino basso) per
+facilitare la cosa:
+
address@hidden
+/* Nel file di intestazione standard: */
+#define _(str) gettext(str)
+
+/* Nel testo del programma: */
+printf("%s", _("Don't Panic!\n"));
address@hidden example
+
address@hidden internazionalizzazione, localizzazione, categorie di
localizzazione
address@hidden @command{gettext}, libreria, categorie di localizzazione
address@hidden libreria @command{gettext}, categorie di localizzazione
address@hidden categorie di localizzazione
address@hidden
+Questo permette di ridurre la digitazione extra a solo tre caratteri per
+ogni stringa da tradurre e inoltre migliora di molto la address@hidden
+
+Ci sono @dfn{categorie} di localizzazione per tipi diversi di informazioni
+legate a una particolare localizzazione.
+Le categorie di localizzazione note a @command{gettext} sono:
+
address@hidden @code
address@hidden @code{LC_MESSAGES}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_MESSAGES}
address@hidden LC_MESSAGES
+Testo dei messaggi. Questa @`e la categoria di default usata all'interno di
address@hidden, ma @`e possibile specificarne esplicitamente una differente,
+se necessario. (Questo non @`e quasi mai necessario.)
+
address@hidden ordinare caratteri in lingue differenti
address@hidden @code{LC_COLLATE}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_COLLATE}
address@hidden LC_COLLATE
+Informazioni sull'ordinamento alfabetico (address@hidden, come caratteri
diversi e/o
+gruppi di carattere sono ordinati in un dato linguaggio).
address@hidden ad esempio i vari caratteri accentati in italiano, vanno ordinati
address@hidden insieme alla loro lettera "principale" (e @`e @'e).
+
address@hidden @code{LC_CTYPE}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_CTYPE}
address@hidden LC_CTYPE
+Informazioni sui singoli caratteri (alfabetico, numerico, maiuscolo
+o minuscolo, etc.), come pure sulla codifica dei caratteri.
address@hidden
+In June 2001 Bruno Haible wrote:
+- Description of LC_CTYPE: It determines both
+ 1. character encoding,
+ 2. character type information.
+ (For example, in both KOI8-R and ISO-8859-5 the character type information
+ is the same - cyrillic letters could as 'alpha' - but the encoding is
+ different.)
address@hidden ignore
+Quest'informazione @`e utilizzata per stabilire le classi di caratteri come
+definite nello standard POSIX, nelle espressioni regolari,
+come p. es. @code{/[[:alnum:]]/}
+(@pxref{Espressioni tra parentesi quadre}).
+
address@hidden informazioni di tipo monetario, localizzazione
address@hidden monete, simboli di, nella localizzazione
address@hidden simboli di monete, nella localizzazione
address@hidden monete, rappresentazioni di, nella localizzazione
address@hidden rappresentazioni di monete, nella localizzazione
address@hidden @code{LC_MONETARY}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_MONETARY}
address@hidden LC_MONETARY
+Le informazioni di tipo monetario, quali il simbolo della moneta, e se
+il simbolo va prima o dopo il valore numerico.
+
address@hidden @code{LC_NUMERIC}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_NUMERIC}
address@hidden LC_NUMERIC
+Informazioni di tipo numerico, quali il carattere da usare per separare le
+cifre decimali e quello per separare le address@hidden americani usano
+una virgola ogni tre cifre decimali, e un punto per separare la parte decimale
+di un numero, mentre molti europei (fra cui gli italiani) fanno esattamente
+l'opposto: 1,234.56 invece che 1.234,56.}
+
address@hidden tempo, localizzazione e
address@hidden date, informazioni relative alla localizzazione
address@hidden @code{LC_TIME}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_TIME}
address@hidden LC_TIME
+Informazioni relative alle date e alle ore,
+come l'uso di ore nel formato a 12 ore oppure a 24 ore, il mese stampato
+prima o dopo il giorno in una data, le abbreviazioni dei mesi nella lingua
+locale, e address@hidden@dotless{i}} via.
+
address@hidden @code{LC_ALL}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_ALL}
address@hidden LC_ALL
+Tutte le categorie viste sopra. (Non molto utile nel contesto del comando
address@hidden)
address@hidden table
+
address@hidden NOTA
address@hidden @env{LANGUAGE}, variabile d'ambiente
address@hidden variabile d'ambiente @env{LANGUAGE}
+Come descritto in @ref{Localizzazioni}, le variabili d'ambiente
+che hanno lo stesso nome delle categorie di localizzazione
+(@env{LC_CTYPE}, @env{LC_ALL}, etc.) influenzano il comportamento di
address@hidden (e quello di altri programmi di address@hidden).
+
+Solitamente, queste variabili influenzano anche il modo con cui
+la libreria @code{gettext} trova le traduzioni. Tuttavia, la
+variabile d'ambiente @env{LANGUAGE} prevale sulle variabili
+della famiglia @address@hidden Molti sistemi GNU/Linux possono
+aver definito questa variabile senza esplicitamente notificarlo
+all'utente, e questo potrebbe far address@hidden@dotless{i}} che
@command{gawk} non riesca a
+trovare le traduzioni corrette. Se si incontra questa situazione,
+occorre controllare se la variabile d'ambiente @env{LANGUAGE} @`e
+definita, e, in questo caso, va usato il comando @command{unset}
+per rimuoverla.
address@hidden quotation
+
+Per il test di traduzioni dei messaggi inviati da @command{gawk} stesso, si
address@hidden
+impostare la variabile d'ambiente @env{GAWK_LOCALE_DIR}. Si veda la
+documentazione per la funzione C @code{bindtextdomain()}, e si veda anche
address@hidden variabili d'ambiente}.
+
address@hidden I18N per programmatore
address@hidden Internazionalizzare programmi @command{awk}
address@hidden programmi @command{awk}, internazionalizzare
address@hidden internazionalizzazione di programmi @command{awk}
+
address@hidden prevede le seguenti variabili per l'internazionalizzazione:
+
address@hidden @code
address@hidden @code{TEXTDOMAIN}, variabile
address@hidden variabile @code{TEXTDOMAIN}
address@hidden TEXTDOMAIN
+Questa variabile indica il dominio di testo dell'applicazione.
+Per address@hidden con il comando GNU @command{gettext}, il valore di default
address@hidden @code{"messages"}.
+
address@hidden internazionalizzazione, localizzazione, stringhe marcate
address@hidden stringhe, marcare per localizzazione
address@hidden _"questo @`e un messaggio da tradurre"
+Costanti di tipo stringa marcate con un trattino basso iniziale
+sono candidate per essere tradotte al momento dell'esecuzione del
+programma @command{gawk}.
+Costanti di tipo stringa non precedute da un trattino basso non
+verranno tradotte.
address@hidden table
+
address@hidden fornisce le seguenti funzioni al servizio
+dell'internazionalizzazione:
+
address@hidden @code
address@hidden
address@hidden @code{dcgettext(@var{string}} address@hidden,} @var{dominio}
address@hidden,} @address@hidden)}
+Restituisce la traduzione di @var{stringa} nel
+dominio di testo @var{dominio} per la categoria di localizzazione
@var{categoria}.
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
+
+Se si assegna un valore a @var{categoria}, dev'essere una stringa uguale a
+una delle categorie di localizzazione note, descritte
address@hidden
+nella precedente @value{SECTION}.
address@hidden ifnotinfo
address@hidden
address@hidden @command{gettext}}.
address@hidden ifinfo
+Si deve anche specificare un dominio di testo. Si usi @code{TEXTDOMAIN} se
+si desidera usare il dominio corrente.
+
address@hidden ATTENZIONE
+L'ordine degli argomenti per la versione @command{awk}
+della funzione @code{dcgettext()} @`e differente, per una scelta di progetto,
+dall'ordine degli argomenti passati alla funzione C che ha lo stesso nome.
+L'ordine della versione @command{awk} @`e stato scelto per amore di
address@hidden e per consentire di avere dei valori di default per gli
+argomenti che fossero il address@hidden possibile simili, come stile, a quello
di
address@hidden
address@hidden quotation
+
address@hidden
address@hidden @code{dcngettext(@var{stringa1}, @var{stringa2}, @var{numero}}
address@hidden,} @var{dominio} address@hidden,} @address@hidden)}
+Restituisce la forma, singolare o plurale, da usare a seconda del valore
+di @var{numero} per la
+traduzione di @var{stringa1} e @var{stringa2} nel dominio di testo
address@hidden per la categoria di localizzazione @var{categoria}.
address@hidden @`e la variante al singolare in inglese di un messaggio,
+e @var{stringa2} @`e la variante al plurale in inglese dello stesso messaggio.
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
+
+Valgono le stesse osservazioni riguardo all'ordine degli argomenti
+fatte a proposito della funzione @code{dcgettext()}.
+
address@hidden @code{.gmo}, file, specificare la directory di
address@hidden file @code{.gmo}, specificare la directory di
address@hidden @dfn{message object} file (.mo), specificare la directory di
address@hidden file, @dfn{message object} (.mo), specificare la directory di
address@hidden
address@hidden @code{bindtextdomain(@var{directory}} address@hidden,}
@var{dominio} address@hidden)}
+Cambia la directory nella quale
address@hidden va a cercare i file @file{.gmo}, per il caso in cui questi
+non possano risiedere nelle posizioni standard
+(p.es., in fase di test).
+Restituisce la directory alla quale @var{dominio} @`e ``collegato''.
+
+Il @var{dominio} di default @`e il valore di @code{TEXTDOMAIN}.
+Se l'argomento @var{directory} @`e impostato alla stringa nulla (@code{""}),
address@hidden()} restituisce il collegamento corrente applicabile
+al @var{dominio} specificato.
address@hidden table
+
+Per usare queste address@hidden in un programma @command{awk},
+va seguita la procedura qui indicata:
+
address@hidden
address@hidden @code{BEGIN}, criterio di ricerca, variabile @code{TEXTDOMAIN} e
address@hidden criterio di ricerca @code{BEGIN}, variabile @code{TEXTDOMAIN} e
address@hidden @code{TEXTDOMAIN}, variabile, criterio di ricerca @code{BEGIN} e
address@hidden variabile @code{TEXTDOMAIN}, criterio di ricerca @code{BEGIN} e
address@hidden
+Impostare la variabile @code{TEXTDOMAIN} al dominio di testo del
+programma. @`E meglio fare address@hidden all'interno di una regola
@code{BEGIN}
+(@pxref{BEGIN/END}),
+ma si address@hidden anche fare dalla riga di comando, usando l'opzione
@option{-v}
+(@pxref{Opzioni}):
+
address@hidden
+BEGIN @{
+ TEXTDOMAIN = "guide"
+ @dots{}
address@hidden
address@hidden example
+
address@hidden @code{_} (trattino basso), stringa traducibile
address@hidden trattino basso (@code{_}), stringa traducibile
address@hidden
+Marcare tutte le stringhe traducibili anteponendo loro un
+trattino basso (@samp{_}). Il trattino @emph{deve} essere adiacente ai
+doppi apici di apertura della stringa. Per esempio:
+
address@hidden
+print _"hello, world"
+x = _"you goofed"
+printf(_"Number of users is %d\n", nusers)
address@hidden example
+
address@hidden
+Se le stringhe da visualizzare sono create dinamicamente, @`e ancora possibile
+tradurle, usando la funzione predefinita @code{dcgettext()}:@footnote{I miei
+ringraziamenti a Bruno Haible per questo esempio.}
+
address@hidden
+if (assonnato)
+ messaggio = dcgettext("%d clienti mi scocciano\n", "adminprog")
+else
+ messaggio = dcgettext("mi diverto con %d clienti\n", "adminprog")
+printf(messaggio, numero_clienti)
address@hidden example
+
+In questo esempio, la chiamata a @code{dcgettext()} specifica un diverso
+dominio di testo (@code{"adminprog"}) in cui trovare il
+messaggio, ma usa la categoria di default @code{"LC_MESSAGES"}.
+
+Il precedente esempio funziona solo se @code{numero_clienti} @`e un numero
maggiore
+di uno.
+Per questo esempio sarebbe address@hidden appropriato usare la funzione
@code{dcngettext()}:
+
address@hidden
+if (assonnato)
+ messaggio = dcngettext("%d cliente mi scoccia\n",
+ "%d clienti mi scocciano\n",
+ numero_clienti, "adminprog")
+else
+ messaggio = dcngettext("mi diverto con %d cliente\n",
+ "mi diverto con %d clienti\n",
+ numero_clienti, "adminprog")
+printf(messaggio, numero_clienti)
address@hidden example
+
+
address@hidden @code{LC_MESSAGES}, categoria di localizzazione, funzione
@code{bindtextdomain()} di (@command{gawk})
address@hidden
+In fase di sviluppo, si address@hidden scegliere di tenere il file @file{.gmo}
+in una directory a parte, solo per provarlo. address@hidden si fa
+con la funzione predefinita @code{bindtextdomain()}:
+
address@hidden
+BEGIN @{
+ TEXTDOMAIN = "guide" # dominio di testo regolare
+ if (Testing) @{
+ # dove trovare il file in prova
+ bindtextdomain("testdir")
+ # joe si occupa del programma adminprog
+ bindtextdomain("../joe/testdir", "adminprog")
+ @}
+ @dots{}
address@hidden
address@hidden example
+
address@hidden enumerate
+
address@hidden I18N}
+per un programma di esempio che illustra i passi da seguire per creare
+e usare traduzioni nei programmi @command{awk}.
+
address@hidden I18N per traduttore
address@hidden Traduzione dei programmi @command{awk}
+
address@hidden @code{.po}, file
address@hidden file @code{.po}
address@hidden @dfn{portable object} file (.po)
address@hidden file, @dfn{portable object} (.po)
+Dopo aver marcato le stringhe che si desidera tradurre in un programma,
+queste vanno estratte per creare il file iniziale @file{.pot}.
+Durante la traduzione, @`e spesso utile modificare l'ordine nel quale
+gli argomenti passati a @code{printf} vengono stampati.
+
+L'opzione da riga di comando @option{--gen-pot} di @command{gawk} serve a
+estrarre i messaggi, ed @`e esposta qui di seguito.
+Dopo di che, address@hidden illustrata la address@hidden di modificare l'ordine
+in cui l'istruzione @code{printf} stampa gli argomenti che le sono passati
+in fase di esecuzione.
+
address@hidden
+* Estrazione di stringhe:: Estrarre stringhe marcate.
+* Ordinamento di printf:: Riordinare argomenti @code{printf}
+* address@hidden nell'I18N:: Problemi di address@hidden a livello di
@command{awk}.
address@hidden menu
+
address@hidden Estrazione di stringhe
address@hidden Estrarre stringhe marcate
address@hidden stringhe, estrazione di
address@hidden stringhe marcate, estrazione di
address@hidden @option{--gen-pot}, opzione
address@hidden opzione @option{--gen-pot}
address@hidden opzioni sulla riga di comando, estrazione stringhe
address@hidden riga di comando, opzioni, estrazione stringhe
address@hidden stringhe marcate, estrazione di (internazionalizzazione)
address@hidden marcate, estrazione di stringhe (internazionalizzazione)
address@hidden estrazione di stringhe marcate (internazionalizzazione)
+
address@hidden @option{--gen-pot}, opzione
address@hidden opzione @option{--gen-pot}
+Una volta che il programma @command{awk} funziona, e tutte le stringhe
+sono state marcate ed @`e stato impostato (e forse fissato) il dominio di
+testo, @`e ora di preparare le traduzioni.
+Per prima cosa, usando l'opzione di riga di comando @option{--gen-pot},
+si crea il file iniziale @file{.pot}:
+
address@hidden
+gawk --gen-pot -f guide.awk > guide.pot
address@hidden example
+
address@hidden @code{xgettext}, programma di address@hidden
address@hidden programma di address@hidden @code{xgettext}
+Quando viene chiamato specificando @option{--gen-pot}, @command{gawk} non
+esegue il programma. Il programma viene esaminato come al solito, e tutte
+le stringhe che sono state marcate per essere tradotte vengono scritte nello
+standard output, nel formato di un file Portable Object di GNU
address@hidden
+L'output comprende anche quelle stringhe costanti che appaiono come primo
+argomento della funzione @code{dcgettext()} o come primo e secondo
+argomento della funzione @code{dcngettext()address@hidden comando di
address@hidden
address@hidden che fa parte del pacchetto distribuito come
address@hidden @`e in grado di gestire i file di tipo @file{.awk}.}
+Il file @file{.pot} address@hidden@dotless{i}} generato
+andrebbe distribuito insieme al programma @command{awk}; i traduttori
+potranno eventualmente utilizzarlo per preparare delle traduzioni, le quali
+potranno a loro volta essere distribuite.
address@hidden I18N}
+per una lista esauriente dei passi necessari per creare e testare
+traduzioni per il programma @command{guide}.
+
address@hidden Ordinamento di printf
address@hidden Riordinare argomenti di @code{printf}
+
address@hidden @code{printf}, istruzione, specificatori di posizione
address@hidden istruzione @code{printf}, specificatori posizionali
address@hidden posizionali, specificatori, istruzione @code{printf}
address@hidden specificatori posizionali, istruzione @code{printf}
+Le stringhe di formattazione per @code{printf} e @code{sprintf()}
+(@pxref{Printf})
+hanno un problema speciale con le traduzioni.
+Si consideri il seguente esempio:@footnote{Questo esempio @`e preso in
+prestito dal manuale del comando GNU @command{gettext}.}
+
address@hidden
+printf(_"String `%s' has %d characters\n",
+ string, length(string)))
address@hidden example
+
+Una possibile traduzione in italiano di questo messaggio potrebbe essere:
+
address@hidden
+"%d @`e la lunghezza della stringa `%s'\n"
address@hidden example
+
+Il problema dovrebbe essere ovvio: l'ordine delle specifiche di
+formattazione @`e differente da quello originale!
address@hidden()}, che pure address@hidden restituire la stringa tradotta
+in fase di esecuzione, non @`e in grado di cambiare l'ordine degli argomenti
+nella chiamata a @code{printf}.
+
+Per risolvere questo problema, gli specificatori di formato di @code{printf}
+possono avere un elemento in address@hidden, facoltativo, detto
@dfn{specificatore
+posizionale}. Per esempio:
+
address@hidden
+"%2$d @`e la lunghezza della stringa `%1$s'\n"
address@hidden example
+
+Qui, lo specificatore posizionale consiste in un numero intero, che indica
+quale argomento utilizzare, seguito da un carattere @samp{$}.
+I numeri partono da uno, e la stringa di formattazione vera e propria
address@hidden @`e inclusa. Quindi, nell'esempio seguente, @samp{stringa} @`e
+il primo argomento e @samp{length(stringa)} @`e il secondo:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{stringa = "Non v\47allarmate!"}
+> @kbd{printf "%2$d caratteri compongono \"%1$s\"\n",}
+> @kbd{stringa, length(stringa)}
+> @address@hidden'}
address@hidden 16 caratteri compongono "Non v\47allarmate!"
address@hidden example
+
+Se presenti, gli specificatori posizionali precedono, nella specifica di
+formato, i flag, la larghezza del campo e/o la precisione.
+
+Gli specificatori posizionali possono essere usati anche se si specifica una
+larghezza dinamica dei campi, e della address@hidden di precisione:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{printf("%*.*s\n", 10, 20, "hello")}
+> @kbd{printf("%3$*2$.*1$s\n", 20, 10, "hello")}
+> @address@hidden'}
address@hidden hello
address@hidden hello
address@hidden example
+
address@hidden NOTA
+Se si usa @samp{*} con uno specificatore posizionale, il carattere @samp{*}
+viene per primo, seguito dal numero che indica la posizione, a sua volta
+seguito dal @samp{$}.
address@hidden address@hidden parere poco intuitivo.
address@hidden quotation
+
address@hidden istruzione @code{printf}, specificatori posizionali, frammisti a
formati standard
address@hidden @code{printf}, istruzione, specificatori posizionali, frammisti
a formati standard
address@hidden specificatori posizionali, istruzione @code{printf}, frammisti a
formati standard
address@hidden formato, specificatori di, frammisti a specificatori posizionali
non standard
address@hidden specificatori di formato, frammisti a specificatori posizionali
non standard
address@hidden non consente di mischiare specificatori di formato standard
+con altri contenenti degli specificatori posizionali in una stessa stringa di
+formato:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "%d %3$s\n", 1, 2, "ciao" @}'}
address@hidden gawk: riga com.:1: fatale: `count$' va usato per tutti
address@hidden i formati o per nessuno
address@hidden example
+
address@hidden NOTA
+Ci sono alcuni casi patologici in cui @command{gawk} potrebbe non inviare
+alcun messaggio diagnostico, anche quando sarebbe necessario.
+In tali casi, l'output address@hidden non essere quello atteso.
+Rimane sempre una pessima idea quella di tentare di mischiare i formati,
+anche se @command{gawk} non riesce ad accorgersene.
address@hidden quotation
+
+Sebbene gli specificatori posizionali possano essere usati direttamente nei
+programmi @command{awk}, il motivo per cui sono stati introdotti @`e perch@'e
+siano d'aiuto nel produrre traduzioni corrette della stringa di
+formattazione in lingue differenti da quella nella quale il programma @`e stato
+originariamente scritto.
+
address@hidden address@hidden nell'I18N
address@hidden Problemi di address@hidden a livello di @command{awk}
+
address@hidden address@hidden, internazionalizzazione e
address@hidden internazionalizzazione, localizzazione, address@hidden e
+Le address@hidden di internazionalizzazione di @command{gawk} sono state
+appositamente implementate per avere il minimo impatto possibile sulla
address@hidden, verso altre versioni di @command{awk}, dei programmi
address@hidden che ne fanno uso.
+Si consideri questo programma:
+
address@hidden
+BEGIN @{
+ TEXTDOMAIN = "guide"
+ if (Test_Guide) # da impostare tramite -v
+ bindtextdomain("/test/guide/messages")
+ print _"don't panic!"
address@hidden
address@hidden example
+
address@hidden
+Per il modo in cui @`e scritto, non address@hidden con altre versioni di
address@hidden
+Tuttavia, @`e in address@hidden quasi portabile, e richiede modifiche minime:
+
address@hidden @value{BULLET}
address@hidden @code{TEXTDOMAIN}, variabile, address@hidden e
address@hidden variabile @code{TEXTDOMAIN}, address@hidden e
address@hidden
+Le assegnazioni di valori a @code{TEXTDOMAIN} non avranno effetto alcuno,
+perch@'e @code{TEXTDOMAIN} non @`e una variabile speciale in altre
+implementazioni di @command{awk}.
+
address@hidden
+Versioni Non-GNU di @command{awk} considerano le stringhe marcate
+come la concatenazione di una variabile di nome @code{_} con la stringa che
+viene subito address@hidden @`e
+un buon materiale per una gara di address@hidden @command{awk}''.}
+Tipicamente, la variabile @code{_} ha come valore la stringa nulla
+(@code{""}), il che produce come risultato la stringa
+originale.
+
address@hidden
+Definendo delle funzioni ``fittizie'' per sostituire @code{dcgettext()},
address@hidden()} e @code{bindtextdomain()}, il programma @command{awk}
address@hidden essere reso eseguibile, ma
+tutti i messaggi verranno inviati nella lingua originale del programma.
+Per esempio:
+
address@hidden @code{bindtextdomain()}, funzione (@command{gawk}),
address@hidden e
address@hidden funzione @code{bindtextdomain()} (@command{gawk}),
address@hidden e
address@hidden @code{dcgettext()}, funzione (@command{gawk}), address@hidden e
address@hidden funzione @code{dcgettext()} (@command{gawk}), address@hidden e
address@hidden @code{dcngettext()}, funzione (@command{gawk}), address@hidden e
address@hidden funzione @code{dcngettext()} (@command{gawk}), address@hidden e
address@hidden
address@hidden file eg/lib/libintl.awk
+function bindtextdomain(dir, domain)
address@hidden
+ return dir
address@hidden
+
+function dcgettext(string, domain, category)
address@hidden
+ return string
address@hidden
+
+function dcngettext(string1, string2, number, domain, category)
address@hidden
+ return (number == 1 ? string1 : string2)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+L'uso di specificazioni posizionali in @code{printf} o
address@hidden()} @emph{non} @`e portabile.
+Per supportare @code{gettext()} nella programmazione in linguaggio C,
+molte versioni C di @code{sprintf()} supportano specificatori posizionali.
+Ma la cosa funziona solo se nella chiamata di funzione sono stati specificati
+argomenti a sufficienza. Molte
+versioni di @command{awk} passano i formati e gli argomenti di @code{printf},
+senza modificarli, alla funzione di libreria in linguaggio C @code{sprintf()},
+ma solo un formato e un argomento alla volta. Quel che succede se si usa una
+specificazione posizionale resta indeterminato.
+Tuttavia, poich@'e le specificazioni posizionali sono usate principalmente
+per le stringhe di formattazione @emph{tradotte}, e poich@'e le versioni
+non-GNU di @command{awk} non utilizzano mai le stringhe tradotte,
address@hidden non
+dovrebbe, in pratica, causare problemi.
address@hidden itemize
+
address@hidden Esempio I18N
address@hidden Un semplice esempio di internazionalizzazione.
+
+Vediamo ora un esempio dettagliato di come internazionalizzare e localizzare
+un semplice programma @command{awk}, usando come nostro programma sorgente
+originale il file @file{guide.awk}:
+
address@hidden
address@hidden file eg/prog/guide.awk
+BEGIN @{
+ TEXTDOMAIN = "guide"
+ bindtextdomain(".") # per la fase di test
+ print _"Don't Panic"
+ print _"The Answer Is", 42
+ print "Pardon me, Zaphod who?"
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Eseguire @samp{gawk --gen-pot} per creare il file @file{.pot}:
+
address@hidden
+$ @kbd{gawk --gen-pot -f guide.awk > guide.pot}
address@hidden example
+
address@hidden
+Questo produce:
+
address@hidden
address@hidden file eg/data/guide.po
+#: guide.awk:4
+msgid "Don't Panic"
+msgstr ""
+
+#: guide.awk:5
+msgid "The Answer Is"
+msgstr ""
+
address@hidden endfile
address@hidden example
+
+Questo modello di @dfn{portable object} va salvato e riutilizzato per ogni
+lingua in cui l'applicazione viene tradotta. La stringa @code{msgid} @`e
+seguita dalla stringa originale da tradurre, e la stringa @code{msgstr}
address@hidden la traduzione.
+
address@hidden NOTA
+Le stringhe non aventi come prefisso un trattino basso non sono inserite
+nel file @file{guide.pot}.
address@hidden quotation
+
+Successivamente, i messaggi devono essere tradotti.
+Questa @`e una traduzione in un ipotetico dialetto dell'inglese,
+chiamato ``Mellow'':@footnote{Forse sarebbe meglio chiamarlo
+``Hippy.'' Meglio non indagare oltre.}
+
address@hidden
address@hidden
+$ @kbd{cp guide.pot guide-mellow.po}
address@hidden traduzioni al file} guide-mellow.po @dots{}
address@hidden group
address@hidden example
+
address@hidden
+Ecco le traduzioni:
+
address@hidden
address@hidden file eg/data/guide-mellow.po
+#: guide.awk:4
+msgid "Don't Panic"
+msgstr "Hey man, relax!"
+
+#: guide.awk:5
+msgid "The Answer Is"
+msgstr "Like, the scoop is"
+
address@hidden endfile
address@hidden example
+
address@hidden Linux
address@hidden GNU/Linux
+Il passo successivo @`e di creare la directory che contenga il file binario
+con le traduzioni dei messaggi (file .mo [message object]) e
+creare in quella directory il file @file{guide.mo}.
+Si presume che il file in questione debba essere usato nella localizzazione
address@hidden, perch@'e si deve usare un nome di localizzazione che sia
+noto alle routine del comando C @command{gettext}.
+La disposizione delle directory qui utilizzata @`e standard per il comando
+GNU @command{gettext} sui sistemi GNU/Linux. Altre versioni di
address@hidden possono usare una disposizione differente:
+
address@hidden
+$ @kbd{mkdir en_US.UTF-8 en_US.UTF-8/LC_MESSAGES}
address@hidden example
+
address@hidden @code{.po}, file, conversione in @code{.mo}
address@hidden file @code{.po}, conversione in @code{.mo}
address@hidden @code{.mo}, file, conversione da @code{.po}
address@hidden file @code{.mo}, conversione da @code{.po}
address@hidden @dfn{portable object} file (.po), conversione in @dfn{message
object} file
address@hidden file, @dfn{portable object} (.po), conversione in @dfn{message
object} file
address@hidden @dfn{message object} file (.mo), conversione da @dfn{portable
object} file
address@hidden file, @dfn{message object} (.mo), conversione da @dfn{portable
object} file
address@hidden @command{msgfmt}, programma di address@hidden
address@hidden programma di address@hidden @command{msgfmt}
+Il programma di address@hidden @command{msgfmt} effettua la conversione dal
file
+leggibile, in formato testo, @file{.po} nel file, in formato binario,
address@hidden
+Per default, @command{msgfmt} crea un file di nome @file{messages}.
+A questo file dev'essere assegnato un nome appropriato, e va messo nella
+directory predisposta (usando l'opzione @option{-o}) in modo che
address@hidden sia in grado di trovarlo:
+
address@hidden
+$ @kbd{msgfmt guide-mellow.po -o en_US.UTF-8/LC_MESSAGES/guide.mo}
address@hidden example
+
+Infine, eseguiamo il programma per provare se funziona:
+
address@hidden
+$ @kbd{gawk -f guide.awk}
address@hidden Hey man, relax!
address@hidden Like, the scoop is 42
address@hidden Pardon me, Zaphod who?
address@hidden example
+
+Se le tre funzioni che rimpiazzano @code{dcgettext()}, @code{dcngettext()},
+e @code{bindtextdomain()}
+(@address@hidden nell'I18N})
+sono contenute in un file di nome @file{libintl.awk},
address@hidden possibile eseguire @file{guide.awk} senza modificarlo, nel modo
seguente:
+
address@hidden
+$ @kbd{gawk --posix -f guide.awk -f libintl.awk}
address@hidden Don't Panic
address@hidden The Answer Is 42
address@hidden Pardon me, Zaphod who?
address@hidden example
+
address@hidden Gawk internazionalizzato
address@hidden @command{gawk} stesso @`e internazionalizzato
+
+Il comando @command{gawk} stesso @`e stato internazionalizzato
+usando il pacchetto GNU @command{gettext}.
+(GNU @command{gettext} @`e descritto in
+maniera esauriente in
address@hidden
address@hidden, , GNU @command{gettext} utilities, gettext, GNU
@command{gettext} utilities}.)
address@hidden ifinfo
address@hidden
address@hidden://www.gnu.org/software/gettext/manual/,
address@hidden @command{gettext} utilities}}.)
address@hidden ifnotinfo
+Al momento in cui questo libro @`e stato scritto, la versione address@hidden
recente di
+GNU @command{gettext} @`e
address@hidden://ftp.gnu.org/gnu/gettext/gettext-0.19.4.tar.gz,
address@hidden 0.19.4}.
+
+Se esiste una traduzione dei messaggi di @command{gawk},
address@hidden invia messaggi, avvertimenti, ed errori fatali
+utilizzando la lingua locale.
+
address@hidden Sommario I18N
address@hidden Sommario
address@hidden @value{BULLET}
address@hidden
+Internazionalizzazione significa scrivere un programma in modo che
+possa interagire in molte lingue senza che sia necessario cambiare il codice
+sorgente.
+Localizzazione significa fornire i dati necessari perch@'e un programma
+internazionalizzato possa interagire usando una determinata lingua.
+
address@hidden
address@hidden usa il comando GNU @command{gettext} per consentire
+l'internazionalizzazione e la localizzazione di programmi @command{awk}.
+Un dominio di testo di un programma identifica il programma, e consente di
+raggruppare tutti i messaggi e gli altri dati del programma in un solo posto.
+
address@hidden
+Si marcano le stringhe in un programma da tradurre preponendo loro un
+trattino basso. Una volta fatto questo, queste stringhe sono estratte
+in un file @file{.pot}. Questo file @`e copiato, per ogni lingua, in un file
address@hidden e i file @file{.po} sono
+compilati in file @file{.gmo} che saranno usati in fase di
+esecuzione del programma.
+
address@hidden
address@hidden possibile usare specificazioni posizionali con le istruzioni
address@hidden()} e @code{printf} per modificare la posizione del valore
+degli argomenti nelle stringhe di formato e nell'output. address@hidden @`e
utile nella
+traduzione di stringhe di
+formattazione dei messaggi.
+
address@hidden
+Le address@hidden di internazionalizzazione sono state progettate in modo
+da poter essere facilmente gestite in un programma @command{awk} standard.
+
address@hidden
+Anche il comando @command{gawk} @`e stato internazionalizzato e viene
+distribuito con traduzioni in molte lingue dei messaggi inviati in fase di
+esecuzione.
+
address@hidden itemize
+
+
address@hidden Debugger
address@hidden Effettuare il debug dei programmi @command{awk}
address@hidden debug dei programmi @command{awk}
+
address@hidden The original text for this chapter was contributed by Efraim
Yawitz.
address@hidden FIXME: Add more indexing.
+
+Sarebbe bello se i programmi per il calcolatore funzionassero perfettamente la
+prima volta che vengono eseguiti, ma nella vita reale questo accade raramente,
+qualunque sia la address@hidden dei programmi. address@hidden la maggior
parte dei
+linguaggi di programmazione hanno a disposizione degli strumenti che facilitano
+la ricerca di errori (@dfn{debugging}) nei programmi, e @command{awk} non fa
+eccezione.
+
+Il @dfn{debugger} di @command{gawk} @`e di proposito costruito sul modello del
+debugger da riga di comando
address@hidden://www.gnu.org/software/gdb/, GNU Debugger (GDB)}.
+Se si ha address@hidden con GDB, address@hidden facile imparare come usare
@command{gawk}
+per eseguire il debug dei propri programmi.
+
address@hidden
+* Debugging:: Introduzione al debugger di @command{gawk}.
+* Esempio di sessione di debug:: Esempio di sessione di debug.
+* Lista dei comandi di debug:: Principali comandi di debug.
+* Supporto per Readline:: Supporto per Readline.
+* Limitazioni:: Limitazioni e piani per il futuro.
+* Sommario sul debug:: Sommario sul debug.
address@hidden menu
+
address@hidden Debugging
address@hidden Introduzione al debugger di @command{gawk}
+
+Questa @value{SECTION}, dopo un'introduzione sul debug in generale, inizia
+la trattazione del debug in @command{gawk}.
+
address@hidden
+* Nozioni sul debug:: address@hidden sul debug.
+* Terminologia nel debug:: Ulteriori nozioni sul debug.
+* Debug di Awk:: Eseguire il debug di Awk.
address@hidden menu
+
address@hidden Nozioni sul debug
address@hidden address@hidden sul debug
+
+(Se si sono usati dei debugger in altri linguaggi, si address@hidden andare
direttamente
+alla @ref{Debug di Awk}.)
+
+Naturalmente, un programma di debug non address@hidden correggere gli errori
al posto del
+programmatore, perch@'e non address@hidden sapere quello che il programmatore
o gli utenti
+considerano un ``bug'' e non una address@hidden''. (Talvolta, anche noi umani
+abbiamo address@hidden nel determinarlo.)
+In quel caso, cosa ci si address@hidden aspettare da un tale strumento? La
risposta
+dipende dal linguaggio su cui si effettua il debug, comunque in generale ci si
address@hidden attendere almeno questo:
+
address@hidden @value{BULLET}
address@hidden
+La address@hidden di osservare l'esecuzione delle istruzioni di un programma
una
+per una, dando al programmatore l'address@hidden di pensare a quel che accade a
+una scala temporale di secondi, minuti od ore, piuttosto che alla scala dei
+nanosecondi alla quale normalmente viene eseguito il codice.
+
address@hidden
+L'address@hidden, non solo di osservare passivamente le operazioni del
progamma,
+ma di controllarlo e tentare diversi percorsi di esecuzione, senza dover
+modificare i file sorgenti.
+
address@hidden
+La address@hidden di vedere i valori o i dati nel programma in qualsiasi punto
+dell'esecuzione, e anche di cambiare i dati al volo, per vedere come questo
+influisca su address@hidden che accade dopo. (Questo include spesso la
address@hidden di
+esaminare le strutture interne dei dati oltre alle variabili che
+sono state effettivamente definite nel codice del programma.)
+
address@hidden
+La address@hidden di ottenere ulteriori informazioni sullo stato del programma
+o anche sulle sue strutture interne.
address@hidden itemize
+
+Tutti questi strumenti sono di grande aiuto e permettono di usare
l'address@hidden
+che si possiede e la comprensione che si ha degli obiettivi del programma
+per trovare dove si verificano i problemi (o, in alternativa, per
+comprendere meglio la logica di un programma funzionante, di cui si sia
+l'autore, o anche di un programma scritto da altri).
+
address@hidden Terminologia nel debug
address@hidden Concetti fondamentali sul debug
+
+Prima di entrare nei dettagli, dobbiamo introdurre diversi
+importanti concetti che valgono per tutti i debugger.
+La seguente lista definisce i termini usati nel resto di
+questo @value{CHAPTER}:
+
address@hidden @dfn
address@hidden @dfn{stack frame}
address@hidden Stack frame
+Durante la loro esecuzione i programmi normalmente chiamano delle funzioni.
+Una funzione address@hidden a sua volta chiamarne un'altra, o address@hidden
richiamare se stessa
+(ricorsione). La
+catena di funzioni chiamate (il programma principale chiama A, che chiama B,
+che chiama C) address@hidden essere vista come una pila di funzioni in
esecuzione: la
+funzione correntemente in esecuzione @`e quella in cima alla pila, e quando
+questa finisce (ritorna al chiamante),
+quella immediatamente sotto diventa la funzione
+attiva. Tale pila (@dfn{stack}) @`e chiamata @dfn{call stack} (pila delle
chiamate).
+
+Per ciascuna funzione della pila delle chiamate (@dfn{call stack}), il sistema
+mantiene un'area di dati che contiene i parametri della funzione, le variabili
+locali e i valori di ritorno, e anche ogni altra informazione ``contabile''
+necessaria per gestire la pila delle chiamate. Quest'area di dati @`e chiamata
address@hidden frame}.
+
+Anche @command{gawk} segue questo modello, e permette l'accesso alla pila
+delle chiamate e a ogni @dfn{stack frame}. @`E possibile esaminare la pila
+delle chiamate, e anche sapere da dove ciascuna funzione sulla pila @`e stata
+invocata. I comandi che stampano la pila delle chiamate stampano anche le
+informazioni su ogni @dfn{stack frame} (come vedremo address@hidden avanti in
dettaglio).
+
address@hidden Punto d'interruzione
address@hidden breakpoint
address@hidden punto d'interruzione
+Durante le operazioni di debug, spesso si preferisce lasciare che il programma
+venga eseguito finch@'e non raggiunge un certo punto, e da quel punto in poi si
+continua l'esecuzione un'istruzione alla volta. Il modo per farlo @`e quello
di
+impostare un @dfn{punto d'interruzione} all'interno del programma. Un punto
+d'interruzione @`e il punto dove l'esecuzione del programma dovrebbe
+interrompersi (fermarsi), in modo da assumere il controllo dell'esecuzione del
+programma. Si possono aggiungere e togliere quanti punti d'interruzione si
+vogliono.
+
address@hidden Punto d'osservazione
address@hidden @dfn{watchpoint}
address@hidden punto d'osservazione
+Un punto d'osservazione @`e simile a un punto d'interruzione. La differenza
@`e
+che i punti d'interruzione sono orientati attorno al codice; fermano il
+programma quando viene raggiunto un certo punto nel codice. Un punto
+d'osservazione, invece, fa fermare il programma quando @`e stato
+cambiato il @emph{valore di un dato}. Questo @`e utile, poich@'e a volte
succede
+che una variabile riceva un valore errato, ed @`e difficile rintracciare il
punto
+dove address@hidden accade solo leggendo il codice sorgente.
+Usando un punto d'osservazione, si address@hidden fermare il programma in
qualunque punto
+vi sia un'assegnazione di variabile, e di solito si individua il codice che
+genera l'errore abbastanza velocemente.
address@hidden table
+
address@hidden Debug di Awk
address@hidden Il debug di @command{awk}
+
+Il debug di un programma @command{awk} ha delle address@hidden proprie, che
+non sono presenti in programmi scritti in altri linguaggi.
+
+Prima di tutto, il fatto che i programmi @command{awk} ricevano generalmente
+l'input riga per riga da uno o address@hidden file e operino su tali righe
usando regole
+specifiche, rende particolarmente agevole organizzare l'esame
+dell'esecuzione del programma facendo riferimento a tali regole.
+Come vedremo, ogni
+regola @command{awk} viene trattata quasi come una chiamata di funzione, col
+proprio specifico blocco di istruzioni.
+
+Inoltre, poich@'e @command{awk} @`e un linguaggio deliberatamente molto
+conciso, @`e facile perdere di vista tutto address@hidden che avviene
``dentro''
+ogni riga di codice @command{awk}. Il debugger address@hidden
l'address@hidden di
+guardare le singole istruzioni primitive la cui esecuzione @`e innescata
+dai comandi di alto livello di @command{awk}.
+
address@hidden Esempio di sessione di debug
address@hidden Esempio di sessione di debug di @command{gawk}
address@hidden esempio di sessione di debug
address@hidden debug, esempio di sessione
+
+Per illustrare l'uso di @command{gawk} come debugger, vediamo un esempio di
+sessione di debug. Come esempio address@hidden usata l'implementazione
@command{awk}
+del comando POSIX @command{uniq} descritta in precedenza (@pxref{Programma
+uniq}).
+
address@hidden
+* Invocazione del debugger:: Come far partire il debugger.
+* Trovare il bug:: Trovare il bug.
address@hidden menu
+
address@hidden Invocazione del debugger
address@hidden Come avviare il debugger
address@hidden avviare il debugger
address@hidden debugger, come avviarlo
address@hidden debugger, comandi del, si veda comando del debugger
+
+Per avviare il debugger in @command{gawk} si richiama il comando esattamente
+come al solito, specificando solo un'opzione aggiuntiva,
address@hidden, o la corrispondente opzione breve @option{-D}.
+I file (o il file) che contengono
+il programma e ogni codice ulteriore sono immessi sulla riga di comando come
+argomenti a una o address@hidden opzioni @option{-f}. (@command{gawk} non @`e
progettato per
+eseguire il debug di programmi scritti sulla riga di comando, ma solo per
+quello di programmi che risiedono su file.)
+Nel nostro caso, il debugger address@hidden invocato in questo modo:
+
address@hidden
+$ @kbd{gawk -D -f getopt.awk -f join.awk -f uniq.awk -1 file_di_input}
address@hidden example
+
address@hidden
+dove entrambi i file @file{getopt.awk} e @file{uniq.awk} sono in
@env{$AWKPATH}.
+(Gli utenti esperti di GDB o debugger simili dovrebbero tener presente che
+questa sintassi @`e leggermente differente da quello che sono abituati a usare.
+Col debugger di @command{gawk}, si danno gli argomenti per eseguire il
+programma nella riga di comando al debugger piuttosto che come parte del
+comando @code{run} al prompt del debugger.)
+L'opzione @option{-1} @`e un'opzione per @file{uniq.awk}.
+
+Invece di eseguire direttamente il programma sul @file{file_di_input}, come
address@hidden farebbe normalmente, il debugger semplicemente carica
+i file sorgenti del programma, li compila internamente, e poi mostra
+la riga d'invito:
+
address@hidden
+gawk>
address@hidden example
+
address@hidden
+da dove si possono impartire i comandi al debugger. Sin qui non @`e
+stato ancora eseguito nessun codice.
+
address@hidden Trovare il bug
address@hidden Trovare il bug
+
+Poniamo di avere un problema usando (una versione difettosa di)
address@hidden nella address@hidden ``salta-campi'', perch@'e sembra che non
+catturi le righe che dovrebbero essere identiche dopo aver saltato il primo
+campo, come:
+
address@hidden
+awk, ecco un programma meraviglioso!
+gawk, ecco un programma meraviglioso!
address@hidden example
+
+Questo potrebbe accadere se noi pensassimo (come in C) che i campi in un record
+siano numerati prendendo come base lo zero, per cui, invece di scrivere:
+
address@hidden
+campi_ultima = join(vettore_ultima, contatore_file+1, n)
+campi_corrente = join(vettore_corrente, contatore_file+1, m)
address@hidden example
+
address@hidden
+abbiamo scritto:
+
address@hidden
+campi_ultima = join(vettore_ultima, contatore_file, n)
+campi_corrente = join(vettore_corrente, contatore_file, m)
address@hidden example
+
+La prima cosa da fare quando si tenta di indagare su un problema come questo
@`e
+quella di mettere un punto d'interruzione (@dfn{breakpoint}) nel programma, in
modo
+da poterlo vedere al lavoro e catturare quello che non va. Una posizione
+ragionevole per un punto d'interruzione in @file{uniq.awk} @`e all'inizio della
+funzione @code{se_sono_uguali()}, che confronta la riga corrente con la
precedente.
+Per impostare il punto d'interruzione, usare il comando @code{b}
(@dfn{breakpoint}):
+
address@hidden
+gawk> @kbd{b se_sono_uguali}
address@hidden Breakpoint 1 impostato al file `uniq.awk', riga 63
address@hidden example
+
+Il debugger mostra il file e il numero di riga dove si trova il punto
+d'interruzione. Ora bisogna immettere @samp{r} o @samp{run} e il programma
+viene eseguito fino al primo punto d'interruzione:
+
address@hidden
+gawk> @kbd{r}
address@hidden Partenza del programma:
address@hidden Mi fermo in Rule ...
address@hidden Breakpoint 1, se_sono_uguali(n, m, campi_ultima, campi_corrente,
address@hidden vettore_ultima, vettore_corrente)
address@hidden a `uniq.awk':63
address@hidden 63 if (contatore_file == 0 && conta_caratteri == 0)
+gawk>
address@hidden example
+
+Ora possiamo osservare cosa accade all'interno del nostro programma.
+Prima di tutto, vediamo come siamo arrivati a questo punto. Sulla riga di
+comando battiamo @samp{bt} (che sta per ``backtrace''), e il debugger risponde
+con un listato degli @dfn{stack frame} correnti:
+
address@hidden
+gawk> @kbd{bt}
address@hidden #0 se_sono_uguali(n, m, campi_ultima, campi_corrente,
address@hidden vettore_ultima, vettore_corrente)
address@hidden a `uniq.awk':63
address@hidden #1 in main() a `uniq.awk':88
address@hidden example
+
+Questo ci dice che la funzione @code{se_sono_uguali()} @`e stata chiamata
+dal programma principale alla riga 88 del file @file{uniq.awk}. (Questo non
+sorprende, perch@'e @`e questa l'unica chiamata a @code{se_sono_uguali()} nel
+programma, address@hidden in programmi
address@hidden complessi, sapere chi ha chiamato una funzione e con quali
parametri address@hidden
+essere la chiave per trovare l'origine del problema.)
+
+Ora che siamo in @code{se_sono_uguali()}, possiamo iniziare a guardare i
valori di
+alcune variabili. Immaginiamo di battere @samp{p n}
+(@code{p} sta per @dfn{print} [stampa]). Ci aspetteremo di vedere il valore di
address@hidden, un parametro di @code{se_sono_uguali()}. In address@hidden, il
debugger
+ci address@hidden:
+
address@hidden
+gawk> @kbd{p n}
address@hidden n = untyped variable
address@hidden example
+
address@hidden
+In questo caso, @code{n} @`e una variabile locale non inizializzata, perch@'e
la
+funzione @`e stata chiamata senza argomenti (@pxref{Chiamate di funzione}).
+
+Una variabile address@hidden utile da visualizzare potrebbe essere la seguente:
+
address@hidden
+gawk> @kbd{p $0}
address@hidden $0 = "gawk, ecco un programma meraviglioso!"
address@hidden example
+
address@hidden
+All'inizio questo potrebbe lasciare un tantino perplessi, perch@'e @`e la
seconda
+riga dell'input del test. Vediamo @code{NR}:
+
address@hidden
+gawk> @kbd{p NR}
address@hidden NR = 2
address@hidden example
+
address@hidden
+Come si address@hidden vedere, @code{se_sono_uguali()} @`e stata chiamata solo
per la seconda
+riga del file. Naturalmente, address@hidden accade perch@'e il nostro
programma contiene
+una regola per @samp{NR == 1}:
+
address@hidden
+NR == 1 @{
+ ultima = $0
+ next
address@hidden
address@hidden example
+
+Bene, controlliamo che questa funzioni correttamente:
+
address@hidden
+gawk> @kbd{p ultima}
address@hidden ultima = "awk, ecco un programma meraviglioso!"
address@hidden example
+
+Tutto address@hidden che @`e stato fatto fin qui ha verificato che il
programma funziona
+come previsto fino alla chiamata a @code{se_sono_uguali()} compresa; quindi
+il problema dev'essere all'interno di questa funzione. Per indagare
+ulteriormente, iniziamo a ``scorrere una ad una'' le righe di
address@hidden()}. Cominciamo col battere @samp{n} (per ``next''
+[successivo]):
+
address@hidden
+gawk> @kbd{n}
address@hidden 66 if (contatore_file > 0) @{
address@hidden example
+
+Questo ci dice che @command{gawk} ora @`e pronto per eseguire la riga 66, che
+decide se assegnare alle righe il trattamento speciale ``salta-campi''
+indicato dall'opzione sulla riga di comando @option{-1}. (Si noti che abbiamo
+saltato da dov'eravamo prima, alla riga 63, a qui, perch@'e la condizione nella
+riga 63, @samp{if (contatore_file == 0 && conta_caratteri == 0)}, era falsa.)
+
+Continuando a scorrere le righe, ora raggiungiamo la divisione del record
+corrente e dell'ultimo:
+
address@hidden
+gawk> @kbd{n}
address@hidden 67 n = split(ultima, vettore_ultima)
+gawk> @kbd{n}
address@hidden 68 m = split($0, vettore_corrente)
address@hidden example
+
+A questo punto, potremmo stare a vedere in quante parti il nostro record
address@hidden stato suddiviso, quindi proviamo a osservare:
+
address@hidden
+gawk> @kbd{p n m vettore_ultima vettore_corrente}
address@hidden n = 5
address@hidden m = untyped variable
address@hidden vettore_ultima = array, 5 elements
address@hidden vettore_corrente = untyped variable
address@hidden example
+
address@hidden
+(Il comando @code{p} address@hidden accettare address@hidden argomenti,
analogamente
+all'istruzione di @command{awk} @code{print}.)
+
+Questo ci lascia piuttosto perplessi. Tutto address@hidden che abbiamo
trovato @`e che ci
+sono cinque elementi in @code{vettore_ultima}; @code{m} e
@code{vettore_corrente} non hanno valori
+perch@'e siamo alla riga 68 che non @`e ancora stata eseguita. Questa
+informazione @`e abbastanza utile (ora sappiamo che nessuna delle parole @`e
stata
+lasciata fuori accidentalmente), ma sarebbe desiderabile vedere i valori
+del vettore.
+
+Una prima address@hidden @`e quella di usare degli indici:
+
address@hidden
+gawk> @kbd{p vettore_ultima[0]}
address@hidden "0" non presente nel vettore `vettore_ultima'
address@hidden example
+
address@hidden
+Oops!
+
address@hidden
+gawk> @kbd{p vettore_ultima[1]}
address@hidden vettore_ultima["1"] = "awk,"
address@hidden example
+
+Questo metodo sarebbe piuttosto lento per un vettore con 100 elementi, per cui
address@hidden fornisce una scorciatoia (che fa venire in mente un altro
+linguaggio che non nominiamo):
+
address@hidden
+gawk> @kbd{p @@vettore_ultima}
address@hidden vettore_ultima["1"] = "awk,"
address@hidden vettore_ultima["2"] = "ecco"
address@hidden vettore_ultima["3"] = "un"
address@hidden vettore_ultima["4"] = "programma"
address@hidden vettore_ultima["5"] = "meraviglioso!"
address@hidden example
+
+Finora, sembra che tutto vada bene. Facciamo un altro passo,
+o anche due:
+
address@hidden
+gawk> @kbd{n}
address@hidden 69 campi_ultima = join(vettore_ultima,
contatore_file, n)
+gawk> @kbd{n}
address@hidden 70 campi_corrente = join(vettore_corrente,
contatore_file, m)
address@hidden example
+
+Bene, eccoci arrivati al nostro errore (ci spiace di aver rovinato la
+sorpresa).
+Quel che avevamo in mente era di unire i campi a partire dal secondo per
+creare il record virtuale da confrontare, e se il primo campo aveva il numero
+zero, questo avrebbe funzionato. Vediamo quel che abbiamo finora:
+
address@hidden
+gawk> @kbd{p campi_ultima campi_corrente}
address@hidden campi_ultima = "awk, ecco un programma meraviglioso!"
address@hidden campi_corrente = "gawk, ecco un programma meraviglioso!"
address@hidden example
+
+Ehi! queste frasi suonano piuttosto familiari! Sono esattamente i nostri
+record di input originali, inalterati. Pensandoci un po' (il cervello umano
@`e
+ancora il miglior strumento di debug), ci si rende conto che eravamo fuori di
+uno!
+
+Usciamo dal debugger:
+
address@hidden
+gawk> @kbd{q}
address@hidden Il programma @`e in esecuzione. Esco comunque (y/n)? @kbd{y}
address@hidden example
+
address@hidden
+Quindi modifichiamo con un editore di testo:
+
address@hidden
+campi_ultima = join(vettore_ultima, contatore_file+1, n)
+campi_corrente = join(vettore_corrente, contatore_file+1, m)
address@hidden example
+
address@hidden
+e il problema @`e risolto!
+
address@hidden Lista dei comandi di debug
address@hidden I principali comandi di debug
+
+L'insieme dei comandi del debugger di @command{gawk} address@hidden essere
diviso nelle
+seguenti categorie:
+
address@hidden @value{BULLET}
+
address@hidden
+Controllo di punti d'interruzione
+
address@hidden
+Controllo di esecuzione
+
address@hidden
+Vedere e modificare dati
+
address@hidden
+Lavorare con le pile
+
address@hidden
+Ottenere informazioni
+
address@hidden
+Comandi vari
address@hidden itemize
+
+Ciascuna di esse @`e trattata nelle sottosezioni che seguono.
+Nelle descrizioni seguenti, i comandi che possono essere abbreviati
+mostrano l'abbreviazione su una seconda riga di descrizione.
+Un nome di comando del debugger address@hidden essere anche troncato se la
parte address@hidden scritta
+non @`e ambigua. Il debugger ha la address@hidden predefinita di ripetere
+automaticamente il precedente comando semplicemente battendo @kbd{Invio}.
+Questo vale per i comandi @code{list}, @code{next}, @code{nexti},
address@hidden, @code{stepi} e @code{continue} quando sono eseguiti senza
+argomenti.
+
address@hidden
+* Controllo dei breakpoint:: Controllo dei punti d'interruzione.
+* Controllo esecuzione debugger:: Controllo di esecuzione.
+* Vedere e modificare dati:: Vedere e modificare dati.
+* Stack di esecuzione:: Lavorare con le pile.
+* Informazioni sul debugger:: Ottenere informazioni sullo stato del
+ programma e del debugger.
+* Comandi vari del debugger:: Comandi vari del debugger.
address@hidden menu
+
address@hidden Controllo dei breakpoint
address@hidden Controllo dei punti d'interruzione
+
+Come abbiamo address@hidden visto, la prima cosa che si dovrebbe fare in una
sessione di
+debug @`e quella di definire dei punti d'interruzione, poich@'e altrimenti il
+programma address@hidden eseguito come se non fosse sotto il debugger. I
comandi per
+controllare i punti d'interruzione sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{b} (alias per @code{break})
address@hidden comando del debugger, @code{break}
address@hidden @code{break}, comando del debugger
address@hidden @code{b}, comando del debugger (alias per @code{break})
address@hidden impostare un punto d'interruzione
address@hidden breakpoint, impostare
address@hidden punto d'interruzione (breakpoint), impostare
address@hidden @code{break} address@hidden@code{:address@hidden |
@var{funzione}] address@hidden"@var{espressione}"}]
address@hidden @code{b} address@hidden@code{:address@hidden | @var{funzione}]
address@hidden"@var{espressione}"}]
+Senza argomenti, imposta un punto d'interruzione alla prossima istruzione
+da eseguire nello @dfn{stack frame} selezionato.
+Gli argomenti possono essere uno dei seguenti:
+
address@hidden @asis for docbook
address@hidden nested table
address@hidden @asis
address@hidden @var{n}
+Imposta un punto d'interruzione alla riga numero @var{n} nel file sorgente
+corrente.
+
address@hidden @address@hidden:address@hidden
+Imposta un punto d'interruzione alla riga numero @var{n} nel file sorgente
address@hidden
+
address@hidden @var{funzione}
+Imposta un punto d'interruzione all'ingresso (la prima istruzione eseguibile)
+della funzione @var{funzione}.
address@hidden table
+
+A ogni punto d'interruzione @`e assegnato un numero che address@hidden essere
usato per
+cancellarlo dalla lista dei punti d'interruzione usando il comando
address@hidden
+
+Specificando un punto d'interruzione, si address@hidden fornire anche una
condizione.
+Questa @`e
+un'espressione @command{awk} (racchiusa tra doppi apici) che il debugger
+valuta ogni volta che viene raggiunto quel punto d'interruzione. Se la
+condizione @`e vera, il debugger ferma l'esecuzione e rimane in attesa di un
+comando. Altrimenti, continua l'esecuzione del programma.
+
address@hidden comando del debugger, @code{clear}
address@hidden @code{clear}, comando del debugger
address@hidden cancellare punto d'interruzione da una determinata posizione
address@hidden punto d'interruzione in una determinata posizione, come
cancellare
address@hidden breakpoint, come cancellare
address@hidden @code{clear} address@hidden@code{:address@hidden |
@var{funzione}]
+Senza argomenti, cancella ogni eventuale punto d'interruzione all'istruzione
+successiva
+da eseguirsi nello @dfn{stack frame} selezionato. Se il programma si ferma in
+un punto d'interruzione, quel punto d'interruzione viene cancellato in modo
+che il programma non si fermi address@hidden in quel punto.
+Gli argomenti possono essere uno tra i seguenti:
+
address@hidden nested table
address@hidden @asis
address@hidden @var{n}
+Cancella il punto (o i punti) d'interruzione impostato/i alla riga @var{n} nel
+file sorgente corrente.
+
address@hidden @address@hidden:address@hidden
+Cancella il punto (o i punti) d'interruzione impostato/i alla riga @var{n} nel
+file sorgente @var{nome-file}.
+
address@hidden @var{funzione}
+Cancella il punto (o i punti) d'interruzione impostato/i all'ingresso della
+funzione @var{funzione}.
address@hidden table
+
address@hidden comando del debugger, @code{condition}
address@hidden @code{condition}, comando del debugger
address@hidden condizione dei punti d'interruzione
address@hidden @code{condition} @var{n} @code{"@var{espressione}"}
+Aggiunge una condizione al punto d'interruzione o al punto d'osservazione
+esistente @var{n}. La condizione @`e un'espressione @command{awk}
address@hidden tra doppi apici} che il debugger valuta ogni volta che viene
+raggiunto il punto d'interruzione o il punto d'osservazione. Se la condizione
@`e
+vera, il debugger ferma l'esecuzione e attende l'immissione di un comando.
+Altrimenti, il debugger continua l'esecuzione del programma. Se l'espressione
+della condizione non viene specificata, tutte le condizioni esistenti vengono
+rimosse (address@hidden, il punto d'interruzione o di osservazione viene
considerato
+incondizionato).
+
address@hidden comando del debugger, @code{d} (alias per @code{delete})
address@hidden comando del debugger, @code{delete}
address@hidden @code{delete}, comando del debugger
address@hidden @code{d}, comando del debugger (alias per @code{delete})
address@hidden cancellare punto d'interruzione per numero
address@hidden punto d'interruzione, cancellare per numero
address@hidden @code{delete} address@hidden n2} @dots{}] address@hidden@var{m}]
address@hidden @code{d} address@hidden n2} @dots{}] address@hidden@var{m}]
+Cancella i punti d'interruzione specificati o un intervallo di punti
+d'interruzione. Se non vengono forniti argomenti, cancella tutti i
+punti d'interruzione esistenti.
+
address@hidden comando del debugger, @code{disable}
address@hidden @code{disable}, comando del debugger
address@hidden disabilitare punto d'interruzione
address@hidden punto d'interruzione, come disabilitare o abilitare
address@hidden @code{disable} address@hidden n2} @dots{} | @address@hidden
+Disabilita punti d'interruzione specificati o un intervallo di essi. Senza
+argomenti, disabilita tutti i punti d'interruzione.
+
address@hidden comando del debugger, @code{e} (alias per @code{enable})
address@hidden comando del debugger, @code{enable}
address@hidden @code{enable}, comando del debugger
address@hidden @code{e}, comando del debugger (alias per @code{enable})
address@hidden abilitare un punto d'interruzione
address@hidden @code{enable} address@hidden | @code{once}] address@hidden n2}
@dots{}] address@hidden@var{m}]
address@hidden @code{e} address@hidden | @code{once}] address@hidden n2}
@dots{}] address@hidden@var{m}]
+Abilita specifici punti d'interruzione o un intervallo di essi. Senza
+argomenti, abilita tutti i punti d'interruzione.
+Opzionalmente, si address@hidden specificare come abilitare i punti
d'interruzione:
+
address@hidden nested table
address@hidden @code
address@hidden del
+Abilita dei punti d'interruzione @dfn{una tantum}, poi li cancella quando il
+programma si ferma in quel punto.
+
address@hidden once
+Abilita dei punti d'interruzione @dfn{una tantum}, poi li cancella quando il
+programma si ferma in quel punto.
address@hidden table
+
address@hidden comando del debugger, @code{ignore}
address@hidden @code{ignore}, comando del debugger
address@hidden ignorare un punto d'interruzione
address@hidden @code{ignore} @var{n} @var{contatore}
+Ignora il punto d'interruzione numero @var{n} le successive
address@hidden volte in cui viene raggiunto.
+
address@hidden comando del debugger, @code{t} (alias per @code{tbreak})
address@hidden comando del debugger, @code{tbreak}
address@hidden @code{tbreak}, comando del debugger
address@hidden @code{t}, comando del debugger (alias per @code{tbreak})
address@hidden punto d'interruzione temporaneo
address@hidden temporaneo, punto d'interruzione
address@hidden @code{tbreak} address@hidden@code{:address@hidden |
@var{funzione}]
address@hidden @code{t} address@hidden@code{:address@hidden | @var{funzione}]
+Imposta un punto d'interruzione temporaneo (abilitato solo per la prima volta
+che viene raggiunto). Gli argomenti sono gli stessi di @code{break}.
address@hidden table
+
address@hidden Controllo esecuzione debugger
address@hidden Controllo di esecuzione
+
+Dopo che i punti d'interruzione sono pronti, si address@hidden iniziare
l'esecuzione del
+programma, osservando il suo comportamento. Ci sono address@hidden comandi per
+controllare l'esecuzione del programma di quelli visti nei precedenti esempi:
+
address@hidden @asis
address@hidden comando del debugger, @code{commands}
address@hidden @code{commands}, comando del debugger
address@hidden comando del debugger, @code{silent}
address@hidden @code{silent}, comando del debugger
address@hidden comando del debugger, @code{end}
address@hidden @code{end}, comando del debugger
address@hidden punto d'interruzione, comandi
address@hidden comandi da eseguire al punto d'interruzione
address@hidden @code{commands} address@hidden
address@hidden @code{silent}
address@hidden @dots{}
address@hidden @code{end}
+Imposta una lista di comandi da eseguire subito dopo l'arresto del programma in
+un punto d'interruzione o di osservazione. @var{n} @`e il numero del punto
+d'interruzione o di osservazione. Se non si specifica un numero, viene usato
+l'ultimo numero che @`e stato specificato. I comandi veri e propri seguono,
+a cominciare dalla riga successiva, e hanno termine col comando @code{end}.
+Se il comando @code{silent} @`e nella lista, i consueti messaggi sull'arresto
del
+programma a un punto d'interruzione e la riga sorgente non vengono stampati.
+Qualsiasi comando nella lista che riprende l'esecuzione (p.es.,
address@hidden) pone fine alla lista (un @code{end} implicito), e i comandi
+successivi vengono ignorati.
+Per esempio:
+
address@hidden
+gawk> @kbd{commands}
+> @kbd{silent}
+> @kbd{printf "Un punto d'interruzione silenzioso; i = %d\n", i}
+> @kbd{info locals}
+> @kbd{set i = 10}
+> @kbd{continue}
+> @kbd{end}
+gawk>
address@hidden example
+
address@hidden comando del debugger, @code{c} (alias per @code{continue})
address@hidden comando del debugger, @code{continue}
address@hidden @code{continue}, comando del debugger
address@hidden @code{continue} address@hidden
address@hidden @code{c} address@hidden
+Riprende l'esecuzione del programma. Se si riparte da un punto d'interruzione
+e viene specificato @var{contatore}, il punto d'interruzione in quella
+posizione viene ignorato per le prossime @var{contatore} volte prima di
+fermarsi nuovamente.
+
address@hidden comando del debugger, @code{finish}
address@hidden @code{finish}, comando del debugger
address@hidden @code{finish}
+Esegue fino a quando lo stack frame selezionato completa l'esecuzione.
+Stampa il valore restituito.
+
address@hidden comando del debugger, @code{n} (alias per @code{next})
address@hidden comando del debugger, @code{next}
address@hidden @code{next}, comando del debugger
address@hidden @code{n}, comando del debugger (alias per @code{next})
address@hidden esecuzione di un solo passo, nel debugger
address@hidden @code{next} address@hidden
address@hidden @code{n} address@hidden
+Continua l'esecuzione alla successiva riga sorgente, saltando le chiamate di
+funzione. L'argomento @var{contatore} controlla il numero di ripetizioni
+dell'azione, come in @code{step}.
+
address@hidden comando del debugger, @code{ni} (alias per @code{nexti})
address@hidden comando del debugger, @code{nexti}
address@hidden @code{nexti}, comando del debugger
address@hidden @code{ni}, comando del debugger (alias for @code{nexti})
address@hidden @code{nexti} address@hidden
address@hidden @code{ni} address@hidden
+Esegue una o @var{contatore} istruzioni, comprese le chiamate di funzione.
+
address@hidden comando del debugger, @code{return}
address@hidden @code{return}, comando del debugger
address@hidden @code{return} address@hidden
+Cancella l'esecuzione di una chiamata di funzione. Se @var{valore} (una
+stringa o un numero) viene specificato, @`e usato come valore di ritorno della
+funzione. Se usato in un frame diverso da quello address@hidden interno (la
funzione
+correntemente in esecuzione; address@hidden, il frame numero 0), ignora tutti
i frame
address@hidden interni di quello selezionato, e il chiamante del frame
selezionato
+diventa il frame address@hidden interno.
+
address@hidden comando del debugger, @code{r} (alias per @code{run})
address@hidden comando del debugger, @code{run}
address@hidden @code{run}, comando del debugger
address@hidden @code{r}, comando del debugger (alias per @code{run})
address@hidden @code{run}
address@hidden @code{r}
+Avvia/riavvia l'esecuzione del programma. Quando il programma viene riavviato,
+il debugger mantiene i punti d'interruzione e di osservazione, la cronologia
+dei comandi, la visualizzazione automatica di variabili, e le opzioni del
+debugger.
+
address@hidden comando del debugger, @code{s} (alias per @code{step})
address@hidden comando del debugger, @code{step}
address@hidden @code{step}, comando del debugger
address@hidden @code{s}, comando del debugger (alias per @code{step})
address@hidden @code{step} address@hidden
address@hidden @code{s} address@hidden
+Continua l'esecuzione finch@'e il controllo non raggiunge una diversa riga del
+sorgente nello @dfn{stack frame} corrente, eseguendo ogni funzione chiamata
+all'interno della riga. Se viene fornito l'argomento @var{contatore},
+esegue il numero di istruzioni specificate prima di fermarsi, a meno che non
+s'imbatta in un punto d'interruzione o di osservazione.
+
address@hidden comando del debugger, @code{si} (alias per @code{stepi})
address@hidden comando del debugger, @code{stepi}
address@hidden @code{stepi}, comando del debugger
address@hidden @code{si}, comando del debugger (alias per @code{stepi})
address@hidden @code{stepi} address@hidden
address@hidden @code{si} address@hidden
+Esegue una o @var{contatore} istruzioni, comprese le chiamate di funzione.
+(Per una spiegazione su cosa s'intende per ``istruzione'' in @command{gawk},
+si veda l'output mostrato sotto @code{dump} nella
address@hidden vari del debugger}.)
+
address@hidden comando del debugger, @code{u} (alias per @code{until})
address@hidden comando del debugger, @code{until}
address@hidden @code{until}, comando del debugger
address@hidden @code{u}, comando del debugger (alias per @code{until})
address@hidden @code{until} address@hidden@code{:address@hidden |
@var{funzione}]
address@hidden @code{u} address@hidden@code{:address@hidden | @var{funzione}]
+Senza argomenti, prosegue l'esecuzione finch@'e non viene raggiunta una riga
+dopo la riga corrente nello @dfn{stack frame} corrente.
+Se viene specificato un argomento,
+prosegue l'esecuzione finch@'e non viene raggiunto il punto specificato, o
+lo @dfn{stack frame} corrente non termina l'esecuzione.
address@hidden table
+
address@hidden Vedere e modificare dati
address@hidden Vedere e modificare dati
+
+I comandi per vedere e modificare variabili all'interno di @command{gawk} sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{display}
address@hidden @code{display}, comando del debugger
address@hidden @code{display} address@hidden | @address@hidden
+Aggiunge la variabile @var{var} (o il campo @address@hidden) alla lista di
+visualizzazione. Il valore della variabile o del campo @`e visualizzato ogni
+volta che il programma s'interrompe.
+Ogni variabile aggiunta alla lista @`e identificata da un numero univoco:
+
address@hidden
+gawk> @kbd{display x}
address@hidden 10: x = 1
address@hidden example
+
address@hidden
+La riga qui sopra mostra il numero di elemento assegnato, il nome della
+variabile e il suo
+valore corrente. Se la variabile di display fa riferimento a un parametro di
+funzione, @`e cancellata silenziosamente dalla lista non appena l'esecuzione
+raggiunge un contesto dove la variabile con quel nome non esiste address@hidden
+Senza argomenti, @code{display} mostra i valori correnti degli elementi della
+lista.
+
address@hidden comando del debugger, @code{eval}
address@hidden @code{eval}, comando del debugger
address@hidden valutare espressioni, nel debugger
address@hidden @code{eval "@var{istruzioni awk}"}
+Valuta @var{istruzioni awk} nel contesto del programma in esecuzione.
+Si address@hidden fare qualsiasi cosa che un programma @command{awk} farebbe:
assegnare
+valori a variabili, chiamare funzioni, e address@hidden@dotless{i}} via.
+
address@hidden @code{eval} @var{param}, @dots{}
address@hidden @var{istruzioni awk}
address@hidden @code{end}
+Questa forma di @code{eval} @`e simile alla precedente, solo che permette di
+definire
+``variabili locali'' che esistono nel contesto delle @var{istruzioni awk},
+invece di usare variabili o parametri di funzione address@hidden definiti nel
programma.
+
address@hidden comando del debugger, @code{p} (alias per @code{print})
address@hidden comando del debugger, @code{print}
address@hidden @code{print}, comando del debugger
address@hidden @code{p}, comando del debugger (alias per @code{print})
address@hidden stampare variabili, nel debugger
address@hidden @code{print} @address@hidden,} @var{var2} @dots{}]
address@hidden @code{p} @address@hidden,} @var{var2} @dots{}]
+Stampa i valori di una o address@hidden variabili o campi di @command{gawk}.
+I campi devono essere indicizzati usando delle costanti:
+
address@hidden
+gawk> @kbd{print $3}
address@hidden example
+
address@hidden
+Questo stampa il terzo campo del record di input (se il campo specificato non
+esiste, stampa il @samp{campo nullo}). Una variabile address@hidden essere un
elemento di
+un vettore, avente come indice una
+stringa di valore costante. Per stampare
+il contenuto di un vettore, si deve anteporre il simbolo @samp{@@} al nome del
+vettore:
+
address@hidden
+gawk> @kbd{print @@a}
address@hidden example
+
address@hidden
+L'esempio stampa gli indici e i corrispondenti valori di tutti gli elementi
+del vettore @code{a}.
+
address@hidden comando del debugger, @code{printf}
address@hidden @code{printf}, comando del debugger
address@hidden @code{printf} @var{formato} address@hidden,} @var{arg} @dots{}]
+Stampa un testo formattato. Il @var{formato} address@hidden includere sequenze
di
+protezione, come @samp{\n}
+(@pxref{Sequenze di protezione}).
+Non viene stampato nessun ritorno a capo che non sia stato specificato
+esplicitamente.
+
address@hidden comando del debugger, @code{set}
address@hidden @code{set}, comando del debugger
address@hidden assegnare valori a variabili, nel debugger
address@hidden @code{set} @address@hidden@var{valore}
+Assegna un valore costante (numero o stringa) a una variabile o a un campo di
address@hidden
+I valori di stringa devono essere racchiusi tra doppi apici
+(@code{"address@hidden@code{"}).
+
+Si possono impostare anche delle variabili speciali di @command{awk}, come
address@hidden, @code{NF}, @code{NR}, e address@hidden@dotless{i}} via.
+
address@hidden comando del debugger, @code{w} (alias per @code{watch})
address@hidden comando del debugger, @code{watch}
address@hidden @code{watch}, comando del debugger
address@hidden @code{w}, comando del debugger (alias per @code{watch})
address@hidden impostare un punto d'osservazione
address@hidden @code{watch} @var{var} | @address@hidden
address@hidden"@var{espressione}"}]
address@hidden @code{w} @var{var} | @address@hidden
address@hidden"@var{espressione}"}]
+Aggiunge la variabile @var{var} (o il campo @address@hidden) alla lista dei
+punti d'osservazione. Il debugger quindi interrompe il programma ogni volta
+che il valore della variabile o del campo cambia. A ogni elemento osservato
+viene assegnato un numero che address@hidden essere usato per cancellarlo
dalla lista
+usando il comando @code{unwatch} [non-osservare address@hidden
+
+Definendo un punto d'osservazione, si address@hidden anche porre una
condizione, che @`e
+un'espressione @command{awk} (racchiusa tra doppi apici) che il debugger valuta
+ogni volta che viene raggiunto il punto d'osservazione. Se la condizione @`e
+vera, il debugger interrompe l'esecuzione e rimane in attesa di un comando.
+Altrimenti, @command{gawk} prosegue nell'esecuzione del programma.
+
address@hidden comando del debugger, @code{undisplay}
address@hidden @code{undisplay}, comando del debugger
address@hidden interruzione visualizzazioni automatiche, nel debugger
address@hidden @code{undisplay} address@hidden
+Rimuove l'elemento numero @var{n} (o tutti gli elementi, se non vi sono
+argomenti) dalla lista delle visualizzazioni automatiche.
+
address@hidden comando del debugger, @code{unwatch}
address@hidden @code{unwatch}, comando del debugger
address@hidden cancellare punto d'osservazione
address@hidden @code{unwatch} address@hidden
+Rimuove l'elemento numero @var{n} (o tutti gli elementi, se non vi sono
+argomenti) dalla lista dei punti d'osservazione.
+
address@hidden table
+
address@hidden Stack di esecuzione
address@hidden Lavorare con lo stack
+
+Ogni volta che si esegue un programma che contiene chiamate di funzione,
address@hidden mantiene una pila contenente la lista delle chiamate di funzione
+che hanno portato al punto in cui il programma si trova in ogni momento. @`E
+possibile vedere a che punto si trova il programma, e anche muoversi
+all'interno della pila per vedere qual era lo stato delle cose nelle funzioni
+che hanno chiamato quella in cui ci si trova. I comandi per far questo sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{bt} (alias per @code{backtrace})
address@hidden comando del debugger, @code{backtrace}
address@hidden comando del debugger, @code{where} (alias per @code{backtrace})
address@hidden @code{backtrace}, comando del debugger
address@hidden @code{bt}, comando del debugger (alias per @code{backtrace})
address@hidden @code{where}, comando del debugger
address@hidden @code{where}, comando del debugger (alias per @code{backtrace})
address@hidden chiamate, @dfn{stack} (pila) delle, mostrare nel debugger
address@hidden @dfn{stack} (pila) delle chiamate, mostrare nel debugger
address@hidden pila (@dfn{stack}) delle chiamate, mostrare nel debugger
address@hidden tracciatura a ritroso, mostrare nel debugger
address@hidden @code{backtrace} address@hidden
address@hidden @code{bt} address@hidden
address@hidden @code{where} address@hidden
+Stampa a ritroso una traccia di tutte le chiamate di funzione (stack frame), o
+i dei @var{contatore} frame address@hidden interni se @var{contatore} > 0.
Stampa i
address@hidden frame address@hidden esterni se @var{contatore} < 0. La
tracciatura a
+ritroso mostra il nome e gli argomenti di ciascuna funzione, il sorgente
address@hidden, e il numero di riga. L'alias @code{where} per @code{backtrace}
+viene mantenuto per i vecchi utenti di GDB che potrebbero essere abituati a
+quel comando.
+
address@hidden comando del debugger, @code{down}
address@hidden @code{down}, comando del debugger
address@hidden @code{down} address@hidden
+Sposta @var{contatore} (default 1) frame sotto la pila verso il frame
address@hidden interno.
+Poi seleziona e stampa il frame.
+
address@hidden comando del debugger, @code{f} (alias per @code{frame})
address@hidden comando del debugger, @code{frame}
address@hidden @code{frame}, comando del debugger
address@hidden @code{f}, comando del debugger (alias per @code{frame})
address@hidden @code{frame} address@hidden
address@hidden @code{f} address@hidden
+Seleziona e stampa lo @dfn{stack frame} @var{n}. Il frame 0 @`e quello
+correntemente in esecuzione, o il frame @address@hidden interno}, (chiamata di
+funzione); il frame 1 @`e il frame che ha chiamato quello address@hidden
interno. Il frame
+col numero address@hidden alto @`e quello per il programma principale. Le
informazioni
+stampate comprendono il numero di frame, i nomi delle funzioni e degli
+argomenti, i file sorgenti e le righe sorgenti.
+
address@hidden comando del debugger, @code{up}
address@hidden @code{up}, comando del debugger
address@hidden @code{up} address@hidden
+Sposta @var{contatore} (default 1) frame sopra la pila verso il frame
address@hidden
+esterno. Poi seleziona e stampa il frame.
address@hidden table
+
address@hidden Informazioni sul debugger
address@hidden Ottenere informazioni sullo stato del programma e del debugger
+
+Oltre che vedere i valori delle variabili, spesso si ha address@hidden di
ottenere
+informazioni di altro tipo sullo stato del programma e dello stesso ambiente di
+debug. Il debugger di @command{gawk} ha un comando che fornisce
+quest'informazione, chiamato convenientemente @code{info}. @code{info}
address@hidden usato con uno dei tanti argomenti che dicono esattamente quel
che si vuol
+sapere:
+
address@hidden @asis
address@hidden comando del debugger, @code{i} (alias per @code{info})
address@hidden comando del debugger, @code{info}
address@hidden @code{info}, comando del debugger
address@hidden @code{i}, comando del debugger (alias per @code{info})
address@hidden @code{info} @var{cosa}
address@hidden @code{i} @var{cosa}
+Il valore di @var{cosa} dovrebbe essere uno dei seguenti:
+
address@hidden nested table
address@hidden @code
address@hidden args
address@hidden mostrare argomenti delle funzioni, nel debugger
address@hidden debugger, mostrare argomenti delle funzioni
+Elenca gli argomenti del frame selezionato.
+
address@hidden break
address@hidden mostrare punti d'interruzione, nel debugger
address@hidden debugger, mostrare punti d'interruzione
+Elenca tutti i punti d'interruzione attualmente impostati.
+
address@hidden display
address@hidden visualizzazioni automatiche, nel debugger
address@hidden debugger, visualizzazioni automatiche
+Elenca tutti gli elementi della lista delle visualizzazioni automatiche.
+
address@hidden frame
address@hidden descrizione degli @dfn{stack frame} delle chiamate, nel debugger
address@hidden debugger, descrizione degli @dfn{stack frame} delle chiamate
address@hidden una descrizione degli @dfn{stack frame} selezionati.
+
address@hidden functions
address@hidden elencare definizioni delle funzioni, nel debugger
address@hidden debugger, elencare definizioni delle funzioni
+Elenca tutte le definizioni delle funzioni compresi i @value{FNS} e
+i numeri di riga.
+
address@hidden locals
address@hidden mostrare variabili locali, nel debugger
address@hidden debugger, mostrare variabili locali
+Elenca le variabili locali dei frame selezionati.
+
address@hidden source
address@hidden mostrare il nome del file sorgente corrente, nel debugger
address@hidden debugger, mostrare il nome del file sorgente corrente
+Stampa il nome del file sorgente corrente. Ogni volta che il programma si
+interrompe, il file sorgente corrente @`e il file che contiene l'istruzione
+corrente. Quando il debugger viene avviato per la prima volta, il file
+sorgente corrente @`e il primo file incluso attraverso l'opzione @option{-f}.
+Il comando @samp{list @var{nome-file}:@var{numero-riga}} address@hidden essere
usato in
+qualsiasi momento per cambiare il sorgente corrente.
+
address@hidden sources
address@hidden mostrare tutti i file sorgente, nel debugger
address@hidden debugger, mostrare tutti i file sorgenti
+Elenca tutti i sorgenti del programma.
+
address@hidden variables
address@hidden elencare tutte le variabili locali, nel debugger
address@hidden debugger, elencare tutte le variabili locali
+Elenca tutte le variabili locali.
+
address@hidden watch
address@hidden mostrare i punti d'osservazione, nel debugger
address@hidden debugger, mostrare i punti d'osservazione
+Elenca tutti gli elementi della lista dei punti d'osservazione.
address@hidden table
address@hidden table
+
+Ulteriori comandi permettono di avere il controllo sul debugger, la
address@hidden di
+salvare lo stato del debugger e la address@hidden di eseguire comandi del
debugger
+da un file. I comandi sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{o} (alias per @code{option})
address@hidden comando del debugger, @code{option}
address@hidden @code{option}, comando del debugger
address@hidden @code{o}, comando del debugger (alias per @code{option})
address@hidden visualizzare le opzioni del debugger
address@hidden debugger, opzioni del
address@hidden @code{option} address@hidden@address@hidden
address@hidden @code{o} address@hidden@address@hidden
+Senza argomenti, visualizza le opzioni del debugger disponibili e i loro valori
+correnti. @samp{option @var{nome}} mostra il valore corrente dell'opzione
address@hidden@dotless{i}} denominata. @samp{option @address@hidden assegna
+un nuovo valore all'opzione.
+Le opzioni disponibili sono:
+
address@hidden nested table
address@hidden asis for docbook
address@hidden @asis
address@hidden @code{history_size}
address@hidden debugger, dimensione della cronologia
+Imposta il numero massimo di righe da mantenere nel file della cronologia
address@hidden/.gawk_history}. Il valore di default @`e 100.
+
address@hidden @code{listsize}
address@hidden debugger, numero di righe nella lista di default
+Specifica il numero di righe che @code{list} deve stampare. Il valore di
+default @`e 15.
+
address@hidden @code{outfile}
address@hidden ridirezionare l'output di @command{gawk}, nel debugger
address@hidden debugger, ridirezionare l'output di @command{gawk}
+Invia l'output di @command{gawk} in un file; l'output del debugger @`e
+visualizzato comunque anche
+nello standard output. Assegnare come valore stringa vuota (@code{""})
+reimposta l'output solo allo standard output.
+
address@hidden @code{prompt}
address@hidden debugger, prompt
+Cambia la riga per l'immissione dei comandi del debugger. Il valore di
+default @`e @address@hidden> }}.
+
address@hidden @code{save_history} address@hidden | @code{off}]
address@hidden debugger, file della cronologia
+Salva la cronologia dei comandi nel file @file{./.gawk_history}.
+L'impostazione di default @`e @code{on}.
+
address@hidden @code{save_options} address@hidden | @code{off}]
address@hidden salvataggio opzioni debugger
address@hidden debugger, salvataggio opzioni
+Salva le opzioni correnti nel file @file{./.gawkrc} all'uscita.
+L'impostazione di default @`e @code{on}.
+Le opzioni sono lette di nuovo all'avvio della sessione successiva.
+
address@hidden @code{trace} address@hidden | @code{off}]
address@hidden istruzioni, tener traccia delle, nel debugger
address@hidden debugger, tener traccia delle istruzioni
+Attiva o disattiva il tracciamento delle istruzioni. L'impostazione di default
address@hidden @code{off}.
address@hidden table
+
address@hidden @code{save} @var{nome-file}
+Salva i comandi eseguiti nella sessione corrente nel @value{FN} indicato,
+in modo da poterli ripetere in seguito usando il comando @command{source}.
+
address@hidden @code{source} @var{nome-file}
address@hidden debugger, leggere comandi da un file
+Esegue comandi contenuti in un file; un errore in un comando non impedisce
+l'esecuzione dei comandi successivi. In un file di comandi sono consentiti
+i commenti (righe che iniziano con @samp{#}).
+Le righe vuote vengono ignorate; esse @emph{non}
+ripetono l'ultimo comando.
+Non si address@hidden riavviare il programma mettendo address@hidden di un
comando @code{run}
+nel file. Inoltre, la lista dei comandi address@hidden includere altri comandi
address@hidden; in ogni caso, il debugger di @command{gawk} non richiama lo
+stesso file address@hidden di una volta per evitare ricorsioni infinite.
+
+Oltre al comando @code{source}, o al posto di esso, si possono usare le opzioni
+sulla riga di comando @option{-D @var{file}} o @address@hidden
+per eseguire comandi da un file in maniera non interattiva
+(@pxref{Opzioni}).
address@hidden table
+
address@hidden Comandi vari del debugger
address@hidden Comandi vari del debugger
+
+Ci sono alcuni altri comandi che non rientrano nelle precedenti categorie,
+come i seguenti:
+
address@hidden @asis
address@hidden comando del debugger, @code{dump}
address@hidden @code{dump}, comando del debugger
address@hidden @code{dump} address@hidden
+Riversa il @dfn{byte code} del programma nello standard output o nel file
+definito in @var{nome-file}. Questo stampa una rappresentazione delle
+istruzioni interne che @command{gawk} esegue per implementare i comandi
address@hidden in un programma. address@hidden address@hidden essere molto
istruttivo, come
+dimostra il seguente riversamento parziale del codice offuscato di
+Davide Brini (@pxref{Programma signature}):
+
address@hidden FIXME: This will need updating if num-handler branch is ever
merged in.
address@hidden
+gawk> @kbd{dump}
address@hidden # BEGIN
address@hidden
address@hidden [ 1:0xfcd340] Op_rule : [in_rule = BEGIN]
[source_file = brini.awk]
address@hidden [ 1:0xfcc240] Op_push_i : "~" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc2a0] Op_push_i : "~" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc280] Op_match :
address@hidden [ 1:0xfcc1e0] Op_store_var : O
address@hidden [ 1:0xfcc2e0] Op_push_i : "==" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc340] Op_push_i : "==" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc320] Op_equal :
address@hidden [ 1:0xfcc200] Op_store_var : o
address@hidden [ 1:0xfcc380] Op_push : o
address@hidden [ 1:0xfcc360] Op_plus_i : 0 [MALLOC|NUMCUR|NUMBER]
address@hidden [ 1:0xfcc220] Op_push_lhs : o [do_reference = true]
address@hidden [ 1:0xfcc300] Op_assign_plus :
address@hidden [ :0xfcc2c0] Op_pop :
address@hidden [ 1:0xfcc400] Op_push : O
address@hidden [ 1:0xfcc420] Op_push_i : "" [MALLOC|STRING|STRCUR]
address@hidden [ :0xfcc4a0] Op_no_op :
address@hidden [ 1:0xfcc480] Op_push : O
address@hidden [ :0xfcc4c0] Op_concat : [expr_count = 3] [concat_flag
= 0]
address@hidden [ 1:0xfcc3c0] Op_store_var : x
address@hidden [ 1:0xfcc440] Op_push_lhs : X [do_reference = true]
address@hidden [ 1:0xfcc3a0] Op_postincrement :
address@hidden [ 1:0xfcc4e0] Op_push : x
address@hidden [ 1:0xfcc540] Op_push : o
address@hidden [ 1:0xfcc500] Op_plus :
address@hidden [ 1:0xfcc580] Op_push : o
address@hidden [ 1:0xfcc560] Op_plus :
address@hidden [ 1:0xfcc460] Op_leq :
address@hidden [ :0xfcc5c0] Op_jmp_false : [target_jmp = 0xfcc5e0]
address@hidden [ 1:0xfcc600] Op_push_i : "%c" [MALLOC|STRING|STRCUR]
address@hidden [ :0xfcc660] Op_no_op :
address@hidden [ 1:0xfcc520] Op_assign_concat : c
address@hidden [ :0xfcc620] Op_jmp : [target_jmp = 0xfcc440]
address@hidden
address@hidden
address@hidden
address@hidden [ 2:0xfcc5a0] Op_K_printf : [expr_count = 17]
[redir_type = ""]
address@hidden [ :0xfcc140] Op_no_op :
address@hidden [ :0xfcc1c0] Op_atexit :
address@hidden [ :0xfcc640] Op_stop :
address@hidden [ :0xfcc180] Op_no_op :
address@hidden [ :0xfcd150] Op_after_beginfile :
address@hidden [ :0xfcc160] Op_no_op :
address@hidden [ :0xfcc1a0] Op_after_endfile :
+gawk>
address@hidden smallexample
+
address@hidden comando del debugger, @code{exit}
address@hidden @code{exit}, comando del debugger
address@hidden uscire dal debugger
address@hidden debugger, uscire dal
address@hidden @code{exit}
+Esce dal debugger.
+Si veda la voce @samp{quit}, address@hidden avanti in quest'elenco.
+
address@hidden comando del debugger, @code{h} (alias per @code{help})
address@hidden comando del debugger, @code{help}
address@hidden @code{help}, comando del debugger
address@hidden @code{h}, comando del debugger (alias per @code{help})
address@hidden @code{help}
address@hidden @code{h}
+Stampa una lista di tutti i comandi del debugger di @command{gawk} con un breve
+sommario su come usarli. @samp{help @var{comando}} stampa l'informazione sul
+comando @var{comando}.
+
address@hidden comando del debugger, @code{l} (alias per @code{list})
address@hidden comando del debugger, @code{list}
address@hidden @code{list}, comando del debugger
address@hidden @code{l}, comando del debugger (alias per @code{list})
address@hidden @code{list} address@hidden | @code{+} | @var{n} |
@address@hidden:address@hidden | @address@hidden | @var{funzione}]
address@hidden @code{l} address@hidden | @code{+} | @var{n} |
@address@hidden:address@hidden | @address@hidden | @var{funzione}]
+Stampa le righe specificate (per default 15) dal file sorgente corrente
+o il file chiamato @var{nome-file}. I possibili argomenti di @code{list}
+sono i seguenti:
+
address@hidden nested table
address@hidden @asis
address@hidden @code{-} (Meno)
+Stampa righe prima delle ultime righe stampate.
+
address@hidden @code{+}
+Stampa righe dopo le ultime righe stampate.
address@hidden senza argomenti fa la stessa cosa.
+
address@hidden @var{n}
+Stampa righe centrate attorno alla riga numero @var{n}.
+
address@hidden @address@hidden
+Stampa righe dalla numero @var{n} alla numero @var{m}.
+
address@hidden @address@hidden:address@hidden
+Stampa righe centrate attorno alla riga numero @var{n} nel file sorgente
address@hidden Questo comando address@hidden cambiare il file sorgente corrente.
+
address@hidden @var{funzione}
+Stampa righe centrate attorno all'inizio della funzione @var{function}.
+Questo comando address@hidden cambiare il file sorgente corrente.
address@hidden table
+
address@hidden comando del debugger, @code{q} (alias per @code{quit})
address@hidden comando del debugger, @code{quit}
address@hidden @code{quit}, comando del debugger
address@hidden @code{q}, comando del debugger (alias per @code{quit})
address@hidden uscire dal debugger
address@hidden debugger, uscire dal
address@hidden @code{quit}
address@hidden @code{q}
+Esce dal debugger. Fare il debug @`e divertente, ma noi tutti a volte
+dobbiamo far fronte ad altri impegni nella vita, e talvolta troviamo il bug
+e possiamo tranquillamente passare a quello successivo! Come abbiamo visto
+prima, se si sta eseguendo un programma, il debugger avverte quando si batte
address@hidden o @samp{quit}, in modo da essere sicuri di voler realmente
abbandonare
+il debug.
+
address@hidden comando del debugger, @code{trace}
address@hidden @code{trace}, comando del debugger
address@hidden @code{trace} address@hidden | @code{off}]
+Abilita o disabilita la stampa continua delle istruzioni che si stanno per
+eseguire, assieme alle righe di @command{awk} che implementano.
+L'impostazione di default @`e @code{off}.
+
address@hidden auspicabile che la maggior parte dei ``codici operativi'' (o
``opcode'')
+in queste istruzioni siano sufficientemente autoesplicativi, e l'uso di
address@hidden e @code{nexti} mentre @code{trace} @`e abilitato li
address@hidden
+familiari.
+
address@hidden table
+
address@hidden Supporto per Readline
address@hidden Supporto per Readline
address@hidden completamento dei comandi nel debugger
address@hidden espansione della cronologia, nel debugger
address@hidden debugger, completamento dei comandi nel
+
+Se @command{gawk} @`e compilato con
address@hidden://cnswww.cns.cwru.edu/php/chet/readline/readline.html, la
libreria
+GNU Readline}, ci si address@hidden avvantaggiare delle sue address@hidden
riguardanti il
+completamento dei comandi della libreria e l'espansione della cronologia. Sono
+disponibili i seguenti tipi di completamento:
+
address@hidden @asis
address@hidden Completamentto dei comandi
+Nomi dei comandi.
+
address@hidden Completamento del @value{FN} del sorgente
address@hidden dei sorgenti. I relativi comandi sono
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden Completamento di argomento
+Argomenti di un comando non numerici.
+I relativi comandi sono @code{enable} e @code{info}.
+
address@hidden Completamento del nome di variabile
+Interessa i nomi delle variabili globali, e gli argomenti di funzione nel
+contesto corrente se
+il programma @`e in esecuzione. I relativi comandi sono
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden table
+
address@hidden Limitazioni
address@hidden Limitazioni
+
+Si spera che il lettore trovi il debugger di @command{gawk} utile e piacevole
+da usare, ma come accade per ogni programma, specialmente nelle sue prime
+versioni, ha ancora delle limitazioni. Quelle di cui @`e bene essere al
corrente sono:
+
address@hidden @value{BULLET}
address@hidden
+Nella versione presente, il debugger non address@hidden una spiegazione
dettagliata
+dell'errore che
+si @`e commesso quando si immette qualcosa che il debugger ritiene sbagliato.
+La risposta invece @`e solamente @samp{syntax error}. Quando si arriva a
capire
+l'errore commesso, tuttavia, ci si address@hidden come un vero guru.
+
address@hidden
address@hidden NOTE: no comma after the ref{} on purpose, due to following
address@hidden parenthetical remark.
+Se si studiano i ``dump'' dei codici operativi
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden vari del debugger}
+(o se si ha address@hidden address@hidden con i comandi interni di
@command{gawk}),
+ci si address@hidden conto che gran parte della manipolaziona interna di dati
+in @command{gawk}, address@hidden@dotless{i}} come in molti interpreti, @`e
fatta su di una pila.
address@hidden, @code{Op_pop}, e simili sono il pane quotidiano di
+gran parte del codice di @command{gawk}.
+
+Sfortunatamente, al momento, il debugger di @command{gawk} non consente
+di esaminare i contenuti della pila.
address@hidden, i risultati intermedi della valutazione delle espressioni sono
sulla
+pila, ma non @`e possibile stamparli. Invece, possono essere stampate solo
+quelle variabili che sono state definite nel programma. Naturalmente, un
+espediente per cercare di rimediare @`e di usare address@hidden variabili
esplicite in
+fase di debug e
+poi cambiarle di nuovo per ottenere un codice forse address@hidden difficile da
+comprendere, ma address@hidden ottimizzato.
+
address@hidden
+Non c'@`e alcun modo per guardare ``dentro'' al processo della compilazione
delle
+espressioni regolari per vedere se corrispondono a quel che si intendeva.
+Come programmatore
+di @command{awk}, ci si aspetta che chi legge conosca il significato di
address@hidden/[^[:alnum:][:blank:]]/}.
+
address@hidden
+Il debugger di @command{gawk} @`e progettato per essere usato eseguendo un
+programma (con tutti i suoi parametri) dalla riga di comando, come descritto
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden del debugger}. Non c'@`e alcun modo (al momento) di modificare
+o di ``entrare dentro'' l'esecuzione di un programma.
+Questo sembra ragionevole per un linguaggio che @`e usato principalmente per
+eseguire programmi piccoli e che non richiedono molto tempo di esecuzione.
+
address@hidden
+Il debugger di @command{gawk} accetta solo codice sorgente fornito con
+l'opzione @option{-f}.
address@hidden itemize
+
address@hidden
address@hidden 11/2016: This no longer applies after all the type cleanup work
that's been done.
+C'@`e un altro punto che vale la pena di trattare. I debugger convenzionali
+vengono eseguiti in un processo (e quindi in una parte di memoria)
+separato dal programma su cui eseguono il debug (il @dfn{debuggato}, se
+si vuole).
+
+Il debugger di @command{gawk} @`e diverso; @`e parte integrante di
@command{gawk}.
address@hidden rende possibile, in rari casi, che @command{gawk} diventi un
eccellente
+dimostratore del principio d'indeterminazione di Heisenberg, secondo il quale
+il solo atto di osservare una cosa address@hidden modificarla. Si consideri il
seguente
+esempio:@footnote{Grazie a Hermann Peifer per quest'esempio.}
+
address@hidden
+$ @kbd{cat test.awk}
address@hidden @{ print typeof($1), typeof($2) @}
+$ @kbd{cat test.data}
address@hidden abc 123
+$ @kbd{gawk -f test.awk test.data}
address@hidden strnum strnum
address@hidden example
+
+Questo @`e quel che ci si aspetta: il campo data ha l'attributo STRNUM
+(@pxref{Tipi di variabile}). Ora vediamo cosa accade quando questo programma
+viene eseguito sotto il debugger:
+
address@hidden
+$ @kbd{gawk -D -f test.awk test.data}
+gawk> @kbd{w $1} @ii{Imposta un punto d'osservazione su} $1
address@hidden Watchpoint 1: $1
+gawk> @kbd{w $2} @ii{Imposta il punto d'osservazione su} $2
address@hidden Watchpoint 2: $2
+gawk> @kbd{r} @ii{Avvia il programma}
address@hidden Partenza del programma:
address@hidden Mi fermo in Rule ...
address@hidden Watchpoint 1: $1 @ii{Scatta punto d'osservazione}
address@hidden Old value: ""
address@hidden New value: "abc"
address@hidden main() a `test.awk':1
address@hidden 1 @{ print typeof($1), typeof($2) @}
+gawk> @kbd{n} @ii{Prosegui @dots{}}
address@hidden Watchpoint 2: $2 @ii{Scatta punto d'osservazione}
address@hidden Old value: ""
address@hidden New value: "123"
address@hidden main() a `test.awk':1
address@hidden 1 @{ print typeof($1), typeof($2) @}
+gawk> @kbd{n} @ii{Prende il risultato da} typeof()
address@hidden strnum number @ii{Il risultato per} $2 @ii{non @`e
corretto}
address@hidden "normally" o "abnormally" @`e in inglese senza address@hidden di
modifiche.
address@hidden Programma completato normally, valore in uscita: 0
+gawk> @kbd{quit}
address@hidden example
+
+In questo caso, la richiesta di confrontare il nuovo valore di @code{$2}
+con quello vecchio ha richiesto che @command{gawk} lo valutasse e
+stabilisse che era proprio un numero, e questo @`e riflesso nel risultato di
address@hidden()}.
+
+Casi come questi in cui il debugger non @`e trasparente rispetto all'esecuzione
+del programma dovrebbero essere rari. Nel caso che se ne trovi uno, si
+prega di segnalarlo (@pxref{Bug}).
address@hidden ignore
+
address@hidden
+Look forward to a future release when these and other missing features may
+be added, and of course feel free to try to add them yourself!
address@hidden ignore
+
address@hidden Sommario sul debug
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Raramente i programmi funzionano bene al primo colpo. Trovare gli errori
+che contengono
+viene chiamato @dfn{debugging}, e un programma che aiuta a trovarli @`e un
address@hidden @command{gawk} ha un debugger incorporato che funziona in
+modo molto simile al debugger GNU, GDB.
+
address@hidden
+I debugger possono eseguire il programma un'istruzione per volta, esaminare e
+cambiare i
+valori delle variabili e dei vettori, e fanno tante altre cose per
+permettere di comprendere cosa sta facendo effettivamente il programma in un
+dato momento (a differenza del comportamento atteso).
+
address@hidden
+Come la maggior parte dei debugger, il debugger di @command{gawk} funziona in
+termini di stack frame, e si possono inserire sia punti d'interruzione
+(interruzioni a un certo punto del codice) sia punti d'osservazione
+(interruzioni quando il valore di un dato cambia).
+
address@hidden
+La serie di comandi del debugger @`e abbastanza completa, e permette di
+monitorare i
+punti d'interruzione, l'esecuzione, la visualizzazione e la
+modifica dei dati, di lavorare con le pile, ottenere informazioni, e di
+svolgere altri compiti.
+
address@hidden
+Se la libreria GNU Readline @`e disponibile al momento della compilazione di
address@hidden, viene usata dal debugger per fornire la cronologia della riga
+di comando e delle modifiche apportate durante il debug.
+
address@hidden
+Normalmente, il debugger non influenza il programma che sta controllando,
+ma questo address@hidden succedere occasionalmente.
+
address@hidden itemize
+
address@hidden Calcolo con precisione arbitraria
address@hidden Calcolo con precisione arbitraria con @command{gawk}
address@hidden precisione arbitraria
address@hidden precisione multipla
address@hidden precisione infinita
address@hidden virgola mobile, numeri address@hidden precisione arbitraria
+
+In questo @value{CHAPTER} si introducono alcuni concetti base su come i
+computer
+eseguono i calcoli e si definiscono alcuni termini importanti.
+Si continua poi descrivendo il calcolo in virgola mobile,
+che @`e quello che @command{awk} usa per tutte le sue operazioni aritmetiche,
+e si prosegue con
+una trattazione del calcolo in virgola mobile con precisione arbitraria,
+una address@hidden disponibile solo in @command{gawk}. Si passa poi a
+illustrare i numeri interi a precisione arbitraria e si conclude con una
+descrizione di alcuni punti sui quali @command{gawk} e lo standard POSIX non
+sono esattamente in accordo.
+
address@hidden NOTA
+La maggior parte degli utenti di @command{gawk} address@hidden saltare senza
patemi
+d'animo
+questo capitolo. Tuttavia, se si vogliono eseguire calcoli scientifici con
address@hidden, questo @`e il luogo adatto per imparare a farlo.
address@hidden quotation
+
address@hidden
+* Aritmetica del computer:: Una rapida introduzione alla matematica del
+ computer.
+* Definizioni matematiche:: Definizione dei termini usati.
+* address@hidden MPFR:: address@hidden MPFR in @command{gawk}.
+* Cautela col calcolo in VM:: Cose da sapere.
+* Interi a precisione arbitraria:: Calcolo con numeri interi a precisione
+ arbitraria con @command{gawk}.
+* Problemi virgola mobile POSIX:: Confronto tra standard e uso corrente.
+* Sommario virgola mobile:: Sommario della trattazione della
+ virgola mobile.
address@hidden menu
+
address@hidden Aritmetica del computer
address@hidden Una descrizione generale dell'aritmetica del computer
+
+Sinora, abbiamo avuto a che fare con dati come numeri o stringhe. Ultimamente,
+comunque, i computer rappresentano ogni cosa in termini di @dfn{cifre binarie},
+o @dfn{bit}. Una cifra decimale address@hidden assumere uno di 10 valori: da
zero a
+nove. Una cifra binaria address@hidden assumere uno di due valori: zero o
uno. Usando
+il sistema binario, i computer (e i programmi per computer) possono
+rappresentare e manipolare dati numerici e dati costituiti da caratteri. In
+generale, tanti address@hidden bit @`e possibile usare per rappresentare una
determinata
+cosa, tanto maggiore address@hidden l'intervallo dei possibili valori che essa
address@hidden
+assumere.
+
+I moderni calcolatori possono eseguire calcoli numerici in almeno due modi, e
+spesso anche di address@hidden Ogni tipo di calcolo usa una diversa
rappresentazione
+(organizzazione dei bit) dei numeri. Le address@hidden di calcolo che ci
interessano
+sono:
+
address@hidden @asis
address@hidden Calcolo decimale
+Questo @`e il tipo di calcolo che s'impara alle scuole elementari, usando
+carta e penna (o anche una calcolatrice). In teoria, i numeri possono avere un
+numero arbitrario di cifre su ambo i lati del separatore decimale, e il
+risultato di un'operazione @`e sempre esatto.
+
+Alcuni sistemi moderni possono eseguire calcoli decimali direttamente,
+tramite apposite istruzioni disponibili
+nell'hardware dell'elaboratore, ma normalmente si ha address@hidden di una
speciale
+libreria software che consenta di effettuare le operazioni desiderate.
+Ci sono anche librerie che svolgono i calcoli decimali interamente
+per via software.
+
+Anche se alcuni utenti si aspettano che @command{gawk} effettui delle
+operazioni usando numeri in base decimale,@footnote{Non sappiamo perch@'e se
+lo aspettino, ma @`e address@hidden@dotless{i}}.} non @`e questo quello che
succede.
+
address@hidden La matematica coi numeri interi
+A scuola ci hanno insegnato che i valori interi erano quei numeri privi di una
+parte frazionaria, come 1, 42, o @minus{}17.
+Il vantaggio dei numeri interi @`e che essi rappresentano dei valori in maniera
+esatta. Lo svantaggio @`e che i numeri rappresentabili sono limitati.
+
address@hidden senza segno, interi
address@hidden segno, interi senza
address@hidden interi senza segno
+Nei calcolatori, i valori interi sono di due tipi: @dfn{con segno} e
address@hidden segno}. I valori con segno possono essere negativi o positivi,
+mentre i valori senza segno sono sempre maggiori o uguali a zero.
+
+Nei sistemi informatici, il calcolo con valori interi @`e esatto, ma il
possibile
+campo di variazione dei valori @`e limitato. L'elaborazione con numeri interi
@`e
address@hidden veloce di quella con numeri a virgola mobile.
+
address@hidden La matematica coi numeri a virgola mobile
+I numeri a virgola mobile rappresentano quelli che a scuola sono chiamati
+numeri ``reali'' (address@hidden, quelli che hanno una parte frazionaria, come
+3.1415927). Il vantaggio dei numeri a virgola mobile @`e che essi possono
+rappresentare uno spettro di valori molto address@hidden ampio di quello
rappresentato dai
+numeri interi. Lo svantaggio @`e che ci sono numeri che essi non possono
+rappresentare in modo esatto.
+
+I computer moderni possono eseguire calcoli su valori a virgola mobile
+nell'hardware dell'elaboratore, entro un intervallo di valori limitato.
+Ci sono inoltre librerie di programmi che consentono calcoli, usando numeri a
+virgola mobile, di precisione arbitraria.
+
+POSIX @command{awk} usa numeri a virgola mobile a @dfn{doppia precisione},
+che possono gestire address@hidden cifre rispetto ai numeri a virgola mobile a
address@hidden precisione}. @command{gawk} ha inoltre address@hidden, descritte
+in dettaglio address@hidden sotto, che lo mettono in grado di eseguire
+calcoli con i numeri a virgola mobile con precisione arbitraria.
address@hidden table
+
+I calcolatori operano con valori interi e a virgola mobile su diversi
+intervalli. I valori interi normalmente hanno una dimensione di 32 bit o 64
bit.
+I valori a virgola mobile a singola precisione occupano 32 bit, mentre i
+valori a virgola mobile a doppia precisione occupano 64 bit. I valori a
+virgola mobile sono sempre con segno. Il possibile campo di variazione dei
+valori @`e mostrato in @ref{table-numeric-ranges}.
+
address@hidden Tabella,table-numeric-ranges
address@hidden dei valori per diverse rappresentazioni numeriche}
address@hidden @columnfractions .34 .33 .33
address@hidden Rappresentazione numerica @tab Valore minimo @tab Valore massimo
address@hidden Interi con segno a 32-bit @tab @minus{}2.147.483.648 @tab
2.147.483.647
address@hidden Interi senza segno a 32-bit @tab 0 @tab 4.294.967.295
address@hidden Interi con segno a 64-bit @tab @minus{}9.223.372.036.854.775.808
@tab 9.223.372.036.854.775.807
address@hidden Interi senza segno a 64-bit @tab 0 @tab
18.446.744.073.709.551.615
address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab
@math{1,175494^{-38}} @tab @math{3,402823^{38}}
address@hidden Virgola mobile, doppia precisione (circa) @tab
@math{2,225074^{-308}} @tab @math{1,797693^{308}}
address@hidden iftex
address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab 1,175494e-38
@tab 3,402823e38
address@hidden Virgola mobile, doppia precisione (circa) @tab 2,225074e-308
@tab 1,797693e308
address@hidden ifinfo
address@hidden
address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab 1,address@hidden
@tab 3,address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab 2,address@hidden
@tab 1,address@hidden
address@hidden ifnotinfo
address@hidden ifnottex
address@hidden multitable
address@hidden float
+
address@hidden Definizioni matematiche
address@hidden Altre cose da sapere
+
+Il resto di questo @value{CHAPTER} usa un certo numero di termini. Di seguito
+vengono date alcune definizioni informali che dovrebbero essere utili
+per la lettura di questo documento:
+
address@hidden @dfn
address@hidden Accuratezza
+L'accuratezza del calcolo sui numeri a virgola mobile indica di quanto si
+avvicina il calcolo al valore reale (calcolato con carta e penna).
+
address@hidden Errore
+La differenza tra quello che il risultato di un calcolo ``dovrebbe dare''
+e quello che effettivamente address@hidden @`E meglio minimizzare l'errore
quanto address@hidden
+possibile.
+
address@hidden Esponente
+L'ordine di grandezza di un valore;
+alcuni bit in un valore a virgola mobile contengono l'esponente.
+
address@hidden Inf
+Un valore speciale che rappresenta l'infinito. Le operazioni tra un qualsiasi
+numero e l'infinito danno infinito.
+
address@hidden Mantissa
+Un valore a virgola mobile @`e formato dalla mantissa moltiplicata per 10
+alla potenza dell'esponente. Per esempio, in @code{1,2345e67},
+la mantissa @`e @code{1,2345}.
+
address@hidden address@hidden di arrotondamento
+Come i numeri vanno arrotondati, per eccesso o per difetto, quando necessario.
+Maggiori dettagli verranno forniti in seguito.
+
address@hidden NaN
+``Not a number'' (Non un Numero)address@hidden a Michael
+Brennan per questa descrizione, che abbiamo parafrasato, e per gli esempi.} Un
+valore speciale che risulta da un calcolo che non ha risposta come numero
+reale. In tal caso, i programmi possono o ricevere un'eccezione di virgola
+mobile, o restituire @code{NaN} come risultato. Lo standard IEEE 754
+consiglia che i sistemi restituiscano @code{NaN}. Alcuni esempi:
+
address@hidden @code
address@hidden sqrt(-1)
+La radice quadrata di @minus{}1 ha senso nell'insieme dei numeri complessi,
+ma non nell'insieme dei numeri reali,
+per cui il risultato @`e @code{NaN}.
+
address@hidden log(-8)
+Il logaritmo di @minus{}8 @`e fuori dal dominio di @code{log()},
+per cui il risultato @`e @code{NaN}.
address@hidden table
+
address@hidden Normalizzato (formato)
+Come la mantissa (vedi oltre in questa lista) @`e usualmente memorizzata. Il
+valore viene aggiustato in modo che il primo bit sia sempre uno,
+e in questo modo l'uno iniziale @`e supposto presente (per come viene
+generato il numero), ma non @`e memorizzato fisicamente.
+Questo fornisce un bit di precisione in address@hidden
+
address@hidden Precisione
+Il numero di bit usati per rappresentare un numero a virgola mobile.
address@hidden sono i bit, e maggiore @`e l'intervallo di cifre che si possono
+rappresentare.
+Le precisioni binaria e decimale sono legate in modo approssimativo, secondo
+la formula:
+
address@hidden
address@hidden
address@hidden = 3.322 @cdot dps}
address@hidden iftex
address@hidden
address@hidden
address@hidden = 3.322 * @var{dps}
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>prec</emphasis> = 3.322 ⋅ <emphasis>dps</emphasis>
address@hidden docbook
address@hidden display
+
address@hidden
+Qui, @emph{prec} indica la precisione binaria
+(misurata in bit) e @emph{dps} (abbreviazione di "decimal places")
+indica le cifre decimali.
+
address@hidden address@hidden
address@hidden://en.wikipedia.org/wiki/Numerical_stability,
+l'articolo di Wikipedia sulla address@hidden numerica}:
+``I calcoli per i quali si address@hidden dimostrare che non amplificano gli
errori di
+approssimazione sono chiamati @dfn{numericamente stabili}.''
address@hidden table
+
+Si veda @uref{http://en.wikipedia.org/wiki/Accuracy_and_precision,
+l'articolo di Wikipedia su accuratezza e precisione} per maggiori informazioni
+su questi due termini.
+
+Sui computer moderni, l'address@hidden di calcolo in virgola mobile usa la
+rappresentazione e le operazioni definite dallo standard IEEE 754.
+Tre dei tipi definiti nello standard IEEE 754 sono:
+32-bit singola precisione,
+64-bit doppia precisione e
+128-bit quadrupla precisione.
+Lo standard specifica anche formati a precisione estesa
+per consentire una maggiore precisione e campi di variazione degli esponenti
address@hidden ampi. (@command{awk} usa solo il formato a 64-bit doppia
precisione.)
+
address@hidden elenca la precisione e i valori di campo
+dell'esponente per i principali formati binari IEEE 754.
+
address@hidden Tabella,table-ieee-formats
address@hidden per i principali formati IEEE}
address@hidden @columnfractions .20 .20 .20 .20 .20
address@hidden Nome @tab Bit totali @tab Precisione @tab Esponente minimo @tab
Esponente massimo
address@hidden Singola @tab 32 @tab 24 @tab @minus{}126 @tab +127
address@hidden Doppia @tab 64 @tab 53 @tab @minus{}1022 @tab +1023
address@hidden Quadrupla @tab 128 @tab 113 @tab @minus{}16382 @tab +16383
address@hidden multitable
address@hidden float
+
address@hidden NOTA
+I numeri che descrivono la precisione includono la cifra 1 iniziale
+implicita, il che equivale ad avere un bit in address@hidden nella mantissa.
address@hidden quotation
+
address@hidden address@hidden MPFR
address@hidden address@hidden per il calcolo a precisione arbitraria in
@command{gawk}
+
+Per default, @command{gawk} usa i valori in virgola mobile a doppia precisione
+disponibili nell'hardware del sistema su cui viene eseguito.
+Tuttavia, se @`e stato compilato in modo da includere questa address@hidden
+ed @`e stata specificata
+l'opzione da riga di comando @option{-M}, @command{gawk} usa le librerie
address@hidden://www.mpfr.org, GNU MPFR} e @uref{http://gmplib.org, GNU MP}
(GMP)
+per effettuare calcoli sui numeri con una precisione arbitraria.
+Si address@hidden verificare se il supporto a MPFR @`e disponibile in questo
modo:
+
address@hidden
+$ @kbd{gawk --version}
address@hidden GNU Awk 4.1.2, API: 1.1 (GNU MPFR 3.1.0-p3, GNU MP 5.0.2)
address@hidden Copyright (C) 1989, 1991-2015 Free Software Foundation.
address@hidden
address@hidden example
+
address@hidden
+(I numeri di versione visualizzati possono essere diversi. Non importa;
+l'importante @`e che siano presenti GNU MPFR e GNU MP
+nel testo restituito.)
+
+Inoltre, ci sono alcuni elementi disponibili nel vettore @code{PROCINFO}
+per fornire informazioni sulle librerie MPFR e GMP
+(@pxref{Variabili auto-assegnate}).
+
+La libreria MPFR address@hidden un controllo accurato sulle precisioni e sulle
address@hidden di
+arrotondamento, e address@hidden risultati correttamente arrotondati,
riproducibili e
+indipendenti dalla piattaforma. Con l'opzione da riga di comando @option{-M},
+tutti gli operatori aritmetici e le funzioni in virgola mobile possono
+produrre risultati a ogni livello di precisione supportato da MPFR.
+
+Due variabili predefinite, @code{PREC} e @code{ROUNDMODE},
+danno il controllo sulla precisione di elaborazione e sulla address@hidden di
+arrotondamento. La precisione e la address@hidden di arrotondamento sono
impostate
+a livello globale per ogni operazione da eseguire.
address@hidden la precisione} e
address@hidden
+la
address@hidden iftex
address@hidden modi di arrotondare}
+per maggiori informazioni.
+
address@hidden Cautela col calcolo in VM
address@hidden Calcolo in virgola mobile: @dfn{Caveat Emptor}!
+
address@hidden
address@hidden'ora di matematica @`e ostica!}
address@hidden Teen Talk Barbie, luglio 1992
address@hidden quotation
+
+Questa @value{SECTION} fornisce un quadro dettagliato dei problemi che
+si presentano quando si eseguono molti calcoli in virgola
address@hidden'@`e un saggio molto bello
address@hidden://www.validlab.com/goldberg/paper.pdf, sul calcolo in
+virgola mobile} di David Goldberg, ``What Every Computer Scientist Should Know
+About Floating-Point Arithmetic,''
address@hidden Computing Surveys} @strong{23}, 1 (1991-03): 5-48. Vale la pena
di
+leggerlo, se si @`e interessati a scendere nei dettagli, address@hidden
richiede delle
+conoscenze informatiche.}
+Le spiegazioni fornite valgono sia per il calcolo in virgola mobile
+effettuato direttamente dall'hardware del computer, sia per quello
+ottenuto tramite il software per la precisione arbitraria.
+
address@hidden ATTENZIONE
+Le informazioni fornite in questa sede sono deliberatamente di tipo generale.
+Se si devono eseguire calcoli complessi col computer, si dovrebbero prima
+ottenere ulteriori informazioni, e non basarsi solo su quanto qui detto.
address@hidden quotation
+
address@hidden
+* Inesattezza nei calcoli:: La matematica in virgola mobile non @`e
+ esatta.
+* Ottenere la precisione:: Ottenere address@hidden precisione richiede
qualche
+ sforzo.
+* Tentare di arrotondare:: Aggiungere cifre di precisione e arrotondare.
+* Impostare la precisione:: Come impostare la precisione.
+* Impostare modi di arrotondare:: Impostare le address@hidden di
arrotondamento.
address@hidden menu
+
address@hidden Inesattezza nei calcoli
address@hidden La matematica in virgola mobile non @`e esatta
+
+Le rappresentazioni e i calcoli con numeri a virgola mobile binari sono
+inesatti. Semplici valori come 0,1 non possono essere rappresentati in modo
+preciso usando numeri a virgola mobile binari, e la limitata precisione dei
+numeri a virgola mobile significa che piccoli cambiamenti nell'ordine delle
+operazioni o la precisione di memorizzazione di operazioni
+intermedie address@hidden cambiare il
+risultato. Per rendere la situazione address@hidden difficile, nel calcolo in
virgola
+mobile con precisione arbitraria, si address@hidden impostare la precisione
prima di
+eseguire un calcolo, address@hidden non si address@hidden sapere con certezza
quale address@hidden
+il numero di cifre decimali esatte nel risultato finale.
+
address@hidden
+* Rappresentazioni inesatte:: I numeri non sono rappresentati esattamente.
+* Confronti tra valori in VM:: Come confrontare valori in virgola mobile.
+* Gli errori si sommano:: Gli errori diventano sempre maggiori.
address@hidden menu
+
address@hidden Rappresentazioni inesatte
address@hidden Molti numeri non possono essere rappresentati esattamente
+
address@hidden, prima di iniziare a scrivere del codice, si dovrebbe pensare
+al risultato che si vuole effettivamente ottenere e a cosa realmente accade.
+Si considerino i due numeri nel seguente esempio:
+
address@hidden
+x = 0.875 # 1/2 + 1/4 + 1/8
+y = 0.425
address@hidden example
+
+Diversamente dal numero in @code{y}, il numero memorizzato in @code{x}
address@hidden rappresentabile esattamente nel formato binario, perch@'e
address@hidden essere
+scritto come somma finita di una o address@hidden frazioni i cui denominatori
sono tutti
+multipli di due.
+Quando @command{gawk} legge un numero a virgola mobile dal sorgente di un
+programma, arrotonda automaticamente quel numero alla precisione, quale che
+sia, supportata dal computer in uso. Se si tenta di stampare il contenuto
+numerico di una variabile usando una stringa di formato in uscita di
address@hidden"%.17g"}, il valore restituito address@hidden non essere lo
stesso numero assegnato
+a quella variabile:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ x = 0.875; y = 0.425}
+> @kbd{ printf("%0.17g, %0.17g\n", x, y) @}'}
address@hidden 0.875, 0.42499999999999999
address@hidden example
+
+Spesso l'errore @`e talmente piccolo da non essere neppure notato, e se @`e
stato
+notato, si address@hidden sempre specificare il grado di precisione si vuole
nell'output.
+In genere questo @`e una stringa di formato come @code{"%.15g"} che, se usata
+nell'esempio precedente, address@hidden luogo a un output identico all'input.
+
address@hidden Confronti tra valori in VM
address@hidden Fare attenzione quando si confrontano valori
+
+Poich@'e la rappresentazione interna del computer
address@hidden discostarsi, sia pur di poco, dal valore
+esatto, confrontare dei valori a virgola mobile per vedere se sono esattamente
+uguali @`e generalmente una pessima idea. Questo @`e un esempio in cui tale
+confronto non funziona come dovrebbe:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print (0.1 + 12.2 == 12.3) @}'}
address@hidden 0
address@hidden example
+
+Il metodo generalmente seguito per confrontare valori a virgola mobile
+consiste nel controllare se la differenza tra loro @`e minore di un certo
valore
+(chiamato @dfn{delta}, o @dfn{tolleranza}). Quel che si deve decidere @`e qual
address@hidden il valore minimo di delta
+adeguato. Il codice per far address@hidden @`e qualcosa del genere:
+
address@hidden
+delta = 0.00001 # per esempio
+differenza = abs(a) - abs(b) # sottrazione dei due valori
+if (differenza < delta)
+ # va bene
+else
+ # non va bene
address@hidden example
+
address@hidden
+(Si presuppone che sia stata definita in qualche parte del programma una
+semplice funzione che restituisce il valore assoluto di un numero,
+chiamata @code{abs()}.)
+
address@hidden Gli errori si sommano
address@hidden Gli errori diventano sempre maggiori
+
+La perdita di accuratezza in un singolo calcolo con numeri a virgola mobile
+generalmente non dovrebbe destare preoccupazione. Tuttavia, se si calcola un
+valore che @`e una sequenza di operazioni in virgola mobile, l'errore si
address@hidden
+accumulare e influire sensibilmente sul risultato del calcolo stesso.
+Qui sotto vediamo un tentativo di calcolare il valore di @value{PI} usando
+una delle sue rappresentazioni
+come somma di una serie di numeri:
+
address@hidden
+BEGIN @{
+ x = 1.0 / sqrt(3.0)
+ n = 6
+ for (i = 1; i < 30; i++) @{
+ n = n * 2.0
+ x = (sqrt(x * x + 1) - 1) / x
+ printf("%.15f\n", n * x)
+ @}
address@hidden
address@hidden example
+
+Quando viene eseguito, gli errori iniziali si propagano nei calcoli
+successivi, facendo terminare il ciclo prematuramente dopo un tentativo di
+divisione per zero:
+
address@hidden
+$ @kbd{gawk -f pi.awk}
address@hidden 3.215390309173475
address@hidden 3.159659942097510
address@hidden 3.146086215131467
address@hidden 3.142714599645573
address@hidden
address@hidden 3.224515243534819
address@hidden 2.791117213058638
address@hidden 0.000000000000000
address@hidden gawk: pi.awk:6: fatale: tentativo di dividere per zero
address@hidden example
+
+Ecco un altro esempio in cui l'inaccuratezza nelle rappresentazioni interne
+porta a un risultato inatteso:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{for (d = 1.1; d <= 1.5; d += 0.1) # esegue il ciclo cinque volte (?)}
+> @kbd{i++}
+> @kbd{print i}
+> @address@hidden'}
address@hidden 4
address@hidden example
+
address@hidden Ottenere la precisione
address@hidden Ottenere la precisione voluta
+
address@hidden il calcolo con precisione arbitraria dare risultati esatti? Non
ci sono
+risposte facili. Le regole standard dell'algebra spesso non valgono
+nei calcoli con precisione arbitraria.
+Tra le altre cose, le leggi distributiva e associativa non sono rispettate
+completamente, e l'ordine dell'operazione address@hidden essere importante per
+il calcolo.
+Errori di arrotondamento, perdite di precisione che si accumulano, e
+valori molto vicini allo zero sono spesso causa di problemi.
+
+Quando @command{gawk} verifica l'eguaglianza delle espressioni
address@hidden + 12.2} e @samp{12.3} usando l'aritmetica a doppia precisione
della
+macchina, decide che non sono uguali! (@xref{Confronti tra valori in VM}.)
+Si address@hidden ottenere il risultato cercato aumentando la precisione; 56
bit in
+questo caso sono sufficienti:
+
address@hidden
+$ @kbd{gawk -M -v PREC=56 'BEGIN @{ print (0.1 + 12.2 == 12.3) @}'}
address@hidden 1
address@hidden example
+
+Se aggiungere address@hidden bit @`e una buona cosa, aggiungerne ancora di
address@hidden
address@hidden meglio?
+Ecco cosa succede se si usa un valore di @code{PREC} ancora address@hidden
alto:
+
address@hidden
+$ @kbd{gawk -M -v PREC=201 'BEGIN @{ print (0.1 + 12.2 == 12.3) @}'}
address@hidden 0
address@hidden example
+
+Non @`e un bug di @command{gawk} o della libreria MPFR.
address@hidden facile dimenticare che il numero finito di bit usato per
memorizzare il
+valore spesso @`e solo un'approssimazione dopo un opportuno arrotondamento. Il
+test di uguaglianza riesce se e solo se @emph{tutti} i bit dei due operandi
+sono esattamente gli stessi. Poich@'e questo non @`e necessariamente vero dopo
un
+calcolo in virgola mobile con una determinata precisione e con una
address@hidden di
+arrotondamento valida, un test di eguaglianza convenzionale potrebbe non
+riuscire. Invece, il test riesce confrontando i due numeri per vedere se la
+differenza tra di loro rientra in un delta accettabile.
+
+In applicazioni dove sono sufficienti fino a 15 cifre decimali,
+il calcolo in doppia precisione eseguito dall'hardware del computer
address@hidden essere una buona soluzione,
+e in genere @`e address@hidden veloce. address@hidden bisogna tener presente
che ogni operazione in
+virgola mobile address@hidden subire un nuovo errore di arrotondamento con
conseguenze
+catastrofiche, come si @`e visto nel precedente tentativo di calcolare il
valore
+di @value{PI}.
+In tali casi una precisione supplementare address@hidden aumentare la
address@hidden e
+l'accuratezza del calcolo.
+
+Oltre a address@hidden, bisogna tenere conto del fatto che
+addizioni ripetute non sono necessariamente equivalenti a una moltiplicazione
+nell'aritmetica in virgola mobile. Nell'esempio visto in
address@hidden errori si sommano}:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{for (d = 1.1; d <= 1.5; d += 0.1) # ciclo eseguito cinque volte (?)}
+> @kbd{i++}
+> @kbd{print i}
+> @address@hidden'}
address@hidden 4
address@hidden example
+
address@hidden
+non @`e detto che, scegliendo per @code{PREC} un valore arbitrariamente alto,
si
+riesca a ottenere il risultato corretto. La riformulazione del problema in
+questione @`e spesso il modo corretto di comportari in tali situazioni.
+
address@hidden Tentare di arrotondare
address@hidden Tentare di aggiungere bit di precisione e arrotondare
+
+Invece dell'aritmetica in virgola mobile con precisione arbitraria,
+spesso tutto address@hidden di cui si ha bisogno @`e un aggiustamento della
logica
+o di un diverso ordine delle operazioni nei calcoli.
+La address@hidden e l'accuratezza del calcolo di @value{PI}
+nel primo esempio possono essere migliorata usando la seguente semplice
+trasformazione algebrica:
+
address@hidden
+(sqrt(x * x + 1) - 1) / x @equiv{} x / (sqrt(x * x + 1) + 1)
address@hidden example
+
address@hidden
+Dopo aver fatto questo cambiamento, il programma converge verso
address@hidden in meno di 30 iterazioni:
+
address@hidden
+$ @kbd{gawk -f pi2.awk}
address@hidden 3.215390309173473
address@hidden 3.159659942097501
address@hidden 3.146086215131436
address@hidden 3.142714599645370
address@hidden 3.141873049979825
address@hidden
address@hidden 3.141592653589797
address@hidden 3.141592653589797
address@hidden example
+
address@hidden Impostare la precisione
address@hidden Impostare la precisione
+
address@hidden usa una precisione di lavoro a livello globale; non tiene
+traccia della precisione e accuratezza dei singoli numeri. Eseguendo
+un'operazione aritmetica o chiamando una funzione predefinita, il risultato
+viene arrotondato alla precisione di lavoro. La precisione di lavoro di default
address@hidden di 53 bit, modificabile usando la variabile predefinita
@code{PREC}. Si address@hidden
+anche impostare il valore a una delle stringhe predefinite (non importa se
+scritte in maiuscolo o minuscolo) elencate in
address@hidden,
+per emulare un formato binario che segue lo standard IEEE 754.
+
address@hidden Tabella,table-predefined-precision-strings
address@hidden di precisione predefinita per @code{PREC}}
address@hidden address@hidden"double"}} {12345678901234567890123456789012345}
address@hidden @code{PREC} @tab formato binario IEEE 754
address@hidden @code{"half"} @tab 16-bit mezza precisione
address@hidden @code{"single"} @tab 32-bit singole precisione di base
address@hidden @code{"double"} @tab 64-bit doppia precisione di base
address@hidden @code{"quad"} @tab 128-bit quadrupla precisione di base
address@hidden @code{"oct"} @tab 256-bit ottupla precisione
address@hidden multitable
address@hidden float
+
+Il seguente esempio illustra gli effetti del cambiamento di precisione
+sulle operazioni aritmetiche:
+
address@hidden
+$ @kbd{gawk -M -v PREC=100 'BEGIN @{ x = 1.0e-400; print x + 0}
+> @kbd{PREC = "double"; print x + 0 @}'}
address@hidden 1e-400
address@hidden 0
address@hidden example
+
address@hidden ATTENZIONE
+Diffidare delle costanti in virgola mobile! Quando si legge una costante in
+virgola mobile dal codice sorgente di un programma, @command{gawk} usa la
+precisione di default (quella del formato @code{double} di C), a meno che non
+venga richiesto, tramite la variabile speciale @code{PREC} fornita
+sulla riga di comando, di memorizzarla internamente come un numero MPFR.
+Cambiare la precisione tramite @code{PREC} nel testo del programma @emph{non}
+cambia la precisione di una costante.
+
+Se si deve rappresentare una costante in virgola mobile con una precisione
+maggiore di quella di default e non @`e possibile usare un assegnamento a
address@hidden da riga di comando, si dovrebbe definire la costante o come
+stringa, o come numero razionale, ove possibile. L'esempio seguente illustra le
+differenze tra i diversi modi di stampare una costante in virgola mobile:
+
address@hidden
+$ @kbd{gawk -M 'BEGIN @{ PREC = 113; printf("%0.25f\n", 0.1) @}'}
address@hidden 0.1000000000000000055511151
+$ @kbd{gawk -M -v PREC=113 'BEGIN @{ printf("%0.25f\n", 0.1) @}'}
address@hidden 0.1000000000000000000000000
+$ @kbd{gawk -M 'BEGIN @{ PREC = 113; printf("%0.25f\n", "0.1") @}'}
address@hidden 0.1000000000000000000000000
+$ @kbd{gawk -M 'BEGIN @{ PREC = 113; printf("%0.25f\n", 1/10) @}'}
address@hidden 0.1000000000000000000000000
address@hidden example
address@hidden quotation
+
address@hidden Impostare modi di arrotondare
address@hidden Impostare la address@hidden di arrotondamento
+
+La variabile @code{ROUNDMODE} permette di controllare a livello di programma
+la address@hidden di arrotondamento.
+La corrispondenza tra @code{ROUNDMODE} e le address@hidden di arrotondamento
IEEE
address@hidden mostrata in @ref{table-gawk-rounding-modes}.
+
address@hidden Tabella,table-gawk-rounding-modes
address@hidden@`a di arrotondamento in @command{gawk} }
address@hidden @columnfractions .45 .30 .25
address@hidden address@hidden di arrotondamento @tab Nome IEEE @tab
@code{ROUNDMODE}
address@hidden Arrotonda al address@hidden vicino, o a un numero pari @tab
@code{roundTiesToEven} @tab @code{"N"} o @code{"n"}
address@hidden Arrotonda verso infinito @tab @code{roundTowardPositive} @tab
@code{"U"} o @code{"u"}
address@hidden Arrotonda verso meno infinito @tab @code{roundTowardNegative}
@tab @code{"D"} o @code{"d"}
address@hidden Arrotonda verso zero (troncamento) @tab @code{roundTowardZero}
@tab @code{"Z"} o @code{"z"}
address@hidden Arrotonda al address@hidden vicino, o per eccesso @tab
@code{roundTiesToAway} @tab @code{"A"} o @code{"a"}
address@hidden multitable
address@hidden float
+
address@hidden ha @code{"N"} come valore di default, ovvero si usa la
address@hidden di arrotondamento IEEE 754 @code{roundTiesToEven}.
+In @ref{table-gawk-rounding-modes}, il valore @code{"A"} seleziona
address@hidden Questo @`e applicabile solo se la versione in uso
+della libreria MPFR lo supporta; altrimenti, l'impostazione di @code{ROUNDMODE}
+ad @code{"A"} non ha alcun effetto.
+
+La address@hidden di default @code{roundTiesToEven} @`e la address@hidden
preferita, ma allo
+stesso tempo
+la meno intuitiva. Questo metodo fa la cosa ovvia per la maggior parte dei
+valori, arrotondandoli per eccesso o per difetto alla cifra address@hidden
prossima.
+Per esempio, arrotondando 1.132 alle due cifre decimali si ottiene 1.13,
+e 1.157 viene arrotondato a 1.16.
+
+Tuttavia, se si deve arrotondare un valore posto esattamente a address@hidden
strada,
+le cose non funzionano come probabilmente si insegna a scuola.
+In questo caso, il numero @`e arrotondato alla cifra @emph{pari}
address@hidden prossima.
address@hidden@dotless{i}} arrotondando 0.125 alle due cifre si arrotonda per
difetto a 0.12,
+ma arrotondando 0.6875 alle tre cifre si arrotonda per eccesso a 0.688.
+Probabilmente ci si @`e address@hidden imbattuti in questa address@hidden di
arrotondamento
+usando @code{printf} per formattare numeri a virgola mobile.
+Per esempio:
+
address@hidden
+BEGIN @{
+ x = -4.5
+ for (i = 1; i < 10; i++) @{
+ x += 1.0
+ printf("%4.1f => %2.0f\n", x, x)
+ @}
address@hidden
address@hidden example
+
address@hidden
+produce il seguente output quando viene eseguito sul sistema
+dell'autore:@address@hidden possibile che l'output sia completamente diverso,
se la
+libreria C presente nel sistema in uso non si conforma, per @code{printf},
+alla regola IEEE 754
+di arrotondamento al valore pari in caso di equidistanza.}
+
address@hidden
+-3.5 => -4
+-2.5 => -2
+-1.5 => -2
+-0.5 => 0
+ 0.5 => 0
+ 1.5 => 2
+ 2.5 => 2
+ 3.5 => 4
+ 4.5 => 4
address@hidden example
+
+La teoria che sta dietro alla regola
address@hidden @`e che gli arrotondamenti di
+valori equidistanti in eccesso e in difetto si distribuiscono address@hidden o
meno
+uniformemente, con la possibile conseguenza che errori di arrotondamento
+ripetuti tendono ad annullarsi a vicenda. Questa @`e la address@hidden di
+arrotondamento di default per funzioni e operatori di calcolo secondo IEEE 754.
+
+Le altre address@hidden di arrotondamento sono usate raramente. Gli
arrotondamenti
+verso l'infinito (@code{roundTowardPositive}) e verso il meno infinito
+(@code{roundTowardNegative}) vengono spesso usati per eseguire calcoli su
+intervalli, dove si adotta questa address@hidden di arrotondamento per
calcolare
+i limiti superiore e inferiore per l'intervallo di valori in uscita.
+La address@hidden
address@hidden address@hidden essere usata per convertire numeri a virgola
mobile
+in numeri interi. La address@hidden di arrotondamento @code{roundTiesToAway}
+arrotonda il risultato al numero address@hidden vicino, e in caso di
equidistanza
+arrotonda per eccesso.
+
+Qualche esperto di analisi numerica address@hidden che la scelta dello stile di
+arrotondamento ha un grandissimo impatto sul risultato finale, e address@hidden
+di attendere sino al risultato finale dopo ogni arrotondamento. Invece,
+spesso si possono evitare problemi legati a errori di arrotondamento
+impostando all'inizio la precisione a un valore sufficientemente maggiore
+della precisione desiderata, in modo che il cumulo degli errori di
+arrotondamento non influisca sul
+risultato finale. Se si ha il dubbio che i risultati del calcolo contengano
+un'accumulazione di errori di arrotondamento, occorre, per accertare la cosa,
+controllare se si verifica una differenza significativa nell'output
+cambiando la address@hidden di arrotondamento.
+
address@hidden Interi a precisione arbitraria
address@hidden Aritmetica dei numeri interi a precisione arbitraria con
@command{gawk}
address@hidden numeri interi a precisione arbitraria
address@hidden interi a precisione arbitraria
address@hidden precisione arbitraria, interi a
+
+Quando viene specificata l'opzione @option{-M},
address@hidden esegue tutti i calcoli sui numeri interi usando gli interi a
+precisione arbitraria della libreria GMP. Qualsiasi numero che appaia come un
+intero in un sorgente o in un @value{DF} @`e memorizzato come intero a
precisione
+arbitraria. La dimensione del numero intero ha come limite solo la memoria
+disponibile. Per esempio, il seguente programma calcola
address@hidden
address@hidden,
address@hidden iftex
address@hidden
+5^4^3^2,
address@hidden ifinfo
address@hidden
address@hidden
address@hidden@address@hidden,
address@hidden ifnotinfo
address@hidden ifnottex
+il cui risultato @`e oltre i limiti degli ordinari valori a virgola mobile a
+doppia precisione dei processori:
+
address@hidden
+$ @kbd{gawk -M 'BEGIN @{}
+> @kbd{x = 5^4^3^2}
+> @kbd{print "numero di cifre =", length(x)}
+> @kbd{print substr(x, 1, 20), "...", substr(x, length(x) - 19, 20)}
+> @address@hidden'}
address@hidden numero di cifre = 183231
address@hidden 62060698786608744707 ... 92256259918212890625
address@hidden example
+
+Se invece si dovesse calcolare lo stesso valore usando valori a virgola mobile
+con precisione arbitraria, la precisione necessaria per il risultato corretto
+(usando
+la formula
address@hidden
address@hidden = 3.322 @cdot dps})
+sarebbe @math{3.322 @cdot 183231},
address@hidden iftex
address@hidden
address@hidden
address@hidden = 3.322 * dps})
+sarebbe 3.322 x 183231,
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>prec</emphasis> = 3.322 ⋅ <emphasis>dps</emphasis>)
+would be
+<emphasis>prec</emphasis> = 3.322 ⋅ 183231,
address@hidden docbook
+o 608693.
+
+Il risultato di un'operazione aritmetica tra un intero e un valore a virgola
+mobile @`e un valore a virgola mobile con precisione uguale alla precisione di
+lavoro. Il seguente programma calcola l'ottavo termine nella successione di
address@hidden, Eric W.
address@hidden's Sequence}. From MathWorld---A Wolfram Web Resource
address@hidden(@url{http://mathworld.wolfram.com/SylvestersSequence.html}).}}
+usando una ricorrenza:
+
address@hidden
+$ @kbd{gawk -M 'BEGIN @{}
+> @kbd{s = 2.0}
+> @kbd{for (i = 1; i <= 7; i++)}
+> @kbd{s = s * (s - 1) + 1}
+> @kbd{print s}
+> @address@hidden'}
address@hidden 113423713055421845118910464
address@hidden example
+
+Il risultato mostrato differisce dal numero effettivo,
+113.423.713.055.421.844.361.000.443,
+perch@'e la precisione di default di 53 bit non @`e suffciente per
rappresentare
+esattamente il risultato in virgola mobile. Si address@hidden o aumentare la
precisione
+(in questo caso bastano 100 bit), o sostituire la costante in virgola mobile
address@hidden con un intero, per eseguire tutti i calcoli usando l'aritmetica
con
+gli interi per ottenere l'output corretto.
+
+A volte @command{gawk} deve convertire implicitamente un intero con precisione
+arbitraria in un valore a virgola mobile con precisione arbitraria.
address@hidden si rende necessario
+principalmente perch@'e la libreria MPFR non sempre prevede l'interfaccia
+necessaria per elaborare interi a precisione arbitraria o numeri di tipo
+eterogeneo come richiesto da un'operazione o funzione. In tal caso, la
+precisione viene impostata al minimo valore necessario per una conversione
+esatta, e non viene usata la precisione di lavoro. Se
+questo non @`e quello di cui si ha bisogno o che si vuole, si address@hidden
ricorrere a un
+sotterfugio e convertire preventivamente l'intero in un valore a virgola
+mobile, come qui di seguito:
+
address@hidden
+gawk -M 'BEGIN @{ n = 13; print (n + 0.0) % 2.0 @}'
address@hidden example
+
+Si address@hidden evitare completamente questo passaggio specificando il
numero come
+valore a virgola mobile fin dall'inizio:
+
address@hidden
+gawk -M 'BEGIN @{ n = 13.0; print n % 2.0 @}'
address@hidden example
+
+Si noti che, per questo specifico esempio, probabilmente @`e meglio
+semplicemente specificare:
+
address@hidden
+gawk -M 'BEGIN @{ n = 13; print n % 2 @}'
address@hidden example
+
+Dividendo due interi a precisione arbitraria con @samp{/} o con @samp{%}, il
+risultato @`e tipicamente un valore a virgola mobile con precisione arbitraria
+(a meno che il risultato non sia un numero intero esatto).
+Per eseguire divisioni intere o calcolare moduli con interi a precisione
+arbitraria, usare la funzione predefinita
address@hidden()} (@pxref{Funzioni numeriche}).
+
+Si address@hidden simulare la funzione @code{intdiv()} in @command{awk}
standard
+usando questa funzione definita dall'utente:
+
address@hidden
address@hidden file eg/lib/intdiv.awk
+# intdiv --- fa una divisione intera
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/intdiv.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# July, 2014
+#
+# Name changed from div() to intdiv()
+# April, 2015
+
address@hidden endfile
+
address@hidden ignore
address@hidden file eg/lib/intdiv.awk
+function intdiv(numerator, denominator, result)
address@hidden
+ split("", result)
+
+ numerator = int(numerator)
+ denominator = int(denominator)
+ result["quotient"] = int(numerator / denominator)
+ result["remainder"] = int(numerator % denominator)
+
+ return 0.0
address@hidden
address@hidden endfile
address@hidden example
+
+Il seguente programma d'esempio, proposto da Katie Wasserman,
+usa @code{intdiv()} per
+calcolare le cifre di @value{PI} al numero di cifre significative
+che si @`e scelto di impostare:
+
address@hidden
address@hidden file eg/prog/pi.awk
+# pi.awk --- calcola le cifre di pi
address@hidden endfile
address@hidden endfile
address@hidden
address@hidden file eg/prog/pi.awk
+#
+# Katie Wasserman, katie@@wass.net
+# August 2014
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/pi.awk
+
+BEGIN @{
+ cifre = 100000
+ due = 2 * 10 ^ cifre
+ pi = due
+ for (m = cifre * 4; m > 0; --m) @{
+ d = m * 2 + 1
+ x = pi * m
+ intdiv(x, d, risultato)
+ pi = risultato["quotient"]
+ pi = pi + due
+ @}
+ print pi
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Date: Wed, 20 Aug 2014 10:19:11 -0400
+To: address@hidden
+From: Katherine Wasserman <address@hidden>
+Subject: Re: computation of digits of pi?
+
+Arnold,
+
+>The program that you sent to compute the digits of pi using div(). Is
+>that some standard algorithm that every math student knows? If so,
+>what's it called?
+
+It's not that well known but it's not that obscure either
+
+It's Euler's modification to Newton's method for calculating pi.
+
+Take a look at lines (23) - (25) here:
http://mathworld.wolfram.com/PiFormulas.htm
+
+The algorithm I wrote simply expands the multiply by 2 and works from the
innermost expression outwards. I used this to program HP calculators because
it's quite easy to modify for tiny memory devices with smallish word sizes.
+
+http://www.hpmuseum.org/cgi-sys/cgiwrap/hpmuseum/articles.cgi?read=899
+
+-Katie
address@hidden ignore
+
+Quando gli fu chiesto dell'algoritmo usato, Katie rispose:
+
address@hidden
+Non @`e quello address@hidden noto ma nemmeno quello address@hidden
incomprensibile.
address@hidden la variante di Eulero al metodo di Newton per il calcolo del Pi
greco.
+Si vedano le righe (23) - (25) nel sito:
address@hidden://mathworld.wolfram.com/PiFormulas.html}.
+
+L'algoritmo che ho scritto semplicemente espande il moltiplicare per 2 e
+lavora dall'espressione address@hidden interna verso l'esterno. Ho usato
questo per
+programmare delle calcolatrici HP perch@'e @`e piuttosto facile da adattare ai
+dispositivi di scarsa memoria con dimensioni di parola piuttosto piccole.
+Si veda
address@hidden://www.hpmuseum.org/cgi-sys/cgiwrap/hpmuseum/articles.cgi?read=899}.
address@hidden quotation
+
address@hidden Problemi virgola mobile POSIX
address@hidden Confronto tra standard e uso corrente
+
+Per diverso tempo, @command{awk} ha convertito le stringhe dall'aspetto non
+numerico nel valore numerico zero, quando richiesto. Per di address@hidden, la
+definizione originaria del linguaggio e lo standard POSIX originale prevedevano
+che @command{awk} riconoscesse solo i numeri decimali (base 10), e non i numeri
+ottali (base 8) o esadecimali (base 16).
+
+Le modifiche nel linguaggio degli standard POSIX 2001 e 2004 possono essere
+interpretate nel senso che @command{awk} debba fornire delle address@hidden
+aggiuntive. Queste sono:
+
address@hidden @value{BULLET}
address@hidden
+Interpretazione del valore dei dati a virgola mobile specificati in notazione
+esadecimale (p.es., @code{0xDEADBEEF}). (Da notare: valore dei dati letti,
address@hidden costanti facenti parte del codice sorgente.)
+
address@hidden
+Supporto per i valori a virgola mobile speciali IEEE 754 ``not a number''
+(NaN), address@hidden infinito (``inf'') e meno infinito (address@hidden'').
+In particolare, il formato per questi valori @`e quello specificato dallo
+standard C ISO 1999, che non distingue maiuscole/minuscole e address@hidden
consentire
+caratteri aggiuntivi dipendenti dall'implementazione dopo il @samp{nan}, e
+consentire o @samp{inf} o @samp{infinity}.
address@hidden itemize
+
+Il primo problema @`e che entrambe le modifiche sono deviazioni evidenti
+dalla prassi consolidata:
+
address@hidden @value{BULLET}
address@hidden
+Il manutentore di @command{gawk} crede che supportare i valori a virgola mobile
+esadecimali, nello specifico, sia sbagliato, e che non sia mai stata intenzione
+dell'autore originale di introdurlo nel linguaggio.
+
address@hidden
+Consentire che stringhe completamente alfabetiche abbiano valori numerici
+validi @`e anch'essa una deviazione molto marcata dalla prassi consolidata.
address@hidden itemize
+
+Il secondo problema @`e che il manutentore di @command{gawk} crede che questa
+interpretazione dello standard, che richiede una certa dimestichezza col
+linguaggio giuridico per essere compresa, non sempre @`e stata
+colta dai normali sviluppatori. In altre parole, ``Sappiamo come siete
+arrivati sin qui, ma non pensiamo che questo sia il posto dove volete essere.''
+
+Recependo queste argomentazioni, e cercando nel contempo di assicurare la
address@hidden con le versioni precedenti dello standard, lo standard POSIX 2008
+ha aggiunto delle formulazioni esplicite per consentire l'uso da parte di
address@hidden, solo a richiesta, dei valori a virgola mobile esadecimali e
+dei valori speciali
address@hidden a number}'' e infinito.
+
+Sebbene il manutentore di @command{gawk} continui a credere che introdurre
+queste address@hidden sia sconsigliabile, address@hidden nonostante, sui
sistemi che
+supportano i valori in virgola mobile IEEE, sembra giusto fornire
address@hidden
address@hidden di usare i valori NaN e infinito. La soluzione implementata
+in @command{gawk} @`e questa:
+
address@hidden @value{BULLET}
address@hidden
+Se @`e stata specificata l'opzione da riga di comando @option{--posix},
address@hidden non
+interviene. I valori di stringa sono passati direttamente alla funzione
address@hidden()} della libreria di sistema, e se quest'ultima restituisce
+senza errori un valore numerico,
+esso viene address@hidden'avete voluto, tenetevelo.}
+Per definizione, i risultati non sono portabili su diversi sistemi;
+e sono anche piuttosto sorprendenti:
+
address@hidden
+$ @kbd{echo nanny | gawk --posix '@{ print $1 + 0 @}'}
address@hidden nan
+$ @kbd{echo 0xDeadBeef | gawk --posix '@{ print $1 + 0 @}'}
address@hidden 3735928559
address@hidden example
+
address@hidden
+Senza l'opzione @option{--posix}, @command{gawk} interpreta i quattro valori
di stringa
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+in modo speciale, producendo i corrispondenti valori numerici speciali.
+Il segno iniziale serve per segnalare a @command{gawk} (e all'utente)
+che il valore @`e realmente numerico. I numeri a virgola mobile esadecimali
+non sono consentiti (a meno di non usare anche @option{--non-decimal-data},
+che @emph{non} @`e consigliabile). Per esempio:
+
address@hidden
+$ @kbd{echo nanny | gawk '@{ print $1 + 0 @}'}
address@hidden 0
+$ @kbd{echo +nan | gawk '@{ print $1 + 0 @}'}
address@hidden nan
+$ @kbd{echo 0xDeadBeef | gawk '@{ print $1 + 0 @}'}
address@hidden 0
address@hidden example
+
address@hidden ignora la distinzione maiuscole/minuscole nei quattro valori
+speciali. address@hidden@dotless{i}}, @samp{+nan} e @samp{+NaN} sono la stessa
cosa.
address@hidden itemize
+
address@hidden Sommario virgola mobile
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+La maggior parte dell'aritmetica al calcolatore @`e fatta usando numeri interi
+oppure
+valori a virgola mobile. L'@command{awk} standard usa valori a virgola mobile
+a doppia precisione.
+
address@hidden
+Nei primi anni '90 Barbie disse erroneamente, ``L'ora di matematica @`e
+ostica!'' Sebbene la matematica non sia ostica, l'aritmetica a virgola
+mobile non @`e proprio come la
+matematica ``carta e penna'', e bisogna prestare attenzione:
+
address@hidden nested list
address@hidden @value{MINUS}
address@hidden
+Non tutti i numeri possono essere rappresentati in modo esatto.
+
address@hidden
+Per confrontare dei valori bisognerebbe usare un delta, invece di farlo
+direttamente con @samp{==} e @samp{!=}.
+
address@hidden
+Gli errori si accumulano.
+
address@hidden
+Le operazioni non sempre sono esattamente associative o distributive.
address@hidden itemize
+
address@hidden
+Aumentare l'accuratezza address@hidden essere d'aiuto, ma non @`e una panacea.
+
address@hidden
+Spesso, aumentare la precisione e poi arrotondare al numero di cifre
+desiderato produce risultati soddisfacenti.
+
address@hidden
+Specificare l'opzione @option{-M} (o @option{--bignum}) per abilitare
+il calcolo MPFR.
+Usare @code{PREC} per impostare la precisione in bit, e
address@hidden per impostare la address@hidden di arrotondamento tra quelle
+previste nello standard IEEE 754.
+
address@hidden
+Specificando l'opzione @option{-M}, @command{gawk} esegue calcoli su interi a
precisione
+arbitraria usando la libreria GMP. In tal modo si ha una maggiore
address@hidden e
+una address@hidden efficiente allocazione dello spazio rispetto all'uso di
MPFR per
+eseguire gli stessi calcoli.
+
address@hidden
+Ci sono diverse aree per quanto attiene ai numeri a virgola mobile in cui
address@hidden @`e in disaccordo con lo standard POSIX.
address@hidden importante averlo ben presente.
+
address@hidden
+In generale, non vi @`e alcun bisogno di essere eccessivamente diffidenti
verso i
+risultati del calcolo in virgola mobile. La lezione da ricordare @`e che
+il calcolo in virgola mobile @`e sempre address@hidden complesso di quello che
si fa con
+carta e penna. Per trarre vantaggio dalla potenza del calcolo in virgola
+mobile, bisogna conoscere i suoi limiti e stare all'interno di essi.
+Per la maggior parte degli usi occasionali del calcolo in virgola mobile, si
+possono ottenere i risultati attesi semplicemente arrotondando la
+visualizzazione dei risultati finali al giusto numero di cifre decimali
+significative.
+
address@hidden
+Come consiglio generale, evitare di rappresentare dati numerici in maniera
+tale da far sembrare che la precisione sia maggiore di quella effettivamente
+necessaria.
+
address@hidden itemize
+
address@hidden Estensioni dinamiche
address@hidden Scrivere estensioni per @command{gawk}
address@hidden estensioni caricate dinamicamente
address@hidden dinamiche, estensioni
+
address@hidden possibile aggiungere nuove funzioni, scritte in C o C++, a
@command{gawk}
+usando librerie caricate dinamicamente. Questa address@hidden @`e disponibile
+su sistemi che supportano le funzioni C @code{dlopen()} e @code{dlsym()}.
+Questo @value{CHAPTER} descrive come creare estensioni usando codice scritto
+in C o C++.
+
+Chi @`e completamente digiuno di programmazione in C address@hidden
tranquillamente
+saltare questo @value{CHAPTER}, ma potrebbe valer la pena di dare un'occhiata
+alla documentazione sulle estensioni che sono installate insieme a
address@hidden (@pxref{Esempi di estensione}),
+e alle informazioni sul progetto @code{gawkextlib} (@pxref{gawkextlib}).
+Gli esempi di estensione sono automaticamente compilati e installati quando
+si installa @command{gawk}.
+
address@hidden NOTA
+Se si specifica l'opzione @option{--sandbox}, le estensioni non sono
+disponibili
+(@pxref{Opzioni}).
address@hidden quotation
+
address@hidden
+* Introduzione alle estensioni:: Cos'@`e un'estensione.
+* Licenza delle estensioni:: Una nota riguardo al tipo di licenza.
+* Panoramica sul meccanismo delle estensioni:: Una panoramica sul meccanismo
+ delle estensioni.
+* Descrizione dell'API delle estensioni:: Una descrizione completa dell'API.
+* Trovare le estensioni:: Come @command{gawk} trova le estensioni
+ compilate.
+* Esempio di estensione:: Esempio di codice C di un'estensione.
+* Esempi di estensione:: Le estensioni di esempio incluse con
+ @command{gawk}.
+* gawkextlib:: Il progetto @code{gawkextlib}.
+* Sommario delle estensioni:: Sommario delle estensioni.
+* Esercizi sulle estensioni:: Esercizi.
address@hidden menu
+
address@hidden Introduzione alle estensioni
address@hidden Cos'@`e un'estensione
+
address@hidden plug-in
+Un'@dfn{estensione} (talora chiamata @dfn{plug-in}) @`e un frammento di codice
+compilato esternamente che @command{gawk} address@hidden caricare in fase di
esecuzione
+per ottenere address@hidden ulteriori, che vanno ad aggiungersi a quelle di
address@hidden descritte nel resto di questo @value{DOCUMENT}.
+
+Le estensioni sono utili perch@'e consentono (ovviamente) di estendere le
address@hidden di @command{gawk}. Per esempio, possono permettere l'uso di
address@hidden di sistema} (come @code{chdir()} per cambiare directory)
+e di altre routine di libreria C potenzialmente utili. Come per la maggior
+parte del software, ``il cielo @`e il limite''; se si riesce a immaginare
+qualcosa che si vuol fare e che @`e possibile programmare in C o C++,
+si address@hidden scrivere un'estensione che lo faccia!
+
+Le estensioni sono scritte in C o C++, usando l'API (@dfn{Application
+Programming Interface}) definita per questo scopo dagli sviluppatori di
address@hidden Il resto di questo @value{CHAPTER} descrive
+le address@hidden offerte dall'API e come usarle,
+e illustra una piccola estensione di esempio. Inoltre, sono documentati
+gli esempi di estensione inclusi nella distribuzione di @command{gawk}
+e viene descritto il progetto @code{gawkextlib}.
address@hidden FOR_PRINT
address@hidden delle estensioni}, per una disamina degli obiettivi e del
+progetto del meccanismo delle estensioni.
address@hidden ifclear
address@hidden FOR_PRINT
+Si veda
@uref{http://www.gnu.org/software/gawk/manual/html_node/estensione-Design.html}
+per una disamina degli obiettivi e del
+progetto del meccanismo delle estensioni.
address@hidden ifset
+
address@hidden Licenza delle estensioni
address@hidden Tipo di licenza delle estensioni
+
+Ogni estensione dinamica dev'essere distribuita in base a una licenza che sia
+compatibile con la licenza GNU GPL (@pxref{Copia}).
+
+Per far sapere a @command{gawk} che la licenza @`e quella corretta,
+l'estensione deve definire il simbolo globale
address@hidden Se tale simbolo non @`e stato definito,
address@hidden termina con un messaggio di errore fatale al momento del
+caricamente dell'estensione.
+
+Il tipo dichiarato per il suddetto simbolo dev'essere @code{int}. Esso non
+deve tuttavia essere presente in ogni sezione allocata.
+Il controllo in essere si limita a constatare che quel simbolo esiste a
+livello globale.
+Qualcosa del genere address@hidden essere sufficiente:
+
address@hidden
+int plugin_is_GPL_compatible;
address@hidden example
+
address@hidden Panoramica sul meccanismo delle estensioni
address@hidden Una panoramica sul funzionamento ad alto livello
+
+La comunicazione tra
address@hidden e un'estensione @`e bidirezionale. Dapprima, quando
+un'estensione @`e caricata, @command{gawk} le passa un puntatore a una
struttura
+(@code{struct}) i cui campi sono dei puntatori di funzione.
address@hidden
+Questo si address@hidden vedere in @ref{figura-carica-estensione}.
address@hidden ifnotdocbook
address@hidden
+Questo si address@hidden vedere in @inlineraw{docbook, <xref
linkend="figura-carica-estensione"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-carica-estensione
address@hidden dell'estensione}
address@hidden SMALLPRINT
address@hidden @image{api-figura1, , , Caricamento dell'estensione}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{api-figura1, 11cm, , Caricamento dell'estensione}
address@hidden ifset
+
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-carica-estensione" float="0">
+<title>Caricamento dell'estensione</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="api-figura1.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
+L'estensione @`e in grado di chiamare funzioni all'interno di @command{gawk}
+utilizzando questi puntatori a funzione, in fase di esecuzione, senza aver
+bisogno di accedere (in fase di compilazione), ai simboli di @command{gawk}.
+Uno di questi puntatori a funzione punta a una funzione che serve per
+``registrare'' nuove funzioni.
address@hidden
+Questo @`e mostrato in @ref{figura-registrare-una-nuova-funzione}.
address@hidden ifnotdocbook
address@hidden
+Questo @`e shown in @inlineraw{docbook, <xref
linkend="figura-registrare-una-nuova-funzione"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-registrare-una-nuova-funzione
address@hidden una nuova funzione}
address@hidden SMALLPRINT
address@hidden @image{api-figura2, , , Registrare una nuova funzione}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{api-figura2, 11cm , , Registrare una nuova funzione}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-registrare-una-nuova-funzione" float="0">
+<title>Registering a new function</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="api-figura2.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
+Nella direzione opposta, l'estensione registra le sue nuove funzioni
+con @command{gawk} passando dei puntatori che puntano alle funzioni che
+implementano la nuova address@hidden, (p.es. @code{do_chdir()}).
@command{gawk}
+associa il puntatore a funzione con un nome ed @`e in grado di chiamarlo in
+seguito, usando una convenzione di chiamata predefinita.
address@hidden
+Questo @`e mostrato in @ref{figura-chiamata-nuova-funzione}.
address@hidden ifnotdocbook
address@hidden
+Questo @`e mostrato in @inlineraw{docbook, <xref
linkend="figura-chiamata-nuova-funzione"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-chiamata-nuova-funzione
address@hidden della nuova funzione}
address@hidden SMALLPRINT
address@hidden @image{api-figura3, , , Chiamata della nuova funzione}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{api-figura3,11cm , , Chiamata della nuova funzione}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-chiamata-nuova-funzione" float="0">
+<title>Chiamata della nuova funzione</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="api-figura3.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
+La funzione @address@hidden()}, a sua volta, utilizza i puntatori a
+funzione nella struttura (@code{struct}) API per svolgere il proprio compito,
+come aggiornare variabili o vettori, stampare messaggi, impostare la
+variabile @code{ERRNO}, e address@hidden@dotless{i}} via.
+
+Delle macro di servizio rendono la chiamata effettuata utilizzando
+i puntatori simile a quella delle funzioni normali, in modo che il codice
+sorgente delle estensioni rimanga sufficientemente leggibile e comprensibile.
+
+Sebbene tutto address@hidden possa sembrare piuttosto complesso, il risultato
@`e che il
+codice sorgente dell'estensione @`e abbastanza intuitivo da scrivere e da
+leggere. Lo si address@hidden constatare nell'estensione di esempio
address@hidden
+(@pxref{Esempio di estensione}), come pure nel codice @file{testext.c},
+che testa l'interfaccia di programmazione (API).
+
+Ecco alcuni ulteriori dettagli:
+
address@hidden @value{BULLET}
address@hidden
+L'API fornisce accesso ai valori delle variabili @command{gawk}
address@hidden@var{xxx}}, che memorizzano opzioni della riga di comando come
address@hidden, @code{do_profiling}, e address@hidden@dotless{i}} via
(@pxref{Variabili dell'estensione API}).
+Questi valori sono solo informativi: un'estensione non address@hidden
modificarli
+all'interno di @command{gawk}. Oltre a address@hidden, il tentativo di
assegnare loro
+dei valori produce un errore quando l'estensione viene compilata.
+
address@hidden
+L'API fornisce anche i numeri che identificano la specifica versione di
address@hidden, in modo che un'estensione possa controllare se il
+comando @command{gawk} che l'ha caricata @`e in grado di supportare le
address@hidden utilizzate nell'estensione. (Discrepanze tra le versioni
+``non dovrebbero'' accadere, ma si sa come vanno @emph{queste} cose.)
address@hidden dell'estensione} per ulteriori dettagli.
address@hidden itemize
+
address@hidden Descrizione dell'API delle estensioni
address@hidden Una descrizione completa dell'API
address@hidden estensioni, API delle
address@hidden API, delle estensioni
+
+Il codice sorgente scritto in C o C++ per un'estensione deve includere il
+file di intestazione
address@hidden, che dichiara le funzioni e definisce i tipi di dati
+usati per comunicare con @command{gawk}.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
+(non breve) @value{SECTION} descrive l'API in detttaglio.
+
address@hidden
+* Intro funzioni API delle estensioni:: Introduzione alle funzioni dell'API.
+* Tipi di dati generali:: I tipi di dati.
+* Funzioni di allocazione memoria:: Funzioni per allocare memoria.
+* Funzioni di costruzione:: Funzioni per creare valori.
+* Funzioni di registrazione:: Funzioni per registrare cose con
+ @command{gawk}.
+* Stampare messaggi:: Funzioni per stampare messaggi.
+* Aggiornare @code{ERRNO}:: Funzioni per aggiornare @code{ERRNO}.
+* Richiedere valori:: Come ottenere un valore.
+* Accedere ai parametri:: Funzioni per accedere ai parametri.
+* Accedere alla tabella simboli:: Funzioni per accedere alle variabili
+ globali
+* Manipolazione di vettori:: Funzioni per lavorare coi vettori.
+* Ridirezione API:: Come accedere alla ridirezioni e
+ modificarle.
+* Variabili dell'estensione API:: Variabili fornite dall'API.
+* Codice predefinito di un'estensione API:: Codice predefinito di
+ interfaccia API.
+* Modifiche dalla versione API 1:: Modifiche dalla versione 1 dell'API.
address@hidden menu
+
address@hidden Intro funzioni API delle estensioni
address@hidden Introduzione alle funzioni dell'API
+
+L'accesso a address@hidden interne a @command{gawk} @`e effettuato
+con una chiamata che usa i puntatori a funzione resi disponibili
+all'estensione.
+
+Puntatori a funzioni API sono previsti per i seguenti tipi di operazioni:
+
address@hidden @value{BULLET}
address@hidden
+Allocare, riallocare e liberare memoria.
+
address@hidden
+Registrare funzioni. Si possono registrare:
+
address@hidden nested list
address@hidden @value{MINUS}
address@hidden
+Funzioni di estensione
address@hidden
+Funzioni ausiliarie di pulizia (@dfn{callbacks})
address@hidden
+Una stringa di caratteri che identifica la versione
address@hidden
+Funzioni per analizzare l'input
address@hidden
+Funzioni per modificare l'output
address@hidden
+Processori bidirezionali
address@hidden itemize
+
+Tutti questi elementi sono spiegati dettagliatamente nel resto di questo
@value{CHAPTER}.
+
address@hidden
+Stampare messaggi fatali, di avvertimento e quelli generati dall'opzione
+``lint''.
+
address@hidden
+Modificare @code{ERRNO} o annullarne il valore.
+
address@hidden
+Accedere a parametri, compresa la address@hidden di definire come vettore
+un parametro ancora indefinito.
+
address@hidden
+Accedere alla "tabella dei simboli": procurarsi il valore di una variabile
+globale, crearne una nuova o modificarne una address@hidden esistente.
+
address@hidden
+Creare ed eliminare valori nascosti; address@hidden rende possibile usare un
+particolare valore per address@hidden di una variabile, e address@hidden
migliorare parecchio
+le prestazioni.
+
address@hidden
+Manipolare vettori:
+
address@hidden @value{MINUS}
address@hidden
+Ritrovare il valore di elementi del vettore, aggiungerne di nuovi,
+cancellare e modificare elementi esistenti.
+
address@hidden
+Ottenere il numero di elementi presenti in un vettore
+
address@hidden
+Creare un nuovo vettore
+
address@hidden
+Cancellare un intero vettore
+
address@hidden
+Appiattire un vettore per poter facilmente eseguire un ciclo, in stile C,
+su tutti i suoi indici ed elementi
address@hidden itemize
+
address@hidden
+Accedere a ridirezioni e manipolarle.
+
address@hidden itemize
+
+Alcune osservazioni riguardo all'uso dell'API:
+
address@hidden @value{BULLET}
address@hidden
+I seguenti tipi di variabili, macro e/o funzioni sono resi disponibili
+nel file @file{gawkapi.h}. Perch@'e siano utilizzabili, i rispettivi file di
+intestazione standard indicati devono essere stati specificati @emph{prima}
+di includere @file{gawkapi.h}:
+
address@hidden FIXME: Make this as a float at some point.
address@hidden address@hidden()}, @code{memcpy()}} address@hidden<sys/types.h>}}
address@hidden Elemento C @tab File d'intestazione
address@hidden @code{EOF} @tab @code{<stdio.h>}
address@hidden valori di @code{errno} @tab @code{<errno.h>}
address@hidden @code{FILE} @tab @code{<stdio.h>}
address@hidden @code{NULL} @tab @code{<stddef.h>}
address@hidden @code{memcpy()} @tab @code{<string.h>}
address@hidden @code{memset()} @tab @code{<string.h>}
address@hidden @code{size_t} @tab @code{<sys/types.h>}
address@hidden @code{struct stat} @tab @code{<sys/stat.h>}
address@hidden multitable
+
+Per ragioni di address@hidden, specialmente per sistemi
+che non sono interamente aderenti agli standard, occorre assicurarsi di
+includere i file corretti nel modo corretto. Questa richiesta mira
+a mantenere il file @file{gawkapi.h} ordinato, invece che farlo diventare
+un'accozzaglia di problemi di address@hidden, quale si address@hidden vedere
in alcune
+parti del codice sorgente di @command{gawk}.
+
address@hidden
+Il file @file{gawkapi.h} address@hidden essere incluso address@hidden volte,
senza conseguenze
+negative. Tuttavia sarebbe meglio evitare di farlo, per uno
+stile di programmazione migliore.
+
address@hidden
+Sebbene l'API usi solo address@hidden ISO C 90, c'@`e un'eccezione; le funzione
+``costruttrici'' usano la parola chiave @code{inline}. Se il compilatore in
+uso non supporta questa parola chiave, si dovrebbe specificare sulla
+riga di comando il parametro @samp{-Dinline=''} oppure usare gli strumenti
+Autotools GNU e includere un file
address@hidden nel codice sorgente delle estensioni.
+
address@hidden
+Tutti i puntatori messi a disposizione da @command{gawk} puntano ad aree
+di memoria gestite da @command{gawk} e dovrebbero essere trattati
+dall'estensione come in sola lettura. Le aree di memoria che contengono
@emph{tutte} le stringhe passate a
address@hidden dall'estensione @emph{devono} provenire da una chiamata a
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()},
+e sono gestite da @command{gawk} da quel punto in avanti.
+
address@hidden
+L'API definisce parecchie semplici @code{struct} che mappano dei valori
+come sono visti da @command{awk}. Un valore address@hidden essere un numero
@code{double}
+(a virgola mobile, in doppia precisione), una stringa o un
+vettore (come @`e il caso per i vettori multidimensionali o nella creazione di
+un nuovo vettore).
+
+I valori di tipo stringa sono costituiti da un puntatore e da una lunghezza,
+poich@'e nella stringa possono essere presenti dei caratteri @sc{nul}
+(zeri binari, che normalmente marcano la fine di una stringa).
+
address@hidden NOTA
+Di proposito, @command{gawk} immagazzina le stringhe usando la codifica
+multibyte correntemente in uso (come definita dalle variabili d'ambiente
address@hidden@var{xxx}}) e non usando dei caratteri larghi (ovvero due byte per
+ogni carattere). address@hidden riflette il modo con cui @command{gawk}
memorizza le
+stringhe internamente, e anche il modo in cui i caratteri sono
+verosimilmente letti dai file in input e scritti nei file in output.
address@hidden quotation
+
address@hidden NOTA
+I valori di una stringa passati a un'estensione da @command{gawk} hanno
+sempre un carattere @sc{nul} alla fine (come delimitatore). Quindi @`e
+possibile usare senza inconvenienti tali valori di stringa per chiamare
+funzioni di libreria standard e routine di sistema. Tuttavia, poich@'e
address@hidden consente che all'interno di una stringa di dati possano
+essere presenti caratteri @sc{nul}, si dovrebbe controllare che la
+lunghezza di ogni stringa passata un'estensione coincida con il valore
+restituito dalla funzione @code{strlen()} per la stringa stessa.
address@hidden quotation
+
address@hidden
+Per ottenere un valore (p.es. quello di un parametro o quello di una
+variabile globale, oppure di un elemento di un vettore), l'estensione chiede
+un tipo specifico di variabile (numero, stringa,
+scalare, @dfn{value cookie} [si veda address@hidden avanti], vettore o
``undefined'').
+Quando la richiesta @`e
+``undefined,'' il valore restituito address@hidden quello originale della
variabile in
+questione.
+
+In ogni caso, se la richiesta e il tipo effettivo della variabile non
+corrispondono, la funzione di accesso restituisce ``false'' e fornisce il
+tipo proprio della variabile, in modo che l'estensione possa, p.es.,
+stampare un messaggio di errore
+(del tipo ``ricevuto uno scalare, invece del vettore previsto'').
+
address@hidden This is documented in the header file and needs some expanding
upon.
address@hidden The table there should be presented here
address@hidden itemize
+
+Si possono chiamare le funzioni dell'API usando i puntatori a funzione
+direttamente, ma l'interfaccia non @`e molto elegante. Per permettere al
+codice sorgente delle estensioni di assomigliare di address@hidden a un codice
normale,
+il file di intestazione @file{gawkapi.h} definisce parecchie
+macro da usare nel codice sorgente dell'estensione.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden presenta le macro come se si trattasse di funzioni.
+
address@hidden Tipi di dati generali
address@hidden I tipi di dati di impiego generale
+
address@hidden Robbins, Arnold
address@hidden Ramey, Chet
address@hidden
address@hidden un vero rapporto di amore/odio con le @dfn{unioni}.}
address@hidden Arnold Robbins
address@hidden quotation
+
address@hidden
address@hidden @`e address@hidden che contraddistingue le @dfn{unioni}: il
compilatore @`e
+in grado di accomodare le cose in modo da far coesistere amore e odio.}
address@hidden Chet Ramey
address@hidden quotation
+
+L'estensione API definisce un certo numero di semplici tipi di dato e
+strutture di uso generale. Ulteriori strutture di dati, address@hidden
specializzate,
+saranno introdotte
address@hidden
+nelle successive
address@hidden ifnotinfo
address@hidden
+nei successivi
address@hidden ifinfo
address@hidden, insieme alle funzioni che ne fanno uso.
+
+I tipi di dati e le strutture di uso generale sono le seguenti:
+
address@hidden @code
address@hidden typedef void *awk_ext_id_t;
+Un valore di questo tipo @`e trasmesso da @command{gawk} a un'estensione nel
+momento in cui viene caricata. Tale valore dev'essere restituito
+a @command{gawk} come primo parametro di ogni funzione API.
+
address@hidden #define awk_const @dots{}
+Questa macro genera delle @samp{costanti} nel momento in cui si compila
+un'estensione, e non genera nulla quando si compila il comando @command{gawk}
+vero e proprio. address@hidden rende alcuni
+campi nelle strutture dei dati dell'API non alterabili dal codice sorgente
+dell'estensione, ma consente al comando @command{gawk} di usarle secondo
address@hidden
+
address@hidden typedef enum awk_bool @{
address@hidden @ @ @ @ awk_false = 0,
address@hidden @ @ @ @ awk_true
address@hidden @} awk_bool_t;
+Un semplice tipo di variabile booleana.
+
address@hidden typedef struct awk_string @{
address@hidden @ @ @ @ char *str;@ @ @ @ @ /* dati veri e propri */
address@hidden @ @ @ @ size_t len;@ @ @ @ /* lunghezza degli stessi, in
caratteri */
address@hidden @} awk_string_t;
+Questo rappresenta una stringa modificabile. @command{gawk} @`e responsabile
+per la gestione della memoria utilizzata, se ha fornito il valore della
+stringa. Altrimenti, assume il possesso della memoria in questione.
address@hidden memoria dev'essere resa disponibile chiamando una delle funzioni
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}!}
+
+Come address@hidden detto, la rappresentazione delle stringhe in memoria usa
la codifica
+multibyte corrente.
+
address@hidden typedef enum @{
address@hidden @ @ @ @ AWK_UNDEFINED,
address@hidden @ @ @ @ AWK_NUMBER,
address@hidden @ @ @ @ AWK_STRING,
address@hidden @ @ @ @ AWK_REGEX,
address@hidden @ @ @ @ AWK_STRNUM,
address@hidden @ @ @ @ AWK_ARRAY,
address@hidden @ @ @ @ AWK_SCALAR,@ @ @ @ @ @ @ @ @ /* accesso opaco a una
variabile */
address@hidden @ @ @ @ AWK_VALUE_COOKIE@ @ @ @ /* per aggiornare un valore
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ address@hidden
creato */
address@hidden @} awk_valtype_t;
+L'elenco @code{enum} indica di che tipo @`e un certo valore.
address@hidden usato nella seguente struttura @code{struct}.
+
address@hidden typedef struct awk_value @{
address@hidden @ @ @ @ awk_valtype_t val_type;
address@hidden @ @ @ @ union @{
address@hidden @ @ @ @ @ @ @ @ awk_string_t@ @ @ @ @ @ @ s;
address@hidden @ @ @ @ @ @ @ @ double@ @ @ @ @ @ @ @ @ @ @ @ @ d;
address@hidden @ @ @ @ @ @ @ @ awk_array_t@ @ @ @ @ @ @ @ a;
address@hidden @ @ @ @ @ @ @ @ awk_scalar_t@ @ @ @ @ @ @ scl;
address@hidden @ @ @ @ @ @ @ @ awk_value_cookie_t@ vc;
address@hidden @ @ @ @ @} u;
address@hidden @} awk_value_t;
+Un ``valore di @command{awk}''.
+Il campo @code{val_type} indica che tipo di valore @code{union} contiene,
+e ogni campo @`e del tipo appropriato.
+
address@hidden #define str_value@ @ @ @ @ @ u.s
address@hidden #define strnum_value@ @ @ str_value
address@hidden #define regex_value@ @ @ @ str_value
address@hidden #define num_value@ @ @ @ @ @ u.d
address@hidden #define array_cookie@ @ @ u.a
address@hidden #define scalar_cookie@ @ u.scl
address@hidden #define value_cookie@ @ @ u.vc
+L'uso di queste macro rende address@hidden facile da seguire l'accesso ai
campi di
address@hidden
+
address@hidden typedef void *awk_scalar_t;
+La variabili scalari possono essere rappresentate da un tipo opaco. Questi
+valori sono ottenuti da @command{gawk} e in seguito gli vengono restituiti.
+Questo argomento @`e discusso in maniera generale nel testo che segue questa
+lista, e address@hidden in dettaglio
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden simboli tramite cookie}.
+
address@hidden typedef void *awk_value_cookie_t;
+Un address@hidden cookie}'' @`e un tipo di variabile opaca, e
+rappresenta un valore nascosto.
+Anche questo argomento @`e discusso in maniera generale nel testo che segue
+questa lista, e address@hidden in dettaglio
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden nascosti}.
+
address@hidden table
+
+I valori di tipo scalare in @command{awk} sono numeri, stringhe, @dfn{strnum}
+o @dfn{regexp} fortemente tipizzate.
+La struttura @code{awk_value_t} rappresenta valori.
+Il campo @code{val_type} indica cosa contiene @code{union}.
+
+Rappresentare numeri @`e facile: l'API usa una variabile C di tipo
address@hidden Le stringhe richiedono
+uno sforzo maggiore. Poich@'e
address@hidden consente che le stringhe contengano dei byte @sc{nul}
+(a zeri binari) nel valore di una stringa, una stringa dev'essere
+rappresentata da una coppia di campi che contengono il puntatore al dato vero
+e proprio e la lunghezza della stringa.
address@hidden questo @`e il tipo @code{awk_string_t}.
+
+Un valore di tipo @dfn{strnum} (stringa numerica) @`e rappresentato come una
+stringa e consiste di dati in input forniti dall'utente che appaiono essere
+numerici.
+Quando una funzione di estensione crea un valore di tipo @dfn{strnum}, il
+risultato @`e una stringa che viene marcata come immessa dall'utente. La
+successiva analisi da parte di @command{gawk} address@hidden poi a determinare
se
+la stringa appare essere un numero, e va quindi trattata come @dfn{strnum},
+invece che come una normale stringa di caratteri.
+
address@hidden @`e utile nei casi un cui una funzione di estensione desideri
fare qualcosa
+di paragonabile alla funzione @code{split}, la quale imposta l'attributo
+di @dfn{strnum} agli elementi di vettore che crea.
+Per esempio, un'estensione che implementi la divisione di record CSV
+(Comma Separated Values, i cui elementi sono delimitati da virgole)
+potrebbe voler usare questa address@hidden Un'altra situazione in cui
address@hidden
address@hidden utile @`e quello di una funzione che richieda campi-dati ad una
banca di
+dati. La funzione @code{PQgetvalue()} della banca dati PostgreSQ, per
+esempio, restituisce una stringa che address@hidden essere numerica o di tipo
carattere,
+a seconda del contesto.
+
+I valori di @dfn{regexp} fortemente tipizzate
+(@pxref{Costanti @dfn{regexp} forti} non sono molto utili nelle funzioni di
+estensione. Le funzioni di estensione possono stabilire di averli ricevuti,
+e crearne, attribuendo valori di tipo scalare. In alternativa, @`e possibile
+esaminare il testo della @dfn{regexp} utilizzando campi @code{regex_value.str}
+e @code{regex_value.len}.
+
+Identificativi (address@hidden, nomi di variabili globali) possono essere
+associati sia a valori scalari che a vettori. Inoltre, @command{gawk}
+consente veri vettori di vettori, in cui ogni singolo elemento di un vettore
address@hidden a sua volta essere un vettore. La spiegazione dei vettori @`e
rinviata
address@hidden
+alla
address@hidden iftex
address@hidden
+a
address@hidden ifnottex
address@hidden di vettori}.
+
+La varie macro sopra elencate facilitano l'uso degli elementi delle
address@hidden come se
+fossero campi in una @code{struct}; @`e questa una pratica comunemente adottata
+nella scrittura di programmi in C. Questo tipo di codice @`e address@hidden
semplice da
+scrivere e da leggere, ma resta una address@hidden @emph{del programmatore}
+assicurarsi che il campo @code{val_type} rifletta correttamente il tipo
+del valore contenuto nella struttura @code{awk_value_t}.
+
+Dal punti di vista concettuale, i primi tre campi dell'@code{union} (numero,
+stringa, e vettore) sono sufficienti per lavorare con i valori @command{awk}.
+Tuttavia, poich@'e l'API fornisce routine per ottenere e modificare
+il valore di una variabile scalare globale usando solo il nome della
+variabile, si ha qui una perdita di efficienza: @command{gawk} deve cercare
+la variabile ogni volta che questa @`e utilizzata e modificata. Questo
address@hidden un probelma reale, non solo un problema teorico.
+
+Per questo motivo, se si sa che una certa estensione address@hidden molto tempo
+a leggere e/o modificare il valore di una o address@hidden variabili scalari,
si address@hidden
+ottenere uno @dfn{scalar address@hidden veda
address@hidden://catb.org/jargon/html/C/cookie.html, la voce ``cookie''
+nello Jargon file}
+per una definizione di @dfn{cookie}, e
address@hidden://catb.org/jargon/html/M/magic-cookie.html, la voce ``magic
cookie''
+sempre nello Jargon file} per un bell'esempio.
address@hidden FOR_PRINT
+Si veda anche la voce ``Cookie'' nel @ref{Glossario}.
address@hidden ifclear
address@hidden://jhanc.altervista.org/jargon/Intro.html, @`E disponibile in rete
+anche una traduzione italiana dello Jargon file}]
+}
+per quella variabile, e poi usare
+il @dfn{cookie} per ottenere il valore della variabile o per modificarne il
+valore.
+Il tipo @code{awk_scalar_t} contiene uno @dfn{scalar cookie}, e la macro
address@hidden fornisce accesso al valore di quel tipo
+nella struttura @code{awk_value_t}.
+Dato uno @dfn{scalar cookie}, @command{gawk} address@hidden trovare o
modificare
+direttamente il valore, come richiesto, senza bisogno di andarlo
+a cercare ogni volta.
+
+Il tipo @code{awk_value_cookie_t} e la macro @code{value_cookie} sono simili.
+Se si pensa di dover usare
+lo stesso @emph{valore} numerico o la stessa @emph{stringa} per una o
address@hidden
+variabili, si address@hidden creare il valore una volta per tutte, mettendo da
parte un
address@hidden@dfn{value cookie}} per quel valore, e in seguito specificare quel
address@hidden cookie} quando si desidera impostare il valore di una variabile.
address@hidden consente di risparmiare spazio in memoria all'interno del
processo
+di @command{gawk} e riduce il tempo richiesto per creare il valore.
+
address@hidden Funzioni di allocazione memoria
address@hidden Funzioni per allocare memoria e macro di servizio
address@hidden allocare memoria per estensioni
address@hidden memoria, allocare per estensioni
address@hidden estensioni, allocare memoria per
+
+L'API fornisce alcune funzioni per effettuare @dfn{allocazioni di memoria}
+che possono essere passate a @command{gawk}, e anche un certo numero di
+macro che possono tornare utili.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden le presenta come prototipi di funzione, nel modo
+con cui il codice dell'estensione potrebbe usarle:
+
address@hidden @code
address@hidden void *gawk_malloc(size_t size);
+Chiama la versione corretta di @code{malloc()} per allocare memoria,
+che address@hidden in seguito essere messa a disposizione di @command{gawk}.
+
address@hidden void *gawk_calloc(size_t nmemb, size_t size);
+Chiama la versione corretta di @code{calloc()} per allocare memoria che
+che address@hidden in seguito essere messa a disposizione di @command{gawk}.
+
address@hidden void *gawk_realloc(void *ptr, size_t size);
+Chiama la versione corretta di @code{realloc()} per allocare memoria
+che address@hidden in seguito essere messa a disposizione di @command{gawk}.
+
address@hidden void gawk_free(void *ptr);
+Chiama la versione corretta di @code{free()} per liberare memoria che
+era stata allocata con
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
address@hidden table
+
+L'API deve fornire queste funzioni perch@'e @`e possibile
+che un'estensione sia stata compilata e costruita usando una versione
+diversa della libreria C rispetto a quella usata per il programma eseguibile
address@hidden@footnote{Questo succede address@hidden spesso nei sistemi
MS-Windows,
+ma address@hidden capitare anche in sistemi di tipo Unix.}
+Se @command{gawk} usasse la propria versione di @code{free()} per liberare
+della memoria acquisita tramite una differente versione di @code{malloc()},
+il risultato sarebbe molto probabilmente differente da quello atteso.
+
+Due macro di address@hidden possono essere usate per allocare memoria
+tramite @code{gawk_malloc()} e
address@hidden()}. Se l'allocazione non riesce, @command{gawk}
+termina l'esecuzione con un messaggio di errore fatale.
+Queste macro dovrebbero essere usate come se fossero dei richiami a
+procedure che non restituiscono un codice di ritorno:
+
address@hidden @code
address@hidden #define emalloc(pointer, type, size, message) @dots{}
+Gli argomenti per questa macro sono i seguenti:
+
address@hidden nested table
address@hidden @code
address@hidden pointer
+La variabile di tipo puntatore che address@hidden alla memoria allocata.
+
address@hidden type
+Il tipo della variabile puntatore. Questo @`e usato per definire il tipo
+quando si chiama @code{gawk_malloc()}.
+
address@hidden size
+Il numero totale di byte da allocare.
+
address@hidden message
+Un messaggio da anteporre all'eventuale messaggio di errore fatale.
+Questo @`e solitamente il nome della funzione che sta usando la macro.
address@hidden table
+
address@hidden
+Per esempio, si potrebbe allocare il valore di una stringa
address@hidden@dotless{i}}:
+
address@hidden
+awk_value_t risultato;
+char *message;
+const char greet[] = "non v'allarmate!";
+
+emalloc(message, char *, sizeof(greet), "myfunc");
+strcpy(message, greet);
+make_malloced_string(message, strlen(message), & risultato);
address@hidden example
+
address@hidden #define erealloc(pointer, type, size, message) @dots{}
+Questo @`e simile a @code{emalloc()}, ma chiama @code{gawk_realloc()}
+invece che @code{gawk_malloc()}.
+Gli argomenti sono gli stessi della macro @code{emalloc()}.
address@hidden table
+
address@hidden Funzioni di costruzione
address@hidden Funzioni per creare valori
+
+L'API fornisce varie funzioni di @dfn{costruzione} per creare
+valori di tipo stringa e di tipo numerico, e anche varie macro di
address@hidden
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden le presenta tutte come prototipi di funzione, nel
+modo in cui il codice sorgente di
+un'estensione le userebbe:
+
address@hidden @code
address@hidden static inline awk_value_t *
address@hidden make_const_string(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione mette il valore di una stringa nella variabile
address@hidden puntata da @code{risultato}. La funzione presuppone che
address@hidden sia una costante stringa C
+(o altri dati che formano una stringa), e automaticamente crea una
address@hidden dei dati che address@hidden immagazzinata in @code{risultato}.
+Viene restituito il puntatore @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_malloced_string(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione mette il valore di una stringa nella variabile
address@hidden puntata da @code{risultato}. Si presuppone che
address@hidden sia un valore @samp{char *}
+che punta a dati ottenuti in precedenza per mezzo di
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
+L'idea @`e che questi dati siano comunicati direttamente a @command{gawk},
+che se ne assume la address@hidden
+Viene restituito il puntatore @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_null_string(awk_value_t *risultato);
+Questa funzione specializzata crea una stringa nulla (il valore ``undefined'')
+nella variabile @code{awk_value_t} puntata da @code{risultato}.
+Viene restituito il puntatore @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_number(double num, awk_value_t *risultato);
+Questa funzione crea semplicemente un valore numerico nella variabile
address@hidden, puntata da @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_const_user_input(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione @`e identica a @code{make_const_string()}, ma la stringa @`e
+marcata come input dell'utente, che address@hidden essere trattata come
@dfn{strnum}
+se il contenuto della stringa appare essere numerico.
+
address@hidden static inline awk_value_t *
address@hidden make_malloced_user_input(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione @`e identica a @code{make_malloced_string()}, ma la stringa @`e
+marcata come input dell'utente, che address@hidden essere trattata come
@dfn{strnum}
+se il contenuto della stringa appare essere numerico.
+
address@hidden static inline awk_value_t *
address@hidden make_const_regex(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione crea un valore di @dfn{regexp} fortemente tipizzata, allocando
una
+copia della stringa.
address@hidden @`e l'espressione regolare, di lunghezza @code{lunghezza}.
+
address@hidden static inline awk_value_t *
address@hidden make_malloced_regex(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione crea un valore di @dfn{regexp} fortemente tipizzata.
address@hidden @`e l'espressione regolare, di lunghezza @code{lunghezza}.
+Si aspetta che @code{stringa} sia un valore di tipo @samp{char *} che punta a
+dati ottenuti in precedenza tramite una chiamata a
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
+
address@hidden table
+
address@hidden Funzioni di registrazione
address@hidden Funzioni di registrazione
address@hidden registrazione di estensione
address@hidden estensione, registrazione di
+
+Questa @value{SECTION} descrive le funzioni dell'API per
+registrare parti di un'estensione con @command{gawk}.
+
address@hidden
+* Funzioni di estensione:: Registrare funzioni di estensione.
+* Funzioni di exit callback:: Registrare una exit di callback.
+* Stringa di versione Estensioni:: Registrare una stringa di versione.
+* Analizzatori di input:: Registrare un analizzatore di input.
+* Processori di output:: Registrare un processore di output.
+* Processori bidirezionali:: Registrare un processore bidirezionale.
address@hidden menu
+
address@hidden Funzioni di estensione
address@hidden Registrare funzioni di estensione
+
+Le funzioni di estensione sono descritte dal seguente tracciato record:
+
address@hidden
+typedef struct awk_ext_func @{
+@ @ @ @ const char *name;
+@ @ @ @ awk_value_t *(*const function)(int num_actual_args,
+@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_value_t *risultato,
+@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ struct
awk_ext_func *finfo);
+@ @ @ @ const size_t max_expected_args;
+@ @ @ @ const size_t min_required_args;
+@ @ @ @ awk_bool_t suppress_lint;
+@ @ @ @ void *data; /* puntatore di tipo opaco
+@ @ @ @ a ogni informazione ulteriore */
address@hidden awk_ext_func_t;
address@hidden example
+
+I campi sono:
+
address@hidden @code
address@hidden const char *name;
+Il nome della nuova funzione.
+Il codice sorgente a livello di @command{awk} richiama la funzione usando
+questo nome.
+Il nome @`e una normale stringa di caratteri del linguaggio C.
+
+I nomi di funzione devono rispettare le stesse regole che valgono per gli
+identificativi @command{awk}.
address@hidden, devono iniziare o con una lettera dell'alfabeto inglese o con un
+trattino basso, che possono essere seguiti da un numero qualsiasi di
+lettere, cifre o trattini bassi.
+L'uso di maiuscolo/minuscolo @`e significativo.
+
address@hidden awk_value_t *(*const function)(int num_actual_args,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_value_t *risultato,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
struct awk_ext_func *finfo);
+Questo @`e un puntatore alla funzione C che fornisce la address@hidden per cui
address@hidden stata scritta l'estensione.
+La funzione deve riempire l'area di memoria puntata da @code{*risultato} con
+un numero, con una stringa, oppure con una @dfn{regexp}.
address@hidden diventa il proprietario di tutte le stringhe di memoria.
+Come address@hidden detto sopra, la stringa di memoria @emph{deve} essere
stata ottenuta
+usando @code{gawk_malloc()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
+
+L'argomento @code{num_actual_args} dice alla funzione scritta in C quanti
+parametri sono stati effettivamente passati dal codice chiamante all'interno
+di @command{awk}.
+
+La funzione deve restituire il valore di @code{risultato}.
+Questo @`e per address@hidden del codice chiamante all'interno di
address@hidden
+
address@hidden size_t max_expected_args;
+Questo @`e il massimo numero di argomenti che la funzione si aspetta di
+ricevere.
+Se chiamata con un numero di argomenti maggiore di questo, e se @`e stato
+richiesto il controllo @dfn{lint}, @command{gawk} stampa un messaggio di
+avvertimento. Per ulteriori informazioni, si veda la descrizione di
address@hidden, address@hidden avanti in questa lista.
+
address@hidden const size_t min_required_args;
+Questo @`e il minimo numero di argomenti che la funzione si aspetta di
+ricevere.
+Se @`e chiamata con un numero inferiore di argomenti, @command{gawk}
+stampa un messaggio di errore fatale ed esce.
+
address@hidden awk_bool_t suppress_lint;
+Questo @dfn{flag} dice a @command{gawk} di non stampare un messaggio
address@hidden se @`e stato richiesto un controllo @dfn{lint} e se sono stati
+forniti address@hidden argomenti di quelli attesi. Una funzione di estensione
address@hidden
+stabilire se @command{gawk} ha address@hidden stampato almeno uno di tali
messaggi
+controllando se @samp{num_actual_args > finfo->max_expected_args}.
+In tal caso, se la funzione non desidera la stampa di ulteriori messaggi,
+dovrebbe impostare @code{finfo->suppress_lint} a @code{awk_true}.
+
address@hidden void *data;
+Questo @`e un puntatore di tipo opaco a tutti quei dati che una funzione
+di estensione desidera avere disponibili al momento della chiamata.
+Passando alla funzione di estensione la struttura @code{awk_ext_func_t}
+e avendo al suo interno questo puntatore disponibile, rende possibile
+scrivere un'unica funzione C o C++ che implementa address@hidden di una
funzione
+di estensione a livello @command{awk}.
address@hidden table
+
+Una volta preparato un record che descrive l'estensione, la funzione di
+estensione va registrata con @command{gawk} usando questa funzione dell'API:
+
address@hidden @code
address@hidden awk_bool_t add_ext_func(const char *namespace, awk_ext_func_t
*func);
+Questa funzione restituisce il valore @dfn{true} se ha successo,
+oppure @dfn{false} in caso contrario.
+Il parametro @code{namespace} non @`e usato per ora; dovrebbe puntare a una
+stringa vuota (@code{""}). Il puntatore @code{func} @`e l'indirizzo di una
address@hidden che rappresenta la funzione stessa, come descritto sopra.
+
address@hidden non modifica address@hidden che @`e puntato da @code{func}, ma la
+funzione di estensione stessa riceve questo puntatore e address@hidden
modificarlo
+e farlo puntare altrove, quindi il puntatore non @`e stato dichiarato
+di tipo costante (@code{const}).
address@hidden table
+
+La combinazione di @code{min_required_args}, @code{max_expected_args},
+e @code{suppress_lint} address@hidden ingenerare confusione. Ecco delle
linee-guida
+sul da farsi.
+
address@hidden @asis
address@hidden Un numero qualsiasi di argomenti @`e valido
+Impostare @code{min_required_args} and @code{max_expected_args} a zero e
+impostare @code{suppress_lint} ad @code{awk_true}.
+
address@hidden Un numero minimo di argomenti @`e richiesto, ma non c'@`e un
limite al numero massimo
+Impostare @code{min_required_args} al minimo richiesto.
+Impostare @code{max_expected_args} a zero e
+impostare @code{suppress_lint} ad @code{awk_true}.
+
address@hidden Un numero minino di argomenti @`e richiesto, ma c'@`e un limite
al numero massimo
+Impostare @code{min_required_args} al minimo richiesto.
+Impostare @code{max_expected_args} al massimo atteso.
+Impostare @code{suppress_lint} ad @code{awk_false}.
+
address@hidden Un numero minino di argomenti @`e richiesto, ma c'@`e un numero
massimo non superabile
+Impostare @code{min_required_args} al minimo richiesto.
+Impostare @code{max_expected_args} al massimo atteso.
+Impostare @code{suppress_lint} ad @code{awk_false}.
+Nella funzione di estensione, controllare che @code{num_actual_args} non
+ecceda @code{f->max_expected_args}. Se il massimo @`e superato, stampare
+un messaggio di errore fatale.
address@hidden table
+
address@hidden Funzioni di exit callback
address@hidden Registrare una funzione @dfn{exit callback}
+
+Una funzione @dfn{exit callback} @`e una funzione che @command{gawk} invoca
+prima di completare l'esecuzione del programma.
+Siffatte funzioni sono utili se ci sono dei compiti generali di ``pulizia''
+che dovrebbero essere effettuati nell'estensione (come chiudere connessioni a
+un @dfn{database} o rilasciare altre risorse).
+Si address@hidden registrare una tale
+funzione con @command{gawk} per mezzo della seguente funzione:
+
address@hidden @code
address@hidden void awk_atexit(void (*funcp)(void *data, int exit_status),
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ void *arg0);
+I parametri sono:
+
address@hidden nested table
address@hidden @code
address@hidden funcp
+Un puntatore alla funzione da chiamare prima che @command{gawk} completi
+l'esecuzione. Il parametro @code{data}
address@hidden il valore originale di @code{arg0}.
+Il parametro @code{exit_status} @`e il valore del codice di ritorno che
address@hidden intende passare alla chiamata di sistema @code{exit()}
+(che termina l'esecuzione del programma).
+
address@hidden arg0
+Un puntatore a un'area dati privata che @command{gawk} mantiene perch@'e
+sia poi passata alla funzione puntata da @code{funcp}.
address@hidden table
address@hidden table
+
+Le funzioni @dfn{exit callback} sono chiamate in ordine inverso rispetto
+a quello con cui @`e stata fatta la registrazione con @command{gawk}
+(LIFO: Last In, First Out).
+
address@hidden Stringa di versione Estensioni
address@hidden Registrare una stringa di versione per un'estensione
+
+Si address@hidden registrare una stringa di versione che indica il nome e la
versione
+di una data estensione a @command{gawk}, come segue:
+
address@hidden @code
address@hidden void register_ext_version(const char *version);
+Registra la stringa puntata da @code{version} con @command{gawk}.
+Si noti che @command{gawk} @emph{non} copia la stringa @code{version}, e
+quindi questa stringa non dovrebbe essere modificata.
address@hidden table
+
address@hidden stampa tutte le stringhe con le versioni di estensione
+registrate, quando viene invocato specificando l'opzione @option{--version}.
+
address@hidden Analizzatori di input
address@hidden Analizzatori di input personalizzati
address@hidden personalizzato, analizzatore di input
address@hidden analizzatore di input personalizzato
address@hidden input, analizzatore di, personalizzato
+
+Per default, @command{gawk} legge file di testo come input. Il valore della
+variabile @code{RS} @`e usato per determinare la fine di un record, e subito
+dopo la variabile @code{FS} (o @code{FIELDWIDTHS} o @code{FPAT}) viene usata
+per suddividerlo in campi
address@hidden
+(@pxrefil{Leggere file}).
address@hidden iftex
address@hidden
+(@pxref{Leggere file}).
address@hidden ifnottex
+Viene inoltre impostato il valore di @code{RT}
+(@pxref{Variabili predefinite}).
+
+Se lo si desidera, @`e possibile fornire un analizzatore di input
+personalizzato. Il compito di un analizzatore di input @`e di restituire un
+record al codice di @command{gawk}, che poi lo address@hidden, accompagnato,
+se necessario, da indicatori del valore e della lunghezza dei dati da usare
+per @code{RT}.
+
+Per fornire un analizzatore personalizzato di input, occorre innanzitutto
+rendere disponibili due funzioni (dove @var{XXX} @`e un nome che fa da prefisso
+all'estensione intera):
+
address@hidden @code
address@hidden awk_bool_t @var{XXX}_can_take_file(const awk_input_buf_t *iobuf);
+Questa funzione esamina l'informazione disponibile in @code{iobuf}
+(che vedremo tra poco). Basandosi su tale informazione,
+decide se l'analizzatore di input personalizzato address@hidden usato per
questo file.
+Se questo @`e il caso, dovrebbe restituire @dfn{true}. Altrimenti,
address@hidden
address@hidden Nessuno stato (valori di variabili, etc.) dovrebbe venire
+modificato all'interno di @command{gawk}.
+
address@hidden awk_bool_t @var{XXX}_take_control_of(awk_input_buf_t *iobuf);
+Quando @command{gawk} decide di passare il controllo del file a questo
+analizzatore di input, address@hidden questa funzione.
+Questa funzione a sua volta deve assegnare un valore ad alcuni campi
+nella struttura @code{awk_input_buf_t} e assicurarsi che
+alcune condizioni siano verificate. Dovrebbe poi restituire @dfn{true}.
+Se si verifica un errore di qualche tipo, i campi in questione non dovrebbero
+venire riempiti, e la funzione dovrebbe restituire @dfn{false}; in questo caso
address@hidden non address@hidden address@hidden l'analizzatore personalizzato
di input.
+I dettagli sono descritti address@hidden avanti.
address@hidden table
+
+L'estensione dovrebbe raccogliere queste funzioni all'interno di una
+struttura @code{awk_input_parser_t}, simile a questa:
+
address@hidden
+typedef struct awk_input_parser @{
+ const char *name; /* nome dell'analizzatore */
+ awk_bool_t (*can_take_file)(const awk_input_buf_t *iobuf);
+ awk_bool_t (*take_control_of)(awk_input_buf_t *iobuf);
+ awk_const struct awk_input_parser *awk_const next; /* per uso
+ di gawk */
address@hidden awk_input_parser_t;
address@hidden example
+
+I campi sono:
+
address@hidden @code
address@hidden const char *name;
+Il nome dell'analizzatore di input. Questa @`e una normale stringa di
caratteri
+del linguaggio C.
+
address@hidden awk_bool_t (*can_take_file)(const awk_input_buf_t *iobuf);
+Un puntatore alla funzione @address@hidden()}.
+
address@hidden awk_bool_t (*take_control_of)(awk_input_buf_t *iobuf);
+Un puntatore alla funzione @address@hidden()}.
+
address@hidden awk_const struct input_parser *awk_const next;
+Questa struttura @`e per uso di @command{gawk};
+per questo motivo @`e marcata @code{awk_const} in modo che l'estensione non
+possa modificarla.
address@hidden table
+
+I passi da seguire sono i seguenti:
+
address@hidden
address@hidden
+Creare una variabile @code{static awk_input_parser_t} e inizializzarla
+adeguatamente.
+
address@hidden
+Quando l'estensione @`e caricata, registrare l'analizzatore personalizzato di
+input con @command{gawk} usando la funzione API @code{register_input_parser()}
+(descritta address@hidden sotto).
address@hidden enumerate
+
+La definizione di una struttura @code{awk_input_buf_t} @`e simile a questa:
+
address@hidden
+typedef struct awk_input @{
+ const char *name; /* nome file */
+ int fd; /* descrittore di file */
+#define INVALID_HANDLE (-1)
+ void *opaque; /* area dati privata
+ per l'analizzatore di input */
+ int (*get_record)(char **out, struct awk_input *iobuf,
+ int *errcode, char **rt_start, size_t *rt_len);
+ ssize_t (*read_func)();
+ void (*close_func)(struct awk_input *iobuf);
+ struct stat sbuf; /* buffer per stat */
address@hidden awk_input_buf_t;
address@hidden example
+
+I campi si possono dividere in due categorie: quelli che sono usati (almeno
+inizialmente) da @address@hidden()}, e quelli che sono usati da
address@hidden@var{XXX}_take_control_of()}. Il primo gruppo di campi, e il
loro uso,
address@hidden address@hidden@dotless{i}} definito:
+
address@hidden @code
address@hidden const char *name;
+Il nome del file.
+
address@hidden int fd;
+Un descrittore di file per il file. Se @command{gawk} riesce ad aprire
+il file, il valore di @code{fd} @emph{non} address@hidden uguale a
address@hidden [descrittore non valido]. In caso contrario,
+quello address@hidden il valore.
+
address@hidden struct stat sbuf;
+Se il descrittore di file @`e valido, @command{gawk} address@hidden riempito i
campi di
+questa struttura invocando la chiamata di sistema @code{fstat()}.
address@hidden table
+
+La funzione @address@hidden()} dovrebbe esaminare i campi di
+cui sopra e decidere se l'analizzatore di input vada usato per il file.
+La decisione address@hidden dipendere da uno stato di @command{gawk} (il valore
+di una variabile definita in precedenza dall'estensione e impostata dal
+codice @command{awk}), dal nome del
+file, dal fatto che il descrittore di file sia valido o no,
+dalle informazioni contenute in @code{struct stat} o da una qualsiasi
+combinazione di questi fattori.
+
+Una volta che @address@hidden()} restituisce @dfn{true}, e
address@hidden ha deciso di usare l'analizzatore personalizzato, viene
+chiamata la funzione @address@hidden()}. Tale funzione
+si occupa di riempire il campo @code{get_record} oppure il campo
address@hidden nella struttura @code{awk_input_buf_t}. La funzione si
+assicura inoltre che @code{fd} @emph{not} sia impostato al valore
address@hidden L'elenco seguente descrive i campi che
+possono essere riempiti da @address@hidden()}:
+
address@hidden @code
address@hidden void *opaque;
+Questo campo @`e usato per contenere qualiasi informazione di stato sia
+necessaria per l'analizzatore di input
+riguardo a questo file. Il campo @`e ``opaco'' per @command{gawk}.
+L'analizzatore di input non @`e obbligato a usare questo puntatore.
+
address@hidden int@ (*get_record)(char@ **out,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ struct@ awk_input *iobuf,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ int *errcode,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ char **rt_start,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ size_t *rt_len);
+Questo puntatore a funzione dovrebbe puntare a una funzione che crea i record
+in input. Tale funzione @`e il nucleo centrale dell'analizzatore di input.
+Il suo modo di operare @`e descritto nel testo che segue questo elenco.
+
address@hidden ssize_t (*read_func)();
+Questo puntatore a funzione dovrebbe puntare a una funzione che ha lo
+stesso comportamento della chiamata di sistema standard POSIX @code{read()}.
address@hidden in alternativa al puntatore a @code{get_record}. Il relativo
comportamento
address@hidden pure descritto nel testo che segue quest'elenco.
+
address@hidden void (*close_func)(struct awk_input *iobuf);
+Questo puntatore a funzione dovrebbe puntare a una funzione che fa
+la ``pulizia finale''. Dovrebbe liberare ogni risorsa allocata da
address@hidden@var{XXX}_take_control_of()}. address@hidden anche chiudere il
file. Se lo fa,
+dovrebbe impostare il campo @code{fd} a @code{INVALID_HANDLE}.
+
+Se @code{fd} @`e ancora diverso da @code{INVALID_HANDLE} dopo la chiamata a
+questa funzione, @command{gawk} invoca la normale chiamata di sistema
address@hidden()}.
+
+Avere una funzione di ``pulizia'' @`e facoltativo. Se l'analizzatore di input
+non ne ha bisogno, basta non impostare questo campo. In questo caso,
address@hidden invoca la normale chiamata di sistema @code{close()} per il
+descrittore di file, che, quindi, dovrebbe essere valido.
address@hidden table
+
+La funzione @address@hidden()} svolge il lavoro di creazione dei
+record in input. I parametri sono i seguenti:
+
address@hidden @code
address@hidden char **out
+Questo @`e un puntatore a una variabile @code{char *} che @`e impostatata in
modo
+da puntare al record. @command{gawk} usa una sua copia locale dei dati,
+quindi l'estensione deve gestire la relativa area di memoria.
+
address@hidden struct awk_input *iobuf
+Questa @`e la struttura @code{awk_input_buf_t} per il file. I campi dovrebbero
+essere usati per leggere i dati (@code{fd}) e per gestire lo stato privato
+(@code{opaque}), se necessario.
+
address@hidden int *errcode
+Se si verifica un errore, @code{*errcode} dovrebbe essere impostato a un
+valore appropriato tra quelli contenuti in @code{<errno.h>}.
+
address@hidden char **rt_start
address@hidden size_t *rt_len
+Se il concetto ``fine record'' @`e applicabile,
address@hidden dovrebbe essere impostato per puntare ai dati da usare come
address@hidden, e @code{*rt_len} dovrebbe essere impostata alla lunghezza di
quel
+campo. In caso contrario, @code{*rt_len} dovrebbe essere impostata a zero.
address@hidden usa una sua copia di questi dati, quindi l'estensione deve
+gestire tale memoria.
address@hidden table
+
+Il codice di ritorno @`e la lunghezza del buffer puntato da
address@hidden oppure @code{EOF}, se @`e stata raggiunta la fine del file o se
+si @`e verificato un errore.
+
+Poich@'e @code{errcode} @`e sicuramente un puntatore valido, non c'@`e
+bisogno di controllare che il valore sia @code{NULL}. @command{gawk}
+imposta @code{*errcode} a zero, quindi non c'@`e bisogno di impostarlo, a meno
+che non si verifichi un errore.
+
+In presenza di un errore, la funzione dovrebbe restituire @code{EOF} e
+impostare @code{*errcode} a un valore maggiore di zero. In questo caso, se
address@hidden non @`e uguale a zero, @command{gawk} automaticamente aggiorna
+la variabile @code{ERRNO} usando il valore contenuto in @code{*errcode}.
+(In generale, impostare @samp{*errcode = errno} dovrebbe essere la
+cosa giusta da fare.)
+
+Invece di fornire una funzione che restituisce un record in input,
address@hidden possibile fornirne una che semplicemente legge dei byte, e lascia
+che sia @command{gawk} ad analizzare i dati per farne dei record. In questo
+caso, i dati dovrebbero essere restituiti nella codifica multibyte propria
+della localizzazione corrente.
+Una siffatta funzione dovrebbe imitare il comportamento della chiamata di
+sistema @code{read()}, e riempire il puntatore @code{read_func} con
+il proprio indirizzo nella struttura @code{awk_input_buf_t}.
+
+Per default, @command{gawk} imposta il puntatore @code{read_func} in modo che
+punti alla chiamata di sistema @code{read()}. In questo modo l'estensione
+non deve preoccuparsi di impostare esplicitamente questo campo.
+
address@hidden NOTA
+Occorre decidere per l'uno o per l'altro metodo: o una funzione che
+restituisce un record o una che restituisce dei dati grezzi. Nel dettaglio,
+se si fornisce una funzione che prepara un record, @command{gawk} la
address@hidden, e non address@hidden mai la funzione che fa una lettura grezza.
address@hidden quotation
+
address@hidden viene distribuito con un'estensione di esempio che legge
+delle directory, restituendo un record per ogni elemento contenuto nella
+directory (@pxref{Esempio di estensione Readdir}. Questo codice sorgente
address@hidden
+essere usato come modello per scrivere un analizzatore di input
+personalizzato.
+
+Quando si scrive un analizzatore di input, si dovrebbe progettare (e
+documentare) il modo con cui si suppone che interagisca con il codice
address@hidden Si address@hidden scegliere di utilizzarlo per tutte le
letture, e
+intervenire solo quando @`e necessario, (come fa l'estensione di
+esempio @code{readdir}). Oppure lo si address@hidden utilizzare a seconda del
+valore preso da una variabile @command{awk}, come fa l'estensione XML
+inclusa nel progetto @code{gawkextlib} (@pxref{gawkextlib}).
+In quest'ultimo caso, il codice in una regola @code{BEGINFILE}
address@hidden controllare @code{FILENAME} ed @code{ERRNO} per decidere se
+attivare un analizzatore di input (@pxref{BEGINFILE/ENDFILE}) oppure no.
+
+Un analizzatore di input va registrato usando la seguente funzione:
+
address@hidden @code
address@hidden void register_input_parser(awk_input_parser_t *input_parser);
+Registra l'analizzatore di input puntato da @code{input_parser} con
address@hidden
address@hidden table
+
address@hidden Processori di output
address@hidden Registrare un processore di output
address@hidden personalizzato, processore di output
address@hidden processore di output personalizzato
address@hidden output, processore di, personalizzato
+
address@hidden processore di output
address@hidden output, processore di
+Un @dfn{processore di output} @`e l'immagine riflessa di un
+analizzatore di input.
+Consente a un'estensione di prendere il controllo dell'output
+indirizzato verso un file
+che sia stato aperto con gli operatori di ridirezione di I/O
address@hidden>} o @samp{>>} (@pxref{Ridirezione}).
+
+Il processore di output @`e molto simile, come struttura,
+all'analizzatore di input:
+
address@hidden
+typedef struct awk_output_wrapper @{
+ const char *name; /* nome del processore */
+ awk_bool_t (*can_take_file)(const awk_output_buf_t *outbuf);
+ awk_bool_t (*take_control_of)(awk_output_buf_t *outbuf);
+ awk_const struct awk_output_wrapper *awk_const next; /* per gawk */
address@hidden awk_output_wrapper_t;
address@hidden example
+
+I campi sono i seguenti:
+
address@hidden @code
address@hidden const char *name;
+Questo @`e il nome del processore di output.
+
address@hidden awk_bool_t (*can_take_file)(const awk_output_buf_t *outbuf);
+Questo @`e il puntatore a una funzione che esamina l'informazione contenuta
+nella struttura @code{awk_output_buf_t} puntata da @code{outbuf}.
+Dovrebbe restituire @dfn{true} se il processore di output vuole elaborare
+il file, e @dfn{false} in caso contrario.
+Nessuno stato (valori di variabili, etc.) dovrebbe essere modificato
+all'interno di @command{gawk}.
+
address@hidden awk_bool_t (*take_control_of)(awk_output_buf_t *outbuf);
+La funzione puntata da questo campo viene chiamata quando @command{gawk}
+decide di consentire al processore di output di prendere il controllo del file.
+Dovrebbe riempire in maniera appropriata dei campi nella struttura
address@hidden, come descritto sotto, e restituire @dfn{true} se
+ha successo, @dfn{false} in caso contrario.
+
address@hidden awk_const struct output_wrapper *awk_const next;
+Questa struttura @`e per uso di @command{gawk};
+per questo motivo @`e marcata @code{awk_const} in modo che l'estensione non
+possa modificarlo.
address@hidden table
+
+La struttura @code{awk_output_buf_t} @`e simile a questa:
+
address@hidden
+typedef struct awk_output_buf @{
+ const char *name; /* nome del file in output */
+ const char *mode; /* argomento @dfn{mode} per fopen */
+ FILE *fp; /* puntatore stdio file */
+ awk_bool_t redirected; /* @dfn{true} se un processore @`e attivo */
+ void *opaque; /* per uso del processore di output */
+ size_t (*gawk_fwrite)(const void *buf, size_t size, size_t count,
+ FILE *fp, void *opaque);
+ int (*gawk_fflush)(FILE *fp, void *opaque);
+ int (*gawk_ferror)(FILE *fp, void *opaque);
+ int (*gawk_fclose)(FILE *fp, void *opaque);
address@hidden awk_output_buf_t;
address@hidden example
+
+Anche qui, l'estensione address@hidden le funzioni @address@hidden()}
+e @address@hidden()} che esaminano e aggiornano
+campi dati in @code{awk_output_buf_t}.
+I campi dati sono i seguenti:
+
address@hidden @code
address@hidden const char *name;
+Il nome del file in output.
+
address@hidden const char *mode;
+La stringa @dfn{mode} (come sarebbe usata nel secondo argomento della
+chiamata di sistema @code{fopen()})
+con cui il file era stato aperto.
+
address@hidden FILE *fp;
+Il puntatore @code{FILE} da @code{<stdio.h>}. @command{gawk} apre il file
+prima di controllare se esiste un processore di output.
+
address@hidden awk_bool_t redirected;
+Questo campo dev'essere impostato a @dfn{true} dalla funzione
address@hidden@var{XXX}_take_control_of()}.
+
address@hidden void *opaque;
+Questo puntatore @`e opaco per @command{gawk}. L'estensione dovrebbe usarlo
+per contenere un puntatore a qualsiasi dato privato associato al file.
+
address@hidden size_t (*gawk_fwrite)(const void *buf, size_t size, size_t count,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ FILE *fp, void
*opaque);
address@hidden int (*gawk_fflush)(FILE *fp, void *opaque);
address@hidden int (*gawk_ferror)(FILE *fp, void *opaque);
address@hidden int (*gawk_fclose)(FILE *fp, void *opaque);
+Questi puntatori dovrebbero essere impostati per puntare a funzioni
+la cui azione sia equivalente a quella delle funzioni di @code{<stdio.h>},
+se questo @`e cio che si desidera.
address@hidden usa questi puntatori a funzione per @emph{tutti} gli output.
address@hidden inizializza i puntatori per puntare a funzioni interne
+``di passaggio'' che si limitano a chiamare le funzioni normali di
address@hidden<stdio.h>}, e quindi un'estensione deve ridefinire solo le
funzioni
+appropriate per fare il lavoro richiesto.
address@hidden table
+
+La funzione @address@hidden()} dovrebbe decidere in base ai
+campi @code{name} e @code{mode}, e a ogni altro ulteriore indicatore di stato
+(p.es., valori di variabili @command{awk}) adatto allo scopo.
+
+Quando @command{gawk} chiama @address@hidden()}, la funzione
+dovrebbe riempire i rimanenti campi
+in modo opportuno, tranne che per @code{fp}, che dovrebbe essere usato
+normalmente.
+
+Il processore di output va registrato usando la seguente funzione:
+
address@hidden @code
address@hidden void register_output_wrapper(awk_output_wrapper_t
*output_wrapper);
+Registra il processore di output puntato da @code{output_wrapper} con
address@hidden
address@hidden table
+
address@hidden Processori bidirezionali
address@hidden Registrare un processore bidirezionale
address@hidden personalizzato, processore bidirezionale
address@hidden processore bidirezionale personalizzato
address@hidden bidirezionale, processore personalizzato
+
+Un @dfn{processore bidirezionale} combina un analizzatore di input e
+un processore di output per un I/O
+bidirezionale usando l'operatore @samp{|&} (@pxref{Ridirezione}).
+Le strutture @code{awk_input_parser_t} e @code{awk_output_buf_t}
+sono usate nella maniera address@hidden descritta precedentemente.
+
+Un processore bidirezionale @`e rappresentato dalla struttura seguente:
+
address@hidden
+typedef struct awk_two_way_processor @{
+ const char *name; /* nome del processore bidirezionale */
+ awk_bool_t (*can_take_two_way)(const char *name);
+ awk_bool_t (*take_control_of)(const char *name,
+ awk_input_buf_t *inbuf,
+ awk_output_buf_t *outbuf);
+ awk_const struct awk_two_way_processor *awk_const next; /* per gawk */
address@hidden awk_two_way_processor_t;
address@hidden example
+
+I campi sono i seguenti:
+
address@hidden @code
address@hidden const char *name;
+Il nome del processore bidirezionale.
+
address@hidden awk_bool_t (*can_take_two_way)(const char *name);
+La funzione puntata da questo campo dovrebbe restituire @dfn{true} se
+vuole gestire l'I/O bidirezionale per questo @value{FN}.
+La funzione non dovrebbe modificare alcuno stato (valori di variabili, etc.)
+all'interno di @command{gawk}.
+
address@hidden awk_bool_t (*take_control_of)(const char *name,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_input_buf_t *inbuf,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_output_buf_t *outbuf);
+La funzione puntata da questo campo dovrebbe riempire le strutture
address@hidden e @code{awk_output_buf_t} puntate da @code{inbuf} e
address@hidden, rispettivamente. Queste strutture sono address@hidden state
descritte
+in precedenza.
+
address@hidden awk_const struct two_way_processor *awk_const next;
+Questa struttura @`e per uso di @command{gawk};
+per questo motivo @`e marcata @code{awk_const} in modo che l'estensione non
+possa modificarla.
address@hidden table
+
+Come per l'analizzatore di input e il processore di output, vanno fornite le
+funzione address@hidden@dotless{i}}, ci penso io'' e ``per questo, fai tu'',
address@hidden@var{XXX}_can_take_two_way()} e @address@hidden()}.
+
+Il processore bidirezionale va registrato usando la seguente funzione:
+
address@hidden @code
address@hidden void register_two_way_processor(awk_two_way_processor_t
*two_way_processor);
+Registra il processore bidirezionale puntato da @code{two_way_processor} con
address@hidden
address@hidden table
+
address@hidden Stampare messaggi
address@hidden Stampare messaggi dalle estensioni
address@hidden stampare messaggi dalle estensioni
address@hidden messaggi, stampare dalle estensioni
address@hidden estensioni, stampare messaggi dalle
+
address@hidden possibile stampare diversi tipi di messaggi di avvertimento da
+un'estensione, come qui spiegato. Si noti che, per queste funzioni,
+si deve fornire l'ID di estensione ricevuto da @command{gawk}
+al momento in cui l'estensione @`e stata caricata:@footnote{Poich@'e l'API usa
solo
address@hidden previste dal
+compilatore ISO C 90, non @`e possibile usare le macro di tipo variadico
+(che accettano un numero variabile di argomenti) disponibili nel compilatore
+ISO C 99, che nasconderebbero quel parametro. Un vero peccato!}
+
address@hidden @code
address@hidden void fatal(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio e poi @command{gawk} termina immediatamente l'esecuzione.
+
address@hidden void nonfatal(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio di errore non-fatale.
+
address@hidden void warning(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio di avvertimento.
+
address@hidden void lintwarn(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio di avvertimento ``lint''. Normalmente questo equivale a
+stampare un messaggio di avvertimento, ma se @command{gawk} era stato
+invocato specificando l'opzione @samp{--lint=fatal},
+gli avvertimenti di @dfn{lint} diventano messaggi di errore fatali.
address@hidden table
+
+Tutte queste funzioni sono per il resto simili alla famiglia di funzioni
address@hidden()} del linguaggio C, dove il parametro @code{format} @`e una
+stringa contenente dei caratteri normali e delle istruzioni di formattazione,
+mischiati tra loro.
+
address@hidden Aggiornare @code{ERRNO}
address@hidden Funzioni per aggiornare @code{ERRNO}
+
+Le seguenti funzioni consentono l'aggiornamento della variabile
address@hidden:
+
address@hidden @code
address@hidden void update_ERRNO_int(int errno_val);
+Imposta @code{ERRNO} alla stringa equivalente del codice di errore
+in @code{errno_val}. Il valore dovrebbe essere uno dei codici di errore
+definiti in @code{<errno.h>}, e @command{gawk} lo trasforma in una stringa
+(qualora possibile, tradotta) usando la funzione C @code{strerror()}.
+
address@hidden void update_ERRNO_string(const char *string);
+Imposta @code{ERRNO} direttamente usando il valore della stringa specificata.
address@hidden fa una copia del valore di @code{stringa}.
+
address@hidden void unset_ERRNO(void);
+Annulla il valore di @code{ERRNO}.
address@hidden table
+
address@hidden Richiedere valori
address@hidden Richiedere valori
+
+Tutte le funzioni che restituiscono valori da @command{gawk}
+funzionano allo stesso modo. Si fornisce un campo @code{awk_valtype_t}
+per indicare il tipo di valore che ci si aspetta. Se il valore disponibile
+corrisponde a quello richiesto, la funzione restituisce @dfn{true} e riempie
+il campo del risultato @code{awk_value_t}.
+Altrimenti, la funzione restituisce @dfn{false}, e il campo @code{val_type}
+indica il tipo di valore disponibile.
+A quel punto si address@hidden, a seconda di quel che richiede la situazione,
+stampare un messaggio di errore oppure ripetere la
+richiesta specificando il tipo di valore che risulta disponibile. Questo
+comportamento @`e riassunto nella
address@hidden
+
address@hidden Tabella,table-value-types-returned
address@hidden di valori restituiti dall'API}
address@hidden
+<informaltable>
+<tgroup cols="8">
+ <colspec colname="c1"/>
+ <colspec colname="c2"/>
+ <colspec colname="c3"/>
+ <colspec colname="c4"/>
+ <colspec colname="c5"/>
+ <colspec colname="c6"/>
+ <colspec colname="c7"/>
+ <colspec colname="c8"/>
+ <spanspec spanname="hspan" namest="c3" nameend="c8" align="center"/>
+ <thead>
+ <row><entry></entry><entry spanname="hspan"><para>Tipo di valore
reale</para></entry></row>
+ <row>
+ <entry></entry>
+ <entry></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Regexp</para></entry>
+ <entry><para>Vettore</para></entry>
+ <entry><para>Indefinito</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Stringa</emphasis></para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Strnum</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Numero</emphasis></para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry><para><emphasis role="bold">Tipo</emphasis></para></entry>
+ <entry><para><emphasis role="bold">Regexp</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>Regexp</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry><para><emphasis role="bold">Richiesto</emphasis></para></entry>
+ <entry><para><emphasis role="bold">Vettore</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>Vettore</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Scalare</emphasis></para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Indefinito</emphasis></para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Regexp</para></entry>
+ <entry><para>Vettore</para></entry>
+ <entry><para>Indefinito</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">@dfn{Value
cookie}</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ </tbody>
+</tgroup>
+</informaltable>
address@hidden docbook
+
address@hidden
address@hidden
address@hidden @columnfractions .50 .50
address@hidden @tab Tipo di valore reale
address@hidden multitable
address@hidden 10/2014: Thanks to Karl Berry for this bit to reduce the space:
address@hidden
+\vglue-1.1\baselineskip
address@hidden tex
address@hidden @multitable @columnfractions .166 .166 .198 .15 .15 .166
address@hidden SMALLPRINT
address@hidden {Richiesto} {Indefinito} {Numero} {Numero} {Scalar} {Regexp}
{Vettore} {Indefinito}
address@hidden @tab @tab Stringa @tab Strnum @tab Numero @tab Regexp @tab
Vettore @tab Indefinito
address@hidden @tab @b{Stringa} @tab Stringa @tab Stringa @tab Stringa @tab
Stringa @tab false @tab false
address@hidden @tab @b{Strnum} @tab false @tab Strnum @tab Strnum @tab false
@tab false @tab false
address@hidden @tab @b{Numero} @tab Numero @tab Numero @tab Numero @tab false
@tab false @tab false
address@hidden @b{Tipo} @tab @b{Regexp} @tab false @tab false @tab false @tab
Regexp @tab false @tab false
address@hidden @b{Richiesto} @tab @b{Vettore} @tab false @tab false @tab false
@tab false @tab Vettore @tab false
address@hidden @tab @b{Scalar} @tab Scalar @tab Scalar @tab Scalar @tab Scalar
@tab false @tab false
address@hidden @tab @b{Indefinito} @tab Stringa @tab Strnum @tab Numero @tab
Regexp @tab Vettore @tab Indefinito
address@hidden @tab @b{Value cookie} @tab false @tab false @tab false @tab
false @tab false @tab false
address@hidden multitable
address@hidden ifclear
+
address@hidden SMALLPRINT
address@hidden
address@hidden {Richiesto} {Value cookie} {Num.} {Num.} {Scal.} {Regexp}
{Vett.} {Indef.}
address@hidden @tab @tab String @tab Strn. @tab Num. @tab Regexp @tab Vett.
@tab Indef.
address@hidden @tab @b{Stringa} @tab String @tab String @tab String @tab String
@tab false @tab false
address@hidden @tab @b{Strnum} @tab false @tab Strn. @tab Strn. @tab false @tab
false @tab false
address@hidden @tab @b{Numero} @tab Num. @tab Num. @tab Num. @tab false @tab
false @tab false
address@hidden @b{Tipo} @tab @b{Regexp} @tab false @tab false @tab false @tab
Regexp @tab false @tab false
address@hidden @b{Richiesto} @tab @b{Vettore} @tab false @tab false @tab false
@tab false @tab Vett. @tab false
address@hidden @tab @b{Scalar} @tab Scal. @tab Scal. @tab Scal. @tab Scal. @tab
false @tab false
address@hidden @tab @b{Indefinito} @tab String @tab Strn. @tab Num. @tab Regexp
@tab Vett. @tab Indef.
address@hidden @tab @b{Value cookie} @tab false @tab false @tab false @tab
false @tab false @tab false
address@hidden multitable
address@hidden smallformat
address@hidden ifset
address@hidden ifnotdocbook
address@hidden ifnotplaintext
address@hidden
address@hidden
+
+-------------------------------------------------------+
+ | Tipo di valore reale:
|
+
+--------+--------+--------+--------+-------+-----------+
+ | Stringa| Strnum | Numero | Regexp |Vettore|
Indefinito|
++-----------+-----------+--------+--------+--------+--------+-------+-----------+
+| | Stringa | Stringa| Stringa| Stringa| Stringa| false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Strnum | false | Strnum | Strnum | false | false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Numero | Numero | Numero | Numero | false | false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Regexp | false | false | false | Regexp | false | false
|
+| Tipo
+-----------+--------+--------+--------+--------+-------+-----------+
+|Richiesto: | Vettore | false | false | false | false |Vettore| false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Scalare | Scalare| Scalare| Scalare| Scalare| false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Indefinito| Stringa| Strnum | Numero | Regexp |Vettore|
Indefinito|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Value- | false | false | false | false | false | false
|
+| | Cookie | | | | | |
|
++-----------+-----------+--------+--------+--------+--------+-------+-----------+
address@hidden verbatim
address@hidden ifplaintext
address@hidden float
+
address@hidden Accedere ai parametri
address@hidden Accedere ai parametri e aggiornarli
+
+Due funzioni consentono di accedere agli argomenti (parametri)
+passati all'estensione. Esse sono:
+
address@hidden @code
address@hidden awk_bool_t get_argument(size_t count,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_valtype_t
wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_value_t
*risultato);
+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.
+In quest'ultimo caso,
address@hidden@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
address@hidden@dotless{i}} via.
address@hidden indica il tipo di valore atteso.
+
address@hidden awk_bool_t set_argument(size_t count, awk_array_t array);
+Converte un parametro di tipo indefinito in un vettore; address@hidden
permette la
+chiamata per riferimento per i vettori. Restituisce @dfn{false} se
@code{count} @`e troppo elevato,
+o se il tipo di argomento @`e diverso da @dfn{undefined}.
address@hidden di vettori}
+per ulteriori informazioni riguardo alla creazione di vettori.
address@hidden table
+
address@hidden Accedere alla tabella simboli
address@hidden Accedere alla Tabella dei simboli
address@hidden accedere alle variabili globali dalle estensioni
address@hidden variabili globali, accesso dalle estensioni
address@hidden estensioni, accesso alle variabili globali
+
+Due insiemi di routine permettono di accedere alle variabili globali,
+e un insieme consente di creare e rilasciare dei valori nascosti.
+
address@hidden
+* Tabella simboli per nome:: Accedere alle variabili per nome.
+* Tabella simboli tramite cookie:: Accedere alle variabili per ``cookie''.
+* Valori nascosti:: Creare e usare valori nascosti.
address@hidden menu
+
address@hidden Tabella simboli per nome
address@hidden Accedere alle variabili per nome e aggiornarle
+
+Le routine che seguono permettono di raggiungere e aggiornare
+le variabili globali a livello di @command{awk} per nome. Nel gergo dei
+compilatori, gli identificativi di vario tipo sono noti come @dfn{simboli},
+da cui il prefisso ``sym'' nei nomi delle routine. La struttura di dati che
+contiene informazioni sui simboli @`e chiamata @dfn{Tabella dei simboli}
+(@dfn{Symbol table}).
+Le funzioni sono le seguenti:
+
address@hidden @code
address@hidden awk_bool_t sym_lookup(const char *name,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_valtype_t wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_value_t
*risultato);
+Riempie la struttura @code{awk_value_t} puntata da @code{risultato}
+con il valore della variabile il cui nome @`e nella stringa @code{name},
+che @`e una normale stringa di caratteri C.
address@hidden 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.
+In quest'ultimo caso, @code{risultato>val_type} indica il tipo effettivo
+della variabile
+(@pxref{table-value-types-returned}).
+
address@hidden awk_bool_t sym_update(const char *name, awk_value_t *valore);
+Aggiorna la variabile il cui nome @`e contenuto nella stringa @code{name},
+che @`e una normale stringa di caratteri C.
+La variabile @`e aggiunta alla Tabella dei simboli di @command{gawk},
+se non @`e address@hidden presente. Restituisce @dfn{true} se tutto @`e
andato bene, e
address@hidden in caso contrario.
+
+La modifica del tipo (da scalare a vettoriale o viceversa) di una variabile
address@hidden esistente @emph{non} @`e consentito, e questa routine non
address@hidden neppure
+essere usata per aggiornare un vettore.
+Questa routine non address@hidden essere usata per modificare nessuna delle
variabili
+predefinite (come @code{ARGC} o @code{NF}).
address@hidden table
+
+Un'estensione address@hidden andare a cercare il valore delle variabili
speciali di
address@hidden
+Tuttavia, con l'eccezione del vettore @code{PROCINFO}, un'estensione
+non address@hidden cambiare alcuna di queste variabili.
+
address@hidden Tabella simboli tramite cookie
address@hidden Accedere alle variabili per ``cookie'' e aggiornarle
+
+Uno @dfn{scalar cookie} @`e un puntatore nascosto (@dfn{opaque handle}) che
+fornisce accesso a una
+variabile globale o a un vettore. Si tratta di un'ottimizzazione, per evitare
+di ricercare variabili nella Tabella dei simboli di @command{gawk} ogni volta
+che un accesso @`e necessario. Questo
+argomento @`e address@hidden stato trattato in precedenza, nella
address@hidden di dati generali}.
+
+Le funzioni seguenti servono per gestire gli @dfn{scalar cookie}:
+
address@hidden @code
address@hidden awk_bool_t sym_lookup_scalar(awk_scalar_t cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_valtype_t wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_value_t *risultato);
+Ottiene il valore corrente di uno @dfn{scalar cookie}.
+Una volta ottenuto lo @dfn{scalar cookie} usando @code{sym_lookup()}, si
address@hidden usare questa funzione per accedere al valore della variabile in
modo
address@hidden efficiente.
+Restituisce @dfn{false} se il valore non @`e disponibile.
+
address@hidden awk_bool_t sym_update_scalar(awk_scalar_t cookie, awk_value_t
*valore);
+Aggiorna il valore associato con uno @dfn{scalar cookie}.
+Restituisce @dfn{false} se il nuovo valore non @`e del tipo
address@hidden, @code{AWK_STRNUM}, @code{AWK_REGEX} o @code{AWK_NUMBER}.
+Anche in questo caso, le variabili predefinite non possono essere aggiornate.
address@hidden table
+
+Non @`e immediatamente evidente come si lavora con gli @dfn{scalar cookie} o
+quale sia la loro vera @i{ragion d'essere}. In teoria, le routine
address@hidden()} e @code{sym_update()} sono tutto address@hidden che occorre
per
+lavorare con le variabili. Per esempio, ci potrebbe essere un codice che
+ricerca il valore di una variabile, valuta una condizione, e potrebbe
+poi cambiare il valore della variabile a seconda dei risultati della
+valutazione in modo simile a questo:
+
address@hidden
+/* do_magic --- fai qualcosa di veramente grande */
+
+static awk_value_t *
+do_magic(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t valore;
+
+ if ( sym_lookup("MAGIC_VAR", AWK_NUMBER, & valore)
+ && qualche_condizione(valore.num_valore)) @{
+ valore.num_valore += 42;
+ sym_update("MAGIC_VAR", & valore);
+ @}
+
+ return make_number(0.0, risultato);
address@hidden
address@hidden example
+
address@hidden
+Questo codice sembra (ed @`e) semplice e immediato. Qual @`e il problema?
+
+Beh, si consideri cosa succede se un qualche codice a livello di @command{awk}
+associato con l'estensione richiama la funzione @code{magic()}
+(implementata in linguaggio C da @code{do_magic()}), una volta per ogni
+record, mentre si stanno elaborando
+file contenenti migliaia o milioni di record.
+La variabile @code{MAGIC_VAR} viene ricercata nella Tabella dei simboli una o
due
+volte per ogni richiamo della funzione!
+
+La ricerca all'interno della Tabella dei simboli @`e in address@hidden una
pura perdita
+di tempo; @`e molto address@hidden efficiente
+ottenere un @dfn{value cookie} che rappresenta la variabile, e usarlo per
+ottenere il valore della variabile e aggiornarlo a seconda della
address@hidden@footnote{La differenza @`e misurabile e indubbiamente reale.
+Fidatevi.}
+
+Quindi, la maniera per usare i valori-cookie @`e la seguente. Per prima
+cosa, la variabile di estensione va messa nella Tabella dei simboli di
address@hidden usando @code{sym_update()}, come al solito. Poi si deve ottenere
+uno @dfn{scalar cookie} per la
+variabile usando @code{sym_lookup()}:
+
address@hidden
+static awk_scalar_t magic_var_cookie; /* cookie per MAGIC_VAR */
+
+static void
+inizializza_estensione()
address@hidden
+ awk_value_t valore;
+
+ /* immettere il valore iniziale */
+ sym_update("MAGIC_VAR", make_number(42.0, & valore));
+
+ /* ottenere il @dfn{value cookie} */
+ sym_lookup("MAGIC_VAR", AWK_SCALAR, & valore);
+
+ /* salvarlo per dopo */
+ magic_var_cookie = valore.scalar_cookie;
+ @dots{}
address@hidden
address@hidden example
+
+Dopo aver fatto questo, si usino le routine descritte in questa @value{SECTION}
+per ottenere e modificare
+il valore usando il @dfn{value cookie}. Quindi, @code{do_magic()} diviene ora
+qualcosa del tipo:
+
address@hidden
+/* do_magic --- fai qualcosa di veramente grande */
+
+static awk_value_t *
+do_magic(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t valore;
+
+ if ( sym_lookup_scalar(magic_var_cookie, AWK_NUMBER, & valore)
+ && qualche_condizione(valore.num_valore)) @{
+ valore.num_valore += 42;
+ sym_update_scalar(magic_var_cookie, & valore);
+ @}
+ @dots{}
+
+ return make_number(0.0, risultato);
address@hidden
address@hidden example
+
address@hidden NOTA
+Il codice appena visto omette il controllo di eventuali errori, per
+amor di address@hidden Il codice dell'estensione dovrebbe essere
address@hidden complesso
+e controllare attentamente i valori
+restituiti dalle funzioni dell'API.
address@hidden quotation
+
address@hidden Valori nascosti
address@hidden Creare e usare valori nascosti
+
+Le routine in questa @value{SECTION} permettono di creare e rilasciare
+valori nascosti. Come gli @dfn{scalar cookie}, in teoria i valori nascosti
+non sono necessari. Si possono creare numeri e stringhe usando
+le funzioni descritte
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di costruzione}. Si possono poi assegnare
+quei valori a delle variabili usando @code{sym_update()}
+o @code{sym_update_scalar()}, come si preferisce.
+
+Tuttavia, si address@hidden comprendere l'address@hidden di avere dei valori
nascosti
+se si pone mente al fatto che la memoria di @emph{ogni} valore di stringa
address@hidden essere ottenuta tramite @code{gawk_malloc()},
address@hidden()} o @code{gawk_realloc()}.
+Se ci sono 20 variabili, e tutte hanno per valore la stessa stringa,
+si devono creare 20 copie identiche della address@hidden valori
+numerici creano molti meno problemi, in quanto richiedono solo una variabile
+C @code{double} (8 byte) per contenerli.}
+
+Chiaramente @`e address@hidden efficiente, se possibile, creare il valore una
sola volta,
+e fare in modo che @command{gawk} utilizzi quell'unico valore per molte
+variabili. Questo @`e address@hidden che la routine in
address@hidden
+questa
address@hidden ifnotinfo
address@hidden
+questo
address@hidden ifinfo
address@hidden permette
+di fare. Le funzioni sono le seguenti:
+
address@hidden @code
address@hidden awk_bool_t create_value(awk_value_t *valore, awk_value_cookie_t
*risultato);
+Crea una stringa o un valore numerico nascosti, da @code{valore}, in
+vista di un successivo assegnamento di valore. Sono consentiti solo valori di
+tipo @code{AWK_NUMBER}, @code{AWK_REGEX} ed @code{AWK_STRING}.
+Ogni altro tipo @`e rifiutato.
+Il tipo @code{AWK_UNDEFINED} potrebbe essere consentito, ma in questo caso
+l'efficienza del programma ne soffrirebbe.
+
address@hidden awk_bool_t release_value(awk_value_cookie_t vc);
+Libera la memoria associata con un @dfn{value cookie} ottenuto mediante
address@hidden()}.
address@hidden table
+
+Si usano i @dfn{value cookie} in modo dimile a quello con cui si usano gli
address@hidden cookie}.
+Nella routine di inizializzazione dell'estensione, si crea il
address@hidden cookie}:
+
address@hidden
+static awk_value_cookie_t answer_cookie; /* static @dfn{value cookie} */
+
+static void
+inizializza_estensione()
address@hidden
+ awk_value_t value;
+ char *long_string;
+ size_t long_string_len;
+
+ /* codice precedente */
+ @dots{}
+ /* @dots{} riempire long_string e long_string_len @dots{} */
+ make_malloced_string(long_string, long_string_len, & value);
+ create_value(& value, & answer_cookie); /* creare cookie */
+ @dots{}
address@hidden
address@hidden example
+
+Una volta che il valore @`e creato, si address@hidden usare come valore per un
numero
+qualsiasi di variabili:
+
address@hidden
+static awk_value_t *
+do_magic(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t new_value;
+
+ @dots{} /* come in precedenza */
+
+ value.val_type = AWK_VALUE_COOKIE;
+ value.value_cookie = answer_cookie;
+ sym_update("VAR1", & value);
+ sym_update("VAR2", & value);
+ @dots{}
+ sym_update("VAR100", & value);
+ @dots{}
address@hidden
address@hidden example
+
address@hidden
+Usare @dfn{value cookie} in questo modo permette di risparmiare parecchia
+memoria, poich@'e tutte le variabili da @code{VAR1} a @code{VAR100} condividono
+lo stesso valore.
+
+Ci si potrebbe chiedere, ``Questa condivisione crea problemi?
+Cosa succede se il codice @command{awk} assegna un nuovo valore a @code{VAR1};
+sono modificate anche tutte le altre variabili?''
+
+Buona domanda! La risposta @`e che no, non @`e un problema.
+Internamente, @command{gawk} usa
address@hidden contatore dei riferimenti alle stringhe}. Questo significa
+che molte variabili possono condividere lo stesso valore di tipo stringa,
+e @command{gawk} mantiene traccia del loro uso. Quando il valore di
+una variabile viene modificato, @command{gawk} semplicemente diminuisce di
+uno il contatore dei riferimenti del vecchio valore, e aggiorna la variabile
+perch@'e usi il nuovo valore.
+
+Infine, come parte della pulizia al termine del programma
+(@pxref{Funzioni di exit callback})
+si deve liberare ogni valore nascosto che era stato creato, usando
+la funzione @code{release_value()}.
+
address@hidden Manipolazione di vettori
address@hidden Manipolazione di vettori
address@hidden vettori, manipolazione nelle estensioni
address@hidden estensioni, manipolazione di vettori
+
+La struttura di dati address@hidden'accordo, l'unica struttura di dati.}
+in @command{awk} @`e il vettore associativo
address@hidden
+(@pxrefil{Vettori}).
address@hidden iftex
address@hidden
+(@pxref{Vettori}).
address@hidden ifnottex
+Le estensioni devono essere in grado di manipolare vettori @command{awk}.
+L'API fornisce varie strutture di dati per lavorare con vettori,
+funzioni per lavorare con singoli elementi di un vettore, e funzioni per
+lavorare con interi vettori. @`E prevista anche la address@hidden di
+``appiattire'' un vettore in modo da rendere facile a un programma scritto in
+C la ``visita'' di tutti gli elementi del vettore.
+Le strutture dati per i vettori sono facilmente integrabili con le
+strutture dati per variabili scalari, per facilitare sia l'elaborazione, sia
+la creazione di @dfn{veri} vettori di vettori (@pxref{Tipi di dati generali}).
+
address@hidden
+* Tipi di dati per i vettori:: Tipi dati per lavorare coi vettori.
+* Funzioni per i vettori:: Funzioni per lavorare coi vettori.
+* Appiattimento di vettori:: Come appiattire i vettori.
+* Creazione di vettori:: Come creare e popolare vettori.
address@hidden menu
+
address@hidden Tipi di dati per i vettori
address@hidden Tipi di dati per i vettori
+
+I tipi di dato associati con i vettori sono i seguenti:
+
address@hidden @code
address@hidden typedef void *awk_array_t;
+Se si richiede il valore di una variabile contenuta in un vettore, si ottiene
+un valore del tipo @code{awk_array_t}. Questo valore @`e
address@hidden@address@hidden anche un
+``cookie,'' ma gli sviluppatori di @command{gawk} hanno preferito non abusare
+di questo termine.} per l'estensione; identifica in maniera univoca il
+vettore ma address@hidden solo essere usato come parametro di una funzione
dell'API,
+o essere ricevuto da una funzione dell'API. Questo @`e molto simile al modo
+in cui i valori @samp{FILE *} sono usati con le routine di libreria di
address@hidden<stdio.h>}.
+
address@hidden typedef struct awk_element @{
address@hidden @ @ @ @ /* puntatore di servizio
address@hidden @ @ @ @ a lista collegata, non usato da gawk */
address@hidden @ @ @ @ struct awk_element *next;
address@hidden @ @ @ @ enum @{
address@hidden @ @ @ @ @ @ @ @ AWK_ELEMENT_DEFAULT = 0,@ @ /* impostato da gawk
*/
address@hidden @ @ @ @ @ @ @ @ AWK_ELEMENT_DELETE = 1@ @ @ @ /* impostato
dall'estensione */
address@hidden @ @ @ @ @} flags;
address@hidden @ @ @ @ awk_value_t index;
address@hidden @ @ @ @ awk_value_t value;
address@hidden @} awk_element_t;
address@hidden @`e un elemento di vettore ``appiattito''.
address@hidden produce un vettore di questo tipo all'interno della struttura
address@hidden (si veda poco address@hidden avanti).
+Singoli elementi di vettore possono essere marcati per essere cancellati.
+Nuovi elementi del vettore devono essere aggiunti individualmente, uno per
+volta, usando una funzione API apposita. I campi sono i seguenti:
+
address@hidden nested table
address@hidden @code
address@hidden struct awk_element *next;
+Questo puntatore @`e presente come ausilio a chi scrive un'estensione.
+Permette a un'estensione di creare una lista collegata (@dfn{linked list}) di
+nuovi elementi che possono essere aggiunti a un vettore con un
+singolo ciclo che percorre tutta la lista.
+
address@hidden enum @{ @dots{} @} flags;
+Un insieme di valori di flag che passano informazione tra l'estensione
+e @command{gawk}. Per ora c'@`e solo un flag disponibile:
address@hidden
+Se lo si imposta, @command{gawk} elimina l'elemento in questione dal vettore
+originale, dopo che il vettore ``appiattito'' @`e stato rilasciato.
+
address@hidden index
address@hidden value
+L'indice e il valore di un elemento, rispettivamente.
address@hidden la memoria puntata da @code{index} e @code{valore} appartiene
+a @command{gawk}.
address@hidden table
+
address@hidden typedef struct awk_flat_array @{
address@hidden @ @ @ @ awk_const void *awk_const opaque1;@ @ @ @ /* per uso di
gawk */
address@hidden @ @ @ @ awk_const void *awk_const opaque2;@ @ @ @ /* per uso di
gawk */
address@hidden @ @ @ @ awk_const size_t count;@ @ @ @ @ /* quanti elementi nel
vettore */
address@hidden @ @ @ @ awk_element_t elements[1];@ @ /* saranno ``appiattiti''
*/
address@hidden @} awk_flat_array_t;
+Questo @`e un vettore appiattito. Quando un'estensione ottiene da
address@hidden questa struttura, il vettore @code{elements} ha una dimensione
+reale di @code{count} elementi.
+I puntatori @code{opaque1} e @code{opaque2} sono per uso di @command{gawk};
+come tali, sono marcati come @code{awk_const} in modo che l'estensione non
+possa modificarli.
address@hidden table
+
address@hidden Funzioni per i vettori
address@hidden Funzioni per lavorare coi vettori
+
+Le funzioni seguenti permettono di gestire singoli elementi di un vettore:
+
address@hidden @code
address@hidden awk_bool_t get_element_count(awk_array_t a_cookie, size_t
*count);
+Per il vettore rappresentato da @code{a_cookie}, restituisce in @code{*count}
+il numero di elementi in esso contenuti. Ogni sottovettore @`e conteggiato
come
+se fosse un solo elemento.
+Restituisce @dfn{false} se si verifica un errore.
+
address@hidden awk_bool_t get_array_element(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const
awk_value_t *const index,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_valtype_t wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
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}.
address@hidden specifica il tipo di valore che si vuole ritrovare.
+Restituisce @dfn{false} se @code{wanted} 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} address@hidden essere numerico, nel qual caso
@command{gawk}
+lo converte in una stringa. Usare valori non interi @`e possibile, ma
+richiede di comprendere il modo con cui tali valori sono convertiti in stringhe
+(@pxref{Conversione}); per questo motivo, @`e meglio usare numeri interi.
+
+Come per @emph{tutte} le stringhe passate a @command{gawk} da
+un'estensione, la memoria che contiene il valore della stringa con chiave
address@hidden deve essere stata acquisita utilizzando le funzioni
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}, e
address@hidden address@hidden (al momento opportuno) la relativa memoria.
+
address@hidden awk_bool_t set_array_element(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const@
awk_value_t *const index,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const@
awk_value_t *const value);
+Nel vettore rappresentato da @code{a_cookie}, crea o modifica
+l'elemento il cui indice @`e contenuto in @code{index}.
+I vettori @code{ARGV} ed @code{ENVIRON} non possono essere modificati,
+mentre il vettore @code{PROCINFO} @`e modificabile.
+
address@hidden awk_bool_t set_array_element_by_elem(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
@ @ @ @ @ awk_element_t element);
+Come @code{set_array_element()}, ma prende l'indice @code{index} e
+il valore @code{value} da @code{element}. Questa @`e una macro di
address@hidden
+
address@hidden awk_bool_t del_array_element(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const
awk_value_t* const index);
+Elimina dal vettore, rappresentato da @code{a_cookie}, l'elemento con
+l'indice specificato.
+Restituisce @dfn{true} se l'elemento @`e stato rimosso o @dfn{false} se
+l'elemento non era presente nel vettore.
address@hidden table
+
+Le seguenti funzioni operano sull'intero vettore:
+
address@hidden @code
address@hidden awk_array_t create_array(void);
+Crea un nuovo vettore a cui si possono aggiungere elementi.
address@hidden di vettori} per una trattazione su come
+creare un nuovo vettore e aggiungervi elementi.
+
address@hidden awk_bool_t clear_array(awk_array_t a_cookie);
+Svuota il vettore rappresentato da @code{a_cookie}.
+Restituisce @dfn{false} in presenza di qualche tipo di problema, @dfn{true}
+in caso contrario. Il vettore non viene eliminato ma, dopo aver chiamato
+questa funzione, resta privo di elementi. Questo @`e equivalente a usare
+l'istruzione @code{delete} (@pxref{Cancellazione}).
+
address@hidden awk_bool_t flatten_array_typed(awk_array_t a_cookie,
awk_flat_array_t **data, awk_valtype_t index_type, awk_valtype_t value_type);
+Per il vettore rappresentato da @code{a_cookie}, crea una struttura
address@hidden e la riempie con indici e valori del tipo richiesto.
+Imposta il puntatore il cui indirizzo @`e passato in @code{data} per puntare a
+questa struttura.
+Restituisce @dfn{true} se tutto va bene o @dfn{false} in caso contrario.
address@hidden FOR_PRINT
+Si veda la prossima @value{SECTION}
address@hidden ifset
address@hidden FOR_PRINT
address@hidden di vettori},
address@hidden ifclear
+per una trattazione su come appiattire un vettore per poterci lavorare.
+
address@hidden awk_bool_t flatten_array(awk_array_t a_cookie, awk_flat_array_t
**data);
+Per il vettore rappresentato da @code{a_cookie}, crea una struttura
address@hidden e la riempie con indici di tipo @code{AWK_STRING} e
+valori @code{AWK_UNDEFINED}.
+Questa funzione @`e resa obsoleta da @code{flatten_array_typed()}.
address@hidden fornita come macro, e mantenuta per convenienza e per
address@hidden a
+livello di codice sorgente con la precedente versione dell'API.
+
address@hidden awk_bool_t release_flattened_array(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
@ @ @ awk_flat_array_t *data);
+Quando si @`e finito di lavorare con un vettore appiattito, si liberi la
+memoria usando questa funzione. Occorre fornire sia il cookie del vettore
+originale, sia l'indirizzo della struttura da liberare,
address@hidden
+La funzione restituisce @dfn{true} se tutto va bene, @dfn{false} in caso
contrario.
address@hidden table
+
address@hidden Appiattimento di vettori
address@hidden Lavorare con tutti gli elementi di un vettore
+
address@hidden un vettore vuol dire creare una struttura che
+rappresenta l'intero vettore in modo da facilitare la visita
+dell'intero vettore da parte del codice in C . Parte del codice in
address@hidden/testext.c} fa questo, ed @`e anche un bell'esempio
+di come utilizzare l'API.
+
+Questa parte del codice sorgente address@hidden descritta un po' per volta.
+Ecco, per iniziare, lo script @command{gawk} che richiama l'estensione di test:
+
address@hidden
+@@load "testext"
+BEGIN @{
+ n = split("blacky rusty sophie raincloud lucky", pets)
+ printf("pets ha %d elementi\n", length(pets))
+ ret = dump_array_and_delete("pets", "3")
+ printf("dump_array_and_delete(pets) ha restituito %d\n", ret)
+ if ("3" in pets)
+ printf("dump_array_and_delete() NON ha rimosso l'indice \"3\"!\n")
+ else
+ printf("dump_array_and_delete() ha rimosso l'indice \"3\"!\n")
+ print ""
address@hidden
address@hidden example
+
address@hidden
+Questo codice crea un vettore usando la funzione @code{split()}
+(@pxref{Funzioni per stringhe})
+e poi chiama @code{dump_array_and_delete()}. Questa funzione ricerca
+il vettore il cui nome @`e passato come primo argomento, ed
+elimina l'elemento il cui indice @`e passato come secondo argomento.
+Il codice @command{awk} stampa poi il valore restituito e controlla che
+l'elemento sia stato effettivamente cancellato. Ecco il codice C che
+costituisce la funzione
address@hidden()}. @`E stato leggermente modificato per facilitare
+l'esposizione.
+
+La prima parte dichiara variabili, imposta il valore di ritorno di default
+in @code{risultato}, e controlla che la funzione
+sia stata chiamata con il numero corretto di argomenti:
+
address@hidden
+static awk_value_t *
+dump_array_and_delete(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t valore, valore2, valore3;
+ awk_flat_array_t *flat_array;
+ size_t count;
+ char *name;
+ int i;
+
+ assert(risultato != NULL);
+ make_number(0.0, risultato);
+
+ if (nargs != 2) @{
+ printf("dump_array_and_delete: nargs errato "
+ "(%d dovrebbe essere 2)\n", nargs);
+ goto out;
+ @}
address@hidden example
+
+La funzione poi prosegue un passo per volta, come segue. Il primo passo @`e
+ricuperare il nome del vettore, passato come primo argomento, seguito dal
+vettore stesso. Se una di queste operazioni non riesce, viene stampato un
+messaggio di errore e si ritorna al chiamante:
+
address@hidden
+ /* trasforma in un vettore piatto il vettore
+ passato come argomento e lo stampa */
+ if (get_argument(0, AWK_STRING, & value)) @{
+ name = valore.str_value.str;
+ if (sym_lookup(name, AWK_array, & value2))
+ printf("dump_array_and_delete: sym_lookup di %s effettuato\n",
+ name);
+ else @{
+ printf("dump_array_and_delete: sym_lookup di %s non riuscito\n",
+ name);
+ goto out;
+ @}
+ @} else @{
+ printf("dump_array_and_delete: get_argument(0) non riuscito\n");
+ goto out;
+ @}
address@hidden example
+
+Per controllo, e per assicurarsi che il codice C veda
+lo stesso numero di elementi del codice @command{awk},
+il secondo passo @`e quello di ottenere il numero di elementi nel vettore
+e stamparlo:
+
address@hidden
+ if (! get_element_count(valore2.array_cookie, & count)) @{
+ printf("dump_array_and_delete: get_element_count non riuscito\n");
+ goto out;
+ @}
+
+ printf("dump_array_and_delete: il vettore in input ha %lu elementi\n",
+ (unsigned long) count);
address@hidden example
+
+Il terzo passo @`e quello di appiattire il vettore, e quindi
+controllare che il numero di elementi nella struttura @code{awk_flat_array_t}
+sia uguale a quello appena trovato:
+
address@hidden
+ if (! flatten_array_typed(valore2.array_cookie, & flat_array,
+ AWK_STRING, AWK_UNDEFINED)) @{
+ printf("dump_array_and_delete: non sono riuscito ad appiattire \
+il vettore\n");
+ goto out;
+ @}
+
+ if (flat_array->count != count) @{
+ printf("dump_array_and_delete: flat_array->count (%lu)"
+ " != count (%lu)\n",
+ (unsigned long) flat_array->count,
+ (unsigned long) count);
+ goto out;
+ @}
address@hidden example
+
+Il quarto passo @`e ritrovare l'indice dell'elemento
+da eliminare, che era stato passato come secondo argomento.
+Va tenuto presente che i contatori di argomenti passati a @code{get_argument()}
+partono da zero, e che quindi il secondo argomento @`e quello numero uno:
+
address@hidden
+ if (! get_argument(1, AWK_STRING, & value3)) @{
+ printf("dump_array_and_delete: get_argument(1) non riuscito\n");
+ goto out;
+ @}
address@hidden example
+
+Il quinto passo @`e quello in cui si fa il ``vero lavoro''. La funzione esegue
+un ciclo su ogni elemento nel vettore, stampando i valori degli indici e
+degli elementi. Inoltre, dopo aver trovato, tramite l'indice, l'elemento
+che si vorrebbe eliminare, la funzione imposta il @dfn{bit}
address@hidden nel campo @code{flags}
+dell'elemento. Quando il vettore @`e stato interamente percorso,
@command{gawk}
+visita il vettore appiattito, ed elimina ogni elemento in cui il relativo
address@hidden della flag sia impostato:
+
address@hidden
+ for (i = 0; i < flat_array->count; i++) @{
+ printf("\t%s[\"%.*s\"] = %s\n",
+ name,
+ (int) flat_array->elements[i].index.str_value.len,
+ flat_array->elements[i].index.str_value.str,
+ valrep2str(& flat_array->elements[i].valore));
+
+ if (strcmp(valore3.str_value.str,
+ flat_array->elements[i].index.str_value.str) == 0) @{
+ flat_array->elements[i].flags |= AWK_ELEMENT_DELETE;
+ printf("dump_array_and_delete: ho marcato l'elemento \"%s\" "
+ "per eliminazione\n",
+ flat_array->elements[i].index.str_value.str);
+ @}
+ @}
address@hidden example
+
+Il sesto passo @`e liberare il vettore appiattito. Questo segnala a
address@hidden che l'estensione non sta address@hidden usando il vettore,
+e che dovrebbe eliminare gli elementi marcati per l'eliminazione.
address@hidden libera anche ogni area di memoria che era stata allocata,
+e quindi non si dovrebbe address@hidden usare il puntatore (@code{flat_array}
in
+questo codice) dopo aver chiamato @code{release_flattened_array()}:
+
address@hidden
+ if (! release_flattened_array(valore2.array_cookie, flat_array)) @{
+ printf("dump_array_and_delete: non riesco a liberare \
+il vettore appiattito\n");
+ goto out;
+ @}
address@hidden example
+
+Infine, poich@'e tutto @`e andato bene, la funzione imposta il codice di
ritorno
+a "successo", e lo restituisce quando esce:
+
address@hidden
+ make_number(1.0, risultato);
+out:
+ return risultato;
address@hidden
address@hidden example
+
+Ecco l'output ottenuto eseguendo questa parte del test:
+
address@hidden
+pets ha 5 elementi
+dump_array_and_delete: sym_lookup di pets effettuato
+dump_array_and_delete: il vettore in input ha 5 elementi
+ pets["1"] = "blacky"
+ pets["2"] = "rusty"
+ pets["3"] = "sophie"
+dump_array_and_delete: ho marcato l'elemento "3" per eliminazione
+ pets["4"] = "raincloud"
+ pets["5"] = "lucky"
+dump_array_and_delete(pets) ha restituito 1
+dump_array_and_delete() ha rimosso l'indice "3"!
address@hidden example
+
address@hidden Creazione di vettori
address@hidden Come creare e popolare vettori
+
+Oltre a lavorare con vettori creati da codice @command{awk}, si possono
+creare vettori a cui aggiungere elementi secondo le esigenze, che poi
+il codice @command{awk} address@hidden utilizzare e manipolare.
+
+Ci sono due punti importanti da tener presente quando di creano vettori dal
+codice di un'estensione:
+
address@hidden @value{BULLET}
address@hidden
+Il vettore appena creato deve essere subito messo nella Tabella dei simboli di
address@hidden Solo dopo aver fatto questo @`e possibile aggiungere elementi
+al vettore.
+
address@hidden
+Strictly speaking, this is required only
+for arrays that will have subarrays as elements; however it is
+a good idea to always do this. This restriction may be relaxed
+in a subsequent revision of the API.
address@hidden ignore
+
+Analogamente, se si installa un nuovo vettore come sottovettore di
+un vettore address@hidden esistente,
+occorre prima aggiungere il nuovo vettore al suo "genitore" per poter poi
+aggiungere degli elementi allo stesso.
+
+Quindi, il modo giusto per costruire un vettore @`e di lavorare ``dall'alto
+verso il basso''. Creare il vettore, e subito aggiungerlo alla Tabella dei
+simboli di @command{gawk} usando @code{sym_update()}, o installarlo come
+elemento in un vettore address@hidden esistente usando
@code{set_array_element()}.
+Un esempio di codice @`e fornito address@hidden sotto.
+
address@hidden
+Per come funziona internamente @command{gawk}, dopo aver usato
address@hidden()} per definire un vettore
+in @command{gawk}, si deve innanzitutto ricuperare il @dfn{cookie}
+del vettore dal valore passato a @command{sym_update()}, in questo modo:
+
address@hidden
+awk_value_t val;
+awk_array_t new_array;
+
+new_array = create_array();
+val.val_type = AWK_ARRAY;
+val.array_cookie = new_array;
+
+/* aggiunge il vettore alla Tabella dei simboli */
+sym_update("array", & val);
+
+new_array = val.array_cookie; /* QUESTO @`E OBBLIGATORIO */
address@hidden example
+
+Se si sta installando un vettore come sottovettore, occorre anche
+ricuperare il @dfn{cookie} del vettore dopo aver chiamato @code{set_element()}.
address@hidden itemize
+
+Il seguente codice C @`e una semplice estensione di test per creare un vettore
+con due elementi normali e con un sottovettore. Le direttive iniziali
address@hidden e le solite dichiarazione di variabili sono state omesse per
+amor di address@hidden
+(@pxref{Codice predefinito di un'estensione API}).
+Il primo passo @`e creare un nuovo vettore e poi aggiungerlo alla
+Tabella dei simboli:
+
address@hidden
address@hidden
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <stdio.h>
+#include <assert.h>
+#include <errno.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+
+#include <sys/types.h>
+#include <sys/stat.h>
+
+#include "gawkapi.h"
+
+static const gawk_api_t *api; /* per far funzionare le macro di
address@hidden */
+static awk_ext_id_t *ext_id;
+static const char *ext_version = "testarray extension: version 1.0";
+
+int plugin_is_GPL_compatible;
+
address@hidden ignore
+/* create_new_array --- creare un vettore denominato */
+
+static void
+create_new_array()
address@hidden
+ awk_array_t a_cookie;
+ awk_array_t sottovettore;
+ awk_value_t index, valore;
+
+ a_cookie = create_array();
+ valore.val_type = AWK_array;
+ valore.array_cookie = a_cookie;
+
+ if (! sym_update("new_array", & value))
+ printf("create_new_array: sym_update(\"nuovo_vettore\") \
+non riuscito!\n");
+ a_cookie = valore.array_cookie;
address@hidden example
+
address@hidden
+Si noti come @code{a_cookie} @`e reimpostato dal campo @code{array_cookie}
+nella struttura @code{valore}.
+
+Il secondo passo aggiunge due elementi normali a @code{nuovo_vettore}:
+
address@hidden
+ (void) make_const_string("salve", 5, & index);
+ (void) make_const_string("mondo", 5, & value);
+ if (! set_array_element(a_cookie, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
+
+ (void) make_const_string("risposta", 8, & index);
+ (void) make_number(42.0, & value);
+ if (! set_array_element(a_cookie, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
address@hidden example
+
+Il terzo passo @`e creare il sottovettore e aggiungerlo al vettore:
+
address@hidden
+ (void) make_const_string("sottovettore", 12, & index);
+ sottovettore = create_array();
+ valore.val_type = AWK_array;
+ valore.array_cookie = subarray;
+ if (! set_array_element(a_cookie, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
+ sottovettore = valore.array_cookie;
address@hidden example
+
+Il passo finale @`e di aggiungere al sottovettore un suo proprio elemento:
+
address@hidden
+ (void) make_const_string("pippo", 5, & index);
+ (void) make_const_string("pluto", 5, & value);
+ if (! set_array_element(sottovettore, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
address@hidden
address@hidden
+static awk_ext_func_t func_table[] = @{
+ @{ NULL, NULL, 0 @}
address@hidden;
+
+/* init_testarray --- funzione ulteriore di inizializzazione */
+
+static awk_bool_t init_testarray(void)
address@hidden
+ create_new_array();
+
+ return awk_true;
address@hidden
+
+static awk_bool_t (*init_func)(void) = init_testarray;
+
+dl_load_func(func_table, testarray, "")
address@hidden ignore
address@hidden example
+
+Ecco uno script di esempio che carica l'estensione
+e quindi stampa il valore di tutti gli elementi del vettore,
+invocando nuovamente se stessa nel caso che un particolare
+elemento sia a sua volta un vettore:
+
address@hidden
+@@load "subarray"
+
+function dumparray(name, vettore, i)
address@hidden
+ for (i in vettore)
+ if (isarray(vettore[i]))
+ dumparray(name "[\"" i "\"]", vettore[i])
+ else
+ printf("%s[\"%s\"] = %s\n", name, i, vettore[i])
address@hidden
+
+BEGIN @{
+ dumparray("new_array", new_array);
address@hidden
address@hidden example
+
+Ecco il risultato dell'esecuzione dello script:
+
address@hidden
+$ @kbd{AWKLIBPATH=$PWD ./gawk -f subarray.awk}
address@hidden new_array["sottovettore"]["pippo"] = pluto
address@hidden new_array["salve"] = mondo
address@hidden new_array["risposta"] = 42
address@hidden example
+
address@hidden
+(@xref{Trovare le estensioni} per ulteriori dettagli sulla
+variabile d'ambiente @env{AWKLIBPATH}.)
+
address@hidden Ridirezione API
address@hidden Accedere alle ridirezioni e modificarle
+
+La seguente funzione consente alle estensioni di accedere e di manipolare
+delle ridirezioni.
+
address@hidden @code
address@hidden awk_bool_t get_file(const char *name,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ size_t name_len,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const char *tipofile,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ int fd,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const awk_input_buf_t
**ibufp,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const awk_output_buf_t
**obufp);
+Ricerca il file @code{name} nella tabella interna di ridirezione di
address@hidden
+Se @code{name} @`e @code{NULL} o @code{name_len} @`e zero, restituisce
+i dati del file in input correntemente aperto il cui nome @`e memorizzato in
address@hidden
+(Questa chiamata non usa l'argomento @code{filetype}, che, quindi,
address@hidden essere
+lasciato indefinito).
+Se il file non @`e address@hidden aperto, tenta di aprirlo.
+L'argomento @code{filetype} deve terminare con uno zero binario, e dovrebbe
+dovrebbe avere uno di questi valori:
+
address@hidden @code
address@hidden ">"
+Un file aperto in output.
+
address@hidden ">>"
+Un file aperto in output, record aggiunti a fine file,
+dopo quelli address@hidden esistenti address@hidden
+
address@hidden "<"
+Un file aperto in input.
+
address@hidden "|>"
+Una @dfn{pipe} aperta in output.
+
address@hidden "|<"
+Una @dfn{pipe} aperta in input.
+
address@hidden "|&"
+Un coprocesso bidirezionale.
address@hidden table
+
+In caso di errore, restituisce il valore @address@hidden
+Altrimenti, restituisce
address@hidden@dfn{awk_true}}, insieme a ulteriori informazioni sulla
ridirezione
+nei puntatori @code{ibufp} e @code{obufp}.
+Per ridirezioni di input il valore @code{*ibufp} non dovrebbe essere
address@hidden, mentre @code{*obufp} dovrebbe essere @code{NULL}.
+Per ridirezioni di output,
+il valore di @code{*obufp} non dovrebbe essere @code{NULL}, e @code{*ibufp}
+dovrebbe essere @code{NULL}. Per coprocessi bidirezionali, nessuno dei due
+valori dovrebbe essere @code{NULL}.
+
+Normalmente, l'estensione @`e interessata a @code{(*ibufp)->fd}
+e/o @code{fileno((*obufp)->fp)}. Se il file non @`e address@hidden
+aperto, e l'argomento @code{fd} non @`e negativo, @command{gawk}
address@hidden quel descrittore di file invece di aprire il file nella
+maniera solita. Se l'@code{fd} non @`e negativo, ma il file esiste
address@hidden,
address@hidden ignora l'@code{fd} e restituisce il file esistente. @`E
address@hidden del chiamante notare che n@'e l'@code{fd} nella struttura
+restituita @code{awk_input_buf_t}, n@'e l'@code{fd} nella struttura restituita
address@hidden contiene il valore richiesto.
+
+Si noti che fornire un descrittore di file @emph{non} @`e al momento supportato
+per le @dfn{pipe}. Tuttavia, l'utilizzo di un descrittore di file
+dovrebbe essere possibile per @dfn{socket} in input, output,
+aggiunta-a-fine-file (append), e bidirezionale (coprocessi).
+Se @code{filetype} @`e bidirezionale, @command{gawk} presuppone che sia un
address@hidden Si noti che nel caso
+bidirezionale i descrittori di file in input e output possono essere
+differenti.
+Per essere sicuri che tutto sia andato bene, si deve controllare che uno dei
due
+corrisponda alla richiesta.
address@hidden table
+
+Si prevede che questa funzione API address@hidden usata per parallelizzare
l'I/O
+e rendere disponibile una libreria per i @dfn{socket}.
+
address@hidden Variabili dell'estensione API
address@hidden Variabili fornite dall'API
+
+L'API fornisce due insiemi di variabili. Il primo insieme contiene
+informazioni sulla versione dell'API (sia la versione dell'estensione
+compilata, che quella di @command{gawk}). Il secondo
+insieme contiene informazioni su come @command{gawk} @`e stato invocato.
+
address@hidden
+* Versione dell'estensione:: Informazioni sulla versione API.
+* Variabili informative di estens. API:: Variabili che forniscono informationi
+ sull'invocazione di @command{gawk}.
address@hidden menu
+
address@hidden Versione dell'estensione
address@hidden Costanti e variabili della versione dell'API
address@hidden API, versione
address@hidden versione dell'estensione API @command{gawk}
address@hidden estensione @command{gawk}, versione API
+
+L'API fornisce sia un numero di versione ``principale'' che uno ``secondario''.
+Le versioni dell'API sono disponibili al momento della compilazione, come
+definizioni per il preprocessore C, a supporto della compilazione
+condizionale, e come elencazione di costanti per facilitare il debug:
+
address@hidden Tabella,gawk-api-version
address@hidden delle versioni API gawk}
address@hidden address@hidden Version}} address@hidden address@hidden
address@hidden versione API @tab Definiz. Preprocessore C @tab Costante di
elenco
address@hidden Major @tab @code{gawk_api_major_version} @tab
@code{GAWK_API_MAJOR_VERSION}
address@hidden Minor @tab @code{gawk_api_minor_version} @tab
@code{GAWK_API_MINOR_VERSION}
address@hidden multitable
address@hidden float
+
+La versione secondaria aumenta quando nuove funzioni sono aggiunte all'API.
+Tali nuove funzioni sono sempre aggiunte alla fine della @code{struct}
dell'API.
+
+La versione principale aumenta (e la versione secondaria torna a zero) se
+qualche tipo di dati cambia dimensione o si modifica l'ordine dei campi, o se
+qualcuna delle funzioni esistenti cambia il livello di versione.
+
address@hidden capitare che un'estensione sia stata compilata con una versione
+dell'API ma caricata da una versione di @command{gawk} che ne usa una
+differente. Per questo motivo, la versione principale e quella secondaria
+dell'API della versione in uso di @command{gawk} sono incluse nella
address@hidden dell'API come costanti intere in sola lettura:
+
address@hidden @code
address@hidden api->major_version
+La versione principale di @command{gawk} in esecuzione.
+
address@hidden api->minor_version
+La versione secondaria di @command{gawk} in esecuzione.
address@hidden table
+
+Dipende dall'estensione decidere se ci sono address@hidden con l'API.
+Tipicamente, basta un controllo di questo tipo:
+
address@hidden
+if (api->major_version != GAWK_API_MAJOR_VERSION
+ || api->minor_version < GAWK_API_MINOR_VERSION) @{
+ fprintf(stderr, "estensione_pippo: discordanza di versione \
+con gawk!\n");
+ fprintf(stderr, "\tLa mia versione (%d, %d), versione gawk \
+(%d, %d)\n",
+ GAWK_API_MAJOR_VERSION, GAWK_API_MINOR_VERSION,
+ api->major_version, api->minor_version);
+ exit(1);
address@hidden
address@hidden example
+
+Questo codice @`e incluso nella macro generica @code{dl_load_func()}
+presente in @file{gawkapi.h} (trattata
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden predefinito di un'estensione API}).
+
address@hidden Variabili informative di estens. API
address@hidden Variabili informative
address@hidden API, variabili informative dell'estensione
address@hidden variabili informative dell'API
address@hidden estensione API, variabili informative
+
+L'API fornisce accesso a parecchie variabili che descrivono
+se le opzioni della riga di comando corrispondenti sono state specificate
+quando @command{gawk} @`e stato chiamato. Le variabili sono:
+
address@hidden @code
address@hidden do_debug
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--debug}.
+
address@hidden do_lint
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--lint}.
+
address@hidden do_mpfr
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--bignum}.
+
address@hidden do_profile
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--profile}.
+
address@hidden do_sandbox
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--sandbox}.
+
address@hidden do_traditional
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--traditional}.
address@hidden table
+
+Il valore di @code{do_lint} address@hidden cambiare se il codice @command{awk}
+modifica la variabile predefinita @code{LINT} (@pxref{Variabili predefinite}).
+Gli altri valori non dovrebbero cambiare durante l'esecuzione.
+
address@hidden Codice predefinito di un'estensione API
address@hidden Codice predefinito di interfaccia API
+
+Come address@hidden detto (@pxref{Panoramica sul meccanismo delle estensioni}),
+le definizioni di funzioni qui presentate sono in address@hidden delle macro.
+Per usare queste macro, l'estensione deve fornire una piccola address@hidden di
+codice predefinito (variabili e
+funzioni) nella parte iniziale del file sorgente, usando dei nomi
+standard, come descritto qui sotto. Il codice predefinito in questione @`e
+anche descritto nel file di intestazione @file{gawkapi.h}:
+
address@hidden
+/* Codice predefinito: */
+int plugin_is_GPL_compatible;
+
+static gawk_api_t *const api;
+static awk_ext_id_t ext_id;
+static const char *ext_version = NULL; /* o @dots{} = "qualche stringa" */
+
+static awk_ext_func_t func_table[] = @{
+ @{ "name", do_name, 1, 0, awk_false, NULL @},
+ /* @dots{} */
address@hidden;
+
+/* O: */
+
+static awk_bool_t (*init_func)(void) = NULL;
+
+/* OPPURE: */
+
+static awk_bool_t
+init_mia_estensione(void)
address@hidden
+ @dots{}
address@hidden
+
+static awk_bool_t (*init_func)(void) = init_mia_estensione;
+
+dl_load_func(func_table, qualche_nome, "name_space_in_quotes")
address@hidden example
+
+Queste variabili e funzioni sono:
+
address@hidden @code
address@hidden int plugin_is_GPL_compatible;
+Qui si dichiara che l'estensione @`e compatibile con
address@hidden FOR_PRINT
+la licenza GNU GPL (@pxref{Copia}).
+
address@hidden ifclear
address@hidden FOR_PRINT
+la licenza GNU GPL.
address@hidden ifset
+Se l'estensione non ha questa variabile, non address@hidden caricata da
@command{gawk}
+(@pxref{Licenza delle estensioni}).
+
address@hidden static gawk_api_t *const api;
+Questa variabile globale @code{static} dovrebbe essere impostata per
+puntare al puntatore
address@hidden che @command{gawk} passa alla funzione (dell'estensione)
address@hidden()}. Questa variabile @`e usata da tutte le macro.
+
address@hidden static awk_ext_id_t ext_id;
+Questa variabile globale @code{static} dovrebbe essere impostata al valore
address@hidden che @command{gawk} passa alla funzione @code{dl_load()}.
+Questa variabile @`e usata da tutte le macro.
+
address@hidden static const char *ext_version = NULL; /* o @dots{} = "qualche
stringa" */
+Questa variabile globale @code{static} dovrebbe essere impostata
+a @code{NULL} oppure puntare a una stringa che contiene il nome e la
+versione dell'estensione.
+
address@hidden static awk_ext_func_t func_table[] = @{ @dots{} @};
+Questo @`e un vettore di una o address@hidden strutture @code{awk_ext_func_t},
+come descritto in precedenza (@pxref{Funzioni di estensione}).
address@hidden essere usato in seguito per address@hidden chiamate a
address@hidden()}.
+
address@hidden Use @var{OR} for docbook
address@hidden static awk_bool_t (*init_func)(void) = NULL;
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @var{OR}
address@hidden static awk_bool_t init_mia_estensione(void) @{ @dots{} @}
address@hidden static awk_bool_t (*init_func)(void) = init_mia_estensione;
+Se qualche lavoro di inizializzazione @`e necessario, si dovrebbe definire una
+funzione all'uopo (crea variabili, apre file, etc.)
+e poi definire il puntatore @code{init_func} che punti alla funzione
+stessa.
+La funzione dovrebbe restituire @address@hidden se non va a buon fine
+o @code{awktrue} se tutto va bene.
+
+Se un'inizializzazione non @`e necessaria, si definisca il puntatore e
+lo si inizializzi a @code{NULL}.
+
address@hidden dl_load_func(func_table, qualche_nome,
"nome_spazio_tra_doppi_apici")
+Questa macro genera una funzione @code{dl_load()} che address@hidden
+tutte le inizializzazioni necessarie.
address@hidden table
+
+Lo scopo di tutte le variabili e dei vettori @`e di far
address@hidden@dotless{i}} che la
+funzione @code{dl_load()} (richiamata dalla macro @code{dl_load_func()})
+faccia tutto il lavoro standard necessario, qui descritto:
+
address@hidden 1
address@hidden
+Controlla le versioni dell'API. Se la versione principale dell'estensione
+non corrisponde a quella di @command{gawk} o se la versione secondaria
+dell'estensione @`e maggiore di quella di @command{gawk}, stampa un messaggio
+di errore fatale ed esce.
+
address@hidden
+Carica le funzioni definite in @code{func_table}.
+Se qualche caricamento non riesce, stampa un messaggio di
+avvertimento ma continua l'esecuzione.
+
address@hidden
+Se il puntatore @code{init_func} non @`e @code{NULL}, chiama la
+funzione da esso puntata. Se questa restituisce @code{awk_false}, stampa un
+messaggio di avvertimento.
+
address@hidden
+Se @code{ext_version} non @`e @code{NULL}, registra la
+stringa di versione con @command{gawk}.
address@hidden enumerate
+
address@hidden Modifiche dalla versione API 1
address@hidden Modifiche dalla versione 1 dell'API
+
+La versione API corrente @emph{non} @`e compatibile a livello binario con la
+versione 1 dell'API.
+Le funzioni di estensione vanno ricompilate per poterle usare con la versione
+corrente di @command{gawk}.
+
+Fortunatamente, fatti salvi alcuni possibili avvertimenti a livello di
+compilazione, l'API rimane compatibile a livello di codice sorgente con la
+precedente versione API. Le differenze address@hidden rilevanti sono gli
ulteriori
+campi nella struttura @code{awk_ext_func_t}, e l'aggiunta del terzo argomento
+nella funzione di implementazione in linguaggio C.
+
address@hidden Trovare le estensioni
address@hidden Come @command{gawk} trova le estensioni compilate
address@hidden estensioni, percorso di ricerca per
address@hidden estensioni, come trovarle
address@hidden trovare le estensioni
address@hidden percorso di ricerca per estensioni
+
+Le estensioni compilate vanno installate in una directory dove
address@hidden possa trovarle. Se @command{gawk} @`e configurato e
+installato nella maniera di default, la directory dove trovare le
+estensioni @`e @file{/usr/local/lib/gawk}. Si address@hidden anche
specificare un
+percorso di ricerca contenente una lista di directory da esaminare per la
+ricerca di estensioni compilate.
address@hidden (Variabile)} per ulteriori dettagli.
+
address@hidden Esempio di estensione
address@hidden Esempio: alcune funzioni per i file
address@hidden estensione, esempio
address@hidden esempio di estensione
+
address@hidden
address@hidden qualunque posto vai, address@hidden tu sei.}
address@hidden Buckaroo Banzai
address@hidden quotation
+
address@hidden It's enough to show chdir and stat, no need for fts
+
+Due utili funzioni che non sono in @command{awk} sono @code{chdir()} (per
+permettere a un programma @command{awk} di cambiare directory di lavoro) e
address@hidden()}
+(per far address@hidden@dotless{i}} che un programma @command{awk} possa
raccogliere informazioni
+su un dato file).
+Per illustrare l'azione dell'API, questa @value{SECTION} fornisce
+queste funzioni a @command{gawk} in un'estensione.
+
address@hidden
+* Descrizione interna file:: Quello che le nuove funzioni faranno
+* Operazioni interne file:: Codice per gestire file all'interno
+* Usare operazioni interne file:: Come usare un'estensione esterna
address@hidden menu
+
address@hidden Descrizione interna file
address@hidden Usare @code{chdir()} e @code{stat()}
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden mostra come usare le nuove funzioni a
+livello di @command{awk} una volta che siano state integrate nell'interprete
+del programma @command{gawk} in esecuzione. Usare @code{chdir()} @`e molto
+semplice. Richiede un solo argomento, la nuova directory su cui
+posizionarsi:
+
address@hidden
+@@load "filefuncs"
address@hidden
+newdir = "/home/arnold/funstuff"
+ret = chdir(newdir)
+if (ret < 0) @{
+ printf("non riesco a passare a %s: %s\n", newdir, ERRNO) > "/dev/stderr"
+ exit 1
address@hidden
address@hidden
address@hidden example
+
+Il valore restituito @`e negativo se la chiamata a @code{chdir()} non @`e
riuscita,
+ed @code{ERRNO} (@pxref{Variabili predefinite}) @`e impostato a una stringa
+che descrive l'errore.
+
+Usare @code{stat()} @`e un po' address@hidden complicato. La funzione scritta
in C
address@hidden()} riempie una struttura che ha una certa address@hidden di
informazioni.
+La maniera corretta per immagazzinarle in @command{awk} @`e quella di riempire
+un vettore associativo con le informazioni appropriate:
+
address@hidden broke printf for page breaking
address@hidden
+file = "/home/arnold/.profile"
+ret = stat(file, fdata)
+if (ret < 0) @{
+ printf("non @`e stato possibile eseguire @command{stat} per %s: %s\n",
+ file, ERRNO) > "/dev/stderr"
+ exit 1
address@hidden
+printf("dimensione di %s @`e %d byte\n", file, fdata["size"])
address@hidden example
+
+La funzione @code{stat()} svuota sempre il vettore che contiene i dati,
+anche nel caso che la chiamata a @code{stat()} non riesca. I seguenti
+elementi vengono restituiti dalla funzione:
+
address@hidden @code
address@hidden "name"
+Il nome del file oggetto della chiamata a @code{stat()}.
+
address@hidden "dev"
address@hidden "ino"
+I numeri di @dfn{device} e di @dfn{inode}, rispettivamente.
+
address@hidden "mode"
+Il modo del file, in formato numerico. Questo include sia il tipo di file che
+i suoi permessi di accesso.
+
address@hidden "nlink"
+Il numero di collegamenti fisici del file (stesso file con diversi nomi).
+
address@hidden "uid"
address@hidden "gid"
+Gli identificativi di utente e di gruppo del possessore del file.
+
address@hidden "size"
+La dimensione in byte del file.
+
address@hidden "blocks"
+Il numero di blocchi su disco realmente occupati dal file. Questo
address@hidden non
+essere
+proporzionale alla dimensione del file se il file ha delle lacune
+[ossia se solo alcune parti del file esistono veramente, il resto
+non @`e ancora stato riempito].
+
address@hidden "atime"
address@hidden "mtime"
address@hidden "ctime"
+La data e ora dell'ultimo accesso, modifica, e aggiornamento dell'@dfn{inode},
+rispettivamente. Questi sono delle marcature temporali numeriche
+(misurate in secondi dal
+01 gennaio 1970), che possono essere formattate dalla funzione
address@hidden()}
+(@pxref{Funzioni di tempo}).
+
address@hidden "pmode"
+La address@hidden stampabile (``printable mode'') del file.
+Questo @`e una stringa che rappresenta
+il tipo del file e i permessi di accesso, come sono visualizzati da
address@hidden -l}---per esempio, @code{"drwxr-xr-x"}.
+
address@hidden "type"
+Una stringa stampabile che descrive il tipo di file. Il valore @`e uno dei
+seguenti:
+
address@hidden @code
address@hidden "blockdev"
address@hidden "chardev"
+Il file @`e un dispositico a blocchi o a caratteri (``file speciale'').
+
address@hidden
address@hidden "door"
+The file is a Solaris ``door'' (special file used for
+interprocess communications).
address@hidden ignore
+
address@hidden "directory"
+Il file @`e una directory.
+
address@hidden "fifo"
+Il file @`e una @dfn{pipe} denominata (nota anche come FIFO [First In First
+Out]).
+
address@hidden "file"
+Il file @`e un file normale.
+
address@hidden "@dfn{socket}"
+Il file @`e un @dfn{socket} @code{AF_UNIX} (``Unix domain'') nel
+filesystem.
+
address@hidden "symlink"
+Il file @`e un collegamento simbolico.
address@hidden table
+
address@hidden 5/2013: Thanks to Corinna Vinschen for this information.
address@hidden "devbsize"
+La dimensione di un blocco per l'elemento indicizzato da @code{"blocks"}.
+Questa informazione @`e derivata dalla costante @code{DEV_BSIZE}
+definita in @code{<sys/param.h>} nella maggior parte dei sistemi,
+o dalla costante @code{S_BLKSIZE} in @code{<sys/stat.h>} nei sistemi BSD.
+Per alcuni altri sistemi il valore si basa su una conoscenza @dfn{a priori}
+delle caratteristiche di un particolare sistema.
+Se non si riesce a determinare il valore, viene
+restituito quello di default, che @`e 512.
address@hidden table
+
+Possono essere presenti diversi altri elementi, a seconda del
+sistema operativo e del tipo di file.
+Si address@hidden controllarne la presenza dal programma @command{awk} per
mezzo
+dell'operatore @code{in}
+(@pxref{Visitare elementi}):
+
address@hidden @code
address@hidden "blksize"
+La dimensione preferita di un blocco per effettuare operazioni di I/O sul file.
+Questo campo non @`e presente nella struttura C @code{stat} di tutti i sistemi
+che rispettano lo standard POSIX.
+
address@hidden "linkval"
+Se il file @`e un collegamento simbolico, questo elemento @`e il nome del
+file puntato dal collegamento simbolico (address@hidden, il valore del
collegamento).
+
address@hidden "rdev"
address@hidden "major"
address@hidden "minor"
+Se il file @`e un dispositivo a blocchi o a caratteri, questi valori
+rappresentano il numero del dispositivo e, rispettivamente, le componenti
+principale e secondaria di quel numero.
address@hidden table
+
address@hidden Operazioni interne file
address@hidden Codice C per eseguire @code{chdir()} e @code{stat()}
+
+Questo @`e il codice C per queste address@hidden versione qui
+presentata @`e
+lievemente modificata per amor di address@hidden Si veda
@file{extension/filefuncs.c}
+nella distribuzione @command{gawk} per la versione completa.}
+
+Il file include alcuni file di intestazione standard, e poi il file di
+intestazione @file{gawkapi.h}, che fornisce le definizioni dell'API.
+A queste seguono le dichiarazioni di variabili, necessarie
+per usare le macro dell'API e il codice predefinito
+(@pxref{Codice predefinito di un'estensione API}):
+
address@hidden
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <stdio.h>
+#include <assert.h>
+#include <errno.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+
+#include <sys/types.h>
+#include <sys/stat.h>
+
+#include "gawkapi.h"
+
+#include "gettext.h"
+#define _(msgid) gettext(msgid)
+#define N_(msgid) msgid
+
+#include "gawkfts.h"
+#include "stack.h"
+
+static const gawk_api_t *api; /* per consentire il funzionamento
+ delle macro di address@hidden */
+static awk_ext_id_t *ext_id;
+static awk_bool_t init_filefuncs(void);
+static awk_bool_t (*init_func)(void) = init_filefuncs;
+static const char *ext_version = "filefuncs extension: version 1.0";
+
+int plugin_is_GPL_compatible;
address@hidden example
+
address@hidden programmazione, convenzioni di, estensioni @command{gawk}
address@hidden estensioni @command{gawk}, convenzioni di programmazione
+Per convenzione, per una funzione @command{awk} di nome @code{pippo()},
+la funzione C che la implementa @`e chiamata @code{do_pippo()}. La funzione
+dovrebbe avere due argomenti. Il primo @`e un numero @code{int}, chiamato
address@hidden, che rappresenta il numero di argomenti passato alla funzione.
+Il secondo @`e un puntatore a una struttura @code{awk_value_t}, normalmente
+chiamata @code{risultato}:
+
address@hidden
+/* do_chdir --- fornisce funzione chdir()
+ caricata dinamicamente per gawk */
+
+static awk_value_t *
+do_chdir(int nargs, awk_value_t *risultato, struct awk_ext_func *non_usata)
address@hidden
+ awk_value_t newdir;
+ int ret = -1;
+
+ assert(risultato != NULL);
address@hidden example
+
+La variabile @code{newdir}
+rappresenta la nuova directory nella quale cambiare, che @`e ottenuta
+tramite la funzione @code{get_argument()}. Si noti che il primo argomento @`e
+quello numero zero.
+
+Se l'argomento @`e stato trovato con successo, la funzione invoca la chiamata
di
+sistema @code{chdir()}. In caso contrario, se la @code{chdir()} non riesce,
+viene aggiornata la variabile @code{ERRNO}:
+
address@hidden
+ if (get_argument(0, AWK_STRING, & newdir)) @{
+ ret = chdir(newdir.str_value.str);
+ if (ret < 0)
+ update_ERRNO_int(errno);
+ @}
address@hidden example
+
+Infine, la funzione restituisce il codice di ritorno da @code{chdir} a
+livello di @command{awk}:
+
address@hidden
+ return make_number(ret, risultato);
address@hidden
address@hidden example
+
+L'estensione @code{stat()} @`e address@hidden impegnativa. Dapprima abbiamo
+una funzione che trasforma la stringa di autorizzazione numerica
+(@dfn{mode}) in una rappresentazione stampabile
+(p.es., il codice ottale @code{0644} diviene @samp{-rw-r--r--}). Questa
+parte @`e qui omessa per address@hidden
+
address@hidden
+/* format_mode --- trasforma il campo @dfn{mode} di @dfn{stat}
+ in qualcosa di leggibile */
+
+static char *
+format_mode(unsigned long fmode)
address@hidden
+ @dots{}
address@hidden
address@hidden example
+
+Viene poi una funzione per leggere dei collegamenti simbolici, anche questa
+omessa per address@hidden:
+
address@hidden
+/* read_symlink --- legge un collegamento simbolico in un buffer
+ allocato.
+ @dots{} */
+
+static char *
+read_symlink(const char *fname, size_t bufsize, ssize_t *linksize)
address@hidden
+ @dots{}
address@hidden
address@hidden example
+
+Due funzioni ausiliarie semplificano l'immissione di valori nel
+vettore che address@hidden il risultato della chiamata a @code{stat()}:
+
address@hidden
+/* array_set --- imposta un elemento di un vettore */
+
+static void
+array_set(awk_array_t vettore, const char *sub, awk_value_t *valore)
address@hidden
+ awk_value_t index;
+
+ set_array_element(vettore,
+ make_const_string(sub, strlen(sub), & index),
+ valore);
+
address@hidden
+
+/* array_set_numeric --- imposta un elemento di un vettore con un
+ numero */
+
+static void
+array_set_numeric(awk_array_t vettore, const char *sub, double num)
address@hidden
+ awk_value_t tmp;
+
+ array_set(vettore, sub, make_number(num, & tmp));
address@hidden
address@hidden example
+
+La seguente funzione fa il grosso del lavoro per riempire il vettore dei
+risultati @code{awk_array_t} con valori ottenuti
+da una @code{struct stat} valida. Questo lavoro @`e fatto in una funzione
+separata per supportare sia la funzione
address@hidden()} per @command{gawk}, che l'estensione @code{fts()},
+che @`e inclusa nello stesso file, ma non
+ @`e mostrata qui
+(@pxref{Esempio di estensione funzioni file}).
+
+La prima parte della funzione @`e la dichiarazione delle variabili,
+compresa una tabella per tradurre i tipi di file in stringhe:
+
address@hidden
+/* fill_stat_array --- fa il lavoro di riempire un
+ vettore con informazioni da stat */
+
+static int
+fill_stat_array(const char *name, awk_array_t vettore, struct stat *sbuf)
address@hidden
+ char *pmode; /* @dfn{mode} stampabile */
+ const char *type = "unknown";
+ awk_value_t tmp;
+ static struct ftype_map @{
+ unsigned int mask;
+ const char *type;
+ @} ftype_map[] = @{
+ @{ S_IFREG, "file" @},
+ @{ S_IFBLK, "blockdev" @},
+ @{ S_IFCHR, "chardev" @},
+ @{ S_IFDIR, "directory" @},
+#ifdef S_IFSOCK
+ @{ S_IFSOCK, "socket" @},
+#endif
+#ifdef S_IFIFO
+ @{ S_IFIFO, "fifo" @},
+#endif
+#ifdef S_IFLNK
+ @{ S_IFLNK, "symlink" @},
+#endif
+#ifdef S_IFDOOR /* Stranezza Solaris */
+ @{ S_IFDOOR, "door" @},
+#endif /* S_IFDOOR */
+ @};
+ int j, k;
address@hidden example
+
+Il vettore di destinazione @`e svuotato di elementi, e poi il codice riempie
+i vari elementi prendendoli dai valori presenti in @code{struct stat}:
address@hidden
+ /* svuota il vettore */
+ clear_array(vettore);
+
+ /* riempie il vettore */
+ array_set(vettore, "name", make_const_string(name, strlen(name),
+ & tmp));
+ array_set_numeric(vettore, "dev", sbuf->st_dev);
+ array_set_numeric(vettore, "ino", sbuf->st_ino);
+ array_set_numeric(vettore, "mode", sbuf->st_mode);
+ array_set_numeric(vettore, "nlink", sbuf->st_nlink);
+ array_set_numeric(vettore, "uid", sbuf->st_uid);
+ array_set_numeric(vettore, "gid", sbuf->st_gid);
+ array_set_numeric(vettore, "size", sbuf->st_size);
+ array_set_numeric(vettore, "blocks", sbuf->st_blocks);
+ array_set_numeric(vettore, "atime", sbuf->st_atime);
+ array_set_numeric(vettore, "mtime", sbuf->st_mtime);
+ array_set_numeric(vettore, "ctime", sbuf->st_ctime);
+
+ /* per dispositivi a blocchi o carattere, aggiunge rdev,
+ e il numero principale e secondario */
+ if (S_ISBLK(sbuf->st_mode) || S_ISCHR(sbuf->st_mode)) @{
+ array_set_numeric(vettore, "rdev", sbuf->st_rdev);
+ array_set_numeric(vettore, "major", major(sbuf->st_rdev));
+ array_set_numeric(vettore, "minor", minor(sbuf->st_rdev));
+ @}
address@hidden example
+
address@hidden
+L'ultima parte della funzione fa alcune aggiunte selettive
+al vettore di destinazione, a seconda che siano disponibili o no
+certi campi e/o il tipo del file. Viene poi restituito zero, per indicare che
+tutto @`e andato bene:
+
address@hidden
+#ifdef HAVE_STRUCT_STAT_ST_BLKSIZE
+ array_set_numeric(vettore, "blksize", sbuf->st_blksize);
+#endif /* HAVE_STRUCT_STAT_ST_BLKSIZE */
+
+ pmode = format_mode(sbuf->st_mode);
+ array_set(vettore, "pmode", make_const_string(pmode, strlen(pmode),
+ & tmp));
+
+ /* per collegamenti simbolici, si aggiunge un campo linkval */
+ if (S_ISLNK(sbuf->st_mode)) @{
+ char *buf;
+ ssize_t linksize;
+
+ if ((buf = read_symlink(name, sbuf->st_size,
+ & linksize)) != NULL)
+ array_set(vettore, "linkval",
+ make_malloced_string(buf, linksize, & tmp));
+ else
+ warning(ext_id, _("stat: non riesco a leggere il \
+collegamento simbolico `%s'"),
+ name);
+ @}
+
+ /* aggiunge il tipo di campo */
+ type = "unknown"; /* non dovrebbe succedere */
+ for (j = 0, k = sizeof(ftype_map)/sizeof(ftype_map[0]); j < k; j++) @{
+ if ((sbuf->st_mode & S_IFMT) == ftype_map[j].mask) @{
+ type = ftype_map[j].type;
+ break;
+ @}
+ @}
+
+ array_set(vettore, "type", make_const_string(type, strlen(type), & tmp));
+
+ return 0;
address@hidden
address@hidden example
+
+Del terzo argomento passato a @code{stat()} non si era ancora parlato.
+Questo argomento @`e facoltativo. Se presente, dice a @code{do_stat()} di
+usare la chiamata di sistema @code{stat()} invece della chiamata di sistema
address@hidden()}. Questo avviene attraverso un puntatore a funzione:
address@hidden
address@hidden @`e inizializzato per puntare a @code{lstat()} (invece che a
address@hidden()}) per ottenere le informazioni relative al file, nel caso che
+il file in questione sia un
+collegamento simbolico. Tuttavia, se il terzo argomento @`e specificato,
address@hidden viene modificato in modo da puntare a @code{stat()}.
+
+Ecco la funzione @code{do_stat()}, che inizia con la dichiarazione delle
+variabili e un controllo degli argomenti passati dal chiamante:
+
address@hidden
+/* do_stat --- fornisce una funzione stat() per gawk */
+
+static awk_value_t *
+do_stat(int nargs, awk_value_t *risultato, struct awk_ext_func *non_usata)
address@hidden
+ awk_value_t file_param, array_param;
+ char *name;
+ awk_array_t vettore;
+ int ret;
+ struct stat sbuf;
+ /* per default si usa lstat() */
+ int (*statfunc)(const char *path, struct stat *sbuf) = lstat;
+
+ assert(risultato != NULL);
address@hidden example
+
+A questo punto inizia l'elaborazione vera e propria. Per prima cosa, la
+funzione esamina gli argomenti.
+Poi, ottiene le informazioni relative al file. Se la funzione chiamata
+(@code{lstat()} o @code{stat()}) restituisce un errore, il codice imposta
address@hidden e torna al chiamante:
+
address@hidden
+ /* file @`e il primo argomento,
+ il vettore per contenere i risultati @`e il secondo */
+ if ( ! get_argument(0, AWK_STRING, & file_param)
+ || ! get_argument(1, AWK_ARRAY, & array_param)) @{
+ warning(ext_id, _("stat: parametri errati"));
+ return make_number(-1, risultato);
+ @}
+
+ if (nargs == 3) @{
+ statfunc = stat;
+ @}
+
+ name = file_param.str_value.str;
+ vettore = array_param.array_cookie;
+
+ /* svuota sempre il vettore all'inizio */
+ clear_array(vettore);
+
+ /* chiama stat per il file;
+ in caso di errore,
+ imposta ERRNO e ritorna */
+ ret = statfunc(name, & sbuf);
+ if (ret < 0) @{
+ update_ERRNO_int(errno);
+ return make_number(ret, risultato);
+ @}
address@hidden example
+
+Il lavoro noioso @`e svolto da @code{fill_stat_array()}, visto in
+precedenza. Alla fine, la funzione restituisce il codice di ritorno
+impostato da @code{fill_stat_array()}:
+
address@hidden
+ ret = fill_stat_array(name, vettore, & sbuf);
+
+ return make_number(ret, risultato);
address@hidden
address@hidden example
+
+Infine, @`e necessario fornire la ``colla'' che aggrega
+le nuove funzioni a @command{gawk}.
+
+L'estensione @code{filefuncs} comprende anche una funzione
address@hidden()}, qui omessa
+(@pxref{Esempio di estensione funzioni file}).
address@hidden anche prevista una funzione di
+inizializzazione:
+
address@hidden
+/* init_filefuncs --- routine di initializazione */
+
+static awk_bool_t
+init_filefuncs(void)
address@hidden
+ @dots{}
address@hidden
address@hidden example
+
+Siamo quasi alla fine. Serve un vettore di strutture @code{awk_ext_func_t}
+per caricare ogni funzione in @command{gawk}:
+
address@hidden
+static awk_ext_func_t func_table[] = @{
+ @{ "chdir", do_chdir, 1, 1, awk_false, NULL @},
+ @{ "stat", do_stat, 3, 2, awk_false, NULL @},
+ @dots{}
address@hidden;
address@hidden example
+
+Ogni estensione deve avere una routine di nome @code{dl_load()} per caricare
+tutto address@hidden che occorre caricare. La cosa address@hidden semplice
@`e di usare la macro
address@hidden()} in @code{gawkapi.h}:
+
address@hidden
+/* definizione della funzione dl_load()
+ usando la macro standard */
+
+dl_load_func(func_table, filefuncs, "")
address@hidden example
+
+Abbiamo finito!
+
address@hidden Usare operazioni interne file
address@hidden Integrare le estensioni
+
address@hidden @command{gawk}, aggiungere address@hidden a
address@hidden address@hidden, aggiungere a @command{gawk}
address@hidden aggiungere address@hidden a @command{gawk}
+Dopo aver scritto il codice, dev'essere possibile aggiungerlo in fase
+di esecuzione all'interprete @command{gawk}. Per prima cosa, il codice
+va compilato. Supponendo che le funzioni siano in
+un file di nome @file{filefuncs.c}, e che @var{idir} sia la posizione
+del file di intestazione @file{gawkapi.h},
+i seguenti address@hidden pratica, si potrebbe decidere di usare
+i comandi GNU Autotools (Automake, Autoconf, Libtool, e @command{gettext})
+per configurare e costruire le librerie necessarie. L'esposizione di come
address@hidden address@hidden essere fatto esula dal tema di questo
@value{DOCUMENT}.
address@hidden per i puntatori a siti Internet che permettono di accedere
+a questi strumenti.} creano una libreria condivisa GNU/Linux:
+
address@hidden
+$ @kbd{gcc -fPIC -shared -DHAVE_CONFIG_H -c -O -g address@hidden filefuncs.c}
+$ @kbd{gcc -o filefuncs.so -shared filefuncs.o}
address@hidden example
+
+Una volta creata la libreria, questa viene caricata usando la parola
+chiave @code{@@load}:
+
address@hidden
+# file testff.awk
+@@load "filefuncs"
+
+BEGIN @{
+ "pwd" | getline curdir # salva la directory corrente
+ close("pwd")
+
+ chdir("/tmp")
+ system("pwd") # verifica l'avvenuto cambio di directory
+ chdir(curdir) # torna indietro
+
+ print "Info per testff.awk"
+ ret = stat("testff.awk", data)
+ print "ret =", ret
+ for (i in data)
+ printf "data[\"%s\"] = %s\n", i, data[i]
+ print "testff.awk modified:",
+ strftime("%m %d %Y %H:%M:%S", data["mtime"])
+
+ print "\nInfo per JUNK"
+ ret = stat("JUNK", data)
+ print "ret =", ret
+ for (i in data)
+ printf "data[\"%s\"] = %s\n", i, data[i]
+ print "JUNK modified:", strftime("%m %d %Y %H:%M:%S", data["mtime"])
address@hidden
address@hidden example
+
+La variabile d'ambiente @env{AWKLIBPATH} dice a
address@hidden dove @`e possibile trovare le estensioni (@pxref{Trovare le
estensioni}).
+La variabile viene impostata alla directory corrente, e quindi viene eseguito
+il programma:
+
address@hidden
+$ @kbd{AWKLIBPATH=$PWD gawk -f testff.awk}
address@hidden /tmp
address@hidden Info per testff.awk
address@hidden ret = 0
address@hidden data["blksize"] = 4096
address@hidden data["devbsize"] = 512
address@hidden data["mtime"] = 1412004710
address@hidden data["mode"] = 33204
address@hidden data["type"] = file
address@hidden data["dev"] = 2053
address@hidden data["gid"] = 1000
address@hidden data["ino"] = 10358899
address@hidden data["ctime"] = 1412004710
address@hidden data["blocks"] = 8
address@hidden data["nlink"] = 1
address@hidden data["name"] = testff.awk
address@hidden data["atime"] = 1412004716
address@hidden data["pmode"] = -rw-rw-r--
address@hidden data["size"] = 666
address@hidden data["uid"] = 1000
address@hidden testff.awk modified: 09 29 2014 18:31:50
address@hidden
address@hidden Info per JUNK
address@hidden ret = -1
address@hidden JUNK modified: 01 01 1970 02:00:00
address@hidden example
+
address@hidden Esempi di estensione
address@hidden Le estensioni di esempio incluse nella distribuzione
@command{gawk}
address@hidden estensioni distribuite con @command{gawk}
+
+Questa @value{SECTION} fornisce una breve panoramica degli esempi di
+estensione inclusi nella distribuzione di @command{gawk}. Alcune di esse
+sono destinate per l'uso in produzione (p.es., le estensioni
address@hidden, @code{readdir}, e
address@hidden). Altre sono state scritte principalmente per mostrare come
+si usa l'estensione API.
+
address@hidden
+* Esempio di estensione funzioni file:: L'esempio che usa funzioni file.
+* Esempio di estensione Fnmatch:: Un'interfaccia a @code{fnmatch()}.
+* Esempio di estensione Fork:: Un'interfaccia a @code{fork()} e
+ altre funzioni di processo.
+* Esempio di estensione Inplace:: Consentire modifica diretta dei file.
+* Esempio di estensione Ord:: Conversioni a valore e a stringa di
+ caratteri.
+* Esempio di estensione Readdir:: Un'interfaccia a @code{readdir()}.
+* Esempio di estensione Revout:: Semplice post-processore per
+ invertire la stringa in output.
+* Esempio di estensione Rev2way:: Processore bidirezionale per
+ invertire la stringa in output.
+* Esempio di estensione Rwarray:: Serializzare il vettore in un
+ file.
+* Esempio di estensione Readfile:: Leggere un intero file in una stringa.
+* Esempio di estensione Time:: Un'interfaccia a @code{gettimeofday()}
+ e @code{sleep()}.
+* Esempio di estensione API Test:: Test per la API.
address@hidden menu
+
address@hidden Esempio di estensione funzioni file
address@hidden Funzioni relative ai file
+
+L'estensione @code{filefuncs} include tre funzioni diverse, come descritto
sotto.
+L'uso @`e il seguente:
+
address@hidden @asis
address@hidden @code{@@load "filefuncs"}
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{chdir()}, estensione
address@hidden estensione @code{chdir()}
address@hidden @code{risultato = chdir("/qualche/directory")}
+La funzione @code{chdir()} invoca a sua volta la chiamata di sistema
address@hidden()} per cambiare la directory corrente. Restituisce zero
+se tutto va bene o un valore minore di zero in caso di errore.
+In quest'ultimo caso, viene aggiornata la variabile @code{ERRNO}.
+
address@hidden @code{stat()}, estensione
address@hidden estensione @code{stat()}
address@hidden @code{risultato = stat("/qualche/percorso", statdata}
address@hidden, address@hidden)}
+La funzione @code{stat()} invoca a sua volta la chiamata di sistema
address@hidden()}.
+Restituisce zero se tutto va bene o un valore minore di zero in caso di
+errore.
+In quest'ultimo caso, viene aggiornata la variabile @code{ERRNO}.
+
+Per default, viene usata la chiamata di sistema @code{lstat()}.
+Tuttavia, se alla funzione viene passato un terzo argomento, questa invoca
+invece @code{stat()}.
+
+In tutti i casi, il vettore @code{statdata} viene preventivamente svuotato.
+Quando la chiamata a @code{stat()} riesce, viene riempito il vettore
address@hidden con le informazioni ottenute dal fileystem, come segue:
+
address@hidden @columnfractions .15 .50 .20
address@hidden Indice @tab Campo in @code{struct stat} @tab Tipo file
address@hidden @code{"name"} @tab Il @value{FN} @tab Tutti
address@hidden @code{"dev"} @tab @code{st_dev} @tab Tutti
address@hidden @code{"ino"} @tab @code{st_ino} @tab Tutti
address@hidden @code{"mode"} @tab @code{st_mode} @tab Tutti
address@hidden @code{"nlink"} @tab @code{st_nlink} @tab Tutti
address@hidden @code{"uid"} @tab @code{st_uid} @tab Tutti
address@hidden @code{"gid"} @tab @code{st_gid} @tab Tutti
address@hidden @code{"size"} @tab @code{st_size} @tab Tutti
address@hidden @code{"atime"} @tab @code{st_atime} @tab Tutti
address@hidden @code{"mtime"} @tab @code{st_mtime} @tab Tutti
address@hidden @code{"ctime"} @tab @code{st_ctime} @tab Tutti
address@hidden @code{"rdev"} @tab @code{st_rdev} @tab Dispositivi
address@hidden @code{"major"} @tab @code{st_major} @tab Dispositivi
address@hidden @code{"minor"} @tab @code{st_minor} @tab Dispositivi
address@hidden @code{"blksize"} @tab @code{st_blksize} @tab Tutti
address@hidden @code{"pmode"} @tab Una versione leggibile del valore
dell'autorizzazione,
+come quello stampato dal comando
address@hidden (per esempio, @code{"-rwxr-xr-x"}) @tab Tutti
address@hidden @code{"linkval"} @tab Il valore del collegamento simbolico @tab
+Collegamenti simbolici
address@hidden @code{"type"} @tab Il tipo del file in formato address@hidden
essere
address@hidden"file"},
address@hidden"blockdev"},
address@hidden"chardev"},
address@hidden"directory"},
address@hidden"socket"},
address@hidden"fifo"},
address@hidden"symlink"},
address@hidden"door"}
+o
address@hidden"unknown"}
+(non tutti i sistemi supportano tutti i tipi file) @tab Tutti
address@hidden multitable
+
address@hidden @code{fts()}, estensione
address@hidden estensione @code{fts()}
address@hidden @code{flags = or(FTS_PHYSICAL, ...)}
address@hidden @code{risultato = fts(pathlist, flags, filedata)}
+Percorre gli alberi di file elencati in @code{pathlist} e riempie il vettore
address@hidden, come descritto qui di seguito. @code{flags} @`e l'operazione
address@hidden @dfn{bit} a @dfn{bit} di parecchi valori predefiniti, pure
descritti
address@hidden sotto.
+Restituisce zero in assenza di errori, in caso contrario restituisce @minus{}1.
address@hidden table
+
+La funzione @code{fts()} invoca a sua volta la routine di libreria C
address@hidden()} per percorrere gerarchie di file. Invece di restituire i dati
+relativi ai file uno per volta in sequenza,
+riempie un vettore multidimensionale con i dati di ogni file e directory
+che risiedono nelle gerarchie richieste.
+
+Gli argomenti sono i seguenti:
+
address@hidden @code
address@hidden pathlist
+Un vettore di @value{FNS}. Sono usati i valori dei singoli elementi;
+gli indici che puntano a tali valori vengono ignorati.
+
address@hidden flags
+Questo dovrebbe essere l'@dfn{OR} @dfn{bit} a @dfn{bit} di uno o
address@hidden dei
+seguenti valori dei flag costanti predefiniti.
+Almeno uno dei due flag @code{FTS_LOGICAL}
+o @code{FTS_PHYSICAL} dev'essere impostato; in caso contrario
address@hidden()} restituisce una segnalazione di errore e imposta @code{ERRNO}.
+I flag sono:
+
address@hidden nested table
address@hidden @code
address@hidden FTS_LOGICAL
+Passa in rassegna i file in modo ``logico'', e quindi l'informazione restituita
+per un collegamento simbolico @`e quella relativa al file puntato, e non al
+collegamento simbolico stesso. Questo flag @`e mutuamente esclusivo con
address@hidden
+
address@hidden FTS_PHYSICAL
+Passa in rassegna i file in modo ``fisico'', e quindi l'informazione restituita
+per un collegamento simbolico @`e quella relativa al collegamento simbolico
+stesso. Questo flag @`e mutuamente esclusivo con @code{FTS_LOGICAL}.
+
address@hidden FTS_NOCHDIR
+Per migliorare le prestazioni, la routine di libreria C @code{fts()}
+cambia directory mentre percorre una gerarchia di file. Questo flag
+disabilita quell'ottimizzazione.
+
address@hidden FTS_COMFOLLOW
+Si accede al file puntato da un collegamento simbolico esistente in
@code{pathlist},
+anche se @code{FTS_LOGICAL} non @`e stato impostato.
+
address@hidden FTS_SEEDOT
+Per default, la routine di libreria C @code{fts()} non restituisce
+informazioni per i file
address@hidden"."} (punto) e @file{".."} (punto-punto). Quest'opzione richiede
+l'informazione anche per @file{".."}. (L'estensione ritorna sempre
+l'informazione per @file{"."}; maggiori dettagli address@hidden sotto.)
+
address@hidden FTS_XDEV
+Mentre si percorre un filesystem, non passare mai a un filesystem montato
+diverso da quello in cui si opera.
address@hidden address@hidden succedere nel caso di collegamenti simbolici, che
contengono un nome di file
address@hidden che si trova da tutt'altra parte
address@hidden lrwxrwxrwx 1 root root 6 ago 6 2015 /aca -> /d/aca
address@hidden /d/aca:
address@hidden /dev/sda6 115234344 15648380 93709280 15% /d
address@hidden / (e il collegamento simbolico /aca)
address@hidden /dev/sda1 37308224 13573368 21816644 39% /
address@hidden table
+
address@hidden filedata
+Il vettore @code{filedata} contiene i risultati.
+La funzione @code{fts()} lo svuota all'inizio. In seguito viene creato
+un elemento in @code{filedata} per ogni elemento in @code{pathlist}.
+L'indice @`e il nome della directory o del file specificato in @code{pathlist}.
+L'elemento puntato da questo indice @`e a sua volta un vettore. Ci sono due
+casi:
+
address@hidden nested table
address@hidden @emph
address@hidden Il percorso @`e un file
+In questo caso, il vettore contiene due o tre elementi:
+
address@hidden doubly nested table
address@hidden @code
address@hidden "path"
+Il percorso completo di questo file, a partire dalla directory radice
(``root'')
+indicata nel vettore @code{pathlist}.
+
address@hidden "stat"
+Questo elemento @`e esso stesso un vettore, contenente le stesse informazioni
+fornite dalla funzione @code{stat()} vista in precedenza a proposito del suo
+argomento
address@hidden L'elemento address@hidden non essere presente se la chiamata
+di sistema @code{stat()} per il file non @`e riuscita.
+
address@hidden "error"
+Se qualche tipo di errore si verifica durante l'elaborazione, il vettore
address@hidden anche un elemento con chiave @code{"error"}, che @`e una stringa
+che descrive l'errore.
address@hidden table
+
address@hidden Il percorso @`e una directory
+In questo caso, nel vettore viene creato un elemento per ogni elemento
+contenuto nella directory. Se un elemento della directory @`e un
+file, l'azione del programma @`e la stessa descritta sopra per un file.
+Se invece la directory contiene delle sottodirectory, l'elemento creato
+nel vettore @`e (ricorsivamente) a sua volta un vettore che descrive la
+sottodirectory. Se fra i flag @`e stato
+specificato il flag @code{FTS_SEEDOT},
+ci address@hidden anche un elemento di nome
address@hidden".."}. Questo elemento address@hidden un vettore contenente i
dati restituiti
+da un'invocazione di @code{stat()}.
+
+Inoltre, ci address@hidden un elemento il cui indice @`e @code{"."}.
+Questo elemento @`e un vettore contenente gli stessi due o tre elementi che
+sono messi a disposizione per un file: @code{"path"}, @code{"stat"},
+ed @code{"error"}.
address@hidden table
address@hidden table
+
+La funzione @code{fts()} restituisce zero in assenza di errori.
+in caso contrario, restituisce @minus{}1.
+
address@hidden NOTA
+L'estensione @code{fts()} non imita esattamente l'interfaccia fornita dalla
+routine di libreria C @code{fts()}, ma sceglie di fornire un'interfaccia
+basata sui vettori associativi, che @`e address@hidden adeguata per l'uso da
parte di un
+programma @command{awk}. Questo
+implica la mancanza di una funzione di
+confronto, poich@'e @command{gawk} address@hidden
+prevede la address@hidden di mettere facilmente nell'ordine desiderato gli
+elementi di un vettore.
+Anche se un'interfaccia modellata su @code{fts_read()} avrebbe potuto essere
+fornita, @`e sembrato address@hidden naturale mettere a disposizione un vettore
+multidimensionale, che rappresenta la gerarchia dei file e le informazioni
+relative a ognuno di essi.
address@hidden quotation
+
+Si veda il file @file{test/fts.awk} nella distribuzione di @command{gawk}
+per un esempio di uso dell'estensione @code{fts()}.
+
address@hidden Esempio di estensione Fnmatch
address@hidden Un'interfaccia a @code{fnmatch()}
+
+Quest'estensione fornisce un'interfaccia per utilizzare la funzione di
+libreria C @code{fnmatch()}. Si usa address@hidden@dotless{i}}:
+
address@hidden @code
address@hidden @@load "fnmatch"
address@hidden questo il modo per caricare l'estensione.
+
address@hidden @code{fnmatch()}, estensione
address@hidden estensione @code{fnmatch()}
address@hidden risultato = fnmatch(pattern, stringa, flags)
+Il valore restituito @`e zero se tutto va bene, oppure @code{FNM_NOMATCH}
+se la funzione non ha trovato alcuna corrispondenza, o
+un valore differente, diverso da zero, se si @`e verificato un errore.
address@hidden table
+
+Oltre a rendere disponibile la funzione @code{fnmatch()}, l'estensione
+di @code{fnmatch} definisce una costante (@code{FNM_NOMATCH}), e un vettore
+con dei valori di flag, di nome @code{FNM}.
+
+Gli argomenti per @code{fnmatch()} sono:
+
address@hidden @code
address@hidden pattern
+L'espressione regolare con cui confrontare @value{FN}
+
address@hidden stringa
+La stringa @value{FN}
+
address@hidden flags
address@hidden valere zero o essere l'@dfn{OR} @dfn{bit} a @dfn{bit} di uno o
address@hidden flag
+nel vettore @code{FNM}
address@hidden table
+
+I flag sono i seguenti:
+
address@hidden @columnfractions .40 .60
address@hidden Elemento del vettore @tab Flag corrispondente definito da
@code{fnmatch()}
address@hidden @code{FNM["CASEFOLD"]} @tab @code{FNM_CASEFOLD}
address@hidden @code{FNM["FILE_NAME"]} @tab @code{FNM_FILE_NAME}
address@hidden @code{FNM["LEADING_DIR"]} @tab @code{FNM_LEADING_DIR}
address@hidden @code{FNM["NOESCAPE"]} @tab @code{FNM_NOESCAPE}
address@hidden @code{FNM["PATHNAME"]} @tab @code{FNM_PATHNAME}
address@hidden @code{FNM["PERIOD"]} @tab @code{FNM_PERIOD}
address@hidden multitable
+
+Ecco un esempio:
+
address@hidden
+@@load "fnmatch"
address@hidden
+flags = or(FNM["PERIOD"], FNM["NOESCAPE"])
+if (fnmatch("*.a", "pippo.c", flags) == FNM_NOMATCH)
+ print "nessuna corrispondenza"
address@hidden example
+
address@hidden Esempio di estensione Fork
address@hidden Un'interfaccia a @code{fork()}, @code{wait()}, e @code{waitpid()}
+
+L'estensione @code{fork} mette a disposizione tre funzioni, come segue:
+
address@hidden @code
address@hidden @@load "fork"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{fork()}, estensione
address@hidden estensione @code{fork()}
address@hidden pid = fork()
+Questa funzione crea un nuovo processo. Il valore restituito @`e zero nel
+processo ``figlio'' e il numero che identifica il nuovo processo
+(@dfn{pid}) nel processo ``padre'', o @minus{}1
+in caso di errore. In quest'ultimo caso, @code{ERRNO} indica il problema.
+Nel processo figlio, gli elementi @code{PROCINFO["pid"]} e
address@hidden"ppid"]} vengono aggiornati per riflettere i valori corretti.
+
address@hidden @code{waitpid()}, estensione
address@hidden estensione @code{waitpid()}
address@hidden ret = waitpid(pid)
+Questa funzione ha un unico argomento numerico, l'identificativo del processo
+di cui aspettare l'esito. Il valore di ritorno @`e quello restituito dalla
+chiamata di sistema @code{waitpid()}.
+
address@hidden @code{wait()}, estensione
address@hidden estensione @code{wait()}
address@hidden ret = wait()
+Questa funzione attende che il primo processo ``figlio'' termini.
+Il valore restituito @`e quello della chiamata di sistema @code{wait()}.
address@hidden table
+
+Non c'@`e una funzione corrispondente alla chiamata di sistema @code{exec()}.
+
+Ecco un esempio:
+
address@hidden
+@@load "fork"
address@hidden
+if ((pid = fork()) == 0)
+ print "salve dal processo figlio"
+else
+ print "salve dal processo padre"
address@hidden example
+
address@hidden Esempio di estensione Inplace
address@hidden Consentire la modifica in loco dei file
+
address@hidden @code{inplace}, estensione
address@hidden estensione @code{inplace}
+L'estensione @code{inplace} svolge un lavoro simile a quello
+dell'opzione @option{-i} nel programma di address@hidden GNU @command{sed},
+che svolge delle funzioni di modifica ``al volo'' su ogni file in input.
+Viene usato il file @file{inplace.awk}, caricato dinamicamente, per richiamare
+l'estensione in maniera corretta:
+
address@hidden
address@hidden file eg/lib/inplace.awk
address@hidden
+# inplace --- carica e richiama l'estensione inplace.
+
+@@load "inplace"
+
+# @`E buona cosa impostare INPLACE_SUFFIX in modo da fare
+# una copia di backup.
+# Per esempio, si potrebbe impostare INPLACE_SUFFIX a .bak
+# sulla riga di comando, o in una regola BEGIN.
+
+# Per default, ogni file specificato sulla riga di comando
+# address@hidden modificato sovrascrivendo il file originale.
+# Ma @`e possibile evitarlo specificando l'argomento inplace=0
+# davanti al nome del file che non si desidera elaborare in questo modo.
+# Si address@hidden poi abilitare di nuovo l'aggiornamento diretto del file
+# sulla riga di comando, specificando inplace=1 prima del file
+# che si vuole modificare direttamente.
+
+# N.B. La funzione inplace_end() @`e invocata nelle regole
+# BEGINFILE ed END, in modo che ogni eventuale azione
+# in una regola ENDFILE address@hidden ridiretta come previsto.
+
+BEGIN @{
+ inplace = 1 # abilitato per default
address@hidden
+
+BEGINFILE @{
+ if (_inplace_filename != "")
+ inplace_end(_inplace_filename, INPLACE_SUFFIX)
+ if (inplace)
+ inplace_begin(_inplace_filename = FILENAME, INPLACE_SUFFIX)
+ else
+ _inplace_filename = ""
address@hidden
+
+END @{
+ if (_inplace_filename != "")
+ inplace_end(_inplace_filename, INPLACE_SUFFIX)
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+Per ogni file elaborato, l'estensione ridirige lo
+standard output verso un file temporaneo definito in modo da avere lo stesso
+proprietario e le stesse autorizzazioni del file originale. Dopo che il file
address@hidden stato elaborato, l'estensione riporta lo standard output alla sua
+destinazione originale.
+Se @code{INPLACE_SUFFIX} non @`e una stringa vuota, il file originale @`e
+collegato a un @value{FN} di backup, creato aggiungendo il
+suffisso al nome originale.
+Infine, il file temporaneo @`e rinominato in modo da essere lo stesso del
address@hidden originario.
+
+Si noti che l'uso di questa address@hidden address@hidden essere controllato
+specificando @samp{inplace=0} sulla riga di comando, prima del nome del file
+che non dovrebbe essere elaborato come appena descritto. Si address@hidden
richiedere
+ancora l'aggiornamento diretto di un file, specificando l'argomento
address@hidden davanti al nome del file da elaborare in maniera diretta.
+
+La variabile @code{_inplace_filename} serve per tener traccia del nome del
+file corrente, in modo da non eseguire la funzione @code{inplace_end()} prima
+di aver elaborato il primo file.
+
+Se si verifica un errore, l'estensione emette un messaggio di errore fatale
+per terminare l'elaborazione immediatamente, senza danneggiare il
+file originale.
+
+Ecco alcuni semplici esempi:
+
address@hidden
+$ @kbd{gawk -i inplace '@{ gsub(/pippo/, "pluto") @}; @{ print @}' file1 file2
file3}
address@hidden example
+
+Per mantenere una copia di backup del file originale, si provi a fare
address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{gawk -i inplace -v INPLACE_SUFFIX=.bak '@{ gsub(/pippo/, "pluto") @}}
+> @address@hidden print @}' file1 file2 file3}
address@hidden example
+
+Si noti che, anche se l'estensione tenta di mantenere il proprietario e i
+permessi di accesso del file originario, non viene tentata la copia degli
+ulteriori permessi di accesso
+(@dfn{ACL - Access Control Lists}) del file originale.
+
+Se il programma termina prima del previsto, come potrebbe succedere se riceve
+dal sistema un segnale non gestito, address@hidden lasciare come residuo un
file
+temporaneo.
+
address@hidden Esempio di estensione Ord
address@hidden Caratteri e valori numerici: @code{ord()} e @code{chr()}
+
+L'estensione @code{ordchr} aggiunge due funzioni, di nome
address@hidden()} e @code{chr()}, come segue:
+
address@hidden @code
address@hidden @@load "ordchr"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{ord()}, estensione
address@hidden estensione @code{Ord}
address@hidden numero = ord(stringa)
+Restituisce il valore numerico del primo carattere in @code{stringa}.
+
address@hidden @code{Chr}, estensione
address@hidden estensione @code{Chr}
address@hidden char = chr(number)
+Restituisce una stringa il cui primo carattere @`e quello rappresentato
+da @code{number}.
address@hidden table
+
+Queste funzioni sono ispirate alle funzioni del linguaggio Pascal
+dallo stesso nome. Ecco un esempio:
+
address@hidden
+@@load "ordchr"
address@hidden
+printf("Il valore numerico di 'A' @`e %d\n", ord("A"))
+printf("Il valore come stringa di 65 @`e %s\n", chr(65))
address@hidden example
+
address@hidden Esempio di estensione Readdir
address@hidden Leggere directory
+
+L'estensione @code{readdir} aggiunge un analizzatore di input
+per esaminare directory.
+L'uso @`e il seguente:
+
address@hidden @code{readdir}, estensione
address@hidden estensione @code{readdir}
address@hidden
+@@load "readdir"
address@hidden example
+
+Quando quest'estensione @`e in uso, invece che saltare le
+directory presenti sulla riga di comando, (o accedute tramite @code{getline}),
+queste sono lette, e ogni elemento della directory @`e restituito come
+un record.
+
+Il record consiste di tre campi. I primi due sono il numero di @dfn{inode} e
+il @value{FN}, separati fra loro da una barra.
+Nei sistemi in cui l'elemento di directory contiene il tipo del file,
+il record ha un terzo campo (pure separato da una barra), composto da una
+sola lettera, che indica il tipo del file. Le lettere e i tipi di file a cui
+corrispondono sono mostrate in @ref{table-readdir-file-types}.
+
address@hidden Tabella,table-readdir-file-types
address@hidden file restituiti dall'estensione @code{readdir}}
address@hidden @columnfractions .1 .9
address@hidden Lettera @tab Tipo di file
address@hidden @code{b} @tab Dispositivo a blocchi
address@hidden @code{c} @tab Dispositivo a caratteri
address@hidden @code{d} @tab Directory
address@hidden @code{f} @tab File normale
address@hidden @code{l} @tab Collegamento simbolico
address@hidden @code{p} @tab @dfn{pipe} con nome (FIFO)
address@hidden @code{s} @tab @dfn{socket}
address@hidden @code{u} @tab Tutto il resto (sconosciuto)
address@hidden multitable
address@hidden float
+
+Nei sistemi che non contengono l'informazione sul tipo del file, il terzo
+campo @`e sempre @samp{u}.
+
address@hidden NOTA
+Nei sistemi GNU/Linux, ci sono fileystem che non supportano il campo
address@hidden (si veda la pagina di manuale @i{readdir}(3)), e in questo caso
+il tipo di file @`e sempre @samp{u}. Si address@hidden usare l'estensione
address@hidden per chiamare @code{stat()} e ottenere l'informazione
+corretta sul tipo di file.
address@hidden quotation
+
+Ecco un esempio:
+
address@hidden
+@@load "readdir"
address@hidden
+BEGIN @{ FS = "/" @}
address@hidden print "@value{FN} @`e", $2 @}
address@hidden example
+
address@hidden Esempio di estensione Revout
address@hidden Invertire la stringa in output
+
+L'estensione @code{revoutput} aggiunge un semplice processore
+di output che inverte i caratteri di ogni riga in output. Serve a dimostrare
+come @`e possibile scrivere un processore di output, anche se address@hidden
essere
+a prima vista vagamente divertente.
+Ecco un esempio:
+
address@hidden @code{revoutput}, estensione
address@hidden estensione @code{revoutput}
address@hidden
+@@load "revoutput"
+
+BEGIN @{
+ REVOUT = 1
+ print "non v'allarmate" > "/dev/stdout"
address@hidden
address@hidden example
+
+L'output di questo programma @`e @samp{etamralla'v non}.
+
address@hidden Esempio di estensione Rev2way
address@hidden Esempio di I/O bidirezionale
+
+L'estensione @code{revtwoway} aggiunge un semplice processore
+bidirezionale che inverte i caratteri di ogni riga che riceve, per farla
+poi rileggere dal programma @command{awk}. Il motivo per cui @`e stata scritta
address@hidden quello di mostrare come si scrive un processore bidirezionale,
anche se address@hidden
+sembrare un programma vagamente divertente.
+Il seguente esempio mostra come usarlo:
+
address@hidden @code{revtwoway}, estensione
address@hidden estensione @code{revtwoway}
address@hidden
+@@load "revtwoway"
+
+BEGIN @{
+ cmd = "/specchio/magico"
+ print "non v'allarmate" |& cmd
+ cmd |& getline risultato
+ print risultato
+ close(cmd)
address@hidden
address@hidden example
+
+L'output di questo programma
address@hidden
+anche in questo caso @`e:
address@hidden ifnotinfo
address@hidden
address@hidden:
address@hidden ifinfo
address@hidden'v non}.
+
address@hidden Esempio di estensione Rwarray
address@hidden Scaricare e ricaricare un vettore
+
+L'estensione @code{rwarray} aggiunge due funzioni,
+di nome @code{writea()} e @code{reada()}, come segue:
+
address@hidden @code
address@hidden @@load "rwarray"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{writea()}, estensione
address@hidden estensione @code{writea()}
address@hidden ret = writea(file, vettore)
+Questa funzione ha come argomento una stringa, che @`e il nome del file
+sul quale scaricare il vettore, e il vettore stesso @`e il secondo argomento.
address@hidden()} @`e in grado di gestire vettori di vettori. Restituisce il
+valore uno se completa il lavoro o zero se non va a buon fine.
+
address@hidden @code{reada()}, estensione
address@hidden estensione @code{reada()}
address@hidden ret = reada(file, vettore)
address@hidden()} @`e la funzione inversa di @code{writea()};
+legge il file il cui nome @`e fornito come primo argomento, riempiendo 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.
address@hidden table
+
+Il vettore creato da @code{reada()} @`e identico a quello scritto da
address@hidden()} nel senso che i contenuti sono gli stessi. Tuttavia,
+per come @`e strutturata la funzione, l'ordine di attraversamento del vettore
+ricreato @`e quasi certamente differente da quello del vettore originale.
+Poich@'e l'ordine di attraversamento di un vettore @`e, per default, indefinito
+in @command{awk}, questo non @`e (tecnicamente) un problema. Se serve che
+l'attraversamento del vettore avvenga in un ordine preciso, si possono usare
+le address@hidden di ordinamento di un vettore disponibili in @command{gawk}
+(@pxref{Ordinamento di vettori}).
+
+Il file contiene dati in formato binario. Tutti i valori interi sono scritti
+in @dfn{network byte address@hidden@`e, nella maniera con cui sarebbero
+normalmente scritti in un testo, con le cifre address@hidden significative del
+numero contenute nella parte sinistra, e quelle meno significative
+nella parte destra della rappresentazione binaria del numero.}.
+Tuttavia, i valori in virgola mobile a doppia precisione sono scritti come
+dati binari nativi. Quindi, vettori che contengono solo dati in formato
+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.
+
+Ecco un esempio:
+
address@hidden
+@@load "rwarray"
address@hidden
+ret = writea("scaricato.bin", vettore)
address@hidden
+ret = reada("scaricato.bin", vettore)
address@hidden example
+
address@hidden Esempio di estensione Readfile
address@hidden Leggere un intero file in una stringa
+
+L'estensione @code{readfile} aggiunge una sola funzione
+di nome @code{readfile()}, e un analizzatore di input:
+
address@hidden @code
address@hidden @@load "readfile"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{readfile()}, estensione
address@hidden estensione @code{readfile()}
address@hidden risultato = readfile("/qualche/persorso")
+L'argomento @`e il nome del file da leggere. Il valore restituito @`e una
+stringa contenente l'intero contenuto del file richiesto. In caso di errore,
+la funzione restituisce la stringa vuota e imposta @code{ERRNO}.
+
address@hidden BEGIN @{ PROCINFO["readfile"] = 1 @}
+Inoltre, l'estensione aggiunge un analizzatore di input che @`e attivato se
+l'elemento @code{PROCINFO["readfile"]} esiste.
+Quando l'analizzatore @`e attivato, ogni file in input @`e restituito
interamente
+come @code{$0}.
+La variabile @code{RT} @`e impostata alla stringa nulla.
address@hidden table
+
+Ecco un esempio:
+
address@hidden
+@@load "readfile"
address@hidden
+contents = readfile("/percorso/del/file");
+if (contents == "" && ERRNO != "") @{
+ print("problema in lettura file", ERRNO) > "/dev/stderr"
+ ...
address@hidden
address@hidden example
+
address@hidden Esempio di estensione Time
address@hidden Funzioni dell'estensione time
+
+L'estensione @code{time} aggiunge due funzioni, di nome
address@hidden()} e @code{sleep()}, come segue:
+
address@hidden @code
address@hidden @@load "time"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{gettimeofday()}, estensione
address@hidden estensione @code{gettimeofday()}
address@hidden ora_corrente = gettimeofday()
+Restituisce il numero di secondi trascorsi dalle ore 00:00 del giorno
+01/01/1970 UTC come valore a virgola mobile.
+Se questa informazione non @`e disponibile nella piattaforma in uso,
+restituisce @minus{}1 e imposta @code{ERRNO}. Il valore fornito dovrebbe
+avere la precisione di una frazione di
+secondo, ma la precisione effettiva address@hidden variare a seconda della
+piattaforma.
+Se la chiamata di sistema standard C @code{gettimeofday()} @`e disponibile
+nella piattaforma in uso, questo @`e il valore restituito. In caso contrario,
+se si sta lavorando con MS-Windows, la chiamata di sistema @`e fatta a
address@hidden()}.
+
address@hidden @code{sleep()}, estensione
address@hidden estensione @code{sleep()}
address@hidden risultato = sleep(@var{secondi})
+Il programma @command{gawk} resta inattivo (dorme) per i @var{secondi}
+specificati. Se @var{secondi} ha un valore negativo,
+o la chiamata di sistema non riesce, restituisce @minus{}1 e imposta
@code{ERRNO}.
+In caso contrario, restituisce zero dopo aver lasciato trascorrere
+la address@hidden di tempo indicata.
+Si noti che @var{secondi} address@hidden essere un numero a virgola mobile
(non solo un
+numero intero).
+Dettagli di implementazione: a seconda della address@hidden nel sistema in uso,
+questa funzione tenta di usare @code{nanosleep()} o @code{select()} per
+ottenere il tempo di attesa richiesto.
address@hidden table
+
address@hidden Esempio di estensione API Test
address@hidden Test per la API
address@hidden @code{testext}, estensione
address@hidden estensione @code{testext}
+
+L'estensione @code{testext} controlla la address@hidden di
+parti dell'API delle estensioni che non sono utilizzate negli altri esempi.
+Il file @file{extension/testext.c}
+contiene sia il codice C per l'estensione che il codice @command{awk}
+(tra i commenti del codice C) per eseguire i test. L'ambiente di test
+estrae il codice sorgente @command{awk} ed esegue i test. Si veda il file
+sorgente per maggiori informazioni.
+
address@hidden gawkextlib
address@hidden Il progetto @code{gawkextlib}
address@hidden @code{gawkextlib}, estensioni
address@hidden estensioni, @code{gawkextlib}
address@hidden estensioni, dove trovarle
+
address@hidden @code{gawkextlib}, progetto
address@hidden progetto @code{gawkextlib}
+Il progetto @uref{http://sourceforge.net/projects/gawkextlib/,
@code{gawkextlib}}
+fornisce varie estensioni per @command{gawk}, compresa una per
+l'elaborazione dei file XML. Questa @`e un'evoluzione del progetto noto come
address@hidden (XML @command{gawk}).
+
+Al momento della stesura di questo testo, ci sono otto estensioni:
+
address@hidden @value{BULLET}
address@hidden
+Estensione @code{errno}
+
address@hidden
+Estensione GD graphics library
+
address@hidden
+Estensione libreria MPFR
+(fornisce l'accesso a varie funzioni MPFR non previste dal supporto nativo
+di MPFR disponibile in @command{gawk})
+
address@hidden
+Estensione PDF
+
address@hidden
+Estensione PostgreSQL
+
address@hidden
+Estensione Redis
+
address@hidden
+Estensione Select
+
address@hidden
+Estensione analizzatore XML, usando la libreria di analisi XML
address@hidden://expat.sourceforge.net, Expat}
address@hidden itemize
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
+Si address@hidden scaricare il codice del progetto @code{gawkextlib}
+usando il codice sorgente mantenuto tramite
address@hidden://git-scm.com, Git}.
+Il comando per farlo @`e il seguente:
+
address@hidden
+git clone git://git.code.sf.net/p/gawkextlib/code gawkextlib-code
address@hidden example
+
address@hidden Expat, libreria per analizzare XML
address@hidden XML, Expat, libreria per analizzare
+Per poter compilare e usare l'estensione XML, @`e necessario installare
+la libreria di analisi XML @uref{http://expat.sourceforge.net, Expat}.
+
+Inoltre, @`e necessario installare gli strumenti GNU Autotools
+(@uref{http://www.gnu.org/software/autoconf, Autoconf},
address@hidden://www.gnu.org/software/automake, Automake},
address@hidden://www.gnu.org/software/libtool, Libtool}
+e
address@hidden://www.gnu.org/software/gettext, GNU @command{gettext}}).
+
+La semplice procedura per compilare e testare @code{gawkextlib} @`e la
seguente.
+Dapprima, occorre compilare e installare @command{gawk}:
+
address@hidden
+cd .../percorso/del/sorgente/gawk
+./configure --prefix=/tmp/newgawk @ii{Installa in /tmp/newgawk per ora}
+make && make check @ii{Compila e controlla che tutto sia a
posto}
+make install @ii{Installa gawk}
address@hidden example
+
+Poi, dal sito @url{http://sourceforge.net/projects/gawkextlib/files} si deve
+scaricare @code{gawkextlib} e le estensioni che si vogliono installare.
+Il file @file{README} del sito spiega come compilare il codice. Se si @`e
+installato @command{gawk} in una posizione non-standard, occorre
+specificare @code{./configure address@hidden/percorso/del/programma/gawk}}
+per far address@hidden@dotless{i}} che venga trovato.
address@hidden essere necessario usare il programma di address@hidden
@command{sudo}
+per installare sia @command{gawk} che @code{gawkextlib}, a seconda di come
+funziona il sistema su cui si lavora.
+
+Chi scrive un'estensione e desidera condividerla con altri utenti
address@hidden, address@hidden prendere in considerazione l'idea di farlo
attraverso
+il progetto @code{gawkextlib}.
+Si veda il sito web del progetto per maggiori informazioni.
+
address@hidden Sommario delle estensioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Si possono scrivere estensioni (dette anche @dfn{plug-in})
+per @command{gawk}
+nel linguaggio C o C++ usando l'interfaccia di programmazione applicativa
+(API) definita dagli sviluppatori di
address@hidden
+
address@hidden
+Le estensioni devono avere una licenza compatibile con la
+GNU General Public License (GPL), e devono dichiararlo definendo un'apposita
+variabile di nome
address@hidden
+
address@hidden
+La comunicazione tra @command{gawk} e un'estensione @`e bidirezionale.
address@hidden passa all'estensione una struttura (@code{struct}) che contiene
+vari campi di dati e puntatori a funzione. L'estensione address@hidden poi
chiamare
+funzioni all'interno di @command{gawk} tramite dei puntatori a funzioni
+per svolgere alcuni compiti.
+
address@hidden
+Uno di questi compiti @`e di ``registrare'' il nome e l'implementazione di
+nuove funzioni a livello di @command{awk} con @command{gawk}.
+L'implementazione ha la forma di un puntatore del linguaggio C,
+cui @`e associato un dato livello di versione.
+Per convenzione, le funzioni di implementazione hanno nome
address@hidden@var{XXXX}()} per una funzione a livello di @command{awk} di nome
address@hidden@var{XXXX}()}.
+
address@hidden
+L'API @`e definita in un file di intestazione di nome @file{gawkapi.h}.
+Occorre includere alcuni file di intestazione standard @emph{prima} di
+includere tale intestazione nel codice sorgente.
+
address@hidden
+Vengono forniti dei puntatori a funzioni dell'API per i seguenti tipi di
+operazioni:
+
address@hidden @value{BULLET}
address@hidden
+Allocare, riallocare, e liberare memoria
+
address@hidden
+Registrare funzioni (si possono registrare
+funzioni di estensione,
+funzioni ausiliarie di pulizia (@dfn{callbacks}),
+una stringa di versione,
+degli analizzatori di input,
+dei processori di output,
+e dei processori bidirezionali)
+
address@hidden
+Stampare messaggi fatali, non fatali, di avvertimento, e avvertimenti ``lint''
+
address@hidden
+Aggiornare @code{ERRNO} o annullarlo
+
address@hidden
+Accedere a parametri, come pure convertire un parametro di tipo non definito
+in un vettore
+
address@hidden
+Accedere alla tabella dei simboli (ricuperare il valore di una
+variabile globale, crearne una nuova o modificarne una esistente)
+
address@hidden
+Creare e rilasciare valori nascosti; questo consente di usare in modo
+efficiente lo stesso valore per address@hidden variabili e address@hidden
migliorare di molto le
+prestazioni del programma
+
address@hidden
+Manipolare vettori
+(ricuperare, aggiungere, cancellare e modificare elementi;
+ottenere il numero di elementi in un vettore;
+creare un nuovo vettore;
+svuotare un vettore;
+e
+appiattire un vettore per poterlo percorrere facilmente con un ciclo in
+stile C, visitando tutti i suoi indici ed elementi)
address@hidden itemize
+
address@hidden
+L'API definisce diversi tipi di dati standard per rappresentare
+valori di variabili, elementi di vettore e vettori presenti in @command{awk}.
+
address@hidden
+L'API fornisce funzioni di servizio per definire dei valori.
+Sono anche disponibili funzioni di gestione della memoria, per assicurare
+la address@hidden fra memoria allocata da @command{gawk} e memoria allocata da
+un'estensione.
+
address@hidden
address@hidden la memoria passata da @command{gawk} a un'estensione dev'essere
+considerata come in sola lettura dall'estensione.
+
address@hidden
address@hidden la memoria passata da un'estensione a @command{gawk} deve
+essere ottenuta dalle funzioni di allocazione della memoria previste
+dall'API. @command{gawk} @`e responsabile per la gestione di quella memoria e
+la libera quando @`e il momento per farlo.
+
address@hidden
+L'API fornisce informazioni sulla versione di @command{gawk} in
+esecuzione, in modo che un'estensione possa verificare la propria
address@hidden
+con la versione di @command{gawk} da cui @`e stata caricata.
+
address@hidden
address@hidden address@hidden facile iniziare a programmare una nuova
estensione usando il
+codice predefinito descritto in questo @value{CHAPTER}. Alcune macro nel
+file di intestazione @file{gawkapi.h} rendono la cosa address@hidden agevole.
+
address@hidden
+La distribuzione di @command{gawk} comprende un numero di piccoli ma utili
+esempi di estensione. Il progetto @code{gawkextlib} include diverse altre
+estensioni, di maggiori dimensioni.
+Per chi desideri scrivere un'estensione e metterla a disposizione della
address@hidden degli utenti di @command{gawk}, il progetto @code{gawkextlib}
address@hidden il posto adatto per farlo.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi sulle estensioni
address@hidden Esercizi
+
address@hidden
address@hidden
+Aggiungere funzioni per rendere disponibili chiamate di sistema come
address@hidden()}, @code{chmod()} e @code{umask()} nelle estensioni che
+operano con i file viste
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden interne file}.
+
address@hidden Idea from comp.lang.awk, February 2015
address@hidden
+Scrivere un analizzatore di input che stampi un prompt se l'input proviene
+da un dispositivo che sia un ``terminale''. Si address@hidden usare la
funzione
address@hidden()} per sapere se il file in input @`e un terminale.
+(Suggerimento: questa funzione
+normalmente usa parecchie risorse quando @`e richiamata; si tenti di chiamarla
+una volta sola.)
+Il contenuto del prompt dovrebbe provenire da una variabile che sia possibile
+impostare a livello di codice @command{awk}.
+Si address@hidden inviare il prompt allo standard error. Tuttavia,
+per ottenere risultati migliori, @`e meglio aprire un nuovo descrittore di file
+(o puntatore a un file)
+sul file @file{/dev/tty} e stampare il prompt su quel file, nel caso
+in cui lo standard error sia stato ridiretto.
+
+Perch@'e lo standard error @`e una scelta migliore dello
+standard output per scrivere il prompt?
+Quale meccanismo di lettura andrebbe sostituito, quello che legge un record
+o quello che legge dei semplici byte?
+
address@hidden
+(Difficile.)
+Come si potrebbero gestire degli insiemi di nomi (@dfn{namespaces})
+in @command{gawk}, in modo
+che i nomi di funzione presenti in estensioni differenti non siano in conflitto
+tra loro?
+Chi riesce a trovare uno schema di buona address@hidden @`e pregato di
contattare il
+manutentore di @command{gawk}, per metterlo al corrente.
+
address@hidden
+Si scriva uno script di shell che funga da interfaccia per
+l'estensione ``inplace'', vista
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di estensione Inplace},
+in modo che il comportamento sia simile a quello del comando @samp{sed -i}.
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden
address@hidden @value{PART4}Appendici
address@hidden ifnotinfo
+
address@hidden
+
address@hidden FOR_PRINT
+La Parte IV contiene le appendici (come pure le due licenze che proteggono
+il codice sorgente di @command{gawk} e questo @value{DOCUMENT},
+rispettivamente) e inoltre il Glossario:
address@hidden ifclear
+
address@hidden FOR_PRINT
+La Parte IV contiene tre appendici, l'ultima delle quali @`e la licenza
+che protegge il codice sorgente di @command{gawk}:
address@hidden ifset
+
address@hidden @value{BULLET}
address@hidden
address@hidden del linguaggio}
+
address@hidden
address@hidden
+
address@hidden FOR_PRINT
address@hidden
address@hidden
+
address@hidden
address@hidden fondamentali}
+
address@hidden
address@hidden
address@hidden ifclear
+
address@hidden
address@hidden
+
address@hidden FOR_PRINT
address@hidden
address@hidden per Documentazione Libera GNU (FDL)}
address@hidden ifclear
address@hidden itemize
address@hidden ifdocbook
+
address@hidden Storia del linguaggio
address@hidden L'evoluzione del linguaggio @command{awk}
+
+Questo @value{DOCUMENT} descrive l'implementazione GNU di @command{awk}
+conforme alle specifiche POSIX. Molti degli utenti di lunga data di
address@hidden hanno imparato a programmare in @command{awk} usando
+l'implementazione originale di @command{awk} presente nella versione 7 di
+Unix. (Questa versione @`e servita da base per la versione Berkeley Unix di
address@hidden, attraverso la versione 4.3BSD-Reno. Successive versioni di
+Berkeley Unix e, per un certo periodo, alcuni sistemi derivati da
+4.4BSD-Lite, hanno usato varie versioni di @command{gawk} come loro
address@hidden) Questo @value{CHAPTER} descrive in breve l'evoluzione
+del linguaggio @command{awk}, facendo riferimento ad altre parti del
address@hidden dove si possono trovare ulteriori informazioni.
+
address@hidden FOR_PRINT
+Per amor di address@hidden, sono state omesse in questa edizione informazioni
+sulla storia delle address@hidden di @command{gawk}. Si possono trovare nella
address@hidden://www.gnu.org/software/gawk/manual/html_node/Feature-History.html,
+documentazione online}.
address@hidden ifset
+
address@hidden
+* V7/SVR3.1:: Le principali differenze tra V7 e System V
+ Release 3.1.
+* SVR4:: Differenze minori tra System V
+ Release 3.1 e 4.
+* POSIX:: Nuove address@hidden per lo standard POSIX.
+* BTL:: Nuove address@hidden dalla versione
+ di @command{awk} di Brian Kernighan.
+* POSIX/GNU:: Le estensioni in @command{gawk} non
+ previste in @command{awk} POSIX.
+* Storia delle address@hidden:: La storia delle address@hidden di
+ @command{gawk}.
+* Estensioni comuni:: Sommario Estensioni comuni.
+* Intervalli e localizzazione:: Come le localizzazioni influiscono sugli
+ intervalli delle espressioni regolari.
+* Contributori:: I maggiori contributori a @command{gawk}.
+* Sommario della storia:: Sommario della storia.
address@hidden menu
+
address@hidden V7/SVR3.1
address@hidden Differenze importanti tra V7 e System V Release 3.1
address@hidden @command{awk}, versioni di
address@hidden @command{awk}, versioni di, differenze tra V7 e SVR3.1
+
+Il liguaggio @command{awk} si @`e evoluto considerevolmente tra Unix versione
+7 (1978) e la nuova implementazione disponibile a partire da Unix System V
+Release 3.1 (1987). Questa @value{SECTION} riassume le differenze e indica
+dove @`e possibile trovare ulteriori dettagli:
+
address@hidden @value{BULLET}
address@hidden
+La address@hidden di inserire @samp{;} per separare address@hidden regole su
una riga
+(@pxref{Istruzioni/Righe})
+
address@hidden
+Funzioni definite dall'utente e istruzione @code{return}
+(@pxref{Funzioni definite dall'utente})
+
address@hidden
+L'istruzione @code{delete} (@pxref{Cancellazione})
+
address@hidden
+L'istruzione @address@hidden
+(@pxref{Istruzione do})
+
address@hidden
+Le funzioni predefinite @code{atan2()}, @code{cos()}, @code{sin()},
@code{rand()} e
address@hidden()} (@pxref{Funzioni numeriche})
+
address@hidden
+Le funzioni predefinite @code{gsub()}, @code{sub()} e @code{match()}
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Le funzioni predefinite @code{close()} e @code{system()}
+(@pxref{Funzioni di I/O})
+
address@hidden
+Le variabili predefinite @code{ARGC}, @code{ARGV}, @code{FNR}, @code{RLENGTH},
address@hidden e @code{SUBSEP} (@pxref{Variabili predefinite})
+
address@hidden
address@hidden di modificare @code{$0} (@pxref{Cambiare i campi})
+
address@hidden
+L'espressione condizionale che fa uso dell'operatore ternario @samp{?:}
+(@pxref{Espressioni condizionali})
+
address@hidden
+L'espressione @address@hidden in @var{vettore}} esterna alle istruzioni
address@hidden (@pxref{Visitare elementi})
+
address@hidden
+L'operatore esponenziale @samp{^}
+(@pxref{Operatori aritmetici}) e il relativo operatore di assegnamento
address@hidden (@pxref{Operatori di assegnamento})
+
address@hidden
+Precedenze tra operatori compatibili con quelle del linguaggio C, che
+rendono non funzionanti alcuni vecchi programmi @command{awk}
(@pxref{Precedenza})
+
address@hidden
+La address@hidden di usare @dfn{regexp} come valori di @code{FS}
+(@pxref{Separatori di campo}) e come
+terzo argomento per la funzione @code{split()}
+(@pxref{Funzioni per stringhe}), invece di usare solo il primo carattere
+di @code{FS}
+
address@hidden
address@hidden dinamiche come operandi degli operatori @samp{~} e @samp{!~}
+(@pxref{Espressioni regolari calcolate})
+
address@hidden
+Le sequenze di protezione @samp{\b}, @samp{\f} e @samp{\r}
+(@pxref{Sequenze di protezione})
+
address@hidden
+La ridirezione dell'input per la funzione @code{getline}
+(@pxref{Getline})
+
address@hidden
+La address@hidden di avere address@hidden regole @code{BEGIN} ed @code{END}
+(@pxref{BEGIN/END})
+
address@hidden
+Vettori multidimensionali
+(@pxref{Vettori multidimensionali})
address@hidden itemize
+
address@hidden SVR4
address@hidden Differenze tra le versioni System V Release 3.1 e SVR4
+
address@hidden @command{awk}, versioni di, differenze tra SVR3.1 e SVR4
+La versione per Unix System V Release 4 (1989) di @command{awk} ha aggiunto
+queste address@hidden (alcune delle quali introdotte da @command{gawk}):
+
address@hidden @value{BULLET}
address@hidden
+Il vettore @code{ENVIRON} (@pxref{Variabili predefinite})
address@hidden gawk and MKS awk
+
address@hidden
+La address@hidden di specificare address@hidden opzioni @option{-f} sulla riga
di comando
+(@pxref{Opzioni})
address@hidden MKS awk
address@hidden Mortice Kern Systems, ditta produttrice di una versione
commerciale di awk
+
address@hidden
+L'opzione @option{-v} per assegnare variabili prima di iniziare
+l'esecuzione del programma
+(@pxref{Opzioni})
address@hidden GNU, Bell Laboratories & MKS together
+
address@hidden
+La notazione @option{--} per indicare la fine delle opzioni sulla riga di
+comando
+
address@hidden
+Le sequenze di protezione @samp{\a}, @samp{\v} e @samp{\x}
+(@pxref{Sequenze di protezione})
address@hidden GNU, for ANSI C compat
+
address@hidden
+Un valore di ritorno definito per la funzione predefinita @code{srand()}
+(@pxref{Funzioni numeriche})
+
address@hidden
+Le funzioni predefinite per stringhe @code{toupper()} e @code{tolower()}
+per la conversione maiuscolo/minuscolo
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Una specificazione address@hidden accurata per la lettera @samp{%c} di
controllo del
+formato nella funzione @code{printf}
+(@pxref{Lettere di controllo})
+
address@hidden
+La address@hidden di decidere dinamicamente la larghezza di un campo e la
+precisione da usare (@code{"%*.*d"}) nella lista degli argomenti passati a
address@hidden e @code{sprintf()}
+(@pxref{Lettere di controllo})
+
address@hidden
+L'uso di costanti @dfn{regexp}, p.es. @code{/pippo/}, come espressioni,
+che equivalgono a usare l'operatore di ricerca di una
+corrispondenza, p.es. @samp{$0 ~ /pippo/}
+(@pxref{Usare le costanti @dfn{regexp}})
+
address@hidden
+Gestione di sequenze di protezione nell'assegnamento di variabili
+effettuato tramite la riga di comando
+(@pxref{Opzioni di assegnamento})
address@hidden itemize
+
address@hidden POSIX
address@hidden Differenze tra versione SVR4 e POSIX di @command{awk}
address@hidden @command{awk}, versioni di, differenze tra SVR4 e POSIX
@command{awk}
address@hidden POSIX @command{awk}, differenze tra versioni @command{awk}
+
+Lo standard POSIX Command Language and Utilities per @command{awk} (1992)
+ha introdotto le seguenti modifiche al linguaggio:
+
address@hidden @value{BULLET}
address@hidden
+L'uso dell'opzione @option{-W} per opzioni specifiche a una data
+implementazione
+(@pxref{Opzioni})
+
address@hidden
+L'uso di @code{CONVFMT} per controllare la conversione di numeri
+in stringhe (@pxref{Conversione})
+
address@hidden
+Il concetto di stringa numerica e regole di confronto address@hidden precise
da seguire
+al riguardo (@pxref{Tipi di variabile e confronti})
+
address@hidden
+L'uso di variabili predefinite come nomi di parametri delle funzioni @`e
vietato
+(@pxref{Sintassi delle definizioni})
+
address@hidden
+Una documentazione address@hidden completa di molte tra le address@hidden del
linguaggio
+precedentemente non documentate
address@hidden itemize
+
+Nel 2012, un certo numero di estensioni che erano address@hidden comunemente
+disponibili da parecchi anni sono state finalmente aggiunte allo standard
+POSIX. Ecco l'elenco:
+
address@hidden @value{BULLET}
address@hidden
+La funzione predefinita @code{fflush()} per forzare la scrittura dei buffer
+in output
+(@pxref{Funzioni di I/O})
+
address@hidden
+L'istruzione @code{nextfile}
+(@pxref{Istruzione nextfile})
+
address@hidden
+La address@hidden di eliminare completamente un vettore con l'istruzione
address@hidden @var{vettore}}
+(@pxref{Cancellazione})
+
address@hidden itemize
+
address@hidden comuni} per una lista delle estensioni comuni
+non previste nello standard POSIX.
+
+Lo standard POSIX 2008 @`e reperibile online a:
address@hidden://www.opengroup.org/onlinepubs/9699919799/}.
+
+
address@hidden BTL
address@hidden Estensioni nell'@command{awk} di Brian Kernighan
+
address@hidden @command{awk}, versioni di, si veda anche Brian Kernighan,
@command{awk} di
address@hidden estensioni, Brian Kernighan @command{awk}
address@hidden Brian Kernighan, @command{awk} di, estensioni
address@hidden Kernighan, Brian
+Brian Kernighan
+ha reso disponibile la sua versione nel suo sito.
+(@pxref{Altre versioni}).
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive estensioni comuni disponibili per la
+prima volta nella sua versione di @command{awk}:
+
address@hidden @value{BULLET}
address@hidden
+Gli operatori @samp{**} e @samp{**=}
+(@pxref{Operatori aritmetici}
+e
address@hidden di assegnamento})
+
address@hidden
+L'uso di @code{func} come abbreviazione di @code{function}
+(@pxref{Sintassi delle definizioni})
+
address@hidden
+La funzione predefinita @code{fflush()} per forzare la scrittura dei buffer
+in output
+(@pxref{Funzioni di I/O})
+
address@hidden
address@hidden
+The @code{SYMTAB} array, that allows access to @command{awk}'s internal symbol
+table. This feature was never documented for his @command{awk}, largely because
+it is somewhat shakily implemented. For instance, you cannot access arrays
+or array elements through it
address@hidden ignore
address@hidden itemize
+
address@hidden comuni} per una lista completa delle estensioni
+disponibile nel suo @command{awk}.
+
address@hidden POSIX/GNU
address@hidden Estensioni di @command{gawk} non in POSIX @command{awk}
+
address@hidden address@hidden compatibile di (@command{gawk}), estensioni nella
address@hidden estensioni nella address@hidden compatibile di (@command{gawk})
address@hidden estensioni, in @command{gawk}, non in POSIX @command{awk}
address@hidden POSIX, estensioni @command{gawk} non incluse in
+L'implementazione GNU di @command{gawk} aggiunge molte address@hidden
+Queste possono essere disabilitate completamente sia con l'opzione
address@hidden che con l'opzione
address@hidden
+(@pxref{Opzioni}).
+
+Alcune address@hidden sono state introdotte e successivamente tolte
+con il passare del tempo.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden
+sintetizza le ulteriori address@hidden rispetto a POSIX @command{awk} che sono
+presenti nella versione corrente di @command{gawk}.
+
address@hidden @value{BULLET}
+
address@hidden
+Ulteriori variabili predefinite:
+
address@hidden @value{MINUS}
address@hidden
+Le variabili
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+(@pxref{Variabili predefinite})
address@hidden itemize
+
address@hidden
+File speciali verso cui ridirigere l'I/O:
+
address@hidden @value{MINUS}
address@hidden
+I file @file{/dev/stdin}, @file{/dev/stdout}, @file{/dev/stderr} e i
address@hidden speciali @file{/dev/fd/@var{N}}
+(@pxref{File speciali})
+
address@hidden
+I file speciali @file{/inet}, @file{/inet4} e @file{/inet6} per
+interagire con la rete TCP/IP usando @samp{|&} per specificare quale
+versione usare del protocollo IP
+(@pxref{Reti TCP/IP})
address@hidden itemize
+
address@hidden
+Differenze e/o aggiunte al linguaggio:
+
address@hidden @value{MINUS}
address@hidden
+La sequenza di protezione @samp{\x}
+(@pxref{Sequenze di protezione})
+
address@hidden
+Supporto completo per @dfn{regexp} sia POSIX che GNU
address@hidden
+(@pxrefil{Espressioni regolari})
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari})
address@hidden ifnottex
+
address@hidden
+La address@hidden che @code{FS} e il terzo
+argomento di @code{split()} siano la stringa nulla
+(@pxref{Campi di un solo carattere})
+
address@hidden
+La address@hidden che @code{RS} sia una @dfn{regexp}
+(@pxref{Record})
+
address@hidden
+La address@hidden di usare costanti ottali ed esadecimali nei programmi
+scritti in @command{awk}
+(@pxref{Numeri non-decimali})
+
address@hidden
+L'operatore @samp{|&} per poter effettuare I/O bidirezionale verso un
+coprocesso
+(@pxref{I/O bidirezionale})
+
address@hidden
+Chiamate indirette di funzione
+(@pxref{Chiamate indirette})
+
address@hidden
+La address@hidden di ignorare directory specificate sulla riga di comando,
+emettendo un messaggio di avvertimento
+(@pxref{Directory su riga di comando})
+
address@hidden
+Errori in output usando @code{print} e @code{printf} non provocano
+necessariamente la fine del programma
+(@pxref{Continuazione dopo errori})
address@hidden itemize
+
address@hidden
+Nuove parole chiave:
+
address@hidden @value{MINUS}
address@hidden
+I criteri di ricerca speciali @code{BEGINFILE} ed @code{ENDFILE}
+(@pxref{BEGINFILE/ENDFILE})
+
address@hidden
+L'istruzione @code{switch}
+(@pxref{Istruzione switch})
address@hidden itemize
+
address@hidden
+Differenze in funzioni standard di @command{awk}:
+
address@hidden @value{MINUS}
address@hidden
+Il secondo argomento opzionale di @code{close()} che consente di chiudere
+un solo lato dell'I/O di una @dfn{pipe} bidirezionale aperta verso un
+coprocesso (@pxref{I/O bidirezionale})
+
address@hidden
+Aderenza allo standard POSIX per le funzioni @code{gsub()} e @code{sub()}
+se @`e stata specificata l'opzione @option{--posix}
+
address@hidden
+La funzione @code{length()} accetta come argomento il nome di un vettore
+e restituisce il numero di elementi nel vettore
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Il terzo argomento opzionale della funzione @code{match()}
+per contenere eventuali sottoespressioni individuate all'interno di una
address@hidden
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Specificatori posizionali nei formati di @code{printf} per facilitare
+le traduzioni di messaggi
+(@pxref{Ordinamento di printf})
+
address@hidden
+L'aggiunta di un quarto argomento opzionale alla funzione @code{split()},
+per designare un vettore che contenga il testo dei separatori di campo
+(@pxref{Funzioni per stringhe})
address@hidden itemize
+
address@hidden
+Ulteriori funzioni presenti solo in @command{gawk}:
+
address@hidden @value{MINUS}
address@hidden
+Le funzioni @code{gensub()}, @code{patsplit()} e @code{strtonum()}
+per una gestione di testi address@hidden potente
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Le funzioni @code{asort()} e @code{asorti()} per l'ordinamento di vettori
+(@pxref{Ordinamento di vettori})
+
address@hidden
+Le funzioni @code{mktime()}, @code{systime()} e @code{strftime()}
+per lavorare con date e ore
+(@pxref{Funzioni di tempo})
+
address@hidden
+Le funzioni
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()}
+e
address@hidden()}
+per la manipolazione a livello di bit
+(@pxref{Funzioni a livello di bit})
address@hidden In 4.1, and(), or() and xor() grew the ability to take > 2
arguments
+
address@hidden
+La funzione @code{isarray()} per controllare se una variabile @`e un vettore
+oppure no
+(@pxref{Funzioni per i tipi})
+
address@hidden
+Le funzioni @code{bindtextdomain()}, @code{dcgettext()}
+e @code{dcngettext()} per l'internazionalizzazione
+(@pxref{I18N per programmatore})
+
address@hidden
+La funzione @code{intdiv()} per effettuare divisioni a numeri interi e
+ottenere il resto della divisione
+(@pxref{Funzioni numeriche})
address@hidden itemize
+
address@hidden
+Modifiche e/o aggiunte alle opzioni della riga di comando:
+
address@hidden @value{MINUS}
address@hidden
+La variabile d'ambiente @env{AWKPATH} per specificare un percorso di ricerca
+per l'opzione @option{-f} della riga di comando
+(@pxref{Opzioni})
+
address@hidden
+La variabile d'ambiente @env{AWKLIBPATH} per specificare un percorso di ricerca
+per l'opzione @option{-l} della riga di comando
+(@pxref{Opzioni})
+
address@hidden
+Le opzioni brevi
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+. Inoltre, la
address@hidden di usare opzioni in formato lungo (stile GNU) che iniziano
+con @option{--}
+e le opzioni lunghe
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+and
address@hidden
+(@pxref{Opzioni}).
address@hidden itemize
+
address@hidden new ports
+
address@hidden
+Il supporto per i seguenti sistemi obsoleti @`e stato rimosso dal codice
+sorgente e dalla documentazione di @command{gawk} @value{PVERSION} 4.0:
+
address@hidden nested table
address@hidden @value{MINUS}
address@hidden
+Amiga
+
address@hidden
+Atari
+
address@hidden
+BeOS
+
address@hidden
+Cray
+
address@hidden
+MIPS RiscOS
+
address@hidden
+MS-DOS con il compilatore Microsoft
+
address@hidden
+MS-Windows con il compilatore Microsoft
+
address@hidden
+NeXT
+
address@hidden
+SunOS 3.x, Sun 386 (Road Runner)
+
address@hidden
+Tandem (non-POSIX)
+
address@hidden
+Compilatore pre-standard VAX C per VAX/VMS
+
address@hidden
+GCC per VAX e Alpha non @`e stato verificato da parecchio tempo.
+
address@hidden itemize
+
address@hidden
+Il supporto per i seguenti sistemi obsoleti @`e stato rimosso dal codice
+di @command{gawk} @value{PVERSION} 4.1:
+
address@hidden nested table
address@hidden @value{MINUS}
address@hidden
+Ultrix
address@hidden itemize
+
address@hidden
+Il supporto per i seguenti sistemi obsoleti @`e stato rimosso dal codice
+sorgente e dalla documentazione di
address@hidden @value{PVERSION} 4.2:
+
address@hidden nested table
address@hidden @value{MINUS}
address@hidden
+MirBSD
+
address@hidden
+GNU/Linux su Alpha
address@hidden itemize
+
address@hidden itemize
+
address@hidden XXX ADD MORE STUFF HERE
+
+
address@hidden This does not need to be in the formal book.
address@hidden FOR_PRINT
address@hidden Storia delle address@hidden
address@hidden Storia delle address@hidden di @command{gawk}
+
address@hidden
+See the thread:
+https://groups.google.com/forum/#!topic/comp.lang.awk/SAUiRuff30c
+This motivated me to add this section.
address@hidden ignore
+
address@hidden
+I've tried to follow this general order, esp.@: for the 3.0 and 3.1 sections:
+ variables
+ special files
+ language changes (e.g., hex constants)
+ differences in standard awk functions
+ new gawk functions
+ new keywords
+ new command-line options
+ behavioral changes
+ new ports
+Within each category, be alphabetical.
address@hidden ignore
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive le address@hidden in @command{gawk}
+in aggiunta a quelle di POSIX @command{awk},
+nell'ordine in cui sono state rese disponibili in @command{gawk}.
+
+La versione 2.10 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+La variabile d'ambiente @env{AWKPATH} per specificare un percorso di ricerca
+per l'opzione @option{-f} della riga di comando
+(@pxref{Opzioni})
+
address@hidden
+La variabile @code{IGNORECASE} e i suoi effetti
+(@pxref{Maiuscolo-Minuscolo}).
+
address@hidden
+I file @file{/dev/stdin}, @file{/dev/stdout}, @file{/dev/stderr} e i
address@hidden speciali @file{/dev/fd/@var{N}}
+(@pxref{File speciali})
address@hidden itemize
+
+La versione 2.13 di @command{gawk} ha ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+La variabile @code{FIELDWIDTHS} e i suoi effetti
+(@pxref{Dimensione costante}).
+
address@hidden
+Le funzioni predefinite @code{systime()} e @code{strftime()} per ottenere
+e stampare data e ora
+(@pxref{Funzioni di tempo}).
+
address@hidden
+Ulteriori opzioni dalla riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{-W lint} per fornire controlli su possibili errori e per
+la address@hidden, sia a livello di codice sorgente che in fase di esecuzione.
+
address@hidden
+L'opzione @option{-W compat} per inibire le estensioni GNU.
+
address@hidden
+L'opzione @option{-W posix} per richiedere una stretta aderenza allo
+standard POSIX.
address@hidden itemize
address@hidden itemize
+
+La versione 2.14 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+L'istruzione @code{next file} per passare immediatamente al successivo
address@hidden (@pxref{Istruzione nextfile}).
address@hidden itemize
+
+La versione 2.15 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+Nuove variabili (@pxref{Variabili predefinite}):
+
address@hidden @value{MINUS}
address@hidden
address@hidden, che permette di controllare la posizione di @code{FILENAME}
+nel vettore @code{ARGV}.
+
address@hidden
address@hidden, che contiene il messaggio di errore del sistema quando
address@hidden restituisce @minus{}1 o @code{close()} non termina con successo.
address@hidden itemize
+
address@hidden
+I @value{FNS} speciali @file{/dev/pid}, @file{/dev/ppid}, @file{/dev/pgrpid}
+e @file{/dev/user}. Questo supporto @`e stato rimosso in seguito.
+
address@hidden
+La address@hidden di cancellare un intero vettore in una sola istruzione
+con @samp{delete @var{vettore}}
+(@pxref{Cancellazione}).
+
address@hidden
+Modifiche nelle opzioni della riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+La address@hidden di usare opzioni in formato lungo (in stile GNU) che iniziano
+con @option{--}.
+
address@hidden
+L'opzione @option{--source} per combinare codice sorgente immesso nella riga
+di comando e codice sorgente proveniente da file di libreria.
address@hidden itemize
address@hidden itemize
+
+La versione 3.0 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+Variabili nuove o modificate:
+
address@hidden @value{MINUS}
address@hidden
address@hidden modificato, diventa applicabile al confronto tra stringhe,
+come pure alle operazioni su @dfn{regexp}
+(@pxref{Maiuscolo-Minuscolo}).
+
address@hidden
address@hidden, che contiene il testo in input che @`e stato individuato da
@code{RS}
+(@pxref{Record}).
address@hidden itemize
+
address@hidden
+Supporto completo sia per le @dfn{regexp} POSIX sia per quelle GNU
address@hidden
+(@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}).
address@hidden ifnottex
+
address@hidden
+La funzione @code{gensub()} per migliorare la manipolazione di testi
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+La funzione @code{strftime()} prevede un formato di data e ora di default,
+in modo da poter essere chiamata senza alcun argomento.
+(@pxref{Funzioni di tempo}).
+
address@hidden
+La address@hidden che @code{FS} e il terzo argomento della funzione
address@hidden()} siano delle stringhe nulle
+(@pxref{Campi di un solo carattere}).
+
address@hidden
+La address@hidden che @code{RS} sia una @dfn{regexp}
+(@pxref{Record}).
+
address@hidden
+L'istruzione @code{next file} @`e diventata @code{nextfile}
+(@pxref{Istruzione nextfile}).
+
address@hidden
+La funzione @code{fflush()} di
+BWK @command{awk}
+(BWK allora lavorava ai Bell Laboratories;
address@hidden di I/O}).
+
address@hidden
+Nuove opzioni della riga di comando:
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{--lint-old} per
+ottenere messaggi relativi a costrutti non disponibili
+nell'implementazione di @command{awk} per Unix Version 7
+(@pxref{V7/SVR3.1}).
+
address@hidden
+L'opzione @option{-m} da BWK @command{awk}. (Brian lavorava
+ancora ai Bell Laboratories all'epoca.) Quest'opzione @`e stata in seguito
+rimossa, sia dal suo @command{awk} che da @command{gawk}.
+
address@hidden
+L'opzione @option{--re-interval} per consentire di specificare
+espressioni di intervallo nelle @dfn{regexp}
+(@pxref{Operatori di espressioni regolari}).
+
address@hidden
+L'opzione @option{--traditional} aggiunta come maniera address@hidden intuitiva
+per richiedere l'opzione
address@hidden (@pxref{Opzioni}).
address@hidden itemize
+
address@hidden
+L'uso di GNU Autoconf per controllare il processo di configurazione
+(@pxref{Installazione veloce}).
+
address@hidden
+Supporto per Amiga.
+Questo supporto @`e stato rimosso in seguito.
+
address@hidden itemize
+
+La versione 3.1 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+Nuove variabili
+(@pxref{Variabili predefinite}):
+
address@hidden @value{MINUS}
address@hidden
address@hidden, per sistemi non aderenti allo standard POSIX,
+che consente I/O binario per file in input e/o output
+(@pxref{Uso su PC}).
+
address@hidden
address@hidden, che controlla dinamicamente gli avvertimenti emessi da
@dfn{lint}.
+
address@hidden
address@hidden, un vettore che fornisce informazioni correlate con il
+processo in esecuzione.
+
address@hidden
address@hidden, per impostare il dominio testuale in cui internazionalizzare
+un'applicazione (@pxref{Internazionalizzazione}).
address@hidden itemize
+
address@hidden
+La address@hidden di usare costanti ottali ed esadecimali nel codice
+sorgente di programmi @command{awk}.
+(@pxref{Numeri non-decimali}).
+
address@hidden
+L'operatore @samp{|&} per effettuare I/O bidirezionale verso un
+coprocesso
+(@pxref{I/O bidirezionale}).
+
address@hidden
+I file speciali @file{/inet} per interagire con reti TCP/IP usando @samp{|&}
+(@pxref{Reti TCP/IP}).
+
address@hidden
+Il secondo argomento opzionale della funzione @code{close()} per permettere di
+chiudere uno dei lati di una @dfn{pipe} bidirezionale aperta con un coprocesso
+(@pxref{I/O bidirezionale}).
+
address@hidden
+Il terzo argomento opzionale della funzione @code{match()} per
+avere a disposizione le diverse sottoespressioni individuate all'interno
+di una @dfn{regexp}
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Specificatori posizionali nelle stringhe di formato di @code{printf} per
+facilitare la traduzione di messaggi
+(@pxref{Ordinamento di printf}).
+
address@hidden
+Alcune nuove funzioni predefinite:
+
address@hidden @value{MINUS}
address@hidden
+Le funzioni @code{asort()} e @code{asorti()} per l'ordinamento di vettori
+(@pxref{Ordinamento di vettori}).
+
address@hidden
+Le funzioni @code{bindtextdomain()}, @code{dcgettext()} e @code{dcngettext()}
+per l'internationalizzazione
+(@pxref{I18N per programmatore}).
+
address@hidden
+La funzione @code{extension()} e la address@hidden di aggiungere
+nuove funzioni predefinite dinamicamente
address@hidden
+(@pxrefil{Estensioni dinamiche}).
address@hidden iftex
address@hidden
+(@pxref{Estensioni dinamiche}).
address@hidden ifnottex
+
address@hidden
+La funzione @code{mktime()} per generare date e ore
+(@pxref{Funzioni di tempo}).
+
address@hidden
+Le funzioni @code{and()}, @code{or()}, @code{xor()}, @code{compl()},
address@hidden()}, @code{rshift()} e @code{strtonum()}
+(@pxref{Funzioni a livello di bit}).
address@hidden itemize
+
address@hidden
address@hidden @code{next file} statement
+Il supporto per @samp{next file} scritto come due parole @`e stato rimosso
+completamente
+(@pxref{Istruzione nextfile}).
+
address@hidden
+Ulteriori opzioni sulla riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{--dump-variables} per stampare una lista di tutte le
+variabili globali.
+
address@hidden
+L'opzione @option{--exec}, da usare in script CGI [Common Gateway Interface].
+
address@hidden
+L'opzione della riga di comando @option{--gen-po} e l'uso di un trattino
+basso a inizio stringa, per segnalare stringhe che dovrebbero essere tradotte
+(@pxref{Estrazione di stringhe}).
+
address@hidden
+L'opzione @option{--non-decimal-data} per consentire di avere dati in input
+di tipo non decimale
+(@pxref{Dati non decimali}).
+
address@hidden
+L'opzione @option{--profile} e @command{pgawk}, la
+versione profilatrice di @command{gawk}, per produrre profili di esecuzione
+di programmi @command{awk}
+(@pxref{Profilare}).
+
address@hidden
+L'opzione @option{--use-lc-numeric} per richiedere a @command{gawk}
+di usare il carattere di separazione decimale proprio della localizzazione
+nell'elaborazione dei dati in input
+(@pxref{Conversione}).
address@hidden itemize
+
address@hidden
+L'uso di GNU Automake a supporto della standardizzazione del processo
+di configurazione
+(@pxref{Installazione veloce}).
+
address@hidden
+L'uso di GNU @command{gettext} per i messaggi emessi da @command{gawk}
+(@pxref{Gawk internazionalizzato}).
+
address@hidden
+Supporto per BeOS. Rimosso in seguito.
+
address@hidden
+Supporto per Tandem. Rimosso in seguito.
+
address@hidden
+La versione per Atari ufficialmente non @`e address@hidden supportata e in
seguito
address@hidden stata completamente rimossa.
+
address@hidden
+Modifiche al codice sorgente per usare definizioni di funzione secondo lo
+stile di codifica dello standard ISO C.
+
address@hidden
+Aderenza alla specifica POSIX per le funzioni @code{sub()} e @code{gsub()}
+(@pxref{Dettagli ostici}).
+
address@hidden
+La funzione @code{length()} @`e stata estesa per accettare un vettore come
+argomento, e restituire in tal caso il numero di elementi nel vettore
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+La funzione @code{strftime()} accetta un terzo argomento per
+dare la address@hidden di stampare data e ora nel formato UTC
+(@pxref{Funzioni di tempo}).
address@hidden itemize
+
+La versione 4.0 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
+
address@hidden
+Aggiunta di variabili:
+
address@hidden @value{MINUS}
address@hidden
address@hidden, che permette di specificare una @dfn{regexp} che individua
+i campi, invece che individuare il separatore tra i campi
+(@pxref{Separazione in base al contenuto}).
+
address@hidden
+Se esiste l'elemento di vettore @code{PROCINFO["sorted_in"]}, il ciclo
address@hidden(indice in pippo)} ordina
+gli indici, prima di iniziare il ciclo. Il valore di questo elemento
+permette di controllare l'ordinamento degli indici prima di iniziare il
+ciclo che li visita tutti
+(@pxref{Controllare visita}).
+
address@hidden
address@hidden"strftime"]}, che contiene la stringa di formato
+di default per @code{strftime()}
+(@pxref{Funzioni di tempo}).
address@hidden itemize
+
address@hidden
+I file speciali @file{/dev/pid}, @file{/dev/ppid}, @file{/dev/pgrpid}
+e @file{/dev/user} sono stati rimossi.
+
address@hidden
+Il supporto per IPv6 @`e stato aggiunto attraverso il file speciale
address@hidden/inet6}.
+Il file speciale @file{/inet4} consente di operare con IPv4 e @file{/inet}
+opera con il default di sistema, che probabilmente @`e IPv4
+(@pxref{Reti TCP/IP}).
+
address@hidden
+L'uso delle sequenze di protezione @samp{\s} e @samp{\S} nelle espressioni
+regolari
+(@pxref{Operatori di @dfn{regexp} GNU}).
+
address@hidden
+Le espressioni di intervallo sono consentite per default nelle espressioni
+regolari
+(@pxref{Operatori di espressioni regolari}).
+
address@hidden
+La classi di caratteri POSIX sono consentite anche se si @`e specificata
+l'opzione @option{--traditional}
+(@pxref{Operatori di espressioni regolari}).
+
address@hidden
address@hidden e @code{continue} non sono address@hidden consentiti fuori da un
ciclo,
+anche se si @`e specificata l'opzione @option{--traditional}
+(@pxref{Istruzione break} e anche la
address@hidden continue}).
+
address@hidden
address@hidden()}, @code{nextfile} e @samp{delete @var{array}}
+sono consentite anche se @`e stata specificata l'opzione @option{--posix} o
address@hidden, poich@'e questi costrutti sono ora inclusi
+nello standard POSIX.
+
address@hidden
+Un terzo argomento facoltativo per le funzioni @code{asort()} e @code{asorti()}
+permette di specificare il tipo di ordinamento desiderato
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Il comportamento di @code{fflush()} @`e stato modificato per corrispondere
+a quello di BWK @command{awk}
+e per lo standard POSIX; ora sia @samp{fflush()} che @samp{fflush("")}
+forzano la scrittura di tutte le ridirezioni in output aperte
+(@pxref{Funzioni di I/O}).
+
address@hidden
+La funzione @code{isarray()}
+determina se un elemento @`e un vettore oppure no
+per rendere possibile la visita di vettori di vettori
+(@pxref{Funzioni per i tipi}).
+
address@hidden
+La funzione @code{patsplit()} che
+fornisce le stesse address@hidden di @code{FPAT}, per suddividere delle
stringhe
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Un quarto argomento opzionale per la funzione @code{split()},
+che indica un vettore destinato a contenere i valori dei separatori
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Vettori di vettori
+(@pxref{Vettori di vettori}).
+
address@hidden
+I criteri di ricerca speciali @code{BEGINFILE} ed @code{ENDFILE}
+(@pxref{BEGINFILE/ENDFILE}).
+
address@hidden
+Chiamate indirette di funzioni
+(@pxref{Chiamate indirette}).
+
address@hidden
+Le istruzioni @code{switch} / @code{case} sono disponibili per default
+(@pxref{Istruzione switch}).
+
address@hidden
+Modifiche nelle opzioni della riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+Le opzioni @option{-b} e @option{--characters-as-bytes},
+che impediscono che @command{gawk} tratti l'input come composto da una
+stringa di caratteri multibyte.
+
address@hidden
+Rimozione delle opzioni ridondanti (in notazione lunga) @option{--compat},
address@hidden e @option{--usage}.
+
address@hidden
+L'opzione @option{--gen-po} @`e stata finalmente rinominata
address@hidden per correttezza.
+
address@hidden
+L'opzione @option{--sandbox} che disabilita alcune address@hidden [per operare
+in un ambiente "protetto"].
+
address@hidden
+Tutte le opzioni in notazione lunga hanno acquisito opzioni corrispondenti
+in notazione breve, per poter essere usate negli script di shell @samp{#!}.
address@hidden itemize
+
address@hidden
+I nomi di directory che appaiono sulla riga di comando generano adesso
+un messaggio di errore, ma non interrompono l'elaborazione, a meno che non
+siano state specificate le opzioni @option{--posix} o @option{--traditional}
+(@pxref{Directory su riga di comando}).
+
address@hidden
+Il codice interno di @command{gawk} @`e stato riscritto, aggiungendo la
+versione per il debug @command{dgawk},
+con un possibile miglioramento nei tempi di esecuzione
address@hidden
+(@pxrefil{Debugger}).
address@hidden iftex
address@hidden
+(@pxref{Debugger}).
address@hidden ifnottex
+
address@hidden
+In aderenza agli standard di codifica GNU, le estensioni dinamiche devono
+definire un simbolo globale che indica che sono compatibili con la
+licenza GPL
+(@pxref{Licenza delle estensioni}).
+
address@hidden
+In address@hidden POSIX, i confronti tra stringhe usano le funzioni di
+libreria @code{strcoll()} / @code{wcscoll()}
+(@pxref{Confronto POSIX di stringhe}).
+
address@hidden
+L'opzione per usare @dfn{socket} in maniera @dfn{raw} (nativa) @`e stata
+rimossa, perch@'e non era mai stata implementata
+(@pxref{Reti TCP/IP}).
+
address@hidden
+Intervalli nella forma @samp{[d-h]} sono elaborati come se fossero scritti
+nella localizzazione C, a prescindere da che tipo di @dfn{regexp} @`e usata,
+anche se era stata specificata l'opzione
address@hidden
+(@pxref{Intervalli e localizzazione}).
+
address@hidden
address@hidden stato rimosso il supporto per i seguenti sistemi:
+
address@hidden @value{MINUS}
address@hidden
+Atari
+
address@hidden
+Amiga
+
address@hidden
+BeOS
+
address@hidden
+Cray
+
address@hidden
+MIPS RiscOS
+
address@hidden
+MS-DOS con Compilatore Microsoft
+
address@hidden
+MS-Windows con Compilatore Microsoft
+
address@hidden
+NeXT
+
address@hidden
+SunOS 3.x, Sun 386 (Road Runner)
+
address@hidden
+Tandem (non-POSIX)
+
address@hidden
+Compilatore pre-standard VAX C per VAX/VMS
address@hidden itemize
address@hidden itemize
+
+La versione 4.1 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
+
address@hidden
+Tre nuovi vettori:
address@hidden, @code{FUNCTAB} e @code{PROCINFO["identifiers"]}
+(@pxref{Variabili auto-assegnate}).
+
address@hidden
+I tre comandi eseguibili @command{gawk}, @command{pgawk} e @command{dgawk},
+sono diventati uno solo, con il solo nome @command{gawk}. Di conseguenza
+le opzioni sulla riga di comando sono state modificate.
+
address@hidden
+Modifiche delle opzioni da riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{-D} attiva il debugger.
+
address@hidden
+Le opzioni @option{-i} e @option{--include}
+caricano dei file di libreria @command{awk}.
+
address@hidden
+Le opzioni @option{-l} e @option{--load} caricano estensioni dinamiche
+compilate.
+
address@hidden
+Le opzioni @option{-M} e @option{--bignum} abilitano la libreria MPFR per
+il calcolo con un numero arbitrario di cifre significative.
+
address@hidden
+L'opzione @option{-o} serve solo a ottenere in output una stampa formattata
+elegantemente del programma da eseguire.
+
address@hidden
+L'opzione @option{-p} @`e usata per "profilare" l'esecuzione del programma.
+
address@hidden
+L'opzione @option{-R} @`e stata rimossa.
address@hidden itemize
+
address@hidden
+Supporto per il calcolo ad alta precisione con MPFR
+(@pxref{Calcolo con precisione arbitraria}).
+
address@hidden
+Le funzioni @code{and()}, @code{or()} e @code{xor()} sono state modificate
+per ammettere un numero qualsiasi di argomenti, con un minimo di due
+(@pxref{Funzioni a livello di bit}).
+
+
address@hidden
+L'interfaccia che rende possibile l'estensione dinamica @`e stata rifatta
+completamente
address@hidden
+(@pxrefil{Estensioni dinamiche}).
address@hidden iftex
address@hidden
+(@pxref{Estensioni dinamiche}).
address@hidden ifnottex
+
address@hidden
+La funzione @code{getline} ridiretta @`e stata resa possibile all'interno di
address@hidden ed @code{ENDFILE}
+(@pxref{BEGINFILE/ENDFILE}).
+
address@hidden
+Il comando @code{where} @`e stato aggiunto al debugger
+(@pxref{Stack di esecuzione}).
+
address@hidden
+Il supporto per Ultrix @`e stato rimosso.
+
address@hidden itemize
+
+La versione 4.2 ha introdotto le seguenti address@hidden:
+
address@hidden @bullet
address@hidden
+Differenze apportate alle variabili di ambiente (@code{ENVIRON}) sono riflesse
in quelle
+rese disponibili a @command{gawk} e in quelle di programmi che siano da esso
richiamati.
address@hidden auto-assegnate}.
+
address@hidden
+L'opzione @option{--pretty-print} non esegue address@hidden, dopo averlo
stampato,
+il programma @command{awk}.
address@hidden
+
address@hidden
+Il programma @command{igawk} e le relative pagine di manuale non sono
address@hidden installati come parte dell'installazione di @command{gawk}.
address@hidden igawk}.
+
address@hidden
+La funzione @code{intdiv()}.
address@hidden numeriche}.
+
address@hidden
+Il massimo numero di cifre esadecimali permesse nelle sequenze di
+protezione @samp{\x} @`e ora limitato a due.
address@hidden di protezione}.
+
address@hidden
address@hidden e @code{printf} non terminano il programma dopo alcuni
+errori di output.
address@hidden dopo errori}.
+
address@hidden
+Per molti anni, lo standard POSIX richiedeva che la separazione dei campi
+di un record fosse fatta per default
+quando si incontrano spazi e TAB, e questo @`e il comportamento di
address@hidden se si specifica l'opzione @option{--posix}. Dal 2013
+il comportamento originario @`e stato ripristinato, e ora
+il default per separare i campi con l'opzione @option{--posix} ammette
+anche il ritorno a capo come separatore di campi.
+
address@hidden
+Il supporto per MirBSD @`e stato rimosso.
+
address@hidden
+Il supporto per GNU/Linux sull'architettura Alpha @`e stato rimosso.
address@hidden itemize
+
address@hidden XXX ADD MORE STUFF HERE
address@hidden ifclear
+
address@hidden Estensioni comuni
address@hidden Sommario Estensioni Comuni
+
address@hidden estensioni, Brian Kernighan @command{awk}
address@hidden estensioni, @command{mawk}
+La tabella seguente dettaglia le estensioni comuni supportate
+da @command{gawk}, da Brian Kernighan @command{awk} e da @command{mawk},
+le tre versioni liberamente disponibili address@hidden usate di @command{awk}
+(@pxref{Altre versioni}).
+
address@hidden {File speciale @file{/dev/stderr}} {BWK @command{awk} }
address@hidden address@hidden {Standard attuale}
address@hidden address@hidden @tab BWK @command{awk} @tab @command{mawk} @tab
@command{gawk} @tab Standard attuale
address@hidden Sequenza di protezione @samp{\x} @tab X @tab X @tab X @tab
address@hidden Stringa nulla come @code{FS} @tab X @tab X @tab X @tab
address@hidden File speciale @file{/dev/stdin} @tab X @tab X @tab X @tab
address@hidden File speciale @file{/dev/stdout} @tab X @tab X @tab X @tab
address@hidden File speciale @file{/dev/stderr} @tab X @tab X @tab X @tab
address@hidden @code{delete} senza indici @tab X @tab X @tab X @tab X
address@hidden Funzione @code{fflush()} @tab X @tab X @tab X @tab X
address@hidden @code{length()} di un vettore @tab X @tab X @tab X @tab
address@hidden Istruzione @code{nextfile} @tab X @tab X @tab X @tab X
address@hidden Operatori @code{**} e @code{**=} @tab X @tab @tab X @tab
address@hidden Parola chiave @code{func} @tab X @tab @tab X @tab
address@hidden Variabile @code{BINMODE} @tab @tab X @tab X @tab
address@hidden @code{RS} come @dfn{regexp} @tab @tab X @tab X @tab
address@hidden Funzioni gestione data/ora @tab @tab X @tab X @tab
address@hidden multitable
+
address@hidden Intervalli e localizzazione
address@hidden Intervalli @dfn{regexp} e localizzazione: una lunga e triste
storia
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive la storia confusionaria degli intervalli
+all'interno di espressioni regolari, le loro relazioni con la localizzazione,
+e l'effetto da address@hidden determinato su diverse versioni di
@command{gawk}.
+
+Gli strumenti originali Unix aventi a che fare con espressioni regolari
+stabilivano che intervalli di caratteri (come @samp{[a-z]}) individuavano
+un carattere qualsiasi tra il primo carattere dell'intervallo e l'ultimo
+carattere dello stesso, entrambi inclusi. L'ordinamento era basato sul
+valore numerico di ogni carattere come era rappresentato all'interno
+del computer, nell'insieme di caratteri proprio di ogni macchina.
+Quindi, su sistemi che adottano la codifica ASCII, @samp{[a-z]} individua
+tutte le lettere minuscole, e solo
+quelle, in quanto i valori numerici che rappresentano le lettere dalla
address@hidden fino alla @samp{z} sono contigui. (In un sistema che adotta la
+codifica EBCDIC, l'intervallo @samp{[a-z]} comprende anche ulteriori
+caratteri non alfabetici.)
+
+Quasi tutti i testi di introduzione allo Unix spiegavano che le espressioni
+di intervallo funzionavano in questo modo, e in particolare insegnavano che
+la maniera ``corretta'' per individuare le lettere minuscole era con
address@hidden e che @samp{[A-Z]} era il modo ``corretto'' per individuare le
+lettere maiuscole.
+E, in effetti, era proprio address@hidden@address@hidden la vita era semplice.}
+
+Lo standard POSIX 1992 introduceva l'idea di localizzazione
+(@pxref{Localizzazioni}).
+Poich@'e molte localizzazioni comprendono altre lettere, oltre alle 26
+lettere dell'alfabeto inglese, lo standard POSIX introduceva le classi
+di carattere (@pxref{Espressioni tra parentesi quadre}) per permettere
+l'individuazione di differenti insiemi di caratteri, in aggiunta a quelli
+tradizionali presenti nell'insieme di caratteri ASCII.
+
+Tuttavia, lo standard @emph{ha modificato} l'interpretazione delle
+espressioni di intervallo.
+Nelle localizzazioni @code{"C"} e @code{"POSIX"},
+un'espressione di intervallo come
address@hidden @`e ancora equivalente a @samp{[abcdxyz]}, secondo l'ordine
+della codifica ASCII.
+Ma in tutte le altre localizzazioni l'ordinamento @`e basato su quel che
+si chiama @dfn{ordine di collazione}.
+
+Cosa vuol dire?
+In molte localizzazioni, le lettere @samp{A} e @samp{a} vengono entrambe
+prima di @samp{B}.
+In altre parole, queste localizzazioni ordinano i caratteri nel modo in cui
+sono ordinati in un dizionario,
+e @samp{[a-dx-z]} non @`e detto che equivalga a @samp{[abcdxyz]};
+invece, potrebbe essere equivalente a @samp{[ABCXYabcdxyz]}, per fare un
+esempio.
+
+Su questo punto @`e opportuno insistere: molta documentazione afferma che
+si dovrebbe usare @samp{[a-z]} per identificare un carattere minuscolo.
+Ma su sistemi con localizzazioni
+non-ASCII, un tale intervallo potrebbe includere tutti i caratteri maiuscoli
+tranne @samp{A} o @samp{Z}! Questo ha continuato a essere una fonte di
+equivoci perfino nel ventunesimo secolo.
+
+Per dare un'idea del tipo di problemi, l'esempio seguente usa la funzione
address@hidden()}, che effettua una sostituzione di testo all'interno di una
+stringa (@pxref{Funzioni per stringhe}). Qui, l'idea @`e quella di rimuovere
+i caratteri maiuscoli a fine stringa:
+
address@hidden
+$ @kbd{echo qualcosa1234abc | gawk-3.1.8 '@{ sub("[A-Z]*$", ""); print @}'}
address@hidden qualcosa1234a
address@hidden example
+
address@hidden
+Questo non @`e l'output che ci si aspettava, perch@'e, il @samp{bc} alla fine
di
address@hidden non dovrebbe essere individuato da @samp{[A-Z]*}.
+Un tale risultato dipende dalle impostazioni di localizzazione (e quindi
+potrebbe non succedere sul sistema che si sta usando).
+
address@hidden Unicode
+Considerazioni simili valgono per altri intervalli. Per esempio, @samp{["-/]}
address@hidden perfettamente valido in ASCII, ma non @`e valido in molte
localizzazioni
+Unicode, p.es. in @code{en_US.UTF-8}.
+
+Il codice delle prime versioni di @command{gawk} per individuare le
address@hidden non teneva conto della localizzazione, e quindi gli
+intervalli potevano essere interpretati in maniera tradizionale.
+
+Quando @command{gawk} ha iniziato a usare metodi di ricerca di @dfn{regexp}
+che tengono conto della localizzazione, sono iniziati i problemi;
+a maggior ragione in quanto sia GNU/Linux che i venditori di versioni
+commerciali di Unix
+avevano iniziato a implementare localizzazioni non-ASCII,
address@hidden per default}. La domanda che forse si udiva address@hidden
spesso
+era del tipo: ``Perch@'e @samp{[A-Z]} individua lettere minuscole?!?''
+
address@hidden Berry, Karl
+Questa situazione @`e in essere da circa 10 anni, se non di address@hidden, e
+il manutentore di @command{gawk} si @`e stufato di continuare a spiegare che
address@hidden stava semplicemente implementando quelli che sono gli
+standard, e che il problema stava nella localizzazione dell'utente. Nella
+fase di sviluppo della @value{PVERSION} 4.0, @command{gawk} @`e stato
modificato
+in modo da trattare sempre gli
+intervalli "come si faceva prima di POSIX", a meno che non si specifichi
+l'opzione @option{--posix} (@pxref{Opzioni})address@hidden
address@hidden address@hidden@dotless{i}} che @`e nata la Campagna per
l'Interpretazione Razionale degli
+Intervalli (in inglese, RRI address@hidden Range Interpretation}]).
+Un certo
+numero di strumenti GNU hanno address@hidden implementato questa modifica, o
+lo faranno presto. Grazie a Karl Berry per aver coniato la frase
+``Rational Range Interpretation''.}
+
+Fortunatamente, un po' prima del rilascio definitivo della versione 4.0 di
address@hidden, il manutentore ha appreso che lo standard 2008 aveva
+modificato la definizione di intervallo, e che, al di fuori delle
+localizzazioni @code{"C"} e @code{"POSIX"}, il significato di espressione
+di intervallo era ora
address@hidden@footnote{Si veda
address@hidden://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_03_05,
lo standard}
+e
address@hidden://pubs.opengroup.org/onlinepubs/9699919799/xrat/V4_xbd_chap09.html#tag_21_09_03_05,
le motivazioni}.}
+
+Adottando questo simpatico termine tecnico, lo standard permette agli
+implementatori di implementare gli intervalli nella maniera che preferiscono.
+Il manutentore di @command{gawk} ha deciso di implementare la regola pre-POSIX
+sia per l'individuazione di default delle @dfn{regexp} sia quando si
+specificano le opzioni @option{--traditional} o @option{--posix}.
+In ogni caso @command{gawk} aderisce allo standard POSIX.
+
address@hidden Contributori
address@hidden I principali contributori a @command{gawk}
address@hidden @command{gawk}, lista di contributori a
address@hidden
address@hidden sempre il merito, se un merito va riconosciuto.}
address@hidden Anonimo
address@hidden quotation
+
+Questa @value{SECTION} elenca le persone che hanno maggiormente contribuito
+allo sviluppo di @command{gawk} e/o alla stesura di questo @value{DOCUMENT},
+in ordine approssimativamente cronologico:
+
address@hidden @value{BULLET}
address@hidden
address@hidden Aho, Alfred
address@hidden Weinberger, Peter
address@hidden Kernighan, Brian
+Il Dr.@: Alfred V.@: Aho,
+il Dr.@: Peter J.@: Weinberger, e
+il Dr.@: Brian W.@: Kernighan, tutti dei Bell Laboratories,
+hanno progettato e implementato @command{awk} per Unix,
+da cui @command{gawk} trae la maggioranza delle sue address@hidden
+
address@hidden
address@hidden Rubin, Paul
+Paul Rubin,
+autore del progetto e dell'implementazione iniziale del 1986, ha
+scritto la prima bozza (di circa 40 pagine) di questo @value{DOCUMENT}.
+
address@hidden
address@hidden Fenlason, Jay
+Jay Fenlason
+ha completato l'implementazione iniziale.
+
address@hidden
address@hidden Close, Diane
+Diane Close
+ha rivisto la prima bozza di questo @value{DOCUMENT}, portandolo alla
+lunghezza di circa 90 pagine.
+
address@hidden
address@hidden Stallman, Richard
+Richard Stallman
+ha aiutato a completare l'implementazione e la bozza iniziale di questo
address@hidden
address@hidden anche il fondatore della FSF e del progetto GNU.
+
address@hidden
address@hidden Woods, John
+John Woods
+ha scritto porzioni di codice (volti principalmente alla correzione di
+errori) nella versione iniziale di @command{gawk}.
+
address@hidden
address@hidden Trueman, David
+Nel 1988,
+David Trueman
+si @`e fatto carico della manutenzione principale di @command{gawk},
+rendendolo compatibile col ``nuovo'' @command{awk} e
+migliorandone parecchio la address@hidden di esecuzione.
+
address@hidden
address@hidden Kwok, Conrad
address@hidden Garfinkle, Scott
address@hidden Williams, Kent
+Conrad Kwok,
+Scott Garfinkle
+e
+Kent Williams
+hanno per primi portato il programma all'ambiente MS-DOS, usando varie
+versioni del compilatore MSC.
+
address@hidden
address@hidden Rankin, Pat
+Pat Rankin
+ha portato il programma all'ambiente VMS, preparando anche la relativa
+documentazione.
+
address@hidden
address@hidden Peterson, Hal
+Hal Peterson
address@hidden stato di aiuto nel portare @command{gawk} nei sistemy Cray.
+(L'ambiente Cray non @`e address@hidden supportato.)
+
address@hidden
address@hidden Rommel, Kai Uwe
+Kai Uwe Rommel
+ha portato per primo il programma all'ambiente OS/2, preparando anche
+la relativa documentazione.
+
address@hidden
address@hidden Jaegermann, Michal
+Michal Jaegermann
+ha portato il programma all'ambiente Atari, preparando anche la relativa
+documentazione.
+(L'ambiente Atari non @`e address@hidden supportato.)
+Michal continua a effettuare controlli di address@hidden,
+e ha molto contribuito a consentire a @command{gawk}
+di funzionare su sistemi diversi da quelli a 32 bit.
+
address@hidden
address@hidden Fish, Fred
+Fred Fish
+ha portato il programma all'ambiente Amiga, preparando anche la relativa
+documentazione.
+(Purtroppo Fred non @`e address@hidden tra noi, e questo ambiente non @`e
address@hidden supportato.)
+
address@hidden
address@hidden Deifik, Scott
+Scott Deifik
+si @`e occupato della manutenzione per MS-DOS usando il compilatore DJGPP.
+
address@hidden
address@hidden Zaretskii, Eli
+Eli Zaretskii
+si occupa della manutenzione della versione per MS-Windows, nell'ambiente
+MinGW.
+
address@hidden
address@hidden Grigera, Juan
+Juan Grigera
address@hidden autore di una versione di @command{gawk} per sistemi Windows32.
+(Questa versione non @`e address@hidden supportata.)
+
address@hidden
address@hidden Hankerson, Darrel
+Per molti anni, il
+Dr.@: Darrel Hankerson
+ha fatto da coordinatore per le varie versioni che giravano su diverse
+piattaforme PC e ha creato distribuzioni binarie per vari sistemi operativi
+che girano sui PC.
+Il suo aiuto @`e stato importante per mantenere aggiornata la documentazione
+per le diverse piattaforme PC.
+
address@hidden
address@hidden Zoulas, Christos
+Christos Zoulas
+ha scritto la funzione predefinita @code{extension()} per aggiungere
+dinamicamente nuove funzioni.
+(Questa address@hidden @`e divenuta obsoleta a partire da @command{gawk} 4.1.)
+
address@hidden
address@hidden Kahrs, J@"urgen
+J@"urgen Kahrs
+ha scritto la prima versione del codice per interagire con la rete
+TCP/IP, con la relativa documentazione, e fornito le ragioni per l'aggiunta
+dell'operatore @samp{|&}.
+
address@hidden
address@hidden Davies, Stephen
+Stephen Davies
+ha portato per la prima volta il programma all'ambiente Tandem, preparando
+anche la relativa documentazione.
+(Tuttavia, questa versione non @`e address@hidden supportata.)
+Stephen @`e anche stato determinante nel lavoro iniziale per integrare il
codice
+interno di gestione dei byte nel
+complesso del codice di @command{gawk}.
+
address@hidden
address@hidden Woehlke, Matthew
+Matthew Woehlke
+ha migliorato l'aderenza allo standard POSIX nei sistemi Tandem che
+implementano lo standard.
+
address@hidden
address@hidden Brown, Martin
+Martin Brown
+ha portato il programma all'ambiente BeOS, preparando anche la relativa
+documentazione.
+(L'ambiente BeOS non @`e address@hidden supportato.)
+
address@hidden
address@hidden Peters, Arno
+Arno Peters
+ha fatto il lavoro iniziale necessario per consentire alla configurazione
+di @command{gawk} di usare GNU Automake e GNU @command{gettext}.
+
address@hidden
address@hidden Broder, Alan J.@:
+Alan J.@: Broder
+ha scritto la prima versione della funzione @code{asort()} e anche
+il codice per gestire il terzo argomento opzionale della funzione
address@hidden()}.
+
address@hidden
address@hidden Buening, Andreas
+Andreas Buening
+ha aggiornato la versione di @command{gawk} per OS/2.
+
address@hidden
address@hidden Hasegawa, Isamu
+Isamu Hasegawa,
+dell'IBM in Giappone, ha contribuito con il supporto per i caratteri multibyte.
+
address@hidden
address@hidden Benzinger, Michael
+Michael Benzinger ha sviluppato il codice iniziale per l'istruzione
address@hidden
+
address@hidden
address@hidden McPhee, Patrick
+Patrick T.J.@: McPhee ha sviluppato il codice per il caricamento
+dinamico negli ambienti Windows32.
+(Questa address@hidden non @`e address@hidden supportata.)
+
address@hidden
address@hidden Wallin, Anders
+Anders Wallin ha aiutato a continuare il supporto della versione VMS
+di @command{gawk} per parecchi anni.
+
address@hidden
address@hidden Gordon, Assaf
+Assaf Gordon ha scritto il codice per implementare
+l'opzione @option{--sandbox}.
+
address@hidden
address@hidden Haque, John
+John Haque @`e autore dei seguenti contributi:
+
address@hidden @value{MINUS}
address@hidden
+Le modifiche per convertire @command{gawk}
+in un interprete di codice a livello di byte, compreso il debugger
+
address@hidden
+L'aggiunta di veri vettori di vettori
+
address@hidden
+Le modifiche ulteriori per il supporto del calcolo a precisione
+arbitraria
+
address@hidden
+Il testo iniziale di
address@hidden con precisione arbitraria}
+
address@hidden
+Il lavoro per unificare le tre varianti del programma @command{gawk},
+in vista della versione 4.1
+
address@hidden
+I miglioramenti alla gestione interna dei vettori per i vettori i cui
+indici sono dei numeri interi
+
address@hidden
+A John, insieme a Pat Rankin, si devono i miglioramenti alla address@hidden
+di ordinamento dei vettori.
address@hidden itemize
+
address@hidden Papadopoulos, Panos
address@hidden
+Panos Papadopoulos ha scritto il testo originale per
address@hidden file}.
+
address@hidden
address@hidden Yawitz, Efraim
+Efraim Yawitz ha scritto il testo originale per il @ref{Debugger}.
+
address@hidden
address@hidden Schorr, Andrew
+Lo sviluppo dell'estensione API rilasciata per la prima volta con
address@hidden 4.1 @`e stata principalmente guidata da
+Arnold Robbins e Andrew Schorr, con notevoli contributi dal
+resto del team di sviluppo.
+
address@hidden Malmberg, John E.
address@hidden
+John Malmberg ha apportato miglioramenti significativi alla versione
+OpenVMS e alla relativa documentazione.
+
address@hidden
address@hidden Colombo, Antonio
+Antonio Giovanni Colombo ha riscritto diversi esempi, che non erano
address@hidden
+attuali, contenuti nei primi capitoli, e gliene sono estremamente grato.
+
address@hidden
address@hidden Robbins, Arnold
+Arnold Robbins
+ha lavorato su @command{gawk} dal 1988, dapprima
+aiutando David Trueman e in seguito, dal 1994 circa, come
+manutentore principale.
address@hidden itemize
+
address@hidden Sommario della storia
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Il linguaggio @command{awk} si @`e evoluto col passare degli anni. La prima
+versione risale a Unix V7, circa 1978. Nel 1987, per la versione Unix
+System V Release 3.1, sono state fatte al linguaggio delle modifiche
+importanti, inclusa la address@hidden di avere funzioni definite dall'utente.
+Ulteriori modifiche sono state fatte per la versione System V Release 4, nel
+1989.
+Dopo di allora, sono state apportate ulteriori modifiche minori,
+per implementare lo standard POSIX.
+
address@hidden
+L'@command{awk} di Brian Kernighan prevede un piccolo numero di estensioni
+implementate di comune accordo con altre versioni di @command{awk}.
+
address@hidden
address@hidden prevede un elevato numero di estensioni rispetto
+a POSIX @command{awk}.
+Queste estensioni possono essere disabilitate specificando l'opzione
address@hidden o @option{--posix}.
+
address@hidden
+L'interazione tra localizzazioni POSIX e individuazione di @dfn{regexp}
+in @command{gawk} @`e stata causa di malintesi nel corso degli anni. Oggi
address@hidden implementa l'Interpretazione Razionale degli Intervalli
+(@dfn{Rational Range Interpretation}), dove
+intervalli nella forma @samp{[a-z]} individuano @emph{solo} i caratteri
+numericamente compresi tra
address@hidden e @samp{z} nella rappresentazione nativa dei caratteri in quella
+particolare macchina. Normalmente quella in uso @`e quella ASCII,
+ma address@hidden essere EBCDIC sui sistemi IBM S/390.
+
address@hidden
+Molte persone hanno contribuito allo sviluppo di @command{gawk} nel corso
+degli anni. Spero che l'elenco fornito in questo @value{CHAPTER} sia
+esauriente e attribuisca il giusto riconoscimento quando questo @`e dovuto.
+
address@hidden itemize
+
address@hidden Installazione
address@hidden Installare @command{gawk}
+
address@hidden last two commas are part of see also
address@hidden sistemi operativi, si veda anche GNU/address@hidden sistemi
operativi per address@hidden Unix
address@hidden @command{gawk}, installare
address@hidden installare @command{gawk}
+Quest'appendice contiene istruzioni per installare @command{gawk} sulle
+varie piattaforme supportate dagli sviluppatori. Lo sviluppatore
+principale supporta GNU/Linux (e Unix), mentre le altre piattaforme sono
+sono curate da altri sviluppatori.
address@hidden
+per gli indirizzi di posta elettronica di chi effettua la manutenzione
+della versione specifica di una particolare piattaforma.
+
address@hidden
+* Distribuzione di Gawk:: Contenuto della distribuzione di @command{gawk}.
+* Installazione Unix:: Installare @command{gawk} su varie versioni
+ di Unix.
+* Installazione non-Unix:: Installazioni su altri Sistemi Operativi.
+* Bug:: Notificare problemi e bug.
+* Altre versioni:: Altre implementazioni di @command{awk}
+ liberamente disponibili.
+* Sommario dell'installazione:: Sommario dell'installazione.
address@hidden menu
+
address@hidden Distribuzione di Gawk
address@hidden La distribuzione di @command{gawk}
address@hidden codice sorgente di @command{gawk}
address@hidden sorgente, codice, @command{gawk}
+
+Questa @value{SECTION} spiega come ottenere la distribuzione
+di @command{gawk}, come scompattarla, e cosa @`e contenuto nei vari file
+e nelle sottodirectory risultanti.
+
address@hidden
+* Scaricare:: Come ottenere la distribuzione.
+* Scompattazione:: Come estrarre la distribuzione.
+* Contenuti della distribuzione:: Cosa c'@`e nella distribuzione.
address@hidden menu
+
address@hidden Scaricare
address@hidden Ottenere la distribuzione di @command{gawk}
address@hidden @command{gawk}, codice address@hidden ottenere il
address@hidden codice sorgente di @command{gawk}, ottenere il
+Ci sono due modi per ottenere del software GNU:
+
address@hidden @value{BULLET}
address@hidden
+Copiarlo da qualcuno che ce l'abbia address@hidden
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden
+Ottenere @command{gawk}
+dal sito Internet
address@hidden, nella directory @file{/gnu/gawk}.
address@hidden possibile accedere al sito sia via @command{ftp} anonimo che via
@code{http}.
+Se si dispone del programma @command{wget}, si address@hidden utilizzarlo
digitando un
+comando simile a questo:
+
address@hidden
+wget http://ftp.gnu.org/gnu/gawk/address@hidden@value{PATCHLEVEL}.tar.gz
address@hidden example
address@hidden itemize
+
+L'archivio che contiene il software GNU @`e disponibile in vari cloni
+(@dfn{mirror}) in tutto il mondo.
+La lista aggiornata dei siti clone @`e disponibile nel
address@hidden://www.gnu.org/order/ftp.html, sito web principale della FSF}.
+Si tenti di usare uno dei siti-clone; dovrebbero essere meno trafficati, ed @`e
+possibile che ce ne sia uno address@hidden vicino.
+
+Si address@hidden anche scaricare la distribuzione del sorgente di
@command{gawk}
+dal deposito Git ufficiale; per maggiori informazioni, si veda
address@hidden ai sorgenti}.
+
address@hidden Scompattazione
address@hidden Scompattare la distribuzione
address@hidden @`e distribuito sotto forma di parecchi file @code{tar}
+compressi con differenti programmi di compressione: @command{gzip},
address@hidden
+e @command{xz}. Per amor di address@hidden, il resto di queste istruzioni
+presuppone che si stia usando quella compressa col programma GNU Gzip
+(@command{gzip}).
+
+Una volta che si ha a disposizione la distribuzione (p.es.,
address@hidden@address@hidden),
+va usato @code{gzip} per scompattare il file e quindi @code{tar} per estrarne i
+file. Si address@hidden usare la seguente @dfn{pipe} per produrre la
distribuzione
address@hidden:
+
address@hidden
+gzip -d -c address@hidden@value{PATCHLEVEL}.tar.gz | tar -xvpf -
address@hidden example
+
+In un sistema che abbia la versione GNU di @command{tar}, si
address@hidden far effettuare la scompattazione direttamente a @command{tar}:
+
address@hidden
+tar -xvpzf address@hidden@value{PATCHLEVEL}.tar.gz
address@hidden example
+
address@hidden
+L'estrazione dei file dall'archivio
+crea una directory di nome @address@hidden@value{PATCHLEVEL}}
+nella directory corrente.
+
+Il @value{FN} della distribuzione @`e nella forma
address@hidden@address@hidden@var{P}.tar.gz}.
+La @var{V} rappresenta la versione maggiore di @command{gawk},
+la @var{R} rappresenta il rilascio corrente della versione @var{V}, e
+la @var{P} rappresenta un @dfn{patch level}, che sta a indicare che
+correzioni a errori minori sono state incluse nel rilascio.
+Il @dfn{patch level} corrente @`e @value{PATCHLEVEL}, ma quando ci si procura
+una distribuzione, address@hidden ottenuta quella con il livello
address@hidden alto di
+versione, rilascio e @dfn{patch}.
+(Si noti, comunque, che livelli di @dfn{patch} maggiori o uguali a 70
+denotano versioni ``beta'', ossia versioni non destinate a essere usate
+in produzione; non si dovrebbero utilizzare tali versioni, se non si @`e
+disposti a sperimentare.)
+Se non si sta usando un sistema Unix o GNU/Linux, i modi per ottenere
+e scompattare la distribuzione di @command{gawk} sono differenti.
+Si dovrebbe sentire un esperto di quel sistema.
+
address@hidden Contenuti della distribuzione
address@hidden Contenuti della distribuzione @command{gawk}
address@hidden @command{gawk}, distribuzione di
address@hidden distribuzione di @command{gawk}
+
+La distribuzione di @command{gawk} contiene un certo numero di file
+sorgente in C, di file di documentazione, di sottodirectory, e di file
+utilizzati durante il processo di configurazione
+(@pxref{Installazione Unix}),
+come pure parecchie sottodirectory relative a diversi sistemi operativi
+non-Unix:
+
address@hidden @asis
address@hidden Vari file @samp{.c}, @samp{.y} e @samp{.h}
+Questi file contengono il codice sorgente vero e proprio di @command{gawk}.
address@hidden table
+
address@hidden @file
address@hidden support/*
+Intestazioni C e file sorgente per routine che @command{gawk}
+usa, ma che non sono parte della sua address@hidden
+fondamentale. Per esempio, analisi di argomenti, controlli
+di corrispondenze di espressioni regolari, e routine per
+generare numeri casuali sono tutti mantenuti qui.
+
address@hidden ABOUT-NLS
+Un file contenente informazioni sul comando GNU @command{gettext} e
+sulle traduzioni.
+
address@hidden AUTHORS
+Un file con alcune informazioni su chi ha scritto @command{gawk}.
+Esiste solo per placare i pedanti della Free Software Foundation.
+
address@hidden README
address@hidden README_d/README.*
+File descrittivi: vari @file{README} ("leggimi") per @command{gawk} sotto Unix
e per
+tutte le varie altre combinazioni hardware e software.
+
address@hidden INSTALL
+Un file che fornisce una panoramica sul processo di configurazione e
installazione.
+
address@hidden ChangeLog
+Una lista dettagliata delle modifiche apportate al codice sorgente,
+ai problemi risolti e ai miglioramenti introdotti.
+
address@hidden ChangeLog.0
+Una lista meno recente di modifiche al codice sorgente.
+
address@hidden NEWS
+Una lista di modifiche a @command{gawk} a partire dall'ultimo rilascio
+o @dfn{patch}.
+
address@hidden NEWS.0
+Una lista meno recente di modifiche a @command{gawk}.
+
address@hidden COPYING
+La @dfn{GNU General Public License}.
+
address@hidden POSIX.STD
+Una descrizione di comportamenti nello standard POSIX per @command{awk} che
+sono lasciati indefiniti, o ai quali @command{gawk} non address@hidden
conformarsi
+pienamente, come pure una lista di specifiche che lo standard POSIX dovrebbe
+contenere, ma che non sono presenti.
+
address@hidden intelligenza artificiale, @command{gawk} e
address@hidden @command{gawk} e l'intelligenza artificiale
address@hidden doc/awkforai.txt
+Puntatori alla bozza originale di un breve articolo
+che spiega perch@'e @command{gawk} @`e un linguaggio adatto alla
+programmazione nel campo dell'intelligenza artificiale (AI).
+
address@hidden doc/bc_notes
+Una breve descrizione della struttura interna a livello di byte di
address@hidden [``byte code''].
+
address@hidden doc/README.card
address@hidden doc/ad.block
address@hidden doc/awkcard.in
address@hidden doc/cardfonts
address@hidden doc/colors
address@hidden doc/macros
address@hidden doc/no.colors
address@hidden doc/setter.outline
+Il sorgente @command{troff} per una scheda di riferimento a cinque colori
+di @command{awk}.
+Per ottenere la versione a colori @`e richiesta una versione recente di
address@hidden, come la versione GNU di @command{troff} (@command{groff}).
+Si veda il file @file{README.card} per istruzioni su come comportarsi se @`e
+disponibile solo una versione address@hidden vecchia di @command{troff}.
+
address@hidden doc/gawk.1
+Il sorgente @command{troff} di una pagina di manuale address@hidden
+che descrive @command{gawk}.
+Questa pagina @`e distribuita a beneficio degli utenti Unix.
+
address@hidden Texinfo
address@hidden doc/gawktexi.in
address@hidden doc/sidebar.awk
+Il file sorgente Texinfo di questo @value{DOCUMENT}.
+Dovrebbe venire elaborato da @file{doc/sidebar.awk}
+prima di essere elaborato con @command{texi2dvi} o @command{texi2pdf}
+per produrre un documento stampato, o
+con @command{makeinfo} per produrre un file Info o HTML.
+Il @file{Makefile} si occupa di questa elaborazione e produce
+la versione stampabile tramite i comandi
address@hidden o @command{texi2pdf}.
+
address@hidden doc/gawk.texi
+Il file prodotto elaborando @file{gawktexi.in}
+tramite @file{sidebar.awk}.
+
address@hidden doc/gawk.info
+Il file Info generato per questo @value{DOCUMENT}.
+
address@hidden doc/gawkinet.texi
+Il file sorgente Texinfo per
address@hidden
address@hidden, , Introduzione generale, gawkinet, @value{GAWKINETTITLE}}.
address@hidden ifinfo
address@hidden
address@hidden@value{GAWKINETTITLE}}.
address@hidden ifnotinfo
+Dovrebbe venire elaborato con @TeX{}
+(tramite @command{texi2dvi} o @command{texi2pdf})
+per produrre un documento stampato o
+con @command{makeinfo} per produrre un file Info o HTML.
+
address@hidden doc/gawkinet.info
+Il file Info generato per
address@hidden@value{GAWKINETTITLE}}.
+
address@hidden doc/igawk.1
+Il sorgente @command{troff} per una pagina di manuale relativa al
+programma @command{igawk} descritto
address@hidden
+in
address@hidden ifnottex
address@hidden
+nella
address@hidden iftex
address@hidden igawk}.
+(Poich@'e @command{gawk} prevede ora internamente l'uso della direttiva
address@hidden@@include},
+n@'e @command{igawk} n@'e @file{igawk.1} sono effettivamente installati.)
+
address@hidden doc/Makefile.in
+Il file in input usato durante la procedura di configurazione per
+generare l'effettivo @file{Makefile} da usare per creare la documentazione.
+
address@hidden Makefile.am
address@hidden */Makefile.am
+File usati dal software GNU Automake per generare
+il file @file{Makefile.in} usato da Autoconf e dallo script
address@hidden
+
address@hidden Makefile.in
address@hidden aclocal.m4
address@hidden bisonfix.awk
address@hidden config.guess
address@hidden configh.in
address@hidden configure.ac
address@hidden configure
address@hidden custom.h
address@hidden depcomp
address@hidden install-sh
address@hidden missing_d/*
address@hidden mkinstalldirs
address@hidden m4/*
+Questi file e sottodirectory sono usati per configurare e compilare
address@hidden per vari sistemi Unix. L'uso di molti tra questi file @`e
spiegato
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden Unix}. I rimanenti hanno una funzione di supporto
+per l'infrastruttura.
+
address@hidden po/*
+La directory @file{po} contiene la traduzione in varie lingue
+dei messaggi emessi da @command{gawk}.
+
address@hidden awklib/extract.awk
address@hidden awklib/Makefile.am
address@hidden awklib/Makefile.in
address@hidden awklib/eg/*
+La directory @file{awklib} contiene una copia di @file{extract.awk}
+(@pxref{Programma extract}),
+che address@hidden essere usato per estrarre i programmi di esempio dal file
sorgente
+Texinfo di questo @value{DOCUMENT}. Contiene anche un file
address@hidden, che
address@hidden usa per generare un @file{Makefile}.
address@hidden @`e usato da GNU Automake per creare @file{Makefile.in}.
+Le funzioni di libreria descritte
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria},
+sono incluse come file pronti per l'uso nella distribuzione @command{gawk}.
+Essi sono installati come parte della procedura di installazione.
+I rimanenti programmi contenuti in questo @value{DOCUMENT} sono disponibili
+nelle appropriate sottodirectory di @file{awklib/eg}.
+
address@hidden extension/*
+Il codice sorgente, le pagine di manuale, e i file di infrastruttura per
+gli esempi di estensione incluse con @command{gawk}.
address@hidden dinamiche}, per ulteriori dettagli.
+
address@hidden extras/*
+Ulteriori file, non-essenziali. Al momento, questa directory contiene
+alcuni file da eseguire al momento di iniziare una sessione,
+da installare nella directory @file{/etc/profile.d}
+per essere di aiuto nella gestione delle variabili di ambiente
address@hidden e @env{AWKLIBPATH}.
address@hidden da usare a inizio sessione}, per ulteriori informazioni.
+
address@hidden posix/*
+File necessari per compilare @command{gawk} su sistemi conformi allo
+standard POSIX.
+
address@hidden pc/*
+File necessari per compilare @command{gawk} sotto MS-Windows
+(@pxref{Installazione su PC} per i dettagli).
+
address@hidden vms/*
+File necessari per compilare @command{gawk} sotto Vax/VMS e OpenVMS
+(@pxref{Installazione su VMS} per i dettagli).
+
address@hidden test/*
+Una serie di test per
address@hidden Si address@hidden usare @samp{make check} dalla directory
principale
+di @command{gawk} per provare se la serie di test funziona con la
+versione in uso di @command{gawk}.
+Se @command{gawk} supera senza errori @samp{make check}, si address@hidden
essere
+sicuri che sia stato installato e configurato correttamente su un dato
+sistema.
address@hidden table
+
address@hidden Installazione Unix
address@hidden Compilare e installare @command{gawk} su sistemi di tipo Unix
+
+Normalmente, si address@hidden compilare e installare @command{gawk} immettendo
+solo un paio di comandi. Comunque, se si ci si trova in un sistema
+insolito, address@hidden essere necessario
+dover configurare @command{gawk} per quel dato sistema.
+
address@hidden
+* Installazione veloce:: Compilare @command{gawk} sotto Unix.
+* File da usare a inizio sessione:: Funzioni di personalizzazione della
+ shell.
+* Ulteriori opzioni di configurazione:: Altre opzioni utilizzabili in fase di
+ compilazione.
+* Filosofia della configurazione:: Come si suppone che tutto funzioni.
address@hidden menu
+
address@hidden Installazione veloce
address@hidden Compilare @command{gawk} per sistemi di tipo Unix
+
+Questi normali passi di installazione dovrebbero essere sufficienti in
+tutti i moderni sistemi in commercio derivati da Unix, ossia
+GNU/Linux, sistemi basati su BSD, e l'ambiente Cygwin sotto MS-Windows.
+
+Dopo aver estratto la distribuzione di @command{gawk}, posizionarsi con
address@hidden nella directory
address@hidden@address@hidden Come per la maggior parte dei
+programmi GNU, occorre configurare @command{gawk} per il sistema in uso,
+eseguendo il programma @command{configure}. Questo programma @`e
+uno script della shell Bourne, che @`e stato generato automaticamente
+usando il comando GNU Autoconf.
address@hidden
+(Il software Autoconf @`e
+descritto in dettaglio in
address@hidden Automatic Configuration Scripts},
+che address@hidden essere trovato in rete sul sito
address@hidden://www.gnu.org/software/autoconf/manual/index.html,
+della Free Software Foundation}.)
address@hidden ifnotinfo
address@hidden
+(Il software Autoconf @`e descritto in dettaglio a partire da
address@hidden, , Autoconf, autoconf,Autoconf---Generating Automatic
Configuration Scripts}.)
address@hidden ifinfo
+
+Per configurare @command{gawk} basta eseguire @command{configure}:
+
address@hidden
+sh ./configure
address@hidden example
+
+Questo produce i file @file{Makefile} e @file{config.h} adatti al sistema
+in uso.
+Il file @file{config.h} descrive varie situazioni relative al sistema in uso.
address@hidden possibile modificare il @file{Makefile} per
+cambiare la variabile @code{CFLAGS}, che controlla
+le opzioni di riga di comando da passare al compilatore C (come i livelli
+di ottimizzazione o la richiesta di generare informazioni per il @dfn{debug}).
+
+In alternativa, si possono specificare dei valori a piacere per
+molte delle variabili di @command{make} sulla riga di comando,
+come @code{CC} e @code{CFLAGS}, quando
+ si chiama il programma
address@hidden:
+
address@hidden
+CC=cc CFLAGS=-g sh ./configure
address@hidden example
+
address@hidden
+Si veda il file @file{INSTALL} nella distribuzione di @command{gawk} per
+tutti i dettagli.
+
+Dopo aver eseguito @command{configure} ed eventualmente modificato
address@hidden,
+va dato il comando:
+
address@hidden
+make
address@hidden example
+
address@hidden
+Poco dopo, si dovrebbe avere a disposizione una versione eseguibile
+di @command{gawk}.
+Questo @`e tutto!
+Per verificare se @command{gawk} funziona correttamente,
+va dato il comando @samp{make check}. Tutti i test dovrebbero terminare con
+successo.
+Se questi passi non producono il risultato desiderato, o se qualche
+test fallisce, controllare i file nella directory @file{README_d}
+per determinare se quello che @`e capitato @`e un problema noto.
+Se il problema capitato non @`e descritto address@hidden@dotless{i}},
+inviare una segnalazione di @dfn{bug} (@pxref{Bug}).
+
+Naturalmente, dopo aver compilato @command{gawk}, verosimilmente
address@hidden installato. Per fare address@hidden, occorre eseguire il comando
address@hidden install}, disponendo delle autorizzazioni necessarie.
+Come acquisirle varia da sistema a sistema, ma su molti sistemi si
address@hidden
+usare il comando @command{sudo} per ottenerle. Il comando da immettere
+diventa in questo caso @samp{sudo make install}. @`E probabile che sia
+necessario fornire una password, ed essere stati messi nella lista degli
+utenti che possono utilizzare il comando @command{sudo}.
+
address@hidden File da usare a inizio sessione
address@hidden File di inizializzazione della shell
+
+La distribuzione contiene i file da usare a inizio sessione
address@hidden e
address@hidden, che contengono funzioni che possono essere di aiuto
+nel gestire le variabili di ambiente
address@hidden e @env{AWKLIBPATH}.
+Su un sistema Fedora GNU/Linux, questi file dovrebbero essere installati
+nella directory @file{/etc/profile.d};
+su altre piattaforme, la posizione corretta address@hidden essere differente.
+
address@hidden @command
+
address@hidden @command{gawkpath_default}, funzione della shell
address@hidden funzione della shell @command{gawkpath_default}
address@hidden gawkpath_default
+Ripristina la variabile d'ambiente @env{AWKPATH} al suo valore di default.
+
address@hidden @command{gawkpath_prepend}, funzione della shell
address@hidden funzione della shell @command{gawkpath_prepend}
address@hidden gawkpath_prepend
+Aggiunge l'argomento all'inizio della variabile d'ambiente @env{AWKPATH}.
+
address@hidden @command{gawkpath_append}, funzione della shell
address@hidden funzione della shell @command{gawkpath_append}
address@hidden gawkpath_append
+Aggiunge l'argomento alla fine della variabile d'ambiente @env{AWKPATH}.
+
address@hidden @command{gawklibpath_default}, funzione della shell
address@hidden funzione della shell @command{gawklibpath_default}
address@hidden gawklibpath_default
+Reimposta la variabile d'ambiente @env{AWKLIBPATH} al suo valore di default.
+
address@hidden @command{gawklibpath_prepend}, funzione della shell
address@hidden funzione della shell @command{gawklibpath_prepend}
address@hidden gawklibpath_prepend
+Aggiunge l'argomento all'inizio della variabile d'ambiente
address@hidden
+
address@hidden @command{gawklibpath_append}, funzione della shell
address@hidden funzione della shell @command{gawklibpath_append}
address@hidden gawklibpath_append
+Aggiunge l'argomento alla fine della variabile d'ambiente
address@hidden
+
address@hidden table
+
+
address@hidden Ulteriori opzioni di configurazione
address@hidden Ulteriori opzioni di configurazione
address@hidden @command{gawk}, configurazione, opzioni di
address@hidden configurazione di @command{gawk}, opzioni di
+
+Ci sono parecchie altre opzioni che si possono utilizzare sulla riga
+di comando di @command{configure}
+quando si compila @command{gawk} a partire dai sorgenti, tra cui:
+
address@hidden @code
+
address@hidden @option{--disable-extensions}, opzione di configurazione
address@hidden opzione di configurazione @code{--disable-extensions}
address@hidden --disable-extensions
+Richiede di non configurare e generare le estensioni di esempio nella
+directory @file{extension}. Questo @`e utile quando si genera
address@hidden per essere eseguito su un'altra piattaforma.
+L'azione di default @`e di controllare dinamicamente se le estensioni
+possono essere configurate e compilate.
+
address@hidden @option{--disable-lint}, opzione di configurazione
address@hidden opzione di configurazione @code{--disable-lint}
address@hidden --disable-lint
+Disabilita i controlli @dfn{lint} all'interno di @command{gawk}. Le opzioni
address@hidden e @option{--lint-old}
+(@pxref{Opzioni})
+sono accettate, ma non fanno nulla, e non emettono alcun messaggio di
+avvertimento.
+Analogamente, se si imposta la variabile @code{LINT}
+(@pxref{Variabili modificabili dall'utente})
+questa non ha alcun effetto sul programma @command{awk} in esecuzione.
+
+Se si specifica l'opzione del compilatore GNU Compiler Collection (GCC) che
+elimina il codice non eseguito, quest'opzione riduce di quasi
+23K byte la dimensione del programma eseguibile @command{gawk}
+su sistemi GNU/Linux x86_64. I risultati su altri sistemi e con
+altri compilatori sono probabilmente diversi.
+L'uso di questa opzione address@hidden apportare qualche piccolo miglioramento
nei
+tempi di esecuzione di un programma.
+
address@hidden ATTENZIONE
+Se si usa quest'opzione alcuni dei test di address@hidden non avranno successo.
+Quest'opzione address@hidden essere rimossa in futuro.
address@hidden quotation
+
address@hidden @option{--disable-nls}, opzione di configurazione
address@hidden opzione di configurazione @code{--disable-nls}
address@hidden --disable-nls
+Non attiva la traduzione automatica dei messaggi.
address@hidden normalmente non @`e consigliabile, ma address@hidden apportare
qualche lieve
+miglioramento nei tempi di esecuzione di un programma.
+
address@hidden @option{--with-whiny-user-strftime}, opzione di configurazione
address@hidden opzione di configurazione @code{--with-whiny-user-strftime}
address@hidden --with-whiny-user-strftime
+Forza l'uso della versione della funzione C @code{strftime()} inclusa nella
+distribuzione di @command{gawk}, per i sistemi in cui la funzione stessa
+non sia disponibile.
address@hidden table
+
+Si usi il comando @samp{./configure --help} per ottenere la lista completa
+delle opzioni disponibili in @command{configure}.
+
address@hidden Filosofia della configurazione
address@hidden Il processo di configurazione
+
address@hidden @command{gawk}, configurazione di
address@hidden configurazione di @command{gawk}
+Questa @value{SECTION} interessa solo a chi abbia un minimo di address@hidden
con
+il linguaggio C e con i sistemi operativi di tipo Unix.
+
+Il codice sorgente di @command{gawk}, in generale, cerca di aderire, nei limiti
+del possibile, a degli standard formali. address@hidden significa che
@command{gawk} usa
+routine di libreria che sono specificate nello standard ISO C e nello standard
+POSIX per le interfacce dei sistemi operativi. Il codice sorgente di
address@hidden richiede l'uso di un compilatore ISO C (standard 1990).
+
+Molti sistemi Unix non aderiscono completamente n@'e allo standard ISO n@'e a
+quello POSIX. La sottodirectory @file{missing_d} nella distribuzione di
address@hidden contiene delle versioni sostitutive per quelle funzioni che
address@hidden
+frequentemente risultano essere non disponibili.
+
+Il file @file{config.h} creato da @command{configure} contiene definizioni che
+elencano address@hidden del particolare sistema operativo nel quale si tenta di
+compilare @command{gawk}. Le tre cose descritte da questo file sono: quali
+file di intestazione sono disponibili, in modo da poterli includere
correttamente,
+quali funzioni (presumibilmente) standard sono realmente disponibili nelle
+librerie C, e varie informazioni assortite riguardo al sistema operativo
+corrente. Per esempio, address@hidden non esserci l'elemento
@code{st_blksize} nella
+struttura @code{stat}. In questo caso, @samp{HAVE_STRUCT_STAT_ST_BLKSIZE} @`e
+indefinito.
+
address@hidden @code{custom.h}, file
address@hidden possible che il compilatore C del sistema in uso "tragga in
inganno"
address@hidden address@hidden succedere nel caso in cui non viene restituito
+un errore se una funzione di libreria non @`e disponibile. Per superare questo
+problema, si address@hidden modificare il file @file{custom.h}. Basta usare
una direttiva
address@hidden appropriata per il sistema corrente, e definire, tramite
address@hidden, tutte le costanti che @command{configure} avrebbe dovuto
+definire, ma non @`e riuscito a farlo, oppure, usando @code{#undef} annullare
le
+costanti che @command{configure} ha definito, ma non avrebbe dovuto farlo. Il
+file @file{custom.h} @`e automaticamente incluso dal file @file{config.h}.
+
address@hidden anche possibile che il programma @command{configure} generato da
Autoconf non
+funzioni in un dato sistema per una ragione differente. Se c'@`e un problema,
si
+tenga presente che il file @file{configure.ac} @`e quello preso in input da
+Autoconf. @`E possibile modificare questo file e generare una nuova versione
di
address@hidden che funzioni sul sistema corrente (@pxref{Bug} per
+informazioni su come segnalare problemi nella configurazione di
address@hidden). Lo stesso meccanismo si address@hidden usare per inviare
aggiornamenti
+al file @file{configure.ac} e/o a @file{custom.h}.
+
address@hidden Installazione non-Unix
address@hidden Installazione su altri Sistemi Operativi
+
+Questa @value{SECTION} descrive come installare @command{gawk} su
+vari sistemi non-Unix.
+
address@hidden
+* Installazione su PC:: Installare e compilare @command{gawk}
+ su Microsoft Windows.
+* Installazione su VMS:: Installare @command{gawk} su VMS.
address@hidden menu
+
address@hidden Installazione su PC
address@hidden Installazione su MS-Windows
+
address@hidden PC, @command{gawk} su sistemi operativi
address@hidden sistemi operativi per PC, @command{gawk} su
address@hidden installare @command{gawk} su sistemi operativi per PC
+Questa @value{SECTION} tratta dell'installazione e uso di @command{gawk}
+su macchine con architettura Intel che eseguono qualsiasi versione di
+MS-Windows.
+In questa @value{SECTION}, il termine ``Windows32''
+si riferisce a una qualsiasi versione di Microsoft Windows
+95/98/ME/NT/2000/XP/Vista/7/8/10.
+
+Si veda anche il file @file{README_d/README.pc} nella distribuzione.
+
address@hidden
+* Installazione binaria su PC:: Installare una distribuzione pronta
+ all'uso.
+* Compilazione su PC:: Compilare @command{gawk} per Windows32.
+* Uso su PC:: Eseguire @command{gawk} su Windows32.
+* Cygwin:: Compilare ed eseguire @command{gawk}
+ per Cygwin.
+* MSYS:: Usare @command{gawk} nell'ambiente MSYS.
address@hidden menu
+
address@hidden Installazione binaria su PC
address@hidden Installare una distribuzione predisposta per sistemi MS-Windows
+
+La sola distribuzione binaria predisposta supportata per i sistem MS-Windows
address@hidden quella messa a disposizione da Eli Zaretskii
address@hidden://sourceforge.net/projects/ezwinports/, progetto ``ezwinports''}.
+Si parta da address@hidden@dotless{i}} per installare il comando
@command{gawk} precompilato.
+
address@hidden Compilazione su PC
address@hidden Compilare @command{gawk} per sistemi operativi di PC
+
address@hidden address@hidden essere compilato per Windows32, usando MinGW
+(per Windows32).
+Il file @file{README_d/README.pc} nella distribuzione @command{gawk}
+contiene ulteriori annotazioni, e il file @file{pc/Makefile} contiene
+informazioni importanti sulle opzioni di compilazione.
+
address@hidden compilare @command{gawk} per MS-Windows
+Per compilare @command{gawk} per Windows32, occorre copiare i file
+dalla directory @file{pc} (@emph{tranne} il file @file{ChangeLog}) alla
+directory che contiene il resto dei sorgenti di @command{gawk}, e quindi
+chiamare @command{make}, specificando il nome appropriato di obiettivo come
+argomento, per generare @command{gawk}. Il @file{Makefile} copiato dalla
+directory @file{pc} contiene una sezione di configurazione con commenti, e
address@hidden
+essere necessario modificarlo perch@'e funzioni con il programma di
address@hidden
address@hidden corrente.
+
+Il @file{Makefile} contiene un certo numero di alternative, che permettono di
+generare @command{gawk} per diverse
+versioni MS-DOS e Windows32. Se il comando @command{make} @`e richiamato senza
+specificare alcun argomento viene stampata una lista delle alternative
+disponibili. Per esempio,
+per generare un codice binario di @command{gawk} nativo per MS-Windows
+usando gli strumenti MinGW, scrivere @samp{make mingw32}.
+
address@hidden Uso su PC
address@hidden Usare @command{gawk} su sistemi operativi PC
address@hidden PC, @command{gawk} su sistemi operativi
address@hidden sistemi operativi PC, @command{gawk} su
+
+Sotto MS-Windows, gli ambienti Cygwin e MinGW consentono di usare
+sia l'operatore @samp{|&} che le operazioni su rete TCP/IP
+(@pxref{Reti TCP/IP}).
+
address@hidden percorso di ricerca
address@hidden percorso di ricerca per file sorgente
address@hidden @command{gawk}, versione MS-Windows di
address@hidden @code{;} (punto e virgola), @env{AWKPATH} variabile e
address@hidden punto e virgola (@code{;}), @env{AWKPATH} variabile e
address@hidden @env{AWKPATH}, variabile d'ambiente
address@hidden variabile d'ambiente @env{AWKPATH}
+Le versioni MS-Windows di @command{gawk} ricercano i file di
+programma come descritto in @ref{AWKPATH (Variabile)}. Comunque, gli elementi
+della variabile @env{AWKPATH} sono separati tra di loro da un punto e virgola
+(anzich@'e da due punti (@code{:})).
+Se @env{AWKPATH} @`e non impostata o ha per valore la stringa nulla, il
percorso
+di ricerca di default @`e @address@hidden;c:/lib/awk;c:/gnu/lib/awk}}.
+
address@hidden estensioni comuni, variabile @code{BINMODE}
address@hidden @cindex extensions, address@hidden @code{BINMODE} variable
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{BINMODE}
address@hidden @code{BINMODE}, variabile
address@hidden variabile @code{BINMODE}
+Sotto MS-Windows,
address@hidden (come molti altri programmi di trattamento testi) converte
+automaticamente la stringa di fine riga @samp{\r\n} in @samp{\n} leggendo
dall'input
+e @samp{\n} in @samp{\r\n} scrivendo sull'output.
+La variabile speciale @code{BINMODE} @value{COMMONEXT} permette di controllare
+come avvengono queste conversioni, ed @`e interpretata come segue:
+
address@hidden @value{BULLET}
address@hidden
+Se @code{BINMODE} @`e @code{"r"} o uno,
+la address@hidden binaria @`e impostata
+in lettura (address@hidden, nessuna conversione in lettura).
+
address@hidden
+Se @code{BINMODE} @`e @code{"w"} o due,
+la address@hidden binaria @`e impostata
+in scrittura (address@hidden, nessuna conversione in scrittura).
+
address@hidden
+Se @code{BINMODE} @`e @code{"rw"} o @code{"wr"} o tre,
+la address@hidden binaria @`e impostata sia in lettura che in scrittura.
+
address@hidden
address@hidden@var{stringa-non-nulla}} equivale a specificare
address@hidden (address@hidden, nessuna conversione in
+lettura e scrittura). Tuttavia, @command{gawk} emette un messaggio di
+avviso se la stringa non @`e @code{"rw"} o @code{"wr"}.
address@hidden itemize
+
address@hidden
+La address@hidden di trattamento dello standard input e standard output sono
+impostate una volta sola
+(dopo aver letto la riga di comando, ma prima di iniziare a elaborare
+qualsiasi programma @command{awk}).
+L'impostazione di @code{BINMODE} per standard input o
+standard output va fatta usando
+un'appropriata opzione @samp{-v address@hidden sulla riga di comando.
address@hidden @`e impostato nel momento in cui un file o @dfn{pipe} @`e aperto
+e non address@hidden essere cambiato in corso di elaborazione.
+
+Il nome @code{BINMODE} @`e stato scelto in analogia con @command{mawk}
+(@pxref{Altre versioni}).
address@hidden e @command{gawk} gestiscono @code{BINMODE} in maniera simile;
+tuttavia, @command{mawk} prevede un'opzione @samp{-W address@hidden e una
+variabile d'ambiente che address@hidden impostare @code{BINMODE}, @code{RS}, e
@code{ORS}.
+I file @file{binmode[1-3].awk} (nella directory @file{gnu/lib/awk} in alcune
+delle distribuzioni binarie address@hidden predisposte) sono stati inclusi per
rendere
+disponibile l'opzione di @command{mawk} @samp{-W address@hidden Questi
+possono essere modificati o ignorati; in particolare, quale sia l'impostazione
+di @code{RS} che address@hidden meno ``sorprese'' rimane una questione aperta.
address@hidden usa @samp{RS = "\r\n"} se si imposta la address@hidden binaria in
+lettura, il che @`e appropriato per file che abbiano i caratteri di fine riga
in
+stile MS-DOS.
+
+Per chiarire, gli esempi seguenti impostano la address@hidden binaria in
+scrittura per lo standard output e altri file, e impostano @code{ORS} in modo
+da ottenere la fine riga ``normale'' in stile MS-DOS:
+
address@hidden
+gawk -v BINMODE=2 -v ORS="\r\n" @dots{}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+gawk -v BINMODE=w -f binmode2.awk @dots{}
address@hidden example
+
address@hidden
+Questi comandi danno lo stesso risultato dell'opzione
address@hidden BINMODE=2} in @command{mawk}.
+Quanto segue modifica il separatore di record a @code{"\r\n"} e imposta
+la address@hidden binaria in lettura, senza modificare le letture da standard
input:
+
address@hidden
+gawk -v RS="\r\n" -e "BEGIN @{ BINMODE = 1 @}" @dots{}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+gawk -f binmode1.awk @dots{}
address@hidden example
+
address@hidden
+Usando i caratteri di protezione appropriati, nel primo
+esempio l'impostazione di @code{RS} address@hidden essere spostata in una
regola
address@hidden
+
address@hidden Cygwin
address@hidden Usare @command{gawk} in ambiente Cygwin
address@hidden compilare @command{gawk} per Cygwin
address@hidden Cygwin, compilare @command{gawk} per
+
address@hidden address@hidden essere compilato e usato
address@hidden@dotless{i}} com'@`e'' sotto MS-Windows se
+si opera all'interno dell'ambiente @uref{http://www.cygwin.com, Cygwin}.
+Questo ambiente consente un'eccellente simulazione di GNU/Linux, con l'uso di
+Bash, GCC, GNU Make, e altri programmi GNU. La compilazione e l'installazione
+per Cygwin @`e la stessa usata nei sistemi di tipo Unix:
+
address@hidden
+tar -xvpzf address@hidden@value{PATCHLEVEL}.tar.gz
+cd address@hidden@value{PATCHLEVEL}
+./configure
+make && make check
address@hidden example
+
+In confronto a un sistema GNU/Linux sulla stessa macchina, l'esecuzione
+del passo di @samp{configure} sotto Cygwin richiede molto address@hidden
tempo. Tuttavia
+si conclude regolarmente, e poi @samp{make} funziona come ci si aspetta.
+
address@hidden MSYS
address@hidden Usare @command{gawk} in ambiente MSYS
+
+Nell'ambiente MSYS sotto MS-Windows, @command{gawk} automaticamente usa la
address@hidden binaria per leggere e scrivere file. Non @`e quindi necessario
usare la
+variabile @code{BINMODE}.
+
+Questo address@hidden causare problemi con altri componenti di tipo Unix che
sono stati
+resi disponibile in MS-Windows, che si aspettano che @command{gawk} faccia
+automaticamente la conversione di @code{"\r\n"}, mentre
address@hidden@dotless{i}} non @`e.
+
address@hidden Installazione su VMS
address@hidden Compilare e installare @command{gawk} su Vax/VMS e OpenVMS
+
address@hidden based on material from Pat Rankin <address@hidden>
address@hidden now address@hidden
address@hidden now address@hidden
+
address@hidden @command{gawk}, versione VMS di
address@hidden installare @command{gawk} su VMS
address@hidden VMS, installare @command{gawk} su
+Questa @value{SUBSECTION} descrive come compilare e installare @command{gawk}
+sotto VMS. Il termine classico ``VMS'' @`e usato qui anche per designare
+OpenVMS.
+
address@hidden
+* Compilazione su VMS:: Come compilare @command{gawk} su VMS.
+* Estensioni dinamiche su VMS:: Compilare estensioni dinamiche
+ di @command{gawk} su VMS.
+* Dettagli installazione su VMS:: Come installare @command{gawk} su VMS.
+* Esecuzione su VMS:: Come eseguire @command{gawk} su VMS.
+* GNV su VMS:: Il progetto VMS GNV.
+* Vecchio Gawk su VMS:: Una versione non aggiornata arriva
+ con alcune versioni di VMS.
address@hidden menu
+
address@hidden Compilazione su VMS
address@hidden Compilare @command{gawk} su VMS
address@hidden compilare @command{gawk} per VMS
address@hidden VMS, compilare @command{gawk} per
+
+Per compilare @command{gawk} sotto VMS, esiste una procedura di comandi
address@hidden che esegue tutti i comandi @code{CC} e @code{LINK} necessari.
C'@`e
+anche un @file{Makefile} da usare con i programmi di address@hidden @code{MMS}
e
address@hidden A partire della directory che contiene i file sorgente, si usi:
+
address@hidden
+$ @kbd{@@[.vms]vmsbuild.com}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+$ @kbd{MMS/DESCRIPTION=[.vms]descrip.mms gawk}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+$ @kbd{MMK/DESCRIPTION=[.vms]descrip.mms gawk}
address@hidden example
+
+Il comando @command{MMK} @`e un quasi-clone, a codice aperto e gratuito, di
address@hidden, che gestisce in maniera migliore i volumi ODS-5 con @value{FNS}
+a caratteri maiuscoli e minuscoli. @command{MMK} @`e disponibile da
address@hidden://github.com/endlesssoftware/mmk}.
+
+Avendo a che fare con volumi ODS-5 e con l'analisi sintattica estesa abilitata,
+il nome del parametro che specifica l'obiettivo address@hidden dover essere
scritto
+digitando esattamente le lettere maiuscole e minuscole.
+
address@hidden @`e stato testato sotto VAX/VMS 7.3 e Alpha/VMS 7.3-1 usando il
+compilatore Compaq C V6.4, e sotto Alpha/VMS 7.3, Alpha/VMS 7.3-2, e IA64/VMS
+8.3. Le compilazioni address@hidden recenti hanno usato il compilatore HP C
V7.3 su Alpha
+VMS 8.3 e su VMS 8.4, sia Alpha che IA64, hanno usato il compilatore HP C
address@hidden'architettura IA64 @`e anche nota come ``Itanium''.}
+
address@hidden su VMS} per informazioni su come compilare
address@hidden come un kit PCSI compatible con il prodotto GNV.
+
address@hidden Estensioni dinamiche su VMS
address@hidden Compilare estensioni dinamiche di @command{gawk} in VMS
+
+Le estensioni che sono state rese disponibile su VMS possono essere
+costruite dando uno dei comandi seguenti:
+
address@hidden
+$ @kbd{MMS/DESCRIPTION=[.vms]descrip.mms extensions}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+$ @kbd{MMK/DESCRIPTION=[.vms]descrip.mms extensions}
address@hidden example
+
address@hidden usa @code{AWKLIBPATH} come una variabile d'ambiente
+oppure come un nome logico per trovare le estensioni dinamiche.
+
+Le estensioni dinamiche devono essere compilate con le stesse opzioni del
+compilatore usate per compilare @command{gawk} riguardanti numeri in virgola
+mobile, dimensione dei puntatori e trattamento dei nomi simbolici. I computer
+con architettura Alpha e Itanium dovrebbero usare i numeri in virgola mobile
+col formato IEEE. La dimensione dei puntatori @`e 32 bit, e il trattamento
dei nomi
+simbolici dovrebbe richiedere il rispetto esatto di maiuscole/minuscole, con le
+abbreviazioni CRC per simboli address@hidden lunghi di 32 bit.
+
+Per Alpha e Itanium:
+
address@hidden
+/name=(as_is,short)
+/float=ieee/ieee_mode=denorm_results
address@hidden example
+
+Per VAX:
+
address@hidden
+/name=(as_is,short)
address@hidden example
+
+Le macro da usare al momento della compilazione devono essere definite prima di
+includere il primo file di intestazione proveniente da VMS, come segue:
+
address@hidden
+#if (__CRTL_VER >= 70200000) && !defined (__VAX)
+#define _LARGEFILE 1
+#endif
+
+#ifndef __VAX
+#ifdef __CRTL_VER
+#if __CRTL_VER >= 80200000
+#define _USE_STD_STAT 1
+#endif
+#endif
+#endif
address@hidden example
+
+Se si scrivono delle estensioni utente da eseguire su VMS, vanno fornite anche
+queste definizioni. Il file @file{config.h} creato quando si compila
address@hidden su VMS lo fa address@hidden; se invece si usa qualche altro file
simile,
+occorre ricordarsi di includerlo prima di qualsiasi file di intestazione
+proveniente da VMS.
+
address@hidden Dettagli installazione su VMS
address@hidden Installare @command{gawk} su VMS
+
+Per usare @command{gawk}, tutto address@hidden che serve @`e un comando
``esterno'', che @`e
+un simbolo @code{DCL} il cui valore inizia col segno del dollaro.
+Per esempio:
+
address@hidden
+$ @kbd{GAWK :== $disk1:[gnubin]gawk}
address@hidden example
+
address@hidden
+Si sostituisca la posizione corrente di @command{gawk.exe} a
address@hidden:[gnubin]}. Il simbolo dovrebbe essere posto nel file
address@hidden di ogni utente che desideri eseguire @command{gawk},
+in modo che sia definito ogni volta che l'utente inizia una sessione.
+Alternativamente, il simbolo address@hidden essere messo nella procedura di
sistema
address@hidden,
+in modo da permettere a tutti gli utenti di eseguire @command{gawk}.
+
+Se @command{gawk} @`e stato installato da un kit PCSI nell'albero di
+directory @file{GNV$GNU:}, il programma address@hidden come nome
address@hidden:[bin]gnv$gawk.exe}, e il file di aiuto address@hidden chiamato
address@hidden:[vms_help]gawk.hlp}.
+
+Il kit PCSI installa anche un file @file{GNV$GNU:[vms_bin]gawk_verb.cld}
+che address@hidden essere usato per aggiungere @command{gawk} e @command{awk}
+alla lista dei comandi DCL.
+
+Per farlo solo nella sessione corrente si address@hidden usare:
+
address@hidden
+$ @kbd{set command gnv$gnu:[vms_bin]gawk_verb.cld}
address@hidden example
+
+Oppure il sistemista VMS address@hidden usare
@file{GNV$GNU:[vms_bin]gawk_verb.cld} per
+aggiungere @command{gawk} e @command{awk} alla tabella @samp{DCLTABLES}
+valida per tutto il sistema.
+
+La sintassi DCL @`e documentata nel file @file{gawk.hlp}.
+
+In alternativa, l'elemento @file{gawk.hlp} address@hidden essere caricato in
una
+libreria di aiuto VMS:
+
address@hidden
+$ @kbd{LIBRARY/HELP sys$help:helplib [.vms]gawk.hlp}
address@hidden example
+
address@hidden
+(Una libreria specifica dell'installazione potrebbe venir usata invece
+della libreria standard VMS library @samp{HELPLIB}.) Dopo aver installato
+il testo di aiuto, il comando:
+
address@hidden
+$ @kbd{HELP GAWK}
address@hidden example
+
address@hidden
+fornisce informazioni sia sull'implementazione di @command{gawk}
+sia sul linguaggio di programmazione @command{awk}.
+
+Il nome logico @samp{AWK_LIBRARY} address@hidden designare una posizione di
default per i
+file di programma @command{awk}. Riguardo all'opzione @option{-f}, se il
address@hidden specificato non contiene un dispositivo o un percorso di
directory,
address@hidden cerca dapprima nella directory corrente, poi nella directory
+specificata dalla traduzione di @samp{AWK_LIBRARY} se il file non @`e stato
+trovato. Se, dopo aver cercato in entrambe queste directory, il file non @`e
+ancora stato trovato, @command{gawk} appone il suffisso @samp{.awk} al
address@hidden e ritenta la ricerca del file. Se @samp{AWK_LIBRARY} non @`e
+definita, si usa per essa il valore di default @samp{SYS$LIBRARY:}.
+
address@hidden Esecuzione su VMS
address@hidden Eseguire @command{gawk} su VMS
+
+L'elaborazione della riga di comando e le convenzioni per proteggere i
+caratteri sono significativamente differenti in VMS, e quindi gli esempi
+presenti in questo @value{DOCUMENT} o provenienti da altre fonti necessitano
+piccole modifiche. Le modifiche, tuttavia, @emph{sono} veramente piccole, e
+tutti i programmi @command{awk} dovrebbero funzionare correttamente.
+
+Ecco un paio di semplici test:
+
address@hidden
+$ @kbd{gawk -- "BEGIN @{print ""Hello, World!""@}"}
+$ @kbd{gawk -"W" version}
+! ma anche -"W version" o "-W version"
address@hidden example
+
address@hidden
+Si noti che il testo con caratteri maiuscoli e misti maiuscoli/minuscoli
+dev'essere incluso tra doppi apici.
+
+La versione VMS di @command{gawk} comprende un'interfaccia in stile @code{DCL},
+oltre a quella originale, di tipo shell (si veda il file di aiuto per ulteriori
+dettagli). Un effetto indesiderato della duplice analisi della riga
+di comando @`e che se c'@`e solo un unico parametro (come nel programma con le
+righe contenenti doppi apici), il comando diviene ambiguo. Per evitare questo
+inconveniente, il flag, normalmente non necessario, @option{--} @`e necessario
+per forzare un esame dei parametri in stile Unix, piuttosto che nella
address@hidden
address@hidden Se qualsiasi altra opzione preceduta dal segno @option{-} (o
address@hidden
+parametri, per esempio, address@hidden @value{DF} in input) @`e presente, non
c'@`e address@hidden,
+e l'opzione @option{--} address@hidden essere omessa.
+
address@hidden exit, codice di ritorno, in VMS
+Il valore di @code{exit} @`e un valore in stile Unix e viene trasformato in
+una condizione VMS all'uscita del programma.
+
+I bit di address@hidden di VMS saranno impostati a partire dal valore
dell'istruzione
address@hidden Un errore grave @`e indicato da 1, e VMS imposta la condizione
address@hidden Un errore fatale @`e indicato da 2, e VMS imposta la condizione
address@hidden Ogni altro valore imposta la condizione @code{SUCCESS}. Il
+valore d'uscita @`e codificato per aderire agli standard di codifica VMS e
address@hidden
+un @code{C_FACILITY_NO} di @code{0x350000} con il codice costante @code{0xA000}
+aggiunto al numero spostato a sinistra di 3 bit per far posto al codice di
address@hidden
+
+Per estrarre il codice reale di ritorno dell'istruzione @code{exit}
+di @command{gawk} dalla condizione impostata da VMS, si usi:
+
address@hidden
+unix_status = (vms_status .and. %x7f8) / 8
address@hidden example
+
address@hidden
+Un programma C che usa @code{exec()} per chiamare @command{gawk}
address@hidden il valore originale della exit in stile Unix.
+
+Precedenti versioni di @command{gawk} per VMS consideravano un codice di
+ritorno a Unix di 0 come 1, un errore come 2, un errore fatale come 4, e tutti
+gli altri valori erano restituiti immodificati. Questa era una violazione
+rispetto alle specifiche di codifica delle condizioni di uscita di VMS.
+
address@hidden numeri in virgola mobile, VAX/VMS
address@hidden VAX/VMS, numeri in virgola mobile,
+L'aritmetica in virgola mobile VAX/VMS usa un arrotondamento statistico.
address@hidden round}.
+
+VMS restituisce data e ora in formato GMT, a meno che non siano stati impostati
+i nomi logici @code{SYS$TIMEZONE_RULE} o @code{TZ}. Precedenti versioni di
+VMS, come VAX/VMS 7.3, non impostano questi nomi logici.
+
address@hidden @cindex directory search
address@hidden @cindex path, search
address@hidden percorso di ricerca
address@hidden percorso di ricerca per file sorgente
+Il percorso di ricerca di default, nella ricerca dei file di programma per
address@hidden specificati dall'opzione @option{-f}, @`e
address@hidden"SYS$DISK:[],AWK_LIBRARY:"}. Il nome logico @env{AWKPATH}
address@hidden essere
+usato per sostituire questo di default. Il formato di @env{AWKPATH} @`e una
lista
+di directory, separate da virgola. Nel definirla, il valore dovrebbe essere
+incluso tra doppi apici, in modo che consenta una sola traduzione, e non una
+lista di ricerca multitraduzione @code{RMS}.
+
address@hidden ridirezione in VMS
+
+Questa restrizione vale anche se si esegue @command{gawk} sotto GNV,
+in quanto la ridirezione @`e sempre verso un comando DCL.
+
+Se si ridirigono dati verso un comando o un programma di address@hidden VMS,
+l'implementazione corrente richiede la creazione di un comando VMS esterno che
+esegua un file di comandi, prima di invocare @command{gawk}.
+(Questa restrizione potrebbe essere rimossa in una futura versione di
address@hidden per VMS.)
+
+Senza un tale file di comandi, i dati in input saranno presenti anche
+in output, prima dei dati di output veri e propri.
+
address@hidden consente la simulazione di comandi POSIX non disponibili in VMS
+o l'uso di programmi di address@hidden GNV.
+
+L'esempio seguente mostra come ridirigere dati da @command{gawk} verso il
+comando VMS @command{sort}.
+
address@hidden
+$ sort = "@@device:[dir]vms_gawk_sort.com"
address@hidden example
+
+Il file di comandi deve avere il formato dell'esempio seguente.
+
+La prima riga serve a evitare che i dati in input siano presenti anche
+nell'output. Dev'essere nel formato mostrato nell'esempio.
+
+La riga seguente crea un comando esterno che prevale sul comando esterno
+superiore, che serve a prevenire una ricorsione infinita di file di comandi.
+
+Il penultimo comando ridirige @code{sys$input} su @code{sys$command},
+per poter ottenere i dati che sono ridiretti verso il comando.
+
+L'ultima riga esegue il comando vero e proprio. Dev'essere l'ultimo
+comando, perch@'e i dati ridiretti da @command{gawk} saranno letti
+quando il file di comandi finisce di essere eseguito.
+
address@hidden
+$!'f$verify(0,0)'
+$ sort := sort
+$ define/user sys$input sys$command:
+$ sort sys$input: sys$output:
address@hidden example
+
+
address@hidden GNV su VMS
address@hidden Il progetto VMS GNV
+
+Il pacchetto VMS GNV fornisce un ambiente di sviluppo simile
+a POSIX tramite una collezione di strumenti @dfn{open source}.
+Il @command{gawk} presente nel pacchetto base GNV @`e una vecchia versione.
+Attualmente, il progetto GNV @`e in fase di riorganizzazione, con l'obiettivo
+di offrire pacchetti PCSI separati per ogni componente.
+Si veda @address@hidden://sourceforge.net/p/gnv/wiki/InstallingGNVPackages/}.}
+
+La procedura normale per compilare @command{gawk} produce un programma
+adatto a essere usato con GNV.
+
+Il file @file{vms/gawk_build_steps.txt} nella distribuzione documenta
+la procedura per compilare un pacchetto PCSI compatible con GNV.
+
address@hidden
address@hidden The VMS POSIX product, also known as POSIX for OpenVMS, is long
defunct
address@hidden and building gawk for it has not been tested in many years, but
these
address@hidden old instructions might still work if anyone is still using it.
+
address@hidden VMS POSIX
address@hidden Compilare e usare @command{gawk} su VMS POSIX
+
+Le istruzioni appena viste vanno ignorate, sebbene @file{vms/gawk.hlp}
+dovrebbe ancora essere reso disponibile in una libreria di aiuto.
+L'albero del codice sorgente dovrebbe essere scompattato in un sottosistema
+contenitore di file, e non nel normale @dfn{filesystem} VMS.
+Occorre accertarsi che i due script, @file{configure} e
address@hidden/posix-cc.sh}, siano eseguibile; si usi @samp{chmod +x} per farlo,
+se necessario. Poi vanno eseguiti i seguenti due comandi:
+
address@hidden
+psx> @kbd{CC=vms/posix-cc.sh configure}
+psx> @kbd{make CC=c89 gawk}
address@hidden example
+
address@hidden
+Il primo comando costruisce i file @file{config.h} e @file{Makefile},
+a partire da dei modelli, usando uno script per fare
address@hidden@dotless{i}} che il
+compilatore C soddisfi le aspettative di @command{configure}. Il secondo
+comando compila e collega @command{gawk} chiamando direttamente il
+compilatore C; gli eventuali messaggi di @command{make} che dicono di non
+riuscire a ridefinire @code{CC} vanno ignorati. @command{configure}
+impiega molto tempo a completarsi, ma in compenso continua a fornire
+messaggi che permettono di seguirne l'avanzamento.
+
+Questo @`e stato testato con VAX/VMS V6.2, VMS POSIX V2.0, e DEC C V5.2.
+
+Una volta installato, @command{gawk} funziona come ogni altro programma
+di address@hidden della shell. A differenza della normale versione VMS di
address@hidden, neesuna manipolazione speciale della riga di comando @`e
+necessaria nell'ambiente VMS POSIX.
address@hidden ignore
+
address@hidden Vecchio Gawk su VMS
address@hidden Vecchia versione di @command{gawk} su sistemi VMS
+
+
address@hidden Thanks to "gerard labadie" <address@hidden>
+
+Alcune versioni di VMS includono una vecchia versione di @command{gawk}.
+Per utilizzarla, occorre definire un simbolo, come segue:
+
address@hidden
+$ @kbd{gawk :== $sys$common:[syshlp.examples.tcpip.snmp]gawk.exe}
address@hidden example
+
+La versione appare essere la @value{PVERSION} 2.15.6, che @`e molto vecchia.
+Si raccomanda di compilare e usare la versione corrente.
+
address@hidden Bug
address@hidden Segnalazione di problemi e bug
address@hidden archeologi
address@hidden
address@hidden c'@`e niente di address@hidden pericoloso di un archeologo
annoiato.}
address@hidden Douglas Adams, @cite{Guida galattica per autostoppisti}
address@hidden quotation
address@hidden the radio show, not the book. :-)
+
address@hidden debug, @command{gawk}, segnalare bug
address@hidden risoluzione problemi @command{gawk}, segnalare bug
+Se si incontrano problemi con @command{gawk} o se si ritiene di aver trovato un
+bug, si raccomanda di segnalarlo agli sviluppatori;
+non c'@`e un impegno preciso a intervenire, ma c'@`e una buona address@hidden
che ci
+si sforzi di risolverlo.
+
address@hidden
+* Indirizzo Bug:: Dove inviare le segnalazioni.
+* Usenet:: Dove non inviare le segnalazioni.
+* Manutentori:: Manutentori di version non-*nix.
address@hidden menu
+
address@hidden Indirizzo Bug
address@hidden Segnalare Bug
+
+Prima di segnalare un bug, occorre assicurarsi che sia davvero un bug. La
+documentazione va riletta attentamente, per controllare se dice che @`e
possibile
+fare quel che si sta tentando di fare. Se non @`e chiaro se sia possibile
+fare quella particolare cosa o no, occorre segnalarlo; in questo caso si tratta
+di un bug nella documentazione!
+
+Prima di segnalare un bug o di tentare di risolverlo personalmente, si tenti
+di isolarlo preparando un programma @command{awk} il address@hidden piccolo
possibile, con
+un @value{DF} in input che possa riprodurre il problema. Dopo averlo fatto, si
+spedisca il programma e il @value{DF}, insieme a informazioni sul tipo di
+sistema Unix in uso, il compilatore usato per compilare @command{gawk}, e i
+risultati esatti che @command{gawk} ha prodotto. Inoltre andrebbe specificato
+cosa ci si aspettava che il programma facesse; questo @`e di aiuto per decidere
+se il problema @`e un problema di documentazione.
+
address@hidden importante includere il numero di versione di @command{gawk} in
uso.
+Questa informazione si address@hidden ottenere con il comando @samp{gawk
--version}.
+
address@hidden @code{bug-gawk@@gnu.org} indirizzo per la segnalazione dei bug
address@hidden email, indirizzo per segnalare bug, @code{bug-gawk@@gnu.org}
address@hidden indirizzo email per segnalare bug, @code{bug-gawk@@gnu.org}
address@hidden bug, segnalare, indirizzo email, @code{bug-gawk@@gnu.org}
address@hidden segnalare bug, indirizzo email, @code{bug-gawk@@gnu.org}
+Una volta pronta la descrizione precisa del problema, si spedisca un messaggio
+di posta elettronica a @EMAIL{bug-gawk@@gnu.org,bug-gawk at gnu dot org}.
+
+I manutentori di @command{gawk} sono i destinatari, e riceveranno la
+segnalazione di errore. Sebbene sia possibile spedire messaggi direttamente ai
+manutentori, @`e preferibile usare l'indirizzo sopra fornito perch@'e quella
+mailing list rimane in archivio presso il Progetto GNU. @emph{Tutti i messaggi
+devono essere in inglese. @`E questo il solo linguaggio che tutti i manutentori
+conoscono.} Inoltre, occorre accertarsi di spedire tutti i messaggi in formato
address@hidden, e non (o non soltanto) in formato HTML.
+
address@hidden NOTA
+Molte distribuzioni di GNU/Linux e i vari sistemi operativi basati su
+BSD hanno un loro proprio canale per segnalare i bug. Se si segnala un
+bug usando il canale della distribuzione, una copia del messaggio andrebbe
+inviata anche a @EMAIL{bug-gawk@@gnu.org,bug-gawk at gnu dot org}.
+
+Questo per due ragioni. La prima @`e che, sebbene alcune distribuzioni
inoltrino
+i messaggi sui problemi ``verso l'alto'' alla mailing list GNU, molte non lo
+fanno, e quindi c'@`e una buona address@hidden che i manutentori di
@command{gawk}
+non vedano affatto il messaggio relativo al bug! La seconda ragione @`e che la
+posta diretta alla mailing list GNU @`e archiviata, e il poter disporre di ogni
+cosa all'interno del progetto GNU consente di avere a disposizione tutte le
+informazioni rilevanti senza dover dipendere da altre organizzazioni.
address@hidden quotation
+
+Suggerimenti non correlati a bug sono pure sempre benvenuti. Se si hanno
+domande riguardo a qualcosa di non chiaro nella documentazione o a proposito
+di address@hidden oscure, si scriva alla mailing list dei bug; si
address@hidden
+a essere di aiuto nei limiti del possibile.
+
address@hidden Usenet
address@hidden Non segnalare bug a USENET!
+
address@hidden
address@hidden Date: Sun, 17 May 2015 19:50:14 -0400
address@hidden From: Chet Ramey <address@hidden>
address@hidden Reply-To: address@hidden
address@hidden Organization: ITS, Case Western Reserve University
address@hidden To: Aharon Robbins <address@hidden>
address@hidden CC: address@hidden
+Ho iniziato a ignorare Usenet un paio di anni fa, e non me ne sono mai
+pentito. @`E come quando si parla di sport alla radio---ci si sente
address@hidden intelligenti per aver lasciato perdere.
address@hidden Chet Ramey
address@hidden quotation
+
address@hidden @code{comp.lang.awk} gruppo di discussione
address@hidden newsgroup @code{comp.lang.awk}
address@hidden gruppo di discussione @code{comp.lang.awk}
+Siete pregati di @emph{non} provare a notificare bug di @command{gawk}
+scrivendo al gruppo di discussione Usenet/Internet @code{comp.lang.awk}.
+Sebbene alcuni degli sviluppatori di @command{gawk} leggano talora i
+messaggi di questo gruppo di discussione, il manutentore principale di
address@hidden non lo fa address@hidden Quindi @`e praticamente certo che un
+messaggio inviato address@hidden @emph{non} sia da lui letto.
+La procedura qui descritta @`e la sola maniera ufficialmente riconosciuta
+per notificare problemi. Davvero!
+
address@hidden
+And another one:
+
+Date: Thu, 11 Jun 2015 09:00:56 -0400
+From: Chet Ramey <address@hidden>
+
+My memory was imperfect. Back in June 2009, I wrote:
+
+"That's the nice thing about open source, right? You can take your ball
+and run to another section of the playground. Then, if you like mixing
+metaphors, you can throw rocks from there."
address@hidden ignore
+
address@hidden Manutentori
address@hidden Notificare problemi per versioni non-Unix
+
+Se si riscontrano bug in una delle versioni non-Unix di @command{gawk}, una
+copia del messaggio inviato alla mailing list dei bug andrebbe spedita alla
+persona che si occupa di quella versione. I manutentori sono elencati nella
+lista seguente, come pure nel file @file{README} nella distribuzione
address@hidden Le informazioni nel file @file{README} dovrebbero essere
+considerate come le address@hidden aggiornate, se risultano in conflitto con
questo
address@hidden
+
+Le persone che si occupano delle varie versioni di @command{gawk} sono:
+
address@hidden put the index entries outside the table, for docbook
address@hidden Buening, Andreas
address@hidden Deifik, Scott
address@hidden Malmberg, John E.
address@hidden Pitts, Dave
address@hidden G., Daniel Richard
address@hidden Robbins, Arnold
address@hidden Zaretskii, Eli
address@hidden SMALLPRINT
address@hidden {MS-Windows}
{123456789012345678901234567890123456789001234567890}
address@hidden ifset
address@hidden SMALLPRINT
address@hidden {MS-Windows con MinGW}
{123456789012345678901234567890123456789001234567890}
address@hidden ifclear
address@hidden Unix e sistemi POSIX @tab Arnold Robbins,
@EMAIL{arnold@@skeeve.com,arnold at skeeve dot com}
+
address@hidden @item MS-DOS con DJGPP @tab Scott Deifik,
@EMAIL{scottd.mail@@sbcglobal.net,scottd dot mail at sbcglobal dot net}
+
address@hidden MS-Windows con MinGW @tab Eli Zaretskii,
@EMAIL{eliz@@gnu.org,eliz at gnu dot org}
+
address@hidden Leave this in the document on purpose.
address@hidden OS/2 is not mentioned anywhere else though.
address@hidden OS/2 @tab Andreas Buening,
@EMAIL{andreas.buening@@nexgo.de,andreas dot buening at nexgo dot de}
+
address@hidden VMS @tab John Malmberg, @EMAIL{wb8tyw@@qsl.net,wb8tyw at qsl.net}
+
address@hidden z/OS (OS/390) @tab Daniel Richard G.@:
@EMAIL{skunk@@iSKUNK.ORG,skunk at iSKUNK.ORG}
address@hidden @tab Dave Pitts (Maintainer Emeritus),
@EMAIL{dpitts@@cozx.com,dpitts at cozx dot com}
address@hidden multitable
+
+Se il problema riscontrato @`e riproducibile anche sotto Unix,
+si dovrebbe spedire una copia del messaggio anche alla mailing list
address@hidden@@gnu.org,bug-gawk at gnu dot org}.
+
+La versione generata usando gli strumenti DJGPP non @`e address@hidden
supportata;
+il codice relativo address@hidden nella distribuzione ancora per qualche tempo,
+nel caso che qualche volontario desideri prenderla in carico.
+Se questo non dovesse succedere, la parte di codice relativa questa
+versione address@hidden rimossa dalla distribuzione.
+
address@hidden Altre versioni
address@hidden Altre implementazioni di @command{awk} liberamente disponibili
address@hidden @command{awk}, implementazioni di
address@hidden implementazioni di @command{awk}
address@hidden
+From: emory!amc.com!brennan (Michael Brennan)
+Subject: C++ comments in awk programs
+To: address@hidden (Arnold Robbins)
+Date: Wed, 4 Sep 1996 08:11:48 -0700 (PDT)
+
address@hidden ignore
address@hidden Brennan, Michael
address@hidden
address@hidden
address@hidden@`E piuttosto divertente mettere commenti simili nel vostro
codice awk:address@hidden
+@ @ @ @ @ @ @code{// Funzionano i commenti in stile C++? Risposta:
address@hidden@dotless{i}}! certo}
address@hidden Michael Brennan
address@hidden quotation
address@hidden ifnotdocbook
+
address@hidden
+<blockquote><attribution>Michael Brennan</attribution>
+<literallayout><emphasis>
address@hidden piuttosto divertente mettere commenti simili nel vostro codice
awk.
+</emphasis>
+ <literal>
+// Funzionano i commenti in stile C++? Risposta: address@hidden@dotless{i}}!
certo
+</literal></literallayout>
+</blockquote>
address@hidden docbook
+
+Ci sono alcune altre implementazioni di @command{awk} disponibili
+gratuitamente.
+Questa @value{SECTION} descrive in breve dove @`e possibile trovarle:
+
address@hidden @asis
address@hidden Kernighan, Brian
address@hidden sorgente, codice, Brian Kernighan @command{awk}
address@hidden codice sorgente, Brian Kernighan @command{awk}
address@hidden @command{awk}, versioni di, si veda anche Brian Kernighan,
@command{awk} di
address@hidden Brian Kernighan, @command{awk} di, codice sorgente
address@hidden Unix @command{awk}
+Brian Kernighan, uno degli sviluppatori originali di Unix @command{awk},
+ha reso disponibile liberamente la sua implementazione di @command{awk}.
+Si address@hidden scaricare questa versione dalla
address@hidden://www.cs.princeton.edu/~bwk, sua pagina principale}.
address@hidden disponibile in parecchi formati compressi:
+
address@hidden @asis
address@hidden Archivio Shell
address@hidden://www.cs.princeton.edu/~bwk/btl.mirror/awk.shar}
+
address@hidden File @command{tar} compresso
address@hidden://www.cs.princeton.edu/~bwk/btl.mirror/awk.tar.gz}
+
address@hidden File Zip
address@hidden://www.cs.princeton.edu/~bwk/btl.mirror/awk.zip}
address@hidden table
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
address@hidden anche disponbile in GitHub:
+
address@hidden
+git clone git://github.com/onetrueawk/awk bwkawk
address@hidden example
+
address@hidden
+Questo comando crea una copia del deposito @uref{http://git-scm.com, Git}
+in una directory chiamata @file{bwkawk}. Se si omette questo argomento della
+riga di comando @command{git}, la copia del deposito @`e creata nella
+directory di nome @file{awk}.
+
+Questa versione richiede un compilatore ISO C (standard 1990); il compilatore
+C contenuto in GCC (la collezione di compilatori GNU) @`e address@hidden che
sufficiente.
+
address@hidden comuni}
+per una lista di estensioni in questo @command{awk} che non sono in
+POSIX @command{awk}.
+
+Incidentalmente, Dan Bornstein ha creato un deposito Git che contiene tutte le
+versioni di BWK @command{awk} che @`e riuscito a trovare. @`E disponibile in
address@hidden://github.com/danfuzz/one-true-awk}.
+
address@hidden Brennan, Michael
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden codice sorgente, @command{mawk}
address@hidden @command{mawk}
+Michael Brennan ha scritto un'implementazione indipendente di @command{awk},
+di nome @command{mawk}. @`E disponibile sotto la licenza
address@hidden FOR_PRINT
+GPL (@pxref{Copia}),
address@hidden ifclear
address@hidden FOR_PRINT
+GPL,
address@hidden ifset
+proprio come @command{gawk}.
+
+Il sito di distribuzione originale di @command{mawk} non contiene
address@hidden
+il codice sorgente. Una copia @`e disponibile in
address@hidden://www.skeeve.com/gawk/mawk1.3.3.tar.gz}.
+
+Dal 2009 @`e Thomas Dickey a occuparsi della manutenzione di @command{mawk}.
+Le informazioni di base sono disponibili nella
address@hidden://www.invisible-island.net/mawk, pagine web del progetto}.
+Il puntatore URL da cui scaricare @`e
address@hidden://invisible-island.net/datafiles/release/mawk.tar.gz}.
+
+Una volta scaricato,
+per scompattare questo file address@hidden essere usato @command{gunzip}.
+L'installazione @`e simile a quella di @command{gawk}
+(@pxref{Installazione Unix}).
+
address@hidden comuni}
+per una lista di estensioni in @command{mawk} che non sono in POSIX
@command{awk}.
+
address@hidden Sumner, Andrew
address@hidden @command{awka}, compilatore per @command{awk}
address@hidden compilatore per @command{awk}, @command{awka}
address@hidden sorgente, codice, @command{awka}
address@hidden codice sorgente di @command{awka}
address@hidden @command{awka}
+Scritto da Andrew Sumner,
address@hidden traduce i programmi @command{awk} in C, li compila,
+e prepara il codice eseguibile usando una libreria di funzioni che
+implementano le address@hidden di base di @command{awk}.
+Comprende anche un certo numero di estensioni.
+
+Il traduttore di @command{awk} @`e rilasciato sotto la licenza GPL, e la
+relativa libreria sotto la licenza LGPL.
+
+Per ottenere @command{awka}, si visiti
+il sito @url{http://sourceforge.net/projects/awka}.
address@hidden You can reach Andrew Sumner at @email{andrew@@zbcom.net}.
address@hidden andrewsumner@@yahoo.net
+
+Il progetto sembra essere stato congelato; non ci sono state modifiche nel
+codice sorgente dal 2001 circa.
+
address@hidden Beebe, Nelson H.F.@:
address@hidden @command{pawk} (versione con profilatura di Brian Kernighan
@command{awk})
address@hidden codice sorgente, @command{pawk}
address@hidden sorgente, codice, @command{pawk}
address@hidden @command{pawk}
+Nelson H.F.@: Beebe all'address@hidden dello Utah ha modificato
+BWK @command{awk} per fornire informazioni di temporizzazione e profilatura.
+Questo @`e differente dall'usare @command{gawk} con l'opzione
@option{--profile}
+(@pxref{Profilare})
+nel senso che fornisce un profilo basato sul consumo di CPU, non sul
+numero di esecuzioni di una data riga di codice.
+Sia address@hidden trovare sia in
address@hidden://ftp.math.utah.edu/pub/pawk/pawk-20030606.tar.gz}
+che in
address@hidden://www.math.utah.edu/pub/pawk/pawk-20030606.tar.gz}.
+
address@hidden BusyBox @command{awk}
address@hidden BusyBox Awk
address@hidden codice sorgente, BusyBox Awk
address@hidden sorgente, codice, BusyBox Awk
+BusyBox @`e un programma distribuito con licenza GPL che fornisce versioni
+ridotte di parecchie piccole applicazioni, all'interno di un singolo modulo
+eseguibile. @`E stato ideato per sistemi
+integrati.
+Include un'implementazione completa di POSIX @command{awk}. Quando lo si
+compila occorre prestare attenzione a non eseguire @samp{make install},
perch@'e
+in questo modo si andrebbero a sostituire copie di altre applicazioni nella
+directory @file{/usr/local/bin} del sistema corrente. Per ulteriori
+informazioni, si veda @uref{http://busybox.net, la pagina principale del
progetto}.
+
address@hidden OpenSolaris
address@hidden Solaris, versione POSIX @command{awk}
address@hidden codice sorgente, Solaris @command{awk}
address@hidden sorgente, codice, Solaris @command{awk}
address@hidden POSIX @command{awk} per OpenSolaris
+Le versioni di @command{awk} in @file{/usr/xpg4/bin} e @file{/usr/xpg6/bin} su
+Solaris sono @dfn{grosso modo} conformi allo standard POSIX. Sono basate sul
+comando @command{awk} preparato per i PC dalla ditta Mortice Kern. @`E stato
+possibile compilare e far funzionare questo codice sotto GNU/Linux dopo 1--2
+ore di lavoro. Rendere questo codice address@hidden generalmente portabile
(usando gli
+strumenti GNU Autoconf e/o Automake) richiederebbe ulteriore lavoro, che non
@`e
+stato fin qui compiuto, almeno per quel che risulta a chi scrive.
+
address@hidden Illumos
address@hidden Illumos, @command{awk} conforme a POSIX e
address@hidden codice sorgente, Illumos @command{awk}
address@hidden sorgente, codice, Illumos @command{awk}
+Il codice sorgente era un tempo disponibile dal sito web OpenSolaris.
+Tuttavia, il progetto @`e terminato, e il sito web chiuso. Fortunatamente,
+il progetto
address@hidden://wiki.illumos.org/display/illumos/illumos+Home, Illumos}
+mette a disposizione questa implementazione. Si possono vedere i singoli file
in
address@hidden://github.com/joyent/illumos-joyent/blob/master/usr/src/cmd/awk_xpg4}.
+
address@hidden @command{jawk}
address@hidden Java, implementazione di @command{awk}
address@hidden implementazione Java di @command{awk}
address@hidden codice sorgente, @command{jawk}
address@hidden sorgente, codice, @command{jawk}
address@hidden @command{jawk}
+Questo @`e un interprete per @command{awk} scritto in Java. Dichiara di
+essere un interprete completo, anche se, poich@'e usa address@hidden di Java
+per l'I/O e per la ricerca di @dfn{regexp}, il linguaggio che supporta
address@hidden differente da @command{awk} POSIX.
+Ulteriori informazioni sono disponibili sulla
address@hidden://jawk.sourceforge.net, pagina principale del progetto}.
+
address@hidden Libmawk
address@hidden @command{libmawk}
address@hidden codice sorgente, @command{libmawk}
address@hidden sorgente, codice, @command{libmawk}
+Questo @`e un interprete @command{awk} incorporabile, derivato da
address@hidden Per ulteriori informazioni, si veda
address@hidden://repo.hu/projects/libmawk/}.
+
address@hidden @code{pawk}
address@hidden codice sorgente, @command{pawk} (versione Python)
address@hidden sorgente, codice, @command{pawk} (versione Python)
address@hidden @code{pawk}, implementazione simile ad @command{awk} per Python
+Questo @`e un modulo Python che intende introdurre address@hidden di tipo
address@hidden in Python. Si veda @uref{https://github.com/alecthomas/pawk} per
+ulteriori informazioni. (Questo programma non @`e correlato con la versione
+modificata da Nelson Beebe di BWK @command{awk}, descritta prima.)
+
address@hidden @w{QSE @command{awk}}
address@hidden QSE @command{awk}
address@hidden codice sorgente, QSE @command{awk}
address@hidden sorgente, codice, QSE @command{awk}
+Questo @`e un interprete di @command{awk} incorporabile. Per ulteriori
+informazioni, si veda
address@hidden://code.google.com/p/qse/} e @uref{http://awk.info/?tools/qse}.
+
address@hidden @command{QTawk}
address@hidden QuikTrim Awk
address@hidden codice sorgente, QuikTrim Awk
address@hidden sorgente, codice, QuikTrim Awk
+Questa @`e un'implementazione indipendente di @command{awk} distribuita con la
+licenza GPL. Ha un gran numero di estensioni rispetto ad @command{awk}
+standard, e address@hidden non essere sintatticamente compatibile al 100% con
esso. Si
+veda @uref{http://www.quiktrim.org/QTawk.html} per ulteriori informazioni,
+compreso il manuale. Il puntatore per scaricare QuikTrim non punta all'ultima
+versione: si veda @uref{http://www.quiktrim.org/#AdditionalResources} per un
+puntatore alla versione corrente.
+
+Il progetto sembra essere fermo; non ci sono nuove versioni del codice
+a partire dal 2014 circa.
+
address@hidden Altre versioni
+Si veda anche [in inglese] la sezione ``Versions and implementations''
+della voce di
address@hidden://en.wikipedia.org/wiki/Awk_language#Versions_and_implementations,
+Wikipedia} su @command{awk} per informazioni su ulteriori versioni.
+
address@hidden table
+
address@hidden Sommario dell'installazione
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+La distribuzione di @command{gawk} @`e disponibile dal sito principale
+di distribuzione del Progetto GNU
address@hidden La maniera canonica per scaricarlo e installarlo @`e:
+
address@hidden
+wget http://ftp.gnu.org/gnu/gawk/address@hidden@value{PATCHLEVEL}.tar.gz
+tar -xvpzf address@hidden@value{PATCHLEVEL}.tar.gz
+cd address@hidden@value{PATCHLEVEL}
+./configure && make && make check
address@hidden example
+
address@hidden
address@hidden address@hidden essere installato anche su sistemi non-POSIX. I
sistemi
+correntemente supportati sono MS-Windows, usando
+MSYS, MinGW, e Cygwin,
+e sia Vax/VMS che OpenVMS. Le istruzioni per ognuno di questi sistemi sono
+incluse in questa @value{APPENDIX}.
+
address@hidden
+Le segnalazioni di errori (bug) dovrebbero essere spedite tramite email a
address@hidden@@gnu.org}. Le segnalazioni di errore dovrebbero essere scritte
+in inglese e dovrebbero specificare la versione di @command{gawk} in uso, come
address@hidden stata compilata, un breve programma e un @value{DF} che
permettono di
+riprodurre il problema.
+
address@hidden
+Ci sono alcune altre implementazioni di @command{awk} disponibili
+gratuitamente. Molte rispettano lo standard POSIX; altre un po' meno.
+
address@hidden itemize
+
+
address@hidden FOR_PRINT
address@hidden Note
address@hidden Note di implementazione
address@hidden @command{gawk}, problemi di implementazione
address@hidden problemi di implementazione, @command{gawk}
+
+Quest'appendice contiene informazioni che interessano soprattutto le persone
+che aggiornano e mantengono @command{gawk}. L'intero contenuto si applica
+specificatamente a @command{gawk} e non ad altre implementazioni.
+
address@hidden
+* address@hidden di address@hidden:: Come inibire alcune estensioni di
+ @command{gawk}.
+* Aggiunte:: Fare aggiunte a @command{gawk}.
+* Future estensioni:: Nuove address@hidden che potranno
+ essere implementate in futuro.
+* Limitazioni dell'implementazione:: Alcune limitazioni
+ dell'implementazione.
+* Progetto delle estensioni:: Note di progetto sull'estensione API.
+* Meccanismo delle vecchie estensioni:: Alcune address@hidden per le vecchie
+ estensioni.
+* Sommario delle note:: Sommario delle note di
+ implementazione.
address@hidden menu
+
address@hidden address@hidden di address@hidden
address@hidden address@hidden all'indietro e debug
address@hidden @command{gawk}, problemi di implementazione, address@hidden
all'indietro
address@hidden @command{gawk}, problemi di implementazione, debug
address@hidden risoluzione di problemi, @command{gawk}
address@hidden problemi, risoluzione di, @command{gawk}
address@hidden problemi di address@hidden @command{gawk}, debug
+
address@hidden/GNU},
+per un compendio delle estensioni GNU per il linguaggio e il programma
address@hidden Tutte queste address@hidden possono essere inibite invocando
address@hidden con l'opzione @option{--traditional} o con l'opzione
address@hidden
+
+Se @command{gawk} @`e stato compilato per il debug con @samp{-DDEBUG}, @`e
+possibile specificare un'ulteriore opzione sulla riga di comando:
+
address@hidden @code
address@hidden -Y
address@hidden --parsedebug
+Stampa l'informazione contenuta nella pila di analisi, durante la fase di
+analisi iniziale del programma.
address@hidden table
+
+Quest'opzione @`e utile solo a chi sviluppa @command{gawk} e non all'utente
+occasionale. @`E probabile che non sia neppure disponibile nella versione di
address@hidden che si sta usando, perch@'e rallenta l'esecuzione del programma.
+
address@hidden Aggiunte
address@hidden Fare aggiunte a @command{gawk}
+
+Se si desidera migliorare @command{gawk} in maniera significativa, c'@`e la
+massima address@hidden di farlo. @`E questo lo scopo del software libero; il
codice
+sorgente @`e disponibile, ed @`e possibile modificarlo a piacere
+(@pxref{Copia}).
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta di come @`e possibile modificare @command{gawk},
+ed espone alcune considerazioni che si dovrebbero tenere presenti.
+
address@hidden
+* Accedere ai sorgenti:: Accedere al deposito dei sorgenti Git.
+* Aggiungere codice:: Aggiungere codice al programma
+ principale @command{gawk}.
+* Nuovi sistemi:: Portare @command{gawk} su un nuovo sistema
+ operativo.
+* File derivati:: Perch@'e i file derivati sono tenuti
+ nel deposito @command{git}.
address@hidden menu
+
address@hidden Accedere ai sorgenti
address@hidden Accedere al deposito dei sorgenti Git di @command{gawk}
+
+Poich@'e @command{gawk} @`e Software Libero, il codice sorgente @`e sempre
+disponibile.
address@hidden
+La
address@hidden iftex
address@hidden di Gawk} descrive come scaricare e installare
+le versioni ufficiali rilasciate di @command{gawk}.
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
+Peraltro, se si intende modificare @command{gawk} e mettere a disposizione le
+modifiche, @`e preferibile lavorare sulla versione in via di sviluppo. Per far
address@hidden @`e necessario accedere al deposito del codice sorgente di
@command{gawk}.
+Il codice @`e mantenuto usando il @uref{http://git-scm.com, sistema distribuito
+di controllo delle versioni Git}. address@hidden necessario installarlo se
non @`e address@hidden
+presente nel sistema. Quando @command{git} @`e disponibile, va usato il
comando:
+
address@hidden
+git clone git://git.savannah.gnu.org/gawk.git
address@hidden example
+
address@hidden
+Questo comando scarica in locale una copia esatta del deposito dei
+sorgenti di @command{gawk}. Se si sta usando un @dfn{firewall}
+che non consente l'uso del protocollo nativo di Git, @`e possibile accedere
+ugualmente al deposito usando il comando:
+
address@hidden
+git clone http://git.savannah.gnu.org/r/gawk.git
address@hidden example
+
+Una volta modificato il sorgente, @`e posibile usare @samp{git diff} per
+produrre una @dfn{patch}, e spedirla al manutentore di @command{gawk}; si veda
address@hidden, per come farlo.
+
+In passato era disponibile un'interfaccia Git--CVS
+utilizzabile da persone che non avevano a disposizione Git. Purtroppo,
+quest'interfaccia non funziona address@hidden, ma si potrebbe avere maggior
fortuna usando
+un sistema di controllo versioni address@hidden moderno, come Bazaar, che @`e
dotato di
+un'estensione Git per lavorare con depositi di sorgenti Git.
+
address@hidden Aggiungere codice
address@hidden Aggiungere nuove address@hidden
+
address@hidden @command{gawk}, aggiungere address@hidden a
address@hidden address@hidden, aggiungere a @command{gawk}
address@hidden aggiungere address@hidden a @command{gawk}
+Ognuno @`e libero di aggiungere tutte le nuove address@hidden che vuole a
address@hidden Comunque, se si desidera che tali modifiche siano incorporate
+nella distribuzione di @command{gawk}, ci sono parecchi passi da fare per
+rendere possibile la loro inclusione:
+
address@hidden 1
address@hidden
+Prima di inserire la nuova address@hidden all'interno di @command{gawk},
+prendere in considerazione la address@hidden di scriverla sotto forma di
+estensione (@pxref{Estensioni dinamiche}).
+Se address@hidden non @`e possibile, continuare con i passi rimanenti
descritti in questa
+lista.
+
address@hidden
+Essere disposti a firmare un documento liberatorio appropriato.
+Se l'FSF deve poter distribuire le modifiche, queste vanno dichiarate
+di pubblico dominio, tramite la firma di un documento apposito, oppure
+attribuendo il copyright delle modifiche all'FSF.
+Entrambe queste azioni sono semplici da fare, e @emph{molte} persone
address@hidden
+l'hanno fatto. Se ci sono domande da fare, mettersi in contatto con me
+(@pxref{Bug}),
+oppure @EMAIL{assign@@gnu.org,assign chiocciola gnu punto org}.
+
address@hidden
+Utilizzare l'ultima versione.
address@hidden molto address@hidden semplice per me integrare modifiche se sono
basate sull'ultima
+versione disponibile di @command{gawk} o, meglio ancora, sull'ultimo codice
+sorgente presente nel deposito Git. Se la versione di @command{gawk} @`e molto
+vecchia, potrei non essere affatto in grado di integrare le modifiche.
+(@xref{Scaricare},
+per informazioni su come ottenere l'ultima versione di @command{gawk}.)
+
address@hidden
address@hidden
+Seguire gli @cite{Standard di codifica GNU}.
address@hidden ifnotinfo
address@hidden
+Si veda @inforef{Top, , Version, standards, Standard di Codifica GNU}.
address@hidden ifinfo
+Questo documento descrive come dovrebbe essere scritto il software GNU.
+Se non lo si @`e letto, @`e bene farlo, preferibilmente @emph{prima}
+di iniziare a modificare @command{gawk}.
+(Gli @cite{Standard di codifica GNU} sono disponibili nel sito web del
address@hidden://www.gnu.org/prep/standards/, Progetto GNU}.
+Sono disponibili anche versioni in formato Texinfo, Info, e DVI.)
+
address@hidden @command{gawk}, stile di codifica in
address@hidden
+Usare lo stile di codifica @command{gawk}.
+Il codice sorgente in C di @command{gawk} segue le istruzioni dello
address@hidden di codifica GNU}, con qualche piccola eccezione. Il codice @`e
+formattato usando lo stile tradizionale ``K&R'', in particolare per
address@hidden che
+riguarda il posizionamento delle parentesi graffe e l'uso del carattere TAB.
+In breve, le regole di codifica per @command{gawk}
+sono le seguenti:
+
address@hidden @value{BULLET}
address@hidden
+Usare intestazioni di funzione (prototipi) in stile ANSI/ISO quando
+si definiscono delle funzioni.
+
address@hidden
+Mettere il nome della funzione all'inizio della riga in cui la si sta
definendo.
+
address@hidden
+Usare @samp{#elif} invece di nidificare istruzioni @samp{#if} all'interno
+di un'istruzione @samp{#else}.
+
address@hidden
+Mettere il tipo di codice di ritorno della funzione, anche se @`e @code{int},
+sulla riga immediatamente sopra quella che contiene il nome e gli argomenti
+della funzione.
+
address@hidden
+Mettere degli spazi attorno alle parentesi usate nelle strutture di controllo
+(@code{if}, @code{while}, @code{for}, @code{do}, @code{switch}
+e @code{return}).
+
address@hidden
+Non mettere spazi davanti alle parentesi usate nelle chiamate di funzione.
+
address@hidden
+Mettere spazi attorno a tutti gli operatori C e dopo le virgole,
+nelle chiamate di funzione.
+
address@hidden
+Non usare l'operatore @dfn{virgola} per produrre degli effetti collaterali
+multipli, tranne che nelle parti di inizializzazione e incremento dei cicli
address@hidden, e nel corpo delle macro.
+
address@hidden
+Usare dei caratteri TAB per l'indentazione, e non dei semplici spazi.
+
address@hidden
+Usare lo stile ``K&R'' per formattare le parti di programma incluse fra
+parentesi graffe.
+
address@hidden
+Usare confronti con @code{NULL} e @code{'\0'} per le condizioni
+contenute nelle istruzioni @code{if}, @code{while} e @code{for}, e anche
+nelle varie clausole @code{case} delle istruzioni @code{switch}, invece
+del semplice puntatore o il semplice valore del carattere.
+
address@hidden
+Usare i valori @code{true} e @code{false} per le variabili @code{booleane},
+la costante simbolica @code{NULL} per i valori dei puntatori,
+e la costante carattere @code{'\0'} quando @`e il caso, invece dei valori
@code{1}
+e @code{0}.
+
address@hidden
+Fornire un commento descrittivo di una riga per ogni funzione.
+
address@hidden
+Non usare la funzione @code{alloca()} per allocare memoria dalla @dfn{stack}.
+Il farlo genera dei problemi di address@hidden che non giustificano il
vantaggio
+secondario di non doversi preoccupare di liberare la memoria. Usare invece
address@hidden()} e @code{free()}.
+
address@hidden
+Non usare confronti nella forma @samp{! strcmp(a, b)} o simili.
+Come disse una volta Henry Spencer, address@hidden()} non @`e una funzione
+booleana!'' Usare invece @samp{strcmp(a, b) == 0}.
+
address@hidden
+Per aggiungere nuovi valori a @dfn{flag} binari, usare costanti esadecimali
+esplicite (@code{0x001}, @code{0x002}, @code{0x004}, etc.) invece che
+spostare di un bit a sinistra in incrementi successivi
+(@samp{(1<<0)}, @samp{(1<<1)}, etc.).
address@hidden itemize
+
address@hidden NOTA
+Qualora fossi costretto a riformattare completamente il codice per
+farlo aderire allo stile di codifica usato in @command{gawk}, potrei anche
+decidere di ignorare del tutto le modifiche proposte.
address@hidden quotation
+
address@hidden Texinfo
address@hidden
+Aggiornare la documentazione.
+Insieme col nuovo codice, fornire nuove sezioni e/o capitoli per questo
address@hidden Per quanto possibile, usare il formato Texinfo, invece
+di fornire soltanto del testo ASCII non formattato (sebbene un semplice testo
+sia address@hidden meglio che nessuna documentazione). Le convenzioni da
seguire in
address@hidden@value{TITLE}} sono elencate dopo la parole chiave @samp{@@bye}
alla fine
+del file sorgente Texinfo. Se possibile, aggiornare anche la pagina di manuale
+in formato @command{man}.
+
+Si address@hidden anche firmare un documento liberatorio relativo alle
+modifiche apportate alla documentazione.
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
address@hidden
+Inviare le modifiche come file di differenze nel formato contestuale unificato.
+Usare @samp{diff -u -r -N} per confrontare i sorgenti originali dell'albero
+di sorgenti @command{gawk} con la versione proposta.
+Si raccomanda di usare la versione GNU di @command{diff} o, ancora meglio,
address@hidden diff} o @samp{git format-patch}.
+Per inviare le modifiche proposte spedire l'output prodotto da @command{diff}.
+(@xref{Bug}, per l'indirizzo di posta elettronica.)
+
+L'uso di questo formato rende semplice per me l'applicazione delle modifiche
+alla versione principale del sorgente di @command{gawk} (usando il programma di
address@hidden @code{patch}). Se invece tocca a me applicare le modifiche a
mano,
+con un editor di testo, potrei decidere di non farlo, specialmente
+se le modifiche sono molte.
+
address@hidden
+Includere una descrizione da aggiungere al file @file{ChangeLog} riguardo alla
+modifica da voi proposta. Questo serve a minimizzare l'address@hidden a me
+richiesta, rendendo address@hidden facile per me l'accettazione delle
modifiche, che
+diventa address@hidden semplice se si include anche questa parte nel file di
differenze
+(nel formato @dfn{diff}).
address@hidden enumerate
+
+Sebbene questa possa sembrare una richiesta molto esigente, si tenga presente
+che, anche se il nuovo codice non @`e opera mia, tocca poi a me manutenerlo e
+correggere eventuali errori. Se non @`e possibile per me farlo senza perderci
+troppo tempo, potrei anche lasciar perdere la modifica.
+
address@hidden Nuovi sistemi
address@hidden Portare @command{gawk} su un nuovo Sistema Operativo
address@hidden address@hidden, @command{gawk}
address@hidden sistemi operativi, portare @command{gawk} su altri
+
address@hidden portare @command{gawk}
+Se si vuol portare @command{gawk} su di un nuovo sistema operativo, sono
+necessari parecchi passi:
+
address@hidden 1
address@hidden
+Seguire le linee-guida contenute
address@hidden
+in @ref{Aggiungere codice},
address@hidden ifinfo
address@hidden
+nella precedente @value{SECTION}
address@hidden ifnotinfo
+relative allo stile di codifica, all'invio delle differenze proposte, etc.
+
address@hidden
+Essere disposti a firmare un documento liberatorio appropriato.
+Se l'FSF deve poter distribuire le modifiche, queste vanno dichiarate
+di pubblico dominio, tramite la firma di un documento apposito, oppure
+attribuendo il copyright delle modifiche all'FSF.
+Entrambe queste azioni sono semplici da fare, e @emph{molte} persone
address@hidden
+l'hanno fatto. Se ci sono domande da fare, scrivere a me
+oppure all'indirizzo @email{gnu@@gnu.org}.
+
address@hidden
+Nel realizzare un @dfn{port}, tener presente che il codice
+deve coesistere pacificamente con il resto di @command{gawk} e con le
+versioni per altri sistemi operativi.
+Evitare modifiche non necessarie alla parte di codice che @`e indipendente
+dal sistema operativo. Se possibile, evitare di disseminare @samp{#ifdef},
+utili solo per il proprio @dfn{port}, all'interno del codice sorgente.
+
+Se le modifiche necessarie per un particolare sistema coinvolgono una parte
+troppo rilevante del codice, @`e probabile che io non le accetti.
+In questo caso si possono, naturalmente, distribuire le modifiche per
+proprio conto, basta che si rispettino i vincoli della GPL
+(@pxref{Copia}).
+
address@hidden
+Un certo numero di file che fanno parte della distribuzione di @command{gawk}
+sono mantenuti da terze persone e non dagli sviluppatori di @command{gawk}.
+Quindi, non si dovrebbero cambiare, se non per ragioni molto
+valide; vale a dire, modifiche a questi file non sono impossibili, ma
+le modifiche a questi file saranno controllate con estrema attenzione.
+I file sono
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden
+Un certo numero di altri file sono prodotti dagli Autotool [comandi di
+configurazione] di GNU (Autoconf, Automake, e GNU @command{gettext}).
+Neppure questi file dovrebbero essere modificati, se non per ragioni molto
+valide. I file sono
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden
+Essere disponibili a continuare a manutenere il @dfn{port}.
+I sistemi operativi non-Unix sono supportati da volontari che tengono
+aggiornato il codice necessario per compilare ed eseguire @command{gawk}
+nei loro sistemi. Se nessuno @`e disponibile a tener aggiornato un @dfn{port},
+questo diventa non address@hidden supportato, e address@hidden essere
necessario rimuoverlo dalla
+distribuzione.
+
address@hidden
+Fornire un appropriato file @file{gawkmisc.???}.
+Ogni @dfn{port} ha il proprio @file{gawkmisc.???} che implementa alcune
+funzioni specifiche per quel sistema operativo. Questa @`e una soluzione
address@hidden
+pulita, rispetto a una address@hidden di @samp{#ifdef} sparsi nel codice. Il
file
address@hidden nella directory principale dei sorgenti include gli
+appropriati file @file{gawkmisc.???} da ogni sottodirectory. Anche
+quest'ultimo file va aggiornato.
+
+Ogni file @file{gawkmisc.???} del @dfn{port} ha un suffisso esplicativo
+del tipo di macchina o del sistema operativo in questione---per esempio,
address@hidden/gawkmisc.pc} e @file{vms/gawkmisc.vms}. L'uso di suffissi
distinti
+invece di un semplice @file{gawkmisc.c}, rende possibile spostare file da
+una sottodirectory propria del @dfn{port} nella sottodirectory principale,
+senza cancellare incidentalmente il file @file{gawkmisc.c} vero e proprio.
+(Al momento, questo rappresenta un problema solo per i @dfn{port} ai
+sistemi operativi dei PC.)
+
address@hidden
+Fornire un @file{Makefile} e ogni altro file sorgente o di intestazione in C
+che sia necessario per il proprio sistema operativo. Tutto il codice dovrebbe
+stare in una sottodirectory a parte, il cui nome sia lo stesso, o
+sia indicativo, del proprio sistema operativo o del tipo di computer.
+Se possibile, tentare di strutturare il codice in modo che non sia necessario
+spostare file dalla propria sottodirectory nella directory principale del
+codice sorgente. Se address@hidden non @`e possibile, evitare nel modo
address@hidden assoluto di
+usare nomi per i file che siano duplicati di nomi di file presenti nella
+directory principale del codice sorgente.
+
address@hidden
+Aggiornare la documentazione.
+Scrivere una sezione (o address@hidden sezioni) per questo @value{DOCUMENT}
+che descriva i passi di installazione e compilazione necessari per compilare
+e/o installare @command{gawk} per il sistema desiderato.
address@hidden enumerate
+
+Seguire queste indicazioni facilita molto l'integrazione delle
+modifiche in @command{gawk} e la loro felice coesistenza con il codice di
+altri sistemi operativi address@hidden presenti.
+
+Nel codice che viene fornito e tenuto aggiornato, si possono
+tranquillamente usare uno stile di codifica e una disposizione delle
+parentesi graffe di proprio gradimento.
+
address@hidden File derivati
address@hidden Perch@'e i file generati sono tenuti in Git
+
address@hidden Git, uso per il codice sorgente di @command{gawk}
address@hidden From emails written March 22, 2012, to the gawk developers list.
+
+Se si esaminano i sorgenti di @command{gawk} nel deposito Git
+si address@hidden che sono inclusi file generati automaticamente dagli
strumenti
+dell'infrastruttura GNU, come @file{Makefile.in} generato da Automake e
+anche @file{configure} proveniente da Autoconf.
+
+Questo comportamento @`e differente da quello di molti progetti di
+Libero Software che non memorizzano i file derivati, per mantenere
address@hidden
+sgombro il deposito Git, rendendo address@hidden@dotless{i}} address@hidden
facile comprendere quali sono le
+modifiche sostanziali confrontando differenti versioni, nel tentativo di
+capire cosa @`e cambiato tra una modifica e la precedente.
+
+Tuttavia, ci sono parecchie ragioni per le quali il manutentore di
address@hidden preferisce mantenere ogni cosa nel deposito Git.
+
+Innanzitutto, perch@'e in questo modo @`e facile generare completamente ogni
+data versione, senza doversi preoccupare di avere a disposizione altri
+strumenti (address@hidden vecchi, probabilmente obsoleti, e in qualche caso
+perfino impossibili da trovare).
+
+Come esempio estremo, se solo si pensa di tentare di compilare, diciamo, la
+versione Unix V7 di @command{awk}, ci si accorge che non solo @`e necessario
+scaricare e ricompilare la versione V7 del comando @command{yacc} per farlo, ma
+anche che serve la versione V7 del comando @command{lex}. E quest'ultima @`e
+praticamente impossibile farla funzionare in un sistema GNU/Linux dei giorni
address@hidden abbiamo provato. @`E stata un'esperienza dolorosa.}
+
+(Oppure, diciamo che la versione 1.2 di @command{gawk} richiede il comando
address@hidden come funzionava nel 1989, e non @`e presente il file
address@hidden [generato tramite @command{bison}] nel deposito Git. Che cosa
+ci garantisce di riuscire a trovare quella versione di @command{bison}? O che
address@hidden riesca a generarlo?)
+
+Se il deposito Git comprende tutti i file derivati,
address@hidden facile, dopo averli scaricati, ricostruire il programma.
(Oppure @`e @address@hidden
+facile}, a seconda di quanto si vuole risalire indietro nel tempo).
+
+E qui arriviamo alla seconda (e address@hidden valida) ragione per cui tutti i
file
+devono essere proprio nel deposito Git. Domandiamoci a chi ci si rivolge:
+agli sviluppatori di @command{gawk}, oppure a un utilizzatore che intende
+solo scaricare una data versione e provarla?
+
+Il manutentore di @command{gawk} desidera che per tutti gli utenti
address@hidden interessati sia possibile limitarsi a clonare il deposito sul
+proprio computer, selezionare la variante che lo interessa e costruirla. Senza
+doversi preoccupare di avere a disposizione le versioni corrette degli Autotool
address@hidden un programma GNU che (secondo noi) @`e estremamente difficile
+da estrarre dal deposito Git e compilare. Per esempio, in un vecchio (ma
+ancora funzionante) PowerPC Macintosh, con il sistema operativo Mac Os X 10.5,
address@hidden stato necessario scaricare e compilare una tonnellata di
software,
+incominciando dallo stesso programma Git, per riuscire a lavorare con l'ultima
+versione del codice. Non @`e un'esperienza piacevole e, specie sui vecchi
+sistemi, @`e una notevole perdita di tempo.
+
+Neppure partire dall'ultimo archivio @command{tar} compresso @`e stata una
+passeggiata: i manutentori avevano eliminato i file compressi in formato
address@hidden e @file{.bz2} sostituendoli con file di tipo @file{.tar.xz}.
+Bisognava quindi per prima cosa scaricare e compilare @command{xz}}.
+A questo serve il file @file{bootstrap.sh}. Va a "toccare"
+[tramite il comando @command{touch}] vari altri file nell'ordine richiesto
+in modo che
+
address@hidden
+# La formula canonica per compilare il software GNU:
+./bootstrap.sh && ./configure && make
address@hidden example
+
address@hidden
+tutto @emph{funzioni senza problemi}.
+
+Questo @`e estremamente importante per i rami
address@hidden e @address@hidden@var{Y}-stable}.
+
+Inoltre, il manutentore di @command{gawk} potrebbe sostenere che
address@hidden @`e importante anche per gli sviluppatori di @command{gawk}.
Tentando di
+scaricare il ramo @address@hidden ramo (non address@hidden presente) creato da
+uno degli altri sviluppatori, e che non includeva i file generati.} per
+compilarlo, non ci address@hidden@dotless{i}}. (Mancava il file
@file{ltmain.sh}, ed egli non
+aveva idea di come crearlo, e c'erano anche ulteriori problemi.)
+
+La cosa lo address@hidden in uno stato di frustrazione @emph{estrema}.
Riguardo a quel
+ramo, il manutentore @`e in una posizione non differente da quella di un utente
+generico che voglia tentare di compilare @code{gawk-4.1-stable} o @code{master}
+dal deposito Git.
+
+Quindi, il manutentore ritiene che sia non solo importante, ma cruciale, che
+per ogni dato ramo la formula canonica evocata prima
address@hidden senza problemi}.
+
address@hidden Added 9/2014:
+Una terza ragione per avere tutti i file @`e che senza di essi, usare @samp{git
+bisect} per tentare di trovare quale modifica ha introdotto un errore diventa
+estremamente difficile. Il manutentore ha tentato di farlo su un altro
+progetto che richiede di eseguire @dfn{script} di inizializzazione allo scopo
+di creare lo @dfn{script} @command{configure} e address@hidden@dotless{i}}
via; @`e stata un'esperienza
+veramente dolorosa. Se invece il deposito Git contiene tutto il necessario,
+usare @command{git bisect} al suo interno @`e molto facile.
+
address@hidden So - that's my reasoning and philosophy.
+
+Quali sono, quindi, alcune delle conseguenze e/o delle cose da fare?
+
address@hidden 1
address@hidden
+Non importa se ci sono file differenti nei diversi rami
+prodotti da versioni differenti degli Autotool.
+
address@hidden A
address@hidden
+Spetta al manutentore integrarli tra loro, e se ne address@hidden lui.
+
address@hidden
address@hidden facile per lui eseguire @samp{git diff x y > /tmp/diff1 ; gvim
/tmp/diff1}
+per rimuovere le differenze che non sono rilevanti ai fini della revisione
+del codice sorgente.
address@hidden enumerate
+
address@hidden
+Sarebbe sicuramente d'aiuto se tutti usassero le stesse versioni degli Autotool
+GNU che lui usa, che in generale sono le ultime versioni rilasciate di
+Automake,
+Autoconf,
address@hidden
+e
+GNU @command{gettext}.
+
address@hidden
+If it would help if I sent out an ``I just upgraded to version x.y
+of tool Z'' kind of message to this list, I can do that. Up until
+now it hasn't been a real issue since I'm the only one who's been
+dorking with the configuration machinery.
address@hidden ignore
+
address@hidden @enumerate A
address@hidden @item
+Installare a partire dal sorgente @`e abbastanza facile. @`E il modo con cui
il
+manutentore ha lavorato per anni (e ancora lavora).
+Egli aveva @file{/usr/local/bin} all'inizio del suo @env{PATH} e dava i
+seguenti comandi:
+
address@hidden
+wget http://ftp.gnu.org/gnu/@var{package}/@address@hidden@address@hidden
+tar -xpzvf @address@hidden@address@hidden
+cd @address@hidden@address@hidden
+./configure && make && make check
+make install # come utente root
address@hidden example
+
address@hidden @item
address@hidden
+These days the maintainer uses Ubuntu 12.04 which is medium current, but
+he is already doing the above for Automake, Autoconf, and @command{bison}.
address@hidden ignore
+
address@hidden
+(C. Rant: Recent Linux versions with GNOME 3 really suck. What
+ are all those people thinking? Fedora 15 was such a bust it drove
+ me to Ubuntu, but Ubuntu 11.04 and 11.10 are totally unusable from
+ a UI perspective. Bleah.)
address@hidden ignore
address@hidden @end enumerate
+
address@hidden
address@hidden
+If someone still feels really strongly about all this, then perhaps they
+can have two branches, one for their development with just the clean
+changes, and one that is buildable (xgawk and xgawk-buildable, maybe).
+Or, as I suggested in another mail, make commits in pairs, the first with
+the "real" changes and the second with "everything else needed for
+ building".
address@hidden ignore
address@hidden enumerate
+
+La maggior parte del testo precedente fa parte di messaggi scritti
+originalmente dal manutentore agli altri sviluppatori @command{gawk}.
+Da uno degli sviluppatori @`e stata avanzata l'obiezione
address@hidden che chi scarica il sorgente da Git
+non @`e un utente finale''.
+
+Tuttavia, questo non @`e esatto. Ci sono ``utenti avanzati di @command{awk}''
+che possono installare @command{gawk} (usando la formula canonica vista sopra)
+ma che non conoscono il linguaggio C. Quindi, i rami address@hidden rilevanti
+dovrebbero essere sempre compilabili.
+
address@hidden stato proposto poi di lanciare ogni notte uno @dfn{script}
tramite il
+programma di address@hidden @command{cron} per creare archivi in formato
@command{tar}
+contenenti tutto ``il codice sorgente.'' Il problema in questo caso @`e che
+ci sono differenti alberi di sorgenti, che corrispondono ai vari rami!
+Quindi gli archivi notturni in questione non sono una risposta valida, anche
+per il fatto che il deposito Git address@hidden rimanere senza alcuna modifica
+significativa per settimane intere.
+
+Fortunatamente, il server Git address@hidden rispondere a questa esigenza.
Per ogni
+dato ramo chiamato @var{nome-ramo}, basta usare:
+
address@hidden
+wget http://git.savannah.gnu.org/cgit/gawk.git/snapshot/address@hidden
address@hidden example
+
address@hidden
+per ottenere una copia utilizzabile del ramo in questione.
+
address@hidden Future estensioni
address@hidden Probabili estensioni future
address@hidden
+From emory!scalpel.netlabs.com!lwall Tue Oct 31 12:43:17 1995
+Return-Path: <emory!scalpel.netlabs.com!lwall>
+Message-Id: <address@hidden>
+To: address@hidden (Arnold D. Robbins)
+Subject: Re: May I quote you?
+In-Reply-To: Your message of "Tue, 31 Oct 95 09:11:00 EST."
+ <address@hidden>
+Date: Tue, 31 Oct 95 09:32:46 -0800
+From: Larry Wall <emory!scalpel.netlabs.com!lwall>
+
+: Greetings. I am working on the release of gawk 3.0. Part of it will be a
+: thoroughly updated manual. One of the sections deals with planned future
+: extensions and enhancements. I have the following at the beginning
+: of it:
+:
+: @cindex PERL
+: @cindex Wall, Larry
+: @display
+: @i{AWK is a language similar to PERL, only considerably more elegant.} @*
+: Arnold Robbins
+: @sp 1
+: @i{Hey!} @*
+: Larry Wall
+: @end display
+:
+: Before I actually release this for publication, I wanted to get your
+: permission to quote you. (Hopefully, in the spirit of much of GNU, the
+: implied humor is visible... :-)
+
+I think that would be fine.
+
+Larry
address@hidden ignore
address@hidden Perl
address@hidden Wall, Larry
address@hidden Robbins, Arnold
address@hidden
address@hidden @`e un linguaggio simile a PERL, solo che @`e notevolmente
address@hidden elegante.}
address@hidden Arnold Robbins
address@hidden quotation
+
address@hidden
address@hidden
address@hidden Larry Wall
address@hidden quotation
+
+Il file @file{TODO} nel ramo @code{master} del deposito Git di @command{gawk}
+contiene un elenco di possibili futuri miglioramenti. Alcuni di questi
+riguardano il codice sorgente, e altri possibili nuove address@hidden
+Consultare quel file per esaminare la lista.
address@hidden,
+se si @`e interessati a intraprendere qualcuno dei progetti address@hidden
elencati.
+
address@hidden Limitazioni dell'implementazione
address@hidden Alcune limitazioni dell'implementazione
+
+La tabella seguente specifica i limiti di @command{gawk} in un sistema di
+tipo Unix (sebbene anche tra questi ci potrebbero essere variazioni). Altri
+sistemi operativi possono avere limiti differenti.
+
address@hidden @columnfractions .40 .60
address@hidden Caratteristica @tab Limiti
address@hidden Caratteri in una classe di caratteri @tab 2^(numero di bit per
byte)
address@hidden Lunghezza di un record in input @tab @code{MAX_INT}
address@hidden Lunghezza di un record in output @tab Illimitata
address@hidden Lunghezza di una riga di codice sorgente @tab Illimitata
address@hidden Numero di campi in un record @tab @code{MAX_LONG}
address@hidden Numero di ridirezioni di file @tab Illimitata
address@hidden Numero di record in input in un singolo file @tab @code{MAX_LONG}
address@hidden Numero totale di record in input @tab @code{MAX_LONG}
address@hidden Numero di ridirezioni via @dfn{pipe} @tab min(numero processi
per utente, numero di file aperti)
address@hidden Valori numerici @tab Numeri a virgola mobile in doppia
precisione (se non si usa la address@hidden MPFR)
address@hidden Dimensione di un campo @tab @code{MAX_INT}
address@hidden Dimensione di una stringa letterale @tab @code{MAX_INT}
address@hidden Dimensione di una stringa di @dfn{printf} @tab @code{MAX_INT}
address@hidden multitable
+
address@hidden Progetto delle estensioni
address@hidden Note di progetto dell'estensione API
+
+Questa @value{SECTION} documenta l'architettura dell'estensione API,
+inclusa una trattazione sommaria della progettazione e dei problemi che
+andavano risolti.
+
+La prima versione delle estensioni per @command{gawk} @`e stata sviluppata
+a address@hidden degli anni '90, e distribuita con la versione 3.1 di
@command{gawk},
+verso la fine degli anni '90.
+Il meccanismo e l'architettura sono rimasti gli stessi per quasi 15 anni,
+fino al 2012.
+
+Il vecchio meccanismo delle estensioni usava tipi di dati e funzioni dello
+stesso @command{gawk}, con un ``abile trucco'' per installare le funzioni
+di estensione.
+
+La distribuzione @command{gawk} conteneva alcuni esempi di estensioni, solo
+poche delle quali erano realmente utili. Tuttavia era chiaro fin da
+principio che il meccanismo di estensione era un'aggiunta improvvisata, e
+non era realmente ben concepito.
+
address@hidden
+* Problemi con le vecchie estensioni:: Problemi col vecchio meccanismo.
+* Obiettivi delle estensioni:: Obiettivi del nuovo meccanismo.
+* Altre scelte progettuali per le estensioni:: Qualche altra scelta
progettuale.
+* Futuri sviluppi delle estensioni:: address@hidden di crescita futura.
address@hidden menu
+
address@hidden Problemi con le vecchie estensioni
address@hidden Problemi con le vecchie estensioni
+
+Il vecchio meccanismo delle estensioni presentava parecchi problemi:
+
address@hidden @value{BULLET}
address@hidden
+Dipendeva eccessivamente dalla struttura interna di @command{gawk}. Ogni volta
+che la struttura @address@hidden struttura di dati fondamentale
+all'interno di @command{gawk}.} veniva modificata, ogni estensione doveva
+essere ricompilata. Inoltre, la scrittura di estensioni richiedeva una
+certa address@hidden con le funzioni interne di @command{gawk}. Esisteva
+un po' di documentazione in questo @value{DOCUMENT}, ma era ridotta al minimo.
+
address@hidden
+Per poter utilizzare servizi di @command{gawk} da un'estensione era necessario
+disporre di address@hidden del @dfn{linker}
+normalmente disponibili in ambiente di tipo Unix, ma non implementate
+nei sistemi MS-Windows; chi voleva utilizzare estensioni in
+MS-Windows doveva aggiungerle al modulo eseguibile di @command{gawk},
+anche se MS-Windows supporta il caricamento dinamico di oggetti condivisi.
+
address@hidden
+L'API di tanto in tanto veniva modificata, in parallelo ai cambiamenti di
address@hidden; nessuna address@hidden tra le versioni @`e stata mai prevista o
+resa disponibile.
address@hidden itemize
+
+Nonostante questi inconvenienti, gli sviluppatori del progetto @command{xgawk}
+si basarono su @command{gawk} per sviluppare parecchie estensioni
+significative. Inoltre, migliorarono le address@hidden, in @command{gawk}, di
+includere file e di accedere a oggetti condivisi.
+
+Una nuova API @`e rimasta un desiderio per lungo tempo, ma solo nel 2012
+il manutentore di @command{gawk} e gli sviluppatori di @command{xgawk}
+iniziarono finalmente a lavorare insieme. Ulteriori informazioni riguardanti
+il progetto @command{xgawk} sono forniti nella @ref{gawkextlib}.
+
address@hidden Obiettivi delle estensioni
address@hidden Obiettivi per un nuovo meccanismo
+
+Alcuni obiettivi per la nuova API sono:
+
address@hidden @value{BULLET}
address@hidden
+L'API dovrebbe essere indipendente dalla struttura interna di @command{gawk}.
+Le modifiche alla struttura interna di @command{gawk} dovrebbero essere
+irrilevanti per chi scrive una funzione di estensione.
+
address@hidden
+L'API dovrebbe consentire una address@hidden @emph{binaria} [ossia a livello
+di codice eseguibile, e non solo a livello di codice sorgente] tra diverse
+versioni di @command{gawk}, se la stessa API rimane invariata.
+
address@hidden
+L'API dovrebbe consentire che le estensioni scritte in C o C++ abbiano
+all'incirca la stessa ``struttura'', per il codice awk,
+di quella che hanno le funzioni di @command{awk}. Questo vuol dire che le
+estensioni dovrebbero avere:
+
address@hidden @value{MINUS}
address@hidden
+La address@hidden di accedere ai parametri delle funzioni.
+
address@hidden
+La address@hidden di trasformare un parametro indefinito in un vettore
+(chiamata per riferimento address@hidden reference}]).
+
address@hidden
+La address@hidden di creare, leggere e aggiornare variabili globali.
+
address@hidden
+Un accesso facile a tutti gli elementi di un vettore simultaneamente
+(``appiattimento del vettore'') in modo da poter visitare tutti gli elementi
+del vettore in una maniera semplice per un programma scritto in C.
+
address@hidden
+La address@hidden di creare vettori (compresi i veri "vettori di vettori" di
address@hidden).
address@hidden itemize
address@hidden itemize
+
+Alcuni ulteriori obiettivi rilevanti sono:
+
address@hidden @value{BULLET}
address@hidden
+L'API dovrebbe usare solo address@hidden disponibili nella specifica ISO C 90,
in
+modo da consentire estensioni scritte con una vasta gamma di compilatori C e
+C++. L'intestazione dovrebbe includere le appropriate direttive
address@hidden __cplusplus} e @samp{extern "C"}, in modo da poter utilizzare un
+compilatore C++. (Se si usa C++, il sistema operativo in uso dev'essere in
+grado di invocare dei costruttori e dei distruttori, poich@'e @command{gawk}
@`e un
+programma scritto in C. Al momento in cui queste note sono scritte, la cosa
+non @`e stata verificata).
+
address@hidden
+Il meccanismo API non dovrebbe aver bisogno di accedere ai simboli di
address@hidden@footnote{I @dfn{simboli} sono le variabili e le funzioni
+definite all'interno di @command{gawk}. Accedere a questi simboli da parte
+di codice esterno a @command{gawk} caricato dinamicamente al momento
+dell'esecuzione @`e problematico in ambiente MS-Windows.} da parte del
address@hidden statico, usato in fase di compilazione, o di quello dinamico,
+in modo da rendere possibile la creazione di estensioni che funzionino anche
+in ambiente MS-Windows.
address@hidden itemize
+
+In fase di sviluppo, @`e apparso evidente che dovevano essere disponibili alle
+estensioni anche altre address@hidden, che sono state
+successivamente implementate:
+
address@hidden @value{BULLET}
address@hidden
+Le estensioni dovrebbero essere in grado di agganciarsi al meccanismo di
+ridirezione dell'I/O di @command{gawk}. In particolare, gli sviluppatori di
address@hidden hanno programmato un cosiddetto ``gancio aperto'' (@dfn{open
+hook}) per gestire autonomamente la lettura dei record. In fase di sviluppo,
+questo meccanismo @`e stato generalizzato, per consentire alle estensioni di
+agganciarsi sia all'elaborazione dell'input, che a quella dell'output, nonch@'e
+all'I/O bidirezionale.
+
address@hidden
+Un'estensione dovrebbe poter rendere disponibile una funzione di ``call back''
+(richiamo) per effettuare operazioni di pulizia all'uscita di @command{gawk}.
+
address@hidden
+Un'estensione dovrebbe poter rendere disponibile una stringa di versione
address@hidden@dotless{i}} che l'opzione @option{--version}
+di @command{gawk} possa informare anche sulle versioni delle estensioni.
address@hidden itemize
+
+Il vincolo di evitare di accedere ai simboli di @command{gawk} address@hidden
parere a
+prima vista piuttosto difficile da rispettare.
+
+Un tipo di architettura, apparentemente usato da Perl e Ruby e forse da altri
+programmi, potrebbe consistere nel mettere il codice principale di
address@hidden in una libreria, limitando il programma di address@hidden
address@hidden a una piccola funzione @code{main()} in C che richiamerebbe
+dinamicamente la libreria.
+
+Questo inverte i ruoli del programma principale e della sua estensione, e
+complica sia la compilazione che l'installazione, trasformando la semplice
+copia del programma eseguibile @command{gawk} da un sistema all'altro (o da una
+posizione all'altra all'interno dello stesso sistema) in un'operazione ad alto
+rischio.
+
+Pat Rankin ha suggerito la soluzione che @`e stata adottata.
address@hidden sul meccanismo delle estensioni}, per maggiori dettagli.
+
address@hidden Altre scelte progettuali per le estensioni
address@hidden Altre scelte progettuali
+
+Per una scelta progettuale arbitraria, le estensioni possono accedere ai valori
+delle variabili e dei vettori predefiniti (come @code{ARGV} e @code{FS}), ma
+non possono modificarli, con la sola eccezione di @code{PROCINFO}.
+
+Il motivo di questa scelta @`e di impedire a una funzione di estensione di
+alterare il flusso di un programma @command{awk} togliendogli il controllo.
+Mentre una vera funzione di @command{awk} address@hidden fare quel che vuole, a
+discrezione del programmatore, una funzione di estensione dovrebbe fornire un
+servizio, o rendere disponibile un'API C da utilizzare all'interno di
address@hidden, senza interferire con le variabili @code{FS} o @code{ARGC} e
address@hidden
+
+Inoltre, diverrebbe facile avviarsi su un sentiero scivoloso. Quante
address@hidden di @command{gawk} dovrebbero essere disponibili alle estensioni?
+Devono poter usare @code{getline}? Oppure richiamare @code{gsub()} o compilare
+espressioni regolari? Oppure richiamare funzioni interne di @command{awk}?
+(@emph{Questo} potrebbe creare molta confusione.)
+
+Per evitare questi problemi, gli sviluppatori di @command{gawk} hanno scelto di
+iniziare con le address@hidden address@hidden semplici e di base, che sono
comunque
+veramente utili.
+
+Sebbene @command{gawk} consenta cose interessanti come l'MPFR,
+e vettori indicizzati internamente con numeri interi,
+un'altra decisione @`e stata quella di non rendere disponibili all'API queste
address@hidden, per amor di address@hidden e per restare fedeli alla
tradizionale
+semantica di @command{awk}. (In effetti, i vettori indicizzati internamente
+con numeri interi sono talmente trasparenti che non sono neppure documentati!)
+
+In address@hidden, tutte le funzioni nell'API controllano che i puntatori ai
parametri
+passati loro in input non siano @code{NULL}. Se lo sono, viene emesso un
+messaggio di errore. (@`E bene che il codice di estensione verifichi
+che i puntatori ricevuti da @command{gawk} non siano @code{NULL}.
address@hidden non
+dovrebbe succedere, ma gli sviluppatori di @command{gawk} sono solo degli
+esseri umani, e capita anche a loro di commettere degli errori, di tanto in
+tanto.)
+
+Col tempo, l'API si address@hidden certamente; gli sviluppatori di
@command{gawk}
+si aspettano che questo avvenga in base alle address@hidden degli utenti. Per
ora,
+l'API disponbile sembra fornire un insieme di address@hidden minimo, eppure
+potente, per creare estensioni.
+
address@hidden Futuri sviluppi delle estensioni
address@hidden address@hidden di sviluppo futuro
+
+L'API address@hidden ancora essere ampliata, in due modi:
+
address@hidden @value{BULLET}
address@hidden
address@hidden passa un ``identificativo di estensione'' all'estensione in fase
+di caricamente dell'estensione. L'estensione a sua volta restituisce questo
+identificativo a @command{gawk} a ogni chiamata di funzione. Questo meccanismo
+consente a @command{gawk} di identificare l'estensione che lo chiama, se la
+cosa dovesse risultare necessaria.
+
address@hidden
+Analogamente, l'estensione passa uno ``spazio dei nomi'' a @command{gawk}
+in fase di registrazione di ogni funzione estesa. Questo @`e fatto in vista di
+un possibile futuro meccanismo per raggruppare funzioni di estensione, e per
+evitare in questo modo possibili conflitti nei nomi di funzione.
address@hidden itemize
+
+Naturalmente, al momento in cui queste righe sono state scritte, nessuna
+decisione @`e stata presa riguardo ai punti sopra descritti.
+
address@hidden Meccanismo delle vecchie estensioni
address@hidden address@hidden per le vecchie estensioni
+
address@hidden
+Il
address@hidden iftex
address@hidden dinamiche}, descrive le API supportate e i meccanismi
+per scrivere estensioni per @command{gawk}. Quest'API @`e stata introdotta
+nella @value{PVERSION} 4.1. Peraltro, address@hidden da molti anni
@command{gawk}
+metteva a disposizione un meccanismo di estensione che richiedeva una
address@hidden con la struttura interna di @command{gawk} e che non era stato
+progettato altrettanto bene.
+
+Per garantire un periodo di transizione, @command{gawk} @value{PVERSION} 4.1
+continua a supportare il meccanismo di estensione originale.
+Questo address@hidden disponibile per la durata di una sola versione
principale.
+Il supporto address@hidden, e address@hidden rimosso dal codice sorgente, al
rilascio
+della prossima versione principale.
+
+In breve, le estensioni in stile originale dovrebbero essere compilate
+includendo il file di intestazione @file{awk.h} nel codice sorgente
+dell'estensione. Inoltre, va definito l'identificativo @samp{GAWK} durante la
+preparazione (si usi @samp{-DGAWK} con compilatori in stile Unix). Se non lo
+si fa, le definizioni in @file{gawkapi.h} risulteranno in conflitto con quelle
+in @file{awk.h} e l'estensione non address@hidden compilabile.
+
+Come nelle versioni precedenti, un'estensione vecchio stile address@hidden
caricata
+usando la funzione predefinita @code{extension()} (che non viene ulteriormente
+documentata). Questa funzione, a sua volta, trova e carica il file oggetto
+condiviso che contiene l'estensione e chiama la sua routine C @code{dl_load()}.
+
+Poich@'e le estensioni in stile originale e quelle nello stile nuovo usano
+differenti routine di inizializzazione(@code{dl_load()} e @code{dlload()},
+rispettivamente), esse possono tranquillamente essere installate nella stessa
+directory (il cui nome deve essere contenuto nella variabile @env{AWKLIBPATH})
+senza problemi di conflitti.
+
+Il @dfn{team} di sviluppo di @command{gawk} raccomanda caldamente di convertire
+ogni estensione del vecchio tipo ancora in uso, in modo da utilizzare la nuova
+API descritta
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden dinamiche}.
+
address@hidden Sommario delle note
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Le estensioni di @command{gawk} possono essere disabilitata sia con
+l'opzione @option{--traditional} che con l'opzione @option{--posix}.
+L'opzione @option{--parsedebug} @`e disponibile se @command{gawk} @`e stato
+compilato con @samp{-DDEBUG}.
+
address@hidden
+Il codice sorgente di @command{gawk} @`e conservato in un deposito Git
+pubblicamente accessibile. Tutti possono scaricarlo e visualizzare il
+codice sorgente.
+
address@hidden
+I contributi a @command{gawk} sono benvenuti. Seguire le istruzioni
+delineate in questo @value{CHAPTER} address@hidden address@hidden agevole
integrare
+i contributi degli utenti nel codice principale.
+Questo vale sia per il contributo di nuove address@hidden che per il
address@hidden a ulteriori sistemi operativi.
+
address@hidden
address@hidden ha alcuni limiti: generalmente quelli imposti
+dall'architettura hardware della macchina.
+
address@hidden
+La progettazione dell'estensione API @`e volta a risolvere alcuni problemi
+riscontrati nel precedente meccanismo di estensione, ad abilitare
address@hidden richieste dal progetto @code{xgawk}, e a fornire una
address@hidden binaria in futuro.
+
address@hidden
+Il precedente meccanismo di estensione @`e ancora supportato
+nella @value{PVERSION} 4.1
+di @command{gawk}, ma address@hidden @emph{rimosso} nella prossima versione
principale.
+
address@hidden itemize
+
+
address@hidden Concetti fondamentali
address@hidden Concetti fondamentali di programmazione
address@hidden programmazione, concetti di
address@hidden programmazione, concetti di
+
+Quest'@value{APPENDIX} si propone di definire alcuni dei concetti
+e termini fondamentali usati nel resto di questo @value{DOCUMENT}.
+Poich@'e questo @value{DOCUMENT} @`e dedicato ad @command{awk},
+e non riguarda la programmazione al computer in generale, la trattazione
address@hidden necessariamente piuttosto generica e semplificata.
+(Se serve qualcosa di address@hidden approfondito, ci sono molti
+altri testi introduttivi che si possono consultare.)
+
address@hidden
+* Fondamenti ad alto livello:: Una visione dall'alto.
+* Fondamenti sui tipi di dati:: Una velocissima introduzione ai tipi di dati.
address@hidden menu
+
address@hidden Fondamenti ad alto livello
address@hidden Quel che fa un programma
+
address@hidden elaborazione dati
+Al livello address@hidden fondamentale, il compito di un programma @`e di
elaborare
+alcuni dati in input e produrre dei risultati.
address@hidden
+Si veda la @ref{figura-generica-flusso}.
address@hidden ifnotdocbook
address@hidden
+Si veda la @inlineraw{docbook, <xref linkend="figura-generica-flusso"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-generica-flusso
address@hidden generico di un programma}
address@hidden SMALLPRINT
address@hidden @image{programma-generico, , , Flusso generico di un programma}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{programma-generico, 11cm, , Flusso generico di un
programma}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-generica-flusso" float="0">
+<title>Flusso generico di un programma</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="programma-generico.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
address@hidden programmi compilati
address@hidden programmi interpretati
+Il ``programma'' nella figura address@hidden essere sia un programma
address@hidden programmi compilati sono normalmente scritti
+in linguaggi di programmazione di livello address@hidden basso, come C, C++, o
Ada,
+e quindi tradotti, o @dfn{compilati}, in una forma che
+il computer address@hidden eseguire direttamente.}
+(come @command{ls}),
+sia un programma @dfn{interpretato}. In quest'ultimo caso, un programma
+direttamente eseguibile dal computer, come @command{awk}, legge il
+programma, e quindi usa le istruzioni in esso contenute per elaborare i dati.
+
address@hidden programmazione, passi fondamentali
+Quando si scrive un programma, esso @`e composto normalmente
+dai seguenti insiemi di istruzioni di base,
address@hidden
+come si vede nella @ref{figura-flusso-elaborazione}:
address@hidden ifnotdocbook
address@hidden
+come si vede nella @inlineraw{docbook, <xref
linkend="figura-flusso-elaborazione"/>}:
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-flusso-elaborazione
address@hidden di un programma generico}
address@hidden SMALLPRINT
address@hidden @image{flusso-elaborazione, , , Fasi di un programma generico}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{flusso-elaborazione, 11cm , , Fasi di un programma
generico}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figura id="figura-flusso-elaborazione" float="0">
+<title>Fasi di un programma generico</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="flusso-elaborazione.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
address@hidden @asis
address@hidden Inizializzazione
+Queste sono le cose da fare prima di iniziare la reale elaborazione dei
+dati, per esempio controllare gli argomenti con cui @`e stato invocato il
+programma, inizializzare dei dati di cui si address@hidden aver bisogno per la
+successiva elaborazione, e address@hidden@dotless{i}} via.
+Questa fase corrisponde alla regola @code{BEGIN} di @command{awk}
+(@pxref{BEGIN/END}).
+
+Nella preparazione di una torta, questa fase corrisponde a quella di
+tirar fuori tutti i contenitori in cui mischiare gli ingredienti, e la
+teglia in cui cuocerla, e nell'assicurarsi di avere a disposizione tutti gli
+ingredienti necessari.
+
address@hidden Elaborazione
+Questa fase @`e quella in cui si svolge il lavoro vero e proprio. Il programma
+legge i dati, raggruppati in ``pezzi logici'', e li elabora secondo
address@hidden
+
+In quasi tutti i linguaggi di programmazione, la lettura dei dati va gestita
+manualmente, controllando dopo ogni lettura se @`e
+rimasto ancora qualcosa d'altro da leggere. Il paradigma @dfn{criterio di
+ricerca--azione} di @command{awk}
address@hidden
+(@pxrefil{Per iniziare})
address@hidden iftex
address@hidden
+(@pxref{Per iniziare})
address@hidden ifnottex
+gestisce automaticamente la parte di lettura dati.
+
+Nella preparazione di una torta, l'elaborazione corrisponde all'address@hidden
+vera e propria: rompere le uova, mescolare la farina, l'acqua e gli altri
+ingredienti, e quindi mettere la torta a cuocere nel forno.
+
address@hidden Pulizia
+Una volta elaborati tutti i dati, ci sono address@hidden da svolgere prima di
aver
+finito. Questa fase corrisponde alla regola @code{END} di @command{awk}.
+(@pxref{BEGIN/END}).
+
+Dopo che la torta @`e stata tirata fuori dal forno, va fatta raffreddare e
+avvolta in una pellicola trasparente per evitare che qualcuno la assaggi,
+e inoltre vanno lavati i contenitori e le posate.
address@hidden table
+
address@hidden Algoritmi
+Un @dfn{algoritmo} @`e la descrizione dettagliata della procedura necessaria
per
+svolgere un compito o per elaborare dati. Lo si address@hidden paragonare
alla ricetta
+per preparare una torta. I programmi sono il modo con cui un
+algoritmo viene eseguito da un computer.
+Spesso @`e compito del programmatore sia sviluppare un algoritmo, sia
+programmarlo.
+
address@hidden record
address@hidden campi
+I ``pezzi logici'' nominati precedentemente sono chiamati @dfn{record}
+(registrazioni), in analogia con le registrazioni del personale di una ditta,
+degli studenti di una scuola, o dei pazienti di un dottore.
+Ogni record @`e composto di molte parti, per esempio nome, cognome, data di
+nascita, indirizzo, e address@hidden@dotless{i}} via. Le parti di cui @`e
composto un record sono
+chiamate @dfn{campi} del record.
+
+L'atto di leggere i dati @`e noto come @dfn{input}, e quello di generare
+risultati @`e, come facilmente prevedibile, chiamato @dfn{output}. Spesso i
due
+sono riuniti sotto il nome di ``input/output'' e, ancor address@hidden spesso,
con
+l'abbreviazione ``I/O''. (In inglese ``input'' e ``output'' sono spesso usati
+come verbi, nel gergo informatico, al posto di leggere e scrivere.)
+
address@hidden guidato-dai-dati, linguaggio di programmazione
address@hidden linguaggio di programmazione, guidato dai dati
address@hidden gestisce la lettura dei dati, come anche la divisione in
+record e campi. Lo scopo del programma dell'utente @`e di dire ad
@command{awk}
+cosa fare con i dati. Questo vien fatto descrivendo @dfn{modelli} da
+ricercare nei dati e @dfn{azioni} da eseguire qualora si siano trovati questi
+modelli. Questa caratteristica dei programmi @command{awk}, di essere
address@hidden, di solito li rende address@hidden facili sia da scrivere che da
+leggere.
+
address@hidden Fondamenti sui tipi di dati
address@hidden Valore dei dati in un computer
+
address@hidden variabili
+In un programma si tiene traccia di informazioni e valori in contenitori
+chiamati @dfn{variabili}. Una variabile @`e solo un nome per designare un
certo
+valore, come @code{nome}, @code{cognome}, @code{indirizzo}, e
address@hidden@dotless{i}} via.
address@hidden ha molte variabili predefinite, e ha dei nomi speciali per
+designare il record in input corrente e i campi che compongono il record
+stesso. Si possono inoltre raggruppare molti valori associati tra di loro
+sotto un unico nome, utilizzando un vettore.
+
address@hidden valori numerici
address@hidden valori tipo stringa
address@hidden valori scalari
address@hidden scalari, valori
+I dati, in particolare in @command{awk}, possono avere valori numerici, come 42
+o 3.1415927, o avere come valore delle stringhe. Un valore di tipo stringa @`e
+essenzialmente qualsiasi cosa che non sia un numero, per esempio un nome. Le
+stringhe sono talora chiamate @dfn{dati di tipo carattere}, poich@'e
memorizzano
+i singoli caratteri che le formano. Le singole variabili, come pure le
+variabili numeriche e di tipo stringa, sono definite come valori
address@hidden Raggruppamenti di valori, come i vettori, non sono scalari.
+
address@hidden
+La
address@hidden iftex
address@hidden del computer}, ha fornito un'introduzione di base ai tipi
+numerici (interi e a virgola mobile) e a come questi sono usati in un computer.
+Si consiglia di rileggere quelle informazioni, comprese le numerose avvertente
address@hidden esposte.
+
address@hidden stringhe nulle
+Mentre @`e probabile che ci si sia abituati all'idea di un numero senza un
valore
+(address@hidden, allo zero), richiede un po' address@hidden di riflessione
abituarsi all'idea di
+dati di tipo carattere a lunghezza zero. Nonostante address@hidden, questo
tipo di dato
+esiste. @`E chiamato @dfn{stringa nulla}. La stringa nulla @`e un dato di
tipo
+carattere che non ha un valore. In altre parole, @`e vuoto. Si scrive
address@hidden@dotless{i}} nei
+programmi @command{awk}: @code{""}.
+
+Gli esseri umani sono abituati a usare il sistema decimale, address@hidden a
base 10.
+In base 10, i numeri vanno da 0 a 9, e poi ``vengono riportati'' nella
+colonna successiva. (Chi si ricorda la scuola elementare? 42 = 4 x 10 + 2.)
+
+Ma esistono anche altre basi per i numeri. I computer normalmente usano
+la base 2 o @dfn{binaria}, la base 8 o @dfn{ottale}, e la base 16 o
address@hidden Nella numerazione binaria, ogni colonna rappresenta il
+doppio del valore della colonna alla sua destra. Ogni colonna address@hidden
contenere
+solo uno 0 o un 1. Quindi, il numero binario 1010 rappresenta (1 x 8) + (0 x
+4) + (1 x 2) + (0 x 1), ossia il numero decimale 10. Le numerazioni ottale ed
+esadecimale sono trattate address@hidden ampiamente
address@hidden
+in
address@hidden ifnottex
address@hidden
+nella
address@hidden iftex
address@hidden non-decimali}.
+
+Al livello address@hidden basso possibile, i computer memorizzano i valori
come gruppi di
+cifre binarie, o @dfn{bit}. I computer moderni raggruppano i bit in gruppi di
+otto, detti @dfn{byte}. Applicazioni avanzate talora hanno address@hidden di
+manipolare i bit direttamente, e @command{gawk} @`e dotato di apposite
funzioni.
+
+I programmi sono scritti nei linguaggi di programmazione. Esistono centinaia,
+se non migliaia, di linguaggi di programmazione. Uno dei address@hidden
diffusi @`e il
+linguaggio di programmazione C. Il linguaggio C ha esercitato un'influsso
+molto forte nella progettazione del linguaggio @command{awk}.
+
address@hidden Kernighan, Brian
address@hidden Ritchie, Dennis
+Ci sono state parecchie versioni di C. La prima @`e spesso designata come
+``K&R'' C, dalle iniziali di Brian Kernighan e Dennis Ritchie,
+gli autori del primo libro sul C. (Dennis Ritchie ha creato il linguaggio,
+e Brian Kernighan @`e stato uno dei creatori di @command{awk}.)
+
+A address@hidden degli anni '80 @`e iniziato uno sforzo rivolto a produrre uno
+standard internazionale per il C. Questo lavoro ha raggiunto un punto di
+arrivo nel 1989 con la produzione dello standard ANSI per il C.
+Questo standard @`e diventato uno standard ISO nel 1990.
+Nel 1999, uno standard ISO C revisionato @`e stato approvato e pubblicato.
+Dove @`e opportuno, POSIX @command{awk} @`e compatible con lo standard
+ISO C del 1999.
+
+
address@hidden Glossario
address@hidden Glossario
+
address@hidden @asis
address@hidden Abbraccio mortale
+La situazione in cui due processi che comunicano tra loro sono entrambi
bloccati, in
+attesa che l'altro processo faccia qualcosa.
+
address@hidden Ada, linguaggio di programmazione
address@hidden linguaggio di programmazione, Ada
address@hidden Ada
+Un linguaggio di programmazione originalmente definito dal Department of
+Defense U.S.A.@: per la programmazione integrata. @`E stato progettato per
+favorire dei buoni metodi da seguire nell'ingegneria del software.
+
address@hidden Ambiente
+Si veda ``Variabili d'ambiente''.
+
address@hidden @`Ancora
+I metacaratteri @dfn{regexp} @samp{^} e @samp{$}, che richiedono che la
+corrispondenza che si sta cercando si trovi all'inizio o alla fine di una
+stringa, rispettivamente.
+
address@hidden angolo buio
address@hidden Angolo buio
+Un'area del linguaggio le cui specifiche spesso non erano (o ancora non
+sono) chiare, col risultato di ottenere un comportamente inatteso o non
+desiderabile.
+Tali aree sono segnalate in questo @value{DOCUMENT} con
address@hidden
+il disegno di una torcia a margine
address@hidden iftex
address@hidden
+``(a.b.)'' nel testo
address@hidden ifnottex
+e sono riportate nell'indice analitico sotto la voce ``angolo buio''.
+
address@hidden ANSI
address@hidden ANSI
+L'American National Standards Institute. Questo ente produce
+parecchi standard, e tra questi gli standard per i linguaggi di
+programmazione C e C++.
+Questi standard spesso diventano anche internazionali. Si veda anche
+``ISO''.
+
address@hidden Argomento
+Un argomento address@hidden essere due cose differenti. address@hidden essere
un'opzione o un
address@hidden passato a un comando mentre lo si invoca dalla riga dei comandi,
+oppure address@hidden essere qualcosa passato a una @dfn{funzione} all'interno
di un
+programma, per esempio all'interno di @command{awk}.
+
+In quest'ultimo caso, un argomento address@hidden essere passato a una
funzione in
+due modi. Nel primo modo @`e passato come valore alla funzione chiamata,
+ossia una copia del valore della variabile @`e reso disponibile alla funzione
+chiamata, ma la variabile originale non address@hidden essere modificata dalla
+funzione stessa. Nel secondo modo l'argomento @`e passato per riferimento,
+ossia un puntatore alla variabile in questione @`e passato alla funzione, che
address@hidden quindi modificarla direttamente. In @command{awk} le variabili
scalari
+sono passate per valore, e i vettori sono passati per riferimento.
+Si veda ``Passaggio per valore/riferimento''.
+
address@hidden Arrotondamento
+Arrotondare il risultato di un'operazione aritmetica address@hidden essere
difficile.
+C'@`e address@hidden di un modo di arrotondare, e in @command{gawk} @`e
possibile scegliere
+quale metodo dovrebbe essere usato all'interno di un programma.
address@hidden modi di arrotondare}.
+
address@hidden Assegnamento
+Un'espressione @command{awk} che cambia il valore di qualche variabile o
+dato oggetto di @command{awk}. Un oggetto a cui si address@hidden assegnare
un valore
address@hidden detto un @dfn{lvalue}. I valori
+assegnati sono chiamati @dfn{rvalue}.
address@hidden di assegnamento}.
+
address@hidden Spencer, Henry
address@hidden @command{sed}, programma di address@hidden
address@hidden programma di address@hidden @command{sed}
address@hidden incredibile assembler (@command{aaa}) scritto in @command{awk}
address@hidden Assembler incredibilmente scritto in @command{awk}
+Henry Spencer dell'address@hidden di Toronto ha scritto un assembler adatto a
+molti diversi hardware, usando solo @dfn{script} @command{sed} e
address@hidden @`E lungo migliaia di righe, e include
+la descrizione dell'hardware di
+numerosi micro-computer a 8 bit. @`E un
+buon esempio di programma per cui sarebbe stato
+meglio utilizzare un altro linguaggio.
+Si address@hidden scaricare da @uref{http://awk.info/?awk100/aaa}.
+
address@hidden Asserzione
+Un'istruzione in un programma che afferma che una condizione @`e verificata in
+un dato punto di un programma.
+Utile per ragionare su come si suppone funzioni un programma.
+
address@hidden Azione
+Una serie di istruzioni @command{awk} associate a una regola. Se
+l'espressione di ricerca della regola individua un record in input,
address@hidden esegue su quel record l'azione relativa. Le azioni sono
+sempre racchiuse tra parentesi graffe.
+(@xref{Panoramica sulle azioni}).
+
address@hidden Bash
+La versione GNU della shell standard
address@hidden
+(il @address@hidden @b{SH}ell).
address@hidden ifnotinfo
address@hidden
+(il Bourne-Again SHell).
address@hidden ifinfo
+Si veda anche ``Bourne Shell''.
+
address@hidden Binario
+Notazione a base due, che usa le cifre @address@hidden Poich@'e
+i circuiti elettronici funzionano ``naturalmente'' in base 2
+(basta pensare a Off/On), ogni cosa all'interno di un computer @`e
+calcolata usando la base 2. Ciascuna cifra rappresenta la presenza
+(o l'assenza) di una potenza di 2 ed @`e chiamata un @dfn{bit}.
address@hidden@dotless{i}}, per esempio, il numero in base due @code{10101}
rappresenta il
+numero in base decimale 21, ((1 x 16) + (1 x 4) + (1 x 1)).
+
+Poich@'e i numeri in base due diventano rapidamente molto lunghi
+sia da leggere che da scrivere, normalmente li si unisce a gruppi di tre
+(ossia, sono visti come numeri ottali) o a gruppi di quattro (ossia, sono
+visti come numeri esadecimali). Non c'@`e un modo diretto per inserire
+numeri a base due in un programma C. Se necessario, tali numeri vengono
+solitamente inseriti come numeri ottali o esadecimali.
+Il numero di cifre in base due contenuto nei registri usati per
+rappresentare i numeri interi all'interno dei computer @`e un'indicazione
+approssimativa della potenza di calcolo del computer stesso. La maggior
+parte dei computer oggi usa 64 bit per rappresentare i numeri interi nei
+registri di calcolo, ma registri a 32 bit, 16 bit e 8 bit sono stati
+largamente in uso in passato.
address@hidden non-decimali}.
+
address@hidden McIlroy, Doug
address@hidden biscotto della fortuna
address@hidden Biscotto della fortuna
+Una particolare perla di saggezza, segno, detto o ricordo
+prodotto da (o presentato a) un programma. (Con vivi ringraziamenti al Prof.
+Doug McIlroy).
address@hidden
+From: Doug McIlroy <address@hidden>
+Date: Sat, 13 Oct 2012 19:55:25 -0400
+To: address@hidden
+Subject: Re: origin of the term "cookie"?
+
+I believe the term "cookie", for a more or less inscrutable
+saying or crumb of information, was injected into Unix
+jargon by Bob Morris, who used the word quite frequently.
+It had no fixed meaning as it now does in browsers.
+
+The word had been around long before it was recognized in
+the 8th edition glossary (earlier editions had no glossary):
+
+cookie a peculiar goodie, token, saying or remembrance
+returned by or presented to a program. [I would say that
+"returned by" would better read "produced by", and assume
+responsibility for the inexactitude.]
+
+Doug McIlroy
+
+From: Doug McIlroy <address@hidden>
+Date: Sun, 14 Oct 2012 10:08:43 -0400
+To: address@hidden
+Subject: Re: origin of the term "cookie"?
+
+> Can I forward your email to Eric Raymond, for possible addition to the
+> Jargon File?
+
+Sure. I might add that I don't know how "cookie" entered Morris's
+vocabulary. Certainly "values of beta give rise to dom!" (see google)
+was an early, if not the earliest Unix cookie. The fact that it was
+found lying around on a model 37 teletype (which had Greek beta in
+its type box) suggests that maybe it was seen to be like milk and
+cookies laid out for Santa Claus. Morris was wont to make such
+connections.
+
+Doug
address@hidden ignore
+
address@hidden Bit
+Abbreviazione di ``Binary Digit'' [cifra binaria].
+Tutti i valori nella memoria di un computer sono rappresentati nella forma di
+cifre binarie: valori che sono zero o uno.
+Gruppi di bit possono essere interpretati differentemente---come numeri
+interi, numeri a virgola mobile, dati di tipo carattere, indirizzi di altri
+oggetti contenuti in memoria, o altri dati ancora.
address@hidden permette di lavorare con numeri a virgola mobile e stringhe.
address@hidden permette di manipolare bit con le funzioni predefinite
+descritte
address@hidden
+in
address@hidden ifnottex
address@hidden
+nella
address@hidden iftex
address@hidden a livello di bit}.
+
+I computer sono spesso definiti dal numero di bit che usano per rappresentare
+valori interi. Molti sistemi sono a 32-bit, ma i sistemi a 64-bit sono sempre
address@hidden numerosi, mentre i sistemi a 16-bit [e quelli a 8-bit] sono
praticamente
+scomparsi.
+
address@hidden Bourne Shell
+La shell standard (@file{/bin/sh}) in Unix e nei sistemi derivati da Unix,
+Originariamente scritto da Steven R.@: Bourne dei Bell Laboratories.
+Molte shell (Bash, @command{ksh}, @command{pdksh}, @command{zsh}) sono
+generalmente compatibili con la Bourne shell, anche quando offrono ulteriori
address@hidden
+
address@hidden C
+Il linguaggio di programmazione di sistema con cui @`e scritta la maggior parte
+del software GNU. Il linguaggio di programmazione @command{awk} ha una
+sintassi simile a quella del C, e
+questo @value{DOCUMENT} puntualizza, quando serve, le somiglianze esistenti
+fra @command{awk} e C.
+
+In generale, @command{gawk} tenta di essere ragionevolmente simile alla
+versione 1990 del C ISO.
+
address@hidden C Shell
+La C Shell (@command{csh} o la sua versione migliorata @command{tcsh}) @`e una
+shell Unix creata da Bill Joy verso la fine degli anni '70. La C shell si
+differenzia dalla altre shell per le sue address@hidden interattive, e per lo
+stile complessivo, che @`e abbastanza simile a quello del linguaggio C.
+La C shell non @`e compatibile all'indietro con la Bourne Shell, e per questo
+motivo un'attenzione speciale @`e necessaria se si convertono alla C shell
+degli script scritti per altre shell Unix, in particolare per address@hidden
che
+concerne la gestione delle variaili di shell.
+Si veda anche ``Bourne Shell''.
+
address@hidden C++
+Un linguaggio di programmazione molto diffuso, orientato agli oggetti,
+derivato dal C.
+
address@hidden Campo
+Quando @command{awk} legge un record in input, suddivide il record in parti
+separate da spazi vuoti (o da una @dfn{regexp} che individua il separatore,
+modificabile reimpostando la variabile predefinita @code{FS}). Tali parti
+sono dette campi. Se le parti sono di lunghezza fissa, si address@hidden
usare la
+variabile predefinita @code{FIELDWIDTHS} per descriverne le lunghezze.
+Se si desidera specificare i contenuti dei campi, piuttosto che il separatore
+fra i campi, si address@hidden usare la variabile predefinita @code{FPAT} per
farlo.
+(@xref{Separatori di campo},
address@hidden
+la
address@hidden iftex
address@hidden costante},
+e
address@hidden
+la
address@hidden iftex
address@hidden in base al contenuto}).
+
address@hidden ASCII
address@hidden ISO 8859-1
address@hidden ISO Latin-1
address@hidden caratteri (codifiche macchina di caratteri)
address@hidden insiemi di caratteri (codifiche macchina di caratteri)
address@hidden Unicode
address@hidden Caratteri
+L'insieme di codici numerici usati da un computer per rappresentare i
+caratteri (lettere, numeri, segni d'interpunzione, etc.) di un particolare
+paese o address@hidden L'insieme di caratteri address@hidden comunemente in
uso oggi @`e
+l'ASCII (American Standard Code for Information Interchange). Molti paesi
+europei usano un'estensione dell'ASCII
+nota come ISO-8859-1 (ISO Latin-1).
+L'insieme di caratteri @uref{http://www.unicode.org, Unicode} sta guadagnando
address@hidden e affermandosi come standard, e il suo uso @`e particolarmente
esteso
+nei sistemi GNU/Linux.
+
address@hidden Kernighan, Brian
address@hidden Bentley, Jon
address@hidden @command{chem}, programma di address@hidden
address@hidden programma di address@hidden @command{chem}
address@hidden CHEM
+Un preprocessore per @command{pic} che legge descrizioni di molecole
+e produce l'input a @command{pic} che serve a disegnarle.
address@hidden stato scritto in @command{awk}
+da Brian Kernighan e Jon Bentley, ed @`e disponibile in
address@hidden://netlib.org/typesetting/chem}.
+
address@hidden Classe di caratteri
+Si veda ``Espressione tra parentesi quadre''.
+
address@hidden programmi compilati
address@hidden Compilatore
+Un programma che traduce codici sorgente scritti in qualche linguaggio
+in codici eseguibili su un particolare computer. Il codice oggetto risultante
address@hidden quindi essere eseguito direttamente dal computer.
+Si veda anche ``Interprete''.
+
address@hidden Concatenazione
+Concatenare due stringhe significa unirle, producendo una nuova stringa.
+Per esempio, la stringa @samp{pippo} concatenata con
+la stringa @samp{pluto} produce la stringa @samp{pippopluto}.
+(@xref{Concatenazione}).
+
address@hidden Contatore di riferimenti
+Un meccanismo interno di @command{gawk} per minimizzare la address@hidden di
+memoria necessaria per contenere il valore delle variabili di tipo
+stringa. Se il valore assunto da una variabile @`e usato in address@hidden di
un
+posto nel programma, solo una copia del valore stesso @`e tenuta in
+memoria, e il contatore di riferimenti ad esso associato @`e aumentato di
+uno quando lo stesso valore @`e usato da un'ulteriore variabile, e diminuito
+di uno quando la variabile relativa non @`e address@hidden utilizzata. Quando
il
+contatore di riferimenti va a zero, la parte di memoria utilizzata per
+contenere il valore della variuabile @`e liberato.
+
address@hidden Coprocesso
+Un programma subordinato con il quale @`e possibile una comunicazione
+bidirezionale dal programma principale.
+
address@hidden Dati oggetto
+Sono costituiti da numeri e stringhe di caratteri. I numeri sono convertiti
+in stringhe e viceversa, a seconda delle address@hidden
+(@xref{Conversione}).
+
address@hidden Debugger
+Un programma che serve agli sviluppatori per rimuovere ``bug'' (de-bug) dai
+loro programmi.
+
address@hidden Dominio di testo
+Un nome unico che identifica un'applicazione.
+Usato per raggruppare messaggi che sono tradotti in fase di esecuzione
+nel linguaggio locale.
+
address@hidden Doppia precisione
+Una rappresentazione di numeri all'interno del computer che ha una parte
+espressa sotto forma di frazione. I numeri a doppia precisione hanno
address@hidden
+cifre decimali che quelli a singola precisione, ma le operazioni che la
+usano consumano address@hidden risorse di quelle
+eseguite in singola precisione. La doppia precisione @`e il formato con cui
address@hidden memorizza i valori numerici. Nel linguaggio C @`e il tipo di
+dati detto @code{double}.
+
address@hidden Editore di flusso
+Un programma che legge record da un flusso in input e li elabora uno o
address@hidden alla volta. Questo @`e diverso da quel che farebbe un programma
batch
+il quale potrebbe leggere completamente i file in input, prima di
+iniziare a fare alcunch@'e, ed @`e diverso anche da un programma interattivo,
che
+richiede input dall'utente [tipicamente, una riga alla volta].
+
address@hidden Effetto collaterale
+Un effetto collaterale ha luogo quando un'espressione ha un effetto ulteriore,
+invece di produrre solo un valore. Espressioni di assegnamento,
+incremento e decremento, e invocazioni di funzioni hanno effetti collaterali.
+(@xref{Operatori di assegnamento}).
+
address@hidden epoch, definizione di
address@hidden Epoca [Inizio del tempo in Unix]
+la data usata come ``inizio del tempo'' per i campi che contengono date.
+I valori del tempo nella maggior parte dei dei sistemi sono rappresentati
+in numero di secondi trascorsi dall'Epoca, con funzioni di libreria
+che consentono di convertire tali valori nei formati normali di data e ora.
+
+L'Epoca nei sistemi Unix e POSIX parte dal primo gennaio 1970 alle ore
+00:00:00 UTC.
+Si veda anche ``GMT'' e ``UTC''.
+
address@hidden Esadecimale
+Notazione per l'aritmetica in base 16, che usa le cifre @address@hidden e
+le lettere @address@hidden, con @samp{A}
+che rappresenta 10, @samp{B} che rappresenta 11, e address@hidden@dotless{i}}
via, fino a
address@hidden per 15.
+I numeri esadecimali sono scritti in C prefissandoli con @samp{0x},
+per indicarne la base. Quindi, @code{0x12} @`e 18 ((1 x 16) + 2).
address@hidden non-decimali}.
+
address@hidden Espressione booleana
address@hidden@dotless{i}} detta dal nome del matematico inglese George Boole.
+Si veda anche ``Espressione logica''.
+
address@hidden Espressione condizionale
+Un'espressione che usa l'operatore ternario @samp{?:}, come p.es.
address@hidden@var{expr1} ? @var{expr2} : @var{expr3}}. Dell'espressione
address@hidden viene calcolato il valore; se risulta verificata, il valore
+dell'intera espressione diviene quello di @var{expr2}; altrimenti il valore @`e
+quello di @var{expr3}. In ogni caso, solo una delle due espressioni
address@hidden e @var{expr3}
+viene calcolata. (@xref{Espressioni condizionali}).
+
address@hidden Espressione di confronto
+Una relazione che @`e vera o falsa, del tipo di @samp{a < b}.
+Espressioni di confronto sono usate nelle istruzioni
address@hidden, @code{while}, @code{do}, @code{for}
+e nelle espressioni di ricerca per scegliere quale record in input elaborare.
+(@xref{Tipi di variabile e confronti}).
+
address@hidden Espressione di intervallo
+Una parte di un'espressione regolare che permette di specificare
+corrispondenze multiple di qualche parte della @dfn{regexp}. Le espressioni di
+intervallo non erano originariamente ammesse nei programmi @command{awk}.
+
address@hidden Espressione di ricerca address@hidden
address@hidden (detta anche "criterio di ricerca" o "modello di ricerca")
+Le espressioni di ricerca individuano per @command{awk} a quali record in
+input sono applicabili determinate
+regole.
+
+Un'espressione di ricerca [pattern] @`e un'espressione condizionale specifica
+che viene confrontata con ogni record
+in input. Se la corrispondenza esiste, si dice che il modello @dfn{individua}
+il record in input. Una tipica espressione di ricerca potrebbe confrontare
+il record in input con un'espressione regolare.
+(@xref{Panoramica sui criteri di ricerca}).
+
address@hidden Espressione logica
+Un'espressione che usa gli operatori logici AND, OR e NOT,
+scritti come @samp{&&}, @samp{||}, e @samp{!} in @command{awk}.
+Spesso chiamate espressioni booleane, dal nome del matematico che per primo
+ha sistematizzato questo tipo di logica matematica.
+
address@hidden Espressione regolare
+un'espressione regolare (abbreviabile come address@hidden'') @`e un modello che
+descrive un assieme di stringhe, potenzialmente illimitato. Per esempio
+l'espressione regolare
address@hidden corrisponde a qualsiasi stringa che inizia con la lettera
address@hidden e termina con le lettere @samp{xp}. In @command{awk}, le
espressioni
+regolari sono usate nei modelli [pattern] e nelle espressioni condizionali.
+Le espressioni regolari possono contenere sequenze di protezione.
address@hidden
+(@xrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+(@xref{Espressioni regolari}).
address@hidden ifnottex
+
address@hidden Espressione regolare calcolata
+Si veda ``Espressioni regolari dinamiche''.
+
address@hidden Espressione regolare costante
+Un'espressione regolare costante @`e un'espressione regolare scritta tra barre,
+come @code{/pippo/}. A una tale espressione viene assegnato un valore quando
+si scrive un programma @command{awk} e non address@hidden essere modificata in
fase di
+esecuzione del programma. (@xref{Uso di @dfn{regexp}}.)
+
address@hidden Espressione regolare dinamica
+Un'espressione regolare dinamica @`e un'espressione regolare scritta come
+un'espressione normale. Potrebbe essere una costante stringa, come
address@hidden"pippo"}, ma potrebbe anche essere un'espressione il cui valore
@`e variabile
+(@xref{Espressioni regolari calcolate}).
+
address@hidden Espressione tra parentesi quadre
+All'interno di una @dfn{espressione regolare}, un'espressione racchiusa
+fra parentesi quadre sta a indicare che un singolo carattere appartiene
+a una specifica classe di caratteri. Un'espressione tra parentesi quadre
address@hidden contenere una lista di uno o address@hidden caratteri, come
@samp{[abc]}, un
+intervallo di caratteri, come @samp{[A-Z]}, o un nome, delimitato da
address@hidden:}, che designa un insieme di caratteri conosciuto, come
address@hidden:digit:]}. La forma di espressione tra parentesi quadre
+racchiusa tra @samp{:} @`e indipendente dalla rappresentazione binaria dei
+caratteri stessi, che potrebbe utilizzare le codifiche ASCII, EBCDIC, o
+Unicode, a seconda dell'architettura del computer, e della localizzazione.
+Si veda anche ``Espressioni regolari''.
+
address@hidden Espressione tra parentesi quadre complementata
+La negazione di una @dfn{espressione tra parentesi quadre}. Tutto
address@hidden che
address@hidden @`e descritto da una data espressione tra parentesi quadre.
+Il simbolo @samp{^} precede l'espressione tra parentesi quadre che viene
+negata. Per esempio: @samp{[[^:digit:]}
+designa qualsiasi carattere che non sia una cifra. @samp{[^bad]}
+designa qualsiasi carattere che non sia una delle lettere @samp{b}, @samp{a},
+o @samp{d}.
+Si veda ``Espressione tra parentesi quadre''.
+
address@hidden Estensione
+Una address@hidden aggiunta o una modifica a un linguaggio di programmazione
+o a un programma di address@hidden, non definita dallo standard di quel
linguaggio
+o di quel programma di address@hidden
address@hidden ha molte estensioni rispetto al POSIX @command{awk} (fin
+troppe).
+
address@hidden FDL
+Free Documentation License. Si veda ``Licenza Documentazione Libera''.
+
address@hidden File speciale
+Un @value{FN} interpretato internamente da @command{gawk}, invece che
+gestito direttamente dal sistema operativo in cui viene eseguito
address@hidden esempio, @file{/dev/stderr}.
+(@xref{File speciali}).
+
address@hidden Flag [Indicatore]
+Una variabile [di tipo booleano] che, se verificata, indica la presenza o
+l'assenza di qualche condizione.
+
address@hidden Formato
+Le stringhe di formato controllano il modo in cui le funzioni
address@hidden()}, @code{sprintf()} e l'istruzione @code{printf} visualizzano
+l'output che producono. Inoltre, le conversioni da numeri a stringhe sono
+controllate dalle stringhe di formato contenute nelle variabili predefinite
address@hidden e @code{OFMT}. (@xref{Lettere di controllo}).
+
address@hidden formattatore incredibilmente duttile (@command{awf})
address@hidden programma @command{awf} (formattatore incredibilmente duttile)
address@hidden Formattatore incredibilmente duttile (@command{awf})
+Henry Spencer all'address@hidden di Toronto ha scritto un formattatore che
+accetta un ampio sottoassieme dei comandi di formattazione @samp{nroff -ms}
+e @samp{nroff -man} usando
address@hidden e @command{sh}.
+Si address@hidden scaricare da @uref{http://awk.info/?tools/awf}.
+
address@hidden Fortran
+Abbreviazione di FORmula TRANslator (traduttore di formule), @`e uno dei primi
+linguaggi di programmazione, pensato per il calcolo scientifico.
address@hidden stato ideato da John Backus ed @`e disponibile a partire dal
1957. @`E ancora
+in uso ai giorni nostri.
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden Stallman, Richard
address@hidden Free Software Foundation
+Un'organizzazione senza fini di lucro dedicata alla
+produzione e distribuzione di software liberamente distribuibile.
address@hidden stata fondata da Richard M.@: Stallman, l'autore dell'originale
editor
+Emacs. GNU Emacs @`e la versione di Emacs maggiormente usata oggigiorno.
+
address@hidden FSF
+Si veda ``Free Software Foundation''.
+
address@hidden Funzione
+Una parte di un programma @command{awk} che si address@hidden chiamare da
qualsiasi
+punto del programma, per eseguire un compito. @command{awk} ha parecchie
+funzioni predefinite.
+Gli utenti possono definire essi stessi delle funzioni in qualsiasi parte
+del programma. Le funzioni possono essere ricorsive, ossia possono
+chiamare se stesse.
address@hidden
address@hidden
address@hidden iftex
address@hidden
address@hidden
address@hidden ifnottex
+In @command{gawk} @`e anche possibile avere funzioni condivise tra diversi
+programmi, incluse secondo address@hidden usando la direttiva
address@hidden@@include}
+(@pxref{Includere file}).
+In @command{gawk} il nome della funzione da chiamare address@hidden essere
generato
+in fase di esecuzione, ossia in maniera dinamica.
+L'estensione API di @command{gawk} fornisce funzioni di costruzione
+(@pxref{Funzioni di costruzione}).
+
address@hidden Funzioni predefinite
+Il linguaggio @command{awk} fornisce funzioni predefinite, che compiono
+calcoli vari, di tipo numerico, di input/output e di tipo carattere. Esempi
+sono @code{sqrt()} ([square root], la radice quadrata di un numero) e
address@hidden()} (che estrae una sottostringa da una stringa).
address@hidden fornisce funzioni per la gestione di data e ora,
+le operazioni a livello di bit, l'ordinamento di
+vettori, il controllo di tipo [di variabile] e la traduzione di stringhe
+in fase di esecuzione di progranna.
+(@xref{Funzioni predefinite}).
+
address@hidden @command{gawk}
+L'implementazione GNU di @command{awk}.
+
address@hidden GPL (General Public License)
address@hidden General Public License (GPL)
address@hidden GNU General Public License
address@hidden General Public License
+Un documento che descrive le condizioni alle quali @command{gawk} e i suoi
+file sorgenti possono essere distribuiti. (@xref{Copia}).
+
address@hidden GMT
+``Greenwich Mean Time''.
+Il termine tradizionalmente usato per UTC.
address@hidden la datazione usata internamente dai sistemi Unix e POSIX.
+Si veda anche ``Epoca'' e ``UTC''.
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden Progetto GNU
address@hidden GNU
+``GNU's not Unix'' (GNU non @`e Unix).
+Un progetto della Free Software Foundation, ancora in corso, che mira a creare
+un ambiente di calcolo completo, liberamente distribuibile, aderente allo
+standard POSIX.
+
address@hidden GNU/Linux
+Una variante del sistema GNU che usa il kernel Linux,
+invece del kernel proprio della Free Software Foundation, noto come Hurd.
+Il kernel Linux @`e un clone di Unix stabile, efficiente, completo di tutte le
address@hidden, ed @`e stato portato su varie architetture hardware.
address@hidden molto diffuso su sistemi del tipo dei Personal Computer, ma
funziona bene
+anche in parecchi altri computer.
+Il codice sorgente del kernel Linux @`e disponibile nei termini della GNU
General
+Public License, la qual cosa @`e forse il suo aspetto address@hidden rilevante.
+
address@hidden GPL
+Si veda ``General Public License''.
+
address@hidden Graffe
+I caratteri @address@hidden e @address@hidden Le parentesi graffe sono usate
in
address@hidden per delimitare azioni, istruzioni composte, e il codice che
+costituisce le funzioni.
+
address@hidden Guidato dai dati
+Una descrizione dei programmi @command{awk}, nei quali si specifica quali sono
+i dati che si vogliono elaborare, e cosa fare quando si trovano tali dati.
+
address@hidden I/O
+Abbreviazione per ``Input/Output,'' ovvero il trasferimento di dati da e verso
+un programma in esecuzione.
+
address@hidden Individuazione
+L'azione che consiste nel confrontare una stringa con un'espressione regolare.
+Se la @dfn{regexp} descrive qualcosa che @`e contenuto nella stringa, si dice
che
+la @dfn{individua}.
+
address@hidden Internazionalizzazione
+La procedura con cui si scrive o si modifica un programma
+in modo che possa inviare messaggi in lingue differenti, senza richiedere
+ulteriori modifiche al codice sorgente.
+
address@hidden Intero
+Un numero intero, address@hidden un numero che non ha una parte frazionaria.
+
address@hidden programmi interpretati
address@hidden Interprete
+Un programma che accetta come input del codice sorgente, e usa le
+istruzione contenute nello stesso per elaborare dati e fornire risultati.
address@hidden @`e tipicamente (ma non sempre) implementato come un interprete.
+Si veda anche ``Compilatore''.
+
address@hidden Intervallo (nelle righe di input)
+Una sequenza di righe consecutive nel/nei file in input. Un'espressione di
+ricerca address@hidden specificare intervalli di righe di input da far
elaborare ad
address@hidden oppure address@hidden specificare singole righe.
+(@xref{Panoramica sui criteri di ricerca}).
+
address@hidden ISO
address@hidden ISO
+Acronimo di International Organization for Standardization.
+Questo ente elabora degli standard internazionali in vari settori, inclusi i
+linguaggi di programmazione, come il C e il C++.
+In ambito informatico, standard importanti come quelli per il C, C++, e POSIX
+sono allo stesso tempo standard nazionali americani e standard internazionali
+ISO.
+In questo @value{DOCUMENT} lo Standard C @`e chiamato ``ISO C''.
+Si veda @uref{http://www.iso.org/iso/home/about.htm, il sito web ISO} per
+ulteriori informazioni sul nome dell'ente e sul suo acronimo di tre lettere,
+che rimane lo stesso in tutte le lingue.
+
address@hidden Istruzione
+Un'espressione all'interno di un programma @command{awk} nella parte
+"azione" di una regola @dfn{criterio di ricerca--azione}, o all'interno
+di una funzione @command{awk}. Un'espressione address@hidden essere un
assegnamento
+di variabile, un'operazione su un vettore, un ciclo, etc.
+
address@hidden Istruzione composta
+Una serie di istruzioni @command{awk}, racchiuse tra parentesi graffe.
+Le istruzioni composte possono essere nidificate [possono esserci
address@hidden livelli
+di parentesi graffe].
+(@xref{Istruzioni}).
+
address@hidden Istruzione di controllo
+Un'istruzione di controllo @`e un'istruzione per eseguire una data operazione
+o un insieme di operazioni all'interno di un programma @command{awk},
+se una determinata condizione @`e verificata.
+Istruzioni di controllo sono: @code{if}, @code{for}, @code{while}, e @code{do}
+(@pxref{Istruzioni}).
+
address@hidden Java, linguaggio di programmazione
address@hidden linguaggio di programmazione, Java
address@hidden Java
+Un moderno linguaggio di programmazione originalmente sviluppato da Sun
+Microsystems (ora Oracle) che prevede la programmazione orientata agli
+oggetti. Sebbene normalmente sia implementato compilando le istruzioni
+per una macchina virtuale standard (la JVM---Java Virtual Machine) il
+linguaggio address@hidden essere compilato per essere eseguito in maniera
nativa.
+
address@hidden Korn Shell
+La Korn Shell (@command{ksh}) @`e una shell Unix sviluppata da David Korn,
+presso i Bell Laboratories, nei primi anni '80. La Korn shell @`e
+compatibile all'indietro con la Bourne shell e comprende molte address@hidden
+presenti nella C Shell.
+Si veda anche ``Bourne Shell''.
+
address@hidden LDL
+Si veda ``Licenza Documentazione Libera''.
+
address@hidden LGPL (Lesser General Public License)
address@hidden Lesser General Public License (LGPL)
address@hidden GNU Lesser General Public License
address@hidden Lesser General Public License
+Questo documento descrive i termini nei quali possono essere distribuiti
+degli archivi contenenti librerie in formato eseguibile o oggetti condivisi,
+e il relativo codice sorgente.
+
address@hidden LGPL
+Si veda ``Lesser General Public License''.
+
address@hidden Licenza Documentazione Libera
+Questo documento descrive i termini in base ai quali questo @value{DOCUMENT}
address@hidden pubblicato e address@hidden essere copiato.
+(@xref{Licenza per Documentazione Libera GNU (FDL)}).
+
address@hidden Linguaggio @command{awk}
+Il linguaggio in cui i programmi @command{awk} sono scritti.
+
address@hidden Linux
+Si veda ``GNU/Linux''.
+
address@hidden Lista di caratteri
+Si veda ``Espressione tra parentesi quadre''.
+
address@hidden Localizzazioni
+La address@hidden che fornisce i dati necessari perch@'e un programma
+internazionalizzato interagisca con l'utente in un particolare linguaggio.
+
address@hidden @dfn{Lvalue}
+[left-value, ossia valore a sinistra] Un'espressione che address@hidden stare
alla
+sinistra di un operatore di assegnamento.
+Nella maggior parte dei linguaggi, gli @dfn{lvalue} possono essere variabili o
+elementi di un vettore. In @command{awk}, un designatore di campo
address@hidden anche
+essere usato come un @dfn{lvalue}.
+
address@hidden Marcatura temporale
+Un valore nel formato ``secondi a partire dall'epoch'' usato dai sistemi Unix
+e POSIX. Usato per le funzioni @command{gawk}
address@hidden()}, @code{strftime()}, e @code{systime()}.
+Si veda anche ``Epoca,'' ``GMT,'' e ``UTC''.
+
address@hidden Metacaratteri
+Caratteri usati all'interno di una @dfn{regexp} e che non rappresentano se
+stessi.
+Servono invece per rappresentare operazioni con espressioni regolari, come
+per esempio delle ripetizioni, dei raggruppamenti, o delle alternanze.
+
address@hidden Nidificazione
+Una nidificazione si riscontra dove l'informazione @`e organizzata a strati,
+o dove degli oggetti contengono altri oggetti simili.
+In @command{gawk} la direttiva @code{@@include}
address@hidden essere nidificata. La nidificazione ``naturale'' delle operazioni
+aritmetiche e logiche address@hidden essere modificato attraverso l'uso di
parentesi.
+(@pxref{Precedenza}).
+
address@hidden No-op
+Un'operazione che non fa nulla.
+
address@hidden Numero
+Un dato oggetto il cui valore @`e numerico. Le implementazioni di @command{awk}
+usano numeri a virgola mobile in doppia precisione per rappresentare i numeri.
+Le primissime implementazioni di @command{awk} usavano numeri a virgola mobile
+in singola precisione.
+
address@hidden Numero a virgola mobile
+Spesso descritto, in termini matematici, come un numero ``razionale'' o reale,
address@hidden soltanto un numero che address@hidden avere una parte
frazionaria.
+Si veda anche ``Doppia precisione'' e ``Singola precisione''.
+
address@hidden Operatori di espressioni regolari
+Si veda ``Metacaratteri''.
+
address@hidden Ottale
+Notazione avente come base 8, nella quale le cifre sono @address@hidden
+I numeri ottali in C sono scritti premettendo uno @samp{0},
+per indicare la base. Quindi, @code{013} @`e 11 ((1 x 8) + 3).
address@hidden non-decimali}.
+
address@hidden Parentesi Graffe
+Si veda ``Graffe''.
+
address@hidden Parola chiave
+nel linguaggio @command{awk}, una parola chiave (keyword) @`e una parola
+che ha un significato speciale. Queste parole sono riservate e non possono
+essere usate come nomi di variabili.
+
+Le parole chiave di @command{gawk} sono:
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
address@hidden,
address@hidden@dots{}while},
address@hidden,
address@hidden,
address@hidden@dots{}in},
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+e
address@hidden
+
address@hidden PEBKAC
+Un acronimo inglese che descrive qual @`e probabilmente la causa
address@hidden frequente
+di problemi nell'uso di un computer. (@dfn{Problem Exists Between Keyboard and
+Chair} [il problema si trova tra la tastiera e la sedia].)
+
address@hidden Percorso di ricerca
+In @command{gawk}, una lista di directory in cui cercare file contenenti del
+codice sorgente per @command{awk}.
+Nella shell, una lista di directory in cui ricercare un programma eseguibile.
+
address@hidden Plug-in
+Si veda ``Estensione''.
+
address@hidden POSIX
+Il nome di una serie di standard che specificano l'interfaccia di un Sistema
+Operativo Portabile (Portable Operating System). La ``IX'' specifica
+che questi standard sono stati originati dallo Unix.
+Lo standard address@hidden rilevante per gli utenti @command{awk} @`e lo
address@hidden Standard for Information Technology, Standard 1003.1-2008}.
+Lo standard POSIX 2008 address@hidden essere trovato in rete all'indirizzo:
address@hidden://www.opengroup.org/onlinepubs/9699919799/}.
+
address@hidden Precedenza
+L'ordine in cui le operazioni sono eseguite quando si usano degli operatori
+se non si stabiliscono precedenze per mezzo di parentesi.
+
address@hidden Private
+Variabili e/o funzioni che sono riservate all'uso esclusivo di funzioni di
+libreria, e non per il programma principale @command{awk}. Un'attenzione
+particolare va prestata quando si desigano tali variabili e funzioni.
+(@xref{Nomi di variabili di libreria}).
+
address@hidden Programma @command{awk}
+Un programma @command{awk} consiste in una serie di @dfn{espressioni di
+ricerca} e @dfn{azioni}, che formano delle @dfn{regole}. Per ogni record in
+input a un progranna, le regole del programma sono elaborate nell'ordine in
+cui sono scritte. I programmi
address@hidden possono anche contenere definizioni di funzioni.
+
address@hidden Record
+Si veda ``Record in input'' e ``Record in output''.
+
address@hidden Record in input
+Una singola parte di dati letta da @command{awk}. Solitamente, un
+record in input di @command{awk} consiste in una linea di testo.
+(@xref{Record}).
+
address@hidden Record in output
+Un singolo pezzo di dati scritto da @command{awk}. Solitamente, un
+record in output di @command{awk} consiste di una o address@hidden righe di
testo.
address@hidden
+
address@hidden Ricorsione
+Quando una funzione chiama se stessa, direttamente o indirettamente.
+Se questo @`e chiaro, si address@hidden passare a leggere la definizione
successiva.
+Altrimenti, si veda la voce ``Ricorsione''.
+
address@hidden @dfn{regexp}
+Si veda ``Espressione regolare''.
+
address@hidden Regola
+Un segmento di un programma @command{awk} che specifica come trattare singoli
+record in input. Una regola consiste in una @dfn{espressione di ricerca} e in
+una @dfn{azione}.
address@hidden legge un record in input; poi, per ogni regola, se il record in
+input soddisfa l'espressione di ricerca della regola, @command{awk} esegue
+l'azione specificata dalla regola.
+Altrimenti, la regola non ha alcun effetto su quel record in input.
+
address@hidden Ridirezione
+Ridirezione significa ricevere input da quaclosa che non sia il flusso dello
+standard input, o dirigere output a qualcosa di diverso dal flusso dello
+standard output.
+
+Si address@hidden ridirigere input all'istruzione @code{getline} usando gli
operatori
address@hidden<}, @samp{|}, e @samp{|&}.
+Si address@hidden ridirigere l'output delle istruzioni @code{print} e
@code{printf} verso
+un file o un comando di sistema, usando gli operatori @samp{>}, @samp{>>},
address@hidden|}, e @samp{|&}.
+(@xref{Getline},
+e @ref{Ridirezione}).
+
address@hidden @dfn{Rvalue}
+[right-value, ossia valore a destra] Un valore che address@hidden apparire
alla destra
+di un operatore di assegnazione.
+In @command{awk}, essenzialmente ogni espressione ha un valore.
+Ognuno di questi valori @`e un @dfn{rvalue}.
+
address@hidden Scalare
+Un valore singolo, sia numerico che di tipo stringa.
+Le variabili normali sono scalari; i vettori e le funzioni non lo sono.
+
address@hidden Scorciatoia
+La natura degli operatori logici @command{awk} @samp{&&} e @samp{||}.
+Se il valore dell'intera espressione in cui sono contenuti @`e determinabile
+valutando solo una parte iniziale dell'espressione, la parte seguente non @`e
+presa in considerazione.
+(@xref{Operatori booleani}).
+
address@hidden @dfn{Script} @command{awk}
+Un altro nome per designare un programma @command{awk}.
+
address@hidden @command{sed}
+Si veda ``Editore di flusso''.
+
address@hidden Seme
+Il valore iniziale, o il punto di partenza, di una sequenza di numeri casuali.
+
address@hidden Sequenze di protezione
+Una speciale sequenza di caratteri usata per descrivere caratteri non
+stampabili, come @samp{\n} (ritorno a capo) o @samp{\033} per il carattere
+ASCII ESC (Escape). (@xref{Sequenze di protezione}).
+
address@hidden Shell
+Il programma che interpreta i comandi nei sistemi Unix e in quelli che
+rispettano lo standard POSIX.
+La shell funziona sia interattivamente che come un linguaggio di
+programmazione, che elabora file sequenziali, detti @dfn{script} di shell.
+
address@hidden Singola precisione
+Una rappresentazione di numeri all'interno del computer che ha una parte
+espressa sotto forma di frazione. I numeri a singola precisione hanno meno
+cifre significative di quelli a doppia precisione, ma le operazioni relative
+richiedono talora meno risorse elaborative da parte del computer.
+Questo tipo di numero @`e quello usato da alcune tra le prime versioni di
address@hidden per memorizzare valori numerici. Nel linguaggio C, sono numeri
+di tipo @code{float}.
+
address@hidden Spazio
+Il carattere generato premendo la barra spaziatrice sulla tastiera.
+
address@hidden Spazio vuoto
+Una sequenza di spazi, TAB, o caratteri di ritorno a capo presenti in un
+record in input o in una stringa.
+
address@hidden Stringa
+Un dato che consiste in una sequenza di caratteri, come @samp{Io sono una
+stringa}. Le costanti stringa sono scritte tra doppi apici nel linguaggio
address@hidden e possono contenere sequenze di protezione
+(@xref{Sequenze di protezione}).
+
address@hidden Stringa nulla
+Una stringa che non contiene alcun carattere. @`E rappresentabile
+esplicitamente nei programmi @command{awk} mettendo due caratteri di
+doppio apice uno dietro all'altro (@code{""}). La si address@hidden inserire
nei dati
+in input mettendo due separatori di campo uno dietro all'altro.
+
address@hidden Stringa vuota
+Si veda ``Stringa nulla''.
+
address@hidden Tab
+Il carattere generato premendo il tasto @kbd{TAB} sulla tastiera.
+Normalmente address@hidden generare sino a otto spazi in output.
+
address@hidden Linux
address@hidden GNU/Linux
address@hidden Unix
address@hidden sistemi operativi basati su BSD
address@hidden NetBSD
address@hidden FreeBSD
address@hidden OpenBSD
address@hidden Unix
+Un sistema operativo per computer originalmente sviluppato nei primi anni '70
+presso gli AT&T Bell Laboratories. Inizialmente si diffuse nelle
address@hidden
+di tutto il mondo e in seguito si estese agli ambienti del mondo del lavoro
+come un sistema per lo sviluppo del software e come server di rete.
+Ci sono parecchie versioni di Unix a pagamento, come pure parecchi sistemi
+operativi modellati su Unix e il cui codice sorgente @`e liberamente
+disponibile. (come GNU/Linux, @uref{http://www.netbsd.org, NetBSD},
address@hidden://www.freebsd.org, FreeBSD}, e
address@hidden://www.openbsd.org, OpenBSD}).
+
address@hidden UTC
+L'abbreviazione comune per ``Universal Coordinated Time'' (tempo coordinato
+universale). Questa @`e l'ora standard di Greenwich, (UK), usata come tempo
+di riferimento per i calcoli relativi a marcature temporali.
+Si veda anche ``Epoca'' e ``GMT''.
+
address@hidden Variabile
+Un nome per designare un valore. In @command{awk}, le variabili possono
+essere degli scalari o dei vettori.
+
address@hidden Variabili d'ambiente
+Una collezione di stringhe, in formato @address@hidden@var{valore}}, che
+ogni programma ha a disposizione. Gli utenti in generale assegnano valori
+alle variabili d'ambiente per fornire informazioni a vari programmi.
+Esempi tipici sono le variabili d'ambiente @env{HOME} e @env{PATH}.
+
address@hidden Variabili predefinite
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+e
address@hidden
+sono le variabili con un significato speciale in @command{awk}.
+In address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+e
address@hidden
+sono le variabili con un significato speciale in @command{gawk}.
+Se i loro valori sono modificati, il contesto di esecuzione di @command{awk}
+cambia.
+(@xref{Variabili predefinite}).
+
address@hidden Vettore
+Un raggruppamento di molti valori con uno stesso nome.
+La maggior parte dei linguaggi fornisce solo vettori sequenziali.
address@hidden fornisce vettori associativi.
+
address@hidden Vettore associativo
+Un vettore i cui indici possono essere numeri o stringhe, e non solamente
+interi sequenziali compresi in un intervallo prestabilito.
+
address@hidden table
+
address@hidden ifclear
+
address@hidden The GNU General Public License.
+
address@hidden Copia
address@hidden Licenza Pubblica Generale GNU (GPL)
address@hidden
address@hidden Versione 3, 29 Giugno 2007
address@hidden ifnotdocbook
address@hidden
+<subtitle>Versione 3, 29 Giugno 2007</subtitle>
address@hidden docbook
+
address@hidden This file is intended to be included within another document,
address@hidden hence no sectioning command or @node.
+
address@hidden
+Copyright @copyright{} 2007 Free Software Foundation, Inc.
@url{http://fsf.org/}
+
+This is an unofficial translation of the GNU General Public License into
+Italian. It was not published by the Free Software Foundation, and does not
+legally state the distribution terms for software that uses the GNU GPLâonly
+the original English text of the GNU GPL does that. However, we hope that this
+translation will help Italian speakers understand the GNU GPL better.
+
+Questa @`e una traduzione non ufficiale in italiano della GNU General Public
+License. Questa traduzione non @`e stata pubblicata dalla Free Software
+Foundation, e non stabilisce i termini legali di distribuzione del software
+che usa la GNU GPL. Soltanto la versione originale in inglese della GNU GPL
+fa address@hidden Ciononostante, speriamo che questa traduzione possa aiutare
gli utenti
+di lingua italiana a comprendere un po' meglio la GNU GPL.
+
+A chiunque @`e permesso copiare e ridistribuire copie esatte di questo
documento
+di licenza, ma non @`e in alcun modo consentito apportarvi modifiche.
address@hidden display
+
address@hidden fakenode --- for prepinfo
address@hidden Preambolo
+
+La GNU General Public License @`e una licenza libera e basata su copyleft per
+software e altri tipi di opere.
+
+Le licenze della maggior parte del software e di altre opere materiali sono
+pensate per togliere la address@hidden di condividere e modificare tali opere.
Al
+contrario, la GNU General Public License ha l'obiettivo di garantire la
address@hidden di condividere e modificare tutte le versioni di un programma e
di
+fare in modo che esso rimanga software libero per tutti gli utenti. Noi, Free
+Software Foundation, usiamo la GNU General Public License per la maggior parte
+del nostro software; essa viene applicata anche a qualunque altro software
+rilasciato dall'autore sotto questa licenza. Chiunque address@hidden
utilizzare questa
+licenza per i suoi programmi.
+
+Quando parliamo di software libero (free software), ci riferiamo al concetto
+di address@hidden, non al prezzo. Le nostre General Public License sono
progettate
+per garantire che chiunque abbia la address@hidden di distribuire copie di
software
+libero (anche dietro pagamento di un prezzo, se lo desidera), che chiunque
+riceva o possa ricevere il codice sorgente se lo vuole, che chiunque possa
+apportare modifiche al software o utilizzarne delle porzioni in altri software
+liberi, e che chiunque sappia che ha il diritto di fare tutte queste cose col
+software libero.
+
+Per proteggere i vostri diritti, abbiamo la address@hidden di impedire che
altri vi
+neghino questi diritti o vi obblighino a rinunciarvi. Pertanto, chiunque
+distribuisce o modifica software rilasciato con questa licenza assume dei
+precisi doveri: il dovere di rispettare la address@hidden degli altri.
+
+Per esempio, chi distribuisce copie di un programma rilasciato sotto questa
+licenza, sia gratis che dietro pagamento di un prezzo, e' obbligato a
+riconoscere a chi riceve il software esattamente gli stessi diritti che ha
+ricevuto. Deve garantire che chi riceva il software abbia o possa avere
+accesso al codice sorgente. E deve chiaramente far conoscere ai destinatari
+del software queste condizioni, address@hidden@dotless{i}} che essi conoscano
quali sono i loro
+diritti.
+
+Gli sviluppatori che usano la GNU GPL proteggono i vostri diritti in due modi:
+(1) Rivendicando il copyright sul software, e (2) offrendovi questa licenza
+che vi garantisce il diritto legale di copiarlo e/o di modificarlo.
+
+Al fine di proteggere gli sviluppatori e gli autori, la GPL spiega chiaramente
+che non c'@`e nessuna garanzia per questo software libero. Nell'interesse degli
+utenti e degli autori, la GPL impone che le versioni modificate del software
+vengano esplicitamente marcate come ``modificate'', in maniera tale che
+eventuali problemi non vengano erroneamente attribuiti agli autori delle
+versioni precedenti.
+
+Alcuni dispositivi sono progettati per negare agli utenti l'installazione o
+l'esecuzione di versioni modificate del software che gira sugli stessi, anche
+se il costruttore si riserva la address@hidden di farlo. address@hidden @`e
fondamentalmente
+incompatibile con l'obiettivo di garantire la address@hidden degli utenti di
+modificare il software. Una ripetizione sistematica di tali abusi avviene nel
+campo dei dispositivi per usi individuali, e address@hidden rende questi abusi
ancora address@hidden
+inaccettabili. Pertanto, abbiamo realizzato questa versione della GPL al fine
+di proibire queste pratiche. Se problemi simili dovessero sorgere in altri
+ambiti, saremo pronti ad estendere queste misure a questi nuovi ambiti in
+versioni future della GPL, nella maniera che si address@hidden necessaria per
+difendere la address@hidden degli utenti.
+
+In conclusione, tutti i programmi sono costantemente minacciati dai brevetti
+sul software. Gli Stati non dovrebbero permettere ai brevetti sul software di
+limitare lo sviluppo e l'utilizzo di software per computer, ma nei Paesi in
+cui address@hidden avviene noi vogliamo evitare in particolare il pericolo che
i brevetti
+sul software applicati ad un programma libero possano renderlo, a tutti gli
+effetti, proprietario. Per impedire address@hidden, la GPL assicura che non
@`e possibile
+utilizzare i brevetti sul software per rendere un programma non libero.
+
+I termini e le condizioni esatte per la copia, la distribuzione e la modifica
+del software sono riportate di seguito.
+
address@hidden fakenode --- for prepinfo
address@hidden TERMINI E CONDIZIONI
+
address@hidden 0
address@hidden Definizioni
+
+``Questa Licenza'' si riferisce alla versione 3 della GNU General Public
+License.
+
+``Copyright'' indica anche leggi simili al copyright che riguardano altri tipi
+di opere, come le maschere per la produzione di semiconduttori.
+
+``Il Programma'' indica qualunque opera che sia soggetta a copyright e che sia
+rilasciata sotto questa Licenza. I detentori della licenza sono indicati come
+``tu'' o ``voi''. Licenziatari e destinatari possono essere individui o
+organizzazioni.
+
+``Modificare'' un'opera significa copiare o adattare tutta o parte dell'opera
in
+una maniera che richieda un permesso di copyright, e non indica la semplice
+azione di fare una esatta copia dell'opera. L'opera risultante viene chiamata
+``versione modificata'' dell'opera precedente, oppure viene detta opera
``basata
+sulla'' opera precedente.
+
+Una ``opera coperta da questa licenza'' indica il Programma originale non
+modificato oppure un'opera basata sul Programma.
+
+``Propagare'' un'opera significa fare qualunque cosa con essa che, in mancanza
+di un esplicito permesso, ti renda direttamente o indirettamente perseguibile
+per violazione secondo le vigenti normative sul copyright, ad eccezione della
+semplice esecuzione del Programma su un computer o della modifica di una copia
+privata. La Propagazione include la copia, la distribuzione (con o senza
+modifiche), la messa a disposizione al pubblico e, in alcuni stati, altre
address@hidden simili e connesse.
+
+``Distribuire'' un'opera indica qualunque forma di propagazione che permetta a
+terze parti di effettuare o ricevere delle copie. La mera interazione con un
+utente attraverso una rete di computer, senza che ci sia alcun trasferimento
+di una copia, non @`e considerata ``Distribuzione''.
+
+Una interfaccia utente interattiva fornisce delle ``Adeguate Informazioni
+Legali'' soltanto nel caso in cui include una apposita address@hidden, resa
+adeguatamente visibile, che (1) visualizzi un'adeguata informazione di
+copyright, e (2) informi l'utente che non c'@`e alcuna garanzia sull'opera
+(eccetto nel caso in cui delle garanzie sono espressamente fornite), dica che
+il licenziatario address@hidden distribuire l'opera utilizzando questa
Licenza, indichi
+come @`e possibile prendere visione di una copia di questa Licenza. Se
+l'interfaccia presenta una lista di comandi o di opzioni, come per esempio un
address@hidden, una delle opzioni fornite nella lista deve rispettare questa
condizione.
+
address@hidden Codice Sorgente
+
+Il ``codice sorgente'' di un'opera indica la forma address@hidden indicata
dell'opera per
+effettuare modifiche su di essa. Il ``codice oggetto'' indica qualunque forma
+dell'opera che non sia codice sorgente.
+
+Una ``Interfaccia Standard'' @`e una interfaccia che risponde ad uno standard
+ufficiale definito da un ente di standardizzazione riconosciuto o, nel caso di
+interfacce specifiche per un particolare linguaggio di programmazione, una
+interfaccia che @`e largamente utilizzata dagli sviluppatori per sviluppare in
+tale linguaggio.
+
+Le ``Librerie di Sistema'' di un eseguibile includono qualsiasi cosa, eccetto
+l'opera nel suo insieme, che (a) sia inclusa nella normale forma di
+pacchettizzazione di un ``Componente Principale'', ma che non @`e parte di quel
+Componente Principale, e (b) che serva solo a consentire l'uso dell'opera con
+quel Componente Principale, o per implementare una Interfaccia Standard per la
+quale esista una implementazione disponibile al pubblico in forma sorgente. Un
+``Componente Principale'', in questo contesto, @`e un componente essenziale
+(kernel, gestore di finestre eccetera) dello specifico sistema operativo
+(ammesso che ce ne sia uno) sul quale l'eseguibile esegue, o un compilatore
+utilizzato per produrre il programma, o un interprete di codice oggetto
+utilizzato per eseguire il programma.
+
+Il ``Sorgente Corrispondente'' per un'opera in forma di codice oggetto @`e il
+codice sorgente necessario per generare, installare e (per un programma
+eseguibile) eseguire il codice oggetto e per modificare l'opera, inclusi gli
+script per controllare le suddette address@hidden di generazione,
installazione ed
+esecuzione. Non sono incluse le Librerie di Sistema usate dal programma, o gli
+strumenti di address@hidden generica o i programmi liberamente accessibili che
sono
+utilizzati, senza modifiche, per portare a termine le suddette address@hidden
ma che
+non fanno parte dell'opera. Per esempio, il sorgente corrispondente include i
+file con le definizioni delle interfacce associati ai file sorgente
+dell'opera, e il codice sorgente delle librerie condivise e sottoprogrammi
+collegati dinamicamente specificatamente necessari per il programma, ad
+esempio a causa di stretta comunicazione dati o di controllo di flusso tra
+questi sottoprogrammi e altre parti del programma.
+
+Il Sorgente Corrispondente non include qualunque cosa che l'utente possa
+rigenerare automaticamente da altre parti del Sorgente Corrispondente stesso.
+
+Il Sorgente Corrispondente di un'opera in forma di codice sorgente @`e l'opera
+stessa.
+
address@hidden Principali Diritti
+
+Tutti i diritti garantiti da questa Licenza sono garantiti per la durata del
+copyright sul Programma, e sono irrevocabili ammesso che le suddette
+condizioni siano rispettate. Questa Licenza afferma esplicitamente il tuo
+permesso illimitato di eseguire il Programma non modificato. Il risultato
+dell'esecuzione di un programma coperto da questa Licenza @`e a sua volta
+coperto da questa Licenza solo se il risultato stesso, a causa del suo
+contenuto, @`e un'opera coperta da questa Licenza. Questa Licenza riconosce il
+tuo diritto all'uso legittimo o altri diritti equivalenti, come stabilito
+dalla legislazione sul copyright.
+
+Puoi creare, eseguire e propagare programmi coperti da questa Licenza che tu
+non distribuisci, senza alcuna condizione fino a quando la tua Licenza rimane
+valida. Puoi distribuire opere coperte da questa Licenza ad altri al solo
+scopo di ottenere che essi facciano delle modifiche al programma
+esclusivamente per te, o che ti forniscano dei servizi per l'esecuzione di
+queste opere, ammesso che tu rispetti i termini di questa Licenza nel
+distribuire tutto il materiale per il quale non detieni il copyright. Coloro i
+quali creano o eseguono per conto tuo un programma coperto da questa Licenza
+lo fanno esclusivamente in tua vece, sotto la tua direzione e il tuo
+controllo, in maniera tale che sia proibito a costoro effettuare copie di
+materiale di cui detieni il copyright al di fuori della relazione che
+intrattengono nei tuoi confronti.
+
+Distribuire opere coperte da licenza in qualunque altra circostanza @`e
+consentito soltanto alle condizioni espresse in seguito. Non @`e consentito
+sottolicenziare le opere: la sezione 10 lo rende non necessario.
+
address@hidden Protezione dei diritti legali degli utenti dalle leggi
anti-elusione
+
+Nessun programma protetto da questa Licenza address@hidden essere considerato
parte di
+una misura tecnologica di restrizione che sottosta ad alcuna delle leggi che
+soddisfano l'articolo 11 del ``WIPO copyright treaty'' adottato il 20 Dicembre
+1996, o a simili leggi che proibiscono o limitano l'elusione di tali misure
+tecnologiche di restrizione.
+
+Quando distribuisci un programma coperto da questa Licenza, rifiuti tutti i
+poteri legali atti a proibire l'elusione di misure tecnologiche di restrizione
+ammesso che tale elusione sia effettuata nell'esercizio dei diritti garantiti
+da questa Licenza riguardo al programma coperto da questa Licenza, e rinunci
+all'intenzione di limitare l'address@hidden o la modifica del programma per far
+valere, contro i diritti degli utenti del programma, diritti legali tuoi o di
+terze parti che impediscano l'elusione di misure tecnologiche di restrizione.
+
address@hidden Distribuzione di Copie Esatte
+
+Ti @`e permesso distribuire copie esatte del codice sorgente del Programma come
+lo hai ricevuto, con qualunque mezzo, ammesso che tu aggiunga in maniera
+appropriata su ciascuna copia una appropriata nota di copyright; che tu lasci
+intatti tutti gli avvisi che affermano che questa Licenza e tutte le clausole
+non-permissive aggiunte in accordo con la sezione 7 sono valide per il codice
+che distribuisci; che tu lasci intatti tutti gli avvisi circa l'assenza di
+garanzia; che tu fornisca a tutti i destinatari una copia di questa Licenza
+assieme al Programma.
+
+Puoi richiedere il pagamento di un prezzo o di nessun prezzo per ciascuna
+copia che distribuisci, e puoi offrire supporto o garanzia a pagamento.
+
address@hidden Distribuzione di Versioni modificate del sorgente
+
+Puoi distribuire un'opera basata sul Programma, o le modifiche per produrla a
+partire dal Programma, nella forma di codice sorgente secondo i termini della
+sezione 4, ammesso che tu rispetti anche tutte le seguenti condizioni:
+
address@hidden a
address@hidden
+L'opera deve recare con address@hidden delle informazioni adeguate che
affermino che tu
+l'hai modificata, indicando la data di modifica.
+
address@hidden
+L'opera deve recare informazioni adeguate che affermino che essa @`e rilasciata
+sotto questa Licenza e sotto le condizioni aggiuntive secondo quanto indicato
+dalla Sezione 7. Questa condizione modifica la condizione espressa alla
+sezione 4 di ``lasciare intatti tutti gli avvisi''.
+
address@hidden
+Devi rilasciare l'intera opera, nel suo complesso, sotto questa Licenza a
+chiunque venga in possesso di una copia di essa. Questa Licenza address@hidden
pertanto
+applicata, assieme ad eventuali clausole aggiunte in osservanza della Sezione
+7, all'opera nel suo complesso, a tutte le sue parti, indipendentemente da
+come esse siano pacchettizzate. Questa Licenza nega il permesso di licenziare
+l'opera in qualunque altro modo, ma non rende nullo un tale permesso ammesso
+che tu lo abbia ricevuto separatamente.
+
address@hidden
+Se l'opera ha delle interfacce utente interattive, ciascuna deve mostrare
+delle Adeguate Informazioni Legali; altrimenti, se il Programma ha delle
+interfacce interattive che non visualizzano delle Adeguate Informazioni
+Legali, il tuo programma non @`e obbligato a visualizzarle.
address@hidden enumerate
+
+La giustapposizione di un'opera coperta da questa Licenza assieme ad altre
+opere separate e indipendenti, che non sono per loro natura estensioni del
+Programma, e che non sono combinate con esso a formare un altro programma
address@hidden
+grande, dentro o in uno stesso supporto di memorizzazione a lungo termine o di
+distribuzione, @`e semplicemente detto ``aggregato'' se la raccolta e il suo
+copyright non sono utilizzati per limitare l'accesso o i diritti legali degli
+utenti della raccolta stessa oltre address@hidden che ciascun singolo
programma consente.
+L'inclusione di un programma coperto da questa Licenza in un aggregato non
+comporta l'applicazione di questa Licenza alle altre parti dell'aggregato.
+
address@hidden Distribuzione in formato non-sorgente
+
+Puoi distribuire un programma coperto da questa Licenza in formato di codice
+oggetto secondo i termini delle sezioni 4 e 5, ammesso che tu fornisca anche
+il Sorgente Corrispondente in formato comprensibile da un computer sotto i
+termini di questa stessa Licenza, in uno dei seguenti modi:
+
address@hidden a
address@hidden
+Distribuendo il codice oggetto in, o contenuto in, un prodotto fisico (inclusi
+i mezzi fisici di distribuzione), accompagnato dal Sorgente Corrispondente su
+un supporto fisico duraturo comunemente utilizzato per lo scambio di software.
+
address@hidden
+Distribuendo il codice oggetto in, o contenuto in, un prodotto fisico (inclusi
+i mezzi fisici di distribuzione), accompagnato da un'offerta scritta, valida
+per almeno tre anni e valida per tutto il tempo durante il quale tu offri
+ricambi o supporto per quel modello di prodotto, di fornire a chiunque
+possieda il codice oggetto (1) una copia del Sorgente Corrispondente di tutto
+il software contenuto nel prodotto che @`e coperto da questa Licenza, su un
+supporto fisico duraturo comunemente utilizzato per lo scambio di software, ad
+un prezzo non superiore al costo ragionevole per effettuare fisicamente tale
+distribuzione del sorgente, oppure (2) accesso alla copia del Sorgente
+Corrispondente attraverso un server di rete senza alcun costo aggiuntivo.
+
address@hidden
+Distribuendo copie singole del codice oggetto assieme ad una copia
+dell'offerta scritta di fornire il Sorgente Corrispondente. Questa
address@hidden
address@hidden permessa soltanto occasionalmente e per fini non commerciali, e
solo se tu
+hai ricevuto il codice oggetto assieme ad una tale offerta, in accordo alla
+sezione 6b.
+
address@hidden
+Distribuendo il codice oggetto mediante accesso da un luogo designato (gratis
+o dietro pagamento di un prezzo), e offrendo un accesso equivalente al
+Sorgente Corrispondente alla stessa maniera a partire dallo stesso luogo senza
+costi aggiuntivi. Non devi obbligare i destinatari a copiare il Sorgente
+Corrispondente assieme al codice oggetto. Se il luogo dal quale copiare il
+codice oggetto @`e un server di rete, il Sorgente Corrispondente
address@hidden trovarsi su
+un server differente (gestito da te o da terze parti) che fornisca
address@hidden equivalenti per la copia, a patto che tu fornisca delle
+indicazioni chiare accanto al codice oggetto che indichino dove trovare il
+Sorgente Corrispondente. Indipendentemente da quale server ospiti il Sorgente
+Corrispondente, tu rimani obbligato ad assicurare che esso rimanga disponibile
+per tutto il tempo necessario a soddisfare queste condizioni.
+
address@hidden
+Distribuendo il codice oggetto mediante trasmissione peer-to-peer, a patto che
+tu informi gli altri peer circa il luogo in cui il codice oggetto e il
+Sorgente Corrispondente sono gratuitamente offerti al pubblico secondo i
+termini della sezione 6d.
+
address@hidden enumerate
+
+Una porzione separabile del codice oggetto, il cui sorgente @`e escluso dal
+Sorgente Corrispondente e trattato come Libreria di Sistema, non deve essere
+obbligatoriamente inclusa nella distribuzione del codice oggetto del
+programma.
+
+Un ``Prodotto Utente'' @`e un (1) ``prodotto consumer'', address@hidden
qualunque address@hidden
+personale tangibile che @`e normalmente utilizzata per scopi personali,
+familiari o domestici, oppure (2) qualunque cosa progettata o venduta per
+essere utilizzata in ambiente domestico. Nella classificazione di un prodotto
+come ``prodotto consumer'', i casi dubbi andranno risolti in favore dell'ambito
+di applicazione. Per un dato prodotto ricevuto da un dato utente, ``normalmente
+utilizzato'' si riferisce ad un uso tipico o comune di quella classe di
+prodotti, indipendentemente dallo stato dell'utente specifico o dal modo in
+cui l'utente specifico utilizza, o si aspetta o ci si aspetta che utilizzi, il
+prodotto. Un prodotto @`e un ``prodotto consumer'' indipendentemente dal fatto
che
+abbia usi commerciali, industriali o diversi da quelli ``consumer'', a meno che
+questi usi non rappresentino il solo modo utile di utilizzare il prodotto in
+questione.
+
+Le ``Informazioni di Installazione'' per un Prodotto Utente sono i metodi, le
+procedure, le chiavi di autorizzazioni o altre informazioni necessarie per
+installare ed eseguire versioni modificate di un programma coperto da questa
+Licenza all'interno di un Prodotto Utente, a partire da versioni modificate
+dei suoi Sorgenti Corrispondenti. Tali informazioni devono essere sufficienti
+ad assicurare che il funzionamento del codice oggetto modificato non sia in
+nessun caso proibito o ostacolato per il solo fatto che sono state apportate
+delle modifiche.
+
+Se distribuisci un codice oggetto secondo le condizioni di questa sezione in,
+o assieme, o specificatamente per l'uso in o con un Prodotto Utente, e la
+distribuzione avviene come parte di una transazione nella quale il diritto di
+possesso e di uso del Prodotto Utente viene trasferito al destinatario per
+sempre o per un periodo prefissato (indipendentemente da come la transazione
+sia caratterizzata), il Sorgente Corrispondente distribuito secondo le
+condizioni di questa sezione deve essere accompagnato dalle Informazioni di
+Installazione. Questa condizione non @`e richiesta se address@hidden tu
address@hidden una terza parte
+ha la address@hidden di installare versioni modificate del codice oggetto sul
+Prodotto Utente (per esempio, se il programma @`e installato su una ROM)
+
+La condizione che richiede di fornire delle Informazioni di Installazione non
+implica che venga fornito supporto, garanzia o aggiornamenti per un programma
+che @`e stato modificato o installato dal destinatario, o per il Prodotto
Utente
+in cui esso @`e stato modificato o installato. L'accesso ad una rete
address@hidden essere
+negato se le modifiche apportate impattano materialmente sull'address@hidden
+della rete o se violano le regole e i protocolli di comunicazione attraverso
+la rete.
+
+Il Sorgente Corrispondente distribuito, e le Informazioni di Installazione
+fornite, in accordo con questa sezione, devono essere in un formato che sia
+pubblicamente documentato (e con una implementazione pubblicamente disponibile
+in formato di codice sorgente), e non devono richiedere speciali password o
+chiavi per essere spacchettate, lette o copiate.
+
address@hidden Condizioni Aggiuntive
+
+Le ``Condizioni Aggiuntive'' sono condizioni che completano le condizioni di
+questa Licenza permettendo delle eccezioni a una o address@hidden delle
condizioni sopra
+elencate. Le condizioni aggiuntive che sono applicabili all'intero Programma
+devono essere considerate come se fossero incluse in questa Licenza, a patto
+che esse siano valide secondo le normative vigenti. Se alcune condizioni
+aggiuntive fanno riferimento soltanto ad alcune parti del Programma, quelle
+parti possono essere utilizzate separatamente sotto le stesse condizioni, ma
+l'intero Programma rimane sottoposto a questa Licenza senza riferimento ad
+alcuna condizione aggiuntiva.
+
+Quando distribuisci una copia di un programma coperto da questa Licenza, puoi,
+a tua discrezione, eliminare qualunque condizione aggiuntiva dalla copia, o da
+parte di essa. (Le Condizioni Aggiuntive possono essere scritte in maniera
+tale da richiedere la loro rimozione in certi casi di modifica del Programma).
+Puoi aggiungere Condizioni Aggiuntive su materiale, aggiunto da te ad un'opera
+coperta da questa Licenza, per il quale hai o puoi garantire un'adeguata
+licenza di copyright.
+
+Indipendentemente da qualunque altra condizione di questa Licenza, e per il
+materiale che aggiungi ad un'opera coperta da questa Licenza, puoi (se
+autorizzato dai legittimi detentori del copyright per il suddetto materiale)
+aggiungere alle condizioni di questa Licenza delle condizioni che:
+
address@hidden a
address@hidden
+Negano la garanzia o limitano la address@hidden del Programma in maniera
+differente da quanto riportato nelle sezioni 15 e 16 di questa Licenza; oppure
+
address@hidden
+Richiedono il mantenimento di specifiche e circostanziate informative legali o
+di note di attribuzione ad autori nel materiale o assieme alle Adeguate
+Informazioni Legali mostrate dal Programma che lo contiene; oppure
+
address@hidden
+Proibiscono di fornire informazioni errate o ingannevoli sull'origine e la
+provenienza del materiale in oggetto, o richiedono che versioni modificate di
+tale materiale siano appositamente marcate in maniera differente rispetto alla
+versione originale; oppure
+
address@hidden
+Limitano l'utilizzo per scopi pubblicitari del nome dei detentori del
+copyright o degli autori del materiale; oppure
+
address@hidden
+Rifiutano di garantire diritti secondo le leggi sulla address@hidden
intellettuale
+circa l'uso di nomi, marchi di fabbrica o similari; oppure
+
address@hidden
+Richiedono l'indennizzo dei detentori del copyright o degli autori del
+materiale in oggetto da parte di chi distribuisce il materiale (o versioni
+modificate dello stesso) con impegni contrattuali circa la address@hidden nei
+confronti del destinatario, per qualunque address@hidden che questi impegni
+contrattuali dovessero imporre direttamente ai suddetti detentori del
+copyright e autori.
address@hidden enumerate
+
+Tutte le altre condizioni addizionali non-permissive sono considerate
+``ulteriori restrizioni'', secondo il significato specificato alla sezione 10.
+Se il Programma o parti di esso contengono, all'atto della ricezione dello
+stesso, informative che specificano che esso @`e soggetto a questa Licenza
+assieme ad una condizione che @`e una ``ulteriore restrizione'', puoi rimuovere
+quest'ultima condizione. Se un documento di licenza contiene ulteriori
+restrizioni ma permette di rilicenziare o distribuire il Programma con questa
+Licenza, puoi aggiungere al Programma del materiale coperto dalle condizioni
+di quel documento di licenza, a patto che le ulteriori restrizioni non
+compaiano nelle versioni rilicenziate o ridistribuite.
+
+Se aggiungi ad un Programma coperto da questa Licenza delle condizioni
+aggiuntive in accordo con questa sezione, devi aggiungere anche, nei file
+sorgenti corrispondenti, un avviso che riassuma le condizioni aggiuntive
+applicate a quei file, ovvero un avviso che specifichi dove @`e possibile
+trovare copia delle condizioni aggiunte.
+
+Tutte le Condizioni aggiuntive, permissive o non-permissive, devono essere
+espresse nella forma di una licenza scritta e separata, o espresse
+esplicitamente come eccezioni; in entrambi i casi valgono le condizioni
+succitate.
+
address@hidden Cessazione di Licenza
+
+Non puoi propagare o modificare un programma coperto da questa Licenza in
+maniera diversa da quanto espressamente consentito da questa Licenza.
+Qualunque tentativo di propagare o modificare altrimenti il Programma @`e
nullo,
+e provoca l'immediata cessazione dei diritti garantiti da questa Licenza
+(compresi tutte le eventuali licenze di brevetto garantite ai sensi del terzo
+paragrafo della sezione 11).
+
+In ogni caso, se cessano tutte le violazioni di questa Licenza, allora la tua
+licenza da parte di un dato detentore del copyright viene ripristinata (a) in
+via cautelativa, a meno che e fino a quando il detentore del copyright non
+cessa esplicitamente e definitivamente la tua licenza, e (b) in via permanente
+se il detentore del copyright non ti notifica in alcun modo la violazione
+entro 60 giorni dalla cessazione della licenza.
+
+Inoltre, la tua licenza da parte di un dato detentore del copyright viene
+ripristinata in maniera permanente se il detentore del copyright ti notifica
+la violazione in maniera adeguata, se questa @`e la prima volta che ricevi una
+notifica di violazione di questa Licenza (per qualunque Programma) dallo
+stesso detentore di copyright, e se rimedi alla violazione entro 30 giorni
+dalla data di ricezione della notifica di violazione.
+
+La cessazione dei tuoi diritti come specificato in questa sezione non provoca
+la cessazione delle licenze di terze parti che abbiano ricevuto copie o
+diritti da te secondo questa Licenza. Se i tuoi diritti cessano e non sono
+ristabiliti in via permanente, non hai diritto di ricevere nuove licenze per
+lo stesso materiale, secondo quanto stabilito nella sezione 10.
+
address@hidden L'ottenimento di copie non richiede l'accettazione della Licenza
+
+Non sei obbligato ad accettare i termini di questa Licenza al solo fine di
+ottenere o eseguire una copia del Programma. Similmente, propagazioni
+collaterali di un Programma coperto da questa Licenza che occorrono come
+semplice conseguenza dell'utilizzo di trasmissioni peer-to-peer per la
+ricezione di una copia non richiedono l'accettazione della Licenza. In ogni
+caso, solo e soltanto questa Licenza ti garantiscono il permesso di propagare
+e modificare qualunque programma coperto da questa Licenza. Queste azioni
+violano le leggi sul copyright nel caso in cui tu non accetti questa Licenza.
+Pertanto, modificando o propagando un programma coperto da questa Licenza,
+indichi implicitamente la tua accettazione della Licenza.
+
address@hidden Licenza Automatica per i successivi destinatari
+
+Ogni qual volta distribuisci un programma coperto da questa Licenza, il
+destinatario riceve automaticamente una licenza, dal detentore originario del
+copyright, di eseguire, modificare e propagare il programma, nel rispetto di
+questa Licenza. Non sei ritenuto responsabile del rispetto di questa Licenza
+da parte di terze parti.
+
+Una ``transazione d'address@hidden'' @`e una transazione che trasferisce il
controllo di
+una organizzazione, o sostanzialmente di tutti i suoi beni, che suddivide una
+organizzazione o che fonde address@hidden organizzazioni. Se la propagazione
di un
+programma coperto da questa Licenza @`e conseguente ad una transazione di
address@hidden, ciascuna parte che ha ruolo nella transazione e che riceve una
copia
+del programma riceve allo stesso tempo qualsiasi licenza sul programma che i
+predecessori della parte possedevano o potevano rilasciare nel rispetto del
+paragrafo precedente, e in address@hidden il diritto di possesso del Sorgente
+Corrispondente del programma dal predecessore in interesse, se il predecessore
+lo possiede o se address@hidden ottenerlo senza troppe address@hidden
+
+Non puoi imporre nessuna ulteriore restrizione sull'esercizio dei diritti
+garantiti o affermati da questa Licenza. Per esempio, non puoi imporre un
+prezzo di licenza, una royalty, o altri costi per l'esercizio dei diritti
+garantiti da questa Licenza, a non puoi dar corso ad una controversia (ivi
+incluse le controversie incrociate o la difesa in cause legali) affermando che
+siano stati violati dei brevetti a causa della produzione, dell'uso, della
+vendita, della messa in vendita o dell'importazione del Programma o di sue
+parti.
+
address@hidden Brevetti
+
+Un ``contribuente'' @`e un detentore di copyright che autorizza l'uso secondo
+questa Licenza di un Programma o di un'opera basata sul Programma. L'opera
address@hidden@dotless{i}} licenziata viene chiamata ``versione del
contribuente''.
+
+I ``diritti essenziali di brevetto'' da parte di un contribuente sono tutti i
+diritti di brevetto che appartengono o che sono controllati dal contribuente,
+che siano address@hidden acquisiti o che saranno acquisiti in futuro, che
possano essere
+violati in qualche maniera, consentita da questa Licenza, generando,
+modificando o vendendo la versione del contribuente, ma non includono i
+diritti che possano essere violati soltanto come conseguenza di ulteriori
+modifiche alla versione del contribuente. In relazione a questa definizione,
+il termine ``controllo'' include il diritto di garantire sottolicenze di
+brevetto in maniera consistente con le condizioni di questa Licenza.
+
+Ciascun contribuente ti garantisce la licenza di brevetto sui diritti
+essenziali di brevetto del contribuente stesso non-esclusiva, valida in tutto
+il mondo, esente da royalty, di creare, usare, vendere, offrire in vendita,
+importare e altrimenti eseguire, modificare e propagare i contenuti della
+versione del contribuente.
+
+Nei tre paragrafi successivi, con ``licenza di brevetto'' si intende qualunque
+accordo o contratto, comunque denominato, di non rivendicazione di un brevetto
+(come per esempio un permesso esplicito di utilizzare un brevetto o un accordo
+di rinuncia alla persecuzione per violazione di brevetto). ``Garantire'' una
+tale licenza di brevetto ad una parte significa portare a termine un tale
+accordo o contratto di non rivendicazione di brevetto contro la parte.
+
+Se distribuisci un programma coperto da questa Licenza, confidando
+consapevolmente su una licenza di brevetto, e il Sorgente Corrispondente per
+il programma non @`e reso disponibile per la copia, senza alcun onere
aggiuntivo
+e comunque nel rispetto delle condizioni di questa Licenza, attraverso un
+server di rete pubblicamente accessibile o tramite altri mezzi facilmente
+accessibili, allora devi (1) fare in modo che il Sorgente Corrispondente sia
+reso disponibile come sopra, oppure (2) fare in modo di rinunciare ai benefici
+della licenza di brevetto per quel particolare programma, oppure (3)
+adoperarti, in maniera consistente con le condizioni di questa Licenza, per
+estendere la licenza di brevetto a tutti i destinatari successivi. ``Confidare
+consapevolmente'' significa che tu sei attualmente cosciente che, eccettuata la
+licenza di brevetto, la distribuzione da parte tua di un programma protetto da
+questa Licenza in un paese, o l'utilizzo in un paese del programma coperto da
+questa Licenza da parte di un destinatario, address@hidden violare uno o
address@hidden brevetti in
+quel paese che tu hai ragione di ritenere validi.
+
+Se, come conseguenza o in connessione con una singola transazione o con un
+dato accordo, distribuisci, o fai in modo di distribuire, un programma coperto
+da questa Licenza, e garantisci una licenza di brevetto per alcune delle parti
+che ricevono il Programma autorizzandole ad utilizzare, propagare, modificare
+o distribuire una specifica copia del Programma, allora la licenza di brevetto
+che fornisci @`e automaticamente estesa a tutti i destinatari del Programma
+coperto da questa Licenza e delle opere basate sul Programma.
+
+Una licenza di brevetto @`e ``discriminatoria'' se non include nell'ambito
della
+sua copertura, proibisce l'esercizio, o @`e vincolata al non-esercizio di uno o
address@hidden dei diritti che sono specificatamente garantiti da questa
Licenza. Non
+puoi distribuire un Programma coperto da questa Licenza se sei parte di un
+accordo con una terza parte la cui address@hidden comprende la distribuzione di
+software, secondo il quale tu sei costretto ad un pagamento alla parte terza
+in funzione della tua address@hidden di distribuzione del Programma, e in
+conseguenza del quale la parte terza garantisce, a qualunque delle parti che
+riceveranno il Programma da te, una licenza di brevetto discriminatoria (a)
+assieme a copie del Programma coperto da questa Licenza distribuite da te (o
+ad altre copie fatte da codeste copie), oppure (b) principalmente per e in
+connessione con specifici prodotti o raccolte di prodotti che contengono il
+Programma, a meno che l'accordo non sia stato stipulato, o le licenze di
+brevetto non siano state rilasciate, prima del 28 Marzo 2007.
+
+Nessuna parte di questa Licenza address@hidden essere interpretata come atta
ad escludere
+o limitare gli effetti di qualunque altra licenza o altri meccanismi di difesa
+dalla violazione che possano altrimenti essere resi disponibili dalla
+normativa vigente in materia di brevetti.
+
address@hidden Nessuna resa di address@hidden altrui
+
+Se ti vengono imposte delle condizioni (da un ordine giudiziario, da un
+accordo o da qualunque altra address@hidden) che contraddicono le condizioni di
+questa Licenza, non sei in nessun modo esonerato dal rispetto delle condizioni
+di questa Licenza. Se non puoi distribuire un Programma coperto da questa
+Licenza per sottostare simultaneamente agli obblighi derivanti da questa
+Licenza e ad altri obblighi pertinenti, allora non puoi distribuire il
+Programma per nessun motivo. Per esempio, se accetti delle condizioni che ti
+obbligano a richiedere il pagamento di una royalty per le distribuzioni
+successivamente effettuate da coloro ai quali hai distribuito il Programma,
+l'unico modo per soddisfare sia queste condizioni che questa Licenza @`e
evitare
+del tutto la distribuzione del Programma.
+
address@hidden Utilizzo con la GNU Affero General Public License
+
+Indipendentemente da qualunque altra condizione espressa da questa Licenza,
+hai il permesso di collegare o combinare qualunque Programma coperto da questa
+Licenza con un'opera rilasciata sotto la versione 3 della licenza GNU Affero
+General Public License, ottenendo un singolo Programma derivato, e di
+distribuire il Programma risultante. Le condizioni di questa Licenza
+continuano a valere per le parti riguardanti il Programma che sono coperte da
+questa Licenza, mentre le condizioni speciali della GNU Affero General Public
+License, sezione 13, riguardanti l'interazione mediante rete, saranno
+applicate al Programma address@hidden@dotless{i}} risultante.
+
address@hidden Versioni rivedute di questa Licenza
+
+La Free Software Foundation address@hidden pubblicare delle versioni rivedute
e/o delle
+nuove versioni della GNU General Public License di tanto in tanto. Tali
+versioni saranno simili, nello spirito, alla presente versione, ma potranno
+differire nei dettagli al fine di affrontare nuovi problemi e nuove
+situazioni.
+
+A ciascuna versione viene assegnato un numero identificativo di versione. Se
+il Programma specifica che si applica a address@hidden stesso una certa
versione della GNU
+General Public License, ``o qualunque altra versione successiva'', hai la
address@hidden di sottostare alle condizioni di quella specifica versione o di
+qualunque altra versione successiva pubblicata dalla Free Software Foundation.
+Se il Programma non specifica un numero di versione della GNU General Public
+License, puoi scegliere qualunque versione della GNU General Public License
+pubblicata dalla Free Software Foundation.
+
+Se il Programma specifica che un sostituto o un procuratore address@hidden
decidere quali
+versioni future della GNU General Public License posso essere utilizzate,
+allora tale scelta di accettazione di una data versione ti autorizza, in
+maniera permanente, ad utilizzare quella versione della Licenza per il
+Programma.
+
+Versioni successive della Licenza possono garantire diritti aggiuntivi o
+leggermente differenti. Ad ogni modo, nessun obbligo aggiuntivo viene imposto
+agli autori o ai detentori di copyright come conseguenza della tua scelta di
+adottare una versione successiva della Licenza.
+
address@hidden Rinuncia alla Garanzia
+
+NON C'@`E NESSUNA GARANZIA PER IL PROGRAMMA, PER QUANTO CONSENTITO DALLE
+VIGENTI NORMATIVE. ECCETTO QUANDO ALTRIMENTI STABILITO PER ISCRITTO, I
+DETENTORI DEL COPYRIGHT E/O LE ALTRE PARTI FORNISCONO IL PROGRAMMA
address@hidden COME
address@hidden'' SENZA GARANZIA DI ALCUN TIPO, N@'E ESPRESSA N@'E IMPLICITA,
INCLUSE, MA NON
+LIMITATE A, LE GARANZIE DI address@hidden O DI address@hidden PER UN
+PARTICOLARE SCOPO. L'INTERO RISCHIO CONCERNENTE LA address@hidden E LE
PRESTAZIONI
+DEL PROGRAMMA @`E DEL LICENZIATARIO. SE IL PROGRAMMA DOVESSE RISULTARE
+DIFETTOSO, IL LICENZIATARIO SI ASSUME I COSTI DI MANUTENZIONE, RIPARAZIONE O
+CORREZIONE.
+
address@hidden Limitazione di address@hidden
+
+IN NESSUN CASO, A MENO CHE NON SIA RICHIESTO DALLA NORMATIVA VIGENTE O
+CONCORDATO PER ISCRITTO, I DETENTORI DEL COPYRIGHT, O QUALUNQUE ALTRA PARTE
+CHE MODIICA E/O DISTRIBUISCE IL PROGRAMMA SECONDO LE CONDIZIONI PRECEDENTI,
+POSSONO ESSERE RITENUTI RESPONSABILI NEI CONFRONTI DEL LICENZIATARIO PER
+DANNI, INCLUSO QUALUNQUE DANNEGGIAMENTO GENERICO, SPECIALE, INCIDENTALE O
+CONSEQUENZIALE DOVUTO ALL'USO O ALL'address@hidden D'USO DEL PROGRAMMA
+(INCLUSI, MA NON LIMITATI A, LE PERDITE DI DATI, LA CORRUZIONE DI DATI, LE
+PERDITE SOSTENUTE DAL LICENZIATARIO O DA TERZE PARTI O L'address@hidden DEL
+PROGRAMMA A FUNZIONARE ASSIEME AD ALTRI PROGRAMMI), ANCHE NEL CASO IN CUI IL
+DETENTORE O LE ALTRE PARTI SIANO STATI AVVISATI CIRCA LA address@hidden DI TALI
+DANNEGGIAMENTI.
+
address@hidden Interpretazione delle Sezioni 15 e 16
+
+Se la dichiarazione di garanzia e la limitazione di address@hidden fornite
+precedentemente non hanno effetto legale in un paese a causa delle loro
+condizioni, le corti di giustizia devono applicare la norma locale che
address@hidden si
+avvicini al rifiuto assoluto di qualsivoglia address@hidden civile relativa al
+Programma, a meno che una garanzia o una assunzione di address@hidden scritta
+non accompagni una copia del programma ottenuta dietro pagamento.
address@hidden enumerate
+
address@hidden fakenode --- for prepinfo
address@hidden FINE DEI TERMINI E DELLE CONDIZIONI
+
address@hidden fakenode --- for prepinfo
address@hidden Come applicare queste condizioni di Licenza ai vostri programmi
+
+Se sviluppi un nuovo programma, e vuoi che esso sia della massima
address@hidden, il
+modo migliore @`e renderlo software libero in modo che chiunque possa
+ridistribuirlo e modificarlo secondo i termini di questa Licenza.
+
+Per fare address@hidden, allega le seguenti note informative al programma. Il
modo
+migliore @`e inserirle all'inizio di ciascun file sorgente, al fine di
rimarcare
+adeguatamente la mancanza di garanzia; ciascun file dovrebbe inoltre contenere
+la dichiarazione di copyright e un riferimento al posto in cui @`e possibile
+ottenere la versione completa delle note informative.
+
address@hidden
address@hidden<una riga con nome del programma e breve descrizione di
address@hidden che fa.>}
+Copyright (C) @var{<anno>} @var{<nome dell'autore>}
+
+Questo software @`e libero; lo puoi distribuire e/o modificare alle condizioni
+stabilite nella 'GNU General Public License' pubblicata dalla Free Software
+Foundation; fai riferimento alla versione 3 della Licenza, o (a tua scelta)
+a una qualsiasi versione successiva.
+
+Questo programma @`e distribuito con la speranza che sia utile, ma SENZA
+ALCUNA GARANZIA; senza neppure la garanzia implicita di address@hidden o
address@hidden AD UN PARTICOLARE SCOPO. Si veda la 'GNU General Public License'
per
+ulteriori dettagli.
+
+Dovresti aver ricevuto una copia della GNU General Public License assieme a
+questo programma; se non @`e address@hidden@dotless{i}}, si veda
address@hidden://www.gnu.org/licenses/}.
address@hidden smallexample
+
+Inoltre, aggiungi le informazioni necessarie a contattarti via posta ordinaria
+o via posta elettronica.
+
+Se il programma interagisce mediante terminale, fai in modo che visualizzi,
+quando viene avviato in address@hidden interattiva, un breve messaggio come
quello
+che segue:
+
address@hidden
address@hidden<programma>} Copyright (C) @var{<anno>} @var{<nome dell'autore>}
+Questo programma non ha ALCUNA GARANZIA; per dettagli usare il comando
address@hidden w}.
+Questo @`e software libero, e ognuno @`e libero di ridistribuirlo
+sotto certe condizioni; usare il comando @samp{show c} per i dettagli.
address@hidden smallexample
+
+Gli ipotetici comandi @samp{show w} e @samp{show c} devono visualizzare le
parti
+corrispondenti della GNU General Public License. Naturalmente i comandi del
+tuo programma potrebbero essere differenti; per una interfaccia di tipo GUI,
+dovresti usare un bottone ``About'' o ``Info''.
+
+Devi inoltre fare in modo che il tuo datore di lavoro (se lavori come
+programmatore presso terzi) o la tua scuola, eventualmente, firmino una
+``rinuncia al copyright'' sul programma, se necessario. Per maggiori
+informazioni su questo punto, e su come applicare e rispettare la GNU GPL,
+consultare la pagina @url{http://www.gnu.org/licenses/}.
+
+La GNU General Public License non consente di incorporare il programma
+all'interno di software proprietario. Se il tuo programma @`e una libreria di
+funzioni, potresti ritenere address@hidden opportuno consentire il
collegamento tra
+software proprietario e la tua libreria. Se @`e questo address@hidden che
vuoi, allora
+utilizza la GNU Lesser General Public License anzich@'e questa Licenza, ma
prima
+leggi @url{http://www.gnu.org/philosophy/why-not-lgpl.html}.
+
address@hidden FOR_PRINT
address@hidden The GNU Free Documentation License.
address@hidden Licenza per Documentazione Libera GNU (FDL)
address@hidden Licenza per Documentazione Libera GNU (FDL)
address@hidden
address@hidden Versione 1.3, 3 Novembre 2008
address@hidden ifnotdocbook
+
address@hidden
+<subtitle>Versione 1.3, 3 Novembre 2008 </subtitle>
address@hidden docbook
+
address@hidden FDL (Free Documentation License)
address@hidden Free Documentation License (FDL)
address@hidden GNU Free Documentation License
+
address@hidden This file is intended to be included within another document,
address@hidden hence no sectioning command or @node.
+
address@hidden
+Copyright @copyright{} 2000, 2001, 2002, 2007, 2008 Free Software Foundation,
Inc.
address@hidden://fsf.org}
+
+This is an unofficial translation of the GNU Free Documentation License into
+Italian. It was not published by the Free Software Foundation, and does not
+legally state the distribution terms for software that uses the GNU FDLâonly
+the original English text of the GNU FDL does that. However, we hope that this
+translation will help Italian speakers understand the GNU FDL better.
+
+Questa @`e una traduzione non ufficiale della GNU Free Documentation License
+in italiano. Non @`e una pubblicazione della Free Software Foundation, e non
+ha address@hidden legale per i termini di distribuzione della documentazione
che
+usa la GNU FDL; solo il testo originale inglese della GNU FDL ha tale
address@hidden Comunque, speriamo che questa traduzione aiuti chi parla
+italiano a comprendere meglio la GNU FDL.
+
+A chiunque @`e permesso copiare e ridistribuire copie esatte di questo
documento
+di licenza, ma non @`e in alcun modo consentito apportarvi modifiche.
+
address@hidden display
+
address@hidden 0
address@hidden
+PREAMBOLO
+
+Lo scopo di questa licenza @`e di rendere @dfn{liberi} un manuale, un testo o
+altri documenti funzionali e utili, nel senso di assicurare a tutti la
address@hidden effettiva di copiarli e ridistribuirli, con o senza modifiche,
con
+o senza fini di lucro. In secondo luogo questa licenza prevede per autori
+ed editori il modo per ottenere il giusto riconoscimento del proprio
+lavoro, preservandoli dall'essere considerati responsabili per modifiche
+apportate da altri.
+
+Questa licenza garantisce il ``copyleft'': questo significa che i lavori che
+derivano dal documento originale devono essere ugualmente liberi. @`E il
+complemento alla Licenza Pubblica Generale GNU, che @`e una licenza di tipo
+``copyleft'' pensata per il software libero.
+
+Questa licenza @`e stata progettata appositamente per l'uso con manuali di
+software libero, perch@'e il software libero ha bisogno di documentazione
+libera: un programma libero dovrebbe accompagnarsi a manuali che
+forniscano le stesse address@hidden del software. Questa licenza non @`e
limitata
+alla manualistica del software; address@hidden essere utilizzata per ogni
testo che
+tratti un qualsiasi argomento e al di address@hidden dell'avvenuta
pubblicazione
+cartacea. Si raccomanda l'uso di questa licenza principalmente per opere
+che abbiano fini didattici o per manuali.
+
address@hidden
address@hidden E DEFINIZIONI
+
+Questa licenza si applica a qualsiasi manuale o altra opera, su ogni tipo
+di supporto, che contenga la nota, posta dal detentore del copyright, che
+attesti la address@hidden di distribuzione secondo i termini di questa
+licenza. Tale nota permette universalmente, senza pagamento di diritti e
+senza limiti di durata di utilizzare il lavoro secondo le condizioni qui
+specificate. Con ``documento'', nel seguito ci si riferisce a qualsiasi
+manuale o opera. Ogni fruitore @`e un destinatario della licenza ed @`e ad
+esso che si fa riferimento. Si conviene che la licenza viene accettata se
+si copia, modifica o distribuisce il lavoro in una maniera tale da
+richiedere il permesso secondo le leggi sul copyright.
+
+Una ``versione modificata'' del documento @`e ogni opera contenente il
+documento stesso o parte di esso, sia riprodotto alla lettera che con
+modifiche, oppure traduzioni in un'altra lingua.
+
+Una ``sezione secondaria'' @`e un'appendice cui si fa riferimento o una
+premessa del documento e riguarda esclusivamente il rapporto dell'editore
+o dell'autore del documento con l'argomento generale del documento stesso
+(o argomenti affini) e non contiene nulla che possa essere compreso
+nell'argomento principale. (address@hidden, se il documento @`e in parte un
manuale
+di matematica, una sezione secondaria non address@hidden contenere spiegazioni
di
+matematica). Il rapporto con l'argomento address@hidden essere un tema
collegato
+storicamente con il soggetto principale o con soggetti affini, o essere
+costituito da argomentazioni legali, commerciali, filosofiche, etiche o
+politiche pertinenti.
+
+Le ``sezioni non modificabili'' sono alcune sezioni secondarie i cui titoli
+sono esplicitamente elencati come titoli delle sezioni non modificabili
+nella nota che indica che il documento @`e realizzato sotto questa licenza.
+Se una sezione non rientra nella precedente definizione di sezione
+secondaria, allora non @`e permesso che venga definita come non
+modificabile. Il documento address@hidden anche non contenere sezioni non
+modificabili. Se nel documento non vengono indicate sezioni non
+modificabili, allora significa che non ve ne sono.
+
+I ``testi di copertina'' sono dei brevi brani di testo che sono elencati,
+nella prima o quarta pagina di copertina, nella nota che indica che il
+documento @`e rilasciato sotto questa licenza. Il testo sulla prima di
+copertina address@hidden essere composto al massimo di 5 parole mentre quello
sulla
+quarta di copertina address@hidden essere al massimo di 25 parole.
+
+Una copia ``trasparente'' indica una copia leggibile da un calcolatore,
+codificata in un formato le cui specifiche sono disponibili pubblicamente,
+tale che il suo contenuto possa essere modificato in modo semplice con
+generici editor di testi o (per immagini composte da pixel) con generici
+editor di immagini o (per i disegni) con qualche editor di disegni
+ampiamente diffuso; la copia deve essere adatta al trattamento per la
+formattazione o per la conversione in una address@hidden di formati atti alla
+successiva formattazione. Una copia fatta in un formato di file, per il
+resto trasparente, i cui marcatori o assenza di tali sono stati progettati
+per intralciare o scoraggiare modifiche future da parte dei lettori non @`e
+trasparente. Un formato immagine non @`e trasparente se viene usato per
+rappresentare una notevole address@hidden di testo. Una copia non
``trasparente''
+viene detta ``opaca''.
+
+Esempi di formati adatti per copie trasparenti sono l'@sc{ASCII} puro senza
+marcatori, il formato di ingresso per Texinfo, il formato di ingresso per
address@hidden, @acronym{SGML} o @acronym{XML} accoppiati ad una @acronym{DTD}
+pubblica e disponibile, e i formati conformi agli standard @acronym{HTML}
+semplice, Postscript e @acronym{PDF} progettati per essere modificati
+manualmente. Esempio di formati immagine trasparenti includono il
address@hidden, @acronym{XCF} e @acronym{JPG}. I formati opachi includono i
+formati proprietari che possono essere letti e modificati solo con word
+processor proprietari, @acronym{SGML} o @acronym{XML} per cui non @`e in
+genere disponibile la @acronym{DTD} o gli strumenti per il trattamento, e i
+formati @acronym{HTML}, Postscript e @acronym{PDF} generati automaticamente
+da qualche word processor esclusivamente come output.
+
+La ``pagina del titolo'' di un libro stampato indica la pagina del titolo
+stessa, address@hidden qualche pagina seguente per quanto necessario a
contenere in
+modo leggibile, il materiale che la licenza prevede che compaia nella
+pagina del titolo. Per opere in formati in cui non sia contemplata
+esplicitamente la pagina del titolo, con ``pagina del titolo'' si intende il
+testo prossimo al titolo dell'opera, precedente l'inizio del corpo del
+testo.
+
+Il termine ``editore'' indica qualunque persona o address@hidden che
distribuisce al
+pubblico copie del documento.
+
+Una sezione ``Intitolata XYZ'' significa una sottosezione con nome del
+documento il cui titolo sia precisamente XYZ o che contenga XYZ in
+parentesi dopo il testo che traduce XYZ in un'altra lingua (in questo caso
+XYZ sta per uno specifico nome di sezione menzionato sotto, come per i
+``Riconoscimenti'', ``Dediche'', ``Approvazioni'', o ``Storia''). Secondo
questa
+definizione, ``preservare il titolo'' di tale sezione quando si modifica il
+documento, significa che essa rimane una sezione ``Intitolata XYZ''.
+
+Il Documento address@hidden includere dei limiti alla garanzia accanto alla
nota
+affermante l'applicazione di questa licenza al documento. Questi limiti
+alla garanzia sono da considerare da includere come riferimento a questa
+licenza, ma solo per quanto riguarda le limitazioni alla garanzia: ogni
+altra implicazione che questi limiti alla garanzia possono avere @`e da
+considerarsi nulla e non ha effetto sul significato di questa licenza.
+
address@hidden
+COPIE LETTERALI
+
+Si address@hidden copiare e distribuire il documento con qualsiasi mezzo, con
o senza
+fini di lucro, purch@'e tutte le copie contengano questa licenza, le note di
+copyright e l'avviso che questa licenza si applica al documento, e che non
+si aggiungano altre condizioni al di fuori di quelle della licenza stessa.
+Non si possono usare misure tecniche per impedire o controllare la lettura
+o la produzione di copie successive alle copie che si producono o
+distribuiscono. Si possono comunque accettare compensi per la copiatura.
+Se si distribuiscono un numero sufficiente di copie si devono seguire
+anche le condizioni della sezione 3.
+
+Alle stesse condizioni sopra menzionate si possono prestare copie e
+mostrarle pubblicamente.
+
address@hidden
+COPIARE IN NOTEVOLI address@hidden
+
+Se si pubblicano a mezzo stampa (o in formati che tipicamente posseggono
+copertine) address@hidden di 100 copie del documento, e la nota della licenza
+richiede uno o address@hidden testi di copertina, si devono includere nelle
copie, in
+modo chiaro e leggibile, tutti i testi di copertina indicati: il testo
+della prima di copertina in prima di copertina e il testo di quarta di
+copertina in quarta di copertina. Ambedue devono identificare l'editore
+che pubblica il documento. La prima di copertina deve presentare il titolo
+completo con tutte le parole che lo compongono egualmente visibili ed
+evidenti. Si address@hidden aggiungere altro materiale alle copertine. Il
copiare con
+modifiche limitate alle sole copertine, purch@'e si preservino il titolo e
+le altre condizioni viste in precedenza, @`e considerato alla stregua di
+copiare alla lettera.
+
+Se il testo richiesto per le copertine @`e troppo voluminoso per essere
+riprodotto in modo leggibile, se ne address@hidden mettere una prima parte (per
+quanto ragionevolmente address@hidden stare) in copertina, e continuare il
resto
+nelle pagine immediatamente seguenti.
+
+Se si pubblicano o distribuiscono copie opache del documento in numero
+superiore a 100, si deve anche includere una copia trasparente leggibile
+da un calcolatore in ogni copia oppure menzionare in ogni copia opaca un
+indirizzo di rete di calcolatori pubblicamente accessibile che utilizzi un
+protocollo di rete standard pubblico, da cui si possa scaricare
+liberamente una copia trasparente completa del documento, senza materiale
+aggiuntivo. Se si adotta quest'ultima opzione, si deve prestare la giusta
+attenzione, nel momento in cui si inizia la distribuzione in address@hidden
+elevata di copie opache, ad assicurarsi che la copia trasparente rimanga
+accessibile all'indirizzo stabilito fino ad almeno un anno dopo l'ultima
+distribuzione (direttamente o attraverso distributori o rivenditori) di
+quell'edizione al pubblico.
+
address@hidden caldamente consigliato, bench@'e non obbligatorio, contattare
l'autore del
+documento prima di distribuirne un numero considerevole di copie, per
+metterlo in grado di fornire una versione aggiornata del documento.
+
address@hidden
+MODIFICHE
+
+Si possono copiare e distribuire versioni modificate del documento
+rispettando le condizioni delle precedenti sezioni 2 e 3, purch@'e la
+versione modificata sia realizzata seguendo questa stessa licenza, con la
+versione modificata che svolga il ruolo del ``documento'',
address@hidden@dotless{i}} da estendere
+la licenza sulla distribuzione e la modifica a chiunque ne possieda una
+copia. Inoltre nelle versioni modificate si deve:
+
address@hidden A
address@hidden
+Usare nella pagina del titolo (e nelle copertine se ce ne sono) un titolo
+diverso da quello del documento, e da quelli di versioni precedenti (che
+devono essere elencati nella sezione storia del documento ove presenti).
+Si address@hidden usare lo stesso titolo di una versione precedente se
l'editore di
+quella versione originale ne ha dato il permesso.
+
address@hidden
+Elencare nella pagina del titolo, come autori, una o address@hidden persone o
gruppi
+responsabili in address@hidden di autori delle modifiche nella versione
+modificata, insieme ad almeno cinque tra i principali autori del documento
+(tutti gli autori principali se sono meno di cinque), a meno che questi
+non abbiano acconsentito a liberarvi da quest'obbligo.
+
address@hidden
+Dichiarare nella pagina del titolo il nome dell'editore della versione
+modificata in address@hidden di editore.
+
address@hidden
+Conservare tutte le note di copyright
+del documento originale.
+
address@hidden
+Aggiungere un'appropriata nota di copyright per
+le modifiche di seguito alle altre note di copyright.
+
address@hidden
+Includere, immediatamente dopo la nota di copyright, una nota di licenza
+che dia pubblicamente il permesso di usare la versione modificata nei
+termini di questa licenza, nella forma mostrata nell'Addendum alla fine di
+questo testo.
+
address@hidden
+Preservare in tale nota di licenza l'elenco completo di sezioni non
+modificabili e testi di copertina richiesti come previsto dalla licenza
+del documento.
+
address@hidden
+Includere una copia non modificata di questa licenza.
+
address@hidden
+Conservare la sezione intitolata ``Storia'', e il suo titolo, e aggiungere
+a questa un elemento che riporti almeno il titolo, l'anno, i nuovi autori,
+e gli editori della versione modificata come figurano nella pagina del
+titolo. Se non ci sono sezioni intitolate ``Storia'' nel documento,
+crearne una che riporti il titolo, gli autori, gli editori del documento
+come figurano nella pagina del titolo, quindi aggiungere un elemento che
+descriva la versione modificata come detto in precedenza.
+
address@hidden
+Conservare l'indirizzo in rete riportato nel documento, se c'@`e, al fine
+del pubblico accesso ad una copia trasparente, e possibilmente l'indirizzo
+in rete per le precedenti versioni su cui ci si @`e basati. Questi possono
+essere collocati nella sezione ``Storia''. Si address@hidden omettere un
indirizzo di
+rete per un'opera pubblicata almeno quattro anni prima del documento
+stesso, o se l'originario editore della versione cui ci si riferisce ne
address@hidden
+il permesso.
+
address@hidden
+In ogni sezione di ``Ringraziamenti'' o ``Dediche'', si conservi il titolo
+della sezione, e all'interno della sezione tutta la sostanza e il tono di
+ognuno dei ringraziamenti ai contributori e/o le dediche ivi contenute.
+
address@hidden
+Si conservino inalterate le sezioni non modificabili del documento, nei
+propri testi e nei propri titoli. I numeri della sezione o equivalenti non
+sono considerati parte del titolo della sezione.
+
address@hidden
+Si cancelli ogni sezione intitolata ``Approvazioni''. Tale sezione non
address@hidden
+essere inclusa nella versione modificata.
+
address@hidden
+Non si cambi il titolo di sezioni esistenti in ``Approvazioni'' o in modo
+tale che si possa creare confusione con i titoli di sezioni non
+modificabili.
+
address@hidden
+Si conservino tutti i limiti alla garanzia.
address@hidden enumerate
+
+
+
+Se la versione modificata comprende nuove sezioni di primaria
+importanza o appendici che ricadono in ``sezioni secondarie'', e non
+contengono materiale copiato dal documento, si ha address@hidden di rendere non
+modificabili quante sezioni si voglia. Per fare address@hidden si aggiunga il
loro
+titolo alla lista delle sezioni non modificabili nella nota di licenza
+della versione modificata. Questi titoli devono essere distinti dai titoli
+di ogni altra sezione.
+
+Si address@hidden aggiungere una sezione intitolata ``Approvazioni'', a patto
che non
+contenga altro che le approvazioni alla versione modificata prodotte da
+vari soggetti--per esempio, affermazioni di revisione o che il testo @`e
+stato approvato da una organizzazione come la definizione normativa di uno
+standard.
+
+Si address@hidden aggiungere un brano fino a cinque parole come testo di prima
di
+copertina e un brano fino a 25 parole come testo di quarta di copertina,
+alla fine dell'elenco dei testi di copertina nella versione modificata.
+Solamente un brano del testo di prima di copertina e uno del testo di
+quarta di copertina possono essere aggiunti (anche con adattamenti) da
+ciascuna persona o organizzazione. Se il documento include address@hidden un
testo di
+copertina per la stessa copertina, precedentemente aggiunto o adattato da
+qualunque fruitore o dalla stessa organizzazione nel nome della quale si
+agisce, non se ne address@hidden aggiungere un altro, ma si address@hidden
rimpiazzare il
+vecchio ottenendo l'esplicita autorizzazione dall'editore precedente che
+aveva aggiunto il testo di copertina.
+
+L'autore/i e l'editore/i del documento non danno, tramite questa licenza,
+il permesso di usare i loro nomi per pubblicizzare o asserire, anche
+implicitamente, la loro approvazione di ogni versione modificata.
+
address@hidden
+COMBINAZIONE DI DOCUMENTI
+
+Si address@hidden combinare il documento con altri pubblicati con questa
licenza,
+seguendo i termini definiti nella precedente sezione 4 per le versioni
+modificate, a patto che si includa l'insieme di tutte le sezioni non
+modificabili di tutti i documenti originali, senza modifiche, e si
+elenchino tutte come sezioni non modificabili della combinazione di
+documenti nella licenza della stessa, mantenendo tutti i limiti alla
+garanzia.
+
+Nella combinazione @`e necessaria una sola copia di questa licenza, e
address@hidden
+sezioni non modificabili possono essere rimpiazzate da una singola copia
+se identiche. Se ci sono address@hidden sezioni non modificabili con lo stesso
nome
+ma contenuti differenti, si renda unico il titolo di ciascuna sezione
+aggiungendovi, alla fine e tra parentesi, il nome dell'autore o editore
+della sezione, se noti, o altrimenti un numero distintivo. Si facciano gli
+stessi aggiustamenti ai titoli delle sezioni nell'elenco delle sezioni non
+modificabili nella nota di copyright della combinazione.
+
+Nella combinazione si devono unire le varie sezioni intitolate ``Storia''
+nei vari documenti originali di partenza per formare una unica sezione
+intitolata ``Storia''; allo stesso modo si unisca ogni sezione intitolata
+``Ringraziamenti'', e ogni sezione intitolata ``Dediche''. Si devono eliminare
+tutte le sezioni intitolate ``Approvazioni''.
+
address@hidden
+RACCOLTE DI DOCUMENTI
+
+Si address@hidden produrre una raccolta che consista del documento e di altri
+documenti rilasciati sotto questa licenza, e rimpiazzare le singole copie
+di questa licenza nei vari documenti con una sola inclusa nella raccolta,
+solamente se si seguono le regole fissate da questa licenza per le copie
+alla lettera come se si applicassero a ciascun documento.
+
+Si address@hidden estrarre un singolo documento da tale raccolta e distribuirlo
+separatamente sotto questa licenza, solo se si inserisce una copia di
+questa licenza nel documento estratto e se si seguono tutte le altre
+regole fissate da questa licenza per le copie alla lettera del documento.
+
address@hidden
+AGGREGAZIONE A LAVORI INDIPENDENTI
+
+Un'unione del documento o sue derivazioni con altri documenti o lavori
+separati o indipendenti, all'interno di, o a formare un, archivio o un
+supporto, per la memorizzazione o la distribuzione, viene chiamato un
+``aggregato'' se il copyright risultante dall'unione non viene usato per
+limitare i diritti legali degli utilizzatori oltre a address@hidden che viene
+permesso dai singoli lavori. Quando il documento viene incluso in un
+aggregato, questa licenza non si applica ad altri lavori nell'aggregato
+che non siano essi stessi dei lavori derivati dal documento.
+
+Se le esigenze del testo di copertina della sezione 3 sono applicabili a
+queste copie del documento allora, se il documento @`e inferiore alla
address@hidden
+dell'intero aggregato i testi di copertina del documento possono essere
+piazzati in copertine che delimitano il documento all'interno
+dell'aggregato, o dell'equivalente elettronico delle copertine se il
+documento @`e in un formato elettronico. Altrimenti devono apparire nella
+copertina dell'intero aggregato.
+
address@hidden
+TRADUZIONE
+
+La traduzione @`e considerata un tipo di modifica, di conseguenza si possono
+distribuire traduzioni del documento nei termini della sezione 4.
+Rimpiazzare sezioni non modificabili con traduzioni richiede un
+particolare permesso da parte dei detentori del copyright, ma @`e possibile
+includere la traduzione di parti o di tutte le sezioni non modificabili in
+aggiunta alle versioni originali di queste sezioni. @`E possibile includere
+una traduzione di questa licenza, di tutte le avvertenze del documento e
+di tutti i limiti di garanzia, a condizione che si includa anche la
+versione originale in inglese della licenza completa, comprese le
+avvertenze e limitazioni di garanzia. In caso di discordanza tra la
+traduzione e la versione originale inglese di questa licenza o avvertenza
+o limitazione di garanzia, prevale sempre la versione originale inglese.
+
+Se una sezione del documento viene titolata ``Riconoscimenti'', ``Dediche'', o
+``Storia'', il requisito (sezione 4) di preservare il titolo (sezione 1)
address@hidden tipicamente il cambiamento del titolo.
+
address@hidden
+CESSAZIONE DELLA LICENZA
+
+Non si address@hidden sublicenziare il documento, copiarlo, modificarlo, o
+distribuirlo al di fuori dei termini espressamente previsti da questa
+licenza. Ogni altro tentativo di applicare una licenza al documento,
+copiarlo, modificarlo, o distribuirlo @`e nullo e pone fine automaticamente
+ai diritti previsti da questa licenza.
+
+In ogni caso, se cessano tutte le violazioni di questa Licenza, allora la
+specifica licenza di un particolare detentore del copyright viene
+ripristinata (a) in via provvisoria, a meno che e fino a quando il
+detentore del copyright non faccia estinguere esplicitamente e
+definitivamente la licenza, e (b) in via permanente se il detentore del
+copyright non notifica in alcun modo la violazione entro 60 giorni dalla
+cessazione della licenza.
+
+Inoltre, la licenza di un dato detentore del copyright viene ripristinata
+in maniera permanente se quest'ultimo notifica la violazione in maniera
+adeguata, se si tratta della prima volta che si riceve una notifica di
+violazione della licenza (per qualsiasi opera) dallo stesso detentore di
+copyright, e se la violazione viene corretta entro 30 giorni dalla data di
+ricezione della notifica di violazione.
+
+La cessazione dei diritti come specificato in questa sezione non provoca
+la cessazione delle licenze di terze parti che abbiano ricevuto copie o
+diritti secondo questa licenza. Se i diritti sono cessati e non sono stati
+ristabiliti in via permanente, la ricezione di una copia dello stesso
+materiale, in tutto o in parte, non address@hidden alcun diritto ad
utilizzarlo.
+
address@hidden
+REVISIONI FUTURE DI QUESTA LICENZA
+
+La Free Software Foundation address@hidden occasionalmente pubblicare versioni
nuove
+o rivedute della Licenza per Documentazione Libera GNU. Le nuove versioni
+saranno simili nello spirito alla versione attuale ma potrebbero
+differirne in qualche dettaglio per affrontare nuovi problemi e concetti.
+Si veda @uref{http://www.gnu.org/copyleft/}.
+
+Ad ogni versione della licenza viene dato un numero che la distingue. Se
+il documento specifica che si riferisce ad una versione particolare della
+licenza ``o ogni versione successiva'', si ha la address@hidden di seguire
+termini e condizioni sia della versione specificata che di ogni versione
+successiva pubblicata (non come bozza) dalla Free Software Foundation. Se
+il documento non specifica un numero di versione particolare di questa
+licenza, si address@hidden scegliere ogni versione pubblicata (non come bozza)
dalla
+Free Software Foundation. Se il documento specifica che un delegato
address@hidden
+decidere quale futura versione di questa licenza address@hidden essere
utilizzata,
+allora la dichiarazione pubblica di accettazione della versione, da parte
+del delegato, autorizza in maniera permanente a scegliere tale versione
+per il documento.
+
address@hidden
+CAMBIO DI LICENZA
+
+Il termine ``sito per la collaborazione massiva multiautore'' (o ``sito
+MMC'')
+indica qualsiasi server web che pubblica opere sottoponibili a copyright e
+fornisce a chiunque appositi strumenti per modificare tali opere. Un wiki
+pubblico modificabile da chiunque @`e un esempio di server in questione. Una
+``collaborazione massiva multiautore'' (o ``MMC'') contenuta nel sito indica
+un qualunque insieme di opere sottoponibili a copyright pubblicate sul
+sito MMC.
+
+Il termine ``CC-BY-SA'' indica la licenza Creative Commons Attribution-Share
+Alike 3.0 pubblicata dalla Creative Commons Corporation, un'organizzazione
+senza fini di lucro con sede principale a San Francisco, California, come
+anche le future versioni di tale licenza pubblicate dalla stessa
+organizzazione.
+
+``Incorporare'' significa pubblicare o ripubblicare un documento in tutto o
+in parte, come parte di un altro documento.
+
+Una MMC @`e ``qualificata a cambiare questa licenza'' se ha adottato questa
+licenza e se tutte le opere precedentemente pubblicate con questa licenza
+altrove rispetto alla MMC e successivamente incorporate del tutto o in
+parte nella MMC (1) non hanno testo di copertina o sezioni invarianti e
+(2) sono state incorporate prima del 1° Novembre 2008.
+
+L'operatore di un sito MMC address@hidden ripubblicare un MMC contenuto nel
sito con
+una CC-BY-SA nello stesso sito in qualsiasi momento prima del 1° Agosto
+2009, da parte di una MMC qualificata a cambiare questa licenza.
+
address@hidden enumerate
+
address@hidden fakenode --- for prepinfo
address@hidden ADDENDUM: Come usare questa licenza per i vostri documenti
+
+Per applicare questa licenza ad un documento che si @`e scritto, si includa
+una copia della licenza nel documento e si inserisca la seguente nota di
+copyright appena dopo la pagina del titolo:
+
address@hidden
address@hidden
+ Copyright (C) @var{<anno>} @var{<il vostro nome>}
+ @`E permesso copiare, distribuire e/o modificare questo documento
+ seguendo i termini della ``Licenza per documentazione libera GNU'', versione
1.3
+ o ogni versione successiva pubblicata dalla Free Software Foundation;
+ senza sezioni non modificabili, senza testi di prima di copertina e di
quarta di copertina.
+ Una copia della licenza @`e inclusa nella sezione intitolata
+ ``Licenza per la documentazione libera GNU''.
address@hidden group
address@hidden smallexample
+
+Se ci sono sezioni non modificabili, testi di prima di copertina e di
+quarta di copertina, scrivere nella parte address@hidden di copertina'' il
testo seguente:
+
address@hidden
address@hidden
+ con le seguenti sezioni non modificabili @var{lista dei loro titoli},
+ con i seguenti testi di prima di copertina @var{elenco},
+ e con i seguenti testi di quarta di copertina @var{elenco},
address@hidden group
address@hidden smallexample
+
+Se esistono delle sezioni non modificabili ma non i testi di copertina, o
+qualche altra combinazione dei tre elementi sopra riportati, fondere
+assieme le due alternative in modo da conformarsi alla situazione descritta.
+
+Se il vostro documento contiene esempi non banali di programma in codice
+sorgente si raccomanda di rilasciare gli esempi contemporaneamente
+applicandovi anche una licenza di software libero di vostra scelta, come
+per esempio la Licenza Pubblica Generica GNU, al fine di permetterne l'uso
+come software libero.
+
address@hidden ifclear
+
address@hidden
address@hidden Indice analitico
address@hidden Indice analitico
address@hidden ifnotdocbook
address@hidden cp
+
address@hidden
+
+Unresolved Issues:
+------------------
+1. From ADR.
+
+ Robert J. Chassell points out that awk programs should have some indication
+ of how to use them. It would be useful to perhaps have a "programming
+ style" section of the manual that would include this and other tips.
+
+Consistency issues:
+ /.../ regexps are in @code, not @samp
+ ".." strings are in @code, not @samp
+ no @print before @dots
+ values of expressions in the text (@code{x} has the value 15),
+ should be in roman, not @code
+ Use TAB and not tab
+ Use ESC and not ESCAPE
+ Use space and not blank to describe the space bar's character
+ The term "blank" is thus basically reserved for "blank lines" etc.
+ To make dark corners work, the @value{DARKCORNER} has to be outside
+ closing `.' of a sentence and after (pxref{...}).
+ " " should have an @w{} around it
+ Use "non-" only with language names or acronyms, or the words bug and
option and null
+ Use @command{ftp} when talking about anonymous ftp
+ Use uppercase and lowercase, not "upper-case" and "lower-case"
+ or "upper case" and "lower case"
+ Use "single precision" and "double precision", not "single-precision"
or "double-precision"
+ Use alphanumeric, not alpha-numeric
+ Use POSIX-compliant, not POSIX compliant
+ Use --foo, not -Wfoo when describing long options
+ Use "Bell Laboratories", but not "Bell Labs".
+ Use "behavior" instead of "behaviour".
+ Use "coprocess" instead of "co-process".
+ Use "zeros" instead of "zeroes".
+ Use "nonzero" not "non-zero".
+ Use "runtime" not "run time" or "run-time".
+ Use "command-line" as an adjective and "command line" as a noun.
+ Use "online" not "on-line".
+ Use "whitespace" not "white space".
+ Use "Input/Output", not "input/output". Also "I/O", not "i/o".
+ Use "lefthand"/"righthand", not "left-hand"/"right-hand".
+ Use "workaround", not "work-around".
+ Use "startup"/"cleanup", not "start-up"/"clean-up"
+ Use "filesystem", not "file system"
+ Use @code{do}, and not @address@hidden, except where
+ actually discussing the do-while.
+ Use "versus" in text and "vs." in index entries
+ Use @code{"C"} for the C locale, not ``C'' or @samp{C}.
+ The words "a", "and", "as", "between", "for", "from", "in", "of",
+ "on", "that", "the", "to", "with", and "without",
+ should not be capitalized in @chapter, @section etc.
+ "Into" and "How" should.
+ Search for @dfn; make sure important items are also indexed.
+ "e.g." should always be followed by a comma.
+ "i.e." should always be followed by a comma.
+ The numbers zero through ten should be spelled out, except when
+ talking about file descriptor numbers. > 10 and < 0, it's
+ ok to use numbers.
+ For most cases, do NOT put a comma before "and", "or" or "but".
+ But exercise taste with this rule.
+ Don't show the awk command with a program in quotes when it's
+ just the program. I.e.
+
+ {
+ ....
+ }
+
+ not
+ awk '{
+ ...
+ }'
+
+ Do show it when showing command-line arguments, data files, etc, even
+ if there is no output shown.
+
+ Use numbered lists only to show a sequential series of steps.
+
+ Use @code{xxx} for the xxx operator in indexing statements, not @samp.
+ Use MS-Windows not MS Windows
+ Use MS-DOS not MS DOS
+ Use an empty set of parentheses after built-in and awk function names.
+ Use "multiFOO" without a hyphen.
+ Use "time zone" as two words, not "timezone".
+
+Date: Wed, 13 Apr 94 15:20:52 -0400
+From: address@hidden (Richard Stallman)
+To: address@hidden
+Subject: A reminder: no pathnames in GNU
+
+It's a GNU convention to use the term "file name" for the name of a
+file, never "pathname". We use the term "path" for search paths,
+which are lists of file names. Using it for a single file name as
+well is potentially confusing to users.
+
+So please check any documentation you maintain, if you think you might
+have used "pathname".
+
+Note that "file name" should be two words when it appears as ordinary
+text. It's ok as one word when it's a metasyntactic variable, though.
+
+------------------------
+ORA uses filename, thus the macro.
+
+Suggestions:
+------------
+
+Better sidebars can almost sort of be done with:
+
+ @ifdocbook
+ @macro @sidebar{title, content}
+ @inlinefmt{docbook, <sidebar><title>}
+ \title\
+ @inlinefmt{docbook, </title>}
+ \content\
+ @inlinefmt{docbook, </sidebar>}
+ @end macro
+ @end ifdocbook
+
+
+ @ifnotdocbook
+ @macro @sidebar{title, content}
+ @cartouche
+ @center @b{\title\}
+
+ \content\
+ @end cartouche
+ @end macro
+ @end ifnotdocbook
+
+But to use it you have to say
+
+ @sidebar{Title Here,
+ @include file-with-content
+ }
+
+which sorta sucks.
+
+TODO:
+Check that all dark corners are indexed properly.
+
diff --git a/doc/it/gawktexi.in b/doc/it/gawktexi.in
new file mode 100755
index 0000000..678125e
--- /dev/null
+++ b/doc/it/gawktexi.in
@@ -0,0 +1,45878 @@
+\language=30
+\input texinfo @c -*-texinfo-*-
address@hidden vim: filetype=texinfo
address@hidden %**start of header (This is for running Texinfo on a region.)
address@hidden gawk-it.info
address@hidden Guida Utente di GNU Awk
address@hidden it
address@hidden %**end of header (This is for running Texinfo on a region.)
+
address@hidden Creazione e manipolazione di testi
address@hidden
+* Gawk: (gawk). Un linguaggio per scandire ed elaborare testi.
address@hidden direntry
address@hidden Programmi di address@hidden individuale
address@hidden
+* awk: (gawk)Avviare gawk. Scansione e processo di testi.
address@hidden direntry
+
address@hidden Enable better indexing, requires texindex from Texinfo 6 or
later.
address@hidden
+\global\usebracesinindexestrue
address@hidden tex
+
address@hidden FOR_PRINT
address@hidden
+\gdef\xrefprintnodename#1{``#1''}
address@hidden tex
address@hidden ifset
+
address@hidden FOR_PRINT
address@hidden With early 2014 texinfo.tex, restore PDF links and colors
address@hidden
+\gdef\linkcolor{0.5 0.09 0.12} % Dark Red
+\gdef\urlcolor{0.5 0.09 0.12} % Also
+\global\urefurlonlylinktrue
address@hidden tex
address@hidden ifclear
+
address@hidden
address@hidden BULLET @bullet{}
address@hidden MINUS @minus{}
address@hidden ifnotdocbook
+
address@hidden
address@hidden BULLET
address@hidden MINUS
address@hidden ifdocbook
+
address@hidden xref-automatic-section-title
+
address@hidden The following information should be updated here only!
address@hidden This sets the edition of the document, the version of gawk it
address@hidden applies to and all the info about who's publishing this edition
+
address@hidden These apply across the board.
address@hidden Aggiornata alla versione del 3 marzo 2017
address@hidden UPDATE-MONTH gennaio 2017
address@hidden VERSION 4.1
address@hidden PATCHLEVEL 4
+
address@hidden added Italian hyphenation stuff
address@hidden o-met-te-re o-met-ten-do}
+
address@hidden GAWKINETTITLE TCP/IP Internetworking with @command{gawk}
address@hidden FOR_PRINT
address@hidden TITLE Programmare efficacemente in awk
address@hidden ifset
address@hidden FOR_PRINT
address@hidden TITLE GAWK: Programmare efficacemente in AWK
address@hidden ifclear
address@hidden SUBTITLE Una Guida Utente per GNU Awk
address@hidden EDITION 4.1
+
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden SMALLPRINT
address@hidden DARKCORNER @address@hidden,1cm}, @image{rflashlight,1cm}}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden DARKCORNER @address@hidden,0.7cm}, @image{rflashlight,0.7cm}}
address@hidden ifset
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden iftex
address@hidden
address@hidden DOCUMENT File Info
address@hidden CHAPTER nodo principale
address@hidden APPENDIX nodo principale
address@hidden SECTION nodo secondario
address@hidden SECTIONS nodi secondari
address@hidden SUBSECTION nodo
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE videata
address@hidden ifinfo
address@hidden
address@hidden DOCUMENT Documento
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE videata
address@hidden ifhtml
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden ifdocbook
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden ifxml
address@hidden
address@hidden DOCUMENT libro
address@hidden CHAPTER capitolo
address@hidden APPENDIX appendice
address@hidden SECTION sezione
address@hidden SECTIONS sezioni
address@hidden SUBSECTION sottosezione
address@hidden DARKCORNER (a.b.)
address@hidden COMMONEXT (e.c.)
address@hidden PAGE pagina
address@hidden ifplaintext
+
address@hidden
address@hidden empty on purpose
address@hidden PART1
address@hidden PART2
address@hidden PART3
address@hidden PART4
address@hidden ifdocbook
+
address@hidden
address@hidden PART1 Parte I:@*
address@hidden PART2 Parte II:@*
address@hidden PART3 Parte III:@*
address@hidden PART4 Parte IV:@*
address@hidden ifnotdocbook
+
address@hidden some special symbols
address@hidden
address@hidden LEQ @address@hidden
address@hidden PI @address@hidden
address@hidden iftex
address@hidden
address@hidden LEQ @inlineraw{docbook, ≤}
address@hidden PI @inlineraw{docbook, &pgr;}
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden LEQ <=
address@hidden PI @i{pi}
address@hidden ifnotdocbook
address@hidden ifnottex
+
address@hidden
address@hidden
address@hidden ii{text}
address@hidden
address@hidden macro
address@hidden ifnotdocbook
address@hidden ifnottex
+
address@hidden
address@hidden ii{text}
address@hidden,<lineannotation>\text\</lineannotation>}
address@hidden macro
address@hidden ifdocbook
+
address@hidden FOR_PRINT
address@hidden FN nome-file
address@hidden FFN Nome-file
address@hidden for Italian plurals {FN}s
address@hidden FNS nomi-file
address@hidden FFNS Nomi-file
address@hidden DF file-dati
address@hidden DDF File-dati
address@hidden PVERSION versione
address@hidden ifclear
address@hidden FOR_PRINT
address@hidden FN nome-file
address@hidden FFN Nome-File
address@hidden for Italian plurals {FN}s
address@hidden FNS nomi-file
address@hidden FFNS Nomi-file
address@hidden DF file-dati
address@hidden DDF File-dati
address@hidden PVERSION Versione
address@hidden ifset
+
address@hidden For HTML, spell out email addresses, to avoid problems with
address@hidden address harvesters for spammers.
address@hidden
address@hidden EMAIL{real,spelled}
+``\spelled\''
address@hidden macro
address@hidden ifhtml
address@hidden
address@hidden EMAIL{real,spelled}
address@hidden
address@hidden macro
address@hidden ifnothtml
+
address@hidden Indexing macros
address@hidden
+
address@hidden cindexawkfunc{name}
address@hidden @code{\name\}
address@hidden macro
+
address@hidden cindexgawkfunc{name}
address@hidden @code{\name\}
address@hidden macro
+
address@hidden ifinfo
+
address@hidden
+
address@hidden cindexawkfunc{name}
address@hidden @code{\name\()}, funzione
address@hidden macro
+
address@hidden cindexgawkfunc{name}
address@hidden @code{\name\()}, funzione (@command{gawk})
address@hidden macro
address@hidden ifnotinfo
+
address@hidden
+Some comments on the layout for TeX.
+1. Use at least texinfo.tex 2016-02-05.07.
address@hidden ignore
+
address@hidden merge the function and variable indexes into the concept index
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden ifinfo
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden iftex
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden ifxml
address@hidden
address@hidden fn cp
address@hidden vr cp
address@hidden ifdocbook
+
address@hidden If "finalout" is commented out, the printed output will show
address@hidden black boxes that mark lines that are too long. Thus, it is
address@hidden unwise to comment it out when running a master in case there are
address@hidden overfulls which are deemed okay.
+
address@hidden
address@hidden
address@hidden iftex
+
address@hidden
address@hidden
+<para>
+“To boldly go where no man has gone before”
+(“Per arrivare address@hidden dove nessun uomo @`e mai giunto
prima”)
address@hidden un Marchio Registrato della Paramount Pictures
Corporation.</para>
+
+<para>Titolo originale:</para>
address@hidden: Effective AWK address@hidden
address@hidden User's Guide for GNU Awk}
+
+<para>Published by:</para>
+<literallayout class="normal">Free Software Foundation
+51 Franklin Street, Fifth Floor -- Boston, MA 02110-1301 USA
+Tel.: +1-617-542-5942 Fax: +1-617-542-2652 Email: <email>gnu@@gnu.org</email>
+URL: <ulink
url="http://www.gnu.org";>http://www.gnu.org/</ulink></literallayout>
+
+<literallayout class="normal">Copyright © 1989, 1991, 1992, 1993,
1996–2005, 2007, 2009–2017
+Free Software Foundation, Inc.
+All Rights Reserved.
+</literallayout>
+
+</para>Traduzione e revisione:<para>
+<literallayout class="normal">
+Antonio Giovanni Colombo -- <email>azc100(chiocciola)gmail(punto)com</email>
+Marco Curreli -- <email>marcocurreli(chiocciola)tiscali(punto)it</email>
+(Italian Linux Documentation Project (<ulink
url="http://www.pluto.it/ildp";>http://www.pluto.it/ildp/</ulink>)
+</literallayout>
+
+<para>Pubblicato da:</para>
+<literallayout class="normal">Free Software Foundation
+Email: <email>gnu@@gnu.org</email>
+URL: <ulink url="http://www.gnu.org";>http://www.gnu.org/</ulink>
+
+e da:
+Italian Linux Documentation Project (ILDP)
+Email: <emailildp@@pluto.it
+URL: <ulink
url="http://www.pluto.it/ildp";>http://www.pluto.it/ildp/</ulink></literallayout>
+
+<literallayout class="normal">Copyright © 2016
+Free Software Foundation, Inc.
+All Rights Reserved.
+</literallayout>
address@hidden docbook
+
address@hidden
address@hidden
+Copyright @copyright{} 2017 -- Free Software Foundation, Inc.
address@hidden iftex
address@hidden ifnotdocbook
address@hidden 2
+Questa @`e l'Edizione @value{EDITION} di @address@hidden: @value{SUBTITLE}},
+per la versione @address@hidden (o successiva)
+dell'implementazione GNU di AWK.
address@hidden
address@hidden
address@hidden
+(Titolo originale: @i{Gawk: Effective AWK Programming: A User's Guide for GNU
Awk.)}
address@hidden ifnotdocbook
address@hidden ifnotxml
address@hidden ifnottex
+
address@hidden garantito il permesso di copiare, distribuire e/o modificare
questo
+documento seguendo i termini della Licenza per Documentazione Libera
+GNU, Versione 1.3 o ogni versione successiva pubblicata dalla Free
+Software Foundation; con le Sezioni Non Modificabili ``GNU General
+Public License'', con i testi di copertina ``Un Manuale GNU'', e con i
+testi di quarta di copertina come in (a) address@hidden avanti.
address@hidden FOR_PRINT
+Una copia della licenza @`e acclusa nella sezione intitolata
+"Licenza per Documentazione Libera GNU".
address@hidden ifclear
address@hidden FOR_PRINT
+Una copia della licenza
+si address@hidden trovare in internet all'indirizzo
address@hidden://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html,
+il sito web del Progetto GNU}.
address@hidden ifset
+
address@hidden a
address@hidden
+Il testo di quarta di copertina della FSF @`e: address@hidden garantito il
permesso di
+copiare e modificare questo manuale GNU.''
address@hidden enumerate
address@hidden copying
+
address@hidden Comment out the "smallbook" for technical review. Saves
address@hidden considerable paper. Remember to turn it back on *before*
address@hidden starting the page-breaking work.
+
address@hidden 4/2002: Karl Berry recommends commenting out this and the
address@hidden address@hidden odd', and letting users use `texi2dvi -t'
address@hidden if they want to waste paper.
address@hidden @smallbook
+
+
address@hidden Uncomment this for the release. Leaving it off saves paper
address@hidden during editing and review.
address@hidden odd
+
address@hidden GNU Awk
address@hidden
address@hidden @value{TITLE}
address@hidden @value{SUBTITLE}
address@hidden Edizione @value{EDITION}
address@hidden @value{UPDATE-MONTH}
address@hidden Arnold D. Robbins
+
address@hidden
address@hidden Include the Distribution inside the titlepage environment so
address@hidden that headings are turned off. Headings on and off do not work.
+
address@hidden
address@hidden 0pt plus 1filll
+``To boldly go where no man has gone before''
+(``Per arrivare address@hidden dove nessun uomo @`e mai giunto prima'')
address@hidden un Marchio Registrato della Paramount Pictures Corporation. @*
address@hidden sorry, i couldn't resist
address@hidden 1
+Titolo originale:@*
address@hidden: Effective AWK address@hidden
address@hidden User's Guide for GNU Awk}
address@hidden 0
+Published by @strong{Free Software address@hidden
+51 Franklin Street, Fifth Floor -- Boston, MA 02110-1301 USA @*
+Tel.: +1-617-542-5942 -- Fax: +1-617-542-2652 -- Email: @email{gnu@@gnu.org} @*
+URL: @uref{http://www.gnu.org/}
address@hidden 0
address@hidden This one is correct for gawk 3.1.0 from the FSF
+ISBN 1-882114-28-0
address@hidden 0
+Copyright @copyright{} 1989, 1991, 1992, 1993, 1996--2005, 2007, 2009--2017 @*
+Free Software Foundation, Inc.
address@hidden 1
+Traduzione e revisione:@*
+Antonio Giovanni Colombo -- @email{azc100(chiocciola)gmail(punto)address@hidden
+Marco Curreli -- @email{marcocurreli(chiocciola)tiscali(punto)address@hidden
+(Italian Linux Documentation Project -- @uref{http://www.pluto.it/ildp})
address@hidden 1
+Pubblicato da:
+Free Software address@hidden
+Email: @email{gnu@@gnu.org}; URL: @uref{http://www.gnu.org/}
+
+e da:
+Italian Linux Documentation Project (ILDP)@*
+Email: @email{ildp@@pluto.it}; URL: @uref{http://www.pluto.it/ildp}
+
address@hidden
address@hidden 1
address@hidden ifnotdocbook
address@hidden titlepage
+
address@hidden Thanks to Bob Chassell for directions on doing dedications.
address@hidden
address@hidden off
address@hidden
address@hidden }
address@hidden 9
+
address@hidden SMALLPRINT
address@hidden @i{Ai miei genitori, per il loro amore, e per lo splendido
esempio che mi hanno dato.}
address@hidden 1
address@hidden @i{A mia moglie, Miriam, per avermi reso completo.
+Grazie per aver costruito la tua vita insieme a me.}
address@hidden 1
address@hidden @i{Ai nostri figli, Chana, Rivka, Nachum e Malka, per aver
arricchito le nostre vite in misura incalcolabile.}
address@hidden ifclear
+
address@hidden SMALLPRINT
address@hidden @i{Ai miei genitori, per il loro amore,}
address@hidden @i{ e per lo splendido esempio che mi hanno dato.}
address@hidden 1
address@hidden @i{A mia moglie, Miriam, per avermi reso completo.} @*
address@hidden @i{ Grazie per aver costruito la tua vita insieme a me.}
address@hidden 1
address@hidden @i{Ai nostri figli, Chana, Rivka, Nachum e Malka,}
address@hidden @i{per aver arricchito le nostre vite in misura incalcolabile.}
address@hidden ifset
+
address@hidden 1
address@hidden }
address@hidden
address@hidden }
address@hidden
address@hidden on
address@hidden iftex
+
address@hidden
+<dedication>
+<para>Ai miei genitori, per il loro amore, e per lo splendido
+esempio che mi hanno dato.</para>
+<para>A mia moglie Miriam, per avermi reso completo.
+Grazie per aver costruito la tua vita insieme con me.</para>
+<para>Ai nostri figli Chana, Rivka, Nachum e Malka,
+per aver arricchito le nostre vite in misura incalcolabile.</para>
+</dedication>
address@hidden docbook
+
address@hidden
address@hidden off
address@hidden @thispage@ @ @ @address@hidden @| @|
address@hidden @| @| @address@hidden@ @ @ @thispage
address@hidden iftex
+
address@hidden
address@hidden
address@hidden
address@hidden Top
address@hidden Introduzione Generale
address@hidden Preface node should come right after the Top
address@hidden node, in `unnumbered' sections, then the chapter, `What is gawk'.
address@hidden Licensing nodes are appendices, they're not central to AWK.
+
+Questo file documenta @command{awk}, un programma che si address@hidden usare
per
+selezionare dei record determinati in un file ed eseguire azioni su di essi.
+
address@hidden
+Copyright dell'edizione originale @copyright{} 1989, 1991, 1992, 1993,
1996--2005, 2007, 2009--2017 @*
+Free Software Foundation, Inc.
+
address@hidden
+Copyright dell'edizione italiana @copyright{} 2016 -- Free Software
Foundation, Inc.
+
+
address@hidden
+
address@hidden ifnotdocbook
address@hidden ifnotxml
address@hidden ifnottex
+
address@hidden
+* Introduzione3:: Alcune parole gentili riguardo a questo
+ @value{DOCUMENT}.
+* Introduzione4:: Ulteriori parole gentili.
+* Prefazione:: Di cosa tratta questo @value{DOCUMENT};
+ breve storia e ringraziamenti.
+* Per iniziare:: Un'introduzione elementare all'uso di
+ @command{awk}. Come eseguire un programma
+ @command{awk}. Sintassi della riga di
+ comando.
+* Invocare Gawk:: Come eseguire @command{gawk}.
+* Espressioni regolari:: Tutto quel che c'@`e da sapere
+ sull'individuazione di stringhe tramite
+ espressioni regolari.
+* Leggere file:: Come leggere file e manipolare campi.
+* Stampare:: Come stampare usando @command{awk}.
+ Descrizione delle istruzioni @code{print} e
+ @code{printf}. @`E descritta inoltre la
+ ridirezione dell'output.
+* Espressioni:: Le espressioni sono i componenti elementari
+ delle istruzioni.
+* Criteri di ricerca e azioni:: Panoramica sui criteri di ricerca e sulle
+ azioni.
+* Vettori:: La descrizione e l'uso dei vettori. Sono
+ inoltre descritte le istruzioni di controllo
+ relative ai vettori.
+* Funzioni:: Funzioni predefinite e definite dall'utente.
+* Funzioni di libreria:: Una libreria di funzioni di @command{awk}.
+* Programmi di esempio:: Molti programmi @command{awk} con
+ spiegazioni dettagliate.
+* address@hidden avanzate:: Roba per utenti sofisticati, propria di
+ @command{gawk}.
+* Internazionalizzazione:: Come far address@hidden@dotless{i}} che
@command{gawk} parli la
+ vostra lingua.
+* Debugger:: Il debugger di @command{gawk}.
+* Calcolo con precisione arbitraria:: Calcolo con precisione arbitraria in
+ @command{gawk}.
+* Estensioni dinamiche:: Aggiungere nuove funzioni predefinite di
+ @command{gawk}.
+* Storia del linguaggio:: L'evoluzione del linguaggio @command{awk}.
+* Installazione:: Installare @command{gawk} in vari sistemi
+ operativi.
+* Note:: Note riguardo ad aggiunte a @command{gawk}
+ e possibili futuri sviluppi.
+* Concetti fondamentali:: Velocissima introduzione alla
+ programmazione.
+* Glossario:: Spiegazione di alcuni termini poco
+ familiari.
+* Copia:: Il vostro diritto a copiare e distribuire
+ @command{gawk}.
+* Licenza per Documentazione Libera GNU (FDL):: La licenza per questo
+ @value{DOCUMENT}.
+* Indice analitico:: Indice dei concetti e delle variabili.
+
address@hidden
+* Storia:: La storia di @command{gawk} e
+ @command{awk}.
+* Nomi:: Che nome usare per trovare
+ @command{awk}.
+* Questo manuale:: Uso di questo @value{DOCUMENT}.
+ Comprende esempi di file in input
+ utilizzabili.
+* Convenzioni:: Convenzioni tipografiche.
+* Storia del manuale:: Breve storia del progetto GNU e di
+ questo @value{DOCUMENT}.
+* Come contribuire:: Un aiuto per la salvezza del mondo.
+* Ringraziamenti:: Ringraziamenti.
+* Eseguire gawk:: Come eseguire programmi
+ @command{gawk}; comprende la sintassi
+ della riga di comando.
+* Monouso:: Eseguire un breve programma
+ @command{awk} di tipo usa-e-getta.
+* Leggere dal terminale:: Senza uso di file in input (input
+ immesso da tastiera).
+* Lunghi:: Mettere programmi @command{awk}
+ permanenti in file.
+* @dfn{Script} eseguibili:: Preparare programmi @command{awk}
+ da eseguire come @dfn{script}.
+* Commenti:: Aggiungere documentazione a programmi
+ @command{gawk}.
+* Protezione:: Ulteriore discussione di problemi
+ connessi alle protezioni nella shell.
+* Doppi apici in DOS:: Doppi apici in file .BAT Windows
+* File dati di esempio:: File di dati di esempio da usare nei
+ programmi @command{awk} illustrati in
+ questo @value{DOCUMENT}.
+* Molto semplice:: Un esempio molto semplice.
+* Due regole:: Un esempio meno semplice di programma
+ di una riga, che usa due regole.
+* Maggiore sofisticazione:: Un esempio address@hidden complesso.
+* Istruzioni/Righe:: Suddividere o riunire istruzioni
+ su [una o address@hidden righe.
+* Altre address@hidden:: Altre address@hidden di
@command{awk}.
+* Quando:: Quando usare @command{gawk} e quando
+ usare altre cose.
+* Sommario dell'introduzione:: Sommario dell'introduzione.
+* Riga di comando:: Come eseguire @command{awk}.
+* Opzioni:: Opzioni sulla riga di comando e loro
+ significato.
+* Altri argomenti:: Nomi dei file in input e assegnamento
+ di valori a variabili.
+* Specificare lo standard input:: Come specificare lo standard input
+ insieme ad altri file.
+* Variabili d'ambiente:: Le variabili d'ambiente usate da
+ @command{gawk}.
+* AWKPATH (Variabile):: Ricerca di programmi @command{awk}
+ in una lista di directory.
+* AWKLIBPATH (Variabile):: Ricerca di librerie condivise
+ @command{awk} in una lista di
+ directory.
+* Altre variabili d'ambiente:: Le variabili d'ambiente.
+* Codice di ritorno:: Il codice di ritorno all'uscita
+ da @command{gawk}.
+* Includere file:: Come includere altri file nel
+ proprio programma.
+* Caricare librerie condivise:: Caricare librerie condivise nel
+ proprio programma.
+* Parti obsolete:: Opzioni e/o address@hidden obsolete.
+* Non documentato:: Opzioni e address@hidden non
documentate.
+* Sommario invocazione:: Sommario di come eseguire
+ @command{awk}.
+* Uso di @dfn{regexp}:: Come usare le espressioni regolari.
+* Sequenze di protezione:: Come scrivere caratteri non stampabili.
+* Operatori di espressioni regolari:: Operatori di espressioni regolari.
+* Espressioni tra parentesi quadre:: Cosa possono contenere @samp{[...]}.
+* address@hidden lungo da sinistra:: Quanto @`e lungo il testo
individuato.
+* Espressioni regolari calcolate:: Usare @dfn{regexp} dinamiche.
+* Operatori di @dfn{regexp} GNU:: Operatori propri del software GNU.
+* Maiuscolo-Minuscolo:: Fare confronti ignorando
+ maiuscolo/minuscolo.
+* Sommario espressioni regolari:: Sommario delle espressioni regolari.
+* Record:: Controllare come i dati sono suddivisi
+ in record.
+* awk divisione record:: Divisione dei record con @command{awk}
+ standard.
+* gawk divisione record:: Divisione dei record con
@command{gawk}.
+* Campi:: Un'introduzione ai campi.
+* Campi non costanti:: Numeri di campo variabili.
+* Cambiare i campi:: Cambiare il contenuto di un campo.
+* Separatori di campo:: I separatori di campo, e come
+ cambiarli.
+* Separatori di campo di default:: Come di solito sono separati i campi.
+* Separare campi con @dfn{regexp}:: Usare @dfn{regexp} come separatori.
+* Campi di un solo carattere:: Fare di ogni carattere un campo
+ separato.
+* Separatori campo da riga di comando:: Impostare @code{FS} dalla riga di
+ comando.
+* Campo intera riga:: Fare di una riga intera un campo
+ solo.
+* Sommario sulla separazione campi:: Alcuni punti finali e una tavola di
+ sommario.
+* Dimensione costante:: Leggere campi di larghezza costante.
+* Separazione in base al contenuto:: Definire campi dal loro Contenuto.
+* Righe multiple:: Record su righe multiple
+* Getline:: Richiedere input usando @code{getline}.
+* Getline semplice:: Usare @code{getline} senza argomenti.
+* Getline variabile:: Usare @code{getline} in una variabile.
+* Getline file:: Usare @code{getline} da un file.
+* Getline variabile file:: Usare @code{getline} in una variabile
+ da un file.
+* Getline @dfn{pipe}:: Usare @code{getline} da una @dfn{pipe}.
+* Getline variabile @dfn{pipe}:: Usare @code{getline} in una variabile
+ da una @dfn{pipe}.
+* Getline coprocesso:: Usare @code{getline} da un coprocesso.
+* Getline variabile coprocesso:: Usare @code{getline} in una variabile
+ da un coprocesso.
+* Note su getline:: Cose importanti da sapere su
+ @code{getline}.
+* Sommario di getline:: Sommario delle varianti di
+ @code{getline}.
+* Timeout in lettura:: Leggere input entro un tempo limite.
+* Proseguire dopo errore in input:: Rielaborare input dopo certi errori.
+* Directory su riga di comando:: Cosa accade se si mette una directory
+ sulla riga di comando.
+* Sommario di Input:: Sommario di Input.
+* Esercizi su Input:: Esercizi.
+* Print:: L'istruzione @code{print}.
+* Esempi su print:: Semplici esempi di
+ istruzioni @code{print}.
+* Separatori di output:: I separatori di output e come
+ modificarli.
+* OFMT:: Controllare l'output di numeri con
+ @code{print}.
+* Printf:: L'istruzione @code{printf}.
+* Printf Fondamenti:: Sintassi dell'istruzione
+ @code{printf}.
+* Lettere di controllo:: Lettere di controllo del formato.
+* Modificatori di formato:: Modificatori specifiche di formato.
+* Esempi su printf:: Numerosi esempi.
+* Ridirezione:: Come ridirigere l'output a diversi
+ file e @dfn{pipe}.
+* FD speciali:: File speciali per I/O.
+* File speciali:: Interpretazione @value{FNS} in
+ @command{gawk}. @command{gawk}
+ permette di accedere a descrittori di
+ file ereditati.
+* Altri file ereditati:: Accedere ad altri file aperti con
+ @command{gawk}.
+* Reti speciali:: File speciali per comunicazioni con
+ la rete.
+* Avvertimenti speciali:: Cose a cui prestare attenzione.
+* Chiusura file e @dfn{pipe}:: Chiudere file in input e di output e
+ @dfn{pipe}.
+* Continuazione dopo errori:: Abilitare continuazione dopo errori
+ in output.
+* Sommario di Output:: Sommario di Output.
+* Esercizi su Output:: Esercizi.
+* Valori:: Costanti, variabili ed espressioni
+ regolari.
+* Costanti:: Costanti di tipo stringa, numeriche ed
+ espressioni regolari.
+* Costanti scalari:: Costanti numeriche e stringhe.
+* Numeri non-decimali:: Cosa sono i numeri ottali ed
+ esadecimali.
+* Costanti come espressioni regolari:: Costanti fornite tramite espressioni
+ regolari.
+* Usare le costanti @dfn{regexp}:: Quando e come usare una costante
+ specificata tramite espressioni
+ regolari
+* Costanti @dfn{regexp} normali:: Costanti @dfn{regexp} normali in
+ @command{awk}.
+* Costanti @dfn{regexp} forti:: Costanti @dfn{regexp} fortemente
+ tipizzate.
+* Variabili:: Le variabili permettono di
+ definire valori da usare in seguito.
+* Usare variabili:: Usare variabili nei propri programmi.
+* Opzioni di assegnamento:: Impostare variabili dalla riga di
+ comando, e un sommario della sintassi
+ della riga di comando.
+ Questo @`e un metodo di input avanzato.
+* Conversione:: La conversione di stringhe in numeri
+ e viceversa.
+* Stringhe e numeri:: Come @command{awk} converte tra
+ stringhe e numeri.
+* Localizzazione e conversioni:: Come la localizzazione address@hidden
influire
+ sulle conversioni.
+* Tutti gli operatori:: Gli operatori di @command{gawk}.
+* Operatori aritmetici:: Operazioni aritmetiche (@samp{+},
+ @samp{-}, etc.)
+* Concatenazione:: Concatenazione di stringhe.
+* Operatori di assegnamento:: Cambiare il valore di una variabile
+ o di un campo.
+* Operatori di incremento:: Incrementare il valore numerico di una
+ variabile.
+* Valori e condizioni di address@hidden:: Determinare Vero/Falso.
+* Valori di address@hidden:: Cosa @`e ``vero'' e cosa @`e
``falso''.
+* Tipi di variabile e confronti:: Come alle variabili si assegna il tipo
+ e l'effetto che questo ha sul confronto
+ di numeri e stringhe con @samp{<}, etc.
+* Tipi di variabile:: Tipo stringa rispetto a tipo numero.
+* Operatori di confronto:: Gli operatori di confronto.
+* Confronto POSIX di stringhe:: Confronto tra stringhe usando le
+ regole POSIX.
+* Operatori booleani:: Combinare espressioni di confronto
+ usando operatori booleani @samp{||}
+ (``or''), @samp{&&} (``and'') e
+ @samp{!} (``not'').
+* Espressioni condizionali:: Le espressioni condizionali scelgono
+ una tra due sottoespressioni, a
+ seconda del valore di una terza
+ sottoespressione.
+* Chiamate di funzione:: Una chiamata di funzione @`e
+ un'espressione.
+* Precedenza:: Come si nidificano i vari operatori.
+* Localizzazioni:: Come la localizzazione influenza la
+ gestione dati.
+* Sommario delle espressioni:: Sommario delle espressioni.
+* Panoramica sui criteri di ricerca:: Come scrivere un criterio di ricerca.
+* @dfn{regexp} come criteri di ricerca:: Espressioni regolari come criteri
+ di ricerca.
+* Espressioni come criteri di ricerca:: Qualsiasi espressione address@hidden
servire da
+ criterio di ricerca.
+* Intervalli:: Specificare intervalli di record con i
+ criteri di ricerca.
+* BEGIN/END:: Specificare regole di inizio e fine
+ programma.
+* Usare BEGIN/END:: Come e perch@'e usare regole BEGIN/END.
+* I/O e BEGIN/END:: Problemi di I/O nelle regole BEGIN/END.
+* BEGINFILE/ENDFILE:: Due condizioni speciali per controlli
+ avanzati.
+* Vuoto:: Il criterio di ricerca vuoto, che
+ corrisponde a ogni record.
+* Usare variabili di shell:: Come usare variabili di shell in
+ @command{awk}.
+* Panoramica sulle azioni:: Cosa costituisce un'azione.
+* Istruzioni:: Descrizione dettagliata delle varie
+ istruzioni di controllo.
+* Istruzione if:: Eseguire in maniera condizionale
+ istruzioni @command{awk}.
+* Istruzione while:: Eseguire il ciclo, finch@'e @`e
+ verificata una condizione.
+* Istruzione do:: Eseguire l'azione specificata,
continuare
+ a eseguire il ciclo
+ finch@'e @`e verificata una condizione.
+* Istruzione for:: Un'altra istruzione iterativa, che
+ permette di specificare clausole
+ iniziali e di incremento.
+* Istruzione switch:: Valutazione di quale insieme di
+ istruzioni eseguire, a seconda del
+ valore assunto da una variabile.
+* Istruzione break:: Uscire subito dal ciclo address@hidden
interno
+ in cui ci si trova.
+* Istruzione continue:: Andare alla fine del ciclo
address@hidden interno
+ in cui ci si trova.
+* Istruzione next:: Smettere di elaborare il record
+ corrente.
+* Istruzione nextfile:: Smettere di elaborare il file
+ corrente.
+* Istruzione exit:: Interrompere l'esecuzione di
@command{awk}.
+* Variabili predefinite:: Sommario delle variabili predefinite.
+* Variabili modificabili dall'utente:: Variabili predefinite modificabili per
+ controllare @command{awk}.
+* Variabili auto-assegnate:: Variabili predefinite con cui
+ @command{awk} fornisce informazioni.
+* ARGC e ARGV:: Modi di usare @code{ARGC} e
+ @code{ARGV}.
+* Sommario criteri e azioni:: Sommario criteri e azioni.
+* Fondamenti sui vettori:: Informazioni di base sui vettori.
+* Introduzione ai vettori:: Introduzione ai vettori.
+* Visitare elementi:: Come esaminare un elemento di un
+ vettore.
+* Impostare elementi:: Come cambiare un elemento di un
+ vettore.
+* Esempio di vettore:: Esempio semplice di vettore
+* Visitare un intero vettore:: Variazione dell'istruzione
+ @code{for}. Cicla attraverso gli
+ indici degli elementi contenuti in
+ un vettore.
+* Controllare visita:: Controllare l'ordine in cui i vettori
+ sono visitati.
+* Indici numerici di vettore:: Come usare numeri come indici in
+ @command{awk}.
+* Indici non inizializzati:: Usare variabili non inizializzate
+ come indici.
+* Cancellazione:: L'istruzione @code{delete} toglie un
+ elemento da un vettore.
+* Vettori multidimensionali:: Emulare vettori multidimensionali in
+ @command{awk}.
+* Visitare vettori multidimensionali:: Visitare vettori multidimensionali.
+* Vettori di vettori:: Vettori multidimensionali veri.
+* Sommario dei vettori:: Sommario dei vettori.
+* Funzioni predefinite:: Riepilogo delle funzioni predefinite.
+* Chiamare funzioni predefinite:: Come chiamare funzioni predefinite.
+* Funzioni numeriche:: Funzioni che trattano numeri, comprese
+ @code{int()}, @code{sin()}
+ e @code{rand()}.
+* Funzioni per stringhe:: Funzioni di manipolazione di stringhe,
+ come @code{split()}, @code{match()}
+ e @code{sprintf()}.
+* Dettagli ostici:: address@hidden di quel che si vorrebbe
sapere su
+ @samp{\} e @samp{&} con @code{sub()},
+ @code{gsub()}, e @code{gensub()}.
+* Funzioni di I/O:: Funzioni per i file e per i comandi
+ della shell.
+* Funzioni di tempo:: Funzione per gestire marcature
temporali.
+* Funzioni a livello di bit:: Funzioni per operazioni di
+ manipolazione bit.
+* Funzioni per i tipi:: Funzioni per conoscere il tipo
+ di una variabile.
+* Funzioni di internazionalizzazione:: Funzioni per tradurre stringhe.
+* Funzioni definite dall'utente:: Descrizione dettagliata delle funzioni
+ definite dall'utente.
+* Sintassi delle definizioni:: Come scrivere definizioni e cosa
+ significano.
+* Esempio di funzione:: Un esempio di definizione di
+ funzione e spiegazione della stessa.
+* Precisazioni sulle funzioni:: Cose a cui prestare attenzione.
+* Chiamare una funzione:: Non usare spazi.
+* Campo di address@hidden variabili:: Variabili locali e globali.
+* Parametri per valore/riferimento:: Passaggio parametri.
+* Istruzione return:: Specificare il valore che una
+ funzione restituisce.
+* Variabili di tipo dinamico:: Come cambiare tipo a una variabile in
+ fase di esecuzione del programma.
+* Chiamate indirette:: Scegliere la funzione da chiamare in
+ fase di esecuzione del programma.
+* Sommario delle funzioni:: Sommario delle funzioni.
+* Nomi di variabili di libreria:: Che nomi @`e meglio dare alle variabili
+ private globali nelle funzioni di
+ libreria
+* Funzioni di tipo generale:: Funzioni di uso generale.
+* Funzione strtonum:: Da usare se non @`e disponibile la
+ funzione predefinita
+ @code{strtonum()}.
+* Funzione assert:: Una funzione per controllare
+ affermazioni in programmi
+ @command{awk}.
+* Funzione round:: Una funzione per eseguire
+ arrotondamenti se @code{sprintf()}
+ non lo fa correttamente.
+* Funzione random Cliff:: Il generatore Cliff di numeri casuali.
+* Funzioni ordinali:: Funzioni per usare caratteri come
+ numeri e viceversa.
+* Funzione join:: Una funzione per raccogliere un
+ vettore in una stringa.
+* Funzione getlocaltime:: Una funzione per ottenere data e
+ ora nel formato desiderato.
+* Funzione readfile:: Una funzione per leggere un file
+ intero in un colpo solo.
+* Apici alla shell:: Una funzione per passare stringhe
+ con apici alla shell.
+* Gestione File Dati:: Funzioni for gestire file dati
+ specificati sulla riga di comando,
+* Funzione filetrans:: Una funzione per gestire il passaggio
+ da un file in input al successivo.
+* Funzione rewind:: Una funzione per rileggere il file
+ di input.
+* Controllo di file:: Controllare che i file in input siano
+ accessibili.
+* File vuoti:: Controllare se i file in input sono
+ vuoti.
+* Ignorare assegnamenti di variabili:: Trattare assegnamenti di variabili
+ come nomi di file.
+* Funzione getopt:: Una funzione per trattare argomenti
+ presenti sulla riga di comando.
+* Funzioni Passwd:: Funzioni per ottenete informazioni
+ sull'utente [da /etc/passwd].
+* Funzioni Group:: Funzioni per ottenete informazioni
+ sul gruppo [da /etc/group].
+* Visitare vettori:: Una funzione per visitare vettori
+ di vettori.
+* Sommario funzioni di libreria:: Sommario funzioni di libreria.
+* Esercizi con le librerie:: Esercizi.
+* Eseguire esempi:: Come eseguire i programmi di esempio.
+* Cloni:: Cloni di programmi di address@hidden
comuni.
+* Programma cut:: Il programma di address@hidden
@command{cut}.
+* Programma egrep:: Il programma di address@hidden
@command{egrep}.
+* Programma id:: Il programma di address@hidden
@command{id}.
+* Programma split:: Il programma di address@hidden
@command{split}.
+* Programma tee:: Il programma di address@hidden
@command{tee}.
+* Programma uniq:: Il programma di address@hidden
@command{uniq}.
+* Programma wc:: Il programma di address@hidden
@command{wc}.
+* Programmi vari:: Alcuni interessanti programmi in
+ @command{awk}
+* Programma dupword:: Trovare parole duplicate in un
+ documento.
+* Programma alarm:: Un programma di sveglia.
+* Programma translate:: Un programma simile al comando di
+ address@hidden @command{tr}.
+* Programma labels:: Stampare etichette per lettere.
+* Programma utilizzo parole:: Un programma per produrre un contatore
+ dell'utilizzo di parole in un testo.
+* Programma riordino diario:: Eliminare righe doppie da un file di
+ cronologia.
+* Programma extract:: Estrarre programmi da file sorgenti
+ Texinfo.
+* Programma sed semplice:: Un semplice editor di flusso.
+* Programma igawk:: Un programma per fornire ad
+ @command{awk} la address@hidden di
+ includere file.
+* Programma anagram:: Trovare anagrammi da una lista di
+ parole.
+* Programma signature:: La gente fa cose stupefacenti se ha
+ troppo tempo libero.
+* Sommario dei programmi:: Sommario dei programmi.
+* Esercizi sui programmi:: Esercizi.
+* Dati non decimali:: Consentire dati di input in base
+ diversa da 10.
+* Ordinamento di vettori:: Modi per controllare la visita di un
+ vettore e il suo ordinamento.
+* Controllare visita vettori:: Come usare PROCINFO["sorted_in"].
+* Funzioni di ordinamento di vettori:: Come usare @code{asort()} e
+ @code{asorti()}.
+* I/O bidirezionale:: Comunicazione nei due sensi con un
+ altro processo.
+* Reti TCP/IP:: Usare @command{gawk} per
+ programmazione di rete.
+* Profilare:: Profilare i propri programmi
+ @command{awk}.
+* Sommario address@hidden avanzate:: Sommario address@hidden avanzate.
+* I18N e L10N:: Internazionalizzazione e localiz.
+* Utilizzare @command{gettext}:: Come funziona GNU @code{gettext}.
+* I18N per programmatore:: address@hidden per il programmatore.
+* I18N per traduttore:: address@hidden per il traduttore.
+* Estrazione di stringhe:: Estrarre stringhe marcate.
+* Ordinamento di printf:: Riordinare argomenti @code{printf}
+ [nelle stringhe da tradurre].
+* address@hidden nell'I18N:: Problemi di address@hidden a livello
di
+ @command{awk}.
+* Esempio I18N:: Un semplice esempio di
+ internazionalizzazione.
+* Gawk internazionalizzato:: @command{gawk} stesso @`e
+ internazionalizzato.
+* Sommario I18N:: Sommario sull'internazionalizzazione.
+* Debugging:: Introduzione al debugger di
+ @command{gawk}.
+* Nozioni sul debug:: address@hidden sul debug.
+* Terminologia nel debug:: Concetti fondamentali sul debug.
+* Debug di Awk:: Il debug di @command{awk}.
+* Esempio di sessione di debug:: Esempio di sessione di debug di
+ @command{gawk}.
+* Invocazione del debugger:: Come avviare il debugger.
+* Trovare il bug:: Trovare il bug.
+* Lista dei comandi di debug:: I principali comandi di debug.
+* Controllo dei breakpoint:: Controllo dei punti d'interruzione.
+* Controllo esecuzione debugger:: Controllo di esecuzione.
+* Vedere e modificare dati:: Vedere e modificare dati.
+* Stack di esecuzione:: Lavorare con lo stack.
+* Informazioni sul debugger:: Ottenere informazioni sullo stato
+ del programma e del debugger.
+* Comandi vari del debugger:: Comandi vari del debugger.
+* Supporto per Readline:: Supporto per Readline.
+* Limitazioni:: Limitazioni.
+* Sommario sul debug:: Sommario sul debug.
+* Aritmetica del computer:: Una rapida introduzione alla
matematica del
+ computer.
+* Definizioni matematiche:: Altre cose da sapere.
+* address@hidden MPFR:: address@hidden per il calcolo a
+ precisione arbitraria in @command{gawk}
+* Cautela col calcolo in VM:: Cose da sapere.
+* Inesattezza nei calcoli:: La matematica in virgola mobile non @`e
+ esatta.
+* Rappresentazioni inesatte:: Molti numeri non sono rappresentati
+ esattamente.
+* Confronti tra valori in VM:: Come confrontare valori in virgola
mobile.
+* Gli errori si sommano:: Gli errori diventano sempre maggiori.
+* Ottenere la precisione:: Ottenere la precisione voluta.
+* Tentare di arrotondare:: Tentare di aggiungere bit di
precisione e
+ arrotondare.
+* Impostare la precisione:: Impostare la precisione.
+* Impostare modi di arrotondare:: Impostare la address@hidden di
+ arrotondamento.
+* Interi a precisione arbitraria:: Aritmetica dei numeri interi a
precisione
+ arbitraria con @command{gawk}.
+* Problemi virgola mobile POSIX:: Confronto tra standard e uso corrente.
+* Sommario virgola mobile:: Sommario della trattazione della
+ virgola mobile.
+* Introduzione alle estensioni:: Cos'@`e un'estensione.
+* Licenza delle estensioni:: tipo di licenza delle estensioni.
+* Panoramica sul meccanismo delle estensioni:: Come funziona a grandi linee.
+* Descrizione dell'API delle estensioni:: Una descrizione completa dell'API.
+* Intro funzioni API delle estensioni:: Introduzione alle funzioni dell'API.
+* Tipi di dati generali:: I tipi di dati.
+* Funzioni di allocazione memoria:: Funzioni per allocare memoria.
+* Funzioni di costruzione:: Funzioni per creare valori.
+* Funzioni di registrazione:: Funzioni per registrare cose con
+ @command{gawk}.
+* Funzioni di estensione:: Registrare funzioni di estensione.
+* Funzioni di exit callback:: Registrare una exit di callback.
+* Stringa di versione Estensioni:: Registrare una stringa di versione.
+* Analizzatori di input:: Registrare un analizzatore di input.
+* Processori di output:: Registrare un processore di output.
+* Processori bidirezionali:: Registrare un processore
+ bidirezionale.
+* Stampare messaggi:: Stampare messaggi dalle estensioni.
+* Aggiornare @code{ERRNO}:: Funzioni per aggiornare @code{ERRNO}.
+* Richiedere valori:: Come ottenere un valore.
+* Accedere ai parametri:: Funzioni per acceder ai parametri.
+* Accedere alla tabella simboli:: Funzioni per accedere alle variabili
+ globali.
+* Tabella simboli per nome:: Accedere e aggiornare variabili per
nome.
+* Tabella simboli tramite cookie:: Accedere alle variabili per ``cookie''.
+* Valori nascosti:: Creare e usare valori nascosti.
+* Manipolazione di vettori:: Funzioni per lavorare coi vettori.
+* Tipi di dati per i vettori:: Tipi dati per lavorare coi vettori.
+* Funzioni per i vettori:: Funzioni per lavorare coi vettori.
+* Appiattimento di vettori:: Come appiattire i vettori.
+* Creazione di vettori:: Come creare e popolare vettori.
+* Ridirezione API:: Come accedere alla ridirezioni e
+ modificarle.
+* Variabili dell'estensione API:: Variabili fornite dall'API.
+* Versione dell'estensione:: Informazioni sulla versione API.
+* Variabili informative di estens. API:: Variabili che forniscono informazioni
+ sull'invocazione di @command{gawk}.
+* Codice predefinito di un'estensione API:: Codice predefinito di interfaccia
API.
+* Modifiche dalla versione API 1:: Modifiche dalla versione 1 dell'API.
+* Trovare le estensioni:: Come @command{gawk} trova le
+ estensioni compilate.
+* Esempio di estensione:: Esempio di codice C di un'estensione.
+* Descrizione interna file:: Quello che le nuove funzioni faranno.
+* Operazioni interne file:: Codice per gestire file all'interno.
+* Usare operazioni interne file:: Come usare un'estensione esterna.
+* Esempi di estensione:: Le estensioni di esempio incluse con
+ @command{gawk}.
+* Esempio di estensione funzioni file:: Funzioni relative ai file.
+* Esempio di estensione Fnmatch:: Un'interfaccia a @code{fnmatch()}.
+* Esempio di estensione Fork:: Un'interfaccia a @code{fork()} e
+ altre funzioni di processo.
+* Esempio di estensione Inplace:: Consentire modifica file input
+ nell'estensione.
+* Esempio di estensione Ord:: Conversioni di caratteri in valori
+ numerici e viceversa.
+* Esempio di estensione Readdir:: Un'interfaccia a @code{readdir()}.
+* Esempio di estensione Revout:: Invertire la stringa in output.
+* Esempio di estensione Rev2way:: Esempio di I/O bidirezionale.
+* Esempio di estensione Rwarray:: Scaricare e ricaricare un vettore.
+* Esempio di estensione Readfile:: Leggere un intero file in una stringa.
+* Esempio di estensione Time:: Un'interfaccia a @code{gettimeofday()}
+ e @code{sleep()}.
+* Esempio di estensione API Test:: Test per la API.
+* gawkextlib:: Il progetto @code{gawkextlib}.
+* Sommario delle estensioni:: Sommario delle estensioni.
+* Esercizi sulle estensioni:: Esercizi.
+* V7/SVR3.1:: Le principali differenze tra V7 e
+ System V Release 3.1.
+* SVR4:: Differenze minori tra System V
+ Release 3.1 e 4.
+* POSIX:: Nuove address@hidden per lo standard
+ POSIX.
+* BTL:: Nuove address@hidden dalla versione
+ di @command{awk} di Brian Kernighan.
+* POSIX/GNU:: Le estensioni in @command{gawk} non
+ previste in @command{awk} POSIX.
+* Storia delle address@hidden:: Storia delle address@hidden di
+ @command{gawk}.
+* Estensioni comuni:: Sommario Estensioni comuni.
+* Intervalli e localizzazione:: Come le localizzazioni influiscono
+ sugli intervalli delle espressioni
+ regolari.
+* Contributori:: I maggiori contributori a
+ @command{gawk}.
+* Sommario della storia:: Sommario della storia.
+* Distribuzione di Gawk:: Contenuto della distribuzione di
+ @command{gawk}.
+* Scaricare:: Come ottenere la distribuzione.
+* Scompattazione:: Come estrarre la distribuzione.
+* Contenuti della distribuzione:: Cosa c'@`e nella distribuzione.
+* Installazione Unix:: Installare @command{gawk} su
+ varie versioni di Unix.
+* Installazione veloce:: Compilare @command{gawk} sotto Unix.
+* File da usare a inizio sessione:: Funzioni di personalizzazione shell.
+* Ulteriori opzioni di configurazione:: Altre opzioni utilizzabili in fase
+ di compilazione.
+* Filosofia della configurazione:: Come si suppone che funzioni.
+* Installazione non-Unix:: Installazioni su altri Sistemi
+ Operativi.
+* Installazione su PC:: Installare e compilare
+ @command{gawk} su Microsoft Windows.
+* Installazione binaria su PC:: Installare una distribuzione pronta
+ all'uso.
+* Compilazione su PC:: Compilare @command{gawk} per
+ Windows32.
+* Uso su PC:: Eseguire @command{gawk} su Windows32.
+* Cygwin:: Compilare ed eseguire @command{gawk}
+ per Cygwin.
+* MSYS:: Usare @command{gawk} nell'ambiente
+ MSYS.
+* Installazione su VMS:: Installare @command{gawk} su VMS.
+* Compilazione su VMS:: Come compilare @command{gawk} su
+ VMS.
+* Estensioni dinamiche su VMS:: Compilare estensioni dinamiche
+ di @command{gawk} su VMS.
+* Dettagli installazione su VMS:: Come installare @command{gawk} su
+ VMS.
+* Esecuzione su VMS:: Come eseguire @command{gawk} su VMS.
+* GNV su VMS:: Il progetto GNV di VMS.
+* Vecchio Gawk su VMS:: Una versione non aggiornata arriva
+ con alcune versioni di VMS.
+* Bug:: Notificare problemi e bug.
+* Indirizzo Bug:: Dove notificare problemi.
+* Usenet:: Dove non notificare problemi.
+* Manutentori:: Manutentori di version non-*nix.
+* Altre versioni:: Altre implementazioni di
+ @command{awk} liberamente
+ disponibili.
+* Sommario dell'installazione:: Sommario dell'installazione.
+* address@hidden di address@hidden:: Come inibire alcune estensioni
di
+ @command{gawk}.
+* Aggiunte:: Fare aggiunte a @command{gawk}.
+* Accedere ai sorgenti:: Accedere al deposito sorgenti Git.
+* Aggiungere codice:: Aggiungere codice al programma
+ principale @command{gawk}.
+* Nuovi sistemi:: Rendere disponibile @command{gawk}
+ a un nuovo sistema operativo.
+* File derivati:: Perch@'e i file ancillari sono tenuti
+ nel deposito @command{git}.
+* Future estensioni:: Nuove address@hidden che potranno
+ essere implementate in futuro.
+* Limitazioni dell'implementazione:: Alcune limitazioni
+ dell'implementazione.
+* Progetto delle estensioni:: Note di progetto sull'estensione API.
+* Problemi con le vecchie estensioni:: Problemi con la precedente
+ implementazione di estensioni.
+* Obiettivi delle estensioni:: Obiettivi del nuovo meccanismo.
+* Altre scelte progettuali per le estensioni:: Qualche altra scelta
progettuale.
+* Futuri sviluppi delle estensioni:: address@hidden di crescita futura.
+* Meccanismo delle vecchie estensioni:: Problemi con le vecchie estensioni.
+* Sommario delle note:: Sommario delle note di
+ implementazione.
+* Fondamenti ad alto livello:: Una visione dall'alto.
+* Fondamenti sui tipi di dati:: Una velocissima introduzione ai tipi
+ di dati.
address@hidden detailmenu
address@hidden menu
+
address@hidden dedication for Info file
address@hidden
+Ai miei genitori, per il loro amore, e per lo splendido
+esempio che mi hanno dato.
address@hidden 1
+A mia moglie Miriam, per avermi reso completo.
+Grazie per aver costruito la tua vita insieme a me.
address@hidden 1
+Ai nostri figli Chana, Rivka, Nachum e Malka,
+per aver arricchito le nostre vite in misura incalcolabile.
address@hidden ifinfo
+
address@hidden SMALLPRINT
address@hidden 10
address@hidden ifset
+
address@hidden
address@hidden
+
address@hidden SMALLPRINT
address@hidden 11
address@hidden ifset
+
address@hidden Introduzione3
address@hidden Introduzione alla Terza Edizione
+
address@hidden This bit is post-processed by a script which turns the chapter
address@hidden tag into a preface tag, and moves this stuff to before the title.
address@hidden Bleah.
address@hidden
+ <prefaceinfo>
+ <author>
+ <firstname>Michael</firstname>
+ <surname>Brennan</surname>
+ <!-- can't put mawk into command tags. sigh. -->
+ <affiliation><jobtitle>Autore di mawk</jobtitle></affiliation>
+ </author>
+ <date>Marzo 2001</date>
+ </prefaceinfo>
address@hidden docbook
+
+Arnold Robbins e io siamo buoni amici. Ci siamo conosciuti
address@hidden 11 years ago
+nel 1990 per un insieme di
+circostanze---e per il nostro linguaggio di programmazione preferito, AWK.
+Tutto era iniziato un paio d'anni prima.
+Avevo appena iniziato un nuovo lavoro e avevo notato un computer Unix
scollegato
+che giaceva in un angolo.
+Nessuno sapeva come usarlo, tanto meno io. Comunque,
+qualche giorno address@hidden tardi, stava funzionando, con
+me come @code{root} e solo e unico utente.
+Quel giorno, iniziai la transizione da statistico a programmatore Unix.
+
+In uno dei miei giri per biblioteche e librerie alla ricerca di libri sullo
+Unix, trovai il libro, dalla copertina grigia, su AWK, noto anche come @:
+Alfred V.@: Aho, Brian W.@: Kernighan e
+Peter J.@: Weinberger, @cite{The AWK Programming Language}, (Addison-Wesley,
+1988). Il semplice paradigma di programmazione di AWK
+---trovare un'espressione di ricerca nell'input e di conseguenza compiere
+un'azione---riduceva spesso
+complesse e tediose manipolazioni di dati a poche righe di codice. Ero
+entusiasta di cimentarmi nella programmazione in AWK.
+
address@hidden, l'@command{awk} sul mio computer era una versione limitata del
+linguaggio descritto nel libro grigio. Scoprii che il mio computer aveva il
+``vecchio @command{awk}'' mentre il libro descriveva il ``nuovo
address@hidden''
+Imparai che non era un caso isolato; la vecchia versione si rifiutava di farsi
da
+parte o di cedere il suo nome. Se un sistema aveva un nuovo @command{awk},
+questo era chiamato invariabilmente @command{nawk}, e pochi sistemi lo avevano.
+Il miglior modo per ottenere un nuovo @command{awk} era quello di scaricare via
address@hidden il codice sorgente di @command{gawk} da @code{prep.ai.mit.edu}.
address@hidden era una versione del nuovo @command{awk} scritta da David Trueman
+e Arnold, e disponibile sotto la GNU General Public License.
+
+Per inciso, ora non @`e
address@hidden address@hidden@dotless{i}} difficile trovare un nuovo
@command{awk}. @command{gawk} viene
+fornito con GNU/Linux, e si possono scaricare i binari e il codice sorgente per
+quasi tutti i sistemi; mia moglie usa @command{gawk} nella sua stazione di
lavoro VMS.
+
+Il mio sistema Unix non era inizialmente collegato a una presa di corrente; a
+maggior ragione non era collegato a una rete. address@hidden@dotless{i}},
ignaro dell'esistenza di
address@hidden e in generale della address@hidden di Unix, e desiderando un
nuovo
address@hidden, ne scrissi uno mio, chiamato @command{mawk}. Prima di aver
+finito, scoprii l'esistenza di @command{gawk},
+ma era troppo tardi per fermarmi, address@hidden@dotless{i}} alla fine inviai
un messaggio
+a un newsgroup @code{comp.sources}.
+
+Qualche giorno dopo ricevetti un cordiale messaggio di posta elettronica
+da Arnold che si presentava.
+Propose di scambiarci progetti e algoritmi, e
address@hidden una bozza dello standard POSIX, che mi permise di
+aggiornare @command{mawk} per includere le estensioni al linguaggio
+aggiunte dopo la pubblicazione di @cite{The AWK Programming Language}.
+
+Francamente, se i nostri ruoli fossero stati
+invertiti, io non sarei stato address@hidden@dotless{i}} disponibile e
probabilmente non ci
+saremmo mai incontrati. Sono felice che l'incontro sia avvenuto.
+Lui @`e un vero esperto tra gli esperti di AWK e una persona squisita.
+Arnold mette a disposizione della Free Software Foundation parti significative
+della sua esperienza e del suo tempo.
+
+Questo libro @`e il manuale di riferimento di @command{gawk}, ma
sostanzialmente
address@hidden un libro sulla programmazione in AWK che
address@hidden un vasto pubblico.
address@hidden un riferimento completo al linguaggio AWK come definito dalla
versione del
+1987 di Bell Laboratories e codificato nelle POSIX Utilities
+standard del 1992.
+
+D'altra parte, un programmatore AWK alle prime armi address@hidden studiare
+una address@hidden di programmi pratici che permettono di apprezzare
+la potenza dei concetti di base di AWK:
+flusso di controllo guidato dai dati, ricerca di corrispondenze tramite
+espressioni regolari e vettori associativi.
+Chi desidera qualcosa di nuovo address@hidden provare l'interfaccia di
@command{gawk}
+verso i protocolli di rete attraverso i file speciali @file{/inet}.
+
+I programmi in questo libro evidenziano come un programma AWK sia
+generalmente molto address@hidden piccolo e veloce da sviluppare
+di uno equivalente scritto in C.
+Di conseguenza, @`e spesso conveniente creare un prototipo di un
+algoritmo o di un progetto in AWK per arrivare a eseguirlo in breve tempo e
+scoprire prima i problemi che possono presentarsi. Spesso, l'efficienza di
+questa versione iniziale interpretata @`e sufficiente e il prototipo
+AWK diventa il prodotto finale.
+
+Il nuovo comando @command{pgawk} (profiling @command{gawk}) produce
+conteggi sull'esecuzione delle istruzioni del programma.
+Recentemente ho fatto un tentativo con un algoritmo che, a fronte di
address@hidden
address@hidden
address@hidden ifnotdocbook
address@hidden
address@hidden
address@hidden ifdocbook
+righe di input, produceva il risultato in un tempo
address@hidden
+$\sim\! Cn^2$,
address@hidden tex
address@hidden
address@hidden
+~ C n^2,
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>∼ Cn<superscript>2</superscript></emphasis>
address@hidden docbook
+mentre in teoria
+avrebbe dovuto terminare in un tempo
address@hidden
+$\sim\! Cn\log n$.
address@hidden tex
address@hidden
address@hidden
+~ C n log n.
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>∼ Cn log n</emphasis>
address@hidden docbook
+Dopo qualche minuto di attenta lettura
+del profilo in @file{awkprof.out}, ho ricondotto il problema a
+una singola riga di codice. @command{pgawk} @`e una gradita integrazione
+ai miei strumenti di programmatore.
+
+Arnold ha condensato in questo libro oltre un decennio di esperienza nell'uso
di
+programmi AWK e nello sviluppo di @command{gawk}. Se si vuole usare
+AWK o imparare ad usarlo, @`e consigliabile leggere questo libro.
+
address@hidden
address@hidden Brennan, Michael
address@hidden
+Michael Brennan
+Autore di @command{mawk}
+Marzo 2001
address@hidden display
address@hidden ifnotdocbook
+
address@hidden Introduzione4
address@hidden Introduzione alla Quarta Edizione
+
address@hidden This bit is post-processed by a script which turns the chapter
address@hidden tag into a preface tag, and moves this stuff to before the title.
address@hidden Bleah.
address@hidden
+ <prefaceinfo>
+ <author>
+ <firstname>Michael</firstname>
+ <surname>Brennan</surname>
+ <!-- can't put mawk into command tags. sigh. -->
+ <affiliation><jobtitle>Autore di mawk</jobtitle></affiliation>
+ </author>
+ <date>Ottobre 2014</date>
+ </prefaceinfo>
address@hidden docbook
+
+Ci sono cose che non cambiano. Tredici anni fa scrivevo:
+``Se si vuole usare AWK o imparare ad usarlo, @`e consigliabile
+leggere questo libro.''
+Era vero allora e rimane vero anche oggi.
+
+Imparare a usare un linguaggio di programmazione richiede qualcosa di
address@hidden
+che padroneggiarne la sintassi. Occorre comprendere come
+usare le address@hidden del linguaggio per risolvere problemi pratici di
+programmazione. Uno dei punti address@hidden importanti di questo libro @`e
che
+fornisce molti esempi che mostrano come utilizzare AWK.
+
+Altre cose, invece, cambiano. I nostri computer sono diventati molto
address@hidden
+veloci e la loro memoria @`e molto address@hidden estesa.
+Per questa ragione, la address@hidden di esecuzione e l'uso efficiente della
+memoria, caratteristiche di un linguaggio di livello elevato, hanno minore
+rilevanza.
+Scrivere un programma prototipo in AWK per poi riscriverlo in C per
+migliorare l'utilizzo delle risorse capita sempre meno, perch@'e sempre
address@hidden
+spesso il prototipo @`e abbastanza veloce anche per essere messo in produzione.
+
+Naturalmente, ci sono tipi di calcoli che sono effettuati address@hidden
agevolmente
+da programmi scritti in C o C++.
+Con @command{gawk} 4.1 e successive versioni, non @`e necessario
+decidere se scrivere un programma in AWK oppure in C/C++. Si address@hidden
scrivere
+buona parte del programma in AWK e le parti che richiedono
+specificamente il C/C++ possono essere scritte in C/C++ e quindi il tutto
address@hidden essere eseguito come un programma unico, con il modulo
@command{gawk}
+che carica dinamicamente il modulo C/C++ in fase di esecuzione.
address@hidden Chapter 16
address@hidden
+Il
address@hidden iftex
address@hidden dinamiche},
+spiega la procedura in gran
+dettaglio, e, come prevedibile, riporta molti esempi che sono di aiuto per
+approfondire anche gli aspetti address@hidden complessi.
+
address@hidden per me un piacere programmare in AWK ed @`e stato divertente
(ri)leggere
+questo libro. Penso che address@hidden lo stesso per voi.
+
address@hidden
address@hidden Brennan, Michael
address@hidden
+Michael Brennan
+Autore di @command{mawk}
+Ottobre 2014
address@hidden display
address@hidden ifnotdocbook
address@hidden Prefazione
address@hidden Prefazione
address@hidden I saw a comment somewhere that the preface should describe the
book itself,
address@hidden and the introduction should describe what the book covers.
address@hidden
address@hidden 12/2000: Chuck wants the preface & intro combined.
+
address@hidden This bit is post-processed by a script which turns the chapter
address@hidden tag into a preface tag, and moves this stuff to before the title.
address@hidden Bleah.
address@hidden
+ <prefaceinfo>
+ <author>
+ <firstname>Arnold</firstname>
+ <surname>Robbins</surname>
+ <affiliation><jobtitle>Nof Ayalon</jobtitle></affiliation>
+ <affiliation><jobtitle>Israel</jobtitle></affiliation>
+ </author>
+ <date>Febbraio 2015</date>
+ </prefaceinfo>
address@hidden docbook
+
+Lavorando con file di testo capita di dover eseguire alcuni tipi ripetitivi di
+operazioni. Si potrebbe voler estrarre alcune righe e scartare il resto, o fare
+modifiche laddove siano verificate certe condizioni, lasciando inalterato il
+resto del file. Questi compiti risultano spesso address@hidden agevoli usando
address@hidden Il programma di address@hidden @command{awk} interpreta un
linguaggio
+di programmazione specializzato che rende facile eseguire semplici
address@hidden
+di riformattazione di dati.
+
address@hidden Brian Kernighan, @command{awk} di
+L'implementazione GNU di @command{awk} @`e chiamata @command{gawk}; se
+invocato con le opzioni o con le variabili d'ambiente appropriate,
+(@pxref{Opzioni}), @`e pienamente
+compatibile con le specifiche
address@hidden standard POSIX 2008 @`e accessibile in rete all'indirizzo
address@hidden@url{http://www.opengroup.org/onlinepubs/9699919799/}.}}
+del linguaggio @command{awk}
+e con la versione Unix di @command{awk} mantenuta
+da Brian Kernighan.
address@hidden implica che tutti i programmi
address@hidden scritti correttamente dovrebbero funzionare con @command{gawk}.
address@hidden nella maggior parte dei casi non si distingue tra @command{gawk}
e
+altre implementazioni di @command{awk}.
+
address@hidden @command{awk}, POSIX e, si veda anche POSIX @command{awk}
address@hidden @command{awk}, POSIX e
address@hidden POSIX, @command{awk} e
address@hidden @command{gawk}, @command{awk} e
address@hidden @command{awk}, @command{gawk} e
address@hidden @command{awk}, uso di
+Usando @command{awk} potete:
+
address@hidden @value{BULLET}
address@hidden
+Gestire piccole basi di dati personali
+
address@hidden
+Generare rapporti
+
address@hidden
+Validare dati
+
address@hidden
+Produrre indici ed effettuare altre operazioni per la preparazione di documenti
+
address@hidden
+Sperimentare algoritmi che possono essere adattati in seguito ad altri
+linguaggi per computer
address@hidden itemize
+
address@hidden @command{awk}, si veda anche @command{gawk}
address@hidden @command{gawk}, si veda anche @command{awk}
address@hidden @command{gawk}, uso di
+Inoltre,
address@hidden
+fornisce strumenti che rendono facile:
+
address@hidden @value{BULLET}
address@hidden
+Estrarre frammenti di dati per l'elaborazione
+
address@hidden
+Ordinare dati
+
address@hidden
+Effettuare semplici comunicazioni di rete
+
address@hidden
+Creare il profilo di esecuzione ed effettuare il debug
+di programmi @command{awk}.
+
address@hidden
+Estendere il linguaggio con funzioni scritte in C o C++.
address@hidden itemize
+
+Questo @value{DOCUMENT} spiega il linguaggio @command{awk} e come lo si
address@hidden
+usare efficacemente. @`E richiesta una address@hidden coi comandi di sistema
+di base, come @command{cat} e @command{ls},@footnote{Questi programmi di
address@hidden sono disponibili sui sistemi conformi a POSIX, come pure sui
sistemi
+tradizionali basati su Unix. Se si usa qualche altro sistema operativo, si
+deve comunque avere address@hidden con i concetti di ridirezione I/O e di
address@hidden address@hidden@dotless{i}} come con le address@hidden di base
della shell, come la
+ridirezione, l'input/output (I/O) e le @dfn{pipe}.
+
address@hidden GNU @command{awk}, si veda @command{gawk}
+Implementazioni del linguaggio @command{awk} sono disponibili per diversi
+sistemi operativi di computer. Questo @value{DOCUMENT}, oltre a descrivere il
+linguaggio @command{awk} in generale, descrive anche la specifica
+implementazione di @command{awk} chiamata @command{gawk} (che sta per
+``GNU @command{awk}''). @command{gawk} funziona su una vasta gamma di sistemi
+Unix, dai PC basati su architettura Intel fino
+a sistemi di potenza molto maggiore.
address@hidden @`e stato portato anche su Mac OS X,
+Microsoft Windows
+(tutte le versioni),
+e address@hidden altro sistema operativo obsoleto su cui
address@hidden era stato portato non @`e address@hidden mantenuto e il codice
specifico
+per quei sistemi @`e stato rimosso.}
+
address@hidden
+* Storia:: La storia di @command{gawk} e
+ @command{awk}.
+* Nomi:: Che nome usare per trovare
+ @command{awk}.
+* Questo manuale:: Uso di questo @value{DOCUMENT}.
+ Comprende esempi di file in input
+ utilizzabili.
+* Convenzioni:: Convenzioni tipografiche.
+* Storia del manuale:: Breve storia del Progetto GNU e di
+ questo @value{DOCUMENT}.
address@hidden FOR_PRINT
+* Aggiornamenti:: Come tenersi al corrente.
address@hidden ifset
+* Come contribuire:: Un aiuto per la salvezza del mondo.
+* Ringraziamenti:: Ringraziamenti.
address@hidden menu
+
address@hidden Storia
address@hidden La storia di @command{gawk} e @command{awk}
address@hidden ricetta per un linguaggio di programmazione
address@hidden linguaggio di programmazione, ricetta per un
address@hidden programmazione, ricetta per un linguaggio di
address@hidden Ricetta per un linguaggio di programmazione
+
address@hidden {2 parti di} {1 parte di @code{egrep}} {1 parte di
@code{snobol}}
address@hidden @tab 1 parte di @code{egrep} @tab 1 parte di @code{snobol}
address@hidden @tab 2 parti di @code{ed} @tab 3 parti di C
address@hidden multitable
+
+Mescolare bene tutte le parti usando @code{lex} e @code{yacc}.
+Preparare una concisa documentazione e distribuire.
+
+Dopo otto anni, aggiungere un'altra parte di @code{egrep} e altre due
+parti di C. Documentare molto bene e distribuire.
address@hidden sidebar
+
address@hidden Aho, Alfred
address@hidden Weinberger, Peter
address@hidden Kernighan, Brian
address@hidden @command{awk}, storia di
+Il nome @command{awk} deriva dalle iniziali dei suoi progettisti: Alfred V.@:
+Aho, Peter J.@: Weinberger e Brian W.@: Kernighan. La versione originale di
address@hidden fu scritta nel 1977 negli AT&T Bell Laboratories.
+Nel 1985, una nuova versione rese il linguaggio di programmazione
address@hidden potente, introducendo le funzioni definite dall'utente, flussi
di input
+multipli ed espressioni regolari calcolate.
+Questa nuova versione ebbe larga diffusione con Unix System V
+Release 3.1 (1987).
+La versione in System V Release 4 (1989) ha aggiunto alcune nuove
address@hidden
+e ha fatto pulizia nel comportamento di alcuni degli ``punti oscuri'' del
+linguaggio. Le specifiche per @command{awk} nello standard POSIX Command
+Language and Utilities ha in seguito reso address@hidden chiaro il linguaggio.
Sia i
+progettisti di @command{gawk} che quelli dell'originale @command{awk} dei Bell
+Laboratories hanno collaborato alla formulazione delle specifiche POSIX.
+
address@hidden Rubin, Paul
address@hidden Fenlason, Jay
address@hidden Trueman, David
+Paul Rubin ha scritto @command{gawk}, nel 1986.
+Jay Fenlason l'ha completata, seguendo i consigli di Richard Stallman.
+Anche John Woods ha fornito parti del codice. Nel 1988 e 1989, David Trueman,
+col mio aiuto, ha rivisto completamente @command{gawk} per la address@hidden
+col address@hidden recente @command{awk}.
+Intorno al 1994, sono divenuto il manutentore principale.
+Lo sviluppo corrente @`e incentrato sulla correzione degli errori, sul
+miglioramento delle prestazioni, sulla address@hidden agli standard e,
+occasionalmente, su nuove address@hidden
+
+Nel maggio 1997, J@"urgen Kahrs address@hidden@dotless{i}} la address@hidden
di un accesso alla
+rete da @command{awk}, e con un piccolo aiuto da parte mia, address@hidden ad
+aggiungere address@hidden a @command{gawk} per fare questo. A quel tempo,
+lui scrisse anche il grosso di
address@hidden@value{GAWKINETTITLE}}
+(un documento separato, disponibile come parte della distribuzione
address@hidden). Il suo codice alla fine venne integrato nella distribuzione
+principale di @command{gawk} con la versione 3.1 di @command{gawk}.
+
+John Haque ha riscritto la parte interna di @command{gawk}, mentre metteva a
+punto un debugger a livello di @command{awk}. Questa versione divenne
+disponibile come @command{gawk} versione 4.0 nel 2011.
+
address@hidden
+per un elenco completo di quelli che hanno fornito contributi importanti a
address@hidden
+
address@hidden Nomi
address@hidden Una rosa, con ogni altro nome...
+
address@hidden @command{awk}, nuovo e vecchio
+Il linguaggio @command{awk} si @`e evoluto nel corso degli anni. Tutti i
+dettagli si trovano in @ref{Storia del linguaggio}.
+Il linguaggio descritto in questo @value{DOCUMENT}
+viene spesso citato come ``nuovo @command{awk}''.
+Per analogia, la versione originale di @command{awk} @`e citata
+come ``vecchio @command{awk}.''
+
+Su molti sistemi di uso corrente, eseguendo il programma di address@hidden
address@hidden, si invoca qualche versione del nuovo
address@hidden@footnote{Solo i sistemi Solaris usano ancora un
+vecchio @command{awk} per il programma di address@hidden predefinito
address@hidden Una versione address@hidden moderna di @command{awk} si trova
+nella directory @file{/usr/xpg6/bin} su questi sistemi.} Se
+il comando @command{awk} nel sistema in uso @`e il vecchio, il
+risultato che vedrete per il programma di test che segue @`e
+del tipo:
+
address@hidden
+$ @kbd{awk 1 /dev/null}
address@hidden awk: syntax error near line 1
address@hidden awk: bailing out near line 1
address@hidden example
+
address@hidden
+Se questo @`e il caso, dovreste cercare una versione del nuovo @command{awk},
+o semplicemente installare @command{gawk}!
+
+All'interno di questo @value{DOCUMENT}, quando si fa riferimento a
address@hidden del linguaggio che dovrebbe essere disponibile in ogni
+implementazione completa di @command{awk} POSIX, viene usato il termine
address@hidden Quando si fa riferimento a una address@hidden specifica
+dell'implementazione GNU, viene usato i termine @command{gawk}.
+
address@hidden Questo manuale
address@hidden Uso di questo @value{DOCUMENT}
address@hidden @command{awk}, descrizione dei termini
+
+Il termine @command{awk} si riferisce sia a uno specifico programma sia al
+linguaggio che si usa per dire al programma stesso cosa deve fare. Quando
dobbiamo
+essere precisi, chiamiamo il linguaggio ``il linguaggio @command{awk},''
+e il programma ``l'address@hidden @command{awk}.''
+Questo @value{DOCUMENT} spiega
+sia come scrivere programmi nel linguaggio @command{awk} che come
+eseguire l'address@hidden @command{awk}.
+Il termine ``programma @command{awk}'' si riferisce a un programma scritto
+dall'utente nel linguaggio di programmazione @command{awk}.
+
address@hidden @command{gawk}, @command{awk} e
address@hidden @command{awk}, @command{gawk} e
address@hidden POSIX @command{awk}
+In primo luogo, questo @value{DOCUMENT} spiega le address@hidden di
@command{awk}
+come definite nello standard POSIX, e lo fa nel contesto dell'implementazione
address@hidden Oltre a questo, cerca anche di descrivere le differenze
+significative tra @command{gawk}
+e altre
address@hidden FOR_PRINT
+implementazioni @address@hidden queste differenze
+si trovano nell'indice alla
+voce ``differenze tra @command{awk} e @command{gawk}.''}
address@hidden ifclear
address@hidden FOR_PRINT
+implementazioni @command{awk}.
address@hidden ifset
+Infine, vien fatta rilevare ogni address@hidden di @command{gawk} non
+inclusa nello standard POSIX per @command{awk}.
+
address@hidden
+Questo @value{DOCUMENT} ha il difficile compito di essere tanto una guida
+introduttiva che un manuale di riferimento. I neofiti possono
+tranquillamente saltare i dettagli che sembrano loro troppo complessi.
+Possono anche ignorare i molti riferimenti incrociati, preparati avendo in
+mente gli utenti esperti e per le versioni Info e
address@hidden://www.gnu.org/software/gawk/manual/, HTML}
+del @value{DOCUMENT}.
address@hidden ifnotinfo
+
+Ci sono dei riquadri
+sparsi in tutto il @value{DOCUMENT}.
+Aggiungono una spiegazione address@hidden completa su punti importanti, ma che
+probabilmente non sono di interesse in sede di prima lettura.
address@hidden FOR_PRINT
+Si trovano tutti nell'indice analitico, alla voce ``sidebar.'' @c non c'e
riquadro nell'indice analitico
address@hidden ifclear
+
+La maggior parte delle volte, gli esempi usano programmi @command{awk}
completi.
+Alcune delle @value{SECTIONS} address@hidden avanzate mostrano solo la parte
del programma
address@hidden che illustra il concetto che si sta descrivendo.
+
+Sebbene questo @value{DOCUMENT} sia destinato soprattutto alle persone che non
+hanno una precedente conoscenza di @command{awk}, esso contiene anche tante
+informazioni che anche gli esperti di @command{awk} troveranno utili.
+In particolare, dovrebbero essere d'interesse la descrizione di POSIX
address@hidden e i programmi di esempio
address@hidden
+in
address@hidden ifnottex
address@hidden
+nel
address@hidden iftex
address@hidden di libreria} e
address@hidden
address@hidden
+in
address@hidden ifnottex
address@hidden ifnotdocbook
address@hidden
+nel
address@hidden iftex
address@hidden di esempio}.
+
+Questo @value{DOCUMENT} @`e suddiviso in diverse parti, come segue:
+
address@hidden FULLXREF ON
+
address@hidden @value{BULLET}
address@hidden
+La Parte I descrive il linguaggio @command{awk} e il programma @command{gawk}
+nel dettaglio.
+Inizia con le nozioni di base, e continua con tutte le caratteristiche di
address@hidden Contiene i seguenti capitoli:
+
address@hidden nested
address@hidden @value{MINUS}
address@hidden
address@hidden iniziare},
+fornisce le nozioni minime indispensabili per iniziare a usare @command{awk}.
+
address@hidden
address@hidden Gawk},
+descrive come eseguire @command{gawk}, il significato delle sue
+opzioni da riga di comando e come trovare i file sorgenti del programma
address@hidden
+
address@hidden
address@hidden regolari},
+introduce le espressioni regolari in generale, e in particolare le
address@hidden
+disponibili in @command{awk} POSIX e @command{gawk}.
+
address@hidden
address@hidden file},
+descrive come @command{awk} legge i dati inseriti dall'utente.
+Introduce i concetti di record e campi, e anche il
+comando @code{getline}.
+Contiene una prima descrizione della ridirezione I/O, e una breve descrizione
+dell'I/O di rete.
+
address@hidden
address@hidden,
+descrive come i programmi @command{awk} possono produrre output con
address@hidden e @code{printf}.
+
address@hidden
address@hidden,
+descrive le espressioni, che sono i componenti elementari di base
+per portare a termine la maggior parte delle operazioni in un programma.
+
address@hidden
address@hidden di ricerca e azioni},
+descrive come scrivere espressioni di ricerca per individuare corrispondenze
nei
+record, le azioni da eseguire quando si @`e trovata una corrispondenza
+in un record, e le variabili predefinite di @command{awk} e
address@hidden
+
address@hidden
address@hidden,
+tratta dell'unica struttura di dati di @command{awk}: il vettore associativo.
+Vengono trattati anche l'eliminazione di elementi del vettore e di interi
+vettori, e l'ordinamento dei vettori in @command{gawk}.
+Il @value{CHAPTER} descrive inoltre come @command{gawk} fornisce vettori di
+vettori.
+
address@hidden
address@hidden,
+descrive le funzioni predefinite fornite da @command{awk} e
address@hidden, e spiega come definire funzioni personalizzate. Viene
+anche spiegato come @command{gawk} permetta di invocare funzioni in
+maniera indiretta.
address@hidden itemize
+
address@hidden
+La Parte II illustra come usare @command{awk} e @command{gawk} per la
+risoluzione di problemi. Qui ci sono molti programmi da leggere e da cui
imparare.
+Questa parte contiene i seguenti capitoli:
+
address@hidden nested
address@hidden @value{MINUS}
address@hidden
address@hidden di libreria},
+fornisce diverse funzioni pensate per
+essere usate dai programmi scritti in @command{awk}.
+
address@hidden
address@hidden di esempio},
+fornisce molti programmi @command{awk} di esempio.
address@hidden itemize
+
+La lettura di questi due capitoli permette di capire come
address@hidden address@hidden risolvere problemi pratici.
+
address@hidden
+La Parte III si concentra sulle address@hidden specifiche di @command{gawk}.
+Contiene i seguenti capitoli:
+
address@hidden nested
address@hidden @value{MINUS}
address@hidden
address@hidden@`a avanzate},
+descrive diverse address@hidden avanzate.
+Di particolare rilevanza sono
+la address@hidden di controllare l'ordine di visita dei vettori,
+quella di instaurare comunicazioni bidirezionali con altri processi,
+di effettuare connessioni di rete TCP/IP, e di
+profilare i propri programmi @command{awk}.
+
address@hidden
address@hidden,
+descrive address@hidden speciali per tradurre i messaggi
+di programma in diverse lingue in fase di esecuzione.
+
address@hidden
address@hidden, descrive il debugger di @command{gawk}.
+
address@hidden
address@hidden con precisione arbitraria},
+illustra le address@hidden di calcolo avanzate.
+
address@hidden
address@hidden dinamiche},
+descrive come aggiungere nuove variabili e
+funzioni a @command{gawk} scrivendo estensioni in C o C++.
address@hidden itemize
+
address@hidden
address@hidden FOR_PRINT
+La Parte IV contiene le appendici, il Glossario, e due licenze relative,
+rispettivamente, al codice sorgente di @command{gawk} e a questo
address@hidden Contiene le seguenti appendici:
address@hidden ifclear
+
address@hidden FOR_PRINT
+La Parte IV contiene le seguenti appendici,
+che includono la Licenza per Documentazione Libera GNU:
address@hidden ifset
+
address@hidden @value{MINUS}
address@hidden
address@hidden del linguaggio},
+descrive l'evoluzione del linguaggio @command{awk} dalla sua prima versione
+fino a oggi. Descrive anche come @command{gawk}
+ha acquisito nuove address@hidden col passare del tempo.
+
address@hidden
address@hidden,
+descrive come ottenere @command{gawk}, come compilarlo
+sui sistemi compatibili con POSIX,
+e come compilarlo e usarlo su diversi sistemi
+non conformi allo standard POSIX. Spiega anche come segnalare gli errori
+di @command{gawk} e dove si possono ottenere altre implementazioni
+di @command{awk} liberamente disponibili.
+
address@hidden FOR_PRINT
address@hidden
address@hidden,
+presenta la licenza applicabile al codice sorgente @command{gawk}.
address@hidden ifset
+
address@hidden FOR_PRINT
address@hidden
address@hidden,
+descrive come disabilitare le estensioni @command{gawk},
+come contribuire scrivendo del nuovo codice per @command{gawk},
+e alcune possibili direzioni per il futuro sviluppo di @command{gawk}.
+
address@hidden
address@hidden fondamentali},
+fornisce del materiale di riferimento a livello elementare per chi
+sia completamente digiuno di programmazione informatica.
+
+Il @ref{Glossario}, definisce quasi tutti i termini significativi
+usati all'interno di questo @value{DOCUMENT}. Se si incontrano termini
+coi quali non si ha address@hidden, questo @`e il posto dove cercarli.
+
address@hidden
address@hidden, e
address@hidden per Documentazione Libera GNU (FDL)},
+presentano le licenze che si applicano, rispettivamente, al codice sorgente
+di @command{gawk} e a questo @value{DOCUMENT}.
address@hidden ifclear
address@hidden itemize
address@hidden itemize
+
address@hidden FOR_PRINT
+La versione di questo @value{DOCUMENT} distribuita con @command{gawk}
+contiene ulteriori appendici e altro materiale.
+Per ragioni di spazio, per questa edizione a stampa abbiamo tralasciato alcune
+delle appendici. Si possono trovare in rete ai seguenti indirizzi:
+
address@hidden @value{BULLET}
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/Notes.html,
+L'appendice sulle note di implementazione}
+descrive come disabilitare le estensioni @command{gawk}, come contribuire
+scrivendo del nuovo codice per @command{gawk}, dove reperire informazioni
+su alcune possibili future direzioni dello sviluppo di @command{gawk}, e
+sulle decisioni di progetto che hanno influito sulle estensioni API.
+
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/Basic-Concepts.html,
+L'appendice sui concetti fondamentali}
+fornisce del materiale di riferimento a livello elementare per chi sia
completamente a
+digiuno di programmazione informatica.
+
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/Glossary.html,
+Il Glossario}
+definisce la maggior parte, se non tutti, i termini significativi usati
+nel corso del libro. Se si incontrano termini con cui non si ha
address@hidden,
+questo @`e il posto dove cercarli.
+
address@hidden
address@hidden://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html,
la licenza GNU FDL}
address@hidden la licenza che vale per questo @value{DOCUMENT}.
address@hidden itemize
+
address@hidden ok not to use CHAPTER / SECTION here
+Alcuni dei capitoli hanno sezioni con esercizi; queste sono anche
+state omesse dall'edizione a stampa ma sono disponibili online.
address@hidden ifset
+
address@hidden FULLXREF OFF
+
address@hidden Convenzioni
address@hidden Convenzioni tipografiche
+
address@hidden Texinfo
+Questo @value{DOCUMENT} @`e scritto in
@uref{http://www.gnu.org/software/texinfo/, Texinfo},
+il linguaggio di formattazione della documentazione GNU. Viene usato un unico
+file sorgente Texinfo per produrre sia la versione a stampa della
documentazione
+sia quella online.
address@hidden
+A causa di address@hidden, le convenzioni tipografiche
+sono leggermente diverse da quelle presenti in altri libri che potete aver
letto.
address@hidden ifnotinfo
address@hidden
+Questo @value{SECTION} documenta brevemente le convenzioni tipografiche usate
in Texinfo.
address@hidden ifinfo
+
+Gli esempi da immettere sulla riga di comando sono preceduti dai
+comuni prompt di shell primario e secondario, @samp{$} e @samp{>}.
+L'input che si inserisce viene mostrato @kbd{in questo modo}.
address@hidden 8/2014: @print{} is stripped from the texi to make docbook.
address@hidden FOR_PRINT
+L'output del comando @`e preceduto dal glifo address@hidden'', che
+in genere rappresenta lo standard output del comando.
address@hidden ifclear
address@hidden FOR_PRINT
+L'output del comando, normalmente il suo standard output, @`e stampato
address@hidden questo modo}.
address@hidden ifset
+Messaggi di errore e altri output sullo standard error del comando sono
+preceduti dal glifo address@hidden''. Per esempio:
+
address@hidden
+$ @kbd{echo ciao su stdout}
address@hidden ciao su stdout
+$ @kbd{echo salve su stderr 1>&2}
address@hidden salve su stderr
address@hidden example
+
address@hidden
+Nel testo, quasi tutto address@hidden che riguarda la programmazione,
+per esempio i nomi dei comandi,
+appare in @code{questo font}. I frammenti
+di codice appaiono nello stesso font e tra apici, @samp{in questo modo}.
address@hidden che viene sostituito dall'utente o dal programmatore
+appare in @var{questo font}.
+Le opzioni sono stampate address@hidden@dotless{i}}: @option{-f}.
+I @value{FNS} sono indicati in questo modo: @file{/percorso/al/file}.
address@hidden FOR_PRINT
+Certe cose sono
+evidenziate @emph{in questo modo}, e se un punto dev'essere reso in modo
address@hidden
+marcato, viene evidenziato @strong{in questo modo}.
address@hidden ifclear
+La prima occorrenza di un
+nuovo termine @`e usualmente la sua @dfn{definizione} e appare nello stesso
+font della precedente occorrenza di ``definizione'' in questa frase.
address@hidden ifnotinfo
+
+I caratteri che si battono sulla tastiera sono scritti come @kbd{questi}. In
+particolare, ci sono caratteri speciali chiamati ``caratteri di controllo''.
+Questi sono caratteri che vengono battuti tenendo premuti il tasto
address@hidden e un altro tasto contemporaneamente.
+Per esempio, @kbd{Ctrl-d} @`e battuto premendo e tenendo premuto il tasto
address@hidden, poi premendo il tasto @kbd{d} e infine rilasciando entrambi i
+tasti.
+
+Per amor di address@hidden, in questo @value{DOCUMENT}, la versione di Brian
+Kernighan di @command{awk} address@hidden citata come ``BWK @command{awk}.''
+(@xref{Altre versioni} per informazioni su questa e altre versioni.)
+
address@hidden FOR_PRINT
address@hidden NOTA
+Note interessanti sono stampate in questo modo.
address@hidden quotation
+
address@hidden ATTENZIONE
+Note di avviso o raccomandazioni di cautela sono stampate in questo modo.
address@hidden quotation
address@hidden ifset
+
address@hidden fakenode --- for prepinfo
address@hidden Angoli Bui
address@hidden Kernighan, Brian
address@hidden
address@hidden angoli bui sono essenzialmente frattali---per quanto vengano
+illuminati, ce n'@`e sempre uno address@hidden piccolo e address@hidden buio.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden a.b., si veda angolo buio
address@hidden angolo buio
+Fino allo standard POSIX (e @address@hidden),
+molte caratteristiche di @command{awk} erano poco documentate o
+non documentate affatto. Le descrizioni di queste caratteristiche
+(chiamate spesso ``angoli bui'') sono segnalate in questo @value{DOCUMENT} con
address@hidden
+il disegno di una torcia elettrica nel margine, come mostrato qui.
address@hidden
address@hidden iftex
address@hidden
+``(a.b.)''.
address@hidden ifnottex
address@hidden FOR_PRINT
+Appaiono anche nell'indice sotto la voce ``angolo buio.''
address@hidden ifclear
+
+Ma come osservato nella citazione d'apertura, ogni trattazione degli
+angoli bui @`e per definizione incompleta.
+
address@hidden e.c., si veda estensioni comuni
+Estensioni al linguaggio standard di @command{awk} disponibili in
address@hidden di una
+implementazione di @command{awk} sono segnate
address@hidden FOR_PRINT
address@hidden,'' ed elencate nell'indice sotto ``estensioni comuni''
+e ``comuni, estensioni''.
address@hidden ifclear
address@hidden FOR_PRINT
address@hidden'' per ``estensioni comuni.''
address@hidden ifset
+
address@hidden Storia del manuale
address@hidden Breve storia del Progetto GNU e di questo @value{DOCUMENT}
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden Stallman, Richard
+La Free Software Foundation (FSF) @`e un'organizzazione senza scopo di lucro
+dedita alla produzione e distribuzione di software liberamente distribuibile.
address@hidden stata fondata da Richard M.@: Stallman, l'autore della prima
versione
+dell'editor Emacs. GNU Emacs @`e oggi la versione di Emacs address@hidden
largamente usata.
+
address@hidden Progetto GNU
address@hidden GNU, Progetto
address@hidden GPL (General Public License)
address@hidden General Public License, si veda GPL
address@hidden documentazione, online
+Il Progetto address@hidden sta per ``GNU's Not Unix.''}
address@hidden un progetto della Free Software
+Foundation in continuo sviluppo per creare un ambiente per computer completo,
liberamente
+distribuibile, conforme allo standard POSIX.
+La FSF usa la GNU General Public License (GPL) per assicurare che
+il codice sorgente del loro software sia sempre
+disponibile all'utente finale.
address@hidden FOR_PRINT
+Una copia della GPL @`e inclusa
address@hidden
+in questo @value{DOCUMENT}
address@hidden ifnotinfo
+per la consultazione
+(@pxref{Copia}).
address@hidden ifclear
+La GPL si applica al codice sorgente in linguaggio C per @command{gawk}.
+Per saperne di address@hidden sulla FSF e sul Progetto GNU,
+si veda @uref{http://www.gnu.org, la pagina principale del Progetto GNU}.
+Questo @value{DOCUMENT} si address@hidden leggere anche dal
address@hidden://www.gnu.org/software/gawk/manual/, sito di GNU}.
+
address@hidden FOR_PRINT
+Una shell, un editor (Emacs), compilatori ottimizzanti C, C++ e
+Objective-C altamente portabili, un debugger simbolico e dozzine di grandi e
+piccoli programmi di address@hidden (come @command{gawk}), sono stati
completati e
+sono liberamente disponibili. Il kernel del sistema operativo GNU (noto come
+HURD), @`e stato rilasciato ma @`e ancora allo stato di sviluppo iniziale.
+
address@hidden Linux
address@hidden GNU/Linux
address@hidden sistemi operativi basati su BSD
+In attesa che il sistema operativo GNU venga address@hidden completatamente
+sviluppato, si dovrebbe prendere in considerazione l'uso di GNU/Linux, un
+sistema operativo liberamente distribuibile e basato su Unix disponibile
+per Intel, Power Architecture,
+Sun SPARC, IBM S/390, e altri
address@hidden terminologia ``GNU/Linux'' @`e spiegata
+nel @ref{Glossario}.}
+Molte distribuzioni GNU/Linux sono
+scaricabili da internet.
address@hidden ifclear
+
address@hidden
+Il @value{DOCUMENT} @`e realmente libero---almeno, l'informazione che contiene
address@hidden libera per chiunque---. Il codice sorgente del
@value{DOCUMENT}, leggibile
+elettronicamente, viene fornito con @command{gawk}.
address@hidden FOR_PRINT
+(Dare un'occhiata alla Free Documentation
+License in @ref{Licenza per Documentazione Libera GNU (FDL)}.)
address@hidden ifclear
address@hidden ifnotinfo
+
address@hidden Close, Diane
+Il @value{DOCUMENT} in s@'e ha address@hidden avuto parecchie edizioni in
passato.
+Paul Rubin ha scritto la prima bozza di @cite{The GAWK Manual};, che era
+lunga una quarantina di pagine.
+Diane Close e Richard Stallman l'hanno migliorata arrivando alla
+versione che era
+lunga una novantina di pagine, e descriveva solo la versione originale
+``vecchia'' di @command{awk}.
+Ho iniziato a lavorare con quella versione nell'autunno del 1988.
+Mentre ci stavo lavorando,
+la FSF ha pubblicato parecchie versioni preliminari, numerate address@hidden).
+Nel 1996, l'edizione 1.0 fu rilasciata assieme a @command{gawk} 3.0.0.
+La FSF ha pubblicato le prime due edizioni col
+titolo @cite{GAWK: The GNU Awk User's Guide}.
address@hidden FOR_PRINT
+SSC ha pubblicato due edizioni del @value{DOCUMENT} col
+titolo @cite{Effective awk Programming}, e O'Reilly ha pubblicato
+la terza edizione nel 2001
address@hidden ifset
+
+Questa edizione mantiene la struttra di base delle edizioni precedenti.
+Per l'edizione FSF 4.0, il contenuto era stato accuratamente rivisto
+e aggiornato. Tutti i riferimenti a versioni di @command{gawk} anteriori alla
+versione 4.0 sono stati eliminati.
+Di particolare interesse in quella edizione era l'aggiunta del @ref{Debugger}.
+
+Per l'edizione FSF
address@hidden FOR_PRINT
address@hidden,
address@hidden ifclear
address@hidden FOR_PRINT
address@hidden
+(la quarta edizione, come pubblicata da O'Reilly),
address@hidden ifset
+il contenuto @`e stato riorganizzato in parti,
+e le aggiunte address@hidden importanti sono
address@hidden
+il
address@hidden iftex
address@hidden con precisione arbitraria}, e
address@hidden
+il
address@hidden iftex
address@hidden dinamiche}.
+
+Questo @value{DOCUMENT} address@hidden certamente ad evolversi. Se si trovano
+errori nel @value{DOCUMENT}, si prega di segnalarli! @xref{Bug}
+per informazioni su come inviare le segnalazione di problemi elettronicamente.
address@hidden FOR_PRINT
address@hidden Restare aggiornati
address@hidden Come restare aggiornati
+
+Potreste avere una versione di @command{gawk} address@hidden recente di quella
+descritta qui. Per vedere cosa @`e cambiato,
+dovreste prima guardare il file @file{NEWS} nella distribuzione di
address@hidden, che fornisce un sommario ad alto livello dei
+cambiamenti in ciascuna versione.
+
+You can then look at the @uref{http://www.gnu.org/software/gawk/manual/,
+online version} of this @value{DOCUMENT} to read about any new features.
address@hidden ifset
+
address@hidden FOR_PRINT
address@hidden Come contribuire
address@hidden Come collaborare
+
+Come manutentore di GNU @command{awk}, un tempo pensai che sarei stato in grado
+di gestire una raccolta di programmi @command{awk} pubblicamente disponibili e
+avevo anche esortato a collaborare. Rendere disponibili le cose su Internet
+aiuta a contenere la distribuzione @command{gawk} entro dimensioni gestibili.
+
+L'iniziale raccolta di materiale, come questo, @`e tuttora disponibile
+su @uref{ftp://ftp.freefriends.org/arnold/Awkstuff}.
+
+Chi fosse @emph{seriamente} interessato a contribuire nell'implementazione
+di un sito Internet dedicato ad argomenti riguardanti il
+linguaggio @command{awk}, @`e pregato di contattarmi.
+
address@hidden
+Nella speranza di
+fare qualcosa di address@hidden esteso, acquisii il dominio @code{awk.info}.
+
+Tuttavia, mi accorsi che non potevo dedicare abbastanza tempo per la gestione
+del codice inviato dai collaboratori: l'archivio non cresceva e il dominio
+rimase in disuso per diversi anni.
+
+Alla fine del 2008, un volontario si assunse il compito di mettere a punto
+un sito web collegato ad @address@hidden://awk.info}---e fece un
+lavoro molto ben fatto.
+
+Se qualcuno ha scritto un programma @command{awk} interessante, o un'estensione
+a @command{gawk} che vuole condividere col resto del mondo, @`e invitato a
+consultare la pagina @uref{http://awk.info/?contribute} per sapere come
+inviarlo per contribuire al sito web.
+
+Mentre scrivo, questo sito @`e in cerca di un responsabile; se qualcuno @`e
+interessato mi contatti.
address@hidden ignore
+
address@hidden
+Altri collegamenti:
+
+http://www.reddit.com/r/linux/comments/dtect/composing_music_in_awk/
address@hidden ignore
address@hidden ifclear
+
address@hidden Ringraziamenti
address@hidden Ringraziamenti
+
+La bozza iniziale di @cite{The GAWK Manual} riportava i seguenti
ringraziamenti:
+
address@hidden
+Molte persone devono essere ringraziate per la loro assistenza nella produzione
+di questo manuale. Jay Fenlason ha contribuito con molte idee e programmi di
+esempio. Richard Mlynarik e Robert Chassell hanno fatto utili osservazioni
+sulle bozze di questo manuale. Lo scritto
address@hidden Supplemental Document for AWK} di John W.@: Pierce, del
+Chemistry Department di UC San Diego, fa il punto su diverse questioni
rilevanti
+sia per l'implementazione di @command{awk} che per questo manuale, che
+altrimenti ci sarebbero sfuggite.
address@hidden quotation
+
address@hidden Stallman, Richard
+Vorrei ringraziare Richard M.@: Stallman, per la sua visione di un mondo
+migliore e per il suo coraggio nel fondare la FSF e nel dare inizio al
+Progetto GNU.
+
address@hidden FOR_PRINT
+Edizioni precedenti di questo @value{DOCUMENT} riportavano i seguenti
+ringraziamenti:
address@hidden ifclear
address@hidden FOR_PRINT
+La precedente edizione di questo @value{DOCUMENT} riportava
+i seguenti ringraziamenti:
address@hidden ifset
+
address@hidden
+Le seguenti persone (in ordine alfabetico)
+hanno inviato commenti utili riguardo alle diverse
+versioni di questo libro:
+Rick Adams,
+Dr.@: Nelson H.F. Beebe,
+Karl Berry,
+Dr.@: Michael Brennan,
+Rich Burridge,
+Claire Cloutier,
+Diane Close,
+Scott Deifik,
+Christopher (``Topher'') Eliot,
+Jeffrey Friedl,
+Dr.@: Darrel Hankerson,
+Michal Jaegermann,
+Dr.@: Richard J.@: LeBlanc,
+Michael Lijewski,
+Pat Rankin,
+Miriam Robbins,
+Mary Sheehan,
+e
+Chuck Toporek.
+
address@hidden Berry, Karl
address@hidden Chassell, Robert J.@:
address@hidden @cindex Texinfo
+Robert J.@: Chassell ha dato preziosissimi consigli
+sull'uso di Texinfo.
+Merita anche un particolare ringraziamento per avermi
+convinto a @emph{non} dare a questo @value{DOCUMENT}
+il titolo @cite{How to Gawk Politely}. [Un gioco di parole in inglese che
address@hidden
+significare sia
address@hidden usare Gawk educatamente}
+che @cite{Come curiosare educatamente}].
+Karl Berry ha aiutato in modo significativo con la parte @TeX{} di Texinfo.
+
address@hidden Hartholz, Marshall
address@hidden Hartholz, Elaine
address@hidden Schreiber, Bert
address@hidden Schreiber, Rita
+Vorrei ringraziare Marshall ed Elaine Hartholz di Seattle e il Dr.@: Bert e
Rita
+Schreiber di Detroit per i lunghi periodi di vacanza trascorsi in tutta
address@hidden in casa loro, che mi hanno permesso di fare importanti progressi
+nella scrittura di questo @value{DOCUMENT} e con lo stesso @command{gawk}.
+
address@hidden Hughes, Phil
+Phil Hughes di SSC
+ha contribuito in modo molto importante prestandomi il suo portatile col
sistema
+GNU/Linux, non una volta, ma due, il che mi ha permesso di fare tantissimo
lavoro
+mentre ero fuori casa.
+
address@hidden Trueman, David
+David Trueman merita un riconoscimento speciale; ha fatto un lavoro da
sentinella
+durante lo sviluppo di @command{gawk} affinch@'e funzioni bene e senza errori.
+Sebbene non sia address@hidden impegnato con @command{gawk},
+lavorare con lui a questo progetto @`e stato un vero piacere.
+
address@hidden Drepper, Ulrich
address@hidden GNITS mailing list
address@hidden mailing list, GNITS
+Gli intrepidi membri della lista GNITS, con una particolare menzione per Ulrich
+Drepper, hanno fornito un aiuto prezioso e commenti per il progetto
+delle address@hidden di internazionalizzazione.
+
+Chuck Toporek, Mary Sheehan, e Claire Cloutier della O'Reilly & Associates
hanno
+fornito un'assistenza editoriale rilevante per questo @value{DOCUMENT} per la
+versione 3.1 di @command{gawk}.
address@hidden quotation
+
address@hidden Beebe, Nelson H.F.@:
address@hidden Buening, Andreas
address@hidden Collado, Manuel
address@hidden Colombo, Antonio
address@hidden Davies, Stephen
address@hidden Deifik, Scott
address@hidden Demaille, Akim
address@hidden G., Daniel Richard
address@hidden Hankerson, Darrel
address@hidden Jaegermann, Michal
address@hidden Kahrs, J@"urgen
address@hidden Kasal, Stepan
address@hidden Malmberg, John E.
address@hidden Pitts, Dave
address@hidden Ramey, Chet
address@hidden Rankin, Pat
address@hidden Schorr, Andrew
address@hidden Vinschen, Corinna
address@hidden Zaretskii, Eli
+
+Dr.@: Nelson Beebe,
+Andreas Buening,
+Dr.@: Manuel Collado,
+Antonio Colombo,
+Stephen Davies,
+Scott Deifik,
+Akim Demaille,
+Daniel Richard G.,
+Darrel Hankerson,
+Michal Jaegermann,
+J@"urgen Kahrs,
+Stepan Kasal,
+John Malmberg,
+Dave Pitts,
+Chet Ramey,
+Pat Rankin,
+Andrew Schorr,
+Corinna Vinschen,
+ed Eli Zaretskii
+(in ordine alfabetico)
+costituiscono l'attuale ``gruppo di lavoro sulla address@hidden'' di
address@hidden Senza il loro duro lavoro e il loro aiuto,
address@hidden non sarebbe stato neanche lontanamente il buon programma che @`e
+oggi. @`E stato e continua a essere un piacere lavorare con questo gruppo
+di ottimi collaboratori.
+
+Notevoli contributi di codice e documentazione sono arrivati da
+parecchie persone. @xref{Contributori} per l'elenco completo.
+
address@hidden FOR_PRINT
address@hidden Oram, Andy
+Grazie ad Andy Oram della O'Reilly Media per aver iniziato
+la quarta edizione e per il suo aiuto in corso d'opera.
+Grazie a Jasmine Kwityn per il suo lavoro di revisione.
address@hidden ifset
+
+Grazie a Michael Brennan per le Prefazioni.
+
address@hidden Duman, Patrice
address@hidden Berry, Karl
+Grazie a Patrice Dumas per il nuovo programma @command{makeinfo}.
+Grazie a Karl Berry, che continua a lavorare per tenere
+aggiornato il linguaggio di marcatura Texinfo.
+
address@hidden Kernighan, Brian
address@hidden Brennan, Michael
address@hidden Day, Robert P.J.@:
+Robert P.J.@: Day, Michael Brennan e Brian Kernighan hanno gentilmente
+fatto da revisiori per l'edizione 2015 di questo @value{DOCUMENT}. Le loro
+osservazioni hanno contribuito a migliorare la stesura finale.
+
+Vorrei ringraziare Brian Kernighan per la sua preziosa assistenza durante
+la fase di collaudo e di debug di @command{gawk} e
+per l'aiuto in corso d'opera e i consigli nel chiarire diversi punti sul
+linguaggio. Non avremmo proprio fatto un address@hidden@dotless{i}} buon
lavoro su @command{gawk} e
+sulla sua documentazione senza il suo aiuto.
+
+Brian @`e un fuoriclasse sia come programmatore che come autore di manuali
+tecnici. @`E mio dovere ringraziarlo (una volta di address@hidden) per la sua
costante
+amicizia e per essere stato per me un modello da seguire ormai da quasi
+30 anni! Averlo come revisiore @`e per me un privilegio eccitante, ma @`e
+stata anche un'esperienza che mi ha fatto sentire molto address@hidden
+
address@hidden Robbins, Miriam
address@hidden Robbins, Jean
address@hidden Robbins, Harry
address@hidden D-o
+Devo ringraziare la mia meravigliosa moglie, Miriam, per la sua pazienza nel
+corso delle molte versioni di questo progetto, per la correzione delle bozze e
+per aver condiviso con me il computer.
+Vorrei ringraziare i miei genitori per il loro amore, e per la gentilezza con
cui
+mi hanno cresciuto ed educato.
+Infine, devo riconoscere la mia gratitudine a D-o, per le molte address@hidden
+che mi ha offerto, e anche per i doni che mi ha elargito, con cui trarre
+vantaggio da quelle address@hidden
address@hidden
address@hidden 2
address@hidden
+Arnold Robbins @*
+Nof Ayalon @*
+Israel @*
+Febbraio 2015
address@hidden ifnotdocbook
+
address@hidden
address@hidden @value{PART1}Il Linguaggio @command{awk}
address@hidden ifnotinfo
+
address@hidden
address@hidden Il Linguaggio @command{awk}
+
+La Parte I descrive il linguaggio @command{awk} e il programma @command{gawk}
+nel dettaglio. Inizia con le nozioni di base, e continua con tutte le
address@hidden di @command{awk}. Sono incluse anche molte, ma non tutte, le
address@hidden di @command{gawk}. Questa parte contiene i
+seguenti capitoli:
+
address@hidden @value{BULLET}
address@hidden
address@hidden iniziare}
+
address@hidden
address@hidden Gawk}
+
address@hidden
address@hidden regolari}
+
address@hidden
address@hidden file}
+
address@hidden
address@hidden
+
address@hidden
address@hidden
+
address@hidden
address@hidden e azioni}
+
address@hidden
address@hidden
+
address@hidden
address@hidden
address@hidden itemize
address@hidden ifdocbook
address@hidden Per iniziare
address@hidden Per iniziare con @command{awk}
address@hidden @cindex @dfn{script}, definizione di
address@hidden @cindex rule, definizione di
address@hidden @cindex program, definizione di
address@hidden @cindex basic function of @command{awk}
address@hidden @command{awk}, funzione di
+
+Il compito fondamentale di @command{awk} @`e quello di ricercare righe (o
+altre address@hidden di testo) in file che corrispondano a certi criteri di
ricerca.
+Quando una riga corrisponde a uno dei criteri, @command{awk} esegue su
+quella riga le azioni specificate per quel criterio. @command{awk} continua
+a elaborare righe in input in questo modo, finch@'e non raggiunge la fine delle
+righe nei file in input.
+
address@hidden @command{awk}, uso di
address@hidden linguaggi di address@hidden guidati-dai-dati/procedurali
address@hidden @command{awk}, programmi
+I programmi scritti in @command{awk} sono differenti dai programmi scritti
+nella maggior parte degli altri linguaggi,
+poich@'e i programmi @command{awk} sono @dfn{guidati dai dati} (ovvero,
+richiedono di descrivere i dati sui quali si vuole operare, e in seguito
+che cosa fare una volta che tali dati siano stati individuati).
+La maggior parte degli altri linguaggi sono @dfn{procedurali}; si deve
+descrivere, in maniera molto dettagliata, ogni passo che il programma
+deve eseguire. Lavorando con linguaggi procedurali, solitamente @`e
+molto address@hidden difficile descrivere chiaramente i dati che il programma
+deve elaborare.
+Per questa ragione i programmi @command{awk} sono spesso piacevolmente
+facili da leggere e da scrivere.
+
address@hidden programma, definizione di
address@hidden regola, definizione di
+Quando si esegue @command{awk}, va specificato un
address@hidden @command{awk} che
+dice ad @command{awk} cosa fare. Il programma consiste di una serie di
address@hidden (address@hidden anche contenere @dfn{definizioni di funzioni},
+una address@hidden avanzata che per ora ignoreremo;
address@hidden definite dall'utente}). Ogni regola specifica un
+criterio di ricerca e un'azione da effettuare
+una volta che viene trovato un record corrispondente.
+
+Sintatticamente, una regola consiste in un @dfn{criterio di ricerca}, seguito
+da una @dfn{azione}.
+L'azione @`e racchiusa tra parentesi graffe per separarla dal criterio di
+ricerca.
+Per separare regole, basta andare a capo. Quindi un programma
address@hidden ha una struttura simile a questa:
+
address@hidden
address@hidden @{ @var{azione} @}
address@hidden @{ @var{azione} @}
address@hidden
address@hidden example
+
address@hidden
+* Eseguire gawk:: Come iniziare a eseguire programmi
+ @command{gawk}; comprende la sintassi
+ della riga di comando.
+* File dati di esempio:: File di dati di esempio da usare nei
+ programmi @command{awk} illustrati in
+ questo @value{DOCUMENT}.
+* Molto semplice:: Un esempio molto semplice.
+* Due regole:: Un esempio meno semplice di programma
+ di una riga, che usa due regole.
+* Maggiore sofisticazione:: Un esempio address@hidden complesso.
+* Istruzioni/Righe:: Suddividere o riunire istruzioni
+ su [una o address@hidden righe.
+* Altre address@hidden:: Altre address@hidden di @command{awk}.
+* Quando:: Quando usare @command{gawk} e quando
+ usare altre cose.
+* Sommario dell'introduzione:: Sommario dell'introduzione.
address@hidden menu
+
address@hidden Eseguire gawk
address@hidden Come iniziare a eseguire programmi @command{gawk}
+
address@hidden programmi @command{awk}, eseguire
+Ci sono vari modi di eseguire un programma @command{awk}. Se il programma @`e
+corto, @`e address@hidden facile includerlo nel comando con cui si invoca
@command{awk},
address@hidden@dotless{i}}:
+
address@hidden
+awk '@var{programma}' @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden riga di comando, formati
+Quando il programma @`e lungo, di solito @`e meglio metterlo in un file
+ed eseguirlo con un comando come questo:
+
address@hidden
+awk -f @var{file-di-programma} @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden si occupa di entrambe queste address@hidden insieme
+a parecchie varianti di ciascuna di esse.
+
address@hidden
+* Monouso:: Eseguire un breve programma
+ @command{awk} di tipo usa-e-getta.
+* Leggere dal terminale:: Senza uso di file in input (input
+ immesso da tastiera).
+* Lunghi:: Mettere programmi @command{awk}
+ permanenti in file.
+* @dfn{Script} eseguibili:: Preparare programmi @command{awk}
+ da eseguire come @dfn{script}.
+* Commenti:: Aggiungere documentazione a programmi
+ @command{gawk}.
+* Protezione:: Ulteriore discussione di problemi
+ connessi all'uso di apici nella shell.
address@hidden menu
+
address@hidden Monouso
address@hidden Eseguire un breve programma @command{awk} usa-e-getta
+
+Una volta acquisita address@hidden con @command{awk}, address@hidden spesso di
+preparare semplici
+programmi nel momento in cui servono. In questo caso si address@hidden
scrivere
+il programma come primo argomento del comando @command{awk},
address@hidden@dotless{i}}:
+
address@hidden
+awk '@var{programma}' @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden
+dove @var{programma} consiste in una serie di criteri di ricerca e di
+azioni, come descritto precedentemente.
+
address@hidden apice singolo (@code{'})
address@hidden @code{'} (apice singolo)
+Questo formato di comando chiede alla @dfn{shell}, ossia all'interpretatore
+dei comandi, di richiamare @command{awk} e di usare il @var{programma} per
+trattare record nei file in input.
+Il @var{programma} @`e incluso tra apici in modo che
+la shell non interpreti qualche carattere destinato ad @command{awk} come
+carattere speciale
+della shell. Gli apici fanno inoltre address@hidden@dotless{i}} che la shell
tratti tutto il
address@hidden come un solo argomento per @command{awk}, e permettono che
address@hidden sia address@hidden lungo di una riga.
+
address@hidden shell, @dfn{script}
address@hidden programmi @command{awk}, eseguire, da @dfn{script} di shell
+Questo formato @`e utile anche per eseguire programmi @command{awk} di
+dimensioni piccole o medie da @dfn{script} di shell, perch@'e non richiede
+un file separato che contenga il programma @command{awk}. Uno @dfn{script}
+di shell @`e address@hidden affidabile, perch@'e non ci sono altri file che
possono
+venirsi a trovare fuori posto.
+
address@hidden avanti in questo capitolo,
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden
address@hidden
address@hidden ifdocbook
address@hidden semplice},
+si vedranno esempi di parecchi programmi,
+brevi, scritti sulla riga di comando.
+
address@hidden Leggere dal terminale
address@hidden Senza uso di file in input (input immesso da tastiera)
+
address@hidden standard input
address@hidden input, standard
address@hidden file in input, eseguire @command{awk} senza usarli
+Si address@hidden anche eseguire @command{awk} senza indicare alcun file in
input. Se
+si immette la seguente riga di comando:
+
address@hidden
+awk '@var{programma}'
address@hidden example
+
address@hidden
address@hidden prende come input del @var{programma} lo @dfn{standard input},
+che di solito significa qualsiasi cosa venga immesso dalla tastiera.
address@hidden prosegue finch@'e non si segnala una fine-file battendo
@kbd{Ctrl-d}.
+(In sistemi operativi non-POSIX, il carattere di fine-file address@hidden
essere diverso.)
+
address@hidden input, file in, si veda file in input
address@hidden file in input, eseguire @command{awk} senza usarli
address@hidden programmi @command{awk}, eseguire, senza file in input
+Per esempio, il seguente programma stampa un consiglio da amico
+(dalla @cite{Guida galattica per gli autostoppisti} di Douglas Adams ),
+per non lasciarsi spaventare dalle address@hidden della programmazione per
+computer:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Non v\47allarmate!" @}'}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden esegue le istruzioni associate a @code{BEGIN} prima di leggere
+qualsiasi input. Se non ci sono altre istruzioni nel proprio programma, come
+in questo caso, @command{awk} si ferma, invece di tentare di leggere input che
+non sa come elaborare.
+Il @samp{\47} @`e un modo straordinario (spiegato address@hidden avanti) per
inserire un
+apice singolo nel programma, senza dover ricorrere a fastidiosi meccanismi
+di protezione della shell.
+
address@hidden NOTA
+Se si usa Bash come shell, si dovrebbe digitare il comando @samp{set +H} prima
+eseguire questo programma interattivamente, per non avere una cronologia dei
+comandi nello stile della C shell, che tratta il @samp{!} come un carattere
+speciale. Si raccomanda di inserire quel comando nel proprio file di
+personalizzazione della shell.
address@hidden quotation
+
+Il seguente semplice programma @command{awk}
+emula il comando @command{cat}; ovvero copia qualsiasi cosa si
+batta sulla tastiera nel suo standard output (perch@'e succede @`e spiegato fra
+poco):
+
address@hidden
+$ @kbd{awk '@{ print @}'}
address@hidden @`e il tempo per tutti gli uomini buoni}
address@hidden Ora @`e il tempo per tutti gli uomini buoni
address@hidden venire in aiuto al loro paese.}
address@hidden di venire in aiuto al loro paese.
address@hidden sono sedici lustri e sette anni, ...}
address@hidden Or sono sedici lustri e sette anni, ...
address@hidden, io preoccupato?}
address@hidden Cosa, io preoccupato?
address@hidden
address@hidden example
+
address@hidden Lunghi
address@hidden Eseguire programmi lunghi
+
address@hidden programmi @command{awk}, eseguire
address@hidden programmi @command{awk}, lunghi
address@hidden file, programmi @command{awk} in
+Talora i programmi @command{awk} sono molto lunghi. In tali situazioni
+conviene mettere il programma in un file separato. Per dire ad
address@hidden di usare quel file come programma, digitare:
+
address@hidden
+awk -f @var{file-sorgente} @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden @option{-f}, opzione
address@hidden riga di comando, opzione @option{-f}
+L'opzione @option{-f} dice al comando @command{awk} di ottenere il programma
address@hidden dal file @var{file-sorgente} (@pxref{Opzioni}).
+Ogni @value{FN} address@hidden essere usato come @var{file-sorgente}. Per
esempio, si
+potrebbe mettere il programma:
+
address@hidden
+BEGIN @{ print \"Non v'allarmate!\" @}
address@hidden example
+
address@hidden
+nel file @file{consiglio}. Allora questo comando:
+
address@hidden
+awk -f consiglio
address@hidden example
+
address@hidden
address@hidden equivalente al comando:
+
address@hidden
+awk 'BEGIN @{ print \"Non v\47allarmate!\" @}'
address@hidden example
+
address@hidden protezione, nella riga di comando di @command{gawk}
address@hidden
+Questo @`e address@hidden stato spiegato prima
+(@pxref{Leggere dal terminale}).
+Si noti che normalmente non serve mettere apici singoli nel @value{FN} che si
+fornisce con @option{-f}, perch@'e di solito i @value{FNS} non contengono
+caratteri che sono speciali per la shell. Si noti che in @file{consiglio},
+il programma @command{awk} non ha dei doppi apici che lo delimitano. I
+doppi apici sono necessari solo per programmi scritti direttamente sulla riga
+di comando di @command{awk}.
+(Inoltre, se il programma si trova in un file, @`e possibile usare un apice
+singolo all'interno del programma, invece del magico @samp{\47}.)
+
address@hidden apice singolo (@code{'}), nella riga di comando di @command{gawk}
address@hidden @code{'} (apice singolo), nella riga di comando di @command{gawk}
+Per identificare chiaramente un file di programma @command{awk} come tale,
+si address@hidden aggiungere il suffisso @file{.awk} al @value{FN}.
address@hidden non
+cambia l'esecuzione del programma @command{awk} ma semplifica
+la ``manutenzione''.
+
address@hidden @dfn{Script} eseguibili
address@hidden Programmi @command{awk} da eseguire come @dfn{script}
address@hidden programmi @command{awk}
address@hidden @code{#} (cancelletto), @code{#!} (@dfn{script} eseguibili)
address@hidden Unix, @dfn{script} @command{awk} e
address@hidden cancelletto (@code{#}), @code{#!} (@dfn{script} eseguibili)
+
+Una volta familiarizzato con @command{awk}, si potrebbero scrivere
address@hidden che richiamano @command{awk}, usando il meccanismo di
address@hidden @samp{#!}. address@hidden @`e
+possibile in molti sistemi address@hidden meccanismo @samp{#!}
+funziona nei sistemi
+GNU/Linux, in quelli basati su BSD e nei sistemi Unix a pagamento.}
+Per esempio, si potrebbe modificare il file @file{consiglio} e farlo divenire:
+
address@hidden
+#! /bin/awk -f
+
+BEGIN @{ print \"Non v'allarmate!\" @}
address@hidden example
+
address@hidden
+Dopo aver reso eseguibile questo file (con il comando @command{chmod}),
+digitare semplicemente @samp{consiglio}
+al prompt della shell e il sistema si address@hidden a eseguire @command{awk}
+come se si fosse digitato @samp{awk -f consiglio}:
+
address@hidden
+$ @kbd{chmod +x consiglio}
+$ @kbd{consiglio}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden
+(Si suppone che la directory corrente sia tra quelle contenute nella variabile
+che indica il "percorso" di ricerca [solitamente @code{$PATH}]. In caso
+contrario si potrebbe aver bisogno di digitare @samp{./consiglio} nella
+shell.)
+
address@hidden @command{awk} autocontenuti sono utili se si vuol scrivere un
+programma che gli utenti possono richiamare senza dover essere informati che
+il programma @`e scritto in @command{awk}.
+
address@hidden Comprendere @samp{#!}
address@hidden address@hidden, @code{#!} (@dfn{script} eseguibili)
+
address@hidden @`e un linguaggio @dfn{interpretato}. address@hidden significa
che il
+comando @command{awk} legge il programma dell'utente e poi elabora i dati
+secondo le istruzioni contenute nel programma (diversamente da un linguaggio
address@hidden come il C, dove il programma viene prima compilato in codice
+macchina che @`e eseguito direttamente dal processore del sistema). Il
+programma di address@hidden @command{awk} @`e address@hidden chiamato
@dfn{interpretatore}.
+Molti linguaggi moderni sono interpretati.
+
+La riga che inizia con @samp{#!} lista l'intero @value{FN} di un
+interpretatore
+da richiamare, con degli argomenti facoltativi che saranno passati a
+quell'interpretatore sulla riga di comando. Il sistema operativo quindi
+richiama l'interpretatore con gli argomenti dati e con l'intera lista di
+argomenti con cui era stato invocato il programma. Il primo argomento nella
+lista @`e l'intero @value{FN} del programma @command{awk}. Il resto della
lista
+degli argomenti contiene opzioni per @command{awk}, oppure @value{DF}, o
+entrambi. (Si noti che in molti sistemi @command{awk} address@hidden essere
trovato in
address@hidden/usr/bin} invece che in @file{/bin}.)
+
+Alcuni sistemi limitano la lunghezza del nome del programma interpretarore a
+32 caratteri. Spesso, si address@hidden rimediare utilizzando un collegamento
simbolico.
+
+Non si dovrebbero mettere altri argomenti oltre al primo nella riga @samp{#!}
+dopo il percorso del comando @command{awk}. Non funziona. Il sistema
+operativo tratta il resto della riga come un argomento solo, e lo passa ad
address@hidden
address@hidden@dotless{i}} facendo il comportamento address@hidden poco chiaro;
con ogni address@hidden un
+messaggio di errore di qualche tipo da @command{awk}.
+
address@hidden variabili @code{ARGC}/@code{ARGV}, address@hidden e
address@hidden address@hidden, variabile @code{ARGV}
+Infine, il valore di @code{ARGV[0]}
+(@pxref{Variabili predefinite})
address@hidden variare a seconda del sistema operativo.
+Alcuni sistemi ci mettono @samp{awk}, altri il nome completo del percorso
+di @command{awk} (ad. es. @file{/bin/awk}), e altri ancora mettono il nome
+dello @dfn{script} dell'utente (@samp{consiglio}). @value{DARKCORNER}
+Non bisogna fidarsi del valore di @code{ARGV[0]}
+per ottenere il nome del proprio @dfn{script}.
address@hidden sidebar
+
address@hidden Commenti
address@hidden Documentare programmi @command{gawk}.
address@hidden @code{#} (cancelletto), commentare
address@hidden cancelletto (@code{#}), commentare
address@hidden commentare
address@hidden programmi @command{awk}, documentazione
+
+Un @dfn{commento} @`e del testo incluso in un programma per aiutare le
+persone che lo leggeranno; non @`e parte del programma eseguibile vero e
+proprio. I commenti possono spiegare cosa fa il programma e come funziona.
+Quasi tutti i linguaggi di programmazione possono contenere commenti, poich@'e
+i programmi sono solitamente difficili da comprendere senza di essi.
+
+Nel linguaggio @command{awk}, un commento inizia con il segno del
+cancelletto (@samp{#}) e continua fino alla fine della riga.
+Il @samp{#} non deve necessariamente essere il primo carattere della riga.
+Il linguaggio @command{awk} ignora il resto di una riga dopo il carattere
+cancelletto.
+Per esempio, potremmo mettere quel che segue in @file{consiglio}:
+
address@hidden
+# Questo programma stampa uno scherzoso consiglio amichevole.
+# Aiuta a far passare la paura del computer agli utenti novelli.
+BEGIN @{ print "Non v'allarmate!" @}
address@hidden example
+
+Si possono mettere dei commenti nei programmi @command{awk} usa-e-getta da
+digitare direttamente da tastiera, ma address@hidden solitmanete non serve
molto; il
+fine di un commento @`e di aiutare l'utente o qualcun altro a comprendere il
+programma, quando lo rilegge in un secondo tempo.
+
address@hidden protezione, per piccoli programmi awk
address@hidden apice singolo (@code{'}), vs.@: apostrofo
address@hidden @code{'} (apice singolo), vs.@: apostrofo
address@hidden ATTENZIONE
+Come detto in
address@hidden,
+si possono includere programmi di dimensioni da piccole a medie tra apici
+singoli, per mantenere compatti i propri @dfn{script} di shell
+autocontenuti. Nel far questo, @emph{non} bisogna inserire un apostrofo
+(ossia un apice singolo) in un commento, (o in qualsiasi altra parte del
+vostro programma). La shell interpreta gli apici singoli come delimitatori
+di chiusura dell'intero programma. Di conseguenza, solitamente la shell
+emette un messaggio riguardo ad apici presenti in numero dispari, e se
address@hidden viene comunque eseguito, @`e probabile che stampi strani
+messaggi di errori di sintassi.
+Per esempio, nel caso seguente:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Ciao" @} # un'idea brillante'}
+>
address@hidden example
+
+La shell considera il secondo apice singolo come delimitatore del testo
+precedente, e trova che un nuovo testo tra apici ha inizio verso la fine
+della riga di comando. A causa di address@hidden emette una richiesta
secondaria di
+input, e si mette in attesa di ulteriore input.
+Con il comando @command{awk} Unix, se si chiude l'ulteriore stringa tra
+apici singoli il risultato @`e il seguente:
+
address@hidden
+$ @kbd{awk '@{ print "Ciao" @} # un'idea brillante'}
+> @kbd{'}
address@hidden awk: fatale: non riesco ad aprire file `brillante'
address@hidden in lettura (File o directory non esistente)
address@hidden example
+
address@hidden @code{\} (barra inversa)
address@hidden barra inversa (@code{\})
+Mettere una barra inversa prima dell'apice singolo in @samp{un'idea} non
+risolverebbe, poich@'e le barre inverse non sono speciali all'interno di apici
+singoli.
+La prossima @value{SUBSECTION} descrive le regole di protezione della shell.
address@hidden quotation
+
address@hidden Protezione
address@hidden Uso di apici nella shell.
address@hidden shell, uso di apici, regole per
+
address@hidden
+* Doppi apici in DOS:: Passaggio di apici in file .BAT Windows.
address@hidden menu
+
+Per programmi @command{awk} di lunghezza da corta a media spesso conviene
+digitare il programma sulla riga di comando @command{awk}.
+La maniera migliore per farlo @`e racchiudere l'intero programma tra apici
+singoli.
+Questo vale sia che si digiti il programma interattivamente su
+richiesta della shell, sia che lo si scriva come parte di uno @dfn{script}
+di shell di maggiori dimensioni:
+
address@hidden
+awk '@var{testo del programma}' @var{input-file1} @var{input-file2} @dots{}
address@hidden example
+
address@hidden shell, uso di apici, regole per
address@hidden Bourne shell, uso di apici, regole per la
+Quando si lavora con la shell, non guasta avere una conoscenza
+di base sulle regole per l'uso di apici nella shell. Le regole
+seguenti valgono solo per shell in stile Bourne (come Bash, la
+Bourne-Again shell). Se si usa la C shell, si avranno regole differenti.
+
+Prima di immergerci nelle regole, introduciamo un concetto che ricorre
+in tutto questo @value{DOCUMENT}, che @`e quello della stringa @dfn{null},
+o vuota.
+
+La stringa nulla @`e una variabile, di tipo carattere, che non ha un valore.
+In altre parole, @`e vuota. Nei programmi @command{awk} si scrive
address@hidden@dotless{i}}:
address@hidden""}. Nella shell la si address@hidden scrivere usando apici sia
singoli
+che doppi: @code{""} oppure @code{''}. Sebbena la stringa nulla non contenga
+alcun carattere, essa esiste lo stesso. Si consideri questo comando:
+
address@hidden
+$ @kbd{echo ""}
address@hidden example
+
address@hidden
+Qui, il comando @command{echo} riceve un solo argomento, anche se
+quell'argomento non contiene alcun carattere. Nel resto di questo
address@hidden, usiamo indifferentemente i termini @dfn{stringa nulla}
+e @dfn{stringa vuota}. Ora, proseguiamo con le regole relative agli apici:
+
+
address@hidden @value{BULLET}
address@hidden
+Elementi tra apici possono essere concatenati con elementi non tra apici.
+La shell converte il tutto in un singolo argomento da passare
+al comando.
+
address@hidden
+Mettere una barra inversa (@samp{\}) prima di qualsiasi singolo carattere
+lo protegge. La shell toglie la barra inversa e passa il carattere
+protetto al comando.
+
address@hidden
address@hidden @code{\} (barra inversa), nei comandi di shell
address@hidden barra inversa (@code{\}), nei comandi di shell
address@hidden apice singolo (@code{'}), nei comandi di shell
address@hidden @code{'} (apice singolo), nei comandi di shell
+Gli apici singoli proteggono qualsiasi cosa sia inclusa tra un apice di
+apertura e uno di chiusura.
+La shell non interpreta il testo protetto, il quale viene passato
address@hidden@dotless{i}} com'@`e
+al comando.
address@hidden @emph{impossibile} inserire un apice singolo in un testo
racchiuso fra
+apici singoli. Potete trovare in
address@hidden
+un esempio di cosa succede se si prova a farlo.
+
address@hidden
address@hidden doppio apice (@code{"}), nei comandi shell
address@hidden @code{"} (doppio apice), nei comandi shell
+I doppi apici proteggono la maggior parte di quel che @`e racchiuso tra i
+doppi apici di apertura e quelli di chiusura.
+La shell effettua almeno la sostituzione di variabili e di comandi
+sul testo racchiuso tra doppi apici.
+Shell differenti possono fare ulteriori tipi di elaborazione
+sul testo racchiuso tra doppi apici.
+
+Poich@'e alcuni caratteri all'interno di un testo racchiuso tra doppi apici
+sono interpretati dalla shell, essi devono essere @dfn{protetti} all'interno
+del testo stesso. Sono da tener presenti i caratteri
address@hidden, @samp{`}, @samp{\}, e @samp{"}, tutti i quali devono essere
+preceduti da una barra inversa quando ricorrono all'interno di un testo
+racchiuso tra doppi apici, per poter essere passati letteralmente al
+programma. (La barra inversa viene tolta prima del passaggio al programma.)
+Quindi, l'esempio visto
address@hidden
+precedentemente
address@hidden ifnotinfo
+in @ref{Leggere dal terminale}:
+
address@hidden
+awk 'BEGIN @{ print "Non v\47allarmate!" @}'
address@hidden example
+
address@hidden
+si potrebbe scrivere invece address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{awk "BEGIN @{ print \"Non v'allarmate!\" @}"}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden apice singolo (@code{'}), con doppio apice
address@hidden @code{'} (apice singolo), con doppio apice
+Va notato che l'apice singolo non @`e speciale all'interno di un testo
+racchiuso tra doppi apici.
+
address@hidden
+Le stringhe nulle sono rimosse se presenti come parte di un argomento
+non-nullo sulla riga di comando, mentre oggetti esplicitamente nulli
+sono mantenuti come tali.
+Per esempio, per richiedere che il separatore di campo @code{FS} sia
+impostato alla stringa nulla, digitare:
+
address@hidden
+awk -F "" '@var{programma}' @var{file} # corretto
address@hidden example
+
address@hidden
address@hidden stringa nulla come argomento a @command{gawk}, protezione della
+Non @`e invece da usare:
+
address@hidden
+awk -F"" '@var{programma}' @var{file} # errato!
address@hidden example
+
address@hidden
+Nel secondo caso, @command{awk} tenta di usare il nome del programma come
+valore di @code{FS}, e il primo @value{FN} come testo del programma!
address@hidden come minimo genera un errore di sintassi, e un comportamento
confuso nel
+caso peggiore.
address@hidden itemize
+
address@hidden protezione, nella riga di comando di @command{gawk}, trucchi per
+Mischiare apici singoli e doppi @`e difficile. Occorre utilizzare
+trucchi della shell per gli apici, come questi:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un apice singolo. <'"'"'>" @}'}
address@hidden Questo @`e un apice singolo. <'>
address@hidden example
+
address@hidden
+Questo programma stampa tre stringhe tra apici concatenate tra loro.
+La prima e la terza sono rinchiuse tra apici singoli, la seconda tra apici
+doppi.
+
+Quanto sopra address@hidden essere ``semplificato'' address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un apice singolo <'\''>" @}'}
address@hidden Questo @`e un apice singolo <'>
address@hidden example
+
address@hidden
+A voi la scelta del address@hidden leggibile dei due.
+
+Un'altra opzione @`e quella di usare doppi apici, proteggendo i doppi apici
+inclusi, a livello @command{awk}:
+
address@hidden
+$ @kbd{awk "BEGIN @{ print \"Questo @`e un apice singolo <'>\" @}"}
address@hidden Questo @`e un apice singolo <'>
address@hidden example
+
address@hidden
+Quest'opzione @`e fastidiosa anche perch@'e il doppio apice, la barra inversa e
+il simbolo del dollaro sono molto comuni nei programmi @command{awk}
address@hidden
+avanzati.
+
+Una terza opzione @`e quella di usare le sequenze ottali equivalenti
+(@pxref{Sequenze di protezione})
+per i caratteri
+apice singolo e doppio, address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un apice singolo <\47>" @}'}
address@hidden Questo @`e un apice singolo <'>
+$ @kbd{awk 'BEGIN @{ print "Questo @`e un doppio apice <\42>" @}'}
address@hidden Questo @`e un doppio apice <">
address@hidden example
+
address@hidden
+Questo funziona bene, ma sai dovrebbe commentare chiaramente quel che
+il testo protetto significa.
+
+Una quarta address@hidden @`e di usare assegnamenti di variabili sulla riga di
+comando, address@hidden@dotless{i}}:
+
address@hidden
address@hidden awk -v sq="'" 'BEGIN @{ print "Questo @`e un apice singolo <" sq
">" @}'}
address@hidden Questo @`e un apice singolo <'>
address@hidden example
+
+(Qui, le due stringhe costanti e il valore di @code{sq} sono concatenati in
+un'unica stringa che @`e stampata da @code{print}.)
+
+Se servono veramente sia gli apici singoli che quelli doppi nel proprio
+programma @command{awk}, @`e probabilmente meglio tenerlo in un file separato,
+dove la shell non interferisce, e si address@hidden scrivere quello che si
vuole.
+
address@hidden Doppi apici in DOS
address@hidden Doppi apici in file .BAT Windows
+
address@hidden
+Date: Wed, 21 May 2008 09:58:43 +0200 (CEST)
+From: address@hidden
+Subject: (g)awk "contribution"
+To: address@hidden
+Message-id: <address@hidden>
+
+Hello Arnold,
+
+maybe you can help me out. Found your email on the GNU/awk online manual
+pages.
+
+I've searched hard to figure out how, on Windows, to print double quotes.
+Couldn't find it in the Quotes area, nor on google or elsewhere. Finally i
+figured out how to do this myself.
+
+How to print all lines in a file surrounded by double quotes (on Windows):
+
+gawk "{ print \"\042\" $0 \"\042\" }" <file>
+
+Maybe this is a helpfull tip for other (Windows) gawk users. However, i
+don't have a clue as to where to "publish" this tip! Do you?
+
+Kind regards,
+
+Jeroen Brink
address@hidden ignore
+
+Sebbene questo @value{DOCUMENT} in generale si preoccupi solo di sistemi POSIX
+e della shell POSIX, il problema che stiamo per vedere emerge abbastanza
+spesso presso parecchi utenti, e per questo ne parliamo.
+
address@hidden Brink, Jeroen
+Le ``shell'' nei sistemi Microsoft Windows usaso il carattere doppio apice
+per protezione, e rendono difficile o impossibile inserire un carattere
+doppio apice in uno @dfn{script} scritto su una riga di comando.
+l'esempio che segue, per il quale ringraziamo Jeroen Brink, mostra come
+stampare tutte le righe di un file, racchiudendole tra doppi apici:
+
address@hidden
+gawk "@{ print \"\042\" $0 \"\042\" @}" @var{file}
address@hidden example
+
+
address@hidden File dati di esempio
address@hidden @value{DDF} per gli esempi
+
address@hidden input file, esempi
address@hidden file di @code{mail-list}
+Molti degli esempi in questo @value{DOCUMENT} hanno come input due @value{DF}
+di esempio. Il primo, @file{mail-list}, contiene una lista di nomi di
+persone, insieme ai loro indirizzi email e a informazioni riguardanti le
+persone stesse.
+Il secondo @value{DF}, di nome @file{inventory-shipped}, contiene
+informazioni riguardo a consegne mensili. In entrambi i file,
+ogni riga @`e considerata come un @dfn{record}.
+
+Nel @file{mail-list}, ogni record contiene il nome di una persona,
+il suo numero di telefono, il suo indirizzo email, e un codice che indica
+la sua relazione con l'autore della lista.
+Le colonne sono allineate usando degli spazi.
+Una @samp{A} nell'ultima colonna indica che quella persona @`e un conoscente
+[Acquaintance]. Una @samp{F} nell'ultima colonna significa che quella
+persona @`e un amico [Friend]. Una @samp{R} vuol dire che quella persona @`e
+un parente [Relative]:
+
address@hidden
address@hidden system if test ! -d eg ; then mkdir eg ; fi
address@hidden system if test ! -d eg/lib ; then mkdir eg/lib ; fi
address@hidden system if test ! -d eg/data ; then mkdir eg/data ; fi
address@hidden system if test ! -d eg/prog ; then mkdir eg/prog ; fi
address@hidden system if test ! -d eg/misc ; then mkdir eg/misc ; fi
address@hidden file eg/data/mail-list
+Amelia 555-5553 amelia.zodiacusque@@gmail.com F
+Anthony 555-3412 anthony.asserturo@@hotmail.com A
+Becky 555-7685 becky.algebrarum@@gmail.com A
+Bill 555-1675 bill.drowning@@hotmail.com A
+Broderick 555-0542 broderick.aliquotiens@@yahoo.com R
+Camilla 555-2912 camilla.infusarum@@skynet.be R
+Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
+Julie 555-6699 julie.perscrutabor@@skeeve.com F
+Martin 555-6480 martin.codicibus@@hotmail.com A
+Samuel 555-3430 samuel.lanceolis@@shu.edu A
+Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden endfile
address@hidden example
+
address@hidden file @code{inventory-shipped}
+Il @value{DF} @file{inventory-shipped} contiene
+informazioni sulle consegne effettuate durante l'anno.
+Ogni record contiene il mese, il numero di contenitori verdi spediti,
+il numero di scatole rosse spedite, il numero di borse arancione spedite,
+e il numero di pacchetti blu spediti, in quest'ordine.
+Ci sono 16 record, relativi ai dodici mesi dello scorso anno e ai primi
+quattro mesi dell'anno in corso.
+Una riga vuota separa i data relativi a ciascun anno:
+
address@hidden
address@hidden file eg/data/inventory-shipped
+Jan 13 25 15 115
+Feb 15 32 24 226
+Mar 15 24 34 228
+Apr 31 52 63 420
+May 16 34 29 208
+Jun 31 42 75 492
+Jul 24 34 67 436
+Aug 15 34 47 316
+Sep 13 55 37 277
+Oct 29 54 68 525
+Nov 20 87 82 577
+Dec 17 35 61 401
+
+Jan 21 36 64 620
+Feb 26 58 80 652
+Mar 24 75 70 495
+Apr 21 70 74 514
address@hidden endfile
address@hidden example
+
+Questi file di esempio sono inclusi nella distribuzione @command{gawk},
+nella directory @file{awklib/eg/data}.
+
address@hidden Molto semplice
address@hidden Alcuni esempi molto semplici
+
+I seguenti comandi eseguono un semplice programma @command{awk} che cerca
+nel file in input @file{mail-list} la stringa di caratteri @samp{li} (una
+sequenza di caratteri @`e solitamente chiamato una @dfn{stringa};
+il termine @dfn{stringa} @`e basato su un uso linguistico, del tipo
+``una stringa di perle'' o ``una stringa di luci decorative''):
+
address@hidden
+awk '/li/ @{ print $0 @}' mail-list
address@hidden example
+
address@hidden
+Quando si incontra una riga che contiene @samp{li}, la si stampa, perch@'e
address@hidden@samp{print $0}} significa "stampa la riga corrente". (Lo
scrivere solo
address@hidden ha lo stesso significato, quindi avremmo anche potuto
+limitarci a fare address@hidden@dotless{i}}).
+
+Si address@hidden notato che delle barre (@samp{/}) delimitano la stringa
@samp{li}
+nel programma @command{awk}. Le barre indicano che @samp{li} @`e il
+modello da ricercare. Questo tipo di notazione @`e definita come
address@hidden regolare}, e address@hidden trattata address@hidden avanti in
maggior dettaglio
address@hidden
+(@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}).
address@hidden ifnottex
+Il modello address@hidden corrispondere anche solo a una parte di una parola.
+Ci sono
+apici singoli che racchiudono il programma @command{awk} in modo che la
+shell non interpreti alcuna parte di esso come un carattere speciale della
+shell.
+
+Questo @`e quello che il programma stampa:
+
address@hidden
+$ @kbd{awk '/li/ @{ print $0 @}' mail-list}
address@hidden Amelia 555-5553 amelia.zodiacusque@@gmail.com F
address@hidden Broderick 555-0542 broderick.aliquotiens@@yahoo.com R
address@hidden Julie 555-6699 julie.perscrutabor@@skeeve.com F
address@hidden Samuel 555-3430 samuel.lanceolis@@shu.edu A
address@hidden example
+
address@hidden azioni, default
address@hidden criteri di ricerca, default
+In una regola @command{awk}, il criterio di selezione o l'azione possono
+essere omessi, ma non entrambi. Se il criterio @`e omesso, l'azione viene
+applicata a @emph{ogni} riga dell'input.
+Se l'azione viene omessa, per default si stampano tutte le righe che
+sono individuate dal criterio di selezione.
+
address@hidden azioni, omesse
+Quindi, si potrebbe omettere l'azione (l'istruzione @code{print} e le
+graffe) nell'esempio precedente e il risultato sarebbe lo stesso:
address@hidden stampa tutte le righe che corrispondono al criterio di
+ricerca @samp{li}. Per confronto, omettendo l'istruzione @code{print} ma
+lasciando le graffe si richiede un'azione nulla, che non fa nulla
(address@hidden non
+stampa alcuna riga).
+
address@hidden programmi @command{awk}, esempi molto corti
+Molti programmi @command{awk} pratici sono lunghi solo una o due righe.
+Qui sotto troviamo una collezione di programmi utili e corti, per iniziare.
+Alcuni di questi programmi contengono elementi del linguaggio che non sono
+ancora stati spiegati. (La descrizione del programma fornisce una buona
+idea di quel che si vuole ottenere, ma occorre leggere il resto del
address@hidden per divenire esperti in @command{awk}!)
+Molti degli esempi usano un @value{DF} di nome @file{data}. Questo serve solo
+a indicare la posizione del nome; se questi programmi devono venir usati per
+se stessi, sostituire i propri @value{FNS} al posto di @file{data}.
+Per futura memoria, si noti che spesso c'@`e address@hidden di un modo per
fare qualcosa
+in @command{awk}. In un altro momento, si potrebbe tornare a guardare questi
+esempi per vedere se si riescono a trovare modi differenti per fare le stesse
+cose mostrate qui appresso:
+
address@hidden @value{BULLET}
address@hidden
+Stampare ogni riga lunga address@hidden di 80 caratteri:
+
address@hidden
+awk 'length($0) > 80' data
address@hidden example
+
+L'unica regola presente ha un'espressione di relazione come modello
+e non ha azione---quindi applica l'azione di default, stampando il record.
+
address@hidden
+Stampare la lunghezza della riga in input address@hidden lunga:
+
address@hidden
+awk '@{ if (length($0) > max) max = length($0) @}
+ END @{ print max @}' data
address@hidden example
+
+Il codice associato a @code{END} viene eseguito dopo che tutto
+l'input @`e stato letto; @`e l'altra faccia della medaglia di @code{BEGIN}.
+
address@hidden programma @command{expand}
address@hidden @command{expand}, programma
address@hidden
+Stampare la lunghezza della riga address@hidden lunga in @file{data}:
+
address@hidden
+expand data | awk '@{ if (x < length($0)) x = length($0) @}
+ END @{ print "la lunghezza massima di una riga @`e" x @}'
address@hidden example
+
+Questo esempio @`e leggermente diverso da quello precedente:
+l'input @`e l'output del comando @command{expand}, che cambia i TAB
+in spazi, in modo che le larghezze confrontate siano quelle che sarebbero
+qualora le si stampasse, e non il numero dei caratteri di input su ogni
+riga. [il carattere TAB occupa un byte nel file, ma address@hidden generare
fino a
+otto spazi bianchi in fase di stampa.]
+
address@hidden
+Stampare ogni riga che abbia almeno un campo:
+
address@hidden
+awk 'NF > 0' data
address@hidden example
+
+Questa @`e una maniera facile per eliminare le righe vuote dal file (o
+piuttosto, per creare un nuovo file, simile al vecchio, ma nel quale le
+linee vuote sono state tolte).
+
address@hidden
+Stampare sette numeri casuali compresi tra 0 e 100, inclusi:
+
address@hidden
+awk 'BEGIN @{ for (i = 1; i <= 7; i++)
+ print int(101 * rand()) @}'
address@hidden example
+
address@hidden
+Stampare il numero totale di byte usato da un @var{elenco-file}:
+
address@hidden
+ls -l @var{elenco-file} | awk '@{ x += $5 @}
+ END @{ print "byte totali: " x @}'
address@hidden example
+
address@hidden
+Stampare il numero totale di kilobyte usati da @var{elenco-file}:
+
address@hidden Don't use \ continuation, not discussed yet
address@hidden Remember that awk does floating point division,
address@hidden no need for (x+1023) / 1024
address@hidden
+ls -l @var{elenco-file} | awk '@{ x += $5 @}
+ END @{ print "K-byte totali:", x / 1024 @}'
address@hidden example
+
address@hidden
+Stampare una lista in ordine alfabetico di tutti gli utenti del sistema
+[Unix]:
+
address@hidden
+awk -F: '@{ print $1 @}' /etc/passwd | sort
address@hidden example
+
address@hidden
+Contare le righe in un file:
+
address@hidden
+awk 'END @{ print NR @}' data
address@hidden example
+
address@hidden
+Stampare le righe pari nel @value{DF}:
+
address@hidden
+awk 'NR % 2 == 0' data
address@hidden example
+
+Se aveste usato invece l'espressione @samp{NR % 2 == 1},
+il programma avrebbe stampato le righe dispari.
address@hidden itemize
+
address@hidden Due regole
address@hidden Un esempio che usa due regole
address@hidden programmi @command{awk}
+
+Il programma @command{awk} legge il file in input una riga alla volta.
+Per ogni riga @command{awk} controlla la corrispondenza con ogni regola.
+Se viene trovata address@hidden di una corrispondenza, vengono eseguite
altrettante
+azioni, nell'ordine in cui appaiono nel programma @command{awk}.
+Se non viene trovata nessuna corrispondenza, non viene eseguita alcuna azione.
+
+Dopo aver elaborato tutte le regole che hanno corrispondenza con la riga (e
+pu@'o darsi che nessuna corrisponda), @command{awk} legge la riga successiva.
Comunque
address@hidden next},
address@hidden
+e @ref{Istruzione Nextfile}.)
address@hidden ifdocbook
address@hidden
+e anche @pxref{Istruzione nextfile}.)
address@hidden ifnotdocbook
+Si prosegue address@hidden@dotless{i}} finch@'e il programma raggiunge la fine
del file.
+Per esempio, il seguente programma @command{awk} contiene due regole:
+
address@hidden
+/12/ @{ print $0 @}
+/21/ @{ print $0 @}
address@hidden example
+
address@hidden
+La prima regola ha la stringa @samp{12} da cercare e
address@hidden $0} come
+azione. La seconda regola ha la
+stringa @samp{21} da cercare e ha ancora @samp{print $0} come azione.
+L'azione di ciascuna regola @`e racchiusa in una coppia di parentesi graffe.
+
+Questo programma stampa ogni riga che contiene la stringa
address@hidden @emph{oppure} la stringa @samp{21}. Se una riga contiene
entrambe
+le stringhe, @`e stampata due volte, una volta per ogni regola.
+
+Questo @`e address@hidden che capita se eseguiamo questo programma sui nostri
@value{DF},
address@hidden e @file{inventory-shipped}:
+
address@hidden
+$ @kbd{awk '/12/ @{ print $0 @}}
+> @kbd{/21/ @{ print $0 @}' mail-list inventory-shipped}
address@hidden Anthony 555-3412 anthony.asserturo@@hotmail.com A
address@hidden Camilla 555-2912 camilla.infusarum@@skynet.be R
address@hidden Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden Jan 21 36 64 620
address@hidden Apr 21 70 74 514
address@hidden example
+
address@hidden
+Si noti che la riga che inizia con @samp{Jean-Paul}
+nel file @file{mail-list}
address@hidden stata stampata due volte, una volta per ogni regola.
+
address@hidden Maggiore sofisticazione
address@hidden Un esempio address@hidden complesso
+
+Dopo aver imparato a eseguire alcuni semplici compiti, vediamo cosa possono
+fare i tipici programmi @command{awk}.
+Questo esempio mostra come @command{awk} address@hidden essere usato per
riassumere,
+selezionare e riordinare l'output di un altro comando. Sono usate
address@hidden di cui non si @`e ancora parlato, quindi non ci si deve
preoccupare
+se alcuni dettagli risulteranno oscuri:
+
address@hidden
+ls -l | awk '$6 == "Nov" @{ somma += $5 @}
+ END @{ print somma @}'
address@hidden example
+
address@hidden comando @command{ls}
+Questo comando stampa il numero totale di byte in tutti i file contenuti
+nella directory corrente, la cui data di modifica @`e novembre (di qualsiasi
+anno). La parte @address@hidden -l}} dell'esempio @`e un comando di sistema
che
+fornisce un elenco dei file in una directory, con anche la dimensione di
+ogni file e la data di ultima modifica. Il suo output @`e del tipo:
+
address@hidden
+-rw-r--r-- 1 arnold user 1933 Nov 7 13:05 Makefile
+-rw-r--r-- 1 arnold user 10809 Nov 7 13:03 awk.h
+-rw-r--r-- 1 arnold user 983 Apr 13 12:14 awk.tab.h
+-rw-r--r-- 1 arnold user 31869 Jun 15 12:20 awkgram.y
+-rw-r--r-- 1 arnold user 22414 Nov 7 13:03 awk1.c
+-rw-r--r-- 1 arnold user 37455 Nov 7 13:03 awk2.c
+-rw-r--r-- 1 arnold user 27511 Dec 9 13:07 awk3.c
+-rw-r--r-- 1 arnold user 7989 Nov 7 13:03 awk4.c
address@hidden example
+
address@hidden
address@hidden continuazione di riga, nella C shell
+Il primo campo contiene le autorizzazioni di lettura/scrittura [r/w], il
+secondo il numero dei collegamenti al file address@hidden il numero di nomi
con cui
+il file @`e conosciuto], e il terzo campo identifica il proprietario del file.
+Il quarto campo identifica il gruppo a cui appartiene il file.
+Il quinto campo contiene la dimensione del file, in byte.
+Il sesto, settimo e ottavo campo contengono il mese, il giorno e l'ora,
+rispettivamente, in cui il file @`e stato modificato. Infine, il nono campo
+contiene il @value{FN}.
+
address@hidden @cindex automatic initialization
address@hidden inizializzazione automatica
+L'espressione @samp{$6 == "Nov"} nel nostro programma @command{awk} controlla
+se il sesto campo dell'output di @address@hidden -l}} corrisponda alla stringa
address@hidden Ogni volta che una riga ha la stringa
address@hidden come suo sesto campo, @command{awk} esegue l'azione
address@hidden += $5}. Questo aggiunge il quinto campo (la dimensione del file)
+alla variabile @code{somma}. Come risultato, quando @command{awk} ha finito
+di leggere tutte le righe in input, @code{somma} contiene la somma totale
+delle dimensioni dei file che corrispondono al criterio di ricerca.
+(address@hidden funziona contando sul fatto che le variabili @command{awk} sono
+automaticamente inizializzate a zero.)
+
+Dopo che l'ultima riga dell'output di @command{ls} @`e stata elaborata, la
+regola @code{END} viene eseguita e viene stampato il valore di @code{somma}.
+In questo esempio, il valore di @code{somma} @`e 80600.
+
+Queste tecniche address@hidden avanzate di @command{awk} sono trattate in
address@hidden
+successive (@pxref{Panoramica sulle azioni}). Prima di poter passare a una
+programmazione address@hidden avanzata con @command{awk}, @`e necessario
sapere come
address@hidden interpreta i file in input e visualizza quelli in output.
+Modificando campi e usando l'istruzione @code{print} @`e possibile produrre
+dei rapporti molto utili ed esteticamente gradevoli.
+
address@hidden Istruzioni/Righe
address@hidden Istruzioni e righe in @command{awk}
address@hidden interruzioni di riga
address@hidden andare a capo
+
+Molto spesso, ogni riga di un programma @command{awk} @`e un'istruzione a s@'e
+stante o una regola isolata, come:
+
address@hidden
+awk '/12/ @{ print $0 @}
+ /21/ @{ print $0 @}' mail-list inventory-shipped
address@hidden example
+
address@hidden @command{gawk}, andare a capo
+Comunque, @command{gawk} ignora i ritorni a capo dopo ognuno di questi
+simboli e istruzioni:
+
address@hidden
+, @{ ? : || && do else
address@hidden example
+
address@hidden
+Un ritorno a capo in ogni altro punto del programma @`e considerato come la
+fine di un'address@hidden @samp{?} e i @samp{:} elencati sopra sono
+usati nell'espressione condizionale in tre parti descritta in
address@hidden condizionali}.
+Il cambio di riga dopo @samp{?} e i @samp{:} @`e un'estensione minore in
address@hidden; specificando @option{--posix} come opzione
+(@pxref{Opzioni}), quest'estensione non @`e valida.}
+
address@hidden @code{\} (barra inversa), continuazione di riga e
address@hidden barra inversa (@code{\}), continuazione di riga e
+Volendo dividere una sola istruzione su due righe in un punto in cui
+andando a capo sarebbe considerata conclusa, @`e possibile @dfn{continuare}
+nella riga successiva terminando la prima riga con un carattere di
+barra inversa (@samp{\}). La barra inversa dev'essere l'ultimo carattere
+sulla riga, per essere riconosciuto come un carattere di continuazione.
+Una barra inversa @`e consentita in ogni parte dell'istruzione, anche in mezzo
+a una stringa o a un'espressione regolare. Per esempio:
+
address@hidden
+awk '/Questa espressione regolare @`e troppo lunga, quindi\
+ la continuiamo sulla riga seguente/ @{ print $1 @}'
address@hidden example
+
address@hidden
address@hidden address@hidden, continuazione di riga con barra inversa e
+Non abbiamo quasi mai usato la continuazione tramite barra inversa nei nostri
+programmi di esempio. @command{gawk} non pone limiti alla lunghezza di
+una riga, quindi la continuazione tramite barra inversa non @`e mai
strettamente
+necessaria; serve soltanto a migliorare la address@hidden del programma.
+Per la stessa ragione, ma anche per amore di chiarezza, abbiamo tenuto
+concise molte istruzioni nei programmi presentati in questo @value{DOCUMENT}.
+La continuazione tramite barra inversa @`e molto utile quando il proprio
+programma @command{awk} si trova in un file sorgente separato, invece di
+essere immesso nella riga di comando. Si noti anche che molte implementazioni
+di @command{awk} presentano delle differenze su dove @`e possibile usare
+la continuazione tramite barra inversa. Per esempio, potrebbero non
+consentire di spezzare una costante di tipo stringa usando la continuazione
+tramite barra inversa. Quindi, per ottenere la massima address@hidden dei
+propri programmi @command{awk}, @`e meglio non spezzare le righe nel
+mezzo di un'espressione regolare o di una stringa.
address@hidden 10/2000: gawk, mawk, and current bell labs awk allow it,
address@hidden solaris 2.7 nawk does not. Solaris /usr/xpg4/bin/awk does
though! sigh.
+
address@hidden comando @command{csh}
address@hidden barra inversa (@code{\}), continuazione di riga e, in
@command{csh}
address@hidden @code{\} (barra inversa), continuazione di riga e, in
@command{csh}
address@hidden ATTENZIONE
address@hidden continuazione tramite barra inversa non funziona come sopra
descritto
+nella C shell.} Funziona per programmi @command{awk} contenuti in file e
+per programmi sulla riga di comando, @emph{ammesso} che si stia usando una
+shell conforme a POSIX, come la Unix Bourne shell o Bash. Ma la C shell si
+comporta in maniera diversa! In quel caso, occorre usare due barre inverse
+consecutive, in fondo alla riga. Si noti anche che quando si usa la C shell
address@hidden andata a capo nel vostro programma @command{awk} deve essere
+indicata con una barra inversa. Per esempio:
+
address@hidden
+% @kbd{awk 'BEGIN @{ \}
+? @kbd{ print \\}
+? @kbd{ "ciao, mondo" \}
+? @address@hidden'}
address@hidden ciao, mondo
address@hidden example
+
address@hidden
+Qui, il @samp{%} e il @samp{?} sono i prompt primario e secondario della
+C shell, analogamente a quelli usati nella shell standard @samp{$} e @samp{>}.
+
+Si confronti l'esempio precedente, come viene scritto in una shell conforme
+a POSIX:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{print \}
+> @kbd{"ciao, mondo"}
+> @address@hidden'}
address@hidden ciao, mondo
address@hidden example
address@hidden quotation
+
address@hidden @`e un linguaggio orientato alla riga. L'azione relativa a ogni
+regola deve iniziare sulla stessa riga del criterio di selezione. Per avere
+criterio di selezione e azione su righe separate, si
address@hidden usare la continuazione tramite barra inversa; non si
address@hidden fare
+diversamente.
+
address@hidden barra inversa (@code{\}), continuazione di riga, commenti e
address@hidden @code{\} (barra inversa), continuazione di riga, commenti e
address@hidden commenti, continuazione di riga con barra inversa e i
+Un'altra cosa da tener presente @`e che la continuazione tramite barra inversa
e
+i commenti non possono essere frammisti. Non appena @command{awk} incontra
+un @samp{#} che inizia un commento, ignora @emph{tutto} il resto della riga.
+Per esempio:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print "Non allarmarti" # una amichevole \}
+> @kbd{ regola BEGIN}
+> @address@hidden'}
address@hidden gawk: riga com.:2: regola BEGIN
address@hidden gawk: riga com.:2: ^ syntax error
address@hidden example
+
address@hidden
+In questo caso, parrebbe che la barra inversa continui il commento sulla riga
+successiva. Invece, la combinazione barra inversa-ritorno a capo non viene
+per nulla notata, in quanto ``nascosta'' all'interno del commento. Quindi,
+il @code{BEGIN} @`e marcato come errore di sintassi.
+
address@hidden istruzioni multiple
address@hidden @code{;} (punto e virgola), separare istruzioni nelle azioni
address@hidden punto e virgola (@code{;}), separare istruzioni nelle azioni
+Quando le istruzioni @command{awk} all'interno di una regola sono brevi, si
+potrebbe metterne address@hidden d'una su una riga sola. address@hidden @`e
possibile separando le
+istruzioni con un punto e virgola (@samp{;}).
+Questo vale anche per le regole stesse.
+Quindi, il programma visto all'inizio di
address@hidden
+questa
address@hidden ifnotinfo
address@hidden
+questo
address@hidden ifinfo
address@hidden
+poteva essere scritto anche address@hidden@dotless{i}}:
+
address@hidden
+/12/ @{ print $0 @} ; /21/ @{ print $0 @}
address@hidden example
+
address@hidden NOTA BENE
+La address@hidden che address@hidden regole coesistano sulla stessa riga, se
sono separate
+da un punto e virgola, non esisteva nel linguaggio @command{awk} originale;
address@hidden stata aggiunta per congruenza con quanto @`e consentito per le
istruzioni
+all'interno di un'azione.
address@hidden quotation
+
address@hidden Altre address@hidden
address@hidden Altre address@hidden di @command{awk}
+
address@hidden variabili
+Il linguaggio @command{awk} mette a disposizione un numero di variabili
address@hidden, o @dfn{predefinite}, che il programma dell'utente
address@hidden usare
+per ottenere informazioni da @command{awk}. Ci sono pure altre variabili
+che il programma address@hidden impostare, per definire come @command{awk} deve
+gestire i dati.
+
+Inoltre, @command{awk} mette a disposizione parecchie funzioni predefinite
address@hidden per effettuare calcoli di tipo comune e operazioni che
+agiscono sulle stringhe di caratteri.
address@hidden mette a disposizione funzioni predefinite per gestire le
+marcature temporali, per effettuare manipolazioni a livello di bit, per
+tradurre stringhe al momento dell'esecuzione del programma
+(internazionalizzazione), per determinare qual @`e il tipo di una variabile,
+e per ordinare dei vettori.
+
+Nel seguito della presentazione del linguaggio @command{awk}, saranno
+introdotte molte delle variabili e parecchie funzioni. Esse sono
+descritte sistematicamente in @ref{Variabili predefinite} e in
address@hidden
+
address@hidden Quando
address@hidden Quando usare @command{gawk}
+
address@hidden @command{awk}, uso di
+Ora che abbiamo visto qualcosa di quel che @command{awk} @`e in grado di fare,
+ci si address@hidden chiedere come @command{awk} potrebbe tornare utile.
Usando
+programmi di address@hidden, criteri di ricerca sofisticati, separatori
+di campo, istruzioni aritmetiche, e altri criteri di selezione, @`e possibile
+produrre degli output molto address@hidden complessi. Il linguaggio
@command{awk} @`e
+molto utile per fornire dei tabulati partendo da grandi address@hidden di dati
+grezzi, per esempio riassumendo informazioni dall'output di altri
+programmi di address@hidden come @command{ls}.
+(@xref{Maggiore sofisticazione}.)
+
+I programmi scritti con @command{awk} sono normalmente molto address@hidden
+corti dei loro equivalenti in altri linguaggi. address@hidden rende i
programmi
address@hidden facili da comporre e da utilizzare. Spesso i programmi
address@hidden possono essere scritti al volo a terminale, usati una volta sola
+e buttati via. Poich@'e i programmi @command{awk} sono interpretati, si
address@hidden
+evitare la (normalmente laboriosa) parte di compilazione nel ciclo tipico
+dello sviluppo software, ossia edita-compila-prova-correggi.
+
address@hidden Brian Kernighan, @command{awk} di
+In @command{awk} sono stati scritti programmi complessi, compreso un assembler
+completo, pluri-piattaforma per
address@hidden FOR_PRINT
address@hidden
+microprocessori a 8-bit (@pxrefil{Glossario}, per maggiori informazioni),
address@hidden iftex
address@hidden
+microprocessori a 8-bit (@pxref{Glossario}, per maggiori informazioni),
address@hidden ifnottex
address@hidden ifclear
address@hidden FOR_PRINT
+microprocessori a 8-bit,
address@hidden ifset
+e un assembler di microcodice per un computer dedicato esclusivamente
+al linguaggio Prolog.
+Le address@hidden dell'originale @command{awk} erano messe a dura prova
+da programmi di questa address@hidden, ma le versioni moderne sono
address@hidden robuste.
+
address@hidden programmi @command{awk}, complessi
+Se capita di scrivere programmi @command{awk} address@hidden lunghi di,
diciamo,
+qualche centinaio di righe, si potrebbe considerare la address@hidden di usare
+un linguaggio di programmazione differente da @command{awk}.
+La shell consente di ricercare stringhe ed espressioni regolari; inoltre
+consente di usare in maniera efficace i comandi di address@hidden del sistema.
+Python offre un piacevole equilibrio tra la address@hidden di una
programmazione
+ad alto livello, e la address@hidden di interagire a livello di sistema
address@hidden linguaggi di @dfn{script} popolari comprendono Ruby
+e Perl.}
+
address@hidden Sommario dell'introduzione
address@hidden Sommario
+
address@hidden FIXME: Review this chapter for summary of builtin functions
called.
address@hidden @value{BULLET}
address@hidden
+I programmi in @command{awk} consistono di coppie di
address@hidden di address@hidden
+
address@hidden
+Un'@var{azione} senza una @var{condizione di ricerca} viene sempre eseguita.
+L'@var{azione} di default per una condizione mancante @`e @address@hidden
print $0 @}}.
+
address@hidden
+Usare
address@hidden '@var{programma}' @var{file}}
+oppure
address@hidden -f @var{file-programma} @var{file}}
+per eseguire @command{awk}.
+
address@hidden
+Si address@hidden usare la notazione speciale @samp{#!} nella prima riga per
creare
+programmi @command{awk} che siano eseguibili direttamente.
+
address@hidden
+I commenti nei programmi @command{awk} iniziano con @samp{#} e continuano
+fino alla fine della stessa riga.
+
address@hidden
+Prestare attenzione ai problemi con gli apici nei programmi @command{awk}
+che facciano parte di uno @dfn{script} della shell (o di un file .BAT di
+MS-Windows).
+
address@hidden
+Si address@hidden usare la continuazione tramite barra inversa per continuare
righe di
+codice sorgente. Le righe sono continuate automaticamente dopo i simboli
+virgola, parentesi aperta, punto interrogativo, punto e virgola,
address@hidden||}, @samp{&&}, @code{do} ed @code{else}.
address@hidden itemize
address@hidden Invocare Gawk
address@hidden Eseguire @command{awk} e @command{gawk}
+
+Questo @value{CHAPTER} tratta di come eseguire @command{awk}, delle opzioni da
+riga di comando, sia quelle dello standard POSIX che quelle specifiche di
address@hidden, e di cosa fanno @command{awk} e @command{gawk} con gli
+argomenti che non sono opzioni.
+Prosegue poi spiegando come @command{gawk} cerca i file sorgenti,
+leggendo lo standard input assieme ad altri file, le variabili d'ambiente di
address@hidden, lo stato di ritorno di @command{gawk}, l'uso dei file inclusi,
+e opzioni e/o address@hidden obsolete e non documentate.
+
+Molte delle opzioni e address@hidden qui descritte sono trattate con
+maggior dettaglio nei capitoli successivi del @value{DOCUMENT}; gli argomenti
+presenti in questo @value{CHAPTER} che al momento non interessano si possono
+tranquillamente saltare.
+
address@hidden
+* Riga di comando:: Come eseguire @command{awk}.
+* Opzioni:: Opzioni sulla riga di comando e loro
+ significato.
+* Altri argomenti:: Nomi dei file in input e assegnamento di
+ valori a variabili.
+* Specificare lo standard input:: Come specificare lo standard input insieme ad
+ altri file.
+* Variabili d'ambiente:: Le variabili d'ambiente usate da
+ @command{gawk}.
+* Codice di ritorno:: Il codice di ritorno all'uscita da
+ @command{gawk}.
+* Includere file:: Come includere altri file nel proprio
+ programma.
+* Caricare librerie condivise:: Caricare librerie condivise nel
+ proprio programma.
+* Parti obsolete:: Opzioni e/o address@hidden obsolete.
+* Non documentato:: Opzioni e address@hidden non documentate.
+* Sommario invocazione:: Sommario invocazione.
address@hidden menu
+
address@hidden Riga di comando
address@hidden Come eseguire @command{awk}
address@hidden riga di comando, eseguire @command{awk} da
address@hidden @command{awk}, eseguire
address@hidden argomenti, riga di comando, eseguire @command{awk}
address@hidden opzioni sulla riga di comando, eseguire @command{awk}
+
+Ci sono due modi di eseguire @command{awk}: con un programma esplicito o con
+uno o address@hidden file di programma. Qui @`e mostrata la sintassi di
entrambi; le voci
+racchiuse tra address@hidden sono opzionali:
+
address@hidden
address@hidden address@hidden @option{-f} @var{file_di _programma}
address@hidden @var{file} @dots{}
address@hidden address@hidden address@hidden @code{'@var{programma}'}
@var{file} @dots{}
address@hidden display
+
address@hidden GNU, opzioni estese
address@hidden estese, opzioni
address@hidden opzioni estese
+In aggiunta alle tradizionali opzioni di una sola lettera in stile POSIX,
address@hidden consente anche le opzioni estese GNU.
+
address@hidden angolo buio, invocare @command{awk}
address@hidden @dfn{lint}, controlli con programma vuoto
address@hidden possibile invocare @command{awk} con un programma vuoto:
+
address@hidden
+awk '' file_dati_1 file_dati_2
address@hidden example
+
address@hidden @option{--lint}, opzione
address@hidden
+Fare address@hidden@dotless{i}} ha comunque poco senso; @command{awk} termina
+silenziosamente quando viene fornito un programma vuoto.
address@hidden
+Se @`e stato specificato @option{--lint} sulla riga di comando,
address@hidden emette un avviso che avverte
+che il programma @`e vuoto.
+
address@hidden Opzioni
address@hidden Opzioni sulla riga di comando
address@hidden opzioni sulla riga di comando
address@hidden riga di comando, opzioni
address@hidden GNU, opzioni estese
address@hidden opzioni estese
+
+Le opzioni sono precedute da un trattino e consistono in un unico carattere.
+Le opzioni estese in stile GNU sono precedute da un doppio trattino e
+consistono in una parola
+chiave. La parola chiave address@hidden essere abbreviata, a condizione che
+l'abbreviazione identifichi univocamente l'opzione. Se l'opzione prevede un
+argomento, la parola chiave @`e immediatamente seguita da un segno di uguale
+(@samp{=}) e dal valore dell'argomento, oppure la parola chiave e il valore
+dell'argomento sono separati da spazi.
+Se un'opzione con un valore viene immessa address@hidden di una volta,
+l'ultimo valore @`e quello che conta.
+
address@hidden POSIX @command{awk}, opzioni estese GNU e
+Ogni opzione estesa di @command{gawk} ha una corrispondente opzione
+breve in stile POSIX.
+Le opzioni estese e brevi sono
+intercambiabili in tutti i contesti.
+L'elenco seguente descrive le opzioni richieste dallo standard POSIX:
+
address@hidden @code
address@hidden -F @var{fs}
address@hidden --field-separator @var{fs}
address@hidden @option{-F}, opzione
address@hidden @option{--field-separator}, opzione
address@hidden @code{FS}, variabile, l'opzione @code{--field-separator} e
+Imposta la variabile @code{FS} a @var{fs}
+(@pxref{Separatori di campo}).
+
address@hidden -f @var{file-sorgente}
address@hidden --file @var{file-sorgente}
address@hidden @option{-f}, opzione
address@hidden @option{--file}, opzione
address@hidden @command{awk}, programmi, collocazione dei
+Legge il sorgente del programma @command{awk} da @var{file-sorgente}
+anzich@'e prenderlo dal primo argomento che non @`e un'opzione.
+Quest'opzione address@hidden essere data address@hidden volte; il programma
@command{awk}
address@hidden formato dalla concatenazione del contenuto di ogni
address@hidden specificato.
+
address@hidden -v @address@hidden
address@hidden --assign @address@hidden
address@hidden @option{-v}, opzione
address@hidden @option{--assign}, opzione
address@hidden variabili, impostazione
+Imposta la variabile @var{var} al valore @var{val} @emph{prima} che inizi
+l'esecuzione del programma. Tali valori di variabile sono disponibili
+all'interno della regola @code{BEGIN}
+(@pxref{Altri argomenti}).
+
+L'opzione @option{-v} address@hidden impostare una sola variabile per volta,
ma address@hidden
+essere usata address@hidden di una volta, impostando ogni volta una variabile
+differente, in questo modo:
address@hidden @w{-v pippo=1} @w{-v pluto=2} @dots{}}.
+
address@hidden predefinite, variabili, opzione @address@hidden impostare con
address@hidden variabili predefinite, impostare con opzione @code{-v}
address@hidden ATTENZIONE
+Usare @option{-v} per impostare valori di variabili predefinite
address@hidden condurre a risultati sorprendenti. @command{awk} address@hidden
i
+valori di quelle variabili secondo le sue address@hidden, anche ignorando
+eventuali valori iniziali che possono essere stati assegnati.
address@hidden quotation
+
address@hidden -W @var{gawk-opt}
address@hidden @option{-W}, opzione
+Fornisce un'opzione specifica dell'implementazione. Questa @`e la convenzione
+POSIX per fornire opzioni specifiche dell'implementazione.
+Queste opzioni
+hanno anche una corrispondente opzione estesa scritta in stile GNU.
+Si noti che le opzioni estese possono essere abbreviate, sempre che
+le abbreviazioni siano univoche.
+L'elenco completo delle opzioni specifiche di @command{gawk} @`e riportato di
+seguito.
+
address@hidden --
address@hidden riga di comando, opzioni, fine delle
address@hidden opzioni sulla riga di comando, fine delle
+Segnale della fine delle opzioni da riga di comando. I seguenti argomenti
+non sono trattati come opzioni anche se iniziano con @samp{-}. Questa
+interpretazione di @option{--} segue le convenzioni POSIX per l'analisi degli
+argomenti.
+
address@hidden @code{-} (meno), nomi di file che iniziano con
address@hidden meno (@code{-}), nomi di file che iniziano con
address@hidden utile se si hanno @value{FNS} che iniziano con @samp{-},
+o negli @dfn{script} di shell, se si hanno @value{FNS} che devono essere
+specificati dall'utente che potrebbero iniziare con @samp{-}.
address@hidden utile anche per passare opzioni al programma @command{awk};
+si veda @ref{Funzione getopt}.
address@hidden table
+
+L'elenco che segue descrive le opzioni specifiche di @command{gawk}:
+
address@hidden Have to use @asis here to get docbook to come out right.
address@hidden @asis
address@hidden @option{-b}
address@hidden @option{--characters-as-bytes}
address@hidden @option{-b}, opzione
address@hidden @option{--characters-as-bytes}, opzione
+Fa address@hidden@dotless{i}} che @command{gawk} tratti tutti i dati in input
come caratteri di un solo
+byte. In aggiunta, tutto l'output scritto con @code{print} o @code{printf}
+viene trattato come composto da caratteri contenuti in un solo byte.
+
+Normalmente, @command{gawk} segue lo standard POSIX e cerca di elaborare i suoi
+dati di input in accordo con la localizzazione corrente
+(@pxref{Localizzazioni}).
+Questo spesso address@hidden comportare la conversione di caratteri multibyte
in
+caratteri estesi (internamente), e address@hidden
+creare problemi o confusione se i dati di input non contengono caratteri
+multibyte validi. Quest'opzione @`e una maniera facile di dire a
@command{gawk}:
address@hidden le mani dai miei dati!''.
+
address@hidden @option{-c}
address@hidden @option{--traditional}
address@hidden @option{-c}, opzione
address@hidden @option{--traditional}, opzione
address@hidden address@hidden compatibile di (@command{gawk}), specificare
+Specifica la @address@hidden di address@hidden, nella quale le estensioni GNU
al
+linguaggio @command{awk} sono disabilitate; in questo modo @command{gawk} si
+comporta proprio come la versione di BWK @command{awk}.
+
address@hidden/GNU},
+che riassume le estensioni.
address@hidden FOR_PRINT
+Si veda anche
address@hidden@`a di address@hidden
address@hidden ifclear
+
address@hidden @option{-C}
address@hidden @option{--copyright}
address@hidden @option{-C}, opzione
address@hidden @option{--copyright}, opzione
address@hidden GPL (General Public License), stampare
+Stampa la versione ridotta della General Public License ed esce.
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-d}, opzione
address@hidden @option{--dump-variables}, opzione
address@hidden fornire una lista di tutte le variabili del programma
address@hidden @file{awkvars.out}, file
address@hidden file @file{awkvars.out}
address@hidden variabili globali, stampare una lista delle
+Stampa una lista ordinata di variabili globali, i loro tipi, e i valori finali
+in @var{file}. Se non viene fornito alcun @var{file}, stampa questa lista
+in un file chiamato @file{awkvars.out} nella directory corrente.
+Non sono consentiti spazi tra @option{-d} e @var{file}, se
address@hidden viene specificato.
+
address@hidden risoluzione di problemi, address@hidden variabili globali
address@hidden problemi, risoluzione di, address@hidden variabili globali
+Avere una lista di tutte le variabili globali @`e un buon modo per cercare
+refusi nei propri programmi.
+Si address@hidden usare quest'opzione anche se si ha un grosso programma con
tantissime
+funzioni, e si vuol essere sicuri che le funzioni non usino
+inavvertitamente variabili globali che sarebbero dovute essere locali
+(questo @`e un errore particolarmente facile da fare con nomi di variabile
+semplici come @code{i}, @code{j}, etc.).
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-D}, opzione
address@hidden @option{--debug}, opzione
address@hidden @command{awk}, debug, abilitare
+Abilita l'esecuzione del debug di programmi @command{awk}
+(@pxref{Debugging}).
+Per default, il debugger legge i comandi interattivamente dalla tastiera
+(standard input).
+L'argomento opzionale @var{file} consente di specificare un file con una lista
+di comandi per il debugger da eseguire in maniera non interattiva.
+Non sono consentiti spazi tra @option{-D} e @var{file}, se
address@hidden viene indicato.
+
address@hidden @option{-e} @var{testo-del-programma}
address@hidden @option{--source} @var{testo-del-programma}
address@hidden @option{-e}, opzione
address@hidden @option{--source}, opzione
address@hidden codice sorgente, combinare
+Fornisce del codice sorgente nel @var{testo-del-programma}.
+Quest'opzione consente di combinare il codice sorgente contenuto in file
+col codice sorgente immesso sulla riga di comando.
+Questo @`e particolarmente utile quando si hanno funzioni di libreria che si
+vogliono usare dai programmi da riga di comando
+(@pxref{AWKPATH (Variabile)}).
+
address@hidden @option{-E} @var{file}
address@hidden @option{--exec} @var{file}
address@hidden @option{-E}, opzione
address@hidden @option{--exec}, opzione
address@hidden @command{awk}, programmi, collocazione dei
address@hidden CGI, @command{awk} @dfn{script} per
+Simile a @option{-f}, legge il testo del programma @command{awk} da
address@hidden Ci sono due differenze rispetto a @option{-f}:
+
address@hidden @value{BULLET}
address@hidden
+Quest'opzione fa terminare l'elaborazione delle opzioni; qualsiasi
+altra cosa sulla riga di comando viene inoltrata direttamente al programma
address@hidden
+
address@hidden
+Le variabili da riga di comando della forma
address@hidden@address@hidden non sono ammesse.
address@hidden itemize
+
+Quest'opzione @`e particolarmente necessaria per le applicazioni World Wide Web
+CGI che passano argomenti attraverso le URL; l'uso di quest'opzione impedisce
+a un utente malintenzionato (o ad altri) di passare opzioni, assegnamenti o
+codice sorgente @command{awk} (con @option{-e}) all'applicazione
address@hidden maggiori dettagli,
+si veda la Sezione 4.4 di @uref{http://www.ietf.org/rfc/rfc3875,
+RFC 3875}. Si veda anche
address@hidden://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html,
+note esplicative spedite alla mailing list @command{gawk} bug}.}
+Quest'opzione dovrebbe essere usata
+con @dfn{script} @samp{#!}
+(@address@hidden eseguibili}), in questo modo:
+
address@hidden
+#! /usr/local/bin/gawk -E
+
address@hidden programma awk @`e qui @dots{}}
address@hidden example
+
address@hidden @option{-g}
address@hidden @option{--gen-pot}
address@hidden @option{-g}, opzione
address@hidden @option{--gen-pot}, opzione
address@hidden address@hidden, generare file oggetto
address@hidden file oggetto portabili, generare
+Analizza il programma sorgente e
+genera un file GNU @command{gettext} @dfn{portable object template} sullo
+standard output per tutte le costanti di tipo stringa che sono state marcate
+come da tradurre.
address@hidden,
+per informazioni su quest'opzione.
+
address@hidden @option{-h}
address@hidden @option{--help}
address@hidden @option{-h}, opzione
address@hidden @option{--help}, opzione
address@hidden GNU, opzioni estese, stampare una lista di
address@hidden opzioni, stampare una lista di
address@hidden stampa, lista di opzioni
+Stampa un messaggio sull'``uso'' riassumendo le opzioni brevi ed estese
+accettate da @command{gawk} ed esce.
+
address@hidden @option{-i} @var{file-sorgente}
address@hidden @option{--include} @var{file-sorgente}
address@hidden @option{-i}, opzione
address@hidden @option{--include}, opzione
address@hidden @command{awk}, programmi, collocazione dei
+Legge una libreria di sorgenti @command{awk} da @var{file-sorgente}.
+Quest'opzione @`e del tutto equivalente a usare la direttiva @code{@@include}
+all'interno del proprio programma. @`E molto simile all'opzione
address@hidden, ma ci sono due differenze importanti. Primo, quando viene usata
+l'opzione @option{-i}, il sorgente del programma non viene caricato se @`e
+stato caricato in precedenza, mentre con @option{-f}, @command{gawk} carica
+sempre il file. Secondo, poich@'e quest'opzione @`e pensata per essere usata
+con librerie di codice, @command{gawk} non riconosce tali file come
+costituenti l'input del programma principale. address@hidden@dotless{i}},
dopo l'elaborazione di
+un argomento @option{-i}, @command{gawk} si aspetta di trovare il codice
+sorgente principale attraverso l'opzione @option{-f} o sulla riga di comando.
+
address@hidden @option{-l} @var{ext}
address@hidden @option{--load} @var{ext}
address@hidden @option{-l}, opzione
address@hidden @option{--load}, opzione
address@hidden caricare estensioni
+Carica un'estensione dinamica denominata @var{ext}. Le estensioni sono
+memorizzate come librerie condivise di sistema.
+Quest'opzione ricerca la libreria usando la variabile d'ambiente
address@hidden Il suffisso corretto per la piattaforma in uso address@hidden
+fornito per default, address@hidden non @`e necessario specificarlo nel nome
+dell'estensione. La routine di inizializzazione dell'estensione dovrebbe
+essere denominata @code{dl_load()}. Un'alternativa @`e quella di usare la
+direttiva @code{@@load} all'interno del programma per caricare una libreria
+condivisa. Questa address@hidden avanzata @`e descritta in dettaglio in
address@hidden dinamiche}.
+
address@hidden @address@hidden
address@hidden @address@hidden@var{valore}]
address@hidden @option{-l}, opzione
address@hidden @option{--lint}, opzione
address@hidden @dfn{lint}, controlli, emissione di avvertimenti
address@hidden avvertimenti, emissione di
+Emette messaggi d'avvertimento relativi a costrutti dubbi o non portabili ad
+altre implementazioni di @command{awk}.
+Non sono consentiti spazi tra @option{-L} e @var{valore}, se
+viene indicato il @var{valore}.
+Alcuni avvertimenti vengono emessi quando @command{gawk} legge preliminarmente
+il programma. Altri vengono emessi quando il programma viene eseguito.
+Con l'argomento opzionale @samp{fatal}, gli avvertimenti @dfn{lint} sono
considerati
+come errori gravi. Potrebbe essere una misura drastica, address@hidden il suo
uso
address@hidden certamente lo sviluppo di programmi @command{awk} address@hidden
corretti.
+Con l'argomento opzionale @samp{invalid}, vengono emessi solo gli avvertimenti
+relativi a quello che @`e effettivamente non valido (address@hidden non ancora
+completamente implementata).
+
+Alcuni avvertimenti vengono stampati solo una volta, anche se i costrutti dubbi
+per i quali vengono emessi avvisi ricorrono diverse volte nel programma
address@hidden address@hidden, nell'eliminazione dei problemi rilevati da
address@hidden, bisogna porre attenzione a cercare tutte le occorrenze di ogni
+costrutto inappropriato. Siccome i programmi @command{awk} generalmente sono
+brevi, questa non @`e un'operazione gravosa.
+
address@hidden @option{-M}
address@hidden @option{--bignum}
address@hidden @option{-M}, opzione
address@hidden @option{--bignum}, opzione
+Chiede il calcolo con precisione arbitraria sui numeri. Quest'opzione non ha
+alcun effetto se @command{gawk} non @`e compilato per l'uso delle librerie GNU
+MPFR e MP
+(@pxref{Calcolo con precisione arbitraria}).
+
address@hidden @option{-n}
address@hidden @option{--non-decimal-data}
address@hidden @option{-n}, opzione
address@hidden @option{--non-decimal-data}, opzione
address@hidden address@hidden valori, abilitare l'interpretazione di
address@hidden address@hidden valori, abilitare l'interpretazione di
address@hidden risoluzione di problemi, opzione @code{--non-decimal-data}
+Abilita l'interpretazione automatica di valori ottali ed esadecimali
+nei dati di input
+(@pxref{Dati non decimali}).
+
address@hidden ATTENZIONE
+Quest'opzione address@hidden generare gravi malfunzionamenti nei vecchi
programmi.
+Usare con cautela. Si noti anche che
+quest'opzione potrebbe non essere address@hidden disponibile in una futura
versione di
address@hidden
address@hidden quotation
+
address@hidden @option{-N}
address@hidden @option{--use-lc-numeric}
address@hidden @option{-N}, opzione
address@hidden @option{--use-lc-numeric}, opzione
+Forza l'uso del carattere di separazione decimale della localizzazione
+quando analizza i dati in input
+(@pxref{Localizzazioni}).
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-o}, opzione
address@hidden @option{--pretty-print}, opzione
+Consente la stampa di una versione formattata elegantemente dei programmi
address@hidden Implica l'opzione @option{--no-optimize}.
+Per default il programma di output viene creato in un file
+chiamato @file{awkprof.out} (@pxref{Profilare}).
+L'argomento opzionale @var{file} consente di specificare un
address@hidden differente per l'output.
+Non sono consentiti spazi tra @option{-o} e @var{file}, se
address@hidden viene indicato.
+
address@hidden NOTA
+Nel passato, quest'opzione eseguiva anche il programma.
+Ora non @`e address@hidden address@hidden@dotless{i}}.
address@hidden quotation
+
address@hidden @option{-O}
address@hidden @option{--optimize}
address@hidden @option{--optimize}, opzione
address@hidden @option{-O}, opzione
+Abilita le ottimizzazioni di default nella rappresentazione interna del
+programma. Attualmente, questo comprende delle semplificazioni nell'uso
+di costanti e l'eliminazione delle code di chiamata nelle funzioni
+ricorsive [sostituzione della chiamata di funzione con dei salti
+diretti alla funzione].
+
+Queste ottimizzazioni sono abilitate per default.
+Quest'opzione rimane disponibile per address@hidden all'indietro.
+Tuttavia address@hidden essere usata per annullare l'effetto di una precedente
+opzione @option{-s} (si veda address@hidden sotto in questa lista).
+
address@hidden @address@hidden
address@hidden @address@hidden@var{file}]
address@hidden @option{-p}, opzione
address@hidden @option{--profile}, opzione
address@hidden @command{awk}, profilatura, abilitare la
+Abilita la creazione del profilo di esecuzione di programmi @command{awk}
+(@pxref{Profilare}).
+Implicitamente viene forzata l'opzione @option{--no-optimize}.
+Per default, i profili vengono creati in un file chiamato @file{awkprof.out}.
+L'argomento opzionale @var{file} consente di specificare un altro
address@hidden per il file del profilo.
+Non sono consentiti spazi tra @option{-p} e @var{file}, se
+viene indicato un @var{file}.
+
+Il profilo contiene il numero di esecuzioni di ogni istruzione sul margine
+sinistro e il conteggio delle chiamate di funzione per ogni funzione.
+
address@hidden @option{-P}
address@hidden @option{--posix}
address@hidden @option{-P}, opzione
address@hidden @option{--posix}, opzione
address@hidden POSIX, address@hidden
address@hidden @command{gawk}, address@hidden disabilitare
+Opera in address@hidden POSIX rigorosa. Disabilita tutte le estensioni di
address@hidden (proprio come @option{--traditional}) e
+disabilita tutte le estensioni non consentite da POSIX.
+
address@hidden comuni}, per un sommario delle estensioni
+di @command{gawk} che sono disabilitate da quest'opzione.
+Inoltre,
+vengono applicate le seguenti
+restrizioni:
+
address@hidden @value{BULLET}
+
address@hidden ritorno a capo
address@hidden spazi vuoti, ritorno a capo invece che
address@hidden
+I ritorni a capo non sono consentiti dopo @samp{?} o @samp{:}
+(@pxref{Espressioni condizionali}).
+
+
address@hidden @code{FS}, variabile, come carattere TAB
address@hidden
+Specificando @samp{-Ft} sulla riga di comando non si imposta il valore
+della variabile @code{FS} a un singolo carattere TAB
+(@pxref{Separatori di campo}).
+
address@hidden localizzazione, separatore decimale della
address@hidden separatore decimale, carattere, specifico della localizzazione
address@hidden
+Il carattere di separatore decimale della localizzazione @`e usato per
analizzare
+i dati di input
+(@pxref{Localizzazioni}).
address@hidden itemize
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden @option{--traditional}, opzione, e opzione @code{--posix}
address@hidden @option{--posix}, opzione, e opzione @code{--traditional}
+Se si forniscono entrambe le opzioni @option{--traditional} e @option{--posix}
+sulla riga di comando, @option{--posix} ha la precedenza. Se vengono fornite
+entrambe le opzioni @command{gawk} emette un avviso.
+
address@hidden @option{-r}
address@hidden @option{--re-interval}
address@hidden @option{-r}, opzione
address@hidden @option{--re-interval}, opzione
address@hidden espressioni regolari, espressioni di intervallo e
+Consente le espressioni di intervallo
+(@pxref{Operatori di espressioni regolari})
+nelle espressioni regolari.
+Questo @`e ora il comportamento di default di @command{gawk}.
+Tuttavia, quest'opzione rimane (sia per address@hidden
+che per l'uso in combinazione con @option{--traditional}).
+
address@hidden @option{-s}
address@hidden @option{--no-optimize}
address@hidden @option{--no-optimize}, opzione
address@hidden opzione @option{--no-optimize}
address@hidden @option{-s}, opzione,
address@hidden opzione @option{-s}
+Disabilita le opzioni di ottimizzazione di default di @command{gawk}
+effettuate sulla rappresentazione interna del programma.
+
address@hidden @option{-S}
address@hidden @option{--sandbox}
address@hidden @option{-S}, opzione
address@hidden @option{--sandbox}, opzione
address@hidden sandbox, address@hidden
address@hidden prova, address@hidden di
+Disabilita la funzione @code{system()},
+la ridirezione dell'input con @code{getline},
+la ridirezione dell'output con @code{print} e @code{printf},
+e le estensioni dinamiche.
address@hidden particolarmente utile quando si vogliono eseguire @dfn{script}
@command{awk}
+da sorgenti dubbie e si vuol essere ricuri che gli @dfn{script} non abbiano
+accesso al sistema (oltre al @value{DF} di input specificato).
+
address@hidden @option{-t}
address@hidden @option{--lint-old}
address@hidden @option{-L}, opzione
address@hidden @option{--lint-old}, opzione
+Avvisa su costrutti che non sono disponibili nella versione originale di
address@hidden dalla versione 7 di Unix
+(@pxref{V7/SVR3.1}).
+
address@hidden @option{-V}
address@hidden @option{--version}
address@hidden @option{-V}, opzione
address@hidden @option{--version}, opzione
address@hidden @command{gawk}, versioni di, informazioni address@hidden stampa
+Stampa informazioni sulla versione di questa specifica copia di @command{gawk}.
+Consente di determinare se la copia di @command{gawk} in uso @`e aggiornata
+rispetto a quello che @`e attualmente in distribuzione da parte della Free
+Software Foundation.
address@hidden utile anche per la segnalazione di bug
+(@pxref{Bug}).
address@hidden table
+
+Ogni altra opzione, se @`e stato specificato il testo di un programma
address@hidden contrassegnata come non valida con un messaggio di avvertimento,
+altrimenti @`e ignorata.
+
address@hidden @option{-F}, opzione, opzione @option{-Ft} imposta @code{FS} a
TAB
+In address@hidden di address@hidden, come caso particolare, se il valore di
@var{fs}
+fornito all'opzione @option{-F} @`e @samp{t}, @code{FS} @`e impostata al
carattere
+TAB (@code{"\t"}). Questo @`e vero solo per @option{--traditional} e non
+per @option{--posix}
+(@pxref{Separatori di campo}).
+
address@hidden @option{-f}, opzione, usi multipli
+L'opzione @option{-f} address@hidden essere usata address@hidden di una volta
nella riga di comando.
+In questo caso, @command{awk} legge il sorgente del suo programma da tutti i
+file indicati, come se fossere concatenati assieme a formare un unico grande
+file.
+Questo @`e utile per creare librerie di funzioni di @command{awk}. Queste
+funzioni possono venir scritte una volta e in seguito recuperate da una
+posizione standard, invece di doverle includere in ogni singolo programma.
+L'opzione @option{-i} @`e simile in questo senso.
+(Come indicato in
address@hidden delle definizioni},
+i nomi di funzione devono essere univoci).
+
+Con @command{awk} standard, le funzioni di libreria si possono ancora usare,
+anche se il programma @`e immesso dalla tastiera,
+specificando @samp{-f /dev/tty}. Dopo aver scritto il programma,
+premere @kbd{Ctrl-d} (il carattere di fine file) per terminarlo.
+(Si potrebbe anche usare @samp{-f -} per leggere il sorgente del programma
+dallo standard input, ma poi non si address@hidden usare lo standard input
come sorgente
+di dati).
+
+Siccome @`e scomodo usare il meccanismo di @command{awk} standard per combinare
+file sorgenti e programmi @command{awk} da riga di comando, @command{gawk}
+fornisce l'opzione @option{-e}. Questo non richiede di evitare l'uso dello
+standard input per immettere codice sorgente; consente di combinare
+facilmente codice sorgente da riga di comando e da libreria
+(@pxref{AWKPATH (Variabile)}).
+Come per @option{-f}, le opzioni @option{-e} e @option{-i}
+si possono usare address@hidden volte nella riga di comando.
+
address@hidden @option{-e}, opzione
+Se non sono specificate opzioni @option{-f} o @option{-e}, @command{gawk}
+usa il primo argomento che non @`e un'opzione come testo del
+codice sorgente del programma.
+
address@hidden @env{POSIXLY_CORRECT}, variabile d'ambiente
address@hidden @dfn{lint}, controlli, variabile d'ambiente @env{POSIXLY_CORRECT}
address@hidden POSIX, address@hidden
+Se la variabile d'ambiente @env{POSIXLY_CORRECT} esiste,
address@hidden si comporta in address@hidden POSIX rigorosa, esattamente come se
+fosse stata fornita l'opzione @option{--posix}.
+Molti programi GNU cercano questa variabile d'ambiente per eliminare
+estensioni che confliggono con POSIX, ma @command{gawk} si comporta in modo
+diverso: sopprime tutte le estensioni, anche quelle che non confliggono con
+POSIX, e funziona rigorosamente in address@hidden POSIX.
+Se viene fornita l'opzione @option{--lint} sulla riga di comando e
address@hidden passa alla address@hidden POSIX a causa di @env{POSIXLY_CORRECT},
+viene emesso un messaggio di avvertimento indicando che @`e attiva la
address@hidden POSIX. Normalmente questa variabile si imposta nel file di avvio
+della shell a livello utente.
+Per una shell compatibile con Bourne (come Bash), queste righe andranno
+aggiunte nel file @file{.profile} della directory "home" dell'utente:
+
address@hidden
+POSIXLY_CORRECT=true
+export POSIXLY_CORRECT
address@hidden example
+
address@hidden @command{csh}, comando, variabile d'ambiente
@env{POSIXLY_CORRECT}
+Per una shell compatibile con C,@footnote{Non raccomandato.}
+questa riga address@hidden aggiunta nel file @file{.login} nella directory
"home"
+dell'utente:
+
address@hidden
+setenv POSIXLY_CORRECT true
address@hidden example
+
address@hidden address@hidden, variabile d'ambiente @env{POSIXLY_CORRECT}
+Avere @env{POSIXLY_CORRECT} impostata non @`e raccomandato per l'uso
quotidiano,
+ma @`e utile per provare la address@hidden dei programmi su altri
+ambienti.
+
address@hidden Altri argomenti
address@hidden Altri argomenti della riga di comando
address@hidden riga di comando, argomenti
address@hidden argomenti, riga di comando
+
+Qualsiasi altro argomento sulla riga di comando @`e trattato normalmente come
+file in input da elaborare nell'ordine con cui @`e specificato. Comunque, un
+argomento che ha la forma @address@hidden@var{valore}}, assegna
+il valore @var{valore} alla variabile @var{var}---non specifica affatto
+un file. (Si veda @ref{Opzioni di assegnamento}.) Nel seguente esempio,
address@hidden @`e un assegnamento di variabile, non un @value{FN}:
+
address@hidden
+awk -f programma.awk file1 count=1 file2
address@hidden example
+
address@hidden @command{gawk}, variabile @code{ARGIND} in
address@hidden @code{ARGIND}, variabile, argomenti da riga di comando
address@hidden @code{ARGV}, vettore, indicizzare all'interno di
address@hidden @code{ARGC}/@code{ARGV}, variabili, argomenti da riga di comando
+Tutti gli argomenti da riga di comando sono resi disponibili al programma
address@hidden nel vettore @code{ARGV} (@pxref{Variabili predefinite}).
Opzioni da
+riga di comando e il testo del programma (se presente) sono esclusi da
address@hidden Tutti gli altri argomenti, compresi gli assegnamenti di
+variabile, sono inclusi. Come ogni elemento di @code{ARGV} viene elaborato,
address@hidden imposta @code{ARGIND} all'indice in @code{ARGV}
+dell'elemento corrente.
+
address@hidden FIXME: One day, move the ARGC and ARGV node closer to here.
+La modifica di @code{ARGC} e @code{ARGV} nel proprio programma @command{awk}
+consente di controllare come @command{awk} elabora i file in input; questo @`e
+descritto address@hidden dettagliatamente in @ref{ARGC e ARGV}.
+
address@hidden file in input, assegnamenti di variabile e
address@hidden assegnamenti di variabile e file in input
+La distinzione tra argomenti che sono @value{FN} e argomenti di assegnamento
+di variabili vien fatta quando @command{awk} deve aprire il successivo file di
+input.
+A quel punto dell'esecuzione, controlla la variabile @value{FN} per vedere se
address@hidden piuttosto un assegnamento di variabile; se
address@hidden@dotless{i}} @`e, @command{awk} imposta la
+variabile invece di leggere un file.
+
+Dunque, le variabili ricevono effettivamente i valori loro assegnati dopo che
+tutti i file precedentemente specificati sono stati letti. In particolare, i
+valori delle variabili assegnati in questo modo @emph{non} sono disponibili
+all'interno di una regola @code{BEGIN}
+(@pxref{BEGIN/END}),
+poich@'e tali regole vengono eseguite prima che @command{awk} cominci a
+esaminare la lista degli argomenti.
+
address@hidden angolo buio, sequenze di protezione
+I valori delle variabili dati sulla riga di comando sono elaborati per
+rimuovere sequenze di protezione (@pxref{Sequenze di protezione}).
address@hidden
+
+In alcune implementazioni di @command{awk} molto vecchie, quando un
+assegnamento di variabile capitava prima di un qualsiasi @value{FN},
+l'assegnamento avveniva @emph{prima} che fosse stata eseguita la regola
address@hidden Il comportamento di @command{awk} era in questo modo
+ambiguo; alcuni assegnamenti da riga di comando erano disponibili
+all'interno della regola @code{BEGIN}, mentre altri no. Sfortunatamente,
+alcune applicazioni finivano per essere dipendenti da questa
address@hidden''. Quando @command{awk} fu modificato per essere address@hidden
+coerente, fu aggiunta l'opzione @option{-v} a beneficio delle
+applicazioni che dipendevano dal vecchio comportamento.
+
+La address@hidden dell'assegnamento di variabile @`e molto utile per assegnare
+valori a variabili come @code{RS}, @code{OFS}, e @code{ORS}, che controllano i
+formati di input e di output, prima di effettuare la scansione dei @value{DF}.
address@hidden utile anche per effettuare passaggi multipli su un o stesso
address@hidden Per esempio:
+
address@hidden file, passaggi multipli su
address@hidden
+awk 'pass == 1 @{ @var{pass 1 stuff} @}
+ pass == 2 @{ @var{pass 2 stuff} @}' pass=1 mydata pass=2 mydata
address@hidden example
+
+Una volta disponibile la address@hidden per assegnare una variabile, l'opzione
address@hidden per impostare il valore di @code{FS} non @`e address@hidden
strettamente
+necessaria. Rimane per address@hidden all'indietro.
+
address@hidden Specificare lo standard input
address@hidden Come specificare lo standard input insieme ad altri file
+
+Capita spesso di voler leggere lo standard input assieme ad altri file.
+Per esempio, leggere un file, leggere lo standard input derivante da una
address@hidden, e poi leggere un altro file.
+
+Il modo di indicare lo standard input, con tutte le versioni di @command{awk},
address@hidden quello di usare un segno meno o trattino da solo, @samp{-}. Per
esempio:
+
address@hidden
address@hidden | awk -f ilmioprogramma.awk file1 - file2
address@hidden example
+
address@hidden
+In questo caso, @command{awk} legge prima @file{file1}, poi legge
+l'output di @var{qualche_comando}, e infile legge
address@hidden
+
+Si address@hidden anche usare @code{"-"} per indicare lo standard input quando
si leggono
+i file con @code{getline} (@pxref{Getline file}).
+
+In aggiunta, @command{gawk} consente di specificare il
address@hidden speciale @file{/dev/stdin}, sia sulla riga di comando che
+quando si usa @code{getline}.
+Anche qualche altra versione di @command{awk} include questa address@hidden,
+ma non @`e standard.
+(Alcuni sistemi operativi prevedono un file @file{/dev/stdin}
+nel filesystem; comunque, @command{gawk} elabora sempre
+questo @value{FN} per conto suo [ossia non importa se il sistema
+operativo rende disponibile il file o no].)
+
address@hidden Variabili d'ambiente
address@hidden Le variabili d'ambiente usate da @command{gawk}
address@hidden variabili d'ambiente usate da @command{gawk}
+
+Diverse variabili d'ambiente influiscono sul comportamento
+di @command{gawk}.
+
address@hidden
+* AWKPATH (Variabile):: Ricerca di programmi @command{awk}
+ in una lista di directory.
+* AWKLIBPATH (Variabile):: Ricerca di librerie condivise
+ @command{awk} su varie directory.
+* Altre variabili d'ambiente:: Le variabili d'ambiente.
address@hidden menu
+
address@hidden AWKPATH (Variabile)
address@hidden Ricerca di programmi @command{awk} in una lista di directory.
address@hidden @env{AWKPATH}, variabile d'ambiente
address@hidden directory, ricerca di file sorgente
address@hidden percorso di ricerca per file sorgente
address@hidden ricerca, percorso di, per file sorgente
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
d'ambiente @env{AWKPATH}
address@hidden
+Il precedente @value{SECTION} ha descritto come i file di programma di
address@hidden possono essere specificati sulla riga di comando con
+l'opzione @option{-f}.
address@hidden ifinfo
+Nella maggior parte delle implementazioni di @command{awk} si deve indicare il
+percorso completo di ogni file di programma, a meno che il file non
+sia nella directory corrente. Con @command{gawk}, invece, se la
+variabile @value{FN} impostata con le opzioni @option{-f} o @option{-i} non
+contiene un separatore di directory @samp{/}, @command{gawk} cerca un file con
+quel nome in un elenco di directory (chiamato @dfn{percorso di ricerca}),
+scorrendole una per una.
+
+Il percorso di ricerca @`e una stringa di nomi di directory separati da due
address@hidden e virgola in MS-Windows.}. @command{gawk} prende
+il percorso di ricerca dalla variabile d'ambiente @env{AWKPATH}. Se questa
+variabile non esiste, o se ha un come valore la stringa nulla,
address@hidden usa un percorso di default (descritto tra poco).
+
+La address@hidden del percorso di ricerca @`e particolarmente utile per
costruire
+librerie di funzioni di @command{awk}. I file di libreria possono essere messi
+in una directory standard inclusa nel percorso di ricerca
+e richiamati sulla riga di comando con un
address@hidden breve. Altrimenti, si dovrebbe scrivere l'intero @value{FN} per
+ciascun file.
+
+Usando l'opzione @option{-i}, o l'opzione @option{-f}, i programmi di
address@hidden scritti sulla riga di comando possono usare le address@hidden
+contenute nei file di libreria di @command{awk}
address@hidden
+(@pxrefil{Funzioni di libreria}).
address@hidden iftex
address@hidden
+(@pxref{Funzioni di libreria}).
address@hidden ifnottex
+La ricerca del percorso non viene eseguita se @command{gawk} @`e in
address@hidden di
address@hidden, sia con l'opzione @option{--traditional} che con l'opzione
address@hidden
address@hidden
+
+Se il file del codice sorgente non viene trovato con una prima ricerca,
+il percorso viene cercato di nuovo dopo aver aggiunto il suffisso
address@hidden al @value{FN}.
+
+Il meccanismo di ricerca del percorso di @command{gawk} @`e simile a quello
+della shell.
+(Si veda @uref{http://www.gnu.org/software/bash/manual/,
address@hidden Bourne-Again SHell manual}}.)
+Un elemento nullo nel percorso indica la directory corrente.
+(Un elemento nullo @`e indicato iniziando o terminando il percorso con un segno
+di @samp{:} oppure mettendo due @samp{:} consecutivi address@hidden::}].)
+
address@hidden NOTA
+Per includere la directory corrente nel percorso di ricerca, si address@hidden
+aggiungere @file{.} come un elemento del percorso di ricerca, oppure
+inserire un elemento nullo.
+
+Diverse passate versioni di @command{gawk} avrebbero effettuato anche una
+ricerca esplicita nella directory corrente, prima o dopo aver esaminato il
+percorso di ricerca. A partire dalla @value{PVERSION} 4.1.2, questo non
+vale address@hidden; se si desidera una ricerca nella directory corrente, @`e
+necessario aggiungere @file{.} esplicitamente, oppure aggiungendo un
+elemento nullo al percorso di ricerca.
address@hidden quotation
+
+Il valore di default di @env{AWKPATH} @`e
address@hidden:/usr/local/share/address@hidden versione di @command{gawk}
+che state usando potrebbe usare una directory diversa; address@hidden dipende
da come
address@hidden @`e stato compilato e installato. La directory effettiva @`e il
+valore di @code{$(datadir)} generato quando @`e stato configurato
address@hidden Non @`e comunque il caso di preoccuparsi per questo.}
+Poich@'e @file{.} @`e incluso all'inizio, @command{gawk} cerca dapprima nella
+directory corrente, e poi in @file{/usr/local/share/awk}.
+In pratica, questo vuol dire che solo raramente ci address@hidden bisogno di
cambiare
+il valore di @env{AWKPATH}.
+
address@hidden da usare a inizio sessione}, per informazioni su funzioni che
possono
+essere di aiuto per gestire la variabile @env{AWKPATH}.
+
address@hidden memorizza il valore del percorso di ricerca in uso in
address@hidden"AWKPATH"]}. Questo consente di aver accesso al valore del
+percorso di ricerca in uso all'interno di un programma @command{awk}.
+
+Sebbene la variabile @code{ENVIRON["AWKPATH"]} possa
+essere cambiata anche all'interno di
+un programma @command{awk}, questo non modifica il comportamento del
+programma in esecuzione. Questo comportamento ha una sua logica: la variabile
+d'ambiente @env{AWKPATH} @`e usata per trovare i file sorgenti del programma;
una
+volta che il programma @`e in esecuzione, tutti i file sono stati trovati,
+e @command{gawk} non ha address@hidden bisogno di usare @env{AWKPATH}.
+
address@hidden AWKLIBPATH (Variabile)
address@hidden Ricerca di librerie condivise @command{awk} su varie directory.
address@hidden @env{AWKLIBPATH}, variabile d'ambiente
address@hidden directory, ricerca di estensioni caricabili
address@hidden percorso di ricerca per estensioni
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
d'ambiente @code{AWKLIBPATH}
+
+La variabile d'ambiente @env{AWKLIBPATH} @`e simile alla variabile
@env{AWKPATH},
+ma @`e usata per ricercare estensioni caricabili (memorizzate come
+librerie condivise di sistema) specificate con l'opzione @option{-l},
+anzich@'e file sorgenti. Se l'estensione non viene trovata, il percorso viene
+cercato nuovamente dopo aver aggiunto il suffisso per la libreria condivisa
+appropriato per la piattaforma. Per esempio, sui sistemi GNU/Linux viene usato
+il suffisso @samp{.so}. Il percorso di ricerca specificato @`e usato anche
+attraverso la direttiva @code{@@load}
+(@pxref{Caricare librerie condivise}).
+
+Se la variabile d'ambiente @env{AWKLIBPATH} non esiste, o se ha come valore
+la stringa nulla, @command{gawk} usa un percorso di ricerca di default;
+questo normalmente vale @samp{/usr/local/lib/gawk}, anche se il suo valore
address@hidden essere diverso, a seconda di come @`e stato installato
@command{gawk}.
+
address@hidden da usare a inizio sessione}, per informazioni su funzioni che
possono
+essere di aiuto per gestire la variabile @env{AWKPATH}.
+
address@hidden memorizza il valore del percorso di ricerca in uso in
address@hidden"AWKLIBPATH"]}. Questo consente di aver accesso al valore del
+percorso di ricerca in uso all'interno di un programma @command{awk}.
+
address@hidden Altre variabili d'ambiente
address@hidden Le variabili d'ambiente.
+
+Molte altre variabili d'ambiente influenzano il comportamento di
address@hidden, ma esse sono address@hidden specializzate. Quelle dell'elenco
seguente
+sono quelle address@hidden utili agli utenti normali:
+
address@hidden @env
address@hidden GAWK_MSEC_SLEEP
+Specifica l'intervallo tra due tentativi di riconnessione,
+in millisecondi. Sui sistemi che non prevedono
+la chiamata di sistema @code{usleep()},
+il valore @`e arrotondato a un numero intero di secondi .
+
address@hidden GAWK_READ_TIMEOUT
+Specifica per quanto tempo, in millisecondi, @command{gawk}
+aspetta l'input prima di emettere un messaggio di errore.
+
address@hidden GAWK_SOCK_RETRIES
+Controlla il numero di volte che @command{gawk} cerca di
+ristabilire una connessione bidirezionale TCP/IP (@dfn{socket}) prima di
+rinunciare a farlo.
address@hidden TCP/IP}.
+Si noti che quando @`e attiva l'opzione di continuazione dopo errori di I/O
+(@pxref{Continuazione dopo errori}),
address@hidden tenta di aprire un @dfn{socket} TCP/IP soltanto una volta.
+
address@hidden POSIXLY_CORRECT
+Provoca il passaggio di @command{gawk} alla address@hidden di address@hidden
POSIX,
+disabilitando tutte le estensioni tradizionali e GNU.
address@hidden
address@hidden table
+
+Le variabili d'ambiente nell'elenco che segue sono utili
+soprattutto agli sviluppatori di @command{gawk} per il collaudo e la messa
+a punto del programma. Sono soggette a cambiamenti. Le variabili sono:
+
address@hidden @env
address@hidden AWKBUFSIZE
+Questa variabile riguarda solo @command{gawk} installato su sistemi
+conformi a POSIX.
+Col valore di @samp{exact}, @command{gawk} usa la dimensione di ogni file di
+input come dimensione del buffer di memoria da allocare per I/O. Altrimenti,
+il valore dovrebbe essere un numero, e @command{gawk} usa questo numero come
+dimensione del buffer da allocare. (Quando questa variabile non @`e impostata,
address@hidden usa la address@hidden piccola tra le dimensioni del file e la
dimensione
+del blocco di ``default'', che normalmente @`e la dimensione del blocco I/O
+del filesystem).
+
address@hidden AWK_HASH
+Se questa variabile @`e impostata con un valore di @samp{gst}, @command{gawk}
+usa la funzione hash di GNU Smalltalk per gestire i vettori.
+Questa funzione address@hidden essere leggermente address@hidden veloce della
funzione standard.
address@hidden AWKREADFUNC
+Se questa variabile esiste, @command{gawk} legge i file sorgenti una riga per
+volta, anzich@'e a blocchi. Questa variabile @`e presente
+per problemi di debug su filesystem di sistemi operativi non POSIX,
+dove l'I/O @`e elaborato a record, non a blocchi.
+
address@hidden GAWK_MSG_SRC
+Se questa variabile esiste, @command{gawk} include il @value{FN} e il
+numero di riga all'interno del codice sorgente @command{gawk}
+dal quale sono stati generati i messaggi di avvertimento o
+i messaggi di errore grave. Il suo intento @`e quello di aiutare a isolare
+l'origine di un messaggio, poich@'e ci possono essere address@hidden righe di
codice che
+producono lo stesso messaggio di avvertimento o di errore.
+
address@hidden GAWK_LOCALE_DIR
+Specifica la posizione dei file oggetto compilati contenenti la traduzione dei
+messaggi emessi da @command{gawk} stesso. Questa variabile @`e passata alla
+funzione @code{bindtextdomain()} nella fase di partenza di @command{gawk}.
+
address@hidden GAWK_NO_DFA
+Se questa variabile esiste, @command{gawk} non usa il riconoscitore di
+espressioni regolari ASFD [automa a stati finiti deterministico] per i tipi di
+test di corrispondenza. Questo address@hidden causare un rallentamento di
@command{gawk}.
+Il suo intento @`e quello di aiutare a isolare le differenze tra i due
+riconoscitori di espressioni regolari che @command{gawk} usa internamente (non
+dovrebbero esserci differenze, ma a volte la teoria non coincide con la
+pratica).
+
address@hidden GAWK_STACKSIZE
+Specifica di quanto @command{gawk} dovrebbe accrescere il suo stack di
+valutazione interno, all'occorrenza.
+
address@hidden INT_CHAIN_MAX
+Specifica il numero massimo previsto di elementi che @command{gawk} mantiene
+su una catena hash per gestire i vettori indicizzati da numeri interi.
+
address@hidden STR_CHAIN_MAX
+Specifica il numero massimo previsto di elementi che @command{gawk} mantiene
+su una catena hash per gestire i vettori indicizzati da stringhe.
+
address@hidden TIDYMEM
+Se questa variabile esiste, @command{gawk} usa le chiamate di libreria
address@hidden()} della @dfn{GNU C library} per aiutare a scoprire
+possibili sprechi di memoria.
address@hidden table
+
address@hidden Codice di ritorno
address@hidden Il codice di ritorno all'uscita da @command{gawk}
+
address@hidden codice di ritorno, di @command{gawk}
address@hidden stato d'uscita, di @command{gawk}
+Se l'istruzione @code{exit} viene usata con un valore
+(@pxref{Istruzione exit}), @command{gawk} termina l'esecuzione con il valore
+numerico specificato.
+
+Altrimenti, se non ci sono stati problemi durante l'esecuzione,
address@hidden esce col valore della costante C
address@hidden, che normalmente @`e zero.
+
+Se si verifica un errore, @command{gawk} esce col valore della
+costante C @code{EXIT_FAILURE}, che normalmente @`e uguale a uno.
+
+Se @command{gawk} esce a causa di un errore grave, il codice di ritorno
address@hidden due. Sui sistemi non POSIX questo valore address@hidden essere
mappato
+a @code{EXIT_FAILURE}.
+
address@hidden Includere file
address@hidden Come includere altri file nel proprio programma
+
address@hidden Panos Papadopoulos <address@hidden> contributed the original
address@hidden text for this section.
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
address@hidden @code{@@include}, direttiva
address@hidden direttiva @code{@@include}
address@hidden includere file, direttiva @code{@@include}
+La direttiva @code{@@include} address@hidden essere usata per leggere file
sorgenti
+di @command{awk} esterni. Questo address@hidden la address@hidden di
suddividere file
+sorgenti di @command{awk} di grandi dimensioni in porzioni address@hidden
piccole e address@hidden
+maneggevoli, e anche di riutilizzare codice @command{awk} di uso comune
+da diversi @dfn{script} @command{awk}. In altre parole, si possono
+raggruppare funzioni di @command{awk} usate per eseguire determinati compiti
+all'interno di file esterni. Questi file possono essere usati proprio come
+librerie di funzioni, usando la direttiva @code{@@include} assieme alla
+variabile d'ambiente @env{AWKPATH}. Si noti che i file sorgenti possono
+venire inclusi anche usando l'opzione @option{-i}.
+
+Vediamolo con un esempio.
+Iniziamo con due @dfn{script} @command{awk} (banali), che chiameremo
address@hidden e @file{test2}. Questo @`e lo @dfn{script} @file{test1}:
+
address@hidden
+BEGIN @{
+ print "Questo @`e lo script test1."
address@hidden
address@hidden example
+
address@hidden
+e questo @`e @file{test2}:
+
address@hidden
+@@include "test1"
+BEGIN @{
+ print "Questo @`e lo script test2."
address@hidden
address@hidden example
+
+L'esecuzione di @command{gawk} con @file{test2}
+produce il seguente risultato:
+
address@hidden
+$ @kbd{gawk -f test2}
address@hidden Questo @`e lo script test1.
address@hidden Questo @`e lo script test2.
address@hidden example
+
address@hidden esegue lo @dfn{script} @file{test2}, il quale include
address@hidden, usando la direttiva @code{@@include}.
address@hidden@dotless{i}}, per includere file sorgenti di @command{awk}
esterni, basta usare
address@hidden@@include} seguito dal nome del file da includere,
+racchiuso tra doppi apici.
+
address@hidden NOTA
+Si tenga presente che questo @`e un costrutto del linguaggio e che @value{FN}
+non address@hidden essere una variabile di tipo stringa, ma solo una costante
di tipo
+letterale racchiusa tra doppi apici.
address@hidden quotation
+
+I file da includere possono essere nidificati; p.es., dato un terzo
address@hidden, che chiameremo @file{test3}:
+
address@hidden
+@@include "test2"
+BEGIN @{
+ print "Questo @`e lo script test3."
address@hidden
address@hidden example
+
address@hidden
+L'esecuzione di @command{gawk} con lo @dfn{script} @file{test3} produce i
+seguenti risultati:
+
address@hidden
+$ @kbd{gawk -f test3}
address@hidden Questo @`e lo script test1.
address@hidden Questo @`e lo script test2.
address@hidden Questo @`e lo script test3.
address@hidden example
+
+Il @value{FN}, naturalmente, address@hidden essere un nome di percorso.
+Per esempio:
+
address@hidden
+@@include "../funzioni_di_i_o"
address@hidden example
+
address@hidden
+e:
+
address@hidden
+@@include "/usr/awklib/network"
address@hidden example
+
address@hidden
+sono entrambi percorsi validi. La variabile d'ambiente @env{AWKPATH}
address@hidden
+rivestire grande importanza quando si usa @code{@@include}. Le stesse
+regole per l'uso della variabile d'ambiente @env{AWKPATH} nelle ricerche
+da riga di comando
+(@pxref{AWKPATH (Variabile)}) si applicano anche a
address@hidden@@include}.
+
+Questo @`e di grande aiuto nella costruzione di librerie di funzioni di
address@hidden Se si ha uno @dfn{script} di grandi dimensioni contenente
+utili funzioni @command{awk} di uso comune, lo si address@hidden suddividere
in file
+di libreria e mettere questi file in una directory dedicata. In seguito si
+possono includere queste ``librerie'' usando il percorso completo dei
+file, o impostando opportunamente la variabile d'ambiente @env{AWKPATH} e
+quindi usando @code{@@include} con la sola parte del percorso completo che
+designa il file. Naturalmente,
+si possono tenere i file di libreria in address@hidden di una directory;
address@hidden @`e complesso l'ambiente di lavoro, address@hidden
+directory possono essere necessarie per organizzare i file da includere.
+
+Vista la address@hidden di specificare opzioni @option{-f} multiple, il
+meccanismo @code{@@include} non @`e strettamente necessario.
+Comunque, la direttiva @code{@@include} address@hidden essere d'aiuto nel
costruire
+programmi @command{gawk} autosufficienti, riducendo address@hidden@dotless{i}}
la address@hidden
+di scrivere righe di comando complesse e tediose.
+In particolare, @code{@@include} @`e molto utile per scrivere @dfn{script} CGI
+eseguibili da pagine web.
+
+Come @`e stato detto in @ref{AWKPATH (Variabile)}, i file sorgenti vengono
+sempre cercati nella directory corrente, prima di eseguire la ricerca in
address@hidden; questo si applica anche ai file indicati con
address@hidden@@include}.
+
address@hidden Caricare librerie condivise
address@hidden Caricare librerie condivise nel proprio programma
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
address@hidden @code{@@load}, direttiva
address@hidden direttiva @code{@@load}
address@hidden caricare estensioni, direttiva @code{@@load}
address@hidden estensioni, caricamento, direttiva @code{@@load}
+La direttiva @code{@@load} address@hidden essere usata per leggere estensioni
di
address@hidden esterne (memorizzate come librerie condivise di sistema).
+Questo consente di collegare del codice compilato che address@hidden offrire
prestazioni
+migliori o dare l'accesso a address@hidden estese non incluse nel linguaggio
address@hidden La variabile @env{AWKLIBPATH} viene usata per ricercare
+l'estensione. Usare @code{@@load} @'e del tutto equivalente a usare l'opzione
da
+riga di comando @option{-l}.
+
+Se l'estensione non viene trovata in @env{AWKLIBPATH}, viene effettuata
+un'altra ricerca dopo aver aggiunto al @value{FN} il suffisso della
+libreria condivisa comunemente in uso per la piattaforma corrente. Per
+esempio, sui sistemi GNU/Linux viene usato il suffisso @samp{.so}:
+
address@hidden
+$ @kbd{gawk '@@load "ordchr"; BEGIN @{print chr(65)@}'}
address@hidden A
address@hidden example
+
address@hidden
+Questo @`e equivalente all'esempio seguente:
+
address@hidden
+$ @kbd{gawk -lordchr 'BEGIN @{print chr(65)@}'}
address@hidden A
address@hidden example
+
address@hidden
+Per l'uso da riga di comando @`e address@hidden conveniente l'opzione
@option{-l},
+ma @code{@@load} @`e utile da inserire all'interno di un file sorgente di
address@hidden che richieda l'accesso a un'estensione.
+
address@hidden dinamiche}, descrive come scrivere estensioni (in C or C++)
+che possono essere caricate sia con @code{@@load} che con l'opzione
address@hidden @`E anche descritta l'estensione @code{ordchr}.
+
address@hidden Parti obsolete
address@hidden Opzioni e/o address@hidden obsolete
+
address@hidden update this section for each release!
+
address@hidden opzioni deprecate
address@hidden address@hidden deprecate
address@hidden obsolete, address@hidden
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive address@hidden o opzioni da riga di comando
+provenienti da precedenti versioni di @command{gawk} che non sono
address@hidden
+disponibili nella versione corrente, o che sono ancora utilizzabili ma sono
+deprecate (address@hidden significa che @emph{non} saranno presenti nella
prossima
+versione).
+
+I file speciali relativi ai processi @file{/dev/pid}, @file{/dev/ppid},
address@hidden/dev/pgrpid} e @file{/dev/user} erano deprecati, ma ancora
disponibili,
+in @command{gawk} 3.1. A partire dalla @value{PVERSION} 4.0, non sono
address@hidden interpretati da @command{gawk} in modo speciale (al loro posto
usare
+invece @code{PROCINFO}; si veda @ref{Variabili auto-assegnate}).
+
address@hidden
+This @value{SECTION}
+is thus essentially a place holder,
+in case some option becomes obsolete in a future version of @command{gawk}.
address@hidden ignore
+
address@hidden Non documentato
address@hidden Opzioni e address@hidden non documentate
address@hidden non documentate, address@hidden
address@hidden address@hidden non documentate
address@hidden Skywalker, Luke
address@hidden Kenobi, Obi-Wan
address@hidden Jedi, Cavalieri
address@hidden Cavalieri Jedi
address@hidden
address@hidden il codice sorgente, Luke!}
address@hidden Obi-Wan
address@hidden quotation
+
address@hidden conchiglie, mare
address@hidden
+Questa @value{SECTION} @`e stata lasciata intenzionalmente vuota.
address@hidden ifnotinfo
address@hidden
+Questo @value{SECTION} @`e stato lasciato intenzionalmente vuoto.
address@hidden ifinfo
+
address@hidden
address@hidden If these came out in the Info file or TeX document, then they
wouldn't
address@hidden be undocumented, would they?
+
address@hidden ha un'opzione non documentata:
+
address@hidden @code
address@hidden -W nostalgia
address@hidden --nostalgia
+Stampa il messaggio @samp{awk: bailing out near line 1} e termina
+con un errore grave.
+Quest'opzione @`e stata ispirata dal comportamento comune delle primissime
+versioni di @command{awk} Unix e da una maglietta [con la scritta].
+Il messaggio @emph{NON} viene tradotto in ambienti non inglesi.
address@hidden so there! nyah, nyah.
address@hidden table
+
+Le prime versioni di @command{awk} non richiedevano alcun separatore (a capo
+
+o @samp{;}) tra le regole nei programmi @command{awk}. Quindi,
+era normale vedere programmi di una riga come:
+
address@hidden
+awk '@{ sum += $1 @} END @{ print sum @}'
address@hidden example
+
address@hidden in address@hidden consente questo stile, ma la cosa non @`e
+documentata per non incoraggiare la pratica. Il modo corretto per scrivere
+quel programma @`e uno dei
+seguenti:
+
address@hidden
+awk '@{ sum += $1 @} ; END @{ print sum @}'
address@hidden example
+
address@hidden
+oppure:
+
address@hidden
+awk '@{ sum += $1 @}
+ END @{ print sum @}' data
address@hidden example
+
address@hidden
address@hidden/Righe}, per una spiegazione address@hidden ampia.
+
+Si possono inserire righe bianche dopo @samp{;} nei cicli @code{for}.
+Questa sembre essere stata una address@hidden a lungo non documentata in
address@hidden Unix.
+
+Analogamente, si possono usare istruzioni @code{print} o @code{printf}
+nelle parti @var{valore-iniziale} e @var{incremento} di un ciclo
address@hidden Questa @`e un'altra address@hidden a lungo non documentata in
address@hidden Unix.
+
address@hidden consente di usare come nomi di parametro dei
+nomi di funzioni predefinite che facciano parte delle estensioni
address@hidden, all'interno di funzioni definite dall'utente.
+Questo avviene per ``salvaguardare per il futuro'' vecchi programmi che
+utilizzino nomi di funzioni aggiunte da @command{gawk} dopo che questi
+programmi erano stati scritti.
+Le funzioni predefinite standard di command{awk}, per esempio
address@hidden()} o @code{substr()} @emph{non} ammettono questa address@hidden
+
+Il vettore @code{PROCINFO["argv"]} contiene tutti gli argomenti della
+riga di comando (una volta espansi i metacaratteri ed elaborata la
+ridirezione, nelle piattaforme in cui address@hidden dev'essere fatto
manualmente
+dal programma), con indici che vanno da 0 as @code{argc} @minus{} 1.
+Per esempio, @code{PROCINFO["argv"][0]} address@hidden il nome con cui @`e
+stato invocato @command{gawk}. L'esempio seguente mostra come @`e
+possibile usare questa address@hidden:
+
address@hidden
+awk '
+BEGIN @{
+ for (i = 0; i < length(PROCINFO["argv"]); i++)
+ print i, PROCINFO["argv"][i]
address@hidden'
address@hidden example
+
address@hidden da tener presente che questo vettore @`e diverso dal vettore
+standard @code{ARGV} che non comprende quegli argomenti della riga di
+comando che sono address@hidden stati elaborati da
address@hidden (@pxref{ARGC e ARGV}).
+
address@hidden ignore
+
address@hidden Sommario invocazione
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Per eseguire @command{awk} usare, o
address@hidden '@var{programma}' @var{file}}
+o
address@hidden -f @var{file-del-programma} @var{file}}.
+
address@hidden
+Le tre opzioni standard per tutte le versioni di @command{awk} sono
address@hidden, @option{-F} e @option{-v}. @command{gawk} fornisce queste e
+molte altre, come pure le opzioni estese corrispondenti scritte in stile GNU.
+
address@hidden
+Gli argomenti da riga di comando che non sono opzioni sono trattati normalmente
+come @value{FNS}, a meno che non abbiano la forma @address@hidden@var{valore}};
+nel qual caso vengono riconosciuti come assegnamenti di variabile da eseguire
+in quel punto
+nell'elaborazione dell'input.
+
address@hidden
+Tutti gli argomenti da riga di comando che non sono opzioni, escluso il testo
+del programma, vengono messe nel vettore @code{ARGV}. Modifiche a @code{ARGC}
+e @code{ARGV} influiscono su come @command{awk} elabora l'input.
+
address@hidden
+Si address@hidden usare un segno meno a s@'e stante (@samp{-}) per designare
lo standard
+input sulla riga di comando. @command{gawk} consente anche di usare il
address@hidden speciale @file{/dev/stdin}.
+
+
address@hidden
address@hidden tiene conto di diverse variabili d'ambiente;
address@hidden, @env{AWKLIBPATH} e @env{POSIXLY_CORRECT} sono le
address@hidden importanti.
+
address@hidden
+Lo stato d'uscita di @command{gawk} invia informazioni al programma che lo
+ha invocato. Usare l'istruzione @code{exit} dall'interno di un programma
address@hidden per impostare il codice di ritorno.
+
address@hidden
address@hidden consente di includere nel proprio programma file sorgenti di
address@hidden con la direttiva @code{@@include} o con le opzioni da riga di
+comando @option{-i} e @option{-f}.
+
address@hidden
address@hidden consente di caricare funzioni aggiuntive scritte in C
+o C++ con la direttiva @code{@@load} e/o con l'opzione @option{-l}
+(questa address@hidden avanzata @`e descritta address@hidden avanti, in
address@hidden dinamiche}).
address@hidden itemize
address@hidden Espressioni regolari
address@hidden Espressioni regolari
address@hidden @dfn{regexp}
address@hidden espressioni regolari
+
+Una @dfn{espressione regolare}, o @dfn{regexp}, @`e un modo per descrivere un
+insieme di stringhe.
+Poich@'e le espressioni regolari sono una parte fondamentale della
+programmazione in @command{awk}, il loro formato e il loro uso meritano un
address@hidden a s@'e stante.
+
address@hidden barra (@code{/}), per delimitare le espressioni regolari
address@hidden @code{/} (barra), per delimitare le espressioni regolari
+Un'espressione regolare racchiusa tra barre (@samp{/})
address@hidden un modello di ricerca @command{awk} che individua tutti i record
in input
+il cui testo corrisponde al modello stesso.
+L'espressione regolare address@hidden semplice @`e una sequenza di lettere o
di numeri, o
+di entrambi. Una tale @dfn{regexp} individua ogni stringa che contenga quella
+particolare sequenza.
+Quindi, la @dfn{regexp} @samp{pippo} individua ogni stringa che contenga
address@hidden In altre parole, al modello di ricerca @code{/pippo/}
corrisponde
+ogni record in input che contiene i cinque caratteri consecutivi @samp{pippo}
address@hidden qualsiasi parte} del record. Altri tipi di @dfn{regexp}
permettono
+di specificare classi di stringhe molto address@hidden complesse.
+
address@hidden
+All'inizio, gli esempi in questo @value{CHAPTER} sono semplici.
+Man mano che entriamo nei dettagli su
+come funzionano le espressioni regolari utilizzeremo formulazioni
address@hidden
+complesse.
address@hidden ifnotinfo
+
address@hidden
+* Uso di @dfn{regexp}:: Come usare le espressioni regolari.
+* Sequenze di protezione:: Come scrivere caratteri non stampabili.
+* Operatori di espressioni regolari:: Operatori di espressioni regolari.
+* Espressioni tra parentesi quadre:: Cosa possono contenere @samp{[...]}.
+* address@hidden lungo da sinistra:: Quanto @`e lungo il testo
individuato.
+* Espressioni regolari calcolate:: Usare @dfn{regexp} dinamiche.
+* Operatori di @dfn{regexp} GNU:: Operatori propri del software GNU.
+* Maiuscolo-Minuscolo:: Fare confronti ignorando
+ maiuscolo/minuscolo.
+* Sommario espressioni regolari:: Sommario delle espressioni regolari.
address@hidden menu
+
address@hidden Uso di @dfn{regexp}
address@hidden Uso di espressioni regolari
+
address@hidden espressioni regolari, come criteri di ricerca
+Un'espressione regolare address@hidden essere usata come modello di ricerca
+racchiudendola tra barre. L'espressione regolare @`e quindi confrontata
+con tutto il testo di ogni record (normalmente, basta che corrisponda a
+una parte qualsiasi del testo per risultare soddisfatta). Per esempio,
+il seguente programma stampa il secondo campo di ogni record in cui compaia
+la stringa @samp{li}, in qualsiasi parte del record:
+
address@hidden
+$ @kbd{awk '/li/ @{ print $2 @}' mail-list}
address@hidden 555-5553
address@hidden 555-0542
address@hidden 555-6699
address@hidden 555-3430
address@hidden example
+
address@hidden espressioni regolari, operatori
address@hidden operatori, ricerca in stringhe
address@hidden @cindex operators, @code{~}
address@hidden ricerca in stringhe, operatori
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @cindex operatori, @code{!~}
address@hidden @code{if}, istruzione, uso di espressioni regolari in
address@hidden @code{while}, istruzione, uso di espressioni regolari in
address@hidden @address@hidden, istruzione, uso di espressioni regolari in
address@hidden @cindex istruzione @code{if}
address@hidden @cindex istruzione @code{while}
address@hidden @cindex istruzione @code{do}
+Espressioni regolari possono anche essere usate in espressioni di confronto.
+Queste espressioni consentono di specificare le stringhe da riconoscere;
+non devono necessariamente comprendere l'intero record corrente. I due
+operatori @samp{~} e @samp{!~} confrontano espressioni regolari. Le
+espressioni che usano questi operatori possono essere usate come modelli di
+ricerca, o nelle istruzioni @code{if}, @code{while}, @code{for}, e @code{do}.
+(@xref{Istruzioni}.)
+Per esempio:
+
address@hidden
address@hidden ~ /@var{regexp}/
address@hidden example
+
address@hidden
address@hidden verificata se l'espressione @var{exp} (intesa come stringa)
+corrisponde a @var{regexp}. L'esempio che segue individua, o sceglie,
+tutti i record in input in cui la lettera maiuscola @samp{J} @`e presente da
+qualche parte nel primo campo:
+
address@hidden
+$ @kbd{awk '$1 ~ /J/' inventory-shipped}
address@hidden Jan 13 25 15 115
address@hidden Jun 31 42 75 492
address@hidden Jul 24 34 67 436
address@hidden Jan 21 36 64 620
address@hidden example
+
+Lo stesso risultato si address@hidden ottenere anche
address@hidden@dotless{i}}:
+
address@hidden
+awk '@{ if ($1 ~ /J/) print @}' inventory-shipped
address@hidden example
+
+Il prossimo esempio chiede che l'espressione @var{exp}
+(intesa come stringa)
address@hidden corrisponda a @var{regexp}:
+
address@hidden
address@hidden !~ /@var{regexp}/
address@hidden example
+
+L'esempio che segue individua o sceglie tutti i record in input il cui
+primo campo @emph{NON} contiene
+la lettera maiuscola @samp{J}:
+
address@hidden
+$ @kbd{awk '$1 !~ /J/' inventory-shipped}
address@hidden Feb 15 32 24 226
address@hidden Mar 15 24 34 228
address@hidden Apr 31 52 63 420
address@hidden May 16 34 29 208
address@hidden
address@hidden example
+
address@hidden @dfn{regexp}, costanti
address@hidden costanti @dfn{regexp}
address@hidden espressioni regolari, costanti, si veda costanti @dfn{regexp}
+Quando una @dfn{regexp} @`e racchiusa tra barre, come @code{/pippo/}, la
chiamiamo
+una @dfn{costante regexp}, proprio come @code{5.27} @`e una costante
+numerica e @code{"pippo"} @`e una costante [di tipo] stringa.
+
address@hidden Sequenze di protezione
address@hidden Sequenze di protezione
+
address@hidden sequenze di protezione, in stringhe
address@hidden barra inversa (@code{\}), in sequenze di protezione
address@hidden @code{\} (barra inversa), in sequenze di protezione
+Alcuni caratteri non possono essere inclusi letteralmente in costanti
+stringa (@code{"pippo"}) o in costanti @dfn{regexp} (@code{/pippo/}).
+Vanno invece rappresentati usando @dfn{sequenze di protezione},
+ossia sequenze di caratteri preceduti da una barra inversa (@samp{\}).
+Una sequenza di protezione address@hidden essere usata per includere un
carattere di
+"doppio apice" in una costante stringa. Poich@'e un semplice doppio apice
+termina la stringa, va usato @samp{\"} per richiedere che un doppio apice sia
+presente all'interno di una stringa. Per esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "Egli le disse \"ciao!\"." @}'}
address@hidden Egli le disse "ciao!".
address@hidden example
+
+Lo stesso carattere di barra inversa @`e un altro carattere che non
address@hidden essere
+incluso normalmente; occorre scrivere @samp{\\} per inserire una barra
+inversa nella stringa o @dfn{regexp}. Quindi, la stringa costituita dai due
+caratteri @samp{"} e @samp{\} deve essere scritta come @code{"\"\\"}.
+
+Altre sequenze di protezione rappresentano caratteri non stampabili
+come TAB o il ritorno a capo. Anche se @`e possibile immettere la maggior
parte dei
+caratteri non stampabili direttamente in una costante stringa o
address@hidden, essi possono non essere di facile comprensione.
+
+La seguente lista elenca
+tutte le sequenze di protezione usate in @command{awk} e
+cosa rappresentano. Se non @`e detto altrimenti, tutte queste sequenze di
+protezione valgono sia per costanti stringa che per costanti @dfn{regexp}:
+
address@hidden @code
address@hidden \\
+Barra inversa letterale, @samp{\}.
+
address@hidden @cindex @command{awk} language, V.4 version
address@hidden @code{\} (barra inversa), @code{\a}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\a}, sequenza di protezione
address@hidden \a
+Il carattere ``campanello'', @kbd{Ctrl-g}, codice ASCII 7 (BEL).
+(Spesso genera qualche tipo di segnale sonoro udibile.)
+
address@hidden @code{\} (barra inversa), @code{\b}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\b}, sequenza di protezione
address@hidden \b
+Barra inversa, @kbd{Ctrl-h}, codice ASCII 8 (BS).
+
address@hidden @code{\} (barra inversa), @code{\f}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\f}, sequenza di protezione
address@hidden \f
+Nuova pagina, @kbd{Ctrl-l}, codice ASCII 12 (FF).
+
address@hidden @code{\} (barra inversa), @code{\n}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\n}, sequenza di protezione
address@hidden \n
+A capo, @kbd{Ctrl-j}, codice ASCII 10 (LF).
+
address@hidden @code{\} (barra inversa), @code{\r}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\r}, sequenza di protezione
address@hidden \r
+Ritorno del carrello, @kbd{Ctrl-m}, codice ASCII 13 (CR).
+
address@hidden @code{\} (barra inversa), @code{\t}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\t}, sequenza di protezione
address@hidden \t
+Tabulazione orizzontale, @kbd{Ctrl-i}, codice ASCII 9 (HT).
+
address@hidden @cindex @command{awk} language, V.4 version
address@hidden @code{\} (barra inversa), @code{\v}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\v}, sequenza di protezione
address@hidden \v
+Tabulazione verticale, @kbd{Ctrl-k}, codice ASCII 11 (VT).
+
address@hidden @code{\} (barra inversa), @address@hidden, sequenza di protezione
address@hidden barra inversa (@code{\}), @address@hidden, sequenza di protezione
address@hidden address@hidden
+Il valore ottale @var{nnn}, dove @var{nnn} address@hidden essere da 1 a 3
cifre ottali,
+tra @samp{0} e @samp{7}. Per esempio, il codice per il carattere ASCII ESC
+(escape) @`e @samp{\033}.
+
address@hidden @cindex @command{awk} language, V.4 version
address@hidden @cindex @command{awk} language, POSIX version
address@hidden @code{\} (barra inversa), @code{\x}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\x}, sequenza di protezione
address@hidden comuni, address@hidden @code{\x}, sequenza di protezione
address@hidden estensioni comuni, @code{\x}, sequenza di protezione
address@hidden address@hidden@dots{}
+Il valore esadecimale @var{hh}, dove @var{hh} indica una sequenza di cifre
+esadecimali (@address@hidden, e @address@hidden
+o @address@hidden). Dopo @samp{\x} @`e consentito un massimo di due cifre.
+Ogni ulteriore cifra esadecimale @`e considerata come una semplice
+lettera o numero. @value{COMMONEXT}
+(La sequenza di protezione @samp{\x} non @`e permessa in POSIX awk.)
+
address@hidden ATTENZIONE
+In ISO C, la sequenza di protezione continua fino a raggiungere il primo
+carattere che non sia una cifra esadecimale.
+In passato, @command{gawk} avrebbe continuato ad aggiungere
+cifre esadecimali al valore finch@'e non trovava una cifra non esadecimale
+oppure fino a raggiungere la fine della stringa.
+Comunque usare address@hidden di due cifre esadecimali produceva risultati
indefiniti.
+Dalla @value{PVERSION} 4.2,
+vengono elaborate solo due cifre.
address@hidden quotation
+
address@hidden @code{\} (barra inversa), @code{\/}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\/}, sequenza di protezione
address@hidden \/
+Una barra (necessario solo per costanti @dfn{regexp}).
+Questa sequenza si usa per inserire una costante @dfn{regexp}
+che contiene una barra
+(come @code{/.*:\/home\/[[:alnum:]]+:.*/}; la notazione @samp{[[:alnum:]]}
address@hidden spiegata address@hidden avanti,
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden tra parentesi quadre}).
+Poich@'e una @dfn{regexp} @`e racchiusa tra
+barre, si deve proteggere ogni barra che sia parte dell'espressione, per dire
+ad @command{awk} di andare avanti a scandire il resto della @dfn{regexp}.
+
address@hidden @code{\} (barra inversa), @code{\"}, sequenza di protezione
address@hidden barra inversa (@code{\}), @code{\"}, sequenza di protezione
address@hidden \"
+Un doppio apice (necessario solo per costanti stringa).
+Questa sequenza si usa per inserire in una costante stringa il carattere
+doppio apice
+(come @code{"Egli le disse \"ciao!\"."}).
+Poich@'e la stringa @`e racchiusa tra
+doppi apici, si deve proteggere ogni doppio apice che sia parte della stringa
+per dire ad @command{awk} di andare avanti a elaborare il resto della stringa.
address@hidden table
+
+In @command{gawk}, parecchie altre sequenze di due caratteri inizianti con
+con una barra inversa hanno un significato speciale nelle @dfn{regexp}.
address@hidden di @dfn{regexp} GNU}.
+
+In una @dfn{regexp}, una barra inversa che preceda un carattere non presente
+nella lista precedente, e non elencato in
address@hidden di @dfn{regexp} GNU},
+significa che il carattere seguente dovrebbe essere preso letteralmente,
+anche se normalmente sarebbe un operatore di @dfn{regexp}. Per esempio,
address@hidden/a\+b/} individua i tre caratteri @samp{a+b}.
+
address@hidden barra inversa (@code{\}), in sequenze di protezione
address@hidden @code{\} (barra inversa), in sequenze di protezione
address@hidden address@hidden
+Per una completa address@hidden, non usare una barra inversa prima di qualsiasi
+carattere non incluso nella lista precedente, o che non sia un operatore.
address@hidden 11/2014: Moved so as to not stack sidebars
address@hidden Barra inversa prima di un carattere normale
address@hidden address@hidden, barra inversa in sequenze di protezione
address@hidden POSIX @command{awk}, barre inverse in costanti stringa
address@hidden barra inversa (@code{\}), in sequenze di protezione, POSIX e
address@hidden @code{\} (barra inversa), in sequenze di protezione, POSIX e
+
address@hidden risoluzione di problemi, barra inversa prima di caratteri non
speciali
address@hidden problemi, risoluzione di, barra inversa prima di caratteri non
speciali
+Se si mette una barra inversa in una costante stringa prima di qualcosa che
+non sia uno dei caratteri elencati sopra, POSIX @command{awk} di proposito
+lascia indefinito il comportamento. Ci sono due address@hidden:
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden Brian Kernighan, @command{awk} di
address@hidden @asis
address@hidden Togliere la barra inversa
+Questo @`e quel che sia BWK @command{awk} che @command{gawk} fanno.
+Per esempio, @code{"a\qc"} equivale a @code{"aqc"}.
+(Poich@'e questo @`e un errore che address@hidden capitare o non capitare con
la stessa
address@hidden, @command{gawk} lo segnala).
+Volendo usare come separatore di campo @samp{FS = @w{"[ \t]+\|[ \t]+"}}
+ossia delle barre verticali precedute e seguite da almeno uno spazio,
+occorre mettere due barre inverse nella stringa:
address@hidden = @w{"[ \t]+\\|[ \t]+"}}.)
address@hidden I did this! This is why I added the warning.
+
address@hidden @command{gawk}, sequenze di protezione
address@hidden Unix @command{awk}, barre inverse in sequenze di protezione
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden Tenere la barra inversa address@hidden@dotless{i}} com'@`e.
+Alcune altre implementazioni di @command{awk} fanno questo.
+In quelle implementazioni, immettere @code{"a\qc"} equivale a immettere
address@hidden"a\\qc"}.
address@hidden table
address@hidden sidebar
+Ricapitolando:
+
address@hidden @value{BULLET}
address@hidden
+Le sequenze di protezione nella lista di cui sopra sono sempre elaborate
+per prime, sia per le costanti stringa che per le costanti @dfn{regexp}.
Questo
+viene fatto quasi subito, non appena @command{awk} legge il programma.
+
address@hidden
address@hidden elabora sia costanti @dfn{regexp} che @dfn{regexp} dinamiche
+(@pxref{Espressioni regolari calcolate}),
+per gli operatori speciali elencati in
address@hidden di @dfn{regexp} GNU}.
+
address@hidden
+Una barra inversa prima di ogni altro carattere richiede di trattare quel
+carattere letteralmente.
address@hidden itemize
+
address@hidden Sequenze di protezione per metacaratteri
address@hidden metacaratteri, sequenze di protezione per
+
+Supponiamo che si usi una protezione ottale o esadecimale
+per rappresentare un metacarattere di @dfn{regexp}
+(si veda @ref{Operatori di espressioni regolari}).
address@hidden considera il carattere come un carattere letterale o
+come un operatore di @dfn{regexp}?
+
address@hidden angolo buio, sequenze di protezione, per metacaratteri
+Storicamente, tali caratteri erano considerati letteralmente.
address@hidden
+Invece, lo standard POSIX richiede che siano considerati
+come metacaratteri veri e propri, e questo @`e address@hidden che
@command{gawk} fa.
+In address@hidden compatibile (@pxref{Opzioni}),
address@hidden tratta i caratteri scritti come sequenze ottali ed esadecimali
+letteramente, quando sono usati in costanti @dfn{regexp}. Quindi,
address@hidden/a\52b/} @`e equivalente a @code{/a\*b/}.
address@hidden sidebar
+
address@hidden Operatori di espressioni regolari
address@hidden Operatori di espressioni regolari
address@hidden espressioni regolari, operatori
address@hidden metacaratteri in espressioni regolari
+
address@hidden possibile inserire in espressioni regolari dei caratteri
speciali,
+detti @dfn{operatori di espressioni regolari} o @dfn{metacaratteri}, per
+aumentarne il potere e la address@hidden
+
+Le sequenze di protezione descritte
address@hidden
+prima
address@hidden ifnotinfo
+in @ref{Sequenze di protezione}
+sono valide all'interno di una @dfn{regexp}. Sono precedute da una @samp{\} e
+sono riconosciute e convertite nei caratteri reali corrispondenti nella
+primissima fase dell'elaborazione delle @dfn{regexp}.
+
+Ecco una lista dei metacaratteri. Tutti i caratteri che non sono sequenze
+di protezione e che non sono elencati qui rappresentano se stessi:
+
address@hidden Use @asis so the docbook comes out ok. Sigh.
address@hidden @asis
address@hidden barra inversa (@code{\}), operatore @dfn{regexp}
address@hidden barra inversa (@code{\}), operatore @dfn{regexp}
address@hidden @code{\} (barra inversa), operatore @dfn{regexp}
address@hidden @code{\}
+Si usa per togliere il significato speciale a un carattere quando si effettuano
+confronti. Per esempio, @samp{\$}
+individua il carattere @samp{$}.
+
address@hidden espressioni regolari, ancore nelle
address@hidden Texinfo, inizi di capitolo nei file
address@hidden @code{^} (circonflesso), operatore @dfn{regexp}
address@hidden circonflesso (@code{^}), operatore @dfn{regexp}
address@hidden @code{^}
+Si usa per indicare l'inizio di una stringa. Per esempio, @samp{^@@chapter}
+individua @samp{@@chapter} all'inizio di una stringa e si address@hidden usare
per
+identificare inizi di capitoli in file sorgenti Texinfo.
+Il simbolo @samp{^} @`e conosciuto come @address@hidden, perch@'e @`ancora la
ricerca
+solo all'inizio della stringa.
+
address@hidden importante notare che @samp{^} non individua un inizio di riga
+(il punto subito dopo un ritorno a capo @samp{\n}) che si trovi all'interno
+di una stringa. La condizione non @`e verificata nell'esempio seguente:
+
address@hidden
+if ("riga1\nRIGA 2" ~ /^R/) @dots{}
address@hidden example
+
address@hidden @code{$} (dollaro), operatore @dfn{regexp}
address@hidden dollaro (@code{$}), operatore @dfn{regexp}
address@hidden @code{$}
+Simile a @samp{^}, ma serve a indicare la fine di una stringa.
+Per esempio, @samp{p$}
+individua un record che termina con la lettera @samp{p}. Il @samp{$} @`e
+un'@`ancora e non individua una fine di riga (il punto immediatamente prima
+di un carattere di ritorno a capo @samp{\n})
+contenuta in una stringa.
+La condizione nell'esempio seguente non @`e verificata:
+
address@hidden
+if ("riga1\nRIGA 2" ~ /1$/) @dots{}
address@hidden example
+
address@hidden @code{.} (punto), operatore @dfn{regexp}
address@hidden punto (@code{.}), operatore @dfn{regexp}
address@hidden @code{.} (punto)
+Individua un qualsiasi carattere,
address@hidden il carattere di ritorno a capo. Per esempio, @samp{.P}
+individua ogni carattere in una stringa che sia seguito da una @samp{P}.
+Usando la concatenazione, si address@hidden formare un'espressione regolare
come
address@hidden, che individua qualsiasi sequenza di tre caratteri che inizia con
address@hidden e finisce con @samp{A}.
+
address@hidden POSIX @command{awk}, uso del punto (@code{.})
+In address@hidden POSIX stretta (@pxref{Opzioni}),
address@hidden non individua il carattere @sc{nul},
+ossia il carattere con tutti i bit uguali a zero.
+In altri contesti, @sc{nul} @`e solo un carattere qualsiasi. Altre versioni
+di @command{awk} possono non essere in grado di individuare il carattere
address@hidden
+
address@hidden @code{[]} (parentesi quadre), operatore @dfn{regexp}
address@hidden parentesi quadre (@code{[]}), operatore @dfn{regexp}
address@hidden espressioni tra parentesi
address@hidden insiemi di caratteri, si veda anche espressioni tra parentesi
quadre
address@hidden liste di caratteri, si veda espressioni tra parentesi quadre
address@hidden classi di caratteri, si veda espressioni tra parentesi quadre
address@hidden @address@hidden@code{]}
+Questa @`e chiamata una @dfn{espressione tra parentesi address@hidden
+altri testi, un'espressione tra parentesi quadre potrebbe essere
+definita come @dfn{insieme di caratteri}, @dfn{classe di caratteri} o
+ @dfn{lista di caratteri}.}
+Individua @emph{uno} qualsiasi dei caratteri racchiusi tra
+parentesi quadre. Per esempio, @samp{[MVX]} individua uno qualsiasi
+dei caratteri @samp{M}, @samp{V}, o @samp{X} in una stringa. Una spiegazione
+esauriente di quel che si address@hidden mettere all'interno di un'espressione
tra
+parentesi quadre @`e data in
address@hidden tra parentesi quadre}.
+
address@hidden espressioni tra parentesi quadre, complementate
address@hidden @address@hidden@code{]}
+Questa @`e una @dfn{espressione tra parentesi quadre complementata}. Il primo
+carattere dopo la @samp{[} @emph{deve} essere un @samp{^}. Individua
+qualsiasi carattere
address@hidden quelli tra parentesi quadre. Per esempio, @samp{[^awk]}
+individua qualsiasi carattere che non sia una @samp{a}, @samp{w}, o @samp{k}.
+
address@hidden @code{|} (barra verticale)
address@hidden barra verticale (@code{|})
address@hidden @code{|}
+Questo @`e un @dfn{operatore alternativa} ed @`e usato per specificare delle
+alternative. La @samp{|} ha la precedenza address@hidden bassa tra tutti gli
operatori
+di espressioni regolari. Per esempio, @samp{^P|[aeiouy]} individua tutte le
+stringhe corrispondenti a @samp{^P} oppure a @samp{[aeiouy]}. address@hidden
significa
+che individua qualsiasi stringa che inizi con @samp{P} o contenga (in
+qualsiasi posizione al suo interno) una vocale inglese minuscola.
+
+L'alternativa si applica alle @dfn{regexp} address@hidden ampie individuabili
in ogni
+lato.
+
address@hidden @code{()} (parentesi), operatore @dfn{regexp}
address@hidden parentesi (@code{()}), operatore @dfn{regexp}
address@hidden @code{(address@hidden@code{)}
+Le parentesi sono usate per raggruppare, sia nelle espressioni regolari sia
+in quelle aritmetiche. Si possono usare per concatenare espressioni regolari
+che contengono l'operatore alternativa, @samp{|}. Per esempio,
address@hidden@@(samp|code)address@hidden@address@hidden individua sia
@samp{@@address@hidden@}} sia
address@hidden@@address@hidden@}}.
+(Queste sono sequenze in linguaggio Texinfo per controllare la formattazione.
+Il significato di @samp{+} @`e
+spiegato address@hidden avanti in questa lista.)
+
address@hidden @code{*} (asterisco), operatore @code{*}, come operatore
@dfn{regexp}
address@hidden asterisco (@code{*}), operatore @code{*}, come operatore
@dfn{regexp}
address@hidden @code{*}
+Questo simbolo richiede che la precedente espressione regolare sia
+ripetuta tante volte quanto serve per trovare una corrispondenza. Per
+esempio, @samp{ph*} applica il simbolo
address@hidden al carattere @samp{h} che lo precede immediatamente e ricerca
+corrispondenze costituite da una @samp{p} seguita da un numero qualsiasi di
address@hidden Viene individuata anche solo la @samp{p}, se non ci sono
address@hidden
+
+Ci sono due sfumature da capire sul funzionamento di @samp{*}.
+Primo, @samp{*} tiene conto solo del singolo componente dell'espressione
+regolare che lo precede (p.es., in @samp{ph*} vale solo per @samp{h}).
+Per fare address@hidden@dotless{i}} che @samp{*} si applichi a una
sottoespressione address@hidden estesa,
+occorre metterla tra parentesi:
address@hidden(ph)*} individua @samp{ph}, @samp{phph}, @samp{phphph} e
address@hidden@dotless{i}} via.
+
+Secondo, @samp{*} trova quante address@hidden ripetizioni siano possibili. Se
il testo
+da ricercare @`e @samp{phhhhhhhhhhhhhhooey}, @samp{ph*} individua tutte le
address@hidden
+
address@hidden @code{+} (address@hidden), operatore @dfn{regexp}
address@hidden address@hidden (@code{+}), operatore @dfn{regexp}
address@hidden @code{+}
+Questo simbolo @`e simile a @samp{*}, tranne per il fatto che l'espressione
+precedente deve essere trovata almeno una volta. Questo significa che
address@hidden individuerebbe @samp{why} e @samp{whhy}, ma non @samp{wy}, mentre
address@hidden li troverebbe tutti e tre.
+
address@hidden @code{?} (punto interrogativo), operatore @dfn{regexp}
address@hidden punto interrogativo (@code{?}), operatore @dfn{regexp}
address@hidden @code{?}
+Questo simbolo @`e simile a @samp{*}, tranne per il fatto che l'espressione che
+precede address@hidden essere trovata una volta sola oppure non trovata
+affatto. Per esempio, @samp{fe?d}
+individua @samp{fed} e @samp{fd}, ma nient'altro.
+
address@hidden espressioni di intervallo, (@dfn{regexp})
address@hidden @address@hidden@address@hidden@}}
address@hidden @address@hidden@address@hidden,@}}
address@hidden @address@hidden@address@hidden,address@hidden@address@hidden
+Uno o due numeri tra parentesi graffe rappresentano una
address@hidden di intervallo}.
+Se c'@`e un numero tra graffe, la @dfn{regexp} precedente @`e ripetuta
address@hidden volte.
+Se ci sono due numeri separati da una virgola, la @dfn{regexp} precedente @`e
+ripetuta da @var{n} a @var{m} volte.
+Se c'@`e un numero seguito da una virgola, allora la @dfn{regexp} precedente
address@hidden ripetuta almeno @var{n} volte:
+
address@hidden @code
address@hidden address@hidden@}y
+Riconosce @samp{whhhy}, ma non @samp{why} o @samp{whhhhy}.
+
address@hidden address@hidden,address@hidden
+Riconosce soltanto @samp{whhhy}, @samp{whhhhy}, o @samp{whhhhhy}.
+
address@hidden address@hidden,@}y
+Riconosce @samp{whhy}, @samp{whhhy} e address@hidden@dotless{i}} via.
address@hidden table
+
address@hidden POSIX @command{awk}, espressioni di intervallo in
+Le espressioni di intervallo non erano tradizionalmente disponibili in
address@hidden Sono state aggiunte come parte dello standard POSIX per
+rendere @command{awk} ed @command{egrep} coerenti tra di loro.
+
address@hidden @command{gawk}, espressioni di intervallo e
+In passato, poich@'e vecchi programmi possono usare @address@hidden e
@address@hidden in
+costanti @dfn{regexp},
address@hidden @emph{non} riconosceva espressioni di intervallo
+nelle @dfn{regexp}.
+
+Comunque, a partire dalla @value{PVERSION} 4.0,
address@hidden riconosce espressioni di intervallo per default.
address@hidden accade perch@'e la address@hidden con POSIX @`e ritenuta
address@hidden
+importante da molti utenti @command{gawk} rispetto alla address@hidden con
+dei vecchi programmi.
+
+Per programmi che usano @address@hidden e @address@hidden in costanti
@dfn{regexp},
address@hidden buona pratica proteggerli sempre con una barra inversa. Allora
le
+costanti @dfn{regexp} sono valide e si comportano come desiderato, usando
+qualsiasi versione di @address@hidden@`E meglio usare due barre inverse
+se si sta usando una costante stringa con un operatore @dfn{regexp} o una
+funzione.}
+
+Infine, quando @address@hidden e @address@hidden appaiono in costanti
@dfn{regexp}
+in un modo non interpretabile come espressione di intervallo
+(come in @code{/address@hidden@}/}), allora sono prese letteralmente.
address@hidden table
+
address@hidden precedenza, operatore @dfn{regexp}
address@hidden espressioni regolari, operatori, precedenza di
+Nelle espressioni regolari, gli operatori @samp{*}, @samp{+}, e @samp{?},
+come pure le parentesi graffe @address@hidden e @address@hidden,
+hanno
+la precedenza address@hidden alta, seguiti dalla concatenazione, e infine da
@samp{|}.
+Come nell'algebra, le parentesi possono cambiare il raggruppamento degli
+operatori.
address@hidden POSIX @command{awk}, espressioni regolari e
address@hidden @command{gawk}, espressioni regolari, precedenza
+In POSIX @command{awk} e in @command{gawk}, gli operatori @samp{*},
address@hidden, e @samp{?} rappresentano se stessi quando non c'@`e nulla
+nella @dfn{regexp} che li precede. Per esempio, @code{/+/} individua un
+semplice segno address@hidden Comunque, molte altre versioni di @command{awk}
+trattano una simile notazione come un errore di sintassi.
+
+Se @command{gawk} @`e in address@hidden compatibile (@pxref{Opzioni}), le
espressioni
+di intervallo non si possono usare nelle espressioni regolari.
+
address@hidden Espressioni tra parentesi quadre
address@hidden Usare espressioni tra parentesi quadre
address@hidden espressioni tra parentesi quadre
address@hidden espressioni tra parentesi quadre, espressioni di intervallo
address@hidden espressioni di intervallo, (@dfn{regexp})
address@hidden elenchi di caratteri in un'espressione regolare
address@hidden caratteri, elenchi di, in un'espressione regolare
+
+Come detto sopra, un'espressione tra parentesi quadre individua qualsiasi
+carattere incluso tra le parentesi quadre aperta e chiusa.
+
+All'interno di un'espressione tra parentesi quadre, una
address@hidden di intervallo} @`e formata da due caratteri separati da un
+trattino. Individua ogni singolo carattere compreso tra i due caratteri,
+ordinati secondo l'insieme di caratteri in uso nel sistema. Per esempio,
address@hidden @`e equivalente a @samp{[0123456789]}.
+(Si veda @ref{Intervalli e localizzazione} per una spiegazione di come
+lo standard POSIX e @command{gawk} sono cambiati nel corso degli anni.
+La cosa ha un interesse principalmente storico.)
+
+Con la crescente address@hidden dello
address@hidden://www.unicode.org, standard di caratteri Unicode},
+c'@`e un'ulteriore dettaglio da tenere in conto. Le sequenze di
+protezione ottali ed esadecimali utilizzabili per inserire
+valori all'interno di espressioni tra parentesi quadre
+sono considerate contenere solo caratteri
+che occupano un unico byte (caratteri il cui valore stia
+nell'intervallo 0--256). Per individuare un intervallo di
+caratteri in cui i punti di inizio e fine dell'intervello
+abbiano valori maggiori di 256, occorre immettere direttamente
+le codifiche multi-byte dei caratteri in questione.
+
address@hidden @code{\} (barra inversa), in espressioni tra parentesi quadre
address@hidden barra inversa (@code{\}), in espressioni tra parentesi quadre
address@hidden @code{^} (circonflesso), in espressioni tra parentesi quadre
address@hidden circonflesso (@code{^}), in espressioni tra parentesi quadre
address@hidden @code{-} (meno), in espressioni tra parentesi quadre
address@hidden meno (@code{-}), in espressioni tra parentesi quadre
+Per includere uno dei caratteri @samp{\}, @samp{]}, @samp{-}, o @samp{^} in
+un'espressione tra parentesi quadre, occorre inserire un @samp{\} prima del
+carattere stesso. Per esempio:
+
address@hidden
+[d\]]
address@hidden example
+
address@hidden
+individua sia @samp{d} che @samp{]}.
+Inoltre, se si mette una @samp{]} subito dopo la
address@hidden aperta, la parentesi quadra chiusa @`e considerata come uno dei
+caratteri da individuare.
+
address@hidden POSIX @command{awk}, espressioni tra parentesi quadre e
address@hidden espressioni regolari estese (ERE)
address@hidden ERE (espressioni regolari estese)
address@hidden @command{egrep}, programma di address@hidden
address@hidden programma di address@hidden @command{egrep}
+L'utilizzo di @samp{\} nelle espressioni tra parentesi quadre
address@hidden compatibile con altre implementazioni di @command{awk} ed @`e
anche richiesto
+da POSIX.
+Le espressioni regolari in @command{awk} sono un insieme address@hidden esteso
delle
+specificazioni POSIX per le espressioni regolari estese (ERE).
+Le ERE POSIX sono basate sulle espressioni regolari accettate dal
+tradizionale programma di address@hidden @command{egrep}.
+
address@hidden espressioni tra parentesi quadre, classi di caratteri
address@hidden POSIX @command{awk}, espressioni tra parentesi quadre e, classi
di caratteri
+Le @dfn{classi di caratteri} sono una address@hidden introdotta nello standard
+POSIX. Una classe di caratteri @`e una particolare notazione per descrivere
+liste di caratteri cha hanno un attributo specifico, ma i caratteri
+veri e propri possono variare da paese a paese e/o
+da insieme di caratteri a insieme di caratteri. Per esempio, la nozione di
+cosa sia un carattere alfabetico @`e diversa tra gli Stati Uniti e la Francia.
+
+Una classe di caratteri @`e valida solo in una @dfn{regexp} @emph{contenuta}
+tra le parentesi quadre di un'espressione tra parentesi quadre. Le classi di
+caratteri consistono di @samp{[:},
+una parola chiave che segnala la classe, e @samp{:]}. La
address@hidden elenca le classi di caratteri definite dallo
+standard POSIX.
+
address@hidden Tabella,tabella-caratteri-classe
address@hidden di caratteri POSIX}
address@hidden @columnfractions .15 .85
address@hidden Classe @tab Significato
address@hidden @code{[:alnum:]} @tab Caratteri alfanumerici.
address@hidden @code{[:alpha:]} @tab Caratteri alfabetici.
address@hidden @code{[:blank:]} @tab Caratteri spazio e TAB.
address@hidden @code{[:cntrl:]} @tab Caratteri di controllo.
address@hidden @code{[:digit:]} @tab Caratteri numerici.
address@hidden @code{[:graph:]} @tab Caratteri che sono stampabili e visibili.
+(Uno @dfn{spazio} @`e stampabile ma non visibile, mentre una @samp{a} @`e
l'uno e
+l'altro.)
address@hidden @code{[:lower:]} @tab Caratteri alfabetici minuscoli.
address@hidden @code{[:print:]} @tab Caratteri stampabili (caratteri che non
sono
+caratteri di controllo).
address@hidden @code{[:punct:]} @tab Caratteri di punteggiatura (caratteri che
non
+sono lettere, cifre, caratteri di controllo, o caratteri di spazio).
address@hidden @code{[:space:]} @tab Caratteri di spazio (come @dfn{spazio},
TAB, e
address@hidden, per citarne alcuni).
address@hidden @code{[:upper:]} @tab Caratteri alfabetici maiuscoli.
address@hidden @code{[:xdigit:]} @tab Caratteri che sono cifre esadecimali.
address@hidden multitable
address@hidden float
+
+Per esempio, prima dello standard POSIX, si doveva scrivere
address@hidden/[A-Za-z0-9]/} per individuare i
+caratteri alfanumerici. Se l'insieme
+di caratteri in uso comprendeva altri caratteri alfabetici, l'espressione
+non li avrebbe individuati.
+Con le classi di caratteri POSIX si address@hidden scrivere
address@hidden/[[:alnum:]]/} per designare i caratteri alfabetici e numerici
+dell'insieme di caratteri in uso.
+
address@hidden Thanks to
address@hidden Date: Tue, 01 Jul 2014 07:39:51 +0200
address@hidden From: Hermann Peifer <address@hidden>
+Alcuni programmi di address@hidden che cercano espressioni regolari prevedono
+una classe di caratteri, non standard,
address@hidden:ascii:]}; @command{awk} non la prevede. Tuttavia, @`e possibile
ottenere
+lo stesso risultato utilizzando @samp{[\x00-\x7F]}. Quest'espressione
+individua tutti i valori numerici tra zero e 127, che @`e l'intervallo definito
+dell'insieme di caratteri ASCII. Usando una lista di caratteri che esclude
+(@samp{[^\x00-\x7F]}) si individuano tutti i caratteri mono-byte che non
+sono nell'intervallo ASCII.
+
address@hidden espressioni tra parentesi quadre, elementi di collazione
address@hidden espressioni tra parentesi quadre, non-ASCII
address@hidden elementi di collazione
+In espressioni tra parentesi quadre possono apparire due ulteriori sequenze
+speciali. Riguardano insiemi di caratteri non-ASCII, che possono avere
+simboli singoli (chiamati @dfn{elementi di collazione}) che sono rappresentati
+con address@hidden di un carattere. Possono designare anche parecchi
caratteri che sono
+equivalenti tra loro ai fini della @dfn{collazione}, o dell'ordinamento.
+(Per esempio, in francese, la semplice ``e'' e la sua versione con accento
grave address@hidden''
+sono equivalenti). Queste sequenze sono:
+
address@hidden @asis
address@hidden espressioni tra parentesi quadre, elementi di collazione
address@hidden elementi di collazione
address@hidden elementi di collazione
+Elementi di collazione multi-byte racchiusi fra
address@hidden e @samp{.]}. Per esempio, se @samp{ch} @`e un elemento di
collazione,
address@hidden @`e una @dfn{regexp} che individua questo elemento di
+collazione, mentre @samp{[ch]} @`e una @dfn{regexp} che individua le lettere
address@hidden o @samp{h}.
+
address@hidden espressioni tra parentesi quadre, classi di equivalenza
address@hidden classi di equivalenza
+Sono nomi, specifici a una particolare localizzazione, per una lista di
+caratteri equivalenti tra loro. Il nome @`e racchiuso fra
address@hidden e @samp{=]}.
+Per esempio, il nome @samp{e} potrebbe essere usato per designare
+``e'', address@hidden'', address@hidden'', e ``@'e''. In questo caso,
@samp{[[=e=]]} @`e una @dfn{regexp}
+che corrisponde a @samp{e}, @address@hidden, @address@hidden e @samp{@'e}.
address@hidden table
+
+Queste address@hidden sono molto utili in localizzazioni non inglesi.
+
address@hidden internazionalizzazione, localizzazione, classi di caratteri
address@hidden @command{gawk}, classi di caratteri e
address@hidden POSIX @command{awk}, espressioni tra parentesi quadre e, classi
di caratteri
address@hidden ATTENZIONE
+Le funzioni di libreria che @command{gawk} usa per individuare le espressioni
+regolari per ora riconoscono solo le classi di caratteri POSIX;
+non riconoscono simboli di collazione o classi di equivalenza.
address@hidden quotation
address@hidden maybe one day ...
+
+In un'espressione tra parentesi quadre, una parentesi aperta (@samp{[})
+che non costituisca l'inizio della specificazione di una classe di
+caratteri, di simboli di collazione o di una classe di equivalenza
address@hidden interpretata letteralmente. Questo vale anche per @samp{.} e
@samp{*}.
+
address@hidden address@hidden lungo da sinistra
address@hidden Quanto @`e lungo il testo individuato?
+
address@hidden espressioni regolari, corrispondenza address@hidden a sinistra
address@hidden @cindex matching, leftmost longest
+Si consideri il caso seguente:
+
address@hidden
+echo aaaabcd | awk '@{ sub(/a+/, "<A>"); print @}'
address@hidden example
+
+Questo esempio usa la funzione @code{sub()} per modificare il record in input.
+(@code{sub()} sostituisce la prima ricorrenza in ogni testo individuato dal
+primo argomento con la stringa fornita come secondo argomento;
address@hidden per stringhe}.) Qui, la @dfn{regexp} @code{/a+/} richiede
+``uno o address@hidden caratteri @samp{a},'' e il testo da sostituire @`e
@samp{<A>}.
+
+L'input contiene quattro caratteri @samp{a}.
+Le espressioni regolari @command{awk} (e POSIX) individuano sempre
+la sequenza @address@hidden lunga}, partendo da sinistra, di caratteri in
input che
+corrispondono. Quindi, tutti e quattro i caratteri @samp{a} sono
+rimpiazzati con @samp{<A>} in questo esempio:
+
address@hidden
+$ @kbd{echo aaaabcd | awk '@{ sub(/a+/, "<A>"); print @}'}
address@hidden <A>bcd
address@hidden example
+
+Per semplici test corrisponde/non corrisponde, la cosa ha poca importanza.
+Ma se si sta controllando un testo o si fanno sostituzioni usando le funzioni
address@hidden()}, @code{sub()}, @code{gsub()} e @code{gensub()},
address@hidden invece molto importante.
address@hidden
address@hidden per stringhe},
+Per maggiori informazioni su queste funzioni.
address@hidden ifinfo
+Tenere in conto questo principio @`e importante anche quando si suddividono
+record e campi usando delle @dfn{regexp} (@pxref{Record},
+e anche @pxref{Separatori di campo}).
+
address@hidden Espressioni regolari calcolate
address@hidden Usare @dfn{regexp} dinamiche
+
address@hidden espressioni regolari calcolate
address@hidden espressioni regolari dinamiche
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @cindex operators, @code{~}
address@hidden @cindex operators, @code{!~}
+L'espressione a destra di un operatore @samp{~} o @samp{!~} non deve
+necessariamente essere una costante @dfn{regexp} (address@hidden, una stringa
di
+caratteri tra barre). address@hidden essere una qualsiasi
+espressione. L'espressione @`e valutata e convertita in una stringa
+se necessario; il contenuto della stringa @`e poi usato come una @dfn{regexp}.
+Una @dfn{regexp} calcolata in questo modo @`e detta una @dfn{regexp dinamica}
+o una @dfn{regexp calcolata}:
+
address@hidden
+BEGIN @{ @dfn{regexp}_numerica = "[[:digit:]]+" @}
+$0 ~ @dfn{regexp}_numerica @{ print @}
address@hidden example
+
address@hidden
+Questo @dfn{script} imposta @code{regexp_numerica} come una @dfn{regexp} che
+descrive una o address@hidden cifre, e poi controlla se un record in input
corrisponde a
+questa regexp.
+
address@hidden NOTA
+Usando gli operatori @samp{~} e @samp{!~}, si tenga presente che c'@`e
+una differenza tra una costante @dfn{regexp} racchiusa tra barre e una
+costante stringa racchiusa tra doppi apici.
+Se si intende utilizzare una costante stringa, occorre comprendere che
+la stringa @`e, in sostanza, scandita @emph{due volte}: la prima volta quando
address@hidden legge il programma, e la seconda volta quando va a
+confrontare la stringa a sinistra dell'operatore con il modello che sta
+alla sua destra. Questo vale per ogni espressione (come la
address@hidden, vista nel precedente esempio), non solo per le
+costanti stringa.
address@hidden quotation
+
address@hidden costanti @dfn{regexp}, barre vs.@: doppi apici
address@hidden @code{\} (barra inversa), in costanti @dfn{regexp}
address@hidden barra inversa (@code{\}), in costanti @dfn{regexp}
address@hidden @code{"} (doppio apice), in costanti @dfn{regexp}
address@hidden doppio apice (@code{"}), in costanti @dfn{regexp}
+Che differenza fa la doppia scansione di una stringa?
+La risposta ha a che vedere con le sequenze di protezione e particolarmente
+con le barre inverse. Per inserire una barra inversa in un'espressione
+regolare all'interno di una stringa, occorre inserire @emph{due} barre
+inverse.
+
+Per esempio, @code{/\*/} @`e una costante @dfn{regexp} per designare un
@samp{*}
+letterale.
address@hidden richiesta una sola barra inversa. Per fare lo stesso con una
stringa,
+occorre immettere @code{"\\*"}. La prima barra inversa protegge la
+seconda in modo che la stringa in address@hidden contenga i
+due caratteri @samp{\} e @samp{*}.
+
address@hidden risoluzione di problemi, costanti @dfn{regexp} vs.@: costanti
stringa
address@hidden problemi, risoluzione di, costanti @dfn{regexp} vs.@: costanti
stringa
address@hidden costanti @dfn{regexp}, vs.@: costanti stringa
address@hidden costanti stringa, vs.@: costanti @dfn{regexp}
+Dato che si possono usare sia costanti @dfn{regexp} che costanti stringa per
+descrivere espressioni regolari, qual @`e da preferire? La risposta @`e
+``costanti @dfn{regexp}'', per molti motivi:
+
address@hidden @value{BULLET}
address@hidden
+Le costanti stringa sono address@hidden complicate da scrivere e
address@hidden difficili
+da leggere. Usare costanti @dfn{regexp} rende i programmi
+meno inclini all'errore. Non comprendere la differenza tra i due tipi di
+costanti @`e una fonte frequente di errori.
+
address@hidden
address@hidden address@hidden efficiente usare costanti @dfn{regexp}.
@command{awk} address@hidden accorgersi
+che @`e stata fornita una @dfn{regexp} e memorizzarla internamente in una forma
+che rende la ricerca di corrispondenze address@hidden efficiente. Se si usa
una costante
+stringa, @command{awk} deve prima convertire la stringa nel suo formato
+interno e quindi eseguire la ricerca di corrispondenze.
+
address@hidden
+Usare costanti @dfn{regexp} @`e la forma migliore; lascia comprendere
+chiaramente che si vuole una corrispondenza con una @dfn{regexp}.
address@hidden itemize
+
address@hidden Usare @code{\n} in espressioni tra parentesi quadre in
@dfn{regexp} dinamiche
address@hidden espressioni regolari dinamiche, contenenti dei ritorni a capo
address@hidden ritorno a capo, in @dfn{regexp} dinamiche
+
+Alcune delle prime versioni di @command{awk} non consentono di usare il
+carattere di ritorno
+a capo all'interno di un'espressione tra parentesi quadre in @dfn{regexp}
+dinamiche:
+
address@hidden
+$ @kbd{awk '$0 ~ "[ \t\n]"'}
address@hidden awk: newline in character class [
address@hidden ]...
address@hidden source line number 1
address@hidden context is
address@hidden $0 ~ "[ >>> \t\n]" <<<
address@hidden example
+
address@hidden ritorno a capo, in costanti @dfn{regexp}
+Ma un ritorno a capo in una costante @dfn{regexp} non address@hidden alcun
problema:
+
address@hidden
+$ @kbd{awk '$0 ~ /[ \t\n]/'}
address@hidden una riga di esempio}
address@hidden ecco una riga di esempio
address@hidden
address@hidden example
+
address@hidden non ha questo problema, e non dovrebbe accadere spesso
+in pratica, ma val la pena di notarlo a futura memoria.
address@hidden sidebar
+
address@hidden Operatori di @dfn{regexp} GNU
address@hidden Operatori @dfn{regexp} propri di @command{gawk}
+
address@hidden This section adapted (long ago) from the regex-0.12 manual
+
address@hidden espressioni regolari, operatori, @command{gawk}
address@hidden @command{gawk}, espressioni regolari, operatori
address@hidden operatori, specifici per GNU
address@hidden espressioni regolari, operatori, per parole
address@hidden parola, definizione in @dfn{regexp}
+Il software GNU che ha a che fare con espressioni regolari comprende alcuni
+operatori @dfn{regexp} aggiuntivi. Questi
+operatori sono descritti in
address@hidden
+questa
address@hidden ifnotinfo
address@hidden
+questo
address@hidden ifinfo
address@hidden e sono specificamente
+per @command{gawk}; non sono disponibili in altre implementazioni di
address@hidden
+La maggior parte degli operatori aggiuntivi riguarda l'identificazione di
+parole. Ai nostri fini, una @dfn{parola} @`e una sequenza di uno o
address@hidden lettere,
+cifre, o trattini bassi (@samp{_}):
+
address@hidden @code
address@hidden @cindex operatori, @code{\s} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\s}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\s}, operatore (@command{gawk})
address@hidden \s
+Corrisponde a ogni carattere bianco.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[[:space:]]}}.
+
address@hidden @cindex operatori, @code{\S} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\S}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\S}, operatore (@command{gawk})
address@hidden \S
+Corrisponde a ogni carattere che non @`e uno spazio bianco.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[^[:space:]]}}.
+
address@hidden @cindex operatori, @code{\w} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\w}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\w}, operatore (@command{gawk})
address@hidden \w
+Corrisponde a ogni carattere che componga una parola; ovvero, corrisponde a
+ogni lettera, cifra, o trattino basso.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[[:alnum:]_]}}.
+
address@hidden @cindex operatori, @code{\W} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\W}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\W}, operatore (@command{gawk})
address@hidden \W
+Corrisponde a ogni carattere che non @`e parte di una parola.
+Lo si address@hidden pensare come un'abbreviazione di
address@hidden@samp{[^[:alnum:]_]}}.
+
address@hidden @cindex operatori, @code{\<} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\<}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\<}, operatore (@command{gawk})
address@hidden \<
+Individua la stringa nulla all'inizio di una parola.
+Per esempio, @code{/\<via/} individua @samp{via} ma non
address@hidden
+
address@hidden @cindex operatori, @code{\>} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\>}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\>}, operatore (@command{gawk})
address@hidden \>
+Individua la stringa nulla alla fine di una parola.
+Per esempio, @code{/via\>/} individua @samp{via} ma non @samp{viadotto}.
+
address@hidden @cindex operatori, @code{\y} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\y}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\y}, operatore (@command{gawk})
address@hidden limite-di-parola, individuare il
address@hidden \y
+Individua la stringa nulla o alla fine o all'inizio di una parola.
+(address@hidden, il limite di una parola - @address@hidden in inglese).
+Per esempio, @samp{\yradar?\y}
+individua sia @samp{rada} che @samp{radar}, come parole separate.
+
address@hidden @cindex operatori, @code{\B} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\B}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\B}, operatore (@command{gawk})
address@hidden \B
+Individua la stringa nulla che ricorre all'interno di una parola.
+Per esempio,
address@hidden/\Bora\B/} individua @samp{Colorado}, ma non individua @samp{che
ora @`e}.
address@hidden @`e essenzialmente l'opposto di @samp{\y}.
address@hidden table
+
address@hidden buffer, operatori per
address@hidden espressioni regolari, operatori, per buffer
address@hidden operatori, ricerca in stringhe, per buffer
+Ci sono due altri operatori che operano sui buffer. In Emacs un
address@hidden @`e, naturalmente, un buffer di Emacs. In altri programmi GNU,
+fra cui @command{gawk}, le routine di libreria delle @dfn{regexp} considerano
+come buffer l'intera stringa su cui effettuare il confronto.
+Gli operatori sono:
+
address@hidden @code
address@hidden \`
address@hidden @cindex operatori, @code{\`} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\`}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\`}, operatore (@command{gawk})
+Individua la stringa nulla che occorre all'inizio di un buffer
+(di una stringa)
+
address@hidden @cindex operatori, @code{\'} (@command{gawk})
address@hidden barra inversa (@code{\}), @code{\'}, operatore (@command{gawk})
address@hidden @code{\} (barra inversa), @code{\'}, operatore (@command{gawk})
address@hidden \'
+Individua la stringa nulla che occorre alla fine di un buffer
+(di una stringa)
address@hidden table
+
address@hidden @code{^} (circonflesso), operatore @dfn{regexp}
address@hidden circonflesso (@code{^}), operatore @dfn{regexp}
address@hidden @code{?} (punto interrogativo), operatore @dfn{regexp}
address@hidden punto interrogativo (@code{?}), operatore @dfn{regexp}
+Poich@'e @samp{^} e @samp{$} si riferiscono sempre all'inizio e alla
+fine di stringhe, questi operatori non aggiungono nuove address@hidden
+ad @command{awk}. Sono inclusi per address@hidden con altro
+software GNU.
+
address@hidden @command{gawk}, operatore limite-di-parola
address@hidden limite-di-parola, operatore (@command{gawk})
address@hidden operatori, limite-di-parola (@command{gawk})
+In altro software GNU, l'operatore di limite-di-parola @`e @samp{\b}. Questo,
+comunque, @`e in conflitto con la definizione, nel linguaggio @command{awk},
+di @samp{\b} come
+backspace, quindi @command{gawk} usa una lettera differente.
+Un metodo alternativo sarebbe stato di richiedere due barre inverse negli
+operatori GNU, ma questo @`e stato ritenuto troppo arzigogolato. Il metodo
+corrente di usare @samp{\y} al posto del @samp{\b} di GNU sembra essere
+il male minore.
+
address@hidden espressioni regolari, @command{gawk}, opzioni sulla riga di
comando
address@hidden @command{gawk}, opzioni sulla riga di comando, ed espressioni
regolari
+Le varie opzioni sulla riga di comando
+(@pxref{Opzioni})
+controllano come @command{gawk} interpreta i caratteri nelle @dfn{regexp}:
+
address@hidden @asis
address@hidden Nessuna opzione
+Per default, @command{gawk} fornisce tutte le address@hidden delle
+regexp POSIX e gli
+operatori @dfn{regexp} GNU
address@hidden
+predecentemente descritti.
address@hidden ifnotinfo
address@hidden
address@hidden
+Sono descritti
+in @ref{Operatori di espressioni regolari}.
address@hidden ifnotdocbook
address@hidden ifnottex
+
address@hidden @code{--posix}
+Sono ammesse solo le @dfn{regexp} POSIX; gli operatori GNU non sono
+speciali (p.es., @samp{\w} individua una semplice lettera @samp{w}).
+Le espressioni di intervallo sono ammesse.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden @code{--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.
+I caratteri descritti usando sequenze di protezione ottali ed esadecimali sono
+trattati letteralmente, anche se rappresentano metacaratteri di @dfn{regexp}.
+
address@hidden @code{--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.
address@hidden table
+
address@hidden Maiuscolo-Minuscolo
address@hidden Fare confronti ignorando maiuscolo/minuscolo
+
address@hidden espressioni regolari, maiuscolo/minuscolo
address@hidden @dfn{regexp}, maiuscolo/minuscolo
address@hidden maiuscolo/minuscolo e @dfn{regexp}
+Il tipo di carattere (maiuscolo/minuscolo) @`e normalmente rilevante nelle
+espressioni regolari, sia nella ricerca di
+caratteri normali (address@hidden, non metacaratteri), sia all'interno di
espressioni
+fra parentesi. Quindi, una @samp{w} in un'espressione regolare individua
+solo una @samp{w} e non la corrispondente maiuscola @samp{W}.
+
+Il modo address@hidden semplice per richiedere una ricerca non sensibile al
+maiuscolo/minuscolo @`e di usare un'espressione tra parentesi quadre, per
+esempio @samp{[Ww]}. Comunque, questo address@hidden essere pesante se si usa
spesso,
+e address@hidden rendere le espressioni regolari di difficile lettura.
+Ci sono due alternative che potrebbero essere preferibili.
+
+Un modo per fare un confronto non sensibile a maiuscolo/minuscolo in un
+particolare punto del programma
address@hidden di convertire i dati in un solo tipo (o minuscole o maiuscole),
+usando le funzioni di stringa
+predefinite @code{tolower()} o @code{toupper()} (che non
+abbiamo ancora introdotto;
address@hidden per stringhe}).
+Per esempio:
+
address@hidden
+tolower($1) ~ /foo/ @{ @dots{} @}
address@hidden example
+
address@hidden
+converte il primo campo in minuscole, prima di fare un confronto.
+Questo funziona in ogni @command{awk} conforme allo standard POSIX.
+
address@hidden @command{gawk}, espressioni regolari, differenza
maiuscolo/minuscolo
address@hidden distinzione maiuscolo/minuscolo, @command{gawk}
address@hidden differenze tra @command{awk} e @command{gawk}, espressioni
regolari
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @code{IGNORECASE}, variabile, con operatori @code{~} e @code{!~}
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden @cindex variables, @code{IGNORECASE}
+Un altro metodo, proprio di @command{gawk}, @`e di impostare la variabile
address@hidden a un valore diverso da zero (@pxref{Variabili predefinite}).
+Quando @code{IGNORECASE} @`e diverso da zero, @emph{tutte} le operazioni con
+regexp e stringhe ignorano la distinzione maiuscolo/minuscolo.
+
+Il cambio del valore di @code{IGNORECASE} controlla dinamicamente la
address@hidden a maiuscolo/minuscolo del programma quando @`e in esecuzione.
+Il tipo di carattere (maiuscolo/minuscolo) @`e rilevante per default,
+poich@'e @code{IGNORECASE} (come la maggior parte delle variabili) @`e
+inizializzata a zero:
+
address@hidden
+x = "aB"
+if (x ~ /ab/) @dots{} # questo test non address@hidden verificato
+
+IGNORECASE = 1
+if (x ~ /ab/) @dots{} # adesso address@hidden verificato
address@hidden example
+
+In generale, non @`e possibile usare @code{IGNORECASE} per rendere certe regole
+non sensibili a maiuscolo/minuscolo e altre regole invece
address@hidden@dotless{i}}, perch@'e non c'@`e
+una maniera diretta per impostare
address@hidden solo per l'espressione di
+una particolare address@hidden esperti in C e C++ noteranno
+che questo @`e possible, usando qualcosa come
address@hidden = 1 && /foObAr/ @{ @dots{} @}}
+e
address@hidden = 0 || /foobar/ @{ @dots{} @}}.
+Comunque, questo @`e un po' tortuoso e non @`e raccomandato.}
+Per fare questo, si usino espressioni tra parentesi quadre oppure
address@hidden()}. Comunque, una cosa che si address@hidden fare con
@code{IGNORECASE}
+soltanto @`e di utilizzare o di ignorare la address@hidden a
maiuscolo/minuscolo
+per tutte le regole contemporaneamente.
+
address@hidden @`e impostabile dalla riga di comando o in una regola
address@hidden (@pxref{Altri argomenti}; e
address@hidden BEGIN/END}).
+Impostare @code{IGNORECASE} dalla riga di comando @`e un modo per rendere
+un programma insensibile a maiuscolo/minuscolo senza doverlo modificare.
+
address@hidden @cindex ISO 8859-1
address@hidden @cindex ISO Latin-1
+In localizzazioni multibyte,
+le equivalenze tra caratteri maiuscoli
+e minuscoli sono controllate usando i valori in formato esteso
+dell'insieme di caratteri della localizzazione.
+Per il resto, i caratteri sono controllati usando l'insieme di caratteri
+ISO-8859-1 (ISO Latin-1).
+Questo insieme di caratteri @`e un'estensione del tradizionale insieme con 128
+caratteri ASCII, che include anche molti caratteri adatti
+per le lingue address@hidden questo sembra oscuro,
+non c'@`e ragione di preoccuparsi; significa solo che @command{gawk} fa
+la cosa giusta.}
+
+Il valore di @code{IGNORECASE} non ha effetto se @command{gawk} @`e in
address@hidden compatibile (@pxref{Opzioni}).
+Il tipo di carattere (maiuscolo o minuscolo) @`e sempre rilevante in
address@hidden
+compatibile.
+
address@hidden Sommario espressioni regolari
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Le espressioni regolari descrivono insiemi di stringhe da confrontare.
+In @command{awk}, le costanti @dfn{regexp} sono scritte racchiuse
+fra barre: @code{/address@hidden@code{/}.
+
address@hidden
+Le costanti @dfn{regexp} possono essere usate da sole in modelli di ricerca e
+in espressioni condizionali, o come parte di espressioni di ricerca
+usando gli operatori @samp{~} e @samp{!~}.
+
address@hidden
+Le sequenze di protezione consentono di rappresentare caratteri non stampabili
+e consentono anche di rappresentare metacaratteri @dfn{regexp} come caratteri
+letterali per i quali cercare corrispondenze.
+
address@hidden
+Gli operatori @dfn{regexp} consentono raggruppamento, alternativa e
+ripetizione.
+
address@hidden
+Le espressioni tra parentesi quadre sono delle notazioni abbreviate per
+specificare insiemi di caratteri che possono avere corrispondenze in un
+punto particolare di una @dfn{regexp}.
+All'interno di espressioni tra parentesi quadre, le classi di caratteri POSIX
+consentono di specificare certi gruppi di caratteri in maniera indipendente
+dalla localizzazione.
+
address@hidden
+Le espressioni regolari individuano il testo address@hidden lungo possibile, a
partire
+da sinistra nella stringa in esame. Questo ha importanza nei casi in cui
+serve conoscere la lunghezza della corrispondenza, come nella sostituzione di
+testo e quando il separatore di record sia una @dfn{regexp}.
+
address@hidden
+Espressioni di ricerca possono usare @dfn{regexp} dinamiche, ossia, i valori
+delle stringhe sono considerato come espressioni regolari.
+
address@hidden
+La variabile @command{gawk} @code{IGNORECASE} consente di controllare la
+differenza maiuscolo/minuscolo nel confronto mediante @dfn{regexp}. In altre
+versioni di @command{awk}, vanno usate invece le funzioni @code{tolower()} o
address@hidden()}.
+
address@hidden itemize
+
address@hidden Leggere file
address@hidden Leggere file in input
+
address@hidden leggere file in input
address@hidden file in input, leggere
address@hidden file in input
address@hidden @code{FILENAME}, variabile
address@hidden variabile @code{FILENAME}
+Nel tipico programma @command{awk},
address@hidden legge tutto l'input sia dallo standard input
+(per default @`e la tastiera, ma spesso @`e una @dfn{pipe} da un altro comando)
+o da file i cui nomi vengono specificati sulla riga di comando di
address@hidden Se si specificano file in input, @command{awk} li legge
+nell'ordine, elaborando tutti i dati di uno prima di passare al successivo.
+Il nome del file in input corrente si trova nella variabile predefinita
address@hidden
+(@pxref{Variabili predefinite}).
+
address@hidden record
address@hidden campi
+L'input @`e letto in address@hidden chiamate @dfn{record}, e viene elaborato,
secondo le
+regole del programma, un record alla volta.
+Per default, ogni record @`e una riga. Ogni
+record @`e suddiviso automaticamente in "pezzi" chiamati @dfn{campi}.
+Questo rende address@hidden pratico far lavorare i programmi sulle parti di un
record.
+
address@hidden @code{getline}, comando
+In rare occasioni, si potrebbe aver bisogno di usare il comando
address@hidden Il comando @code{getline} @`e utile sia perch@'e address@hidden
procurare
+un input esplicito da un numero indeterminato di file, sia perch@'e non vanno
+specificati sulla riga di comando di @command{awk} i nomi dei file usati con
+getline (@pxref{Getline}).
+
address@hidden
+* Record:: Controllare come i dati sono suddivisi
+ in record.
+* Campi:: Un'introduzione ai campi.
+* Campi non costanti:: Numeri di campo variabili.
+* Cambiare i campi:: Cambiare il contenuto di un campo.
+* Separatori di campo:: I separatori di campo, e come
+ cambiarli.
+* Dimensione costante:: Leggere campi di larghezza costante.
+* Separazione in base al contenuto:: Definire campi dal loro contenuto.
+* Righe multiple:: Leggere record che sono su address@hidden
righe.
+* Getline:: Leggere file sotto il controllo del
+ programma, usando la funzione
+ @code{getline}.
+* Timeout in lettura:: Leggere input entro un tempo limite.
+* Proseguire dopo errore in input:: Elaborare ulteriore input dopo certi
+ errori di I/O.
+* Directory su riga di comando:: Cosa succede mettendo una directory
+ sulla riga di comando.
+* Sommario di Input:: Sommario di Input.
+* Esercizi su Input:: Esercizi.
address@hidden menu
+
address@hidden Record
address@hidden Controllare come i dati sono suddivisi in record
+
address@hidden input, suddividere in record
address@hidden record, suddividere l'input in
address@hidden @code{NR}, variabile
address@hidden @code{FNR}, variabile
address@hidden suddivide l'input per il programma in record e campi.
+Tiene traccia del numero di record address@hidden letti dal
+file in input corrente. Questo valore @`e memorizzato in una variabile
+predefinita chiamata @code{FNR} che @`e reimpostata a zero ogni volta che si
+inizia un nuovo file. Un'altra variabile predefinita, @code{NR}, registra il
+numero totale di record in input address@hidden letti da tutti i @value{DF}.
+Il suo valore iniziale @`e zero ma non viene mai reimpostata a zero
+automaticamente.
+
address@hidden
+* awk divisione record:: Come @command{awk} standard divide i record.
+* gawk divisione record:: Come @command{gawk} divide i record.
address@hidden menu
+
address@hidden awk divisione record
address@hidden Come @command{awk} standard divide i record.
+
address@hidden separatori di record
address@hidden record, separatori di
+I record sono separati da un carattere chiamato @dfn{separatore di record}.
+Per default, il separatore di record @`e il carattere di ritorno a capo.
+Questo @`e il motivo per cui i record sono, per default, righe singole.
+Per usare un diverso carattere come separatore di record
+basta assegnare quel carattere alla variabile predefinita @code{RS}.
+
address@hidden ritorno a capo, come separatore di record
address@hidden a capo, come separatore di record
address@hidden @code{RS}, variabile
+Come per ogni altra variabile,
+il valore di @code{RS} address@hidden essere cambiato nel programma
@command{awk}
+con l'operatore di assegnamento, @samp{=}
+(@pxref{Operatori di assegnamento}).
+Il nuovo separatore di record dovrebbe essere racchiuso tra doppi apici,
+per indicare una costante di stringa. Spesso il momento giusto per far questo
address@hidden all'inizio dell'esecuzione, prima che sia elaborato qualsiasi
input,
+in modo che il primo record sia letto col separatore appropriato.
+Per far address@hidden, si usa il criterio speciale @code{BEGIN}
+(@pxref{BEGIN/END}).
+Per esempio:
+
address@hidden
+awk 'BEGIN @{ RS = "u" @}
+ @{ print $0 @}' mail-list
address@hidden example
+
address@hidden
+cambia il valore di @code{RS} in @samp{u}, prima di leggere qualsiasi input.
+Il nuovo valore @`e una stringa il cui primo carattere @`e la lettera ``u'';
come
+risultato, i record sono separati dalla lettera ``u''. Poi viene letto il
+file in input, e la seconda regola nel programma @command{awk} (l'azione
+eseguita se non si specifica un criterio)
+stampa ogni record. Poich@'e ogni istruzione @code{print} aggiunge
+un ritorno a capo alla fine del suo output, questo programma
address@hidden copia l'input con ogni @samp{u} trasformato in un ritorno
+a capo. Qui vediamo il risultato dell'esecuzione del programma sul file
address@hidden:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ RS = "u" @}}
+> @address@hidden print $0 @}' mail-list}
address@hidden Amelia 555-5553 amelia.zodiac
address@hidden sq
address@hidden e@@gmail.com F
address@hidden Anthony 555-3412 anthony.assert
address@hidden ro@@hotmail.com A
address@hidden Becky 555-7685 becky.algebrar
address@hidden m@@gmail.com A
address@hidden Bill 555-1675 bill.drowning@@hotmail.com A
address@hidden Broderick 555-0542 broderick.aliq
address@hidden otiens@@yahoo.com R
address@hidden Camilla 555-2912 camilla.inf
address@hidden sar
address@hidden m@@skynet.be R
address@hidden Fabi
address@hidden s 555-1234 fabi
address@hidden s.
address@hidden ndevicesim
address@hidden s@@
address@hidden cb.ed
address@hidden F
address@hidden J
address@hidden lie 555-6699 j
address@hidden lie.perscr
address@hidden tabor@@skeeve.com F
address@hidden Martin 555-6480 martin.codicib
address@hidden s@@hotmail.com A
address@hidden Sam
address@hidden el 555-3430 sam
address@hidden el.lanceolis@@sh
address@hidden .ed
address@hidden A
address@hidden Jean-Pa
address@hidden l 555-2127 jeanpa
address@hidden l.campanor
address@hidden m@@ny
address@hidden .ed
address@hidden R
address@hidden
address@hidden example
+
address@hidden
+Si noti che la voce relativa al nome @samp{Bill} non @`e divisa.
+Nel @value{DF} originale
+(@pxref{File dati di esempio}),
+la riga appare in questo modo:
+
address@hidden
+Bill 555-1675 bill.drowning@@hotmail.com A
address@hidden example
+
address@hidden
+Essa non contiene nessuna @samp{u}, per cui non c'@`e alcun motivo di dividere
+il record, diversamente dalle altre, che hanno una o address@hidden ricorrenze
della
address@hidden Infatti, questo record @`e trattato come parte del record
precedente;
+il ritorno a capo che li separa nell'output @`e l'originale ritorno a capo nel
address@hidden, non quella aggiunta da @command{awk} quando ha stampato il
record!
+
address@hidden separatori di record, cambiare i
address@hidden record, separatori di
+Un altro modo per cambiare il separatore di record @`e sulla riga di comando,
+usando la address@hidden dell'assegnamento di variabile
+(@pxref{Altri argomenti}):
+
address@hidden
+awk '@{ print $0 @}' RS="u" mail-list
address@hidden example
+
address@hidden
+Questo imposta @code{RS} a @samp{u} prima di elaborare @file{mail-list}.
+
+Usando un carattere alfabetico come @samp{u} come separatore di record
address@hidden molto probabile che si ottengano risultati strani.
+Usando un carattere insolito come @samp{/} @`e address@hidden probabile
+che si ottenga un comportamento corretto nella maggioranza dei casi, ma non
+c'@`e nessuna garanzia. La morale @`e: conosci i tuoi dati!
+
+Quando si usano caratteri normali come separatore di record,
+c'@`e un caso insolito che capita quando @command{gawk}
address@hidden reso completamente conforme a POSIX (@pxref{Opzioni}).
+In quel caso, la seguente (estrema) @dfn{pipeline} stampa un sorprendente
address@hidden:
+
address@hidden
+$ echo | gawk --posix 'BEGIN @{ RS = "a" @} ; @{ print NF @}'
address@hidden 1
address@hidden example
+
+C'@`e un solo campo, consistente in un ritorno a capo. Il valore della
+variabile predefinita @code{NF} @`e il numero di campi nel record corrente.
+(Normalmente @command{gawk} tratta il ritorno a capo come uno spazio
+vuoto, stampando @samp{0} come risultato. Anche molte altre versioni di
address@hidden agiscono in questo modo.)
+
address@hidden angolo buio, file in input
+Il raggiungimento della fine di un file in input fa terminare il record di
+input corrente, anche se l'ultimo carattere nel file non @`e il carattere in
address@hidden @value{DARKCORNER}
+
address@hidden stringhe vuote
address@hidden stringhe nulle
address@hidden @cindex strings, empty, see null strings
+La stringa nulla @code{""} (una stringa che non contiene alcun carattere)
+ha un significato particolare come
+valore di @code{RS}. Significa che i record sono separati
+soltanto da una o address@hidden righe vuote.
address@hidden multiple} per maggiori dettagli.
+
+Se si cambia il valore di @code{RS} nel mezzo di un'esecuzione di
address@hidden, il nuovo valore @`e usato per delimitare i record successivi, ma
+non riguarda il record in corso di elaborazione e neppure quelli address@hidden
+elaborati.
+
address@hidden @command{gawk}, variabile @code{RT} in
address@hidden @code{RT}, variabile
address@hidden record, fine dei
address@hidden differenze tra @command{awk} e @command{gawk}, separatori di
record
address@hidden espressioni regolari, come separatori di record
address@hidden record, separatori di, espressioni regolari come
address@hidden separatori di record, espressioni regolari come
+Dopo che @`e stata determinata la fine di un record, @command{gawk}
+imposta la variabile @code{RT} al testo nell'input che corrisponde a
address@hidden
+
address@hidden gawk divisione record
address@hidden Divisione dei record con @command{gawk}
+
address@hidden estensioni comuni, @code{RS} come espressione regolare
address@hidden comuni, address@hidden @code{RS} come espressione regolare
+Quando si usa @command{gawk},
+il valore di @code{RS} non @`e limitato a una stringa costituita da un solo
+carattere, ma address@hidden essere qualsiasi espressione regolare
address@hidden
+(@pxrefil{Espressioni regolari}). @value{COMMONEXT}
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}). @value{COMMONEXT}
address@hidden ifnottex
+In generale, ogni record termina alla stringa address@hidden vicina che
corrisponde
+all'espressione regolare; il record successivo inizia alla fine della stringa
+che corrisponde. Questa regola generale @`e in address@hidden applicata anche
nel caso
+normale, in cui @code{RS} contiene solo un ritorno a capo: un record
+termina all'inizio della prossima stringa che corrisponde (il prossimo
+ritorno a capo nell'input), e il record seguente inizia subito dopo la
+fine di questa stringa (al primo carattere della riga seguente).
+Il ritorno a capo, poich@'e corrisponde a @code{RS}, non appartiene a
+nessuno dei due record.
+
+Quando @code{RS} @`e un singolo carattere, @code{RT}
+contiene lo stesso singolo carattere. Peraltro, quando @code{RS} @`e
+un'espressione regolare, @code{RT} contiene l'effettivo testo in input
+corrispondente all'espressione regolare.
+
+Se il file in input termina senza che vi sia un testo che corrisponda a
address@hidden, @command{gawk} imposta @code{RT} alla stringa nulla.
+
+Il seguente esempio illustra entrambe queste caratteristiche.
+In quest'esempio @code{RS} @`e impostato a un'espressione regolare che
+cerca sia un ritorno a capo che una serie di una o address@hidden lettere
+maiuscole con uno spazio vuoto opzionale iniziale e/o finale:
+
address@hidden
+$ @kbd{echo record 1 AAAA record 2 BBBB record 3 |}
+> @kbd{gawk 'BEGIN @{ RS = "\n|( *[[:upper:]]+ *)" @}}
+> @address@hidden print "Record =", $0,"e RT = [" RT "]" @}'}
address@hidden Record = record 1 e RT = [ AAAA ]
address@hidden Record = record 2 e RT = [ BBBB ]
address@hidden Record = record 3 e RT = [
address@hidden ]
address@hidden example
+
address@hidden
+Le parentesi quadre racchiudono il contenuto di @code{RT}, rendendo visibile
+lo spazio vuoto iniziale e quello finale. L'ultimo valore di
address@hidden @`e un ritorno a capo.
address@hidden sed semplice} per un esempio address@hidden utile
+su @code{RS} come espressione regolare e su @code{RT}.
+
+Se si imposta @code{RS} a un'espressione regolare che consente del testo
+finale opzionale, come @samp{RS = "abc(XYZ)?"} @`e possibile, per via di
+limitazioni dell'implementazione, che @command{gawk} possa trovare la parte
+iniziale dell'espressione regolare, ma non la parte finale, in modo
+particolare se il testo di input che potrebbe avere una corrispondenza con la
+parte finale @`e piuttosto lungo. @command{gawk} cerca di evitare questo
+problema, ma al momento non ci sono garanzie che questo funzioni sempre.
+
address@hidden NOTA
+Si ricordi che in @command{awk}, i metacaratteri di ancoraggio @samp{^} e
address@hidden trovano l'inizio e la fine di una @emph{stringa}, e non l'inizio
e la
+fine di una @emph{riga}. Come risultato, qualcosa come
address@hidden = "^[[:upper:]]"} address@hidden solo corrispondere all'inizio
di un file.
+Questo perch@'e @command{gawk} vede il file in input come un'unica lunga
stringa
+in cui possono essere presenti dei caratteri di ritorno a capo.
address@hidden meglio address@hidden evitare metacaratteri di ancoraggio nel
valore di @code{RS}.
address@hidden quotation
+
address@hidden differenze tra @command{awk} e @command{gawk}, variabili
@code{RS}/@code{RT}
+L'uso di @code{RS} come espressione regolare e la variabile @code{RT} sono
+estensioni @command{gawk}; non sono disponibili in
address@hidden compatibile
+(@pxref{Opzioni}).
+In address@hidden compatibile, solo il primo carattere del valore di
address@hidden determina la fine del record.
+
address@hidden @code{RS = "\0"} non @`e portabile
address@hidden address@hidden, file di dati come un unico record
+Ci sono casi in cui capita di dover trattare un intero @value{DF} come
+un record unico. L'unico modo di far questo @`e quello di dare a @code{RS}
+un valore che non ricorre nel file in input. address@hidden @`e difficile da
fare in modo
+generale, address@hidden@dotless{i}} che un programma possa
+funzionare con file in input arbitrari.
+
+Si potrebbe pensare che per i file di testo il carattere @sc{NUL}, che
+consiste di un carattere con tutti i bit uguali a zero, sia un buon valore da
+usare per @code{RS} in questo caso:
+
address@hidden
+BEGIN @{ RS = "\0" @} # l'intero file diventa un record?
address@hidden example
+
address@hidden differenze tra @command{awk} e @command{gawk}, stringhe,
memorizzazione
address@hidden di fatto lo accetta, e usa il carattere @sc{NUL}
+come separatore di record.
+Questo funziona per certi file speciali, come @file{/proc/environ} su sistemi
+GNU/Linux, dove il carattere @sc{NUL} @`e di fatto un separatore di record..
+Comunque, quest'uso @emph{non} @`e portabile sulla maggior parte delle
+implementazioni di @command{awk}.
+
address@hidden angolo buio, stringhe, memorizzazione
+Quasi tutte le altre implementazioni di @command{awk} @footnote{Almeno quelle
+che ci sono note.} memorizzano internamente le stringhe come stringhe
+in stile C. Le stringhe in stile C usano il carattere @sc{NUL} come
+terminatore di stringa. In effetti, questo significa che
address@hidden = "\0"} @`e lo stesso di @samp{RS = ""}.
address@hidden
+
+Capita che recenti versioni di @command{mawk} possano usare i carattere
address@hidden come separatore di record. Comunque questo @`e un caso
particolare:
address@hidden non consente di includere caratteri @sc{NUL} nelle stringhe.
+(address@hidden potrebbe cambiare in una versione futura di @command{mawk}.)
+
address@hidden record, trattare un file come un solo
address@hidden trattare un file, come un solo record
address@hidden readfile} per un modo interessante di leggere
+file interi. Se si usa @command{gawk}, si veda
address@hidden di estensione Readfile} per un'altra opzione.
address@hidden sidebar
+
address@hidden Campi
address@hidden Un'introduzione ai campi
+
address@hidden esaminare i campi
address@hidden campi
address@hidden accesso ai campi
address@hidden campi, esame dei
+Quando @command{awk} legge un record in input, il record @`e
+automaticamente @dfn{analizzato} o separato da @command{awk} in "pezzi"
+chiamati @dfn{campi}. Per default, i campi sono separati da
address@hidden vuoti}, come le parole in una riga stampata.
+Uno spazio vuoto in @command{awk} @`e qualsiasi stringa composta da uno o
address@hidden
+spazi, segni di tabulazione o ritorni a capo;
+altri caratteri, come interruzione di pagina, tabulazione verticale, etc., che
+sono considerati spazi vuoti in altri linguaggi, @emph{non} sono considerati
+tali da @command{awk}.
+
+Lo scopo dei campi @`e quello di rendere address@hidden conveniente per
l'utente far
+riferimento a questi frammenti dei record. Non @`e necessario usarli---si
address@hidden
+operare sull'intero record, se si vuole---ma i campi sono address@hidden che
rende
address@hidden@dotless{i}} potenti dei semplici programmi @command{awk}.
+
address@hidden operatore di campo @code{$}
address@hidden @code{$} (dollaro), operatore di campo @code{$}
address@hidden dollaro (@code{$}), operatore di campo @code{$}
address@hidden operatore di campo, dollaro come
+Si usa il simbolo del dollaro (@samp{$})
+per far riferimento a un campo in un programma @command{awk},
+seguito dal numero del campo desiderato. Quindi, @code{$1}
+si riferisce al primo campo, @code{$2} al secondo, e
address@hidden@dotless{i}} via.
+(Diversamente che nelle shell Unix, i numeri di campo non sono limitati a una
+sola cifra; @code{$127} @`e il centoventisettesimo campo nel record.)
+Per esempio, supponiamo che la seguente sia una riga in input:
+
address@hidden
+Questo pare essere un esempio proprio carino.
address@hidden example
+
address@hidden
+Qui il primo campo, o @code{$1}, @`e @samp{Questo}, il secondo campo, o
address@hidden, @`e @samp{pare}, e via dicendo. Si noti che l'ultimo campo,
address@hidden, @`e @samp{carino.}. Poich@'e non ci sono spazi tra la
address@hidden e il @samp{.}, il punto @`e considerato parte del settimo
+campo.
+
address@hidden @code{NF}, variabile
address@hidden campi, numero dei
address@hidden @`e una variabile predefinita il cui valore @`e il numero di
campi nel
+record corrente. @command{awk} aggiorna automaticamente il valore di
address@hidden ogni volta che legge un record. Indipendentemente da quanti
campi
+ci possano essere, l'ultimo campo in un record address@hidden essere
rappresentato da
address@hidden address@hidden@dotless{i}}, @code{$NF} @`e lo stesso di
@code{$7}, che @`e @samp{carino.}.
+Se si cerca di far riferimento a un campo oltre l'ultimo
+(come @code{$8} quando il record ha solo sette campi), si ottiene
+la stringa nulla. (Se usato in un'operazione numerica si ottiene zero.)
+
+L'uso di @code{$0}, che sarebbe come un riferimento al campo ``numero zero'',
address@hidden un caso particolare: rappresenta l'intero record in input. Si
usa quando
+non si @`e interessati a un campo specifico. Vediamo qualche altro esempio:
+
address@hidden
+$ @kbd{awk '$1 ~ /li/ @{ print $0 @}' mail-list}
address@hidden Amelia 555-5553 amelia.zodiacusque@@gmail.com F
address@hidden Julie 555-6699 julie.perscrutabor@@skeeve.com F
address@hidden example
+
address@hidden
+Questo esempio stampa ogni record del file @file{mail-list} il cui primo campo
+contiene la stringa @samp{li}.
+
+Per converso, il seguente esempio cerca @samp{li} @emph{nell'intero record} e
+stampa il primo e l'ultimo campo di ogni record in input per cui @`e stata
+trovata una corrispondenza:
+
address@hidden
+$ @kbd{awk '/li/ @{ print $1, $NF @}' mail-list}
address@hidden Amelia F
address@hidden Broderick R
address@hidden Julie F
address@hidden Samuel A
address@hidden example
+
address@hidden Campi non costanti
address@hidden Numeri di campo variabili
address@hidden campi, numero dei
address@hidden numeri di campo
+
+Un numero di campo non @`e necessario che sia una costante. Nel linguaggio
address@hidden si address@hidden usare qualsiasi espressione dopo @samp{$} per
far
+riferimento a un campo. Il valore dell'espressione specifica il numero di
+campo. Se il valore @`e una stringa, piuttosto che un numero, viene convertito
+in un numero. Consideriamo questo esempio:
+
address@hidden
+awk '@{ print $NR @}'
address@hidden example
+
address@hidden
+Ricordiamo che @code{NR} @`e il numero dei record letti fino a questo punto:
uno
+nel primo record, due nel secondo, etc. address@hidden@dotless{i}}
quest'esempio stampa il primo
+campo del primo record, il secondo campo del secondo record, e
address@hidden@dotless{i}} via.
+Per il ventesimo record, @`e stampato il campo numero 20; molto probabilmente
il
+record ha meno di 20 campi, address@hidden stampa una riga vuota.
+Questo @`e un altro esempio sull'uso di espressioni come numeri di campo:
+
address@hidden
+awk '@{ print $(2*2) @}' mail-list
address@hidden example
+
address@hidden calcola l'espressione @samp{(2*2)} e usa il suo valore come
+numero del campo da stampare. Qui @samp{*} rappresenta la
+moltiplicazione, quindi l'espressione @samp{2*2} ha il valore quattro. Le
+parentesi vengono usate affinch@'e la moltiplicazione sia eseguita prima
+dell'operazione @samp{$}; sono necessarie ogni volta che c'@`e un operatore
address@hidden un @dfn{operatore binario}, come @samp{*} per la
+moltiplicazione, servono due operandi. La distinzione @`e necessaria poich@'e
address@hidden ha anche operatori unari (un operando) e ternari (tre
+operandi).}
+nell'espressione del numero di campo. Questo esempio, dunque, stampa il
+tipo di relazione (il quarto campo) per ogni riga del file
address@hidden (Tutti gli operatori di @command{awk} sono elencati, in
+ordine decrescente di precedenza, in
address@hidden)
+
+Se il numero di campo calcolato @`e zero, si ottiene l'intero record.
+Quindi, @samp{$(2-2)} ha lo stesso valore di @code{$0}. Numeri di campo
+negativi non sono consentiti; tentare di far riferimento a uno di essi
+normalmente fa terminare il programma. (Lo standard POSIX non chiarisce
+cosa succede quando si fa riferimento a un numero di campo negativo.
address@hidden avvisa di questo e fa terminare il programma. Altre
+implementazioni di @command{awk} possono comportarsi in modo diverso.)
+
+Come accennato in @ref{Campi},
address@hidden memorizza il numero di campi del record corrente nella variabile
+predefinita @code{NF} (@pxref{Variabili predefinite}). Quindi,
+l'espressione @code{$NF} non @`e una address@hidden address@hidden la diretta
+conseguenza della valutazione di @code{NF} e dell'uso di questo valore come
+numero di campo.
+
address@hidden Cambiare i campi
address@hidden Cambiare il contenuto di un campo
+
address@hidden campi, cambiare il contenuto dei
+Il contenuto di un campo, address@hidden@dotless{i}} come @`e visto da
@command{awk}, address@hidden essere
+cambiato all'interno di un programma @command{awk}; questo cambia quello che
address@hidden percepisce come record in input corrente. (Il reale file in
+input non viene toccato; @command{awk} non modifica @emph{mai} il file in
+input).
+Si consideri il seguente esempio e il suo output:
+
address@hidden
+$ @kbd{awk '@{ numero_pacchi = $3 ; $3 = $3 - 10}
+> @kbd{print numero_pacchi, $3 @}' inventory-shipped}
address@hidden 25 15
address@hidden 32 22
address@hidden 24 14
address@hidden
address@hidden example
+
address@hidden
+Il programma per prima cosa salva il valore originale del campo tre nella
+variabile @code{numero_pacchi}.
+Il segno @samp{-} rappresenta la sottrazione, address@hidden@dotless{i}}
questo programma riassegna
+il campo tre, @code{$3}, come il valore originale del campo meno dieci:
address@hidden - 10}. (@xref{Operatori aritmetici}.)
+Poi stampa il valore originale e quello nuovo del campo tre.
+(Qualcuno nel magazzino ha fatto un errore ricorrente nell'inventariare le
+scatole rosse.)
+
+Perch@'e questo funzioni, il testo in @code{$3} deve poter essere riconosciuto
+come un numero; la stringa di caratteri dev'essere convertita in un numero
+affich@'e il computer possa eseguire operazioni aritmetiche su di essa. Il
+numero che risulta dalla sottrazione viene nuovamente convertito in
+una stringa di caratteri che quindi diventa il campo tre.
address@hidden
+
+Quando il valore di un campo @`e cambiato (come percepito da @command{awk}), il
+testo del record in input viene ricalcolato per contenere il nuovo campo al
+posto di quello vecchio. In altre parole, @code{$0} cambia per riflettere il
+campo modificato. Questo programma
+stampa una copia del file in input, con 10 sottratto dal secondo campo di ogni
+riga:
+
address@hidden
+$ @kbd{awk '@{ $2 = $2 - 10; print $0 @}' inventory-shipped}
address@hidden Jan 3 25 15 115
address@hidden Feb 5 32 24 226
address@hidden Mar 5 24 34 228
address@hidden
address@hidden example
+
address@hidden possibile inoltre assegnare contenuti a campi che sono fuori
+intervallo. Per esempio:
+
address@hidden
+$ @kbd{awk '@{ $6 = ($5 + $4 + $3 + $2)}
+> @kbd{ print $6 @}' inventory-shipped}
address@hidden 168
address@hidden 297
address@hidden 301
address@hidden
address@hidden example
+
address@hidden aggiungere, campi
address@hidden campi, aggiungere
address@hidden
+Abbiamo appena creato @code{$6}, il cui valore @`e la somma dei campi
address@hidden, @code{$3}, @code{$4} e @code{$5}. Il segno @samp{+}
+rappresenta l'addizione. Per il file @file{inventory-shipped}, @code{$6}
+rappresenta il numero totale di pacchi spediti in un determinato mese.
+
+La creazione di un nuovo campo cambia la copia interna di @command{awk} nel
+record in input corrente, che @`e il valore di @code{$0}.
address@hidden@dotless{i}}, se si scrive
address@hidden $0} dopo aver aggiunto un campo, il record stampato include il
+nuovo campo, col numero di separatori di campo appropriati tra esso e i
+campi originariamente presenti.
+
address@hidden @code{OFS}, variabile
address@hidden output, separatore di campo, si veda @code{OFS}, variabile
address@hidden campo, separatori di, si veda anche @code{OFS}
address@hidden separatori di campo, si veda anche @code{OFS}
+Questa ridefinizione influenza ed @`e influenzata da
address@hidden (il numero dei campi; @pxref{Campi}).
+Per esempio, il valore di @code{NF} @`e impostato al numero del campo
address@hidden
+elevato che @`e stato creato.
+Il formato preciso di @code{$0} @`e influenzato anche da una address@hidden che
+non @`e ancora stata trattata: il @dfn{separatore di campo di output},
address@hidden, usato per separare i campi (@pxref{Separatori di output}).
+
+Si noti, comunque, che il mero @emph{riferimento} a un campo fuori
+intervallo @emph{non} cambia il valore di @code{$0} o di @code{NF}.
+Far riferimento a un campo fuori intervallo produce solo una stringa nulla.
+Per esempio:
+
address@hidden
+if ($(NF+1) != "")
+ print "non @`e possibile"
+else
+ print "@`e tutto normale"
address@hidden example
+
address@hidden
+dovrebbe stampare @address@hidden tutto normale}, perch@'e @code{NF+1} @`e
certamente
+fuori intervallo. (@xref{Istruzione if}
+per maggiori informazioni sulle istruzioni @code{if-else} di @command{awk}.
address@hidden di variabile e confronti}
+per maggiori informazioni sull'operatore @samp{!=}.)
+
address@hidden importante notare che facendo un assegnamento a un campo
esistente cambia
+il valore di @code{$0} ma non cambia il valore di @code{NF},
+anche qualora si assegni a un campo la stringa nulla. Per esempio:
+
address@hidden
+$ @kbd{echo a b c d | awk '@{ OFS = ":"; $2 = ""}
+> @kbd{print $0; print NF @}'}
address@hidden a::c:d
address@hidden 4
address@hidden example
+
address@hidden
+Il campo @`e ancora address@hidden@dotless{i}}; ha solo un valore vuoto,
delimitato dai due "due punti"
+tra @samp{a} e @samp{c}.
+Questo esempio mostra cosa succede se si crea un nuovo campo:
+
address@hidden
+$ @kbd{echo a b c d | awk '@{ OFS = ":"; $2 = ""; $6 = "nuovo"}
+> @kbd{print $0; print NF @}'}
address@hidden a::c:d::nuovo
address@hidden 6
address@hidden example
+
address@hidden
+Il campo intermedio, @code{$5}, @`e creato con un valore vuoto
+(indicato dalla seconda coppia di due punti adiacenti),
+e @code{NF} @`e aggiornato col valore sei.
+
address@hidden angolo buio, variabile @code{NF}, decremento
address@hidden @code{NF}, variable, decremento
+Decrementando @code{NF} si eliminano i campi
+dopo il nuovo valore di @code{NF} e si ricalcola @code{$0}.
address@hidden
+Vediamo un esempio:
+
address@hidden
+$ @kbd{echo a b c d e f | awk '@{ print "NF =", NF;}
+> @kbd{ NF = 3; print $0 @}'}
address@hidden NF = 6
address@hidden a b c
address@hidden example
+
address@hidden address@hidden, variabile @address@hidden decremento
address@hidden ATTENZIONE
+Alcune versioni di @command{awk} non
+ricostruiscono @code{$0} quando @code{NF} viene diminuito.
address@hidden quotation
+
+Infine, ci sono casi in cui conviene forzare
address@hidden a ricostruire l'intero record, usando i valori correnti
+dei campi e @code{OFS}. Per far address@hidden, si usa
+l'apparentemente innocuo assegnamento:
+
address@hidden
+$1 = $1 # forza la ricostruzione del record
+print $0 # o qualsiasi altra cosa con $0
address@hidden example
+
address@hidden
+Questo forza @command{awk} a ricostruire il record. Aggiungere un commento
+rende tutto address@hidden chiaro, come abbiamo appena visto.
+
+C'@`e un rovescio della medaglia nella relazione tra @code{$0} e
+i campi. Qualsiasi assegnamento a @code{$0} fa address@hidden@dotless{i}} che
il record sia
+rianalizzato (sintatticamente) e ridiviso in campi usando il valore
address@hidden di @code{FS}. Questo si applica anche a qualsiasi funzione
+predefinita che aggiorna @code{$0}, come @code{sub()} e @code{gsub()}
+(@pxref{Funzioni per stringhe}).
+
address@hidden Comprendere @code{$0}
+
address@hidden importante ricordare che @code{$0} @`e @emph{l'intero}
+record, esattamente com'@`e stato letto dall'input, compresi tutti gli spazi
+vuoti iniziali e finali, e l'esatto spazio vuoto (o altri caratteri) che
+separa i campi.
+
address@hidden un errore comune tentare di cambiare il separatore di campo in
un record
+semplicemente impostando @code{FS} e @code{OFS}, e poi
+aspettarsi che un semplice @samp{print} or @samp{print $0} stampi il record
+modificato.
+
+Questo non funziona, poich@'e non @`e stato fatto niente per cambiare quello
+stesso record. Invece, si deve forzare la ricostruzione del record,
+tipicamente con un'istruzione come @samp{$1 = $1}, come descritto
+in precedenza.
address@hidden sidebar
+
+
address@hidden Separatori di campo
address@hidden Specificare come vengono separati i campi
+
address@hidden
+* Separatori di campo di default:: Come di solito sono separati i campi.
+* Separare campi con @dfn{regexp}:: Usare @dfn{regexp} come separatori.
+* Campi di un solo carattere:: Fare di ogni carattere un campo
+ separato.
+* Separatori campo da riga di comando:: Assegnare @code{FS} dalla riga di
+ comando.
+* Campo intera riga:: Far address@hidden@dotless{i}} che la
riga intera sia un
+ campo solo.
+* Sommario sulla separazione campi:: Alcuni punti finali e una tavola di
+ sommario.
address@hidden menu
+
address@hidden @code{FS}, variabile
address@hidden campi, separare
address@hidden campo, separatori di
+Il @dfn{separatore di campo}, che @`e un carattere singolo o un'espressione
+regolare, controlla il modo in cui @command{awk} suddivide un record in input
+in campi. @command{awk} fa una scansione del record in input per trovare i
+caratteri che individuano il separatore; i campi sono il testo compreso tra i
+separatori trovati.
+
+Nell'esempio che segue, usiamo il simbolo del punto elenco (@bullet{}) per
+rappresentare gli spazi nell'output.
+Se il separatore di campo @`e @samp{oo}, la seguente riga:
+
address@hidden
+moo goo gai pan
address@hidden example
+
address@hidden
address@hidden suddivisa in tre campi: @samp{m}, @address@hidden, e
address@hidden@address@hidden
+Notare gli spazi iniziali nei valori del secondo e del terzo campo.
+
address@hidden risoluzione di problemi, @command{awk} usa @code{FS} anzich@'e
@code{IFS}
address@hidden problemi, risoluzione di, @command{awk} usa @code{FS} anzich@'e
@code{IFS}
+Il separatore di campo @`e rappresentato dalla variable predefinita @code{FS}.
+I programmatori di shell notino: @command{awk} @emph{non} usa il
+nome @code{IFS} che @`e usato dalle shell conformi a POSIX (come
+la Unix Bourne shell, @command{sh}, o Bash).
+
address@hidden @code{FS}, variabile, cambiare il valore di una
+Il valore di @code{FS} si address@hidden cambiare nel programma @command{awk}
con
+l'operatore di assegnamento, @samp{=} (@pxref{Operatori di assegnamento}).
+Spesso il momento giusto per far address@hidden @`e all'inizio dell'esecuzione
+prima che sia stato elaborato qualsiasi input, address@hidden@dotless{i}} che
il primo record
+sia letto col separatore appropriato. Per far questo, si usa il modello di
+ricerca speciale
address@hidden
+(@pxref{BEGIN/END}).
+Per esempio, qui impostiamo il valore di @code{FS} alla stringa
address@hidden","}:
+
address@hidden
+awk 'BEGIN @{ FS = "," @} ; @{ print $2 @}'
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca
address@hidden
+Data la riga in input:
+
address@hidden
+John Q. Smith, 29 Oak St., Walamazoo, MI 42139
address@hidden example
+
address@hidden
+questo programma @command{awk} estrae e stampa la stringa
address@hidden@address@hidden@bullet{}St.}.
+
address@hidden separatori di campo, scelta dei
address@hidden espressioni regolari come separatori di campo
address@hidden separatori di campo, espressioni regolari come
+A volte i dati in input contengono caratteri separatori che non
+separano i campi nel modo in cui ci si sarebbe atteso. Per esempio, il
+nome della persona dell'esempio che abbiamo appena usato potrebbe avere un
+titolo o un suffisso annesso, come:
+
address@hidden
+John Q. Smith, LXIX, 29 Oak St., Walamazoo, MI 42139
address@hidden example
+
address@hidden
+Lo stesso programma estrarrebbe @address@hidden invece di
address@hidden@address@hidden@bullet{}St.}.
+Se ci si aspetta che il programma stampi l'indirizzo,
+si address@hidden sorpresi. La morale @`e quella di scegliere la struttura
dei dati
+e i caratteri di separazione attentamente per evitare questi problemi.
+(Se i dati non sono in una forma facile da elaborare, address@hidden darsi che
+si possano manipolare con un programma @command{awk} separato.)
+
+
address@hidden Separatori di campo di default
address@hidden Lo spazio vuoto normalmente separa i campi
+
address@hidden spazi vuoti, come separatori di campo
+I campi sono separati normalmente da spazi vuoti
+(spazi, tabulazioni e ritorni a capo), non solo da spazi singoli. Due spazi
+in una riga non delimitano un campo vuoto. Il valore di default del separatore
+di campo @code{FS} @`e una stringa contenente un singolo spazio,
@address@hidden" "}}.
+Se @command{awk} interpretasse questo valore nel modo usuale, ogni carattere
+di spazio separerebbe campi, quindi due spazi in una riga creerebbero un campo
+vuoto tra di essi. Il motivo per cui questo non succede @`e perch@'e un
singolo
+spazio come valore di @code{FS} @`e un caso particolare: @`e preso per
specificare
+il modo di default di delimitare i campi.
+
+Se @code{FS} @`e qualsiasi altro carattere singolo, come @code{","}, ogni
+ricorrenza di quel carattere separa due campi. Due ricorrenze consecutive
+delimitano un campo vuoto. Se il carattere si trova all'inizio o alla fine
+della riga, anche quello delimita un campo vuoto. Il carattere di spazio @`e
+il solo carattere singolo che non segue queste
+regole.
+
address@hidden Separare campi con @dfn{regexp}
address@hidden Usare @dfn{regexp} come separatori di campo
+
address@hidden espressioni regolari, come separatori di campo
address@hidden separatori di campo, espressioni regolari come
+La precedente @value{SUBSECTION}
+ha illustrato l'uso di caratteri singoli o di stringhe semplici come
+valore di @code{FS}.
address@hidden in generale, il valore di @code{FS} address@hidden essere una
stringa contenente
+qualsiasi espressione regolare. Se questo @`e il caso, ogni corrispondenza nel
+record con l'espressione regolare separa campi. Per esempio, l'assegnamento:
+
address@hidden
+FS = ", \t"
address@hidden example
+
address@hidden
+trasforma ogni parte di una riga in input che consiste di una virgola seguita
+da uno spazio e una tabulazione in un separatore di campo.
address@hidden
+(@samp{\t}
address@hidden una @dfn{sequenza di protezione} che sta per un segno di
tabulazione;
address@hidden di protezione},
+per l'elenco completo di sequenze di protezione simili.)
address@hidden ifinfo
+
+Per un esempio meno banale di espressione regolare, si provi a usare spazi
+singoli per separare campi nel modo in cui sono usate le virgole. @code{FS}
address@hidden essere impostato a @address@hidden"[@ ]"}} (parentesi quadra
sinistra, spazio,
+parentesi quadra destra). Quest'espressione regolare corrisponde a uno spazio
address@hidden
+singolo e niente address@hidden (@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+singolo e niente address@hidden (@pxref{Espressioni regolari}).
address@hidden ifnottex
+C'@`e una differenza importante tra i due casi di @samp{FS = @w{" "}}
+(uno spazio singolo) e @samp{FS = @w{"[ \t\n]+"}}
+(un'espressione regolare che individua uno o address@hidden spazi, tabulazioni
o
+ritorni a capo). Per entrambi i valori di @code{FS}, i campi sono
+separati da @dfn{serie} (ricorrenze adiacenti multiple) di spazi, tabulazioni
+e/o ritorni a capo. Comunque, quando il valore di @code{FS} @`e
address@hidden@code{" "}}, @command{awk} prima toglie lo spazio vuoto iniziale
e finale
+dal record e poi stabilisce dove sono i campi.
+Per esempio, la seguente @dfn{pipeline} stampa @samp{b}:
+
address@hidden
+$ @kbd{echo ' a b c d ' | awk '@{ print $2 @}'}
address@hidden b
address@hidden example
+
address@hidden
+Invece la @dfn{pipeline} che segue stampa @samp{a} (notare lo spazio extra
+intorno a ogni lettera):
+
address@hidden
+$ @kbd{echo ' a b c d ' | awk 'BEGIN @{ FS = "[ \t\n]+" @}}
+> @address@hidden print $2 @}'}
address@hidden a
address@hidden example
+
address@hidden
address@hidden @cindex null strings
address@hidden stringhe nulle
address@hidden stringhe vuote, si veda stringhe nulle
+In questo caso, il primo campo @`e nullo, o vuoto.
+Il taglio degli spazi vuoti iniziale e finale ha luogo anche
+ogniqualvolta @code{$0} @`e ricalcolato.
+Per esempio, si consideri questa @dfn{pipeline}:
+
address@hidden
+$ @kbd{echo ' a b c d' | awk '@{ print; $2 = $2; print @}'}
address@hidden a b c d
address@hidden a b c d
address@hidden example
+
address@hidden
+La prima istruzione @code{print} stampa il record address@hidden@dotless{i}}
come @`e stato letto,
+con lo spazio vuoto intatto. L'assegnamento a @code{$2} ricostruisce
address@hidden concatenando insieme @code{$1} fino a @code{$NF},
+separati dal valore di @code{OFS} (che @`e uno spazio per default).
+Poich@'e lo spazio vuoto iniziale @`e stato ignorato quando si @`e trovato
address@hidden, esso non fa parte del nuovo @code{$0}. Alla fine, l'ultima
+istruzione @code{print} stampa il nuovo @code{$0}.
+
address@hidden @code{FS}, contenente @code{^}
address@hidden @code{^} (circonflesso), in @code{FS}
address@hidden angolo buio, @code{^}, in @code{FS}
+C'@`e un'ulteriore sottigliezza da considerare quando si usano le espressioni
+regolari per separare i campi.
+Non @`e ben specificato nello standard POSIX, n@'e altrove, cosa
+significhi @samp{^} nella divisione dei campi. Il @samp{^} cerca
+corrispondenze solo all'inizio dell'intero record? Oppure ogni separatore di
+campo @`e una nuova stringa? Di fatto versioni differenti di @command{awk}
+rispondono a questo quesito in modo diverso, e non si dovrebbe far affidamento
+su alcun comportamento specifico nei propri programmi.
address@hidden
+
address@hidden Brian Kernighan, @command{awk} di
+Di sicuro, BWK @command{awk} individua con @samp{^}
+solo l'inizio del record. Anche @command{gawk}
+funziona in questo modo. Per esempio:
+
address@hidden
+$ @kbd{echo 'xxAA xxBxx C' |}
+> @kbd{gawk -F '(^x+)|( +)' '@{ for (i = 1; i <= NF; i++)}
+> @kbd{ printf "-->%s<--\n", $i @}'}
address@hidden --><--
address@hidden -->AA<--
address@hidden -->xxBxx<--
address@hidden -->C<--
address@hidden example
+
address@hidden Campi di un solo carattere
address@hidden Fare di ogni carattere un campo separato
+
address@hidden estensioni comuni, campi di un solo carattere
address@hidden comuni, estensioni, campi di un solo carattere
address@hidden differenze tra @command{awk} e @command{gawk}, campi di un solo
carattere
address@hidden singolo carattere, campi
address@hidden campi di un solo carattere
+Ci sono casi in cui si abbia la address@hidden di analizzare ciascun carattere
di un
+record separatamente. Questo si address@hidden fare in @command{gawk}
semplicemente
+assegnando la stringa nulla (@code{""}) a @code{FS}. @value{COMMONEXT}
+In questo caso,
+ogni singolo carattere nel record diventa un campo separato.
+Per esempio:
+
address@hidden
+$ @kbd{echo a b | gawk 'BEGIN @{ FS = "" @}}
+> @address@hidden
+> @kbd{for (i = 1; i <= NF; i = i + 1)}
+> @kbd{print "Il campo", i, "@`e", $i}
+> @address@hidden'}
address@hidden Il campo 1 @`e a
address@hidden Il campo 2 @`e
address@hidden Il campo 3 @`e b
address@hidden example
+
address@hidden angolo buio, @code{FS} come stringa nulla
address@hidden @code{FS}, variabile, come stringa nulla
+Tradizionalmente, il comportamento di @code{FS} quando @`e impostato a
address@hidden""} non @`e stato definito. In questo caso, la maggior parte
delle
+versioni UNIX di @command{awk} trattano l'intero record come se avesse un
+unico campo.
address@hidden
+In address@hidden di address@hidden
+(@pxref{Opzioni}),
+se @code{FS} @`e la stringa nulla, anche @command{gawk}
+si comporta in questo modo.
+
address@hidden Separatori campo da riga di comando
address@hidden Impostare @code{FS} dalla riga di comando
address@hidden @option{-F}, opzione sulla riga di comando
address@hidden separatore di campo, specificare sulla riga di comando
address@hidden riga di comando, impostare @code{FS} sulla
address@hidden @code{FS}, variabile, impostare da riga di comando
+
address@hidden address@hidden essere impostata sulla riga di comando. Per far
questo si usa
+l'opzione @option{-F}. Per esempio:
+
address@hidden
+awk -F, '@var{programma}' @var{i-file-di-input}
address@hidden example
+
address@hidden
+imposta @code{FS} al carattere @samp{,}. Si noti che l'opzione richiede
+un carattere maiuscolo @samp{F} anzich@'e minuscolo @samp{f}. Quest'ultima
+opzione (@option{-f}) serve a specificare il file contenente un programma
address@hidden
+
+Il valore usato per l'argomento di @option{-F} @`e elaborato esattamente nello
+stesso modo degli assegnamenti alla variabile predefinita @code{FS}. Qualsiasi
+carattere speciale nel separatore di campo dev'essere protetto in modo
+appropriato. Per esempio, per usare un @samp{\} come separatore di campo
+sulla riga di comando, si dovrebbe battere:
+
address@hidden
+# equivale a FS = "\\"
+awk -F\\\\ '@dots{}' file @dots{}
address@hidden example
+
address@hidden
address@hidden @code{\} (barra inversa), come separatore di campo
address@hidden barra inversa (@code{\}), come separatore di campo
+Poich@'e @samp{\} @`e usato nella shell per proteggere caratteri, a
@command{awk}
+arriva @samp{-F\\}. Quindi @command{awk} elabora @samp{\\} per caratteri di
+protezione (@pxref{Sequenze di protezione}), producendo alla fine
+un unico @samp{\} da usare come separatore di campo.
+
address@hidden @cindex historical features
+Come caso particolare, in address@hidden di address@hidden
+(@pxref{Opzioni}),
+se l'argomento di @option{-F} @`e @samp{t}, @code{FS} @`e impostato al
+carattere di tabulazione. Se si immette @samp{-F\t} nella
+shell, senza che sia tra apici, @samp{\} viene cancellata,
address@hidden@dotless{i}} @command{awk}
+conclude che si vuole realmente che i campi siano separati da tabulazioni e
+non da delle @samp{t}. Si usi @samp{-v FS="t"} o @samp{-F"[t]"} sulla riga di
+comando se si vuole separare i campi con delle @samp{t}.
+Quando non si @`e in address@hidden di address@hidden si deve usare @samp{-F
'\t'} per
+specificare che le tabulazioni separano i campi.
+
+Come esempio, usiamo un file di programma @command{awk} chiamato
address@hidden che contiene il criterio di ricerca @code{/edu/} e l'azione
address@hidden $1}:
+
address@hidden
+/edu/ @{ print $1 @}
address@hidden example
+
+Impostiamo inoltre @code{FS} al carattere @samp{-} ed eseguiamo il programma
+sul file @file{mail-list}. Il seguente comando stampa un elenco dei nomi
+delle persone che lavorano all'address@hidden o che la frequentano, e le prime
tre
+cifre dei loro numeri di telefono:
+
address@hidden
+$ @kbd{awk -F- -f edu.awk mail-list}
address@hidden Fabius 555
address@hidden Samuel 555
address@hidden Jean
address@hidden example
+
address@hidden
+Si noti la terza riga di output. La terza riga
+nel file originale @`e simile a questa:
+
address@hidden
+Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden example
+
+Il @samp{-} che fa parte del nome della persona @`e stato usato come
+separatore di campo, al posto del @samp{-} presente nel numero di telefono,
+che ci si aspettava venisse usato.
+Questo lascia intuire il motivo per cui si deve stare attenti nella scelta
+dei separatori di campo e di record.
+
address@hidden Unix @command{awk}, file di password, separatori di campo e
+Forse l'uso address@hidden comune di un solo carattere come separatore di
campo avviene
+quando si elabora il file delle password di un sistema Unix. Su molti sistemi
+Unix, ogni utente @`e descritto da un elemento nel file delle password del
+sistema, che contiene una riga singola per ogni utente. In queste righe le
+informazioni sono separate da dei caratteri ":". Il
+primo campo @`e il nome di login dell'utente e il secondo @`e la password
+dell'utente criptata o oscurata (una password oscurata @`e indicata dalla
+presenza di una sola @samp{x} nel secondo campo). Una riga nel file delle
+password potrebbe essere simile a questa:
+
address@hidden Robbins, Arnold
address@hidden
+arnold:x:2076:10:Arnold Robbins:/home/arnold:/bin/bash
address@hidden example
+
+Il seguente programma esamina il file delle password di sistema e stampa le
+voci relative agli utenti il cui nome completo non @`e presente nel file:
+
address@hidden
+awk -F: '$5 == ""' /etc/passwd
address@hidden example
+
address@hidden Campo intera riga
address@hidden Fare di una riga intera un campo solo
+
+Occasionalmente, @`e utile trattare l'intera riga in input come un solo campo.
+Questo si address@hidden fare facilmente e in modo portabile semplicemente
impostando
address@hidden a @code{"\n"} (un ritorno a capo)address@hidden ad
+Andrew Schorr per questo suggerimento.}
+
address@hidden
+awk -F'\n' '@var{programma}' @var{file @dots{}}
address@hidden example
+
address@hidden
+In questo caso, @code{$1} coincide con @code{$0}.
+
+
address@hidden Cambiare @code{FS} non incide sui campi
+
address@hidden POSIX @command{awk}, separatori di campo e
address@hidden separatore di campo, POSIX e il
+Secondo lo standard POSIX, si suppone che @command{awk} si comporti
+come se ogni record sia stato diviso in campi nel momento in cui @`e stato
+letto. In particolare, address@hidden vuol dire che se si cambia il valore di
address@hidden dopo che un record @`e stato letto, il valore dei campi (cio@'e
+la loro suddivisione) address@hidden ancora quello ottenuto usando il
precedente
+valore di @code{FS}, non quello nuovo.
+
address@hidden angolo buio, separatori di campo
address@hidden @command{sed}, programma di address@hidden
address@hidden programma di address@hidden @command{sed}
address@hidden editori di flusso
+Comunque, molte delle address@hidden vecchie implementazioni di @command{awk}
non
+funzionano in questo modo. Invece, rimandano la divisione dei campi
+fino a quando si fa effettivamente riferimento a un campo. I campi sono
+divisi usando il valore @emph{corrente} di @code{FS}!
address@hidden
+Questo comportamento address@hidden essere di difficile
+identificazione. Il seguente esempio illustra la differenza
+tra i due metodi. Lo script
+
address@hidden
+sed 1q /etc/passwd | awk '@{ FS = ":" ; print $1 @}'
address@hidden example
+
address@hidden
+normalmente stampa:
+
address@hidden
address@hidden root
address@hidden example
+
address@hidden
+su un'implementazione non standard di @command{awk}, mentre @command{gawk}
+stampa l'intera prima riga del file, qualcosa come:
+
address@hidden
+root:x:0:0:Root:/:
address@hidden example
+
+(Il comando @address@hidden programma di address@hidden @command{sed} @`e un
+``editore di flusso''. Anche il suo comportamento @`e definito dallo standard
+POSIX.} appena visto stampa solo la prima riga di @file{/etc/passwd}.)
address@hidden sidebar
+
address@hidden Sommario sulla separazione campi
address@hidden Sommario sulla separazione dei campi
+
address@hidden importante ricordare che quando si assegna una costante stringa
+come valore di @code{FS}, questa subisce una normale elaborazione di stringa
+da parte di @command{awk}. Per esempio, con Unix @command{awk} e
address@hidden, l'assegnamento @samp{FS = "\.."} assegna la stringa di
+caratteri @code{".."}
+a @code{FS} (la barra inversa @`e tolta). Questo crea un'espressione regolare
+che significa ``i campi sono separati da ricorrenze di due caratteri
+qualsiasi''. Se invece si vuole che i campi siano separati da un punto
+seguito da un qualsiasi carattere singolo, si deve usare @samp{FS = "\\.."}.
+
+Il seguente elenco riassume come i campi vengono divisi, in base al valore
+di @code{FS} (@samp{==} significa address@hidden uguale a''):
+
address@hidden @code
address@hidden FS == " "
+I campi sono separati da serie di spazi vuoti. Gli spazi vuoti iniziale e
+finale sono ignorati. Questo @`e il comportamento di default.
+
address@hidden FS == @var{qualsiasi altro carattere singolo}
+I campi sono separati da ogni ricorrenza del carattere. Ricorrenze
+successive multiple delimitano campi vuoti, e lo stesso fanno le ricorrenze
+iniziali e finali del carattere.
+Il carattere address@hidden essere anche un metacarattere di espressione
regolare, che
+non @`e necessario proteggere.
+
address@hidden FS == @var{espressione regolare}
+I campi sono separati da ricorrenze di caratteri che corrispondono alla
address@hidden regolare}. Corrispondenze iniziali e finali della
address@hidden delimitano campi vuoti.
address@hidden FS == ""
+Ogni sinngolo carattere nel record diventa un campo separato.
+(Questa @`e un'estensione comune; non @`e specificata dallo standard POSIX.)
address@hidden table
+
address@hidden @code{FS} e @code{IGNORECASE}
+La variabile @code{IGNORECASE}
+(@pxref{Variabili modificabili dall'utente})
+influisce sulla divisione del campo @emph{solo} quando il valore di @code{FS}
address@hidden un'espressione regolare. Non ha nessun effetto quando @code{FS}
@`e un
+singolo carattere, anche se quel carattere @`e una lettera. Quindi, nel
+seguente codice:
+
address@hidden
+FS = "c"
+IGNORECASE = 1
+$0 = "aCa"
+print $1
address@hidden example
+
address@hidden
+L'output @`e @samp{aCa}. Se si vuol veramente dividere i campi su un carattere
+alfabetico ignorandone il maiuscolo/minuscolo, si deve usare un'espressione
+regolare che lo address@hidden in automatico (p.es., @samp{FS = "[c]"}). In
questo
+caso, @code{IGNORECASE} address@hidden effetto.
address@hidden sidebar
+
+
address@hidden Dimensione costante
address@hidden Leggere campi di larghezza costante
+
+
address@hidden campi di larghezza costante
address@hidden larghezza costante, campi di
address@hidden address@hidden avanzate, campi di larghezza costante
address@hidden O'Reilly doesn't like it as a note the first thing in the
section.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta una address@hidden avanzata
+di @command{gawk}. Se si @`e un utente alle prime armi di @command{awk},
+la si address@hidden saltare in prima lettura.
+
address@hidden fornisce una address@hidden per il trattamento di campi
+a larghezza fissa senza un separatore di campo distintivo. Per esempio,
+dati di questo tipo si trovano nell'input per vecchi programmi Fortran dove
+dei numeri sono elencati uno dopo l'altro, o nell'output di programmi che
+non prevedono che il loro output sia dato in input ad altri programmi.
+
+Un esempio di quest'ultimo caso @`e una tabella dove tutte le colonne sono
+allineate usando un numero variabile di spazi e dove @emph{i campi vuoti
+sono solo spazi}. Chiaramente, la normale divisione in campi di
address@hidden basata su @code{FS} non funziona bene in questa situazione.
+Sebbene un programma @command{awk}
+portabile possa usare una serie di chiamate @code{substr()} su @code{$0}
+(@pxref{Funzioni per stringhe}),
+questo @`e scomodo e inefficiente se il numero dei campi @`e elevato.
+
address@hidden risoluzione di problemi, errori fatali, specificare larghezza
dei campi
address@hidden problemi, risoluzione di, errori fatali, specificare larghezza
dei campi
address@hidden @command{w}, programma di address@hidden
address@hidden programma di address@hidden @command{w}
address@hidden @code{FIELDWIDTHS}, variabile
address@hidden @command{gawk}, variabile @code{FIELDWIDTHS} in
+La suddivisione di un record in input in campi a larghezza fissa viene
+specificata assegnando una stringa contenente numeri separati da spazi alla
+variabile predefinita @code{FIELDWIDTHS}. Ogni numero specifica la larghezza
+del campo, @emph{comprese} le colonne tra i campi. Se si vogliono ignorare le
+colonne tra i campi si address@hidden specificare la loro larghezza come un
campo
+separato che address@hidden poi ignorato.
address@hidden un errore fatale definire una larghezza di campo che abbia un
valore
+negativo. I dati seguenti costituiscono l'output del programma di
address@hidden
+Unix @command{w}. @`E utile per spiegare l'uso di @code{FIELDWIDTHS}:
+
address@hidden
address@hidden
+ 10:06pm up 21 days, 14:04, 23 users
+User tty login@ idle JCPU PCPU what
+hzuo ttyV0 8:58pm 9 5 vi p24.tex
+hzang ttyV3 6:37pm 50 -csh
+eklye ttyV5 9:53pm 7 1 em thes.tex
+dportein ttyV6 8:17pm 1:47 -csh
+gierd ttyD3 10:00pm 1 elm
+dave ttyD4 9:47pm 4 4 w
+brent ttyp0 26Jun91 4:46 26:46 4:41 bash
+dave ttyq4 26Jun9115days 46 46 wnewmail
address@hidden group
address@hidden example
+
+Il seguente programma prende l'input sopra mostrato, converte il tempo di
address@hidden
+in numero di secondi, e stampa i primi due campi e il tempo di address@hidden
+calcolato:
+
address@hidden
+BEGIN @{ FIELDWIDTHS = "9 6 10 6 7 7 35" @}
+NR > 2 @{
+ inat = $4
+ sub(/^ +/, "", inat) # togli spazi prima del valore
+ if (inat == "")
+ inat = 0
+ if (inat ~ /:/) @{
+ split(inat, t, ":")
+ inat = t[1] * 60 + t[2]
+ @}
+ if (inat ~ /days/)
+ inat *= 24 * 60 * 60
+
+ print $1, $2, inat
address@hidden
address@hidden example
+
address@hidden NOTA
+Questo programma usa diverse address@hidden di @command{awk} non
+ancora trattate.
address@hidden quotation
+
+L'esecuzione del programma sui dati produce il seguente risultato:
+
address@hidden
+hzuo ttyV0 0
+hzang ttyV3 50
+eklye ttyV5 0
+dportein ttyV6 107
+gierd ttyD3 1
+dave ttyD4 0
+brent ttyp0 286
+dave ttyq4 1296000
address@hidden example
+
+Un altro esempio (forse address@hidden pratico) di dati di input con larghezza
costante @`e
+l'input da un mazzo di schede elettorali. In alcune parti degli Stati Uniti,
+i votanti marcano le loro scelte perforando delle schede elettroniche.
+
+Queste schede vengono poi elaborate per contare i voti espressi per ogni
+singolo candidato o su ogni determinato quesito. Siccome un votante
address@hidden
+scegliere di non votare su alcune questioni, qualsiasi colonna della scheda
address@hidden essere vuota. Un programma @command{awk} per elaborare tali
dati potrebbe
+usare la address@hidden @code{FIELDWIDTHS} per semplificare la lettura dei
dati.
+(Naturalmente, riuscire a eseguire @command{gawk} su un sistema con lettori di
+schede @`e un'altra storia!)
+
address@hidden @command{gawk}, separazione in campi e
+L'assegnazione di un valore a @code{FS} fa address@hidden@dotless{i}} che
@command{gawk} usi @code{FS}
+per separare nuovamente i campi. Si address@hidden usare @samp{FS = FS} per
ottenere
+questo effetto, senza dover conoscere il valore corrente di @code{FS}.
+Per vedere quale tipo di separazione sia in atto,
+si address@hidden usare @code{PROCINFO["FS"]}
+(@pxref{Variabili auto-assegnate}).
+Il suo valore @`e @code{"FS"} se si usa la normale separazione in campi,
+o @code{"FIELDWIDTHS"} se si usa la separazione in campi a larghezza fissa:
+
address@hidden
+if (PROCINFO["FS"] == "FS")
+ @var{separazione in campi address@hidden
+else if (PROCINFO["FS"] == "FIELDWIDTHS")
+ @var{separazione in campi a larghezza address@hidden
+else
+ @var{separazione dei campi in base al address@hidden @ii{(si veda
address@hidden
+la @value{SECTION} successiva)}
address@hidden ifnotinfo
address@hidden
+il @value{SECTION} successivo)}
address@hidden ifinfo
address@hidden example
+
+Quest'informazione @`e utile quando si scrive una funzione che
+necessita di cambiare temporaneamente @code{FS} o @code{FIELDWIDTHS},
+leggere alcuni record, e poi ripristinare le impostazioni originali
+(@pxref{Funzioni Passwd},
+per un esempio di tale funzione).
+
address@hidden Separazione in base al contenuto
address@hidden Definire i campi in base al contenuto
+
address@hidden O'Reilly doesn't like it as a note the first thing in the
section.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta una address@hidden avanzata
+di @command{gawk}. Se si @`e un utente alle prime armi di @command{awk},
+la si address@hidden saltare in prima lettura.
+
address@hidden address@hidden avanzate, specificare il contenuto dei campi
+Normalmente, quando si usa @code{FS}, @command{gawk} definisce i campi come
+le parti del record che si trovano tra due separatori di campo. In altre
+parole, @code{FS} definisce cosa un campo @emph{non @`e}, invece di cosa
address@hidden@`e}.
+Tuttavia, ci sono casi in cui effettivamente si ha bisogno di definire i campi
+in base a cosa essi sono, e non in base a cosa non sono.
+
+Il caso address@hidden emblematico @`e quello dei dati cosiddetti
@dfn{comma-separated
+value} (CSV). Molti fogli elettronici, per esempio, possono esportare i dati
+in file di testo, dove ogni record termina con un ritorno a capo e i campi
+sono separati tra loro da virgole. Se le virgole facessero solo da separatore
+fra i dati non ci sarebbero problemi. Il problema sorge se uno dei campi
+contiene una virgola @emph{al suo interno}.
+In queste situazioni, la maggioranza dei programmi include il campo fra
+doppi address@hidden formato CSV non ha avuto, per molti anni, una
+definizione standard formale.
address@hidden://www.ietf.org/rfc/rfc4180.txt, RFC 4180}
+standardizza le pratiche address@hidden comuni.}
address@hidden@dotless{i}}, potremmo avere dei dati di questo tipo:
+
address@hidden
address@hidden file eg/misc/addresses.csv
+Robbins,Arnold,"1234 A Pretty Street, NE",MyTown,MyState,12345-6789,USA
address@hidden endfile
address@hidden example
+
address@hidden @command{gawk}, variabile @code{FPAT} in
address@hidden @code{FPAT}, variabile
+La variabile @code{FPAT} offre una soluzione per casi come questo.
+Il valore di @code{FPAT} dovrebbe essere una stringa formata da un'espressione
+regolare. L'espressione regolare descrive il contenuto di ciascun campo.
+
+Nel caso dei dati CSV visti prima, ogni campo @`e ``qualsiasi cosa che non
+sia una virgola,'' oppure ``doppi apici, seguiti da qualsiasi cosa che non
+siano doppi apici, e doppi apici di chiusura''. Se fosse scritta come una
+costante @dfn{regexp}
address@hidden
+(@pxrefil{Espressioni regolari}),
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}),
address@hidden ifnottex
+sarebbe @code{/([^,]+)|("[^"]+")/}.
+Dovendola scrivere come stringa si devono proteggere i doppi apici,
+e quindi si deve scrivere:
+
address@hidden
+FPAT = "([^,]+)|(\"[^\"]+\")"
address@hidden example
+
+Come esempio pratico, si address@hidden vedere questo semplice programma che
analizza
+e divide i dati:
+
address@hidden
address@hidden file eg/misc/simple-csv.awk
+BEGIN @{
+ FPAT = "([^,]+)|(\"[^\"]+\")"
address@hidden
+
address@hidden
+ print "NF = ", NF
+ for (i = 1; i <= NF; i++) @{
+ printf("$%d = <%s>\n", i, $i)
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Eseguendolo, avendo in input la riga vista sopra, si ottiene:
+
address@hidden
+$ @kbd{gawk -f simple-csv.awk addresses.csv}
+NF = 7
+$1 = <Robbins>
+$2 = <Arnold>
+$3 = <"1234 A Pretty Street, NE">
+$4 = <MyTown>
+$5 = <MyState>
+$6 = <12345-6789>
+$7 = <USA>
address@hidden example
+
+Si noti la virgola contenuta nel valore del campo @code{$3}.
+
+Un semplice miglioramento se si elaborano dati CSV di questo tipo potrebbe
+essere quello di rimuovere i doppi apici, se presenti, con del codice di
+questo tipo:
+
address@hidden
+if (substr($i, 1, 1) == "\"") @{
+ len = length($i)
+ $i = substr($i, 2, len - 2) # Ottiene il testo tra doppi apici
address@hidden
address@hidden example
+
+Come per @code{FS}, la variabile @code{IGNORECASE}
+(@pxref{Variabili modificabili dall'utente}) ha effetto sulla separazione dei
+campi con @code{FPAT}.
+
+Se si assegna un valore a @code{FPAT} la divisione in campi non viene
+effettuata utilizzando @code{FS} o @code{FIELDWIDTHS}.
+Analogamente a @code{FIELDWIDTHS}, il valore di @code{PROCINFO["FS"]}
address@hidden @code{"FPAT"} se @`e in uso la suddivisione in campi in base al
contenuto.
+
address@hidden NOTA
+Alcuni programmi esportano dei dati CSV che contengono dei ritorni a capo al
+loro interno in campi rinchiusi tra doppi apici. @command{gawk} non @`e in
+grado di trattare questi dati. Malgrado esista una specifica ufficiale
+per i dati CSV, non c'@`e molto da fare; il meccanismo di @code{FPAT} fornisce
+una soluzione elegante per la maggioranza dei casi, e per gli sviluppatori di
address@hidden address@hidden address@hidden bastare.
address@hidden quotation
+
+Come visto, l'espressione regolare usata per @code{FPAT} richiede
+che ogni campo contenga almeno un carattere. Una semplice modifica
+(cambiare il primo @samp{+} con @samp{*}) permette che siano presenti dei
+campi vuoti:
+
address@hidden
+FPAT = "([^,]*)|(\"[^\"]+\")"
address@hidden example
+
address@hidden FIXME: 4/2015
address@hidden Consider use of FPAT = "([^,]*)|(\"[^\"]*\")"
address@hidden (star in latter part of value) to allow quoted strings to be
empty.
address@hidden Per email from Ed Morton <address@hidden>
+
+Infine, la funzione @code{patsplit()} rende la stessa address@hidden
disponibile
+per suddividere normali stringhe (@pxref{Funzioni per stringhe}).
+
+Per ricapitolare, @command{gawk} fornisce tre metodi indipendenti per
+suddividere in campi i record in input.
+Il meccanismo usato @`e determinato da quella tra le tre
address@hidden, @code{FIELDWIDTHS}, o @code{FPAT}---a cui
+sia stato assegnato un valore address@hidden recentemente.
+
address@hidden Righe multiple
address@hidden Record su righe multiple
+
address@hidden righe multiple, record su
address@hidden record multiriga
address@hidden input, record multiriga
address@hidden file, lettura dei record multiriga
address@hidden input, file in, si veda file in input
+In alcune banche-dati, una sola riga non address@hidden contenere in modo
adeguato
+tutte le informazioni di una voce. In questi casi si possono usare record
+multiriga.
+Il primo passo @`e quello di scegliere il formato dei dati.
+
address@hidden separatori di record, per record multiriga
+Una tecnica @`e quella di usare un carattere o una stringa non usuali per
+separare i record. Per esempio, si address@hidden usare il carattere di
interruzione di
+pagina (scritto @samp{\f} sia in @command{awk} che in C) per separarli,
+rendendo ogni record una pagina del file. Per far address@hidden, basta
impostare la
+variabile @code{RS} a @code{"\f"} (una stringa contenente il carattere di
+interruzione di pagina). Si potrebbe ugualmente usare qualsiasi altro
+carattere, sempre che non faccia parte dei dati di un record.
+
address@hidden @code{RS}, variabile, record multiriga e
+Un'altra tecnica @`e quella di usare righe vuote per separare i record.
+Per una particolare
+convenzione, una stringa nulla come valore di @code{RS} indica che i record
+sono separati da una o address@hidden righe vuote. Quando @code{RS} @`e
impostato alla
+stringa nulla, ogni record termina sempre alla prima riga vuota che @`e stata
+trovata. Il record successivo non inizia prima della successiva riga non
+vuota. Indipendentemente dal numero di righe vuote presenti in successione,
+esse costituiscono sempre un unico separatore di record.
+(Le righe vuote devono essere completamente vuote; righe che contengono
+spazi bianchi @emph{non} sono righe vuote.)
+
address@hidden stringa address@hidden lunga da sinistra, individuare la
address@hidden individuare la stringa address@hidden lunga da sinistra
+Si address@hidden ottenere lo stesso effetto di @samp{RS = ""} assegnando la
stringa
address@hidden"\n\n+"} a @code{RS}. Quest'espressione regolare individua
+il ritorno a capo alla fine del record e una o address@hidden righe vuote dopo
il
+record. In aggiunta, un'espressione regolare individua sempre la sequenza
address@hidden
+lunga possibile quando una tale stringa sia presente.
+(@address@hidden lungo da sinistra}).
+Quindi, il record successivo non inizia prima della successiva riga non
+vuota; indipendentemente dal numero di righe vuote presenti in una voce di
+banca-dati, esse sono considerate come un unico separatore di record.
+
address@hidden angolo buio, record multiriga
+Comunque, c'@`e una sostanziale differenza tra @samp{RS = ""} e @samp{RS =
+"\n\n+"}. Nel primo caso, i ritorni a capo iniziali nel @value{DF} di
+input vengono ignorati, e se un file termina senza righe vuote aggiuntive dopo
+l'ultimo record, il ritorno a capo viene rimosso dal record. Nel secondo
+caso, questa particolare elaborazione non viene fatta.
address@hidden
+
address@hidden separatore di campo, nei record multiriga
address@hidden @code{FS}, nei record multiriga
+Ora che l'input @`e separato in record, il secondo passo @`e quello di
separare i
+campi all'interno dei record. Un modo per farlo @`e quello di dividere in
+campi ognuna delle righe in input
+nel modo solito. Questo viene fatto per default tramite una
+speciale address@hidden Quando @code{RS} @`e impostato alla stringa nulla
address@hidden @code{FS} @`e impostato a un solo carattere, il carattere di
+ritorno a capo agisce @emph{sempre} come separatore di campo.
+Questo in aggiunta a tutte le separazioni di campo che risultano da
address@hidden@footnote{Quando @code{FS} @`e la stringa nulla (@code{""}), o
+un'espressione regolare, questa particolare address@hidden di @code{RS} non
+viene applicata; si applica al separatore di campo quando @`e costituito da un
+solo spazio:
address@hidden = @w{" "}}.}
+
+La motivazione originale per questa particolare eccezione probabilmente era
+quella di prevedere un comportamento che fosse utile nel caso di default
+(address@hidden, @code{FS} uguale a @address@hidden" "}}). Questa
address@hidden address@hidden
+costituire un problema se non si vuole che il carattere di ritorno a capo
+faccia da separatore tra i campi, perch@'e non c'@`e alcun modo per impedirlo.
+Tuttavia, si address@hidden aggirare il problema usando la funzione
@code{split()}
+per spezzare i record manualmente.
+(@pxref{Funzioni per stringhe}).
+Se si ha un separatore di campo costituito da un solo carattere, si
address@hidden
+aggirare la address@hidden speciale in modo diverso, trasformando @code{FS}
+in un'espressione regolare contenente
+quel carattere singolo. Per esempio, se il separatore di campo @`e
+un carattere di percentuale, al posto di
address@hidden = "%"}, si address@hidden usare @samp{FS = "[%]"}.
+
+Un altro modo per separare i campi @`e quello di
+mettere ciascun campo su una riga separata: per far questo basta impostare la
+variabile @code{FS} alla stringa @code{"\n"}.
+(Questo separatore di un solo carattere individua un singolo ritorno a capo.)
+Un esempio pratico di un @value{DF} organizzato in questo modo potrebbe essere
+un elenco di indirizzi, in cui delle righe vuote fungono da separatore fra
+record. Si consideri un elenco di indirizzi in un file chiamato
address@hidden, simile a questo:
+
address@hidden
+Jane Doe
+123 Main Street
+Anywhere, SE 12345-6789
+
+John Smith
+456 Tree-lined Avenue
+Smallville, MW 98765-4321
address@hidden
address@hidden example
+
address@hidden
+Un semplice programma per elaborare questo file @`e il seguente:
+
address@hidden
+# addrs.awk --- semplice programma per una lista di indirizzi postali
+
+# I record sono separati da righe bianche
+# Ogni riga @`e un campo.
+BEGIN @{ RS = "" ; FS = "\n" @}
+
address@hidden
+ print "Il nome @`e:", $1
+ print "L'indirizzo @`e:", $2
+ print "address@hidden e Stato sono:", $3
+ print ""
address@hidden
address@hidden example
+
+L'esecuzione del programma produce questo output:
+
address@hidden
+$ @kbd{awk -f addrs.awk addresses}
address@hidden Il nome @`e: Jane Doe
address@hidden L'indirizzo @`e: 123 Main Street
address@hidden address@hidden e Stato sono: Anywhere, SE 12345-6789
address@hidden
address@hidden Il nome @`e: John Smith
address@hidden L'indirizzo @`e: 456 Tree-lined Avenue
address@hidden address@hidden e Stato sono: Smallville, MW 98765-4321
address@hidden
address@hidden
address@hidden example
+
address@hidden labels}, per un programma address@hidden realistico per gestire
+elenchi di indirizzi. Il seguente elenco riassume come sono divisi i record,
+a seconda del valore assunto da
address@hidden
address@hidden
+(@samp{==} significa address@hidden uguale a.'')
address@hidden ifinfo
address@hidden
address@hidden:
address@hidden ifnotinfo
+
address@hidden @code
address@hidden RS == "\n"
+I record sono separati dal carattere di ritorno a capo (@samp{\n}). In
+effetti, ogni riga nel @value{DF} @`e un record separato, comprese le righe
+vuote. Questo @`e il comportamento di default.
+
address@hidden RS == @var{qualsiasi carattere singolo}
+I record sono separati da ogni ricorrenza del carattere specificato.
address@hidden
+ricorrenze adiacenti delimitano record vuoti.
+
address@hidden RS == ""
+I record sono separati da una o address@hidden righe vuote.
+Quando @code{FS} @`e un carattere singolo,
+il carattere di ritorno a capo
+serve sempre come separatore di campo, in aggiunta a qualunque valore possa
+avere @code{FS}. I ritorni a capo all'inizio e alla fine del file sono
+ignorati.
+
address@hidden RS == @var{regexp}
+I record sono separati da ricorrenze di caratteri corrispondenti a
address@hidden Le corrispondenze iniziali e finali di
address@hidden designano record vuoti.
+(Questa @`e un'estensione di @command{gawk}; non @`e specificata dallo
+standard POSIX.)
address@hidden table
+
address@hidden @command{gawk}, @code{RT} variabile in
address@hidden @code{RT}, variabile
+Se non @`e eseguito in address@hidden di address@hidden (@pxref{Opzioni}),
address@hidden imposta @code{RT} al testo di input corrispondente
+al valore specificato da @code{RS}.
+Ma se al termine del file in input non @`e stato trovato un testo che
+corrisponde a @code{RS}, @command{gawk} imposta @code{RT} alla stringa nulla.
+
address@hidden Getline
address@hidden Richiedere input usando @code{getline}
+
address@hidden @code{getline}, comando, input esplicito con
address@hidden input esplicito
+Finora abbiamo ottenuto i dati di input dal flusso di input principale di
address@hidden: lo standard input (normalmente la tastiera, a volte
+l'output di un altro programma) o i
+file indicati sulla riga di comando. Il linguaggio @command{awk} ha uno
+speciale comando predefinito chiamato @code{getline} che
address@hidden essere usato per leggere l'input sotto il diretto controllo
dell'utente.
+
+Il comando @code{getline} @`e usato in molti modi diversi e
address@hidden dovrebbe essere usato dai principianti.
+L'esempio che segue alla spiegazione del comando @code{getline}
+comprende del materiale che ancora non @`e stato trattato. Quindi, @`e meglio
+tornare indietro e studiare il comando @code{getline} @emph{dopo} aver rivisto
+il resto
address@hidden
+di questo @value{DOCUMENT}
address@hidden ifinfo
address@hidden
+di questo @value{DOCUMENT}
address@hidden ifhtml
address@hidden
address@hidden
+delle Parti I e II
address@hidden ifnothtml
address@hidden ifnotinfo
+e avere acquisito una buona conoscenza di come funziona @command{awk}.
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile, con comando @command{getline}
address@hidden differenze tra @command{awk} e @command{gawk}, comando
@code{getline}
address@hidden @code{getline}, comando, valori di ritorno
address@hidden @option{--sandbox}, opzione, ridirezione dell'input con
@code{getline}
+
+Il comando @code{getline} restituisce 1 se trova un record e 0 se
+trova la fine del file. Se si verifica qualche errore cercando di leggere
+un record, come un file che non address@hidden essere aperto, @code{getline}
+restituisce @minus{}1. In questo caso, @command{gawk} imposta la variabile
address@hidden a una stringa che descrive l'errore in questione.
+
+Se il messaggio di errore @code{ERRNO} indica che l'operazione di I/O
address@hidden
+essere ritentata e la variabile @code{PROCINFO["@var{input}", "RETRY"]} @`e
+impostata a 1, @code{getline} restituisce un codice di ritorno @minus{}2
+invece che @minus{}1, e si address@hidden provare a chiamare ulterioriormente
address@hidden @xref{Proseguire dopo errore in input} per ulteriori
+informazioni riguardo a questa address@hidden
+
+Negli esempi seguenti, @var{comando} sta per un valore di stringa che
+rappresenta un comando della shell.
+
address@hidden NOTA
+Quando @`e stata specificata l'opzione @option{--sandbox} (@pxref{Opzioni}),
+la lettura di input da file, @dfn{pipe} e coprocessi non @`e possibile.
address@hidden quotation
+
address@hidden
+* Getline semplice:: Usare @code{getline} senza argomenti.
+* Getline variabile:: Usare @code{getline} in una variabile.
+* Getline file:: Usare @code{getline} da un file.
+* Getline variabile file:: Usare @code{getline} in una variabile da un
+ file.
+* Getline @dfn{pipe}:: Usare @code{getline} da una @dfn{pipe}.
+* Getline variabile @dfn{pipe}:: Usare @code{getline} in una variabile da una
+ @dfn{pipe}.
+* Getline coprocesso:: Usare @code{getline} da un coprocesso.
+* Getline variabile coprocesso:: Usare @code{getline} in una variabile da un
+ coprocesso.
+* Note su getline:: Cose importanti da sapere su @code{getline}.
+* Sommario di getline:: Sommario delle varianti di @code{getline}.
address@hidden menu
+
address@hidden Getline semplice
address@hidden Usare @code{getline} senza argomenti
+
+Il comando @code{getline} address@hidden essere usato senza argomenti per
leggere l'input
+dal file in input corrente. Tutto quel che fa in questo caso @`e leggere il
+record in input successivo e dividerlo in campi. Questo @`e utile se @`e
+finita l'elaborarezione del record corrente, e si vogliono fare delle
+elaborazioni particolari sul record successivo @emph{proprio adesso}.
+Per esempio:
+
address@hidden
+# rimuovere il testo tra /* e */, compresi
address@hidden
+ if ((i = index($0, "/*")) != 0) @{
+ prima = substr($0, 1, i - 1) # la parte iniziale della stringa
+ dopo = substr($0, i + 2) # ... */ ...
+ j = index(dopo, "*/") # */ @`e nella parte finale?
+ if (j > 0) @{
+ dopo = substr(dopo, j + 2) # rimozione del commento
+ @} else @{
+ while (j == 0) @{
+ # passa ai record seguenti
+ if (getline <= 0) @{
+ print("Fine file inattesa o errore:", ERRNO) > "/dev/stderr"
+ exit
+ @}
+ # incrementare la riga usando la concatenazione di stringhe
+ dopo = dopo $0
+ j = index(dopo, "*/") # @`e */ nella parte finale?
+ if (j != 0) @{
+ dopo = substr(dopo, j + 2)
+ break
+ @}
+ @}
+ @}
+ # incrementare la riga di output usando la concatenazione
+ # di stringhe
+ $0 = prima dopo
+ @}
+ print $0
address@hidden
address@hidden example
+
address@hidden 8/2014: Here is some sample input:
address@hidden
+mon/*comment*/key
+rab/*commen
+t*/bit
+horse /*comment*/more text
+part 1 /*comment*/part 2 /*comment*/part 3
+no comment
address@hidden ignore
+
+Questo programma @command{awk} cancella i commenti in stile C
+(@samp{/* @dots{} */}) dall'input.
+Usa diverse address@hidden che non sono ancora state trattate, incluse la
+concatenazione di stringhe
+(@pxref{Concatenazione})
+e le funzioni predefinite @code{index()} e @code{substr()}
+(@pxref{Funzioni per stringhe}).
+Sostituendo @samp{print $0} con altre
+istruzioni, si possono effettuare elaborazioni address@hidden complesse
sull'input
+decommentato, come ricercare corrispondenze di un'espressione regolare.
+(Questo programma ha un piccolo problema: non funziona se c'@`e address@hidden
di un
+commento che inizia e finisce
+sulla stessa riga.)
+
+Questa forma del comando @code{getline} imposta @code{NF},
address@hidden, @code{FNR}, @code{RT} e il valore di @code{$0}.
+
address@hidden NOTA
+Il nuovo valore di @code{$0} @`e usato per verificare
+le espressioni di ricerca di ogni regola successiva. Il valore originale
+di @code{$0} che ha attivato la regola che ha eseguito la @code{getline}
+viene perso.
+A differenza di @code{getline}, l'istruzione @code{next} legge un nuovo record
+ma inizia a elaborarlo normalmente, a partire dalla prima
+regola presente nel programma. @xref{Istruzione next}.
address@hidden quotation
+
address@hidden Getline variabile
address@hidden Usare @code{getline} in una variabile
address@hidden @code{getline} in una variabile
address@hidden variabili, usare in comando @code{getline}
+
+Si address@hidden usare @samp{getline @var{var}} per leggere il record
successivo
+in input ad @command{awk} nella variabile @var{var}. Non vien fatta
+nessun'altra elaborazione.
+Per esempio, supponiamo che la riga successiva sia un commento o una stringa
+particolare, e la si voglia leggere senza innescare nessuna regola. Questa
+forma di @code{getline} permette di leggere quella riga e memorizzarla in una
+variabile in modo che il ciclo principale di @command{awk} che "legge una riga
+e controlla ogni regola" non la veda affatto.
+L'esempio seguente inverte tra loro a due a due le righe in input:
+
address@hidden
address@hidden
+ if ((getline tmp) > 0) @{
+ print tmp
+ print $0
+ @} else
+ print $0
address@hidden
address@hidden example
+
address@hidden
+Prende la seguente lista:
+
address@hidden
+wan
+tew
+free
+phore
address@hidden example
+
address@hidden
+e produce questo risultato:
+
address@hidden
+tew
+wan
+phore
+free
address@hidden example
+
+Il comando @code{getline} usato in questo modo imposta solo le variabili
address@hidden, @code{FNR} e @code{RT} (e, naturalmente, @var{var}).
+Il record non viene
+suddiviso in campi, e quindi i valori dei campi (compreso @code{$0}) e
+il valore di @code{NF} non cambiano.
+
address@hidden Getline file
address@hidden Usare @code{getline} da un file
+
address@hidden @code{getline} da un file
address@hidden input, ridirezione dell'
address@hidden ridirezione dell'input
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<} (I/O)
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<} (I/O)
address@hidden operatori di input/output
+Si usa @samp{getline < @var{file}} per leggere il record successivo da
address@hidden Qui, @var{file} @`e un'espressione di tipo stringa che
+specifica il @value{FN}. @samp{< @var{file}} @`e una cosidetta
address@hidden perch@'e richiede che l'input provenga da un posto
+differente. Per esempio, il seguente programma
+legge il suo record in input dal file @file{secondary.input} quando
+trova un primo campo con un valore uguale a 10 nel file in input
+corrente:
+
address@hidden
address@hidden
+ if ($1 == 10) @{
+ getline < "secondary.input"
+ print
+ @} else
+ print
address@hidden
address@hidden example
+
+Poich@'e non viene usato il flusso principale di input, i valori di @code{NR} e
address@hidden restano immutati. Comunque, il record in input viene diviso in
+modo normale, per cui vengono cambiati i valori di @code{$0} e degli altri
+campi, producendo un nuovo valore di @code{NF}.
+Viene impostato anche @code{RT}.
+
address@hidden POSIX @command{awk}, operatore @code{<} e
address@hidden Thanks to Paul Eggert for initial wording here
+Per lo standard POSIX, @samp{getline < @var{espressione}} @`e ambiguo se
address@hidden contiene operatori che non sono all'interno di parentesi,
+ad esclusione di @samp{$}; per esempio, @samp{getline < dir "/" file} @`e
+ambiguo perch@'e l'operatore di concatenazione (non ancora trattato;
address@hidden) non @`e posto tra parentesi.
+Si dovrebbe scrivere invece @samp{getline < (dir "/" file)}, se il
+programma dev'essere portabile su tutte le implementazioni di @command{awk}.
+
address@hidden Getline variabile file
address@hidden Usare @code{getline} in una variabile da un file
address@hidden variabili, usare in comando @code{getline}
+
+Si usa @samp{getline @var{var} < @var{file}} per leggere l'input
+dal file
address@hidden, e metterlo nella variabile @var{var}. Come prima, @var{file}
address@hidden un'espressione di tipo stringa che specifica il file dal quale
+legggere.
+
+In questa versione di @code{getline}, nessuna delle variabili predefinite @`e
+cambiata e il record non @`e diviso in campi. La sola variabile cambiata @`e
address@hidden@footnote{Questo non @`e completamente vero. @code{RT}
address@hidden essere
+cambiato se @code{RS} @`e un'espressione regolare.}
+Per esempio, il seguente programma copia tutti i file in input nell'output, ad
+eccezione dei record che dicono @address@hidden@@include @var{nomefile}}}.
+Tale record @`e sostituito dal contenuto del file
address@hidden:
+
address@hidden
address@hidden
+ if (NF == 2 && $1 == "@@include") @{
+ while ((getline line < $2) > 0)
+ print line
+ close($2)
+ @} else
+ print
address@hidden
address@hidden example
+
+Si noti come il nome del file in input aggiuntivo non compaia all'interno del
+programma; @`e preso direttamente dai dati, e precisamente dal secondo campo
+della riga di @code{@@include}.
+
+La funzione @code{close()} viene chiamata per assicurarsi che se nell'input
+appaiono due righe @code{@@include} identiche, l'intero file specificato sia
+incluso ogni volta.
address@hidden file e @dfn{pipe}}.
+
+Una carenza di questo programma @`e che non gestisce istruzioni
address@hidden@@include} nidificate
+(address@hidden, istruzioni @code{@@include} contenute nei file inclusi)
+nel modo in cui ci si aspetta che funzioni un vero preelaboratore di macro.
address@hidden igawk} per un programma
+che gestisce le istruzioni @code{@@include} nidificate.
+
address@hidden Getline @dfn{pipe}
address@hidden Usare @code{getline} da una @dfn{pipe}
+
address@hidden From private email, dated October 2, 1988. Used by permission,
March 2013.
address@hidden Kernighan, Brian
address@hidden
address@hidden'onniscienza ha molti aspetti positivi.
+Se non si address@hidden ottenerla, l'attenzione ai dettagli address@hidden
aiutare.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden @code{|} (barra verticale), operatore @code{|} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|} (I/O)
address@hidden input, @dfn{pipeline}
address@hidden @dfn{pipe}, input
address@hidden operatori, input/output
+L'output di un comando address@hidden anche essere convogliato in
@code{getline}, usando
address@hidden@var{comando} | getline}. In
+questo caso, la stringa @var{comando} viene eseguita come comando di shell e
+il suo output @`e passato ad @command{awk} per essere usato come input.
+Questa forma di @code{getline} legge un record alla volta dalla @dfn{pipe}.
+Per esempio, il seguente programma copia il suo input nel suo output,
+ad eccezione delle righe che iniziano con @samp{@@execute}, che sono
+sostituite dall'output prodotto dall'esecuzione del resto della riga
+costituito da un comando di shell.
+
address@hidden
address@hidden
+ if ($1 == "@@execute") @{
+ tmp = substr($0, 10) # Rimuove "@@execute"
+ while ((tmp | getline) > 0)
+ print
+ close(tmp)
+ @} else
+ print
address@hidden
address@hidden example
+
address@hidden
+La funzione @code{close()} viene chiamata per assicurarsi che, se appaiono
+nell'input due righe @samp{@@execute} identiche, il comando sia eseguito per
+ciascuna di esse.
address@hidden
address@hidden
address@hidden file e @dfn{pipe}}.
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden This example is unrealistic, since you could just use system
+Dato l'input:
+
address@hidden
+pippo
+pluto
+paperino
+@@execute who
+gastone
address@hidden example
+
address@hidden
+il programma potrebbe produrre:
+
address@hidden Robbins, Bill
address@hidden Robbins, Miriam
address@hidden Robbins, Arnold
address@hidden
+pippo
+pluto
+paperino
+arnold ttyv0 Jul 13 14:22
+miriam ttyp0 Jul 13 14:23 (murphy:0)
+bill ttyp1 Jul 13 14:23 (murphy:0)
+gastone
address@hidden example
+
address@hidden
+Si osservi che questo programma ha eseguito @command{who} e stampato il
+risultato. (Eseguendo questo programma, @`e chiaro che ciascun utente
address@hidden
+risultati diversi, a seconda di chi @`e collegato al sistema.)
+
+Questa variante di @code{getline} divide il record in campi, imposta il valore
+di @code{NF}, e ricalcola il valore di @code{$0}. I valori di
address@hidden e @code{FNR} non vengono cambiati.
+Viene impostato @code{RT}.
+
address@hidden POSIX @command{awk}, operatore I/O @code{|} e
address@hidden Thanks to Paul Eggert for initial wording here
+Per lo standard POSIX, @address@hidden | getline} @`e ambiguo se
address@hidden contiene operatori che non sono all'interno di parentesi,
+ad esclusione di @samp{$}. Per esempio,
address@hidden@w{"echo "} "date" | getline} @`e ambiguo perch@'e
+l'operatore di concatenazione non @`e tra parentesi. Si dovrebbe scrivere
+invece @samp{(@w{"echo "} "date") | getline}, se il programma dev'essere
+portabile su tutte le implementazioni di @command{awk}.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden NOTA
+Sfortunatamente, @command{gawk} non ha un comportamento uniforme nel
+trattare un costrutto come @address@hidden"echo "} "date" | getline}.
+La maggior parte delle versioni, compresa la versione corrente, lo tratta
+come @address@hidden("echo "} "date") | getline}.
+(Questo @`e anche il comportamento di BWK @command{awk}.)
+Alcune versioni invece lo trattano come
address@hidden@w{"echo "} ("date" | getline)}.
+(Questo @`e il comportamento di @command{mawk}.)
+In breve, per evitare problemi, @`e @emph{sempre} meglio usare parentesi
+esplicite.
address@hidden quotation
+
address@hidden Getline variabile @dfn{pipe}
address@hidden Usare @code{getline} in una variabile da una @dfn{pipe}
address@hidden variabili, usare in comando @code{getline}
+
+Quando si usa @address@hidden | getline @var{var}},
+l'output di @var{comando} @`e inviato tramite una @dfn{pipe} a
address@hidden ad una variabile @var{var}. Per esempio, il
+seguente programma legge la data e l'ora corrente nella variabile
address@hidden, usando il programma di address@hidden @command{date}, e poi lo
+stampa:
+
address@hidden
+BEGIN @{
+ "date" | getline current_time
+ close("date")
+ print "Report printed on " current_time
address@hidden
address@hidden example
+
+In questa versione di @code{getline}, nessuna delle variabili predefinite @`e
+cambiata e il record non @`e diviso in campi. In ogni caso, @code{RT} viene
+impostato.
+
address@hidden
address@hidden Thanks to Paul Eggert for initial wording here
+Per lo standard POSIX, @address@hidden | getline @var{var}} @`e ambiguo
+se @var{espressione} contiene operatori che non sono all'interno di parentesi
+ad esclusione di @samp{$}; per esempio,
address@hidden@w{"echo "} "date" | getline @var{var}} @`e ambiguo
+perch@'e l'operatore di concatenazione non @`e tra parentesi. Si dovrebbe
+scrivere invece @samp{(@w{"echo "} "date") | getline @var{var}} se il
+programma dev'essere portabile su tutte le implementazioni di @command{awk}.
address@hidden ifinfo
+
address@hidden Getline coprocesso
address@hidden Usare @code{getline} da un coprocesso
address@hidden coprocessi, @code{getline} da
address@hidden @code{getline}, comando, address@hidden usare dal
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|&} (I/O)
address@hidden operatori, input/output
address@hidden differenze tra @command{awk} e @command{gawk}, operatori di
input/output
+
+Leggere dell'input in @code{getline} da una @dfn{pipe} @`e un'operazione
+unidirezionale.
+Il comando avviato con @address@hidden | getline} invia dati
address@hidden programma @command{awk}.
+
+Occasionalmente, si potrebbe avere la address@hidden di inviare dei dati a un
altro
+programma che li elabori, per poi leggere il risultato che esso genera.
address@hidden permette di avviare un @dfn{coprocesso}, col quale sono
+possibili comunicazioni bidirezionali. Questo vien fatto con l'operatore
address@hidden|&}.
+Tipicamente, dapprima si inviano dati al coprocesso e poi si leggono
+i risultati da esso prodotto, come mostrato di seguito:
+
address@hidden
+print "@var{some query}" |& "db_server"
+"db_server" |& getline
address@hidden example
+
address@hidden
+esso invia una richiesta a @command{db_server} e poi legge i risultati.
+
+I valori di @code{NR} e
address@hidden non vengono cambiati,
+perch@'e non @`e cambiato il flusso principale.
+In ogni caso, il record @`e diviso in campi
+nel solito modo, cambiando address@hidden@dotless{i}} i valori di @code{$0},
degli altri campi,
+e di @code{NF} e @code{RT}.
+
+I coprocessi sono una address@hidden avanzata. Vengono trattati qui solo
perch@'e
address@hidden
+questa @`e la
address@hidden ifnotinfo
address@hidden
+questo @`e il
address@hidden ifinfo
address@hidden su @code{getline}.
address@hidden/O bidirezionale},
+dove i coprocessi vengono trattati address@hidden dettagliatamente.
+
address@hidden Getline variabile coprocesso
address@hidden Usare @code{getline} in una variabile da un coprocesso
address@hidden variabili, usare in comando @code{getline}
+
+Quando si usa @address@hidden |& getline @var{var}}, l'output dal
+coprocesso @var{comando} viene inviato tramite una @dfn{pipe} bidirezionale a
address@hidden e nella variabile @var{var}.
+
+In questa versione di @code{getline}, nessuna delle variabili predefinite
+viene cambiata e il record non viene diviso in campi. La sola variabile che
+cambia @`e @var{var}.
+In ogni caso, @code{RT} viene impostato.
+
address@hidden
+I coprocessi sono una address@hidden avanzata. Vengono trattati qui solo
perch@'e
+questo @`e il @value{SECTION} su @code{getline}.
address@hidden/O bidirezionale},
+dove i coprocessi vengono trattati address@hidden dettagliatamente.
address@hidden ifinfo
+
address@hidden Note su getline
address@hidden Cose importanti da sapere riguardo a @code{getline}
+Qui sono elencate diverse considerazioni su @code{getline}
+da tener presenti:
+
address@hidden @value{BULLET}
address@hidden
+Quando @code{getline} cambia il valore di @code{$0} e @code{NF},
address@hidden @emph{non} salta automaticamente all'inizio del
+programma per iniziare a provare il nuovo record su ogni criterio di ricerca.
+Comunque, il nuovo record viene provato su ogni regola successiva.
+
address@hidden differenze tra @command{awk} e @command{gawk}, limitazioni di
implementazione
address@hidden implementazione, problemi, @command{gawk}, limiti
address@hidden @command{awk}, implementazioni, limiti
address@hidden @command{gawk}, problemi di implementazioni, limiti
address@hidden
+Alcune tra le prime implementazioni di @command{awk} limitano a una sola il
+numero di @dfn{pipeline} che un programma @command{awk} address@hidden tenere
aperte.
+In @command{gawk}, non c'@`e questo limite.
+Si possono aprire tante @dfn{pipeline} (e coprocessi) quante ne permette il
+sistema operativo in uso.
+
address@hidden effetti collaterali, variabile @code{FILENAME}
address@hidden @code{FILENAME}, variabile, impostare con @code{getline}
address@hidden angolo buio, variabile @code{FILENAME}
address@hidden @code{getline}, comando, variabile @code{FILENAME} e
address@hidden @code{BEGIN}, criterio di ricerca, @code{getline} e
address@hidden
+Un interessante effetto collaterale si ha se si usa @code{getline}, senza
+una ridirezione, all'interno di una regola @code{BEGIN}. Poich@'e una
address@hidden non ridiretta legge dai @value{DF} specificati nella riga di
+comando, il primo comando @code{getline} fa address@hidden@dotless{i}} che
@command{awk} imposti
+il valore di @code{FILENAME}. Normalmente, @code{FILENAME} non ha ancora un
+valore all'interno delle regole @code{BEGIN}, perch@'e non si @`e ancora
+iniziato a elaborare il
address@hidden della riga di comando.
address@hidden
+(Si veda @ref{BEGIN/END};
+e @pxref{Variabili auto-assegnate}.)
+
address@hidden
+Usare @code{FILENAME} con @code{getline}
+(@samp{getline < FILENAME})
address@hidden essere fonte di
+confusione. @command{awk} apre un flusso separato di input, diverso dal
+file in input corrente. Comunque, poich@'e non si usa una variabile,
address@hidden e @code{NF} vengono aggiornati. Se si sta facendo questo, @`e
+probabilmente per sbaglio, e si dovrebbe rivedere quello che si sta cercando
+di fare.
+
address@hidden
address@hidden
+La prossima @value{SECTION}
address@hidden ifdocbook
address@hidden
address@hidden di getline},
address@hidden ifnotdocbook
+contiene una tabella che sintetizza le
+varianti di @code{getline} e le variabili da esse modificate.
address@hidden degno di nota che le varianti che non usano la ridirezione
+possono far address@hidden@dotless{i}} che @code{FILENAME} venga aggiornato se
chiedono ad
address@hidden di iniziare a leggere un nuovo file in input.
+
address@hidden
address@hidden Moore, Duncan
+Se la variabile assegnata @`e un'espressione con effetti collaterali, versioni
+differenti di @command{awk} si comportano in modo diverso quando trovano la
+fine-del-file [EOF]. Alcune versioni non valutano l'espressione; molte
+versioni (compreso @command{gawk}) lo fanno. Si veda un esempio, gentilmente
+fornito da Duncan Moore:
+
address@hidden
+Date: Sun, 01 Apr 2012 11:49:33 +0100
+From: Duncan Moore <duncan.moore@@gmx.com>
address@hidden ignore
+
address@hidden
+BEGIN @{
+ system("echo 1 > f")
+ while ((getline a[++c] < "f") > 0) @{ @}
+ print c
address@hidden
address@hidden example
+
address@hidden
+Qui l'effetto secondario @`e @samp{++c}. Se viene trovata la fine del file
address@hidden di assegnare l'elemento @code{a}, @code{c} @`e incrementato o no?
+
address@hidden tratta @code{getline} come una chiamata di funzione, e valuta
+l'espressione @samp{a[++c]} prima di cercare di leggere da @file{f}.
+Comunque, alcune versioni di @command{awk} valutano l'espressione solo
+se c'@`e un valore di stringa da assegnare.
address@hidden itemize
+
address@hidden Sommario di getline
address@hidden Sommario delle varianti di @code{getline}
address@hidden @code{getline}, comando, varianti
+
+La @ref{tabella-varianti-getline}
+riassume le otto varianti di @code{getline},
+elencando le variabili predefinite che sono impostate da ciascuna di esse,
+e se la variante @`e standard o @`e un'estensione di @command{gawk}.
+Nota: per ogni variante, @command{gawk} imposta la variabile predefinita
address@hidden
+
address@hidden Tabella,tabella-varianti-getline
address@hidden di @code{getline} e variabili impostate da ognuna}
address@hidden @columnfractions .33 .38 .27
address@hidden Variante @tab Effetto @tab @command{awk} / @command{gawk}
address@hidden @code{getline} @tab Imposta @code{$0}, @code{NF}, @code{FNR},
@code{NR}, e @code{RT} @tab @command{awk}
address@hidden @code{getline} @var{var} @tab Imposta @var{var}, @code{FNR},
@code{NR}, e @code{RT} @tab @command{awk}
address@hidden @code{getline <} @var{file} @tab Imposta @code{$0}, @code{NF}, e
@code{RT} @tab @command{awk}
address@hidden @code{getline @var{var} < @var{file}} @tab Imposta @var{var} e
@code{RT} @tab @command{awk}
address@hidden @var{comando} @code{| getline} @tab Imposta @code{$0},
@code{NF}, e @code{RT} @tab @command{awk}
address@hidden @var{comando} @code{| getline} @var{var} @tab Imposta @var{var}
e @code{RT} @tab @command{awk}
address@hidden @var{comando} @code{|& getline} @tab Imposta @code{$0},
@code{NF}, e @code{RT} @tab @command{gawk}
address@hidden @var{comando} @code{|& getline} @var{var} @tab Imposta @var{var}
e @code{RT} @tab @command{gawk}
address@hidden multitable
address@hidden float
+
address@hidden Timeout in lettura
address@hidden Leggere input entro un tempo limite
address@hidden tempo limite, leggere input
address@hidden @dfn{timeout}, si veda tempo limite
+
address@hidden differenze tra @command{awk} e @command{gawk}, tempo limite per
lettura
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
+Si address@hidden specificare un tempo limite in millisecondi per leggere
l'input dalla
+tastiera, da una @dfn{pipe} o da una comunicazione bidirezionale, compresi i
address@hidden TCP/IP. Questo address@hidden essere fatto per input, per
comando o per
+connessione, impostando un elemento speciale nel vettore @code{PROCINFO}
+(@pxref{Variabili auto-assegnate}):
+
address@hidden
+PROCINFO["nome_input", "READ_TIMEOUT"] = @var{tempo limite in millisecondi}
address@hidden example
+
+Se @`e impostato, @command{gawk} smette di attendere una risposta e restituisce
+insuccesso se non sono disponibili dati da leggere entro il limite di tempo
+specificato. Per esempio, un cliente TCP address@hidden decidere di
abbandonare se
+non riceve alcuna risposta dal server dopo un certo periodo di tempo:
+
address@hidden
+Service = "/inet/tcp/0/localhost/daytime"
+PROCINFO[Service, "READ_TIMEOUT"] = 100
+if ((Service |& getline) > 0)
+ print $0
+else if (ERRNO != "")
+ print ERRNO
address@hidden example
+
+Qui vediamo come ottenere dati interattivamente dall'address@hidden
+presuppone che lo standard input provenga dalla tastiera.} aspettando per
+non address@hidden di cinque secondi:
+
address@hidden
+PROCINFO["/dev/stdin", "READ_TIMEOUT"] = 5000
+while ((getline < "/dev/stdin") > 0)
+ print $0
address@hidden example
+
address@hidden termina l'operazione di lettura se l'input non
+arriva entro il periodo di tempo limite, restituisce insuccesso
+e imposta @code{ERRNO} a una stringa di valore adeguato.
+Un valore del tempo limite negativo o pari a zero equivale a non specificare
+affatto un tempo limite.
+
+Si address@hidden impostare un tempo limite anche per leggere dalla tastiera
nel ciclo
+implicito che legge i record in input e li confronta coi criteri di ricerca,
+come:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ PROCINFO["-", "READ_TIMEOUT"] = 5000 @}}
+> @address@hidden print "You entered: " $0 @}'}
address@hidden
address@hidden You entered: gawk
address@hidden example
+
+In questo caso, la mancata risposta entro cinque secondi address@hidden luogo
al seguente
+messaggio di errore:
+
address@hidden
address@hidden questo @`e l'output effettivo - Antonio
address@hidden gawk: linea com.:2: (FILENAME=- FNR=1) fatale: errore leggendo
address@hidden file in input `-': Connessione scaduta
address@hidden example
+
+Il tempo limite address@hidden essere impostato o cambiato in qualsiasi
momento, e address@hidden
+effetto al tentativo successivo di leggere dal dispositivo di input. Nel
+seguente esempio, partiamo con un valore di tempo limite di un secondo e
+lo riduciamo progressivamente di un decimo di secondo finch@'e l'attesa
+per l'input diventa illimitata.
+
address@hidden
+PROCINFO[Service, "READ_TIMEOUT"] = 1000
+while ((Service |& getline) > 0) @{
+ print $0
+ PROCINFO[Service, "READ_TIMEOUT"] -= 100
address@hidden
address@hidden example
+
address@hidden NOTA
+Non si deve dare per scontato che l'operazione di lettura si blocchi
+esattamente dopo che @`e stato stampato il decimo record. @`E possibile che
address@hidden legga e tenga in memoria i dati di address@hidden di un record
+la prima volta. Per questo, cambiare il valore del tempo
+limite come nell'esempio appena visto non @`e molto utile.
address@hidden quotation
+
+Se l'elemento di @code{PROCINFO} non @`e presente e la variabile d'ambiente
address@hidden esiste,
address@hidden usa il suo valore per inizializzare il valore di tempo limite.
+L'uso esclusivo della variabile d'ambiente per specificare il tempo limite
+ha lo svantaggio di non essere
+adattabile per ogni comando o per ogni connessione.
+
address@hidden considera errore un superamento di tempo limite anche se
+il tentativo di leggere dal dispositivo sottostante potrebbe riuscire
+in un tentativo successivo. Questa @`e una limitazione, e inoltre
+significa che non @`e possibile usarlo per ottenere input multipli,
+provenienti da due o address@hidden sorgenti. @xref{Proseguire dopo errore in
input}
+per una address@hidden che consente di tentare ulteriori operazioni di I/O.
+
+Assegnare un valore di tempo limite previene un blocco a tempo indeterminato
+legato a operazioni di lettura. Si tenga address@hidden presente che ci sono
altre
+situazioni in cui @command{gawk} address@hidden restare bloccato in attesa che
un
+dispositivo di input sia pronto. Un cliente di rete a volte address@hidden
impiegare
+molto tempo per stabilire una
+connessione prima di poter iniziare a leggere qualsiasi dato,
+oppure il tentativo di aprire un file speciale FIFO in lettura address@hidden
bloccarsi
+indefinitamente in attesa che qualche altro processo lo apra in scrittura.
+
address@hidden Proseguire dopo errore in input
address@hidden Elaborare ulteriore input dopo certi errori di I/O
address@hidden proseguire dopo errore in input
address@hidden errore in input, address@hidden di proseguire
+
address@hidden differenze tra @command{awk} e @command{gawk}, proseguire dopo
errore in input
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
+
+Qualora @command{gawk} incontri un errore durante la lettura dell'input,
+per default @code{getline} ha come codice di ritorno @minus{}1, e i
+successivi tentativi di leggere dallo stesso file restituiscono una
+indicazione di fine-file. @`E tuttavia possibile chiedere a
address@hidden di consentire un ulteriore tentativo di lettura in presenza
+di certi errori, impostando uno speciale elemento del vettore
address@hidden (@pxref{Variabili auto-assegnate}):
+
address@hidden
+PROCINFO["@var{nome_input_file}", "RETRY"] = 1
address@hidden example
+
+Quando un tale elemento esiste, @command{gawk} controlla il valore della
+variabile di sistema
+(nel linguaggio C)
address@hidden quando si verifica un errore di I/O.
+Se @code{errno} indica che un ulteriore tentativo di lettura address@hidden
+terminare con successo, @code{getline} ha come codice di ritorno @minus{}2
+e ulteriori chiamate a @code{getline} possono terminare correttamente.
+Questo vale per i seguenti valori di @code{errno}: @code{EAGAIN},
address@hidden, @code{EINTR}, e @code{ETIMEDOUT}.
+
+Questa address@hidden @`e utile quando si assegna un valore all'elemento
address@hidden"@var{nome_input_file}", "READ_TIMEOUT"]} o in situazioni
+in cui un descrittore di file sia stato configurato per comportarsi in
+modo non bloccante.
+
address@hidden Directory su riga di comando
address@hidden Directory sulla riga di comando
address@hidden differenze tra @command{awk} e @command{gawk}, directory sulla
riga di comando
address@hidden directory, riga di comando
address@hidden riga di comando, directory su
+
+Per lo standard POSIX, i file che compaiono sulla riga di comando di
address@hidden devono essere file di testo; @`e un errore fatale se non lo sono.
+La maggior parte delle versioni di @command{awk} genera un errore fatale
+quando trova una directory sulla riga di comando.
+
+Per default, @command{gawk} emette un avvertimento se c'@`e una directory sulla
+riga di comando, e in ogni caso la ignora. Questo rende address@hidden facile
usare
+metacaratteri di shell col proprio programma @command{awk}:
+
address@hidden
+$ @kbd{gawk -f whizprog.awk *} @ii{Le directory potrebbero far fallire il
programma}
address@hidden example
+
+Se viene data una delle opzioni @option{--posix}
+o @option{--traditional}, @command{gawk} considera invece
+una directory sulla riga di comando come un errore fatale.
+
address@hidden di estensione Readdir} per un modo di trattare le directory
+come dati usabili da un programma @command{awk}.
+
address@hidden 2
address@hidden Sommario di Input
address@hidden Sommario di Input
+
address@hidden @value{BULLET}
address@hidden
+L'input @`e diviso in record in base al valore di @code{RS}.
+Le address@hidden sono le seguenti:
+
address@hidden @columnfractions .28 .45 .40
address@hidden Valore di @code{RS} @tab Record separati da @dots{} @tab
@command{awk} / @command{gawk}
address@hidden Un carattere singolo @tab Quel carattere @tab @command{awk}
address@hidden La stringa nulla (@code{""}) @tab Serie di due o address@hidden
ritorni a capo @tab @command{awk}
address@hidden Un'espressione regolare @tab Testo corrispondente alla
@dfn{regexp} @tab @command{gawk}
address@hidden multitable
+
address@hidden
address@hidden indica quanti record sono stati letti dal file in input corrente;
address@hidden indica quanti record sono stati letti in totale.
+
address@hidden
address@hidden imposta @code{RT} al testo individuato da @code{RS}.
+
address@hidden
+Dopo la divisione dell'input in record, @command{awk} divide
+i record in singoli campi, chiamati @code{$1}, @code{$2} e
address@hidden@dotless{i}}
+via. @code{$0} @`e l'intero record, e @code{NF} indica quanti campi
+contiene. Il metodo di default per dividere i campi utilizza i
+caratteri di spazio vuoto.
+
address@hidden Si address@hidden far riferimento ai campi usando una variabile,
come in @code{$NF}.
+Ai campi possono anche essere assegnati dei valori, e questo implica che il
+valore di @code{$0} sia ricalcolato se ad esso si fa riferimento in seguito.
+Fare un assegnamento a un campo con un numero maggiore di @code{NF} crea il
+campo e ricostruisce il record, usando @code{OFS} per separare i campi.
+Incrementare @code{NF} fa la stessa cosa. Decrementare @code{NF} scarta dei
+campi e ricostruisce il record.
+
address@hidden
+Separare i campi @`e address@hidden complicato che separare i record.
+
address@hidden @columnfractions .40 .40 .20
address@hidden Valore del separatore di campo @tab Campi separati @dots{} @tab
@command{awk} / @command{gawk}
address@hidden @code{FS == " "} @tab Da serie di spazi vuoti @tab @command{awk}
address@hidden @code{FS == @var{un solo carattere}} @tab Da quel carattere @tab
@command{awk}
address@hidden @code{FS == @var{espr. reg.}} @tab Dal testo che corrisponde
alla @dfn{regexp} @tab @command{awk}
address@hidden @code{FS == ""} @tab address@hidden@dotless{i}} ogni singolo
carattere @`e un campo separato @tab @command{gawk}
address@hidden @code{FIELDWIDTHS == @var{lista di colonne}} @tab Basata sulla
posizione del carattere @tab @command{gawk}
address@hidden @code{FPAT == @var{regexp}} @tab Dal testo attorno al testo
corrispondente alla @dfn{regexp} @tab @command{gawk}
address@hidden multitable
+
address@hidden
+Usando @samp{FS = "\n"} l'intero record address@hidden un unico campo
+(nell'ipotesi che i record siano separati da caratteri di ritorno a capo).
+
address@hidden
address@hidden address@hidden essere impostato dalla riga di comando con
l'opzione
address@hidden
+Si address@hidden fare la stessa cosa usando un assegnamento di variabile da
riga di
+comando.
+
address@hidden
address@hidden"FS"]} permette di sapere come i campi sono separati.
+
address@hidden
address@hidden nelle sue diverse forme serve per leggere record aggiuntivi
+provenienti dal flusso di input di default, da un file, o da una @dfn{pipe}
+o da un coprocesso.
+
address@hidden
address@hidden@var{file}, "READ_TIMEOUT"]} si address@hidden usare per
impostare un
+tempo limite alle operazioni di lettura da @var{file}.
+
address@hidden
+Le directory sulla riga di comando generano un errore fatale per
address@hidden standard;
address@hidden le ignora se non @`e in address@hidden POSIX.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi su Input
address@hidden Esercizi
+
address@hidden
address@hidden
+Usando la variabile @code{FIELDWIDTHS} (@pxref{Dimensione costante}),
+scrivere un programma per leggere i dati delle elezioni, dove ogni record
+rappresenta i voti di un votante. Trovare un modo per definire quali colonne
+sono associate a ogni quesito elettorale, e stampare i voti totali,
+comprese le astensioni, per ciascun quesito.
address@hidden
+La @ref{Getline semplice}, ha illustrato un programma per rimuovere i commenti
+in stile C (@samp{/* @dots{} */}) dall'input. Quel programma
+non funziona se un commento termina in una riga e il successivo commento
+inizia nella stessa riga.
+Il problema si address@hidden risolvere con una semplice modifica. Quale?
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden Stampare
address@hidden Stampare in output
+
address@hidden stampare
address@hidden output, stampare, si veda stampare
+Una delle azioni che un programma fa address@hidden comunemente, @`e quella di
produrre
address@hidden, ossia scrivere in output l'input letto, tutto o in parte.
+Si address@hidden usare l'istruzione @code{print} per una stampa semplice, e
l'istruzione
address@hidden per una formattazione dell'output address@hidden sofisticata.
+L'istruzione @code{print} non ha un limite al numero di elementi quando
+calcola @emph{quali} valori stampare. Peraltro, con due eccezioni,
+non @`e possibile specificare @emph{come} stamparli: quante
+colonne, se usare una notazione esponenziale o no, etc.
+(Per le eccezioni, @pxref{Separatori di output} e
+la @ref{OFMT}.)
+Per stampare fornendo delle specifiche, @`e necessario usare
+l'istruzione @code{printf}
+(@pxref{Printf}).
+
address@hidden istruzione @code{print}
address@hidden istruzione @code{printf}
+Oltre alla stampa semplice e formattata, questo @value{CHAPTER}
+esamina anche le ridirezioni di I/O verso file e @dfn{pipe}, introduce
+i @value{FNS} speciali che @command{gawk} elabora internamente,
+e parla della funzione predefinita @code{close()}.
+
address@hidden
+* Print:: L'istruzione @code{print}.
+* Esempi su print:: Semplici esempi di
+ istruzioni @code{print}.
+* Separatori di output:: I separatori di output e come
+ modificarli.
+* OFMT:: Controllare l'output di numeri con
+ @code{print}.
+* Printf:: l'istruzione @code{printf}.
+* Ridirezione:: Come ridirigere l'output a diversi
+ file e @dfn{pipe}.
+* FD speciali:: I/O con FD [Descrittori File]
+ speciali.
+* File speciali:: Interpretazione nomi file in
+ @command{gawk}. @command{gawk}
+ Permette di accedere a descrittori
+ file address@hidden aperti a inizio esecuzione
+* Chiusura file e @dfn{pipe}:: Chiudere file in input e di output e
+ @dfn{pipe}.
+* Continuazione dopo errori:: Abilitare continuazione dopo errori
+ in output.
+* Sommario di Output:: Sommario di Output.
+* Esercizi su Output:: Esercizi.
address@hidden menu
+
address@hidden Print
address@hidden L'istruzione @code{print}
+
+L'istruzione @code{print} si usa per produrre dell'output formattato in
+maniera semplice, standardizzata. Si
+specificano solo le stringhe o i numeri
+da stampare, in una lista separata da virgole. Questi elementi sono stampati,
+separati tra loro da spazi singoli, e alla fine viene stampato un ritorno a
+capo. L'istruzione @`e simile a questa:
+
address@hidden
+print @var{elemento1}, @var{elemento2}, @dots{}
address@hidden example
+
address@hidden
+L'intera lista di elementi address@hidden facoltativamente essere racchiusa fra
+parentesi. Le parentesi sono obbligatorie se qualche espressione presente
+in uno degli elementi usa l'operatore relazionale @samp{>}, che potrebbe
+essere confuso con una ridirezione dell'output (@pxref{Ridirezione}).
+
+Gli elementi da stampare possono essere stringhe costanti o numeri, campi
+del record corrente (come @code{$1}), variabili, o quasiasi espressione
address@hidden I valori numerici sono convertiti in stringhe prima di essere
+stampati.
+
address@hidden record, stampare
address@hidden righe, vuote, stampare
address@hidden testo, stampare
+Una semplice istruzione @samp{print} senza specificare elementi equivale a
address@hidden $0}: stampa l'intero record corrente. Per stampare una riga
+vuota, si usa @samp{print ""}.
+Per stampare un testo che non cambia, si usi come elemento una costante
+stringa, per esempio @address@hidden"Non v'allarmate"}}. Dimenticandosi di
mettere
+i doppi apici, il testo @`e preso per un'espressione @command{awk},
+e probabilmente address@hidden emesso un messaggio di errore. Occorre tener
presente
+che tra ogni coppia di elementi viene stampato uno spazio.
+
+Si noti che l'istruzione @code{print} @`e un'istruzione, e non
+un'espressione: non @`e possibile usarla nella parte modello [di ricerca] di
+un'istruzione @dfn{criterio di ricerca--azione}, per esempio.
+
address@hidden Esempi su print
address@hidden Esempi di istruzioni @code{print}
+
+Ogni istruzione @code{print} produce almeno una riga in output. Comunque,
+non @`e limitata a una sola riga. Se il valore di un elemento @`e una stringa
+che contiene un ritorno a capo, il ritorno a capo @`e stampato insieme al
+resto della stringa. Una
+singola istruzione @code{print} address@hidden in questo modo generare un
numero
+qualsiasi di righe.
+
address@hidden ritorno a capo, stampare un
+Quel che segue @`e un esempio di stampa di una stringa che contiene al suo
+interno dei
address@hidden
+ritorni a capo
+(la @samp{\n} @`e una sequenza di protezione, che si usa per rappresentare il
+carattere di ritorno a capo; @pxref{Sequenze di protezione}):
address@hidden ifinfo
address@hidden
+ritorni a capo
+(la @samp{\n} @`e una sequenza di protezione, che si usa per rappresentare il
+carattere di ritorno a capo; @pxref{Sequenze di protezione}):
address@hidden ifhtml
address@hidden
address@hidden
+ritorni a capo:
address@hidden ifnothtml
address@hidden ifnotinfo
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print "riga uno\nriga due\nriga tre" @}'}
address@hidden riga uno
address@hidden riga due
address@hidden riga tre
address@hidden example
+
address@hidden campi, stampare
+Il prossimo esempio, eseguito sul file @file{inventory-shipped},
+stampa i primi due campi di ogni record in input, separandoli con uno
+spazio:
+
address@hidden
+$ @kbd{awk '@{ print $1, $2 @}' inventory-shipped}
address@hidden Jan 13
address@hidden Feb 15
address@hidden Mar 15
address@hidden
address@hidden example
+
address@hidden istruzione @code{print}, virgole, omettere
address@hidden debug, istruzione @address@hidden omissione virgole
+Un errore frequente usando l'istruzione @code{print} @`e quello di tralasciare
+la virgola tra due elementi. Questo ha spesso come risultato la stampa di
+elementi attaccati tra loro, senza lo spazio di separazione. Il motivo per
+cui address@hidden accade @`e che la scrittura di due
+espressioni di stringa in @command{awk} ne indica la concatenazione. Qui si
+vede l'effetto dello stesso programma,
+senza le virgole:
+
address@hidden
+$ @kbd{awk '@{ print $1 $2 @}' inventory-shipped}
address@hidden Jan13
address@hidden Feb15
address@hidden Mar15
address@hidden
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, intestazioni, aggiungere
+Per chi non conosce il file @file{inventory-shipped} nessuno
+dei due output di esempio risulta molto comprensibile. Una riga iniziale di
+intestazione li renderebbe address@hidden chiari.
+Aggiungiamo qualche intestazione alla nostra tabella dei mesi
+(@code{$1}) e dei contenitori verdi spediti (@code{$2}). Lo facciamo usando
+una regola @code{BEGIN} (@pxref{BEGIN/END}) in modo che le intestazioni siano
+stampate una volta sola:
+
address@hidden
+awk 'BEGIN @{ print "Mese Contenitori"
+ print "----- -----------" @}
+ @{ print $1, $2 @}' inventory-shipped
address@hidden example
+
address@hidden
+Una volta eseguito, il programma stampa questo:
+
address@hidden
+Mese Contenitori
+----- -----------
+Jan 13
+Feb 15
+Mar 15
address@hidden
address@hidden example
+
address@hidden
+Il solo problema, in effetti, @`e che le intestazioni e i dati della tabella
+non sono allineati! Possiamo provvedere stampando alcuni spazi tra i due
+campi:
+
address@hidden
address@hidden
+awk 'BEGIN @{ print "Mese Contenitori"
+ print "----- -----------" @}
+ @{ print $1, " ", $2 @}' inventory-shipped
address@hidden group
address@hidden example
+
address@hidden istruzione @code{printf}, address@hidden allineamento
address@hidden colonne, allineamento
+Allineare le colonne in questo modo address@hidden diventare piuttosto
+complicato, quando ci sono parecchie colonne da tenere allineate. Contare gli
+spazi per due o tre colonne @`e semplice, ma oltre questo limite comincia a
+volerci molto tempo. Ecco perch@'e @`e disponibile l'istruzione @code{printf}
+(@pxref{Printf});
+una delle address@hidden che offre @`e quella di allineare colonne di dati.
+
address@hidden continuazione di riga, in istruzione @code{print}
address@hidden istruzione @code{print}, continuazione di riga e
address@hidden @code{print}, istruzione, continuazione di riga e
address@hidden NOTA
+Si address@hidden continuare su address@hidden righe sia l'istruzione
@code{print} che l'istruzione
address@hidden semplicemente mettendo un ritorno a capo dopo una virgola
+qualsiasi
+(@pxref{Istruzioni/Righe}).
address@hidden quotation
+
address@hidden Separatori di output
address@hidden I separatori di output e come modificarli
+
address@hidden variabile @code{OFS}
+Come detto sopra, un'istruzione @code{print} contiene una lista di elementi
+separati da virgole. Nell'output, gli elementi sono solitamente separati
+da spazi singoli. Non @`e detto tuttavia che debba sempre essere
address@hidden@dotless{i}}; uno
+spazio singolo @`e semplicemnte il valore di default. Qualsiasi stringa di
+caratteri address@hidden essere usata come
address@hidden di campo in output} impostando la variabile
+predefinita @code{OFS}. Il valore iniziale di questa variabile @`e
+la stringa @address@hidden" "}} (address@hidden, uno spazio singolo).
+
+L'output di un'istruzione @code{print} completa @`e detto un @dfn{record di
+output}. Ogni istruzione @code{print} stampa un record di output, e alla fine
+ci aggiunge una stringa detta @dfn{separatore record in output} (o
address@hidden). Il valore iniziale di @code{ORS} @`e la stringa @code{"\n"}
+(address@hidden, un carattere di ritorno a capo). Quindi, ogni istruzione
address@hidden normalmente genera [almeno] una riga a s@'e stante.
+
address@hidden output, record
address@hidden separatore di record in output, si veda @code{ORS}, variabile
address@hidden @code{ORS}, variabile
address@hidden @code{BEGIN}, criterio di ricerca, variabili
@code{OFS}/@code{ORS}, assegnare valori a
+Per cambiare il tipo di separazione in output di campi e record, si impostano
+valori differenti alle variabili @code{OFS} e @code{ORS}. Il posto
address@hidden
+indicato per farlo @`e nella regola @code{BEGIN}
+(@pxref{BEGIN/END}), in modo che l'assegnazione abbia effetto prima
+dell'elaborazione di ogni record in input. Questi valori si possono
+anche impostare dalla riga di comando, prima della lista dei file in input,
+oppure usando l'opzione della riga di comando @option{-v}
+(@pxref{Opzioni}).
+L'esempio seguente stampa il primo e il secondo campo di ogni record in input,
+separati da un punto e virgola, con una riga vuota aggiunta dopo ogni
+ritorno a capo:
+
+
address@hidden
+$ @kbd{awk 'BEGIN @{ OFS = ";"; ORS = "\n\n" @}}
+> @address@hidden print $1, $2 @}' mail-list}
address@hidden Amelia;555-5553
address@hidden
address@hidden Anthony;555-3412
address@hidden
address@hidden Becky;555-7685
address@hidden
address@hidden Bill;555-1675
address@hidden
address@hidden Broderick;555-0542
address@hidden
address@hidden Camilla;555-2912
address@hidden
address@hidden Fabius;555-1234
address@hidden
address@hidden Julie;555-6699
address@hidden
address@hidden Martin;555-6480
address@hidden
address@hidden Samuel;555-3430
address@hidden
address@hidden Jean-Paul;555-2127
address@hidden
address@hidden example
+
+Se il valore di @code{ORS} non contiene un ritorno a capo, l'output del
+programma viene scritto tutto su un'unica riga.
+
address@hidden OFMT
address@hidden Controllare l'output di numeri con @code{print}
address@hidden numerico, formato di output
address@hidden formati numerici di output
+Quando si stampano valori numerici con l'istruzione @code{print},
address@hidden converte internamente ogni numero in una stringa di caratteri
+e stampa quella stringa. @command{awk} usa la funzione @code{sprintf()}
+per effettuare questa conversione
+(@pxref{Funzioni per stringhe}).
+Per ora, basta dire che la funzione @code{sprintf()}
+accetta una @dfn{specifica di formato} che indica come formattare
+i numeri (o le stringhe), e che ci sono svariati modi per formattare i
+numeri. Le differenti specifiche di formato sono trattate address@hidden
+esaurientemente
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di controllo}.
+
address@hidden
address@hidden @code{OFMT}, variabile
address@hidden output, specificatore di address@hidden @code{OFMT}
+La variabile predefinita @code{OFMT} contiene la specifica di formato
+che @code{print} usa con @code{sprintf()} per convertire un numero in
+una stringa per poterla stampare.
+Il valore di default di @code{OFMT} @`e @code{"%.6g"}.
+Il modo in cui @code{print} stampa i numeri si address@hidden cambiare
+fornendo una specifica di formato differente
+per il valore di @code{OFMT}, come mostrato nell'esempio seguente:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{OFMT = "%.0f" # Stampa numeri come interi (arrotonda)}
+> @kbd{print 17.23, 17.54 @}'}
address@hidden 17 18
address@hidden example
+
address@hidden
address@hidden angolo buio, variabile @code{OFMT}
address@hidden POSIX @command{awk}, variabile @code{OFMT} e
address@hidden variabile @code{OFMT}, POSIX @command{awk} e
+Per lo standard POSIX, il comportamento di @command{awk} @`e indefinito
+se @code{OFMT} contiene qualcosa di diverso da una specifica di conversione
+di un numero a virgola mobile.
address@hidden
+
address@hidden Printf
address@hidden Usare l'istruzione @code{printf} per stampe sofisticate
+
address@hidden istruzione @code{printf}
address@hidden @code{printf}, istruzione
address@hidden output, formattato
address@hidden formattare l'output
+Per un controllo address@hidden ampio sul formato di output di quello fornito
da
address@hidden, si address@hidden usare @code{printf}.
+Con @code{printf} si address@hidden
+specificare lo spazio da utilizzare per ogni elemento, e anche le varie
+scelte di formattazione disponibile per i numeri (come la base da usare in
+output, se stampare con notazione esponenziale, se inserire un segno, e quante
+cifre stampare dopo il separatore decimale).
+
address@hidden
+* Printf Fondamenti:: Sintassi dell'istruzione
+ @code{printf}.
+* Lettere di controllo:: Lettere di controllo del formato.
+* Modificatori di formato:: Modificatori specifiche di formato.
+* Esempi su printf:: Numerosi esempi.
address@hidden menu
+
address@hidden Printf Fondamenti
address@hidden Sintassi dell'istruzione @code{printf}
+
address@hidden istruzione @code{printf}, sintassi dell'
address@hidden @code{printf}, sintassi dell'istruzione
+Una semplice istruzione @code{printf} @`e qualcosa di simile a questo:
+
address@hidden
+printf @var{formato}, @var{elemento1}, @var{elemento2}, @dots{}
address@hidden example
+
address@hidden
+Come nel caso di @code{print}, l'intera lista degli argomenti address@hidden
+facoltativamente essere racchiusa fra
+parentesi. Anche qui, le parentesi sono obbligatorie se l'espressione di
+qualche elemento usa l'operatore
+relazionale @samp{>}, che potrebbe
+essere confuso con una ridirezione dell'output (@pxref{Ridirezione}).
+
address@hidden specificatori di formato
+La differenza tra @code{printf} e @code{print} @`e l'argomento @var{formato}.
+Questo @`e un'espressione il cui valore @`e visto come una stringa;
+specifica come scrivere in output ognuno degli altri argomenti. @`E chiamata
address@hidden di formato}.
+
+La stringa di formato @`e molto simile a quella usata dalla funzione di
+libreria ISO C @code{printf()}. Buona parte del @var{formato} @`e testo da
+stampare address@hidden@dotless{i}} come @`e scritto.
+All'interno di questo testo ci sono degli @dfn{specificatori di formato},
+uno per ogni elemento da stampare.
+Ogni specificatore di formato richiede di stampare l'elemento successivo
+nella lista degli argomenti
+in quella posizione del formato.
+
+L'istruzione @code{printf} non aggiunge in automatico un ritorno a capo
+al suo output. Scrive solo quanto specificato dalla stringa di formato.
+Quindi, se serve un ritorno a capo, questo va incluso nella stringa di formato.
+Le variabili di separazione dell'output @code{OFS} e @code{ORS} non hanno
+effetto sulle istruzioni @code{printf}.
+Per esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{ORS = "\nAHI!\n"; OFS = "+"}
+> @kbd{msg = "Non v\47allarmate!"}
+> @kbd{printf "%s\n", msg}
+> @address@hidden'}
address@hidden Non v'allarmate!
address@hidden example
+
address@hidden
+Qui, n@'e il @samp{+} n@'e l'esclamazione @samp{AHI!} compaiono nel messaggio
+in output.
+
address@hidden Lettere di controllo
address@hidden Lettere di controllo del formato
address@hidden istruzione @code{printf}, lettere di controllo del formato
address@hidden @code{printf}, istruzione, lettere di controllo del formato
address@hidden specificatori di formato, istruzione @code{printf}
+
+Uno specificatore di formato inizia col carattere @samp{%} e termina con
+una @dfn{lettera di controllo del formato}; e dice all'istruzione
address@hidden come stampare un elemento. La lettera di controllo del
+formato specifica che @emph{tipo}
+di valore stampare. Il resto dello specificatore di formato @`e costituito da
address@hidden facoltativi che controllano @emph{come} stampare il valore,
+per esempio stabilendo la larghezza del campo. Ecco una lista delle
+lettere di controllo del formato:
+
address@hidden @asis for docbook to come out right
address@hidden @asis
address@hidden @code{%c}
+Stampa un numero come un carattere; quindi, @samp{printf "%c",
+65} stampa la lettera @samp{A}. L'output per un valore costituito da una
+stringa @`e il primo carattere della stringa stessa.
+
address@hidden angolo buio, caratteri di controllo del formato
address@hidden @command{gawk}, caratteri di controllo del formato
address@hidden NOTA
+Lo standard POSIX richiede che il primo carattere di una stringa sia stampato.
+In localizzazioni con caratteri multibyte, @command{gawk} tenta di
+convertire i primi byte della stringa in un carattere multibyte valido
+e poi di stampare la codifica multibyte di quel carattere.
+Analogamente, nella stampa di un valore numerico, @command{gawk} ammette che
+il valore appartenga all'intervallo numerico di valori che possono essere
+contenuti in un carattere multibyte.
+Se la conversione alla codifica multibyte non riesce, @command{gawk}
+usa gli ultimi otto bit della cifra (quelli meno significativi) come
+carattere da stampare.
+
+Altre versioni di @command{awk} generalmente si limitano a stampare
+il primo byte di una stringa o i valori numerici che possono essere
+rappresentati in un singolo byte (0--255).
address@hidden quotation
+
+
address@hidden @code{%d}, @code{%i}
+Stampa un numero intero in base decimale.
+Le due lettere di controllo sono equivalenti.
+(La specificazione @samp{%i} @`e ammessa per address@hidden con ISO C.)
+
address@hidden @code{%e}, @code{%E}
+Stampa un numero nella notazione scientifica (con uso di esponente).
+Per esempio:
+
address@hidden
+printf "%4.3e\n", 1950
address@hidden example
+
address@hidden
+stampa @samp{1.950e+03}, con un totale di quattro cifre significative, tre
+delle quali
+seguono il punto che separa la parte intera da quella decimale
+[in Italia si usa la virgola al posto del punto]
+(L'espressione @samp{4.3} rappresenta due modificatori,
+introdotti nella prossima @value{SUBSECTION}).
address@hidden usa @samp{E} invece di @samp{e} nell'output.
+
address@hidden @code{%f}
+Stampa un numero in notazione a virgola mobile.
+Per esempio:
+
address@hidden
+printf "%4.3f", 1950
address@hidden example
+
address@hidden
+stampa @samp{1950.000}, con un totale di quattro cifre significative, tre
+delle quali vengono dopo il punto decimale.
+(L'espressione @samp{4.3} rappresenta due modificatori,
+introdotti nella prossima @value{SUBSECTION}).
+
+In sistemi che implementano il formato a virgola mobile, come specificato
+dallo standard IEEE 754, il valore infinito negativo @`e rappresentato come
address@hidden o @samp{-infinity},
+e l'infinito positivo come
address@hidden o @samp{infinity}.
+Il valore speciale ``not a number'' [non @`e un numero] viene scritto come
address@hidden o @samp{nan}
+(@pxref{Definizioni matematiche}).
+
address@hidden @code{%F}
+Come @samp{%f}, ma i valori di infinito e di ``not a number'' sono scritti
+in lettere maiuscole.
+
+Il formato @samp{%F} @`e un'estensione POSIX allo standard ISO C; non tutti
+i sistemi lo prevedono. In tali casi,
address@hidden usa il formato @samp{%f}.
+
address@hidden @code{%g}, @code{%G}
+Stampa un numero usando o la notazione scientifica o quella a virgola
+mobile, scegliendo la forma address@hidden concisa; se il risultato @`e
stampato usando la
+notazione scientifica, @samp{%G} usa @samp{E} invece di @samp{e}.
+
address@hidden @code{%o}
+Stampa un numero intero in ottale, senza segno
+(@pxref{Numeri non-decimali}).
+
address@hidden @code{%s}
+Stampa una stringa.
+
address@hidden @code{%u}
+Stampa un numero intero decimale, senza segno.
+(Questo formato @`e poco usato, perch@'e tutti i numeri in @command{awk}
+sono a virgola mobile; @`e disponibile principalmente per address@hidden col
+linguaggio C.)
+
address@hidden @code{%x}, @code{%X}
+Stampa un intero esadecimale senza segno;
address@hidden usa le lettere da @samp{A} a @samp{F}
+invece che da @samp{a} a @samp{f}
+(@pxref{Numeri non-decimali}).
+
address@hidden @code{%%}
+Stampa un solo carattere @samp{%}.
+Questa notazione non serve per stampare alcun
+argomento e ignora eventuali modificatori.
address@hidden table
+
address@hidden angolo buio, caratteri di controllo del formato
address@hidden @command{gawk}, caratteri di controllo del formato
address@hidden NOTA
+Quando si usano lettere di controllo del formato per numeri interi
+per stampare valori esterni all'intervallo massimo disponibile nel
+linguaggio C per i numeri interi,
address@hidden usa lo
+specificatore di formato @samp{%g}. Se si specifica l'opzione @option{--lint}
+sulla riga di comando (@pxref{Opzioni}), @command{gawk}
+emette un messaggio di avvertimento. Altre versioni di @command{awk} possono
+stampare valori non validi, o comportarsi in modo completamente differente.
address@hidden
address@hidden quotation
+
address@hidden Modificatori di formato
address@hidden Modificatori per specifiche di formato @code{printf}
+
address@hidden istruzione @code{printf}, modificatori
address@hidden @code{printf}, istruzione, modificatori
address@hidden address@hidden in specificatori di formato
+Una specifica di formato address@hidden anche includere dei @dfn{modificatori}
che
+possono controllare che parte stampare del valore dell'elemento, e anche
+quanto spazio utilizzare per stamparlo.
+I modificatori sono posizionati tra il @samp{%} e la lettera che controlla
+il formato.
+Negli esempi seguenti address@hidden usato il simbolo del punto elenco
address@hidden'' per
+rappresentare
+spazi nell'output. Questi sono i modificatori previsti, nell'ordine in
+cui possono apparire:
+
address@hidden @asis
address@hidden differenze tra @command{awk} e @command{gawk}, tra istruzioni
@code{print} e @code{printf}
address@hidden istruzione @code{printf}, specificatori posizionali
address@hidden @code{printf}, istruzione, specificatori posizionali
address@hidden the code{} does NOT start a secondary
address@hidden specificatori posizionali, istruzione @code{printf}
address@hidden @address@hidden
+Una costante intera seguita da un @samp{$} @`e uno @dfn{specificatore
posizionale}.
+Normalmente, le specifiche di formato sono applicate agli argomenti
+nell'ordine in cui appaiono nella stringa di formato. Con uno specificatore
+posizionale, la specifica di formato @`e applicata a un argomento
+indicato per numero, invece che a quello che
+sarebbe il prossimo argomento nella lista. Gli specificatori posizionali
+iniziano a contare partendo da uno. Quindi:
+
address@hidden
+printf "%s %s\n", "Non", "v'allarmate"
+printf "%2$s %1$s\n", "v'allarmate", "Non"
address@hidden example
+
address@hidden
+stampa per due volte il famoso consiglio amichevole.
+
+A prima vista, questa address@hidden non sembra di grande address@hidden
+Si tratta in effetti di un'estensione @command{gawk}, pensata per essere
+usata nella traduzione di messaggi emessi in fase di esecuzione.
address@hidden di printf},
+che descrive come e perch@'e usare specificatori posizionali.
+Per ora li possiamo ignorare.
+
address@hidden - @code{-} (Segno meno)
+Il segno meno, usato prima del modificatore di larghezza (si veda
address@hidden avanti
+in questa lista),
+richiede di allineare a sinistra
+l'argomento mantenendo la larghezza specificata. Normalmente, l'argomento
address@hidden stampato allineato a destra, con la larghezza specificata.
Quindi:
+
address@hidden
+printf "%-6s", "pippo"
address@hidden example
+
address@hidden
+stampa @address@hidden
+
address@hidden @var{spazio}
+Applicabile a conversioni numeriche, richiede di inserire uno spazio prima
+dei valori positivi e un segno meno prima di quelli negativi.
+
address@hidden @code{+}
+Il segno address@hidden, usato prima del modificatore di larghezza (si veda
address@hidden avanti
+in questa lista),
+richiede di mettere sempre un segno nelle conversioni numeriche, anche se
+il dato da formattare ha valore positivo. Il @samp{+} prevale sul
+modificatore @dfn{spazio}.
+
address@hidden @code{#}
+Richiede di usare una ``forma alternativa'' per alcune lettere di controllo.
+Per @samp{%o}, preporre uno zero.
+Per @samp{%x} e @samp{%X}, preporre @samp{0x} o @samp{0X} se il
+numero @`e diverso da zero.
+Per @samp{%e}, @samp{%E}, @samp{%f}, e @samp{%F}, il risultato deve contenere
+sempre un separatore decimale.
+Per @code{%g} e @code{%G}, gli zeri finali non significativi non sono
+tolti dal numero stampato.
+
address@hidden @code{0}
+Uno @samp{0} (zero) iniziale serve a richiedere che l'output sia
+riempito con zeri (invece che con spazi), prima delle cifre significative.
+Questo si applica solo ai formati di output di tipo numerico.
+Questo @dfn{flag} ha un effetto solo se la larghezza del campo @`e maggiore
+di quella del valore da stampare.
+
address@hidden @code{'}
+Un carattere di apice singolo o un apostrofo @`e un'estensione POSIX allo
+standard ISO C.
+Indica che la parte intera di un valore a virgola mobile, o la parte intera
+di un valore decimale intero, ha un carattere di separazione delle migliaia.
address@hidden @`e applicabile solo alle localizzazioni che prevedono un tale
carattere.
+Per esempio:
+
address@hidden
+$ @kbd{cat migliaia.awk} @ii{Visualizza il programma sorgente}
address@hidden BEGIN @{ printf "%'d\n", 1234567 @}
+$ @kbd{LC_ALL=C gawk -f migliaia.awk}
address@hidden 1234567 @ii{Risultato nella localizzazione} "C"
+$ @kbd{LC_ALL=en_US.UTF-8 gawk -f migliaia.awk}
address@hidden 1,234,567 @ii{Risultato nella localizzazione UTF inglese
americana}
address@hidden example
+
address@hidden
+Per maggiori informazioni relative a localizzazioni e internazionalizzazioni,
+si veda @ref{Localizzazioni}.
+
address@hidden NOTA
+Il @dfn{flag} @samp{'} @`e una address@hidden interessante, ma utilizza un
+carattere che @`e fonte di complicazioni, perch@'e risulta difficila da usare
nei
+programmi scritti direttamente sulla riga di comando. Per informazioni sui
+metodi appropriati per gestire la cosa, si veda @ref{Protezione}.
address@hidden quotation
+
address@hidden @var{larghezza}
+Questo @`e un numero che specifica la larghezza minima che deve occupare un
+campo. L'inserimento di un numero tra il segno @samp{%} e il carattere
+di controllo del formato fa address@hidden@dotless{i}} che il campo si espanda
a quella larghezza.
+Il modo di default per fare questo @`e di aggiungere degli spazi a
+sinistra. Per esempio:
+
address@hidden
+printf "%6s", "pippo"
address@hidden example
+
address@hidden
+stampa @address@hidden
+
+il valore di @var{larghezza} indica la larghezza minima, non la massima. Se
+il valore dell'elemento richiede address@hidden caratteri della @var{larghezza}
+specificata, questa address@hidden essere aumentata secondo address@hidden
+Quindi, per esempio:
+
address@hidden
+printf "%6s", "pippo-pluto"
address@hidden example
+
address@hidden
+stampa @samp{pippo-pluto}.
+
+Anteponendo un segno meno alla @var{larghezza} si richiede che l'output sia
+esteso con spazi a destra, invece che a sinistra.
+
address@hidden @address@hidden
+Un punto, seguito da una costante intera
+specifica la precisione da usare nella stampa.
+Il tipo di precisione varia a seconda della lettera di controllo:
+
address@hidden @asis
address@hidden @code{%d}, @code{%i}, @code{%o}, @code{%u}, @code{%x}, @code{%X}
+Minimo numero di cifre da stampare.
+
address@hidden @code{%e}, @code{%E}, @code{%f}, @code{%F}
+Numero di cifre alla destra del separatore decimale.
+
address@hidden @code{%g}, @code{%G}
+Massimo numero di cifre significative.
+
address@hidden @code{%s}
+Massimo numero di caratteri della stringa che possono essere stampati.
address@hidden table
+
+Quindi, l'istruzione:
+
address@hidden
+printf "%.4s", "foobar"
address@hidden example
+
address@hidden
+stampa @samp{foob}.
address@hidden table
+
+Le address@hidden di @var{larghezza} e @var{precisione} dinamiche
(address@hidden,
address@hidden"%*.*s"}) disponibili nell'istruzione @code{printf} della
libreria C sono
+utilizzabili.
+Invece che fornire esplicitamente una @var{larghezza} e/o una @var{precisione}
+nella stringa di formato, queste sono fornite come parte della lista degli
+argomenti. Per esempio:
+
address@hidden
+w = 5
+p = 3
+s = "abcdefg"
+printf "%*.*s\n", w, p, s
address@hidden example
+
address@hidden
+equivale esattamente a:
+
address@hidden
+s = "abcdefg"
+printf "%5.3s\n", s
address@hidden example
+
address@hidden
+Entrambi i programmi stampano @address@hidden@address@hidden
+Versioni address@hidden datate di @command{awk} non consentivano questa
address@hidden
+Dovendo usare una di queste versioni, @`e possibile simulare questa
address@hidden usando la concatenazione per costruire una stringa di formato,
+come per esempio:
+
address@hidden
+w = 5
+p = 3
+s = "abcdefg"
+printf "%" w "." p "s\n", s
address@hidden example
+
address@hidden
+Questo codice non @`e di facile lettura, ma funziona.
+
address@hidden @cindex controlli @command @{lint}
address@hidden debug, errori fatali, @code{printf}, stringhe di formato
address@hidden POSIX @command{awk}, stringhe di formato @code{printf} e
+Chi programma in C probabilmente @`e abituato a specificare modificatori
+addizionali (@samp{h}, @samp{j}, @samp{l}, @samp{L}, @samp{t} e @samp{z}) nelle
+stringhe di formato di @code{printf}. Questi modificatori non sono validi
+in @command{awk}. La maggior parte della implementazioni di @command{awk} li
+ignora senza emettere messaggi. Se si specifica l'opzione @option{--lint}
+sulla riga di comando (@pxref{Opzioni}), @command{gawk} emette un messaggio
+di avvertimento quando li si usa. Se si specifica l'opzione @option{--posix},
+il loro uso genera un errore fatale.
+
address@hidden Esempi su printf
address@hidden Esempi d'uso di @code{printf}
+
+Il seguente semplice esempio mostra
+come usare @code{printf} per preparare una tabella allineata:
+
address@hidden
+awk '@{ printf "%-10s %s\n", $1, $2 @}' mail-list
address@hidden example
+
address@hidden
+Questo comando
+stampa i nomi delle persone (@code{$1}) nel file
address@hidden come una stringa di 10 caratteri allineati a sinistra.
+Stampa anche i numeri telefonici (@code{$2}) a fianco, sulla stessa riga.
+Il risultato @`e una tabella allineata, contenente due colonne, di nomi e
numeri
+telefonici, come si address@hidden vedere qui:
+
address@hidden
+$ @kbd{awk '@{ printf "%-10s %s\n", $1, $2 @}' mail-list}
address@hidden Amelia 555-5553
address@hidden Anthony 555-3412
address@hidden Becky 555-7685
address@hidden Bill 555-1675
address@hidden Broderick 555-0542
address@hidden Camilla 555-2912
address@hidden Fabius 555-1234
address@hidden Julie 555-6699
address@hidden Martin 555-6480
address@hidden Samuel 555-3430
address@hidden Jean-Paul 555-2127
address@hidden example
+
+In questo caso, i numeri telefonici debbono essere stampati come stringhe,
+poich@'e includono un trattino. Una stampa dei numeri telefonici come numeri
+semplici avrebbe visualizzato solo le prime tre cifre: @samp{555},
+e questo non sarebbe stato di grande address@hidden
+
+Non era necessario specificare una larghezza per i numeri telefonici poich@'e
+sono nell'ultima colonnna di ogni riga. Non c'@`e bisogno di avere un
+allineamento di spazi dopo di loro.
+
+La tabella avrebbe potuto essere resa address@hidden leggibile aggiungendo
+intestazioni in cima
+alle colonne. Questo si address@hidden fare usando una regola @code{BEGIN}
+(@pxref{BEGIN/END})
+in modo che le intestazioni siano stampate una sola volta, all'inizio del
+programma @command{awk}:
+
address@hidden
+awk 'BEGIN @{ print "Nome Numero"
+ print "---- ------" @}
+ @{ printf "%-10s %s\n", $1, $2 @}' mail-list
address@hidden example
+
+L'esempio precedente usa sia l'istruzione @code{print} che l'istruzione
address@hidden nello stesso programma. Si possono ottenere gli stessi
+risultati usando solo istruzioni @code{printf}:
+
address@hidden
+awk 'BEGIN @{ printf "%-10s %s\n", "Nome", "Numero"
+ printf "%-10s %s\n", "----", "------" @}
+ @{ printf "%-10s %s\n", $1, $2 @}' mail-list
address@hidden example
+
address@hidden
+Stampare ogni intestazione di colonna con la stessa specifica di formato
+usata per gli elementi delle colonne ci address@hidden la certezza che le
intestazioni
+sono allineate esattamente come le colonne.
+
+Il fatto che usiamo per tre volte la stessa specifica di formato si
address@hidden
+evidenziare memorizzandola in una variabile, address@hidden@dotless{i}}:
+
address@hidden
+awk 'BEGIN @{ format = "%-10s %s\n"
+ printf format, "Nome", "Numero"
+ printf format, "----", "------" @}
+ @{ printf format, $1, $2 @}' mail-list
address@hidden example
+
+
address@hidden Ridirezione
address@hidden Ridirigere l'output di @code{print} e @code{printf}
+
address@hidden output, ridirezione
address@hidden ridirezione dell'output
address@hidden @option{--sandbox}, opzione, ridirezione dell'output con
@code{print}, @code{printf}
+Finora, l'output di @code{print} e @code{printf} @`e stato diretto
+verso lo standard output,
+che di solito @`e lo schermo. Sia @code{print} che @code{printf} possono
+anche inviare il loro output in altre direzioni.
address@hidden quel che si chiama @dfn{ridirezione}.
+
address@hidden NOTA
+Quando si specifica @option{--sandbox} (@pxref{Opzioni}),
+la ridirezione dell'output verso file, @dfn{pipe} e coprocessi non @`e
+consentita.
address@hidden quotation
+
+Una ridirezione @`e posta dopo l'istruzione @code{print} o @code{printf}.
+Le ridirezioni in @command{awk} sono scritte come le ridirezioni nei
+comandi della shell, l'unica differenza @`e che si trovano all'interno di
+un programma @command{awk}.
+
address@hidden the commas here are part of the see also
address@hidden istruzione @code{print}, si veda anche ridirezione dell'output
address@hidden istruzione @code{printf}, si veda anche ridirezione dell'output
+Ci sono quattro forme di ridirezione dell'output:
+output scritto su un file,
+output aggiunto in fondo a un file,
+output che fa da input a un altro comando (usando una @dfn{pipe}) e
+output diretto a un coprocesso.
+Vengono descritti per l'istruzione @code{print},
+ma funzionano allo stesso modo per @code{printf}:
+
address@hidden @code
address@hidden @code{>} (parentesi acuta destra), operatore @code{>} (I/O)
address@hidden parentesi acuta destra (@code{>}), operatore @code{>} (I/O)
address@hidden operatori, input/output
address@hidden print @var{elementi} > @var{output-file}
+Questa ridirezione stampa gli elementi nel file di output chiamato
address@hidden Il @value{FN} @var{output-file} address@hidden essere
+una qualsiasi espressione. Il suo valore @`e trasformato in una stringa e
+quindi usato come
address@hidden
address@hidden (@pxrefil{Espressioni}).
address@hidden iftex
address@hidden
address@hidden (@pxref{Espressioni}).
address@hidden ifnottex
+Quando si usa questo tipo di ridirezione, il file @var{output-file} viene
+cancellato prima che su di esso sia stato scritto il primo record in uscita.
+Le successive scritture verso lo stesso file @var{output-file} non cancellano
address@hidden, ma continuano ad aggiungervi record.
+(Questo comportamento @`e differente da quello delle ridirezioni usate negli
+script della shell.)
+Se @var{output-file} non esiste, viene creato. Per esempio, ecco
+come un programma @command{awk} address@hidden scrivere una lista di nomi di
persone
+su un file di nome @file{lista-nomi}, e una lista di numeri telefonici
+su un altro file di nome @file{lista-telefoni}:
+
address@hidden
+$ @kbd{awk '@{ print $2 > "lista-telefoni"}
+> @kbd{print $1 > "lista-nomi" @}' mail-list}
+$ @kbd{cat lista-telefoni}
address@hidden 555-5553
address@hidden 555-3412
address@hidden
+$ @kbd{cat lista-nomi}
address@hidden Amelia
address@hidden Anthony
address@hidden
address@hidden example
+
address@hidden
+Ogni file in output contiene un nome o un numero su ogni riga.
+
address@hidden @code{>} (parentesi acuta destra), operatore @code{>>} (I/O)
address@hidden parentesi acuta destra (@code{>}), operatore @code{>>} (I/O)
address@hidden print @var{elementi} >> @var{output-file}
+Questa ridirezione stampa gli elementi in un file di output preesistente,
+di nome @var{output-file}. La differenza tra questa ridirezione e quella
+con un solo @samp{>} @`e che il precedente contenuto (se esiste) di
address@hidden non viene cancellato. Invece, l'output di @command{awk} @`e
+aggiunto in fondo al file.
+Se @var{output-file} non esiste, viene creato.
+
address@hidden @code{|} (barra verticale), operatore @code{|} (I/O)
address@hidden @dfn{pipe}, output
address@hidden output, a @dfn{pipe}
address@hidden print @var{elementi} | @var{comando}
address@hidden possibile inviare output a un altro programma usando una
@dfn{pipe}
+invece di inviarlo a un file. Questa ridirezione apre una @dfn{pipe} verso
address@hidden, e invia i valori di @var{elementi}, tramite questa
address@hidden, a un altro processo creato per eseguire @var{comando}.
+
+L'argomento @var{comando}, verso cui @`e rivolta la ridirezione, @`e in
address@hidden
+un'espressione
address@hidden Il suo valore @`e convertito in una stringa il cui contenuto
+costituisce un comando della shell che deve essere eseguito. Per esempio,
+il seguente programma produce due file, una lista non ordinata di nomi di
+persone e una lista ordinata in ordine alfabetico inverso:
+
address@hidden
+10/2000:
+This isn't the best style, since COMMAND is assigned for each
+record. It's done to avoid overfull hboxes in TeX. Leave it
+alone for now and let's hope no-one notices.
address@hidden ignore
+
address@hidden
+awk '@{ print $1 > "nomi.non.ordinati"
+ comando = "sort -r > nomi.ordinati"
+ print $1 | comando @}' mail-list
address@hidden example
+
+La lista non ordinata @`e scritta usando una ridirezione normale, mentre
+la lista ordinata @`e scritta inviando una @dfn{pipe} in input al programma
+di address@hidden @command{sort}.
+
+Il prossimo esempio usa la ridirezione per inviare un messaggio alla
+mailing list @code{bug-sistema}. Questo address@hidden tornare utile se si
hanno
+problemi con uno script @command{awk} eseguito periodicamente per la
+manutenzione del sistema:
+
address@hidden
+report = "mail bug-sistema"
+print("Script awk in errore:", $0) | report
+print("al record numero", FNR, "di", NOME_FILE) | report
+close(report)
address@hidden example
+
+La funzione @code{close()} @`e stata chiamata perch@'e @`e una buona idea
chiudere
+la @dfn{pipe} non appena tutto l'output da inviare alla @dfn{pipe} @`e stato
+inviato. @xref{Chiusura file e @dfn{pipe}}
+per maggiori informazioni.
+
+Questo esempio illustra anche l'uso di una variabile per rappresentare
+un @var{file} o un @var{comando}; non @`e necessario usare sempre
+una costante stringa. Usare una variabile @`e di solito una buona idea,
+perch@'e (se si vuole riusare lo stesso file o comando)
address@hidden richiede che il valore della stringa sia sempre scritto
+esattamente nello stesso modo.
+
address@hidden coprocessi
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden operatori, input/output
address@hidden differenze tra @command{awk} e @command{gawk}, operatori di
input/output
address@hidden print @var{elementi} |& @var{comando}
+Questa ridirezione stampa gli elementi nell'input di @var{comando}.
+La differenza tra questa ridirezione e quella
+con la sola @samp{|} @`e che l'output da @var{comando}
address@hidden essere letto tramite @code{getline}.
+Quindi, @var{comando} @`e un @dfn{coprocesso}, che lavora in parallelo al
+programma @command{awk}, ma @`e al suo servizio.
+
+Questa address@hidden @`e un'estensione @command{gawk}, e non @`e disponibile
in
+POSIX @command{awk}.
address@hidden
address@hidden coprocesso},
+per una breve spiegazione.
address@hidden/O bidirezionale}
+per un'esposizione address@hidden esauriente.
address@hidden ifnotdocbook
address@hidden
address@hidden coprocesso}
+per una breve spiegazione.
address@hidden/O bidirezionale}
+per un'esposizione address@hidden esauriente.
address@hidden ifdocbook
address@hidden table
+
+Ridirigere l'output usando @samp{>}, @samp{>>}, @samp{|} o @samp{|&}
+richiede al sistema di aprire un file, una @dfn{pipe} o un coprocesso solo se
+il particolare @var{file} o @var{comando} che si @`e specificato non @`e
address@hidden
+stato utilizzato in scrittura dal programma o se @`e stato chiuso
+dopo l'ultima scrittura.
+
address@hidden debug, stampare
address@hidden un errore comune usare la ridirezione @samp{>} per la prima
istruzione
address@hidden verso un file, e in seguito usare @samp{>>} per le successive
+scritture in output:
+
address@hidden
+# inizializza il file
+print "Non v'allarmate" > "guida.txt"
address@hidden
+# aggiungi in fondo al file
+print "Evitate generatori di address@hidden" >> "guide.txt"
address@hidden example
+
address@hidden
+Questo @`e il modo in cui le ridirezioni devono essere usate lavorando
+con la shell. Ma in @command{awk} address@hidden non @`e necessario. In casi
di questo
+genere, un programma dovrebbe
+usare @samp{>} per tutte le istruzioni @code{print}, perch@'e il file di
+output @`e aperto una sola volta.
+(Usando sia @samp{>} che @samp{>>} nello stesso programma, l'output @`e
prodotto
+nell'ordine atteso.
+Tuttavia il mischiare gli operatori per lo stesso file @`e sintomo di uno
+stile di programmazione inelegante, e address@hidden causare confusione in chi
legge
+il programma.)
+
address@hidden differenze tra @command{awk} e @command{gawk}, limitazioni di
implementazione
address@hidden problemi di implementazione, @command{gawk}, limitazioni
address@hidden @command{awk}, problemi di implementazione, @dfn{pipe}
address@hidden @command{gawk}, problemi di implementazione, @dfn{pipe}
address@hidden
+Come visto in precedenza
+(@pxref{Note su getline}),
+molte
address@hidden ifnotinfo
address@hidden
address@hidden
address@hidden
+Molte
address@hidden ifnothtml
address@hidden ifnotdocbook
address@hidden ifnottex
+tra le address@hidden vecchie implementazioni di
address@hidden limitano il numero di @dfn{pipeline} che un programma
address@hidden address@hidden mantenere aperte a una soltanto! In
@command{gawk}, non c'@`e
+un tale limite. @command{gawk} consente a un programma di
+aprire tante @dfn{pipeline} quante ne consente il sistema operativo su cui
+viene eseguito.
+
address@hidden Inviare @dfn{pipe} alla @command{sh}
address@hidden shell, inviare comandi tramite @dfn{pipe} alla
+
+Una maniera particolarmente efficace di usare la ridirezione @`e quella di
+preparare righe di comando da passare
+come @dfn{pipe} alla shell,
address@hidden Per esempio, si supponga di avere una lista di file provenienti
+da un sistema in cui tutti i
address@hidden sono memorizzari in maiuscolo, e di volerli rinominare
+in modo da avere nomi tutti in
+minuscolo. Il seguente programma @`e
+sia semplice che efficiente:
+
address@hidden @cindex @command{mv} utility
address@hidden
address@hidden printf("mv %s %s\n", $0, tolower($0)) | "sh" @}
+
+END @{ close("sh") @}
address@hidden example
+
+La funzione @code{tolower()} restituisce la stringa che gli viene passata
+come argomento con tutti i caratteri maiuscoli convertiti in minuscolo
+(@pxref{Funzioni per stringhe}).
+Il programma costruisce una lista di righe di comando,
+usando il programma di address@hidden @command{mv} per rinominare i file.
+Poi invia la lista alla shell per l'elaborazione.
+
address@hidden alla shell} per una funzione che address@hidden essere utile nel
generare
+righe di comando da passare alla shell.
address@hidden sidebar
+
address@hidden FD speciali
address@hidden File speciali per flussi standard di dati pre-aperti
address@hidden standard input
address@hidden input, standard
address@hidden standard output
address@hidden output, standard
address@hidden errore, output
address@hidden standard error
address@hidden descrittori di file
address@hidden file, descrittori, si veda descrittori di file
+
+I programmi in esecuzione hanno convenzionalmente tre flussi di input e
+output a disposizione, address@hidden aperti per la lettura e la scrittura.
+Questi sono noti come
+lo @dfn{standard input}, lo @dfn{standard output} e lo @dfn{standard
+error output}. A questi flussi aperti (e a tutti gli altri file aperti o
address@hidden) si fa spesso riferimento usando il termine tecnico
address@hidden di file} [FD].
+
+Questi flussi sono, per default, associati alla tastiera e allo schermo,
+ma spesso sono ridiretti, nella shell, utilizzando gli operatori
address@hidden<}, @samp{<<}, @samp{>}, @samp{>>}, @samp{>&} e @samp{|}.
+Lo standard error @`e tipicamente usato per scrivere messaggi di errore;
+la ragione per cui ci sono due flussi distinti,
+standard output e standard error, @`e per poterli ridirigere indipendentemente
+l'uno dall'altro.
+
address@hidden differenze tra @command{awk} e @command{gawk}, messaggi di errore
address@hidden gestione errori
address@hidden errori, gestione degli
+Nelle tradizionali implementazioni di @command{awk}, il solo modo per
+scrivere un messaggio di errore allo
+standard error in un programma @command{awk} @`e il seguente:
+
address@hidden
+print "Ho trovato un errore grave!" | "cat 1>&2"
address@hidden example
+
address@hidden
+Con quest'istruzione si apre una @dfn{pipeline} verso un comando della shell
+che @`e in grado di accedere al flusso di standard error che eredita dal
+processo @command{awk}.
address@hidden 8/2014: Mike Brennan says not to cite this as inefficient. So,
fixed.
+Questo @`e molto poco elegante, e richiede anche di innescare un processo
+separato. Per questo chi scrive programmi @command{awk} spesso
+non usa questo metodo. Invece, invia i messaggi di errore allo
+schermo, in questo modo:
+
address@hidden
+print "Ho trovato un errore grave!" > "/dev/tty"
address@hidden example
+
address@hidden
+(@file{/dev/tty} @`e un file speciale fornito dal sistema operativo
+ed @`e connesso alla tastiera e allo schermo. Rappresenta il
+``terminale'',@footnote{``tty'' in @file{/dev/tty} @`e un'abbreviazione di
+``TeleTYpe'' [telescrivente], un terminale seriale.} che nei sistemi odierni
address@hidden una tastiera e uno schermo, e non una @dfn{console} seriale).
+Questo ha generalmente lo stesso effetto, ma non @`e sempre detto: sebbene il
+flusso di standard error sia solitamente diretto allo schermo, potrebbe
+essere stato
+ridiretto; se questo @`e il caso, scrivere verso lo schermo non serve. In
+effetti, se @command{awk} @`e chiamato da un lavoro che non @`e eseguito
+interattivamente,
address@hidden non avere a disposizione alcun terminale su cui scrivere.
+In quel caso, l'apertura di @file{/dev/tty} genera un errore.
+
address@hidden, BWK @command{awk}, e @command{mawk} mettono a disposizione
+speciali @value{FNS} per accedere ai tre flussi standard.
+Se il @value{FN} coincide con uno di questi nomi speciali, quando
address@hidden (o uno degli altri) ridirige l'input o l'output, usa
+direttamente il descrittore di file identificato dal @value{FN}. Questi
address@hidden sono gestiti address@hidden@dotless{i}} in tutti i sistemi
operativi nei quali
address@hidden @`e disponibile, e non solo in quelli che aderiscono allo
+standard POSIX:
+
address@hidden estensioni comuni, file speciale @code{/dev/stdin}
address@hidden estensioni comuni, file speciale @code{/dev/stdout}
address@hidden estensioni comuni, file speciale @code{/dev/stderr}
address@hidden @cindex comuni, address@hidden file speciale @code{/dev/stdin}
address@hidden @cindex comuni, address@hidden file speciale @code{/dev/stdout}
address@hidden @cindex comuni, address@hidden file speciale @code{/dev/stderr}
address@hidden nomi di file, flussi standard in @command{gawk}
address@hidden @code{/dev/@dots{}}, file speciali
address@hidden file, file speciali @code{/dev/@dots{}}
address@hidden @code{/dev/fd/@var{N}}, file speciali (in @command{gawk})
address@hidden @file
address@hidden /dev/stdin
+Lo standard input (descrittore di file 0).
+
address@hidden /dev/stdout
+Lo standard output (descrittore di file 1).
+
address@hidden /dev/stderr
+Lo standard error output (descrittore di file 2).
address@hidden table
+
+Usando questa address@hidden
+la maniera corretta di scrivere un messaggio di errore diviene quindi:
+
address@hidden
+print "Ho trovato un errore grave!" > "/dev/stderr"
address@hidden example
+
address@hidden debug, doppio apice con nomi di file
+Si noti l'uso di doppi apici per racchiudere il @value{FN}.
+Come per ogni altra ridirezione, il valore dev'essere una stringa.
address@hidden un errore comune omettere i doppi apici, il che conduce a
+risultati inattesi.
+
address@hidden non tratta questi @value{FNS} come speciali quando opera
+in address@hidden di address@hidden POSIX. Comunque, poich@'e BWK
@command{awk}
+li prevede, @command{gawk} li ammette anche quando viene
+invocato con l'opzione @option{--traditional} (@pxref{Opzioni}).
+
address@hidden File speciali
address@hidden @value{FFNS} speciali in @command{gawk}
address@hidden @command{gawk}, nomi di file in
+
+Oltre all'accesso a standard input, standard output e standard error,
address@hidden consente di accedere a ogni descrittore di file aperto.
+In address@hidden, ci sono dei @value{FNS} speciali riservati per accedere a
+reti TCP/IP.
+
address@hidden
+* Altri file ereditati:: Accedere ad altri file aperti con
+ @command{gawk}.
+* Reti speciali:: File speciali per comunicazioni con la rete.
+* Avvertimenti speciali:: Cose a cui prestare attenzione.
address@hidden menu
+
address@hidden Altri file ereditati
address@hidden Accedere ad altri file aperti con @command{gawk}
+
+Oltre ai valori speciali di @value{FNS}
address@hidden/dev/stdin}, @code{/dev/stdout} e @code{/dev/stderr}
address@hidden menzionati, @command{gawk} prevede una sintassi
+per accedere a ogni altro file aperto ereditato:
+
address@hidden @file
address@hidden /dev/fd/@var{N}
+Il file associato al descrittore di file @var{N}. Il file indicato deve
+essere aperto dal programma che inizia l'esecuzione di @command{awk}
+(tipicamente la shell). Se non sono state poste in essere iniziative
+speciali nella shell da cui @command{gawk} @`e stato invocato, solo i
+descrittori 0, 1, e 2 sono disponibili.
address@hidden table
+
+I @value{FNS} @file{/dev/stdin}, @file{/dev/stdout} e @file{/dev/stderr}
+sono essenzialmente alias per @file{/dev/fd/0}, @file{/dev/fd/1} e
address@hidden/dev/fd/2}, rispettivamente. Comunque, i primi nomi sono
address@hidden
+autoesplicativi.
+
+Si noti che l'uso di @code{close()} su un @value{FN} della forma
address@hidden"/dev/fd/@var{N}"}, per numeri di descrittore di file
+oltre il due, effettivamente chiude il descrittore di file specificato.
+
address@hidden Reti speciali
address@hidden File speciali per comunicazioni con la rete
address@hidden reti, address@hidden per
address@hidden TCP/IP, address@hidden per
+
+I programmi @command{gawk}
+possono aprire una connessione bidirezionale
+TCP/IP, fungendo o da @dfn{client} o da @dfn{server}.
+Questo avviene usando uno speciale @value{FN} della forma:
+
address@hidden
address@hidden/@var{tipo-rete}/@var{protocollo}/@var{porta-locale}/@var{host-remoto}/@var{porta-remota}}
address@hidden example
+
+il @var{tipo-rete} address@hidden essere @samp{inet}, @samp{inet4} o
@samp{inet6}.
+Il @var{protocollo} address@hidden essere @samp{tcp} o @samp{udp},
+e gli altri campi rappresentano gli altri dati essenziali
+necessari per realizzare una connessione di rete.
+Questi @value{FNS} sono usati con l'operatore @samp{|&} per comunicare
+con un coprocesso
+(@pxref{I/O bidirezionale}).
+Questa @`e una address@hidden avanzata, qui riferita solo per completezza.
+Una spiegazione esauriente address@hidden fornita nella
address@hidden TCP/IP}.
+
address@hidden Avvertimenti speciali
address@hidden Avvertimenti speciali sui @value{FNS}
+
+Sono qui elencate alcune cose da tener presente usando i
address@hidden speciali forniti da @command{gawk}:
+
address@hidden @value{BULLET}
address@hidden address@hidden compatibile di (@command{gawk}), nomi di file
address@hidden nomi di file, nella address@hidden compatibile di @command{gawk}
address@hidden
+Il riconoscimento dei @value{FNS} per i tre file standard pre-aperti
address@hidden disabilitato solo in address@hidden POSIX.
+
address@hidden
+Il riconoscimento degli altri @value{FNS} speciali @`e disabilitato se
address@hidden @`e in address@hidden compatibile
+(o @option{--traditional} o @option{--posix};
address@hidden).
+
address@hidden
address@hidden interpreta @emph{sempre}
+questi @value{FNS} speciali.
+Per esempio, se si usa @samp{/dev/fd/4}
+per l'output, si scrive realmente sul descrittore di file 4, e non su un nuovo
+descrittore di file generato duplicando (con @code{dup()}) il descrittore
+file 4. Solitamente questo non ha importanza; comunque, @`e importante
address@hidden chiudere alcun file correlato ai descrittori di file 0, 1 e 2.
+Se lo si fa, il comportamente risultante @`e imprevedibile.
address@hidden itemize
+
address@hidden Chiusura file e @dfn{pipe}
address@hidden Chiudere ridirezioni in input e in output
address@hidden output, file in, si veda file in output
address@hidden input, file in, chiusura
address@hidden output, file in, chiusura
address@hidden @dfn{pipe}, chiusura
address@hidden coprocessi, chiusura
address@hidden @code{getline}, comando, address@hidden usare dal
+
+Se lo stesso @value{FN} o lo stesso comando di shell @`e usato con
@code{getline}
address@hidden di una volta durante l'esecuzione di un programma @command{awk}
+(@pxref{Getline}),
+il file viene aperto (o il comando viene eseguito) solo la prima volta.
+A quel punto, il primo record in input @`e letto da quel file o comando.
+La prossima volta che lo stesso file o comando @`e usato con @code{getline},
+un altro record @`e letto da esso, e address@hidden@dotless{i}} via.
+
+Analogamente, quando un file o una @dfn{pipe} sono aperti in output,
address@hidden ricorda
+il @value{FN} o comando a essi associato, e le successive
+scritture verso lo stesso file o comando sono accodate alle precedenti
+scritture.
+Il file o la @dfn{pipe} rimangono aperti fino al termine dell'esecuzione
+di @command{awk}.
+
address@hidden
+Questo implica che sono necessari dei passi speciali per rileggere nuovamente
+lo stesso file dall'inizio, o per eseguire di nuovo un comando di shell
+(invece che leggere ulteriore output dal precedente comando). La funzione
address@hidden()} rende possibile fare queste cose:
+
address@hidden
+close(@var{NOME_FILE})
address@hidden example
+
address@hidden
+o:
+
address@hidden
+close(@var{comando})
address@hidden example
+
+l'argomento @var{NOME_FILE} o @var{comando} address@hidden essere qualsiasi
espressione,
+il cui valore dev'essere @emph{esattamente} uguale alla stringa
+usata per aprire il file o eseguire il comando (spazi e altri caratteri
+``irrilevanti'' inclusi). Per esempio, se si apre una @dfn{pipe}
address@hidden@dotless{i}}:
+
address@hidden
+"sort -r nomi" | getline pippo
address@hidden example
+
address@hidden
+essa va chiusa in questo modo:
+
address@hidden
+close("sort -r nomi")
address@hidden example
+
+Una volta eseguita questa chiamata di funzione, la successiva @code{getline}
+da quel file o comando, o la successiva @code{print} o @code{printf} verso quel
+file o comando, riaprono il file o eseguono nuovamente il comando.
+Poich@'e l'espressione da usare per chiudere un file o una @dfn{pipeline} deve
+essere uguale all'espressione usata per aprire il file o eseguire il comando,
address@hidden buona norma usare una variabile che contenga il @value{FN} o il
comando.
+Il precedente esempio cambia come segue:
+
address@hidden
+sortcom = "sort -r nomi"
+sortcom | getline pippo
address@hidden
+close(sortcom)
address@hidden example
+
address@hidden
+Questo aiuta a evitare nei programmi @command{awk} errori di battitura
+difficili da scoprire. Queste sono alcune delle ragioni per cui @`e bene
+chiudere un file di output:
+
address@hidden @value{BULLET}
address@hidden
+Scrivere un file e rileggerlo in seguito all'interno dello stesso programma
address@hidden Occorre chiudere il file dopo aver finito di scriverlo, e poi
+iniziare a rileggerlo con @code{getline}.
+
address@hidden
+Per scrivere numerosi file, uno dopo l'altro, nello stesso programma
address@hidden Se i file non vengono chiusi, prima o poi @command{awk}
address@hidden
+superare il limite di sistema per il numero di file aperti in un processo.
address@hidden meglio chiudere ogni file quando il programma ha finito di
scriverlo.
+
address@hidden
+Per terminare un comando. Quando l'output @`e ridiretto usando una @dfn{pipe},
+il comando che legge la @dfn{pipe} normalmente continua a tentare di leggere
+input finch@'e la @dfn{pipe} rimane aperta. Spesso questo vuol dire che
+il comando non address@hidden eseguire il compito a lui assegnato finch@'e la
@dfn{pipe}
+non viene chiusa. Per esempio, se l'output @`e ridiretto al programma
address@hidden, il messaggio non @`e effettivamente inviato finch@'e la
@dfn{pipe}
+non viene chiusa.
+
address@hidden
+Eseguire lo stesso programma una seconda volta, con gli stessi argomenti.
+Questo non equivale a fornire ulteriore input alla prima esecuzione!
+
+Per esempio, si supponga che una programma invii tramite una @dfn{pipe}
+dell'output al programma @command{mail}.
+Se invia parecchie linee ridirigendole a questa @dfn{pipe} senza chiuderla,
+queste costituiscono un solo messaggio di parecchie righe. Invece, se il
+programma chiude la @dfn{pipe} dopo ogni riga dell'output, allora ogni riga
+costituisce un messaggio separato.
address@hidden itemize
+
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{close()}
address@hidden address@hidden, funzione @code{close()}
address@hidden funzione @code{close()}, address@hidden
address@hidden @code{close()}, funzione, address@hidden
+Se si usano file in numero superiore a quelli che il sistema permette
+di mantenere aperti,
address@hidden tenta di riutilizzare i file aperti disponibili fra
+i @value{DF}. La address@hidden che @command{gawk} lo faccia dipende dalle
address@hidden del sistema operativo, e quindi non @`e detto che questo riesca
+sempre. @`E quindi sia una buona pratica
+che un buon suggerimento per la address@hidden quello di usare sempre
address@hidden()} sui file, una volta che si @`e finito di operare su di essi.
+In effetti, se si usano molte @dfn{pipe}, @`e fondamentale che i comandi
+vengano chiusi, una volta finita la loro elaborazione. Per esempio, si
+consideri qualcosa del tipo:
+
address@hidden
address@hidden
+ @dots{}
+ comando = ("grep " $1 " /qualche/file | un_mio_programma -q " $3)
+ while ((comando | getline) > 0) @{
+ @var{elabora output di} comando
+ @}
+ # qui serve close(comando)
address@hidden
address@hidden example
+
+Questo esempio crea una nuova @dfn{pipeline} a seconda dei dati contenuti in
address@hidden record.
+Senza la chiamata a @code{close()} indicata come commento, @command{awk}
+genera processi-figlio per eseguire i comandi, fino a che non finisce per
+esaurire i descrittori di file
+necessari per creare ulteriori @dfn{pipeline}.
+
+Sebbene ogni comando sia stato completato (come si deduce dal codice di
+fine-file restituito dalla @code{getline}), il processo-figlio non @`e
+terminato;@footnote{La terminologia tecnica @`e piuttosto macabra.
+Il processo-figlio terminato @`e chiamato ``zombie,'' e la pulizia alla fine
+dello stesso @`e chiamata ``reaping'' [mietitura].}
address@hidden Good old UNIX: give the marketing guys fits, that's the ticket
+inoltre, e questo @`e address@hidden che address@hidden ci interessa, il
descrittore di file
+per la @dfn{pipe} non @`e chiuso e liberato finch@'e non si chiama
address@hidden()} o finch@'e il programma @command{awk} non termina.
+
address@hidden()} non fa nulla (e non emette messaggi) se le viene fornito come
+argomento una stringa che non rappresenta un file, una @dfn{pipe} o un
+coprocesso che sia stato aperto mediante una ridirezione. In quel caso,
address@hidden()} restituisce un valore di ritorno negativo, che indica un
+errore. Inoltre, @command{gawk} imposta @code{ERRNO}
+a una stringa che indica il tipo di errore.
+
+Si noti anche che @samp{close(NOME_FILE)} non ha effetti ``magici'' sul ciclo
+implicito che legge ogni record dei file indicati nella riga di comando.
+Si tratta, con ogni address@hidden, della chiusura di un file che non era mai
+stato aperto con una ridirezione,
+e per questo @command{awk} silenziosamente non fa nulla, tranne impostare un
+codice di ritorno negativo.
+
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O),
@address@hidden chiusura
+Quando si usa l'operatore @samp{|&} per comunicare con un coprocesso,
address@hidden talora utile essere in grado di chiudere un lato della @dfn{pipe}
+bidirezionale, senza chiudere l'altro lato.
+Questo @`e possibile fornendo un secondo argomento a @code{close()}.
+Come in ogni altra invocazione di @code{close()},
+il primo argomento @`e il nome del comando o file speciale usato
+per iniziare il coprocesso.
+Il secondo argomento dovrebbe essere una stringa, con uno dei due valori
address@hidden"to"} [a] oppure @code{"from"} [da]. Maiuscolo/minuscolo non fa
+differenza. Poich@'e questa @`e una address@hidden avanzata, la trattazione
@`e
+rinviata alla
address@hidden/O bidirezionale},
+che ne parla address@hidden dettagliatamente e fornisce un esempio.
+
address@hidden Usare il valore di ritorno di @code{close()}
address@hidden angolo buio, funzione @code{close()}
address@hidden funzione @code{close()}, valore di ritorno
address@hidden @code{close()}, funzione, valore di ritorno
address@hidden valore di address@hidden funzione @code{close()}
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{close()}
address@hidden Unix @command{awk}, funzione @code{close()} e
+
+In molte versioni di Unix @command{awk}, la funzione @code{close()}
address@hidden in address@hidden un'istruzione.
address@hidden
address@hidden un errore di sintassi tentare di usare il valore
+di ritorno da @code{close()}:
+
address@hidden
+comando = "@dots{}"
+comando | getline info
+retval = close(comando) # errore di sintassi in parecchi Unix awk
address@hidden example
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden variabile @code{ERRNO}, con funzione @command{close()}
address@hidden @code{ERRNO}, variabile, con funzione @command{close()}
address@hidden gestisce @code{close()} come una funzione.
+Il valore di ritorno @`e @minus{}1 se l'argomento designa un file
+che non era mai stato aperto con una ridirezione, o se c'@`e un problema di
+sistema nella chiusura del file o del processo.
+In tal caso, @command{gawk} imposta la variabile predefinita
address@hidden a una stringa che descrive il problema.
+
+In @command{gawk}, a partire dalla @value{PVERSION} 4.2,
+quando si chiude una @dfn{pipe} o un coprocesso (in input o in output),
+il valore di ritorno @`e quello restituito dal comando,
+come descritto in @address@hidden
+della @value{PVERSION} 4.2, il valore di ritorno dopo la chiusura di
+una @dfn{pipe} o di un coprocesso era una cifra di due byte (16-bit),
+contenente il valore restituito dalla chiamata di sistema @code{wait()}}.
+Altrimenti, @`e il valore di ritorno dalla chiamata alle funzione
+di sistema @code{close()} o alla funzione C @code{fclose()}
+se si sta chiudendo un file in input o in output, rispettivamente.
+Questo valore @`e zero se la chiusura riesce, o @minus{}1 se non riesce.
+
address@hidden Tabella,table-close-pipe-return-values
address@hidden di ritorno dalla @code{close()} di una @dfn{pipe}}
address@hidden @columnfractions .50 .50
address@hidden Situazione @tab Valore restituito da @code{close()}
address@hidden Uscita normale dal comando @tab Il codice di ritorno del comando
address@hidden Uscita dal comando per @dfn{signal} @tab 256 + numero del
segnale assassino
address@hidden Uscita dal comando per @dfn{signal} con @dfn{dump} @tab 512 +
numero del segnale assassino
address@hidden Errore di qualsiasi tipo @tab @minus{}1
address@hidden multitable
address@hidden float
+
+Lo standard POSIX @`e molto generico; dice che @code{close()}
+restituisce zero se @`e terminata correttamente, e un valore diverso da zero
+nell'altro caso. In generale,
+implementazioni differenti variano in quel che restituiscono chiudendo una
address@hidden; quindi, il valore di ritorno non address@hidden essere usato in
modo
+portabile.
address@hidden
+In address@hidden POSIX (@pxref{Opzioni}), @command{gawk} restituisce solo zero
+quando chiude una @dfn{pipe}.
address@hidden sidebar
+
address@hidden Continuazione dopo errori
address@hidden Abilitare continuazione dopo errori in output
+
+Questa @value{SECTION} descrive una address@hidden specifica di @command{gawk}.
+
+In @command{awk} standard, l'output con @code{print} o @code{printf}
+a un file che non esiste, o qualche altro errore di I/O (come p.es.
+esaurire lo spazio disponibile su disco) @`e un errore fatale (termina
+l'esecuzione del programma).
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print "ciao" > "/file/non/esistente" @}'}
address@hidden gawk: riga com.:1: fatale: non riesco a ri-dirigere a
address@hidden `/file/non/esistente' (/file o directory non esistente)
address@hidden example
+
address@hidden rende possibile accorgersi che c'@`e stato un errore,
+permettendo di tentare di rimediare, o almeno di stampare un messaggio
+di errore prima di terminare il programma.
address@hidden possibile fare questo in due modi differenti:
+
address@hidden @bullet
address@hidden
+Per tutti i file in output, assegnando un valore qualsiasi a
address@hidden"NONFATAL"]}.
+
address@hidden
+Specificamente per un solo file, assegnando un valore qualsiasi a
address@hidden@var{nome_file}, "NONFATAL"]}.
address@hidden @`e il nome del file per il quale
+si desidera che l'errore di output non faccia terminare il programma.
address@hidden itemize
+
+Una volta abilitata la continuazione dopo un errore di output, si
address@hidden
+controllare la variabile @code{ERRNO} dopo ogni istruzione
address@hidden o @code{printf} diretta a quel file, per controllare che
+tutto sia andato a buon fine. @`E anche una buona idea inizializzare
address@hidden a zero prima di tentare l'operazione di scrittura.
+Per esempio:
+
address@hidden
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{ PROCINFO["NONFATAL"] = 1}
+> @kbd{ ERRNO = 0}
+> @kbd{ print "ciao" > "/file/non/esistente"}
+> @kbd{ if (ERRNO) @{}
+> @kbd{ print("Output non riuscito:", ERRNO) > "/dev/stderr"}
+> @kbd{ exit 1}
+> @kbd{ @}}
+> @address@hidden'}
address@hidden Output non riuscito: No such file or directory
address@hidden example
+
address@hidden non genera un errore fatale; permette invece
+al programma @command{awk} di rendersi conto del problema e di gestirlo.
+
+Questo meccanismo si applica anche allo standard output e allo standard error.
+Per lo standard output, si address@hidden usare @code{PROCINFO["-",
"NONFATAL"]}
+o @code{PROCINFO["/dev/stdout", "NONFATAL"]}.
+Per lo standard error, occorre
+usare @code{PROCINFO["/dev/stderr", "NONFATAL"]}.
+
+Se si tenta di aprire un @dfn{socket} TCP/IP (@pxref{Reti TCP/IP}),
address@hidden tenta di farlo per un certo numero di volte.
+La variabile d'ambiente @env{GAWK_SOCK_RETRIES}
+(@pxref{Altre variabili d'ambiente}) consente di alterare il numero di
+tentativi che @command{gawk} farebbe per default. Tuttavia,
+una volta abilitata la continuazione dopo un errore di I/O per un certo
address@hidden, @command{gawk} si limita a un solo tentativo,
+lasciando al codice del programma @command{awk} il compito di gestire
+l'eventuale problema.
+
address@hidden Sommario di Output
address@hidden Sommario.
+
address@hidden @value{BULLET}
address@hidden
+L'istruzione @code{print} stampa una lista di espressioni separate da virgole.
+Le espressioni sono separate tra loro dal valore di @code{OFS} e completate
+dal valore di @code{ORS}. @code{OFMT} fornisce il formato di conversione
+dei valori numerici per l'istruzione @code{print}.
+
address@hidden
+L'istruzione @code{printf} fornisce un controllo address@hidden preciso
sull'output,
+con lettere di controllo del formato per diversi tipi di dati e vari
+modificatori
+che cambiano il comportamento delle lettere di controllo del formato.
+
address@hidden
+L'output sia di @code{print} che di @code{printf} address@hidden essere
ridiretto a
+file, @dfn{pipe}, e coprocessi.
+
address@hidden
address@hidden fornisce @value{FNS} speciali per accedere allo
+standard input, standard output e standard error, e per comunicazioni di rete.
+
address@hidden
+Usare @code{close()} per chiudere file aperti, @dfn{pipe} e ridirezioni a
+coprocessi.
+Per i coprocessi, @`e possibile chiudere anche soltanto una delle due
+direzioni di comunicazione.
+
address@hidden
+Normalmente se si verificano errori eseguendo istruzioni @code{print} o
address@hidden, questi causano la fine del programma.
address@hidden consente di proseguire l'elaborazione anche in questo
+caso, o per un errore su qualsiasi file in output, o per un errore
+relativo a qualche file in particolare.
+Resta a carico del programma controllare se si sono verificati errori
+dopo l'esecuzione di ogni istruzione di output interessata.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi su Output
address@hidden Esercizi
+
address@hidden
address@hidden
+Riscrivere il programma:
+
address@hidden
+awk 'BEGIN @{ print "Mese Contenitori"
+ print "----- -----------" @}
+ @{ print $1, $2 @}' inventory-shipped
address@hidden example
+
address@hidden
+come
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di output}, usando un nuovo valore per @code{OFS}.
+
address@hidden
+Usare l'istruzione @code{printf} per allineare le intestazioni e i dati
+della tabella
+per il file di esempio @file{inventory-shipped} utilizzato nella @ref{Print}.
+
address@hidden
+Spiegare cosa succede se si dimenticano i doppi apici ridirigendo l'output,
+come nel caso che segue:
+
address@hidden
+BEGIN @{ print "Ho trovato un errore grave!" > /dev/stderr @}
address@hidden example
+
address@hidden enumerate
address@hidden EXCLUDE END
+
+
address@hidden Espressioni
address@hidden Espressioni
address@hidden espressioni
+
+Le espressioni sono i mattoni fondamentali dei modelli di ricerca e delle
+azioni di @command{awk}. Un'espressione genera un valore che si
address@hidden stampare, verificare o passare a una funzione. Oltre a
address@hidden, un'espressione
address@hidden assegnare un nuovo valore a una variabile o a un campo usando un
operatore
+di assegnamento.
+
+Un'espressione address@hidden servire come modello di ricerca o istruzione di
azione a
+s@'e stante. La maggior parte degli altri tipi di istruzione contengono una o
address@hidden espressioni che specificano i dati sui quali operare. Come in
altri
+linguaggi, le espressioni in @command{awk} possono includere variabili,
+riferimenti a vettori e a costanti, e chiamate di funzione, come pure
+combinazioni tra questi usando diversi operatori.
+
address@hidden
+* Valori:: Costanti, variabili ed espressioni regolari.
+* Tutti gli operatori:: Gli operatori di @command{gawk}.
+* Valori e condizioni di address@hidden:: Determinare Vero/Falso.
+* Chiamate di funzione:: Una chiamata di funzione address@hidden essere
+ un'espressione.
+* Precedenza:: Come si nidificano i vari operatori.
+* Localizzazioni:: Come la localizzazione influenza la
+ gestione dati.
+* Sommario delle espressioni:: Sommario delle espressioni.
address@hidden menu
+
address@hidden Valori
address@hidden Costanti, variabili e conversioni
+
+Le espressioni sono costruite a partire da valori e dalle operazioni eseguite
+su di essi. Questa @value{SECTION} descrive gli oggetti elementari
+che forniscono i valori usati nelle espressioni.
+
address@hidden
+* Costanti:: Costanti di tipo stringa, numeriche ed
+ espressioni regolari
+* Usare le costanti @dfn{regexp}:: Quando e come usare una costante
+ specificata tramite espressioni regolari
+* Variabili:: Le variabili permettono di
+ definire valori da usare in seguito.
+* Conversione:: La conversione di stringhe in numeri
+ e viceversa.
address@hidden menu
+
address@hidden Costanti
address@hidden Espressioni costanti
+
address@hidden costanti, tipi di
+
+Il tipo di espressione address@hidden semplice @`e una @dfn{costante}, che ha
sempre lo
+stesso valore. Ci sono tre tipi di costanti: numeriche, di stringa e di
+espressione regolare.
+
+Ognuna di esse si usa nel contesto appropriato quando occorre assegnare ai
+dati un valore che non address@hidden essere cambiato. Le costanti numeriche
possono
+avere forme diverse, ma sono memorizzate internamente sempre allo stesso modo.
+
address@hidden
+* Costanti scalari:: Costanti numeriche e stringhe.
+* Numeri non-decimali:: Cosa sono i numeri ottali ed esadecimali.
+* Costanti come espressioni regolari:: Costanti fornite tramite espressioni
+ regolari.
address@hidden menu
+
address@hidden Costanti scalari
address@hidden Costanti numeriche e stringhe
+
address@hidden costanti numeriche
address@hidden numeriche, costanti
+Una @dfn{costante numerica} @`e un numero. Questo numero address@hidden
essere un
+numero intero, una frazione decimale o un numero in notazione scientifica
+(esponenziale)address@hidden rappresentazione interna di tutti i numeri,
+compresi gli interi, usa numeri in virgola mobile a doppia precisione.
+Sui sistemi address@hidden moderni, questi sono nel formato standard IEEE 754.
address@hidden con precisione arbitraria}, per maggiori informazioni.}
+Ecco alcuni esempi di costanti numeriche che hanno tutte lo stesso
+valore:
+
address@hidden
+105
+1.05e+2
+1050e-1
address@hidden example
+
address@hidden costanti stringa
+Una @dfn{costante stringa} @`e formata da una sequenza di caratteri racchiusi
tra
+doppi apici. Per esempio:
+
address@hidden
+"pappagallo"
address@hidden example
+
address@hidden
address@hidden differenze tra @command{awk} e @command{gawk}, stringhe
address@hidden stringhe, limitazioni della lunghezza
+rappresenta la stringa il cui contenuto @`e la parola @samp{pappagallo}.
+Le stringhe in
address@hidden possono essere di qualsiasi lunghezza, e possono contenere
+tutti i possibili caratteri ASCII a otto bit, compreso il carattere ASCII
address@hidden (carattere con codice zero).
+Altre implementazioni di @command{awk} possono avere address@hidden con alcuni
+particolari codici di carattere.
+
address@hidden Numeri non-decimali
address@hidden Numeri ottali ed esadecimali
address@hidden ottali, numeri
address@hidden esadecimali, numeri
address@hidden numeri ottali
address@hidden numeri esadecimali
+
+In @command{awk}, tutti i numeri sono espressi nel sistema decimale
(address@hidden a
+base 10).
+Molti altri linguaggi di programmazione consentono di specificare i numeri in
+altre basi, spesso in ottale (base 8) e in esadecimale (base 16).
+Nel sistema ottale i numeri hanno la sequenza 0, 1, 2, 3, 4, 5, 6, 7, 10, 11,
+12, e address@hidden@dotless{i}} via. Come @samp{11} decimale @`e una volta
10 address@hidden 1, address@hidden@dotless{i}}
address@hidden ottale @`e una volta 8 address@hidden 1. Questo equivale a 9 nel
sistema decimale.
+Nell'esadecimale ci sono 16 cifre. Poich@'e l'usuale sistema numerico decimale
+ha solo dieci cifre (@address@hidden), le lettere da
address@hidden a @samp{f} rappresentano le cifre ulteriori.
+(normalmente @`e irrilevante se le lettere sono maiuscole o minuscole; gli
+esadecimali @samp{a} e @samp{A} hanno lo stesso valore).
address@hidden@dotless{i}}, @samp{11} esadecimale @`e 1 volta 16 address@hidden
1,
+il che equivale a 17 decimale.
+
+Guardando solamente un @samp{11} puro e semplice, non si capisce in quale base
+sia. address@hidden@dotless{i}}, in C, C++, e in altri linguaggi derivati da
C,
address@hidden such as PERL, but we won't mention that....
+c'@`e una speciale notazione per esprimere la base.
+I numeri ottali iniziano con uno @samp{0},
+e i numeri esadecimali iniziano con uno @samp{0x} o @samp{0X}:
+
address@hidden @code
address@hidden 11
+Valore decimale 11
+
address@hidden 011
+11 ottale, valore decimale 9
+
address@hidden 0x11
+11 esadecimale, valore decimale 17
address@hidden table
+
+Quest'esempio mostra le differenze:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "%d, %d, %d\n", 011, 11, 0x11 @}'}
address@hidden 9, 11, 17
address@hidden example
+
+Poter usare costanti ottali ed esadecimali nei propri programmi @`e molto utile
+quando si lavora con dati che non possono essere rappresentati
+convenientemente come caratteri o come numeri regolari, come i dati binari di
+vario tipo.
+
address@hidden @command{gawk}, numeri ottali e
address@hidden @command{gawk}, numeri esadecimali e
address@hidden permette l'uso di costanti ottali ed esadecimali nel testo di
+un programma. Comunque, se numeri non-decimali sono presenti tra i dati in
+input, essi non sono trattati in maniera speciale; trattarli in modo speciale
+per default significherebbe che vecchi programmi @command{awk} produrrebbero
+risultati errati.
+(Se si vuole che i numeri siano trattati in maniera speciale, si deve
+specificare l'opzione da riga di comando
address@hidden;
address@hidden non decimali}.)
+Se si devono gestire dati ottali o esadecimali,
+si address@hidden usare la funzione @code{strtonum()}
+(@pxref{Funzioni per stringhe})
+per convertire i dati in numeri.
+La maggior parte delle volte, le costanti ottali o esadecimali si usano quando
+si lavora con le funzioni predefinite di manipolazione di bit;
+si veda @ref{Funzioni a livello di bit}
+per maggiori informazioni.
+
+Diversamente da alcune tra le prime implementazioni di C, @samp{8} e @samp{9}
+non sono cifre valide nelle costanti ottali. Per esempio, @command{gawk}
+tratta @samp{018} come un 18 decimale:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print "021 @`e", 021 ; print 018 @}'}
address@hidden 021 @`e 17
address@hidden 18
address@hidden example
+
address@hidden address@hidden compatibile di (@command{gawk}), numeri ottali
address@hidden numeri ottali nella address@hidden compatibile di
(@command{gawk})
address@hidden address@hidden compatibile di (@command{gawk}), numeri
esadecimali
address@hidden numeri esadecimali nella address@hidden compatibile di
(@command{gawk})
address@hidden compatibile, address@hidden (@command{gawk}), numeri ottali
address@hidden compatibile, address@hidden (@command{gawk}), numeri esadecimali
+Le costanti ottali ed esadecimali nel codice sorgente sono un'estensione di
address@hidden Se @command{gawk} @`e in address@hidden compatibile
+(@pxref{Opzioni}),
+non sono disponibili.
+
address@hidden La base di una costante non influisce sul suo valore
+
+Una volta che una costante numerica @`e stata
+convertita internamente in un numero [decimale],
address@hidden non considera address@hidden
+la forma originale della costante; viene sempre usato il valore
+interno. Questo ha delle precise conseguenze per la conversione dei
+numeri in stringhe:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "0x11 vale <%s>\n", 0x11 @}'}
address@hidden 0x11 vale <17>
address@hidden example
address@hidden sidebar
+
address@hidden Costanti come espressioni regolari
address@hidden Costanti fornite tramite espressioni regolari
+
address@hidden @dfn{regexp}, costanti
address@hidden costanti @dfn{regexp}
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
+Una @dfn{costante regexp} @`e la descrizione di un'espressione regolare
+delimitata
+da barre, come @address@hidden/^inizio e fine$/}}. La maggior parte delle
address@hidden usate nei programmi @command{awk} sono costanti, ma gli operatori
+di confronto @samp{~} e @samp{!~} possono confrontare anche @dfn{regexp}
+calcolate o dinamiche (che tipicamente sono solo stringhe ordinarie o
+variabili che contengono un'espressione regolare, ma potrebbero anche essere
+espressioni address@hidden complesse).
+
address@hidden Usare le costanti @dfn{regexp}
address@hidden Usare espressioni regolari come costanti
+
+Le costanti @dfn{regexp} sono costituite da testo che descrive un'espressione
+regolare, racchiusa fra barre (come p.e. @code{/la +risposta/}).
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta del comportamento di tali costanti in
+POSIX @command{awk} e in @command{gawk}, e prosegue descrivendo le
address@hidden @dfn{regexp} fortemente tipizzate}, che sono
+un'estensione @command{gawk}.
+
address@hidden
+* Costanti @dfn{regexp} normali:: Costanti @dfn{regexp} normali in
+ @command{awk}.
+* Costanti @dfn{regexp} forti:: Costanti @dfn{regexp} fortemente tipizzate.
address@hidden menu
+
address@hidden Costanti @dfn{regexp} normali
address@hidden Costanti @dfn{regexp} normali in @command{awk}.
+
address@hidden angolo buio, costanti @dfn{regexp}
+Quand'@`e usata a destra degli operatori @samp{~} o @samp{!~},
+una costante @dfn{regexp} rappresenta semplicemente l'espressione regolare che
+dev'essere confrontata. Comunque, le costanti @dfn{regexp} (come
@code{/pippo/})
+possono essere usate come semplici espressioni.
+Quando una
+costante @dfn{regexp} compare da sola, ha lo stesso significato di quando
+compare in un criterio di ricerca (address@hidden @samp{($0 ~ /pippo/)}).
address@hidden
address@hidden come criteri di ricerca}.
address@hidden vuol dire che i due frammenti di codice seguenti:
+
address@hidden
+if ($0 ~ /barfly/ || $0 ~ /camelot/)
+ print "trovato"
address@hidden example
+
address@hidden
+e:
+
address@hidden
+if (/barfly/ || /camelot/)
+ print "trovato"
address@hidden example
+
address@hidden
+sono esattamente equivalenti.
+Una conseguenza piuttosto bizzarra di questa regola @`e che la seguente
+espressione booleana @`e valida, ma non fa quel che probabilmente l'autore
+si aspettava:
+
address@hidden
+# Notare che /pippo/ @`e alla @emph{sinistra} della ~
+if (/pippo/ ~ $1) print "trovato pippo"
address@hidden example
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden @command{gawk}, costanti @dfn{regexp} e
address@hidden costanti @dfn{regexp}, in @command{gawk}
address@hidden
+Questo codice ``ovviamente'' intende verificare se @code{$1} contiene
+l'espressione regolare @code{/pippo/}. Ma in effetti l'espressione
address@hidden/pippo/ ~ $1} significa realmente @samp{($0 ~ /pippo/) ~ $1}. In
altre
+parole, prima confronta il record in input con l'espressione regolare
address@hidden/pippo/}. Il risultato @`e zero o uno, a seconda che il
confronto dia esito
+positivo o negativo. Questo risultato
address@hidden poi confrontato col primo campo nel record.
+Siccome @`e improbabile che qualcuno voglia mai fare realmente questo genere di
+test, @command{gawk} emette un avvertimento quando vede questo costrutto in
+un programma.
+Un'altra conseguenza di questa regola @`e che l'istruzione di assegnamento:
+
address@hidden
+confronta = /pippo/
address@hidden example
+
address@hidden
+assegna zero o uno alla variabile @code{confronta}, a seconda
+del contenuto del record in input corrente.
+
address@hidden differenze tra @command{awk} e @command{gawk}, costanti
@dfn{regexp}
address@hidden angolo buio, costanti @dfn{regexp}, come argomenti a funzioni
definite dall'utente
address@hidden
address@hidden
address@hidden
+Le espressioni regolari costanti possono essere usate anche come primo
+argomento delle
+funzioni @code{gensub()}, @code{sub()}, e @code{gsub()}, come secondo argomento
+della funzione @code{match()},
+e come terzo argomento delle funzioni @code{split()} e @code{patsplit()}
+(@pxref{Funzioni per stringhe}).
+Le moderne implementazioni di @command{awk}, incluso @command{gawk}, permettono
+di usare come terzo argomento di @code{split()} una costante @dfn{regexp}, ma
+alcune implementazioni address@hidden vecchie non lo consentono.
address@hidden
+Poich@'e alcune funzioni predefinite accettano costanti @dfn{regexp} come
+argomenti, address@hidden generare confusione l'uso di costanti @dfn{regexp}
come
+argomenti di funzioni definite dall'utente
+(@pxref{Funzioni definite dall'utente}). Per esempio:
+
address@hidden
+function mysub(modello, sostituzione, stringa, globale)
address@hidden
+ if (globale)
+ gsub(modello, sostituzione, stringa)
+ else
+ sub(modello, sostituzione, stringa)
+ return stringa
address@hidden
+
address@hidden
+ @dots{}
+ text = "salve! salve a te!"
+ mysub(/salve/, "ciao", text, 1)
+ @dots{}
address@hidden
address@hidden example
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
+In quest'esempio, il programmatore vuol passare una costante @dfn{regexp} alla
+funzione definita dall'utente @code{mysub()}, che a sua volta la passa o a
address@hidden()} o a @code{gsub()}. Comunque, quel che realmente succede @`e
che
+al parametro @code{modello} @`e assegnato un valore di uno o zero, a seconda
+che @code{$0} corrisponda a @code{/salve/} o no.
address@hidden emette un avvertimento quando vede una costante @dfn{regexp}
+usata come parametro di una funzione definita dall'utente, poich@'e
+passare un valore vero/falso in questo modo probabilmente non @`e quello che
+si intendeva fare.
+
address@hidden Costanti @dfn{regexp} forti
address@hidden Costanti @dfn{regexp} fortemente tipizzate
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden specifica di @command{gawk}.
+
+Come visto
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden
address@hidden
address@hidden ifdocbook
+precedente,
+le costanti @dfn{regexp} (@code{/@dots{}/}) hanno uno strano posto nel
+linguaggio @command{awk}. In molti contesti, si comportano come
+un'espressione:
address@hidden ~ /@dots{}/}. In altri contesti, denotano solo una @dfn{regexp}
da
+individuare. In nessun caso esse sono davvero ``cittadine di serie A'' del
+linguaggio. Ovvero, non @`e possibile definire una variabile scalare il cui
+tipo sia address@hidden'' nello stesso senso in cui si address@hidden definire
una
+variabile che sia un numero o una stringa:
+
address@hidden
+num = 42 @ii{Variabile numerica}
+str = "hi" @ii{Variabile di tipo stringa}
+re = /pippo/ @ii{Errore!} re @address@hidden il risultato di} $0 ~ /pippo/
address@hidden example
+
+Per alcuni casi di uso address@hidden avanzati,
+sarebbe bello poter avere costanti @dfn{regexp} che sono
address@hidden tipizzate}; in altre parole, che sostituiscono
+una @dfn{regexp} utile per effettuare dei confronti,
+e non una semplice espressione regolare.
+
address@hidden prevede questa address@hidden Un'espressione regolare
+fortemente tipizzata @`e molto simile a un'espressione regolare normale,
+tranne per il fatto di essere preceduta dal simbolo @samp{@@}:
+
address@hidden
+re = @@/foo/ @ii{variabile @dfn{regexp} fortemente tipizzata}
address@hidden example
+
+Le variabili @dfn{regexp} fortemente tipizzate @emph{non possono} essere
+usate in ogni istruzione in cui compare un'espressione regolare normale.
+perch@'e address@hidden renderebbe il linguaggio ancora address@hidden
fuorviante.
+Queste espressioni possono essere usate solo in alcuni contesti:
+
address@hidden @bullet
address@hidden
+Sul lato destro degli operatori @samp{~} e @samp{!~}:
address@hidden ~ @@/foo/}
+(@pxref{Uso di @dfn{regexp}}).
+
address@hidden
+Nella parte @code{case} di un'istruzione @code{switch}
+(@pxref{Istruzione switch}).
+
address@hidden
+Come argomento in una delle funzioni predefinite che possono utilizzare
+costanti @dfn{regexp}:
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()}
+e
address@hidden()}
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Come parametro in una chiamata a una funzione definita dall'utente
+(@pxref{Funzioni definite dall'utente}).
+
address@hidden
+Sul lato destro di un assegnamento di variabile:
address@hidden = @@/foo/}.
+In tal caso, @code{qualche_variabile} @`e di tipo @dfn{regexp}.
+Inoltre, @code{qualche_variabile}
address@hidden essere usata con gli operatori @samp{~} e @samp{!~}, passata a
una
+delle funzioni predefinite sopra elencate o passata come parametro
+a una funzione definita dall'utente.
address@hidden itemize
+
+Si address@hidden usare la funzione predefinita @code{typeof()}
+(@pxref{Funzioni per i tipi})
+per determinare se un parametro passato a una funzione
address@hidden una variabile di tipo @dfn{regexp}.
+
+La vera efficacia di questa address@hidden consiste nella address@hidden di
creare
+variabili il cui tipo @`e @dfn{regexp}. Tali variabili possono essere passate
+a funzioni definite dall'utente, senza gli inconvenenti che si hanno usando
+espressioni regolari calcolate, a partire da stringhe o da costanti di tipo
+stringa. Queste variabili possono anche essere passate utilizzando chiamate
+indirette a funzioni (@pxref{Chiamate indirette}) e alle funzioni predefinite
+che accettano costanti di tipo @dfn{regesp}.
+
+Quando sono usate per effettuare conversioni numeriche, le variabili
address@hidden fortemente tipizzate vengono convertite alla cifra zero.
+Quando sono usate per effettuare conversioni a stringhe, vengono convertite
+al valore di stringa del testo della @dfn{regexp} originale.
+
address@hidden Variabili
address@hidden Variabili
+
address@hidden variabili definite dall'utente
address@hidden definite dall'utente, variabili
+Le @dfn{variabili} consentono di memorizzare valori in un certo punto di un
+programma, per usarli address@hidden tardi in un'altra parte del programma.
Le variabili
+possono essere gestite interamente all'interno del testo del programma, ma
+ad esse possono essere assegnati valori sulla riga di comando, in fase di
+invocazione di @command{awk}.
+
address@hidden
+* Usare variabili:: Usare variabili nei propri programmi.
+* Opzioni di assegnamento:: Impostare variabili dalla riga di
+ comando, e un sommario della sintassi
+ della riga di comando.
+ Questo @`e un metodo di input avanzato.
address@hidden menu
+
address@hidden Usare variabili
address@hidden Usare variabili in un programma
+
+Le variabili permettono di dare nomi ai valori e di far riferimento ad essi in
+un secondo momento. Alcune variabili sono address@hidden state usate in molti
degli
+esempi.
+Il nome di una variabile dev'essere una sequenza di lettere, cifre o trattini
+bassi, e non deve iniziare con una cifra.
+Qui, una @dfn{lettera} @`e una qualsiasi delle 52 lettere maiuscole e minuscole
+dell'alfabeto inglese. Altri caratteri che possono essere definiti come
+lettere in localizzazioni non inglesi non sono validi nei nomi di variabile.
+Il maiuscolo o minuscolo sono significativi nei nomi di variabile;
address@hidden e @code{A} sono variabili diverse.
+
+Un nome di variabile @`e un'espressione valida in se stessa; rappresenta il
+valore corrente della variabile. I valori delle variabili possono essere
+modificati tramite @dfn{operatori di assegnamento}, @dfn{operatori di
+incremento} e @dfn{operatori di decremento}
+(@xref{Operatori di assegnamento}).
+Inoltre, le funzioni @code{sub()} e @code{gsub()} possono cambiare il valore
+di una variabile e le funzioni
address@hidden()}, @code{split()}, e @code{patsplit()} possono cambiare il
+contenuto dei loro parametri che sono
+costituiti da vettori
+(@pxref{Funzioni per stringhe}).
+
address@hidden variabili, predefinite
address@hidden variabili, inizializzazione
+Alcune variabili hanno un significato speciale predefinito, come @code{FS}
+(il separatore di campo) e @code{NF} (il numero di campi nel record di input
+corrente). @xref{Variabili predefinite} per un elenco delle variabili
+predefinite. Queste variabili predefinite possono essere usate e possono
+ricevere assegnamenti come tutte le altre variabili, ma i loro valori sono
+anche usati o cambiati automaticamente da @command{awk}. Tutti i nomi delle
+variabili predefinite sono in caratteri maiuscoli.
+
+Alle variabili in @command{awk} possono essere assegnati valori numerici o
+valori di stringa. Il tipo di valore che una variabile contiene
address@hidden cambiare
+durante la vita di un programma. Per default, le variabili sono inizializzate
+alla stringa nulla, che vale zero se viene convertita in un numero. Non c'@`e
+alcuna
address@hidden di inizializzare esplicitamente una variabile in @command{awk},
+come invece occorre fare in C e nella maggior parte dei linguaggi
+tradizionali.
+
address@hidden Opzioni di assegnamento
address@hidden Assegnare una variabile dalla riga di comando
address@hidden variabili, assegnare da riga di comando
address@hidden riga di comando, address@hidden assegnare da
+
+Si address@hidden impostare qualsiasi variabile @command{awk} includendo un
address@hidden di variabile} tra gli argomenti sulla riga di comando quando
+viene invocato @command{awk} (@pxref{Altri argomenti}).
+Tale assegnamento ha la seguente forma:
+
address@hidden
address@hidden@var{testo}
address@hidden example
+
address@hidden @option{-v}, opzione
address@hidden
+Con questo assegnamento, una variabile viene impostata o all'inizio
+dell'esecuzione di @command{awk} o tra la lettura di un file in input e il
+successivo file in input.
+Quando l'assegnamento @`e preceduto dall'opzione @option{-v},
+come nel seguente esempio:
+
address@hidden
+-v @address@hidden
address@hidden example
+
address@hidden
+la variabile @`e impostata proprio all'inizio, ancor prima che sia eseguita la
+regola @code{BEGIN}. L'opzione @option{-v} e il suo assegnamento
+deve precedere tutti gli argomenti @value{FN}, e anche il testo del programma.
+(@xref{Opzioni} per maggiori informazioni sull'opzione
address@hidden)
+In alternativa, l'assegnamento di variabile @`e effettuata in un momento
+determinato
+dalla posizione dell'opzione tra gli argomenti "file in input", address@hidden
dopo
+l'elaborazione del precedente argomento "file in input". Per esempio:
+
address@hidden
+awk '@{ print $n @}' n=4 inventory-shipped n=2 mail-list
address@hidden example
+
address@hidden
+stampa il valore del campo numero @code{n} per tutti i record in input. Prima
+che venga letto il primo file, la riga di comando imposta la variabile @code{n}
+al valore quattro. Questo fa address@hidden@dotless{i}} che venga stampato il
quarto campo delle righe
+del file @file{inventory-shipped}. Dopo la fine del primo file, ma prima
+che inizi il secondo file, @code{n} viene impostato a due, e quindi poi
+viene stampato il secondo campo delle righe di @file{mail-list}:
+
address@hidden
+$ @kbd{awk '@{ print $n @}' n=4 inventory-shipped n=2 mail-list}
address@hidden 15
address@hidden 24
address@hidden
address@hidden 555-5553
address@hidden 555-3412
address@hidden
address@hidden example
+
address@hidden angolo buio, argomenti da riga di comando
+Gli argomenti da riga di comando sono resi disponibili dal programma
address@hidden nel vettore @code{ARGV} per poter essere esaminati esplicitamente
+(@pxref{ARGC e ARGV}).
address@hidden elabora i valori degli assegnamenti da riga di comando per
+sequenze di protezione
+(@pxref{Sequenze di protezione}).
address@hidden
+
address@hidden Conversione
address@hidden Conversione di stringhe e numeri
+
+Le conversioni di numeri in stringhe e di stringhe in numeri sono generalmente
+semplici. Ci possono essere delle sottigliezze che bisogna tenere presenti;
+questa @value{SECTION} tratta di quest'importante sfaccettatura di
@command{awk}.
+
address@hidden
+* Stringhe e numeri:: Come @command{awk} converte tra
+ stringhe e numeri.
+* Localizzazione e conversioni:: Come la localizzazione address@hidden influire
+ sulle conversioni.
address@hidden menu
+
address@hidden Stringhe e numeri
address@hidden Come @command{awk} converte tra stringhe e numeri
+
address@hidden conversione da stringhe a numeri
address@hidden stringhe, conversione
address@hidden numeri, conversione in stringhe
address@hidden conversione da numeri a stringhe
+Le stringhe sono convertite in numeri e i numeri sono convertiti in stringhe,
+se il contesto del programma @command{awk} lo richiede. Per esempio, se il
+valore di @code{pippo} o @code{pluto} nell'espressione @samp{pippo + pluto}
address@hidden una stringa, viene convertita in un numero prima di eseguire
l'addizione.
+Se in una concatenazione di stringhe ci sono valori numerici, questi sono
+convertiti in stringhe. Si consideri il seguente esempio:
+
address@hidden
+due = 2; tre = 3
+print (due tre) + 4
address@hidden example
+
address@hidden
+Stampa il valore (numerico) di 27. I valori numerici delle
+variabili @code{due} e @code{tre} sono convertiti in stringhe e
+concatenati insieme. La stringa risultante @`e riconvertita nel
+numero 23, al quale poi viene aggiunto 4.
+
address@hidden stringhe nulle, conversione da tipo numerico a tipo stringa
address@hidden conversione di tipo variabile
address@hidden variabile, conversione di tipo
+Se, per qualche ragione, si vuole forzare la conversione di un numero in
+una stringa, basta concatenare a quel numero la stringa nulla, @code{""}.
+Per forzare la conversione di una stringa in un numero, basta aggiungere zero
+a quella stringa. Una stringa viene convertita in un numero interpretando
+qualsiasi prefisso numerico della stringa come numero:
address@hidden"2.5"} si converte in 2.5, @code{"1e3"} si converte in 1000, e
address@hidden"25fix"} ha un valore numerico di 25.
+Le stringhe che non possono essere interpretate come numeri validi vengono
+convertite al valore zero.
+
address@hidden @code{CONVFMT}, variabile
+Il modo esatto in cui i numeri sono convertiti in stringhe @`e controllato
dalla
+variabile predefinita di @command{awk} @code{CONVFMT}
+(@pxref{Variabili predefinite}). I numeri vengono convertiti usando la
+funzione @code{sprintf()}
+con @code{CONVFMT} come specificatore di formato
+(@pxref{Funzioni per stringhe}).
+
+Il valore di default di @code{CONVFMT} @`e @code{"%.6g"}, che crea un valore
con
+un massimo di sei cifre significative. Per alcune applicazioni potrebbe essere
+opportuno cambiare questo valore per ottenere una maggiore precisione.
+Sulla maggior parte delle macchine moderne
+normalmente bastano 17 cifre per esprimere esattamente il valore di un numero
+in virgola address@hidden casi eccezionali possono essere richieste fino
+a 752 cifre (!), non sembra che sia il caso di preoccuparsene qui.}
+
address@hidden angolo buio, variabile @code{CONVFMT}
+Si possono avere strani risultati se si imposta @code{CONVFMT} a una stringa
+che non indica a @code{sprintf()} come formattare i numeri in virgola mobile
+in un modo utile. Per esempio, se ci si dimentica la @samp{%} nel formato,
address@hidden converte tutti i numeri alla stessa stringa costante.
+
+Come caso particolare, per un numero intero, il risultato della conversione
+a una stringa @`e @emph{sempre} un numero intero, indipendentemente da quale
+sia il valore di @code{CONVFMT}. Dato il seguente fammento di codice:
+
address@hidden
+CONVFMT = "%2.2f"
+a = 12
+b = a ""
address@hidden example
+
address@hidden
address@hidden ha valore @code{"12"}, non @code{"12.00"}.
address@hidden
+
address@hidden @command{awk} prima di POSIX usava @code{OFMT} per la
conversione di stringhe
address@hidden POSIX @command{awk}, variabile @code{OFMT} e
address@hidden @code{OFMT}, variabile
address@hidden address@hidden, nuovo @command{awk} vs.@: vecchio @command{awk}
address@hidden @command{awk}, nuovo vs.@: vecchio, variabile @code{OFMT}
+Prima dello standard POSIX, @command{awk} usava il valore di @code{OFMT} per
+convertire i numeri in stringhe. @code{OFMT} specifica il formato di output da
+usare per la stampa dei numeri con @code{print}. @code{CONVFMT} fu introdotto
+per separare la semantica della conversione dalla semantica della stampa. Sia
address@hidden che @code{OFMT} hanno lo stesso valore di dafault:
address@hidden"%.6g"}. Nella stragrande maggioranza dei casi, i vecchi
programmi di
address@hidden non cambiano questo comportamento.
address@hidden per maggiori informazioni sull'istruzione @code{print}.
address@hidden sidebar
+
address@hidden Localizzazione e conversioni
address@hidden Le localizzazioni possono influire sulle conversioni
+
+Il luogo dove si @`e address@hidden avere importanza quando si tratta di
convertire numeri e
+stringhe. La lingua e i caratteri---la @dfn{localizzazione}---possono
+influire sui formati numerici. In particolare, per i programmi @command{awk},
+influiscono sui caratteri separatore decimale e separatore delle migliaia.
+La localizzazione @code{"C"}, e la maggior parte delle localizzazioni inglesi,
+usano il punto (@samp{.}) come separatore decimale e non prevedono un
+separatore delle
+migliaia. Tuttavia, molte (se non la maggior parte) delle localizzazioni
+europee e non inglesi usano la virgola (@samp{,}) come separatore dei decimali.
+Le localizzazioni europee spesso usano o lo spazio o il punto come separatore
+delle migliaia, all'occorrenza.
+
address@hidden angolo buio, carattere di separazione dei decimali nelle
localizzazioni
+Lo standard POSIX prevede che @command{awk} usi sempre il punto come separatore
+dei decimali nel codice sorgente del programma @command{awk}, e per
+gli assegnamenti di variabile da riga di comando (@pxref{Altri argomenti}).
+Tuttavia, nell'interpretazione dei dati in input, per l'output di
address@hidden e @code{printf}, e per la conversione da numeri a stringhe,
+viene usato il
+separatore decimale locale. @value{DARKCORNER} In ogni caso, i numeri nel
+codice sorgente e nei dati di input non possono avere un separatore delle
+migliaia. Di seguito sono riportati alcuni esempi che illustrano la differenza
+di comportamento, su un sistema GNU/Linux:
+
address@hidden
+$ @kbd{export POSIXLY_CORRECT=1} @ii{Forzare aderenza a
standard POSIX}
+$ @kbd{gawk 'BEGIN @{ printf "%g\n", 3.1415927 @}'}
address@hidden 3.14159
+$ @kbd{LC_ALL=en_DK.utf-8 gawk 'BEGIN @{ printf "%g\n", 3.1415927 @}'}
address@hidden 3,14159
+$ @kbd{echo 4,321 | gawk '@{ print $1 + 1 @}'}
address@hidden 5
+$ @kbd{echo 4,321 | LC_ALL=en_DK.utf-8 gawk '@{ print $1 + 1 @}'}
address@hidden 5,321
address@hidden example
+
address@hidden
+La localizzazione @code{en_DK.utf-8} @`e per l'inglese in Danimarca, dove
+le virgole fungono da separatore decimale. Nella localizzazione @code{"C"}
+normale, @command{gawk} tratta @samp{4,321} come 4, mentre nella localizzazione
+danese @`e trattato come numero completo comprendente la parte frazionaria,
+4.321.
+
+Alcune delle prime versioni di @command{gawk} si conformavano completamente con
+quest'aspetto dello standard. Tuttavia, molti utenti di localizzazioni non
+inglesi si lamentavano di questo comportamento, perch@'e i loro dati usavano il
+punto come separatore decimale, per cui fu ripristinato il comportamento di
+default che usava il punto come carattere di separazione decimale. Si
address@hidden
+usare l'opzione @option{--use-lc-numeric} (@pxref{Opzioni}) per forzare
address@hidden a usare il carattere separatore decimale della localizzazione.
+(@command{gawk} usa il separatore decimale della localizzazione anche quando
address@hidden in address@hidden POSIX, o con l'opzione @option{--posix} o con
la variabile
+d'ambiente @env{POSIXLY_CORRECT}, come appena visto.)
+
address@hidden descrive i casi in cui si usa il separatore decimale
+locale e quando si usa il punto. Alcune di queste address@hidden non sono
state
+ancora descritte.
+
address@hidden Tabella,table-locale-affects
address@hidden decimale locale o punto}
address@hidden @columnfractions .15 .25 .45
address@hidden Funzione @tab Default @tab @option{--posix} o
@option{--use-lc-numeric}
address@hidden @code{%'g} @tab Usa la localizzazione @tab Usa la localizzazione
address@hidden @code{%g} @tab Usa il punto @tab Usa la localizzazione
address@hidden Input @tab Usa il punto @tab Usa la localizzazione
address@hidden @code{strtonum()} @tab Usa il punto @tab Usa la localizzazione
address@hidden multitable
address@hidden float
+
+Infine, gli standard ufficiali correnti e la rappresentazione dei numeri
+in virgola mobile dello standard IEEE possono avere un effetto insolito ma
+importante sul modo in cui @command{gawk} converte alcuni valori di stringa
+speciali in
+numeri. I dettagli sono illustrati in @ref{Problemi virgola mobile POSIX}.
+
address@hidden Tutti gli operatori
address@hidden Operatori: fare qualcosa coi valori
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden introduce gli @dfn{operatori} che fanno uso
+dei valori forniti da costanti e variabili.
+
address@hidden
+* Operatori aritmetici:: Operazioni aritmetiche (@samp{+}, @samp{-},
+ etc.)
+* Concatenazione:: Concatenazione di stringhe.
+* Operatori di assegnamento:: Cambiare il valore di una variabile o di un
+ campo.
+* Operatori di incremento:: Incrementare il valore numerico di una
+ variabile.
address@hidden menu
+
address@hidden Operatori aritmetici
address@hidden Operatori aritmetici
address@hidden aritmetici, operatori
address@hidden operatori aritmetici
address@hidden @cindex addition
address@hidden @cindex subtraction
address@hidden @cindex multiplication
address@hidden @cindex division
address@hidden @cindex remainder
address@hidden @cindex quotient
address@hidden @cindex exponentiation
+
+Il linguaggio @command{awk} usa i comuni operatori aritmetici nella valutazione
+delle espressioni. Tutti questi operatori aritmetici seguono le normali regole
+di precedenza e funzionano come ci si aspetta.
+
+Il seguente esempio usa un file chiamato @file{grades}, che contiene
+una lista di nomi di studenti e anche i voti di tre verifiche per ogni studente
+(@`e una piccola classe):
+
address@hidden
+Pat 100 97 58
+Sandy 84 72 93
+Chris 72 92 89
address@hidden example
+
address@hidden
+Questo programma prende il file @file{grades} e stampa la media
+dei voti:
+
address@hidden
+$ @kbd{awk '@{ sum = $2 + $3 + $4 ; avg = sum / 3}
+> @kbd{print $1, avg @}' grades}
address@hidden Pat 85
address@hidden Sandy 83
address@hidden Chris 84.3333
address@hidden example
+
+La lista seguente elenca gli operatori aritmetici in @command{awk},
+in ordine di precedenza, da quella address@hidden alta a quella address@hidden
bassa:
+
address@hidden @code
address@hidden estensioni comuni, operatore @code{**}
address@hidden POSIX @command{awk}, operatori aritmetici e
address@hidden @var{x} ^ @var{y}
address@hidden @var{x} ** @var{y}
+Elevamento a potenza; @var{x} elevato alla potenza @var{y}. @samp{2 ^ 3}
+ha il valore otto; la sequenza di caratteri @samp{**} @`e equivalente a
address@hidden @value{COMMONEXT}
+
address@hidden - @var{x}
+Negazione.
+
address@hidden + @var{x}
address@hidden unario; l'espressione @`e convertita in un numero.
+
address@hidden @var{x} * @var{y}
+Moltiplicazione.
+
address@hidden risoluzione di problemi, divisione
address@hidden problemi, risoluzione di, divisione
address@hidden divisione
address@hidden @var{x} / @var{y}
+Divisione; poich@'e tutti i numeri in @command{awk} sono numeri in virgola
+mobile, il risultato @emph{non} @`e arrotondato all'address@hidden / 4} ha il
+valore di 0.75. (Un errore comune, specialmente tra i programmatori in C, @`e
+quello di dimenticare che @emph{tutti} i numeri in @command{awk} sono in
virgola mobile,
+e che la divisione di costanti rappresentate da numeri interi produce un
+numero reale, non un numero intero.)
+
address@hidden @var{x} % @var{y}
+Resto della divisione; subito dopo questa lista, l'argomento viene
+ulteriormente dettagliato.
+
address@hidden @var{x} + @var{y}
+Addizione.
+
address@hidden @var{x} - @var{y}
+Sottrazione.
address@hidden table
+
+Il address@hidden e il meno unari hanno la stessa precedenza,
+gli operatori di moltiplicazione hanno tutti la stessa precedenza, e
+l'addizione e la sottrazione hanno la stessa precedenza.
+
address@hidden differenze tra @command{awk} e @command{gawk}, operazione di
modulo-troncamento
address@hidden modulo-troncamento, operazione di
+Quando si calcola il resto di @address@hidden % @var{y}},
+il quoziente @`e troncato all'intero e
+moltiplicato per @var{y}. Questo risultato @`e sottratto da @var{x};
+quest'operazione @`e nota anche come ``modulo''. La seguente
+relazione @`e sempre verificata:
+
address@hidden
+b * int(a / b) + (a % b) == a
address@hidden example
+
+Un possibile effetto indesiderato di questa definizione di resto @`e che
address@hidden@var{x} % @var{y}} sia negativo se @var{x} @`e negativo.
address@hidden@dotless{i}}:
+
address@hidden
+-17 % 8 = -1
address@hidden example
+
+In altre implementazioni di @command{awk} il segno del resto
address@hidden essere dipendente dalla macchina.
address@hidden FIXME !!! what does posix say?
+
address@hidden address@hidden, operatore @code{**}
address@hidden @code{*} (asterisco), operatore @code{**}
address@hidden asterisco (@code{*}), operatore @code{**}
address@hidden NOTA
+Lo standard POSIX specifica solo l'uso di @samp{^}
+per l'elevamento a potenza.
+Per garantire la massima address@hidden @`e meglio non usare l'operatore
@samp{**}.
address@hidden quotation
+
address@hidden Concatenazione
address@hidden Concatenazione di stringhe
address@hidden Kernighan, Brian
address@hidden
address@hidden ci era sembrata una buona idea.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden operatori di stringa
address@hidden stringa, operatori di
address@hidden concatenare
+C'@`e una sola operazione di stringa: la concatenazione. Non ha un operatore
+specifico per rappresentarla. Piuttosto, la concatenazione @`e effettuata
+scrivendo le espressioni l'una vicino all'altra, senza alcun operatore.
+Per esempio:
+
address@hidden
+$ @kbd{awk '@{ print "Campo numero uno: " $1 @}' mail-list}
address@hidden Campo numero uno: Amelia
address@hidden Campo numero uno: Anthony
address@hidden
address@hidden example
+
+Senza lo spazio nella costante stringa dopo @samp{:}, la riga
+rimane unita. Per esempio:
+
address@hidden
+$ @kbd{awk '@{ print "Campo numero uno:" $1 @}' mail-list}
address@hidden Campo numero uno:Amelia
address@hidden Campo numero uno:Anthony
address@hidden
address@hidden example
+
address@hidden risoluzione di problemi, concatenazione di stringhe
address@hidden problemi, risoluzione di, concatenazione di stringhe
+Poich@'e la concatenazione di stringhe non ha un operatore esplicito, @`e
spesso
+necessario assicurarsi che venga effettuata al momento giusto usando le
+parentesi per racchiudere gli elementi da concatenare. Per esempio, ci si
+potrebbe aspettare che il
+seguente fammento di codice concateni @code{nome} e @code{file}:
+
address@hidden
+nome = "nome"
+file = "file"
+print "qualcosa di significativo" > nome file
address@hidden example
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden
+Questo produce un errore di sintassi in alcune versioni di
address@hidden per address@hidden@`o capitare che BWK
address@hidden, @command{gawk} e @command{mawk} lo interpretino nel modo giusto,
+ma non ci si dovrebbe fare affidamento.}
address@hidden necessario usare la seguente sintassi:
+
address@hidden
+print "qualcosa di significativo" > (nome file)
address@hidden example
+
address@hidden ordine di valutazione, concatenazione
address@hidden valutazione, ordine di, concatenazione
address@hidden effetti collaterali
+Si dovrebbero usare le parentesi attorno alle concatenazioni in tutti i
+contesti non comuni, come, per esempio, sul lato destro di @samp{=}.
+Bisogna stare attenti
+al tipo di espressioni usate nella concatenazione di stringhe. In particolare,
+l'ordine di valutazione di espressioni usate per la concatenazione non @`e
+definita nel linguaggio @command{awk}. Si consideri quest'esempio:
+
address@hidden
+BEGIN @{
+ a = "Non"
+ print (a " " (a = "v'allarmate"))
address@hidden
address@hidden example
+
address@hidden
+Non @`e definito se il secondo assegnamento ad @code{a} debba avvenire
+prima o dopo il recupero del valore di @code{a} per produrre il
+valore concatenato. Il risultato potrebbe essere sia @samp{Non v'allarmate},
+sia @samp{v'allarmate v'allarmate}.
address@hidden see test/nasty.awk for a worse example
+
+La precedenza della concatenazione, quando @`e in combinazione con altri
+operatori, @`e spesso controintuitiva. Si consideri questo esempio:
+
address@hidden
+> To: bug-gnu-utils@@gnu.org
+> CC: arnold@@gnu.org
+> Subject: gawk 3.0.4 bug with {print -12 " " -24}
+> From: Russell Schulz <address@hidden>
+> Date: Tue, 8 Feb 2000 19:56:08 -0700
+>
+> gawk 3.0.4 on NT gives me:
+>
+> prompt> cat bad.awk
+> BEGIN { print -12 " " -24; }
+>
+> prompt> gawk -f bad.awk
+> -12-24
+>
+> when I would expect
+>
+> -12 -24
+>
+> I have not investigated the source, or other implementations. The
+> bug is there on my NT and DOS versions 2.15.6 .
address@hidden ignore
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print -12 " " -24 @}'}
address@hidden -12-24
address@hidden example
+
+Quest'esempio, ``ovviamente'' concatena @minus{}12, uno spazio, e @minus{}24.
+Ma dov'@`e finito lo spazio?
+La risposta sta nella combinazione di precedenze di operatori e nelle regole di
+conversione automatica di @command{awk}. Per ottenere il risultato desiderato,
+si deve scrivere il programma in questo modo:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print -12 " " (-24) @}'}
address@hidden -12 -24
address@hidden example
+
+Questo forza il trattamento, da parte di @command{awk}, del @samp{-} del
address@hidden come operatore unario. Altrimenti @`e analizzato in questo modo:
+
address@hidden
+ @minus{}12 (@code{"@ "} @minus{} 24)
address@hidden @minus{}12 (0 @minus{} 24)
address@hidden @minus{}12 (@minus{}24)
address@hidden @address@hidden
address@hidden display
+
+Come si @`e detto precedentemente,
+quando si usa la concatenazione insieme ad altri operatori, @`e necessario
address@hidden le parentesi}. Altrimenti, non si address@hidden essere mai
completamente
+certi di quel che si ottiene.
+
address@hidden Operatori di assegnamento
address@hidden Espressioni di assegnamento
address@hidden operatori di assegnamento
address@hidden assegnamento, operatori di
address@hidden espressioni di assegnamento
address@hidden @code{=} (uguale), operatore @code{=}
address@hidden uguale (@code{=}), operatore @code{=}
+Un @dfn{assegnamento} @`e un'espressione che memorizza un valore (generalmente
+diverso da quello che la variabile aveva in precedenza) in una variabile.
+Per esempio, si assegni il valore uno alla variabile @code{z}:
+
address@hidden
+z = 1
address@hidden example
+
+Dopo l'esecuzione di quest'espressione, la variabile @code{z} ha il valore
+uno. Qualsiasi precedente valore di @code{z} prima dell'assegnamento
+viene dimenticato.
+
+Gli assegnamenti possono anche memorizzare valori di stringa. Il seguente
+esempio memorizza
+il valore @code{"questo cibo @`e buono"} nella variabile @code{messaggio}:
+
address@hidden
+cosa = "cibo"
+predicato = "buono"
+messaggio = "questo " cosa " @`e " predicato
address@hidden example
+
address@hidden
address@hidden effetti collaterali, espressioni di assegnamento
+Quest'esempio illustra anche la concatenazione di stringhe.
+Il segno @samp{=} @`e un @dfn{operatore di assegnamento}. @`E il
address@hidden semplice
+fra gli operatori di assegnamento perch@'e il valore dell'operando di destra
address@hidden memorizzato invariato.
+La maggior parte degli operatori (addizione, concatenazione e
address@hidden@dotless{i}} via) non
+fanno altro che calcolare un valore. Se il valore non viene poi utilizzato
non c'@`e alcun
+motivo per usare l'operatore. Un operatore di assegnamento @`e differente;
+produce un valore; anche se poi non lo si usa, l'assegnamento svolge ancora
+una funzione alterando la variabile. Chiamiamo questo
+un @dfn{effetto collaterale}.
+
address@hidden @dfn{lvalue/rvalue}
address@hidden @dfn{rvalue/lvalue}
address@hidden assegnamento, operatori di, @dfn{lvalue/rvalue}
address@hidden operatori di assegnamento
+L'operando di sinistra non dev'essere necessariamente una variabile
+(@pxref{Variabili}); address@hidden essere anche un campo
+(@pxref{Cambiare i campi}) o
address@hidden
+un elemento di un vettore (@pxrefil{Vettori}).
address@hidden iftex
address@hidden
+un elemento di un vettore (@pxref{Vettori}).
address@hidden ifnottex
+Questi operandi sono chiamati @dfn{lvalue}, il
+che significa che possono apparire sul lato sinistro di un operatore di
+assegnamento. L'operando sul lato destro address@hidden essere qualsiasi
espressione;
+produce un nuovo valore che l'assegnamento memorizza nella variabile, nel campo
+o nell'elemento di vettore specificati. Tali valori sono chiamati
address@hidden
+
address@hidden variabili, tipi di
address@hidden importante notare che le variabili @emph{non} hanno dei tipi
permanenti.
+Il tipo di una variabile @`e semplicemente quello di qualsiasi valore le sia
stato
+assegnato per ultimo. Nel seguente frammento di programma, la variabile
address@hidden ha dapprima un valore numerico, e in seguito un valore di
stringa:
+
address@hidden
+pippo = 1
+print pippo
+pippo = "pluto"
+print pippo
address@hidden example
+
address@hidden
+Quando il secondo assegnamento address@hidden a @code{pippo} un valore di
stringa, il fatto
+che avesse precedentemente un valore numerico viene dimenticato.
+
+Ai valori di stringa che non iniziano con una cifra viene assegnato il valore
+numerico zero. Dopo l'esecuzione del seguente codice, il valore di
@code{pippo} @`e
+cinque:
+
address@hidden
+pippo = "una stringa"
+pippo = pippo + 5
address@hidden example
+
address@hidden NOTA
+Usare una variabile sia come numero che come stringa address@hidden originare
confusione
+e denota uno stile di programmazione scadente. I due esempi precedenti
+illustrano come funziona @command{awk}, @emph{non} come si dovrebbero scrivere
+i programmi!
address@hidden quotation
+
+Un assegnamento @`e un'espressione, per cui ha un valore: lo stesso valore che
+le @`e stato assegnato. address@hidden@dotless{i}}, @samp{z = 1} @`e
un'espressione col valore uno.
+Una conseguenza di address@hidden @`e che si possono scrivere address@hidden
assegnamenti insieme,
+come:
+
address@hidden
+x = y = z = 5
address@hidden example
+
address@hidden
+Quest'esempio memorizza il valore cinque in tutte e tre le variabili,
+(@code{x}, @code{y} e @code{z}).
+Questo perch@'e il
+valore di @samp{z = 5}, che @`e cinque, @`e memorizzato in @code{y} e poi
+il valore di @samp{y = z = 5}, che @`e cinque, @`e memorizzato in @code{x}.
+
+Gli assegnamenti possono essere usati ovunque sia prevista un'espressione. Per
+esempio, @`e valido scrivere @samp{x != (y = 1)} per impostare @code{y} a
+uno, e poi verificare se @code{x} @`e uguale a uno. address@hidden questo
stile rende i
+programmi difficili da leggere; una tale nidificazione di assegnamenti dovrebbe
+essere evitata, eccetto forse in un programma usa-e-getta.
+
address@hidden @code{+} (address@hidden), operatore @code{+=}
address@hidden address@hidden (@code{+}), operatore @code{+=}
+Accanto a @samp{=}, ci sono diversi altri operatori di assegnamento che
+eseguono calcoli col vecchio valore di una variabile. Per esempio,
+l'operatore @samp{+=} calcola un nuovo valore aggiungendo il valore sul lato
+destro al vecchio valore di una variabile. address@hidden@dotless{i}}, il
seguente assegnamento
+aggiunge cinque al valore di @code{pippo}:
+
address@hidden
+pippo += 5
address@hidden example
+
address@hidden
+Questo @`e equivalente a:
+
address@hidden
+pippo = pippo + 5
address@hidden example
+
address@hidden
+Si usi la notazione che rende address@hidden chiaro il significato del
programma.
+
+Ci sono situazioni in cui usare @samp{+=} (o qualunque operatore di
+assegnamento) @emph{non} @`e la stessa cosa che ripetere semplicemente
l'operando
+di sinistra nell'espressione di destra. Per esempio:
+
address@hidden Rankin, Pat
address@hidden
+# Grazie a Pat Rankin per quest'esempio
+BEGIN @{
+ pippo[rand()] += 5
+ for (x in pippo)
+ print x, pippo[x]
+
+ pluto[rand()] = pluto[rand()] + 5
+ for (x in pluto)
+ print x, pluto[x]
address@hidden
address@hidden example
+
address@hidden operatori di assegnamento, ordine di valutazione
address@hidden assegnamento, operatori di, ordine di valutazione
address@hidden
address@hidden praticamente certo che gli indici di @code{pluto} siano
differenti, perch@'e
address@hidden()} restituisce valori differenti ogni volta che viene chiamata.
+(I vettori e la funzione @code{rand()} non sono ancora stati trattati.
address@hidden
address@hidden,
address@hidden iftex
address@hidden
address@hidden,
address@hidden ifnottex
+e
address@hidden
address@hidden numeriche}
address@hidden ifnotdocbook
address@hidden
address@hidden numeriche}
address@hidden ifdocbook
+per maggiori informazioni.)
+Quest'esempio illustra un fatto importante riguardo agli operatori di
+assegnamento: l'espressione di sinistra viene valutata @emph{una volta sola}.
+
+Dipende dall'implementazione stabilire quale espressione valutare per
+prima, se quella di sinistra o quella di destra.
+Si consideri quest'esempio:
+
address@hidden
+i = 1
+a[i += 2] = i + 1
address@hidden example
+
address@hidden
+Il valore di @code{a[3]} potrebbe essere sia due sia quattro.
+
+La @ref{table-assign-ops} elenca gli operatori di assegnamento aritmetici. In
+ogni caso, l'operando di destra @`e un'espressione il cui valore @`e
convertito in
+un numero.
+
address@hidden @code{-} (meno), operatore @code{-=}
address@hidden meno (@code{-}), operatore @code{-=}
address@hidden @code{*} (asterisco), operatore @code{*=}
address@hidden asterisco (@code{*}), operatore @code{*=}
address@hidden @code{/} (barra), operatore @code{/=}
address@hidden barra (@code{/}), operatore @code{/=}
address@hidden @code{%} (percento), operatore @code{%=}
address@hidden percento (@code{%}), operatore @code{%=}
address@hidden @code{^} (circonflesso), operatore @code{^=}
address@hidden circonflesso (@code{^}), operatore @code{^=}
address@hidden @code{*} (asterisco), operatore @code{**=}
address@hidden asterisco (@code{*}), operatore @code{**=}
address@hidden Tabella,table-assign-ops
address@hidden di assegnamento aritmetici}
address@hidden @columnfractions .30 .70
address@hidden Operatore @tab Effetto
address@hidden @var{lvalue} @code{+=} @var{incremento} @tab Aggiunge
@var{incremento} al valore di @var{lvalue}.
address@hidden @var{lvalue} @code{-=} @var{decremento} @tab Sottrae
@var{decremento} dal valore di @var{lvalue}.
address@hidden @var{lvalue} @code{*=} @var{coefficiente} @tab Moltiplica il
valore di @var{lvalue} per @var{coefficiente}.
address@hidden @var{lvalue} @code{/=} @var{divisore} @tab Divide il valore di
@var{lvalue} per @var{divisore}.
address@hidden @var{lvalue} @code{%=} @var{modulo} @tab Imposta @var{lvalue} al
resto della sua divisione per @var{modulo}.
address@hidden estensioni comuni, operatore @code{**=}
address@hidden estensioni address@hidden operatore @code{**=}
address@hidden @command{awk}, linguaggio, versione POSIX
address@hidden POSIX @command{awk}
address@hidden @var{lvalue} @code{^=} @var{esponente} @tab Eleva @var{lvalue}
alla potenza @var{esponente}.
address@hidden @var{lvalue} @code{**=} @var{esponente} @tab Eleva @var{lvalue}
alla potenza @var{esponente}. @value{COMMONEXT}
address@hidden multitable
address@hidden float
+
address@hidden POSIX @command{awk}, operatore @code{**=} e
address@hidden address@hidden, operatore @code{**=}
address@hidden NOTA
+Soltanto l'operatore @samp{^=} @`e definito da POSIX.
+Per avere la massima address@hidden, non usare l'operatore @samp{**=}.
address@hidden quotation
+
address@hidden address@hidden sintattiche tra @samp{/=} e le espressioni
regolari
address@hidden angolo buio, costanti @dfn{regexp}, operatore @code{/=} e
address@hidden @code{/} (barra), operatore @code{/=}, vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden barra (@code{/}), operatore @code{/=}, vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden @dfn{regexp}, costanti, @code{/address@hidden/}, operatore
@code{/=} e
+
address@hidden derived from email from "Nelson H. F. Beebe" <address@hidden>
address@hidden Date: Mon, 1 Sep 1997 13:38:35 -0600 (MDT)
+
address@hidden angolo buio, operatore @code{/=} vs. costante @dfn{regexp}
@code{/address@hidden/}
address@hidden address@hidden sintattica: operatore @code{/=} vs. costante
@dfn{regexp} @code{/address@hidden/}
address@hidden sintattica, address@hidden: operatore @code{/=} vs. costante
@dfn{regexp} @code{/address@hidden/}
address@hidden @code{/=}, operatore, vs. costante @dfn{regexp}
@code{/address@hidden/}
+C'@`e un'address@hidden sintattica tra l'operatore di assegnamento @code{/=}
+e le costanti @dfn{regexp} il cui primo carattere sia @samp{=}.
address@hidden
+Questo @`e address@hidden evidente in alcune versioni commerciali di
@command{awk}.
+Per esempio:
+
address@hidden
+$ @kbd{awk /==/ /dev/null}
address@hidden awk: syntax error at source line 1
address@hidden context is
address@hidden >>> /= <<<
address@hidden awk: bailing out at source line 1
address@hidden example
+
address@hidden
+Un espediente @`e:
+
address@hidden
+awk '/[=]=/' /dev/null
address@hidden example
+
address@hidden non ha questo problema, e neppure lo hanno BWK @command{awk}
+e @command{mawk}.
address@hidden sidebar
+
address@hidden Operatori di incremento
address@hidden Operatori di incremento e di decremento
+
address@hidden incremento, operatori di
address@hidden operatori di decremento/incremento
+Gli @dfn{operatori di incremento} e @dfn{decremento} incrementano o riducono il
+valore di una variabile di uno. Un operatore di assegnamento address@hidden
fare la
+stessa cosa, per cui gli operatori di incremento non aggiungono address@hidden
+al inguaggio @command{awk}; in ogni caso, sono delle convenienti abbreviazioni
+per operazioni molto comuni.
+
address@hidden effetti collaterali
address@hidden @code{+} (address@hidden), operatore @code{++}
address@hidden address@hidden (@code{+}), operatore @code{++}
address@hidden effetti collaterali, operatori di decremento/incremento
+L'operatore per aggiungere uno @`e @samp{++}. address@hidden essere usato per
incrementare
+una variabile prima o dopo aver stabilito il suo valore. Per
@dfn{preincrementare}
+una variabile @code{v}, si scrive @samp{++v}. Questo aggiunge uno al valore di
address@hidden; questo nuovo valore @`e anche il valore dell'espressione.
+(L'espressione di assegnamento @samp{v += 1} @`e totalmente equivalente.)
+Scrivendo @samp{++} dopo la variabile si specifica un @dfn{postincremento}.
+Questo incrementa il valore della variabile nello stesso modo; la differenza
@`e
+che il valore dell'espressione d'incremento @`e il @emph{vecchio} valore della
+variabile. address@hidden@dotless{i}}, se @code{pippo} ha il valore quattro,
l'espressione
address@hidden ha il valore quattro, ma cambia il valore di @code{pippo} in
cinque.
+In altre parole, l'operatore restituisce il vecchio valore della variabile, ma
+con l'effetto collaterale di incrementarlo.
+
+Il postincremento @samp{pippo++} @`e quasi come scrivere @samp{(pippo += 1) -
1}.
+Non @`e perfettamente equivalente perch@'e tutti i numeri in @command{awk}
sono in
+virgola mobile. In virgola mobile, @samp{pippo + 1 - 1} non @`e
necessariamente
+uguale a @code{pippo}, ma la differenza @`e molto piccola finch@'e si ha a che
+fare con numeri relativamente piccoli (inferiori a
address@hidden
address@hidden).
address@hidden iftex
address@hidden
+10e12).
address@hidden ifinfo
address@hidden
address@hidden
address@hidden).
address@hidden ifnotinfo
address@hidden ifnottex
+
address@hidden @code{$} (dollaro), incrementare campi e vettori
address@hidden dollaro (@code{$}), incrementare campi e vettori
+I campi di un record e gli elementi di un vettore vengono incrementati
+proprio come le
+variabili. (Si deve usare @samp{$(i++)} quando si deve fare un riferimento a
+un campo e incrementare una variabile allo stesso tempo. Le parentesi sono
+necessarie a causa della precedenza dell'operatore di riferimento @samp{$}.)
+
address@hidden decremento, operatori di
+L'operatore di decremento @samp{--} funziona proprio come @samp{++}, solo che
+sottrae uno anzich@'e aggiungerlo. Come @samp{++}, si address@hidden usare
prima di
address@hidden
+per predecrementare o dopo per postdecrementare.
+Quel che segue @`e un sommario delle espressioni di incremento e di
+decremento:
+
address@hidden @code
address@hidden @code{+} (address@hidden), operatore @code{++}
address@hidden address@hidden (@code{+}), operatore @code{++}
address@hidden address@hidden
+Incrementa @var{lvalue}, restituendo il nuovo valore come
+valore dell'espressione.
+
address@hidden @var{lvalue}++
+Incrementa @var{lvalue}, restituendo il @emph{vecchio} valore di @var{lvalue}
+come valore dell'espressione.
+
address@hidden @code{-} (meno), operatore @code{--}
address@hidden meno (@code{-}), operatore @code{--}
address@hidden address@hidden
+Decrementa @var{lvalue}, restituendo il nuovo valore come
+valore dell'espressione.
+(Quest'espressione @`e come
address@hidden@var{lvalue}}, ma invece di aggiungere, sottrae.)
+
address@hidden @var{lvalue}--
+Decrementa @var{lvalue}, restituendo il @emph{vecchio} valore di @var{lvalue}
+come valore dell'espressione.
+(Quest'espressione @`e come
address@hidden@var{lvalue}++}, ma invece di aggiungere, sottrae.)
address@hidden table
+
address@hidden Ordine di valutazione degli operatori
address@hidden precedenza
address@hidden operatori, precedenza
address@hidden address@hidden, operatori
address@hidden valutazione, ordine di
address@hidden Marx, Groucho
address@hidden
address@hidden, quando faccio address@hidden@dotless{i}} mi fa address@hidden
+E allora non farlo!}
address@hidden Groucho Marx
address@hidden quotation
+
address@hidden
+Che cosa succede con qualcosa come questo?
+
address@hidden
+b = 6
+print b += b++
address@hidden example
+
address@hidden
+O con qualcosa di address@hidden strano ancora?
+
address@hidden
+b = 6
+b += ++b + b++
+print b
address@hidden example
+
address@hidden effetti collaterali
+In altre parole, quando hanno effetto i vari effetti collaterali previsti
+dagli operatori col suffisso (@samp{b++})? Quando gli effetti collaterali
+si verificano @`e @dfn{definito dall'implementazione}.
+Per dirla diversamente, questo @`e compito di ogni specifica versione di
address@hidden Il risultato del primo esempio address@hidden essere 12 o 13, e
del
+secondo address@hidden essere 22 o 23.
+
+In breve, @`e sconsigliato fare cose come questa e, in ogni caso,
+ogni cosa che possa incidere sulla address@hidden
+Si dovrebbero evitare cose come queste nei programmi.
address@hidden You'll sleep better at night and be able to look at yourself
address@hidden in the mirror in the morning.
address@hidden sidebar
+
address@hidden Valori e condizioni di address@hidden
address@hidden Valori e condizioni di address@hidden
+
+In certi contesti, i valori delle espressioni servono anche come
+``valori di address@hidden''; address@hidden, determinano quale address@hidden
la direzione che il
+programma address@hidden durante la sua esecuzione. Questa
address@hidden descrive come @command{awk} definisce ``vero'' e ``falso''
+e come questi valori sono confrontati.
+
address@hidden
+* Valori di address@hidden:: Cos'@`e ``vero'' e cos'@`e ``falso''.
+* Tipi di variabile e confronti:: Come alle variabili si assegna il tipo e
+ l'effetto che questo ha sul confronto di
+ numeri e stringhe con @samp{<}, etc.
+* Operatori booleani:: Combinare espressioni di confronto usando
+ operatori booleani @samp{||} (``or''),
+ @samp{&&} (``and'') e @samp{!} (``not'').
+* Espressioni condizionali:: Le espressioni condizionali scelgono una fra
+ due sottoespressioni, a seconda del valore di
+ una terza sottoespressione.
address@hidden menu
+
address@hidden Valori di address@hidden
address@hidden Vero e falso in @command{awk}
address@hidden valori di address@hidden
address@hidden logico, valore, vero/falso
address@hidden falso, valore logico (zero o stringa nulla)
address@hidden vero, valore logico (diverso da zero e da stringa nulla)
+
address@hidden nulle, stringhe
+Molti linguaggi di programmazione hanno una particolare rappresentazione per i
+concetti di ``vero'' e ``falso.'' Questi linguaggi usano normalmente le
+costanti speciali @code{true} e @code{false}, o forse i loro equivalenti
+maiuscoli.
address@hidden @command{awk} @`e differente.
+Prende in prestito un concetto molto semplice di vero e falso dal linguaggio
+C. In @command{awk}, ogni valore numerico diverso da zero @emph{oppure}
+ogni valore di stringa non vuota @`e vero. Ogni altro valore (zero o la
stringa
+nulla, @code{""}) @`e falso. Il seguente programma stampa @samp{Uno strano
+valore di address@hidden tre volte:
+
address@hidden
+BEGIN @{
+ if (3.1415927)
+ print "Uno strano valore di address@hidden"
+ if ("Ottanta e sette anni or sono")
+ print "Uno strano valore di address@hidden"
+ if (j = 57)
+ print "Uno strano valore di address@hidden"
address@hidden
address@hidden example
+
address@hidden angolo buio, @code{"0"} @`e effettivamente vero
+C'@`e una conseguenza sorprendente della regola ``non zero o non nullo'':
+la costante di stringa @code{"0"} sta effettivamente per vero, perch@'e
address@hidden non nulla.
address@hidden
+
address@hidden Tipi di variabile e confronti
address@hidden Tipi di variabile ed espressioni di confronto
address@hidden
address@hidden Guida galattica @`e infallibile. @`E la address@hidden, spesso,
a essere inesatta.}
address@hidden Douglas Adams, @cite{Guida galattica per autostoppisti}
address@hidden quotation
address@hidden 2/2015: Antonio Colombo points out that this is really from
address@hidden The Restaurant at the End of the Universe. But I'm going to
address@hidden leave it alone.
+
address@hidden confronto, espressioni di
address@hidden espressioni di confronto
address@hidden espressioni, ricerca di corrispondenze, si veda espressioni di
confronto
address@hidden individuazione, espressioni di, si veda espressioni di confronto
address@hidden relazionali, operatori, si veda espressioni di confronto
address@hidden operatori relazionali, si veda espressioni di confronto
address@hidden variabile, tipi di
address@hidden variabili, tipi di, espressioni di confronto e
+Diversamente che in altri linguaggi di programmazione, le variabili di
address@hidden non hanno un tipo fisso. Possono essere sia un numero che una
+stringa, a seconda del valore loro assegnato.
+Vediamo ora come viene assegnato il tipo a una variabile, e come @command{awk}
+le confronta.
+
address@hidden
+* Tipi di variabile:: Tipo stringa rispetto a tipo numero.
+* Operatori di confronto:: Gli operatori di confronto.
+* Confronto POSIX di stringhe:: Confronto tra stringhe usando le
+ regole POSIX.
address@hidden menu
+
address@hidden Tipi di variabile
address@hidden Tipo stringa rispetto a tipo numero
+
+Per gli elementi scalari in @command{awk} (variabili, elementi di
+vettore e campi), il tipo degli stessi viene attribuito @emph{dinamicamente}.
address@hidden significa che il tipo di un elemento address@hidden cambiare nel
corso
+dell'esecuzione di un programma, da @dfn{untyped} (non ancora tipizzata),
+valore assunto prima che la variabile sia utilizzata,@address@hidden
+chiama queste variabili @dfn{unassigned} (non ancora assegnate), come si
+vede dall'esempio che segue.} a stringa oppure a numero, e in seguito
+da stringa a numero o da numero a stringa, nel prosieguo del programma.
+(@command{gawk} prevede anche degli scalari di tipo @dfn{regexp}, ma
+per ora possiamo ignorarli;
address@hidden @dfn{regexp} forti}.)
+
+Non si address@hidden fare molto riguardo alle variabili di tipo @dfn{untyped},
+oltre a constatare che ancora non @`e stato loro attribuito un tipo.
+Il seguente programma confronta la variabile @code{a} con i valori
address@hidden""} e @code{0}; il confronto address@hidden esito positivo se alla
+variabile @code{a} non @`e mai stato assegnato un valore.
+L'esempio usa la funzione predefinita @code{typeof()}
+(non ancora trattata; @pxref{Funzioni per i tipi}) per
+visualizzare il tipo della variabile @code{a}:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print (a == "" && a == 0 ?}
+> @kbd{"a non ha un tipo" : "a ha un tipo!") ; print typeof(a) @}'}
address@hidden a non ha un tipo
address@hidden unassigned
address@hidden example
+
+Una variabile scalare diviene di tipo numerico quando le viene assegnato un
+valore numerico, per mezzo di una costante numerica, o tramite un'altra
+variabile scalare di tipo numerico:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ a = 42 ; print typeof(a)}
+> @kbd{b = a ; print typeof(b) @}'}
+number
+number
address@hidden example
+
+Analogamente, una variabile scalare diviene di tipo stringa quando le
+viene assegnato come valore una stringa, per mezzo di una costante stringa,
+o tramite un'altra variabile scalare di tipo stringa:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ a = "quarantadue" ; print typeof(a)}
+> @kbd{b = a ; print typeof(b) @}'}
+string
+string
address@hidden example
+
+Fin qui, tutto semplice e chiaro. Cosa succede, address@hidden, quando
address@hidden deve trattare dati forniti dall'utente?
+Il primo caso da considerare @`e quello dei campi di dati in input.
+Quale dovrebbe essere l'output del seguente programma?
+
address@hidden
+echo ciao | awk '@{ printf("%s %s < 42\n", $1,
+ ($1 < 42 ? "@`e" : "non @`e")) @}'
address@hidden example
+
address@hidden
+Poich@'e @samp{ciao} @`e un dato di tipo alfabetico, @command{awk}
address@hidden solo
+effettuare un confronto di tipo stringa. Internamente, il numero @code{42}
+viene convertito in @code{"42"} e vengono confrontate le due stringhe di
+valore @code{"ciao"} e @code{"42"}. Questo @`e il risultato:
+
address@hidden
+$ @kbd{echo ciao | awk '@{ printf("%s %s < 42\n", $1,}
+> @kbd{ ($1 < 42 ? "@`e" : "non @`e")) @}'}
address@hidden ciao non @`e < 42
address@hidden example
+
+Tuttavia, cosa succede quando un dato utente @emph{assomiglia} a un
+numero?
+Da un lato, in address@hidden, il dato in input @`e formato da alcuni
caratteri, non da
+valori numerici in formato binario. Ma, d'altro lato, il dato sembra
+numerico, e @command{awk} dovrebbe davvero trattarlo come tale. E in effetti
+questo @`e address@hidden che avviene:
+
address@hidden
+$ @kbd{echo 37 | awk '@{ printf("%s %s < 42\n", $1,}
+> @kbd{ ($1 < 42 ? "@`e" : "non @`e")) @}'}
address@hidden 37 is < 42
address@hidden example
+
+Queste sono le regole seguite per determinare quando @command{awk}
+tratta dei dati in input come numeri, e quando li considera stringhe.
+
address@hidden numeriche, stringhe
address@hidden stringhe, numeriche
address@hidden POSIX @command{awk}, stringhe numeriche e
+Lo standard POSIX usa il concetto di @dfn{stringa numerica}, per dei dati
+in input che appaiono essere numerici. Il @samp{37} nell'esempio precedente
address@hidden una stringa numerica. Quindi, qual @`e il tipo di una stringa
numerica?
+Risposta: numerico.
+
+Il tipo di una variabile @`e importante perch@'e il tipo di due variabili
+determina il modo con cui le stesse vengono confrontate.
+La determinazione del tipo di variabile segue queste regole:
+
address@hidden @value{BULLET}
address@hidden
+Una costante numerica o il risultato di un'operazione numerica ha l'attributo
address@hidden
+
address@hidden
+Una costante di stringa o il risultato di un'operazione di stringa ha
+l'attributo @dfn{string}.
+
address@hidden
+Campi, input tramite @code{getline}, @code{FILENAME}, elementi di
address@hidden, elementi di @code{ENVIRON}, e gli elementi di un vettore
+creato da @code{match()}, @code{split()} e @code{patsplit()} che sono
+stringhe numeriche hanno l'attributo @address@hidden, una
+stringa numerica POSIX e una variabile tipo @dfn{strnum} di @command{gawk}
+sono equivalenti.}
+Altrimenti, hanno l'attributo @dfn{string}.
+Anche le variabili non inizializzate hanno l'attributo @var{strnum}.
+
address@hidden
+Gli attributi si trasmettono attraverso gli assegnamenti ma non vengono
+cambiati da nessun uso.
address@hidden (Although a use may cause the entity to acquire an additional
address@hidden value such that it has both a numeric and string value, this
leaves the
address@hidden attribute unchanged.)
address@hidden This is important but not relevant
address@hidden itemize
+
+L'ultima regola @`e particolarmente importante. Nel seguente programma,
address@hidden @`e di tipo numerico, anche se viene usata in un secondo momento
in
+un'operazione di stringa:
+
address@hidden
+BEGIN @{
+ a = 12.345
+ b = a " @`e un numero carino"
+ print b
address@hidden
address@hidden example
+
+Quando si confrontano due operandi, address@hidden essere usata sia il
confronto come
+stringa che il confronto numerico, a seconda degli attributi degli operandi,
+secondo questa matrice simmetrica:
+
address@hidden thanks to Karl Berry, address@hidden, for major help with TeX
tables
address@hidden
+\centerline{
+\vbox{\bigskip % space above the table (about 1 linespace)
+% Because we have vertical rules, we can't let TeX insert interline space
+% in its usual way.
+\offinterlineskip
+%
+% Define the table template. & separates columns, and \cr ends the
+% template (and each row). # is replaced by the text of that entry on
+% each row. The template for the first column breaks down like this:
+% \strut -- a way to make each line have the height and depth
+% of a normal line of type, since we turned off interline spacing.
+% \hfil -- infinite glue; has the effect of right-justifying in this case.
+% # -- replaced by the text (for instance, `STRNUM', in the last row).
+% \quad -- about the width of an `M'. Just separates the columns.
+%
+% The second column (\vrule#) is what generates the vertical rule that
+% spans table rows.
+%
+% The doubled && before the next entry means `repeat the following
+% template as many times as necessary on each line' -- in our case, twice.
+%
+% The template itself, \quad#\hfil, left-justifies with a little space before.
+%
+\halign{\strut\hfil#\quad&\vrule#&&\quad#\hfil\cr
+ &&STRING &NUMERIC &STRNUM\cr
+% The \omit tells TeX to skip inserting the template for this column on
+% this particular row. In this case, we only want a little extra space
+% to separate the heading row from the rule below it. the depth 2pt --
+% `\vrule depth 2pt' is that little space.
+\omit &depth 2pt\cr
+% This is the horizontal rule below the heading. Since it has nothing to
+% do with the columns of the table, we use \noalign to get it in there.
+\noalign{\hrule}
+% Like above, this time a little more space.
+\omit &depth 4pt\cr
+% The remaining rows have nothing special about them.
+STRING &&string &string &string\cr
+NUMERIC &&string &numeric &numeric\cr
+STRNUM &&string &numeric &numeric\cr
+}}}
address@hidden tex
address@hidden
address@hidden
address@hidden
+ +----------------------------------------------
+ | STRING NUMERIC STRNUM
+--------+----------------------------------------------
+ |
+STRING | string string string
+ |
+NUMERIC | string numeric numeric
+ |
+STRNUM | string numeric numeric
+--------+----------------------------------------------
address@hidden verbatim
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<informaltable>
+<tgroup cols="4">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<colspec colname="3" align="left"/>
+<colspec colname="4" align="left"/>
+<thead>
+<row>
+<entry/>
+<entry>STRING</entry>
+<entry>NUMERIC</entry>
+<entry>STRNUM</entry>
+</row>
+</thead>
+
+<tbody>
+<row>
+<entry><emphasis role="bold">STRING</emphasis></entry>
+<entry>string</entry>
+<entry>string</entry>
+<entry>string</entry>
+</row>
+
+<row>
+<entry><emphasis role="bold">NUMERIC</emphasis></entry>
+<entry>string</entry>
+<entry>numeric</entry>
+<entry>numeric</entry>
+</row>
+
+<row>
+<entry><emphasis role="bold">STRNUM</emphasis></entry>
+<entry>string</entry>
+<entry>numeric</entry>
+<entry>numeric</entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
+L'idea di base @`e che l'input dell'utente che appare come numerico---e
address@hidden l'input dell'utente---dovrebbe essere trattato come numerico,
anche
+se in address@hidden @`e un insieme di caratteri e quindi anche una stringa.
address@hidden@dotless{i}}, ad esempio, la costante di stringa @address@hidden"
+3.14"}},
+quando appare nel codice sorgente di un programma,
address@hidden una stringa---anche se sembra numerica---e non
+viene @emph{mai} trattato come numero
+ai fini di un confronto.
+
+In breve, quando un operando @`e una stringa ``pura'', come una costante di
+stringa, viene effettuato un confronto di stringa. In caso contrario viene
+effettuato un confronto numerico.
+(La differenza principale tra un numero e uno @dfn{strnum} @`e che per gli
address@hidden @command{gawk} conserva anche il valore originale della stringa
+che la variabile scalare aveva al momento in cui @`e stata letta.
+
+Questo punto merita di essere ulteriormente ribadito:
+l'input che appare essere un numero @address@hidden numerico.
+Tutto il resto dell'input @`e considerato essere una stringa.
+
address@hidden@dotless{i}}, la stringa in input di sei caratteri
@address@hidden +3.14}}
+riceve l'attributo @dfn{strnum}. Al contrario, la stringa di sei caratteri
address@hidden@code{" +3.14"}} che compaia nel testo di un programma rimane una
+costante di stringa. I seguenti esempi stampano @samp{1} quando il confronto
+fra due diverse costanti @`e vero, altrimenti stampano @samp{0}:
+
address@hidden 22.9.2014: Tested with mawk and BWK awk, got same results.
address@hidden
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == " +3.14") @}'} @ii{Vero}
address@hidden 1
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == "+3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == "3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($0 == 3.14) @}'} @ii{Vero}
address@hidden 1
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == " +3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == "+3.14") @}'} @ii{Vero}
address@hidden 1
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == "3.14") @}'} @ii{Falso}
address@hidden 0
+$ @kbd{echo ' +3.14' | awk '@{ print($1 == 3.14) @}'} @ii{Vero}
address@hidden 1
address@hidden example
+
+Per controllare il tipo di un campo in input (o di altro input immesso
+dall'utente, si address@hidden usare @code{typeof()}:
+
address@hidden
+$ @kbd{echo salve 37 | gawk '@{ print typeof($1), typeof($2) @}'}
address@hidden string strnum
address@hidden example
+
address@hidden Operatori di confronto
address@hidden Operatori di confronto
+
+Le @dfn{espressioni di confronto} confrontano stringhe o numeri per metterli in
+relazione tra di loro, come ad esempio nella relazione di uguaglianza. Sono
+scritte usando @dfn{operatori di relazione}, che sono un superinsieme di quelli
+in C. Sono descritti nella @ref{table-relational-ops}.
+
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<}
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<=}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>=}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>}
address@hidden @code{=} (uguale), operatore @code{==}
address@hidden uguale (@code{=}), operatore @code{==}
address@hidden @code{!} (punto esclamativo), operatore @code{!=}
address@hidden punto esclamativo (@code{!}), operatore @code{!=}
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @code{in}, operatore
address@hidden Tabella,table-relational-ops
address@hidden di relazione}
address@hidden @columnfractions .23 .77
address@hidden Espressione @tab Risultato
address@hidden @var{x} @code{<} @var{y} @tab Vero se @var{x} @`e minore di
@var{y}
address@hidden @var{x} @code{<=} @var{y} @tab Vero se @var{x} @`e minore o
uguale a @var{y}
address@hidden @var{x} @code{>} @var{y} @tab Vero se @var{x} @`e maggiore di
@var{y}
address@hidden @var{x} @code{>=} @var{y} @tab Vero se @var{x} @`e maggiore o
uguale a @var{y}
address@hidden @var{x} @code{==} @var{y} @tab Vero se @var{x} @`e uguale a
@var{y}
address@hidden @var{x} @code{!=} @var{y} @tab Vero se @var{x} @`e diverso da
@var{y}
address@hidden @var{x} @code{~} @var{y} @tab Vero se la stringa @var{x}
corrisponde alla @dfn{regexp} rappresentata da @var{y}
address@hidden @var{x} @code{!~} @var{y} @tab Vero se la stringa @var{x} non
corrisponde alla @dfn{regexp} rappresentata da @var{y}
address@hidden @var{indice} @code{in} @var{vettore} @tab Vero se il vettore
@var{vettore} ha un elemento con indice @var{indice}
address@hidden multitable
address@hidden float
+
+Le espressioni di confronto valgono uno se sono vere e zero se false.
+Quando si confrontano operandi di tipi diversi, gli operandi numerici sono
+convertiti in stringhe usando il valore di @code{CONVFMT}
+(@pxref{Conversione}).
+
+Il confronto tra stringhe avviene
+confrontando il primo carattere di ciascuna stringa, poi il secondo carattere,
+e address@hidden@dotless{i}} via. Quindi, @code{"10"} @`e minore di
@code{"9"}. Se vi sono due
+stringhe di cui una @`e il prefisso dell'altra, la stringa address@hidden
corta @`e minore di
+quella address@hidden lunga. address@hidden@dotless{i}}, @code{"abc"} @`e
minore di @code{"abcd"}.
+
address@hidden risoluzione di problemi, operatore @code{==}
address@hidden problemi, risoluzione di, operatore @code{==}
address@hidden molto facile sbagliarsi scrivendo l'operatore @samp{==} e
+omettendo uno dei due caratteri @samp{=}. Il risultato @`e sempre un codice
address@hidden valido, ma il programma non fa quel che si voleva:
+
address@hidden
+if (a = b) # oops! dovrebbe essere == b
+ @dots{}
+else
+ @dots{}
address@hidden example
+
address@hidden
+A meno che @code{b} non sia zero o la stringa nulla, la parte @code{if}
+del test ha sempre successo. Poich@'e gli operatori sono molto simili,
+questo tipo di errore @`e molto difficile da individuare
+rileggendo il codice sorgente.
+
+Il seguente elenco di espressioni illustra il tipo di confronti
+che @command{awk} effettua e il risultato di ciascun confronto:
+
address@hidden @code
address@hidden 1.5 <= 2.0
+Confronto numerico (vero)
+
address@hidden "abc" >= "xyz"
+Confronto tra stringhe (falso)
+
address@hidden 1.5 != " +2"
+Confronto tra stringhe (vero)
+
address@hidden "1e2" < "3"
+Confronto tra stringhe (vero)
+
address@hidden a = 2; b = "2"
address@hidden a == b
+Confronto tra stringhe (vero)
+
address@hidden a = 2; b = " +2"
address@hidden a == b
+Confronto tra stringhe (falso)
address@hidden table
+
+In quest'esempio:
+
address@hidden
+$ @kbd{echo 1e2 3 | awk '@{ print ($1 < $2) ? "vero" : "falso" @}'}
address@hidden falso
address@hidden example
+
address@hidden espressioni di confronto, stringa vs.@: @dfn{regexp}
address@hidden @cindex string comparison vs.@: regexp comparison
address@hidden @cindex regexp comparison vs.@: string comparison
address@hidden
+il risultato @`e @samp{falso} perch@'e sia @code{$1} che @code{$2}
+sono immessi dall'utente. Sono stringhe numeriche---quindi hanno entrambe
+l'attributo @dfn{strnum}, che richiede un confronto di tipo numerico.
+Lo scopo delle regole di confronto e dell'uso di stringhe numeriche @`e quello
+di cercare di produrre il comportamento "meno inaspettato possibile",
+pur "facendo la cosa giusta".
+
+I confronti di stringhe e i confronti di espressioni regolari sono molto
+diversi. Per esempio:
+
address@hidden
+x == "att"
address@hidden example
+
address@hidden
+ha il valore uno, ossia @`e vero, se la variabile @code{x}
address@hidden precisamente @samp{att}. Al contrario:
+
address@hidden
+x ~ /att/
address@hidden example
+
address@hidden
+ha il valore uno se @code{x} contiene @samp{att}, come
address@hidden"Oh, che matto che sono!"}.
+
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
+L'operando di destra degli operatori @samp{~} e @samp{!~} address@hidden
essere sia una
+costante @dfn{regexp} (@code{/address@hidden@code{/}) che un'espressione
ordinaria.
+In quest'ultimo caso, il valore dell'espressione come stringa @`e usato come
una
address@hidden dinamica (@pxref{Uso di @dfn{regexp}}; e
address@hidden regolari calcolate}).
+
address@hidden @command{awk}, costanti @dfn{regexp} e
address@hidden costanti @dfn{regexp}
address@hidden @dfn{regexp}, costanti
+Un'espressione regolare costante tra due barre @`e di per s@'e anche
+un'espressione. @code{/@var{regexp}/} @`e un'abbreviazione per la seguente
+espressione di confronto:
+
address@hidden
+$0 ~ /@var{regexp}/
address@hidden example
+
+Una particolare posizione dove @code{/pippo/} @emph{non} @`e un'abbreviazione
di
address@hidden ~ /pippo/} @`e quella in cui @`e l'operando di destra di
@samp{~} o
address@hidden
address@hidden le costanti @dfn{regexp}},
+dove questo punto @`e trattato in maggiore dettaglio.
+
address@hidden Confronto POSIX di stringhe
address@hidden Confronto tra stringhe usando l'ordine di collazione locale
+
+Lo standard POSIX diceva che il confronto di stringhe viene effettuato secondo
+l'@dfn{ordine di collazione} locale. Questo @`e l'ordine secondo il quale sono
+disposti i caratteri, come definito dalla localizzazione (per una trattazione
address@hidden dettagliata, @pxref{Localizzazioni}). Quest'ordine normalmente
@`e molto
+diverso dal risultato ottenuto quando si esegue un confronto rigorosamente
+"carattere per carattere"address@hidden, il confronto di stringhe
+dovrebbe funzionare come se le stringhe fossero confrontate usando la
+funzione @code{strcoll()} di C.}
+
+Poich@'e questo comportamento differisce sensibilmente dalla pratica corrente,
address@hidden lo implementava solo quando eseguito in address@hidden POSIX
+(@pxref{Opzioni}).
+Quest'esempio ilustra la differenza, in una localizzazione
address@hidden:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf("ABC < abc = %s\n",}
+> @kbd{("ABC" < "abc" ? "TRUE" : "FALSE")) @}'}
address@hidden ABC < abc = TRUE
+$ @kbd{gawk --posix 'BEGIN @{ printf("ABC < abc = %s\n",}
+> @kbd{("ABC" < "abc" ? "TRUE" : "FALSE")) @}'}
address@hidden ABC < abc = FALSE
address@hidden example
+Fortunatamente, dal mese di agosto 2016, un confronto basato sull'ordine
+di collazione locale non @`e address@hidden richiesto per gli operatori
@code{==} e
address@hidden@footnote{Si consulti il sito web
address@hidden://austingroupbugs.net/view.php?id=1070,
+dell'Austin Group}.} Tuttavia, un confronto basato sull'ordine di
+collazione locale @`e ancora richiesto per gli operatori @code{<},
address@hidden<=}, @code{>} e @code{>=}. POSIX, quindi, raccomanda quanto
+segue:
+
address@hidden
+Poich@'e l'operatore @code{==} controlla che se le stringhe sono identiche,
+e non se sono nell'ordine di collazione locale, le applicazioni che
+devono controllare se le stringhe sono nell'ordine di collazione locale
+possono usare:
+
address@hidden
+a <= b && a >= b
address@hidden example
address@hidden quotation
+
+A partire dalla @value{PVERSION} 4.2, @command{gawk} continua a usare
+l'ordine di collazione locale per @code{<}, @code{<=}, @code{>}
+e @code{>=} solo se eseguito nella address@hidden POSIX.
+
address@hidden Operatori booleani
address@hidden Espressioni booleane
address@hidden @dfn{and}, operatore logico-booleano
address@hidden @dfn{or}, operatore logico-booleano
address@hidden @dfn{not}, operatore logico-booleano
address@hidden espressioni booleane
address@hidden booleane, espressioni
address@hidden operatori booleani, si veda espressioni booleane
address@hidden booleani, operatori, si veda espressioni booleane
address@hidden logici, operatori, si veda espressioni booleane
address@hidden operatori logici, si veda espressioni booleane
+
+Un'@dfn{espressione booleana} @`e una combinazione di espressioni di confronto
o
+espressioni di ricerca, che usa gli operatori booleani "or"
+(@samp{||}), "and" (@samp{&&}), e "not" (@samp{!}), facendo uso di
+parentesi per controllare le nidificazioni. Il valore di address@hidden
+dell'espressione booleana @`e calcolato calcolando i valori di address@hidden
delle
+espressioni componenti. Le espressioni booleane sono conosciute anche come
address@hidden logiche}. I due termini sono equivalenti.
+
+Le espressioni booleane possono essere usate in tutti i casi in cui @`e
possibile
+usare espressioni di confronto e di ricerca di corrispondenze. Si possono
+usare nelle istruzioni @code{if}, @code{while}, @code{do} e @code{for}
+(@pxref{Istruzioni}).
+Hanno valori numerici (uno se vero, zero se falso) che entrano in gioco
+se il risultato di un'espressione booleana @`e memorizzato in una variabile o
+se @`e usato nei calcoli.
+
+Inoltre, ogni espressione booleana @`e anche un modello di ricerca valido,
address@hidden@dotless{i}}
+se ne address@hidden usare uno come modello di ricerca per controllare
l'esecuzione di
+regole. Gli operatori booleani sono:
+
address@hidden @code
address@hidden @var{booleano1} && @var{booleano2}
+Vero se @var{booleano1} e @var{booleano2} sono entrambi veri. Per esempio,
+la seguente istruzione stampa il record in input corrente se contiene
+sia @samp{edu} che @samp{li}:
+
address@hidden
+if ($0 ~ /edu/ && $0 ~ /li/) print
address@hidden example
+
address@hidden effetti collaterali, operatori booleani
+La sottoespressione @var{booleano2} viene valutata solo se @var{booleano1}
address@hidden vero. Questo address@hidden comportare una differenza laddove
@var{booleano2} contenga
+espressioni che hanno effetti collaterali. Nel caso di @samp{$0 ~ /pippo/ &&
+($2 == pluto++)}, la variabile @code{pluto} non viene incrementata se non c'@`e
+nessuna sottostringa @samp{pippo} nel record.
+
address@hidden @var{booleano1} || @var{booleano2}
+Vero se almeno uno tra @var{booleano1} e @var{booleano2} @`e vero.
+Per esempio, la seguente istruzione stampa tutti i record dell'input che
+contengono @samp{edu} @emph{oppure}
address@hidden:
+
address@hidden
+if ($0 ~ /edu/ || $0 ~ /li/) print
address@hidden example
+
+La sottoespressione @var{booleano2} viene valutata solo se @var{booleano1}
address@hidden falso. Questo address@hidden comportare una differenza quando
@var{booleano2} contiene
+espressioni che hanno effetti collaterali.
+(address@hidden, questo confronto non individua mai i record che contengono sia
address@hidden che @samp{li}: non appena @samp{edu} viene trovato,
+l'intero confronto @`e concluso positivamente.)
+
address@hidden ! @var{booleano}
+Vero se @var{booleano} @`e falso. Per esempio,
+il seguente programma stampa @samp{nessuna home!} nel
+caso insolito che la variabile d'ambiente @env{HOME}
+non sia stata definita:
+
address@hidden
+BEGIN @{ if (! ("HOME" in ENVIRON))
+ print "nessuna home!" @}
address@hidden example
+
+(L'operatore @code{in} @`e descritto in
address@hidden elementi}.)
address@hidden table
+
address@hidden cortocircuito, operatori
address@hidden operatori di cortocircuito
address@hidden @code{&} (e commerciale), operatore @code{&&}
address@hidden e commerciale (@code{&}), operatore @code{&&}
address@hidden @code{|} (barra verticale), operatore @code{||}
address@hidden barra verticale (@code{|}), operatore @code{||}
+Gli operatori @samp{&&} e @samp{||} sono chiamati operatori di
address@hidden per il modo in cui funzionano. La valutazione dell'intera
+espressione @`e "cortocircuitata" se il risultato address@hidden
address@hidden essere determinato
+prima di aver completato interamente la valutazione.
+
address@hidden continuazione di riga
+Le istruzioni che finiscono con @samp{&&} o @samp{||} si possono continuare
+semplicemente mettendo un ritorno a capo dopo di esse. address@hidden non si
address@hidden mettere
+un ritorno a capo @emph{prima} di questi operatori senza usare la
+continuazione tramite la barra inversa (@pxref{Istruzioni/Righe}).
+
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden ritorno a capo
address@hidden variabili di tipo indicatore address@hidden
address@hidden @dfn{flag} [indicatore], variabili
+Il valore reale di un'espressione che usa l'operatore @samp{!} @`e uno
+o zero, a seconda del valore di address@hidden dell'espressione a cui
address@hidden applicato.
+L'operatore @samp{!} spesso @`e utile per cambiare il senso di una variabile
+indicatore address@hidden da falso a vero e viceversa. Per esempio, il seguente
+programma @`e un modo per stampare righe poste tra due speciali righe
+delimitatrici:
+
address@hidden
+$1 == "START" @{ pertinente = ! pertinente; next @}
+pertinente @{ print @}
+$1 == "END" @{ pertinente = ! pertinente; next @}
address@hidden example
+
address@hidden
+La variabile @code{pertinente}, address@hidden@dotless{i}} come tutte le
variabili di @command{awk},
address@hidden inizializzata a zero, che vale anche "falso". Quando viene
trovata
+una riga il cui primo campo @`e @samp{START}, il valore di @code{pertinente}
+viene commutato a vero, usando @samp{!}. La regola nella riga seguente stampa
righe finch@'e
address@hidden resta vero. Quando viene trovata una riga il cui primo
+campo @`e @samp{END}, @code{pertinente} viene nuovamente commutata a
address@hidden programma ha un bug; stampa righe che iniziano con
address@hidden Come si address@hidden risolvere?}
+
address@hidden
+Scott Deifik points out that this program isn't robust against
+bogus input data, but the point is to illustrate the use of `!',
+so we'll leave well enough alone.
address@hidden ignore
+
address@hidden comunemente, l'operatore @samp{!} viene usato nelle condizioni
delle
+istruzioni @code{if} e @code{while}, dove ha address@hidden senso formulare
espressioni
+logiche in negativo:
+
address@hidden
+if (! @var{qualche condizione} || @var{qualche altra condizione}) @{
+ @address@hidden fai un'operazione a piacere @dots{}}
address@hidden
address@hidden example
+
address@hidden @code{next}, istruzione
address@hidden NOTA
+L'istruzione @code{next} viene trattata in
address@hidden next}.
address@hidden dice ad @command{awk} di tralasciare il resto delle regole,
+leggere il record successivo, e iniziare a elaborare le regole partendo
+nuovamente dalla prima.
+Il motivo @`e quello di evitare di stampare le righe delimitatrici
address@hidden e @samp{END}.
address@hidden quotation
+
address@hidden Espressioni condizionali
address@hidden Espressioni condizionali
address@hidden condizionali, espressioni
address@hidden espressioni condizionali
address@hidden espressioni, selezionare
+
+Un'@dfn{espressione condizionale} @`e un tipo particolare di espressione che ha
+tre operandi. Consente di usare il primo valore dell'espressione per
+scegliere una o l'altra delle due ulteriori espressioni.
+L'espressione condizionale in @command{awk} @`e la stessa di quella del
+linguaggio C, ovvero:
+
address@hidden
address@hidden ? @var{espr-se-vero} : @var{espr-se-falso}
address@hidden example
+
address@hidden
+Ci sono tre sottoespressioni. La prima, @var{selettore}, viene sempre
+calcolata per prima. Se @`e "vera" (non zero o non nulla), viene poi calcolata
address@hidden e il suo valore diventa il valore dell'intera espressione.
+Altrimenti, la seconda espressione che viene calcolata @`e @var{espr-se-falso}
+e il suo valore diventa il valore dell'intera espressione.
+Per esempio, la seguente espressione produce il valore assoluto di @code{x}:
+
address@hidden
+x >= 0 ? x : -x
address@hidden example
+
address@hidden effetti collaterali, espressioni condizionali
+Ogni volta che viene calcolata un'espressione condizionale, solo una delle
+espressioni @var{espr-se-vero} e @var{espr-se-falso} viene usata; l'altra
address@hidden ignorata. Questo @`e importante quando le espressioni hanno
effetti
+collaterali. Per esempio, quest'espressione condizionale esamina l'elemento
address@hidden del vettore @code{a} o del vettore @code{b}, e incrementa
@code{i}:
+
address@hidden
+x == y ? a[i++] : b[i++]
address@hidden example
+
address@hidden
+Questa istruzione garantisce che @code{i} sia incrementato una volta sola
+per ogni esecuzione dell'istruzione stessa, perch@'e ogni volta viene eseguita
+solo una delle due espressioni di incremento, mentre l'altra viene
+ignorata.
address@hidden
address@hidden,
address@hidden iftex
address@hidden
address@hidden,
address@hidden ifnottex
+per maggiori informazioni sui vettori.
+
address@hidden differenze tra @command{awk} e @command{gawk}, continuazione di
riga
address@hidden continuazione di riga, @command{gawk}
address@hidden @command{gawk}, continuazione di riga in
+Come estensione minore di @command{gawk},
+un'istruzione che usa @samp{?:} si address@hidden continuare mettendo
+semplicemente un ritorno a capo dopo i due caratteri.
+Tuttavia, se si mette un ritorno a capo @emph{prima} dei due
+caratteri, la continuazione non funziona, se non si aggiunge anche la barra
inversa
+(@pxref{Istruzioni/Righe}).
+Se viene specificata l'opzione @option{--posix}
+(@pxref{Opzioni}), quest'estensione @`e disabilitata.
+
address@hidden Chiamate di funzione
address@hidden Chiamate di funzione
address@hidden chiamata di funzione
+
+Una @dfn{funzione} @`e un nome per richiedere un particolare calcolo.
+Il nome permette di richiamare
+la funzione da qualsiasi punto del programma.
+Per esempio, la funzione @code{sqrt()} calcola la radice quadrata di un numero.
+
address@hidden funzioni predefinite
+Un certo numero di funzioni sono @dfn{predefinite}, ossia sono
+disponibili in ogni programma @command{awk}. La funzione @code{sqrt()} @`e una
+di queste. @xref{Funzioni predefinite} per un elenco di funzioni
+predefinite e per le loro rispettive descrizioni. In aggiunta, l'utente
address@hidden
+definire delle funzioni da usare nel proprio programma.
address@hidden definite dall'utente}
+per istruzioni su come farlo.
+Infine, @command{gawk} permette di scrivere funzioni in C o in C++ che possono
+essere chiamate dal proprio programma (@pxref{Estensioni dinamiche}).
+
address@hidden argomenti, nelle chiamate di funzione
+Una funzione viene utilizzata invocandola tramite un'espressione di
address@hidden di funzione}, che consiste nel nome della funzione seguito
+immediatamente da una lista di @dfn{argomenti} tra parentesi. Gli argomenti
+sono espressioni che forniscono i materiali grezzi su cui opera la funzione.
+Quando ci sono address@hidden argomenti, questi sono separati da virgole. Se
+non ci sono argomenti, basta scrivere @samp{()} dopo il nome della funzione.
+Gli esempi che seguono mostrano chiamate di funzione con e senza argomenti:
+
address@hidden
+sqrt(x^2 + y^2) @ii{un argomento}
+atan2(y, x) @ii{due argomenti}
+rand() @ii{nessun argomento}
address@hidden example
+
address@hidden risoluzione di problemi, sintassi della chiamata di funzione
address@hidden problemi, risoluzione di, sintassi della chiamata di funzione
address@hidden ATTENZIONE
+Non ci dev'essere nessuno spazio tra il nome della funzione e la parentesi
+aperta! Un nome di funzione definita dall'utente address@hidden essere
scambiata per
+il nome di una
+variabile: uno spazio renderebbe l'espressione simile alla concatenazione di
+una variabile con un'espressione racchiusa tra parentesi.
+Per le funzioni predefinite, lo spazio prima delle parentesi non crea problemi,
+ma @`e meglio non prendere l'abitudine di usare spazi per evitare errori con le
+funzioni definite dall'utente.
address@hidden quotation
+
+Ogni funzione richiede uno specifico numero di argomenti.
+Per esempio, la funzione @code{sqrt()} dev'essere chiamata con
+un solo argomento, il numero del quale si vuole estrarre la radice quadrata:
+
address@hidden
+sqrt(@var{argomento})
address@hidden example
+
+Alcune delle funzioni predefinite hanno uno o address@hidden argomenti
opzionali.
+Se questi argomenti non vengono forniti, le funzioni
+usano un valore di default appropriato.
address@hidden predefinite} per tutti i dettagli. Se sono omessi argomenti
+in chiamate a funzioni definite dall'utente, tali argomenti sono considerati
+essere variabili locali. Il valore di tali variabili locali
address@hidden la stringa nulla se usate in un contesto che richiede una
stringa
+di caratteri, e lo zero se @`e richiesto
+un valore numerico
+(@pxref{Funzioni definite dall'utente}).
+
+Come address@hidden avanzata, @command{gawk} prevede la address@hidden di
+effettuare chiamate di funzione
+indirette, il che permette di scegliere la funzione da chiamare al momento
+dell'esecuzione, invece che nel momento in cui si scrive il codice sorgente
+del programma.
+Si rimanda la trattazione di questa address@hidden
+a un secondo momento; si veda @ref{Chiamate indirette}.
+
address@hidden effetti collaterali, chiamate di funzione
+Come ogni altra espressione, la chiamata di funzione ha un valore, chiamato
+spesso @dfn{valore di ritorno}, che @`e calcolato dalla funzione
+in base agli argomenti dati. In quest'esempio, il valore di ritorno
+di @samp{sqrt(@var{argomento})} @`e la radice quadrata di @var{argomento}.
+Il seguente programma legge numeri, un numero per riga, e stampa
+la radice quadrata di ciascuno:
+
address@hidden
+$ @kbd{awk '@{ print "La radice quadrata di", $1, "@`e", sqrt($1) @}'}
address@hidden
address@hidden La radice quadrata di 1 @`e 1
address@hidden
address@hidden La radice quadrata di 3 @`e 1.73205
address@hidden
address@hidden La radice quadrata di 5 @`e 2.23607
address@hidden
address@hidden example
+
+Una funzione address@hidden avere anche effetti collaterali, come assegnare
+valori a certe variabili o effettuare operazioni di I/O.
+Questo programma mostra come la funzione @code{match()}
+(@pxref{Funzioni per stringhe})
+cambia le variabili @code{RSTART} e @code{RLENGTH}:
+
address@hidden
address@hidden
+ if (match($1, $2))
+ print RSTART, RLENGTH
+ else
+ print "non uguali"
address@hidden
address@hidden example
+
address@hidden
+Qui vediamo un'esecuzione di esempio:
+
address@hidden
+$ @kbd{awk -f matchit.awk}
address@hidden c+}
address@hidden 3 2
address@hidden pluto}
address@hidden non uguali
address@hidden e}
address@hidden 5 1
address@hidden example
+
address@hidden Precedenza
address@hidden Precedenza degli operatori (Come si nidificano gli operatori)
address@hidden precedenza
address@hidden operatori, precedenza
+
+La @dfn{precedenza degli operatori} determina come gli operatori vengono
+raggruppati quando diversi operatori appaiono uno vicino all'altro in
+un'espressione.
+Per esempio, @samp{*} ha una precedenza address@hidden alta di @samp{+};
address@hidden@dotless{i}},
address@hidden + b * c} moltiplica @code{b} e @code{c}, e poi aggiunge @code{a}
al
+prodotto (ovvero esegue @samp{a + (b * c)}).
+
+La normale precedenza degli operatori address@hidden essere cambiata usando
delle
+parentesi. Si possono vedere le regole di precedenza come un modo per
+indicare dove si sarebbero dovute mettere delle parentesi. Di fatto,
address@hidden cosa saggia usare sempre le parentesi
+in presenza di una combinazione di operatori insolita, perch@'e altre persone
+che leggono il programma potrebbero non ricordare quale sia la precedenza
+in quel particolare caso.
+Anche dei programmatori esperti a volte dimenticano le regole esatte,
+il che porta a commettere errori.
+Usare esplicitamente le parentesi previene qualunque errore
+di questo tipo.
+
+Quando vengono usati insieme operatori con uguale precedenza, quello
address@hidden a
+sinistra viene raggruppato per primo, ad eccezione degli operatori di
+assegnamento, condizionali e di elevamento a potenza, che vengono raggruppati
+nell'ordine opposto.
+Quindi, @samp{a - b + c} raggruppa come @samp{(a - b) + c} e
address@hidden = b = c} raggruppa come @samp{a = (b = c)}.
+
+Normalmente la precedenza degli operatori unari di prefisso non ha importanza,
+perch@'e c'@`e un solo modo di interpretarli: prima il address@hidden interno.
Quindi,
address@hidden significa @samp{$(++i)} e
address@hidden significa @samp{++($x)}. Tuttavia, quando un altro operatore
segue
+l'operando, la precedenza degli operatori unari address@hidden avere
importanza.
address@hidden significa @samp{($x)^2}, ma @samp{-x^2} significa
address@hidden(x^2)}, perch@'e @samp{-} ha precedenza address@hidden bassa
rispetto a @samp{^},
+mentre @samp{$} ha precedenza address@hidden alta.
+Inoltre, gli operatori non possono essere combinati in modo tale da violare le
+regole di precedenza; per esempio, @samp{$$0++--} non @`e un'espressione valida
+perch@'e il primo @samp{$} ha precedenza address@hidden alta di
address@hidden; per evitare il problema l'espressione address@hidden essere
scritta come
address@hidden($0++)--}.
+
+Questa lista illustra gli operatori di @command{awk}, in ordine di precedenza
+dalla address@hidden alta alla address@hidden bassa:
+
address@hidden @asis for docbook to come out right
address@hidden @asis
address@hidden @code{(address@hidden@code{)}
+Raggruppamento.
+
address@hidden @code{$} (dollaro), operatore di campo @code{$}
address@hidden dollaro (@code{$}), operatore di campo @code{$}
address@hidden @code{$}
+Riferimento a un campo.
+
address@hidden @code{+} (address@hidden), operatore @code{++}
address@hidden address@hidden (@code{+}), operatore @code{++}
address@hidden @code{-} (meno), operatore @code{--}
address@hidden meno (@code{-}), operatore @code{--}
address@hidden @code{++ --}
+Incremento, decremento.
+
address@hidden @code{^} (circonflesso), operatore @code{^}
address@hidden circonflesso (@code{^}), operatore @code{^}
address@hidden @code{*} (asterisco), operatore @code{**}
address@hidden asterisco (@code{*}), operatore @code{**}
address@hidden @code{^ **}
+Elevamento a potenza. Questi operatori sono raggruppati da destra verso
+sinistra.
+
address@hidden @code{+} (address@hidden), operatore @code{+}
address@hidden address@hidden (@code{+}), operatore @code{+}
address@hidden @code{-} (meno), operatore @code{-}
address@hidden meno (@code{-}), operatore @code{-}
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden @code{+ - !}
address@hidden, meno, ``not'' logico, unari.
+
address@hidden @code{*} (asterisco), operatore @code{*}, come operatore di
moltiplicazione
address@hidden asterisco (@code{*}), operatore @code{*}, come operatore di
moltiplicazione
address@hidden @code{/} (barra), operatore @code{/}
address@hidden barra (@code{/}), operatore @code{/}
address@hidden @code{%} (percento), operatore @code{%}
address@hidden percento (@code{%}), operatore @code{%}
address@hidden @code{* / %}
+Moltiplicazione, divisione, resto di una divisione.
+
address@hidden @code{+} (address@hidden), operatore @code{+}
address@hidden address@hidden (@code{+}), operatore @code{+}
address@hidden @code{-} (meno), operatore @code{-}
address@hidden meno (@code{-}), operatore @code{-}
address@hidden @code{+ -}
+Addizione, sottrazione.
+
address@hidden Concatenazione di stringhe
+Non c'@`e un simbolo speciale per la concatenazione.
+Gli operandi sono semplicemente scritti uno accanto all'altro.
+(@pxref{Concatenazione}).
+
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<}
address@hidden @code{<} (parentesi acuta sinistra), operatore @code{<=}
address@hidden parentesi acuta sinistra (@code{<}), operatore @code{<=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>=}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>}
address@hidden parentesi acuta destra (@code{>}), operatore @code{>}
address@hidden @code{=} (uguale), operatore @code{==}
address@hidden uguale (@code{=}), operatore @code{==}
address@hidden @code{!} (punto esclamativo), operatore @code{!=}
address@hidden punto esclamativo (@code{!}), operatore @code{!=}
address@hidden @code{>} (parentesi acuta destra), operatore @code{>>} (I/O)
address@hidden parentesi acuta destra (@code{>}), operatore @code{>>} (I/O)
address@hidden operatori, input/output
address@hidden @code{|} (barra verticale), operatore @code{|} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|} (I/O)
address@hidden operatori, input/output
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|&} (I/O)
address@hidden operatori, input/output
address@hidden @code{< <= == != > >= >> | |&}
+Operatori relazionali e ridirezione.
+Gli operatori relazionali e le ridirezioni hanno lo stesso livello di
+precedenza. I caratteri come @samp{>} servono sia come operatori relazionali
+che come ridirezioni; la distinzione tra i due significati dipende dal
+contesto.
+
address@hidden istruzione @code{print}, operatori I/O nell'
address@hidden istruzione @code{printf}, operatori I/O nell'
+Si noti che gli operatori di ridirezione I/O nelle istruzioni @code{print} e
address@hidden appartengono al livello dell'istruzione, non alle espressioni.
+La ridirezione non produce un'espressione che potrebbe essere l'operando di un
+altro operatore. Di conseguenza, non ha senso usare un operatore di
+ridirezione vicino a un altro operatore con precedenza address@hidden bassa
senza
+parentesi. Tali combinazioni generano errori di sintassi
+(p.es., @samp{print pippo > a ? b : c}).
+Il modo corretto di scrivere quest'istruzione @`e @samp{print pippo > (a ? b :
c)}.
+
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden @code{~ !~}
+Corrispondenza, non corrispondenza.
+
address@hidden @code{in}, operatore
address@hidden @code{in}
+Appartenenza a un vettore.
+
address@hidden @code{&} (e commerciale), operatore @code{&&}
address@hidden e commerciale (@code{&}), operatore @code{&&}
address@hidden @code{&&}
+``and'' logico.
+
address@hidden @code{|} (barra verticale), operatore @code{||}
address@hidden barra verticale (@code{|}), operatore @code{||}
address@hidden @code{||}
+``or'' logico.
+
address@hidden @code{?} (punto interrogativo), operatore @code{?:}
address@hidden punto interrogativo (@code{?}), operatore @code{?:}
address@hidden @code{?:}
+Operatore condizionale. Questo operatore raggruppa da destra verso sinistra.
+
address@hidden @code{+} (address@hidden), operatore @code{+=}
address@hidden address@hidden (@code{+}), operatore @code{+=}
address@hidden @code{-} (meno), operatore @code{-=}
address@hidden meno (@code{-}), operatore @code{-=}
address@hidden @code{*} (asterisco), operatore @code{*=}
address@hidden asterisco (@code{*}), operatore @code{*=}
address@hidden @code{*} (asterisco), operatore @code{**=}
address@hidden asterisco (@code{*}), operatore @code{**=}
address@hidden @code{/} (barra), operatore @code{/=}
address@hidden barra (@code{/}), operatore @code{/=}
address@hidden @code{%} (percento), operatore @code{%=}
address@hidden percento (@code{%}), operatore @code{%=}
address@hidden @code{^} (circonflesso), operatore @code{^=}
address@hidden circonflesso (@code{^}), operatore @code{^=}
address@hidden @code{= += -= *= /= %= ^= **=}
+Assegnamento. Questi operatori raggruppano da destra verso sinistra.
address@hidden table
+
address@hidden POSIX @command{awk}, @code{**} e
address@hidden address@hidden, operatori, non in POSIX @command{awk}
address@hidden NOTA
+Gli operatori @samp{|&}, @samp{**} e @samp{**=} non sono definiti da POSIX.
+Per la massima address@hidden, @`e meglio non usarli.
address@hidden quotation
+
address@hidden Localizzazioni
address@hidden Il luogo fa la differenza
address@hidden localizzazione, definizione di
+
+I moderni sistemi prevedono la nozione di @dfn{localizzazione}: un modo per
+informare il sistema sulla serie di caratteri e sulla lingua locali.
+Lo standard ISO C definisce una localizzazione di default @code{"C"}, che @`e
+l'ambiente tipico a cui molti programmatori in C sono abituati.
+
+Un tempo, le impostazioni della localizzazione avevano influenza sulla
+ricerca di corrispondenze tramite @dfn{regexp}, ma ora non @`e address@hidden
address@hidden@dotless{i}}
+(@pxref{Intervalli e localizzazione}).
+
+La localizzazione address@hidden influire sulla separazione dei record. Per
il caso
+normale di @samp{RS = "\n"}, la localizzazione @`e generalmente irrilevante.
+Per altri separatori di record di un solo carattere, impostare
+la variabile d'ambiente @samp{LC_ALL=C}
+garantisce una migliore efficienza nella lettura dei record. Altrimenti,
address@hidden dovrebbe fare diverse chiamate di funzione, @emph{per ogni
+carattere in input}, per determinare la fine del record.
+
+La localizzazione address@hidden influire sulla formattazione delle date e
delle ore
+(@pxref{Funzioni di tempo}). Per esempio, un modo comune per abbreviare la
+data 4 settembre 2015, negli Stati Uniti @`e ``9/4/15.'' In molti paesi
+dell'Europa, invece, l'abbreviazione @`e "4.9.15". Quindi, la specifica di
+formato
address@hidden in una localizzazione @code{"US"} potrebbe produrre
@samp{9/4/15},
+mentre in una localizzazione @code{"EUROPA"}, potrebbe produrre @samp{4.9.15}.
+
+Secondo POSIX, anche il confronto tra stringhe @`e influenzato dalla
+localizzazione (come nelle espressioni regolari). I dettagli sono descritti in
address@hidden POSIX di stringhe}.
+
+Infine, la localizzazione influenza il valore del separatore decimale
+usato quando @command{gawk} analizza i dati in input. Questo @`e stato
+trattato nel dettaglio in @ref{Conversione}.
+
address@hidden Sommario delle espressioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Le espressioni sono gli elementi base dei calcoli eseguiti nei programmi.
+Sono costruite a partire da costanti, variabili, chiamate di funzione e dalla
+combinazione di vari tipi di valori tramite operatori.
+
address@hidden
address@hidden fornisce tre tipi di costanti: numerica, di stringa e
+di @dfn{regexp}. Le costanti numeriche in @command{gawk} si possono
+specificare nei sistemi ottale ed esadecimale (con base 8 e 16), e anche nel
+sistema decimale (base 10). In alcuni contesti, una costante @dfn{regexp}
+isolata come @code{/pippo/} ha lo stesso significato di @samp{$0 ~ /pippo/}.
+
address@hidden
+Le variabili contengono valori che possono essere usati diverse volte nei
+calcoli. Un certo numero di variabili predefinite forniscono informazioni al
+programma @command{awk}, mentre altre permettono il controllo del comportamento
+di @command{awk}.
+
address@hidden
+I numeri sono automaticamente convertiti in stringhe, e le stringhe in numeri,
+a seconda delle address@hidden di @command{awk}. I valori numerici sono
convertiti
+come se fossero formattati con @code{sprintf()} usando il formato contenuto in
address@hidden La localizzazione address@hidden influire sulle conversioni.
+
address@hidden
+In @command{awk} ci sono gli operatori aritmetici di uso comune (addizione,
+sottrazione, moltiplicazione, divisione, modulo), e il address@hidden e il
meno unari.
+Ci sono anche operatori di confronto, operatori booleani, una verifica
+dell'esistenza di una chiave in
+un vettore, e operatori per la ricerca di corrispondenze con espressioni
+regolari. La concatenazione di stringhe @`e effettuata mettendo due
espressioni
+una vicino all'altra; non c'@`e nessun operatore esplicito.
+L'operatore con tre operandi @samp{?:} fornisce una verifica ``if-else''
+all'interno delle espressioni.
+
address@hidden
+Gli operatori di assegnamento forniscono delle comode forme brevi per le comuni
+operazioni aritmetiche.
+
address@hidden
+In @command{awk}, un valore @`e considerato vero se @`e diverso da zero
address@hidden non nullo. Altrimenti, il valore @`e falso.
+
address@hidden
+Il tipo di una variabile viene impostata a ogni assegnamento e address@hidden
cambiare
+durante il suo ciclo di vita. Il tipo determina il comportamento della
+variabile nei confronti (di tipo stringa o numerici).
+
address@hidden
+Le chiamate di funzione restituiscono un valore che address@hidden essere
usato come parte
+di un'espressione address@hidden lunga. Le espressioni usate per passare
valori di
+parametro vengono valutate completamente prima di chiamare la funzione.
address@hidden fornisce funzioni predefinite e prevede quelle definite
+dall'utente; questo @`e descritto in
address@hidden
+
address@hidden
+La precedenza degli operatori specifica l'ordine secondo il quale vengono
+effettuate le operazioni, a meno che quest'ordine non sia esplicitamente
+alterato
+tramite parentesi. Le regole di precedenza degli operatori di @command{awk}
+sono compatibili con quelle del linguaggio C.
+
address@hidden
+La localizzazione address@hidden influire sul formato dei dati in uscita da un
programma
address@hidden, e occasionalmente sul formato dei dati letti in input.
+
address@hidden itemize
+
address@hidden Criteri di ricerca e azioni
address@hidden Criteri di ricerca, azioni e variabili
address@hidden criteri di ricerca
address@hidden @dfn{pattern}, si veda criteri di ricerca
address@hidden espressione di ricerca
+
+Come address@hidden visto, ogni istruzione @command{awk} consiste di un
criterio di
+ricerca address@hidden a cui @`e associata un'azione. Questo @value{CHAPTER}
+descrive come specificare criteri e azioni, cosa @`e possibile
+fare tramite le azioni e quali sono le variabili predefinite in
address@hidden
+
+Le regole @dfn{criterio di ricerca--azione} e le istruzioni che si possono
+dare all'interno delle azioni formano il nucleo centrale dei programmi
+scritti in @command{awk}.
+In un certo senso, tutto quanto si @`e visto finora costituisce le fondamenta
+sulle quali sono costruiti i programmi. @`E giunto il momento di iniziare a
+costruire qualcosa di utile.
+
address@hidden
+* Panoramica sui criteri di ricerca:: Come scrivere un criterio di ricerca.
+* Usare variabili di shell:: come usare variabili della shell in
+ @command{awk}.
+* Panoramica sulle azioni:: Come scrivere un'azione.
+* Istruzioni:: Descrizione dettagliata delle varie
+ istruzioni di controllo.
+* Variabili predefinite:: Sommario delle variabili predefinite.
+* Sommario criteri e azioni:: Sommario di criteri di ricerca e azioni.
address@hidden menu
+
address@hidden Panoramica sui criteri di ricerca
address@hidden Elementi di un criterio di ricerca
+
address@hidden
+* @dfn{regexp} come criteri di ricerca:: Usare espressioni regolari come
+ criteri di ricerca.
+* Espressioni come criteri di ricerca:: Qualsiasi espressione address@hidden
servire da
+ criterio di ricerca.
+* Intervalli:: Coppie di espressioni regolari per
+ delimitare una ricerca.
+* BEGIN/END:: Specificare regole di inizio e fine programma.
+* BEGINFILE/ENDFILE:: Due condizioni speciali per controlli avanzati.
+* Vuoto:: Il criterio di ricerca vuoto, che
+ corrisponde a ogni record.
address@hidden menu
+
address@hidden criteri di ricerca, tipi di
+I criteri di ricerca in @command{awk} controllano l'esecuzione di
+azioni: un'azione viene eseguita
+quando il criterio di ricerca associato ad essa @`e soddisfatto dal
+record in input corrente.
+La tabella seguente @`e un sommario dei tipi di criteri di ricerca in
address@hidden:
+
address@hidden @code
address@hidden /@var{espressione regolare}/
+Un'espressione regolare. @`E verificata quando il testo di un
+record in input corrisponde all'espressione regolare.
address@hidden
+(@xrefIl{Espressioni regolari}.)
address@hidden iftex
address@hidden
+(@xref{Espressioni regolari}.)
address@hidden ifnottex
+
address@hidden @var{espressione}
+Una singola espressione. @`E verificata quando il suo valore @`e
+diverso da zero (se di tipo numerico) o non nullo (se @`e una stringa).
+(@xref{Espressioni come criteri di ricerca}.)
+
address@hidden @var{inizio_interv}, @var{fine_interv}
+Una coppia di criteri di ricerca separati da una virgola, che specificano un
address@hidden di record.
+L'intervallo comprende sia il record iniziale che corrisponde a
@var{inizio_interv}
+sia il record finale che corrisponde a @var{fine_interv}.
+(@xref{Intervalli}.)
+
address@hidden BEGIN
address@hidden END
+Criteri di ricerca speciali che consentono azioni di inizializzazione o
+di pulizia in un programma @command{awk}.
+(@xref{BEGIN/END}.)
+
address@hidden BEGINFILE
address@hidden ENDFILE
+Criteri di ricerca speciali che consentono azioni di inizializzazione o di
+pulizia da eseguire all'inizio o alla fine di ogni file in input.
+(@xref{BEGINFILE/ENDFILE}.)
+
address@hidden @var{vuoto}
+Il criterio di ricerca vuoto corrisponde a ciascun record in input.
+(@xref{Vuoto}.)
address@hidden table
+
address@hidden @dfn{regexp} come criteri di ricerca
address@hidden Espressioni regolari come criteri di ricerca
address@hidden criteri di ricerca, espressioni come
address@hidden espressioni regolari, come criteri di ricerca
+
+Le espressioni regolari sono uno dei primi tipi di criteri di ricerca
+presentati in questo @value{DOCUMENT}.
+Questo tipo di criterio di ricerca @`e semplicemente una costante @dfn{regexp}
+posta nella parte @dfn{criterio di ricerca} di una regola. Equivale a
+scrivere @samp{$0 ~ /@var{criterio di ricerca}/}.
+Il criterio di ricerca @`e verificato quando il record in input corrisponde
+alla @dfn{regexp}.
+Per esempio:
+
address@hidden
+/pippo|pluto|paperino/ @{ personaggi_Disney++ @}
+END @{ print personaggi_Disney, "Personaggi Disney visti" @}
address@hidden example
+
address@hidden Espressioni come criteri di ricerca
address@hidden Espressioni come criteri di ricerca
address@hidden espressioni regolari, come criteri di ricerca
+
+Qualsiasi espressione @command{awk} address@hidden essere usata come un
criterio di
+ricerca @command{awk}.
+Il criterio di ricerca @`e verificato se il valore dell'espressione @`e diverso
+da zero (se @`e un numero), o non nullo (se @`e una stringa).
+L'espressione @`e ricalcolata ogni volta che la regola viene applicata a un
+nuovo record in input. Se l'espressione usa campi come @code{$1}, il suo
+valore dipende direttamente dal contenuto del record in input appena letto;
+altrimenti, dipende solo da quel che @`e accaduto fino a quel momento durante
+l'esecuzione del programma @command{awk}.
+
address@hidden espressioni di confronto, come criteri di ricerca
address@hidden criteri di ricerca, espressioni di confronto come
+Le espressioni di confronto, che usano gli operatori di confronto descritti in
address@hidden di variabile e confronti},
+sono un tipo di criterio di ricerca usato frequentemente.
+Anche le @dfn{regexp}, verificate o non verificate, sono tipi di espressioni
molto frequenti.
+L'operando a sinistra degli operatori @samp{~} e @samp{!~} @`e una stringa.
+L'operando di destra @`e un'espressione regolare costante delimitata da
+barre (@code{/@address@hidden/}) o qualsiasi espressione il cui valore come
+stringa @`e usato come un'espressione regolare dinamica
+(@pxref{Espressioni regolari calcolate}).
+L'esempio seguente stampa il secondo campo di ogni record in input
+il cui primo campo sia esattamente @samp{li}:
+
address@hidden @code{/} (barra), criteri di ricerca e
address@hidden barra (@code{/}), criteri di ricerca e
address@hidden @code{~} (tilde), operatore @code{~}
address@hidden tilde (@code{~}), operatore @code{~}
address@hidden @code{!} (punto esclamativo), operatore @code{!~}
address@hidden punto esclamativo (@code{!}), operatore @code{!~}
address@hidden
+$ @kbd{awk '$1 == "li" @{ print $2 @}' mail-list}
address@hidden example
+
address@hidden
+(Il programma non stampa alcun output, perch@'e nessuna persona ha come nome
esattamente @samp{li}.)
+Si veda la differenza con il seguente confronto di espressione regolare, che
+individua invece qualsiasi record il cui primo campo @emph{contenga} @samp{li}:
+
address@hidden
+$ @kbd{awk '$1 ~ /li/ @{ print $2 @}' mail-list}
address@hidden 555-5553
address@hidden 555-6699
address@hidden example
+
address@hidden @dfn{regexp}, costanti, come criteri di ricerca
address@hidden criteri di ricerca, costanti @dfn{regexp} come
+Una costante @dfn{regexp} usata come criterio di ricerca @`e anche un
+caso speciale di criterio di ricerca costituito da un'espressione.
+All'espressione @code{/li/} viene assegnato il valore uno se @samp{li}
+viene trovato nel record in input corrente. Quindi, come criterio di ricerca,
address@hidden/li/} individua tutti i record che contengono la stringa
@samp{li}.
+
address@hidden espressioni booleane, come criteri di ricerca
+Anche le espressioni booleane sono frequentemente usate come criteri di
+ricerca. Se un criterio di ricerca
+individua o no un record in input dipende dalla verifica delle
+sottoespressioni da cui @`e composto.
+Per esempio, il seguente comando stampa tutti i record in
address@hidden che contengono sia @samp{edu} che @samp{li}:
+
address@hidden
+$ @kbd{awk '/edu/ && /li/' mail-list}
address@hidden Samuel 555-3430 samuel.lanceolis@@shu.edu A
address@hidden example
+
+Il seguente comando stampa tutti i record in
address@hidden che contengono @samp{edu} @emph{oppure} @samp{li}
+(o entrambi, naturalmente):
+
address@hidden
+$ @kbd{awk '/edu/ || /li/' mail-list}
address@hidden Amelia 555-5553 amelia.zodiacusque@@gmail.com F
address@hidden Broderick 555-0542 broderick.aliquotiens@@yahoo.com R
address@hidden Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
address@hidden Julie 555-6699 julie.perscrutabor@@skeeve.com F
address@hidden Samuel 555-3430 samuel.lanceolis@@shu.edu A
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden example
+
+Il seguente comando stampa tutti i record in
address@hidden che @emph{non} contengono la stringa @samp{li}:
+
address@hidden
+$ @kbd{awk '! /li/' mail-list}
address@hidden Anthony 555-3412 anthony.asserturo@@hotmail.com A
address@hidden Becky 555-7685 becky.algebrarum@@gmail.com A
address@hidden Bill 555-1675 bill.drowning@@hotmail.com A
address@hidden Camilla 555-2912 camilla.infusarum@@skynet.be R
address@hidden Fabius 555-1234 fabius.undevicesimus@@ucb.edu F
address@hidden Martin 555-6480 martin.codicibus@@hotmail.com A
address@hidden Jean-Paul 555-2127 jeanpaul.campanorum@@nyu.edu R
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, criteri di ricerca booleani e
address@hidden @code{END}, criterio di ricerca, criteri di ricerca booleani e
address@hidden @code{BEGINFILE}, criterio di ricerca, criteri di ricerca
booleani e
address@hidden @code{ENDFILE}, criterio di ricerca, criteri di ricerca booleani
e
+Le sottoespressioni di un'operatore booleano in un criterio di ricerca possono
+essere espressioni regolari costanti, confronti, o qualsiasi altra espressione
+di @command{awk}. Gli intervalli di ricerca
+non sono espressioni, e quindi non possono apparire all'interno di
+criteri di ricerca booleani. Analogamente, i criteri di ricerca speciali
address@hidden, @code{END}, @code{BEGINFILE} ed @code{ENDFILE},
+che non corrispondono ad alcun record in input, non sono espressioni e non
+possono essere usati all'interno di criteri di ricerca booleani.
+
+L'ordine di precedenza dei differenti operatori che possono essere usati nei
+criteri di ricerca @`e descritto in @ref{Precedenza}.
+
address@hidden Intervalli
address@hidden Specificare intervalli di record con i criteri di ricerca
+
address@hidden intervalli di ricerca
address@hidden criteri di ricerca, intervalli nei
address@hidden righe, individuare intervalli di
address@hidden @code{,} (virgola), negli intervalli di ricerca
address@hidden virgola (@code{,}), negli intervalli di ricerca
+Un @dfn{intervallo di ricerca} @`e composto da due criteri di ricerca
+separati da una virgola, nella forma
address@hidden@var{inizio_intervallo}, @var{fine_intervallo}}. @`E usato per
+individuare
+una serie di record consecutivi nei file in input. Il primo criterio di
+ricerca, @var{inizio_intervallo}, controlla dove inizia la serie di record,
+mentre @var{fine_intervallo} controlla dove finisce la serie stessa.
+L'esempio seguente:
+
address@hidden
+awk '$1 == "on", $1 == "off"' miofile
address@hidden example
+
address@hidden
+stampa ogni record in @file{miofile} incluso tra i due record che iniziano con
address@hidden/@samp{off}, estremi compresi.
+
+Un intervallo di ricerca inizia con la valutazione di
address@hidden per ogni record in input. Quando un record soddisfa
+la condizione @var{inizio_intervallo}, l'intervallo di ricerca @`e
address@hidden e l'intervallo di ricerca include anche quel
+record. Finch@'e l'intervallo di ricerca rimane attivo,
+automaticamente vengono trovate corrispondenze in ogni record in input letto.
+L'intervallo di ricerca verifica anche @var{fine_intervallo} per ogni
+record in input; quando la verifica ha successo, il
+criterio di ricerca viene @dfn{disattivato} a partire dal record seguente.
+Quindi il criterio di ricerca torna a controllare
address@hidden per ogni nuovo record.
+
address@hidden @code{if}, istruzione, address@hidden modificabili
+Il record che segnala l'inizio dell'intervallo
+di ricerca e quello che segnala la fine di quell'intervallo soddisfano
address@hidden il criterio di ricerca. Se non si vuole agire su tali record
+si possono scrivere istruzioni @code{if} nella parte @dfn{azione} della regola
+per distinguerli dai record che il programma @`e interessato a trattare.
+
address@hidden possibile che un criterio di ricerca sia attivato e disattivato
dallo
+stesso record. Se il record soddisfa entrambe le condizioni, l'azione @`e
+eseguita solo su quel record.
+Per esempio, si supponga che ci sia un testo tra due separatori identici
+(p.es., il simbolo @samp{%}), ognuno dei quali sia su una riga a parte, che
+dovrebbero essere ignorati. Un primo tentativo potrebbe essere quello di
+combinare un intervallo di ricerca che descrive il
+testo delimitato con l'istruzione
address@hidden
+(non ancora introdotta, @pxref{Istruzione next}).
+Con quest'istruzione @command{awk} non effettua alcuna azione sul record
+corrente e inizia di nuovo a elaborare il successivo record in input.
+Un tale programma @`e simile a questo:
+
address@hidden
+/^%$/,/^%$/ @{ next @}
+ @{ print @}
address@hidden example
+
address@hidden
address@hidden righe, saltare tra delimitatori
address@hidden @cindex @dfn{flag} variables
+Questo programma non funziona, perch@'e l'intervallo di ricerca @`e sia
attivato
+che disattivato dalla prima riga incontrata, quella costituita da un @samp{%}.
+Per ottenere l'effetto desiderato, si scriva il programma nella maniera che
+segue, utilizzando un @dfn{flag}:
+
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden
+/^%$/ @{ ignora = ! ignora; next @}
+ignora == 1 @{ next @} # ignora righe quando `ignora' @`e impostato a 1
address@hidden example
+
+In un intervallo di ricerca, la virgola (@samp{,}) ha la
+precedenza address@hidden bassa tra tutti gli operatori (address@hidden, @`e
l'ultima a essere
+valutata). Il programma seguente tenta di combinare un intervallo di
+ricerca con un altro controllo, address@hidden semplice:
+
address@hidden
+echo Yes | awk '/1/,/2/ || /Yes/'
address@hidden example
+
+L'intenzione in questo programma @`e quello di esprimere le condizioni
address@hidden(/1/,/2/) || /Yes/}.
+Tuttavia, @command{awk} lo interpreta come se fosse
address@hidden/1/, (/2/ || /Yes/)}.
+Questo comportamento non address@hidden essere cambiato o evitato; gli
intervalli di
+ricerca non si possono combinare con altri criteri di ricerca:
+
address@hidden
+$ @kbd{echo Yes | gawk '(/1/,/2/) || /Yes/'}
address@hidden gawk: riga com.:1: (/1/,/2/) || /Yes/
address@hidden gawk: riga com.:1: ^ syntax error
address@hidden example
+
address@hidden intervalli di ricerca, continuazione di riga e
+Come punto di secondaria importanza, nonostante sia stilisticamente poco
elegante,
+lo standard POSIX consente di andare a capo dopo la virgola
+in un intervallo di ricerca. @value{DARKCORNER}
address@hidden BEGIN/END
address@hidden I criteri di ricerca speciali @code{BEGIN} ed @code{END}
+
address@hidden @code{BEGIN}, criterio di ricerca
address@hidden @code{END}, criterio di ricerca
address@hidden criterio di ricerca @code{END}
+Tutti i criteri di ricerca fin qui descritti servono a individuare dei record
+in input.
+I criteri di ricerca speciali @code{BEGIN} ed @code{END} non hanno questo
scopo.
+Servono invece per effettuare azioni di inizializzazione o di pulizia nei
+programmi @command{awk}.
+Le regole @code{BEGIN} ed @code{END} devono prevedere azioni; non c'@`e
+un'azione di default per queste regole, perch@'e non c'@`e un record corrente
+quando sono invocate.
+Le regole @code{BEGIN} ed @code{END} sono spesso chiamate
+``blocchi @code{BEGIN} ed @code{END}'' da programmatori che usano @command{awk}
+da molto tempo.
+
address@hidden
+* Usare BEGIN/END:: Come e perch@'e usare regole BEGIN/END.
+* I/O e BEGIN/END:: Problemi di I/O nelle regole BEGIN/END.
address@hidden menu
+
address@hidden Usare BEGIN/END
address@hidden Azioni di inizializzazione e pulizia
+
address@hidden @code{BEGIN}, criterio di ricerca
address@hidden criterio di ricerca @code{BEGIN}
address@hidden @code{END}, criterio di ricerca
address@hidden criterio di ricerca @code{END}
+Una regola @code{BEGIN} @`e eseguita solo una volta, prima che sia letto il
+primo record in input. Analogamente, una regola @code{END} @`e eseguita
+solo una volta, dopo che tutto l'input @`e address@hidden stato letto. Per
esempio:
+
address@hidden
+$ @kbd{awk '}
+> @kbd{BEGIN @{ print "Analisi di \"li\"" @}}
+> @kbd{/li/ @{ ++n @}}
+> @kbd{END @{ print "\"li\" @`e presente in", n, "record." @}' mail-list}
address@hidden Analisi di "li"
address@hidden "li" @`e presente in 4 record.
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, operatori e
address@hidden @code{END}, criterio di ricerca, operatori e
address@hidden criterio di ricerca @code{END}, operatori e
+Questo programma trova il numero di record nel file in input
address@hidden che contengono la stringa @samp{li}. La regola @code{BEGIN}
+stampa un titolo per il rapporto. Non c'@`e bisogno di usare la regola
address@hidden per inizializzare il contatore @code{n} a zero, poich@'e
address@hidden lo fa
+automaticamente (@pxref{Variabili}).
+La seconda regola incrementa la variabile @code{n} ogni volta che si legge
+un record che soddisfa il criterio di ricerca @samp{li}. La regola @code{END}
+stampa il valore di @code{n} alla fine del programma.
+
+I criteri di ricerca speciali @code{BEGIN} ed @code{END} non possono essere
+usati negli intervalli,
+o con operatori booleani (in effetti, non possono essere combinati con nessun
+altro operatore).
+Un programma @command{awk} address@hidden avere molte regole @code{BEGIN} e/o
@code{END}.
+Queste sono eseguite nell'ordine in cui compaiono nel programma: tutte le
+regole @code{BEGIN} a inizio programma e tutte le regole @code{END}
+a fine programma.
+Le regole @code{BEGIN} ed @code{END} possono apparire in qualsiasi
+posizione all'interno del programma.
+Questa address@hidden @`e stata aggiunta nella versione 1987 di @command{awk}
ed
address@hidden inclusa nello standard POSIX.
+La versione originale (1978) di @command{awk} richiedeva che la regola
address@hidden fosse posta all'inizio del programma, e la regola
address@hidden alla fine del programma, e solo una regola per tipo era ammessa.
address@hidden non @`e address@hidden obbligatorio, ma @`e una buona idea
continuare a seguire questo
+modello per migliorare l'organizzazione e la address@hidden del programma.
+
+Regole multiple @code{BEGIN} ed @code{END} sono utili per scrivere funzioni
+di libreria, poich@'e ogni file di libreria address@hidden avere la sua
propria regola
address@hidden e/o @code{END} per fare la propria inizializzazione e/o pulizia.
+L'ordine in cui le funzioni di libreria sono menzionate nella riga dei comandi
+determina l'ordine in cui le rispettive regole @code{BEGIN} ed @code{END} sono
+eseguite. Per questo motivi, occorre prestare attenzione nello scrivere tali
+regole nei file di libreria, in modo che non sia importante
+l'ordine in cui tali regole vengono eseguite.
address@hidden per maggiori informazioni sull'uso di funzioni di libreria.
address@hidden
address@hidden di libreria},
address@hidden iftex
address@hidden
address@hidden di libreria},
address@hidden ifnottex
+per parecchie utili funzioni di libreria.
+
+Se un programma @command{awk} ha solo regole @code{BEGIN} e nessun'altra
+regola, il programma esce dopo aver eseguito le regole
address@hidden@footnote{La versione originale di @command{awk} continuava a
+leggere e ignorare i record in input fino alla fine del file.} Tuttavia, se
+una regola @code{END} esiste, l'intero input @`e letto, anche se non sono
+presenti altre regole nel programma. address@hidden viene fatto
necessariamente
+per permettere che
+la regola @code{END} faccia uso delle variabili @code{FNR} e @code{NR}.
+
address@hidden I/O e BEGIN/END
address@hidden Input/Output dalle regole @code{BEGIN} ed @code{END}
+
address@hidden input/output, dalle regole @code{BEGIN} ed @code{END}
+Ci sono parecchi punti (talora insidiosi) da tener presente se si fa dell'I/O
+all'interno di una regola @code{BEGIN} o @code{END}.
+Il primo ha a che fare con il valore di @code{$0} in una regola @code{BEGIN}.
+Poich@'e le regole @code{BEGIN} sono eseguite prima delle lettura di qualsiasi
+input, non c'@`e assolutamente alcun record in input, e quindi nessun campo,
+quando si eseguono delle regole @code{BEGIN}. I riferimento a @code{$0} e ai
+campi restituiscono una stringa nulla o zero, a seconda del contesto.
+Un modo per assegnare un valore effettivo a @code{$0} @`e di eseguire un
+comando @code{getline} senza indicare una variabile (@pxref{Getline}).
+Un altro modo @`e semplicemente quello di assegnare un valore a @code{$0}.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden differenze tra @command{awk} e @command{gawk}, criteri di
ricerca @code{BEGIN}/@code{END}
address@hidden POSIX @command{awk}, criteri di ricerca @code{BEGIN}/@code{END}
address@hidden @code{print}, istruzione, criteri di ricerca
@code{BEGIN}/@code{END} e
address@hidden @code{BEGIN}, criterio di ricerca, istruzione @code{print} e
address@hidden @code{END}, criterio di ricerca, istruzione @code{print} e
+Il secondo punto @`e simile al primo, ma in direzione opposta.
+Tradizionalmente, address@hidden che altro per problemi di implementazione,
@code{$0}
+e @code{NF} erano @emph{indefiniti} all'interno di una regola @code{END}.
+Lo standard POSIX prescrive che @code{NF} sia disponibile all'interno di una
+regola @code{END}. Contiene il numero di campi dell'ultimo record in input.
+Probabilmente per una svista, lo standard non specifica che @`e reso
+disponibile anche @code{$0}, sebbene possa apparire logico che sia
address@hidden@dotless{i}}.
+In effetti, BWK @command{awk}, @command{mawk} e @command{gawk} mantengono il
+valore di @code{$0} in modo che sia possibile usarlo all'interno delle regole
address@hidden Occorre peraltro tener presente che alcune altre implementazioni
+e parecchie tra le versioni address@hidden vecchie di Unix @command{awk} non si
+comportano address@hidden@dotless{i}}.
+
+Il terzo punto @`e una conseguenza dei primi due. Il significato di
address@hidden
+all'interno di una regola @code{BEGIN} o @code{END} @`e quello di sempre:
address@hidden $0}. Se @code{$0} @`e la stringa nulla, stampa una riga vuota.
+Molti programmatori di lungo corso di @command{awk} usano un semplice
address@hidden all'interno delle regole @code{BEGIN} ed @code{END},
+intendendo @address@hidden ""}}, contando sul fatto che @code{$0} sia una
+stringa nulla. Sebbene questo funzioni solitamente con le regole
address@hidden, @`e una pessima idea nelle regole @code{END},
+almeno in @command{gawk}. @`E anche stilisticamente inelegante, perch@'e se
+serve una riga vuota in output, il programma dovrebbe stamparne
+una esplicitamente.
+
address@hidden @code{next}, istruzione, criteri di ricerca
@code{BEGIN}/@code{END} e
address@hidden @code{nextfile}, istruzione, criteri di ricerca
@code{BEGIN}/@code{END} e
address@hidden @code{BEGIN}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
address@hidden @code{END}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
+Per finire, le istruzioni @code{next} e @code{nextfile} non sono consentite
+all'interno di una regola @code{BEGIN}, perch@'e il ciclo implicito
+leggi-un-record-e-confrontalo-con-le-regole non @`e ancora iniziato.
+Analogamente, tali istruzioni non sono valide all'interno di una regola
address@hidden, perch@'e tutto l'input @`e address@hidden stato letto.
+(@xref{Istruzione next} e
address@hidden
address@hidden nextfile}.)
address@hidden ifnotdocbook
address@hidden
address@hidden nextfile}.)
address@hidden ifdocbook
+
address@hidden BEGINFILE/ENDFILE
address@hidden I criteri di ricerca speciali @code{BEGINFILE} ed @code{ENDFILE}
address@hidden @code{BEGINFILE}, criterio di ricerca
address@hidden @code{ENDFILE}, criterio di ricerca
address@hidden differenze tra @command{awk} e @command{gawk}, criteri di
ricerca @code{BEGINFILE}/@code{ENDFILE}
+
+Questa @value{SECTION} descrive una address@hidden specifica di @command{gawk}.
+
+Due tipi speciali di criterio di ricerca, @code{BEGINFILE} ed @code{ENDFILE},
+forniscono
+degli ``agganci'' per intervenire durante il ciclo di elaborazione dei file
+specificati sulla riga di comando di @command{gawk}.
+Come con le regole @code{BEGIN} ed @code{END}
address@hidden
address@hidden
+(@pxref{BEGIN/END}),
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+(si veda la @value{SECTION} precedente),
address@hidden iftex
address@hidden
+(si veda la @value{SECTION} precedente),
address@hidden ifdocbook
+tutte le regole @code{BEGINFILE} in un programma sono riunite, mantenendole
+nell'ordine in cui sono lette da @command{gawk} e lo stesso viene fatto
+per tutte le regole @code{ENDFILE}.
+
+Il corpo delle regole @code{BEGINFILE} @`e eseguito subito prima che
address@hidden legga il primo record da un file. La variabile @code{FILENAME}
address@hidden impostata al nome del file corrente e @code{FNR} @`e impostata a
zero.
+
+La regola @code{BEGINFILE} address@hidden la address@hidden di eseguire due
compiti
+che sarebbe difficile o impossibile effettuare altrimenti:
+
address@hidden @value{BULLET}
address@hidden
+Si address@hidden verificare che il file sia leggibile. Di solito, se un file
presente
+nella riga dei comandi non address@hidden essere aperto in lettura, il
programma
address@hidden viene terminato. Comunque, questo si address@hidden evitare,
per poi
+passare a elaborare il file successivo specificato sulla riga dei comandi.
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile, con criterio di ricerca @code{BEGINFILE}
address@hidden @code{nextfile}, istruzione, criteri di ricerca
@code{BEGINFILE}/@code{ENDFILE} e
+Questo controllo @`e fattibile controllando se la variabile @code{ERRNO} @`e
+diversa dalla stringa nulla; se @`e questo il caso, @command{gawk} non @`e
+riuscito ad aprire il file. In questo caso il programma address@hidden
eseguire
+un'istruzione @code{nextfile}
+(@pxref{Istruzione nextfile}). In questo modo @command{gawk} salta
+completamente l'elaborazione di quel file.
+In caso contrario, @command{gawk} termina come al solito con un
+errore fatale.
+
address@hidden
+Se sono state scritte estensioni che modificano la gestione del record
+(tramite l'inserzione di un ``analizzatore di input'';
address@hidden di input}), @`e possibile richiamarle
+a questo punto, prima che @command{gawk} inizi a elaborare il file.
+(Questa @`e una address@hidden @emph{molto} avanzata, usata al momento solo dal
address@hidden://sourceforge.net/projects/gawkextlib, progetto
@code{gawkextlib}}.)
address@hidden itemize
+
+La regola @code{ENDFILE} @`e chiamata quando @command{gawk} ha finito di
+elaborare l'ultimo record di un file in input. Per l'ultimo file in input,
address@hidden chiamata prima di ogni regola @code{END}.
+La regola @code{ENDFILE} @`e eseguita anche per file in input vuoti.
+
+Normalmente, se si verifica un errore di lettura durante il normale
+ciclo di elaborazione dell'input,
+questo @`e considerato fatale (il programma termina). Tuttavia, se @`e
presente
+una regola @code{ENDFILE}, l'errore non @`e considerato fatale, ma viene
+impostato @code{ERRNO}. address@hidden permette di intercettare ed elaborare
errori
+di I/O a livello di programma @command{awk}.
+
address@hidden @code{next}, istruzione, criteri di ricerca
@code{BEGINFILE}/@code{ENDFILE} e
+L'istruzione @code{next} (@pxref{Istruzione next}) non @`e permessa all'interno
+di una regola @code{BEGINFILE} o @code{ENDFILE}. L'istruzione @code{nextfile}
address@hidden consentita solo all'interno di una regola @code{BEGINFILE}, non
all'interno
+di una regola @code{ENDFILE}.
+
address@hidden @code{getline}, comando, criteri di ricerca
@code{BEGINFILE}/@code{ENDFILE} e
+L'istruzione @code{getline} (@pxref{Getline}) @`e limitata all'interno sia di
address@hidden che di @code{ENDFILE}: solo le forme ridirette di
+di @code{getline} sono permesse.
+
address@hidden ed @code{ENDFILE} sono estensioni @command{gawk}.
+In molte altre implementazioni di @command{awk} o se @command{gawk} @`e in
address@hidden compatibile (@pxref{Opzioni}), non sono regole speciali.
+
address@hidden FIXME: For 4.2 maybe deal with this?
address@hidden
+Date: Tue, 17 May 2011 02:06:10 PDT
+From: address@hidden (Pat Rankin)
+Message-Id: <address@hidden>
+Subject: BEGINFILE
+To: address@hidden
+
+ The documentation for BEGINFILE states that FNR is 0, which seems
+pretty obvious. It doesn't mention what the value of $0 is, and that's
+not obvious. I think setting it to null before starting the BEGINFILE
+action would be preferable to leaving whatever was there in the last
+record of the previous file.
+
+ ENDFILE can retain the last record in $0. I guess it has to if
+the END rule's actions see that value too. But the beginning of a new
+file doesn't just mean that the old one has been closed; the old file
+is being superseded, so leaving the old data around feels wrong to me.
+[If the user wants to keep it on hand, he or she can use an ENDFILE
+rule to grab it before moving on to the next file.]
address@hidden ignore
+
address@hidden Vuoto
address@hidden Il criterio di ricerca vuoto
+
address@hidden vuoto, criterio di ricerca
address@hidden criteri di ricerca vuoti
+Un criterio di ricerca vuoto (address@hidden omesso) corrisponde a
address@hidden record in input. Per esempio, il programma:
+
address@hidden
+awk '@{ print $1 @}' mail-list
address@hidden example
+
address@hidden
+stampa il primo campo di ogni record.
+
address@hidden Usare variabili di shell
address@hidden Usare variabili di shell in programmi
address@hidden shell, variabili di
address@hidden programmi @command{awk}, variabili di shell in
address@hidden @cindex shell and @command{awk} interaction
+
+I programmi @command{awk} sono spesso usati come componenti di programmi
address@hidden
+ampi, scritti in un linguaggio di shell.
+Per esempio, @`e molto comune usare una variabile di shell per
+specificare un criterio di ricerca che il programma @command{awk} deve poi
+individuare.
+Ci sono due modi per rendere disponibile il valore di una variabile di shell
+all'interno di un programma @command{awk}.
+
address@hidden shell, uso di doppio apice
+Un modo comune @`e quello di usare i doppi apici per sostituire il valore della
+variabile nel progamma @command{awk} contenuto nello @dfn{script}:
+
+Per esempio, si consideri il programma seguente:
+
address@hidden
+printf "Immettere il criterio di ricerca: "
+read criterio_di_ricerca
+awk "/$criterio_di_ricerca/ "'@{ num_trov++ @}
+ END @{ print num_trov, "occorrenze trovate" @}' /nome/file/dati
address@hidden example
+
address@hidden
+Il programma @command{awk} consiste di due pezzi di testo tra apici
+che, concatenati insieme, formano il programma.
+La prima parte @`e tra doppi apici, per consentire la sostituzione della
+variabile di shell @code{criterio_di_ricerca} contenuta al loro interno.
+La seconda parte @`e racchiusa tra apici singoli.
+
+La sostituzione di variabile attraverso gli apici funziona, ma address@hidden
+facilmente generare address@hidden Richiede una buona comprensione delle
+regole per l'uso degli apici nella shell
+(@pxref{Protezione}),
+e spesso @`e difficile accoppiare i vari apici quando si legge il programma.
+
+Un metodo migliore @`e quello di usare la address@hidden di assegnamento delle
+variabili di @command{awk}
+(@pxref{Opzioni di assegnamento})
+per assegnare il valore di una variabile di shell a una variabile
+di @command{awk}.
+Poi si possono usare @dfn{regexp} dinamiche come criterio di ricerca
+(@pxref{Espressioni regolari calcolate}).
+Quanto segue mostra come sarebbe l'esempio precedente usando questa tecnica:
+
address@hidden
+printf "Immettere il criterio di ricerca: "
+read criterio_di_ricerca
+awk -v crit="$criterio_di_ricerca" '$0 ~ crit @{ num_trov++ @}
+ END @{ print num_trov, "occorrenze trovate" @}' /nome/file/dati
address@hidden example
+
address@hidden
+Adesso il programma @command{awk} @`e solo una stringa tra apici semplici.
+L'assegnamento @samp{-v crit="$criterio_di_ricerca"} richiede ancora doppi
+apici, per il caso in cui uno spazio vuoto sia presente nel valore di
address@hidden
+La variabile @command{awk} @code{crit} potrebbe avere come nome anche
address@hidden, ma address@hidden potrebbe essere causa di confusione.
+Usare una variabile permette una maggiore address@hidden, poich@'e la variabile
address@hidden essere usata in ogni parte del
+programma---per stamparla, per indicizzare un vettore, o per qualsiasi altro
+scopo---senza che sia necessario l'artificio di doverla inserire usando gli
+apici.
+
address@hidden Panoramica sulle azioni
address@hidden Azioni
address@hidden @cindex action, definition of
address@hidden @cindex curly braces
address@hidden @cindex action, curly braces
address@hidden @cindex action, separating statements
address@hidden azioni
+
+Un programma o script @command{awk} consiste in una serie di
+regole e definizioni di funzione frammiste tra loro. (Le funzioni sono
+descritte address@hidden avanti. @xref{Funzioni definite dall'utente}.)
+Una regola contiene un criterio di ricerca e un'azione; l'uno o l'altra
+(ma non tutt'e due) possono essere omessi. Lo scopo di una @dfn{azione} @`e
+di specificare cosa deve fare @command{awk} quando si trova una corrispondenza
+con il criterio di ricerca. Quindi, schematicamente, un programma
address@hidden @`e normalmente simile a questo:
+
address@hidden
address@hidden di ricerca}] @address@hidden @var{azione} @}}
+ @var{criterio di ricerca} address@hidden@{ @var{azione} @}}]
address@hidden
address@hidden @var{nome}(@var{argomenti}) @{ @dots{} @}}
address@hidden
address@hidden display
+
address@hidden @address@hidden@}} (parentesi graffe), azioni e
address@hidden parentesi graffe (@address@hidden@}}), azioni e
address@hidden separatori, per istruzioni in azioni
address@hidden a capo, separatore di istruzioni nelle azioni
address@hidden @code{;} (punto e virgola), separare istruzioni nelle azioni
address@hidden punto e virgola (@code{;}), separare istruzioni nelle azioni
+Un'azione consiste di una o address@hidden @dfn{istruzioni} @command{awk},
racchiuse
+fra parentesi graffe (@address@hidden@address@hidden@}}). Ogni istruzione
specifica
+una cosa da fare. Le istruzioni sono separate tra loro da dei ritorni a capo o
+da dei punti e virgola.
+Le parentesi graffe attorno a un'azione vanno usate anche se l'azione
+contiene una sola istruzione o se non contiene alcuna istruzione.
+Comunque, se si omette completamente l'azione, si possono omettere anche le
+parentesi graffe. Un'azione omessa @`e equivalente a specificare
address@hidden@{ print $0 @}}:
+
address@hidden
+/pippo/ @{ @} @ii{se si trova @code{pippo}, non fare nulla --- azione
vuota}
+/pippo/ @ii{se si trova @code{pippo}, stampa il record --- azione
omessa}
address@hidden example
+
+I seguenti tipi di istruzione sono disponibili in @command{awk}:
+
address@hidden @asis
address@hidden effetti collaterali delle istruzioni
address@hidden istruzioni, effetti collaterali delle
address@hidden Espressioni
+Servono per chiamare funzioni o assegnare valori a variabili
address@hidden
+(@pxrefil{Espressioni}). L'esecuzione
address@hidden iftex
address@hidden
+(@pxref{Espressioni}). L'esecuzione
address@hidden ifnottex
+di questo tipo di istruzione calcola semplicemente il valore dell'espressione.
address@hidden @`e utile quando l'espressione ha effetti collaterali
+(@pxref{Operatori di assegnamento}).
+
address@hidden Istruzioni di controllo
+Specificano il flusso di controllo dei programmi @command{awk}.
+Il linguaggio @command{awk} utilizza dei costrutti simili a quelli del C,
+(@code{if}, @code{for}, @code{while} e @code{do}), e anche alcune altre
+di tipo speciale (@pxref{Istruzioni}).
+
address@hidden Istruzioni composte
+Sono una o address@hidden istruzioni racchiuse tra parentesi graffe.
Un'istruzione
+composta
address@hidden usata per riunire un gruppo di istruzioni all'interno di
+un'istruzione @code{if}, @code{while}, @code{do} o @code{for}.
+
address@hidden Istruzioni di input
+Usano il comando @code{getline}
+(@pxref{Getline}).
+In @command{awk} sono anche disponibili le istruzioni @code{next}
+(@pxref{Istruzione next})
+e @code{nextfile}
+(@pxref{Istruzione nextfile}).
+
address@hidden Istruzioni di output
+Come @code{print} e @code{printf}.
address@hidden
address@hidden
address@hidden iftex
address@hidden
address@hidden
address@hidden ifnottex
+
address@hidden Istruzioni di cancellazione
+Per eliminare elementi di vettori.
address@hidden
address@hidden table
+
address@hidden Istruzioni
address@hidden Istruzioni di controllo nelle azioni
address@hidden istruzioni di controllo
address@hidden controllo, tramite istruzioni, in azioni
address@hidden azioni, istruzioni di controllo in
+
+Le @dfn{istruzioni di controllo}, come @code{if}, @code{while} e
address@hidden@dotless{i}} via,
+regolano il flusso di esecuzione nei programmi @command{awk}. Molte tra
+le istruzioni di controllo di @command{awk} sono modellate sulle
+corrispondenti istruzioni in C.
address@hidden istruzioni address@hidden istruzioni di controllo e
address@hidden composte, address@hidden istruzioni di controllo e
address@hidden corpo, nelle azioni
address@hidden @address@hidden@}} (parentesi graffe), istruzioni, raggruppare
address@hidden parentesi graffe (@address@hidden@}}), istruzioni, raggruppare
address@hidden a capo, separatore di istruzioni nelle azioni
address@hidden @code{;} (punto e virgola), separare istruzioni nelle azioni
address@hidden punto e virgola (@code{;}), separare istruzioni nelle azioni
+Tutte le istruzioni di controllo iniziano con parole chiave speciali, come
address@hidden e @code{while}, per distinguerle dalle semplici espressioni.
+Molte istruzioni di controllo contengono altre istruzioni. Per esempio,
+l'istruzione @code{if} contiene un'altra istruzione che address@hidden essere
eseguita
+oppure no. Le istruzioni contenute sono chiamate @dfn{corpo}.
+Per includere address@hidden di un'istruzione nel corpo, queste vanno
raggruppate
+in una sola @dfn{istruzione composta} tra parentesi graffe, e separate tra
+loro con dei ritorni a capo o dei punti e virgola.
+
address@hidden
+* Istruzione if:: Eseguire in maniera condizionale
+ istruzioni @command{awk}.
+* Istruzione while:: Eseguire il ciclo finch@'e @`e
+ verificata una condizione.
+* Istruzione do:: Eseguire l'azione specificata, continuare
+ a eseguire il ciclo
+ finch@'e @`e verificata una condizione.
+* Istruzione for:: Un'altra istruzione iterativa, che
+ permette di specificare clausole
+ iniziali e di incremento.
+* Istruzione switch :: Valutazione di quale insieme di
+ istruzioni eseguire, a seconda del
+ valore assunto da una variabile.
+* Istruzione break:: Uscire subito dal ciclo address@hidden interno
+ in cui ci si trova.
+* Istruzione continue:: Andare alla fine del ciclo address@hidden
interno
+ in cui ci si trova.
+* Istruzione next:: Smettere di elaborare il record corrente.
+* Istruzione nextfile:: Smettere di elaborare il file corrente.
+* Istruzione exit:: Interrompere l'esecuzione di @command{awk}.
address@hidden menu
+
address@hidden Istruzione if
address@hidden L'istruzione @address@hidden
+
address@hidden istruzione @code{if}
address@hidden @code{if}, istruzione
+L'istruzione @address@hidden @`e quella che serve in @command{awk}
+per prendere decisioni. @`E simile
+a questa:
+
address@hidden
address@hidden (@var{condizione}) @var{se-vera-fai}} address@hidden
@var{se-falsa-fai}}]
address@hidden display
+
address@hidden
+La @var{condizione} @`e un'espressione che controlla quel che fa il resto
+dell'istruzione. Se la @var{condizione} @`e vera, viene eseguita la
+parte @var{se-vera-fai}; altrimenti viene
+eseguita la parte @var{se-falsa-fai}.
+La parte @code{else} dell'istruzione @`e
+facoltativa. La condizione @`e considerata falsa se il suo valore @`e zero o
+la stringa nulla; altrimenti, la condizione @`e vera.
+Si consideri quanto segue:
+
address@hidden
+if (x % 2 == 0)
+ print "x @`e pari"
+else
+ print "x @`e dispari"
address@hidden example
+
+In questo esempio, se l'espressione @samp{x % 2 == 0} @`e vera (address@hidden,
+se il valore di @code{x} @`e esattamente divisibile per due), allora viene
+eseguita la prima istruzione
address@hidden; altrimenti, viene eseguita la seconda istruzione @code{print}.
+Se la parola chiave @code{else} sta sulla stessa riga di @var{se-vera-fai}
+e se @var{se-vera-fai} non @`e un'istruzione composta (address@hidden, non @`e
racchiusa
+tra parentesi graffe), allora un punto e virgola deve separare
address@hidden dalla parola chiave @code{else}.
+Per chiarire questo, l'esempio precedente si address@hidden riscrivere come:
+
address@hidden
+if (x % 2 == 0) print "x @`e pari"; else
+ print "x @`e dispari"
address@hidden example
+
address@hidden
+Se il @samp{;} @`e omesso, @command{awk} non address@hidden interpretare
l'istruzione e
+segnala un errore di sintassi. Non si dovrebbero scrivere programmi in
+questo modo, perch@'e a chi li legge potrebbe sfuggire la parola chiave
address@hidden se non @`e la prima parola della riga.
+
address@hidden Istruzione while
address@hidden L'istruzione @code{while}
address@hidden @code{while}, istruzione
address@hidden istruzione @code{while}
address@hidden cicli
address@hidden cicli, @code{while}
address@hidden cicli, si veda anche @code{while}, istruzione
+
+Nella programmazione, un @dfn{ciclo} @`e una parte di un programma che
address@hidden
+essere eseguita due o address@hidden volte consecutivamente.
+L'istruzione @code{while} @`e la address@hidden semplice istruzione iterativa
in
address@hidden Esegue ripetutamente un'istruzione finch@'e una data
+condizione @`e vera. Per esempio:
+
address@hidden
+while (@var{condizione})
+ @var{corpo-del-ciclo}
address@hidden example
+
address@hidden corpo, nei cicli
address@hidden
address@hidden @`e un'istruzione detta @dfn{corpo} del ciclo,
+e @var{condizione} @`e un'espressione che controlla per quante volte il ciclo
+deve continuare a essere ripetuto.
+La prima cosa che l'istruzione @code{while} fa @`e un controllo della
address@hidden
+Se la @var{condizione} @`e vera, viene eseguita l'istruzione
address@hidden
address@hidden
+(La @var{condizione} @`e vera quando il suo valore
address@hidden diverso da zero e non @`e la stringa nulla.)
address@hidden ifinfo
+Dopo che le istruzioni in @var{corpo-del-ciclo} sono state eseguite,
address@hidden @`e controllata nuovamente, e se @`e ancora vera,
address@hidden viene eseguito ancora. Questo processo @`e ripetuto
+finch@'e @var{condizione} rimane vera. Se la @var{condizione} @`e falsa fin
+dall'inizio, il corpo del ciclo
+non viene eseguito per nulla, e @command{awk} continua con l'istruzione
+che viene dopo il ciclo.
+Questo esempio stampa i primi tre campi di ogni record in input, uno per
+riga:
+
address@hidden
+awk '
address@hidden
+ i = 1
+ while (i <= 3) @{
+ print $i
+ i++
+ @}
address@hidden' inventory-shipped
address@hidden example
+
address@hidden
+Il corpo di questo ciclo @`e un'istruzione composta racchiusa tra parentesi
graffe,
+che contiene due istruzioni.
+Il ciclo funziona in questo modo: all'inizio, il valore di @code{i} @`e
+impostato a 1.
+Poi, l'istruzione @code{while} controlla se @code{i} @`e minore o uguale a
+tre. address@hidden @`e vero quando @code{i} @`e uguale a 1, quindi il campo
address@hidden viene stampato. Quindi l'istruzione @samp{i++} incrementa il
+valore di @code{i}
+e il ciclo viene ripetuto. Il ciclo termina quando @code{i} assume il
+valore quattro.
+
+Un ritorno a capo non @`e richiesto tra la condizione e il corpo del ciclo;
+tuttavia, se lo si mette, il programma @`e di address@hidden facile
comprensione,
+a meno che il corpo del ciclo non sia un'istruzione composta, oppure se @`e
+qualcosa di molto semplice. Neppure il ritorno a capo dopo la parentesi graffa
+aperta che inizia l'istruzione composta @`e necessario, ma il
+programma @`e di lettura address@hidden difficile se lo si omette.
+
address@hidden Istruzione do
address@hidden L'istruzione @address@hidden
address@hidden @address@hidden
address@hidden cicli, @address@hidden
+
+Il ciclo @code{do} @`e una variazione dell'istruzione di ciclo @code{while}.
+Il ciclo @code{do} esegue il @var{corpo-del-ciclo} una volta e poi ripete il
address@hidden finch@'e la @var{condizione} rimane vera. @`E simile a questo:
address@hidden
+do
+ @var{corpo-del-ciclo}
+while (@var{condizione})
address@hidden example
+
+Anche se la @var{condizione} @`e falsa fin dall'inizio, il
@var{corpo-del-ciclo}
+viene eseguito almeno una volta (e solo una volta, a meno che
+l'esecuzione di @var{corpo-del-ciclo}
+non renda vera la @var{condizione}). Si confronti con il corrispondente
address@hidden:
+
address@hidden
+while (@var{condizione})
+ @var{corpo-del-ciclo}
address@hidden example
+
address@hidden
+Quest'istruzione non esegue il @var{corpo-del-ciclo} neppure una volta, se
+la @var{condizione} @`e falsa fin dall'inizio. Il seguente @`e un esempio di
address@hidden:
+
address@hidden
address@hidden
+ i = 1
+ do @{
+ print $0
+ i++
+ @} while (i <= 10)
address@hidden
address@hidden example
+
address@hidden
+Questo programma stampa ogni record in input per 10 volte. Non si tratta,
+peraltro, di un esempio molto realistico, perch@'e in questo caso un semplice
address@hidden sarebbe sufficiente. Questa osservazione riflette un'esperienza
+reale; solo occasionalmente @`e davvero necessario usare un @code{do}.
+
address@hidden Istruzione for
address@hidden L'istruzione @code{for}
address@hidden istruzione @code{for}
address@hidden @code{for}, istruzione
address@hidden cicli, @code{for}, iterativi
+
+L'istruzione @code{for} rende address@hidden agevole contare le iterazioni di
un ciclo.
+La forma generale dell'istruzione @code{for} @`e simile a questa:
+
address@hidden
+for (@var{inizializzazione}; @var{condizione}; @var{incremento})
+ @var{corpo-del-ciclo}
address@hidden example
+
address@hidden
+La parti @var{inizializzazione}, @var{condizione} e @var{incremento} sono
+espressioni @command{awk} a piacere, e @var{corpo-del-ciclo} indica qualsiasi
+istruzione @command{awk}.
+
+L'istruzione @code{for} comincia con l'esecuzione di @var{inizializzazione}.
+Poi, finch@'e
+la @var{condizione} @`e vera, esegue ripetutamente @var{corpo-del-ciclo},
+e quindi @var{incremento}. Tipicamente, @var{inizializzazione} imposta una
+variabile a zero o a uno, @var{incremento} aggiunge uno alla stessa e
address@hidden ne confronta il valore rispetto al numero desiderato di
+iterazioni.
+Per esempio:
+
address@hidden
+awk '
address@hidden
+ for (i = 1; i <= 3; i++)
+ print $i
address@hidden' inventory-shipped
address@hidden example
+
address@hidden
+Questo programma stampa i primi tre campi di ogni record in input, mettendo
+un campo su ogni riga.
+
+Non @`e possibile impostare
address@hidden di una variabile nella parte di
address@hidden senza usare un'istruzione di assegnamento multiplo,
+come @samp{x = y = 0}. address@hidden ha senso solo se tutti i valori iniziali
+sono uguali. (Ma @`e possibile inizializzare ulteriori variabili scrivendo
+i relativi assegnamenti come istruzioni separate @emph{prima} del ciclo
address@hidden)
+
address@hidden @cindex comma operator, not supported
+Lo stesso vale per la parte @var{incremento}. Se serve incrementare ulteriori
+variabili, questo va fatto con istruzioni separate alla fine del ciclo.
+L'espressione composta del linguaggio C, che usa l'operatore virgola [,]
+del C, sarebbe
+utile in questo contesto, ma non @`e
+prevista in @command{awk}.
+
+Molto spesso, @var{incremento} @`e un'espressione di incremento, come
+nell'esempio precedente. Ma questo non @`e obbligatorio; address@hidden
trattarsi di
+un'espressione qualsiasi. Per esempio,
+la seguente istruzione stampa tutte le potenze di due comprese
+tra 1 e 100:
+
address@hidden
+for (i = 1; i <= 100; i *= 2)
+ print i
address@hidden example
+
+Se non @`e necessaria, ognuna delle tre espressioni fra
+parentesi che segue la parola chiave @code{for} address@hidden essere omessa.
Quindi,
address@hidden@samp{for (; x > 0;)}} @`e equivalente a @address@hidden (x >
0)}}. Se la
address@hidden @`e omessa del tutto, @`e ritenuta sempre vera, producendo
+un @dfn{ciclo infinito} (address@hidden, un ciclo che non finisce mai).
+
+Molto spesso, un ciclo @code{for} @`e un'abbreviazione per un ciclo
@code{while},
+come si address@hidden vedere qui:
+
address@hidden
address@hidden
+while (@var{condizione}) @{
+ @var{corpo-del-ciclo}
+ @var{incremento}
address@hidden
address@hidden example
+
address@hidden cicli, istruzione @code{continue} e
address@hidden
+La sola eccezione @`e quando l'istruzione @code{continue}
+(@pxref{Istruzione continue}) @`e usata
+all'interno del ciclo. Se si modifica un'istruzione @code{for}
+sostituendola con un'istruzione @code{while}
address@hidden address@hidden cambiare l'effetto dell'istruzione
@code{continue} posta all'interno
+del ciclo.
+
+Il linguaggio @command{awk} ha un'istruzione @code{for} oltre all'istruzione
address@hidden perch@'e un ciclo @code{for} @`e spesso address@hidden semplice
da scrivere,
+e viene in mente address@hidden naturalmente.
+Contare il numero di iterazioni @`e
+molto frequente nei cicli. address@hidden essere address@hidden facile
pensare a questo conto come
+parte del ciclo, piuttosto che come qualcosa da fare all'interno del ciclo.
+
address@hidden @code{in}, operatore
address@hidden operatore @code{in}
+Esiste una versione alternativa al ciclo @code{for}, per esaminare tutti
+gli indici di un vettore:
+
address@hidden
+for (i in vettore)
+ @var{fai qualcosa con} vettore[i]
address@hidden example
+
address@hidden
address@hidden un intero vettore}
+per maggiori informazioni su questa versione del ciclo @code{for}.
+
address@hidden Istruzione switch
address@hidden L'istruzione @code{switch}
address@hidden @code{switch}, istruzione
address@hidden @code{case}, parola chiave
address@hidden parola chiave @code{case}
address@hidden @code{default}, parola chiave
address@hidden parola chiave @code{default}
+
+Questa @value{SECTION} descrive una address@hidden disponibile solo in
address@hidden
+Se @command{gawk} @`e in address@hidden compatibile (@pxref{Opzioni}),
+la address@hidden non @`e disponibile.
+
+L'istruzione @code{switch} consente di valutare un'espressione e di
+eseguire istruzioni se il valore trovato corrisponde a uno dei @code{case}
[casi] previsti.
+Le istruzioni @code{case} sono esaminate per cercare una corrispondenza
+nell'ordine in cui i casi sono definiti nel programma. Se nessuno dei
@code{case}
+corrisponde al valore dell'espressione, viene eseguita la sezione
address@hidden, se @`e stata specificata.
+
+Ogni @code{case} contiene una singola costante, che address@hidden essere un
numero,
+una stringa, o
+una @dfn{regexp}. Viene valutata l'espressione @code{switch}, e poi la
+costante di ogni @code{case} viene confrontata
+di volta in volta con il valore risultante.
+Il tipo di costante determina quale address@hidden il confronto: per i tipi
numerici o
+stringa si seguono le regole abituali. Per una costante @dfn{regexp} viene
+effettuato un confronto tra l'espressione e il valore di tipo stringa
+dell'espressione originale.
+Il formato generale dell'istruzione @code{switch} @`e simile a questo:
+
address@hidden
+switch (@var{espressione}) @{
+case @var{valore o espressione regolare}:
+ @var{corpo-del-caso}
+default:
+ @var{corpo-del-default}
address@hidden
address@hidden example
+
+Il flusso di controllo
+dell'istruzione @code{switch} funziona come per il linguaggio C. Una volta
+stabilita una corrispondenza con un dato caso, le istruzione che formano il
+corpo del caso sono eseguite, fino a che non venga trovata un'istruzione
address@hidden,
address@hidden, @code{next}, @code{nextfile} o @code{exit},
+o fino alla fine dell'istruzione @code{switch} medesima. Per esempio:
+
address@hidden
+while ((c = getopt(ARGC, ARGV, "aksx")) != -1) @{
+ switch (c) @{
+ case "a":
+ # stampa la dimensione di tutti i file
+ all_files = TRUE;
+ break
+ case "k":
+ BLOCK_SIZE = 1024 # in blocchi da 1 Kbyte
+ break
+ case "s":
+ # fa solo le somme
+ sum_only = TRUE
+ break
+ case "x":
+ # non esce dal filesystem
+ fts_flags = or(fts_flags, FTS_XDEV)
+ break
+ case "?":
+ default:
+ uso()
+ break
+ @}
address@hidden
address@hidden example
+
+Si noti che se nessuna delle istruzioni specificate qui arresta l'esecuzione
+di un'istruzione @code{case} per la quale @`e stata trovata una corrispondenza;
+l'esecuzione continua fino al successivo @code{case} finch@'e
+non viene interrotta. In questo esempio, il
address@hidden per @code{"?"} esegue quello di @code{default}, che consiste nel
+chiamare una funzione di nome @code{uso()}.
+(La funzione @code{getopt()} qui chiamata @`e descritta in
address@hidden getopt}.)
+
address@hidden Istruzione break
address@hidden L'istruzione @code{break}
address@hidden @code{break}, istruzione
address@hidden istruzione @code{break}
address@hidden cicli, uscita
address@hidden cicli, istruzione @code{break} e
+
+L'istruzione @code{break} esce dal ciclo address@hidden interno @code{for},
address@hidden o @code{do} dentro al quale si trova. L'esempio seguente
+trova, se esiste, il divisore address@hidden piccolo di un dato numero intero,
oppure
+dichiara che si tratta di un numero primo:
+
address@hidden
+# trova il divisore address@hidden piccolo di num
address@hidden
+ num = $1
+ for (divisore = 2; divisore * divisore <= num; divisore++) @{
+ if (num % divisore == 0)
+ break
+ @}
+ if (num % divisore == 0)
+ printf "Il address@hidden piccolo divisore di %d @`e %d\n", num,
divisore
+ else
+ printf "%d @`e un numero primo\n", num
address@hidden
address@hidden example
+
+Quando il resto della divisione @`e zero nella prima istruzione @code{if},
address@hidden immediatamente esce, a causa del @dfn{break}, dal ciclo
address@hidden in cui @`e contenuto. address@hidden vuol dire
+che @command{awk} prosegue immediatamente fino all'istruzione che viene dopo
+il ciclo, e continua l'elaborazione. (L'istruzione @code{break} @`e molto
+differente dall'istruzione @code{exit},
+la quale termina l'intero programma @command{awk}.
address@hidden exit}.)
+
+Il seguente programma mostra come la @var{condizione} di un'istruzione
address@hidden o @code{while} potrebbe essere sostituita da un'istruzione
address@hidden all'interno di un @code{if}:
+
address@hidden
+# trova il divisore address@hidden piccolo di num
address@hidden
+ num = $1
+ for (divisore = 2; ; divisore++) @{
+ if (num % divisore == 0) @{
+ printf "Il address@hidden piccolo divisore di %d @`e %d\n", num,
divisore
+ break
+ @}
+ if (divisore * divisore > num) @{
+ printf "%d @`e un numero primo\n", num
+ break
+ @}
+ @}
address@hidden
address@hidden example
+
+L'istruzione @code{break} @`e usata anche per terminare l'esecuzione di
+un'istruzione @code{switch}.
+Questo argomento @`e trattato in @ref{Istruzione switch}.
+
address@hidden @cindex @code{break}, outside of loops
address@hidden @cindex historical features
address@hidden @cindex @command{awk} language, POSIX version
address@hidden POSIX @command{awk}, @code{break} e
address@hidden angolo buio, istruzione @code{break}
address@hidden @command{gawk}, istruzione @code{break} in
address@hidden Brian Kernighan, @command{awk} di
+L'istruzione @code{break} non ha significato se
+usata fuori dal corpo di un ciclo o di un'istruzione @code{switch}.
+Tuttavia, anche se la cosa non @`e mai stata documentata,
+le prime implementazioni di @command{awk} consideravano l'istruzione
@code{break}
+esterna a un ciclo come un'istruzione @code{next}
+(@pxref{Istruzione next}).
address@hidden
+Versioni recenti di BWK @command{awk} non consentono address@hidden un tale
uso,
+e lo stesso fa @command{gawk}.
+
address@hidden Istruzione continue
address@hidden L'istruzione @code{continue}
+
address@hidden @code{continue}, istruzione
address@hidden istruzione @code{continue}
+Analogamente a @code{break}, l'istruzione @code{continue} @`e usata solo
+all'interno di cicli @code{for}, @code{while} e @code{do}. L'istruzione
+ignora il resto del corpo del ciclo, facendo address@hidden@dotless{i}} che la
successiva iterazione
+del ciclo inizi immediatamente. Questo comportamento @`e differente da quello
+di @code{break}, che esce completamente dal ciclo.
+
+L'istruzione @code{continue} in un ciclo @code{for} fa
address@hidden@dotless{i}} che @command{awk}
+ignori il resto del corpo del ciclo e prosegua l'esecuzione con l'espressione
address@hidden dell'istruzione @code{for}. Il seguente programma
address@hidden un esempio di address@hidden:
+
address@hidden
+BEGIN @{
+ for (x = 0; x <= 20; x++) @{
+ if (x == 5)
+ continue
+ printf "%d ", x
+ @}
+ print ""
address@hidden
address@hidden example
+
address@hidden
+Questo programma stampa tutti i numeri da 0 a 20---tranne il 5, in cui
+l'istruzione @code{printf} @`e saltata. Siccome l'incremento @samp{x++}
+non viene saltato, @code{x} non rimane fermo al valore 5. Si confronti il
ciclo
address@hidden dell'esempio precedente con il seguente ciclo @code{while}:
+
address@hidden
+BEGIN @{
+ x = 0
+ while (x <= 20) @{
+ if (x == 5)
+ continue
+ printf "%d ", x
+ x++
+ @}
+ print ""
address@hidden
address@hidden example
+
address@hidden
+Questo programma inizia un ciclo infinito dopo che @code{x} ha assunto il
+valore 5, poich@'e l'istruzione di incremento (@samp{x++}) non @`e mai
raggiunta.
+
address@hidden @cindex @code{continue}, fuori da un ciclo
address@hidden @cindex address@hidden del passato
address@hidden @cindex linguaggio @command{awk}, versione POSIX
address@hidden POSIX @command{awk}, istruzione @code{continue} e
address@hidden angolo buio, istruzione @code{continue}
address@hidden @command{gawk}, istruzione @code{continue} in
address@hidden Brian Kernighan, @command{awk} di
+L'istruzione @code{continue} non ha un significato speciale se appare in
+un'istruzione @code{switch}, e non ha alcun significato se usata fuori dal
+corpo di un ciclo. Le prime versioni di @command{awk} trattavano le
+istruzioni @code{continue} che erano fuori da un ciclo allo stesso modo con
+cui trattavano l'istruzione @code{break}
+fuori da un ciclo: come se fosse un'istruzione @code{next}
address@hidden FOR_PRINT
+(trattata nella @value{SECTION} seguente).
address@hidden ifset
address@hidden FOR_PRINT
+(@pxref{Istruzione next}).
address@hidden ifclear
address@hidden
+Versioni recenti di BWK @command{awk} non consentono address@hidden un tale
uso,
+e lo stesso vale per @command{gawk}.
+
address@hidden Istruzione next
address@hidden L'istruzione @code{next}
address@hidden @code{next}, istruzione
address@hidden istruzione @code{next}
+
+L'istruzione @code{next} fa address@hidden@dotless{i}} che @command{awk}
termini immediatamente
+l'elaborazione del record corrente e proceda a elaborare il record successivo.
address@hidden vuol dire che nessuna delle eventuali regole successive viene
eseguita
+per il record corrente e che il resto delle azioni presenti nella
+regola correntemente in esecuzione non viene eseguito.
+
+Si confronti quanto sopra con quel che fa la funzione @code{getline}
+(@pxref{Getline}). Anch'essa fa address@hidden@dotless{i}} che @command{awk}
legga il record
+successivo immediatamente, ma non altera il flusso del controllo in alcun
+modo (address@hidden, il resto dell'azione in esecuzione prosegue con il nuovo
record
+in input).
+
address@hidden @command{awk}, programmi, eseguire
+Al livello address@hidden alto, l'esecuzione di un programma @command{awk} @`e
un ciclo
+che legge un record in input e quindi confronta il criterio di ricerca di
+ciascuna regola con il record stesso. Se si vede questo ciclo come un
address@hidden il cui corpo contiene le regole, l'istruzione @code{next} @`e
analoga
+a un'istruzione @code{continue}. Salta, address@hidden, alla fine del corpo
di questo
+ciclo implicito
+ed esegue l'incremento (ovvero legge un altro record).
+
+Per esempio, si supponga che un programma @command{awk} agisca solo su record
+che hanno quattro campi, e che non dovrebbe terminare con un errore se trova
+dei record in input non validi. Per evitare di complicare il resto del
+programma, si address@hidden scrivere una regola ``filtro'' a inizio
programma, come
+mostrato in questo esempio:
+
address@hidden
+NF != 4 @{
+ printf("%s:%d: salto: NF != 4\n", FILENAME, FNR) > "/dev/stderr"
+ next
address@hidden
address@hidden example
+
address@hidden
+Siccome @`e presente un @code{next},
+le regole successive del programma non elaboreranno i record non validi.
+Il messaggio @`e ridiretto al flusso in output
address@hidden error}, sul quale vanno scritti i messaggi di errore.
+Per maggiori dettagli, si veda
address@hidden speciali}.
+
+Se l'istruzione @code{next} provoca il raggiungimento della fine del file
+in input, vengono eseguite le eventuali regole @code{END} presenti.
address@hidden/END}.
+
+L'istruzione @code{next} non @`e consentita all'interno delle regole
address@hidden ed @code{ENDFILE}.
address@hidden/ENDFILE}.
+
address@hidden @cindex @command{awk} language, POSIX version
address@hidden @cindex @code{next}, inside a user-defined function
address@hidden @code{BEGIN}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
address@hidden @code{END}, criterio di ricerca, istruzioni
@code{next}/@code{nextfile} e
address@hidden POSIX @command{awk}, istruzioni @code{next}/@code{nextfile} e
address@hidden @code{next}, istruzione, in funzioni definite dall'utente
address@hidden funzioni definite dall'utente, istruzioni
@code{next}/@code{nextfile} e
+Secondo lo standard POSIX, il comportamento di @command{awk} @`e indefinito
+se @code{next} @`e usato in una regola @code{BEGIN} o @code{END}.
address@hidden considera questo come un errore di sintassi. Sebbene POSIX
+non proibisca di usarlo,
+molte altre implementazioni di @command{awk} non consentono che l'istruzione
address@hidden sia usata all'interno del corpo di funzioni.
+(@pxref{Funzioni definite dall'utente}).
+Come tutte le altre istruzioni @code{next}, un'istruzione @code{next}
all'interno del
+corpo di una funzione legge il record successivo e inizia a elaborarlo
+a partire dalla prima regola del programma.
+
address@hidden Istruzione nextfile
address@hidden L'istruzione @code{nextfile}
address@hidden @code{nextfile}, istruzione
address@hidden istruzione @code{nextfile}
+
+L'istruzione @code{nextfile}
address@hidden simile all'istruzione @code{next}.
+Tuttavia, invece di terminare l'elaborazione del record corrente, l'istruzione
address@hidden richiede ad @command{awk} di terminare di elaborare il
address@hidden corrente.
+
+Alla fine dell'esecuzione dell'istruzione @code{nextfile},
address@hidden @`e
+aggiornato per contenere il nome del successivo @value{DF} elencato sulla riga
+di comando, @code{FNR} @`e reimpostato a uno, e l'elaborazione riparte con
+la prima regola del programma.
+Se l'istruzione @code{nextfile} raggiunge la fine dei file in input,
+vengono eseguite le eventuali regole @code{END} presenti.
+Un'eccezione a questo si ha se @code{nextfile} @`e invocata durante
+l'esecuzione di qualche istruzione all'interno di una regola @code{END};
+in questo caso, il programma viene terminato immediatamente.
address@hidden/END}.
+
+L'istruzione @code{nextfile} @`e utile quando ci sono parecchi @value{DF} da
+elaborare, ma non @`e necessario elaborare ogni record in ogni file.
+Senza @code{nextfile},
+per passare al successivo @value{DF}, un programma
+dovrebbe continuare a leggere i record che non gli servono. L'istruzione
address@hidden @`e una maniera molto address@hidden efficiente per ottenere lo
stesso
+risultato.
+
+In @command{gawk}, l'esecuzione di @code{nextfile} produce ulteriori effetti:
+le eventuali regole @code{ENDFILE}
+sono eseguite se @command{gawk} non
+si trova correntemente all'interno di una regola @code{END} o
address@hidden; @code{ARGIND} @`e
+incrementato e le eventuali regole @code{BEGINFILE} sono eseguite.
+(@code{ARGIND} non @`e stato ancora trattato.
address@hidden predefinite}.)
+
+In @command{gawk}, @code{nextfile} @`e utile all'interno di una regola
address@hidden per evitare di elaborare un file che altrimenti causerebbe
+un errore fatale in @command{gawk}.
+In questo caso, le regole @code{ENDFILE} non vengono eseguite.
address@hidden/ENDFILE}.
+
+Sebbene possa sembrare che @samp{close(FILENAME)} ottenga lo stesso
+risultato di @code{nextfile}, non @`e address@hidden@dotless{i}}.
@code{close()}
address@hidden essere usato solo per chiudere file, @dfn{pipe} e coprocessi che
siano
+stati aperti tramite ridirezioni. Non ha niente a che vedere con
+l'elaborazione principale che
address@hidden fa dei file elencati in @code{ARGV}.
+
address@hidden NOTA
+Per molti anni, @code{nextfile} @`e stata
+un'estensione comune. A settembre 2012 si @`e deciso di
+includerla nello standard POSIX.
+Si veda @uref{http://austingroupbugs.net/view.php?id=607, il sito web
dell'Austin Group}.
address@hidden quotation
+
address@hidden funzioni definite dall'utente, istruzioni
@code{next}/@code{nextfile} e
address@hidden @code{nextfile}, in funzioni definite dall'utente
address@hidden Brian Kernighan, @command{awk} di
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
+Le versioni correnti di BWK @command{awk} e @command{mawk}
+entrambe prevedono @code{nextfile}. Tuttavia, non sono consentite istruzioni
address@hidden all'interno del corpo delle funzioni
+(@pxref{Funzioni definite dall'utente}).
address@hidden lo permette; una @code{nextfile} all'interno del corpo di una
+funzione legge il primo record del file
+successivo e inizia l'elaborazione dello stesso
+a partire dalla prima regola del programma, esattamente come farebbe
+qualsiasi altra istruzione @code{nextfile}.
+
address@hidden Istruzione exit
address@hidden L'istruzione @code{exit}
+
address@hidden @code{exit}, istruzione
address@hidden istruzione @code{exit}
+L'istruzione @code{exit} fa address@hidden@dotless{i}} che @command{awk}
termini immediatamente
+l'esecuzione della regola corrente e che termini di elaborare l'input;
+qualsiasi input ancora da elaborare @`e ignorato. L'istruzione @code{exit} @`e
+scritta come segue:
+
address@hidden
address@hidden address@hidden di ritorno}]
address@hidden display
+
address@hidden @code{BEGIN}, criterio di ricerca, istruzione @code{exit} e
address@hidden criterio di ricerca @code{BEGIN}, istruzione @code{exit} e
address@hidden @code{END}, criterio di ricerca, istruzione @code{exit} e
address@hidden criterio di ricerca @code{END}, istruzione @code{exit} e
+Quando un'istruzione @code{exit} @`e eseguita all'interno di una regola
@code{BEGIN},
+il programma termina completamente l'elaborazione. Nessun record in input
+viene letto. Tuttavia, se una regola @code{END} @`e presente, come parte
+dell'esecuzione dell'istruzione @code{exit},
+la regola @code{END} viene eseguita
+(@pxref{BEGIN/END}).
+Se @code{exit} @`e usata nel corpo di una regola @code{END},
+il programma termina immediatamente.
+
+Un'istruzione @code{exit} che non fa parte di una regola @code{BEGIN} o
@code{END}
+termina l'esecuzione di qualsiasi ulteriore regola applicabile al record
+corrente, salta la lettura di qualsiasi record in input, ed esegue
+le eventuali regole @code{END}. @command{gawk} salta anche le eventuali regole
address@hidden, che non vengono eseguite.
+
+In questo caso,
+se non si desidera che la regola @code{END} venga eseguita, si deve impostare
+una variabile a un valore diverso da zero, prima di invocare l'istruzione
address@hidden e controllarne il valore nella regola @code{END}.
address@hidden assert}
+per un esempio di questo tipo.
+
address@hidden angolo buio, istruzione @code{exit}
+Se si specifica un argomento all'istruzione @code{exit}, il suo valore @`e
+usato come codice di ritorno finale dell'elaborazione @command{awk}. Se non
+viene specificato alcun argomento,
address@hidden fa terminare @command{awk} con un codice di ritorno di
+``successo''.
+Nel caso in cui un argomento
+sia specificato in una prima istruzione @code{exit} e poi @code{exit} sia
+chiamato una seconda volta all'interno di una regola @code{END} senza alcun
+argomento, @command{awk} usa il valore di ritorno specificato in precedenza.
address@hidden
address@hidden di ritorno} per maggiori informazioni.
+
address@hidden convenzioni di programmazione, istruzione @code{exit}
+Per esempio, si supponga che si sia verificata una condizione di errore
+difficile o impossibile da gestire. Convenzionalmente, i programmi la
+segnalano terminando con un codice di ritorno diverso da zero. Un programma
address@hidden address@hidden farlo usando un'istruzione @code{exit} con un
argomento
+diverso da zero, come mostrato nell'esempio seguente:
+
address@hidden
+BEGIN @{
+ if (("date" | getline data_corrente) <= 0) @{
+ print "Non riesco a ottenere la data dal sistema" > "/dev/stderr"
+ exit 1
+ @}
+ print "la data corrente @`e", data_corrente
+ close("date")
address@hidden
address@hidden example
+
address@hidden NOTA
+Per una completa address@hidden, i codici di ritorno dovrebbero essere compresi
+tra zero e 126, estremi compresi.
+Valori negativi e valori maggiori o uguali a 127, possono non generare
+risultati coerenti tra loro in sistemi operativi diversi.
address@hidden quotation
+
+
address@hidden Variabili predefinite
address@hidden Variabili predefinite
address@hidden predefinite, variabili
address@hidden variabili predefinite
+
+La maggior parte delle variabili @command{awk} sono disponibili per essere
+usate dall'utente secondo le proprie esigenze;
+queste variabili non cambiano mai di valore a meno che il
+programma non assegni loro dei valori, e non hanno alcuna influenza sul
+programma a meno che non si decida di utilizzarle nel programma.
+Tuttavia, alcune variabili in @command{awk} hanno dei significati speciali
+predefiniti.
address@hidden tiene conto di alcune di queste automaticamente, in modo da
+rendere possibile la richiesta ad @command{awk} di fare certe cose nella
+maniera desiderata. Altre variabili sono impostate automaticamente da
address@hidden, in modo da poter comunicare al programma in esecuzione
+informazioni sul modo di procedere interno di @command{awk}.
+
address@hidden @command{gawk}, variabili predefinite e
+Questa @value{SECTION} documenta tutte le variabili predefinite di
address@hidden; molte di queste variabili sono anche documentate nei
address@hidden che descrivono le loro aree di influenza.
+
address@hidden
+* Variabili modificabili dall'utente:: Variabili predefinite modificabili per
+ controllare @command{awk}.
+* Variabili auto-assegnate:: Variabili predefinite con cui
+ @command{awk} fornisce informazioni.
+* ARGC e ARGV:: Modi di usare @code{ARGC} e @code{ARGV}.
address@hidden menu
+
address@hidden Variabili modificabili dall'utente
address@hidden Variabili predefinite modificabili per controllare @command{awk}
address@hidden variabili predefinite, modificabili dall'utente
address@hidden modificabili dall'utente, variabili
+
+La seguente @`e una lista alfabetica di variabili che @`e possibile modificare
per
+controllare come @command{awk} gestisce alcuni compiti.
+
+Le variabili che sono specifiche di @command{gawk} sono contrassegnate da un
+cancelletto (@samp{#}). Queste variabili sono estensioni @command{gawk}.
+In altre implementazioni di @command{awk}, o se @command{gawk} @`e eseguito in
address@hidden compatibile
+(@pxref{Opzioni}), non hanno un significato speciale. (Eventuali eccezioni
+sono menzionate nella descrizione di ogni variabile.)
+
address@hidden @code
address@hidden @code{BINMODE}, variabile
address@hidden variabile @code{BINMODE}
address@hidden binario, input/output
address@hidden input/output binario
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{BINMODE}
address@hidden BINMODE #
+Su sistemi non-POSIX, questa variabile specifica l'uso della address@hidden
binaria
+per tutto l'I/O. I valori numerici di uno, due o tre specificano che i file
+in input, i file di output o tutti i file, rispettivamente, devono usare I/O
+binario.
+Un valore numerico inferiore a zero @`e trattato come zero e un valore
+numerico maggiore di tre @`e trattato
+come tre. Alternativamente, le stringhe @code{"r"} o @code{"w"} specificano
+che i file in input e i file in output,
+rispettivamente, devono usare
+I/O binario. Una stringa @code{"rw"} o @code{"wr"} indica che tutti i file
+devono usare I/O binario. Ogni altro valore di stringa @`e trattato come
address@hidden"rw"}, ma @command{gawk} genera un messaggio di avvertimento.
address@hidden @`e descritto in maggior
+dettaglio in @ref{Uso su PC}. @command{mawk} (@pxref{Altre versioni})
+prevede questa variabile, ma consente solo valori numerici.
+
address@hidden @code{CONVFMT}, variabile
address@hidden variabile @code{CONVFMT}
address@hidden POSIX @command{awk}, variabile @code{CONVFMT} e
address@hidden numeri, conversione in stringhe
address@hidden stringhe, conversione in numeri
address@hidden @code{CONVFMT}
+Una stringa che controlla la conversione di numeri in
+stringhe (@pxref{Conversione}).
+In effetti @`e la stringa passata come primo argomento alla funzione
address@hidden()}
+(@pxref{Funzioni per stringhe}).
+Il suo valore di default @`e @code{"%.6g"}.
address@hidden @`e stata introdotta dallo standard POSIX.
+
address@hidden @command{gawk}, variabile @code{FIELDWIDTHS} in
address@hidden @code{FIELDWIDTHS}, variabile
address@hidden variabile @code{FIELDWIDTHS}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{FIELDWIDTHS}
address@hidden separatori di campo, variabile @code{FIELDWIDTHS} e
address@hidden campo, separatori di, variabile @code{FIELDWIDTHS} e
address@hidden FIELDWIDTHS #
+Una lista di posizioni di colonna, separate da spazi, per dire a
address@hidden
+come dividere campi in input posti su colonne fisse.
+Assegnando un valore a @code{FIELDWIDTHS}, le variabili @code{FS} e
address@hidden
address@hidden vengono usate per effettuare la divisione in campi.
address@hidden costante} per maggiori informazioni.
+
address@hidden @command{gawk}, variabile @code{FPAT} in
address@hidden @code{FPAT}, variabile
address@hidden variabile @code{FPAT}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{FPAT}
address@hidden separatori di campo, variabile @code{FPAT} e
address@hidden campo, separatori di, variabile @code{FPAT} e
address@hidden FPAT #
+Un'espressione regolare (di tipo stringa) per dire a @command{gawk}
+di creare i campi utilizzando come delimitatore il testo che corrisponde
+all'espressione regolare.
+Assegnando un valore a @code{FPAT}
+le variabili @code{FS} e @code{FIELDWIDTHS}
address@hidden vengono usate per effettuare la divisione in campi.
address@hidden in base al contenuto} per maggiori informazioni.
+
address@hidden @code{FS}, variabile
address@hidden variabile @code{FS}
address@hidden campo, separatori di
address@hidden separatori di campo
address@hidden FS
+Il separatore dei campi in input (@pxref{Separatori di campo}).
+Il valore address@hidden essere una stringa di un solo carattere o
un'espressione
+regolare composta da address@hidden caratteri che individua il separatore tra
i campi
+dei record in input. Se il suo valore
address@hidden la stringa nulla (@code{""}),
+ogni singolo carattere del record costituisce un campo.
+(Questo comportamente @`e un'estensione @command{gawk}. POSIX @command{awk} non
+specifica il comportamento quando @code{FS} @`e la stringa nulla.
+Nonostante questo, alcune altre versioni di @command{awk} trattano @code{""}
+in modo speciale.)
+
address@hidden POSIX @command{awk}, variabile @code{FS} e
+Il valore di default @`e @address@hidden" "}}, una stringa consistente in un
singolo
+spazio. In via eccezionale, questo valore significa che qualsiasi sequenza
+di spazi, TAB, e/o ritorni a capo costituisce
+un solo separatore.
+Inoltre eventuali spazi, TAB e ritorni a capo all'inizio e alla fine
+del record in input vengono ignorati.
+
+Si address@hidden impostare il valore di @code{FS} sulla riga dei comandi
usando
+l'opzione @option{-F}:
+
address@hidden
+awk -F, '@var{programma}' @var{file-in-input}
address@hidden example
+
address@hidden @command{gawk}, separatori di campo e
+Se @command{gawk} sta usando @code{FIELDWIDTHS} o @code{FPAT}
+per separare i campi,
+assegnare un valore a @code{FS} fa address@hidden@dotless{i}} che
@command{gawk} torni alla
+separazione dei campi normale, fatta utilizzando la variabile @code{FS}.
+Un modo semplice per fare questo
address@hidden semplicemente quello di scrivere l'istruzione
address@hidden = FS}, aggiungendo magari un commento esplicativo.
+
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden @code{IGNORECASE}, variabile
address@hidden variabile @code{IGNORECASE}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{IGNORECASE}
address@hidden maiuscolo/minuscolo e confronti tra stringhe
address@hidden maiuscolo/minuscolo e @dfn{regexp}
address@hidden espressioni regolari, maiuscolo/minuscolo
address@hidden IGNORECASE #
+Se la variabile @code{IGNORECASE} @`e diversa da zero o dalla stringa nulla,
+tutti i confronti tra stringhe
+e tutti i confronti tra espressioni regolari sono insensibili
+alle differenze maiuscolo/minuscolo.
+Questo vale per il confronto tra @dfn{regexp}
+usando @samp{~} e @samp{!~}, per le funzioni @code{gensub()},
address@hidden()}, @code{index()}, @code{match()}, @code{patsplit()},
address@hidden()} e @code{sub()},
+per la determinazione della fine record con @code{RS} e per la divisione
+in campi con @code{FS} e @code{FPAT}.
+Tuttavia, il valore di @code{IGNORECASE} @emph{non} influenza gli indici
+dei vettori
+e non influenza la separazione dei campi qualora si usi un separatore di campo
+costituito da un unico carattere.
address@hidden
+
address@hidden @command{gawk}, variabile @code{LINT} in
address@hidden @code{LINT}, variabile
address@hidden variabile @code{LINT}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{LINT}
address@hidden @dfn{lint}, controlli
address@hidden controlli @dfn{lint}
address@hidden 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}
+(@pxref{Opzioni}).
+Con un valore di @code{"fatal"}, gli avvertimenti di @dfn{lint} generano un
errore
+fatale.
+Con un valore di @code{"invalid"}, sono inviati solo gli avvertimenti
+per cose che sono effettivamente non valide. (Questa parte non funziona
+ancora perfettamente.)
+Ogni altro valore @dfn{vero} stampa avvertimenti non fatali.
+Se @code{LINT} ha per valore @dfn{falso} nessun avvertimento @dfn{lint} viene
+stampato.
+
+Questa variabile @`e un'estensione @command{gawk}. Non ha un valore speciale
+per altre implementazioni di @command{awk}. A differenza di altre variabili
+speciali, modificare il valore di @code{LINT} altera la produzione di
+avvertimenti @dfn{lint} anche se @command{gawk} @`e in address@hidden
compatibile.
+Analogamente a come le opzioni
address@hidden e @option{--traditional} controllano in maniera indipendente
+diversi aspetti del comportamente di @command{gawk}, il controllo
+degli avvertimenti di @dfn{lint} durante l'esecuzione del programma @`e
indipendente
+dall'implementazione @command{awk} in esecuzione.
+
address@hidden @code{OFMT}, variabile
address@hidden variabile @code{OFMT}
address@hidden numeri, conversione in stringhe
address@hidden stringhe, conversione in numeri
address@hidden OFMT
address@hidden questa la stringa che controlla la conversione di numeri in
+stringhe (@pxref{Conversione}) quando li
+si stampa con l'istruzione
address@hidden Funziona passandola
+ come primo argomento alla funzione @code{sprintf()}
+(@pxref{Funzioni per stringhe}).
+Il suo valore di default @`e @code{"%.6g"}. Le prime versioni di @command{awk}
+usavano @code{OFMT} per specificare il formato da usare per convertire
+numeri in stringhe in espressioni generali; questo compito @`e ora svolto
+da @code{CONVFMT}.
+
address@hidden @code{sprintf()}, funzione, variabile @code{OFMT} e
address@hidden funzione @code{sprintf()}, variabile @code{OFMT} e
address@hidden @code{print}, istruzione, variabile @code{OFMT} e
address@hidden istruzione @code{print}, variabile @code{OFMT} e
address@hidden variabile @code{OFS}
address@hidden @code{OFS}, variabile
address@hidden campo, separatori di
address@hidden separatori di campo
address@hidden OFS
address@hidden il separatore dei campi in output (@pxref{Separatori di
output}). @`E address@hidden
+che viene stampato in output per separare i campi stampati da un'istruzione
@code{print}.
+Il suo valore di default @`e @address@hidden" "}}, una stringa costituita da
un solo
+spazio.
+
address@hidden @code{ORS}, variabile
address@hidden variabile @code{ORS}
address@hidden ORS
+Il separatore dei record in output. Viene stampato alla fine di ogni
+istruzione @code{print}. Il suo valore di default @`e @code{"\n"},
+il carattere di ritorno a capo.
+(@xref{Separatori di output}.)
+
address@hidden @code{PREC}, variabile
address@hidden variabile @code{PREC}
address@hidden PREC #
+La precisione disponibile nei numeri a virgola mobile a precisione arbitraria,
+per default 53 bit (@pxref{Impostare la precisione}).
+
address@hidden @code{ROUNDMODE}, variabile
address@hidden variabile @code{ROUNDMODE}
address@hidden ROUNDMODE #
+La address@hidden di arrotondamento da usare per operazioni aritmetiche a
precisione
+arbitraria svolte sui numeri, per default @code{"N"}
+(@code{roundTiesToEven} nello standard
+IEEE 754; @pxref{Impostare modi di arrotondare}).
+
address@hidden @code{RS}, variabile
address@hidden variabile @code{RS}
address@hidden separatori di record
address@hidden record, separatori di
address@hidden @code{RS}
+Il separatore tra record in input. Il suo valore di default @`e una stringa
+contenente il solo carattere di ritorno a capo, il che significa che un record
in input
+consiste di una sola riga di testo.
+Il suo valore address@hidden essere anche la stringa nulla, nel qual caso i
record sono
+separati da una o address@hidden righe vuote.
+Se invece @`e una @dfn{regexp}, i record sono separati da
+corrispondenze alla @dfn{regexp} nel testo in input.
+(@xref{Record}.)
+
+La address@hidden che @code{RS} sia un'espressione regolare
address@hidden un'estensione @command{gawk}.
+In molte altre implementazioni @command{awk}, oppure
+se @command{gawk} @`e in address@hidden compatibile
+(@pxref{Opzioni}),
address@hidden usato solo il primo carattere del valore di @code{RS}.
+
address@hidden @code{SUBSEP}, variabile
address@hidden variabile @code{SUBSEP}
address@hidden separatori di indici
address@hidden indici, separatori di
address@hidden @code{SUBSEP}
+Il separatore di indici. Ha il valore di default di
address@hidden"\034"} ed @`e usato per separare le parti di cui sono composti
gli indici
+di un vettore multidimensionale. Quindi, l'espressione
address@hidden@w{pippo["A", "B"]}}
+in address@hidden accede a @code{pippo["A\034B"]}
+(@pxref{Vettori multidimensionali}).
+
address@hidden @command{gawk}, variabile @code{TEXTDOMAIN} in
address@hidden @code{TEXTDOMAIN}, variabile
address@hidden variabile @code{TEXTDOMAIN}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{TEXTDOMAIN}
address@hidden internazionalizzazione, localizzazione
address@hidden TEXTDOMAIN #
+Usata per l'internazionalizzazione di programmi a livello di
address@hidden Imposta il dominio di testo (@dfn{text domain}) di default per
costanti stringa
+marcate in maniera speciale nel codice sorgente, e anche per le funzioni
address@hidden()}, @code{dcngettext()} e @code{bindtextdomain()}
address@hidden
+(@pxrefil{Internazionalizzazione}).
address@hidden iftex
address@hidden
+(@pxref{Internazionalizzazione}).
address@hidden ifnottex
+Il valore di default di @code{TEXTDOMAIN} @`e @code{"messages"}.
address@hidden table
+
address@hidden Variabili auto-assegnate
address@hidden Variabili predefinite con cui @command{awk} fornisce informazioni
+
address@hidden predefinite, variabili, che forniscono informazioni
address@hidden variabili predefinite, che forniscono informazioni
+Quella che segue @`e una lista in ordine alfabetico di variabili che
address@hidden imposta automaticamente in determinate situazioni per
+fornire informazioni a un programma.
+
+Le variabili specifiche di @command{gawk} sono contrassegnate da un
+cancelletto (@samp{#}). Queste variabili sono estensioni @command{gawk}.
+In altre implementazioni di @command{awk} o se @command{gawk} @`e in
address@hidden compatibile (@pxref{Opzioni}), non hanno un significato speciale:
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{ARGC}/@code{ARGV}, variabili
address@hidden argomenti, riga di comando
address@hidden riga di comando, argomenti
address@hidden @code{ARGC}, @code{ARGV}
+Gli argomenti della riga di comando disponibili ai programmi @command{awk}
+sono memorizzati in un vettore di nome
address@hidden @code{ARGC} @`e il numero di argomenti presenti sulla
+riga di comando.
address@hidden argomenti}.
+A differenza di quasi tutti i vettori di @command{awk},
address@hidden @`e indicizzato da 0 a @code{ARGC} @minus{} 1.
+Lo si address@hidden vedere nell'esempio seguente:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{for (i = 0; i < ARGC; i++)}
+> @kbd{print ARGV[i]}
+> @address@hidden' inventory-shipped mail-list}
address@hidden awk
address@hidden inventory-shipped
address@hidden mail-list
address@hidden example
+
address@hidden
address@hidden contiene @samp{awk}, @code{ARGV[1]}
+contiene @samp{inventory-shipped} e @code{ARGV[2]} contiene
address@hidden Il valore di @code{ARGC} @`e tre, ossia uno in address@hidden
+dell'indice dell'ultimo elemento di @code{ARGV}, perch@'e gli elementi sono
+numerati a partire da zero.
+
address@hidden convenzioni di programmazione, variabili @code{ARGC}/@code{ARGV}
+I nomi @code{ARGC} e @code{ARGV}, come pure la convenzione di indicizzare
+il vettore da 0 a @code{ARGC} @minus{} 1, derivano dal modo in cui il
+linguaggio C accede agli argomenti presenti sulla riga di comando.
+
address@hidden angolo buio, valore di @code{ARGV[0]}
+Il valore di @code{ARGV[0]} address@hidden variare da sistema a sistema.
+Va anche notato che il programma @emph{non}
address@hidden incluso in @code{ARGV}, e non sono incluse neppure le eventuali
opzioni di
address@hidden specificate sulla riga di comando.
address@hidden e ARGV} per informazioni
+su come @command{awk} usa queste variabili.
address@hidden
+
address@hidden @code{ARGIND}, variabile
address@hidden variabile @code{ARGIND}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{ARGIND}
address@hidden @code{ARGIND #}
+L'indice in @code{ARGV} del file correntemente in elaborazione.
+Ogni volta che @command{gawk} apre un nuovo @value{DF} per elaborarlo, imposta
address@hidden all'indice in @code{ARGV} del @value{FN}.
+Quando @command{gawk} sta elaborando i file in input, il confronto
address@hidden == ARGV[ARGIND]} @`e sempre verificato.
+
address@hidden file, address@hidden variabile @code{ARGIND} e
+Questa variabile @`e utile nell'elaborazione dei file; consente di stabilire
+a che punto ci si trova nella lista
+di @value{DF}, e anche di distinguere tra successive occorrenze dello stesso
address@hidden sulla riga dei comandi.
+
address@hidden nomi di file, distinguere
+Anche se @`e possibile modificare il valore di @code{ARGIND} all'interno del
+programma @command{awk}, @command{gawk} automaticamente lo imposta a un nuovo
+valore quando viene aperto il file successivo.
+
address@hidden @code{ENVIRON}, vettore
address@hidden vettore @code{ENVIRON}
address@hidden variabili d'ambiente, nel vettore @code{ENVIRON}
address@hidden @code{ENVIRON}
+Un vettore associativo contenente i valori delle variabili d'ambiente.
+Gli indici del vettore sono i nomi delle variabili d'ambiente; gli elementi
+sono i valori della specifica variabile d'ambiente. Per esempio,
address@hidden"HOME"]} potrebbe valere @code{/home/arnold}.
+
+Per POSIX @command{awk}, le modifiche a questo vettore non cambiano
+le variabili d'ambiente passate a qualsivoglia programma che @command{awk}
address@hidden richiamare tramite una ridirezione
+o usando la funzione @code{system()}.
+
+Tuttavia, a partire dalla @value{PVERSION} 4.2, se non si @`e in
address@hidden compatibile POSIX, @command{gawk} aggiorna le proprie variabili
+d'ambiente, quando si modifica @code{ENVIRON}, e in questo modo sono
+modificate anche le variabili d'ambiente disponibili ai programmi richiamati.
+Un'attenzione speciale dovrebbe essere prestata alla modifica di
address@hidden"PATH"]}, che @`e il percorso di ricerca usato per trovare
+i programmi eseguibili.
+
+Queste modifiche possono anche influire sul programma @command{gawk}, poich@'e
+alcune funzioni predefinite possono tener conto di certe
+variabili d'ambiente.
+L'esempio address@hidden notevole di una tale situazione @`e @code{mktime()}
+(@pxref{Funzioni di tempo})
+che, in molti sistemi, tiene conto del valore della
+variabile d'ambiente @env{TZ}.
+
+Alcuni sistemi operativi possono non avere variabili d'ambiente.
+In tali sistemi, il vettore @code{ENVIRON} @`e vuoto (tranne che per
+le variabili
address@hidden@code{ENVIRON["AWKPATH"]}} e
address@hidden@code{ENVIRON["AWKLIBPATH"]}} eventualmente presenti;
address@hidden (Variabile)} e
address@hidden
address@hidden (Variabile)}).
address@hidden ifdocbook
address@hidden
address@hidden (Variabile)}).
address@hidden ifnotdocbook
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile
address@hidden variabile @code{ERRNO}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{ERRNO}
address@hidden gestione errori, variabile @code{ERRNO} e
address@hidden @code{ERRNO #}
+Se si verifica un errore di sistema durante una ridirezione per @code{getline},
+durante una lettura per @code{getline} o durante un'operazione di
address@hidden()}, la variabile
address@hidden contiene una stringa che descrive l'errore.
+
+Inoltre, @command{gawk} annulla @code{ERRNO} prima di aprire ogni
+file in input presente sulla riga di comando. Questo consente di controllare
+se il file @`e accessibile
+all'interno di un criterio di ricerca @code{BEGINFILE}
+(@pxref{BEGINFILE/ENDFILE}).
+
+Per il resto, @code{ERRNO} si comporta analogamente alla variabile C
address@hidden
+Tranne nel caso sopra accennato, @command{gawk} non annulla @emph{mai}
address@hidden (lo imposta a zero o a @code{""}). Quindi, ci si deve
+aspettare che il suo valore sia significativo solo quando un'operazione
+di I/O restituisce un valore che indica il fallimento dell'operazione, come
+per esempio quando @code{getline} restituisce @minus{}1. Si @`e, naturalmente,
+liberi di annullarla prima di effettuare un'operazione di I/O.
+
+Se il valore di @code{ERRNO} corrisponde a un errore di sistema della
+variabile C @code{errno}, @code{PROCINFO["errno"]} address@hidden impostato al
valore
+di @code{errno}. Per errori non di sistema, @code{PROCINFO["errno"]}
address@hidden
+impostata al valore zero.
+
address@hidden @code{FILENAME}, variabile
address@hidden variabile @code{FILENAME}
address@hidden angolo buio, variabile @code{FILENAME}
address@hidden @code{FILENAME}
+Il nome del file in input corrente. Quando non ci sono @value{DF}
+sulla riga dei comandi, @command{awk} legge dallo standard input e
address@hidden @`e impostato a @code{"-"}. @code{FILENAME} cambia ogni
+volta che si legge un nuovo file
address@hidden
+(@pxrefil{Leggere file}).
address@hidden iftex
address@hidden
+(@pxref{Leggere file}).
address@hidden ifnottex
+All'interno di una
+regola @code{BEGIN}, il valore di @code{FILENAME} @`e @code{""}, perch@'e non
si
+sta elaborando alcun file in address@hidden tra le prime implementazioni di
Unix
address@hidden inizializzavano @code{FILENAME} a @code{"-"}, anche se
+vi erano @value{DF} da elaborare. Un tale comportamento era incorretto e
+non ci si dovrebbe poter contare nei programmi.}
address@hidden Si noti, tuttavia,
+che l'uso di @code{getline} (@pxref{Getline}) all'interno di una regola
address@hidden address@hidden implicare l'assegnamento di un valore a
@code{FILENAME}.
+
address@hidden @code{FNR}, variabile
address@hidden variabile @code{FNR}
address@hidden @code{FNR}
+Il numero del record corrente nel file corrente. @command{awk} incrementa
address@hidden ogni volta che legge un nuovo record (@pxref{Record}).
address@hidden imposta nuovamente a zero @code{FNR} ogni volta che inizia a
+leggere un nuovo file in input.
+
address@hidden @code{NF}, variabile
address@hidden variabile @code{NF}
address@hidden @code{NF}
+Il numero di campi nel corrente record in input.
address@hidden @`e impostato ogni volta che si legge un nuovo record,
+quando un nuovo campo viene creato,
+o quando si modifica @code{$0} (@pxref{Campi}).
+
+A differenza di molte altre variabili descritte in questa @value{SUBSECTION},
+l'assegnamento di un valore a @code{NF} address@hidden potenzialmente
influenzare
+il funzionamento interno di @command{awk}. In particolare, assegnamenti
+a @code{NF} si possono usare per aggiungere o togliere campi dal
+record corrente. @xref{Cambiare i campi}.
+
address@hidden @code{FUNCTAB}, vettore
address@hidden vettore @code{FUNCTAB}
address@hidden @command{gawk}, vettore @code{FUNCTAB} in
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{FUNCTAB}
address@hidden @code{FUNCTAB #}
+Un vettore i cui indici e i corrispondenti valori sono i nomi di tutte le
+funzioni predefinite, definite dall'utente ed estese, presenti nel programma.
+
address@hidden NOTA
+Il tentativo di usare l'istruzione @code{delete} per eliminare il vettore
address@hidden genera un errore fatale. Genera un errore fatale anche
+ogni tentativo di impostare un elemento di @code{FUNCTAB}.
address@hidden quotation
+
address@hidden @code{NR}, variabile
address@hidden variabile @code{NR}
address@hidden @code{NR}
+Il numero di record in input che @command{awk} ha elaborato dall'inizio
+dell'esecuzione del programma
+(@pxref{Record}).
address@hidden incrementa @code{NR} ogni volta che legge un nuovo record.
+
address@hidden @command{gawk}, vettore @code{PROCINFO} in
address@hidden @code{PROCINFO}, vettore
address@hidden vettore @code{PROCINFO}
address@hidden differenze tra @command{awk} e @command{gawk}, vettore
@code{PROCINFO}
address@hidden @code{PROCINFO #}
+Gli elementi di questo vettore danno accesso a informazioni sul
+programma @command{awk} in esecuzione.
+I seguenti elementi (elencati in ordine alfabetico)
+sono sicuramente sempre disponibili:
+
address@hidden @code
address@hidden effettivo, @dfn{ID di gruppo} dell'utente di @command{gawk}
address@hidden PROCINFO["egid"]
+Il valore restituito dalla chiamata di sistema @code{getegid()}.
+
address@hidden PROCINFO["errno"]
+Il valore della variabile C @code{ERRNO} quando @code{ERRNO} @`e impostato
+al messaggio di errore a essa associato.
+
address@hidden PROCINFO["euid"]
address@hidden @dfn{ID effettivo} dell'utente di @command{gawk}
+Il valore restituito dalla chiamata di sistema @code{geteuid()}.
+
address@hidden PROCINFO["FS"]
+Questo elemento vale
address@hidden"FS"} se @`e in uso la separazione in campi con @code{FS},
address@hidden"FIELDWIDTHS"} se @`e in uso quella con @code{FIELDWIDTHS},
+oppure @code{"FPAT"} se @`e in uso l'individuazione di campo con @code{FPAT}.
+
address@hidden PROCINFO["gid"]
address@hidden @dfn{ID di gruppo} dell'utente @command{gawk}
+Il valore restituito dalla chiamata di sistema @code{getgid()} .
+
address@hidden PROCINFO["identifiers"]
address@hidden programma, identificativi in un
address@hidden identificativi in un programma
+Un sottovettore, indicizzato dai nomi di tutti gli identificativi usati
+all'interno del programma @command{awk}. Un @dfn{identificativo} @`e
+semplicemente il nome di una variabile
+(scalare o vettoriale), una funzione predefinita, una funzione definita
+dall'utente, o una funzione contenuta in un'estensione.
+Per ogni identificativo, il valore dell'elemento @`e uno dei seguenti:
+
address@hidden @code
address@hidden "array"
+L'identificativo @`e un vettore.
+
address@hidden "builtin"
+L'identificativo @`e una funzione predefinita.
+
address@hidden "extension"
+L'identificativo @`e una funzione in un'estensione caricata tramite
address@hidden@@load} o con l'opzione @option{-l}.
+
address@hidden "scalar"
+L'identificativo @`e uno scalare.
+
address@hidden "untyped"
+L'identificativo non ha ancora un tipo (potrebbe essere usato come scalare o
+come vettore; @command{gawk} non @`e ancora in grado di dirlo).
+
address@hidden "user"
+L'identificativo @`e una funzione definita dall'utente.
address@hidden table
+
address@hidden
+I valori riportano address@hidden che @command{gawk} sa sugli identificativi
+dopo aver finito l'analisi iniziale del programma; questi valori @emph{non}
+vengono address@hidden aggiornati durante l'esecuzione del programma.
+
address@hidden PROCINFO["pgrpid"]
address@hidden @dfn{process group ID} del programma @command{gawk}
+Il @dfn{ID di gruppo del processo} del programma corrente.
+
address@hidden PROCINFO["pid"]
address@hidden @dfn{process ID} del programma @command{gawk}
+Il @dfn{process ID} del programma corrente.
+
address@hidden PROCINFO["ppid"]
address@hidden @dfn{parent process ID} del programma @command{gawk}
+Il @dfn{ID di processo del padre} del programma corrente.
+
address@hidden PROCINFO["strftime"]
+La stringa col formato di default usato per la funzione @code{strftime()}.
+Assegnando un nuovo valore a questo elemento si cambia quello di default.
address@hidden di tempo}.
+
address@hidden PROCINFO["uid"]
+Il valore restituito dalla chiamata di sistema @code{getuid()}.
+
address@hidden PROCINFO["version"]
address@hidden versione di @command{gawk}
address@hidden @command{gawk}, versione di
+La versione di @command{gawk}.
address@hidden table
+
+I seguenti elementi addizionali del vettore
+sono disponibili per fornire informazioni sulle librerie MPFR e GMP,
+se la versione in uso di @command{gawk} consente il calcolo con precisione
+arbitraria
+(@pxref{Calcolo con precisione arbitraria}):
+
address@hidden @code
address@hidden PROCINFO["gmp_version"]
address@hidden versione della libreria GNU MP
+La versione della libreria GNU MP.
+
address@hidden versione della libreria GNU MPFR
address@hidden PROCINFO["mpfr_version"]
+La versione della libreria GNU MPFR.
+
address@hidden PROCINFO["prec_max"]
address@hidden precisione massima consentita dalla libreria MPFR
+La massima precisione consentita da MPFR.
+
address@hidden PROCINFO["prec_min"]
address@hidden precisione minima richiesta dalla libreria MPFR
+La precisione minima richiesta da MPFR.
address@hidden table
+
+I seguenti elementi addizionali del vettore
+sono disponibili per fornire
+informazioni sulla versione dell'estensione API, se la versione
+di @command{gawk} prevede il caricamento dinamico di funzioni di estensione
address@hidden
+(@pxrefil{Estensioni dinamiche}):
address@hidden iftex
address@hidden
+(@pxref{Estensioni dinamiche}):
address@hidden ifnottex
+
address@hidden @code
address@hidden PROCINFO["api_major"]
address@hidden versione dell'estensione API @command{gawk}
address@hidden estensione API, numero di versione
+La versione principale dell'estensione API.
+
address@hidden PROCINFO["api_minor"]
+La versione secondaria dell'estensione API.
address@hidden table
+
address@hidden gruppi supplementari Unix con @command{gawk}
+Su alcuni sistemi, ci possono essere elementi nel vettore, da @code{"group1"}
+fino a @code{"address@hidden"}. @var{N} @`e il numero di
+gruppi supplementari che il processo [Unix] possiede. Si usi l'operatore
address@hidden per verificare la presenza di questi elementi
+(@pxref{Visitare elementi}).
+
+I seguenti elementi consentono di modificare il comportamento di
address@hidden:
+
address@hidden PROCINFO["NONFATAL"]
+Se questo elemento esiste, gli errori di I/O per tutte le ridirezioni
+consentono la prosecuzizone del programma.
address@hidden dopo errori}.
+
address@hidden PROCINFO["@var{nome_output}", "NONFATAL"]
+Gli errori in output per il file @var{nome_output}
+consentono la prosecuzizone del programma.
address@hidden dopo errori}.
+
address@hidden @code
address@hidden PROCINFO["@var{comando}", "pty"]
+Per una comunicazione bidirezionale con @var{comando}, si usi una pseudo-tty
+invece di impostare una @dfn{pipe} bidirezionale.
address@hidden/O bidirezionale} per ulteriori informazioni.
+
address@hidden PROCINFO["@var{input_name}", "READ_TIMEOUT"]
+Imposta un tempo limite per leggere dalla ridirezione di input
@var{input_name}.
address@hidden in lettura} per ulteriori informazioni.
+
address@hidden PROCINFO["sorted_in"]
+Se questo elemento esiste in @code{PROCINFO}, il suo valore controlla
+l'ordine in cui gli indici dei vettori saranno elaborati nei cicli
address@hidden (@var{indice} in @var{vettore})}.
+Questa @`e una address@hidden avanzata, la cui descrizione completa
address@hidden vista
address@hidden avanti; si veda
address@hidden un intero vettore}.
address@hidden table
+
address@hidden @code{RLENGTH}, variabile
address@hidden variabile @code{RLENGTH}
address@hidden @code{RLENGTH}
+La lunghezza della sottostringa individuata dalla funzione
address@hidden()}
+(@pxref{Funzioni per stringhe}).
address@hidden viene impostata quando si richiama la funzione @code{match()}.
+Il suo
+valore @`e la lunghezza della stringa individuata, oppure @minus{}1 se non @`e
+stata trovata alcuna corrispondenza.
+
address@hidden @code{RSTART}, variabile
address@hidden variabile @code{RSTART}
address@hidden @code{RSTART}
+L'indice, in caratteri, da cui parte la sottostringa che @`e individuata dalla
+funzione @code{match()}
+(@pxref{Funzioni per stringhe}).
address@hidden viene impostata quando si richiama la funzione @code{match()}.
+Il suo
+valore @`e la posizione nella stringa da cui inizia la sottostringa
+individuata, oppure zero, se non @`e stata trovata alcuna corrispondenza.
+
address@hidden @command{gawk}, variabile @code{RT} in
address@hidden @code{RT}, variabile
address@hidden variabile @code{RT}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{RT}
address@hidden @code{RT #}
+Il testo in input che corrisponde al testo individuato da @code{RS},
+il separatore di record. Questa variabile viene impostata dopo aver letto
+ciascun record.
+
address@hidden @command{gawk}, vettore @code{SYMTAB} in
address@hidden @code{SYMTAB}, vettore
address@hidden vettore @code{SYMTAB}
address@hidden differenze tra @command{awk} e @command{gawk}, vettore
@code{SYMTAB}
address@hidden @code{SYMTAB #}
+Un vettore i cui indici sono i nomi di tutte le variabili globali e i vettori
+definiti nel programma. @code{SYMTAB} rende visibile al
+programmatore @command{awk} la tabella dei simboli di @command{gawk}.
+Viene preparata nella fase di analisi iniziale del programma @command{gawk}
+ed @`e completata prima di cominciare a eseguire il programma.
+
+Il vettore address@hidden essere usato per accedere indirettamente, in lettura
o in
+scrittura, al valore di una variabile:
+
address@hidden
+pippo = 5
+SYMTAB["pippo"] = 4
+print pippo # stampa 4
address@hidden example
+
address@hidden
+La funzione @code{isarray()} (@pxref{Funzioni per i tipi}) si address@hidden
usare per
+controllare se un elemento in @code{SYMTAB} @`e un vettore.
+Inoltre, non @`e possibile usare l'istruzione @code{delete} con il vettore
address@hidden
+
address@hidden possibile aggiungere a @code{SYMTAB} un elemento che non sia un
+identificativo address@hidden esistente:
+
address@hidden
+SYMTAB["xxx"] = 5
+print SYMTAB["xxx"]
address@hidden example
+
address@hidden
+Il risultato @`e quello previsto: in questo caso @code{SYMTAB} si comporta
+come un normale vettore. La sola differenza @`e che non @`e poi possibile
+cancellare @code{SYMTAB["xxx"]}.
+
address@hidden Schorr, Andrew
+Il vettore @code{SYMTAB} @`e address@hidden interessante di quel che sembra.
Andrew
+Schorr fa notare che effettivamente consente di ottenere dei puntatori ai dati
+in @command{awk}. Si consideri quest'esempio:
+
address@hidden
+# Moltiplicazione indiretta di una qualsiasi variabile per un
+# numero a piacere e restituzione del risultato
+
+function multiply(variabile, numero)
address@hidden
+ return SYMTAB[variabile] *= numero
address@hidden
address@hidden example
+
address@hidden
+Si potrebbe usare in questo modo:
+
address@hidden
+BEGIN @{
+ risposta = 10.5
+ multiply("risposta", 4)
+ print "La risposta @`e", risposta
address@hidden
address@hidden example
+
address@hidden
+Eseguendo, il risultato @`e:
+
address@hidden
+$ @kbd{gawk -f risposta.awk}
address@hidden La risposta @`e 42
address@hidden example
+
address@hidden NOTA
+Per evitare seri paradossi temporali,
address@hidden non parlare dei grossi problemi di implementazione.}
+n@'e @code{FUNCTAB} n@'e @code{SYMTAB}
+sono disponibili come elementi all'interno del vettore @code{SYMTAB}.
address@hidden quotation
address@hidden table
+
address@hidden Modificare @code{NR} e @code{FNR}
address@hidden @code{NR}, variabile, modifica di
address@hidden variabile @code{NR}, modifica di
address@hidden @code{FNR}, variabile, modifica di
address@hidden variabile @code{FNR}, modifica di
address@hidden angolo buio, variabili @code{FNR}/@code{NR}
address@hidden incrementa le variabili @code{NR} e @code{FNR}
+ogni volta che legge un record, invece che impostarle al valore assoluto del
+numero di record letti. address@hidden significa che un programma
address@hidden
+modificare queste variabili e i valori address@hidden@dotless{i}} assegnati
sono incrementati per
+ogni record.
address@hidden
+Si consideri l'esempio seguente:
+
address@hidden
+$ @kbd{echo '1}
+> @kbd{2}
+> @kbd{3}
+> @kbd{4' | awk 'NR == 2 @{ NR = 17 @}}
+> @address@hidden print NR @}'}
address@hidden 1
address@hidden 17
address@hidden 18
address@hidden 19
address@hidden example
+
address@hidden
+Prima che @code{FNR} venisse aggiunto al linguaggio @command{awk}
+(@pxref{V7/SVR3.1}),
+molti programmi @command{awk} usavano questa address@hidden per
+contare il numero di record in un file impostando a zero @code{NR} al cambiare
+di @code{FILENAME}.
address@hidden sidebar
+
address@hidden ARGC e ARGV
address@hidden Usare @code{ARGC} e @code{ARGV}
address@hidden @code{ARGC}/@code{ARGV}, variabili, come usarle
address@hidden variabili @code{ARGC}/@code{ARGV}, come usarle
address@hidden argomenti, riga di comando
address@hidden riga di comando, argomenti
+
address@hidden
+La
address@hidden iftex
address@hidden auto-assegnate}
+conteneva il programma seguente che visualizzava le informazioni contenute
+in @code{ARGC} e @code{ARGV}:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{for (i = 0; i < ARGC; i++)}
+> @kbd{print ARGV[i]}
+> @address@hidden' inventory-shipped mail-list}
address@hidden awk
address@hidden inventory-shipped
address@hidden mail-list
address@hidden example
+
address@hidden
+In questo esempio, @code{ARGV[0]} contiene @samp{awk}, @code{ARGV[1]}
+contiene @samp{inventory-shipped} e @code{ARGV[2]} contiene
address@hidden
+Si noti che il nome del programma @command{awk} non @`e incluso in @code{ARGV}.
+Le altre opzioni della riga di comando, con i relativi argomenti,
+sono parimenti non presenti, compresi anche gli assegnamenti di
+variabile fatti tramite l'opzione @option{-v}
+(@pxref{Opzioni}).
+I normali assegnamenti di variabile sulla riga dei comandi @emph{sono}
+trattati come argomenti e quindi inseriti nel vettore @code{ARGV}.
+Dato il seguente programma in un file di nome @file{vediargomenti.awk}:
+
address@hidden
+BEGIN @{
+ printf "A=%d, B=%d\n", A, B
+ for (i = 0; i < ARGC; i++)
+ printf "\tARGV[%d] = %s\n", i, ARGV[i]
address@hidden
+END @{ printf "A=%d, B=%d\n", A, B @}
address@hidden example
+
address@hidden
+la sua esecuzione produce il seguente risultato:
+
address@hidden
+$ @kbd{awk -v A=1 -f vediargomenti.awk B=2 /dev/null}
address@hidden A=1, B=0
address@hidden ARGV[0] = awk
address@hidden ARGV[1] = B=2
address@hidden ARGV[2] = /dev/null
address@hidden A=1, B=2
address@hidden example
+
+Un programma address@hidden modificare @code{ARGC} e gli elementi di
@code{ARGV}.
+Ogni volta che @command{awk} arriva alla fine di un file in input, usa
+il successivo elemento nel vettore @code{ARGV} come nome del successivo file
+in input. Cambiando il contenuto di quella stringa, un programma
address@hidden
+modificare la lista dei file che sono letti.
+Si usi @code{"-"} per rappresentare lo standard input. Assegnando ulteriori
+elementi e incrementando @code{ARGC}
+verranno letti ulteriori file.
+
+Se il valore di @code{ARGC} viene diminuto, vengono ignorati i file in input
+posti alla fine della lista. Memorizzando il valore originale di @code{ARGC}
+da qualche altra parte, un programma address@hidden gestire gli argomenti
+ignorati come se fossero qualcosa di diverso dai @value{FN}.
+
+Per eliminare un file che sia in mezzo alla lista, si imposti in @code{ARGV}
+la stringa nulla
+(@code{""}) al posto del nome del file in questione. Come address@hidden
+speciale, @command{awk} ignora valori di @value{FN} che siano stati
+rimpiazzati con la stringa nulla.
+Un'altra address@hidden @`e quella
+di usare l'istruzione @code{delete} per
+togliere elementi da @code{ARGV} (@pxref{Cancellazione}).
+
+Tutte queste azioni sono tipicamente eseguite nella regola @code{BEGIN},
+prima di iniziare l'elaborazione vera e propria dell'input.
address@hidden split} e
address@hidden
address@hidden tee}
address@hidden ifnotdocbook
address@hidden
address@hidden tee}
address@hidden ifdocbook
+per esempi
+su ognuno dei modi per togliere elementi dal vettore @code{ARGV}.
+
+Per passare direttamente delle opzioni a un programma scritto in
address@hidden, si devono terminare le opzioni di @command{awk} con
address@hidden e poi inserire le opzioni destinate al programma @command{awk},
+come mostrato qui di seguito:
+
address@hidden
+awk -f mio_programma.awk -- -v -q file1 file2 @dots{}
address@hidden example
+
+Il seguente frammento di programma ispeziona @code{ARGV} per esaminare, e
+poi rimuovere, le opzioni sulla riga di comando viste sopra:
+
address@hidden
+BEGIN @{
+ for (i = 1; i < ARGC; i++) @{
+ if (ARGV[i] == "-v")
+ verbose = 1
+ else if (ARGV[i] == "-q")
+ debug = 1
+ else if (ARGV[i] ~ /^-./) @{
+ e = sprintf("%s: opzione non riconosciuta -- %c",
+ ARGV[0], substr(ARGV[i], 2, 1))
+ print e > "/dev/stderr"
+ @} else
+ break
+ delete ARGV[i]
+ @}
address@hidden
address@hidden example
+
address@hidden differenze tra @command{awk} e @command{gawk}, variabili
@code{ARGC}/@code{ARGV}
+Terminare le opzioni di @command{awk} con @option{--} non @`e
+necessario in @command{gawk}. A meno che non si specifichi @option{--posix},
address@hidden inserisce, senza emettere messaggi, ogni opzione non
+riconosciuta
+nel vettore @code{ARGV} perch@'e sia trattata dal programma @command{awk}.
+Dopo aver trovato un'opzione non riconosciuta, @command{gawk} non cerca
+ulteriori opzioni, anche se ce ne fossero di riconoscibili.
+La riga dei comandi precedente sarebbe
+con @command{gawk}:
+
address@hidden
+gawk -f mio_programma.awk -q -v file1 file2 @dots{}
address@hidden example
+
address@hidden
+Poich@'e @option{-q} non @`e un'opzione valida per @command{gawk},
quest'opzione
+e l'opzione @option{-v} che segue sono passate al programma @command{awk}.
+(@xref{Funzione getopt} per una funzione di libreria @command{awk}
+che analizza le opzioni della riga di comando.)
+
+Nel progettare un programma, si dovrebbero scegliere opzioni che non
+siano in conflitto con quelle di @command{gawk}, perch@'e ogni opzioni
+accettata da @command{gawk} address@hidden elaborata prima di passare il resto
+della riga dei comandi al programma @command{awk}.
+Usare @samp{#!} con l'opzione @option{-E} address@hidden essere utile in
questo caso
+(@address@hidden eseguibili}
+e
address@hidden
address@hidden).
address@hidden ifnotdocbook
address@hidden
address@hidden).
address@hidden ifdocbook
+
address@hidden Sommario criteri e azioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Coppie @dfn{criterio di ricerca--azione} sono gli elementi base di un
+programma @command{awk}. I criteri di ricerca possono essere espressioni
+normali, espressioni di intervallo, o costanti @dfn{regexp}; possono anche
+essere i criteri speciali @code{BEGIN}, @code{END},
address@hidden o @code{ENDFILE}; o essere omessi. L'azione viene eseguita
+se il record corrente soddisfa il criterio di ricerca. Criteri di ricerca
+vuoti (omessi) corrispondono a
+tutti i record in input.
+
address@hidden
+L'I/O effettuato nelle azioni delle regole @code{BEGIN} ed @code{END}
+ha alcuni vincoli.
+Questo vale a maggior ragione per le regole @code{BEGINFILE} ed
address@hidden Queste ultime due forniscono degli ``agganci'' per interagire
+con l'elaborazione dei file fatta da @command{gawk},
+consentendo di risolvere situazioni che altrimenti genererebbero degli
+errori fatali (ad esempio per un file che non si @`e autorizzati
+a leggere).
+
address@hidden
+Le variabili di shell possono essere usate nei programmi @command{awk}
+prestando la dovuta attenzione all'uso degli apici.
address@hidden address@hidden facile passare una variabile di shell ad
address@hidden usando l'opzione @option{-v} e una variabile @command{awk}.
+
address@hidden
+Le azioni sono formate da istruzioni racchiuse tra parentesi graffe.
+Le istruzioni sono composte da
+espressioni, istruzioni di controllo,
+istruzioni composte,
+istruzioni di input/output e istruzioni di cancellazione.
+
address@hidden
+Le istruzioni di controllo in @command{awk} sono @address@hidden,
address@hidden, @code{for} e @address@hidden @command{gawk}
+aggiunge l'istruzione @code{switch}. Ci sono due tipi di istruzione
address@hidden: uno per eseguire dei cicli, e l'altro per esaminare un vettore.
+
address@hidden
+Le istruzioni @code{break} e @code{continue} permettono di uscire
+velocemente da un ciclo, o di passare alla successiva iterazione dello
+stesso (o di uscire da un'istruzione @code{switch}).
+
address@hidden
+Le istruzioni @code{next} e @code{nextfile} permettono, rispettivamente,
+di passare al record successivo, ricominciando l'elaborazione dalla prima
+regola del programma, o di passare al successivo file in input, sempre
+ripartendo dalla prima regola del programma.
+
address@hidden
+L'istruzione @code{exit} termina il programma. Quando @`e eseguita
+dall'interno di un'azione (o nel corpo di una funzione), trasferisce
+il controlla alle eventuali istruzioni @code{END}. Se @`e eseguita nel corpo
+di un'istruzione @code{END}, il programma @`e terminato
+immediatamente. @`E possibile specificare un valore numerico da usare come
+codice di ritorno di @command{awk}.
+
address@hidden
+Alcune variabili predefinite permettono di controllare @command{awk},
+principalmente per l'I/O. Altre variabili trasmettono informazioni
+da @command{awk} al programma.
+
address@hidden
+I vettori @code{ARGC} e @code{ARGV} rendono disponibili al programma gli
+argomenti della riga di comando. Una loro modifica all'interno di una regola
address@hidden permette di controllare come @command{awk} address@hidden i
@value{DF}
+in input.
+
address@hidden itemize
+
address@hidden Vettori
address@hidden Vettori in @command{awk}
address@hidden vettori
+
+Un @dfn{vettore} @`e una tabella di valori chiamati @dfn{elementi}. Gli
+elementi di un vettore sono individuati dai loro @dfn{indici}. Gli indici
+possono essere numeri o stringhe.
+
+Questo @value{CHAPTER} descrive come funzionano i vettori in @command{awk},
+come usare gli elementi di un vettore, come visitare tutti gli elementi
+di un vettore, e come rimuovere elementi da un vettore.
+Descrive anche come @command{awk} simula vettori multidimensionali,
+oltre ad alcuni aspetti meno ovvii sull'uso dei vettori.
+Il @value{CHAPTER} prosegue illustrando la address@hidden di ordinamento dei
+vettori di @command{gawk}, e termina con una breve descrizione della
address@hidden
+di @command{gawk} di consentire veri vettori di vettori.
+
address@hidden
+* Fondamenti sui vettori:: Informazioni di base sui vettori.
+* Indici numerici di vettore:: Come usare numeri come indici in
+ @command{awk}.
+* Indici non inizializzati:: Usare variabili non inizializzate come indici.
+* Cancellazione:: L'istruzione @code{delete} toglie un elemento
+ da un vettore.
+* Vettori multidimensionali:: Emulare vettori multidimensionali in
+ @command{awk}.
+* Vettori di vettori:: Vettori multidimensionali veri.
+* Sommario dei vettori:: Sommario dei vettori.
address@hidden menu
+
address@hidden Fondamenti sui vettori
address@hidden Informazioni di base sui vettori
+
+Questa @value{SECTION} espone le nozioni fondamentali: elaborare gli elementi
+di un vettore uno alla volta, e visitare sequenzialmente tutti gli elementi
+di un vettore.
+
address@hidden
+* Introduzione ai vettori:: Introduzione ai vettori
+* Visitare elementi:: Come esaminare un elemento di un vettore.
+* Impostare elementi:: Come cambiare un elemento di un vettore.
+* Esempio di vettore:: Esempio semplice di vettore
+* Visitare un intero vettore:: Variazione dell'istruzione @code{for}. Esegue
+ un ciclo attraverso gli indici degli elementi
+ contenuti in un vettore.
+* Controllare visita:: Controllare l'ordine in cui i vettori sono
+ visitati.
address@hidden menu
+
address@hidden Introduzione ai vettori
address@hidden Introduzione ai vettori
+
address@hidden Wall, Larry
address@hidden
address@hidden sequenzialmente un vettore associativo @`e come tentare di
+lapidare qualcuno usando una mitragliatrice Uzi carica.}
address@hidden Larry Wall
address@hidden quotation
+
+Il linguaggio @command{awk} mette a disposizione vettori monodimensionali per
+memorizzare gruppi di stringhe o di numeri correlati fra loro. Ogni vettore di
address@hidden deve avere un nome. I nomi dei vettori hanno la stessa sintassi
+dei nomi di variabile; qualsiasi nome valido di variabile potrebbe essere anche
+un valido nome di vettore. Un nome address@hidden non address@hidden essere
usato in entrambi i
+modi (come vettore e come variabile) nello stesso programma @command{awk}.
+
+I vettori in @command{awk} assomigliano superficialmente ai vettori in altri
+linguaggi di programmazione, ma ci sono differenze fondamentali. In
address@hidden, non @`e necessario specificare la dimensione di un vettore prima
+di iniziare a usarlo. In address@hidden, qualsiasi numero o stringa
address@hidden essere usato
+come indice di un vettore, non solo numeri interi consecutivi.
+
+Nella maggior parte degli altri linguaggi, i vettori devono essere
address@hidden prima dell'uso, specificando quanti elementi o componenti
+contengono. In questi linguaggi, la dichiarazione causa l'allocazione, per
+questi elementi, di un blocco di memoria contiguo.
+Normalmente, un indice di un vettore dev'essere un intero non negativo.
+Per esempio, l'indice zero specifica il primo elemento nel vettore, che @`e
+effettivamente memorizzato all'inizio di un blocco di memoria. L'indice uno
+specifica il secondo elemento, che @`e memorizzato subito dopo il primo
elemento,
+e address@hidden@dotless{i}} via. @`E impossibile aggiungere ulteriori
elementi al vettore, perch@'e
+esso address@hidden contenere solo il numero di elementi dichiarato.
+(Alcuni linguaggi consentono indici iniziali e finali arbitrari---p.es.,
address@hidden .. address@hidden la dimensione del vettore rimane fissa una
volta che
+il vettore sia stato dichiarato.)
+
address@hidden 1/2015: Do not put the numeric values into @code. Array element
address@hidden values are no different than scalar variable values.
+Un vettore contiguo di quattro elementi potrebbe essere come quello in
address@hidden
address@hidden,
address@hidden ifnotdocbook
address@hidden
+come mostrato in @inlineraw{docbook, <xref linkend="vettore-elementi"/>}:
address@hidden ifdocbook
+concettualmente, se i valori degli elementi sono 8, @code{"pippo"},
address@hidden""} e 30.
+
address@hidden
address@hidden Figura,vettore-elementi
address@hidden vettore contiguo}
address@hidden SMALLPRINT
address@hidden @image{vettore-elementi, 11cm, , Un vettore contiguo}
address@hidden ifset
address@hidden SMALLPRINT
address@hidden @image{vettore-elementi, , , Un vettore contiguo}
address@hidden ifclear
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="vettore-elementi" float="0">
+<title>Un vettore contiguo</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="vettore-elementi.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
address@hidden
+Vengono memorizzati solo i valori; gli indici sono definiti implicitamente
+dall'ordine dei valori. Qui, 8 @`e il valore il cui indice @`e zero, perch@'e 8
+appare nella posizione con zero elementi prima di essa.
+
address@hidden vettori, indicizzazione
address@hidden indicizzare i vettori
address@hidden associativi, vettori
address@hidden vettori associativi
+I vettori in @command{awk} non sono di questo tipo: sono invece
address@hidden
address@hidden significa che ogni vettore @`e un insieme di coppie, ognuna
costituita
+da un indice e dal corrispondente valore dell'elemento del vettore:
+
address@hidden
address@hidden extra empty column to indent it right
address@hidden @columnfractions .1 .1 .1
address@hidden @tab Indice @tab Valore
address@hidden @tab @code{3} @tab @code{30}
address@hidden @tab @code{1} @tab @code{"pippo"}
address@hidden @tab @code{0} @tab @code{8}
address@hidden @tab @code{2} @tab @code{""}
address@hidden multitable
address@hidden ifnotdocbook
+
address@hidden
+<informaltable>
+<tgroup cols="2">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<thead>
+<row>
+<entry>Indice</entry>
+<entry>Valore</entry>
+</row>
+</thead>
+
+<tbody>
+<row>
+<entry><literal>3</literal></entry>
+<entry><literal>30</literal></entry>
+</row>
+
+<row>
+<entry><literal>1</literal></entry>
+<entry><literal>"pippo"</literal></entry>
+</row>
+
+<row>
+<entry><literal>0</literal></entry>
+<entry><literal>8</literal></entry>
+</row>
+
+<row>
+<entry><literal>2</literal></entry>
+<entry><literal>""</literal></entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
address@hidden
+Le coppie sono elencate in ordine casuale perch@'e il loro ordinamento @`e
address@hidden'ordine address@hidden variare nelle diverse implementazioni
+di @command{awk}, che tipicamente usa tabelle @dfn{hash} per memorizzare
+elementi e valori del vettore.}
+
+Un vantaggio dei vettori associativi @`e che si possono aggiungere nuove coppie
+in qualsiasi momento. Per esempio, supponiamo di aggiungere al vettore un
+decimo elemento il cui valore sia @address@hidden"numero dieci"}}. Il
risultato address@hidden:
+
address@hidden
address@hidden extra empty column to indent it right
address@hidden @columnfractions .1 .1 .3
address@hidden @tab Indice @tab Valore
address@hidden @tab @code{10} @tab @code{"numero dieci"}
address@hidden @tab @code{3} @tab @code{30}
address@hidden @tab @code{1} @tab @code{"pippo"}
address@hidden @tab @code{0} @tab @code{8}
address@hidden @tab @code{2} @tab @code{""}
address@hidden multitable
address@hidden ifnotdocbook
+
address@hidden
+<informaltable>
+<tgroup cols="2">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<thead>
+<row>
+<entry>Indice</entry>
+<entry>Valore</entry>
+</row>
+</thead>
+<tbody>
+
+<row>
+<entry><literal>10</literal></entry>
+<entry><literal>"numero dieci"</literal></entry>
+</row>
+
+<row>
+<entry><literal>3</literal></entry>
+<entry><literal>30</literal></entry>
+</row>
+
+<row>
+<entry><literal>1</literal></entry>
+<entry><literal>"pippo"</literal></entry>
+</row>
+
+<row>
+<entry><literal>0</literal></entry>
+<entry><literal>8</literal></entry>
+</row>
+
+<row>
+<entry><literal>2</literal></entry>
+<entry><literal>""</literal></entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
address@hidden
address@hidden sparsi, vettori
address@hidden vettori sparsi
+Ora il vettore @`e @dfn{sparso}, il che significa semplicemente che non sono
+usati alcuni indici. Ha gli elementi 0, 1, 2, 3 e 10, ma mancano gli
+elementi 4, 5, 6, 7, 8 e 9.
+
+Un'altra caratteristica dei vettori associativi @`e che gli indici non devono
+essere necessariamente interi non negativi. Qualsiasi numero, o anche una
+stringa, address@hidden essere un indice. Per esempio, il seguente @`e un
vettore che
+traduce delle parole dall'inglese all'italiano:
+
address@hidden
address@hidden @columnfractions .1 .1 .1
address@hidden @tab Indice @tab Valore
address@hidden @tab @code{"dog"} @tab @code{"cane"}
address@hidden @tab @code{"cat"} @tab @code{"gatto"}
address@hidden @tab @code{"one"} @tab @code{"uno"}
address@hidden @tab @code{1} @tab @code{"uno"}
address@hidden multitable
address@hidden ifnotdocbook
+
address@hidden
+<informaltable>
+<tgroup cols="2">
+<colspec colname="1" align="left"/>
+<colspec colname="2" align="left"/>
+<thead>
+<row>
+<entry>Indice</entry>
+<entry>Valore</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><literal>"dog"</literal></entry>
+<entry><literal>"cane"</literal></entry>
+</row>
+
+<row>
+<entry><literal>"cat"</literal></entry>
+<entry><literal>"gatto"</literal></entry>
+</row>
+
+<row>
+<entry><literal>"one"</literal></entry>
+<entry><literal>"uno"</literal></entry>
+</row>
+
+<row>
+<entry><literal>1</literal></entry>
+<entry><literal>"uno"</literal></entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
address@hidden docbook
+
address@hidden
+Qui abbiamo deciso di tradurre il numero uno sia nella forma letterale che in
+quella numerica, per illustrare che un singolo vettore address@hidden avere
come indici
+sia numeri che stringhe.
+(In effetti, gli indici dei vettori sono sempre stringhe.
+Ci sono alcune sottigliezze su come funzionano i numeri quando sono usati come
+indici dei vettori; questo address@hidden trattato in maggior dettaglio nella
address@hidden numerici di vettore}.)
+Qui sopra, il numero @code{1} non @`e tra doppi apici, perch@'e @command{awk}
+lo converte automaticamente in una stringa.
+
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden maiuscolo/minuscolo, distinzione, indici dei vettori e
address@hidden vettori, ordinamento, variabile @code{IGNORECASE} e
address@hidden @code{IGNORECASE}, variabile, e indici dei vettori
address@hidden variabile @code{IGNORECASE}, e indici dei vettori
+Il valore di @code{IGNORECASE} non ha alcun effetto sull'indicizzazione dei
+vettori. Lo stesso valore di stringa usato per memorizzare un elemento di un
+vettore address@hidden essere usato per richiamarlo.
+Quando @command{awk} crea un vettore (p.es., con la funzione predefinita
address@hidden()}), gli indici di quel vettore sono numeri interi consecutivi
+a partire da uno.
+(@xref{Funzioni per stringhe}.)
+
+I vettori di @command{awk} sono efficienti: il tempo necessario per accedere a
+un elemento @`e indipendente dal numero di elementi nel vettore.
+
address@hidden Visitare elementi
address@hidden Come esaminare un elemento di un vettore
address@hidden vettori, esaminare elementi
address@hidden vettore, elementi di un
address@hidden elementi di un vettore
+
+Il modo principale di usare un vettore @`e quello di esaminare uno dei suoi
+elementi. Un @dfn{riferimento al vettore} @`e un'espressione come questa:
+
address@hidden
address@hidden@var{espressione-indice}]
address@hidden example
+
address@hidden
+Qui, @var{vettore} @`e il nome di un vettore. L'espressione
address@hidden @`e l'indice dell'elemento del vettore che si vuol
+esaminare.
+
address@hidden 1/2015: Having the 4.3 in @samp is a little iffy. It's
essentially
address@hidden an expression though, so leave be. It's to early in the
discussion
address@hidden to mention that it's really a string.
+Il valore del riferimento al vettore @`e il valore corrente di quell'elemento
+del vettore. Per esempio, @code{pippo[4.3]} @`e un'espressione che richiama
+l'elemento del vettore @code{pippo} il cui indice @`e @samp{4.3}.
+
address@hidden vettori, elementi non assegnati
address@hidden elementi di vettore non assegnati
address@hidden elementi di vettore vuoti
+Un riferimento a un elemento di un vettore il cui indice non esiste ancora
+restituisce un valore uguale a @code{""}, la stringa nulla. Questo comprende
+elementi a cui non @`e stato assegnato un valore ed elementi che sono stati
+eliminati (@pxref{Cancellazione}).
+
address@hidden elementi inesistenti di un vettore
address@hidden vettori, elementi che non esistono
address@hidden NOTA
+Un riferimento a un elemento inesistente crea @emph{automaticamente}
+quell'elemento di vettore, con la stringa nulla come valore. (In certi casi,
address@hidden @`e indesiderabile, perch@'e potrebbe sprecare memoria
all'interno di
address@hidden)
+
+I programmatori principianti di @command{awk} fanno spesso l'errore di
+verificare se un elemento esiste controllando se il valore @`e vuoto:
+
address@hidden
+# Verifica se "pippo" esiste in a: @ii{Non corretto!}
+if (a["pippo"] != "") @dots{}
address@hidden example
+
address@hidden
+Questo @`e sbagliato per due motivi. Primo, @emph{crea} @code{a["pippo"]}
+se ancora non esisteva! Secondo, assegnare a un elemento di un vettore la
+stringa vuota come valore @`e un'operazione valida (anche se un po' insolita).
address@hidden quotation
+
address@hidden @cindex arrays, @code{in} operator and
address@hidden @code{in}, operatore, verificare se un elemento esiste in un
vettore
+Per determinare se un elemento con un dato indice esiste in un vettore,
+si usi la seguente espressione:
+
address@hidden
address@hidden in @var{vettore}
address@hidden example
+
address@hidden effetti collaterali, indicizzazione di vettori
address@hidden
+Quest'espressione verifica se lo specifico indice @var{indice} esiste, senza
+l'effetto collaterale di creare quell'elemento nel caso che esso non sia
+presente. L'espressione ha il valore uno (vero) se
address@hidden@address@hidden
+esiste e zero (falso) se non esiste.
address@hidden (Qui usiamo @var{indx}, perch@'e @samp{index} @`e il nome di una
funzione
address@hidden predefinita.)
+Per esempio, quest'istruzione verifica se il vettore @code{frequenze}
+contiene l'indice @samp{2}:
+
address@hidden
+if (2 in frequenze)
+ print "L'indice 2 @`e presente."
address@hidden example
+
+Si noti che questo @emph{non} verifica se il vettore
address@hidden contiene un elemento il cui @emph{valore} @`e 2.
+Il solo modo far questo @`e quello di passare in rassegna tutti gli
+elementi. Inoltre, questo @emph{non} crea @code{frequenze[2]}, mentre la
+seguente alternativa (non corretta) lo fa:
+
address@hidden
+if (frequenze[2] != "")
+ print "L'indice 2 @`e presente."
address@hidden example
+
address@hidden Impostare elementi
address@hidden Assegnare un valore a elementi di un vettore
address@hidden vettori, elementi, assegnare valori
address@hidden elementi di vettori, assegnare valori
+
+Agli elementi di un vettore possono essere assegnati valori proprio come
+alle variabili di @command{awk}:
+
address@hidden
address@hidden@var{espressione-indice}] = @var{valore}
address@hidden example
+
address@hidden
address@hidden @`e il nome di un vettore. L'espressione
address@hidden @`e l'indice dell'elemento del vettore a cui @`e
+assegnato il valore. L'espressione @var{valore} @`e il valore da assegnare
+a quell'elemento del vettore.
+
address@hidden Esempio di vettore
address@hidden Esempio semplice di vettore
address@hidden vettori, un esempio sull'uso
+
+Il seguente programma prende una lista di righe, ognuna delle quali inizia con
+un numero di riga, e le stampa in ordine di numero di riga. I numeri di riga
+non sono ordinati al momento della lettura, ma sono invece in ordine sparso.
+Questo programma ordina le righe mediante la creazione di un vettore che usa
+i numeri di riga come indici. Il programma stampa poi le righe
+ordinate secondo il loro numero. @`E un programma molto semplice e non @`e in
+grado di gestire numeri ripetuti, salti di riga o righe che non
+iniziano con un numero:
+
address@hidden
address@hidden file eg/misc/arraymax.awk
address@hidden
+ if ($1 > massimo)
+ massimo = $1
+ vett[$1] = $0
address@hidden
+
+END @{
+ for (x = 1; x <= massimo; x++)
+ print vett[x]
address@hidden
address@hidden endfile
address@hidden example
+
+La prima regola tiene traccia del numero di riga address@hidden grande visto
+durante la lettura;
+memorizza anche ogni riga nel vettore @code{vett}, usando come indice
+il numero di riga.
+La seconda regola viene eseguita dopo che @`e stato letto tutto l'input, per
+stampare tutte le righe.
+Quando questo programma viene eseguito col seguente input:
+
address@hidden
address@hidden file eg/misc/arraymax.data
+5 Io sono l'uomo Cinque
+2 Chi sei? Il nuovo numero due!
+4 . . . E quattro a terra
+1 Chi @`e il numero uno?
+3 Sei il tre.
address@hidden endfile
address@hidden example
+
address@hidden
+Il suo output @`e:
+
address@hidden
+1 Chi @`e il numero uno?
+2 Chi sei? Il nuovo numero due!
+3 Sei il tre.
+4 . . . E quattro a terra
+5 Io sono l'uomo Cinque
address@hidden example
+
+Se un numero di riga appare address@hidden di una volta, l'ultima riga con
quel dato
+numero prevale sulle altre.
+Le righe non presenti nel vettore
+si possono saltare con un semplice perfezionamento della
+regola @code{END} del programma, in questo modo:
+
address@hidden
+END @{
+ for (x = 1; x <= massimo; x++)
+ if (x in vett)
+ print vett[x]
address@hidden
address@hidden example
+
address@hidden Visitare un intero vettore
address@hidden Visitare tutti gli elementi di un vettore
address@hidden elementi di vettori, visitare
address@hidden visitare vettori
address@hidden vettori, visitare
address@hidden cicli, @code{for}, visita di un vettore
+
+Nei programmi che usano vettori, @`e spesso necessario usare un ciclo che
+esegue un'azione su ciascun elemento di un vettore. In altri linguaggi, dove
+i vettori sono contigui e gli indici sono limitati ai numeri interi
+non negativi,
+questo @`e facile: tutti gli indici validi possono essere visitati partendo
+dall'indice address@hidden basso e arrivando a quello address@hidden alto.
Questa tecnica non
address@hidden applicabile in @command{awk}, perch@'e qualsiasi numero o
stringa address@hidden
+fare da indice in un vettore. address@hidden @command{awk} ha un tipo
speciale di
+istruzione @code{for} per visitare un vettore:
+
address@hidden
+for (@var{variabile} in @var{vettore})
+ @var{corpo}
address@hidden example
+
address@hidden
address@hidden @code{in}, operatore, uso in cicli
address@hidden operatore @code{in}, uso in cicli
+Questo ciclo esegue @var{corpo} una volta per ogni indice in @var{vettore} che
+il programma ha usato precedentemente, con la variabile @var{variabile}
+impostata a quell'indice.
+
address@hidden vettori, istruzione @code{for} e
address@hidden @code{for}, istruzione, esecuzione di cicli su un vettore
+Il seguente programma usa questa forma dell'istruzione @code{for}. La
+prima regola visita i record in input e tiene nota di quali parole appaiono
+(almeno una volta) nell'input, memorizzando un 1 nel vettore @code{usate} con
+la parola come indice. La seconda regola visita gli elementi di
address@hidden per trovare tutte le parole distinte che appaiono nell'input.
+Il programma stampa poi ogni parola che @`e address@hidden lunga di 10
caratteri e
+anche il numero di tali parole.
address@hidden per stringhe}
+per maggiori informazioni sulla funzione predefinita @code{length()}.
+
address@hidden
+# Registra un 1 per ogni parola usata almeno una volta
address@hidden
+ for (i = 1; i <= NF; i++)
+ usate[$i] = 1
address@hidden
+
+# Trova il numero di parole distinte lunghe address@hidden di 10 caratteri
+END @{
+ for (x in usate) @{
+ if (length(x) > 10) @{
+ ++numero_parole_lunghe
+ print x
+ @}
+ @}
+ print numero_parole_lunghe, "parole address@hidden lunghe di 10 caratteri"
address@hidden
address@hidden example
+
address@hidden
address@hidden utilizzo parole}
+per un esempio di questo tipo address@hidden dettagliato.
+
address@hidden vettori, elementi di, ordine di accesso da parte dell'operatore
@code{in}
address@hidden elementi di vettori, ordine di accesso da parte dell'operatore
@code{in}
address@hidden @code{in}, operatore, ordine di accesso dei vettori
address@hidden operatore @code{in}, ordine di accesso dei vettori
+L'ordine nel quale gli elementi del vettore sono esaminati da quest'istruzione
address@hidden determinato dalla disposizione interna degli elementi del
vettore all'interno
+di @command{awk} e nell'@command{awk} standard non address@hidden essere
controllato
+o cambiato. Questo address@hidden portare a dei problemi se vengono aggiunti
nuovi
+elementi al @var{vettore} dall'istruzione eseguendo il corpo del ciclo;
+non @`e prevedibile se il ciclo @code{for} li address@hidden raggiungere.
Similmente,
+modificare @var{variabile} all'interno del ciclo potrebbe produrre strani
+risultati. @`E meglio evitare di farlo.
+
+Di sicuro, @command{gawk} imposta la lista di elementi su cui eseguire
+l'iterazione prima che inizi il ciclo, e non la cambia in corso d'opera.
+Ma non tutte le versioni di @command{awk} fanno address@hidden@dotless{i}}. Si
consideri questo
+programma, chiamato @file{vediciclo.awk}:
+
address@hidden
+BEGIN @{
+ a["questo"] = "questo"
+ a["@`e"] = "@`e"
+ a["un"] = "un"
+ a["ciclo"] = "ciclo"
+ for (i in a) @{
+ j++
+ a[j] = j
+ print i
+ @}
address@hidden
address@hidden example
+
+Ecco quel che accade quando viene eseguito con @command{gawk} (e
@command{mawk}):
+
address@hidden
+$ @kbd{gawk -f vediciclo.awk}
address@hidden questo
address@hidden ciclo
address@hidden un
address@hidden @`e
address@hidden example
+
+Se si usa invece BWK @command{awk}:
+
address@hidden
+$ @kbd{nawk -f vediciclo.awk}
address@hidden ciclo
address@hidden questo
address@hidden @`e
address@hidden un
address@hidden 1
address@hidden example
+
address@hidden Controllare visita
address@hidden Visita di vettori in ordine predefinito con @command{gawk}
+
+Questa @value{SUBSECTION} descrive una address@hidden disponibile solo in
address@hidden
+
+Per default, quando un ciclo @code{for} visita un vettore, l'ordine
address@hidden indeterminato, il che vuol dire che l'implementazione di
@command{awk}
+determina l'ordine in cui il vettore viene attraversato.
+Quest'ordine normalmente @`e basato sull'implementazione interna dei vettori
+e varia da una versione di @command{awk} alla successiva.
+
address@hidden vettori, ordine di visita, controllo dell'
address@hidden controllare l'ordine di visita dei vettori
+Spesso, tuttavia, servirebbe fare qualcosa di semplice, come
+``visitare il vettore confrontando gli indici in ordine crescente,''
+o ``visitare il vettore confrontando i valori in ordine decrescente.''
address@hidden fornisce due meccanismi che permettono di farlo.
+
address@hidden @value{BULLET}
address@hidden
+Assegnare a @code{PROCINFO["sorted_in"]} un valore a scelta fra
+alcuni valori predefiniti.
+Si vedano address@hidden sotto i valori ammessi.
+
address@hidden
+Impostare @code{PROCINFO["sorted_in"]} al nome di una funzione definita
+dall'utente, da usare per il confronto tra gli elementi di un vettore. Questa
address@hidden avanzata address@hidden descritta in seguito in @ref{Ordinamento
di vettori}.
address@hidden itemize
+
address@hidden @code{PROCINFO}, valori di @code{sorted_in}
+Sono disponibili i seguenti valori speciali per @code{PROCINFO["sorted_in"]}:
+
address@hidden @code
address@hidden "@@unsorted"
+Lasciare gli elementi del vettore in ordine arbitrario
+(questo @`e il comportamento di default di @command{awk}).
+
address@hidden "@@ind_str_asc"
+Ordinare in ordine crescente di indice, confrontando tra loro gli indici
+come stringhe; questo @`e l'ordinamento address@hidden normale.
+(Internamente, gli indici dei vettori sono sempre stringhe, per cui con
address@hidden = 1} l'indice @`e la stringa @code{"10"} e non il numero 10.)
+
address@hidden "@@ind_num_asc"
+Ordinare in ordine crescente di indice, ma nell'elaborazione gli indici vengono
+trattati come numeri. Gli indici con valore non numerico verranno posizionati
+come se fossero uguali a zero.
+
address@hidden "@@val_type_asc"
+Ordinare secondo il valore degli elementi in ordine crescente (invece che in
+base agli indici). L'ordinamento @`e in base al tipo assegnato all'elemento
+(@pxref{Tipi di variabile e confronti}).
+Tutti i valori numerici precedono tutti i valori di tipo stringa,
+che a loro volta vengono prima dei sottovettori.
+(I sottovettori non sono ancora stati descritti;
address@hidden di vettori}.)
+
address@hidden "@@val_str_asc"
+Ordinare secondo il valore degli elementi in ordine crescente (invece che in
+base agli indici). I valori scalari sono confrontati come stringhe.
+I sottovettori, se presenti, vengono per ultimi.
+
address@hidden "@@val_num_asc"
+Ordinare secondo il valore degli elementi in ordine crescente (invece che in
+base agli indici). I valori scalari sono confrontati come numeri.
+I sottovettori, se presenti, vengono per ultimi.
+Quando i valori numerici coincidono, vengono usati i valori di tipo stringa
+per stabilire un ordinamento: address@hidden garantisce risultati coerenti tra
differenti
+versioni della funzione C @code{qsort()},@footnote{Quando due elementi
+risultano uguali, la funzione C @code{qsort()} non garantisce
+che dopo l'ordinamento venga rispettato il loro ordine relativo originale.
+Usando il valore di stringa per stabilire un ordinamento univoco quando i
+valori numerici sono uguali assicura che il comportamento di @command{gawk}
+sia coerente in differenti ambienti.} che @command{gawk} usa internamente
+per effettuare l'ordinamento.
+
address@hidden "@@ind_str_desc"
+Ordinare come fa @code{"@@ind_str_asc"}, ma gli
+indici di tipo stringa sono ordinati dal address@hidden alto al address@hidden
basso.
+
address@hidden "@@ind_num_desc"
+Ordinare come fa @code{"@@ind_num_asc"}, ma gli
+indici numerici sono ordinati dal address@hidden alto al address@hidden basso.
+
address@hidden "@@val_type_desc"
+Ordinare come fa @code{"@@val_type_asc"}, ma i valori
+degli elementi, a seconda del tipo, sono ordinati dal address@hidden alto al
address@hidden basso.
+I sottovettori, se presenti, vengono per primi.
+
address@hidden "@@val_str_desc"
+Ordinare come fa @code{"@@val_str_asc"}, ma i valori degli
+elementi, trattati come stringhe, sono ordinati dal address@hidden alto al
address@hidden basso.
+I sottovettori, se presenti, vengono per primi.
+
address@hidden "@@val_num_desc"
+Ordinare come fa @code{"@@val_num_asc"}, ma i valori degli
+elementi, trattati come numeri, sono ordinati dal address@hidden alto al
address@hidden basso.
+I sottovettori, se presenti, vengono per primi.
address@hidden table
+
+L'ordine in cui il vettore @`e visitato viene determinato prima di iniziare
+l'esecuzione del ciclo @code{for}. Cambiare @code{PROCINFO["sorted_in"]}
+all'interno del corpo del ciclo non influisce sul ciclo stesso.
+Per esempio:
+
address@hidden
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{ a[4] = 4}
+> @kbd{ a[3] = 3}
+> @kbd{ for (i in a)}
+> @kbd{ print i, a[i]}
+> @address@hidden'}
address@hidden 4 4
address@hidden 3 3
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{ PROCINFO["sorted_in"] = "@@ind_str_asc"}
+> @kbd{ a[4] = 4}
+> @kbd{ a[3] = 3}
+> @kbd{ for (i in a)}
+> @kbd{ print i, a[i]}
+> @address@hidden'}
address@hidden 3 3
address@hidden 4 4
address@hidden example
+
+Quando si ordina un vettore in base al valore dei suoi elementi, se viene
+trovato un valore che @`e un sottovettore, questo @`e considerato
address@hidden grande di
+qualsiasi stringa o valore numerico, indipendentemente da quel che contiene
+lo stesso sottovettore, e tutti i sottovettori sono trattati come se fossero
+l'uno uguale all'altro. Il loro ordine reciproco @`e determinato dai loro
+indici, visti come stringhe.
+
+Di seguito sono elencati alcuni punti da tener presenti sulla visita
+ordinata dei vettori:
+
address@hidden @value{BULLET}
address@hidden
+Il valore di @code{PROCINFO["sorted_in"]} @`e globale. address@hidden, ha
effetto su tutti
+i cicli @code{for} relativi a qualsiasi vettore. Se si deve cambiarlo
+all'interno del proprio codice, si dovrebbe vedere se era address@hidden stato
+definito in precedenza, e salvare il valore relativo, per ripristinarlo
+successivamente:
+
address@hidden
address@hidden
+if ("sorted_in" in PROCINFO) @{
+ ordine_salvato = PROCINFO["sorted_in"]
+ PROCINFO["sorted_in"] = "@@val_str_desc" # o qualcos'altro
address@hidden
address@hidden
+if (ordine_salvato)
+ PROCINFO["sorted_in"] = ordine_salvato
address@hidden example
+
address@hidden
+Come address@hidden accennato, l'ordine di visita di default del vettore
address@hidden rappresentato da @code{"@@unsorted"}. Si address@hidden
ottenere il comportamento di
+default anche assegnando la stringa nulla a @code{PROCINFO["sorted_in"]} o
+semplicemente eliminando l'elemento @code{"sorted_in"} dal vettore
address@hidden con l'istruzione @code{delete}.
+(L'istruzione @code{delete} non @`e stata ancora descritta;
@pxref{Cancellazione}.)
address@hidden itemize
+
+Inoltre, @command{gawk} fornisce funzioni predefinite per l'ordinamento
+dei vettori; si veda @ref{Funzioni di ordinamento di vettori}.
+
address@hidden Indici numerici di vettore
address@hidden Usare numeri per indicizzare i vettori
+
address@hidden numeri, come indici di vettore
address@hidden vettori, indici numerici di
address@hidden indici di vettori, numeri come
address@hidden @code{CONVFMT}, variabile, e indici di vettore
+Un aspetto importante da ricordare riguardo ai vettori @`e che
address@hidden indici dei vettori sono sempre stringhe}.
+Quando un valore numerico @`e usato come indice,
+viene convertito in un valore di tipo stringa prima di essere usato per
+l'indicizzazione (@pxref{Conversione}).
address@hidden vuol dire che il valore della variabile predefinita
@code{CONVFMT} address@hidden
+influire su come un programma ha accesso agli elementi di un vettore.
+Per esempio:
+
address@hidden
+xyz = 12.153
+dati[xyz] = 1
+CONVFMT = "%2.2f"
+if (xyz in dati)
+ printf "%s @`e in dati\n", xyz
+else
+ printf "%s non @`e in dati\n", xyz
address@hidden example
+
address@hidden
+Il risultato @`e @samp{12.15 non @`e in dati}. La prima istruzione
address@hidden a
address@hidden un valore numerico. L'assegnamento a @code{dati[xyz]}
+indicizza @code{dati} col valore di tipo stringa @code{"12.153"}
+(usando il valore di conversione di default @code{CONVFMT}, @code{"%.6g"}).
+Quindi, all'elemento del vettore @code{dati["12.153"]} @`e assegnato il valore
+uno. Il programma cambia poi
+il valore di @code{CONVFMT}. La verifica @samp{(xyz in dati)} genera un nuovo
+valore di stringa da @code{xyz}---questa volta @code{"12.15"}---perch@'e il
+valore di @code{CONVFMT} consente solo due cifre decimali. Questa
+verifica address@hidden esito negativo, perch@'e @code{"12.15"} @`e diverso da
@code{"12.153"}.
+
address@hidden convertire numeri interi che sono indici di vettore
address@hidden numeri interi, indici di vettore
+Secondo le regole di conversione
+(@pxref{Conversione}), i valori numerici interi
+vengono convertiti in stringhe sempre come interi, indipendentemente dal
+valore che potrebbe avere @code{CONVFMT}. E infatti il caso
+seguente produce il risultato atteso:
+
address@hidden
+for (i = 1; i <= maxsub; i++)
+ @ii{fa qualcosa con} vettore[i]
address@hidden example
+
+La regola ``i valori numerici interi si convertono sempre in stringhe intere''
+ha un'altra conseguenza per l'indicizzazione dei vettori.
+Le costanti ottali ed esadecimali
address@hidden
+(@pxref{Numeri non-decimali})
address@hidden ifnotdocbook
address@hidden
+(trattate in @ref{Numeri non-decimali})
address@hidden ifdocbook
+vengono convertite internamente in numeri, e la loro forma originale
+non viene address@hidden ricordata. address@hidden significa, per esempio, che
address@hidden,
address@hidden e
address@hidden fanno riferimento tutti allo stesso
+elemento!
+
+Come molte cose in @command{awk}, molto spesso le cose
+funzionano come ci si aspetta. @`E utile comunque avere una
+conoscenza precisa delle regole applicate, poich@'e a volte possono avere
+effetti difficili da individuare sui programmi.
+
address@hidden Indici non inizializzati
address@hidden Usare variabili non inizializzate come indici
+
address@hidden variabili non inizializzate, come indici di vettore
address@hidden non inizializzate, variabili, come indici di vettore
address@hidden indici di vettore, variabili non inizializzate come
address@hidden vettori, indici, variabili non inizializzate come
+Supponiamo che sia necessario scrivere un programma
+per stampare i dati di input in ordine inverso.
+Un tentativo ragionevole per far address@hidden (con qualche dato di
+prova) potrebbe essere qualcosa di questo tipo:
+
address@hidden
+$ @kbd{echo 'riga 1}
+> @kbd{riga 2}
+> @kbd{riga 3' | awk '@{ l[righe] = $0; ++righe @}}
+> @kbd{END @{}
+> @kbd{for (i = righe - 1; i >= 0; i--)}
+> @kbd{print l[i]}
+> @address@hidden'}
address@hidden riga 3
address@hidden riga 2
address@hidden example
+
+Sfortunatamente, la prima riga di dati in input non appare
+nell'output!
+
+A prima vista, verrebbe da dire che questo programma avrebbe dovuto
+funzionare. La variabile @code{righe}
+non @`e inizializzata, e le variabili non inizializzate hanno il valore
numerico
+zero. address@hidden@dotless{i}}, @command{awk} dovrebbe aver stampato il
valore @code{l[0]}.
+
+Qui il problema @`e che gli indici per i vettori di @command{awk} sono
address@hidden stringhe. Le variabili non inizializzate, quando sono usate come
+stringhe, hanno il valore @code{""}, e non zero. Quindi, @samp{riga 1}
+finisce per essere memorizzata in @code{l[""]}.
+La seguente variante del programma funziona correttamente:
+
address@hidden
address@hidden l[righe++] = $0 @}
+END @{
+ for (i = righe - 1; i >= 0; i--)
+ print l[i]
address@hidden
address@hidden example
+
+Qui, @samp{++} forza @code{righe} a essere di tipo numerico, rendendo
+quindi il ``vecchio valore'' uno zero numerico. Questo viene poi convertito
+in @code{"0"} come l'indice del vettore.
+
address@hidden nulle, stringhe, come indici di vettore
address@hidden stringhe nulle, come indici di vettore
address@hidden angolo buio, indici di vettori
address@hidden @dfn{lint}, controlli, indici di vettori
address@hidden controlli @dfn{lint}, indici di vettori
+Anche se la cosa address@hidden sembrare strana, la stringa nulla
+(@code{""}) @`e un indice di vettore valido.
address@hidden
+Se viene fornita l'opzione @option{--lint} sulla riga di comando
address@hidden), @command{gawk} avvisa quando la stringa nulla viene usata
+come indice.
+
address@hidden Cancellazione
address@hidden L'istruzione @code{delete}
address@hidden @code{delete}, istruzione
address@hidden istruzione @code{delete}
address@hidden eliminare elementi di vettori
address@hidden vettori, elementi, eliminazione di
address@hidden elementi di vettori, eliminazione di
+
+Per rimuovere un singolo elemento da un vettore si usa l'istruzione
address@hidden:
+
address@hidden
+delete @address@hidden
address@hidden example
+
+Una volta che un elemento di un vettore @`e stato eliminato, il valore che
aveva
+quell'elemento non @`e address@hidden disponibile. @`E come se quell'elemento
non sia
+mai stato referenziato oppure come se non gli sia mai stato assegnato un
+valore. Il seguente @`e un esempio di eliminazione di elementi da un vettore:
+
address@hidden
+for (i in frequenze)
+ delete frequenze[i]
address@hidden example
+
address@hidden
+Quest'esempio rimuove tutti gli elementi dal vettore @code{frequenze}. Una
+volta che un elemento @`e stato eliminato, una successiva istruzione @code{for}
+che visiti il vettore non address@hidden quell'elemento, e l'uso dell'operatore
address@hidden per controllare la presenza di quell'elemento restituisce zero
(address@hidden
+falso):
+
address@hidden
+delete pippo[4]
+if (4 in pippo)
+ print "Questo non address@hidden mai stampato"
address@hidden example
+
address@hidden nulle, stringhe, ed eliminazione di elementi di un vettore
address@hidden stringhe nulle, ed eliminazione di elementi di un vettore
address@hidden importante notare che eliminare un elemento @emph{non} @`e la
stessa cosa
+che assegnargli un valore nullo (la stringa vuota, @code{""}).
+Per esempio:
+
address@hidden
+pippo[4] = ""
+if (4 in pippo)
+ print "Questo viene stampato, anche se pippo[4] @`e vuoto"
address@hidden example
+
address@hidden @dfn{lint}, controlli, elementi di vettori
address@hidden controlli @dfn{lint}, elementi di vettori
address@hidden elementi di vettori, controlli @dfn{lint} per
+Non @`e un errore eliminare un elemento che non esiste.
+Tuttavia, se viene data l'opzione @option{--lint} sulla riga di comando
+(@pxref{Opzioni}),
address@hidden emette un messaggio di avvertimento quando viene eliminato un
+elemento che non @`e presente in un vettore.
+
address@hidden comuni, estensioni, @code{delete} per eliminare interi vettori
address@hidden estensioni address@hidden @code{delete} per eliminare interi
vettori
address@hidden vettori, eliminare l'intero contenuto
address@hidden eliminare interi vettori
address@hidden @code{delete}, @var{vettore}
address@hidden differenze tra @command{awk} e @command{gawk}, elementi dei
vettori, eliminazione
+Tutti gli elementi di un vettore possono essere eliminati con una singola
+istruzione omettendo l'indice nell'istruzione @code{delete},
+in questo modo:
+
+
address@hidden
+delete @var{vettore}
address@hidden example
+
+L'uso di questa versione dell'istruzione @code{delete} @`e circa tre volte
address@hidden
+efficiente dell'equivalente ciclo che elimina gli elementi uno
+alla volta.
+
+Questa forma dell'istruzione @code{delete} @`e ammessa anche
+da BWK @command{awk} e da @command{mawk}, e anche da
+diverse altre implementazioni.
+
address@hidden Brian Kernighan, @command{awk} di
address@hidden NOTA
+Per molti anni, l'uso di @code{delete} senza un indice era un'estensione
+comune. A settembre 2012 si @`e deciso di includerla nello
+standard POSIX. Si veda @uref{http://austingroupbugs.net/view.php?id=544,
+il sito dell'Austin Group}.
address@hidden quotation
+
address@hidden address@hidden, eliminazione di elementi di un vettore
address@hidden Brennan, Michael
+La seguente istruzione fornisce un modo portabile, anche se non evidente,
+per svuotare un vettore:@footnote{Un ringraziamento a Michael
+Brennan per la segnalazione.}
+
address@hidden
+split("", vettore)
address@hidden example
+
address@hidden @code{split()}, funzione, eliminazione di elementi di vettori
address@hidden funzione @code{split()}, eliminazione di elementi di vettori
+La funzione @code{split()}
+(@pxref{Funzioni per stringhe})
+dapprima svuota il vettore indicato. La chiamata chiede di dividere
+la stringa nulla. Poich@'e non c'@`e nulla da dividere, la
+funzione si limita a svuotare il vettore e poi termina.
+
address@hidden ATTENZIONE
+L'eliminazione di tutti gli elementi di un vettore non cambia il suo tipo; non
+si address@hidden svuotare un vettore e poi usare il nome del vettore come
scalare
+(address@hidden, come una variabile semplice). Per esempio, questo non @`e
consentito:
+
address@hidden
+a[1] = 3
+delete a
+a = 3
address@hidden example
address@hidden quotation
+
address@hidden Vettori multidimensionali
address@hidden Vettori multidimensionali
+
address@hidden
+* Visitare vettori multidimensionali:: Visitare vettori multidimensionali.
address@hidden menu
+
address@hidden indici di vettori multidimensionali
address@hidden vettori multidimensionali
address@hidden multidimensionali, vettori
+Un @dfn{vettore multidimensionale} @`e un vettore in cui un elemento @`e
+identificato da un insieme di indici invece che da un indice singolo. Per
+esempio, un vettore bidimenisonale richiede due indici. Il modo consueto (in
+molti linguaggi, compreso @command{awk}) per far riferimento a un elemento di
+un vettore multidimensionale chiamato @code{griglia} @`e con
address@hidden@var{x},@var{y}]}.
+
address@hidden @code{SUBSEP}, variabile, e vettori multidimensionali
address@hidden variabile @code{SUBSEP}, e vettori multidimensionali
+I vettori multidimensionali sono resi disponibili in @command{awk} attraverso
+la concatenazione di address@hidden indici in una stringa;
address@hidden converte gli indici in stringhe
+(@pxref{Conversione}) e
+le concatena assieme, inserendo un separatore tra ognuna di loro. Ne
+risulta una sola stringa che include i valori di ogni indice. La
+stringa address@hidden@dotless{i}} composta viene usata come un singolo indice
in un vettore
+ordinario monodimensionale. Il separatore usato @`e il valore della variabile
+predefinita @code{SUBSEP}.
+
+Per esempio, supponiamo di valutare l'espressione @samp{pippo[5,12] = "valore"}
+quando il valore di @code{SUBSEP} @`e @code{"@@"}. I numeri 5 e 12 vengono
+convertiti in stringhe che sono poi
+concatenate con un @samp{@@} tra di essi, dando @code{"5@@12"}; di conseguenza,
+l'elemento del vettore @code{pippo["5@@12"]} @`e impostato a @code{"valore"}.
+
+Una volta che il valore dell'elemento @`e memorizzato, @command{awk}
+ignora se sia stato memorizzato con un solo indice o con una
+serie di indici. Le due espressioni @samp{pippo[5,12]} e
address@hidden@samp{pippo[5 SUBSEP 12]}} sono sempre equivalenti.
+
+Il valore di default di @code{SUBSEP} @`e la stringa @code{"\034"},
+che contiene un carattere non stampabile che difficilmente appare in
+un programma di @command{awk} e nella maggior parte dei dati di input.
+Il vantaggio di scegliere un carattere improbabile discende dal fatto che i
+valori degli indici che contengono una stringa corrispondente a @code{SUBSEP}
+possono portare a stringhe risultanti ambigue. Supponendo che
address@hidden valga @code{"@@"}, @address@hidden"a@@b", "c"]}} e
address@hidden@samp{pippo["a", "b@@c"]}} risultano indistinguibili perch@'e
entrambi
+sarebbero in address@hidden memorizzati come @samp{pippo["a@@b@@c"]}.
+
address@hidden @code{in}, operatore, verificare se un elemento esiste in un
vettore multidimensionale
+Per verificare se una determinata sequenza di indici esiste in un vettore
+multidimensionale, si usa lo stesso operatore (@code{in}) che viene usato
+per i vettori monodimensionali. Si scrive l'intera sequenza di indici tra
+parentesi, separati da virgole, come operando di sinistra:
+
address@hidden
+if ((@var{indice1}, @var{indice2}, @dots{}) in @var{vettore})
+ @dots{}
address@hidden example
+
+Qui vediamo un esempio, avendo in input un vettore bidimensionale
+di campi, ruota questo vettore di 90 gradi in senso orario e stampa il
+risultato. Si suppone che tutte le righe in input contengano lo stesso
+numero di elementi:
+
address@hidden
address@hidden
+ if (max_nf < NF)
+ max_nf = NF
+ max_nr = NR
+ for (x = 1; x <= NF; x++)
+ vettore[x, NR] = $x
address@hidden
+
+END @{
+ for (x = 1; x <= max_nf; x++) @{
+ for (y = max_nr; y >= 1; --y)
+ printf("%s ", vettore[x, y])
+ printf("\n")
+ @}
address@hidden
address@hidden example
+
address@hidden
+Dato l'input:
+
address@hidden
+1 2 3 4 5 6
+2 3 4 5 6 1
+3 4 5 6 1 2
+4 5 6 1 2 3
address@hidden example
+
address@hidden
+il programma produce il seguente output:
+
address@hidden
+4 3 2 1
+5 4 3 2
+6 5 4 3
+1 6 5 4
+2 1 6 5
+3 2 1 6
address@hidden example
+
address@hidden Visitare vettori multidimensionali
address@hidden Visitare vettori multidimensionali
+
+Non c'@`e un'istruzione @code{for} particolare per visitare un
+vettore ``multidimensionale''. Non ce ne address@hidden essere una, perch@'e
address@hidden in address@hidden non ha
+vettori o elementi multidimensionali: c'@`e solo una address@hidden
+multidimensionale per @emph{accedere} a un vettore.
+
address@hidden indici di vettori multidimensionali, visitare gli
address@hidden vettori, multidimensionali, visitare
address@hidden visitare vettori multidimensionali
+Comunque, se un programma ha un vettore al quale si accede sempre in
address@hidden multidimensionale, si address@hidden ottenere il risultato di
visitarlo
+combinando l'istruzione di visita @code{for}
+(@pxref{Visitare un intero vettore}) con la funzione
+interna @code{split()}
+(@pxref{Funzioni per stringhe}).
+Si procede nel seguente modo:
+
address@hidden
+for (indice_combinato in vettore) @{
+ split(indice_combinato, indici_separati, SUBSEP)
+ @dots{}
address@hidden
address@hidden example
+
address@hidden
+Questo imposta la variabile @code{indice_combinato} a ogni
+concatenazione di indici contenuta nel vettore, e la suddivide
+nei singoli indici separandoli
+in corrispondenza del valore di
address@hidden I singoli indici diventano poi gli elementi
+del vettore @code{indici_separati}.
+
address@hidden, se un valore @`e stato precedentemente memorizzato in
address@hidden, "pippo"]}, esiste in @code{vettore} un elemento con indice
address@hidden"1\034pippo"} (ricordare che il valore di default di @code{SUBSEP}
address@hidden il carattere con codice ottale 034).
+Prima o poi, l'istruzione @code{for} trova quell'indice e fa un'iterazione
+con la variabile @code{indice_combinato} impostata a @code{"1\034pippo"}.
+Poi viene chiamata la funzione @code{split()} in questo modo:
+
address@hidden
+split("1\034pippo", indici_separati, "\034")
address@hidden example
+
address@hidden
+Il risultato @`e quello di impostare @code{indici_separati[1]} a @code{"1"} e
address@hidden a @code{"pippo"}. Ecco fatto!
+La sequenza originale degli indici separati @`e ripristinata.
+
+
address@hidden Vettori di vettori
address@hidden Vettori di vettori
address@hidden vettori di vettori
+
address@hidden migliora l'accesso ai vettori multidimensionali di
address@hidden standard e mette a disposizione dei veri vettori di vettori.
+Agli elementi di un sottovettore si fa riferimento tramite il loro indice
+racchiuso tra parentesi quadre, proprio come gli elementi del vettore
+principale. Per esempio, quel che segue crea un sottovettore con due elementi
+all'indice @code{1} del vettore principale @code{a}:
+
address@hidden
+a[1][1] = 1
+a[1][2] = 2
address@hidden example
+
+Questo simula un vero vettore bidimensionale. Ogni elemento di un sottovettore
address@hidden contenere un altro sottovettore come valore, che a sua volta
address@hidden
+contenere anche ulteriori vettori. In questo modo, si possono creare vettori
+di tre o address@hidden dimensioni.
+Gli indici possono essere costituiti da qualunque espressione di
address@hidden, compresi dei
+valori scalari separati da virgole (address@hidden, un indice
multidimensionale simulato
+di @command{awk}). Quindi, la seguente espressione @`e valida in
address@hidden:
+
address@hidden
+a[1][3][1, "nome"] = "barney"
address@hidden example
+
+Ogni sottovettore e il vettore principale possono essere di diversa lunghezza.
+Di fatto, gli elementi di un vettore o un suo sottovettore non devono essere
+necessariamente tutti dello stesso tipo. address@hidden significa che il
vettore
+principale come anche uno qualsiasi dei suoi sottovettori address@hidden essere
+non rettangolare,
+o avere una struttura frastagliata. Si address@hidden assegnare un valore
scalare
+all'indice @code{4} del vettore principale @code{a}, anche se @code{a[1]}
address@hidden esso stesso un vettore e non uno scalare:
+
address@hidden
+a[4] = "Un elemento in un vettore frastagliato"
address@hidden example
+
+I termini @dfn{dimensione}, @dfn{riga} e @dfn{colonna} sono privi di
+significato quando sono applicati
+a questo tipo di vettore, ma d'ora in poi useremo ``dimensione'' per indicare
+il numero massimo di indici necessario per far riferimento a un elemento
+esistente. Il tipo di ogni elemento che @`e address@hidden stato assegnato non
address@hidden essere
+cambiato assegnando un valore di tipo diverso. Prima si deve eliminare
+l'elemento corrente, per togliere completamente dalla memoria di
address@hidden ogni riferimento a quell'indice:
+
address@hidden
+delete a[4]
+a[4][5][6][7] = "Un elemento in un vettore quadridimensionale"
address@hidden example
+
address@hidden
+Le due istruzioni rimuovono il valore scalare dall'indice @code{4} e
+inseriscono poi un
+sottovettore interno a tre indici contenente uno scalare. Si address@hidden
anche
+eliminare un intero sottovettore o un sottovettore di sottovettori:
+
address@hidden
+delete a[4][5]
+a[4][5] = "Un elemento nel sottovettore a[4]"
address@hidden example
+
+Si deve address@hidden ricordare che non @`e consentito eliminare il vettore
principale
address@hidden e poi usarlo come scalare.
+
+Le funzioni predefinite che accettano come argomenti dei vettori possono
+essere usate
+anche con i sottovettori. Per esempio, il seguente frammento di codice usa
address@hidden()} (@pxref{Funzioni per stringhe})
+per determinare il numero di elementi nel vettore principale @code{a}
+e nei suoi sottovettori:
+
address@hidden
+print length(a), length(a[1]), length(a[1][3])
address@hidden example
+
address@hidden
+Il risultato per il nostro vettore principale @code{a} @`e il seguente:
+
address@hidden
+2, 3, 1
address@hidden example
+
address@hidden
+L'espressione @address@hidden in @var{vettore}}
+(@pxref{Visitare elementi}) funziona allo stesso modo sia per
+i vettori regolari in stile @command{awk}
+che per i vettori di vettori. Per esempio, le espressioni @samp{1 in a},
address@hidden in a[1]} e @samp{(1, "nome") in a[1][3]} risultano tutte di
valore
+uno (vero) per il nostro vettore @code{a}.
+
+L'istruzione @samp{for (elemento in vettore)} (@pxref{Visitare un intero
vettore})
address@hidden essere nidificata per visitare tutti gli
+elementi di un vettore di vettori che abbia una struttura rettangolare. Per
+stampare il contenuto (valori scalari) di un vettore di vettori bidimensionale
+(address@hidden nel quale ogni elemento di primo livello @`e esso stesso un
+vettore, non necessariamente di lunghezza uguale agli altri)
+si address@hidden usare il seguente codice:
+
address@hidden
+for (i in vettore)
+ for (j in vettore[i])
+ print vettore[i][j]
address@hidden example
+
+La funzione @code{isarray()} (@pxref{Funzioni per i tipi})
+permette di verificare se un elemento di un vettore @`e esso stesso un vettore:
+
address@hidden
+for (i in vettore) @{
+ if (isarray(vettore[i]) @{
+ for (j in vettore[i]) @{
+ print vettore[i][j]
+ @}
+ @}
+ else
+ print vettore[i]
address@hidden
address@hidden example
+
+Se la struttura di un vettore di vettori frastagliato @`e nota in anticipo,
+si address@hidden spesso trovare il modo per visitarlo usando istruzioni di
controllo.
+Per esempio,
+il seguente codice stampa gli elementi del nostro vettore principale @code{a}:
+
address@hidden
+for (i in a) @{
+ for (j in a[i]) @{
+ if (j == 3) @{
+ for (k in a[i][j])
+ print a[i][j][k]
+ @} else
+ print a[i][j]
+ @}
address@hidden
address@hidden example
+
address@hidden
address@hidden vettori} per una funzione definita dall'utente che
+``visita'' un vettore di vettori di dimensioni arbitrarie.
+
+Si ricordi che un riferimento a un elemento di un vettore non
+inizializzato genera un elemento con valore uguale a @code{""}, la stringa
+nulla. Questo ha
+un'importante implicazione quando s'intende usare un sottovettore come
+argomento di una funzione, come illustrato nel seguente esempio:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ split("a b c d", b[1]); print b[1][1] @}'}
address@hidden gawk: riga com.:1: fatale: split: secondo argomento
address@hidden non-vettoriale
address@hidden example
+
+Il modo per aggirare quest'ostacolo @`e quello di definire prima @code{b[1]}
+come vettore creando un indice arbitrario:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ b[1][1] = ""; split("a b c d", b[1]); print b[1][1] @}'}
address@hidden a
address@hidden example
+
address@hidden Sommario dei vettori
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
address@hidden standard dispone di vettori associativi monodimensionali
+(vettori indicizzati da valori di tipo stringa). Tutti i vettori sono
+associativi; gli indici numerici vengono convertiti automaticamente in
+stringhe.
+
address@hidden
+Agli elementi dei vettori si fa riferimento come
address@hidden@address@hidden Fare riferimento a un elemento lo
+crea se questo non esiste ancora.
+
address@hidden
+Il modo corretto per vedere se un vettore ha un elemento con un dato indice
address@hidden quello di usare l'operatore @code{in}: @address@hidden in
@var{vettore}}.
+
address@hidden
+Si usa @samp{for (@var{indice} in @var{vettore}) @dots{}} per visitare
+ogni singolo elemento di un vettore. Nel corpo del ciclo,
address@hidden assume via via il valore dell'indice di ogni elemento del
vettore.
+
address@hidden
+L'ordine in cui il ciclo @samp{for (@var{indice} in @var{vettore})}
+attraversa un vettore non @`e definito in POSIX @command{awk} e varia a seconda
+dell'implementazione. @command{gawk} consente di controllare l'ordinamento
+di visita
+assegnando speciali valori predefiniti a @code{PROCINFO["sorted_in"]}.
+
address@hidden
+Si usa @samp{delete @address@hidden per eliminare un singolo
+elemento di un vettore.
+Per eliminare tutti gli elementi di un vettore,
+si usa @samp{delete @var{vettore}}.
+Quest'ultima address@hidden @`e stata per molti anni un'estensione comune
+e ora @`e standard, ma potrebbe non essere disponibile in tutte le
+versioni commerciali di @command{awk}.
+
address@hidden
address@hidden standard simula vettori multidimensionali ammettendo
address@hidden indici
+separati da virgole. I loro valori sono concatenati in un'unica
+stringa, separati dal valore di @code{SUBSEP}. Il modo di creazione
+dell'indice non viene immagazzinato; address@hidden@dotless{i}},
+cambiare @code{SUBSEP} potrebbe avere conseguenze inaspettate. Si
address@hidden usare
address@hidden(@var{sub1}, @var{sub2}, @dots{}) in @var{vettore}} per vedere se
+un certo indice multidimensionale esiste in @var{vettore}.
+
address@hidden
address@hidden consente di avere a disposizione veri vettori di vettori.
+Si usa una coppia
+di parentesi quadre per ogni dimensione in tali vettori:
address@hidden, per esempio. Gli elementi del vettore possono
+poi essere valori scalari (numeri o stringhe) o altri vettori.
+
address@hidden
+Si usa la funzione predefinita @code{isarray()} per determinare se un elemento
+di un vettore @`e esso stesso un sottovettore.
+
address@hidden itemize
+
address@hidden Funzioni
address@hidden Funzioni
+
address@hidden funzioni predefinite
address@hidden predefinite, funzioni
+Questo @value{CHAPTER} descrive le funzioni predefinite di @command{awk},
+che sono di tre tipi: numeriche, di stringa, e di I/O.
address@hidden mette a disposizione ulteriori tipi di funzioni
+per gestire valori che rappresentano marcature temporali, per manipolare bit,
per
+ordinare vettori, per fornire informazioni sui tipi di variabile,
+per internazionalizzare e localizzare i address@hidden
+un'introduzione alle tematiche suddette, si address@hidden consultare
l'articolo
+"Localizzazione dei programmi" nel
address@hidden://www.pluto.it/files/journal/pj0404/l10n.html, sito pluto.it.}}
+
+Oltre alle funzioni predefinite, @command{awk} consente di
+scrivere nuove funzioni utilizzabili all'interno di un programma.
+La seconda address@hidden di questo @value{CHAPTER} descrive le funzioni
address@hidden dall'utente}.
+Vengono infine descritte le chiamate indirette a una funzione, un'estensione
+specifica di @command{gawk} che consente di stabilire durante l'esecuzione del
+programma quale funzione chiamare.
+
address@hidden
+* Funzioni predefinite:: Riepilogo delle funzioni predefinite.
+* Funzioni definite dall'utente:: Descrizione dettagliata delle funzioni
+ definite dall'utente.
+* Chiamate indirette:: Scegliere la funzione da chiamare in
+ fase di esecuzione del programma.
+* Sommario delle funzioni:: Sommario delle funzioni.
address@hidden menu
+
address@hidden Funzioni predefinite
address@hidden Funzioni predefinite
+
+Le funzioni @dfn{predefinite} sono sempre disponibili per essere chiamate
+da un programma @command{awk}. Questa @value{SECTION} definisce tutte le
+funzioni predefinite di @command{awk}; di alcune di queste si fa menzione
+in altre @value{SECTIONS},
+ma sono comunque riassunte anche qui per address@hidden
+
address@hidden
+* Chiamare funzioni predefinite:: Come chiamare funzioni predefinite.
+* Funzioni numeriche:: Funzioni che trattano numeri, comprese
+ @code{int()}, @code{sin()} e @code{rand()}.
+* Funzioni per stringhe:: Funzioni di manipolazione di stringhe,
+ come @code{split()}, @code{match()}
+ e @code{sprintf()}.
+* Funzioni di I/O:: Funzioni per i file e per i comandi
+ della shell.
+* Funzioni di tempo:: Funzione per gestire marcature temporali.
+* Funzioni a livello di bit:: Funzioni per operazioni di
+ manipolazione bit.
+* Funzioni per i tipi:: Funzioni per informazioni sul tipo
+ di una variabile.
+* Funzioni di internazionalizzazione:: Funzioni per tradurre stringhe.
address@hidden menu
+
address@hidden Chiamare funzioni predefinite
address@hidden Chiamare funzioni predefinite
+
+Per chiamare una delle funzioni predefinite di @command{awk},
+si scrive il nome della funzione seguito dai suoi argomenti racchiusi
+tra parentesi. Per esempio, @samp{atan2(y + z, 1)}
address@hidden una chiamata alla funzione @code{atan2()} e ha due argomenti.
+
address@hidden convenzioni di programmazione, nelle chiamate di funzione
address@hidden spazio bianco, nelle chiamate di funzione
+La presenza di spazi bianchi tra il nome della funzione predefinita
+e la parentesi aperta @`e consentita, ma @`e buona norma quella di evitare
+di inserire spazi bianchi in quella posizione.
+Le funzioni definite dall'utente non consentono che vi siano spazi bianchi
+fra nome funzione e aperta parentesi,
+ed @`e address@hidden semplice evitare errori seguendo una semplice
convenzione che
+resta sempre valida: non inserire spazi dopo il nome di una funzione.
+
address@hidden risoluzione di problemi, @command{gawk}, errori address@hidden
argomenti di funzione e
address@hidden problemi, risoluzione di, @command{gawk}, errori address@hidden
argomenti di funzione e
address@hidden @command{gawk}, argomenti di funzione e
address@hidden differenze tra @command{awk} e @command{gawk}, argomenti di
funzione (@command{gawk})
+Ogni funzione predefinita accetta un certo numero di argomenti.
+In alcuni casi, gli argomenti possono essere omessi. I valori di default per
+gli argomenti omessi variano
+da funzione a funzione e sono descritti insieme a
+ciascuna funzione. In alcune implementazioni di @command{awk}, gli
+eventuali argomenti in address@hidden specificati per le funzioni predefinite
sono
+ignorati. Tuttavia, in @command{gawk},
address@hidden un errore fatale fornire argomenti in address@hidden a una
funzione predefinita.
+
+Quando si richiama una funzione viene calcolato, prima di effettuare la
+chiamata, il valore assunto dalle espressioni che descrivono i parametri
+da passare alla funzione.
+Per esempio, nel seguente frammento di codice:
+
address@hidden
+i = 4
+j = sqrt(i++)
address@hidden example
+
address@hidden ordine di valutazione, funzioni
address@hidden funzioni predefinite, ordine di valutazione
address@hidden predefinite, funzioni, ordine di valutazione
address@hidden
+la variabile @code{i} @`e incrementata al valore cinque prima di chiamare
+la funzione @code{sqrt()} alla quale viene fornito come parametro il valore
+quattro.
+L'ordine di valutazione delle espressioni usate come parametri per la
+funzione @`e indefinito. Per questo motivo, si deve evitare di scrivere
+programmi che presuppongono che i parametri siano valutati da sinistra a
+destra o da destra a sinistra. Per esempio:
+
address@hidden
+i = 5
+j = atan2(++i, i *= 2)
address@hidden example
+
+Se l'ordine di valutazione @`e da sinistra a destra, @code{i} assume dapprima
+il valore 6, e quindi il valore 12, e la funzione @code{atan2()} @`e chiamata
+con i due argomenti 6 e 12. Ma se l'ordine di valutazione @`e da destra a
+sinistra, @code{i} assume dapprima il valore 10, e poi il valore 11, e la
+funzione @code{atan2()} @`e chiamata con i due argomenti 11 e 10.
+
address@hidden Funzioni numeriche
address@hidden Funzioni numeriche
address@hidden funzioni numeriche
address@hidden numeriche, funzioni
+
+La seguente lista descrive tutte le
+funzioni predefinite che hanno a che fare con i numeri.
+I parametri facoltativi sono racchiusi tra parentesi address@hidden ([ ]):}
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{atan2(@var{y}, @var{x})}
address@hidden
address@hidden arcotangente
+Restituisce l'arcotangente di @address@hidden / @var{x}} in radianti.
+Si address@hidden usare @samp{pi = atan2(0, -1)} per ottenere il valore di
address@hidden greco.
+
address@hidden @code{cos(@var{x})}
address@hidden
address@hidden coseno
+Restituisce il coseno di @var{x}, con @var{x} in radianti.
+
address@hidden @code{exp(@var{x})}
address@hidden
address@hidden esponenziale
+Restituisce l'esponenziale di @var{x} (@code{e ^ @var{x}}) o un messaggio
+di errore se @var{x} @`e fuori dall'intervallo consentito.
+L'intervallo entro il quale address@hidden variare @var{x}
+dipende dalla rappresentazione dei numeri in virgola mobile nella macchina in
+uso.
+
address@hidden @code{int(@var{x})}
address@hidden
address@hidden arrotondamento all'intero address@hidden vicino
+Restituisce l'intero address@hidden vicino a @var{x}, situato tra @var{x} e
zero,
+troncato togliendo i decimali.
+Per esempio, @code{int(3)} @`e 3, @code{int(3.9)} @`e 3, @code{int(-3.9)}
address@hidden @minus{}3, e @code{int(-3)} @`e ancora @minus{}3.
+
address@hidden @code{intdiv(@var{numeratore}, @var{denominatore},
@var{risultato})}
address@hidden
address@hidden funzione @code{intdiv}
+Esegue una divisione tra numeri interi, simile alla funzione standard C
+che ha lo stesso nome. Dapprima, il @code{numeratore} e il
address@hidden vengono troncati, eliminando la parte decimale,
+per trasformarli in numeri interi.
+Il vettore @code{risultato} viene dapprima svuotato, e poi viene impostato
+l'elemento @code{risultato["quotient"]} al risultato della divisione
address@hidden / denominatore}, troncato a numero intero
+mediante l'eliminazione dei decimali,
+e viene impostato l'elemento @code{risultato["remainder"]} al
+risultato dell'operazione @samp{numeratore % denominatore}, troncato a
+numero intero allo stesso modo del risultato. Questa funzione @`e
+rivolta principalmente a chi usa numeri interi di lunghezza arbitraria;
+consente di evitare la creazione di numeri in virgola mobile
+di precisione arbitaria usando la address@hidden MPFR
+(@pxref{Interi a precisione arbitraria}).
+
+Questa funzione @`e un'estensione @code{gawk}. Non @`e disponibile in
address@hidden compatibile (@pxref{Opzioni}).
+
address@hidden @code{log(@var{x})}
address@hidden
address@hidden logaritmo
+Restituisce il logaritmo naturale di @var{x}, se @var{x} @`e positivo;
+altrimenti, restituisce @code{NaN} (``not a number'') sui sistemi che
+implementano lo standard IEEE 754.
+Inoltre, @command{gawk} stampa un messaggio di avvertimento qualora @code{x}
+sia negativo.
+
address@hidden @code{rand()}
address@hidden
address@hidden numeri casuali, funzioni @code{rand()}/@code{srand()}
+Restituisce un numero casuale. I valori di @code{rand()} sono
+uniformemente distribuiti tra zero e uno.
+Il valore potrebbe essere zero ma non @`e mai address@hidden versione C di
address@hidden()} in molti sistemi Unix
+produce notoriamente delle sequenze piuttosto mediocri di numeri casuali.
+Tuttavia, non @`e prescritto che un'implementazione di @command{awk}
+debba usare la funzione @code{rand()} del linguaggio C per implementare
+la versione @command{awk} di @code{rand()}.
+In effetti, @command{gawk} usa, per generare numeri casuali,
+la funzione @code{random()} di BSD, che @`e
+notevolmente migliore di @code{rand()}}
+
+Spesso servono dei numeri casuali interi invece che frazionari.
+La seguente funzione definita dall'utente address@hidden essere usata per
ottenere
+un numero casuale non negativo inferiore a @var{n}:
+
address@hidden
+function randint(n)
address@hidden
+ return int(n * rand())
address@hidden
address@hidden example
+
address@hidden
+La moltiplicazione produce un numero casuale maggiore o uguale a zero e
+minore di @code{n}. Tramite @code{int()}, questo risultato diventa
+un intero tra zero e @code{n} @minus{} 1, estremi inclusi.
+
+Il seguente esempio usa una funzione simile per generate interi casuali
+fra uno e @var{n}. Il programma stampa un numero casuale per
+ogni record in input:
+
address@hidden
+# funzione per simulare un tiro di dado.
+function roll(n) @{ return 1 + int(rand() * n) @}
+
+# Tira 3 dadi a sei facce e
+# stampa il numero di punti.
address@hidden
+ printf("%d punteggio\n", roll(6) + roll(6) + roll(6))
address@hidden
address@hidden example
+
address@hidden inizializzazione generazione di numeri casuali
address@hidden numeri casuali, inizializzazione generazione di
address@hidden numeri casuali, seme di
address@hidden ATTENZIONE
+Nella maggior parte delle implementazioni di @command{awk}, compreso
address@hidden,
address@hidden()} inizia a generare numeri casuali partendo sempre
+dallo stesso numero, o @dfn{seme}, per ogni invocazione di
address@hidden@address@hidden
+usa un seme differente ogni volta.} @`E per questo motivo che
+un programma genera sempre gli stessi risultati ogni volta che lo si esegue.
+I numeri sono casuali all'interno di una singola esecuzione di @command{awk}
+ma "prevedibili" in ogni successiva esecuzione.
address@hidden torna utile in fase di test, ma se si desidera che
+un programma generi sequenze differenti di numeri casuali ogni volta
+che @`e chiamato, occorre impostare il seme a un valore che cambi
+per ogni esecuzione. Per fare questo, @`e prevista la funzione @code{srand()}.
address@hidden quotation
+
address@hidden @code{sin(@var{x})}
address@hidden
address@hidden seno
+Restituisce il seno di @var{x}, con @var{x} espresso in radianti.
+
address@hidden @code{sqrt(@var{x})}
address@hidden
address@hidden radice quadrata
+Restituisce la radice quadrata positiva di @var{x}.
address@hidden stampa un messaggio di avvertimento
+se @var{x} @`e un numero negativo. Quindi, @code{sqrt(4)} vale 2.
+
address@hidden @code{srand(address@hidden@code{)}
address@hidden
+Imposta al valore @var{x} il numero di partenza, o seme,
+utilizzato per generare numeri casuali.
+
+Ogni seme genera una sequenza particolare di numeri address@hidden
+numeri casuali generati da un computer non sono veramente casuali.
+Tecnicamente sono conosciuti come numeri @dfn{pseudo-casuali}. address@hidden
vuol dire
+che, anche se i numeri in una sequenza sembrano casuali, @`e possibile
+in address@hidden generare la stessa sequenza di numeri casuali address@hidden
e address@hidden volte.}
+Quindi, impostando il seme allo stesso valore una seconda volta,
+viene prodotta ancora la stessa sequenza di numeri casuali.
+
address@hidden ATTENZIONE
+Differenti implementazioni di @command{awk} usano internamente differenti
+generatori di numeri casuali. Non si deve dare per scontato che lo stesso
+programma @command{awk}
+generi la stessa serie di numeri casuali se viene eseguito da differenti
+versioni di @command{awk}.
address@hidden quotation
+
+Se si omette l'argomento @var{x}, scrivendo @samp{srand()}, viene usato
+come seme la data e ora corrente. @`E questo il modo per ottenere numeri
+casuali che sono veramente imprevedibili.
+
+Il valore restituito da @code{srand()} @`e quello del seme precedente.
+Questo per facilitare il monitoraggio dei semi, nel caso occorra riprodurre
+in maniera coerente delle sequenze di numeri casuali.
+
+POSIX non specifica quale debba essere il seme iniziale, che quindi varia
+a seconda delle implementazioni @command{awk}.
address@hidden table
+
address@hidden Funzioni per stringhe
address@hidden Funzioni di manipolazione di stringhe
address@hidden funzioni di manipolazione di stringhe
+
+Le funzioni in questa @value{SECTION} leggono o modificano il testo di
+una o address@hidden stringhe.
+
address@hidden implementa la localizzazione
+(@pxref{Localizzazioni}) ed effettua
+ogni manipolazione di stringhe trattando ogni singolo @emph{carattere}, non
+ogni singolo @emph{byte}.
+Questa distinzione @`e particolarmente importante da comprendere per
+quelle localizzazioni in cui un singolo carattere address@hidden essere
rappresentato
+da address@hidden di un byte.
+Quindi, per esempio, la funzione @code{length()} restituisce il numero di
+caratteri in una stringa, e non il numero di byte usato per rappresentare quei
+caratteri. Allo stesso modo, @code{index()} restituisce indici di caratteri, e
+non indici di byte.
+
address@hidden ATTENZIONE
+Un certo numero di funzioni riguarda indici all'interno di stringhe. Per
+queste funzioni, il primo carattere di una stringa @`e alla posizione
+(all'indice) uno. Questo comportamento @`e differente da quello del C e dei
+linguaggi che da esso discendono, nei quali il primo carattere @`e alla
posizione
+zero. @`E importante ricordarlo quando si fanno calcoli sugli indici, in
+particolare se si ha address@hidden con il linguaggio C.
address@hidden quotation
+
+Nella lista seguente, i parametri facoltativi sono racchiusi tra parentesi
address@hidden ([ ]).}
+Parecchie funzioni operano sostituzioni in una stringa; la spiegazione
+completa di address@hidden @`e contenuta nella descrizione della funzione
@code{sub()},
+che si trova quasi alla fine di questa lista, ordinata alfabeticamente.
+
+Le funzioni specifiche di @command{gawk} sono contrassegnate col simbolo
+del cancelletto (@samp{#}). Tali funzioni non sono disponibili in
address@hidden
+compatibile (@pxref{Opzioni}):
+
+
address@hidden
+* Dettagli ostici:: address@hidden di quel che si vorrebbe sapere su
@samp{\}
+ e @samp{&} con @code{sub()}, @code{gsub()}, e
+ @code{gensub()}.
address@hidden menu
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{asort(address@hidden address@hidden,} @var{destinazione}
address@hidden,} @var{come} ] address@hidden) #}
address@hidden @code{asorti(address@hidden address@hidden,} @var{destinazione}
address@hidden,} @var{come} ] address@hidden) #}
address@hidden
address@hidden vettori, ordinamento dei
address@hidden ordinamento di vettori
address@hidden vettori, determinare il numero degli elementi
address@hidden
address@hidden ordinamento vettori per indici
address@hidden vettori, ordinamento per indici
address@hidden indici di vettori, ordinamento per
+Queste due funzioni sono abbastanza simili, e quindi sono descritte
+insieme.
+
address@hidden NOTA
+La seguente descrizione ignora il terzo argomento, @var{come}, perch@'e
+richiede la conoscenza di address@hidden di cui non si @`e ancora parlato. Per
+questo motivo la seguente trattazione @`e volutamente semplificata. (In
seguito
+l'argomento address@hidden trattato in maniera address@hidden esauriente; si
veda @ref{Funzioni di
+ordinamento di vettori} per la descrizione completa.)
address@hidden quotation
+
+Entrambe le funzioni restituiscono il numero di elementi nel vettore
@var{sorgente}.
+Con @command{asort()}, @command{gawk} ordina i valori di @var{sorgente}
+e rimpiazza gli indici dei valori ordinati di @var{sorgente} con
+numeri interi sequenziali, a partire da uno. Se si specifica il vettore
+opzionale @var{destinazione},
address@hidden @`e copiato in @var{destinazione}. @var{destinazione}
+viene quindi ordinato, lasciando immodificati gli indici di @var{sorgente}.
+
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
+Nel confronto tra stringhe, la variabile @code{IGNORECASE} influenza
+l'ordinamento
+(@pxref{Funzioni di ordinamento di vettori}). Se il vettore
address@hidden contiene sottovettori come valori
+(@pxref{Vettori di vettori}), questi saranno alla fine, dopo tutti i valori
+scalari.
+I sottovettori @emph{non} vengono ordinati ricorsivamente.
+
+Per esempio, se i contenuti del vettore @code{a} sono i seguenti:
+
address@hidden
+a["ultimo"] = "de"
+a["primo"] = "sac"
+a["mediano"] = "cul"
address@hidden example
+
address@hidden
+Una chiamata a @code{asort()}:
+
address@hidden
+asort(a)
address@hidden example
+
address@hidden
+genera i seguenti contenuti di @code{a}:
+
address@hidden
+a[1] = "cul"
+a[2] = "de"
+a[3] = "sac"
address@hidden example
+
+La funzione @code{asorti()} si comporta in maniera simile ad @code{asort()};
+tuttavia l'ordinamento avviene in base agli @emph{indici}, e non in base ai
+valori. Quindi, nell'esempio seguente, a partire dallo stesso insieme iniziale
+di indici e valori nel vettore @code{a}, la chiamata di @samp{asorti(a)}
+produrrebbe:
+
address@hidden
+a[1] = "mediano"
+a[2] = "primo"
+a[3] = "ultimo"
address@hidden example
+
address@hidden @code{gensub(@var{regexp}, @var{rimpiazzo}, @var{come}}
address@hidden, @address@hidden) #}
address@hidden
address@hidden cercare e rimpiazzare in stringhe
address@hidden sostituzione in stringa
+Ricerca nella stringa @var{obiettivo} delle corrispondenze
+all'espressione regolare @var{regexp}.
+Se @var{come} @`e una stringa che inizia
+con @samp{g} o @samp{G} (abbreviazione di ``global''), sostituisce
+ogni occorrenza di @var{regexp} con la stringa
address@hidden Altrimenti, @var{come} @`e visto come un numero che indica
+quale corrispondenza di @var{regexp} va rimpiazzata. Se non si specifica
+il nome dell'@var{obiettivo}, si
+opera su @code{$0}. La funzione restituisce come risultato la stringa
+modificata, e la stringa originale di partenza @emph{non} viene modificata.
+
address@hidden()} @`e una funzione generale di sostituzione. Mira a fornire
address@hidden address@hidden rispetto alle funzioni standard @code{sub()} e
address@hidden()}.
+
address@hidden()} prevede una address@hidden ulteriore, non disponibile in
address@hidden()} o @code{gsub()}: la address@hidden di specificare componenti
di
+una @dfn{regexp} nel testo da sostituire. Questo @`e fatto utilizzando delle
+parentesi nella @dfn{regexp} per designare i componenti, e quindi inserendo
address@hidden@var{N}} nel testo di rimpiazzo, dove @var{N} @`e una cifra da 1
a 9.
+Per esempio:
+
address@hidden
+$ @kbd{gawk '}
+> @kbd{BEGIN @{}
+> @kbd{a = "abc def"}
+> @kbd{b = gensub(/(.+) (.+)/, "\\2 \\1", "g", a)}
+> @kbd{print b}
+> @address@hidden'}
address@hidden def abc
address@hidden example
+
address@hidden
+Come con @code{sub()}, occorre battere due barre inverse, per ottenerne
+una come componente della stringa.
+Nel testo di rimpiazzo, la sequenza @samp{\0} rappresenta l'intero testo
+corrispondente, e lo stesso vale per
+il carattere @samp{&}.
+
+Il seguente esempio mostra come @`e possibile usare il terzo argomento
+per controllare quale corrispondenza
+della @dfn{regexp} sia da modificare:
+
address@hidden
+$ @kbd{echo a b c a b c |}
+> @kbd{gawk '@{ print gensub(/a/, "AA", 2) @}'}
address@hidden a b c AA b c
address@hidden example
+
+In questo caso, @code{$0} @`e la stringa obiettivo di default.
address@hidden()} restituisce la nuova stringa come risultato, e questa
address@hidden passata direttamente a @code{print} per essere stampata.
+
address@hidden @cindex avvertimenti automatici
address@hidden @cindex automatici, avvertimenti
+Se l'argomento @var{come} @`e una stringa che non inizia con @samp{g} o
address@hidden, o se @`e un numero minore o uguale a zero, si effettua solo una
+sostituzione. Se @var{come} @`e zero, @command{gawk} emette
+un messaggio di avvertimento.
+
+Se @var{regexp} non viene trovata in @var{obiettivo}, il valore
+restituito da @code{gensub()}
address@hidden il valore originale e non modificato di @var{obiettivo}.
+
address@hidden @code{gsub(@var{regexp}, @var{rimpiazzo}} address@hidden,
@address@hidden)}
address@hidden
+Ricerca in @var{obiettivo}
address@hidden le sottostringhe corrispondenti al criterio di ricerca, le
address@hidden lunghe possibili partendo da sinistra, @emph{non sovrapposte tra
loro},
+e le sostituisce con @var{rimpiazzo}.
+La lettera @samp{g} in @code{gsub()} significa
+``global'', e richiede di sostituire dappertutto. Per esempio:
+
address@hidden
address@hidden gsub(/Inghilterra/, "Regno Unito"); print @}
address@hidden example
+
address@hidden
+sostituisce tutte le occorrenze della stringa @samp{Inghilterra} con
address@hidden Unito} in tutti i record in input.
+
+La funzione @code{gsub()} restituisce il numero di sostituzioni effettuate.
+Se la variabile da cercare e modificare (@var{obiettivo}) @`e omessa,
+viene usato l'intero record in input.
+Come in @code{sub()}, i caratteri @samp{&} e @samp{\} sono speciali,
+e il terzo argomento dev'essere modificabile.
+
address@hidden @code{index(@var{dove}, @var{cosa})}
address@hidden
address@hidden ricerca in stringhe
address@hidden trovare sottostringhe in una stringa
+Ricerca nella stringa @var{dove} la prima occorrenza della stringa @var{cosa},
+e restituisce la posizione in caratteri dell'inizio di quest'occorrenza nella
+stringa @var{dove}. Si consideri il seguente esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{ print index("noccioline", "oli") @}'}
address@hidden 6
address@hidden example
+
address@hidden
+Se @var{cosa} non viene trovato, @code{index()} restituisce zero.
+
address@hidden angolo buio, @dfn{regexp} come secondo argomento di
@code{index()}
+In BWK @command{awk} e @command{gawk},
address@hidden un errore fatale usare una costante @dfn{regexp} per @var{cosa}.
+Altre implementazioni lo consentono, considerando semplicemente
+la costante @dfn{regexp} come un'espressione che significa
address@hidden ~ /@dfn{regexp}/}. @value{DARKCORNER}
+
address@hidden @code{length(address@hidden@code{)}
address@hidden
address@hidden stringa, lunghezza di una
address@hidden lunghezza di una stringa
+Restituisce il numero di caratteri in @var{stringa}. Se
address@hidden @`e un numero, viene restituita la lunghezza della stringa
+di cifre che rappresenta quel numero. Per esempio, @code{length("abcde")} @`e
+cinque.
+Invece, @code{length(15 * 35)} restituisce tre. In questo esempio,
address@hidden
address@hidden @cdot 35 = 525},
address@hidden iftex
address@hidden
address@hidden
+15 * 35 = 525,
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+15 ⋅ 35 = 525,
address@hidden docbook
+e 525 @`e quindi convertito alla stringa @code{"525"}, che @`e composta da
+tre caratteri.
+
address@hidden lunghezza di un record in input
address@hidden record in input, lunghezza di un
+Se non si specifica alcun argomento, @code{length()} restituisce la
+lunghezza di @code{$0}.
+
address@hidden @cindex historical features
address@hidden address@hidden, funzione @code{length()}
address@hidden POSIX @command{awk}, funzione @code{length()} e
address@hidden NOTA
+In alcune delle prime versioni di @command{awk}, la funzione @code{length()}
+poteva essere richiamata senza alcuna parentesi. Farlo @`e considerata
+una cattiva abitudine, sebbene il POSIX standard 2008 lo consenta
esplicitamente,
+per address@hidden con la vecchia prassi. Per garantire la massima
address@hidden ai programmi, @`e meglio mettere sempre le parentesi.
address@hidden quotation
+
address@hidden angolo buio, funzione @code{length()}
+Se @code{length()} @`e chiamata con una variabile che non @`e stata usata,
address@hidden considera la variabile come uno scalare. Altre
+implementazioni di @command{awk} non assegnano nessun tipo alla variabile.
address@hidden
+Si consideri:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print length(x) ; x[1] = 1 @}'}
address@hidden 0
address@hidden gawk: riga com.:1: fatale: tentativo di usare
address@hidden scalare 'x' come vettore
+
+$ @kbd{nawk 'BEGIN @{ print length(x) ; x[1] = 1 @}'}
address@hidden 0
address@hidden example
+
address@hidden
+Se @option{--lint} @`e
+stato specificato sulla riga di comando, @command{gawk} emette un
+avvertimento a questo riguardo.
+
address@hidden estensioni comuni, @code{length()} applicato a un vettore
address@hidden comuni, address@hidden @code{length()} applicato a un vettore
address@hidden differenze tra @command{gawk} e @command{awk}
address@hidden numero di elementi di un vettore
address@hidden vettore, determinare il numero degli elementi
+In @command{gawk} e in parecchie altre implementazioni @command{awk},
+se l'argomento @`e un vettore, la funzione @code{length()} restituisce il
numero
+di elementi nel vettore. @value{COMMONEXT}
address@hidden @`e meno utile di quel che sembra a prima vista, in quanto
+non @`e affatto detto che il vettore abbia come indici i numeri da 1 al
+numero di elementi che contiene.
+Se @option{--lint} @`e
+stato specificato sulla riga di comando,
+(@pxref{Opzioni}),
address@hidden avvisa che l'uso di un vettore come argomento non
address@hidden portabile.
+Se si specifica l'opzione @option{--posix}, l'uso di un vettore come
+argomento genera un errore fatale
address@hidden
+(@pxrefil{Vettori}).
address@hidden iftex
address@hidden
+(@pxref{Vettori}).
address@hidden ifnottex
+
address@hidden @code{match(@var{stringa}, @var{regexp}} address@hidden,
@address@hidden)}
address@hidden
address@hidden stringa, ricercare espressioni regolari in una
address@hidden ricerca @dfn{regexp} in stringhe
+Ricerca in @var{stringa} la
+sottostringa address@hidden lunga, a partire da sinistra, che corrisponde
+all'espressione regolare @var{regexp} e restituisce la posizione
+del carattere (indice) con cui inizia la sottostringa (uno, se
+la corrispondenza parte dall'inizio di @var{stringa}). Se non viene
+trovata alcuna corrispondenza, restituisce zero.
+
+L'argomento @var{regexp} address@hidden essere sia una costante @dfn{regexp}
+(@code{/address@hidden@code{/}) che una costante stringa
(@code{"address@hidden@code{"}).
+In quest'ultimo caso, la stringa @`e trattata come una @dfn{regexp}
+per la quale cercare una corrispondenza.
address@hidden regolari calcolate} per una
+spiegazione sulla differenza tra le due forme e sulle loro
+implicazioni riguardo al modo per scrivere correttamente un programma.
+
+L'ordine dei primi due argomenti @`e l'opposto di molte altre funzioni che
+trattano stringhe e che hanno a che fare con espressioni regolari, come
address@hidden()} e @code{gsub()}. Potrebbe essere di aiuto ricordare che
+per @code{match()}, l'ordine @`e lo stesso che per l'operatore @samp{~} :
address@hidden@var{stringa} ~ @var{regexp}}.
+
address@hidden @code{RSTART}, variabile, funzione @code{match()} e
address@hidden variabile @code{RSTART}, funzione @code{match()} e
address@hidden @code{RLENGTH}, variabile, funzione @code{match()} e
address@hidden variabile @code{RLENGTH}, funzione @code{match()} e
address@hidden funzione @code{match()}, variabili @code{RSTART}/@code{RLENGTH}
address@hidden @code{match()}, funzione, variabili @code{RSTART}/@code{RLENGTH}
+La funzione @code{match()} imposta la variabile predefinita @code{RSTART}
+all'indice.
+Imposta anche la variabile predefinita @code{RLENGTH} alla
+lunghezza in caratteri della sottostringa individuata. Se non viene
+trovata alcuna corrispondenza, @code{RSTART} @`e impostata a zero, e
address@hidden a @minus{}1.
+
+Per esempio:
+
address@hidden
address@hidden file eg/misc/findpat.awk
address@hidden
+ if ($1 == "TROVA")
+ regexp = $2
+ else @{
+ dove = match($0, regexp)
+ if (dove != 0)
+ print "Corrispondenza di", regexp, "alla posiz.", \
+ dove, "in", $0
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Questo programma ricerca delle righe che corrispondono all'espressione
+regolare contenuta nella variabile
address@hidden Quest'espressione regolare address@hidden essere modificata.
Se la
+prima parola in una riga @`e @samp{TROVA}, @code{regexp} diventa la
+seconda parola su quella riga. Quindi, dato:
+
address@hidden
address@hidden file eg/misc/findpat.data
+TROVA or+e
+Il mio programma corre
+ma non troppo velocemente
+TROVA Melvin
+JF+KM
+Questa riga appartiene a Reality Engineering Co.
+Melvin @`e passato da qui.
address@hidden endfile
address@hidden example
+
address@hidden
address@hidden stampa:
+
address@hidden
+Corrispondenza di or+e alla posiz. 19 in Il mio programma corre
+Corrispondenza di Melvin alla posiz. 1 in Melvin @`e passato da qui.
address@hidden example
+
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{match()}
+Se @var{vettore} esiste address@hidden, viene cancellato, e quindi l'elemento
numero
+zero di @var{vettore} @`e impostato all'intera parte di @var{stringa}
+individuata da @var{regexp}. Se @var{regexp} contiene parentesi,
+gli elementi aventi per indici numeri interi in @var{vettore} sono
+impostati per contenere ognuno la parte di @var{stringa} individuata dalla
+corrispondente sottoespressione delimitata da parentesi.
+Per esempio:
+
address@hidden
+$ @kbd{echo pippoooopaperpluttttttt |}
+> @kbd{gawk '@{ match($0, /(pippo+).+(plut*)/, vett)}
+> @kbd{print vett[1], vett[2] @}'}
address@hidden pippoooo pluttttttt
address@hidden example
+
+Inoltre,
+sono disponibili indici multidimensionali che contengono
+la posizione di partenza e la lunghezza di ogni sottoespressione
+individuata:
+
address@hidden
+$ @kbd{echo pippoooopaperpluttttttt |}
+> @kbd{gawk '@{ match($0, /(pippo+).+(plut*)/, vett)}
+> @kbd{print vett[1], vett[2]}
+> @kbd{print vett[1, "start"], vett[1, "length"]}
+> @kbd{print vett[2, "start"], vett[2, "length"]}
+> @address@hidden'}
address@hidden pippoooo pluttttttt
address@hidden 1 8
address@hidden 14 10
address@hidden example
+
+Possono non esserci indici che individuino inizio e posizione
+per ogni sottoespressione
+fra parentesi, perch@'e non tutte potrebbero aver individuato del testo;
+quindi, andrebbero esaminati usando l'operatore @code{in}
+(@pxref{Visitare elementi}).
+
address@hidden risoluzione di problemi, funzione @code{match()}
address@hidden problemi, risoluzione di, funzione @code{match()}
+L'argomento @var{vettore} di @code{match()} @`e un'estensione
address@hidden In address@hidden compatibile
+(@pxref{Opzioni}),
+l'impiego di un terzo argomento causa un errore fatale.
+
address@hidden @code{patsplit(@var{stringa}, @var{vettore}} address@hidden,
@var{regexpdelim}} address@hidden, @var{separatori}} ] address@hidden) #}
address@hidden
address@hidden dividere in un vettore una stringa
address@hidden creare un vettore da una stringa
+Divide
address@hidden in parti definite da @var{regexpdelim}
+e memorizza i pezzi in @var{vettore} e le stringhe di separazione nel
+vettore @var{separatori}. Il primo pezzo @`e memorizzato in
address@hidden@var{vettore}[1]}, il secondo pezzo in @address@hidden, e
address@hidden@dotless{i}} via. Il terzo argomento, @var{regexpdelim}, @`e
+una @dfn{regexp} che descrive i campi in @var{stringa} (allo stesso modo in
+cui @code{FPAT} @`e una @dfn{regexp} che descrive i campi nei record
+in input).
address@hidden essere una costante @dfn{regexp} o una stringa.
+Se @var{regexpdelim} @`e omesso, viene usato il valore di @code{FPAT}.
address@hidden()} restituisce il numero di elementi creati.
address@hidden@address@hidden @`e
+la stringa che separa
+l'elemento @address@hidden@var{i}]} e @address@hidden@var{i}+1]}.
+Ogni separatore iniziale address@hidden in @address@hidden
+
+La funzione @code{patsplit()} divide delle stringhe in pezzi in modo
+simile a quello con cui le righe in input vengono divise in campi
+usando @code{FPAT}
+(@pxref{Separazione in base al contenuto}).
+
+Prima di dividere la stringa, @code{patsplit()} cancella ogni elemento che
+fosse eventualmente presente
+nei vettori @var{vettore} e @var{separatori}.
+
address@hidden @code{split(@var{stringa}, @var{vettore}} address@hidden,
@var{separacampo}} address@hidden, @var{separatori}} ] address@hidden)}
address@hidden
+Divide @var{stringa} in pezzi separati da @var{separacampo}
+e memorizza i pezzi in @var{vettore} e le stringhe di separazione nel
+vettore @var{separatori}. Il primo pezzo @`e memorizzato in
address@hidden@var{vettore}[1]}, il secondo pezzo in @address@hidden, e
address@hidden@dotless{i}} via. Il valore della stringa specificata nel terzo
argomento,
address@hidden, @`e una @dfn{regexp} che indica come dividere @var{stringa}
+(analogamente a come @code{FS} address@hidden essere un @dfn{regexp} che
indica dove
+dividere i record in input).
+Se @var{separacampo} @`e omesso, si usa il valore di @code{FS}.
address@hidden()} restituisce il numero di elementi creati.
address@hidden @`e un'estensione @command{gawk}, in cui
address@hidden@address@hidden
address@hidden la stringa che separa @address@hidden@var{i}]} e
address@hidden@address@hidden
+Se @var{separacampo} @`e uno spazio bianco, ogni eventuale spazio bianco
+a inizio stringa viene messo in @address@hidden e ogni
+eventuale spazio bianco a fine stringa viene messo in
address@hidden@address@hidden, dove @var{n} @`e il valore restituito da
address@hidden()} (address@hidden il numero di elementi in @var{vettore}).
+
+La funzione @code{split()} divide le stringhe in pezzi in modo simile
+a quello con cui le righe in input sono divise in campi. Per esempio:
+
address@hidden
+split("cul-de-sac", a, "-", separatori)
address@hidden example
+
address@hidden
address@hidden stringhe, divisione, esempio
+divide la stringa @code{"cul-de-sac"} in tre campi usando @samp{-} come
+separatore. Il vettore @code{a} ha i seguenti contenuti:
+
address@hidden
+a[1] = "cul"
+a[2] = "de"
+a[3] = "sac"
address@hidden example
+
+e imposta il contenuto del vettore @code{separatori} come segue:
+
address@hidden
+seps[1] = "-"
+seps[2] = "-"
address@hidden example
+
address@hidden
+Il valore restituito da questa chiamata a @code{split()} @`e tre.
+
address@hidden differenze tra @command{awk} e @command{gawk}, funzione
@code{split()}
+Come nella divisione in campi dei record in input, quando il valore di
address@hidden @`e @address@hidden" "}}, gli spazi bianchi a inizio e fine
stringa
+vengono ignorati nell'assegnare valori agli elementi di @var{vettore} ma non
nel
+vettore @var{separatori}, e gli elementi sono separati da uno o address@hidden
spazi
+bianchi. Inoltre, come nel caso della divisione dei record in input, se
address@hidden @`e la stringa nulla, ogni singolo carattere nella stringa
+costituisce un elemento del vettore.
address@hidden
+
+Si noti, tuttavia, che @code{RS} non influisce sul comportamento di
address@hidden()}.
+Anche se @samp{RS = ""} fa address@hidden@dotless{i}} che il carattere di
ritorno a capo sia un
+separatore di campo,
+questo non influenza il modo in cui @code{split()} divide le stringhe.
+
address@hidden angolo buio, funzione @code{split()}
+Recenti implementazioni di @command{awk}, incluso @command{gawk},
+consentono che il terzo argomento sia una costante @dfn{regexp}
+(@address@hidden/address@hidden@code{/}})
+o anche una stringa. @value{DARKCORNER}
+Anche lo standard POSIX permette questo.
address@hidden regolari calcolate} per la spiegazione della differenza
+tra l'uso di una costante stringa e l'uso di una costante @dfn{regexp},
+sulle loro implicazioni riguardo a come scrivere correttamente un programma.
+
+Prima di dividere la stringa, @code{split()} cancella ogni elemento
+eventualmente address@hidden presente
+nei vettori @var{vettore} e @var{separatori}.
+
+Se @var{stringa} @`e la stringa nulla, il vettore non ha elementi.
+(Quindi, in questo modo si address@hidden cancellare un intero vettore con una
sola
+istruzione).
address@hidden)
+
+Se in @var{stringa} non viene trovato @var{separacampo} (ma la stringa
+non @`e la stringa nulla),
address@hidden ha solo un elemento. Il valore di quell'elemento @`e la
address@hidden originale.
+
+In address@hidden POSIX (@pxref{Opzioni}), il quarto argomento non @`e
disponibile.
+
address@hidden @code{sprintf(@var{formato}, @var{espressione1}, @dots{})}
address@hidden
address@hidden formattare stringhe
address@hidden stringhe, formattazione
+Restituisce (senza stamparla) la stringa che @code{printf} avrebbe
+stampato con gli stessi argomenti
+(@pxref{Printf}).
+Per esempio:
+
address@hidden
+pival = sprintf("pi = %.2f (approx.)", 22/7)
address@hidden example
+
address@hidden
+assegna la stringa @address@hidden = 3.14 (approx.)}} alla variabile
@code{pival}.
+
address@hidden
address@hidden conversione di una stringa in un numero
address@hidden stringhe, conversione in numeri
address@hidden @code{strtonum(@var{stringa}) #}
+Esamina @var{stringa} e restituisce il suo valore numerico. Se
address@hidden inizia con la cifra @samp{0}, @code{strtonum()} presuppone
+che @var{stringa} sia un numero ottale. Se @var{stringa} inizia con
address@hidden o @samp{0X}, @code{strtonum()} presuppone che @var{stringa} sia
un
+numero esadecimale.
+Per esempio:
+
address@hidden
+$ @kbd{echo 0x11 |}
+> @kbd{gawk '@{ printf "%d\n", strtonum($1) @}'}
address@hidden 17
address@hidden example
+
+Usare la funzione @code{strtonum()} @emph{non} @`e lo stesso che aggiungere
+zero al valore di una stringa;
+la conversione automatica di stringhe in numeri
+si applica solo a dati decimali, non a quelli ottali o
address@hidden nel caso si usi l'opzione
address@hidden, il che non @`e consigliato.
address@hidden non decimali} per ulteriori informazioni.}
+
+Si noti anche che @code{strtonum()} usa il separatore decimale della
+localizzazione corrente per riconoscere i numeri
+(@pxref{Localizzazioni}).
+
address@hidden @code{sub(@var{regexp}, @var{rimpiazzo}} address@hidden,
@address@hidden)}
address@hidden
address@hidden rimpiazzare in una stringa
address@hidden stringa, rimpiazzare in una
+Ricerca in @var{obiettivo}, che @`e visto come una stringa,
+la prima sottostringa address@hidden lunga possibile,
+a partire da sinistra, che corrisponde all'espressione regolare @var{regexp}.
+Modifica l'intera stringa sostituendo il testo individuato con
address@hidden
+La stringa address@hidden@dotless{i}} modificata diventa il nuovo valore di
@var{obiettivo}.
+Restituisce il numero di sostituzioni fatte (zero o uno).
+
+L'argomento @var{regexp} address@hidden essere o una costante @dfn{regexp}
+(@code{/address@hidden@code{/}) o una constante stringa
(@code{"address@hidden@code{"}).
+In quest'ultimo caso, la stringa @`e trattata come una @dfn{regexp}
+da individuare.
address@hidden regolari calcolate} per la spiegazione della differenza tra
+le due forme, delle loro implicazioni riguardo al modo di scrivere
+correttamente un programma.
+
+Questa funzione @`e particolare perch@'e @var{obiettivo} non @`e semplicemente
usato
+per calcolare un valore, e non basta che sia un'espressione qualsiasi:
+dev'essere una variabile, un campo, o un elemento di vettore in cui
address@hidden()} possa memorizzare un valore modificato. Se questo argomento
@`e
+omesso, il comportamento di default @`e
+quello di usare e modificare
address@hidden@footnote{Si noti che questo significa che il record
address@hidden dapprima
+ricostruito, usando il valore di @code{OFS} se qualche campo @`e stato
cambiato,
+e che i campi saranno aggiornati dopo la sostituzione, anche se l'operazione in
+s@'e non cambia il record (@`e una ``no-op'') come @samp{sub(/^/, "")}.} Per
+esempio:
+
address@hidden
+str = "acqua, acqua dappertutto"
+sub(/cqu/, "vari", str)
address@hidden example
+
address@hidden
+modifica @code{stringa} facendola divenire
address@hidden@samp{avaria, acqua dappertutto}},
+rimpiazzando l'occorrenza address@hidden lunga,
+a partire da sinistra, di @samp{cqu} con @samp{vari}.
+
+Se il carattere speciale @samp{&} compare in @var{rimpiazzo}, designa
+l'esatta sottostringa individuata da @var{regexp}. (Se
address@hidden address@hidden individuare address@hidden di una stringa, questa
sottostringa
address@hidden assumere valori diversi.) Per esempio:
+
address@hidden
address@hidden sub(/candidato/, "& e sua moglie"); print @}
address@hidden example
+
address@hidden
+cambia la prima occorrenza di @samp{candidato} a @samp{candidato
+e sua moglie} in ogni riga in input.
+Ecco un altro esempio:
+
address@hidden
+$ @kbd{awk 'BEGIN @{}
+> @kbd{str = "daabaaa"}
+> @kbd{sub(/a+/, "C&C", str)}
+> @kbd{print str}
+> @address@hidden'}
address@hidden dCaaCbaaa
address@hidden example
+
address@hidden
+questo mostra come @samp{&} possa rappresentare una stringa variabile
+e illustra anche la regola
+``a partire da sinistra, la address@hidden lunga'' nell'individuazione di
@dfn{regexp}
+(@address@hidden lungo da sinistra}).
+
+L'effetto di questo carattere speciale (@samp{&}) address@hidden essere
neutralizzato
+anteponendogli una barra inversa nella stringa. Come al solito, per
+inserire una barra inversa nella
+stringa, occorre scrivere due barre inverse. Quindi, occorre scrivere
address@hidden&} in una costante stringa per includere un carattere @samp{&}
+nel rimpiazzo.
+Per esempio, quanto segue mostra come rimpiazzare il primo @samp{|} su
+ogni riga con un @samp{&}:
+
address@hidden
address@hidden sub(/\|/, "\\&"); print @}
address@hidden example
+
address@hidden @code{sub()}, funzione, argomenti di
address@hidden funzione @code{sub()}, argomenti di
address@hidden @code{gsub()}, funzione, argomenti di
address@hidden funzione @code{gsub()}, argomenti di
+Come address@hidden accennato, il terzo argomento di @code{sub()} dev'essere
+una variabile, un campo, o un elemento di vettore.
+Alcune versioni di @command{awk} accettano come terzo argomento
+un'espressione che non @`e un @dfn{lvalue}. In tal caso, @code{sub()}
+cerca ugualmente l'espressione e restituisce zero o uno, ma il risultato
+della sostituzione (se ce n'@`e uno) viene scartato perch@'e non c'@`e un posto
+dove memorizzarlo. Tali versioni di @command{awk} accettano espressioni
+come le seguente:
+
address@hidden
+sub(/USA/, "Stati Uniti", "gli USA e il Canada")
address@hidden example
+
address@hidden
address@hidden risoluzione di problemi, funzioni @code{gsub()}/@code{sub()}
address@hidden problemi, risoluzione di, funzioni @code{gsub()}/@code{sub()}
+Per address@hidden storica, @command{gawk} accetta un tale codice erroneo.
+Tuttavia, l'uso di qualsiasi altra espressione non modificabile
+come terzo parametro causa un errore fatale, e il programma
+non viene portato a termine.
+
+Infine, se la @var{regexp} non @`e una costante @dfn{regexp}, @`e convertita
+in una stringa, e quindi il valore di quella stringa @`e trattato come
+la @dfn{regexp} da individuare.
+
address@hidden @code{substr(@var{stringa}, @var{inizio}} address@hidden,
@var{lunghezza}} address@hidden)}
address@hidden
address@hidden sottostringa
+Restituisce una sottostringa di @var{stringa} lunga @var{lunghezza} caratteri,
+iniziando dal carattere numero @var{inizio}. Il primo carattere di una
+stringa @`e il carattere numero address@hidden @`e differente da
+C e C++, in cui il primo carattere ha il numero zero.}
+Per esempio, @code{substr("Washington", 5, 3)} restituisce @code{"ing"}.
+
+Se @var{lunghezza} non @`e presente, @code{substr()} restituisce l'intero
+suffisso di
address@hidden a partire dal carattere numero @var{inizio}. Per esempio,
address@hidden("Washington", 5)} restituisce @code{"ington"}. L'intero
+suffisso @`e restituito anche
+se @var{lunghezza} @`e maggiore del numero di caratteri disponibili
+nella stringa, a partire dal carattere @var{inizio}.
+
address@hidden Brian Kernighan, @command{awk} di
+Se @var{inizio} @`e minore di uno, @code{substr()} lo tratta come se
+fosse uno. (POSIX non specifica cosa fare in questo caso:
+BWK @command{awk} si comporta address@hidden@dotless{i}}, e quindi
@command{gawk} fa lo stesso.)
+Se @var{inizio} @`e maggiore del numero di caratteri
+nella stringa, @code{substr()} restituisce la stringa nulla.
+Analogamente, se @var{lunghezza} @`e presente ma minore o uguale a zero,
+viene restituita la stringa nulla.
+
address@hidden risoluzione di problemi, funzione @code{substr()}
address@hidden problemi, risoluzione di, funzione @code{substr()}
+La stringa restituita da @code{substr()} @emph{non address@hidden essere
+assegnata. Quindi, @`e un errore tentare di modificare una porzione di
+una stringa, come si vede nel seguente esempio:
+
address@hidden
+stringa = "abcdef"
+# tentare di ottenere "abCDEf", non @`e possibile
+substr(stringa, 3, 3) = "CDE"
address@hidden example
+
address@hidden
address@hidden anche un errore usare @code{substr()} come terzo argomento
+di @code{sub()} o @code{gsub()}:
+
address@hidden
+gsub(/xyz/, "pdq", substr($0, 5, 20)) # SBAGLIATO
address@hidden example
+
address@hidden address@hidden, funzione @code{substr()}
+(Alcune versioni commerciali di @command{awk} consentono un tale uso di
address@hidden()}, ma un tale codice non @`e portabile.)
+
+Se si devono sostituire pezzi di una stringa,
+si combini @code{substr()}
+con una concatenazione di stringa, nel modo seguente:
+
address@hidden
+stringa = "abcdef"
address@hidden
+stringa = substr(stringa, 1, 2) "CDE" substr(stringa, 6)
address@hidden example
+
address@hidden maiuscolo/minuscolo, conversione da/a
address@hidden stringhe, convertire maiuscolo/minuscolo
address@hidden @code{tolower(@var{stringa})}
address@hidden
address@hidden convertire stringa in minuscolo
+Restituisce una copia di @var{stringa}, con ogni carattere maiuscolo
+nella stringa rimpiazzato dal suo corrispondente carattere minuscolo.
+I caratteri non alfabetici non vengono modificati. Per esempio,
address@hidden("MaIuScOlO MiNuScOlO 123")} restituisce
address@hidden"maiuscolo minuscolo 123"}.
+
address@hidden @code{toupper(@var{stringa})}
address@hidden
address@hidden convertire stringa in maiuscolo
+Restituisce una copia di @var{stringa}, con ogni carattere minuscolo
+nella stringa rimpiazzato dal suo corrispondente carattere maiuscolo.
+I caratteri non alfabetici non vengono modificati. Per esempio,
address@hidden("MaIuScOlO MiNuScOlO 123")} restituisce
address@hidden"MAIUSCOLO MINUSCOLO 123"}.
address@hidden table
+
address@hidden Individuare la stringa nulla
address@hidden individuare la stringa nulla
address@hidden stringa nulla, individuare la
address@hidden @code{*} (asterisco), operatore @code{*}, individuare la stringa
nulla
address@hidden asterisco (@code{*}), operatore @code{*}, individuare la stringa
nulla
+
+In @command{awk}, l'operatore @samp{*} address@hidden individuare la stringa
nulla.
+Questo @`e particolarmente importante per le funzioni @code{sub()},
address@hidden()} e @code{gensub()}. Per esempio:
+
address@hidden
+$ @kbd{echo abc | awk '@{ gsub(/m*/, "X"); print @}'}
address@hidden XaXbXcX
address@hidden example
+
address@hidden
+Sebbene questo sia abbastanza sensato, address@hidden suscitare una certa
sorpresa.
address@hidden sidebar
+
+
address@hidden Dettagli ostici
address@hidden Ulteriori dettagli su @samp{\} e @samp{&} con @code{sub()},
@code{gsub()} e @code{gensub()}
+
address@hidden protezione caratteri nelle funzioni
@code{gsub()}/@code{gensub()}/@code{sub()}
address@hidden funzione @code{sub()}, protezione caratteri
address@hidden @code{sub()}, funzione, protezione caratteri
address@hidden funzione @code{gsub()}, protezione caratteri
address@hidden @code{gsub()}, funzione, protezione caratteri
address@hidden funzione @code{gensub()} (@command{gawk}), protezione caratteri
address@hidden @code{gensub()}, funzione (@command{gawk}), protezione caratteri
address@hidden @code{\} (barra inversa),
@code{gsub()}/@code{gensub()}/@code{sub()} funzioni e
address@hidden barra inversa (@code{\}),
@code{gsub()}/@code{gensub()}/@code{sub()} funzioni e
address@hidden @code{&} (e commerciale), funzioni
@code{gsub()}/@code{gensub()}/@code{sub()} e
address@hidden e commerciale (@code{&}), funzioni
@code{gsub()}/@code{gensub()}/@code{sub()} e
+
address@hidden ATTENZIONE
+Si dice che questa sottosezione possa causare dei mal di testa.
+In prima lettura address@hidden essere benissimo saltata.
address@hidden quotation
+
+Quando si usa @code{sub()}, @code{gsub()} o @code{gensub()}, e si
+desidera includere delle
+barre inverse e delle "e commerciali" (@code{&}) nel testo da sostituire
address@hidden necessario ricordare che ci sono parecchi livelli di
address@hidden caratteri} in gioco.
+
+Anzitutto, vi @`e il livello @dfn{lessicale}, quello in cui @command{awk}
+legge un programma e ne costruisce una copia interna da eseguire.
+Poi c'@`e il momento dell'esecuzione, quello in cui @command{awk}
+esamina effettivamente la stringa da sostituire, per determinare cosa
+fare.
+
address@hidden Brian Kernighan, @command{awk} di
+In entrambi i livelli, @command{awk} ricerca un dato insieme di caratteri
+che possono venire dopo una
+barra inversa. A livello lessicale, cerca le sequenze di protezione
+elencate in @ref{Sequenze di protezione}.
+Quindi, per ogni @samp{\} che @command{awk} elabora al momento
+dell'esecuzione, occorre immetterne due a livello lessicale.
+Quando un carattere che non ha address@hidden di una sequenza di protezione
+segue una @samp{\}, sia BWK @command{awk} che @command{gawk} semplicemente
+rimuovono la @samp{\} stessa e
+mettono il carattere seguente nella stringa. Quindi, per esempio,
address@hidden"a\qb"} @`e trattato come se si fosse scritto @code{"aqb"}.
+
+Al momento dell'esecuzione, le varie funzioni gestiscono sequenze di
address@hidden e @samp{&} in maniera differente. La situazione @`e (purtroppo)
+piuttosto complessa.
+Storicamente, le funzioni @code{sub()} e @code{gsub()} trattavano la
+sequenza di due caratteri @samp{\&} in maniera speciale; questa sequenza
+era rimpiazzata nel testo
+generato da un singolo carattere @samp{&}. Ogni altra @samp{\} contenuta
+nella stringa @var{rimpiazzo} che non era posta prima di una @samp{&} era
+lasciata passare senza modifiche.
+Questo @`e illustrato nella @ref{table-sub-escapes}.
+
address@hidden Thank to Karl Berry for help with the TeX stuff.
address@hidden Tabella,table-sub-escapes
address@hidden storica delle sequenze di protezione per @code{sub()} e
@code{gsub()}}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
+ @code{\&}! @code{&}!Il testo individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\\\&}! @code{\\&}!I caratteri @samp{\&}_cr
+ @code{\\\\\&}! @code{\\&}!I caratteri @samp{\&}_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\\&}_cr
+ @code{\\q}! @code{\q}!I caratteri @samp{\q}_cr
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden Immissione @tab @code{sub()} vede @tab @code{sub()} genera
address@hidden @code{\&} @tab @code{&} @tab Il testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\\\&} @tab @code{\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\\&} @tab @code{\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\\&}
address@hidden @code{\\q} @tab @code{\q} @tab I caratteri @samp{\q}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+ Immissione @code{sub()} vede @code{sub()} genera
+ --------------- ------------- ---------------
+ @code{\&} @code{&} Il testo individuato
+ @code{\\&} @code{\&} La lettera @samp{&}
+ @code{\\\&} @code{\&} La lettera @samp{&}
+ @code{\\\\&} @code{\\&} Le lettere @samp{\&}
+ @code{\\\\\&} @code{\\&} Le lettere @samp{\&}
address@hidden&} @code{\\\&} Le lettere
@samp{\\&}
+ @code{\\q} @code{\q} Le lettere @samp{\q}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
address@hidden
+Questa tabella mostra l'elaborazione a livello lessicale, in cui
+un numero dispari di barre inverse diventa un numero pari al momento
+dell'esecuzione,
+e mostra anche l'elaborazione in fase di esecuzione fatta da @code{sub()}.
+(Per amor di address@hidden le tavole che ancora seguono mostrano solo il caso
+di un numero pari di barre inverse immesso a livello lessicale.)
+
+Il problema con l'approccio storico @`e che non c'@`e modo di ottenere
+un carattere @samp{\} seguito dal testo individuato.
+
+Parecchie edizioni dello standard POSIX hanno provato a risolvere questo
+problema, senza riuscirci. I dettagli sono irrilevanti in questo contesto.
+
+A un certo punto, il manutentore di @command{gawk} ha presentato una
+proposta per una revisione dello standard per tornare
+a regole che corrispondano address@hidden da vicino alla prassi originalmente
seguita.
+Le regole proposte hanno dei casi speciali che rendono possibile
+produrre una @samp{\} prima del
+testo individuato. Questo si address@hidden vedere nella
address@hidden
+
address@hidden Tabella,table-sub-proposed
address@hidden @command{gawk} per @code{sub()} e barra inversa}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\&}_cr
address@hidden&}! @code{\\&}!Il carattere @samp{\}, seguito dal testo
individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\q}! @code{\q}!I caratteri @samp{\q}_cr
+ @code{\\\\}! @address@hidden
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden Immissione @tab @code{sub()} vede @tab @code{sub()} genera
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\&} @tab @code{\\&} @tab Il carattere @samp{\},
seguito dal testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\q} @tab @code{\q} @tab I caratteri @samp{\q}
address@hidden @code{\\\\} @tab @code{\\} @tab @code{\\}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+Immissione @code{sub()} vede @code{sub()} genera
+--------- ---------- ---------------
address@hidden&} @code{\\\&} Il carattere @samp{\&}
+ @code{\\\\&} @code{\\&} Il carattere @samp{\}, seguito
dal testo individuato
+ @code{\\&} @code{\&} Il carattere @samp{&}
+ @code{\\q} @code{\q} I caratteri @samp{\q}
+ @code{\\\\} @code{\\} @code{\\}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
+In breve, al momento dell'esecuzione, ci sono ora tre sequenze speciali
+di caratteri (@samp{\\\&}, @samp{\\&}, e @samp{\&}) mentre tradizionalmente
+ce n'era una sola. Tuttavia, come nel caso storico, ogni @samp{\} che
+non fa parte di una di queste tre sequenze non @`e speciale e appare
+nell'output address@hidden@dotless{i}} come @`e scritto.
+
address@hidden 3.0 e 3.1 seguono queste regole per @code{sub()} e
address@hidden()}. La revisione dello standard POSIX ha richiesto molto
address@hidden tempo
+di quel che ci si attendeva. Inoltre, la proposta del manutentore di
address@hidden @`e andata persa durante il processo di standardizzazione. Le
+regole finali risultanti sono un po' address@hidden semplici. I risultati
sono simili,
+tranne che in un caso.
+
address@hidden POSIX @command{awk}, funzioni @code{gsub()}/@code{sub()} e
+Le regole POSIX stabiliscono che @samp{\&} nella stringa di rimpiazzo
+produca il carattere @samp{&}, @samp{\\} produce il carattere @samp{\},
+e che @samp{\} seguito da qualsiasi carattere non @`e speciale; la @samp{\}
address@hidden messa direttamente nell'output.
+Queste regole sono presentate nella @ref{table-posix-sub}.
+
address@hidden Tabella,table-posix-sub
address@hidden POSIX per @code{sub()} e @code{gsub()}}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\&}_cr
address@hidden&}! @code{\\&}!Il carattere @samp{\}, seguito dal testo
individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\q}! @code{\q}!I caratteri @samp{\q}_cr
+ @code{\\\\}! @address@hidden
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden @tab @code{sub()} vede @tab @code{sub()} genera
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\\\&} @tab @code{\\&} @tab Il carattere @samp{\},
seguito dal testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab I caratteri @samp{&}
address@hidden @code{\\q} @tab @code{\q} @tab I caratteri @samp{\q}
address@hidden @code{\\\\} @tab @code{\\} @tab @code{\}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+Immissione @code{sub()} vede @code{sub()} genera
+--------- ---------- ---------------
address@hidden&} @code{\\\&} I caratteri @samp{\&}
+ @code{\\\\&} @code{\\&} Il carattere @samp{\}, seguito
dal testo individuato
+ @code{\\&} @code{\&} Il carattere @samp{&}
+ @code{\\q} @code{\q} I caratteri @samp{\q}
+ @code{\\\\} @code{\\} @code{\}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
+Il solo caso in cui la differenza @`e rilevante @`e l'ultimo: @samp{\\\\}
address@hidden visto come @samp{\\} e produce @samp{\} invece che @samp{\\}.
+
+A partire dalla @value{PVERSION} 3.1.4, @command{gawk} ha seguito le regole
+POSIX quando si specifica @option{--posix} (@pxref{Opzioni}). Altrimenti, ha
+continuato a seguire le regole proposte [a POSIX], poich@'e questa @`e stato il
+comportamento seguito per parecchi anni.
+
+Quando la @value{PVERSION} 4.0.0 @`e stata rilasciata, il manutentore di
address@hidden
+ha stabilito come default le regole POSIX, interrompendo
address@hidden@dotless{i}} oltre
+un decennio di address@hidden
+all'address@hidden decisione si @`e dimostrata piuttosto avventata,
+anche se una nota in questa sezione avvertiva che la successiva versione
+principale di @command{gawk} avrebbe adottato le regole POSIX.}
+Inutile dire che questa non @`e stata una buona idea, e quindi dalla
address@hidden 4.0.1, @command{gawk} ha ripreso il suo comportamento
+tradizionale, seguendo le regole POSIX solo quando si specifica l'opzione
address@hidden
+
+Le regole per @code{gensub()} sono molto address@hidden semplici. Al momento
+dell'esecuzione, quando @command{gawk} vede una @samp{\}, se il carattere
+seguente @`e una cifra,
+il testo individuato dalla corrispondente sottoespressione tra parentesi
address@hidden inserito nell'output generato. Altrimenti, qualsiasi carattere
segua la
address@hidden viene inserito nel testo generato, mentre la @samp{\} va persa,
+come si vede nella @ref{table-gensub-escapes}.
+
address@hidden Tabella,table-gensub-escapes
address@hidden sequenze di protezione in @code{gensub()}}
address@hidden
+\vbox{\bigskip
+% We need more characters for escape and tab ...
+\catcode`_ = 0
+\catcode`! = 4
+% ... since this table has lots of &'s and \'s, so we unspecialize them.
+\catcode`\& = \other \catcode`\\ = \other
+_halign{_hfil#!_qquad_hfil#!_qquad#_hfil_cr
+ address@hidden()} address@hidden()} genera_cr
+_hrulefill!_hrulefill!_hrulefill_cr
+ @code{&}! @code{&}!Il testo individuato_cr
+ @code{\\&}! @code{\&}!Il carattere @samp{&}_cr
+ @code{\\\\}! @code{\\}!Il carattere @samp{\}_cr
+ @code{\\\\&}! @code{\\&}!Il carattere @samp{\}, seguito dal testo
individuato_cr
address@hidden&}! @code{\\\&}!I caratteri @samp{\&}_cr
+ @code{\\q}! @code{\q}!Il carattere @samp{q}_cr
+}
+_bigskip}
address@hidden tex
address@hidden
address@hidden @columnfractions .20 .20 .60
address@hidden Immissione @tab @code{gensub()} vede @tab @code{gensub()} genera
address@hidden @code{&} @tab @code{&} @tab Il testo individuato
address@hidden @code{\\&} @tab @code{\&} @tab Il carattere @samp{&}
address@hidden @code{\\\\} @tab @code{\\} @tab Il carattere @samp{\}
address@hidden @code{\\\\&} @tab @code{\\&} @tab Il carattere @samp{\},
seguito dal testo individuato
address@hidden @code{\\\\\\&} @tab @code{\\\&} @tab I caratteri @samp{\&}
address@hidden @code{\\q} @tab @code{\q} @tab Il carattere @samp{q}
address@hidden multitable
address@hidden ifdocbook
address@hidden
address@hidden
address@hidden
+ Immissione @code{gensub()} vede @code{gensub()} genera
+ --------- ------------- ------------------
+ @code{&} @code{&} Il testo individuato
+ @code{\\&} @code{\&} Il carattere @samp{&}
+ @code{\\\\} @code{\\} Il carattere @samp{\}
+ @code{\\\\&} @code{\\&} Il carattere @samp{\},
seguito dal testo individuato
address@hidden&} @code{\\\&} I caratteri @samp{\&}
+ @code{\\q} @code{\q} Il carattere @samp{q}
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden float
+
+A causa della address@hidden dell'elaborazione a livello lessicale e in fase
+di esecuzione, e dei casi speciali di @code{sub()} e @code{gsub()},
+si raccomanda l'uso di @command{gawk} e di @code{gensub()} quando ci siano
+da fare delle sostituzioni.
+
address@hidden Funzioni di I/O
address@hidden Funzioni di Input/Output
address@hidden input/output, funzioni di
address@hidden funzioni di input/output
+
+Le seguenti funzioni riguardano l'input/output (I/O).
+I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @asis
address@hidden @code{close(address@hidden address@hidden,} @address@hidden)}
address@hidden
address@hidden file, chiusura
address@hidden chiudere un file o un coprocesso
+Chiude il file @var{nome_file} in input o in output. Alternativamente,
+l'argomento address@hidden essere un comando della shell usato per creare un
+coprocesso, o per ridirigere
+verso o da una @dfn{pipe}; questo coprocesso o @dfn{pipe} viene chiuso.
address@hidden file e @dfn{pipe}}
+per ulteriori informazioni.
+
+Quando si chiude un coprocesso, address@hidden talora essere utile chiudere
dapprima
+un lato della @dfn{pipe} bidirezionale e quindi chiudere l'altro.
+Questo si address@hidden fare fornendo un secondo argomento a @code{close()}.
+Questo secondo argomento (@var{come})
+dovrebbe essere una delle due stringhe @code{"to"} o @code{"from"},
+che indicano quale lato della @dfn{pipe} chiudere. La stringa address@hidden
essere
+scritta indifferentemente in maiuscolo o in minuscolo.
address@hidden/O bidirezionale},
+che tratta questa address@hidden con maggior dettaglio e mostra un esempio.
+
+Si noti che il secondo argomento di @code{close()} @`e
+un'estensione @command{gawk}; non @`e disponibile in address@hidden compatibile
+(@pxref{Opzioni}).
+
address@hidden @code{fflush(address@hidden@code{)}
address@hidden
address@hidden scrivere su disco i buffer di output contenuti in memoria
+Scrive su disco ogni output contenuto in memoria, associato con
address@hidden, che @`e o un
+file aperto in scrittura o un comando della shell che ridirige output a
+una @dfn{pipe} o a un coprocesso.
+
address@hidden buffer, scrivere su disco un
address@hidden memoria tampone, scrivere su disco
address@hidden output, bufferizzazione
address@hidden output, nella memoria tampone (buffer)
+Molti programmi di address@hidden @dfn{bufferizzano} il loro output
(address@hidden,
+accumulano in memoria record da scrivere in un file su disco o sullo
+schermo, fin quando non arriva il momento giusto per inviare i
+dati al dispositivo di output).
+Questo @`e spesso address@hidden efficiente che scrivere
+ogni particella di informazione non appena diventa disponibile. Tuttavia,
+qualche volta @`e necessario forzare un programma a @dfn{svuotare}
+i suoi buffer (address@hidden, inviare l'informazione alla sua destinazione,
+anche se un buffer non @`e pieno).
+Questo @`e lo scopo della funzione @code{fflush()}; anche
address@hidden scrive il suo output in un buffer, e la funzione @code{fflush()}
+forza @command{gawk} a svuotare i suoi buffer.
+
address@hidden estensioni comuni, funzione @code{fflush()}
address@hidden Brian Kernighan, @command{awk} di
+Brian Kernighan ha aggiunto @code{fflush()} al suo @command{awk} nell'aprile
+1992. Per due decenni @`e rimasta un'estensione comune. A Dicembre
+2012 @`e stata accettata e inclusa nello standard POSIX.
+Si veda @uref{http://austingroupbugs.net/view.php?id=634, il sito Web
dell'Austin Group}.
+
+POSIX standardizza @code{fflush()} come segue: se non c'@`e alcun
+argomento, o se l'argomento @`e la stringa nulla (@address@hidden""}}),
address@hidden svuota i buffer di @emph{tutti} i file in output e di
address@hidden le @dfn{pipe}.
+
address@hidden NOTA
+Prima della @value{PVERSION} 4.0.2, @command{gawk}
+avrebbe svuotato solo i buffer dello standard output se non era
+specificato alcun argomento,
+e svuotato tutti i buffer dei file in output e delle @dfn{pipe} se
+l'argomento era la stringa nulla.
+Questo @`e stato modificato per essere compatibile con l'@command{awk} di
+Kernighan, nella speranza che standardizzare questa
address@hidden in POSIX sarebbe stato address@hidden agevole (come poi @`e
effettivamente
+successo).
+
+Con @command{gawk},
+si address@hidden usare @samp{fflush("/dev/stdout")} se si desidera solo
svuotare i
+buffer dello standard output.
address@hidden quotation
+
address@hidden @cindex automatic warnings
address@hidden @cindex warnings, automatic
address@hidden risoluzione di problemi, funzione @code{fflush()}
address@hidden problemi, risoluzione di, funzione @code{fflush()}
address@hidden()} restituisce zero se il buffer @`e svuotato con successo;
+altrimenti, restituisce un valore diverso da zero. (@command{gawk}
+restituisce @minus{}1.)
+Nel caso in cui tutti i buffer vadano svuotati, il valore restituito @`e zero
+solo se tutti i buffer sono stati svuotati con successo. Altrimenti,
address@hidden @minus{}1, e @command{gawk} avvisa riguardo al @var{nome_file}
+che ha problemi.
+
address@hidden invia anche un messaggio di avvertimento se si tenta di svuotare
i
+buffer di un file o @dfn{pipe} che era stato aperto in lettura
+(p.es. con @code{getline}),
+o se @var{nome_file} non @`e un file, una @dfn{pipe}, o un coprocesso aperto.
+in tal caso, @code{fflush()} restituisce ancora @minus{}1.
+
address@hidden Bufferizzazione interattiva e non interattiva
address@hidden bufferizzazione, interattiva vs.@: non interattiva
+
+A complicare ulteriormente le cose, i problemi di bufferizzazione possono
+peggiorare se il programma eseguito
address@hidden @dfn{interattivo} (address@hidden, se
+comunica con un utente seduto davanti a una tastiera)address@hidden programma
address@hidden interattivo se il suo standard output @`e connesso a un
dispositivo
+terminale. Ai giorni nostri, questo vuol dire davanti a uno
+schermo e a una tastiera.}
+
address@hidden Thanks to address@hidden for this example, and for
address@hidden motivating me to write this section.
+I programmi interattivi normalmente @dfn{bufferizzano per riga} il loro
+output (address@hidden, scrivono in output una riga alla volta). I programmi
+non-interattivi attendono di aver riempito un buffer, il che address@hidden
voler dire
+anche parecchie righe di output.
+Ecco un esempio della differenza:
+
address@hidden
+$ @kbd{awk '@{ print $1 + $2 @}'}
address@hidden 1}
address@hidden 2
address@hidden 3}
address@hidden 5
address@hidden
address@hidden example
+
address@hidden
+Ogni riga di output @`e stampata immediatamente. Si confronti questo
+comportamente con quello di questo esempio:
+
address@hidden
+$ @kbd{awk '@{ print $1 + $2 @}' | cat}
address@hidden 1}
address@hidden 3}
address@hidden
address@hidden 2
address@hidden 5
address@hidden example
+
address@hidden
+In questo caso, nessun output viene stampato finch@'e non @`e stato battuto il
address@hidden, perch@'e l'output @`e bufferizzato e inviato tramite
address@hidden al comando @command{cat} in un colpo solo.
address@hidden sidebar
+
address@hidden @code{system(@var{comando})}
address@hidden
address@hidden chiamare comandi di shell
address@hidden interagire con altri programmi
+Esegue il comando del sistema operativo @var{comando} e quindi
+ritorna al programma @command{awk}.
+Restituisce il codice ritorno di @var{comando}.
+
+Per esempio, inserendo il seguente frammento di codice in un programma
address@hidden:
+
address@hidden
+END @{
+ system("date | mail -s 'awk completato' root")
address@hidden
address@hidden example
+
address@hidden
+all'amministratore di sistema viene inviato un messaggio di posta quando
+il programma @command{awk} termina di elaborare l'input e inizia
+l'elaborazione da eseguire alla fine dell'input.
+
+Si noti che la ridirezione di @code{print} o @code{printf} in una
address@hidden @`e spesso sufficiente per ottenere lo stesso risultato.
+Se @`e necessario eseguire parecchi comandi, @`e address@hidden efficiente
+stamparli verso una @dfn{pipe} diretta alla shell:
+
address@hidden
+while (@var{ancora lavoro da fare})
+ print @var{comando} | "/bin/sh"
+close("/bin/sh")
address@hidden example
+
address@hidden
address@hidden risoluzione di problemi, funzione @code{system()}
address@hidden problemi, risoluzione di, funzione @code{system()}
address@hidden @option{--sandbox}, opzione, disabilitare la funzione
@code{system()}
address@hidden opzione @option{--sandbox}, disabilitare la funzione
@code{system()}
+Tuttavia, nel caso che il programma @command{awk} sia interattivo,
address@hidden()} @`e utile per eseguire grossi programmi autonomi,
+come ad esempio la shell o un programma di modifica testi.
+Alcuni sistemi operativi non consentono di implementare la funzione
address@hidden()}.
+Richiamare @code{system()} in sistemi in cui non @`e disponibile provoca
+un errore fatale.
+
address@hidden NOTA
+Quando si specifica l'opzione @option{--sandbox}, la funzione @code{system()}
@`e
+disabilitata (@pxref{Opzioni}).
address@hidden quotation
+
+Nei sistemi aderenti allo standard POSIX, il codice di ritorno di un
+comando @`e un numero contenuto in 16 bit. Il valore del codice di ritorno
+passato alla funzione C @code{exit()} alla fine del programma @`e contenuto
+negli 8 bit di valore address@hidden alto dei 16 bit (la address@hidden
sinistra) che compongono
+il numero. I bit di valore address@hidden basso (la address@hidden destra)
indicano se il
+processo @`e stato terminato da un segnale (bit 7), e, se questo @`e il caso,
+il numero del segnale che ha provocato la terminazione (bit 0--6).
+
+Tradizionalmente, la funzione @code{system()} di @command{awk} si @`e
+semplicemente limitata a restituire il valore del codice di ritorno
+diviso per 256 (ossia la address@hidden sinistra del numero di 16 bit, spostata
+a destra). In una situazione normale questo equivale a utilizzare il
+codice di ritornodi @code{system()}, ma nel caso in cui il programma sia
+stato terminato da un segnale, il valore diventa un numero frazionale a
+virgola address@hidden uno scambio di messaggi privato il Dr.@:
+Kernighan mi ha comunicato che questo modo di procedere @`e probabilmente
+errato.} POSIX stabilisce che la chiamata a @code{system()} dall'interno
+di @command{awk} dovrebbe restituire l'intero valore a 16 bit.
+
address@hidden si trova in qualche modo a address@hidden strada.
+I valori del codice di ritorno sono descritti nella
address@hidden
+
address@hidden Tabella,table-system-return-values
address@hidden codici di ritorno da chiamata a @code{system()}}
address@hidden @columnfractions .40 .60
address@hidden Situazione @tab Valore codice di ritorno da @code{system()}
address@hidden @option{--traditional} @tab Valore dalla funzione C
@code{system()}/256
address@hidden @option{--posix} @tab Valore dalla funzione C @code{system()}
address@hidden Uscita normale dal comando @tab Codice di ritorno del comando
address@hidden Terminazione da un segnale @tab 256 + numero segnale "assassino"
address@hidden Terminazione da un segnale con dump memoria @tab 512 + numero
segnale "assassino"
address@hidden Qualsiasi tipo di errore @tab @minus{}1
address@hidden multitable
address@hidden float
address@hidden table
+
address@hidden Controllare la bufferizzazione dell'output con @code{system()}
address@hidden buffer, scrivere su disco un
address@hidden bufferizzazione, dell'input/output
address@hidden output, bufferizzazione
address@hidden bufferizzazione, dell'output
+
+La funzione @code{fflush()} consente un controllo esplicito sulla
+bufferizzazione dell'output per singoli file e @dfn{pipe}.
+Tuttavia, il suo utilizzo non @`e portabile su molte delle meno recenti
+implementazioni di @command{awk}. Un metodo alternativo per forzare la
+scrittura dell'output @`e una chiamata a
address@hidden()} che abbia come argomento la stringa nulla:
+
address@hidden
+system("") # scrive l'output su disco
address@hidden example
+
address@hidden
address@hidden tratta questo uso della funzione @code{system()} come un
+caso speciale, e si guarda bene dall'invocare la shell (o un altro
+interprete di comandi) con un comando nullo.
+Quindi, con @command{gawk}, questa maniera di procedere non @`e solo utile,
+ma @`e anche efficiente.
+Questo metodo dovrebbe funzionare anche con
+altre implementazioni di @command{awk}, ma non @`e detto che eviti una
+invocazione non necessaria della shell. (Altre implementazioni potrebbero
+limitarsi a forzare la scrittura del buffer associato con lo
+standard output, e non necessariamente di tutto l'output bufferizzato.)
+
+Avendo in mente le attese di un programmatore, sarebbe sensato che
address@hidden()} forzi la scrittura su disco di tutto l'output disponibile.
+Il programma seguente:
+
address@hidden
+BEGIN @{
+ print "prima riga stampata"
+ system("echo system echo")
+ print "seconda riga stampata"
address@hidden
address@hidden example
+
address@hidden
+deve stampare:
+
address@hidden
+prima riga stampata
+system echo
+seconda riga stampata
address@hidden example
+
address@hidden
+e non:
+
address@hidden
+system echo
+prima riga stampata
+seconda riga stampata
address@hidden example
+
+Se @command{awk} non forzasse la scrittura dei suoi buffer prima di
+invocare @code{system()}, l'output sarebbe quest'ultimo (quello non voluto).
address@hidden sidebar
+
address@hidden Funzioni di tempo
address@hidden Funzioni per gestire marcature temporali
address@hidden funzioni di tempo
+
address@hidden marcature temporali
address@hidden data e ora, si veda marcature temporali
address@hidden @dfn{log} (registro), file di, marcature temporali nei
address@hidden registro (@dfn{log}), file di, marcature temporali nel
address@hidden file di registro (@dfn{log}), marcature temporali nei
address@hidden @command{gawk}, data e ora (marcature temporali)
address@hidden POSIX @command{awk}, marcature temporali e
+I programmi @command{awk} sono frequentemente usati per elaborare file di
+registro [file con estensione .log], che contengono l'informazione sulla data e
+l'ora (marcatura temporale) in cui un particolare record @`e stato registrato
sul log.
+Molti programmi registrano questa informazione nel formato restituito
+dalla chiamata di sistema @code{time()}, la quale misura il numero di secondi
+trascorsi a partire da una certa data iniziale (Epoca). Nei sistemi aderenti
+allo standard POSIX, questo @`e il numero di secondi a partire dal primo
gennaio
+1970, ora di Greenwich (1970-01-01 00:00:00 UTC), senza includere i secondi
address@hidden FOR_PRINT
address@hidden
address@hidden@xrefIl{Glossario},
address@hidden iftex
address@hidden
address@hidden@xref{Glossario},
address@hidden ifnottex
+in particolare le voci ``Epoca'' e ``UTC.''}
address@hidden ifclear
address@hidden FOR_PRINT
+intercalari.
address@hidden ifset
+Tutti i sistemi noti aderenti allo standard POSIX gestiscono le marcature
+temporali da 0 fino a
address@hidden
address@hidden - 1},
address@hidden iftex
address@hidden
+2^31 - 1,
address@hidden ifinfo
address@hidden
address@hidden
address@hidden @minus{} 1,
address@hidden ifnotinfo
address@hidden ifnottex
+il che @`e sufficiente per rappresentare date e ore fino a inizio 2038
+(2038-01-19 03:14:07 UTC). Molti sistemi supportano una maggiore estensione
+di date, compresi dei valori negativi per rappresentare delle date
+anteriori all'Epoca.
+
address@hidden @command{date}, programma di address@hidden GNU
address@hidden programma di address@hidden @command{date} GNU
address@hidden tempo, ottenerlo
+Per facilitare l'elaborazione di tali file di registro, e per produrre
+dei rapporti utili, @command{gawk} prevede le seguenti funzioni per
+lavorare con le marcature temporali. Si tratta di estensioni @command{gawk};
+non sono previste nello standard address@hidden comando di address@hidden GNU
address@hidden address@hidden fare anche molte delle cose qui descritte.
address@hidden essere
+preferibile usarlo per semplici operazioni relative a data e ora in semplici
+script della shell.} Tuttavia, anche versioni recenti di @command{mawk}
+(@pxref{Altre versioni}) prevedono queste funzioni. I parametri facoltativi
+sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @code{mktime(@var{specifiche_data}} address@hidden,
@var{utc-flag}} address@hidden)}
address@hidden
address@hidden generare data e ora
+Trasforma @var{specifiche_data} in una marcatura temporale nello stesso formato
+restituito da @code{systime()}. @`E simile alla funzione omonima
+in ISO C. L'argomento, @var{specifiche_data}, @`e una stringa della forma
address@hidden@code{"@var{AAAA} @var{MM} @var{GG} @var{HH} @var{MM} @var{SS}
address@hidden"}}.
+La stringa consiste di sei o sette numeri che rappresentano,
+rispettivamente,
+l'anno in quattro cifre, il mese da 1 a 12, il giorno del mese
+da 1 a 31, l'ora del giorno da 0 a 23, il minuto da 0 a
+59, il secondo da 0 a 60,@footnote{Occasionalmente ci sono dei
+minuti in un anno con un secondo intercalare, il che spiega perch@'e i
+secondi possono arrivare fino a 60.}
+e un'indicazione opzionale relativa all'ora legale.
+
+I valori di questi numeri possono non essere negli intervalli specificati; per
+esempio, un'ora di @minus{}1 sta a indicare 1 ora prima di mezzanotte.
+Viene adottato il calendario gregoriano con l'origine posta all'anno zero,
+con l'anno 0 che viene prima dell'anno 1 e l'anno @minus{}1 che viene prima
+dell'anno 0. Se il flag @var{utc-flag} @`e specificato ed @`e diverso da zero
+e dalla stringa nulla, si suppone che l'ora sia quella del fuso orario UTC;
+altrimenti l'ora @`e considerata essere quella del fuso orario locale. Se
+l'indicatore dell'ora legale @`e positivo, si presuppone che l'ora sia quella
+legale; se @`e 0, l'ora considerata @`e quella di Greenwich (standard time); se
+invece @`e negativo (questo @`e il default), @code{mktime()} tenta di
+determinare se @`e in vigore l'ora legale o no, nel momento specificato.
+
+Se @var{specifiche_data} non contiene elementi in numero sufficiente, o se
+la data e ora risultante sono fuori dall'intervallo previsto,
address@hidden()} restituisce @minus{}1.
+
address@hidden @command{gawk}, vettore @code{PROCINFO} in
address@hidden @code{PROCINFO}, vettore
address@hidden vettore @code{PROCINFO}
address@hidden @code{strftime(address@hidden address@hidden,} @var{data_e_ora}
address@hidden,} @var{utc}] ] address@hidden)}
address@hidden
address@hidden formato stringa marcature temporali
address@hidden formato stringa data e ora
address@hidden data e ora, formato stringa
address@hidden marcature temporali, formato stringa
+Formatta la data e ora specificata da @var{data_e_ora} in base alle indicazioni
+contenute nella stringa @var{formato} e restituisce il risultato.
address@hidden simile alla funzione omonima in ISO C.
+Se @var{utc} @`e presente ed @`e diverso da zero o dalla stringa nulla,
+il valore @`e formattato come UTC (Tempo Coordinato Universale,
address@hidden noto come GMT o Tempo Medio di Greenwich).
+Altrimenti, il valore @`e formattato per il fuso orario locale.
+La stringa @var{data_e_ora} @`e nello stesso formato del valore restituito
+dalla funzione @code{systime()}. Se non si specifica l'argomento
address@hidden, @command{gawk} usa l'ora del giorno corrente per la
+formattazione.
+Omettendo l'argomento @var{formato}, @code{strftime()} usa
+il valore di @code{PROCINFO["strftime"]} come stringa di formattazione
+(@pxref{Variabili predefinite}).
+Il valore di default della stringa @`e
address@hidden@w{"%a %b %e %H:%M:%S %Z %Y"}}. Questa stringa di formattazione
+produce lo stesso output del programma di address@hidden equivalente
address@hidden
+Si address@hidden assegnare un nuovo valore a @code{PROCINFO["strftime"]} per
+modificare la formattazione di default; si veda
+la lista che segue per le varie direttive di formattazione.
+
address@hidden @code{systime()}
address@hidden
address@hidden marcature temporali
address@hidden data e ora, si veda marcature temporali
address@hidden data e ora corrente del sistema
+Restituisce l'ora corrente come numero di secondi a partire dall'Epoca
+del sistema. Sui sistemi aderenti allo standard POSIX, questo @`e il numero
+di secondi trascorsi a partire dal primo gennaio 1970, ora di Greenwich
+(1970-01-01 00:00:00 UTC), senza includere i secondi intercalari.
address@hidden table
+
+La funzione @code{systime()} consente di confrontare una marcatura temporale
+in un file di registro con la data e ora correnti. In particolare, @`e facile
+determinare quanto tempo prima un particolare record @`e stato registrato.
address@hidden anche possibile produrre record di registro usando il formato
+``secondi a partire dall'Epoca''.
+
address@hidden conversione di date in marcature temporali
address@hidden date, conversione in marcature temporali
address@hidden marcature temporali, conversione date nelle
+La funzione @code{mktime()} consente di convertire una rappresentazione in
+forma testuale di una data e ora in una marcatura temporale.
+Questo semplifica i confronti prima/dopo tra differenti date e ore, in
+particolare quando si abbia a che fare con date e ore provenienti da una
+fonte esterna, come un file di registro.
+
+La funzione @code{strftime()} permette di trasformare facilmente una marcatura
+temporale in un'informazione intelligibile. @`E analoga come tipo alla
funzione
address@hidden()} (@pxref{Funzioni per stringhe}), nel senso che copia
+letteralmente address@hidden che non @`e una specifica di formato nella
stringa che viene
+restituita, mentre sostituisce i valori di data e ora a seconda delle
+specifiche di formato contenute nella stringa @var{formato}.
+
address@hidden specificatori di formato, funzione @code{strftime()} di
(@command{gawk})
address@hidden formato, specificatori di, funzione @code{strftime()} di
(@command{gawk})
+Per @code{strftime()} lo standard
+1999 ISO address@hidden,
+non tutte le funzioni @code{strftime()} dei vari sistemi operativi
+ammettono tutte le conversioni qui elencate.}
+consente le seguenti specifiche di formattazione delle date:
+
address@hidden @code
address@hidden %a
+Il nome abbreviato del giorno della settimana nella lingua locale.
+
address@hidden %A
+Il nome completo del giorno della settimana nella lingua locale.
+
address@hidden %b
+Il nome abbreviato del mese dell'anno nella lingua locale.
+
address@hidden %B
+Il nome completo del mese dell'anno nella lingua locale.
+
address@hidden %c
+Il formato ``appropriato'' della rappresentazione della data e ora
+nella lingua locale.
+(Questo @`e @samp{%A %B %d %T %Y} per la localizzazione @code{"C"}.)
+
address@hidden %C
+La parte che designa il secolo nell'anno corrente.
+Si ottiene dividendo per 100 l'anno, e
+troncando verso il basso
+all'intero address@hidden vicino.
+
address@hidden %d
+Il giorno del mese come numero decimale (01--31).
+
address@hidden %D
+Equivale a specificare @samp{%m/%d/%y}.
+
address@hidden %e
+Il giorno del mese, preceduto da uno spazio se di tratta di una cifra sola.
+
address@hidden %F
+Equivale a specificare @samp{%Y-%m-%d}.
+Questo @`e il formato ISO 8601 della data.
+
address@hidden %g
+L'anno (ultime due cifre) ricavato prendendo il resto della divisione per 100
+dell'anno a cui appartiene la settimana, secondo ISO 8601, come numero decimale
+(00--99). Per esempio, il primo gennaio 2012, fa parte della settimana 53 del
+2011. Quindi, l'anno relativo al numero di settimana ISO di quella data @`e
2011
+(ossia 11), anche se la data in s@'e @`e nel 2012. Analogamente, il 31
dicembre
+2012, @`e nella prima settimana del 2013. Quindi, l'anno relativo al numero di
+settimana ISO di quella data @`e 2013 (ossia 13), anche se la data in s@'e @`e
nel
+2012.
+
address@hidden %G
+L'anno intero relativo al numero di settimana ISO, come numero decimale.
+
address@hidden %h
+Equivalente a @samp{%b}.
+
address@hidden %H
+L'ora (in un orologio a 24 ore) come numero decimale (00--23).
+
address@hidden %I
+L'ora (in un orologio a 12 ore) come numero decimale (01--12).
+
address@hidden %j
+Il giorno dell'anno come numero decimale (001--366).
+
address@hidden %m
+Il mese come numero decimale (01--12).
+
address@hidden %M
+Il minuto come numero decimale (00--59).
+
address@hidden %n
+Un carattere di ritorno a capo (ASCII LF).
+
address@hidden %p
+L'equivalente nella lingua locale delle designazioni AM/PM
+(mattino/pomerigggio) associate a un orologio a 12 ore.
+
address@hidden %r
+L'ora locale nel formato a 12 ore.
+(Questo @`e @samp{%I:%M:%S %p} nella localizzazione @code{"C"}.)
+
address@hidden %R
+Equivalente a specificare @samp{%H:%M}.
+
address@hidden %S
+Il secondo come numero decimale (00--60).
+
address@hidden %t
+Un carattere di tabulazione [TAB].
+
address@hidden %T
+Equivalente a specificare @samp{%H:%M:%S}.
+
address@hidden %u
+Il numero del giorno della settimana come numero decimale (1--7).
address@hidden@dotless{i}} @`e il giorno numero 1.
+
address@hidden %U
+Il numero di settimana dell'anno (con la prima domenica dell'anno presa
+come primo giorno della prima settimana) come numero decimale (00--53).
+
address@hidden @cindex ISO 8601
address@hidden %V
+Il numero di settimana dell'anno (con il primo address@hidden@dotless{i}}
dell'anno preso
+come primo giorno della prima settimana) come numero decimale (01--53).
+Il metodo per determinare il numero di settimana @`e quello specificato
+dallo standard ISO 8601.
+(In pratica: se la settimana che contiene il primo gennaio ha quattro o
address@hidden giorni nel nuovo anno, allora
address@hidden la settimana numero uno; altrimenti @`e l'ultima settimana
+[52 o 53] dell'anno
+precedente, e la settimana successiva @`e la settimana numero uno.)
+
address@hidden %w
+Il giorno della settimana come numero decimale (0--6).
+Domenica @`e il giorno zero.
+
address@hidden %W
+Il numero di settimana dell'anno (con il primo address@hidden@dotless{i}} come
primo giorno
+della settimana numero uno)
+come numero decimale (00--53).
+
address@hidden %x
+Il formato ``appropriato'' della rappresentazione della data
+nella lingua locale.
+(Questo @`e @samp{%A %B %d %Y} nella localizzazione @code{"C"}.)
+
address@hidden %X
+Il formato ``appropriato'' della rappresentazione della data.
+(Questo @`e @samp{%T} nella localizzazione @code{"C"}.)
+
address@hidden %y
+L'anno modulo 100 (le ultime due cifre) come numero decimale (00--99).
+
address@hidden %Y
+L'anno come numero decimale (p.es., 2015).
+
address@hidden @cindex RFC 822
address@hidden @cindex RFC 1036
address@hidden %z
+La differenza di fuso orario [rispetto all'ora di Greenwich] in formato
address@hidden@var{OOMM}} (p.es., il
+formato necessario per produrre intestazioni di data conformi agli standard
+RFC 822/RFC 1036).
+
address@hidden %Z
+Il nome o l'abbreviazione della zona di fuso orario (@dfn{time zone}); se il
fuso
+orario non @`e determinabile, @`e impostata alla stringa nulla.
+
address@hidden %Ec %EC %Ex %EX %Ey %EY %Od %Oe %OH
address@hidden %OI %Om %OM %OS %Ou %OU %OV %Ow %OW %Oy
+``notazioni alternative'' di specifica
+in cui solo la seconda lettera (@samp{%c}, @samp{%C} e
address@hidden@dotless{i}} via) @`e
address@hidden questo risulta incomprensibile, non @`e il
+caso di preoccuparsi; queste notazioni hanno lo scopo di facilitare
+la ``internazionalizzazione'' dei programmi.
+Altre address@hidden di internazionalizzazione sono descritte in
address@hidden
+(Queste facilitano la address@hidden con il programma di address@hidden
+POSIX @command{date}.)
+
address@hidden %%
+Un singolo carattere @samp{%}.
address@hidden table
+
+Se uno specificatore di conversione non @`e tra quelli elencati sopra, il
+comportamento @`e address@hidden @`e perch@'e ISO C lascia
+indefinito il comportamento della versione C di @code{strftime()} e
address@hidden usa la versione di sistema di @code{strftime()},
+se disponibile.
+Tipicamente, lo specificatore di conversione "non previsto" non appare
+nella stringa risultante, o appare address@hidden@dotless{i}} come @`e
scritto.}
+
+Per sistemi che non aderiscono completamente agli standard
address@hidden utilizza una copia di
address@hidden()} dalla libreria C di GNU.
+Sono disponibili tutte le specifiche di formato sopra elencate.
+Se la detta versione @`e
+usata per compilare @command{gawk} (@pxref{Installazione}),
+sono disponibili anche le seguenti ulteriori specifiche di formato:
+
address@hidden @code
address@hidden %k
+L'ora (in un orologio a 24 ore) come numero decimale (0--23).
+I numeri di una sola cifra sono preceduti da uno spazio bianco.
+
address@hidden %l
+L'ora (in un orologio a 12 ore) come numero decimale (1--12).
+I numeri di una sola cifra sono preceduti da uno spazio bianco.
+
address@hidden
address@hidden %N
+Il nome dell'``Imperatore/Era''.
+Equivalente a @samp{%C}.
+
address@hidden %o
+L'anno dell'``Imperatore/Era''.
+Equivalente a @samp{%y}.
address@hidden ignore
+
address@hidden %s
+L'ora espressa in numero di secondi a partire dall'Epoca.
+
address@hidden
address@hidden %v
+La data in formato VMS (p.es., @samp{20-JUN-1991}).
address@hidden ignore
address@hidden table
+
+In aggiunta a address@hidden, le notazioni alternative sono riconosciute, ma al
+loro posto sono usate quelle normali.
+
address@hidden @code{date}, programma di address@hidden POSIX
address@hidden programma di address@hidden POSIX @code{date}
address@hidden POSIX @command{awk}, programma di address@hidden @code{date} e
+Il seguente esempio @`e un'implementazione @command{awk} del
+programma di address@hidden POSIX @command{date}.
+Normalmente, il programma di address@hidden @command{date} stampa la
+data e l'ora corrente nel formato ben noto. Tuttavia, se si
+specifica al comando un argomento che inizia con un @samp{+}, @command{date}
+copia i caratteri che non sono specifiche di formato nello standard output
+e interpreta l'ora corrente secondo gli specificatori di formato
+contenuti nella stringa. Per esempio:
+
address@hidden
+$ @kbd{date '+Oggi @`e %A, %d %B %Y.'}
address@hidden Oggi @`e address@hidden@dotless{i}}, 22 settembre 2014.
address@hidden example
+
+Ecco la versione @command{gawk} del programma di address@hidden @command{date}.
address@hidden all'interno di uno script di shell per gestire l'opzione
@option{-u},
+che richiede che @command{date} sia eseguito come se il fuso orario
+fosse impostato a UTC:
+
address@hidden
+#! /bin/sh
+#
+# date --- simula il comando POSIX 'date'
+
+case $1 in
+-u) TZ=UTC0 # usare UTC
+ export TZ
+ shift ;;
+esac
+
+gawk 'BEGIN @{
+ formato = PROCINFO["strftime"]
+ codice_di_ritorno = 0
+
+ if (ARGC > 2)
+ codice_di_ritorno = 1
+ else if (ARGC == 2) @{
+ formato = ARGV[1]
+ if (formato ~ /^\+/)
+ formato = substr(formato, 2) # togli il + iniziale
+ @}
+ print strftime(formato)
+ exit codice_di_ritorno
address@hidden' "$@@"
address@hidden example
+
address@hidden Funzioni a livello di bit
address@hidden Funzioni per operazioni di manipolazione bit
address@hidden bit, funzioni per la manipolazione di
address@hidden manipolazione di bit, funzioni per la
address@hidden funzioni per la manipolazione di bit
address@hidden bit, operazioni sui
address@hidden AND, operazione sui bit
address@hidden OR, operazione sui bit
address@hidden XOR, operazione sui bit
address@hidden operazioni sui bit
address@hidden
address@hidden posso spiegarlo per te, ma non posso capirlo per te.}
address@hidden Anonimo
address@hidden quotation
+
+Molti linguaggi consentono di eseguire operazioni @dfn{bit a bit}
+su due numeri interi. In altre parole, l'operazione @`e eseguita
+su ogni successiva coppia di bit presi da ognuno dei due operandi.
+Tre operazioni comuni sono AND, OR e XOR bit a bit.
+Queste operazioni sono descritte nella @ref{table-bitwise-ops}.
+
address@hidden 11/2014: Postprocessing turns the docbook informaltable
address@hidden into a table. Hurray for scripting!
address@hidden Tabella,table-bitwise-ops
address@hidden a livello di bit}
address@hidden
address@hidden
address@hidden
address@hidden
+ Operatore booleano
+ | AND | OR | XOR
+ |---+---+---+---+---+---
+Operandi | 0 | 1 | 0 | 1 | 0 | 1
+----------+---+---+---+---+---+---
+ 0 | 0 0 | 0 1 | 0 1
+ 1 | 0 1 | 1 1 | 1 0
address@hidden verbatim
address@hidden display
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+\centerline{
+\vbox{\bigskip % space above the table (about 1 linespace)
+% Because we have vertical rules, we can't let TeX insert interline space
+% in its usual way.
+\offinterlineskip
+\halign{\strut\hfil#\quad\hfil % operands
+ &\vrule#&\quad#\quad % rule, 0 (of and)
+ &\vrule#&\quad#\quad % rule, 1 (of and)
+ &\vrule# % rule between and and or
+ &\quad#\quad % 0 (of or)
+ &\vrule#&\quad#\quad % rule, 1 (of of)
+ &\vrule# % rule between or and xor
+ &\quad#\quad % 0 of xor
+ &\vrule#&\quad#\quad % rule, 1 of xor
+ \cr
+&\omit&\multispan{11}\hfil\bf Operatore booleano\hfil\cr
+\noalign{\smallskip}
+& &\multispan3\hfil AND\hfil&&\multispan3\hfil OR\hfil
+ &&\multispan3\hfil XOR\hfil\cr
+\bf Operandi&&0&&1&&0&&1&&0&&1\cr
+\noalign{\hrule}
+\omit&height 2pt&&\omit&&&&\omit&&&&\omit\cr
+\noalign{\hrule height0pt}% without this the rule does not extend; why?
+0&&0&\omit&0&&0&\omit&1&&0&\omit&1\cr
+1&&0&\omit&1&&1&\omit&1&&1&\omit&0\cr
+}}}
address@hidden tex
+
address@hidden
+<informaltable>
+
+<tgroup cols="7" colsep="1">
+<colspec colname="c1"/>
+<colspec colname="c2"/>
+<colspec colname="c3"/>
+<colspec colname="c4"/>
+<colspec colname="c5"/>
+<colspec colname="c6"/>
+<colspec colname="c7"/>
+<spanspec spanname="optitle" namest="c2" nameend="c7" align="center"/>
+<spanspec spanname="andspan" namest="c2" nameend="c3" align="center"/>
+<spanspec spanname="orspan" namest="c4" nameend="c5" align="center"/>
+<spanspec spanname="xorspan" namest="c6" nameend="c7" align="center"/>
+
+<tbody>
+<row>
+<entry colsep="0"></entry>
+<entry spanname="optitle"><emphasis role="bold">Operatore
booleano</emphasis></entry>
+</row>
+
+<row rowsep="1">
+<entry rowsep="0"></entry>
+<entry spanname="andspan">AND</entry>
+<entry spanname="orspan">OR</entry>
+<entry spanname="xorspan">XOR</entry>
+</row>
+
+<row rowsep="1">
+<entry ><emphasis role="bold">Operandi</emphasis></entry>
+<entry colsep="0">0</entry>
+<entry colsep="1">1</entry>
+<entry colsep="0">0</entry>
+<entry colsep="1">1</entry>
+<entry colsep="0">0</entry>
+<entry colsep="1">1</entry>
+</row>
+
+<row>
+<entry align="center">0</entry>
+<entry colsep="0">0</entry>
+<entry>0</entry>
+<entry colsep="0">0</entry>
+<entry>1</entry>
+<entry colsep="0">0</entry>
+<entry>1</entry>
+</row>
+
+<row>
+<entry align="center">1</entry>
+<entry colsep="0">0</entry>
+<entry>1</entry>
+<entry colsep="0">1</entry>
+<entry>1</entry>
+<entry colsep="0">1</entry>
+<entry>0</entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
address@hidden docbook
address@hidden float
+
address@hidden bit, complemento a livello di
address@hidden complemento a livello di bit
+Come si vede, il risultato di un'operazione di AND @`e 1 solo quando
address@hidden i bit sono 1.
+Il risultato di un'operazione di OR @`e 1 se @emph{almeno un} bit @`e 1.
+Il risultato di un'operazione di XOR @`e 1 se l'uno o l'altro
+bit @`e 1, ma non tutti e due.
+La successiva operazione @`e il @dfn{complemento}; il complemento di 1 @`e 0 e
+il complemento di 0 @`e 1. Quindi, quest'operazione ``inverte'' tutti i bit
+di un dato valore.
+
address@hidden bit, spostamento di
address@hidden spostamento a sinistra, bit a bit
address@hidden spostamento a destra, bit a bit
address@hidden spostamento, bit a bit
+Infine, due altre operazioni comuni consistono nello spostare i bit
+a sinistra o a destra.
+Per esempio, se si ha una stringa di bit @samp{10111001} e la si sposta
+a destra di tre bit, si ottiene @address@hidden esempio
+presuppone che degli zeri riempiano le posizioni a sinistra.
+Per @command{gawk}, @`e sempre
address@hidden@dotless{i}}, ma in alcuni linguaggi @`e possibile che le
posizioni a sinistra
+siano riempite con degli uno.}
+Partendo nuovamente da @samp{10111001} e spostandolo a sinistra di tre
+bit, si ottiene @samp{11001000}. La lista seguente descrive
+le funzioni predefinite di @command{gawk} che rendono disponibili
+le operazioni a livello di bit.
+I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @command{gawk}, operazioni a livello di bit in
address@hidden @code
address@hidden
address@hidden AND, operazione sui bit
address@hidden @code{and(address@hidden@code{,} @var{v2} address@hidden,}
@address@hidden)}
+Restituisce l'AND bit a bit degli argomenti.
+Gli argomenti devono essere almeno due.
+
address@hidden
address@hidden complemento a livello di bit
address@hidden @code{compl(@var{val})}
+Restituisce il complemento bit a bit di @var{val}.
+
address@hidden
address@hidden spostamento a sinistra
address@hidden @code{lshift(@var{val}, @var{contatore})}
+Restituisce il valore di @var{val}, spostato a sinistra di
address@hidden bit.
+
address@hidden
address@hidden OR, operazione sui bit
address@hidden @code{or(address@hidden@code{,} @var{v2} address@hidden,}
@address@hidden)}
+Restituisce l'OR bit a bit degli argomenti.
+Gli argomenti devono essere almeno due.
+
address@hidden
address@hidden spostamento a destra
address@hidden @code{rshift(@var{val}, @var{contatore})}
+Restituisce il valore di @var{val}, spostato a destra
+di @var{contatore} bit.
+
address@hidden
address@hidden XOR, operazione sui bit
address@hidden @code{xor(address@hidden@code{,} @var{v2} address@hidden,}
@address@hidden)}
+Restituisce il XOR bit a bit degli argomenti.
+Gli argomenti devono essere almeno due.
address@hidden table
+
address@hidden ATTENZIONE
+A partire dalla versione di @command{gawk} @value{PVERSION} 4.2, gli operandi
+negativi non sono consentiti per nessuna di queste funzioni. Un operando
+negativo produce un errore fatale. Si veda la nota a lato
+``Attenzione. Non @`e tutto oro quel che luccica!'' per maggiori informazioni
sul perch@'e.
address@hidden quotation
+
+Ecco una funzione definita dall'utente (@pxref{Funzioni definite dall'utente})
+che illustra l'uso di queste funzioni:
+
address@hidden @code{bits2str()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{bits2str()}
address@hidden @code{testbits.awk}, programma
address@hidden programma @code{testbits.awk}
address@hidden
address@hidden
address@hidden file eg/lib/bits2str.awk
+# bits2str --- decodifica un byte in una serie di 0/1 leggibili
+
+function bits2str(byte, dati, maschera)
address@hidden
+ if (byte == 0)
+ return "0"
+
+ maschera = 1
+ for (; byte != 0; stringa = rshift(stringa, 1))
+ dati = (and(byte, maschera) ? "1" : "0") dati
+
+ while ((length(dati) % 8) != 0)
+ dati = "0" dati
+
+ return dati
address@hidden
address@hidden endfile
address@hidden group
+
address@hidden this is a hack to make testbits.awk self-contained
address@hidden
address@hidden file eg/prog/testbits.awk
+# bits2str --- turn a byte into readable 1's and 0's
+
+function bits2str(bits, data, mask)
address@hidden
+ if (bits == 0)
+ return "0"
+
+ mask = 1
+ for (; bits != 0; bits = rshift(bits, 1))
+ data = (and(bits, mask) ? "1" : "0") data
+
+ while ((length(data) % 8) != 0)
+ data = "0" data
+
+ return data
address@hidden
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/testbits.awk
+BEGIN @{
+ printf "123 = %s\n", bits2str(123)
+ printf "0123 = %s\n", bits2str(0123)
+ printf "0x99 = %s\n", bits2str(0x99)
+ comp = compl(0x99)
+ printf "compl(0x99) = %#x = %s\n", comp, bits2str(comp)
+ shift = lshift(0x99, 2)
+ printf "lshift(0x99, 2) = %#x = %s\n", shift, bits2str(shift)
+ shift = rshift(0x99, 2)
+ printf "rshift(0x99, 2) = %#x = %s\n", shift, bits2str(shift)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Questo programma produce il seguente output quando viene eseguito:
+
address@hidden
+$ @kbd{gawk -f testbits.awk}
address@hidden 123 = 01111011
address@hidden 0123 = 01010011
address@hidden 0x99 = 10011001
address@hidden compl(0x99) = 0x3fffffffffff66 =
001111111111111111111111111111111
address@hidden 11111111111111101100110
address@hidden lshift(0x99, 2) = 0x264 = 0000001001100100
address@hidden rshift(0x99, 2) = 0x26 = 00100110
address@hidden example
+
address@hidden conversione da stringhe a numeri
address@hidden stringhe, conversione
address@hidden numeri, conversione in stringhe
address@hidden conversione da numeri a stringhe
address@hidden numero visto come stringa di bit
+La funzione @code{bits2str()} trasforma un numero binario in una stringa.
+Inizializzando @code{maschera} a uno otteniamo
+un valore binario in cui il bit address@hidden a destra @`e impostato a
+uno. Usando questa maschera,
+la funzione continua a controllare il bit address@hidden a destra.
+l'operazione di AND tra la maschera e il valore indica se il
+bit address@hidden a destra @`e uno oppure no. Se questo @`e il caso, un
@code{"1"}
address@hidden concatenato all'inizio della stringa.
+Altrimenti, @`e concatenato uno @code{"0"}.
+Il valore @`e quindi spostato a destra di un bit e il ciclo continua
+finch@'e non ci sono address@hidden bit.
+
+Se il valore iniziale @`e zero, viene restituito semplicemente uno @code{"0"}.
+Altrimenti, alla fine, al valore ottenuto vengono aggiunti degli zeri a
+sinistra, per arrivare a stringhe
+di lunghezza multipla di 8, ossia contenenti un numero intero di byte.
+Questo @`e tipico dei computer moderni.
+
+Il codice principale nella regola @code{BEGIN} mostra la differenza tra
+i valori decimale e ottale dello stesso numero.
+(@pxref{Numeri non-decimali}),
+e poi mostra i risultati delle funzioni
address@hidden()}, @code{lshift()} e @code{rshift()}.
+
address@hidden Attenzione. Non @`e tutto oro quel che luccica!
+
+In altri linguaggi, le operazioni "bit a bit" sono eseguite su valori interi,
+non su valori a virgola mobile. Come regola generale, tali operazioni
+funzionano meglio se eseguite su interi senza segno.
+
address@hidden tenta di trattare gli argomenti delle funzioni
+"bit a bit" come interi senza segno. Per questo motivo, gli argomenti negativi
+provocano un errore fatale.
+
+In una normale operazione, per tutte queste funzioni, prima il valore a virgola
+mobile a doppia precisione viene convertito nel tipo intero senza segno di C
address@hidden ampio, poi viene eseguita l'operazione "bit a bit". Se il
risultato non
address@hidden essere rappresentato esattamente come un tipo @code{double} di C,
+vengono rimossi i bit iniziali diversi da zero uno alla volta finch@'e
+non sono rappresentati esattamente. Il risultato @`e poi nuovamente convertito
+in un tipo @code{double} di address@hidden essere address@hidden chiari,
+la conseguenza @`e che @command{gawk} address@hidden memorizzare solo un
determinato
+intervallo di valori interi; i numeri al di fuori di questo intervallo vengono
+ridotti per rientrare all'interno dell'intervallo.}
+
+Comunque, quando si usa il calcolo con precisione arbitraria con l'opzione
address@hidden (@pxref{Calcolo con precisione arbitraria}), il risultato
address@hidden
+essere diverso. Questo @`e particolarmente evidente con la funzione
@code{compl()}:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print compl(42) @}'}
address@hidden 9007199254740949
+$ @kbd{gawk -M 'BEGIN @{ print compl(42) @}'}
address@hidden -43
address@hidden example
+
+Quel che avviene diventa chiaro quando si stampano i risultati
+in notazione esadecimale:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "%#x\n", compl(42) @}'}
address@hidden 0x1fffffffffffd5
+$ @kbd{gawk -M 'BEGIN @{ printf "%#x\n", compl(42) @}'}
address@hidden 0xffffffffffffffd5
address@hidden example
+
+Quando si usa l'opzione @option{-M}, nel dettaglio, @command{gawk} usa
+gli interi a precisione arbitraria di GNU MP che hanno almeno 64 bit di
precisione.
+Quando non si usa l'opzione @option{-M}, @command{gawk} memorizza i valori
+interi come regolari valori a virgola mobile con doppia precisione, che
+mantengono solo 53 bit di precisione. Inoltre, la libreria GNU MP tratta
+(o almeno sembra che tratti) il bit iniziale come un bit con segno;
address@hidden il
+risultato con @option{-M} in questo caso @`e un numero negativo.
+
+In breve, usare @command{gawk} per qualsiasi tipo di operazione "bit a bit",
+tranne le address@hidden semplici, probabilmente @`e una cattiva idea; caveat
emptor!
+
address@hidden sidebar
+
address@hidden Funzioni per i tipi
address@hidden Funzioni per conoscere il tipo di una variabile
+
address@hidden prevede due funzioni che permettono di conoscere
+il tipo di una variabile.
+Questo @`e necessario per scrivere del codice che visiti ogni elemento di un
+vettore di vettori
+(@pxref{Vettori di vettori}) e in altri contesti.
+
address@hidden @code
address@hidden
address@hidden scalare o vettore
address@hidden isarray(@var{x})
+Restituisce il valore 'vero' se @var{x} @`e un vettore. Altrimenti, restituisce
+'falso'.
+
address@hidden
address@hidden variabile, tipo di una
address@hidden tipo di una variabile
address@hidden typeof(@var{x})
+Restituisce una delle stringhe seguenti, a seconda del tipo di @var{x}:
+
address@hidden nested table
address@hidden @code
address@hidden "array"
address@hidden @`e un vettore.
+
address@hidden "regexp"
address@hidden @`e una @dfn{regexp} fortemente tipizzata
+(@pxref{Costanti @dfn{regexp} forti}).
+
address@hidden "number"
address@hidden @`e un numero.
+
address@hidden "string"
address@hidden @`e una stringa.
+
address@hidden "strnum"
address@hidden @`e un numero che ha avuto origine da un input dell'utente,
+come un campo o il risultato di una chiamata a @code{split()}.
+(address@hidden, @var{x} ha l'attributo @dfn{strnum};
address@hidden di variabile}.)
+
address@hidden "unassigned"
address@hidden @`e una variabile scalare a cui non @`e ancora stato assegnato
un valore.
+Per esempio:
+
address@hidden
+BEGIN @{
+ # crea a[1] ma non gli attribuisce alcun valore
+ a[1]
+ print typeof(a[1]) # unassigned
address@hidden
address@hidden example
+
address@hidden "untyped"
address@hidden non @`e stata usata per nulla; address@hidden diventare uno
scalare o un
+vettore.
+Per esempio:
+
address@hidden
+BEGIN @{
+ print typeof(x) # x non @`e mai stato usato --> untyped
+ mk_arr(x)
+ print typeof(x) # x ora @`e un vettore --> array
address@hidden
+
+function mk_arr(a) @{ a[1] = 1 @}
address@hidden example
+
address@hidden table
address@hidden table
+
address@hidden()} torna utile in due occasioni. La prima @`e quando
+si visita un vettore multidimensionale: si address@hidden stabilire se un
elemento @`e
+un vettore oppure no. La seconda @`e all'interno del corpo di una funzione
+definita dall'utente (argomento non ancora trattato;
address@hidden definite dall'utente}), per determinare se un parametro
address@hidden un vettore oppure no.
+
address@hidden NOTA
+Usare @code{isarray()} a livello globale per controllare le variabili
+non ha alcun senso. Si suppone infatti che chi scrive il programma
+sappia se una variabile @`e un vettore oppure no. E in
+effetti, per come funziona @command{gawk}, se si passa una variabile
+che non sia stata usata in precedenza a @code{isarray()}, @command{gawk}
+la crea al volo, assegnandole il tipo scalare.
address@hidden quotation
+
+La funzione @code{typeof()} @`e generale; consente di determinare
+se una variabile o un parametro di funzione @`e uno scalare, un vettore,
+o una @dfn{regexp} fortemente tipizzata.
+
+L'uso di @code{isarray()} @`e deprecato; si dovrebbe usare @code{typeof()}
+al suo posto. Si dovrebbe sostituire ogni uso esistente di
address@hidden(var)} nei programmi esistenti con
address@hidden(var) == "array"}.
+
address@hidden Funzioni di internazionalizzazione
address@hidden Funzioni per tradurre stringhe
address@hidden @command{gawk}, funzioni di traduzione di stringhe
address@hidden funzioni di traduzione di stringhe
address@hidden traduzione di stringhe, funzioni di
address@hidden internazionalizzazione
address@hidden programmi @command{awk}, internazionalizzare
+
address@hidden prevede strumenti per internazionalizzare i programmi
address@hidden
+Questi sono costituiti dalle funzioni descritte nella lista seguente.
+Le descrizioni sono volutamente concise.
address@hidden,
+per un'esposizione completa.
+I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+
address@hidden @asis
address@hidden
address@hidden impostare directory con catalogo messaggi tradotti
address@hidden messaggi tradotti, impostare directory con catalogo
address@hidden @code{bindtextdomain(@var{directory}} address@hidden,}
@address@hidden)}
+Imposta la directory in cui
address@hidden trova i file di traduzione dei messaggi, nel caso in cui
+non siano o non possano essere messi nelle directory ``standard''
+(p.es., durante la fase di test di un programma).
+Restituisce la directory alla quale @var{dominio} @`e ``connesso.''
+
+Il default per @var{dominio} @`e il valore di @code{TEXTDOMAIN}.
+Se @var{directory} @`e la stringa nulla (@code{""}),
address@hidden()} restituisce la connessione corrente per il
address@hidden dato.
+
address@hidden
address@hidden traduzione di stringhe
address@hidden @code{dcgettext(@var{stringa}} address@hidden,} @var{dominio}
address@hidden,} @var{categoria}] address@hidden)}
+Restituisce la traduzione di @var{stringa} nel
+dominio linguistico @var{dominio} per la categoria di localizzazione
address@hidden
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
+
address@hidden
address@hidden @code{dcngettext(@var{stringa1}, @var{stringa2}, @var{numero}}
address@hidden,} @var{dominio} address@hidden,} @var{categoria}]
address@hidden)}
+Restituisce la forma plurale usata per @var{numero} nella
+traduzione di @var{stringa1} e @var{stringa2} nel dominio di testo
address@hidden per la categoria di localizzazione @var{categoria}.
address@hidden @`e la variante al singolare in inglese di un messaggio e
address@hidden @`e la variante al plurare in inglese dello stesso messaggio.
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
address@hidden table
+
address@hidden Funzioni definite dall'utente
address@hidden Funzioni definite dall'utente
+
address@hidden funzioni definite dall'utente
address@hidden utente, funzioni definite dall'
+Programmi @command{awk} complessi spesso possono essere semplificati
+definendo delle apposite funzioni personali.
+Le funzioni definite dall'utente sono richiamate allo stesso modo di quelle
+predefinite
+(@pxref{Chiamate di funzione}),
+ma dipende dall'utente la loro definizione
+(address@hidden, dire ad @command{awk} cosa dovrebbero fare queste funzioni).
+
address@hidden
+* Sintassi delle definizioni:: Come scrivere definizioni e cosa
+ significano.
+* Esempio di funzione:: Un esempio di definizione di
+ funzione e spiegazione della stessa.
+* Precisazioni sulle funzioni:: Cose a cui prestare attenzione.
+* Istruzione return:: Specificare il valore che una
+ funzione restituisce.
+* Variabili di tipo dinamico:: Come cambiare tipo a una variabile in
+ fase di esecuzione del programma.
address@hidden menu
+
address@hidden Sintassi delle definizioni
address@hidden Come scrivere definizioni e cosa significano
+
address@hidden
address@hidden al vero affermare che la sintassi di awk per la definizione
+di variabili locali @`e semplicemente atroce.}
address@hidden Brian Kernighan
address@hidden quotation
+
address@hidden funzioni, definizione di
address@hidden definizione di funzioni
+Definizioni di funzioni possono stare in una posizione qualsiasi tra le regole
+di un programma @command{awk}. Quindi, la forma generale di un
+programma @command{awk} @`e estesa per
+permettere l'inclusione di regole @emph{e} la definizione di funzioni
+create dall'utente.
+Non @`e necessario che la definizione di una funzione sia posta prima
+del richiamo della stessa. Questo dipende dal fatto che @command{awk}
+legge l'intero programma, prima di iniziare ad eseguirlo.
+
+La definizione di una funzione chiamata @var{nome} @`e simile a questa:
+
address@hidden
address@hidden @address@hidden(address@hidden@code{)}
address@hidden@{}
+ @var{corpo-della-funzione}
address@hidden@}}
address@hidden display
+
address@hidden nomi di funzione
address@hidden funzioni, nomi di
address@hidden limitazioni nei nomi di funzione
address@hidden nomi di funzione, limitazioni nei
address@hidden
+Qui, @var{nome} @`e il nome della funzione da definire. Un nome di funzione
+valido @`e come un nome di variabile valido: una sequenza di
+lettere, cifre e trattini bassi che non inizia con una cifra.
+Anche qui, solo le 52 lettere inglesi maiuscole e minuscole possono
+essere usate in un nome di funzione.
+All'interno di un singolo programma @command{awk}, un dato nome address@hidden
essere
+usato una sola volta: per una variabile, o per un vettore,
+o per una funzione.
+
address@hidden @`e una lista opzionale degli argomenti della funzione
+e dei nomi delle variabili locali,
+separati da virgole. Quando la funzione viene chiamata,
+i nomi degli argomenti sono usati per contenere il valore degli argomenti
+passati con la chiamata.
+
+Una funzione non address@hidden avere due parametri con lo stesso nome, e
neanche un
+parametro con lo stesso nome della funzione stessa.
+
address@hidden ATTENZIONE
+Secondo lo standard POSIX, i parametri di funzione
+non possono avere lo stesso nome di una delle speciali variabili predefinite
+(@pxref{Variabili predefinite}), e un parametro di funzione non address@hidden
avere
+lo stesso nome di un'altra funzione.
+Non tutte le versioni di @command{awk} applicano queste limitazioni.
address@hidden applica solo la prima di queste restrizioni.
+Se viene specificata l'opzione @option{--posix} (@pxref{Opzioni}),
+anche la seconda restrizione viene applicata.
address@hidden quotation
+
+Le variabili locali si comportano come la stringa vuota
+se vengono utilizzate dove @`e richiesto il valore di una stringa,
+e valgono zero se utilizzate dove @`e richiesto un valore numerico.
+Questo @`e lo stesso comportamento delle variabili regolari a cui non sia
+stato ancora assegnato un valore. (Ci sono ulteriori informazioni riguardo
+alle variabili locali;
address@hidden di tipo dinamico}.)
+
+Il @var{corpo-della-funzione} @`e composto da istruzioni @command{awk}.
+Questa @`e la parte address@hidden importante della definizione, perch@'e dice
quello che
+la funzione dovrebbe realmente
address@hidden I nomi di argomento esistono per consentire al corpo della
+funzione di gestire gli argomenti;
+le variabili locali esistono per consentire al corpo della funzione di
+memorizzare dei valori temporanei.
+
+I nomi di argomento non sono sintatticamente distinti da quelli delle
+variabili locali. Invece, il numero di argomenti forniti quando la
+funzione viene chiamata determina quanti degli argomenti passati sono delle
+variabili. Quindi, se tre valori di argomento sono specificati, i primi
+tre nomi in @var{lista-parametri}
+sono degli argomenti e i rimanenti sono delle variabili locali.
+
+Ne consegue che se il numero di argomenti richiesto non @`e lo stesso in
+tutte le chiamate alla funzione, alcuni dei nomi in @var{lista-parametri}
+possono essere in alcuni casi degli argomenti e in altri casi
+delle variabili locali. Un'altra angolatura da cui guardare questo fatto
address@hidden che gli argomenti omessi assumono come valore di default la
stringa nulla.
+
address@hidden convenzioni di programmazione, nella scrittura di funzioni
address@hidden funzioni, convenzioni di programmazione, nella scrittura di
+Solitamente, quando si scrive una funzione, si sa quanti nomi si intendono
+usare per gli argomenti e quanti si vogliono usare come variabili locali.
address@hidden una convenzione in uso quella di aggiungere alcuni spazi extra
tra gli
+argomenti e le variabili locali, per documentare come va utilizzata quella
+funzione.
+
address@hidden variabili nascoste
address@hidden nascondere valori di variabile
+Durante l'esecuzione del corpo della funzione, gli argomenti e i valori
+delle variabili locali
+nascondono, o @dfn{oscurano}, qualsiasi variabile dello stesso nome usata
+nel resto del programma. Le variabili oscurate non sono accessibili
+nel corpo della funzione, perch@'e non c'@`e modo di accedere a esse
+mentre i loro nomi sono stati "occupati" dagli argomenti e dalla variabili
+locali. Tutte le altre variabili usate nel programma @command{awk}
+possono essere accedute o impostate normalmente nel corpo della funzione.
+
+Gli argomenti e le variabili locali esistono solo finch@'e il corpo della
+funzione @`e in esecuzione. Una volta che l'esecuzione @`e terminata,
+ritornano accessibili le variabili che erano oscurate
+durante l'esecuzione della funzione.
+
address@hidden ricorsive, funzioni
address@hidden funzioni ricorsive
+Il corpo della funzione address@hidden contenere espressioni che chiamano altre
+funzioni. Tali espressioni possono perfino chiamare direttamente, o
+indirettamente tramite un'altra funzione, la funzione stessa.
+Quando questo succede, la funzione @`e detta @dfn{ricorsiva}.
+Il fatto che una funzione richiami se stessa @`e detto @dfn{ricorsione}.
+
+Tutte le funzioni predefinite restituiscono un valore al loro chiamante.
+Anche le funzioni definite dall'utente possono farlo, usando
+l'istruzione @code{return},
+che @`e descritta in dettaglio nella @ref{Istruzione return}.
+Molti dei successivi esempi in questa @value{SECTION} usano
+l'istruzione @code{return}.
+
address@hidden estensioni comuni, parola chiave @code{func}
address@hidden @cindex @command{awk} language, POSIX version
address@hidden @cindex POSIX @command{awk}
address@hidden POSIX @command{awk}, parola chiave @code{function} in
+In molte implementazioni di @command{awk}, compreso @command{gawk},
+la parola chiave @code{function} address@hidden essere
+abbreviata come @code{func}. @value{COMMONEXT}
+Tuttavia, POSIX specifica solo l'uso della parola chiave
address@hidden Questo ha alcune implicazioni di carattere pratico.
+Se @command{gawk} @`e in address@hidden POSIX-compatibile
+(@pxref{Opzioni}), la seguente
+istruzione @emph{non} definisce una funzione:
+
address@hidden
+func foo() @{ a = sqrt($1) ; print a @}
address@hidden example
+
address@hidden
+Invece, definisce una regola che, per ogni record, concatena il valore
+della variabile @samp{func} con il valore restituito dalla funzione @samp{foo}.
+Se la stringa risultante @`e diversa dalla stringa nulla, l'azione viene
eseguita.
+Questo non @`e con ogni address@hidden quello che si desidera.
+(@command{awk} accetta questo input come
+sintatticamente valido, perch@'e le funzioni, nei programmi @command{awk}
+possono essere usate prima che siano state address@hidden
+programma in address@hidden non address@hidden eseguito, perch@'e @code{foo()}
address@hidden
+essere una funzione non definita.})
+
address@hidden address@hidden, nella definizione di funzioni
+Per essere certi che un programma @command{awk} sia portabile,
+va sempre usata la parola chiave
address@hidden per definire una funzione.
+
address@hidden Esempio di funzione
address@hidden Un esempio di definizione di funzione
address@hidden esempio di definizione di funzione
address@hidden funzione, esempio di definizione di
+
+
+Ecco un esempio di funzione definita dall'utente, di nome
address@hidden()}, che
+ha come input un numero e lo stampa in un formato specifico:
+
address@hidden
+function stampa_num(numero)
address@hidden
+ printf "%6.3g\n", numero
address@hidden
address@hidden example
+
address@hidden
+Per comprenderne il funzionamento, ecco una regola @command{awk} che usa
+la funzione @code{stampa_num()}:
+
address@hidden
+$3 > 0 @{ stampa_num($3) @}
address@hidden example
+
address@hidden
+Questo programma stampa, nel nostro formato speciale, tutti i terzi campi
+nei record in input che
+contengono un numero positivo. Quindi, dato il seguente input:
+
address@hidden
+ 1.2 3.4 5.6 7.8
+ 9.10 11.12 -13.14 15.16
+17.18 19.20 21.22 23.24
address@hidden example
+
address@hidden
+questo programma, usando la nostra funzione per formattare i risultati, stampa:
+
address@hidden
+ 5.6
+ 21.2
address@hidden example
+
+La funzione seguente cancella tutti gli elementi in un vettore
+(si ricordi che gli spazi bianchi in soprannumero stanno a indicare
+l'inizio della lista delle variabili locali):
+
address@hidden
+function cancella_vettore(a, i)
address@hidden
+ for (i in a)
+ delete a[i]
address@hidden
address@hidden example
+
+Quando si lavora con vettori, @`e spesso necessario cancellare
+tutti gli elementi in un vettore e ripartire con una nuova lista di elementi
+(@pxref{Cancellazione}).
+Invece di dover ripetere
+questo ciclo ogni volta che si deve cancellare
+un vettore, un programma address@hidden limitarsi a effettuare una chiamata
+a @code{cancella_vettore()}.
+(Questo garantisce la address@hidden L'uso di @samp{delete @var{vettore}}
+per cancellare
+il contenuto di un intero vettore @`e un'aggiunta relativamente
address@hidden la fine del 2012.}
+allo standard POSIX.)
+
+Quello che segue @`e un esempio di una funzione ricorsiva. Prende come
+parametro di input una stringa e restituisce la stringa in ordine inverso.
+Le funzioni ricorsive devono sempre avere un test che interrompa la
+ricorsione.
+In questo caso, la ricorsione termina quando la stringa in input @`e
address@hidden vuota:
+
address@hidden 8/2014: Thanks to Mike Brennan for the improved formulation
address@hidden @code{rev()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{rev()}
address@hidden
+function rev(stringa)
address@hidden
+ if (stringa == "")
+ return ""
+
+ return (rev(substr(stringa, 2)) substr(stringa, 1, 1))
address@hidden
address@hidden example
+
+Se questa funzione @`e in un file di nome @file{rev.awk}, si address@hidden
provare
address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{echo "Non v'allarmate!" |}
+> @kbd{gawk -e '@{ print rev($0) @}' -f rev.awk}
address@hidden !etamralla'v noN
address@hidden example
+
+La funzione C @code{ctime()} prende una marcatura temporale e la restituisce
+come una stringa,
+formattata come address@hidden sappiamo.
+Il seguente esempio usa la funzione predefinita @code{strftime()}
+(@pxref{Funzioni di tempo})
+per creare una versione @command{awk} di @code{ctime()}:
+
address@hidden @code{ctime()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{ctime()}
address@hidden
address@hidden file eg/lib/ctime.awk
+# ctime.awk
+#
+# versione awk della funzione C ctime(3)
+
+function ctime(ts, format)
address@hidden
+ format = "%a %e %b %Y, %H.%M.%S, %Z"
+
+ if (ts == 0)
+ ts = systime() # usare data e ora correnti per default
+ return strftime(format, ts)
address@hidden
address@hidden endfile
address@hidden example
+
+Si potrebbe pensare che la funzione @code{ctime()} possa usare
address@hidden"strftime"]}
+come stringa di formato. Sarebbe un errore, perch@'e si suppone che
address@hidden()} restituisca data e ora formattati in maniera standard,
+e qualche codice a livello utente potrebbe aver modificato in precedenza
address@hidden"strftime"]}.
+
address@hidden Precisazioni sulle funzioni
address@hidden Chiamare funzioni definite dall'utente
+
address@hidden funzioni definite dall'utente, chiamare
address@hidden chiamare funzioni definite dall'utente
address@hidden una funzione} significa richiedere l'esecuzione di una
+funzione, la quale svolge il compito per cui @`e stata scritta.
+La chiamata di una funzione @`e un'espressione e il suo valore @`e quello
+restituito dalla funzione.
+
address@hidden
+* Chiamare una funzione:: Non usare spazi.
+* Campo di address@hidden variabili:: Variabili locali e globali.
+* Parametri per valore/riferimento:: Passaggio parametri.
address@hidden menu
+
address@hidden Chiamare una funzione
address@hidden Scrivere una chiamata di funzione
+
+Una chiamata di funzione consiste nel nome della funzione seguito dagli
+argomenti racchiusi tra parentesi. Gli argomenti specificati nella chiamata
+sono costituiti da espressioni @command{awk}. Ogni volta che si esegue una
+chiamata queste espressioni vengono ricalcolate, e i loro valori diventano gli
+argomenti passati alla funzione. Per esempio, ecco una chiamata a
address@hidden()} con tre argomenti (il primo dei quali @`e una concatenazione
di
+stringhe):
+
address@hidden
+pippo(x y, "perdere", 4 * z)
address@hidden example
+
address@hidden ATTENZIONE
+Caratteri bianchi (spazi e TAB) non sono permessi tra il nome della funzione e
+la parentesi aperta che apre la lista degli argomenti. Se per errore si
+lasciano dei caratteri bianchi, @command{awk} li interpreterebbe come se
+s'intendesse concatenare una variabile con un'espressione tra parentesi.
+Tuttavia, poich@'e si @`e usato un nome di funzione e non un nome di variabile,
+verrebbe emesso un messaggio di errore.
address@hidden quotation
+
address@hidden Campo di address@hidden variabili
address@hidden Variabili locali e globali.
+
address@hidden variabili locali, in una funzione
address@hidden locali, variabili, per una funzione
+Diversamente da molti altri linguaggi, non c'@`e modo di
+rendere locale una variabile in un blocco @address@hidden @dots{}
@address@hidden di
address@hidden, ma si address@hidden rendere locale una variabile di una
funzione. @`E
+buona norma farlo quando una variabile serve solo all'interno di quella
+particolare funzione.
+
+Per rendere locale una variabile per una funzione, basta dichiarare la
+variabile come argomento della funzione dopo gli argomenti richiesti dalla
+funzione (@pxref{Sintassi delle definizioni}). Si consideri il seguente
+esempio, dove la variabile @code{i} @`e una variabile globale usata sia dalla
+funzione @code{pippo()} che dalla funzione @code{pluto()}:
+
address@hidden
+function pluto()
address@hidden
+ for (i = 0; i < 3; i++)
+ print "in pluto i=" i
address@hidden
+
+function pippo(j)
address@hidden
+ i = j + 1
+ print "in pippo i=" i
+ pluto()
+ print "in pippo i=" i
address@hidden
+
+BEGIN @{
+ i = 10
+ print "in BEGIN i=" i
+ pippo(0)
+ print "in BEGIN i=" i
address@hidden
address@hidden example
+
+L'esecuzione di questo script produce quanto segue, perch@'e la stessa
+variabile @code{i} @`e usata sia nelle
+funzioni @code{pippo()} e @code{pluto()} sia a livello della
+regola @code{BEGIN}:
+
address@hidden
+in BEGIN i=10
+in pippo i=1
+in pluto i=0
+in pluto i=1
+in pluto i=2
+in pippo i=3
+in BEGIN i=3
address@hidden example
+
+Se si vuole che @code{i} sia una variabile locale sia per
address@hidden()} che per @code{pluto()}, occorre procedere in questo modo
+(gli spazi extra prima della @code{i} sono una convenzione di codifica
+che serve a ricordare che @code{i} @`e una variabile locale, non
+un argomento):
+
address@hidden
+function pluto( i)
address@hidden
+ for (i = 0; i < 3; i++)
+ print "in pluto i=" i
address@hidden
+
+function pippo(j, i)
address@hidden
+ i = j + 1
+ print "in pippo i=" i
+ pluto()
+ print "in pippo i=" i
address@hidden
+
+BEGIN @{
+ i = 10
+ print "in BEGIN i=" i
+ pippo(0)
+ print "in BEGIN i=" i
address@hidden
address@hidden example
+
+L'esecuzione della versione corretta dello script produce il seguente
+output:
+
address@hidden
+in BEGIN i=10
+in pippo i=1
+in pluto i=0
+in pluto i=1
+in pluto i=2
+in pippo i=1
+in BEGIN i=10
address@hidden example
+
+Oltre a valori scalari (stringhe e numeri), si possono usare anche
+vettori locali. Usando come parametro il nome di un vettore, @command{awk}
+lo considera come tale, e lo tratta come locale alla funzione.
+Inoltre, chiamate ricorsive creano nuovi vettori.
+Si consideri questo esempio:
+
address@hidden
+function qualche_funz(p1, a)
address@hidden
+ if (p1++ > 3)
+ return
+
+ a[p1] = p1
+
+ qualche_funz(p1)
+
+ printf("Al livello %d, indice %d %s trova in a\n",
+ p1, (p1 - 1), (p1 - 1) in a ? "si" : "non si")
+ printf("Al livello %d, indice %d %s trova in a\n",
+ p1, p1, p1 in a ? "si" : "non si")
+ print ""
address@hidden
+
+BEGIN @{
+ qualche_funz(1)
address@hidden
address@hidden example
+
+Quando viene eseguito, questo programma produce il seguente output:
+
address@hidden
+Al livello 4, indice 3 non si trova in a
+Al livello 4, indice 4 si trova in a
+
+Al livello 3, indice 2 non si trova in a
+Al livello 3, indice 3 si trova in a
+
+Al livello 2, indice 1 non si trova in a
+Al livello 2, indice 2 si trova in a
address@hidden example
+
address@hidden Parametri per valore/riferimento
address@hidden Passare parametri di funzione per valore o per riferimento
+
+In @command{awk}, quando si definisce una funzione, non c'@`e modo di
+dichiarare esplicitamente se gli argomenti sono passati @dfn{per valore}
+o @dfn{per riferimento}.
+
+Invece, il modo con cui i parametri sono passati @`e determinato
+durante l'esecuzione del programma,
+quando la funzione @`e chiamata, nel rispetto della regola seguente:
+se l'argomento @`e una variabile di tipo vettoriale, questa @`e passata
+per riferimento. Altrimenti, l'argomento @`e passato per valore.
+
address@hidden chiamare per valore
+Passare un argomento per valore significa che quando una funzione @`e chiamata,
+le viene fornita una @emph{copia} del valore di quell'argomento. Il chiamante
address@hidden usare una variabile il cui valore calcolato viene passato come
argomento, ma la
+funzione chiamata non la riconosce come variabile; riconosce solo il valore
+assunto dall'argomento. Per esempio, scrivendo il seguente codice:
+
address@hidden
+pippo = "pluto"
+z = mia_funzione(pippo)
address@hidden example
+
address@hidden
+non si deve pensare che l'argomento passato a @code{mia_funzione()} sia ``la
+variabile @code{pippo}.'' Invece, @`e corretto considerare l'argomento come la
+stringa il cui valore @`e @code{"pluto"}.
+Se la funzione @code{mia_funzione()} altera i valori delle sue variabili
+locali, address@hidden non influisce su nessun'altra variabile. Quindi, se
address@hidden()} fa questo:
+
address@hidden
+function mia_funzione(stringa)
address@hidden
+ print stringa
+ stringa = "zzz"
+ print stringa
address@hidden
address@hidden example
+
address@hidden
+cambiando address@hidden@dotless{i}} il valore della variabile che @`e il suo
primo argomento, ossia
address@hidden, il valore di @code{pippo} per il chiamante @emph{non} viene
+modificato. Il ruolo svolto da @code{pippo} nella chiamata di
address@hidden()} termina quando il suo valore (@code{"pluto"}) viene
+calcolato. Se la variabile @code{stringa} esiste anche al di fuori di
address@hidden()}, il corpo della funzione non address@hidden modificare questo
valore
+esterno, perch@'e esso rimane oscurato durante l'esecuzione di
address@hidden()} e non address@hidden quindi essere visto o modificato.
+
address@hidden chiamare per riferimento
address@hidden vettori, come parametri di funzione
address@hidden funzioni, vettori come parametri di
+Tuttavia, quando sono dei vettori a fungere da parametri alle funzioni, questi
address@hidden vengono copiati. Invece, il vettore stesso @`e reso disponibile
per
+essere manipolato direttamente dalla funzione. Questo @`e quel che si dice
+solitamente una @dfn{chiamata per riferimento}. Le modifiche effettuate su un
+vettore passato come parametro all'interno del corpo di una funzione
address@hidden visibili all'esterno della funzione.
+
address@hidden NOTA
+Modificare un vettore passato come parametro all'interno di una funzione
address@hidden essere molto pericoloso se non si sta attenti a quel che si sta
facendo.
+Per esempio:
+
address@hidden
+function cambialo(vettore, ind, nvalore)
address@hidden
+ vettore[ind] = nvalore
address@hidden
+
+BEGIN @{
+ a[1] = 1; a[2] = 2; a[3] = 3
+ cambialo(a, 2, "due")
+ printf "a[1] = %s, a[2] = %s, a[3] = %s\n",
+ a[1], a[2], a[3]
address@hidden
address@hidden example
+
address@hidden
+stampa @samp{a[1] = 1, a[2] = due, a[3] = 3}, perch@'e
address@hidden()} memorizza @code{"due"} nel secondo elemento di @code{a}.
address@hidden quotation
+
address@hidden indefinite, funzioni
address@hidden funzioni indefinite
+Alcune implementazioni di @command{awk} consentono di chiamare una
+funzione che non @`e stata definita.
+Viene solo emesso un messaggio che descrive il problema al momento
+dell'esecuzione, se il programma tenta di chiamare quella funzione.
+Per esempio:
+
address@hidden
+BEGIN @{
+ if (0)
+ pippo()
+ else
+ pluto()
address@hidden
+function pluto() @{ @dots{} @}
+# si noti che `pippo' non @`e definito
address@hidden example
+
address@hidden
+Poich@'e la condizione dell'istruzione @samp{if} non address@hidden mai
verificata
+in questo caso,
+non @`e un problema reale il fatto che
+che @code{pippo()} non sia stato definito. Solitamente, tuttavia,
address@hidden un problema se un programma chiama una funzione indefinita.
+
address@hidden @dfn{lint}, controlli, funzione indefinita
address@hidden controlli @dfn{lint} per funzione indefinita
address@hidden funzione indefinita, controlli @dfn{lint} per
+
+Se si specifica l'opzione @option{--lint}
+(@pxref{Opzioni}),
address@hidden elenca le chiamate a funzioni indefinite.
+
address@hidden address@hidden, istruzione @code{next} in funzioni definite
dall'utente
address@hidden @code{next}, istruzione, in funzioni definite dall'utente
+Alcune implementazione di @command{awk} emettono un messaggio di errore
+se si usa l'istruzione @code{next}
+o @code{nextfile}
+(@pxref{Istruzione next}, e
address@hidden
address@hidden nextfile})
address@hidden ifdocbook
address@hidden
address@hidden nextfile})
address@hidden ifnotdocbook
+all'interno di una funzione definita dall'utente.
address@hidden non ha questa limitazione.
+
address@hidden Istruzione return
address@hidden L'istruzione @code{return}
address@hidden @code{return}, address@hidden in funzioni definite dall'utente
address@hidden istruzione @address@hidden in funzioni definite dall'utente
+
+Come visto in parecchi esempi precedenti,
+il corpo di una funzione definita dall'utente address@hidden contenere
un'istruzione
address@hidden
+Quest'istruzione restituisce il controllo a quella parte del
+del programma @command{awk} che ha effettuato la chiamata.
address@hidden anche essere usata per restituire un valore da usare nel resto
del
+programma @command{awk}.
+Questo @`e un esempio:
+
address@hidden
address@hidden address@hidden
address@hidden display
+
+La parte @var{espressione} @`e facoltativa.
+Probabilmente per una svista, POSIX non definisce qual @`e il valore
+restituito, se si omette @var{espressione}. Tecnicamente parlando, questo
+rende il valore restituito indefinito, e quindi, indeterminato.
+In pratica, tuttavia, tutte le versioni di @command{awk} restituiscono
+semplicemente la stringa nulla, che vale zero se usata
+in un contesto che richiede un numero.
+
+Un'istruzione @code{return} senza una @var{espressione} @`e considerata
presente
+alla fine di ogni definizione di funzione.
+Quindi, se il flusso di esecuzione raggiunge la fine del corpo della
+funzione, tecnicamente la funzione
+restituisce un valore indeterminato.
+In pratica, restituisce la stringa nulla. @command{awk}
address@hidden emette alcun messaggio di avvertimento se si usa
+il valore restituito di una tale funzione.
+
+Talvolta address@hidden capitare di scrivere una funzione per quello che fa,
non per
+quello che restituisce. Una tale funzione corrisponde a una funzione
address@hidden in C, C++, o Java, o a una @code{procedure} in Ada.
+Quindi, address@hidden essere corretto non
+restituire alcun valore; basta fare attenzione a non usare poi il
+valore restituito da una tale funzione.
+
+Quello che segue @`e un esempio di una funzione definita dall'utente
+che restituisce un valore che @`e
+il numero address@hidden alto presente tra gli elementi di un vettore:
+
address@hidden
+function massimo(vettore, i, max)
address@hidden
+ for (i in vettore) @{
+ if (max == "" || vettore[i] > max)
+ max = vettore[i]
+ @}
+ return max
address@hidden
address@hidden example
+
address@hidden programmazione, convenzioni di, parametri di funzione
address@hidden convenzioni di programmazione, parametri di funzione
address@hidden
+La chiamata a @code{massimo()} ha un solo argomento, che @`e il nome di
+un vettore. Le variabili locali @code{i} e @code{max} non vanno intese
+come argomenti; nulla vieta di passare address@hidden di un argomento
+a @code{massimo()} ma i risultati sarebbero strani. Gli spazi extra prima
+di @code{i} nella lista dei parametri della funzione indicano che @code{i} e
address@hidden sono variabili locali.
address@hidden consigliabile seguire questa convenzione quando si definiscono
delle funzioni.
+
+Il programma seguente usa la funzione @code{massimo()}. Carica un vettore,
+richiama @code{massimo()}, e quindi elenca il numero massimo contenuto in
+quel vettore:
+
address@hidden
+function massimo(vettore, i, max)
address@hidden
+ for (i in vettore) @{
+ if (max == "" || vettore[i] > max)
+ max = vettore[i]
+ @}
+ return max
address@hidden
+
+# Carica tutti i campi di ogni record in numeri.
address@hidden
+ for (i = 1; i <= NF; i++)
+ numeri[NR, i] = $i
address@hidden
+
+END @{
+ print massimo(numeri)
address@hidden
address@hidden example
+
+Dato il seguente input:
+
address@hidden
+ 1 5 23 8 16
+44 3 5 2 8 26
+256 291 1396 2962 100
+-6 467 998 1101
+99385 11 0 225
address@hidden example
+
address@hidden
+il programma trova (come si address@hidden immaginare) che 99.385 @`e il
+valore address@hidden alto contenuto nel vettore.
+
address@hidden Variabili di tipo dinamico
address@hidden Funzioni e loro effetti sul tipo di una variabile
+
address@hidden @`e un linguaggio molto fluido.
address@hidden possible che @command{awk} non sia in grado di stabilire se un
+identificativo rappresenta una variabile scalare o un vettore,
+prima dell'effettiva esecuzione di un programma.
+Ecco un esempio di programma commentato:
+
address@hidden
+function pippo(a)
address@hidden
+ a[1] = 1 # il parametro @`e un vettore
address@hidden
+
+BEGIN @{
+ b = 1
+ pippo(b) # non valido: errore fatale, tipi variabile in conflitto
+
+ pippo(x) # x non inizializzato, diventa un vettore dinamicamente
+ x = 1 # a questo punto, non permesso: errore in esecuzione
address@hidden
address@hidden example
+
+In questo esempio, la prima chiamata a @code{pippo()} genera
+un errore fatale, quindi @command{awk} non address@hidden a segnalare il
secondo
+errore. Se si commenta la prima chiamata e si riesegue il
+programma, a quel punto @command{awk} address@hidden con un messaggio
+relativo al secondo errore.
+Solitamente queste cose non causano grossi problemi, ma @`e bene
+esserne a conoscenza.
+
address@hidden Chiamate indirette
address@hidden Chiamate indirette di funzione
+
address@hidden indiretta, chiamata di funzione
address@hidden chiamata indiretta di funzione
address@hidden funzione, puntatori a
address@hidden puntatori a funzioni
address@hidden differenze tra @command{awk} e @command{gawk}, chiamata
indiretta di funzione
+
+Questa sezione descrive un'estensione avanzata, specifica di @command{gawk}.
+
+Spesso address@hidden essere utile ritardare la scelta della funzione da
chiamare
+fino al momento in cui il programma viene eseguito.
+Per esempio, potrebbero esserci diversi tipi di record in input, ciascuno
+dei quali dovrebbe essere elaborato in maniera differente.
+
+Solitamente, si userebbe una serie di istruzioni @address@hidden
+per decidere quale funzione chiamare. Usando la chiamata @dfn{indiretta}
+a una funzione, si address@hidden assegnare il nome della funzione da chiamare
a
+una variabile di tipo stringa, e usarla per chiamare la funzione.
+Vediamo un esempio.
+
+Si supponga di avere un file con i punteggi ottenuti negli esami per i
+corsi che si stanno seguendo, e che si desideri ottenere la somma e la
+media dei punteggi ottenuti.
+Il primo campo @`e il nome del corso. I campi seguenti sono i nomi delle
+funzioni da chiamare per elaborare i dati, fino a un campo ``separatore''
address@hidden:}. Dopo il separatore, fino alla fine del record,
+ci sono i vari risultati numerici di ogni test.
+
+Ecco il file iniziale:
+
address@hidden
address@hidden file eg/data/class_data1
+Biologia_101 somma media dati: 87.0 92.4 78.5 94.9
+Chimica_305 somma media dati: 75.2 98.3 94.7 88.2
+Inglese_401 somma media dati: 100.0 95.6 87.1 93.4
address@hidden endfile
address@hidden example
+
+Per elaborare i dati, si potrebbe iniziare a scrivere:
+
address@hidden
address@hidden
+ corso = $1
+ for (i = 2; $i != "dati:"; i++) @{
+ if ($i == "somma")
+ somma() # elabora l'intero record
+ else if ($i == "media")
+ media()
+ @dots{} # e address@hidden@dotless{i}} via
+ @}
address@hidden
address@hidden example
+
address@hidden
+Questo stile di programmazione funziona, ma address@hidden essere scomodo.
+Con la chiamata @dfn{indiretta} di funzione, si address@hidden richiedere a
@command{gawk}
+di usare il @emph{valore} di una variabile come @emph{nome} della funzione da
+chiamare.
+
address@hidden @code{@@}, notazione per la chiamata indiretta di funzioni
address@hidden chiamata indiretta di funzioni, notazione @code{@@}
+La sintassi @`e simile a quella di una normale chiamata di funzione:
+un identificativo, seguito immediatamente da una parentesi aperta,
+qualche argomento, e una parentesi chiusa, con l'aggiunta di un carattere
address@hidden@@} all'inizio:
+
address@hidden
+quale_funzione = "somma"
+risultato = @@quale_funzione() # chiamata della funzione somma()
address@hidden example
+
+Ecco un intero programma che elabora i dati mostrati sopra,
+usando la chiamata indiretta di funzioni:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# chiamataindiretta.awk --- esempio di chiamata indiretta di funzioni
address@hidden endfile
address@hidden
address@hidden file eg/prog/indirectcall.awk
+#
+# Arnold Robbins, address@hidden, Public Domain
+# January 2009
address@hidden endfile
address@hidden ignore
+
address@hidden file eg/prog/indirectcall.awk
+# media --- calcola la media dei valori dei campi $primo - $ultimo
+
+function media(primo, ultimo, somma, i)
address@hidden
+ somma = 0;
+ for (i = primo; i <= ultimo; i++)
+ somma += $i
+
+ return somma / (ultimo - primo + 1)
address@hidden
+
+# somma --- restituisce la somma dei valori dei campi $primo - $ultimo
+
+function somma(primo, ultimo, totale, i)
address@hidden
+ max = 0;
+ for (i = primo; i <= ultimo; i++)
+ totale += $i
+
+ return totale
address@hidden
address@hidden endfile
address@hidden example
+
+Queste due funzioni presuppongono che si lavori con dei campi; quindi,
+i parametri @code{primo} e @code{ultimo} indicano da quale campo iniziare
+e fino a quale arrivare.
+Per il resto, eseguono i calcoli richiesti, che sono i soliti:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# Per ogni record,
+# stampa il nome del corso e le statistiche richieste
address@hidden
+ nome_corso = $1
+ gsub(/_/, " ", nome_corso) # Rimpiazza _ con spazi
+
+ # trova campo da cui iniziare
+ for (i = 1; i <= NF; i++) @{
+ if ($i == "dati:") @{
+ inizio = i + 1
+ break
+ @}
+ @}
+
+ printf("%s:\n", nome_corso)
+ for (i = 2; $i != "dati:"; i++) @{
+ quale_funzione = $i
+ printf("\t%s: <%s>\n", $i, @@quale_funzione(inizio, NF) "")
+ @}
+ print ""
address@hidden
address@hidden endfile
address@hidden example
+
+Questo @`e il ciclo principale eseguito per ogni record.
+Stampa il nome del corso (con le
+lineette basse sostituite da spazi). Trova poi l'inizio dei dati veri
+e propri, salvandolo in @code{inizio}.
+L'ultima parte del codice esegue un ciclo per ogni nome di funzione
+(da @code{$2} fino al separatore, @samp{dati:}), chiamando la funzione
+il cui nome @`e specificato nel campo. La chiamata di funzione indiretta
+compare come parametro nella chiamata a @code{printf}.
+(La stringa di formattazione di @code{printf} usa @samp{%s} come
+specificatore di formato, affinch@'e sia possibile usare funzioni
+che restituiscano sia stringhe che numeri. Si noti che il risultato
+della chiamata indiretta @`e concatenato con la stringa nulla, in modo da
+farlo considerare un valore di tipo stringa).
+
+Ecco il risultato dell'esecuzione del programma:
+
address@hidden
+$ @kbd{gawk -f chiamataindiretta.awk dati_dei_corsi}
address@hidden Biologia 101:
address@hidden somma: <352.8>
address@hidden media: <88.2>
address@hidden
address@hidden Chimica 305:
address@hidden somma: <356.4>
address@hidden media: <89.1>
address@hidden
address@hidden Inglese 401:
address@hidden somma: <376.1>
address@hidden media: <94.025>
address@hidden example
+
+La address@hidden di usare la chiamata indiretta di funzioni @`e
address@hidden potente
+di quel che si possa pensare inizialmente.
+I linguaggi C e C++ forniscono ``puntatori di funzione'' che
+sono un metodo per chiamare una funzione scelta al momento dell'esecuzione.
+Uno dei address@hidden noti usi di questa address@hidden @`e
+la funzione C @code{qsort()}, che ordina un vettore usando il famoso
+algoritmo noto come ``quicksort''
+(si veda @uref{http://en.wikipedia.org/wiki/Quicksort, l'articolo di Wikipedia}
+per ulteriori informazioni). Per usare questa funzione, si specifica un
+puntatore a una funzione di confronto. Questo meccanismo consente
+di ordinare dei dati arbitrari in una maniera arbitraria.
+
+Si address@hidden fare qualcosa di simile usando @command{gawk},
address@hidden@dotless{i}}:
+
address@hidden
address@hidden file eg/lib/quicksort.awk
+# quicksort.awk --- Algoritmo di quicksort, con funzione di confronto
+# fornita dall'utente
address@hidden endfile
address@hidden
address@hidden file eg/lib/quicksort.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# January 2009
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/quicksort.awk
+
+# quicksort --- Algoritmo di quicksort di C.A.R. Hoare.
+# Si veda Wikipedia o quasi ogni libro
+# che tratta di algoritmi o di informatica.
address@hidden endfile
address@hidden
address@hidden file eg/lib/quicksort.awk
+#
+# Adattato da B.W. Kernighan & D.M. Ritchie
+# The C Programming Language
+# (Englewood Cliffs, NJ: Prentice Hall, 1988)
+# Seconda Edizione, pagina 110
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/quicksort.awk
+
+function quicksort(dati, sinistra, destra, minore_di, i, ultimo)
address@hidden
+ if (sinistra >= destra) # non fa nulla se il vettore contiene
+ return # meno di due elementi
+
+ quicksort_scambia(dati, sinistra, int((sinistra + destra) / 2))
+ ultimo = sinistra
+ for (i = sinistra + 1; i <= destra; i++)
+ if (@@minore_di(dati[i], dati[sinistra]))
+ quicksort_scambia(dati, ++ultimo, i)
+ quicksort_scambia(dati, sinistra, ultimo)
+ quicksort(dati, sinistra, ultimo - 1, minore_di)
+ quicksort(dati, ultimo + 1, destra, minore_di)
address@hidden
+
+# quicksort_scambia --- funzione ausiliaria per quicksort,
+# sarebbe meglio fosse nel programma principale
+
+function quicksort_scambia(dati, i, j, salva)
address@hidden
+ salva = dati[i]
+ dati[i] = dati[j]
+ dati[j] = salva
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{quicksort()} riceve il vettore @code{dati}, gli
+indici iniziali e finali da ordinare
+(@code{sinistra} e @code{destra}), e il nome di una funzione che
+esegue un confronto ``minore di''. Viene quindi eseguito
+l'algoritmo di quicksort.
+
+Per fare uso della funzione di ordinamento, torniamo all'esempio
+precedente. La prima cosa da fare @`e di scrivere qualche funzione
+di confronto:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# num_min --- confronto numerico per minore di
+
+function num_min(sinistra, destra)
address@hidden
+ return ((sinistra + 0) < (destra + 0))
address@hidden
+
+# num_magg_o_ug --- confronto numerico per maggiore o uguale
+
+function num_magg_o_ug(sinistra, destra)
address@hidden
+ return ((sinistra + 0) >= (destra + 0))
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{num_magg_o_ug()} serve per ottenere un ordinamento
+decrescente (dal numero address@hidden alto al address@hidden basso); quando
@`e usato
+per eseguire un test per ``minore di'', in address@hidden fa l'opposto
+(maggiore o uguale a), il che conduce a ottenere dati ordinati
+in ordine decrescente.
+
+Poi serve una funzione di ordinamento.
+Come parametri ha i numeri del campo iniziale e di quello finale,
+e il nome della funzione di confronto.
+Costruisce un vettore con
+i dati e richiama appropriatamente @code{quicksort()}; quindi formatta i
+risultati mettendoli in un'unica stringa:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# ordina --- ordina i dati a seconda di `confronta'
+# e li restituisce come un'unica stringa
+
+function ordina(primo, ultimo, confronta, dati, i, risultato)
address@hidden
+ delete dati
+ for (i = 1; primo <= ultimo; primo++) @{
+ dati[i] = $primo
+ i++
+ @}
+
+ quicksort(dati, 1, i-1, confronta)
+
+ risultato = dati[1]
+ for (i = 2; i in dati; i++)
+ risultato = risultato " " dati[i]
+
+ return risultato
address@hidden
address@hidden endfile
address@hidden example
+
+Per finire, le due funzioni di ordinamento chiamano la funzione
address@hidden()}, passandole i nomi delle due funzioni di confronto:
+
address@hidden
address@hidden file eg/prog/indirectcall.awk
+# ascendente --- ordina i dati in ordine crescente
+# e li restituisce sotto forma di stringa
+
+function ascendente(primo, ultimo)
address@hidden
+ return ordina(primo, ultimo, "num_min")
address@hidden
+
+# discendente --- ordina i dati in ordine decrescente
+# e li restituisce sotto forma di stringa
+
+function discendente(primo, ultimo)
address@hidden
+ return ordina(primo, ultimo, "num_magg_o_ug")
address@hidden
address@hidden endfile
address@hidden example
+
+Ecco una versione estesa del @value{DF}:
+
address@hidden
address@hidden file eg/data/class_data2
+Biologia_101 somma media ordina discendente dati: 87.0 92.4 78.5 94.9
+Chimica_305 somma media ordina discendente dati: 75.2 98.3 94.7 88.2
+Inglese_401 somma media ordina discendente dati: 100.0 95.6 87.1 93.4
address@hidden endfile
address@hidden example
+
+Per finire, questi sono i risultati quando si esegue il programma
+in questa versione migliorata:
+
address@hidden
+$ @kbd{gawk -f quicksort.awk -f indirettacall.awk class_data2}
address@hidden Biologia 101:
address@hidden somma: <352.8>
address@hidden media: <88.2>
address@hidden ascendente: <78.5 87.0 92.4 94.9>
address@hidden discendente: <94.9 92.4 87.0 78.5>
address@hidden
address@hidden Chimica 305:
address@hidden somma: <356.4>
address@hidden media: <89.1>
address@hidden ascendente: <75.2 88.2 94.7 98.3>
address@hidden discendente: <98.3 94.7 88.2 75.2>
address@hidden
address@hidden Inglese 401:
address@hidden somma: <376.1>
address@hidden media: <94.025>
address@hidden ascendente: <87.1 93.4 95.6 100.0>
address@hidden discendente: <100.0 95.6 93.4 87.1>
address@hidden example
+
+Un altro esempio in cui le chiamate indirette di funzione sono utili
address@hidden costituito dall'elaborazione di vettori. La descrizione si
address@hidden trovare
address@hidden vettori}.
+
+Occorre ricordarsi di anteporre il carattere @samp{@@} prima di una
+chiamata indiretta di funzione.
+
+A partire dalla @value{PVERSION} 4.1.2 di @command{gawk}, le chiamate
+indirette di funzione
+possono anche essere usate per chiamare funzioni predefinite e con
+funzioni di estensione
+(@pxref{Estensioni dinamiche}). Ci sono alcune limitazioni nel richiamare
+in maniera indiretta delle funzioni predefinite, come qui dettagliato:
+
address@hidden @value{BULLET}
address@hidden
+Non si address@hidden passare una costante @dfn{regexp} a una funzione
predefinita
+effettuando una chiamata di funzione address@hidden
+limitazione potrebbe cambiare in una futura versione;
+per appurarlo, si controlli la documentazione che accompagna
+la versione in uso di @command{gawk}.}
+Quanto sopra vale per le funzioni
address@hidden()}, @code{gsub()}, @code{gensub()}, @code{match()},
address@hidden()} e @code{patsplit()}.
+
address@hidden
+Nel chiamare @code{sub()} o @code{gsub()}, sono accettati solo due argomenti,
+poich@'e queste funzioni sono atipiche, in quanto aggiornano il loro terzo
+argomento. Questo significa che address@hidden sempre aggiornato l'argomento
di
+default, @code{$0}.
address@hidden itemize
+
address@hidden fa del suo meglio per rendere efficiente la chiamata indiretta
+di funzioni. Per esempio, nel ciclo seguente:
+
address@hidden
+for (i = 1; i <= n; i++)
+ @@quale_funzione()
address@hidden example
+
address@hidden
address@hidden ricerca solo una volta quale funzione chiamare.
+
address@hidden Sommario delle funzioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
address@hidden include delle funzioni predefinite e consente all'utente
+di definire le sue proprie funzioni.
+
address@hidden
+POSIX @command{awk} include tre tipi di funzioni predefinite: numeriche, di
+stringa, e di I/O. @command{gawk} prevede funzioni per ordinare vettori, per
+lavorare con valori che rappresentano marcature temporali,
+per la manipolazione di bit,
+per determinare il tipo di una variabile (vettoriale piuttosto che scalare), e
+programmi per l'internazionalizzazione e la localizzazione. @command{gawk}
+prevede anche parecchie estensioni ad alcune funzioni standard, tipicamente
+nella forma di ulteriori argomenti.
+
address@hidden
+Le funzioni accettano zero o address@hidden argomenti e restituiscono un
valore. Le
+espressioni che specificano il valore di ogni argomento sono valutate
+completamente prima della chiamata
+a una funzione. L'ordine di valutazione di questi argomenti non @`e definito.
+Il valore restituito dalla funzione address@hidden essere ignorato.
+
address@hidden
+La gestione delle barre inverse in @code{sub()} e @code{gsub()} non @`e
+semplice.
address@hidden address@hidden semplice nella funzione di @command{gawk}
@code{gensub()},
+ma anche questa funzione richiede attenzione quando la si usa.
+
address@hidden
+Le funzioni definite dall'utente consentono importanti address@hidden ma hanno
+anche alcune ineleganze sintattiche. In una chiamata di funzione non si
address@hidden
+inserire alcuno spazio tra il nome della funzione e la parentesi sinistra
+aperta che inizia la lista degli argomenti. Inoltre, non c'@`e nessuna
+prescrizione per le variabili locali, e per questo la
+convenzione in uso @`e di aggiungere parametri extra, e di separarli
visivamente
+dai parametri veri e propri inserendo degli spazi bianchi prima di essi.
+
address@hidden
+Le funzioni definite dall'utente possono chiamare altre
+funzioni definite dall'utente (oltre a quelle predefinite)
+e possono chiamare se stesse ricorsivamente. I parametri di funzione
+``nascondono'' qualsiasi variabile globale che abbia lo stesso nome.
+Non si address@hidden usare il nome di una variabile riservata (p.es.
@code{ARGC})
+come nome di un parametro in funzioni definite dall'utente.
+
address@hidden
+I valori scalari sono passati alle funzioni definite dall'utente
+per valore. I parametri che sono dei vettori sono passati alle funzioni
+per riferimento; ogni modifica fatta dalla funzione a un parametro che
+sia un vettore @`e quindi visibile dopo aver eseguito quella funzione.
+
address@hidden
+L'istruzione @code{return} serve per tornare indietro da una funzione definita
+dall'utente. Un'espressione opzionale diviene il valore restituito dalla
+funzione. Una funzione address@hidden solo restituire valori di tipo scalare.
+
address@hidden
+Se una variabile che non @`e stata mai usata @`e passata a una funzione
+definita dall'utente, il modo con cui quella funzione elabora la variabile
+ne address@hidden determinare il tipo: o scalare o vettoriale.
+
address@hidden
address@hidden consente la chiamata indiretta di funzioni usando una sintassi
+speciale. Impostando una variabile al nome di una funzione, si address@hidden
+determinare al momento dell'esecuzione che funzione address@hidden chiamata in
un certo
+punto del programma. Questo equivale a usare un puntatore a una funzione nei
+linguaggi C e C++.
+
address@hidden itemize
+
+
address@hidden
address@hidden @value{PART2}Risoluzione di problemi con @command{awk}
address@hidden ifnotinfo
+
address@hidden
+La Parte II mostra come usare @command{awk} e @command{gawk} per risolvere
+problemi. Qui c'@`e il codice di molti programmi, da leggere e da cui si
address@hidden
+imparare. @`E composta dai seguenti capitoli:
+
address@hidden @value{BULLET}
address@hidden
address@hidden di libreria}
+
address@hidden
address@hidden di esempio}
address@hidden itemize
address@hidden ifdocbook
+
address@hidden Funzioni di libreria
address@hidden Una libreria di funzioni @command{awk}
address@hidden libreria di funzioni @command{awk}
address@hidden funzioni di libreria
address@hidden funzioni definite dall'utente, libreria di
+
address@hidden
+La
address@hidden iftex
address@hidden definite dall'utente} descrive come scrivere le proprie
+funzioni @command{awk} personali. Scrivere funzioni @`e importante, perch@'e
+consente di incapsulare in un unico contenitore algoritmi e azioni di
+programma. Semplifica la programmazione, rendendo lo sviluppo di un programma
address@hidden gestibile, e rendendo i programmi address@hidden leggibili.
+
address@hidden Kernighan, Brian
address@hidden Plauger, P.J.@:
+Nel loro autorevole libro del 1976,
address@hidden Tools},@footnote{Purtroppo, a distanza di oltre 35 anni,
+molte delle
+lezioni impartite da questo libro devono ancora essere apprese da un gran
+numero di programmatori professionisti.}
+Brian Kernighan e P.J.@: Plauger hanno scritto:
+
address@hidden
+A programmare bene non s'impara dai concetti generali, ma vedendo come
+programmi complessi possono essere resi puliti, facili da leggere,
+facili da manutenere e modificare,
+strutturati in modo comprensibile, efficienti e affidabili,
+applicando il buon senso e delle buone pratiche di programmazione.
+Lo studio attento e l'imitazione di buoni programmi conduce a una migliore
+scrittura.
address@hidden quotation
+
+In effetti, loro reputavano quest'idea tanto importante da mettere questa
+frase sulla copertina del libro. Poich@'e credo fermamente che la loro
+affermazione sia corretta, questo @value{CHAPTER} e
address@hidden
+il
address@hidden iftex
address@hidden di esempio}
+forniscono una corposa raccolta di codice da leggere e, si spera, da cui
+imparare.
+
+Questo @value{CHAPTER} illustra una libreria di utili funzioni @command{awk}.
+Molti dei programmi descritti nel seguito di questo @value{DOCUMENT}
+usano queste funzioni.
+Le funzioni sono illustrate progressivamente, dalla address@hidden semplice
alla address@hidden
+complessa.
+
address@hidden Texinfo
address@hidden
+La
address@hidden iftex
address@hidden extract}
+illustra un programma che si address@hidden usare per estrarre il codice
sorgente
+degli esempi di funzioni di libreria e di programmi dal sorgente Texinfo
+di questo @value{DOCUMENT}.
+(Questo @`e address@hidden stato fatto durante la preparazione della
distribuzione
+di @command{gawk}.)
+
address@hidden FOR_PRINT
+Chi avesse scritto una o address@hidden funzioni @command{awk} utili e di uso
+generale, e volesse metterle a disposizione della address@hidden degli utenti
di
address@hidden, address@hidden leggere le informazioni contenute in
address@hidden contribuire}.
address@hidden ifclear
+
address@hidden address@hidden, programmi di esempio
+I programmi contenuti in questo @value{CHAPTER} e in
address@hidden di esempio},
+utilizzano anche le address@hidden specifiche di @command{gawk}.
+Riscrivere questi programmi per implementazioni di @command{awk} diverse
address@hidden piuttosto semplice:
+
address@hidden @value{BULLET}
address@hidden
+I messaggi di errore diagnostici sono inviati a @file{/dev/stderr}.
+Usare @samp{| "cat 1>&2"} al posto di @samp{> "/dev/stderr"} se il sistema
+in uso non ha un @file{/dev/stderr}, o se non @`e possibile usare
address@hidden
+
address@hidden
+Alcuni programmi usano @code{nextfile}
+(@pxref{Istruzione nextfile})
+per evitare di leggere gli input ancora non letti dal file in input corrente.
+
address@hidden
address@hidden 12/2000: Thanks to Nelson Beebe for pointing out the output
issue.
address@hidden distinzione maiuscolo/minuscolo, programmi di esempio
address@hidden @code{IGNORECASE}, variabile, nei programmi di esempio
address@hidden variabile @code{IGNORECASE}, nei programmi di esempio
+Infine, alcuni dei programmi scelgono di ignorare la distinzione tra maiuscolo
e
+minuscolo nei loro input, assegnando il valore uno a @code{IGNORECASE}.
+Si address@hidden ottenere quasi lo stesso address@hidden risultati non sono
identici.
+L'output del record trasformato address@hidden tutto in minuscolo, mentre
address@hidden preserva il contenuto originale del record in input.}
+aggiungendo la seguente regola
+all'inizio del programma:
+
address@hidden
+# ignora maiuscolo/minuscolo
address@hidden $0 = tolower($0) @}
address@hidden example
+
address@hidden
+Inoltre, si verifichi che tutte le @dfn{regexp} e le costanti
+di tipo stringa usate nei confronti utilizzano solo lettere minuscole.
address@hidden itemize
+
address@hidden
+* Nomi di variabili di libreria:: Che nomi @`e meglio dare alle variabili
+ private globali nelle funzioni di libreria.
+* Funzioni di tipo generale:: Funzioni di uso generale.
+* Gestione File Dati:: Funzioni per gestire file-dati specificati
+ sulla riga di comando.
+* Funzione getopt:: Una funzione per trattare argomenti presenti
+ sulla riga di comando.
+* Funzioni Passwd:: Funzioni per ottenete informazioni
+ sull'utente [da /etc/passwd].
+* Funzioni Group:: Funzioni per ottenete informazioni
+ sul gruppo [da /etc/group].
+* Visitare vettori:: Una funzione per visitare vettori di vettori.
+* Sommario funzioni di libreria:: Sommario funzioni di libreria
+* Esercizi con le librerie:: Esercizi.
address@hidden menu
+
address@hidden Nomi di variabili di libreria
address@hidden Dare un nome a variabili globali in funzioni di libreria
+
address@hidden nomi di vettore/variabile
address@hidden nomi di funzione
address@hidden questioni sui nomi permessi
address@hidden nomi permessi, questioni sui
address@hidden programmi @command{awk}, documentazione
address@hidden documentazione, di programmi @command{awk}
+Per come si @`e sviluppato il linguaggio @command{awk}, le variabili sono
+o @dfn{globali} (usabili dall'intero programma) o @dfn{locali} (usabili solo
+in una specifica funzione). Non c'@`e uno stato intermedio analogo alle
+variabili @code{statiche} in C.
+
address@hidden variabili globali, per funzioni di libreria
address@hidden globali, variabili, per funzioni di libreria
address@hidden private, variabili
address@hidden variabili private
+Le funzioni di libreria hanno spesso address@hidden di avere variabili globali
da
+usare per conservare informazioni di stato tra successive chiamate alla
+funzione; per esempio, la variabile di @code{getopt()} @code{_opti}
+(@pxref{Funzione getopt}).
+Tali variabili vengono dette @dfn{private}, poich@'e le sole funzioni che
+devono usarle sono quelle della libreria.
+
+Quando si scrive una funzione di libreria, si dovrebbe cercare di scegliere per
+le variabili private dei nomi che non entrano in conflitto con nessuna delle
+variabili usate da un'altra funzione di libreria o dal programma principale di
+un utente. Per esempio, un nome come @code{i} o @code{j} non @`e una buona
+scelta, perch@'e i programmi a livello utente usano spesso nomi di variabile
come
+questi per le proprie elaborazioni.
+
address@hidden convenzioni di programmazione, nomi di variabili private
address@hidden programmazione, convenzioni di, nomi di variabili private
+I programmi di esempio mostrati in questo @value{CHAPTER} usano per le
+loro variabili private nomi che iniziano con un trattino basso(@samp{_}).
+Generalmente gli utenti
+non usano trattini bassi iniziali nei nomi di variabile,
address@hidden@dotless{i}} questa convenzione
+riduce le address@hidden che il nome di variabile coincida con un nome usato
+nel programma dell'utente.
+
address@hidden @code{_} (trattino basso), nei nomi di variabili private
address@hidden trattino basso (@code{_}), nei nomi di variabili private
+Inoltre, parecchie funzioni di libreria usano un prefisso che suggerisce
+quale funzione o gruppo di funzioni usa quelle variabili; per esempio,
address@hidden()} nelle routine che consultano la lista degli utenti
+(@pxref{Funzioni Passwd}).
+L'uso di questa convenzione viene raccomandata, poich@'e riduce ulteriormente
la
address@hidden di conflitti accidentali tra nomi di variabile. Si noti che
questa
+convenzione address@hidden anche essere usata per i nomi di variabile e per i
nomi delle
+funzioni address@hidden tutte le routine di libreria si sarebbero
+potute riscrivere usando questa convenzione, address@hidden non @`e stato
fatto, per far
+vedere come lo stile di programmazione in @command{awk} si @`e evoluto e
+per fornire alcuni spunti per questa spiegazione.}
+
+Come nota finale sui nomi delle variabili, se una funzione rende
+disponibile una variabile globale per essere usata da un programma principale,
address@hidden una buona convenzione quella di far iniziare i nomi di queste
variabili con
+una lettera maiuscola; per esempio, @code{Opterr} e @code{Optind} di
address@hidden()}
+(@pxref{Funzione getopt}).
+La lettera maiuscola iniziale indica che la variabile @`e globale,
+mentre il fatto che
+il nome della variabile non @`e tutto in lettere maiuscole indica che la
variabile
+non @`e una delle variabili predefinite di @command{awk}, come @code{FS}.
+
address@hidden @option{--dump-variables}, opzione, uso per funzioni di libreria
address@hidden opzione @option{--dump-variables}, uso per funzioni di libreria
address@hidden importante anche che @emph{tutte} le variabili nelle funzioni di
libreria
+che non abbiano la address@hidden di essere
+conservate per tutta la durata del
+programma siano, di fatto, dichiarate
+come address@hidden'opzione da riga di comando di @command{gawk}
address@hidden @`e utile per verificare questo.} Se address@hidden non viene
+fatto, la variabile potrebbe essere usata accidentalmente nel programma
+dell'utente, conducendo a errori che sono molto difficili da scoprire:
+
address@hidden
+function lib_func(x, y, l1, l2)
address@hidden
+ @dots{}
+ # qualche_var dovrebbe essere locale ma per una svista non lo @`e
+ @var{uso della variabile} qualche_var
+ @dots{}
address@hidden
address@hidden example
+
address@hidden vettori associativi, funzioni di libreria e
address@hidden libreria di funzioni @command{awk}, vettori associativi e
address@hidden funzioni, libreria di, vettori associativi e
address@hidden Tcl
+Una differente convenzione, comune nella address@hidden Tcl, @`e quella di
usare un
+solo vettore associativo che contiene i valori necessari alle funzioni di
+libreria, o ``package.'' Questo riduce significativamente il numero degli
+effettivi nomi globali in uso. Per esempio, le funzioni descritte in
address@hidden Passwd}
+potrebbero aver usato gli elementi di vettore
address@hidden@w{PW_data["inizializzato"]}},
address@hidden@w{PW_data["totale"]}}, @address@hidden"contatore"]}}, e
address@hidden@w{PW_data["awklib"]}}, al posto di @address@hidden,
address@hidden@w{_pw_totale}},
address@hidden@w{_pw_awklib}} e
address@hidden@w{_pw_contatore}}.
+
+Le convenzioni illustrate in questa @value{SECTION} sono esattamente
+quello che indica il termine: convenzioni. Non si @`e obbligati a scrivere
+i propri programmi in questo modo: @`e solo auspicabile che lo si faccia.
+
address@hidden Funzioni di tipo generale
address@hidden Programmazione di tipo generale
+
+Questa @value{SECTION} illustra diverse funzioni che sono di uso generale nella
+programmazione.
+
address@hidden
+* Funzione strtonum:: Da usare se non @`e disponibile la funzione
+ predefinita @code{strtonum()}.
+* Funzione assert:: Una funzione per controllare affermazioni
+ in programmi @command{awk}.
+* Funzione round:: Una funzione per eseguire arrotondamenti
+ se @code{sprintf()} non lo fa correttamente.
+* Funzione random Cliff:: Il generatore Cliff di numeri casuali.
+* Funzioni ordinali:: Funzioni per usare caratteri come numeri
+ e viceversa.
+* Funzione join:: Una funzione per fondere un vettore
+ in una stringa.
+* Funzione getlocaltime:: Una funzione per ottenere data e ora nel
+ formato desiderato.
+* Funzione readfile:: Una funzione per leggere un file intero in
+ un colpo solo.
+* Apici alla shell:: Una funzione per passare stringhe
+ con apici alla shell.
address@hidden menu
+
address@hidden Funzione strtonum
address@hidden Conversione di stringhe in numeri
+
+La funzione @code{strtonum()} (@pxref{Funzioni per stringhe})
address@hidden un'estensione @command{gawk}. La seguente funzione
+fornisce un'implementazione per altre versioni di @command{awk}:
+
address@hidden
address@hidden file eg/lib/strtonum.awk
+# mystrtonum --- converte stringhe in numeri
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/strtonum.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# February, 2004
+# Revised June, 2014
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/strtonum.awk
+function mystrtonum(str, ret, n, i, k, c)
address@hidden
+ if (str ~ /^0[0-7]*$/) @{
+ # ottale
+ n = length(str)
+ ret = 0
+ for (i = 1; i <= n; i++) @{
+ c = substr(str, i, 1)
+ # index() restituisce 0 se c non @`e nella stringa,
+ # e anche se c == "0"
+ k = index("1234567", c)
+
+ ret = ret * 8 + k
+ @}
+ @} else if (str ~ /^0[xX][[:xdigit:]]+$/) @{
+ # esadecimale
+ str = substr(str, 3) # via 0x iniziale
+ n = length(str)
+ ret = 0
+ for (i = 1; i <= n; i++) @{
+ c = substr(str, i, 1)
+ c = tolower(c)
+ # index() restituisce 0 se c non @`e nella stringa,
+ # e anche se c == "0"
+ k = index("123456789abcdef", c)
+
+ ret = ret * 16 + k
+ @}
+ @} else if (str ~ \
+ /^[-+]?([0-9]+([.][0-9]*([Ee][0-9]+)?)?|([.][0-9]+([Ee][-+]?[0-9]+)?))$/) @{
+ # numero decimale, eventualmente in virgola mobile
+ ret = str + 0
+ @} else
+ ret = "NON-UN-NUMERO"
+
+ return ret
address@hidden
+
+# BEGIN @{ # dati per un test
+# a[1] = "25"
+# a[2] = ".31"
+# a[3] = "0123"
+# a[4] = "0xdeadBEEF"
+# a[5] = "123.45"
+# a[6] = "1.e3"
+# a[7] = "1.32"
+# a[8] = "1.32E2"
+#
+# for (i = 1; i in a; i++)
+# print a[i], strtonum(a[i]), mystrtonum(a[i])
+# @}
address@hidden endfile
address@hidden example
+
+La funzione cerca dapprima numeri ottali in stile C (base 8).
+Se la stringa in input corrisponde all'espressione regolare che descrive i
+numeri ottali, @code{mystrtonum()} esegue il ciclo per ogni carattere presente
+nella stringa. Imposta @code{k} all'indice in @code{"1234567"} della cifra
+ottale corrente.
+Il valore di ritorno address@hidden lo stesso numero della cifra, o zero
+se il carattere non c'@`e, il che address@hidden per ogni cifra @samp{0}.
+Questo si address@hidden fare, perch@'e il test di @dfn{regexp}
nell'istruzione @code{if}
+assicura che vengano scelti per
+essere convertiti solo dei numeri ottali.
+
+Una logica simile si applica al codice che ricerca e converte un
+valore esadecimale, che inizia con @samp{0x} o @samp{0X}.
+L'uso di @code{tolower()} semplifica il calcolo per trovare
+il valore numerico corretto per ogni cifra esadecimale.
+
+Infine, se la stringa corrisponde alla (piuttosto complicata) @dfn{regexp} per
+un intero decimale regolare o per un numero in virgola mobile, il calcolo
address@hidden = str + 0} fa address@hidden@dotless{i}} che @command{awk}
converta il valore in un
+numero.
+
address@hidden incluso un programma di verifica commentato, in modo che la
funzione possa
+essere verificata con @command{gawk} e il risultato confrontato con la funzione
+predefinita @code{strtonum()}.
+
address@hidden Funzione assert
address@hidden Asserzioni
+
address@hidden asserzioni
address@hidden @code{assert()}, funzione (libreria C)
address@hidden funzione @code{assert()} (libreria C)
address@hidden libreria di funzioni @command{awk}, asserzioni
address@hidden funzioni, libreria di, asserzioni
address@hidden @command{awk}, asserzioni in programmi lunghi
+Quando si scrivono grossi programmi, spesso @`e utile sapere se
+una condizione o una serie di condizioni @`e verificata oppure no.
+Prima di procedere
+con un determinato calcolo, si fa un'affermazione su cosa si crede sia
+vero. Tale affermazione @`e nota come
address@hidden Il linguaggio C fornisce un file di intestazione
address@hidden<assert.h>} e una corrispondente macro @code{assert()} che un
+programmatore address@hidden utilizzare per fare asserzioni.
+Se l'asserzione risulta falsa, la macro @code{assert()} predispone la
+stampa di un messaggio diagnostico che descrive la condizione che
+sarebbe dovuta essere vera ma che non lo era, e poi fa terminare
+il programma.
+In C, l'uso di @code{assert()} @`e simile a questo:
+
address@hidden
+#include <assert.h>
+
+int myfunc(int a, double b)
address@hidden
+ assert(a <= 5 && b >= 17.1);
+ @dots{}
address@hidden
address@hidden example
+
+Se l'asserzione @`e falsa, il programma stampa un messaggio simile a questo:
+
address@hidden
+prog.c:5: asserzione falsa: `a <= 5 && b >= 17.1'
address@hidden example
+
address@hidden @code{assert()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{assert()}
+Il linguaggio C rende possibile trasformare questa condizione in una stringa
+da
+usare per stampare il messaggio di diagnosi. address@hidden in @command{awk}
non @`e
+possibile, per cui la funzione @code{assert()} scritta in @command{awk}
+richiede anche una descrizione
+della condizione da verificare, in formato stringa.
+La funzione @`e la seguente:
+
address@hidden
address@hidden file eg/lib/assert.awk
+# assert --- Verifica una condizione. Se questa @`e falsa esce.
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/assert.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May, 1993
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/assert.awk
+function assert(condizione, stringa)
address@hidden
+ if (! condizione) @{
+ printf("%s:%d: asserzione falsa: %s\n",
+ FILENAME, FNR, stringa) > "/dev/stderr"
+ _assert_exit = 1
+ exit 1
+ @}
address@hidden
+
address@hidden
+END @{
+ if (_assert_exit)
+ exit 1
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+La funzione @code{assert()} verifica il parametro @code{condizione}. Se
address@hidden falso, stampa un messaggio sullo standard error, usando il
parametro
address@hidden per descrivere la condizione non verificata. Poi imposta la
+variabile @code{_assert_exit} a uno ed esegue l'istruzione @code{exit}.
+L'istruzione @code{exit} salta alla regola @code{END}. Se la regola @code{END}
+trova vera la variabile @code{_assert_exit}, esce immediatamente.
+
+Lo scopo della verifica nella regola @code{END} @`e quello di evitare che venga
+eseguita qualsiasi altra eventuale regola @code{END}.
+Quando un'asserzione non @`e
+verificata, il programma dovrebbe uscire immediatamente.
+Se nessuna asserzione
+fallisce, @code{_assert_exit} @`e ancora falso quando la regola @code{END} @`e
+eseguita normalmente, e le eventuali altre regole @code{END} del programma
+vengono eseguite.
+Affinch@'e tutto questo funzioni correttamente, @file{assert.awk} dev'essere il
+primo file sorgente che viene letto da @command{awk}.
+La funzione address@hidden essere usata in un programma nel seguente modo:
+
address@hidden
+function miafunz(a, b)
address@hidden
+ assert(a <= 5 && b >= 17.1, "a <= 5 && b >= 17.1")
+ @dots{}
address@hidden
address@hidden example
+
address@hidden
+Se l'asserzione non @`e verificata, si address@hidden un messaggio simile a
questo:
+
address@hidden
+mydata:1357: asserzione falsa: a <= 5 && b >= 17.1
address@hidden example
+
address@hidden @code{END}, criterio di ricerca, funzione definita dall'utente
@code{assert()} e
address@hidden criterio di ricerca @code{END}, funzione definita dall'utente
@code{assert()} e
+C'@`e un piccolo problema con questa versione di @code{assert()}.
+Come visto, una regola @code{END} viene automaticamente aggiunta al programma
+che chiama @code{assert()}. Normalmente, se un programma consiste
+solo di una regola @code{BEGIN}, i file in input e/o lo standard input non
+vengono letti. Tuttavia, ora che il programma ha una regola @code{END},
address@hidden tenta di leggere i @value{DF} in input o lo standard input
+(@pxref{Usare BEGIN/END}), provocando molto probabilmente la sospensione del
+programma come se rimanesse in attesa di input.
+
address@hidden @code{BEGIN}, criterio di ricerca, funzione definita dall'utente
@code{assert()} e
address@hidden criterio di ricerca @code{BEGIN}, funzione definita dall'utente
@code{assert()} e
+C'@`e un modo per aggirare questo problema:
+assicurarsi che la regola @code{BEGIN} termini sempre
+con un'istruzione @code{exit}.
+
address@hidden Funzione round
address@hidden Arrotondamento di numeri
+
address@hidden arrotondare numeri
address@hidden numeri, arrotondamento di
address@hidden libreria di funzioni @command{awk}, arrotondamento di numeri
address@hidden funzioni, libreria di, arrotondamento di numeri
address@hidden @code{print}, istruzione, funzione @code{sprintf()} e
address@hidden istruzione @code{print}, funzione @code{sprintf()} e
address@hidden @code{printf}, istruzione, funzione @code{sprintf()} e
address@hidden istruzione @code{printf}, funzione @code{sprintf()} e
address@hidden @code{sprintf()}, funzione, istruzioni
@code{print}/@code{printf} e
address@hidden funzione @code{sprintf()}, istruzioni @code{print}/@code{printf}
e
+Il modo in cui @code{printf} e @code{sprintf()}
+(@pxref{Printf})
+effettuano l'arrotondamento spesso dipende dalla subroutine C @code{sprintf()}
+del sistema. Su molte macchine, l'arrotondamento di @code{sprintf()} @`e
address@hidden, il che significa che non sempre arrotonda un .5 finale per
+eccesso, contrariamente alle normali aspettative. Nell'arrotondamento
+statistico, .5 arrotonda alla cifra pari, anzich@'e sempre per eccesso,
address@hidden@dotless{i}}
+1.5 arrotonda a 2 e 4.5 arrotonda a 4. address@hidden significa che se si sta
usando un
+formato che fa arrotondamenti (p.es. @code{"%.0f"}), si dovrebbe controllare
+quello che fa il sistema che si sta usando. La seguente funzione esegue un
+arrotondamento tradizionale; potrebbe essere utile nel caso in cui
+l'istruzione @code{printf}
+di @command{awk} che si sta usando faccia degli arrotondamenti statistici:
+
address@hidden @code{round()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{round()}
address@hidden
address@hidden file eg/lib/round.awk
+# round.awk --- effettua arrotondamento tradizionale
address@hidden endfile
address@hidden
address@hidden file eg/lib/round.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# August, 1996
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/round.awk
+
+function round(x, ival, aval, frazione)
address@hidden
+ ival = int(x) # parte intera, int() fa un troncamento
+
+ # vedere se c'@`e la parte frazionale
+ if (ival == x) # nessuna parte frazionale
+ return ival # nessun decimale
+
+ if (x < 0) @{
+ aval = -x # valore assoluto
+ ival = int(aval)
+ frazione = aval - ival
+ if (frazione >= .5)
+ return int(x) - 1 # -2.5 --> -3
+ else
+ return int(x) # -2.3 --> -2
+ @} else @{
+ frazione = x - ival
+ if (frazione >= .5)
+ return ival + 1
+ else
+ return ival
+ @}
address@hidden
address@hidden endfile
address@hidden don't include test harness in the file that gets installed
+
+# codice per testare, commentato
+# @{ print $0, round($0) @}
address@hidden example
+
address@hidden Funzione random Cliff
address@hidden Il generatore di numeri casuali Cliff
address@hidden numeri casuali, generatore Cliff
address@hidden Cliff, generatore di numeri casuali
address@hidden casuali, numeri, generatore Cliff di
address@hidden funzioni, libreria di, numeri casuali Cliff
+
+Il
address@hidden://mathworld.wolfram.com/CliffRandomNumberGenerator.html,
generatore di numeri casuali Cliff}
address@hidden un generatore di numeri casuali molto semplice che ``passa il
test della sfera
+del rumore per la address@hidden non mostrando di avere alcuna struttura.''
address@hidden programmato in modo molto semplice, in meno di 10 righe di codice
address@hidden:
+
address@hidden @code{cliff_rand()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{cliff_rand()}
address@hidden
address@hidden file eg/lib/cliff_rand.awk
+# cliff_rand.awk --- generare numeri casuali con algoritmo di Cliff
address@hidden endfile
address@hidden
address@hidden file eg/lib/cliff_rand.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# December 2000
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/cliff_rand.awk
+
+BEGIN @{ _cliff_seme = 0.1 @}
+
+function cliff_rand()
address@hidden
+ _cliff_seme = (100 * log(_cliff_seme)) % 1
+ if (_cliff_seme < 0)
+ _cliff_seme = - _cliff_seme
+ return _cliff_seme
address@hidden
address@hidden endfile
address@hidden example
+
+Questo algoritmo richiede un ``seme'' iniziale di 0,1. Ogni nuovo valore
+usa il seme corrente come input per il calcolo.
+Se la funzione predefinita @code{rand()}
+(@pxref{Funzioni numeriche})
+non @`e abbastanza casuale, si address@hidden tentare di usare al suo posto
questa funzione.
+
address@hidden Funzioni ordinali
address@hidden Tradurre tra caratteri e numeri
+
address@hidden libreria di funzioni @command{awk}, valori di carattere come
numeri
address@hidden funzioni, libreria di, valori di carattere come numeri
address@hidden carattere, valore come numero
address@hidden numeri, come valori di carattere
+Un'implementazione commerciale di @command{awk} fornisce una funzione
+predefinita @code{ord()}, che prende un carattere e restituisce il valore
+numerico per quel carattere nella rappresentazione dei caratteri
+di quella particolare macchina. Se la
+stringa passata a @code{ord()} ha address@hidden di un carattere, viene usato
solo il
+primo.
+
+L'inverso di questa funzione @`e @code{chr()} (dalla funzione con lo stesso
nome
+in Pascal), che, dato un numero, restituisce il corrispondente carattere.
+Entrambe le funzioni si possono scrivere molto bene usando @command{awk};
+non vi @`e nessun reale motivo per inglobarle come funzioni predefinite
address@hidden:
+
address@hidden @code{ord()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{ord()}
address@hidden @code{chr()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{chr()}
address@hidden @code{_ord_init()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{_ord_init()}
address@hidden
address@hidden file eg/lib/ord.awk
+# ord.awk --- implementa ord e chr
+
+# Identificatori globali:
+# _ord_: valori numerici indicizzati da caratteri
+# _ord_init: funzione per inizializzare _ord_
address@hidden endfile
address@hidden
address@hidden file eg/lib/ord.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# 16 January, 1992
+# 20 July, 1992, revised
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/ord.awk
+
+BEGIN @{ _ord_init() @}
+
+function _ord_init( basso, alto, i, t)
address@hidden
+ basso = sprintf("%c", 7) # BEL @`e ascii 7
+ if (basso == "\a") @{ # ascii regolare
+ basso = 0
+ alto = 127
+ @} else if (sprintf("%c", 128 + 7) == "\a") @{
+ # ascii, con il primo bit a 1 (mark)
+ basso = 128
+ alto = 255
+ @} else @{ # ebcdic(!)
+ basso = 0
+ alto = 255
+ @}
+
+ for (i = basso; i <= alto; i++) @{
+ t = sprintf("%c", i)
+ _ord_[t] = i
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden serie di caratteri (codifiche dei caratteri da parte della
macchina)
address@hidden ASCII
address@hidden EBCDIC
address@hidden Unicode
address@hidden bit di address@hidden (in ASCII)
address@hidden @dfn{mark}, bit di address@hidden (in ASCII)
+Alcune spiegazioni riguardo ai numeri usati da @code{_ord_init()}
+non guastano.
+La serie di caratteri address@hidden importante oggi in uso @`e nota come
address@hidden situazione sta address@hidden
+cambiando: molti sistemi usano Unicode, una serie di caratteri molto ampia
+che comprende ASCII al suo interno.
+Nei sistemi che supportano interamente Unicode,
+un carattere address@hidden occupare fino a 32 bit, facendo diventare
+i semplici test usati qui eccessivamente complessi.}
+Sebbene un byte a
+8 bit possa contenere 256 valori distinti (da 0 a 255), ASCII definisce solo i
+caratteri che usano i valori da 0 a address@hidden
address@hidden stato esteso in molti paesi per usare i valori da 128 a 255
includendo
+i caratteri specifici del paese. Se il sistema in uso si avvale di queste
+estensioni, si address@hidden semplificare @code{_ord_init()} per eseguire un
ciclo da
+0 a 255.} Nel lontano passato,
+almeno un produttore di microcomputer
address@hidden Pr1me, blech
+ha usato ASCII, ma con una address@hidden di tipo @dfn{mark}, address@hidden
con il bit address@hidden a
+sinistra sempre a 1. Questo significa che su questi sistemi i caratteri
+ASCII hanno valori numerici da 128 a 255.
+Infine, i grandi elaboratori centrali usano la serie di caratteri EBCDIC, che
+prevede tutti i 256 valori.
+Ci sono altre serie di caratteri in uso su alcuni sistemi address@hidden
vecchi, ma non
+vale la pena di considerarli:
+
address@hidden
address@hidden file eg/lib/ord.awk
+function ord(str, c)
address@hidden
+ # solo il primo carattere @`e d'interesse
+ c = substr(str, 1, 1)
+ return _ord_[c]
address@hidden
+
+function chr(c)
address@hidden
+ # trasforma c in un numero aggiungendo uno 0
+ return sprintf("%c", c + 0)
address@hidden
address@hidden endfile
+
+#### programma di verifica ####
+# BEGIN @{
+# for (;;) @{
+# printf("immetti un carattere: ")
+# if (getline var <= 0)
+# break
+# printf("ord(%s) = %d\n", var, ord(var))
+# @}
+# @}
address@hidden endfile
address@hidden example
+
+Un ovvio miglioramento a queste funzioni @`e quello di spostare il codice per
la
+funzione @address@hidden nel corpo della regola @code{BEGIN}.
+Il programma @`e
+stato scritto inizialmente in questo modo per address@hidden di sviluppo.
+C'@`e un ``programma di verifica'' in una regola @code{BEGIN}, per verificare
+la funzione. @`E commentato, per poter essere eventualmente usato in
produzione.
+
address@hidden Funzione join
address@hidden Trasformare un vettore in una sola stringa
+
address@hidden libreria di funzioni @command{awk}, trasformare vettori in
stringhe
address@hidden funzioni, libreria di, trasformare vettori in stringhe
address@hidden stringhe, trasformare vettori in
address@hidden vettori, trasformare in stringhe
+Quando si fanno elaborazioni su stringhe, spesso @`e utile poter unire
+tutte le stringhe di un vettore in una lunga stringa. La funzione seguente,
address@hidden()}, svolge questo compito. address@hidden utilizzata nel
seguito in diversi
+programmi applicativi
address@hidden
+(@pxrefil{Programmi di esempio}).
address@hidden iftex
address@hidden
+(@pxref{Programmi di esempio}).
address@hidden ifnottex
+
+La buona progettazione di una funzione @`e importante; la funzione dev'essere
+generale, ma potrebbe anche avere un ragionevole comportamento di default.
+Viene chiamata con un vettore e anche con gli indici iniziale e finale degli
+elementi del vettore da riunire.
+Questo presuppone che gli indici del vettore
+siano numerici---una supposizione logica, dato che il vettore probabilmente @`e
+stato creato con @code{split()}
+(@pxref{Funzioni per stringhe}):
+
address@hidden @code{join()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{join()}
address@hidden
address@hidden file eg/lib/join.awk
+# join.awk --- trasforma un vettore in una stringa
address@hidden endfile
address@hidden
address@hidden file eg/lib/join.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/join.awk
+
+function join(vettore, iniz, fine, separ, risultato, i)
address@hidden
+ if (separ == "")
+ separ = " "
+ else if (separ == SUBSEP) # valore magico
+ separ = ""
+ risultato = vettore[iniz]
+ for (i = iniz + 1; i <= fine; i++)
+ risultato = risultato separ vettore[i]
+ return risultato
address@hidden
address@hidden endfile
address@hidden example
+
+Un ulteriore argomento opzionale @`e il separatore da usare quando si uniscono
+nuovamente le stringhe. Se il chiamante fornisce un valore non nullo,
address@hidden()} usa quello; se non viene fornito,
+per default ha un valore nullo.
+In questo caso, @code{join()} usa uno spazio singolo come separatore
+di default
+per le stringhe. Se il valore @`e uguale a @code{SUBSEP},
address@hidden()} unisce le stringhe senza un separatore tra di esse.
address@hidden serve come valore ``magico'' per indicare che potrebbe non
esserci
+un separatore tra le stringhe address@hidden bello
+se @command{awk} avesse un operatore di assegnamento per la concatenazione.
+La mancanza di un esplicito operatore per la concatenazione rende le operazioni
+sulle stringhe address@hidden difficili di quanto potrebbero essere.}
+
address@hidden Funzione getlocaltime
address@hidden Gestione dell'ora del giorno
+
address@hidden libreria di funzioni @command{awk}, gestire ora del giorno
(marcature temporali)
address@hidden funzioni, libreria di, gestione delle ore del giorno
address@hidden data e ora, formattate
address@hidden marcature temporali, formattate
address@hidden ora del giorno, gestire
+Le funzioni @code{systime()} e @code{strftime()} descritte nella
address@hidden di tempo}
+forniscono la address@hidden minima necessaria per visualizzare l'ora del
giorno
+in una forma intelligibile. Sebbene @code{strftime()} offra un'ampia gamma di
+formattazioni, i formati di controllo non sono facili da ricordare o
+intuitivamente ovvii quando si legge un programma.
+
+La seguente funzione, @code{getlocaltime()}, riempie un vettore fornito
+dall'utente con informazioni sul tempo preformattate. Restituisce una stringa
+con data e ora corrente formattata come nel programma di address@hidden
@command{date}:
+
address@hidden @code{getlocaltime()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getlocaltime()}
address@hidden
address@hidden file eg/lib/gettime.awk
+# getlocaltime.awk --- ottiene l'ora del giorno in un formato usabile
address@hidden endfile
address@hidden
address@hidden file eg/lib/gettime.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain, May 1993
+#
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/gettime.awk
+
+# Restituisce una stringa nel formato dell'output di date(1)
+# Riempie l'argomento del vettore time con valori individuali:
+# time["second"] -- secondi (0 - 59)
+# time["minute"] -- minuti (0 - 59)
+# time["hour"] -- ore (0 - 23)
+# time["althour"] -- ore (0 - 12)
+# time["monthday"] -- giorno del mese (1 - 31)
+# time["month"] -- mese dell'anno (1 - 12)
+# time["monthname"] -- nome del mese
+# time["shortmonth"] -- nome breve del mese
+# time["year"] -- anno modulo 100 (0 - 99)
+# time["fullyear"] -- anno completo
+# time["weekday"] -- giorno della settimana (domenica = 0)
+# time["altweekday"] -- giorno della settimana
(address@hidden@dotless{i}} = 0)
+# time["dayname"] -- nome del giorno della settimana
+# time["shortdayname"] -- nome breve del giorno della settimana
+# time["yearday"] -- giorno dell'anno (0 - 365)
+# time["timezone"] -- abbreviazione del nome della zona di fuso orario
+# time["ampm"] -- designazione di AM o PM
+# time["weeknum"] -- numero della settimana, domenica primo giorno
+# time["altweeknum"] -- numero della settimana,
address@hidden@dotless{i}} primmo giorno
+
+function getlocaltime(ora, ret, adesso, i)
address@hidden
+ # ottiene data e ora una volta sola,
+ # evitando chiamate di sistema non necessarie
+ adesso = systime()
+
+ # restituisce l'output in stile date(1)
address@hidden lun 8 giu 2015, 20.39.38, CEST
address@hidden "%a %e %b %Y , %H.%M.%S, %Z"
+ ret = strftime("%a %e %b %Y, %H.%M.%S, %Z", adesso)
+
+ # clear out target array
+ delete time
+
+ # immette i valori, forzando i valori numerici
+ # a essere numerici aggiungendo uno 0
+ time["second"] = strftime("%S", adesso) + 0
+ time["minute"] = strftime("%M", adesso) + 0
+ time["hour"] = strftime("%H", adesso) + 0
+ time["althour"] = strftime("%I", adesso) + 0
+ time["monthday"] = strftime("%d", adesso) + 0
+ time["month"] = strftime("%m", adesso) + 0
+ time["monthname"] = strftime("%B", adesso)
+ time["shortmonth"] = strftime("%b", adesso)
+ time["year"] = strftime("%y", adesso) + 0
+ time["fullyear"] = strftime("%Y", adesso) + 0
+ time["weekday"] = strftime("%w", adesso) + 0
+ time["altweekday"] = strftime("%u", adesso) + 0
+ time["dayname"] = strftime("%A", adesso)
+ time["shortdayname"] = strftime("%a", adesso)
+ time["yearday"] = strftime("%j", adesso) + 0
+ time["timezone"] = strftime("%Z", adesso)
+ time["ampm"] = strftime("%p", adesso)
+ time["weeknum"] = strftime("%U", adesso) + 0
+ time["altweeknum"] = strftime("%W", adesso) + 0
+
+ return ret
address@hidden
address@hidden endfile
address@hidden example
+
+Gli indici di stringa sono address@hidden facili da usare e leggere rispetto ai
+vari formati
+richiesti da @code{strftime()}. Il programma @code{alarm} illustrato in
address@hidden alarm}
+usa questa funzione.
+Una progettazione address@hidden generica della funzione @code{getlocaltime()}
+avrebbe permesso all'utente di fornire un valore di data e ora
+opzionale da usare al posto della data/ora corrente.
+
address@hidden Funzione readfile
address@hidden Leggere un intero file in una sola volta
+
+Spesso @`e conveniente avere il contenuto di un intero file disponibile
+in memoria, visto
+come un'unica stringa. Un modo chiaro e semplice per far address@hidden
potrebbe essere
+questo:
+
address@hidden
+function readfile(file, temp, contenuto)
address@hidden
+ if ((getline temp < file) < 0)
+ return
+
+ contenuto = temp
+ while (getline temp < file) > 0)
+ contenuto = contenuto RT tmp
+
+ close(file)
+ return contenuto
address@hidden
address@hidden example
+
+Questa funzione legge da @code{file} un record alla volta, ricostruendo
+l'intero contenuto del file nella variabile locale @code{contenuto}.
+Funziona, ma non @`e detto che sia efficiente.
+
+La funzione seguente, basata su un suggerimento di Denis Shirokov,
+legge l'intero contenuto del file in un colpo solo:
+
address@hidden @code{readfile()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{readfile()}
address@hidden
address@hidden file eg/lib/readfile.awk
+# readfile.awk --- legge un intero file in un colpo solo
address@hidden endfile
address@hidden
address@hidden file eg/lib/readfile.awk
+#
+# Idea originale di Denis Shirokov, cosmogen@@gmail.com, aprile 2013
+#
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/readfile.awk
+
+function readfile(file, temp, salva_rs)
address@hidden
+ salva_rs = RS
+ RS = "^$"
+ getline temp < file
+ close(file)
+ RS = salva_rs
+
+ return temp
address@hidden
address@hidden endfile
address@hidden example
+
+Funziona impostando @code{RS} a @samp{^$}, un'espressione regolare che
+non trova nessuna corrispondenza se il file ha un contenuto.
address@hidden
+legge i dati dal file contenuto in @code{temp}, tentando di trovare una
+corrispondenza con @code{RS}.
+La ricerca dopo ogni lettura non ha mai successo, ma termina
+rapidamente, e quindi @command{gawk} inserisce in
address@hidden l'intero contenuto del file.
+(@xref{Record} per informazioni su @code{RT} e @code{RS}.)
+
+Se @code{file} @`e vuoto, il valore di ritorno @`e la stringa vuota.
+Quindi, il codice chiamante address@hidden usare qualcosa simile a questo:
+
address@hidden
+contenuto = readfile("/qualche/percorso")
+if (length(contenuto) == 0)
+ # file vuoto @dots{}
address@hidden example
+
+La verifica serve a determinare se il file @`e vuoto o no. Una verifica
+equivalente potrebbe essere @samp{contenuto == ""}.
+
address@hidden di estensione Readfile} per una funzione di estensione
+anch'essa finalizzata a leggere un intero file in memoria.
+
address@hidden Apici alla shell
address@hidden Stringhe con apici da passare alla shell
+
address@hidden included by permission
address@hidden
+Date: Sun, 27 Jul 2014 17:16:16 -0700
+Message-ID: <address@hidden>
+Subject: Useful awk function
+From: Mike Brennan <address@hidden>
+To: Arnold Robbins <address@hidden>
address@hidden ignore
+
+Michael Brennan propone il seguente modello di programma,
+da lui usato spesso:
+
address@hidden
+#! /bin/sh
+
+awkp='
+ @dots{}
+ '
+
address@hidden | awk "$awkp" | /bin/sh
address@hidden example
+
+Per esempio, un suo programma chiamato @address@hidden
+file con suffisso @dfn{flac} contengono normalmente dei brani musicali.
address@hidden @`e un programma che permette di modificare
+le informazioni address@hidden contenute all'inizio di un file di tipo
address@hidden ha questa forma:
+
address@hidden
+$ @kbd{flac-edit -song="Whoope! That's Great" file.flac}
address@hidden example
+
address@hidden genera in output il seguente script, da passare alla
+shell (@file{/bin/sh}) per essere eseguito:
+
address@hidden
+chmod +w file.flac
+metaflac --remove-tag=TITLE file.flac
+LANG=en_US.88591 metaflac --set-tag=TITLE='Whoope! That'"'"'s Great' file.flac
+chmod -w file.flac
address@hidden example
+
+Si noti la address@hidden di gestire gli apici nello script da passare alla
shell.
+La funzione
address@hidden()} li prepara nel formato richiesto.
address@hidden @`e la stringa di un solo
+carattere @code{"'"} e @code{QSINGLE} @`e la stringa di tre caratteri
address@hidden"\"'\""}:
+
address@hidden
address@hidden file eg/lib/shellquote.awk
+# shell_quote --- pone tra apici un argomento da passare alla shell
address@hidden endfile
address@hidden
address@hidden file eg/lib/shellquote.awk
+#
+# Michael Brennan
+# brennan@@madronabluff.com
+# September 2014
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/shellquote.awk
+
+function shell_quote(s, # parametro
+ SINGLE, QSINGLE, i, X, n, ret) # variabili locali
address@hidden
+ if (s == "")
+ return "\"\""
+
+ SINGLE = "\x27" # apice singolo
+ QSINGLE = "\"\x27\"" # apice singolo incapsulato
+ n = split(s, X, SINGLE)
+
+ ret = SINGLE X[1] SINGLE
+ for (i = 2; i <= n; i++)
+ ret = ret QSINGLE SINGLE X[i] SINGLE
+
+ return ret
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Gestione File Dati
address@hidden Gestione di @value{DF}
+
address@hidden file, gestione di
address@hidden gestione di file
address@hidden libreria di funzioni @command{awk}, gestire file di dati
address@hidden funzioni, libreria di, gestire file di dati
+Questa @value{SECTION} presenta funzioni utili per gestire
address@hidden da riga di comando.
+
address@hidden
+* Funzione filetrans:: Una funzione per gestire il passaggio da un
+ file in input al successivo.
+* Funzione rewind:: Una funzione per rileggere il file in input.
+* Controllo di file:: Controllare che i file in input siano
+ accessibili.
+* File vuoti:: Controllare se i file in input sono vuoti.
+* Ignorare assegnamenti di variabili:: Trattare assegnamenti di variabili.
+ come nomi di file.
address@hidden menu
+
address@hidden Funzione filetrans
address@hidden Trovare i limiti dei @value{DF}
+
address@hidden file, gestione di, limiti dei file-dati
address@hidden file, inizializzazione e pulizia
+Ognuna delle regole @code{BEGIN} ed @code{END} viene eseguita esattamente
+solo una volta, rispettivamente all'inizio e alla fine del programma
address@hidden (@pxref{BEGIN/END}).
+Una volta noi (gli autori di @command{gawk}) siamo venuti in contatto
+con un utente che
+erroneamemnte pensava che le regole @code{BEGIN} venissero eseguite all'inizio
+di ogni @value{DF} e le regole @code{END} alla fine di ogni @value{DF}.
+
+Quando lo abbiamo informato che
+non era address@hidden@dotless{i}}, ci ha chiesto di aggiungere un nuovo
criterio di ricerca speciale
+a @command{gawk}, chiamato @code{BEGIN_FILE} e @code{END_FILE}, che avesse il
+comportamento desiderato. Ci ha fornito anche il codice per far questo.
+
+Non @`e stato necessario aggiungere a @command{gawk} questi criteri di ricerca
+speciali; il lavoro si address@hidden fare tranquillamente usando
@command{awk}, come
+illustrato nel seguente programma di libreria. @`E strutturato in modo da
+chiamare due funzioni fornite dall'utente, @code{a_inizio_file()} e
address@hidden()}, all'inizio e alla fine di ogni @value{DF}. Oltre a risolvere
+il problema in sole nove(!) righe di codice,
+questa soluzione @`e @emph{portabile}; il
+programma funziona con qualsiasi implementazione di @command{awk}:
+
address@hidden
+# transfile.awk
+#
+# Dare all'utente un aggancio per il passaggio
+# da un file in input a quello successivo
+#
+# L'utente deve fornire le funzioni a_inizio_file() ed a_fine_file()
+# ciascuna delle quali @`e invocata
+# quando il file, rispettivamente,
+# inizia e finisce.
address@hidden #
address@hidden # Arnold Robbins, arnold@@skeeve.com, Public Domain
address@hidden # January 1992
+
+FILENAME != _nome_file_vecchio @{
+ if (_nome_file_vecchio != "")
+ a_fine_file(_nome_file_vecchio)
+ _nome_file_vecchio = FILENAME
+ a_inizio_file(FILENAME)
address@hidden
+
+END @{ a_fine_file(FILENAME) @}
address@hidden example
+
+Questo file [transfile.awk] dev'essere caricato prima del programma
+``principale'' dell'utente,
+in modo che la regola ivi contenuta venga eseguita per prima.
+
+Questa regola dipende dalla variabile di @command{awk} @code{FILENAME}, che
+cambia automaticamente per ogni nuovo @value{DF}. Il @value{FN} corrente viene
+salvato in una variabile privata, @code{_nome_file_vecchio}. Se
@code{FILENAME} non @`e
+uguale a @code{_nome_file_vecchio}, inizia l'elaborazioone di un nuovo
@value{DF} ed
address@hidden necessario chiamare @code{a_fine_file()} per il vecchio file.
Poich@'e
address@hidden()} dovrebbe essere chiamato solo se un file @`e stato elaborato,
il
+programma esegue prima un controllo per assicurarsi che
@code{_nome_file_vecchio} non
+sia la stringa nulla. Il programma assegna poi il valore corrente di
address@hidden a @code{_nome_file_vecchio} e chiama @code{a_inizio_file()} per
il file.
+Poich@'e, come tutte le variabili di @command{awk}, @code{_nome_file_vecchio}
@`e
+inizializzato alla stringa nulla, questa regola viene eseguita correttamente
+anche per il primo @value{DF}.
+
+Il programma contiene anche una regola @code{END} per completare l'elaborazione
+per l'ultimo file. Poich@'e questa regola @code{END} viene prima di qualsiasi
+regola @code{END} contenuta nel programma ``principale'',
address@hidden()} viene
+chiamata per prima. Ancora una volta, l'address@hidden di poter avere
address@hidden regole
address@hidden ed @code{END} dovrebbe risultare chiara.
+
address@hidden @code{a_inizio_file()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{a_inizio_file()}
address@hidden @code{a_fine_file()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{a_fine_file()}
+Se lo stesso @value{DF} compare due volte di fila sulla riga di comando,
address@hidden()} e @code{a_inizio_file()} non vengono eseguite alla fine del
primo
+passaggio e all'inizio del secondo passaggio.
+La versione seguente risolve il problema:
+
address@hidden
address@hidden file eg/lib/ftrans.awk
+# ftrans.awk --- gestisce il passaggio da un file dati al successivo
+#
+# L'utente deve fornire le funzioni a_inizio_file() ed a_fine_file()
address@hidden endfile
address@hidden
address@hidden file eg/lib/ftrans.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# November 1992
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/ftrans.awk
+
+FNR == 1 @{
+ if (_filename_ != "")
+ a_fine_file(_filename_)
+ _filename_ = FILENAME
+ a_inizio_file(FILENAME)
address@hidden
+
+END @{ a_fine_file(_filename_) @}
address@hidden endfile
address@hidden example
+
address@hidden
+La
address@hidden iftex
address@hidden wc}
+mostra come utilizzare questa funzione di libreria e come address@hidden
+semplifichi la scrittura del programma principale.
+
address@hidden Allora perch@'e @command{gawk} ha @code{BEGINFILE} e
@code{ENDFILE}?
+
+Ci si address@hidden, probabilmente: perch@'e, se le funzioni
@code{a_inizio_file()} e
address@hidden()} possono eseguire il compito, @command{gawk} prevede i
+criteri di
+ricerca @code{BEGINFILE} e @code{ENDFILE}?
+
+Buona domanda. Normalmente, se @command{awk} non riesce ad aprire un file,
+questo fatto
+provoca un errore fatale immediato. In tal caso, per una funzione definita
+dall'utente non vi @`e alcun modo di affrontare il problema, giacch@'e la
+chiamata verrebbe effettuata
+solo dopo aver aperto il file e letto il primo record.
+Quindi, la ragione principale di @code{BEGINFILE} @`e quella di dare un
+``aggancio'' per gestire i file che non posso essere elaborati.
address@hidden esiste per simmetria, e perch@'e consente facilmente
+una pulizia "file per file". Per maggiori informazioni si faccia
+riferimento alla @ref{BEGINFILE/ENDFILE}.
address@hidden sidebar
+
address@hidden Funzione rewind
address@hidden Rileggere il file corrente
+
address@hidden file, leggere un
address@hidden file, rileggere un
+Un'altra richiesta per una nuova funzione predefinita @`e stata per
+una funzione per rileggere il file corrente.
+L'utente che l'ha richiesta non voleva dover usare @code{getline}
+(@pxref{Getline})
+all'interno di un ciclo.
+
+Comunque, se non si @`e nella regola @code{END}, @`e piuttosto facile
+fare in modo di chiudere il corrente file in input immediatamente
+e ricominciare a leggerlo dall'inizio.
+In mancanza di un nome migliore, chiameremo la funzione @code{rewind()}:
+
address@hidden @code{rewind()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{rewind()}
address@hidden
address@hidden file eg/lib/rewind.awk
+# rewind.awk --- ricarica il file corrente e ricomincia a leggerlo
address@hidden endfile
address@hidden
address@hidden file eg/lib/rewind.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# September 2000
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/rewind.awk
+
+function rewind( i)
address@hidden
+ # sposta in alto i rimanenti argomenti
+ for (i = ARGC; i > ARGIND; i--)
+ ARGV[i] = ARGV[i-1]
+
+ # assicurarsi che gawk sappia raggiungerli
+ ARGC++
+
+ # fa address@hidden@dotless{i}} che il file corrente sia il prossimo a
essere letto
+ ARGV[ARGIND+1] = FILENAME
+
+ # do it
+ nextfile
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{rewind()} dipende dalla variabile @code{ARGIND}
+(@pxref{Variabili auto-assegnate}), che @`e specifica di @command{gawk}.
Dipende anche
+dalla parola chiave @code{nextfile} (@pxref{Istruzione nextfile}).
address@hidden, non si dovrebbe chiamarla da una regola @code{ENDFILE}.
+(Non sarebbe peraltro necessario, perch@'e @command{gawk} legge il file
+successivo non appena la regola @code{ENDFILE} finisce!)
+
+Occorre prestare attenzione quando si chiama @code{rewind()}. Si
address@hidden
+provocare una ricorsione infinita se non si sta attenti. Ecco un
+esempio di uso:
+
address@hidden
+$ @kbd{cat dati}
address@hidden a
address@hidden b
address@hidden c
address@hidden d
address@hidden e
+
+$ cat @kbd{test.awk}
address@hidden FNR == 3 && ! riavvolto @{
address@hidden riavvolto = 1
address@hidden rewind()
address@hidden @}
address@hidden
address@hidden @{ print FILENAME, FNR, $0 @}
+
+$ @kbd{gawk -f rewind.awk -f test.awk dati }
address@hidden data 1 a
address@hidden data 2 b
address@hidden data 1 a
address@hidden data 2 b
address@hidden data 3 c
address@hidden data 4 d
address@hidden data 5 e
address@hidden example
+
address@hidden Controllo di file
address@hidden Controllare che i @value{DF} siano leggibili
+
address@hidden risoluzione di problemi, address@hidden file-dati
address@hidden address@hidden, address@hidden controllare la
address@hidden file, non elaborare
+Normalmente, se si fornisce ad @command{awk} un @value{DF} che non @`e
leggibile,
+il programma
+si arresta con un errore fatale. Ci sono casi in cui sarebbe preferibile
+ignorare semplicemente questi file e address@hidden criterio di
+ricerca speciale @code{BEGINFILE} (@pxref{BEGINFILE/ENDFILE}) fornisce un
+meccanismo alternativo per trattare i file che non sono leggibili.
+Tuttavia, il codice qui proposto fornisce una soluzione portabile.}
+Si address@hidden far questo facendo precedere il proprio programma
@command{awk} dal
+seguente programma:
+
address@hidden @code{readable.awk}, programma
address@hidden
address@hidden file eg/lib/readable.awk
+# readable.awk --- file di libreria per saltare file non leggibili
address@hidden endfile
address@hidden
address@hidden file eg/lib/readable.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# October 2000
+# December 2010
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/readable.awk
+
+BEGIN @{
+ for (i = 1; i < ARGC; i++) @{
+ if (ARGV[i] ~ /^[a-zA-Z_][a-zA-Z0-9_]*=.*/ \
+ || ARGV[i] == "-" || ARGV[i] == "/dev/stdin")
+ continue # assegnamento di variabile o standard input
+ else if ((getline aperdere < ARGV[i]) < 0) # file non leggibile
+ delete ARGV[i]
+ else
+ close(ARGV[i])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden risoluzione di problemi, funzione @code{getline}
address@hidden comando @code{getline}, risoluzione di problemi
address@hidden @code{getline}, comando, risoluzione di problemi
+Questo codice funziona, perch@'e l'errore di @code{getline} non @`e fatale.
+Rimuovendo l'elemento da @code{ARGV} con @code{delete}
+si tralascia il file (perch@'e non @`e address@hidden nella lista).
+Si veda anche @ref{ARGC e ARGV}.
+
+Poich@'e per i nomi delle variabili @command{awk} si possono usare solo lettere
+dell'alfabeto inglese, di proposito il controllo con espressioni regolari
+non usa classi di
+carattere come @samp{[:alpha:]} e @samp{[:alnum:]}
+(@pxref{Espressioni tra parentesi quadre}).
+
address@hidden File vuoti
address@hidden Ricerca di file di lunghezza zero
+
+Tutte le implementazioni note di @command{awk} ignorano senza
+mandare alcun messaggio i file di
+lunghezza zero. Questo @`e un effetto collaterale del ciclo implicito di
address@hidden "leggi un record e confrontalo con le regole": quando
address@hidden cerca di leggere un record da un file vuoto, riceve
immediatamente
+un'indicazione di fine-file address@hidden, chiude il file,
+e prosegue con il
+successivo @value{DF} presente nella riga di comando, @emph{senza}
+eseguire alcun codice
+di programma @command{awk} a livello di utente.
+
+Usando la variabile @code{ARGIND} di @command{gawk}
+(@pxref{Variabili predefinite}), @`e possibile accorgersi quando un @value{DF}
address@hidden stato saltato. Simile al file di libreria illustrato in
address@hidden filetrans}, il seguente file di libreria chiama una funzione
+di nome @code{zerofile()} che l'utente deve fornire. Gli argomenti passati
+sono il @value{FN} e la posizione del file in @code{ARGV}:
+
address@hidden @code{zerofile.awk}, programma
address@hidden
address@hidden file eg/lib/zerofile.awk
+# zerofile.awk --- file di libreria per elaborare file in input vuoti
address@hidden endfile
address@hidden
address@hidden file eg/lib/zerofile.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# June 2003
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/zerofile.awk
+
+BEGIN @{ Argind = 0 @}
+
+ARGIND > Argind + 1 @{
+ for (Argind++; Argind < ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
+
+ARGIND != Argind @{ Argind = ARGIND @}
+
+END @{
+ if (ARGIND > Argind)
+ for (Argind++; Argind <= ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
address@hidden endfile
address@hidden example
+
+La variabile definita dall'utente @code{Argind} permette al programma
address@hidden
+di tracciare il suo percorso all'interno di @code{ARGV}. Ogniqualvolta il
+programma rileva che @code{ARGIND} @`e maggiore di @samp{Argind + 1}, vuol dire
+che uno o address@hidden file vuoti sono stati tralasciati. L'azione chiama
poi
address@hidden()} per ogni file che @`e stato saltato, incrementando
+ogni volta @code{Argind}.
+
+La regola @samp{Argind != ARGIND} tiene semplicemente aggiornato @code{Argind}
+nel caso che non ci siano file vuoti.
+
+Infine, la regola @code{END} prende in considerazione il caso di un qualsiasi
+file vuoto alla fine degli argomenti nella riga di comando. Si noti che nella
+condizione del ciclo @code{for}, la verifica usa l'operatore @samp{<=}, non
address@hidden<}.
+
address@hidden Ignorare assegnamenti di variabili
address@hidden Trattare assegnamenti di variabile come @value{FNS}
+
address@hidden assegnamenti di variabile, visti come nomi di file
address@hidden file, nomi di, assegnamenti di variabile visti come
address@hidden nomi di file, assegnamenti di variabile visti come
+Occasionalmente, potrebbe essere address@hidden opportuno che @command{awk}
non elabori gli
+assegnamenti di variabile presenti sulla riga di comando
+(@pxref{Opzioni di assegnamento}).
+In particolare, se si ha un @value{FN} che contiene un carattere @samp{=},
address@hidden tratta il @value{FN} come un assegnamento e non lo elabora.
+
+Alcuni utenti hanno suggerito un'opzione aggiuntiva da riga di comando per
address@hidden per disabilitare gli assegnamenti dati sulla riga di comando.
+Comunque, poche righe di codice di programmazione in un file di libreria
+hanno lo stesso effetto:
+
address@hidden @code{noassign.awk}, programma
address@hidden programma @code{noassign.awk}
address@hidden
address@hidden file eg/lib/noassign.awk
+# noassign.awk --- file di libreria per evitare la address@hidden
+# di una speciale opzione per disabilitare gli assegnamenti da
+# riga di comando
address@hidden endfile
address@hidden
address@hidden file eg/lib/noassign.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# October 1999
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/noassign.awk
+
+function disable_assigns(argc, argv, i)
address@hidden
+ for (i = 1; i < argc; i++)
+ if (argv[i] ~ /^[a-zA-Z_][a-zA-Z0-9_]*=.*/)
+ argv[i] = ("./" argv[i])
address@hidden
+
+BEGIN @{
+ if (Disabilita_variabili)
+ disable_assigns(ARGC, ARGV)
address@hidden
address@hidden endfile
address@hidden example
+
+Il programma va poi eseguito in questo modo:
+
address@hidden
+awk -v Disabilita_variabili=1 -f noassign.awk -f vostro_programma.awk *
address@hidden example
+
+La funzione esegue un ciclo che esamina ogni argomento.
+Antepone @samp{./} a
+qualsiasi argomento che abbia la forma di un assegnamento
+di variabile, trasformando address@hidden@dotless{i}} quell'argomento in un
@value{FN}.
+
+L'uso di @code{Disabilita_variabili} consente di disabilitare assegnamenti di
+variabile dati sulla riga di comando al momento dell'invocazione,
+assegnando alla variabile un valore @dfn{vero}.
+Se non viene impostata la variabile @`e inizializzata a zero (address@hidden
address@hidden), e gli argomenti sulla riga di comando
+non vengono modificati.
+
address@hidden Funzione getopt
address@hidden Elaborare opzioni specificate sulla riga di comando
+
address@hidden libreria di funzioni @command{awk}, opzioni sulla riga di comando
address@hidden funzioni, libreria di, opzioni sulla riga di comando
address@hidden riga di comando, opzioni, elaborazione di
address@hidden opzioni sulla riga di comando, elaborazione di
address@hidden funzioni, libreria di, libreria C
address@hidden argomenti, elaborazione di
+La maggior parte dei programmi di address@hidden su sistemi compatibili con
POSIX
+prevedono opzioni presenti sulla riga di comando che possono essere usate per
+cambiare il modo in cui un programma si comporta. @command{awk} @`e un
esempio di
+tali programmi (@pxref{Opzioni}).
+Spesso le opzioni hanno degli @dfn{argomenti} (address@hidden, dati che
servono al
+programma per eseguire correttamente le opzioni specificate
+sulla riga di comando).
+Per esempio, l'opzione @option{-F} di @command{awk} richiede di usare la
stringa
+specificata
+come separatore di campo. La prima occorrenza, sulla riga di comando, di
address@hidden o di una stringa che non inizia con @samp{-} segnala la fine
+delle opzioni.
+
address@hidden @code{getopt()}, funzione (libreria C)
address@hidden funzione @code{getopt()} (libreria C)
+I moderni sistemi Unix hanno una funzione C chiamata @code{getopt()} per
+elaborare gli argomenti presenti
+sulla riga di comando. Il programmatore fornisce una
+stringa che descrive le opzioni, ognuna delle quali consiste di
+una sola lettera. Se un'opzione richiede un
+argomento, nella stringa l'opzione @`e seguita da due punti.
+A @code{getopt()} vengono anche
+passati il numero e i valori degli argomenti presenti sulla riga di comando
+e viene chiamata in un ciclo.
address@hidden()} scandisce gli argomenti della riga di comando cercando
+le lettere delle opzioni.
+A ogni passaggio del ciclo restituisce un carattere
+singolo che rappresenta la successiva lettera di opzione trovata, o @samp{?}
+se viene trovata un'opzione non prevista.
+Quando restituisce @minus{}1, non ci sono ulteriori
+opzioni da trattare sulla riga di comando.
+
+Quando si usa @code{getopt()}, le opzioni che non prevedono argomenti
+possono essere raggruppate.
+Inoltre, le opzioni che hanno argomenti richiedono obbligatoriamente che
+l'argomento sia specificato.
+L'argomento address@hidden seguire immediatamente la lettera
+dell'opzione, o address@hidden costituire un argomento separato sulla riga di
comando.
+
+Dato un ipotetico programma che ha tre opzioni sulla riga di comando,
address@hidden, @option{-b} e @option{-c}, dove
address@hidden richiede un argomento, tutti i seguenti sono modi validi per
+invocare il programma:
+
address@hidden
+programma -a -b pippo -c dati1 dati2 dati3
+programma -ac -bpippo -- dati1 dati2 dati3
+programma -acbpippo dati1 dati2 dati3
address@hidden example
+
+Si noti che quando l'argomento @`e raggruppato con la sua opzione,
+la parte rimanente
+dell'argomento @`e considerato come argomento dell'opzione.
+In quest'esempio, @option{-acbpippo} indica che tutte le opzioni
address@hidden, @option{-b} e @option{-c} sono presenti,
+e che @samp{pippo} @`e l'argomento dell'opzione @option{-b}.
+
address@hidden()} fornisce quattro variabili esterne a disposizione del
+programmatore:
+
address@hidden @code
address@hidden optind
+L'indice nel vettore dei valori degli argomenti (@code{argv}) dove si
address@hidden
+trovare il primo argomento sulla riga di comando che non sia un'opzione.
+
address@hidden optarg
+Il valore (di tipo stringa) dell'argomento di un'opzione.
+
address@hidden opterr
+Solitamente @code{getopt()} stampa un messaggio di errore quando trova
un'opzione
+non valida. Impostando @code{opterr} a zero si disabilita questa
address@hidden
+(un'applicazione potrebbe voler stampare un proprio messaggio di errore.)
+
address@hidden optopt
+La lettera che rappresenta l'opzione sulla riga di comando.
address@hidden table
+
+Il seguente frammento di codice C mostra come @code{getopt()} potrebbe
+elaborare gli argomenti della riga di comando per @command{awk}:
+
address@hidden
+int
+main(int argc, char *argv[])
address@hidden
+ @dots{}
+ /* stampa un appropriato messaggio */
+ opterr = 0;
+ while ((c = getopt(argc, argv, "v:f:F:W:")) != -1) @{
+ switch (c) @{
+ case 'f': /* file */
+ @dots{}
+ break;
+ case 'F': /* separatore di campo */
+ @dots{}
+ break;
+ case 'v': /* assegnamento di variabile */
+ @dots{}
+ break;
+ case 'W': /* estensione */
+ @dots{}
+ break;
+ case '?':
+ default:
+ messaggio_di_aiuto();
+ break;
+ @}
+ @}
+ @dots{}
address@hidden
address@hidden example
+
+Incidentalmente, @command{gawk} al suo interno usa la funzione GNU
address@hidden()} per elaborare sia le normali opzioni che quelle lunghe
+in stile GNU
+(@pxref{Opzioni}).
+
+L'astrazione fornita da @code{getopt()} @`e molto utile ed @`e piuttosto comoda
+anche nei programmi @command{awk}. Di seguito si riporta una versione
address@hidden di @code{getopt()}. Questa funzione mette in evidenza uno dei
+maggiori punti deboli di @command{awk}, che @`e quello di essere molto carente
+nella manipolazione di caratteri singoli. Sono necessarie ripetute chiamate a
address@hidden()} per accedere a caratteri singoli.
+(@pxref{Funzioni per stringhe})address@hidden funzione
address@hidden stata scritta prima che @command{gawk} acquisisse la
address@hidden di
+dividere le stringhe in caratteri singoli usando @code{""} come separatore.
address@hidden stata lasciata address@hidden@dotless{i}}, poich@'e l'uso di
@code{substr()} @`e address@hidden portabile.}
+
+La spiegazione della funzione viene data
+man mano che si elencano i pezzi di codice che la compongono:
+
address@hidden @code{getopt()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getopt()}
address@hidden
address@hidden file eg/lib/getopt.awk
+# getopt.awk --- imita in awk la funzione di libreria C getopt(3)
address@hidden endfile
address@hidden
address@hidden file eg/lib/getopt.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+#
+# Initial version: March, 1991
+# Revised: May, 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/getopt.awk
+
+# Variabili esterne:
+# Optind -- indice in ARGV del primo argomento che non @`e un'opzione
+# Optarg -- valore di tipo stringa dell'argomento dell'opzione corrente
+# Opterr -- se diverso da zero, viene stampato un messaggio diagnostico
+# Optopt -- lettera dell'opzione corrente
+
+# Restituisce:
+# -1 alla fine delle opzioni
+# "?" per un'opzione non riconosciuta
+# <c> un carattere che rappresenta l'opzione corrente
+
+# Dati privati:
+# _opti -- indice in un'opzione multipla, p.es., -abc
address@hidden endfile
address@hidden example
+
+La funzione inizia con commenti che elencano e descrivono le variabili globali
+utilizzate, spiegano quali sono i valori di ritorno, il loro significato, e
+ogni altra variabile che @`e
+``esclusiva'' a questa funzione di libreria. Tale
+documentazione @`e essenziale per qualsiasi programma, e in modo particolare
per
+le funzioni di libreria.
+
+La funzione @code{getopt()} dapprima controlla che sia stata effettivamente
+chiamata con una stringa di opzioni (il parametro @code{opzioni}). Se
address@hidden ha lunghezza zero, @code{getopt()} restituisce immediatamente
address@hidden:
+
address@hidden @code{getopt()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getopt()}
address@hidden
address@hidden file eg/lib/getopt.awk
+function getopt(argc, argv, opzioni, unaopz, i)
address@hidden
+ if (length(opzioni) == 0) # nessuna opzione specificata
+ return -1
+
address@hidden
+ if (argv[Optind] == "--") @{ # fatto tutto
+ Optind++
+ _opti = 0
+ return -1
address@hidden group
+ @} else if (argv[Optind] !~ /^-[^:[:space:]]/) @{
+ _opti = 0
+ return -1
+ @}
address@hidden endfile
address@hidden example
+
+Il successivo controllo cerca la fine delle opzioni. Due trattini
+(@option{--}) marcano la fine delle opzioni da riga di comando, e lo stesso
+fa qualsiasi
+argomento sulla riga di comando che non inizi con @samp{-}. @code{Optind} @`e
+usato per scorrere il vettore degli argomenti presenti sulla riga di comando;
+mantiene il suo valore attraverso chiamate successive a @code{getopt()},
perch@'e
address@hidden una variabile globale.
+
+L'espressione regolare che viene usata, @address@hidden/^-[^:[:space:]/}},
+chiede di cercare un
address@hidden seguito da qualsiasi cosa che non sia uno spazio vuoto o un
carattere
+di due punti. Se l'argomento corrente sulla riga di comando non corrisponde a
+quest'espressione regolare, vuol dire che non si tratta di un'opzione, e
+quindi viene terminata l'elaborazione delle opzioni. Continuando:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+ if (_opti == 0)
+ _opti = 2
+ unaopz = substr(argv[Optind], _opti, 1)
+ Optopt = unaopz
+ i = index(opzioni, unaopz)
+ if (i == 0) @{
+ if (Opterr)
+ printf("%c -- opzione non ammessa\n", unaopz) > "/dev/stderr"
+ if (_opti >= length(argv[Optind])) @{
+ Optind++
+ _opti = 0
+ @} else
+ _opti++
+ return "?"
+ @}
address@hidden endfile
address@hidden example
+
+La variabile @code{_opti} tiene traccia della posizione nell'argomento
+della riga di comando correntemente in esame
+(@code{argv[Optind]}). Se opzioni multiple sono
+raggruppate con un @samp{-} (p.es., @option{-abx}), @`e necessario
+restituirle all'utente una per volta.
+
+Se @code{_opti} @`e uguale a zero, viene impostato a due, ossia all'indice
+nella
+stringa del successivo carattere da esaminare (@samp{-}, che @`e alla
+posizione uno viene ignorato).
+La variabile @code{unaopz} contiene il carattere,
+ottenuto con @code{substr()}. Questo @`e salvato in @code{Optopt} per essere
+usato dal programma principale.
+
+Se @code{unaopz} non @`e nella stringa delle opzioni @code{opzioni},
+si tratta di un'opzione
+non valida. Se @code{Opterr} @`e diverso da zero, @code{getopt()} stampa un
+messaggio di errore sullo @dfn{standard error} che @`e simile al messaggio
+emesso dalla versione C di @code{getopt()}.
+
+Poich@'e l'opzione non @`e valida, @`e necessario tralasciarla e passare al
successivo
+carattere di opzione. Se @code{_opti} @`e maggiore o uguale alla lunghezza
+dell'argomento corrente della riga di comando, @`e necessario passare al
+successivo argomento, in modo che @code{Optind} venga incrementato e
address@hidden sia reimpostato a zero. In caso contrario, @code{Optind} viene
+lasciato com'@`e e @code{_opti} viene soltanto incrementato.
+
+In ogni caso, poich@'e l'opzione non @`e valida, @code{getopt()} restituisce
address@hidden"?"}. Il programma principale address@hidden esaminare
@code{Optopt} se serve
+conoscere quale lettera di opzione @`e quella non valida. Proseguendo:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+ if (substr(opzioni, i + 1, 1) == ":") @{
+ # ottiene un argomento di opzione
+ if (length(substr(argv[Optind], _opti + 1)) > 0)
+ Optarg = substr(argv[Optind], _opti + 1)
+ else
+ Optarg = argv[++Optind]
+ _opti = 0
+ @} else
+ Optarg = ""
address@hidden endfile
address@hidden example
+
+Se l'opzione richiede un argomento, la lettera di opzione @`e seguita da due
punti
+nella stringa @code{opzioni}. Se rimangono altri caratteri nell'argomento
+corrente sulla riga di comando (@code{argv[Optind]}), il resto di quella
stringa
+viene assegnato a @code{Optarg}. Altrimenti, viene usato il successivo
+argomento sulla riga di comando (@samp{-xFOO} piuttosto che
address@hidden@w{-x FOO}}). In
+entrambi i casi, @code{_opti} viene reimpostato a zero, perch@'e non ci sono
altri
+caratteri da esaminare nell'argomento corrente sulla riga di comando.
+Continuando:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+ if (_opti == 0 || _opti >= length(argv[Optind])) @{
+ Optind++
+ _opti = 0
+ @} else
+ _opti++
+ return unaopz
address@hidden
address@hidden endfile
address@hidden example
+
+Infine, se @code{_opti} @`e zero o maggiore della lunghezza dell'argomento
+corrente sulla riga di comando, significa che l'elaborazione di
+quest'elemento in @code{argv} @`e
+terminata, quindi @code{Optind} @`e incrementato per
+puntare al successivo elemento in @code{argv}. Se nessuna delle condizioni @`e
+vera, viene incrementato solo @code{_opti}, cosicch@'e la successiva lettera di
+opzione address@hidden essere elaborata con la successiva chiamata a
@code{getopt()}.
+
+La regola @code{BEGIN} inizializza sia @code{Opterr} che @code{Optind} a uno.
address@hidden viene impostato a uno, perch@'e il comportamento di default per
address@hidden()} @`e quello di stampare un messaggio diagnostico dopo aver
visto
+un'opzione non valida. @code{Optind} @`e impostato a uno, perch@'e non
+c'@`e alcun motivo
+per considerare il nome del programma, che @`e in @code{ARGV[0]}:
+
address@hidden
address@hidden file eg/lib/getopt.awk
+BEGIN @{
+ Opterr = 1 # il default @`e eseguire una diagnosi
+ Optind = 1 # salta ARGV[0]
+
+ # programma di controllo
+ if (_getopt_test) @{
+ while ((_go_c = getopt(ARGC, ARGV, "ab:cd")) != -1)
+ printf("c = <%c>, Optarg = <%s>\n",
+ _go_c, Optarg)
+ printf("argomenti che non sono opzioni:\n")
+ for (; Optind < ARGC; Optind++)
+ printf("\tARGV[%d] = <%s>\n",
+ Optind, ARGV[Optind])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Il resto della regola @code{BEGIN} @`e un semplice programma di controllo. Qui
+sotto si riportano i risultati di
+due esecuzioni di prova
+del programma di controllo:
+
address@hidden
+$ @kbd{awk -f getopt.awk -v _getopt_test=1 -- -a -cbARG bax -x}
address@hidden c = <a>, Optarg = <>
address@hidden c = <c>, Optarg = <>
address@hidden c = <b>, Optarg = <ARG>
address@hidden argomenti che non sono opzioni:
address@hidden ARGV[3] = <bax>
address@hidden ARGV[4] = <-x>
+
+$ @kbd{awk -f getopt.awk -v _getopt_test=1 -- -a -x -- xyz abc}
address@hidden c = <a>, Optarg = <>
address@hidden x -- opzione non ammessa
address@hidden c = <?>, Optarg = <>
address@hidden argomenti che non sono opzioni:
address@hidden ARGV[4] = <xyz>
address@hidden ARGV[5] = <abc>
address@hidden example
+
+In entrambe le esecuzioni, il primo @option{--} fa terminare gli argomenti dati
+ad @command{awk}, in modo che @command{awk} non tenti di interpretare le
opzioni
address@hidden, etc. come sue opzioni.
+
address@hidden NOTA
+Dopo che @code{getopt()} @`e terminato,
+il codice a livello utente deve eliminare tutti gli elementi
+di @code{ARGV} da
+1 a @code{Optind}, in modo che @command{awk} non tenti di elaborare le opzioni
+sulla riga di comando come @value{FNS}.
address@hidden quotation
+
+Usare @samp{#!} con l'opzione @option{-E} address@hidden essere d'aiuto per
evitare
+conflitti tra le opzioni del proprio programma e quelle di @command{gawk},
+poich@'e l'opzione @option{-E} fa address@hidden@dotless{i}} che
@command{gawk} abbandoni
+l'elaborazione di ulteriori opzioni.
+(@address@hidden eseguibili} e
address@hidden
address@hidden).
address@hidden ifnotdocbook
address@hidden
address@hidden).
address@hidden ifdocbook
+
+Molti degli esempi presentati in
address@hidden di esempio},
+usano @code{getopt()} per elaborare i propri argomenti.
+
address@hidden Funzioni Passwd
address@hidden Leggere la lista degli utenti
+
address@hidden libreria di funzioni @command{awk}, leggere la lista degli utenti
address@hidden funzioni, libreria di, leggera la lista degli utenti
address@hidden utenti, leggere la lista degli
address@hidden lista degli address@hidden leggere la
address@hidden @code{PROCINFO}, vettore
address@hidden vettore @code{PROCINFO}
+Il vettore @code{PROCINFO}
+(@pxref{Variabili predefinite})
address@hidden accesso ai numeri ID reale ed effettivo dell'utente e del gruppo
e, se
+disponibili, alla serie di gruppi ulteriori a cui l'utente appartiene.
+Comunque, poich@'e questi sono numeri, non forniscono informazioni molto utili
per
+l'utente medio. Bisogna trovare un modo per reperire informazioni
+sull'utente associate con i numeri ID dell'utente e del gruppo. Questa
address@hidden illustra una raccolta di funzioni per ottenere le informazioni
+dalla lista gli utenti. @xref{Funzioni Group} per una raccolta di
+funzioni simili per ottenere informazioni dalla lista dei gruppi.
+
address@hidden @code{getpwent()}, funzione (libreria C)
address@hidden funzione @code{getpwent()} (libreria C)
address@hidden @code{getpwent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwent()}
address@hidden utenti, informazioni riguardo agli, ottenere
address@hidden login, informazioni
address@hidden account, informazioni sugli
address@hidden password, file delle
address@hidden file delle password
+Lo standard POSIX non definisce il file dove sono mantenute le informazioni
+degli utenti. Invece, fornisce il file d'intestazione @code{<pwd.h>}
+e diverse @dfn{subroutine} del linguaggio C per ottenere informazioni sugli
+utenti. La funzione primaria @`e @code{getpwent()}, che sta per ``get password
+entry''. La ``password'' proviene dal file originale della lista
+degli utenti, @file{/etc/passwd}, che contiene le informazioni sugli utenti
+assieme alle password criptate (da cui il nome)address@hidden @`e
+vero per le versioni address@hidden antiche di Unix. In quelle address@hidden
recenti,
+la @dfn{password} di ogni utente @`e stata trasferita nel file
@file{/etc/shadow},
+un file non accessibile dall'utente normale. La struttura del file
address@hidden/etc/passwd} @`e rimasta la stessa, ma al posto del campo
@dfn{password}
+c'@`e una @code{x}.}
+
address@hidden @command{pwcat}, programma
+Sebbene un programma @command{awk} possa semplicemente leggere
address@hidden/etc/passwd} direttamente, questo file address@hidden non
contenere tutte le
+informazioni su tutti gli utenti del address@hidden spesso che le
+informazioni sulla password siano memorizzate in una lista in rete.} Per
+essere sicuri di poter produrre una versione leggibile e completa della banca
+dati degli utenti, @`e necessario scrivere un piccolo programma in C che chiama
address@hidden()}. @code{getpwent()} viene definita in modo da restituire un
+puntatore a una @code{struct passwd}. Ogni volta che viene chiamata,
+restituisce l'elemento successivo della lista. Quando non ci sono
address@hidden
+elementi, restituisce @code{NULL}, il puntatore nullo. Quando accade
address@hidden, il
+programma C dovrebbe chiamare @code{endpwent()} per chiudere la lista..
+Quel che segue @`e @command{pwcat}, un programma in C che ``concatena'' la
+lista delle password:
+
address@hidden
address@hidden file eg/lib/pwcat.c
+/*
+ * pwcat.c
+ *
+ * Genera una versione stampabile della lista delle password.
+ */
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+/*
+ * Arnold Robbins, arnold@@skeeve.com, May 1993
+ * Public Domain
+ * December 2010, move to ANSI C definition for main().
+ */
+
+#if HAVE_CONFIG_H
+#include <config.h>
+#endif
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+#include <stdio.h>
+#include <pwd.h>
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+#if defined (STDC_HEADERS)
+#include <stdlib.h>
+#endif
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+int
+main(int argc, char **argv)
address@hidden
+ struct passwd *p;
+
+ while ((p = getpwent()) != NULL)
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+#ifdef ZOS_USS
+ printf("%s:%ld:%ld:%s:%s\n",
+ p->pw_name, (long) p->pw_uid,
+ (long) p->pw_gid, p->pw_dir, p->pw_shell);
+#else
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+ printf("%s:%s:%ld:%ld:%s:%s:%s\n",
+ p->pw_name, p->pw_passwd, (long) p->pw_uid,
+ (long) p->pw_gid, p->pw_gecos, p->pw_dir, p->pw_shell);
address@hidden endfile
address@hidden
address@hidden file eg/lib/pwcat.c
+#endif
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/pwcat.c
+
+ endpwent();
+ return 0;
address@hidden
address@hidden endfile
address@hidden example
+
+Se non si conosce il linguaggio C, non @`e il caso di preoccuparsi.
+L'output di @command{pwcat} @`e la lista degli utenti, nel formato
+tradizionale del file @file{/etc/passwd} con campi separati da due punti.
+I campi sono:
+
address@hidden @asis
address@hidden Login name
+Il nome di login dell'utente.
+
address@hidden Encrypted password
+La password criptata dell'utente. address@hidden non essere disponibile su
alcuni sistemi.
+
address@hidden User-ID
+L'ID numerico dell'utente.
+(Su alcuni sistemi, @`e un numero di formato @code{long} [32bit]
+del linguaggio C, e non nel formato @code{int} [16bit].
+Quindi, lo cambieremo in @code{long} per sicurezza.)
+
address@hidden Group-ID
+L'ID di gruppo numerico dell'utente.
+(Valgono le stesse considerazioni su @code{long} al posto di @code{int}.)
+
address@hidden Full name
+Il nome completo dell'utente, e talora altre informazioni associate
+all'utente.
+
address@hidden Home directory
+La directory di login (o ``home'') (nota ai programmatori di shell come
address@hidden).
+
address@hidden Login shell
+Il programma che viene eseguito quando l'utente effettua l'accesso. Questo @`e
+comunemente una shell, come Bash.
address@hidden table
+
+Di seguito si riportano alcune righe di un possibile output di @command{pwcat}:
+
address@hidden Jacobs, Andrew
address@hidden Robbins, Arnold
address@hidden Robbins, Miriam
address@hidden
+$ @kbd{pwcat}
address@hidden root:x:0:1:Operator:/:/bin/sh
address@hidden nobody:x:65534:65534::/:
address@hidden daemon:x:1:1::/:
address@hidden sys:x:2:2::/:/bin/csh
address@hidden bin:x:3:3::/bin:
address@hidden arnold:x:2076:10:Arnold Robbins:/home/arnold:/bin/sh
address@hidden miriam:x:112:10:Miriam Robbins:/home/miriam:/bin/sh
address@hidden andy:x:113:10:Andy Jacobs:/home/andy:/bin/sh
address@hidden
address@hidden example
+
+Dopo quest'introduzione, di seguito si riporta un gruppo di funzioni per
+ottenere informazioni sugli utenti. Ci sono diverse funzioni, che
+corrispondono alle omonime funzioni C:
+
address@hidden @code{_pw_init()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{_pw_init()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+# passwd.awk --- accedere alle informazioni del file delle password
address@hidden endfile
address@hidden
address@hidden file eg/lib/passwdawk.in
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised October 2000
+# Revised December 2010
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/passwdawk.in
+
+BEGIN @{
+ # modificare per adattarlo al sistema in uso
+ _pw_awklib = "/usr/local/libexec/awk/"
address@hidden
+
+function _pw_init( oldfs, oldrs, olddol0, pwcat, using_fw, using_fpat)
address@hidden
+ if (_pw_inizializzato)
+ return
+
+ oldfs = FS
+ oldrs = RS
+ olddol0 = $0
+ using_fw = (PROCINFO["FS"] == "FIELDWIDTHS")
+ using_fpat = (PROCINFO["FS"] == "FPAT")
+ FS = ":"
+ RS = "\n"
+
+ pwcat = _pw_awklib "pwcat"
+ while ((pwcat | getline) > 0) @{
+ _pw_byname[$1] = $0
+ _pw_byuid[$3] = $0
+ _pw_bycount[++_pw_totale] = $0
+ @}
+ close(pwcat)
+ _pw_contatore = 0
+ _pw_inizializzato = 1
+ FS = oldfs
+ if (using_fw)
+ FIELDWIDTHS = FIELDWIDTHS
+ else if (using_fpat)
+ FPAT = FPAT
+ RS = oldrs
+ $0 = olddol0
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, programma @code{pwcat}
address@hidden criterio di ricerca @code{BEGIN}, programma @code{pwcat}
+La regola @code{BEGIN} imposta una variabile privata col nome
+della directory in cui si
+trova @command{pwcat}.
+Poich@'e @`e destinata a essere usata da una routine di
+libreria di @command{awk}, si @`e scelto di metterla in
address@hidden/usr/local/libexec/awk}; comunque, in un altro sistema potrebbe
+essere messa in una directory differente.
+
+La funzione @code{_pw_init()} mette tre copie delle informazioni sull'utente in
+tre vettori associativi. I vettori sono indicizzati per nome-utente
+(@code{_pw_byname}), per numero di ID-utente (@code{_pw_byuid}), e per ordine
di
+occorrenza (@code{_pw_bycount}).
+La variabile @code{_pw_inizializzato} @`e usata per
+efficienza, poich@'e in questo modo @code{_pw_init()}
+viene chiamata solo una volta.
+
address@hidden @code{PROCINFO}, vettore, verificare la divisione in campi
address@hidden vettore @code{PROCINFO}, verificare la divisione in campi
address@hidden @code{getline}, comando, funzione definita dall'utente,
@code{_pw_init()}
address@hidden comando @code{getline}, funzione definita dall'utente,
@code{_pw_init()}
+Poich@'e questa funzione usa @code{getline} per leggere informazioni da
address@hidden, dapprima salva i valori di @code{FS}, @code{RS} e @code{$0}.
+Annota nella variabile @code{using_fw} se la suddivisione in campi
+usando @code{FIELDWIDTHS} @`e attiva o no.
+Far questo @`e necessario, poich@'e queste funzioni potrebbero essere chiamate
da
+qualsiai parte all'interno di un programma dell'utente, e l'utente
address@hidden
+suddividere i record in campi a suo piacimento.
address@hidden rende possibile ripristinare il corretto meccanismo di
suddivisione dei
+campi in un secondo momento. La verifica address@hidden restituire solo
@dfn{vero} per
address@hidden
+Il risultato address@hidden essere @dfn{falso} se si usa
address@hidden o @code{FPAT},
+o in qualche altra implementazione di @command{awk}.
+
+Il codice che controlla se si sta usando @code{FPAT}, utilizzando
address@hidden e @code{PROCINFO["FS"]}, @`e simile.
+
+La parte principale della funzione usa un ciclo per leggere le righe della
+lista, suddividere le righe in campi, e poi memorizzare la riga
+all'interno di ogni vettore a seconda delle address@hidden Quando il ciclo @`e
+completato, @address@hidden()}} fa pulizia chiudendo la @dfn{pipe},
+impostando @address@hidden a uno, e ripristinando @code{FS}
+(e @code{FIELDWIDTHS} o @code{FPAT}
+se necessario), @code{RS} e @code{$0}.
+L'uso di @address@hidden address@hidden spiegato a breve.
+
address@hidden @code{getpwnam()}, funzione (libreria C)
address@hidden funzione @code{getpwnam()} (libreria C)
+La funzione @code{getpwnam()} ha un nome utente come argomento di tipo
+stringa. Se
+quell'utente @`e presente nella lista, restituisce la riga appropriata.
+Altrimenti, il riferimento a un elemento inesistente del vettore
+aggiunge al vettore stesso un elemento il cui valore @`e la stringa nulla:
+
address@hidden @code{getpwnam()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwnam()}
address@hidden
address@hidden
address@hidden file eg/lib/passwdawk.in
+function getpwnam(nome)
address@hidden
+ _pw_init()
+ return _pw_byname[nome]
address@hidden
address@hidden endfile
address@hidden group
address@hidden example
+
address@hidden @code{getpwuid()}, funzione (libreria C)
address@hidden funzione @code{getpwuid()} (libreria C)
+In modo simile, la funzione @code{getpwuid()} ha per argomento
+il numero ID di un utente.
+Se un utente con quel numero si trova nella lista, restituisce la riga
+appropriata. Altrimenti restituisce la stringa nulla:
+
address@hidden @code{getpwuid()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwuid()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+function getpwuid(uid)
address@hidden
+ _pw_init()
+ return _pw_byuid[uid]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getpwent()}, funzione (libreria C)
address@hidden funzione @code{getpwent()} (libreria C)
+La funzione @code{getpwent()} scorre semplicemnte la lista, un elemento
+alla volta. Usa @code{_pw_contatore} per tener traccia della posizione
corrente
+nel vettore @code{_pw_bycount}:
+
address@hidden @code{getpwent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getpwent()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+function getpwent()
address@hidden
+ _pw_init()
+ if (_pw_contatore < _pw_totale)
+ return _pw_bycount[++_pw_contatore]
+ return ""
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{endpwent()}, funzione (libreria C)
address@hidden funzione @code{endpwent()} (libreria C)
+La funzione @address@hidden()}} reimposta @address@hidden a zero,
+in modo che chiamate successive a @code{getpwent()} ricomincino da capo:
+
address@hidden @code{endpwent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{endpwent()}
address@hidden
address@hidden file eg/lib/passwdawk.in
+function endpwent()
address@hidden
+ _pw_contatore = 0
address@hidden
address@hidden endfile
address@hidden example
+
+In questa serie di funzioni, il fatto che ogni subroutine chiami
address@hidden@w{_pw_init()}}
+per inizializzare il vettore della lista utenti risponde a una precisa
+scelta progettuale.
+Il lavoro necessario per eseguire un processo separato che generi la
+lista degli utenti, e l'I/O per esaminarla, si ha solo se il programma
+principale dell'utente chiama effettivamente una di queste funzioni.
+Se questo
+file di libreria viene caricato assieme a un programma dell'utente, ma non
+viene mai chiamata nessuna delle routine, non c'@`e nessun lavoro aggiuntivo
+richiesto in fase di esecuzione.
+(L'alternativa @`e quella di spostare il corpo di @address@hidden()}}
+all'interno di una regola @code{BEGIN}, che esegua sempre @command{pwcat}.
+Questo semplifica il codice ma richiede di eseguire un processo extra
+il cui risultato potrebbe non essere mai utilizzato dal programma.)
+
+A sua volta, chiamare ripetutamente @code{_pw_init()} non @`e troppo
+dispendioso, perch@'e la
+variabile @code{_pw_inizializzato} permette di evitare di leggere
+i dati relativi agli utenti address@hidden di una
+volta. Se la preoccupazione @`e quella di minimizzare il tempo di
+esecuzione del programma @command{awk},
+il controllo di @code{_pw_inizializzato} potrebbe essere spostato
+al di fuori di @code{_pw_init()} e duplicato in tutte le altre funzioni.
+In pratica, questo non @`e necessario, poich@'e la maggior parte dei
+programmi di @command{awk}
address@hidden I/address@hidden programmi si distinguono tradizionalemente in
+CPU-bound e I/O-bound. Quelli CPU-bound effettuano elaborazioni che non
+richiedono molta address@hidden di I/O, come ad esempio la preparazione di una
+tavola di numeri primi. Quelli I/O bound leggono dei file, ma richiedono
+poca address@hidden di elaborazione per ogni record letto.},
+e una tale modifica complicherebbe inutilmente il codice.
+
+Il programma @command{id} in @ref{Programma id}
+usa queste funzioni.
+
address@hidden Funzioni Group
address@hidden Leggere la lista dei gruppi
+
address@hidden libreria di funzioni @command{awk}, leggere la lista dei gruppi
address@hidden funzioni, libreria di, leggere la lista dei gruppi
address@hidden gruppi, lista dei, leggere la
address@hidden lista dei gruppi, leggere la
address@hidden @code{PROCINFO}, vettore, e appartenenza a gruppi
address@hidden @code{getgrent()}, funzione (libreria C)
address@hidden funzione @code{getgrent()} (libreria C)
address@hidden @code{getgrent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrent()}
address@hidden address@hidden informazioni su
address@hidden account, informazioni sugli
address@hidden gruppi, file dei
address@hidden file dei gruppi
+Molto di quel che @`e stato detto
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden Passwd}
+vale anche per la lista dei gruppi. Sebbene questa sia tradizionalmente
+contenuta in
+un file ben noto (@file{/etc/group}) in un altrettanto noto formato,
+lo standard
+POSIX prevede solo una serie di routine della libreria C
+(@code{<grp.h>} e @code{getgrent()})
+per accedere a tali informazioni.
+Anche se il file suddetto @`e disponibile, potrebbe non contenere delle
+informazioni
+complete. address@hidden, come per la lista degli utenti, @`e necessario
avere un
+piccolo programma in C che genera la lista dei gruppi come suo output.
address@hidden, un programma in C che fornisce la lista dei gruppi,
address@hidden il seguente:
+
address@hidden @command{grcat}, programma C
address@hidden programma C, @command{grcat}
address@hidden
address@hidden file eg/lib/grcat.c
+/*
+ * grcat.c
+ *
+ * Genera una versione stampabile della lista dei gruppi.
+ */
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+/*
+ * Arnold Robbins, arnold@@skeeve.com, May 1993
+ * Public Domain
+ * December 2010, move to ANSI C definition for main().
+ */
+
+/* Per OS/2, non fare nulla. */
+#if HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#if defined (STDC_HEADERS)
+#include <stdlib.h>
+#endif
+
+#ifndef HAVE_GETGRENT
+int main() { return 0; }
+#else
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/grcat.c
+#include <stdio.h>
+#include <grp.h>
+
+int
+main(int argc, char **argv)
address@hidden
+ struct group *g;
+ int i;
+
+ while ((g = getgrent()) != NULL) @{
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+#ifdef ZOS_USS
+ printf("%s:%ld:", g->gr_name, (long) g->gr_gid);
+#else
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/grcat.c
+ printf("%s:%s:%ld:", g->gr_name, g->gr_passwd,
+ (long) g->gr_gid);
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+#else
+ printf("%s:*:%ld:", g->gr_name, (long) g->gr_gid);
+#endif
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/grcat.c
+ for (i = 0; g->gr_mem[i] != NULL; i++) @{
+ printf("%s", g->gr_mem[i]);
address@hidden
+ if (g->gr_mem[i+1] != NULL)
+ putchar(',');
+ @}
address@hidden group
+ putchar('\n');
+ @}
+ endgrent();
+ return 0;
address@hidden
address@hidden endfile
address@hidden
address@hidden file eg/lib/grcat.c
+#endif /* HAVE_GETGRENT */
address@hidden endfile
address@hidden ignore
address@hidden example
+
+Ciascuna riga nella lista dei gruppi rappresenta un gruppo. I campi sono
+separati da due punti e rappresentano le seguenti informazioni:
+
address@hidden @asis
address@hidden Nome del gruppo
+Il nome del gruppo.
+
address@hidden Password del gruppo
+La password del gruppo criptata. In pratica, questo campo non viene mai usato;
+normalmente @`e vuoto o impostato a @samp{x}.
+
address@hidden Numero ID del gruppo
+Il numero ID del gruppo in formato numerico;
+l'associazione del nome al numero dev'essere univoca all'interno di questo
file.
+(Su alcuni sistemi, @`e un numero nel formato @code{long} [32bit]
+del linguaggio C, e non nel formato @code{int} [16bit].
+Quindi, lo cambieremo in @code{long} per sicurezza.)
+
address@hidden Lista dei membri del gruppo
+Una lista di nomi utente separati da virgole.
+Questi utenti sono i membri del gruppo.
+I sistemi Unix moderni consentono agli utenti di appartenere a
+diversi gruppi simultaneamente. Se il sistema in uso @`e uno di questi, ci
sono
+elementi in @code{PROCINFO} che vanno da @code{"group1"} fino a
address@hidden"address@hidden"} per quei numeri di ID di gruppo.
+(Si noti che @code{PROCINFO} @`e un'estensione @command{gawk};
address@hidden predefinite}.)
address@hidden table
+
+Di seguito si riporta quel che @command{grcat} potrebbe produrre:
+
address@hidden
+$ @kbd{grcat}
address@hidden wheel:x:0:arnold
address@hidden nogroup:x:65534:
address@hidden daemon:x:1:
address@hidden kmem:x:2:
address@hidden staff:x:10:arnold,miriam,andy
address@hidden other:x:20:
address@hidden
address@hidden example
+
+Qui ci sono le funzioni per ottenere informazioni relative alla lista dei
+gruppi. Ce ne sono diverse, costruite sul modello delle omonime funzioni della
+libreria C:
+
address@hidden @code{getline}, comando, funzione definita dall'utente,
@code{_gr_init()}
address@hidden comando @code{getline}, funzione definita dall'utente,
@code{_gr_init()}
address@hidden @code{_gr_init()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{_gr_init()}
address@hidden
address@hidden file eg/lib/groupawk.in
+# group.awk --- funzioni per il trattamento del file dei gruppi
address@hidden endfile
address@hidden
address@hidden file eg/lib/groupawk.in
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised October 2000
+# Revised December 2010
address@hidden endfile
address@hidden ignore
address@hidden line break on _gr_init for smallbook
address@hidden file eg/lib/groupawk.in
+
+BEGIN @{
+ # Modificare in base alla struttura del proprio sistema
+ _gr_awklib = "/usr/local/libexec/awk/"
address@hidden
+
+function _gr_init( oldfs, oldrs, olddol0, grcat,
+ using_fw, using_fpat, n, a, i)
address@hidden
+ if (_gr_inizializzato)
+ return
+
+ oldfs = FS
+ oldrs = RS
+ olddol0 = $0
+ using_fw = (PROCINFO["FS"] == "FIELDWIDTHS")
+ using_fpat = (PROCINFO["FS"] == "FPAT")
+ FS = ":"
+ RS = "\n"
+
+ grcat = _gr_awklib "grcat"
+ while ((grcat | getline) > 0) @{
+ if ($1 in _gr_byname)
+ _gr_byname[$1] = _gr_byname[$1] "," $4
+ else
+ _gr_byname[$1] = $0
+ if ($3 in _gr_bygid)
+ _gr_bygid[$3] = _gr_bygid[$3] "," $4
+ else
+ _gr_bygid[$3] = $0
+
+ n = split($4, a, "[ \t]*,[ \t]*")
+ for (i = 1; i <= n; i++)
+ if (a[i] in _gr_groupsbyuser)
+ _gr_groupsbyuser[a[i]] = _gr_groupsbyuser[a[i]] " " $1
+ else
+ _gr_groupsbyuser[a[i]] = $1
+
+ _gr_bycount[++_gr_contatore] = $0
+ @}
+ close(grcat)
+ _gr_contatore = 0
+ _gr_inizializzato++
+ FS = oldfs
+ if (using_fw)
+ FIELDWIDTHS = FIELDWIDTHS
+ else if (using_fpat)
+ FPAT = FPAT
+ RS = oldrs
+ $0 = olddol0
address@hidden
address@hidden endfile
address@hidden example
+
+La regola @code{BEGIN} imposta una variabile privata con il nome della
+directory in cui si trova @command{grcat}.
+Poich@'e @`e destinata a essere usata da una routine di
+libreria di @command{awk}, si @`e scelto di metterla in
address@hidden/usr/local/libexec/awk}; comunque, in un altro sistema potrebbe
+essere messa in una directory differente.
+
+Queste routine seguono le stesse linee generali delle routine per formare la
+lista degli utenti (@pxref{Funzioni Passwd}).
+La variabile @address@hidden @`e usata per
+essere sicuri che la lista venga letta una volta sola.
+La funzione @address@hidden()}} dapprima salva @code{FS},
address@hidden e
address@hidden, e poi imposta @code{FS} e @code{RS} ai valori da usare nel
+passare in rassegna le informazioni di gruppo. Inoltre
+viene annotato se si stanno usando @code{FIELDWIDTHS} o @code{FPAT}, per
+poter poi
+ripristinare il meccanismo di suddivisione in campi appropriato.
+
+Le informazioni sui gruppi sono memorizzate in diversi vettori associativi.
+I vettori sono indicizzati per nome di gruppo (@address@hidden), per
+numero ID del gruppo (@address@hidden), e per posizione nella lista
+(@address@hidden). C'@`e un vettore aggiuntivo indicizzato per nome utente
+(@address@hidden), che @`e una lista, separata da spazi, dei
+gruppi ai quali ciascun utente appartiene.
+
+Diversamente dalla lista degli utenti, @`e possibile avere address@hidden
record
+nella lista per lo stesso gruppo. Questo @`e frequente quando un gruppo ha
+un gran numero di membri. Un paio di tali voci potrebbero essere come queste:
+
address@hidden
+tvpeople:x:101:johnny,jay,arsenio
+tvpeople:x:101:david,conan,tom,joan
address@hidden example
+
+Per questo motivo, @code{_gr_init()} controlla se un nome di gruppo o un numero
+di ID di gruppo @`e stato address@hidden visto. Se address@hidden@dotless{i}}
fosse, i nomi utente vanno
+semplicemente concatenati con la precedente lista di address@hidden'@`e un
+piccolo problema col codice appena illustrato. Supponiamo che la prima volta
+non ci siano nomi. Questo codice aggiunge i nomi con una virgola iniziale.
+Inoltre non controlla che ci sia un @code{$4}.}
+
+Infine, @code{_gr_init()} chiude la @dfn{pipe} a @command{grcat}, ripristina
address@hidden (e @code{FIELDWIDTHS} o @code{FPAT}, se necessario), @code{RS} e
address@hidden, inizializza @code{_gr_contatore} a zero
+(per essere usato address@hidden tardi), e rende @code{_gr_inizializzato}
diverso da zero.
+
address@hidden @code{getgrnam()}, funzione (libreria C)
address@hidden funzione @code{getgrnam()} (libreria C)
+La funzione @code{getgrnam()} ha come argomento un nome di gruppo, e se quel
+gruppo esiste, viene restituito.
+
+Altrimenti, il riferimento a un elemento inesistente del vettore
+aggiunge al vettore stesso un elemento il cui valore @`e la stringa nulla:
+
address@hidden @code{getgrnam()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrnam()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgrnam(group)
address@hidden
+ _gr_init()
+ return _gr_byname[group]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getgrgid()}, funzione (libreria C)
address@hidden funzione @code{getgrgid()} (libreria C)
+La funzione @code{getgrgid()} @`e simile; ha come argomento un numero ID di
+gruppo e controlla le informazioni assiciate con quell'ID di gruppo:
+
address@hidden @code{getgrgid()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrgid()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgrgid(gid)
address@hidden
+ _gr_init()
+ return _gr_bygid[gid]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getgruser()}, funzione (libreria C)
address@hidden funzione @code{getgruser()} (libreria C)
+La funzione @code{getgruser()} non ha un equivalente in C. Ha come argomento un
+nome-utente e restituisce l'elenco dei gruppi di cui l'utente @`e membro:
+
address@hidden @code{getgruser()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgruser()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgruser(user)
address@hidden
+ _gr_init()
+ return _gr_groupsbyuser[user]
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{getgrent()}, funzione (libreria C)
address@hidden funzione @code{getgrent()} (libreria C)
+La funzione @code{getgrent()} scorre la lista un elemento alla volta.
+Usa @code{_gr_contatore} per ricordare la posizione corrente nella lista:
+
address@hidden @code{getgrent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{getgrent()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function getgrent()
address@hidden
+ _gr_init()
+ if (++_gr_contatore in _gr_bycount)
+ return _gr_bycount[_gr_contatore]
+ return ""
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden @code{endgrent()}, funzione (libreria C)
address@hidden funzione @code{endgrent()} (libreria C)
+La funzione @code{endgrent()} reimposta @code{_gr_contatore} a zero in modo che
address@hidden()} possa ricominciare da capo:
+
address@hidden @code{endgrent()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{endgrent()}
address@hidden
address@hidden file eg/lib/groupawk.in
+function endgrent()
address@hidden
+ _gr_contatore = 0
address@hidden
address@hidden endfile
address@hidden example
+
+Come con le routine per la lista degli utenti, ogni funzione chiama
address@hidden()} per inizializzare i vettori.
address@hidden@dotless{i}} facendo si address@hidden il solo
+lavoro aggiuntivo di eseguire @command{grcat} se queste funzioni vengono
+usate (rispetto a spostare il corpo di @code{_gr_init()} all'interno della
+regola @code{BEGIN}).
+
+La maggior parte del lavoro consiste nell'ispezionare la lista e nel
+costruire i vari vettori associativi. Le funzioni che l'utente chiama sono
+di per s@'e molto semplici, poich@'e si appoggiano sui vettori associativi di
address@hidden per fare il lavoro.
+
+Il programma @command{id} in @ref{Programma id}
+usa queste funzioni.
+
address@hidden Visitare vettori
address@hidden Attraversare vettori di vettori
+
address@hidden
+La
address@hidden iftex
address@hidden di vettori} trattava come @command{gawk}
+avere a disposizione vettori di vettori. In particolare, qualsiasi elemento di
+un vettore address@hidden essere uno scalare o un altro vettore. La funzione
address@hidden()} (@pxref{Funzioni per i tipi})
+permette di distinguere un vettore
+da uno scalare.
+La seguente funzione, @code{walk_array()}, attraversa ricorsivamente
+un vettore, stampando gli indici e i valori di ogni elemento.
+Viene chiamata col vettore e con una stringa che contiene il nome
+del vettore:
+
address@hidden @code{walk_array()}, funzione definita dall'utente
address@hidden funzione definita dall'utente, @code{walk_array()}
address@hidden
address@hidden file eg/lib/walkarray.awk
+function walk_array(vett, nome, i)
address@hidden
+ for (i in vett) @{
+ if (isarray(vett[i]))
+ walk_array(vett[i], (nome "[" i "]"))
+ else
+ printf("%s[%s] = %s\n", nome, i, vett[i])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Funziona eseguendo un ciclo su ogni elemento del vettore. Se un dato elemento
address@hidden esso stesso un vettore, la funzione chiama s@'e stessa
ricorsivamente,
+passando il sottovettore e una nuova stringa che rappresenta l'indice corrente.
+In caso contrario, la funzione stampa semplicemente il nome, l'indice e il
+valore dell'elemento.
+Qui di seguito si riporta un programma principale che ne mostra l'uso:
+
address@hidden
+BEGIN @{
+ a[1] = 1
+ a[2][1] = 21
+ a[2][2] = 22
+ a[3] = 3
+ a[4][1][1] = 411
+ a[4][2] = 42
+
+ walk_array(a, "a")
address@hidden
address@hidden example
+
+Quando viene eseguito, il programma produce il seguente output:
+
address@hidden
+$ @kbd{gawk -f walk_array.awk}
address@hidden a[1] = 1
address@hidden a[2][1] = 21
address@hidden a[2][2] = 22
address@hidden a[3] = 3
address@hidden a[4][1][1] = 411
address@hidden a[4][2] = 42
address@hidden example
+
+La funzione appena illustrata stampa semplicemente il nome e il valore
+di ogni elemento costituito da un vettore scalare. Comunque @`e facile
+generalizzarla, passandole il nome di una funzione da chiamare
+quando si attraversa un vettore. La funzione modificata @`e simile a questa:
+
address@hidden
address@hidden file eg/lib/processarray.awk
+function process_array(vett, nome, elab, do_arrays, i, nuovo_nome)
address@hidden
+ for (i in vett) @{
+ nuovo_nome = (nome "[" i "]")
+ if (isarray(vett[i])) @{
+ if (do_arrays)
+ @@elab(nuovo_nome, vett[i])
+ process_array(vett[i], nuovo_nome, elab, do_arrays)
+ @} else
+ @@elab(nuovo_nome, vett[i])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Gli argomenti sono i seguenti:
+
address@hidden @code
address@hidden vett
+Il vettore.
+
address@hidden nome
+Il nome del vettore (una stringa).
+
address@hidden elab
+Il nome della funzione da chiamare.
+
address@hidden do_arrays
+Se vale @dfn{vero}, la funzione address@hidden gestire elementi che sono
sottovettori.
address@hidden table
+
+Se devono essere elaborati sottovettori, questo vien fatto prima di
+attraversarne altri.
+
+Quando viene eseguita con la seguente struttura, la funzione produce lo stesso
+risultato della precedente versione di @code{walk_array()}:
+
address@hidden
+BEGIN @{
+ a[1] = 1
+ a[2][1] = 21
+ a[2][2] = 22
+ a[3] = 3
+ a[4][1][1] = 411
+ a[4][2] = 42
+
+ process_array(a, "a", "do_print", 0)
address@hidden
+
+function do_print(nome, elemento)
address@hidden
+ printf "%s = %s\n", nome, elemento
address@hidden
address@hidden example
+
address@hidden Sommario funzioni di libreria
address@hidden Riassunto
+
address@hidden @value{BULLET}
address@hidden
+Leggere i programmi @`e un eccellente metodo per imparare la "buona
+programmazione". Le funzioni e i programmi contenuti in questo @value{CHAPTER}
+e nel successivo si propongo questo obiettivo.
+
address@hidden
+Quando si scrivono funzioni di libreria di uso generale, si deve stare attenti
+ai nomi da dare alle variabili globali, facendo in modo che non entrino in
+conflitto con le variabili di un programma dell'utente.
+
address@hidden
+Le funzioni descritte qui appartengono alle seguenti categorie:
+
address@hidden nested list
address@hidden @asis
address@hidden Problemi generali
+Conversione di numeri in stringhe, verifica delle asserzioni, arrotondamenti,
+generazione di numeri casuali, conversione di caratteri in numeri, unione di
+stringhe, ottenimento di informazioni su data e ora facilmente usabili,
+e lettura di un intero file in una volta sola
+
address@hidden Gestione dei @value{DF}
+Annotazione dei limiti di un @value{DF}, rilettura del file corrente,
+ricerca di
+file leggibili, ricerca di file di lunghezza zero, e trattamento degli
+assegnamenti di variabili fatti sulla riga comando come @value{FNS}
+
address@hidden Elaborazione di opzioni sulla riga di comando
+Una versione @command{awk} della funzione del C standard @code{getopt()}
+
address@hidden Lettura dei file degli utenti e dei gruppi
+Due serie di routine equivalenti alle versioni disponibili nella libreria
+del linguaggio C
+
address@hidden Attraversamento di vettori di vettori
+Due funzioni che attraversano un vettore di vettori fino in fondo
address@hidden table
address@hidden end nested list
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi con le librerie
address@hidden Esercizi
+
address@hidden
address@hidden
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden vuoti}, abbiamo illustrato il programma @file{zerofile.awk},
+che fa uso della variabile di @command{gawk} @code{ARGIND}. Questo problema
address@hidden
+essere risolto senza dipendere da @code{ARGIND}? Se
address@hidden@dotless{i}}, come?
+
address@hidden
+# zerofile2.awk --- same thing, portably
+
+BEGIN @{
+ ARGIND = Argind = 0
+ for (i = 1; i < ARGC; i++)
+ Fnames[ARGV[i]]++
+
address@hidden
+FNR == 1 @{
+ while (ARGV[ARGIND] != FILENAME)
+ ARGIND++
+ Seen[FILENAME]++
+ if (Seen[FILENAME] == Fnames[FILENAME])
+ do
+ ARGIND++
+ while (ARGV[ARGIND] != FILENAME)
address@hidden
+ARGIND > Argind + 1 @{
+ for (Argind++; Argind < ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
+ARGIND != Argind @{
+ Argind = ARGIND
address@hidden
+END @{
+ if (ARGIND < ARGC - 1)
+ ARGIND = ARGC - 1
+ if (ARGIND > Argind)
+ for (Argind++; Argind <= ARGIND; Argind++)
+ zerofile(ARGV[Argind], Argind)
address@hidden
address@hidden ignore
+
address@hidden
+Come esercizio collegato, rivedere quel codice per gestire il caso in cui un
+valore contenuto in @code{ARGV} sia un assegnamento di variabile.
+
address@hidden
address@hidden June 13 2015: Antonio points out that this is answered in the
text. Ooops.
address@hidden
address@hidden vettori} ha illustrato una funzione che ispezionava un vettore
+multidimensionale per stamparlo. Comunque, ispezionare un vettore ed elaborare
+ogni elemento @`e un'operazione generica. Generalizzare la funzione
address@hidden()} agggiungendo un parametro aggiuntivo chiamato
address@hidden
+
+Quindi, all'interno del ciclo, invece di stampare l'indice e il valore
+dell'elemento del vettore, usare la sintassi della chiamata indiretta a una
+funzione (@pxref{Chiamate indirette})
+su @code{elab}, passandole l'indice e il valore.
+
+Nel chiamare @code{walk_array()}, si passa il nome di una
+funzione definita dall'utente che aspetta di ricevere un indice e un valore
+per poi elaborare l'elemento.
+
+Verificare la nuova versione stampando il vettore; si dovrebbe ottenere un
+output identico a quello della versione originale.
address@hidden ignore
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden Programmi di esempio
address@hidden Programmi utili scritti in @command{awk}
address@hidden @command{awk}, programmi, esempi di
address@hidden programmi @command{awk}, esempi di
address@hidden esempi di programmi @command{awk}
+
address@hidden FULLXREF ON
address@hidden
+Il
address@hidden iftex
address@hidden di libreria},
+ha prospettato l'idea che la lettura di programmi scritti in un certo
+linguaggio possa aiutare a imparare quel linguaggio. Questo
address@hidden ripropone lo stesso tema, presentando una miscellanea di
+programmi @command{awk} per il piacere di leggerli.
address@hidden FULLXREF OFF
address@hidden
+Ci sono tre @value{SECTIONS}.
+La prima spiega come eseguire i programmi descritti in questo
address@hidden
+
+La seconda illustra la versione @command{awk}
+di parecchi comuni programmi di address@hidden disponibili in POSIX.
+Si presuppone che si abbia address@hidden una certa address@hidden con questi
programmi,
+e che quindi i problemi a loro legati siano facilmente comprensibili.
+Riscrivendo questi programmi in @command{awk},
+ci si address@hidden focalizzare sulle address@hidden di @command{awk} nella
+risoluzione dei problemi di programmazione.
+
+La terza sezione @`e una collezione di programmi interessanti.
+Essi mirano a risolvere un certo numero di differenti problemi di
+manipolazione e di gestione dati. Molti dei programmi sono brevi, per
+evidenziare la address@hidden di @command{awk} di fare molte cose usando solo
+poche righe di codice.
address@hidden ifnotinfo
+
+Molti di questi programmi usano le funzioni di libreria che sono state
presentate
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria}.
+
address@hidden
+* Eseguire esempi:: Come eseguire questi esempi.
+* Cloni:: Cloni di programmi di address@hidden comuni.
+* Programmi vari:: Alcuni interessanti programmi in
+ @command{awk}.
+* Sommario dei programmi:: Sommario dei programmi.
+* Esercizi sui programmi:: Esercizi.
address@hidden menu
+
address@hidden Eseguire esempi
address@hidden Come eseguire i programmi di esempio.
+
+
+Per eseguire un dato programma, si procederebbe tipicamente
address@hidden@dotless{i}}:
+
address@hidden
+awk -f @var{programma} -- @var{opzioni} @var{file}
address@hidden example
+
address@hidden
+Qui, @var{programma} @`e il nome del programma @command{awk} (p.es.
address@hidden), @var{opzioni} sono le opzioni sulla riga di comando
+per il programma che iniziano con un @samp{-}, e @var{file} sono i
address@hidden in input.
+
+Se il sistema prevede il meccanismo @samp{#!} di specifica di un
address@hidden
+(@address@hidden eseguibili}),
+si address@hidden invece eseguire direttamente un programma:
+
address@hidden
+cut.awk -c1-8 i_miei_file > risultati
address@hidden example
+
+Se @command{awk} non @`e @command{gawk}, address@hidden invece essere
necessario usare:
+
address@hidden
+cut.awk -- -c1-8 i_miei_file > risultati
address@hidden example
+
address@hidden Cloni
address@hidden Reinventare la ruota per divertimento e profitto
address@hidden programmi POSIX, implementazione in @command{awk}
address@hidden POSIX, programmi, implementazione in @command{awk}
+
+Questa @value{SECTION} presenta un certo numero di programmi di address@hidden
+POSIX implementati in @command{awk}. Riscrivere questi programmi in
address@hidden @`e spesso divertente,
+perch@'e gli algoritmi possono essere espressi molto chiaramente, e il codice
address@hidden normalmente molto semplice e conciso. address@hidden @`e
possibile perch@'e @command{awk}
+facilita molto le cose al programmatore.
+
+Va precisato che questi programmi non sono necessariamente scritti per
+sostituire le versioni installate sul sistema in uso.
+Inoltre, nessuno di questi programmi @`e del tutto aderente ai address@hidden
recenti
+standard POSIX. Questo non @`e un problema; il loro scopo
address@hidden di illustrare la programmazione in linguaggio @command{awk} che
serve nel
+``mondo reale''.
+
+I programmi sono presentati in ordine alfabetico.
+
address@hidden
+* Programma cut:: Il programma di address@hidden @command{cut}.
+* Programma egrep:: Il programma di address@hidden
@command{egrep}.
+* Programma id:: Il programma di address@hidden @command{id}.
+* Programma split:: Il programma di address@hidden
@command{split}.
+* Programma tee:: Il programma di address@hidden @command{tee}.
+* Programma uniq:: Il programma di address@hidden
@command{uniq}.
+* Programma wc:: Il programma di address@hidden @command{wc}.
address@hidden menu
+
address@hidden Programma cut
address@hidden Ritagliare campi e colonne
+
address@hidden @command{cut}, programma di address@hidden
address@hidden programma di address@hidden @command{cut}
address@hidden campi, ritagliare
address@hidden colonne, ritagliare
+Il programma di address@hidden @command{cut} seleziona, o ``taglia''
(@dfn{cut}),
+caratteri o campi dal suo standard input e li
+spedisce al suo standard output.
+I campi sono separati da caratteri TAB per default,
+ma @`e possibile fornire un'opzione dalla riga di comando per cambiare il campo
address@hidden (address@hidden, il carattere che separa i campi). La
definizione di
+campo di @command{cut} @`e meno generale di quella di @command{awk}.
+
+Un uso comune del comando @command{cut} potrebbe essere quello di estrarre
+i nomi degli utenti correntemente collegati al sistema, a partire
+dall'output del comando @command{who}. Per esempio, la seguente
+pipeline genera una lista in ordine alfabetico, senza doppioni, degli utenti
+correntemente collegati al sistema:
+
address@hidden
+who | cut -c1-8 | sort | uniq
address@hidden example
+
+Le opzioni per @command{cut} sono:
+
address@hidden @code
address@hidden -c @var{lista}
+Usare @var{lista} come lista di caratteri da ritagliare. Elementi
+all'interno della lista
+possono essere separati da virgole, e intervalli di caratteri possono essere
+separated da trattini. La lista
address@hidden,15,22-35} specifica i caratteri da 1 a 8, 15, e da 22 a 35.
+
address@hidden -f @var{lista}
+Usare @var{lista} come lista di campi da ritagliare.
+
address@hidden -d @var{delimitatore}
+Usare @var{delimitatore} come carattere che separa i campi invece del
+carattere TAB.
+
address@hidden -s
+Evita la stampa di righe che non contengono il delimitatore di campo.
address@hidden table
+
+L'implementazione @command{awk} del comando @command{cut} usa la funzione
+di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e la funzione di libreria @code{join()}
+(@pxref{Funzione join}).
+
+Il programma inizia con un commento che descrive le opzioni, le funzioni
+di libreria necessarie, e una funzione @code{sintassi()} che stampa un
+messaggio ed esce. @code{sintassi()} @`e chiamato se si specificano degli
+argomenti non validi:
+
address@hidden @code{cut.awk}, programma
address@hidden programma @code{cut.awk}
address@hidden
address@hidden file eg/prog/cut.awk
+# cut.awk --- implementa cut in awk
address@hidden endfile
address@hidden
address@hidden file eg/prog/cut.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/cut.awk
+
+# Opzioni:
+# -f lista Ritagliare campi
+# -d c Carattere di delimitazione di campo
+# -c lista Ritagliare caratteri
+#
+# -s Sopprimere righe che non contengono il delimitatore
+#
+# Richiede le funzioni di libreria getopt() e join()
+
address@hidden
+function sintassi()
address@hidden
+ print("sintassi: cut [-f lista] [-d c] [-s] [file...]") > "/dev/stderr"
+ print("sintassi: cut [-c lista] [file...]") > "/dev/stderr"
+ exit 1
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
address@hidden @code{BEGIN}, criterio di ricerca, eseguire programmi
@command{awk} e
address@hidden criterio di ricerca @code{BEGIN}, eseguire programmi
@command{awk} e
address@hidden @code{FS}, variabile, eseguire programmi @command{awk} e
address@hidden variabile @code{FS}, eseguire programmi @command{awk} e
+Subito dopo c'@`e una regola @code{BEGIN} che analizza le opzioni della riga
+di comando.
+Questa regola imposta @code{FS} a un solo carattere TAB, perch@'e quello @`e
+il separatore di campo di @command{cut} per default.
+La regola poi imposta il separatore di campo in output allo stesso valore
+del separatore di campo in input. Un ciclo che usa @code{getopt()} esamina
+le opzioni della riga di comando. Una e una sola delle variabili
address@hidden o @code{per_caratteri} @`e impostata a "vero", per indicare
+che l'elaborazione address@hidden fatta per campi o per caratteri,
rispettivamente.
+Quando si ritaglia per caratteri, il separatore di campo in output @`e
+impostato alla stringa nulla:
+
address@hidden
address@hidden file eg/prog/cut.awk
+BEGIN @{
+ FS = "\t" # default
+ OFS = FS
+ while ((c = getopt(ARGC, ARGV, "sf:c:d:")) != -1) @{
+ if (c == "f") @{
+ per_campi = 1
+ lista_campi = Optarg
+ @} else if (c == "c") @{
+ per_caratteri = 1
+ lista_campi = Optarg
+ OFS = ""
+ @} else if (c == "d") @{
+ if (length(Optarg) > 1) @{
+ printf("cut: usa il primo carattere di %s" \
+ " come delimitatore\n", Optarg) > "/dev/stderr"
+ Optarg = substr(Optarg, 1, 1)
+ @}
+ fs = FS = Optarg
+ OFS = FS
+ if (FS == " ") # mette specifica in formato awk
+ FS = "[ ]"
+ @} else if (c == "s")
+ sopprimi = 1
+ else
+ sintassi()
+ @}
+
+ # Toglie opzioni da riga di comando
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
address@hidden endfile
address@hidden example
+
address@hidden separatori di campo, spazi come
address@hidden spazi come separatori di campo
+Nella scrittura del codice si deve porre particolare attenzione quando il
+delimitatore di campo @`e uno spazio. Usare
+un semplice spazio (@address@hidden" "}}) come valore per @code{FS} @`e
+sbagliato: @command{awk} separerebbe i campi con serie di spazi,
+TAB, e/o ritorni a capo, mentre devono essere separati solo da uno spazio.
+Per far questo, salviamo il carattere di spazio originale nella variabile
address@hidden per un uso futuro; dopo aver impostato @code{FS} a @code{"[ ]"}
non
address@hidden possibile usarlo direttamente per vedere se il carattere
delimitatore di
+campo @`e nella stringa.
+
+Si ricordi anche che dopo che si @`e finito di usare @code{getopt()}
+(come descritto nella @ref{Funzione getopt}),
address@hidden necessario
+eliminare tutti gli elementi del vettore @code{ARGV} da 1 a @code{Optind},
+in modo che @command{awk} non tenti di elaborare le opzioni della riga di
comando
+come @value{FNS}.
+
+Dopo aver elaborato le opzioni della riga di comando, il programma verifica
+che le opzioni siano coerenti. Solo una tra le opzioni @option{-c}
+e @option{-f} dovrebbe essere presente, ed entrambe richiedono una lista di
+campi. Poi il programma chiama
address@hidden()} oppure @code{prepara_lista_caratteri()} per
+preparare la lista dei campi o dei caratteri:
+
address@hidden
address@hidden file eg/prog/cut.awk
+ if (per_campi && per_caratteri)
+ sintassi()
+
+ if (per_campi == 0 && per_caratteri == 0)
+ per_campi = 1 # default
+
+ if (lista_campi == "") @{
+ print "cut: specificare lista per -c o -f" > "/dev/stderr"
+ exit 1
+ @}
+
+ if (per_campi)
+ prepara_lista_campi()
+ else
+ prepara_lista_caratteri()
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden()} pone la lista campi, usando la virgola come
+separatore, in un vettore. Poi, per
+ogni elemento del vettore, controlla che esso non sia un intervallo. Se @`e
+un intervallo, lo fa diventare un elenco. La funzione controlla l'intervallo
+specificato, per assicurarsi che il primo numero sia minore del secondo.
+Ogni numero nella lista @`e aggiunto al vettore @code{lista_c}, che
+semplicemente elenca i campi che saranno stampati. Viene usata la normale
+separazione in campi di @command{awk}. Il programma lascia ad @command{awk}
+il compito di separare i campi:
+
address@hidden
address@hidden file eg/prog/cut.awk
+function prepara_lista_campi( n, m, i, j, k, f, g)
address@hidden
+ n = split(lista_campi, f, ",")
+ j = 1 # indice in lista_c
+ for (i = 1; i <= n; i++) @{
+ if (index(f[i], "-") != 0) @{ # un intervallo
+ m = split(f[i], g, "-")
address@hidden
+ if (m != 2 || g[1] >= g[2]) @{
+ printf("cut: lista campi errata: %s\n",
+ f[i]) > "/dev/stderr"
+ exit 1
+ @}
address@hidden group
+ for (k = g[1]; k <= g[2]; k++)
+ lista_c[j++] = k
+ @} else
+ lista_c[j++] = f[i]
+ @}
+ ncampi = j - 1
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{prepara_lista_caratteri()} @`e address@hidden complicata di
address@hidden()}.
+L'idea qui @`e di usare la variabile di @command{gawk} @code{FIELDWIDTHS}
+(@pxref{Dimensione costante}),
+che descrive input a larghezza costante. Quando si usa una lista di
+caratteri questo @`e proprio il nostro caso.
+
+Impostare @code{FIELDWIDTHS} @`e address@hidden complicato che semplicemente
elencare
+i campi da stampare. Si deve tener traccia dei campi da
+stampare e anche dei caratteri che li separano, che vanno saltati.
+Per esempio, supponiamo che si vogliano i caratteri da 1 a 8, 15,
+e da 22 a 35. Per questo si specifica @samp{-c 1-8,15,22-35}. Il valore che
+corrisponde a questo nella variabile @code{FIELDWIDTHS} @`e
address@hidden@w{"8 6 1 6 14"}}. Questi sono cinque campi, e quelli da stampare
+sono @code{$1}, @code{$3}, e @code{$5}.
+I campi intermedi sono @dfn{riempitivo} (@dfn{filler}),
+ossia @`e address@hidden che separa i dati che si desidera estrarre.
address@hidden lista i campi da stampare, e @code{t} traccia l'elenco
+completo dei campi, inclusi i riempitivi:
+
address@hidden
address@hidden file eg/prog/cut.awk
+function prepara_lista_caratteri( campo, i, j, f, g, n, m, t,
+ filler, ultimo, lungo)
address@hidden
+ campo = 1 # contatore totale campi
+ n = split(lista_campi, f, ",")
+ j = 1 # indice in lista_c
+ for (i = 1; i <= n; i++) @{
+ if (index(f[i], "-") != 0) @{ # intervallo
+ m = split(f[i], g, "-")
+ if (m != 2 || g[1] >= g[2]) @{
+ printf("cut: lista caratteri errata: %s\n",
+ f[i]) > "/dev/stderr"
+ exit 1
+ @}
+ lungo = g[2] - g[1] + 1
+ if (g[1] > 1) # calcola lunghezza del riempitivo
+ filler = g[1] - ultimo - 1
+ else
+ filler = 0
address@hidden
+ if (filler)
+ t[campo++] = filler
address@hidden group
+ t[campo++] = lungo # lunghezza del campo
+ ultimo = g[2]
+ lista_c[j++] = campo - 1
+ @} else @{
+ if (f[i] > 1)
+ filler = f[i] - ultimo - 1
+ else
+ filler = 0
+ if (filler)
+ t[campo++] = filler
+ t[campo++] = 1
+ ultimo = f[i]
+ lista_c[j++] = campo - 1
+ @}
+ @}
+ FIELDWIDTHS = join(t, 1, campo - 1)
+ ncampi = j - 1
address@hidden
address@hidden endfile
address@hidden example
+
+Poi viene la regola che elabora i dati. Se l'opzione @option{-s} @`e stata
+specificata, il flag @code{sopprimi}
address@hidden vero. La prima istruzione
address@hidden accerta che il record in input abbia il separatore di
+campo. Se @command{cut} sta elaborando dei campi, e @code{sopprimi} @`e vero,
+e il carattere di separazione dei campi non @`e presente nel record, il
+record @`e ignorato.
+
+Se il record @`e valido, @command{gawk} ha address@hidden separato i dati in
campi,
+usando il carattere in @code{FS} o usando campi a lunghezza fissa
+e @code{FIELDWIDTHS}. Il ciclo scorre attraverso la lista di campi che
+si dovrebbero stampare. Il campo corrispondente @`e stampato se contiene dati.
+Se il campo successivo contiene pure dei dati, il carattere di separazione @`e
+scritto tra i due campi:
+
address@hidden
address@hidden file eg/prog/cut.awk
address@hidden
+ if (per_campi && sopprimi && index($0, fs) == 0)
+ next
+
+ for (i = 1; i <= ncampi; i++) @{
+ if ($lista_c[i] != "") @{
+ printf "%s", $lista_c[i]
+ if (i < ncampi && $lista_c[i+1] != "")
+ printf "%s", OFS
+ @}
+ @}
+ print ""
address@hidden
address@hidden endfile
address@hidden example
+
+Questa versione di @command{cut} utilizza la variabile @code{FIELDWIDTHS} di
address@hidden per ritagliare in base alla posizione dei caratteri. @`E
+possibile, in altre implementazioni di @command{awk} usare @code{substr()}
+(@pxref{Funzioni per stringhe}), ma
+la cosa @`e molto address@hidden complessa.
+La variabile @code{FIELDWIDTHS} fornisce una soluzione elegante al problema
+di suddividere la riga in input in singoli caratteri.
+
+
address@hidden Programma egrep
address@hidden Ricercare espressioni regolari nei file
+
address@hidden espressioni regolari, ricerca di
address@hidden ricercare, in file, espressioni regolari
address@hidden file, ricercare espressioni regolari nei
address@hidden @command{egrep}, programma di address@hidden
address@hidden programma di address@hidden @command{egrep}
+Il programma di address@hidden @command{egrep} ricerca occorrenze di
espressioni
+regolari all'interno di file. Usa
+espressioni regolari che sono quasi identiche a quelle disponibili in
address@hidden
address@hidden (@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
address@hidden (@pxref{Espressioni regolari}).
address@hidden ifnottex
+Si richiama address@hidden@dotless{i}}:
+
address@hidden
address@hidden address@hidden @code{'@var{espressione}'} @var{file} @dots{}
address@hidden display
+
address@hidden @`e un'espressione regolare. Normalmente, l'espressione
+regolare @`e protetta da apici per impedire alla shell di espandere ogni
+carattere speciale come @value{FN}.
+Normalmente, @command{egrep} stampa le righe per cui @`e stata trovata una
+corrispondenza. Se nella riga di comando si richiede di operare su
address@hidden di un
address@hidden, ogni riga in output @`e preceduta dal nome del file, e dal segno
+due punti.
+
+Le opzioni di @command{egrep} sono le seguenti:
+
address@hidden @code
address@hidden -c
+Stampa un contatore delle righe che corrispondono al criterio di ricerca,
+e non le righe stesse.
+
address@hidden -s
+Funziona in silenzio. Non si produce alcun output ma il codice di ritorno
+indica se il criterio di ricerca ha trovato almeno una corrispondenza.
+
address@hidden -v
+Inverte il senso del test. @command{egrep} stampa le righe che
address@hidden soddisfano il criterio di ricerca ed esce con successo se il
+criterio di ricerca non @`e soddisfatto.
+
address@hidden -i
+Ignora maiuscolo/minuscolo sia nel criterio di ricerca che nei dati in input.
+
address@hidden -l
+Stampa (elenca) solo i nomi dei file che corrispondono, e non le righe trovate.
+
address@hidden -e @var{espressione}
+Usa @var{espressione} come @dfn{regexp} da ricercare. Il motivo per cui
address@hidden prevista l'opzione @option{-e} @`e di
+permettere dei criteri di ricerca che
+inizino con un @samp{-}.
address@hidden table
+
+Questa versione usa la funzione di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e il programma di libreria che gestisce il passaggio da un file dati
+al successivo
+(@pxref{Funzione filetrans}).
+
+Il programma inizia con un commento descrittivo e poi c'@`e una regola
address@hidden
+che elabora gli argomenti della riga di comando usando @code{getopt()}.
+L'opzione @option{-i} (ignora maiuscolo/minuscolo) @`e particolarmente facile
+da implementare con @command{gawk}; basta usare la variabile predefinita
address@hidden
+(@pxref{Variabili predefinite}):
+
address@hidden @code{egrep.awk}, programma
address@hidden programma @code{egrep.awk}
address@hidden
address@hidden file eg/prog/egrep.awk
+# egrep.awk --- simula egrep in awk
+#
address@hidden endfile
address@hidden
address@hidden file eg/prog/egrep.awk
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/egrep.awk
+# Opzioni:
+# -c conta le righe trovate
+# -s sileziosa: genera solo il codice di ritorno
+# -v inverte test, successo se @dfn{regexp} non presente
+# -i ignora maiuscolo/minuscolo
+# -l stampa solo nomi file
+# -e espressione da ricercare
+#
+# Richiede la funzione getopt() e il programma di libreria
+# che gestisce il passaggio da un file dati al successivo
+
+BEGIN @{
+ while ((c = getopt(ARGC, ARGV, "ce:svil")) != -1) @{
+ if (c == "c")
+ conta_e_basta++
+ else if (c == "s")
+ non_stampare++
+ else if (c == "v")
+ inverti_test++
+ else if (c == "i")
+ IGNORECASE = 1
+ else if (c == "l")
+ solo_nomi_file++
+ else if (c == "e")
+ criterio_di_ricerca = Optarg
+ else
+ sintassi()
+ @}
address@hidden endfile
address@hidden example
+
+Nel seguito c'@`e il codice che gestisce il comportamento specifico di
address@hidden Se non @`e fornito esplicitamente alcun criterio di ricerca
+tramite l'opzione @option{-e}, si usa il primo argomento sulla riga di
+comando che non sia un'opzione.
+Gli argomenti della riga di comando di @command{awk} fino ad
address@hidden vengono cancellati,
+in modo che @command{awk} non tenti di elaborarli come file. Se
+non @`e stato specificato alcun nome di file, si usa lo standard input, e se
address@hidden presente address@hidden di un nome di file, lo si annota, in
modo che i @value{FNS}
+vengano scritti prima di ogni riga di output corrispondente:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+ if (criterio_di_ricerca == "")
+ criterio_di_ricerca = ARGV[Optind++]
+
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
+ if (Optind >= ARGC) @{
+ ARGV[1] = "-"
+ ARGC = 2
+ @} else if (ARGC - Optind > 1)
+ servono_nomi_file++
+
+# if (IGNORECASE)
+# criterio_di_ricerca = tolower(criterio_di_ricerca)
address@hidden
address@hidden endfile
address@hidden example
+
+Le ultime due righe sono solo dei commenti, in quanto non necessarie in
address@hidden Per altre versioni di
address@hidden, potrebbe essere necessario utilizzarle come istruzioni
+effettive (togliendo il "#").
+
+Il prossimo insieme di righe dovrebbe essere decommentato
+se non si sta usando @command{gawk}.
+Questa regola converte in minuscolo tutti i caratteri della riga in input,
+se @`e stata specificata l'opzione @address@hidden, qui si
+introduce un errore subdolo; se una corrispondenza viene trovata, viene
+inviata in output la riga tradotta, non quella originale.}
+La regola @`e
+commentata perch@'e non @`e necessaria se si usa @command{gawk}:
+
address@hidden
address@hidden file eg/prog/egrep.awk
address@hidden
+# if (IGNORECASE)
+# $0 = tolower($0)
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{a_inizio_file()} @`e chiamata dalla regola in
@file{ftrans.awk}
+quando ogni nuovo file viene elaborato. In questo caso, non c'@`e molto da
fare;
+ci si limita a inizializzare una variabile @code{contatore_file} a zero.
address@hidden serve a ricordare quante righe nel file corrente
+corrispondono al criterio di ricerca.
+Scegliere come nome di parametro @code{da_buttare} indica che sappiamo che
address@hidden()} @`e chiamata con un parametro, ma che noi non siamo
+interessati al suo valore:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+function a_inizio_file(da_buttare)
address@hidden
+ contatore_file = 0
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{endfile()} viene chiamata dopo l'elaborazione di ogni file.
+Ha influenza sull'output solo quando l'utente desidera un contatore del
+numero di righe che sono state individuate. @code{non_stampare} @`e vero nel
+caso si desideri solo il codice di
+ritorno. @code{conta_e_basta} @`e vero se si desiderano solo i contatori
+delle righe trovate. @command{egrep}
+quindi stampa i contatori solo se
+sia la stampa che il conteggio delle righe sono stati abilitati.
+Il formato di output deve tenere conto del numero di file sui quali si
+opera. Per finire, @code{contatore_file} @`e aggiunto a @code{totale}, in
+modo da stabilire qual @`e il numero totale di righe che ha soddisfatto il
+criterio di ricerca:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+function endfile(file)
address@hidden
+ if (! non_stampare && conta_e_basta) @{
+ if (servono_nomi_file)
+ print file ":" contatore_file
+ else
+ print contatore_file
+ @}
+
+ totale += contatore_file
address@hidden
address@hidden endfile
address@hidden example
+
+Si potrebbero usare i criteri di ricerca speciali @code{BEGINFILE} ed
address@hidden
+(@pxref{BEGINFILE/ENDFILE}),
+ma in quel caso il programma funzionerebbe solo usando @command{gawk}.
+Inoltre, questo esempio @`e stato scritto prima che a @command{gawk} venissero
+aggiunti i criteri speciali @code{BEGINFILE} ed @code{ENDFILE}.
+
+La regola seguente fa il grosso del lavoro per trovare righe corrispondenti
+al criterio di ricerca fornito. La variabile
address@hidden @`e vera se la riga @`e individuata dal criterio di ricerca.
+Se l'utente chiede invece le righe che non corrispondono, il senso di
address@hidden @`e invertito, usando l'operatore @samp{!}.
address@hidden @`e incrementato con il valore di
address@hidden, che vale uno o zero, a seconda che la corrispondenza sia
+stata trovata oppure no. Se la riga non corrisponde, l'istruzione
address@hidden passa ad esaminare il record successivo.
+
+Vengono effettuati anche altri controlli, ma soltanto se non
+si sceglie di contare le righe. Prima di tutto, se l'utente desidera solo
+il codice di ritorno (@code{non_stampare} @`e vero), @`e sufficiente sapere
+che @emph{una} riga nel file corrisponde, e si address@hidden passare al file
successivo
+usando @code{nextfile}. Analogamente, se stiamo solo stampando @value{FNS},
+possiamo stampare il @value{FN}, e quindi saltare al file successivo con
address@hidden
+Infine, ogni riga viene stampata, preceduta, se necessario, dal @value{FN} e
+dai due punti:
+
address@hidden @code{!} (punto esclamativo), operatore @code{!}
address@hidden punto esclamativo (@code{!}), operatore @code{!}
address@hidden
address@hidden file eg/prog/egrep.awk
address@hidden
+ corrisponde = ($0 ~ criterio_di_ricerca)
+ if (inverti_test)
+ corrisponde = ! corrisponde
+
+ contatore_file += corrisponde # 1 o 0
+
+ if (! corrisponde)
+ next
+
+ if (! conta_e_basta) @{
+ if (non_stampare)
+ nextfile
+
+ if (solo_nomi_file) @{
+ print nome_file
+ nextfile
+ @}
+
+ if (servono_nomi_file)
+ print nome_file ":" $0
+ else
+ print
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+La regola @code{END} serve a produrre il codice di ritorno corretto. Se
+non ci sono corrispondenze, il codice di ritorno @`e uno; altrimenti, @`e zero:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+END @{
+ exit (totale == 0)
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{sintassi()} stampa un messaggio per l'utente, nel caso
+siano state specificate opzioni non valide, e quindi esce:
+
address@hidden
address@hidden file eg/prog/egrep.awk
+function sintassi()
address@hidden
+ print("sintassi: egrep [-csvil] [-e criterio_di_ricerca] [file ...]")\
+ > "/dev/stderr"
+ print("\n\tegrep [-csvil] criterio_di_ricerca [file ...]") > "/dev/stderr"
+ exit 1
address@hidden
address@hidden endfile
address@hidden example
+
+
address@hidden Programma id
address@hidden Stampare informazioni sull'utente
+
address@hidden stampare informazioni utente
address@hidden utenti, informazioni riguardo agli, stampare
address@hidden @command{id}, programma di address@hidden
address@hidden programma di address@hidden @command{id}
+Il programma di address@hidden @command{id} elenca i numeri identificativi (ID)
+reali ed effettivi di un utente, e l'insieme dei gruppi a cui l'utente
+appartiene, se ve ne sono.
address@hidden stampa i numeri identificativi di utente e di gruppo solo se
+questi sono differenti da quelli reali. Se possibile, @command{id} elenca
+anche i corrispondenti nomi di utente e di gruppo.
+L'output potrebbe essere simile a questo:
+
address@hidden
+$ @kbd{id}
address@hidden uid=1000(arnold) gid=1000(arnold)
groups=1000(arnold),4(adm),7(lp),27(sudo)
address@hidden example
+
address@hidden @code{PROCINFO}, vettore, e @dfn{process ID} di utente e di
gruppo
+Questa informazione @`e parte di address@hidden che @`e reso disponibile dal
vettore
address@hidden di @command{gawk} (@pxref{Variabili predefinite}).
+Comunque, il programma di address@hidden @command{id} fornisce un output
address@hidden
+comprensibile che non una semplice lista di numeri.
+
+Ecco una versione semplice di @command{id} scritta in @command{awk}.
+Usa le funzioni di libreria che riguardano il database degli utenti
+(@pxref{Funzioni Passwd})
+e le funzioni di libreria che riguardano il database dei gruppi
+(@pxref{Funzioni Group})
+contenute
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria}.
+
+Il programma @`e abbastanza semplice. Tutto il lavoro @`e svolto nella regola
address@hidden I numeri ID di utente e di gruppo sono ottenuti da
address@hidden
+Il codice @`e ripetitivo. La riga nel database degli utenti che descrive
+l'ID reale dell'utente @`e divisa in parti, separate tra loro da @samp{:}.
+Il nome @`e il primo campo. Un codice analogo @`e usato per l'ID effettivo, e
+per i numeri che descrivono i gruppi:
+
address@hidden @code{id.awk}, programma
address@hidden programma @code{id.awk}
address@hidden
address@hidden file eg/prog/id.awk
+# id.awk --- implement id in awk
+#
+# Richiede funzioni di libreria per utente e gruppo
address@hidden endfile
address@hidden
address@hidden file eg/prog/id.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised February 1996
+# Revised May 2014
+# Revised September 2014
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/id.awk
+# l'output @`e:
+# uid=12(pippo) euid=34(pluto) gid=3(paperino) \
+# egid=5(paperina) groups=9(nove),2(due),1(uno)
+
address@hidden
+BEGIN @{
+ uid = PROCINFO["uid"]
+ euid = PROCINFO["euid"]
+ gid = PROCINFO["gid"]
+ egid = PROCINFO["egid"]
address@hidden group
+
+ printf("uid=%d", uid)
+ pw = getpwuid(uid)
+ stampa_primo_campo(pw)
+
+ if (euid != uid) @{
+ printf(" euid=%d", euid)
+ pw = getpwuid(euid)
+ stampa_primo_campo(pw)
+ @}
+
+ printf(" gid=%d", gid)
+ pw = getgrgid(gid)
+ stampa_primo_campo(pw)
+
+ if (egid != gid) @{
+ printf(" egid=%d", egid)
+ pw = getgrgid(egid)
+ stampa_primo_campo(pw)
+ @}
+
+ for (i = 1; ("group" i) in PROCINFO; i++) @{
+ if (i == 1)
+ printf(" gruppi=")
+ group = PROCINFO["group" i]
+ printf("%d", group)
+ pw = getgrgid(group)
+ stampa_primo_campo(pw)
+ if (("group" (i+1)) in PROCINFO)
+ printf(",")
+ @}
+
+ print ""
address@hidden
+
+function stampa_primo_campo(str, a)
address@hidden
+ if (str != "") @{
+ split(str, a, ":")
+ printf("(%s)", a[1])
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+Il test incluso nel ciclo @code{for} @`e degno di nota.
+Ogni ulteriore gruppo nel vettore @code{PROCINFO} ha come indice da
address@hidden"group1"} a @code{"address@hidden"} dove il numero
address@hidden @`e il numero totale di gruppi ulteriori).
+Tuttavia, non si sa quanti di questi gruppi ci siano per un dato utente.
+
+Questo ciclo inizia da uno, concatena il valore di ogni iterazione con
address@hidden"group"}, e poi usando l'istruzione @code{in} verifica se quella
+chiave @`e nel vettore (@pxref{Visitare elementi}). Quando @code{i} @`e
+incrementato oltre l'ultimo gruppo presente nel vettore, il ciclo termina.
+
+Il ciclo funziona correttamente anche se @emph{non} ci sono ulteriori
+gruppi; in quel caso la condizione risulta falsa fin dal primo controllo, e
+il corpo del ciclo non viene mai eseguito.
+
+La funzione @code{stampa_primo_campo()} semplicemente incapsula quelle parti di
+codice che vengono usate ripetutamente, rendendo il programma address@hidden
conciso e
+ordinato.
+In particolare, inserendo in questa funzione il test per la stringa nulla
+consente di risparmiare parecchie righe di programma.
+
+
address@hidden Programma split
address@hidden Suddividere in pezzi un file grosso
+
address@hidden FIXME: One day, update to current POSIX version of split
+
address@hidden file, splitting
address@hidden @code{split}, programma di address@hidden
address@hidden programma di address@hidden @code{split}
+Il programma @command{split} divide grossi file di testo in pezzi
address@hidden piccoli.
+La sua sintassi @`e la seguente:@footnote{Questo @`e la sintassi tradizionale.
+La versione POSIX del comando ha una sintassi differente, ma per lo scopo di
+questo programma @command{awk} la cosa non ha importanza.}
+
address@hidden
address@hidden address@hidden@var{contatore}}] address@hidden address@hidden
address@hidden display
+
+Per default,
+i file di output avranno nome @file{xaa}, @file{xab}, e
address@hidden@dotless{i}} via. Ogni file
+contiene 1.000 righe, con la probabile
+eccezione dell'ultimo file. Per
+cambiare il numero di righe in ogni file, va indicato un numero sulla riga
+di comando, preceduto da un segno meno (p.es., @samp{-500} per file con 500
+righe ognuno invece che 1.000). Per modificare i nomi dei file di output in
+qualcosa del tipo
address@hidden, @file{miofileab}, e address@hidden@dotless{i}} via, va indicato
un argomento
+ulteriore che specifica il prefisso del @value{FN}.
+
+Ecco una versione di @command{split} in @command{awk}. Usa le funzioni
address@hidden()} e @code{chr()} descritte nella
address@hidden ordinali}.
+
+Il programma dapprima imposta i suoi valori di default, e poi controlla che
+non siano stati specificati troppi argomenti. Quindi esamina gli argomenti
+uno alla volta. Il primo
+argomento potrebbe essere un segno meno seguito da un numero. Poich@'e il
+numero in questione address@hidden apparire negativo, lo si fa diventare
positivo, e
+viene usato per contare le righe. Il nome del @value{DF} @`e per ora ignorato
+e l'ultimo argomento @`e usato come prefisso per i @value{FNS} in output:
+
address@hidden @code{split.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{split.awk}
address@hidden
address@hidden file eg/prog/split.awk
+# split.awk --- comando split scritto in awk
+#
+# Richiede le funzioni di libreria ord() e chr()
address@hidden endfile
address@hidden
address@hidden file eg/prog/split.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised slightly, May 2014
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/split.awk
+# sintassi: split [-contatore] [file] [nome_in_output]
+
+BEGIN @{
+ outfile = "x" # default
+ contatore = 1000
+ if (ARGC > 4)
+ sintassi()
+
+ i = 1
+ if (i in ARGV && ARGV[i] ~ /^-[[:digit:]]+$/) @{
+ contatore = -ARGV[i]
+ ARGV[i] = ""
+ i++
+ @}
+ # testa argv nel caso che si legga da stdin invece che da file
+ if (i in ARGV)
+ i++ # salta nome file-dati
+ if (i in ARGV) @{
+ outfile = ARGV[i]
+ ARGV[i] = ""
+ @}
+
+ s1 = s2 = "a"
+ out = (outfile s1 s2)
address@hidden
address@hidden endfile
address@hidden example
+
+La regola seguente fa il grosso del lavoro. @code{contatore_t}
+(contatore temporaneo) tiene conto di
+quante righe sono state stampate sul file di output finora. Se questo
+numero supera il valore di @code{contatore}, @`e ora di chiudere il file
+corrente e di iniziare a scriverne uno nuovo.
+Le variabili @code{s1} e @code{s2} sono usate per creare i suffissi
+da apporre a @value{FN}. Se entrambi arrivano al valore @samp{z}, il file
address@hidden troppo grosso. Altrimenti, @code{s1} passa alla successiva
lettera
+dell'alfabeto e @code{s2} ricomincia da @samp{a}:
+
address@hidden else on separate line here for page breaking
address@hidden
address@hidden file eg/prog/split.awk
address@hidden
+ if (++contatore_t > contatore) @{
+ close(out)
+ if (s2 == "z") @{
+ if (s1 == "z") @{
+ printf("split: %s @`e troppo grosso da suddividere\n",
+ nome_file) > "/dev/stderr"
+ exit 1
+ @}
+ s1 = chr(ord(s1) + 1)
+ s2 = "a"
+ @}
address@hidden
+ else
+ s2 = chr(ord(s2) + 1)
address@hidden group
+ out = (outfile s1 s2)
+ contatore_t = 1
+ @}
+ print > out
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+La funzione @code{sintassi()} stampa solo un messaggio di errore ed esce:
+
address@hidden
address@hidden file eg/prog/split.awk
+function sintassi()
address@hidden
+ print("sintassi: split [-num] [file] [nome_in_output]") > "/dev/stderr"
+ exit 1
address@hidden
address@hidden endfile
address@hidden example
+
+Questo programma @`e un po' approssimativo; conta sul fatto che @command{awk}
chiuda
+automaticamente l'ultimo file invece di farlo in una regola @code{END}.
+Un altro presupposto del programma @`e che le lettere dell'alfabeto siano
+in posizioni consecutive nella codifica in uso, il che non @`e vero per i
+sistemi che usano la codifica EBCDIC.
+
address@hidden FOR_PRINT
+Si potrebbe pensare a come eliminare l'uso di
address@hidden()} e @code{chr()}; la cosa si address@hidden fare in modo tale
da risolvere
+anche il problema posto dalla codifica EBCDIC.
address@hidden ifset
+
+
address@hidden Programma tee
address@hidden Inviare l'output su address@hidden di un file
+
address@hidden file, address@hidden duplicare l'output su
address@hidden output, duplicarlo su address@hidden file
address@hidden @code{tee}, programma di address@hidden
address@hidden programma di address@hidden @code{tee}
+Il programma @code{tee} @`e noto come @dfn{pipe fitting} (tubo secondario).
address@hidden copia il suo standard input al suo standard output e inoltre lo
+duplica scrivendo sui file indicati nella riga di comando. La sua sintassi
address@hidden la seguente:
+
address@hidden
address@hidden address@hidden @var{file} @dots{}
address@hidden display
+
+L'opzione @option{-a} chiede a @code{tee} di aggiungere in fondo al file
+indicato, invece che riscriverlo dall'inizio.
+
+La regola @code{BEGIN} dapprima fa una copia di tutti gli argomenti presenti
+sulla riga di comando, in un vettore di nome @code{copia}.
address@hidden non serve, e quindi non viene copiato.
address@hidden non address@hidden usare @code{ARGV} direttamente, perch@'e
@command{awk} tenta
+di elaborare ogni @value{FN} in @code{ARGV} come dati in input.
+
address@hidden flag, variabili di tipo
address@hidden variabili di tipo indicatore address@hidden
+Se il primo argomento @`e @option{-a}, la variabile flag
address@hidden viene impostata a vero, e sia @code{ARGV[1]} che
address@hidden vengono cancellati. Se @code{ARGC} @`e minore di due, nessun
address@hidden @`e stato fornito, e @code{tee} stampa un messaggio di sintassi
ed
+esce.
+Infine, @command{awk} viene obbligato a leggere lo standard input
+impostando @code{ARGV[1]} al valore @code{"-"} e @code{ARGC} a due:
+
address@hidden @code{tee.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{tee.awk}
address@hidden
address@hidden file eg/prog/tee.awk
+# tee.awk --- tee in awk
+#
+# Copia lo standard input a tutti i file di output indicati.
+# Aggiunge in fondo se viene data l'opzione -a.
+#
address@hidden endfile
address@hidden
address@hidden file eg/prog/tee.awk
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised December 1995
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/tee.awk
+BEGIN @{
+ for (i = 1; i < ARGC; i++)
+ copia[i] = ARGV[i]
+
+ if (ARGV[1] == "-a") @{
+ append = 1
+ delete ARGV[1]
+ delete copia[1]
+ ARGC--
+ @}
+ if (ARGC < 2) @{
+ print "sintassi: tee [-a] file ..." > "/dev/stderr"
+ exit 1
+ @}
+ ARGV[1] = "-"
+ ARGC = 2
address@hidden
address@hidden endfile
address@hidden example
+
+La seguente regola @`e sufficiente da sola a eseguire il lavoro. Poich@'e non
@`e
+presente alcun criterio di ricerca, la regola @`e eseguita per ogni riga di
+input. Il corpo della regola si limita a stampare la riga su ogni file
+indicato nella riga di comando, e poi sullo standard output:
+
address@hidden
address@hidden file eg/prog/tee.awk
address@hidden
+ # spostare l'if fuori dal ciclo ne velocizza l'esecuzione
+ if (append)
+ for (i in copia)
+ print >> copia[i]
+ else
+ for (i in copia)
+ print > copia[i]
+ print
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
address@hidden anche possibile scrivere il ciclo address@hidden@dotless{i}}:
+
address@hidden
+for (i in copia)
+ if (append)
+ print >> copia[i]
+ else
+ print > copia[i]
address@hidden example
+
address@hidden
+Questa forma @`e address@hidden concisa, ma anche meno efficiente.
L'@samp{if} @`e
+eseguito per ogni record e per ogni file di output. Duplicando il corpo
+del ciclo, l'@samp{if} @`e eseguito solo una volta per ogni record in input.
+Se ci sono
address@hidden record in input e @var{M} file di output, il primo metodo esegue
solo
address@hidden istruzioni @samp{if}, mentre il secondo esegue
address@hidden@address@hidden istruzioni @samp{if}.
+
+Infine, la regola @code{END} fa pulizia, chiudendo tutti i file di output:
+
address@hidden
address@hidden file eg/prog/tee.awk
+END @{
+ for (i in copia)
+ close(copia[i])
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma uniq
address@hidden Stampare righe di testo non duplicate
+
address@hidden FIXME: One day, update to current POSIX version of uniq
+
address@hidden stampare righe di testo non duplicate
address@hidden address@hidden stampare, righe non duplicate di
address@hidden @command{uniq}, programma di address@hidden
address@hidden programma di address@hidden @command{uniq}
+Il programma di address@hidden @command{uniq} legge righe di dati ordinati sul
suo
+standard input, e per default rimuove righe duplicate. In altre parole,
+stampa solo righe uniche; da cui il
+nome. @command{uniq} ha diverse opzioni. La sintassi @`e la seguente:
+
address@hidden
address@hidden address@hidden address@hidden@var{n}}]] address@hidden@var{n}}]
address@hidden address@hidden
address@hidden display
+
+Le opzioni per @command{uniq} sono:
+
address@hidden @code
address@hidden -d
+Stampa solo righe ripetute (duplicate).
+
address@hidden -u
+Stampa solo righe non ripetute (uniche).
+
address@hidden -c
+Contatore righe. Quest'opzione annulla le opzioni @option{-d} e @option{-u}.
+Sia le righe ripetute che quelle non ripetute vengono contate.
+
address@hidden address@hidden
+Salta @var{n} campi prima di confrontare le righe. La definizione di campo
address@hidden simile al default di @command{awk}: caratteri non bianchi,
separati da
+sequenze di spazi e/o TAB.
+
address@hidden address@hidden
+Salta @var{n} caratteri prima di confrontare le righe. Eventuali campi
+specificati con @address@hidden sono saltati prima.
+
address@hidden @var{file_input}
+I dati sono letti dal file in input specificato sulla riga di comando, invece
+che dallo standard input.
+
address@hidden @var{file_output}
+L'output generato @`e scritto sul file di output specificato, invece che sullo
+standard output.
address@hidden table
+
+Normalmente @command{uniq} si comporta come se siano state specificate entrambe
+le opzioni @option{-d} e @option{-u}.
+
address@hidden usa la
+funzione di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e la funzione di libreria @code{join()}
+(@pxref{Funzione join}).
+
+Il programma inizia con una funzione @code{sintassi()} e poi con una breve
+spiegazione delle opzioni e del loro significato, sotto forma di commenti.
+La regola @code{BEGIN} elabora gli argomenti della riga di comando e le
+opzioni. Viene usato un artificio per poter impiegare @code{getopt()} con
+opzioni della forma @samp{-25},
+trattando quest'opzione come la lettera di opzione @samp{2} con
+l'argomento @samp{5}. Se si specificano due o address@hidden cifre
(@code{Optarg}
+sembra essere numerico), @code{Optarg} @`e concatenato con la cifra che
+costituisce l'opzione e poi al risultato @`e addizionato zero, per trasformarlo
+in un numero. Se c'@`e solo una cifra nell'opzione, @code{Optarg} non @`e
+necessario. In tal caso, @code{Optind} dev'essere decrementata, in modo che
address@hidden()} la elabori quando viene nuovamente richiamato. Questo codice
address@hidden sicuramente un po' intricato.
+
+Se non sono specificate opzioni, per default si stampano sia le righe
+ripetute che quelle non ripetute. Il file di output, se specificato, @`e
+assegnato a @code{file_output}. In precedenza, @code{file_output} @`e
+inizializzato allo standard output, @file{/dev/stdout}:
+
address@hidden @code{uniq.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{uniq.awk}
address@hidden
address@hidden file eg/prog/uniq.awk
address@hidden
+# uniq.awk --- implementa uniq in awk
+#
+# Richiede le funzioni di libreria getopt() e join()
address@hidden group
address@hidden endfile
address@hidden
address@hidden file eg/prog/uniq.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/uniq.awk
+
+function sintassi()
address@hidden
+ print("sintassi: uniq [-udc [-n]] [+n] [ in [ out ]]") > "/dev/stderr"
+ exit 1
address@hidden
+
+# -c contatore di righe. prevale su -d e -u
+# -d solo righe ripetute
+# -u solo righe non ripetute
+# -n salta n campi
+# +n salta n caratteri, salta prima eventuali campi
+
+BEGIN @{
+ contatore = 1
+ file_output = "/dev/stdout"
+ opts = "udc0:1:2:3:4:5:6:7:8:9:"
+ while ((c = getopt(ARGC, ARGV, opts)) != -1) @{
+ if (c == "u")
+ solo_non_ripetute++
+ else if (c == "d")
+ solo_ripetute++
+ else if (c == "c")
+ conta_record++
+ else if (index("0123456789", c) != 0) @{
+ # getopt() richiede argomenti per le opzioni
+ # questo consente di gestire cose come -5
+ if (Optarg ~ /^[[:digit:]]+$/)
+ contatore_file = (c Optarg) + 0
+ else @{
+ contatore_file = c + 0
+ Optind--
+ @}
+ @} else
+ sintassi()
+ @}
+
+ if (ARGV[Optind] ~ /^\+[[:digit:]]+$/) @{
+ conta_caratteri = substr(ARGV[Optind], 2) + 0
+ Optind++
+ @}
+
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
+
+ if (solo_ripetute == 0 && solo_non_ripetute == 0)
+ solo_ripetute = solo_non_ripetute = 1
+
+ if (ARGC - Optind == 2) @{
+ file_output = ARGV[ARGC - 1]
+ ARGV[ARGC - 1] = ""
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione seguente, @code{se_sono_uguali()}, confronta la riga corrente,
address@hidden, con la riga precedente, @code{ultima}. Gestisce il salto di
+campi e caratteri. Se non sono stati richiesti n@'e contatori di campo n@'e
+contatori di carattere, @code{se_sono_uguali()} restituisce uno o zero a
+seconda del risultato di un semplice confronto tra le stringhe @code{ultima}
+e @code{$0}.
+
+In caso contrario, le cose si complicano. Se devono essere saltati dei campi,
+ogni riga viene suddivisa in un vettore, usando @code{split()}
+(@pxref{Funzioni per stringhe}); i campi desiderati sono poi nuovamente uniti
in
+un'unica riga usando @code{join()}. Le righe ricongiunte vengono
+immagazzinate in @code{campi_ultima} e @code{campi_corrente}. Se non ci
+sono campi da saltare, @code{campi_ultima} e @code{campi_corrente} sono
+impostati a @code{ultima} e @code{$0}, rispettivamente. Infine, se
+occorre saltare dei caratteri, si usa @code{substr()} per eliminare i primi
address@hidden caratteri in @code{campi_ultima} e
address@hidden Le due stringhe sono poi confrontare e
address@hidden()} restituisce il risultato del confronto:
+
address@hidden
address@hidden file eg/prog/uniq.awk
+function se_sono_uguali( n, m, campi_ultima, campi_corrente,\
+vettore_ultima, vettore_corrente)
address@hidden
+ if (contatore_file == 0 && conta_caratteri == 0)
+ return (ultima == $0)
+
+ if (contatore_file > 0) @{
+ n = split(ultima, vettore_ultima)
+ m = split($0, vettore_corrente)
+ campi_ultima = join(vettore_ultima, contatore_file+1, n)
+ campi_corrente = join(vettore_corrente, contatore_file+1, m)
+ @} else @{
+ campi_ultima = ultima
+ campi_corrente = $0
+ @}
+ if (conta_caratteri) @{
+ campi_ultima = substr(campi_ultima, conta_caratteri + 1)
+ campi_corrente = substr(campi_corrente, conta_caratteri + 1)
+ @}
+
+ return (campi_ultima == campi_corrente)
address@hidden
address@hidden endfile
address@hidden example
+
+Le due regole seguenti sono il corpo del programma. La prima @`e eseguita solo
+per la prima riga dei dati. Imposta @code{ultima} al record corrente
address@hidden, in modo che le righe di testo successive abbiano qualcosa con
cui
+essere confrontate.
+
+La seconda regola fa il lavoro. La variabile @code{uguale} vale uno o zero,
+a seconda del risultato del confronto effettuato in @code{se_sono_uguali()}.
+Se @command{uniq} sta contando le righe ripetute, e le righe sono uguali,
+viene incrementata la variabile @code{contatore}.
+Altrimenti, viene stampata la riga e azzerato @code{contatore},
+perch@'e le due righe non sono uguali.
+
+Se @command{uniq} non sta contando, e se le righe sono uguali,
address@hidden @`e incrementato.
+Non viene stampato niente, perch@'e l'obiettivo @`e quello di rimuovere i
duplicati.
+Altrimenti, se @command{uniq} sta contando le righe ripetute e viene trovata
address@hidden
+di una riga, o se @command{uniq} sta contando le righe non ripetute
+e viene trovata solo una riga, questa riga viene stampata, e @code{contatore}
@`e
+azzerato.
+
+Infine, una logica simile @`e usata nella regola @code{END} per stampare
+l'ultima riga di dati in input:
+
address@hidden
address@hidden file eg/prog/uniq.awk
+NR == 1 @{
+ ultima = $0
+ next
address@hidden
+
address@hidden
+ uguale = se_sono_uguali()
+
+ if (conta_record) @{ # prevale su -d e -u
+ if (uguale)
+ contatore++
+ else @{
+ printf("%4d %s\n", contatore, ultima) > file_output
+ ultima = $0
+ contatore = 1 # reset
+ @}
+ next
+ @}
+
+ if (uguale)
+ contatore++
+ else @{
+ if ((solo_ripetute && contatore > 1) ||
+ (solo_non_ripetute && contatore == 1))
+ print ultima > file_output
+ ultima = $0
+ contatore = 1
+ @}
address@hidden
+
+END @{
+ if (conta_record)
+ printf("%4d %s\n", contatore, ultima) > file_output
+ else if ((solo_ripetute && contatore > 1) ||
+ (solo_non_ripetute && contatore == 1))
+ print ultima > file_output
+ close(file_output)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden FIXME: Include this?
address@hidden
+This program does not follow our recommended convention of naming
+global variables with a leading capital letter. Doing that would
+make the program a little easier to follow.
address@hidden ignore
+
address@hidden FOR_PRINT
+La logica per scegliere quali righe stampare rappresenta una @dfn{macchina a
+stati}, che @`e ``un dispositivo che address@hidden trovarsi in una tra un
dato numero di
+condizioni stabili, a seconda della sua condizione precedente e del valore
+corrente dei suoi input.''@footnote{Questa @`e la definizione trovata
+cercando @code{define: state machine} in Google.}
+Brian Kernighan suggerisce che
+``un approccio alternativo alle macchine a stati @`e quello di mettere l'input
+in un vettore, e poi usare gli indici. @`E quasi sempre address@hidden facile
da
+programmare e, per molti input in cui si address@hidden usare questo metodo,
+altrettanto veloce.'' Si consideri come riscrivere la logica di questo
+programma per seguite questo suggerimento.
address@hidden ifset
+
+
+
address@hidden Programma wc
address@hidden Contare cose
+
address@hidden FIXME: One day, update to current POSIX version of wc
+
address@hidden contare
address@hidden file in input, contare elementi nel
address@hidden parole, contare le
address@hidden caratteri, contare i
address@hidden righe, contare le
address@hidden @command{wc}, programma di address@hidden
address@hidden programma di address@hidden @command{wc}
+Il programma di address@hidden @command{wc} (@dfn{word count}, contatore di
parole)
+conta righe, parole, e caratteri in uno o address@hidden file in input. La sua
sintassi
address@hidden la seguente:
+
address@hidden
address@hidden address@hidden address@hidden @dots{}]
address@hidden display
+
+Se nessun file @`e specificato sulla riga di comando, @command{wc} legge il suo
+standard input. Se ci sono address@hidden file, stampa anche il contatore
totale di
+tutti i file. Le opzioni e il loro significato sono i seguenti:
+
address@hidden @code
address@hidden -l
+Conta solo le righe.
+
address@hidden -w
+Conta solo le parole.
+Una ``parola'' @`e una sequenza contigua di caratteri non bianchi, separata da
+spazi e/o TAB. Fortunatamente, questo @`e il modo normale in cui @command{awk}
+separa i campi nei suoi record in input.
+
address@hidden -c
+Conta solo i caratteri.
address@hidden table
+
+Implementare @command{wc} in @command{awk} @`e particolarmente elegante,
+perch@'e @command{awk} fa molto lavoro al posto nostro; divide le righe in
+parole (address@hidden, campi) e le conta, conta le righe (address@hidden, i
record),
+e address@hidden facilmente dire quanto @`e lunga una riga.
+
+Questo programma usa la funzione di libreria @code{getopt()}
+(@pxref{Funzione getopt})
+e le funzioni di passaggio da un file all'altro
+(@pxref{Funzione filetrans}).
+
+Questa versione ha una differenza significativa rispetto alle versioni
+tradizionali di @command{wc}: stampa sempre i contatori rispettando l'ordine
+righe, parole e caratteri. Le versioni tradizionali rilevano l'ordine in cui
+sono specificate le opzioni @option{-l}, @option{-w} e @option{-c} sulla riga
+di comando, e stampano i contatori in quell'ordine.
+
+La regola @code{BEGIN} si occupa degli argomenti. La variabile
address@hidden @`e vera se address@hidden di un file @`e presente sulla
+riga di comando:
+
address@hidden @code{wc.awk}, programma di address@hidden
address@hidden programma di address@hidden @code{wc.awk}
address@hidden
address@hidden file eg/prog/wc.awk
+# wc.awk --- conta righe, parole, caratteri
address@hidden endfile
address@hidden
address@hidden file eg/prog/wc.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/wc.awk
+
+# Opzioni:
+# -l conta solo righe
+# -w conta solo parole
+# -c conta solo caratteri
+#
+# Il default @`e di contare righe, parole, caratteri
+#
+# Richiede le funzioni di libreria getopt()
+# e il programma di libreria che gestisce
+# il passaggio da un file dati al successivo
+
+BEGIN @{
+ # consente a getopt() di stampare un messaggio se si specificano
+ # opzioni non valide. Noi le ignoriamo
+ while ((c = getopt(ARGC, ARGV, "lwc")) != -1) @{
+ if (c == "l")
+ conta_righe = 1
+ else if (c == "w")
+ conta_parole = 1
+ else if (c == "c")
+ conta_caratteri = 1
+ @}
+ for (i = 1; i < Optind; i++)
+ ARGV[i] = ""
+
+ # se nessuna opzione @`e specificata, conta tutto
+ if (! conta_righe && ! conta_parole && ! conta_caratteri)
+ conta_righe = conta_parole = conta_caratteri = 1
+
+ stampa_totale = (ARGC - i > 1)
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{a_inizio_file()} @`e semplice; si limita ad azzerare i
contatori
+di righe, parole e caratteri, e salva il valore corrente di @value{FN} in
address@hidden:
+
address@hidden
address@hidden file eg/prog/wc.awk
+function a_inizio_file(file)
address@hidden
+ righe = parole = caratteri = 0
+ nome_file = FILENAME
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{a_fine_file()} aggiunge i numeri del file corrente al totale
+di righe, parole, e caratteri. Poi stampa i numeri relativi al file appena
+letto. La funzione
address@hidden()} azzera i numeri relativi al @value{DF} seguente:
+
address@hidden
address@hidden file eg/prog/wc.awk
+function a_fine_file(file)
address@hidden
+ totale_righe += righe
+ totale_parole += parole
+ totale_caratteri += caratteri
+ if (conta_righe)
+ printf "\t%d", righe
address@hidden
+ if (conta_parole)
+ printf "\t%d", parole
address@hidden group
+ if (conta_caratteri)
+ printf "\t%d", caratteri
+ printf "\t%s\n", nome_file
address@hidden
address@hidden endfile
address@hidden example
+
+C'@`e una regola che viene eseguita per ogni riga. Aggiunge la lunghezza del
record
address@hidden uno, a @address@hidden@'e @command{gawk} gestisce le
+localizzazioni in cui un carattere address@hidden occupare address@hidden di
un byte, questo codice
+conta i caratteri, non i byte.}
+Aggiungere uno alla lunghezza del record
address@hidden necessario, perch@'e il carattere di ritorno a capo, che separa
i record
+(il valore di @code{RS}) non @`e parte del record stesso, e quindi non @`e
+incluso nella sua lunghezza. Poi, @code{righe} @`e incrementata per ogni riga
+letta, e @code{parole} @`e incrementato con il valore @code{NF}, che @`e il
+numero di ``parole'' su questa riga:
+
address@hidden
address@hidden file eg/prog/wc.awk
+# per ogni riga...
address@hidden
+ caratteri += length($0) + 1 # aggiunge un ritorno a capo
+ righe++
+ parole += NF
address@hidden
address@hidden endfile
address@hidden example
+
+Infine, la regola @code{END} si limita a stampare i totali per tutti i file:
+
address@hidden
address@hidden file eg/prog/wc.awk
+END @{
+ if (stampa_totale) @{
+ if (conta_righe)
+ printf "\t%d", totale_righe
+ if (conta_parole)
+ printf "\t%d", totale_parole
+ if (conta_caratteri)
+ printf "\t%d", totale_caratteri
+ print "\ttotale"
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programmi vari
address@hidden Un paniere di programmi @command{awk}
+
+Questa @value{SECTION} @`e un ``paniere'' che contiene vari programmi.
+Si spera che siano interessanti e divertenti.
+
address@hidden
+* Programma dupword:: Trovare parole duplicate in un documento.
+* Programma alarm:: Un programma di sveglia.
+* Programma translate:: Un programma simile al programma di
address@hidden
+ @command{tr}.
+* Programma labels:: Stampare etichette per lettere.
+* Programma utilizzo parole:: Un programma per produrre un contatore
+ dell'uso di parole in un testo.
+* Programma riordino diario:: Eliminare righe doppie da un file di
+ cronologia.
+* Programma extract :: Estrarre programmi da file sorgenti Texinfo.
+* Programma sed semplice:: Un semplice editor di flusso.
+* Programma igawk:: Un programma per fornire ad
+ @command{awk} la address@hidden di includere
+ file.
+* Programma anagram:: Trovare anagrammi da una lista di parole.
+* Programma signature:: La gente fa cose stupefacenti se ha troppo
+ tempo libero.
address@hidden menu
+
address@hidden Programma dupword
address@hidden Trovare parole duplicate in un documento
+
address@hidden parole duplicate, ricerca di
address@hidden ricerca di parole
address@hidden address@hidden ricerca in
+Un errore comune quando si scrive un testo lungo @`e quello di ripetere
+accidentalmente delle parole. Tipicamente lo si address@hidden vedere in
testi del tipo
+``questo questo programma fa quanto address@hidden'' Quando il testo @`e
pubblicato in rete, spesso
+le parole duplicate sono poste tra il termine di
address@hidden
+di
address@hidden iftex
+una riga e l'inizio di un'altra, il che rende difficile scoprirle.
address@hidden as here!
+
+Questo programma, @file{dupword.awk}, legge un file una riga alla volta
+e cerca le occorrenze adiacenti della stessa parola. Conserva anche
+l'ultima parola di ogni riga (nella variabile @code{precedente}) per
+confrontarla con la prima parola sulla riga successiva.
+
address@hidden Texinfo
+Le prime due istruzioni fanno address@hidden@dotless{i}} che la riga sia tutta
in minuscolo,
+in modo che, per esempio, ``Il'' e ``il'' risultino essere la stessa parola.
+L'istruzione successiva sostituisce i caratteri che sono non alfanumerici e
+diversi dagli
+spazi bianchi con degli spazi, in modo che neppure la punteggiatura influenzi
+i confronti.
+I caratteri sono rimpiazzati da spazi in modo che i controlli di formattazione
+non creino parole prive di senso (p.es., l'espressione Texinfo
address@hidden@@address@hidden@}} diventa @samp{codeNF}, se ci si limita a
eliminare la
+punteggiatura). Il record @`e poi
+suddiviso di nuovo in campi, producendo address@hidden@dotless{i}} solo la
lista delle parole
+presenti sulla riga, esclusi eventuali campi nulli.
+
+Se, dopo aver rimosso tutta la punteggiatura, non rimane alcun campo, il
+record corrente @`e saltato. In caso contrario, il programma esegue il ciclo
+per ogni parola, confrontandola con quella che la precede:
+
address@hidden @code{dupword.awk}, programma
address@hidden programma @code{dupword.awk}
address@hidden
address@hidden file eg/prog/dupword.awk
+# dupword.awk --- trova parole duplicate in un testo
address@hidden endfile
address@hidden
address@hidden file eg/prog/dupword.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# December 1991
+# Revised October 2000
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/dupword.awk
address@hidden
+ $0 = tolower($0)
+ gsub(/[^[:alnum:][:blank:]]/, " ");
+ $0 = $0 # divide di nuovo in campi
+ if (NF == 0)
+ next
+ if ($1 == prec)
+ printf("%s:%d: duplicato %s\n",
+ nome_file, FNR, $1)
+ for (i = 2; i <= NF; i++)
+ if ($i == $(i-1))
+ printf("%s:%d: duplicato %s\n",
+ nome_file, FNR, $i)
+ prec = $NF
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma alarm
address@hidden Un programma di sveglia
address@hidden insonnia, cura per
address@hidden Robbins, Arnold
address@hidden
address@hidden cura contro l'insonnia @`e efficace quanto una sveglia che
suona.}
address@hidden Arnold Robbins
address@hidden quotation
address@hidden Quanstrom, Erik
address@hidden
+Date: Sat, 15 Feb 2014 16:47:09 -0500
+Subject: Re: 9atom install question
+Message-ID: <address@hidden>
+From: Erik Quanstrom <address@hidden>
+To: Aharon Robbins <address@hidden>
+
+yes.
+
+- erik
+
+Aharon Robbins <address@hidden> wrote:
+
+>> sleep is for web developers.
+>
+>Can I quote you, in the gawk manual?
+>
+>Thanks,
+>
+>Arnold
address@hidden ignore
address@hidden
address@hidden sonno @`e per sviluppatori web.}
address@hidden Erik Quanstrom
address@hidden quotation
+
address@hidden tempo, sveglia, programma di esempio
address@hidden sveglia, programma di esempio
+Il seguente programma @`e un semplice programma di ``sveglia''.
+Si address@hidden specificare un'ora del giorno e un messaggio opzionale.
All'ora
+specificata, il programma stampa il messaggio sullo standard output. Inoltre,
+si address@hidden specificare il numero di volte in cui il messaggio va
ripetuto, e
+anche un intervallo di tempo (ritardo) tra ogni ripetizione.
+
+Questo programma usa la funzione @code{getlocaltime()}
address@hidden
+dalla
address@hidden iftex
address@hidden
+da
address@hidden ifnottex
address@hidden getlocaltime}.
+
+Tutto il lavoro @`e svolto nella regola @code{BEGIN}. La prima parte @`e
+il controllo degli argomenti e l'impostazione dei valori di default:
+l'intervallo prima di ripetere, il contatore, e il messaggio da stampare.
+Se l'utente ha fornito un messaggio che non contiene il carattere ASCII BEL
+(noto come carattere ``campanello'', @code{"\a"}), questo viene aggiunto al
+messaggio. (Su molti sistemi, stampare il carattere ASCII BEL genera un suono
+udibile. Quindi, quando la sveglia suona, il sistema richiama l'attenzione
+su di s@'e nel caso che l'utente non stia guardando il computer.)
+Per amor di address@hidden, questo programma usa un'istruzione @code{switch}
+(@pxref{Istruzione switch}), ma l'elaborazione potrebbe anche essere fatta
+con una serie di istruzioni @address@hidden
+Ecco il programma:
+
address@hidden @code{alarm.awk}, programma
address@hidden programma @code{alarm.awk}
address@hidden
address@hidden file eg/prog/alarm.awk
+# alarm.awk --- impostare una sveglia
+#
+# Richiede la funzione di libreria getlocaltime()
address@hidden endfile
address@hidden
address@hidden file eg/prog/alarm.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised December 2010
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/alarm.awk
+# sintassi: alarm a_che_ora [ "messaggio" [ contatore [ ritardo ] ] ]
+
+BEGIN @{
+ # Controllo iniziale address@hidden argomenti
+ sintassi1 = "sintassi: alarm a_che_ora ['messaggio' [contatore [ritardo]]]"
+ sintassi2 = sprintf("\t(%s) formato ora: ::= hh:mm", ARGV[1])
+
+ if (ARGC < 2) @{
+ print sintassi1 > "/dev/stderr"
+ print sintassi2 > "/dev/stderr"
+ exit 1
+ @}
+ switch (ARGC) @{
+ case 5:
+ ritardo = ARGV[4] + 0
+ # vai al caso seguente
+ case 4:
+ contatore = ARGV[3] + 0
+ # vai al caso seguente
+ case 3:
+ messaggio = ARGV[2]
+ break
+ default:
+ if (ARGV[1] !~ /[[:digit:]]?[[:digit:]]:[[:digit:address@hidden@}/) @{
+ print sintassi1 > "/dev/stderr"
+ print sintassi2 > "/dev/stderr"
+ exit 1
+ @}
+ break
+ @}
+
+ # imposta i valori di default per quando arriva l'ora desiderata
+ if (ritardo == 0)
+ ritardo = 180 # 3 minuti
address@hidden
+ if (contatore == 0)
+ contatore = 5
address@hidden group
+ if (messaggio == "")
+ messaggio = sprintf("\aAdesso sono le %s!\a", ARGV[1])
+ else if (index(message, "\a") == 0)
+ messaggio = "\a" messaggio "\a"
address@hidden endfile
address@hidden example
+
+La successiva @value{SECTION} di codice scompone l'ora specificata in ore e
+minuti, la converte (se @`e il caso) al formato 24-ore, e poi calcola il
+relativo numero di secondi dalla mezzanotte. Poi trasforma l'ora corrente in
+un contatore dei secondi dalla
+mezzanotte. La differenza tra i due @`e il tempo di attesa che deve passare
+prima di far scattare la sveglia:
+
address@hidden
address@hidden file eg/prog/alarm.awk
+ # scomponi ora della sveglia
+ split(ARGV[1], ore_minuti, ":")
+ ora = ore_minuti[1] + 0 # trasforma in numero
+ minuto = ore_minuti[2] + 0 # trasforma in numero
+
+ # ottiene ora corrente divisa in campi
+ getlocaltime(adesso)
+
+ # se l'ora desiderata @`e in formato 12-ore ed @`e nel pomeriggio
+ # (p.es., impostare `alarm 5:30' alle 9 del mattino
+ # vuol dire far suonare la sveglia alle 5:30 pomeridiane)
+ # aggiungere 12 all'ora richiesta
+ if (hour < 12 && adesso["hour"] > ora)
+ ora += 12
+
+ # imposta l'ora in secondi dalla mezzanotte
+ sveglia = (ora * 60 * 60) + (minuto * 60)
+
+ # ottieni l'ora corrente in secondi dalla mezzanotte
+ corrente = (now["hour"] * 60 * 60) + \
+ (now["minute"] * 60) + now["second"]
+
+ # quanto restare appisolati
+ sonno = sveglia - corrente
+ if (sonno <= 0) @{
+ print "alarm: l'ora @`e nel passato!" > "/dev/stderr"
+ exit 1
+ @}
address@hidden endfile
address@hidden example
+
address@hidden @command{sleep}, programma di address@hidden
address@hidden programma di address@hidden @command{sleep}
+Infine, il programma usa la funzione @code{system()}
+(@pxref{Funzioni di I/O})
+per chiamare il programma di address@hidden @command{sleep}. Il programma di
address@hidden
address@hidden non fa altro che aspettare per il numero di secondi
+specificato. Se il codice di ritorno restituito @`e diverso da zero, il
+programma suppone che @command{sleep} sia stato interrotto ed esce. Se
address@hidden @`e terminato con un codice di ritorno corretto, (zero), il
+programma stampa il messaggio in un ciclo, utilizzando ancora @command{sleep}
+per ritardare per il numero di secondi necessario:
+
address@hidden
address@hidden file eg/prog/alarm.awk
+ # zzzzzz..... esci se sleep @`e interrotto
+ if (system(sprintf("sleep %d", sonno)) != 0)
+ exit 1
+
+ # @`e ora di avvisare!
+ command = sprintf("sleep %d", ritardo)
+ for (i = 1; i <= contatore; i++) @{
+ print messaggio
+ # se il comando sleep @`e interrotto, esci
+ if (system(command) != 0)
+ break
+ @}
+
+ exit 0
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma translate
address@hidden Rimpiazzare o eliminare caratteri
+
address@hidden caratteri, rimpiazzare
address@hidden rimpiazzare caratteri
address@hidden @command{tr}, programma di address@hidden
address@hidden programma di address@hidden @command{tr}
+Il programma di address@hidden di sistema @command{tr} rimpiazza caratteri.
Per
+esempio, @`e spesso usato per trasformare lettere maiuscole in lettere
minuscole
+in vista di ulteriori elaborazioni:
+
address@hidden
address@hidden dei dati} | tr 'A-Z' 'a-z' | @var{elaborare dei dati} @dots{}
address@hidden example
+
address@hidden richiede due liste di address@hidden alcuni sistemi
address@hidden datati, incluso Solaris, la versione di sistema di @command{tr}
address@hidden
+richiedere che le liste siano scritte come espressioni di intervallo,
+racchiuse in parentesi quadre
+(@samp{[a-z]}) e tra apici, per evitare che la shell effettui
+espansioni di @value{FN}. Questo non @`e un miglioramento.} Quando
+si elabora l'input, il primo carattere della prima lista @`e rimpiazzato con il
+primo carattere della seconda lista, il secondo carattere della prima lista @`e
+rimpiazzato con il secondo carattere della seconda lista, e
address@hidden@dotless{i}} via. Se ci
+sono address@hidden caratteri nella lista ``da'' che in quella ``a'', l'ultimo
carattere
+della lista ``a'' @`e usato per i restanti caratteri della lista ``da''.
+
+In un lontano passato,
address@hidden early or mid-1989!
+un utente propose di aggiungere una funzione di traslitterazione a
address@hidden
address@hidden Wishing to avoid gratuitous new features,
address@hidden at least theoretically
+Il programma seguente @`e stato scritto per dimostrare che la traslitterazione
+di caratteri poteva essere fatta con una funzione definita dall'utente.
+Questo programma non @`e address@hidden@dotless{i}} completo come il programma
di address@hidden di sistema
address@hidden, ma svolge buona parte dello stesso lavoro.
+
+Il programma @command{translate} @`e stato scritto molto prima che
@command{gawk}
+fosse in grado di separare ciascun carattere di una stringa in elementi
+distinti di un vettore. Questo @`e il motivo per cui usa ripetutamente le
+funzioni predefinite @code{substr()}, @code{index()}, e @code{gsub()}
+(@pxref{Funzioni per stringhe}).
+Ci sono due funzioni. La prima, @code{traduci_stringa()},
+richiede tre argomenti:
+
address@hidden @code
address@hidden da
+Una lista di caratteri da cui traslitterare
+
address@hidden a
+Una lista di caratteri a cui traslitterare
+
address@hidden stringa
+La stringa su cui effettuare la traslitterazione
address@hidden table
+
+I vettori associativi facilitano molto la parte di traslitterazione.
address@hidden contiene i caratteri ``a'', indicizzato dai
+caratteri ``da''. Poi un semplice
+ciclo scandisce @code{da}, un carattere alla volta. Per ogni carattere
+in @code{da}, se il carattere compare in @code{stringa}
address@hidden rimpiazzato con il corrispondente carattere @code{a}.
+
+La funzione @code{traducilo()} chiama @code{traduci_stringa()}, usando
@code{$0}
+come stringa. Il programma principale imposta due variabili globali,
@code{DA} e
address@hidden, dalla riga di comando, e poi modifica @code{ARGV} in modo che
address@hidden legga dallo standard input.
+
+Infine, la regola di elaborazione si limita a chiamare @code{traducilo()}
+per ogni record:
+
address@hidden @code{translate.awk}, programma
address@hidden programma @code{translate.awk}
address@hidden
address@hidden file eg/prog/translate.awk
+# translate.awk --- fa cose simili al comando tr
address@hidden endfile
address@hidden
address@hidden file eg/prog/translate.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# August 1989
+# February 2009 - bug fix
+
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/translate.awk
+# Bug: non gestisce cose del tipo tr A-Z a-z; deve essere
+# descritto carattere per carattere.
+# Tuttavia, se `a' @`e address@hidden corto di `da',
+# l'ultimo carattere in `a' @`e usato per il resto di `da'.
+
+function traduci_stringa(da, a, stringa, lf, lt, lstringa, vettore_trad,
+ i, c, risultato)
address@hidden
+ lf = length(da)
+ lt = length(a)
+ lstringa = length(stringa)
+ for (i = 1; i <= lt; i++)
+ vettore_trad[substr(da, i, 1)] = substr(a, i, 1)
+ if (lt < lf)
+ for (; i <= lf; i++)
+ vettore_trad[substr(da, i, 1)] = substr(a, lt, 1)
+ for (i = 1; i <= lstringa; i++) @{
+ c = substr(stringa, i, 1)
+ if (c in vettore_trad)
+ c = vettore_trad[c]
+ risultato = risultato c
+ @}
+ return risultato
address@hidden
+
+function traducilo(da, a)
address@hidden
+ return $0 = traduci_stringa(da, a, $0)
address@hidden
+
+# programma principale
+BEGIN @{
address@hidden
+ if (ARGC < 3) @{
+ print "sintassi: translate da a" > "/dev/stderr"
+ exit
+ @}
address@hidden group
+ DA = ARGV[1]
+ A = ARGV[2]
+ ARGC = 2
+ ARGV[1] = "-"
address@hidden
+
address@hidden
+ traducilo(DA, A)
+ print
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden possibile effettuare la traslitterazione di caratteri in una
funzione a
+livello utente, ma non @`e detto che sia efficiente, e noi (sviluppatori
+di @command{gawk}) abbiamo iniziato a prendere in considerazione l'aggiunta di
una funzione.
+Tuttavia, poco dopo aver scritto questo programma, abbiamo saputo che Brian
+Kernighan aveva aggiunto le funzioni @code{toupper()} e @code{tolower()} alla
+sua versione di @command{awk} (@pxref{Funzioni per stringhe}). Queste
+funzioni gestiscono la maggior parte dei casi in cui serva la traslitterazione
+di caratteri, e quindi abbiamo deciso di limitarci ad aggiungere le stesse
+funzioni a @command{gawk}, e di disinteressarci del resto.
+
+Un miglioramento ovvio a questo programma sarebbe di impostare il vettore
address@hidden solo una volta, in una regola @code{BEGIN}. Tuttavia,
address@hidden
+presuppone che le liste ``da'' e ``a'' non cambino mai durante tutta
+l'esecuzione del programma.
+
+Un altro miglioramento ovvio @`e di consentire l'uso di intervalli, come
address@hidden, come consentito dal programma di address@hidden @command{tr}.
Si address@hidden
+trarre ispirazione dal codice di @file{cut.awk} (@pxref{Programma cut}).
+
+
address@hidden Programma labels
address@hidden Stampare etichette per lettere
+
address@hidden stampare etichette per lettera
address@hidden etichette per address@hidden stampare
+Ecco un programma ``del mondo-reale''@footnote{``Del mondo-reale'' @`e definito
+come ``un programma effettivamente usato per realizzare qualcosa''.}.
+Questo script legge elenchi di nomi e indirizzi, e genera etichette per
+lettera. Ogni pagina di etichette contiene 20 etichette, su due file da 10
+etichette l'una. Gli indirizzi non possono contenere address@hidden di cinque
righe di
+dati. Ogni indirizzo @`e separato dal successivo da una riga bianca.
+
+L'idea di base @`e di leggere dati per 20 etichette. Ogni riga di ogni
etichetta
address@hidden immagazzinata nel vettore @code{riga}. L'unica regola si occupa
di riempire
+il vettore @code{riga} e di stampare la pagina dopo che sono state lette 20
+etichette.
+
+La regola @code{BEGIN} si limita a impostare @code{RS} alla stringa vuota, in
+modo che @command{awk} divida un record dal successivo quando incontra una riga
+bianca.
+(@pxref{Record}).
+Inoltre imposta @code{LIMITE_LINEE} a 100,
+perch@'e 100 @`e il massimo numero di righe sulla pagina
address@hidden
+(@math{20 @cdot 5 = 100}).
address@hidden iftex
address@hidden
address@hidden
+(20 * 5 = 100).
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+(20 ⋅ 5 = 100).
address@hidden docbook
+
+Il grosso del lavoro @`e svolto nella funzione @code{stampa_pagina()}.
+Le righe che compongono le etichette sono immagazzinate sequenzialmente nel
vettore
address@hidden Ma occorre stamparle in
+orizzontale: @code{riga[1]} a fianco di @code{riga[6]}, @code{riga[2]} a
+fianco di @code{riga[7]}, e address@hidden@dotless{i}} via. Questo si
address@hidden fare utilizzando due
+cicli. Quello address@hidden esterno, controllato dalla variabile @code{i},
gestisce 10
+righe di dati, ovvero la stampa di due etichette una a fianco dell'altra.
+Il ciclo address@hidden interno
+controllato dalla variabile @code{j}, gestisce le singole righe che compongono
+ognuno degli indirizzi.
+Poich@'e @code{j} varia da 0 a 4, @samp{i+j} @`e la riga @code{j}-esima
+dell'indirizzo di sinistra, e @samp{i+j+5} @`e quella stampata alla sua destra.
+L'output @`e simile a quello mostrato qui sotto:
+
address@hidden
+riga 1 riga 6
+riga 2 riga 7
+riga 3 riga 8
+riga 4 riga 9
+riga 5 riga 10
address@hidden
address@hidden example
+
address@hidden
+La stringa di formato per @code{printf} @samp{%-41s} allinea a
+sinistra i dati, e li stampa in un campo di lunghezza fissa.
+
+Come nota finale, un'ulteriore riga bianca extra viene stampata alle righe 21 e
+61, per mantenere entro i bordi l'output sulle etichette. address@hidden
dipende dalla
+particolare marca di etichette in uso quando il programma @`e stato scritto.
+Si noti anche che ci sono due righe bianche a inizio pagina e due righe
+bianche a fine pagina.
+
+La regola @code{END} si occupa di stampare l'ultima pagina di
+etichette; @`e improbabile che il numero di indirizzi da stampare sia un
+multiplo esatto di 20:
+
address@hidden @code{labels.awk}, programma
address@hidden programma @code{labels.awk}
address@hidden
address@hidden file eg/prog/labels.awk
+# labels.awk --- stampare etichette per lettera
address@hidden endfile
address@hidden
address@hidden file eg/prog/labels.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# June 1992
+# December 2010, minor edits
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/labels.awk
+
+# Ogni etichetta @`e 5 righe di dati, qualcuna delle quali address@hidden
essere bianca.
+# I fogli con le etichetta hanno 2 righe bianche in cima alla pagina e altre 2
+# a fine pagina.
+
+BEGIN @{ RS = "" ; LIMITE_LINEE = 100 @}
+
+function stampa_pagina( i, j)
address@hidden
+ if (NUMEROrighe <= 0)
+ return
+
+ printf "\n\n" # in cima
+
+ for (i = 1; i <= NUMEROrighe; i += 10) @{
+ if (i == 21 || i == 61)
+ print ""
+ for (j = 0; j < 5; j++) @{
+ if (i + j > LIMITE_LINEE)
+ break
+ printf " %-41s %s\n", riga[i+j], riga[i+j+5]
+ @}
+ print ""
+ @}
+
+ printf "\n\n" # in fondo
+
+ delete riga
address@hidden
+
+# regola principale
address@hidden
+ if (contatore >= 20) @{
+ stampa_pagina()
+ contatore = 0
+ NUMEROrighe = 0
+ @}
+ n = split($0, a, "\n")
+ for (i = 1; i <= n; i++)
+ riga[++NUMEROrighe] = a[i]
+ for (; i <= 5; i++)
+ riga[++NUMEROrighe] = ""
+ contatore++
address@hidden
+
+END @{
+ stampa_pagina()
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma utilizzo parole
address@hidden Generare statistiche sulla frequenza d'uso delle parole
+
address@hidden parole, statistica utilizzo delle
address@hidden statistica utilizzo delle parole
+
+Quando si lavora con una grande address@hidden di testo, address@hidden essere
interessante
+sapere quanto spesso ricorrono le diverse parole. Per esempio, un autore
address@hidden
+fare un uso eccessivo di certe parole, e in questo caso si potrebbero
+trovare sinonimi da sostituire a
+parole che appaiono troppo spesso.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden spiega come
+scrivere un programma per contare le parole e presentare in un formato
+utile le informazioni relative alla loro frequenza.
+
+A prima vista, un programma come questo sembrerebbe essere sufficiente:
+
address@hidden
+# wordfreq-first-try.awk --- stampa lista frequenze utilizzo parole
+
address@hidden
+ for (i = 1; i <= NF; i++)
+ freq[$i]++
address@hidden
+
+END @{
+ for (word in freq)
+ printf "%s\t%d\n", word, freq[word]
address@hidden
address@hidden example
+
+Il programma si affida al meccanismo con cui @command{awk} divide i campi per
+default, per suddividere ogni riga in ``parole'' e usa un vettore associativo
+di nome @code{freq}, che ha per indici le singole parole, per contare il
+numero di volte che ogni parola viene usata. Nella regola @code{END}, stampa i
+contatori.
+
+Questo programma ha parecchi problemi che lo rendono praticamente inutile
+su file di testo reali:
+
address@hidden @value{BULLET}
address@hidden
+Il linguaggio @command{awk} considera i caratteri maiuscoli e minuscoli come
+distinti (non equivalenti). Quindi, ``barista'' e ``Barista'' sono
+considerate parole differenti. Questo non @`e un comportamento auspicabile,
+perch@'e le parole iniziano con la lettera maiuscola se sono a inizio frase in
+un testo normale, e un analizzatore di frequenze dovrebbe ignorare la
+distinzione maiuscolo/minuscolo.
+
address@hidden
+Le parole sono individuate usando la convenzione @command{awk} secondo cui i
+campi sono separati solo da spazi bianchi. Altri caratteri nell'input
+(tranne il ritorno a capo) non hanno alcun particolare significato per
address@hidden Questo significa che i segni di interpunzione sono visti come
+parte di una parola.
+
address@hidden
+L'output non @`e scritto in alcun ordine utile. Si @`e probabilmente
address@hidden
+interessati a sapere quali parole ricorrono address@hidden di frequente, o ad
avere
+una tabella in ordine alfabetico che mostra quante volte ricorre ogni parola.
address@hidden itemize
+
address@hidden @command{sort}, programma di address@hidden
address@hidden programma di address@hidden @command{sort}
+Il primo problema si address@hidden risolvere usando @code{tolower()} per
rimuovere la
+distinzione maiuscolo/minuscolo. Il secondo problema si address@hidden
risolvere usando
address@hidden()} per rimuovere i caratteri di interpunzione. Infine, per
+risolvere il terzo problema si address@hidden usare il programma di
address@hidden
address@hidden per elaborare l'output dello script @command{awk}. Ecco la
+nuova versione del programma:
+
address@hidden @code{wordfreq.awk}, programma
address@hidden programma @code{wordfreq.awk}
address@hidden
address@hidden file eg/prog/wordfreq.awk
+# wordfreq.awk --- stampa la lista con la frequenza delle parole
+
address@hidden
+ $0 = tolower($0) # togli maiuscolo/minuscolo
+ # togli interpunzione
+ gsub(/[^[:alnum:]_[:blank:]]/, "", $0)
+ for (i = 1; i <= NF; i++)
+ freq[$i]++
address@hidden
+
address@hidden endfile
+END @{
+ for (word in freq)
+ printf "%s\t%d\n", word, freq[word]
address@hidden
address@hidden example
+
+La @dfn{regexp} @code{/[^[:alnum:]_[:blank:]]/} si poteva scrivere come
address@hidden/[[:punct:]]/}, ma in questo modo il caratteri trattino basso
sarebbe
+stato rimosso, mentre si desidera conservarlo.
+
+Supponendo di aver salvato questo programma in un file di nome
address@hidden,
+e che i dati siano in @file{file1}, il seguente comando con @dfn{pipeline}:
+
address@hidden
+awk -f wordfreq.awk file1 | sort -k 2nr
address@hidden example
+
address@hidden
+produce una tabella delle parole che appaiono in @file{file1} in ordine
+descrescente di frequenza.
+
+Il programma @command{awk} da solo gestisce adeguatamente i dati e produce
+una tabella delle frequenza che non @`e ordinata.
+L'output di @command{awk} @`e poi messo in ordine dal programma di
address@hidden
address@hidden e stampato sullo schermo.
+
+Le opzioni passate a @command{sort}
+richiedono un ordinamento che usi come chiave il secondo campo di ogni riga
+in input (saltando il primo campo), che le chiavi di ordinamento siano
+trattate come address@hidden numeriche
+(altrimenti @samp{15} sarebbe stampato prima di @samp{5}), e che l'ordinamento
+sia fatto in ordine decrescente (inverso).
+
+Il comando @command{sort} potrebbe anche essere richiamato dall'interno del
+programma, cambiando l'azione da fare nella regola @code{END} a:
+
address@hidden
address@hidden file eg/prog/wordfreq.awk
+END @{
+ sort = "sort -k 2nr"
+ for (word in freq)
+ printf "%s\t%d\n", word, freq[word] | sort
+ close(sort)
address@hidden
address@hidden endfile
address@hidden example
+
+Questa maniera di ordinare dev'essere usata su sistemi che non hanno delle
+vere e proprie @dfn{pipe} a livello di riga di comando (o di procedura di
+comandi).
+Si veda la documentazione generale riguardo al sistema operativo per maggiori
+informazioni su come usare il programma @command{sort}.
+
address@hidden Programma riordino diario
address@hidden Eliminare duplicati da un file non ordinato
+
address@hidden righe, address@hidden rimuovere
address@hidden rimuovere righe duplicate
+Il programma @command{uniq}
+(@pxref{Programma uniq})
+rimuove righe duplicate da dati @emph{ordinati}.
+
+Si supponga, tuttavia, di dover rimuovere righe duplicate da un @value{DF},
+ma di voler conservare l'ordine in cui le righe sono state scritte. Un buon
+esempio di questo tipo potrebbe essere un file della cronologia dei comandi
+della shell. Il file della cronologia dei comandi
+mantiene copia di tutti i comandi che sono stati dati, e non @`e
+insolito ripetere un comando molte volte di fila. Occasionalmente si
+potrebbe voler compattare la cronologia togliendo le righe duplicate.
+Tuttavia sarebbe opportuno mantenere l'ordine originale dei comandi.
+
+Questo semplice programma fa questo. Usa due vettori. Il vettore @code{dati}
+ha come indice il testo di ogni riga.
+Per ogni riga, @code{dati[$0]} @`e incrementato di uno.
+Se una particolare riga non @`e stata ancora vista, @code{dati[$0]} @`e zero.
+In tal caso, il testo della riga @`e immagazzinato in @code{righe[contatore]}.
+Ogni elemento del vettore @code{righe} @`e un comando unico, e gli
+indici di @code{righe} indicano l'ordine in cui quelle righe sono state
+incontrate.
+La regola @code{END} stampa semplicemente le righe, in ordine:
+
address@hidden Rakitzis, Byron
address@hidden @code{histsort.awk}, programma
address@hidden programma @code{histsort.awk}
address@hidden
address@hidden file eg/prog/histsort.awk
+# histsort.awk --- compatta un file della cronologia dei comandi della shell
+# Grazie a Byron Rakitzis per l'idea generale
address@hidden endfile
address@hidden
address@hidden file eg/prog/histsort.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/histsort.awk
+
address@hidden
address@hidden
+ if (dati[$0]++ == 0)
+ righe[++contatore] = $0
address@hidden
address@hidden group
+
address@hidden
+END @{
+ for (i = 1; i <= contatore; i++)
+ print righe[i]
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+Questo programma address@hidden essere un punto di partenza per generare altre
+informazioni utili.
+Per esempio, usando la seguente istruzione @code{print} nella regola
address@hidden permette di sapere quante volte viene usato un certo comando:
+
address@hidden
+print dati[righe[i]], righe[i]
address@hidden example
+
address@hidden
+Questo si address@hidden fare perch@'e @code{dati[$0]} @`e incrementato ogni
volta che una
+riga @`e stata trovata.
+
address@hidden Programma extract
address@hidden Estrarre programmi da un file sorgente Texinfo
+
address@hidden Texinfo, estrarre programma da file sorgente
address@hidden estrarre programma da file sorgente Texinfo
address@hidden file Texinfo, estrarre programma da
address@hidden
+Sia questo capitolo che il precedente
+(@ref{Funzioni di libreria})
+presentano un numero elevato di programmi @command{awk}.
address@hidden ifnotinfo
address@hidden
+I nodi
address@hidden di libreria},
+e @ref{Programmi di esempio},
+sono nodi al livello address@hidden elevato, e
+contengono nodi che descrivono un numero elevato di programmi @command{awk}.
address@hidden ifinfo
+Se si vuole fare pratica con questi programmi, @`e fastidioso doverli
+digitare di nuovo manualmente. @`E per questo che abbiamo pensato a un
programma
+in grado di estrarre parti di un file in input Texinfo e metterli in file
+separati.
+
address@hidden Texinfo
+Questo @value{DOCUMENT} @`e scritto in
@uref{http://www.gnu.org/software/texinfo/, Texinfo},
+il programma di formattazione di documenti del progetto GNU.
+Un solo file sorgente Texinfo address@hidden essere usato per produrre sia la
+documentazione stampata, usando @TeX{}, sia quella online.
address@hidden
+(Texinfo @`e esaurientemente documentato nel libro
address@hidden GNU Documentation Format},
+disponibile alla Free Software Foundation,
+e anche @uref{http://www.gnu.org/software/texinfo/manual/texinfo/, online}.)
address@hidden ifnotinfo
address@hidden
+(Il linguaggio Texinfo @`e descritto esaurientemente, a partire da
address@hidden, , Texinfo, texinfo,Texinfo---The GNU Documentation Format}.)
address@hidden ifinfo
+
+Per quel che ci riguarda, @`e sufficiente sapere tre cose riguardo ai file di
+input Texinfo:
+
address@hidden @value{BULLET}
address@hidden
+Il simbolo ``chiocciola'' (@samp{@@}) @`e speciale per
+Texinfo, proprio come la barra inversa (@samp{\}) lo @`e per il linguaggio C
+o per @command{awk}. I simboli @samp{@@} sono rappresentati nel sorgente
+Texinfo come @samp{@@@@}.
+
address@hidden
+I commenti iniziano con @samp{@@c} o con @samp{@@comment}.
+Il programma di estrazione file funziona usando dei commenti speciali che
+sono posti all'inizio di una riga.
+
address@hidden
+Righe contenenti comandi @samp{@@group} e @samp{@@end group} racchiudono testi
+di esempio che non dovrebbero andare a cavallo di due pagine.
+(Sfortunatamente, @TeX{} non @`e sempre in grado di fare le cose in maniera
+esatta, e quindi va un po' aiutato).
address@hidden itemize
+
+Il programma seguente, @file{extract.awk}, legge un file sorgente Texinfo
+e fa due cose, basandosi sui commenti speciali.
+Dopo aver visto il commento @address@hidden@@c system @dots{}}},
+esegue un comando, usando il testo del comando contenuto nella
+riga di controllo e passandolo alla funzione @code{system()}
+(@pxref{Funzioni di I/O}).
+Dopo aver trovato il commento @samp{@@c file @var{nome_file}}, ogni riga
+successiva @`e spedita al file @var{nome_file}, fino a che si trova un
+commento @samp{@@c endfile}.
+Le regole in @file{extract.awk} sono soddisfatte sia quando incontrano
address@hidden@@c} che quando incontrano @samp{@@comment} e quindi la parte
address@hidden @`e opzionale.
+Le righe che contengono @samp{@@group} e @samp{@@end group} sono semplicemente
+ignorate.
address@hidden usa la funzione di libreria @code{join()}
+(@pxref{Funzione join}).
+
+I programmi di esempio nel sorgente Texinfo online di @address@hidden
+(@file{gawktexi.in}) sono stati tutti inseriti tra righe @samp{file} e righe
address@hidden La distribuzione di @command{gawk} usa una copia di
address@hidden per estrarre i programmi di esempio e per installarne
+molti in una particolare directory dove @command{gawk} li address@hidden
trovare.
+Il file Texinfo ha un aspetto simile a questo:
+
address@hidden
address@hidden
+Questo programma ha una regola @@address@hidden@}
+che stampa un messaggio scherzoso:
+
+@@example
+@@c file esempi/messages.awk
+BEGIN @@@{ print "Non v'allarmate!" @@@}
+@@c endfile
+@@end example
+
+Stampa anche qualche avviso conclusivo:
+
+@@example
+@@c file esempi/messages.awk
+END @@@{ print "Evitate sempre gli archeologi annoiati!" @@@}
+@@c endfile
+@@end example
address@hidden
address@hidden example
+
+Il programma @file{extract.awk} inizia con l'impostare @code{IGNORECASE} a
+uno, in modo che un miscuglio di lettere maiuscole e minuscole nelle direttive
+non faccia differenza.
+
+La prima regola gestisce le chiamate a @code{system()}, controllando che sia
+stato fornito un comando (@code{NF} dev'essere almeno tre) e controllando
+anche che il comando termini con un codice di ritorno uguale a zero, che sta
+a significare che tutto @`e andato bene:
+
address@hidden @code{extract.awk}, programma
address@hidden programma @code{extract.awk}
address@hidden
address@hidden file eg/prog/extract.awk
+# extract.awk --- estrae file ed esegue programmi dal file Texinfo
address@hidden endfile
address@hidden
address@hidden file eg/prog/extract.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised September 2000
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/extract.awk
+
+BEGIN @{ IGNORECASE = 1 @}
+
+/^@@c(omment)?[ \t]+system/ @{
+ if (NF < 3) @{
+ e = ("extract: " FILENAME ":" FNR)
+ e = (e ": riga `system' con formato errato")
+ print e > "/dev/stderr"
+ next
+ @}
+ $1 = ""
+ $2 = ""
+ stat = system($0)
+ if (stat != 0) @{
+ e = ("extract: " FILENAME ":" FNR)
+ e = (e ": attenzione: system ha restituito " stat)
+ print e > "/dev/stderr"
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+La variabile @code{e} @`e stata usata per far address@hidden@dotless{i}} che
la regola
+sia agevolemente contenuta nella @value{PAGE}.
+
+La seconda regola gestisce il trasferimento di dati in un file. Verifica che
+nella direttiva sia stato fornito un @value{FN}.
+Se il nome del file non @`e quello del file corrente, il file
+corrente viene chiuso. Mantenere aperto il file corrente finch@'e non si trova
+un nuovo nome file permette di usare la ridirezione @samp{>} per stampare i
+contenuti nel file, semplificando la gestione dei file aperti.
+
+Il ciclo @code{for} esegue il lavoro. Legge le righe usando @code{getline}
+(@pxref{Getline}).
+Se si raggiunge una fine-file inattesa, viene chiamata la funzione
address@hidden@w{fine_file_inattesa()}}. Se la riga @`e una riga ``endfile'',
+il ciclo viene abbandonato.
+Se la riga inizia con @samp{@@group} o @samp{@@end group}, la riga viene
+ignorata, e si passa a quella seguente. Allo stesso modo, eventuali commenti
+all'interno degli esempi vengono ignorati.
+
+Il grosso del lavoro @`e nelle poche righe che seguono. Se la riga non ha
+simboli @samp{@@}, il programma la address@hidden
+stampare address@hidden@dotless{i}} com'@`e. Altrimenti, ogni @samp{@@} a
inizio parola dev'essere
+eliminato.
+Per rimuovere i simboli @samp{@@}, la riga viene divisa nei singoli elementi
+del vettore @code{a}, usando la funzione @code{split()}
+(@pxref{Funzioni per stringhe}).
+Il simbolo @samp{@@} @`e usato come carattere di separazione.
+Ogni elemento del vettore @code{a} che risulti vuoto indica due caratteri
address@hidden@@} contigui nella riga originale. Per ogni due elementi vuoti
+(@samp{@@@@} nel file originale), va inserito un solo simbolo @samp{@@} nel
+file in output.
+
+Una volta terminato di esaminare il vettore, viene chiamata la funzione
@code{join()}
+specificando nella chiamata il valore di @code{SUBSEP}
+(@pxref{Vettori multidimensionali}),
+per riunire nuovamente i pezzi in una riga sola.
+La riga @`e poi stampata nel file di output:
+
address@hidden
address@hidden file eg/prog/extract.awk
+/^@@c(omment)?[ \t]+file/ @{
+ if (NF != 3) @{
+ e = ("extract: " FILENAME ":" FNR ": riga `file' con formato errato")
+ print e > "/dev/stderr"
+ next
+ @}
+ if ($3 != file_corrente) @{
+ if (file_corrente != "")
+ close(file_corrente)
+ file_corrente = $3
+ @}
+
+ for (;;) @{
+ if ((getline riga) <= 0)
+ fine_file_inattesa()
+ if (riga ~ /^@@c(omment)?[ \t]+endfile/)
+ break
+ else if (riga ~ /^@@(end[ \t]+)?group/)
+ continue
+ else if (riga ~ /^@@c(omment+)?[ \t]+/)
+ continue
+ if (index(riga, "@@") == 0) @{
+ print riga > file_corrente
+ continue
+ @}
+ n = split(riga, a, "@@")
+ # if a[1] == "", vuol dire riga che inizia per @@,
+ # non salvare un @@
+ for (i = 2; i <= n; i++) @{
+ if (a[i] == "") @{ # era un @@@@
+ a[i] = "@@"
+ if (a[i+1] == "")
+ i++
+ @}
+ @}
+ print join(a, 1, n, SUBSEP) > file_corrente
+ @}
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden importante notare l'uso della ridirezione @samp{>} .
+L'output fatto usando @samp{>} apre il file solo la prima volta; il file resta
+poi aperto, e ogni scrittura successiva @`e aggiunta in fondo al file.
+(@pxref{Ridirezione}).
address@hidden rende possibile mischiare testo del programm e commenti
esplicativi
+(come @`e stato fatto qui) nello stesso file sorgente, senza nessun problema.
+Il file viene chiuso solo quando viene trovato un nuovo nome di
address@hidden oppure alla fine del file in input.
+
+Per finire, la funzione @address@hidden()}} stampa un
+appropriato messaggio di errore ed esce.
+La regola @code{END} gestisce la pulizia finale, chiudendo il file aperto:
+
address@hidden
address@hidden file eg/prog/extract.awk
address@hidden
+function fine_file_inattesa()
address@hidden
+ printf("extract: %s:%d: fine-file inattesa, o errore\n",
+ FILENAME, FNR) > "/dev/stderr"
+ exit 1
address@hidden
address@hidden group
+
+END @{
+ if (file_corrente)
+ close(file_corrente)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden Programma sed semplice
address@hidden Un semplice editor di flusso
+
address@hidden @command{sed}, programma di address@hidden
address@hidden programma di address@hidden @command{sed}
address@hidden editori di flusso
address@hidden flusso, editori di
+Il programma di address@hidden @command{sed} @`e un @dfn{editore di flusso},
+ovvero un programma che legge un flusso di dati, lo modifica, e scrive il file
address@hidden@dotless{i}} modificato.
address@hidden spesso usato per fare modifiche generalizzate a un grosso file,
o a un
+flusso di dati generato da una @dfn{pipeline} di comandi.
+Sebbene @command{sed} sia un programma piuttosto complesso di suo, l'uso che
+se ne fa solitamente @`e di effettuare delle sostituzioni globali attraverso
+una @dfn{pipeline}:
+
address@hidden
address@hidden < dati.originali | sed 's/vecchio/nuovo/g' | @var{comando2} >
risultato
address@hidden example
+
+Qui, @samp{s/vecchio/nuovo/g} chiede a @command{sed} di ricercare la
address@hidden @samp{vecchio} in ogni riga di input e di sostituirla
+dappertutto con il testo @samp{nuovo} (address@hidden, in tutte le occorrenze
di
+ciascuna riga). Questo @`e simile a quello che fa la funzione di @command{awk}
address@hidden()}
+(@pxref{Funzioni per stringhe}).
+
+Il programma seguente, @file{awksed.awk}, accetta almeno due argomenti dalla
+riga di comando: l'espressione da ricercare e il testo con cui rimpiazzarla.
+Ogni ulteriore argomento @`e considerato
+come un nome di @value{DF} da elaborare. Se non ne viene fornito alcuno, si
+usa lo standard input:
+
address@hidden Brennan, Michael
address@hidden @command{awksed.awk}, programma
address@hidden programma @command{awksed.awk}
address@hidden @cindex simple stream editor
address@hidden @cindex stream editor, simple
address@hidden
address@hidden file eg/prog/awksed.awk
+# awksed.awk --- fa s/pippo/pluto/g usando solo print
+# Ringraziamenti a Michael Brennan per l'idea
address@hidden endfile
address@hidden
address@hidden file eg/prog/awksed.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# August 1995
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/awksed.awk
+
+function sintassi()
address@hidden
+ print "sintassi: awksed espressione rimpiazzo [file...]" > "/dev/stderr"
+ exit 1
address@hidden
+
+BEGIN @{
+ # valida argomenti
+ if (ARGC < 3)
+ sintassi()
+
+ RS = ARGV[1]
+ ORS = ARGV[2]
+
+ # non usare argomenti come nomi di file
+ ARGV[1] = ARGV[2] = ""
address@hidden
+
address@hidden
+# guarda, mamma, senza mani!
address@hidden
+ if (RT == "")
+ printf "%s", $0
+ else
+ print
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+Il programma fa assegnamento sulla address@hidden di @command{gawk} di avere
come
address@hidden una @dfn{regexp},
+e anche sul fatto che @code{RT} viene impostato al testo che effettivamente
+delimita il record (@pxref{Record}).
+
+L'idea @`e di usare @code{RS} come espressione da ricercare. @command{gawk}
+automaticamente imposta @code{$0} al testo che compare tra due corrispondenze
+all'espressione di ricerca.
+Questo @`e appunto il testo che vogliamo conservare inalterato. Quindi,
+impostando @code{ORS} al testo che si vuole sostituire, una semplice
+istruzione @code{print} scrive il testo che si vuole mantenere, seguito dal
+testo che si vuole invece sostituire.
+
+C'@`e un problema in questo schema, ossia cosa fare se l'ultimo record
+non termina con un testo che corrisponde a @code{RS}. Usando un'istruzione
address@hidden incondizionatamente stampa il testo da sostituire, il che non
address@hidden corretto.
+Tuttavia, se il file non termina con del testo che corrisponde a @code{RS},
address@hidden @`e impostata alla stringa nulla. In tal caso, si
address@hidden stampare
address@hidden usando @code{printf}
+(@pxref{Printf}).
+
+La regola @code{BEGIN} gestisce la preparazione, controllando che ci sia
+il numero giusto di argomenti e chiamando @code{sintassi()} se c'@`e un
problema.
+Poi imposta @code{RS} e @code{ORS} dagli argomenti della riga di comando e
+imposta @code{ARGV[1]} e @code{ARGV[2]} alla stringa nulla, per impedire che
+vengano considerati dei @value{FNS}
+(@pxref{ARGC e ARGV}).
+
+La funzione @code{sintassi()} stampa un messaggio di errore ed esce.
+Per finire, l'unica regola gestisce lo schema di stampa delineato
address@hidden sopra,
+usando @code{print} o @code{printf} come richiesto, a seconda del valore di
address@hidden
+
address@hidden Programma igawk
address@hidden Una maniera facile per usare funzioni di libreria
+
address@hidden libreria di funzioni @command{awk}, programma di esempio per
usare
address@hidden funzioni, librerie di, programma di esempio per usare
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden file}, abbiamo visto come @command{gawk} preveda la
address@hidden di includere file. Tuttavia, questa @`e un'estensione
@command{gawk}.
+Questa @value{SECTION} evidenzia l'address@hidden di rendere l'inclusione di
+file disponibile per @command{awk} standard, e mostra come farlo utilizzando
+una combinazione di programmazione di shell e di @command{awk}.
+
+Usare funzioni di libreria in @command{awk} address@hidden presentare molti
vantaggi.
+Incoraggia il riutilizzo di codice e la scrittura di funzioni di tipo
+generale. I programmi sono address@hidden snelli e quindi address@hidden
comprensibili.
+Tuttavia, usare funzioni di libreria @`e facile solo in fase di scrittura di
+programmi @command{awk}; @`e invece complicato al momento di eseguirli,
+rendendo necessario specificare molte opzioni @option{-f}. Se @command{gawk}
+non @`e disponibile, non lo sono neppure la variabile d'ambiente @env{AWKPATH}
e
+la address@hidden di conservare funzioni @command{awk} in una directory di
+libreria (@pxref{Opzioni}).
+Sarebbe bello poter scrivere programmi nel modo seguente:
+
address@hidden
+# funzioni di libreria
+@@include getopt.awk
+@@include join.awk
address@hidden
+
+# programma principale
+BEGIN @{
+ while ((c = getopt(ARGC, ARGV, "a:b:cde")) != -1)
+ @dots{}
+ @dots{}
address@hidden
address@hidden example
+
+Il programma seguente, @file{igawk.sh}, fornisce questo servizio.
+Simula la ricerca da parte di @command{gawk} della variabile d'ambiente
address@hidden e permette anche delle inclusioni @dfn{nidificate}
(address@hidden,
+un file che @`e stato incluso tramite
address@hidden@@include} address@hidden contenere ulteriori istruzioni
@code{@@include}).
address@hidden tenta di includere ogni file una volta sola, in modo che delle
+inclusioni nidificate non contengano accidentalmente una funzione di libreria
address@hidden di una volta.
+
address@hidden dovrebbe comportarsi esternamente proprio come @command{gawk}.
+Questo vuol dire che dovrebbe accettare sulla riga di comando tutti gli
+argomenti di @command{gawk}, compresa
+la address@hidden di specificare address@hidden file
+sorgenti tramite l'opzione @option{-f}
+e la address@hidden di mescolare istruzioni da riga di comando e file di
sorgenti di
+libreria.
+
+Il programma @`e scritto usando il linguaggio della Shell POSIX
+(@command{sh})address@hidden spiegazione dettagliata del linguaggio della
address@hidden non rientra negli intenti di questo libro. Qualche spiegazione
+sommaria viene fornita, ma se si desidera una comprensione address@hidden
dettagliata, si
+dovrebbe consultare un buon libro sulla programmazione della shell.}
+Il funzionamento @`e il seguente:
+
address@hidden
address@hidden
+Esegue un ciclo attraverso gli argomenti, salvando tutto address@hidden che
non si presenta come
+codice sorgente @command{awk}, per quando il programma espanso address@hidden
eseguito.
+
address@hidden
+Per ogni argomento che rappresenta del codice @command{awk}, mette l'argomento
+in una variabile di shell che address@hidden espansa. Ci sono due casi:
+
address@hidden a
address@hidden
+Un testo letterale, fornito con l'opzione @option{-e} o @option{--source}.
+Questo testo viene aggiunto direttamente in fondo.
+
address@hidden
address@hidden sorgenti, forniti con l'opzione @option{-f}. Usiamo il
trucchetto
+di aggiungere @samp{@@include @var{nome_file}} in fondo ai contenuti della
+variabile di shell. Poich@'e il programma di inclusione dei file funziona
+allo stesso modo in cui funziona @command{gawk}, ne risulta che il file viene
+incluso nel programma al punto giusto.
address@hidden enumerate
+
address@hidden
+Esegue un programma (naturalmente @command{awk}) sui contenuti della variabile
+di shell per espandere le istruzioni
address@hidden@@include}. Il programma espanso @`e messo in una seconda
variabile di
+shell.
+
address@hidden
+Esegue il programma espanso richiamando @command{gawk} e tutti gli altri
+argomenti originalmente forniti dall'utente sulla riga di comando (come p.es.
+dei nomi di @value{DF}).
address@hidden enumerate
+
+Questo programma usa variabili di shell in address@hidden: per immagazzinare
+argomenti della riga di comando e
+il testo del programma @command{awk} che address@hidden il programma
dell'utente,
+per il programma originale dell'utente e per il programma espanso. Questo
+modo di procedere risolve potenziali
+problemi che potrebbero presentarsi se si usassero invece dei file temporanei,
+ma rende lo script un po' address@hidden complicato.
+
+La parte iniziale del programma attiva il tracciamento della shell se il primo
+argomento @`e @samp{debug}.
+
+La parte successiva esegue un ciclo che esamina ogni argomento della riga di
+comando.
+Ci sono parecchi casi da esaminare:
+
address@hidden @asis for docbook
address@hidden @asis
address@hidden @option{--}
+Quest'opzione termina gli argomenti per @command{igawk}. Tutto quel che segue
+dovrebbe essere passato al programma @command{awk} dell'utente senza essere
+preso in considerazione.
+
address@hidden @option{-W}
+Questo indica che l'opzione successiva @`e propria di @command{gawk}. Per
+facilitare l'elaborazione degli argomenti, l'opzione @option{-W} @`e aggiunta
+davanti agli argomenti rimanenti, e il
+ciclo continua. (Questo @`e un trucco di programmazione della @command{sh}.
+Non @`e il caso di preoccuparsene se non si ha address@hidden con il comando
address@hidden)
+
address@hidden @option{-v}, @option{-F}
+Queste opzioni sono conservate e lasciate da gestire a @command{gawk}.
+
address@hidden @option{-f}, @option{--file}, @option{--file=}, @option{-Wfile=}
+Il @value{FN} @`e aggiunto alla variabile di shell @code{programma}, insieme
+a un'istruzione @code{@@include}.
+Il programma di address@hidden @command{expr} @`e usato per eliminare la parte
+iniziale dell'argomento (p.es., @samp{--file=}).
+(La sintassi tipica di @command{sh} richiederebbe di usare il comando
address@hidden e il programma di address@hidden @command{sed} per far questo.
+Sfortunatamente, alcune versioni di @command{echo} valutano le sequenze
+di protezione contenute nei loro argomenti, e questo potrebbe finire per
+alterare il testo del programma.
+L'uso di @command{expr} evita questo problema.)
+
address@hidden @option{--source}, @option{--source=}, @option{-Wsource=}
+Il testo sorgente @`e aggiunto in fondo a @code{programma}.
+
address@hidden @option{--version}, @option{-Wversion}
address@hidden stampa il proprio numero di versione, esegue
address@hidden --version} per ottenere l'informazione relativa alla versione di
address@hidden, ed esce.
address@hidden table
+
+Se nessuno degli argomenti
address@hidden, @option{--file}, @option{-Wfile}, @option{--source},
+o @option{-Wsource} @`e stato fornito, il primo argomento che non @`e
un'opzione
+dovrebbe essere il programma @command{awk}. Se non ci sono argomenti rimasti
+sulla riga di comando, @command{igawk} stampa un messaggio di errore ed esce.
+Altrimenti, il primo argomento @`e aggiunto in fondo a @code{programma}.
+In qualsiasi caso, dopo che gli argomenti sono stati elaborati,
+la variabile di shell
address@hidden contiene il testo completo del programma originale
address@hidden
+
+Il programma @`e il seguente:
+
address@hidden @code{igawk.sh}, programma
address@hidden programma @code{igawk.sh}
address@hidden
address@hidden file eg/prog/igawk.sh
+#! /bin/sh
+# igawk --- come gawk ma abilita l'uso di @@include
address@hidden endfile
address@hidden
address@hidden file eg/prog/igawk.sh
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# July 1993
+# December 2010, minor edits
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/igawk.sh
+
+if [ "$1" = debug ]
+then
+ set -x
+ shift
+fi
+
+# Un ritorno a capo letterale,
+# per formattare correttamente il testo del programma
+n='
+'
+
+# Inizializza delle variabili alla stringa nulla
+programma=
+opts=
+
+while [ $# -ne 0 ] # ciclo sugli argomenti
+do
+ case $1 in
+ --) shift
+ break ;;
+
+ -W) shift
+ # Il costrutto address@hidden'messaggio qui'@} stampa un
+ # messaggio diagnostico se $x @`e la stringa nulla
+ set -- -W"address@hidden@@?'manca operando'@}"
+ continue ;;
+
+ -[vF]) opts="$opts $1 'address@hidden'manca operando'@}'"
+ shift ;;
+
+ -[vF]*) opts="$opts '$1'" ;;
+
+ -f) programma="$programma$n@@include address@hidden'manca operando'@}"
+ shift ;;
+
+ -f*) f=$(expr "$1" : '-f\(.*\)')
+ programma="$programma$n@@include $f" ;;
+
+ -[W-]file=*)
+ f=$(expr "$1" : '-.file=\(.*\)')
+ programma="$programma$n@@include $f" ;;
+
+ -[W-]file)
+ programma="$programma$n@@include address@hidden'manca operando'@}"
+ shift ;;
+
+ -[W-]source=*)
+ t=$(expr "$1" : '-.source=\(.*\)')
+ programma="$programma$n$t" ;;
+
+ -[W-]source)
+ programma="address@hidden'manca operando'@}"
+ shift ;;
+
+ -[W-]version)
+ echo igawk: version 3.0 1>&2
+ gawk --version
+ exit 0 ;;
+
+ -[W-]*) opts="$opts '$1'" ;;
+
+ *) break ;;
+ esac
+ shift
+done
+
+if [ -z "$programma" ]
+then
+ address@hidden'manca programma'@}
+ shift
+fi
+
+# A questo punto, `programma' contiene il programma.
address@hidden endfile
address@hidden example
+
+Il programma @command{awk} che elabora le direttive @code{@@include}
address@hidden immagazzinato nella variabile di shell @code{progr_che_espande}.
address@hidden serve
+a mantenere leggibile lo script. Questo programma @command{awk} legge
+tutto il programma dell'utente, una riga per volta, usando @code{getline}
+(@pxref{Getline}). I @value{FNS} in input e le istruzioni @code{@@include}
+sono gestiti usando una pila. Man mano che viene trovata una @code{@@include},
+il valore corrente di @value{FN} @`e
+``spinto'' sulla pila e il file menzionato nella direttiva @code{@@include}
+diventa il @value{FN} corrente. Man mano che un file @`e finito,
+la pila viene ``disfatta'', e il precedente file in input diventa nuovamente il
+file in input corrente. Il processo viene iniziato ponendo il file originale
+come primo file sulla pila.
+
+La funzione @code{percorso()} trova qual @`e il percorso completo di un file.
+Simula il comportamento di @command{gawk} quando utilizza la variabile
+d'ambiente @env{AWKPATH}
+(@pxref{AWKPATH (Variabile)}).
+Se un @value{FN} contiene una @samp{/}, non viene effettuata la ricerca del
+percorso. Analogamente, se il
address@hidden @`e @code{"-"}, viene usato senza alcuna modifica. Altrimenti,
+il @value{FN} @`e concatenato col nome di ogni directory nella lista dei
+percorsi, e vien fatto un tentativo per aprire il @value{FN}
address@hidden@dotless{i}} generato.
+Il solo modo di controllare se un file @`e leggibile da @command{awk} @`e di
+andare avanti e tentare di leggerlo con
address@hidden; questo @`e quel che
address@hidden()} address@hidden alcune versioni molto datate di
address@hidden, il test @samp{getline da_buttare < t} address@hidden ripetersi
in un ciclo
+infinito se il file esiste ma @`e vuoto.}
+Se il file address@hidden essere letto, viene chiuso e viene restituito il
valore di
address@hidden:
+
address@hidden
+An alternative way to test for the file's existence would be to call
address@hidden("test -r " t)}, which uses the @command{test} utility to
+see if the file exists and is readable. The disadvantage to this method
+is that it requires creating an extra process and can thus be slightly
+slower.
address@hidden ignore
+
address@hidden
address@hidden file eg/prog/igawk.sh
+progr_che_espande='
+
+function percorso(file, i, t, da_buttare)
address@hidden
+ if (index(file, "/") != 0)
+ return file
+
+ if (file == "-")
+ return file
+
+ for (i = 1; i <= n_dir; i++) @{
+ t = (lista_percorsi[i] "/" file)
address@hidden
+ if ((getline da_buttare < t) > 0) @{
+ # found it
+ close(t)
+ return t
+ @}
address@hidden group
+ @}
+ return ""
address@hidden
address@hidden endfile
address@hidden example
+
+Il programma principale @`e contenuto all'interno di una regola @code{BEGIN}.
+La prima cosa che fa @`e di impostare il vettore @code{lista_percorsi} usato
+dalla funzione @code{percorso()}. Dopo aver diviso la lista usando come
+delimitatore @samp{:}, gli elementi nulli sono sostituiti da @code{"."},
+che rappresenta la directory corrente:
+
address@hidden
address@hidden file eg/prog/igawk.sh
+BEGIN @{
+ percorsi = ENVIRON["AWKPATH"]
+ n_dir = split(percorsi, lista_percorsi, ":")
+ for (i = 1; i <= n_dir; i++) @{
+ if (lista_percorsi[i] == "")
+ lista_percorsi[i] = "."
+ @}
address@hidden endfile
address@hidden example
+
+La pila @`e inizializzata con @code{ARGV[1]}, che address@hidden
@code{"/dev/stdin"}.
+Il ciclo principale viene subito dopo. Le righe in input sono lette una dopo
+l'altra. Righe che non iniziano con @code{@@include} sono stampate
address@hidden@dotless{i}} come
+sono.
+Se la riga inizia con @code{@@include}, il @value{FN} @`e in @code{$2}.
+La funzione @code{percorso()} @`e chiamata per generare il percorso completo.
+Se questo non riesce, il programma stampa un messaggio di errore e continua.
+
+Subito dopo occorre controllare se il file sia address@hidden stato incluso.
Il vettore
address@hidden @`e indicizzato dal nome completo di ogni @value{FN} incluso
+e tiene traccia per noi di questa informazione. Se un file viene visto
address@hidden
+volte, viene stampato un messaggio di avvertimento. Altrimenti il nuovo
address@hidden @`e aggiunto alla pila e l'elaborazione continua.
+
+Infine, quando @code{getline} giunge alla fine del file in input, il file
+viene chiuso, e la pila viene elaborata. Quando @code{indice_pila} @`e minore
+di zero, il programma @`e terminato:
+
address@hidden
address@hidden file eg/prog/igawk.sh
+ indice_pila = 0
+ input[indice_pila] = ARGV[1] # ARGV[1] @`e il primo file
+
+ for (; indice_pila >= 0; indice_pila--) @{
+ while ((getline < input[indice_pila]) > 0) @{
+ if (tolower($1) != "@@include") @{
+ print
+ continue
+ @}
+ cammino = percorso($2)
address@hidden
+ if (cammino == "") @{
+ printf("igawk: %s:%d: non riesco a trovare %s\n",
+ input[indice_pila], FNR, $2) > "/dev/stderr"
+ continue
+ @}
address@hidden group
+ if (! (cammino in gia_fatto)) @{
+ gia_fatto[cammino] = input[indice_pila]
+ input[++indice_pila] = cammino # aggiungilo alla pila
+ @} else
+ print $2, "incluso in", input[indice_pila],
+ "era address@hidden incluso in",
+ gia_fatto[cammino] > "/dev/stderr"
+ @}
+ close(input[indice_pila])
+ @}
address@hidden' # l'apice chiude la variabile `progr_che_espande'
+
+programma_elaborato=$(gawk -- "$progr_che_espande" /dev/stdin << EOF
+$programma
+EOF
+)
address@hidden endfile
address@hidden example
+
+Il costrutto di shell @address@hidden << @var{marcatore}} @`e chiamato
address@hidden document} (@dfn{documento sul posto}). Ogni riga presente nello
+script di shell fino al @var{marcatore} @`e passato in input a @var{comando}.
+La shell elabora i contenuti dell'@dfn{here document} sostituendo, dove serve,
+variabili e comandi (ed eventualmente altre cose, a seconda della shell
+in uso).
+
+Il costrutto di shell @samp{$(@dots{})} @`e chiamato @dfn{sostituzione di
comando}.
+L'output del comando posto all'interno delle parentesi @`e sostituito
+nella riga di comando.
+Poich@'e il risultato @`e usato in un assegnamento di variabile,
+viene salvato come un'unica stringa di caratteri, anche se il risultato
+contiene degli spazi bianchi.
+
+Il programma espanso @`e salvato nella variabile @code{programma_elaborato}.
+Il tutto avviene secondo le fasi seguenti:
+
address@hidden
address@hidden
+Si esegue @command{gawk} con il programma che gestisce le @code{@@include}
+(il valore della variabile di shell
address@hidden) leggendo lo standard input.
+
address@hidden
+Lo standard input contiene il programma dell'utente,
+nella variabile di shell @code{programma}.
+L'input @`e passato a @command{gawk} tramite un @dfn{here document}.
+
address@hidden
+I risultati di questo processo sono salvati nella variabile di shell
address@hidden usando la sostituzione di comando.
address@hidden enumerate
+
+L'ultima fase @`e la chiamata a @command{gawk} con il programma espanso,
+insieme alle opzioni originali e agli argomenti della riga di comando che
+l'utente aveva fornito:
+
address@hidden
address@hidden file eg/prog/igawk.sh
+eval gawk $opts -- '"$programma_elaborato"' '"$@@"'
address@hidden endfile
address@hidden example
+
+Il comando @command{eval} @`e una struttura della shell che riesegue
+l'elaborazione dei parametri della riga di comando. Gli apici proteggono le
+parti restanti.
+
+Questa versione di @command{igawk} @`e la quinta versione di questo programma.
+Ci sono quattro semplificazioni migliorative:
+
address@hidden @value{BULLET}
address@hidden
+L'uso di @code{@@include} anche per i file specificati tramite l'opzione
address@hidden consente di semplificare di molto la preparazione del programma
+iniziale @command{awk}; tutta l'elaborazione delle istruzioni @code{@@include}
address@hidden essere svolta in una sola volta.
+
address@hidden
+Non tentare di salvare la riga letta tramite @code{getline} all'interno della
+funzione @code{percorso()} quando si controlla se il file @`e accessibile
+per il successivo uso nel programma principale semplifica notevolmente
+le cose.
+
address@hidden
+Usare un ciclo di @code{getline} nella regola @code{BEGIN} rende possibile
+fare tutto in un solo posto. Non @`e necessario programmare un ulteriore ciclo
+per elaborare le istruzioni @code{@@include} nidificate.
+
address@hidden
+Invece di salvare il programma espanso in un file temporaneo, assegnarlo a
+una variabile di shell evita alcuni potenziali problemi di sicurezza.
address@hidden address@hidden ha lo svantaggio di basare lo script su
address@hidden del
+linguaggio @command{sh}, il che rende address@hidden difficile la comprensione
a chi non
+abbia address@hidden con il comando
address@hidden
address@hidden itemize
+
+Inoltre, questo programma dimostra come spesso valga la pena di utilizzare
+insieme la programmazione della @command{sh} e quella di @command{awk}.
+Solitamente, si address@hidden fare parecchio senza dover ricorrere alla
programmazione
+di basso livello in C o C++, ed @`e spesso address@hidden facile fare certi
tipi di
+manipolazioni di stringhe e argomenti usando la shell, piuttosto che
address@hidden
+
+Infine, @command{igawk} dimostra che non @`e sempre necessario aggiungere nuove
address@hidden a un programma; queste possono spesso essere aggiunte in
address@hidden@command{gawk}
address@hidden in grado di elaborare istruzioni @code{@@include} al suo stesso
interno, per
+permettere l'uso di programmi @command{awk} come script Web CGI.}
+
+
address@hidden Programma anagram
address@hidden Trovare anagrammi da una lista di parole
+
address@hidden anagrammi, trovare
+Un'interessante sfida per il programmatore @`e quella di cercare
@dfn{anagrammi} in una
+lista di parole (come
address@hidden/usr/share/dict/italian} presente in molti sistemi GNU/Linux).
+Una parola @`e un anagramma di un'altra se entrambe le parole contengono
+le stesse lettere
+(p.es., ``branzino'' e ``bronzina'').
+
+La Colonna 2, Problema C, della seconda edizione del libro di Jon Bentley
address@hidden Pearls}, presenta un algoritmo elegante.
+L'idea @`e di assegnare a parole che sono anagrammi l'una dell'altra una
+firma comune, e poi di ordinare tutte le parole in base alla loro
+firma e di stamparle.
+Il Dr.@: Bentley fa notare che prendere tutte le lettere di ogni parola ed
+elencarle in ordine alfabetico produce queste firme comuni.
+
+Il programma seguente usa vettori di vettori per riunire
+parole con la stessa firma, e l'ordinamento di vettori per stampare le
+parole trovate in ordine alfabetico:
+
address@hidden @code{anagram.awk}, programma
address@hidden programma @code{anagram.awk}
address@hidden
address@hidden file eg/prog/anagram.awk
+# anagram.awk --- Un'implementazione dell'algoritmo per trovare anagrammi
+# dalla seconda edizione
+# del libro di Jon Bentley "Programming Pearls".
+# Addison Wesley, 2000, ISBN 0-201-65788-0.
+# Colonna 2, Problema C, sezione 2.8, pp 18-20.
address@hidden endfile
address@hidden
address@hidden file eg/prog/anagram.awk
+#
+# Questo programma richiede gawk 4.0 o una versione successiva.
+# address@hidden di gawk richieste:
+# - veri vettori multidimensionali
+# - split() con separatore "" per separare ogni singolo carattere
+# - le funzioni asort() e asorti()
+#
+# Vedere http://savannah.gnu.org/projects/gawk.
+#
+# Arnold Robbins
+# arnold@@skeeve.com
+# Public Domain
+# January, 2011
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/anagram.awk
+
+/'s$/ @{ next @} # Salta i genitivi sassoni
address@hidden endfile
address@hidden example
+
+Il programma inizia con un'intestazione, e poi una regola per saltare
+i genitivi sassoni eventualmente contenuti nel file che contiene la lista di
+parole. La regola
+successiva costruisce la struttura dei dati. Il primo indice del vettore
address@hidden rappresentato dalla firma; il secondo @`e la parola stessa:
+
address@hidden
address@hidden file eg/prog/anagram.awk
address@hidden
+ chiave = da_parola_a_chiave($1) # costruisce la firma
+ data[chiave][$1] = $1 # Immagazzina parola con questa firma
address@hidden
address@hidden endfile
address@hidden example
+
+La funzione @code{da_parola_a_chiave()} crea la firma.
+Divide la parola in lettere singole, mette in ordine alfabetico le lettere,
+e poi le rimette ancora insieme:
+
address@hidden
address@hidden file eg/prog/anagram.awk
+# da_parola_a_chiave --- divide parole in lettere, ordina e riunisce
+
+function da_parola_a_chiave(parola, a, i, n, risultato)
address@hidden
+ n = split(parola, a, "")
+ asort(a)
+
+ for (i = 1; i <= n; i++)
+ risultato = risultato a[i]
+
+ return risultato
address@hidden
address@hidden endfile
address@hidden example
+
+Infine, la regola @code{END} percorre tutto il vettore e stampa
+le liste degli anagrammi. L'output @`e poi passato al
+comando di sistema @command{sort} perch@'e altrimenti gli
+anagrammi sarebbero elencati in ordine arbitrario:
+
address@hidden
address@hidden file eg/prog/anagram.awk
+END @{
+ sort = "sort"
+ for (chiave in data) @{
+ # ordina parole con la stessa chiave
+ n_parole = asorti(data[chiave], parole)
+ if (n_parole == 1)
+ continue
+
+ # e stampa. Problema minore: uno spazio extra a fine di ogni riga
+ for (j = 1; j <= n_parole; j++)
+ printf("%s ", parole[j]) | sort
+ print "" | sort
+ @}
+ close(sort)
address@hidden
address@hidden endfile
address@hidden example
+
+Ecco una piccola parte dell'output quando il programma @`e eseguito:
+
address@hidden
+$ @kbd{gawk -f anagram.awk /usr/share/dict/italian | grep '^b'}
address@hidden
+baraste bastare serbata
+barasti basarti
+baratro tabarro
+barattoli ribaltato tribolata
+barbieri birberia
+barche brache
+barcollerei corbelleria
+bare erba
+bareremmo brameremo
+barili librai
address@hidden
address@hidden example
+
+
address@hidden Programma signature
address@hidden E ora per qualcosa di completamente differente
+
address@hidden @code{signature}, programma
address@hidden programma @code{signature}
address@hidden Brini, Davide
+Il programma seguente @`e stato scritto da Davide Brini
address@hidden (@email{dave_br@@gmx.com})
+ed @`e pubblicato sul
@uref{http://backreference.org/2011/02/03/obfuscated-awk/,
+suo sito web}.
+Serve come sua firma nel gruppo Usenet @code{comp.lang.awk}.
+Questi sono i termini da lui stabiliti per il copyright:
+
address@hidden
+Copyright @copyright{} 2008 Davide Brini
+
+Copying and distribution of the code published in this page, with or without
+modification, are permitted in any medium without royalty provided the
copyright
+notice and this notice are preserved.
address@hidden quotation
+
+Ecco il programma:
+
address@hidden
+awk 'address@hidden"~"~"~";o="=="=="==";o+=+o;x=O""O;while(X++<=x+o+o)c=c"%c";
+printf c,(x-O)*(x-O),x*(x-o)-o,x*(x-O)+x-O-o,+x*(x-O)-x+o,X*(o*o+O)+x-O,
+X*(X-x)-o*o,(x+X)*o*o+o,x*(X-x)-O-O,x-O+(O+o+X+x)*(o+O),X*X-X*(x-O)-x+O,
+O+X*(o*(o+O)+O),+x+O+X*o,x*(x-o),(o+X+x)*o*o-(x-O-O),O+(X-x)*(X+O),address@hidden'
address@hidden example
address@hidden genera l'email del tizio:
address@hidden address@hidden
+
address@hidden Johansen, Chris
+Viene lasciato al lettore il piacere di stabilire cosa fa il programma.
+(Se si @`e sull'orlo della disperazione nel tentativo di comprensione, si veda
+la spiegazione di Chris Johansen,
+che @`e contenuta nel file sorgente Texinfo di questo @value{DOCUMENT}.)
+
address@hidden
+To: "Arnold Robbins" <address@hidden>
+Date: Sat, 20 Aug 2011 13:50:46 -0400
+Subject: The GNU Awk User's Guide, Section 13.3.11
+From: "Chris Johansen" <address@hidden>
+Message-ID: <address@hidden>
+
+Arnold, tu non mi conosci, ma c'@`e un sottile legame tra noi. Mia moglie @`e
+Barbara A. Field, FAIA, GIT '65 (B. Arch.).
+
+Ho un paio di copie cartacee di "Effective Awk Programming" da
+anni, ed ora sto leggendo di nuovo la versione Kindle di "The GNU Awk User's
+Guide". Quando sono arrivato alla sezione 13.3.11, ho riformattato e
+brevemente commentato lo script di firma di Davide Brin per comprenderne il
funzionamento.
+
+Mi pare che questo possa avere un valore pedagogico come esempio
+(sia pure imperfetto) del significato di spazi bianchi e commenti, e un
+punto di partenza per una tale discussione. Sicuramente ha aiutato _me_ a
+capire quel che succede. Se vuoi
+usarlo, com'@`e o modificato, sentiti libero di farlo (a condizione di
+rispettare i vincoli posti da Davide, naturalmente, che credo siano stati
+da me rispettati).
+
+Se dovessi includere questa spiegazione in una futura edizione, la inserirei
+a una certa distanza dalla sezione 13.3.11, diciamo come una nota o come
+un'appendice, in modo da non rivelare immediatamente la soluzione dell'enigma.
+
+Cordiali saluti,
+--
+Chris Johansen {johansen at main dot nc dot us}
+ . . . collapsing the probability wave function, sending ripples of
+certainty through the space-time continuum.
+
+
+#! /usr/bin/gawk -f
+
+# Da "13.3.11 E ora per qualcosa di completamente differente"
+#
http://www.gnu.org/software/gawk/manual/html_node/Signature-Program.html#Signature-Program
+
+# Copyright é 2008 Davide Brini
+
+# Copying and distribution of the code published in this page, with
+# or without modification, are permitted in any medium without
+# royalty provided the copyright notice and this notice are preserved.
+
+BEGIN {
+ O = "~" ~ "~"; # 1
+ o = "==" == "=="; # 1
+ o += +o; # 2
+ x = O "" O; # 11
+
+
+ while ( X++ <= x + o + o ) c = c "%c";
+
+ # O vale 1
+ # o vale 2
+ # x vale 11
+ # X vale 17
+ # c vale "%c%c%c%c%c%c%c%c%c%c%c%c%c%c%c%c"
+
+ printf c,
+ ( x - O )*( x - O), # 100 d
+ x*( x - o ) - o, # 97 a
+ x*( x - O ) + x - O - o, # 118 v
+ +x*( x - O ) - x + o, # 101 e
+ X*( o*o + O ) + x - O, # 95 _
+ X*( X - x ) - o*o, # 98 b
+ ( x + X )*o*o + o, # 114 r
+ x*( X - x ) - O - O, # 64 @
+ x - O + ( O + o + X + x )*( o + O ), # 103 g
+ X*X - X*( x - O ) - x + O, # 109 m
+ O + X*( o*( o + O ) + O ), # 120 x
+ +x + O + X*o, # 46 .
+ x*( x - o), # 99 c
+ ( o + X + x )*o*o - ( x - O - O ), # 111 0
+ O + ( X - x )*( X + O ), # 109 m
+ x - O # 10 \n
+}
address@hidden ignore
+
address@hidden Sommario dei programmi
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+I programmi illustrati in questo @value{CHAPTER}
+ripropongo la tesi secondo cui leggere programmi @`e una maniera eccellente
+per imparare a fare della buona programmazione.
+
address@hidden
+Usare @samp{#!} per rendere i programmi @command{awk} direttamente eseguibili
+ne rende address@hidden semplice l'uso. In alternativa, si address@hidden
invocare un
+programma usando @samp{awk -f @dots{}}.
+
address@hidden
+Reimplementare programmi POSIX standard in @command{awk} @`e un esercizio
+piacevole; il potere espressivo di @command{awk} consente di scrivere tali
+programmi usando relativamente poche righe di codice, nonostante i programmi
+risultanti siano funzionalmente completi e utilizzabili.
+
address@hidden
+Una delle debolezze della versione standard di @command{awk} riguarda il
+lavorare con singoli caratteri. La address@hidden di usare @code{split()} con
+la stringa nulla come separatore address@hidden semplificare considerevolmente
tale
+compito.
+
address@hidden
+Gli esempi proposti dimostrano l'address@hidden delle funzioni di libreria
introdotte
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria}
+per un numero (sia pur piccolo) di programmi reali.
+
address@hidden
+Oltre a reinventare la ruota POSIX, altri programmi risolvono una serie di
+problemi interessanti, come trovare delle parole duplicate in un testo,
+stampare etichette per lettere, e trovare anagrammi.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi sui programmi
address@hidden Esercizi
+
address@hidden
address@hidden
+Riscrivere @file{cut.awk} (@pxref{Programma cut})
+usando @code{split()} con @code{""} come separatore.
+
address@hidden
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden egrep}, @`e detto che @samp{egrep -i} potrebbe essere
+simulato in versioni di @command{awk} che non prevedono @code{IGNORECASE}
+usando @code{tolower()} sulla riga e nei criteri di ricerca. In una nota a
address@hidden di pagina @`e anche detto che questa soluzione ha un problema:
in output
+viene scritta la riga tradotta (a lettere minuscole), e non quella originale.
+Risolvere questo problema.
address@hidden Exercise: Fix this, w/array and new line as key to original line
+
address@hidden
+La versione POSIX di @command{id} accetta opzioni che controllano quali
+informazioni stampare. Modificare la versione @command{awk}
+(@pxref{Programma id}) per accettare gli stessi argomenti e funzionare allo
+stesso modo.
+
address@hidden
+Il programma @code{split.awk} (@pxref{Programma split}) presuppone che le
+lettere siano contigue nella codifica dei caratteri,
+il che non @`e vero per sistemi che usano la codifica EBCDIC.
+Risolvere questo problema.
+(Suggerimento: Considerare un modo diverso di analizzare l'alfabeto,
+senza appoggiarsi sulle funzioni @code{ord()} e @code{chr()}.)
+
address@hidden
+Nel programma @file{uniq.awk} (@pxref{Programma uniq}, la
+logica per scegliere quali righe stampare rappresenta una
address@hidden a stati},
+ossia ``un dispositivo che address@hidden essere in uno di un insieme di stati
+stabili, a seconda dello stato in cui si trovava in precedenza, e del
+valore corrente dei suoi
+input.''@footnote{Questo @`e la definizione trovata usando
address@hidden: state machine} come chiave di ricerca in Google.}
+Brian Kernighan suggerisce che
+``un approccio alternativo alle macchine a stati @`e di leggere tutto l'input
+e metterlo in un vettore, e quindi usare gli indici. @`E quasi sempre
address@hidden
+semplice da programmare, e per la maggior parte degli input in cui si
address@hidden
+usare, altrettanto veloce in esecuzione.'' Riscrivere la logica del
+programma seguendo questa indicazione.
+
+
address@hidden
+Perch@'e il programma @file{wc.awk} (@pxref{Programma wc}) non address@hidden
+limitarsi a usare il valore di @code{FNR} nella funziona @code{a_fine_file()}?
+Suggerimento: Esaminare il codice
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden filetrans}.
+
address@hidden
address@hidden can't just use the value of @code{FNR} in
address@hidden()}. If you examine the code in @ref{Filetrans Function},
+you will see that @code{FNR} has already been reset by the time
address@hidden()} is called.
address@hidden ignore
+
address@hidden
+La manipolazione di singoli caratteri nel programma @command{translate}
+(@pxref{Programma translate}) @`e farraginosa usando le funzione standard
address@hidden Poich@'e @command{gawk} address@hidden dividere stringhe in
caratteri
+singoli usando come separatore @code{""}, come si potrebbe usare questa
address@hidden per semplificare il programma?
+
address@hidden
+Il programma @file{extract.awk} (@pxref{Programma extract}) @`e stato
+scritto prima che @command{gawk} avesse a disposizione la funzione
address@hidden()}. Usarla per semplificare il codice.
+
address@hidden
+Si confronti la address@hidden di esecuzione del programma @file{awksed.awk}
+(@pxref{Programma sed semplice}) con il address@hidden diretto:
+
address@hidden
+BEGIN @{
+ stringa = ARGV[1]
+ rimpiazzo = ARGV[2]
+ ARGV[1] = ARGV[2] = ""
address@hidden
+
address@hidden gsub(stringa, rimpiazzo); print @}
address@hidden example
+
address@hidden
+Quali sono vantaggi e svantaggi di @file{awksed.awk} rispetto al vero
+programma di address@hidden @command{sed}?
+
address@hidden
+ Advantage: egrep regexps
+ speed (?)
+ Disadvantage: no & in replacement text
+
+Others?
address@hidden ignore
+
address@hidden
address@hidden
+Nella
address@hidden iftex
address@hidden
+In
address@hidden ifnottex
address@hidden igawk}, si @`e detto che non tentando di salvare la riga
+letta con @code{getline} nella funzione @code{percorso()}, mentre si
+controlla l'address@hidden del file da usare nel programma principale,
+semplifica notevolmente le cose. Quale problema @`e peraltro generato
address@hidden@dotless{i}}
+facendo?
address@hidden answer, reading from "-" o /dev/stdin
+
address@hidden percorso di ricerca per file sorgente
address@hidden ricerca, percorso di, per file sorgente
address@hidden file sorgente, percorso di ricerca per
address@hidden directory, ricerca
address@hidden
+Come ulteriore esempio dell'idea che non sempre @`e necessario aggiungere
+nuove address@hidden a un programma, si consideri l'idea di avere due file in
+una directory presente nel percorso di ricerca:
+
address@hidden @file
address@hidden default.awk
+Questo file contiene un insieme di funzioni di libreria di default, come
address@hidden()} e @code{assert()}.
+
address@hidden sito.awk
+Questo file contiene funzioni di libreria che sono specifiche di
+un sito o di un'installazione; address@hidden, funzioni sviluppate localmente.
+Mantenere due file separati consente a @file{default.awk} di essere
+modificato in seguito a nuove versioni di @command{gawk}, senza che
+l'amministratore di sistema debba ogni volta aggiornarlo aggiungendo le
+funzioni locali.
address@hidden table
+
+Un utente
address@hidden Karl Berry, address@hidden, 10/95
+ha suggerito che @command{gawk} venga modificato per leggere automaticamente
+questi file alla partenza. Piuttosto, sarebbe molto semplice
+modificare @command{igawk} per farlo. Poich@'e @command{igawk} @`e capace di
+elaborare direttive @code{@@include}
+nidificate, @file{default.awk} potrebbe contenere semplicemente la lista di
+direttive @code{@@include} con le funzioni di libreria desiderate.
+Fare questa modifica.
+
address@hidden
+Modificare @file{anagram.awk} (@pxref{Programma anagram}), per evitare di
+usare il programma di address@hidden esterno @command{sort}.
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden
address@hidden @value{PART3}Andare oltre @command{awk} con @command{gawk}
address@hidden ifnotinfo
+
address@hidden
+La Parte III riguarda address@hidden proprie di @command{gawk}.
+Contiene i seguenti capitoli:
+
address@hidden @value{BULLET}
address@hidden
address@hidden@`a avanzate}
+
address@hidden
address@hidden
+
address@hidden
address@hidden
+
address@hidden
address@hidden con precisione arbitraria}
+
address@hidden
address@hidden dinamiche}
address@hidden itemize
address@hidden ifdocbook
+
address@hidden address@hidden avanzate
address@hidden address@hidden avanzate di @command{gawk}
address@hidden @command{gawk}, address@hidden avanzate
address@hidden avanzate, address@hidden, di @command{gawk}
address@hidden
+Contributed by: Peter Langston <address@hidden>
+
+ Found in Steve English's "signature" line:
+
+"Write documentation as if whoever reads it is a violent psychopath
+who knows where you live."
address@hidden ignore
address@hidden Langston, Peter
address@hidden English, Steve
address@hidden
address@hidden la documentazione supponendo che chiunque la address@hidden sia
uno psicopatico
+violento, che conosce il vostro indirizzo di casa.}
address@hidden Steve English, citato da Peter Langston
address@hidden quotation
+
+Questo @value{CHAPTER} tratta delle address@hidden avanzate in @command{gawk}.
address@hidden un po' come un ``pacco sorpresa'' di argomenti che non sono
collegati tra di
+loro in altro modo.
+Per prima cosa, vediamo un'opzione da riga di comando che consente a
address@hidden di riconoscere i numeri non-decimali nei dati in input, e non
+soltanto nei programmi @command{awk}.
+Poi vengono illustrate delle address@hidden speciali di @command{gawk} per
+l'ordinamento di vettori. Quindi viene trattato dettagliatamente l'I/O
+bidirezionale, di cui si @`e fatto cenno in precedenti parti di questo
address@hidden, assieme ai fondamenti sulle reti TCP/IP.
+Infine, vediamo come @command{gawk}
address@hidden tracciare il @dfn{profilo} di un programma @command{awk},
address@hidden@dotless{i}} che si
+possa ritoccarlo per migliorarne le prestazioni.
+
address@hidden FULLXREF ON
+Altre address@hidden avanzate vengono trattate separatamente dedicando un
address@hidden per ciascuna di esse:
+
address@hidden @value{BULLET}
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden, parla di come internazionalizzare
+i propri programmi @command{awk}, in modo che parlino address@hidden lingue
+nazionali.
+
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden, descrive il debugger dalla riga di comando disponibile
+all'interno di
address@hidden per individuare errori nei programmi @command{awk}.
+
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden con precisione arbitraria}, illustra come si address@hidden usare
address@hidden per eseguire calcoli con precisione arbitraria.
+
address@hidden
address@hidden
+Il
address@hidden iftex
address@hidden dinamiche},
+tratta della address@hidden di aggiungere dinamicamente nuove funzioni
predefinite a
address@hidden
address@hidden itemize
address@hidden FULLXREF OFF
+
address@hidden
+* Dati non decimali:: Consentire dati di input non decimali.
+* Ordinamento di vettori:: Modi per controllare la visita di un vettore
+ e il suo ordinamento.
+* I/O bidirezionale:: Comunicazione bidirezionale con un altro
+ processo.
+* Reti TCP/IP:: Usare @command{gawk} per programmazione di
rete.
+* Profilare:: Profilare i propri programmi @command{awk}.
+* Sommario address@hidden avanzate:: Sommario delle address@hidden avanzate.
address@hidden menu
+
address@hidden Dati non decimali
address@hidden Consentire dati di input non decimali
address@hidden opzione @option{--non-decimal-data}
address@hidden @cindex address@hidden avanzate, dati di input non decimali
address@hidden input, dati non decimali
address@hidden costanti, non decimali
+
+Se si esegue @command{gawk} con l'opzione @option{--non-decimal-data},
+si possono avere valori in base diversa da dieci nei dati di input:
+
address@hidden
+$ @kbd{echo 0123 123 0x123 |}
+> @kbd{gawk --non-decimal-data '@{ printf "%d, %d, %d\n", $1, $2, $3 @}'}
address@hidden 83, 123, 291
address@hidden example
+
+Affinch@'e questa address@hidden sia disponibile, i programmi devono essere
+scritti in modo che @command{gawk} tratti i dati come valori numerici:
+
address@hidden
+$ @kbd{echo 0123 123 0x123 | gawk '@{ print $1, $2, $3 @}'}
address@hidden 0123 123 0x123
address@hidden example
+
address@hidden
+L'istruzione @code{print} tratta le sue espressioni come se fossero stringhe.
+Sebbene i campi possano comportarsi come numeri, quando necessario,
+essi rimangono sempre stringhe, per cui @code{print} non cerca di elaborarli
+come se fossero numeri. Si deve aggiungere zero a un campo affich@'e venga
+considerato come un numero. Per esempio:
+
address@hidden
+$ @kbd{echo 0123 123 0x123 | gawk --non-decimal-data '}
+> @address@hidden print $1, $2, $3}
+> @kbd{print $1 + 0, $2 + 0, $3 + 0 @}'}
address@hidden 0123 123 0x123
address@hidden 83 123 291
address@hidden example
+
+Poich@'e capita comunemente di avere dati di tipo decimale con degli zeri
iniziali,
+e poich@'e l'uso di questa address@hidden address@hidden portare a risultati
inattesi, il
+comportamento di default @`e quello lasciarla disabilitata. Se si vuole, la si
+deve richiedere esplicitamente.
+
address@hidden programmazione, convenzioni di, opzione @code{--non-decimal-data}
address@hidden @option{--non-decimal-data}, opzione, funzione @code{strtonum()}
e
address@hidden @code{strtonum()}, funzione (@command{gawk}), opzione
@code{--non-decimal-data} e
address@hidden ATTENZIONE
address@hidden'uso di questa opzione non @`e consigliata.}
address@hidden provocare errori molto seri eseguendo vecchi programmi.
+Al suo posto @`e meglio usare la funzione @code{strtonum()} per convertire i
dati
+(@pxref{Funzioni per stringhe}).
+Questo rende i programmi address@hidden facili da scrivere e address@hidden
facili da leggere, e
+porta a risultati meno inattesi.
+
+Quest'opzione potrebbe sparire dalle versioni future di @command{gawk}.
address@hidden quotation
+
address@hidden Ordinamento di vettori
address@hidden Controllare la visita di un vettore e il suo ordinamento
+
address@hidden permette di controllare l'ordine con cui un ciclo
address@hidden (@var{indice} in @var{vettore})}
+attraversa un vettore.
+
+Inoltre, due funzioni predefinite, @code{asort()} e @code{asorti()},
+permettono di mettere in ordine i vettori sulla base, rispettivamente, dei
+valori e degli indici del vettore. Queste due funzioni danno anche il
+controllo sui criteri in base ai quali riordinare gli elementi del vettore.
+
address@hidden
+* Controllare visita vettori:: Come usare PROCINFO["sorted_in"].
+* Funzioni di ordinamento di vettori:: Come usare @code{asort()} e
@code{asorti()}.
address@hidden menu
+
address@hidden Controllare visita vettori
address@hidden Controllare visita vettori
+
+Per default, l'ordine secondo il quale un ciclo @samp{for (@var{indice} in
address@hidden)} scorre un vettore non @`e definito; in genere si basa
+sull'implementazione interna dei vettori all'interno di @command{awk}.
+
+Spesso, tuttavia, si vorrebbe poter eseguire un ciclo sugli elementi in un
+determinato ordine scelto dall'utente programmatore. Con @command{gawk}
+si address@hidden fare.
+
address@hidden
+La
address@hidden iftex
address@hidden visita} parla di come si possono assegnare valori speciali
+predefiniti a @code{PROCINFO["sorted_in"]} per controllare l'ordine secondo il
+quale @command{gawk} attraversa un vettore
+durante un ciclo @code{for}.
+
+Inoltre, il valore di @code{PROCINFO["sorted_in"]} address@hidden essere un
nome di
address@hidden @`e il motivo per cui gli ordinamenti predefiniti
+iniziano con il carattere @samp{@@}, che non address@hidden essere usato in un
+identificatore.}
+Questo consente di scorrere un vettore sulla base di un qualsiasi criterio
+personalizzato. Gli elementi del vettore vengono ordinati in accordo col valore
+ritornato da questa funzione. La funzione che fa il confronto dovrebbe essere
+definita con almeno quattro argomenti:
+
address@hidden
+function confronta(i1, v1, i2, v2)
address@hidden
+ @var{confronta gli elementi 1 e 2 in qualche modo}
+ @var{return < 0; 0; o > 0}
address@hidden
address@hidden example
+
+Qui, @code{i1} e @code{i2} sono gli indici, e @code{v1} e @code{v2}
+sono i corrispondenti valori dei due elementi che si stanno confrontando.
address@hidden oppure @code{v2}, o entrambi, possono essere vettori se il
vettore
+che si sta visitando contiene sottovettori come valori.
+(@xref{Vettori di vettori} per maggiori informazioni sui sottovettori.)
+I tre possibili valori di ritorno sono interpretati nel seguente modo:
+
address@hidden @code
address@hidden confronta(i1, v1, i2, v2) < 0
+L'indice @code{i1} viene prima dell'indice @code{i2} durante l'avanzamento
+del ciclo.
+
address@hidden confronta(i1, v1, i2, v2) == 0
+Gli indici @code{i1} e @code{i2}
+sono equivalenti, ma l'ordine tra loro non @`e definito.
+
address@hidden confronta(i1, v1, i2, v2) > 0
+L'indice @code{i1} viene dopo l'indice @code{i2} durante l'avanzamento del
+ciclo.
address@hidden table
+
+La prima funzione di confronto address@hidden essere usata per scorrere un
vettore
+secondo l'ordine numerico degli indici:
+
address@hidden
+function cfr_ind_num(i1, v1, i2, v2)
address@hidden
+ # confronto di indici numerici, ordine crescente
+ return (i1 - i2)
address@hidden
address@hidden example
+
+La seconda funzione scorre un vettore secondo l'ordine delle stringhe
+dei valori degli elementi piuttosto che secondo gli indici:
+
address@hidden
+function cfr_val_str(i1, v1, i2, v2)
address@hidden
+ # confronto di valori di stringa, ordine crescente
+ v1 = v1 ""
+ v2 = v2 ""
+ if (v1 < v2)
+ return -1
+ return (v1 != v2)
address@hidden
address@hidden example
+
+La terza funzione di confronto restituisce dapprima tutti i numeri, e dopo
+questi le stringhe numeriche senza spazi iniziali o finali, durante
+l'avanzamento del ciclo:
+
address@hidden
+function cfr_val_num_str(i1, v1, i2, v2, n1, n2)
address@hidden
+ # confronto mettendo i numeri prima dei valori di stringa,
+ # ordine crescente
+ n1 = v1 + 0
+ n2 = v2 + 0
+ if (n1 == v1)
+ return (n2 == v2) ? (n1 - n2) : -1
+ else if (n2 == v2)
+ return 1
+ return (v1 < v2) ? -1 : (v1 != v2)
address@hidden
address@hidden example
+
+Qui vediamo un programma principale che mostra come @command{gawk}
+si comporta usando ciascuna delle funzioni precedenti:
+
address@hidden
+BEGIN @{
+ data["uno"] = 10
+ data["due"] = 20
+ data[10] = "uno"
+ data[100] = 100
+ data[20] = "due"
+
+ f[1] = "cfr_ind_num"
+ f[2] = "cfr_val_str"
+ f[3] = "cfr_val_num_str"
+ for (i = 1; i <= 3; i++) @{
+ printf("Funzione di ordinamento: %s\n", f[i])
+ PROCINFO["sorted_in"] = f[i]
+ for (j in data)
+ printf("\tdata[%s] = %s\n", j, data[j])
+ print ""
+ @}
address@hidden
address@hidden example
+
+I risultati dell'esecuzione del programma sono questi:
+
address@hidden
+$ @kbd{gawk -f compdemo.awk}
address@hidden Funzione di ordinamento: cfr_ind_num @ii{Ordinamento per indice
numerico}
address@hidden data[uno] = 10
address@hidden data[due] = 20 @ii{Entrambe le stringhe sono
numericamente zero}
address@hidden data[10] = uno
address@hidden data[20] = due
address@hidden data[100] = 100
address@hidden
address@hidden Funzione di ordinamento: cfr_val_str @ii{Ordinamento per valore
degli}
address@hidden @ii{elementi come
stringhe}
address@hidden data[uno] = 10
address@hidden data[100] = 100 @ii{La stringa 100 @`e minore della
stringa 20}
address@hidden data[due] = 20
address@hidden data[20] = due
address@hidden data[10] = uno
address@hidden
address@hidden Funzione di ordinamento: cfr_val_num_str @ii{Ordinamento con
tutti i}
address@hidden @ii{valori numerici prima di tutte le
stringhe}
address@hidden data[uno] = 10
address@hidden data[due] = 20
address@hidden data[100] = 100
address@hidden data[20] = due
address@hidden data[10] = uno
address@hidden example
+
+Si provi a ordinare gli elementi di un file delle password del sistema
GNU/Linux
+in base al nome d'accesso dell'utente. Il seguente programma ordina i record
+secondo una specifica posizione del campo e address@hidden essere usato per
questo scopo:
+
address@hidden
+# passwd-sort.awk --- semplice programma per ordinare in base alla
+# posizione del campo
+# la posizione del campo @`e specificata dalla variabile globale POS
+
+function per_campo(i1, v1, i2, v2)
address@hidden
+ # confronto per valore, come stringa, e in ordine crescente
+ return v1[POS] < v2[POS] ? -1 : (v1[POS] != v2[POS])
address@hidden
+
address@hidden
+ for (i = 1; i <= NF; i++)
+ a[NR][i] = $i
address@hidden
+
+END @{
+ PROCINFO["sorted_in"] = "per_campo"
+ if (POS < 1 || POS > NF)
+ POS = 1
+ for (i in a) @{
+ for (j = 1; j <= NF; j++)
+ printf("%s%c", a[i][j], j < NF ? ":" : "")
+ print ""
+ @}
address@hidden
address@hidden example
+
+Il primo campo di ogni elemento del file delle password @`e il nome d'accesso
+dell'utente, e i campi sono separati tra loro da due punti.
+Ogni record definisce un sottovettore,
+con ogni campo come elemento nel sottovettore.
+L'esecuzione del programma produce
+il seguente output:
+
address@hidden
+$ @kbd{gawk -v POS=1 -F: -f sort.awk /etc/passwd}
address@hidden adm:x:3:4:adm:/var/adm:/sbin/nologin
address@hidden apache:x:48:48:Apache:/var/www:/sbin/nologin
address@hidden avahi:x:70:70:Avahi daemon:/:/sbin/nologin
address@hidden
address@hidden example
+
+Il confronto normalmente dovrebbe restituire sempre lo stesso valore quando
+vien dato come argomento un preciso paio di elementi del vettore. Se viene
+restituito un risultato non coerente, l'ordine @`e indefinito. Questo
+comportamento address@hidden essere sfruttato per introdurre un ordinamento
casuale in
+dati apparentemente ordinati:
+
address@hidden
+function ordina_a_caso(i1, v1, i2, v2)
address@hidden
+ # ordine casuale (attenzione: potrebbe non finire mai!)
+ return (2 - 4 * rand())
address@hidden
address@hidden example
+
+Come address@hidden accennato, l'ordine degli indici @`e arbitrario se due
elementi
+risultano uguali. Normalmente questo non @`e un problema, ma lasciare che
+elementi di uguale valore compaiano in ordine arbitrario address@hidden essere
un
+problema, specialmente quando si confrontano valori di elementi di un elenco.
+L'ordine parziale di elementi uguali address@hidden cambiare quando il vettore
viene
+visitato di nuovo, se nel vettore vengono aggiunti o rimossi elementi. Un modo
+per superare l'ostacolo quando si confrontano elementi con valori uguali @`e
+quello di includere gli indici nelle regole di confronto. Si noti che questo
+potrebbe rendere meno efficiente l'attraversamento del ciclo, per cui si
+consiglia di farlo solo se necessario. Le seguenti funzioni di confronto
+impongono un ordine deterministico, e si basano sul fatto che gli indici
+(di stringa) di due elementi non sono mai uguali:
address@hidden
+function per_numero(i1, v1, i2, v2)
address@hidden
+ # confronto di valori numerici (e indici), ordine decrescente
+ return (v1 != v2) ? (v2 - v1) : (i2 - i1)
address@hidden
+
+function per_stringa(i1, v1, i2, v2)
address@hidden
+ # confronto di valori di stringa (e indici), ordine decrescente
+ v1 = v1 i1
+ v2 = v2 i2
+ return (v1 > v2) ? -1 : (v1 != v2)
address@hidden
address@hidden example
+
address@hidden Avoid using the term ``stable'' when describing the
unpredictable behavior
address@hidden if two items compare equal. Usually, the goal of a "stable
algorithm"
address@hidden is to maintain the original order of the items, which is a
meaningless
address@hidden concept for a list constructed from a hash.
+
+Una funzione di confronto personalizzata spesso address@hidden semplificare
+l'attraversamento del
+ciclo ordinato, e il solo limite @`e il cielo, quando si va a progettare
+una funzione di questo tipo.
+
+Quando i confronti tra stringhe son fatti durante un'operazione di ordinamento,
+per valori di elementi che, uno o entrambi, non sono numeri, o per
+indici di elementi gestiti come stringhe, il valore di @code{IGNORECASE}
+(@pxref{Variabili predefinite}) controlla se
+i confronti trattano corrispondenti lettere maiuscole e minuscole
+come equivalenti o come distinte.
+
+Un'altra cosa da tenere a mente @`e che nel caso di sottovettori, i valori
degli
+elementi possono essere a loro volta dei vettori; una funzione di confronto in
+produzione dovrebbe usare la funzione @code{isarray()}
+(@pxref{Funzioni per i tipi})
+per controllare address@hidden, e scegliere un ordinamento preciso per i
sottovettori.
+
+Tutti gli ordinamenti basati su @code{PROCINFO["sorted_in"]}
+sono disabilitati in address@hidden POSIX,
+perch@'e il vettore @code{PROCINFO} in questo caso non @`e speciale.
+
+Come nota a margine, si @`e visto che ordinare gli indici del vettore prima di
+scorrere il vettore porta a un incremento variabile dal 15% al 20% del tempo di
+esecuzione dei programmi @command{awk}. Per questo motivo l'attraversamento
+ordinato di vettori non @`e il default.
+
address@hidden The @command{gawk}
address@hidden maintainers believe that only the people who wish to use a
address@hidden feature should have to pay for it.
+
address@hidden Funzioni di ordinamento di vettori
address@hidden Ordinare valori e indici di un vettore con @command{gawk}
+
address@hidden vettori, ordinamento dei
address@hidden
address@hidden @code{asort()}, funzione (@command{gawk}), ordinamento di vettori
address@hidden funzione @code{asort()} (@command{gawk}), ordinamento di vettori
address@hidden
address@hidden @code{asorti()}, funzione (@command{gawk}), ordinamento di
vettori
address@hidden funzione @code{asorti()} (@command{gawk}), ordinamento di vettori
address@hidden @code{sort()}, funzione, ordinamento di vettori
address@hidden funzione @code{sort()}, ordinamento di vettori
+Nella maggior parte delle implementazioni di @command{awk}, ordinare un vettore
+richiede una funzione @code{sort()}. Questo address@hidden essere istruttivo
per provare
+diversi algoritmi di ordinamento, ma normalmente non @`e questo lo scopo del
+programma. In @command{gawk} ci sono le funzioni predefinite @code{asort()} e
address@hidden()} (@pxref{Funzioni per stringhe}) per i vettori ordinati.
+Per esempio:
+
address@hidden
address@hidden il vettore} dati
+n = asort(dati)
+for (i = 1; i <= n; i++)
+ @var{fare qualcosa con} dati[i]
address@hidden example
+
+Dopo la chiamata ad @code{asort()}, il vettore @code{dati} @`e indicizzato da 1
+a @var{n}, il numero totale di elementi in @code{dati}.
+(Questo conteggio @`e il valore di ritorno di @code{asort()}).
address@hidden @value{LEQ} @code{dati[2]} @value{LEQ} @code{dati[3]}, e
address@hidden@dotless{i}}
+via. Il confronto di default @`e basato sul tipo di elementi
+(@pxref{Tipi di variabile e confronti}).
+Tutti i valori numerici vengono prima dei valori di stringa,
+che a loro volta vengono prima di tutti i sottovettori.
+
address@hidden effetti collaterali, funzione @code{asort()}
address@hidden funzione @code{asort()}, effetti collaterali
+Un effetto collaterale rilevante nel chiamare @code{asort()} @`e che
address@hidden indici originali del vettore vengono persi irreparabilmente}.
+Poich@'e questo non sempre @`e opportuno, @code{asort()} accetta un
+secondo argomento:
+
address@hidden
address@hidden the array} orig
+n = asort(orig, dest)
+for (i = 1; i <= n; i++)
+ @var{fai qualcosaa con} dest[i]
address@hidden example
+
+In questo caso, @command{gawk} copia il vettore @code{orig} nel vettore
address@hidden e ordina @code{dest}, distruggendo i suoi indici.
+Tuttavia il vettore @code{orig} non viene modificato.
+
+Spesso, address@hidden di cui si ha bisogno @`e di ordinare per i valori degli
address@hidden invece che per i valori degli elementi. Per far questo si usa la
+funzione @code{asorti()}. L'interfaccia e il comportamento sono identici a
+quelli di @code{asort()}, solo che per l'ordinamento vengono usati i valori
+degli indici, che diventano i valori del vettore risultato:
+
address@hidden
address@hidden orig[$0] = una_funz($0) @}
+
+END @{
+ n = asorti(orig, dest)
+ for (i = 1; i <= n; i++) @{
+ @ii{Lavora direttamente con gli indici ordinati:}
+ @var{fa qualcosa con} dest[i]
+ @dots{}
+ @ii{Accede al vettore originale attraverso gli indici ordinati:}
+ @var{fa qualcosa con} orig[dest[i]]
+ @}
address@hidden
address@hidden example
+
+Fin qui, tutto bene. Ora inizia la parte interessante. Sia @code{asort()}
+che @code{asorti()} accettano un terzo argomento di stringa per controllare il
+confronto di elementi del vettore. Quando abbiamo introdotto @code{asort()} e
address@hidden()} nella @ref{Funzioni per stringhe}, abbiamo ignorato questo
terzo
+argomento; comunque, @`e giunto il momento di descrivere come questo argomento
+influenza queste due funzioni.
+
+Fondamentalmente, il terzo argomento specifica come dev'essere ordinato il
+vettore. Ci sono due address@hidden Come per @code{PROCINFO["sorted_in"]},
+quest'argomento address@hidden essere uno degli argomenti predefiniti che
@command{gawk}
+fornisce (@pxref{Controllare visita}), o address@hidden essere il nome di una
funzione
+definita dall'utente (@pxref{Controllare visita vettori}).
+
+Nell'ultimo caso, @emph{la funzione address@hidden confrontare gli elementi in
qualunque
+modo si voglia}, prendendo in considerazione solo gli indici, solo i valori,
+o entrambi. Questo @`e estremamente potente.
+
+Una volta che il vettore @`e ordinato, @code{asort()} prende i @emph{valori}
nel
+loro ordine finale e li usa per riempire il vettore risultato, mentre
address@hidden()} prende gli @emph{indici} nel loro ordine finale e li usa per
+riempire il vettore risultato.
+
address@hidden conteggio riferimenti, ordinamento vettori
address@hidden NOTA
+Copiare indici ed elementi non @`e dispendioso in termini di memoria.
+Internamente, @command{gawk} mantiene un @dfn{conteggio dei riferimenti} ai
+dati. Per esempio, dopo che @code{asort()} copia il primo vettore nel
+secondo, in memoria c'@`e ancora una sola copia dei dati degli elementi
+del vettore originale, ed entrambi i vettori accedono all'unica copia di
+valori che esiste in memoria.
address@hidden quotation
+
address@hidden Document It And Call It A Feature. Sigh.
address@hidden @command{gawk}, variabile @code{IGNORECASE} in
address@hidden vettori, ordinamento, variabile @code{IGNORECASE} e
address@hidden @code{IGNORECASE}, variabile, e funzioni di ordinamento dei
vettori
address@hidden variabile @code{IGNORECASE}, e funzioni di ordinamento dei
vettori
+Poich@'e @code{IGNORECASE} influenza i confronti tra stringhe, il valore di
address@hidden influisce anche sull'ordinamento sia con @code{asort()} che
+con @code{asorti()}.
+Si noti inoltre che l'ordinamento della localizzazione @emph{non} entra in
+gioco; i confronti sono basati solamente sul valore dei
address@hidden@`o @`e vero perch@'e il confronto basato sulla localizzazione
+avviene solo quando si @`e in address@hidden POSIX-compatibile, e poich@'e
@code{asort()}
+e @code{asorti()} sono estensioni di @command{gawk}, esse non sono disponibili
+in quel caso.}
+
+L'esempio seguente mostra l'uso di una funzione di confronto usata con
address@hidden()}. La funzione di confronto, @code{confronta_in_minuscolo()},
+trasforma gli elementi da confrontare in lettere minuscole, in modo da avere
+confronti che non dipendono da maiuscolo/minuscolo.
+
address@hidden
+# confronta_in_minuscolo --- confronta stringhe ignorando maiuscolo/minuscolo
+
+function confronta_in_minuscolo(i1, v1, i2, v2, l, r)
address@hidden
+ l = tolower(v1)
+ r = tolower(v2)
+
+ if (l < r)
+ return -1
+ else if (l == r)
+ return 0
+ else
+ return 1
address@hidden
address@hidden example
+
+E questo programma address@hidden essere usato per provarla:
+
address@hidden
+# programma di test
+
+BEGIN @{
+ Letters = "abcdefghijklmnopqrstuvwxyz" \
+ "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+ split(Letters, data, "")
+
+ asort(data, risultato, "confronta_in_minuscolo")
+
+ j = length(risultato) # numero elementi del vettore "risultato"
+ for (i = 1; i <= j; i++) @{
+ printf("%s", risultato[i])
+ if (i % (j/2) == 0)
+ # a address@hidden, la stampa del vettore va a capo
+ printf("\n")
+ else
+ printf(" ")
+ @}
address@hidden
address@hidden example
+
+Se si esegue il programma, si ottiene:
+
address@hidden
+$ @kbd{gawk -f confronta_in_minuscolo.awk}
address@hidden A a B b c C D d e E F f g G H h i I J j k K l L M m
address@hidden n N O o p P Q q r R S s t T u U V v w W X x y Y z Z
address@hidden example
+
address@hidden I/O bidirezionale
address@hidden Comunicazioni bidirezionali con un altro processo
+
address@hidden 8/2014. Neither Mike nor BWK saw this as relevant. Commenting it
out.
address@hidden
address@hidden Brennan, Michael
address@hidden programmers, attractiveness of
address@hidden
address@hidden Path:
cssun.mathcs.emory.edu!gatech!newsxfer3.itd.umich.edu!news-peer.sprintlink.net!news-sea-19.sprintlink.net!news-in-west.sprintlink.net!news.sprintlink.net!Sprint!204.94.52.5!news.whidbey.com!brennan
+From: brennan@@whidbey.com (Mike Brennan)
+Newsgroups: comp.lang.awk
+Subject: Re: Learn the SECRET to Attract Women Easily
+Date: 4 Aug 1997 17:34:46 GMT
address@hidden Organization: WhidbeyNet
address@hidden Lines: 12
+Message-ID: <5s53rm$eca@@news.whidbey.com>
address@hidden References: <address@hidden>
address@hidden Reply-To: address@hidden
address@hidden NNTP-Posting-Host: asn202.whidbey.com
address@hidden X-Newsreader: slrn (0.9.4.1 UNIX)
address@hidden Xref: cssun.mathcs.emory.edu comp.lang.awk:5403
+
+On 3 Aug 1997 13:17:43 GMT, Want More Dates???
+<tracy78@@kilgrona.com> wrote:
+>Learn the SECRET to Attract Women Easily
+>
+>The SCENT(tm) Pheromone Sex Attractant For Men to Attract Women
+
+The scent of awk programmers is a lot more attractive to women than
+the scent of perl programmers.
+--
+Mike Brennan
address@hidden brennan@@whidbey.com
address@hidden smallexample
address@hidden ignore
+
address@hidden address@hidden avanzate, address@hidden comunicare con
address@hidden processi, comunicazioni bidirezionali con
+Spesso @`e utile poter
+inviare dati a un programma separato che
+li elabori e in seguito leggere il risultato. Questo address@hidden essere
sempre
+fatto con file temporanei:
+
address@hidden
+# Scrivere i dati per l'elaborazione
+filetemp = ("mieidati." PROCINFO["pid"])
+while (@var{non dipendente dai dati})
+ print @var{dati} | ("sottoprogramma > " filetemp)
+close("sottoprogramma > " filetemp)
+
+# Legge il risultato, rimuove filetemp quando ha finito
+while ((getline nuovidati < filetemp) > 0)
+ @var{elabora} nuovidati @var{secondo le esigenze}
+close(filetemp)
+system("rm " filetemp)
address@hidden example
+
address@hidden
+Questo funziona, ma non @`e elegante. Tra le altre cose, richiede che il
+programma venga eseguito in una directory che non address@hidden essere
condivisa tra gli
+utenti; per esempio, @file{/tmp} non address@hidden esserlo, poich@'e potrebbe
accadere che
+un altro utente stia usando un file temporaneo con lo stesso
address@hidden Brennan suggerisce l'uso di @command{rand()} per
+generare @value{FNS} unici. Questo @`e un punto valido; tuttavia, i file
+temporanei rimangono address@hidden difficili da usare delle @dfn{pipe}
bidirezionali.} @c 8/2014
+
address@hidden coprocessi
address@hidden input/output bidirezionale
address@hidden @code{|} (barra verticale), operatore @code{|&} (I/O)
address@hidden barra verticale (@code{|}), operatore @code{|&} (I/O)
address@hidden @command{csh}, comando, operatore @code{|&}, confronto con
address@hidden comando @command{csh}, operatore @code{|&}, confronto con
+Comunque, con @command{gawk}, @`e possibile aprire una @dfn{pipe}
address@hidden
+verso un altro processo. Il secondo processo @`e chiamato @dfn{coprocesso},
+poich@'e viene eseguito in parallelo con @command{gawk}. La connessione
+bidirezionale viene creata usando l'operatore @samp{|&} (preso in prestito
+dalla shell Korn, @command{ksh}):@footnote{Questo @`e molto diverso dallo
stesso
+operatore nella C shell e in Bash.}
+
address@hidden
+do @{
+ print @var{dati} |& "sottoprogramma"
+ "sottoprogramma" |& getline risultato
address@hidden while (@var{ci sono ancora dati da elaborare})
+close("sottoprogramma")
address@hidden example
+
+La prima volta che viene eseguita un'operazione I/O usando l'operatore
address@hidden|&},
address@hidden crea una @dfn{pipeline} bidirezionale verso un processo figlio
+che esegue l'altro programma. L'output creato con @code{print} o con
address@hidden viene scritto nello standard input del programma, e il contenuto
+dello standard output del programma address@hidden essere letto dal programma
address@hidden usando @code{getline}.
+Come accade coi processi avviati con @samp{|}, il sottoprogramma address@hidden
+essere un qualsiasi programma, o una @dfn{pipeline} di programmi, che
address@hidden essere
+avviato dalla shell.
+
+Ci sono alcune avvertenze da tenere presenti:
+
address@hidden @value{BULLET}
address@hidden
+Per come funziona internamente @command{gawk}, lo standard error
+dei coprocessi va nello stesso posto dove va lo standard error del
+genitore @command{gawk}. Non @`e possibile leggere lo standard error del
+figlio separatamente.
+
address@hidden stalli
address@hidden abbracci mortali
address@hidden @dfn{deadlocks}, vedi stalli
address@hidden bufferizzazione, dell'input/output
address@hidden input/output, bufferizzazione
address@hidden @code{getline}, comando, stalli e
address@hidden
+La permanenza in memoria (bufferizzazione) dell'I/O del sottoprocesso potrebbe
+essere un problema. @command{gawk} automaticamente scrive su disco tutto
+l'output spedito tramite la @dfn{pipe} al coprocesso.
+Tuttavia, se il coprocesso non scrive su disco il suo output,
address@hidden potrebbe bloccarsi mentre esegue una @code{getline} per leggere
+il risultato del coprocesso. Questo address@hidden portare a una situazione
+conosciuta come @dfn{stallo} (@dfn{deadlock}, abbraccio mortale), in cui
ciascun
+processo rimane in attesa
+che l'altro processo faccia qualcosa.
address@hidden itemize
+
address@hidden @code{close()}, funzione, @dfn{pipe} bidirezionali e
address@hidden funzione @code{close()}, @dfn{pipe} bidirezionali e
address@hidden possibile chiudere una @dfn{pipe} bidirezionale con un
coprocesso solo in una
+direzione, fornendo un secondo argomento, @code{"to"} o @code{"from"}, alla
+funzione @code{close()} (@pxref{Chiusura file e @dfn{pipe}}).
+Queste stringhe dicono a @command{gawk} di chiudere la @dfn{pipe},
rispettivamente
+nella direzione che invia i dati al coprocesso e nella direzione che legge da
+esso.
+
address@hidden @command{sort}, programma di address@hidden, coprocessi e
address@hidden programma di address@hidden @command{sort}, coprocessi e
+Questo @`e particolarmente necessario per usare il programma di address@hidden
+di sistema @command{sort} come parte di un coprocesso;
address@hidden deve leggere @emph{tutti} i dati di input
+prima di poter produrre un qualsiasi output.
+Il programma @command{sort} non riceve un'indicazione di fine-file
+(end-of-file) finch@'e @command{gawk} non chiude l'address@hidden in scrittura
della
address@hidden
+
+Una volta terminata la scrittura dei dati sul programma @command{sort},
+si address@hidden chiudere il lato @code{"to"} della @dfn{pipe}, e quindi
iniziare a leggere
+i dati ordinati via @code{getline}.
+Per esempio:
+
address@hidden
+BEGIN @{
+ comando = "LC_ALL=C sort"
+ n = split("abcdefghijklmnopqrstuvwxyz", a, "")
+
+ for (i = n; i > 0; i--)
+ print a[i] |& comando
+ close(comando, "to")
+
+ while ((comando |& getline line) > 0)
+ print "ricevuto", line
+ close(comando)
address@hidden
address@hidden example
+
+Questo programma scrive le lettere dell'alfabeto in ordine inverso, uno per
+riga, attraverso la @dfn{pipe} bidirezionale verso @command{sort}. Poi chiude
la
+direzione di scrittura della @dfn{pipe}, in modo che @command{sort} riceva
+un'indicazione di fine-file. Questo fa in modo che @command{sort} ordini i
+dati e scriva i dati ordinati nel programma @command{gawk}. Una volta che
+tutti i dati sono stati letti, @command{gawk} termina il coprocesso ed esce.
+
+Come nota a margine, l'assegnamento @samp{LC_ALL=C} nel comando @command{sort}
+assicura che @command{sort} usi l'ordinamento tradizionale di Unix (ASCII).
address@hidden non @`e strettamente necessario in questo caso, ma @`e bene
sapere come farlo.
+
+Occorre prestare attenzione quando si chiude il lato @code{"from"} di una
address@hidden bidirezionale; in tal caso @command{gawk} attende che il
+processo-figlio termini, il che address@hidden causare lo stallo del programma
address@hidden in esecuzione. (Per questo motivo, questa particolare
address@hidden @`e molto meno usata, in pratica, di quella che consente la
address@hidden di chiudere il lato @code{"to"} della @dfn{pipe}.)
+
address@hidden ATTENZIONE
+Normalmente,
address@hidden un errore fatale (che fa terminare il programma @command{awk})
+scrivere verso il lato @code{"to"} di una @dfn{pipe} bidirezionale che
address@hidden stata chiusa, e lo stesso vale se si legge dal lato @code{"from"}
+di una @dfn{pipe} bidirezionale che sia stata chiusa.
+
address@hidden possibile impostare @code{PROCINFO["@var{comando}", "NONFATAL"]}
+per far address@hidden@dotless{i}} che tali operazioni non provochino la fine
del programma
address@hidden Se lo si fa, @`e necessario controllare il valore
+di @code{ERRNO} dopo ogni istruzione @code{print}, @code{printf},
+o @code{getline}.
address@hidden dopo errori} per ulteriori informazioni.
address@hidden quotation
+
address@hidden @command{gawk}, vettore @code{PROCINFO} in
address@hidden @code{PROCINFO}, vettore, e comunicazioni attraverso le @dfn{pty}
+Per le comunicazioni bidirezionali si possono anche usare delle pseudo
@dfn{tty}
+(@dfn{pty}) al posto delle @dfn{pipe}, se il sistema in uso le prevede.
+Questo vien fatto, a seconda del comando da usare, impostando un elemento
+speciale nel vettore @code{PROCINFO}
+(@pxref{Variabili auto-assegnate}),
+in questo modo:
+
address@hidden
+comando = "sort -nr" # comando, salvato in una variabile
+PROCINFO[comando, "pty"] = 1 # aggiorna PROCINFO
+print @dots{} |& comando # avvia la @dfn{pipe} bidirezionale
address@hidden
address@hidden example
+
address@hidden
+Se il sistema in uso non ha le @dfn{pty}, o se tutte le @dfn{pty} del sistema
+sono in uso, @command{gawk} automaticamente torna a usare le @dfn{pipe}
+regolari.
+
+Usare le @dfn{pty} in genere evita i problemi di stallo del buffer descritti
+precedentemente, in cambio di un piccolo calo di prestazioni. address@hidden
dipende
+dal fatto che la gestione delle @dfn{tty} @`e fatta una riga per volta.
+Su sistemi che hanno il comando @command{stdbuf} (parte del pacchetto
address@hidden://www.gnu.org/software/coreutils/coreutils.html,
+GNU Coreutils}), si address@hidden usare tale programma, invece delle
@dfn{pty}.
+
+Si noti anche che le @dfn{pty} non sono completamente trasparenti.
+Alcuni codici di controllo binari, come @kbd{Ctrl-d} per indicare la
+condizione di file-file, sono interpetati dal gestore di @dfn{tty}
+e non sono passati all'applicazione.
+
address@hidden ATTENZIONE
+In ultima analisi, i coprocessi danno adito alla address@hidden di uno
address@hidden (deadlock) tra @command{gawk} e il programma in esecuzione
+nel coprocesso. address@hidden address@hidden succedere se si inviano
``troppi'' dati al
+coprocesso, prima di leggere dati inviati dallo stesso; entrambi i
+processi sono bloccati sulla scrittura dei dati, e nessuno dei due
address@hidden disponibile a leggere quelli che sono address@hidden stati
scritti dall'altro.
+Non c'@`e modo di evitare completamente una tale situazione; occorre una
+programmazione attenta, insieme alla conoscenza del comportamento del
+coprocesso.
address@hidden quotation
+
address@hidden Reti TCP/IP
address@hidden Usare @command{gawk} per la programmazione di rete
address@hidden address@hidden avanzate, programmazione di rete
address@hidden avanzate, address@hidden, programmazione di rete
address@hidden reti, programmazione di
address@hidden TCP/IP
address@hidden @code{/inet/@dots{}}, file speciali (in @command{gawk})
address@hidden file speciali @code{/inet/@dots{}} (in @command{gawk})
address@hidden @code{/inet4/@dots{}}, file speciali (in @command{gawk})
address@hidden file speciali @code{/inet4/@dots{}} (in @command{gawk})
address@hidden @code{/inet6/@dots{}}, file speciali (in @command{gawk})
address@hidden file speciali @code{/inet6/@dots{}} (in @command{gawk})
address@hidden @code{EMRED}
address@hidden
address@hidden
address@hidden:@*
+@ @ @ @ @i{A host is a host from coast to coast,@*
+@ @ @ @ and nobody talks to a host that's close,@*
+@ @ @ @ unless the host that isn't address@hidden
+@ @ @ @ is busy, hung, or dead.}
+
address@hidden:@*
+@ @ @ @ @i{Un computer @`e un computer lontano o vicino,@*
+@ @ @ @ e nessuno parla con un computer vicino,@*
+@ @ @ @ a meno che il computer address@hidden
+@ @ @ @ sia occupato, fuori linea, o spento.}
address@hidden Mike O'Brien (noto anche come Mr.@: Protocol)
address@hidden quotation
address@hidden ifnotdocbook
+
address@hidden
+<blockquote>
+<attribution>Mike O'Brien (aka Mr. Protocol)</attribution>
+<literallayout class="normal"><literal>EMRED</literal>:
+ <emphasis>A host is a host from coast to
coast,</emphasis>
+ <emphasis>and no-one can talk to host that's
close,</emphasis>
+ <emphasis>unless the host that isn't close</emphasis>
+ <emphasis>is busy, hung, or
dead.</emphasis></literallayout>
+</blockquote>
address@hidden docbook
+
+Oltre a poter aprire una @dfn{pipeline} bidirezionale verso un coprocesso
+sullo stesso sistema
+(@pxref{I/O bidirezionale}),
address@hidden possibile attivare una connessione bidirezionale verso un altro
processo
+o verso un altro sistema attraverso una connessione di rete IP.
+
+Si address@hidden pensare a questo semplicemente come a una @dfn{pipeline}
bidirezionale
address@hidden lunga} verso un coprocesso.
+Il modo in cui @command{gawk} stabilisce quando usare una rete TCP/IP @`e
+mediante il riconoscimento di speciali @value{FNS} che iniziano con
address@hidden/inet/}, con @samp{/inet4/} o con @samp{/inet6/}.
+
+La sintassi completa del @value{FN} speciale @`e
address@hidden/@var{tipo-rete}/@var{protocollo}/@var{porta-locale}/@var{host-remoto}/@var{porta-remota}}.
+I componenti sono:
+
address@hidden @var
address@hidden tipo-rete
+Specifica il tipo di connessione a internet da stabilire.
+Si usa @samp{/inet4/} per usare solo IPv4, e
address@hidden/inet6/} per usare solo IPv6.
+Il semplice @samp{/inet/} (che usualmente @`e l'unica opzione) usa
+il tipo di default del sistema, quasi certamente IPv4.
+
address@hidden protocollo
+Il protocollo da usare sull'IP. Questo dev'essere o @samp{tcp} o
address@hidden, per una connessione IP rispettivamente TCP o UDP.
+TCP dovrebbe venir usato per la maggior parte delle applicazioni.
+
address@hidden porta-locale
address@hidden @code{getaddrinfo()}, funzione (libreria C)
address@hidden funzione @code{getaddrinfo()} (libreria C)
+Il numero di porta TCP o UDP da usare. Si usa un numero di porta di valore
address@hidden quando si vuole che sia il sistema a scegliere una porta.
+Questo @`e quel che si dovrebbe fare quando si scrive un'applicazione
+cliente TCP o UDP.
+Si address@hidden usare anche un nome di un servizio noto, come @samp{smtp}
+o @samp{http}, nel qual caso @command{gawk} tenta di determinare
+il numero di porta predefinito usando la funzione C @code{getaddrinfo()}.
+
address@hidden host-remoto
+L'indirizzo IP o il nome di dominio completamente qualificato dell'host
+internet al quale ci si vuol connettere.
+
address@hidden porta-remota
+Il numero di porta TCP o UDP da usare sul particolare @var{host remoto}.
+Anche in questo caso, si usi @samp{0} se non ci sono preferenze,
+o alternativamente, un nome di servizio comunemente noto.
address@hidden table
+
address@hidden @command{gawk}, variabile @code{ERRNO} in
address@hidden @code{ERRNO}, variabile
address@hidden variabile @code{ERRNO}
address@hidden NOTA
+Un insuccesso nell'apertura di un socket bidirezionale address@hidden luogo
alla
+segnalazione di un errore non fatale al codice chiamante.
+Il valore di @code{ERRNO} indica l'errore (@pxref{Variabili auto-assegnate}).
address@hidden quotation
+
+Si consideri il seguente esempio molto semplice:
+
address@hidden
+BEGIN @{
+ Servizio = "/inet/tcp/0/localhost/daytime"
+ Servizio |& getline
+ print $0
+ close(Servizio)
address@hidden
address@hidden example
+
+Questo programma legge la data e l'ora corrente dal server @code{daytime}
+TCP del sistema locale.
+Stampa poi il risultato e chiude la connessione.
+
+Poich@'e questo tema @`e molto ampio, l'uso di @command{gawk} per
+la programmazione TCP/IP viene documentato separatamente.
address@hidden
+Si veda
address@hidden, , General Introduction, gawkinet, @value{GAWKINETTITLE}},
address@hidden ifinfo
address@hidden
+Si veda
address@hidden://www.gnu.org/software/gawk/manual/gawkinet/,
address@hidden@value{GAWKINETTITLE}}},
+che fa parte della distribuzione @command{gawk},
address@hidden ifnotinfo
+per una introduzione e trattazione molto address@hidden completa e con molti
+esempi.
+
address@hidden NOTA
address@hidden address@hidden aprire solo socket diretti. Al momento non c'@`e
alcun modo
+per accedere ai servizi disponibili su Secure Socket Layer
+(SSL); questo comprende qualsiasi servizio web il cui URL inizia con
address@hidden://}.
address@hidden quotation
+
+
address@hidden Profilare
address@hidden Profilare i propri programmi @command{awk}
address@hidden @command{awk}, programmi, profilare
address@hidden profilare programmi @command{awk}
address@hidden @code{awkprof.out}, file
address@hidden file @code{awkprof.out}
+
address@hidden possibile tener traccia dell'esecuzione dei propri programmi
@command{awk}.
address@hidden si address@hidden fare passando l'opzione @option{--profile} a
@command{gawk}.
+Al termine dell'esecuzione, @command{gawk} crea un profilo del programma in un
+file chiamato @file{awkprof.out}. A causa dell'address@hidden di profilazione
+l'esecuzione del programma @`e address@hidden lenta fino al 45% rispetto al
normale.
+
address@hidden @option{--profile}, opzione
address@hidden opzione @option{--profile}
+Come mostrato nel seguente esempio,
+l'opzione @option{--profile} address@hidden essere usata per cambiare il nome
del file
+su cui @command{gawk} address@hidden il profilo:
+
address@hidden
+gawk --profile=mioprog.prof -f mioprog.awk dati1 dati2
address@hidden example
+
address@hidden
+Nell'esempio precedente, @command{gawk} mette il profilo in
address@hidden anzich@'e in @file{awkprof.out}.
+
+Vediamo ora una sessione d'esempio che mostra un semplice programma
address@hidden, i suoi dati in input, e il risultato dell'esecuzione di
address@hidden con l'opzione @option{--profile}. Innanzitutto, il
+programma @command{awk}:
+
address@hidden
+BEGIN @{ print "Prima regola BEGIN" @}
+
+END @{ print "Prima regola END" @}
+
+/pippo/ @{
+ print "trovato /pippo/, perbacco"
+ for (i = 1; i <= 3; i++)
+ sing()
address@hidden
+
address@hidden
+ if (/pippo/)
+ print "l'if @`e vero"
+ else
+ print "l'else @`e vero"
address@hidden
+
+BEGIN @{ print "Seconda regola BEGIN" @}
+
+END @{ print "Seconda regola END" @}
+
+function sing( ignora)
address@hidden
+ print "Devo essere io!"
address@hidden
address@hidden example
+
+Questi sono i dati in input:
+
address@hidden
+pippo
+pluto
+paperino
+pippo
+cianfrusaglie
address@hidden example
+
+E questo @`e il file @file{awkprof.out} che @`e il risultato dell'esecuzione
+del profilatore di @command{gawk} su questo programma e sui dati (quest'esempio
+dimostra anche che i programmatori di @command{awk} a volte si alzano molto
+presto al mattino per lavorare):
+
address@hidden @code{BEGIN}, criterio di ricerca, e profilatura
address@hidden criterio di ricerca @code{BEGIN}, e profilatura
address@hidden @code{END}, criterio di ricerca, e profilatura
address@hidden criterio di ricerca @code{END}, e profilatura
address@hidden
+ # profilo gawk, creato Mon Sep 29 05:16:21 2014
+
+ # BEGIN regola(e)
+
+ BEGIN @{
+ 1 print "Prima regola BEGIN"
+ @}
+
+ BEGIN @{
+ 1 print "Seconda regola BEGIN"
+ @}
+
+ # Regola(e)
+
+ 5 /pippo/ @{ # 2
+ 2 print "trovato /pippo/, perbacco"
+ 6 for (i = 1; i <= 3; i++) @{
+ 6 sing()
+ @}
+ @}
+
+ 5 @{
+ 5 if (/pippo/) @{ # 2
+ 2 print "l'if @`e vero"
+ 3 @} else @{
+ 3 print "l'else @`e vero"
+ @}
+ @}
+
+ # END regola(e)
+
+ END @{
+ 1 print "Prima regola END"
+ @}
+
+ END @{
+ 1 print "Seconda regola END"
+ @}
+
+
+ # Funzioni, in ordine alfabetico
+
+ 6 function sing(ignora)
+ @{
+ 6 print "Devo essere io!"
+ @}
address@hidden example
+
+Quest'esempio illustra molte caratteristiche fondamentali dell'output
+della profilazione.
+Queste sono:
+
address@hidden @value{BULLET}
address@hidden
+Il programma viene stampato nell'ordine: regole @code{BEGIN},
+regole @code{BEGINFILE},
+regole criterio di ricerca--azione,
+regole @code{ENDFILE}, regole @code{END}, e funzioni, elencate
+in ordine alfabetico.
+Le regole @code{BEGIN} ed @code{END} multiple conservano le loro
+distinte address@hidden, address@hidden@dotless{i}} come le regole
@code{BEGINFILE} ed @code{ENDFILE}
+multiple.
+
address@hidden criteri di ricerca, conteggi, in un profilo
address@hidden
+Le regole criterio di ricerca--azione hanno due conteggi.
+Il primo conteggio, a sinistra della regola, mostra quante volte
+il criterio di ricerca della regola @`e stato @emph{testato}.
+Il secondo conteggio, alla destra della parentesi graffa aperta,
+all'interno di un commento,
+mostra quante volte l'azione della regola @`e stata @emph{eseguita}.
+La differenza tra i due indica quante volte il criterio di ricerca della regola
address@hidden stato valutato come falso.
+
address@hidden
+Analogamente,
+il conteggio per un'istruzione @address@hidden mostra quante volte
+la condizione @`e stata testata.
+Alla destra della parentesi graffa sinistra aperta per il corpo di @code{if}
+c'@`e un conteggio che mostra quante volte la condizione @`e stata trovata
vera.
+Il conteggio per @code{else} indica
+quante volte la verifica non ha avuto successo.
+
address@hidden cicli, conteggi per l'intestazione, in un profilo
address@hidden
+Il conteggio per un ciclo (come @code{for}
+o @code{while}) mostra quante volte il test del ciclo @`e stato eseguito.
+(Per questo motivo, non si address@hidden solamente guardare il conteggio
sulla prima
+istruzione in una regola per determinare quante volte la regola @`e stata
+eseguita. Se la prima istruzione @`e un ciclo, il conteggio @`e ingannevole.)
+
address@hidden funzioni definite dall'utente, conteggi, in un profilo
address@hidden definite dall'utente, funzioni, conteggi, in un profilo
address@hidden
+Per le funzioni definite dall'utente, il conteggio vicino alla parola chiave
address@hidden indica quante volte la funzione @`e stata chiamata.
+I conteggi vicino alle istruzioni nel corpo mostrano quante volte
+quelle istruzioni sono state eseguite.
+
address@hidden @address@hidden@}} (parentesi graffe)
address@hidden parentesi graffe (@address@hidden@}})
address@hidden
+L'impaginazione usa lo stile ``K&R'' con le tabulazioni.
+Le parentesi graffe sono usate dappertutto, anche dove il corpo di un
address@hidden, di un @code{else} o di un ciclo @`e formato da un'unica
istruzione.
+
address@hidden @code{()} (parentesi), in un profilo
address@hidden parentesi (@code{()}), in un profilo
address@hidden
+Le parentesi vengono usate solo dov'@`e necessario, come si rileva dalla
+struttura del programma e dalle regole di precedenza.
+Per esempio, @samp{(3 + 5) * 4} significa sommare tre e cinque, quindi
+moltiplicare il totale per quattro. Di contro, @samp{3 + 5 * 4} non ha
+parentesi, e significa @samp{3 + (5 * 4)}.
+
address@hidden
address@hidden
+All string concatenations are parenthesized too.
+(This could be made a bit smarter.)
address@hidden ignore
+
address@hidden
+Le parentesi vengono usate attorno agli argomenti di @code{print}
+e @code{printf} solo quando l'istruzione
address@hidden o @code{printf} @`e seguita da una ridirezione.
+Similarmente, se
+l'oggetto di una ridirezione non @`e uno scalare, viene messo tra parentesi.
+
address@hidden
address@hidden mette dei commenti iniziali
+davanti alle regole @code{BEGIN} ed @code{END},
+alle regole @code{BEGINFILE} ed @code{ENDFILE},
+alle regole criterio_di_ricerca--azione e alle funzioni.
+
address@hidden itemize
+
+La versione profilata del proprio programma potrebbe non apparire esattamente
+come quella scritta durante la stesura del programma. Questo perch@'e
address@hidden crea la versione profilata facendo una ``stampa elegante'' della
+sua rappresentazione interna del programma. Un vantaggio di address@hidden
@`e che
address@hidden address@hidden produrre una rappresentazione standard.
+Inoltre, cose come:
+
address@hidden
+/pippo/
address@hidden example
+
address@hidden
+appaiono come:
+
address@hidden
+/pippo/ @{
+ print $0
address@hidden
address@hidden example
+
address@hidden
+che @`e corretto, ma probabilmente inatteso.
+
address@hidden profilare programmi @command{awk}, dinamicamente
address@hidden @command{gawk}, programma, profilazione dinamica
address@hidden profilazione dinamica
+Oltre a creare profili una volta completato il programma,
address@hidden address@hidden generare un profilo mentre @`e in esecuzione.
+Questo @`e utile se il proprio programma @command{awk} entra in un ciclo
+infinito e si vuol vedere cosa @`e stato eseguito.
+Per usare questa address@hidden, bisogna eseguire @command{gawk} con l'opzione
address@hidden in background:
+
address@hidden
+$ @kbd{gawk --profile -f mioprog &}
+[1] 13992
address@hidden example
+
address@hidden @command{kill}, address@hidden profilazione dinamica e
address@hidden comando @address@hidden profilazione dinamica e
address@hidden @code{USR1}, segnale, per profilazione dinamica
address@hidden @code{SIGUSR1}, segnale, per profilazione dinamica
address@hidden segnali @code{USR1}/@code{SIGUSR1}, per profilazione
address@hidden
+La shell stampa un numero di job e il numero di ID del relativo processo;
+in questo caso, 13992. Si usi il comando @command{kill} per inviare il
+segnale @code{USR1} a @command{gawk}:
+
address@hidden
+$ @kbd{kill -USR1 13992}
address@hidden example
+
address@hidden
+Come al solito, la versione profilata del programma @`e scritta nel file
address@hidden, o in un file differente se ne viene specificato uno
+con l'opzione @option{--profile}.
+
+Assieme al profilo regolare, come mostrato in precedenza, il file del profilo
+include una traccia di ogni funzione attiva:
+
address@hidden
+# `Stack' (Pila) Chiamate Funzione:
+
+# 3. paperino
+# 2. pluto
+# 1. pippo
+# -- main --
address@hidden example
+
+Si address@hidden inviare a @command{gawk} il segnale @code{USR1} quante volte
si vuole.
+Ogni volta, il profilo e la traccia della chiamata alla funzione vengono
+aggiunte in fondo al file di profilo creato.
+
address@hidden @code{HUP}, segnale, per profilazione dinamica
address@hidden @code{SIGHUP}, segnale, per profilazione dinamica
address@hidden segnali @code{HUP}/@code{SIGHUP}, per profilazione
+Se si usa il segnale @code{HUP} invece del segnale @code{USR1}, @command{gawk}
+genera il profilo e la traccia della chiamata alla funzione ed esce.
+
address@hidden @code{INT}, segnale (MS-Windows)
address@hidden @code{SIGINT}, segnale (MS-Windows)
address@hidden segnali @code{INT}/@code{SIGINT} (MS-Windows)
address@hidden @code{QUIT}, segnale (MS-Windows)
address@hidden @code{SIGQUIT}, segnale (MS-Windows)
address@hidden segnali @code{QUIT}/@code{SIGQUIT} (MS-Windows)
+Quando @command{gawk} viene eseguito sui sistemi MS-Windows, usa i segnali
address@hidden e @code{QUIT} per generare il profilo, e nel
+caso del segnale @code{INT}, @command{gawk} esce. Questo perch@'e
+questi sistemi non prevedono il comando @command{kill}, per cui gli unici
+segnali che si possono trasmettere a un programma sono quelli generati dalla
+tastiera. Il segnale @code{INT} @`e generato dalle combinazioni di tasti
address@hidden o @kbd{Ctrl-BREAK}, mentre il segnale
address@hidden @`e generato dalla combinazione di tasti @kbd{Ctrl-\}.
+
+Infine, @command{gawk} accetta anche un'altra opzione, @option{--pretty-print}.
+Quando viene chiamato in questo modo, @command{gawk} fa una ``stampa elegante''
+del programma nel file @file{awkprof.out}, senza conteggi sull'esecuzione.
+
address@hidden NOTA
+Una volta, l'opzione @option{--pretty-print} eseguiva anche il programma.
+Ora non address@hidden
address@hidden quotation
+
+C'@`e una differenza significativa tra l'output creato durante la
profilazione, e
+quello creato durante la stampa elegante. L'output della stampa elegante
+preserva i commenti originali che erano nel programma, anche se la loro
+posizione address@hidden non corrispondere esattamente alle posizioni
originali che
+avevano nel codice address@hidden@command{gawk} fa del suo meglio
+per mantenere la distinzione tra commenti posti dopo delle istruzioni e
+commenti su righe a s@'e stanti. Per limiti insiti nell'implementazione,
+non sempre questo address@hidden avvenire in maniera corretta, in particolare
nel
+caso di istruzioni @code{switch}. I manutentori di @command{gawk}
+sperano di poter migliorare la situazione in una futura versione.}
+
+Comunque, per una precisa scelta progettuale, l'output della profilazione
address@hidden i commenti del programma originale. Questo permette di
+concentrarsi sui dati del conteggio di esecuzione ed evita la tentazione di
+usare il profilatore per creare una stampa elegante.
+
+Oltre a address@hidden, l'output stampato in modo elegante non ha
l'indentazione iniziale
+che ha l'output della profilazione. Questo rende agevole la stampa elegante
+del proprio codice una volta completato lo sviluppo, usando poi il risultato
+come versione finale del programma.
+
+Poich@'e la rappresentazione interna del programma @`e formattata per
+essere aderente al programma @command{awk} in questione, la profilatura
+e la formattazione graziosa (opzione @option{--pretty-print}) disabilitano
+automaticamente le optimizzazioni di default di @command{gawk}.
+
+La formattazione elegante mantiene anche il formato originale delle
+costanti numeriche; se sono stati usati dei valori ottali o esadecimali
+nel codice sorgente, questi compariranno nell'output nello stesso
+formato con cui sono stati inseriti.
+
address@hidden Sommario address@hidden avanzate
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+L'opzione @option{--non-decimal-data} fa address@hidden@dotless{i}} che
@command{gawk} tratti
+i dati di input che hanno l'aspetto ottale ed esadecimale come valori ottali ed
+esadecimali. L'opzione dovrebbe essere usata con prudenza o non usata affatto;
address@hidden preferibile l'uso di @code{strtonum()}.
+Si noti che quest'opzione potrebbe sparire nelle prossime versioni di
address@hidden
+
address@hidden
+Si address@hidden prendere il completo controllo dell'ordinamento nello
scorrere il
+vettore con @samp{for (@var{indice} in @var{vettore})}, impostando
address@hidden"sorted_in"]} al nome di una funzione definita dall'utente che
+fa il confronto tra elementi del vettore basandosi su indice e valore.
+
address@hidden
+Analogamente, si address@hidden fornire il nome di una funzione di confronto
definita
+dall'utente come terzo argomento di @code{asort()} o di @command{asorti()} per
+controllare come queste funzioni ordinano i vettori. O si address@hidden
fornire una delle
+stringhe di controllo predefinite che funzionano per
address@hidden"sorted_in"]}.
+
address@hidden
+Si address@hidden usare l'operatore @samp{|&} per creare una @dfn{pipe}
bidirezionale
+verso un coprocesso. Si legge dal coprocesso con @code{getline}, ci si
+scrive sopra con @code{print} o con @code{printf}. Usare @code{close()}
+per bloccare il coprocesso completamente o, se necessario, chiudere le
+comunicazioni bidirezionali in una direzione.
+
address@hidden
+Usando degli speciali @value{FNS} con l'operatore @samp{|&}, si address@hidden
aprire una
+connessione TCP/IP (o UDP/IP) verso host remoti su internet. @command{gawk}
+supporta sia IPv4 che IPv6.
+
address@hidden
+Si possono generare profili del proprio programma con i conteggi del numero
+di esecuzione di ogni singola
+istruzione. Questo address@hidden essere d'aiuto nel determinare quali parti
del programma
+potrebbero portar via la maggior parte del tempo, consentendo
address@hidden@dotless{i}} di
+aggiustarli address@hidden agevolmente. Inviando il segnale @code{USR1}
durante la
+profilazione @command{gawk} scrive il profilo, includendo la
+stack della chiamata alla funzione e prosegue nell'elaborazione.
+
address@hidden
+Si address@hidden anche fare solo una ``stampa elegante'' del programma.
+
address@hidden itemize
address@hidden Internazionalizzazione
address@hidden Internazionalizzazione con @command{gawk}
+
+Tanto tempo fa i produttori di computer
+scrivevano software che comunicava solo in inglese.
+Col passare del tempo, i venditori di hardware e di software si sono
+resi conto che se i loro sistemi avessero comunicato anche nelle lingue
+materne di paesi dove non si parlava inglese,
address@hidden avrebbe avuto come risultato un incremento delle vendite.
+Per questo motivo, l'internazionalizzazione e la localizzazione
+di programmi e sistemi software @`e divenuta una pratica comune.
+
address@hidden internazionalizzazione, localizzazione
address@hidden @command{gawk}, internazionalizzazione e, si veda
internazionalizzazione
address@hidden internazionalizzazione, localizzazione, @command{gawk} e
+Per molti anni la address@hidden di fornire l'internazionalizzazione
+era sostanzialmente limitata ai programmi scritti in C e C++.
+Questo @value{CHAPTER} descrive la libreria @dfn{ad hoc} utilizzata da
address@hidden
+per l'internazionalizzazione e anche il modo in cui le address@hidden che
+consentono l'internazionalizzazione sono rese disponibili da @command{gawk}
+a ogni programma scritto in @command{awk}.
+La address@hidden dell'internazionalizzazione a livello di programma
address@hidden offre ulteriore address@hidden agli sviluppatori di software:
+non sono address@hidden obbligati a scrivere in C o C++ quando
l'internazionalizzazione
address@hidden necessaria in un programma.
+
address@hidden
+* I18N e L10N:: Internazionalizzazione e localizzazione.
+* Utilizzare @command{gettext}:: Come funziona il comando GNU
@command{gettext}.
+* I18N per programmatore:: address@hidden per il programmatore.
+* I18N per traduttore:: address@hidden per il traduttore.
+* Esempio I18N:: Un semplice esempio di internazionalizzazione.
+* Gawk internazionalizzato:: Anche @command{gawk} @`e internazionalizzato.
+* Sommario I18N:: Sommario dell'internazionalizzazione.
address@hidden menu
+
address@hidden I18N e L10N
address@hidden Internazionalizzazione e localizzazione
+
address@hidden internazionalizzazione di programmi @command{awk}
address@hidden localizzazione, si veda address@hidden localizzazione
address@hidden localizzazione
address@hidden significa scrivere (o modificare) un programma
+una volta sola,
+in maniera tale che possa usare address@hidden di una lingua senza
+bisogno di ulteriori modifiche al file sorgente.
address@hidden
+significa fornire i dati necessari perch@'e un programma
+internazionalizzato sia in grado di funzionare con una data lingua.
+Questi termini si riferiscono comunemente a address@hidden quali la lingua
+usata per stampare messaggi di errore, quella usata per leggere
+risposte, e alle informazioni
+relative al modo di leggere e di stampare dati di tipo numerico o valutario.
+
address@hidden Utilizzare @command{gettext}
address@hidden Il comando GNU @command{gettext}
+
address@hidden internazionalizzare un programma
address@hidden @command{gettext}, libreria
address@hidden libreria @command{gettext}
address@hidden usa il comando GNU @command{gettext} per rendere disponibili
+le proprie address@hidden di internazionalizzazione.
+L'attenzione del comando GNU @command{gettext} @`e rivolta principalmente
+ai messaggi: stringhe di caratteri stampate da un programma, sia
+direttamente sia usando la formattazione prevista dalle istruzioni
address@hidden o @code{sprintf()address@hidden alcuni sistemi operativi,
+la relativa versione di @command{gawk}
+non supporta il comando GNU @command{gettext}.
+Per questo motivo, queste address@hidden non sono disponibili nel caso
+si stia lavorando con uno di questi sistemi operativi. Siamo spiacenti.}
+
address@hidden address@hidden, libreria @command{gettext} e
+Quando si usa il comando GNU @command{gettext}, ogni applicazione ha il
+proprio @dfn{dominio di testo}. Questo @`e un nome unico come,
+p.es., @samp{kpilot} o @samp{gawk},
+che identifica l'applicazione.
+Un'applicazione completa address@hidden avere address@hidden componenti:
programmi scritti
+in C o C++, come pure script di @command{sh} o di @command{awk}.
+Tutti i componenti usano lo stesso dominio di testo.
+
+Per andare sul concreto, si supponga di scrivere un'applicazione
+chiamata @command{guide}. L'internazionalizzazione per quest'applicazione
address@hidden essere implementata seguendo nell'ordine i passi qui delineati:
+
address@hidden
address@hidden
+Il programmatore esamina i sorgenti di tutti i componenti dell'applicazione
address@hidden e prende nota di ogni stringa che potrebbe aver bisogno
+di traduzione.
+Per esempio, @code{"`-F': option required"} @`e una stringa che sicuramente
+necessita di una traduzione.
+Una tabella che contenga stringhe che sono nomi di opzioni @emph{non}
+necessita di traduzione.
+(P.es., l'opzione di @command{gawk} @option{--profile}
+dovrebbe restare immutata, a prescindere dalla lingua locale).
+
address@hidden @code{textdomain()}, funzione (libreria C)
address@hidden funzione @code{textdomain()} (libreria C)
address@hidden
+Il programmatore indica il dominio di testo dell'applicazione
+(@command{"guide"}) alla libreria @command{gettext},
+chiamando la funzione @code{textdomain()}.
+
address@hidden @code{.pot}, file
address@hidden file @code{.pot}
address@hidden @dfn{portable object template} (.pot), file
address@hidden file, @dfn{portable object template} (.pot)
address@hidden
+I messaggi dell'applicazione che vanno tradotti sono estratti dal codice
+sorgente e messi in un file di tipo
address@hidden object template}
+[modello di oggetto portabile]
+di nome @file{guide.pot},
+che elenca le stringhe e le relative traduzioni.
+Le traduzioni sono inizialmente vuote
+(esiste la struttura che definisce la stringa tradotta, ma la stringa
+tradotta @`e una stringa nulla).
+Il messaggio originale (normalmente in inglese) @`e utilizzato come chiave
+di riferimento per le traduzioni.
+
address@hidden @code{.po}, file
address@hidden file @code{.po}
address@hidden @dfn{portable object} file (.po)
address@hidden file, @dfn{portable object} (.po)
address@hidden
+Per ogni lingua per cui sia disponibile un traduttore, il file
address@hidden @`e copiato in un file di tipo
address@hidden object}
+[oggetto portabile]
+(dal suffisso @code{.po})
+e le traduzioni sono effettuate su quel file,
+che viene distribuito con l'applicazione.
+Per esempio, potrebbe esserci un file @file{it.po} per la traduzione italiana.
+
address@hidden @code{.gmo}, file
address@hidden file @code{.gmo}
address@hidden @dfn{message object} file (.mo)
address@hidden file, @dfn{message object} (.mo)
address@hidden
+Il file @file{.po} di ogni lingua @`e convertito in un formato binario,
+detto @dfn{message object} (file @file{.gmo}).
+Un file di tipo @dfn{message object} contiene i messaggi originali e le loro
+traduzioni in un formato binario che facilita il ritrovamento delle
+traduzioni quando l'applicazione viene eseguita.
+
address@hidden
+Quando @command{guide} @`e compilato e installato, i file binari contenenti le
+traduzioni sono installati in una directory standard.
+
address@hidden @code{bindtextdomain()}, funzione (libreria C)
address@hidden funzione @code{bindtextdomain()} (libreria C)
address@hidden
+Durante la fase di prova e sviluppo, @`e possibile chiedere a @command{gettext}
+di usare un file @file{.gmo} in una directory diversa da quella standard,
+usando la funzione @code{bindtextdomain()}.
+
address@hidden @code{.gmo}, file, specificare la directory di
address@hidden file @code{.gmo}, specificare la directory di
address@hidden @dfn{message object} file (.mo), specificare la directory di
address@hidden file, @dfn{message object} (.mo), specificare la directory di
address@hidden
+Quando viene eseguito, il programma @command{awk} @command{guide} cerca ogni
+stringa da tradurre facendo una chiamata a @code{gettext()}. La stringa
+ricevuta in ritorno @`e la stringa tradotta, se @`e stata trovata, o la stringa
+originale, se una traduzione non @`e disponibile.
+
address@hidden
+Se necessario, @`e possibile procurarsi dei messaggi tradotti da un dominio di
+testo diverso da quello proprio dell'applicazione, senza dover altalenare fra
+questo secondo dominio e quello dell'applicazione.
address@hidden enumerate
+
address@hidden @code{gettext()}, funzione (libreria C)
address@hidden funzione @code{gettext()} (libreria C)
+In C (o C++), la marcatura della stringa la ricerca dinamica
+della traduzione si fanno inserendo ogni stringa da tradurre in una chiamata
+a @code{gettext()}:
+
address@hidden
+printf("%s", gettext("Don't Panic!\n"));
address@hidden example
+
+Gli strumenti software che estraggono messaggi dal codice sorgente
+individuano tutte le stringhe racchiuse nelle chiamate a @code{gettext()}.
+
address@hidden @code{_} (trattino basso), macro C
address@hidden trattino basso (@code{_}), macro C
+Gli sviluppatori del comando GNU @command{gettext}, riconoscendo che
+continuare a immettere @samp{gettext(@dots{})} @`e sia faticoso che poco
+elegante da vedere, usano la macro @samp{_} (un trattino basso) per
+facilitare la cosa:
+
address@hidden
+/* Nel file di intestazione standard: */
+#define _(str) gettext(str)
+
+/* Nel testo del programma: */
+printf("%s", _("Don't Panic!\n"));
address@hidden example
+
address@hidden internazionalizzazione, localizzazione, categorie di
localizzazione
address@hidden @command{gettext}, libreria, categorie di localizzazione
address@hidden libreria @command{gettext}, categorie di localizzazione
address@hidden categorie di localizzazione
address@hidden
+Questo permette di ridurre la digitazione extra a solo tre caratteri per
+ogni stringa da tradurre e inoltre migliora di molto la address@hidden
+
+Ci sono @dfn{categorie} di localizzazione per tipi diversi di informazioni
+legate a una particolare localizzazione.
+Le categorie di localizzazione note a @command{gettext} sono:
+
address@hidden @code
address@hidden @code{LC_MESSAGES}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_MESSAGES}
address@hidden LC_MESSAGES
+Testo dei messaggi. Questa @`e la categoria di default usata all'interno di
address@hidden, ma @`e possibile specificarne esplicitamente una differente,
+se necessario. (Questo non @`e quasi mai necessario.)
+
address@hidden ordinare caratteri in lingue differenti
address@hidden @code{LC_COLLATE}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_COLLATE}
address@hidden LC_COLLATE
+Informazioni sull'ordinamento alfabetico (address@hidden, come caratteri
diversi e/o
+gruppi di carattere sono ordinati in un dato linguaggio).
address@hidden ad esempio i vari caratteri accentati in italiano, vanno ordinati
address@hidden insieme alla loro lettera "principale" (e @`e @'e).
+
address@hidden @code{LC_CTYPE}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_CTYPE}
address@hidden LC_CTYPE
+Informazioni sui singoli caratteri (alfabetico, numerico, maiuscolo
+o minuscolo, etc.), come pure sulla codifica dei caratteri.
address@hidden
+In June 2001 Bruno Haible wrote:
+- Description of LC_CTYPE: It determines both
+ 1. character encoding,
+ 2. character type information.
+ (For example, in both KOI8-R and ISO-8859-5 the character type information
+ is the same - cyrillic letters could as 'alpha' - but the encoding is
+ different.)
address@hidden ignore
+Quest'informazione @`e utilizzata per stabilire le classi di caratteri come
+definite nello standard POSIX, nelle espressioni regolari,
+come p. es. @code{/[[:alnum:]]/}
+(@pxref{Espressioni tra parentesi quadre}).
+
address@hidden informazioni di tipo monetario, localizzazione
address@hidden monete, simboli di, nella localizzazione
address@hidden simboli di monete, nella localizzazione
address@hidden monete, rappresentazioni di, nella localizzazione
address@hidden rappresentazioni di monete, nella localizzazione
address@hidden @code{LC_MONETARY}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_MONETARY}
address@hidden LC_MONETARY
+Le informazioni di tipo monetario, quali il simbolo della moneta, e se
+il simbolo va prima o dopo il valore numerico.
+
address@hidden @code{LC_NUMERIC}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_NUMERIC}
address@hidden LC_NUMERIC
+Informazioni di tipo numerico, quali il carattere da usare per separare le
+cifre decimali e quello per separare le address@hidden americani usano
+una virgola ogni tre cifre decimali, e un punto per separare la parte decimale
+di un numero, mentre molti europei (fra cui gli italiani) fanno esattamente
+l'opposto: 1,234.56 invece che 1.234,56.}
+
address@hidden tempo, localizzazione e
address@hidden date, informazioni relative alla localizzazione
address@hidden @code{LC_TIME}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_TIME}
address@hidden LC_TIME
+Informazioni relative alle date e alle ore,
+come l'uso di ore nel formato a 12 ore oppure a 24 ore, il mese stampato
+prima o dopo il giorno in una data, le abbreviazioni dei mesi nella lingua
+locale, e address@hidden@dotless{i}} via.
+
address@hidden @code{LC_ALL}, categoria di localizzazione
address@hidden categoria di localizzazione @code{LC_ALL}
address@hidden LC_ALL
+Tutte le categorie viste sopra. (Non molto utile nel contesto del comando
address@hidden)
address@hidden table
+
address@hidden NOTA
address@hidden @env{LANGUAGE}, variabile d'ambiente
address@hidden variabile d'ambiente @env{LANGUAGE}
+Come descritto in @ref{Localizzazioni}, le variabili d'ambiente
+che hanno lo stesso nome delle categorie di localizzazione
+(@env{LC_CTYPE}, @env{LC_ALL}, etc.) influenzano il comportamento di
address@hidden (e quello di altri programmi di address@hidden).
+
+Solitamente, queste variabili influenzano anche il modo con cui
+la libreria @code{gettext} trova le traduzioni. Tuttavia, la
+variabile d'ambiente @env{LANGUAGE} prevale sulle variabili
+della famiglia @address@hidden Molti sistemi GNU/Linux possono
+aver definito questa variabile senza esplicitamente notificarlo
+all'utente, e questo potrebbe far address@hidden@dotless{i}} che
@command{gawk} non riesca a
+trovare le traduzioni corrette. Se si incontra questa situazione,
+occorre controllare se la variabile d'ambiente @env{LANGUAGE} @`e
+definita, e, in questo caso, va usato il comando @command{unset}
+per rimuoverla.
address@hidden quotation
+
+Per il test di traduzioni dei messaggi inviati da @command{gawk} stesso, si
address@hidden
+impostare la variabile d'ambiente @env{GAWK_LOCALE_DIR}. Si veda la
+documentazione per la funzione C @code{bindtextdomain()}, e si veda anche
address@hidden variabili d'ambiente}.
+
address@hidden I18N per programmatore
address@hidden Internazionalizzare programmi @command{awk}
address@hidden programmi @command{awk}, internazionalizzare
address@hidden internazionalizzazione di programmi @command{awk}
+
address@hidden prevede le seguenti variabili per l'internazionalizzazione:
+
address@hidden @code
address@hidden @code{TEXTDOMAIN}, variabile
address@hidden variabile @code{TEXTDOMAIN}
address@hidden TEXTDOMAIN
+Questa variabile indica il dominio di testo dell'applicazione.
+Per address@hidden con il comando GNU @command{gettext}, il valore di default
address@hidden @code{"messages"}.
+
address@hidden internazionalizzazione, localizzazione, stringhe marcate
address@hidden stringhe, marcare per localizzazione
address@hidden _"questo @`e un messaggio da tradurre"
+Costanti di tipo stringa marcate con un trattino basso iniziale
+sono candidate per essere tradotte al momento dell'esecuzione del
+programma @command{gawk}.
+Costanti di tipo stringa non precedute da un trattino basso non
+verranno tradotte.
address@hidden table
+
address@hidden fornisce le seguenti funzioni al servizio
+dell'internazionalizzazione:
+
address@hidden @code
address@hidden
address@hidden @code{dcgettext(@var{string}} address@hidden,} @var{dominio}
address@hidden,} @address@hidden)}
+Restituisce la traduzione di @var{stringa} nel
+dominio di testo @var{dominio} per la categoria di localizzazione
@var{categoria}.
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
+
+Se si assegna un valore a @var{categoria}, dev'essere una stringa uguale a
+una delle categorie di localizzazione note, descritte
address@hidden
+nella precedente @value{SECTION}.
address@hidden ifnotinfo
address@hidden
address@hidden @command{gettext}}.
address@hidden ifinfo
+Si deve anche specificare un dominio di testo. Si usi @code{TEXTDOMAIN} se
+si desidera usare il dominio corrente.
+
address@hidden ATTENZIONE
+L'ordine degli argomenti per la versione @command{awk}
+della funzione @code{dcgettext()} @`e differente, per una scelta di progetto,
+dall'ordine degli argomenti passati alla funzione C che ha lo stesso nome.
+L'ordine della versione @command{awk} @`e stato scelto per amore di
address@hidden e per consentire di avere dei valori di default per gli
+argomenti che fossero il address@hidden possibile simili, come stile, a quello
di
address@hidden
address@hidden quotation
+
address@hidden
address@hidden @code{dcngettext(@var{stringa1}, @var{stringa2}, @var{numero}}
address@hidden,} @var{dominio} address@hidden,} @address@hidden)}
+Restituisce la forma, singolare o plurale, da usare a seconda del valore
+di @var{numero} per la
+traduzione di @var{stringa1} e @var{stringa2} nel dominio di testo
address@hidden per la categoria di localizzazione @var{categoria}.
address@hidden @`e la variante al singolare in inglese di un messaggio,
+e @var{stringa2} @`e la variante al plurale in inglese dello stesso messaggio.
+Il valore di default per @var{dominio} @`e il valore corrente di
@code{TEXTDOMAIN}.
+Il valore di default per @var{categoria} @`e @code{"LC_MESSAGES"}.
+
+Valgono le stesse osservazioni riguardo all'ordine degli argomenti
+fatte a proposito della funzione @code{dcgettext()}.
+
address@hidden @code{.gmo}, file, specificare la directory di
address@hidden file @code{.gmo}, specificare la directory di
address@hidden @dfn{message object} file (.mo), specificare la directory di
address@hidden file, @dfn{message object} (.mo), specificare la directory di
address@hidden
address@hidden @code{bindtextdomain(@var{directory}} address@hidden,}
@var{dominio} address@hidden)}
+Cambia la directory nella quale
address@hidden va a cercare i file @file{.gmo}, per il caso in cui questi
+non possano risiedere nelle posizioni standard
+(p.es., in fase di test).
+Restituisce la directory alla quale @var{dominio} @`e ``collegato''.
+
+Il @var{dominio} di default @`e il valore di @code{TEXTDOMAIN}.
+Se l'argomento @var{directory} @`e impostato alla stringa nulla (@code{""}),
address@hidden()} restituisce il collegamento corrente applicabile
+al @var{dominio} specificato.
address@hidden table
+
+Per usare queste address@hidden in un programma @command{awk},
+va seguita la procedura qui indicata:
+
address@hidden
address@hidden @code{BEGIN}, criterio di ricerca, variabile @code{TEXTDOMAIN} e
address@hidden criterio di ricerca @code{BEGIN}, variabile @code{TEXTDOMAIN} e
address@hidden @code{TEXTDOMAIN}, variabile, criterio di ricerca @code{BEGIN} e
address@hidden variabile @code{TEXTDOMAIN}, criterio di ricerca @code{BEGIN} e
address@hidden
+Impostare la variabile @code{TEXTDOMAIN} al dominio di testo del
+programma. @`E meglio fare address@hidden all'interno di una regola
@code{BEGIN}
+(@pxref{BEGIN/END}),
+ma si address@hidden anche fare dalla riga di comando, usando l'opzione
@option{-v}
+(@pxref{Opzioni}):
+
address@hidden
+BEGIN @{
+ TEXTDOMAIN = "guide"
+ @dots{}
address@hidden
address@hidden example
+
address@hidden @code{_} (trattino basso), stringa traducibile
address@hidden trattino basso (@code{_}), stringa traducibile
address@hidden
+Marcare tutte le stringhe traducibili anteponendo loro un
+trattino basso (@samp{_}). Il trattino @emph{deve} essere adiacente ai
+doppi apici di apertura della stringa. Per esempio:
+
address@hidden
+print _"hello, world"
+x = _"you goofed"
+printf(_"Number of users is %d\n", nusers)
address@hidden example
+
address@hidden
+Se le stringhe da visualizzare sono create dinamicamente, @`e ancora possibile
+tradurle, usando la funzione predefinita @code{dcgettext()}:@footnote{I miei
+ringraziamenti a Bruno Haible per questo esempio.}
+
address@hidden
+if (assonnato)
+ messaggio = dcgettext("%d clienti mi scocciano\n", "adminprog")
+else
+ messaggio = dcgettext("mi diverto con %d clienti\n", "adminprog")
+printf(messaggio, numero_clienti)
address@hidden example
+
+In questo esempio, la chiamata a @code{dcgettext()} specifica un diverso
+dominio di testo (@code{"adminprog"}) in cui trovare il
+messaggio, ma usa la categoria di default @code{"LC_MESSAGES"}.
+
+Il precedente esempio funziona solo se @code{numero_clienti} @`e un numero
maggiore
+di uno.
+Per questo esempio sarebbe address@hidden appropriato usare la funzione
@code{dcngettext()}:
+
address@hidden
+if (assonnato)
+ messaggio = dcngettext("%d cliente mi scoccia\n",
+ "%d clienti mi scocciano\n",
+ numero_clienti, "adminprog")
+else
+ messaggio = dcngettext("mi diverto con %d cliente\n",
+ "mi diverto con %d clienti\n",
+ numero_clienti, "adminprog")
+printf(messaggio, numero_clienti)
address@hidden example
+
+
address@hidden @code{LC_MESSAGES}, categoria di localizzazione, funzione
@code{bindtextdomain()} di (@command{gawk})
address@hidden
+In fase di sviluppo, si address@hidden scegliere di tenere il file @file{.gmo}
+in una directory a parte, solo per provarlo. address@hidden si fa
+con la funzione predefinita @code{bindtextdomain()}:
+
address@hidden
+BEGIN @{
+ TEXTDOMAIN = "guide" # dominio di testo regolare
+ if (Testing) @{
+ # dove trovare il file in prova
+ bindtextdomain("testdir")
+ # joe si occupa del programma adminprog
+ bindtextdomain("../joe/testdir", "adminprog")
+ @}
+ @dots{}
address@hidden
address@hidden example
+
address@hidden enumerate
+
address@hidden I18N}
+per un programma di esempio che illustra i passi da seguire per creare
+e usare traduzioni nei programmi @command{awk}.
+
address@hidden I18N per traduttore
address@hidden Traduzione dei programmi @command{awk}
+
address@hidden @code{.po}, file
address@hidden file @code{.po}
address@hidden @dfn{portable object} file (.po)
address@hidden file, @dfn{portable object} (.po)
+Dopo aver marcato le stringhe che si desidera tradurre in un programma,
+queste vanno estratte per creare il file iniziale @file{.pot}.
+Durante la traduzione, @`e spesso utile modificare l'ordine nel quale
+gli argomenti passati a @code{printf} vengono stampati.
+
+L'opzione da riga di comando @option{--gen-pot} di @command{gawk} serve a
+estrarre i messaggi, ed @`e esposta qui di seguito.
+Dopo di che, address@hidden illustrata la address@hidden di modificare l'ordine
+in cui l'istruzione @code{printf} stampa gli argomenti che le sono passati
+in fase di esecuzione.
+
address@hidden
+* Estrazione di stringhe:: Estrarre stringhe marcate.
+* Ordinamento di printf:: Riordinare argomenti @code{printf}
+* address@hidden nell'I18N:: Problemi di address@hidden a livello di
@command{awk}.
address@hidden menu
+
address@hidden Estrazione di stringhe
address@hidden Estrarre stringhe marcate
address@hidden stringhe, estrazione di
address@hidden stringhe marcate, estrazione di
address@hidden @option{--gen-pot}, opzione
address@hidden opzione @option{--gen-pot}
address@hidden opzioni sulla riga di comando, estrazione stringhe
address@hidden riga di comando, opzioni, estrazione stringhe
address@hidden stringhe marcate, estrazione di (internazionalizzazione)
address@hidden marcate, estrazione di stringhe (internazionalizzazione)
address@hidden estrazione di stringhe marcate (internazionalizzazione)
+
address@hidden @option{--gen-pot}, opzione
address@hidden opzione @option{--gen-pot}
+Una volta che il programma @command{awk} funziona, e tutte le stringhe
+sono state marcate ed @`e stato impostato (e forse fissato) il dominio di
+testo, @`e ora di preparare le traduzioni.
+Per prima cosa, usando l'opzione di riga di comando @option{--gen-pot},
+si crea il file iniziale @file{.pot}:
+
address@hidden
+gawk --gen-pot -f guide.awk > guide.pot
address@hidden example
+
address@hidden @code{xgettext}, programma di address@hidden
address@hidden programma di address@hidden @code{xgettext}
+Quando viene chiamato specificando @option{--gen-pot}, @command{gawk} non
+esegue il programma. Il programma viene esaminato come al solito, e tutte
+le stringhe che sono state marcate per essere tradotte vengono scritte nello
+standard output, nel formato di un file Portable Object di GNU
address@hidden
+L'output comprende anche quelle stringhe costanti che appaiono come primo
+argomento della funzione @code{dcgettext()} o come primo e secondo
+argomento della funzione @code{dcngettext()address@hidden comando di
address@hidden
address@hidden che fa parte del pacchetto distribuito come
address@hidden @`e in grado di gestire i file di tipo @file{.awk}.}
+Il file @file{.pot} address@hidden@dotless{i}} generato
+andrebbe distribuito insieme al programma @command{awk}; i traduttori
+potranno eventualmente utilizzarlo per preparare delle traduzioni, le quali
+potranno a loro volta essere distribuite.
address@hidden I18N}
+per una lista esauriente dei passi necessari per creare e testare
+traduzioni per il programma @command{guide}.
+
address@hidden Ordinamento di printf
address@hidden Riordinare argomenti di @code{printf}
+
address@hidden @code{printf}, istruzione, specificatori di posizione
address@hidden istruzione @code{printf}, specificatori posizionali
address@hidden posizionali, specificatori, istruzione @code{printf}
address@hidden specificatori posizionali, istruzione @code{printf}
+Le stringhe di formattazione per @code{printf} e @code{sprintf()}
+(@pxref{Printf})
+hanno un problema speciale con le traduzioni.
+Si consideri il seguente esempio:@footnote{Questo esempio @`e preso in
+prestito dal manuale del comando GNU @command{gettext}.}
+
address@hidden
+printf(_"String `%s' has %d characters\n",
+ string, length(string)))
address@hidden example
+
+Una possibile traduzione in italiano di questo messaggio potrebbe essere:
+
address@hidden
+"%d @`e la lunghezza della stringa `%s'\n"
address@hidden example
+
+Il problema dovrebbe essere ovvio: l'ordine delle specifiche di
+formattazione @`e differente da quello originale!
address@hidden()}, che pure address@hidden restituire la stringa tradotta
+in fase di esecuzione, non @`e in grado di cambiare l'ordine degli argomenti
+nella chiamata a @code{printf}.
+
+Per risolvere questo problema, gli specificatori di formato di @code{printf}
+possono avere un elemento in address@hidden, facoltativo, detto
@dfn{specificatore
+posizionale}. Per esempio:
+
address@hidden
+"%2$d @`e la lunghezza della stringa `%1$s'\n"
address@hidden example
+
+Qui, lo specificatore posizionale consiste in un numero intero, che indica
+quale argomento utilizzare, seguito da un carattere @samp{$}.
+I numeri partono da uno, e la stringa di formattazione vera e propria
address@hidden @`e inclusa. Quindi, nell'esempio seguente, @samp{stringa} @`e
+il primo argomento e @samp{length(stringa)} @`e il secondo:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{stringa = "Non v\47allarmate!"}
+> @kbd{printf "%2$d caratteri compongono \"%1$s\"\n",}
+> @kbd{stringa, length(stringa)}
+> @address@hidden'}
address@hidden 16 caratteri compongono "Non v\47allarmate!"
address@hidden example
+
+Se presenti, gli specificatori posizionali precedono, nella specifica di
+formato, i flag, la larghezza del campo e/o la precisione.
+
+Gli specificatori posizionali possono essere usati anche se si specifica una
+larghezza dinamica dei campi, e della address@hidden di precisione:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{printf("%*.*s\n", 10, 20, "hello")}
+> @kbd{printf("%3$*2$.*1$s\n", 20, 10, "hello")}
+> @address@hidden'}
address@hidden hello
address@hidden hello
address@hidden example
+
address@hidden NOTA
+Se si usa @samp{*} con uno specificatore posizionale, il carattere @samp{*}
+viene per primo, seguito dal numero che indica la posizione, a sua volta
+seguito dal @samp{$}.
address@hidden address@hidden parere poco intuitivo.
address@hidden quotation
+
address@hidden istruzione @code{printf}, specificatori posizionali, frammisti a
formati standard
address@hidden @code{printf}, istruzione, specificatori posizionali, frammisti
a formati standard
address@hidden specificatori posizionali, istruzione @code{printf}, frammisti a
formati standard
address@hidden formato, specificatori di, frammisti a specificatori posizionali
non standard
address@hidden specificatori di formato, frammisti a specificatori posizionali
non standard
address@hidden non consente di mischiare specificatori di formato standard
+con altri contenenti degli specificatori posizionali in una stessa stringa di
+formato:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ printf "%d %3$s\n", 1, 2, "ciao" @}'}
address@hidden gawk: riga com.:1: fatale: `count$' va usato per tutti
address@hidden i formati o per nessuno
address@hidden example
+
address@hidden NOTA
+Ci sono alcuni casi patologici in cui @command{gawk} potrebbe non inviare
+alcun messaggio diagnostico, anche quando sarebbe necessario.
+In tali casi, l'output address@hidden non essere quello atteso.
+Rimane sempre una pessima idea quella di tentare di mischiare i formati,
+anche se @command{gawk} non riesce ad accorgersene.
address@hidden quotation
+
+Sebbene gli specificatori posizionali possano essere usati direttamente nei
+programmi @command{awk}, il motivo per cui sono stati introdotti @`e perch@'e
+siano d'aiuto nel produrre traduzioni corrette della stringa di
+formattazione in lingue differenti da quella nella quale il programma @`e stato
+originariamente scritto.
+
address@hidden address@hidden nell'I18N
address@hidden Problemi di address@hidden a livello di @command{awk}
+
address@hidden address@hidden, internazionalizzazione e
address@hidden internazionalizzazione, localizzazione, address@hidden e
+Le address@hidden di internazionalizzazione di @command{gawk} sono state
+appositamente implementate per avere il minimo impatto possibile sulla
address@hidden, verso altre versioni di @command{awk}, dei programmi
address@hidden che ne fanno uso.
+Si consideri questo programma:
+
address@hidden
+BEGIN @{
+ TEXTDOMAIN = "guide"
+ if (Test_Guide) # da impostare tramite -v
+ bindtextdomain("/test/guide/messages")
+ print _"don't panic!"
address@hidden
address@hidden example
+
address@hidden
+Per il modo in cui @`e scritto, non address@hidden con altre versioni di
address@hidden
+Tuttavia, @`e in address@hidden quasi portabile, e richiede modifiche minime:
+
address@hidden @value{BULLET}
address@hidden @code{TEXTDOMAIN}, variabile, address@hidden e
address@hidden variabile @code{TEXTDOMAIN}, address@hidden e
address@hidden
+Le assegnazioni di valori a @code{TEXTDOMAIN} non avranno effetto alcuno,
+perch@'e @code{TEXTDOMAIN} non @`e una variabile speciale in altre
+implementazioni di @command{awk}.
+
address@hidden
+Versioni Non-GNU di @command{awk} considerano le stringhe marcate
+come la concatenazione di una variabile di nome @code{_} con la stringa che
+viene subito address@hidden @`e
+un buon materiale per una gara di address@hidden @command{awk}''.}
+Tipicamente, la variabile @code{_} ha come valore la stringa nulla
+(@code{""}), il che produce come risultato la stringa
+originale.
+
address@hidden
+Definendo delle funzioni ``fittizie'' per sostituire @code{dcgettext()},
address@hidden()} e @code{bindtextdomain()}, il programma @command{awk}
address@hidden essere reso eseguibile, ma
+tutti i messaggi verranno inviati nella lingua originale del programma.
+Per esempio:
+
address@hidden @code{bindtextdomain()}, funzione (@command{gawk}),
address@hidden e
address@hidden funzione @code{bindtextdomain()} (@command{gawk}),
address@hidden e
address@hidden @code{dcgettext()}, funzione (@command{gawk}), address@hidden e
address@hidden funzione @code{dcgettext()} (@command{gawk}), address@hidden e
address@hidden @code{dcngettext()}, funzione (@command{gawk}), address@hidden e
address@hidden funzione @code{dcngettext()} (@command{gawk}), address@hidden e
address@hidden
address@hidden file eg/lib/libintl.awk
+function bindtextdomain(dir, domain)
address@hidden
+ return dir
address@hidden
+
+function dcgettext(string, domain, category)
address@hidden
+ return string
address@hidden
+
+function dcngettext(string1, string2, number, domain, category)
address@hidden
+ return (number == 1 ? string1 : string2)
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+L'uso di specificazioni posizionali in @code{printf} o
address@hidden()} @emph{non} @`e portabile.
+Per supportare @code{gettext()} nella programmazione in linguaggio C,
+molte versioni C di @code{sprintf()} supportano specificatori posizionali.
+Ma la cosa funziona solo se nella chiamata di funzione sono stati specificati
+argomenti a sufficienza. Molte
+versioni di @command{awk} passano i formati e gli argomenti di @code{printf},
+senza modificarli, alla funzione di libreria in linguaggio C @code{sprintf()},
+ma solo un formato e un argomento alla volta. Quel che succede se si usa una
+specificazione posizionale resta indeterminato.
+Tuttavia, poich@'e le specificazioni posizionali sono usate principalmente
+per le stringhe di formattazione @emph{tradotte}, e poich@'e le versioni
+non-GNU di @command{awk} non utilizzano mai le stringhe tradotte,
address@hidden non
+dovrebbe, in pratica, causare problemi.
address@hidden itemize
+
address@hidden Esempio I18N
address@hidden Un semplice esempio di internazionalizzazione.
+
+Vediamo ora un esempio dettagliato di come internazionalizzare e localizzare
+un semplice programma @command{awk}, usando come nostro programma sorgente
+originale il file @file{guide.awk}:
+
address@hidden
address@hidden file eg/prog/guide.awk
+BEGIN @{
+ TEXTDOMAIN = "guide"
+ bindtextdomain(".") # per la fase di test
+ print _"Don't Panic"
+ print _"The Answer Is", 42
+ print "Pardon me, Zaphod who?"
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Eseguire @samp{gawk --gen-pot} per creare il file @file{.pot}:
+
address@hidden
+$ @kbd{gawk --gen-pot -f guide.awk > guide.pot}
address@hidden example
+
address@hidden
+Questo produce:
+
address@hidden
address@hidden file eg/data/guide.po
+#: guide.awk:4
+msgid "Don't Panic"
+msgstr ""
+
+#: guide.awk:5
+msgid "The Answer Is"
+msgstr ""
+
address@hidden endfile
address@hidden example
+
+Questo modello di @dfn{portable object} va salvato e riutilizzato per ogni
+lingua in cui l'applicazione viene tradotta. La stringa @code{msgid} @`e
+seguita dalla stringa originale da tradurre, e la stringa @code{msgstr}
address@hidden la traduzione.
+
address@hidden NOTA
+Le stringhe non aventi come prefisso un trattino basso non sono inserite
+nel file @file{guide.pot}.
address@hidden quotation
+
+Successivamente, i messaggi devono essere tradotti.
+Questa @`e una traduzione in un ipotetico dialetto dell'inglese,
+chiamato ``Mellow'':@footnote{Forse sarebbe meglio chiamarlo
+``Hippy.'' Meglio non indagare oltre.}
+
address@hidden
address@hidden
+$ @kbd{cp guide.pot guide-mellow.po}
address@hidden traduzioni al file} guide-mellow.po @dots{}
address@hidden group
address@hidden example
+
address@hidden
+Ecco le traduzioni:
+
address@hidden
address@hidden file eg/data/guide-mellow.po
+#: guide.awk:4
+msgid "Don't Panic"
+msgstr "Hey man, relax!"
+
+#: guide.awk:5
+msgid "The Answer Is"
+msgstr "Like, the scoop is"
+
address@hidden endfile
address@hidden example
+
address@hidden Linux
address@hidden GNU/Linux
+Il passo successivo @`e di creare la directory che contenga il file binario
+con le traduzioni dei messaggi (file .mo [message object]) e
+creare in quella directory il file @file{guide.mo}.
+Si presume che il file in questione debba essere usato nella localizzazione
address@hidden, perch@'e si deve usare un nome di localizzazione che sia
+noto alle routine del comando C @command{gettext}.
+La disposizione delle directory qui utilizzata @`e standard per il comando
+GNU @command{gettext} sui sistemi GNU/Linux. Altre versioni di
address@hidden possono usare una disposizione differente:
+
address@hidden
+$ @kbd{mkdir en_US.UTF-8 en_US.UTF-8/LC_MESSAGES}
address@hidden example
+
address@hidden @code{.po}, file, conversione in @code{.mo}
address@hidden file @code{.po}, conversione in @code{.mo}
address@hidden @code{.mo}, file, conversione da @code{.po}
address@hidden file @code{.mo}, conversione da @code{.po}
address@hidden @dfn{portable object} file (.po), conversione in @dfn{message
object} file
address@hidden file, @dfn{portable object} (.po), conversione in @dfn{message
object} file
address@hidden @dfn{message object} file (.mo), conversione da @dfn{portable
object} file
address@hidden file, @dfn{message object} (.mo), conversione da @dfn{portable
object} file
address@hidden @command{msgfmt}, programma di address@hidden
address@hidden programma di address@hidden @command{msgfmt}
+Il programma di address@hidden @command{msgfmt} effettua la conversione dal
file
+leggibile, in formato testo, @file{.po} nel file, in formato binario,
address@hidden
+Per default, @command{msgfmt} crea un file di nome @file{messages}.
+A questo file dev'essere assegnato un nome appropriato, e va messo nella
+directory predisposta (usando l'opzione @option{-o}) in modo che
address@hidden sia in grado di trovarlo:
+
address@hidden
+$ @kbd{msgfmt guide-mellow.po -o en_US.UTF-8/LC_MESSAGES/guide.mo}
address@hidden example
+
+Infine, eseguiamo il programma per provare se funziona:
+
address@hidden
+$ @kbd{gawk -f guide.awk}
address@hidden Hey man, relax!
address@hidden Like, the scoop is 42
address@hidden Pardon me, Zaphod who?
address@hidden example
+
+Se le tre funzioni che rimpiazzano @code{dcgettext()}, @code{dcngettext()},
+e @code{bindtextdomain()}
+(@address@hidden nell'I18N})
+sono contenute in un file di nome @file{libintl.awk},
address@hidden possibile eseguire @file{guide.awk} senza modificarlo, nel modo
seguente:
+
address@hidden
+$ @kbd{gawk --posix -f guide.awk -f libintl.awk}
address@hidden Don't Panic
address@hidden The Answer Is 42
address@hidden Pardon me, Zaphod who?
address@hidden example
+
address@hidden Gawk internazionalizzato
address@hidden @command{gawk} stesso @`e internazionalizzato
+
+Il comando @command{gawk} stesso @`e stato internazionalizzato
+usando il pacchetto GNU @command{gettext}.
+(GNU @command{gettext} @`e descritto in
+maniera esauriente in
address@hidden
address@hidden, , GNU @command{gettext} utilities, gettext, GNU
@command{gettext} utilities}.)
address@hidden ifinfo
address@hidden
address@hidden://www.gnu.org/software/gettext/manual/,
address@hidden @command{gettext} utilities}}.)
address@hidden ifnotinfo
+Al momento in cui questo libro @`e stato scritto, la versione address@hidden
recente di
+GNU @command{gettext} @`e
address@hidden://ftp.gnu.org/gnu/gettext/gettext-0.19.4.tar.gz,
address@hidden 0.19.4}.
+
+Se esiste una traduzione dei messaggi di @command{gawk},
address@hidden invia messaggi, avvertimenti, ed errori fatali
+utilizzando la lingua locale.
+
address@hidden Sommario I18N
address@hidden Sommario
address@hidden @value{BULLET}
address@hidden
+Internazionalizzazione significa scrivere un programma in modo che
+possa interagire in molte lingue senza che sia necessario cambiare il codice
+sorgente.
+Localizzazione significa fornire i dati necessari perch@'e un programma
+internazionalizzato possa interagire usando una determinata lingua.
+
address@hidden
address@hidden usa il comando GNU @command{gettext} per consentire
+l'internazionalizzazione e la localizzazione di programmi @command{awk}.
+Un dominio di testo di un programma identifica il programma, e consente di
+raggruppare tutti i messaggi e gli altri dati del programma in un solo posto.
+
address@hidden
+Si marcano le stringhe in un programma da tradurre preponendo loro un
+trattino basso. Una volta fatto questo, queste stringhe sono estratte
+in un file @file{.pot}. Questo file @`e copiato, per ogni lingua, in un file
address@hidden e i file @file{.po} sono
+compilati in file @file{.gmo} che saranno usati in fase di
+esecuzione del programma.
+
address@hidden
address@hidden possibile usare specificazioni posizionali con le istruzioni
address@hidden()} e @code{printf} per modificare la posizione del valore
+degli argomenti nelle stringhe di formato e nell'output. address@hidden @`e
utile nella
+traduzione di stringhe di
+formattazione dei messaggi.
+
address@hidden
+Le address@hidden di internazionalizzazione sono state progettate in modo
+da poter essere facilmente gestite in un programma @command{awk} standard.
+
address@hidden
+Anche il comando @command{gawk} @`e stato internazionalizzato e viene
+distribuito con traduzioni in molte lingue dei messaggi inviati in fase di
+esecuzione.
+
address@hidden itemize
+
+
address@hidden Debugger
address@hidden Effettuare il debug dei programmi @command{awk}
address@hidden debug dei programmi @command{awk}
+
address@hidden The original text for this chapter was contributed by Efraim
Yawitz.
address@hidden FIXME: Add more indexing.
+
+Sarebbe bello se i programmi per il calcolatore funzionassero perfettamente la
+prima volta che vengono eseguiti, ma nella vita reale questo accade raramente,
+qualunque sia la address@hidden dei programmi. address@hidden la maggior
parte dei
+linguaggi di programmazione hanno a disposizione degli strumenti che facilitano
+la ricerca di errori (@dfn{debugging}) nei programmi, e @command{awk} non fa
+eccezione.
+
+Il @dfn{debugger} di @command{gawk} @`e di proposito costruito sul modello del
+debugger da riga di comando
address@hidden://www.gnu.org/software/gdb/, GNU Debugger (GDB)}.
+Se si ha address@hidden con GDB, address@hidden facile imparare come usare
@command{gawk}
+per eseguire il debug dei propri programmi.
+
address@hidden
+* Debugging:: Introduzione al debugger di @command{gawk}.
+* Esempio di sessione di debug:: Esempio di sessione di debug.
+* Lista dei comandi di debug:: Principali comandi di debug.
+* Supporto per Readline:: Supporto per Readline.
+* Limitazioni:: Limitazioni e piani per il futuro.
+* Sommario sul debug:: Sommario sul debug.
address@hidden menu
+
address@hidden Debugging
address@hidden Introduzione al debugger di @command{gawk}
+
+Questa @value{SECTION}, dopo un'introduzione sul debug in generale, inizia
+la trattazione del debug in @command{gawk}.
+
address@hidden
+* Nozioni sul debug:: address@hidden sul debug.
+* Terminologia nel debug:: Ulteriori nozioni sul debug.
+* Debug di Awk:: Eseguire il debug di Awk.
address@hidden menu
+
address@hidden Nozioni sul debug
address@hidden address@hidden sul debug
+
+(Se si sono usati dei debugger in altri linguaggi, si address@hidden andare
direttamente
+alla @ref{Debug di Awk}.)
+
+Naturalmente, un programma di debug non address@hidden correggere gli errori
al posto del
+programmatore, perch@'e non address@hidden sapere quello che il programmatore
o gli utenti
+considerano un ``bug'' e non una address@hidden''. (Talvolta, anche noi umani
+abbiamo address@hidden nel determinarlo.)
+In quel caso, cosa ci si address@hidden aspettare da un tale strumento? La
risposta
+dipende dal linguaggio su cui si effettua il debug, comunque in generale ci si
address@hidden attendere almeno questo:
+
address@hidden @value{BULLET}
address@hidden
+La address@hidden di osservare l'esecuzione delle istruzioni di un programma
una
+per una, dando al programmatore l'address@hidden di pensare a quel che accade a
+una scala temporale di secondi, minuti od ore, piuttosto che alla scala dei
+nanosecondi alla quale normalmente viene eseguito il codice.
+
address@hidden
+L'address@hidden, non solo di osservare passivamente le operazioni del
progamma,
+ma di controllarlo e tentare diversi percorsi di esecuzione, senza dover
+modificare i file sorgenti.
+
address@hidden
+La address@hidden di vedere i valori o i dati nel programma in qualsiasi punto
+dell'esecuzione, e anche di cambiare i dati al volo, per vedere come questo
+influisca su address@hidden che accade dopo. (Questo include spesso la
address@hidden di
+esaminare le strutture interne dei dati oltre alle variabili che
+sono state effettivamente definite nel codice del programma.)
+
address@hidden
+La address@hidden di ottenere ulteriori informazioni sullo stato del programma
+o anche sulle sue strutture interne.
address@hidden itemize
+
+Tutti questi strumenti sono di grande aiuto e permettono di usare
l'address@hidden
+che si possiede e la comprensione che si ha degli obiettivi del programma
+per trovare dove si verificano i problemi (o, in alternativa, per
+comprendere meglio la logica di un programma funzionante, di cui si sia
+l'autore, o anche di un programma scritto da altri).
+
address@hidden Terminologia nel debug
address@hidden Concetti fondamentali sul debug
+
+Prima di entrare nei dettagli, dobbiamo introdurre diversi
+importanti concetti che valgono per tutti i debugger.
+La seguente lista definisce i termini usati nel resto di
+questo @value{CHAPTER}:
+
address@hidden @dfn
address@hidden @dfn{stack frame}
address@hidden Stack frame
+Durante la loro esecuzione i programmi normalmente chiamano delle funzioni.
+Una funzione address@hidden a sua volta chiamarne un'altra, o address@hidden
richiamare se stessa
+(ricorsione). La
+catena di funzioni chiamate (il programma principale chiama A, che chiama B,
+che chiama C) address@hidden essere vista come una pila di funzioni in
esecuzione: la
+funzione correntemente in esecuzione @`e quella in cima alla pila, e quando
+questa finisce (ritorna al chiamante),
+quella immediatamente sotto diventa la funzione
+attiva. Tale pila (@dfn{stack}) @`e chiamata @dfn{call stack} (pila delle
chiamate).
+
+Per ciascuna funzione della pila delle chiamate (@dfn{call stack}), il sistema
+mantiene un'area di dati che contiene i parametri della funzione, le variabili
+locali e i valori di ritorno, e anche ogni altra informazione ``contabile''
+necessaria per gestire la pila delle chiamate. Quest'area di dati @`e chiamata
address@hidden frame}.
+
+Anche @command{gawk} segue questo modello, e permette l'accesso alla pila
+delle chiamate e a ogni @dfn{stack frame}. @`E possibile esaminare la pila
+delle chiamate, e anche sapere da dove ciascuna funzione sulla pila @`e stata
+invocata. I comandi che stampano la pila delle chiamate stampano anche le
+informazioni su ogni @dfn{stack frame} (come vedremo address@hidden avanti in
dettaglio).
+
address@hidden Punto d'interruzione
address@hidden breakpoint
address@hidden punto d'interruzione
+Durante le operazioni di debug, spesso si preferisce lasciare che il programma
+venga eseguito finch@'e non raggiunge un certo punto, e da quel punto in poi si
+continua l'esecuzione un'istruzione alla volta. Il modo per farlo @`e quello
di
+impostare un @dfn{punto d'interruzione} all'interno del programma. Un punto
+d'interruzione @`e il punto dove l'esecuzione del programma dovrebbe
+interrompersi (fermarsi), in modo da assumere il controllo dell'esecuzione del
+programma. Si possono aggiungere e togliere quanti punti d'interruzione si
+vogliono.
+
address@hidden Punto d'osservazione
address@hidden @dfn{watchpoint}
address@hidden punto d'osservazione
+Un punto d'osservazione @`e simile a un punto d'interruzione. La differenza
@`e
+che i punti d'interruzione sono orientati attorno al codice; fermano il
+programma quando viene raggiunto un certo punto nel codice. Un punto
+d'osservazione, invece, fa fermare il programma quando @`e stato
+cambiato il @emph{valore di un dato}. Questo @`e utile, poich@'e a volte
succede
+che una variabile riceva un valore errato, ed @`e difficile rintracciare il
punto
+dove address@hidden accade solo leggendo il codice sorgente.
+Usando un punto d'osservazione, si address@hidden fermare il programma in
qualunque punto
+vi sia un'assegnazione di variabile, e di solito si individua il codice che
+genera l'errore abbastanza velocemente.
address@hidden table
+
address@hidden Debug di Awk
address@hidden Il debug di @command{awk}
+
+Il debug di un programma @command{awk} ha delle address@hidden proprie, che
+non sono presenti in programmi scritti in altri linguaggi.
+
+Prima di tutto, il fatto che i programmi @command{awk} ricevano generalmente
+l'input riga per riga da uno o address@hidden file e operino su tali righe
usando regole
+specifiche, rende particolarmente agevole organizzare l'esame
+dell'esecuzione del programma facendo riferimento a tali regole.
+Come vedremo, ogni
+regola @command{awk} viene trattata quasi come una chiamata di funzione, col
+proprio specifico blocco di istruzioni.
+
+Inoltre, poich@'e @command{awk} @`e un linguaggio deliberatamente molto
+conciso, @`e facile perdere di vista tutto address@hidden che avviene
``dentro''
+ogni riga di codice @command{awk}. Il debugger address@hidden
l'address@hidden di
+guardare le singole istruzioni primitive la cui esecuzione @`e innescata
+dai comandi di alto livello di @command{awk}.
+
address@hidden Esempio di sessione di debug
address@hidden Esempio di sessione di debug di @command{gawk}
address@hidden esempio di sessione di debug
address@hidden debug, esempio di sessione
+
+Per illustrare l'uso di @command{gawk} come debugger, vediamo un esempio di
+sessione di debug. Come esempio address@hidden usata l'implementazione
@command{awk}
+del comando POSIX @command{uniq} descritta in precedenza (@pxref{Programma
+uniq}).
+
address@hidden
+* Invocazione del debugger:: Come far partire il debugger.
+* Trovare il bug:: Trovare il bug.
address@hidden menu
+
address@hidden Invocazione del debugger
address@hidden Come avviare il debugger
address@hidden avviare il debugger
address@hidden debugger, come avviarlo
address@hidden debugger, comandi del, si veda comando del debugger
+
+Per avviare il debugger in @command{gawk} si richiama il comando esattamente
+come al solito, specificando solo un'opzione aggiuntiva,
address@hidden, o la corrispondente opzione breve @option{-D}.
+I file (o il file) che contengono
+il programma e ogni codice ulteriore sono immessi sulla riga di comando come
+argomenti a una o address@hidden opzioni @option{-f}. (@command{gawk} non @`e
progettato per
+eseguire il debug di programmi scritti sulla riga di comando, ma solo per
+quello di programmi che risiedono su file.)
+Nel nostro caso, il debugger address@hidden invocato in questo modo:
+
address@hidden
+$ @kbd{gawk -D -f getopt.awk -f join.awk -f uniq.awk -1 file_di_input}
address@hidden example
+
address@hidden
+dove entrambi i file @file{getopt.awk} e @file{uniq.awk} sono in
@env{$AWKPATH}.
+(Gli utenti esperti di GDB o debugger simili dovrebbero tener presente che
+questa sintassi @`e leggermente differente da quello che sono abituati a usare.
+Col debugger di @command{gawk}, si danno gli argomenti per eseguire il
+programma nella riga di comando al debugger piuttosto che come parte del
+comando @code{run} al prompt del debugger.)
+L'opzione @option{-1} @`e un'opzione per @file{uniq.awk}.
+
+Invece di eseguire direttamente il programma sul @file{file_di_input}, come
address@hidden farebbe normalmente, il debugger semplicemente carica
+i file sorgenti del programma, li compila internamente, e poi mostra
+la riga d'invito:
+
address@hidden
+gawk>
address@hidden example
+
address@hidden
+da dove si possono impartire i comandi al debugger. Sin qui non @`e
+stato ancora eseguito nessun codice.
+
address@hidden Trovare il bug
address@hidden Trovare il bug
+
+Poniamo di avere un problema usando (una versione difettosa di)
address@hidden nella address@hidden ``salta-campi'', perch@'e sembra che non
+catturi le righe che dovrebbero essere identiche dopo aver saltato il primo
+campo, come:
+
address@hidden
+awk, ecco un programma meraviglioso!
+gawk, ecco un programma meraviglioso!
address@hidden example
+
+Questo potrebbe accadere se noi pensassimo (come in C) che i campi in un record
+siano numerati prendendo come base lo zero, per cui, invece di scrivere:
+
address@hidden
+campi_ultima = join(vettore_ultima, contatore_file+1, n)
+campi_corrente = join(vettore_corrente, contatore_file+1, m)
address@hidden example
+
address@hidden
+abbiamo scritto:
+
address@hidden
+campi_ultima = join(vettore_ultima, contatore_file, n)
+campi_corrente = join(vettore_corrente, contatore_file, m)
address@hidden example
+
+La prima cosa da fare quando si tenta di indagare su un problema come questo
@`e
+quella di mettere un punto d'interruzione (@dfn{breakpoint}) nel programma, in
modo
+da poterlo vedere al lavoro e catturare quello che non va. Una posizione
+ragionevole per un punto d'interruzione in @file{uniq.awk} @`e all'inizio della
+funzione @code{se_sono_uguali()}, che confronta la riga corrente con la
precedente.
+Per impostare il punto d'interruzione, usare il comando @code{b}
(@dfn{breakpoint}):
+
address@hidden
+gawk> @kbd{b se_sono_uguali}
address@hidden Breakpoint 1 impostato al file `uniq.awk', riga 63
address@hidden example
+
+Il debugger mostra il file e il numero di riga dove si trova il punto
+d'interruzione. Ora bisogna immettere @samp{r} o @samp{run} e il programma
+viene eseguito fino al primo punto d'interruzione:
+
address@hidden
+gawk> @kbd{r}
address@hidden Partenza del programma:
address@hidden Mi fermo in Rule ...
address@hidden Breakpoint 1, se_sono_uguali(n, m, campi_ultima, campi_corrente,
address@hidden vettore_ultima, vettore_corrente)
address@hidden a `uniq.awk':63
address@hidden 63 if (contatore_file == 0 && conta_caratteri == 0)
+gawk>
address@hidden example
+
+Ora possiamo osservare cosa accade all'interno del nostro programma.
+Prima di tutto, vediamo come siamo arrivati a questo punto. Sulla riga di
+comando battiamo @samp{bt} (che sta per ``backtrace''), e il debugger risponde
+con un listato degli @dfn{stack frame} correnti:
+
address@hidden
+gawk> @kbd{bt}
address@hidden #0 se_sono_uguali(n, m, campi_ultima, campi_corrente,
address@hidden vettore_ultima, vettore_corrente)
address@hidden a `uniq.awk':63
address@hidden #1 in main() a `uniq.awk':88
address@hidden example
+
+Questo ci dice che la funzione @code{se_sono_uguali()} @`e stata chiamata
+dal programma principale alla riga 88 del file @file{uniq.awk}. (Questo non
+sorprende, perch@'e @`e questa l'unica chiamata a @code{se_sono_uguali()} nel
+programma, address@hidden in programmi
address@hidden complessi, sapere chi ha chiamato una funzione e con quali
parametri address@hidden
+essere la chiave per trovare l'origine del problema.)
+
+Ora che siamo in @code{se_sono_uguali()}, possiamo iniziare a guardare i
valori di
+alcune variabili. Immaginiamo di battere @samp{p n}
+(@code{p} sta per @dfn{print} [stampa]). Ci aspetteremo di vedere il valore di
address@hidden, un parametro di @code{se_sono_uguali()}. In address@hidden, il
debugger
+ci address@hidden:
+
address@hidden
+gawk> @kbd{p n}
address@hidden n = untyped variable
address@hidden example
+
address@hidden
+In questo caso, @code{n} @`e una variabile locale non inizializzata, perch@'e
la
+funzione @`e stata chiamata senza argomenti (@pxref{Chiamate di funzione}).
+
+Una variabile address@hidden utile da visualizzare potrebbe essere la seguente:
+
address@hidden
+gawk> @kbd{p $0}
address@hidden $0 = "gawk, ecco un programma meraviglioso!"
address@hidden example
+
address@hidden
+All'inizio questo potrebbe lasciare un tantino perplessi, perch@'e @`e la
seconda
+riga dell'input del test. Vediamo @code{NR}:
+
address@hidden
+gawk> @kbd{p NR}
address@hidden NR = 2
address@hidden example
+
address@hidden
+Come si address@hidden vedere, @code{se_sono_uguali()} @`e stata chiamata solo
per la seconda
+riga del file. Naturalmente, address@hidden accade perch@'e il nostro
programma contiene
+una regola per @samp{NR == 1}:
+
address@hidden
+NR == 1 @{
+ ultima = $0
+ next
address@hidden
address@hidden example
+
+Bene, controlliamo che questa funzioni correttamente:
+
address@hidden
+gawk> @kbd{p ultima}
address@hidden ultima = "awk, ecco un programma meraviglioso!"
address@hidden example
+
+Tutto address@hidden che @`e stato fatto fin qui ha verificato che il
programma funziona
+come previsto fino alla chiamata a @code{se_sono_uguali()} compresa; quindi
+il problema dev'essere all'interno di questa funzione. Per indagare
+ulteriormente, iniziamo a ``scorrere una ad una'' le righe di
address@hidden()}. Cominciamo col battere @samp{n} (per ``next''
+[successivo]):
+
address@hidden
+gawk> @kbd{n}
address@hidden 66 if (contatore_file > 0) @{
address@hidden example
+
+Questo ci dice che @command{gawk} ora @`e pronto per eseguire la riga 66, che
+decide se assegnare alle righe il trattamento speciale ``salta-campi''
+indicato dall'opzione sulla riga di comando @option{-1}. (Si noti che abbiamo
+saltato da dov'eravamo prima, alla riga 63, a qui, perch@'e la condizione nella
+riga 63, @samp{if (contatore_file == 0 && conta_caratteri == 0)}, era falsa.)
+
+Continuando a scorrere le righe, ora raggiungiamo la divisione del record
+corrente e dell'ultimo:
+
address@hidden
+gawk> @kbd{n}
address@hidden 67 n = split(ultima, vettore_ultima)
+gawk> @kbd{n}
address@hidden 68 m = split($0, vettore_corrente)
address@hidden example
+
+A questo punto, potremmo stare a vedere in quante parti il nostro record
address@hidden stato suddiviso, quindi proviamo a osservare:
+
address@hidden
+gawk> @kbd{p n m vettore_ultima vettore_corrente}
address@hidden n = 5
address@hidden m = untyped variable
address@hidden vettore_ultima = array, 5 elements
address@hidden vettore_corrente = untyped variable
address@hidden example
+
address@hidden
+(Il comando @code{p} address@hidden accettare address@hidden argomenti,
analogamente
+all'istruzione di @command{awk} @code{print}.)
+
+Questo ci lascia piuttosto perplessi. Tutto address@hidden che abbiamo
trovato @`e che ci
+sono cinque elementi in @code{vettore_ultima}; @code{m} e
@code{vettore_corrente} non hanno valori
+perch@'e siamo alla riga 68 che non @`e ancora stata eseguita. Questa
+informazione @`e abbastanza utile (ora sappiamo che nessuna delle parole @`e
stata
+lasciata fuori accidentalmente), ma sarebbe desiderabile vedere i valori
+del vettore.
+
+Una prima address@hidden @`e quella di usare degli indici:
+
address@hidden
+gawk> @kbd{p vettore_ultima[0]}
address@hidden "0" non presente nel vettore `vettore_ultima'
address@hidden example
+
address@hidden
+Oops!
+
address@hidden
+gawk> @kbd{p vettore_ultima[1]}
address@hidden vettore_ultima["1"] = "awk,"
address@hidden example
+
+Questo metodo sarebbe piuttosto lento per un vettore con 100 elementi, per cui
address@hidden fornisce una scorciatoia (che fa venire in mente un altro
+linguaggio che non nominiamo):
+
address@hidden
+gawk> @kbd{p @@vettore_ultima}
address@hidden vettore_ultima["1"] = "awk,"
address@hidden vettore_ultima["2"] = "ecco"
address@hidden vettore_ultima["3"] = "un"
address@hidden vettore_ultima["4"] = "programma"
address@hidden vettore_ultima["5"] = "meraviglioso!"
address@hidden example
+
+Finora, sembra che tutto vada bene. Facciamo un altro passo,
+o anche due:
+
address@hidden
+gawk> @kbd{n}
address@hidden 69 campi_ultima = join(vettore_ultima,
contatore_file, n)
+gawk> @kbd{n}
address@hidden 70 campi_corrente = join(vettore_corrente,
contatore_file, m)
address@hidden example
+
+Bene, eccoci arrivati al nostro errore (ci spiace di aver rovinato la
+sorpresa).
+Quel che avevamo in mente era di unire i campi a partire dal secondo per
+creare il record virtuale da confrontare, e se il primo campo aveva il numero
+zero, questo avrebbe funzionato. Vediamo quel che abbiamo finora:
+
address@hidden
+gawk> @kbd{p campi_ultima campi_corrente}
address@hidden campi_ultima = "awk, ecco un programma meraviglioso!"
address@hidden campi_corrente = "gawk, ecco un programma meraviglioso!"
address@hidden example
+
+Ehi! queste frasi suonano piuttosto familiari! Sono esattamente i nostri
+record di input originali, inalterati. Pensandoci un po' (il cervello umano
@`e
+ancora il miglior strumento di debug), ci si rende conto che eravamo fuori di
+uno!
+
+Usciamo dal debugger:
+
address@hidden
+gawk> @kbd{q}
address@hidden Il programma @`e in esecuzione. Esco comunque (y/n)? @kbd{y}
address@hidden example
+
address@hidden
+Quindi modifichiamo con un editore di testo:
+
address@hidden
+campi_ultima = join(vettore_ultima, contatore_file+1, n)
+campi_corrente = join(vettore_corrente, contatore_file+1, m)
address@hidden example
+
address@hidden
+e il problema @`e risolto!
+
address@hidden Lista dei comandi di debug
address@hidden I principali comandi di debug
+
+L'insieme dei comandi del debugger di @command{gawk} address@hidden essere
diviso nelle
+seguenti categorie:
+
address@hidden @value{BULLET}
+
address@hidden
+Controllo di punti d'interruzione
+
address@hidden
+Controllo di esecuzione
+
address@hidden
+Vedere e modificare dati
+
address@hidden
+Lavorare con le pile
+
address@hidden
+Ottenere informazioni
+
address@hidden
+Comandi vari
address@hidden itemize
+
+Ciascuna di esse @`e trattata nelle sottosezioni che seguono.
+Nelle descrizioni seguenti, i comandi che possono essere abbreviati
+mostrano l'abbreviazione su una seconda riga di descrizione.
+Un nome di comando del debugger address@hidden essere anche troncato se la
parte address@hidden scritta
+non @`e ambigua. Il debugger ha la address@hidden predefinita di ripetere
+automaticamente il precedente comando semplicemente battendo @kbd{Invio}.
+Questo vale per i comandi @code{list}, @code{next}, @code{nexti},
address@hidden, @code{stepi} e @code{continue} quando sono eseguiti senza
+argomenti.
+
address@hidden
+* Controllo dei breakpoint:: Controllo dei punti d'interruzione.
+* Controllo esecuzione debugger:: Controllo di esecuzione.
+* Vedere e modificare dati:: Vedere e modificare dati.
+* Stack di esecuzione:: Lavorare con le pile.
+* Informazioni sul debugger:: Ottenere informazioni sullo stato del
+ programma e del debugger.
+* Comandi vari del debugger:: Comandi vari del debugger.
address@hidden menu
+
address@hidden Controllo dei breakpoint
address@hidden Controllo dei punti d'interruzione
+
+Come abbiamo address@hidden visto, la prima cosa che si dovrebbe fare in una
sessione di
+debug @`e quella di definire dei punti d'interruzione, poich@'e altrimenti il
+programma address@hidden eseguito come se non fosse sotto il debugger. I
comandi per
+controllare i punti d'interruzione sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{b} (alias per @code{break})
address@hidden comando del debugger, @code{break}
address@hidden @code{break}, comando del debugger
address@hidden @code{b}, comando del debugger (alias per @code{break})
address@hidden impostare un punto d'interruzione
address@hidden breakpoint, impostare
address@hidden punto d'interruzione (breakpoint), impostare
address@hidden @code{break} address@hidden@code{:address@hidden |
@var{funzione}] address@hidden"@var{espressione}"}]
address@hidden @code{b} address@hidden@code{:address@hidden | @var{funzione}]
address@hidden"@var{espressione}"}]
+Senza argomenti, imposta un punto d'interruzione alla prossima istruzione
+da eseguire nello @dfn{stack frame} selezionato.
+Gli argomenti possono essere uno dei seguenti:
+
address@hidden @asis for docbook
address@hidden nested table
address@hidden @asis
address@hidden @var{n}
+Imposta un punto d'interruzione alla riga numero @var{n} nel file sorgente
+corrente.
+
address@hidden @address@hidden:address@hidden
+Imposta un punto d'interruzione alla riga numero @var{n} nel file sorgente
address@hidden
+
address@hidden @var{funzione}
+Imposta un punto d'interruzione all'ingresso (la prima istruzione eseguibile)
+della funzione @var{funzione}.
address@hidden table
+
+A ogni punto d'interruzione @`e assegnato un numero che address@hidden essere
usato per
+cancellarlo dalla lista dei punti d'interruzione usando il comando
address@hidden
+
+Specificando un punto d'interruzione, si address@hidden fornire anche una
condizione.
+Questa @`e
+un'espressione @command{awk} (racchiusa tra doppi apici) che il debugger
+valuta ogni volta che viene raggiunto quel punto d'interruzione. Se la
+condizione @`e vera, il debugger ferma l'esecuzione e rimane in attesa di un
+comando. Altrimenti, continua l'esecuzione del programma.
+
address@hidden comando del debugger, @code{clear}
address@hidden @code{clear}, comando del debugger
address@hidden cancellare punto d'interruzione da una determinata posizione
address@hidden punto d'interruzione in una determinata posizione, come
cancellare
address@hidden breakpoint, come cancellare
address@hidden @code{clear} address@hidden@code{:address@hidden |
@var{funzione}]
+Senza argomenti, cancella ogni eventuale punto d'interruzione all'istruzione
+successiva
+da eseguirsi nello @dfn{stack frame} selezionato. Se il programma si ferma in
+un punto d'interruzione, quel punto d'interruzione viene cancellato in modo
+che il programma non si fermi address@hidden in quel punto.
+Gli argomenti possono essere uno tra i seguenti:
+
address@hidden nested table
address@hidden @asis
address@hidden @var{n}
+Cancella il punto (o i punti) d'interruzione impostato/i alla riga @var{n} nel
+file sorgente corrente.
+
address@hidden @address@hidden:address@hidden
+Cancella il punto (o i punti) d'interruzione impostato/i alla riga @var{n} nel
+file sorgente @var{nome-file}.
+
address@hidden @var{funzione}
+Cancella il punto (o i punti) d'interruzione impostato/i all'ingresso della
+funzione @var{funzione}.
address@hidden table
+
address@hidden comando del debugger, @code{condition}
address@hidden @code{condition}, comando del debugger
address@hidden condizione dei punti d'interruzione
address@hidden @code{condition} @var{n} @code{"@var{espressione}"}
+Aggiunge una condizione al punto d'interruzione o al punto d'osservazione
+esistente @var{n}. La condizione @`e un'espressione @command{awk}
address@hidden tra doppi apici} che il debugger valuta ogni volta che viene
+raggiunto il punto d'interruzione o il punto d'osservazione. Se la condizione
@`e
+vera, il debugger ferma l'esecuzione e attende l'immissione di un comando.
+Altrimenti, il debugger continua l'esecuzione del programma. Se l'espressione
+della condizione non viene specificata, tutte le condizioni esistenti vengono
+rimosse (address@hidden, il punto d'interruzione o di osservazione viene
considerato
+incondizionato).
+
address@hidden comando del debugger, @code{d} (alias per @code{delete})
address@hidden comando del debugger, @code{delete}
address@hidden @code{delete}, comando del debugger
address@hidden @code{d}, comando del debugger (alias per @code{delete})
address@hidden cancellare punto d'interruzione per numero
address@hidden punto d'interruzione, cancellare per numero
address@hidden @code{delete} address@hidden n2} @dots{}] address@hidden@var{m}]
address@hidden @code{d} address@hidden n2} @dots{}] address@hidden@var{m}]
+Cancella i punti d'interruzione specificati o un intervallo di punti
+d'interruzione. Se non vengono forniti argomenti, cancella tutti i
+punti d'interruzione esistenti.
+
address@hidden comando del debugger, @code{disable}
address@hidden @code{disable}, comando del debugger
address@hidden disabilitare punto d'interruzione
address@hidden punto d'interruzione, come disabilitare o abilitare
address@hidden @code{disable} address@hidden n2} @dots{} | @address@hidden
+Disabilita punti d'interruzione specificati o un intervallo di essi. Senza
+argomenti, disabilita tutti i punti d'interruzione.
+
address@hidden comando del debugger, @code{e} (alias per @code{enable})
address@hidden comando del debugger, @code{enable}
address@hidden @code{enable}, comando del debugger
address@hidden @code{e}, comando del debugger (alias per @code{enable})
address@hidden abilitare un punto d'interruzione
address@hidden @code{enable} address@hidden | @code{once}] address@hidden n2}
@dots{}] address@hidden@var{m}]
address@hidden @code{e} address@hidden | @code{once}] address@hidden n2}
@dots{}] address@hidden@var{m}]
+Abilita specifici punti d'interruzione o un intervallo di essi. Senza
+argomenti, abilita tutti i punti d'interruzione.
+Opzionalmente, si address@hidden specificare come abilitare i punti
d'interruzione:
+
address@hidden nested table
address@hidden @code
address@hidden del
+Abilita dei punti d'interruzione @dfn{una tantum}, poi li cancella quando il
+programma si ferma in quel punto.
+
address@hidden once
+Abilita dei punti d'interruzione @dfn{una tantum}, poi li cancella quando il
+programma si ferma in quel punto.
address@hidden table
+
address@hidden comando del debugger, @code{ignore}
address@hidden @code{ignore}, comando del debugger
address@hidden ignorare un punto d'interruzione
address@hidden @code{ignore} @var{n} @var{contatore}
+Ignora il punto d'interruzione numero @var{n} le successive
address@hidden volte in cui viene raggiunto.
+
address@hidden comando del debugger, @code{t} (alias per @code{tbreak})
address@hidden comando del debugger, @code{tbreak}
address@hidden @code{tbreak}, comando del debugger
address@hidden @code{t}, comando del debugger (alias per @code{tbreak})
address@hidden punto d'interruzione temporaneo
address@hidden temporaneo, punto d'interruzione
address@hidden @code{tbreak} address@hidden@code{:address@hidden |
@var{funzione}]
address@hidden @code{t} address@hidden@code{:address@hidden | @var{funzione}]
+Imposta un punto d'interruzione temporaneo (abilitato solo per la prima volta
+che viene raggiunto). Gli argomenti sono gli stessi di @code{break}.
address@hidden table
+
address@hidden Controllo esecuzione debugger
address@hidden Controllo di esecuzione
+
+Dopo che i punti d'interruzione sono pronti, si address@hidden iniziare
l'esecuzione del
+programma, osservando il suo comportamento. Ci sono address@hidden comandi per
+controllare l'esecuzione del programma di quelli visti nei precedenti esempi:
+
address@hidden @asis
address@hidden comando del debugger, @code{commands}
address@hidden @code{commands}, comando del debugger
address@hidden comando del debugger, @code{silent}
address@hidden @code{silent}, comando del debugger
address@hidden comando del debugger, @code{end}
address@hidden @code{end}, comando del debugger
address@hidden punto d'interruzione, comandi
address@hidden comandi da eseguire al punto d'interruzione
address@hidden @code{commands} address@hidden
address@hidden @code{silent}
address@hidden @dots{}
address@hidden @code{end}
+Imposta una lista di comandi da eseguire subito dopo l'arresto del programma in
+un punto d'interruzione o di osservazione. @var{n} @`e il numero del punto
+d'interruzione o di osservazione. Se non si specifica un numero, viene usato
+l'ultimo numero che @`e stato specificato. I comandi veri e propri seguono,
+a cominciare dalla riga successiva, e hanno termine col comando @code{end}.
+Se il comando @code{silent} @`e nella lista, i consueti messaggi sull'arresto
del
+programma a un punto d'interruzione e la riga sorgente non vengono stampati.
+Qualsiasi comando nella lista che riprende l'esecuzione (p.es.,
address@hidden) pone fine alla lista (un @code{end} implicito), e i comandi
+successivi vengono ignorati.
+Per esempio:
+
address@hidden
+gawk> @kbd{commands}
+> @kbd{silent}
+> @kbd{printf "Un punto d'interruzione silenzioso; i = %d\n", i}
+> @kbd{info locals}
+> @kbd{set i = 10}
+> @kbd{continue}
+> @kbd{end}
+gawk>
address@hidden example
+
address@hidden comando del debugger, @code{c} (alias per @code{continue})
address@hidden comando del debugger, @code{continue}
address@hidden @code{continue}, comando del debugger
address@hidden @code{continue} address@hidden
address@hidden @code{c} address@hidden
+Riprende l'esecuzione del programma. Se si riparte da un punto d'interruzione
+e viene specificato @var{contatore}, il punto d'interruzione in quella
+posizione viene ignorato per le prossime @var{contatore} volte prima di
+fermarsi nuovamente.
+
address@hidden comando del debugger, @code{finish}
address@hidden @code{finish}, comando del debugger
address@hidden @code{finish}
+Esegue fino a quando lo stack frame selezionato completa l'esecuzione.
+Stampa il valore restituito.
+
address@hidden comando del debugger, @code{n} (alias per @code{next})
address@hidden comando del debugger, @code{next}
address@hidden @code{next}, comando del debugger
address@hidden @code{n}, comando del debugger (alias per @code{next})
address@hidden esecuzione di un solo passo, nel debugger
address@hidden @code{next} address@hidden
address@hidden @code{n} address@hidden
+Continua l'esecuzione alla successiva riga sorgente, saltando le chiamate di
+funzione. L'argomento @var{contatore} controlla il numero di ripetizioni
+dell'azione, come in @code{step}.
+
address@hidden comando del debugger, @code{ni} (alias per @code{nexti})
address@hidden comando del debugger, @code{nexti}
address@hidden @code{nexti}, comando del debugger
address@hidden @code{ni}, comando del debugger (alias for @code{nexti})
address@hidden @code{nexti} address@hidden
address@hidden @code{ni} address@hidden
+Esegue una o @var{contatore} istruzioni, comprese le chiamate di funzione.
+
address@hidden comando del debugger, @code{return}
address@hidden @code{return}, comando del debugger
address@hidden @code{return} address@hidden
+Cancella l'esecuzione di una chiamata di funzione. Se @var{valore} (una
+stringa o un numero) viene specificato, @`e usato come valore di ritorno della
+funzione. Se usato in un frame diverso da quello address@hidden interno (la
funzione
+correntemente in esecuzione; address@hidden, il frame numero 0), ignora tutti
i frame
address@hidden interni di quello selezionato, e il chiamante del frame
selezionato
+diventa il frame address@hidden interno.
+
address@hidden comando del debugger, @code{r} (alias per @code{run})
address@hidden comando del debugger, @code{run}
address@hidden @code{run}, comando del debugger
address@hidden @code{r}, comando del debugger (alias per @code{run})
address@hidden @code{run}
address@hidden @code{r}
+Avvia/riavvia l'esecuzione del programma. Quando il programma viene riavviato,
+il debugger mantiene i punti d'interruzione e di osservazione, la cronologia
+dei comandi, la visualizzazione automatica di variabili, e le opzioni del
+debugger.
+
address@hidden comando del debugger, @code{s} (alias per @code{step})
address@hidden comando del debugger, @code{step}
address@hidden @code{step}, comando del debugger
address@hidden @code{s}, comando del debugger (alias per @code{step})
address@hidden @code{step} address@hidden
address@hidden @code{s} address@hidden
+Continua l'esecuzione finch@'e il controllo non raggiunge una diversa riga del
+sorgente nello @dfn{stack frame} corrente, eseguendo ogni funzione chiamata
+all'interno della riga. Se viene fornito l'argomento @var{contatore},
+esegue il numero di istruzioni specificate prima di fermarsi, a meno che non
+s'imbatta in un punto d'interruzione o di osservazione.
+
address@hidden comando del debugger, @code{si} (alias per @code{stepi})
address@hidden comando del debugger, @code{stepi}
address@hidden @code{stepi}, comando del debugger
address@hidden @code{si}, comando del debugger (alias per @code{stepi})
address@hidden @code{stepi} address@hidden
address@hidden @code{si} address@hidden
+Esegue una o @var{contatore} istruzioni, comprese le chiamate di funzione.
+(Per una spiegazione su cosa s'intende per ``istruzione'' in @command{gawk},
+si veda l'output mostrato sotto @code{dump} nella
address@hidden vari del debugger}.)
+
address@hidden comando del debugger, @code{u} (alias per @code{until})
address@hidden comando del debugger, @code{until}
address@hidden @code{until}, comando del debugger
address@hidden @code{u}, comando del debugger (alias per @code{until})
address@hidden @code{until} address@hidden@code{:address@hidden |
@var{funzione}]
address@hidden @code{u} address@hidden@code{:address@hidden | @var{funzione}]
+Senza argomenti, prosegue l'esecuzione finch@'e non viene raggiunta una riga
+dopo la riga corrente nello @dfn{stack frame} corrente.
+Se viene specificato un argomento,
+prosegue l'esecuzione finch@'e non viene raggiunto il punto specificato, o
+lo @dfn{stack frame} corrente non termina l'esecuzione.
address@hidden table
+
address@hidden Vedere e modificare dati
address@hidden Vedere e modificare dati
+
+I comandi per vedere e modificare variabili all'interno di @command{gawk} sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{display}
address@hidden @code{display}, comando del debugger
address@hidden @code{display} address@hidden | @address@hidden
+Aggiunge la variabile @var{var} (o il campo @address@hidden) alla lista di
+visualizzazione. Il valore della variabile o del campo @`e visualizzato ogni
+volta che il programma s'interrompe.
+Ogni variabile aggiunta alla lista @`e identificata da un numero univoco:
+
address@hidden
+gawk> @kbd{display x}
address@hidden 10: x = 1
address@hidden example
+
address@hidden
+La riga qui sopra mostra il numero di elemento assegnato, il nome della
+variabile e il suo
+valore corrente. Se la variabile di display fa riferimento a un parametro di
+funzione, @`e cancellata silenziosamente dalla lista non appena l'esecuzione
+raggiunge un contesto dove la variabile con quel nome non esiste address@hidden
+Senza argomenti, @code{display} mostra i valori correnti degli elementi della
+lista.
+
address@hidden comando del debugger, @code{eval}
address@hidden @code{eval}, comando del debugger
address@hidden valutare espressioni, nel debugger
address@hidden @code{eval "@var{istruzioni awk}"}
+Valuta @var{istruzioni awk} nel contesto del programma in esecuzione.
+Si address@hidden fare qualsiasi cosa che un programma @command{awk} farebbe:
assegnare
+valori a variabili, chiamare funzioni, e address@hidden@dotless{i}} via.
+
address@hidden @code{eval} @var{param}, @dots{}
address@hidden @var{istruzioni awk}
address@hidden @code{end}
+Questa forma di @code{eval} @`e simile alla precedente, solo che permette di
+definire
+``variabili locali'' che esistono nel contesto delle @var{istruzioni awk},
+invece di usare variabili o parametri di funzione address@hidden definiti nel
programma.
+
address@hidden comando del debugger, @code{p} (alias per @code{print})
address@hidden comando del debugger, @code{print}
address@hidden @code{print}, comando del debugger
address@hidden @code{p}, comando del debugger (alias per @code{print})
address@hidden stampare variabili, nel debugger
address@hidden @code{print} @address@hidden,} @var{var2} @dots{}]
address@hidden @code{p} @address@hidden,} @var{var2} @dots{}]
+Stampa i valori di una o address@hidden variabili o campi di @command{gawk}.
+I campi devono essere indicizzati usando delle costanti:
+
address@hidden
+gawk> @kbd{print $3}
address@hidden example
+
address@hidden
+Questo stampa il terzo campo del record di input (se il campo specificato non
+esiste, stampa il @samp{campo nullo}). Una variabile address@hidden essere un
elemento di
+un vettore, avente come indice una
+stringa di valore costante. Per stampare
+il contenuto di un vettore, si deve anteporre il simbolo @samp{@@} al nome del
+vettore:
+
address@hidden
+gawk> @kbd{print @@a}
address@hidden example
+
address@hidden
+L'esempio stampa gli indici e i corrispondenti valori di tutti gli elementi
+del vettore @code{a}.
+
address@hidden comando del debugger, @code{printf}
address@hidden @code{printf}, comando del debugger
address@hidden @code{printf} @var{formato} address@hidden,} @var{arg} @dots{}]
+Stampa un testo formattato. Il @var{formato} address@hidden includere sequenze
di
+protezione, come @samp{\n}
+(@pxref{Sequenze di protezione}).
+Non viene stampato nessun ritorno a capo che non sia stato specificato
+esplicitamente.
+
address@hidden comando del debugger, @code{set}
address@hidden @code{set}, comando del debugger
address@hidden assegnare valori a variabili, nel debugger
address@hidden @code{set} @address@hidden@var{valore}
+Assegna un valore costante (numero o stringa) a una variabile o a un campo di
address@hidden
+I valori di stringa devono essere racchiusi tra doppi apici
+(@code{"address@hidden@code{"}).
+
+Si possono impostare anche delle variabili speciali di @command{awk}, come
address@hidden, @code{NF}, @code{NR}, e address@hidden@dotless{i}} via.
+
address@hidden comando del debugger, @code{w} (alias per @code{watch})
address@hidden comando del debugger, @code{watch}
address@hidden @code{watch}, comando del debugger
address@hidden @code{w}, comando del debugger (alias per @code{watch})
address@hidden impostare un punto d'osservazione
address@hidden @code{watch} @var{var} | @address@hidden
address@hidden"@var{espressione}"}]
address@hidden @code{w} @var{var} | @address@hidden
address@hidden"@var{espressione}"}]
+Aggiunge la variabile @var{var} (o il campo @address@hidden) alla lista dei
+punti d'osservazione. Il debugger quindi interrompe il programma ogni volta
+che il valore della variabile o del campo cambia. A ogni elemento osservato
+viene assegnato un numero che address@hidden essere usato per cancellarlo
dalla lista
+usando il comando @code{unwatch} [non-osservare address@hidden
+
+Definendo un punto d'osservazione, si address@hidden anche porre una
condizione, che @`e
+un'espressione @command{awk} (racchiusa tra doppi apici) che il debugger valuta
+ogni volta che viene raggiunto il punto d'osservazione. Se la condizione @`e
+vera, il debugger interrompe l'esecuzione e rimane in attesa di un comando.
+Altrimenti, @command{gawk} prosegue nell'esecuzione del programma.
+
address@hidden comando del debugger, @code{undisplay}
address@hidden @code{undisplay}, comando del debugger
address@hidden interruzione visualizzazioni automatiche, nel debugger
address@hidden @code{undisplay} address@hidden
+Rimuove l'elemento numero @var{n} (o tutti gli elementi, se non vi sono
+argomenti) dalla lista delle visualizzazioni automatiche.
+
address@hidden comando del debugger, @code{unwatch}
address@hidden @code{unwatch}, comando del debugger
address@hidden cancellare punto d'osservazione
address@hidden @code{unwatch} address@hidden
+Rimuove l'elemento numero @var{n} (o tutti gli elementi, se non vi sono
+argomenti) dalla lista dei punti d'osservazione.
+
address@hidden table
+
address@hidden Stack di esecuzione
address@hidden Lavorare con lo stack
+
+Ogni volta che si esegue un programma che contiene chiamate di funzione,
address@hidden mantiene una pila contenente la lista delle chiamate di funzione
+che hanno portato al punto in cui il programma si trova in ogni momento. @`E
+possibile vedere a che punto si trova il programma, e anche muoversi
+all'interno della pila per vedere qual era lo stato delle cose nelle funzioni
+che hanno chiamato quella in cui ci si trova. I comandi per far questo sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{bt} (alias per @code{backtrace})
address@hidden comando del debugger, @code{backtrace}
address@hidden comando del debugger, @code{where} (alias per @code{backtrace})
address@hidden @code{backtrace}, comando del debugger
address@hidden @code{bt}, comando del debugger (alias per @code{backtrace})
address@hidden @code{where}, comando del debugger
address@hidden @code{where}, comando del debugger (alias per @code{backtrace})
address@hidden chiamate, @dfn{stack} (pila) delle, mostrare nel debugger
address@hidden @dfn{stack} (pila) delle chiamate, mostrare nel debugger
address@hidden pila (@dfn{stack}) delle chiamate, mostrare nel debugger
address@hidden tracciatura a ritroso, mostrare nel debugger
address@hidden @code{backtrace} address@hidden
address@hidden @code{bt} address@hidden
address@hidden @code{where} address@hidden
+Stampa a ritroso una traccia di tutte le chiamate di funzione (stack frame), o
+i dei @var{contatore} frame address@hidden interni se @var{contatore} > 0.
Stampa i
address@hidden frame address@hidden esterni se @var{contatore} < 0. La
tracciatura a
+ritroso mostra il nome e gli argomenti di ciascuna funzione, il sorgente
address@hidden, e il numero di riga. L'alias @code{where} per @code{backtrace}
+viene mantenuto per i vecchi utenti di GDB che potrebbero essere abituati a
+quel comando.
+
address@hidden comando del debugger, @code{down}
address@hidden @code{down}, comando del debugger
address@hidden @code{down} address@hidden
+Sposta @var{contatore} (default 1) frame sotto la pila verso il frame
address@hidden interno.
+Poi seleziona e stampa il frame.
+
address@hidden comando del debugger, @code{f} (alias per @code{frame})
address@hidden comando del debugger, @code{frame}
address@hidden @code{frame}, comando del debugger
address@hidden @code{f}, comando del debugger (alias per @code{frame})
address@hidden @code{frame} address@hidden
address@hidden @code{f} address@hidden
+Seleziona e stampa lo @dfn{stack frame} @var{n}. Il frame 0 @`e quello
+correntemente in esecuzione, o il frame @address@hidden interno}, (chiamata di
+funzione); il frame 1 @`e il frame che ha chiamato quello address@hidden
interno. Il frame
+col numero address@hidden alto @`e quello per il programma principale. Le
informazioni
+stampate comprendono il numero di frame, i nomi delle funzioni e degli
+argomenti, i file sorgenti e le righe sorgenti.
+
address@hidden comando del debugger, @code{up}
address@hidden @code{up}, comando del debugger
address@hidden @code{up} address@hidden
+Sposta @var{contatore} (default 1) frame sopra la pila verso il frame
address@hidden
+esterno. Poi seleziona e stampa il frame.
address@hidden table
+
address@hidden Informazioni sul debugger
address@hidden Ottenere informazioni sullo stato del programma e del debugger
+
+Oltre che vedere i valori delle variabili, spesso si ha address@hidden di
ottenere
+informazioni di altro tipo sullo stato del programma e dello stesso ambiente di
+debug. Il debugger di @command{gawk} ha un comando che fornisce
+quest'informazione, chiamato convenientemente @code{info}. @code{info}
address@hidden usato con uno dei tanti argomenti che dicono esattamente quel
che si vuol
+sapere:
+
address@hidden @asis
address@hidden comando del debugger, @code{i} (alias per @code{info})
address@hidden comando del debugger, @code{info}
address@hidden @code{info}, comando del debugger
address@hidden @code{i}, comando del debugger (alias per @code{info})
address@hidden @code{info} @var{cosa}
address@hidden @code{i} @var{cosa}
+Il valore di @var{cosa} dovrebbe essere uno dei seguenti:
+
address@hidden nested table
address@hidden @code
address@hidden args
address@hidden mostrare argomenti delle funzioni, nel debugger
address@hidden debugger, mostrare argomenti delle funzioni
+Elenca gli argomenti del frame selezionato.
+
address@hidden break
address@hidden mostrare punti d'interruzione, nel debugger
address@hidden debugger, mostrare punti d'interruzione
+Elenca tutti i punti d'interruzione attualmente impostati.
+
address@hidden display
address@hidden visualizzazioni automatiche, nel debugger
address@hidden debugger, visualizzazioni automatiche
+Elenca tutti gli elementi della lista delle visualizzazioni automatiche.
+
address@hidden frame
address@hidden descrizione degli @dfn{stack frame} delle chiamate, nel debugger
address@hidden debugger, descrizione degli @dfn{stack frame} delle chiamate
address@hidden una descrizione degli @dfn{stack frame} selezionati.
+
address@hidden functions
address@hidden elencare definizioni delle funzioni, nel debugger
address@hidden debugger, elencare definizioni delle funzioni
+Elenca tutte le definizioni delle funzioni compresi i @value{FNS} e
+i numeri di riga.
+
address@hidden locals
address@hidden mostrare variabili locali, nel debugger
address@hidden debugger, mostrare variabili locali
+Elenca le variabili locali dei frame selezionati.
+
address@hidden source
address@hidden mostrare il nome del file sorgente corrente, nel debugger
address@hidden debugger, mostrare il nome del file sorgente corrente
+Stampa il nome del file sorgente corrente. Ogni volta che il programma si
+interrompe, il file sorgente corrente @`e il file che contiene l'istruzione
+corrente. Quando il debugger viene avviato per la prima volta, il file
+sorgente corrente @`e il primo file incluso attraverso l'opzione @option{-f}.
+Il comando @samp{list @var{nome-file}:@var{numero-riga}} address@hidden essere
usato in
+qualsiasi momento per cambiare il sorgente corrente.
+
address@hidden sources
address@hidden mostrare tutti i file sorgente, nel debugger
address@hidden debugger, mostrare tutti i file sorgenti
+Elenca tutti i sorgenti del programma.
+
address@hidden variables
address@hidden elencare tutte le variabili locali, nel debugger
address@hidden debugger, elencare tutte le variabili locali
+Elenca tutte le variabili locali.
+
address@hidden watch
address@hidden mostrare i punti d'osservazione, nel debugger
address@hidden debugger, mostrare i punti d'osservazione
+Elenca tutti gli elementi della lista dei punti d'osservazione.
address@hidden table
address@hidden table
+
+Ulteriori comandi permettono di avere il controllo sul debugger, la
address@hidden di
+salvare lo stato del debugger e la address@hidden di eseguire comandi del
debugger
+da un file. I comandi sono:
+
address@hidden @asis
address@hidden comando del debugger, @code{o} (alias per @code{option})
address@hidden comando del debugger, @code{option}
address@hidden @code{option}, comando del debugger
address@hidden @code{o}, comando del debugger (alias per @code{option})
address@hidden visualizzare le opzioni del debugger
address@hidden debugger, opzioni del
address@hidden @code{option} address@hidden@address@hidden
address@hidden @code{o} address@hidden@address@hidden
+Senza argomenti, visualizza le opzioni del debugger disponibili e i loro valori
+correnti. @samp{option @var{nome}} mostra il valore corrente dell'opzione
address@hidden@dotless{i}} denominata. @samp{option @address@hidden assegna
+un nuovo valore all'opzione.
+Le opzioni disponibili sono:
+
address@hidden nested table
address@hidden asis for docbook
address@hidden @asis
address@hidden @code{history_size}
address@hidden debugger, dimensione della cronologia
+Imposta il numero massimo di righe da mantenere nel file della cronologia
address@hidden/.gawk_history}. Il valore di default @`e 100.
+
address@hidden @code{listsize}
address@hidden debugger, numero di righe nella lista di default
+Specifica il numero di righe che @code{list} deve stampare. Il valore di
+default @`e 15.
+
address@hidden @code{outfile}
address@hidden ridirezionare l'output di @command{gawk}, nel debugger
address@hidden debugger, ridirezionare l'output di @command{gawk}
+Invia l'output di @command{gawk} in un file; l'output del debugger @`e
+visualizzato comunque anche
+nello standard output. Assegnare come valore stringa vuota (@code{""})
+reimposta l'output solo allo standard output.
+
address@hidden @code{prompt}
address@hidden debugger, prompt
+Cambia la riga per l'immissione dei comandi del debugger. Il valore di
+default @`e @address@hidden> }}.
+
address@hidden @code{save_history} address@hidden | @code{off}]
address@hidden debugger, file della cronologia
+Salva la cronologia dei comandi nel file @file{./.gawk_history}.
+L'impostazione di default @`e @code{on}.
+
address@hidden @code{save_options} address@hidden | @code{off}]
address@hidden salvataggio opzioni debugger
address@hidden debugger, salvataggio opzioni
+Salva le opzioni correnti nel file @file{./.gawkrc} all'uscita.
+L'impostazione di default @`e @code{on}.
+Le opzioni sono lette di nuovo all'avvio della sessione successiva.
+
address@hidden @code{trace} address@hidden | @code{off}]
address@hidden istruzioni, tener traccia delle, nel debugger
address@hidden debugger, tener traccia delle istruzioni
+Attiva o disattiva il tracciamento delle istruzioni. L'impostazione di default
address@hidden @code{off}.
address@hidden table
+
address@hidden @code{save} @var{nome-file}
+Salva i comandi eseguiti nella sessione corrente nel @value{FN} indicato,
+in modo da poterli ripetere in seguito usando il comando @command{source}.
+
address@hidden @code{source} @var{nome-file}
address@hidden debugger, leggere comandi da un file
+Esegue comandi contenuti in un file; un errore in un comando non impedisce
+l'esecuzione dei comandi successivi. In un file di comandi sono consentiti
+i commenti (righe che iniziano con @samp{#}).
+Le righe vuote vengono ignorate; esse @emph{non}
+ripetono l'ultimo comando.
+Non si address@hidden riavviare il programma mettendo address@hidden di un
comando @code{run}
+nel file. Inoltre, la lista dei comandi address@hidden includere altri comandi
address@hidden; in ogni caso, il debugger di @command{gawk} non richiama lo
+stesso file address@hidden di una volta per evitare ricorsioni infinite.
+
+Oltre al comando @code{source}, o al posto di esso, si possono usare le opzioni
+sulla riga di comando @option{-D @var{file}} o @address@hidden
+per eseguire comandi da un file in maniera non interattiva
+(@pxref{Opzioni}).
address@hidden table
+
address@hidden Comandi vari del debugger
address@hidden Comandi vari del debugger
+
+Ci sono alcuni altri comandi che non rientrano nelle precedenti categorie,
+come i seguenti:
+
address@hidden @asis
address@hidden comando del debugger, @code{dump}
address@hidden @code{dump}, comando del debugger
address@hidden @code{dump} address@hidden
+Riversa il @dfn{byte code} del programma nello standard output o nel file
+definito in @var{nome-file}. Questo stampa una rappresentazione delle
+istruzioni interne che @command{gawk} esegue per implementare i comandi
address@hidden in un programma. address@hidden address@hidden essere molto
istruttivo, come
+dimostra il seguente riversamento parziale del codice offuscato di
+Davide Brini (@pxref{Programma signature}):
+
address@hidden FIXME: This will need updating if num-handler branch is ever
merged in.
address@hidden
+gawk> @kbd{dump}
address@hidden # BEGIN
address@hidden
address@hidden [ 1:0xfcd340] Op_rule : [in_rule = BEGIN]
[source_file = brini.awk]
address@hidden [ 1:0xfcc240] Op_push_i : "~" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc2a0] Op_push_i : "~" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc280] Op_match :
address@hidden [ 1:0xfcc1e0] Op_store_var : O
address@hidden [ 1:0xfcc2e0] Op_push_i : "==" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc340] Op_push_i : "==" [MALLOC|STRING|STRCUR]
address@hidden [ 1:0xfcc320] Op_equal :
address@hidden [ 1:0xfcc200] Op_store_var : o
address@hidden [ 1:0xfcc380] Op_push : o
address@hidden [ 1:0xfcc360] Op_plus_i : 0 [MALLOC|NUMCUR|NUMBER]
address@hidden [ 1:0xfcc220] Op_push_lhs : o [do_reference = true]
address@hidden [ 1:0xfcc300] Op_assign_plus :
address@hidden [ :0xfcc2c0] Op_pop :
address@hidden [ 1:0xfcc400] Op_push : O
address@hidden [ 1:0xfcc420] Op_push_i : "" [MALLOC|STRING|STRCUR]
address@hidden [ :0xfcc4a0] Op_no_op :
address@hidden [ 1:0xfcc480] Op_push : O
address@hidden [ :0xfcc4c0] Op_concat : [expr_count = 3] [concat_flag
= 0]
address@hidden [ 1:0xfcc3c0] Op_store_var : x
address@hidden [ 1:0xfcc440] Op_push_lhs : X [do_reference = true]
address@hidden [ 1:0xfcc3a0] Op_postincrement :
address@hidden [ 1:0xfcc4e0] Op_push : x
address@hidden [ 1:0xfcc540] Op_push : o
address@hidden [ 1:0xfcc500] Op_plus :
address@hidden [ 1:0xfcc580] Op_push : o
address@hidden [ 1:0xfcc560] Op_plus :
address@hidden [ 1:0xfcc460] Op_leq :
address@hidden [ :0xfcc5c0] Op_jmp_false : [target_jmp = 0xfcc5e0]
address@hidden [ 1:0xfcc600] Op_push_i : "%c" [MALLOC|STRING|STRCUR]
address@hidden [ :0xfcc660] Op_no_op :
address@hidden [ 1:0xfcc520] Op_assign_concat : c
address@hidden [ :0xfcc620] Op_jmp : [target_jmp = 0xfcc440]
address@hidden
address@hidden
address@hidden
address@hidden [ 2:0xfcc5a0] Op_K_printf : [expr_count = 17]
[redir_type = ""]
address@hidden [ :0xfcc140] Op_no_op :
address@hidden [ :0xfcc1c0] Op_atexit :
address@hidden [ :0xfcc640] Op_stop :
address@hidden [ :0xfcc180] Op_no_op :
address@hidden [ :0xfcd150] Op_after_beginfile :
address@hidden [ :0xfcc160] Op_no_op :
address@hidden [ :0xfcc1a0] Op_after_endfile :
+gawk>
address@hidden smallexample
+
address@hidden comando del debugger, @code{exit}
address@hidden @code{exit}, comando del debugger
address@hidden uscire dal debugger
address@hidden debugger, uscire dal
address@hidden @code{exit}
+Esce dal debugger.
+Si veda la voce @samp{quit}, address@hidden avanti in quest'elenco.
+
address@hidden comando del debugger, @code{h} (alias per @code{help})
address@hidden comando del debugger, @code{help}
address@hidden @code{help}, comando del debugger
address@hidden @code{h}, comando del debugger (alias per @code{help})
address@hidden @code{help}
address@hidden @code{h}
+Stampa una lista di tutti i comandi del debugger di @command{gawk} con un breve
+sommario su come usarli. @samp{help @var{comando}} stampa l'informazione sul
+comando @var{comando}.
+
address@hidden comando del debugger, @code{l} (alias per @code{list})
address@hidden comando del debugger, @code{list}
address@hidden @code{list}, comando del debugger
address@hidden @code{l}, comando del debugger (alias per @code{list})
address@hidden @code{list} address@hidden | @code{+} | @var{n} |
@address@hidden:address@hidden | @address@hidden | @var{funzione}]
address@hidden @code{l} address@hidden | @code{+} | @var{n} |
@address@hidden:address@hidden | @address@hidden | @var{funzione}]
+Stampa le righe specificate (per default 15) dal file sorgente corrente
+o il file chiamato @var{nome-file}. I possibili argomenti di @code{list}
+sono i seguenti:
+
address@hidden nested table
address@hidden @asis
address@hidden @code{-} (Meno)
+Stampa righe prima delle ultime righe stampate.
+
address@hidden @code{+}
+Stampa righe dopo le ultime righe stampate.
address@hidden senza argomenti fa la stessa cosa.
+
address@hidden @var{n}
+Stampa righe centrate attorno alla riga numero @var{n}.
+
address@hidden @address@hidden
+Stampa righe dalla numero @var{n} alla numero @var{m}.
+
address@hidden @address@hidden:address@hidden
+Stampa righe centrate attorno alla riga numero @var{n} nel file sorgente
address@hidden Questo comando address@hidden cambiare il file sorgente corrente.
+
address@hidden @var{funzione}
+Stampa righe centrate attorno all'inizio della funzione @var{function}.
+Questo comando address@hidden cambiare il file sorgente corrente.
address@hidden table
+
address@hidden comando del debugger, @code{q} (alias per @code{quit})
address@hidden comando del debugger, @code{quit}
address@hidden @code{quit}, comando del debugger
address@hidden @code{q}, comando del debugger (alias per @code{quit})
address@hidden uscire dal debugger
address@hidden debugger, uscire dal
address@hidden @code{quit}
address@hidden @code{q}
+Esce dal debugger. Fare il debug @`e divertente, ma noi tutti a volte
+dobbiamo far fronte ad altri impegni nella vita, e talvolta troviamo il bug
+e possiamo tranquillamente passare a quello successivo! Come abbiamo visto
+prima, se si sta eseguendo un programma, il debugger avverte quando si batte
address@hidden o @samp{quit}, in modo da essere sicuri di voler realmente
abbandonare
+il debug.
+
address@hidden comando del debugger, @code{trace}
address@hidden @code{trace}, comando del debugger
address@hidden @code{trace} address@hidden | @code{off}]
+Abilita o disabilita la stampa continua delle istruzioni che si stanno per
+eseguire, assieme alle righe di @command{awk} che implementano.
+L'impostazione di default @`e @code{off}.
+
address@hidden auspicabile che la maggior parte dei ``codici operativi'' (o
``opcode'')
+in queste istruzioni siano sufficientemente autoesplicativi, e l'uso di
address@hidden e @code{nexti} mentre @code{trace} @`e abilitato li
address@hidden
+familiari.
+
address@hidden table
+
address@hidden Supporto per Readline
address@hidden Supporto per Readline
address@hidden completamento dei comandi nel debugger
address@hidden espansione della cronologia, nel debugger
address@hidden debugger, completamento dei comandi nel
+
+Se @command{gawk} @`e compilato con
address@hidden://cnswww.cns.cwru.edu/php/chet/readline/readline.html, la
libreria
+GNU Readline}, ci si address@hidden avvantaggiare delle sue address@hidden
riguardanti il
+completamento dei comandi della libreria e l'espansione della cronologia. Sono
+disponibili i seguenti tipi di completamento:
+
address@hidden @asis
address@hidden Completamentto dei comandi
+Nomi dei comandi.
+
address@hidden Completamento del @value{FN} del sorgente
address@hidden dei sorgenti. I relativi comandi sono
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden Completamento di argomento
+Argomenti di un comando non numerici.
+I relativi comandi sono @code{enable} e @code{info}.
+
address@hidden Completamento del nome di variabile
+Interessa i nomi delle variabili globali, e gli argomenti di funzione nel
+contesto corrente se
+il programma @`e in esecuzione. I relativi comandi sono
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden table
+
address@hidden Limitazioni
address@hidden Limitazioni
+
+Si spera che il lettore trovi il debugger di @command{gawk} utile e piacevole
+da usare, ma come accade per ogni programma, specialmente nelle sue prime
+versioni, ha ancora delle limitazioni. Quelle di cui @`e bene essere al
corrente sono:
+
address@hidden @value{BULLET}
address@hidden
+Nella versione presente, il debugger non address@hidden una spiegazione
dettagliata
+dell'errore che
+si @`e commesso quando si immette qualcosa che il debugger ritiene sbagliato.
+La risposta invece @`e solamente @samp{syntax error}. Quando si arriva a
capire
+l'errore commesso, tuttavia, ci si address@hidden come un vero guru.
+
address@hidden
address@hidden NOTE: no comma after the ref{} on purpose, due to following
address@hidden parenthetical remark.
+Se si studiano i ``dump'' dei codici operativi
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden vari del debugger}
+(o se si ha address@hidden address@hidden con i comandi interni di
@command{gawk}),
+ci si address@hidden conto che gran parte della manipolaziona interna di dati
+in @command{gawk}, address@hidden@dotless{i}} come in molti interpreti, @`e
fatta su di una pila.
address@hidden, @code{Op_pop}, e simili sono il pane quotidiano di
+gran parte del codice di @command{gawk}.
+
+Sfortunatamente, al momento, il debugger di @command{gawk} non consente
+di esaminare i contenuti della pila.
address@hidden, i risultati intermedi della valutazione delle espressioni sono
sulla
+pila, ma non @`e possibile stamparli. Invece, possono essere stampate solo
+quelle variabili che sono state definite nel programma. Naturalmente, un
+espediente per cercare di rimediare @`e di usare address@hidden variabili
esplicite in
+fase di debug e
+poi cambiarle di nuovo per ottenere un codice forse address@hidden difficile da
+comprendere, ma address@hidden ottimizzato.
+
address@hidden
+Non c'@`e alcun modo per guardare ``dentro'' al processo della compilazione
delle
+espressioni regolari per vedere se corrispondono a quel che si intendeva.
+Come programmatore
+di @command{awk}, ci si aspetta che chi legge conosca il significato di
address@hidden/[^[:alnum:][:blank:]]/}.
+
address@hidden
+Il debugger di @command{gawk} @`e progettato per essere usato eseguendo un
+programma (con tutti i suoi parametri) dalla riga di comando, come descritto
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden del debugger}. Non c'@`e alcun modo (al momento) di modificare
+o di ``entrare dentro'' l'esecuzione di un programma.
+Questo sembra ragionevole per un linguaggio che @`e usato principalmente per
+eseguire programmi piccoli e che non richiedono molto tempo di esecuzione.
+
address@hidden
+Il debugger di @command{gawk} accetta solo codice sorgente fornito con
+l'opzione @option{-f}.
address@hidden itemize
+
address@hidden
address@hidden 11/2016: This no longer applies after all the type cleanup work
that's been done.
+C'@`e un altro punto che vale la pena di trattare. I debugger convenzionali
+vengono eseguiti in un processo (e quindi in una parte di memoria)
+separato dal programma su cui eseguono il debug (il @dfn{debuggato}, se
+si vuole).
+
+Il debugger di @command{gawk} @`e diverso; @`e parte integrante di
@command{gawk}.
address@hidden rende possibile, in rari casi, che @command{gawk} diventi un
eccellente
+dimostratore del principio d'indeterminazione di Heisenberg, secondo il quale
+il solo atto di osservare una cosa address@hidden modificarla. Si consideri il
seguente
+esempio:@footnote{Grazie a Hermann Peifer per quest'esempio.}
+
address@hidden
+$ @kbd{cat test.awk}
address@hidden @{ print typeof($1), typeof($2) @}
+$ @kbd{cat test.data}
address@hidden abc 123
+$ @kbd{gawk -f test.awk test.data}
address@hidden strnum strnum
address@hidden example
+
+Questo @`e quel che ci si aspetta: il campo data ha l'attributo STRNUM
+(@pxref{Tipi di variabile}). Ora vediamo cosa accade quando questo programma
+viene eseguito sotto il debugger:
+
address@hidden
+$ @kbd{gawk -D -f test.awk test.data}
+gawk> @kbd{w $1} @ii{Imposta un punto d'osservazione su} $1
address@hidden Watchpoint 1: $1
+gawk> @kbd{w $2} @ii{Imposta il punto d'osservazione su} $2
address@hidden Watchpoint 2: $2
+gawk> @kbd{r} @ii{Avvia il programma}
address@hidden Partenza del programma:
address@hidden Mi fermo in Rule ...
address@hidden Watchpoint 1: $1 @ii{Scatta punto d'osservazione}
address@hidden Old value: ""
address@hidden New value: "abc"
address@hidden main() a `test.awk':1
address@hidden 1 @{ print typeof($1), typeof($2) @}
+gawk> @kbd{n} @ii{Prosegui @dots{}}
address@hidden Watchpoint 2: $2 @ii{Scatta punto d'osservazione}
address@hidden Old value: ""
address@hidden New value: "123"
address@hidden main() a `test.awk':1
address@hidden 1 @{ print typeof($1), typeof($2) @}
+gawk> @kbd{n} @ii{Prende il risultato da} typeof()
address@hidden strnum number @ii{Il risultato per} $2 @ii{non @`e
corretto}
address@hidden "normally" o "abnormally" @`e in inglese senza address@hidden di
modifiche.
address@hidden Programma completato normally, valore in uscita: 0
+gawk> @kbd{quit}
address@hidden example
+
+In questo caso, la richiesta di confrontare il nuovo valore di @code{$2}
+con quello vecchio ha richiesto che @command{gawk} lo valutasse e
+stabilisse che era proprio un numero, e questo @`e riflesso nel risultato di
address@hidden()}.
+
+Casi come questi in cui il debugger non @`e trasparente rispetto all'esecuzione
+del programma dovrebbero essere rari. Nel caso che se ne trovi uno, si
+prega di segnalarlo (@pxref{Bug}).
address@hidden ignore
+
address@hidden
+Look forward to a future release when these and other missing features may
+be added, and of course feel free to try to add them yourself!
address@hidden ignore
+
address@hidden Sommario sul debug
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Raramente i programmi funzionano bene al primo colpo. Trovare gli errori
+che contengono
+viene chiamato @dfn{debugging}, e un programma che aiuta a trovarli @`e un
address@hidden @command{gawk} ha un debugger incorporato che funziona in
+modo molto simile al debugger GNU, GDB.
+
address@hidden
+I debugger possono eseguire il programma un'istruzione per volta, esaminare e
+cambiare i
+valori delle variabili e dei vettori, e fanno tante altre cose per
+permettere di comprendere cosa sta facendo effettivamente il programma in un
+dato momento (a differenza del comportamento atteso).
+
address@hidden
+Come la maggior parte dei debugger, il debugger di @command{gawk} funziona in
+termini di stack frame, e si possono inserire sia punti d'interruzione
+(interruzioni a un certo punto del codice) sia punti d'osservazione
+(interruzioni quando il valore di un dato cambia).
+
address@hidden
+La serie di comandi del debugger @`e abbastanza completa, e permette di
+monitorare i
+punti d'interruzione, l'esecuzione, la visualizzazione e la
+modifica dei dati, di lavorare con le pile, ottenere informazioni, e di
+svolgere altri compiti.
+
address@hidden
+Se la libreria GNU Readline @`e disponibile al momento della compilazione di
address@hidden, viene usata dal debugger per fornire la cronologia della riga
+di comando e delle modifiche apportate durante il debug.
+
address@hidden
+Normalmente, il debugger non influenza il programma che sta controllando,
+ma questo address@hidden succedere occasionalmente.
+
address@hidden itemize
+
address@hidden Calcolo con precisione arbitraria
address@hidden Calcolo con precisione arbitraria con @command{gawk}
address@hidden precisione arbitraria
address@hidden precisione multipla
address@hidden precisione infinita
address@hidden virgola mobile, numeri address@hidden precisione arbitraria
+
+In questo @value{CHAPTER} si introducono alcuni concetti base su come i
+computer
+eseguono i calcoli e si definiscono alcuni termini importanti.
+Si continua poi descrivendo il calcolo in virgola mobile,
+che @`e quello che @command{awk} usa per tutte le sue operazioni aritmetiche,
+e si prosegue con
+una trattazione del calcolo in virgola mobile con precisione arbitraria,
+una address@hidden disponibile solo in @command{gawk}. Si passa poi a
+illustrare i numeri interi a precisione arbitraria e si conclude con una
+descrizione di alcuni punti sui quali @command{gawk} e lo standard POSIX non
+sono esattamente in accordo.
+
address@hidden NOTA
+La maggior parte degli utenti di @command{gawk} address@hidden saltare senza
patemi
+d'animo
+questo capitolo. Tuttavia, se si vogliono eseguire calcoli scientifici con
address@hidden, questo @`e il luogo adatto per imparare a farlo.
address@hidden quotation
+
address@hidden
+* Aritmetica del computer:: Una rapida introduzione alla matematica del
+ computer.
+* Definizioni matematiche:: Definizione dei termini usati.
+* address@hidden MPFR:: address@hidden MPFR in @command{gawk}.
+* Cautela col calcolo in VM:: Cose da sapere.
+* Interi a precisione arbitraria:: Calcolo con numeri interi a precisione
+ arbitraria con @command{gawk}.
+* Problemi virgola mobile POSIX:: Confronto tra standard e uso corrente.
+* Sommario virgola mobile:: Sommario della trattazione della
+ virgola mobile.
address@hidden menu
+
address@hidden Aritmetica del computer
address@hidden Una descrizione generale dell'aritmetica del computer
+
+Sinora, abbiamo avuto a che fare con dati come numeri o stringhe. Ultimamente,
+comunque, i computer rappresentano ogni cosa in termini di @dfn{cifre binarie},
+o @dfn{bit}. Una cifra decimale address@hidden assumere uno di 10 valori: da
zero a
+nove. Una cifra binaria address@hidden assumere uno di due valori: zero o
uno. Usando
+il sistema binario, i computer (e i programmi per computer) possono
+rappresentare e manipolare dati numerici e dati costituiti da caratteri. In
+generale, tanti address@hidden bit @`e possibile usare per rappresentare una
determinata
+cosa, tanto maggiore address@hidden l'intervallo dei possibili valori che essa
address@hidden
+assumere.
+
+I moderni calcolatori possono eseguire calcoli numerici in almeno due modi, e
+spesso anche di address@hidden Ogni tipo di calcolo usa una diversa
rappresentazione
+(organizzazione dei bit) dei numeri. Le address@hidden di calcolo che ci
interessano
+sono:
+
address@hidden @asis
address@hidden Calcolo decimale
+Questo @`e il tipo di calcolo che s'impara alle scuole elementari, usando
+carta e penna (o anche una calcolatrice). In teoria, i numeri possono avere un
+numero arbitrario di cifre su ambo i lati del separatore decimale, e il
+risultato di un'operazione @`e sempre esatto.
+
+Alcuni sistemi moderni possono eseguire calcoli decimali direttamente,
+tramite apposite istruzioni disponibili
+nell'hardware dell'elaboratore, ma normalmente si ha address@hidden di una
speciale
+libreria software che consenta di effettuare le operazioni desiderate.
+Ci sono anche librerie che svolgono i calcoli decimali interamente
+per via software.
+
+Anche se alcuni utenti si aspettano che @command{gawk} effettui delle
+operazioni usando numeri in base decimale,@footnote{Non sappiamo perch@'e se
+lo aspettino, ma @`e address@hidden@dotless{i}}.} non @`e questo quello che
succede.
+
address@hidden La matematica coi numeri interi
+A scuola ci hanno insegnato che i valori interi erano quei numeri privi di una
+parte frazionaria, come 1, 42, o @minus{}17.
+Il vantaggio dei numeri interi @`e che essi rappresentano dei valori in maniera
+esatta. Lo svantaggio @`e che i numeri rappresentabili sono limitati.
+
address@hidden senza segno, interi
address@hidden segno, interi senza
address@hidden interi senza segno
+Nei calcolatori, i valori interi sono di due tipi: @dfn{con segno} e
address@hidden segno}. I valori con segno possono essere negativi o positivi,
+mentre i valori senza segno sono sempre maggiori o uguali a zero.
+
+Nei sistemi informatici, il calcolo con valori interi @`e esatto, ma il
possibile
+campo di variazione dei valori @`e limitato. L'elaborazione con numeri interi
@`e
address@hidden veloce di quella con numeri a virgola mobile.
+
address@hidden La matematica coi numeri a virgola mobile
+I numeri a virgola mobile rappresentano quelli che a scuola sono chiamati
+numeri ``reali'' (address@hidden, quelli che hanno una parte frazionaria, come
+3.1415927). Il vantaggio dei numeri a virgola mobile @`e che essi possono
+rappresentare uno spettro di valori molto address@hidden ampio di quello
rappresentato dai
+numeri interi. Lo svantaggio @`e che ci sono numeri che essi non possono
+rappresentare in modo esatto.
+
+I computer moderni possono eseguire calcoli su valori a virgola mobile
+nell'hardware dell'elaboratore, entro un intervallo di valori limitato.
+Ci sono inoltre librerie di programmi che consentono calcoli, usando numeri a
+virgola mobile, di precisione arbitraria.
+
+POSIX @command{awk} usa numeri a virgola mobile a @dfn{doppia precisione},
+che possono gestire address@hidden cifre rispetto ai numeri a virgola mobile a
address@hidden precisione}. @command{gawk} ha inoltre address@hidden, descritte
+in dettaglio address@hidden sotto, che lo mettono in grado di eseguire
+calcoli con i numeri a virgola mobile con precisione arbitraria.
address@hidden table
+
+I calcolatori operano con valori interi e a virgola mobile su diversi
+intervalli. I valori interi normalmente hanno una dimensione di 32 bit o 64
bit.
+I valori a virgola mobile a singola precisione occupano 32 bit, mentre i
+valori a virgola mobile a doppia precisione occupano 64 bit. I valori a
+virgola mobile sono sempre con segno. Il possibile campo di variazione dei
+valori @`e mostrato in @ref{table-numeric-ranges}.
+
address@hidden Tabella,table-numeric-ranges
address@hidden dei valori per diverse rappresentazioni numeriche}
address@hidden @columnfractions .34 .33 .33
address@hidden Rappresentazione numerica @tab Valore minimo @tab Valore massimo
address@hidden Interi con segno a 32-bit @tab @minus{}2.147.483.648 @tab
2.147.483.647
address@hidden Interi senza segno a 32-bit @tab 0 @tab 4.294.967.295
address@hidden Interi con segno a 64-bit @tab @minus{}9.223.372.036.854.775.808
@tab 9.223.372.036.854.775.807
address@hidden Interi senza segno a 64-bit @tab 0 @tab
18.446.744.073.709.551.615
address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab
@math{1,175494^{-38}} @tab @math{3,402823^{38}}
address@hidden Virgola mobile, doppia precisione (circa) @tab
@math{2,225074^{-308}} @tab @math{1,797693^{308}}
address@hidden iftex
address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab 1,175494e-38
@tab 3,402823e38
address@hidden Virgola mobile, doppia precisione (circa) @tab 2,225074e-308
@tab 1,797693e308
address@hidden ifinfo
address@hidden
address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab 1,address@hidden
@tab 3,address@hidden
address@hidden Virgola mobile, singola precisione (circa) @tab 2,address@hidden
@tab 1,address@hidden
address@hidden ifnotinfo
address@hidden ifnottex
address@hidden multitable
address@hidden float
+
address@hidden Definizioni matematiche
address@hidden Altre cose da sapere
+
+Il resto di questo @value{CHAPTER} usa un certo numero di termini. Di seguito
+vengono date alcune definizioni informali che dovrebbero essere utili
+per la lettura di questo documento:
+
address@hidden @dfn
address@hidden Accuratezza
+L'accuratezza del calcolo sui numeri a virgola mobile indica di quanto si
+avvicina il calcolo al valore reale (calcolato con carta e penna).
+
address@hidden Errore
+La differenza tra quello che il risultato di un calcolo ``dovrebbe dare''
+e quello che effettivamente address@hidden @`E meglio minimizzare l'errore
quanto address@hidden
+possibile.
+
address@hidden Esponente
+L'ordine di grandezza di un valore;
+alcuni bit in un valore a virgola mobile contengono l'esponente.
+
address@hidden Inf
+Un valore speciale che rappresenta l'infinito. Le operazioni tra un qualsiasi
+numero e l'infinito danno infinito.
+
address@hidden Mantissa
+Un valore a virgola mobile @`e formato dalla mantissa moltiplicata per 10
+alla potenza dell'esponente. Per esempio, in @code{1,2345e67},
+la mantissa @`e @code{1,2345}.
+
address@hidden address@hidden di arrotondamento
+Come i numeri vanno arrotondati, per eccesso o per difetto, quando necessario.
+Maggiori dettagli verranno forniti in seguito.
+
address@hidden NaN
+``Not a number'' (Non un Numero)address@hidden a Michael
+Brennan per questa descrizione, che abbiamo parafrasato, e per gli esempi.} Un
+valore speciale che risulta da un calcolo che non ha risposta come numero
+reale. In tal caso, i programmi possono o ricevere un'eccezione di virgola
+mobile, o restituire @code{NaN} come risultato. Lo standard IEEE 754
+consiglia che i sistemi restituiscano @code{NaN}. Alcuni esempi:
+
address@hidden @code
address@hidden sqrt(-1)
+La radice quadrata di @minus{}1 ha senso nell'insieme dei numeri complessi,
+ma non nell'insieme dei numeri reali,
+per cui il risultato @`e @code{NaN}.
+
address@hidden log(-8)
+Il logaritmo di @minus{}8 @`e fuori dal dominio di @code{log()},
+per cui il risultato @`e @code{NaN}.
address@hidden table
+
address@hidden Normalizzato (formato)
+Come la mantissa (vedi oltre in questa lista) @`e usualmente memorizzata. Il
+valore viene aggiustato in modo che il primo bit sia sempre uno,
+e in questo modo l'uno iniziale @`e supposto presente (per come viene
+generato il numero), ma non @`e memorizzato fisicamente.
+Questo fornisce un bit di precisione in address@hidden
+
address@hidden Precisione
+Il numero di bit usati per rappresentare un numero a virgola mobile.
address@hidden sono i bit, e maggiore @`e l'intervallo di cifre che si possono
+rappresentare.
+Le precisioni binaria e decimale sono legate in modo approssimativo, secondo
+la formula:
+
address@hidden
address@hidden
address@hidden = 3.322 @cdot dps}
address@hidden iftex
address@hidden
address@hidden
address@hidden = 3.322 * @var{dps}
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>prec</emphasis> = 3.322 ⋅ <emphasis>dps</emphasis>
address@hidden docbook
address@hidden display
+
address@hidden
+Qui, @emph{prec} indica la precisione binaria
+(misurata in bit) e @emph{dps} (abbreviazione di "decimal places")
+indica le cifre decimali.
+
address@hidden address@hidden
address@hidden://en.wikipedia.org/wiki/Numerical_stability,
+l'articolo di Wikipedia sulla address@hidden numerica}:
+``I calcoli per i quali si address@hidden dimostrare che non amplificano gli
errori di
+approssimazione sono chiamati @dfn{numericamente stabili}.''
address@hidden table
+
+Si veda @uref{http://en.wikipedia.org/wiki/Accuracy_and_precision,
+l'articolo di Wikipedia su accuratezza e precisione} per maggiori informazioni
+su questi due termini.
+
+Sui computer moderni, l'address@hidden di calcolo in virgola mobile usa la
+rappresentazione e le operazioni definite dallo standard IEEE 754.
+Tre dei tipi definiti nello standard IEEE 754 sono:
+32-bit singola precisione,
+64-bit doppia precisione e
+128-bit quadrupla precisione.
+Lo standard specifica anche formati a precisione estesa
+per consentire una maggiore precisione e campi di variazione degli esponenti
address@hidden ampi. (@command{awk} usa solo il formato a 64-bit doppia
precisione.)
+
address@hidden elenca la precisione e i valori di campo
+dell'esponente per i principali formati binari IEEE 754.
+
address@hidden Tabella,table-ieee-formats
address@hidden per i principali formati IEEE}
address@hidden @columnfractions .20 .20 .20 .20 .20
address@hidden Nome @tab Bit totali @tab Precisione @tab Esponente minimo @tab
Esponente massimo
address@hidden Singola @tab 32 @tab 24 @tab @minus{}126 @tab +127
address@hidden Doppia @tab 64 @tab 53 @tab @minus{}1022 @tab +1023
address@hidden Quadrupla @tab 128 @tab 113 @tab @minus{}16382 @tab +16383
address@hidden multitable
address@hidden float
+
address@hidden NOTA
+I numeri che descrivono la precisione includono la cifra 1 iniziale
+implicita, il che equivale ad avere un bit in address@hidden nella mantissa.
address@hidden quotation
+
address@hidden address@hidden MPFR
address@hidden address@hidden per il calcolo a precisione arbitraria in
@command{gawk}
+
+Per default, @command{gawk} usa i valori in virgola mobile a doppia precisione
+disponibili nell'hardware del sistema su cui viene eseguito.
+Tuttavia, se @`e stato compilato in modo da includere questa address@hidden
+ed @`e stata specificata
+l'opzione da riga di comando @option{-M}, @command{gawk} usa le librerie
address@hidden://www.mpfr.org, GNU MPFR} e @uref{http://gmplib.org, GNU MP}
(GMP)
+per effettuare calcoli sui numeri con una precisione arbitraria.
+Si address@hidden verificare se il supporto a MPFR @`e disponibile in questo
modo:
+
address@hidden
+$ @kbd{gawk --version}
address@hidden GNU Awk 4.1.2, API: 1.1 (GNU MPFR 3.1.0-p3, GNU MP 5.0.2)
address@hidden Copyright (C) 1989, 1991-2015 Free Software Foundation.
address@hidden
address@hidden example
+
address@hidden
+(I numeri di versione visualizzati possono essere diversi. Non importa;
+l'importante @`e che siano presenti GNU MPFR e GNU MP
+nel testo restituito.)
+
+Inoltre, ci sono alcuni elementi disponibili nel vettore @code{PROCINFO}
+per fornire informazioni sulle librerie MPFR e GMP
+(@pxref{Variabili auto-assegnate}).
+
+La libreria MPFR address@hidden un controllo accurato sulle precisioni e sulle
address@hidden di
+arrotondamento, e address@hidden risultati correttamente arrotondati,
riproducibili e
+indipendenti dalla piattaforma. Con l'opzione da riga di comando @option{-M},
+tutti gli operatori aritmetici e le funzioni in virgola mobile possono
+produrre risultati a ogni livello di precisione supportato da MPFR.
+
+Due variabili predefinite, @code{PREC} e @code{ROUNDMODE},
+danno il controllo sulla precisione di elaborazione e sulla address@hidden di
+arrotondamento. La precisione e la address@hidden di arrotondamento sono
impostate
+a livello globale per ogni operazione da eseguire.
address@hidden la precisione} e
address@hidden
+la
address@hidden iftex
address@hidden modi di arrotondare}
+per maggiori informazioni.
+
address@hidden Cautela col calcolo in VM
address@hidden Calcolo in virgola mobile: @dfn{Caveat Emptor}!
+
address@hidden
address@hidden'ora di matematica @`e ostica!}
address@hidden Teen Talk Barbie, luglio 1992
address@hidden quotation
+
+Questa @value{SECTION} fornisce un quadro dettagliato dei problemi che
+si presentano quando si eseguono molti calcoli in virgola
address@hidden'@`e un saggio molto bello
address@hidden://www.validlab.com/goldberg/paper.pdf, sul calcolo in
+virgola mobile} di David Goldberg, ``What Every Computer Scientist Should Know
+About Floating-Point Arithmetic,''
address@hidden Computing Surveys} @strong{23}, 1 (1991-03): 5-48. Vale la pena
di
+leggerlo, se si @`e interessati a scendere nei dettagli, address@hidden
richiede delle
+conoscenze informatiche.}
+Le spiegazioni fornite valgono sia per il calcolo in virgola mobile
+effettuato direttamente dall'hardware del computer, sia per quello
+ottenuto tramite il software per la precisione arbitraria.
+
address@hidden ATTENZIONE
+Le informazioni fornite in questa sede sono deliberatamente di tipo generale.
+Se si devono eseguire calcoli complessi col computer, si dovrebbero prima
+ottenere ulteriori informazioni, e non basarsi solo su quanto qui detto.
address@hidden quotation
+
address@hidden
+* Inesattezza nei calcoli:: La matematica in virgola mobile non @`e
+ esatta.
+* Ottenere la precisione:: Ottenere address@hidden precisione richiede
qualche
+ sforzo.
+* Tentare di arrotondare:: Aggiungere cifre di precisione e arrotondare.
+* Impostare la precisione:: Come impostare la precisione.
+* Impostare modi di arrotondare:: Impostare le address@hidden di
arrotondamento.
address@hidden menu
+
address@hidden Inesattezza nei calcoli
address@hidden La matematica in virgola mobile non @`e esatta
+
+Le rappresentazioni e i calcoli con numeri a virgola mobile binari sono
+inesatti. Semplici valori come 0,1 non possono essere rappresentati in modo
+preciso usando numeri a virgola mobile binari, e la limitata precisione dei
+numeri a virgola mobile significa che piccoli cambiamenti nell'ordine delle
+operazioni o la precisione di memorizzazione di operazioni
+intermedie address@hidden cambiare il
+risultato. Per rendere la situazione address@hidden difficile, nel calcolo in
virgola
+mobile con precisione arbitraria, si address@hidden impostare la precisione
prima di
+eseguire un calcolo, address@hidden non si address@hidden sapere con certezza
quale address@hidden
+il numero di cifre decimali esatte nel risultato finale.
+
address@hidden
+* Rappresentazioni inesatte:: I numeri non sono rappresentati esattamente.
+* Confronti tra valori in VM:: Come confrontare valori in virgola mobile.
+* Gli errori si sommano:: Gli errori diventano sempre maggiori.
address@hidden menu
+
address@hidden Rappresentazioni inesatte
address@hidden Molti numeri non possono essere rappresentati esattamente
+
address@hidden, prima di iniziare a scrivere del codice, si dovrebbe pensare
+al risultato che si vuole effettivamente ottenere e a cosa realmente accade.
+Si considerino i due numeri nel seguente esempio:
+
address@hidden
+x = 0.875 # 1/2 + 1/4 + 1/8
+y = 0.425
address@hidden example
+
+Diversamente dal numero in @code{y}, il numero memorizzato in @code{x}
address@hidden rappresentabile esattamente nel formato binario, perch@'e
address@hidden essere
+scritto come somma finita di una o address@hidden frazioni i cui denominatori
sono tutti
+multipli di due.
+Quando @command{gawk} legge un numero a virgola mobile dal sorgente di un
+programma, arrotonda automaticamente quel numero alla precisione, quale che
+sia, supportata dal computer in uso. Se si tenta di stampare il contenuto
+numerico di una variabile usando una stringa di formato in uscita di
address@hidden"%.17g"}, il valore restituito address@hidden non essere lo
stesso numero assegnato
+a quella variabile:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ x = 0.875; y = 0.425}
+> @kbd{ printf("%0.17g, %0.17g\n", x, y) @}'}
address@hidden 0.875, 0.42499999999999999
address@hidden example
+
+Spesso l'errore @`e talmente piccolo da non essere neppure notato, e se @`e
stato
+notato, si address@hidden sempre specificare il grado di precisione si vuole
nell'output.
+In genere questo @`e una stringa di formato come @code{"%.15g"} che, se usata
+nell'esempio precedente, address@hidden luogo a un output identico all'input.
+
address@hidden Confronti tra valori in VM
address@hidden Fare attenzione quando si confrontano valori
+
+Poich@'e la rappresentazione interna del computer
address@hidden discostarsi, sia pur di poco, dal valore
+esatto, confrontare dei valori a virgola mobile per vedere se sono esattamente
+uguali @`e generalmente una pessima idea. Questo @`e un esempio in cui tale
+confronto non funziona come dovrebbe:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{ print (0.1 + 12.2 == 12.3) @}'}
address@hidden 0
address@hidden example
+
+Il metodo generalmente seguito per confrontare valori a virgola mobile
+consiste nel controllare se la differenza tra loro @`e minore di un certo
valore
+(chiamato @dfn{delta}, o @dfn{tolleranza}). Quel che si deve decidere @`e qual
address@hidden il valore minimo di delta
+adeguato. Il codice per far address@hidden @`e qualcosa del genere:
+
address@hidden
+delta = 0.00001 # per esempio
+differenza = abs(a) - abs(b) # sottrazione dei due valori
+if (differenza < delta)
+ # va bene
+else
+ # non va bene
address@hidden example
+
address@hidden
+(Si presuppone che sia stata definita in qualche parte del programma una
+semplice funzione che restituisce il valore assoluto di un numero,
+chiamata @code{abs()}.)
+
address@hidden Gli errori si sommano
address@hidden Gli errori diventano sempre maggiori
+
+La perdita di accuratezza in un singolo calcolo con numeri a virgola mobile
+generalmente non dovrebbe destare preoccupazione. Tuttavia, se si calcola un
+valore che @`e una sequenza di operazioni in virgola mobile, l'errore si
address@hidden
+accumulare e influire sensibilmente sul risultato del calcolo stesso.
+Qui sotto vediamo un tentativo di calcolare il valore di @value{PI} usando
+una delle sue rappresentazioni
+come somma di una serie di numeri:
+
address@hidden
+BEGIN @{
+ x = 1.0 / sqrt(3.0)
+ n = 6
+ for (i = 1; i < 30; i++) @{
+ n = n * 2.0
+ x = (sqrt(x * x + 1) - 1) / x
+ printf("%.15f\n", n * x)
+ @}
address@hidden
address@hidden example
+
+Quando viene eseguito, gli errori iniziali si propagano nei calcoli
+successivi, facendo terminare il ciclo prematuramente dopo un tentativo di
+divisione per zero:
+
address@hidden
+$ @kbd{gawk -f pi.awk}
address@hidden 3.215390309173475
address@hidden 3.159659942097510
address@hidden 3.146086215131467
address@hidden 3.142714599645573
address@hidden
address@hidden 3.224515243534819
address@hidden 2.791117213058638
address@hidden 0.000000000000000
address@hidden gawk: pi.awk:6: fatale: tentativo di dividere per zero
address@hidden example
+
+Ecco un altro esempio in cui l'inaccuratezza nelle rappresentazioni interne
+porta a un risultato inatteso:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{for (d = 1.1; d <= 1.5; d += 0.1) # esegue il ciclo cinque volte (?)}
+> @kbd{i++}
+> @kbd{print i}
+> @address@hidden'}
address@hidden 4
address@hidden example
+
address@hidden Ottenere la precisione
address@hidden Ottenere la precisione voluta
+
address@hidden il calcolo con precisione arbitraria dare risultati esatti? Non
ci sono
+risposte facili. Le regole standard dell'algebra spesso non valgono
+nei calcoli con precisione arbitraria.
+Tra le altre cose, le leggi distributiva e associativa non sono rispettate
+completamente, e l'ordine dell'operazione address@hidden essere importante per
+il calcolo.
+Errori di arrotondamento, perdite di precisione che si accumulano, e
+valori molto vicini allo zero sono spesso causa di problemi.
+
+Quando @command{gawk} verifica l'eguaglianza delle espressioni
address@hidden + 12.2} e @samp{12.3} usando l'aritmetica a doppia precisione
della
+macchina, decide che non sono uguali! (@xref{Confronti tra valori in VM}.)
+Si address@hidden ottenere il risultato cercato aumentando la precisione; 56
bit in
+questo caso sono sufficienti:
+
address@hidden
+$ @kbd{gawk -M -v PREC=56 'BEGIN @{ print (0.1 + 12.2 == 12.3) @}'}
address@hidden 1
address@hidden example
+
+Se aggiungere address@hidden bit @`e una buona cosa, aggiungerne ancora di
address@hidden
address@hidden meglio?
+Ecco cosa succede se si usa un valore di @code{PREC} ancora address@hidden
alto:
+
address@hidden
+$ @kbd{gawk -M -v PREC=201 'BEGIN @{ print (0.1 + 12.2 == 12.3) @}'}
address@hidden 0
address@hidden example
+
+Non @`e un bug di @command{gawk} o della libreria MPFR.
address@hidden facile dimenticare che il numero finito di bit usato per
memorizzare il
+valore spesso @`e solo un'approssimazione dopo un opportuno arrotondamento. Il
+test di uguaglianza riesce se e solo se @emph{tutti} i bit dei due operandi
+sono esattamente gli stessi. Poich@'e questo non @`e necessariamente vero dopo
un
+calcolo in virgola mobile con una determinata precisione e con una
address@hidden di
+arrotondamento valida, un test di eguaglianza convenzionale potrebbe non
+riuscire. Invece, il test riesce confrontando i due numeri per vedere se la
+differenza tra di loro rientra in un delta accettabile.
+
+In applicazioni dove sono sufficienti fino a 15 cifre decimali,
+il calcolo in doppia precisione eseguito dall'hardware del computer
address@hidden essere una buona soluzione,
+e in genere @`e address@hidden veloce. address@hidden bisogna tener presente
che ogni operazione in
+virgola mobile address@hidden subire un nuovo errore di arrotondamento con
conseguenze
+catastrofiche, come si @`e visto nel precedente tentativo di calcolare il
valore
+di @value{PI}.
+In tali casi una precisione supplementare address@hidden aumentare la
address@hidden e
+l'accuratezza del calcolo.
+
+Oltre a address@hidden, bisogna tenere conto del fatto che
+addizioni ripetute non sono necessariamente equivalenti a una moltiplicazione
+nell'aritmetica in virgola mobile. Nell'esempio visto in
address@hidden errori si sommano}:
+
address@hidden
+$ @kbd{gawk 'BEGIN @{}
+> @kbd{for (d = 1.1; d <= 1.5; d += 0.1) # ciclo eseguito cinque volte (?)}
+> @kbd{i++}
+> @kbd{print i}
+> @address@hidden'}
address@hidden 4
address@hidden example
+
address@hidden
+non @`e detto che, scegliendo per @code{PREC} un valore arbitrariamente alto,
si
+riesca a ottenere il risultato corretto. La riformulazione del problema in
+questione @`e spesso il modo corretto di comportari in tali situazioni.
+
address@hidden Tentare di arrotondare
address@hidden Tentare di aggiungere bit di precisione e arrotondare
+
+Invece dell'aritmetica in virgola mobile con precisione arbitraria,
+spesso tutto address@hidden di cui si ha bisogno @`e un aggiustamento della
logica
+o di un diverso ordine delle operazioni nei calcoli.
+La address@hidden e l'accuratezza del calcolo di @value{PI}
+nel primo esempio possono essere migliorata usando la seguente semplice
+trasformazione algebrica:
+
address@hidden
+(sqrt(x * x + 1) - 1) / x @equiv{} x / (sqrt(x * x + 1) + 1)
address@hidden example
+
address@hidden
+Dopo aver fatto questo cambiamento, il programma converge verso
address@hidden in meno di 30 iterazioni:
+
address@hidden
+$ @kbd{gawk -f pi2.awk}
address@hidden 3.215390309173473
address@hidden 3.159659942097501
address@hidden 3.146086215131436
address@hidden 3.142714599645370
address@hidden 3.141873049979825
address@hidden
address@hidden 3.141592653589797
address@hidden 3.141592653589797
address@hidden example
+
address@hidden Impostare la precisione
address@hidden Impostare la precisione
+
address@hidden usa una precisione di lavoro a livello globale; non tiene
+traccia della precisione e accuratezza dei singoli numeri. Eseguendo
+un'operazione aritmetica o chiamando una funzione predefinita, il risultato
+viene arrotondato alla precisione di lavoro. La precisione di lavoro di default
address@hidden di 53 bit, modificabile usando la variabile predefinita
@code{PREC}. Si address@hidden
+anche impostare il valore a una delle stringhe predefinite (non importa se
+scritte in maiuscolo o minuscolo) elencate in
address@hidden,
+per emulare un formato binario che segue lo standard IEEE 754.
+
address@hidden Tabella,table-predefined-precision-strings
address@hidden di precisione predefinita per @code{PREC}}
address@hidden address@hidden"double"}} {12345678901234567890123456789012345}
address@hidden @code{PREC} @tab formato binario IEEE 754
address@hidden @code{"half"} @tab 16-bit mezza precisione
address@hidden @code{"single"} @tab 32-bit singole precisione di base
address@hidden @code{"double"} @tab 64-bit doppia precisione di base
address@hidden @code{"quad"} @tab 128-bit quadrupla precisione di base
address@hidden @code{"oct"} @tab 256-bit ottupla precisione
address@hidden multitable
address@hidden float
+
+Il seguente esempio illustra gli effetti del cambiamento di precisione
+sulle operazioni aritmetiche:
+
address@hidden
+$ @kbd{gawk -M -v PREC=100 'BEGIN @{ x = 1.0e-400; print x + 0}
+> @kbd{PREC = "double"; print x + 0 @}'}
address@hidden 1e-400
address@hidden 0
address@hidden example
+
address@hidden ATTENZIONE
+Diffidare delle costanti in virgola mobile! Quando si legge una costante in
+virgola mobile dal codice sorgente di un programma, @command{gawk} usa la
+precisione di default (quella del formato @code{double} di C), a meno che non
+venga richiesto, tramite la variabile speciale @code{PREC} fornita
+sulla riga di comando, di memorizzarla internamente come un numero MPFR.
+Cambiare la precisione tramite @code{PREC} nel testo del programma @emph{non}
+cambia la precisione di una costante.
+
+Se si deve rappresentare una costante in virgola mobile con una precisione
+maggiore di quella di default e non @`e possibile usare un assegnamento a
address@hidden da riga di comando, si dovrebbe definire la costante o come
+stringa, o come numero razionale, ove possibile. L'esempio seguente illustra le
+differenze tra i diversi modi di stampare una costante in virgola mobile:
+
address@hidden
+$ @kbd{gawk -M 'BEGIN @{ PREC = 113; printf("%0.25f\n", 0.1) @}'}
address@hidden 0.1000000000000000055511151
+$ @kbd{gawk -M -v PREC=113 'BEGIN @{ printf("%0.25f\n", 0.1) @}'}
address@hidden 0.1000000000000000000000000
+$ @kbd{gawk -M 'BEGIN @{ PREC = 113; printf("%0.25f\n", "0.1") @}'}
address@hidden 0.1000000000000000000000000
+$ @kbd{gawk -M 'BEGIN @{ PREC = 113; printf("%0.25f\n", 1/10) @}'}
address@hidden 0.1000000000000000000000000
address@hidden example
address@hidden quotation
+
address@hidden Impostare modi di arrotondare
address@hidden Impostare la address@hidden di arrotondamento
+
+La variabile @code{ROUNDMODE} permette di controllare a livello di programma
+la address@hidden di arrotondamento.
+La corrispondenza tra @code{ROUNDMODE} e le address@hidden di arrotondamento
IEEE
address@hidden mostrata in @ref{table-gawk-rounding-modes}.
+
address@hidden Tabella,table-gawk-rounding-modes
address@hidden@`a di arrotondamento in @command{gawk} }
address@hidden @columnfractions .45 .30 .25
address@hidden address@hidden di arrotondamento @tab Nome IEEE @tab
@code{ROUNDMODE}
address@hidden Arrotonda al address@hidden vicino, o a un numero pari @tab
@code{roundTiesToEven} @tab @code{"N"} o @code{"n"}
address@hidden Arrotonda verso infinito @tab @code{roundTowardPositive} @tab
@code{"U"} o @code{"u"}
address@hidden Arrotonda verso meno infinito @tab @code{roundTowardNegative}
@tab @code{"D"} o @code{"d"}
address@hidden Arrotonda verso zero (troncamento) @tab @code{roundTowardZero}
@tab @code{"Z"} o @code{"z"}
address@hidden Arrotonda al address@hidden vicino, o per eccesso @tab
@code{roundTiesToAway} @tab @code{"A"} o @code{"a"}
address@hidden multitable
address@hidden float
+
address@hidden ha @code{"N"} come valore di default, ovvero si usa la
address@hidden di arrotondamento IEEE 754 @code{roundTiesToEven}.
+In @ref{table-gawk-rounding-modes}, il valore @code{"A"} seleziona
address@hidden Questo @`e applicabile solo se la versione in uso
+della libreria MPFR lo supporta; altrimenti, l'impostazione di @code{ROUNDMODE}
+ad @code{"A"} non ha alcun effetto.
+
+La address@hidden di default @code{roundTiesToEven} @`e la address@hidden
preferita, ma allo
+stesso tempo
+la meno intuitiva. Questo metodo fa la cosa ovvia per la maggior parte dei
+valori, arrotondandoli per eccesso o per difetto alla cifra address@hidden
prossima.
+Per esempio, arrotondando 1.132 alle due cifre decimali si ottiene 1.13,
+e 1.157 viene arrotondato a 1.16.
+
+Tuttavia, se si deve arrotondare un valore posto esattamente a address@hidden
strada,
+le cose non funzionano come probabilmente si insegna a scuola.
+In questo caso, il numero @`e arrotondato alla cifra @emph{pari}
address@hidden prossima.
address@hidden@dotless{i}} arrotondando 0.125 alle due cifre si arrotonda per
difetto a 0.12,
+ma arrotondando 0.6875 alle tre cifre si arrotonda per eccesso a 0.688.
+Probabilmente ci si @`e address@hidden imbattuti in questa address@hidden di
arrotondamento
+usando @code{printf} per formattare numeri a virgola mobile.
+Per esempio:
+
address@hidden
+BEGIN @{
+ x = -4.5
+ for (i = 1; i < 10; i++) @{
+ x += 1.0
+ printf("%4.1f => %2.0f\n", x, x)
+ @}
address@hidden
address@hidden example
+
address@hidden
+produce il seguente output quando viene eseguito sul sistema
+dell'autore:@address@hidden possibile che l'output sia completamente diverso,
se la
+libreria C presente nel sistema in uso non si conforma, per @code{printf},
+alla regola IEEE 754
+di arrotondamento al valore pari in caso di equidistanza.}
+
address@hidden
+-3.5 => -4
+-2.5 => -2
+-1.5 => -2
+-0.5 => 0
+ 0.5 => 0
+ 1.5 => 2
+ 2.5 => 2
+ 3.5 => 4
+ 4.5 => 4
address@hidden example
+
+La teoria che sta dietro alla regola
address@hidden @`e che gli arrotondamenti di
+valori equidistanti in eccesso e in difetto si distribuiscono address@hidden o
meno
+uniformemente, con la possibile conseguenza che errori di arrotondamento
+ripetuti tendono ad annullarsi a vicenda. Questa @`e la address@hidden di
+arrotondamento di default per funzioni e operatori di calcolo secondo IEEE 754.
+
+Le altre address@hidden di arrotondamento sono usate raramente. Gli
arrotondamenti
+verso l'infinito (@code{roundTowardPositive}) e verso il meno infinito
+(@code{roundTowardNegative}) vengono spesso usati per eseguire calcoli su
+intervalli, dove si adotta questa address@hidden di arrotondamento per
calcolare
+i limiti superiore e inferiore per l'intervallo di valori in uscita.
+La address@hidden
address@hidden address@hidden essere usata per convertire numeri a virgola
mobile
+in numeri interi. La address@hidden di arrotondamento @code{roundTiesToAway}
+arrotonda il risultato al numero address@hidden vicino, e in caso di
equidistanza
+arrotonda per eccesso.
+
+Qualche esperto di analisi numerica address@hidden che la scelta dello stile di
+arrotondamento ha un grandissimo impatto sul risultato finale, e address@hidden
+di attendere sino al risultato finale dopo ogni arrotondamento. Invece,
+spesso si possono evitare problemi legati a errori di arrotondamento
+impostando all'inizio la precisione a un valore sufficientemente maggiore
+della precisione desiderata, in modo che il cumulo degli errori di
+arrotondamento non influisca sul
+risultato finale. Se si ha il dubbio che i risultati del calcolo contengano
+un'accumulazione di errori di arrotondamento, occorre, per accertare la cosa,
+controllare se si verifica una differenza significativa nell'output
+cambiando la address@hidden di arrotondamento.
+
address@hidden Interi a precisione arbitraria
address@hidden Aritmetica dei numeri interi a precisione arbitraria con
@command{gawk}
address@hidden numeri interi a precisione arbitraria
address@hidden interi a precisione arbitraria
address@hidden precisione arbitraria, interi a
+
+Quando viene specificata l'opzione @option{-M},
address@hidden esegue tutti i calcoli sui numeri interi usando gli interi a
+precisione arbitraria della libreria GMP. Qualsiasi numero che appaia come un
+intero in un sorgente o in un @value{DF} @`e memorizzato come intero a
precisione
+arbitraria. La dimensione del numero intero ha come limite solo la memoria
+disponibile. Per esempio, il seguente programma calcola
address@hidden
address@hidden,
address@hidden iftex
address@hidden
+5^4^3^2,
address@hidden ifinfo
address@hidden
address@hidden
address@hidden@address@hidden,
address@hidden ifnotinfo
address@hidden ifnottex
+il cui risultato @`e oltre i limiti degli ordinari valori a virgola mobile a
+doppia precisione dei processori:
+
address@hidden
+$ @kbd{gawk -M 'BEGIN @{}
+> @kbd{x = 5^4^3^2}
+> @kbd{print "numero di cifre =", length(x)}
+> @kbd{print substr(x, 1, 20), "...", substr(x, length(x) - 19, 20)}
+> @address@hidden'}
address@hidden numero di cifre = 183231
address@hidden 62060698786608744707 ... 92256259918212890625
address@hidden example
+
+Se invece si dovesse calcolare lo stesso valore usando valori a virgola mobile
+con precisione arbitraria, la precisione necessaria per il risultato corretto
+(usando
+la formula
address@hidden
address@hidden = 3.322 @cdot dps})
+sarebbe @math{3.322 @cdot 183231},
address@hidden iftex
address@hidden
address@hidden
address@hidden = 3.322 * dps})
+sarebbe 3.322 x 183231,
address@hidden ifnotdocbook
address@hidden ifnottex
address@hidden
+<emphasis>prec</emphasis> = 3.322 ⋅ <emphasis>dps</emphasis>)
+would be
+<emphasis>prec</emphasis> = 3.322 ⋅ 183231,
address@hidden docbook
+o 608693.
+
+Il risultato di un'operazione aritmetica tra un intero e un valore a virgola
+mobile @`e un valore a virgola mobile con precisione uguale alla precisione di
+lavoro. Il seguente programma calcola l'ottavo termine nella successione di
address@hidden, Eric W.
address@hidden's Sequence}. From MathWorld---A Wolfram Web Resource
address@hidden(@url{http://mathworld.wolfram.com/SylvestersSequence.html}).}}
+usando una ricorrenza:
+
address@hidden
+$ @kbd{gawk -M 'BEGIN @{}
+> @kbd{s = 2.0}
+> @kbd{for (i = 1; i <= 7; i++)}
+> @kbd{s = s * (s - 1) + 1}
+> @kbd{print s}
+> @address@hidden'}
address@hidden 113423713055421845118910464
address@hidden example
+
+Il risultato mostrato differisce dal numero effettivo,
+113.423.713.055.421.844.361.000.443,
+perch@'e la precisione di default di 53 bit non @`e suffciente per
rappresentare
+esattamente il risultato in virgola mobile. Si address@hidden o aumentare la
precisione
+(in questo caso bastano 100 bit), o sostituire la costante in virgola mobile
address@hidden con un intero, per eseguire tutti i calcoli usando l'aritmetica
con
+gli interi per ottenere l'output corretto.
+
+A volte @command{gawk} deve convertire implicitamente un intero con precisione
+arbitraria in un valore a virgola mobile con precisione arbitraria.
address@hidden si rende necessario
+principalmente perch@'e la libreria MPFR non sempre prevede l'interfaccia
+necessaria per elaborare interi a precisione arbitraria o numeri di tipo
+eterogeneo come richiesto da un'operazione o funzione. In tal caso, la
+precisione viene impostata al minimo valore necessario per una conversione
+esatta, e non viene usata la precisione di lavoro. Se
+questo non @`e quello di cui si ha bisogno o che si vuole, si address@hidden
ricorrere a un
+sotterfugio e convertire preventivamente l'intero in un valore a virgola
+mobile, come qui di seguito:
+
address@hidden
+gawk -M 'BEGIN @{ n = 13; print (n + 0.0) % 2.0 @}'
address@hidden example
+
+Si address@hidden evitare completamente questo passaggio specificando il
numero come
+valore a virgola mobile fin dall'inizio:
+
address@hidden
+gawk -M 'BEGIN @{ n = 13.0; print n % 2.0 @}'
address@hidden example
+
+Si noti che, per questo specifico esempio, probabilmente @`e meglio
+semplicemente specificare:
+
address@hidden
+gawk -M 'BEGIN @{ n = 13; print n % 2 @}'
address@hidden example
+
+Dividendo due interi a precisione arbitraria con @samp{/} o con @samp{%}, il
+risultato @`e tipicamente un valore a virgola mobile con precisione arbitraria
+(a meno che il risultato non sia un numero intero esatto).
+Per eseguire divisioni intere o calcolare moduli con interi a precisione
+arbitraria, usare la funzione predefinita
address@hidden()} (@pxref{Funzioni numeriche}).
+
+Si address@hidden simulare la funzione @code{intdiv()} in @command{awk}
standard
+usando questa funzione definita dall'utente:
+
address@hidden
address@hidden file eg/lib/intdiv.awk
+# intdiv --- fa una divisione intera
+
address@hidden endfile
address@hidden
address@hidden file eg/lib/intdiv.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# July, 2014
+#
+# Name changed from div() to intdiv()
+# April, 2015
+
address@hidden endfile
+
address@hidden ignore
address@hidden file eg/lib/intdiv.awk
+function intdiv(numerator, denominator, result)
address@hidden
+ split("", result)
+
+ numerator = int(numerator)
+ denominator = int(denominator)
+ result["quotient"] = int(numerator / denominator)
+ result["remainder"] = int(numerator % denominator)
+
+ return 0.0
address@hidden
address@hidden endfile
address@hidden example
+
+Il seguente programma d'esempio, proposto da Katie Wasserman,
+usa @code{intdiv()} per
+calcolare le cifre di @value{PI} al numero di cifre significative
+che si @`e scelto di impostare:
+
address@hidden
address@hidden file eg/prog/pi.awk
+# pi.awk --- calcola le cifre di pi
address@hidden endfile
address@hidden endfile
address@hidden
address@hidden file eg/prog/pi.awk
+#
+# Katie Wasserman, katie@@wass.net
+# August 2014
address@hidden endfile
address@hidden ignore
address@hidden file eg/prog/pi.awk
+
+BEGIN @{
+ cifre = 100000
+ due = 2 * 10 ^ cifre
+ pi = due
+ for (m = cifre * 4; m > 0; --m) @{
+ d = m * 2 + 1
+ x = pi * m
+ intdiv(x, d, risultato)
+ pi = risultato["quotient"]
+ pi = pi + due
+ @}
+ print pi
address@hidden
address@hidden endfile
address@hidden example
+
address@hidden
+Date: Wed, 20 Aug 2014 10:19:11 -0400
+To: address@hidden
+From: Katherine Wasserman <address@hidden>
+Subject: Re: computation of digits of pi?
+
+Arnold,
+
+>The program that you sent to compute the digits of pi using div(). Is
+>that some standard algorithm that every math student knows? If so,
+>what's it called?
+
+It's not that well known but it's not that obscure either
+
+It's Euler's modification to Newton's method for calculating pi.
+
+Take a look at lines (23) - (25) here:
http://mathworld.wolfram.com/PiFormulas.htm
+
+The algorithm I wrote simply expands the multiply by 2 and works from the
innermost expression outwards. I used this to program HP calculators because
it's quite easy to modify for tiny memory devices with smallish word sizes.
+
+http://www.hpmuseum.org/cgi-sys/cgiwrap/hpmuseum/articles.cgi?read=899
+
+-Katie
address@hidden ignore
+
+Quando gli fu chiesto dell'algoritmo usato, Katie rispose:
+
address@hidden
+Non @`e quello address@hidden noto ma nemmeno quello address@hidden
incomprensibile.
address@hidden la variante di Eulero al metodo di Newton per il calcolo del Pi
greco.
+Si vedano le righe (23) - (25) nel sito:
address@hidden://mathworld.wolfram.com/PiFormulas.html}.
+
+L'algoritmo che ho scritto semplicemente espande il moltiplicare per 2 e
+lavora dall'espressione address@hidden interna verso l'esterno. Ho usato
questo per
+programmare delle calcolatrici HP perch@'e @`e piuttosto facile da adattare ai
+dispositivi di scarsa memoria con dimensioni di parola piuttosto piccole.
+Si veda
address@hidden://www.hpmuseum.org/cgi-sys/cgiwrap/hpmuseum/articles.cgi?read=899}.
address@hidden quotation
+
address@hidden Problemi virgola mobile POSIX
address@hidden Confronto tra standard e uso corrente
+
+Per diverso tempo, @command{awk} ha convertito le stringhe dall'aspetto non
+numerico nel valore numerico zero, quando richiesto. Per di address@hidden, la
+definizione originaria del linguaggio e lo standard POSIX originale prevedevano
+che @command{awk} riconoscesse solo i numeri decimali (base 10), e non i numeri
+ottali (base 8) o esadecimali (base 16).
+
+Le modifiche nel linguaggio degli standard POSIX 2001 e 2004 possono essere
+interpretate nel senso che @command{awk} debba fornire delle address@hidden
+aggiuntive. Queste sono:
+
address@hidden @value{BULLET}
address@hidden
+Interpretazione del valore dei dati a virgola mobile specificati in notazione
+esadecimale (p.es., @code{0xDEADBEEF}). (Da notare: valore dei dati letti,
address@hidden costanti facenti parte del codice sorgente.)
+
address@hidden
+Supporto per i valori a virgola mobile speciali IEEE 754 ``not a number''
+(NaN), address@hidden infinito (``inf'') e meno infinito (address@hidden'').
+In particolare, il formato per questi valori @`e quello specificato dallo
+standard C ISO 1999, che non distingue maiuscole/minuscole e address@hidden
consentire
+caratteri aggiuntivi dipendenti dall'implementazione dopo il @samp{nan}, e
+consentire o @samp{inf} o @samp{infinity}.
address@hidden itemize
+
+Il primo problema @`e che entrambe le modifiche sono deviazioni evidenti
+dalla prassi consolidata:
+
address@hidden @value{BULLET}
address@hidden
+Il manutentore di @command{gawk} crede che supportare i valori a virgola mobile
+esadecimali, nello specifico, sia sbagliato, e che non sia mai stata intenzione
+dell'autore originale di introdurlo nel linguaggio.
+
address@hidden
+Consentire che stringhe completamente alfabetiche abbiano valori numerici
+validi @`e anch'essa una deviazione molto marcata dalla prassi consolidata.
address@hidden itemize
+
+Il secondo problema @`e che il manutentore di @command{gawk} crede che questa
+interpretazione dello standard, che richiede una certa dimestichezza col
+linguaggio giuridico per essere compresa, non sempre @`e stata
+colta dai normali sviluppatori. In altre parole, ``Sappiamo come siete
+arrivati sin qui, ma non pensiamo che questo sia il posto dove volete essere.''
+
+Recependo queste argomentazioni, e cercando nel contempo di assicurare la
address@hidden con le versioni precedenti dello standard, lo standard POSIX 2008
+ha aggiunto delle formulazioni esplicite per consentire l'uso da parte di
address@hidden, solo a richiesta, dei valori a virgola mobile esadecimali e
+dei valori speciali
address@hidden a number}'' e infinito.
+
+Sebbene il manutentore di @command{gawk} continui a credere che introdurre
+queste address@hidden sia sconsigliabile, address@hidden nonostante, sui
sistemi che
+supportano i valori in virgola mobile IEEE, sembra giusto fornire
address@hidden
address@hidden di usare i valori NaN e infinito. La soluzione implementata
+in @command{gawk} @`e questa:
+
address@hidden @value{BULLET}
address@hidden
+Se @`e stata specificata l'opzione da riga di comando @option{--posix},
address@hidden non
+interviene. I valori di stringa sono passati direttamente alla funzione
address@hidden()} della libreria di sistema, e se quest'ultima restituisce
+senza errori un valore numerico,
+esso viene address@hidden'avete voluto, tenetevelo.}
+Per definizione, i risultati non sono portabili su diversi sistemi;
+e sono anche piuttosto sorprendenti:
+
address@hidden
+$ @kbd{echo nanny | gawk --posix '@{ print $1 + 0 @}'}
address@hidden nan
+$ @kbd{echo 0xDeadBeef | gawk --posix '@{ print $1 + 0 @}'}
address@hidden 3735928559
address@hidden example
+
address@hidden
+Senza l'opzione @option{--posix}, @command{gawk} interpreta i quattro valori
di stringa
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+in modo speciale, producendo i corrispondenti valori numerici speciali.
+Il segno iniziale serve per segnalare a @command{gawk} (e all'utente)
+che il valore @`e realmente numerico. I numeri a virgola mobile esadecimali
+non sono consentiti (a meno di non usare anche @option{--non-decimal-data},
+che @emph{non} @`e consigliabile). Per esempio:
+
address@hidden
+$ @kbd{echo nanny | gawk '@{ print $1 + 0 @}'}
address@hidden 0
+$ @kbd{echo +nan | gawk '@{ print $1 + 0 @}'}
address@hidden nan
+$ @kbd{echo 0xDeadBeef | gawk '@{ print $1 + 0 @}'}
address@hidden 0
address@hidden example
+
address@hidden ignora la distinzione maiuscole/minuscole nei quattro valori
+speciali. address@hidden@dotless{i}}, @samp{+nan} e @samp{+NaN} sono la stessa
cosa.
address@hidden itemize
+
address@hidden Sommario virgola mobile
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+La maggior parte dell'aritmetica al calcolatore @`e fatta usando numeri interi
+oppure
+valori a virgola mobile. L'@command{awk} standard usa valori a virgola mobile
+a doppia precisione.
+
address@hidden
+Nei primi anni '90 Barbie disse erroneamente, ``L'ora di matematica @`e
+ostica!'' Sebbene la matematica non sia ostica, l'aritmetica a virgola
+mobile non @`e proprio come la
+matematica ``carta e penna'', e bisogna prestare attenzione:
+
address@hidden nested list
address@hidden @value{MINUS}
address@hidden
+Non tutti i numeri possono essere rappresentati in modo esatto.
+
address@hidden
+Per confrontare dei valori bisognerebbe usare un delta, invece di farlo
+direttamente con @samp{==} e @samp{!=}.
+
address@hidden
+Gli errori si accumulano.
+
address@hidden
+Le operazioni non sempre sono esattamente associative o distributive.
address@hidden itemize
+
address@hidden
+Aumentare l'accuratezza address@hidden essere d'aiuto, ma non @`e una panacea.
+
address@hidden
+Spesso, aumentare la precisione e poi arrotondare al numero di cifre
+desiderato produce risultati soddisfacenti.
+
address@hidden
+Specificare l'opzione @option{-M} (o @option{--bignum}) per abilitare
+il calcolo MPFR.
+Usare @code{PREC} per impostare la precisione in bit, e
address@hidden per impostare la address@hidden di arrotondamento tra quelle
+previste nello standard IEEE 754.
+
address@hidden
+Specificando l'opzione @option{-M}, @command{gawk} esegue calcoli su interi a
precisione
+arbitraria usando la libreria GMP. In tal modo si ha una maggiore
address@hidden e
+una address@hidden efficiente allocazione dello spazio rispetto all'uso di
MPFR per
+eseguire gli stessi calcoli.
+
address@hidden
+Ci sono diverse aree per quanto attiene ai numeri a virgola mobile in cui
address@hidden @`e in disaccordo con lo standard POSIX.
address@hidden importante averlo ben presente.
+
address@hidden
+In generale, non vi @`e alcun bisogno di essere eccessivamente diffidenti
verso i
+risultati del calcolo in virgola mobile. La lezione da ricordare @`e che
+il calcolo in virgola mobile @`e sempre address@hidden complesso di quello che
si fa con
+carta e penna. Per trarre vantaggio dalla potenza del calcolo in virgola
+mobile, bisogna conoscere i suoi limiti e stare all'interno di essi.
+Per la maggior parte degli usi occasionali del calcolo in virgola mobile, si
+possono ottenere i risultati attesi semplicemente arrotondando la
+visualizzazione dei risultati finali al giusto numero di cifre decimali
+significative.
+
address@hidden
+Come consiglio generale, evitare di rappresentare dati numerici in maniera
+tale da far sembrare che la precisione sia maggiore di quella effettivamente
+necessaria.
+
address@hidden itemize
+
address@hidden Estensioni dinamiche
address@hidden Scrivere estensioni per @command{gawk}
address@hidden estensioni caricate dinamicamente
address@hidden dinamiche, estensioni
+
address@hidden possibile aggiungere nuove funzioni, scritte in C o C++, a
@command{gawk}
+usando librerie caricate dinamicamente. Questa address@hidden @`e disponibile
+su sistemi che supportano le funzioni C @code{dlopen()} e @code{dlsym()}.
+Questo @value{CHAPTER} descrive come creare estensioni usando codice scritto
+in C o C++.
+
+Chi @`e completamente digiuno di programmazione in C address@hidden
tranquillamente
+saltare questo @value{CHAPTER}, ma potrebbe valer la pena di dare un'occhiata
+alla documentazione sulle estensioni che sono installate insieme a
address@hidden (@pxref{Esempi di estensione}),
+e alle informazioni sul progetto @code{gawkextlib} (@pxref{gawkextlib}).
+Gli esempi di estensione sono automaticamente compilati e installati quando
+si installa @command{gawk}.
+
address@hidden NOTA
+Se si specifica l'opzione @option{--sandbox}, le estensioni non sono
+disponibili
+(@pxref{Opzioni}).
address@hidden quotation
+
address@hidden
+* Introduzione alle estensioni:: Cos'@`e un'estensione.
+* Licenza delle estensioni:: Una nota riguardo al tipo di licenza.
+* Panoramica sul meccanismo delle estensioni:: Una panoramica sul meccanismo
+ delle estensioni.
+* Descrizione dell'API delle estensioni:: Una descrizione completa dell'API.
+* Trovare le estensioni:: Come @command{gawk} trova le estensioni
+ compilate.
+* Esempio di estensione:: Esempio di codice C di un'estensione.
+* Esempi di estensione:: Le estensioni di esempio incluse con
+ @command{gawk}.
+* gawkextlib:: Il progetto @code{gawkextlib}.
+* Sommario delle estensioni:: Sommario delle estensioni.
+* Esercizi sulle estensioni:: Esercizi.
address@hidden menu
+
address@hidden Introduzione alle estensioni
address@hidden Cos'@`e un'estensione
+
address@hidden plug-in
+Un'@dfn{estensione} (talora chiamata @dfn{plug-in}) @`e un frammento di codice
+compilato esternamente che @command{gawk} address@hidden caricare in fase di
esecuzione
+per ottenere address@hidden ulteriori, che vanno ad aggiungersi a quelle di
address@hidden descritte nel resto di questo @value{DOCUMENT}.
+
+Le estensioni sono utili perch@'e consentono (ovviamente) di estendere le
address@hidden di @command{gawk}. Per esempio, possono permettere l'uso di
address@hidden di sistema} (come @code{chdir()} per cambiare directory)
+e di altre routine di libreria C potenzialmente utili. Come per la maggior
+parte del software, ``il cielo @`e il limite''; se si riesce a immaginare
+qualcosa che si vuol fare e che @`e possibile programmare in C o C++,
+si address@hidden scrivere un'estensione che lo faccia!
+
+Le estensioni sono scritte in C o C++, usando l'API (@dfn{Application
+Programming Interface}) definita per questo scopo dagli sviluppatori di
address@hidden Il resto di questo @value{CHAPTER} descrive
+le address@hidden offerte dall'API e come usarle,
+e illustra una piccola estensione di esempio. Inoltre, sono documentati
+gli esempi di estensione inclusi nella distribuzione di @command{gawk}
+e viene descritto il progetto @code{gawkextlib}.
address@hidden FOR_PRINT
address@hidden delle estensioni}, per una disamina degli obiettivi e del
+progetto del meccanismo delle estensioni.
address@hidden ifclear
address@hidden FOR_PRINT
+Si veda
@uref{http://www.gnu.org/software/gawk/manual/html_node/estensione-Design.html}
+per una disamina degli obiettivi e del
+progetto del meccanismo delle estensioni.
address@hidden ifset
+
address@hidden Licenza delle estensioni
address@hidden Tipo di licenza delle estensioni
+
+Ogni estensione dinamica dev'essere distribuita in base a una licenza che sia
+compatibile con la licenza GNU GPL (@pxref{Copia}).
+
+Per far sapere a @command{gawk} che la licenza @`e quella corretta,
+l'estensione deve definire il simbolo globale
address@hidden Se tale simbolo non @`e stato definito,
address@hidden termina con un messaggio di errore fatale al momento del
+caricamente dell'estensione.
+
+Il tipo dichiarato per il suddetto simbolo dev'essere @code{int}. Esso non
+deve tuttavia essere presente in ogni sezione allocata.
+Il controllo in essere si limita a constatare che quel simbolo esiste a
+livello globale.
+Qualcosa del genere address@hidden essere sufficiente:
+
address@hidden
+int plugin_is_GPL_compatible;
address@hidden example
+
address@hidden Panoramica sul meccanismo delle estensioni
address@hidden Una panoramica sul funzionamento ad alto livello
+
+La comunicazione tra
address@hidden e un'estensione @`e bidirezionale. Dapprima, quando
+un'estensione @`e caricata, @command{gawk} le passa un puntatore a una
struttura
+(@code{struct}) i cui campi sono dei puntatori di funzione.
address@hidden
+Questo si address@hidden vedere in @ref{figura-carica-estensione}.
address@hidden ifnotdocbook
address@hidden
+Questo si address@hidden vedere in @inlineraw{docbook, <xref
linkend="figura-carica-estensione"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-carica-estensione
address@hidden dell'estensione}
address@hidden SMALLPRINT
address@hidden @image{api-figura1, , , Caricamento dell'estensione}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{api-figura1, 11cm, , Caricamento dell'estensione}
address@hidden ifset
+
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-carica-estensione" float="0">
+<title>Caricamento dell'estensione</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="api-figura1.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
+L'estensione @`e in grado di chiamare funzioni all'interno di @command{gawk}
+utilizzando questi puntatori a funzione, in fase di esecuzione, senza aver
+bisogno di accedere (in fase di compilazione), ai simboli di @command{gawk}.
+Uno di questi puntatori a funzione punta a una funzione che serve per
+``registrare'' nuove funzioni.
address@hidden
+Questo @`e mostrato in @ref{figura-registrare-una-nuova-funzione}.
address@hidden ifnotdocbook
address@hidden
+Questo @`e shown in @inlineraw{docbook, <xref
linkend="figura-registrare-una-nuova-funzione"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-registrare-una-nuova-funzione
address@hidden una nuova funzione}
address@hidden SMALLPRINT
address@hidden @image{api-figura2, , , Registrare una nuova funzione}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{api-figura2, 11cm , , Registrare una nuova funzione}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-registrare-una-nuova-funzione" float="0">
+<title>Registering a new function</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="api-figura2.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
+Nella direzione opposta, l'estensione registra le sue nuove funzioni
+con @command{gawk} passando dei puntatori che puntano alle funzioni che
+implementano la nuova address@hidden, (p.es. @code{do_chdir()}).
@command{gawk}
+associa il puntatore a funzione con un nome ed @`e in grado di chiamarlo in
+seguito, usando una convenzione di chiamata predefinita.
address@hidden
+Questo @`e mostrato in @ref{figura-chiamata-nuova-funzione}.
address@hidden ifnotdocbook
address@hidden
+Questo @`e mostrato in @inlineraw{docbook, <xref
linkend="figura-chiamata-nuova-funzione"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-chiamata-nuova-funzione
address@hidden della nuova funzione}
address@hidden SMALLPRINT
address@hidden @image{api-figura3, , , Chiamata della nuova funzione}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{api-figura3,11cm , , Chiamata della nuova funzione}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-chiamata-nuova-funzione" float="0">
+<title>Chiamata della nuova funzione</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="api-figura3.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
+La funzione @address@hidden()}, a sua volta, utilizza i puntatori a
+funzione nella struttura (@code{struct}) API per svolgere il proprio compito,
+come aggiornare variabili o vettori, stampare messaggi, impostare la
+variabile @code{ERRNO}, e address@hidden@dotless{i}} via.
+
+Delle macro di servizio rendono la chiamata effettuata utilizzando
+i puntatori simile a quella delle funzioni normali, in modo che il codice
+sorgente delle estensioni rimanga sufficientemente leggibile e comprensibile.
+
+Sebbene tutto address@hidden possa sembrare piuttosto complesso, il risultato
@`e che il
+codice sorgente dell'estensione @`e abbastanza intuitivo da scrivere e da
+leggere. Lo si address@hidden constatare nell'estensione di esempio
address@hidden
+(@pxref{Esempio di estensione}), come pure nel codice @file{testext.c},
+che testa l'interfaccia di programmazione (API).
+
+Ecco alcuni ulteriori dettagli:
+
address@hidden @value{BULLET}
address@hidden
+L'API fornisce accesso ai valori delle variabili @command{gawk}
address@hidden@var{xxx}}, che memorizzano opzioni della riga di comando come
address@hidden, @code{do_profiling}, e address@hidden@dotless{i}} via
(@pxref{Variabili dell'estensione API}).
+Questi valori sono solo informativi: un'estensione non address@hidden
modificarli
+all'interno di @command{gawk}. Oltre a address@hidden, il tentativo di
assegnare loro
+dei valori produce un errore quando l'estensione viene compilata.
+
address@hidden
+L'API fornisce anche i numeri che identificano la specifica versione di
address@hidden, in modo che un'estensione possa controllare se il
+comando @command{gawk} che l'ha caricata @`e in grado di supportare le
address@hidden utilizzate nell'estensione. (Discrepanze tra le versioni
+``non dovrebbero'' accadere, ma si sa come vanno @emph{queste} cose.)
address@hidden dell'estensione} per ulteriori dettagli.
address@hidden itemize
+
address@hidden Descrizione dell'API delle estensioni
address@hidden Una descrizione completa dell'API
address@hidden estensioni, API delle
address@hidden API, delle estensioni
+
+Il codice sorgente scritto in C o C++ per un'estensione deve includere il
+file di intestazione
address@hidden, che dichiara le funzioni e definisce i tipi di dati
+usati per comunicare con @command{gawk}.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
+(non breve) @value{SECTION} descrive l'API in detttaglio.
+
address@hidden
+* Intro funzioni API delle estensioni:: Introduzione alle funzioni dell'API.
+* Tipi di dati generali:: I tipi di dati.
+* Funzioni di allocazione memoria:: Funzioni per allocare memoria.
+* Funzioni di costruzione:: Funzioni per creare valori.
+* Funzioni di registrazione:: Funzioni per registrare cose con
+ @command{gawk}.
+* Stampare messaggi:: Funzioni per stampare messaggi.
+* Aggiornare @code{ERRNO}:: Funzioni per aggiornare @code{ERRNO}.
+* Richiedere valori:: Come ottenere un valore.
+* Accedere ai parametri:: Funzioni per accedere ai parametri.
+* Accedere alla tabella simboli:: Funzioni per accedere alle variabili
+ globali
+* Manipolazione di vettori:: Funzioni per lavorare coi vettori.
+* Ridirezione API:: Come accedere alla ridirezioni e
+ modificarle.
+* Variabili dell'estensione API:: Variabili fornite dall'API.
+* Codice predefinito di un'estensione API:: Codice predefinito di
+ interfaccia API.
+* Modifiche dalla versione API 1:: Modifiche dalla versione 1 dell'API.
address@hidden menu
+
address@hidden Intro funzioni API delle estensioni
address@hidden Introduzione alle funzioni dell'API
+
+L'accesso a address@hidden interne a @command{gawk} @`e effettuato
+con una chiamata che usa i puntatori a funzione resi disponibili
+all'estensione.
+
+Puntatori a funzioni API sono previsti per i seguenti tipi di operazioni:
+
address@hidden @value{BULLET}
address@hidden
+Allocare, riallocare e liberare memoria.
+
address@hidden
+Registrare funzioni. Si possono registrare:
+
address@hidden nested list
address@hidden @value{MINUS}
address@hidden
+Funzioni di estensione
address@hidden
+Funzioni ausiliarie di pulizia (@dfn{callbacks})
address@hidden
+Una stringa di caratteri che identifica la versione
address@hidden
+Funzioni per analizzare l'input
address@hidden
+Funzioni per modificare l'output
address@hidden
+Processori bidirezionali
address@hidden itemize
+
+Tutti questi elementi sono spiegati dettagliatamente nel resto di questo
@value{CHAPTER}.
+
address@hidden
+Stampare messaggi fatali, di avvertimento e quelli generati dall'opzione
+``lint''.
+
address@hidden
+Modificare @code{ERRNO} o annullarne il valore.
+
address@hidden
+Accedere a parametri, compresa la address@hidden di definire come vettore
+un parametro ancora indefinito.
+
address@hidden
+Accedere alla "tabella dei simboli": procurarsi il valore di una variabile
+globale, crearne una nuova o modificarne una address@hidden esistente.
+
address@hidden
+Creare ed eliminare valori nascosti; address@hidden rende possibile usare un
+particolare valore per address@hidden di una variabile, e address@hidden
migliorare parecchio
+le prestazioni.
+
address@hidden
+Manipolare vettori:
+
address@hidden @value{MINUS}
address@hidden
+Ritrovare il valore di elementi del vettore, aggiungerne di nuovi,
+cancellare e modificare elementi esistenti.
+
address@hidden
+Ottenere il numero di elementi presenti in un vettore
+
address@hidden
+Creare un nuovo vettore
+
address@hidden
+Cancellare un intero vettore
+
address@hidden
+Appiattire un vettore per poter facilmente eseguire un ciclo, in stile C,
+su tutti i suoi indici ed elementi
address@hidden itemize
+
address@hidden
+Accedere a ridirezioni e manipolarle.
+
address@hidden itemize
+
+Alcune osservazioni riguardo all'uso dell'API:
+
address@hidden @value{BULLET}
address@hidden
+I seguenti tipi di variabili, macro e/o funzioni sono resi disponibili
+nel file @file{gawkapi.h}. Perch@'e siano utilizzabili, i rispettivi file di
+intestazione standard indicati devono essere stati specificati @emph{prima}
+di includere @file{gawkapi.h}:
+
address@hidden FIXME: Make this as a float at some point.
address@hidden address@hidden()}, @code{memcpy()}} address@hidden<sys/types.h>}}
address@hidden Elemento C @tab File d'intestazione
address@hidden @code{EOF} @tab @code{<stdio.h>}
address@hidden valori di @code{errno} @tab @code{<errno.h>}
address@hidden @code{FILE} @tab @code{<stdio.h>}
address@hidden @code{NULL} @tab @code{<stddef.h>}
address@hidden @code{memcpy()} @tab @code{<string.h>}
address@hidden @code{memset()} @tab @code{<string.h>}
address@hidden @code{size_t} @tab @code{<sys/types.h>}
address@hidden @code{struct stat} @tab @code{<sys/stat.h>}
address@hidden multitable
+
+Per ragioni di address@hidden, specialmente per sistemi
+che non sono interamente aderenti agli standard, occorre assicurarsi di
+includere i file corretti nel modo corretto. Questa richiesta mira
+a mantenere il file @file{gawkapi.h} ordinato, invece che farlo diventare
+un'accozzaglia di problemi di address@hidden, quale si address@hidden vedere
in alcune
+parti del codice sorgente di @command{gawk}.
+
address@hidden
+Il file @file{gawkapi.h} address@hidden essere incluso address@hidden volte,
senza conseguenze
+negative. Tuttavia sarebbe meglio evitare di farlo, per uno
+stile di programmazione migliore.
+
address@hidden
+Sebbene l'API usi solo address@hidden ISO C 90, c'@`e un'eccezione; le funzione
+``costruttrici'' usano la parola chiave @code{inline}. Se il compilatore in
+uso non supporta questa parola chiave, si dovrebbe specificare sulla
+riga di comando il parametro @samp{-Dinline=''} oppure usare gli strumenti
+Autotools GNU e includere un file
address@hidden nel codice sorgente delle estensioni.
+
address@hidden
+Tutti i puntatori messi a disposizione da @command{gawk} puntano ad aree
+di memoria gestite da @command{gawk} e dovrebbero essere trattati
+dall'estensione come in sola lettura. Le aree di memoria che contengono
@emph{tutte} le stringhe passate a
address@hidden dall'estensione @emph{devono} provenire da una chiamata a
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()},
+e sono gestite da @command{gawk} da quel punto in avanti.
+
address@hidden
+L'API definisce parecchie semplici @code{struct} che mappano dei valori
+come sono visti da @command{awk}. Un valore address@hidden essere un numero
@code{double}
+(a virgola mobile, in doppia precisione), una stringa o un
+vettore (come @`e il caso per i vettori multidimensionali o nella creazione di
+un nuovo vettore).
+
+I valori di tipo stringa sono costituiti da un puntatore e da una lunghezza,
+poich@'e nella stringa possono essere presenti dei caratteri @sc{nul}
+(zeri binari, che normalmente marcano la fine di una stringa).
+
address@hidden NOTA
+Di proposito, @command{gawk} immagazzina le stringhe usando la codifica
+multibyte correntemente in uso (come definita dalle variabili d'ambiente
address@hidden@var{xxx}}) e non usando dei caratteri larghi (ovvero due byte per
+ogni carattere). address@hidden riflette il modo con cui @command{gawk}
memorizza le
+stringhe internamente, e anche il modo in cui i caratteri sono
+verosimilmente letti dai file in input e scritti nei file in output.
address@hidden quotation
+
address@hidden NOTA
+I valori di una stringa passati a un'estensione da @command{gawk} hanno
+sempre un carattere @sc{nul} alla fine (come delimitatore). Quindi @`e
+possibile usare senza inconvenienti tali valori di stringa per chiamare
+funzioni di libreria standard e routine di sistema. Tuttavia, poich@'e
address@hidden consente che all'interno di una stringa di dati possano
+essere presenti caratteri @sc{nul}, si dovrebbe controllare che la
+lunghezza di ogni stringa passata un'estensione coincida con il valore
+restituito dalla funzione @code{strlen()} per la stringa stessa.
address@hidden quotation
+
address@hidden
+Per ottenere un valore (p.es. quello di un parametro o quello di una
+variabile globale, oppure di un elemento di un vettore), l'estensione chiede
+un tipo specifico di variabile (numero, stringa,
+scalare, @dfn{value cookie} [si veda address@hidden avanti], vettore o
``undefined'').
+Quando la richiesta @`e
+``undefined,'' il valore restituito address@hidden quello originale della
variabile in
+questione.
+
+In ogni caso, se la richiesta e il tipo effettivo della variabile non
+corrispondono, la funzione di accesso restituisce ``false'' e fornisce il
+tipo proprio della variabile, in modo che l'estensione possa, p.es.,
+stampare un messaggio di errore
+(del tipo ``ricevuto uno scalare, invece del vettore previsto'').
+
address@hidden This is documented in the header file and needs some expanding
upon.
address@hidden The table there should be presented here
address@hidden itemize
+
+Si possono chiamare le funzioni dell'API usando i puntatori a funzione
+direttamente, ma l'interfaccia non @`e molto elegante. Per permettere al
+codice sorgente delle estensioni di assomigliare di address@hidden a un codice
normale,
+il file di intestazione @file{gawkapi.h} definisce parecchie
+macro da usare nel codice sorgente dell'estensione.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden presenta le macro come se si trattasse di funzioni.
+
address@hidden Tipi di dati generali
address@hidden I tipi di dati di impiego generale
+
address@hidden Robbins, Arnold
address@hidden Ramey, Chet
address@hidden
address@hidden un vero rapporto di amore/odio con le @dfn{unioni}.}
address@hidden Arnold Robbins
address@hidden quotation
+
address@hidden
address@hidden @`e address@hidden che contraddistingue le @dfn{unioni}: il
compilatore @`e
+in grado di accomodare le cose in modo da far coesistere amore e odio.}
address@hidden Chet Ramey
address@hidden quotation
+
+L'estensione API definisce un certo numero di semplici tipi di dato e
+strutture di uso generale. Ulteriori strutture di dati, address@hidden
specializzate,
+saranno introdotte
address@hidden
+nelle successive
address@hidden ifnotinfo
address@hidden
+nei successivi
address@hidden ifinfo
address@hidden, insieme alle funzioni che ne fanno uso.
+
+I tipi di dati e le strutture di uso generale sono le seguenti:
+
address@hidden @code
address@hidden typedef void *awk_ext_id_t;
+Un valore di questo tipo @`e trasmesso da @command{gawk} a un'estensione nel
+momento in cui viene caricata. Tale valore dev'essere restituito
+a @command{gawk} come primo parametro di ogni funzione API.
+
address@hidden #define awk_const @dots{}
+Questa macro genera delle @samp{costanti} nel momento in cui si compila
+un'estensione, e non genera nulla quando si compila il comando @command{gawk}
+vero e proprio. address@hidden rende alcuni
+campi nelle strutture dei dati dell'API non alterabili dal codice sorgente
+dell'estensione, ma consente al comando @command{gawk} di usarle secondo
address@hidden
+
address@hidden typedef enum awk_bool @{
address@hidden @ @ @ @ awk_false = 0,
address@hidden @ @ @ @ awk_true
address@hidden @} awk_bool_t;
+Un semplice tipo di variabile booleana.
+
address@hidden typedef struct awk_string @{
address@hidden @ @ @ @ char *str;@ @ @ @ @ /* dati veri e propri */
address@hidden @ @ @ @ size_t len;@ @ @ @ /* lunghezza degli stessi, in
caratteri */
address@hidden @} awk_string_t;
+Questo rappresenta una stringa modificabile. @command{gawk} @`e responsabile
+per la gestione della memoria utilizzata, se ha fornito il valore della
+stringa. Altrimenti, assume il possesso della memoria in questione.
address@hidden memoria dev'essere resa disponibile chiamando una delle funzioni
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}!}
+
+Come address@hidden detto, la rappresentazione delle stringhe in memoria usa
la codifica
+multibyte corrente.
+
address@hidden typedef enum @{
address@hidden @ @ @ @ AWK_UNDEFINED,
address@hidden @ @ @ @ AWK_NUMBER,
address@hidden @ @ @ @ AWK_STRING,
address@hidden @ @ @ @ AWK_REGEX,
address@hidden @ @ @ @ AWK_STRNUM,
address@hidden @ @ @ @ AWK_ARRAY,
address@hidden @ @ @ @ AWK_SCALAR,@ @ @ @ @ @ @ @ @ /* accesso opaco a una
variabile */
address@hidden @ @ @ @ AWK_VALUE_COOKIE@ @ @ @ /* per aggiornare un valore
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ address@hidden
creato */
address@hidden @} awk_valtype_t;
+L'elenco @code{enum} indica di che tipo @`e un certo valore.
address@hidden usato nella seguente struttura @code{struct}.
+
address@hidden typedef struct awk_value @{
address@hidden @ @ @ @ awk_valtype_t val_type;
address@hidden @ @ @ @ union @{
address@hidden @ @ @ @ @ @ @ @ awk_string_t@ @ @ @ @ @ @ s;
address@hidden @ @ @ @ @ @ @ @ double@ @ @ @ @ @ @ @ @ @ @ @ @ d;
address@hidden @ @ @ @ @ @ @ @ awk_array_t@ @ @ @ @ @ @ @ a;
address@hidden @ @ @ @ @ @ @ @ awk_scalar_t@ @ @ @ @ @ @ scl;
address@hidden @ @ @ @ @ @ @ @ awk_value_cookie_t@ vc;
address@hidden @ @ @ @ @} u;
address@hidden @} awk_value_t;
+Un ``valore di @command{awk}''.
+Il campo @code{val_type} indica che tipo di valore @code{union} contiene,
+e ogni campo @`e del tipo appropriato.
+
address@hidden #define str_value@ @ @ @ @ @ u.s
address@hidden #define strnum_value@ @ @ str_value
address@hidden #define regex_value@ @ @ @ str_value
address@hidden #define num_value@ @ @ @ @ @ u.d
address@hidden #define array_cookie@ @ @ u.a
address@hidden #define scalar_cookie@ @ u.scl
address@hidden #define value_cookie@ @ @ u.vc
+L'uso di queste macro rende address@hidden facile da seguire l'accesso ai
campi di
address@hidden
+
address@hidden typedef void *awk_scalar_t;
+La variabili scalari possono essere rappresentate da un tipo opaco. Questi
+valori sono ottenuti da @command{gawk} e in seguito gli vengono restituiti.
+Questo argomento @`e discusso in maniera generale nel testo che segue questa
+lista, e address@hidden in dettaglio
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden simboli tramite cookie}.
+
address@hidden typedef void *awk_value_cookie_t;
+Un address@hidden cookie}'' @`e un tipo di variabile opaca, e
+rappresenta un valore nascosto.
+Anche questo argomento @`e discusso in maniera generale nel testo che segue
+questa lista, e address@hidden in dettaglio
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden nascosti}.
+
address@hidden table
+
+I valori di tipo scalare in @command{awk} sono numeri, stringhe, @dfn{strnum}
+o @dfn{regexp} fortemente tipizzate.
+La struttura @code{awk_value_t} rappresenta valori.
+Il campo @code{val_type} indica cosa contiene @code{union}.
+
+Rappresentare numeri @`e facile: l'API usa una variabile C di tipo
address@hidden Le stringhe richiedono
+uno sforzo maggiore. Poich@'e
address@hidden consente che le stringhe contengano dei byte @sc{nul}
+(a zeri binari) nel valore di una stringa, una stringa dev'essere
+rappresentata da una coppia di campi che contengono il puntatore al dato vero
+e proprio e la lunghezza della stringa.
address@hidden questo @`e il tipo @code{awk_string_t}.
+
+Un valore di tipo @dfn{strnum} (stringa numerica) @`e rappresentato come una
+stringa e consiste di dati in input forniti dall'utente che appaiono essere
+numerici.
+Quando una funzione di estensione crea un valore di tipo @dfn{strnum}, il
+risultato @`e una stringa che viene marcata come immessa dall'utente. La
+successiva analisi da parte di @command{gawk} address@hidden poi a determinare
se
+la stringa appare essere un numero, e va quindi trattata come @dfn{strnum},
+invece che come una normale stringa di caratteri.
+
address@hidden @`e utile nei casi un cui una funzione di estensione desideri
fare qualcosa
+di paragonabile alla funzione @code{split}, la quale imposta l'attributo
+di @dfn{strnum} agli elementi di vettore che crea.
+Per esempio, un'estensione che implementi la divisione di record CSV
+(Comma Separated Values, i cui elementi sono delimitati da virgole)
+potrebbe voler usare questa address@hidden Un'altra situazione in cui
address@hidden
address@hidden utile @`e quello di una funzione che richieda campi-dati ad una
banca di
+dati. La funzione @code{PQgetvalue()} della banca dati PostgreSQ, per
+esempio, restituisce una stringa che address@hidden essere numerica o di tipo
carattere,
+a seconda del contesto.
+
+I valori di @dfn{regexp} fortemente tipizzate
+(@pxref{Costanti @dfn{regexp} forti} non sono molto utili nelle funzioni di
+estensione. Le funzioni di estensione possono stabilire di averli ricevuti,
+e crearne, attribuendo valori di tipo scalare. In alternativa, @`e possibile
+esaminare il testo della @dfn{regexp} utilizzando campi @code{regex_value.str}
+e @code{regex_value.len}.
+
+Identificativi (address@hidden, nomi di variabili globali) possono essere
+associati sia a valori scalari che a vettori. Inoltre, @command{gawk}
+consente veri vettori di vettori, in cui ogni singolo elemento di un vettore
address@hidden a sua volta essere un vettore. La spiegazione dei vettori @`e
rinviata
address@hidden
+alla
address@hidden iftex
address@hidden
+a
address@hidden ifnottex
address@hidden di vettori}.
+
+La varie macro sopra elencate facilitano l'uso degli elementi delle
address@hidden come se
+fossero campi in una @code{struct}; @`e questa una pratica comunemente adottata
+nella scrittura di programmi in C. Questo tipo di codice @`e address@hidden
semplice da
+scrivere e da leggere, ma resta una address@hidden @emph{del programmatore}
+assicurarsi che il campo @code{val_type} rifletta correttamente il tipo
+del valore contenuto nella struttura @code{awk_value_t}.
+
+Dal punti di vista concettuale, i primi tre campi dell'@code{union} (numero,
+stringa, e vettore) sono sufficienti per lavorare con i valori @command{awk}.
+Tuttavia, poich@'e l'API fornisce routine per ottenere e modificare
+il valore di una variabile scalare globale usando solo il nome della
+variabile, si ha qui una perdita di efficienza: @command{gawk} deve cercare
+la variabile ogni volta che questa @`e utilizzata e modificata. Questo
address@hidden un probelma reale, non solo un problema teorico.
+
+Per questo motivo, se si sa che una certa estensione address@hidden molto tempo
+a leggere e/o modificare il valore di una o address@hidden variabili scalari,
si address@hidden
+ottenere uno @dfn{scalar address@hidden veda
address@hidden://catb.org/jargon/html/C/cookie.html, la voce ``cookie''
+nello Jargon file}
+per una definizione di @dfn{cookie}, e
address@hidden://catb.org/jargon/html/M/magic-cookie.html, la voce ``magic
cookie''
+sempre nello Jargon file} per un bell'esempio.
address@hidden FOR_PRINT
+Si veda anche la voce ``Cookie'' nel @ref{Glossario}.
address@hidden ifclear
address@hidden://jhanc.altervista.org/jargon/Intro.html, @`E disponibile in rete
+anche una traduzione italiana dello Jargon file}]
+}
+per quella variabile, e poi usare
+il @dfn{cookie} per ottenere il valore della variabile o per modificarne il
+valore.
+Il tipo @code{awk_scalar_t} contiene uno @dfn{scalar cookie}, e la macro
address@hidden fornisce accesso al valore di quel tipo
+nella struttura @code{awk_value_t}.
+Dato uno @dfn{scalar cookie}, @command{gawk} address@hidden trovare o
modificare
+direttamente il valore, come richiesto, senza bisogno di andarlo
+a cercare ogni volta.
+
+Il tipo @code{awk_value_cookie_t} e la macro @code{value_cookie} sono simili.
+Se si pensa di dover usare
+lo stesso @emph{valore} numerico o la stessa @emph{stringa} per una o
address@hidden
+variabili, si address@hidden creare il valore una volta per tutte, mettendo da
parte un
address@hidden@dfn{value cookie}} per quel valore, e in seguito specificare quel
address@hidden cookie} quando si desidera impostare il valore di una variabile.
address@hidden consente di risparmiare spazio in memoria all'interno del
processo
+di @command{gawk} e riduce il tempo richiesto per creare il valore.
+
address@hidden Funzioni di allocazione memoria
address@hidden Funzioni per allocare memoria e macro di servizio
address@hidden allocare memoria per estensioni
address@hidden memoria, allocare per estensioni
address@hidden estensioni, allocare memoria per
+
+L'API fornisce alcune funzioni per effettuare @dfn{allocazioni di memoria}
+che possono essere passate a @command{gawk}, e anche un certo numero di
+macro che possono tornare utili.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden le presenta come prototipi di funzione, nel modo
+con cui il codice dell'estensione potrebbe usarle:
+
address@hidden @code
address@hidden void *gawk_malloc(size_t size);
+Chiama la versione corretta di @code{malloc()} per allocare memoria,
+che address@hidden in seguito essere messa a disposizione di @command{gawk}.
+
address@hidden void *gawk_calloc(size_t nmemb, size_t size);
+Chiama la versione corretta di @code{calloc()} per allocare memoria che
+che address@hidden in seguito essere messa a disposizione di @command{gawk}.
+
address@hidden void *gawk_realloc(void *ptr, size_t size);
+Chiama la versione corretta di @code{realloc()} per allocare memoria
+che address@hidden in seguito essere messa a disposizione di @command{gawk}.
+
address@hidden void gawk_free(void *ptr);
+Chiama la versione corretta di @code{free()} per liberare memoria che
+era stata allocata con
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
address@hidden table
+
+L'API deve fornire queste funzioni perch@'e @`e possibile
+che un'estensione sia stata compilata e costruita usando una versione
+diversa della libreria C rispetto a quella usata per il programma eseguibile
address@hidden@footnote{Questo succede address@hidden spesso nei sistemi
MS-Windows,
+ma address@hidden capitare anche in sistemi di tipo Unix.}
+Se @command{gawk} usasse la propria versione di @code{free()} per liberare
+della memoria acquisita tramite una differente versione di @code{malloc()},
+il risultato sarebbe molto probabilmente differente da quello atteso.
+
+Due macro di address@hidden possono essere usate per allocare memoria
+tramite @code{gawk_malloc()} e
address@hidden()}. Se l'allocazione non riesce, @command{gawk}
+termina l'esecuzione con un messaggio di errore fatale.
+Queste macro dovrebbero essere usate come se fossero dei richiami a
+procedure che non restituiscono un codice di ritorno:
+
address@hidden @code
address@hidden #define emalloc(pointer, type, size, message) @dots{}
+Gli argomenti per questa macro sono i seguenti:
+
address@hidden nested table
address@hidden @code
address@hidden pointer
+La variabile di tipo puntatore che address@hidden alla memoria allocata.
+
address@hidden type
+Il tipo della variabile puntatore. Questo @`e usato per definire il tipo
+quando si chiama @code{gawk_malloc()}.
+
address@hidden size
+Il numero totale di byte da allocare.
+
address@hidden message
+Un messaggio da anteporre all'eventuale messaggio di errore fatale.
+Questo @`e solitamente il nome della funzione che sta usando la macro.
address@hidden table
+
address@hidden
+Per esempio, si potrebbe allocare il valore di una stringa
address@hidden@dotless{i}}:
+
address@hidden
+awk_value_t risultato;
+char *message;
+const char greet[] = "non v'allarmate!";
+
+emalloc(message, char *, sizeof(greet), "myfunc");
+strcpy(message, greet);
+make_malloced_string(message, strlen(message), & risultato);
address@hidden example
+
address@hidden #define erealloc(pointer, type, size, message) @dots{}
+Questo @`e simile a @code{emalloc()}, ma chiama @code{gawk_realloc()}
+invece che @code{gawk_malloc()}.
+Gli argomenti sono gli stessi della macro @code{emalloc()}.
address@hidden table
+
address@hidden Funzioni di costruzione
address@hidden Funzioni per creare valori
+
+L'API fornisce varie funzioni di @dfn{costruzione} per creare
+valori di tipo stringa e di tipo numerico, e anche varie macro di
address@hidden
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden le presenta tutte come prototipi di funzione, nel
+modo in cui il codice sorgente di
+un'estensione le userebbe:
+
address@hidden @code
address@hidden static inline awk_value_t *
address@hidden make_const_string(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione mette il valore di una stringa nella variabile
address@hidden puntata da @code{risultato}. La funzione presuppone che
address@hidden sia una costante stringa C
+(o altri dati che formano una stringa), e automaticamente crea una
address@hidden dei dati che address@hidden immagazzinata in @code{risultato}.
+Viene restituito il puntatore @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_malloced_string(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione mette il valore di una stringa nella variabile
address@hidden puntata da @code{risultato}. Si presuppone che
address@hidden sia un valore @samp{char *}
+che punta a dati ottenuti in precedenza per mezzo di
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
+L'idea @`e che questi dati siano comunicati direttamente a @command{gawk},
+che se ne assume la address@hidden
+Viene restituito il puntatore @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_null_string(awk_value_t *risultato);
+Questa funzione specializzata crea una stringa nulla (il valore ``undefined'')
+nella variabile @code{awk_value_t} puntata da @code{risultato}.
+Viene restituito il puntatore @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_number(double num, awk_value_t *risultato);
+Questa funzione crea semplicemente un valore numerico nella variabile
address@hidden, puntata da @code{risultato}.
+
address@hidden static inline awk_value_t *
address@hidden make_const_user_input(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione @`e identica a @code{make_const_string()}, ma la stringa @`e
+marcata come input dell'utente, che address@hidden essere trattata come
@dfn{strnum}
+se il contenuto della stringa appare essere numerico.
+
address@hidden static inline awk_value_t *
address@hidden make_malloced_user_input(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione @`e identica a @code{make_malloced_string()}, ma la stringa @`e
+marcata come input dell'utente, che address@hidden essere trattata come
@dfn{strnum}
+se il contenuto della stringa appare essere numerico.
+
address@hidden static inline awk_value_t *
address@hidden make_const_regex(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione crea un valore di @dfn{regexp} fortemente tipizzata, allocando
una
+copia della stringa.
address@hidden @`e l'espressione regolare, di lunghezza @code{lunghezza}.
+
address@hidden static inline awk_value_t *
address@hidden make_malloced_regex(const char *stringa, size_t lunghezza,
awk_value_t *risultato);
+Questa funzione crea un valore di @dfn{regexp} fortemente tipizzata.
address@hidden @`e l'espressione regolare, di lunghezza @code{lunghezza}.
+Si aspetta che @code{stringa} sia un valore di tipo @samp{char *} che punta a
+dati ottenuti in precedenza tramite una chiamata a
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
+
address@hidden table
+
address@hidden Funzioni di registrazione
address@hidden Funzioni di registrazione
address@hidden registrazione di estensione
address@hidden estensione, registrazione di
+
+Questa @value{SECTION} descrive le funzioni dell'API per
+registrare parti di un'estensione con @command{gawk}.
+
address@hidden
+* Funzioni di estensione:: Registrare funzioni di estensione.
+* Funzioni di exit callback:: Registrare una exit di callback.
+* Stringa di versione Estensioni:: Registrare una stringa di versione.
+* Analizzatori di input:: Registrare un analizzatore di input.
+* Processori di output:: Registrare un processore di output.
+* Processori bidirezionali:: Registrare un processore bidirezionale.
address@hidden menu
+
address@hidden Funzioni di estensione
address@hidden Registrare funzioni di estensione
+
+Le funzioni di estensione sono descritte dal seguente tracciato record:
+
address@hidden
+typedef struct awk_ext_func @{
+@ @ @ @ const char *name;
+@ @ @ @ awk_value_t *(*const function)(int num_actual_args,
+@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_value_t *risultato,
+@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ struct
awk_ext_func *finfo);
+@ @ @ @ const size_t max_expected_args;
+@ @ @ @ const size_t min_required_args;
+@ @ @ @ awk_bool_t suppress_lint;
+@ @ @ @ void *data; /* puntatore di tipo opaco
+@ @ @ @ a ogni informazione ulteriore */
address@hidden awk_ext_func_t;
address@hidden example
+
+I campi sono:
+
address@hidden @code
address@hidden const char *name;
+Il nome della nuova funzione.
+Il codice sorgente a livello di @command{awk} richiama la funzione usando
+questo nome.
+Il nome @`e una normale stringa di caratteri del linguaggio C.
+
+I nomi di funzione devono rispettare le stesse regole che valgono per gli
+identificativi @command{awk}.
address@hidden, devono iniziare o con una lettera dell'alfabeto inglese o con un
+trattino basso, che possono essere seguiti da un numero qualsiasi di
+lettere, cifre o trattini bassi.
+L'uso di maiuscolo/minuscolo @`e significativo.
+
address@hidden awk_value_t *(*const function)(int num_actual_args,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_value_t *risultato,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
struct awk_ext_func *finfo);
+Questo @`e un puntatore alla funzione C che fornisce la address@hidden per cui
address@hidden stata scritta l'estensione.
+La funzione deve riempire l'area di memoria puntata da @code{*risultato} con
+un numero, con una stringa, oppure con una @dfn{regexp}.
address@hidden diventa il proprietario di tutte le stringhe di memoria.
+Come address@hidden detto sopra, la stringa di memoria @emph{deve} essere
stata ottenuta
+usando @code{gawk_malloc()}, @code{gawk_calloc()} o @code{gawk_realloc()}.
+
+L'argomento @code{num_actual_args} dice alla funzione scritta in C quanti
+parametri sono stati effettivamente passati dal codice chiamante all'interno
+di @command{awk}.
+
+La funzione deve restituire il valore di @code{risultato}.
+Questo @`e per address@hidden del codice chiamante all'interno di
address@hidden
+
address@hidden size_t max_expected_args;
+Questo @`e il massimo numero di argomenti che la funzione si aspetta di
+ricevere.
+Se chiamata con un numero di argomenti maggiore di questo, e se @`e stato
+richiesto il controllo @dfn{lint}, @command{gawk} stampa un messaggio di
+avvertimento. Per ulteriori informazioni, si veda la descrizione di
address@hidden, address@hidden avanti in questa lista.
+
address@hidden const size_t min_required_args;
+Questo @`e il minimo numero di argomenti che la funzione si aspetta di
+ricevere.
+Se @`e chiamata con un numero inferiore di argomenti, @command{gawk}
+stampa un messaggio di errore fatale ed esce.
+
address@hidden awk_bool_t suppress_lint;
+Questo @dfn{flag} dice a @command{gawk} di non stampare un messaggio
address@hidden se @`e stato richiesto un controllo @dfn{lint} e se sono stati
+forniti address@hidden argomenti di quelli attesi. Una funzione di estensione
address@hidden
+stabilire se @command{gawk} ha address@hidden stampato almeno uno di tali
messaggi
+controllando se @samp{num_actual_args > finfo->max_expected_args}.
+In tal caso, se la funzione non desidera la stampa di ulteriori messaggi,
+dovrebbe impostare @code{finfo->suppress_lint} a @code{awk_true}.
+
address@hidden void *data;
+Questo @`e un puntatore di tipo opaco a tutti quei dati che una funzione
+di estensione desidera avere disponibili al momento della chiamata.
+Passando alla funzione di estensione la struttura @code{awk_ext_func_t}
+e avendo al suo interno questo puntatore disponibile, rende possibile
+scrivere un'unica funzione C o C++ che implementa address@hidden di una
funzione
+di estensione a livello @command{awk}.
address@hidden table
+
+Una volta preparato un record che descrive l'estensione, la funzione di
+estensione va registrata con @command{gawk} usando questa funzione dell'API:
+
address@hidden @code
address@hidden awk_bool_t add_ext_func(const char *namespace, awk_ext_func_t
*func);
+Questa funzione restituisce il valore @dfn{true} se ha successo,
+oppure @dfn{false} in caso contrario.
+Il parametro @code{namespace} non @`e usato per ora; dovrebbe puntare a una
+stringa vuota (@code{""}). Il puntatore @code{func} @`e l'indirizzo di una
address@hidden che rappresenta la funzione stessa, come descritto sopra.
+
address@hidden non modifica address@hidden che @`e puntato da @code{func}, ma la
+funzione di estensione stessa riceve questo puntatore e address@hidden
modificarlo
+e farlo puntare altrove, quindi il puntatore non @`e stato dichiarato
+di tipo costante (@code{const}).
address@hidden table
+
+La combinazione di @code{min_required_args}, @code{max_expected_args},
+e @code{suppress_lint} address@hidden ingenerare confusione. Ecco delle
linee-guida
+sul da farsi.
+
address@hidden @asis
address@hidden Un numero qualsiasi di argomenti @`e valido
+Impostare @code{min_required_args} and @code{max_expected_args} a zero e
+impostare @code{suppress_lint} ad @code{awk_true}.
+
address@hidden Un numero minimo di argomenti @`e richiesto, ma non c'@`e un
limite al numero massimo
+Impostare @code{min_required_args} al minimo richiesto.
+Impostare @code{max_expected_args} a zero e
+impostare @code{suppress_lint} ad @code{awk_true}.
+
address@hidden Un numero minino di argomenti @`e richiesto, ma c'@`e un limite
al numero massimo
+Impostare @code{min_required_args} al minimo richiesto.
+Impostare @code{max_expected_args} al massimo atteso.
+Impostare @code{suppress_lint} ad @code{awk_false}.
+
address@hidden Un numero minino di argomenti @`e richiesto, ma c'@`e un numero
massimo non superabile
+Impostare @code{min_required_args} al minimo richiesto.
+Impostare @code{max_expected_args} al massimo atteso.
+Impostare @code{suppress_lint} ad @code{awk_false}.
+Nella funzione di estensione, controllare che @code{num_actual_args} non
+ecceda @code{f->max_expected_args}. Se il massimo @`e superato, stampare
+un messaggio di errore fatale.
address@hidden table
+
address@hidden Funzioni di exit callback
address@hidden Registrare una funzione @dfn{exit callback}
+
+Una funzione @dfn{exit callback} @`e una funzione che @command{gawk} invoca
+prima di completare l'esecuzione del programma.
+Siffatte funzioni sono utili se ci sono dei compiti generali di ``pulizia''
+che dovrebbero essere effettuati nell'estensione (come chiudere connessioni a
+un @dfn{database} o rilasciare altre risorse).
+Si address@hidden registrare una tale
+funzione con @command{gawk} per mezzo della seguente funzione:
+
address@hidden @code
address@hidden void awk_atexit(void (*funcp)(void *data, int exit_status),
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ void *arg0);
+I parametri sono:
+
address@hidden nested table
address@hidden @code
address@hidden funcp
+Un puntatore alla funzione da chiamare prima che @command{gawk} completi
+l'esecuzione. Il parametro @code{data}
address@hidden il valore originale di @code{arg0}.
+Il parametro @code{exit_status} @`e il valore del codice di ritorno che
address@hidden intende passare alla chiamata di sistema @code{exit()}
+(che termina l'esecuzione del programma).
+
address@hidden arg0
+Un puntatore a un'area dati privata che @command{gawk} mantiene perch@'e
+sia poi passata alla funzione puntata da @code{funcp}.
address@hidden table
address@hidden table
+
+Le funzioni @dfn{exit callback} sono chiamate in ordine inverso rispetto
+a quello con cui @`e stata fatta la registrazione con @command{gawk}
+(LIFO: Last In, First Out).
+
address@hidden Stringa di versione Estensioni
address@hidden Registrare una stringa di versione per un'estensione
+
+Si address@hidden registrare una stringa di versione che indica il nome e la
versione
+di una data estensione a @command{gawk}, come segue:
+
address@hidden @code
address@hidden void register_ext_version(const char *version);
+Registra la stringa puntata da @code{version} con @command{gawk}.
+Si noti che @command{gawk} @emph{non} copia la stringa @code{version}, e
+quindi questa stringa non dovrebbe essere modificata.
address@hidden table
+
address@hidden stampa tutte le stringhe con le versioni di estensione
+registrate, quando viene invocato specificando l'opzione @option{--version}.
+
address@hidden Analizzatori di input
address@hidden Analizzatori di input personalizzati
address@hidden personalizzato, analizzatore di input
address@hidden analizzatore di input personalizzato
address@hidden input, analizzatore di, personalizzato
+
+Per default, @command{gawk} legge file di testo come input. Il valore della
+variabile @code{RS} @`e usato per determinare la fine di un record, e subito
+dopo la variabile @code{FS} (o @code{FIELDWIDTHS} o @code{FPAT}) viene usata
+per suddividerlo in campi
address@hidden
+(@pxrefil{Leggere file}).
address@hidden iftex
address@hidden
+(@pxref{Leggere file}).
address@hidden ifnottex
+Viene inoltre impostato il valore di @code{RT}
+(@pxref{Variabili predefinite}).
+
+Se lo si desidera, @`e possibile fornire un analizzatore di input
+personalizzato. Il compito di un analizzatore di input @`e di restituire un
+record al codice di @command{gawk}, che poi lo address@hidden, accompagnato,
+se necessario, da indicatori del valore e della lunghezza dei dati da usare
+per @code{RT}.
+
+Per fornire un analizzatore personalizzato di input, occorre innanzitutto
+rendere disponibili due funzioni (dove @var{XXX} @`e un nome che fa da prefisso
+all'estensione intera):
+
address@hidden @code
address@hidden awk_bool_t @var{XXX}_can_take_file(const awk_input_buf_t *iobuf);
+Questa funzione esamina l'informazione disponibile in @code{iobuf}
+(che vedremo tra poco). Basandosi su tale informazione,
+decide se l'analizzatore di input personalizzato address@hidden usato per
questo file.
+Se questo @`e il caso, dovrebbe restituire @dfn{true}. Altrimenti,
address@hidden
address@hidden Nessuno stato (valori di variabili, etc.) dovrebbe venire
+modificato all'interno di @command{gawk}.
+
address@hidden awk_bool_t @var{XXX}_take_control_of(awk_input_buf_t *iobuf);
+Quando @command{gawk} decide di passare il controllo del file a questo
+analizzatore di input, address@hidden questa funzione.
+Questa funzione a sua volta deve assegnare un valore ad alcuni campi
+nella struttura @code{awk_input_buf_t} e assicurarsi che
+alcune condizioni siano verificate. Dovrebbe poi restituire @dfn{true}.
+Se si verifica un errore di qualche tipo, i campi in questione non dovrebbero
+venire riempiti, e la funzione dovrebbe restituire @dfn{false}; in questo caso
address@hidden non address@hidden address@hidden l'analizzatore personalizzato
di input.
+I dettagli sono descritti address@hidden avanti.
address@hidden table
+
+L'estensione dovrebbe raccogliere queste funzioni all'interno di una
+struttura @code{awk_input_parser_t}, simile a questa:
+
address@hidden
+typedef struct awk_input_parser @{
+ const char *name; /* nome dell'analizzatore */
+ awk_bool_t (*can_take_file)(const awk_input_buf_t *iobuf);
+ awk_bool_t (*take_control_of)(awk_input_buf_t *iobuf);
+ awk_const struct awk_input_parser *awk_const next; /* per uso
+ di gawk */
address@hidden awk_input_parser_t;
address@hidden example
+
+I campi sono:
+
address@hidden @code
address@hidden const char *name;
+Il nome dell'analizzatore di input. Questa @`e una normale stringa di
caratteri
+del linguaggio C.
+
address@hidden awk_bool_t (*can_take_file)(const awk_input_buf_t *iobuf);
+Un puntatore alla funzione @address@hidden()}.
+
address@hidden awk_bool_t (*take_control_of)(awk_input_buf_t *iobuf);
+Un puntatore alla funzione @address@hidden()}.
+
address@hidden awk_const struct input_parser *awk_const next;
+Questa struttura @`e per uso di @command{gawk};
+per questo motivo @`e marcata @code{awk_const} in modo che l'estensione non
+possa modificarla.
address@hidden table
+
+I passi da seguire sono i seguenti:
+
address@hidden
address@hidden
+Creare una variabile @code{static awk_input_parser_t} e inizializzarla
+adeguatamente.
+
address@hidden
+Quando l'estensione @`e caricata, registrare l'analizzatore personalizzato di
+input con @command{gawk} usando la funzione API @code{register_input_parser()}
+(descritta address@hidden sotto).
address@hidden enumerate
+
+La definizione di una struttura @code{awk_input_buf_t} @`e simile a questa:
+
address@hidden
+typedef struct awk_input @{
+ const char *name; /* nome file */
+ int fd; /* descrittore di file */
+#define INVALID_HANDLE (-1)
+ void *opaque; /* area dati privata
+ per l'analizzatore di input */
+ int (*get_record)(char **out, struct awk_input *iobuf,
+ int *errcode, char **rt_start, size_t *rt_len);
+ ssize_t (*read_func)();
+ void (*close_func)(struct awk_input *iobuf);
+ struct stat sbuf; /* buffer per stat */
address@hidden awk_input_buf_t;
address@hidden example
+
+I campi si possono dividere in due categorie: quelli che sono usati (almeno
+inizialmente) da @address@hidden()}, e quelli che sono usati da
address@hidden@var{XXX}_take_control_of()}. Il primo gruppo di campi, e il
loro uso,
address@hidden address@hidden@dotless{i}} definito:
+
address@hidden @code
address@hidden const char *name;
+Il nome del file.
+
address@hidden int fd;
+Un descrittore di file per il file. Se @command{gawk} riesce ad aprire
+il file, il valore di @code{fd} @emph{non} address@hidden uguale a
address@hidden [descrittore non valido]. In caso contrario,
+quello address@hidden il valore.
+
address@hidden struct stat sbuf;
+Se il descrittore di file @`e valido, @command{gawk} address@hidden riempito i
campi di
+questa struttura invocando la chiamata di sistema @code{fstat()}.
address@hidden table
+
+La funzione @address@hidden()} dovrebbe esaminare i campi di
+cui sopra e decidere se l'analizzatore di input vada usato per il file.
+La decisione address@hidden dipendere da uno stato di @command{gawk} (il valore
+di una variabile definita in precedenza dall'estensione e impostata dal
+codice @command{awk}), dal nome del
+file, dal fatto che il descrittore di file sia valido o no,
+dalle informazioni contenute in @code{struct stat} o da una qualsiasi
+combinazione di questi fattori.
+
+Una volta che @address@hidden()} restituisce @dfn{true}, e
address@hidden ha deciso di usare l'analizzatore personalizzato, viene
+chiamata la funzione @address@hidden()}. Tale funzione
+si occupa di riempire il campo @code{get_record} oppure il campo
address@hidden nella struttura @code{awk_input_buf_t}. La funzione si
+assicura inoltre che @code{fd} @emph{not} sia impostato al valore
address@hidden L'elenco seguente descrive i campi che
+possono essere riempiti da @address@hidden()}:
+
address@hidden @code
address@hidden void *opaque;
+Questo campo @`e usato per contenere qualiasi informazione di stato sia
+necessaria per l'analizzatore di input
+riguardo a questo file. Il campo @`e ``opaco'' per @command{gawk}.
+L'analizzatore di input non @`e obbligato a usare questo puntatore.
+
address@hidden int@ (*get_record)(char@ **out,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ struct@ awk_input *iobuf,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ int *errcode,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ char **rt_start,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ size_t *rt_len);
+Questo puntatore a funzione dovrebbe puntare a una funzione che crea i record
+in input. Tale funzione @`e il nucleo centrale dell'analizzatore di input.
+Il suo modo di operare @`e descritto nel testo che segue questo elenco.
+
address@hidden ssize_t (*read_func)();
+Questo puntatore a funzione dovrebbe puntare a una funzione che ha lo
+stesso comportamento della chiamata di sistema standard POSIX @code{read()}.
address@hidden in alternativa al puntatore a @code{get_record}. Il relativo
comportamento
address@hidden pure descritto nel testo che segue quest'elenco.
+
address@hidden void (*close_func)(struct awk_input *iobuf);
+Questo puntatore a funzione dovrebbe puntare a una funzione che fa
+la ``pulizia finale''. Dovrebbe liberare ogni risorsa allocata da
address@hidden@var{XXX}_take_control_of()}. address@hidden anche chiudere il
file. Se lo fa,
+dovrebbe impostare il campo @code{fd} a @code{INVALID_HANDLE}.
+
+Se @code{fd} @`e ancora diverso da @code{INVALID_HANDLE} dopo la chiamata a
+questa funzione, @command{gawk} invoca la normale chiamata di sistema
address@hidden()}.
+
+Avere una funzione di ``pulizia'' @`e facoltativo. Se l'analizzatore di input
+non ne ha bisogno, basta non impostare questo campo. In questo caso,
address@hidden invoca la normale chiamata di sistema @code{close()} per il
+descrittore di file, che, quindi, dovrebbe essere valido.
address@hidden table
+
+La funzione @address@hidden()} svolge il lavoro di creazione dei
+record in input. I parametri sono i seguenti:
+
address@hidden @code
address@hidden char **out
+Questo @`e un puntatore a una variabile @code{char *} che @`e impostatata in
modo
+da puntare al record. @command{gawk} usa una sua copia locale dei dati,
+quindi l'estensione deve gestire la relativa area di memoria.
+
address@hidden struct awk_input *iobuf
+Questa @`e la struttura @code{awk_input_buf_t} per il file. I campi dovrebbero
+essere usati per leggere i dati (@code{fd}) e per gestire lo stato privato
+(@code{opaque}), se necessario.
+
address@hidden int *errcode
+Se si verifica un errore, @code{*errcode} dovrebbe essere impostato a un
+valore appropriato tra quelli contenuti in @code{<errno.h>}.
+
address@hidden char **rt_start
address@hidden size_t *rt_len
+Se il concetto ``fine record'' @`e applicabile,
address@hidden dovrebbe essere impostato per puntare ai dati da usare come
address@hidden, e @code{*rt_len} dovrebbe essere impostata alla lunghezza di
quel
+campo. In caso contrario, @code{*rt_len} dovrebbe essere impostata a zero.
address@hidden usa una sua copia di questi dati, quindi l'estensione deve
+gestire tale memoria.
address@hidden table
+
+Il codice di ritorno @`e la lunghezza del buffer puntato da
address@hidden oppure @code{EOF}, se @`e stata raggiunta la fine del file o se
+si @`e verificato un errore.
+
+Poich@'e @code{errcode} @`e sicuramente un puntatore valido, non c'@`e
+bisogno di controllare che il valore sia @code{NULL}. @command{gawk}
+imposta @code{*errcode} a zero, quindi non c'@`e bisogno di impostarlo, a meno
+che non si verifichi un errore.
+
+In presenza di un errore, la funzione dovrebbe restituire @code{EOF} e
+impostare @code{*errcode} a un valore maggiore di zero. In questo caso, se
address@hidden non @`e uguale a zero, @command{gawk} automaticamente aggiorna
+la variabile @code{ERRNO} usando il valore contenuto in @code{*errcode}.
+(In generale, impostare @samp{*errcode = errno} dovrebbe essere la
+cosa giusta da fare.)
+
+Invece di fornire una funzione che restituisce un record in input,
address@hidden possibile fornirne una che semplicemente legge dei byte, e lascia
+che sia @command{gawk} ad analizzare i dati per farne dei record. In questo
+caso, i dati dovrebbero essere restituiti nella codifica multibyte propria
+della localizzazione corrente.
+Una siffatta funzione dovrebbe imitare il comportamento della chiamata di
+sistema @code{read()}, e riempire il puntatore @code{read_func} con
+il proprio indirizzo nella struttura @code{awk_input_buf_t}.
+
+Per default, @command{gawk} imposta il puntatore @code{read_func} in modo che
+punti alla chiamata di sistema @code{read()}. In questo modo l'estensione
+non deve preoccuparsi di impostare esplicitamente questo campo.
+
address@hidden NOTA
+Occorre decidere per l'uno o per l'altro metodo: o una funzione che
+restituisce un record o una che restituisce dei dati grezzi. Nel dettaglio,
+se si fornisce una funzione che prepara un record, @command{gawk} la
address@hidden, e non address@hidden mai la funzione che fa una lettura grezza.
address@hidden quotation
+
address@hidden viene distribuito con un'estensione di esempio che legge
+delle directory, restituendo un record per ogni elemento contenuto nella
+directory (@pxref{Esempio di estensione Readdir}. Questo codice sorgente
address@hidden
+essere usato come modello per scrivere un analizzatore di input
+personalizzato.
+
+Quando si scrive un analizzatore di input, si dovrebbe progettare (e
+documentare) il modo con cui si suppone che interagisca con il codice
address@hidden Si address@hidden scegliere di utilizzarlo per tutte le
letture, e
+intervenire solo quando @`e necessario, (come fa l'estensione di
+esempio @code{readdir}). Oppure lo si address@hidden utilizzare a seconda del
+valore preso da una variabile @command{awk}, come fa l'estensione XML
+inclusa nel progetto @code{gawkextlib} (@pxref{gawkextlib}).
+In quest'ultimo caso, il codice in una regola @code{BEGINFILE}
address@hidden controllare @code{FILENAME} ed @code{ERRNO} per decidere se
+attivare un analizzatore di input (@pxref{BEGINFILE/ENDFILE}) oppure no.
+
+Un analizzatore di input va registrato usando la seguente funzione:
+
address@hidden @code
address@hidden void register_input_parser(awk_input_parser_t *input_parser);
+Registra l'analizzatore di input puntato da @code{input_parser} con
address@hidden
address@hidden table
+
address@hidden Processori di output
address@hidden Registrare un processore di output
address@hidden personalizzato, processore di output
address@hidden processore di output personalizzato
address@hidden output, processore di, personalizzato
+
address@hidden processore di output
address@hidden output, processore di
+Un @dfn{processore di output} @`e l'immagine riflessa di un
+analizzatore di input.
+Consente a un'estensione di prendere il controllo dell'output
+indirizzato verso un file
+che sia stato aperto con gli operatori di ridirezione di I/O
address@hidden>} o @samp{>>} (@pxref{Ridirezione}).
+
+Il processore di output @`e molto simile, come struttura,
+all'analizzatore di input:
+
address@hidden
+typedef struct awk_output_wrapper @{
+ const char *name; /* nome del processore */
+ awk_bool_t (*can_take_file)(const awk_output_buf_t *outbuf);
+ awk_bool_t (*take_control_of)(awk_output_buf_t *outbuf);
+ awk_const struct awk_output_wrapper *awk_const next; /* per gawk */
address@hidden awk_output_wrapper_t;
address@hidden example
+
+I campi sono i seguenti:
+
address@hidden @code
address@hidden const char *name;
+Questo @`e il nome del processore di output.
+
address@hidden awk_bool_t (*can_take_file)(const awk_output_buf_t *outbuf);
+Questo @`e il puntatore a una funzione che esamina l'informazione contenuta
+nella struttura @code{awk_output_buf_t} puntata da @code{outbuf}.
+Dovrebbe restituire @dfn{true} se il processore di output vuole elaborare
+il file, e @dfn{false} in caso contrario.
+Nessuno stato (valori di variabili, etc.) dovrebbe essere modificato
+all'interno di @command{gawk}.
+
address@hidden awk_bool_t (*take_control_of)(awk_output_buf_t *outbuf);
+La funzione puntata da questo campo viene chiamata quando @command{gawk}
+decide di consentire al processore di output di prendere il controllo del file.
+Dovrebbe riempire in maniera appropriata dei campi nella struttura
address@hidden, come descritto sotto, e restituire @dfn{true} se
+ha successo, @dfn{false} in caso contrario.
+
address@hidden awk_const struct output_wrapper *awk_const next;
+Questa struttura @`e per uso di @command{gawk};
+per questo motivo @`e marcata @code{awk_const} in modo che l'estensione non
+possa modificarlo.
address@hidden table
+
+La struttura @code{awk_output_buf_t} @`e simile a questa:
+
address@hidden
+typedef struct awk_output_buf @{
+ const char *name; /* nome del file in output */
+ const char *mode; /* argomento @dfn{mode} per fopen */
+ FILE *fp; /* puntatore stdio file */
+ awk_bool_t redirected; /* @dfn{true} se un processore @`e attivo */
+ void *opaque; /* per uso del processore di output */
+ size_t (*gawk_fwrite)(const void *buf, size_t size, size_t count,
+ FILE *fp, void *opaque);
+ int (*gawk_fflush)(FILE *fp, void *opaque);
+ int (*gawk_ferror)(FILE *fp, void *opaque);
+ int (*gawk_fclose)(FILE *fp, void *opaque);
address@hidden awk_output_buf_t;
address@hidden example
+
+Anche qui, l'estensione address@hidden le funzioni @address@hidden()}
+e @address@hidden()} che esaminano e aggiornano
+campi dati in @code{awk_output_buf_t}.
+I campi dati sono i seguenti:
+
address@hidden @code
address@hidden const char *name;
+Il nome del file in output.
+
address@hidden const char *mode;
+La stringa @dfn{mode} (come sarebbe usata nel secondo argomento della
+chiamata di sistema @code{fopen()})
+con cui il file era stato aperto.
+
address@hidden FILE *fp;
+Il puntatore @code{FILE} da @code{<stdio.h>}. @command{gawk} apre il file
+prima di controllare se esiste un processore di output.
+
address@hidden awk_bool_t redirected;
+Questo campo dev'essere impostato a @dfn{true} dalla funzione
address@hidden@var{XXX}_take_control_of()}.
+
address@hidden void *opaque;
+Questo puntatore @`e opaco per @command{gawk}. L'estensione dovrebbe usarlo
+per contenere un puntatore a qualsiasi dato privato associato al file.
+
address@hidden size_t (*gawk_fwrite)(const void *buf, size_t size, size_t count,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ FILE *fp, void
*opaque);
address@hidden int (*gawk_fflush)(FILE *fp, void *opaque);
address@hidden int (*gawk_ferror)(FILE *fp, void *opaque);
address@hidden int (*gawk_fclose)(FILE *fp, void *opaque);
+Questi puntatori dovrebbero essere impostati per puntare a funzioni
+la cui azione sia equivalente a quella delle funzioni di @code{<stdio.h>},
+se questo @`e cio che si desidera.
address@hidden usa questi puntatori a funzione per @emph{tutti} gli output.
address@hidden inizializza i puntatori per puntare a funzioni interne
+``di passaggio'' che si limitano a chiamare le funzioni normali di
address@hidden<stdio.h>}, e quindi un'estensione deve ridefinire solo le
funzioni
+appropriate per fare il lavoro richiesto.
address@hidden table
+
+La funzione @address@hidden()} dovrebbe decidere in base ai
+campi @code{name} e @code{mode}, e a ogni altro ulteriore indicatore di stato
+(p.es., valori di variabili @command{awk}) adatto allo scopo.
+
+Quando @command{gawk} chiama @address@hidden()}, la funzione
+dovrebbe riempire i rimanenti campi
+in modo opportuno, tranne che per @code{fp}, che dovrebbe essere usato
+normalmente.
+
+Il processore di output va registrato usando la seguente funzione:
+
address@hidden @code
address@hidden void register_output_wrapper(awk_output_wrapper_t
*output_wrapper);
+Registra il processore di output puntato da @code{output_wrapper} con
address@hidden
address@hidden table
+
address@hidden Processori bidirezionali
address@hidden Registrare un processore bidirezionale
address@hidden personalizzato, processore bidirezionale
address@hidden processore bidirezionale personalizzato
address@hidden bidirezionale, processore personalizzato
+
+Un @dfn{processore bidirezionale} combina un analizzatore di input e
+un processore di output per un I/O
+bidirezionale usando l'operatore @samp{|&} (@pxref{Ridirezione}).
+Le strutture @code{awk_input_parser_t} e @code{awk_output_buf_t}
+sono usate nella maniera address@hidden descritta precedentemente.
+
+Un processore bidirezionale @`e rappresentato dalla struttura seguente:
+
address@hidden
+typedef struct awk_two_way_processor @{
+ const char *name; /* nome del processore bidirezionale */
+ awk_bool_t (*can_take_two_way)(const char *name);
+ awk_bool_t (*take_control_of)(const char *name,
+ awk_input_buf_t *inbuf,
+ awk_output_buf_t *outbuf);
+ awk_const struct awk_two_way_processor *awk_const next; /* per gawk */
address@hidden awk_two_way_processor_t;
address@hidden example
+
+I campi sono i seguenti:
+
address@hidden @code
address@hidden const char *name;
+Il nome del processore bidirezionale.
+
address@hidden awk_bool_t (*can_take_two_way)(const char *name);
+La funzione puntata da questo campo dovrebbe restituire @dfn{true} se
+vuole gestire l'I/O bidirezionale per questo @value{FN}.
+La funzione non dovrebbe modificare alcuno stato (valori di variabili, etc.)
+all'interno di @command{gawk}.
+
address@hidden awk_bool_t (*take_control_of)(const char *name,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_input_buf_t *inbuf,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_output_buf_t *outbuf);
+La funzione puntata da questo campo dovrebbe riempire le strutture
address@hidden e @code{awk_output_buf_t} puntate da @code{inbuf} e
address@hidden, rispettivamente. Queste strutture sono address@hidden state
descritte
+in precedenza.
+
address@hidden awk_const struct two_way_processor *awk_const next;
+Questa struttura @`e per uso di @command{gawk};
+per questo motivo @`e marcata @code{awk_const} in modo che l'estensione non
+possa modificarla.
address@hidden table
+
+Come per l'analizzatore di input e il processore di output, vanno fornite le
+funzione address@hidden@dotless{i}}, ci penso io'' e ``per questo, fai tu'',
address@hidden@var{XXX}_can_take_two_way()} e @address@hidden()}.
+
+Il processore bidirezionale va registrato usando la seguente funzione:
+
address@hidden @code
address@hidden void register_two_way_processor(awk_two_way_processor_t
*two_way_processor);
+Registra il processore bidirezionale puntato da @code{two_way_processor} con
address@hidden
address@hidden table
+
address@hidden Stampare messaggi
address@hidden Stampare messaggi dalle estensioni
address@hidden stampare messaggi dalle estensioni
address@hidden messaggi, stampare dalle estensioni
address@hidden estensioni, stampare messaggi dalle
+
address@hidden possibile stampare diversi tipi di messaggi di avvertimento da
+un'estensione, come qui spiegato. Si noti che, per queste funzioni,
+si deve fornire l'ID di estensione ricevuto da @command{gawk}
+al momento in cui l'estensione @`e stata caricata:@footnote{Poich@'e l'API usa
solo
address@hidden previste dal
+compilatore ISO C 90, non @`e possibile usare le macro di tipo variadico
+(che accettano un numero variabile di argomenti) disponibili nel compilatore
+ISO C 99, che nasconderebbero quel parametro. Un vero peccato!}
+
address@hidden @code
address@hidden void fatal(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio e poi @command{gawk} termina immediatamente l'esecuzione.
+
address@hidden void nonfatal(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio di errore non-fatale.
+
address@hidden void warning(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio di avvertimento.
+
address@hidden void lintwarn(awk_ext_id_t id, const char *format, ...);
+Stampa un messaggio di avvertimento ``lint''. Normalmente questo equivale a
+stampare un messaggio di avvertimento, ma se @command{gawk} era stato
+invocato specificando l'opzione @samp{--lint=fatal},
+gli avvertimenti di @dfn{lint} diventano messaggi di errore fatali.
address@hidden table
+
+Tutte queste funzioni sono per il resto simili alla famiglia di funzioni
address@hidden()} del linguaggio C, dove il parametro @code{format} @`e una
+stringa contenente dei caratteri normali e delle istruzioni di formattazione,
+mischiati tra loro.
+
address@hidden Aggiornare @code{ERRNO}
address@hidden Funzioni per aggiornare @code{ERRNO}
+
+Le seguenti funzioni consentono l'aggiornamento della variabile
address@hidden:
+
address@hidden @code
address@hidden void update_ERRNO_int(int errno_val);
+Imposta @code{ERRNO} alla stringa equivalente del codice di errore
+in @code{errno_val}. Il valore dovrebbe essere uno dei codici di errore
+definiti in @code{<errno.h>}, e @command{gawk} lo trasforma in una stringa
+(qualora possibile, tradotta) usando la funzione C @code{strerror()}.
+
address@hidden void update_ERRNO_string(const char *string);
+Imposta @code{ERRNO} direttamente usando il valore della stringa specificata.
address@hidden fa una copia del valore di @code{stringa}.
+
address@hidden void unset_ERRNO(void);
+Annulla il valore di @code{ERRNO}.
address@hidden table
+
address@hidden Richiedere valori
address@hidden Richiedere valori
+
+Tutte le funzioni che restituiscono valori da @command{gawk}
+funzionano allo stesso modo. Si fornisce un campo @code{awk_valtype_t}
+per indicare il tipo di valore che ci si aspetta. Se il valore disponibile
+corrisponde a quello richiesto, la funzione restituisce @dfn{true} e riempie
+il campo del risultato @code{awk_value_t}.
+Altrimenti, la funzione restituisce @dfn{false}, e il campo @code{val_type}
+indica il tipo di valore disponibile.
+A quel punto si address@hidden, a seconda di quel che richiede la situazione,
+stampare un messaggio di errore oppure ripetere la
+richiesta specificando il tipo di valore che risulta disponibile. Questo
+comportamento @`e riassunto nella
address@hidden
+
address@hidden Tabella,table-value-types-returned
address@hidden di valori restituiti dall'API}
address@hidden
+<informaltable>
+<tgroup cols="8">
+ <colspec colname="c1"/>
+ <colspec colname="c2"/>
+ <colspec colname="c3"/>
+ <colspec colname="c4"/>
+ <colspec colname="c5"/>
+ <colspec colname="c6"/>
+ <colspec colname="c7"/>
+ <colspec colname="c8"/>
+ <spanspec spanname="hspan" namest="c3" nameend="c8" align="center"/>
+ <thead>
+ <row><entry></entry><entry spanname="hspan"><para>Tipo di valore
reale</para></entry></row>
+ <row>
+ <entry></entry>
+ <entry></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Regexp</para></entry>
+ <entry><para>Vettore</para></entry>
+ <entry><para>Indefinito</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Stringa</emphasis></para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Strnum</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Numero</emphasis></para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry><para><emphasis role="bold">Tipo</emphasis></para></entry>
+ <entry><para><emphasis role="bold">Regexp</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>Regexp</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry><para><emphasis role="bold">Richiesto</emphasis></para></entry>
+ <entry><para><emphasis role="bold">Vettore</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>Vettore</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Scalare</emphasis></para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>Scalare</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">Indefinito</emphasis></para></entry>
+ <entry><para>Stringa</para></entry>
+ <entry><para>Strnum</para></entry>
+ <entry><para>Numero</para></entry>
+ <entry><para>Regexp</para></entry>
+ <entry><para>Vettore</para></entry>
+ <entry><para>Indefinito</para></entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry><para><emphasis role="bold">@dfn{Value
cookie}</emphasis></para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ <entry><para>false</para></entry>
+ </row>
+ </tbody>
+</tgroup>
+</informaltable>
address@hidden docbook
+
address@hidden
address@hidden
address@hidden @columnfractions .50 .50
address@hidden @tab Tipo di valore reale
address@hidden multitable
address@hidden 10/2014: Thanks to Karl Berry for this bit to reduce the space:
address@hidden
+\vglue-1.1\baselineskip
address@hidden tex
address@hidden @multitable @columnfractions .166 .166 .198 .15 .15 .166
address@hidden SMALLPRINT
address@hidden {Richiesto} {Indefinito} {Numero} {Numero} {Scalar} {Regexp}
{Vettore} {Indefinito}
address@hidden @tab @tab Stringa @tab Strnum @tab Numero @tab Regexp @tab
Vettore @tab Indefinito
address@hidden @tab @b{Stringa} @tab Stringa @tab Stringa @tab Stringa @tab
Stringa @tab false @tab false
address@hidden @tab @b{Strnum} @tab false @tab Strnum @tab Strnum @tab false
@tab false @tab false
address@hidden @tab @b{Numero} @tab Numero @tab Numero @tab Numero @tab false
@tab false @tab false
address@hidden @b{Tipo} @tab @b{Regexp} @tab false @tab false @tab false @tab
Regexp @tab false @tab false
address@hidden @b{Richiesto} @tab @b{Vettore} @tab false @tab false @tab false
@tab false @tab Vettore @tab false
address@hidden @tab @b{Scalar} @tab Scalar @tab Scalar @tab Scalar @tab Scalar
@tab false @tab false
address@hidden @tab @b{Indefinito} @tab Stringa @tab Strnum @tab Numero @tab
Regexp @tab Vettore @tab Indefinito
address@hidden @tab @b{Value cookie} @tab false @tab false @tab false @tab
false @tab false @tab false
address@hidden multitable
address@hidden ifclear
+
address@hidden SMALLPRINT
address@hidden
address@hidden {Richiesto} {Value cookie} {Num.} {Num.} {Scal.} {Regexp}
{Vett.} {Indef.}
address@hidden @tab @tab String @tab Strn. @tab Num. @tab Regexp @tab Vett.
@tab Indef.
address@hidden @tab @b{Stringa} @tab String @tab String @tab String @tab String
@tab false @tab false
address@hidden @tab @b{Strnum} @tab false @tab Strn. @tab Strn. @tab false @tab
false @tab false
address@hidden @tab @b{Numero} @tab Num. @tab Num. @tab Num. @tab false @tab
false @tab false
address@hidden @b{Tipo} @tab @b{Regexp} @tab false @tab false @tab false @tab
Regexp @tab false @tab false
address@hidden @b{Richiesto} @tab @b{Vettore} @tab false @tab false @tab false
@tab false @tab Vett. @tab false
address@hidden @tab @b{Scalar} @tab Scal. @tab Scal. @tab Scal. @tab Scal. @tab
false @tab false
address@hidden @tab @b{Indefinito} @tab String @tab Strn. @tab Num. @tab Regexp
@tab Vett. @tab Indef.
address@hidden @tab @b{Value cookie} @tab false @tab false @tab false @tab
false @tab false @tab false
address@hidden multitable
address@hidden smallformat
address@hidden ifset
address@hidden ifnotdocbook
address@hidden ifnotplaintext
address@hidden
address@hidden
+
+-------------------------------------------------------+
+ | Tipo di valore reale:
|
+
+--------+--------+--------+--------+-------+-----------+
+ | Stringa| Strnum | Numero | Regexp |Vettore|
Indefinito|
++-----------+-----------+--------+--------+--------+--------+-------+-----------+
+| | Stringa | Stringa| Stringa| Stringa| Stringa| false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Strnum | false | Strnum | Strnum | false | false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Numero | Numero | Numero | Numero | false | false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Regexp | false | false | false | Regexp | false | false
|
+| Tipo
+-----------+--------+--------+--------+--------+-------+-----------+
+|Richiesto: | Vettore | false | false | false | false |Vettore| false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Scalare | Scalare| Scalare| Scalare| Scalare| false | false
|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Indefinito| Stringa| Strnum | Numero | Regexp |Vettore|
Indefinito|
+|
+-----------+--------+--------+--------+--------+-------+-----------+
+| | Value- | false | false | false | false | false | false
|
+| | Cookie | | | | | |
|
++-----------+-----------+--------+--------+--------+--------+-------+-----------+
address@hidden verbatim
address@hidden ifplaintext
address@hidden float
+
address@hidden Accedere ai parametri
address@hidden Accedere ai parametri e aggiornarli
+
+Due funzioni consentono di accedere agli argomenti (parametri)
+passati all'estensione. Esse sono:
+
address@hidden @code
address@hidden awk_bool_t get_argument(size_t count,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_valtype_t
wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_value_t
*risultato);
+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.
+In quest'ultimo caso,
address@hidden@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
address@hidden@dotless{i}} via.
address@hidden indica il tipo di valore atteso.
+
address@hidden awk_bool_t set_argument(size_t count, awk_array_t array);
+Converte un parametro di tipo indefinito in un vettore; address@hidden
permette la
+chiamata per riferimento per i vettori. Restituisce @dfn{false} se
@code{count} @`e troppo elevato,
+o se il tipo di argomento @`e diverso da @dfn{undefined}.
address@hidden di vettori}
+per ulteriori informazioni riguardo alla creazione di vettori.
address@hidden table
+
address@hidden Accedere alla tabella simboli
address@hidden Accedere alla Tabella dei simboli
address@hidden accedere alle variabili globali dalle estensioni
address@hidden variabili globali, accesso dalle estensioni
address@hidden estensioni, accesso alle variabili globali
+
+Due insiemi di routine permettono di accedere alle variabili globali,
+e un insieme consente di creare e rilasciare dei valori nascosti.
+
address@hidden
+* Tabella simboli per nome:: Accedere alle variabili per nome.
+* Tabella simboli tramite cookie:: Accedere alle variabili per ``cookie''.
+* Valori nascosti:: Creare e usare valori nascosti.
address@hidden menu
+
address@hidden Tabella simboli per nome
address@hidden Accedere alle variabili per nome e aggiornarle
+
+Le routine che seguono permettono di raggiungere e aggiornare
+le variabili globali a livello di @command{awk} per nome. Nel gergo dei
+compilatori, gli identificativi di vario tipo sono noti come @dfn{simboli},
+da cui il prefisso ``sym'' nei nomi delle routine. La struttura di dati che
+contiene informazioni sui simboli @`e chiamata @dfn{Tabella dei simboli}
+(@dfn{Symbol table}).
+Le funzioni sono le seguenti:
+
address@hidden @code
address@hidden awk_bool_t sym_lookup(const char *name,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_valtype_t wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_value_t
*risultato);
+Riempie la struttura @code{awk_value_t} puntata da @code{risultato}
+con il valore della variabile il cui nome @`e nella stringa @code{name},
+che @`e una normale stringa di caratteri C.
address@hidden 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.
+In quest'ultimo caso, @code{risultato>val_type} indica il tipo effettivo
+della variabile
+(@pxref{table-value-types-returned}).
+
address@hidden awk_bool_t sym_update(const char *name, awk_value_t *valore);
+Aggiorna la variabile il cui nome @`e contenuto nella stringa @code{name},
+che @`e una normale stringa di caratteri C.
+La variabile @`e aggiunta alla Tabella dei simboli di @command{gawk},
+se non @`e address@hidden presente. Restituisce @dfn{true} se tutto @`e
andato bene, e
address@hidden in caso contrario.
+
+La modifica del tipo (da scalare a vettoriale o viceversa) di una variabile
address@hidden esistente @emph{non} @`e consentito, e questa routine non
address@hidden neppure
+essere usata per aggiornare un vettore.
+Questa routine non address@hidden essere usata per modificare nessuna delle
variabili
+predefinite (come @code{ARGC} o @code{NF}).
address@hidden table
+
+Un'estensione address@hidden andare a cercare il valore delle variabili
speciali di
address@hidden
+Tuttavia, con l'eccezione del vettore @code{PROCINFO}, un'estensione
+non address@hidden cambiare alcuna di queste variabili.
+
address@hidden Tabella simboli tramite cookie
address@hidden Accedere alle variabili per ``cookie'' e aggiornarle
+
+Uno @dfn{scalar cookie} @`e un puntatore nascosto (@dfn{opaque handle}) che
+fornisce accesso a una
+variabile globale o a un vettore. Si tratta di un'ottimizzazione, per evitare
+di ricercare variabili nella Tabella dei simboli di @command{gawk} ogni volta
+che un accesso @`e necessario. Questo
+argomento @`e address@hidden stato trattato in precedenza, nella
address@hidden di dati generali}.
+
+Le funzioni seguenti servono per gestire gli @dfn{scalar cookie}:
+
address@hidden @code
address@hidden awk_bool_t sym_lookup_scalar(awk_scalar_t cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_valtype_t wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_value_t *risultato);
+Ottiene il valore corrente di uno @dfn{scalar cookie}.
+Una volta ottenuto lo @dfn{scalar cookie} usando @code{sym_lookup()}, si
address@hidden usare questa funzione per accedere al valore della variabile in
modo
address@hidden efficiente.
+Restituisce @dfn{false} se il valore non @`e disponibile.
+
address@hidden awk_bool_t sym_update_scalar(awk_scalar_t cookie, awk_value_t
*valore);
+Aggiorna il valore associato con uno @dfn{scalar cookie}.
+Restituisce @dfn{false} se il nuovo valore non @`e del tipo
address@hidden, @code{AWK_STRNUM}, @code{AWK_REGEX} o @code{AWK_NUMBER}.
+Anche in questo caso, le variabili predefinite non possono essere aggiornate.
address@hidden table
+
+Non @`e immediatamente evidente come si lavora con gli @dfn{scalar cookie} o
+quale sia la loro vera @i{ragion d'essere}. In teoria, le routine
address@hidden()} e @code{sym_update()} sono tutto address@hidden che occorre
per
+lavorare con le variabili. Per esempio, ci potrebbe essere un codice che
+ricerca il valore di una variabile, valuta una condizione, e potrebbe
+poi cambiare il valore della variabile a seconda dei risultati della
+valutazione in modo simile a questo:
+
address@hidden
+/* do_magic --- fai qualcosa di veramente grande */
+
+static awk_value_t *
+do_magic(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t valore;
+
+ if ( sym_lookup("MAGIC_VAR", AWK_NUMBER, & valore)
+ && qualche_condizione(valore.num_valore)) @{
+ valore.num_valore += 42;
+ sym_update("MAGIC_VAR", & valore);
+ @}
+
+ return make_number(0.0, risultato);
address@hidden
address@hidden example
+
address@hidden
+Questo codice sembra (ed @`e) semplice e immediato. Qual @`e il problema?
+
+Beh, si consideri cosa succede se un qualche codice a livello di @command{awk}
+associato con l'estensione richiama la funzione @code{magic()}
+(implementata in linguaggio C da @code{do_magic()}), una volta per ogni
+record, mentre si stanno elaborando
+file contenenti migliaia o milioni di record.
+La variabile @code{MAGIC_VAR} viene ricercata nella Tabella dei simboli una o
due
+volte per ogni richiamo della funzione!
+
+La ricerca all'interno della Tabella dei simboli @`e in address@hidden una
pura perdita
+di tempo; @`e molto address@hidden efficiente
+ottenere un @dfn{value cookie} che rappresenta la variabile, e usarlo per
+ottenere il valore della variabile e aggiornarlo a seconda della
address@hidden@footnote{La differenza @`e misurabile e indubbiamente reale.
+Fidatevi.}
+
+Quindi, la maniera per usare i valori-cookie @`e la seguente. Per prima
+cosa, la variabile di estensione va messa nella Tabella dei simboli di
address@hidden usando @code{sym_update()}, come al solito. Poi si deve ottenere
+uno @dfn{scalar cookie} per la
+variabile usando @code{sym_lookup()}:
+
address@hidden
+static awk_scalar_t magic_var_cookie; /* cookie per MAGIC_VAR */
+
+static void
+inizializza_estensione()
address@hidden
+ awk_value_t valore;
+
+ /* immettere il valore iniziale */
+ sym_update("MAGIC_VAR", make_number(42.0, & valore));
+
+ /* ottenere il @dfn{value cookie} */
+ sym_lookup("MAGIC_VAR", AWK_SCALAR, & valore);
+
+ /* salvarlo per dopo */
+ magic_var_cookie = valore.scalar_cookie;
+ @dots{}
address@hidden
address@hidden example
+
+Dopo aver fatto questo, si usino le routine descritte in questa @value{SECTION}
+per ottenere e modificare
+il valore usando il @dfn{value cookie}. Quindi, @code{do_magic()} diviene ora
+qualcosa del tipo:
+
address@hidden
+/* do_magic --- fai qualcosa di veramente grande */
+
+static awk_value_t *
+do_magic(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t valore;
+
+ if ( sym_lookup_scalar(magic_var_cookie, AWK_NUMBER, & valore)
+ && qualche_condizione(valore.num_valore)) @{
+ valore.num_valore += 42;
+ sym_update_scalar(magic_var_cookie, & valore);
+ @}
+ @dots{}
+
+ return make_number(0.0, risultato);
address@hidden
address@hidden example
+
address@hidden NOTA
+Il codice appena visto omette il controllo di eventuali errori, per
+amor di address@hidden Il codice dell'estensione dovrebbe essere
address@hidden complesso
+e controllare attentamente i valori
+restituiti dalle funzioni dell'API.
address@hidden quotation
+
address@hidden Valori nascosti
address@hidden Creare e usare valori nascosti
+
+Le routine in questa @value{SECTION} permettono di creare e rilasciare
+valori nascosti. Come gli @dfn{scalar cookie}, in teoria i valori nascosti
+non sono necessari. Si possono creare numeri e stringhe usando
+le funzioni descritte
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di costruzione}. Si possono poi assegnare
+quei valori a delle variabili usando @code{sym_update()}
+o @code{sym_update_scalar()}, come si preferisce.
+
+Tuttavia, si address@hidden comprendere l'address@hidden di avere dei valori
nascosti
+se si pone mente al fatto che la memoria di @emph{ogni} valore di stringa
address@hidden essere ottenuta tramite @code{gawk_malloc()},
address@hidden()} o @code{gawk_realloc()}.
+Se ci sono 20 variabili, e tutte hanno per valore la stessa stringa,
+si devono creare 20 copie identiche della address@hidden valori
+numerici creano molti meno problemi, in quanto richiedono solo una variabile
+C @code{double} (8 byte) per contenerli.}
+
+Chiaramente @`e address@hidden efficiente, se possibile, creare il valore una
sola volta,
+e fare in modo che @command{gawk} utilizzi quell'unico valore per molte
+variabili. Questo @`e address@hidden che la routine in
address@hidden
+questa
address@hidden ifnotinfo
address@hidden
+questo
address@hidden ifinfo
address@hidden permette
+di fare. Le funzioni sono le seguenti:
+
address@hidden @code
address@hidden awk_bool_t create_value(awk_value_t *valore, awk_value_cookie_t
*risultato);
+Crea una stringa o un valore numerico nascosti, da @code{valore}, in
+vista di un successivo assegnamento di valore. Sono consentiti solo valori di
+tipo @code{AWK_NUMBER}, @code{AWK_REGEX} ed @code{AWK_STRING}.
+Ogni altro tipo @`e rifiutato.
+Il tipo @code{AWK_UNDEFINED} potrebbe essere consentito, ma in questo caso
+l'efficienza del programma ne soffrirebbe.
+
address@hidden awk_bool_t release_value(awk_value_cookie_t vc);
+Libera la memoria associata con un @dfn{value cookie} ottenuto mediante
address@hidden()}.
address@hidden table
+
+Si usano i @dfn{value cookie} in modo dimile a quello con cui si usano gli
address@hidden cookie}.
+Nella routine di inizializzazione dell'estensione, si crea il
address@hidden cookie}:
+
address@hidden
+static awk_value_cookie_t answer_cookie; /* static @dfn{value cookie} */
+
+static void
+inizializza_estensione()
address@hidden
+ awk_value_t value;
+ char *long_string;
+ size_t long_string_len;
+
+ /* codice precedente */
+ @dots{}
+ /* @dots{} riempire long_string e long_string_len @dots{} */
+ make_malloced_string(long_string, long_string_len, & value);
+ create_value(& value, & answer_cookie); /* creare cookie */
+ @dots{}
address@hidden
address@hidden example
+
+Una volta che il valore @`e creato, si address@hidden usare come valore per un
numero
+qualsiasi di variabili:
+
address@hidden
+static awk_value_t *
+do_magic(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t new_value;
+
+ @dots{} /* come in precedenza */
+
+ value.val_type = AWK_VALUE_COOKIE;
+ value.value_cookie = answer_cookie;
+ sym_update("VAR1", & value);
+ sym_update("VAR2", & value);
+ @dots{}
+ sym_update("VAR100", & value);
+ @dots{}
address@hidden
address@hidden example
+
address@hidden
+Usare @dfn{value cookie} in questo modo permette di risparmiare parecchia
+memoria, poich@'e tutte le variabili da @code{VAR1} a @code{VAR100} condividono
+lo stesso valore.
+
+Ci si potrebbe chiedere, ``Questa condivisione crea problemi?
+Cosa succede se il codice @command{awk} assegna un nuovo valore a @code{VAR1};
+sono modificate anche tutte le altre variabili?''
+
+Buona domanda! La risposta @`e che no, non @`e un problema.
+Internamente, @command{gawk} usa
address@hidden contatore dei riferimenti alle stringhe}. Questo significa
+che molte variabili possono condividere lo stesso valore di tipo stringa,
+e @command{gawk} mantiene traccia del loro uso. Quando il valore di
+una variabile viene modificato, @command{gawk} semplicemente diminuisce di
+uno il contatore dei riferimenti del vecchio valore, e aggiorna la variabile
+perch@'e usi il nuovo valore.
+
+Infine, come parte della pulizia al termine del programma
+(@pxref{Funzioni di exit callback})
+si deve liberare ogni valore nascosto che era stato creato, usando
+la funzione @code{release_value()}.
+
address@hidden Manipolazione di vettori
address@hidden Manipolazione di vettori
address@hidden vettori, manipolazione nelle estensioni
address@hidden estensioni, manipolazione di vettori
+
+La struttura di dati address@hidden'accordo, l'unica struttura di dati.}
+in @command{awk} @`e il vettore associativo
address@hidden
+(@pxrefil{Vettori}).
address@hidden iftex
address@hidden
+(@pxref{Vettori}).
address@hidden ifnottex
+Le estensioni devono essere in grado di manipolare vettori @command{awk}.
+L'API fornisce varie strutture di dati per lavorare con vettori,
+funzioni per lavorare con singoli elementi di un vettore, e funzioni per
+lavorare con interi vettori. @`E prevista anche la address@hidden di
+``appiattire'' un vettore in modo da rendere facile a un programma scritto in
+C la ``visita'' di tutti gli elementi del vettore.
+Le strutture dati per i vettori sono facilmente integrabili con le
+strutture dati per variabili scalari, per facilitare sia l'elaborazione, sia
+la creazione di @dfn{veri} vettori di vettori (@pxref{Tipi di dati generali}).
+
address@hidden
+* Tipi di dati per i vettori:: Tipi dati per lavorare coi vettori.
+* Funzioni per i vettori:: Funzioni per lavorare coi vettori.
+* Appiattimento di vettori:: Come appiattire i vettori.
+* Creazione di vettori:: Come creare e popolare vettori.
address@hidden menu
+
address@hidden Tipi di dati per i vettori
address@hidden Tipi di dati per i vettori
+
+I tipi di dato associati con i vettori sono i seguenti:
+
address@hidden @code
address@hidden typedef void *awk_array_t;
+Se si richiede il valore di una variabile contenuta in un vettore, si ottiene
+un valore del tipo @code{awk_array_t}. Questo valore @`e
address@hidden@address@hidden anche un
+``cookie,'' ma gli sviluppatori di @command{gawk} hanno preferito non abusare
+di questo termine.} per l'estensione; identifica in maniera univoca il
+vettore ma address@hidden solo essere usato come parametro di una funzione
dell'API,
+o essere ricevuto da una funzione dell'API. Questo @`e molto simile al modo
+in cui i valori @samp{FILE *} sono usati con le routine di libreria di
address@hidden<stdio.h>}.
+
address@hidden typedef struct awk_element @{
address@hidden @ @ @ @ /* puntatore di servizio
address@hidden @ @ @ @ a lista collegata, non usato da gawk */
address@hidden @ @ @ @ struct awk_element *next;
address@hidden @ @ @ @ enum @{
address@hidden @ @ @ @ @ @ @ @ AWK_ELEMENT_DEFAULT = 0,@ @ /* impostato da gawk
*/
address@hidden @ @ @ @ @ @ @ @ AWK_ELEMENT_DELETE = 1@ @ @ @ /* impostato
dall'estensione */
address@hidden @ @ @ @ @} flags;
address@hidden @ @ @ @ awk_value_t index;
address@hidden @ @ @ @ awk_value_t value;
address@hidden @} awk_element_t;
address@hidden @`e un elemento di vettore ``appiattito''.
address@hidden produce un vettore di questo tipo all'interno della struttura
address@hidden (si veda poco address@hidden avanti).
+Singoli elementi di vettore possono essere marcati per essere cancellati.
+Nuovi elementi del vettore devono essere aggiunti individualmente, uno per
+volta, usando una funzione API apposita. I campi sono i seguenti:
+
address@hidden nested table
address@hidden @code
address@hidden struct awk_element *next;
+Questo puntatore @`e presente come ausilio a chi scrive un'estensione.
+Permette a un'estensione di creare una lista collegata (@dfn{linked list}) di
+nuovi elementi che possono essere aggiunti a un vettore con un
+singolo ciclo che percorre tutta la lista.
+
address@hidden enum @{ @dots{} @} flags;
+Un insieme di valori di flag che passano informazione tra l'estensione
+e @command{gawk}. Per ora c'@`e solo un flag disponibile:
address@hidden
+Se lo si imposta, @command{gawk} elimina l'elemento in questione dal vettore
+originale, dopo che il vettore ``appiattito'' @`e stato rilasciato.
+
address@hidden index
address@hidden value
+L'indice e il valore di un elemento, rispettivamente.
address@hidden la memoria puntata da @code{index} e @code{valore} appartiene
+a @command{gawk}.
address@hidden table
+
address@hidden typedef struct awk_flat_array @{
address@hidden @ @ @ @ awk_const void *awk_const opaque1;@ @ @ @ /* per uso di
gawk */
address@hidden @ @ @ @ awk_const void *awk_const opaque2;@ @ @ @ /* per uso di
gawk */
address@hidden @ @ @ @ awk_const size_t count;@ @ @ @ @ /* quanti elementi nel
vettore */
address@hidden @ @ @ @ awk_element_t elements[1];@ @ /* saranno ``appiattiti''
*/
address@hidden @} awk_flat_array_t;
+Questo @`e un vettore appiattito. Quando un'estensione ottiene da
address@hidden questa struttura, il vettore @code{elements} ha una dimensione
+reale di @code{count} elementi.
+I puntatori @code{opaque1} e @code{opaque2} sono per uso di @command{gawk};
+come tali, sono marcati come @code{awk_const} in modo che l'estensione non
+possa modificarli.
address@hidden table
+
address@hidden Funzioni per i vettori
address@hidden Funzioni per lavorare coi vettori
+
+Le funzioni seguenti permettono di gestire singoli elementi di un vettore:
+
address@hidden @code
address@hidden awk_bool_t get_element_count(awk_array_t a_cookie, size_t
*count);
+Per il vettore rappresentato da @code{a_cookie}, restituisce in @code{*count}
+il numero di elementi in esso contenuti. Ogni sottovettore @`e conteggiato
come
+se fosse un solo elemento.
+Restituisce @dfn{false} se si verifica un errore.
+
address@hidden awk_bool_t get_array_element(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const
awk_value_t *const index,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_valtype_t wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
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}.
address@hidden specifica il tipo di valore che si vuole ritrovare.
+Restituisce @dfn{false} se @code{wanted} 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} address@hidden essere numerico, nel qual caso
@command{gawk}
+lo converte in una stringa. Usare valori non interi @`e possibile, ma
+richiede di comprendere il modo con cui tali valori sono convertiti in stringhe
+(@pxref{Conversione}); per questo motivo, @`e meglio usare numeri interi.
+
+Come per @emph{tutte} le stringhe passate a @command{gawk} da
+un'estensione, la memoria che contiene il valore della stringa con chiave
address@hidden deve essere stata acquisita utilizzando le funzioni
address@hidden()}, @code{gawk_calloc()} o @code{gawk_realloc()}, e
address@hidden address@hidden (al momento opportuno) la relativa memoria.
+
address@hidden awk_bool_t set_array_element(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const@
awk_value_t *const index,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const@
awk_value_t *const value);
+Nel vettore rappresentato da @code{a_cookie}, crea o modifica
+l'elemento il cui indice @`e contenuto in @code{index}.
+I vettori @code{ARGV} ed @code{ENVIRON} non possono essere modificati,
+mentre il vettore @code{PROCINFO} @`e modificabile.
+
address@hidden awk_bool_t set_array_element_by_elem(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
@ @ @ @ @ awk_element_t element);
+Come @code{set_array_element()}, ma prende l'indice @code{index} e
+il valore @code{value} da @code{element}. Questa @`e una macro di
address@hidden
+
address@hidden awk_bool_t del_array_element(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const
awk_value_t* const index);
+Elimina dal vettore, rappresentato da @code{a_cookie}, l'elemento con
+l'indice specificato.
+Restituisce @dfn{true} se l'elemento @`e stato rimosso o @dfn{false} se
+l'elemento non era presente nel vettore.
address@hidden table
+
+Le seguenti funzioni operano sull'intero vettore:
+
address@hidden @code
address@hidden awk_array_t create_array(void);
+Crea un nuovo vettore a cui si possono aggiungere elementi.
address@hidden di vettori} per una trattazione su come
+creare un nuovo vettore e aggiungervi elementi.
+
address@hidden awk_bool_t clear_array(awk_array_t a_cookie);
+Svuota il vettore rappresentato da @code{a_cookie}.
+Restituisce @dfn{false} in presenza di qualche tipo di problema, @dfn{true}
+in caso contrario. Il vettore non viene eliminato ma, dopo aver chiamato
+questa funzione, resta privo di elementi. Questo @`e equivalente a usare
+l'istruzione @code{delete} (@pxref{Cancellazione}).
+
address@hidden awk_bool_t flatten_array_typed(awk_array_t a_cookie,
awk_flat_array_t **data, awk_valtype_t index_type, awk_valtype_t value_type);
+Per il vettore rappresentato da @code{a_cookie}, crea una struttura
address@hidden e la riempie con indici e valori del tipo richiesto.
+Imposta il puntatore il cui indirizzo @`e passato in @code{data} per puntare a
+questa struttura.
+Restituisce @dfn{true} se tutto va bene o @dfn{false} in caso contrario.
address@hidden FOR_PRINT
+Si veda la prossima @value{SECTION}
address@hidden ifset
address@hidden FOR_PRINT
address@hidden di vettori},
address@hidden ifclear
+per una trattazione su come appiattire un vettore per poterci lavorare.
+
address@hidden awk_bool_t flatten_array(awk_array_t a_cookie, awk_flat_array_t
**data);
+Per il vettore rappresentato da @code{a_cookie}, crea una struttura
address@hidden e la riempie con indici di tipo @code{AWK_STRING} e
+valori @code{AWK_UNDEFINED}.
+Questa funzione @`e resa obsoleta da @code{flatten_array_typed()}.
address@hidden fornita come macro, e mantenuta per convenienza e per
address@hidden a
+livello di codice sorgente con la precedente versione dell'API.
+
address@hidden awk_bool_t release_flattened_array(awk_array_t a_cookie,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
@ @ @ awk_flat_array_t *data);
+Quando si @`e finito di lavorare con un vettore appiattito, si liberi la
+memoria usando questa funzione. Occorre fornire sia il cookie del vettore
+originale, sia l'indirizzo della struttura da liberare,
address@hidden
+La funzione restituisce @dfn{true} se tutto va bene, @dfn{false} in caso
contrario.
address@hidden table
+
address@hidden Appiattimento di vettori
address@hidden Lavorare con tutti gli elementi di un vettore
+
address@hidden un vettore vuol dire creare una struttura che
+rappresenta l'intero vettore in modo da facilitare la visita
+dell'intero vettore da parte del codice in C . Parte del codice in
address@hidden/testext.c} fa questo, ed @`e anche un bell'esempio
+di come utilizzare l'API.
+
+Questa parte del codice sorgente address@hidden descritta un po' per volta.
+Ecco, per iniziare, lo script @command{gawk} che richiama l'estensione di test:
+
address@hidden
+@@load "testext"
+BEGIN @{
+ n = split("blacky rusty sophie raincloud lucky", pets)
+ printf("pets ha %d elementi\n", length(pets))
+ ret = dump_array_and_delete("pets", "3")
+ printf("dump_array_and_delete(pets) ha restituito %d\n", ret)
+ if ("3" in pets)
+ printf("dump_array_and_delete() NON ha rimosso l'indice \"3\"!\n")
+ else
+ printf("dump_array_and_delete() ha rimosso l'indice \"3\"!\n")
+ print ""
address@hidden
address@hidden example
+
address@hidden
+Questo codice crea un vettore usando la funzione @code{split()}
+(@pxref{Funzioni per stringhe})
+e poi chiama @code{dump_array_and_delete()}. Questa funzione ricerca
+il vettore il cui nome @`e passato come primo argomento, ed
+elimina l'elemento il cui indice @`e passato come secondo argomento.
+Il codice @command{awk} stampa poi il valore restituito e controlla che
+l'elemento sia stato effettivamente cancellato. Ecco il codice C che
+costituisce la funzione
address@hidden()}. @`E stato leggermente modificato per facilitare
+l'esposizione.
+
+La prima parte dichiara variabili, imposta il valore di ritorno di default
+in @code{risultato}, e controlla che la funzione
+sia stata chiamata con il numero corretto di argomenti:
+
address@hidden
+static awk_value_t *
+dump_array_and_delete(int nargs, awk_value_t *risultato)
address@hidden
+ awk_value_t valore, valore2, valore3;
+ awk_flat_array_t *flat_array;
+ size_t count;
+ char *name;
+ int i;
+
+ assert(risultato != NULL);
+ make_number(0.0, risultato);
+
+ if (nargs != 2) @{
+ printf("dump_array_and_delete: nargs errato "
+ "(%d dovrebbe essere 2)\n", nargs);
+ goto out;
+ @}
address@hidden example
+
+La funzione poi prosegue un passo per volta, come segue. Il primo passo @`e
+ricuperare il nome del vettore, passato come primo argomento, seguito dal
+vettore stesso. Se una di queste operazioni non riesce, viene stampato un
+messaggio di errore e si ritorna al chiamante:
+
address@hidden
+ /* trasforma in un vettore piatto il vettore
+ passato come argomento e lo stampa */
+ if (get_argument(0, AWK_STRING, & value)) @{
+ name = valore.str_value.str;
+ if (sym_lookup(name, AWK_array, & value2))
+ printf("dump_array_and_delete: sym_lookup di %s effettuato\n",
+ name);
+ else @{
+ printf("dump_array_and_delete: sym_lookup di %s non riuscito\n",
+ name);
+ goto out;
+ @}
+ @} else @{
+ printf("dump_array_and_delete: get_argument(0) non riuscito\n");
+ goto out;
+ @}
address@hidden example
+
+Per controllo, e per assicurarsi che il codice C veda
+lo stesso numero di elementi del codice @command{awk},
+il secondo passo @`e quello di ottenere il numero di elementi nel vettore
+e stamparlo:
+
address@hidden
+ if (! get_element_count(valore2.array_cookie, & count)) @{
+ printf("dump_array_and_delete: get_element_count non riuscito\n");
+ goto out;
+ @}
+
+ printf("dump_array_and_delete: il vettore in input ha %lu elementi\n",
+ (unsigned long) count);
address@hidden example
+
+Il terzo passo @`e quello di appiattire il vettore, e quindi
+controllare che il numero di elementi nella struttura @code{awk_flat_array_t}
+sia uguale a quello appena trovato:
+
address@hidden
+ if (! flatten_array_typed(valore2.array_cookie, & flat_array,
+ AWK_STRING, AWK_UNDEFINED)) @{
+ printf("dump_array_and_delete: non sono riuscito ad appiattire \
+il vettore\n");
+ goto out;
+ @}
+
+ if (flat_array->count != count) @{
+ printf("dump_array_and_delete: flat_array->count (%lu)"
+ " != count (%lu)\n",
+ (unsigned long) flat_array->count,
+ (unsigned long) count);
+ goto out;
+ @}
address@hidden example
+
+Il quarto passo @`e ritrovare l'indice dell'elemento
+da eliminare, che era stato passato come secondo argomento.
+Va tenuto presente che i contatori di argomenti passati a @code{get_argument()}
+partono da zero, e che quindi il secondo argomento @`e quello numero uno:
+
address@hidden
+ if (! get_argument(1, AWK_STRING, & value3)) @{
+ printf("dump_array_and_delete: get_argument(1) non riuscito\n");
+ goto out;
+ @}
address@hidden example
+
+Il quinto passo @`e quello in cui si fa il ``vero lavoro''. La funzione esegue
+un ciclo su ogni elemento nel vettore, stampando i valori degli indici e
+degli elementi. Inoltre, dopo aver trovato, tramite l'indice, l'elemento
+che si vorrebbe eliminare, la funzione imposta il @dfn{bit}
address@hidden nel campo @code{flags}
+dell'elemento. Quando il vettore @`e stato interamente percorso,
@command{gawk}
+visita il vettore appiattito, ed elimina ogni elemento in cui il relativo
address@hidden della flag sia impostato:
+
address@hidden
+ for (i = 0; i < flat_array->count; i++) @{
+ printf("\t%s[\"%.*s\"] = %s\n",
+ name,
+ (int) flat_array->elements[i].index.str_value.len,
+ flat_array->elements[i].index.str_value.str,
+ valrep2str(& flat_array->elements[i].valore));
+
+ if (strcmp(valore3.str_value.str,
+ flat_array->elements[i].index.str_value.str) == 0) @{
+ flat_array->elements[i].flags |= AWK_ELEMENT_DELETE;
+ printf("dump_array_and_delete: ho marcato l'elemento \"%s\" "
+ "per eliminazione\n",
+ flat_array->elements[i].index.str_value.str);
+ @}
+ @}
address@hidden example
+
+Il sesto passo @`e liberare il vettore appiattito. Questo segnala a
address@hidden che l'estensione non sta address@hidden usando il vettore,
+e che dovrebbe eliminare gli elementi marcati per l'eliminazione.
address@hidden libera anche ogni area di memoria che era stata allocata,
+e quindi non si dovrebbe address@hidden usare il puntatore (@code{flat_array}
in
+questo codice) dopo aver chiamato @code{release_flattened_array()}:
+
address@hidden
+ if (! release_flattened_array(valore2.array_cookie, flat_array)) @{
+ printf("dump_array_and_delete: non riesco a liberare \
+il vettore appiattito\n");
+ goto out;
+ @}
address@hidden example
+
+Infine, poich@'e tutto @`e andato bene, la funzione imposta il codice di
ritorno
+a "successo", e lo restituisce quando esce:
+
address@hidden
+ make_number(1.0, risultato);
+out:
+ return risultato;
address@hidden
address@hidden example
+
+Ecco l'output ottenuto eseguendo questa parte del test:
+
address@hidden
+pets ha 5 elementi
+dump_array_and_delete: sym_lookup di pets effettuato
+dump_array_and_delete: il vettore in input ha 5 elementi
+ pets["1"] = "blacky"
+ pets["2"] = "rusty"
+ pets["3"] = "sophie"
+dump_array_and_delete: ho marcato l'elemento "3" per eliminazione
+ pets["4"] = "raincloud"
+ pets["5"] = "lucky"
+dump_array_and_delete(pets) ha restituito 1
+dump_array_and_delete() ha rimosso l'indice "3"!
address@hidden example
+
address@hidden Creazione di vettori
address@hidden Come creare e popolare vettori
+
+Oltre a lavorare con vettori creati da codice @command{awk}, si possono
+creare vettori a cui aggiungere elementi secondo le esigenze, che poi
+il codice @command{awk} address@hidden utilizzare e manipolare.
+
+Ci sono due punti importanti da tener presente quando di creano vettori dal
+codice di un'estensione:
+
address@hidden @value{BULLET}
address@hidden
+Il vettore appena creato deve essere subito messo nella Tabella dei simboli di
address@hidden Solo dopo aver fatto questo @`e possibile aggiungere elementi
+al vettore.
+
address@hidden
+Strictly speaking, this is required only
+for arrays that will have subarrays as elements; however it is
+a good idea to always do this. This restriction may be relaxed
+in a subsequent revision of the API.
address@hidden ignore
+
+Analogamente, se si installa un nuovo vettore come sottovettore di
+un vettore address@hidden esistente,
+occorre prima aggiungere il nuovo vettore al suo "genitore" per poter poi
+aggiungere degli elementi allo stesso.
+
+Quindi, il modo giusto per costruire un vettore @`e di lavorare ``dall'alto
+verso il basso''. Creare il vettore, e subito aggiungerlo alla Tabella dei
+simboli di @command{gawk} usando @code{sym_update()}, o installarlo come
+elemento in un vettore address@hidden esistente usando
@code{set_array_element()}.
+Un esempio di codice @`e fornito address@hidden sotto.
+
address@hidden
+Per come funziona internamente @command{gawk}, dopo aver usato
address@hidden()} per definire un vettore
+in @command{gawk}, si deve innanzitutto ricuperare il @dfn{cookie}
+del vettore dal valore passato a @command{sym_update()}, in questo modo:
+
address@hidden
+awk_value_t val;
+awk_array_t new_array;
+
+new_array = create_array();
+val.val_type = AWK_ARRAY;
+val.array_cookie = new_array;
+
+/* aggiunge il vettore alla Tabella dei simboli */
+sym_update("array", & val);
+
+new_array = val.array_cookie; /* QUESTO @`E OBBLIGATORIO */
address@hidden example
+
+Se si sta installando un vettore come sottovettore, occorre anche
+ricuperare il @dfn{cookie} del vettore dopo aver chiamato @code{set_element()}.
address@hidden itemize
+
+Il seguente codice C @`e una semplice estensione di test per creare un vettore
+con due elementi normali e con un sottovettore. Le direttive iniziali
address@hidden e le solite dichiarazione di variabili sono state omesse per
+amor di address@hidden
+(@pxref{Codice predefinito di un'estensione API}).
+Il primo passo @`e creare un nuovo vettore e poi aggiungerlo alla
+Tabella dei simboli:
+
address@hidden
address@hidden
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <stdio.h>
+#include <assert.h>
+#include <errno.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+
+#include <sys/types.h>
+#include <sys/stat.h>
+
+#include "gawkapi.h"
+
+static const gawk_api_t *api; /* per far funzionare le macro di
address@hidden */
+static awk_ext_id_t *ext_id;
+static const char *ext_version = "testarray extension: version 1.0";
+
+int plugin_is_GPL_compatible;
+
address@hidden ignore
+/* create_new_array --- creare un vettore denominato */
+
+static void
+create_new_array()
address@hidden
+ awk_array_t a_cookie;
+ awk_array_t sottovettore;
+ awk_value_t index, valore;
+
+ a_cookie = create_array();
+ valore.val_type = AWK_array;
+ valore.array_cookie = a_cookie;
+
+ if (! sym_update("new_array", & value))
+ printf("create_new_array: sym_update(\"nuovo_vettore\") \
+non riuscito!\n");
+ a_cookie = valore.array_cookie;
address@hidden example
+
address@hidden
+Si noti come @code{a_cookie} @`e reimpostato dal campo @code{array_cookie}
+nella struttura @code{valore}.
+
+Il secondo passo aggiunge due elementi normali a @code{nuovo_vettore}:
+
address@hidden
+ (void) make_const_string("salve", 5, & index);
+ (void) make_const_string("mondo", 5, & value);
+ if (! set_array_element(a_cookie, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
+
+ (void) make_const_string("risposta", 8, & index);
+ (void) make_number(42.0, & value);
+ if (! set_array_element(a_cookie, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
address@hidden example
+
+Il terzo passo @`e creare il sottovettore e aggiungerlo al vettore:
+
address@hidden
+ (void) make_const_string("sottovettore", 12, & index);
+ sottovettore = create_array();
+ valore.val_type = AWK_array;
+ valore.array_cookie = subarray;
+ if (! set_array_element(a_cookie, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
+ sottovettore = valore.array_cookie;
address@hidden example
+
+Il passo finale @`e di aggiungere al sottovettore un suo proprio elemento:
+
address@hidden
+ (void) make_const_string("pippo", 5, & index);
+ (void) make_const_string("pluto", 5, & value);
+ if (! set_array_element(sottovettore, & index, & value)) @{
+ printf("fill_in_array: set_array_element non riuscito\n");
+ return;
+ @}
address@hidden
address@hidden
+static awk_ext_func_t func_table[] = @{
+ @{ NULL, NULL, 0 @}
address@hidden;
+
+/* init_testarray --- funzione ulteriore di inizializzazione */
+
+static awk_bool_t init_testarray(void)
address@hidden
+ create_new_array();
+
+ return awk_true;
address@hidden
+
+static awk_bool_t (*init_func)(void) = init_testarray;
+
+dl_load_func(func_table, testarray, "")
address@hidden ignore
address@hidden example
+
+Ecco uno script di esempio che carica l'estensione
+e quindi stampa il valore di tutti gli elementi del vettore,
+invocando nuovamente se stessa nel caso che un particolare
+elemento sia a sua volta un vettore:
+
address@hidden
+@@load "subarray"
+
+function dumparray(name, vettore, i)
address@hidden
+ for (i in vettore)
+ if (isarray(vettore[i]))
+ dumparray(name "[\"" i "\"]", vettore[i])
+ else
+ printf("%s[\"%s\"] = %s\n", name, i, vettore[i])
address@hidden
+
+BEGIN @{
+ dumparray("new_array", new_array);
address@hidden
address@hidden example
+
+Ecco il risultato dell'esecuzione dello script:
+
address@hidden
+$ @kbd{AWKLIBPATH=$PWD ./gawk -f subarray.awk}
address@hidden new_array["sottovettore"]["pippo"] = pluto
address@hidden new_array["salve"] = mondo
address@hidden new_array["risposta"] = 42
address@hidden example
+
address@hidden
+(@xref{Trovare le estensioni} per ulteriori dettagli sulla
+variabile d'ambiente @env{AWKLIBPATH}.)
+
address@hidden Ridirezione API
address@hidden Accedere alle ridirezioni e modificarle
+
+La seguente funzione consente alle estensioni di accedere e di manipolare
+delle ridirezioni.
+
address@hidden @code
address@hidden awk_bool_t get_file(const char *name,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ size_t name_len,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const char *tipofile,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ int fd,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const awk_input_buf_t
**ibufp,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const awk_output_buf_t
**obufp);
+Ricerca il file @code{name} nella tabella interna di ridirezione di
address@hidden
+Se @code{name} @`e @code{NULL} o @code{name_len} @`e zero, restituisce
+i dati del file in input correntemente aperto il cui nome @`e memorizzato in
address@hidden
+(Questa chiamata non usa l'argomento @code{filetype}, che, quindi,
address@hidden essere
+lasciato indefinito).
+Se il file non @`e address@hidden aperto, tenta di aprirlo.
+L'argomento @code{filetype} deve terminare con uno zero binario, e dovrebbe
+dovrebbe avere uno di questi valori:
+
address@hidden @code
address@hidden ">"
+Un file aperto in output.
+
address@hidden ">>"
+Un file aperto in output, record aggiunti a fine file,
+dopo quelli address@hidden esistenti address@hidden
+
address@hidden "<"
+Un file aperto in input.
+
address@hidden "|>"
+Una @dfn{pipe} aperta in output.
+
address@hidden "|<"
+Una @dfn{pipe} aperta in input.
+
address@hidden "|&"
+Un coprocesso bidirezionale.
address@hidden table
+
+In caso di errore, restituisce il valore @address@hidden
+Altrimenti, restituisce
address@hidden@dfn{awk_true}}, insieme a ulteriori informazioni sulla
ridirezione
+nei puntatori @code{ibufp} e @code{obufp}.
+Per ridirezioni di input il valore @code{*ibufp} non dovrebbe essere
address@hidden, mentre @code{*obufp} dovrebbe essere @code{NULL}.
+Per ridirezioni di output,
+il valore di @code{*obufp} non dovrebbe essere @code{NULL}, e @code{*ibufp}
+dovrebbe essere @code{NULL}. Per coprocessi bidirezionali, nessuno dei due
+valori dovrebbe essere @code{NULL}.
+
+Normalmente, l'estensione @`e interessata a @code{(*ibufp)->fd}
+e/o @code{fileno((*obufp)->fp)}. Se il file non @`e address@hidden
+aperto, e l'argomento @code{fd} non @`e negativo, @command{gawk}
address@hidden quel descrittore di file invece di aprire il file nella
+maniera solita. Se l'@code{fd} non @`e negativo, ma il file esiste
address@hidden,
address@hidden ignora l'@code{fd} e restituisce il file esistente. @`E
address@hidden del chiamante notare che n@'e l'@code{fd} nella struttura
+restituita @code{awk_input_buf_t}, n@'e l'@code{fd} nella struttura restituita
address@hidden contiene il valore richiesto.
+
+Si noti che fornire un descrittore di file @emph{non} @`e al momento supportato
+per le @dfn{pipe}. Tuttavia, l'utilizzo di un descrittore di file
+dovrebbe essere possibile per @dfn{socket} in input, output,
+aggiunta-a-fine-file (append), e bidirezionale (coprocessi).
+Se @code{filetype} @`e bidirezionale, @command{gawk} presuppone che sia un
address@hidden Si noti che nel caso
+bidirezionale i descrittori di file in input e output possono essere
+differenti.
+Per essere sicuri che tutto sia andato bene, si deve controllare che uno dei
due
+corrisponda alla richiesta.
address@hidden table
+
+Si prevede che questa funzione API address@hidden usata per parallelizzare
l'I/O
+e rendere disponibile una libreria per i @dfn{socket}.
+
address@hidden Variabili dell'estensione API
address@hidden Variabili fornite dall'API
+
+L'API fornisce due insiemi di variabili. Il primo insieme contiene
+informazioni sulla versione dell'API (sia la versione dell'estensione
+compilata, che quella di @command{gawk}). Il secondo
+insieme contiene informazioni su come @command{gawk} @`e stato invocato.
+
address@hidden
+* Versione dell'estensione:: Informazioni sulla versione API.
+* Variabili informative di estens. API:: Variabili che forniscono informationi
+ sull'invocazione di @command{gawk}.
address@hidden menu
+
address@hidden Versione dell'estensione
address@hidden Costanti e variabili della versione dell'API
address@hidden API, versione
address@hidden versione dell'estensione API @command{gawk}
address@hidden estensione @command{gawk}, versione API
+
+L'API fornisce sia un numero di versione ``principale'' che uno ``secondario''.
+Le versioni dell'API sono disponibili al momento della compilazione, come
+definizioni per il preprocessore C, a supporto della compilazione
+condizionale, e come elencazione di costanti per facilitare il debug:
+
address@hidden Tabella,gawk-api-version
address@hidden delle versioni API gawk}
address@hidden address@hidden Version}} address@hidden address@hidden
address@hidden versione API @tab Definiz. Preprocessore C @tab Costante di
elenco
address@hidden Major @tab @code{gawk_api_major_version} @tab
@code{GAWK_API_MAJOR_VERSION}
address@hidden Minor @tab @code{gawk_api_minor_version} @tab
@code{GAWK_API_MINOR_VERSION}
address@hidden multitable
address@hidden float
+
+La versione secondaria aumenta quando nuove funzioni sono aggiunte all'API.
+Tali nuove funzioni sono sempre aggiunte alla fine della @code{struct}
dell'API.
+
+La versione principale aumenta (e la versione secondaria torna a zero) se
+qualche tipo di dati cambia dimensione o si modifica l'ordine dei campi, o se
+qualcuna delle funzioni esistenti cambia il livello di versione.
+
address@hidden capitare che un'estensione sia stata compilata con una versione
+dell'API ma caricata da una versione di @command{gawk} che ne usa una
+differente. Per questo motivo, la versione principale e quella secondaria
+dell'API della versione in uso di @command{gawk} sono incluse nella
address@hidden dell'API come costanti intere in sola lettura:
+
address@hidden @code
address@hidden api->major_version
+La versione principale di @command{gawk} in esecuzione.
+
address@hidden api->minor_version
+La versione secondaria di @command{gawk} in esecuzione.
address@hidden table
+
+Dipende dall'estensione decidere se ci sono address@hidden con l'API.
+Tipicamente, basta un controllo di questo tipo:
+
address@hidden
+if (api->major_version != GAWK_API_MAJOR_VERSION
+ || api->minor_version < GAWK_API_MINOR_VERSION) @{
+ fprintf(stderr, "estensione_pippo: discordanza di versione \
+con gawk!\n");
+ fprintf(stderr, "\tLa mia versione (%d, %d), versione gawk \
+(%d, %d)\n",
+ GAWK_API_MAJOR_VERSION, GAWK_API_MINOR_VERSION,
+ api->major_version, api->minor_version);
+ exit(1);
address@hidden
address@hidden example
+
+Questo codice @`e incluso nella macro generica @code{dl_load_func()}
+presente in @file{gawkapi.h} (trattata
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden predefinito di un'estensione API}).
+
address@hidden Variabili informative di estens. API
address@hidden Variabili informative
address@hidden API, variabili informative dell'estensione
address@hidden variabili informative dell'API
address@hidden estensione API, variabili informative
+
+L'API fornisce accesso a parecchie variabili che descrivono
+se le opzioni della riga di comando corrispondenti sono state specificate
+quando @command{gawk} @`e stato chiamato. Le variabili sono:
+
address@hidden @code
address@hidden do_debug
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--debug}.
+
address@hidden do_lint
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--lint}.
+
address@hidden do_mpfr
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--bignum}.
+
address@hidden do_profile
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--profile}.
+
address@hidden do_sandbox
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--sandbox}.
+
address@hidden do_traditional
+Questa variabile @`e @dfn{true} se @command{gawk} @`e stato invocato con
l'opzione @option{--traditional}.
address@hidden table
+
+Il valore di @code{do_lint} address@hidden cambiare se il codice @command{awk}
+modifica la variabile predefinita @code{LINT} (@pxref{Variabili predefinite}).
+Gli altri valori non dovrebbero cambiare durante l'esecuzione.
+
address@hidden Codice predefinito di un'estensione API
address@hidden Codice predefinito di interfaccia API
+
+Come address@hidden detto (@pxref{Panoramica sul meccanismo delle estensioni}),
+le definizioni di funzioni qui presentate sono in address@hidden delle macro.
+Per usare queste macro, l'estensione deve fornire una piccola address@hidden di
+codice predefinito (variabili e
+funzioni) nella parte iniziale del file sorgente, usando dei nomi
+standard, come descritto qui sotto. Il codice predefinito in questione @`e
+anche descritto nel file di intestazione @file{gawkapi.h}:
+
address@hidden
+/* Codice predefinito: */
+int plugin_is_GPL_compatible;
+
+static gawk_api_t *const api;
+static awk_ext_id_t ext_id;
+static const char *ext_version = NULL; /* o @dots{} = "qualche stringa" */
+
+static awk_ext_func_t func_table[] = @{
+ @{ "name", do_name, 1, 0, awk_false, NULL @},
+ /* @dots{} */
address@hidden;
+
+/* O: */
+
+static awk_bool_t (*init_func)(void) = NULL;
+
+/* OPPURE: */
+
+static awk_bool_t
+init_mia_estensione(void)
address@hidden
+ @dots{}
address@hidden
+
+static awk_bool_t (*init_func)(void) = init_mia_estensione;
+
+dl_load_func(func_table, qualche_nome, "name_space_in_quotes")
address@hidden example
+
+Queste variabili e funzioni sono:
+
address@hidden @code
address@hidden int plugin_is_GPL_compatible;
+Qui si dichiara che l'estensione @`e compatibile con
address@hidden FOR_PRINT
+la licenza GNU GPL (@pxref{Copia}).
+
address@hidden ifclear
address@hidden FOR_PRINT
+la licenza GNU GPL.
address@hidden ifset
+Se l'estensione non ha questa variabile, non address@hidden caricata da
@command{gawk}
+(@pxref{Licenza delle estensioni}).
+
address@hidden static gawk_api_t *const api;
+Questa variabile globale @code{static} dovrebbe essere impostata per
+puntare al puntatore
address@hidden che @command{gawk} passa alla funzione (dell'estensione)
address@hidden()}. Questa variabile @`e usata da tutte le macro.
+
address@hidden static awk_ext_id_t ext_id;
+Questa variabile globale @code{static} dovrebbe essere impostata al valore
address@hidden che @command{gawk} passa alla funzione @code{dl_load()}.
+Questa variabile @`e usata da tutte le macro.
+
address@hidden static const char *ext_version = NULL; /* o @dots{} = "qualche
stringa" */
+Questa variabile globale @code{static} dovrebbe essere impostata
+a @code{NULL} oppure puntare a una stringa che contiene il nome e la
+versione dell'estensione.
+
address@hidden static awk_ext_func_t func_table[] = @{ @dots{} @};
+Questo @`e un vettore di una o address@hidden strutture @code{awk_ext_func_t},
+come descritto in precedenza (@pxref{Funzioni di estensione}).
address@hidden essere usato in seguito per address@hidden chiamate a
address@hidden()}.
+
address@hidden Use @var{OR} for docbook
address@hidden static awk_bool_t (*init_func)(void) = NULL;
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @var{OR}
address@hidden static awk_bool_t init_mia_estensione(void) @{ @dots{} @}
address@hidden static awk_bool_t (*init_func)(void) = init_mia_estensione;
+Se qualche lavoro di inizializzazione @`e necessario, si dovrebbe definire una
+funzione all'uopo (crea variabili, apre file, etc.)
+e poi definire il puntatore @code{init_func} che punti alla funzione
+stessa.
+La funzione dovrebbe restituire @address@hidden se non va a buon fine
+o @code{awktrue} se tutto va bene.
+
+Se un'inizializzazione non @`e necessaria, si definisca il puntatore e
+lo si inizializzi a @code{NULL}.
+
address@hidden dl_load_func(func_table, qualche_nome,
"nome_spazio_tra_doppi_apici")
+Questa macro genera una funzione @code{dl_load()} che address@hidden
+tutte le inizializzazioni necessarie.
address@hidden table
+
+Lo scopo di tutte le variabili e dei vettori @`e di far
address@hidden@dotless{i}} che la
+funzione @code{dl_load()} (richiamata dalla macro @code{dl_load_func()})
+faccia tutto il lavoro standard necessario, qui descritto:
+
address@hidden 1
address@hidden
+Controlla le versioni dell'API. Se la versione principale dell'estensione
+non corrisponde a quella di @command{gawk} o se la versione secondaria
+dell'estensione @`e maggiore di quella di @command{gawk}, stampa un messaggio
+di errore fatale ed esce.
+
address@hidden
+Carica le funzioni definite in @code{func_table}.
+Se qualche caricamento non riesce, stampa un messaggio di
+avvertimento ma continua l'esecuzione.
+
address@hidden
+Se il puntatore @code{init_func} non @`e @code{NULL}, chiama la
+funzione da esso puntata. Se questa restituisce @code{awk_false}, stampa un
+messaggio di avvertimento.
+
address@hidden
+Se @code{ext_version} non @`e @code{NULL}, registra la
+stringa di versione con @command{gawk}.
address@hidden enumerate
+
address@hidden Modifiche dalla versione API 1
address@hidden Modifiche dalla versione 1 dell'API
+
+La versione API corrente @emph{non} @`e compatibile a livello binario con la
+versione 1 dell'API.
+Le funzioni di estensione vanno ricompilate per poterle usare con la versione
+corrente di @command{gawk}.
+
+Fortunatamente, fatti salvi alcuni possibili avvertimenti a livello di
+compilazione, l'API rimane compatibile a livello di codice sorgente con la
+precedente versione API. Le differenze address@hidden rilevanti sono gli
ulteriori
+campi nella struttura @code{awk_ext_func_t}, e l'aggiunta del terzo argomento
+nella funzione di implementazione in linguaggio C.
+
address@hidden Trovare le estensioni
address@hidden Come @command{gawk} trova le estensioni compilate
address@hidden estensioni, percorso di ricerca per
address@hidden estensioni, come trovarle
address@hidden trovare le estensioni
address@hidden percorso di ricerca per estensioni
+
+Le estensioni compilate vanno installate in una directory dove
address@hidden possa trovarle. Se @command{gawk} @`e configurato e
+installato nella maniera di default, la directory dove trovare le
+estensioni @`e @file{/usr/local/lib/gawk}. Si address@hidden anche
specificare un
+percorso di ricerca contenente una lista di directory da esaminare per la
+ricerca di estensioni compilate.
address@hidden (Variabile)} per ulteriori dettagli.
+
address@hidden Esempio di estensione
address@hidden Esempio: alcune funzioni per i file
address@hidden estensione, esempio
address@hidden esempio di estensione
+
address@hidden
address@hidden qualunque posto vai, address@hidden tu sei.}
address@hidden Buckaroo Banzai
address@hidden quotation
+
address@hidden It's enough to show chdir and stat, no need for fts
+
+Due utili funzioni che non sono in @command{awk} sono @code{chdir()} (per
+permettere a un programma @command{awk} di cambiare directory di lavoro) e
address@hidden()}
+(per far address@hidden@dotless{i}} che un programma @command{awk} possa
raccogliere informazioni
+su un dato file).
+Per illustrare l'azione dell'API, questa @value{SECTION} fornisce
+queste funzioni a @command{gawk} in un'estensione.
+
address@hidden
+* Descrizione interna file:: Quello che le nuove funzioni faranno
+* Operazioni interne file:: Codice per gestire file all'interno
+* Usare operazioni interne file:: Come usare un'estensione esterna
address@hidden menu
+
address@hidden Descrizione interna file
address@hidden Usare @code{chdir()} e @code{stat()}
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden mostra come usare le nuove funzioni a
+livello di @command{awk} una volta che siano state integrate nell'interprete
+del programma @command{gawk} in esecuzione. Usare @code{chdir()} @`e molto
+semplice. Richiede un solo argomento, la nuova directory su cui
+posizionarsi:
+
address@hidden
+@@load "filefuncs"
address@hidden
+newdir = "/home/arnold/funstuff"
+ret = chdir(newdir)
+if (ret < 0) @{
+ printf("non riesco a passare a %s: %s\n", newdir, ERRNO) > "/dev/stderr"
+ exit 1
address@hidden
address@hidden
address@hidden example
+
+Il valore restituito @`e negativo se la chiamata a @code{chdir()} non @`e
riuscita,
+ed @code{ERRNO} (@pxref{Variabili predefinite}) @`e impostato a una stringa
+che descrive l'errore.
+
+Usare @code{stat()} @`e un po' address@hidden complicato. La funzione scritta
in C
address@hidden()} riempie una struttura che ha una certa address@hidden di
informazioni.
+La maniera corretta per immagazzinarle in @command{awk} @`e quella di riempire
+un vettore associativo con le informazioni appropriate:
+
address@hidden broke printf for page breaking
address@hidden
+file = "/home/arnold/.profile"
+ret = stat(file, fdata)
+if (ret < 0) @{
+ printf("non @`e stato possibile eseguire @command{stat} per %s: %s\n",
+ file, ERRNO) > "/dev/stderr"
+ exit 1
address@hidden
+printf("dimensione di %s @`e %d byte\n", file, fdata["size"])
address@hidden example
+
+La funzione @code{stat()} svuota sempre il vettore che contiene i dati,
+anche nel caso che la chiamata a @code{stat()} non riesca. I seguenti
+elementi vengono restituiti dalla funzione:
+
address@hidden @code
address@hidden "name"
+Il nome del file oggetto della chiamata a @code{stat()}.
+
address@hidden "dev"
address@hidden "ino"
+I numeri di @dfn{device} e di @dfn{inode}, rispettivamente.
+
address@hidden "mode"
+Il modo del file, in formato numerico. Questo include sia il tipo di file che
+i suoi permessi di accesso.
+
address@hidden "nlink"
+Il numero di collegamenti fisici del file (stesso file con diversi nomi).
+
address@hidden "uid"
address@hidden "gid"
+Gli identificativi di utente e di gruppo del possessore del file.
+
address@hidden "size"
+La dimensione in byte del file.
+
address@hidden "blocks"
+Il numero di blocchi su disco realmente occupati dal file. Questo
address@hidden non
+essere
+proporzionale alla dimensione del file se il file ha delle lacune
+[ossia se solo alcune parti del file esistono veramente, il resto
+non @`e ancora stato riempito].
+
address@hidden "atime"
address@hidden "mtime"
address@hidden "ctime"
+La data e ora dell'ultimo accesso, modifica, e aggiornamento dell'@dfn{inode},
+rispettivamente. Questi sono delle marcature temporali numeriche
+(misurate in secondi dal
+01 gennaio 1970), che possono essere formattate dalla funzione
address@hidden()}
+(@pxref{Funzioni di tempo}).
+
address@hidden "pmode"
+La address@hidden stampabile (``printable mode'') del file.
+Questo @`e una stringa che rappresenta
+il tipo del file e i permessi di accesso, come sono visualizzati da
address@hidden -l}---per esempio, @code{"drwxr-xr-x"}.
+
address@hidden "type"
+Una stringa stampabile che descrive il tipo di file. Il valore @`e uno dei
+seguenti:
+
address@hidden @code
address@hidden "blockdev"
address@hidden "chardev"
+Il file @`e un dispositico a blocchi o a caratteri (``file speciale'').
+
address@hidden
address@hidden "door"
+The file is a Solaris ``door'' (special file used for
+interprocess communications).
address@hidden ignore
+
address@hidden "directory"
+Il file @`e una directory.
+
address@hidden "fifo"
+Il file @`e una @dfn{pipe} denominata (nota anche come FIFO [First In First
+Out]).
+
address@hidden "file"
+Il file @`e un file normale.
+
address@hidden "@dfn{socket}"
+Il file @`e un @dfn{socket} @code{AF_UNIX} (``Unix domain'') nel
+filesystem.
+
address@hidden "symlink"
+Il file @`e un collegamento simbolico.
address@hidden table
+
address@hidden 5/2013: Thanks to Corinna Vinschen for this information.
address@hidden "devbsize"
+La dimensione di un blocco per l'elemento indicizzato da @code{"blocks"}.
+Questa informazione @`e derivata dalla costante @code{DEV_BSIZE}
+definita in @code{<sys/param.h>} nella maggior parte dei sistemi,
+o dalla costante @code{S_BLKSIZE} in @code{<sys/stat.h>} nei sistemi BSD.
+Per alcuni altri sistemi il valore si basa su una conoscenza @dfn{a priori}
+delle caratteristiche di un particolare sistema.
+Se non si riesce a determinare il valore, viene
+restituito quello di default, che @`e 512.
address@hidden table
+
+Possono essere presenti diversi altri elementi, a seconda del
+sistema operativo e del tipo di file.
+Si address@hidden controllarne la presenza dal programma @command{awk} per
mezzo
+dell'operatore @code{in}
+(@pxref{Visitare elementi}):
+
address@hidden @code
address@hidden "blksize"
+La dimensione preferita di un blocco per effettuare operazioni di I/O sul file.
+Questo campo non @`e presente nella struttura C @code{stat} di tutti i sistemi
+che rispettano lo standard POSIX.
+
address@hidden "linkval"
+Se il file @`e un collegamento simbolico, questo elemento @`e il nome del
+file puntato dal collegamento simbolico (address@hidden, il valore del
collegamento).
+
address@hidden "rdev"
address@hidden "major"
address@hidden "minor"
+Se il file @`e un dispositivo a blocchi o a caratteri, questi valori
+rappresentano il numero del dispositivo e, rispettivamente, le componenti
+principale e secondaria di quel numero.
address@hidden table
+
address@hidden Operazioni interne file
address@hidden Codice C per eseguire @code{chdir()} e @code{stat()}
+
+Questo @`e il codice C per queste address@hidden versione qui
+presentata @`e
+lievemente modificata per amor di address@hidden Si veda
@file{extension/filefuncs.c}
+nella distribuzione @command{gawk} per la versione completa.}
+
+Il file include alcuni file di intestazione standard, e poi il file di
+intestazione @file{gawkapi.h}, che fornisce le definizioni dell'API.
+A queste seguono le dichiarazioni di variabili, necessarie
+per usare le macro dell'API e il codice predefinito
+(@pxref{Codice predefinito di un'estensione API}):
+
address@hidden
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <stdio.h>
+#include <assert.h>
+#include <errno.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+
+#include <sys/types.h>
+#include <sys/stat.h>
+
+#include "gawkapi.h"
+
+#include "gettext.h"
+#define _(msgid) gettext(msgid)
+#define N_(msgid) msgid
+
+#include "gawkfts.h"
+#include "stack.h"
+
+static const gawk_api_t *api; /* per consentire il funzionamento
+ delle macro di address@hidden */
+static awk_ext_id_t *ext_id;
+static awk_bool_t init_filefuncs(void);
+static awk_bool_t (*init_func)(void) = init_filefuncs;
+static const char *ext_version = "filefuncs extension: version 1.0";
+
+int plugin_is_GPL_compatible;
address@hidden example
+
address@hidden programmazione, convenzioni di, estensioni @command{gawk}
address@hidden estensioni @command{gawk}, convenzioni di programmazione
+Per convenzione, per una funzione @command{awk} di nome @code{pippo()},
+la funzione C che la implementa @`e chiamata @code{do_pippo()}. La funzione
+dovrebbe avere due argomenti. Il primo @`e un numero @code{int}, chiamato
address@hidden, che rappresenta il numero di argomenti passato alla funzione.
+Il secondo @`e un puntatore a una struttura @code{awk_value_t}, normalmente
+chiamata @code{risultato}:
+
address@hidden
+/* do_chdir --- fornisce funzione chdir()
+ caricata dinamicamente per gawk */
+
+static awk_value_t *
+do_chdir(int nargs, awk_value_t *risultato, struct awk_ext_func *non_usata)
address@hidden
+ awk_value_t newdir;
+ int ret = -1;
+
+ assert(risultato != NULL);
address@hidden example
+
+La variabile @code{newdir}
+rappresenta la nuova directory nella quale cambiare, che @`e ottenuta
+tramite la funzione @code{get_argument()}. Si noti che il primo argomento @`e
+quello numero zero.
+
+Se l'argomento @`e stato trovato con successo, la funzione invoca la chiamata
di
+sistema @code{chdir()}. In caso contrario, se la @code{chdir()} non riesce,
+viene aggiornata la variabile @code{ERRNO}:
+
address@hidden
+ if (get_argument(0, AWK_STRING, & newdir)) @{
+ ret = chdir(newdir.str_value.str);
+ if (ret < 0)
+ update_ERRNO_int(errno);
+ @}
address@hidden example
+
+Infine, la funzione restituisce il codice di ritorno da @code{chdir} a
+livello di @command{awk}:
+
address@hidden
+ return make_number(ret, risultato);
address@hidden
address@hidden example
+
+L'estensione @code{stat()} @`e address@hidden impegnativa. Dapprima abbiamo
+una funzione che trasforma la stringa di autorizzazione numerica
+(@dfn{mode}) in una rappresentazione stampabile
+(p.es., il codice ottale @code{0644} diviene @samp{-rw-r--r--}). Questa
+parte @`e qui omessa per address@hidden
+
address@hidden
+/* format_mode --- trasforma il campo @dfn{mode} di @dfn{stat}
+ in qualcosa di leggibile */
+
+static char *
+format_mode(unsigned long fmode)
address@hidden
+ @dots{}
address@hidden
address@hidden example
+
+Viene poi una funzione per leggere dei collegamenti simbolici, anche questa
+omessa per address@hidden:
+
address@hidden
+/* read_symlink --- legge un collegamento simbolico in un buffer
+ allocato.
+ @dots{} */
+
+static char *
+read_symlink(const char *fname, size_t bufsize, ssize_t *linksize)
address@hidden
+ @dots{}
address@hidden
address@hidden example
+
+Due funzioni ausiliarie semplificano l'immissione di valori nel
+vettore che address@hidden il risultato della chiamata a @code{stat()}:
+
address@hidden
+/* array_set --- imposta un elemento di un vettore */
+
+static void
+array_set(awk_array_t vettore, const char *sub, awk_value_t *valore)
address@hidden
+ awk_value_t index;
+
+ set_array_element(vettore,
+ make_const_string(sub, strlen(sub), & index),
+ valore);
+
address@hidden
+
+/* array_set_numeric --- imposta un elemento di un vettore con un
+ numero */
+
+static void
+array_set_numeric(awk_array_t vettore, const char *sub, double num)
address@hidden
+ awk_value_t tmp;
+
+ array_set(vettore, sub, make_number(num, & tmp));
address@hidden
address@hidden example
+
+La seguente funzione fa il grosso del lavoro per riempire il vettore dei
+risultati @code{awk_array_t} con valori ottenuti
+da una @code{struct stat} valida. Questo lavoro @`e fatto in una funzione
+separata per supportare sia la funzione
address@hidden()} per @command{gawk}, che l'estensione @code{fts()},
+che @`e inclusa nello stesso file, ma non
+ @`e mostrata qui
+(@pxref{Esempio di estensione funzioni file}).
+
+La prima parte della funzione @`e la dichiarazione delle variabili,
+compresa una tabella per tradurre i tipi di file in stringhe:
+
address@hidden
+/* fill_stat_array --- fa il lavoro di riempire un
+ vettore con informazioni da stat */
+
+static int
+fill_stat_array(const char *name, awk_array_t vettore, struct stat *sbuf)
address@hidden
+ char *pmode; /* @dfn{mode} stampabile */
+ const char *type = "unknown";
+ awk_value_t tmp;
+ static struct ftype_map @{
+ unsigned int mask;
+ const char *type;
+ @} ftype_map[] = @{
+ @{ S_IFREG, "file" @},
+ @{ S_IFBLK, "blockdev" @},
+ @{ S_IFCHR, "chardev" @},
+ @{ S_IFDIR, "directory" @},
+#ifdef S_IFSOCK
+ @{ S_IFSOCK, "socket" @},
+#endif
+#ifdef S_IFIFO
+ @{ S_IFIFO, "fifo" @},
+#endif
+#ifdef S_IFLNK
+ @{ S_IFLNK, "symlink" @},
+#endif
+#ifdef S_IFDOOR /* Stranezza Solaris */
+ @{ S_IFDOOR, "door" @},
+#endif /* S_IFDOOR */
+ @};
+ int j, k;
address@hidden example
+
+Il vettore di destinazione @`e svuotato di elementi, e poi il codice riempie
+i vari elementi prendendoli dai valori presenti in @code{struct stat}:
address@hidden
+ /* svuota il vettore */
+ clear_array(vettore);
+
+ /* riempie il vettore */
+ array_set(vettore, "name", make_const_string(name, strlen(name),
+ & tmp));
+ array_set_numeric(vettore, "dev", sbuf->st_dev);
+ array_set_numeric(vettore, "ino", sbuf->st_ino);
+ array_set_numeric(vettore, "mode", sbuf->st_mode);
+ array_set_numeric(vettore, "nlink", sbuf->st_nlink);
+ array_set_numeric(vettore, "uid", sbuf->st_uid);
+ array_set_numeric(vettore, "gid", sbuf->st_gid);
+ array_set_numeric(vettore, "size", sbuf->st_size);
+ array_set_numeric(vettore, "blocks", sbuf->st_blocks);
+ array_set_numeric(vettore, "atime", sbuf->st_atime);
+ array_set_numeric(vettore, "mtime", sbuf->st_mtime);
+ array_set_numeric(vettore, "ctime", sbuf->st_ctime);
+
+ /* per dispositivi a blocchi o carattere, aggiunge rdev,
+ e il numero principale e secondario */
+ if (S_ISBLK(sbuf->st_mode) || S_ISCHR(sbuf->st_mode)) @{
+ array_set_numeric(vettore, "rdev", sbuf->st_rdev);
+ array_set_numeric(vettore, "major", major(sbuf->st_rdev));
+ array_set_numeric(vettore, "minor", minor(sbuf->st_rdev));
+ @}
address@hidden example
+
address@hidden
+L'ultima parte della funzione fa alcune aggiunte selettive
+al vettore di destinazione, a seconda che siano disponibili o no
+certi campi e/o il tipo del file. Viene poi restituito zero, per indicare che
+tutto @`e andato bene:
+
address@hidden
+#ifdef HAVE_STRUCT_STAT_ST_BLKSIZE
+ array_set_numeric(vettore, "blksize", sbuf->st_blksize);
+#endif /* HAVE_STRUCT_STAT_ST_BLKSIZE */
+
+ pmode = format_mode(sbuf->st_mode);
+ array_set(vettore, "pmode", make_const_string(pmode, strlen(pmode),
+ & tmp));
+
+ /* per collegamenti simbolici, si aggiunge un campo linkval */
+ if (S_ISLNK(sbuf->st_mode)) @{
+ char *buf;
+ ssize_t linksize;
+
+ if ((buf = read_symlink(name, sbuf->st_size,
+ & linksize)) != NULL)
+ array_set(vettore, "linkval",
+ make_malloced_string(buf, linksize, & tmp));
+ else
+ warning(ext_id, _("stat: non riesco a leggere il \
+collegamento simbolico `%s'"),
+ name);
+ @}
+
+ /* aggiunge il tipo di campo */
+ type = "unknown"; /* non dovrebbe succedere */
+ for (j = 0, k = sizeof(ftype_map)/sizeof(ftype_map[0]); j < k; j++) @{
+ if ((sbuf->st_mode & S_IFMT) == ftype_map[j].mask) @{
+ type = ftype_map[j].type;
+ break;
+ @}
+ @}
+
+ array_set(vettore, "type", make_const_string(type, strlen(type), & tmp));
+
+ return 0;
address@hidden
address@hidden example
+
+Del terzo argomento passato a @code{stat()} non si era ancora parlato.
+Questo argomento @`e facoltativo. Se presente, dice a @code{do_stat()} di
+usare la chiamata di sistema @code{stat()} invece della chiamata di sistema
address@hidden()}. Questo avviene attraverso un puntatore a funzione:
address@hidden
address@hidden @`e inizializzato per puntare a @code{lstat()} (invece che a
address@hidden()}) per ottenere le informazioni relative al file, nel caso che
+il file in questione sia un
+collegamento simbolico. Tuttavia, se il terzo argomento @`e specificato,
address@hidden viene modificato in modo da puntare a @code{stat()}.
+
+Ecco la funzione @code{do_stat()}, che inizia con la dichiarazione delle
+variabili e un controllo degli argomenti passati dal chiamante:
+
address@hidden
+/* do_stat --- fornisce una funzione stat() per gawk */
+
+static awk_value_t *
+do_stat(int nargs, awk_value_t *risultato, struct awk_ext_func *non_usata)
address@hidden
+ awk_value_t file_param, array_param;
+ char *name;
+ awk_array_t vettore;
+ int ret;
+ struct stat sbuf;
+ /* per default si usa lstat() */
+ int (*statfunc)(const char *path, struct stat *sbuf) = lstat;
+
+ assert(risultato != NULL);
address@hidden example
+
+A questo punto inizia l'elaborazione vera e propria. Per prima cosa, la
+funzione esamina gli argomenti.
+Poi, ottiene le informazioni relative al file. Se la funzione chiamata
+(@code{lstat()} o @code{stat()}) restituisce un errore, il codice imposta
address@hidden e torna al chiamante:
+
address@hidden
+ /* file @`e il primo argomento,
+ il vettore per contenere i risultati @`e il secondo */
+ if ( ! get_argument(0, AWK_STRING, & file_param)
+ || ! get_argument(1, AWK_ARRAY, & array_param)) @{
+ warning(ext_id, _("stat: parametri errati"));
+ return make_number(-1, risultato);
+ @}
+
+ if (nargs == 3) @{
+ statfunc = stat;
+ @}
+
+ name = file_param.str_value.str;
+ vettore = array_param.array_cookie;
+
+ /* svuota sempre il vettore all'inizio */
+ clear_array(vettore);
+
+ /* chiama stat per il file;
+ in caso di errore,
+ imposta ERRNO e ritorna */
+ ret = statfunc(name, & sbuf);
+ if (ret < 0) @{
+ update_ERRNO_int(errno);
+ return make_number(ret, risultato);
+ @}
address@hidden example
+
+Il lavoro noioso @`e svolto da @code{fill_stat_array()}, visto in
+precedenza. Alla fine, la funzione restituisce il codice di ritorno
+impostato da @code{fill_stat_array()}:
+
address@hidden
+ ret = fill_stat_array(name, vettore, & sbuf);
+
+ return make_number(ret, risultato);
address@hidden
address@hidden example
+
+Infine, @`e necessario fornire la ``colla'' che aggrega
+le nuove funzioni a @command{gawk}.
+
+L'estensione @code{filefuncs} comprende anche una funzione
address@hidden()}, qui omessa
+(@pxref{Esempio di estensione funzioni file}).
address@hidden anche prevista una funzione di
+inizializzazione:
+
address@hidden
+/* init_filefuncs --- routine di initializazione */
+
+static awk_bool_t
+init_filefuncs(void)
address@hidden
+ @dots{}
address@hidden
address@hidden example
+
+Siamo quasi alla fine. Serve un vettore di strutture @code{awk_ext_func_t}
+per caricare ogni funzione in @command{gawk}:
+
address@hidden
+static awk_ext_func_t func_table[] = @{
+ @{ "chdir", do_chdir, 1, 1, awk_false, NULL @},
+ @{ "stat", do_stat, 3, 2, awk_false, NULL @},
+ @dots{}
address@hidden;
address@hidden example
+
+Ogni estensione deve avere una routine di nome @code{dl_load()} per caricare
+tutto address@hidden che occorre caricare. La cosa address@hidden semplice
@`e di usare la macro
address@hidden()} in @code{gawkapi.h}:
+
address@hidden
+/* definizione della funzione dl_load()
+ usando la macro standard */
+
+dl_load_func(func_table, filefuncs, "")
address@hidden example
+
+Abbiamo finito!
+
address@hidden Usare operazioni interne file
address@hidden Integrare le estensioni
+
address@hidden @command{gawk}, aggiungere address@hidden a
address@hidden address@hidden, aggiungere a @command{gawk}
address@hidden aggiungere address@hidden a @command{gawk}
+Dopo aver scritto il codice, dev'essere possibile aggiungerlo in fase
+di esecuzione all'interprete @command{gawk}. Per prima cosa, il codice
+va compilato. Supponendo che le funzioni siano in
+un file di nome @file{filefuncs.c}, e che @var{idir} sia la posizione
+del file di intestazione @file{gawkapi.h},
+i seguenti address@hidden pratica, si potrebbe decidere di usare
+i comandi GNU Autotools (Automake, Autoconf, Libtool, e @command{gettext})
+per configurare e costruire le librerie necessarie. L'esposizione di come
address@hidden address@hidden essere fatto esula dal tema di questo
@value{DOCUMENT}.
address@hidden per i puntatori a siti Internet che permettono di accedere
+a questi strumenti.} creano una libreria condivisa GNU/Linux:
+
address@hidden
+$ @kbd{gcc -fPIC -shared -DHAVE_CONFIG_H -c -O -g address@hidden filefuncs.c}
+$ @kbd{gcc -o filefuncs.so -shared filefuncs.o}
address@hidden example
+
+Una volta creata la libreria, questa viene caricata usando la parola
+chiave @code{@@load}:
+
address@hidden
+# file testff.awk
+@@load "filefuncs"
+
+BEGIN @{
+ "pwd" | getline curdir # salva la directory corrente
+ close("pwd")
+
+ chdir("/tmp")
+ system("pwd") # verifica l'avvenuto cambio di directory
+ chdir(curdir) # torna indietro
+
+ print "Info per testff.awk"
+ ret = stat("testff.awk", data)
+ print "ret =", ret
+ for (i in data)
+ printf "data[\"%s\"] = %s\n", i, data[i]
+ print "testff.awk modified:",
+ strftime("%m %d %Y %H:%M:%S", data["mtime"])
+
+ print "\nInfo per JUNK"
+ ret = stat("JUNK", data)
+ print "ret =", ret
+ for (i in data)
+ printf "data[\"%s\"] = %s\n", i, data[i]
+ print "JUNK modified:", strftime("%m %d %Y %H:%M:%S", data["mtime"])
address@hidden
address@hidden example
+
+La variabile d'ambiente @env{AWKLIBPATH} dice a
address@hidden dove @`e possibile trovare le estensioni (@pxref{Trovare le
estensioni}).
+La variabile viene impostata alla directory corrente, e quindi viene eseguito
+il programma:
+
address@hidden
+$ @kbd{AWKLIBPATH=$PWD gawk -f testff.awk}
address@hidden /tmp
address@hidden Info per testff.awk
address@hidden ret = 0
address@hidden data["blksize"] = 4096
address@hidden data["devbsize"] = 512
address@hidden data["mtime"] = 1412004710
address@hidden data["mode"] = 33204
address@hidden data["type"] = file
address@hidden data["dev"] = 2053
address@hidden data["gid"] = 1000
address@hidden data["ino"] = 10358899
address@hidden data["ctime"] = 1412004710
address@hidden data["blocks"] = 8
address@hidden data["nlink"] = 1
address@hidden data["name"] = testff.awk
address@hidden data["atime"] = 1412004716
address@hidden data["pmode"] = -rw-rw-r--
address@hidden data["size"] = 666
address@hidden data["uid"] = 1000
address@hidden testff.awk modified: 09 29 2014 18:31:50
address@hidden
address@hidden Info per JUNK
address@hidden ret = -1
address@hidden JUNK modified: 01 01 1970 02:00:00
address@hidden example
+
address@hidden Esempi di estensione
address@hidden Le estensioni di esempio incluse nella distribuzione
@command{gawk}
address@hidden estensioni distribuite con @command{gawk}
+
+Questa @value{SECTION} fornisce una breve panoramica degli esempi di
+estensione inclusi nella distribuzione di @command{gawk}. Alcune di esse
+sono destinate per l'uso in produzione (p.es., le estensioni
address@hidden, @code{readdir}, e
address@hidden). Altre sono state scritte principalmente per mostrare come
+si usa l'estensione API.
+
address@hidden
+* Esempio di estensione funzioni file:: L'esempio che usa funzioni file.
+* Esempio di estensione Fnmatch:: Un'interfaccia a @code{fnmatch()}.
+* Esempio di estensione Fork:: Un'interfaccia a @code{fork()} e
+ altre funzioni di processo.
+* Esempio di estensione Inplace:: Consentire modifica diretta dei file.
+* Esempio di estensione Ord:: Conversioni a valore e a stringa di
+ caratteri.
+* Esempio di estensione Readdir:: Un'interfaccia a @code{readdir()}.
+* Esempio di estensione Revout:: Semplice post-processore per
+ invertire la stringa in output.
+* Esempio di estensione Rev2way:: Processore bidirezionale per
+ invertire la stringa in output.
+* Esempio di estensione Rwarray:: Serializzare il vettore in un
+ file.
+* Esempio di estensione Readfile:: Leggere un intero file in una stringa.
+* Esempio di estensione Time:: Un'interfaccia a @code{gettimeofday()}
+ e @code{sleep()}.
+* Esempio di estensione API Test:: Test per la API.
address@hidden menu
+
address@hidden Esempio di estensione funzioni file
address@hidden Funzioni relative ai file
+
+L'estensione @code{filefuncs} include tre funzioni diverse, come descritto
sotto.
+L'uso @`e il seguente:
+
address@hidden @asis
address@hidden @code{@@load "filefuncs"}
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{chdir()}, estensione
address@hidden estensione @code{chdir()}
address@hidden @code{risultato = chdir("/qualche/directory")}
+La funzione @code{chdir()} invoca a sua volta la chiamata di sistema
address@hidden()} per cambiare la directory corrente. Restituisce zero
+se tutto va bene o un valore minore di zero in caso di errore.
+In quest'ultimo caso, viene aggiornata la variabile @code{ERRNO}.
+
address@hidden @code{stat()}, estensione
address@hidden estensione @code{stat()}
address@hidden @code{risultato = stat("/qualche/percorso", statdata}
address@hidden, address@hidden)}
+La funzione @code{stat()} invoca a sua volta la chiamata di sistema
address@hidden()}.
+Restituisce zero se tutto va bene o un valore minore di zero in caso di
+errore.
+In quest'ultimo caso, viene aggiornata la variabile @code{ERRNO}.
+
+Per default, viene usata la chiamata di sistema @code{lstat()}.
+Tuttavia, se alla funzione viene passato un terzo argomento, questa invoca
+invece @code{stat()}.
+
+In tutti i casi, il vettore @code{statdata} viene preventivamente svuotato.
+Quando la chiamata a @code{stat()} riesce, viene riempito il vettore
address@hidden con le informazioni ottenute dal fileystem, come segue:
+
address@hidden @columnfractions .15 .50 .20
address@hidden Indice @tab Campo in @code{struct stat} @tab Tipo file
address@hidden @code{"name"} @tab Il @value{FN} @tab Tutti
address@hidden @code{"dev"} @tab @code{st_dev} @tab Tutti
address@hidden @code{"ino"} @tab @code{st_ino} @tab Tutti
address@hidden @code{"mode"} @tab @code{st_mode} @tab Tutti
address@hidden @code{"nlink"} @tab @code{st_nlink} @tab Tutti
address@hidden @code{"uid"} @tab @code{st_uid} @tab Tutti
address@hidden @code{"gid"} @tab @code{st_gid} @tab Tutti
address@hidden @code{"size"} @tab @code{st_size} @tab Tutti
address@hidden @code{"atime"} @tab @code{st_atime} @tab Tutti
address@hidden @code{"mtime"} @tab @code{st_mtime} @tab Tutti
address@hidden @code{"ctime"} @tab @code{st_ctime} @tab Tutti
address@hidden @code{"rdev"} @tab @code{st_rdev} @tab Dispositivi
address@hidden @code{"major"} @tab @code{st_major} @tab Dispositivi
address@hidden @code{"minor"} @tab @code{st_minor} @tab Dispositivi
address@hidden @code{"blksize"} @tab @code{st_blksize} @tab Tutti
address@hidden @code{"pmode"} @tab Una versione leggibile del valore
dell'autorizzazione,
+come quello stampato dal comando
address@hidden (per esempio, @code{"-rwxr-xr-x"}) @tab Tutti
address@hidden @code{"linkval"} @tab Il valore del collegamento simbolico @tab
+Collegamenti simbolici
address@hidden @code{"type"} @tab Il tipo del file in formato address@hidden
essere
address@hidden"file"},
address@hidden"blockdev"},
address@hidden"chardev"},
address@hidden"directory"},
address@hidden"socket"},
address@hidden"fifo"},
address@hidden"symlink"},
address@hidden"door"}
+o
address@hidden"unknown"}
+(non tutti i sistemi supportano tutti i tipi file) @tab Tutti
address@hidden multitable
+
address@hidden @code{fts()}, estensione
address@hidden estensione @code{fts()}
address@hidden @code{flags = or(FTS_PHYSICAL, ...)}
address@hidden @code{risultato = fts(pathlist, flags, filedata)}
+Percorre gli alberi di file elencati in @code{pathlist} e riempie il vettore
address@hidden, come descritto qui di seguito. @code{flags} @`e l'operazione
address@hidden @dfn{bit} a @dfn{bit} di parecchi valori predefiniti, pure
descritti
address@hidden sotto.
+Restituisce zero in assenza di errori, in caso contrario restituisce @minus{}1.
address@hidden table
+
+La funzione @code{fts()} invoca a sua volta la routine di libreria C
address@hidden()} per percorrere gerarchie di file. Invece di restituire i dati
+relativi ai file uno per volta in sequenza,
+riempie un vettore multidimensionale con i dati di ogni file e directory
+che risiedono nelle gerarchie richieste.
+
+Gli argomenti sono i seguenti:
+
address@hidden @code
address@hidden pathlist
+Un vettore di @value{FNS}. Sono usati i valori dei singoli elementi;
+gli indici che puntano a tali valori vengono ignorati.
+
address@hidden flags
+Questo dovrebbe essere l'@dfn{OR} @dfn{bit} a @dfn{bit} di uno o
address@hidden dei
+seguenti valori dei flag costanti predefiniti.
+Almeno uno dei due flag @code{FTS_LOGICAL}
+o @code{FTS_PHYSICAL} dev'essere impostato; in caso contrario
address@hidden()} restituisce una segnalazione di errore e imposta @code{ERRNO}.
+I flag sono:
+
address@hidden nested table
address@hidden @code
address@hidden FTS_LOGICAL
+Passa in rassegna i file in modo ``logico'', e quindi l'informazione restituita
+per un collegamento simbolico @`e quella relativa al file puntato, e non al
+collegamento simbolico stesso. Questo flag @`e mutuamente esclusivo con
address@hidden
+
address@hidden FTS_PHYSICAL
+Passa in rassegna i file in modo ``fisico'', e quindi l'informazione restituita
+per un collegamento simbolico @`e quella relativa al collegamento simbolico
+stesso. Questo flag @`e mutuamente esclusivo con @code{FTS_LOGICAL}.
+
address@hidden FTS_NOCHDIR
+Per migliorare le prestazioni, la routine di libreria C @code{fts()}
+cambia directory mentre percorre una gerarchia di file. Questo flag
+disabilita quell'ottimizzazione.
+
address@hidden FTS_COMFOLLOW
+Si accede al file puntato da un collegamento simbolico esistente in
@code{pathlist},
+anche se @code{FTS_LOGICAL} non @`e stato impostato.
+
address@hidden FTS_SEEDOT
+Per default, la routine di libreria C @code{fts()} non restituisce
+informazioni per i file
address@hidden"."} (punto) e @file{".."} (punto-punto). Quest'opzione richiede
+l'informazione anche per @file{".."}. (L'estensione ritorna sempre
+l'informazione per @file{"."}; maggiori dettagli address@hidden sotto.)
+
address@hidden FTS_XDEV
+Mentre si percorre un filesystem, non passare mai a un filesystem montato
+diverso da quello in cui si opera.
address@hidden address@hidden succedere nel caso di collegamenti simbolici, che
contengono un nome di file
address@hidden che si trova da tutt'altra parte
address@hidden lrwxrwxrwx 1 root root 6 ago 6 2015 /aca -> /d/aca
address@hidden /d/aca:
address@hidden /dev/sda6 115234344 15648380 93709280 15% /d
address@hidden / (e il collegamento simbolico /aca)
address@hidden /dev/sda1 37308224 13573368 21816644 39% /
address@hidden table
+
address@hidden filedata
+Il vettore @code{filedata} contiene i risultati.
+La funzione @code{fts()} lo svuota all'inizio. In seguito viene creato
+un elemento in @code{filedata} per ogni elemento in @code{pathlist}.
+L'indice @`e il nome della directory o del file specificato in @code{pathlist}.
+L'elemento puntato da questo indice @`e a sua volta un vettore. Ci sono due
+casi:
+
address@hidden nested table
address@hidden @emph
address@hidden Il percorso @`e un file
+In questo caso, il vettore contiene due o tre elementi:
+
address@hidden doubly nested table
address@hidden @code
address@hidden "path"
+Il percorso completo di questo file, a partire dalla directory radice
(``root'')
+indicata nel vettore @code{pathlist}.
+
address@hidden "stat"
+Questo elemento @`e esso stesso un vettore, contenente le stesse informazioni
+fornite dalla funzione @code{stat()} vista in precedenza a proposito del suo
+argomento
address@hidden L'elemento address@hidden non essere presente se la chiamata
+di sistema @code{stat()} per il file non @`e riuscita.
+
address@hidden "error"
+Se qualche tipo di errore si verifica durante l'elaborazione, il vettore
address@hidden anche un elemento con chiave @code{"error"}, che @`e una stringa
+che descrive l'errore.
address@hidden table
+
address@hidden Il percorso @`e una directory
+In questo caso, nel vettore viene creato un elemento per ogni elemento
+contenuto nella directory. Se un elemento della directory @`e un
+file, l'azione del programma @`e la stessa descritta sopra per un file.
+Se invece la directory contiene delle sottodirectory, l'elemento creato
+nel vettore @`e (ricorsivamente) a sua volta un vettore che descrive la
+sottodirectory. Se fra i flag @`e stato
+specificato il flag @code{FTS_SEEDOT},
+ci address@hidden anche un elemento di nome
address@hidden".."}. Questo elemento address@hidden un vettore contenente i
dati restituiti
+da un'invocazione di @code{stat()}.
+
+Inoltre, ci address@hidden un elemento il cui indice @`e @code{"."}.
+Questo elemento @`e un vettore contenente gli stessi due o tre elementi che
+sono messi a disposizione per un file: @code{"path"}, @code{"stat"},
+ed @code{"error"}.
address@hidden table
address@hidden table
+
+La funzione @code{fts()} restituisce zero in assenza di errori.
+in caso contrario, restituisce @minus{}1.
+
address@hidden NOTA
+L'estensione @code{fts()} non imita esattamente l'interfaccia fornita dalla
+routine di libreria C @code{fts()}, ma sceglie di fornire un'interfaccia
+basata sui vettori associativi, che @`e address@hidden adeguata per l'uso da
parte di un
+programma @command{awk}. Questo
+implica la mancanza di una funzione di
+confronto, poich@'e @command{gawk} address@hidden
+prevede la address@hidden di mettere facilmente nell'ordine desiderato gli
+elementi di un vettore.
+Anche se un'interfaccia modellata su @code{fts_read()} avrebbe potuto essere
+fornita, @`e sembrato address@hidden naturale mettere a disposizione un vettore
+multidimensionale, che rappresenta la gerarchia dei file e le informazioni
+relative a ognuno di essi.
address@hidden quotation
+
+Si veda il file @file{test/fts.awk} nella distribuzione di @command{gawk}
+per un esempio di uso dell'estensione @code{fts()}.
+
address@hidden Esempio di estensione Fnmatch
address@hidden Un'interfaccia a @code{fnmatch()}
+
+Quest'estensione fornisce un'interfaccia per utilizzare la funzione di
+libreria C @code{fnmatch()}. Si usa address@hidden@dotless{i}}:
+
address@hidden @code
address@hidden @@load "fnmatch"
address@hidden questo il modo per caricare l'estensione.
+
address@hidden @code{fnmatch()}, estensione
address@hidden estensione @code{fnmatch()}
address@hidden risultato = fnmatch(pattern, stringa, flags)
+Il valore restituito @`e zero se tutto va bene, oppure @code{FNM_NOMATCH}
+se la funzione non ha trovato alcuna corrispondenza, o
+un valore differente, diverso da zero, se si @`e verificato un errore.
address@hidden table
+
+Oltre a rendere disponibile la funzione @code{fnmatch()}, l'estensione
+di @code{fnmatch} definisce una costante (@code{FNM_NOMATCH}), e un vettore
+con dei valori di flag, di nome @code{FNM}.
+
+Gli argomenti per @code{fnmatch()} sono:
+
address@hidden @code
address@hidden pattern
+L'espressione regolare con cui confrontare @value{FN}
+
address@hidden stringa
+La stringa @value{FN}
+
address@hidden flags
address@hidden valere zero o essere l'@dfn{OR} @dfn{bit} a @dfn{bit} di uno o
address@hidden flag
+nel vettore @code{FNM}
address@hidden table
+
+I flag sono i seguenti:
+
address@hidden @columnfractions .40 .60
address@hidden Elemento del vettore @tab Flag corrispondente definito da
@code{fnmatch()}
address@hidden @code{FNM["CASEFOLD"]} @tab @code{FNM_CASEFOLD}
address@hidden @code{FNM["FILE_NAME"]} @tab @code{FNM_FILE_NAME}
address@hidden @code{FNM["LEADING_DIR"]} @tab @code{FNM_LEADING_DIR}
address@hidden @code{FNM["NOESCAPE"]} @tab @code{FNM_NOESCAPE}
address@hidden @code{FNM["PATHNAME"]} @tab @code{FNM_PATHNAME}
address@hidden @code{FNM["PERIOD"]} @tab @code{FNM_PERIOD}
address@hidden multitable
+
+Ecco un esempio:
+
address@hidden
+@@load "fnmatch"
address@hidden
+flags = or(FNM["PERIOD"], FNM["NOESCAPE"])
+if (fnmatch("*.a", "pippo.c", flags) == FNM_NOMATCH)
+ print "nessuna corrispondenza"
address@hidden example
+
address@hidden Esempio di estensione Fork
address@hidden Un'interfaccia a @code{fork()}, @code{wait()}, e @code{waitpid()}
+
+L'estensione @code{fork} mette a disposizione tre funzioni, come segue:
+
address@hidden @code
address@hidden @@load "fork"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{fork()}, estensione
address@hidden estensione @code{fork()}
address@hidden pid = fork()
+Questa funzione crea un nuovo processo. Il valore restituito @`e zero nel
+processo ``figlio'' e il numero che identifica il nuovo processo
+(@dfn{pid}) nel processo ``padre'', o @minus{}1
+in caso di errore. In quest'ultimo caso, @code{ERRNO} indica il problema.
+Nel processo figlio, gli elementi @code{PROCINFO["pid"]} e
address@hidden"ppid"]} vengono aggiornati per riflettere i valori corretti.
+
address@hidden @code{waitpid()}, estensione
address@hidden estensione @code{waitpid()}
address@hidden ret = waitpid(pid)
+Questa funzione ha un unico argomento numerico, l'identificativo del processo
+di cui aspettare l'esito. Il valore di ritorno @`e quello restituito dalla
+chiamata di sistema @code{waitpid()}.
+
address@hidden @code{wait()}, estensione
address@hidden estensione @code{wait()}
address@hidden ret = wait()
+Questa funzione attende che il primo processo ``figlio'' termini.
+Il valore restituito @`e quello della chiamata di sistema @code{wait()}.
address@hidden table
+
+Non c'@`e una funzione corrispondente alla chiamata di sistema @code{exec()}.
+
+Ecco un esempio:
+
address@hidden
+@@load "fork"
address@hidden
+if ((pid = fork()) == 0)
+ print "salve dal processo figlio"
+else
+ print "salve dal processo padre"
address@hidden example
+
address@hidden Esempio di estensione Inplace
address@hidden Consentire la modifica in loco dei file
+
address@hidden @code{inplace}, estensione
address@hidden estensione @code{inplace}
+L'estensione @code{inplace} svolge un lavoro simile a quello
+dell'opzione @option{-i} nel programma di address@hidden GNU @command{sed},
+che svolge delle funzioni di modifica ``al volo'' su ogni file in input.
+Viene usato il file @file{inplace.awk}, caricato dinamicamente, per richiamare
+l'estensione in maniera corretta:
+
address@hidden
address@hidden file eg/lib/inplace.awk
address@hidden
+# inplace --- carica e richiama l'estensione inplace.
+
+@@load "inplace"
+
+# @`E buona cosa impostare INPLACE_SUFFIX in modo da fare
+# una copia di backup.
+# Per esempio, si potrebbe impostare INPLACE_SUFFIX a .bak
+# sulla riga di comando, o in una regola BEGIN.
+
+# Per default, ogni file specificato sulla riga di comando
+# address@hidden modificato sovrascrivendo il file originale.
+# Ma @`e possibile evitarlo specificando l'argomento inplace=0
+# davanti al nome del file che non si desidera elaborare in questo modo.
+# Si address@hidden poi abilitare di nuovo l'aggiornamento diretto del file
+# sulla riga di comando, specificando inplace=1 prima del file
+# che si vuole modificare direttamente.
+
+# N.B. La funzione inplace_end() @`e invocata nelle regole
+# BEGINFILE ed END, in modo che ogni eventuale azione
+# in una regola ENDFILE address@hidden ridiretta come previsto.
+
+BEGIN @{
+ inplace = 1 # abilitato per default
address@hidden
+
+BEGINFILE @{
+ if (_inplace_filename != "")
+ inplace_end(_inplace_filename, INPLACE_SUFFIX)
+ if (inplace)
+ inplace_begin(_inplace_filename = FILENAME, INPLACE_SUFFIX)
+ else
+ _inplace_filename = ""
address@hidden
+
+END @{
+ if (_inplace_filename != "")
+ inplace_end(_inplace_filename, INPLACE_SUFFIX)
address@hidden
address@hidden group
address@hidden endfile
address@hidden example
+
+Per ogni file elaborato, l'estensione ridirige lo
+standard output verso un file temporaneo definito in modo da avere lo stesso
+proprietario e le stesse autorizzazioni del file originale. Dopo che il file
address@hidden stato elaborato, l'estensione riporta lo standard output alla sua
+destinazione originale.
+Se @code{INPLACE_SUFFIX} non @`e una stringa vuota, il file originale @`e
+collegato a un @value{FN} di backup, creato aggiungendo il
+suffisso al nome originale.
+Infine, il file temporaneo @`e rinominato in modo da essere lo stesso del
address@hidden originario.
+
+Si noti che l'uso di questa address@hidden address@hidden essere controllato
+specificando @samp{inplace=0} sulla riga di comando, prima del nome del file
+che non dovrebbe essere elaborato come appena descritto. Si address@hidden
richiedere
+ancora l'aggiornamento diretto di un file, specificando l'argomento
address@hidden davanti al nome del file da elaborare in maniera diretta.
+
+La variabile @code{_inplace_filename} serve per tener traccia del nome del
+file corrente, in modo da non eseguire la funzione @code{inplace_end()} prima
+di aver elaborato il primo file.
+
+Se si verifica un errore, l'estensione emette un messaggio di errore fatale
+per terminare l'elaborazione immediatamente, senza danneggiare il
+file originale.
+
+Ecco alcuni semplici esempi:
+
address@hidden
+$ @kbd{gawk -i inplace '@{ gsub(/pippo/, "pluto") @}; @{ print @}' file1 file2
file3}
address@hidden example
+
+Per mantenere una copia di backup del file originale, si provi a fare
address@hidden@dotless{i}}:
+
address@hidden
+$ @kbd{gawk -i inplace -v INPLACE_SUFFIX=.bak '@{ gsub(/pippo/, "pluto") @}}
+> @address@hidden print @}' file1 file2 file3}
address@hidden example
+
+Si noti che, anche se l'estensione tenta di mantenere il proprietario e i
+permessi di accesso del file originario, non viene tentata la copia degli
+ulteriori permessi di accesso
+(@dfn{ACL - Access Control Lists}) del file originale.
+
+Se il programma termina prima del previsto, come potrebbe succedere se riceve
+dal sistema un segnale non gestito, address@hidden lasciare come residuo un
file
+temporaneo.
+
address@hidden Esempio di estensione Ord
address@hidden Caratteri e valori numerici: @code{ord()} e @code{chr()}
+
+L'estensione @code{ordchr} aggiunge due funzioni, di nome
address@hidden()} e @code{chr()}, come segue:
+
address@hidden @code
address@hidden @@load "ordchr"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{ord()}, estensione
address@hidden estensione @code{Ord}
address@hidden numero = ord(stringa)
+Restituisce il valore numerico del primo carattere in @code{stringa}.
+
address@hidden @code{Chr}, estensione
address@hidden estensione @code{Chr}
address@hidden char = chr(number)
+Restituisce una stringa il cui primo carattere @`e quello rappresentato
+da @code{number}.
address@hidden table
+
+Queste funzioni sono ispirate alle funzioni del linguaggio Pascal
+dallo stesso nome. Ecco un esempio:
+
address@hidden
+@@load "ordchr"
address@hidden
+printf("Il valore numerico di 'A' @`e %d\n", ord("A"))
+printf("Il valore come stringa di 65 @`e %s\n", chr(65))
address@hidden example
+
address@hidden Esempio di estensione Readdir
address@hidden Leggere directory
+
+L'estensione @code{readdir} aggiunge un analizzatore di input
+per esaminare directory.
+L'uso @`e il seguente:
+
address@hidden @code{readdir}, estensione
address@hidden estensione @code{readdir}
address@hidden
+@@load "readdir"
address@hidden example
+
+Quando quest'estensione @`e in uso, invece che saltare le
+directory presenti sulla riga di comando, (o accedute tramite @code{getline}),
+queste sono lette, e ogni elemento della directory @`e restituito come
+un record.
+
+Il record consiste di tre campi. I primi due sono il numero di @dfn{inode} e
+il @value{FN}, separati fra loro da una barra.
+Nei sistemi in cui l'elemento di directory contiene il tipo del file,
+il record ha un terzo campo (pure separato da una barra), composto da una
+sola lettera, che indica il tipo del file. Le lettere e i tipi di file a cui
+corrispondono sono mostrate in @ref{table-readdir-file-types}.
+
address@hidden Tabella,table-readdir-file-types
address@hidden file restituiti dall'estensione @code{readdir}}
address@hidden @columnfractions .1 .9
address@hidden Lettera @tab Tipo di file
address@hidden @code{b} @tab Dispositivo a blocchi
address@hidden @code{c} @tab Dispositivo a caratteri
address@hidden @code{d} @tab Directory
address@hidden @code{f} @tab File normale
address@hidden @code{l} @tab Collegamento simbolico
address@hidden @code{p} @tab @dfn{pipe} con nome (FIFO)
address@hidden @code{s} @tab @dfn{socket}
address@hidden @code{u} @tab Tutto il resto (sconosciuto)
address@hidden multitable
address@hidden float
+
+Nei sistemi che non contengono l'informazione sul tipo del file, il terzo
+campo @`e sempre @samp{u}.
+
address@hidden NOTA
+Nei sistemi GNU/Linux, ci sono fileystem che non supportano il campo
address@hidden (si veda la pagina di manuale @i{readdir}(3)), e in questo caso
+il tipo di file @`e sempre @samp{u}. Si address@hidden usare l'estensione
address@hidden per chiamare @code{stat()} e ottenere l'informazione
+corretta sul tipo di file.
address@hidden quotation
+
+Ecco un esempio:
+
address@hidden
+@@load "readdir"
address@hidden
+BEGIN @{ FS = "/" @}
address@hidden print "@value{FN} @`e", $2 @}
address@hidden example
+
address@hidden Esempio di estensione Revout
address@hidden Invertire la stringa in output
+
+L'estensione @code{revoutput} aggiunge un semplice processore
+di output che inverte i caratteri di ogni riga in output. Serve a dimostrare
+come @`e possibile scrivere un processore di output, anche se address@hidden
essere
+a prima vista vagamente divertente.
+Ecco un esempio:
+
address@hidden @code{revoutput}, estensione
address@hidden estensione @code{revoutput}
address@hidden
+@@load "revoutput"
+
+BEGIN @{
+ REVOUT = 1
+ print "non v'allarmate" > "/dev/stdout"
address@hidden
address@hidden example
+
+L'output di questo programma @`e @samp{etamralla'v non}.
+
address@hidden Esempio di estensione Rev2way
address@hidden Esempio di I/O bidirezionale
+
+L'estensione @code{revtwoway} aggiunge un semplice processore
+bidirezionale che inverte i caratteri di ogni riga che riceve, per farla
+poi rileggere dal programma @command{awk}. Il motivo per cui @`e stata scritta
address@hidden quello di mostrare come si scrive un processore bidirezionale,
anche se address@hidden
+sembrare un programma vagamente divertente.
+Il seguente esempio mostra come usarlo:
+
address@hidden @code{revtwoway}, estensione
address@hidden estensione @code{revtwoway}
address@hidden
+@@load "revtwoway"
+
+BEGIN @{
+ cmd = "/specchio/magico"
+ print "non v'allarmate" |& cmd
+ cmd |& getline risultato
+ print risultato
+ close(cmd)
address@hidden
address@hidden example
+
+L'output di questo programma
address@hidden
+anche in questo caso @`e:
address@hidden ifnotinfo
address@hidden
address@hidden:
address@hidden ifinfo
address@hidden'v non}.
+
address@hidden Esempio di estensione Rwarray
address@hidden Scaricare e ricaricare un vettore
+
+L'estensione @code{rwarray} aggiunge due funzioni,
+di nome @code{writea()} e @code{reada()}, come segue:
+
address@hidden @code
address@hidden @@load "rwarray"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{writea()}, estensione
address@hidden estensione @code{writea()}
address@hidden ret = writea(file, vettore)
+Questa funzione ha come argomento una stringa, che @`e il nome del file
+sul quale scaricare il vettore, e il vettore stesso @`e il secondo argomento.
address@hidden()} @`e in grado di gestire vettori di vettori. Restituisce il
+valore uno se completa il lavoro o zero se non va a buon fine.
+
address@hidden @code{reada()}, estensione
address@hidden estensione @code{reada()}
address@hidden ret = reada(file, vettore)
address@hidden()} @`e la funzione inversa di @code{writea()};
+legge il file il cui nome @`e fornito come primo argomento, riempiendo 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.
address@hidden table
+
+Il vettore creato da @code{reada()} @`e identico a quello scritto da
address@hidden()} nel senso che i contenuti sono gli stessi. Tuttavia,
+per come @`e strutturata la funzione, l'ordine di attraversamento del vettore
+ricreato @`e quasi certamente differente da quello del vettore originale.
+Poich@'e l'ordine di attraversamento di un vettore @`e, per default, indefinito
+in @command{awk}, questo non @`e (tecnicamente) un problema. Se serve che
+l'attraversamento del vettore avvenga in un ordine preciso, si possono usare
+le address@hidden di ordinamento di un vettore disponibili in @command{gawk}
+(@pxref{Ordinamento di vettori}).
+
+Il file contiene dati in formato binario. Tutti i valori interi sono scritti
+in @dfn{network byte address@hidden@`e, nella maniera con cui sarebbero
+normalmente scritti in un testo, con le cifre address@hidden significative del
+numero contenute nella parte sinistra, e quelle meno significative
+nella parte destra della rappresentazione binaria del numero.}.
+Tuttavia, i valori in virgola mobile a doppia precisione sono scritti come
+dati binari nativi. Quindi, vettori che contengono solo dati in formato
+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.
+
+Ecco un esempio:
+
address@hidden
+@@load "rwarray"
address@hidden
+ret = writea("scaricato.bin", vettore)
address@hidden
+ret = reada("scaricato.bin", vettore)
address@hidden example
+
address@hidden Esempio di estensione Readfile
address@hidden Leggere un intero file in una stringa
+
+L'estensione @code{readfile} aggiunge una sola funzione
+di nome @code{readfile()}, e un analizzatore di input:
+
address@hidden @code
address@hidden @@load "readfile"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{readfile()}, estensione
address@hidden estensione @code{readfile()}
address@hidden risultato = readfile("/qualche/persorso")
+L'argomento @`e il nome del file da leggere. Il valore restituito @`e una
+stringa contenente l'intero contenuto del file richiesto. In caso di errore,
+la funzione restituisce la stringa vuota e imposta @code{ERRNO}.
+
address@hidden BEGIN @{ PROCINFO["readfile"] = 1 @}
+Inoltre, l'estensione aggiunge un analizzatore di input che @`e attivato se
+l'elemento @code{PROCINFO["readfile"]} esiste.
+Quando l'analizzatore @`e attivato, ogni file in input @`e restituito
interamente
+come @code{$0}.
+La variabile @code{RT} @`e impostata alla stringa nulla.
address@hidden table
+
+Ecco un esempio:
+
address@hidden
+@@load "readfile"
address@hidden
+contents = readfile("/percorso/del/file");
+if (contents == "" && ERRNO != "") @{
+ print("problema in lettura file", ERRNO) > "/dev/stderr"
+ ...
address@hidden
address@hidden example
+
address@hidden Esempio di estensione Time
address@hidden Funzioni dell'estensione time
+
+L'estensione @code{time} aggiunge due funzioni, di nome
address@hidden()} e @code{sleep()}, come segue:
+
address@hidden @code
address@hidden @@load "time"
+Questo @`e il modo per caricare l'estensione.
+
address@hidden @code{gettimeofday()}, estensione
address@hidden estensione @code{gettimeofday()}
address@hidden ora_corrente = gettimeofday()
+Restituisce il numero di secondi trascorsi dalle ore 00:00 del giorno
+01/01/1970 UTC come valore a virgola mobile.
+Se questa informazione non @`e disponibile nella piattaforma in uso,
+restituisce @minus{}1 e imposta @code{ERRNO}. Il valore fornito dovrebbe
+avere la precisione di una frazione di
+secondo, ma la precisione effettiva address@hidden variare a seconda della
+piattaforma.
+Se la chiamata di sistema standard C @code{gettimeofday()} @`e disponibile
+nella piattaforma in uso, questo @`e il valore restituito. In caso contrario,
+se si sta lavorando con MS-Windows, la chiamata di sistema @`e fatta a
address@hidden()}.
+
address@hidden @code{sleep()}, estensione
address@hidden estensione @code{sleep()}
address@hidden risultato = sleep(@var{secondi})
+Il programma @command{gawk} resta inattivo (dorme) per i @var{secondi}
+specificati. Se @var{secondi} ha un valore negativo,
+o la chiamata di sistema non riesce, restituisce @minus{}1 e imposta
@code{ERRNO}.
+In caso contrario, restituisce zero dopo aver lasciato trascorrere
+la address@hidden di tempo indicata.
+Si noti che @var{secondi} address@hidden essere un numero a virgola mobile
(non solo un
+numero intero).
+Dettagli di implementazione: a seconda della address@hidden nel sistema in uso,
+questa funzione tenta di usare @code{nanosleep()} o @code{select()} per
+ottenere il tempo di attesa richiesto.
address@hidden table
+
address@hidden Esempio di estensione API Test
address@hidden Test per la API
address@hidden @code{testext}, estensione
address@hidden estensione @code{testext}
+
+L'estensione @code{testext} controlla la address@hidden di
+parti dell'API delle estensioni che non sono utilizzate negli altri esempi.
+Il file @file{extension/testext.c}
+contiene sia il codice C per l'estensione che il codice @command{awk}
+(tra i commenti del codice C) per eseguire i test. L'ambiente di test
+estrae il codice sorgente @command{awk} ed esegue i test. Si veda il file
+sorgente per maggiori informazioni.
+
address@hidden gawkextlib
address@hidden Il progetto @code{gawkextlib}
address@hidden @code{gawkextlib}, estensioni
address@hidden estensioni, @code{gawkextlib}
address@hidden estensioni, dove trovarle
+
address@hidden @code{gawkextlib}, progetto
address@hidden progetto @code{gawkextlib}
+Il progetto @uref{http://sourceforge.net/projects/gawkextlib/,
@code{gawkextlib}}
+fornisce varie estensioni per @command{gawk}, compresa una per
+l'elaborazione dei file XML. Questa @`e un'evoluzione del progetto noto come
address@hidden (XML @command{gawk}).
+
+Al momento della stesura di questo testo, ci sono otto estensioni:
+
address@hidden @value{BULLET}
address@hidden
+Estensione @code{errno}
+
address@hidden
+Estensione GD graphics library
+
address@hidden
+Estensione libreria MPFR
+(fornisce l'accesso a varie funzioni MPFR non previste dal supporto nativo
+di MPFR disponibile in @command{gawk})
+
address@hidden
+Estensione PDF
+
address@hidden
+Estensione PostgreSQL
+
address@hidden
+Estensione Redis
+
address@hidden
+Estensione Select
+
address@hidden
+Estensione analizzatore XML, usando la libreria di analisi XML
address@hidden://expat.sourceforge.net, Expat}
address@hidden itemize
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
+Si address@hidden scaricare il codice del progetto @code{gawkextlib}
+usando il codice sorgente mantenuto tramite
address@hidden://git-scm.com, Git}.
+Il comando per farlo @`e il seguente:
+
address@hidden
+git clone git://git.code.sf.net/p/gawkextlib/code gawkextlib-code
address@hidden example
+
address@hidden Expat, libreria per analizzare XML
address@hidden XML, Expat, libreria per analizzare
+Per poter compilare e usare l'estensione XML, @`e necessario installare
+la libreria di analisi XML @uref{http://expat.sourceforge.net, Expat}.
+
+Inoltre, @`e necessario installare gli strumenti GNU Autotools
+(@uref{http://www.gnu.org/software/autoconf, Autoconf},
address@hidden://www.gnu.org/software/automake, Automake},
address@hidden://www.gnu.org/software/libtool, Libtool}
+e
address@hidden://www.gnu.org/software/gettext, GNU @command{gettext}}).
+
+La semplice procedura per compilare e testare @code{gawkextlib} @`e la
seguente.
+Dapprima, occorre compilare e installare @command{gawk}:
+
address@hidden
+cd .../percorso/del/sorgente/gawk
+./configure --prefix=/tmp/newgawk @ii{Installa in /tmp/newgawk per ora}
+make && make check @ii{Compila e controlla che tutto sia a
posto}
+make install @ii{Installa gawk}
address@hidden example
+
+Poi, dal sito @url{http://sourceforge.net/projects/gawkextlib/files} si deve
+scaricare @code{gawkextlib} e le estensioni che si vogliono installare.
+Il file @file{README} del sito spiega come compilare il codice. Se si @`e
+installato @command{gawk} in una posizione non-standard, occorre
+specificare @code{./configure address@hidden/percorso/del/programma/gawk}}
+per far address@hidden@dotless{i}} che venga trovato.
address@hidden essere necessario usare il programma di address@hidden
@command{sudo}
+per installare sia @command{gawk} che @code{gawkextlib}, a seconda di come
+funziona il sistema su cui si lavora.
+
+Chi scrive un'estensione e desidera condividerla con altri utenti
address@hidden, address@hidden prendere in considerazione l'idea di farlo
attraverso
+il progetto @code{gawkextlib}.
+Si veda il sito web del progetto per maggiori informazioni.
+
address@hidden Sommario delle estensioni
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Si possono scrivere estensioni (dette anche @dfn{plug-in})
+per @command{gawk}
+nel linguaggio C o C++ usando l'interfaccia di programmazione applicativa
+(API) definita dagli sviluppatori di
address@hidden
+
address@hidden
+Le estensioni devono avere una licenza compatibile con la
+GNU General Public License (GPL), e devono dichiararlo definendo un'apposita
+variabile di nome
address@hidden
+
address@hidden
+La comunicazione tra @command{gawk} e un'estensione @`e bidirezionale.
address@hidden passa all'estensione una struttura (@code{struct}) che contiene
+vari campi di dati e puntatori a funzione. L'estensione address@hidden poi
chiamare
+funzioni all'interno di @command{gawk} tramite dei puntatori a funzioni
+per svolgere alcuni compiti.
+
address@hidden
+Uno di questi compiti @`e di ``registrare'' il nome e l'implementazione di
+nuove funzioni a livello di @command{awk} con @command{gawk}.
+L'implementazione ha la forma di un puntatore del linguaggio C,
+cui @`e associato un dato livello di versione.
+Per convenzione, le funzioni di implementazione hanno nome
address@hidden@var{XXXX}()} per una funzione a livello di @command{awk} di nome
address@hidden@var{XXXX}()}.
+
address@hidden
+L'API @`e definita in un file di intestazione di nome @file{gawkapi.h}.
+Occorre includere alcuni file di intestazione standard @emph{prima} di
+includere tale intestazione nel codice sorgente.
+
address@hidden
+Vengono forniti dei puntatori a funzioni dell'API per i seguenti tipi di
+operazioni:
+
address@hidden @value{BULLET}
address@hidden
+Allocare, riallocare, e liberare memoria
+
address@hidden
+Registrare funzioni (si possono registrare
+funzioni di estensione,
+funzioni ausiliarie di pulizia (@dfn{callbacks}),
+una stringa di versione,
+degli analizzatori di input,
+dei processori di output,
+e dei processori bidirezionali)
+
address@hidden
+Stampare messaggi fatali, non fatali, di avvertimento, e avvertimenti ``lint''
+
address@hidden
+Aggiornare @code{ERRNO} o annullarlo
+
address@hidden
+Accedere a parametri, come pure convertire un parametro di tipo non definito
+in un vettore
+
address@hidden
+Accedere alla tabella dei simboli (ricuperare il valore di una
+variabile globale, crearne una nuova o modificarne una esistente)
+
address@hidden
+Creare e rilasciare valori nascosti; questo consente di usare in modo
+efficiente lo stesso valore per address@hidden variabili e address@hidden
migliorare di molto le
+prestazioni del programma
+
address@hidden
+Manipolare vettori
+(ricuperare, aggiungere, cancellare e modificare elementi;
+ottenere il numero di elementi in un vettore;
+creare un nuovo vettore;
+svuotare un vettore;
+e
+appiattire un vettore per poterlo percorrere facilmente con un ciclo in
+stile C, visitando tutti i suoi indici ed elementi)
address@hidden itemize
+
address@hidden
+L'API definisce diversi tipi di dati standard per rappresentare
+valori di variabili, elementi di vettore e vettori presenti in @command{awk}.
+
address@hidden
+L'API fornisce funzioni di servizio per definire dei valori.
+Sono anche disponibili funzioni di gestione della memoria, per assicurare
+la address@hidden fra memoria allocata da @command{gawk} e memoria allocata da
+un'estensione.
+
address@hidden
address@hidden la memoria passata da @command{gawk} a un'estensione dev'essere
+considerata come in sola lettura dall'estensione.
+
address@hidden
address@hidden la memoria passata da un'estensione a @command{gawk} deve
+essere ottenuta dalle funzioni di allocazione della memoria previste
+dall'API. @command{gawk} @`e responsabile per la gestione di quella memoria e
+la libera quando @`e il momento per farlo.
+
address@hidden
+L'API fornisce informazioni sulla versione di @command{gawk} in
+esecuzione, in modo che un'estensione possa verificare la propria
address@hidden
+con la versione di @command{gawk} da cui @`e stata caricata.
+
address@hidden
address@hidden address@hidden facile iniziare a programmare una nuova
estensione usando il
+codice predefinito descritto in questo @value{CHAPTER}. Alcune macro nel
+file di intestazione @file{gawkapi.h} rendono la cosa address@hidden agevole.
+
address@hidden
+La distribuzione di @command{gawk} comprende un numero di piccoli ma utili
+esempi di estensione. Il progetto @code{gawkextlib} include diverse altre
+estensioni, di maggiori dimensioni.
+Per chi desideri scrivere un'estensione e metterla a disposizione della
address@hidden degli utenti di @command{gawk}, il progetto @code{gawkextlib}
address@hidden il posto adatto per farlo.
+
address@hidden itemize
+
address@hidden EXCLUDE START
address@hidden Esercizi sulle estensioni
address@hidden Esercizi
+
address@hidden
address@hidden
+Aggiungere funzioni per rendere disponibili chiamate di sistema come
address@hidden()}, @code{chmod()} e @code{umask()} nelle estensioni che
+operano con i file viste
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden interne file}.
+
address@hidden Idea from comp.lang.awk, February 2015
address@hidden
+Scrivere un analizzatore di input che stampi un prompt se l'input proviene
+da un dispositivo che sia un ``terminale''. Si address@hidden usare la
funzione
address@hidden()} per sapere se il file in input @`e un terminale.
+(Suggerimento: questa funzione
+normalmente usa parecchie risorse quando @`e richiamata; si tenti di chiamarla
+una volta sola.)
+Il contenuto del prompt dovrebbe provenire da una variabile che sia possibile
+impostare a livello di codice @command{awk}.
+Si address@hidden inviare il prompt allo standard error. Tuttavia,
+per ottenere risultati migliori, @`e meglio aprire un nuovo descrittore di file
+(o puntatore a un file)
+sul file @file{/dev/tty} e stampare il prompt su quel file, nel caso
+in cui lo standard error sia stato ridiretto.
+
+Perch@'e lo standard error @`e una scelta migliore dello
+standard output per scrivere il prompt?
+Quale meccanismo di lettura andrebbe sostituito, quello che legge un record
+o quello che legge dei semplici byte?
+
address@hidden
+(Difficile.)
+Come si potrebbero gestire degli insiemi di nomi (@dfn{namespaces})
+in @command{gawk}, in modo
+che i nomi di funzione presenti in estensioni differenti non siano in conflitto
+tra loro?
+Chi riesce a trovare uno schema di buona address@hidden @`e pregato di
contattare il
+manutentore di @command{gawk}, per metterlo al corrente.
+
address@hidden
+Si scriva uno script di shell che funga da interfaccia per
+l'estensione ``inplace'', vista
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di estensione Inplace},
+in modo che il comportamento sia simile a quello del comando @samp{sed -i}.
+
address@hidden enumerate
address@hidden EXCLUDE END
+
address@hidden
address@hidden @value{PART4}Appendici
address@hidden ifnotinfo
+
address@hidden
+
address@hidden FOR_PRINT
+La Parte IV contiene le appendici (come pure le due licenze che proteggono
+il codice sorgente di @command{gawk} e questo @value{DOCUMENT},
+rispettivamente) e inoltre il Glossario:
address@hidden ifclear
+
address@hidden FOR_PRINT
+La Parte IV contiene tre appendici, l'ultima delle quali @`e la licenza
+che protegge il codice sorgente di @command{gawk}:
address@hidden ifset
+
address@hidden @value{BULLET}
address@hidden
address@hidden del linguaggio}
+
address@hidden
address@hidden
+
address@hidden FOR_PRINT
address@hidden
address@hidden
+
address@hidden
address@hidden fondamentali}
+
address@hidden
address@hidden
address@hidden ifclear
+
address@hidden
address@hidden
+
address@hidden FOR_PRINT
address@hidden
address@hidden per Documentazione Libera GNU (FDL)}
address@hidden ifclear
address@hidden itemize
address@hidden ifdocbook
+
address@hidden Storia del linguaggio
address@hidden L'evoluzione del linguaggio @command{awk}
+
+Questo @value{DOCUMENT} descrive l'implementazione GNU di @command{awk}
+conforme alle specifiche POSIX. Molti degli utenti di lunga data di
address@hidden hanno imparato a programmare in @command{awk} usando
+l'implementazione originale di @command{awk} presente nella versione 7 di
+Unix. (Questa versione @`e servita da base per la versione Berkeley Unix di
address@hidden, attraverso la versione 4.3BSD-Reno. Successive versioni di
+Berkeley Unix e, per un certo periodo, alcuni sistemi derivati da
+4.4BSD-Lite, hanno usato varie versioni di @command{gawk} come loro
address@hidden) Questo @value{CHAPTER} descrive in breve l'evoluzione
+del linguaggio @command{awk}, facendo riferimento ad altre parti del
address@hidden dove si possono trovare ulteriori informazioni.
+
address@hidden FOR_PRINT
+Per amor di address@hidden, sono state omesse in questa edizione informazioni
+sulla storia delle address@hidden di @command{gawk}. Si possono trovare nella
address@hidden://www.gnu.org/software/gawk/manual/html_node/Feature-History.html,
+documentazione online}.
address@hidden ifset
+
address@hidden
+* V7/SVR3.1:: Le principali differenze tra V7 e System V
+ Release 3.1.
+* SVR4:: Differenze minori tra System V
+ Release 3.1 e 4.
+* POSIX:: Nuove address@hidden per lo standard POSIX.
+* BTL:: Nuove address@hidden dalla versione
+ di @command{awk} di Brian Kernighan.
+* POSIX/GNU:: Le estensioni in @command{gawk} non
+ previste in @command{awk} POSIX.
+* Storia delle address@hidden:: La storia delle address@hidden di
+ @command{gawk}.
+* Estensioni comuni:: Sommario Estensioni comuni.
+* Intervalli e localizzazione:: Come le localizzazioni influiscono sugli
+ intervalli delle espressioni regolari.
+* Contributori:: I maggiori contributori a @command{gawk}.
+* Sommario della storia:: Sommario della storia.
address@hidden menu
+
address@hidden V7/SVR3.1
address@hidden Differenze importanti tra V7 e System V Release 3.1
address@hidden @command{awk}, versioni di
address@hidden @command{awk}, versioni di, differenze tra V7 e SVR3.1
+
+Il liguaggio @command{awk} si @`e evoluto considerevolmente tra Unix versione
+7 (1978) e la nuova implementazione disponibile a partire da Unix System V
+Release 3.1 (1987). Questa @value{SECTION} riassume le differenze e indica
+dove @`e possibile trovare ulteriori dettagli:
+
address@hidden @value{BULLET}
address@hidden
+La address@hidden di inserire @samp{;} per separare address@hidden regole su
una riga
+(@pxref{Istruzioni/Righe})
+
address@hidden
+Funzioni definite dall'utente e istruzione @code{return}
+(@pxref{Funzioni definite dall'utente})
+
address@hidden
+L'istruzione @code{delete} (@pxref{Cancellazione})
+
address@hidden
+L'istruzione @address@hidden
+(@pxref{Istruzione do})
+
address@hidden
+Le funzioni predefinite @code{atan2()}, @code{cos()}, @code{sin()},
@code{rand()} e
address@hidden()} (@pxref{Funzioni numeriche})
+
address@hidden
+Le funzioni predefinite @code{gsub()}, @code{sub()} e @code{match()}
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Le funzioni predefinite @code{close()} e @code{system()}
+(@pxref{Funzioni di I/O})
+
address@hidden
+Le variabili predefinite @code{ARGC}, @code{ARGV}, @code{FNR}, @code{RLENGTH},
address@hidden e @code{SUBSEP} (@pxref{Variabili predefinite})
+
address@hidden
address@hidden di modificare @code{$0} (@pxref{Cambiare i campi})
+
address@hidden
+L'espressione condizionale che fa uso dell'operatore ternario @samp{?:}
+(@pxref{Espressioni condizionali})
+
address@hidden
+L'espressione @address@hidden in @var{vettore}} esterna alle istruzioni
address@hidden (@pxref{Visitare elementi})
+
address@hidden
+L'operatore esponenziale @samp{^}
+(@pxref{Operatori aritmetici}) e il relativo operatore di assegnamento
address@hidden (@pxref{Operatori di assegnamento})
+
address@hidden
+Precedenze tra operatori compatibili con quelle del linguaggio C, che
+rendono non funzionanti alcuni vecchi programmi @command{awk}
(@pxref{Precedenza})
+
address@hidden
+La address@hidden di usare @dfn{regexp} come valori di @code{FS}
+(@pxref{Separatori di campo}) e come
+terzo argomento per la funzione @code{split()}
+(@pxref{Funzioni per stringhe}), invece di usare solo il primo carattere
+di @code{FS}
+
address@hidden
address@hidden dinamiche come operandi degli operatori @samp{~} e @samp{!~}
+(@pxref{Espressioni regolari calcolate})
+
address@hidden
+Le sequenze di protezione @samp{\b}, @samp{\f} e @samp{\r}
+(@pxref{Sequenze di protezione})
+
address@hidden
+La ridirezione dell'input per la funzione @code{getline}
+(@pxref{Getline})
+
address@hidden
+La address@hidden di avere address@hidden regole @code{BEGIN} ed @code{END}
+(@pxref{BEGIN/END})
+
address@hidden
+Vettori multidimensionali
+(@pxref{Vettori multidimensionali})
address@hidden itemize
+
address@hidden SVR4
address@hidden Differenze tra le versioni System V Release 3.1 e SVR4
+
address@hidden @command{awk}, versioni di, differenze tra SVR3.1 e SVR4
+La versione per Unix System V Release 4 (1989) di @command{awk} ha aggiunto
+queste address@hidden (alcune delle quali introdotte da @command{gawk}):
+
address@hidden @value{BULLET}
address@hidden
+Il vettore @code{ENVIRON} (@pxref{Variabili predefinite})
address@hidden gawk and MKS awk
+
address@hidden
+La address@hidden di specificare address@hidden opzioni @option{-f} sulla riga
di comando
+(@pxref{Opzioni})
address@hidden MKS awk
address@hidden Mortice Kern Systems, ditta produttrice di una versione
commerciale di awk
+
address@hidden
+L'opzione @option{-v} per assegnare variabili prima di iniziare
+l'esecuzione del programma
+(@pxref{Opzioni})
address@hidden GNU, Bell Laboratories & MKS together
+
address@hidden
+La notazione @option{--} per indicare la fine delle opzioni sulla riga di
+comando
+
address@hidden
+Le sequenze di protezione @samp{\a}, @samp{\v} e @samp{\x}
+(@pxref{Sequenze di protezione})
address@hidden GNU, for ANSI C compat
+
address@hidden
+Un valore di ritorno definito per la funzione predefinita @code{srand()}
+(@pxref{Funzioni numeriche})
+
address@hidden
+Le funzioni predefinite per stringhe @code{toupper()} e @code{tolower()}
+per la conversione maiuscolo/minuscolo
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Una specificazione address@hidden accurata per la lettera @samp{%c} di
controllo del
+formato nella funzione @code{printf}
+(@pxref{Lettere di controllo})
+
address@hidden
+La address@hidden di decidere dinamicamente la larghezza di un campo e la
+precisione da usare (@code{"%*.*d"}) nella lista degli argomenti passati a
address@hidden e @code{sprintf()}
+(@pxref{Lettere di controllo})
+
address@hidden
+L'uso di costanti @dfn{regexp}, p.es. @code{/pippo/}, come espressioni,
+che equivalgono a usare l'operatore di ricerca di una
+corrispondenza, p.es. @samp{$0 ~ /pippo/}
+(@pxref{Usare le costanti @dfn{regexp}})
+
address@hidden
+Gestione di sequenze di protezione nell'assegnamento di variabili
+effettuato tramite la riga di comando
+(@pxref{Opzioni di assegnamento})
address@hidden itemize
+
address@hidden POSIX
address@hidden Differenze tra versione SVR4 e POSIX di @command{awk}
address@hidden @command{awk}, versioni di, differenze tra SVR4 e POSIX
@command{awk}
address@hidden POSIX @command{awk}, differenze tra versioni @command{awk}
+
+Lo standard POSIX Command Language and Utilities per @command{awk} (1992)
+ha introdotto le seguenti modifiche al linguaggio:
+
address@hidden @value{BULLET}
address@hidden
+L'uso dell'opzione @option{-W} per opzioni specifiche a una data
+implementazione
+(@pxref{Opzioni})
+
address@hidden
+L'uso di @code{CONVFMT} per controllare la conversione di numeri
+in stringhe (@pxref{Conversione})
+
address@hidden
+Il concetto di stringa numerica e regole di confronto address@hidden precise
da seguire
+al riguardo (@pxref{Tipi di variabile e confronti})
+
address@hidden
+L'uso di variabili predefinite come nomi di parametri delle funzioni @`e
vietato
+(@pxref{Sintassi delle definizioni})
+
address@hidden
+Una documentazione address@hidden completa di molte tra le address@hidden del
linguaggio
+precedentemente non documentate
address@hidden itemize
+
+Nel 2012, un certo numero di estensioni che erano address@hidden comunemente
+disponibili da parecchi anni sono state finalmente aggiunte allo standard
+POSIX. Ecco l'elenco:
+
address@hidden @value{BULLET}
address@hidden
+La funzione predefinita @code{fflush()} per forzare la scrittura dei buffer
+in output
+(@pxref{Funzioni di I/O})
+
address@hidden
+L'istruzione @code{nextfile}
+(@pxref{Istruzione nextfile})
+
address@hidden
+La address@hidden di eliminare completamente un vettore con l'istruzione
address@hidden @var{vettore}}
+(@pxref{Cancellazione})
+
address@hidden itemize
+
address@hidden comuni} per una lista delle estensioni comuni
+non previste nello standard POSIX.
+
+Lo standard POSIX 2008 @`e reperibile online a:
address@hidden://www.opengroup.org/onlinepubs/9699919799/}.
+
+
address@hidden BTL
address@hidden Estensioni nell'@command{awk} di Brian Kernighan
+
address@hidden @command{awk}, versioni di, si veda anche Brian Kernighan,
@command{awk} di
address@hidden estensioni, Brian Kernighan @command{awk}
address@hidden Brian Kernighan, @command{awk} di, estensioni
address@hidden Kernighan, Brian
+Brian Kernighan
+ha reso disponibile la sua versione nel suo sito.
+(@pxref{Altre versioni}).
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive estensioni comuni disponibili per la
+prima volta nella sua versione di @command{awk}:
+
address@hidden @value{BULLET}
address@hidden
+Gli operatori @samp{**} e @samp{**=}
+(@pxref{Operatori aritmetici}
+e
address@hidden di assegnamento})
+
address@hidden
+L'uso di @code{func} come abbreviazione di @code{function}
+(@pxref{Sintassi delle definizioni})
+
address@hidden
+La funzione predefinita @code{fflush()} per forzare la scrittura dei buffer
+in output
+(@pxref{Funzioni di I/O})
+
address@hidden
address@hidden
+The @code{SYMTAB} array, that allows access to @command{awk}'s internal symbol
+table. This feature was never documented for his @command{awk}, largely because
+it is somewhat shakily implemented. For instance, you cannot access arrays
+or array elements through it
address@hidden ignore
address@hidden itemize
+
address@hidden comuni} per una lista completa delle estensioni
+disponibile nel suo @command{awk}.
+
address@hidden POSIX/GNU
address@hidden Estensioni di @command{gawk} non in POSIX @command{awk}
+
address@hidden address@hidden compatibile di (@command{gawk}), estensioni nella
address@hidden estensioni nella address@hidden compatibile di (@command{gawk})
address@hidden estensioni, in @command{gawk}, non in POSIX @command{awk}
address@hidden POSIX, estensioni @command{gawk} non incluse in
+L'implementazione GNU di @command{gawk} aggiunge molte address@hidden
+Queste possono essere disabilitate completamente sia con l'opzione
address@hidden che con l'opzione
address@hidden
+(@pxref{Opzioni}).
+
+Alcune address@hidden sono state introdotte e successivamente tolte
+con il passare del tempo.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden
+sintetizza le ulteriori address@hidden rispetto a POSIX @command{awk} che sono
+presenti nella versione corrente di @command{gawk}.
+
address@hidden @value{BULLET}
+
address@hidden
+Ulteriori variabili predefinite:
+
address@hidden @value{MINUS}
address@hidden
+Le variabili
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+(@pxref{Variabili predefinite})
address@hidden itemize
+
address@hidden
+File speciali verso cui ridirigere l'I/O:
+
address@hidden @value{MINUS}
address@hidden
+I file @file{/dev/stdin}, @file{/dev/stdout}, @file{/dev/stderr} e i
address@hidden speciali @file{/dev/fd/@var{N}}
+(@pxref{File speciali})
+
address@hidden
+I file speciali @file{/inet}, @file{/inet4} e @file{/inet6} per
+interagire con la rete TCP/IP usando @samp{|&} per specificare quale
+versione usare del protocollo IP
+(@pxref{Reti TCP/IP})
address@hidden itemize
+
address@hidden
+Differenze e/o aggiunte al linguaggio:
+
address@hidden @value{MINUS}
address@hidden
+La sequenza di protezione @samp{\x}
+(@pxref{Sequenze di protezione})
+
address@hidden
+Supporto completo per @dfn{regexp} sia POSIX che GNU
address@hidden
+(@pxrefil{Espressioni regolari})
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari})
address@hidden ifnottex
+
address@hidden
+La address@hidden che @code{FS} e il terzo
+argomento di @code{split()} siano la stringa nulla
+(@pxref{Campi di un solo carattere})
+
address@hidden
+La address@hidden che @code{RS} sia una @dfn{regexp}
+(@pxref{Record})
+
address@hidden
+La address@hidden di usare costanti ottali ed esadecimali nei programmi
+scritti in @command{awk}
+(@pxref{Numeri non-decimali})
+
address@hidden
+L'operatore @samp{|&} per poter effettuare I/O bidirezionale verso un
+coprocesso
+(@pxref{I/O bidirezionale})
+
address@hidden
+Chiamate indirette di funzione
+(@pxref{Chiamate indirette})
+
address@hidden
+La address@hidden di ignorare directory specificate sulla riga di comando,
+emettendo un messaggio di avvertimento
+(@pxref{Directory su riga di comando})
+
address@hidden
+Errori in output usando @code{print} e @code{printf} non provocano
+necessariamente la fine del programma
+(@pxref{Continuazione dopo errori})
address@hidden itemize
+
address@hidden
+Nuove parole chiave:
+
address@hidden @value{MINUS}
address@hidden
+I criteri di ricerca speciali @code{BEGINFILE} ed @code{ENDFILE}
+(@pxref{BEGINFILE/ENDFILE})
+
address@hidden
+L'istruzione @code{switch}
+(@pxref{Istruzione switch})
address@hidden itemize
+
address@hidden
+Differenze in funzioni standard di @command{awk}:
+
address@hidden @value{MINUS}
address@hidden
+Il secondo argomento opzionale di @code{close()} che consente di chiudere
+un solo lato dell'I/O di una @dfn{pipe} bidirezionale aperta verso un
+coprocesso (@pxref{I/O bidirezionale})
+
address@hidden
+Aderenza allo standard POSIX per le funzioni @code{gsub()} e @code{sub()}
+se @`e stata specificata l'opzione @option{--posix}
+
address@hidden
+La funzione @code{length()} accetta come argomento il nome di un vettore
+e restituisce il numero di elementi nel vettore
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Il terzo argomento opzionale della funzione @code{match()}
+per contenere eventuali sottoespressioni individuate all'interno di una
address@hidden
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Specificatori posizionali nei formati di @code{printf} per facilitare
+le traduzioni di messaggi
+(@pxref{Ordinamento di printf})
+
address@hidden
+L'aggiunta di un quarto argomento opzionale alla funzione @code{split()},
+per designare un vettore che contenga il testo dei separatori di campo
+(@pxref{Funzioni per stringhe})
address@hidden itemize
+
address@hidden
+Ulteriori funzioni presenti solo in @command{gawk}:
+
address@hidden @value{MINUS}
address@hidden
+Le funzioni @code{gensub()}, @code{patsplit()} e @code{strtonum()}
+per una gestione di testi address@hidden potente
+(@pxref{Funzioni per stringhe})
+
address@hidden
+Le funzioni @code{asort()} e @code{asorti()} per l'ordinamento di vettori
+(@pxref{Ordinamento di vettori})
+
address@hidden
+Le funzioni @code{mktime()}, @code{systime()} e @code{strftime()}
+per lavorare con date e ore
+(@pxref{Funzioni di tempo})
+
address@hidden
+Le funzioni
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()},
address@hidden()}
+e
address@hidden()}
+per la manipolazione a livello di bit
+(@pxref{Funzioni a livello di bit})
address@hidden In 4.1, and(), or() and xor() grew the ability to take > 2
arguments
+
address@hidden
+La funzione @code{isarray()} per controllare se una variabile @`e un vettore
+oppure no
+(@pxref{Funzioni per i tipi})
+
address@hidden
+Le funzioni @code{bindtextdomain()}, @code{dcgettext()}
+e @code{dcngettext()} per l'internazionalizzazione
+(@pxref{I18N per programmatore})
+
address@hidden
+La funzione @code{intdiv()} per effettuare divisioni a numeri interi e
+ottenere il resto della divisione
+(@pxref{Funzioni numeriche})
address@hidden itemize
+
address@hidden
+Modifiche e/o aggiunte alle opzioni della riga di comando:
+
address@hidden @value{MINUS}
address@hidden
+La variabile d'ambiente @env{AWKPATH} per specificare un percorso di ricerca
+per l'opzione @option{-f} della riga di comando
+(@pxref{Opzioni})
+
address@hidden
+La variabile d'ambiente @env{AWKLIBPATH} per specificare un percorso di ricerca
+per l'opzione @option{-l} della riga di comando
+(@pxref{Opzioni})
+
address@hidden
+Le opzioni brevi
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+. Inoltre, la
address@hidden di usare opzioni in formato lungo (stile GNU) che iniziano
+con @option{--}
+e le opzioni lunghe
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+and
address@hidden
+(@pxref{Opzioni}).
address@hidden itemize
+
address@hidden new ports
+
address@hidden
+Il supporto per i seguenti sistemi obsoleti @`e stato rimosso dal codice
+sorgente e dalla documentazione di @command{gawk} @value{PVERSION} 4.0:
+
address@hidden nested table
address@hidden @value{MINUS}
address@hidden
+Amiga
+
address@hidden
+Atari
+
address@hidden
+BeOS
+
address@hidden
+Cray
+
address@hidden
+MIPS RiscOS
+
address@hidden
+MS-DOS con il compilatore Microsoft
+
address@hidden
+MS-Windows con il compilatore Microsoft
+
address@hidden
+NeXT
+
address@hidden
+SunOS 3.x, Sun 386 (Road Runner)
+
address@hidden
+Tandem (non-POSIX)
+
address@hidden
+Compilatore pre-standard VAX C per VAX/VMS
+
address@hidden
+GCC per VAX e Alpha non @`e stato verificato da parecchio tempo.
+
address@hidden itemize
+
address@hidden
+Il supporto per i seguenti sistemi obsoleti @`e stato rimosso dal codice
+di @command{gawk} @value{PVERSION} 4.1:
+
address@hidden nested table
address@hidden @value{MINUS}
address@hidden
+Ultrix
address@hidden itemize
+
address@hidden
+Il supporto per i seguenti sistemi obsoleti @`e stato rimosso dal codice
+sorgente e dalla documentazione di
address@hidden @value{PVERSION} 4.2:
+
address@hidden nested table
address@hidden @value{MINUS}
address@hidden
+MirBSD
+
address@hidden
+GNU/Linux su Alpha
address@hidden itemize
+
address@hidden itemize
+
address@hidden XXX ADD MORE STUFF HERE
+
+
address@hidden This does not need to be in the formal book.
address@hidden FOR_PRINT
address@hidden Storia delle address@hidden
address@hidden Storia delle address@hidden di @command{gawk}
+
address@hidden
+See the thread:
+https://groups.google.com/forum/#!topic/comp.lang.awk/SAUiRuff30c
+This motivated me to add this section.
address@hidden ignore
+
address@hidden
+I've tried to follow this general order, esp.@: for the 3.0 and 3.1 sections:
+ variables
+ special files
+ language changes (e.g., hex constants)
+ differences in standard awk functions
+ new gawk functions
+ new keywords
+ new command-line options
+ behavioral changes
+ new ports
+Within each category, be alphabetical.
address@hidden ignore
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive le address@hidden in @command{gawk}
+in aggiunta a quelle di POSIX @command{awk},
+nell'ordine in cui sono state rese disponibili in @command{gawk}.
+
+La versione 2.10 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+La variabile d'ambiente @env{AWKPATH} per specificare un percorso di ricerca
+per l'opzione @option{-f} della riga di comando
+(@pxref{Opzioni})
+
address@hidden
+La variabile @code{IGNORECASE} e i suoi effetti
+(@pxref{Maiuscolo-Minuscolo}).
+
address@hidden
+I file @file{/dev/stdin}, @file{/dev/stdout}, @file{/dev/stderr} e i
address@hidden speciali @file{/dev/fd/@var{N}}
+(@pxref{File speciali})
address@hidden itemize
+
+La versione 2.13 di @command{gawk} ha ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+La variabile @code{FIELDWIDTHS} e i suoi effetti
+(@pxref{Dimensione costante}).
+
address@hidden
+Le funzioni predefinite @code{systime()} e @code{strftime()} per ottenere
+e stampare data e ora
+(@pxref{Funzioni di tempo}).
+
address@hidden
+Ulteriori opzioni dalla riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{-W lint} per fornire controlli su possibili errori e per
+la address@hidden, sia a livello di codice sorgente che in fase di esecuzione.
+
address@hidden
+L'opzione @option{-W compat} per inibire le estensioni GNU.
+
address@hidden
+L'opzione @option{-W posix} per richiedere una stretta aderenza allo
+standard POSIX.
address@hidden itemize
address@hidden itemize
+
+La versione 2.14 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+L'istruzione @code{next file} per passare immediatamente al successivo
address@hidden (@pxref{Istruzione nextfile}).
address@hidden itemize
+
+La versione 2.15 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+Nuove variabili (@pxref{Variabili predefinite}):
+
address@hidden @value{MINUS}
address@hidden
address@hidden, che permette di controllare la posizione di @code{FILENAME}
+nel vettore @code{ARGV}.
+
address@hidden
address@hidden, che contiene il messaggio di errore del sistema quando
address@hidden restituisce @minus{}1 o @code{close()} non termina con successo.
address@hidden itemize
+
address@hidden
+I @value{FNS} speciali @file{/dev/pid}, @file{/dev/ppid}, @file{/dev/pgrpid}
+e @file{/dev/user}. Questo supporto @`e stato rimosso in seguito.
+
address@hidden
+La address@hidden di cancellare un intero vettore in una sola istruzione
+con @samp{delete @var{vettore}}
+(@pxref{Cancellazione}).
+
address@hidden
+Modifiche nelle opzioni della riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+La address@hidden di usare opzioni in formato lungo (in stile GNU) che iniziano
+con @option{--}.
+
address@hidden
+L'opzione @option{--source} per combinare codice sorgente immesso nella riga
+di comando e codice sorgente proveniente da file di libreria.
address@hidden itemize
address@hidden itemize
+
+La versione 3.0 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+Variabili nuove o modificate:
+
address@hidden @value{MINUS}
address@hidden
address@hidden modificato, diventa applicabile al confronto tra stringhe,
+come pure alle operazioni su @dfn{regexp}
+(@pxref{Maiuscolo-Minuscolo}).
+
address@hidden
address@hidden, che contiene il testo in input che @`e stato individuato da
@code{RS}
+(@pxref{Record}).
address@hidden itemize
+
address@hidden
+Supporto completo sia per le @dfn{regexp} POSIX sia per quelle GNU
address@hidden
+(@pxrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+(@pxref{Espressioni regolari}).
address@hidden ifnottex
+
address@hidden
+La funzione @code{gensub()} per migliorare la manipolazione di testi
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+La funzione @code{strftime()} prevede un formato di data e ora di default,
+in modo da poter essere chiamata senza alcun argomento.
+(@pxref{Funzioni di tempo}).
+
address@hidden
+La address@hidden che @code{FS} e il terzo argomento della funzione
address@hidden()} siano delle stringhe nulle
+(@pxref{Campi di un solo carattere}).
+
address@hidden
+La address@hidden che @code{RS} sia una @dfn{regexp}
+(@pxref{Record}).
+
address@hidden
+L'istruzione @code{next file} @`e diventata @code{nextfile}
+(@pxref{Istruzione nextfile}).
+
address@hidden
+La funzione @code{fflush()} di
+BWK @command{awk}
+(BWK allora lavorava ai Bell Laboratories;
address@hidden di I/O}).
+
address@hidden
+Nuove opzioni della riga di comando:
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{--lint-old} per
+ottenere messaggi relativi a costrutti non disponibili
+nell'implementazione di @command{awk} per Unix Version 7
+(@pxref{V7/SVR3.1}).
+
address@hidden
+L'opzione @option{-m} da BWK @command{awk}. (Brian lavorava
+ancora ai Bell Laboratories all'epoca.) Quest'opzione @`e stata in seguito
+rimossa, sia dal suo @command{awk} che da @command{gawk}.
+
address@hidden
+L'opzione @option{--re-interval} per consentire di specificare
+espressioni di intervallo nelle @dfn{regexp}
+(@pxref{Operatori di espressioni regolari}).
+
address@hidden
+L'opzione @option{--traditional} aggiunta come maniera address@hidden intuitiva
+per richiedere l'opzione
address@hidden (@pxref{Opzioni}).
address@hidden itemize
+
address@hidden
+L'uso di GNU Autoconf per controllare il processo di configurazione
+(@pxref{Installazione veloce}).
+
address@hidden
+Supporto per Amiga.
+Questo supporto @`e stato rimosso in seguito.
+
address@hidden itemize
+
+La versione 3.1 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
address@hidden
+Nuove variabili
+(@pxref{Variabili predefinite}):
+
address@hidden @value{MINUS}
address@hidden
address@hidden, per sistemi non aderenti allo standard POSIX,
+che consente I/O binario per file in input e/o output
+(@pxref{Uso su PC}).
+
address@hidden
address@hidden, che controlla dinamicamente gli avvertimenti emessi da
@dfn{lint}.
+
address@hidden
address@hidden, un vettore che fornisce informazioni correlate con il
+processo in esecuzione.
+
address@hidden
address@hidden, per impostare il dominio testuale in cui internazionalizzare
+un'applicazione (@pxref{Internazionalizzazione}).
address@hidden itemize
+
address@hidden
+La address@hidden di usare costanti ottali ed esadecimali nel codice
+sorgente di programmi @command{awk}.
+(@pxref{Numeri non-decimali}).
+
address@hidden
+L'operatore @samp{|&} per effettuare I/O bidirezionale verso un
+coprocesso
+(@pxref{I/O bidirezionale}).
+
address@hidden
+I file speciali @file{/inet} per interagire con reti TCP/IP usando @samp{|&}
+(@pxref{Reti TCP/IP}).
+
address@hidden
+Il secondo argomento opzionale della funzione @code{close()} per permettere di
+chiudere uno dei lati di una @dfn{pipe} bidirezionale aperta con un coprocesso
+(@pxref{I/O bidirezionale}).
+
address@hidden
+Il terzo argomento opzionale della funzione @code{match()} per
+avere a disposizione le diverse sottoespressioni individuate all'interno
+di una @dfn{regexp}
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Specificatori posizionali nelle stringhe di formato di @code{printf} per
+facilitare la traduzione di messaggi
+(@pxref{Ordinamento di printf}).
+
address@hidden
+Alcune nuove funzioni predefinite:
+
address@hidden @value{MINUS}
address@hidden
+Le funzioni @code{asort()} e @code{asorti()} per l'ordinamento di vettori
+(@pxref{Ordinamento di vettori}).
+
address@hidden
+Le funzioni @code{bindtextdomain()}, @code{dcgettext()} e @code{dcngettext()}
+per l'internationalizzazione
+(@pxref{I18N per programmatore}).
+
address@hidden
+La funzione @code{extension()} e la address@hidden di aggiungere
+nuove funzioni predefinite dinamicamente
address@hidden
+(@pxrefil{Estensioni dinamiche}).
address@hidden iftex
address@hidden
+(@pxref{Estensioni dinamiche}).
address@hidden ifnottex
+
address@hidden
+La funzione @code{mktime()} per generare date e ore
+(@pxref{Funzioni di tempo}).
+
address@hidden
+Le funzioni @code{and()}, @code{or()}, @code{xor()}, @code{compl()},
address@hidden()}, @code{rshift()} e @code{strtonum()}
+(@pxref{Funzioni a livello di bit}).
address@hidden itemize
+
address@hidden
address@hidden @code{next file} statement
+Il supporto per @samp{next file} scritto come due parole @`e stato rimosso
+completamente
+(@pxref{Istruzione nextfile}).
+
address@hidden
+Ulteriori opzioni sulla riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{--dump-variables} per stampare una lista di tutte le
+variabili globali.
+
address@hidden
+L'opzione @option{--exec}, da usare in script CGI [Common Gateway Interface].
+
address@hidden
+L'opzione della riga di comando @option{--gen-po} e l'uso di un trattino
+basso a inizio stringa, per segnalare stringhe che dovrebbero essere tradotte
+(@pxref{Estrazione di stringhe}).
+
address@hidden
+L'opzione @option{--non-decimal-data} per consentire di avere dati in input
+di tipo non decimale
+(@pxref{Dati non decimali}).
+
address@hidden
+L'opzione @option{--profile} e @command{pgawk}, la
+versione profilatrice di @command{gawk}, per produrre profili di esecuzione
+di programmi @command{awk}
+(@pxref{Profilare}).
+
address@hidden
+L'opzione @option{--use-lc-numeric} per richiedere a @command{gawk}
+di usare il carattere di separazione decimale proprio della localizzazione
+nell'elaborazione dei dati in input
+(@pxref{Conversione}).
address@hidden itemize
+
address@hidden
+L'uso di GNU Automake a supporto della standardizzazione del processo
+di configurazione
+(@pxref{Installazione veloce}).
+
address@hidden
+L'uso di GNU @command{gettext} per i messaggi emessi da @command{gawk}
+(@pxref{Gawk internazionalizzato}).
+
address@hidden
+Supporto per BeOS. Rimosso in seguito.
+
address@hidden
+Supporto per Tandem. Rimosso in seguito.
+
address@hidden
+La versione per Atari ufficialmente non @`e address@hidden supportata e in
seguito
address@hidden stata completamente rimossa.
+
address@hidden
+Modifiche al codice sorgente per usare definizioni di funzione secondo lo
+stile di codifica dello standard ISO C.
+
address@hidden
+Aderenza alla specifica POSIX per le funzioni @code{sub()} e @code{gsub()}
+(@pxref{Dettagli ostici}).
+
address@hidden
+La funzione @code{length()} @`e stata estesa per accettare un vettore come
+argomento, e restituire in tal caso il numero di elementi nel vettore
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+La funzione @code{strftime()} accetta un terzo argomento per
+dare la address@hidden di stampare data e ora nel formato UTC
+(@pxref{Funzioni di tempo}).
address@hidden itemize
+
+La versione 4.0 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
+
address@hidden
+Aggiunta di variabili:
+
address@hidden @value{MINUS}
address@hidden
address@hidden, che permette di specificare una @dfn{regexp} che individua
+i campi, invece che individuare il separatore tra i campi
+(@pxref{Separazione in base al contenuto}).
+
address@hidden
+Se esiste l'elemento di vettore @code{PROCINFO["sorted_in"]}, il ciclo
address@hidden(indice in pippo)} ordina
+gli indici, prima di iniziare il ciclo. Il valore di questo elemento
+permette di controllare l'ordinamento degli indici prima di iniziare il
+ciclo che li visita tutti
+(@pxref{Controllare visita}).
+
address@hidden
address@hidden"strftime"]}, che contiene la stringa di formato
+di default per @code{strftime()}
+(@pxref{Funzioni di tempo}).
address@hidden itemize
+
address@hidden
+I file speciali @file{/dev/pid}, @file{/dev/ppid}, @file{/dev/pgrpid}
+e @file{/dev/user} sono stati rimossi.
+
address@hidden
+Il supporto per IPv6 @`e stato aggiunto attraverso il file speciale
address@hidden/inet6}.
+Il file speciale @file{/inet4} consente di operare con IPv4 e @file{/inet}
+opera con il default di sistema, che probabilmente @`e IPv4
+(@pxref{Reti TCP/IP}).
+
address@hidden
+L'uso delle sequenze di protezione @samp{\s} e @samp{\S} nelle espressioni
+regolari
+(@pxref{Operatori di @dfn{regexp} GNU}).
+
address@hidden
+Le espressioni di intervallo sono consentite per default nelle espressioni
+regolari
+(@pxref{Operatori di espressioni regolari}).
+
address@hidden
+La classi di caratteri POSIX sono consentite anche se si @`e specificata
+l'opzione @option{--traditional}
+(@pxref{Operatori di espressioni regolari}).
+
address@hidden
address@hidden e @code{continue} non sono address@hidden consentiti fuori da un
ciclo,
+anche se si @`e specificata l'opzione @option{--traditional}
+(@pxref{Istruzione break} e anche la
address@hidden continue}).
+
address@hidden
address@hidden()}, @code{nextfile} e @samp{delete @var{array}}
+sono consentite anche se @`e stata specificata l'opzione @option{--posix} o
address@hidden, poich@'e questi costrutti sono ora inclusi
+nello standard POSIX.
+
address@hidden
+Un terzo argomento facoltativo per le funzioni @code{asort()} e @code{asorti()}
+permette di specificare il tipo di ordinamento desiderato
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Il comportamento di @code{fflush()} @`e stato modificato per corrispondere
+a quello di BWK @command{awk}
+e per lo standard POSIX; ora sia @samp{fflush()} che @samp{fflush("")}
+forzano la scrittura di tutte le ridirezioni in output aperte
+(@pxref{Funzioni di I/O}).
+
address@hidden
+La funzione @code{isarray()}
+determina se un elemento @`e un vettore oppure no
+per rendere possibile la visita di vettori di vettori
+(@pxref{Funzioni per i tipi}).
+
address@hidden
+La funzione @code{patsplit()} che
+fornisce le stesse address@hidden di @code{FPAT}, per suddividere delle
stringhe
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Un quarto argomento opzionale per la funzione @code{split()},
+che indica un vettore destinato a contenere i valori dei separatori
+(@pxref{Funzioni per stringhe}).
+
address@hidden
+Vettori di vettori
+(@pxref{Vettori di vettori}).
+
address@hidden
+I criteri di ricerca speciali @code{BEGINFILE} ed @code{ENDFILE}
+(@pxref{BEGINFILE/ENDFILE}).
+
address@hidden
+Chiamate indirette di funzioni
+(@pxref{Chiamate indirette}).
+
address@hidden
+Le istruzioni @code{switch} / @code{case} sono disponibili per default
+(@pxref{Istruzione switch}).
+
address@hidden
+Modifiche nelle opzioni della riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+Le opzioni @option{-b} e @option{--characters-as-bytes},
+che impediscono che @command{gawk} tratti l'input come composto da una
+stringa di caratteri multibyte.
+
address@hidden
+Rimozione delle opzioni ridondanti (in notazione lunga) @option{--compat},
address@hidden e @option{--usage}.
+
address@hidden
+L'opzione @option{--gen-po} @`e stata finalmente rinominata
address@hidden per correttezza.
+
address@hidden
+L'opzione @option{--sandbox} che disabilita alcune address@hidden [per operare
+in un ambiente "protetto"].
+
address@hidden
+Tutte le opzioni in notazione lunga hanno acquisito opzioni corrispondenti
+in notazione breve, per poter essere usate negli script di shell @samp{#!}.
address@hidden itemize
+
address@hidden
+I nomi di directory che appaiono sulla riga di comando generano adesso
+un messaggio di errore, ma non interrompono l'elaborazione, a meno che non
+siano state specificate le opzioni @option{--posix} o @option{--traditional}
+(@pxref{Directory su riga di comando}).
+
address@hidden
+Il codice interno di @command{gawk} @`e stato riscritto, aggiungendo la
+versione per il debug @command{dgawk},
+con un possibile miglioramento nei tempi di esecuzione
address@hidden
+(@pxrefil{Debugger}).
address@hidden iftex
address@hidden
+(@pxref{Debugger}).
address@hidden ifnottex
+
address@hidden
+In aderenza agli standard di codifica GNU, le estensioni dinamiche devono
+definire un simbolo globale che indica che sono compatibili con la
+licenza GPL
+(@pxref{Licenza delle estensioni}).
+
address@hidden
+In address@hidden POSIX, i confronti tra stringhe usano le funzioni di
+libreria @code{strcoll()} / @code{wcscoll()}
+(@pxref{Confronto POSIX di stringhe}).
+
address@hidden
+L'opzione per usare @dfn{socket} in maniera @dfn{raw} (nativa) @`e stata
+rimossa, perch@'e non era mai stata implementata
+(@pxref{Reti TCP/IP}).
+
address@hidden
+Intervalli nella forma @samp{[d-h]} sono elaborati come se fossero scritti
+nella localizzazione C, a prescindere da che tipo di @dfn{regexp} @`e usata,
+anche se era stata specificata l'opzione
address@hidden
+(@pxref{Intervalli e localizzazione}).
+
address@hidden
address@hidden stato rimosso il supporto per i seguenti sistemi:
+
address@hidden @value{MINUS}
address@hidden
+Atari
+
address@hidden
+Amiga
+
address@hidden
+BeOS
+
address@hidden
+Cray
+
address@hidden
+MIPS RiscOS
+
address@hidden
+MS-DOS con Compilatore Microsoft
+
address@hidden
+MS-Windows con Compilatore Microsoft
+
address@hidden
+NeXT
+
address@hidden
+SunOS 3.x, Sun 386 (Road Runner)
+
address@hidden
+Tandem (non-POSIX)
+
address@hidden
+Compilatore pre-standard VAX C per VAX/VMS
address@hidden itemize
address@hidden itemize
+
+La versione 4.1 di @command{gawk} ha introdotto le seguenti address@hidden:
+
address@hidden @value{BULLET}
+
address@hidden
+Tre nuovi vettori:
address@hidden, @code{FUNCTAB} e @code{PROCINFO["identifiers"]}
+(@pxref{Variabili auto-assegnate}).
+
address@hidden
+I tre comandi eseguibili @command{gawk}, @command{pgawk} e @command{dgawk},
+sono diventati uno solo, con il solo nome @command{gawk}. Di conseguenza
+le opzioni sulla riga di comando sono state modificate.
+
address@hidden
+Modifiche delle opzioni da riga di comando
+(@pxref{Opzioni}):
+
address@hidden @value{MINUS}
address@hidden
+L'opzione @option{-D} attiva il debugger.
+
address@hidden
+Le opzioni @option{-i} e @option{--include}
+caricano dei file di libreria @command{awk}.
+
address@hidden
+Le opzioni @option{-l} e @option{--load} caricano estensioni dinamiche
+compilate.
+
address@hidden
+Le opzioni @option{-M} e @option{--bignum} abilitano la libreria MPFR per
+il calcolo con un numero arbitrario di cifre significative.
+
address@hidden
+L'opzione @option{-o} serve solo a ottenere in output una stampa formattata
+elegantemente del programma da eseguire.
+
address@hidden
+L'opzione @option{-p} @`e usata per "profilare" l'esecuzione del programma.
+
address@hidden
+L'opzione @option{-R} @`e stata rimossa.
address@hidden itemize
+
address@hidden
+Supporto per il calcolo ad alta precisione con MPFR
+(@pxref{Calcolo con precisione arbitraria}).
+
address@hidden
+Le funzioni @code{and()}, @code{or()} e @code{xor()} sono state modificate
+per ammettere un numero qualsiasi di argomenti, con un minimo di due
+(@pxref{Funzioni a livello di bit}).
+
+
address@hidden
+L'interfaccia che rende possibile l'estensione dinamica @`e stata rifatta
+completamente
address@hidden
+(@pxrefil{Estensioni dinamiche}).
address@hidden iftex
address@hidden
+(@pxref{Estensioni dinamiche}).
address@hidden ifnottex
+
address@hidden
+La funzione @code{getline} ridiretta @`e stata resa possibile all'interno di
address@hidden ed @code{ENDFILE}
+(@pxref{BEGINFILE/ENDFILE}).
+
address@hidden
+Il comando @code{where} @`e stato aggiunto al debugger
+(@pxref{Stack di esecuzione}).
+
address@hidden
+Il supporto per Ultrix @`e stato rimosso.
+
address@hidden itemize
+
+La versione 4.2 ha introdotto le seguenti address@hidden:
+
address@hidden @bullet
address@hidden
+Differenze apportate alle variabili di ambiente (@code{ENVIRON}) sono riflesse
in quelle
+rese disponibili a @command{gawk} e in quelle di programmi che siano da esso
richiamati.
address@hidden auto-assegnate}.
+
address@hidden
+L'opzione @option{--pretty-print} non esegue address@hidden, dopo averlo
stampato,
+il programma @command{awk}.
address@hidden
+
address@hidden
+Il programma @command{igawk} e le relative pagine di manuale non sono
address@hidden installati come parte dell'installazione di @command{gawk}.
address@hidden igawk}.
+
address@hidden
+La funzione @code{intdiv()}.
address@hidden numeriche}.
+
address@hidden
+Il massimo numero di cifre esadecimali permesse nelle sequenze di
+protezione @samp{\x} @`e ora limitato a due.
address@hidden di protezione}.
+
address@hidden
address@hidden e @code{printf} non terminano il programma dopo alcuni
+errori di output.
address@hidden dopo errori}.
+
address@hidden
+Per molti anni, lo standard POSIX richiedeva che la separazione dei campi
+di un record fosse fatta per default
+quando si incontrano spazi e TAB, e questo @`e il comportamento di
address@hidden se si specifica l'opzione @option{--posix}. Dal 2013
+il comportamento originario @`e stato ripristinato, e ora
+il default per separare i campi con l'opzione @option{--posix} ammette
+anche il ritorno a capo come separatore di campi.
+
address@hidden
+Il supporto per MirBSD @`e stato rimosso.
+
address@hidden
+Il supporto per GNU/Linux sull'architettura Alpha @`e stato rimosso.
address@hidden itemize
+
address@hidden XXX ADD MORE STUFF HERE
address@hidden ifclear
+
address@hidden Estensioni comuni
address@hidden Sommario Estensioni Comuni
+
address@hidden estensioni, Brian Kernighan @command{awk}
address@hidden estensioni, @command{mawk}
+La tabella seguente dettaglia le estensioni comuni supportate
+da @command{gawk}, da Brian Kernighan @command{awk} e da @command{mawk},
+le tre versioni liberamente disponibili address@hidden usate di @command{awk}
+(@pxref{Altre versioni}).
+
address@hidden {File speciale @file{/dev/stderr}} {BWK @command{awk} }
address@hidden address@hidden {Standard attuale}
address@hidden address@hidden @tab BWK @command{awk} @tab @command{mawk} @tab
@command{gawk} @tab Standard attuale
address@hidden Sequenza di protezione @samp{\x} @tab X @tab X @tab X @tab
address@hidden Stringa nulla come @code{FS} @tab X @tab X @tab X @tab
address@hidden File speciale @file{/dev/stdin} @tab X @tab X @tab X @tab
address@hidden File speciale @file{/dev/stdout} @tab X @tab X @tab X @tab
address@hidden File speciale @file{/dev/stderr} @tab X @tab X @tab X @tab
address@hidden @code{delete} senza indici @tab X @tab X @tab X @tab X
address@hidden Funzione @code{fflush()} @tab X @tab X @tab X @tab X
address@hidden @code{length()} di un vettore @tab X @tab X @tab X @tab
address@hidden Istruzione @code{nextfile} @tab X @tab X @tab X @tab X
address@hidden Operatori @code{**} e @code{**=} @tab X @tab @tab X @tab
address@hidden Parola chiave @code{func} @tab X @tab @tab X @tab
address@hidden Variabile @code{BINMODE} @tab @tab X @tab X @tab
address@hidden @code{RS} come @dfn{regexp} @tab @tab X @tab X @tab
address@hidden Funzioni gestione data/ora @tab @tab X @tab X @tab
address@hidden multitable
+
address@hidden Intervalli e localizzazione
address@hidden Intervalli @dfn{regexp} e localizzazione: una lunga e triste
storia
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive la storia confusionaria degli intervalli
+all'interno di espressioni regolari, le loro relazioni con la localizzazione,
+e l'effetto da address@hidden determinato su diverse versioni di
@command{gawk}.
+
+Gli strumenti originali Unix aventi a che fare con espressioni regolari
+stabilivano che intervalli di caratteri (come @samp{[a-z]}) individuavano
+un carattere qualsiasi tra il primo carattere dell'intervallo e l'ultimo
+carattere dello stesso, entrambi inclusi. L'ordinamento era basato sul
+valore numerico di ogni carattere come era rappresentato all'interno
+del computer, nell'insieme di caratteri proprio di ogni macchina.
+Quindi, su sistemi che adottano la codifica ASCII, @samp{[a-z]} individua
+tutte le lettere minuscole, e solo
+quelle, in quanto i valori numerici che rappresentano le lettere dalla
address@hidden fino alla @samp{z} sono contigui. (In un sistema che adotta la
+codifica EBCDIC, l'intervallo @samp{[a-z]} comprende anche ulteriori
+caratteri non alfabetici.)
+
+Quasi tutti i testi di introduzione allo Unix spiegavano che le espressioni
+di intervallo funzionavano in questo modo, e in particolare insegnavano che
+la maniera ``corretta'' per individuare le lettere minuscole era con
address@hidden e che @samp{[A-Z]} era il modo ``corretto'' per individuare le
+lettere maiuscole.
+E, in effetti, era proprio address@hidden@address@hidden la vita era semplice.}
+
+Lo standard POSIX 1992 introduceva l'idea di localizzazione
+(@pxref{Localizzazioni}).
+Poich@'e molte localizzazioni comprendono altre lettere, oltre alle 26
+lettere dell'alfabeto inglese, lo standard POSIX introduceva le classi
+di carattere (@pxref{Espressioni tra parentesi quadre}) per permettere
+l'individuazione di differenti insiemi di caratteri, in aggiunta a quelli
+tradizionali presenti nell'insieme di caratteri ASCII.
+
+Tuttavia, lo standard @emph{ha modificato} l'interpretazione delle
+espressioni di intervallo.
+Nelle localizzazioni @code{"C"} e @code{"POSIX"},
+un'espressione di intervallo come
address@hidden @`e ancora equivalente a @samp{[abcdxyz]}, secondo l'ordine
+della codifica ASCII.
+Ma in tutte le altre localizzazioni l'ordinamento @`e basato su quel che
+si chiama @dfn{ordine di collazione}.
+
+Cosa vuol dire?
+In molte localizzazioni, le lettere @samp{A} e @samp{a} vengono entrambe
+prima di @samp{B}.
+In altre parole, queste localizzazioni ordinano i caratteri nel modo in cui
+sono ordinati in un dizionario,
+e @samp{[a-dx-z]} non @`e detto che equivalga a @samp{[abcdxyz]};
+invece, potrebbe essere equivalente a @samp{[ABCXYabcdxyz]}, per fare un
+esempio.
+
+Su questo punto @`e opportuno insistere: molta documentazione afferma che
+si dovrebbe usare @samp{[a-z]} per identificare un carattere minuscolo.
+Ma su sistemi con localizzazioni
+non-ASCII, un tale intervallo potrebbe includere tutti i caratteri maiuscoli
+tranne @samp{A} o @samp{Z}! Questo ha continuato a essere una fonte di
+equivoci perfino nel ventunesimo secolo.
+
+Per dare un'idea del tipo di problemi, l'esempio seguente usa la funzione
address@hidden()}, che effettua una sostituzione di testo all'interno di una
+stringa (@pxref{Funzioni per stringhe}). Qui, l'idea @`e quella di rimuovere
+i caratteri maiuscoli a fine stringa:
+
address@hidden
+$ @kbd{echo qualcosa1234abc | gawk-3.1.8 '@{ sub("[A-Z]*$", ""); print @}'}
address@hidden qualcosa1234a
address@hidden example
+
address@hidden
+Questo non @`e l'output che ci si aspettava, perch@'e, il @samp{bc} alla fine
di
address@hidden non dovrebbe essere individuato da @samp{[A-Z]*}.
+Un tale risultato dipende dalle impostazioni di localizzazione (e quindi
+potrebbe non succedere sul sistema che si sta usando).
+
address@hidden Unicode
+Considerazioni simili valgono per altri intervalli. Per esempio, @samp{["-/]}
address@hidden perfettamente valido in ASCII, ma non @`e valido in molte
localizzazioni
+Unicode, p.es. in @code{en_US.UTF-8}.
+
+Il codice delle prime versioni di @command{gawk} per individuare le
address@hidden non teneva conto della localizzazione, e quindi gli
+intervalli potevano essere interpretati in maniera tradizionale.
+
+Quando @command{gawk} ha iniziato a usare metodi di ricerca di @dfn{regexp}
+che tengono conto della localizzazione, sono iniziati i problemi;
+a maggior ragione in quanto sia GNU/Linux che i venditori di versioni
+commerciali di Unix
+avevano iniziato a implementare localizzazioni non-ASCII,
address@hidden per default}. La domanda che forse si udiva address@hidden
spesso
+era del tipo: ``Perch@'e @samp{[A-Z]} individua lettere minuscole?!?''
+
address@hidden Berry, Karl
+Questa situazione @`e in essere da circa 10 anni, se non di address@hidden, e
+il manutentore di @command{gawk} si @`e stufato di continuare a spiegare che
address@hidden stava semplicemente implementando quelli che sono gli
+standard, e che il problema stava nella localizzazione dell'utente. Nella
+fase di sviluppo della @value{PVERSION} 4.0, @command{gawk} @`e stato
modificato
+in modo da trattare sempre gli
+intervalli "come si faceva prima di POSIX", a meno che non si specifichi
+l'opzione @option{--posix} (@pxref{Opzioni})address@hidden
address@hidden address@hidden@dotless{i}} che @`e nata la Campagna per
l'Interpretazione Razionale degli
+Intervalli (in inglese, RRI address@hidden Range Interpretation}]).
+Un certo
+numero di strumenti GNU hanno address@hidden implementato questa modifica, o
+lo faranno presto. Grazie a Karl Berry per aver coniato la frase
+``Rational Range Interpretation''.}
+
+Fortunatamente, un po' prima del rilascio definitivo della versione 4.0 di
address@hidden, il manutentore ha appreso che lo standard 2008 aveva
+modificato la definizione di intervallo, e che, al di fuori delle
+localizzazioni @code{"C"} e @code{"POSIX"}, il significato di espressione
+di intervallo era ora
address@hidden@footnote{Si veda
address@hidden://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_03_05,
lo standard}
+e
address@hidden://pubs.opengroup.org/onlinepubs/9699919799/xrat/V4_xbd_chap09.html#tag_21_09_03_05,
le motivazioni}.}
+
+Adottando questo simpatico termine tecnico, lo standard permette agli
+implementatori di implementare gli intervalli nella maniera che preferiscono.
+Il manutentore di @command{gawk} ha deciso di implementare la regola pre-POSIX
+sia per l'individuazione di default delle @dfn{regexp} sia quando si
+specificano le opzioni @option{--traditional} o @option{--posix}.
+In ogni caso @command{gawk} aderisce allo standard POSIX.
+
address@hidden Contributori
address@hidden I principali contributori a @command{gawk}
address@hidden @command{gawk}, lista di contributori a
address@hidden
address@hidden sempre il merito, se un merito va riconosciuto.}
address@hidden Anonimo
address@hidden quotation
+
+Questa @value{SECTION} elenca le persone che hanno maggiormente contribuito
+allo sviluppo di @command{gawk} e/o alla stesura di questo @value{DOCUMENT},
+in ordine approssimativamente cronologico:
+
address@hidden @value{BULLET}
address@hidden
address@hidden Aho, Alfred
address@hidden Weinberger, Peter
address@hidden Kernighan, Brian
+Il Dr.@: Alfred V.@: Aho,
+il Dr.@: Peter J.@: Weinberger, e
+il Dr.@: Brian W.@: Kernighan, tutti dei Bell Laboratories,
+hanno progettato e implementato @command{awk} per Unix,
+da cui @command{gawk} trae la maggioranza delle sue address@hidden
+
address@hidden
address@hidden Rubin, Paul
+Paul Rubin,
+autore del progetto e dell'implementazione iniziale del 1986, ha
+scritto la prima bozza (di circa 40 pagine) di questo @value{DOCUMENT}.
+
address@hidden
address@hidden Fenlason, Jay
+Jay Fenlason
+ha completato l'implementazione iniziale.
+
address@hidden
address@hidden Close, Diane
+Diane Close
+ha rivisto la prima bozza di questo @value{DOCUMENT}, portandolo alla
+lunghezza di circa 90 pagine.
+
address@hidden
address@hidden Stallman, Richard
+Richard Stallman
+ha aiutato a completare l'implementazione e la bozza iniziale di questo
address@hidden
address@hidden anche il fondatore della FSF e del progetto GNU.
+
address@hidden
address@hidden Woods, John
+John Woods
+ha scritto porzioni di codice (volti principalmente alla correzione di
+errori) nella versione iniziale di @command{gawk}.
+
address@hidden
address@hidden Trueman, David
+Nel 1988,
+David Trueman
+si @`e fatto carico della manutenzione principale di @command{gawk},
+rendendolo compatibile col ``nuovo'' @command{awk} e
+migliorandone parecchio la address@hidden di esecuzione.
+
address@hidden
address@hidden Kwok, Conrad
address@hidden Garfinkle, Scott
address@hidden Williams, Kent
+Conrad Kwok,
+Scott Garfinkle
+e
+Kent Williams
+hanno per primi portato il programma all'ambiente MS-DOS, usando varie
+versioni del compilatore MSC.
+
address@hidden
address@hidden Rankin, Pat
+Pat Rankin
+ha portato il programma all'ambiente VMS, preparando anche la relativa
+documentazione.
+
address@hidden
address@hidden Peterson, Hal
+Hal Peterson
address@hidden stato di aiuto nel portare @command{gawk} nei sistemy Cray.
+(L'ambiente Cray non @`e address@hidden supportato.)
+
address@hidden
address@hidden Rommel, Kai Uwe
+Kai Uwe Rommel
+ha portato per primo il programma all'ambiente OS/2, preparando anche
+la relativa documentazione.
+
address@hidden
address@hidden Jaegermann, Michal
+Michal Jaegermann
+ha portato il programma all'ambiente Atari, preparando anche la relativa
+documentazione.
+(L'ambiente Atari non @`e address@hidden supportato.)
+Michal continua a effettuare controlli di address@hidden,
+e ha molto contribuito a consentire a @command{gawk}
+di funzionare su sistemi diversi da quelli a 32 bit.
+
address@hidden
address@hidden Fish, Fred
+Fred Fish
+ha portato il programma all'ambiente Amiga, preparando anche la relativa
+documentazione.
+(Purtroppo Fred non @`e address@hidden tra noi, e questo ambiente non @`e
address@hidden supportato.)
+
address@hidden
address@hidden Deifik, Scott
+Scott Deifik
+si @`e occupato della manutenzione per MS-DOS usando il compilatore DJGPP.
+
address@hidden
address@hidden Zaretskii, Eli
+Eli Zaretskii
+si occupa della manutenzione della versione per MS-Windows, nell'ambiente
+MinGW.
+
address@hidden
address@hidden Grigera, Juan
+Juan Grigera
address@hidden autore di una versione di @command{gawk} per sistemi Windows32.
+(Questa versione non @`e address@hidden supportata.)
+
address@hidden
address@hidden Hankerson, Darrel
+Per molti anni, il
+Dr.@: Darrel Hankerson
+ha fatto da coordinatore per le varie versioni che giravano su diverse
+piattaforme PC e ha creato distribuzioni binarie per vari sistemi operativi
+che girano sui PC.
+Il suo aiuto @`e stato importante per mantenere aggiornata la documentazione
+per le diverse piattaforme PC.
+
address@hidden
address@hidden Zoulas, Christos
+Christos Zoulas
+ha scritto la funzione predefinita @code{extension()} per aggiungere
+dinamicamente nuove funzioni.
+(Questa address@hidden @`e divenuta obsoleta a partire da @command{gawk} 4.1.)
+
address@hidden
address@hidden Kahrs, J@"urgen
+J@"urgen Kahrs
+ha scritto la prima versione del codice per interagire con la rete
+TCP/IP, con la relativa documentazione, e fornito le ragioni per l'aggiunta
+dell'operatore @samp{|&}.
+
address@hidden
address@hidden Davies, Stephen
+Stephen Davies
+ha portato per la prima volta il programma all'ambiente Tandem, preparando
+anche la relativa documentazione.
+(Tuttavia, questa versione non @`e address@hidden supportata.)
+Stephen @`e anche stato determinante nel lavoro iniziale per integrare il
codice
+interno di gestione dei byte nel
+complesso del codice di @command{gawk}.
+
address@hidden
address@hidden Woehlke, Matthew
+Matthew Woehlke
+ha migliorato l'aderenza allo standard POSIX nei sistemi Tandem che
+implementano lo standard.
+
address@hidden
address@hidden Brown, Martin
+Martin Brown
+ha portato il programma all'ambiente BeOS, preparando anche la relativa
+documentazione.
+(L'ambiente BeOS non @`e address@hidden supportato.)
+
address@hidden
address@hidden Peters, Arno
+Arno Peters
+ha fatto il lavoro iniziale necessario per consentire alla configurazione
+di @command{gawk} di usare GNU Automake e GNU @command{gettext}.
+
address@hidden
address@hidden Broder, Alan J.@:
+Alan J.@: Broder
+ha scritto la prima versione della funzione @code{asort()} e anche
+il codice per gestire il terzo argomento opzionale della funzione
address@hidden()}.
+
address@hidden
address@hidden Buening, Andreas
+Andreas Buening
+ha aggiornato la versione di @command{gawk} per OS/2.
+
address@hidden
address@hidden Hasegawa, Isamu
+Isamu Hasegawa,
+dell'IBM in Giappone, ha contribuito con il supporto per i caratteri multibyte.
+
address@hidden
address@hidden Benzinger, Michael
+Michael Benzinger ha sviluppato il codice iniziale per l'istruzione
address@hidden
+
address@hidden
address@hidden McPhee, Patrick
+Patrick T.J.@: McPhee ha sviluppato il codice per il caricamento
+dinamico negli ambienti Windows32.
+(Questa address@hidden non @`e address@hidden supportata.)
+
address@hidden
address@hidden Wallin, Anders
+Anders Wallin ha aiutato a continuare il supporto della versione VMS
+di @command{gawk} per parecchi anni.
+
address@hidden
address@hidden Gordon, Assaf
+Assaf Gordon ha scritto il codice per implementare
+l'opzione @option{--sandbox}.
+
address@hidden
address@hidden Haque, John
+John Haque @`e autore dei seguenti contributi:
+
address@hidden @value{MINUS}
address@hidden
+Le modifiche per convertire @command{gawk}
+in un interprete di codice a livello di byte, compreso il debugger
+
address@hidden
+L'aggiunta di veri vettori di vettori
+
address@hidden
+Le modifiche ulteriori per il supporto del calcolo a precisione
+arbitraria
+
address@hidden
+Il testo iniziale di
address@hidden con precisione arbitraria}
+
address@hidden
+Il lavoro per unificare le tre varianti del programma @command{gawk},
+in vista della versione 4.1
+
address@hidden
+I miglioramenti alla gestione interna dei vettori per i vettori i cui
+indici sono dei numeri interi
+
address@hidden
+A John, insieme a Pat Rankin, si devono i miglioramenti alla address@hidden
+di ordinamento dei vettori.
address@hidden itemize
+
address@hidden Papadopoulos, Panos
address@hidden
+Panos Papadopoulos ha scritto il testo originale per
address@hidden file}.
+
address@hidden
address@hidden Yawitz, Efraim
+Efraim Yawitz ha scritto il testo originale per il @ref{Debugger}.
+
address@hidden
address@hidden Schorr, Andrew
+Lo sviluppo dell'estensione API rilasciata per la prima volta con
address@hidden 4.1 @`e stata principalmente guidata da
+Arnold Robbins e Andrew Schorr, con notevoli contributi dal
+resto del team di sviluppo.
+
address@hidden Malmberg, John E.
address@hidden
+John Malmberg ha apportato miglioramenti significativi alla versione
+OpenVMS e alla relativa documentazione.
+
address@hidden
address@hidden Colombo, Antonio
+Antonio Giovanni Colombo ha riscritto diversi esempi, che non erano
address@hidden
+attuali, contenuti nei primi capitoli, e gliene sono estremamente grato.
+
address@hidden
address@hidden Robbins, Arnold
+Arnold Robbins
+ha lavorato su @command{gawk} dal 1988, dapprima
+aiutando David Trueman e in seguito, dal 1994 circa, come
+manutentore principale.
address@hidden itemize
+
address@hidden Sommario della storia
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Il linguaggio @command{awk} si @`e evoluto col passare degli anni. La prima
+versione risale a Unix V7, circa 1978. Nel 1987, per la versione Unix
+System V Release 3.1, sono state fatte al linguaggio delle modifiche
+importanti, inclusa la address@hidden di avere funzioni definite dall'utente.
+Ulteriori modifiche sono state fatte per la versione System V Release 4, nel
+1989.
+Dopo di allora, sono state apportate ulteriori modifiche minori,
+per implementare lo standard POSIX.
+
address@hidden
+L'@command{awk} di Brian Kernighan prevede un piccolo numero di estensioni
+implementate di comune accordo con altre versioni di @command{awk}.
+
address@hidden
address@hidden prevede un elevato numero di estensioni rispetto
+a POSIX @command{awk}.
+Queste estensioni possono essere disabilitate specificando l'opzione
address@hidden o @option{--posix}.
+
address@hidden
+L'interazione tra localizzazioni POSIX e individuazione di @dfn{regexp}
+in @command{gawk} @`e stata causa di malintesi nel corso degli anni. Oggi
address@hidden implementa l'Interpretazione Razionale degli Intervalli
+(@dfn{Rational Range Interpretation}), dove
+intervalli nella forma @samp{[a-z]} individuano @emph{solo} i caratteri
+numericamente compresi tra
address@hidden e @samp{z} nella rappresentazione nativa dei caratteri in quella
+particolare macchina. Normalmente quella in uso @`e quella ASCII,
+ma address@hidden essere EBCDIC sui sistemi IBM S/390.
+
address@hidden
+Molte persone hanno contribuito allo sviluppo di @command{gawk} nel corso
+degli anni. Spero che l'elenco fornito in questo @value{CHAPTER} sia
+esauriente e attribuisca il giusto riconoscimento quando questo @`e dovuto.
+
address@hidden itemize
+
address@hidden Installazione
address@hidden Installare @command{gawk}
+
address@hidden last two commas are part of see also
address@hidden sistemi operativi, si veda anche GNU/address@hidden sistemi
operativi per address@hidden Unix
address@hidden @command{gawk}, installare
address@hidden installare @command{gawk}
+Quest'appendice contiene istruzioni per installare @command{gawk} sulle
+varie piattaforme supportate dagli sviluppatori. Lo sviluppatore
+principale supporta GNU/Linux (e Unix), mentre le altre piattaforme sono
+sono curate da altri sviluppatori.
address@hidden
+per gli indirizzi di posta elettronica di chi effettua la manutenzione
+della versione specifica di una particolare piattaforma.
+
address@hidden
+* Distribuzione di Gawk:: Contenuto della distribuzione di @command{gawk}.
+* Installazione Unix:: Installare @command{gawk} su varie versioni
+ di Unix.
+* Installazione non-Unix:: Installazioni su altri Sistemi Operativi.
+* Bug:: Notificare problemi e bug.
+* Altre versioni:: Altre implementazioni di @command{awk}
+ liberamente disponibili.
+* Sommario dell'installazione:: Sommario dell'installazione.
address@hidden menu
+
address@hidden Distribuzione di Gawk
address@hidden La distribuzione di @command{gawk}
address@hidden codice sorgente di @command{gawk}
address@hidden sorgente, codice, @command{gawk}
+
+Questa @value{SECTION} spiega come ottenere la distribuzione
+di @command{gawk}, come scompattarla, e cosa @`e contenuto nei vari file
+e nelle sottodirectory risultanti.
+
address@hidden
+* Scaricare:: Come ottenere la distribuzione.
+* Scompattazione:: Come estrarre la distribuzione.
+* Contenuti della distribuzione:: Cosa c'@`e nella distribuzione.
address@hidden menu
+
address@hidden Scaricare
address@hidden Ottenere la distribuzione di @command{gawk}
address@hidden @command{gawk}, codice address@hidden ottenere il
address@hidden codice sorgente di @command{gawk}, ottenere il
+Ci sono due modi per ottenere del software GNU:
+
address@hidden @value{BULLET}
address@hidden
+Copiarlo da qualcuno che ce l'abbia address@hidden
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden
+Ottenere @command{gawk}
+dal sito Internet
address@hidden, nella directory @file{/gnu/gawk}.
address@hidden possibile accedere al sito sia via @command{ftp} anonimo che via
@code{http}.
+Se si dispone del programma @command{wget}, si address@hidden utilizzarlo
digitando un
+comando simile a questo:
+
address@hidden
+wget http://ftp.gnu.org/gnu/gawk/address@hidden@value{PATCHLEVEL}.tar.gz
address@hidden example
address@hidden itemize
+
+L'archivio che contiene il software GNU @`e disponibile in vari cloni
+(@dfn{mirror}) in tutto il mondo.
+La lista aggiornata dei siti clone @`e disponibile nel
address@hidden://www.gnu.org/order/ftp.html, sito web principale della FSF}.
+Si tenti di usare uno dei siti-clone; dovrebbero essere meno trafficati, ed @`e
+possibile che ce ne sia uno address@hidden vicino.
+
+Si address@hidden anche scaricare la distribuzione del sorgente di
@command{gawk}
+dal deposito Git ufficiale; per maggiori informazioni, si veda
address@hidden ai sorgenti}.
+
address@hidden Scompattazione
address@hidden Scompattare la distribuzione
address@hidden @`e distribuito sotto forma di parecchi file @code{tar}
+compressi con differenti programmi di compressione: @command{gzip},
address@hidden
+e @command{xz}. Per amor di address@hidden, il resto di queste istruzioni
+presuppone che si stia usando quella compressa col programma GNU Gzip
+(@command{gzip}).
+
+Una volta che si ha a disposizione la distribuzione (p.es.,
address@hidden@address@hidden),
+va usato @code{gzip} per scompattare il file e quindi @code{tar} per estrarne i
+file. Si address@hidden usare la seguente @dfn{pipe} per produrre la
distribuzione
address@hidden:
+
address@hidden
+gzip -d -c address@hidden@value{PATCHLEVEL}.tar.gz | tar -xvpf -
address@hidden example
+
+In un sistema che abbia la versione GNU di @command{tar}, si
address@hidden far effettuare la scompattazione direttamente a @command{tar}:
+
address@hidden
+tar -xvpzf address@hidden@value{PATCHLEVEL}.tar.gz
address@hidden example
+
address@hidden
+L'estrazione dei file dall'archivio
+crea una directory di nome @address@hidden@value{PATCHLEVEL}}
+nella directory corrente.
+
+Il @value{FN} della distribuzione @`e nella forma
address@hidden@address@hidden@var{P}.tar.gz}.
+La @var{V} rappresenta la versione maggiore di @command{gawk},
+la @var{R} rappresenta il rilascio corrente della versione @var{V}, e
+la @var{P} rappresenta un @dfn{patch level}, che sta a indicare che
+correzioni a errori minori sono state incluse nel rilascio.
+Il @dfn{patch level} corrente @`e @value{PATCHLEVEL}, ma quando ci si procura
+una distribuzione, address@hidden ottenuta quella con il livello
address@hidden alto di
+versione, rilascio e @dfn{patch}.
+(Si noti, comunque, che livelli di @dfn{patch} maggiori o uguali a 70
+denotano versioni ``beta'', ossia versioni non destinate a essere usate
+in produzione; non si dovrebbero utilizzare tali versioni, se non si @`e
+disposti a sperimentare.)
+Se non si sta usando un sistema Unix o GNU/Linux, i modi per ottenere
+e scompattare la distribuzione di @command{gawk} sono differenti.
+Si dovrebbe sentire un esperto di quel sistema.
+
address@hidden Contenuti della distribuzione
address@hidden Contenuti della distribuzione @command{gawk}
address@hidden @command{gawk}, distribuzione di
address@hidden distribuzione di @command{gawk}
+
+La distribuzione di @command{gawk} contiene un certo numero di file
+sorgente in C, di file di documentazione, di sottodirectory, e di file
+utilizzati durante il processo di configurazione
+(@pxref{Installazione Unix}),
+come pure parecchie sottodirectory relative a diversi sistemi operativi
+non-Unix:
+
address@hidden @asis
address@hidden Vari file @samp{.c}, @samp{.y} e @samp{.h}
+Questi file contengono il codice sorgente vero e proprio di @command{gawk}.
address@hidden table
+
address@hidden @file
address@hidden support/*
+Intestazioni C e file sorgente per routine che @command{gawk}
+usa, ma che non sono parte della sua address@hidden
+fondamentale. Per esempio, analisi di argomenti, controlli
+di corrispondenze di espressioni regolari, e routine per
+generare numeri casuali sono tutti mantenuti qui.
+
address@hidden ABOUT-NLS
+Un file contenente informazioni sul comando GNU @command{gettext} e
+sulle traduzioni.
+
address@hidden AUTHORS
+Un file con alcune informazioni su chi ha scritto @command{gawk}.
+Esiste solo per placare i pedanti della Free Software Foundation.
+
address@hidden README
address@hidden README_d/README.*
+File descrittivi: vari @file{README} ("leggimi") per @command{gawk} sotto Unix
e per
+tutte le varie altre combinazioni hardware e software.
+
address@hidden INSTALL
+Un file che fornisce una panoramica sul processo di configurazione e
installazione.
+
address@hidden ChangeLog
+Una lista dettagliata delle modifiche apportate al codice sorgente,
+ai problemi risolti e ai miglioramenti introdotti.
+
address@hidden ChangeLog.0
+Una lista meno recente di modifiche al codice sorgente.
+
address@hidden NEWS
+Una lista di modifiche a @command{gawk} a partire dall'ultimo rilascio
+o @dfn{patch}.
+
address@hidden NEWS.0
+Una lista meno recente di modifiche a @command{gawk}.
+
address@hidden COPYING
+La @dfn{GNU General Public License}.
+
address@hidden POSIX.STD
+Una descrizione di comportamenti nello standard POSIX per @command{awk} che
+sono lasciati indefiniti, o ai quali @command{gawk} non address@hidden
conformarsi
+pienamente, come pure una lista di specifiche che lo standard POSIX dovrebbe
+contenere, ma che non sono presenti.
+
address@hidden intelligenza artificiale, @command{gawk} e
address@hidden @command{gawk} e l'intelligenza artificiale
address@hidden doc/awkforai.txt
+Puntatori alla bozza originale di un breve articolo
+che spiega perch@'e @command{gawk} @`e un linguaggio adatto alla
+programmazione nel campo dell'intelligenza artificiale (AI).
+
address@hidden doc/bc_notes
+Una breve descrizione della struttura interna a livello di byte di
address@hidden [``byte code''].
+
address@hidden doc/README.card
address@hidden doc/ad.block
address@hidden doc/awkcard.in
address@hidden doc/cardfonts
address@hidden doc/colors
address@hidden doc/macros
address@hidden doc/no.colors
address@hidden doc/setter.outline
+Il sorgente @command{troff} per una scheda di riferimento a cinque colori
+di @command{awk}.
+Per ottenere la versione a colori @`e richiesta una versione recente di
address@hidden, come la versione GNU di @command{troff} (@command{groff}).
+Si veda il file @file{README.card} per istruzioni su come comportarsi se @`e
+disponibile solo una versione address@hidden vecchia di @command{troff}.
+
address@hidden doc/gawk.1
+Il sorgente @command{troff} di una pagina di manuale address@hidden
+che descrive @command{gawk}.
+Questa pagina @`e distribuita a beneficio degli utenti Unix.
+
address@hidden Texinfo
address@hidden doc/gawktexi.in
address@hidden doc/sidebar.awk
+Il file sorgente Texinfo di questo @value{DOCUMENT}.
+Dovrebbe venire elaborato da @file{doc/sidebar.awk}
+prima di essere elaborato con @command{texi2dvi} o @command{texi2pdf}
+per produrre un documento stampato, o
+con @command{makeinfo} per produrre un file Info o HTML.
+Il @file{Makefile} si occupa di questa elaborazione e produce
+la versione stampabile tramite i comandi
address@hidden o @command{texi2pdf}.
+
address@hidden doc/gawk.texi
+Il file prodotto elaborando @file{gawktexi.in}
+tramite @file{sidebar.awk}.
+
address@hidden doc/gawk.info
+Il file Info generato per questo @value{DOCUMENT}.
+
address@hidden doc/gawkinet.texi
+Il file sorgente Texinfo per
address@hidden
address@hidden, , Introduzione generale, gawkinet, @value{GAWKINETTITLE}}.
address@hidden ifinfo
address@hidden
address@hidden@value{GAWKINETTITLE}}.
address@hidden ifnotinfo
+Dovrebbe venire elaborato con @TeX{}
+(tramite @command{texi2dvi} o @command{texi2pdf})
+per produrre un documento stampato o
+con @command{makeinfo} per produrre un file Info o HTML.
+
address@hidden doc/gawkinet.info
+Il file Info generato per
address@hidden@value{GAWKINETTITLE}}.
+
address@hidden doc/igawk.1
+Il sorgente @command{troff} per una pagina di manuale relativa al
+programma @command{igawk} descritto
address@hidden
+in
address@hidden ifnottex
address@hidden
+nella
address@hidden iftex
address@hidden igawk}.
+(Poich@'e @command{gawk} prevede ora internamente l'uso della direttiva
address@hidden@@include},
+n@'e @command{igawk} n@'e @file{igawk.1} sono effettivamente installati.)
+
address@hidden doc/Makefile.in
+Il file in input usato durante la procedura di configurazione per
+generare l'effettivo @file{Makefile} da usare per creare la documentazione.
+
address@hidden Makefile.am
address@hidden */Makefile.am
+File usati dal software GNU Automake per generare
+il file @file{Makefile.in} usato da Autoconf e dallo script
address@hidden
+
address@hidden Makefile.in
address@hidden aclocal.m4
address@hidden bisonfix.awk
address@hidden config.guess
address@hidden configh.in
address@hidden configure.ac
address@hidden configure
address@hidden custom.h
address@hidden depcomp
address@hidden install-sh
address@hidden missing_d/*
address@hidden mkinstalldirs
address@hidden m4/*
+Questi file e sottodirectory sono usati per configurare e compilare
address@hidden per vari sistemi Unix. L'uso di molti tra questi file @`e
spiegato
address@hidden
+nella
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden Unix}. I rimanenti hanno una funzione di supporto
+per l'infrastruttura.
+
address@hidden po/*
+La directory @file{po} contiene la traduzione in varie lingue
+dei messaggi emessi da @command{gawk}.
+
address@hidden awklib/extract.awk
address@hidden awklib/Makefile.am
address@hidden awklib/Makefile.in
address@hidden awklib/eg/*
+La directory @file{awklib} contiene una copia di @file{extract.awk}
+(@pxref{Programma extract}),
+che address@hidden essere usato per estrarre i programmi di esempio dal file
sorgente
+Texinfo di questo @value{DOCUMENT}. Contiene anche un file
address@hidden, che
address@hidden usa per generare un @file{Makefile}.
address@hidden @`e usato da GNU Automake per creare @file{Makefile.in}.
+Le funzioni di libreria descritte
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden di libreria},
+sono incluse come file pronti per l'uso nella distribuzione @command{gawk}.
+Essi sono installati come parte della procedura di installazione.
+I rimanenti programmi contenuti in questo @value{DOCUMENT} sono disponibili
+nelle appropriate sottodirectory di @file{awklib/eg}.
+
address@hidden extension/*
+Il codice sorgente, le pagine di manuale, e i file di infrastruttura per
+gli esempi di estensione incluse con @command{gawk}.
address@hidden dinamiche}, per ulteriori dettagli.
+
address@hidden extras/*
+Ulteriori file, non-essenziali. Al momento, questa directory contiene
+alcuni file da eseguire al momento di iniziare una sessione,
+da installare nella directory @file{/etc/profile.d}
+per essere di aiuto nella gestione delle variabili di ambiente
address@hidden e @env{AWKLIBPATH}.
address@hidden da usare a inizio sessione}, per ulteriori informazioni.
+
address@hidden posix/*
+File necessari per compilare @command{gawk} su sistemi conformi allo
+standard POSIX.
+
address@hidden pc/*
+File necessari per compilare @command{gawk} sotto MS-Windows
+(@pxref{Installazione su PC} per i dettagli).
+
address@hidden vms/*
+File necessari per compilare @command{gawk} sotto Vax/VMS e OpenVMS
+(@pxref{Installazione su VMS} per i dettagli).
+
address@hidden test/*
+Una serie di test per
address@hidden Si address@hidden usare @samp{make check} dalla directory
principale
+di @command{gawk} per provare se la serie di test funziona con la
+versione in uso di @command{gawk}.
+Se @command{gawk} supera senza errori @samp{make check}, si address@hidden
essere
+sicuri che sia stato installato e configurato correttamente su un dato
+sistema.
address@hidden table
+
address@hidden Installazione Unix
address@hidden Compilare e installare @command{gawk} su sistemi di tipo Unix
+
+Normalmente, si address@hidden compilare e installare @command{gawk} immettendo
+solo un paio di comandi. Comunque, se si ci si trova in un sistema
+insolito, address@hidden essere necessario
+dover configurare @command{gawk} per quel dato sistema.
+
address@hidden
+* Installazione veloce:: Compilare @command{gawk} sotto Unix.
+* File da usare a inizio sessione:: Funzioni di personalizzazione della
+ shell.
+* Ulteriori opzioni di configurazione:: Altre opzioni utilizzabili in fase di
+ compilazione.
+* Filosofia della configurazione:: Come si suppone che tutto funzioni.
address@hidden menu
+
address@hidden Installazione veloce
address@hidden Compilare @command{gawk} per sistemi di tipo Unix
+
+Questi normali passi di installazione dovrebbero essere sufficienti in
+tutti i moderni sistemi in commercio derivati da Unix, ossia
+GNU/Linux, sistemi basati su BSD, e l'ambiente Cygwin sotto MS-Windows.
+
+Dopo aver estratto la distribuzione di @command{gawk}, posizionarsi con
address@hidden nella directory
address@hidden@address@hidden Come per la maggior parte dei
+programmi GNU, occorre configurare @command{gawk} per il sistema in uso,
+eseguendo il programma @command{configure}. Questo programma @`e
+uno script della shell Bourne, che @`e stato generato automaticamente
+usando il comando GNU Autoconf.
address@hidden
+(Il software Autoconf @`e
+descritto in dettaglio in
address@hidden Automatic Configuration Scripts},
+che address@hidden essere trovato in rete sul sito
address@hidden://www.gnu.org/software/autoconf/manual/index.html,
+della Free Software Foundation}.)
address@hidden ifnotinfo
address@hidden
+(Il software Autoconf @`e descritto in dettaglio a partire da
address@hidden, , Autoconf, autoconf,Autoconf---Generating Automatic
Configuration Scripts}.)
address@hidden ifinfo
+
+Per configurare @command{gawk} basta eseguire @command{configure}:
+
address@hidden
+sh ./configure
address@hidden example
+
+Questo produce i file @file{Makefile} e @file{config.h} adatti al sistema
+in uso.
+Il file @file{config.h} descrive varie situazioni relative al sistema in uso.
address@hidden possibile modificare il @file{Makefile} per
+cambiare la variabile @code{CFLAGS}, che controlla
+le opzioni di riga di comando da passare al compilatore C (come i livelli
+di ottimizzazione o la richiesta di generare informazioni per il @dfn{debug}).
+
+In alternativa, si possono specificare dei valori a piacere per
+molte delle variabili di @command{make} sulla riga di comando,
+come @code{CC} e @code{CFLAGS}, quando
+ si chiama il programma
address@hidden:
+
address@hidden
+CC=cc CFLAGS=-g sh ./configure
address@hidden example
+
address@hidden
+Si veda il file @file{INSTALL} nella distribuzione di @command{gawk} per
+tutti i dettagli.
+
+Dopo aver eseguito @command{configure} ed eventualmente modificato
address@hidden,
+va dato il comando:
+
address@hidden
+make
address@hidden example
+
address@hidden
+Poco dopo, si dovrebbe avere a disposizione una versione eseguibile
+di @command{gawk}.
+Questo @`e tutto!
+Per verificare se @command{gawk} funziona correttamente,
+va dato il comando @samp{make check}. Tutti i test dovrebbero terminare con
+successo.
+Se questi passi non producono il risultato desiderato, o se qualche
+test fallisce, controllare i file nella directory @file{README_d}
+per determinare se quello che @`e capitato @`e un problema noto.
+Se il problema capitato non @`e descritto address@hidden@dotless{i}},
+inviare una segnalazione di @dfn{bug} (@pxref{Bug}).
+
+Naturalmente, dopo aver compilato @command{gawk}, verosimilmente
address@hidden installato. Per fare address@hidden, occorre eseguire il comando
address@hidden install}, disponendo delle autorizzazioni necessarie.
+Come acquisirle varia da sistema a sistema, ma su molti sistemi si
address@hidden
+usare il comando @command{sudo} per ottenerle. Il comando da immettere
+diventa in questo caso @samp{sudo make install}. @`E probabile che sia
+necessario fornire una password, ed essere stati messi nella lista degli
+utenti che possono utilizzare il comando @command{sudo}.
+
address@hidden File da usare a inizio sessione
address@hidden File di inizializzazione della shell
+
+La distribuzione contiene i file da usare a inizio sessione
address@hidden e
address@hidden, che contengono funzioni che possono essere di aiuto
+nel gestire le variabili di ambiente
address@hidden e @env{AWKLIBPATH}.
+Su un sistema Fedora GNU/Linux, questi file dovrebbero essere installati
+nella directory @file{/etc/profile.d};
+su altre piattaforme, la posizione corretta address@hidden essere differente.
+
address@hidden @command
+
address@hidden @command{gawkpath_default}, funzione della shell
address@hidden funzione della shell @command{gawkpath_default}
address@hidden gawkpath_default
+Ripristina la variabile d'ambiente @env{AWKPATH} al suo valore di default.
+
address@hidden @command{gawkpath_prepend}, funzione della shell
address@hidden funzione della shell @command{gawkpath_prepend}
address@hidden gawkpath_prepend
+Aggiunge l'argomento all'inizio della variabile d'ambiente @env{AWKPATH}.
+
address@hidden @command{gawkpath_append}, funzione della shell
address@hidden funzione della shell @command{gawkpath_append}
address@hidden gawkpath_append
+Aggiunge l'argomento alla fine della variabile d'ambiente @env{AWKPATH}.
+
address@hidden @command{gawklibpath_default}, funzione della shell
address@hidden funzione della shell @command{gawklibpath_default}
address@hidden gawklibpath_default
+Reimposta la variabile d'ambiente @env{AWKLIBPATH} al suo valore di default.
+
address@hidden @command{gawklibpath_prepend}, funzione della shell
address@hidden funzione della shell @command{gawklibpath_prepend}
address@hidden gawklibpath_prepend
+Aggiunge l'argomento all'inizio della variabile d'ambiente
address@hidden
+
address@hidden @command{gawklibpath_append}, funzione della shell
address@hidden funzione della shell @command{gawklibpath_append}
address@hidden gawklibpath_append
+Aggiunge l'argomento alla fine della variabile d'ambiente
address@hidden
+
address@hidden table
+
+
address@hidden Ulteriori opzioni di configurazione
address@hidden Ulteriori opzioni di configurazione
address@hidden @command{gawk}, configurazione, opzioni di
address@hidden configurazione di @command{gawk}, opzioni di
+
+Ci sono parecchie altre opzioni che si possono utilizzare sulla riga
+di comando di @command{configure}
+quando si compila @command{gawk} a partire dai sorgenti, tra cui:
+
address@hidden @code
+
address@hidden @option{--disable-extensions}, opzione di configurazione
address@hidden opzione di configurazione @code{--disable-extensions}
address@hidden --disable-extensions
+Richiede di non configurare e generare le estensioni di esempio nella
+directory @file{extension}. Questo @`e utile quando si genera
address@hidden per essere eseguito su un'altra piattaforma.
+L'azione di default @`e di controllare dinamicamente se le estensioni
+possono essere configurate e compilate.
+
address@hidden @option{--disable-lint}, opzione di configurazione
address@hidden opzione di configurazione @code{--disable-lint}
address@hidden --disable-lint
+Disabilita i controlli @dfn{lint} all'interno di @command{gawk}. Le opzioni
address@hidden e @option{--lint-old}
+(@pxref{Opzioni})
+sono accettate, ma non fanno nulla, e non emettono alcun messaggio di
+avvertimento.
+Analogamente, se si imposta la variabile @code{LINT}
+(@pxref{Variabili modificabili dall'utente})
+questa non ha alcun effetto sul programma @command{awk} in esecuzione.
+
+Se si specifica l'opzione del compilatore GNU Compiler Collection (GCC) che
+elimina il codice non eseguito, quest'opzione riduce di quasi
+23K byte la dimensione del programma eseguibile @command{gawk}
+su sistemi GNU/Linux x86_64. I risultati su altri sistemi e con
+altri compilatori sono probabilmente diversi.
+L'uso di questa opzione address@hidden apportare qualche piccolo miglioramento
nei
+tempi di esecuzione di un programma.
+
address@hidden ATTENZIONE
+Se si usa quest'opzione alcuni dei test di address@hidden non avranno successo.
+Quest'opzione address@hidden essere rimossa in futuro.
address@hidden quotation
+
address@hidden @option{--disable-nls}, opzione di configurazione
address@hidden opzione di configurazione @code{--disable-nls}
address@hidden --disable-nls
+Non attiva la traduzione automatica dei messaggi.
address@hidden normalmente non @`e consigliabile, ma address@hidden apportare
qualche lieve
+miglioramento nei tempi di esecuzione di un programma.
+
address@hidden @option{--with-whiny-user-strftime}, opzione di configurazione
address@hidden opzione di configurazione @code{--with-whiny-user-strftime}
address@hidden --with-whiny-user-strftime
+Forza l'uso della versione della funzione C @code{strftime()} inclusa nella
+distribuzione di @command{gawk}, per i sistemi in cui la funzione stessa
+non sia disponibile.
address@hidden table
+
+Si usi il comando @samp{./configure --help} per ottenere la lista completa
+delle opzioni disponibili in @command{configure}.
+
address@hidden Filosofia della configurazione
address@hidden Il processo di configurazione
+
address@hidden @command{gawk}, configurazione di
address@hidden configurazione di @command{gawk}
+Questa @value{SECTION} interessa solo a chi abbia un minimo di address@hidden
con
+il linguaggio C e con i sistemi operativi di tipo Unix.
+
+Il codice sorgente di @command{gawk}, in generale, cerca di aderire, nei limiti
+del possibile, a degli standard formali. address@hidden significa che
@command{gawk} usa
+routine di libreria che sono specificate nello standard ISO C e nello standard
+POSIX per le interfacce dei sistemi operativi. Il codice sorgente di
address@hidden richiede l'uso di un compilatore ISO C (standard 1990).
+
+Molti sistemi Unix non aderiscono completamente n@'e allo standard ISO n@'e a
+quello POSIX. La sottodirectory @file{missing_d} nella distribuzione di
address@hidden contiene delle versioni sostitutive per quelle funzioni che
address@hidden
+frequentemente risultano essere non disponibili.
+
+Il file @file{config.h} creato da @command{configure} contiene definizioni che
+elencano address@hidden del particolare sistema operativo nel quale si tenta di
+compilare @command{gawk}. Le tre cose descritte da questo file sono: quali
+file di intestazione sono disponibili, in modo da poterli includere
correttamente,
+quali funzioni (presumibilmente) standard sono realmente disponibili nelle
+librerie C, e varie informazioni assortite riguardo al sistema operativo
+corrente. Per esempio, address@hidden non esserci l'elemento
@code{st_blksize} nella
+struttura @code{stat}. In questo caso, @samp{HAVE_STRUCT_STAT_ST_BLKSIZE} @`e
+indefinito.
+
address@hidden @code{custom.h}, file
address@hidden possible che il compilatore C del sistema in uso "tragga in
inganno"
address@hidden address@hidden succedere nel caso in cui non viene restituito
+un errore se una funzione di libreria non @`e disponibile. Per superare questo
+problema, si address@hidden modificare il file @file{custom.h}. Basta usare
una direttiva
address@hidden appropriata per il sistema corrente, e definire, tramite
address@hidden, tutte le costanti che @command{configure} avrebbe dovuto
+definire, ma non @`e riuscito a farlo, oppure, usando @code{#undef} annullare
le
+costanti che @command{configure} ha definito, ma non avrebbe dovuto farlo. Il
+file @file{custom.h} @`e automaticamente incluso dal file @file{config.h}.
+
address@hidden anche possibile che il programma @command{configure} generato da
Autoconf non
+funzioni in un dato sistema per una ragione differente. Se c'@`e un problema,
si
+tenga presente che il file @file{configure.ac} @`e quello preso in input da
+Autoconf. @`E possibile modificare questo file e generare una nuova versione
di
address@hidden che funzioni sul sistema corrente (@pxref{Bug} per
+informazioni su come segnalare problemi nella configurazione di
address@hidden). Lo stesso meccanismo si address@hidden usare per inviare
aggiornamenti
+al file @file{configure.ac} e/o a @file{custom.h}.
+
address@hidden Installazione non-Unix
address@hidden Installazione su altri Sistemi Operativi
+
+Questa @value{SECTION} descrive come installare @command{gawk} su
+vari sistemi non-Unix.
+
address@hidden
+* Installazione su PC:: Installare e compilare @command{gawk}
+ su Microsoft Windows.
+* Installazione su VMS:: Installare @command{gawk} su VMS.
address@hidden menu
+
address@hidden Installazione su PC
address@hidden Installazione su MS-Windows
+
address@hidden PC, @command{gawk} su sistemi operativi
address@hidden sistemi operativi per PC, @command{gawk} su
address@hidden installare @command{gawk} su sistemi operativi per PC
+Questa @value{SECTION} tratta dell'installazione e uso di @command{gawk}
+su macchine con architettura Intel che eseguono qualsiasi versione di
+MS-Windows.
+In questa @value{SECTION}, il termine ``Windows32''
+si riferisce a una qualsiasi versione di Microsoft Windows
+95/98/ME/NT/2000/XP/Vista/7/8/10.
+
+Si veda anche il file @file{README_d/README.pc} nella distribuzione.
+
address@hidden
+* Installazione binaria su PC:: Installare una distribuzione pronta
+ all'uso.
+* Compilazione su PC:: Compilare @command{gawk} per Windows32.
+* Uso su PC:: Eseguire @command{gawk} su Windows32.
+* Cygwin:: Compilare ed eseguire @command{gawk}
+ per Cygwin.
+* MSYS:: Usare @command{gawk} nell'ambiente MSYS.
address@hidden menu
+
address@hidden Installazione binaria su PC
address@hidden Installare una distribuzione predisposta per sistemi MS-Windows
+
+La sola distribuzione binaria predisposta supportata per i sistem MS-Windows
address@hidden quella messa a disposizione da Eli Zaretskii
address@hidden://sourceforge.net/projects/ezwinports/, progetto ``ezwinports''}.
+Si parta da address@hidden@dotless{i}} per installare il comando
@command{gawk} precompilato.
+
address@hidden Compilazione su PC
address@hidden Compilare @command{gawk} per sistemi operativi di PC
+
address@hidden address@hidden essere compilato per Windows32, usando MinGW
+(per Windows32).
+Il file @file{README_d/README.pc} nella distribuzione @command{gawk}
+contiene ulteriori annotazioni, e il file @file{pc/Makefile} contiene
+informazioni importanti sulle opzioni di compilazione.
+
address@hidden compilare @command{gawk} per MS-Windows
+Per compilare @command{gawk} per Windows32, occorre copiare i file
+dalla directory @file{pc} (@emph{tranne} il file @file{ChangeLog}) alla
+directory che contiene il resto dei sorgenti di @command{gawk}, e quindi
+chiamare @command{make}, specificando il nome appropriato di obiettivo come
+argomento, per generare @command{gawk}. Il @file{Makefile} copiato dalla
+directory @file{pc} contiene una sezione di configurazione con commenti, e
address@hidden
+essere necessario modificarlo perch@'e funzioni con il programma di
address@hidden
address@hidden corrente.
+
+Il @file{Makefile} contiene un certo numero di alternative, che permettono di
+generare @command{gawk} per diverse
+versioni MS-DOS e Windows32. Se il comando @command{make} @`e richiamato senza
+specificare alcun argomento viene stampata una lista delle alternative
+disponibili. Per esempio,
+per generare un codice binario di @command{gawk} nativo per MS-Windows
+usando gli strumenti MinGW, scrivere @samp{make mingw32}.
+
address@hidden Uso su PC
address@hidden Usare @command{gawk} su sistemi operativi PC
address@hidden PC, @command{gawk} su sistemi operativi
address@hidden sistemi operativi PC, @command{gawk} su
+
+Sotto MS-Windows, gli ambienti Cygwin e MinGW consentono di usare
+sia l'operatore @samp{|&} che le operazioni su rete TCP/IP
+(@pxref{Reti TCP/IP}).
+
address@hidden percorso di ricerca
address@hidden percorso di ricerca per file sorgente
address@hidden @command{gawk}, versione MS-Windows di
address@hidden @code{;} (punto e virgola), @env{AWKPATH} variabile e
address@hidden punto e virgola (@code{;}), @env{AWKPATH} variabile e
address@hidden @env{AWKPATH}, variabile d'ambiente
address@hidden variabile d'ambiente @env{AWKPATH}
+Le versioni MS-Windows di @command{gawk} ricercano i file di
+programma come descritto in @ref{AWKPATH (Variabile)}. Comunque, gli elementi
+della variabile @env{AWKPATH} sono separati tra di loro da un punto e virgola
+(anzich@'e da due punti (@code{:})).
+Se @env{AWKPATH} @`e non impostata o ha per valore la stringa nulla, il
percorso
+di ricerca di default @`e @address@hidden;c:/lib/awk;c:/gnu/lib/awk}}.
+
address@hidden estensioni comuni, variabile @code{BINMODE}
address@hidden @cindex extensions, address@hidden @code{BINMODE} variable
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{BINMODE}
address@hidden @code{BINMODE}, variabile
address@hidden variabile @code{BINMODE}
+Sotto MS-Windows,
address@hidden (come molti altri programmi di trattamento testi) converte
+automaticamente la stringa di fine riga @samp{\r\n} in @samp{\n} leggendo
dall'input
+e @samp{\n} in @samp{\r\n} scrivendo sull'output.
+La variabile speciale @code{BINMODE} @value{COMMONEXT} permette di controllare
+come avvengono queste conversioni, ed @`e interpretata come segue:
+
address@hidden @value{BULLET}
address@hidden
+Se @code{BINMODE} @`e @code{"r"} o uno,
+la address@hidden binaria @`e impostata
+in lettura (address@hidden, nessuna conversione in lettura).
+
address@hidden
+Se @code{BINMODE} @`e @code{"w"} o due,
+la address@hidden binaria @`e impostata
+in scrittura (address@hidden, nessuna conversione in scrittura).
+
address@hidden
+Se @code{BINMODE} @`e @code{"rw"} o @code{"wr"} o tre,
+la address@hidden binaria @`e impostata sia in lettura che in scrittura.
+
address@hidden
address@hidden@var{stringa-non-nulla}} equivale a specificare
address@hidden (address@hidden, nessuna conversione in
+lettura e scrittura). Tuttavia, @command{gawk} emette un messaggio di
+avviso se la stringa non @`e @code{"rw"} o @code{"wr"}.
address@hidden itemize
+
address@hidden
+La address@hidden di trattamento dello standard input e standard output sono
+impostate una volta sola
+(dopo aver letto la riga di comando, ma prima di iniziare a elaborare
+qualsiasi programma @command{awk}).
+L'impostazione di @code{BINMODE} per standard input o
+standard output va fatta usando
+un'appropriata opzione @samp{-v address@hidden sulla riga di comando.
address@hidden @`e impostato nel momento in cui un file o @dfn{pipe} @`e aperto
+e non address@hidden essere cambiato in corso di elaborazione.
+
+Il nome @code{BINMODE} @`e stato scelto in analogia con @command{mawk}
+(@pxref{Altre versioni}).
address@hidden e @command{gawk} gestiscono @code{BINMODE} in maniera simile;
+tuttavia, @command{mawk} prevede un'opzione @samp{-W address@hidden e una
+variabile d'ambiente che address@hidden impostare @code{BINMODE}, @code{RS}, e
@code{ORS}.
+I file @file{binmode[1-3].awk} (nella directory @file{gnu/lib/awk} in alcune
+delle distribuzioni binarie address@hidden predisposte) sono stati inclusi per
rendere
+disponibile l'opzione di @command{mawk} @samp{-W address@hidden Questi
+possono essere modificati o ignorati; in particolare, quale sia l'impostazione
+di @code{RS} che address@hidden meno ``sorprese'' rimane una questione aperta.
address@hidden usa @samp{RS = "\r\n"} se si imposta la address@hidden binaria in
+lettura, il che @`e appropriato per file che abbiano i caratteri di fine riga
in
+stile MS-DOS.
+
+Per chiarire, gli esempi seguenti impostano la address@hidden binaria in
+scrittura per lo standard output e altri file, e impostano @code{ORS} in modo
+da ottenere la fine riga ``normale'' in stile MS-DOS:
+
address@hidden
+gawk -v BINMODE=2 -v ORS="\r\n" @dots{}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+gawk -v BINMODE=w -f binmode2.awk @dots{}
address@hidden example
+
address@hidden
+Questi comandi danno lo stesso risultato dell'opzione
address@hidden BINMODE=2} in @command{mawk}.
+Quanto segue modifica il separatore di record a @code{"\r\n"} e imposta
+la address@hidden binaria in lettura, senza modificare le letture da standard
input:
+
address@hidden
+gawk -v RS="\r\n" -e "BEGIN @{ BINMODE = 1 @}" @dots{}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+gawk -f binmode1.awk @dots{}
address@hidden example
+
address@hidden
+Usando i caratteri di protezione appropriati, nel primo
+esempio l'impostazione di @code{RS} address@hidden essere spostata in una
regola
address@hidden
+
address@hidden Cygwin
address@hidden Usare @command{gawk} in ambiente Cygwin
address@hidden compilare @command{gawk} per Cygwin
address@hidden Cygwin, compilare @command{gawk} per
+
address@hidden address@hidden essere compilato e usato
address@hidden@dotless{i}} com'@`e'' sotto MS-Windows se
+si opera all'interno dell'ambiente @uref{http://www.cygwin.com, Cygwin}.
+Questo ambiente consente un'eccellente simulazione di GNU/Linux, con l'uso di
+Bash, GCC, GNU Make, e altri programmi GNU. La compilazione e l'installazione
+per Cygwin @`e la stessa usata nei sistemi di tipo Unix:
+
address@hidden
+tar -xvpzf address@hidden@value{PATCHLEVEL}.tar.gz
+cd address@hidden@value{PATCHLEVEL}
+./configure
+make && make check
address@hidden example
+
+In confronto a un sistema GNU/Linux sulla stessa macchina, l'esecuzione
+del passo di @samp{configure} sotto Cygwin richiede molto address@hidden
tempo. Tuttavia
+si conclude regolarmente, e poi @samp{make} funziona come ci si aspetta.
+
address@hidden MSYS
address@hidden Usare @command{gawk} in ambiente MSYS
+
+Nell'ambiente MSYS sotto MS-Windows, @command{gawk} automaticamente usa la
address@hidden binaria per leggere e scrivere file. Non @`e quindi necessario
usare la
+variabile @code{BINMODE}.
+
+Questo address@hidden causare problemi con altri componenti di tipo Unix che
sono stati
+resi disponibile in MS-Windows, che si aspettano che @command{gawk} faccia
+automaticamente la conversione di @code{"\r\n"}, mentre
address@hidden@dotless{i}} non @`e.
+
address@hidden Installazione su VMS
address@hidden Compilare e installare @command{gawk} su Vax/VMS e OpenVMS
+
address@hidden based on material from Pat Rankin <address@hidden>
address@hidden now address@hidden
address@hidden now address@hidden
+
address@hidden @command{gawk}, versione VMS di
address@hidden installare @command{gawk} su VMS
address@hidden VMS, installare @command{gawk} su
+Questa @value{SUBSECTION} descrive come compilare e installare @command{gawk}
+sotto VMS. Il termine classico ``VMS'' @`e usato qui anche per designare
+OpenVMS.
+
address@hidden
+* Compilazione su VMS:: Come compilare @command{gawk} su VMS.
+* Estensioni dinamiche su VMS:: Compilare estensioni dinamiche
+ di @command{gawk} su VMS.
+* Dettagli installazione su VMS:: Come installare @command{gawk} su VMS.
+* Esecuzione su VMS:: Come eseguire @command{gawk} su VMS.
+* GNV su VMS:: Il progetto VMS GNV.
+* Vecchio Gawk su VMS:: Una versione non aggiornata arriva
+ con alcune versioni di VMS.
address@hidden menu
+
address@hidden Compilazione su VMS
address@hidden Compilare @command{gawk} su VMS
address@hidden compilare @command{gawk} per VMS
address@hidden VMS, compilare @command{gawk} per
+
+Per compilare @command{gawk} sotto VMS, esiste una procedura di comandi
address@hidden che esegue tutti i comandi @code{CC} e @code{LINK} necessari.
C'@`e
+anche un @file{Makefile} da usare con i programmi di address@hidden @code{MMS}
e
address@hidden A partire della directory che contiene i file sorgente, si usi:
+
address@hidden
+$ @kbd{@@[.vms]vmsbuild.com}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+$ @kbd{MMS/DESCRIPTION=[.vms]descrip.mms gawk}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+$ @kbd{MMK/DESCRIPTION=[.vms]descrip.mms gawk}
address@hidden example
+
+Il comando @command{MMK} @`e un quasi-clone, a codice aperto e gratuito, di
address@hidden, che gestisce in maniera migliore i volumi ODS-5 con @value{FNS}
+a caratteri maiuscoli e minuscoli. @command{MMK} @`e disponibile da
address@hidden://github.com/endlesssoftware/mmk}.
+
+Avendo a che fare con volumi ODS-5 e con l'analisi sintattica estesa abilitata,
+il nome del parametro che specifica l'obiettivo address@hidden dover essere
scritto
+digitando esattamente le lettere maiuscole e minuscole.
+
address@hidden @`e stato testato sotto VAX/VMS 7.3 e Alpha/VMS 7.3-1 usando il
+compilatore Compaq C V6.4, e sotto Alpha/VMS 7.3, Alpha/VMS 7.3-2, e IA64/VMS
+8.3. Le compilazioni address@hidden recenti hanno usato il compilatore HP C
V7.3 su Alpha
+VMS 8.3 e su VMS 8.4, sia Alpha che IA64, hanno usato il compilatore HP C
address@hidden'architettura IA64 @`e anche nota come ``Itanium''.}
+
address@hidden su VMS} per informazioni su come compilare
address@hidden come un kit PCSI compatible con il prodotto GNV.
+
address@hidden Estensioni dinamiche su VMS
address@hidden Compilare estensioni dinamiche di @command{gawk} in VMS
+
+Le estensioni che sono state rese disponibile su VMS possono essere
+costruite dando uno dei comandi seguenti:
+
address@hidden
+$ @kbd{MMS/DESCRIPTION=[.vms]descrip.mms extensions}
address@hidden example
+
address@hidden
+o:
+
address@hidden
+$ @kbd{MMK/DESCRIPTION=[.vms]descrip.mms extensions}
address@hidden example
+
address@hidden usa @code{AWKLIBPATH} come una variabile d'ambiente
+oppure come un nome logico per trovare le estensioni dinamiche.
+
+Le estensioni dinamiche devono essere compilate con le stesse opzioni del
+compilatore usate per compilare @command{gawk} riguardanti numeri in virgola
+mobile, dimensione dei puntatori e trattamento dei nomi simbolici. I computer
+con architettura Alpha e Itanium dovrebbero usare i numeri in virgola mobile
+col formato IEEE. La dimensione dei puntatori @`e 32 bit, e il trattamento
dei nomi
+simbolici dovrebbe richiedere il rispetto esatto di maiuscole/minuscole, con le
+abbreviazioni CRC per simboli address@hidden lunghi di 32 bit.
+
+Per Alpha e Itanium:
+
address@hidden
+/name=(as_is,short)
+/float=ieee/ieee_mode=denorm_results
address@hidden example
+
+Per VAX:
+
address@hidden
+/name=(as_is,short)
address@hidden example
+
+Le macro da usare al momento della compilazione devono essere definite prima di
+includere il primo file di intestazione proveniente da VMS, come segue:
+
address@hidden
+#if (__CRTL_VER >= 70200000) && !defined (__VAX)
+#define _LARGEFILE 1
+#endif
+
+#ifndef __VAX
+#ifdef __CRTL_VER
+#if __CRTL_VER >= 80200000
+#define _USE_STD_STAT 1
+#endif
+#endif
+#endif
address@hidden example
+
+Se si scrivono delle estensioni utente da eseguire su VMS, vanno fornite anche
+queste definizioni. Il file @file{config.h} creato quando si compila
address@hidden su VMS lo fa address@hidden; se invece si usa qualche altro file
simile,
+occorre ricordarsi di includerlo prima di qualsiasi file di intestazione
+proveniente da VMS.
+
address@hidden Dettagli installazione su VMS
address@hidden Installare @command{gawk} su VMS
+
+Per usare @command{gawk}, tutto address@hidden che serve @`e un comando
``esterno'', che @`e
+un simbolo @code{DCL} il cui valore inizia col segno del dollaro.
+Per esempio:
+
address@hidden
+$ @kbd{GAWK :== $disk1:[gnubin]gawk}
address@hidden example
+
address@hidden
+Si sostituisca la posizione corrente di @command{gawk.exe} a
address@hidden:[gnubin]}. Il simbolo dovrebbe essere posto nel file
address@hidden di ogni utente che desideri eseguire @command{gawk},
+in modo che sia definito ogni volta che l'utente inizia una sessione.
+Alternativamente, il simbolo address@hidden essere messo nella procedura di
sistema
address@hidden,
+in modo da permettere a tutti gli utenti di eseguire @command{gawk}.
+
+Se @command{gawk} @`e stato installato da un kit PCSI nell'albero di
+directory @file{GNV$GNU:}, il programma address@hidden come nome
address@hidden:[bin]gnv$gawk.exe}, e il file di aiuto address@hidden chiamato
address@hidden:[vms_help]gawk.hlp}.
+
+Il kit PCSI installa anche un file @file{GNV$GNU:[vms_bin]gawk_verb.cld}
+che address@hidden essere usato per aggiungere @command{gawk} e @command{awk}
+alla lista dei comandi DCL.
+
+Per farlo solo nella sessione corrente si address@hidden usare:
+
address@hidden
+$ @kbd{set command gnv$gnu:[vms_bin]gawk_verb.cld}
address@hidden example
+
+Oppure il sistemista VMS address@hidden usare
@file{GNV$GNU:[vms_bin]gawk_verb.cld} per
+aggiungere @command{gawk} e @command{awk} alla tabella @samp{DCLTABLES}
+valida per tutto il sistema.
+
+La sintassi DCL @`e documentata nel file @file{gawk.hlp}.
+
+In alternativa, l'elemento @file{gawk.hlp} address@hidden essere caricato in
una
+libreria di aiuto VMS:
+
address@hidden
+$ @kbd{LIBRARY/HELP sys$help:helplib [.vms]gawk.hlp}
address@hidden example
+
address@hidden
+(Una libreria specifica dell'installazione potrebbe venir usata invece
+della libreria standard VMS library @samp{HELPLIB}.) Dopo aver installato
+il testo di aiuto, il comando:
+
address@hidden
+$ @kbd{HELP GAWK}
address@hidden example
+
address@hidden
+fornisce informazioni sia sull'implementazione di @command{gawk}
+sia sul linguaggio di programmazione @command{awk}.
+
+Il nome logico @samp{AWK_LIBRARY} address@hidden designare una posizione di
default per i
+file di programma @command{awk}. Riguardo all'opzione @option{-f}, se il
address@hidden specificato non contiene un dispositivo o un percorso di
directory,
address@hidden cerca dapprima nella directory corrente, poi nella directory
+specificata dalla traduzione di @samp{AWK_LIBRARY} se il file non @`e stato
+trovato. Se, dopo aver cercato in entrambe queste directory, il file non @`e
+ancora stato trovato, @command{gawk} appone il suffisso @samp{.awk} al
address@hidden e ritenta la ricerca del file. Se @samp{AWK_LIBRARY} non @`e
+definita, si usa per essa il valore di default @samp{SYS$LIBRARY:}.
+
address@hidden Esecuzione su VMS
address@hidden Eseguire @command{gawk} su VMS
+
+L'elaborazione della riga di comando e le convenzioni per proteggere i
+caratteri sono significativamente differenti in VMS, e quindi gli esempi
+presenti in questo @value{DOCUMENT} o provenienti da altre fonti necessitano
+piccole modifiche. Le modifiche, tuttavia, @emph{sono} veramente piccole, e
+tutti i programmi @command{awk} dovrebbero funzionare correttamente.
+
+Ecco un paio di semplici test:
+
address@hidden
+$ @kbd{gawk -- "BEGIN @{print ""Hello, World!""@}"}
+$ @kbd{gawk -"W" version}
+! ma anche -"W version" o "-W version"
address@hidden example
+
address@hidden
+Si noti che il testo con caratteri maiuscoli e misti maiuscoli/minuscoli
+dev'essere incluso tra doppi apici.
+
+La versione VMS di @command{gawk} comprende un'interfaccia in stile @code{DCL},
+oltre a quella originale, di tipo shell (si veda il file di aiuto per ulteriori
+dettagli). Un effetto indesiderato della duplice analisi della riga
+di comando @`e che se c'@`e solo un unico parametro (come nel programma con le
+righe contenenti doppi apici), il comando diviene ambiguo. Per evitare questo
+inconveniente, il flag, normalmente non necessario, @option{--} @`e necessario
+per forzare un esame dei parametri in stile Unix, piuttosto che nella
address@hidden
address@hidden Se qualsiasi altra opzione preceduta dal segno @option{-} (o
address@hidden
+parametri, per esempio, address@hidden @value{DF} in input) @`e presente, non
c'@`e address@hidden,
+e l'opzione @option{--} address@hidden essere omessa.
+
address@hidden exit, codice di ritorno, in VMS
+Il valore di @code{exit} @`e un valore in stile Unix e viene trasformato in
+una condizione VMS all'uscita del programma.
+
+I bit di address@hidden di VMS saranno impostati a partire dal valore
dell'istruzione
address@hidden Un errore grave @`e indicato da 1, e VMS imposta la condizione
address@hidden Un errore fatale @`e indicato da 2, e VMS imposta la condizione
address@hidden Ogni altro valore imposta la condizione @code{SUCCESS}. Il
+valore d'uscita @`e codificato per aderire agli standard di codifica VMS e
address@hidden
+un @code{C_FACILITY_NO} di @code{0x350000} con il codice costante @code{0xA000}
+aggiunto al numero spostato a sinistra di 3 bit per far posto al codice di
address@hidden
+
+Per estrarre il codice reale di ritorno dell'istruzione @code{exit}
+di @command{gawk} dalla condizione impostata da VMS, si usi:
+
address@hidden
+unix_status = (vms_status .and. %x7f8) / 8
address@hidden example
+
address@hidden
+Un programma C che usa @code{exec()} per chiamare @command{gawk}
address@hidden il valore originale della exit in stile Unix.
+
+Precedenti versioni di @command{gawk} per VMS consideravano un codice di
+ritorno a Unix di 0 come 1, un errore come 2, un errore fatale come 4, e tutti
+gli altri valori erano restituiti immodificati. Questa era una violazione
+rispetto alle specifiche di codifica delle condizioni di uscita di VMS.
+
address@hidden numeri in virgola mobile, VAX/VMS
address@hidden VAX/VMS, numeri in virgola mobile,
+L'aritmetica in virgola mobile VAX/VMS usa un arrotondamento statistico.
address@hidden round}.
+
+VMS restituisce data e ora in formato GMT, a meno che non siano stati impostati
+i nomi logici @code{SYS$TIMEZONE_RULE} o @code{TZ}. Precedenti versioni di
+VMS, come VAX/VMS 7.3, non impostano questi nomi logici.
+
address@hidden @cindex directory search
address@hidden @cindex path, search
address@hidden percorso di ricerca
address@hidden percorso di ricerca per file sorgente
+Il percorso di ricerca di default, nella ricerca dei file di programma per
address@hidden specificati dall'opzione @option{-f}, @`e
address@hidden"SYS$DISK:[],AWK_LIBRARY:"}. Il nome logico @env{AWKPATH}
address@hidden essere
+usato per sostituire questo di default. Il formato di @env{AWKPATH} @`e una
lista
+di directory, separate da virgola. Nel definirla, il valore dovrebbe essere
+incluso tra doppi apici, in modo che consenta una sola traduzione, e non una
+lista di ricerca multitraduzione @code{RMS}.
+
address@hidden ridirezione in VMS
+
+Questa restrizione vale anche se si esegue @command{gawk} sotto GNV,
+in quanto la ridirezione @`e sempre verso un comando DCL.
+
+Se si ridirigono dati verso un comando o un programma di address@hidden VMS,
+l'implementazione corrente richiede la creazione di un comando VMS esterno che
+esegua un file di comandi, prima di invocare @command{gawk}.
+(Questa restrizione potrebbe essere rimossa in una futura versione di
address@hidden per VMS.)
+
+Senza un tale file di comandi, i dati in input saranno presenti anche
+in output, prima dei dati di output veri e propri.
+
address@hidden consente la simulazione di comandi POSIX non disponibili in VMS
+o l'uso di programmi di address@hidden GNV.
+
+L'esempio seguente mostra come ridirigere dati da @command{gawk} verso il
+comando VMS @command{sort}.
+
address@hidden
+$ sort = "@@device:[dir]vms_gawk_sort.com"
address@hidden example
+
+Il file di comandi deve avere il formato dell'esempio seguente.
+
+La prima riga serve a evitare che i dati in input siano presenti anche
+nell'output. Dev'essere nel formato mostrato nell'esempio.
+
+La riga seguente crea un comando esterno che prevale sul comando esterno
+superiore, che serve a prevenire una ricorsione infinita di file di comandi.
+
+Il penultimo comando ridirige @code{sys$input} su @code{sys$command},
+per poter ottenere i dati che sono ridiretti verso il comando.
+
+L'ultima riga esegue il comando vero e proprio. Dev'essere l'ultimo
+comando, perch@'e i dati ridiretti da @command{gawk} saranno letti
+quando il file di comandi finisce di essere eseguito.
+
address@hidden
+$!'f$verify(0,0)'
+$ sort := sort
+$ define/user sys$input sys$command:
+$ sort sys$input: sys$output:
address@hidden example
+
+
address@hidden GNV su VMS
address@hidden Il progetto VMS GNV
+
+Il pacchetto VMS GNV fornisce un ambiente di sviluppo simile
+a POSIX tramite una collezione di strumenti @dfn{open source}.
+Il @command{gawk} presente nel pacchetto base GNV @`e una vecchia versione.
+Attualmente, il progetto GNV @`e in fase di riorganizzazione, con l'obiettivo
+di offrire pacchetti PCSI separati per ogni componente.
+Si veda @address@hidden://sourceforge.net/p/gnv/wiki/InstallingGNVPackages/}.}
+
+La procedura normale per compilare @command{gawk} produce un programma
+adatto a essere usato con GNV.
+
+Il file @file{vms/gawk_build_steps.txt} nella distribuzione documenta
+la procedura per compilare un pacchetto PCSI compatible con GNV.
+
address@hidden
address@hidden The VMS POSIX product, also known as POSIX for OpenVMS, is long
defunct
address@hidden and building gawk for it has not been tested in many years, but
these
address@hidden old instructions might still work if anyone is still using it.
+
address@hidden VMS POSIX
address@hidden Compilare e usare @command{gawk} su VMS POSIX
+
+Le istruzioni appena viste vanno ignorate, sebbene @file{vms/gawk.hlp}
+dovrebbe ancora essere reso disponibile in una libreria di aiuto.
+L'albero del codice sorgente dovrebbe essere scompattato in un sottosistema
+contenitore di file, e non nel normale @dfn{filesystem} VMS.
+Occorre accertarsi che i due script, @file{configure} e
address@hidden/posix-cc.sh}, siano eseguibile; si usi @samp{chmod +x} per farlo,
+se necessario. Poi vanno eseguiti i seguenti due comandi:
+
address@hidden
+psx> @kbd{CC=vms/posix-cc.sh configure}
+psx> @kbd{make CC=c89 gawk}
address@hidden example
+
address@hidden
+Il primo comando costruisce i file @file{config.h} e @file{Makefile},
+a partire da dei modelli, usando uno script per fare
address@hidden@dotless{i}} che il
+compilatore C soddisfi le aspettative di @command{configure}. Il secondo
+comando compila e collega @command{gawk} chiamando direttamente il
+compilatore C; gli eventuali messaggi di @command{make} che dicono di non
+riuscire a ridefinire @code{CC} vanno ignorati. @command{configure}
+impiega molto tempo a completarsi, ma in compenso continua a fornire
+messaggi che permettono di seguirne l'avanzamento.
+
+Questo @`e stato testato con VAX/VMS V6.2, VMS POSIX V2.0, e DEC C V5.2.
+
+Una volta installato, @command{gawk} funziona come ogni altro programma
+di address@hidden della shell. A differenza della normale versione VMS di
address@hidden, neesuna manipolazione speciale della riga di comando @`e
+necessaria nell'ambiente VMS POSIX.
address@hidden ignore
+
address@hidden Vecchio Gawk su VMS
address@hidden Vecchia versione di @command{gawk} su sistemi VMS
+
+
address@hidden Thanks to "gerard labadie" <address@hidden>
+
+Alcune versioni di VMS includono una vecchia versione di @command{gawk}.
+Per utilizzarla, occorre definire un simbolo, come segue:
+
address@hidden
+$ @kbd{gawk :== $sys$common:[syshlp.examples.tcpip.snmp]gawk.exe}
address@hidden example
+
+La versione appare essere la @value{PVERSION} 2.15.6, che @`e molto vecchia.
+Si raccomanda di compilare e usare la versione corrente.
+
address@hidden Bug
address@hidden Segnalazione di problemi e bug
address@hidden archeologi
address@hidden
address@hidden c'@`e niente di address@hidden pericoloso di un archeologo
annoiato.}
address@hidden Douglas Adams, @cite{Guida galattica per autostoppisti}
address@hidden quotation
address@hidden the radio show, not the book. :-)
+
address@hidden debug, @command{gawk}, segnalare bug
address@hidden risoluzione problemi @command{gawk}, segnalare bug
+Se si incontrano problemi con @command{gawk} o se si ritiene di aver trovato un
+bug, si raccomanda di segnalarlo agli sviluppatori;
+non c'@`e un impegno preciso a intervenire, ma c'@`e una buona address@hidden
che ci
+si sforzi di risolverlo.
+
address@hidden
+* Indirizzo Bug:: Dove inviare le segnalazioni.
+* Usenet:: Dove non inviare le segnalazioni.
+* Manutentori:: Manutentori di version non-*nix.
address@hidden menu
+
address@hidden Indirizzo Bug
address@hidden Segnalare Bug
+
+Prima di segnalare un bug, occorre assicurarsi che sia davvero un bug. La
+documentazione va riletta attentamente, per controllare se dice che @`e
possibile
+fare quel che si sta tentando di fare. Se non @`e chiaro se sia possibile
+fare quella particolare cosa o no, occorre segnalarlo; in questo caso si tratta
+di un bug nella documentazione!
+
+Prima di segnalare un bug o di tentare di risolverlo personalmente, si tenti
+di isolarlo preparando un programma @command{awk} il address@hidden piccolo
possibile, con
+un @value{DF} in input che possa riprodurre il problema. Dopo averlo fatto, si
+spedisca il programma e il @value{DF}, insieme a informazioni sul tipo di
+sistema Unix in uso, il compilatore usato per compilare @command{gawk}, e i
+risultati esatti che @command{gawk} ha prodotto. Inoltre andrebbe specificato
+cosa ci si aspettava che il programma facesse; questo @`e di aiuto per decidere
+se il problema @`e un problema di documentazione.
+
address@hidden importante includere il numero di versione di @command{gawk} in
uso.
+Questa informazione si address@hidden ottenere con il comando @samp{gawk
--version}.
+
address@hidden @code{bug-gawk@@gnu.org} indirizzo per la segnalazione dei bug
address@hidden email, indirizzo per segnalare bug, @code{bug-gawk@@gnu.org}
address@hidden indirizzo email per segnalare bug, @code{bug-gawk@@gnu.org}
address@hidden bug, segnalare, indirizzo email, @code{bug-gawk@@gnu.org}
address@hidden segnalare bug, indirizzo email, @code{bug-gawk@@gnu.org}
+Una volta pronta la descrizione precisa del problema, si spedisca un messaggio
+di posta elettronica a @EMAIL{bug-gawk@@gnu.org,bug-gawk at gnu dot org}.
+
+I manutentori di @command{gawk} sono i destinatari, e riceveranno la
+segnalazione di errore. Sebbene sia possibile spedire messaggi direttamente ai
+manutentori, @`e preferibile usare l'indirizzo sopra fornito perch@'e quella
+mailing list rimane in archivio presso il Progetto GNU. @emph{Tutti i messaggi
+devono essere in inglese. @`E questo il solo linguaggio che tutti i manutentori
+conoscono.} Inoltre, occorre accertarsi di spedire tutti i messaggi in formato
address@hidden, e non (o non soltanto) in formato HTML.
+
address@hidden NOTA
+Molte distribuzioni di GNU/Linux e i vari sistemi operativi basati su
+BSD hanno un loro proprio canale per segnalare i bug. Se si segnala un
+bug usando il canale della distribuzione, una copia del messaggio andrebbe
+inviata anche a @EMAIL{bug-gawk@@gnu.org,bug-gawk at gnu dot org}.
+
+Questo per due ragioni. La prima @`e che, sebbene alcune distribuzioni
inoltrino
+i messaggi sui problemi ``verso l'alto'' alla mailing list GNU, molte non lo
+fanno, e quindi c'@`e una buona address@hidden che i manutentori di
@command{gawk}
+non vedano affatto il messaggio relativo al bug! La seconda ragione @`e che la
+posta diretta alla mailing list GNU @`e archiviata, e il poter disporre di ogni
+cosa all'interno del progetto GNU consente di avere a disposizione tutte le
+informazioni rilevanti senza dover dipendere da altre organizzazioni.
address@hidden quotation
+
+Suggerimenti non correlati a bug sono pure sempre benvenuti. Se si hanno
+domande riguardo a qualcosa di non chiaro nella documentazione o a proposito
+di address@hidden oscure, si scriva alla mailing list dei bug; si
address@hidden
+a essere di aiuto nei limiti del possibile.
+
address@hidden Usenet
address@hidden Non segnalare bug a USENET!
+
address@hidden
address@hidden Date: Sun, 17 May 2015 19:50:14 -0400
address@hidden From: Chet Ramey <address@hidden>
address@hidden Reply-To: address@hidden
address@hidden Organization: ITS, Case Western Reserve University
address@hidden To: Aharon Robbins <address@hidden>
address@hidden CC: address@hidden
+Ho iniziato a ignorare Usenet un paio di anni fa, e non me ne sono mai
+pentito. @`E come quando si parla di sport alla radio---ci si sente
address@hidden intelligenti per aver lasciato perdere.
address@hidden Chet Ramey
address@hidden quotation
+
address@hidden @code{comp.lang.awk} gruppo di discussione
address@hidden newsgroup @code{comp.lang.awk}
address@hidden gruppo di discussione @code{comp.lang.awk}
+Siete pregati di @emph{non} provare a notificare bug di @command{gawk}
+scrivendo al gruppo di discussione Usenet/Internet @code{comp.lang.awk}.
+Sebbene alcuni degli sviluppatori di @command{gawk} leggano talora i
+messaggi di questo gruppo di discussione, il manutentore principale di
address@hidden non lo fa address@hidden Quindi @`e praticamente certo che un
+messaggio inviato address@hidden @emph{non} sia da lui letto.
+La procedura qui descritta @`e la sola maniera ufficialmente riconosciuta
+per notificare problemi. Davvero!
+
address@hidden
+And another one:
+
+Date: Thu, 11 Jun 2015 09:00:56 -0400
+From: Chet Ramey <address@hidden>
+
+My memory was imperfect. Back in June 2009, I wrote:
+
+"That's the nice thing about open source, right? You can take your ball
+and run to another section of the playground. Then, if you like mixing
+metaphors, you can throw rocks from there."
address@hidden ignore
+
address@hidden Manutentori
address@hidden Notificare problemi per versioni non-Unix
+
+Se si riscontrano bug in una delle versioni non-Unix di @command{gawk}, una
+copia del messaggio inviato alla mailing list dei bug andrebbe spedita alla
+persona che si occupa di quella versione. I manutentori sono elencati nella
+lista seguente, come pure nel file @file{README} nella distribuzione
address@hidden Le informazioni nel file @file{README} dovrebbero essere
+considerate come le address@hidden aggiornate, se risultano in conflitto con
questo
address@hidden
+
+Le persone che si occupano delle varie versioni di @command{gawk} sono:
+
address@hidden put the index entries outside the table, for docbook
address@hidden Buening, Andreas
address@hidden Deifik, Scott
address@hidden Malmberg, John E.
address@hidden Pitts, Dave
address@hidden G., Daniel Richard
address@hidden Robbins, Arnold
address@hidden Zaretskii, Eli
address@hidden SMALLPRINT
address@hidden {MS-Windows}
{123456789012345678901234567890123456789001234567890}
address@hidden ifset
address@hidden SMALLPRINT
address@hidden {MS-Windows con MinGW}
{123456789012345678901234567890123456789001234567890}
address@hidden ifclear
address@hidden Unix e sistemi POSIX @tab Arnold Robbins,
@EMAIL{arnold@@skeeve.com,arnold at skeeve dot com}
+
address@hidden @item MS-DOS con DJGPP @tab Scott Deifik,
@EMAIL{scottd.mail@@sbcglobal.net,scottd dot mail at sbcglobal dot net}
+
address@hidden MS-Windows con MinGW @tab Eli Zaretskii,
@EMAIL{eliz@@gnu.org,eliz at gnu dot org}
+
address@hidden Leave this in the document on purpose.
address@hidden OS/2 is not mentioned anywhere else though.
address@hidden OS/2 @tab Andreas Buening,
@EMAIL{andreas.buening@@nexgo.de,andreas dot buening at nexgo dot de}
+
address@hidden VMS @tab John Malmberg, @EMAIL{wb8tyw@@qsl.net,wb8tyw at qsl.net}
+
address@hidden z/OS (OS/390) @tab Daniel Richard G.@:
@EMAIL{skunk@@iSKUNK.ORG,skunk at iSKUNK.ORG}
address@hidden @tab Dave Pitts (Maintainer Emeritus),
@EMAIL{dpitts@@cozx.com,dpitts at cozx dot com}
address@hidden multitable
+
+Se il problema riscontrato @`e riproducibile anche sotto Unix,
+si dovrebbe spedire una copia del messaggio anche alla mailing list
address@hidden@@gnu.org,bug-gawk at gnu dot org}.
+
+La versione generata usando gli strumenti DJGPP non @`e address@hidden
supportata;
+il codice relativo address@hidden nella distribuzione ancora per qualche tempo,
+nel caso che qualche volontario desideri prenderla in carico.
+Se questo non dovesse succedere, la parte di codice relativa questa
+versione address@hidden rimossa dalla distribuzione.
+
address@hidden Altre versioni
address@hidden Altre implementazioni di @command{awk} liberamente disponibili
address@hidden @command{awk}, implementazioni di
address@hidden implementazioni di @command{awk}
address@hidden
+From: emory!amc.com!brennan (Michael Brennan)
+Subject: C++ comments in awk programs
+To: address@hidden (Arnold Robbins)
+Date: Wed, 4 Sep 1996 08:11:48 -0700 (PDT)
+
address@hidden ignore
address@hidden Brennan, Michael
address@hidden
address@hidden
address@hidden@`E piuttosto divertente mettere commenti simili nel vostro
codice awk:address@hidden
+@ @ @ @ @ @ @code{// Funzionano i commenti in stile C++? Risposta:
address@hidden@dotless{i}}! certo}
address@hidden Michael Brennan
address@hidden quotation
address@hidden ifnotdocbook
+
address@hidden
+<blockquote><attribution>Michael Brennan</attribution>
+<literallayout><emphasis>
address@hidden piuttosto divertente mettere commenti simili nel vostro codice
awk.
+</emphasis>
+ <literal>
+// Funzionano i commenti in stile C++? Risposta: address@hidden@dotless{i}}!
certo
+</literal></literallayout>
+</blockquote>
address@hidden docbook
+
+Ci sono alcune altre implementazioni di @command{awk} disponibili
+gratuitamente.
+Questa @value{SECTION} descrive in breve dove @`e possibile trovarle:
+
address@hidden @asis
address@hidden Kernighan, Brian
address@hidden sorgente, codice, Brian Kernighan @command{awk}
address@hidden codice sorgente, Brian Kernighan @command{awk}
address@hidden @command{awk}, versioni di, si veda anche Brian Kernighan,
@command{awk} di
address@hidden Brian Kernighan, @command{awk} di, codice sorgente
address@hidden Unix @command{awk}
+Brian Kernighan, uno degli sviluppatori originali di Unix @command{awk},
+ha reso disponibile liberamente la sua implementazione di @command{awk}.
+Si address@hidden scaricare questa versione dalla
address@hidden://www.cs.princeton.edu/~bwk, sua pagina principale}.
address@hidden disponibile in parecchi formati compressi:
+
address@hidden @asis
address@hidden Archivio Shell
address@hidden://www.cs.princeton.edu/~bwk/btl.mirror/awk.shar}
+
address@hidden File @command{tar} compresso
address@hidden://www.cs.princeton.edu/~bwk/btl.mirror/awk.tar.gz}
+
address@hidden File Zip
address@hidden://www.cs.princeton.edu/~bwk/btl.mirror/awk.zip}
address@hidden table
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
address@hidden anche disponbile in GitHub:
+
address@hidden
+git clone git://github.com/onetrueawk/awk bwkawk
address@hidden example
+
address@hidden
+Questo comando crea una copia del deposito @uref{http://git-scm.com, Git}
+in una directory chiamata @file{bwkawk}. Se si omette questo argomento della
+riga di comando @command{git}, la copia del deposito @`e creata nella
+directory di nome @file{awk}.
+
+Questa versione richiede un compilatore ISO C (standard 1990); il compilatore
+C contenuto in GCC (la collezione di compilatori GNU) @`e address@hidden che
sufficiente.
+
address@hidden comuni}
+per una lista di estensioni in questo @command{awk} che non sono in
+POSIX @command{awk}.
+
+Incidentalmente, Dan Bornstein ha creato un deposito Git che contiene tutte le
+versioni di BWK @command{awk} che @`e riuscito a trovare. @`E disponibile in
address@hidden://github.com/danfuzz/one-true-awk}.
+
address@hidden Brennan, Michael
address@hidden @command{mawk}, programma di address@hidden
address@hidden programma di address@hidden @command{mawk}
address@hidden codice sorgente, @command{mawk}
address@hidden @command{mawk}
+Michael Brennan ha scritto un'implementazione indipendente di @command{awk},
+di nome @command{mawk}. @`E disponibile sotto la licenza
address@hidden FOR_PRINT
+GPL (@pxref{Copia}),
address@hidden ifclear
address@hidden FOR_PRINT
+GPL,
address@hidden ifset
+proprio come @command{gawk}.
+
+Il sito di distribuzione originale di @command{mawk} non contiene
address@hidden
+il codice sorgente. Una copia @`e disponibile in
address@hidden://www.skeeve.com/gawk/mawk1.3.3.tar.gz}.
+
+Dal 2009 @`e Thomas Dickey a occuparsi della manutenzione di @command{mawk}.
+Le informazioni di base sono disponibili nella
address@hidden://www.invisible-island.net/mawk, pagine web del progetto}.
+Il puntatore URL da cui scaricare @`e
address@hidden://invisible-island.net/datafiles/release/mawk.tar.gz}.
+
+Una volta scaricato,
+per scompattare questo file address@hidden essere usato @command{gunzip}.
+L'installazione @`e simile a quella di @command{gawk}
+(@pxref{Installazione Unix}).
+
address@hidden comuni}
+per una lista di estensioni in @command{mawk} che non sono in POSIX
@command{awk}.
+
address@hidden Sumner, Andrew
address@hidden @command{awka}, compilatore per @command{awk}
address@hidden compilatore per @command{awk}, @command{awka}
address@hidden sorgente, codice, @command{awka}
address@hidden codice sorgente di @command{awka}
address@hidden @command{awka}
+Scritto da Andrew Sumner,
address@hidden traduce i programmi @command{awk} in C, li compila,
+e prepara il codice eseguibile usando una libreria di funzioni che
+implementano le address@hidden di base di @command{awk}.
+Comprende anche un certo numero di estensioni.
+
+Il traduttore di @command{awk} @`e rilasciato sotto la licenza GPL, e la
+relativa libreria sotto la licenza LGPL.
+
+Per ottenere @command{awka}, si visiti
+il sito @url{http://sourceforge.net/projects/awka}.
address@hidden You can reach Andrew Sumner at @email{andrew@@zbcom.net}.
address@hidden andrewsumner@@yahoo.net
+
+Il progetto sembra essere stato congelato; non ci sono state modifiche nel
+codice sorgente dal 2001 circa.
+
address@hidden Beebe, Nelson H.F.@:
address@hidden @command{pawk} (versione con profilatura di Brian Kernighan
@command{awk})
address@hidden codice sorgente, @command{pawk}
address@hidden sorgente, codice, @command{pawk}
address@hidden @command{pawk}
+Nelson H.F.@: Beebe all'address@hidden dello Utah ha modificato
+BWK @command{awk} per fornire informazioni di temporizzazione e profilatura.
+Questo @`e differente dall'usare @command{gawk} con l'opzione
@option{--profile}
+(@pxref{Profilare})
+nel senso che fornisce un profilo basato sul consumo di CPU, non sul
+numero di esecuzioni di una data riga di codice.
+Sia address@hidden trovare sia in
address@hidden://ftp.math.utah.edu/pub/pawk/pawk-20030606.tar.gz}
+che in
address@hidden://www.math.utah.edu/pub/pawk/pawk-20030606.tar.gz}.
+
address@hidden BusyBox @command{awk}
address@hidden BusyBox Awk
address@hidden codice sorgente, BusyBox Awk
address@hidden sorgente, codice, BusyBox Awk
+BusyBox @`e un programma distribuito con licenza GPL che fornisce versioni
+ridotte di parecchie piccole applicazioni, all'interno di un singolo modulo
+eseguibile. @`E stato ideato per sistemi
+integrati.
+Include un'implementazione completa di POSIX @command{awk}. Quando lo si
+compila occorre prestare attenzione a non eseguire @samp{make install},
perch@'e
+in questo modo si andrebbero a sostituire copie di altre applicazioni nella
+directory @file{/usr/local/bin} del sistema corrente. Per ulteriori
+informazioni, si veda @uref{http://busybox.net, la pagina principale del
progetto}.
+
address@hidden OpenSolaris
address@hidden Solaris, versione POSIX @command{awk}
address@hidden codice sorgente, Solaris @command{awk}
address@hidden sorgente, codice, Solaris @command{awk}
address@hidden POSIX @command{awk} per OpenSolaris
+Le versioni di @command{awk} in @file{/usr/xpg4/bin} e @file{/usr/xpg6/bin} su
+Solaris sono @dfn{grosso modo} conformi allo standard POSIX. Sono basate sul
+comando @command{awk} preparato per i PC dalla ditta Mortice Kern. @`E stato
+possibile compilare e far funzionare questo codice sotto GNU/Linux dopo 1--2
+ore di lavoro. Rendere questo codice address@hidden generalmente portabile
(usando gli
+strumenti GNU Autoconf e/o Automake) richiederebbe ulteriore lavoro, che non
@`e
+stato fin qui compiuto, almeno per quel che risulta a chi scrive.
+
address@hidden Illumos
address@hidden Illumos, @command{awk} conforme a POSIX e
address@hidden codice sorgente, Illumos @command{awk}
address@hidden sorgente, codice, Illumos @command{awk}
+Il codice sorgente era un tempo disponibile dal sito web OpenSolaris.
+Tuttavia, il progetto @`e terminato, e il sito web chiuso. Fortunatamente,
+il progetto
address@hidden://wiki.illumos.org/display/illumos/illumos+Home, Illumos}
+mette a disposizione questa implementazione. Si possono vedere i singoli file
in
address@hidden://github.com/joyent/illumos-joyent/blob/master/usr/src/cmd/awk_xpg4}.
+
address@hidden @command{jawk}
address@hidden Java, implementazione di @command{awk}
address@hidden implementazione Java di @command{awk}
address@hidden codice sorgente, @command{jawk}
address@hidden sorgente, codice, @command{jawk}
address@hidden @command{jawk}
+Questo @`e un interprete per @command{awk} scritto in Java. Dichiara di
+essere un interprete completo, anche se, poich@'e usa address@hidden di Java
+per l'I/O e per la ricerca di @dfn{regexp}, il linguaggio che supporta
address@hidden differente da @command{awk} POSIX.
+Ulteriori informazioni sono disponibili sulla
address@hidden://jawk.sourceforge.net, pagina principale del progetto}.
+
address@hidden Libmawk
address@hidden @command{libmawk}
address@hidden codice sorgente, @command{libmawk}
address@hidden sorgente, codice, @command{libmawk}
+Questo @`e un interprete @command{awk} incorporabile, derivato da
address@hidden Per ulteriori informazioni, si veda
address@hidden://repo.hu/projects/libmawk/}.
+
address@hidden @code{pawk}
address@hidden codice sorgente, @command{pawk} (versione Python)
address@hidden sorgente, codice, @command{pawk} (versione Python)
address@hidden @code{pawk}, implementazione simile ad @command{awk} per Python
+Questo @`e un modulo Python che intende introdurre address@hidden di tipo
address@hidden in Python. Si veda @uref{https://github.com/alecthomas/pawk} per
+ulteriori informazioni. (Questo programma non @`e correlato con la versione
+modificata da Nelson Beebe di BWK @command{awk}, descritta prima.)
+
address@hidden @w{QSE @command{awk}}
address@hidden QSE @command{awk}
address@hidden codice sorgente, QSE @command{awk}
address@hidden sorgente, codice, QSE @command{awk}
+Questo @`e un interprete di @command{awk} incorporabile. Per ulteriori
+informazioni, si veda
address@hidden://code.google.com/p/qse/} e @uref{http://awk.info/?tools/qse}.
+
address@hidden @command{QTawk}
address@hidden QuikTrim Awk
address@hidden codice sorgente, QuikTrim Awk
address@hidden sorgente, codice, QuikTrim Awk
+Questa @`e un'implementazione indipendente di @command{awk} distribuita con la
+licenza GPL. Ha un gran numero di estensioni rispetto ad @command{awk}
+standard, e address@hidden non essere sintatticamente compatibile al 100% con
esso. Si
+veda @uref{http://www.quiktrim.org/QTawk.html} per ulteriori informazioni,
+compreso il manuale. Il puntatore per scaricare QuikTrim non punta all'ultima
+versione: si veda @uref{http://www.quiktrim.org/#AdditionalResources} per un
+puntatore alla versione corrente.
+
+Il progetto sembra essere fermo; non ci sono nuove versioni del codice
+a partire dal 2014 circa.
+
address@hidden Altre versioni
+Si veda anche [in inglese] la sezione ``Versions and implementations''
+della voce di
address@hidden://en.wikipedia.org/wiki/Awk_language#Versions_and_implementations,
+Wikipedia} su @command{awk} per informazioni su ulteriori versioni.
+
address@hidden table
+
address@hidden Sommario dell'installazione
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+La distribuzione di @command{gawk} @`e disponibile dal sito principale
+di distribuzione del Progetto GNU
address@hidden La maniera canonica per scaricarlo e installarlo @`e:
+
address@hidden
+wget http://ftp.gnu.org/gnu/gawk/address@hidden@value{PATCHLEVEL}.tar.gz
+tar -xvpzf address@hidden@value{PATCHLEVEL}.tar.gz
+cd address@hidden@value{PATCHLEVEL}
+./configure && make && make check
address@hidden example
+
address@hidden
address@hidden address@hidden essere installato anche su sistemi non-POSIX. I
sistemi
+correntemente supportati sono MS-Windows, usando
+MSYS, MinGW, e Cygwin,
+e sia Vax/VMS che OpenVMS. Le istruzioni per ognuno di questi sistemi sono
+incluse in questa @value{APPENDIX}.
+
address@hidden
+Le segnalazioni di errori (bug) dovrebbero essere spedite tramite email a
address@hidden@@gnu.org}. Le segnalazioni di errore dovrebbero essere scritte
+in inglese e dovrebbero specificare la versione di @command{gawk} in uso, come
address@hidden stata compilata, un breve programma e un @value{DF} che
permettono di
+riprodurre il problema.
+
address@hidden
+Ci sono alcune altre implementazioni di @command{awk} disponibili
+gratuitamente. Molte rispettano lo standard POSIX; altre un po' meno.
+
address@hidden itemize
+
+
address@hidden FOR_PRINT
address@hidden Note
address@hidden Note di implementazione
address@hidden @command{gawk}, problemi di implementazione
address@hidden problemi di implementazione, @command{gawk}
+
+Quest'appendice contiene informazioni che interessano soprattutto le persone
+che aggiornano e mantengono @command{gawk}. L'intero contenuto si applica
+specificatamente a @command{gawk} e non ad altre implementazioni.
+
address@hidden
+* address@hidden di address@hidden:: Come inibire alcune estensioni di
+ @command{gawk}.
+* Aggiunte:: Fare aggiunte a @command{gawk}.
+* Future estensioni:: Nuove address@hidden che potranno
+ essere implementate in futuro.
+* Limitazioni dell'implementazione:: Alcune limitazioni
+ dell'implementazione.
+* Progetto delle estensioni:: Note di progetto sull'estensione API.
+* Meccanismo delle vecchie estensioni:: Alcune address@hidden per le vecchie
+ estensioni.
+* Sommario delle note:: Sommario delle note di
+ implementazione.
address@hidden menu
+
address@hidden address@hidden di address@hidden
address@hidden address@hidden all'indietro e debug
address@hidden @command{gawk}, problemi di implementazione, address@hidden
all'indietro
address@hidden @command{gawk}, problemi di implementazione, debug
address@hidden risoluzione di problemi, @command{gawk}
address@hidden problemi, risoluzione di, @command{gawk}
address@hidden problemi di address@hidden @command{gawk}, debug
+
address@hidden/GNU},
+per un compendio delle estensioni GNU per il linguaggio e il programma
address@hidden Tutte queste address@hidden possono essere inibite invocando
address@hidden con l'opzione @option{--traditional} o con l'opzione
address@hidden
+
+Se @command{gawk} @`e stato compilato per il debug con @samp{-DDEBUG}, @`e
+possibile specificare un'ulteriore opzione sulla riga di comando:
+
address@hidden @code
address@hidden -Y
address@hidden --parsedebug
+Stampa l'informazione contenuta nella pila di analisi, durante la fase di
+analisi iniziale del programma.
address@hidden table
+
+Quest'opzione @`e utile solo a chi sviluppa @command{gawk} e non all'utente
+occasionale. @`E probabile che non sia neppure disponibile nella versione di
address@hidden che si sta usando, perch@'e rallenta l'esecuzione del programma.
+
address@hidden Aggiunte
address@hidden Fare aggiunte a @command{gawk}
+
+Se si desidera migliorare @command{gawk} in maniera significativa, c'@`e la
+massima address@hidden di farlo. @`E questo lo scopo del software libero; il
codice
+sorgente @`e disponibile, ed @`e possibile modificarlo a piacere
+(@pxref{Copia}).
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta di come @`e possibile modificare @command{gawk},
+ed espone alcune considerazioni che si dovrebbero tenere presenti.
+
address@hidden
+* Accedere ai sorgenti:: Accedere al deposito dei sorgenti Git.
+* Aggiungere codice:: Aggiungere codice al programma
+ principale @command{gawk}.
+* Nuovi sistemi:: Portare @command{gawk} su un nuovo sistema
+ operativo.
+* File derivati:: Perch@'e i file derivati sono tenuti
+ nel deposito @command{git}.
address@hidden menu
+
address@hidden Accedere ai sorgenti
address@hidden Accedere al deposito dei sorgenti Git di @command{gawk}
+
+Poich@'e @command{gawk} @`e Software Libero, il codice sorgente @`e sempre
+disponibile.
address@hidden
+La
address@hidden iftex
address@hidden di Gawk} descrive come scaricare e installare
+le versioni ufficiali rilasciate di @command{gawk}.
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
+Peraltro, se si intende modificare @command{gawk} e mettere a disposizione le
+modifiche, @`e preferibile lavorare sulla versione in via di sviluppo. Per far
address@hidden @`e necessario accedere al deposito del codice sorgente di
@command{gawk}.
+Il codice @`e mantenuto usando il @uref{http://git-scm.com, sistema distribuito
+di controllo delle versioni Git}. address@hidden necessario installarlo se
non @`e address@hidden
+presente nel sistema. Quando @command{git} @`e disponibile, va usato il
comando:
+
address@hidden
+git clone git://git.savannah.gnu.org/gawk.git
address@hidden example
+
address@hidden
+Questo comando scarica in locale una copia esatta del deposito dei
+sorgenti di @command{gawk}. Se si sta usando un @dfn{firewall}
+che non consente l'uso del protocollo nativo di Git, @`e possibile accedere
+ugualmente al deposito usando il comando:
+
address@hidden
+git clone http://git.savannah.gnu.org/r/gawk.git
address@hidden example
+
+Una volta modificato il sorgente, @`e posibile usare @samp{git diff} per
+produrre una @dfn{patch}, e spedirla al manutentore di @command{gawk}; si veda
address@hidden, per come farlo.
+
+In passato era disponibile un'interfaccia Git--CVS
+utilizzabile da persone che non avevano a disposizione Git. Purtroppo,
+quest'interfaccia non funziona address@hidden, ma si potrebbe avere maggior
fortuna usando
+un sistema di controllo versioni address@hidden moderno, come Bazaar, che @`e
dotato di
+un'estensione Git per lavorare con depositi di sorgenti Git.
+
address@hidden Aggiungere codice
address@hidden Aggiungere nuove address@hidden
+
address@hidden @command{gawk}, aggiungere address@hidden a
address@hidden address@hidden, aggiungere a @command{gawk}
address@hidden aggiungere address@hidden a @command{gawk}
+Ognuno @`e libero di aggiungere tutte le nuove address@hidden che vuole a
address@hidden Comunque, se si desidera che tali modifiche siano incorporate
+nella distribuzione di @command{gawk}, ci sono parecchi passi da fare per
+rendere possibile la loro inclusione:
+
address@hidden 1
address@hidden
+Prima di inserire la nuova address@hidden all'interno di @command{gawk},
+prendere in considerazione la address@hidden di scriverla sotto forma di
+estensione (@pxref{Estensioni dinamiche}).
+Se address@hidden non @`e possibile, continuare con i passi rimanenti
descritti in questa
+lista.
+
address@hidden
+Essere disposti a firmare un documento liberatorio appropriato.
+Se l'FSF deve poter distribuire le modifiche, queste vanno dichiarate
+di pubblico dominio, tramite la firma di un documento apposito, oppure
+attribuendo il copyright delle modifiche all'FSF.
+Entrambe queste azioni sono semplici da fare, e @emph{molte} persone
address@hidden
+l'hanno fatto. Se ci sono domande da fare, mettersi in contatto con me
+(@pxref{Bug}),
+oppure @EMAIL{assign@@gnu.org,assign chiocciola gnu punto org}.
+
address@hidden
+Utilizzare l'ultima versione.
address@hidden molto address@hidden semplice per me integrare modifiche se sono
basate sull'ultima
+versione disponibile di @command{gawk} o, meglio ancora, sull'ultimo codice
+sorgente presente nel deposito Git. Se la versione di @command{gawk} @`e molto
+vecchia, potrei non essere affatto in grado di integrare le modifiche.
+(@xref{Scaricare},
+per informazioni su come ottenere l'ultima versione di @command{gawk}.)
+
address@hidden
address@hidden
+Seguire gli @cite{Standard di codifica GNU}.
address@hidden ifnotinfo
address@hidden
+Si veda @inforef{Top, , Version, standards, Standard di Codifica GNU}.
address@hidden ifinfo
+Questo documento descrive come dovrebbe essere scritto il software GNU.
+Se non lo si @`e letto, @`e bene farlo, preferibilmente @emph{prima}
+di iniziare a modificare @command{gawk}.
+(Gli @cite{Standard di codifica GNU} sono disponibili nel sito web del
address@hidden://www.gnu.org/prep/standards/, Progetto GNU}.
+Sono disponibili anche versioni in formato Texinfo, Info, e DVI.)
+
address@hidden @command{gawk}, stile di codifica in
address@hidden
+Usare lo stile di codifica @command{gawk}.
+Il codice sorgente in C di @command{gawk} segue le istruzioni dello
address@hidden di codifica GNU}, con qualche piccola eccezione. Il codice @`e
+formattato usando lo stile tradizionale ``K&R'', in particolare per
address@hidden che
+riguarda il posizionamento delle parentesi graffe e l'uso del carattere TAB.
+In breve, le regole di codifica per @command{gawk}
+sono le seguenti:
+
address@hidden @value{BULLET}
address@hidden
+Usare intestazioni di funzione (prototipi) in stile ANSI/ISO quando
+si definiscono delle funzioni.
+
address@hidden
+Mettere il nome della funzione all'inizio della riga in cui la si sta
definendo.
+
address@hidden
+Usare @samp{#elif} invece di nidificare istruzioni @samp{#if} all'interno
+di un'istruzione @samp{#else}.
+
address@hidden
+Mettere il tipo di codice di ritorno della funzione, anche se @`e @code{int},
+sulla riga immediatamente sopra quella che contiene il nome e gli argomenti
+della funzione.
+
address@hidden
+Mettere degli spazi attorno alle parentesi usate nelle strutture di controllo
+(@code{if}, @code{while}, @code{for}, @code{do}, @code{switch}
+e @code{return}).
+
address@hidden
+Non mettere spazi davanti alle parentesi usate nelle chiamate di funzione.
+
address@hidden
+Mettere spazi attorno a tutti gli operatori C e dopo le virgole,
+nelle chiamate di funzione.
+
address@hidden
+Non usare l'operatore @dfn{virgola} per produrre degli effetti collaterali
+multipli, tranne che nelle parti di inizializzazione e incremento dei cicli
address@hidden, e nel corpo delle macro.
+
address@hidden
+Usare dei caratteri TAB per l'indentazione, e non dei semplici spazi.
+
address@hidden
+Usare lo stile ``K&R'' per formattare le parti di programma incluse fra
+parentesi graffe.
+
address@hidden
+Usare confronti con @code{NULL} e @code{'\0'} per le condizioni
+contenute nelle istruzioni @code{if}, @code{while} e @code{for}, e anche
+nelle varie clausole @code{case} delle istruzioni @code{switch}, invece
+del semplice puntatore o il semplice valore del carattere.
+
address@hidden
+Usare i valori @code{true} e @code{false} per le variabili @code{booleane},
+la costante simbolica @code{NULL} per i valori dei puntatori,
+e la costante carattere @code{'\0'} quando @`e il caso, invece dei valori
@code{1}
+e @code{0}.
+
address@hidden
+Fornire un commento descrittivo di una riga per ogni funzione.
+
address@hidden
+Non usare la funzione @code{alloca()} per allocare memoria dalla @dfn{stack}.
+Il farlo genera dei problemi di address@hidden che non giustificano il
vantaggio
+secondario di non doversi preoccupare di liberare la memoria. Usare invece
address@hidden()} e @code{free()}.
+
address@hidden
+Non usare confronti nella forma @samp{! strcmp(a, b)} o simili.
+Come disse una volta Henry Spencer, address@hidden()} non @`e una funzione
+booleana!'' Usare invece @samp{strcmp(a, b) == 0}.
+
address@hidden
+Per aggiungere nuovi valori a @dfn{flag} binari, usare costanti esadecimali
+esplicite (@code{0x001}, @code{0x002}, @code{0x004}, etc.) invece che
+spostare di un bit a sinistra in incrementi successivi
+(@samp{(1<<0)}, @samp{(1<<1)}, etc.).
address@hidden itemize
+
address@hidden NOTA
+Qualora fossi costretto a riformattare completamente il codice per
+farlo aderire allo stile di codifica usato in @command{gawk}, potrei anche
+decidere di ignorare del tutto le modifiche proposte.
address@hidden quotation
+
address@hidden Texinfo
address@hidden
+Aggiornare la documentazione.
+Insieme col nuovo codice, fornire nuove sezioni e/o capitoli per questo
address@hidden Per quanto possibile, usare il formato Texinfo, invece
+di fornire soltanto del testo ASCII non formattato (sebbene un semplice testo
+sia address@hidden meglio che nessuna documentazione). Le convenzioni da
seguire in
address@hidden@value{TITLE}} sono elencate dopo la parole chiave @samp{@@bye}
alla fine
+del file sorgente Texinfo. Se possibile, aggiornare anche la pagina di manuale
+in formato @command{man}.
+
+Si address@hidden anche firmare un documento liberatorio relativo alle
+modifiche apportate alla documentazione.
+
address@hidden @command{git}, programma di address@hidden
address@hidden programma di address@hidden @command{git}
address@hidden
+Inviare le modifiche come file di differenze nel formato contestuale unificato.
+Usare @samp{diff -u -r -N} per confrontare i sorgenti originali dell'albero
+di sorgenti @command{gawk} con la versione proposta.
+Si raccomanda di usare la versione GNU di @command{diff} o, ancora meglio,
address@hidden diff} o @samp{git format-patch}.
+Per inviare le modifiche proposte spedire l'output prodotto da @command{diff}.
+(@xref{Bug}, per l'indirizzo di posta elettronica.)
+
+L'uso di questo formato rende semplice per me l'applicazione delle modifiche
+alla versione principale del sorgente di @command{gawk} (usando il programma di
address@hidden @code{patch}). Se invece tocca a me applicare le modifiche a
mano,
+con un editor di testo, potrei decidere di non farlo, specialmente
+se le modifiche sono molte.
+
address@hidden
+Includere una descrizione da aggiungere al file @file{ChangeLog} riguardo alla
+modifica da voi proposta. Questo serve a minimizzare l'address@hidden a me
+richiesta, rendendo address@hidden facile per me l'accettazione delle
modifiche, che
+diventa address@hidden semplice se si include anche questa parte nel file di
differenze
+(nel formato @dfn{diff}).
address@hidden enumerate
+
+Sebbene questa possa sembrare una richiesta molto esigente, si tenga presente
+che, anche se il nuovo codice non @`e opera mia, tocca poi a me manutenerlo e
+correggere eventuali errori. Se non @`e possibile per me farlo senza perderci
+troppo tempo, potrei anche lasciar perdere la modifica.
+
address@hidden Nuovi sistemi
address@hidden Portare @command{gawk} su un nuovo Sistema Operativo
address@hidden address@hidden, @command{gawk}
address@hidden sistemi operativi, portare @command{gawk} su altri
+
address@hidden portare @command{gawk}
+Se si vuol portare @command{gawk} su di un nuovo sistema operativo, sono
+necessari parecchi passi:
+
address@hidden 1
address@hidden
+Seguire le linee-guida contenute
address@hidden
+in @ref{Aggiungere codice},
address@hidden ifinfo
address@hidden
+nella precedente @value{SECTION}
address@hidden ifnotinfo
+relative allo stile di codifica, all'invio delle differenze proposte, etc.
+
address@hidden
+Essere disposti a firmare un documento liberatorio appropriato.
+Se l'FSF deve poter distribuire le modifiche, queste vanno dichiarate
+di pubblico dominio, tramite la firma di un documento apposito, oppure
+attribuendo il copyright delle modifiche all'FSF.
+Entrambe queste azioni sono semplici da fare, e @emph{molte} persone
address@hidden
+l'hanno fatto. Se ci sono domande da fare, scrivere a me
+oppure all'indirizzo @email{gnu@@gnu.org}.
+
address@hidden
+Nel realizzare un @dfn{port}, tener presente che il codice
+deve coesistere pacificamente con il resto di @command{gawk} e con le
+versioni per altri sistemi operativi.
+Evitare modifiche non necessarie alla parte di codice che @`e indipendente
+dal sistema operativo. Se possibile, evitare di disseminare @samp{#ifdef},
+utili solo per il proprio @dfn{port}, all'interno del codice sorgente.
+
+Se le modifiche necessarie per un particolare sistema coinvolgono una parte
+troppo rilevante del codice, @`e probabile che io non le accetti.
+In questo caso si possono, naturalmente, distribuire le modifiche per
+proprio conto, basta che si rispettino i vincoli della GPL
+(@pxref{Copia}).
+
address@hidden
+Un certo numero di file che fanno parte della distribuzione di @command{gawk}
+sono mantenuti da terze persone e non dagli sviluppatori di @command{gawk}.
+Quindi, non si dovrebbero cambiare, se non per ragioni molto
+valide; vale a dire, modifiche a questi file non sono impossibili, ma
+le modifiche a questi file saranno controllate con estrema attenzione.
+I file sono
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden
+Un certo numero di altri file sono prodotti dagli Autotool [comandi di
+configurazione] di GNU (Autoconf, Automake, e GNU @command{gettext}).
+Neppure questi file dovrebbero essere modificati, se non per ragioni molto
+valide. I file sono
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
+e
address@hidden
+
address@hidden
+Essere disponibili a continuare a manutenere il @dfn{port}.
+I sistemi operativi non-Unix sono supportati da volontari che tengono
+aggiornato il codice necessario per compilare ed eseguire @command{gawk}
+nei loro sistemi. Se nessuno @`e disponibile a tener aggiornato un @dfn{port},
+questo diventa non address@hidden supportato, e address@hidden essere
necessario rimuoverlo dalla
+distribuzione.
+
address@hidden
+Fornire un appropriato file @file{gawkmisc.???}.
+Ogni @dfn{port} ha il proprio @file{gawkmisc.???} che implementa alcune
+funzioni specifiche per quel sistema operativo. Questa @`e una soluzione
address@hidden
+pulita, rispetto a una address@hidden di @samp{#ifdef} sparsi nel codice. Il
file
address@hidden nella directory principale dei sorgenti include gli
+appropriati file @file{gawkmisc.???} da ogni sottodirectory. Anche
+quest'ultimo file va aggiornato.
+
+Ogni file @file{gawkmisc.???} del @dfn{port} ha un suffisso esplicativo
+del tipo di macchina o del sistema operativo in questione---per esempio,
address@hidden/gawkmisc.pc} e @file{vms/gawkmisc.vms}. L'uso di suffissi
distinti
+invece di un semplice @file{gawkmisc.c}, rende possibile spostare file da
+una sottodirectory propria del @dfn{port} nella sottodirectory principale,
+senza cancellare incidentalmente il file @file{gawkmisc.c} vero e proprio.
+(Al momento, questo rappresenta un problema solo per i @dfn{port} ai
+sistemi operativi dei PC.)
+
address@hidden
+Fornire un @file{Makefile} e ogni altro file sorgente o di intestazione in C
+che sia necessario per il proprio sistema operativo. Tutto il codice dovrebbe
+stare in una sottodirectory a parte, il cui nome sia lo stesso, o
+sia indicativo, del proprio sistema operativo o del tipo di computer.
+Se possibile, tentare di strutturare il codice in modo che non sia necessario
+spostare file dalla propria sottodirectory nella directory principale del
+codice sorgente. Se address@hidden non @`e possibile, evitare nel modo
address@hidden assoluto di
+usare nomi per i file che siano duplicati di nomi di file presenti nella
+directory principale del codice sorgente.
+
address@hidden
+Aggiornare la documentazione.
+Scrivere una sezione (o address@hidden sezioni) per questo @value{DOCUMENT}
+che descriva i passi di installazione e compilazione necessari per compilare
+e/o installare @command{gawk} per il sistema desiderato.
address@hidden enumerate
+
+Seguire queste indicazioni facilita molto l'integrazione delle
+modifiche in @command{gawk} e la loro felice coesistenza con il codice di
+altri sistemi operativi address@hidden presenti.
+
+Nel codice che viene fornito e tenuto aggiornato, si possono
+tranquillamente usare uno stile di codifica e una disposizione delle
+parentesi graffe di proprio gradimento.
+
address@hidden File derivati
address@hidden Perch@'e i file generati sono tenuti in Git
+
address@hidden Git, uso per il codice sorgente di @command{gawk}
address@hidden From emails written March 22, 2012, to the gawk developers list.
+
+Se si esaminano i sorgenti di @command{gawk} nel deposito Git
+si address@hidden che sono inclusi file generati automaticamente dagli
strumenti
+dell'infrastruttura GNU, come @file{Makefile.in} generato da Automake e
+anche @file{configure} proveniente da Autoconf.
+
+Questo comportamento @`e differente da quello di molti progetti di
+Libero Software che non memorizzano i file derivati, per mantenere
address@hidden
+sgombro il deposito Git, rendendo address@hidden@dotless{i}} address@hidden
facile comprendere quali sono le
+modifiche sostanziali confrontando differenti versioni, nel tentativo di
+capire cosa @`e cambiato tra una modifica e la precedente.
+
+Tuttavia, ci sono parecchie ragioni per le quali il manutentore di
address@hidden preferisce mantenere ogni cosa nel deposito Git.
+
+Innanzitutto, perch@'e in questo modo @`e facile generare completamente ogni
+data versione, senza doversi preoccupare di avere a disposizione altri
+strumenti (address@hidden vecchi, probabilmente obsoleti, e in qualche caso
+perfino impossibili da trovare).
+
+Come esempio estremo, se solo si pensa di tentare di compilare, diciamo, la
+versione Unix V7 di @command{awk}, ci si accorge che non solo @`e necessario
+scaricare e ricompilare la versione V7 del comando @command{yacc} per farlo, ma
+anche che serve la versione V7 del comando @command{lex}. E quest'ultima @`e
+praticamente impossibile farla funzionare in un sistema GNU/Linux dei giorni
address@hidden abbiamo provato. @`E stata un'esperienza dolorosa.}
+
+(Oppure, diciamo che la versione 1.2 di @command{gawk} richiede il comando
address@hidden come funzionava nel 1989, e non @`e presente il file
address@hidden [generato tramite @command{bison}] nel deposito Git. Che cosa
+ci garantisce di riuscire a trovare quella versione di @command{bison}? O che
address@hidden riesca a generarlo?)
+
+Se il deposito Git comprende tutti i file derivati,
address@hidden facile, dopo averli scaricati, ricostruire il programma.
(Oppure @`e @address@hidden
+facile}, a seconda di quanto si vuole risalire indietro nel tempo).
+
+E qui arriviamo alla seconda (e address@hidden valida) ragione per cui tutti i
file
+devono essere proprio nel deposito Git. Domandiamoci a chi ci si rivolge:
+agli sviluppatori di @command{gawk}, oppure a un utilizzatore che intende
+solo scaricare una data versione e provarla?
+
+Il manutentore di @command{gawk} desidera che per tutti gli utenti
address@hidden interessati sia possibile limitarsi a clonare il deposito sul
+proprio computer, selezionare la variante che lo interessa e costruirla. Senza
+doversi preoccupare di avere a disposizione le versioni corrette degli Autotool
address@hidden un programma GNU che (secondo noi) @`e estremamente difficile
+da estrarre dal deposito Git e compilare. Per esempio, in un vecchio (ma
+ancora funzionante) PowerPC Macintosh, con il sistema operativo Mac Os X 10.5,
address@hidden stato necessario scaricare e compilare una tonnellata di
software,
+incominciando dallo stesso programma Git, per riuscire a lavorare con l'ultima
+versione del codice. Non @`e un'esperienza piacevole e, specie sui vecchi
+sistemi, @`e una notevole perdita di tempo.
+
+Neppure partire dall'ultimo archivio @command{tar} compresso @`e stata una
+passeggiata: i manutentori avevano eliminato i file compressi in formato
address@hidden e @file{.bz2} sostituendoli con file di tipo @file{.tar.xz}.
+Bisognava quindi per prima cosa scaricare e compilare @command{xz}}.
+A questo serve il file @file{bootstrap.sh}. Va a "toccare"
+[tramite il comando @command{touch}] vari altri file nell'ordine richiesto
+in modo che
+
address@hidden
+# La formula canonica per compilare il software GNU:
+./bootstrap.sh && ./configure && make
address@hidden example
+
address@hidden
+tutto @emph{funzioni senza problemi}.
+
+Questo @`e estremamente importante per i rami
address@hidden e @address@hidden@var{Y}-stable}.
+
+Inoltre, il manutentore di @command{gawk} potrebbe sostenere che
address@hidden @`e importante anche per gli sviluppatori di @command{gawk}.
Tentando di
+scaricare il ramo @address@hidden ramo (non address@hidden presente) creato da
+uno degli altri sviluppatori, e che non includeva i file generati.} per
+compilarlo, non ci address@hidden@dotless{i}}. (Mancava il file
@file{ltmain.sh}, ed egli non
+aveva idea di come crearlo, e c'erano anche ulteriori problemi.)
+
+La cosa lo address@hidden in uno stato di frustrazione @emph{estrema}.
Riguardo a quel
+ramo, il manutentore @`e in una posizione non differente da quella di un utente
+generico che voglia tentare di compilare @code{gawk-4.1-stable} o @code{master}
+dal deposito Git.
+
+Quindi, il manutentore ritiene che sia non solo importante, ma cruciale, che
+per ogni dato ramo la formula canonica evocata prima
address@hidden senza problemi}.
+
address@hidden Added 9/2014:
+Una terza ragione per avere tutti i file @`e che senza di essi, usare @samp{git
+bisect} per tentare di trovare quale modifica ha introdotto un errore diventa
+estremamente difficile. Il manutentore ha tentato di farlo su un altro
+progetto che richiede di eseguire @dfn{script} di inizializzazione allo scopo
+di creare lo @dfn{script} @command{configure} e address@hidden@dotless{i}}
via; @`e stata un'esperienza
+veramente dolorosa. Se invece il deposito Git contiene tutto il necessario,
+usare @command{git bisect} al suo interno @`e molto facile.
+
address@hidden So - that's my reasoning and philosophy.
+
+Quali sono, quindi, alcune delle conseguenze e/o delle cose da fare?
+
address@hidden 1
address@hidden
+Non importa se ci sono file differenti nei diversi rami
+prodotti da versioni differenti degli Autotool.
+
address@hidden A
address@hidden
+Spetta al manutentore integrarli tra loro, e se ne address@hidden lui.
+
address@hidden
address@hidden facile per lui eseguire @samp{git diff x y > /tmp/diff1 ; gvim
/tmp/diff1}
+per rimuovere le differenze che non sono rilevanti ai fini della revisione
+del codice sorgente.
address@hidden enumerate
+
address@hidden
+Sarebbe sicuramente d'aiuto se tutti usassero le stesse versioni degli Autotool
+GNU che lui usa, che in generale sono le ultime versioni rilasciate di
+Automake,
+Autoconf,
address@hidden
+e
+GNU @command{gettext}.
+
address@hidden
+If it would help if I sent out an ``I just upgraded to version x.y
+of tool Z'' kind of message to this list, I can do that. Up until
+now it hasn't been a real issue since I'm the only one who's been
+dorking with the configuration machinery.
address@hidden ignore
+
address@hidden @enumerate A
address@hidden @item
+Installare a partire dal sorgente @`e abbastanza facile. @`E il modo con cui
il
+manutentore ha lavorato per anni (e ancora lavora).
+Egli aveva @file{/usr/local/bin} all'inizio del suo @env{PATH} e dava i
+seguenti comandi:
+
address@hidden
+wget http://ftp.gnu.org/gnu/@var{package}/@address@hidden@address@hidden
+tar -xpzvf @address@hidden@address@hidden
+cd @address@hidden@address@hidden
+./configure && make && make check
+make install # come utente root
address@hidden example
+
address@hidden @item
address@hidden
+These days the maintainer uses Ubuntu 12.04 which is medium current, but
+he is already doing the above for Automake, Autoconf, and @command{bison}.
address@hidden ignore
+
address@hidden
+(C. Rant: Recent Linux versions with GNOME 3 really suck. What
+ are all those people thinking? Fedora 15 was such a bust it drove
+ me to Ubuntu, but Ubuntu 11.04 and 11.10 are totally unusable from
+ a UI perspective. Bleah.)
address@hidden ignore
address@hidden @end enumerate
+
address@hidden
address@hidden
+If someone still feels really strongly about all this, then perhaps they
+can have two branches, one for their development with just the clean
+changes, and one that is buildable (xgawk and xgawk-buildable, maybe).
+Or, as I suggested in another mail, make commits in pairs, the first with
+the "real" changes and the second with "everything else needed for
+ building".
address@hidden ignore
address@hidden enumerate
+
+La maggior parte del testo precedente fa parte di messaggi scritti
+originalmente dal manutentore agli altri sviluppatori @command{gawk}.
+Da uno degli sviluppatori @`e stata avanzata l'obiezione
address@hidden che chi scarica il sorgente da Git
+non @`e un utente finale''.
+
+Tuttavia, questo non @`e esatto. Ci sono ``utenti avanzati di @command{awk}''
+che possono installare @command{gawk} (usando la formula canonica vista sopra)
+ma che non conoscono il linguaggio C. Quindi, i rami address@hidden rilevanti
+dovrebbero essere sempre compilabili.
+
address@hidden stato proposto poi di lanciare ogni notte uno @dfn{script}
tramite il
+programma di address@hidden @command{cron} per creare archivi in formato
@command{tar}
+contenenti tutto ``il codice sorgente.'' Il problema in questo caso @`e che
+ci sono differenti alberi di sorgenti, che corrispondono ai vari rami!
+Quindi gli archivi notturni in questione non sono una risposta valida, anche
+per il fatto che il deposito Git address@hidden rimanere senza alcuna modifica
+significativa per settimane intere.
+
+Fortunatamente, il server Git address@hidden rispondere a questa esigenza.
Per ogni
+dato ramo chiamato @var{nome-ramo}, basta usare:
+
address@hidden
+wget http://git.savannah.gnu.org/cgit/gawk.git/snapshot/address@hidden
address@hidden example
+
address@hidden
+per ottenere una copia utilizzabile del ramo in questione.
+
address@hidden Future estensioni
address@hidden Probabili estensioni future
address@hidden
+From emory!scalpel.netlabs.com!lwall Tue Oct 31 12:43:17 1995
+Return-Path: <emory!scalpel.netlabs.com!lwall>
+Message-Id: <address@hidden>
+To: address@hidden (Arnold D. Robbins)
+Subject: Re: May I quote you?
+In-Reply-To: Your message of "Tue, 31 Oct 95 09:11:00 EST."
+ <address@hidden>
+Date: Tue, 31 Oct 95 09:32:46 -0800
+From: Larry Wall <emory!scalpel.netlabs.com!lwall>
+
+: Greetings. I am working on the release of gawk 3.0. Part of it will be a
+: thoroughly updated manual. One of the sections deals with planned future
+: extensions and enhancements. I have the following at the beginning
+: of it:
+:
+: @cindex PERL
+: @cindex Wall, Larry
+: @display
+: @i{AWK is a language similar to PERL, only considerably more elegant.} @*
+: Arnold Robbins
+: @sp 1
+: @i{Hey!} @*
+: Larry Wall
+: @end display
+:
+: Before I actually release this for publication, I wanted to get your
+: permission to quote you. (Hopefully, in the spirit of much of GNU, the
+: implied humor is visible... :-)
+
+I think that would be fine.
+
+Larry
address@hidden ignore
address@hidden Perl
address@hidden Wall, Larry
address@hidden Robbins, Arnold
address@hidden
address@hidden @`e un linguaggio simile a PERL, solo che @`e notevolmente
address@hidden elegante.}
address@hidden Arnold Robbins
address@hidden quotation
+
address@hidden
address@hidden
address@hidden Larry Wall
address@hidden quotation
+
+Il file @file{TODO} nel ramo @code{master} del deposito Git di @command{gawk}
+contiene un elenco di possibili futuri miglioramenti. Alcuni di questi
+riguardano il codice sorgente, e altri possibili nuove address@hidden
+Consultare quel file per esaminare la lista.
address@hidden,
+se si @`e interessati a intraprendere qualcuno dei progetti address@hidden
elencati.
+
address@hidden Limitazioni dell'implementazione
address@hidden Alcune limitazioni dell'implementazione
+
+La tabella seguente specifica i limiti di @command{gawk} in un sistema di
+tipo Unix (sebbene anche tra questi ci potrebbero essere variazioni). Altri
+sistemi operativi possono avere limiti differenti.
+
address@hidden @columnfractions .40 .60
address@hidden Caratteristica @tab Limiti
address@hidden Caratteri in una classe di caratteri @tab 2^(numero di bit per
byte)
address@hidden Lunghezza di un record in input @tab @code{MAX_INT}
address@hidden Lunghezza di un record in output @tab Illimitata
address@hidden Lunghezza di una riga di codice sorgente @tab Illimitata
address@hidden Numero di campi in un record @tab @code{MAX_LONG}
address@hidden Numero di ridirezioni di file @tab Illimitata
address@hidden Numero di record in input in un singolo file @tab @code{MAX_LONG}
address@hidden Numero totale di record in input @tab @code{MAX_LONG}
address@hidden Numero di ridirezioni via @dfn{pipe} @tab min(numero processi
per utente, numero di file aperti)
address@hidden Valori numerici @tab Numeri a virgola mobile in doppia
precisione (se non si usa la address@hidden MPFR)
address@hidden Dimensione di un campo @tab @code{MAX_INT}
address@hidden Dimensione di una stringa letterale @tab @code{MAX_INT}
address@hidden Dimensione di una stringa di @dfn{printf} @tab @code{MAX_INT}
address@hidden multitable
+
address@hidden Progetto delle estensioni
address@hidden Note di progetto dell'estensione API
+
+Questa @value{SECTION} documenta l'architettura dell'estensione API,
+inclusa una trattazione sommaria della progettazione e dei problemi che
+andavano risolti.
+
+La prima versione delle estensioni per @command{gawk} @`e stata sviluppata
+a address@hidden degli anni '90, e distribuita con la versione 3.1 di
@command{gawk},
+verso la fine degli anni '90.
+Il meccanismo e l'architettura sono rimasti gli stessi per quasi 15 anni,
+fino al 2012.
+
+Il vecchio meccanismo delle estensioni usava tipi di dati e funzioni dello
+stesso @command{gawk}, con un ``abile trucco'' per installare le funzioni
+di estensione.
+
+La distribuzione @command{gawk} conteneva alcuni esempi di estensioni, solo
+poche delle quali erano realmente utili. Tuttavia era chiaro fin da
+principio che il meccanismo di estensione era un'aggiunta improvvisata, e
+non era realmente ben concepito.
+
address@hidden
+* Problemi con le vecchie estensioni:: Problemi col vecchio meccanismo.
+* Obiettivi delle estensioni:: Obiettivi del nuovo meccanismo.
+* Altre scelte progettuali per le estensioni:: Qualche altra scelta
progettuale.
+* Futuri sviluppi delle estensioni:: address@hidden di crescita futura.
address@hidden menu
+
address@hidden Problemi con le vecchie estensioni
address@hidden Problemi con le vecchie estensioni
+
+Il vecchio meccanismo delle estensioni presentava parecchi problemi:
+
address@hidden @value{BULLET}
address@hidden
+Dipendeva eccessivamente dalla struttura interna di @command{gawk}. Ogni volta
+che la struttura @address@hidden struttura di dati fondamentale
+all'interno di @command{gawk}.} veniva modificata, ogni estensione doveva
+essere ricompilata. Inoltre, la scrittura di estensioni richiedeva una
+certa address@hidden con le funzioni interne di @command{gawk}. Esisteva
+un po' di documentazione in questo @value{DOCUMENT}, ma era ridotta al minimo.
+
address@hidden
+Per poter utilizzare servizi di @command{gawk} da un'estensione era necessario
+disporre di address@hidden del @dfn{linker}
+normalmente disponibili in ambiente di tipo Unix, ma non implementate
+nei sistemi MS-Windows; chi voleva utilizzare estensioni in
+MS-Windows doveva aggiungerle al modulo eseguibile di @command{gawk},
+anche se MS-Windows supporta il caricamento dinamico di oggetti condivisi.
+
address@hidden
+L'API di tanto in tanto veniva modificata, in parallelo ai cambiamenti di
address@hidden; nessuna address@hidden tra le versioni @`e stata mai prevista o
+resa disponibile.
address@hidden itemize
+
+Nonostante questi inconvenienti, gli sviluppatori del progetto @command{xgawk}
+si basarono su @command{gawk} per sviluppare parecchie estensioni
+significative. Inoltre, migliorarono le address@hidden, in @command{gawk}, di
+includere file e di accedere a oggetti condivisi.
+
+Una nuova API @`e rimasta un desiderio per lungo tempo, ma solo nel 2012
+il manutentore di @command{gawk} e gli sviluppatori di @command{xgawk}
+iniziarono finalmente a lavorare insieme. Ulteriori informazioni riguardanti
+il progetto @command{xgawk} sono forniti nella @ref{gawkextlib}.
+
address@hidden Obiettivi delle estensioni
address@hidden Obiettivi per un nuovo meccanismo
+
+Alcuni obiettivi per la nuova API sono:
+
address@hidden @value{BULLET}
address@hidden
+L'API dovrebbe essere indipendente dalla struttura interna di @command{gawk}.
+Le modifiche alla struttura interna di @command{gawk} dovrebbero essere
+irrilevanti per chi scrive una funzione di estensione.
+
address@hidden
+L'API dovrebbe consentire una address@hidden @emph{binaria} [ossia a livello
+di codice eseguibile, e non solo a livello di codice sorgente] tra diverse
+versioni di @command{gawk}, se la stessa API rimane invariata.
+
address@hidden
+L'API dovrebbe consentire che le estensioni scritte in C o C++ abbiano
+all'incirca la stessa ``struttura'', per il codice awk,
+di quella che hanno le funzioni di @command{awk}. Questo vuol dire che le
+estensioni dovrebbero avere:
+
address@hidden @value{MINUS}
address@hidden
+La address@hidden di accedere ai parametri delle funzioni.
+
address@hidden
+La address@hidden di trasformare un parametro indefinito in un vettore
+(chiamata per riferimento address@hidden reference}]).
+
address@hidden
+La address@hidden di creare, leggere e aggiornare variabili globali.
+
address@hidden
+Un accesso facile a tutti gli elementi di un vettore simultaneamente
+(``appiattimento del vettore'') in modo da poter visitare tutti gli elementi
+del vettore in una maniera semplice per un programma scritto in C.
+
address@hidden
+La address@hidden di creare vettori (compresi i veri "vettori di vettori" di
address@hidden).
address@hidden itemize
address@hidden itemize
+
+Alcuni ulteriori obiettivi rilevanti sono:
+
address@hidden @value{BULLET}
address@hidden
+L'API dovrebbe usare solo address@hidden disponibili nella specifica ISO C 90,
in
+modo da consentire estensioni scritte con una vasta gamma di compilatori C e
+C++. L'intestazione dovrebbe includere le appropriate direttive
address@hidden __cplusplus} e @samp{extern "C"}, in modo da poter utilizzare un
+compilatore C++. (Se si usa C++, il sistema operativo in uso dev'essere in
+grado di invocare dei costruttori e dei distruttori, poich@'e @command{gawk}
@`e un
+programma scritto in C. Al momento in cui queste note sono scritte, la cosa
+non @`e stata verificata).
+
address@hidden
+Il meccanismo API non dovrebbe aver bisogno di accedere ai simboli di
address@hidden@footnote{I @dfn{simboli} sono le variabili e le funzioni
+definite all'interno di @command{gawk}. Accedere a questi simboli da parte
+di codice esterno a @command{gawk} caricato dinamicamente al momento
+dell'esecuzione @`e problematico in ambiente MS-Windows.} da parte del
address@hidden statico, usato in fase di compilazione, o di quello dinamico,
+in modo da rendere possibile la creazione di estensioni che funzionino anche
+in ambiente MS-Windows.
address@hidden itemize
+
+In fase di sviluppo, @`e apparso evidente che dovevano essere disponibili alle
+estensioni anche altre address@hidden, che sono state
+successivamente implementate:
+
address@hidden @value{BULLET}
address@hidden
+Le estensioni dovrebbero essere in grado di agganciarsi al meccanismo di
+ridirezione dell'I/O di @command{gawk}. In particolare, gli sviluppatori di
address@hidden hanno programmato un cosiddetto ``gancio aperto'' (@dfn{open
+hook}) per gestire autonomamente la lettura dei record. In fase di sviluppo,
+questo meccanismo @`e stato generalizzato, per consentire alle estensioni di
+agganciarsi sia all'elaborazione dell'input, che a quella dell'output, nonch@'e
+all'I/O bidirezionale.
+
address@hidden
+Un'estensione dovrebbe poter rendere disponibile una funzione di ``call back''
+(richiamo) per effettuare operazioni di pulizia all'uscita di @command{gawk}.
+
address@hidden
+Un'estensione dovrebbe poter rendere disponibile una stringa di versione
address@hidden@dotless{i}} che l'opzione @option{--version}
+di @command{gawk} possa informare anche sulle versioni delle estensioni.
address@hidden itemize
+
+Il vincolo di evitare di accedere ai simboli di @command{gawk} address@hidden
parere a
+prima vista piuttosto difficile da rispettare.
+
+Un tipo di architettura, apparentemente usato da Perl e Ruby e forse da altri
+programmi, potrebbe consistere nel mettere il codice principale di
address@hidden in una libreria, limitando il programma di address@hidden
address@hidden a una piccola funzione @code{main()} in C che richiamerebbe
+dinamicamente la libreria.
+
+Questo inverte i ruoli del programma principale e della sua estensione, e
+complica sia la compilazione che l'installazione, trasformando la semplice
+copia del programma eseguibile @command{gawk} da un sistema all'altro (o da una
+posizione all'altra all'interno dello stesso sistema) in un'operazione ad alto
+rischio.
+
+Pat Rankin ha suggerito la soluzione che @`e stata adottata.
address@hidden sul meccanismo delle estensioni}, per maggiori dettagli.
+
address@hidden Altre scelte progettuali per le estensioni
address@hidden Altre scelte progettuali
+
+Per una scelta progettuale arbitraria, le estensioni possono accedere ai valori
+delle variabili e dei vettori predefiniti (come @code{ARGV} e @code{FS}), ma
+non possono modificarli, con la sola eccezione di @code{PROCINFO}.
+
+Il motivo di questa scelta @`e di impedire a una funzione di estensione di
+alterare il flusso di un programma @command{awk} togliendogli il controllo.
+Mentre una vera funzione di @command{awk} address@hidden fare quel che vuole, a
+discrezione del programmatore, una funzione di estensione dovrebbe fornire un
+servizio, o rendere disponibile un'API C da utilizzare all'interno di
address@hidden, senza interferire con le variabili @code{FS} o @code{ARGC} e
address@hidden
+
+Inoltre, diverrebbe facile avviarsi su un sentiero scivoloso. Quante
address@hidden di @command{gawk} dovrebbero essere disponibili alle estensioni?
+Devono poter usare @code{getline}? Oppure richiamare @code{gsub()} o compilare
+espressioni regolari? Oppure richiamare funzioni interne di @command{awk}?
+(@emph{Questo} potrebbe creare molta confusione.)
+
+Per evitare questi problemi, gli sviluppatori di @command{gawk} hanno scelto di
+iniziare con le address@hidden address@hidden semplici e di base, che sono
comunque
+veramente utili.
+
+Sebbene @command{gawk} consenta cose interessanti come l'MPFR,
+e vettori indicizzati internamente con numeri interi,
+un'altra decisione @`e stata quella di non rendere disponibili all'API queste
address@hidden, per amor di address@hidden e per restare fedeli alla
tradizionale
+semantica di @command{awk}. (In effetti, i vettori indicizzati internamente
+con numeri interi sono talmente trasparenti che non sono neppure documentati!)
+
+In address@hidden, tutte le funzioni nell'API controllano che i puntatori ai
parametri
+passati loro in input non siano @code{NULL}. Se lo sono, viene emesso un
+messaggio di errore. (@`E bene che il codice di estensione verifichi
+che i puntatori ricevuti da @command{gawk} non siano @code{NULL}.
address@hidden non
+dovrebbe succedere, ma gli sviluppatori di @command{gawk} sono solo degli
+esseri umani, e capita anche a loro di commettere degli errori, di tanto in
+tanto.)
+
+Col tempo, l'API si address@hidden certamente; gli sviluppatori di
@command{gawk}
+si aspettano che questo avvenga in base alle address@hidden degli utenti. Per
ora,
+l'API disponbile sembra fornire un insieme di address@hidden minimo, eppure
+potente, per creare estensioni.
+
address@hidden Futuri sviluppi delle estensioni
address@hidden address@hidden di sviluppo futuro
+
+L'API address@hidden ancora essere ampliata, in due modi:
+
address@hidden @value{BULLET}
address@hidden
address@hidden passa un ``identificativo di estensione'' all'estensione in fase
+di caricamente dell'estensione. L'estensione a sua volta restituisce questo
+identificativo a @command{gawk} a ogni chiamata di funzione. Questo meccanismo
+consente a @command{gawk} di identificare l'estensione che lo chiama, se la
+cosa dovesse risultare necessaria.
+
address@hidden
+Analogamente, l'estensione passa uno ``spazio dei nomi'' a @command{gawk}
+in fase di registrazione di ogni funzione estesa. Questo @`e fatto in vista di
+un possibile futuro meccanismo per raggruppare funzioni di estensione, e per
+evitare in questo modo possibili conflitti nei nomi di funzione.
address@hidden itemize
+
+Naturalmente, al momento in cui queste righe sono state scritte, nessuna
+decisione @`e stata presa riguardo ai punti sopra descritti.
+
address@hidden Meccanismo delle vecchie estensioni
address@hidden address@hidden per le vecchie estensioni
+
address@hidden
+Il
address@hidden iftex
address@hidden dinamiche}, descrive le API supportate e i meccanismi
+per scrivere estensioni per @command{gawk}. Quest'API @`e stata introdotta
+nella @value{PVERSION} 4.1. Peraltro, address@hidden da molti anni
@command{gawk}
+metteva a disposizione un meccanismo di estensione che richiedeva una
address@hidden con la struttura interna di @command{gawk} e che non era stato
+progettato altrettanto bene.
+
+Per garantire un periodo di transizione, @command{gawk} @value{PVERSION} 4.1
+continua a supportare il meccanismo di estensione originale.
+Questo address@hidden disponibile per la durata di una sola versione
principale.
+Il supporto address@hidden, e address@hidden rimosso dal codice sorgente, al
rilascio
+della prossima versione principale.
+
+In breve, le estensioni in stile originale dovrebbero essere compilate
+includendo il file di intestazione @file{awk.h} nel codice sorgente
+dell'estensione. Inoltre, va definito l'identificativo @samp{GAWK} durante la
+preparazione (si usi @samp{-DGAWK} con compilatori in stile Unix). Se non lo
+si fa, le definizioni in @file{gawkapi.h} risulteranno in conflitto con quelle
+in @file{awk.h} e l'estensione non address@hidden compilabile.
+
+Come nelle versioni precedenti, un'estensione vecchio stile address@hidden
caricata
+usando la funzione predefinita @code{extension()} (che non viene ulteriormente
+documentata). Questa funzione, a sua volta, trova e carica il file oggetto
+condiviso che contiene l'estensione e chiama la sua routine C @code{dl_load()}.
+
+Poich@'e le estensioni in stile originale e quelle nello stile nuovo usano
+differenti routine di inizializzazione(@code{dl_load()} e @code{dlload()},
+rispettivamente), esse possono tranquillamente essere installate nella stessa
+directory (il cui nome deve essere contenuto nella variabile @env{AWKLIBPATH})
+senza problemi di conflitti.
+
+Il @dfn{team} di sviluppo di @command{gawk} raccomanda caldamente di convertire
+ogni estensione del vecchio tipo ancora in uso, in modo da utilizzare la nuova
+API descritta
address@hidden
+nel
address@hidden iftex
address@hidden
+in
address@hidden ifnottex
address@hidden dinamiche}.
+
address@hidden Sommario delle note
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
+Le estensioni di @command{gawk} possono essere disabilitata sia con
+l'opzione @option{--traditional} che con l'opzione @option{--posix}.
+L'opzione @option{--parsedebug} @`e disponibile se @command{gawk} @`e stato
+compilato con @samp{-DDEBUG}.
+
address@hidden
+Il codice sorgente di @command{gawk} @`e conservato in un deposito Git
+pubblicamente accessibile. Tutti possono scaricarlo e visualizzare il
+codice sorgente.
+
address@hidden
+I contributi a @command{gawk} sono benvenuti. Seguire le istruzioni
+delineate in questo @value{CHAPTER} address@hidden address@hidden agevole
integrare
+i contributi degli utenti nel codice principale.
+Questo vale sia per il contributo di nuove address@hidden che per il
address@hidden a ulteriori sistemi operativi.
+
address@hidden
address@hidden ha alcuni limiti: generalmente quelli imposti
+dall'architettura hardware della macchina.
+
address@hidden
+La progettazione dell'estensione API @`e volta a risolvere alcuni problemi
+riscontrati nel precedente meccanismo di estensione, ad abilitare
address@hidden richieste dal progetto @code{xgawk}, e a fornire una
address@hidden binaria in futuro.
+
address@hidden
+Il precedente meccanismo di estensione @`e ancora supportato
+nella @value{PVERSION} 4.1
+di @command{gawk}, ma address@hidden @emph{rimosso} nella prossima versione
principale.
+
address@hidden itemize
+
+
address@hidden Concetti fondamentali
address@hidden Concetti fondamentali di programmazione
address@hidden programmazione, concetti di
address@hidden programmazione, concetti di
+
+Quest'@value{APPENDIX} si propone di definire alcuni dei concetti
+e termini fondamentali usati nel resto di questo @value{DOCUMENT}.
+Poich@'e questo @value{DOCUMENT} @`e dedicato ad @command{awk},
+e non riguarda la programmazione al computer in generale, la trattazione
address@hidden necessariamente piuttosto generica e semplificata.
+(Se serve qualcosa di address@hidden approfondito, ci sono molti
+altri testi introduttivi che si possono consultare.)
+
address@hidden
+* Fondamenti ad alto livello:: Una visione dall'alto.
+* Fondamenti sui tipi di dati:: Una velocissima introduzione ai tipi di dati.
address@hidden menu
+
address@hidden Fondamenti ad alto livello
address@hidden Quel che fa un programma
+
address@hidden elaborazione dati
+Al livello address@hidden fondamentale, il compito di un programma @`e di
elaborare
+alcuni dati in input e produrre dei risultati.
address@hidden
+Si veda la @ref{figura-generica-flusso}.
address@hidden ifnotdocbook
address@hidden
+Si veda la @inlineraw{docbook, <xref linkend="figura-generica-flusso"/>}.
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-generica-flusso
address@hidden generico di un programma}
address@hidden SMALLPRINT
address@hidden @image{programma-generico, , , Flusso generico di un programma}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{programma-generico, 11cm, , Flusso generico di un
programma}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figure id="figura-generica-flusso" float="0">
+<title>Flusso generico di un programma</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="programma-generico.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
address@hidden programmi compilati
address@hidden programmi interpretati
+Il ``programma'' nella figura address@hidden essere sia un programma
address@hidden programmi compilati sono normalmente scritti
+in linguaggi di programmazione di livello address@hidden basso, come C, C++, o
Ada,
+e quindi tradotti, o @dfn{compilati}, in una forma che
+il computer address@hidden eseguire direttamente.}
+(come @command{ls}),
+sia un programma @dfn{interpretato}. In quest'ultimo caso, un programma
+direttamente eseguibile dal computer, come @command{awk}, legge il
+programma, e quindi usa le istruzioni in esso contenute per elaborare i dati.
+
address@hidden programmazione, passi fondamentali
+Quando si scrive un programma, esso @`e composto normalmente
+dai seguenti insiemi di istruzioni di base,
address@hidden
+come si vede nella @ref{figura-flusso-elaborazione}:
address@hidden ifnotdocbook
address@hidden
+come si vede nella @inlineraw{docbook, <xref
linkend="figura-flusso-elaborazione"/>}:
address@hidden ifdocbook
+
address@hidden
address@hidden Figura,figura-flusso-elaborazione
address@hidden di un programma generico}
address@hidden SMALLPRINT
address@hidden @image{flusso-elaborazione, , , Fasi di un programma generico}
address@hidden ifclear
address@hidden SMALLPRINT
address@hidden @image{flusso-elaborazione, 11cm , , Fasi di un programma
generico}
address@hidden ifset
address@hidden float
address@hidden ifnotdocbook
+
address@hidden
+<figura id="figura-flusso-elaborazione" float="0">
+<title>Fasi di un programma generico</title>
+<mediaobject>
+<imageobject role="web"><imagedata fileref="flusso-elaborazione.png"
format="PNG"/></imageobject>
+</mediaobject>
+</figure>
address@hidden docbook
+
address@hidden @asis
address@hidden Inizializzazione
+Queste sono le cose da fare prima di iniziare la reale elaborazione dei
+dati, per esempio controllare gli argomenti con cui @`e stato invocato il
+programma, inizializzare dei dati di cui si address@hidden aver bisogno per la
+successiva elaborazione, e address@hidden@dotless{i}} via.
+Questa fase corrisponde alla regola @code{BEGIN} di @command{awk}
+(@pxref{BEGIN/END}).
+
+Nella preparazione di una torta, questa fase corrisponde a quella di
+tirar fuori tutti i contenitori in cui mischiare gli ingredienti, e la
+teglia in cui cuocerla, e nell'assicurarsi di avere a disposizione tutti gli
+ingredienti necessari.
+
address@hidden Elaborazione
+Questa fase @`e quella in cui si svolge il lavoro vero e proprio. Il programma
+legge i dati, raggruppati in ``pezzi logici'', e li elabora secondo
address@hidden
+
+In quasi tutti i linguaggi di programmazione, la lettura dei dati va gestita
+manualmente, controllando dopo ogni lettura se @`e
+rimasto ancora qualcosa d'altro da leggere. Il paradigma @dfn{criterio di
+ricerca--azione} di @command{awk}
address@hidden
+(@pxrefil{Per iniziare})
address@hidden iftex
address@hidden
+(@pxref{Per iniziare})
address@hidden ifnottex
+gestisce automaticamente la parte di lettura dati.
+
+Nella preparazione di una torta, l'elaborazione corrisponde all'address@hidden
+vera e propria: rompere le uova, mescolare la farina, l'acqua e gli altri
+ingredienti, e quindi mettere la torta a cuocere nel forno.
+
address@hidden Pulizia
+Una volta elaborati tutti i dati, ci sono address@hidden da svolgere prima di
aver
+finito. Questa fase corrisponde alla regola @code{END} di @command{awk}.
+(@pxref{BEGIN/END}).
+
+Dopo che la torta @`e stata tirata fuori dal forno, va fatta raffreddare e
+avvolta in una pellicola trasparente per evitare che qualcuno la assaggi,
+e inoltre vanno lavati i contenitori e le posate.
address@hidden table
+
address@hidden Algoritmi
+Un @dfn{algoritmo} @`e la descrizione dettagliata della procedura necessaria
per
+svolgere un compito o per elaborare dati. Lo si address@hidden paragonare
alla ricetta
+per preparare una torta. I programmi sono il modo con cui un
+algoritmo viene eseguito da un computer.
+Spesso @`e compito del programmatore sia sviluppare un algoritmo, sia
+programmarlo.
+
address@hidden record
address@hidden campi
+I ``pezzi logici'' nominati precedentemente sono chiamati @dfn{record}
+(registrazioni), in analogia con le registrazioni del personale di una ditta,
+degli studenti di una scuola, o dei pazienti di un dottore.
+Ogni record @`e composto di molte parti, per esempio nome, cognome, data di
+nascita, indirizzo, e address@hidden@dotless{i}} via. Le parti di cui @`e
composto un record sono
+chiamate @dfn{campi} del record.
+
+L'atto di leggere i dati @`e noto come @dfn{input}, e quello di generare
+risultati @`e, come facilmente prevedibile, chiamato @dfn{output}. Spesso i
due
+sono riuniti sotto il nome di ``input/output'' e, ancor address@hidden spesso,
con
+l'abbreviazione ``I/O''. (In inglese ``input'' e ``output'' sono spesso usati
+come verbi, nel gergo informatico, al posto di leggere e scrivere.)
+
address@hidden guidato-dai-dati, linguaggio di programmazione
address@hidden linguaggio di programmazione, guidato dai dati
address@hidden gestisce la lettura dei dati, come anche la divisione in
+record e campi. Lo scopo del programma dell'utente @`e di dire ad
@command{awk}
+cosa fare con i dati. Questo vien fatto descrivendo @dfn{modelli} da
+ricercare nei dati e @dfn{azioni} da eseguire qualora si siano trovati questi
+modelli. Questa caratteristica dei programmi @command{awk}, di essere
address@hidden, di solito li rende address@hidden facili sia da scrivere che da
+leggere.
+
address@hidden Fondamenti sui tipi di dati
address@hidden Valore dei dati in un computer
+
address@hidden variabili
+In un programma si tiene traccia di informazioni e valori in contenitori
+chiamati @dfn{variabili}. Una variabile @`e solo un nome per designare un
certo
+valore, come @code{nome}, @code{cognome}, @code{indirizzo}, e
address@hidden@dotless{i}} via.
address@hidden ha molte variabili predefinite, e ha dei nomi speciali per
+designare il record in input corrente e i campi che compongono il record
+stesso. Si possono inoltre raggruppare molti valori associati tra di loro
+sotto un unico nome, utilizzando un vettore.
+
address@hidden valori numerici
address@hidden valori tipo stringa
address@hidden valori scalari
address@hidden scalari, valori
+I dati, in particolare in @command{awk}, possono avere valori numerici, come 42
+o 3.1415927, o avere come valore delle stringhe. Un valore di tipo stringa @`e
+essenzialmente qualsiasi cosa che non sia un numero, per esempio un nome. Le
+stringhe sono talora chiamate @dfn{dati di tipo carattere}, poich@'e
memorizzano
+i singoli caratteri che le formano. Le singole variabili, come pure le
+variabili numeriche e di tipo stringa, sono definite come valori
address@hidden Raggruppamenti di valori, come i vettori, non sono scalari.
+
address@hidden
+La
address@hidden iftex
address@hidden del computer}, ha fornito un'introduzione di base ai tipi
+numerici (interi e a virgola mobile) e a come questi sono usati in un computer.
+Si consiglia di rileggere quelle informazioni, comprese le numerose avvertente
address@hidden esposte.
+
address@hidden stringhe nulle
+Mentre @`e probabile che ci si sia abituati all'idea di un numero senza un
valore
+(address@hidden, allo zero), richiede un po' address@hidden di riflessione
abituarsi all'idea di
+dati di tipo carattere a lunghezza zero. Nonostante address@hidden, questo
tipo di dato
+esiste. @`E chiamato @dfn{stringa nulla}. La stringa nulla @`e un dato di
tipo
+carattere che non ha un valore. In altre parole, @`e vuoto. Si scrive
address@hidden@dotless{i}} nei
+programmi @command{awk}: @code{""}.
+
+Gli esseri umani sono abituati a usare il sistema decimale, address@hidden a
base 10.
+In base 10, i numeri vanno da 0 a 9, e poi ``vengono riportati'' nella
+colonna successiva. (Chi si ricorda la scuola elementare? 42 = 4 x 10 + 2.)
+
+Ma esistono anche altre basi per i numeri. I computer normalmente usano
+la base 2 o @dfn{binaria}, la base 8 o @dfn{ottale}, e la base 16 o
address@hidden Nella numerazione binaria, ogni colonna rappresenta il
+doppio del valore della colonna alla sua destra. Ogni colonna address@hidden
contenere
+solo uno 0 o un 1. Quindi, il numero binario 1010 rappresenta (1 x 8) + (0 x
+4) + (1 x 2) + (0 x 1), ossia il numero decimale 10. Le numerazioni ottale ed
+esadecimale sono trattate address@hidden ampiamente
address@hidden
+in
address@hidden ifnottex
address@hidden
+nella
address@hidden iftex
address@hidden non-decimali}.
+
+Al livello address@hidden basso possibile, i computer memorizzano i valori
come gruppi di
+cifre binarie, o @dfn{bit}. I computer moderni raggruppano i bit in gruppi di
+otto, detti @dfn{byte}. Applicazioni avanzate talora hanno address@hidden di
+manipolare i bit direttamente, e @command{gawk} @`e dotato di apposite
funzioni.
+
+I programmi sono scritti nei linguaggi di programmazione. Esistono centinaia,
+se non migliaia, di linguaggi di programmazione. Uno dei address@hidden
diffusi @`e il
+linguaggio di programmazione C. Il linguaggio C ha esercitato un'influsso
+molto forte nella progettazione del linguaggio @command{awk}.
+
address@hidden Kernighan, Brian
address@hidden Ritchie, Dennis
+Ci sono state parecchie versioni di C. La prima @`e spesso designata come
+``K&R'' C, dalle iniziali di Brian Kernighan e Dennis Ritchie,
+gli autori del primo libro sul C. (Dennis Ritchie ha creato il linguaggio,
+e Brian Kernighan @`e stato uno dei creatori di @command{awk}.)
+
+A address@hidden degli anni '80 @`e iniziato uno sforzo rivolto a produrre uno
+standard internazionale per il C. Questo lavoro ha raggiunto un punto di
+arrivo nel 1989 con la produzione dello standard ANSI per il C.
+Questo standard @`e diventato uno standard ISO nel 1990.
+Nel 1999, uno standard ISO C revisionato @`e stato approvato e pubblicato.
+Dove @`e opportuno, POSIX @command{awk} @`e compatible con lo standard
+ISO C del 1999.
+
+
address@hidden Glossario
address@hidden Glossario
+
address@hidden @asis
address@hidden Abbraccio mortale
+La situazione in cui due processi che comunicano tra loro sono entrambi
bloccati, in
+attesa che l'altro processo faccia qualcosa.
+
address@hidden Ada, linguaggio di programmazione
address@hidden linguaggio di programmazione, Ada
address@hidden Ada
+Un linguaggio di programmazione originalmente definito dal Department of
+Defense U.S.A.@: per la programmazione integrata. @`E stato progettato per
+favorire dei buoni metodi da seguire nell'ingegneria del software.
+
address@hidden Ambiente
+Si veda ``Variabili d'ambiente''.
+
address@hidden @`Ancora
+I metacaratteri @dfn{regexp} @samp{^} e @samp{$}, che richiedono che la
+corrispondenza che si sta cercando si trovi all'inizio o alla fine di una
+stringa, rispettivamente.
+
address@hidden angolo buio
address@hidden Angolo buio
+Un'area del linguaggio le cui specifiche spesso non erano (o ancora non
+sono) chiare, col risultato di ottenere un comportamente inatteso o non
+desiderabile.
+Tali aree sono segnalate in questo @value{DOCUMENT} con
address@hidden
+il disegno di una torcia a margine
address@hidden iftex
address@hidden
+``(a.b.)'' nel testo
address@hidden ifnottex
+e sono riportate nell'indice analitico sotto la voce ``angolo buio''.
+
address@hidden ANSI
address@hidden ANSI
+L'American National Standards Institute. Questo ente produce
+parecchi standard, e tra questi gli standard per i linguaggi di
+programmazione C e C++.
+Questi standard spesso diventano anche internazionali. Si veda anche
+``ISO''.
+
address@hidden Argomento
+Un argomento address@hidden essere due cose differenti. address@hidden essere
un'opzione o un
address@hidden passato a un comando mentre lo si invoca dalla riga dei comandi,
+oppure address@hidden essere qualcosa passato a una @dfn{funzione} all'interno
di un
+programma, per esempio all'interno di @command{awk}.
+
+In quest'ultimo caso, un argomento address@hidden essere passato a una
funzione in
+due modi. Nel primo modo @`e passato come valore alla funzione chiamata,
+ossia una copia del valore della variabile @`e reso disponibile alla funzione
+chiamata, ma la variabile originale non address@hidden essere modificata dalla
+funzione stessa. Nel secondo modo l'argomento @`e passato per riferimento,
+ossia un puntatore alla variabile in questione @`e passato alla funzione, che
address@hidden quindi modificarla direttamente. In @command{awk} le variabili
scalari
+sono passate per valore, e i vettori sono passati per riferimento.
+Si veda ``Passaggio per valore/riferimento''.
+
address@hidden Arrotondamento
+Arrotondare il risultato di un'operazione aritmetica address@hidden essere
difficile.
+C'@`e address@hidden di un modo di arrotondare, e in @command{gawk} @`e
possibile scegliere
+quale metodo dovrebbe essere usato all'interno di un programma.
address@hidden modi di arrotondare}.
+
address@hidden Assegnamento
+Un'espressione @command{awk} che cambia il valore di qualche variabile o
+dato oggetto di @command{awk}. Un oggetto a cui si address@hidden assegnare
un valore
address@hidden detto un @dfn{lvalue}. I valori
+assegnati sono chiamati @dfn{rvalue}.
address@hidden di assegnamento}.
+
address@hidden Spencer, Henry
address@hidden @command{sed}, programma di address@hidden
address@hidden programma di address@hidden @command{sed}
address@hidden incredibile assembler (@command{aaa}) scritto in @command{awk}
address@hidden Assembler incredibilmente scritto in @command{awk}
+Henry Spencer dell'address@hidden di Toronto ha scritto un assembler adatto a
+molti diversi hardware, usando solo @dfn{script} @command{sed} e
address@hidden @`E lungo migliaia di righe, e include
+la descrizione dell'hardware di
+numerosi micro-computer a 8 bit. @`E un
+buon esempio di programma per cui sarebbe stato
+meglio utilizzare un altro linguaggio.
+Si address@hidden scaricare da @uref{http://awk.info/?awk100/aaa}.
+
address@hidden Asserzione
+Un'istruzione in un programma che afferma che una condizione @`e verificata in
+un dato punto di un programma.
+Utile per ragionare su come si suppone funzioni un programma.
+
address@hidden Azione
+Una serie di istruzioni @command{awk} associate a una regola. Se
+l'espressione di ricerca della regola individua un record in input,
address@hidden esegue su quel record l'azione relativa. Le azioni sono
+sempre racchiuse tra parentesi graffe.
+(@xref{Panoramica sulle azioni}).
+
address@hidden Bash
+La versione GNU della shell standard
address@hidden
+(il @address@hidden @b{SH}ell).
address@hidden ifnotinfo
address@hidden
+(il Bourne-Again SHell).
address@hidden ifinfo
+Si veda anche ``Bourne Shell''.
+
address@hidden Binario
+Notazione a base due, che usa le cifre @address@hidden Poich@'e
+i circuiti elettronici funzionano ``naturalmente'' in base 2
+(basta pensare a Off/On), ogni cosa all'interno di un computer @`e
+calcolata usando la base 2. Ciascuna cifra rappresenta la presenza
+(o l'assenza) di una potenza di 2 ed @`e chiamata un @dfn{bit}.
address@hidden@dotless{i}}, per esempio, il numero in base due @code{10101}
rappresenta il
+numero in base decimale 21, ((1 x 16) + (1 x 4) + (1 x 1)).
+
+Poich@'e i numeri in base due diventano rapidamente molto lunghi
+sia da leggere che da scrivere, normalmente li si unisce a gruppi di tre
+(ossia, sono visti come numeri ottali) o a gruppi di quattro (ossia, sono
+visti come numeri esadecimali). Non c'@`e un modo diretto per inserire
+numeri a base due in un programma C. Se necessario, tali numeri vengono
+solitamente inseriti come numeri ottali o esadecimali.
+Il numero di cifre in base due contenuto nei registri usati per
+rappresentare i numeri interi all'interno dei computer @`e un'indicazione
+approssimativa della potenza di calcolo del computer stesso. La maggior
+parte dei computer oggi usa 64 bit per rappresentare i numeri interi nei
+registri di calcolo, ma registri a 32 bit, 16 bit e 8 bit sono stati
+largamente in uso in passato.
address@hidden non-decimali}.
+
address@hidden McIlroy, Doug
address@hidden biscotto della fortuna
address@hidden Biscotto della fortuna
+Una particolare perla di saggezza, segno, detto o ricordo
+prodotto da (o presentato a) un programma. (Con vivi ringraziamenti al Prof.
+Doug McIlroy).
address@hidden
+From: Doug McIlroy <address@hidden>
+Date: Sat, 13 Oct 2012 19:55:25 -0400
+To: address@hidden
+Subject: Re: origin of the term "cookie"?
+
+I believe the term "cookie", for a more or less inscrutable
+saying or crumb of information, was injected into Unix
+jargon by Bob Morris, who used the word quite frequently.
+It had no fixed meaning as it now does in browsers.
+
+The word had been around long before it was recognized in
+the 8th edition glossary (earlier editions had no glossary):
+
+cookie a peculiar goodie, token, saying or remembrance
+returned by or presented to a program. [I would say that
+"returned by" would better read "produced by", and assume
+responsibility for the inexactitude.]
+
+Doug McIlroy
+
+From: Doug McIlroy <address@hidden>
+Date: Sun, 14 Oct 2012 10:08:43 -0400
+To: address@hidden
+Subject: Re: origin of the term "cookie"?
+
+> Can I forward your email to Eric Raymond, for possible addition to the
+> Jargon File?
+
+Sure. I might add that I don't know how "cookie" entered Morris's
+vocabulary. Certainly "values of beta give rise to dom!" (see google)
+was an early, if not the earliest Unix cookie. The fact that it was
+found lying around on a model 37 teletype (which had Greek beta in
+its type box) suggests that maybe it was seen to be like milk and
+cookies laid out for Santa Claus. Morris was wont to make such
+connections.
+
+Doug
address@hidden ignore
+
address@hidden Bit
+Abbreviazione di ``Binary Digit'' [cifra binaria].
+Tutti i valori nella memoria di un computer sono rappresentati nella forma di
+cifre binarie: valori che sono zero o uno.
+Gruppi di bit possono essere interpretati differentemente---come numeri
+interi, numeri a virgola mobile, dati di tipo carattere, indirizzi di altri
+oggetti contenuti in memoria, o altri dati ancora.
address@hidden permette di lavorare con numeri a virgola mobile e stringhe.
address@hidden permette di manipolare bit con le funzioni predefinite
+descritte
address@hidden
+in
address@hidden ifnottex
address@hidden
+nella
address@hidden iftex
address@hidden a livello di bit}.
+
+I computer sono spesso definiti dal numero di bit che usano per rappresentare
+valori interi. Molti sistemi sono a 32-bit, ma i sistemi a 64-bit sono sempre
address@hidden numerosi, mentre i sistemi a 16-bit [e quelli a 8-bit] sono
praticamente
+scomparsi.
+
address@hidden Bourne Shell
+La shell standard (@file{/bin/sh}) in Unix e nei sistemi derivati da Unix,
+Originariamente scritto da Steven R.@: Bourne dei Bell Laboratories.
+Molte shell (Bash, @command{ksh}, @command{pdksh}, @command{zsh}) sono
+generalmente compatibili con la Bourne shell, anche quando offrono ulteriori
address@hidden
+
address@hidden C
+Il linguaggio di programmazione di sistema con cui @`e scritta la maggior parte
+del software GNU. Il linguaggio di programmazione @command{awk} ha una
+sintassi simile a quella del C, e
+questo @value{DOCUMENT} puntualizza, quando serve, le somiglianze esistenti
+fra @command{awk} e C.
+
+In generale, @command{gawk} tenta di essere ragionevolmente simile alla
+versione 1990 del C ISO.
+
address@hidden C Shell
+La C Shell (@command{csh} o la sua versione migliorata @command{tcsh}) @`e una
+shell Unix creata da Bill Joy verso la fine degli anni '70. La C shell si
+differenzia dalla altre shell per le sue address@hidden interattive, e per lo
+stile complessivo, che @`e abbastanza simile a quello del linguaggio C.
+La C shell non @`e compatibile all'indietro con la Bourne Shell, e per questo
+motivo un'attenzione speciale @`e necessaria se si convertono alla C shell
+degli script scritti per altre shell Unix, in particolare per address@hidden
che
+concerne la gestione delle variaili di shell.
+Si veda anche ``Bourne Shell''.
+
address@hidden C++
+Un linguaggio di programmazione molto diffuso, orientato agli oggetti,
+derivato dal C.
+
address@hidden Campo
+Quando @command{awk} legge un record in input, suddivide il record in parti
+separate da spazi vuoti (o da una @dfn{regexp} che individua il separatore,
+modificabile reimpostando la variabile predefinita @code{FS}). Tali parti
+sono dette campi. Se le parti sono di lunghezza fissa, si address@hidden
usare la
+variabile predefinita @code{FIELDWIDTHS} per descriverne le lunghezze.
+Se si desidera specificare i contenuti dei campi, piuttosto che il separatore
+fra i campi, si address@hidden usare la variabile predefinita @code{FPAT} per
farlo.
+(@xref{Separatori di campo},
address@hidden
+la
address@hidden iftex
address@hidden costante},
+e
address@hidden
+la
address@hidden iftex
address@hidden in base al contenuto}).
+
address@hidden ASCII
address@hidden ISO 8859-1
address@hidden ISO Latin-1
address@hidden caratteri (codifiche macchina di caratteri)
address@hidden insiemi di caratteri (codifiche macchina di caratteri)
address@hidden Unicode
address@hidden Caratteri
+L'insieme di codici numerici usati da un computer per rappresentare i
+caratteri (lettere, numeri, segni d'interpunzione, etc.) di un particolare
+paese o address@hidden L'insieme di caratteri address@hidden comunemente in
uso oggi @`e
+l'ASCII (American Standard Code for Information Interchange). Molti paesi
+europei usano un'estensione dell'ASCII
+nota come ISO-8859-1 (ISO Latin-1).
+L'insieme di caratteri @uref{http://www.unicode.org, Unicode} sta guadagnando
address@hidden e affermandosi come standard, e il suo uso @`e particolarmente
esteso
+nei sistemi GNU/Linux.
+
address@hidden Kernighan, Brian
address@hidden Bentley, Jon
address@hidden @command{chem}, programma di address@hidden
address@hidden programma di address@hidden @command{chem}
address@hidden CHEM
+Un preprocessore per @command{pic} che legge descrizioni di molecole
+e produce l'input a @command{pic} che serve a disegnarle.
address@hidden stato scritto in @command{awk}
+da Brian Kernighan e Jon Bentley, ed @`e disponibile in
address@hidden://netlib.org/typesetting/chem}.
+
address@hidden Classe di caratteri
+Si veda ``Espressione tra parentesi quadre''.
+
address@hidden programmi compilati
address@hidden Compilatore
+Un programma che traduce codici sorgente scritti in qualche linguaggio
+in codici eseguibili su un particolare computer. Il codice oggetto risultante
address@hidden quindi essere eseguito direttamente dal computer.
+Si veda anche ``Interprete''.
+
address@hidden Concatenazione
+Concatenare due stringhe significa unirle, producendo una nuova stringa.
+Per esempio, la stringa @samp{pippo} concatenata con
+la stringa @samp{pluto} produce la stringa @samp{pippopluto}.
+(@xref{Concatenazione}).
+
address@hidden Contatore di riferimenti
+Un meccanismo interno di @command{gawk} per minimizzare la address@hidden di
+memoria necessaria per contenere il valore delle variabili di tipo
+stringa. Se il valore assunto da una variabile @`e usato in address@hidden di
un
+posto nel programma, solo una copia del valore stesso @`e tenuta in
+memoria, e il contatore di riferimenti ad esso associato @`e aumentato di
+uno quando lo stesso valore @`e usato da un'ulteriore variabile, e diminuito
+di uno quando la variabile relativa non @`e address@hidden utilizzata. Quando
il
+contatore di riferimenti va a zero, la parte di memoria utilizzata per
+contenere il valore della variuabile @`e liberato.
+
address@hidden Coprocesso
+Un programma subordinato con il quale @`e possibile una comunicazione
+bidirezionale dal programma principale.
+
address@hidden Dati oggetto
+Sono costituiti da numeri e stringhe di caratteri. I numeri sono convertiti
+in stringhe e viceversa, a seconda delle address@hidden
+(@xref{Conversione}).
+
address@hidden Debugger
+Un programma che serve agli sviluppatori per rimuovere ``bug'' (de-bug) dai
+loro programmi.
+
address@hidden Dominio di testo
+Un nome unico che identifica un'applicazione.
+Usato per raggruppare messaggi che sono tradotti in fase di esecuzione
+nel linguaggio locale.
+
address@hidden Doppia precisione
+Una rappresentazione di numeri all'interno del computer che ha una parte
+espressa sotto forma di frazione. I numeri a doppia precisione hanno
address@hidden
+cifre decimali che quelli a singola precisione, ma le operazioni che la
+usano consumano address@hidden risorse di quelle
+eseguite in singola precisione. La doppia precisione @`e il formato con cui
address@hidden memorizza i valori numerici. Nel linguaggio C @`e il tipo di
+dati detto @code{double}.
+
address@hidden Editore di flusso
+Un programma che legge record da un flusso in input e li elabora uno o
address@hidden alla volta. Questo @`e diverso da quel che farebbe un programma
batch
+il quale potrebbe leggere completamente i file in input, prima di
+iniziare a fare alcunch@'e, ed @`e diverso anche da un programma interattivo,
che
+richiede input dall'utente [tipicamente, una riga alla volta].
+
address@hidden Effetto collaterale
+Un effetto collaterale ha luogo quando un'espressione ha un effetto ulteriore,
+invece di produrre solo un valore. Espressioni di assegnamento,
+incremento e decremento, e invocazioni di funzioni hanno effetti collaterali.
+(@xref{Operatori di assegnamento}).
+
address@hidden epoch, definizione di
address@hidden Epoca [Inizio del tempo in Unix]
+la data usata come ``inizio del tempo'' per i campi che contengono date.
+I valori del tempo nella maggior parte dei dei sistemi sono rappresentati
+in numero di secondi trascorsi dall'Epoca, con funzioni di libreria
+che consentono di convertire tali valori nei formati normali di data e ora.
+
+L'Epoca nei sistemi Unix e POSIX parte dal primo gennaio 1970 alle ore
+00:00:00 UTC.
+Si veda anche ``GMT'' e ``UTC''.
+
address@hidden Esadecimale
+Notazione per l'aritmetica in base 16, che usa le cifre @address@hidden e
+le lettere @address@hidden, con @samp{A}
+che rappresenta 10, @samp{B} che rappresenta 11, e address@hidden@dotless{i}}
via, fino a
address@hidden per 15.
+I numeri esadecimali sono scritti in C prefissandoli con @samp{0x},
+per indicarne la base. Quindi, @code{0x12} @`e 18 ((1 x 16) + 2).
address@hidden non-decimali}.
+
address@hidden Espressione booleana
address@hidden@dotless{i}} detta dal nome del matematico inglese George Boole.
+Si veda anche ``Espressione logica''.
+
address@hidden Espressione condizionale
+Un'espressione che usa l'operatore ternario @samp{?:}, come p.es.
address@hidden@var{expr1} ? @var{expr2} : @var{expr3}}. Dell'espressione
address@hidden viene calcolato il valore; se risulta verificata, il valore
+dell'intera espressione diviene quello di @var{expr2}; altrimenti il valore @`e
+quello di @var{expr3}. In ogni caso, solo una delle due espressioni
address@hidden e @var{expr3}
+viene calcolata. (@xref{Espressioni condizionali}).
+
address@hidden Espressione di confronto
+Una relazione che @`e vera o falsa, del tipo di @samp{a < b}.
+Espressioni di confronto sono usate nelle istruzioni
address@hidden, @code{while}, @code{do}, @code{for}
+e nelle espressioni di ricerca per scegliere quale record in input elaborare.
+(@xref{Tipi di variabile e confronti}).
+
address@hidden Espressione di intervallo
+Una parte di un'espressione regolare che permette di specificare
+corrispondenze multiple di qualche parte della @dfn{regexp}. Le espressioni di
+intervallo non erano originariamente ammesse nei programmi @command{awk}.
+
address@hidden Espressione di ricerca address@hidden
address@hidden (detta anche "criterio di ricerca" o "modello di ricerca")
+Le espressioni di ricerca individuano per @command{awk} a quali record in
+input sono applicabili determinate
+regole.
+
+Un'espressione di ricerca [pattern] @`e un'espressione condizionale specifica
+che viene confrontata con ogni record
+in input. Se la corrispondenza esiste, si dice che il modello @dfn{individua}
+il record in input. Una tipica espressione di ricerca potrebbe confrontare
+il record in input con un'espressione regolare.
+(@xref{Panoramica sui criteri di ricerca}).
+
address@hidden Espressione logica
+Un'espressione che usa gli operatori logici AND, OR e NOT,
+scritti come @samp{&&}, @samp{||}, e @samp{!} in @command{awk}.
+Spesso chiamate espressioni booleane, dal nome del matematico che per primo
+ha sistematizzato questo tipo di logica matematica.
+
address@hidden Espressione regolare
+un'espressione regolare (abbreviabile come address@hidden'') @`e un modello che
+descrive un assieme di stringhe, potenzialmente illimitato. Per esempio
+l'espressione regolare
address@hidden corrisponde a qualsiasi stringa che inizia con la lettera
address@hidden e termina con le lettere @samp{xp}. In @command{awk}, le
espressioni
+regolari sono usate nei modelli [pattern] e nelle espressioni condizionali.
+Le espressioni regolari possono contenere sequenze di protezione.
address@hidden
+(@xrefil{Espressioni regolari}).
address@hidden iftex
address@hidden
+(@xref{Espressioni regolari}).
address@hidden ifnottex
+
address@hidden Espressione regolare calcolata
+Si veda ``Espressioni regolari dinamiche''.
+
address@hidden Espressione regolare costante
+Un'espressione regolare costante @`e un'espressione regolare scritta tra barre,
+come @code{/pippo/}. A una tale espressione viene assegnato un valore quando
+si scrive un programma @command{awk} e non address@hidden essere modificata in
fase di
+esecuzione del programma. (@xref{Uso di @dfn{regexp}}.)
+
address@hidden Espressione regolare dinamica
+Un'espressione regolare dinamica @`e un'espressione regolare scritta come
+un'espressione normale. Potrebbe essere una costante stringa, come
address@hidden"pippo"}, ma potrebbe anche essere un'espressione il cui valore
@`e variabile
+(@xref{Espressioni regolari calcolate}).
+
address@hidden Espressione tra parentesi quadre
+All'interno di una @dfn{espressione regolare}, un'espressione racchiusa
+fra parentesi quadre sta a indicare che un singolo carattere appartiene
+a una specifica classe di caratteri. Un'espressione tra parentesi quadre
address@hidden contenere una lista di uno o address@hidden caratteri, come
@samp{[abc]}, un
+intervallo di caratteri, come @samp{[A-Z]}, o un nome, delimitato da
address@hidden:}, che designa un insieme di caratteri conosciuto, come
address@hidden:digit:]}. La forma di espressione tra parentesi quadre
+racchiusa tra @samp{:} @`e indipendente dalla rappresentazione binaria dei
+caratteri stessi, che potrebbe utilizzare le codifiche ASCII, EBCDIC, o
+Unicode, a seconda dell'architettura del computer, e della localizzazione.
+Si veda anche ``Espressioni regolari''.
+
address@hidden Espressione tra parentesi quadre complementata
+La negazione di una @dfn{espressione tra parentesi quadre}. Tutto
address@hidden che
address@hidden @`e descritto da una data espressione tra parentesi quadre.
+Il simbolo @samp{^} precede l'espressione tra parentesi quadre che viene
+negata. Per esempio: @samp{[[^:digit:]}
+designa qualsiasi carattere che non sia una cifra. @samp{[^bad]}
+designa qualsiasi carattere che non sia una delle lettere @samp{b}, @samp{a},
+o @samp{d}.
+Si veda ``Espressione tra parentesi quadre''.
+
address@hidden Estensione
+Una address@hidden aggiunta o una modifica a un linguaggio di programmazione
+o a un programma di address@hidden, non definita dallo standard di quel
linguaggio
+o di quel programma di address@hidden
address@hidden ha molte estensioni rispetto al POSIX @command{awk} (fin
+troppe).
+
address@hidden FDL
+Free Documentation License. Si veda ``Licenza Documentazione Libera''.
+
address@hidden File speciale
+Un @value{FN} interpretato internamente da @command{gawk}, invece che
+gestito direttamente dal sistema operativo in cui viene eseguito
address@hidden esempio, @file{/dev/stderr}.
+(@xref{File speciali}).
+
address@hidden Flag [Indicatore]
+Una variabile [di tipo booleano] che, se verificata, indica la presenza o
+l'assenza di qualche condizione.
+
address@hidden Formato
+Le stringhe di formato controllano il modo in cui le funzioni
address@hidden()}, @code{sprintf()} e l'istruzione @code{printf} visualizzano
+l'output che producono. Inoltre, le conversioni da numeri a stringhe sono
+controllate dalle stringhe di formato contenute nelle variabili predefinite
address@hidden e @code{OFMT}. (@xref{Lettere di controllo}).
+
address@hidden formattatore incredibilmente duttile (@command{awf})
address@hidden programma @command{awf} (formattatore incredibilmente duttile)
address@hidden Formattatore incredibilmente duttile (@command{awf})
+Henry Spencer all'address@hidden di Toronto ha scritto un formattatore che
+accetta un ampio sottoassieme dei comandi di formattazione @samp{nroff -ms}
+e @samp{nroff -man} usando
address@hidden e @command{sh}.
+Si address@hidden scaricare da @uref{http://awk.info/?tools/awf}.
+
address@hidden Fortran
+Abbreviazione di FORmula TRANslator (traduttore di formule), @`e uno dei primi
+linguaggi di programmazione, pensato per il calcolo scientifico.
address@hidden stato ideato da John Backus ed @`e disponibile a partire dal
1957. @`E ancora
+in uso ai giorni nostri.
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden Stallman, Richard
address@hidden Free Software Foundation
+Un'organizzazione senza fini di lucro dedicata alla
+produzione e distribuzione di software liberamente distribuibile.
address@hidden stata fondata da Richard M.@: Stallman, l'autore dell'originale
editor
+Emacs. GNU Emacs @`e la versione di Emacs maggiormente usata oggigiorno.
+
address@hidden FSF
+Si veda ``Free Software Foundation''.
+
address@hidden Funzione
+Una parte di un programma @command{awk} che si address@hidden chiamare da
qualsiasi
+punto del programma, per eseguire un compito. @command{awk} ha parecchie
+funzioni predefinite.
+Gli utenti possono definire essi stessi delle funzioni in qualsiasi parte
+del programma. Le funzioni possono essere ricorsive, ossia possono
+chiamare se stesse.
address@hidden
address@hidden
address@hidden iftex
address@hidden
address@hidden
address@hidden ifnottex
+In @command{gawk} @`e anche possibile avere funzioni condivise tra diversi
+programmi, incluse secondo address@hidden usando la direttiva
address@hidden@@include}
+(@pxref{Includere file}).
+In @command{gawk} il nome della funzione da chiamare address@hidden essere
generato
+in fase di esecuzione, ossia in maniera dinamica.
+L'estensione API di @command{gawk} fornisce funzioni di costruzione
+(@pxref{Funzioni di costruzione}).
+
address@hidden Funzioni predefinite
+Il linguaggio @command{awk} fornisce funzioni predefinite, che compiono
+calcoli vari, di tipo numerico, di input/output e di tipo carattere. Esempi
+sono @code{sqrt()} ([square root], la radice quadrata di un numero) e
address@hidden()} (che estrae una sottostringa da una stringa).
address@hidden fornisce funzioni per la gestione di data e ora,
+le operazioni a livello di bit, l'ordinamento di
+vettori, il controllo di tipo [di variabile] e la traduzione di stringhe
+in fase di esecuzione di progranna.
+(@xref{Funzioni predefinite}).
+
address@hidden @command{gawk}
+L'implementazione GNU di @command{awk}.
+
address@hidden GPL (General Public License)
address@hidden General Public License (GPL)
address@hidden GNU General Public License
address@hidden General Public License
+Un documento che descrive le condizioni alle quali @command{gawk} e i suoi
+file sorgenti possono essere distribuiti. (@xref{Copia}).
+
address@hidden GMT
+``Greenwich Mean Time''.
+Il termine tradizionalmente usato per UTC.
address@hidden la datazione usata internamente dai sistemi Unix e POSIX.
+Si veda anche ``Epoca'' e ``UTC''.
+
address@hidden FSF (Free Software Foundation)
address@hidden Free Software Foundation (FSF)
address@hidden Progetto GNU
address@hidden GNU
+``GNU's not Unix'' (GNU non @`e Unix).
+Un progetto della Free Software Foundation, ancora in corso, che mira a creare
+un ambiente di calcolo completo, liberamente distribuibile, aderente allo
+standard POSIX.
+
address@hidden GNU/Linux
+Una variante del sistema GNU che usa il kernel Linux,
+invece del kernel proprio della Free Software Foundation, noto come Hurd.
+Il kernel Linux @`e un clone di Unix stabile, efficiente, completo di tutte le
address@hidden, ed @`e stato portato su varie architetture hardware.
address@hidden molto diffuso su sistemi del tipo dei Personal Computer, ma
funziona bene
+anche in parecchi altri computer.
+Il codice sorgente del kernel Linux @`e disponibile nei termini della GNU
General
+Public License, la qual cosa @`e forse il suo aspetto address@hidden rilevante.
+
address@hidden GPL
+Si veda ``General Public License''.
+
address@hidden Graffe
+I caratteri @address@hidden e @address@hidden Le parentesi graffe sono usate
in
address@hidden per delimitare azioni, istruzioni composte, e il codice che
+costituisce le funzioni.
+
address@hidden Guidato dai dati
+Una descrizione dei programmi @command{awk}, nei quali si specifica quali sono
+i dati che si vogliono elaborare, e cosa fare quando si trovano tali dati.
+
address@hidden I/O
+Abbreviazione per ``Input/Output,'' ovvero il trasferimento di dati da e verso
+un programma in esecuzione.
+
address@hidden Individuazione
+L'azione che consiste nel confrontare una stringa con un'espressione regolare.
+Se la @dfn{regexp} descrive qualcosa che @`e contenuto nella stringa, si dice
che
+la @dfn{individua}.
+
address@hidden Internazionalizzazione
+La procedura con cui si scrive o si modifica un programma
+in modo che possa inviare messaggi in lingue differenti, senza richiedere
+ulteriori modifiche al codice sorgente.
+
address@hidden Intero
+Un numero intero, address@hidden un numero che non ha una parte frazionaria.
+
address@hidden programmi interpretati
address@hidden Interprete
+Un programma che accetta come input del codice sorgente, e usa le
+istruzione contenute nello stesso per elaborare dati e fornire risultati.
address@hidden @`e tipicamente (ma non sempre) implementato come un interprete.
+Si veda anche ``Compilatore''.
+
address@hidden Intervallo (nelle righe di input)
+Una sequenza di righe consecutive nel/nei file in input. Un'espressione di
+ricerca address@hidden specificare intervalli di righe di input da far
elaborare ad
address@hidden oppure address@hidden specificare singole righe.
+(@xref{Panoramica sui criteri di ricerca}).
+
address@hidden ISO
address@hidden ISO
+Acronimo di International Organization for Standardization.
+Questo ente elabora degli standard internazionali in vari settori, inclusi i
+linguaggi di programmazione, come il C e il C++.
+In ambito informatico, standard importanti come quelli per il C, C++, e POSIX
+sono allo stesso tempo standard nazionali americani e standard internazionali
+ISO.
+In questo @value{DOCUMENT} lo Standard C @`e chiamato ``ISO C''.
+Si veda @uref{http://www.iso.org/iso/home/about.htm, il sito web ISO} per
+ulteriori informazioni sul nome dell'ente e sul suo acronimo di tre lettere,
+che rimane lo stesso in tutte le lingue.
+
address@hidden Istruzione
+Un'espressione all'interno di un programma @command{awk} nella parte
+"azione" di una regola @dfn{criterio di ricerca--azione}, o all'interno
+di una funzione @command{awk}. Un'espressione address@hidden essere un
assegnamento
+di variabile, un'operazione su un vettore, un ciclo, etc.
+
address@hidden Istruzione composta
+Una serie di istruzioni @command{awk}, racchiuse tra parentesi graffe.
+Le istruzioni composte possono essere nidificate [possono esserci
address@hidden livelli
+di parentesi graffe].
+(@xref{Istruzioni}).
+
address@hidden Istruzione di controllo
+Un'istruzione di controllo @`e un'istruzione per eseguire una data operazione
+o un insieme di operazioni all'interno di un programma @command{awk},
+se una determinata condizione @`e verificata.
+Istruzioni di controllo sono: @code{if}, @code{for}, @code{while}, e @code{do}
+(@pxref{Istruzioni}).
+
address@hidden Java, linguaggio di programmazione
address@hidden linguaggio di programmazione, Java
address@hidden Java
+Un moderno linguaggio di programmazione originalmente sviluppato da Sun
+Microsystems (ora Oracle) che prevede la programmazione orientata agli
+oggetti. Sebbene normalmente sia implementato compilando le istruzioni
+per una macchina virtuale standard (la JVM---Java Virtual Machine) il
+linguaggio address@hidden essere compilato per essere eseguito in maniera
nativa.
+
address@hidden Korn Shell
+La Korn Shell (@command{ksh}) @`e una shell Unix sviluppata da David Korn,
+presso i Bell Laboratories, nei primi anni '80. La Korn shell @`e
+compatibile all'indietro con la Bourne shell e comprende molte address@hidden
+presenti nella C Shell.
+Si veda anche ``Bourne Shell''.
+
address@hidden LDL
+Si veda ``Licenza Documentazione Libera''.
+
address@hidden LGPL (Lesser General Public License)
address@hidden Lesser General Public License (LGPL)
address@hidden GNU Lesser General Public License
address@hidden Lesser General Public License
+Questo documento descrive i termini nei quali possono essere distribuiti
+degli archivi contenenti librerie in formato eseguibile o oggetti condivisi,
+e il relativo codice sorgente.
+
address@hidden LGPL
+Si veda ``Lesser General Public License''.
+
address@hidden Licenza Documentazione Libera
+Questo documento descrive i termini in base ai quali questo @value{DOCUMENT}
address@hidden pubblicato e address@hidden essere copiato.
+(@xref{Licenza per Documentazione Libera GNU (FDL)}).
+
address@hidden Linguaggio @command{awk}
+Il linguaggio in cui i programmi @command{awk} sono scritti.
+
address@hidden Linux
+Si veda ``GNU/Linux''.
+
address@hidden Lista di caratteri
+Si veda ``Espressione tra parentesi quadre''.
+
address@hidden Localizzazioni
+La address@hidden che fornisce i dati necessari perch@'e un programma
+internazionalizzato interagisca con l'utente in un particolare linguaggio.
+
address@hidden @dfn{Lvalue}
+[left-value, ossia valore a sinistra] Un'espressione che address@hidden stare
alla
+sinistra di un operatore di assegnamento.
+Nella maggior parte dei linguaggi, gli @dfn{lvalue} possono essere variabili o
+elementi di un vettore. In @command{awk}, un designatore di campo
address@hidden anche
+essere usato come un @dfn{lvalue}.
+
address@hidden Marcatura temporale
+Un valore nel formato ``secondi a partire dall'epoch'' usato dai sistemi Unix
+e POSIX. Usato per le funzioni @command{gawk}
address@hidden()}, @code{strftime()}, e @code{systime()}.
+Si veda anche ``Epoca,'' ``GMT,'' e ``UTC''.
+
address@hidden Metacaratteri
+Caratteri usati all'interno di una @dfn{regexp} e che non rappresentano se
+stessi.
+Servono invece per rappresentare operazioni con espressioni regolari, come
+per esempio delle ripetizioni, dei raggruppamenti, o delle alternanze.
+
address@hidden Nidificazione
+Una nidificazione si riscontra dove l'informazione @`e organizzata a strati,
+o dove degli oggetti contengono altri oggetti simili.
+In @command{gawk} la direttiva @code{@@include}
address@hidden essere nidificata. La nidificazione ``naturale'' delle operazioni
+aritmetiche e logiche address@hidden essere modificato attraverso l'uso di
parentesi.
+(@pxref{Precedenza}).
+
address@hidden No-op
+Un'operazione che non fa nulla.
+
address@hidden Numero
+Un dato oggetto il cui valore @`e numerico. Le implementazioni di @command{awk}
+usano numeri a virgola mobile in doppia precisione per rappresentare i numeri.
+Le primissime implementazioni di @command{awk} usavano numeri a virgola mobile
+in singola precisione.
+
address@hidden Numero a virgola mobile
+Spesso descritto, in termini matematici, come un numero ``razionale'' o reale,
address@hidden soltanto un numero che address@hidden avere una parte
frazionaria.
+Si veda anche ``Doppia precisione'' e ``Singola precisione''.
+
address@hidden Operatori di espressioni regolari
+Si veda ``Metacaratteri''.
+
address@hidden Ottale
+Notazione avente come base 8, nella quale le cifre sono @address@hidden
+I numeri ottali in C sono scritti premettendo uno @samp{0},
+per indicare la base. Quindi, @code{013} @`e 11 ((1 x 8) + 3).
address@hidden non-decimali}.
+
address@hidden Parentesi Graffe
+Si veda ``Graffe''.
+
address@hidden Parola chiave
+nel linguaggio @command{awk}, una parola chiave (keyword) @`e una parola
+che ha un significato speciale. Queste parole sono riservate e non possono
+essere usate come nomi di variabili.
+
+Le parole chiave di @command{gawk} sono:
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
address@hidden,
address@hidden@dots{}while},
address@hidden,
address@hidden,
address@hidden@dots{}in},
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+e
address@hidden
+
address@hidden PEBKAC
+Un acronimo inglese che descrive qual @`e probabilmente la causa
address@hidden frequente
+di problemi nell'uso di un computer. (@dfn{Problem Exists Between Keyboard and
+Chair} [il problema si trova tra la tastiera e la sedia].)
+
address@hidden Percorso di ricerca
+In @command{gawk}, una lista di directory in cui cercare file contenenti del
+codice sorgente per @command{awk}.
+Nella shell, una lista di directory in cui ricercare un programma eseguibile.
+
address@hidden Plug-in
+Si veda ``Estensione''.
+
address@hidden POSIX
+Il nome di una serie di standard che specificano l'interfaccia di un Sistema
+Operativo Portabile (Portable Operating System). La ``IX'' specifica
+che questi standard sono stati originati dallo Unix.
+Lo standard address@hidden rilevante per gli utenti @command{awk} @`e lo
address@hidden Standard for Information Technology, Standard 1003.1-2008}.
+Lo standard POSIX 2008 address@hidden essere trovato in rete all'indirizzo:
address@hidden://www.opengroup.org/onlinepubs/9699919799/}.
+
address@hidden Precedenza
+L'ordine in cui le operazioni sono eseguite quando si usano degli operatori
+se non si stabiliscono precedenze per mezzo di parentesi.
+
address@hidden Private
+Variabili e/o funzioni che sono riservate all'uso esclusivo di funzioni di
+libreria, e non per il programma principale @command{awk}. Un'attenzione
+particolare va prestata quando si desigano tali variabili e funzioni.
+(@xref{Nomi di variabili di libreria}).
+
address@hidden Programma @command{awk}
+Un programma @command{awk} consiste in una serie di @dfn{espressioni di
+ricerca} e @dfn{azioni}, che formano delle @dfn{regole}. Per ogni record in
+input a un progranna, le regole del programma sono elaborate nell'ordine in
+cui sono scritte. I programmi
address@hidden possono anche contenere definizioni di funzioni.
+
address@hidden Record
+Si veda ``Record in input'' e ``Record in output''.
+
address@hidden Record in input
+Una singola parte di dati letta da @command{awk}. Solitamente, un
+record in input di @command{awk} consiste in una linea di testo.
+(@xref{Record}).
+
address@hidden Record in output
+Un singolo pezzo di dati scritto da @command{awk}. Solitamente, un
+record in output di @command{awk} consiste di una o address@hidden righe di
testo.
address@hidden
+
address@hidden Ricorsione
+Quando una funzione chiama se stessa, direttamente o indirettamente.
+Se questo @`e chiaro, si address@hidden passare a leggere la definizione
successiva.
+Altrimenti, si veda la voce ``Ricorsione''.
+
address@hidden @dfn{regexp}
+Si veda ``Espressione regolare''.
+
address@hidden Regola
+Un segmento di un programma @command{awk} che specifica come trattare singoli
+record in input. Una regola consiste in una @dfn{espressione di ricerca} e in
+una @dfn{azione}.
address@hidden legge un record in input; poi, per ogni regola, se il record in
+input soddisfa l'espressione di ricerca della regola, @command{awk} esegue
+l'azione specificata dalla regola.
+Altrimenti, la regola non ha alcun effetto su quel record in input.
+
address@hidden Ridirezione
+Ridirezione significa ricevere input da quaclosa che non sia il flusso dello
+standard input, o dirigere output a qualcosa di diverso dal flusso dello
+standard output.
+
+Si address@hidden ridirigere input all'istruzione @code{getline} usando gli
operatori
address@hidden<}, @samp{|}, e @samp{|&}.
+Si address@hidden ridirigere l'output delle istruzioni @code{print} e
@code{printf} verso
+un file o un comando di sistema, usando gli operatori @samp{>}, @samp{>>},
address@hidden|}, e @samp{|&}.
+(@xref{Getline},
+e @ref{Ridirezione}).
+
address@hidden @dfn{Rvalue}
+[right-value, ossia valore a destra] Un valore che address@hidden apparire
alla destra
+di un operatore di assegnazione.
+In @command{awk}, essenzialmente ogni espressione ha un valore.
+Ognuno di questi valori @`e un @dfn{rvalue}.
+
address@hidden Scalare
+Un valore singolo, sia numerico che di tipo stringa.
+Le variabili normali sono scalari; i vettori e le funzioni non lo sono.
+
address@hidden Scorciatoia
+La natura degli operatori logici @command{awk} @samp{&&} e @samp{||}.
+Se il valore dell'intera espressione in cui sono contenuti @`e determinabile
+valutando solo una parte iniziale dell'espressione, la parte seguente non @`e
+presa in considerazione.
+(@xref{Operatori booleani}).
+
address@hidden @dfn{Script} @command{awk}
+Un altro nome per designare un programma @command{awk}.
+
address@hidden @command{sed}
+Si veda ``Editore di flusso''.
+
address@hidden Seme
+Il valore iniziale, o il punto di partenza, di una sequenza di numeri casuali.
+
address@hidden Sequenze di protezione
+Una speciale sequenza di caratteri usata per descrivere caratteri non
+stampabili, come @samp{\n} (ritorno a capo) o @samp{\033} per il carattere
+ASCII ESC (Escape). (@xref{Sequenze di protezione}).
+
address@hidden Shell
+Il programma che interpreta i comandi nei sistemi Unix e in quelli che
+rispettano lo standard POSIX.
+La shell funziona sia interattivamente che come un linguaggio di
+programmazione, che elabora file sequenziali, detti @dfn{script} di shell.
+
address@hidden Singola precisione
+Una rappresentazione di numeri all'interno del computer che ha una parte
+espressa sotto forma di frazione. I numeri a singola precisione hanno meno
+cifre significative di quelli a doppia precisione, ma le operazioni relative
+richiedono talora meno risorse elaborative da parte del computer.
+Questo tipo di numero @`e quello usato da alcune tra le prime versioni di
address@hidden per memorizzare valori numerici. Nel linguaggio C, sono numeri
+di tipo @code{float}.
+
address@hidden Spazio
+Il carattere generato premendo la barra spaziatrice sulla tastiera.
+
address@hidden Spazio vuoto
+Una sequenza di spazi, TAB, o caratteri di ritorno a capo presenti in un
+record in input o in una stringa.
+
address@hidden Stringa
+Un dato che consiste in una sequenza di caratteri, come @samp{Io sono una
+stringa}. Le costanti stringa sono scritte tra doppi apici nel linguaggio
address@hidden e possono contenere sequenze di protezione
+(@xref{Sequenze di protezione}).
+
address@hidden Stringa nulla
+Una stringa che non contiene alcun carattere. @`E rappresentabile
+esplicitamente nei programmi @command{awk} mettendo due caratteri di
+doppio apice uno dietro all'altro (@code{""}). La si address@hidden inserire
nei dati
+in input mettendo due separatori di campo uno dietro all'altro.
+
address@hidden Stringa vuota
+Si veda ``Stringa nulla''.
+
address@hidden Tab
+Il carattere generato premendo il tasto @kbd{TAB} sulla tastiera.
+Normalmente address@hidden generare sino a otto spazi in output.
+
address@hidden Linux
address@hidden GNU/Linux
address@hidden Unix
address@hidden sistemi operativi basati su BSD
address@hidden NetBSD
address@hidden FreeBSD
address@hidden OpenBSD
address@hidden Unix
+Un sistema operativo per computer originalmente sviluppato nei primi anni '70
+presso gli AT&T Bell Laboratories. Inizialmente si diffuse nelle
address@hidden
+di tutto il mondo e in seguito si estese agli ambienti del mondo del lavoro
+come un sistema per lo sviluppo del software e come server di rete.
+Ci sono parecchie versioni di Unix a pagamento, come pure parecchi sistemi
+operativi modellati su Unix e il cui codice sorgente @`e liberamente
+disponibile. (come GNU/Linux, @uref{http://www.netbsd.org, NetBSD},
address@hidden://www.freebsd.org, FreeBSD}, e
address@hidden://www.openbsd.org, OpenBSD}).
+
address@hidden UTC
+L'abbreviazione comune per ``Universal Coordinated Time'' (tempo coordinato
+universale). Questa @`e l'ora standard di Greenwich, (UK), usata come tempo
+di riferimento per i calcoli relativi a marcature temporali.
+Si veda anche ``Epoca'' e ``GMT''.
+
address@hidden Variabile
+Un nome per designare un valore. In @command{awk}, le variabili possono
+essere degli scalari o dei vettori.
+
address@hidden Variabili d'ambiente
+Una collezione di stringhe, in formato @address@hidden@var{valore}}, che
+ogni programma ha a disposizione. Gli utenti in generale assegnano valori
+alle variabili d'ambiente per fornire informazioni a vari programmi.
+Esempi tipici sono le variabili d'ambiente @env{HOME} e @env{PATH}.
+
address@hidden Variabili predefinite
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+e
address@hidden
+sono le variabili con un significato speciale in @command{awk}.
+In address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+e
address@hidden
+sono le variabili con un significato speciale in @command{gawk}.
+Se i loro valori sono modificati, il contesto di esecuzione di @command{awk}
+cambia.
+(@xref{Variabili predefinite}).
+
address@hidden Vettore
+Un raggruppamento di molti valori con uno stesso nome.
+La maggior parte dei linguaggi fornisce solo vettori sequenziali.
address@hidden fornisce vettori associativi.
+
address@hidden Vettore associativo
+Un vettore i cui indici possono essere numeri o stringhe, e non solamente
+interi sequenziali compresi in un intervallo prestabilito.
+
address@hidden table
+
address@hidden ifclear
+
address@hidden The GNU General Public License.
+
address@hidden Copia
address@hidden Licenza Pubblica Generale GNU (GPL)
address@hidden
address@hidden Versione 3, 29 Giugno 2007
address@hidden ifnotdocbook
address@hidden
+<subtitle>Versione 3, 29 Giugno 2007</subtitle>
address@hidden docbook
+
address@hidden This file is intended to be included within another document,
address@hidden hence no sectioning command or @node.
+
address@hidden
+Copyright @copyright{} 2007 Free Software Foundation, Inc.
@url{http://fsf.org/}
+
+This is an unofficial translation of the GNU General Public License into
+Italian. It was not published by the Free Software Foundation, and does not
+legally state the distribution terms for software that uses the GNU GPLâonly
+the original English text of the GNU GPL does that. However, we hope that this
+translation will help Italian speakers understand the GNU GPL better.
+
+Questa @`e una traduzione non ufficiale in italiano della GNU General Public
+License. Questa traduzione non @`e stata pubblicata dalla Free Software
+Foundation, e non stabilisce i termini legali di distribuzione del software
+che usa la GNU GPL. Soltanto la versione originale in inglese della GNU GPL
+fa address@hidden Ciononostante, speriamo che questa traduzione possa aiutare
gli utenti
+di lingua italiana a comprendere un po' meglio la GNU GPL.
+
+A chiunque @`e permesso copiare e ridistribuire copie esatte di questo
documento
+di licenza, ma non @`e in alcun modo consentito apportarvi modifiche.
address@hidden display
+
address@hidden fakenode --- for prepinfo
address@hidden Preambolo
+
+La GNU General Public License @`e una licenza libera e basata su copyleft per
+software e altri tipi di opere.
+
+Le licenze della maggior parte del software e di altre opere materiali sono
+pensate per togliere la address@hidden di condividere e modificare tali opere.
Al
+contrario, la GNU General Public License ha l'obiettivo di garantire la
address@hidden di condividere e modificare tutte le versioni di un programma e
di
+fare in modo che esso rimanga software libero per tutti gli utenti. Noi, Free
+Software Foundation, usiamo la GNU General Public License per la maggior parte
+del nostro software; essa viene applicata anche a qualunque altro software
+rilasciato dall'autore sotto questa licenza. Chiunque address@hidden
utilizzare questa
+licenza per i suoi programmi.
+
+Quando parliamo di software libero (free software), ci riferiamo al concetto
+di address@hidden, non al prezzo. Le nostre General Public License sono
progettate
+per garantire che chiunque abbia la address@hidden di distribuire copie di
software
+libero (anche dietro pagamento di un prezzo, se lo desidera), che chiunque
+riceva o possa ricevere il codice sorgente se lo vuole, che chiunque possa
+apportare modifiche al software o utilizzarne delle porzioni in altri software
+liberi, e che chiunque sappia che ha il diritto di fare tutte queste cose col
+software libero.
+
+Per proteggere i vostri diritti, abbiamo la address@hidden di impedire che
altri vi
+neghino questi diritti o vi obblighino a rinunciarvi. Pertanto, chiunque
+distribuisce o modifica software rilasciato con questa licenza assume dei
+precisi doveri: il dovere di rispettare la address@hidden degli altri.
+
+Per esempio, chi distribuisce copie di un programma rilasciato sotto questa
+licenza, sia gratis che dietro pagamento di un prezzo, e' obbligato a
+riconoscere a chi riceve il software esattamente gli stessi diritti che ha
+ricevuto. Deve garantire che chi riceva il software abbia o possa avere
+accesso al codice sorgente. E deve chiaramente far conoscere ai destinatari
+del software queste condizioni, address@hidden@dotless{i}} che essi conoscano
quali sono i loro
+diritti.
+
+Gli sviluppatori che usano la GNU GPL proteggono i vostri diritti in due modi:
+(1) Rivendicando il copyright sul software, e (2) offrendovi questa licenza
+che vi garantisce il diritto legale di copiarlo e/o di modificarlo.
+
+Al fine di proteggere gli sviluppatori e gli autori, la GPL spiega chiaramente
+che non c'@`e nessuna garanzia per questo software libero. Nell'interesse degli
+utenti e degli autori, la GPL impone che le versioni modificate del software
+vengano esplicitamente marcate come ``modificate'', in maniera tale che
+eventuali problemi non vengano erroneamente attribuiti agli autori delle
+versioni precedenti.
+
+Alcuni dispositivi sono progettati per negare agli utenti l'installazione o
+l'esecuzione di versioni modificate del software che gira sugli stessi, anche
+se il costruttore si riserva la address@hidden di farlo. address@hidden @`e
fondamentalmente
+incompatibile con l'obiettivo di garantire la address@hidden degli utenti di
+modificare il software. Una ripetizione sistematica di tali abusi avviene nel
+campo dei dispositivi per usi individuali, e address@hidden rende questi abusi
ancora address@hidden
+inaccettabili. Pertanto, abbiamo realizzato questa versione della GPL al fine
+di proibire queste pratiche. Se problemi simili dovessero sorgere in altri
+ambiti, saremo pronti ad estendere queste misure a questi nuovi ambiti in
+versioni future della GPL, nella maniera che si address@hidden necessaria per
+difendere la address@hidden degli utenti.
+
+In conclusione, tutti i programmi sono costantemente minacciati dai brevetti
+sul software. Gli Stati non dovrebbero permettere ai brevetti sul software di
+limitare lo sviluppo e l'utilizzo di software per computer, ma nei Paesi in
+cui address@hidden avviene noi vogliamo evitare in particolare il pericolo che
i brevetti
+sul software applicati ad un programma libero possano renderlo, a tutti gli
+effetti, proprietario. Per impedire address@hidden, la GPL assicura che non
@`e possibile
+utilizzare i brevetti sul software per rendere un programma non libero.
+
+I termini e le condizioni esatte per la copia, la distribuzione e la modifica
+del software sono riportate di seguito.
+
address@hidden fakenode --- for prepinfo
address@hidden TERMINI E CONDIZIONI
+
address@hidden 0
address@hidden Definizioni
+
+``Questa Licenza'' si riferisce alla versione 3 della GNU General Public
+License.
+
+``Copyright'' indica anche leggi simili al copyright che riguardano altri tipi
+di opere, come le maschere per la produzione di semiconduttori.
+
+``Il Programma'' indica qualunque opera che sia soggetta a copyright e che sia
+rilasciata sotto questa Licenza. I detentori della licenza sono indicati come
+``tu'' o ``voi''. Licenziatari e destinatari possono essere individui o
+organizzazioni.
+
+``Modificare'' un'opera significa copiare o adattare tutta o parte dell'opera
in
+una maniera che richieda un permesso di copyright, e non indica la semplice
+azione di fare una esatta copia dell'opera. L'opera risultante viene chiamata
+``versione modificata'' dell'opera precedente, oppure viene detta opera
``basata
+sulla'' opera precedente.
+
+Una ``opera coperta da questa licenza'' indica il Programma originale non
+modificato oppure un'opera basata sul Programma.
+
+``Propagare'' un'opera significa fare qualunque cosa con essa che, in mancanza
+di un esplicito permesso, ti renda direttamente o indirettamente perseguibile
+per violazione secondo le vigenti normative sul copyright, ad eccezione della
+semplice esecuzione del Programma su un computer o della modifica di una copia
+privata. La Propagazione include la copia, la distribuzione (con o senza
+modifiche), la messa a disposizione al pubblico e, in alcuni stati, altre
address@hidden simili e connesse.
+
+``Distribuire'' un'opera indica qualunque forma di propagazione che permetta a
+terze parti di effettuare o ricevere delle copie. La mera interazione con un
+utente attraverso una rete di computer, senza che ci sia alcun trasferimento
+di una copia, non @`e considerata ``Distribuzione''.
+
+Una interfaccia utente interattiva fornisce delle ``Adeguate Informazioni
+Legali'' soltanto nel caso in cui include una apposita address@hidden, resa
+adeguatamente visibile, che (1) visualizzi un'adeguata informazione di
+copyright, e (2) informi l'utente che non c'@`e alcuna garanzia sull'opera
+(eccetto nel caso in cui delle garanzie sono espressamente fornite), dica che
+il licenziatario address@hidden distribuire l'opera utilizzando questa
Licenza, indichi
+come @`e possibile prendere visione di una copia di questa Licenza. Se
+l'interfaccia presenta una lista di comandi o di opzioni, come per esempio un
address@hidden, una delle opzioni fornite nella lista deve rispettare questa
condizione.
+
address@hidden Codice Sorgente
+
+Il ``codice sorgente'' di un'opera indica la forma address@hidden indicata
dell'opera per
+effettuare modifiche su di essa. Il ``codice oggetto'' indica qualunque forma
+dell'opera che non sia codice sorgente.
+
+Una ``Interfaccia Standard'' @`e una interfaccia che risponde ad uno standard
+ufficiale definito da un ente di standardizzazione riconosciuto o, nel caso di
+interfacce specifiche per un particolare linguaggio di programmazione, una
+interfaccia che @`e largamente utilizzata dagli sviluppatori per sviluppare in
+tale linguaggio.
+
+Le ``Librerie di Sistema'' di un eseguibile includono qualsiasi cosa, eccetto
+l'opera nel suo insieme, che (a) sia inclusa nella normale forma di
+pacchettizzazione di un ``Componente Principale'', ma che non @`e parte di quel
+Componente Principale, e (b) che serva solo a consentire l'uso dell'opera con
+quel Componente Principale, o per implementare una Interfaccia Standard per la
+quale esista una implementazione disponibile al pubblico in forma sorgente. Un
+``Componente Principale'', in questo contesto, @`e un componente essenziale
+(kernel, gestore di finestre eccetera) dello specifico sistema operativo
+(ammesso che ce ne sia uno) sul quale l'eseguibile esegue, o un compilatore
+utilizzato per produrre il programma, o un interprete di codice oggetto
+utilizzato per eseguire il programma.
+
+Il ``Sorgente Corrispondente'' per un'opera in forma di codice oggetto @`e il
+codice sorgente necessario per generare, installare e (per un programma
+eseguibile) eseguire il codice oggetto e per modificare l'opera, inclusi gli
+script per controllare le suddette address@hidden di generazione,
installazione ed
+esecuzione. Non sono incluse le Librerie di Sistema usate dal programma, o gli
+strumenti di address@hidden generica o i programmi liberamente accessibili che
sono
+utilizzati, senza modifiche, per portare a termine le suddette address@hidden
ma che
+non fanno parte dell'opera. Per esempio, il sorgente corrispondente include i
+file con le definizioni delle interfacce associati ai file sorgente
+dell'opera, e il codice sorgente delle librerie condivise e sottoprogrammi
+collegati dinamicamente specificatamente necessari per il programma, ad
+esempio a causa di stretta comunicazione dati o di controllo di flusso tra
+questi sottoprogrammi e altre parti del programma.
+
+Il Sorgente Corrispondente non include qualunque cosa che l'utente possa
+rigenerare automaticamente da altre parti del Sorgente Corrispondente stesso.
+
+Il Sorgente Corrispondente di un'opera in forma di codice sorgente @`e l'opera
+stessa.
+
address@hidden Principali Diritti
+
+Tutti i diritti garantiti da questa Licenza sono garantiti per la durata del
+copyright sul Programma, e sono irrevocabili ammesso che le suddette
+condizioni siano rispettate. Questa Licenza afferma esplicitamente il tuo
+permesso illimitato di eseguire il Programma non modificato. Il risultato
+dell'esecuzione di un programma coperto da questa Licenza @`e a sua volta
+coperto da questa Licenza solo se il risultato stesso, a causa del suo
+contenuto, @`e un'opera coperta da questa Licenza. Questa Licenza riconosce il
+tuo diritto all'uso legittimo o altri diritti equivalenti, come stabilito
+dalla legislazione sul copyright.
+
+Puoi creare, eseguire e propagare programmi coperti da questa Licenza che tu
+non distribuisci, senza alcuna condizione fino a quando la tua Licenza rimane
+valida. Puoi distribuire opere coperte da questa Licenza ad altri al solo
+scopo di ottenere che essi facciano delle modifiche al programma
+esclusivamente per te, o che ti forniscano dei servizi per l'esecuzione di
+queste opere, ammesso che tu rispetti i termini di questa Licenza nel
+distribuire tutto il materiale per il quale non detieni il copyright. Coloro i
+quali creano o eseguono per conto tuo un programma coperto da questa Licenza
+lo fanno esclusivamente in tua vece, sotto la tua direzione e il tuo
+controllo, in maniera tale che sia proibito a costoro effettuare copie di
+materiale di cui detieni il copyright al di fuori della relazione che
+intrattengono nei tuoi confronti.
+
+Distribuire opere coperte da licenza in qualunque altra circostanza @`e
+consentito soltanto alle condizioni espresse in seguito. Non @`e consentito
+sottolicenziare le opere: la sezione 10 lo rende non necessario.
+
address@hidden Protezione dei diritti legali degli utenti dalle leggi
anti-elusione
+
+Nessun programma protetto da questa Licenza address@hidden essere considerato
parte di
+una misura tecnologica di restrizione che sottosta ad alcuna delle leggi che
+soddisfano l'articolo 11 del ``WIPO copyright treaty'' adottato il 20 Dicembre
+1996, o a simili leggi che proibiscono o limitano l'elusione di tali misure
+tecnologiche di restrizione.
+
+Quando distribuisci un programma coperto da questa Licenza, rifiuti tutti i
+poteri legali atti a proibire l'elusione di misure tecnologiche di restrizione
+ammesso che tale elusione sia effettuata nell'esercizio dei diritti garantiti
+da questa Licenza riguardo al programma coperto da questa Licenza, e rinunci
+all'intenzione di limitare l'address@hidden o la modifica del programma per far
+valere, contro i diritti degli utenti del programma, diritti legali tuoi o di
+terze parti che impediscano l'elusione di misure tecnologiche di restrizione.
+
address@hidden Distribuzione di Copie Esatte
+
+Ti @`e permesso distribuire copie esatte del codice sorgente del Programma come
+lo hai ricevuto, con qualunque mezzo, ammesso che tu aggiunga in maniera
+appropriata su ciascuna copia una appropriata nota di copyright; che tu lasci
+intatti tutti gli avvisi che affermano che questa Licenza e tutte le clausole
+non-permissive aggiunte in accordo con la sezione 7 sono valide per il codice
+che distribuisci; che tu lasci intatti tutti gli avvisi circa l'assenza di
+garanzia; che tu fornisca a tutti i destinatari una copia di questa Licenza
+assieme al Programma.
+
+Puoi richiedere il pagamento di un prezzo o di nessun prezzo per ciascuna
+copia che distribuisci, e puoi offrire supporto o garanzia a pagamento.
+
address@hidden Distribuzione di Versioni modificate del sorgente
+
+Puoi distribuire un'opera basata sul Programma, o le modifiche per produrla a
+partire dal Programma, nella forma di codice sorgente secondo i termini della
+sezione 4, ammesso che tu rispetti anche tutte le seguenti condizioni:
+
address@hidden a
address@hidden
+L'opera deve recare con address@hidden delle informazioni adeguate che
affermino che tu
+l'hai modificata, indicando la data di modifica.
+
address@hidden
+L'opera deve recare informazioni adeguate che affermino che essa @`e rilasciata
+sotto questa Licenza e sotto le condizioni aggiuntive secondo quanto indicato
+dalla Sezione 7. Questa condizione modifica la condizione espressa alla
+sezione 4 di ``lasciare intatti tutti gli avvisi''.
+
address@hidden
+Devi rilasciare l'intera opera, nel suo complesso, sotto questa Licenza a
+chiunque venga in possesso di una copia di essa. Questa Licenza address@hidden
pertanto
+applicata, assieme ad eventuali clausole aggiunte in osservanza della Sezione
+7, all'opera nel suo complesso, a tutte le sue parti, indipendentemente da
+come esse siano pacchettizzate. Questa Licenza nega il permesso di licenziare
+l'opera in qualunque altro modo, ma non rende nullo un tale permesso ammesso
+che tu lo abbia ricevuto separatamente.
+
address@hidden
+Se l'opera ha delle interfacce utente interattive, ciascuna deve mostrare
+delle Adeguate Informazioni Legali; altrimenti, se il Programma ha delle
+interfacce interattive che non visualizzano delle Adeguate Informazioni
+Legali, il tuo programma non @`e obbligato a visualizzarle.
address@hidden enumerate
+
+La giustapposizione di un'opera coperta da questa Licenza assieme ad altre
+opere separate e indipendenti, che non sono per loro natura estensioni del
+Programma, e che non sono combinate con esso a formare un altro programma
address@hidden
+grande, dentro o in uno stesso supporto di memorizzazione a lungo termine o di
+distribuzione, @`e semplicemente detto ``aggregato'' se la raccolta e il suo
+copyright non sono utilizzati per limitare l'accesso o i diritti legali degli
+utenti della raccolta stessa oltre address@hidden che ciascun singolo
programma consente.
+L'inclusione di un programma coperto da questa Licenza in un aggregato non
+comporta l'applicazione di questa Licenza alle altre parti dell'aggregato.
+
address@hidden Distribuzione in formato non-sorgente
+
+Puoi distribuire un programma coperto da questa Licenza in formato di codice
+oggetto secondo i termini delle sezioni 4 e 5, ammesso che tu fornisca anche
+il Sorgente Corrispondente in formato comprensibile da un computer sotto i
+termini di questa stessa Licenza, in uno dei seguenti modi:
+
address@hidden a
address@hidden
+Distribuendo il codice oggetto in, o contenuto in, un prodotto fisico (inclusi
+i mezzi fisici di distribuzione), accompagnato dal Sorgente Corrispondente su
+un supporto fisico duraturo comunemente utilizzato per lo scambio di software.
+
address@hidden
+Distribuendo il codice oggetto in, o contenuto in, un prodotto fisico (inclusi
+i mezzi fisici di distribuzione), accompagnato da un'offerta scritta, valida
+per almeno tre anni e valida per tutto il tempo durante il quale tu offri
+ricambi o supporto per quel modello di prodotto, di fornire a chiunque
+possieda il codice oggetto (1) una copia del Sorgente Corrispondente di tutto
+il software contenuto nel prodotto che @`e coperto da questa Licenza, su un
+supporto fisico duraturo comunemente utilizzato per lo scambio di software, ad
+un prezzo non superiore al costo ragionevole per effettuare fisicamente tale
+distribuzione del sorgente, oppure (2) accesso alla copia del Sorgente
+Corrispondente attraverso un server di rete senza alcun costo aggiuntivo.
+
address@hidden
+Distribuendo copie singole del codice oggetto assieme ad una copia
+dell'offerta scritta di fornire il Sorgente Corrispondente. Questa
address@hidden
address@hidden permessa soltanto occasionalmente e per fini non commerciali, e
solo se tu
+hai ricevuto il codice oggetto assieme ad una tale offerta, in accordo alla
+sezione 6b.
+
address@hidden
+Distribuendo il codice oggetto mediante accesso da un luogo designato (gratis
+o dietro pagamento di un prezzo), e offrendo un accesso equivalente al
+Sorgente Corrispondente alla stessa maniera a partire dallo stesso luogo senza
+costi aggiuntivi. Non devi obbligare i destinatari a copiare il Sorgente
+Corrispondente assieme al codice oggetto. Se il luogo dal quale copiare il
+codice oggetto @`e un server di rete, il Sorgente Corrispondente
address@hidden trovarsi su
+un server differente (gestito da te o da terze parti) che fornisca
address@hidden equivalenti per la copia, a patto che tu fornisca delle
+indicazioni chiare accanto al codice oggetto che indichino dove trovare il
+Sorgente Corrispondente. Indipendentemente da quale server ospiti il Sorgente
+Corrispondente, tu rimani obbligato ad assicurare che esso rimanga disponibile
+per tutto il tempo necessario a soddisfare queste condizioni.
+
address@hidden
+Distribuendo il codice oggetto mediante trasmissione peer-to-peer, a patto che
+tu informi gli altri peer circa il luogo in cui il codice oggetto e il
+Sorgente Corrispondente sono gratuitamente offerti al pubblico secondo i
+termini della sezione 6d.
+
address@hidden enumerate
+
+Una porzione separabile del codice oggetto, il cui sorgente @`e escluso dal
+Sorgente Corrispondente e trattato come Libreria di Sistema, non deve essere
+obbligatoriamente inclusa nella distribuzione del codice oggetto del
+programma.
+
+Un ``Prodotto Utente'' @`e un (1) ``prodotto consumer'', address@hidden
qualunque address@hidden
+personale tangibile che @`e normalmente utilizzata per scopi personali,
+familiari o domestici, oppure (2) qualunque cosa progettata o venduta per
+essere utilizzata in ambiente domestico. Nella classificazione di un prodotto
+come ``prodotto consumer'', i casi dubbi andranno risolti in favore dell'ambito
+di applicazione. Per un dato prodotto ricevuto da un dato utente, ``normalmente
+utilizzato'' si riferisce ad un uso tipico o comune di quella classe di
+prodotti, indipendentemente dallo stato dell'utente specifico o dal modo in
+cui l'utente specifico utilizza, o si aspetta o ci si aspetta che utilizzi, il
+prodotto. Un prodotto @`e un ``prodotto consumer'' indipendentemente dal fatto
che
+abbia usi commerciali, industriali o diversi da quelli ``consumer'', a meno che
+questi usi non rappresentino il solo modo utile di utilizzare il prodotto in
+questione.
+
+Le ``Informazioni di Installazione'' per un Prodotto Utente sono i metodi, le
+procedure, le chiavi di autorizzazioni o altre informazioni necessarie per
+installare ed eseguire versioni modificate di un programma coperto da questa
+Licenza all'interno di un Prodotto Utente, a partire da versioni modificate
+dei suoi Sorgenti Corrispondenti. Tali informazioni devono essere sufficienti
+ad assicurare che il funzionamento del codice oggetto modificato non sia in
+nessun caso proibito o ostacolato per il solo fatto che sono state apportate
+delle modifiche.
+
+Se distribuisci un codice oggetto secondo le condizioni di questa sezione in,
+o assieme, o specificatamente per l'uso in o con un Prodotto Utente, e la
+distribuzione avviene come parte di una transazione nella quale il diritto di
+possesso e di uso del Prodotto Utente viene trasferito al destinatario per
+sempre o per un periodo prefissato (indipendentemente da come la transazione
+sia caratterizzata), il Sorgente Corrispondente distribuito secondo le
+condizioni di questa sezione deve essere accompagnato dalle Informazioni di
+Installazione. Questa condizione non @`e richiesta se address@hidden tu
address@hidden una terza parte
+ha la address@hidden di installare versioni modificate del codice oggetto sul
+Prodotto Utente (per esempio, se il programma @`e installato su una ROM)
+
+La condizione che richiede di fornire delle Informazioni di Installazione non
+implica che venga fornito supporto, garanzia o aggiornamenti per un programma
+che @`e stato modificato o installato dal destinatario, o per il Prodotto
Utente
+in cui esso @`e stato modificato o installato. L'accesso ad una rete
address@hidden essere
+negato se le modifiche apportate impattano materialmente sull'address@hidden
+della rete o se violano le regole e i protocolli di comunicazione attraverso
+la rete.
+
+Il Sorgente Corrispondente distribuito, e le Informazioni di Installazione
+fornite, in accordo con questa sezione, devono essere in un formato che sia
+pubblicamente documentato (e con una implementazione pubblicamente disponibile
+in formato di codice sorgente), e non devono richiedere speciali password o
+chiavi per essere spacchettate, lette o copiate.
+
address@hidden Condizioni Aggiuntive
+
+Le ``Condizioni Aggiuntive'' sono condizioni che completano le condizioni di
+questa Licenza permettendo delle eccezioni a una o address@hidden delle
condizioni sopra
+elencate. Le condizioni aggiuntive che sono applicabili all'intero Programma
+devono essere considerate come se fossero incluse in questa Licenza, a patto
+che esse siano valide secondo le normative vigenti. Se alcune condizioni
+aggiuntive fanno riferimento soltanto ad alcune parti del Programma, quelle
+parti possono essere utilizzate separatamente sotto le stesse condizioni, ma
+l'intero Programma rimane sottoposto a questa Licenza senza riferimento ad
+alcuna condizione aggiuntiva.
+
+Quando distribuisci una copia di un programma coperto da questa Licenza, puoi,
+a tua discrezione, eliminare qualunque condizione aggiuntiva dalla copia, o da
+parte di essa. (Le Condizioni Aggiuntive possono essere scritte in maniera
+tale da richiedere la loro rimozione in certi casi di modifica del Programma).
+Puoi aggiungere Condizioni Aggiuntive su materiale, aggiunto da te ad un'opera
+coperta da questa Licenza, per il quale hai o puoi garantire un'adeguata
+licenza di copyright.
+
+Indipendentemente da qualunque altra condizione di questa Licenza, e per il
+materiale che aggiungi ad un'opera coperta da questa Licenza, puoi (se
+autorizzato dai legittimi detentori del copyright per il suddetto materiale)
+aggiungere alle condizioni di questa Licenza delle condizioni che:
+
address@hidden a
address@hidden
+Negano la garanzia o limitano la address@hidden del Programma in maniera
+differente da quanto riportato nelle sezioni 15 e 16 di questa Licenza; oppure
+
address@hidden
+Richiedono il mantenimento di specifiche e circostanziate informative legali o
+di note di attribuzione ad autori nel materiale o assieme alle Adeguate
+Informazioni Legali mostrate dal Programma che lo contiene; oppure
+
address@hidden
+Proibiscono di fornire informazioni errate o ingannevoli sull'origine e la
+provenienza del materiale in oggetto, o richiedono che versioni modificate di
+tale materiale siano appositamente marcate in maniera differente rispetto alla
+versione originale; oppure
+
address@hidden
+Limitano l'utilizzo per scopi pubblicitari del nome dei detentori del
+copyright o degli autori del materiale; oppure
+
address@hidden
+Rifiutano di garantire diritti secondo le leggi sulla address@hidden
intellettuale
+circa l'uso di nomi, marchi di fabbrica o similari; oppure
+
address@hidden
+Richiedono l'indennizzo dei detentori del copyright o degli autori del
+materiale in oggetto da parte di chi distribuisce il materiale (o versioni
+modificate dello stesso) con impegni contrattuali circa la address@hidden nei
+confronti del destinatario, per qualunque address@hidden che questi impegni
+contrattuali dovessero imporre direttamente ai suddetti detentori del
+copyright e autori.
address@hidden enumerate
+
+Tutte le altre condizioni addizionali non-permissive sono considerate
+``ulteriori restrizioni'', secondo il significato specificato alla sezione 10.
+Se il Programma o parti di esso contengono, all'atto della ricezione dello
+stesso, informative che specificano che esso @`e soggetto a questa Licenza
+assieme ad una condizione che @`e una ``ulteriore restrizione'', puoi rimuovere
+quest'ultima condizione. Se un documento di licenza contiene ulteriori
+restrizioni ma permette di rilicenziare o distribuire il Programma con questa
+Licenza, puoi aggiungere al Programma del materiale coperto dalle condizioni
+di quel documento di licenza, a patto che le ulteriori restrizioni non
+compaiano nelle versioni rilicenziate o ridistribuite.
+
+Se aggiungi ad un Programma coperto da questa Licenza delle condizioni
+aggiuntive in accordo con questa sezione, devi aggiungere anche, nei file
+sorgenti corrispondenti, un avviso che riassuma le condizioni aggiuntive
+applicate a quei file, ovvero un avviso che specifichi dove @`e possibile
+trovare copia delle condizioni aggiunte.
+
+Tutte le Condizioni aggiuntive, permissive o non-permissive, devono essere
+espresse nella forma di una licenza scritta e separata, o espresse
+esplicitamente come eccezioni; in entrambi i casi valgono le condizioni
+succitate.
+
address@hidden Cessazione di Licenza
+
+Non puoi propagare o modificare un programma coperto da questa Licenza in
+maniera diversa da quanto espressamente consentito da questa Licenza.
+Qualunque tentativo di propagare o modificare altrimenti il Programma @`e
nullo,
+e provoca l'immediata cessazione dei diritti garantiti da questa Licenza
+(compresi tutte le eventuali licenze di brevetto garantite ai sensi del terzo
+paragrafo della sezione 11).
+
+In ogni caso, se cessano tutte le violazioni di questa Licenza, allora la tua
+licenza da parte di un dato detentore del copyright viene ripristinata (a) in
+via cautelativa, a meno che e fino a quando il detentore del copyright non
+cessa esplicitamente e definitivamente la tua licenza, e (b) in via permanente
+se il detentore del copyright non ti notifica in alcun modo la violazione
+entro 60 giorni dalla cessazione della licenza.
+
+Inoltre, la tua licenza da parte di un dato detentore del copyright viene
+ripristinata in maniera permanente se il detentore del copyright ti notifica
+la violazione in maniera adeguata, se questa @`e la prima volta che ricevi una
+notifica di violazione di questa Licenza (per qualunque Programma) dallo
+stesso detentore di copyright, e se rimedi alla violazione entro 30 giorni
+dalla data di ricezione della notifica di violazione.
+
+La cessazione dei tuoi diritti come specificato in questa sezione non provoca
+la cessazione delle licenze di terze parti che abbiano ricevuto copie o
+diritti da te secondo questa Licenza. Se i tuoi diritti cessano e non sono
+ristabiliti in via permanente, non hai diritto di ricevere nuove licenze per
+lo stesso materiale, secondo quanto stabilito nella sezione 10.
+
address@hidden L'ottenimento di copie non richiede l'accettazione della Licenza
+
+Non sei obbligato ad accettare i termini di questa Licenza al solo fine di
+ottenere o eseguire una copia del Programma. Similmente, propagazioni
+collaterali di un Programma coperto da questa Licenza che occorrono come
+semplice conseguenza dell'utilizzo di trasmissioni peer-to-peer per la
+ricezione di una copia non richiedono l'accettazione della Licenza. In ogni
+caso, solo e soltanto questa Licenza ti garantiscono il permesso di propagare
+e modificare qualunque programma coperto da questa Licenza. Queste azioni
+violano le leggi sul copyright nel caso in cui tu non accetti questa Licenza.
+Pertanto, modificando o propagando un programma coperto da questa Licenza,
+indichi implicitamente la tua accettazione della Licenza.
+
address@hidden Licenza Automatica per i successivi destinatari
+
+Ogni qual volta distribuisci un programma coperto da questa Licenza, il
+destinatario riceve automaticamente una licenza, dal detentore originario del
+copyright, di eseguire, modificare e propagare il programma, nel rispetto di
+questa Licenza. Non sei ritenuto responsabile del rispetto di questa Licenza
+da parte di terze parti.
+
+Una ``transazione d'address@hidden'' @`e una transazione che trasferisce il
controllo di
+una organizzazione, o sostanzialmente di tutti i suoi beni, che suddivide una
+organizzazione o che fonde address@hidden organizzazioni. Se la propagazione
di un
+programma coperto da questa Licenza @`e conseguente ad una transazione di
address@hidden, ciascuna parte che ha ruolo nella transazione e che riceve una
copia
+del programma riceve allo stesso tempo qualsiasi licenza sul programma che i
+predecessori della parte possedevano o potevano rilasciare nel rispetto del
+paragrafo precedente, e in address@hidden il diritto di possesso del Sorgente
+Corrispondente del programma dal predecessore in interesse, se il predecessore
+lo possiede o se address@hidden ottenerlo senza troppe address@hidden
+
+Non puoi imporre nessuna ulteriore restrizione sull'esercizio dei diritti
+garantiti o affermati da questa Licenza. Per esempio, non puoi imporre un
+prezzo di licenza, una royalty, o altri costi per l'esercizio dei diritti
+garantiti da questa Licenza, a non puoi dar corso ad una controversia (ivi
+incluse le controversie incrociate o la difesa in cause legali) affermando che
+siano stati violati dei brevetti a causa della produzione, dell'uso, della
+vendita, della messa in vendita o dell'importazione del Programma o di sue
+parti.
+
address@hidden Brevetti
+
+Un ``contribuente'' @`e un detentore di copyright che autorizza l'uso secondo
+questa Licenza di un Programma o di un'opera basata sul Programma. L'opera
address@hidden@dotless{i}} licenziata viene chiamata ``versione del
contribuente''.
+
+I ``diritti essenziali di brevetto'' da parte di un contribuente sono tutti i
+diritti di brevetto che appartengono o che sono controllati dal contribuente,
+che siano address@hidden acquisiti o che saranno acquisiti in futuro, che
possano essere
+violati in qualche maniera, consentita da questa Licenza, generando,
+modificando o vendendo la versione del contribuente, ma non includono i
+diritti che possano essere violati soltanto come conseguenza di ulteriori
+modifiche alla versione del contribuente. In relazione a questa definizione,
+il termine ``controllo'' include il diritto di garantire sottolicenze di
+brevetto in maniera consistente con le condizioni di questa Licenza.
+
+Ciascun contribuente ti garantisce la licenza di brevetto sui diritti
+essenziali di brevetto del contribuente stesso non-esclusiva, valida in tutto
+il mondo, esente da royalty, di creare, usare, vendere, offrire in vendita,
+importare e altrimenti eseguire, modificare e propagare i contenuti della
+versione del contribuente.
+
+Nei tre paragrafi successivi, con ``licenza di brevetto'' si intende qualunque
+accordo o contratto, comunque denominato, di non rivendicazione di un brevetto
+(come per esempio un permesso esplicito di utilizzare un brevetto o un accordo
+di rinuncia alla persecuzione per violazione di brevetto). ``Garantire'' una
+tale licenza di brevetto ad una parte significa portare a termine un tale
+accordo o contratto di non rivendicazione di brevetto contro la parte.
+
+Se distribuisci un programma coperto da questa Licenza, confidando
+consapevolmente su una licenza di brevetto, e il Sorgente Corrispondente per
+il programma non @`e reso disponibile per la copia, senza alcun onere
aggiuntivo
+e comunque nel rispetto delle condizioni di questa Licenza, attraverso un
+server di rete pubblicamente accessibile o tramite altri mezzi facilmente
+accessibili, allora devi (1) fare in modo che il Sorgente Corrispondente sia
+reso disponibile come sopra, oppure (2) fare in modo di rinunciare ai benefici
+della licenza di brevetto per quel particolare programma, oppure (3)
+adoperarti, in maniera consistente con le condizioni di questa Licenza, per
+estendere la licenza di brevetto a tutti i destinatari successivi. ``Confidare
+consapevolmente'' significa che tu sei attualmente cosciente che, eccettuata la
+licenza di brevetto, la distribuzione da parte tua di un programma protetto da
+questa Licenza in un paese, o l'utilizzo in un paese del programma coperto da
+questa Licenza da parte di un destinatario, address@hidden violare uno o
address@hidden brevetti in
+quel paese che tu hai ragione di ritenere validi.
+
+Se, come conseguenza o in connessione con una singola transazione o con un
+dato accordo, distribuisci, o fai in modo di distribuire, un programma coperto
+da questa Licenza, e garantisci una licenza di brevetto per alcune delle parti
+che ricevono il Programma autorizzandole ad utilizzare, propagare, modificare
+o distribuire una specifica copia del Programma, allora la licenza di brevetto
+che fornisci @`e automaticamente estesa a tutti i destinatari del Programma
+coperto da questa Licenza e delle opere basate sul Programma.
+
+Una licenza di brevetto @`e ``discriminatoria'' se non include nell'ambito
della
+sua copertura, proibisce l'esercizio, o @`e vincolata al non-esercizio di uno o
address@hidden dei diritti che sono specificatamente garantiti da questa
Licenza. Non
+puoi distribuire un Programma coperto da questa Licenza se sei parte di un
+accordo con una terza parte la cui address@hidden comprende la distribuzione di
+software, secondo il quale tu sei costretto ad un pagamento alla parte terza
+in funzione della tua address@hidden di distribuzione del Programma, e in
+conseguenza del quale la parte terza garantisce, a qualunque delle parti che
+riceveranno il Programma da te, una licenza di brevetto discriminatoria (a)
+assieme a copie del Programma coperto da questa Licenza distribuite da te (o
+ad altre copie fatte da codeste copie), oppure (b) principalmente per e in
+connessione con specifici prodotti o raccolte di prodotti che contengono il
+Programma, a meno che l'accordo non sia stato stipulato, o le licenze di
+brevetto non siano state rilasciate, prima del 28 Marzo 2007.
+
+Nessuna parte di questa Licenza address@hidden essere interpretata come atta
ad escludere
+o limitare gli effetti di qualunque altra licenza o altri meccanismi di difesa
+dalla violazione che possano altrimenti essere resi disponibili dalla
+normativa vigente in materia di brevetti.
+
address@hidden Nessuna resa di address@hidden altrui
+
+Se ti vengono imposte delle condizioni (da un ordine giudiziario, da un
+accordo o da qualunque altra address@hidden) che contraddicono le condizioni di
+questa Licenza, non sei in nessun modo esonerato dal rispetto delle condizioni
+di questa Licenza. Se non puoi distribuire un Programma coperto da questa
+Licenza per sottostare simultaneamente agli obblighi derivanti da questa
+Licenza e ad altri obblighi pertinenti, allora non puoi distribuire il
+Programma per nessun motivo. Per esempio, se accetti delle condizioni che ti
+obbligano a richiedere il pagamento di una royalty per le distribuzioni
+successivamente effettuate da coloro ai quali hai distribuito il Programma,
+l'unico modo per soddisfare sia queste condizioni che questa Licenza @`e
evitare
+del tutto la distribuzione del Programma.
+
address@hidden Utilizzo con la GNU Affero General Public License
+
+Indipendentemente da qualunque altra condizione espressa da questa Licenza,
+hai il permesso di collegare o combinare qualunque Programma coperto da questa
+Licenza con un'opera rilasciata sotto la versione 3 della licenza GNU Affero
+General Public License, ottenendo un singolo Programma derivato, e di
+distribuire il Programma risultante. Le condizioni di questa Licenza
+continuano a valere per le parti riguardanti il Programma che sono coperte da
+questa Licenza, mentre le condizioni speciali della GNU Affero General Public
+License, sezione 13, riguardanti l'interazione mediante rete, saranno
+applicate al Programma address@hidden@dotless{i}} risultante.
+
address@hidden Versioni rivedute di questa Licenza
+
+La Free Software Foundation address@hidden pubblicare delle versioni rivedute
e/o delle
+nuove versioni della GNU General Public License di tanto in tanto. Tali
+versioni saranno simili, nello spirito, alla presente versione, ma potranno
+differire nei dettagli al fine di affrontare nuovi problemi e nuove
+situazioni.
+
+A ciascuna versione viene assegnato un numero identificativo di versione. Se
+il Programma specifica che si applica a address@hidden stesso una certa
versione della GNU
+General Public License, ``o qualunque altra versione successiva'', hai la
address@hidden di sottostare alle condizioni di quella specifica versione o di
+qualunque altra versione successiva pubblicata dalla Free Software Foundation.
+Se il Programma non specifica un numero di versione della GNU General Public
+License, puoi scegliere qualunque versione della GNU General Public License
+pubblicata dalla Free Software Foundation.
+
+Se il Programma specifica che un sostituto o un procuratore address@hidden
decidere quali
+versioni future della GNU General Public License posso essere utilizzate,
+allora tale scelta di accettazione di una data versione ti autorizza, in
+maniera permanente, ad utilizzare quella versione della Licenza per il
+Programma.
+
+Versioni successive della Licenza possono garantire diritti aggiuntivi o
+leggermente differenti. Ad ogni modo, nessun obbligo aggiuntivo viene imposto
+agli autori o ai detentori di copyright come conseguenza della tua scelta di
+adottare una versione successiva della Licenza.
+
address@hidden Rinuncia alla Garanzia
+
+NON C'@`E NESSUNA GARANZIA PER IL PROGRAMMA, PER QUANTO CONSENTITO DALLE
+VIGENTI NORMATIVE. ECCETTO QUANDO ALTRIMENTI STABILITO PER ISCRITTO, I
+DETENTORI DEL COPYRIGHT E/O LE ALTRE PARTI FORNISCONO IL PROGRAMMA
address@hidden COME
address@hidden'' SENZA GARANZIA DI ALCUN TIPO, N@'E ESPRESSA N@'E IMPLICITA,
INCLUSE, MA NON
+LIMITATE A, LE GARANZIE DI address@hidden O DI address@hidden PER UN
+PARTICOLARE SCOPO. L'INTERO RISCHIO CONCERNENTE LA address@hidden E LE
PRESTAZIONI
+DEL PROGRAMMA @`E DEL LICENZIATARIO. SE IL PROGRAMMA DOVESSE RISULTARE
+DIFETTOSO, IL LICENZIATARIO SI ASSUME I COSTI DI MANUTENZIONE, RIPARAZIONE O
+CORREZIONE.
+
address@hidden Limitazione di address@hidden
+
+IN NESSUN CASO, A MENO CHE NON SIA RICHIESTO DALLA NORMATIVA VIGENTE O
+CONCORDATO PER ISCRITTO, I DETENTORI DEL COPYRIGHT, O QUALUNQUE ALTRA PARTE
+CHE MODIICA E/O DISTRIBUISCE IL PROGRAMMA SECONDO LE CONDIZIONI PRECEDENTI,
+POSSONO ESSERE RITENUTI RESPONSABILI NEI CONFRONTI DEL LICENZIATARIO PER
+DANNI, INCLUSO QUALUNQUE DANNEGGIAMENTO GENERICO, SPECIALE, INCIDENTALE O
+CONSEQUENZIALE DOVUTO ALL'USO O ALL'address@hidden D'USO DEL PROGRAMMA
+(INCLUSI, MA NON LIMITATI A, LE PERDITE DI DATI, LA CORRUZIONE DI DATI, LE
+PERDITE SOSTENUTE DAL LICENZIATARIO O DA TERZE PARTI O L'address@hidden DEL
+PROGRAMMA A FUNZIONARE ASSIEME AD ALTRI PROGRAMMI), ANCHE NEL CASO IN CUI IL
+DETENTORE O LE ALTRE PARTI SIANO STATI AVVISATI CIRCA LA address@hidden DI TALI
+DANNEGGIAMENTI.
+
address@hidden Interpretazione delle Sezioni 15 e 16
+
+Se la dichiarazione di garanzia e la limitazione di address@hidden fornite
+precedentemente non hanno effetto legale in un paese a causa delle loro
+condizioni, le corti di giustizia devono applicare la norma locale che
address@hidden si
+avvicini al rifiuto assoluto di qualsivoglia address@hidden civile relativa al
+Programma, a meno che una garanzia o una assunzione di address@hidden scritta
+non accompagni una copia del programma ottenuta dietro pagamento.
address@hidden enumerate
+
address@hidden fakenode --- for prepinfo
address@hidden FINE DEI TERMINI E DELLE CONDIZIONI
+
address@hidden fakenode --- for prepinfo
address@hidden Come applicare queste condizioni di Licenza ai vostri programmi
+
+Se sviluppi un nuovo programma, e vuoi che esso sia della massima
address@hidden, il
+modo migliore @`e renderlo software libero in modo che chiunque possa
+ridistribuirlo e modificarlo secondo i termini di questa Licenza.
+
+Per fare address@hidden, allega le seguenti note informative al programma. Il
modo
+migliore @`e inserirle all'inizio di ciascun file sorgente, al fine di
rimarcare
+adeguatamente la mancanza di garanzia; ciascun file dovrebbe inoltre contenere
+la dichiarazione di copyright e un riferimento al posto in cui @`e possibile
+ottenere la versione completa delle note informative.
+
address@hidden
address@hidden<una riga con nome del programma e breve descrizione di
address@hidden che fa.>}
+Copyright (C) @var{<anno>} @var{<nome dell'autore>}
+
+Questo software @`e libero; lo puoi distribuire e/o modificare alle condizioni
+stabilite nella 'GNU General Public License' pubblicata dalla Free Software
+Foundation; fai riferimento alla versione 3 della Licenza, o (a tua scelta)
+a una qualsiasi versione successiva.
+
+Questo programma @`e distribuito con la speranza che sia utile, ma SENZA
+ALCUNA GARANZIA; senza neppure la garanzia implicita di address@hidden o
address@hidden AD UN PARTICOLARE SCOPO. Si veda la 'GNU General Public License'
per
+ulteriori dettagli.
+
+Dovresti aver ricevuto una copia della GNU General Public License assieme a
+questo programma; se non @`e address@hidden@dotless{i}}, si veda
address@hidden://www.gnu.org/licenses/}.
address@hidden smallexample
+
+Inoltre, aggiungi le informazioni necessarie a contattarti via posta ordinaria
+o via posta elettronica.
+
+Se il programma interagisce mediante terminale, fai in modo che visualizzi,
+quando viene avviato in address@hidden interattiva, un breve messaggio come
quello
+che segue:
+
address@hidden
address@hidden<programma>} Copyright (C) @var{<anno>} @var{<nome dell'autore>}
+Questo programma non ha ALCUNA GARANZIA; per dettagli usare il comando
address@hidden w}.
+Questo @`e software libero, e ognuno @`e libero di ridistribuirlo
+sotto certe condizioni; usare il comando @samp{show c} per i dettagli.
address@hidden smallexample
+
+Gli ipotetici comandi @samp{show w} e @samp{show c} devono visualizzare le
parti
+corrispondenti della GNU General Public License. Naturalmente i comandi del
+tuo programma potrebbero essere differenti; per una interfaccia di tipo GUI,
+dovresti usare un bottone ``About'' o ``Info''.
+
+Devi inoltre fare in modo che il tuo datore di lavoro (se lavori come
+programmatore presso terzi) o la tua scuola, eventualmente, firmino una
+``rinuncia al copyright'' sul programma, se necessario. Per maggiori
+informazioni su questo punto, e su come applicare e rispettare la GNU GPL,
+consultare la pagina @url{http://www.gnu.org/licenses/}.
+
+La GNU General Public License non consente di incorporare il programma
+all'interno di software proprietario. Se il tuo programma @`e una libreria di
+funzioni, potresti ritenere address@hidden opportuno consentire il
collegamento tra
+software proprietario e la tua libreria. Se @`e questo address@hidden che
vuoi, allora
+utilizza la GNU Lesser General Public License anzich@'e questa Licenza, ma
prima
+leggi @url{http://www.gnu.org/philosophy/why-not-lgpl.html}.
+
address@hidden FOR_PRINT
address@hidden The GNU Free Documentation License.
address@hidden Licenza per Documentazione Libera GNU (FDL)
address@hidden Licenza per Documentazione Libera GNU (FDL)
address@hidden
address@hidden Versione 1.3, 3 Novembre 2008
address@hidden ifnotdocbook
+
address@hidden
+<subtitle>Versione 1.3, 3 Novembre 2008 </subtitle>
address@hidden docbook
+
address@hidden FDL (Free Documentation License)
address@hidden Free Documentation License (FDL)
address@hidden GNU Free Documentation License
+
address@hidden This file is intended to be included within another document,
address@hidden hence no sectioning command or @node.
+
address@hidden
+Copyright @copyright{} 2000, 2001, 2002, 2007, 2008 Free Software Foundation,
Inc.
address@hidden://fsf.org}
+
+This is an unofficial translation of the GNU Free Documentation License into
+Italian. It was not published by the Free Software Foundation, and does not
+legally state the distribution terms for software that uses the GNU FDLâonly
+the original English text of the GNU FDL does that. However, we hope that this
+translation will help Italian speakers understand the GNU FDL better.
+
+Questa @`e una traduzione non ufficiale della GNU Free Documentation License
+in italiano. Non @`e una pubblicazione della Free Software Foundation, e non
+ha address@hidden legale per i termini di distribuzione della documentazione
che
+usa la GNU FDL; solo il testo originale inglese della GNU FDL ha tale
address@hidden Comunque, speriamo che questa traduzione aiuti chi parla
+italiano a comprendere meglio la GNU FDL.
+
+A chiunque @`e permesso copiare e ridistribuire copie esatte di questo
documento
+di licenza, ma non @`e in alcun modo consentito apportarvi modifiche.
+
address@hidden display
+
address@hidden 0
address@hidden
+PREAMBOLO
+
+Lo scopo di questa licenza @`e di rendere @dfn{liberi} un manuale, un testo o
+altri documenti funzionali e utili, nel senso di assicurare a tutti la
address@hidden effettiva di copiarli e ridistribuirli, con o senza modifiche,
con
+o senza fini di lucro. In secondo luogo questa licenza prevede per autori
+ed editori il modo per ottenere il giusto riconoscimento del proprio
+lavoro, preservandoli dall'essere considerati responsabili per modifiche
+apportate da altri.
+
+Questa licenza garantisce il ``copyleft'': questo significa che i lavori che
+derivano dal documento originale devono essere ugualmente liberi. @`E il
+complemento alla Licenza Pubblica Generale GNU, che @`e una licenza di tipo
+``copyleft'' pensata per il software libero.
+
+Questa licenza @`e stata progettata appositamente per l'uso con manuali di
+software libero, perch@'e il software libero ha bisogno di documentazione
+libera: un programma libero dovrebbe accompagnarsi a manuali che
+forniscano le stesse address@hidden del software. Questa licenza non @`e
limitata
+alla manualistica del software; address@hidden essere utilizzata per ogni
testo che
+tratti un qualsiasi argomento e al di address@hidden dell'avvenuta
pubblicazione
+cartacea. Si raccomanda l'uso di questa licenza principalmente per opere
+che abbiano fini didattici o per manuali.
+
address@hidden
address@hidden E DEFINIZIONI
+
+Questa licenza si applica a qualsiasi manuale o altra opera, su ogni tipo
+di supporto, che contenga la nota, posta dal detentore del copyright, che
+attesti la address@hidden di distribuzione secondo i termini di questa
+licenza. Tale nota permette universalmente, senza pagamento di diritti e
+senza limiti di durata di utilizzare il lavoro secondo le condizioni qui
+specificate. Con ``documento'', nel seguito ci si riferisce a qualsiasi
+manuale o opera. Ogni fruitore @`e un destinatario della licenza ed @`e ad
+esso che si fa riferimento. Si conviene che la licenza viene accettata se
+si copia, modifica o distribuisce il lavoro in una maniera tale da
+richiedere il permesso secondo le leggi sul copyright.
+
+Una ``versione modificata'' del documento @`e ogni opera contenente il
+documento stesso o parte di esso, sia riprodotto alla lettera che con
+modifiche, oppure traduzioni in un'altra lingua.
+
+Una ``sezione secondaria'' @`e un'appendice cui si fa riferimento o una
+premessa del documento e riguarda esclusivamente il rapporto dell'editore
+o dell'autore del documento con l'argomento generale del documento stesso
+(o argomenti affini) e non contiene nulla che possa essere compreso
+nell'argomento principale. (address@hidden, se il documento @`e in parte un
manuale
+di matematica, una sezione secondaria non address@hidden contenere spiegazioni
di
+matematica). Il rapporto con l'argomento address@hidden essere un tema
collegato
+storicamente con il soggetto principale o con soggetti affini, o essere
+costituito da argomentazioni legali, commerciali, filosofiche, etiche o
+politiche pertinenti.
+
+Le ``sezioni non modificabili'' sono alcune sezioni secondarie i cui titoli
+sono esplicitamente elencati come titoli delle sezioni non modificabili
+nella nota che indica che il documento @`e realizzato sotto questa licenza.
+Se una sezione non rientra nella precedente definizione di sezione
+secondaria, allora non @`e permesso che venga definita come non
+modificabile. Il documento address@hidden anche non contenere sezioni non
+modificabili. Se nel documento non vengono indicate sezioni non
+modificabili, allora significa che non ve ne sono.
+
+I ``testi di copertina'' sono dei brevi brani di testo che sono elencati,
+nella prima o quarta pagina di copertina, nella nota che indica che il
+documento @`e rilasciato sotto questa licenza. Il testo sulla prima di
+copertina address@hidden essere composto al massimo di 5 parole mentre quello
sulla
+quarta di copertina address@hidden essere al massimo di 25 parole.
+
+Una copia ``trasparente'' indica una copia leggibile da un calcolatore,
+codificata in un formato le cui specifiche sono disponibili pubblicamente,
+tale che il suo contenuto possa essere modificato in modo semplice con
+generici editor di testi o (per immagini composte da pixel) con generici
+editor di immagini o (per i disegni) con qualche editor di disegni
+ampiamente diffuso; la copia deve essere adatta al trattamento per la
+formattazione o per la conversione in una address@hidden di formati atti alla
+successiva formattazione. Una copia fatta in un formato di file, per il
+resto trasparente, i cui marcatori o assenza di tali sono stati progettati
+per intralciare o scoraggiare modifiche future da parte dei lettori non @`e
+trasparente. Un formato immagine non @`e trasparente se viene usato per
+rappresentare una notevole address@hidden di testo. Una copia non
``trasparente''
+viene detta ``opaca''.
+
+Esempi di formati adatti per copie trasparenti sono l'@sc{ASCII} puro senza
+marcatori, il formato di ingresso per Texinfo, il formato di ingresso per
address@hidden, @acronym{SGML} o @acronym{XML} accoppiati ad una @acronym{DTD}
+pubblica e disponibile, e i formati conformi agli standard @acronym{HTML}
+semplice, Postscript e @acronym{PDF} progettati per essere modificati
+manualmente. Esempio di formati immagine trasparenti includono il
address@hidden, @acronym{XCF} e @acronym{JPG}. I formati opachi includono i
+formati proprietari che possono essere letti e modificati solo con word
+processor proprietari, @acronym{SGML} o @acronym{XML} per cui non @`e in
+genere disponibile la @acronym{DTD} o gli strumenti per il trattamento, e i
+formati @acronym{HTML}, Postscript e @acronym{PDF} generati automaticamente
+da qualche word processor esclusivamente come output.
+
+La ``pagina del titolo'' di un libro stampato indica la pagina del titolo
+stessa, address@hidden qualche pagina seguente per quanto necessario a
contenere in
+modo leggibile, il materiale che la licenza prevede che compaia nella
+pagina del titolo. Per opere in formati in cui non sia contemplata
+esplicitamente la pagina del titolo, con ``pagina del titolo'' si intende il
+testo prossimo al titolo dell'opera, precedente l'inizio del corpo del
+testo.
+
+Il termine ``editore'' indica qualunque persona o address@hidden che
distribuisce al
+pubblico copie del documento.
+
+Una sezione ``Intitolata XYZ'' significa una sottosezione con nome del
+documento il cui titolo sia precisamente XYZ o che contenga XYZ in
+parentesi dopo il testo che traduce XYZ in un'altra lingua (in questo caso
+XYZ sta per uno specifico nome di sezione menzionato sotto, come per i
+``Riconoscimenti'', ``Dediche'', ``Approvazioni'', o ``Storia''). Secondo
questa
+definizione, ``preservare il titolo'' di tale sezione quando si modifica il
+documento, significa che essa rimane una sezione ``Intitolata XYZ''.
+
+Il Documento address@hidden includere dei limiti alla garanzia accanto alla
nota
+affermante l'applicazione di questa licenza al documento. Questi limiti
+alla garanzia sono da considerare da includere come riferimento a questa
+licenza, ma solo per quanto riguarda le limitazioni alla garanzia: ogni
+altra implicazione che questi limiti alla garanzia possono avere @`e da
+considerarsi nulla e non ha effetto sul significato di questa licenza.
+
address@hidden
+COPIE LETTERALI
+
+Si address@hidden copiare e distribuire il documento con qualsiasi mezzo, con
o senza
+fini di lucro, purch@'e tutte le copie contengano questa licenza, le note di
+copyright e l'avviso che questa licenza si applica al documento, e che non
+si aggiungano altre condizioni al di fuori di quelle della licenza stessa.
+Non si possono usare misure tecniche per impedire o controllare la lettura
+o la produzione di copie successive alle copie che si producono o
+distribuiscono. Si possono comunque accettare compensi per la copiatura.
+Se si distribuiscono un numero sufficiente di copie si devono seguire
+anche le condizioni della sezione 3.
+
+Alle stesse condizioni sopra menzionate si possono prestare copie e
+mostrarle pubblicamente.
+
address@hidden
+COPIARE IN NOTEVOLI address@hidden
+
+Se si pubblicano a mezzo stampa (o in formati che tipicamente posseggono
+copertine) address@hidden di 100 copie del documento, e la nota della licenza
+richiede uno o address@hidden testi di copertina, si devono includere nelle
copie, in
+modo chiaro e leggibile, tutti i testi di copertina indicati: il testo
+della prima di copertina in prima di copertina e il testo di quarta di
+copertina in quarta di copertina. Ambedue devono identificare l'editore
+che pubblica il documento. La prima di copertina deve presentare il titolo
+completo con tutte le parole che lo compongono egualmente visibili ed
+evidenti. Si address@hidden aggiungere altro materiale alle copertine. Il
copiare con
+modifiche limitate alle sole copertine, purch@'e si preservino il titolo e
+le altre condizioni viste in precedenza, @`e considerato alla stregua di
+copiare alla lettera.
+
+Se il testo richiesto per le copertine @`e troppo voluminoso per essere
+riprodotto in modo leggibile, se ne address@hidden mettere una prima parte (per
+quanto ragionevolmente address@hidden stare) in copertina, e continuare il
resto
+nelle pagine immediatamente seguenti.
+
+Se si pubblicano o distribuiscono copie opache del documento in numero
+superiore a 100, si deve anche includere una copia trasparente leggibile
+da un calcolatore in ogni copia oppure menzionare in ogni copia opaca un
+indirizzo di rete di calcolatori pubblicamente accessibile che utilizzi un
+protocollo di rete standard pubblico, da cui si possa scaricare
+liberamente una copia trasparente completa del documento, senza materiale
+aggiuntivo. Se si adotta quest'ultima opzione, si deve prestare la giusta
+attenzione, nel momento in cui si inizia la distribuzione in address@hidden
+elevata di copie opache, ad assicurarsi che la copia trasparente rimanga
+accessibile all'indirizzo stabilito fino ad almeno un anno dopo l'ultima
+distribuzione (direttamente o attraverso distributori o rivenditori) di
+quell'edizione al pubblico.
+
address@hidden caldamente consigliato, bench@'e non obbligatorio, contattare
l'autore del
+documento prima di distribuirne un numero considerevole di copie, per
+metterlo in grado di fornire una versione aggiornata del documento.
+
address@hidden
+MODIFICHE
+
+Si possono copiare e distribuire versioni modificate del documento
+rispettando le condizioni delle precedenti sezioni 2 e 3, purch@'e la
+versione modificata sia realizzata seguendo questa stessa licenza, con la
+versione modificata che svolga il ruolo del ``documento'',
address@hidden@dotless{i}} da estendere
+la licenza sulla distribuzione e la modifica a chiunque ne possieda una
+copia. Inoltre nelle versioni modificate si deve:
+
address@hidden A
address@hidden
+Usare nella pagina del titolo (e nelle copertine se ce ne sono) un titolo
+diverso da quello del documento, e da quelli di versioni precedenti (che
+devono essere elencati nella sezione storia del documento ove presenti).
+Si address@hidden usare lo stesso titolo di una versione precedente se
l'editore di
+quella versione originale ne ha dato il permesso.
+
address@hidden
+Elencare nella pagina del titolo, come autori, una o address@hidden persone o
gruppi
+responsabili in address@hidden di autori delle modifiche nella versione
+modificata, insieme ad almeno cinque tra i principali autori del documento
+(tutti gli autori principali se sono meno di cinque), a meno che questi
+non abbiano acconsentito a liberarvi da quest'obbligo.
+
address@hidden
+Dichiarare nella pagina del titolo il nome dell'editore della versione
+modificata in address@hidden di editore.
+
address@hidden
+Conservare tutte le note di copyright
+del documento originale.
+
address@hidden
+Aggiungere un'appropriata nota di copyright per
+le modifiche di seguito alle altre note di copyright.
+
address@hidden
+Includere, immediatamente dopo la nota di copyright, una nota di licenza
+che dia pubblicamente il permesso di usare la versione modificata nei
+termini di questa licenza, nella forma mostrata nell'Addendum alla fine di
+questo testo.
+
address@hidden
+Preservare in tale nota di licenza l'elenco completo di sezioni non
+modificabili e testi di copertina richiesti come previsto dalla licenza
+del documento.
+
address@hidden
+Includere una copia non modificata di questa licenza.
+
address@hidden
+Conservare la sezione intitolata ``Storia'', e il suo titolo, e aggiungere
+a questa un elemento che riporti almeno il titolo, l'anno, i nuovi autori,
+e gli editori della versione modificata come figurano nella pagina del
+titolo. Se non ci sono sezioni intitolate ``Storia'' nel documento,
+crearne una che riporti il titolo, gli autori, gli editori del documento
+come figurano nella pagina del titolo, quindi aggiungere un elemento che
+descriva la versione modificata come detto in precedenza.
+
address@hidden
+Conservare l'indirizzo in rete riportato nel documento, se c'@`e, al fine
+del pubblico accesso ad una copia trasparente, e possibilmente l'indirizzo
+in rete per le precedenti versioni su cui ci si @`e basati. Questi possono
+essere collocati nella sezione ``Storia''. Si address@hidden omettere un
indirizzo di
+rete per un'opera pubblicata almeno quattro anni prima del documento
+stesso, o se l'originario editore della versione cui ci si riferisce ne
address@hidden
+il permesso.
+
address@hidden
+In ogni sezione di ``Ringraziamenti'' o ``Dediche'', si conservi il titolo
+della sezione, e all'interno della sezione tutta la sostanza e il tono di
+ognuno dei ringraziamenti ai contributori e/o le dediche ivi contenute.
+
address@hidden
+Si conservino inalterate le sezioni non modificabili del documento, nei
+propri testi e nei propri titoli. I numeri della sezione o equivalenti non
+sono considerati parte del titolo della sezione.
+
address@hidden
+Si cancelli ogni sezione intitolata ``Approvazioni''. Tale sezione non
address@hidden
+essere inclusa nella versione modificata.
+
address@hidden
+Non si cambi il titolo di sezioni esistenti in ``Approvazioni'' o in modo
+tale che si possa creare confusione con i titoli di sezioni non
+modificabili.
+
address@hidden
+Si conservino tutti i limiti alla garanzia.
address@hidden enumerate
+
+
+
+Se la versione modificata comprende nuove sezioni di primaria
+importanza o appendici che ricadono in ``sezioni secondarie'', e non
+contengono materiale copiato dal documento, si ha address@hidden di rendere non
+modificabili quante sezioni si voglia. Per fare address@hidden si aggiunga il
loro
+titolo alla lista delle sezioni non modificabili nella nota di licenza
+della versione modificata. Questi titoli devono essere distinti dai titoli
+di ogni altra sezione.
+
+Si address@hidden aggiungere una sezione intitolata ``Approvazioni'', a patto
che non
+contenga altro che le approvazioni alla versione modificata prodotte da
+vari soggetti--per esempio, affermazioni di revisione o che il testo @`e
+stato approvato da una organizzazione come la definizione normativa di uno
+standard.
+
+Si address@hidden aggiungere un brano fino a cinque parole come testo di prima
di
+copertina e un brano fino a 25 parole come testo di quarta di copertina,
+alla fine dell'elenco dei testi di copertina nella versione modificata.
+Solamente un brano del testo di prima di copertina e uno del testo di
+quarta di copertina possono essere aggiunti (anche con adattamenti) da
+ciascuna persona o organizzazione. Se il documento include address@hidden un
testo di
+copertina per la stessa copertina, precedentemente aggiunto o adattato da
+qualunque fruitore o dalla stessa organizzazione nel nome della quale si
+agisce, non se ne address@hidden aggiungere un altro, ma si address@hidden
rimpiazzare il
+vecchio ottenendo l'esplicita autorizzazione dall'editore precedente che
+aveva aggiunto il testo di copertina.
+
+L'autore/i e l'editore/i del documento non danno, tramite questa licenza,
+il permesso di usare i loro nomi per pubblicizzare o asserire, anche
+implicitamente, la loro approvazione di ogni versione modificata.
+
address@hidden
+COMBINAZIONE DI DOCUMENTI
+
+Si address@hidden combinare il documento con altri pubblicati con questa
licenza,
+seguendo i termini definiti nella precedente sezione 4 per le versioni
+modificate, a patto che si includa l'insieme di tutte le sezioni non
+modificabili di tutti i documenti originali, senza modifiche, e si
+elenchino tutte come sezioni non modificabili della combinazione di
+documenti nella licenza della stessa, mantenendo tutti i limiti alla
+garanzia.
+
+Nella combinazione @`e necessaria una sola copia di questa licenza, e
address@hidden
+sezioni non modificabili possono essere rimpiazzate da una singola copia
+se identiche. Se ci sono address@hidden sezioni non modificabili con lo stesso
nome
+ma contenuti differenti, si renda unico il titolo di ciascuna sezione
+aggiungendovi, alla fine e tra parentesi, il nome dell'autore o editore
+della sezione, se noti, o altrimenti un numero distintivo. Si facciano gli
+stessi aggiustamenti ai titoli delle sezioni nell'elenco delle sezioni non
+modificabili nella nota di copyright della combinazione.
+
+Nella combinazione si devono unire le varie sezioni intitolate ``Storia''
+nei vari documenti originali di partenza per formare una unica sezione
+intitolata ``Storia''; allo stesso modo si unisca ogni sezione intitolata
+``Ringraziamenti'', e ogni sezione intitolata ``Dediche''. Si devono eliminare
+tutte le sezioni intitolate ``Approvazioni''.
+
address@hidden
+RACCOLTE DI DOCUMENTI
+
+Si address@hidden produrre una raccolta che consista del documento e di altri
+documenti rilasciati sotto questa licenza, e rimpiazzare le singole copie
+di questa licenza nei vari documenti con una sola inclusa nella raccolta,
+solamente se si seguono le regole fissate da questa licenza per le copie
+alla lettera come se si applicassero a ciascun documento.
+
+Si address@hidden estrarre un singolo documento da tale raccolta e distribuirlo
+separatamente sotto questa licenza, solo se si inserisce una copia di
+questa licenza nel documento estratto e se si seguono tutte le altre
+regole fissate da questa licenza per le copie alla lettera del documento.
+
address@hidden
+AGGREGAZIONE A LAVORI INDIPENDENTI
+
+Un'unione del documento o sue derivazioni con altri documenti o lavori
+separati o indipendenti, all'interno di, o a formare un, archivio o un
+supporto, per la memorizzazione o la distribuzione, viene chiamato un
+``aggregato'' se il copyright risultante dall'unione non viene usato per
+limitare i diritti legali degli utilizzatori oltre a address@hidden che viene
+permesso dai singoli lavori. Quando il documento viene incluso in un
+aggregato, questa licenza non si applica ad altri lavori nell'aggregato
+che non siano essi stessi dei lavori derivati dal documento.
+
+Se le esigenze del testo di copertina della sezione 3 sono applicabili a
+queste copie del documento allora, se il documento @`e inferiore alla
address@hidden
+dell'intero aggregato i testi di copertina del documento possono essere
+piazzati in copertine che delimitano il documento all'interno
+dell'aggregato, o dell'equivalente elettronico delle copertine se il
+documento @`e in un formato elettronico. Altrimenti devono apparire nella
+copertina dell'intero aggregato.
+
address@hidden
+TRADUZIONE
+
+La traduzione @`e considerata un tipo di modifica, di conseguenza si possono
+distribuire traduzioni del documento nei termini della sezione 4.
+Rimpiazzare sezioni non modificabili con traduzioni richiede un
+particolare permesso da parte dei detentori del copyright, ma @`e possibile
+includere la traduzione di parti o di tutte le sezioni non modificabili in
+aggiunta alle versioni originali di queste sezioni. @`E possibile includere
+una traduzione di questa licenza, di tutte le avvertenze del documento e
+di tutti i limiti di garanzia, a condizione che si includa anche la
+versione originale in inglese della licenza completa, comprese le
+avvertenze e limitazioni di garanzia. In caso di discordanza tra la
+traduzione e la versione originale inglese di questa licenza o avvertenza
+o limitazione di garanzia, prevale sempre la versione originale inglese.
+
+Se una sezione del documento viene titolata ``Riconoscimenti'', ``Dediche'', o
+``Storia'', il requisito (sezione 4) di preservare il titolo (sezione 1)
address@hidden tipicamente il cambiamento del titolo.
+
address@hidden
+CESSAZIONE DELLA LICENZA
+
+Non si address@hidden sublicenziare il documento, copiarlo, modificarlo, o
+distribuirlo al di fuori dei termini espressamente previsti da questa
+licenza. Ogni altro tentativo di applicare una licenza al documento,
+copiarlo, modificarlo, o distribuirlo @`e nullo e pone fine automaticamente
+ai diritti previsti da questa licenza.
+
+In ogni caso, se cessano tutte le violazioni di questa Licenza, allora la
+specifica licenza di un particolare detentore del copyright viene
+ripristinata (a) in via provvisoria, a meno che e fino a quando il
+detentore del copyright non faccia estinguere esplicitamente e
+definitivamente la licenza, e (b) in via permanente se il detentore del
+copyright non notifica in alcun modo la violazione entro 60 giorni dalla
+cessazione della licenza.
+
+Inoltre, la licenza di un dato detentore del copyright viene ripristinata
+in maniera permanente se quest'ultimo notifica la violazione in maniera
+adeguata, se si tratta della prima volta che si riceve una notifica di
+violazione della licenza (per qualsiasi opera) dallo stesso detentore di
+copyright, e se la violazione viene corretta entro 30 giorni dalla data di
+ricezione della notifica di violazione.
+
+La cessazione dei diritti come specificato in questa sezione non provoca
+la cessazione delle licenze di terze parti che abbiano ricevuto copie o
+diritti secondo questa licenza. Se i diritti sono cessati e non sono stati
+ristabiliti in via permanente, la ricezione di una copia dello stesso
+materiale, in tutto o in parte, non address@hidden alcun diritto ad
utilizzarlo.
+
address@hidden
+REVISIONI FUTURE DI QUESTA LICENZA
+
+La Free Software Foundation address@hidden occasionalmente pubblicare versioni
nuove
+o rivedute della Licenza per Documentazione Libera GNU. Le nuove versioni
+saranno simili nello spirito alla versione attuale ma potrebbero
+differirne in qualche dettaglio per affrontare nuovi problemi e concetti.
+Si veda @uref{http://www.gnu.org/copyleft/}.
+
+Ad ogni versione della licenza viene dato un numero che la distingue. Se
+il documento specifica che si riferisce ad una versione particolare della
+licenza ``o ogni versione successiva'', si ha la address@hidden di seguire
+termini e condizioni sia della versione specificata che di ogni versione
+successiva pubblicata (non come bozza) dalla Free Software Foundation. Se
+il documento non specifica un numero di versione particolare di questa
+licenza, si address@hidden scegliere ogni versione pubblicata (non come bozza)
dalla
+Free Software Foundation. Se il documento specifica che un delegato
address@hidden
+decidere quale futura versione di questa licenza address@hidden essere
utilizzata,
+allora la dichiarazione pubblica di accettazione della versione, da parte
+del delegato, autorizza in maniera permanente a scegliere tale versione
+per il documento.
+
address@hidden
+CAMBIO DI LICENZA
+
+Il termine ``sito per la collaborazione massiva multiautore'' (o ``sito
+MMC'')
+indica qualsiasi server web che pubblica opere sottoponibili a copyright e
+fornisce a chiunque appositi strumenti per modificare tali opere. Un wiki
+pubblico modificabile da chiunque @`e un esempio di server in questione. Una
+``collaborazione massiva multiautore'' (o ``MMC'') contenuta nel sito indica
+un qualunque insieme di opere sottoponibili a copyright pubblicate sul
+sito MMC.
+
+Il termine ``CC-BY-SA'' indica la licenza Creative Commons Attribution-Share
+Alike 3.0 pubblicata dalla Creative Commons Corporation, un'organizzazione
+senza fini di lucro con sede principale a San Francisco, California, come
+anche le future versioni di tale licenza pubblicate dalla stessa
+organizzazione.
+
+``Incorporare'' significa pubblicare o ripubblicare un documento in tutto o
+in parte, come parte di un altro documento.
+
+Una MMC @`e ``qualificata a cambiare questa licenza'' se ha adottato questa
+licenza e se tutte le opere precedentemente pubblicate con questa licenza
+altrove rispetto alla MMC e successivamente incorporate del tutto o in
+parte nella MMC (1) non hanno testo di copertina o sezioni invarianti e
+(2) sono state incorporate prima del 1° Novembre 2008.
+
+L'operatore di un sito MMC address@hidden ripubblicare un MMC contenuto nel
sito con
+una CC-BY-SA nello stesso sito in qualsiasi momento prima del 1° Agosto
+2009, da parte di una MMC qualificata a cambiare questa licenza.
+
address@hidden enumerate
+
address@hidden fakenode --- for prepinfo
address@hidden ADDENDUM: Come usare questa licenza per i vostri documenti
+
+Per applicare questa licenza ad un documento che si @`e scritto, si includa
+una copia della licenza nel documento e si inserisca la seguente nota di
+copyright appena dopo la pagina del titolo:
+
address@hidden
address@hidden
+ Copyright (C) @var{<anno>} @var{<il vostro nome>}
+ @`E permesso copiare, distribuire e/o modificare questo documento
+ seguendo i termini della ``Licenza per documentazione libera GNU'', versione
1.3
+ o ogni versione successiva pubblicata dalla Free Software Foundation;
+ senza sezioni non modificabili, senza testi di prima di copertina e di
quarta di copertina.
+ Una copia della licenza @`e inclusa nella sezione intitolata
+ ``Licenza per la documentazione libera GNU''.
address@hidden group
address@hidden smallexample
+
+Se ci sono sezioni non modificabili, testi di prima di copertina e di
+quarta di copertina, scrivere nella parte address@hidden di copertina'' il
testo seguente:
+
address@hidden
address@hidden
+ con le seguenti sezioni non modificabili @var{lista dei loro titoli},
+ con i seguenti testi di prima di copertina @var{elenco},
+ e con i seguenti testi di quarta di copertina @var{elenco},
address@hidden group
address@hidden smallexample
+
+Se esistono delle sezioni non modificabili ma non i testi di copertina, o
+qualche altra combinazione dei tre elementi sopra riportati, fondere
+assieme le due alternative in modo da conformarsi alla situazione descritta.
+
+Se il vostro documento contiene esempi non banali di programma in codice
+sorgente si raccomanda di rilasciare gli esempi contemporaneamente
+applicandovi anche una licenza di software libero di vostra scelta, come
+per esempio la Licenza Pubblica Generica GNU, al fine di permetterne l'uso
+come software libero.
+
address@hidden ifclear
+
address@hidden
address@hidden Indice analitico
address@hidden Indice analitico
address@hidden ifnotdocbook
address@hidden cp
+
address@hidden
+
+Unresolved Issues:
+------------------
+1. From ADR.
+
+ Robert J. Chassell points out that awk programs should have some indication
+ of how to use them. It would be useful to perhaps have a "programming
+ style" section of the manual that would include this and other tips.
+
+Consistency issues:
+ /.../ regexps are in @code, not @samp
+ ".." strings are in @code, not @samp
+ no @print before @dots
+ values of expressions in the text (@code{x} has the value 15),
+ should be in roman, not @code
+ Use TAB and not tab
+ Use ESC and not ESCAPE
+ Use space and not blank to describe the space bar's character
+ The term "blank" is thus basically reserved for "blank lines" etc.
+ To make dark corners work, the @value{DARKCORNER} has to be outside
+ closing `.' of a sentence and after (pxref{...}).
+ " " should have an @w{} around it
+ Use "non-" only with language names or acronyms, or the words bug and
option and null
+ Use @command{ftp} when talking about anonymous ftp
+ Use uppercase and lowercase, not "upper-case" and "lower-case"
+ or "upper case" and "lower case"
+ Use "single precision" and "double precision", not "single-precision"
or "double-precision"
+ Use alphanumeric, not alpha-numeric
+ Use POSIX-compliant, not POSIX compliant
+ Use --foo, not -Wfoo when describing long options
+ Use "Bell Laboratories", but not "Bell Labs".
+ Use "behavior" instead of "behaviour".
+ Use "coprocess" instead of "co-process".
+ Use "zeros" instead of "zeroes".
+ Use "nonzero" not "non-zero".
+ Use "runtime" not "run time" or "run-time".
+ Use "command-line" as an adjective and "command line" as a noun.
+ Use "online" not "on-line".
+ Use "whitespace" not "white space".
+ Use "Input/Output", not "input/output". Also "I/O", not "i/o".
+ Use "lefthand"/"righthand", not "left-hand"/"right-hand".
+ Use "workaround", not "work-around".
+ Use "startup"/"cleanup", not "start-up"/"clean-up"
+ Use "filesystem", not "file system"
+ Use @code{do}, and not @address@hidden, except where
+ actually discussing the do-while.
+ Use "versus" in text and "vs." in index entries
+ Use @code{"C"} for the C locale, not ``C'' or @samp{C}.
+ The words "a", "and", "as", "between", "for", "from", "in", "of",
+ "on", "that", "the", "to", "with", and "without",
+ should not be capitalized in @chapter, @section etc.
+ "Into" and "How" should.
+ Search for @dfn; make sure important items are also indexed.
+ "e.g." should always be followed by a comma.
+ "i.e." should always be followed by a comma.
+ The numbers zero through ten should be spelled out, except when
+ talking about file descriptor numbers. > 10 and < 0, it's
+ ok to use numbers.
+ For most cases, do NOT put a comma before "and", "or" or "but".
+ But exercise taste with this rule.
+ Don't show the awk command with a program in quotes when it's
+ just the program. I.e.
+
+ {
+ ....
+ }
+
+ not
+ awk '{
+ ...
+ }'
+
+ Do show it when showing command-line arguments, data files, etc, even
+ if there is no output shown.
+
+ Use numbered lists only to show a sequential series of steps.
+
+ Use @code{xxx} for the xxx operator in indexing statements, not @samp.
+ Use MS-Windows not MS Windows
+ Use MS-DOS not MS DOS
+ Use an empty set of parentheses after built-in and awk function names.
+ Use "multiFOO" without a hyphen.
+ Use "time zone" as two words, not "timezone".
+
+Date: Wed, 13 Apr 94 15:20:52 -0400
+From: address@hidden (Richard Stallman)
+To: address@hidden
+Subject: A reminder: no pathnames in GNU
+
+It's a GNU convention to use the term "file name" for the name of a
+file, never "pathname". We use the term "path" for search paths,
+which are lists of file names. Using it for a single file name as
+well is potentially confusing to users.
+
+So please check any documentation you maintain, if you think you might
+have used "pathname".
+
+Note that "file name" should be two words when it appears as ordinary
+text. It's ok as one word when it's a metasyntactic variable, though.
+
+------------------------
+ORA uses filename, thus the macro.
+
+Suggestions:
+------------
+
+Better sidebars can almost sort of be done with:
+
+ @ifdocbook
+ @macro @sidebar{title, content}
+ @inlinefmt{docbook, <sidebar><title>}
+ \title\
+ @inlinefmt{docbook, </title>}
+ \content\
+ @inlinefmt{docbook, </sidebar>}
+ @end macro
+ @end ifdocbook
+
+
+ @ifnotdocbook
+ @macro @sidebar{title, content}
+ @cartouche
+ @center @b{\title\}
+
+ \content\
+ @end cartouche
+ @end macro
+ @end ifnotdocbook
+
+But to use it you have to say
+
+ @sidebar{Title Here,
+ @include file-with-content
+ }
+
+which sorta sucks.
+
+TODO:
+Check that all dark corners are indexed properly.
+
diff --git a/doc/it/lflashlight-small.xpic b/doc/it/lflashlight-small.xpic
new file mode 100755
index 0000000..94ae774
--- /dev/null
+++ b/doc/it/lflashlight-small.xpic
@@ -0,0 +1,20 @@
+#! /usr/X11R6/bin/xpic
+80 48 160 80 8
+1 75 144 48 160 56 0 0
+2
+ 160 48 144 56
+1 76 112 48 136 56 0 0
+2
+ 112 56 136 48
+1 77 112 72 136 80 0 0
+2
+ 112 72 136 80
+5 78 128 48 144 80 0 0
+136 64 8 16
+3 79 80 56 112 72 0 0
+1 80 144 64 160 64 0 0
+2
+ 144 64 160 64
+1 81 144 72 160 80 0 0
+2
+ 144 72 160 80
diff --git a/doc/it/lflashlight.eps b/doc/it/lflashlight.eps
new file mode 100755
index 0000000..fdb8cf3
--- /dev/null
+++ b/doc/it/lflashlight.eps
@@ -0,0 +1,135 @@
+%!
+%%Creator: address@hidden (Aharon Robbins)
+%%Title: rflashlight.small.xpic (xpic)
+%%CreationDate: Tue Dec 12 09:51:27 2000
+%%Pages: 1
+%%BoundingBox: 0 0 72 28.8
+% (in inches) at 0 0, width 1, height 0.4
+%%EndComments
+% Prolog for xpic to PostScript converter
+% Author: Mark Moraes
+% $Header: x2ps.pro,v 1.2 88/03/19 16:50:09 moraes Exp
+% %d D - change style SOLID, DOTTED, SHORT-DASH, LONG-DASH, DOT-DASH
+% %s F - change font to fontname
+% %d S - change size (font size in points)
+% (%s) rj %d t - text right just. (%d is TOPLINE, MIDLINE, BOTLINE)
+% (%s) lj %d t - text left just. (%d is TOPLINE, MIDLINE, BOTLINE)
+% (%s) ce %d t - text centered (%d is TOPLINE, MIDLINE, BOTLINE)
+% %d %d l - lineto
+% %d %d m - moveto
+% %d %d s - spline segment
+% x - flush line, spline
+% <wid> <ht> <x> <y> b - box
+% <wid> <ht> <x> <y> e - ellipse
+% %d ss - setscale
+% %d W - change linewidth
+% getpagesize - gets the values of PAGEHEIGHT and PAGEWIDTH
+% %d %d flip - translate by %d, PAGEHEIGHT - %d (this
+% transforms to X windows coordinates)
+save 50 dict begin /xpic exch def
+/StartXpic {newpath 0 0 moveto [] 0 setdash 0 setgray 1 setlinecap} def
+% Set defaults
+/fontname /Times-Roman def
+/ptsize 12 def
+% halign has the values for MIDLINE, TOPLINE, BOTLINE
+/halign 3 array def
+/s {rcurveto} def
+/x {stroke} def
+/l {lineto} def
+/m {moveto} def
+/b {
+ /ury exch def /urx exch def /lly exch def /llx exch def
+ llx lly moveto urx lly lineto urx ury lineto
+ llx ury lineto llx lly lineto stroke
+} def
+/mtrx matrix def
+/e {
+ /yc exch def /xc exch def /yrad exch def /xrad exch def
+ xc xrad add yc moveto
+ /savematrix mtrx currentmatrix def
+ xc yc translate
+ xrad yrad scale
+ 0 0 1 0 360 arc
+ savematrix setmatrix stroke
+} def
+% The next three take the text string, and moveto the right horiz. position
+% leaving the string on the stack.
+/lj {} def
+/rj {dup stringwidth pop neg 0 rmoveto} def
+/ce {dup stringwidth pop 2 div neg 0 rmoveto} def
+% And this is invoked after one of the three above, and
+% computes the vert. pos, and then displays the string.
+/t {halign exch get 0 exch rmoveto show newpath} def
+% Store an array of patterns in /styles - a pattern is an array consisting
+% of an array and an offset. Corresp to xpic patterns
+% solid, dotted, short-dashed, long-dashed, dot-dashed
+/styles [ [] 0 ] [ [1 3] 0 ] [ [4 4] 0 ] [ [8 4] 0 ] [ [1 4 4 4] 0 ]
+ 5 array astore def
+% change style to arg.
+/D {stroke styles exch get aload pop setdash newpath} def
+/W {stroke 0.5 mul setlinewidth newpath} def
+% fontbox takes a fontname off the stack, and returns an array
+% containing the values of the bottom line of the bounding box, the
+% mid line of the bounding box, and the top line of the bounding box
+% of that font, taken from the baseline, scaled to a font of size 1
+/fontbox {
+ findfont dup /FontMatrix get /fm exch def /FontBBox get aload pop
+ /ytop exch def pop /ybot exch def pop
+ /ymid ytop ybot sub 2 div def
+ 0 ybot fm dtransform exch pop % botline
+ dup neg exch % midline - this works better than (ytop-ybot)/2!
+ 0 ytop fm dtransform exch pop exch %topline
+ % now in the order midline, topline, botline.
+ 3 array astore
+} def
+% select font
+/F {
+ dup /fontname exch def fontbox
+ /thisfontbox exch def SF
+} def
+% set point size
+/S {/ptsize exch def SF} def
+% actually set font
+/SF {
+ fontname findfont ptsize curscale div scalefont setfont
+ thisfontbox aload pop
+ 1 1 3 {
+ pop ptsize mul curscale div neg 3 1 roll
+ } for
+ halign astore pop
+} def
+% sets the scale to 72 / n, where n is on the stack, and stores the value
+% in curscale for font scaling
+/curscale 1 def
+/getpagesize{newpath clippath pathbbox /pageheight exch def
+ /pagewidth exch def pop pop newpath} def
+/flip{pageheight exch sub translate} def
+/ss {/curscale exch 72 exch div dup dup scale def} def
+/land {90 rotate} def
+StartXpic
+%%EndProlog
+80 ss
+0.5 W
+0 D
+80 32 m
+64 24 l
+x
+32 24 m
+56 32 l
+x
+32 8 m
+56 0 l
+x
+8 16 56 16 e
+0 24 32 8 b
+64 16 m
+80 16 l
+x
+64 8 m
+80 0 l
+x
+%%Trailer
+showpage
+% Trailer for xpic to PostScript converter
+% $Header: x2ps.tra,v 1.2 89/07/02 15:59:53 moraes Exp $
+xpic end restore
diff --git a/doc/it/lflashlight.pdf b/doc/it/lflashlight.pdf
new file mode 100755
index 0000000..4432fdd
--- /dev/null
+++ b/doc/it/lflashlight.pdf
@@ -0,0 +1,56 @@
+%PDF-1.3
+%Çì¢
+6 0 obj
+<</Length 7 0 R/Filter /FlateDecode>>
+stream
+xUA! E÷=EO¥¯ànôÄÅèÂëÛ51P ¿ß)D$[ól; pº
+>ÞÀ3~ âE÷*ò²à¹äXp±Z)IwZyBêÈ¢Èl·jFBæ3fI¡aáV
¤HàTúMÿÔV*´RÔÈèjÂñowU¢¹Î4ÍEÔì
¼îImätÐ>Á1Òªë O>endstream
+endobj
+7 0 obj
+168
+endobj
+5 0 obj
+<</Type/Page/MediaBox [0 0 72 28.8]
+/Rotate 0/Parent 3 0 R
+/Resources<</ProcSet[/PDF]
+/ExtGState 8 0 R
+>>
+/Contents 6 0 R
+>>
+endobj
+3 0 obj
+<< /Type /Pages /Kids [
+5 0 R
+] /Count 1
+>>
+endobj
+1 0 obj
+<</Type /Catalog /Pages 3 0 R
+>>
+endobj
+4 0 obj
+<</Type/ExtGState/Name/R4/TR/Identity/OPM 1/SM 0.02>>
+endobj
+8 0 obj
+<</R4
+4 0 R>>
+endobj
+2 0 obj
+<</Producer(GNU Ghostscript 7.07)>>endobj
+xref
+0 9
+0000000000 65535 f
+0000000471 00000 n
+0000000617 00000 n
+0000000412 00000 n
+0000000519 00000 n
+0000000272 00000 n
+0000000015 00000 n
+0000000253 00000 n
+0000000588 00000 n
+trailer
+<< /Size 9 /Root 1 0 R /Info 2 0 R
+>>
+startxref
+667
+%%EOF
diff --git a/doc/it/margini.texi b/doc/it/margini.texi
new file mode 100755
index 0000000..67b2519
--- /dev/null
+++ b/doc/it/margini.texi
@@ -0,0 +1,7 @@
address@hidden
+\global\bindingoffset = 4.6mm
address@hidden tex
+
address@hidden \global\topskip = 0mm
address@hidden \global\baselineskip = 0mm
address@hidden \global\parskip = 0mm
diff --git a/doc/it/programma-generico.eps b/doc/it/programma-generico.eps
new file mode 100755
index 0000000..db87944
--- /dev/null
+++ b/doc/it/programma-generico.eps
@@ -0,0 +1,228 @@
+%!PS-Adobe-3.0 EPSF-3.0
+%%Creator: cairo 1.12.8 (http://cairographics.org)
+%%CreationDate: Wed Dec 17 19:11:08 2014
+%%Pages: 1
+%%DocumentData: Clean7Bit
+%%LanguageLevel: 2
+%%BoundingBox: 0 -1 265 57
+%%EndComments
+%%BeginProlog
+save
+50 dict begin
+/q { gsave } bind def
+/Q { grestore } bind def
+/cm { 6 array astore concat } bind def
+/w { setlinewidth } bind def
+/J { setlinecap } bind def
+/j { setlinejoin } bind def
+/M { setmiterlimit } bind def
+/d { setdash } bind def
+/m { moveto } bind def
+/l { lineto } bind def
+/c { curveto } bind def
+/h { closepath } bind def
+/re { exch dup neg 3 1 roll 5 3 roll moveto 0 rlineto
+ 0 exch rlineto 0 rlineto closepath } bind def
+/S { stroke } bind def
+/f { fill } bind def
+/f* { eofill } bind def
+/n { newpath } bind def
+/W { clip } bind def
+/W* { eoclip } bind def
+/BT { } bind def
+/ET { } bind def
+/pdfmark where { pop globaldict /?pdfmark /exec load put }
+ { globaldict begin /?pdfmark /pop load def /pdfmark
+ /cleartomark load def end } ifelse
+/BDC { mark 3 1 roll /BDC pdfmark } bind def
+/EMC { mark /EMC pdfmark } bind def
+/cairo_store_point { /cairo_point_y exch def /cairo_point_x exch def } def
+/Tj { show currentpoint cairo_store_point } bind def
+/TJ {
+ {
+ dup
+ type /stringtype eq
+ { show } { -0.001 mul 0 cairo_font_matrix dtransform rmoveto } ifelse
+ } forall
+ currentpoint cairo_store_point
+} bind def
+/cairo_selectfont { cairo_font_matrix aload pop pop pop 0 0 6 array astore
+ cairo_font exch selectfont cairo_point_x cairo_point_y moveto } bind def
+/Tf { pop /cairo_font exch def /cairo_font_matrix where
+ { pop cairo_selectfont } if } bind def
+/Td { matrix translate cairo_font_matrix matrix concatmatrix dup
+ /cairo_font_matrix exch def dup 4 get exch 5 get cairo_store_point
+ /cairo_font where { pop cairo_selectfont } if } bind def
+/Tm { 2 copy 8 2 roll 6 array astore /cairo_font_matrix exch def
+ cairo_store_point /cairo_font where { pop cairo_selectfont } if } bind
def
+/g { setgray } bind def
+/rg { setrgbcolor } bind def
+/d1 { setcachedevice } bind def
+%%EndProlog
+11 dict begin
+/FontType 42 def
+/FontName /DroidSansFallback def
+/PaintType 0 def
+/FontMatrix [ 1 0 0 1 0 0 ] def
+/FontBBox [ 0 0 0 0 ] def
+/Encoding 256 array def
+0 1 255 { Encoding exch /.notdef put } for
+Encoding 68 /D put
+Encoding 80 /P put
+Encoding 82 /R put
+Encoding 97 /a put
+Encoding 103 /g put
+Encoding 105 /i put
+Encoding 108 /l put
+Encoding 109 /m put
+Encoding 111 /o put
+Encoding 114 /r put
+Encoding 115 /s put
+Encoding 116 /t put
+Encoding 117 /u put
+/CharStrings 14 dict dup begin
+/.notdef 0 def
+/D 1 def
+/a 2 def
+/t 3 def
+/i 4 def
+/P 5 def
+/r 6 def
+/o 7 def
+/g 8 def
+/m 9 def
+/R 10 def
+/s 11 def
+/u 12 def
+/l 13 def
+end readonly def
+/sfnts [
+<000100000009008000030010637674200000000000000498000000026670676db02159b00000
+049c00000007676c7966cf60e9770000009c000003fc68656164eb09793d000004a400000036
+68686561021600ec000004dc00000024686d747807ac012f00000500000000386c6f63610000
+1d50000005380000003c6d617870006802310000057400000020707265708014882900000594
+000000120002004b000000b500b700030007000037331523373335234b6a6a0d4f4fb7b70d9d
+000000020019000000a000b70008001100003335333216151406232715333236353426231933
+272d2f2a171422211f1fb72f2b2d30a38f242424230000000002000cfffe0074008c00170022
+0000332723062322263534373735342623220727363332161515270706061514163332363563
+04010f1b13153a170d0e11130816161a18171217110b0b1113131515132a0201080f0f0a110c
+16185e4301010e0d0b0b1413000000010004fffe005200a90015000037150623222635352335
+37373315331523151416333252090d12121414090d232309080a13110415164f0a0a1d20114f
+0d0c000200140000002f00bd000b000f0000371406232226353436333216072335332f070706
+0707060707021717ae07070707080707b6890000000200190000008600b7000a001300003715
+23353332161514062327333236353426232330172d20202221131019151515144747b71b1b1b
+1f141213111200000001001600000061008c000f000037072623220615152335331733363332
+610308060f14171203011015098b150118154a89191c0002000efffe0086008c000b00170000
+3734363332161514062322263734262322061514163332360e211b1a22211b1b216012121212
+121212124522252621232425221a1a1a1a1a1b1b000000030005ffc30080008c00250031003e
+0000371507161514062322270615141633333216151406232226353437263534372635343633
+321717342623220615141633323607232206151416333236353426801908191608020b090a16
+151522221b1a1e0c10181a170b07070d0d0d0c0d0d0c0d0e160d0e101017170b890e030b1014
+1801070a05051312181713131a08050e0e0a0a1c1719032b0e0f0f0f0e0e0e4d0c0c0b0b0e0e
+0a08000000010016000000d1008c002100003335342623220615152335342623220615152335
+3317333633321733363332161515ba0d0c1111170d0d1011171204010c1a1e09010d1d161658
+111017164c581110161c47891215171719195a00000200190000009400b7000c001500003715
+233533321615140717232727333236353426232330172c212024321b2c1d1515141317144c4c
+b71a1a240d524c13121111100001000bfffe0068008c001f000037351633323635342e023534
+36333217072623220615141e0215140623220b16130f0f0b2d0d1917151408140e0c0d0a2e0d
+1a1a1a06150b0a0a080915110c11140a12090808080914120c13150000010015fffe00810089
+0013000033272306232226353533151416333236353533156f04010c1b1717160e0d12121712
+14191959581011171b478900000100160000002d00c300030000332335332d1717c300000000
+0000b0002cb000212d000001000000024f5c133ce3d25f0f3cf5000b010000000000c3477867
+00000000c79972b4ffe9ffbc011f010b00000009000200010000000000010000010bffbc0000
+012bffe9fff6011f00010000000000000000000000000000000e0100004b00af00190088000c
+005700040042001400940019006600160094000e0085000500e50016009700190074000b0097
+001500420016000000000000002400000060000000c8000001080000014000000180000001b4
+00000200000002ac000003080000034c000003a8000003e4000003fc00010000000e00e80027
+0105001800020010002f0001000000040012000500014bb0c8514bb007535a58b9000101ff85
+8d59000000>
+] def
+/f-0-0 currentdict end definefont pop
+%%Page: 1 1
+%%BeginPageSetup
+%%PageBoundingBox: 0 -1 265 57
+%%EndPageSetup
+q 0 -1 265 58 rectclip q
+0 g
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 114.254 56.309 m 98.195 28.215 l 114.508 0.246 l 146.82 0.434 l 162.883
+ 28.527 l 146.57 56.496 l 114.254 56.309 l S
+Q q
+26 56.719 170 -57 re W n
+26.316 83.094 m 26.316 -25.965 l 195.043 -25.965 l 195.043 83.094 l 26.316
+ 83.094 l 83.664 24.711 m 89.629 24.711 l 89.629 31.816 l 83.664 31.816
+l 88.406 28.266 l 83.664 24.711 l W n
+q
+26 56.719 170 -57 re W n
+[ 1 0 0 1 0 -0.28125 ] concat
+ q
+0 g
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 65.922 28.547 m 89.035 28.547 l S
+ Q
+Q
+Q q
+0 g
+87.988 26.449 m 95.547 28.34 l 87.988 30.23 l 87.988 26.449 l f*
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 88.047 26.359 m 93.973 28.25 l 88.047 30.141 l 88.047 26.359 l S
+Q q
+0 56.719 265 -57 re W n
+-3.438 57.5 m -3.438 -0.5 l 265.562 -0.5 l 265.562 57.5 l -3.438 57.5 l
+ 190.031 26.449 m 199.543 26.449 l 199.543 30.23 l 190.031 30.23 l 197.59
+ 28.34 l 190.031 26.449 l W n
+q
+0 56.719 265 -57 re W n
+[ 1 0 0 1 0 -0.28125 ] concat
+ q
+0 g
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 167.418 28.621 m 198.598 28.621 l S
+ Q
+Q
+Q q
+0 g
+190.031 26.449 m 197.59 28.34 l 190.031 30.23 l 190.031 26.449 l f*
+0.4724 w
+0 J
+0 j
+[] 0.0 d
+10 M 190.031 26.449 m 197.59 28.34 l 190.031 30.23 l 190.031 26.449 l S
+205.215 48.18 m 202.605 48.18 200.488 46.066 200.488 43.457 c 200.488 13.285
+ l 200.488 10.676 202.605 8.562 205.215 8.562 c 259.953 8.562 l 262.559
+8.562 264.676 10.676 264.676 13.285 c 264.676 43.457 l 264.676 46.066 262.559
+ 48.18 259.953 48.18 c 205.215 48.18 l S
+BT
+10 0 0 10 21.9375 24.9167 Tm
+/f-0-0 1 Tf
+[(D)-4(a)31(t)28(i)]TJ
+8.1875 -0.05 Td
+[(P)16(r)23(o)16(g)19(r)24(a)31(m)19(m)20(a)]TJ
+11.2375 0.1 Td
+[(R)27(i)8(s)16(u)27(l)8(t)27(a)32(t)27(i)]TJ
+ET
+205.215 48.18 m 202.605 48.18 200.488 46.066 200.488 43.457 c 200.488 13.285
+ l 200.488 10.676 202.605 8.562 205.215 8.562 c 259.953 8.562 l 262.559
+8.562 264.676 10.676 264.676 13.285 c 264.676 43.457 l 264.676 46.066 262.559
+ 48.18 259.953 48.18 c 205.215 48.18 l S
+4.965 47.805 m 2.355 47.805 0.238 45.691 0.238 43.082 c 0.238 12.91 l 0.238
+ 10.301 2.355 8.188 4.965 8.188 c 59.703 8.188 l 62.309 8.188 64.426 10.301
+ 64.426 12.91 c 64.426 43.082 l 64.426 45.691 62.309 47.805 59.703 47.805
+ c 4.965 47.805 l S
+Q Q
+showpage
+%%Trailer
+end restore
+%%EOF
diff --git a/doc/it/programma-generico.fig b/doc/it/programma-generico.fig
new file mode 100755
index 0000000..e87f6e3
--- /dev/null
+++ b/doc/it/programma-generico.fig
@@ -0,0 +1,25 @@
+#FIG 3.2 Produced by xfig version 3.2.5c
+Landscape
+Center
+Metric
+A4
+100.00
+Single
+-2
+1200 2
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 5805 3465 6300 3465
+2 4 0 1 0 7 50 -1 -1 0.000 0 0 4 0 0 5
+ 4052 3779 4052 3195 3105 3195 3105 3779 4052 3779
+2 4 0 1 0 7 50 -1 -1 0.000 0 0 7 0 0 5
+ 7695 3825 7695 3195 6300 3195 6300 3825 7695 3825
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+ 1 1 1.00 60.00 120.00
+ 4095 3465 4680 3465
+2 3 0 1 0 7 50 -1 -1 0.000 0 0 0 0 0 7
+ 5490 3915 5745 3456 5475 3006 4950 3015 4695 3474 4965 3924
+ 5490 3915
+4 0 0 50 -1 0 12 0.0000 4 135 360 3375 3510 Dati\001
+4 0 0 50 -1 0 12 0.0000 4 165 810 4860 3510 Programma\001
+4 0 0 50 -1 0 12 0.0000 4 135 810 6525 3510 Risultati\001
diff --git a/doc/it/programma-generico.pdf b/doc/it/programma-generico.pdf
new file mode 100755
index 0000000..d5c751a
Binary files /dev/null and b/doc/it/programma-generico.pdf differ
diff --git a/doc/it/programma-generico.png b/doc/it/programma-generico.png
new file mode 100755
index 0000000..1a87790
Binary files /dev/null and b/doc/it/programma-generico.png differ
diff --git a/doc/it/programma-generico.txt b/doc/it/programma-generico.txt
new file mode 100755
index 0000000..1f6e512
--- /dev/null
+++ b/doc/it/programma-generico.txt
@@ -0,0 +1,4 @@
+ _________
++------+ / \ +-----------+
+| Dati | -----> < Programma > -----> | Risultati |
++------+ \_________/ +-----------+
diff --git a/doc/it/rflashlight-small.xpic b/doc/it/rflashlight-small.xpic
new file mode 100755
index 0000000..9e78a3f
--- /dev/null
+++ b/doc/it/rflashlight-small.xpic
@@ -0,0 +1,26 @@
+#! /usr/X11R6/bin/xpic
+80 48 160 80 8
+5 36 96 48 112 80 0 0
+104 64 8 16
+1 37 104 48 128 56 0 0
+2
+ 104 48 128 56
+1 38 104 72 128 80 0 0
+2
+ 104 80 128 72
+2 39 128 56 128 72 0 0
+2
+ 128 56 128 72
+3 40 128 56 160 72 0 0
+1 41 80 72 80 72 0 0
+2
+ 80 72 80 72
+1 42 80 72 96 80 0 0
+2
+ 80 80 96 72
+1 43 80 64 96 64 0 0
+2
+ 80 64 96 64
+1 45 80 48 96 56 0 0
+2
+ 96 56 80 48
diff --git a/doc/it/rflashlight.eps b/doc/it/rflashlight.eps
new file mode 100755
index 0000000..28cb7e2
--- /dev/null
+++ b/doc/it/rflashlight.eps
@@ -0,0 +1,141 @@
+%!
+%%Creator: address@hidden (Aharon Robbins)
+%%Title: flashlight.small.xpic (xpic)
+%%CreationDate: Tue Oct 24 14:41:28 2000
+%%Pages: 1
+%%BoundingBox: 0 0 72 28.8
+% (in inches) at 0 0, width 1, height 0.4
+%%EndComments
+% Prolog for xpic to PostScript converter
+% Author: Mark Moraes
+% $Header: x2ps.pro,v 1.2 88/03/19 16:50:09 moraes Exp
+% %d D - change style SOLID, DOTTED, SHORT-DASH, LONG-DASH, DOT-DASH
+% %s F - change font to fontname
+% %d S - change size (font size in points)
+% (%s) rj %d t - text right just. (%d is TOPLINE, MIDLINE, BOTLINE)
+% (%s) lj %d t - text left just. (%d is TOPLINE, MIDLINE, BOTLINE)
+% (%s) ce %d t - text centered (%d is TOPLINE, MIDLINE, BOTLINE)
+% %d %d l - lineto
+% %d %d m - moveto
+% %d %d s - spline segment
+% x - flush line, spline
+% <wid> <ht> <x> <y> b - box
+% <wid> <ht> <x> <y> e - ellipse
+% %d ss - setscale
+% %d W - change linewidth
+% getpagesize - gets the values of PAGEHEIGHT and PAGEWIDTH
+% %d %d flip - translate by %d, PAGEHEIGHT - %d (this
+% transforms to X windows coordinates)
+save 50 dict begin /xpic exch def
+/StartXpic {newpath 0 0 moveto [] 0 setdash 0 setgray 1 setlinecap} def
+% Set defaults
+/fontname /Times-Roman def
+/ptsize 12 def
+% halign has the values for MIDLINE, TOPLINE, BOTLINE
+/halign 3 array def
+/s {rcurveto} def
+/x {stroke} def
+/l {lineto} def
+/m {moveto} def
+/b {
+ /ury exch def /urx exch def /lly exch def /llx exch def
+ llx lly moveto urx lly lineto urx ury lineto
+ llx ury lineto llx lly lineto stroke
+} def
+/mtrx matrix def
+/e {
+ /yc exch def /xc exch def /yrad exch def /xrad exch def
+ xc xrad add yc moveto
+ /savematrix mtrx currentmatrix def
+ xc yc translate
+ xrad yrad scale
+ 0 0 1 0 360 arc
+ savematrix setmatrix stroke
+} def
+% The next three take the text string, and moveto the right horiz. position
+% leaving the string on the stack.
+/lj {} def
+/rj {dup stringwidth pop neg 0 rmoveto} def
+/ce {dup stringwidth pop 2 div neg 0 rmoveto} def
+% And this is invoked after one of the three above, and
+% computes the vert. pos, and then displays the string.
+/t {halign exch get 0 exch rmoveto show newpath} def
+% Store an array of patterns in /styles - a pattern is an array consisting
+% of an array and an offset. Corresp to xpic patterns
+% solid, dotted, short-dashed, long-dashed, dot-dashed
+/styles [ [] 0 ] [ [1 3] 0 ] [ [4 4] 0 ] [ [8 4] 0 ] [ [1 4 4 4] 0 ]
+ 5 array astore def
+% change style to arg.
+/D {stroke styles exch get aload pop setdash newpath} def
+/W {stroke 0.5 mul setlinewidth newpath} def
+% fontbox takes a fontname off the stack, and returns an array
+% containing the values of the bottom line of the bounding box, the
+% mid line of the bounding box, and the top line of the bounding box
+% of that font, taken from the baseline, scaled to a font of size 1
+/fontbox {
+ findfont dup /FontMatrix get /fm exch def /FontBBox get aload pop
+ /ytop exch def pop /ybot exch def pop
+ /ymid ytop ybot sub 2 div def
+ 0 ybot fm dtransform exch pop % botline
+ dup neg exch % midline - this works better than (ytop-ybot)/2!
+ 0 ytop fm dtransform exch pop exch %topline
+ % now in the order midline, topline, botline.
+ 3 array astore
+} def
+% select font
+/F {
+ dup /fontname exch def fontbox
+ /thisfontbox exch def SF
+} def
+% set point size
+/S {/ptsize exch def SF} def
+% actually set font
+/SF {
+ fontname findfont ptsize curscale div scalefont setfont
+ thisfontbox aload pop
+ 1 1 3 {
+ pop ptsize mul curscale div neg 3 1 roll
+ } for
+ halign astore pop
+} def
+% sets the scale to 72 / n, where n is on the stack, and stores the value
+% in curscale for font scaling
+/curscale 1 def
+/getpagesize{newpath clippath pathbbox /pageheight exch def
+ /pagewidth exch def pop pop newpath} def
+/flip{pageheight exch sub translate} def
+/ss {/curscale exch 72 exch div dup dup scale def} def
+/land {90 rotate} def
+StartXpic
+%%EndProlog
+80 ss
+0.5 W
+0 D
+8 16 24 16 e
+24 32 m
+48 24 l
+x
+24 0 m
+48 8 l
+x
+48 24 m
+0 0 0 -5.33333 0 -16 s
+x
+48 24 80 8 b
+0 8 m
+0 8 l
+x
+0 0 m
+16 8 l
+x
+0 16 m
+16 16 l
+x
+16 24 m
+0 32 l
+x
+%%Trailer
+showpage
+% Trailer for xpic to PostScript converter
+% $Header: x2ps.tra,v 1.2 89/07/02 15:59:53 moraes Exp $
+xpic end restore
diff --git a/doc/it/rflashlight.pdf b/doc/it/rflashlight.pdf
new file mode 100755
index 0000000..72c8561
--- /dev/null
+++ b/doc/it/rflashlight.pdf
@@ -0,0 +1,57 @@
+%PDF-1.3
+%Çì¢
+6 0 obj
+<</Length 7 0 R/Filter /FlateDecode>>
+stream
+xEQÃ ß9'pBQ»+ìÛeYR º%Ûõ'(]
ð£îaÔ5üZaÓUðñð fOàyFÁzDEÌSH|FN),h²ù¨äÀS?iWk¬Ö*Ú%H!F¯¦Ð®®MÁë\m
ø¬
+2±õmÆÁ
+òtg ÉÏH¿ðëÞXTR»Ûì¬>@ÿ2{¤MéWV¶´õó'Eendstream
+endobj
+7 0 obj
+175
+endobj
+5 0 obj
+<</Type/Page/MediaBox [0 0 72 28.8]
+/Rotate 0/Parent 3 0 R
+/Resources<</ProcSet[/PDF]
+/ExtGState 8 0 R
+>>
+/Contents 6 0 R
+>>
+endobj
+3 0 obj
+<< /Type /Pages /Kids [
+5 0 R
+] /Count 1
+>>
+endobj
+1 0 obj
+<</Type /Catalog /Pages 3 0 R
+>>
+endobj
+4 0 obj
+<</Type/ExtGState/Name/R4/TR/Identity/OPM 1/SM 0.02>>
+endobj
+8 0 obj
+<</R4
+4 0 R>>
+endobj
+2 0 obj
+<</Producer(GNU Ghostscript 7.07)>>endobj
+xref
+0 9
+0000000000 65535 f
+0000000478 00000 n
+0000000624 00000 n
+0000000419 00000 n
+0000000526 00000 n
+0000000279 00000 n
+0000000015 00000 n
+0000000260 00000 n
+0000000595 00000 n
+trailer
+<< /Size 9 /Root 1 0 R /Info 2 0 R
+>>
+startxref
+674
+%%EOF
diff --git a/doc/it/sidebar.awk b/doc/it/sidebar.awk
new file mode 100755
index 0000000..d1f3efc
--- /dev/null
+++ b/doc/it/sidebar.awk
@@ -0,0 +1,67 @@
+# sidebar.awk --- add support for sidebars, other stuff to gawk.texi
+
+# Copyright (C) 2013, 2016 the Free Software Foundation, Inc.
+#
+# This file is part of GAWK, the GNU implementation of the
+# AWK Programming Language.
+#
+# GAWK is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# GAWK is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
USA
+
+BEGIN {
+ print "% ****************************************************"
+ print "% * DO NOT MODIFY THIS FILE!!!! *"
+ print "% * It was generated from gawktexi.in by sidebar.awk *"
+ print "% * Edit gawktexi.in instead. *"
+ print "% ****************************************************"
+}
+
+/address@hidden/ {
+ sub(/address@hidden \t]+/, "", $0)
+ title = $0
+ body = ""
+ collecting = 1
+ next
+}
+
+/address@hidden \t]+sidebar[ \t]*$/ {
+ collecting = 0
+ printf "@cindex sidebar, %s\n", title
+ printf "@ifdocbook\n"
+ printf "@docbook\n"
+ printf "<sidebar><title>%s</title>\n", title
+ printf "@end docbook\n"
+ print body
+ print ""
+ printf "@docbook\n"
+ printf "</sidebar>\n"
+ printf "@end docbook\n"
+ printf "@end ifdocbook\n\n"
+
+ printf "@ifnotdocbook\n"
+ printf "@cartouche\n"
+ printf "@center @b{%s}\n\n", title
+ print body
+ printf "@end cartouche\n"
+ printf "@end ifnotdocbook\n"
+ body = ""
+ next
+}
+
+collecting == 1 {
+ body = body RS $0
+ next
+}
+
+{ print }
diff --git a/doc/it/texinfo.tex b/doc/it/texinfo.tex
new file mode 100755
index 0000000..2a4cdd6
--- /dev/null
+++ b/doc/it/texinfo.tex
@@ -0,0 +1,11231 @@
+% texinfo.tex -- TeX macros to handle Texinfo files.
+%
+% Load plain if necessary, i.e., if running under initex.
+\expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi
+%
+\def\texinfoversion{2016-02-05.07}
+%
+% Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
+% 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+% 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016
+% Free Software Foundation, Inc.
+%
+% This texinfo.tex file is free software: you can redistribute it and/or
+% modify it under the terms of the GNU General Public License as
+% published by the Free Software Foundation, either version 3 of the
+% License, or (at your option) any later version.
+%
+% This texinfo.tex file is distributed in the hope that it will be
+% useful, but WITHOUT ANY WARRANTY; without even the implied warranty
+% of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+% General Public License for more details.
+%
+% You should have received a copy of the GNU General Public License
+% along with this program. If not, see <http://www.gnu.org/licenses/>.
+%
+% As a special exception, when this file is read by TeX when processing
+% a Texinfo source document, you may use the result without
+% restriction. This Exception is an additional permission under section 7
+% of the GNU General Public License, version 3 ("GPLv3").
+%
+% Please try the latest version of texinfo.tex before submitting bug
+% reports; you can get the latest version from:
+% http://ftp.gnu.org/gnu/texinfo/ (the Texinfo release area), or
+% http://ftpmirror.gnu.org/texinfo/ (same, via a mirror), or
+% http://www.gnu.org/software/texinfo/ (the Texinfo home page)
+% The texinfo.tex in any given distribution could well be out
+% of date, so if that's what you're using, please check.
+%
+% Send bug reports to address@hidden Please include including a
+% complete document in each bug report with which we can reproduce the
+% problem. Patches are, of course, greatly appreciated.
+%
+% To process a Texinfo manual with TeX, it's most reliable to use the
+% texi2dvi shell script that comes with the distribution. For a simple
+% manual foo.texi, however, you can get away with this:
+% tex foo.texi
+% texindex foo.??
+% tex foo.texi
+% tex foo.texi
+% dvips foo.dvi -o # or whatever; this makes foo.ps.
+% The extra TeX runs get the cross-reference information correct.
+% Sometimes one run after texindex suffices, and sometimes you need more
+% than two; texi2dvi does it as many times as necessary.
+%
+% It is possible to adapt texinfo.tex for other languages, to some
+% extent. You can get the existing language-specific files from the
+% full Texinfo distribution.
+%
+% The GNU Texinfo home page is http://www.gnu.org/software/texinfo.
+
+
+\message{Loading texinfo [version \texinfoversion]:}
+
+% If in a .fmt file, print the version number
+% and turn on active characters that we couldn't do earlier because
+% they might have appeared in the input file name.
+\everyjob{\message{[Texinfo version \texinfoversion]}%
+ \catcode`+=\active \catcode`\_=\active}
+
+\chardef\other=12
+
+% We never want plain's \outer definition of \+ in Texinfo.
+% For @tex, we can use \tabalign.
+\let\+ = \relax
+
+% Save some plain tex macros whose names we will redefine.
+\let\ptexb=\b
+\let\ptexbullet=\bullet
+\let\ptexc=\c
+\let\ptexcomma=\,
+\let\ptexdot=\.
+\let\ptexdots=\dots
+\let\ptexend=\end
+\let\ptexequiv=\equiv
+\let\ptexexclam=\!
+\let\ptexfootnote=\footnote
+\let\ptexgtr=>
+\let\ptexhat=^
+\let\ptexi=\i
+\let\ptexindent=\indent
+\let\ptexinsert=\insert
+\let\ptexlbrace=\{
+\let\ptexless=<
+\let\ptexnewwrite\newwrite
+\let\ptexnoindent=\noindent
+\let\ptexplus=+
+\let\ptexraggedright=\raggedright
+\let\ptexrbrace=\}
+\let\ptexslash=\/
+\let\ptexsp=\sp
+\let\ptexstar=\*
+\let\ptexsup=\sup
+\let\ptext=\t
+\let\ptextop=\top
+{\catcode`\'=\active \global\let\ptexquoteright'}% active in plain's math mode
+
+% If this character appears in an error message or help string, it
+% starts a new line in the output.
+\newlinechar = `^^J
+
+% Use TeX 3.0's \inputlineno to get the line number, for better error
+% messages, but if we're using an old version of TeX, don't do anything.
+%
+\ifx\inputlineno\thisisundefined
+ \let\linenumber = \empty % Pre-3.0.
+\else
+ \def\linenumber{l.\the\inputlineno:\space}
+\fi
+
+% Set up fixed words for English if not already set.
+\ifx\putwordAppendix\undefined \gdef\putwordAppendix{Appendix}\fi
+\ifx\putwordChapter\undefined \gdef\putwordChapter{Chapter}\fi
+\ifx\putworderror\undefined \gdef\putworderror{error}\fi
+\ifx\putwordfile\undefined \gdef\putwordfile{file}\fi
+\ifx\putwordin\undefined \gdef\putwordin{in}\fi
+\ifx\putwordIndexIsEmpty\undefined \gdef\putwordIndexIsEmpty{(Index is
empty)}\fi
+\ifx\putwordIndexNonexistent\undefined \gdef\putwordIndexNonexistent{(Index
is nonexistent)}\fi
+\ifx\putwordInfo\undefined \gdef\putwordInfo{Info}\fi
+\ifx\putwordInstanceVariableof\undefined
\gdef\putwordInstanceVariableof{Instance Variable of}\fi
+\ifx\putwordMethodon\undefined \gdef\putwordMethodon{Method on}\fi
+\ifx\putwordNoTitle\undefined \gdef\putwordNoTitle{No Title}\fi
+\ifx\putwordof\undefined \gdef\putwordof{of}\fi
+\ifx\putwordon\undefined \gdef\putwordon{on}\fi
+\ifx\putwordpage\undefined \gdef\putwordpage{page}\fi
+\ifx\putwordsection\undefined \gdef\putwordsection{section}\fi
+\ifx\putwordSection\undefined \gdef\putwordSection{Section}\fi
+\ifx\putwordsee\undefined \gdef\putwordsee{see}\fi
+\ifx\putwordSee\undefined \gdef\putwordSee{See}\fi
+\ifx\putwordShortTOC\undefined \gdef\putwordShortTOC{Short Contents}\fi
+\ifx\putwordTOC\undefined \gdef\putwordTOC{Table of Contents}\fi
+%
+\ifx\putwordMJan\undefined \gdef\putwordMJan{January}\fi
+\ifx\putwordMFeb\undefined \gdef\putwordMFeb{February}\fi
+\ifx\putwordMMar\undefined \gdef\putwordMMar{March}\fi
+\ifx\putwordMApr\undefined \gdef\putwordMApr{April}\fi
+\ifx\putwordMMay\undefined \gdef\putwordMMay{May}\fi
+\ifx\putwordMJun\undefined \gdef\putwordMJun{June}\fi
+\ifx\putwordMJul\undefined \gdef\putwordMJul{July}\fi
+\ifx\putwordMAug\undefined \gdef\putwordMAug{August}\fi
+\ifx\putwordMSep\undefined \gdef\putwordMSep{September}\fi
+\ifx\putwordMOct\undefined \gdef\putwordMOct{October}\fi
+\ifx\putwordMNov\undefined \gdef\putwordMNov{November}\fi
+\ifx\putwordMDec\undefined \gdef\putwordMDec{December}\fi
+%
+\ifx\putwordDefmac\undefined \gdef\putwordDefmac{Macro}\fi
+\ifx\putwordDefspec\undefined \gdef\putwordDefspec{Special Form}\fi
+\ifx\putwordDefvar\undefined \gdef\putwordDefvar{Variable}\fi
+\ifx\putwordDefopt\undefined \gdef\putwordDefopt{User Option}\fi
+\ifx\putwordDeffunc\undefined \gdef\putwordDeffunc{Function}\fi
+%
+% Aggiunto per l'italiano
+\gdef\putwordla{la}
+\gdef\putwordLa{La}
+\gdef\putwordsivedail{si veda il}
+\gdef\putwordSivedail{Si veda il}
+% Produces article before Section names
+\def\refla#1{\putwordla{} \xrefX[#1,,,,,,,]}
+\def\refLa#1{\putwordLa{} \xrefX[#1,,,,,,,]}
+% Produces article before Chapter names
+\def\pxrefil#1{\putwordsivedail{} \xrefX[#1,,,,,,,]}
+\def\pxrefIl#1{\putwordSivedail{} \xrefX[#1,,,,,,,]}
+\def\xrefil#1{\putwordsivedail{} \xrefX[#1,,,,,,,]}
+\def\xrefIl#1{\putwordSivedail{} \xrefX[#1,,,,,,,]}
+
+% Give the space character the catcode for a space.
+\def\spaceisspace{\catcode`\ =10\relax}
+
+\chardef\dashChar = `\-
+\chardef\slashChar = `\/
+\chardef\underChar = `\_
+
+% Ignore a token.
+%
+\def\gobble#1{}
+
+% The following is used inside several \edef's.
+\def\makecsname#1{\expandafter\noexpand\csname#1\endcsname}
+
+% Hyphenation fixes.
+\hyphenation{
+ Flor-i-da Ghost-script Ghost-view Mac-OS Post-Script
+ ap-pen-dix bit-map bit-maps
+ data-base data-bases eshell fall-ing half-way long-est man-u-script
+ man-u-scripts mini-buf-fer mini-buf-fers over-view par-a-digm
+ par-a-digms rath-er rec-tan-gu-lar ro-bot-ics se-vere-ly set-up spa-ces
+ spell-ing spell-ings
+ stand-alone strong-est time-stamp time-stamps which-ever white-space
+ wide-spread wrap-around
+}
+
+% Sometimes it is convenient to have everything in the transcript file
+% and nothing on the terminal. We don't just call \tracingall here,
+% since that produces some useless output on the terminal. We also make
+% some effort to order the tracing commands to reduce output in the log
+% file; cf. trace.sty in LaTeX.
+%
+\def\gloggingall{\begingroup \globaldefs = 1 \loggingall \endgroup}%
+\def\loggingall{%
+ \tracingstats2
+ \tracingpages1
+ \tracinglostchars2 % 2 gives us more in etex
+ \tracingparagraphs1
+ \tracingoutput1
+ \tracingmacros2
+ \tracingrestores1
+ \showboxbreadth\maxdimen \showboxdepth\maxdimen
+ \ifx\eTeXversion\thisisundefined\else % etex gives us more logging
+ \tracingscantokens1
+ \tracingifs1
+ \tracinggroups1
+ \tracingnesting2
+ \tracingassigns1
+ \fi
+ \tracingcommands3 % 3 gives us more in etex
+ \errorcontextlines16
+}%
+
+% @errormsg{MSG}. Do the index-like expansions on MSG, but if things
+% aren't perfect, it's not the end of the world, being an error message,
+% after all.
+%
+\def\errormsg{\begingroup \indexnofonts \doerrormsg}
+\def\doerrormsg#1{\errmessage{#1}}
+
+% add check for \lastpenalty to plain's definitions. If the last thing
+% we did was a \nobreak, we don't want to insert more space.
+%
+\def\smallbreak{\ifnum\lastpenalty<10000\par\ifdim\lastskip<\smallskipamount
+ \removelastskip\penalty-50\smallskip\fi\fi}
+\def\medbreak{\ifnum\lastpenalty<10000\par\ifdim\lastskip<\medskipamount
+ \removelastskip\penalty-100\medskip\fi\fi}
+\def\bigbreak{\ifnum\lastpenalty<10000\par\ifdim\lastskip<\bigskipamount
+ \removelastskip\penalty-200\bigskip\fi\fi}
+
+% Output routine
+%
+
+% For a final copy, take out the rectangles
+% that mark overfull boxes (in case you have decided
+% that the text looks ok even though it passes the margin).
+%
+\def\finalout{\overfullrule=0pt }
+
+% Do @cropmarks to get crop marks.
+%
+\newif\ifcropmarks
+\let\cropmarks = \cropmarkstrue
+%
+% Dimensions to add cropmarks at corners.
+% Added by P. A. MacKay, 12 Nov. 1986
+%
+\newdimen\outerhsize \newdimen\outervsize % set by the paper size routines
+\newdimen\cornerlong \cornerlong=1pc
+\newdimen\cornerthick \cornerthick=.3pt
+\newdimen\topandbottommargin \topandbottommargin=.75in
+
+% Output a mark which sets \thischapter, \thissection and \thiscolor.
+% We dump everything together because we only have one kind of mark.
+% This works because we only use \botmark / \topmark, not \firstmark.
+%
+% A mark contains a subexpression of the \ifcase ... \fi construct.
+% \get*marks macros below extract the needed part using \ifcase.
+%
+% Another complication is to let the user choose whether \thischapter
+% (\thissection) refers to the chapter (section) in effect at the top
+% of a page, or that at the bottom of a page.
+
+% \domark is called twice inside \chapmacro, to add one
+% mark before the section break, and one after.
+% In the second call \prevchapterdefs is the same as \lastchapterdefs,
+% and \prevsectiondefs is the same as \lastsectiondefs.
+% Then if the page is not broken at the mark, some of the previous
+% section appears on the page, and we can get the name of this section
+% from \firstmark for @everyheadingmarks top.
+% @everyheadingmarks bottom uses \botmark.
+%
+% See page 260 of The TeXbook.
+\def\domark{%
+ \toks0=\expandafter{\lastchapterdefs}%
+ \toks2=\expandafter{\lastsectiondefs}%
+ \toks4=\expandafter{\prevchapterdefs}%
+ \toks6=\expandafter{\prevsectiondefs}%
+ \toks8=\expandafter{\lastcolordefs}%
+ \mark{%
+ \the\toks0 \the\toks2 % 0: marks for @everyheadingmarks top
+ \noexpand\or \the\toks4 \the\toks6 % 1: for @everyheadingmarks bottom
+ \noexpand\else \the\toks8 % 2: color marks
+ }%
+}
+
+% \gettopheadingmarks, \getbottomheadingmarks,
+% \getcolormarks - extract needed part of mark.
+%
+% \topmark doesn't work for the very first chapter (after the title
+% page or the contents), so we use \firstmark there -- this gets us
+% the mark with the chapter defs, unless the user sneaks in, e.g.,
+% @setcolor (or @url, or @link, etc.) between @contents and the very
+% first @chapter.
+\def\gettopheadingmarks{%
+ \ifcase0\topmark\fi
+ \ifx\thischapter\empty \ifcase0\firstmark\fi \fi
+}
+\def\getbottomheadingmarks{\ifcase1\botmark\fi}
+\def\getcolormarks{\ifcase2\topmark\fi}
+
+% Avoid "undefined control sequence" errors.
+\def\lastchapterdefs{}
+\def\lastsectiondefs{}
+\def\lastsection{}
+\def\prevchapterdefs{}
+\def\prevsectiondefs{}
+\def\lastcolordefs{}
+
+% Margin to add to right of even pages, to left of odd pages.
+\newdimen\bindingoffset
+\newdimen\normaloffset
+\newdimen\pagewidth \newdimen\pageheight
+
+% Main output routine.
+%
+\chardef\PAGE = 255
+\output = {\onepageout{\pagecontents\PAGE}}
+
+\newbox\headlinebox
+\newbox\footlinebox
+
+% \onepageout takes a vbox as an argument.
+% \shipout a vbox for a single page, adding an optional header, footer,
+% cropmarks, and footnote. This also causes index entries for this page
+% to be written to the auxiliary files.
+%
+\def\onepageout#1{%
+ \ifcropmarks \hoffset=0pt \else \hoffset=\normaloffset \fi
+ %
+ \ifodd\pageno \advance\hoffset by \bindingoffset
+ \else \advance\hoffset by -\bindingoffset\fi
+ %
+ % Common context changes for both heading and footing.
+ % Do this outside of the \shipout so @code etc. will be expanded in
+ % the headline as they should be, not taken literally (outputting ''code).
+ \def\commmonheadfootline{\let\hsize=\pagewidth \texinfochars}
+ %
+ % Retrieve the information for the headings from the marks in the page,
+ % and call Plain TeX's \makeheadline and \makefootline, which use the
+ % values in \headline and \footline.
+ %
+ % This is used to check if we are on the first page of a chapter.
+ \ifcase1\topmark\fi
+ \let\prevchaptername\thischaptername
+ \ifcase0\firstmark\fi
+ \let\curchaptername\thischaptername
+ %
+ \ifodd\pageno \getoddheadingmarks \else \getevenheadingmarks \fi
+ \ifodd\pageno \getoddfootingmarks \else \getevenfootingmarks \fi
+ %
+ \ifx\curchaptername\prevchaptername
+ \let\thischapterheading\thischapter
+ \else
+ % \thischapterheading is the same as \thischapter except it is blank
+ % for the first page of a chapter. This is to prevent the chapter name
+ % being shown twice.
+ \def\thischapterheading{}%
+ \fi
+ %
+ \global\setbox\headlinebox = \vbox{\commmonheadfootline \makeheadline}%
+ \global\setbox\footlinebox = \vbox{\commmonheadfootline \makefootline}%
+ %
+ {%
+ % Set context for writing to auxiliary files like index files.
+ % Have to do this stuff outside the \shipout because we want it to
+ % take effect in \write's, yet the group defined by the \vbox ends
+ % before the \shipout runs.
+ %
+ \indexdummies % don't expand commands in the output.
+ \normalturnoffactive % \ in index entries must not stay \, e.g., if
+ % the page break happens to be in the middle of an example.
+ % We don't want .vr (or whatever) entries like this:
+ % \entry{{\indexbackslash }acronym}{32}{\code {\acronym}}
+ % "\acronym" won't work when it's read back in;
+ % it needs to be
+ % {\code {{\backslashcurfont }acronym}
+ \shipout\vbox{%
+ % Do this early so pdf references go to the beginning of the page.
+ \ifpdfmakepagedest \pdfdest name{\the\pageno} xyz\fi
+ %
+ \ifcropmarks \vbox to \outervsize\bgroup
+ \hsize = \outerhsize
+ \vskip-\topandbottommargin
+ \vtop to0pt{%
+ \line{\ewtop\hfil\ewtop}%
+ \nointerlineskip
+ \line{%
+ \vbox{\moveleft\cornerthick\nstop}%
+ \hfill
+ \vbox{\moveright\cornerthick\nstop}%
+ }%
+ \vss}%
+ \vskip\topandbottommargin
+ \line\bgroup
+ \hfil % center the page within the outer (page) hsize.
+ \ifodd\pageno\hskip\bindingoffset\fi
+ \vbox\bgroup
+ \fi
+ %
+ \unvbox\headlinebox
+ \pagebody{#1}%
+ \ifdim\ht\footlinebox > 0pt
+ % Only leave this space if the footline is nonempty.
+ % (We lessened \vsize for it in \oddfootingyyy.)
+ % The \baselineskip=24pt in plain's \makefootline has no effect.
+ \vskip 24pt
+ \unvbox\footlinebox
+ \fi
+ %
+ \ifcropmarks
+ \egroup % end of \vbox\bgroup
+ \hfil\egroup % end of (centering) \line\bgroup
+ \vskip\topandbottommargin plus1fill minus1fill
+ \boxmaxdepth = \cornerthick
+ \vbox to0pt{\vss
+ \line{%
+ \vbox{\moveleft\cornerthick\nsbot}%
+ \hfill
+ \vbox{\moveright\cornerthick\nsbot}%
+ }%
+ \nointerlineskip
+ \line{\ewbot\hfil\ewbot}%
+ }%
+ \egroup % \vbox from first cropmarks clause
+ \fi
+ }% end of \shipout\vbox
+ }% end of group with \indexdummies
+ \advancepageno
+ \ifnum\outputpenalty>-20000 \else\dosupereject\fi
+}
+
+\newinsert\margin \dimen\margin=\maxdimen
+
+% Main part of page, including any footnotes
+\def\pagebody#1{\vbox to\pageheight{\boxmaxdepth=\maxdepth #1}}
+{\catcode`\@ =11
+\gdef\pagecontents#1{\ifvoid\topins\else\unvbox\topins\fi
+% marginal hacks, address@hidden (Juha Takala)
+\ifvoid\margin\else % marginal info is present
+ \rlap{\kern\hsize\vbox address@hidden \vss}}\fi
address@hidden \unvbox#1\relax
+\ifvoid\footins\else\vskip\skip\footins\footnoterule \unvbox\footins\fi
address@hidden \kern-\dimen@ \vfil \fi}
+}
+
+% Here are the rules for the cropmarks. Note that they are
+% offset so that the space between them is truly \outerhsize or \outervsize
+% (P. A. MacKay, 12 November, 1986)
+%
+\def\ewtop{\vrule height\cornerthick depth0pt width\cornerlong}
+\def\nstop{\vbox
+ {\hrule height\cornerthick depth\cornerlong width\cornerthick}}
+\def\ewbot{\vrule height0pt depth\cornerthick width\cornerlong}
+\def\nsbot{\vbox
+ {\hrule height\cornerlong depth\cornerthick width\cornerthick}}
+
+
+% Argument parsing
+
+% Parse an argument, then pass it to #1. The argument is the rest of
+% the input line (except we remove a trailing comment). #1 should be a
+% macro which expects an ordinary undelimited TeX argument.
+% For example, \def\foo{\parsearg\fooxxx}.
+%
+\def\parsearg{\parseargusing{}}
+\def\parseargusing#1#2{%
+ \def\argtorun{#2}%
+ \begingroup
+ \obeylines
+ \spaceisspace
+ #1%
+ \parseargline\empty% Insert the \empty token, see \finishparsearg below.
+}
+
+{\obeylines %
+ \gdef\parseargline#1^^M{%
+ \endgroup % End of the group started in \parsearg.
+ \argremovecomment #1\comment\ArgTerm%
+ }%
+}
+
+% First remove any @comment, then any @c comment. Also remove a @texinfoc
+% comment (see \scanmacro for details). Pass the result on to \argcheckspaces.
+\def\argremovecomment#1\comment#2\ArgTerm{\argremovec #1\c\ArgTerm}
+\def\argremovec#1\c#2\ArgTerm{\argremovetexinfoc #1\texinfoc\ArgTerm}
+\def\argremovetexinfoc#1\texinfoc#2\ArgTerm{\argcheckspaces#1\^^M\ArgTerm}
+
+% Each occurrence of `\^^M' or `<space>\^^M' is replaced by a single space.
+%
+% \argremovec might leave us with trailing space, e.g.,
+% @end itemize @c foo
+% This space token undergoes the same procedure and is eventually removed
+% by \finishparsearg.
+%
+\def\argcheckspaces#1\^^M{\argcheckspacesX#1\^^M \^^M}
+\def\argcheckspacesX#1 \^^M{\argcheckspacesY#1\^^M}
+\def\argcheckspacesY#1\^^M#2\^^M#3\ArgTerm{%
+ \def\temp{#3}%
+ \ifx\temp\empty
+ % Do not use \next, perhaps the caller of \parsearg uses it; reuse \temp:
+ \let\temp\finishparsearg
+ \else
+ \let\temp\argcheckspaces
+ \fi
+ % Put the space token in:
+ \temp#1 #3\ArgTerm
+}
+
+% If a _delimited_ argument is enclosed in braces, they get stripped; so
+% to get _exactly_ the rest of the line, we had to prevent such situation.
+% We prepended an \empty token at the very beginning and we expand it now,
+% just before passing the control to \argtorun.
+% (Similarly, we have to think about #3 of \argcheckspacesY above: it is
+% either the null string, or it ends with \^^M---thus there is no danger
+% that a pair of braces would be stripped.
+%
+% But first, we have to remove the trailing space token.
+%
+\def\finishparsearg#1 \ArgTerm{\expandafter\argtorun\expandafter{#1}}
+
+
+% \parseargdef - define a command taking an argument on the line
+%
+% \parseargdef\foo{...}
+% is roughly equivalent to
+% \def\foo{\parsearg\Xfoo}
+% \def\Xfoo#1{...}
+\def\parseargdef#1{%
+ \expandafter \doparseargdef \csname\string#1\endcsname #1%
+}
+\def\doparseargdef#1#2{%
+ \def#2{\parsearg#1}%
+ \def#1##1%
+}
+
+% Several utility definitions with active space:
+{
+ \obeyspaces
+ \gdef\obeyedspace{ }
+
+ % Make each space character in the input produce a normal interword
+ % space in the output. Don't allow a line break at this space, as this
+ % is used only in environments like @example, where each line of input
+ % should produce a line of output anyway.
+ %
+ \gdef\sepspaces{\obeyspaces\let =\tie}
+
+ % If an index command is used in an @example environment, any spaces
+ % therein should become regular spaces in the raw index file, not the
+ % expansion of \tie (\leavevmode \penalty address@hidden \ ).
+ \gdef\unsepspaces{\let =\space}
+}
+
+
+\def\flushcr{\ifx\par\lisppar \def\next##1{}\else \let\next=\relax \fi \next}
+
+% Define the framework for environments in texinfo.tex. It's used like this:
+%
+% \envdef\foo{...}
+% \def\Efoo{...}
+%
+% It's the responsibility of \envdef to insert \begingroup before the
+% actual body; @end closes the group after calling \Efoo. \envdef also
+% defines \thisenv, so the current environment is known; @end checks
+% whether the environment name matches. The \checkenv macro can also be
+% used to check whether the current environment is the one expected.
+%
+% Non-false conditionals (@iftex, @ifset) don't fit into this, so they
+% are not treated as environments; they don't open a group. (The
+% implementation of @end takes care not to call \endgroup in this
+% special case.)
+
+
+% At run-time, environments start with this:
+\def\startenvironment#1{\begingroup\def\thisenv{#1}}
+% initialize
+\let\thisenv\empty
+
+% ... but they get defined via ``\envdef\foo{...}'':
+\long\def\envdef#1#2{\def#1{\startenvironment#1#2}}
+\def\envparseargdef#1#2{\parseargdef#1{\startenvironment#1#2}}
+
+% Check whether we're in the right environment:
+\def\checkenv#1{%
+ \def\temp{#1}%
+ \ifx\thisenv\temp
+ \else
+ \badenverr
+ \fi
+}
+
+% Environment mismatch, #1 expected:
+\def\badenverr{%
+ \errhelp = \EMsimple
+ \errmessage{This command can appear only \inenvironment\temp,
+ not \inenvironment\thisenv}%
+}
+\def\inenvironment#1{%
+ \ifx#1\empty
+ outside of any environment%
+ \else
+ in environment \expandafter\string#1%
+ \fi
+}
+
+% @end foo executes the definition of \Efoo.
+% But first, it executes a specialized version of \checkenv
+%
+\parseargdef\end{%
+ \if 1\csname iscond.#1\endcsname
+ \else
+ % The general wording of \badenverr may not be ideal.
+ \expandafter\checkenv\csname#1\endcsname
+ \csname E#1\endcsname
+ \endgroup
+ \fi
+}
+
+\newhelp\EMsimple{Press RETURN to continue.}
+
+
+% Be sure we're in horizontal mode when doing a tie, since we make space
+% equivalent to this in @example-like environments. Otherwise, a space
+% at the beginning of a line will start with \penalty -- and
+% since \penalty is valid in vertical mode, we'd end up putting the
+% penalty on the vertical list instead of in the new paragraph.
+{\catcode`@ = 11
+ % Avoid using address@hidden directly, because that causes trouble
+ % if the definition is written into an index file.
+ \global\let\tiepenalty = address@hidden
+ \gdef\tie{\leavevmode\penalty\tiepenalty\ }
+}
+
+% @: forces normal size whitespace following.
+\def\:{\spacefactor=1000 }
+
+% @* forces a line break.
+\def\*{\unskip\hfil\break\hbox{}\ignorespaces}
+
+% @/ allows a line break.
+\let\/=\allowbreak
+
+% @. is an end-of-sentence period.
+\def\.{.\spacefactor=\endofsentencespacefactor\space}
+
+% @! is an end-of-sentence bang.
+\def\!{!\spacefactor=\endofsentencespacefactor\space}
+
+% @? is an end-of-sentence query.
+\def\?{?\spacefactor=\endofsentencespacefactor\space}
+
+% @frenchspacing on|off says whether to put extra space after punctuation.
+%
+\def\onword{on}
+\def\offword{off}
+%
+\parseargdef\frenchspacing{%
+ \def\temp{#1}%
+ \ifx\temp\onword \plainfrenchspacing
+ \else\ifx\temp\offword \plainnonfrenchspacing
+ \else
+ \errhelp = \EMsimple
+ \errmessage{Unknown @frenchspacing option `\temp', must be on|off}%
+ \fi\fi
+}
+
+% @w prevents a word break. Without the \leavevmode, @w at the
+% beginning of a paragraph, when TeX is still in vertical mode, would
+% produce a whole line of output instead of starting the paragraph.
+\def\w#1{\leavevmode\hbox{#1}}
+
+% @group ... @end group forces ... to be all on one page, by enclosing
+% it in a TeX vbox. We use \vtop instead of \vbox to construct the box
+% to keep its height that of a normal line. According to the rules for
+% \topskip (p.114 of the TeXbook), the glue inserted is
+% max (\topskip - \ht (first item), 0). If that height is large,
+% therefore, no glue is inserted, and the space between the headline and
+% the text is small, which looks bad.
+%
+% Another complication is that the group might be very large. This can
+% cause the glue on the previous page to be unduly stretched, because it
+% does not have much material. In this case, it's better to add an
+% explicit \vfill so that the extra space is at the bottom. The
+% threshold for doing this is if the group is more than \vfilllimit
+% percent of a page (\vfilllimit can be changed inside of @tex).
+%
+\newbox\groupbox
+\def\vfilllimit{0.7}
+%
+\envdef\group{%
+ \ifnum\catcode`\^^M=\active \else
+ \errhelp = \groupinvalidhelp
+ address@hidden invalid in context where filling is enabled}%
+ \fi
+ \startsavinginserts
+ %
+ \setbox\groupbox = \vtop\bgroup
+ % Do @comment since we are called inside an environment such as
+ % @example, where each end-of-line in the input causes an
+ % end-of-line in the output. We don't want the end-of-line after
+ % the address@hidden' to put extra space in the output. Since @group
+ % should appear on a line by itself (according to the Texinfo
+ % manual), we don't worry about eating any user text.
+ \comment
+}
+%
+% The \vtop produces a box with normal height and large depth; thus, TeX puts
+% \baselineskip glue before it, and (when the next line of text is done)
+% \lineskip glue after it. Thus, space below is not quite equal to space
+% above. But it's pretty close.
+\def\Egroup{%
+ % To get correct interline space between the last line of the group
+ % and the first line afterwards, we have to propagate \prevdepth.
+ \endgraf % Not \par, as it may have been set to \lisppar.
+ \global\dimen1 = \prevdepth
+ \egroup % End the \vtop.
+ \addgroupbox
+ \prevdepth = \dimen1
+ \checkinserts
+}
+
+\def\addgroupbox{
+ % \dimen0 is the vertical size of the group's box.
+ \dimen0 = \ht\groupbox \advance\dimen0 by \dp\groupbox
+ % \dimen2 is how much space is left on the page (more or less).
+ \dimen2 = \pageheight \advance\dimen2 by -\pagetotal
+ % if the group doesn't fit on the current page, and it's a big big
+ % group, force a page break.
+ \ifdim \dimen0 > \dimen2
+ \ifdim \pagetotal < \vfilllimit\pageheight
+ \page
+ \fi
+ \fi
+ \box\groupbox
+}
+
+%
+% TeX puts in an \escapechar (i.e., `@') at the beginning of the help
+% message, so this ends up printing address@hidden can only ...'.
+%
+\newhelp\groupinvalidhelp{%
+group can only be used in environments such as @example,^^J%
+where each line of input produces a line of output.}
+
+% @need space-in-mils
+% forces a page break if there is not space-in-mils remaining.
+
+\newdimen\mil \mil=0.001in
+
+\parseargdef\need{%
+ % Ensure vertical mode, so we don't make a big box in the middle of a
+ % paragraph.
+ \par
+ %
+ % If the @need value is less than one line space, it's useless.
+ \dimen0 = #1\mil
+ \dimen2 = \ht\strutbox
+ \advance\dimen2 by \dp\strutbox
+ \ifdim\dimen0 > \dimen2
+ %
+ % Do a \strut just to make the height of this box be normal, so the
+ % normal leading is inserted relative to the preceding line.
+ % And a page break here is fine.
+ \vtop to #1\mil{\strut\vfil}%
+ %
+ % TeX does not even consider page breaks if a penalty added to the
+ % main vertical list is 10000 or more. But in order to see if the
+ % empty box we just added fits on the page, we must make it consider
+ % page breaks. On the other hand, we don't want to actually break the
+ % page after the empty box. So we use a penalty of 9999.
+ %
+ % There is an extremely small chance that TeX will actually break the
+ % page at this \penalty, if there are no other feasible breakpoints in
+ % sight. (If the user is using lots of big @group commands, which
+ % almost-but-not-quite fill up a page, TeX will have a hard time doing
+ % good page breaking, for example.) However, I could not construct an
+ % example where a page broke at this \penalty; if it happens in a real
+ % document, then we can reconsider our strategy.
+ \penalty9999
+ %
+ % Back up by the size of the box, whether we did a page break or not.
+ \kern -#1\mil
+ %
+ % Do not allow a page break right after this kern.
+ \nobreak
+ \fi
+}
+
+% @br forces paragraph break (and is undocumented).
+
+\let\br = \par
+
+% @page forces the start of a new page.
+%
+\def\page{\par\vfill\supereject}
+
+% @exdent text....
+% outputs text on separate line in roman font, starting at standard page margin
+
+% This records the amount of indent in the innermost environment.
+% That's how much \exdent should take out.
+\newskip\exdentamount
+
+% This defn is used inside fill environments such as @defun.
+\parseargdef\exdent{\hfil\break\hbox{\kern -\exdentamount{\rm#1}}\hfil\break}
+
+% This defn is used inside nofill environments such as @example.
+\parseargdef\nofillexdent{{\advance \leftskip by -\exdentamount
+ \leftline{\hskip\leftskip{\rm#1}}}}
+
+% @inmargin{WHICH}{TEXT} puts TEXT in the WHICH margin next to the current
+% paragraph. For more general purposes, use the \margin insertion
+% class. WHICH is `l' or `r'. Not documented, written for gawk manual.
+%
+\newskip\inmarginspacing \inmarginspacing=1cm
+\def\strutdepth{\dp\strutbox}
+%
+\def\doinmargin#1#2{\strut\vadjust{%
+ \nobreak
+ \kern-\strutdepth
+ \vtop to \strutdepth{%
+ \baselineskip=\strutdepth
+ \vss
+ % if you have multiple lines of stuff to put here, you'll need to
+ % make the vbox yourself of the appropriate size.
+ \ifx#1l%
+ \llap{\ignorespaces #2\hskip\inmarginspacing}%
+ \else
+ \rlap{\hskip\hsize \hskip\inmarginspacing \ignorespaces #2}%
+ \fi
+ \null
+ }%
+}}
+\def\inleftmargin{\doinmargin l}
+\def\inrightmargin{\doinmargin r}
+%
+% @inmargin{TEXT [, RIGHT-TEXT]}
+% (if RIGHT-TEXT is given, use TEXT for left page, RIGHT-TEXT for right;
+% else use TEXT for both).
+%
+\def\inmargin#1{\parseinmargin #1,,\finish}
+\def\parseinmargin#1,#2,#3\finish{% not perfect, but better than nothing.
+ \setbox0 = \hbox{\ignorespaces #2}%
+ \ifdim\wd0 > 0pt
+ \def\lefttext{#1}% have both texts
+ \def\righttext{#2}%
+ \else
+ \def\lefttext{#1}% have only one text
+ \def\righttext{#1}%
+ \fi
+ %
+ \ifodd\pageno
+ \def\temp{\inrightmargin\righttext}% odd page -> outside is right margin
+ \else
+ \def\temp{\inleftmargin\lefttext}%
+ \fi
+ \temp
+}
+
+% @| inserts a changebar to the left of the current line. It should
+% surround any changed text. This approach does *not* work if the
+% change spans more than two lines of output. To handle that, we would
+% have adopt a much more difficult approach (putting marks into the main
+% vertical list for the beginning and end of each change). This command
+% is not documented, not supported, and doesn't work.
+%
+\def\|{%
+ % \vadjust can only be used in horizontal mode.
+ \leavevmode
+ %
+ % Append this vertical mode material after the current line in the output.
+ \vadjust{%
+ % We want to insert a rule with the height and depth of the current
+ % leading; that is exactly what \strutbox is supposed to record.
+ \vskip-\baselineskip
+ %
+ % \vadjust-items are inserted at the left edge of the type. So
+ % the \llap here moves out into the left-hand margin.
+ \llap{%
+ %
+ % For a thicker or thinner bar, change the `1pt'.
+ \vrule height\baselineskip width1pt
+ %
+ % This is the space between the bar and the text.
+ \hskip 12pt
+ }%
+ }%
+}
+
+% @include FILE -- \input text of FILE.
+%
+\def\include{\parseargusing\filenamecatcodes\includezzz}
+\def\includezzz#1{%
+ \pushthisfilestack
+ \def\thisfile{#1}%
+ {%
+ \makevalueexpandable % we want to expand any @value in FILE.
+ \turnoffactive % and allow special characters in the expansion
+ \indexnofonts % Allow `@@' and other weird things in file names.
+ \wlog{texinfo.tex: doing @include of #1^^J}%
+ \edef\temp{\noexpand\input #1 }%
+ %
+ % This trickery is to read FILE outside of a group, in case it makes
+ % definitions, etc.
+ \expandafter
+ }\temp
+ \popthisfilestack
+}
+\def\filenamecatcodes{%
+ \catcode`\\=\other
+ \catcode`~=\other
+ \catcode`^=\other
+ \catcode`_=\other
+ \catcode`|=\other
+ \catcode`<=\other
+ \catcode`>=\other
+ \catcode`+=\other
+ \catcode`-=\other
+ \catcode`\`=\other
+ \catcode`\'=\other
+}
+
+\def\pushthisfilestack{%
+ \expandafter\pushthisfilestackX\popthisfilestack\StackTerm
+}
+\def\pushthisfilestackX{%
+ \expandafter\pushthisfilestackY\thisfile\StackTerm
+}
+\def\pushthisfilestackY #1\StackTerm #2\StackTerm {%
+ \gdef\popthisfilestack{\gdef\thisfile{#1}\gdef\popthisfilestack{#2}}%
+}
+
+\def\popthisfilestack{\errthisfilestackempty}
+\def\errthisfilestackempty{\errmessage{Internal error:
+ the stack of filenames is empty.}}
+%
+\def\thisfile{}
+
+% @center line
+% outputs that line, centered.
+%
+\parseargdef\center{%
+ \ifhmode
+ \let\centersub\centerH
+ \else
+ \let\centersub\centerV
+ \fi
+ \centersub{\hfil \ignorespaces#1\unskip \hfil}%
+ \let\centersub\relax % don't let the definition persist, just in case
+}
+\def\centerH#1{{%
+ \hfil\break
+ \advance\hsize by -\leftskip
+ \advance\hsize by -\rightskip
+ \line{#1}%
+ \break
+}}
+%
+\newcount\centerpenalty
+\def\centerV#1{%
+ % The idea here is the same as in \startdefun, \cartouche, etc.: if
+ % @center is the first thing after a section heading, we need to wipe
+ % out the negative parskip inserted by \sectionheading, but still
+ % prevent a page break here.
+ \centerpenalty = \lastpenalty
+ \ifnum\centerpenalty>10000 \vskip\parskip \fi
+ \ifnum\centerpenalty>9999 \penalty\centerpenalty \fi
+ \line{\kern\leftskip #1\kern\rightskip}%
+}
+
+% @sp n outputs n lines of vertical space
+%
+\parseargdef\sp{\vskip #1\baselineskip}
+
+% @comment ...line which is ignored...
+% @c is the same as @comment
+% @ignore ... @end ignore is another way to write a comment
+%
+\def\comment{\begingroup \catcode`\^^M=\active%
address@hidden \catcode`\{=\other \catcode`\}=\other\commentxxx}%
+
+{\catcode`\^^M=\active%
+\gdef\commentxxx#1^^M{\endgroup%
+\futurelet\nexttoken\commentxxxx}%
+\gdef\commentxxxx{\ifx\nexttoken\aftermacro\expandafter\comment\fi}%
+}
+
+\def\c{\begingroup \catcode`\^^M=\active%
address@hidden \catcode`\{=\other \catcode`\}=\other%
+\cxxx}
+{\catcode`\^^M=\active \gdef\cxxx#1^^M{\endgroup}}
+% See comment in \scanmacro about why the definitions of @c and @comment differ
+
+% @paragraphindent NCHARS
+% We'll use ems for NCHARS, close enough.
+% NCHARS can also be the word `asis' or `none'.
+% We cannot feasibly implement @paragraphindent asis, though.
+%
+\def\asisword{asis} % no translation, these are keywords
+\def\noneword{none}
+%
+\parseargdef\paragraphindent{%
+ \def\temp{#1}%
+ \ifx\temp\asisword
+ \else
+ \ifx\temp\noneword
+ \defaultparindent = 0pt
+ \else
+ \defaultparindent = #1em
+ \fi
+ \fi
+ \parindent = \defaultparindent
+}
+
+% @exampleindent NCHARS
+% We'll use ems for NCHARS like @paragraphindent.
+% It seems @exampleindent asis isn't necessary, but
+% I preserve it to make it similar to @paragraphindent.
+\parseargdef\exampleindent{%
+ \def\temp{#1}%
+ \ifx\temp\asisword
+ \else
+ \ifx\temp\noneword
+ \lispnarrowing = 0pt
+ \else
+ \lispnarrowing = #1em
+ \fi
+ \fi
+}
+
+% @firstparagraphindent WORD
+% If WORD is `none', then suppress indentation of the first paragraph
+% after a section heading. If WORD is `insert', then do indent at such
+% paragraphs.
+%
+% The paragraph indentation is suppressed or not by calling
+% \suppressfirstparagraphindent, which the sectioning commands do.
+% We switch the definition of this back and forth according to WORD.
+% By default, we suppress indentation.
+%
+\def\suppressfirstparagraphindent{\dosuppressfirstparagraphindent}
+\def\insertword{insert}
+%
+\parseargdef\firstparagraphindent{%
+ \def\temp{#1}%
+ \ifx\temp\noneword
+ \let\suppressfirstparagraphindent = \dosuppressfirstparagraphindent
+ \else\ifx\temp\insertword
+ \let\suppressfirstparagraphindent = \relax
+ \else
+ \errhelp = \EMsimple
+ \errmessage{Unknown @firstparagraphindent option `\temp'}%
+ \fi\fi
+}
+
+% Here is how we actually suppress indentation. Redefine \everypar to
+% \kern backwards by \parindent, and then reset itself to empty.
+%
+% We also make \indent itself not actually do anything until the next
+% paragraph.
+%
+\gdef\dosuppressfirstparagraphindent{%
+ \gdef\indent {\restorefirstparagraphindent \indent}%
+ \gdef\noindent{\restorefirstparagraphindent \noindent}%
+ \global\everypar = {\kern -\parindent \restorefirstparagraphindent}%
+}
+%
+\gdef\restorefirstparagraphindent{%
+ \global\let\indent = \ptexindent
+ \global\let\noindent = \ptexnoindent
+ \global\everypar = {}%
+}
+
+
+% @refill is a no-op.
+\let\refill=\relax
+
+% @setfilename INFO-FILENAME - ignored
+\let\setfilename=\comment
+
+% @bye.
+\outer\def\bye{\pagealignmacro\tracingstats=1\ptexend}
+
+
+\message{pdf,}
+% adobe `portable' document format
+\newcount\tempnum
+\newcount\lnkcount
+\newtoks\filename
+\newcount\filenamelength
+\newcount\pgn
+\newtoks\toksA
+\newtoks\toksB
+\newtoks\toksC
+\newtoks\toksD
+\newbox\boxA
+\newbox\boxB
+\newcount\countA
+\newif\ifpdf
+\newif\ifpdfmakepagedest
+
+% when pdftex is run in dvi mode, \pdfoutput is defined (so \pdfoutput=1
+% can be set). So we test for \relax and 0 as well as being undefined.
+\ifx\pdfoutput\thisisundefined
+\else
+ \ifx\pdfoutput\relax
+ \else
+ \ifcase\pdfoutput
+ \else
+ \pdftrue
+ \fi
+ \fi
+\fi
+
+% PDF uses PostScript string constants for the names of xref targets,
+% for display in the outlines, and in other places. Thus, we have to
+% double any backslashes. Otherwise, a name like "\node" will be
+% interpreted as a newline (\n), followed by o, d, e. Not good.
+%
+% See http://www.ntg.nl/pipermail/ntg-pdftex/2004-July/000654.html and
+% related messages. The final outcome is that it is up to the TeX user
+% to double the backslashes and otherwise make the string valid, so
+% that's what we do. pdftex 1.30.0 (ca.2005) introduced a primitive to
+% do this reliably, so we use it.
+
+% #1 is a control sequence in which to do the replacements,
+% which we \xdef.
+\def\txiescapepdf#1{%
+ \ifx\pdfescapestring\thisisundefined
+ % No primitive available; should we give a warning or log?
+ % Many times it won't matter.
+ \else
+ % The expandable \pdfescapestring primitive escapes parentheses,
+ % backslashes, and other special chars.
+ \xdef#1{\pdfescapestring{#1}}%
+ \fi
+}
+
+\newhelp\nopdfimagehelp{Texinfo supports .png, .jpg, .jpeg, and .pdf images
+with PDF output, and none of those formats could be found. (.eps cannot
+be supported due to the design of the PDF format; use regular TeX (DVI
+output) for that.)}
+
+\ifpdf
+ %
+ % Color manipulation macros using ideas from pdfcolor.tex,
+ % except using rgb instead of cmyk; the latter is said to render as a
+ % very dark gray on-screen and a very dark halftone in print, instead
+ % of actual black. The dark red here is dark enough to print on paper as
+ % nearly black, but still distinguishable for online viewing. We use
+ % black by default, though.
+ \def\rgbDarkRed{0.50 0.09 0.12}
+ \def\rgbBlack{0 0 0}
+ %
+ % rg sets the color for filling (usual text, etc.);
+ % RG sets the color for stroking (thin rules, e.g., normal _'s).
+ \def\pdfsetcolor#1{\pdfliteral{#1 rg #1 RG}}
+ %
+ % Set color, and create a mark which defines \thiscolor accordingly,
+ % so that \makeheadline knows which color to restore.
+ \def\setcolor#1{%
+ \xdef\lastcolordefs{\gdef\noexpand\thiscolor{#1}}%
+ \domark
+ \pdfsetcolor{#1}%
+ }
+ %
+ \def\maincolor{\rgbBlack}
+ \pdfsetcolor{\maincolor}
+ \edef\thiscolor{\maincolor}
+ \def\lastcolordefs{}
+ %
+ \def\makefootline{%
+ \baselineskip24pt
+ \line{\pdfsetcolor{\maincolor}\the\footline}%
+ }
+ %
+ \def\makeheadline{%
+ \vbox to 0pt{%
+ \vskip-22.5pt
+ \line{%
+ \vbox to8.5pt{}%
+ % Extract \thiscolor definition from the marks.
+ \getcolormarks
+ % Typeset the headline with \maincolor, then restore the color.
+ \pdfsetcolor{\maincolor}\the\headline\pdfsetcolor{\thiscolor}%
+ }%
+ \vss
+ }%
+ \nointerlineskip
+ }
+ %
+ %
+ \pdfcatalog{/PageMode /UseOutlines}
+ %
+ % #1 is image name, #2 width (might be empty/whitespace), #3 height (ditto).
+ \def\dopdfimage#1#2#3{%
+ \def\pdfimagewidth{#2}\setbox0 = \hbox{\ignorespaces #2}%
+ \def\pdfimageheight{#3}\setbox2 = \hbox{\ignorespaces #3}%
+ %
+ % pdftex (and the PDF format) support .pdf, .png, .jpg (among
+ % others). Let's try in that order, PDF first since if
+ % someone has a scalable image, presumably better to use that than a
+ % bitmap.
+ \let\pdfimgext=\empty
+ \begingroup
+ \openin 1 #1.pdf \ifeof 1
+ \openin 1 #1.PDF \ifeof 1
+ \openin 1 #1.png \ifeof 1
+ \openin 1 #1.jpg \ifeof 1
+ \openin 1 #1.jpeg \ifeof 1
+ \openin 1 #1.JPG \ifeof 1
+ \errhelp = \nopdfimagehelp
+ \errmessage{Could not find image file #1 for pdf}%
+ \else \gdef\pdfimgext{JPG}%
+ \fi
+ \else \gdef\pdfimgext{jpeg}%
+ \fi
+ \else \gdef\pdfimgext{jpg}%
+ \fi
+ \else \gdef\pdfimgext{png}%
+ \fi
+ \else \gdef\pdfimgext{PDF}%
+ \fi
+ \else \gdef\pdfimgext{pdf}%
+ \fi
+ \closein 1
+ \endgroup
+ %
+ % without \immediate, ancient pdftex seg faults when the same image is
+ % included twice. (Version 3.14159-pre-1.0-unofficial-20010704.)
+ \ifnum\pdftexversion < 14
+ \immediate\pdfimage
+ \else
+ \immediate\pdfximage
+ \fi
+ \ifdim \wd0 >0pt width \pdfimagewidth \fi
+ \ifdim \wd2 >0pt height \pdfimageheight \fi
+ \ifnum\pdftexversion<13
+ #1.\pdfimgext
+ \else
+ {#1.\pdfimgext}%
+ \fi
+ \ifnum\pdftexversion < 14 \else
+ \pdfrefximage \pdflastximage
+ \fi}
+ %
+ \def\pdfmkdest#1{{%
+ % We have to set dummies so commands such as @code, and characters
+ % such as \, aren't expanded when present in a section title.
+ \indexnofonts
+ \turnoffactive
+ \makevalueexpandable
+ \def\pdfdestname{#1}%
+ \txiescapepdf\pdfdestname
+ \safewhatsit{\pdfdest name{\pdfdestname} xyz}%
+ }}
+ %
+ % used to mark target names; must be expandable.
+ \def\pdfmkpgn#1{#1}
+ %
+ % by default, use black for everything.
+ \def\urlcolor{\rgbBlack}
+ \def\linkcolor{\rgbBlack}
+ \def\endlink{\setcolor{\maincolor}\pdfendlink}
+ %
+ % Adding outlines to PDF; macros for calculating structure of outlines
+ % come from Petr Olsak
+ \def\expnumber#1{\expandafter\ifx\csname#1\endcsname\relax 0%
+ \else \csname#1\endcsname \fi}
+ \def\advancenumber#1{\tempnum=\expnumber{#1}\relax
+ \advance\tempnum by 1
+ \expandafter\xdef\csname#1\endcsname{\the\tempnum}}
+ %
+ % #1 is the section text, which is what will be displayed in the
+ % outline by the pdf viewer. #2 is the pdf expression for the number
+ % of subentries (or empty, for subsubsections). #3 is the node text,
+ % which might be empty if this toc entry had no corresponding node.
+ % #4 is the page number
+ %
+ \def\dopdfoutline#1#2#3#4{%
+ % Generate a link to the node text if that exists; else, use the
+ % page number. We could generate a destination for the section
+ % text in the case where a section has no node, but it doesn't
+ % seem worth the trouble, since most documents are normally structured.
+ \edef\pdfoutlinedest{#3}%
+ \ifx\pdfoutlinedest\empty
+ \def\pdfoutlinedest{#4}%
+ \else
+ \txiescapepdf\pdfoutlinedest
+ \fi
+ %
+ % Also escape PDF chars in the display string.
+ \edef\pdfoutlinetext{#1}%
+ \txiescapepdf\pdfoutlinetext
+ %
+ \pdfoutline goto name{\pdfmkpgn{\pdfoutlinedest}}#2{\pdfoutlinetext}%
+ }
+ %
+ \def\pdfmakeoutlines{%
+ \begingroup
+ % Read toc silently, to get counts of subentries for \pdfoutline.
+ \def\partentry##1##2##3##4{}% ignore parts in the outlines
+ \def\numchapentry##1##2##3##4{%
+ \def\thischapnum{##2}%
+ \def\thissecnum{0}%
+ \def\thissubsecnum{0}%
+ }%
+ \def\numsecentry##1##2##3##4{%
+ \advancenumber{chap\thischapnum}%
+ \def\thissecnum{##2}%
+ \def\thissubsecnum{0}%
+ }%
+ \def\numsubsecentry##1##2##3##4{%
+ \advancenumber{sec\thissecnum}%
+ \def\thissubsecnum{##2}%
+ }%
+ \def\numsubsubsecentry##1##2##3##4{%
+ \advancenumber{subsec\thissubsecnum}%
+ }%
+ \def\thischapnum{0}%
+ \def\thissecnum{0}%
+ \def\thissubsecnum{0}%
+ %
+ % use \def rather than \let here because we redefine \chapentry et
+ % al. a second time, below.
+ \def\appentry{\numchapentry}%
+ \def\appsecentry{\numsecentry}%
+ \def\appsubsecentry{\numsubsecentry}%
+ \def\appsubsubsecentry{\numsubsubsecentry}%
+ \def\unnchapentry{\numchapentry}%
+ \def\unnsecentry{\numsecentry}%
+ \def\unnsubsecentry{\numsubsecentry}%
+ \def\unnsubsubsecentry{\numsubsubsecentry}%
+ \readdatafile{toc}%
+ %
+ % Read toc second time, this time actually producing the outlines.
+ % The `-' means take the \expnumber as the absolute number of
+ % subentries, which we calculated on our first read of the .toc above.
+ %
+ % We use the node names as the destinations.
+ \def\numchapentry##1##2##3##4{%
+ \dopdfoutline{##1}{count-\expnumber{chap##2}}{##3}{##4}}%
+ \def\numsecentry##1##2##3##4{%
+ \dopdfoutline{##1}{count-\expnumber{sec##2}}{##3}{##4}}%
+ \def\numsubsecentry##1##2##3##4{%
+ \dopdfoutline{##1}{count-\expnumber{subsec##2}}{##3}{##4}}%
+ \def\numsubsubsecentry##1##2##3##4{% count is always zero
+ \dopdfoutline{##1}{}{##3}{##4}}%
+ %
+ % PDF outlines are displayed using system fonts, instead of
+ % document fonts. Therefore we cannot use special characters,
+ % since the encoding is unknown. For example, the eogonek from
+ % Latin 2 (0xea) gets translated to a | character. Info from
+ % Staszek Wawrykiewicz, 19 Jan 2004 04:09:24 +0100.
+ %
+ % TODO this right, we have to translate 8-bit characters to
+ % their "best" equivalent, based on the @documentencoding. Too
+ % much work for too little return. Just use the ASCII equivalents
+ % we use for the index sort strings.
+ %
+ \indexnofonts
+ \setupdatafile
+ % We can have normal brace characters in the PDF outlines, unlike
+ % Texinfo index files. So set that up.
+ \def\{{\lbracecharliteral}%
+ \def\}{\rbracecharliteral}%
+ \catcode`\\=\active \otherbackslash
+ \input \tocreadfilename
+ \endgroup
+ }
+ {\catcode`[=1 \catcode`]=2
+ \catcode`{=\other \catcode`}=\other
+ \gdef\lbracecharliteral[{]%
+ \gdef\rbracecharliteral[}]%
+ ]
+ %
+ \def\skipspaces#1{\def\PP{#1}\def\D{|}%
+ \ifx\PP\D\let\nextsp\relax
+ \else\let\nextsp\skipspaces
+ \addtokens{\filename}{\PP}%
+ \advance\filenamelength by 1
+ \fi
+ \nextsp}
+ \def\getfilename#1{%
+ \filenamelength=0
+ % If we don't expand the argument now, \skipspaces will get
+ % snagged on things like "@value{foo}".
+ \edef\temp{#1}%
+ \expandafter\skipspaces\temp|\relax
+ }
+ \ifnum\pdftexversion < 14
+ \let \startlink \pdfannotlink
+ \else
+ \let \startlink \pdfstartlink
+ \fi
+ % make a live url in pdf output.
+ \def\pdfurl#1{%
+ \begingroup
+ % it seems we really need yet another set of dummies; have not
+ % tried to figure out what each command should do in the context
+ % of @url. for now, just make @/ a no-op, that's the only one
+ % people have actually reported a problem with.
+ %
+ \normalturnoffactive
+ address@hidden@}%
+ \let\/=\empty
+ \makevalueexpandable
+ % do we want to go so far as to use \indexnofonts instead of just
+ % special-casing \var here?
+ \def\var##1{##1}%
+ %
+ \leavevmode\setcolor{\urlcolor}%
+ \startlink attr{/Border [0 0 0]}%
+ user{/Subtype /Link /A << /S /URI /URI (#1) >>}%
+ \endgroup}
+ \def\pdfgettoks#1.{\setbox\boxA=\hbox{\toksA={#1.}\toksB={}\maketoks}}
+ \def\addtokens#1#2{\edef\addtoks{\noexpand#1={\the#1#2}}\addtoks}
+ \def\adn#1{\addtokens{\toksC}{#1}\global\countA=1\let\next=\maketoks}
+ \def\poptoks#1#2|ENDTOKS|{\let\first=#1\toksD={#1}\toksA={#2}}
+ \def\maketoks{%
+ \expandafter\poptoks\the\toksA|ENDTOKS|\relax
+ \ifx\first0\adn0
+ \else\ifx\first1\adn1 \else\ifx\first2\adn2 \else\ifx\first3\adn3
+ \else\ifx\first4\adn4 \else\ifx\first5\adn5 \else\ifx\first6\adn6
+ \else\ifx\first7\adn7 \else\ifx\first8\adn8 \else\ifx\first9\adn9
+ \else
+ \ifnum0=\countA\else\makelink\fi
+ \ifx\first.\let\next=\done\else
+ \let\next=\maketoks
+ \addtokens{\toksB}{\the\toksD}
+ \ifx\first,\addtokens{\toksB}{\space}\fi
+ \fi
+ \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi
+ \next}
+ \def\makelink{\addtokens{\toksB}%
+ {\noexpand\pdflink{\the\toksC}}\toksC={}\global\countA=0}
+ \def\pdflink#1{%
+ \startlink attr{/Border [0 0 0]} goto name{\pdfmkpgn{#1}}
+ \setcolor{\linkcolor}#1\endlink}
+ \def\done{\edef\st{\global\noexpand\toksA={\the\toksB}}\st}
+\else
+ % non-pdf mode
+ \let\pdfmkdest = \gobble
+ \let\pdfurl = \gobble
+ \let\endlink = \relax
+ \let\setcolor = \gobble
+ \let\pdfsetcolor = \gobble
+ \let\pdfmakeoutlines = \relax
+\fi % \ifx\pdfoutput
+
+%
+% @image support for XeTeX
+%
+\newif\ifxeteximgpdf
+\ifx\XeTeXrevision\thisisundefined
+\else
+ %
+ % #1 is image name, #2 width (might be empty/whitespace), #3 height (ditto).
+ \def\doxeteximage#1#2#3{%
+ \def\xeteximagewidth{#2}\setbox0 = \hbox{\ignorespaces #2}%
+ \def\xeteximageheight{#3}\setbox2 = \hbox{\ignorespaces #3}%
+ %
+ % XeTeX (and the PDF format) support .pdf, .png, .jpg (among
+ % others). Let's try in that order, PDF first since if
+ % someone has a scalable image, presumably better to use that than a
+ % bitmap.
+ \let\xeteximgext=\empty
+ \xeteximgpdffalse
+ \begingroup
+ \openin 1 #1.pdf \ifeof 1
+ \openin 1 #1.PDF \ifeof 1
+ \openin 1 #1.png \ifeof 1
+ \openin 1 #1.jpg \ifeof 1
+ \openin 1 #1.jpeg \ifeof 1
+ \openin 1 #1.JPG \ifeof 1
+ \errmessage{Could not find image file #1 for XeTeX}%
+ \else \gdef\xeteximgext{JPG}%
+ \fi
+ \else \gdef\xeteximgext{jpeg}%
+ \fi
+ \else \gdef\xeteximgext{jpg}%
+ \fi
+ \else \gdef\xeteximgext{png}%
+ \fi
+ \else \gdef\xeteximgext{PDF} \global\xeteximgpdftrue%
+ \fi
+ \else \gdef\xeteximgext{pdf} \global\xeteximgpdftrue%
+ \fi
+ \closein 1
+ \endgroup
+ %
+ \ifxeteximgpdf
+ \XeTeXpdffile "#1".\xeteximgext ""
+ \else
+ \XeTeXpicfile "#1".\xeteximgext ""
+ \fi
+ \ifdim \wd0 >0pt width \xeteximagewidth \fi
+ \ifdim \wd2 >0pt height \xeteximageheight \fi \relax
+ }
+\fi
+
+\message{fonts,}
+
+% Change the current font style to #1, remembering it in \curfontstyle.
+% For now, we do not accumulate font styles: @address@hidden prints foo in
+% italics, not bold italics.
+%
+\def\setfontstyle#1{%
+ \def\curfontstyle{#1}% not as a control sequence, because we are \edef'd.
+ \csname ten#1\endcsname % change the current font
+}
+
+% Select #1 fonts with the current style.
+%
+\def\selectfonts#1{\csname #1fonts\endcsname \csname\curfontstyle\endcsname}
+
+\def\rm{\fam=0 \setfontstyle{rm}}
+\def\it{\fam=\itfam \setfontstyle{it}}
+\def\sl{\fam=\slfam \setfontstyle{sl}}
+\def\bf{\fam=\bffam \setfontstyle{bf}}\def\bfstylename{bf}
+\def\tt{\fam=\ttfam \setfontstyle{tt}}
+
+% Unfortunately, we have to override this for titles and the like, since
+% in those cases "rm" is bold. Sigh.
+\def\rmisbold{\rm\def\curfontstyle{bf}}
+
+% Texinfo sort of supports the sans serif font style, which plain TeX does not.
+% So we set up a \sf.
+\newfam\sffam
+\def\sf{\fam=\sffam \setfontstyle{sf}}
+\let\li = \sf % Sometimes we call it \li, not \sf.
+
+% We don't need math for this font style.
+\def\ttsl{\setfontstyle{ttsl}}
+
+
+% Set the baselineskip to #1, and the lineskip and strut size
+% correspondingly. There is no deep meaning behind these magic numbers
+% used as factors; they just match (closely enough) what Knuth defined.
+%
+\def\lineskipfactor{.08333}
+\def\strutheightpercent{.70833}
+\def\strutdepthpercent {.29167}
+%
+% can get a sort of poor man's double spacing by redefining this.
+\def\baselinefactor{1}
+%
+\newdimen\textleading
+\def\setleading#1{%
+ \dimen0 = #1\relax
+ \normalbaselineskip = \baselinefactor\dimen0
+ \normallineskip = \lineskipfactor\normalbaselineskip
+ \normalbaselines
+ \setbox\strutbox =\hbox{%
+ \vrule width0pt height\strutheightpercent\baselineskip
+ depth \strutdepthpercent \baselineskip
+ }%
+}
+
+% PDF CMaps. See also LaTeX's t1.cmap.
+%
+% do nothing with this by default.
+\expandafter\let\csname cmapOT1\endcsname\gobble
+\expandafter\let\csname cmapOT1IT\endcsname\gobble
+\expandafter\let\csname cmapOT1TT\endcsname\gobble
+
+% if we are producing pdf, and we have \pdffontattr, then define cmaps.
+% (\pdffontattr was introduced many years ago, but people still run
+% older pdftex's; it's easy to conditionalize, so we do.)
+\ifpdf \ifx\pdffontattr\thisisundefined \else
+ \begingroup
+ \catcode`\^^M=\active \def^^M{^^J}% Output line endings as the ^^J char.
+ \catcode`\%=12 \immediate\pdfobj stream {%!PS-Adobe-3.0 Resource-CMap
+%%DocumentNeededResources: ProcSet (CIDInit)
+%%IncludeResource: ProcSet (CIDInit)
+%%BeginResource: CMap (TeX-OT1-0)
+%%Title: (TeX-OT1-0 TeX OT1 0)
+%%Version: 1.000
+%%EndComments
+/CIDInit /ProcSet findresource begin
+12 dict begin
+begincmap
+/CIDSystemInfo
+<< /Registry (TeX)
+/Ordering (OT1)
+/Supplement 0
+>> def
+/CMapName /TeX-OT1-0 def
+/CMapType 2 def
+1 begincodespacerange
+<00> <7F>
+endcodespacerange
+8 beginbfrange
+<00> <01> <0393>
+<09> <0A> <03A8>
+<23> <26> <0023>
+<28> <3B> <0028>
+<3F> <5B> <003F>
+<5D> <5E> <005D>
+<61> <7A> <0061>
+<7B> <7C> <2013>
+endbfrange
+40 beginbfchar
+<02> <0398>
+<03> <039B>
+<04> <039E>
+<05> <03A0>
+<06> <03A3>
+<07> <03D2>
+<08> <03A6>
+<0B> <00660066>
+<0C> <00660069>
+<0D> <0066006C>
+<0E> <006600660069>
+<0F> <00660066006C>
+<10> <0131>
+<11> <0237>
+<12> <0060>
+<13> <00B4>
+<14> <02C7>
+<15> <02D8>
+<16> <00AF>
+<17> <02DA>
+<18> <00B8>
+<19> <00DF>
+<1A> <00E6>
+<1B> <0153>
+<1C> <00F8>
+<1D> <00C6>
+<1E> <0152>
+<1F> <00D8>
+<21> <0021>
+<22> <201D>
+<27> <2019>
+<3C> <00A1>
+<3D> <003D>
+<3E> <00BF>
+<5C> <201C>
+<5F> <02D9>
+<60> <2018>
+<7D> <02DD>
+<7E> <007E>
+<7F> <00A8>
+endbfchar
+endcmap
+CMapName currentdict /CMap defineresource pop
+end
+end
+%%EndResource
+%%EOF
+ }\endgroup
+ \expandafter\edef\csname cmapOT1\endcsname#1{%
+ \pdffontattr#1{/ToUnicode \the\pdflastobj\space 0 R}%
+ }%
+%
+% \cmapOT1IT
+ \begingroup
+ \catcode`\^^M=\active \def^^M{^^J}% Output line endings as the ^^J char.
+ \catcode`\%=12 \immediate\pdfobj stream {%!PS-Adobe-3.0 Resource-CMap
+%%DocumentNeededResources: ProcSet (CIDInit)
+%%IncludeResource: ProcSet (CIDInit)
+%%BeginResource: CMap (TeX-OT1IT-0)
+%%Title: (TeX-OT1IT-0 TeX OT1IT 0)
+%%Version: 1.000
+%%EndComments
+/CIDInit /ProcSet findresource begin
+12 dict begin
+begincmap
+/CIDSystemInfo
+<< /Registry (TeX)
+/Ordering (OT1IT)
+/Supplement 0
+>> def
+/CMapName /TeX-OT1IT-0 def
+/CMapType 2 def
+1 begincodespacerange
+<00> <7F>
+endcodespacerange
+8 beginbfrange
+<00> <01> <0393>
+<09> <0A> <03A8>
+<25> <26> <0025>
+<28> <3B> <0028>
+<3F> <5B> <003F>
+<5D> <5E> <005D>
+<61> <7A> <0061>
+<7B> <7C> <2013>
+endbfrange
+42 beginbfchar
+<02> <0398>
+<03> <039B>
+<04> <039E>
+<05> <03A0>
+<06> <03A3>
+<07> <03D2>
+<08> <03A6>
+<0B> <00660066>
+<0C> <00660069>
+<0D> <0066006C>
+<0E> <006600660069>
+<0F> <00660066006C>
+<10> <0131>
+<11> <0237>
+<12> <0060>
+<13> <00B4>
+<14> <02C7>
+<15> <02D8>
+<16> <00AF>
+<17> <02DA>
+<18> <00B8>
+<19> <00DF>
+<1A> <00E6>
+<1B> <0153>
+<1C> <00F8>
+<1D> <00C6>
+<1E> <0152>
+<1F> <00D8>
+<21> <0021>
+<22> <201D>
+<23> <0023>
+<24> <00A3>
+<27> <2019>
+<3C> <00A1>
+<3D> <003D>
+<3E> <00BF>
+<5C> <201C>
+<5F> <02D9>
+<60> <2018>
+<7D> <02DD>
+<7E> <007E>
+<7F> <00A8>
+endbfchar
+endcmap
+CMapName currentdict /CMap defineresource pop
+end
+end
+%%EndResource
+%%EOF
+ }\endgroup
+ \expandafter\edef\csname cmapOT1IT\endcsname#1{%
+ \pdffontattr#1{/ToUnicode \the\pdflastobj\space 0 R}%
+ }%
+%
+% \cmapOT1TT
+ \begingroup
+ \catcode`\^^M=\active \def^^M{^^J}% Output line endings as the ^^J char.
+ \catcode`\%=12 \immediate\pdfobj stream {%!PS-Adobe-3.0 Resource-CMap
+%%DocumentNeededResources: ProcSet (CIDInit)
+%%IncludeResource: ProcSet (CIDInit)
+%%BeginResource: CMap (TeX-OT1TT-0)
+%%Title: (TeX-OT1TT-0 TeX OT1TT 0)
+%%Version: 1.000
+%%EndComments
+/CIDInit /ProcSet findresource begin
+12 dict begin
+begincmap
+/CIDSystemInfo
+<< /Registry (TeX)
+/Ordering (OT1TT)
+/Supplement 0
+>> def
+/CMapName /TeX-OT1TT-0 def
+/CMapType 2 def
+1 begincodespacerange
+<00> <7F>
+endcodespacerange
+5 beginbfrange
+<00> <01> <0393>
+<09> <0A> <03A8>
+<21> <26> <0021>
+<28> <5F> <0028>
+<61> <7E> <0061>
+endbfrange
+32 beginbfchar
+<02> <0398>
+<03> <039B>
+<04> <039E>
+<05> <03A0>
+<06> <03A3>
+<07> <03D2>
+<08> <03A6>
+<0B> <2191>
+<0C> <2193>
+<0D> <0027>
+<0E> <00A1>
+<0F> <00BF>
+<10> <0131>
+<11> <0237>
+<12> <0060>
+<13> <00B4>
+<14> <02C7>
+<15> <02D8>
+<16> <00AF>
+<17> <02DA>
+<18> <00B8>
+<19> <00DF>
+<1A> <00E6>
+<1B> <0153>
+<1C> <00F8>
+<1D> <00C6>
+<1E> <0152>
+<1F> <00D8>
+<20> <2423>
+<27> <2019>
+<60> <2018>
+<7F> <00A8>
+endbfchar
+endcmap
+CMapName currentdict /CMap defineresource pop
+end
+end
+%%EndResource
+%%EOF
+ }\endgroup
+ \expandafter\edef\csname cmapOT1TT\endcsname#1{%
+ \pdffontattr#1{/ToUnicode \the\pdflastobj\space 0 R}%
+ }%
+\fi\fi
+
+
+% Set the font macro #1 to the font named \fontprefix#2.
+% #3 is the font's design size, #4 is a scale factor, #5 is the CMap
+% encoding (only OT1, OT1IT and OT1TT are allowed, or empty to omit).
+% Example:
+% #1 = \textrm
+% #2 = \rmshape
+% #3 = 10
+% #4 = \mainmagstep
+% #5 = OT1
+%
+\def\setfont#1#2#3#4#5{%
+ \font#1=\fontprefix#2#3 scaled #4
+ \csname cmap#5\endcsname#1%
+}
+% This is what gets called when #5 of \setfont is empty.
+\let\cmap\gobble
+%
+% (end of cmaps)
+
+% Use cm as the default font prefix.
+% To specify the font prefix, you must define \fontprefix
+% before you read in texinfo.tex.
+\ifx\fontprefix\thisisundefined
+\def\fontprefix{cm}
+\fi
+% Support font families that don't use the same naming scheme as CM.
+\def\rmshape{r}
+\def\rmbshape{bx} % where the normal face is bold
+\def\bfshape{b}
+\def\bxshape{bx}
+\def\ttshape{tt}
+\def\ttbshape{tt}
+\def\ttslshape{sltt}
+\def\itshape{ti}
+\def\itbshape{bxti}
+\def\slshape{sl}
+\def\slbshape{bxsl}
+\def\sfshape{ss}
+\def\sfbshape{ss}
+\def\scshape{csc}
+\def\scbshape{csc}
+
+% Definitions for a main text size of 11pt. (The default in Texinfo.)
+%
+\def\definetextfontsizexi{%
+% Text fonts (11.2pt, magstep1).
+\def\textnominalsize{11pt}
+\edef\mainmagstep{\magstephalf}
+\setfont\textrm\rmshape{10}{\mainmagstep}{OT1}
+\setfont\texttt\ttshape{10}{\mainmagstep}{OT1TT}
+\setfont\textbf\bfshape{10}{\mainmagstep}{OT1}
+\setfont\textit\itshape{10}{\mainmagstep}{OT1IT}
+\setfont\textsl\slshape{10}{\mainmagstep}{OT1}
+\setfont\textsf\sfshape{10}{\mainmagstep}{OT1}
+\setfont\textsc\scshape{10}{\mainmagstep}{OT1}
+\setfont\textttsl\ttslshape{10}{\mainmagstep}{OT1TT}
+\font\texti=cmmi10 scaled \mainmagstep
+\font\textsy=cmsy10 scaled \mainmagstep
+\def\textecsize{1095}
+
+% A few fonts for @defun names and args.
+\setfont\defbf\bfshape{10}{\magstep1}{OT1}
+\setfont\deftt\ttshape{10}{\magstep1}{OT1TT}
+\setfont\defsl\slshape{10}{\magstep1}{OT1TT}
+\setfont\defttsl\ttslshape{10}{\magstep1}{OT1TT}
+\def\df{\let\tentt=\deftt \let\tenbf = \defbf
+\let\tenttsl=\defttsl \let\tensl=\defsl \bf}
+
+% Fonts for indices, footnotes, small examples (9pt).
+\def\smallnominalsize{9pt}
+\setfont\smallrm\rmshape{9}{1000}{OT1}
+\setfont\smalltt\ttshape{9}{1000}{OT1TT}
+\setfont\smallbf\bfshape{10}{900}{OT1}
+\setfont\smallit\itshape{9}{1000}{OT1IT}
+\setfont\smallsl\slshape{9}{1000}{OT1}
+\setfont\smallsf\sfshape{9}{1000}{OT1}
+\setfont\smallsc\scshape{10}{900}{OT1}
+\setfont\smallttsl\ttslshape{10}{900}{OT1TT}
+\font\smalli=cmmi9
+\font\smallsy=cmsy9
+\def\smallecsize{0900}
+
+% Fonts for small examples (8pt).
+\def\smallernominalsize{8pt}
+\setfont\smallerrm\rmshape{8}{1000}{OT1}
+\setfont\smallertt\ttshape{8}{1000}{OT1TT}
+\setfont\smallerbf\bfshape{10}{800}{OT1}
+\setfont\smallerit\itshape{8}{1000}{OT1IT}
+\setfont\smallersl\slshape{8}{1000}{OT1}
+\setfont\smallersf\sfshape{8}{1000}{OT1}
+\setfont\smallersc\scshape{10}{800}{OT1}
+\setfont\smallerttsl\ttslshape{10}{800}{OT1TT}
+\font\smalleri=cmmi8
+\font\smallersy=cmsy8
+\def\smallerecsize{0800}
+
+% Fonts for title page (20.4pt):
+\def\titlenominalsize{20pt}
+\setfont\titlerm\rmbshape{12}{\magstep3}{OT1}
+\setfont\titleit\itbshape{10}{\magstep4}{OT1IT}
+\setfont\titlesl\slbshape{10}{\magstep4}{OT1}
+\setfont\titlett\ttbshape{12}{\magstep3}{OT1TT}
+\setfont\titlettsl\ttslshape{10}{\magstep4}{OT1TT}
+\setfont\titlesf\sfbshape{17}{\magstep1}{OT1}
+\let\titlebf=\titlerm
+\setfont\titlesc\scbshape{10}{\magstep4}{OT1}
+\font\titlei=cmmi12 scaled \magstep3
+\font\titlesy=cmsy10 scaled \magstep4
+\def\titleecsize{2074}
+
+% Chapter (and unnumbered) fonts (17.28pt).
+\def\chapnominalsize{17pt}
+\setfont\chaprm\rmbshape{12}{\magstep2}{OT1}
+\setfont\chapit\itbshape{10}{\magstep3}{OT1IT}
+\setfont\chapsl\slbshape{10}{\magstep3}{OT1}
+\setfont\chaptt\ttbshape{12}{\magstep2}{OT1TT}
+\setfont\chapttsl\ttslshape{10}{\magstep3}{OT1TT}
+\setfont\chapsf\sfbshape{17}{1000}{OT1}
+\let\chapbf=\chaprm
+\setfont\chapsc\scbshape{10}{\magstep3}{OT1}
+\font\chapi=cmmi12 scaled \magstep2
+\font\chapsy=cmsy10 scaled \magstep3
+\def\chapecsize{1728}
+
+% Section fonts (14.4pt).
+\def\secnominalsize{14pt}
+\setfont\secrm\rmbshape{12}{\magstep1}{OT1}
+\setfont\secrmnotbold\rmshape{12}{\magstep1}{OT1}
+\setfont\secit\itbshape{10}{\magstep2}{OT1IT}
+\setfont\secsl\slbshape{10}{\magstep2}{OT1}
+\setfont\sectt\ttbshape{12}{\magstep1}{OT1TT}
+\setfont\secttsl\ttslshape{10}{\magstep2}{OT1TT}
+\setfont\secsf\sfbshape{12}{\magstep1}{OT1}
+\let\secbf\secrm
+\setfont\secsc\scbshape{10}{\magstep2}{OT1}
+\font\seci=cmmi12 scaled \magstep1
+\font\secsy=cmsy10 scaled \magstep2
+\def\sececsize{1440}
+
+% Subsection fonts (13.15pt).
+\def\ssecnominalsize{13pt}
+\setfont\ssecrm\rmbshape{12}{\magstephalf}{OT1}
+\setfont\ssecit\itbshape{10}{1315}{OT1IT}
+\setfont\ssecsl\slbshape{10}{1315}{OT1}
+\setfont\ssectt\ttbshape{12}{\magstephalf}{OT1TT}
+\setfont\ssecttsl\ttslshape{10}{1315}{OT1TT}
+\setfont\ssecsf\sfbshape{12}{\magstephalf}{OT1}
+\let\ssecbf\ssecrm
+\setfont\ssecsc\scbshape{10}{1315}{OT1}
+\font\sseci=cmmi12 scaled \magstephalf
+\font\ssecsy=cmsy10 scaled 1315
+\def\ssececsize{1200}
+
+% Reduced fonts for @acro in text (10pt).
+\def\reducednominalsize{10pt}
+\setfont\reducedrm\rmshape{10}{1000}{OT1}
+\setfont\reducedtt\ttshape{10}{1000}{OT1TT}
+\setfont\reducedbf\bfshape{10}{1000}{OT1}
+\setfont\reducedit\itshape{10}{1000}{OT1IT}
+\setfont\reducedsl\slshape{10}{1000}{OT1}
+\setfont\reducedsf\sfshape{10}{1000}{OT1}
+\setfont\reducedsc\scshape{10}{1000}{OT1}
+\setfont\reducedttsl\ttslshape{10}{1000}{OT1TT}
+\font\reducedi=cmmi10
+\font\reducedsy=cmsy10
+\def\reducedecsize{1000}
+
+\textleading = 13.2pt % line spacing for 11pt CM
+\textfonts % reset the current fonts
+\rm
+} % end of 11pt text font size definitions, \definetextfontsizexi
+
+
+% Definitions to make the main text be 10pt Computer Modern, with
+% section, chapter, etc., sizes following suit. This is for the GNU
+% Press printing of the Emacs 22 manual. Maybe other manuals in the
+% future. Used with @smallbook, which sets the leading to 12pt.
+%
+\def\definetextfontsizex{%
+% Text fonts (10pt).
+\def\textnominalsize{10pt}
+\edef\mainmagstep{1000}
+\setfont\textrm\rmshape{10}{\mainmagstep}{OT1}
+\setfont\texttt\ttshape{10}{\mainmagstep}{OT1TT}
+\setfont\textbf\bfshape{10}{\mainmagstep}{OT1}
+\setfont\textit\itshape{10}{\mainmagstep}{OT1IT}
+\setfont\textsl\slshape{10}{\mainmagstep}{OT1}
+\setfont\textsf\sfshape{10}{\mainmagstep}{OT1}
+\setfont\textsc\scshape{10}{\mainmagstep}{OT1}
+\setfont\textttsl\ttslshape{10}{\mainmagstep}{OT1TT}
+\font\texti=cmmi10 scaled \mainmagstep
+\font\textsy=cmsy10 scaled \mainmagstep
+\def\textecsize{1000}
+
+% A few fonts for @defun names and args.
+\setfont\defbf\bfshape{10}{\magstephalf}{OT1}
+\setfont\deftt\ttshape{10}{\magstephalf}{OT1TT}
+\setfont\defsl\slshape{10}{\magstephalf}{OT1TT}
+\setfont\defttsl\ttslshape{10}{\magstephalf}{OT1TT}
+\def\df{\let\tentt=\deftt \let\tenbf = \defbf
+\let\tensl=\defsl \let\tenttsl=\defttsl \bf}
+
+% Fonts for indices, footnotes, small examples (9pt).
+\def\smallnominalsize{9pt}
+\setfont\smallrm\rmshape{9}{1000}{OT1}
+\setfont\smalltt\ttshape{9}{1000}{OT1TT}
+\setfont\smallbf\bfshape{10}{900}{OT1}
+\setfont\smallit\itshape{9}{1000}{OT1IT}
+\setfont\smallsl\slshape{9}{1000}{OT1}
+\setfont\smallsf\sfshape{9}{1000}{OT1}
+\setfont\smallsc\scshape{10}{900}{OT1}
+\setfont\smallttsl\ttslshape{10}{900}{OT1TT}
+\font\smalli=cmmi9
+\font\smallsy=cmsy9
+\def\smallecsize{0900}
+
+% Fonts for small examples (8pt).
+\def\smallernominalsize{8pt}
+\setfont\smallerrm\rmshape{8}{1000}{OT1}
+\setfont\smallertt\ttshape{8}{1000}{OT1TT}
+\setfont\smallerbf\bfshape{10}{800}{OT1}
+\setfont\smallerit\itshape{8}{1000}{OT1IT}
+\setfont\smallersl\slshape{8}{1000}{OT1}
+\setfont\smallersf\sfshape{8}{1000}{OT1}
+\setfont\smallersc\scshape{10}{800}{OT1}
+\setfont\smallerttsl\ttslshape{10}{800}{OT1TT}
+\font\smalleri=cmmi8
+\font\smallersy=cmsy8
+\def\smallerecsize{0800}
+
+% Fonts for title page (20.4pt):
+\def\titlenominalsize{20pt}
+\setfont\titlerm\rmbshape{12}{\magstep3}{OT1}
+\setfont\titleit\itbshape{10}{\magstep4}{OT1IT}
+\setfont\titlesl\slbshape{10}{\magstep4}{OT1}
+\setfont\titlett\ttbshape{12}{\magstep3}{OT1TT}
+\setfont\titlettsl\ttslshape{10}{\magstep4}{OT1TT}
+\setfont\titlesf\sfbshape{17}{\magstep1}{OT1}
+\let\titlebf=\titlerm
+\setfont\titlesc\scbshape{10}{\magstep4}{OT1}
+\font\titlei=cmmi12 scaled \magstep3
+\font\titlesy=cmsy10 scaled \magstep4
+\def\titleecsize{2074}
+
+% Chapter fonts (14.4pt).
+\def\chapnominalsize{14pt}
+\setfont\chaprm\rmbshape{12}{\magstep1}{OT1}
+\setfont\chapit\itbshape{10}{\magstep2}{OT1IT}
+\setfont\chapsl\slbshape{10}{\magstep2}{OT1}
+\setfont\chaptt\ttbshape{12}{\magstep1}{OT1TT}
+\setfont\chapttsl\ttslshape{10}{\magstep2}{OT1TT}
+\setfont\chapsf\sfbshape{12}{\magstep1}{OT1}
+\let\chapbf\chaprm
+\setfont\chapsc\scbshape{10}{\magstep2}{OT1}
+\font\chapi=cmmi12 scaled \magstep1
+\font\chapsy=cmsy10 scaled \magstep2
+\def\chapecsize{1440}
+
+% Section fonts (12pt).
+\def\secnominalsize{12pt}
+\setfont\secrm\rmbshape{12}{1000}{OT1}
+\setfont\secit\itbshape{10}{\magstep1}{OT1IT}
+\setfont\secsl\slbshape{10}{\magstep1}{OT1}
+\setfont\sectt\ttbshape{12}{1000}{OT1TT}
+\setfont\secttsl\ttslshape{10}{\magstep1}{OT1TT}
+\setfont\secsf\sfbshape{12}{1000}{OT1}
+\let\secbf\secrm
+\setfont\secsc\scbshape{10}{\magstep1}{OT1}
+\font\seci=cmmi12
+\font\secsy=cmsy10 scaled \magstep1
+\def\sececsize{1200}
+
+% Subsection fonts (10pt).
+\def\ssecnominalsize{10pt}
+\setfont\ssecrm\rmbshape{10}{1000}{OT1}
+\setfont\ssecit\itbshape{10}{1000}{OT1IT}
+\setfont\ssecsl\slbshape{10}{1000}{OT1}
+\setfont\ssectt\ttbshape{10}{1000}{OT1TT}
+\setfont\ssecttsl\ttslshape{10}{1000}{OT1TT}
+\setfont\ssecsf\sfbshape{10}{1000}{OT1}
+\let\ssecbf\ssecrm
+\setfont\ssecsc\scbshape{10}{1000}{OT1}
+\font\sseci=cmmi10
+\font\ssecsy=cmsy10
+\def\ssececsize{1000}
+
+% Reduced fonts for @acro in text (9pt).
+\def\reducednominalsize{9pt}
+\setfont\reducedrm\rmshape{9}{1000}{OT1}
+\setfont\reducedtt\ttshape{9}{1000}{OT1TT}
+\setfont\reducedbf\bfshape{10}{900}{OT1}
+\setfont\reducedit\itshape{9}{1000}{OT1IT}
+\setfont\reducedsl\slshape{9}{1000}{OT1}
+\setfont\reducedsf\sfshape{9}{1000}{OT1}
+\setfont\reducedsc\scshape{10}{900}{OT1}
+\setfont\reducedttsl\ttslshape{10}{900}{OT1TT}
+\font\reducedi=cmmi9
+\font\reducedsy=cmsy9
+\def\reducedecsize{0900}
+
+\divide\parskip by 2 % reduce space between paragraphs
+\textleading = 12pt % line spacing for 10pt CM
+\textfonts % reset the current fonts
+\rm
+} % end of 10pt text font size definitions, \definetextfontsizex
+
+
+% We provide the user-level command
+% @fonttextsize 10
+% (or 11) to redefine the text font size. pt is assumed.
+%
+\def\xiword{11}
+\def\xword{10}
+\def\xwordpt{10pt}
+%
+\parseargdef\fonttextsize{%
+ \def\textsizearg{#1}%
+ %\wlog{doing @fonttextsize \textsizearg}%
+ %
+ % Set \globaldefs so that documents can use this inside @tex, since
+ % makeinfo 4.8 does not support it, but we need it nonetheless.
+ %
+ \begingroup \globaldefs=1
+ \ifx\textsizearg\xword \definetextfontsizex
+ \else \ifx\textsizearg\xiword \definetextfontsizexi
+ \else
+ \errhelp=\EMsimple
+ address@hidden only supports `10' or `11', not `\textsizearg'}
+ \fi\fi
+ \endgroup
+}
+
+% In order for the font changes to affect most math symbols and letters,
+% we have to define the \textfont of the standard families. We don't
+% bother to reset \scriptfont and \scriptscriptfont; awaiting user need.
+%
+\def\resetmathfonts{%
+ \textfont0=\tenrm \textfont1=\teni \textfont2=\tensy
+ \textfont\itfam=\tenit \textfont\slfam=\tensl \textfont\bffam=\tenbf
+ \textfont\ttfam=\tentt \textfont\sffam=\tensf
+}
+
+% The font-changing commands redefine the meanings of \tenSTYLE, instead
+% of just \STYLE. We do this because \STYLE needs to also set the
+% current \fam for math mode. Our \STYLE (e.g., \rm) commands hardwire
+% \tenSTYLE to set the current font.
+%
+% Each font-changing command also sets the names \lsize (one size lower)
+% and \lllsize (three sizes lower). These relative commands are used
+% in, e.g., the LaTeX logo and acronyms.
+%
+% This all needs generalizing, badly.
+%
+\def\textfonts{%
+ \let\tenrm=\textrm \let\tenit=\textit \let\tensl=\textsl
+ \let\tenbf=\textbf \let\tentt=\texttt \let\smallcaps=\textsc
+ \let\tensf=\textsf \let\teni=\texti \let\tensy=\textsy
+ \let\tenttsl=\textttsl
+ \def\curfontsize{text}%
+ \def\lsize{reduced}\def\lllsize{smaller}%
+ \resetmathfonts \setleading{\textleading}}
+\def\titlefonts{%
+ \let\tenrm=\titlerm \let\tenit=\titleit \let\tensl=\titlesl
+ \let\tenbf=\titlebf \let\tentt=\titlett \let\smallcaps=\titlesc
+ \let\tensf=\titlesf \let\teni=\titlei \let\tensy=\titlesy
+ \let\tenttsl=\titlettsl
+ \def\curfontsize{title}%
+ \def\lsize{chap}\def\lllsize{subsec}%
+ \resetmathfonts \setleading{27pt}}
+\def\titlefont#1{{\titlefonts\rmisbold #1}}
+\def\chapfonts{%
+ \let\tenrm=\chaprm \let\tenit=\chapit \let\tensl=\chapsl
+ \let\tenbf=\chapbf \let\tentt=\chaptt \let\smallcaps=\chapsc
+ \let\tensf=\chapsf \let\teni=\chapi \let\tensy=\chapsy
+ \let\tenttsl=\chapttsl
+ \def\curfontsize{chap}%
+ \def\lsize{sec}\def\lllsize{text}%
+ \resetmathfonts \setleading{19pt}}
+\def\secfonts{%
+ \let\tenrm=\secrm \let\tenit=\secit \let\tensl=\secsl
+ \let\tenbf=\secbf \let\tentt=\sectt \let\smallcaps=\secsc
+ \let\tensf=\secsf \let\teni=\seci \let\tensy=\secsy
+ \let\tenttsl=\secttsl
+ \def\curfontsize{sec}%
+ \def\lsize{subsec}\def\lllsize{reduced}%
+ \resetmathfonts \setleading{17pt}}
+\def\subsecfonts{%
+ \let\tenrm=\ssecrm \let\tenit=\ssecit \let\tensl=\ssecsl
+ \let\tenbf=\ssecbf \let\tentt=\ssectt \let\smallcaps=\ssecsc
+ \let\tensf=\ssecsf \let\teni=\sseci \let\tensy=\ssecsy
+ \let\tenttsl=\ssecttsl
+ \def\curfontsize{ssec}%
+ \def\lsize{text}\def\lllsize{small}%
+ \resetmathfonts \setleading{15pt}}
+\let\subsubsecfonts = \subsecfonts
+\def\reducedfonts{%
+ \let\tenrm=\reducedrm \let\tenit=\reducedit \let\tensl=\reducedsl
+ \let\tenbf=\reducedbf \let\tentt=\reducedtt \let\reducedcaps=\reducedsc
+ \let\tensf=\reducedsf \let\teni=\reducedi \let\tensy=\reducedsy
+ \let\tenttsl=\reducedttsl
+ \def\curfontsize{reduced}%
+ \def\lsize{small}\def\lllsize{smaller}%
+ \resetmathfonts \setleading{10.5pt}}
+\def\smallfonts{%
+ \let\tenrm=\smallrm \let\tenit=\smallit \let\tensl=\smallsl
+ \let\tenbf=\smallbf \let\tentt=\smalltt \let\smallcaps=\smallsc
+ \let\tensf=\smallsf \let\teni=\smalli \let\tensy=\smallsy
+ \let\tenttsl=\smallttsl
+ \def\curfontsize{small}%
+ \def\lsize{smaller}\def\lllsize{smaller}%
+ \resetmathfonts \setleading{10.5pt}}
+\def\smallerfonts{%
+ \let\tenrm=\smallerrm \let\tenit=\smallerit \let\tensl=\smallersl
+ \let\tenbf=\smallerbf \let\tentt=\smallertt \let\smallcaps=\smallersc
+ \let\tensf=\smallersf \let\teni=\smalleri \let\tensy=\smallersy
+ \let\tenttsl=\smallerttsl
+ \def\curfontsize{smaller}%
+ \def\lsize{smaller}\def\lllsize{smaller}%
+ \resetmathfonts \setleading{9.5pt}}
+
+% Fonts for short table of contents.
+\setfont\shortcontrm\rmshape{12}{1000}{OT1}
+\setfont\shortcontbf\bfshape{10}{\magstep1}{OT1} % no cmb12
+\setfont\shortcontsl\slshape{12}{1000}{OT1}
+\setfont\shortconttt\ttshape{12}{1000}{OT1TT}
+
+% Define these just so they can be easily changed for other fonts.
+\def\angleleft{$\langle$}
+\def\angleright{$\rangle$}
+
+% Set the fonts to use with the @small... environments.
+\let\smallexamplefonts = \smallfonts
+
+% About \smallexamplefonts. If we use \smallfonts (9pt), @smallexample
+% can fit this many characters:
+% 8.5x11=86 smallbook=72 a4=90 a5=69
+% If we use \scriptfonts (8pt), then we can fit this many characters:
+% 8.5x11=90+ smallbook=80 a4=90+ a5=77
+% For me, subjectively, the few extra characters that fit aren't worth
+% the additional smallness of 8pt. So I'm making the default 9pt.
+%
+% By the way, for comparison, here's what fits with @example (10pt):
+% 8.5x11=71 smallbook=60 a4=75 a5=58
+% --karl, 24jan03.
+
+% Set up the default fonts, so we can use them for creating boxes.
+%
+\definetextfontsizexi
+
+
+\message{markup,}
+
+% Check if we are currently using a typewriter font. Since all the
+% Computer Modern typewriter fonts have zero interword stretch (and
+% shrink), and it is reasonable to expect all typewriter fonts to have
+% this property, we can check that font parameter.
+%
+\def\ifmonospace{\ifdim\fontdimen3\font=0pt }
+
+% Markup style infrastructure. \defmarkupstylesetup\INITMACRO will
+% define and register \INITMACRO to be called on markup style changes.
+% \INITMACRO can check \currentmarkupstyle for the innermost
+% style and the set of \ifmarkupSTYLE switches for all styles
+% currently in effect.
+\newif\ifmarkupvar
+\newif\ifmarkupsamp
+\newif\ifmarkupkey
+%\newif\ifmarkupfile % @file == @samp.
+%\newif\ifmarkupoption % @option == @samp.
+\newif\ifmarkupcode
+\newif\ifmarkupkbd
+%\newif\ifmarkupenv % @env == @code.
+%\newif\ifmarkupcommand % @command == @code.
+\newif\ifmarkuptex % @tex (and part of @math, for now).
+\newif\ifmarkupexample
+\newif\ifmarkupverb
+\newif\ifmarkupverbatim
+
+\let\currentmarkupstyle\empty
+
+\def\setupmarkupstyle#1{%
+ \csname markup#1true\endcsname
+ \def\currentmarkupstyle{#1}%
+ \markupstylesetup
+}
+
+\let\markupstylesetup\empty
+
+\def\defmarkupstylesetup#1{%
+ \expandafter\def\expandafter\markupstylesetup
+ \expandafter{\markupstylesetup #1}%
+ \def#1%
+}
+
+% Markup style setup for left and right quotes.
+\defmarkupstylesetup\markupsetuplq{%
+ \expandafter\let\expandafter \temp
+ \csname markupsetuplq\currentmarkupstyle\endcsname
+ \ifx\temp\relax \markupsetuplqdefault \else \temp \fi
+}
+
+\defmarkupstylesetup\markupsetuprq{%
+ \expandafter\let\expandafter \temp
+ \csname markupsetuprq\currentmarkupstyle\endcsname
+ \ifx\temp\relax \markupsetuprqdefault \else \temp \fi
+}
+
+{
+\catcode`\'=\active
+\catcode`\`=\active
+
+\gdef\markupsetuplqdefault{\let`\lq}
+\gdef\markupsetuprqdefault{\let'\rq}
+
+\gdef\markupsetcodequoteleft{\let`\codequoteleft}
+\gdef\markupsetcodequoteright{\let'\codequoteright}
+}
+
+\let\markupsetuplqcode \markupsetcodequoteleft
+\let\markupsetuprqcode \markupsetcodequoteright
+%
+\let\markupsetuplqexample \markupsetcodequoteleft
+\let\markupsetuprqexample \markupsetcodequoteright
+%
+\let\markupsetuplqkbd \markupsetcodequoteleft
+\let\markupsetuprqkbd \markupsetcodequoteright
+%
+\let\markupsetuplqsamp \markupsetcodequoteleft
+\let\markupsetuprqsamp \markupsetcodequoteright
+%
+\let\markupsetuplqverb \markupsetcodequoteleft
+\let\markupsetuprqverb \markupsetcodequoteright
+%
+\let\markupsetuplqverbatim \markupsetcodequoteleft
+\let\markupsetuprqverbatim \markupsetcodequoteright
+
+% Allow an option to not use regular directed right quote/apostrophe
+% (char 0x27), but instead the undirected quote from cmtt (char 0x0d).
+% The undirected quote is ugly, so don't make it the default, but it
+% works for pasting with more pdf viewers (at least evince), the
+% lilypond developers report. xpdf does work with the regular 0x27.
+%
+\def\codequoteright{%
+ \expandafter\ifx\csname SETtxicodequoteundirected\endcsname\relax
+ \expandafter\ifx\csname SETcodequoteundirected\endcsname\relax
+ '%
+ \else \char'15 \fi
+ \else \char'15 \fi
+}
+%
+% and a similar option for the left quote char vs. a grave accent.
+% Modern fonts display ASCII 0x60 as a grave accent, so some people like
+% the code environments to do likewise.
+%
+\def\codequoteleft{%
+ \expandafter\ifx\csname SETtxicodequotebacktick\endcsname\relax
+ \expandafter\ifx\csname SETcodequotebacktick\endcsname\relax
+ % [Knuth] pp. 380,381,391
+ % \relax disables Spanish ligatures ?` and !` of \tt font.
+ \relax`%
+ \else \char'22 \fi
+ \else \char'22 \fi
+}
+
+% Commands to set the quote options.
+%
+\parseargdef\codequoteundirected{%
+ \def\temp{#1}%
+ \ifx\temp\onword
+ \expandafter\let\csname SETtxicodequoteundirected\endcsname
+ = t%
+ \else\ifx\temp\offword
+ \expandafter\let\csname SETtxicodequoteundirected\endcsname
+ = \relax
+ \else
+ \errhelp = \EMsimple
+ \errmessage{Unknown @codequoteundirected value `\temp', must be on|off}%
+ \fi\fi
+}
+%
+\parseargdef\codequotebacktick{%
+ \def\temp{#1}%
+ \ifx\temp\onword
+ \expandafter\let\csname SETtxicodequotebacktick\endcsname
+ = t%
+ \else\ifx\temp\offword
+ \expandafter\let\csname SETtxicodequotebacktick\endcsname
+ = \relax
+ \else
+ \errhelp = \EMsimple
+ \errmessage{Unknown @codequotebacktick value `\temp', must be on|off}%
+ \fi\fi
+}
+
+% [Knuth] pp. 380,381,391, disable Spanish ligatures ?` and !` of \tt font.
+\def\noligaturesquoteleft{\relax\lq}
+
+% Count depth in font-changes, for error checks
+\newcount\fontdepth \fontdepth=0
+
+% Font commands.
+
+% #1 is the font command (\sl or \it), #2 is the text to slant.
+% If we are in a monospaced environment, however, 1) always use \ttsl,
+% and 2) do not add an italic correction.
+\def\dosmartslant#1#2{%
+ \ifusingtt
+ {{\ttsl #2}\let\next=\relax}%
+ {\def\next{{#1#2}\futurelet\next\smartitaliccorrection}}%
+ \next
+}
+\def\smartslanted{\dosmartslant\sl}
+\def\smartitalic{\dosmartslant\it}
+
+% Output an italic correction unless \next (presumed to be the following
+% character) is such as not to need one.
+\def\smartitaliccorrection{%
+ \ifx\next,%
+ \else\ifx\next-%
+ \else\ifx\next.%
+ \else\ifx\next\.%
+ \else\ifx\next\comma%
+ \else\ptexslash
+ \fi\fi\fi\fi\fi
+ \aftersmartic
+}
+
+% Unconditional use \ttsl, and no ic. @var is set to this for defuns.
+\def\ttslanted#1{{\ttsl #1}}
+
+% @cite is like \smartslanted except unconditionally use \sl. We never want
+% ttsl for book titles, do we?
+\def\cite#1{{\sl #1}\futurelet\next\smartitaliccorrection}
+
+\def\aftersmartic{}
+\def\var#1{%
+ \let\saveaftersmartic = \aftersmartic
+ \def\aftersmartic{\null\let\aftersmartic=\saveaftersmartic}%
+ \smartslanted{#1}%
+}
+
+\let\i=\smartitalic
+\let\slanted=\smartslanted
+\let\dfn=\smartslanted
+\let\emph=\smartitalic
+
+% Explicit font changes: @r, @sc, undocumented @ii.
+\def\r#1{{\rm #1}} % roman font
+\def\sc#1{{\smallcaps#1}} % smallcaps font
+\def\ii#1{{\it #1}} % italic font
+
+% @b, explicit bold. Also @strong.
+\def\b#1{{\bf #1}}
+\let\strong=\b
+
+% @sansserif, explicit sans.
+\def\sansserif#1{{\sf #1}}
+
+% We can't just use \exhyphenpenalty, because that only has effect at
+% the end of a paragraph. Restore normal hyphenation at the end of the
+% group within which \nohyphenation is presumably called.
+%
+\def\nohyphenation{\hyphenchar\font = -1 \aftergroup\restorehyphenation}
+\def\restorehyphenation{\hyphenchar\font = `- }
+
+% Set sfcode to normal for the chars that usually have another value.
+% Can't use plain's \frenchspacing because it uses the `\x notation, and
+% sometimes \x has an active definition that messes things up.
+%
address@hidden
+ \def\plainfrenchspacing{%
+ address@hidden address@hidden address@hidden
+ \sfcode`\:address@hidden \sfcode`\;address@hidden \sfcode`\,address@hidden
+ \def\endofsentencespacefactor{1000}% for @. and friends
+ }
+ \def\plainnonfrenchspacing{%
+ \sfcode`\.3000\sfcode`\?3000\sfcode`\!3000
+ \sfcode`\:2000\sfcode`\;1500\sfcode`\,1250
+ \def\endofsentencespacefactor{3000}% for @. and friends
+ }
address@hidden
+\def\endofsentencespacefactor{3000}% default
+
+% @t, explicit typewriter.
+\def\t#1{%
+ {\tt \rawbackslash \plainfrenchspacing #1}%
+ \null
+}
+
+% @samp.
+\def\samp#1{{\setupmarkupstyle{samp}\lq\tclose{#1}\rq\null}}
+
+% @indicateurl is \samp, that is, with quotes.
+\let\indicateurl=\samp
+
+% @code (and similar) prints in typewriter, but with spaces the same
+% size as normal in the surrounding text, without hyphenation, etc.
+% This is a subroutine for that.
+\def\tclose#1{%
+ {%
+ % Change normal interword space to be same as for the current font.
+ \spaceskip = \fontdimen2\font
+ %
+ % Switch to typewriter.
+ \tt
+ %
+ % But `\ ' produces the large typewriter interword space.
+ \def\ {{\spaceskip = 0pt{} }}%
+ %
+ % Turn off hyphenation.
+ \nohyphenation
+ %
+ \rawbackslash
+ \plainfrenchspacing
+ #1%
+ }%
+ \null % reset spacefactor to 1000
+}
+
+% We *must* turn on hyphenation at `-' and `_' in @code.
+% (But see \codedashfinish below.)
+% Otherwise, it is too hard to avoid overfull hboxes
+% in the Emacs manual, the Library manual, etc.
+%
+% Unfortunately, TeX uses one parameter (\hyphenchar) to control
+% both hyphenation at - and hyphenation within words.
+% We must therefore turn them both off (\tclose does that)
+% and arrange explicitly to hyphenate at a dash. -- rms.
+{
+ \catcode`\-=\active \catcode`\_=\active
+ \catcode`\'=\active \catcode`\`=\active
+ \global\let'=\rq \global\let`=\lq % default definitions
+ %
+ \global\def\code{\begingroup
+ \setupmarkupstyle{code}%
+ % The following should really be moved into \setupmarkupstyle handlers.
+ \catcode\dashChar=\active \catcode\underChar=\active
+ \ifallowcodebreaks
+ \let-\codedash
+ \let_\codeunder
+ \else
+ \let-\normaldash
+ \let_\realunder
+ \fi
+ % Given -foo (with a single dash), we do not want to allow a break
+ % after the hyphen.
+ \global\let\codedashprev=\codedash
+ %
+ \codex
+ }
+ %
+ \gdef\codedash{\futurelet\next\codedashfinish}
+ \gdef\codedashfinish{%
+ \normaldash % always output the dash character itself.
+ %
+ % Now, output a discretionary to allow a line break, unless
+ % (a) the next character is a -, or
+ % (b) the preceding character is a -.
+ % E.g., given --posix, we do not want to allow a break after either -.
+ % Given --foo-bar, we do want to allow a break between the - and the b.
+ \ifx\next\codedash \else
+ \ifx\codedashprev\codedash
+ \else \discretionary{}{}{}\fi
+ \fi
+ % we need the space after the = for the case when \next itself is a
+ % space token; it would get swallowed otherwise. As in @code{- a}.
+ \global\let\codedashprev= \next
+ }
+}
+\def\normaldash{-}
+%
+\def\codex #1{\tclose{#1}\endgroup}
+
+\def\codeunder{%
+ % this is all so @address@hidden can work. In math mode, _
+ % is "active" (mathcode"8000) and \normalunderscore (or \char95, etc.)
+ % will therefore expand the active definition of _, which is us
+ % (inside @code that is), therefore an endless loop.
+ \ifusingtt{\ifmmode
+ \mathchar"075F % class 0=ordinary, family 7=ttfam, pos 0x5F=_.
+ \else\normalunderscore \fi
+ \discretionary{}{}{}}%
+ {\_}%
+}
+
+% An additional complication: the above will allow breaks after, e.g.,
+% each of the four underscores in __typeof__. This is bad.
+% @allowcodebreaks provides a document-level way to turn breaking at -
+% and _ on and off.
+%
+\newif\ifallowcodebreaks \allowcodebreakstrue
+
+\def\keywordtrue{true}
+\def\keywordfalse{false}
+
+\parseargdef\allowcodebreaks{%
+ \def\txiarg{#1}%
+ \ifx\txiarg\keywordtrue
+ \allowcodebreakstrue
+ \else\ifx\txiarg\keywordfalse
+ \allowcodebreaksfalse
+ \else
+ \errhelp = \EMsimple
+ \errmessage{Unknown @allowcodebreaks option `\txiarg', must be true|false}%
+ \fi\fi
+}
+
+% For @command, @env, @file, @option quotes seem unnecessary,
+% so use \code rather than \samp.
+\let\command=\code
+\let\env=\code
+\let\file=\code
+\let\option=\code
+
+% @uref (abbreviation for `urlref') aka @url takes an optional
+% (comma-separated) second argument specifying the text to display and
+% an optional third arg as text to display instead of (rather than in
+% addition to) the url itself. First (mandatory) arg is the url.
+
+% TeX-only option to allow changing PDF output to show only the second
+% arg (if given), and not the url (which is then just the link target).
+\newif\ifurefurlonlylink
+
+% The main macro is \urefbreak, which allows breaking at expected
+% places within the url. (There used to be another version, which
+% didn't support automatic breaking.)
+\def\urefbreak{\begingroup \urefcatcodes \dourefbreak}
+\let\uref=\urefbreak
+%
+\def\dourefbreak#1{\urefbreakfinish #1,,,\finish}
+\def\urefbreakfinish#1,#2,#3,#4\finish{% doesn't work in @example
+ \unsepspaces
+ \pdfurl{#1}%
+ \setbox0 = \hbox{\ignorespaces #3}%
+ \ifdim\wd0 > 0pt
+ \unhbox0 % third arg given, show only that
+ \else
+ \setbox0 = \hbox{\ignorespaces #2}% look for second arg
+ \ifdim\wd0 > 0pt
+ \ifpdf
+ \ifurefurlonlylink
+ % PDF plus option to not display url, show just arg
+ \unhbox0
+ \else
+ % PDF, normally display both arg and url for consistency,
+ % visibility, if the pdf is eventually used to print, etc.
+ \unhbox0\ (\urefcode{#1})%
+ \fi
+ \else
+ \unhbox0\ (\urefcode{#1})% DVI, always show arg and url
+ \fi
+ \else
+ \urefcode{#1}% only url given, so show it
+ \fi
+ \fi
+ \endlink
+\endgroup}
+
+% Allow line breaks around only a few characters (only).
+\def\urefcatcodes{%
+ \catcode`\&=\active \catcode`\.=\active
+ \catcode`\#=\active \catcode`\?=\active
+ \catcode`\/=\active
+}
+{
+ \urefcatcodes
+ %
+ \global\def\urefcode{\begingroup
+ \setupmarkupstyle{code}%
+ \urefcatcodes
+ \let&\urefcodeamp
+ \let.\urefcodedot
+ \let#\urefcodehash
+ \let?\urefcodequest
+ \let/\urefcodeslash
+ \codex
+ }
+ %
+ % By default, they are just regular characters.
+ \global\def&{\normalamp}
+ \global\def.{\normaldot}
+ \global\def#{\normalhash}
+ \global\def?{\normalquest}
+ \global\def/{\normalslash}
+}
+
+% we put a little stretch before and after the breakable chars, to help
+% line breaking of long url's. The unequal skips make look better in
+% cmtt at least, especially for dots.
+\def\urefprestretchamount{.13em}
+\def\urefpoststretchamount{.1em}
+\def\urefprestretch{\urefprebreak \hskip0pt plus\urefprestretchamount\relax}
+\def\urefpoststretch{\urefpostbreak \hskip0pt plus\urefprestretchamount\relax}
+%
+\def\urefcodeamp{\urefprestretch \&\urefpoststretch}
+\def\urefcodedot{\urefprestretch .\urefpoststretch}
+\def\urefcodehash{\urefprestretch \#\urefpoststretch}
+\def\urefcodequest{\urefprestretch ?\urefpoststretch}
+\def\urefcodeslash{\futurelet\next\urefcodeslashfinish}
+{
+ \catcode`\/=\active
+ \global\def\urefcodeslashfinish{%
+ \urefprestretch \slashChar
+ % Allow line break only after the final / in a sequence of
+ % slashes, to avoid line break between the slashes in http://.
+ \ifx\next/\else \urefpoststretch \fi
+ }
+}
+
+% One more complication: by default we'll break after the special
+% characters, but some people like to break before the special chars, so
+% allow that. Also allow no breaking at all, for manual control.
+%
+\parseargdef\urefbreakstyle{%
+ \def\txiarg{#1}%
+ \ifx\txiarg\wordnone
+ \def\urefprebreak{\nobreak}\def\urefpostbreak{\nobreak}
+ \else\ifx\txiarg\wordbefore
+ \def\urefprebreak{\allowbreak}\def\urefpostbreak{\nobreak}
+ \else\ifx\txiarg\wordafter
+ \def\urefprebreak{\nobreak}\def\urefpostbreak{\allowbreak}
+ \else
+ \errhelp = \EMsimple
+ \errmessage{Unknown @urefbreakstyle setting `\txiarg'}%
+ \fi\fi\fi
+}
+\def\wordafter{after}
+\def\wordbefore{before}
+\def\wordnone{none}
+
+\urefbreakstyle after
+
+% @url synonym for @uref, since that's how everyone uses it.
+%
+\let\url=\uref
+
+% rms does not like angle brackets --karl, 17may97.
+% So now @email is just like @uref, unless we are pdf.
+%
+%\def\email#1{\angleleft{\tt #1}\angleright}
+\ifpdf
+ \def\email#1{\doemail#1,,\finish}
+ \def\doemail#1,#2,#3\finish{\begingroup
+ \unsepspaces
+ \pdfurl{mailto:#1}%
+ \setbox0 = \hbox{\ignorespaces #2}%
+ \ifdim\wd0>0pt\unhbox0\else\code{#1}\fi
+ \endlink
+ \endgroup}
+\else
+ \let\email=\uref
+\fi
+
+% @kbdinputstyle -- arg is `distinct' (@kbd uses slanted tty font always),
+% `example' (@kbd uses ttsl only inside of @example and friends),
+% or `code' (@kbd uses normal tty font always).
+\parseargdef\kbdinputstyle{%
+ \def\txiarg{#1}%
+ \ifx\txiarg\worddistinct
+ \gdef\kbdexamplefont{\ttsl}\gdef\kbdfont{\ttsl}%
+ \else\ifx\txiarg\wordexample
+ \gdef\kbdexamplefont{\ttsl}\gdef\kbdfont{\tt}%
+ \else\ifx\txiarg\wordcode
+ \gdef\kbdexamplefont{\tt}\gdef\kbdfont{\tt}%
+ \else
+ \errhelp = \EMsimple
+ \errmessage{Unknown @kbdinputstyle setting `\txiarg'}%
+ \fi\fi\fi
+}
+\def\worddistinct{distinct}
+\def\wordexample{example}
+\def\wordcode{code}
+
+% Default is `distinct'.
+\kbdinputstyle distinct
+
+% @kbd is like @code, except that if the argument is just one @key command,
+% then @kbd has no effect.
+\def\kbd#1{{\def\look{#1}\expandafter\kbdsub\look??\par}}
+
+\def\xkey{\key}
+\def\kbdsub#1#2#3\par{%
+ \def\one{#1}\def\three{#3}\def\threex{??}%
+ \ifx\one\xkey\ifx\threex\three \key{#2}%
+ \else{\tclose{\kbdfont\setupmarkupstyle{kbd}\look}}\fi
+ \else{\tclose{\kbdfont\setupmarkupstyle{kbd}\look}}\fi
+}
+
+% definition of @key that produces a lozenge. Doesn't adjust to text size.
+%\setfont\keyrm\rmshape{8}{1000}{OT1}
+%\font\keysy=cmsy9
+%\def\key#1{{\keyrm\textfont2=\keysy \leavevmode\hbox{%
+% \raise0.4pt\hbox{\angleleft}\kern-.08em\vtop{%
+% \vbox{\hrule\kern-0.4pt
+% \hbox{\raise0.4pt\hbox{\vphantom{\angleleft}}#1}}%
+% \kern-0.4pt\hrule}%
+% \kern-.06em\raise0.4pt\hbox{\angleright}}}}
+
+% definition of @key with no lozenge. If the current font is already
+% monospace, don't change it; that way, we respect @kbdinputstyle. But
+% if it isn't monospace, then use \tt.
+%
+\def\key#1{{\setupmarkupstyle{key}%
+ \nohyphenation
+ \ifmonospace\else\tt\fi
+ #1}\null}
+
+% @clicksequence{File @click{} Open ...}
+\def\clicksequence#1{\begingroup #1\endgroup}
+
+% @clickstyle @arrow (by default)
+\parseargdef\clickstyle{\def\click{#1}}
+\def\click{\arrow}
+
+% Typeset a dimension, e.g., `in' or `pt'. The only reason for the
+% argument is to make the input look right: @dmn{pt} instead of @dmn{}pt.
+%
+\def\dmn#1{\thinspace #1}
+
+% @acronym for "FBI", "NATO", and the like.
+% We print this one point size smaller, since it's intended for
+% all-uppercase.
+%
+\def\acronym#1{\doacronym #1,,\finish}
+\def\doacronym#1,#2,#3\finish{%
+ {\selectfonts\lsize #1}%
+ \def\temp{#2}%
+ \ifx\temp\empty \else
+ \space ({\unsepspaces \ignorespaces \temp \unskip})%
+ \fi
+ \null % reset \spacefactor=1000
+}
+
+% @abbr for "Comput. J." and the like.
+% No font change, but don't do end-of-sentence spacing.
+%
+\def\abbr#1{\doabbr #1,,\finish}
+\def\doabbr#1,#2,#3\finish{%
+ {\plainfrenchspacing #1}%
+ \def\temp{#2}%
+ \ifx\temp\empty \else
+ \space ({\unsepspaces \ignorespaces \temp \unskip})%
+ \fi
+ \null % reset \spacefactor=1000
+}
+
+% @asis just yields its argument. Used with @table, for example.
+%
+\def\asis#1{#1}
+
+% @math outputs its argument in math mode.
+%
+% One complication: _ usually means subscripts, but it could also mean
+% an actual _ character, as in @address@hidden + 1}. So make
+% _ active, and distinguish by seeing if the current family is \slfam,
+% which is what @var uses.
+{
+ \catcode`\_ = \active
+ \gdef\mathunderscore{%
+ \catcode`\_=\active
+ \def_{\ifnum\fam=\slfam \_\else\sb\fi}%
+ }
+}
+% Another complication: we want \\ (and @\) to output a math (or tt) \.
+% FYI, plain.tex uses \\ as a temporary control sequence (for no
+% particular reason), but this is not advertised and we don't care.
+%
+% The \mathchar is class=0=ordinary, family=7=ttfam, position=5C=\.
+\def\mathbackslash{\ifnum\fam=\ttfam \mathchar"075C \else\backslash \fi}
+%
+\def\math{%
+ \ifmmode\else % only go into math if not in math mode already
+ \tex
+ \mathunderscore
+ \let\\ = \mathbackslash
+ \mathactive
+ % make the texinfo accent commands work in math mode
+ \let\"=\ddot
+ \let\'=\acute
+ \let\==\bar
+ \let\^=\hat
+ \let\`=\grave
+ \let\u=\breve
+ \let\v=\check
+ \let\~=\tilde
+ \let\dotaccent=\dot
+ % have to provide another name for sup operator
+ \let\mathopsup=\sup
+ $\expandafter\finishmath\fi
+}
+\def\finishmath#1{#1$\endgroup} % Close the group opened by \tex.
+
+% Some active characters (such as <) are spaced differently in math.
+% We have to reset their definitions in case the @math was an argument
+% to a command which sets the catcodes (such as @item or @section).
+%
+{
+ \catcode`^ = \active
+ \catcode`< = \active
+ \catcode`> = \active
+ \catcode`+ = \active
+ \catcode`' = \active
+ \gdef\mathactive{%
+ \let^ = \ptexhat
+ \let< = \ptexless
+ \let> = \ptexgtr
+ \let+ = \ptexplus
+ \let' = \ptexquoteright
+ }
+}
+
+% for @sub and @sup, if in math mode, just do a normal sub/superscript.
+% If in text, use math to place as sub/superscript, but switch
+% into text mode, with smaller fonts. This is a different font than the
+% one used for real math sub/superscripts (8pt vs. 7pt), but let's not
+% fix it (significant additions to font machinery) until someone notices.
+%
+\def\sub{\ifmmode \expandafter\sb \else \expandafter\finishsub\fi}
+\def\finishsub#1{$\sb{\hbox{\selectfonts\lllsize #1}}$}%
+%
+\def\sup{\ifmmode \expandafter\ptexsp \else \expandafter\finishsup\fi}
+\def\finishsup#1{$\ptexsp{\hbox{\selectfonts\lllsize #1}}$}%
+
+% @inlinefmt{FMTNAME,PROCESSED-TEXT} and @inlineraw{FMTNAME,RAW-TEXT}.
+% Ignore unless FMTNAME == tex; then it is like @iftex and @tex,
+% except specified as a normal braced arg, so no newlines to worry about.
+%
+\def\outfmtnametex{tex}
+%
+\long\def\inlinefmt#1{\doinlinefmt #1,\finish}
+\long\def\doinlinefmt#1,#2,\finish{%
+ \def\inlinefmtname{#1}%
+ \ifx\inlinefmtname\outfmtnametex \ignorespaces #2\fi
+}
+%
+% @inlinefmtifelse{FMTNAME,THEN-TEXT,ELSE-TEXT} expands THEN-TEXT if
+% FMTNAME is tex, else ELSE-TEXT.
+\long\def\inlinefmtifelse#1{\doinlinefmtifelse #1,,,\finish}
+\long\def\doinlinefmtifelse#1,#2,#3,#4,\finish{%
+ \def\inlinefmtname{#1}%
+ \ifx\inlinefmtname\outfmtnametex \ignorespaces #2\else \ignorespaces #3\fi
+}
+%
+% For raw, must switch into @tex before parsing the argument, to avoid
+% setting catcodes prematurely. Doing it this way means that, for
+% example, @inlineraw{html, foo{bar} gets a parse error instead of being
+% ignored. But this isn't important because if people want a literal
+% *right* brace they would have to use a command anyway, so they may as
+% well use a command to get a left brace too. We could re-use the
+% delimiter character idea from \verb, but it seems like overkill.
+%
+\long\def\inlineraw{\tex \doinlineraw}
+\long\def\doinlineraw#1{\doinlinerawtwo #1,\finish}
+\def\doinlinerawtwo#1,#2,\finish{%
+ \def\inlinerawname{#1}%
+ \ifx\inlinerawname\outfmtnametex \ignorespaces #2\fi
+ \endgroup % close group opened by \tex.
+}
+
+% @inlineifset{VAR, TEXT} expands TEXT if VAR is @set.
+%
+\long\def\inlineifset#1{\doinlineifset #1,\finish}
+\long\def\doinlineifset#1,#2,\finish{%
+ \def\inlinevarname{#1}%
+ \expandafter\ifx\csname SET\inlinevarname\endcsname\relax
+ \else\ignorespaces#2\fi
+}
+
+% @inlineifclear{VAR, TEXT} expands TEXT if VAR is not @set.
+%
+\long\def\inlineifclear#1{\doinlineifclear #1,\finish}
+\long\def\doinlineifclear#1,#2,\finish{%
+ \def\inlinevarname{#1}%
+ \expandafter\ifx\csname SET\inlinevarname\endcsname\relax \ignorespaces#2\fi
+}
+
+
+\message{glyphs,}
+% and logos.
+
+% @@ prints an @, as does @atchar{}.
address@hidden }
+\let\atchar=\@
+
+% @{ @} @lbracechar{} @rbracechar{} all generate brace characters.
+% Unless we're in typewriter, use \ecfont because the CM text fonts do
+% not have braces, and we don't want to switch into math.
+\def\mylbrace{{\ifmonospace\else\ecfont\fi \char123}}
+\def\myrbrace{{\ifmonospace\else\ecfont\fi \char125}}
+\let\{=\mylbrace \let\lbracechar=\{
+\let\}=\myrbrace \let\rbracechar=\}
+\begingroup
+ % Definitions to produce \{ and \} commands for indices,
+ % and @{ and @} for the aux/toc files.
+ \catcode`\{ = \other \catcode`\} = \other
+ \catcode`\[ = 1 \catcode`\] = 2
+ \catcode`\! = 0 \catcode`\\ = \other
+ !gdef!lbracecmd[\{]%
+ !gdef!rbracecmd[\}]%
+ address@hidden
+ address@hidden
+!endgroup
+
+% @comma{} to avoid , parsing problems.
+\let\comma = ,
+
+% Accents: @, @dotaccent @ringaccent @ubaraccent @udotaccent
+% Others are defined by plain TeX: @` @' @" @^ @~ @= @u @v @H.
+\let\, = \ptexc
+\let\dotaccent = \ptexdot
+\def\ringaccent#1{{\accent23 #1}}
+\let\tieaccent = \ptext
+\let\ubaraccent = \ptexb
+\let\udotaccent = \d
+
+% Other special characters: @questiondown @exclamdown @ordf @ordm
+% Plain TeX defines: @AA @AE @O @OE @L (plus lowercase versions) @ss.
+\def\questiondown{?`}
+\def\exclamdown{!`}
+\def\ordf{\leavevmode\raise1ex\hbox{\selectfonts\lllsize \underbar{a}}}
+\def\ordm{\leavevmode\raise1ex\hbox{\selectfonts\lllsize \underbar{o}}}
+
+% Dotless i and dotless j, used for accents.
+\def\imacro{i}
+\def\jmacro{j}
+\def\dotless#1{%
+ \def\temp{#1}%
+ \ifx\temp\imacro \ifmmode\imath \else\ptexi \fi
+ \else\ifx\temp\jmacro \ifmmode\jmath \else\j \fi
+ \else address@hidden can be used only with i or j}%
+ \fi\fi
+}
+
+% The \TeX{} logo, as in plain, but resetting the spacing so that a
+% period following counts as ending a sentence. (Idea found in latex.)
+%
+\edef\TeX{\TeX \spacefactor=1000 }
+
+% @LaTeX{} logo. Not quite the same results as the definition in
+% latex.ltx, since we use a different font for the raised A; it's most
+% convenient for us to use an explicitly smaller font, rather than using
+% the \scriptstyle font (since we don't reset \scriptstyle and
+% \scriptscriptstyle).
+%
+\def\LaTeX{%
+ L\kern-.36em
+ {\setbox0=\hbox{T}%
+ \vbox to \ht0{\hbox{%
+ \ifx\textnominalsize\xwordpt
+ % for 10pt running text, \lllsize (8pt) is too small for the A in LaTeX.
+ % Revert to plain's \scriptsize, which is 7pt.
+ \count255=\the\fam $\fam\count255 \scriptstyle A$%
+ \else
+ % For 11pt, we can use our lllsize.
+ \selectfonts\lllsize A%
+ \fi
+ }%
+ \vss
+ }}%
+ \kern-.15em
+ \TeX
+}
+
+% Some math mode symbols. Define \ensuremath to switch into math mode
+% unless we are already there. Expansion tricks may not be needed here,
+% but safer, and can't hurt.
+\def\ensuremath{\ifmmode \expandafter\asis \else\expandafter\ensuredmath \fi}
+\def\ensuredmath#1{$\relax#1$}
+%
+\def\bullet{\ensuremath\ptexbullet}
+\def\geq{\ensuremath\ge}
+\def\leq{\ensuremath\le}
+\def\minus{\ensuremath-}
+
+% @dots{} outputs an ellipsis using the current font.
+% We do .5em per period so that it has the same spacing in the cm
+% typewriter fonts as three actual period characters; on the other hand,
+% in other typewriter fonts three periods are wider than 1.5em. So do
+% whichever is larger.
+%
+\def\dots{%
+ \leavevmode
+ \setbox0=\hbox{...}% get width of three periods
+ \ifdim\wd0 > 1.5em
+ \dimen0 = \wd0
+ \else
+ \dimen0 = 1.5em
+ \fi
+ \hbox to \dimen0{%
+ \hskip 0pt plus.25fil
+ .\hskip 0pt plus1fil
+ .\hskip 0pt plus1fil
+ .\hskip 0pt plus.5fil
+ }%
+}
+
+% @enddots{} is an end-of-sentence ellipsis.
+%
+\def\enddots{%
+ \dots
+ \spacefactor=\endofsentencespacefactor
+}
+
+% @point{}, @result{}, @expansion{}, @print{}, @equiv{}.
+%
+% Since these characters are used in examples, they should be an even number of
+% \tt widths. Each \tt character is 1en, so two makes it 1em.
+%
+\def\point{$\star$}
+\def\arrow{\leavevmode\raise.05ex\hbox to 1em{\hfil$\rightarrow$\hfil}}
+\def\result{\leavevmode\raise.05ex\hbox to 1em{\hfil$\Rightarrow$\hfil}}
+\def\expansion{\leavevmode\hbox to 1em{\hfil$\mapsto$\hfil}}
+\def\print{\leavevmode\lower.1ex\hbox to 1em{\hfil$\dashv$\hfil}}
+\def\equiv{\leavevmode\hbox to 1em{\hfil$\ptexequiv$\hfil}}
+
+% The @error{} command.
+% Adapted from the TeXbook's \boxit.
+%
+\newbox\errorbox
+%
+{\tentt \global\dimen0 = 3em}% Width of the box.
+\dimen2 = .55pt % Thickness of rules
+% The text. (`r' is open on the right, `e' somewhat less so on the left.)
+\setbox0 = \hbox{\kern-.75pt \reducedsf \putworderror\kern-1.5pt}
+%
+\setbox\errorbox=\hbox to \dimen0{\hfil
+ \hsize = \dimen0 \advance\hsize by -5.8pt % Space to left+right.
+ \advance\hsize by -2\dimen2 % Rules.
+ \vbox{%
+ \hrule height\dimen2
+ \hbox{\vrule width\dimen2 \kern3pt % Space to left of text.
+ \vtop{\kern2.4pt \box0 \kern2.4pt}% Space above/below.
+ \kern3pt\vrule width\dimen2}% Space to right.
+ \hrule height\dimen2}
+ \hfil}
+%
+\def\error{\leavevmode\lower.7ex\copy\errorbox}
+
+% @pounds{} is a sterling sign, which Knuth put in the CM italic font.
+%
+\def\pounds{{\it\$}}
+
+% @euro{} comes from a separate font, depending on the current style.
+% We use the free feym* fonts from the eurosym package by Henrik
+% Theiling, which support regular, slanted, bold and bold slanted (and
+% "outlined" (blackboard board, sort of) versions, which we don't need).
+% It is available from http://www.ctan.org/tex-archive/fonts/eurosym.
+%
+% Although only regular is the truly official Euro symbol, we ignore
+% that. The Euro is designed to be slightly taller than the regular
+% font height.
+%
+% feymr - regular
+% feymo - slanted
+% feybr - bold
+% feybo - bold slanted
+%
+% There is no good (free) typewriter version, to my knowledge.
+% A feymr10 euro is ~7.3pt wide, while a normal cmtt10 char is ~5.25pt wide.
+% Hmm.
+%
+% Also doesn't work in math. Do we need to do math with euro symbols?
+% Hope not.
+%
+%
+\def\euro{{\eurofont e}}
+\def\eurofont{%
+ % We set the font at each command, rather than predefining it in
+ % \textfonts and the other font-switching commands, so that
+ % installations which never need the symbol don't have to have the
+ % font installed.
+ %
+ % There is only one designed size (nominal 10pt), so we always scale
+ % that to the current nominal size.
+ %
+ % By the way, simply using "at 1em" works for cmr10 and the like, but
+ % does not work for cmbx10 and other extended/shrunken fonts.
+ %
+ \def\eurosize{\csname\curfontsize nominalsize\endcsname}%
+ %
+ \ifx\curfontstyle\bfstylename
+ % bold:
+ \font\thiseurofont = \ifusingit{feybo10}{feybr10} at \eurosize
+ \else
+ % regular:
+ \font\thiseurofont = \ifusingit{feymo10}{feymr10} at \eurosize
+ \fi
+ \thiseurofont
+}
+
+% Glyphs from the EC fonts. We don't use \let for the aliases, because
+% sometimes we redefine the original macro, and the alias should reflect
+% the redefinition.
+%
+% Use LaTeX names for the Icelandic letters.
+\def\DH{{\ecfont \char"D0}} % Eth
+\def\dh{{\ecfont \char"F0}} % eth
+\def\TH{{\ecfont \char"DE}} % Thorn
+\def\th{{\ecfont \char"FE}} % thorn
+%
+\def\guillemetleft{{\ecfont \char"13}}
+\def\guillemotleft{\guillemetleft}
+\def\guillemetright{{\ecfont \char"14}}
+\def\guillemotright{\guillemetright}
+\def\guilsinglleft{{\ecfont \char"0E}}
+\def\guilsinglright{{\ecfont \char"0F}}
+\def\quotedblbase{{\ecfont \char"12}}
+\def\quotesinglbase{{\ecfont \char"0D}}
+%
+% This positioning is not perfect (see the ogonek LaTeX package), but
+% we have the precomposed glyphs for the most common cases. We put the
+% tests to use those glyphs in the single \ogonek macro so we have fewer
+% dummy definitions to worry about for index entries, etc.
+%
+% ogonek is also used with other letters in Lithuanian (IOU), but using
+% the precomposed glyphs for those is not so easy since they aren't in
+% the same EC font.
+\def\ogonek#1{{%
+ \def\temp{#1}%
+ \ifx\temp\macrocharA\Aogonek
+ \else\ifx\temp\macrochara\aogonek
+ \else\ifx\temp\macrocharE\Eogonek
+ \else\ifx\temp\macrochare\eogonek
+ \else
+ \ecfont \setbox0=\hbox{#1}%
+ \ifdim\ht0=1ex\accent"0C #1%
+ \else\ooalign{\unhbox0\crcr\hidewidth\char"0C \hidewidth}%
+ \fi
+ \fi\fi\fi\fi
+ }%
+}
+\def\Aogonek{{\ecfont \char"81}}\def\macrocharA{A}
+\def\aogonek{{\ecfont \char"A1}}\def\macrochara{a}
+\def\Eogonek{{\ecfont \char"86}}\def\macrocharE{E}
+\def\eogonek{{\ecfont \char"A6}}\def\macrochare{e}
+%
+% Use the European Computer Modern fonts (cm-super in outline format)
+% for non-CM glyphs. That is ec* for regular text and tc* for the text
+% companion symbols (LaTeX TS1 encoding). Both are part of the ec
+% package and follow the same conventions.
+%
+\def\ecfont{\etcfont{e}}
+\def\tcfont{\etcfont{t}}
+%
+\def\etcfont#1{%
+ % We can't distinguish serif/sans and italic/slanted, but this
+ % is used for crude hacks anyway (like adding French and German
+ % quotes to documents typeset with CM, where we lose kerning), so
+ % hopefully nobody will notice/care.
+ \edef\ecsize{\csname\curfontsize ecsize\endcsname}%
+ \edef\nominalsize{\csname\curfontsize nominalsize\endcsname}%
+ \ifmonospace
+ % typewriter:
+ \font\thisecfont = #1ctt\ecsize \space at \nominalsize
+ \else
+ \ifx\curfontstyle\bfstylename
+ % bold:
+ \font\thisecfont = #1cb\ifusingit{i}{x}\ecsize \space at \nominalsize
+ \else
+ % regular:
+ \font\thisecfont = #1c\ifusingit{ti}{rm}\ecsize \space at \nominalsize
+ \fi
+ \fi
+ \thisecfont
+}
+
+% @registeredsymbol - R in a circle. The font for the R should really
+% be smaller yet, but lllsize is the best we can do for now.
+% Adapted from the plain.tex definition of \copyright.
+%
+\def\registeredsymbol{%
+ $^{{\ooalign{\hfil\raise.07ex\hbox{\selectfonts\lllsize R}%
+ \hfil\crcr\Orb}}%
+ }$%
+}
+
+% @textdegree - the normal degrees sign.
+%
+\def\textdegree{$^\circ$}
+
+% Laurent Siebenmann reports \Orb undefined with:
+% Textures 1.7.7 (preloaded format=plain 93.10.14) (68K) 16 APR 2004 02:38
+% so we'll define it if necessary.
+%
+\ifx\Orb\thisisundefined
+\def\Orb{\mathhexbox20D}
+\fi
+
+% Quotes.
+\chardef\quotedblleft="5C
+\chardef\quotedblright=`\"
+\chardef\quoteleft=`\`
+\chardef\quoteright=`\'
+
+
+\message{page headings,}
+
+\newskip\titlepagetopglue \titlepagetopglue = 1.5in
+\newskip\titlepagebottomglue \titlepagebottomglue = 2pc
+
+% First the title page. Must do @settitle before @titlepage.
+\newif\ifseenauthor
+\newif\iffinishedtitlepage
+
+% Do an implicit @contents or @shortcontents after @end titlepage if the
+% user says @setcontentsaftertitlepage or @setshortcontentsaftertitlepage.
+%
+\newif\ifsetcontentsaftertitlepage
+ \let\setcontentsaftertitlepage = \setcontentsaftertitlepagetrue
+\newif\ifsetshortcontentsaftertitlepage
+ \let\setshortcontentsaftertitlepage = \setshortcontentsaftertitlepagetrue
+
+\parseargdef\shorttitlepage{%
+ \begingroup \hbox{}\vskip 1.5in \chaprm \centerline{#1}%
+ \endgroup\page\hbox{}\page}
+
+\envdef\titlepage{%
+ % Open one extra group, as we want to close it in the middle of \Etitlepage.
+ \begingroup
+ \parindent=0pt \textfonts
+ % Leave some space at the very top of the page.
+ \vglue\titlepagetopglue
+ % No rule at page bottom unless we print one at the top with @title.
+ \finishedtitlepagetrue
+ %
+ % Most title ``pages'' are actually two pages long, with space
+ % at the top of the second. We don't want the ragged left on the second.
+ \let\oldpage = \page
+ \def\page{%
+ \iffinishedtitlepage\else
+ \finishtitlepage
+ \fi
+ \let\page = \oldpage
+ \page
+ \null
+ }%
+}
+
+\def\Etitlepage{%
+ \iffinishedtitlepage\else
+ \finishtitlepage
+ \fi
+ % It is important to do the page break before ending the group,
+ % because the headline and footline are only empty inside the group.
+ % If we use the new definition of \page, we always get a blank page
+ % after the title page, which we certainly don't want.
+ \oldpage
+ \endgroup
+ %
+ % Need this before the \...aftertitlepage checks so that if they are
+ % in effect the toc pages will come out with page numbers.
+ \HEADINGSon
+ %
+ % If they want short, they certainly want long too.
+ \ifsetshortcontentsaftertitlepage
+ \shortcontents
+ \contents
+ \global\let\shortcontents = \relax
+ \global\let\contents = \relax
+ \fi
+ %
+ \ifsetcontentsaftertitlepage
+ \contents
+ \global\let\contents = \relax
+ \global\let\shortcontents = \relax
+ \fi
+}
+
+\def\finishtitlepage{%
+ \vskip4pt \hrule height 2pt width \hsize
+ \vskip\titlepagebottomglue
+ \finishedtitlepagetrue
+}
+
+% Settings used for typesetting titles: no hyphenation, no indentation,
+% don't worry much about spacing, ragged right. This should be used
+% inside a \vbox, and fonts need to be set appropriately first. Because
+% it is always used for titles, nothing else, we call \rmisbold. \par
+% should be specified before the end of the \vbox, since a vbox is a group.
+%
+\def\raggedtitlesettings{%
+ \rmisbold
+ \hyphenpenalty=10000
+ \parindent=0pt
+ \tolerance=5000
+ \ptexraggedright
+}
+
+% Macros to be used within @titlepage:
+
+\let\subtitlerm=\tenrm
+\def\subtitlefont{\subtitlerm \normalbaselineskip = 13pt \normalbaselines}
+
+\parseargdef\title{%
+ \checkenv\titlepage
+ \vbox{\titlefonts \raggedtitlesettings #1\par}%
+ % print a rule at the page bottom also.
+ \finishedtitlepagefalse
+ \vskip4pt \hrule height 4pt width \hsize \vskip4pt
+}
+
+\parseargdef\subtitle{%
+ \checkenv\titlepage
+ {\subtitlefont \rightline{#1}}%
+}
+
+% @author should come last, but may come many times.
+% It can also be used inside @quotation.
+%
+\parseargdef\author{%
+ \def\temp{\quotation}%
+ \ifx\thisenv\temp
+ \def\quotationauthor{#1}% printed in \Equotation.
+ \else
+ \checkenv\titlepage
+ \ifseenauthor\else \vskip 0pt plus 1filll \seenauthortrue \fi
+ {\secfonts\rmisbold \leftline{#1}}%
+ \fi
+}
+
+
+% Set up page headings and footings.
+
+\let\thispage=\folio
+
+\newtoks\evenheadline % headline on even pages
+\newtoks\oddheadline % headline on odd pages
+\newtoks\evenfootline % footline on even pages
+\newtoks\oddfootline % footline on odd pages
+
+% Now make \makeheadline and \makefootline in Plain TeX use those variables
+\headline={{\textfonts\rm \ifodd\pageno \the\oddheadline
+ \else \the\evenheadline \fi}}
+\footline={{\textfonts\rm \ifodd\pageno \the\oddfootline
+ \else \the\evenfootline \fi}\HEADINGShook}
+\let\HEADINGShook=\relax
+
+% Commands to set those variables.
+% For example, this is what @headings on does
+% @evenheading @thistitle|@thispage|@thischapter
+% @oddheading @thischapter|@thispage|@thistitle
+% @evenfooting @thisfile||
+% @oddfooting ||@thisfile
+
+
+\def\evenheading{\parsearg\evenheadingxxx}
+\def\evenheadingxxx #1{\evenheadingyyy #1\|\|\|\|\finish}
+\def\evenheadingyyy #1\|#2\|#3\|#4\finish{%
+\global\evenheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}
+
+\def\oddheading{\parsearg\oddheadingxxx}
+\def\oddheadingxxx #1{\oddheadingyyy #1\|\|\|\|\finish}
+\def\oddheadingyyy #1\|#2\|#3\|#4\finish{%
+\global\oddheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}
+
+\parseargdef\everyheading{\oddheadingxxx{#1}\evenheadingxxx{#1}}%
+
+\def\evenfooting{\parsearg\evenfootingxxx}
+\def\evenfootingxxx #1{\evenfootingyyy #1\|\|\|\|\finish}
+\def\evenfootingyyy #1\|#2\|#3\|#4\finish{%
+\global\evenfootline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}
+
+\def\oddfooting{\parsearg\oddfootingxxx}
+\def\oddfootingxxx #1{\oddfootingyyy #1\|\|\|\|\finish}
+\def\oddfootingyyy #1\|#2\|#3\|#4\finish{%
+ \global\oddfootline = {\rlap{\centerline{#2}}\line{#1\hfil#3}}%
+ %
+ % Leave some space for the footline. Hopefully ok to assume
+ % @evenfooting will not be used by itself.
+ \global\advance\pageheight by -12pt
+ \global\advance\vsize by -12pt
+}
+
+\parseargdef\everyfooting{\oddfootingxxx{#1}\evenfootingxxx{#1}}
+
+% @evenheadingmarks top \thischapter <- chapter at the top of a page
+% @evenheadingmarks bottom \thischapter <- chapter at the bottom of a page
+%
+% The same set of arguments for:
+%
+% @oddheadingmarks
+% @evenfootingmarks
+% @oddfootingmarks
+% @everyheadingmarks
+% @everyfootingmarks
+
+% These define \getoddheadingmarks, \getevenheadingmarks,
+% \getoddfootingmarks, and \getevenfootingmarks, each to one of
+% \gettopheadingmarks, \getbottomheadingmarks.
+%
+\def\evenheadingmarks{\headingmarks{even}{heading}}
+\def\oddheadingmarks{\headingmarks{odd}{heading}}
+\def\evenfootingmarks{\headingmarks{even}{footing}}
+\def\oddfootingmarks{\headingmarks{odd}{footing}}
+\def\everyheadingmarks#1 {\headingmarks{even}{heading}{#1}
+ \headingmarks{odd}{heading}{#1} }
+\def\everyfootingmarks#1 {\headingmarks{even}{footing}{#1}
+ \headingmarks{odd}{footing}{#1} }
+% #1 = even/odd, #2 = heading/footing, #3 = top/bottom.
+\def\headingmarks#1#2#3 {%
+ \expandafter\let\expandafter\temp \csname get#3headingmarks\endcsname
+ \global\expandafter\let\csname get#1#2marks\endcsname \temp
+}
+
+\everyheadingmarks bottom
+\everyfootingmarks bottom
+
+% @headings double turns headings on for double-sided printing.
+% @headings single turns headings on for single-sided printing.
+% @headings off turns them off.
+% @headings on same as @headings double, retained for compatibility.
+% @headings after turns on double-sided headings after this page.
+% @headings doubleafter turns on double-sided headings after this page.
+% @headings singleafter turns on single-sided headings after this page.
+% By default, they are off at the start of a document,
+% and turned `on' after @end titlepage.
+
+\def\headings #1 {\csname HEADINGS#1\endcsname}
+
+\def\headingsoff{% non-global headings elimination
+ \evenheadline={\hfil}\evenfootline={\hfil}%
+ \oddheadline={\hfil}\oddfootline={\hfil}%
+}
+
+\def\HEADINGSoff{{\globaldefs=1 \headingsoff}} % global setting
+\HEADINGSoff % it's the default
+
+% When we turn headings on, set the page number to 1.
+% For double-sided printing, put current file name in lower left corner,
+% chapter name on inside top of right hand pages, document
+% title on inside top of left hand pages, and page numbers on outside top
+% edge of all pages.
+\def\HEADINGSdouble{%
+\global\pageno=1
+\global\evenfootline={\hfil}
+\global\oddfootline={\hfil}
+\global\evenheadline={\line{\folio\hfil\thistitle}}
+\global\oddheadline={\line{\thischapterheading\hfil\folio}}
+\global\let\contentsalignmacro = \chapoddpage
+}
+\let\contentsalignmacro = \chappager
+
+% For single-sided printing, chapter title goes across top left of page,
+% page number on top right.
+\def\HEADINGSsingle{%
+\global\pageno=1
+\global\evenfootline={\hfil}
+\global\oddfootline={\hfil}
+\global\evenheadline={\line{\thischapterheading\hfil\folio}}
+\global\oddheadline={\line{\thischapterheading\hfil\folio}}
+\global\let\contentsalignmacro = \chappager
+}
+\def\HEADINGSon{\HEADINGSdouble}
+
+\def\HEADINGSafter{\let\HEADINGShook=\HEADINGSdoublex}
+\let\HEADINGSdoubleafter=\HEADINGSafter
+\def\HEADINGSdoublex{%
+\global\evenfootline={\hfil}
+\global\oddfootline={\hfil}
+\global\evenheadline={\line{\folio\hfil\thistitle}}
+\global\oddheadline={\line{\thischapterheading\hfil\folio}}
+\global\let\contentsalignmacro = \chapoddpage
+}
+
+\def\HEADINGSsingleafter{\let\HEADINGShook=\HEADINGSsinglex}
+\def\HEADINGSsinglex{%
+\global\evenfootline={\hfil}
+\global\oddfootline={\hfil}
+\global\evenheadline={\line{\thischapterheading\hfil\folio}}
+\global\oddheadline={\line{\thischapterheading\hfil\folio}}
+\global\let\contentsalignmacro = \chappager
+}
+
+% Subroutines used in generating headings
+% This produces Day Month Year style of output.
+% Only define if not already defined, in case a txi-??.tex file has set
+% up a different format (e.g., txi-cs.tex does this).
+\ifx\today\thisisundefined
+\def\today{%
+ \number\day\space
+ \ifcase\month
+ \or\putwordMJan\or\putwordMFeb\or\putwordMMar\or\putwordMApr
+ \or\putwordMMay\or\putwordMJun\or\putwordMJul\or\putwordMAug
+ \or\putwordMSep\or\putwordMOct\or\putwordMNov\or\putwordMDec
+ \fi
+ \space\number\year}
+\fi
+
+% @settitle line... specifies the title of the document, for headings.
+% It generates no output of its own.
+\def\thistitle{\putwordNoTitle}
+\def\settitle{\parsearg{\gdef\thistitle}}
+
+
+\message{tables,}
+% Tables -- @table, @ftable, @vtable, @item(x).
+
+% default indentation of table text
+\newdimen\tableindent \tableindent=.8in
+% default indentation of @itemize and @enumerate text
+\newdimen\itemindent \itemindent=.3in
+% margin between end of table item and start of table text.
+\newdimen\itemmargin \itemmargin=.1in
+
+% used internally for \itemindent minus \itemmargin
+\newdimen\itemmax
+
+% Note @table, @ftable, and @vtable define @item, @itemx, etc., with
+% these defs.
+% They also define \itemindex
+% to index the item name in whatever manner is desired (perhaps none).
+
+\newif\ifitemxneedsnegativevskip
+
+\def\itemxpar{\par\ifitemxneedsnegativevskip\nobreak\vskip-\parskip\nobreak\fi}
+
+\def\internalBitem{\smallbreak \parsearg\itemzzz}
+\def\internalBitemx{\itemxpar \parsearg\itemzzz}
+
+\def\itemzzz #1{\begingroup %
+ \advance\hsize by -\rightskip
+ \advance\hsize by -\tableindent
+ \setbox0=\hbox{\itemindicate{#1}}%
+ \itemindex{#1}%
+ \nobreak % This prevents a break before @itemx.
+ %
+ % If the item text does not fit in the space we have, put it on a line
+ % by itself, and do not allow a page break either before or after that
+ % line. We do not start a paragraph here because then if the next
+ % command is, e.g., @kindex, the whatsit would get put into the
+ % horizontal list on a line by itself, resulting in extra blank space.
+ \ifdim \wd0>\itemmax
+ %
+ % Make this a paragraph so we get the \parskip glue and wrapping,
+ % but leave it ragged-right.
+ \begingroup
+ \advance\leftskip by-\tableindent
+ \advance\hsize by\tableindent
+ \advance\rightskip by0pt plus1fil\relax
+ \leavevmode\unhbox0\par
+ \endgroup
+ %
+ % We're going to be starting a paragraph, but we don't want the
+ % \parskip glue -- logically it's part of the @item we just started.
+ \nobreak \vskip-\parskip
+ %
+ % Stop a page break at the \parskip glue coming up. However, if
+ % what follows is an environment such as @example, there will be no
+ % \parskip glue; then the negative vskip we just inserted would
+ % cause the example and the item to crash together. So we use this
+ % bizarre value of 10001 as a signal to \aboveenvbreak to insert
+ % \parskip glue after all. Section titles are handled this way also.
+ %
+ \penalty 10001
+ \endgroup
+ \itemxneedsnegativevskipfalse
+ \else
+ % The item text fits into the space. Start a paragraph, so that the
+ % following text (if any) will end up on the same line.
+ \noindent
+ % Do this with kerns and \unhbox so that if there is a footnote in
+ % the item text, it can migrate to the main vertical list and
+ % eventually be printed.
+ \nobreak\kern-\tableindent
+ \dimen0 = \itemmax \advance\dimen0 by \itemmargin \advance\dimen0 by -\wd0
+ \unhbox0
+ \nobreak\kern\dimen0
+ \endgroup
+ \itemxneedsnegativevskiptrue
+ \fi
+}
+
address@hidden while not in a list environment}}
address@hidden while not in a list environment}}
+
+% @table, @ftable, @vtable.
+\envdef\table{%
+ \let\itemindex\gobble
+ \tablecheck{table}%
+}
+\envdef\ftable{%
+ \def\itemindex ##1{\doind {fn}{\code{##1}}}%
+ \tablecheck{ftable}%
+}
+\envdef\vtable{%
+ \def\itemindex ##1{\doind {vr}{\code{##1}}}%
+ \tablecheck{vtable}%
+}
+\def\tablecheck#1{%
+ \ifnum \the\catcode`\^^M=\active
+ \endgroup
+ \errmessage{This command won't work in this context; perhaps the problem is
+ that we are \inenvironment\thisenv}%
+ \def\next{\doignore{#1}}%
+ \else
+ \let\next\tablex
+ \fi
+ \next
+}
+\def\tablex#1{%
+ \def\itemindicate{#1}%
+ \parsearg\tabley
+}
+\def\tabley#1{%
+ {%
+ \makevalueexpandable
+ \edef\temp{\noexpand\tablez #1\space\space\space}%
+ \expandafter
+ }\temp \endtablez
+}
+\def\tablez #1 #2 #3 #4\endtablez{%
+ \aboveenvbreak
+ \ifnum 0#1>0 \advance \leftskip by #1\mil \fi
+ \ifnum 0#2>0 \tableindent=#2\mil \fi
+ \ifnum 0#3>0 \advance \rightskip by #3\mil \fi
+ \itemmax=\tableindent
+ \advance \itemmax by -\itemmargin
+ \advance \leftskip by \tableindent
+ \exdentamount=\tableindent
+ \parindent = 0pt
+ \parskip = \smallskipamount
+ \ifdim \parskip=0pt \parskip=2pt \fi
+ \let\item = \internalBitem
+ \let\itemx = \internalBitemx
+}
+\def\Etable{\endgraf\afterenvbreak}
+\let\Eftable\Etable
+\let\Evtable\Etable
+\let\Eitemize\Etable
+\let\Eenumerate\Etable
+
+% This is the counter used by @enumerate, which is really @itemize
+
+\newcount \itemno
+
+\envdef\itemize{\parsearg\doitemize}
+
+\def\doitemize#1{%
+ \aboveenvbreak
+ \itemmax=\itemindent
+ \advance\itemmax by -\itemmargin
+ \advance\leftskip by \itemindent
+ \exdentamount=\itemindent
+ \parindent=0pt
+ \parskip=\smallskipamount
+ \ifdim\parskip=0pt \parskip=2pt \fi
+ %
+ % Try typesetting the item mark so that if the document erroneously says
+ % something like @itemize @samp (intending @table), there's an error
+ % right away at the @itemize. It's not the best error message in the
+ % world, but it's better than leaving it to the @item. This means if
+ % the user wants an empty mark, they have to say @w{} not just @w.
+ \def\itemcontents{#1}%
+ \setbox0 = \hbox{\itemcontents}%
+ %
+ % @itemize with no arg is equivalent to @itemize @bullet.
+ \ifx\itemcontents\empty\def\itemcontents{\bullet}\fi
+ %
+ \let\item=\itemizeitem
+}
+
+% Definition of @item while inside @itemize and @enumerate.
+%
+\def\itemizeitem{%
+ \advance\itemno by 1 % for enumerations
+ {\let\par=\endgraf \smallbreak}% reasonable place to break
+ {%
+ % If the document has an @itemize directly after a section title, a
+ % \nobreak will be last on the list, and \sectionheading will have
+ % done a \vskip-\parskip. In that case, we don't want to zero
+ % parskip, or the item text will crash with the heading. On the
+ % other hand, when there is normal text preceding the item (as there
+ % usually is), we do want to zero parskip, or there would be too much
+ % space. In that case, we won't have a \nobreak before. At least
+ % that's the theory.
+ \ifnum\lastpenalty<10000 \parskip=0in \fi
+ \noindent
+ \hbox to 0pt{\hss \itemcontents \kern\itemmargin}%
+ %
+ \ifinner\else
+ \vadjust{\penalty 1200}% not good to break after first line of item.
+ \fi
+ % We can be in inner vertical mode in a footnote, although an
+ % @itemize looks awful there.
+ }%
+ \flushcr
+}
+
+% \splitoff TOKENS\endmark defines \first to be the first token in
+% TOKENS, and \rest to be the remainder.
+%
+\def\splitoff#1#2\endmark{\def\first{#1}\def\rest{#2}}%
+
+% Allow an optional argument of an uppercase letter, lowercase letter,
+% or number, to specify the first label in the enumerated list. No
+% argument is the same as `1'.
+%
+\envparseargdef\enumerate{\enumeratey #1 \endenumeratey}
+\def\enumeratey #1 #2\endenumeratey{%
+ % If we were given no argument, pretend we were given `1'.
+ \def\thearg{#1}%
+ \ifx\thearg\empty \def\thearg{1}\fi
+ %
+ % Detect if the argument is a single token. If so, it might be a
+ % letter. Otherwise, the only valid thing it can be is a number.
+ % (We will always have one token, because of the test we just made.
+ % This is a good thing, since \splitoff doesn't work given nothing at
+ % all -- the first parameter is undelimited.)
+ \expandafter\splitoff\thearg\endmark
+ \ifx\rest\empty
+ % Only one token in the argument. It could still be anything.
+ % A ``lowercase letter'' is one whose \lccode is nonzero.
+ % An ``uppercase letter'' is one whose \lccode is both nonzero, and
+ % not equal to itself.
+ % Otherwise, we assume it's a number.
+ %
+ % We need the \relax at the end of the \ifnum lines to stop TeX from
+ % continuing to look for a <number>.
+ %
+ \ifnum\lccode\expandafter`\thearg=0\relax
+ \numericenumerate % a number (we hope)
+ \else
+ % It's a letter.
+ \ifnum\lccode\expandafter`\thearg=\expandafter`\thearg\relax
+ \lowercaseenumerate % lowercase letter
+ \else
+ \uppercaseenumerate % uppercase letter
+ \fi
+ \fi
+ \else
+ % Multiple tokens in the argument. We hope it's a number.
+ \numericenumerate
+ \fi
+}
+
+% An @enumerate whose labels are integers. The starting integer is
+% given in \thearg.
+%
+\def\numericenumerate{%
+ \itemno = \thearg
+ \startenumeration{\the\itemno}%
+}
+
+% The starting (lowercase) letter is in \thearg.
+\def\lowercaseenumerate{%
+ \itemno = \expandafter`\thearg
+ \startenumeration{%
+ % Be sure we're not beyond the end of the alphabet.
+ \ifnum\itemno=0
+ \errmessage{No more lowercase letters in @enumerate; get a bigger
+ alphabet}%
+ \fi
+ \char\lccode\itemno
+ }%
+}
+
+% The starting (uppercase) letter is in \thearg.
+\def\uppercaseenumerate{%
+ \itemno = \expandafter`\thearg
+ \startenumeration{%
+ % Be sure we're not beyond the end of the alphabet.
+ \ifnum\itemno=0
+ \errmessage{No more uppercase letters in @enumerate; get a bigger
+ alphabet}
+ \fi
+ \char\uccode\itemno
+ }%
+}
+
+% Call \doitemize, adding a period to the first argument and supplying the
+% common last two arguments. Also subtract one from the initial value in
+% \itemno, since @item increments \itemno.
+%
+\def\startenumeration#1{%
+ \advance\itemno by -1
+ \doitemize{#1.}\flushcr
+}
+
+% @alphaenumerate and @capsenumerate are abbreviations for giving an arg
+% to @enumerate.
+%
+\def\alphaenumerate{\enumerate{a}}
+\def\capsenumerate{\enumerate{A}}
+\def\Ealphaenumerate{\Eenumerate}
+\def\Ecapsenumerate{\Eenumerate}
+
+
+% @multitable macros
+% Amy Hendrickson, 8/18/94, 3/6/96
+%
+% @multitable ... @end multitable will make as many columns as desired.
+% Contents of each column will wrap at width given in preamble. Width
+% can be specified either with sample text given in a template line,
+% or in percent of \hsize, the current width of text on page.
+
+% Table can continue over pages but will only break between lines.
+
+% To make preamble:
+%
+% Either define widths of columns in terms of percent of \hsize:
+% @multitable @columnfractions .25 .3 .45
+% @item ...
+%
+% Numbers following @columnfractions are the percent of the total
+% current hsize to be used for each column. You may use as many
+% columns as desired.
+
+
+% Or use a template:
+% @multitable {Column 1 template} {Column 2 template} {Column 3 template}
+% @item ...
+% using the widest term desired in each column.
+
+% Each new table line starts with @item, each subsequent new column
+% starts with @tab. Empty columns may be produced by supplying @tab's
+% with nothing between them for as many times as empty columns are needed,
+% ie, @address@hidden@tab will produce two empty columns.
+
+% @item, @tab do not need to be on their own lines, but it will not hurt
+% if they are.
+
+% Sample multitable:
+
+% @multitable {Column 1 template} {Column 2 template} {Column 3 template}
+% @item first col stuff @tab second col stuff @tab third col
+% @item
+% first col stuff
+% @tab
+% second col stuff
+% @tab
+% third col
+% @item first col stuff @tab second col stuff
+% @tab Many paragraphs of text may be used in any column.
+%
+% They will wrap at the width determined by the template.
+% @address@hidden@tab This will be in third column.
+% @end multitable
+
+% Default dimensions may be reset by user.
+% @multitableparskip is vertical space between paragraphs in table.
+% @multitableparindent is paragraph indent in table.
+% @multitablecolmargin is horizontal space to be left between columns.
+% @multitablelinespace is space to leave between table items, baseline
+% to baseline.
+% 0pt means it depends on current normal line spacing.
+%
+\newskip\multitableparskip
+\newskip\multitableparindent
+\newdimen\multitablecolspace
+\newskip\multitablelinespace
+\multitableparskip=0pt
+\multitableparindent=6pt
+\multitablecolspace=12pt
+\multitablelinespace=0pt
+
+% Macros used to set up halign preamble:
+%
+\let\endsetuptable\relax
+\def\xendsetuptable{\endsetuptable}
+\let\columnfractions\relax
+\def\xcolumnfractions{\columnfractions}
+\newif\ifsetpercent
+
+% #1 is the @columnfraction, usually a decimal number like .5, but might
+% be just 1. We just use it, whatever it is.
+%
+\def\pickupwholefraction#1 {%
+ \global\advance\colcount by 1
+ \expandafter\xdef\csname col\the\colcount\endcsname{#1\hsize}%
+ \setuptable
+}
+
+\newcount\colcount
+\def\setuptable#1{%
+ \def\firstarg{#1}%
+ \ifx\firstarg\xendsetuptable
+ \let\go = \relax
+ \else
+ \ifx\firstarg\xcolumnfractions
+ \global\setpercenttrue
+ \else
+ \ifsetpercent
+ \let\go\pickupwholefraction
+ \else
+ \global\advance\colcount by 1
+ \setbox0=\hbox{#1\unskip\space}% Add a normal word space as a
+ % separator; typically that is always in the input, anyway.
+ \expandafter\xdef\csname col\the\colcount\endcsname{\the\wd0}%
+ \fi
+ \fi
+ \ifx\go\pickupwholefraction
+ % Put the argument back for the \pickupwholefraction call, so
+ % we'll always have a period there to be parsed.
+ \def\go{\pickupwholefraction#1}%
+ \else
+ \let\go = \setuptable
+ \fi%
+ \fi
+ \go
+}
+
+% multitable-only commands.
+%
+% @headitem starts a heading row, which we typeset in bold. Assignments
+% have to be global since we are inside the implicit group of an
+% alignment entry. \everycr below resets \everytab so we don't have to
+% undo it ourselves.
+\def\headitemfont{\b}% for people to use in the template row; not changeable
+\def\headitem{%
+ \checkenv\multitable
+ \crcr
+ \gdef\headitemcrhook{\nobreak}% attempt to avoid page break after headings
+ \global\everytab={\bf}% can't use \headitemfont since the parsing differs
+ \the\everytab % for the first item
+}%
+%
+% default for tables with no headings.
+\let\headitemcrhook=\relax
+%
+% A \tab used to include \hskip1sp. But then the space in a template
+% line is not enough. That is bad. So let's go back to just `&' until
+% we again encounter the problem the 1sp was intended to solve.
+% --karl, address@hidden, 20apr99.
+\def\tab{\checkenv\multitable &\the\everytab}%
+
+% @multitable ... @end multitable definitions:
+%
+\newtoks\everytab % insert after every tab.
+%
+\envdef\multitable{%
+ \vskip\parskip
+ \startsavinginserts
+ %
+ % @item within a multitable starts a normal row.
+ % We use \def instead of \let so that if one of the multitable entries
+ % contains an @itemize, we don't choke on the \item (seen as \crcr aka
+ % \endtemplate) expanding \doitemize.
+ \def\item{\crcr}%
+ %
+ \tolerance=9500
+ \hbadness=9500
+ \setmultitablespacing
+ \parskip=\multitableparskip
+ \parindent=\multitableparindent
+ \overfullrule=0pt
+ \global\colcount=0
+ %
+ \everycr = {%
+ \noalign{%
+ \global\everytab={}% Reset from possible headitem.
+ \global\colcount=0 % Reset the column counter.
+ %
+ % Check for saved footnotes, etc.:
+ \checkinserts
+ %
+ % Perhaps a \nobreak, then reset:
+ \headitemcrhook
+ \global\let\headitemcrhook=\relax
+ }%
+ }%
+ %
+ \parsearg\domultitable
+}
+\def\domultitable#1{%
+ % To parse everything between @multitable and @item:
+ \setuptable#1 \endsetuptable
+ %
+ % This preamble sets up a generic column definition, which will
+ % be used as many times as user calls for columns.
+ % \vtop will set a single line and will also let text wrap and
+ % continue for many paragraphs if desired.
+ \halign\bgroup &%
+ \global\advance\colcount by 1
+ \multistrut
+ \vtop{%
+ % Use the current \colcount to find the correct column width:
+ \hsize=\expandafter\csname col\the\colcount\endcsname
+ %
+ % In order to keep entries from bumping into each other
+ % we will add a \leftskip of \multitablecolspace to all columns after
+ % the first one.
+ %
+ % If a template has been used, we will add \multitablecolspace
+ % to the width of each template entry.
+ %
+ % If the user has set preamble in terms of percent of \hsize we will
+ % use that dimension as the width of the column, and the \leftskip
+ % will keep entries from bumping into each other. Table will start at
+ % left margin and final column will justify at right margin.
+ %
+ % Make sure we don't inherit \rightskip from the outer environment.
+ \rightskip=0pt
+ \ifnum\colcount=1
+ % The first column will be indented with the surrounding text.
+ \advance\hsize by\leftskip
+ \else
+ \ifsetpercent \else
+ % If user has not set preamble in terms of percent of \hsize
+ % we will advance \hsize by \multitablecolspace.
+ \advance\hsize by \multitablecolspace
+ \fi
+ % In either case we will make \leftskip=\multitablecolspace:
+ \leftskip=\multitablecolspace
+ \fi
+ % Ignoring space at the beginning and end avoids an occasional spurious
+ % blank line, when TeX decides to break the line at the space before the
+ % box from the multistrut, so the strut ends up on a line by itself.
+ % For example:
+ % @multitable @columnfractions .11 .89
+ % @item @code{#}
+ % @tab Legal holiday which is valid in major parts of the whole country.
+ % Is automatically provided with highlighting sequences respectively
+ % marking characters.
+ \noindent\ignorespaces##\unskip\multistrut
+ }\cr
+}
+\def\Emultitable{%
+ \crcr
+ \egroup % end the \halign
+ \global\setpercentfalse
+}
+
+\def\setmultitablespacing{%
+ \def\multistrut{\strut}% just use the standard line spacing
+ %
+ % Compute \multitablelinespace (if not defined by user) for use in
+ % \multitableparskip calculation. We used define \multistrut based on
+ % this, but (ironically) that caused the spacing to be off.
+ % See bug-texinfo report from Werner Lemberg, 31 Oct 2004 12:52:20 +0100.
+\ifdim\multitablelinespace=0pt
+\setbox0=\vbox{X}\global\multitablelinespace=\the\baselineskip
+\global\advance\multitablelinespace by-\ht0
+\fi
+% Test to see if parskip is larger than space between lines of
+% table. If not, do nothing.
+% If so, set to same dimension as multitablelinespace.
+\ifdim\multitableparskip>\multitablelinespace
+\global\multitableparskip=\multitablelinespace
+\global\advance\multitableparskip-7pt % to keep parskip somewhat smaller
+ % than skip between lines in the table.
+\fi%
+\ifdim\multitableparskip=0pt
+\global\multitableparskip=\multitablelinespace
+\global\advance\multitableparskip-7pt % to keep parskip somewhat smaller
+ % than skip between lines in the table.
+\fi}
+
+
+\message{conditionals,}
+
+% @iftex, @ifnotdocbook, @ifnothtml, @ifnotinfo, @ifnotplaintext,
+% @ifnotxml always succeed. They currently do nothing; we don't
+% attempt to check whether the conditionals are properly nested. But we
+% have to remember that they are conditionals, so that @end doesn't
+% attempt to close an environment group.
+%
+\def\makecond#1{%
+ \expandafter\let\csname #1\endcsname = \relax
+ \expandafter\let\csname iscond.#1\endcsname = 1
+}
+\makecond{iftex}
+\makecond{ifnotdocbook}
+\makecond{ifnothtml}
+\makecond{ifnotinfo}
+\makecond{ifnotplaintext}
+\makecond{ifnotxml}
+
+% Ignore @ignore, @ifhtml, @ifinfo, and the like.
+%
+\def\direntry{\doignore{direntry}}
+\def\documentdescription{\doignore{documentdescription}}
+\def\docbook{\doignore{docbook}}
+\def\html{\doignore{html}}
+\def\ifdocbook{\doignore{ifdocbook}}
+\def\ifhtml{\doignore{ifhtml}}
+\def\ifinfo{\doignore{ifinfo}}
+\def\ifnottex{\doignore{ifnottex}}
+\def\ifplaintext{\doignore{ifplaintext}}
+\def\ifxml{\doignore{ifxml}}
+\def\ignore{\doignore{ignore}}
+\def\menu{\doignore{menu}}
+\def\xml{\doignore{xml}}
+
+% Ignore text until a line address@hidden #1', keeping track of nested
conditionals.
+%
+% A count to remember the depth of nesting.
+\newcount\doignorecount
+
+\def\doignore#1{\begingroup
+ % Scan in ``verbatim'' mode:
+ \obeylines
+ \catcode`\@ = \other
+ \catcode`\{ = \other
+ \catcode`\} = \other
+ %
+ % Make sure that spaces turn into tokens that match what \doignoretext wants.
+ \spaceisspace
+ %
+ % Count number of #1's that we've seen.
+ \doignorecount = 0
+ %
+ % Swallow text until we reach the matching address@hidden #1'.
+ \dodoignore{#1}%
+}
+
+{ \catcode`_=11 % We want to use \_STOP_ which cannot appear in texinfo source.
+ \obeylines %
+ %
+ \gdef\dodoignore#1{%
+ % #1 contains the command name as a string, e.g., `ifinfo'.
+ %
+ % Define a command to find the next address@hidden #1'.
+ address@hidden #1{%
+ address@hidden
+ %
+ % And this command to find another #1 command, at the beginning of a
+ % line. (Otherwise, we would consider a line address@hidden @ifset', for
+ % example, to count as an @ifset for nesting.)
+ address@hidden
+ %
+ % And now expand that command.
+ \doignoretext ^^M%
+ }%
+}
+
+\def\doignoreyyy#1{%
+ \def\temp{#1}%
+ \ifx\temp\empty % Nothing found.
+ \let\next\doignoretextzzz
+ \else % Found a nested condition, ...
+ \advance\doignorecount by 1
+ \let\next\doignoretextyyy % ..., look for another.
+ % If we're here, #1 ends with ^^M\ifinfo (for example).
+ \fi
+ \next #1% the token \_STOP_ is present just after this macro.
+}
+
+% We have to swallow the remaining "\_STOP_".
+%
+\def\doignoretextzzz#1{%
+ \ifnum\doignorecount = 0 % We have just found the outermost @end.
+ \let\next\enddoignore
+ \else % Still inside a nested condition.
+ \advance\doignorecount by -1
+ \let\next\doignoretext % Look for the next @end.
+ \fi
+ \next
+}
+
+% Finish off ignored text.
+{ \obeylines%
+ % Ignore anything after the last address@hidden #1'; this matters in verbatim
+ % environments, where otherwise the newline after an ignored conditional
+ % would result in a blank line in the output.
+ \gdef\enddoignore#1^^M{\endgroup\ignorespaces}%
+}
+
+
+% @set VAR sets the variable VAR to an empty value.
+% @set VAR REST-OF-LINE sets VAR to the value REST-OF-LINE.
+%
+% Since we want to separate VAR from REST-OF-LINE (which might be
+% empty), we can't just use \parsearg; we have to insert a space of our
+% own to delimit the rest of the line, and then take it out again if we
+% didn't need it.
+% We rely on the fact that \parsearg sets \catcode`\ =10.
+%
+\parseargdef\set{\setyyy#1 \endsetyyy}
+\def\setyyy#1 #2\endsetyyy{%
+ {%
+ \makevalueexpandable
+ \def\temp{#2}%
+ \edef\next{\gdef\makecsname{SET#1}}%
+ \ifx\temp\empty
+ \next{}%
+ \else
+ \setzzz#2\endsetzzz
+ \fi
+ }%
+}
+% Remove the trailing space \setxxx inserted.
+\def\setzzz#1 \endsetzzz{\next{#1}}
+
+% @clear VAR clears (i.e., unsets) the variable VAR.
+%
+\parseargdef\clear{%
+ {%
+ \makevalueexpandable
+ \global\expandafter\let\csname SET#1\endcsname=\relax
+ }%
+}
+
+% @value{foo} gets the text saved in variable foo.
+\def\value{\begingroup\makevalueexpandable\valuexxx}
+\def\valuexxx#1{\expandablevalue{#1}\endgroup}
+{
+ \catcode`\-=\active \catcode`\_=\active
+ %
+ \gdef\makevalueexpandable{%
+ \let\value = \expandablevalue
+ % We don't want these characters active, ...
+ \catcode`\-=\other \catcode`\_=\other
+ % ..., but we might end up with active ones in the argument if
+ % we're called from @code, as @address@hidden, though.
+ % So \let them to their normal equivalents.
+ \let-\normaldash \let_\normalunderscore
+ }
+}
+
+% We have this subroutine so that we can handle at least some @value's
+% properly in indexes (we call \makevalueexpandable in \indexdummies).
+% The command has to be fully expandable (if the variable is set), since
+% the result winds up in the index file. This means that if the
+% variable's value contains other Texinfo commands, it's almost certain
+% it will fail (although perhaps we could fix that with sufficient work
+% to do a one-level expansion on the result, instead of complete).
+%
+% Unfortunately, this has the consequence that when _ is in the *value*
+% of an @set, it does not print properly in the roman fonts (get the cmr
+% dot accent at position 126 instead). No fix comes to mind, and it's
+% been this way since 2003 or earlier, so just ignore it.
+%
+\def\expandablevalue#1{%
+ \expandafter\ifx\csname SET#1\endcsname\relax
+ {[No value for ``#1'']}%
+ \message{Variable `#1', used in @value, is not set.}%
+ \else
+ \csname SET#1\endcsname
+ \fi
+}
+
+% @ifset VAR ... @end ifset reads the `...' iff VAR has been defined
+% with @set.
+%
+% To get the special treatment we need for address@hidden ifset,' we call
+% \makecond and then redefine.
+%
+\makecond{ifset}
+\def\ifset{\parsearg{\doifset{\let\next=\ifsetfail}}}
+\def\doifset#1#2{%
+ {%
+ \makevalueexpandable
+ \let\next=\empty
+ \expandafter\ifx\csname SET#2\endcsname\relax
+ #1% If not set, redefine \next.
+ \fi
+ \expandafter
+ }\next
+}
+\def\ifsetfail{\doignore{ifset}}
+
+% @ifclear VAR ... @end executes the `...' iff VAR has never been
+% defined with @set, or has been undefined with @clear.
+%
+% The `\else' inside the `\doifset' parameter is a trick to reuse the
+% above code: if the variable is not set, do nothing, if it is set,
+% then redefine \next to \ifclearfail.
+%
+\makecond{ifclear}
+\def\ifclear{\parsearg{\doifset{\else \let\next=\ifclearfail}}}
+\def\ifclearfail{\doignore{ifclear}}
+
+% @ifcommandisdefined CMD ... @end executes the `...' if CMD (written
+% without the @) is in fact defined. We can only feasibly check at the
+% TeX level, so something like `mathcode' is going to considered
+% defined even though it is not a Texinfo command.
+%
+\makecond{ifcommanddefined}
+\def\ifcommanddefined{\parsearg{\doifcmddefined{\let\next=\ifcmddefinedfail}}}
+%
+\def\doifcmddefined#1#2{{%
+ \makevalueexpandable
+ \let\next=\empty
+ \expandafter\ifx\csname #2\endcsname\relax
+ #1% If not defined, \let\next as above.
+ \fi
+ \expandafter
+ }\next
+}
+\def\ifcmddefinedfail{\doignore{ifcommanddefined}}
+
+% @ifcommandnotdefined CMD ... handled similar to @ifclear above.
+\makecond{ifcommandnotdefined}
+\def\ifcommandnotdefined{%
+ \parsearg{\doifcmddefined{\else \let\next=\ifcmdnotdefinedfail}}}
+\def\ifcmdnotdefinedfail{\doignore{ifcommandnotdefined}}
+
+% Set the `txicommandconditionals' variable, so documents have a way to
+% test if the @ifcommand...defined conditionals are available.
+\set txicommandconditionals
+
+% @dircategory CATEGORY -- specify a category of the dir file
+% which this file should belong to. Ignore this in TeX.
+\let\dircategory=\comment
+
+% @defininfoenclose.
+\let\definfoenclose=\comment
+
+
+\message{indexing,}
+% Index generation facilities
+
+% Define \newwrite to be identical to plain tex's \newwrite
+% except not \outer, so it can be used within macros and \if's.
+\edef\newwrite{\makecsname{ptexnewwrite}}
+
+% \newindex {foo} defines an index named IX.
+% It automatically defines \IXindex such that
+% \IXindex ...rest of line... puts an entry in the index IX.
+% It also defines \IXindfile to be the number of the output channel for
+% the file that accumulates this index. The file's extension is IX.
+% The name of an index should be no more than 2 characters long
+% for the sake of vms.
+%
+\def\newindex#1{%
+ \expandafter\chardef\csname#1indfile\endcsname=0
+ \expandafter\xdef\csname#1index\endcsname{% % Define @#1index
+ \noexpand\doindex{#1}}
+}
+
+% @defindex foo == \newindex{foo}
+%
+\def\defindex{\parsearg\newindex}
+
+% Define @defcodeindex, like @defindex except put all entries in @code.
+%
+\def\defcodeindex{\parsearg\newcodeindex}
+%
+\def\newcodeindex#1{%
+ \expandafter\chardef\csname#1indfile\endcsname=0
+ \expandafter\xdef\csname#1index\endcsname{%
+ \noexpand\docodeindex{#1}}%
+}
+
+% The default indices:
+\newindex{cp}% concepts,
+\newcodeindex{fn}% functions,
+\newcodeindex{vr}% variables,
+\newcodeindex{tp}% types,
+\newcodeindex{ky}% keys
+\newcodeindex{pg}% and programs.
+
+
+% @synindex foo bar makes index foo feed into index bar.
+% Do this instead of @defindex foo if you don't want it as a separate index.
+%
+% @syncodeindex foo bar similar, but put all entries made for index foo
+% inside @code.
+%
+\def\synindex#1 #2 {\dosynindex\doindex{#1}{#2}}
+\def\syncodeindex#1 #2 {\dosynindex\docodeindex{#1}{#2}}
+
+% #1 is \doindex or \docodeindex, #2 the index getting redefined (foo),
+% #3 the target index (bar).
+\def\dosynindex#1#2#3{%
+ % Only do \closeout if we haven't already done it, else we'll end up
+ % closing the target index.
+ \expandafter \ifx\csname donesynindex#2\endcsname \relax
+ % The \closeout helps reduce unnecessary open files; the limit on the
+ % Acorn RISC OS is a mere 16 files.
+ \expandafter\closeout\csname#2indfile\endcsname
+ \expandafter\let\csname donesynindex#2\endcsname = 1
+ \fi
+ % redefine \fooindfile:
+ \expandafter\let\expandafter\temp\expandafter=\csname#3indfile\endcsname
+ \expandafter\let\csname#2indfile\endcsname=\temp
+ % redefine \fooindex:
+ \expandafter\xdef\csname#2index\endcsname{\noexpand#1{#3}}%
+}
+
+% Define \doindex, the driver for all index macros.
+% Argument #1 is generated by the calling \fooindex macro,
+% and it the two-letter name of the index.
+
+\def\doindex#1{\edef\indexname{#1}\parsearg\doindexxxx}
+\def\doindexxxx #1{\doind{\indexname}{#1}}
+
+% like the previous two, but they put @code around the argument.
+\def\docodeindex#1{\edef\indexname{#1}\parsearg\docodeindexxxx}
+\def\docodeindexxxx #1{\doind{\indexname}{\code{#1}}}
+
+% Used when writing an index entry out to an index file, to prevent
+% expansion of Texinfo commands that can appear in an index entry.
+%
+\def\indexdummies{%
+ \escapechar = `\\ % use backslash in output files.
+ address@hidden@}% change to @@ when we switch to @ as escape char in index
files.
+ \def\ {\realbackslash\space }%
+ %
+ % Need these unexpandable (because we define \tt as a dummy)
+ % definitions when @{ or @} appear in index entry text. Also, more
+ % complicated, when \tex is in effect and \{ is a \delimiter again.
+ % We can't use \lbracecmd and \rbracecmd because texindex assumes
+ % braces and backslashes are used only as delimiters. Perhaps we
+ % should use @lbracechar and @rbracechar?
+ \def\{{{\tt\char123}}%
+ \def\}{{\tt\char125}}%
+ %
+ % Do the redefinitions.
+ \commondummies
+}
+
+% For the aux and toc files, @ is the escape character. So we want to
+% redefine everything using @ as the escape character (instead of
+% \realbackslash, still used for index files). When everything uses @,
+% this will be simpler.
+%
+\def\atdummies{%
+ address@hidden@@}%
+ \def\ {@ }%
+ \let\{ = \lbraceatcmd
+ \let\} = \rbraceatcmd
+ %
+ % Do the redefinitions.
+ \commondummies
+ \otherbackslash
+}
+
+% Called from \indexdummies and \atdummies.
+%
+\def\commondummies{%
+ % \definedummyword defines \#1 as \string\#1\space, thus effectively
+ % preventing its expansion. This is used only for control words,
+ % not control letters, because the \space would be incorrect for
+ % control characters, but is needed to separate the control word
+ % from whatever follows.
+ %
+ % For control letters, we have \definedummyletter, which omits the
+ % space.
+ %
+ % These can be used both for control words that take an argument and
+ % those that do not. If it is followed by {arg} in the input, then
+ % that will dutifully get written to the index (or wherever).
+ %
+ \def\definedummyword ##1{\def##1{\string##1\space}}%
+ \def\definedummyletter##1{\def##1{\string##1}}%
+ \let\definedummyaccent\definedummyletter
+ %
+ \commondummiesnofonts
+ %
+ \definedummyletter\_%
+ \definedummyletter\-%
+ %
+ % Non-English letters.
+ \definedummyword\AA
+ \definedummyword\AE
+ \definedummyword\DH
+ \definedummyword\L
+ \definedummyword\O
+ \definedummyword\OE
+ \definedummyword\TH
+ \definedummyword\aa
+ \definedummyword\ae
+ \definedummyword\dh
+ \definedummyword\exclamdown
+ \definedummyword\l
+ \definedummyword\o
+ \definedummyword\oe
+ \definedummyword\ordf
+ \definedummyword\ordm
+ \definedummyword\questiondown
+ \definedummyword\ss
+ \definedummyword\th
+ %
+ % Although these internal commands shouldn't show up, sometimes they do.
+ \definedummyword\bf
+ \definedummyword\gtr
+ \definedummyword\hat
+ \definedummyword\less
+ \definedummyword\sf
+ \definedummyword\sl
+ \definedummyword\tclose
+ \definedummyword\tt
+ %
+ \definedummyword\LaTeX
+ \definedummyword\TeX
+ %
+ % Assorted special characters.
+ \definedummyword\arrow
+ \definedummyword\bullet
+ \definedummyword\comma
+ \definedummyword\copyright
+ \definedummyword\registeredsymbol
+ \definedummyword\dots
+ \definedummyword\enddots
+ \definedummyword\entrybreak
+ \definedummyword\equiv
+ \definedummyword\error
+ \definedummyword\euro
+ \definedummyword\expansion
+ \definedummyword\geq
+ \definedummyword\guillemetleft
+ \definedummyword\guillemetright
+ \definedummyword\guilsinglleft
+ \definedummyword\guilsinglright
+ \definedummyword\lbracechar
+ \definedummyword\leq
+ \definedummyword\mathopsup
+ \definedummyword\minus
+ \definedummyword\ogonek
+ \definedummyword\pounds
+ \definedummyword\point
+ \definedummyword\print
+ \definedummyword\quotedblbase
+ \definedummyword\quotedblleft
+ \definedummyword\quotedblright
+ \definedummyword\quoteleft
+ \definedummyword\quoteright
+ \definedummyword\quotesinglbase
+ \definedummyword\rbracechar
+ \definedummyword\result
+ \definedummyword\sub
+ \definedummyword\sup
+ \definedummyword\textdegree
+ %
+ % We want to disable all macros so that they are not expanded by \write.
+ \macrolist
+ %
+ \normalturnoffactive
+ %
+ % Handle some cases of @value -- where it does not contain any
+ % (non-fully-expandable) commands.
+ \makevalueexpandable
+}
+
+% \commondummiesnofonts: common to \commondummies and \indexnofonts.
+% Define \definedumyletter, \definedummyaccent and \definedummyword before
+% using.
+%
+\def\commondummiesnofonts{%
+ % Control letters and accents.
+ \definedummyletter\!%
+ \definedummyaccent\"%
+ \definedummyaccent\'%
+ \definedummyletter\*%
+ \definedummyaccent\,%
+ \definedummyletter\.%
+ \definedummyletter\/%
+ \definedummyletter\:%
+ \definedummyaccent\=%
+ \definedummyletter\?%
+ \definedummyaccent\^%
+ \definedummyaccent\`%
+ \definedummyaccent\~%
+ \definedummyword\u
+ \definedummyword\v
+ \definedummyword\H
+ \definedummyword\dotaccent
+ \definedummyword\ogonek
+ \definedummyword\ringaccent
+ \definedummyword\tieaccent
+ \definedummyword\ubaraccent
+ \definedummyword\udotaccent
+ \definedummyword\dotless
+ %
+ % Texinfo font commands.
+ \definedummyword\b
+ \definedummyword\i
+ \definedummyword\r
+ \definedummyword\sansserif
+ \definedummyword\sc
+ \definedummyword\slanted
+ \definedummyword\t
+ %
+ % Commands that take arguments.
+ \definedummyword\abbr
+ \definedummyword\acronym
+ \definedummyword\anchor
+ \definedummyword\cite
+ \definedummyword\code
+ \definedummyword\command
+ \definedummyword\dfn
+ \definedummyword\dmn
+ \definedummyword\email
+ \definedummyword\emph
+ \definedummyword\env
+ \definedummyword\file
+ \definedummyword\image
+ \definedummyword\indicateurl
+ \definedummyword\inforef
+ \definedummyword\kbd
+ \definedummyword\key
+ \definedummyword\math
+ \definedummyword\option
+ \definedummyword\pxref
+ \definedummyword\ref
+ \definedummyword\samp
+ \definedummyword\strong
+ \definedummyword\tie
+ \definedummyword\U
+ \definedummyword\uref
+ \definedummyword\url
+ \definedummyword\var
+ \definedummyword\verb
+ \definedummyword\w
+ \definedummyword\xref
+}
+
+% For testing: output @{ and @} in index sort strings as \{ and \}.
+\newif\ifusebracesinindexes
+
+\let\indexlbrace\relax
+\let\indexrbrace\relax
+
address@hidden
+\catcode`\\=13
+ @address@hidden@def\{}}
+}
+
+{
+\catcode`\<=13
+\catcode`\-=13
+\catcode`\`=13
+ \gdef\indexnonalnumdisappear{%
+ \expandafter\ifx\csname SETtxiindexlquoteignore\endcsname\relax\else
+ % @set txiindexlquoteignore makes us ignore left quotes in the sort term.
+ % (Introduced for FSFS 2nd ed.)
+ \let`=\empty
+ \fi
+ %
+ \expandafter\ifx\csname SETtxiindexbackslashignore\endcsname\relax\else
+ \backslashdisappear
+ \fi
+ %
+ \expandafter\ifx\csname SETtxiindexhyphenignore\endcsname\relax\else
+ \def-{}%
+ \fi
+ \expandafter\ifx\csname SETtxiindexlessthanignore\endcsname\relax\else
+ \def<{}%
+ \fi
+ \expandafter\ifx\csname SETtxiindexatsignignore\endcsname\relax\else
+ address@hidden
+ \fi
+ }
+
+ \gdef\indexnonalnumreappear{%
+ \useindexbackslash
+ \let-\normaldash
+ \let<\normalless
+ address@hidden@}%
+ }
+}
+
+
+% \indexnofonts is used when outputting the strings to sort the index
+% by, and when constructing control sequence names. It eliminates all
+% control sequences and just writes whatever the best ASCII sort string
+% would be for a given command (usually its argument).
+%
+\def\indexnofonts{%
+ % Accent commands should become @asis.
+ \def\definedummyaccent##1{\let##1\asis}%
+ % We can just ignore other control letters.
+ \def\definedummyletter##1{\let##1\empty}%
+ % All control words become @asis by default; overrides below.
+ \let\definedummyword\definedummyaccent
+ \commondummiesnofonts
+ %
+ % Don't no-op \tt, since it isn't a user-level command
+ % and is used in the definitions of the active chars like <, >, |, etc.
+ % Likewise with the other plain tex font commands.
+ %\let\tt=\asis
+ %
+ \def\ { }%
+ address@hidden@}%
+ \def\_{\normalunderscore}%
+ \def\-{}% @- shouldn't affect sorting
+ %
+ \uccode`\1=`\{ \uppercase{\def\{{1}}%
+ \uccode`\1=`\} \uppercase{\def\}{1}}%
+ \let\lbracechar\{%
+ \let\rbracechar\}%
+ %
+ % Non-English letters.
+ \def\AA{AA}%
+ \def\AE{AE}%
+ \def\DH{DZZ}%
+ \def\L{L}%
+ \def\OE{OE}%
+ \def\O{O}%
+ \def\TH{TH}%
+ \def\aa{aa}%
+ \def\ae{ae}%
+ \def\dh{dzz}%
+ \def\exclamdown{!}%
+ \def\l{l}%
+ \def\oe{oe}%
+ \def\ordf{a}%
+ \def\ordm{o}%
+ \def\o{o}%
+ \def\questiondown{?}%
+ \def\ss{ss}%
+ \def\th{th}%
+ %
+ \def\LaTeX{LaTeX}%
+ \def\TeX{TeX}%
+ %
+ % Assorted special characters.
+ % (The following {} will end up in the sort string, but that's ok.)
+ \def\arrow{->}%
+ \def\bullet{bullet}%
+ \def\comma{,}%
+ \def\copyright{copyright}%
+ \def\dots{...}%
+ \def\enddots{...}%
+ \def\equiv{==}%
+ \def\error{error}%
+ \def\euro{euro}%
+ \def\expansion{==>}%
+ \def\geq{>=}%
+ \def\guillemetleft{<<}%
+ \def\guillemetright{>>}%
+ \def\guilsinglleft{<}%
+ \def\guilsinglright{>}%
+ \def\leq{<=}%
+ \def\minus{-}%
+ \def\point{.}%
+ \def\pounds{pounds}%
+ \def\print{-|}%
+ \def\quotedblbase{"}%
+ \def\quotedblleft{"}%
+ \def\quotedblright{"}%
+ \def\quoteleft{`}%
+ \def\quoteright{'}%
+ \def\quotesinglbase{,}%
+ \def\registeredsymbol{R}%
+ \def\result{=>}%
+ \def\textdegree{o}%
+ %
+ % We need to get rid of all macros, leaving only the arguments (if present).
+ % Of course this is not nearly correct, but it is the best we can do for now.
+ % makeinfo does not expand macros in the argument to @deffn, which ends up
+ % writing an index entry, and texindex isn't prepared for an index sort entry
+ % that starts with \.
+ %
+ % Since macro invocations are followed by braces, we can just redefine them
+ % to take a single TeX argument. The case of a macro invocation that
+ % goes to end-of-line is not handled.
+ %
+ \macrolist
+}
+
+
+\let\SETmarginindex=\relax % put index entries in margin (undocumented)?
+
+% Most index entries go through here, but \dosubind is the general case.
+% #1 is the index name, #2 is the entry text.
+\def\doind#1#2{\dosubind{#1}{#2}{}}
+
+% There is also \dosubind {index}{topic}{subtopic}
+% which makes an entry in a two-level index such as the operation index.
+% TODO: Two-level index? Operation index?
+
+% Workhorse for all indexes.
+% #1 is name of index, #2 is stuff to put there, #3 is subentry --
+% empty if called from \doind, as we usually are (the main exception
+% is with most defuns, which call us directly).
+%
+\def\dosubind#1#2#3{%
+ \iflinks
+ {%
+ \requireopenindexfile{#1}%
+ % Store the main index entry text (including the third arg).
+ \toks0 = {#2}%
+ % If third arg is present, precede it with a space.
+ \def\thirdarg{#3}%
+ \ifx\thirdarg\empty \else
+ \toks0 = \expandafter{\the\toks0 \space #3}%
+ \fi
+ %
+ \edef\writeto{\csname#1indfile\endcsname}%
+ %
+ \safewhatsit\dosubindwrite
+ }%
+ \fi
+}
+
+% Check if an index file has been opened, and if not, open it.
+\def\requireopenindexfile#1{%
+\ifnum\csname #1indfile\endcsname=0
+ \expandafter\newwrite \csname#1indfile\endcsname
+ \edef\suffix{#1}%
+ % A .fls suffix would conflict with the file extension for the output
+ % of -recorder, so use .f1s instead.
+ \ifx\suffix\indexisfl\def\suffix{f1}\fi
+ % Open the file
+ \immediate\openout\csname#1indfile\endcsname \jobname.\suffix
+ % Using \immediate here prevents an object entering into the current box,
+ % which could confound checks such as those in \safewhatsit for preceding
+ % skips.
+\fi}
+\def\indexisfl{fl}
+
+% Output \ as {\indexbackslash}, because \ is an escape character in
+% the index files.
+\let\indexbackslash=\relax
address@hidden \catcode`\\=\active
+ @address@hidden@address@hidden
+}
+
+% Definition for writing index entry text.
+\def\sortas#1{\ignorespaces}%
+
+% Definition for writing index entry sort key. Should occur at the at
+% the beginning of the index entry, like
+% @cindex @sortas{september} \september
+% The \ignorespaces takes care of following space, but there's no way
+% to remove space before it.
+{
+\catcode`\-=13
+\gdef\indexwritesortas{%
+ \begingroup
+ \indexnonalnumreappear
+ \indexwritesortasxxx}
+\gdef\indexwritesortasxxx#1{%
+ \xdef\indexsortkey{#1}\endgroup}
+}
+
+
+% Write the entry in \toks0 to the index file.
+%
+\def\dosubindwrite{%
+ % Put the index entry in the margin if desired.
+ \ifx\SETmarginindex\relax\else
+ \insert\margin{\hbox{\vrule height8pt depth3pt width0pt \the\toks0}}%
+ \fi
+ %
+ % Remember, we are within a group.
+ \indexdummies % Must do this here, since \bf, etc expand at this stage
+ \useindexbackslash % \indexbackslash isn't defined now so it will be output
+ % as is; and it will print as backslash.
+ % The braces around \indexbrace are recognized by texindex.
+ %
+ % Get the string to sort by, by processing the index entry with all
+ % font commands turned off.
+ {\indexnofonts
+ \def\lbracechar{{\indexlbrace}}%
+ \def\rbracechar{{\indexrbrace}}%
+ \let\{=\lbracechar
+ \let\}=\rbracechar
+ \indexnonalnumdisappear
+ \xdef\indexsortkey{}%
+ \let\sortas=\indexwritesortas
+ \edef\temp{\the\toks0}%
+ \setbox\dummybox = \hbox{\temp}% Make sure to execute any \sortas
+ \ifx\indexsortkey\empty
+ \xdef\indexsortkey{\temp}%
+ \ifx\indexsortkey\empty\xdef\indexsortkey{ }\fi
+ \fi
+ }%
+ %
+ % Set up the complete index entry, with both the sort key and
+ % the original text, including any font commands. We write
+ % three arguments to \entry to the .?? file (four in the
+ % subentry case), texindex reduces to two when writing the .??s
+ % sorted result.
+ \edef\temp{%
+ \write\writeto{%
+ \string\entry{\indexsortkey}{\noexpand\folio}{\the\toks0}}%
+ }%
+ \temp
+}
+\newbox\dummybox % used above
+
+% Take care of unwanted page breaks/skips around a whatsit:
+%
+% If a skip is the last thing on the list now, preserve it
+% by backing up by \lastskip, doing the \write, then inserting
+% the skip again. Otherwise, the whatsit generated by the
+% \write or \pdfdest will make \lastskip zero. The result is that
+% sequences like this:
+% @end defun
+% @tindex whatever
+% @defun ...
+% will have extra space inserted, because the \medbreak in the
+% start of the @defun won't see the skip inserted by the @end of
+% the previous defun.
+%
+% But don't do any of this if we're not in vertical mode. We
+% don't want to do a \vskip and prematurely end a paragraph.
+%
+% Avoid page breaks due to these extra skips, too.
+%
+% But wait, there is a catch there:
+% We'll have to check whether \lastskip is zero skip. \ifdim is not
+% sufficient for this purpose, as it ignores stretch and shrink parts
+% of the skip. The only way seems to be to check the textual
+% representation of the skip.
+%
+% The following is almost like \def\zeroskipmacro{0.0pt} except that
+% the ``p'' and ``t'' characters have catcode \other, not 11 (letter).
+%
+\edef\zeroskipmacro{\expandafter\the\csname address@hidden
+%
+\newskip\whatsitskip
+\newcount\whatsitpenalty
+%
+% ..., ready, GO:
+%
+\def\safewhatsit#1{\ifhmode
+ #1%
+ \else
+ % \lastskip and \lastpenalty cannot both be nonzero simultaneously.
+ \whatsitskip = \lastskip
+ \edef\lastskipmacro{\the\lastskip}%
+ \whatsitpenalty = \lastpenalty
+ %
+ % If \lastskip is nonzero, that means the last item was a
+ % skip. And since a skip is discardable, that means this
+ % -\whatsitskip glue we're inserting is preceded by a
+ % non-discardable item, therefore it is not a potential
+ % breakpoint, therefore no \nobreak needed.
+ \ifx\lastskipmacro\zeroskipmacro
+ \else
+ \vskip-\whatsitskip
+ \fi
+ %
+ #1%
+ %
+ \ifx\lastskipmacro\zeroskipmacro
+ % If \lastskip was zero, perhaps the last item was a penalty, and
+ % perhaps it was >=10000, e.g., a \nobreak. In that case, we want
+ % to re-insert the same penalty (values >10000 are used for various
+ % signals); since we just inserted a non-discardable item, any
+ % following glue (such as a \parskip) would be a breakpoint. For example:
+ % @deffn deffn-whatever
+ % @vindex index-whatever
+ % Description.
+ % would allow a break between the index-whatever whatsit
+ % and the "Description." paragraph.
+ \ifnum\whatsitpenalty>9999 \penalty\whatsitpenalty \fi
+ \else
+ % On the other hand, if we had a nonzero \lastskip,
+ % this make-up glue would be preceded by a non-discardable item
+ % (the whatsit from the \write), so we must insert a \nobreak.
+ \nobreak\vskip\whatsitskip
+ \fi
+\fi}
+
+% The index entry written in the file actually looks like
+% \entry {sortstring}{page}{topic}
+% or
+% \entry {sortstring}{page}{topic}{subtopic}
+% The texindex program reads in these files and writes files
+% containing these kinds of lines:
+% \initial {c}
+% before the first topic whose initial is c
+% \entry {topic}{pagelist}
+% for a topic that is used without subtopics
+% \primary {topic}
+% for the beginning of a topic that is used with subtopics
+% \secondary {subtopic}{pagelist}
+% for each subtopic.
+
+% Define the user-accessible indexing commands
+% @findex, @vindex, @kindex, @cindex.
+
+\def\findex {\fnindex}
+\def\kindex {\kyindex}
+\def\cindex {\cpindex}
+\def\vindex {\vrindex}
+\def\tindex {\tpindex}
+\def\pindex {\pgindex}
+
+\def\cindexsub {\begingroup\obeylines\cindexsub}
+{\obeylines %
+\gdef\cindexsub "#1" #2^^M{\endgroup %
+\dosubind{cp}{#2}{#1}}}
+
+% Define the macros used in formatting output of the sorted index material.
+
+% @printindex causes a particular index (the ??s file) to get printed.
+% It does not print any chapter heading (usually an @unnumbered).
+%
+\parseargdef\printindex{\begingroup
+ \dobreak \chapheadingskip{10000}%
+ %
+ \smallfonts \rm
+ \tolerance = 9500
+ \plainfrenchspacing
+ \everypar = {}% don't want the \kern\-parindent from indentation suppression.
+ %
+ % See if the index file exists and is nonempty.
+ % Change catcode of @ here so that if the index file contains
+ % \initial address@hidden
+ % as its first line, TeX doesn't complain about mismatched braces
+ % (because it thinks @} is a control sequence).
+ \catcode`\@ = 11
+ % See comment in \requireopenindexfile.
+ \def\indexname{#1}\ifx\indexname\indexisfl\def\indexname{f1}\fi
+ \openin 1 \jobname.\indexname s
+ \ifeof 1
+ % \enddoublecolumns gets confused if there is no text in the index,
+ % and it loses the chapter title and the aux file entries for the
+ % index. The easiest way to prevent this problem is to make sure
+ % there is some text.
+ \putwordIndexNonexistent
+ \else
+ \catcode`\\ = 0
+ \escapechar = `\\
+ %
+ % If the index file exists but is empty, then \openin leaves \ifeof
+ % false. We have to make TeX try to read something from the file, so
+ % it can discover if there is anything in it.
+ \read 1 to \thisline
+ \ifeof 1
+ \putwordIndexIsEmpty
+ \else
+ % Index files are almost Texinfo source, but we use \ as the escape
+ % character. It would be better to use @, but that's too big a change
+ % to make right now.
+ \def\indexbackslash{\ttbackslash}%
+ \let\indexlbrace\{ % Likewise, set these sequences for braces
+ \let\indexrbrace\} % used in the sort key.
+ \begindoublecolumns
+ \let\entryorphanpenalty=\indexorphanpenalty
+ %
+ % Read input from the index file line by line.
+ \loopdo
+ \ifeof1
+ \let\firsttoken\relax
+ \else
+ \read 1 to \nextline
+ \edef\act{\gdef\noexpand\firsttoken{\getfirsttoken\nextline}}%
+ \act
+ \fi
+ \thisline
+ %
+ \ifeof1\else
+ \let\thisline\nextline
+ \repeat
+ %%
+ \enddoublecolumns
+ \fi
+ \fi
+ \closein 1
+\endgroup}
+
+\def\getfirsttoken#1{\expandafter\getfirsttokenx#1\endfirsttoken}
+\long\def\getfirsttokenx#1#2\endfirsttoken{\noexpand#1}
+
+\def\loopdo#1\repeat{\def\body{#1}\loopdoxxx}
+\def\loopdoxxx{\let\next=\relax\body\let\next=\loopdoxxx\fi\next}
+
+% These macros are used by the sorted index file itself.
+% Change them to control the appearance of the index.
+
+{\catcode`\/=13 \catcode`\-=13 \catcode`\^=13 \catcode`\~=13 \catcode`\_=13
+\catcode`\|=13 \catcode`\<=13 \catcode`\>=13 \catcode`\+=13 \catcode`\"=13
+\catcode`\$=3
+\gdef\initialglyphs{%
+ % Some changes for non-alphabetic characters. Using the glyphs from the
+ % math fonts looks more consistent than the typewriter font used elsewhere
+ % for these characters.
+ \def\indexbackslash{\math{\backslash}}%
+ \let\\=\indexbackslash
+ %
+ % Can't get bold backslash so don't use bold forward slash
+ \catcode`\/=13
+ \def/{{\secrmnotbold \normalslash}}%
+ \def-{{\normaldash\normaldash}}% en dash `--'
+ \def^{{\chapbf \normalcaret}}%
+ \def~{{\chapbf \normaltilde}}%
+ \def\_{%
+ \leavevmode \kern.07em \vbox{\hrule width.3em height.1ex}\kern .07em }%
+ \def|{$\vert$}%
+ \def<{$\less$}%
+ \def>{$\gtr$}%
+ \def+{$\normalplus$}%
+}}
+
+\def\initial{%
+ \bgroup
+ \initialglyphs
+ \initialx
+}
+
+\def\initialx#1{%
+ % Remove any glue we may have, we'll be inserting our own.
+ \removelastskip
+ %
+ % We like breaks before the index initials, so insert a bonus.
+ % The glue before the bonus allows a little bit of space at the
+ % bottom of a column to reduce an increase in inter-line spacing.
+ \nobreak
+ \vskip 0pt plus 5\baselineskip
+ \penalty -300
+ \vskip 0pt plus -5\baselineskip
+ %
+ % Typeset the initial. Making this add up to a whole number of
+ % baselineskips increases the chance of the dots lining up from column
+ % to column. It still won't often be perfect, because of the stretch
+ % we need before each entry, but it's better.
+ %
+ % No shrink because it confuses \balancecolumns.
+ \vskip 1.67\baselineskip plus 1\baselineskip
+ \leftline{\secfonts \kern-0.05em \secbf #1}%
+ % \secfonts is inside the argument of \leftline so that the change of
+ % \baselineskip will not affect any glue inserted before the vbox that
+ % \leftline creates.
+ % Do our best not to break after the initial.
+ \nobreak
+ \vskip .33\baselineskip plus .1\baselineskip
+ \egroup % \initialglyphs
+}
+
+\newdimen\entryrightmargin
+\entryrightmargin=0pt
+
+% \entry typesets a paragraph consisting of the text (#1), dot leaders, and
+% then page number (#2) flushed to the right margin. It is used for index
+% and table of contents entries. The paragraph is indented by \leftskip.
+%
+\def\entry{%
+ \begingroup
+ %
+ % Start a new paragraph if necessary, so our assignments below can't
+ % affect previous text.
+ \par
+ %
+ % No extra space above this paragraph.
+ \parskip = 0in
+ %
+ % When reading the text of entry, convert explicit line breaks
+ % from @* into spaces. The user might give these in long section
+ % titles, for instance.
+ \def\*{\unskip\space\ignorespaces}%
+ \def\entrybreak{\hfil\break}% An undocumented command
+ %
+ % A bit of stretch before each entry for the benefit of balancing
+ % columns.
+ \vskip 0pt plus0.5pt
+ %
+ % Swallow the left brace of the text (first parameter):
+ \afterassignment\doentry
+ \let\temp =
+}
+\def\entrybreak{\unskip\space\ignorespaces}%
+\def\doentry{%
+ % Save the text of the entry
+ \global\setbox\boxA=\hbox\bgroup
+ \bgroup % Instead of the swallowed brace.
+ \noindent
+ \aftergroup\finishentry
+ % And now comes the text of the entry.
+ % Not absorbing as a macro argument reduces the chance of problems
+ % with catcodes occurring.
+}
address@hidden
+\gdef\finishentry#1{%
+ \egroup % end box A
+ \dimen@ = \wd\boxA % Length of text of entry
+ \global\setbox\boxA=\hbox\bgroup\unhbox\boxA
+ % #1 is the page number.
+ %
+ % Get the width of the page numbers, and only use
+ % leaders if they are present.
+ \global\setbox\boxB = \hbox{#1}%
+ \ifdim\wd\boxB = 0pt
+ \null\nobreak\hfill\ %
+ \else
+ %
+ \null\nobreak\indexdotfill % Have leaders before the page number.
+ %
+ \ifpdf
+ \pdfgettoks#1.%
+ \bgroup\let\domark\relax
+ \hskip\skip\thinshrinkable\the\toksA
+ \egroup
+ % The redefinion of \domark stops marks being added in \pdflink to
+ % preserve coloured links across page boundaries. Otherwise the marks
+ % would get in the way of \lastbox in \insertindexentrybox.
+ \else
+ \hskip\skip\thinshrinkable #1%
+ \fi
+ \fi
+ \egroup % end \boxA
+ \ifdim\wd\boxB = 0pt
+ \global\setbox\entryindexbox=\vbox{\unhbox\boxA}%
+ \else
+ \global\setbox\entryindexbox=\vbox\bgroup
+ \prevdepth=\entrylinedepth
+ \noindent
+ % We want the text of the entries to be aligned to the left, and the
+ % page numbers to be aligned to the right.
+ %
+ \advance\leftskip by 0pt plus 1fil
+ \advance\leftskip by 0pt plus -1fill
+ \rightskip = 0pt plus -1fil
+ \advance\rightskip by 0pt plus 1fill
+ % Cause last line, which could consist of page numbers on their own
+ % if the list of page numbers is long, to be aligned to the right.
+ \parfillskip=0pt plus -1fill
+ %
+ \hangindent=1em
+ %
+ \advance\rightskip by \entryrightmargin
+ % Determine how far we can stretch into the margin.
+ % This allows, e.g., "Appendix H GNU Free Documentation License" to
+ % fit on one line in @letterpaper format.
+ \ifdim\entryrightmargin>2.1em
+ address@hidden
+ \else
+ address@hidden
+ \fi
+ \advance \parfillskip by 0pt minus address@hidden
+ %
+ address@hidden = \hsize
+ address@hidden by -1\leftskip
+ address@hidden by -1\entryrightmargin
+ address@hidden by address@hidden
+ \ifdim\wd\boxA > address@hidden % If the entry doesn't fit in one line
+ \ifdim\dimen@ > address@hidden % due to long index text
+ \dimen@ = 0.7\dimen@ % Try to split the text roughly evenly
+ address@hidden = \hsize
+ \advance address@hidden by -1em
+ \ifnum\dimen@>address@hidden
+ % If the entry is too long, use the whole line
+ \dimen@ = address@hidden
+ \fi
+ \advance\leftskip by 0pt plus 1fill % ragged right
+ \advance \dimen@ by 1\rightskip
+ \parshape = 2 0pt \dimen@ 1em address@hidden
+ % Ideally we'd add a finite glue at the end of the first line only, but
+ % TeX doesn't seem to provide a way to do such a thing.
+ \fi\fi
+ \unhbox\boxA
+ %
+ % Do not prefer a separate line ending with a hyphen to fewer lines.
+ \finalhyphendemerits = 0
+ %
+ % Word spacing - no stretch
+ \spaceskip=\fontdimen2\font minus \fontdimen4\font
+ %
+ \linepenalty=1000 % Discourage line breaks.
+ \hyphenpenalty=5000 % Discourage hyphenation.
+ %
+ \par % format the paragraph
+ \egroup % The \vbox
+ \fi
+ \endgroup
+ % delay text of entry until after penalty
+ \bgroup\aftergroup\insertindexentrybox
+ \entryorphanpenalty
+}}
+
+\newskip\thinshrinkable
+\skip\thinshrinkable=.15em minus .15em
+
+\newbox\entryindexbox
+\def\insertindexentrybox{%
+ \copy\entryindexbox
+ % The following gets the depth of the last box. This is for even
+ % line spacing when entries span several lines.
+ \setbox\dummybox\vbox{%
+ \unvbox\entryindexbox
+ \nointerlineskip
+ \lastbox
+ \global\entrylinedepth=\prevdepth
+ }%
+ % Note that we couldn't simply \unvbox\entryindexbox followed by
+ % \nointerlineskip\lastbox to remove the last box and then reinstate it,
+ % because this resets how far the box has been \moveleft'ed to 0. \unvbox
+ % doesn't affect \prevdepth either.
+}
+\newdimen\entrylinedepth
+
+% Default is no penalty
+\let\entryorphanpenalty\egroup
+
+% Used from \printindex. \firsttoken should be the first token
+% after the \entry. If it's not another \entry, we are at the last
+% line of a group of index entries, so insert a penalty to discourage
+% orphaned index entries.
+\long\def\indexorphanpenalty{%
+ \def\isentry{\entry}%
+ \ifx\firsttoken\isentry
+ \else
+ \unskip\penalty 9000
+ % The \unskip here stops breaking before the glue. It relies on the
+ % \vskip above being there, otherwise there is an error
+ % "You can't use `\unskip' in vertical mode". There has to be glue
+ % in the current vertical list that hasn't been added to the
+ % "current page". See Chapter 24 of the TeXbook. This contradicts
+ % Section 8.3.7 in "TeX by Topic," though.
+ \fi
+ \egroup % now comes the box added with \aftergroup
+}
+
+% Like plain.tex's \dotfill, except uses up at least 1 em.
+% The filll stretch here overpowers both the fil and fill stretch to push
+% the page number to the right.
+\def\indexdotfill{\cleaders
+ \hbox{$\mathsurround=0pt \mkern1.5mu.\mkern1.5mu$}\hskip 1em plus 1filll}
+
+
+\def\primary #1{\line{#1\hfil}}
+
+\newskip\secondaryindent \secondaryindent=0.5cm
+\def\secondary#1#2{{%
+ \parfillskip=0in
+ \parskip=0in
+ \hangindent=1in
+ \hangafter=1
+ \noindent\hskip\secondaryindent\hbox{#1}\indexdotfill
+ \ifpdf
+ \pdfgettoks#2.\ \the\toksA % The page number ends the paragraph.
+ \else
+ #2
+ \fi
+ \par
+}}
+
+% Define two-column mode, which we use to typeset indexes.
+% Adapted from the TeXbook, page 416, which is to say,
+% the manmac.tex format used to print the TeXbook itself.
address@hidden % private names
+
+\newbox\partialpage
+\newdimen\doublecolumnhsize
+\newdimen\doublecolumntopgap
+\doublecolumntopgap = 0pt
+
+% Use inside an output routine to save \topmark and \firstmark
+\def\savemarks{%
+ \global\savedtopmark=\expandafter{\topmark }%
+ \global\savedfirstmark=\expandafter{\firstmark }%
+}
+\newtoks\savedtopmark
+\newtoks\savedfirstmark
+
+% Set \topmark and \firstmark for next time \output runs.
+% Can't be run from withinside \output (because any material
+% added while an output routine is active, including
+% penalties, is saved for after it finishes). The page so far
+% should be empty, otherwise what's on it will be thrown away.
+\def\restoremarks{%
+ \mark{\the\savedtopmark}%
+ \bgroup\output = {%
+ \setbox\dummybox=\box\PAGE
+ }abc\eject\egroup
+ % "abc" because output routine doesn't fire for a completely empty page.
+ \mark{\the\savedfirstmark}%
+}
+
+\def\begindoublecolumns{\begingroup % ended by \enddoublecolumns
+ % If not much space left on page, start a new page.
+ \ifdim\pagetotal>0.8\vsize\vfill\eject\fi
+ %
+ % Grab any single-column material above us.
+ \output = {%
+ %
+ % Here is a possibility not foreseen in manmac: if we accumulate a
+ % whole lot of material, we might end up calling this \output
+ % routine twice in a row (see the doublecol-lose test, which is
+ % essentially a couple of indexes with @setchapternewpage off). In
+ % that case we just ship out what is in \partialpage with the normal
+ % output routine. Generally, \partialpage will be empty when this
+ % runs and this will be a no-op. See the indexspread.tex test case.
+ \ifvoid\partialpage \else
+ \onepageout{\pagecontents\partialpage}%
+ \fi
+ %
+ \global\setbox\partialpage = \vbox{%
+ % Unvbox the main output page.
+ \unvbox\PAGE
+ \kern-\topskip \kern\baselineskip
+ }%
+ \savemarks
+ }%
+ \eject % run that output routine to set \partialpage
+ \restoremarks
+ %
+ % We recover the two marks that the last output routine saved in order
+ % to propagate the information in marks added around a chapter heading,
+ % which could be otherwise be lost by the time the final page is output.
+ %
+ %
+ % Use the double-column output routine for subsequent pages.
+ \output = {\doublecolumnout}%
+ %
+ % Change the page size parameters. We could do this once outside this
+ % routine, in each of @smallbook, @afourpaper, and the default 8.5x11
+ % format, but then we repeat the same computation. Repeating a couple
+ % of assignments once per index is clearly meaningless for the
+ % execution time, so we may as well do it in one place.
+ %
+ % First we halve the line length, less a little for the gutter between
+ % the columns. We compute the gutter based on the line length, so it
+ % changes automatically with the paper format. The magic constant
+ % below is chosen so that the gutter has the same value (well, +-<1pt)
+ % as it did when we hard-coded it.
+ %
+ % We put the result in a separate register, \doublecolumhsize, so we
+ % can restore it in \pagesofar, after \hsize itself has (potentially)
+ % been clobbered.
+ %
+ \doublecolumnhsize = \hsize
+ \advance\doublecolumnhsize by -.04154\hsize
+ \divide\doublecolumnhsize by 2
+ \hsize = \doublecolumnhsize
+ %
+ % Double the \vsize as well. (We don't need a separate register here,
+ % since nobody clobbers \vsize.)
+ \global\doublecolumntopgap = \topskip
+ \global\advance\doublecolumntopgap by -1\baselineskip
+ \advance\vsize by -1\doublecolumntopgap
+ \vsize = 2\vsize
+ \topskip=0pt
+ \global\entrylinedepth=0pt\relax
+}
+
+% The double-column output routine for all double-column pages except
+% the last, which is done by \balancecolumns.
+%
+\def\doublecolumnout{%
+ %
+ \splittopskip=\topskip \splitmaxdepth=\maxdepth
+ % Get the available space for the double columns -- the normal
+ % (undoubled) page height minus any material left over from the
+ % previous page.
+ \dimen@ = \vsize
+ \divide\dimen@ by 2
+ \advance\dimen@ by -\ht\partialpage
+ %
+ % box0 will be the left-hand column, box2 the right.
+ \setbox0=\vsplit255 to\dimen@ \setbox2=\vsplit255 to\dimen@
+ \onepageout\pagesofar
+ \unvbox255
+ \penalty\outputpenalty
+}
+%
+% Re-output the contents of the output page -- any previous material,
+% followed by the two boxes we just split, in box0 and box2.
+\def\pagesofar{%
+ \unvbox\partialpage
+ %
+ \hsize = \doublecolumnhsize
+ \wd0=\hsize \wd2=\hsize
+ \vbox{%
+ \vskip\doublecolumntopgap
+ \hbox to\pagewidth{\box0\hfil\box2}}%
+}
+
+
+% Finished with with double columns.
+\def\enddoublecolumns{%
+ % The following penalty ensures that the page builder is exercised
+ % _before_ we change the output routine. This is necessary in the
+ % following situation:
+ %
+ % The last section of the index consists only of a single entry.
+ % Before this section, \pagetotal is less than \pagegoal, so no
+ % break occurs before the last section starts. However, the last
+ % section, consisting of \initial and the single \entry, does not
+ % fit on the page and has to be broken off. Without the following
+ % penalty the page builder will not be exercised until \eject
+ % below, and by that time we'll already have changed the output
+ % routine to the \balancecolumns version, so the next-to-last
+ % double-column page will be processed with \balancecolumns, which
+ % is wrong: The two columns will go to the main vertical list, with
+ % the broken-off section in the recent contributions. As soon as
+ % the output routine finishes, TeX starts reconsidering the page
+ % break. The two columns and the broken-off section both fit on the
+ % page, because the two columns now take up only half of the page
+ % goal. When TeX sees \eject from below which follows the final
+ % section, it invokes the new output routine that we've set after
+ % \balancecolumns below; \onepageout will try to fit the two columns
+ % and the final section into the vbox of \pageheight (see
+ % \pagebody), causing an overfull box.
+ %
+ % Note that glue won't work here, because glue does not exercise the
+ % page builder, unlike penalties (see The TeXbook, pp. 280-281).
+ \penalty0
+ %
+ \output = {%
+ % Split the last of the double-column material.
+ \savemarks
+ \balancecolumns
+ %
+ % Having called \balancecolumns once, we do not
+ % want to call it again. Therefore, reset \output to its normal
+ % definition right away.
+ \global\output = {\onepageout{\pagecontents\PAGE}}%
+ }%
+ \eject
+ \endgroup % started in \begindoublecolumns
+ \restoremarks
+ % Leave the double-column material on the current page, no automatic
+ % page break.
+ \box\balancedcolumns
+ %
+ % \pagegoal was set to the doubled \vsize above, since we restarted
+ % the current page. We're now back to normal single-column
+ % typesetting, so reset \pagegoal to the normal \vsize (after the
+ % \endgroup where \vsize got restored).
+ \pagegoal = \vsize
+}
+\newbox\balancedcolumns
+\setbox\balancedcolumns=\vbox{shouldnt see this}%
+%
+% Only called for the last of the double column material. \doublecolumnout
+% does the others.
+\def\balancecolumns{%
+ \setbox0 = \vbox{\unvbox255}% like \box255 but more efficient, see p.120.
+ \dimen@ = \ht0
+ \advance\dimen@ by \topskip
+ \advance\dimen@ by-\baselineskip
+ \ifdim\dimen@<14\baselineskip
+ % Don't split a short final column in two.
+ \setbox2=\vbox{}%
+ \else
+ \divide\dimen@ by 2 % target to split to
+ address@hidden = \dimen@
+ \splittopskip = \topskip
+ % Loop until the second column is no higher than the first
+ {%
+ \vbadness = 10000
+ \loop
+ \global\setbox3 = \copy0
+ \global\setbox1 = \vsplit3 to \dimen@
+ % Remove glue from bottom of first column to
+ % make sure it is higher than the second.
+ \global\setbox1 = \vbox{\unvbox1\unpenalty\unskip}%
+ \ifdim\ht3>\ht1
+ \global\advance\dimen@ by 1pt
+ \repeat
+ }%
+ address@hidden by 4
+ address@hidden by 5
+ \ifdim\ht3<address@hidden
+ % Column heights are too different, so don't make their bottoms
+ % flush with each other. The glue at the end of the second column
+ % allows a second column to stretch, reducing the difference in
+ % height between the two.
+ \setbox0=\vbox address@hidden
+ \setbox2=\vbox address@hidden 0pt plus 0.3\ht0}%
+ \else
+ \setbox0=\vbox address@hidden
+ \setbox2=\vbox address@hidden
+ \fi
+ \fi
+ %
+ \global\setbox\balancedcolumns=\vbox{\pagesofar}%
+}
+\catcode`\@ = \other
+
+
+\message{sectioning,}
+% Chapters, sections, etc.
+
+% Let's start with @part.
+\outer\parseargdef\part{\partzzz{#1}}
+\def\partzzz#1{%
+ \chapoddpage
+ \null
+ \vskip.3\vsize % move it down on the page a bit
+ \begingroup
+ \noindent \titlefonts\rmisbold #1\par % the text
+ \let\lastnode=\empty % no node to associate with
+ \writetocentry{part}{#1}{}% but put it in the toc
+ \headingsoff % no headline or footline on the part page
+ % This outputs a mark at the end of the page that clears \thischapter
+ % and \thissection, as is done in \startcontents.
+ \let\pchapsepmacro\relax
+ \chapmacro{}{Yomitfromtoc}{}%
+ \chapoddpage
+ \endgroup
+}
+
+% \unnumberedno is an oxymoron. But we count the unnumbered
+% sections so that we can refer to them unambiguously in the pdf
+% outlines by their "section number". We avoid collisions with chapter
+% numbers by starting them at 10000. (If a document ever has 10000
+% chapters, we're in trouble anyway, I'm sure.)
+\newcount\unnumberedno \unnumberedno = 10000
+\newcount\chapno
+\newcount\secno \secno=0
+\newcount\subsecno \subsecno=0
+\newcount\subsubsecno \subsubsecno=0
+
+% This counter is funny since it counts through charcodes of letters A, B, ...
+\newcount\appendixno \appendixno = `\@
+%
+% \def\appendixletter{\char\the\appendixno}
+% We do the following ugly conditional instead of the above simple
+% construct for the sake of pdftex, which needs the actual
+% letter in the expansion, not just typeset.
+%
+\def\appendixletter{%
+ \ifnum\appendixno=`A A%
+ \else\ifnum\appendixno=`B B%
+ \else\ifnum\appendixno=`C C%
+ \else\ifnum\appendixno=`D D%
+ \else\ifnum\appendixno=`E E%
+ \else\ifnum\appendixno=`F F%
+ \else\ifnum\appendixno=`G G%
+ \else\ifnum\appendixno=`H H%
+ \else\ifnum\appendixno=`I I%
+ \else\ifnum\appendixno=`J J%
+ \else\ifnum\appendixno=`K K%
+ \else\ifnum\appendixno=`L L%
+ \else\ifnum\appendixno=`M M%
+ \else\ifnum\appendixno=`N N%
+ \else\ifnum\appendixno=`O O%
+ \else\ifnum\appendixno=`P P%
+ \else\ifnum\appendixno=`Q Q%
+ \else\ifnum\appendixno=`R R%
+ \else\ifnum\appendixno=`S S%
+ \else\ifnum\appendixno=`T T%
+ \else\ifnum\appendixno=`U U%
+ \else\ifnum\appendixno=`V V%
+ \else\ifnum\appendixno=`W W%
+ \else\ifnum\appendixno=`X X%
+ \else\ifnum\appendixno=`Y Y%
+ \else\ifnum\appendixno=`Z Z%
+ % The \the is necessary, despite appearances, because \appendixletter is
+ % expanded while writing the .toc file. \char\appendixno is not
+ % expandable, thus it is written literally, thus all appendixes come out
+ % with the same letter (or @) in the toc without it.
+ \else\char\the\appendixno
+ \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi
+ \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi}
+
+% Each @chapter defines these (using marks) as the number+name, number
+% and name of the chapter. Page headings and footings can use
+% these. @section does likewise.
+\def\thischapter{}
+\def\thischapternum{}
+\def\thischaptername{}
+\def\thissection{}
+\def\thissectionnum{}
+\def\thissectionname{}
+
+\newcount\absseclevel % used to calculate proper heading level
+\newcount\secbase\secbase=0 % @raisesections/@lowersections modify this count
+
+% @raisesections: treat @section as chapter, @subsection as section, etc.
+\def\raisesections{\global\advance\secbase by -1}
+\let\up=\raisesections % original BFox name
+
+% @lowersections: treat @chapter as section, @section as subsection, etc.
+\def\lowersections{\global\advance\secbase by 1}
+\let\down=\lowersections % original BFox name
+
+% we only have subsub.
+\chardef\maxseclevel = 3
+%
+% A numbered section within an unnumbered changes to unnumbered too.
+% To achieve this, remember the "biggest" unnum. sec. we are currently in:
+\chardef\unnlevel = \maxseclevel
+%
+% Trace whether the current chapter is an appendix or not:
+% \chapheadtype is "N" or "A", unnumbered chapters are ignored.
+\def\chapheadtype{N}
+
+% Choose a heading macro
+% #1 is heading type
+% #2 is heading level
+% #3 is text for heading
+\def\genhead#1#2#3{%
+ % Compute the abs. sec. level:
+ \absseclevel=#2
+ \advance\absseclevel by \secbase
+ % Make sure \absseclevel doesn't fall outside the range:
+ \ifnum \absseclevel < 0
+ \absseclevel = 0
+ \else
+ \ifnum \absseclevel > 3
+ \absseclevel = 3
+ \fi
+ \fi
+ % The heading type:
+ \def\headtype{#1}%
+ \if \headtype U%
+ \ifnum \absseclevel < \unnlevel
+ \chardef\unnlevel = \absseclevel
+ \fi
+ \else
+ % Check for appendix sections:
+ \ifnum \absseclevel = 0
+ \edef\chapheadtype{\headtype}%
+ \else
+ \if \headtype A\if \chapheadtype N%
+ address@hidden within a non-appendix chapter}%
+ \fi\fi
+ \fi
+ % Check for numbered within unnumbered:
+ \ifnum \absseclevel > \unnlevel
+ \def\headtype{U}%
+ \else
+ \chardef\unnlevel = 3
+ \fi
+ \fi
+ % Now print the heading:
+ \if \headtype U%
+ \ifcase\absseclevel
+ \unnumberedzzz{#3}%
+ \or \unnumberedseczzz{#3}%
+ \or \unnumberedsubseczzz{#3}%
+ \or \unnumberedsubsubseczzz{#3}%
+ \fi
+ \else
+ \if \headtype A%
+ \ifcase\absseclevel
+ \appendixzzz{#3}%
+ \or \appendixsectionzzz{#3}%
+ \or \appendixsubseczzz{#3}%
+ \or \appendixsubsubseczzz{#3}%
+ \fi
+ \else
+ \ifcase\absseclevel
+ \chapterzzz{#3}%
+ \or \seczzz{#3}%
+ \or \numberedsubseczzz{#3}%
+ \or \numberedsubsubseczzz{#3}%
+ \fi
+ \fi
+ \fi
+ \suppressfirstparagraphindent
+}
+
+% an interface:
+\def\numhead{\genhead N}
+\def\apphead{\genhead A}
+\def\unnmhead{\genhead U}
+
+% @chapter, @appendix, @unnumbered. Increment top-level counter, reset
+% all lower-level sectioning counters to zero.
+%
+% Also set \chaplevelprefix, which we prepend to @float sequence numbers
+% (e.g., figures), q.v. By default (before any chapter), that is empty.
+\let\chaplevelprefix = \empty
+%
+\outer\parseargdef\chapter{\numhead0{#1}} % normally numhead0 calls chapterzzz
+\def\chapterzzz#1{%
+ % section resetting is \global in case the chapter is in a group, such
+ % as an @include file.
+ \global\secno=0 \global\subsecno=0 \global\subsubsecno=0
+ \global\advance\chapno by 1
+ %
+ % Used for \float.
+ \gdef\chaplevelprefix{\the\chapno.}%
+ \resetallfloatnos
+ %
+ % \putwordChapter can contain complex things in translations.
+ \toks0=\expandafter{\putwordChapter}%
+ \message{\the\toks0 \space \the\chapno}%
+ %
+ % Write the actual heading.
+ \chapmacro{#1}{Ynumbered}{\the\chapno}%
+ %
+ % So @section and the like are numbered underneath this chapter.
+ \global\let\section = \numberedsec
+ \global\let\subsection = \numberedsubsec
+ \global\let\subsubsection = \numberedsubsubsec
+}
+
+\outer\parseargdef\appendix{\apphead0{#1}} % normally calls appendixzzz
+%
+\def\appendixzzz#1{%
+ \global\secno=0 \global\subsecno=0 \global\subsubsecno=0
+ \global\advance\appendixno by 1
+ \gdef\chaplevelprefix{\appendixletter.}%
+ \resetallfloatnos
+ %
+ % \putwordAppendix can contain complex things in translations.
+ \toks0=\expandafter{\putwordAppendix}%
+ \message{\the\toks0 \space \appendixletter}%
+ %
+ \chapmacro{#1}{Yappendix}{\appendixletter}%
+ %
+ \global\let\section = \appendixsec
+ \global\let\subsection = \appendixsubsec
+ \global\let\subsubsection = \appendixsubsubsec
+}
+
+% normally unnmhead0 calls unnumberedzzz:
+\outer\parseargdef\unnumbered{\unnmhead0{#1}}
+\def\unnumberedzzz#1{%
+ \global\secno=0 \global\subsecno=0 \global\subsubsecno=0
+ \global\advance\unnumberedno by 1
+ %
+ % Since an unnumbered has no number, no prefix for figures.
+ \global\let\chaplevelprefix = \empty
+ \resetallfloatnos
+ %
+ % This used to be simply \message{#1}, but TeX fully expands the
+ % argument to \message. Therefore, if #1 contained @-commands, TeX
+ % expanded them. For example, in address@hidden The @cite{Book}', TeX
+ % expanded @cite (which turns out to cause errors because \cite is meant
+ % to be executed, not expanded).
+ %
+ % Anyway, we don't want the fully-expanded definition of @cite to appear
+ % as a result of the \message, we just want address@hidden' itself. We use
+ % \the<toks register> to achieve this: TeX expands \the<toks> only once,
+ % simply yielding the contents of <toks register>. (We also do this for
+ % the toc entries.)
+ \toks0 = {#1}%
+ \message{(\the\toks0)}%
+ %
+ \chapmacro{#1}{Ynothing}{\the\unnumberedno}%
+ %
+ \global\let\section = \unnumberedsec
+ \global\let\subsection = \unnumberedsubsec
+ \global\let\subsubsection = \unnumberedsubsubsec
+}
+
+% @centerchap is like @unnumbered, but the heading is centered.
+\outer\parseargdef\centerchap{%
+ \let\centerparametersmaybe = \centerparameters
+ \unnmhead0{#1}%
+ \let\centerparametersmaybe = \relax
+}
+
+% @top is like @unnumbered.
+\let\top\unnumbered
+
+% Sections.
+%
+\outer\parseargdef\numberedsec{\numhead1{#1}} % normally calls seczzz
+\def\seczzz#1{%
+ \global\subsecno=0 \global\subsubsecno=0 \global\advance\secno by 1
+ \sectionheading{#1}{sec}{Ynumbered}{\the\chapno.\the\secno}%
+}
+
+% normally calls appendixsectionzzz:
+\outer\parseargdef\appendixsection{\apphead1{#1}}
+\def\appendixsectionzzz#1{%
+ \global\subsecno=0 \global\subsubsecno=0 \global\advance\secno by 1
+ \sectionheading{#1}{sec}{Yappendix}{\appendixletter.\the\secno}%
+}
+\let\appendixsec\appendixsection
+
+% normally calls unnumberedseczzz:
+\outer\parseargdef\unnumberedsec{\unnmhead1{#1}}
+\def\unnumberedseczzz#1{%
+ \global\subsecno=0 \global\subsubsecno=0 \global\advance\secno by 1
+ \sectionheading{#1}{sec}{Ynothing}{\the\unnumberedno.\the\secno}%
+}
+
+% Subsections.
+%
+% normally calls numberedsubseczzz:
+\outer\parseargdef\numberedsubsec{\numhead2{#1}}
+\def\numberedsubseczzz#1{%
+ \global\subsubsecno=0 \global\advance\subsecno by 1
+ \sectionheading{#1}{subsec}{Ynumbered}{\the\chapno.\the\secno.\the\subsecno}%
+}
+
+% normally calls appendixsubseczzz:
+\outer\parseargdef\appendixsubsec{\apphead2{#1}}
+\def\appendixsubseczzz#1{%
+ \global\subsubsecno=0 \global\advance\subsecno by 1
+ \sectionheading{#1}{subsec}{Yappendix}%
+ {\appendixletter.\the\secno.\the\subsecno}%
+}
+
+% normally calls unnumberedsubseczzz:
+\outer\parseargdef\unnumberedsubsec{\unnmhead2{#1}}
+\def\unnumberedsubseczzz#1{%
+ \global\subsubsecno=0 \global\advance\subsecno by 1
+ \sectionheading{#1}{subsec}{Ynothing}%
+ {\the\unnumberedno.\the\secno.\the\subsecno}%
+}
+
+% Subsubsections.
+%
+% normally numberedsubsubseczzz:
+\outer\parseargdef\numberedsubsubsec{\numhead3{#1}}
+\def\numberedsubsubseczzz#1{%
+ \global\advance\subsubsecno by 1
+ \sectionheading{#1}{subsubsec}{Ynumbered}%
+ {\the\chapno.\the\secno.\the\subsecno.\the\subsubsecno}%
+}
+
+% normally appendixsubsubseczzz:
+\outer\parseargdef\appendixsubsubsec{\apphead3{#1}}
+\def\appendixsubsubseczzz#1{%
+ \global\advance\subsubsecno by 1
+ \sectionheading{#1}{subsubsec}{Yappendix}%
+ {\appendixletter.\the\secno.\the\subsecno.\the\subsubsecno}%
+}
+
+% normally unnumberedsubsubseczzz:
+\outer\parseargdef\unnumberedsubsubsec{\unnmhead3{#1}}
+\def\unnumberedsubsubseczzz#1{%
+ \global\advance\subsubsecno by 1
+ \sectionheading{#1}{subsubsec}{Ynothing}%
+ {\the\unnumberedno.\the\secno.\the\subsecno.\the\subsubsecno}%
+}
+
+% These macros control what the section commands do, according
+% to what kind of chapter we are in (ordinary, appendix, or unnumbered).
+% Define them by default for a numbered chapter.
+\let\section = \numberedsec
+\let\subsection = \numberedsubsec
+\let\subsubsection = \numberedsubsubsec
+
+% Define @majorheading, @heading and @subheading
+
+\def\majorheading{%
+ {\advance\chapheadingskip by 10pt \chapbreak }%
+ \parsearg\chapheadingzzz
+}
+
+\def\chapheading{\chapbreak \parsearg\chapheadingzzz}
+\def\chapheadingzzz#1{%
+ \vbox{\chapfonts \raggedtitlesettings #1\par}%
+ \nobreak\bigskip \nobreak
+ \suppressfirstparagraphindent
+}
+
+% @heading, @subheading, @subsubheading.
+\parseargdef\heading{\sectionheading{#1}{sec}{Yomitfromtoc}{}
+ \suppressfirstparagraphindent}
+\parseargdef\subheading{\sectionheading{#1}{subsec}{Yomitfromtoc}{}
+ \suppressfirstparagraphindent}
+\parseargdef\subsubheading{\sectionheading{#1}{subsubsec}{Yomitfromtoc}{}
+ \suppressfirstparagraphindent}
+
+% These macros generate a chapter, section, etc. heading only
+% (including whitespace, linebreaking, etc. around it),
+% given all the information in convenient, parsed form.
+
+% Args are the skip and penalty (usually negative)
+\def\dobreak#1#2{\par\ifdim\lastskip<#1\removelastskip\penalty#2\vskip#1\fi}
+
+% Parameter controlling skip before chapter headings (if needed)
+\newskip\chapheadingskip
+
+% Define plain chapter starts, and page on/off switching for it.
+\def\chapbreak{\dobreak \chapheadingskip {-4000}}
+
+% Start a new page
+\def\chappager{\par\vfill\supereject}
+
+% \chapoddpage - start on an odd page for a new chapter
+% Because \domark is called before \chapoddpage, the filler page will
+% get the headings for the next chapter, which is wrong. But we don't
+% care -- we just disable all headings on the filler page.
+\def\chapoddpage{%
+ \chappager
+ \ifodd\pageno \else
+ \begingroup
+ \headingsoff
+ \null
+ \chappager
+ \endgroup
+ \fi
+}
+
+\def\setchapternewpage #1 {\csname CHAPPAG#1\endcsname}
+
+\def\CHAPPAGoff{%
+\global\let\contentsalignmacro = \chappager
+\global\let\pchapsepmacro=\chapbreak
+\global\let\pagealignmacro=\chappager}
+
+\def\CHAPPAGon{%
+\global\let\contentsalignmacro = \chappager
+\global\let\pchapsepmacro=\chappager
+\global\let\pagealignmacro=\chappager
+\global\def\HEADINGSon{\HEADINGSsingle}}
+
+\def\CHAPPAGodd{%
+\global\let\contentsalignmacro = \chapoddpage
+\global\let\pchapsepmacro=\chapoddpage
+\global\let\pagealignmacro=\chapoddpage
+\global\def\HEADINGSon{\HEADINGSdouble}}
+
+\CHAPPAGon
+
+% \chapmacro - Chapter opening.
+%
+% #1 is the text, #2 is the section type (Ynumbered, Ynothing,
+% Yappendix, Yomitfromtoc), #3 the chapter number.
+% Not used for @heading series.
+%
+% To test against our argument.
+\def\Ynothingkeyword{Ynothing}
+\def\Yappendixkeyword{Yappendix}
+\def\Yomitfromtockeyword{Yomitfromtoc}
+%
+\def\chapmacro#1#2#3{%
+ \expandafter\ifx\thisenv\titlepage\else
+ \checkenv{}% chapters, etc., should not start inside an environment.
+ \fi
+ % FIXME: \chapmacro is currently called from inside \titlepage when
+ % \setcontentsaftertitlepage to print the "Table of Contents" heading, but
+ % this should probably be done by \sectionheading with an option to print
+ % in chapter size.
+ %
+ % Insert the first mark before the heading break (see notes for \domark).
+ \let\prevchapterdefs=\lastchapterdefs
+ \let\prevsectiondefs=\lastsectiondefs
+ \gdef\lastsectiondefs{\gdef\thissectionname{}\gdef\thissectionnum{}%
+ \gdef\thissection{}}%
+ %
+ \def\temptype{#2}%
+ \ifx\temptype\Ynothingkeyword
+ \gdef\lastchapterdefs{\gdef\thischaptername{#1}\gdef\thischapternum{}%
+ \gdef\thischapter{\thischaptername}}%
+ \else\ifx\temptype\Yomitfromtockeyword
+ \gdef\lastchapterdefs{\gdef\thischaptername{#1}\gdef\thischapternum{}%
+ \gdef\thischapter{}}%
+ \else\ifx\temptype\Yappendixkeyword
+ \toks0={#1}%
+ \xdef\lastchapterdefs{%
+ \gdef\noexpand\thischaptername{\the\toks0}%
+ \gdef\noexpand\thischapternum{\appendixletter}%
+ % \noexpand\putwordAppendix avoids expanding indigestible
+ % commands in some of the translations.
+ \gdef\noexpand\thischapter{\noexpand\putwordAppendix{}
+ \noexpand\thischapternum:
+ \noexpand\thischaptername}%
+ }%
+ \else
+ \toks0={#1}%
+ \xdef\lastchapterdefs{%
+ \gdef\noexpand\thischaptername{\the\toks0}%
+ \gdef\noexpand\thischapternum{\the\chapno}%
+ % \noexpand\putwordChapter avoids expanding indigestible
+ % commands in some of the translations.
+ \gdef\noexpand\thischapter{\noexpand\putwordChapter{}
+ \noexpand\thischapternum:
+ \noexpand\thischaptername}%
+ }%
+ \fi\fi\fi
+ %
+ % Output the mark. Pass it through \safewhatsit, to take care of
+ % the preceding space.
+ \safewhatsit\domark
+ %
+ % Insert the chapter heading break.
+ \pchapsepmacro
+ %
+ % Now the second mark, after the heading break. No break points
+ % between here and the heading.
+ \let\prevchapterdefs=\lastchapterdefs
+ \let\prevsectiondefs=\lastsectiondefs
+ \domark
+ %
+ {%
+ \chapfonts \rmisbold
+ \let\footnote=\errfootnoteheading % give better error message
+ %
+ % Have to define \lastsection before calling \donoderef, because the
+ % xref code eventually uses it. On the other hand, it has to be called
+ % after \pchapsepmacro, or the headline will change too soon.
+ \gdef\lastsection{#1}%
+ %
+ % Only insert the separating space if we have a chapter/appendix
+ % number, and don't print the unnumbered ``number''.
+ \ifx\temptype\Ynothingkeyword
+ \setbox0 = \hbox{}%
+ \def\toctype{unnchap}%
+ \else\ifx\temptype\Yomitfromtockeyword
+ \setbox0 = \hbox{}% contents like unnumbered, but no toc entry
+ \def\toctype{omit}%
+ \else\ifx\temptype\Yappendixkeyword
+ \setbox0 = \hbox{\putwordAppendix{} #3\enspace}%
+ \def\toctype{app}%
+ \else
+ \setbox0 = \hbox{#3\enspace}%
+ \def\toctype{numchap}%
+ \fi\fi\fi
+ %
+ % Write the toc entry for this chapter. Must come before the
+ % \donoderef, because we include the current node name in the toc
+ % entry, and \donoderef resets it to empty.
+ \writetocentry{\toctype}{#1}{#3}%
+ %
+ % For pdftex, we have to write out the node definition (aka, make
+ % the pdfdest) after any page break, but before the actual text has
+ % been typeset. If the destination for the pdf outline is after the
+ % text, then jumping from the outline may wind up with the text not
+ % being visible, for instance under high magnification.
+ \donoderef{#2}%
+ %
+ % Typeset the actual heading.
+ \nobreak % Avoid page breaks at the interline glue.
+ \vbox{\raggedtitlesettings \hangindent=\wd0 \centerparametersmaybe
+ \unhbox0 #1\par}%
+ }%
+ \nobreak\bigskip % no page break after a chapter title
+ \nobreak
+}
+
+% @centerchap -- centered and unnumbered.
+\let\centerparametersmaybe = \relax
+\def\centerparameters{%
+ \advance\rightskip by 3\rightskip
+ \leftskip = \rightskip
+ \parfillskip = 0pt
+}
+
+
+% I don't think this chapter style is supported any more, so I'm not
+% updating it with the new noderef stuff. We'll see. --karl, 11aug03.
+%
+\def\setchapterstyle #1 {\csname CHAPF#1\endcsname}
+%
+\def\unnchfopen #1{%
+ \chapoddpage
+ \vbox{\chapfonts \raggedtitlesettings #1\par}%
+ \nobreak\bigskip\nobreak
+}
+\def\chfopen #1#2{\chapoddpage {\chapfonts
+\vbox to 3in{\vfil \hbox to\hsize{\hfil #2} \hbox to\hsize{\hfil #1} \vfil}}%
+\par\penalty 5000 %
+}
+\def\centerchfopen #1{%
+ \chapoddpage
+ \vbox{\chapfonts \raggedtitlesettings \hfill #1\hfill}%
+ \nobreak\bigskip \nobreak
+}
+\def\CHAPFopen{%
+ \global\let\chapmacro=\chfopen
+ \global\let\centerchapmacro=\centerchfopen}
+
+
+% Section titles. These macros combine the section number parts and
+% call the generic \sectionheading to do the printing.
+%
+\newskip\secheadingskip
+\def\secheadingbreak{\dobreak \secheadingskip{-1000}}
+
+% Subsection titles.
+\newskip\subsecheadingskip
+\def\subsecheadingbreak{\dobreak \subsecheadingskip{-500}}
+
+% Subsubsection titles.
+\def\subsubsecheadingskip{\subsecheadingskip}
+\def\subsubsecheadingbreak{\subsecheadingbreak}
+
+
+% Print any size, any type, section title.
+%
+% #1 is the text of the title,
+% #2 is the section level (sec/subsec/subsubsec),
+% #3 is the section type (Ynumbered, Ynothing, Yappendix, Yomitfromtoc),
+% #4 is the section number.
+%
+\def\seckeyword{sec}
+%
+\def\sectionheading#1#2#3#4{%
+ {%
+ \def\sectionlevel{#2}%
+ \def\temptype{#3}%
+ %
+ % It is ok for the @heading series commands to appear inside an
+ % environment (it's been historically allowed, though the logic is
+ % dubious), but not the others.
+ \ifx\temptype\Yomitfromtockeyword\else
+ \checkenv{}% address@hidden should not be in an environment.
+ \fi
+ \let\footnote=\errfootnoteheading
+ %
+ % Switch to the right set of fonts.
+ \csname #2fonts\endcsname \rmisbold
+ %
+ % Insert first mark before the heading break (see notes for \domark).
+ \let\prevsectiondefs=\lastsectiondefs
+ \ifx\temptype\Ynothingkeyword
+ \ifx\sectionlevel\seckeyword
+ \gdef\lastsectiondefs{\gdef\thissectionname{#1}\gdef\thissectionnum{}%
+ \gdef\thissection{\thissectionname}}%
+ \fi
+ \else\ifx\temptype\Yomitfromtockeyword
+ % Don't redefine \thissection.
+ \else\ifx\temptype\Yappendixkeyword
+ \ifx\sectionlevel\seckeyword
+ \toks0={#1}%
+ \xdef\lastsectiondefs{%
+ \gdef\noexpand\thissectionname{\the\toks0}%
+ \gdef\noexpand\thissectionnum{#4}%
+ % \noexpand\putwordSection avoids expanding indigestible
+ % commands in some of the translations.
+ \gdef\noexpand\thissection{\noexpand\putwordSection{}
+ \noexpand\thissectionnum:
+ \noexpand\thissectionname}%
+ }%
+ \fi
+ \else
+ \ifx\sectionlevel\seckeyword
+ \toks0={#1}%
+ \xdef\lastsectiondefs{%
+ \gdef\noexpand\thissectionname{\the\toks0}%
+ \gdef\noexpand\thissectionnum{#4}%
+ % \noexpand\putwordSection avoids expanding indigestible
+ % commands in some of the translations.
+ \gdef\noexpand\thissection{\noexpand\putwordSection{}
+ \noexpand\thissectionnum:
+ \noexpand\thissectionname}%
+ }%
+ \fi
+ \fi\fi\fi
+ %
+ % Go into vertical mode. Usually we'll already be there, but we
+ % don't want the following whatsit to end up in a preceding paragraph
+ % if the document didn't happen to have a blank line.
+ \par
+ %
+ % Output the mark. Pass it through \safewhatsit, to take care of
+ % the preceding space.
+ \safewhatsit\domark
+ %
+ % Insert space above the heading.
+ \csname #2headingbreak\endcsname
+ %
+ % Now the second mark, after the heading break. No break points
+ % between here and the heading.
+ \global\let\prevsectiondefs=\lastsectiondefs
+ \domark
+ %
+ % Only insert the space after the number if we have a section number.
+ \ifx\temptype\Ynothingkeyword
+ \setbox0 = \hbox{}%
+ \def\toctype{unn}%
+ \gdef\lastsection{#1}%
+ \else\ifx\temptype\Yomitfromtockeyword
+ % for @headings -- no section number, don't include in toc,
+ % and don't redefine \lastsection.
+ \setbox0 = \hbox{}%
+ \def\toctype{omit}%
+ \let\sectionlevel=\empty
+ \else\ifx\temptype\Yappendixkeyword
+ \setbox0 = \hbox{#4\enspace}%
+ \def\toctype{app}%
+ \gdef\lastsection{#1}%
+ \else
+ \setbox0 = \hbox{#4\enspace}%
+ \def\toctype{num}%
+ \gdef\lastsection{#1}%
+ \fi\fi\fi
+ %
+ % Write the toc entry (before \donoderef). See comments in \chapmacro.
+ \writetocentry{\toctype\sectionlevel}{#1}{#4}%
+ %
+ % Write the node reference (= pdf destination for pdftex).
+ % Again, see comments in \chapmacro.
+ \donoderef{#3}%
+ %
+ % Interline glue will be inserted when the vbox is completed.
+ % That glue will be a valid breakpoint for the page, since it'll be
+ % preceded by a whatsit (usually from the \donoderef, or from the
+ % \writetocentry if there was no node). We don't want to allow that
+ % break, since then the whatsits could end up on page n while the
+ % section is on page n+1, thus toc/etc. are wrong. Debian bug 276000.
+ \nobreak
+ %
+ % Output the actual section heading.
+ \vbox{\hyphenpenalty=10000 \tolerance=5000 \parindent=0pt \ptexraggedright
+ \hangindent=\wd0 % zero if no section number
+ \unhbox0 #1}%
+ }%
+ % Add extra space after the heading -- half of whatever came above it.
+ % Don't allow stretch, though.
+ \kern .5 \csname #2headingskip\endcsname
+ %
+ % Do not let the kern be a potential breakpoint, as it would be if it
+ % was followed by glue.
+ \nobreak
+ %
+ % We'll almost certainly start a paragraph next, so don't let that
+ % glue accumulate. (Not a breakpoint because it's preceded by a
+ % discardable item.) However, when a paragraph is not started next
+ % (\startdefun, \cartouche, \center, etc.), this needs to be wiped out
+ % or the negative glue will cause weirdly wrong output, typically
+ % obscuring the section heading with something else.
+ \vskip-\parskip
+ %
+ % This is so the last item on the main vertical list is a known
+ % \penalty > 10000, so \startdefun, etc., can recognize the situation
+ % and do the needful.
+ \penalty 10001
+}
+
+
+\message{toc,}
+% Table of contents.
+\newwrite\tocfile
+
+% Write an entry to the toc file, opening it if necessary.
+% Called from @chapter, etc.
+%
+% Example usage: \writetocentry{sec}{Section Name}{\the\chapno.\the\secno}
+% We append the current node name (if any) and page number as additional
+% arguments for the \{chap,sec,...}entry macros which will eventually
+% read this. The node name is used in the pdf outlines as the
+% destination to jump to.
+%
+% We open the .toc file for writing here instead of at @setfilename (or
+% any other fixed time) so that @contents can be anywhere in the document.
+% But if #1 is `omit', then we don't do anything. This is used for the
+% table of contents chapter openings themselves.
+%
+\newif\iftocfileopened
+\def\omitkeyword{omit}%
+%
+\def\writetocentry#1#2#3{%
+ \edef\writetoctype{#1}%
+ \ifx\writetoctype\omitkeyword \else
+ \iftocfileopened\else
+ \immediate\openout\tocfile = \jobname.toc
+ \global\tocfileopenedtrue
+ \fi
+ %
+ \iflinks
+ {\atdummies
+ \edef\temp{%
+ address@hidden
+ \temp
+ }%
+ \fi
+ \fi
+ %
+ % Tell \shipout to create a pdf destination on each page, if we're
+ % writing pdf. These are used in the table of contents. We can't
+ % just write one on every page because the title pages are numbered
+ % 1 and 2 (the page numbers aren't printed), and so are the first
+ % two pages of the document. Thus, we'd have two destinations named
+ % `1', and two named `2'.
+ \ifpdf \global\pdfmakepagedesttrue \fi
+}
+
+
+% These characters do not print properly in the Computer Modern roman
+% fonts, so we must take special care. This is more or less redundant
+% with the Texinfo input format setup at the end of this file.
+%
+\def\activecatcodes{%
+ \catcode`\"=\active
+ \catcode`\$=\active
+ \catcode`\<=\active
+ \catcode`\>=\active
+ \catcode`\\=\active
+ \catcode`\^=\active
+ \catcode`\_=\active
+ \catcode`\|=\active
+ \catcode`\~=\active
+}
+
+
+% Read the toc file, which is essentially Texinfo input.
+\def\readtocfile{%
+ \setupdatafile
+ \activecatcodes
+ \input \tocreadfilename
+}
+
+\newskip\contentsrightmargin \contentsrightmargin=1in
+\newcount\savepageno
+\newcount\lastnegativepageno \lastnegativepageno = -1
+
+% Prepare to read what we've written to \tocfile.
+%
+\def\startcontents#1{%
+ % If @setchapternewpage on, and @headings double, the contents should
+ % start on an odd page, unlike chapters. Thus, we maintain
+ % \contentsalignmacro in parallel with \pagealignmacro.
+ % From: Torbjorn Granlund <address@hidden>
+ \contentsalignmacro
+ \immediate\closeout\tocfile
+ %
+ % Don't need to put `Contents' or `Short Contents' in the headline.
+ % It is abundantly clear what they are.
+ \chapmacro{#1}{Yomitfromtoc}{}%
+ %
+ \savepageno = \pageno
+ \begingroup % Set up to handle contents files properly.
+ \raggedbottom % Worry more about breakpoints than the bottom.
+ \entryrightmargin=\contentsrightmargin % Don't use the full line length.
+ %
+ % Roman numerals for page numbers.
+ \ifnum \pageno>0 \global\pageno = \lastnegativepageno \fi
+}
+
+% redefined for the two-volume lispref. We always output on
+% \jobname.toc even if this is redefined.
+%
+\def\tocreadfilename{\jobname.toc}
+
+% Normal (long) toc.
+%
+\def\contents{%
+ \startcontents{\putwordTOC}%
+ \openin 1 \tocreadfilename\space
+ \ifeof 1 \else
+ \readtocfile
+ \fi
+ \vfill \eject
+ \contentsalignmacro % in case @setchapternewpage odd is in effect
+ \ifeof 1 \else
+ \pdfmakeoutlines
+ \fi
+ \closein 1
+ \endgroup
+ \lastnegativepageno = \pageno
+ \global\pageno = \savepageno
+}
+
+% And just the chapters.
+\def\summarycontents{%
+ \startcontents{\putwordShortTOC}%
+ %
+ \let\partentry = \shortpartentry
+ \let\numchapentry = \shortchapentry
+ \let\appentry = \shortchapentry
+ \let\unnchapentry = \shortunnchapentry
+ % We want a true roman here for the page numbers.
+ \secfonts
+ \let\rm=\shortcontrm \let\bf=\shortcontbf
+ \let\sl=\shortcontsl \let\tt=\shortconttt
+ \rm
+ \hyphenpenalty = 10000
+ \advance\baselineskip by 1pt % Open it up a little.
+ \def\numsecentry##1##2##3##4{}
+ \let\appsecentry = \numsecentry
+ \let\unnsecentry = \numsecentry
+ \let\numsubsecentry = \numsecentry
+ \let\appsubsecentry = \numsecentry
+ \let\unnsubsecentry = \numsecentry
+ \let\numsubsubsecentry = \numsecentry
+ \let\appsubsubsecentry = \numsecentry
+ \let\unnsubsubsecentry = \numsecentry
+ \openin 1 \tocreadfilename\space
+ \ifeof 1 \else
+ \readtocfile
+ \fi
+ \closein 1
+ \vfill \eject
+ \contentsalignmacro % in case @setchapternewpage odd is in effect
+ \endgroup
+ \lastnegativepageno = \pageno
+ \global\pageno = \savepageno
+}
+\let\shortcontents = \summarycontents
+
+% Typeset the label for a chapter or appendix for the short contents.
+% The arg is, e.g., `A' for an appendix, or `3' for a chapter.
+%
+\def\shortchaplabel#1{%
+ % This space should be enough, since a single number is .5em, and the
+ % widest letter (M) is 1em, at least in the Computer Modern fonts.
+ % But use \hss just in case.
+ % (This space doesn't include the extra space that gets added after
+ % the label; that gets put in by \shortchapentry above.)
+ %
+ % We'd like to right-justify chapter numbers, but that looks strange
+ % with appendix letters. And right-justifying numbers and
+ % left-justifying letters looks strange when there is less than 10
+ % chapters. Have to read the whole toc once to know how many chapters
+ % there are before deciding ...
+ \hbox to 1em{#1\hss}%
+}
+
+% These macros generate individual entries in the table of contents.
+% The first argument is the chapter or section name.
+% The last argument is the page number.
+% The arguments in between are the chapter number, section number, ...
+
+% Parts, in the main contents. Replace the part number, which doesn't
+% exist, with an empty box. Let's hope all the numbers have the same width.
+% Also ignore the page number, which is conventionally not printed.
+\def\numeralbox{\setbox0=\hbox{8}\hbox to \wd0{\hfil}}
+\def\partentry#1#2#3#4{\dochapentry{\numeralbox\labelspace#1}{}}
+%
+% Parts, in the short toc.
+\def\shortpartentry#1#2#3#4{%
+ \penalty-300
+ \vskip.5\baselineskip plus.15\baselineskip minus.1\baselineskip
+ \shortchapentry{{\bf #1}}{\numeralbox}{}{}%
+}
+
+% Chapters, in the main contents.
+\def\numchapentry#1#2#3#4{\dochapentry{#2\labelspace#1}{#4}}
+
+% Chapters, in the short toc.
+% See comments in \dochapentry re vbox and related settings.
+\def\shortchapentry#1#2#3#4{%
+ \tocentry{\shortchaplabel{#2}\labelspace #1}{\doshortpageno\bgroup#4\egroup}%
+}
+
+% Appendices, in the main contents.
+% Need the word Appendix, and a fixed-size box.
+%
+\def\appendixbox#1{%
+ % We use M since it's probably the widest letter.
+ \setbox0 = \hbox{\putwordAppendix{} M}%
+ \hbox to \wd0{\putwordAppendix{} #1\hss}}
+%
+\def\appentry#1#2#3#4{\dochapentry{\appendixbox{#2}\hskip.7em#1}{#4}}
+
+% Unnumbered chapters.
+\def\unnchapentry#1#2#3#4{\dochapentry{#1}{#4}}
+\def\shortunnchapentry#1#2#3#4{\tocentry{#1}{\doshortpageno\bgroup#4\egroup}}
+
+% Sections.
+\def\numsecentry#1#2#3#4{\dosecentry{#2\labelspace#1}{#4}}
+\let\appsecentry=\numsecentry
+\def\unnsecentry#1#2#3#4{\dosecentry{#1}{#4}}
+
+% Subsections.
+\def\numsubsecentry#1#2#3#4{\dosubsecentry{#2\labelspace#1}{#4}}
+\let\appsubsecentry=\numsubsecentry
+\def\unnsubsecentry#1#2#3#4{\dosubsecentry{#1}{#4}}
+
+% And subsubsections.
+\def\numsubsubsecentry#1#2#3#4{\dosubsubsecentry{#2\labelspace#1}{#4}}
+\let\appsubsubsecentry=\numsubsubsecentry
+\def\unnsubsubsecentry#1#2#3#4{\dosubsubsecentry{#1}{#4}}
+
+% This parameter controls the indentation of the various levels.
+% Same as \defaultparindent.
+\newdimen\tocindent \tocindent = 15pt
+
+% Now for the actual typesetting. In all these, #1 is the text and #2 is the
+% page number.
+%
+% If the toc has to be broken over pages, we want it to be at chapters
+% if at all possible; hence the \penalty.
+\def\dochapentry#1#2{%
+ \penalty-300 \vskip1\baselineskip plus.33\baselineskip minus.25\baselineskip
+ \begingroup
+ % Move the page numbers slightly to the right
+ \advance\entryrightmargin by -0.05em
+ \chapentryfonts
+ \tocentry{#1}{\dopageno\bgroup#2\egroup}%
+ \endgroup
+ \nobreak\vskip .25\baselineskip plus.1\baselineskip
+}
+
+\def\dosecentry#1#2{\begingroup
+ \secentryfonts \leftskip=\tocindent
+ \tocentry{#1}{\dopageno\bgroup#2\egroup}%
+\endgroup}
+
+\def\dosubsecentry#1#2{\begingroup
+ \subsecentryfonts \leftskip=2\tocindent
+ \tocentry{#1}{\dopageno\bgroup#2\egroup}%
+\endgroup}
+
+\def\dosubsubsecentry#1#2{\begingroup
+ \subsubsecentryfonts \leftskip=3\tocindent
+ \tocentry{#1}{\dopageno\bgroup#2\egroup}%
+\endgroup}
+
+% We use the same \entry macro as for the index entries.
+\let\tocentry = \entry
+
+% Space between chapter (or whatever) number and the title.
+\def\labelspace{\hskip1em \relax}
+
+\def\dopageno#1{{\rm #1}}
+\def\doshortpageno#1{{\rm #1}}
+
+\def\chapentryfonts{\secfonts \rm}
+\def\secentryfonts{\textfonts}
+\def\subsecentryfonts{\textfonts}
+\def\subsubsecentryfonts{\textfonts}
+
+
+\message{environments,}
+% @foo ... @end foo.
+
+% @tex ... @end tex escapes into raw TeX temporarily.
+% One exception: @ is still an escape character, so that @end tex works.
+% But \@ or @@ will get a plain @ character.
+
+\envdef\tex{%
+ \setupmarkupstyle{tex}%
+ \catcode `\\=0 \catcode `\{=1 \catcode `\}=2
+ \catcode `\$=3 \catcode `\&=4 \catcode `\#=6
+ \catcode `\^=7 \catcode `\_=8 \catcode `\~=\active \let~=\tie
+ \catcode `\%=14
+ \catcode `\+=\other
+ \catcode `\"=\other
+ \catcode `\|=\other
+ \catcode `\<=\other
+ \catcode `\>=\other
+ \catcode `\`=\other
+ \catcode `\'=\other
+ \escapechar=`\\
+ %
+ % ' is active in math mode (mathcode"8000). So reset it, and all our
+ % other math active characters (just in case), to plain's definitions.
+ \mathactive
+ %
+ % Inverse of the list at the beginning of the file.
+ \let\b=\ptexb
+ \let\bullet=\ptexbullet
+ \let\c=\ptexc
+ \let\,=\ptexcomma
+ \let\.=\ptexdot
+ \let\dots=\ptexdots
+ \let\equiv=\ptexequiv
+ \let\!=\ptexexclam
+ \let\i=\ptexi
+ \let\indent=\ptexindent
+ \let\noindent=\ptexnoindent
+ \let\{=\ptexlbrace
+ \let\+=\tabalign
+ \let\}=\ptexrbrace
+ \let\/=\ptexslash
+ \let\sp=\ptexsp
+ \let\*=\ptexstar
+ %\let\sup=\ptexsup % do not redefine, we want @sup to work in math mode
+ \let\t=\ptext
+ \expandafter \let\csname top\endcsname=\ptextop % we've made it outer
+ \let\frenchspacing=\plainfrenchspacing
+ %
+ \def\endldots{\mathinner{\ldots\ldots\ldots\ldots}}%
+ \def\enddots{\relax\ifmmode\endldots\else$\mathsurround=0pt \endldots\,$\fi}%
+ address@hidden@}%
+}
+% There is no need to define \Etex.
+
+% Define @lisp ... @end lisp.
+% @lisp environment forms a group so it can rebind things,
+% including the definition of @end lisp (which normally is erroneous).
+
+% Amount to narrow the margins by for @lisp.
+\newskip\lispnarrowing \lispnarrowing=0.4in
+
+% This is the definition that ^^M gets inside @lisp, @example, and other
+% such environments. \null is better than a space, since it doesn't
+% have any width.
+\def\lisppar{\null\endgraf}
+
+% This space is always present above and below environments.
+\newskip\envskipamount \envskipamount = 0pt
+
+% Make spacing and below environment symmetrical. We use \parskip here
+% to help in doing that, since in @example-like environments \parskip
+% is reset to zero; thus the \afterenvbreak inserts no space -- but the
+% start of the next paragraph will insert \parskip.
+%
+\def\aboveenvbreak{{%
+ % =10000 instead of <10000 because of a special case in \itemzzz and
+ % \sectionheading, q.v.
+ \ifnum \lastpenalty=10000 \else
+ \advance\envskipamount by \parskip
+ \endgraf
+ \ifdim\lastskip<\envskipamount
+ \removelastskip
+ \ifnum\lastpenalty<10000
+ % Penalize breaking before the environment, because preceding text
+ % often leads into it.
+ \penalty100
+ \fi
+ \vskip\envskipamount
+ \fi
+ \fi
+}}
+
+\def\afterenvbreak{{%
+ % =10000 instead of <10000 because of a special case in \itemzzz and
+ % \sectionheading, q.v.
+ \ifnum \lastpenalty=10000 \else
+ \advance\envskipamount by \parskip
+ \endgraf
+ \ifdim\lastskip<\envskipamount
+ \removelastskip
+ % it's not a good place to break if the last penalty was \nobreak
+ % or better ...
+ \ifnum\lastpenalty<10000 \penalty-50 \fi
+ \vskip\envskipamount
+ \fi
+ \fi
+}}
+
+% \nonarrowing is a flag. If "set", @lisp etc don't narrow margins; it will
+% also clear it, so that its embedded environments do the narrowing again.
+\let\nonarrowing=\relax
+
+% @cartouche ... @end cartouche: draw rectangle w/rounded corners around
+% environment contents.
+\font\circle=lcircle10
+\newdimen\circthick
+\newdimen\cartouter\newdimen\cartinner
+\newskip\normbskip\newskip\normpskip\newskip\normlskip
+\circthick=\fontdimen8\circle
+%
+\def\ctl{{\circle\char'013\hskip -6pt}}% 6pt from pl file: 1/2charwidth
+\def\ctr{{\hskip 6pt\circle\char'010}}
+\def\cbl{{\circle\char'012\hskip -6pt}}
+\def\cbr{{\hskip 6pt\circle\char'011}}
+\def\carttop{\hbox to \cartouter{\hskip\lskip
+ \ctl\leaders\hrule height\circthick\hfil\ctr
+ \hskip\rskip}}
+\def\cartbot{\hbox to \cartouter{\hskip\lskip
+ \cbl\leaders\hrule height\circthick\hfil\cbr
+ \hskip\rskip}}
+%
+\newskip\lskip\newskip\rskip
+
+\envdef\cartouche{%
+ \ifhmode\par\fi % can't be in the midst of a paragraph.
+ \startsavinginserts
+ \lskip=\leftskip \rskip=\rightskip
+ \leftskip=0pt\rightskip=0pt % we want these *outside*.
+ \cartinner=\hsize \advance\cartinner by-\lskip
+ \advance\cartinner by-\rskip
+ \cartouter=\hsize
+ \advance\cartouter by 18.4pt % allow for 3pt kerns on either
+ % side, and for 6pt waste from
+ % each corner char, and rule thickness
+ \normbskip=\baselineskip \normpskip=\parskip \normlskip=\lineskip
+ %
+ % If this cartouche directly follows a sectioning command, we need the
+ % \parskip glue (backspaced over by default) or the cartouche can
+ % collide with the section heading.
+ \ifnum\lastpenalty>10000 \vskip\parskip \penalty\lastpenalty \fi
+ %
+ \setbox\groupbox=\vbox\bgroup
+ \baselineskip=0pt\parskip=0pt\lineskip=0pt
+ \carttop
+ \hbox\bgroup
+ \hskip\lskip
+ \vrule\kern3pt
+ \vbox\bgroup
+ \kern3pt
+ \hsize=\cartinner
+ \baselineskip=\normbskip
+ \lineskip=\normlskip
+ \parskip=\normpskip
+ \vskip -\parskip
+ \comment % For explanation, see the end of def\group.
+}
+\def\Ecartouche{%
+ \ifhmode\par\fi
+ \kern3pt
+ \egroup
+ \kern3pt\vrule
+ \hskip\rskip
+ \egroup
+ \cartbot
+ \egroup
+ \addgroupbox
+ \checkinserts
+}
+
+
+% This macro is called at the beginning of all the @example variants,
+% inside a group.
+\newdimen\nonfillparindent
+\def\nonfillstart{%
+ \aboveenvbreak
+ \ifdim\hfuzz < 12pt \hfuzz = 12pt \fi % Don't be fussy
+ \sepspaces % Make spaces be word-separators rather than space tokens.
+ \let\par = \lisppar % don't ignore blank lines
+ \obeylines % each line of input is a line of output
+ \parskip = 0pt
+ % Turn off paragraph indentation but redefine \indent to emulate
+ % the normal \indent.
+ \nonfillparindent=\parindent
+ \parindent = 0pt
+ \let\indent\nonfillindent
+ %
+ \emergencystretch = 0pt % don't try to avoid overfull boxes
+ \ifx\nonarrowing\relax
+ \advance \leftskip by \lispnarrowing
+ \exdentamount=\lispnarrowing
+ \else
+ \let\nonarrowing = \relax
+ \fi
+ \let\exdent=\nofillexdent
+}
+
+\begingroup
+\obeyspaces
+% We want to swallow spaces (but not other tokens) after the fake
+% @indent in our nonfill-environments, where spaces are normally
+% active and set to @tie, resulting in them not being ignored after
+% @indent.
+\gdef\nonfillindent{\futurelet\temp\nonfillindentcheck}%
+\gdef\nonfillindentcheck{%
+\ifx\temp %
+\expandafter\nonfillindentgobble%
+\else%
+\leavevmode\nonfillindentbox%
+\fi%
+}%
+\endgroup
+\def\nonfillindentgobble#1{\nonfillindent}
+\def\nonfillindentbox{\hbox to \nonfillparindent{\hss}}
+
+% If you want all examples etc. small: @set dispenvsize small.
+% If you want even small examples the full size: @set dispenvsize nosmall.
+% This affects the following displayed environments:
+% @example, @display, @format, @lisp
+%
+\def\smallword{small}
+\def\nosmallword{nosmall}
+\let\SETdispenvsize\relax
+\def\setnormaldispenv{%
+ \ifx\SETdispenvsize\smallword
+ % end paragraph for sake of leading, in case document has no blank
+ % line. This is redundant with what happens in \aboveenvbreak, but
+ % we need to do it before changing the fonts, and it's inconvenient
+ % to change the fonts afterward.
+ \ifnum \lastpenalty=10000 \else \endgraf \fi
+ \smallexamplefonts \rm
+ \fi
+}
+\def\setsmalldispenv{%
+ \ifx\SETdispenvsize\nosmallword
+ \else
+ \ifnum \lastpenalty=10000 \else \endgraf \fi
+ \smallexamplefonts \rm
+ \fi
+}
+
+% We often define two environments, @foo and @smallfoo.
+% Let's do it in one command. #1 is the env name, #2 the definition.
+\def\makedispenvdef#1#2{%
+ \expandafter\envdef\csname#1\endcsname {\setnormaldispenv #2}%
+ \expandafter\envdef\csname small#1\endcsname {\setsmalldispenv #2}%
+ \expandafter\let\csname E#1\endcsname \afterenvbreak
+ \expandafter\let\csname Esmall#1\endcsname \afterenvbreak
+}
+
+% Define two environment synonyms (#1 and #2) for an environment.
+\def\maketwodispenvdef#1#2#3{%
+ \makedispenvdef{#1}{#3}%
+ \makedispenvdef{#2}{#3}%
+}
+%
+% @lisp: indented, narrowed, typewriter font;
+% @example: same as @lisp.
+%
+% @smallexample and @smalllisp: use smaller fonts.
+% Originally contributed by address@hidden
+%
+\maketwodispenvdef{lisp}{example}{%
+ \nonfillstart
+ \tt\setupmarkupstyle{example}%
+ \let\kbdfont = \kbdexamplefont % Allow @kbd to do something special.
+ \gobble % eat return
+}
+% @display/@smalldisplay: same as @lisp except keep current font.
+%
+\makedispenvdef{display}{%
+ \nonfillstart
+ \gobble
+}
+
+% @format/@smallformat: same as @display except don't narrow margins.
+%
+\makedispenvdef{format}{%
+ \let\nonarrowing = t%
+ \nonfillstart
+ \gobble
+}
+
+% @flushleft: same as @format, but doesn't obey \SETdispenvsize.
+\envdef\flushleft{%
+ \let\nonarrowing = t%
+ \nonfillstart
+ \gobble
+}
+\let\Eflushleft = \afterenvbreak
+
+% @flushright.
+%
+\envdef\flushright{%
+ \let\nonarrowing = t%
+ \nonfillstart
+ \advance\leftskip by 0pt plus 1fill\relax
+ \gobble
+}
+\let\Eflushright = \afterenvbreak
+
+
+% @raggedright does more-or-less normal line breaking but no right
+% justification. From plain.tex. Don't stretch around special
+% characters in urls in this environment, since the stretch at the right
+% should be enough.
+\envdef\raggedright{%
+ \rightskip0pt plus2.4em \spaceskip.3333em \xspaceskip.5em\relax
+ \def\urefprestretchamount{0pt}%
+ \def\urefpoststretchamount{0pt}%
+}
+\let\Eraggedright\par
+
+\envdef\raggedleft{%
+ \parindent=0pt \leftskip0pt plus2em
+ \spaceskip.3333em \xspaceskip.5em \parfillskip=0pt
+ \hbadness=10000 % Last line will usually be underfull, so turn off
+ % badness reporting.
+}
+\let\Eraggedleft\par
+
+\envdef\raggedcenter{%
+ \parindent=0pt \rightskip0pt plus1em \leftskip0pt plus1em
+ \spaceskip.3333em \xspaceskip.5em \parfillskip=0pt
+ \hbadness=10000 % Last line will usually be underfull, so turn off
+ % badness reporting.
+}
+\let\Eraggedcenter\par
+
+
+% @quotation does normal linebreaking (hence we can't use \nonfillstart)
+% and narrows the margins. We keep \parskip nonzero in general, since
+% we're doing normal filling. So, when using \aboveenvbreak and
+% \afterenvbreak, temporarily make \parskip 0.
+%
+\makedispenvdef{quotation}{\quotationstart}
+%
+\def\quotationstart{%
+ \indentedblockstart % same as \indentedblock, but increase right margin too.
+ \ifx\nonarrowing\relax
+ \advance\rightskip by \lispnarrowing
+ \fi
+ \parsearg\quotationlabel
+}
+
+% We have retained a nonzero parskip for the environment, since we're
+% doing normal filling.
+%
+\def\Equotation{%
+ \par
+ \ifx\quotationauthor\thisisundefined\else
+ % indent a bit.
+ \leftline{\kern 2\leftskip \sl ---\quotationauthor}%
+ \fi
+ {\parskip=0pt \afterenvbreak}%
+}
+\def\Esmallquotation{\Equotation}
+
+% If we're given an argument, typeset it in bold with a colon after.
+\def\quotationlabel#1{%
+ \def\temp{#1}%
+ \ifx\temp\empty \else
+ {\bf #1: }%
+ \fi
+}
+
+% @indentedblock is like @quotation, but indents only on the left and
+% has no optional argument.
+%
+\makedispenvdef{indentedblock}{\indentedblockstart}
+%
+\def\indentedblockstart{%
+ {\parskip=0pt \aboveenvbreak}% because \aboveenvbreak inserts \parskip
+ \parindent=0pt
+ %
+ % @cartouche defines \nonarrowing to inhibit narrowing at next level down.
+ \ifx\nonarrowing\relax
+ \advance\leftskip by \lispnarrowing
+ \exdentamount = \lispnarrowing
+ \else
+ \let\nonarrowing = \relax
+ \fi
+}
+
+% Keep a nonzero parskip for the environment, since we're doing normal filling.
+%
+\def\Eindentedblock{%
+ \par
+ {\parskip=0pt \afterenvbreak}%
+}
+\def\Esmallindentedblock{\Eindentedblock}
+
+
+% LaTeX-like @address@hidden verbatim and @verb{<char>...<char>}
+% If we want to allow any <char> as delimiter,
+% we need the curly braces so that makeinfo sees the @verb command, eg:
+% address@hidden' would look like the '@verbx' command. address@hidden
+%
+% [Knuth]: Donald Ervin Knuth, 1996. The TeXbook.
+%
+% [Knuth] p.344; only we need to do the other characters Texinfo sets
+% active too. Otherwise, they get lost as the first character on a
+% verbatim line.
+\def\dospecials{%
+ \do\ \do\\\do\{\do\}\do\$\do\&%
+ \do\#\do\^\do\^^K\do\_\do\^^A\do\%\do\~%
+ \do\<\do\>\do\|address@hidden"%
+ % Don't do the quotes -- if we do, @set txicodequoteundirected and
+ % @set txicodequotebacktick will not have effect on @verb and
+ % @verbatim, and ?` and !` ligatures won't get disabled.
+ %\do\`\do\'%
+}
+%
+% [Knuth] p. 380
+\def\uncatcodespecials{%
+ \def\do##1{\catcode`##1=\other}\dospecials}
+%
+% Setup for the @verb command.
+%
+% Eight spaces for a tab
+\begingroup
+ \catcode`\^^I=\active
+ \gdef\tabeightspaces{\catcode`\^^I=\active\def^^I{\ \ \ \ \ \ \ \ }}
+\endgroup
+%
+\def\setupverb{%
+ \tt % easiest (and conventionally used) font for verbatim
+ \def\par{\leavevmode\endgraf}%
+ \setupmarkupstyle{verb}%
+ \tabeightspaces
+ % Respect line breaks,
+ % print special symbols as themselves, and
+ % make each space count
+ % must do in this order:
+ \obeylines \uncatcodespecials \sepspaces
+}
+
+% Setup for the @verbatim environment
+%
+% Real tab expansion.
+\newdimen\tabw \setbox0=\hbox{\tt\space} \tabw=8\wd0 % tab amount
+%
+% We typeset each line of the verbatim in an \hbox, so we can handle
+% tabs. The \global is in case the verbatim line starts with an accent,
+% or some other command that starts with a begin-group. Otherwise, the
+% entire \verbbox would disappear at the corresponding end-group, before
+% it is typeset. Meanwhile, we can't have nested verbatim commands
+% (can we?), so the \global won't be overwriting itself.
+\newbox\verbbox
+\def\starttabbox{\global\setbox\verbbox=\hbox\bgroup}
+%
+\begingroup
+ \catcode`\^^I=\active
+ \gdef\tabexpand{%
+ \catcode`\^^I=\active
+ \def^^I{\leavevmode\egroup
+ \dimen\verbbox=\wd\verbbox % the width so far, or since the previous tab
+ \divide\dimen\verbbox by\tabw
+ \multiply\dimen\verbbox by\tabw % compute previous multiple of \tabw
+ \advance\dimen\verbbox by\tabw % advance to next multiple of \tabw
+ \wd\verbbox=\dimen\verbbox \box\verbbox \starttabbox
+ }%
+ }
+\endgroup
+
+% start the verbatim environment.
+\def\setupverbatim{%
+ \let\nonarrowing = t%
+ \nonfillstart
+ \tt % easiest (and conventionally used) font for verbatim
+ % The \leavevmode here is for blank lines. Otherwise, we would
+ % never \starttabox and the \egroup would end verbatim mode.
+ \def\par{\leavevmode\egroup\box\verbbox\endgraf}%
+ \tabexpand
+ \setupmarkupstyle{verbatim}%
+ % Respect line breaks,
+ % print special symbols as themselves, and
+ % make each space count.
+ % Must do in this order:
+ \obeylines \uncatcodespecials \sepspaces
+ \everypar{\starttabbox}%
+}
+
+% Do the @verb magic: verbatim text is quoted by unique
+% delimiter characters. Before first delimiter expect a
+% right brace, after last delimiter expect closing brace:
+%
+% \def\doverb'{'<char>#1<char>'}'{#1}
+%
+% [Knuth] p. 382; only eat outer {}
+\begingroup
+ \catcode`[=1\catcode`]=2\catcode`\{=\other\catcode`\}=\other
+ \gdef\doverb{#1[\def\next##1#1}[##1\endgroup]\next]
+\endgroup
+%
+\def\verb{\begingroup\setupverb\doverb}
+%
+%
+% Do the @verbatim magic: define the macro \doverbatim so that
+% the (first) argument ends when '@end verbatim' is reached, ie:
+%
+% address@hidden verbatim{#1}
+%
+% For Texinfo it's a lot easier than for LaTeX,
+% because texinfo's \verbatim doesn't stop at '\end{verbatim}':
+% we need not redefine '\', '{' and '}'.
+%
+% Inspired by LaTeX's verbatim command set [latex.ltx]
+%
+\begingroup
+ \catcode`\ =\active
+ \obeylines %
+ % ignore everything up to the first ^^M, that's the newline at the end
+ % of the @verbatim input line itself. Otherwise we get an extra blank
+ % line in the output.
+ address@hidden verbatim{#2\noexpand\end\gobble verbatim}%
+ % We really want {...\end verbatim} in the body of the macro, but
+ % without the active space; thus we have to use \xdef and \gobble.
+\endgroup
+%
+\envdef\verbatim{%
+ \setupverbatim\doverbatim
+}
+\let\Everbatim = \afterenvbreak
+
+
+% @verbatiminclude FILE - insert text of file in verbatim environment.
+%
+\def\verbatiminclude{\parseargusing\filenamecatcodes\doverbatiminclude}
+%
+\def\doverbatiminclude#1{%
+ {%
+ \makevalueexpandable
+ \setupverbatim
+ \indexnofonts % Allow `@@' and other weird things in file names.
+ \wlog{texinfo.tex: doing @verbatiminclude of #1^^J}%
+ \input #1
+ \afterenvbreak
+ }%
+}
+
+% @copying ... @end copying.
+% Save the text away for @insertcopying later.
+%
+% We save the uninterpreted tokens, rather than creating a box.
+% Saving the text in a box would be much easier, but then all the
+% typesetting commands (@smallbook, font changes, etc.) have to be done
+% beforehand -- and a) we want @copying to be done first in the source
+% file; b) letting users define the frontmatter in as flexible order as
+% possible is desirable.
+%
+\def\copying{\checkenv{}\begingroup\scanargctxt\docopying}
address@hidden copying{\endgroup\def\copyingtext{#1}}
+%
+\def\insertcopying{%
+ \begingroup
+ \parindent = 0pt % paragraph indentation looks wrong on title page
+ \scanexp\copyingtext
+ \endgroup
+}
+
+
+\message{defuns,}
+% @defun etc.
+
+\newskip\defbodyindent \defbodyindent=.4in
+\newskip\defargsindent \defargsindent=50pt
+\newskip\deflastargmargin \deflastargmargin=18pt
+\newcount\defunpenalty
+
+% Start the processing of @deffn:
+\def\startdefun{%
+ \ifnum\lastpenalty<10000
+ \medbreak
+ \defunpenalty=10003 % Will keep this @deffn together with the
+ % following @def command, see below.
+ \else
+ % If there are two @def commands in a row, we'll have a \nobreak,
+ % which is there to keep the function description together with its
+ % header. But if there's nothing but headers, we need to allow a
+ % break somewhere. Check specifically for penalty 10002, inserted
+ % by \printdefunline, instead of 10000, since the sectioning
+ % commands also insert a nobreak penalty, and we don't want to allow
+ % a break between a section heading and a defun.
+ %
+ % As a further refinement, we avoid "club" headers by signalling
+ % with penalty of 10003 after the very first @deffn in the
+ % sequence (see above), and penalty of 10002 after any following
+ % @def command.
+ \ifnum\lastpenalty=10002 \penalty2000 \else \defunpenalty=10002 \fi
+ %
+ % Similarly, after a section heading, do not allow a break.
+ % But do insert the glue.
+ \medskip % preceded by discardable penalty, so not a breakpoint
+ \fi
+ %
+ \parindent=0in
+ \advance\leftskip by \defbodyindent
+ \exdentamount=\defbodyindent
+}
+
+\def\dodefunx#1{%
+ % First, check whether we are in the right environment:
+ \checkenv#1%
+ %
+ % As above, allow line break if we have multiple x headers in a row.
+ % It's not a great place, though.
+ \ifnum\lastpenalty=10002 \penalty3000 \else \defunpenalty=10002 \fi
+ %
+ % And now, it's time to reuse the body of the original defun:
+ \expandafter\gobbledefun#1%
+}
+\def\gobbledefun#1\startdefun{}
+
+% \printdefunline \deffnheader{text}
+%
+\def\printdefunline#1#2{%
+ \begingroup
+ % call \deffnheader:
+ #1#2 \endheader
+ % common ending:
+ \interlinepenalty = 10000
+ \advance\rightskip by 0pt plus 1fil\relax
+ \endgraf
+ \nobreak\vskip -\parskip
+ \penalty\defunpenalty % signal to \startdefun and \dodefunx
+ % Some of the @defun-type tags do not enable magic parentheses,
+ % rendering the following check redundant. But we don't optimize.
+ \checkparencounts
+ \endgroup
+}
+
+\def\Edefun{\endgraf\medbreak}
+
+% \makedefun{deffn} creates \deffn, \deffnx and \Edeffn;
+% the only thing remaining is to define \deffnheader.
+%
+\def\makedefun#1{%
+ \expandafter\let\csname E#1\endcsname = \Edefun
+ \edef\temp{\noexpand\domakedefun
+ \makecsname{#1}\makecsname{#1x}\makecsname{#1header}}%
+ \temp
+}
+
+% \domakedefun \deffn \deffnx \deffnheader { (defn. of \deffnheader) }
+%
+% Define \deffn and \deffnx, without parameters.
+% \deffnheader has to be defined explicitly.
+%
+\def\domakedefun#1#2#3{%
+ \envdef#1{%
+ \startdefun
+ \doingtypefnfalse % distinguish typed functions from all else
+ \parseargusing\activeparens{\printdefunline#3}%
+ }%
+ \def#2{\dodefunx#1}%
+ \def#3%
+}
+
+\newif\ifdoingtypefn % doing typed function?
+\newif\ifrettypeownline % typeset return type on its own line?
+
+% @deftypefnnewline on|off says whether the return type of typed functions
+% are printed on their own line. This affects @deftypefn, @deftypefun,
+% @deftypeop, and @deftypemethod.
+%
+\parseargdef\deftypefnnewline{%
+ \def\temp{#1}%
+ \ifx\temp\onword
+ \expandafter\let\csname SETtxideftypefnnl\endcsname
+ = \empty
+ \else\ifx\temp\offword
+ \expandafter\let\csname SETtxideftypefnnl\endcsname
+ = \relax
+ \else
+ \errhelp = \EMsimple
+ \errmessage{Unknown @txideftypefnnl value `\temp',
+ must be on|off}%
+ \fi\fi
+}
+
+% Untyped functions:
+
+% @deffn category name args
+\makedefun{deffn}{\deffngeneral{}}
+
+% @deffn category class name args
+\makedefun{defop}#1 {\defopon{#1\ \putwordon}}
+
+% \defopon {category on}class name args
+\def\defopon#1#2 {\deffngeneral{\putwordon\ \code{#2}}{#1\ \code{#2}} }
+
+% \deffngeneral {subind}category name args
+%
+\def\deffngeneral#1#2 #3 #4\endheader{%
+ % Remember that \dosubind{fn}{foo}{} is equivalent to \doind{fn}{foo}.
+ \dosubind{fn}{\code{#3}}{#1}%
+ \defname{#2}{}{#3}\magicamp\defunargs{#4\unskip}%
+}
+
+% Typed functions:
+
+% @deftypefn category type name args
+\makedefun{deftypefn}{\deftypefngeneral{}}
+
+% @deftypeop category class type name args
+\makedefun{deftypeop}#1 {\deftypeopon{#1\ \putwordon}}
+
+% \deftypeopon {category on}class type name args
+\def\deftypeopon#1#2 {\deftypefngeneral{\putwordon\ \code{#2}}{#1\ \code{#2}} }
+
+% \deftypefngeneral {subind}category type name args
+%
+\def\deftypefngeneral#1#2 #3 #4 #5\endheader{%
+ \dosubind{fn}{\code{#4}}{#1}%
+ \doingtypefntrue
+ \defname{#2}{#3}{#4}\defunargs{#5\unskip}%
+}
+
+% Typed variables:
+
+% @deftypevr category type var args
+\makedefun{deftypevr}{\deftypecvgeneral{}}
+
+% @deftypecv category class type var args
+\makedefun{deftypecv}#1 {\deftypecvof{#1\ \putwordof}}
+
+% \deftypecvof {category of}class type var args
+\def\deftypecvof#1#2 {\deftypecvgeneral{\putwordof\ \code{#2}}{#1\ \code{#2}} }
+
+% \deftypecvgeneral {subind}category type var args
+%
+\def\deftypecvgeneral#1#2 #3 #4 #5\endheader{%
+ \dosubind{vr}{\code{#4}}{#1}%
+ \defname{#2}{#3}{#4}\defunargs{#5\unskip}%
+}
+
+% Untyped variables:
+
+% @defvr category var args
+\makedefun{defvr}#1 {\deftypevrheader{#1} {} }
+
+% @defcv category class var args
+\makedefun{defcv}#1 {\defcvof{#1\ \putwordof}}
+
+% \defcvof {category of}class var args
+\def\defcvof#1#2 {\deftypecvof{#1}#2 {} }
+
+% Types:
+
+% @deftp category name args
+\makedefun{deftp}#1 #2 #3\endheader{%
+ \doind{tp}{\code{#2}}%
+ \defname{#1}{}{#2}\defunargs{#3\unskip}%
+}
+
+% Remaining @defun-like shortcuts:
+\makedefun{defun}{\deffnheader{\putwordDeffunc} }
+\makedefun{defmac}{\deffnheader{\putwordDefmac} }
+\makedefun{defspec}{\deffnheader{\putwordDefspec} }
+\makedefun{deftypefun}{\deftypefnheader{\putwordDeffunc} }
+\makedefun{defvar}{\defvrheader{\putwordDefvar} }
+\makedefun{defopt}{\defvrheader{\putwordDefopt} }
+\makedefun{deftypevar}{\deftypevrheader{\putwordDefvar} }
+\makedefun{defmethod}{\defopon\putwordMethodon}
+\makedefun{deftypemethod}{\deftypeopon\putwordMethodon}
+\makedefun{defivar}{\defcvof\putwordInstanceVariableof}
+\makedefun{deftypeivar}{\deftypecvof\putwordInstanceVariableof}
+
+% \defname, which formats the name of the @def (not the args).
+% #1 is the category, such as "Function".
+% #2 is the return type, if any.
+% #3 is the function name.
+%
+% We are followed by (but not passed) the arguments, if any.
+%
+\def\defname#1#2#3{%
+ \par
+ % Get the values of \leftskip and \rightskip as they were outside the @def...
+ \advance\leftskip by -\defbodyindent
+ %
+ % Determine if we are typesetting the return type of a typed function
+ % on a line by itself.
+ \rettypeownlinefalse
+ \ifdoingtypefn % doing a typed function specifically?
+ % then check user option for putting return type on its own line:
+ \expandafter\ifx\csname SETtxideftypefnnl\endcsname\relax \else
+ \rettypeownlinetrue
+ \fi
+ \fi
+ %
+ % How we'll format the category name. Putting it in brackets helps
+ % distinguish it from the body text that may end up on the next line
+ % just below it.
+ \def\temp{#1}%
+ \setbox0=\hbox{\kern\deflastargmargin \ifx\temp\empty\else [\rm\temp]\fi}
+ %
+ % Figure out line sizes for the paragraph shape. We'll always have at
+ % least two.
+ \tempnum = 2
+ %
+ % The first line needs space for \box0; but if \rightskip is nonzero,
+ % we need only space for the part of \box0 which exceeds it:
+ \dimen0=\hsize \advance\dimen0 by -\wd0 \advance\dimen0 by \rightskip
+ %
+ % If doing a return type on its own line, we'll have another line.
+ \ifrettypeownline
+ \advance\tempnum by 1
+ \def\maybeshapeline{0in \hsize}%
+ \else
+ \def\maybeshapeline{}%
+ \fi
+ %
+ % The continuations:
+ \dimen2=\hsize \advance\dimen2 by -\defargsindent
+ %
+ % The final paragraph shape:
+ \parshape \tempnum 0in \dimen0 \maybeshapeline \defargsindent \dimen2
+ %
+ % Put the category name at the right margin.
+ \noindent
+ \hbox to 0pt{%
+ \hfil\box0 \kern-\hsize
+ % \hsize has to be shortened this way:
+ \kern\leftskip
+ % Intentionally do not respect \rightskip, since we need the space.
+ }%
+ %
+ % Allow all lines to be underfull without complaint:
+ \tolerance=10000 \hbadness=10000
+ \exdentamount=\defbodyindent
+ {%
+ % defun fonts. We use typewriter by default (used to be bold) because:
+ % . we're printing identifiers, they should be in tt in principle.
+ % . in languages with many accents, such as Czech or French, it's
+ % common to leave accents off identifiers. The result looks ok in
+ % tt, but exceedingly strange in rm.
+ % . we don't want -- and --- to be treated as ligatures.
+ % . this still does not fix the ?` and !` ligatures, but so far no
+ % one has made identifiers using them :).
+ \df \tt
+ \def\temp{#2}% text of the return type
+ \ifx\temp\empty\else
+ \tclose{\temp}% typeset the return type
+ \ifrettypeownline
+ % put return type on its own line; prohibit line break following:
+ \hfil\vadjust{\nobreak}\break
+ \else
+ \space % type on same line, so just followed by a space
+ \fi
+ \fi % no return type
+ #3% output function name
+ }%
+ {\rm\enskip}% hskip 0.5 em of \tenrm
+ %
+ \boldbrax
+ % arguments will be output next, if any.
+}
+
+% Print arguments in slanted roman (not ttsl), inconsistently with using
+% tt for the name. This is because literal text is sometimes needed in
+% the argument list (groff manual), and ttsl and tt are not very
+% distinguishable. Prevent hyphenation at `-' chars.
+%
+\def\defunargs#1{%
+ % use sl by default (not ttsl),
+ % tt for the names.
+ \df \sl \hyphenchar\font=0
+ %
+ % On the other hand, if an argument has two dashes (for instance), we
+ % want a way to get ttsl. We used to recommend @var for that, so
+ % leave the code in, but it's strange for @var to lead to typewriter.
+ % Nowadays we recommend @code, since the difference between a ttsl hyphen
+ % and a tt hyphen is pretty tiny. @code also disables ?` !`.
+ \def\var##1{{\setupmarkupstyle{var}\ttslanted{##1}}}%
+ #1%
+ \sl\hyphenchar\font=45
+}
+
+% We want ()&[] to print specially on the defun line.
+%
+\def\activeparens{%
+ \catcode`\(=\active \catcode`\)=\active
+ \catcode`\[=\active \catcode`\]=\active
+ \catcode`\&=\active
+}
+
+% Make control sequences which act like normal parenthesis chars.
+\let\lparen = ( \let\rparen = )
+
+% Be sure that we always have a definition for `(', etc. For example,
+% if the fn name has parens in it, \boldbrax will not be in effect yet,
+% so TeX would otherwise complain about undefined control sequence.
+{
+ \activeparens
+ \global\let(=\lparen \global\let)=\rparen
+ \global\let[=\lbrack \global\let]=\rbrack
+ \global\let& = \&
+
+ \gdef\boldbrax{\let(=\opnr\let)=\clnr\let[=\lbrb\let]=\rbrb}
+ \gdef\magicamp{\let&=\amprm}
+}
+
+\newcount\parencount
+
+% If we encounter &foo, then turn on ()-hacking afterwards
+\newif\ifampseen
+\def\amprm#1 {\ampseentrue{\bf\ }}
+
+\def\parenfont{%
+ \ifampseen
+ % At the first level, print parens in roman,
+ % otherwise use the default font.
+ \ifnum \parencount=1 \rm \fi
+ \else
+ % The \sf parens (in \boldbrax) actually are a little bolder than
+ % the contained text. This is especially needed for [ and ] .
+ \sf
+ \fi
+}
+\def\infirstlevel#1{%
+ \ifampseen
+ \ifnum\parencount=1
+ #1%
+ \fi
+ \fi
+}
+\def\bfafterword#1 {#1 \bf}
+
+\def\opnr{%
+ \global\advance\parencount by 1
+ {\parenfont(}%
+ \infirstlevel \bfafterword
+}
+\def\clnr{%
+ {\parenfont)}%
+ \infirstlevel \sl
+ \global\advance\parencount by -1
+}
+
+\newcount\brackcount
+\def\lbrb{%
+ \global\advance\brackcount by 1
+ {\bf[}%
+}
+\def\rbrb{%
+ {\bf]}%
+ \global\advance\brackcount by -1
+}
+
+\def\checkparencounts{%
+ \ifnum\parencount=0 \else \badparencount \fi
+ \ifnum\brackcount=0 \else \badbrackcount \fi
+}
+% these should not use \errmessage; the glibc manual, at least, actually
+% has such constructs (when documenting function pointers).
+\def\badparencount{%
+ \message{Warning: unbalanced parentheses in @def...}%
+ \global\parencount=0
+}
+\def\badbrackcount{%
+ \message{Warning: unbalanced square brackets in @def...}%
+ \global\brackcount=0
+}
+
+
+\message{macros,}
+% @macro.
+
+% To do this right we need a feature of e-TeX, \scantokens,
+% which we arrange to emulate with a temporary file in ordinary TeX.
+\ifx\eTeXversion\thisisundefined
+ \newwrite\macscribble
+ \def\scantokens#1{%
+ \toks0={#1}%
+ \immediate\openout\macscribble=\jobname.tmp
+ \immediate\write\macscribble{\the\toks0}%
+ \immediate\closeout\macscribble
+ \input \jobname.tmp
+ }
+\fi
+
+\let\aftermacroxxx\relax
+\def\aftermacro{\aftermacroxxx}
+
+% alias because \c means cedilla in @tex or @math
+\let\texinfoc=\c
+
+% Used at the time of macro expansion.
+% Argument is macro body with arguments substituted
+\def\scanmacro#1{%
+ \newlinechar`\^^M
+ \def\xprocessmacroarg{\eatspaces}%
+ %
+ % Process the macro body under the current catcode regime.
+ \scantokens{#1\texinfoc}\aftermacro%
+ %
+ % The \c is to remove the \newlinechar added by \scantokens, and
+ % can be noticed by \parsearg.
+ % The \aftermacro allows a \comment at the end of the macro definition
+ % to duplicate itself past the final \newlinechar added by \scantokens:
+ % this is used in the definition of \group to comment out a newline. We
+ % don't do the same for \c to support Texinfo files with macros that ended
+ % with a @c, which should no longer be necessary.
+ % We avoid surrounding the call to \scantokens with \bgroup and \egroup
+ % to allow macros to open or close groups themselves.
+}
+
+% Used for copying and captions
+\def\scanexp#1{%
+ \bgroup
+ % Undo catcode changes of \startcontents and \printindex
+ % When called from @insertcopying or (short)caption, we need active
+ % backslash to get it printed correctly.
+ % FIXME: This may not be needed.
+ address@hidden \catcode`\\=\active \escapechar=`\@
+ \edef\temp{\noexpand\scanmacro{#1}}%
+ \temp
+ \egroup
+}
+
+\newcount\paramno % Count of parameters
+\newtoks\macname % Macro name
+\newif\ifrecursive % Is it recursive?
+
+% List of all defined macros in the form
+% \definedummyword\macro1\definedummyword\macro2...
+% Currently is also contains all @aliases; the list can be split
+% if there is a need.
+\def\macrolist{}
+
+% Add the macro to \macrolist
+\def\addtomacrolist#1{\expandafter \addtomacrolistxxx \csname#1\endcsname}
+\def\addtomacrolistxxx#1{%
+ \toks0 = \expandafter{\macrolist\definedummyword#1}%
+ \xdef\macrolist{\the\toks0}%
+}
+
+% Utility routines.
+% This does \let #1 = #2, with \csnames; that is,
+% \let \csname#1\endcsname = \csname#2\endcsname
+% (except of course we have to play expansion games).
+%
+\def\cslet#1#2{%
+ \expandafter\let
+ \csname#1\expandafter\endcsname
+ \csname#2\endcsname
+}
+
+% Trim leading and trailing spaces off a string.
+% Concepts from aro-bend problem 15 (see CTAN).
address@hidden
+\gdef\eatspaces address@hidden }}
+\gdef\trim@ #1{\trim@@ @#1 @ #1 @ @@}
+\gdef\trim@@ #1@ #2@ #3@@{\trim@@@\empty #2 @}
+\def\unbrace#1{#1}
+\unbrace{\gdef\trim@@@ #1 } address@hidden
+}
+
+% Trim a single trailing ^^M off a string.
+{\catcode`\^^M=\other \catcode`\Q=3%
+\gdef\eatcr #1{\eatcra #1Q^^MQ}%
+\gdef\eatcra#1^^MQ{\eatcrb#1Q}%
+\gdef\eatcrb#1Q#2Q{#1}%
+}
+
+% Macro bodies are absorbed as an argument in a context where
+% all characters are catcode 10, 11 or 12, except \ which is active
+% (as in normal texinfo). It is necessary to change the definition of \
+% to recognize macro arguments; this is the job of \mbodybackslash.
+%
+% Non-ASCII encodings make 8-bit characters active, so un-activate
+% them to avoid their expansion. Must do this non-globally, to
+% confine the change to the current group.
+%
+% It's necessary to have hard CRs when the macro is executed. This is
+% done by making ^^M (\endlinechar) catcode 12 when reading the macro
+% body, and then making it the \newlinechar in \scanmacro.
+%
+\def\scanctxt{% used as subroutine
+ \catcode`\"=\other
+ \catcode`\+=\other
+ \catcode`\<=\other
+ \catcode`\>=\other
+ \catcode`\^=\other
+ \catcode`\_=\other
+ \catcode`\|=\other
+ \catcode`\~=\other
+ \ifx\declaredencoding\ascii \else \setnonasciicharscatcodenonglobal\other \fi
+}
+
+\def\scanargctxt{% used for copying and captions, not macros.
+ \scanctxt
+ address@hidden
+ \catcode`\\=\other
+ \catcode`\^^M=\other
+}
+
+\def\macrobodyctxt{% used for @macro definitions
+ \scanctxt
+ \catcode`\ =\other
+ address@hidden
+ \catcode`\{=\other
+ \catcode`\}=\other
+ \catcode`\^^M=\other
+ \usembodybackslash
+}
+
+% Used when scanning braced macro arguments. Note, however, that catcode
+% changes here are ineffectual if the macro invocation was nested inside
+% an argument to another Texinfo command.
+\def\macroargctxt{%
+ \scanctxt
+ \catcode`\ =\active
+ \catcode`\^^M=\other
+ \catcode`\\=\active
+}
+
+\def\macrolineargctxt{% used for whole-line arguments without braces
+ \scanctxt
+ \catcode`\{=\other
+ \catcode`\}=\other
+}
+
+% \mbodybackslash is the definition of \ in @macro bodies.
+% It maps \foo\ => \csname macarg.foo\endcsname => #N
+% where N is the macro parameter number.
+% We define \csname macarg.\endcsname to be \realbackslash, so
+% \\ in macro replacement text gets you a backslash.
+%
address@hidden @address@hidden@active
+ @address@hidden@address@hidden
+ @address@hidden@csname address@hidden
+}
+\expandafter\def\csname macarg.\endcsname{\realbackslash}
+
+\def\margbackslash#1{\char`\#1 }
+
+\def\macro{\recursivefalse\parsearg\macroxxx}
+\def\rmacro{\recursivetrue\parsearg\macroxxx}
+
+\def\macroxxx#1{%
+ \getargs{#1}% now \macname is the macname and \argl the arglist
+ \ifx\argl\empty % no arguments
+ \paramno=0\relax
+ \else
+ \expandafter\parsemargdef \argl;%
+ \if\paramno>256\relax
+ \ifx\eTeXversion\thisisundefined
+ \errhelp = \EMsimple
+ \errmessage{You need eTeX to compile a file with macros with more
than 256 arguments}
+ \fi
+ \fi
+ \fi
+ \if1\csname ismacro.\the\macname\endcsname
+ \message{Warning: redefining \the\macname}%
+ \else
+ \expandafter\ifx\csname \the\macname\endcsname \relax
+ \else \errmessage{Macro name \the\macname\space already defined}\fi
+ \global\cslet{macsave.\the\macname}{\the\macname}%
+ \global\expandafter\let\csname ismacro.\the\macname\endcsname=1%
+ \addtomacrolist{\the\macname}%
+ \fi
+ \begingroup \macrobodyctxt
+ \ifrecursive \expandafter\parsermacbody
+ \else \expandafter\parsemacbody
+ \fi}
+
+\parseargdef\unmacro{%
+ \if1\csname ismacro.#1\endcsname
+ \global\cslet{#1}{macsave.#1}%
+ \global\expandafter\let \csname ismacro.#1\endcsname=0%
+ % Remove the macro name from \macrolist:
+ \begingroup
+ \expandafter\let\csname#1\endcsname \relax
+ \let\definedummyword\unmacrodo
+ \xdef\macrolist{\macrolist}%
+ \endgroup
+ \else
+ \errmessage{Macro #1 not defined}%
+ \fi
+}
+
+% Called by \do from \dounmacro on each macro. The idea is to omit any
+% macro definitions that have been changed to \relax.
+%
+\def\unmacrodo#1{%
+ \ifx #1\relax
+ % remove this
+ \else
+ \noexpand\definedummyword \noexpand#1%
+ \fi
+}
+
+% \getargs -- Parse the arguments to a @macro line. Set \macname to
+% the name of the macro, and \argl to the braced argument list.
+\def\getargs#1{\getargsxxx#1{}}
+\def\getargsxxx#1#{\getmacname #1 \relax\getmacargs}
+\def\getmacname#1 #2\relax{\macname={#1}}
+\def\getmacargs#1{\def\argl{#1}}
+% This made use of the feature that if the last token of a
+% <parameter list> is #, then the preceding argument is delimited by
+% an opening brace, and that opening brace is not consumed.
+
+% Parse the optional {params} list to @macro or @rmacro.
+% Set \paramno to the number of arguments,
+% and \paramlist to a parameter text for the macro (e.g. #1,#2,#3 for a
+% three-param macro.) Define \macarg.BLAH for each BLAH in the params
+% list to some hook where the argument is to be expanded. If there are
+% less than 10 arguments that hook is to be replaced by ##N where N
+% is the position in that list, that is to say the macro arguments are to be
+% defined `a la TeX in the macro body.
+%
+% That gets used by \mbodybackslash (above).
+%
+% If there are 10 or more arguments, a different technique is used: see
+% \parsemmanyargdef.
+%
+\def\parsemargdef#1;{%
+ \paramno=0\def\paramlist{}%
+ \let\hash\relax
+ % \hash is redefined to `#' later to get it into definitions
+ \let\processmacroarg\relax
+ \parsemargdefxxx#1,;,%
+ \ifnum\paramno<10\relax\else
+ \paramno0\relax
+ \parsemmanyargdef@@#1,;,% 10 or more arguments
+ \fi
+}
+\def\parsemargdefxxx#1,{%
+ \if#1;\let\next=\relax
+ \else \let\next=\parsemargdefxxx
+ \advance\paramno by 1
+ \expandafter\edef\csname macarg.\eatspaces{#1}\endcsname
+ {\processmacroarg{\hash\the\paramno}}%
+ \edef\paramlist{\paramlist\hash\the\paramno,}%
+ \fi\next}
+
+% \parsemacbody, \parsermacbody
+%
+% Read recursive and nonrecursive macro bodies. (They're different since
+% rec and nonrec macros end differently.)
+%
+% We are in \macrobodyctxt, and the \xdef causes backslashshes in the macro
+% body to be transformed.
+% Set \macrobody to the body of the macro, and call \defmacro.
+%
+{\catcode`\ address@hidden macro{%
+\xdef\macrobody{\eatcr{#1}}\endgroup\defmacro}}%
+{\catcode`\ address@hidden rmacro{%
+\xdef\macrobody{\eatcr{#1}}\endgroup\defmacro}}%
+
+% Make @ a letter, so that we can make private-to-Texinfo macro names.
address@hidden
+\catcode address@hidden
+
+%%%%%%%%%%%%%% Code for > 10 arguments only %%%%%%%%%%%%%%%%%%
+
+% If there are 10 or more arguments, a different technique is used, where the
+% hook remains in the body, and when macro is to be expanded the body is
+% processed again to replace the arguments.
+%
+% In that case, the hook is \the\toks N-1, and we simply set \toks N-1 to the
+% argument N value and then \edef the body (nothing else will expand because of
+% the catcode regime under which the body was input).
+%
+% If you compile with TeX (not eTeX), and you have macros with 10 or more
+% arguments, no macro can have more than 256 arguments (else error).
+%
+% In case that there are 10 or more arguments we parse again the arguments
+% list to set new definitions for the \macarg.BLAH macros corresponding to
+% each BLAH argument. It was anyhow needed to parse already once this list
+% in order to count the arguments, and as macros with at most 9 arguments
+% are by far more frequent than macro with 10 or more arguments, defining
+% twice the \macarg.BLAH macros does not cost too much processing power.
+\def\parsemmanyargdef@@#1,{%
+ \if#1;\let\next=\relax
+ \else
+ \let\next=\parsemmanyargdef@@
+ \edef\tempb{\eatspaces{#1}}%
+ \expandafter\def\expandafter\tempa
+ \expandafter{\csname macarg.\tempb\endcsname}%
+ % Note that we need some extra \noexpand\noexpand, this is because we
+ % don't want \the to be expanded in the \parsermacbody as it uses an
+ % \xdef .
+ \expandafter\edef\tempa
+ {\noexpand\noexpand\noexpand\the\toks\the\paramno}%
+ \advance\paramno by 1\relax
+ \fi\next}
+
+
address@hidden
address@hidden
address@hidden@}%
address@hidden@}%
+
+% This macro is expanded during the Texinfo macro expansion, not during its
+% definition. It gets all the arguments' values and assigns them to macros
+% macarg.ARGNAME
+%
+% #1 is the macro name
+% #2 is the list of argument names
+% #3 is the list of argument values
address@hidden
+ address@hidden
+ address@hidden Need to keep a copy for parameter expansion.
+ \def\paramlist{#2,address@hidden
+ \def\macroname{#1}%
+ \begingroup
+ \macroargctxt
+ \def\argvaluelist{#3,address@hidden
+ address@hidden
+ address@hidden
+ \setemptyargvalues@
+ \else
+ \getargvals@@
+ \fi
+}
+\def\getargvals@@{%
+ \ifx\paramlist\nilm@
+ % Some sanity check needed here that \argvaluelist is also empty.
+ \ifx\argvaluelist\nillm@
+ \else
+ \errhelp = \EMsimple
+ \errmessage{Too many arguments in macro `\macroname'!}%
+ \fi
+ \let\next\macargexpandinbody@
+ \else
+ \ifx\argvaluelist\nillm@
+ % No more arguments values passed to macro. Set remaining named-arg
+ % macros to empty.
+ \let\next\setemptyargvalues@
+ \else
+ % pop current arg name into address@hidden
+ address@hidden@address@hidden@}%
+ address@hidden
+ % pop current argument value into address@hidden
+ address@hidden@address@hidden@}%
+ address@hidden
+ % Here address@hidden is the current arg name and address@hidden is the
current arg value.
+ % First place the new argument macro definition into address@hidden
+ address@hidden
+ \expandafter\let\csname address@hidden
+ address@hidden
+ \csname address@hidden
+ address@hidden@tempe{\the\macname}}%
+ address@hidden@tempd\macargdeflist@
+ \let\next\getargvals@@
+ \fi
+ \fi
+ \next
+}
+
address@hidden
+ \expandafter\expandafter\expandafter\def
+ \expandafter\expandafter\expandafter#2%
+ \expandafter\expandafter\expandafter{%
+ \expandafter#1#2}%
+}
+
+% Replace arguments by their values in the macro body, and place the result
+% in macro address@hidden
+%
address@hidden
+ % To do this we use the property that token registers that are \the'ed
+ % within an \edef expand only once. So we are going to place all argument
+ % values into respective token registers.
+ %
+ % First we save the token context, and initialize argument numbering.
+ \begingroup
+ \paramno0\relax
+ % Then, for each argument number #N, we place the corresponding argument
+ % value into a new token list register \toks#N
+ address@hidden@,;,%
+ % Then, we expand the body so that argument are replaced by their
+ % values. The trick for values not to be expanded themselves is that they
+ % are within tokens and that tokens expand only once in an \edef .
+ address@hidden mac.\macroname .body\endcsname}%
+ % Now we restore the token stack pointer to free the token list registers
+ % which we have used, but we make sure that expanded body is saved after
+ % group.
+ \expandafter
+ \endgroup
+ address@hidden@tempc}%
+ }
+
+% Define the named-macro outside of this group and then close this group.
+%
address@hidden
+ \expandafter
+ \endgroup
+ \macargdeflist@
+ % First the replace in body the macro arguments by their values, the result
+ % is in address@hidden .
+ \macvalstoargs@
+ % Then we point at the \norecurse or \gobble (for recursive) macro value
+ % with address@hidden .
+ address@hidden mac.\macroname .recurse\endcsname
+ % Depending on whether it is recursive or not, we need some tailing
+ % \egroup .
+ address@hidden
+ address@hidden
+ \else
+ address@hidden
+ \fi
+ % And now we do the real job:
+ address@hidden@address@hidden@tempc}%
+ address@hidden
+}
+
address@hidden,{%
+ \if#1;\let\next\relax
+ \else
+ \let\next\putargsintokens@
+ % First we allocate the new token list register, and give it a temporary
+ % alias address@hidden .
+ address@hidden
+ % Then we place the argument value into that token list register.
+ address@hidden macarg.#1\endcsname
+ address@hidden@tempa}%
+ \advance\paramno by 1\relax
+ \fi
+ \next
+}
+
+% Trailing missing arguments are set to empty.
+%
address@hidden
+ \ifx\paramlist\nilm@
+ \let\next\macargexpandinbody@
+ \else
+ address@hidden@
+ \let\next\setemptyargvalues@
+ \fi
+ \next
+}
+
address@hidden,address@hidden
+ address@hidden
+ \expandafter\def\csname macarg.#1\endcsname{}}%
+ address@hidden@tempa\macargdeflist@
+ \def\paramlist{#2}%
+}
+
+% #1 is the element target macro
+% #2 is the list macro
+% #3,#4\endargs@ is the list value
address@hidden,address@hidden
+ \def#1{#3}%
+ \def#2{#4}%
+}
address@hidden,address@hidden
+ \long\def#1{#3}%
+ \long\def#2{#4}%
+}
+
+
+%%%%%%%%%%%%%% End of code for > 10 arguments %%%%%%%%%%%%%%%%%%
+
+
+
+% Remove following spaces at the expansion stage.
+% This works because spaces are discarded before each argument when TeX is
+% getting the arguments for a macro.
+% This must not be immediately followed by a }.
+\long\def\gobblespaces#1{#1}
+
+% This defines a Texinfo @macro or @rmacro, called by \parsemacbody.
+% \macrobody has the body of the macro in it, with placeholders for
+% its parameters, looking like "\processmacroarg{\hash 1}".
+% \paramno is the number of parameters
+% \paramlist is a TeX parameter text, e.g. "#1,#2,#3,"
+% There are eight cases: recursive and nonrecursive macros of zero, one,
+% up to nine, and many arguments.
+% \xdef is used so that macro definitions will survive the file
+% they're defined in: @include reads the file inside a group.
+%
+\def\defmacro{%
+ \let\hash=##% convert placeholders to macro parameter chars
+ \ifnum\paramno=1
+ \def\processmacroarg{\gobblespaces}%
+ % This removes the pair of braces around the argument. We don't
+ % use \eatspaces, because this can cause ends of lines to be lost
+ % when the argument to \eatspaces is read, leading to line-based
+ % commands like "@itemize" not being read correctly.
+ \else
+ \def\processmacroarg{\xprocessmacroarg}%
+ \let\xprocessmacroarg\relax
+ \fi
+ \ifrecursive %%%%%%%%%%%%%% Recursive %%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \ifcase\paramno
+ % 0
+ \expandafter\xdef\csname\the\macname\endcsname{%
+ \noexpand\scanmacro{\macrobody}}%
+ \or % 1
+ \expandafter\xdef\csname\the\macname\endcsname{%
+ \bgroup
+ \noexpand\braceorline
+ \expandafter\noexpand\csname\the\macname @@@\endcsname}%
+ \expandafter\xdef\csname\the\macname @@@\endcsname##1{%
+ \expandafter\noexpand\csname\the\macname @@@@\endcsname{%
+ \noexpand\gobblespaces##1\empty}%
+ % The \empty is for \gobblespaces in case #1 is empty
+ }%
+ \expandafter\xdef\csname\the\macname @@@@\endcsname##1{%
+ \egroup\noexpand\scanmacro{\macrobody}}%
+ \else
+ \ifnum\paramno<10\relax % at most 9
+ % See non-recursive section below for comments
+ \expandafter\xdef\csname\the\macname\endcsname{%
+ \bgroup
+ \noexpand\expandafter
+ \noexpand\macroargctxt
+ \noexpand\expandafter
+ \expandafter\noexpand\csname\the\macname @@\endcsname}%
+ \expandafter\xdef\csname\the\macname @@\endcsname##1{%
+ \noexpand\passargtomacro
+ \expandafter\noexpand\csname\the\macname @@@\endcsname{##1,}}%
+ \expandafter\xdef\csname\the\macname @@@\endcsname##1{%
+ \expandafter\noexpand\csname\the\macname @@@@\endcsname ##1}%
+ \expandafter\expandafter
+ \expandafter\xdef
+ \expandafter\expandafter
+ \csname\the\macname @@@@\endcsname\paramlist{%
+ \egroup\noexpand\scanmacro{\macrobody}}%
+ \else % 10 or more
+ \expandafter\xdef\csname\the\macname\endcsname{%
+ address@hidden
+ }%
+ \global\expandafter\let\csname mac.\the\macname
.body\endcsname\macrobody
+ \global\expandafter\let\csname mac.\the\macname
.recurse\endcsname\gobble
+ \fi
+ \fi
+ \else %%%%%%%%%%%%%%%%%%%%%% Non-recursive %%%%%%%%%%%%%%%%%%%%%%%%%%
+ \ifcase\paramno
+ % 0
+ \expandafter\xdef\csname\the\macname\endcsname{%
+ \noexpand\scanmacro{\macrobody}}%
+ \or % 1
+ \expandafter\xdef\csname\the\macname\endcsname{%
+ \bgroup
+ \noexpand\braceorline
+ \expandafter\noexpand\csname\the\macname @@@\endcsname}%
+ \expandafter\xdef\csname\the\macname @@@\endcsname##1{%
+ \expandafter\noexpand\csname\the\macname @@@@\endcsname{%
+ \noexpand\gobblespaces##1\empty}%
+ % The \empty is for \gobblespaces in case #1 is empty
+ }%
+ \expandafter\xdef\csname\the\macname @@@@\endcsname##1{%
+ \egroup
+ \noexpand\scanmacro{\macrobody}%
+ }%
+ \else % at most 9
+ \ifnum\paramno<10\relax
+ % @MACNAME sets the context for reading the macro argument
+ % @MACNAME@@ gets the argument, processes backslashes and appends a
+ % comma.
+ % @MACNAME@@@ removes braces surrounding the argument list.
+ % @MACNAME@@@@ scans the macro body with arguments substituted.
+ \expandafter\xdef\csname\the\macname\endcsname{%
+ \bgroup
+ \noexpand\expandafter % This \expandafter skip any spaces after the
+ \noexpand\macroargctxt % macro before we change the catcode of space.
+ \noexpand\expandafter
+ \expandafter\noexpand\csname\the\macname @@\endcsname}%
+ \expandafter\xdef\csname\the\macname @@\endcsname##1{%
+ \noexpand\passargtomacro
+ \expandafter\noexpand\csname\the\macname @@@\endcsname{##1,}}%
+ \expandafter\xdef\csname\the\macname @@@\endcsname##1{%
+ \expandafter\noexpand\csname\the\macname @@@@\endcsname ##1}%
+ \expandafter\expandafter
+ \expandafter\xdef
+ \expandafter\expandafter
+ \csname\the\macname @@@@\endcsname\paramlist{%
+ \egroup\noexpand\scanmacro{\macrobody}}%
+ \else % 10 or more:
+ \expandafter\xdef\csname\the\macname\endcsname{%
+ address@hidden
+ }%
+ \global\expandafter\let\csname mac.\the\macname
.body\endcsname\macrobody
+ \global\expandafter\let\csname mac.\the\macname
.recurse\endcsname\norecurse
+ \fi
+ \fi
+ \fi}
+
+\catcode address@hidden % end private-to-Texinfo catcodes
+
+\def\norecurse#1{\bgroup\cslet{#1}{macsave.#1}}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
address@hidden \catcode`\\=13 % We need to manipulate \ so use @ as escape
address@hidden@_=11 % private names
address@hidden@!=11 % used as argument separator
+
+% \passargtomacro#1#2 -
+% Call #1 with a list of tokens #2, with any doubled backslashes in #2
+% compressed to one.
+%
+% This implementation works by expansion, and not execution (so we cannot use
+% \def or similar). This reduces the risk of this failing in contexts where
+% complete expansion is done with no execution (for example, in writing out to
+% an auxiliary file for an index entry).
+%
+% State is kept in the input stream: the argument passed to
+% @look_ahead, @gobble_and_check_finish and @add_segment is
+%
+% THE_MACRO ARG_RESULT ! {PENDING_BS} NEXT_TOKEN (... rest of input)
+%
+% where:
+% THE_MACRO - name of the macro we want to call
+% ARG_RESULT - argument list we build to pass to that macro
+% PENDING_BS - either a backslash or nothing
+% NEXT_TOKEN - used to look ahead in the input stream to see what's coming next
+
address@hidden@passargtomacro#1#2{%
+ @add_segment address@hidden@_finish\%
+}
address@hidden@address@hidden @address@hidden@address@hidden
+
+% #1 - THE_MACRO ARG_RESULT
+% #2 - PENDING_BS
+% #3 - NEXT_TOKEN
+% #4 used to look ahead
+%
+% If the next token is not a backslash, process the rest of the argument;
+% otherwise, remove the next token.
address@hidden@look_ahead#1!#2#3#4{%
+ @ifx#4\%
+ @address@hidden
+ @else
+ @address@hidden
+ @fi#1!{#2}#4#4%
+}
+
+% #1 - THE_MACRO ARG_RESULT
+% #2 - PENDING_BS
+% #3 - NEXT_TOKEN
+% #4 should be a backslash, which is gobbled.
+% #5 looks ahead
+%
+% Double backslash found. Add a single backslash, and look ahead.
address@hidden@gobble_and_check_finish#1!#2#3#4#5{%
+ @add_segment#1\!{}#5#5%
+}
+
address@hidden@address@hidden
+
+% #1 - THE_MACRO ARG_RESULT
+% #2 - PENDING_BS
+% #3 - NEXT_TOKEN
+% #4 is input stream until next backslash
+%
+% Input stream is either at the start of the argument, or just after a
+% backslash sequence, either a lone backslash, or a doubled backslash.
+% NEXT_TOKEN contains the first token in the input stream: if it is \finish,
+% finish; otherwise, append to ARG_RESULT the segment of the argument up until
+% the next backslash. PENDING_BACKSLASH contains a backslash to represent
+% a backslash just before the start of the input stream that has not been
+% added to ARG_RESULT.
address@hidden@add_segment#1!#2#3#4\{%
address@hidden@_finish
+ @call_the_macro#1!%
address@hidden
+ % append the pending backslash to the result, followed by the next segment
+ @address@hidden@address@hidden
+ % this @fi is discarded by @look_ahead.
+ % we can't get rid of it with \expandafter because we don't know how
+ % long #4 is.
+}
+
+% #1 - THE_MACRO
+% #2 - ARG_RESULT
+% #3 discards the res of the conditional in @add_segment, and @is_fi ends the
+% conditional.
address@hidden@address@hidden@is_fi #1{#2}}
+
+}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+% \braceorline MAC is used for a one-argument macro MAC. It checks
+% whether the next non-whitespace character is a {. It sets the context
+% for reading the argument (slightly different in the two cases). Then,
+% to read the argument, in the whole-line case, it then calls the regular
+% \parsearg MAC; in the lbrace case, it calls \passargtomacro MAC.
+%
+\def\braceorline#1{\let\macnamexxx=#1\futurelet\nchar\braceorlinexxx}
+\def\braceorlinexxx{%
+ \ifx\nchar\bgroup
+ \macroargctxt
+ \expandafter\passargtomacro
+ \else
+ \macrolineargctxt\expandafter\parsearg
+ \fi \macnamexxx}
+
+
+% @alias.
+% We need some trickery to remove the optional spaces around the equal
+% sign. Make them active and then expand them all to nothing.
+%
+\def\alias{\parseargusing\obeyspaces\aliasxxx}
+\def\aliasxxx #1{\aliasyyy#1\relax}
+\def\aliasyyy #1=#2\relax{%
+ {%
+ \expandafter\let\obeyedspace=\empty
+ \addtomacrolist{#1}%
+ \xdef\next{\global\let\makecsname{#1}=\makecsname{#2}}%
+ }%
+ \next
+}
+
+
+\message{cross references,}
+
+\newwrite\auxfile
+\newif\ifhavexrefs % True if xref values are known.
+\newif\ifwarnedxrefs % True if we warned once that they aren't known.
+
+% @inforef is relatively simple.
+\def\inforef #1{\inforefzzz #1,,,,**}
+\def\inforefzzz #1,#2,#3,#4**{%
+ \putwordSee{} \putwordInfo{} \putwordfile{} \file{\ignorespaces #3{}},
+ node \samp{\ignorespaces#1{}}}
+
+% @node's only job in TeX is to define \lastnode, which is used in
+% cross-references. The @node line might or might not have commas, and
+% might or might not have spaces before the first comma, like:
+% @node foo , bar , ...
+% We don't want such trailing spaces in the node name.
+%
+\parseargdef\node{\checkenv{}\donode #1 ,\finishnodeparse}
+%
+% also remove a trailing comma, in case of something like this:
+% @node Help-Cross, , , Cross-refs
+\def\donode#1 ,#2\finishnodeparse{\dodonode #1,\finishnodeparse}
+\def\dodonode#1,#2\finishnodeparse{\gdef\lastnode{#1}}
+
+\let\nwnode=\node
+\let\lastnode=\empty
+
+% Write a cross-reference definition for the current node. #1 is the
+% type (Ynumbered, Yappendix, Ynothing).
+%
+\def\donoderef#1{%
+ \ifx\lastnode\empty\else
+ \setref{\lastnode}{#1}%
+ \global\let\lastnode=\empty
+ \fi
+}
+
+% @anchor{NAME} -- define xref target at arbitrary point.
+%
+\newcount\savesfregister
+%
+\def\savesf{\relax \ifhmode \savesfregister=\spacefactor \fi}
+\def\restoresf{\relax \ifhmode \spacefactor=\savesfregister \fi}
+\def\anchor#1{\savesf \setref{#1}{Ynothing}\restoresf \ignorespaces}
+
+% \setref{NAME}{SNT} defines a cross-reference point NAME (a node or an
+% anchor), which consists of three parts:
+% 1) NAME-title - the current sectioning name taken from \lastsection,
+% or the anchor name.
+% 2) NAME-snt - section number and type, passed as the SNT arg, or
+% empty for anchors.
+% 3) NAME-pg - the page number.
+%
+% This is called from \donoderef, \anchor, and \dofloat. In the case of
+% floats, there is an additional part, which is not written here:
+% 4) NAME-lof - the text as it should appear in a @listoffloats.
+%
+\def\setref#1#2{%
+ \pdfmkdest{#1}%
+ \iflinks
+ {%
+ \requireauxfile
+ \atdummies % preserve commands, but don't expand them
+ \edef\writexrdef##1##2{%
+ address@hidden #1 of \setref, expanded by the \edef
+ ##1}{##2}}% these are parameters of \writexrdef
+ }%
+ \toks0 = \expandafter{\lastsection}%
+ \immediate \writexrdef{title}{\the\toks0 }%
+ \immediate \writexrdef{snt}{\csname #2\endcsname}% \Ynumbered etc.
+ \safewhatsit{\writexrdef{pg}{\folio}}% will be written later, at \shipout
+ }%
+ \fi
+}
+
+% @xrefautosectiontitle on|off says whether @section(ing) names are used
+% automatically in xrefs, if the third arg is not explicitly specified.
+% This was provided as a "secret" @set xref-automatic-section-title
+% variable, now it's official.
+%
+\parseargdef\xrefautomaticsectiontitle{%
+ \def\temp{#1}%
+ \ifx\temp\onword
+ \expandafter\let\csname SETxref-automatic-section-title\endcsname
+ = \empty
+ \else\ifx\temp\offword
+ \expandafter\let\csname SETxref-automatic-section-title\endcsname
+ = \relax
+ \else
+ \errhelp = \EMsimple
+ \errmessage{Unknown @xrefautomaticsectiontitle value `\temp',
+ must be on|off}%
+ \fi\fi
+}
+
+%
+% @xref, @pxref, and @ref generate cross-references. For \xrefX, #1 is
+% the node name, #2 the name of the Info cross-reference, #3 the printed
+% node name, #4 the name of the Info file, #5 the name of the printed
+% manual. All but the node name can be omitted.
+%
+\def\pxref{\putwordsee{} \xrefXX}
+\def\xref{\putwordSee{} \xrefXX}
+\def\ref{\xrefXX}
+
+\def\xrefXX#1{\def\xrefXXarg{#1}\futurelet\tokenafterxref\xrefXXX}
+\def\xrefXXX{\expandafter\xrefX\expandafter[\xrefXXarg,,,,,,,]}
+%
+\newbox\toprefbox
+\newbox\printedrefnamebox
+\newbox\infofilenamebox
+\newbox\printedmanualbox
+%
+\def\xrefX[#1,#2,#3,#4,#5,#6]{\begingroup
+ \unsepspaces
+ %
+ % Get args without leading/trailing spaces.
+ \def\printedrefname{\ignorespaces #3}%
+ \setbox\printedrefnamebox = \hbox{\printedrefname\unskip}%
+ %
+ \def\infofilename{\ignorespaces #4}%
+ \setbox\infofilenamebox = \hbox{\infofilename\unskip}%
+ %
+ \def\printedmanual{\ignorespaces #5}%
+ \setbox\printedmanualbox = \hbox{\printedmanual\unskip}%
+ %
+ % If the printed reference name (arg #3) was not explicitly given in
+ % the @xref, figure out what we want to use.
+ \ifdim \wd\printedrefnamebox = 0pt
+ % No printed node name was explicitly given.
+ \expandafter\ifx\csname SETxref-automatic-section-title\endcsname \relax
+ % Not auto section-title: use node name inside the square brackets.
+ \def\printedrefname{\ignorespaces #1}%
+ \else
+ % Auto section-title: use chapter/section title inside
+ % the square brackets if we have it.
+ \ifdim \wd\printedmanualbox > 0pt
+ % It is in another manual, so we don't have it; use node name.
+ \def\printedrefname{\ignorespaces #1}%
+ \else
+ \ifhavexrefs
+ % We (should) know the real title if we have the xref values.
+ \def\printedrefname{\refx{#1-title}{}}%
+ \else
+ % Otherwise just copy the Info node name.
+ \def\printedrefname{\ignorespaces #1}%
+ \fi%
+ \fi
+ \fi
+ \fi
+ %
+ % Make link in pdf output.
+ \ifpdf
+ {\indexnofonts
+ \turnoffactive
+ \makevalueexpandable
+ % This expands tokens, so do it after making catcode changes, so _
+ % etc. don't get their TeX definitions. This ignores all spaces in
+ % #4, including (wrongly) those in the middle of the filename.
+ \getfilename{#4}%
+ %
+ % This (wrongly) does not take account of leading or trailing
+ % spaces in #1, which should be ignored.
+ \edef\pdfxrefdest{#1}%
+ \ifx\pdfxrefdest\empty
+ \def\pdfxrefdest{Top}% no empty targets
+ \else
+ \txiescapepdf\pdfxrefdest % escape PDF special chars
+ \fi
+ %
+ \leavevmode
+ \startlink attr{/Border [0 0 0]}%
+ \ifnum\filenamelength>0
+ goto file{\the\filename.pdf} name{\pdfxrefdest}%
+ \else
+ goto name{\pdfmkpgn{\pdfxrefdest}}%
+ \fi
+ }%
+ \setcolor{\linkcolor}%
+ \fi
+ {%
+ % Have to otherify everything special to allow the \csname to
+ % include an _ in the xref name, etc.
+ \indexnofonts
+ \turnoffactive
+ \expandafter\global\expandafter\let\expandafter\Xthisreftitle
+ \csname XR#1-title\endcsname
+ }%
+ %
+ % Float references are printed completely differently: "Figure 1.2"
+ % instead of "[somenode], p.3". \iffloat distinguishes them by
+ % \Xthisreftitle being set to a magic string.
+ \iffloat\Xthisreftitle
+ % If the user specified the print name (third arg) to the ref,
+ % print it instead of our usual "Figure 1.2".
+ \ifdim\wd\printedrefnamebox = 0pt
+ \refx{#1-snt}{}%
+ \else
+ \printedrefname
+ \fi
+ %
+ % If the user also gave the printed manual name (fifth arg), append
+ % "in MANUALNAME".
+ \ifdim \wd\printedmanualbox > 0pt
+ \space \putwordin{} \cite{\printedmanual}%
+ \fi
+ \else
+ % node/anchor (non-float) references.
+ %
+ % If we use \unhbox to print the node names, TeX does not insert
+ % empty discretionaries after hyphens, which means that it will not
+ % find a line break at a hyphen in a node names. Since some manuals
+ % are best written with fairly long node names, containing hyphens,
+ % this is a loss. Therefore, we give the text of the node name
+ % again, so it is as if TeX is seeing it for the first time.
+ %
+ \ifdim \wd\printedmanualbox > 0pt
+ % Cross-manual reference with a printed manual name.
+ %
+ \crossmanualxref{\cite{\printedmanual\unskip}}%
+ %
+ \else\ifdim \wd\infofilenamebox > 0pt
+ % Cross-manual reference with only an info filename (arg 4), no
+ % printed manual name (arg 5). This is essentially the same as
+ % the case above; we output the filename, since we have nothing else.
+ %
+ \crossmanualxref{\code{\infofilename\unskip}}%
+ %
+ \else
+ % Reference within this manual.
+ %
+ % _ (for example) has to be the character _ for the purposes of the
+ % control sequence corresponding to the node, but it has to expand
+ % into the usual \leavevmode...\vrule stuff for purposes of
+ % printing. So we \turnoffactive for the \refx-snt, back on for the
+ % printing, back off for the \refx-pg.
+ {\turnoffactive
+ % Only output a following space if the -snt ref is nonempty; for
+ % @unnumbered and @anchor, it won't be.
+ \setbox2 = \hbox{\ignorespaces \refx{#1-snt}{}}%
+ \ifdim \wd2 > 0pt \refx{#1-snt}\space\fi
+ }%
+ % output the `[mynode]' via the macro below so it can be overridden.
+ \xrefprintnodename\printedrefname
+ %
+ % But we always want a comma and a space:
+ ,\space
+ %
+ % output the `page 3'.
+ \turnoffactive \putwordpage\tie\refx{#1-pg}{}%
+ % Add a , if xref followed by a space
+ \if\space\noexpand\tokenafterxref ,%
+ \else\ifx\ \tokenafterxref ,% @TAB
+ \else\ifx\*\tokenafterxref ,% @*
+ \else\ifx\ \tokenafterxref ,% @SPACE
+ \else\ifx\
+ \tokenafterxref ,% @NL
+ \else\ifx\tie\tokenafterxref ,% @tie
+ \fi\fi\fi\fi\fi\fi
+ \fi\fi
+ \fi
+ \endlink
+\endgroup}
+
+% Output a cross-manual xref to #1. Used just above (twice).
+%
+% Only include the text "Section ``foo'' in" if the foo is neither
+% missing or Top. Thus, @xref{,,,foo,The Foo Manual} outputs simply
+% "see The Foo Manual", the idea being to refer to the whole manual.
+%
+% But, this being TeX, we can't easily compare our node name against the
+% string "Top" while ignoring the possible spaces before and after in
+% the input. By adding the arbitrary 7sp below, we make it much less
+% likely that a real node name would have the same width as "Top" (e.g.,
+% in a monospaced font). Hopefully it will never happen in practice.
+%
+% For the same basic reason, we retypeset the "Top" at every
+% reference, since the current font is indeterminate.
+%
+\def\crossmanualxref#1{%
+ \setbox\toprefbox = \hbox{Top\kern7sp}%
+ \setbox2 = \hbox{\ignorespaces \printedrefname \unskip \kern7sp}%
+ \ifdim \wd2 > 7sp % nonempty?
+ \ifdim \wd2 = \wd\toprefbox \else % same as Top?
+ \putwordSection{} ``\printedrefname'' \putwordin{}\space
+ \fi
+ \fi
+ #1%
+}
+
+% This macro is called from \xrefX for the `[nodename]' part of xref
+% output. It's a separate macro only so it can be changed more easily,
+% since square brackets don't work well in some documents. Particularly
+% one that Bob is working on :).
+%
+\def\xrefprintnodename#1{[#1]}
+
+% Things referred to by \setref.
+%
+\def\Ynothing{}
+\def\Yomitfromtoc{}
+\def\Ynumbered{%
+ \ifnum\secno=0
+ address@hidden \the\chapno
+ \else \ifnum\subsecno=0
+ address@hidden \the\chapno.\the\secno
+ \else \ifnum\subsubsecno=0
+ address@hidden \the\chapno.\the\secno.\the\subsecno
+ \else
+ address@hidden \the\chapno.\the\secno.\the\subsecno.\the\subsubsecno
+ \fi\fi\fi
+}
+\def\Yappendix{%
+ \ifnum\secno=0
+ address@hidden @char\the\appendixno{}%
+ \else \ifnum\subsecno=0
+ address@hidden @char\the\appendixno.\the\secno
+ \else \ifnum\subsubsecno=0
+ address@hidden @char\the\appendixno.\the\secno.\the\subsecno
+ \else
+ address@hidden
+ @char\the\appendixno.\the\secno.\the\subsecno.\the\subsubsecno
+ \fi\fi\fi
+}
+
+% Define \refx{NAME}{SUFFIX} to reference a cross-reference string named NAME.
+% If its value is nonempty, SUFFIX is output afterward.
+%
+\def\refx#1#2{%
+ \requireauxfile
+ {%
+ \indexnofonts
+ \otherbackslash
+ \expandafter\global\expandafter\let\expandafter\thisrefX
+ \csname XR#1\endcsname
+ }%
+ \ifx\thisrefX\relax
+ % If not defined, say something at least.
+ \angleleft un\-de\-fined\angleright
+ \iflinks
+ \ifhavexrefs
+ {\toks0 = {#1}% avoid expansion of possibly-complex value
+ \message{\linenumber Undefined cross reference `\the\toks0'.}}%
+ \else
+ \ifwarnedxrefs\else
+ \global\warnedxrefstrue
+ \message{Cross reference values unknown; you must run TeX again.}%
+ \fi
+ \fi
+ \fi
+ \else
+ % It's defined, so just use it.
+ \thisrefX
+ \fi
+ #2% Output the suffix in any case.
+}
+
+% This is the macro invoked by entries in the aux file. Usually it's
+% just a \def (we prepend XR to the control sequence name to avoid
+% collisions). But if this is a float type, we have more work to do.
+%
+\def\xrdef#1#2{%
+ {% The node name might contain 8-bit characters, which in our current
+ % implementation are changed to commands like @'e. Don't let these
+ % mess up the control sequence name.
+ \indexnofonts
+ \turnoffactive
+ \xdef\safexrefname{#1}%
+ }%
+ %
+ \expandafter\gdef\csname XR\safexrefname\endcsname{#2}% remember this xref
+ %
+ % Was that xref control sequence that we just defined for a float?
+ \expandafter\iffloat\csname XR\safexrefname\endcsname
+ % it was a float, and we have the (safe) float type in \iffloattype.
+ \expandafter\let\expandafter\floatlist
+ \csname floatlist\iffloattype\endcsname
+ %
+ % Is this the first time we've seen this float type?
+ \expandafter\ifx\floatlist\relax
+ \toks0 = {\do}% yes, so just \do
+ \else
+ % had it before, so preserve previous elements in list.
+ \toks0 = \expandafter{\floatlist\do}%
+ \fi
+ %
+ % Remember this xref in the control sequence \floatlistFLOATTYPE,
+ % for later use in \listoffloats.
+ \expandafter\xdef\csname floatlist\iffloattype\endcsname{\the\toks0
+ {\safexrefname}}%
+ \fi
+}
+
+% If working on a large document in chapters, it is convenient to
+% be able to disable indexing, cross-referencing, and contents, for test runs.
+% This is done with @novalidate at the beginning of the file.
+%
+\newif\iflinks \linkstrue % by default we want the aux files.
+\let\novalidate = \linksfalse
+
+% Used when writing to the aux file, or when using data from it.
+\def\requireauxfile{%
+ \iflinks
+ \tryauxfile
+ % Open the new aux file. TeX will close it automatically at exit.
+ \immediate\openout\auxfile=\jobname.aux
+ \fi
+ \global\let\requireauxfile=\relax % Only do this once.
+}
+
+% Read the last existing aux file, if any. No error if none exists.
+%
+\def\tryauxfile{%
+ \openin 1 \jobname.aux
+ \ifeof 1 \else
+ \readdatafile{aux}%
+ \global\havexrefstrue
+ \fi
+ \closein 1
+}
+
+\def\setupdatafile{%
+ address@hidden
+ \catcode`\^^A=\other
+ \catcode`\^^B=\other
+ \catcode`\^^C=\other
+ \catcode`\^^D=\other
+ \catcode`\^^E=\other
+ \catcode`\^^F=\other
+ \catcode`\^^G=\other
+ \catcode`\^^H=\other
+ \catcode`\^^K=\other
+ \catcode`\^^L=\other
+ \catcode`\^^N=\other
+ \catcode`\^^P=\other
+ \catcode`\^^Q=\other
+ \catcode`\^^R=\other
+ \catcode`\^^S=\other
+ \catcode`\^^T=\other
+ \catcode`\^^U=\other
+ \catcode`\^^V=\other
+ \catcode`\^^W=\other
+ \catcode`\^^X=\other
+ \catcode`\^^Z=\other
+ \catcode`\^^[=\other
+ \catcode`\^^\=\other
+ \catcode`\^^]=\other
+ \catcode`\^^^=\other
+ \catcode`\^^_=\other
+ % It was suggested to set the catcode of ^ to 7, which would allow ^^e4 etc.
+ % in xref tags, i.e., node names. But since ^^e4 notation isn't
+ % supported in the main text, it doesn't seem desirable. Furthermore,
+ % that is not enough: for node names that actually contain a ^
+ % character, we would end up writing a line like this: 'xrdef {'hat
+ % b-title}{'hat b} and \xrdef does a \csname...\endcsname on the first
+ % argument, and \hat is not an expandable control sequence. It could
+ % all be worked out, but why? Either we support ^^ or we don't.
+ %
+ % The other change necessary for this was to define \auxhat:
+ % \def\auxhat{\def^{'hat }}% extra space so ok if followed by letter
+ % and then to call \auxhat in \setq.
+ %
+ \catcode`\^=\other
+ %
+ % Special characters. Should be turned off anyway, but...
+ \catcode`\~=\other
+ \catcode`\[=\other
+ \catcode`\]=\other
+ \catcode`\"=\other
+ \catcode`\_=\other
+ \catcode`\|=\other
+ \catcode`\<=\other
+ \catcode`\>=\other
+ \catcode`\$=\other
+ \catcode`\#=\other
+ \catcode`\&=\other
+ \catcode`\%=\other
+ \catcode`+=\other % avoid \+ for paranoia even though we've turned it off
+ %
+ % This is to support \ in node names and titles, since the \
+ % characters end up in a \csname. It's easier than
+ % leaving it active and making its active definition an actual \
+ % character. What I don't understand is why it works in the *value*
+ % of the xrdef. Seems like it should be a catcode12 \, and that
+ % should not typeset properly. But it works, so I'm moving on for
+ % now. --karl, 15jan04.
+ \catcode`\\=\other
+ %
+ % Make the characters 128-255 be printing characters.
+ {\setnonasciicharscatcodenonglobal\other}%
+ %
+ % @ is our escape character in .aux files, and we need braces.
+ \catcode`\{=1
+ \catcode`\}=2
+ address@hidden
+}
+
+\def\readdatafile#1{%
+\begingroup
+ \setupdatafile
+ \input\jobname.#1
+\endgroup}
+
+
+\message{insertions,}
+% including footnotes.
+
+\newcount \footnoteno
+
+% The trailing space in the following definition for supereject is
+% vital for proper filling; pages come out unaligned when you do a
+% pagealignmacro call if that space before the closing brace is
+% removed. (Generally, numeric constants should always be followed by a
+% space to prevent strange expansion errors.)
+\def\supereject{\par\penalty -20000\footnoteno =0 }
+
+% @footnotestyle is meaningful for Info output only.
+\let\footnotestyle=\comment
+
+{\catcode address@hidden
+%
+% Auto-number footnotes. Otherwise like plain.
+\gdef\footnote{%
+ \global\advance\footnoteno by address@hidden
+ \edef\thisfootno{$^{\the\footnoteno}$}%
+ %
+ % In case the footnote comes at the end of a sentence, preserve the
+ % extra spacing after we do the footnote number.
+ address@hidden
+ address@hidden
+ %
+ % Remove inadvertent blank space before typesetting the footnote number.
+ \unskip
+ address@hidden
+ \dofootnote
+}%
+
+% Don't bother with the trickery in plain.tex to not require the
+% footnote text as a parameter. Our footnotes don't need to be so general.
+%
+% Oh yes, they do; otherwise, @ifset (and anything else that uses
+% \parseargline) fails inside footnotes because the tokens are fixed when
+% the footnote is read. --karl, 16nov96.
+%
+\gdef\dofootnote{%
+ \insert\footins\bgroup
+ %
+ % Nested footnotes are not supported in TeX, that would take a lot
+ % more work. (\startsavinginserts does not suffice.)
+ \let\footnote=\errfootnotenest
+ %
+ % We want to typeset this text as a normal paragraph, even if the
+ % footnote reference occurs in (for example) a display environment.
+ % So reset some parameters.
+ \hsize=\pagewidth
+ \interlinepenalty\interfootnotelinepenalty
+ \splittopskip\ht\strutbox % top baseline for broken footnotes
+ \splitmaxdepth\dp\strutbox
+ address@hidden
+ address@hidden
+ address@hidden
+ address@hidden
+ address@hidden
+ \parindent\defaultparindent
+ %
+ \smallfonts \rm
+ %
+ % Because we use hanging indentation in footnotes, a @noindent appears
+ % to exdent this text, so make it be a no-op. makeinfo does not use
+ % hanging indentation so @noindent can still be needed within footnote
+ % text after an @example or the like (not that this is good style).
+ \let\noindent = \relax
+ %
+ % Hang the footnote text off the number. Use \everypar in case the
+ % footnote extends for more than one paragraph.
+ \everypar = {\hang}%
+ \textindent{\thisfootno}%
+ %
+ % Don't crash into the line above the footnote text. Since this
+ % expands into a box, it must come within the paragraph, lest it
+ % provide a place where TeX can split the footnote.
+ \footstrut
+ %
+ % Invoke rest of plain TeX footnote routine.
+ address@hidden
+}
+}%end \catcode address@hidden
+
+\def\errfootnotenest{%
+ \errhelp=\EMsimple
+ \errmessage{Nested footnotes not supported in texinfo.tex,
+ even though they work in makeinfo; sorry}
+}
+
+\def\errfootnoteheading{%
+ \errhelp=\EMsimple
+ \errmessage{Footnotes in chapters, sections, etc., are not supported}
+}
+
+% In case a @footnote appears in a vbox, save the footnote text and create
+% the real \insert just after the vbox finished. Otherwise, the insertion
+% would be lost.
+% Similarly, if a @footnote appears inside an alignment, save the footnote
+% text to a box and make the \insert when a row of the table is finished.
+% And the same can be done for other insert classes. --kasal, 16nov03.
+%
+% Replace the \insert primitive by a cheating macro.
+% Deeper inside, just make sure that the saved insertions are not spilled
+% out prematurely.
+%
+\def\startsavinginserts{%
+ \ifx \insert\ptexinsert
+ \let\insert\saveinsert
+ \else
+ \let\checkinserts\relax
+ \fi
+}
+
+% This \insert replacement works for both \insert\footins{foo} and
+% \insert\footins\bgroup foo\egroup, but it doesn't work for \insert27{foo}.
+%
+\def\saveinsert#1{%
+ \edef\next{\noexpand\savetobox \makeSAVEname#1}%
+ \afterassignment\next
+ % swallow the left brace
+ \let\temp =
+}
+\def\makeSAVEname#1{\makecsname{SAVE\expandafter\gobble\string#1}}
+\def\savetobox#1{\global\setbox#1 = \vbox\bgroup \unvbox#1}
+
+\def\checksaveins#1{\ifvoid#1\else \placesaveins#1\fi}
+
+\def\placesaveins#1{%
+ \ptexinsert \csname\expandafter\gobblesave\string#1\endcsname
+ {\box#1}%
+}
+
+% eat @SAVE -- beware, all of them have catcode \other:
+{
+ \def\dospecials{\do S\do A\do V\do E} \uncatcodespecials % ;-)
+ \gdef\gobblesave @SAVE{}
+}
+
+% initialization:
+\def\newsaveins #1{%
+ \edef\next{\noexpand\newsaveinsX \makeSAVEname#1}%
+ \next
+}
+\def\newsaveinsX #1{%
+ \csname newbox\endcsname #1%
+ \expandafter\def\expandafter\checkinserts\expandafter{\checkinserts
+ \checksaveins #1}%
+}
+
+% initialize:
+\let\checkinserts\empty
+\newsaveins\footins
+\newsaveins\margin
+
+
+% @image. We use the macros from epsf.tex to support this.
+% If epsf.tex is not installed and @image is used, we complain.
+%
+% Check for and read epsf.tex up front. If we read it only at @image
+% time, we might be inside a group, and then its definitions would get
+% undone and the next image would fail.
+\openin 1 = epsf.tex
+\ifeof 1 \else
+ % Do not bother showing banner with epsf.tex v2.7k (available in
+ % doc/epsf.tex and on ctan).
+ \def\epsfannounce{\toks0 = }%
+ \input epsf.tex
+\fi
+\closein 1
+%
+% We will only complain once about lack of epsf.tex.
+\newif\ifwarnednoepsf
+\newhelp\noepsfhelp{epsf.tex must be installed for images to
+ work. It is also included in the Texinfo distribution, or you can get
+ it from ftp://tug.org/tex/epsf.tex.}
+%
+\def\image#1{%
+ \ifx\epsfbox\thisisundefined
+ \ifwarnednoepsf \else
+ \errhelp = \noepsfhelp
+ \errmessage{epsf.tex not found, images will be ignored}%
+ \global\warnednoepsftrue
+ \fi
+ \else
+ \imagexxx #1,,,,,\finish
+ \fi
+}
+%
+% Arguments to @image:
+% #1 is (mandatory) image filename; we tack on .eps extension.
+% #2 is (optional) width, #3 is (optional) height.
+% #4 is (ignored optional) html alt text.
+% #5 is (ignored optional) extension.
+% #6 is just the usual extra ignored arg for parsing stuff.
+\newif\ifimagevmode
+\def\imagexxx#1,#2,#3,#4,#5,#6\finish{\begingroup
+ \catcode`\^^M = 5 % in case we're inside an example
+ \normalturnoffactive % allow _ et al. in names
+ \def\xprocessmacroarg{\eatspaces}% in case we are being used via a macro
+ % If the image is by itself, center it.
+ \ifvmode
+ \imagevmodetrue
+ \else \ifx\centersub\centerV
+ % for @center @image, we need a vbox so we can have our vertical space
+ \imagevmodetrue
+ \vbox\bgroup % vbox has better behavior than vtop herev
+ \fi\fi
+ %
+ \ifimagevmode
+ \nobreak\medskip
+ % Usually we'll have text after the image which will insert
+ % \parskip glue, so insert it here too to equalize the space
+ % above and below.
+ \nobreak\vskip\parskip
+ \nobreak
+ \fi
+ %
+ % Leave vertical mode so that indentation from an enclosing
+ % environment such as @quotation is respected.
+ % However, if we're at the top level, we don't want the
+ % normal paragraph indentation.
+ % On the other hand, if we are in the case of @center @image, we don't
+ % want to start a paragraph, which will create a hsize-width box and
+ % eradicate the centering.
+ \ifx\centersub\centerV\else \noindent \fi
+ %
+ % Output the image.
+ \ifpdf
+ % For pdfTeX and LuaTeX <= 0.80
+ \dopdfimage{#1}{#2}{#3}%
+ \else
+ \ifx\XeTeXrevision\thisisundefined
+ % For epsf.tex
+ % \epsfbox itself resets \epsf?size at each figure.
+ \setbox0 = \hbox{\ignorespaces #2}%
+ \ifdim\wd0 > 0pt \epsfxsize=#2\relax \fi
+ \setbox0 = \hbox{\ignorespaces #3}%
+ \ifdim\wd0 > 0pt \epsfysize=#3\relax \fi
+ \epsfbox{#1.eps}%
+ \else
+ % For XeTeX
+ \doxeteximage{#1}{#2}{#3}%
+ \fi
+ \fi
+ %
+ \ifimagevmode
+ \medskip % space after a standalone image
+ \fi
+ \ifx\centersub\centerV \egroup \fi
+\endgroup}
+
+
+% @float FLOATTYPE,LABEL,LOC ... @end float for displayed figures, tables,
+% etc. We don't actually implement floating yet, we always include the
+% float "here". But it seemed the best name for the future.
+%
+\envparseargdef\float{\eatcommaspace\eatcommaspace\dofloat#1, , ,\finish}
+
+% There may be a space before second and/or third parameter; delete it.
+\def\eatcommaspace#1, {#1,}
+
+% #1 is the optional FLOATTYPE, the text label for this float, typically
+% "Figure", "Table", "Example", etc. Can't contain commas. If omitted,
+% this float will not be numbered and cannot be referred to.
+%
+% #2 is the optional xref label. Also must be present for the float to
+% be referable.
+%
+% #3 is the optional positioning argument; for now, it is ignored. It
+% will somehow specify the positions allowed to float to (here, top, bottom).
+%
+% We keep a separate counter for each FLOATTYPE, which we reset at each
+% chapter-level command.
+\let\resetallfloatnos=\empty
+%
+\def\dofloat#1,#2,#3,#4\finish{%
+ \let\thiscaption=\empty
+ \let\thisshortcaption=\empty
+ %
+ % don't lose footnotes inside @float.
+ %
+ % BEWARE: when the floats start float, we have to issue warning whenever an
+ % insert appears inside a float which could possibly float. --kasal, 26may04
+ %
+ \startsavinginserts
+ %
+ % We can't be used inside a paragraph.
+ \par
+ %
+ \vtop\bgroup
+ \def\floattype{#1}%
+ \def\floatlabel{#2}%
+ \def\floatloc{#3}% we do nothing with this yet.
+ %
+ \ifx\floattype\empty
+ \let\safefloattype=\empty
+ \else
+ {%
+ % the floattype might have accents or other special characters,
+ % but we need to use it in a control sequence name.
+ \indexnofonts
+ \turnoffactive
+ \xdef\safefloattype{\floattype}%
+ }%
+ \fi
+ %
+ % If label is given but no type, we handle that as the empty type.
+ \ifx\floatlabel\empty \else
+ % We want each FLOATTYPE to be numbered separately (Figure 1,
+ % Table 1, Figure 2, ...). (And if no label, no number.)
+ %
+ \expandafter\getfloatno\csname\safefloattype floatno\endcsname
+ \global\advance\floatno by 1
+ %
+ {%
+ % This magic value for \lastsection is output by \setref as the
+ % XREFLABEL-title value. \xrefX uses it to distinguish float
+ % labels (which have a completely different output format) from
+ % node and anchor labels. And \xrdef uses it to construct the
+ % lists of floats.
+ %
+ \edef\lastsection{\floatmagic=\safefloattype}%
+ \setref{\floatlabel}{Yfloat}%
+ }%
+ \fi
+ %
+ % start with \parskip glue, I guess.
+ \vskip\parskip
+ %
+ % Don't suppress indentation if a float happens to start a section.
+ \restorefirstparagraphindent
+}
+
+% we have these possibilities:
+% @float Foo,lbl & @caption{Cap}: Foo 1.1: Cap
+% @float Foo,lbl & no caption: Foo 1.1
+% @float Foo & @caption{Cap}: Foo: Cap
+% @float Foo & no caption: Foo
+% @float ,lbl & Caption{Cap}: 1.1: Cap
+% @float ,lbl & no caption: 1.1
+% @float & @caption{Cap}: Cap
+% @float & no caption:
+%
+\def\Efloat{%
+ \let\floatident = \empty
+ %
+ % In all cases, if we have a float type, it comes first.
+ \ifx\floattype\empty \else \def\floatident{\floattype}\fi
+ %
+ % If we have an xref label, the number comes next.
+ \ifx\floatlabel\empty \else
+ \ifx\floattype\empty \else % if also had float type, need tie first.
+ \appendtomacro\floatident{\tie}%
+ \fi
+ % the number.
+ \appendtomacro\floatident{\chaplevelprefix\the\floatno}%
+ \fi
+ %
+ % Start the printed caption with what we've constructed in
+ % \floatident, but keep it separate; we need \floatident again.
+ \let\captionline = \floatident
+ %
+ \ifx\thiscaption\empty \else
+ \ifx\floatident\empty \else
+ \appendtomacro\captionline{: }% had ident, so need a colon between
+ \fi
+ %
+ % caption text.
+ \appendtomacro\captionline{\scanexp\thiscaption}%
+ \fi
+ %
+ % If we have anything to print, print it, with space before.
+ % Eventually this needs to become an \insert.
+ \ifx\captionline\empty \else
+ \vskip.5\parskip
+ \captionline
+ %
+ % Space below caption.
+ \vskip\parskip
+ \fi
+ %
+ % If have an xref label, write the list of floats info. Do this
+ % after the caption, to avoid chance of it being a breakpoint.
+ \ifx\floatlabel\empty \else
+ % Write the text that goes in the lof to the aux file as
+ % \floatlabel-lof. Besides \floatident, we include the short
+ % caption if specified, else the full caption if specified, else nothing.
+ {%
+ \requireauxfile
+ \atdummies
+ %
+ % since we read the caption text in the macro world, where ^^M
+ % is turned into a normal character, we have to scan it back, so
+ % we don't write the literal three characters "^^M" into the aux file.
+ \scanexp{%
+ \xdef\noexpand\gtemp{%
+ \ifx\thisshortcaption\empty
+ \thiscaption
+ \else
+ \thisshortcaption
+ \fi
+ }%
+ }%
+ address@hidden
+ \ifx\gtemp\empty \else : \gtemp \fi}}%
+ }%
+ \fi
+ \egroup % end of \vtop
+ %
+ % place the captured inserts
+ %
+ % BEWARE: when the floats start floating, we have to issue warning
+ % whenever an insert appears inside a float which could possibly
+ % float. --kasal, 26may04
+ %
+ \checkinserts
+}
+
+% Append the tokens #2 to the definition of macro #1, not expanding either.
+%
+\def\appendtomacro#1#2{%
+ \expandafter\def\expandafter#1\expandafter{#1#2}%
+}
+
+% @caption, @shortcaption
+%
+\def\caption{\docaption\thiscaption}
+\def\shortcaption{\docaption\thisshortcaption}
+\def\docaption{\checkenv\float \bgroup\scanargctxt\defcaption}
+\def\defcaption#1#2{\egroup \def#1{#2}}
+
+% The parameter is the control sequence identifying the counter we are
+% going to use. Create it if it doesn't exist and assign it to \floatno.
+\def\getfloatno#1{%
+ \ifx#1\relax
+ % Haven't seen this figure type before.
+ \csname newcount\endcsname #1%
+ %
+ % Remember to reset this floatno at the next chap.
+ \expandafter\gdef\expandafter\resetallfloatnos
+ \expandafter{\resetallfloatnos #1=0 }%
+ \fi
+ \let\floatno#1%
+}
+
+% \setref calls this to get the XREFLABEL-snt value. We want an @xref
+% to the FLOATLABEL to expand to "Figure 3.1". We call \setref when we
+% first read the @float command.
+%
address@hidden \chaplevelprefix\the\floatno}%
+
+% Magic string used for the XREFLABEL-title value, so \xrefX can
+% distinguish floats from other xref types.
+\def\floatmagic{!!float!!}
+
+% #1 is the control sequence we are passed; we expand into a conditional
+% which is true if #1 represents a float ref. That is, the magic
+% \lastsection value which we \setref above.
+%
+\def\iffloat#1{\expandafter\doiffloat#1==\finish}
+%
+% #1 is (maybe) the \floatmagic string. If so, #2 will be the
+% (safe) float type for this float. We set \iffloattype to #2.
+%
+\def\doiffloat#1=#2=#3\finish{%
+ \def\temp{#1}%
+ \def\iffloattype{#2}%
+ \ifx\temp\floatmagic
+}
+
+% @listoffloats FLOATTYPE - print a list of floats like a table of contents.
+%
+\parseargdef\listoffloats{%
+ \def\floattype{#1}% floattype
+ {%
+ % the floattype might have accents or other special characters,
+ % but we need to use it in a control sequence name.
+ \indexnofonts
+ \turnoffactive
+ \xdef\safefloattype{\floattype}%
+ }%
+ %
+ % \xrdef saves the floats as a \do-list in \floatlistSAFEFLOATTYPE.
+ \expandafter\ifx\csname floatlist\safefloattype\endcsname \relax
+ \ifhavexrefs
+ % if the user said @listoffloats foo but never @float foo.
+ \message{\linenumber No `\safefloattype' floats to list.}%
+ \fi
+ \else
+ \begingroup
+ \leftskip=\tocindent % indent these entries like a toc
+ \let\do=\listoffloatsdo
+ \csname floatlist\safefloattype\endcsname
+ \endgroup
+ \fi
+}
+
+% This is called on each entry in a list of floats. We're passed the
+% xref label, in the form LABEL-title, which is how we save it in the
+% aux file. We strip off the -title and look up \XRLABEL-lof, which
+% has the text we're supposed to typeset here.
+%
+% Figures without xref labels will not be included in the list (since
+% they won't appear in the aux file).
+%
+\def\listoffloatsdo#1{\listoffloatsdoentry#1\finish}
+\def\listoffloatsdoentry#1-title\finish{{%
+ % Can't fully expand XR#1-lof because it can contain anything. Just
+ % pass the control sequence. On the other hand, XR#1-pg is just the
+ % page number, and we want to fully expand that so we can get a link
+ % in pdf output.
+ \toksA = \expandafter{\csname XR#1-lof\endcsname}%
+ %
+ % use the same \entry macro we use to generate the TOC and index.
+ \edef\writeentry{\noexpand\entry{\the\toksA}{\csname XR#1-pg\endcsname}}%
+ \writeentry
+}}
+
+
+\message{localization,}
+
+% For single-language documents, @documentlanguage is usually given very
+% early, just after @documentencoding. Single argument is the language
+% (de) or locale (de_DE) abbreviation.
+%
+{
+ \catcode`\_ = \active
+ \globaldefs=1
+\parseargdef\documentlanguage{%
+ \tex % read txi-??.tex file in plain TeX.
+ % Read the file by the name they passed if it exists.
+ \let_ = \normalunderscore % normal _ character for filename test
+ \openin 1 txi-#1.tex
+ \ifeof 1
+ \documentlanguagetrywithoutunderscore #1_\finish
+ \else
+ \globaldefs = 1 % everything in the txi-LL files needs to persist
+ \input txi-#1.tex
+ \fi
+ \closein 1
+ \endgroup % end raw TeX
+}
+%
+% If they passed de_DE, and txi-de_DE.tex doesn't exist,
+% try txi-de.tex.
+%
+\gdef\documentlanguagetrywithoutunderscore#1_#2\finish{%
+ \openin 1 txi-#1.tex
+ \ifeof 1
+ \errhelp = \nolanghelp
+ \errmessage{Cannot read language file txi-#1.tex}%
+ \else
+ \globaldefs = 1 % everything in the txi-LL files needs to persist
+ \input txi-#1.tex
+ \fi
+ \closein 1
+}
+}% end of special _ catcode
+%
+\newhelp\nolanghelp{The given language definition file cannot be found or
+is empty. Maybe you need to install it? Putting it in the current
+directory should work if nowhere else does.}
+
+% This macro is called from txi-??.tex files; the first argument is the
+% \language name to set (without the "\lang@" prefix), the second and
+% third args are \{left,right}hyphenmin.
+%
+% The language names to pass are determined when the format is built.
+% See the etex.log file created at that time, e.g.,
+% /usr/local/texlive/2008/texmf-var/web2c/pdftex/etex.log.
+%
+% With TeX Live 2008, etex now includes hyphenation patterns for all
+% available languages. This means we can support hyphenation in
+% Texinfo, at least to some extent. (This still doesn't solve the
+% accented characters problem.)
+%
address@hidden
+\def\txisetlanguage#1#2#3{%
+ % do not set the language if the name is undefined in the current TeX.
+ \expandafter\ifx\csname address@hidden \relax
+ \message{no patterns for #1}%
+ \else
+ \global\language = \csname address@hidden
+ \fi
+ % but there is no harm in adjusting the hyphenmin values regardless.
+ \global\lefthyphenmin = #2\relax
+ \global\righthyphenmin = #3\relax
+}
+
+% Get input by bytes instead of by UTF-8 codepoints for XeTeX and LuaTeX,
+% otherwise the encoding support is completely broken.
+\ifx\XeTeXrevision\thisisundefined
+\else
+\XeTeXdefaultencoding "bytes" % For subsequent files to be read
+\XeTeXinputencoding "bytes" % Effective in texinfo.tex only
+% Unfortunately, there seems to be no corresponding XeTeX command for
+% output encoding. This is a problem for auxiliary index and TOC files.
+% The only solution would be perhaps to write out @U{...} sequences in
+% place of UTF-8 characters.
+\fi
+
+\ifx\luatexversion\thisisundefined
+\else
+\directlua{
+local utf8_char, byte, gsub = unicode.utf8.char, string.byte, string.gsub
+local function convert_char (char)
+ return utf8_char(byte(char))
+end
+
+local function convert_line (line)
+ return gsub(line, ".", convert_char)
+end
+
+callback.register("process_input_buffer", convert_line)
+
+local function convert_line_out (line)
+ local line_out = ""
+ for c in string.utfvalues(line) do
+ line_out = line_out .. string.char(c)
+ end
+ return line_out
+end
+
+callback.register("process_output_buffer", convert_line_out)
+}
+\fi
+
+
+% Helpers for encodings.
+% Set the catcode of characters 128 through 255 to the specified number.
+%
+\def\setnonasciicharscatcode#1{%
+ \count255=128
+ \loop\ifnum\count255<256
+ \global\catcode\count255=#1\relax
+ \advance\count255 by 1
+ \repeat
+}
+
+\def\setnonasciicharscatcodenonglobal#1{%
+ \count255=128
+ \loop\ifnum\count255<256
+ \catcode\count255=#1\relax
+ \advance\count255 by 1
+ \repeat
+}
+
+% @documentencoding sets the definition of non-ASCII characters
+% according to the specified encoding.
+%
+\def\documentencoding{\parseargusing\filenamecatcodes\documentencodingzzz}
+\def\documentencodingzzz#1{%
+ % Get input by bytes instead of by UTF-8 codepoints for XeTeX,
+ % otherwise the encoding support is completely broken.
+ % This settings is for the document root file.
+ \ifx\XeTeXrevision\thisisundefined
+ \else
+ \XeTeXinputencoding "bytes"
+ \fi
+ %
+ % Encoding being declared for the document.
+ \def\declaredencoding{\csname #1.enc\endcsname}%
+ %
+ % Supported encodings: names converted to tokens in order to be able
+ % to compare them with \ifx.
+ \def\ascii{\csname US-ASCII.enc\endcsname}%
+ \def\latnine{\csname ISO-8859-15.enc\endcsname}%
+ \def\latone{\csname ISO-8859-1.enc\endcsname}%
+ \def\lattwo{\csname ISO-8859-2.enc\endcsname}%
+ \def\utfeight{\csname UTF-8.enc\endcsname}%
+ %
+ \ifx \declaredencoding \ascii
+ \asciichardefs
+ %
+ \else \ifx \declaredencoding \lattwo
+ \setnonasciicharscatcode\active
+ \lattwochardefs
+ %
+ \else \ifx \declaredencoding \latone
+ \setnonasciicharscatcode\active
+ \latonechardefs
+ %
+ \else \ifx \declaredencoding \latnine
+ \setnonasciicharscatcode\active
+ \latninechardefs
+ %
+ \else \ifx \declaredencoding \utfeight
+ \setnonasciicharscatcode\active
+ % since we already invoked \utfeightchardefs at the top level
+ % (below), do not re-invoke it, then our check for duplicated
+ % definitions triggers. Making non-ascii chars active is enough.
+ %
+ \else
+ \message{Ignoring unknown document encoding: #1.}%
+ %
+ \fi % utfeight
+ \fi % latnine
+ \fi % latone
+ \fi % lattwo
+ \fi % ascii
+}
+
+% emacs-page
+% A message to be logged when using a character that isn't available
+% the default font encoding (OT1).
+%
+\def\missingcharmsg#1{\message{Character missing, sorry: #1.}}
+
+% Take account of \c (plain) vs. \, (Texinfo) difference.
+\def\cedilla#1{\ifx\c\ptexc\c{#1}\else\,{#1}\fi}
+
+% First, make active non-ASCII characters in order for them to be
+% correctly categorized when TeX reads the replacement text of
+% macros containing the character definitions.
+\setnonasciicharscatcode\active
+%
+% Latin1 (ISO-8859-1) character definitions.
+\def\latonechardefs{%
+ \gdef^^a0{\tie}
+ \gdef^^a1{\exclamdown}
+ \gdef^^a2{{\tcfont \char162}} % cent
+ \gdef^^a3{\pounds}
+ \gdef^^a4{{\tcfont \char164}} % currency
+ \gdef^^a5{{\tcfont \char165}} % yen
+ \gdef^^a6{{\tcfont \char166}} % broken bar
+ \gdef^^a7{\S}
+ \gdef^^a8{\"{}}
+ \gdef^^a9{\copyright}
+ \gdef^^aa{\ordf}
+ \gdef^^ab{\guillemetleft}
+ \gdef^^ac{\ensuremath\lnot}
+ \gdef^^ad{\-}
+ \gdef^^ae{\registeredsymbol}
+ \gdef^^af{\={}}
+ %
+ \gdef^^b0{\textdegree}
+ \gdef^^b1{$\pm$}
+ \gdef^^b2{$^2$}
+ \gdef^^b3{$^3$}
+ \gdef^^b4{\'{}}
+ \gdef^^b5{$\mu$}
+ \gdef^^b6{\P}
+ \gdef^^b7{\ensuremath\cdot}
+ \gdef^^b8{\cedilla\ }
+ \gdef^^b9{$^1$}
+ \gdef^^ba{\ordm}
+ \gdef^^bb{\guillemetright}
+ \gdef^^bc{$1\over4$}
+ \gdef^^bd{$1\over2$}
+ \gdef^^be{$3\over4$}
+ \gdef^^bf{\questiondown}
+ %
+ \gdef^^c0{\`A}
+ \gdef^^c1{\'A}
+ \gdef^^c2{\^A}
+ \gdef^^c3{\~A}
+ \gdef^^c4{\"A}
+ \gdef^^c5{\ringaccent A}
+ \gdef^^c6{\AE}
+ \gdef^^c7{\cedilla C}
+ \gdef^^c8{\`E}
+ \gdef^^c9{\'E}
+ \gdef^^ca{\^E}
+ \gdef^^cb{\"E}
+ \gdef^^cc{\`I}
+ \gdef^^cd{\'I}
+ \gdef^^ce{\^I}
+ \gdef^^cf{\"I}
+ %
+ \gdef^^d0{\DH}
+ \gdef^^d1{\~N}
+ \gdef^^d2{\`O}
+ \gdef^^d3{\'O}
+ \gdef^^d4{\^O}
+ \gdef^^d5{\~O}
+ \gdef^^d6{\"O}
+ \gdef^^d7{$\times$}
+ \gdef^^d8{\O}
+ \gdef^^d9{\`U}
+ \gdef^^da{\'U}
+ \gdef^^db{\^U}
+ \gdef^^dc{\"U}
+ \gdef^^dd{\'Y}
+ \gdef^^de{\TH}
+ \gdef^^df{\ss}
+ %
+ \gdef^^e0{\`a}
+ \gdef^^e1{\'a}
+ \gdef^^e2{\^a}
+ \gdef^^e3{\~a}
+ \gdef^^e4{\"a}
+ \gdef^^e5{\ringaccent a}
+ \gdef^^e6{\ae}
+ \gdef^^e7{\cedilla c}
+ \gdef^^e8{\`e}
+ \gdef^^e9{\'e}
+ \gdef^^ea{\^e}
+ \gdef^^eb{\"e}
+ \gdef^^ec{\`{\dotless i}}
+ \gdef^^ed{\'{\dotless i}}
+ \gdef^^ee{\^{\dotless i}}
+ \gdef^^ef{\"{\dotless i}}
+ %
+ \gdef^^f0{\dh}
+ \gdef^^f1{\~n}
+ \gdef^^f2{\`o}
+ \gdef^^f3{\'o}
+ \gdef^^f4{\^o}
+ \gdef^^f5{\~o}
+ \gdef^^f6{\"o}
+ \gdef^^f7{$\div$}
+ \gdef^^f8{\o}
+ \gdef^^f9{\`u}
+ \gdef^^fa{\'u}
+ \gdef^^fb{\^u}
+ \gdef^^fc{\"u}
+ \gdef^^fd{\'y}
+ \gdef^^fe{\th}
+ \gdef^^ff{\"y}
+}
+
+% Latin9 (ISO-8859-15) encoding character definitions.
+\def\latninechardefs{%
+ % Encoding is almost identical to Latin1.
+ \latonechardefs
+ %
+ \gdef^^a4{\euro}
+ \gdef^^a6{\v S}
+ \gdef^^a8{\v s}
+ \gdef^^b4{\v Z}
+ \gdef^^b8{\v z}
+ \gdef^^bc{\OE}
+ \gdef^^bd{\oe}
+ \gdef^^be{\"Y}
+}
+
+% Latin2 (ISO-8859-2) character definitions.
+\def\lattwochardefs{%
+ \gdef^^a0{\tie}
+ \gdef^^a1{\ogonek{A}}
+ \gdef^^a2{\u{}}
+ \gdef^^a3{\L}
+ \gdef^^a4{\missingcharmsg{CURRENCY SIGN}}
+ \gdef^^a5{\v L}
+ \gdef^^a6{\'S}
+ \gdef^^a7{\S}
+ \gdef^^a8{\"{}}
+ \gdef^^a9{\v S}
+ \gdef^^aa{\cedilla S}
+ \gdef^^ab{\v T}
+ \gdef^^ac{\'Z}
+ \gdef^^ad{\-}
+ \gdef^^ae{\v Z}
+ \gdef^^af{\dotaccent Z}
+ %
+ \gdef^^b0{\textdegree}
+ \gdef^^b1{\ogonek{a}}
+ \gdef^^b2{\ogonek{ }}
+ \gdef^^b3{\l}
+ \gdef^^b4{\'{}}
+ \gdef^^b5{\v l}
+ \gdef^^b6{\'s}
+ \gdef^^b7{\v{}}
+ \gdef^^b8{\cedilla\ }
+ \gdef^^b9{\v s}
+ \gdef^^ba{\cedilla s}
+ \gdef^^bb{\v t}
+ \gdef^^bc{\'z}
+ \gdef^^bd{\H{}}
+ \gdef^^be{\v z}
+ \gdef^^bf{\dotaccent z}
+ %
+ \gdef^^c0{\'R}
+ \gdef^^c1{\'A}
+ \gdef^^c2{\^A}
+ \gdef^^c3{\u A}
+ \gdef^^c4{\"A}
+ \gdef^^c5{\'L}
+ \gdef^^c6{\'C}
+ \gdef^^c7{\cedilla C}
+ \gdef^^c8{\v C}
+ \gdef^^c9{\'E}
+ \gdef^^ca{\ogonek{E}}
+ \gdef^^cb{\"E}
+ \gdef^^cc{\v E}
+ \gdef^^cd{\'I}
+ \gdef^^ce{\^I}
+ \gdef^^cf{\v D}
+ %
+ \gdef^^d0{\DH}
+ \gdef^^d1{\'N}
+ \gdef^^d2{\v N}
+ \gdef^^d3{\'O}
+ \gdef^^d4{\^O}
+ \gdef^^d5{\H O}
+ \gdef^^d6{\"O}
+ \gdef^^d7{$\times$}
+ \gdef^^d8{\v R}
+ \gdef^^d9{\ringaccent U}
+ \gdef^^da{\'U}
+ \gdef^^db{\H U}
+ \gdef^^dc{\"U}
+ \gdef^^dd{\'Y}
+ \gdef^^de{\cedilla T}
+ \gdef^^df{\ss}
+ %
+ \gdef^^e0{\'r}
+ \gdef^^e1{\'a}
+ \gdef^^e2{\^a}
+ \gdef^^e3{\u a}
+ \gdef^^e4{\"a}
+ \gdef^^e5{\'l}
+ \gdef^^e6{\'c}
+ \gdef^^e7{\cedilla c}
+ \gdef^^e8{\v c}
+ \gdef^^e9{\'e}
+ \gdef^^ea{\ogonek{e}}
+ \gdef^^eb{\"e}
+ \gdef^^ec{\v e}
+ \gdef^^ed{\'{\dotless{i}}}
+ \gdef^^ee{\^{\dotless{i}}}
+ \gdef^^ef{\v d}
+ %
+ \gdef^^f0{\dh}
+ \gdef^^f1{\'n}
+ \gdef^^f2{\v n}
+ \gdef^^f3{\'o}
+ \gdef^^f4{\^o}
+ \gdef^^f5{\H o}
+ \gdef^^f6{\"o}
+ \gdef^^f7{$\div$}
+ \gdef^^f8{\v r}
+ \gdef^^f9{\ringaccent u}
+ \gdef^^fa{\'u}
+ \gdef^^fb{\H u}
+ \gdef^^fc{\"u}
+ \gdef^^fd{\'y}
+ \gdef^^fe{\cedilla t}
+ \gdef^^ff{\dotaccent{}}
+}
+
+% UTF-8 character definitions.
+%
+% This code to support UTF-8 is based on LaTeX's utf8.def, with some
+% changes for Texinfo conventions. It is included here under the GPL by
+% permission from Frank Mittelbach and the LaTeX team.
+%
+\newcount\countUTFx
+\newcount\countUTFy
+\newcount\countUTFz
+
+\gdef\UTFviiiTwoOctets#1#2{\expandafter
+ \UTFviiiDefined\csname u8:#1\string #2\endcsname}
+%
+\gdef\UTFviiiThreeOctets#1#2#3{\expandafter
+ \UTFviiiDefined\csname u8:#1\string #2\string #3\endcsname}
+%
+\gdef\UTFviiiFourOctets#1#2#3#4{\expandafter
+ \UTFviiiDefined\csname u8:#1\string #2\string #3\string #4\endcsname}
+
+\gdef\UTFviiiDefined#1{%
+ \ifx #1\relax
+ \message{\linenumber Unicode char \string #1 not defined for Texinfo}%
+ \else
+ \expandafter #1%
+ \fi
+}
+
+\begingroup
+ \catcode`\~13
+ \catcode`\"12
+
+ \def\UTFviiiLoop{%
+ \global\catcode\countUTFx\active
+ \uccode`\~\countUTFx
+ \uppercase\expandafter{\UTFviiiTmp}%
+ \advance\countUTFx by 1
+ \ifnum\countUTFx < \countUTFy
+ \expandafter\UTFviiiLoop
+ \fi}
+
+ \countUTFx = "C2
+ \countUTFy = "E0
+ \def\UTFviiiTmp{%
+ \xdef~{\noexpand\UTFviiiTwoOctets\string~}}
+ \UTFviiiLoop
+
+ \countUTFx = "E0
+ \countUTFy = "F0
+ \def\UTFviiiTmp{%
+ \xdef~{\noexpand\UTFviiiThreeOctets\string~}}
+ \UTFviiiLoop
+
+ \countUTFx = "F0
+ \countUTFy = "F4
+ \def\UTFviiiTmp{%
+ \xdef~{\noexpand\UTFviiiFourOctets\string~}}
+ \UTFviiiLoop
+\endgroup
+
+\def\globallet{\global\let} % save some \expandafter's below
+
+% @U{xxxx} to produce U+xxxx, if we support it.
+\def\U#1{%
+ \expandafter\ifx\csname uni:#1\endcsname \relax
+ \errhelp = \EMsimple
+ \errmessage{Unicode character U+#1 not supported, sorry}%
+ \else
+ \csname uni:#1\endcsname
+ \fi
+}
+
+\begingroup
+ \catcode`\"=12
+ \catcode`\<=12
+ \catcode`\.=12
+ \catcode`\,=12
+ \catcode`\;=12
+ \catcode`\!=12
+ \catcode`\~=13
+ \gdef\DeclareUnicodeCharacter#1#2{%
+ \countUTFz = "#1\relax
+ %\wlog{\space\space defining Unicode char U+#1 (decimal \the\countUTFz)}%
+ \begingroup
+ \parseXMLCharref
+ \def\UTFviiiTwoOctets##1##2{%
+ \csname u8:##1\string ##2\endcsname}%
+ \def\UTFviiiThreeOctets##1##2##3{%
+ \csname u8:##1\string ##2\string ##3\endcsname}%
+ \def\UTFviiiFourOctets##1##2##3##4{%
+ \csname u8:##1\string ##2\string ##3\string ##4\endcsname}%
+ \expandafter\expandafter\expandafter\expandafter
+ \expandafter\expandafter\expandafter
+ \gdef\UTFviiiTmp{#2}%
+ %
+ \expandafter\ifx\csname uni:#1\endcsname \relax \else
+ \message{Internal error, already defined: #1}%
+ \fi
+ %
+ % define an additional control sequence for this code point.
+ \expandafter\globallet\csname uni:#1\endcsname \UTFviiiTmp
+ \endgroup}
+
+ \gdef\parseXMLCharref{%
+ \ifnum\countUTFz < "A0\relax
+ \errhelp = \EMsimple
+ \errmessage{Cannot define Unicode char value < 00A0}%
+ \else\ifnum\countUTFz < "800\relax
+ \parseUTFviiiA,%
+ \parseUTFviiiB C\UTFviiiTwoOctets.,%
+ \else\ifnum\countUTFz < "10000\relax
+ \parseUTFviiiA;%
+ \parseUTFviiiA,%
+ \parseUTFviiiB E\UTFviiiThreeOctets.{,;}%
+ \else
+ \parseUTFviiiA;%
+ \parseUTFviiiA,%
+ \parseUTFviiiA!%
+ \parseUTFviiiB F\UTFviiiFourOctets.{!,;}%
+ \fi\fi\fi
+ }
+
+ \gdef\parseUTFviiiA#1{%
+ \countUTFx = \countUTFz
+ \divide\countUTFz by 64
+ \countUTFy = \countUTFz
+ \multiply\countUTFz by 64
+ \advance\countUTFx by -\countUTFz
+ \advance\countUTFx by 128
+ \uccode `#1\countUTFx
+ \countUTFz = \countUTFy}
+
+ \gdef\parseUTFviiiB#1#2#3#4{%
+ \advance\countUTFz by "#10\relax
+ \uccode `#3\countUTFz
+ \uppercase{\gdef\UTFviiiTmp{#2#3#4}}}
+\endgroup
+
+% https://en.wikipedia.org/wiki/Plane_(Unicode)#Basic_M
+% U+0000..U+007F = https://en.wikipedia.org/wiki/Basic_Latin_(Unicode_block)
+% U+0080..U+00FF =
https://en.wikipedia.org/wiki/Latin-1_Supplement_(Unicode_block)
+% U+0100..U+017F = https://en.wikipedia.org/wiki/Latin_Extended-A
+% U+0180..U+024F = https://en.wikipedia.org/wiki/Latin_Extended-B
+%
+% Many of our renditions are less than wonderful, and all the missing
+% characters are available somewhere. Loading the necessary fonts
+% awaits user request. We can't truly support Unicode without
+% reimplementing everything that's been done in LaTeX for many years,
+% plus probably using luatex or xetex, and who knows what else.
+% We won't be doing that here in this simple file. But we can try to at
+% least make most of the characters not bomb out.
+%
+\def\utfeightchardefs{%
+ \DeclareUnicodeCharacter{00A0}{\tie}
+ \DeclareUnicodeCharacter{00A1}{\exclamdown}
+ \DeclareUnicodeCharacter{00A2}{{\tcfont \char162}}% 0242=cent
+ \DeclareUnicodeCharacter{00A3}{\pounds}
+ \DeclareUnicodeCharacter{00A4}{{\tcfont \char164}}% 0244=currency
+ \DeclareUnicodeCharacter{00A5}{{\tcfont \char165}}% 0245=yen
+ \DeclareUnicodeCharacter{00A6}{{\tcfont \char166}}% 0246=brokenbar
+ \DeclareUnicodeCharacter{00A7}{\S}
+ \DeclareUnicodeCharacter{00A8}{\"{ }}
+ \DeclareUnicodeCharacter{00A9}{\copyright}
+ \DeclareUnicodeCharacter{00AA}{\ordf}
+ \DeclareUnicodeCharacter{00AB}{\guillemetleft}
+ \DeclareUnicodeCharacter{00AC}{\ensuremath\lnot}
+ \DeclareUnicodeCharacter{00AD}{\-}
+ \DeclareUnicodeCharacter{00AE}{\registeredsymbol}
+ \DeclareUnicodeCharacter{00AF}{\={ }}
+ %
+ \DeclareUnicodeCharacter{00B0}{\ringaccent{ }}
+ \DeclareUnicodeCharacter{00B1}{\ensuremath\pm}
+ \DeclareUnicodeCharacter{00B2}{$^2$}
+ \DeclareUnicodeCharacter{00B3}{$^3$}
+ \DeclareUnicodeCharacter{00B4}{\'{ }}
+ \DeclareUnicodeCharacter{00B5}{$\mu$}
+ \DeclareUnicodeCharacter{00B6}{\P}
+ \DeclareUnicodeCharacter{00B7}{\ensuremath\cdot}
+ \DeclareUnicodeCharacter{00B8}{\cedilla{ }}
+ \DeclareUnicodeCharacter{00B9}{$^1$}
+ \DeclareUnicodeCharacter{00BA}{\ordm}
+ \DeclareUnicodeCharacter{00BB}{\guillemetright}
+ \DeclareUnicodeCharacter{00BC}{$1\over4$}
+ \DeclareUnicodeCharacter{00BD}{$1\over2$}
+ \DeclareUnicodeCharacter{00BE}{$3\over4$}
+ \DeclareUnicodeCharacter{00BF}{\questiondown}
+ %
+ \DeclareUnicodeCharacter{00C0}{\`A}
+ \DeclareUnicodeCharacter{00C1}{\'A}
+ \DeclareUnicodeCharacter{00C2}{\^A}
+ \DeclareUnicodeCharacter{00C3}{\~A}
+ \DeclareUnicodeCharacter{00C4}{\"A}
+ \DeclareUnicodeCharacter{00C5}{\AA}
+ \DeclareUnicodeCharacter{00C6}{\AE}
+ \DeclareUnicodeCharacter{00C7}{\cedilla{C}}
+ \DeclareUnicodeCharacter{00C8}{\`E}
+ \DeclareUnicodeCharacter{00C9}{\'E}
+ \DeclareUnicodeCharacter{00CA}{\^E}
+ \DeclareUnicodeCharacter{00CB}{\"E}
+ \DeclareUnicodeCharacter{00CC}{\`I}
+ \DeclareUnicodeCharacter{00CD}{\'I}
+ \DeclareUnicodeCharacter{00CE}{\^I}
+ \DeclareUnicodeCharacter{00CF}{\"I}
+ %
+ \DeclareUnicodeCharacter{00D0}{\DH}
+ \DeclareUnicodeCharacter{00D1}{\~N}
+ \DeclareUnicodeCharacter{00D2}{\`O}
+ \DeclareUnicodeCharacter{00D3}{\'O}
+ \DeclareUnicodeCharacter{00D4}{\^O}
+ \DeclareUnicodeCharacter{00D5}{\~O}
+ \DeclareUnicodeCharacter{00D6}{\"O}
+ \DeclareUnicodeCharacter{00D7}{\ensuremath\times}
+ \DeclareUnicodeCharacter{00D8}{\O}
+ \DeclareUnicodeCharacter{00D9}{\`U}
+ \DeclareUnicodeCharacter{00DA}{\'U}
+ \DeclareUnicodeCharacter{00DB}{\^U}
+ \DeclareUnicodeCharacter{00DC}{\"U}
+ \DeclareUnicodeCharacter{00DD}{\'Y}
+ \DeclareUnicodeCharacter{00DE}{\TH}
+ \DeclareUnicodeCharacter{00DF}{\ss}
+ %
+ \DeclareUnicodeCharacter{00E0}{\`a}
+ \DeclareUnicodeCharacter{00E1}{\'a}
+ \DeclareUnicodeCharacter{00E2}{\^a}
+ \DeclareUnicodeCharacter{00E3}{\~a}
+ \DeclareUnicodeCharacter{00E4}{\"a}
+ \DeclareUnicodeCharacter{00E5}{\aa}
+ \DeclareUnicodeCharacter{00E6}{\ae}
+ \DeclareUnicodeCharacter{00E7}{\cedilla{c}}
+ \DeclareUnicodeCharacter{00E8}{\`e}
+ \DeclareUnicodeCharacter{00E9}{\'e}
+ \DeclareUnicodeCharacter{00EA}{\^e}
+ \DeclareUnicodeCharacter{00EB}{\"e}
+ \DeclareUnicodeCharacter{00EC}{\`{\dotless{i}}}
+ \DeclareUnicodeCharacter{00ED}{\'{\dotless{i}}}
+ \DeclareUnicodeCharacter{00EE}{\^{\dotless{i}}}
+ \DeclareUnicodeCharacter{00EF}{\"{\dotless{i}}}
+ %
+ \DeclareUnicodeCharacter{00F0}{\dh}
+ \DeclareUnicodeCharacter{00F1}{\~n}
+ \DeclareUnicodeCharacter{00F2}{\`o}
+ \DeclareUnicodeCharacter{00F3}{\'o}
+ \DeclareUnicodeCharacter{00F4}{\^o}
+ \DeclareUnicodeCharacter{00F5}{\~o}
+ \DeclareUnicodeCharacter{00F6}{\"o}
+ \DeclareUnicodeCharacter{00F7}{\ensuremath\div}
+ \DeclareUnicodeCharacter{00F8}{\o}
+ \DeclareUnicodeCharacter{00F9}{\`u}
+ \DeclareUnicodeCharacter{00FA}{\'u}
+ \DeclareUnicodeCharacter{00FB}{\^u}
+ \DeclareUnicodeCharacter{00FC}{\"u}
+ \DeclareUnicodeCharacter{00FD}{\'y}
+ \DeclareUnicodeCharacter{00FE}{\th}
+ \DeclareUnicodeCharacter{00FF}{\"y}
+ %
+ \DeclareUnicodeCharacter{0100}{\=A}
+ \DeclareUnicodeCharacter{0101}{\=a}
+ \DeclareUnicodeCharacter{0102}{\u{A}}
+ \DeclareUnicodeCharacter{0103}{\u{a}}
+ \DeclareUnicodeCharacter{0104}{\ogonek{A}}
+ \DeclareUnicodeCharacter{0105}{\ogonek{a}}
+ \DeclareUnicodeCharacter{0106}{\'C}
+ \DeclareUnicodeCharacter{0107}{\'c}
+ \DeclareUnicodeCharacter{0108}{\^C}
+ \DeclareUnicodeCharacter{0109}{\^c}
+ \DeclareUnicodeCharacter{010A}{\dotaccent{C}}
+ \DeclareUnicodeCharacter{010B}{\dotaccent{c}}
+ \DeclareUnicodeCharacter{010C}{\v{C}}
+ \DeclareUnicodeCharacter{010D}{\v{c}}
+ \DeclareUnicodeCharacter{010E}{\v{D}}
+ \DeclareUnicodeCharacter{010F}{d'}
+ %
+ \DeclareUnicodeCharacter{0110}{\DH}
+ \DeclareUnicodeCharacter{0111}{\dh}
+ \DeclareUnicodeCharacter{0112}{\=E}
+ \DeclareUnicodeCharacter{0113}{\=e}
+ \DeclareUnicodeCharacter{0114}{\u{E}}
+ \DeclareUnicodeCharacter{0115}{\u{e}}
+ \DeclareUnicodeCharacter{0116}{\dotaccent{E}}
+ \DeclareUnicodeCharacter{0117}{\dotaccent{e}}
+ \DeclareUnicodeCharacter{0118}{\ogonek{E}}
+ \DeclareUnicodeCharacter{0119}{\ogonek{e}}
+ \DeclareUnicodeCharacter{011A}{\v{E}}
+ \DeclareUnicodeCharacter{011B}{\v{e}}
+ \DeclareUnicodeCharacter{011C}{\^G}
+ \DeclareUnicodeCharacter{011D}{\^g}
+ \DeclareUnicodeCharacter{011E}{\u{G}}
+ \DeclareUnicodeCharacter{011F}{\u{g}}
+ %
+ \DeclareUnicodeCharacter{0120}{\dotaccent{G}}
+ \DeclareUnicodeCharacter{0121}{\dotaccent{g}}
+ \DeclareUnicodeCharacter{0122}{\cedilla{G}}
+ \DeclareUnicodeCharacter{0123}{\cedilla{g}}
+ \DeclareUnicodeCharacter{0124}{\^H}
+ \DeclareUnicodeCharacter{0125}{\^h}
+ \DeclareUnicodeCharacter{0126}{\missingcharmsg{H WITH STROKE}}
+ \DeclareUnicodeCharacter{0127}{\missingcharmsg{h WITH STROKE}}
+ \DeclareUnicodeCharacter{0128}{\~I}
+ \DeclareUnicodeCharacter{0129}{\~{\dotless{i}}}
+ \DeclareUnicodeCharacter{012A}{\=I}
+ \DeclareUnicodeCharacter{012B}{\={\dotless{i}}}
+ \DeclareUnicodeCharacter{012C}{\u{I}}
+ \DeclareUnicodeCharacter{012D}{\u{\dotless{i}}}
+ \DeclareUnicodeCharacter{012E}{\ogonek{I}}
+ \DeclareUnicodeCharacter{012F}{\ogonek{i}}
+ %
+ \DeclareUnicodeCharacter{0130}{\dotaccent{I}}
+ \DeclareUnicodeCharacter{0131}{\dotless{i}}
+ \DeclareUnicodeCharacter{0132}{IJ}
+ \DeclareUnicodeCharacter{0133}{ij}
+ \DeclareUnicodeCharacter{0134}{\^J}
+ \DeclareUnicodeCharacter{0135}{\^{\dotless{j}}}
+ \DeclareUnicodeCharacter{0136}{\cedilla{K}}
+ \DeclareUnicodeCharacter{0137}{\cedilla{k}}
+ \DeclareUnicodeCharacter{0138}{\ensuremath\kappa}
+ \DeclareUnicodeCharacter{0139}{\'L}
+ \DeclareUnicodeCharacter{013A}{\'l}
+ \DeclareUnicodeCharacter{013B}{\cedilla{L}}
+ \DeclareUnicodeCharacter{013C}{\cedilla{l}}
+ \DeclareUnicodeCharacter{013D}{L'}% should kern
+ \DeclareUnicodeCharacter{013E}{l'}% should kern
+ \DeclareUnicodeCharacter{013F}{L\U{00B7}}
+ %
+ \DeclareUnicodeCharacter{0140}{l\U{00B7}}
+ \DeclareUnicodeCharacter{0141}{\L}
+ \DeclareUnicodeCharacter{0142}{\l}
+ \DeclareUnicodeCharacter{0143}{\'N}
+ \DeclareUnicodeCharacter{0144}{\'n}
+ \DeclareUnicodeCharacter{0145}{\cedilla{N}}
+ \DeclareUnicodeCharacter{0146}{\cedilla{n}}
+ \DeclareUnicodeCharacter{0147}{\v{N}}
+ \DeclareUnicodeCharacter{0148}{\v{n}}
+ \DeclareUnicodeCharacter{0149}{'n}
+ \DeclareUnicodeCharacter{014A}{\missingcharmsg{ENG}}
+ \DeclareUnicodeCharacter{014B}{\missingcharmsg{eng}}
+ \DeclareUnicodeCharacter{014C}{\=O}
+ \DeclareUnicodeCharacter{014D}{\=o}
+ \DeclareUnicodeCharacter{014E}{\u{O}}
+ \DeclareUnicodeCharacter{014F}{\u{o}}
+ %
+ \DeclareUnicodeCharacter{0150}{\H{O}}
+ \DeclareUnicodeCharacter{0151}{\H{o}}
+ \DeclareUnicodeCharacter{0152}{\OE}
+ \DeclareUnicodeCharacter{0153}{\oe}
+ \DeclareUnicodeCharacter{0154}{\'R}
+ \DeclareUnicodeCharacter{0155}{\'r}
+ \DeclareUnicodeCharacter{0156}{\cedilla{R}}
+ \DeclareUnicodeCharacter{0157}{\cedilla{r}}
+ \DeclareUnicodeCharacter{0158}{\v{R}}
+ \DeclareUnicodeCharacter{0159}{\v{r}}
+ \DeclareUnicodeCharacter{015A}{\'S}
+ \DeclareUnicodeCharacter{015B}{\'s}
+ \DeclareUnicodeCharacter{015C}{\^S}
+ \DeclareUnicodeCharacter{015D}{\^s}
+ \DeclareUnicodeCharacter{015E}{\cedilla{S}}
+ \DeclareUnicodeCharacter{015F}{\cedilla{s}}
+ %
+ \DeclareUnicodeCharacter{0160}{\v{S}}
+ \DeclareUnicodeCharacter{0161}{\v{s}}
+ \DeclareUnicodeCharacter{0162}{\cedilla{T}}
+ \DeclareUnicodeCharacter{0163}{\cedilla{t}}
+ \DeclareUnicodeCharacter{0164}{\v{T}}
+ \DeclareUnicodeCharacter{0165}{\v{t}}
+ \DeclareUnicodeCharacter{0166}{\missingcharmsg{H WITH STROKE}}
+ \DeclareUnicodeCharacter{0167}{\missingcharmsg{h WITH STROKE}}
+ \DeclareUnicodeCharacter{0168}{\~U}
+ \DeclareUnicodeCharacter{0169}{\~u}
+ \DeclareUnicodeCharacter{016A}{\=U}
+ \DeclareUnicodeCharacter{016B}{\=u}
+ \DeclareUnicodeCharacter{016C}{\u{U}}
+ \DeclareUnicodeCharacter{016D}{\u{u}}
+ \DeclareUnicodeCharacter{016E}{\ringaccent{U}}
+ \DeclareUnicodeCharacter{016F}{\ringaccent{u}}
+ %
+ \DeclareUnicodeCharacter{0170}{\H{U}}
+ \DeclareUnicodeCharacter{0171}{\H{u}}
+ \DeclareUnicodeCharacter{0172}{\ogonek{U}}
+ \DeclareUnicodeCharacter{0173}{\ogonek{u}}
+ \DeclareUnicodeCharacter{0174}{\^W}
+ \DeclareUnicodeCharacter{0175}{\^w}
+ \DeclareUnicodeCharacter{0176}{\^Y}
+ \DeclareUnicodeCharacter{0177}{\^y}
+ \DeclareUnicodeCharacter{0178}{\"Y}
+ \DeclareUnicodeCharacter{0179}{\'Z}
+ \DeclareUnicodeCharacter{017A}{\'z}
+ \DeclareUnicodeCharacter{017B}{\dotaccent{Z}}
+ \DeclareUnicodeCharacter{017C}{\dotaccent{z}}
+ \DeclareUnicodeCharacter{017D}{\v{Z}}
+ \DeclareUnicodeCharacter{017E}{\v{z}}
+ \DeclareUnicodeCharacter{017F}{\missingcharmsg{LONG S}}
+ %
+ \DeclareUnicodeCharacter{01C4}{D\v{Z}}
+ \DeclareUnicodeCharacter{01C5}{D\v{z}}
+ \DeclareUnicodeCharacter{01C6}{d\v{z}}
+ \DeclareUnicodeCharacter{01C7}{LJ}
+ \DeclareUnicodeCharacter{01C8}{Lj}
+ \DeclareUnicodeCharacter{01C9}{lj}
+ \DeclareUnicodeCharacter{01CA}{NJ}
+ \DeclareUnicodeCharacter{01CB}{Nj}
+ \DeclareUnicodeCharacter{01CC}{nj}
+ \DeclareUnicodeCharacter{01CD}{\v{A}}
+ \DeclareUnicodeCharacter{01CE}{\v{a}}
+ \DeclareUnicodeCharacter{01CF}{\v{I}}
+ %
+ \DeclareUnicodeCharacter{01D0}{\v{\dotless{i}}}
+ \DeclareUnicodeCharacter{01D1}{\v{O}}
+ \DeclareUnicodeCharacter{01D2}{\v{o}}
+ \DeclareUnicodeCharacter{01D3}{\v{U}}
+ \DeclareUnicodeCharacter{01D4}{\v{u}}
+ %
+ \DeclareUnicodeCharacter{01E2}{\={\AE}}
+ \DeclareUnicodeCharacter{01E3}{\={\ae}}
+ \DeclareUnicodeCharacter{01E6}{\v{G}}
+ \DeclareUnicodeCharacter{01E7}{\v{g}}
+ \DeclareUnicodeCharacter{01E8}{\v{K}}
+ \DeclareUnicodeCharacter{01E9}{\v{k}}
+ %
+ \DeclareUnicodeCharacter{01F0}{\v{\dotless{j}}}
+ \DeclareUnicodeCharacter{01F1}{DZ}
+ \DeclareUnicodeCharacter{01F2}{Dz}
+ \DeclareUnicodeCharacter{01F3}{dz}
+ \DeclareUnicodeCharacter{01F4}{\'G}
+ \DeclareUnicodeCharacter{01F5}{\'g}
+ \DeclareUnicodeCharacter{01F8}{\`N}
+ \DeclareUnicodeCharacter{01F9}{\`n}
+ \DeclareUnicodeCharacter{01FC}{\'{\AE}}
+ \DeclareUnicodeCharacter{01FD}{\'{\ae}}
+ \DeclareUnicodeCharacter{01FE}{\'{\O}}
+ \DeclareUnicodeCharacter{01FF}{\'{\o}}
+ %
+ \DeclareUnicodeCharacter{021E}{\v{H}}
+ \DeclareUnicodeCharacter{021F}{\v{h}}
+ %
+ \DeclareUnicodeCharacter{0226}{\dotaccent{A}}
+ \DeclareUnicodeCharacter{0227}{\dotaccent{a}}
+ \DeclareUnicodeCharacter{0228}{\cedilla{E}}
+ \DeclareUnicodeCharacter{0229}{\cedilla{e}}
+ \DeclareUnicodeCharacter{022E}{\dotaccent{O}}
+ \DeclareUnicodeCharacter{022F}{\dotaccent{o}}
+ %
+ \DeclareUnicodeCharacter{0232}{\=Y}
+ \DeclareUnicodeCharacter{0233}{\=y}
+ \DeclareUnicodeCharacter{0237}{\dotless{j}}
+ %
+ \DeclareUnicodeCharacter{02DB}{\ogonek{ }}
+ %
+ % Greek letters upper case
+ \DeclareUnicodeCharacter{0391}{{\it A}}
+ \DeclareUnicodeCharacter{0392}{{\it B}}
+ \DeclareUnicodeCharacter{0393}{\ensuremath{\mit\Gamma}}
+ \DeclareUnicodeCharacter{0394}{\ensuremath{\mit\Delta}}
+ \DeclareUnicodeCharacter{0395}{{\it E}}
+ \DeclareUnicodeCharacter{0396}{{\it Z}}
+ \DeclareUnicodeCharacter{0397}{{\it H}}
+ \DeclareUnicodeCharacter{0398}{\ensuremath{\mit\Theta}}
+ \DeclareUnicodeCharacter{0399}{{\it I}}
+ \DeclareUnicodeCharacter{039A}{{\it K}}
+ \DeclareUnicodeCharacter{039B}{\ensuremath{\mit\Lambda}}
+ \DeclareUnicodeCharacter{039C}{{\it M}}
+ \DeclareUnicodeCharacter{039D}{{\it N}}
+ \DeclareUnicodeCharacter{039E}{\ensuremath{\mit\Xi}}
+ \DeclareUnicodeCharacter{039F}{{\it O}}
+ \DeclareUnicodeCharacter{03A0}{\ensuremath{\mit\Pi}}
+ \DeclareUnicodeCharacter{03A1}{{\it P}}
+ %\DeclareUnicodeCharacter{03A2}{} % none - corresponds to final sigma
+ \DeclareUnicodeCharacter{03A3}{\ensuremath{\mit\Sigma}}
+ \DeclareUnicodeCharacter{03A4}{{\it T}}
+ \DeclareUnicodeCharacter{03A5}{\ensuremath{\mit\Upsilon}}
+ \DeclareUnicodeCharacter{03A6}{\ensuremath{\mit\Phi}}
+ \DeclareUnicodeCharacter{03A7}{{\it X}}
+ \DeclareUnicodeCharacter{03A8}{\ensuremath{\mit\Psi}}
+ \DeclareUnicodeCharacter{03A9}{\ensuremath{\mit\Omega}}
+ %
+ % Vowels with accents
+ \DeclareUnicodeCharacter{0390}{\ensuremath{\ddot{\acute\iota}}}
+ \DeclareUnicodeCharacter{03AC}{\ensuremath{\acute\alpha}}
+ \DeclareUnicodeCharacter{03AD}{\ensuremath{\acute\epsilon}}
+ \DeclareUnicodeCharacter{03AE}{\ensuremath{\acute\eta}}
+ \DeclareUnicodeCharacter{03AF}{\ensuremath{\acute\iota}}
+ \DeclareUnicodeCharacter{03B0}{\ensuremath{\acute{\ddot\upsilon}}}
+ %
+ % Standalone accent
+ \DeclareUnicodeCharacter{0384}{\ensuremath{\acute{\ }}}
+ %
+ % Greek letters lower case
+ \DeclareUnicodeCharacter{03B1}{\ensuremath\alpha}
+ \DeclareUnicodeCharacter{03B2}{\ensuremath\beta}
+ \DeclareUnicodeCharacter{03B3}{\ensuremath\gamma}
+ \DeclareUnicodeCharacter{03B4}{\ensuremath\delta}
+ \DeclareUnicodeCharacter{03B5}{\ensuremath\epsilon}
+ \DeclareUnicodeCharacter{03B6}{\ensuremath\zeta}
+ \DeclareUnicodeCharacter{03B7}{\ensuremath\eta}
+ \DeclareUnicodeCharacter{03B8}{\ensuremath\theta}
+ \DeclareUnicodeCharacter{03B9}{\ensuremath\iota}
+ \DeclareUnicodeCharacter{03BA}{\ensuremath\kappa}
+ \DeclareUnicodeCharacter{03BB}{\ensuremath\lambda}
+ \DeclareUnicodeCharacter{03BC}{\ensuremath\mu}
+ \DeclareUnicodeCharacter{03BD}{\ensuremath\nu}
+ \DeclareUnicodeCharacter{03BE}{\ensuremath\xi}
+ \DeclareUnicodeCharacter{03BF}{{\it o}} % omicron
+ \DeclareUnicodeCharacter{03C0}{\ensuremath\pi}
+ \DeclareUnicodeCharacter{03C1}{\ensuremath\rho}
+ \DeclareUnicodeCharacter{03C2}{\ensuremath\varsigma}
+ \DeclareUnicodeCharacter{03C3}{\ensuremath\sigma}
+ \DeclareUnicodeCharacter{03C4}{\ensuremath\tau}
+ \DeclareUnicodeCharacter{03C5}{\ensuremath\upsilon}
+ \DeclareUnicodeCharacter{03C6}{\ensuremath\phi}
+ \DeclareUnicodeCharacter{03C7}{\ensuremath\chi}
+ \DeclareUnicodeCharacter{03C8}{\ensuremath\psi}
+ \DeclareUnicodeCharacter{03C9}{\ensuremath\omega}
+ %
+ % More Greek vowels with accents
+ \DeclareUnicodeCharacter{03CA}{\ensuremath{\ddot\iota}}
+ \DeclareUnicodeCharacter{03CB}{\ensuremath{\ddot\upsilon}}
+ \DeclareUnicodeCharacter{03CC}{\ensuremath{\acute o}}
+ \DeclareUnicodeCharacter{03CD}{\ensuremath{\acute\upsilon}}
+ \DeclareUnicodeCharacter{03CE}{\ensuremath{\acute\omega}}
+ %
+ % Variant Greek letters
+ \DeclareUnicodeCharacter{03D1}{\ensuremath\vartheta}
+ \DeclareUnicodeCharacter{03D6}{\ensuremath\varpi}
+ \DeclareUnicodeCharacter{03F1}{\ensuremath\varrho}
+ %
+ \DeclareUnicodeCharacter{1E02}{\dotaccent{B}}
+ \DeclareUnicodeCharacter{1E03}{\dotaccent{b}}
+ \DeclareUnicodeCharacter{1E04}{\udotaccent{B}}
+ \DeclareUnicodeCharacter{1E05}{\udotaccent{b}}
+ \DeclareUnicodeCharacter{1E06}{\ubaraccent{B}}
+ \DeclareUnicodeCharacter{1E07}{\ubaraccent{b}}
+ \DeclareUnicodeCharacter{1E0A}{\dotaccent{D}}
+ \DeclareUnicodeCharacter{1E0B}{\dotaccent{d}}
+ \DeclareUnicodeCharacter{1E0C}{\udotaccent{D}}
+ \DeclareUnicodeCharacter{1E0D}{\udotaccent{d}}
+ \DeclareUnicodeCharacter{1E0E}{\ubaraccent{D}}
+ \DeclareUnicodeCharacter{1E0F}{\ubaraccent{d}}
+ %
+ \DeclareUnicodeCharacter{1E1E}{\dotaccent{F}}
+ \DeclareUnicodeCharacter{1E1F}{\dotaccent{f}}
+ %
+ \DeclareUnicodeCharacter{1E20}{\=G}
+ \DeclareUnicodeCharacter{1E21}{\=g}
+ \DeclareUnicodeCharacter{1E22}{\dotaccent{H}}
+ \DeclareUnicodeCharacter{1E23}{\dotaccent{h}}
+ \DeclareUnicodeCharacter{1E24}{\udotaccent{H}}
+ \DeclareUnicodeCharacter{1E25}{\udotaccent{h}}
+ \DeclareUnicodeCharacter{1E26}{\"H}
+ \DeclareUnicodeCharacter{1E27}{\"h}
+ %
+ \DeclareUnicodeCharacter{1E30}{\'K}
+ \DeclareUnicodeCharacter{1E31}{\'k}
+ \DeclareUnicodeCharacter{1E32}{\udotaccent{K}}
+ \DeclareUnicodeCharacter{1E33}{\udotaccent{k}}
+ \DeclareUnicodeCharacter{1E34}{\ubaraccent{K}}
+ \DeclareUnicodeCharacter{1E35}{\ubaraccent{k}}
+ \DeclareUnicodeCharacter{1E36}{\udotaccent{L}}
+ \DeclareUnicodeCharacter{1E37}{\udotaccent{l}}
+ \DeclareUnicodeCharacter{1E3A}{\ubaraccent{L}}
+ \DeclareUnicodeCharacter{1E3B}{\ubaraccent{l}}
+ \DeclareUnicodeCharacter{1E3E}{\'M}
+ \DeclareUnicodeCharacter{1E3F}{\'m}
+ %
+ \DeclareUnicodeCharacter{1E40}{\dotaccent{M}}
+ \DeclareUnicodeCharacter{1E41}{\dotaccent{m}}
+ \DeclareUnicodeCharacter{1E42}{\udotaccent{M}}
+ \DeclareUnicodeCharacter{1E43}{\udotaccent{m}}
+ \DeclareUnicodeCharacter{1E44}{\dotaccent{N}}
+ \DeclareUnicodeCharacter{1E45}{\dotaccent{n}}
+ \DeclareUnicodeCharacter{1E46}{\udotaccent{N}}
+ \DeclareUnicodeCharacter{1E47}{\udotaccent{n}}
+ \DeclareUnicodeCharacter{1E48}{\ubaraccent{N}}
+ \DeclareUnicodeCharacter{1E49}{\ubaraccent{n}}
+ %
+ \DeclareUnicodeCharacter{1E54}{\'P}
+ \DeclareUnicodeCharacter{1E55}{\'p}
+ \DeclareUnicodeCharacter{1E56}{\dotaccent{P}}
+ \DeclareUnicodeCharacter{1E57}{\dotaccent{p}}
+ \DeclareUnicodeCharacter{1E58}{\dotaccent{R}}
+ \DeclareUnicodeCharacter{1E59}{\dotaccent{r}}
+ \DeclareUnicodeCharacter{1E5A}{\udotaccent{R}}
+ \DeclareUnicodeCharacter{1E5B}{\udotaccent{r}}
+ \DeclareUnicodeCharacter{1E5E}{\ubaraccent{R}}
+ \DeclareUnicodeCharacter{1E5F}{\ubaraccent{r}}
+ %
+ \DeclareUnicodeCharacter{1E60}{\dotaccent{S}}
+ \DeclareUnicodeCharacter{1E61}{\dotaccent{s}}
+ \DeclareUnicodeCharacter{1E62}{\udotaccent{S}}
+ \DeclareUnicodeCharacter{1E63}{\udotaccent{s}}
+ \DeclareUnicodeCharacter{1E6A}{\dotaccent{T}}
+ \DeclareUnicodeCharacter{1E6B}{\dotaccent{t}}
+ \DeclareUnicodeCharacter{1E6C}{\udotaccent{T}}
+ \DeclareUnicodeCharacter{1E6D}{\udotaccent{t}}
+ \DeclareUnicodeCharacter{1E6E}{\ubaraccent{T}}
+ \DeclareUnicodeCharacter{1E6F}{\ubaraccent{t}}
+ %
+ \DeclareUnicodeCharacter{1E7C}{\~V}
+ \DeclareUnicodeCharacter{1E7D}{\~v}
+ \DeclareUnicodeCharacter{1E7E}{\udotaccent{V}}
+ \DeclareUnicodeCharacter{1E7F}{\udotaccent{v}}
+ %
+ \DeclareUnicodeCharacter{1E80}{\`W}
+ \DeclareUnicodeCharacter{1E81}{\`w}
+ \DeclareUnicodeCharacter{1E82}{\'W}
+ \DeclareUnicodeCharacter{1E83}{\'w}
+ \DeclareUnicodeCharacter{1E84}{\"W}
+ \DeclareUnicodeCharacter{1E85}{\"w}
+ \DeclareUnicodeCharacter{1E86}{\dotaccent{W}}
+ \DeclareUnicodeCharacter{1E87}{\dotaccent{w}}
+ \DeclareUnicodeCharacter{1E88}{\udotaccent{W}}
+ \DeclareUnicodeCharacter{1E89}{\udotaccent{w}}
+ \DeclareUnicodeCharacter{1E8A}{\dotaccent{X}}
+ \DeclareUnicodeCharacter{1E8B}{\dotaccent{x}}
+ \DeclareUnicodeCharacter{1E8C}{\"X}
+ \DeclareUnicodeCharacter{1E8D}{\"x}
+ \DeclareUnicodeCharacter{1E8E}{\dotaccent{Y}}
+ \DeclareUnicodeCharacter{1E8F}{\dotaccent{y}}
+ %
+ \DeclareUnicodeCharacter{1E90}{\^Z}
+ \DeclareUnicodeCharacter{1E91}{\^z}
+ \DeclareUnicodeCharacter{1E92}{\udotaccent{Z}}
+ \DeclareUnicodeCharacter{1E93}{\udotaccent{z}}
+ \DeclareUnicodeCharacter{1E94}{\ubaraccent{Z}}
+ \DeclareUnicodeCharacter{1E95}{\ubaraccent{z}}
+ \DeclareUnicodeCharacter{1E96}{\ubaraccent{h}}
+ \DeclareUnicodeCharacter{1E97}{\"t}
+ \DeclareUnicodeCharacter{1E98}{\ringaccent{w}}
+ \DeclareUnicodeCharacter{1E99}{\ringaccent{y}}
+ %
+ \DeclareUnicodeCharacter{1EA0}{\udotaccent{A}}
+ \DeclareUnicodeCharacter{1EA1}{\udotaccent{a}}
+ %
+ \DeclareUnicodeCharacter{1EB8}{\udotaccent{E}}
+ \DeclareUnicodeCharacter{1EB9}{\udotaccent{e}}
+ \DeclareUnicodeCharacter{1EBC}{\~E}
+ \DeclareUnicodeCharacter{1EBD}{\~e}
+ %
+ \DeclareUnicodeCharacter{1ECA}{\udotaccent{I}}
+ \DeclareUnicodeCharacter{1ECB}{\udotaccent{i}}
+ \DeclareUnicodeCharacter{1ECC}{\udotaccent{O}}
+ \DeclareUnicodeCharacter{1ECD}{\udotaccent{o}}
+ %
+ \DeclareUnicodeCharacter{1EE4}{\udotaccent{U}}
+ \DeclareUnicodeCharacter{1EE5}{\udotaccent{u}}
+ %
+ \DeclareUnicodeCharacter{1EF2}{\`Y}
+ \DeclareUnicodeCharacter{1EF3}{\`y}
+ \DeclareUnicodeCharacter{1EF4}{\udotaccent{Y}}
+ %
+ \DeclareUnicodeCharacter{1EF8}{\~Y}
+ \DeclareUnicodeCharacter{1EF9}{\~y}
+ %
+ % Punctuation
+ \DeclareUnicodeCharacter{2013}{--}
+ \DeclareUnicodeCharacter{2014}{---}
+ \DeclareUnicodeCharacter{2018}{\quoteleft}
+ \DeclareUnicodeCharacter{2019}{\quoteright}
+ \DeclareUnicodeCharacter{201A}{\quotesinglbase}
+ \DeclareUnicodeCharacter{201C}{\quotedblleft}
+ \DeclareUnicodeCharacter{201D}{\quotedblright}
+ \DeclareUnicodeCharacter{201E}{\quotedblbase}
+ \DeclareUnicodeCharacter{2020}{\ensuremath\dagger}
+ \DeclareUnicodeCharacter{2021}{\ensuremath\ddagger}
+ \DeclareUnicodeCharacter{2022}{\bullet}
+ \DeclareUnicodeCharacter{202F}{\thinspace}
+ \DeclareUnicodeCharacter{2026}{\dots}
+ \DeclareUnicodeCharacter{2039}{\guilsinglleft}
+ \DeclareUnicodeCharacter{203A}{\guilsinglright}
+ %
+ \DeclareUnicodeCharacter{20AC}{\euro}
+ %
+ \DeclareUnicodeCharacter{2192}{\expansion}
+ \DeclareUnicodeCharacter{21D2}{\result}
+ %
+ % Mathematical symbols
+ \DeclareUnicodeCharacter{2200}{\ensuremath\forall}
+ \DeclareUnicodeCharacter{2203}{\ensuremath\exists}
+ \DeclareUnicodeCharacter{2208}{\ensuremath\in}
+ \DeclareUnicodeCharacter{2212}{\minus}
+ \DeclareUnicodeCharacter{2217}{\ast}
+ \DeclareUnicodeCharacter{221E}{\ensuremath\infty}
+ \DeclareUnicodeCharacter{2225}{\ensuremath\parallel}
+ \DeclareUnicodeCharacter{2227}{\ensuremath\wedge}
+ \DeclareUnicodeCharacter{2229}{\ensuremath\cap}
+ \DeclareUnicodeCharacter{2261}{\equiv}
+ \DeclareUnicodeCharacter{2264}{\ensuremath\leq}
+ \DeclareUnicodeCharacter{2265}{\ensuremath\geq}
+ \DeclareUnicodeCharacter{2282}{\ensuremath\subset}
+ \DeclareUnicodeCharacter{2287}{\ensuremath\supseteq}
+ %
+ \DeclareUnicodeCharacter{2016}{\ensuremath\Vert}
+ \DeclareUnicodeCharacter{2032}{\ensuremath\prime}
+ \DeclareUnicodeCharacter{210F}{\ensuremath\hbar}
+ \DeclareUnicodeCharacter{2111}{\ensuremath\Im}
+ \DeclareUnicodeCharacter{2113}{\ensuremath\ell}
+ \DeclareUnicodeCharacter{2118}{\ensuremath\wp}
+ \DeclareUnicodeCharacter{211C}{\ensuremath\Re}
+ \DeclareUnicodeCharacter{2127}{\ensuremath\mho}
+ \DeclareUnicodeCharacter{2135}{\ensuremath\aleph}
+ \DeclareUnicodeCharacter{2190}{\ensuremath\leftarrow}
+ \DeclareUnicodeCharacter{2191}{\ensuremath\uparrow}
+ \DeclareUnicodeCharacter{2193}{\ensuremath\downarrow}
+ \DeclareUnicodeCharacter{2194}{\ensuremath\leftrightarrow}
+ \DeclareUnicodeCharacter{2195}{\ensuremath\updownarrow}
+ \DeclareUnicodeCharacter{2196}{\ensuremath\nwarrow}
+ \DeclareUnicodeCharacter{2197}{\ensuremath\nearrow}
+ \DeclareUnicodeCharacter{2198}{\ensuremath\searrow}
+ \DeclareUnicodeCharacter{2199}{\ensuremath\swarrow}
+ \DeclareUnicodeCharacter{21A6}{\ensuremath\mapsto}
+ \DeclareUnicodeCharacter{21A9}{\ensuremath\hookleftarrow}
+ \DeclareUnicodeCharacter{21AA}{\ensuremath\hookrightarrow}
+ \DeclareUnicodeCharacter{21BC}{\ensuremath\leftharpoonup}
+ \DeclareUnicodeCharacter{21BD}{\ensuremath\leftharpoondown}
+ \DeclareUnicodeCharacter{21BE}{\ensuremath\upharpoonright}
+ \DeclareUnicodeCharacter{21C0}{\ensuremath\rightharpoonup}
+ \DeclareUnicodeCharacter{21C1}{\ensuremath\rightharpoondown}
+ \DeclareUnicodeCharacter{21CC}{\ensuremath\rightleftharpoons}
+ \DeclareUnicodeCharacter{21D0}{\ensuremath\Leftarrow}
+ \DeclareUnicodeCharacter{21D1}{\ensuremath\Uparrow}
+ \DeclareUnicodeCharacter{21D3}{\ensuremath\Downarrow}
+ \DeclareUnicodeCharacter{21D4}{\ensuremath\Leftrightarrow}
+ \DeclareUnicodeCharacter{21D5}{\ensuremath\Updownarrow}
+ \DeclareUnicodeCharacter{21DD}{\ensuremath\leadsto}
+ \DeclareUnicodeCharacter{2201}{\ensuremath\complement}
+ \DeclareUnicodeCharacter{2202}{\ensuremath\partial}
+ \DeclareUnicodeCharacter{2205}{\ensuremath\emptyset}
+ \DeclareUnicodeCharacter{2207}{\ensuremath\nabla}
+ \DeclareUnicodeCharacter{2209}{\ensuremath\notin}
+ \DeclareUnicodeCharacter{220B}{\ensuremath\owns}
+ \DeclareUnicodeCharacter{220F}{\ensuremath\prod}
+ \DeclareUnicodeCharacter{2210}{\ensuremath\coprod}
+ \DeclareUnicodeCharacter{2211}{\ensuremath\sum}
+ \DeclareUnicodeCharacter{2213}{\ensuremath\mp}
+ \DeclareUnicodeCharacter{2218}{\ensuremath\circ}
+ \DeclareUnicodeCharacter{221A}{\ensuremath\surd}
+ \DeclareUnicodeCharacter{221D}{\ensuremath\propto}
+ \DeclareUnicodeCharacter{2220}{\ensuremath\angle}
+ \DeclareUnicodeCharacter{2223}{\ensuremath\mid}
+ \DeclareUnicodeCharacter{2228}{\ensuremath\vee}
+ \DeclareUnicodeCharacter{222A}{\ensuremath\cup}
+ \DeclareUnicodeCharacter{222B}{\ensuremath\smallint}
+ \DeclareUnicodeCharacter{222E}{\ensuremath\oint}
+ \DeclareUnicodeCharacter{223C}{\ensuremath\sim}
+ \DeclareUnicodeCharacter{2240}{\ensuremath\wr}
+ \DeclareUnicodeCharacter{2243}{\ensuremath\simeq}
+ \DeclareUnicodeCharacter{2245}{\ensuremath\cong}
+ \DeclareUnicodeCharacter{2248}{\ensuremath\approx}
+ \DeclareUnicodeCharacter{224D}{\ensuremath\asymp}
+ \DeclareUnicodeCharacter{2250}{\ensuremath\doteq}
+ \DeclareUnicodeCharacter{2260}{\ensuremath\neq}
+ \DeclareUnicodeCharacter{226A}{\ensuremath\ll}
+ \DeclareUnicodeCharacter{226B}{\ensuremath\gg}
+ \DeclareUnicodeCharacter{227A}{\ensuremath\prec}
+ \DeclareUnicodeCharacter{227B}{\ensuremath\succ}
+ \DeclareUnicodeCharacter{2283}{\ensuremath\supset}
+ \DeclareUnicodeCharacter{2286}{\ensuremath\subseteq}
+ \DeclareUnicodeCharacter{228E}{\ensuremath\uplus}
+ \DeclareUnicodeCharacter{228F}{\ensuremath\sqsubset}
+ \DeclareUnicodeCharacter{2290}{\ensuremath\sqsupset}
+ \DeclareUnicodeCharacter{2291}{\ensuremath\sqsubseteq}
+ \DeclareUnicodeCharacter{2292}{\ensuremath\sqsupseteq}
+ \DeclareUnicodeCharacter{2293}{\ensuremath\sqcap}
+ \DeclareUnicodeCharacter{2294}{\ensuremath\sqcup}
+ \DeclareUnicodeCharacter{2295}{\ensuremath\oplus}
+ \DeclareUnicodeCharacter{2296}{\ensuremath\ominus}
+ \DeclareUnicodeCharacter{2297}{\ensuremath\otimes}
+ \DeclareUnicodeCharacter{2298}{\ensuremath\oslash}
+ \DeclareUnicodeCharacter{2299}{\ensuremath\odot}
+ \DeclareUnicodeCharacter{22A2}{\ensuremath\vdash}
+ \DeclareUnicodeCharacter{22A3}{\ensuremath\dashv}
+ \DeclareUnicodeCharacter{22A4}{\ensuremath\ptextop}
+ \DeclareUnicodeCharacter{22A5}{\ensuremath\bot}
+ \DeclareUnicodeCharacter{22A8}{\ensuremath\models}
+ \DeclareUnicodeCharacter{22B4}{\ensuremath\unlhd}
+ \DeclareUnicodeCharacter{22B5}{\ensuremath\unrhd}
+ \DeclareUnicodeCharacter{22C0}{\ensuremath\bigwedge}
+ \DeclareUnicodeCharacter{22C1}{\ensuremath\bigvee}
+ \DeclareUnicodeCharacter{22C2}{\ensuremath\bigcap}
+ \DeclareUnicodeCharacter{22C3}{\ensuremath\bigcup}
+ \DeclareUnicodeCharacter{22C4}{\ensuremath\diamond}
+ \DeclareUnicodeCharacter{22C5}{\ensuremath\cdot}
+ \DeclareUnicodeCharacter{22C6}{\ensuremath\star}
+ \DeclareUnicodeCharacter{22C8}{\ensuremath\bowtie}
+ \DeclareUnicodeCharacter{2308}{\ensuremath\lceil}
+ \DeclareUnicodeCharacter{2309}{\ensuremath\rceil}
+ \DeclareUnicodeCharacter{230A}{\ensuremath\lfloor}
+ \DeclareUnicodeCharacter{230B}{\ensuremath\rfloor}
+ \DeclareUnicodeCharacter{2322}{\ensuremath\frown}
+ \DeclareUnicodeCharacter{2323}{\ensuremath\smile}
+ %
+ \DeclareUnicodeCharacter{25A1}{\ensuremath\Box}
+ \DeclareUnicodeCharacter{25B3}{\ensuremath\triangle}
+ \DeclareUnicodeCharacter{25B7}{\ensuremath\triangleright}
+ \DeclareUnicodeCharacter{25BD}{\ensuremath\bigtriangledown}
+ \DeclareUnicodeCharacter{25C1}{\ensuremath\triangleleft}
+ \DeclareUnicodeCharacter{25C7}{\ensuremath\Diamond}
+ \DeclareUnicodeCharacter{2660}{\ensuremath\spadesuit}
+ \DeclareUnicodeCharacter{2661}{\ensuremath\heartsuit}
+ \DeclareUnicodeCharacter{2662}{\ensuremath\diamondsuit}
+ \DeclareUnicodeCharacter{2663}{\ensuremath\clubsuit}
+ \DeclareUnicodeCharacter{266D}{\ensuremath\flat}
+ \DeclareUnicodeCharacter{266E}{\ensuremath\natural}
+ \DeclareUnicodeCharacter{266F}{\ensuremath\sharp}
+ \DeclareUnicodeCharacter{26AA}{\ensuremath\bigcirc}
+ \DeclareUnicodeCharacter{27B9}{\ensuremath\rangle}
+ \DeclareUnicodeCharacter{27C2}{\ensuremath\perp}
+ \DeclareUnicodeCharacter{27E8}{\ensuremath\langle}
+ \DeclareUnicodeCharacter{27F5}{\ensuremath\longleftarrow}
+ \DeclareUnicodeCharacter{27F6}{\ensuremath\longrightarrow}
+ \DeclareUnicodeCharacter{27F7}{\ensuremath\longleftrightarrow}
+ \DeclareUnicodeCharacter{27FC}{\ensuremath\longmapsto}
+ \DeclareUnicodeCharacter{29F5}{\ensuremath\setminus}
+ \DeclareUnicodeCharacter{2A00}{\ensuremath\bigodot}
+ \DeclareUnicodeCharacter{2A01}{\ensuremath\bigoplus}
+ \DeclareUnicodeCharacter{2A02}{\ensuremath\bigotimes}
+ \DeclareUnicodeCharacter{2A04}{\ensuremath\biguplus}
+ \DeclareUnicodeCharacter{2A06}{\ensuremath\bigsqcup}
+ \DeclareUnicodeCharacter{2A1D}{\ensuremath\Join}
+ \DeclareUnicodeCharacter{2A3F}{\ensuremath\amalg}
+ \DeclareUnicodeCharacter{2AAF}{\ensuremath\preceq}
+ \DeclareUnicodeCharacter{2AB0}{\ensuremath\succeq}
+ %
+ \global\mathchardef\checkmark="1370 % actually the square root sign
+ \DeclareUnicodeCharacter{2713}{\ensuremath\checkmark}
+}% end of \utfeightchardefs
+
+% US-ASCII character definitions.
+\def\asciichardefs{% nothing need be done
+ \relax
+}
+
+% Latin1 (ISO-8859-1) character definitions.
+\def\nonasciistringdefs{%
+ \setnonasciicharscatcode\active
+ \def\defstringchar##1{\def##1{\string##1}}%
+ %
+ \defstringchar^^80\defstringchar^^81\defstringchar^^82\defstringchar^^83%
+ \defstringchar^^84\defstringchar^^85\defstringchar^^86\defstringchar^^87%
+ \defstringchar^^88\defstringchar^^89\defstringchar^^8a\defstringchar^^8b%
+ \defstringchar^^8c\defstringchar^^8d\defstringchar^^8e\defstringchar^^8f%
+ %
+ \defstringchar^^90\defstringchar^^91\defstringchar^^92\defstringchar^^93%
+ \defstringchar^^94\defstringchar^^95\defstringchar^^96\defstringchar^^97%
+ \defstringchar^^98\defstringchar^^99\defstringchar^^9a\defstringchar^^9b%
+ \defstringchar^^9c\defstringchar^^9d\defstringchar^^9e\defstringchar^^9f%
+ %
+ \defstringchar^^a0\defstringchar^^a1\defstringchar^^a2\defstringchar^^a3%
+ \defstringchar^^a4\defstringchar^^a5\defstringchar^^a6\defstringchar^^a7%
+ \defstringchar^^a8\defstringchar^^a9\defstringchar^^aa\defstringchar^^ab%
+ \defstringchar^^ac\defstringchar^^ad\defstringchar^^ae\defstringchar^^af%
+ %
+ \defstringchar^^b0\defstringchar^^b1\defstringchar^^b2\defstringchar^^b3%
+ \defstringchar^^b4\defstringchar^^b5\defstringchar^^b6\defstringchar^^b7%
+ \defstringchar^^b8\defstringchar^^b9\defstringchar^^ba\defstringchar^^bb%
+ \defstringchar^^bc\defstringchar^^bd\defstringchar^^be\defstringchar^^bf%
+ %
+ \defstringchar^^c0\defstringchar^^c1\defstringchar^^c2\defstringchar^^c3%
+ \defstringchar^^c4\defstringchar^^c5\defstringchar^^c6\defstringchar^^c7%
+ \defstringchar^^c8\defstringchar^^c9\defstringchar^^ca\defstringchar^^cb%
+ \defstringchar^^cc\defstringchar^^cd\defstringchar^^ce\defstringchar^^cf%
+ %
+ \defstringchar^^d0\defstringchar^^d1\defstringchar^^d2\defstringchar^^d3%
+ \defstringchar^^d4\defstringchar^^d5\defstringchar^^d6\defstringchar^^d7%
+ \defstringchar^^d8\defstringchar^^d9\defstringchar^^da\defstringchar^^db%
+ \defstringchar^^dc\defstringchar^^dd\defstringchar^^de\defstringchar^^df%
+ %
+ \defstringchar^^e0\defstringchar^^e1\defstringchar^^e2\defstringchar^^e3%
+ \defstringchar^^e4\defstringchar^^e5\defstringchar^^e6\defstringchar^^e7%
+ \defstringchar^^e8\defstringchar^^e9\defstringchar^^ea\defstringchar^^eb%
+ \defstringchar^^ec\defstringchar^^ed\defstringchar^^ee\defstringchar^^ef%
+ %
+ \defstringchar^^f0\defstringchar^^f1\defstringchar^^f2\defstringchar^^f3%
+ \defstringchar^^f4\defstringchar^^f5\defstringchar^^f6\defstringchar^^f7%
+ \defstringchar^^f8\defstringchar^^f9\defstringchar^^fa\defstringchar^^fb%
+ \defstringchar^^fc\defstringchar^^fd\defstringchar^^fe\defstringchar^^ff%
+}
+
+
+% define all the unicode characters we know about, for the sake of @U.
+\utfeightchardefs
+
+
+% Make non-ASCII characters printable again for compatibility with
+% existing Texinfo documents that may use them, even without declaring a
+% document encoding.
+%
+\setnonasciicharscatcode \other
+
+
+\message{formatting,}
+
+\newdimen\defaultparindent \defaultparindent = 15pt
+
+\chapheadingskip = 15pt plus 4pt minus 2pt
+\secheadingskip = 12pt plus 3pt minus 2pt
+\subsecheadingskip = 9pt plus 2pt minus 2pt
+
+% Prevent underfull vbox error messages.
+\vbadness = 10000
+
+% Don't be very finicky about underfull hboxes, either.
+\hbadness = 6666
+
+% Following George Bush, get rid of widows and orphans.
+\widowpenalty=10000
+\clubpenalty=10000
+
+% Use TeX 3.0's \emergencystretch to help line breaking, but if we're
+% using an old version of TeX, don't do anything. We want the amount of
+% stretch added to depend on the line length, hence the dependence on
+% \hsize. We call this whenever the paper size is set.
+%
+\def\setemergencystretch{%
+ \ifx\emergencystretch\thisisundefined
+ % Allow us to assign to \emergencystretch anyway.
+ \def\emergencystretch{\dimen0}%
+ \else
+ \emergencystretch = .15\hsize
+ \fi
+}
+
+% Parameters in order: 1) textheight; 2) textwidth;
+% 3) voffset; 4) hoffset; 5) binding offset; 6) topskip;
+% 7) physical page height; 8) physical page width.
+%
+% We also call \setleading{\textleading}, so the caller should define
+% \textleading. The caller should also set \parskip.
+%
+\def\internalpagesizes#1#2#3#4#5#6#7#8{%
+ \voffset = #3\relax
+ \topskip = #6\relax
+ \splittopskip = \topskip
+ %
+ \vsize = #1\relax
+ \advance\vsize by \topskip
+ \outervsize = \vsize
+ \advance\outervsize by 2\topandbottommargin
+ \pageheight = \vsize
+ %
+ \hsize = #2\relax
+ \outerhsize = \hsize
+ \advance\outerhsize by 0.5in
+ \pagewidth = \hsize
+ %
+ \normaloffset = #4\relax
+ \bindingoffset = #5\relax
+ %
+ \ifpdf
+ \pdfpageheight #7\relax
+ \pdfpagewidth #8\relax
+ % if we don't reset these, they will remain at "1 true in" of
+ % whatever layout pdftex was dumped with.
+ \pdfhorigin = 1 true in
+ \pdfvorigin = 1 true in
+ \fi
+ %
+ \setleading{\textleading}
+ %
+ \parindent = \defaultparindent
+ \setemergencystretch
+}
+
+% @letterpaper (the default).
+\def\letterpaper{{\globaldefs = 1
+ \parskip = 3pt plus 2pt minus 1pt
+ \textleading = 13.2pt
+ %
+ % If page is nothing but text, make it come out even.
+ \internalpagesizes{607.2pt}{6in}% that's 46 lines
+ {\voffset}{.25in}%
+ {\bindingoffset}{36pt}%
+ {11in}{8.5in}%
+}}
+
+% Use @smallbook to reset parameters for 7x9.25 trim size.
+\def\smallbook{{\globaldefs = 1
+ \parskip = 2pt plus 1pt
+ \textleading = 12pt
+ %
+ \internalpagesizes{7.5in}{5in}%
+ {-.2in}{0in}%
+ {\bindingoffset}{16pt}%
+ {9.25in}{7in}%
+ %
+ \lispnarrowing = 0.3in
+ \tolerance = 700
+ \hfuzz = 1pt
+ \contentsrightmargin = 0pt
+ \defbodyindent = .5cm
+}}
+
+% Use @smallerbook to reset parameters for 6x9 trim size.
+% (Just testing, parameters still in flux.)
+\def\smallerbook{{\globaldefs = 1
+ \parskip = 1.5pt plus 1pt
+ \textleading = 12pt
+ %
+ \internalpagesizes{7.4in}{4.8in}%
+ {-.2in}{-.4in}%
+ {0pt}{14pt}%
+ {9in}{6in}%
+ %
+ \lispnarrowing = 0.25in
+ \tolerance = 700
+ \hfuzz = 1pt
+ \contentsrightmargin = 0pt
+ \defbodyindent = .4cm
+}}
+
+% Use @afourpaper to print on European A4 paper.
+\def\afourpaper{{\globaldefs = 1
+ \parskip = 3pt plus 2pt minus 1pt
+ \textleading = 13.2pt
+ %
+ % Double-side printing via postscript on Laserjet 4050
+ % prints double-sided nicely when \bindingoffset=10mm and \hoffset=-6mm.
+ % To change the settings for a different printer or situation, adjust
+ % \normaloffset until the front-side and back-side texts align. Then
+ % do the same for \bindingoffset. You can set these for testing in
+ % your texinfo source file like this:
+ % @tex
+ % \global\normaloffset = -6mm
+ % \global\bindingoffset = 10mm
+ % @end tex
+ \internalpagesizes{673.2pt}{160mm}% that's 51 lines
+ {\voffset}{\hoffset}%
+ {\bindingoffset}{44pt}%
+ {297mm}{210mm}%
+ %
+ \tolerance = 700
+ \hfuzz = 1pt
+ \contentsrightmargin = 0pt
+ \defbodyindent = 5mm
+}}
+
+% Use @afivepaper to print on European A5 paper.
+% From address@hidden, 2 July 2000.
+% He also recommends making @example and @lisp be small.
+\def\afivepaper{{\globaldefs = 1
+ \parskip = 2pt plus 1pt minus 0.1pt
+ \textleading = 12.5pt
+ %
+ \internalpagesizes{160mm}{120mm}%
+ {\voffset}{\hoffset}%
+ {\bindingoffset}{8pt}%
+ {210mm}{148mm}%
+ %
+ \lispnarrowing = 0.2in
+ \tolerance = 800
+ \hfuzz = 1.2pt
+ \contentsrightmargin = 0pt
+ \defbodyindent = 2mm
+ \tableindent = 12mm
+}}
+
+% A specific text layout, 24x15cm overall, intended for A4 paper.
+\def\afourlatex{{\globaldefs = 1
+ \afourpaper
+ \internalpagesizes{237mm}{150mm}%
+ {\voffset}{4.6mm}%
+ {\bindingoffset}{7mm}%
+ {297mm}{210mm}%
+ %
+ % Must explicitly reset to 0 because we call \afourpaper.
+ \globaldefs = 0
+}}
+
+ % Aggiunto formato 17x24, comunemente usato per i testi scientifici.
+\def\manuale{{\globaldefs = 1
+ \parskip = 2pt plus 1pt minus 0.1pt
+ \textleading = 12.0pt
+ %
+ \internalpagesizes{190mm}{120mm}%
+ {\voffset}{0mm}%
+ {\hoffset}{0mm}%
+ {\bindingoffset}{4.6mm}%
+ {240mm}{170mm}%
+ %
+ \lispnarrowing = 0.2in
+ \tolerance = 800
+ \hfuzz = 1.2pt
+ \contentsrightmargin = 0pt
+ \defbodyindent = 2mm
+ \tableindent = 12mm
+}}
+
+% Use @afourwide to print on A4 paper in landscape format.
+\def\afourwide{{\globaldefs = 1
+ \afourpaper
+ \internalpagesizes{241mm}{165mm}%
+ {\voffset}{-2.95mm}%
+ {\bindingoffset}{7mm}%
+ {297mm}{210mm}%
+ \globaldefs = 0
+}}
+
+% @pagesizes TEXTHEIGHT[,TEXTWIDTH]
+% Perhaps we should allow setting the margins, \topskip, \parskip,
+% and/or leading, also. Or perhaps we should compute them somehow.
+%
+\parseargdef\pagesizes{\pagesizesyyy #1,,\finish}
+\def\pagesizesyyy#1,#2,#3\finish{{%
+ \setbox0 = \hbox{\ignorespaces #2}\ifdim\wd0 > 0pt \hsize=#2\relax \fi
+ \globaldefs = 1
+ %
+ \parskip = 3pt plus 2pt minus 1pt
+ \setleading{\textleading}%
+ %
+ \dimen0 = #1\relax
+ \advance\dimen0 by \voffset
+ %
+ \dimen2 = \hsize
+ \advance\dimen2 by \normaloffset
+ %
+ \internalpagesizes{#1}{\hsize}%
+ {\voffset}{\normaloffset}%
+ {\bindingoffset}{44pt}%
+ {\dimen0}{\dimen2}%
+}}
+
+% Set default to letter.
+%
+\letterpaper
+
+
+\message{and turning on texinfo input format.}
+
+\def^^L{\par} % remove \outer, so ^L can appear in an @comment
+
+% DEL is a comment character, in case @c does not suffice.
+\catcode`\^^? = 14
+
+% Define macros to output various characters with catcode for normal text.
+\catcode`\"=\other \def\normaldoublequote{"}
+\catcode`\$=\other \def\normaldollar{$}%$ font-lock fix
+\catcode`\+=\other \def\normalplus{+}
+\catcode`\<=\other \def\normalless{<}
+\catcode`\>=\other \def\normalgreater{>}
+\catcode`\^=\other \def\normalcaret{^}
+\catcode`\_=\other \def\normalunderscore{_}
+\catcode`\|=\other \def\normalverticalbar{|}
+\catcode`\~=\other \def\normaltilde{~}
+
+% This macro is used to make a character print one way in \tt
+% (where it can probably be output as-is), and another way in other fonts,
+% where something hairier probably needs to be done.
+%
+% #1 is what to print if we are indeed using \tt; #2 is what to print
+% otherwise. Since all the Computer Modern typewriter fonts have zero
+% interword stretch (and shrink), and it is reasonable to expect all
+% typewriter fonts to have this, we can check that font parameter.
+%
+\def\ifusingtt#1#2{\ifdim \fontdimen3\font=0pt #1\else #2\fi}
+
+% Same as above, but check for italic font. Actually this also catches
+% non-italic slanted fonts since it is impossible to distinguish them from
+% italic fonts. But since this is only used by $ and it uses \sl anyway
+% this is not a problem.
+\def\ifusingit#1#2{\ifdim \fontdimen1\font>0pt #1\else #2\fi}
+
+% Set catcodes for Texinfo file
+
+% Active characters for printing the wanted glyph.
+% Most of these we simply print from the \tt font, but for some, we can
+% use math or other variants that look better in normal text.
+%
+\catcode`\"=\active
+\def\activedoublequote{{\tt\char34}}
+\let"=\activedoublequote
+\catcode`\~=\active \def\activetilde{{\tt\char126}} \let~ = \activetilde
+\chardef\hatchar=`\^
+\catcode`\^=\active \def\activehat{{\tt \hatchar}} \let^ = \activehat
+
+\catcode`\_=\active
+\def_{\ifusingtt\normalunderscore\_}
+\def\_{\leavevmode \kern.07em \vbox{\hrule width.3em height.1ex}\kern .07em }
+\let\realunder=_
+
+\catcode`\|=\active \def|{{\tt\char124}}
+
+\chardef \less=`\<
+\catcode`\<=\active \def\activeless{{\tt \less}}\let< = \activeless
+\chardef \gtr=`\>
+\catcode`\>=\active \def\activegtr{{\tt \gtr}}\let> = \activegtr
+\catcode`\+=\active \def+{{\tt \char 43}}
+\catcode`\$=\active \def${\ifusingit{{\sl\$}}\normaldollar}%$ font-lock fix
+\catcode`\-=\active \let-=\normaldash
+
+
+% used for headline/footline in the output routine, in case the page
+% breaks in the middle of an @tex block.
+\def\texinfochars{%
+ \let< = \activeless
+ \let> = \activegtr
+ \let~ = \activetilde
+ \let^ = \activehat
+ \markupsetuplqdefault \markupsetuprqdefault
+ \let\b = \strong
+ \let\i = \smartitalic
+ % in principle, all other definitions in \tex have to be undone too.
+}
+
+% Used sometimes to turn off (effectively) the active characters even after
+% parsing them.
+\def\turnoffactive{%
+ \normalturnoffactive
+ \otherbackslash
+}
+
address@hidden
+
+% \backslashcurfont outputs one backslash character in current font,
+% as in \char`\\.
+\global\chardef\backslashcurfont=`\\
+\global\let\rawbackslashxx=\backslashcurfont % let existing .??s files work
+
+% \realbackslash is an actual character `\' with catcode other, and
+% \doublebackslash is two of them (for the pdf outlines).
+{\catcode`\\=\other @address@hidden @address@hidden
+
+% In Texinfo, backslash is an active character; it prints the backslash
+% in fixed width font.
+\catcode`\\=\active % @ for escape char from now on.
+
+% Print a typewriter backslash. For math mode, we can't simply use
+% \backslashcurfont: the story here is that in math mode, the \char
+% of \backslashcurfont ends up printing the roman \ from the math symbol
+% font (because \char in math mode uses the \mathcode, and plain.tex
+% sets \mathcode`\\="026E). Hence we use an explicit \mathchar,
+% which is the decimal equivalent of "715c (class 7, e.g., use \fam;
+% ignored family value; char position "5C). We can't use " for the
+% usual hex value because it has already been made active.
+
address@hidden@address@hidden @ifmmode @mathchar29020 @else @backslashcurfont
@fi}}
address@hidden@backslashchar = @ttbackslash % @backslashchar{} is for user
documents.
+
+% \rawbackslash defines an active \ to do \backslashcurfont.
+% \otherbackslash defines an active \ to be a literal `\' character with
+% catcode other. We switch back and forth between these.
address@hidden@address@hidden@backslashcurfont}
address@hidden@address@hidden@realbackslash}
+
+% Same as @turnoffactive except outputs \ as {\tt\char`\\} instead of
+% the literal character `\'.
+%
address@hidden = @active
+ @address@hidden
+ @nonasciistringdefs
+ @address@hidden
+ @let"address@hidden
+ @address@hidden %$ font-lock fix
+ @address@hidden
+ @let<address@hidden
+ @let>address@hidden
+ @address@hidden
+ @address@hidden
+ @let|address@hidden
+ @address@hidden
+ @address@hidden
+ @markupsetuplqdefault
+ @markupsetuprqdefault
+ @unsepspaces
+ }
+}
+
+% If a .fmt file is being used, characters that might appear in a file
+% name cannot be active until we have parsed the command line.
+% So turn them off again, and have @fixbackslash turn them back on.
address@hidden@other @address@hidden@other
+
+% \enablebackslashhack - allow file to begin `\input texinfo'
+%
+% If a .fmt file is being used, we don't want the `\input texinfo' to show up.
+% That is what \eatinput is for; after that, the `\' should revert to printing
+% a backslash.
+% If the file did not have a `\input texinfo', then it is turned off after
+% the first line; otherwise the first `\' in the file would cause an error.
+% This is used on the very last line of this file, texinfo.tex.
+% We also use @c to call @fixbackslash, in case ends of lines are hidden.
+{
address@hidden@^=7
address@hidden@address@hidden@enablebackslashhack{%
+ @address@hidden = @eatinput%
+ @address@hidden
+ @address@hidden@address@hidden
+ @def address@hidden@secondlinenl}%
+ @gdef @address@hidden@thirdlinenl}%
+ @gdef @address@hidden
+}}
+
address@hidden@^=7 @address@hidden
address@hidden@eatinput input address@hidden
+
+% Emergency active definition of newline, in case an active newline token
+% appears by mistake.
address@hidden@^=7 @catcode13=13%
address@hidden@enableemergencynewline{%
+ @gdef^^M{%
+ @par%
+ %<warning: active newline>@par%
+}}}
+
+
address@hidden@fixbackslash{%
+ @address@hidden @let\ = @ttbackslash @fi
+ @catcode13=5 % regular end of line
+ @enableemergencynewline
+ @address@hidden@texinfoc
+ % Also turn back on active characters that might appear in the input
+ % file name, in case not using a pre-dumped format.
+ @address@hidden
+ @address@hidden@active
+ %
+ % If texinfo.cnf is present on the system, read it.
+ % Useful for site-wide @afourpaper, etc. This macro, @fixbackslash, gets
+ % called at the beginning of every Texinfo file. Not opening texinfo.cnf
+ % directly in this file, texinfo.tex, makes it possible to make a format
+ % file for Texinfo.
+ %
+ @openin 1 texinfo.cnf
+ @ifeof 1 @else @input texinfo.cnf @fi
+ @closein 1
+}
+
+
+% Say @foo, not \foo, in error messages.
address@hidden = `@@
+
+% These (along with & and #) are made active for url-breaking, so need
+% active definitions as the normal characters.
address@hidden@normaldot{.}
address@hidden@normalquest{?}
address@hidden@normalslash{/}
+
+% These look ok in all fonts, so just make them not special.
+% @hashchar{} gets its own user-level command, because of #line.
address@hidden@& = @other @address@hidden&}
address@hidden@# = @other @address@hidden
address@hidden@% = @other @address@hidden
+
address@hidden @hashchar = @normalhash
+
address@hidden Finally, make ` and ' active, so that txicodequoteundirected and
address@hidden txicodequotebacktick work right in, e.g., @address@hidden'}}.
If we
address@hidden don't make ` and ' active, @code will not get them as active
chars.
address@hidden Do this last of all since we use ` in the previous @catcode
assignments.
address@hidden@'address@hidden
address@hidden@address@hidden
address@hidden
address@hidden
+
address@hidden Local variables:
address@hidden eval: (add-hook 'write-file-hooks 'time-stamp)
address@hidden page-delimiter: "^\\\\message\\|emacs-page"
address@hidden time-stamp-start: "def\\\\texinfoversion{"
address@hidden time-stamp-format: "%:y-%02m-%02d.%02H"
address@hidden time-stamp-end: "}"
address@hidden End:
+
address@hidden vim:sw=2:
+
address@hidden
+ arch-tag: e1b36e32-c96e-4135-a41a-0b2efa2ea115
address@hidden ignore
address@hidden
diff --git a/doc/it/txi-it.tex b/doc/it/txi-it.tex
new file mode 100755
index 0000000..ba3bf6a
--- /dev/null
+++ b/doc/it/txi-it.tex
@@ -0,0 +1,84 @@
+% $Id: txi-it.tex 5191 2013-02-23 00:11:18Z karl $
+% txi-it.tex -- Italian translations for texinfo.tex
+%
+% Copyright 1999, 2007, 2008 Free Software Foundation.
+%
+% This program is free software; you can redistribute it and/or modify
+% it under the terms of the GNU General Public License as published by
+% the Free Software Foundation; either version 3 of the License, or
+% (at your option) any later version.
+%
+% This program is distributed in the hope that it will be useful,
+% but WITHOUT ANY WARRANTY; without even the implied warranty of
+% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+% GNU General Public License for more details.
+%
+% You should have received a copy of the GNU General Public License
+% along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+\txisetlanguage{italian}{2}{2}
+
+\plainfrenchspacing
+
+\gdef\putwordAppendix{Appendice}
+\gdef\putwordChapter{Capitolo}
+\gdef\putwordfile{file}
+\gdef\putwordin{in}
+\gdef\putwordIndexIsEmpty{(L'indice \'e vuoto)}
+\gdef\putwordIndexNonexistent{(L'indice non esiste)}
+\gdef\putwordInfo{Info}
+\gdef\putwordInstanceVariableof{Variabile di istanza di}
+\gdef\putwordMethodon{Metodo di}
+\gdef\putwordNoTitle{Nessun titolo}
+\gdef\putwordof{di}
+\gdef\putwordon{su}
+\gdef\putwordpage{pagina}
+\gdef\putwordsection{sezione}
+\gdef\putwordSection{Sezione}
+\gdef\putwordsee{si veda la}
+\gdef\putwordSee{Si veda la}
+\gdef\putwordShortTOC{Sommario abbreviato}
+\gdef\putwordTOC{Sommario}
+%
+\gdef\putwordMJan{Gennaio}
+\gdef\putwordMFeb{Febbraio}
+\gdef\putwordMMar{Marzo}
+\gdef\putwordMApr{Aprile}
+\gdef\putwordMMay{Maggio}
+\gdef\putwordMJun{Giugno}
+\gdef\putwordMJul{Luglio}
+\gdef\putwordMAug{Agosto}
+\gdef\putwordMSep{Settembre}
+\gdef\putwordMOct{Ottobre}
+\gdef\putwordMNov{Novembre}
+\gdef\putwordMDec{Dicembre}
+%
+\gdef\putwordDefmac{Macro}
+\gdef\putwordDefspec{Forma speciale}
+\gdef\putwordDefvar{Variabile}
+\gdef\putwordDefopt{Opzione}
+\gdef\putwordDeffunc{Funzione}
+
+\gdef\putwordla{la}
+\gdef\putwordLa{La}
+\gdef\putwordsivedail{si veda il}
+\gdef\putwordSivedail{Si veda il}
+% Produces article before Section names
+\def\refla#1{\putwordla{} \xrefX[#1,,,,,,,]}
+\def\refLa#1{\putwordLa{} \xrefX[#1,,,,,,,]}
+% Produces article before Chapter names
+\def\pxrefil#1{\putwordsivedail{} \xrefX[#1,,,,,,,]}
+\def\pxrefIl#1{\putwordSivedail{} \xrefX[#1,,,,,,,]}
+\def\xrefil#1{\putwordsivedail{} \xrefX[#1,,,,,,,]}
+\def\xrefIl#1{\putwordSivedail{} \xrefX[#1,,,,,,,]}
+
+% Produces Day Month Year style of output.
+\def\today{%
+ \number\day\space
+ \ifcase\month
+ \or\putwordMJan\or\putwordMFeb\or\putwordMMar\or\putwordMApr
+ \or\putwordMMay\or\putwordMJun\or\putwordMJul\or\putwordMAug
+ \or\putwordMSep\or\putwordMOct\or\putwordMNov\or\putwordMDec
+ \fi
+ \space\number\year}
+% ultimo aggiornamento: 19 febbraio 2015 21:11
diff --git a/doc/it/vettore-elementi.eps b/doc/it/vettore-elementi.eps
new file mode 100755
index 0000000..87979fb
--- /dev/null
+++ b/doc/it/vettore-elementi.eps
@@ -0,0 +1,159 @@
+%!PS-Adobe-3.0 EPSF-3.0
+%%Title: vettore-elementi.fig
+%%Creator: fig2dev Version 3.2 Patchlevel 5e
+%%CreationDate: Mon Feb 9 17:13:19 2015
+%%For: address@hidden (Marco)
+%%BoundingBox: 0 0 383 76
+%Magnification: 1.0000
+%%EndComments
+%%BeginProlog
+/$F2psDict 200 dict def
+$F2psDict begin
+$F2psDict /mtrx matrix put
+/col-1 {0 setgray} bind def
+/col0 {0.000 0.000 0.000 srgb} bind def
+/col1 {0.000 0.000 1.000 srgb} bind def
+/col2 {0.000 1.000 0.000 srgb} bind def
+/col3 {0.000 1.000 1.000 srgb} bind def
+/col4 {1.000 0.000 0.000 srgb} bind def
+/col5 {1.000 0.000 1.000 srgb} bind def
+/col6 {1.000 1.000 0.000 srgb} bind def
+/col7 {1.000 1.000 1.000 srgb} bind def
+/col8 {0.000 0.000 0.560 srgb} bind def
+/col9 {0.000 0.000 0.690 srgb} bind def
+/col10 {0.000 0.000 0.820 srgb} bind def
+/col11 {0.530 0.810 1.000 srgb} bind def
+/col12 {0.000 0.560 0.000 srgb} bind def
+/col13 {0.000 0.690 0.000 srgb} bind def
+/col14 {0.000 0.820 0.000 srgb} bind def
+/col15 {0.000 0.560 0.560 srgb} bind def
+/col16 {0.000 0.690 0.690 srgb} bind def
+/col17 {0.000 0.820 0.820 srgb} bind def
+/col18 {0.560 0.000 0.000 srgb} bind def
+/col19 {0.690 0.000 0.000 srgb} bind def
+/col20 {0.820 0.000 0.000 srgb} bind def
+/col21 {0.560 0.000 0.560 srgb} bind def
+/col22 {0.690 0.000 0.690 srgb} bind def
+/col23 {0.820 0.000 0.820 srgb} bind def
+/col24 {0.500 0.190 0.000 srgb} bind def
+/col25 {0.630 0.250 0.000 srgb} bind def
+/col26 {0.750 0.380 0.000 srgb} bind def
+/col27 {1.000 0.500 0.500 srgb} bind def
+/col28 {1.000 0.630 0.630 srgb} bind def
+/col29 {1.000 0.750 0.750 srgb} bind def
+/col30 {1.000 0.880 0.880 srgb} bind def
+/col31 {1.000 0.840 0.000 srgb} bind def
+
+end
+
+/cp {closepath} bind def
+/ef {eofill} bind def
+/gr {grestore} bind def
+/gs {gsave} bind def
+/sa {save} bind def
+/rs {restore} bind def
+/l {lineto} bind def
+/m {moveto} bind def
+/rm {rmoveto} bind def
+/n {newpath} bind def
+/s {stroke} bind def
+/sh {show} bind def
+/slc {setlinecap} bind def
+/slj {setlinejoin} bind def
+/slw {setlinewidth} bind def
+/srgb {setrgbcolor} bind def
+/rot {rotate} bind def
+/sc {scale} bind def
+/sd {setdash} bind def
+/ff {findfont} bind def
+/sf {setfont} bind def
+/scf {scalefont} bind def
+/sw {stringwidth} bind def
+/tr {translate} bind def
+/tnt {dup dup currentrgbcolor
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add
+ 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb}
+ bind def
+/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul
+ 4 -2 roll mul srgb} bind def
+/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def
+/$F2psEnd {$F2psEnteredState restore end} def
+
+/pageheader {
+save
+newpath 0 76 moveto 0 0 lineto 383 0 lineto 383 76 lineto closepath clip
newpath
+-203.3 199.4 translate
+1 -1 scale
+$F2psBegin
+10 setmiterlimit
+0 slj 0 slc
+ 0.06299 0.06299 sc
+} bind def
+/pagefooter {
+$F2psEnd
+restore
+} bind def
+%%EndProlog
+pageheader
+%
+% Fig objects follow
+%
+%
+% here starts figure with depth 50
+% Polyline
+0 slj
+0 slc
+7.500 slw
+n 4455 1980 m 4455 2700 l 4455 2655 l
+ 4455 2700 l gs col0 s gr
+% Polyline
+n 6075 1980 m
+ 6075 2700 l gs col0 s gr
+% Polyline
+n 7425 1980 m
+ 7425 2700 l gs col0 s gr
+/Courier-Bold ff 190.50 scf sf
+3735 2340 m
+gs 1 -1 sc (8) col0 sh gr
+/Courier-Bold ff 190.50 scf sf
+6795 2340 m
+gs 1 -1 sc ("") col0 sh gr
+/Courier-Bold ff 190.50 scf sf
+7875 2340 m
+gs 1 -1 sc (30) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+3735 3150 m
+gs 1 -1 sc (0) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+5175 3150 m
+gs 1 -1 sc (1) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+6795 3150 m
+gs 1 -1 sc (2) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+7875 3150 m
+gs 1 -1 sc (3) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+8730 2340 m
+gs 1 -1 sc (Valore) col0 sh gr
+/Times-Roman ff 190.50 scf sf
+8730 3150 m
+gs 1 -1 sc (Indice) col0 sh gr
+/Courier-Bold ff 190.50 scf sf
+5175 2340 m
+gs 1 -1 sc ("pippo") col0 sh gr
+% here ends figure;
+%
+% here starts figure with depth 40
+% Polyline
+0 slj
+0 slc
+7.500 slw
+n 3240 1980 m 8415 1980 l 8415 2700 l 3240 2700 l
+ cp gs col0 s gr
+% here ends figure;
+pagefooter
+showpage
+%%Trailer
+%EOF
diff --git a/doc/it/vettore-elementi.fig b/doc/it/vettore-elementi.fig
new file mode 100755
index 0000000..37f3449
--- /dev/null
+++ b/doc/it/vettore-elementi.fig
@@ -0,0 +1,27 @@
+#FIG 3.2 Produced by xfig version 3.2.5c
+Landscape
+Center
+Metric
+A4
+100.00
+Single
+-2
+1200 2
+2 2 0 1 0 7 40 -1 -1 0.000 0 0 -1 0 0 5
+ 3240 1980 8415 1980 8415 2700 3240 2700 3240 1980
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 4
+ 4455 1980 4455 2700 4455 2655 4455 2700
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
+ 6075 1980 6075 2700
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
+ 7425 1980 7425 2700
+4 0 0 50 -1 14 12 0.0000 4 135 90 3735 2340 8\001
+4 0 0 50 -1 14 12 0.0000 4 45 180 6795 2340 ""\001
+4 0 0 50 -1 14 12 0.0000 4 135 180 7875 2340 30\001
+4 0 0 50 -1 0 12 0.0000 4 135 90 3735 3150 0\001
+4 0 0 50 -1 0 12 0.0000 4 135 90 5175 3150 1\001
+4 0 0 50 -1 0 12 0.0000 4 135 90 6795 3150 2\001
+4 0 0 50 -1 0 12 0.0000 4 135 90 7875 3150 3\001
+4 0 0 50 -1 0 12 0.0000 4 135 540 8730 2340 Valore\001
+4 0 0 50 -1 0 12 0.0000 4 135 540 8730 3150 Indice\001
+4 0 0 50 -1 14 12 0.0000 4 165 630 5175 2340 "pippo"\001
diff --git a/doc/it/vettore-elementi.pdf b/doc/it/vettore-elementi.pdf
new file mode 100755
index 0000000..cfec876
Binary files /dev/null and b/doc/it/vettore-elementi.pdf differ
diff --git a/doc/it/vettore-elementi.png b/doc/it/vettore-elementi.png
new file mode 100755
index 0000000..87ef434
Binary files /dev/null and b/doc/it/vettore-elementi.png differ
diff --git a/doc/it/vettore-elementi.txt b/doc/it/vettore-elementi.txt
new file mode 100755
index 0000000..5d7efb8
--- /dev/null
+++ b/doc/it/vettore-elementi.txt
@@ -0,0 +1,4 @@
++---------+---------+--------+---------+
+| 8 | "pippo" | "" | 30 | @r{Value}
++---------+---------+--------+---------+
+ 0 1 2 3 @r{Index}
-----------------------------------------------------------------------
Summary of changes:
doc/ChangeLog | 5 +
doc/Makefile.am | 3 +-
doc/Makefile.in | 3 +-
doc/it/ChangeLog | 7 +
doc/{api-figure1.eps => it/api-figura1.eps} | 32 +-
doc/{api-figure1.fig => it/api-figura1.fig} | 12 +-
doc/it/api-figura1.pdf | Bin 0 -> 9120 bytes
doc/it/api-figura1.png | Bin 0 -> 5747 bytes
doc/{api-figure1.txt => it/api-figura1.txt} | 4 +-
doc/{api-figure2.eps => it/api-figura2.eps} | 26 +-
doc/{api-figure2.fig => it/api-figura2.fig} | 8 +-
doc/it/api-figura2.pdf | Bin 0 -> 11596 bytes
doc/it/api-figura2.png | Bin 0 -> 5768 bytes
doc/{api-figure2.txt => it/api-figura2.txt} | 2 +-
doc/{api-figure3.eps => it/api-figura3.eps} | 32 +-
doc/{api-figure3.fig => it/api-figura3.fig} | 14 +-
doc/it/api-figura3.pdf | Bin 0 -> 11914 bytes
doc/it/api-figura3.png | Bin 0 -> 5734 bytes
doc/{api-figure3.txt => it/api-figura3.txt} | 2 +-
doc/it/compila_originale.sh | 16 +
doc/it/compila_smallprint.sh | 19 +
doc/it/epsf.tex | 653 +
doc/it/flusso-elaborazione.eps | 420 +
doc/it/flusso-elaborazione.fig | 37 +
doc/it/flusso-elaborazione.pdf | Bin 0 -> 9672 bytes
doc/it/flusso-elaborazione.png | Bin 0 -> 6300 bytes
doc/it/flusso-elaborazione.txt | 11 +
doc/it/gawk-it.texi | 46902 +++++++++++++++++++
doc/it/gawk.texi | 46902 +++++++++++++++++++
doc/it/gawktexi.in | 45878 ++++++++++++++++++
doc/{ => it}/lflashlight-small.xpic | 0
doc/{ => it}/lflashlight.eps | 0
doc/{ => it}/lflashlight.pdf | 0
doc/it/margini.texi | 7 +
doc/it/programma-generico.eps | 228 +
doc/it/programma-generico.fig | 25 +
doc/it/programma-generico.pdf | Bin 0 -> 5313 bytes
doc/it/programma-generico.png | Bin 0 -> 4151 bytes
doc/it/programma-generico.txt | 4 +
doc/{ => it}/rflashlight-small.xpic | 0
doc/{ => it}/rflashlight.eps | 0
doc/{ => it}/rflashlight.pdf | 0
doc/{ => it}/sidebar.awk | 0
doc/{ => it}/texinfo.tex | 33 +
doc/it/txi-it.tex | 84 +
.../vettore-elementi.eps} | 39 +-
doc/it/vettore-elementi.fig | 27 +
doc/it/vettore-elementi.pdf | Bin 0 -> 7009 bytes
doc/it/vettore-elementi.png | Bin 0 -> 1032 bytes
doc/it/vettore-elementi.txt | 4 +
50 files changed, 141352 insertions(+), 87 deletions(-)
create mode 100644 doc/it/ChangeLog
copy doc/{api-figure1.eps => it/api-figura1.eps} (96%)
mode change 100644 => 100755
copy doc/{api-figure1.fig => it/api-figura1.fig} (78%)
mode change 100644 => 100755
create mode 100755 doc/it/api-figura1.pdf
create mode 100755 doc/it/api-figura1.png
copy doc/{api-figure1.txt => it/api-figura1.txt} (91%)
mode change 100644 => 100755
copy doc/{api-figure2.eps => it/api-figura2.eps} (97%)
mode change 100644 => 100755
copy doc/{api-figure2.fig => it/api-figura2.fig} (74%)
mode change 100644 => 100755
create mode 100755 doc/it/api-figura2.pdf
create mode 100755 doc/it/api-figura2.png
copy doc/{api-figure2.txt => it/api-figura2.txt} (90%)
mode change 100644 => 100755
copy doc/{api-figure3.eps => it/api-figura3.eps} (96%)
mode change 100644 => 100755
copy doc/{api-figure3.fig => it/api-figura3.fig} (62%)
mode change 100644 => 100755
create mode 100755 doc/it/api-figura3.pdf
create mode 100755 doc/it/api-figura3.png
copy doc/{api-figure3.txt => it/api-figura3.txt} (90%)
mode change 100644 => 100755
create mode 100755 doc/it/compila_originale.sh
create mode 100755 doc/it/compila_smallprint.sh
create mode 100755 doc/it/epsf.tex
create mode 100755 doc/it/flusso-elaborazione.eps
create mode 100755 doc/it/flusso-elaborazione.fig
create mode 100755 doc/it/flusso-elaborazione.pdf
create mode 100755 doc/it/flusso-elaborazione.png
create mode 100755 doc/it/flusso-elaborazione.txt
create mode 100644 doc/it/gawk-it.texi
create mode 100644 doc/it/gawk.texi
create mode 100755 doc/it/gawktexi.in
copy doc/{ => it}/lflashlight-small.xpic (100%)
mode change 100644 => 100755
copy doc/{ => it}/lflashlight.eps (100%)
mode change 100644 => 100755
copy doc/{ => it}/lflashlight.pdf (100%)
mode change 100644 => 100755
create mode 100755 doc/it/margini.texi
create mode 100755 doc/it/programma-generico.eps
create mode 100755 doc/it/programma-generico.fig
create mode 100755 doc/it/programma-generico.pdf
create mode 100755 doc/it/programma-generico.png
create mode 100755 doc/it/programma-generico.txt
copy doc/{ => it}/rflashlight-small.xpic (100%)
mode change 100644 => 100755
copy doc/{ => it}/rflashlight.eps (100%)
mode change 100644 => 100755
copy doc/{ => it}/rflashlight.pdf (100%)
mode change 100644 => 100755
copy doc/{ => it}/sidebar.awk (100%)
mode change 100644 => 100755
copy doc/{ => it}/texinfo.tex (99%)
mode change 100644 => 100755
create mode 100755 doc/it/txi-it.tex
copy doc/{array-elements.eps => it/vettore-elementi.eps} (84%)
mode change 100644 => 100755
create mode 100755 doc/it/vettore-elementi.fig
create mode 100755 doc/it/vettore-elementi.pdf
create mode 100755 doc/it/vettore-elementi.png
create mode 100755 doc/it/vettore-elementi.txt
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-2541-gcaba861,
Arnold Robbins <=