diff options
Diffstat (limited to 'util/sbase/cut.1')
| -rw-r--r-- | util/sbase/cut.1 | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/util/sbase/cut.1 b/util/sbase/cut.1 new file mode 100644 index 00000000..7a5174e6 --- /dev/null +++ b/util/sbase/cut.1 @@ -0,0 +1,69 @@ +.Dd October 8, 2015 +.Dt CUT 1 +.Os sbase +.Sh NAME +.Nm cut +.Nd extract columns of data +.Sh SYNOPSIS +.Nm +.Fl b Ar list +.Op Fl n +.Op Ar file ... +.Nm +.Fl c Ar list +.Op Ar file ... +.Nm +.Fl f Ar list +.Op Fl d Ar delim +.Op Fl s +.Op Ar file ... +.Sh DESCRIPTION +.Nm +out bytes, characters or delimited fields from each line of +.Ar file +and write to stdout. +.Pp +If no +.Ar file +is given or +.Ar file +is '-', +.Nm +reads from stdin. +.Pp +.Ar list +is a comma or space separated list of numbers and ranges starting +from 1. +Ranges have the form 'N-M'. If N or M is missing, beginning or end +of line is assumed. +Numbers and ranges may be repeated, overlapping and in any order. +.Pp +Selected input is written in the same order it is read +and is written exactly once. +.Sh OPTIONS +.Bl -tag -width Ds +.It Fl b Ar list | Fl c Ar list +.Ar list +specifies byte | character positions. +.It Fl d Ar delim +Use +.Ar delim +as field delimiter, which can be an arbitrary string. +Default is '\et'. +.It Fl f Ar list +.Ar list +specifies field numbers. +Lines not containing field delimiters are passed through, unless +.Fl s +is specified. +.It Fl n +Do not split multibyte characters. +A character is written when its last byte is selected. +.It Fl s +Suppress lines not containing field delimiters. +.El +.Sh STANDARDS +POSIX.1-2013. +.Pp +The possibility of separating numbers and ranges with a space and specifying +multibyte delimiters of arbitrary length is an extension to that specification. |