commands/cut/cut.1

   1 .\"     $NetBSD: cut.1,v 1.14.26.1 2008/12/23 03:47:20 snj Exp $
   2 .\"
   3 .\" Copyright (c) 1989, 1990, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to Berkeley by
   7 .\" the Institute of Electrical and Electronics Engineers, Inc.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\" 3. Neither the name of the University nor the names of its contributors
  18 .\"    may be used to endorse or promote products derived from this software
  19 .\"    without specific prior written permission.
  20 .\"
  21 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31 .\" SUCH DAMAGE.
  32 .\"
  33 .\"     @(#)cut.1       8.1 (Berkeley) 6/6/93
  34 .\"
  35 .Dd December 21, 2008
  36 .Dt CUT 1
  37 .Os
  38 .Sh NAME
  39 .Nm cut
  40 .Nd select portions of each line of a file
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Fl b Ar list
  44 .Op Fl n
  45 .Op Ar
  46 .Nm
  47 .Fl c Ar list
  48 .Op Ar
  49 .Nm
  50 .Fl f Ar list
  51 .Op Fl d Ar delim
  52 .Op Fl s
  53 .Op Ar
  54 .Sh DESCRIPTION
  55 The
  56 .Nm
  57 utility selects portions of each line (as specified by
  58 .Ar list  )
  59 from each
  60 .Ar file
  61 and writes them to the
  62 standard output.
  63 If the
  64 .Ar file
  65 argument is a single dash
  66 .Pq Sq -
  67 or no
  68 .Ar file
  69 arguments were specified, lines are read from the standard input.
  70 The items specified by
  71 .Ar list
  72 can be in terms of column position or in terms of fields delimited
  73 by a special character.
  74 Column numbering starts from 1.
  75 .Pp
  76 .Ar List
  77 is a comma or whitespace separated set of increasing numbers and/or
  78 number ranges.
  79 Number ranges consist of a number, a dash
  80 .Pq Li \- ,
  81 and a second number
  82 and select the fields or columns from the first number to the second,
  83 inclusive.
  84 Numbers or number ranges may be preceded by a dash, which selects all
  85 fields or columns from 1 to the first number.
  86 Numbers or number ranges may be followed by a dash, which selects all
  87 fields or columns from the last number to the end of the line.
  88 Numbers and number ranges may be repeated, overlapping, and in any order.
  89 It is not an error to select fields or columns not present in the
  90 input line.
  91 .Pp
  92 The options are as follows:
  93 .Bl -tag -width Fl
  94 .It Fl b Ar list
  95 The
  96 .Ar list
  97 specifies byte positions.
  98 .It Fl c Ar list
  99 The
 100 .Ar list
 101 specifies character positions.
 102 .It Fl d Ar string
 103 Use the first character of
 104 .Ar string
 105 as the field delimiter character.
 106 The default is the
 107 .Aq TAB
 108 character.
 109 .It Fl f Ar list
 110 The
 111 .Ar list
 112 specifies fields, separated by the field delimiter character.
 113 The selected fields are output,
 114 separated by the field delimiter character.
 115 .It Fl n
 116 Do not split multi-byte characters.
 117 .It Fl s
 118 Suppresses lines with no field delimiter characters.
 119 Unless specified, lines with no delimiters are passed through unmodified.
 120 .El
 121 .Sh EXIT STATUS
 122 .Nm
 123 exits 0 on success, 1 if an error occurred.
 124 .Sh SEE ALSO
 125 .Xr paste 1
 126 .Sh STANDARDS
 127 The
 128 .Nm
 129 utility conforms to
 130 .St -p1003.2-92 .