What is the difference between NR and FNR?

NR is the cumulative record number across every input file, so it keeps counting as awk moves from one file to the next. FNR resets to 1 at the start of each file, which is useful for detecting headers or per-file logic.

How do I change the field separator in awk?

Set the FS variable, either on the command line with -F',' or inside a BEGIN block with FS=",". For output, set OFS to control the separator that print places between fields.

What is the difference between sub and gsub?

sub replaces only the first match of the regex in the target string and returns 0 or 1. gsub replaces every non-overlapping match and returns the total number of substitutions made.

How do I run code only once before or after processing?

Use the special BEGIN pattern for setup code that runs before any input is read, such as setting FS or printing a header. Use END for code that runs after the last record, ideal for printing totals.

Are awk string positions zero-based or one-based?

awk uses one-based indexing for strings and fields. substr(s,1,3) returns the first three characters, index returns 1 for a match at the start, and $1 is the first field.

awk Reference — Gera Tools

awk

awk is a line-oriented text-processing language: it reads input record by record (usually line by line), splits each record into fields, and runs pattern-action rules against it. Its power comes from a compact set of built-in variables like NR, NF and FS, a library of string and numeric functions, and the special BEGIN/END patterns. This page is a searchable, offline reference to all of them, each with a working snippet.

How it works

An awk program is a sequence of pattern { action } rules. For every input record:

The record is split into fields $1, $2, … up to $NF using the field separator FS; $0 is the whole record.
Each rule whose pattern matches runs its action. A pattern can be a regex /error/, a boolean expression NR > 1, a range /START/,/END/, or the special BEGIN/END markers.
Built-in variables track state: NR (record number), NF (field count), FNR (per-file record number), FILENAME, and the separators FS, OFS, RS, ORS.

String functions such as split, gsub, sub, substr, match, index and sprintf let you reshape text, while int, sqrt, log and friends handle numbers. print and printf produce output, and getline reads extra input.

Tips and examples

Sum a column and print the total at the end:

awk '{ sum += $2 } END { print "total:", sum }' data.tsv

Print the last field of each line regardless of how many fields there are:

awk '{ print $NF }' file

Reformat a colon-delimited file into tab-separated output:

awk 'BEGIN { FS=":"; OFS="\t" } { print $1, $3 }' /etc/passwd

Remember awk indexes from 1, treats unset variables as 0 or empty depending on context, and rebuilds $0 whenever you assign to a field — handy for in-place column edits.

awk Reference

Email me this result

awk

How it works

Tips and examples