.\" Copyright (c) 1989, 1990, 1993
.\"	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.
.\" %FreeBSD: src/usr.bin/cut/cut.1,v 1.29 2004/07/07 19:57:15 ru Exp %
.\"
.\"     @(#)cut.1	8.1 (Berkeley) 6/6/93
.\" $FreeBSD$
.\"
.Dd June 28, 2004
.Dt CUT 1
.Os
.Sh 名称
.Nm cut
.Nd ファイルの各行の、指定した部分を取り出す
.Sh 書式
.Nm cut
.Fl b Ar list
.Op Fl n
.Op Ar
.Nm cut
.Fl c Ar list
.Op Ar
.Nm cut
.Fl f Ar list
.Op Fl d Ar delim
.Op Fl s
.Op Ar
.Sh 解説
.Nm
は、
.Ar file
から行を読み込み、
.Ar list
の指定に従って選択した部分を取り出して標準出力に出力します。
.Ar file
引数が指定されない場合もしくはこれが単一のダッシュ
.Pq Sq Fl
の場合、
.Nm
は標準入力から読み込みます。
.Ar list
には、カラム番号、もしくはフィールド番号を指定します。
フィールドは特定の文字で区切られた領域です。
カラム番号およびフィールド番号は 1 から始まります。
.\" フィールド番号が 1 から始まるという記述はオリジナルには無いですが、
.\" 分かりやすくするために補足しました。
.\" By horikawa@isrd.hitachi.co.jp (Nov 9 1996)
.Pp
.Ar list
オプション引数には、コンマもしくは空白で区切られた
複数の増加方向の番号もしくは番号範囲を指定することができます。
番号範囲は、1 番目の番号、ダッシュ
.Pq Sq \-
、2 番目の番号の 3 つの組から構成され、
1 番目の番号から 2 番目の番号までの複数のフィールドもしくは複数のカラムを
選択します。
範囲には 1 番目の番号および 2 番目の番号も含まれます。
番号もしくは番号範囲の前にダッシュをつけた場合には、
1 番目の番号までのすべてのフィールドもしくはカラムも選択します。
番号もしくは番号範囲の後にダッシュをつけた場合には、
最後の番号以降のすべてのフィールドもしくはカラムも選択します。
番号もしくは番号範囲は、
繰り返しても、重なっても、いかなる順番であっても構いません。
また、入力行に指定のフィールドやカラムがない場合、
エラーとはなりません。
.Pp
オプションとしては以下のものがあります:
.Bl -tag -width indent
.It Fl b Ar list
バイト単位で指定します。
.It Fl c Ar list
文字単位で指定します。
.It Fl d Ar delim
フィールドを区切る文字として
.Ar delim
を使用します。
デフォルトではタブが使用されます。
.It Fl f Ar list
フィールド区切り文字で区切られたフィールド単位に指定します
(
.Fl d
オプションを参照)。
出力フィールドは、フィールド区切り文字 1 つによって区切られます。
.It Fl n
マルチバイト文字を分割しません。
マルチバイト文字は、その文字を構成するバイト列のうち
1 バイト以上が選択されている、その選択された 1 バイトの前に
その文字を構成する選択されていないバイト列が 0 バイト以上ある、
その選択された 1 バイトの後ろがすべて選択されている、という条件が
満たされた場合にのみ、出力されます。
.It Fl s
区切り文字のない行を出力しないようにします。
このオプションが指定されてない場合、区切り文字がない行はそのまま出力されます。
.El
.Sh 環境変数
.Xr environ 7
に記述されているように、
.Ev LANG , LC_ALL , LC_CTYPE
環境変数は
.Nm
の実行に影響を及ぼします。
.Sh 使用例
ユーザのログイン名とシェルを、システムの
.Xr passwd 5
ファイルから
.Dq name:shell
という組で取り出します:
.Pp
.Dl "cut -d : -f 1,7 /etc/passwd"
.Pp
現在ログインしているユーザに対し、名前とログイン時刻を表示します:
.Pp
.Dl "who | cut -c 1-16,26-38"
.Sh 診断
.Ex -std
.Sh 関連項目
.Xr colrm 1 ,
.Xr paste 1
.Sh 規格
.Nm
ユーティリティは
.St -p1003.2-92
準拠です。
.Sh 歴史
.Nm
コマンドは
.Tn AT&T
System III
.Ux
に登場しました。