A BEGIN rule executes once only, before the first input record
is read. Likewise, an END rule executes once only, after all the
input is read. For example:
$ awk '
> BEGIN { print "Analysis of \"li\"" }
> /li/ { ++n }
> END { print "\"li\" appears in", n, "records." }' mail-list
⊣ Analysis of "li"
⊣ "li" appears in 4 records.
This program finds the number of records in mail-list
that contain the string ‘li’. The BEGIN rule prints a title
for the report. There is no need to use the BEGIN rule to
initialize the counter n to zero, as awk does this
automatically (see Variables).
The second rule increments n every time a
record containing the pattern ‘li’ is read. The END rule
prints the value of n at the end of the run.
The special patterns BEGIN and END cannot be used in ranges
or with Boolean operators (indeed, they cannot be used with any operators).
An awk program may have multiple BEGIN and/or END
rules. They execute in the order in which they appear: all the BEGIN
rules at startup and all the END rules at termination.
BEGIN and END rules may be intermixed with other rules.
In terms of program organization and readability,
it is a good idea to place the BEGIN rule at the beginning of the
program, and to place the END rule at the end.
Multiple BEGIN and END rules are useful for writing
library functions, because each library file can have its own BEGIN and/or
END rule to do its own initialization and/or cleanup.
The order in which library functions are named on the command line
controls the order in which their BEGIN and END rules
execute. Therefore, you have to be careful when writing such rules in
library files so that the order in which they execute doesn’t matter.
See Command-Line Options for more information on
using library functions.
See A Library of awk Functions,
for a number of useful library functions.
If an awk program has only BEGIN rules and no
other rules, then the program exits after the BEGIN rules
run. However, if an
END rule exists, then the input is read, even if there are
no other rules in the program. This is necessary in case the END
rule checks the FNR and NR variables, or the fields.