1
0
mirror of git://git.suckless.org/sbase synced 2024-12-23 15:34:38 +00:00
sbase/cut.1
2013-10-08 20:41:32 +01:00

61 lines
1.2 KiB
Groff

.TH CUT 1 sbase\-VERSION
.SH NAME
cut \- extract columns of data
.SH SYNOPSIS
.B cut \-b
.I list
.RB [ \-n ]
.RI [ file ...]
.br
.B cut \-c
.I list
.RI [ file ...]
.br
.B cut \-f
.I list
.RB [ \-d
.IR delim ]
.RB [ \-s ]
.RI [ file ...]
.SH DESCRIPTION
.B cut
out bytes, characters, or delimited fields from each line of the given
files and write to stdout. With no file, or when file is `-', cut reads
from stdin.
.P
.I list
is a comma or space separated list of numbers and ranges where numbering
starts from 1. Ranges are on the form `N-M'. If N or M is missing, the
beginning or end of line is assumed. Numbers and ranges may be repeated,
overlapping, and in any order. Selected input is written in the same
order that it is read, and is written exactly once.
.SH OPTIONS
.TP
.BI \-b \ list
The
.I list
specifies byte positions.
.TP
.BI \-c \ list
The
.I list
specifies character positions.
.TP
.BI \-d \ delim
Use first byte of
.I delim
as field delimiter, instead of tab.
.TP
.BI \-f \ list
The
.I list
specifies field numbers. Lines not containing field delimiters are
passed through untouched.
.TP
.B \-n
Do not split characters. A character is output if its last byte is
selected.
.TP
.B \-s
Suppress lines not containing field delimiters.