.\" You may copy, distribute and modify under the terms of the LDP General
.\" Public License as specified in the LICENSE file that comes with the
.\" gnumaniak distribution
.\"
.\" The author kindly requests that no comments regarding the "better"
.\" suitability or up-to-date notices of any info documentation alternative
.\" is added without contacting him first.
.\"
.\" (C) 2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
.\"
.\"	GNU csplit man page
.\"	man pages are NOT obsolete!
.\"	<ragnar@ragnar-hojland.com>
.\"
.\" Japanese Version Copyright (c) 2000 NAKANO Takeo all rights reserved.
.\" Translated Sun 12 Mar 2000 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\"
.TH CSPLIT 1 "7 October 2002" "GNU textutils 2.1"
.SH 名前
csplit \- ファイルを文脈ベースで分割する
.B csplit 
.RB [ \-kqsz ]
[\fB\-b \fISUFFIX\fR] [\fB\-f \fIPREFIX\fR]
[\fB\-n \fIDIGITS\fR] [\fB\-\-digits=\fIDIGITS\fR]
[\fB\-\-elide\-empty\-files\fR] [\fB\-\-keep\-files\fR]
[\fB\-\-prefix=\fIPREFIX\fR]
[\fB\-\-quiet\fR]
[\fB\-\-silent\fR]
[\fB\-\-suffix=\fISUFFIX\fR]
[\fIFILE\fR]

.BR csplit " [" \-\-help "] [" \-\-version ]
.SH 説明
.B csplit
は
.I FILE
の各セクション（section）の内容を持つ 0 個以上の出力ファイルを作成する。
.I FILE
が一つも与えられないと標準入力から読み込む。また
.I FILE
が
.RB ` \- '
だった場合には、そのファイルには標準入力が用いられる。

出力ファイルの内容は
.I PATTERN
引数によって決まる。
.I PATTERN
引き数で指定される行が入力ファイルに存在しない場合はエラーとなる
(例えば、与えられた正規表現にマッチする行が残っていない場合など)。
すべての
.I PATTERN
がマッチしおわったら、入力の残りは最後の出力ファイルにコピーされる。

出力ファイルのファイル名は二つの部分からなっている。
前半部のデフォルト名は `xx' である。
デフォルトでは後半部は 2 桁の 10 進数で、
`00' から `99' まで順にカウントアップされて行く。
いずれの場合でも、出力ファイルを名前でソートして順に結合させると、
入力ファイルが得られるようになっている。

デフォルトでは、
.B csplit
はそれぞれの出力ファイルを作成した後に、
それに書き出したバイト数を表示する。

.B csplit
がエラーになったり、
hangup, interrupt, quit, terminate 各シグナルを受け取った場合には、
デフォルトではそれまでに作られた出力ファイルは消去される。
.SH オプション
.TP
.B \-b \fISUFFIX\fB, \-\-suffix=\fISUFFIX
.I SUFFIX
を出力ファイル名の後半部に用いる。
.I SUFFIX
には、 printf(3) 形式の変換文字列を一つだけ指定しなければならない。
書式指定フラグ、文字列の幅、精度指定なども指定できる。変換指定
文字列は整数を可読なかたちで出力するものでなければならない。
書式は整数値を可読な形式に変換するものでなければならない。したがって
使えるのは
.RB ` d "', `" i "', `" u "', `" o "', `" x "', `" X '
に限られる。
.I suffix
文字列はすべて（現在の出力ファイルが何番目かを示す数値と共に）
.BR sprintf (3)
関数に渡され、それぞれの出力ファイルに応じた名前が順番に出力される。
このオプションが指定されると、
.B \-\-digits
オプションは無視される。
.TP
.B \-f \fIPREFIX\fB, \-\-prefix=\fIPREFIX
出力ファイル名の前半部を
.I PREFIX
にする。
.TP
.B \-k, \-\-keep\-files
エラーが起こったとき、
それまでに作成した出力ファイルを消去しないようにする。
.TP
.B \-n \fIDIGITS\fB, \-\-digits=\fIDIGITS
出力ファイル名の数値部分の桁数をデフォルト値の 2 から
.I DIGITS
に変更する。
.TP
.B \-q, \-s, \--quiet, \--silent
出力ファイルのサイズを表示しない。
.TP
.B \-z, \-\-elide\-empty\-files
大きさ 0 の出力ファイルを作らないようにする。
(セクション区切りが入力の最初の行にきた場合、
このオプションを指定していなければ対応する出力ファイルの大きさは 0 になる)。
なお出力ファイルの順番を示す番号は、
このオプションが指定された場合でも、
常に 0 から連続してカウントされる。
.TP
.B "\-\-help"
標準出力に使用方法のメッセージを出力して正常終了する。
.TP
.B "\-\-version"
標準出力にバージョン情報を出力して正常終了する。
.SH PATTERN 引数
.TP
.I N
\fIN\fP には正の整数を指定する。出力ファイルを作成し、
入力ファイルの内容を行番号が \fIN\fP になるまで書き込む
(ただし \fIline\fP の行は書き込まない)。
この後に繰り返し回数を指定すると、
それぞれ \fIN\fR 行分の入力ファイルの内容を含む出力ファイルを作成する。
.TP
\fB/\fIREGEXP\fB/\fR[\fIOFFSET\fR]
出力ファイルを作成し、入力ファイルのうち
.I REGEXP
にマッチする行の前までの内容を書き込む (マッチ行は含まない)。
.I OFFSET
を付加することもでき、これは
.RB ` + "' または `" - '
に正の整数を続けて指定する。
.I OFFSET
が指定されるとマッチ行に
.I OFFSET
の値を増減した行までが出力される。
入力ファイルの残りは次のセクションの入力として利用される。
.TP
\fB%\fIREGEXP\fB%\fR[\fIOFFSET\fR]
直前の形式と同様だが、出力ファイルが作成されない。
したがって入力ファイルの該当するセクションは無視されることになる。
.TP
\fB{\fIREPEAT\-COUNT\fB}
直前のパターンを
.I REPEAT\-COUNT
の回数だけ余計に繰りかえす。
.I REPEAT\-COUNT
には正の整数かアスタリスクが指定できる。
アスタリスクの場合は、
入力ファイルが終わるまで直前のパターンを繰り返す。
.SH 注意
プログラムのバグについては bug-textutils@gnu.org に報告してください。
.br
man ページは Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com> が作成しました。