cut.1 - sbase - suckless unix tools
 (HTM) git clone git://git.suckless.org/sbase
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       cut.1 (1443B)
       ---
            1 .Dd October 8, 2015
            2 .Dt CUT 1
            3 .Os sbase
            4 .Sh NAME
            5 .Nm cut
            6 .Nd extract columns of data
            7 .Sh SYNOPSIS
            8 .Nm
            9 .Fl b Ar list
           10 .Op Fl n
           11 .Op Ar file ...
           12 .Nm
           13 .Fl c Ar list
           14 .Op Ar file ...
           15 .Nm
           16 .Fl f Ar list
           17 .Op Fl d Ar delim
           18 .Op Fl s
           19 .Op Ar file ...
           20 .Sh DESCRIPTION
           21 .Nm
           22 out bytes, characters or delimited fields from each line of
           23 .Ar file
           24 and write to stdout.
           25 .Pp
           26 If no
           27 .Ar file
           28 is given or
           29 .Ar file
           30 is '-',
           31 .Nm
           32 reads from stdin.
           33 .Pp
           34 .Ar list
           35 is a comma or space separated list of numbers and ranges starting
           36 from 1.
           37 Ranges have the form 'N-M'. If N or M is missing, beginning or end
           38 of line is assumed.
           39 Numbers and ranges may be repeated, overlapping and in any order.
           40 .Pp
           41 Selected input is written in the same order it is read
           42 and is written exactly once.
           43 .Sh OPTIONS
           44 .Bl -tag -width Ds
           45 .It Fl b Ar list | Fl c Ar list
           46 .Ar list
           47 specifies byte | character positions.
           48 .It Fl d Ar delim
           49 Use
           50 .Ar delim
           51 as field delimiter, which can be an arbitrary string.
           52 Default is '\et'.
           53 .It Fl f Ar list
           54 .Ar list
           55 specifies field numbers.
           56 Lines not containing field delimiters are passed through, unless
           57 .Fl s
           58 is specified.
           59 .It Fl n
           60 Do not split multibyte characters.
           61 A character is written when its last byte is selected.
           62 .It Fl s
           63 Suppress lines not containing field delimiters.
           64 .El
           65 .Sh STANDARDS
           66 POSIX.1-2013.
           67 .Pp
           68 The possibility of separating numbers and ranges with a space and specifying
           69 multibyte delimiters of arbitrary length is an extension to that specification.