Node:Nextfile Statement, Next:Exit Statement, Previous:Next Statement, Up:Statements
gawk provides the
which is similar to the
However, instead of abandoning processing of the current record, the
nextfile statement instructs
gawk to stop processing the
current data file.
nextfile statement is a
In most other
gawk is in compatibility mode
(see Command-Line Options),
nextfile is not special.
Upon execution of the
updated to the name of the next data file listed on the command line,
FNR is reset to one,
ARGIND is incremented, and processing
starts over with the first rule in the program.
ARGIND hasn't been introduced yet. See Built-in Variables.)
nextfile statement causes the end of the input to be reached,
then the code in any
END rules is executed.
END Special Patterns.
nextfile statement is useful when there are many data files
to process but it isn't necessary to process every record in every file.
Normally, in order to move on to the next data file, a program
has to continue scanning the unwanted records. The
statement accomplishes this much more efficiently.
While one might think that
close(FILENAME) would accomplish
the same as
nextfile, this isn't true.
reserved for closing files, pipes, and coprocesses that are
opened with redirections. It is not related to the main processing that
awk does with the files listed in
If it's necessary to use an
awk version that doesn't support
nextfile as a Function,
for a user-defined function that simulates the
The current version of the Bell Laboratories
(see Other Freely Available
nextfile. However, it doesn't allow the
statement inside function bodies
(see User-Defined Functions).
gawk does; a
nextfile inside a
function body reads the next record and starts processing it with the
first rule in the program, just as any other
Caution: Versions of
gawk prior to 3.0 used two
next file) for the
In version 3.0, this was changed
to one word, because the treatment of
inconsistent. When it appeared after
file was a keyword;
otherwise, it was a regular identifier. The old usage is no longer
next file generates a syntax error.