aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gawk.1
diff options
context:
space:
mode:
authorArnold D. Robbins <arnold@skeeve.com>2017-04-12 11:36:36 +0300
committerArnold D. Robbins <arnold@skeeve.com>2017-04-12 11:36:36 +0300
commit6ba1d42808efba4f381aaeec54211a7802b816ff (patch)
tree00513bc313fec3b13a4a264898868663060a71aa /doc/gawk.1
parent9d331bd9dc0f3e752b1c4a80fe1f7eaad8e34403 (diff)
parentc9c9fe5bb2d5c6b07a67f4cf6861aeb6d9bbfcfd (diff)
downloadegawk-6ba1d42808efba4f381aaeec54211a7802b816ff.tar.gz
egawk-6ba1d42808efba4f381aaeec54211a7802b816ff.tar.bz2
egawk-6ba1d42808efba4f381aaeec54211a7802b816ff.zip
Merge branch 'master' into feature/stringfix
Diffstat (limited to 'doc/gawk.1')
-rw-r--r--doc/gawk.115
1 files changed, 11 insertions, 4 deletions
diff --git a/doc/gawk.1 b/doc/gawk.1
index 2460a686..a4f691d6 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -805,10 +805,13 @@ is a regular expression.
.PP
If the
.B FIELDWIDTHS
-variable is set to a space separated list of numbers, each field is
+variable is set to a space-separated list of numbers, each field is
expected to have fixed width, and
.I gawk
-splits up the record using the specified widths. The value of
+splits up the record using the specified widths.
+Each field width may optionally be preceded by a colon-separated
+value specifying the number of characters to skip before the field starts.
+The value of
.B FS
is ignored.
Assigning a new value to
@@ -959,12 +962,14 @@ For non-system errors,
will be zero.
.TP
.B FIELDWIDTHS
-A whitespace separated list of field widths. When set,
+A whitespace-separated list of field widths. When set,
.I gawk
parses the input into fields of fixed width, instead of using the
value of the
.B FS
variable as the field separator.
+Each field width may optionally be preceded by a colon-separated
+value specifying the number of characters to skip before the field starts.
See
.BR Fields ,
above.
@@ -1133,8 +1138,10 @@ is in effect,
\fB"FPAT"\fP if field splitting with
.B FPAT
is in effect,
-or \fB"FIELDWIDTHS"\fP if field splitting with
+\fB"FIELDWIDTHS"\fP if field splitting with
.B FIELDWIDTHS
+is in effect,
+or \fB"API"\fP if API input parser field splitting
is in effect.
.TP
\fBPROCINFO["gid"]\fP