home *** CD-ROM | disk | FTP | other *** search
- Newsgroups: comp.sys.next.misc
- Path: sparky!uunet!blaze.cs.jhu.edu!syzygy.cs.jhu.edu!swiet
- From: swiet@syzygy.cs.jhu.edu (Alexander Swietlicki)
- Subject: Re: Is there a "cut" command available for the NeXT ???
- Message-ID: <1992Dec12.171809.26343@blaze.cs.jhu.edu>
- Sender: news@blaze.cs.jhu.edu (Usenet news system)
- Organization: Johns Hopkins Computer Science Department, Baltimore, MD
- References: <1992Dec9.030102.5535@leland.Stanford.EDU> <28333@oasys.dt.navy.mil> <1992Dec11.142738.11686@black.toppoint.de>
- Date: Sat, 12 Dec 1992 17:18:09 GMT
- Lines: 110
-
- .\" Copyright (c) 1989, 1990 The Regents of the University of California.
- .\" All rights reserved.
- .\"
- .\" This code is derived from software contributed to Berkeley by
- .\" the Institute of Electrical and Electronics Engineers, Inc.
- .\"
- .\" Redistribution and use in source and binary forms, with or without
- .\" modification, are permitted provided that the following conditions
- .\" are met:
- .\" 1. Redistributions of source code must retain the above copyright
- .\" notice, this list of conditions and the following disclaimer.
- .\" 2. Redistributions in binary form must reproduce the above copyright
- .\" notice, this list of conditions and the following disclaimer in the
- .\" documentation and/or other materials provided with the distribution.
- .\" 3. All advertising materials mentioning features or use of this software
- .\" must display the following acknowledgement:
- .\" This product includes software developed by the University of
- .\" California, Berkeley and its contributors.
- .\" 4. Neither the name of the University nor the names of its contributors
- .\" may be used to endorse or promote products derived from this software
- .\" without specific prior written permission.
- .\"
- .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
- .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
- .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
- .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
- .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
- .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
- .\" SUCH DAMAGE.
- .\"
- .\" @(#)cut.1 5.5 (Berkeley) 6/27/91
- .\"
- .Dd June 27, 1991
- .Dt CUT 1
- .Os
- .Sh NAME
- .Nm cut
- .Nd select portions of each line of a file
- .Sh SYNOPSIS
- .Nm cut
- .Fl c Ar list
- .Ar
- .Nm cut
- .Fl f Ar list
- .Op Fl d Ar string
- .Op Fl s
- .Ar
- .Sh DESCRIPTION
- The
- .Nm cut
- utility selects portions of each line (as specified by
- .Ar list )
- from each
- .Ar file
- (or the standard input by default), and writes them to the
- standard output.
- The items specified by
- .Ar list
- can be in terms of column position or in terms of fields delimited
- by a special character. Column numbering starts from 1.
- .Pp
- .Ar List
- is a comma or whitespace separated set of increasing numbers and/or
- number ranges.
- Number ranges consist of a number, a dash
- .Pq Li \- ,
- and a second number
- and select the fields or columns from the first number to the second,
- inclusive.
- Numbers or number ranges may be preceded by a dash, which selects all
- fields or columns from 1 to the first number.
- Numbers or number ranges may be followed by a dash, which selects all
- fields or columns from the last number to the end of the line.
- Numbers and number ranges may be repeated, overlapping, and in any order.
- It is not an error to select fields or columns not present in the
- input line.
- .Pp
- The options are as follows:
- .Bl -tag -width Fl
- .It Fl c Ar list
- The
- .Ar list
- specifies character positions.
- .It Fl d Ar string
- Use
- .Ar char
- as the field delimiter character instead of the tab character.
- .It Fl f Ar list
- The
- .Ar list
- specifies fields, delimited in the input by a single tab character.
- Output fields are separated by a single tab character.
- .It Fl s
- Suppresses lines with no field delimiter characters.
- Unless specified, lines with no delimiters are passed through unmodified.
- .El
- .Pp
- .Nm Cut
- exits 0 on success, 1 if an error occurred.
- .Sh SEE ALSO
- .Xr paste 1
- .Sh STANDARDS
- The
- .Nm cut
- utility is expected to conform to
- .St -p1003.2 .
-