csplit.1 (2010 09)

c
csplit(1) csplit(1)
NAME
csplit - context split
SYNOPSIS
csplit [-s][-k][
-f prefix ][-n number] file arg1 [ ... argn ]
DESCRIPTION
csplit reads file, separates it into n+1 sections as defined by the arguments arg1 ... argn, and places
the results in separate files. The maximum number of arguments (arg1 through argn) allowed is 99
unless the
-n number option is used to allow for more output file names. If the
-f prefix option is
specified, the resulting filenames are prefix
00 through prefix NN where NN is the two-digit value of n
using a leading zero if n is less than 10. If the
-f prefix option is not specified, the default filenames
xx00 through xxNN are used. file is divided as follows:
Default Prefixed
Filename Filename Contents
From start of file up to (but not including) the line
referenced by arg1.
xx00 prefix00
From the line referenced by arg1 up to the line
referenced by arg2.
xx01 prefix01
.
.
.
From the line referenced by argn to end of file.xxNN prefixNN
If the file argument is
-, standard input is used.
csplit supports the Basic Regular Expression syntax (see regexp (5)).
Options
csplit recognizes the following options:
-s Suppress printing of all character counts (csplit normally prints the character
counts for each file created).
-k Leave previously created files intact (csplit normally removes created files if an
error occurs).
-f prefix Name created files prefix00 through prefixNN (default is xx00
through xxNN.
-n number The output file name suffix will use number digits instead of the default
2. This
allows creation of more than 100 output files.
Arguments (arg1 through argn)to
csplit can be any combination of the following:
/regexp / Create a file containing the section from the current line up to (but not including)
the line matching the regular expression regexp . The new current line becomes the
line matching regexp .
/regexp /+n
/regexp /-n Create a file containing the section from the current line up to (but not including)
the nth before (-n) or after (+n) the line matching the regular expression regexp .
(e.g., /Page/-5). The new current line becomes the line matching regexp ±n lines.
%regexp % equivalent to /regexp /, except that no file is created for the section.
line_number Create a file from the current line up to (but not including) line_number . The new
current line becomes line_number .
{num} Repeat argument. This argument can follow any of the above argument forms. If it
follows a regexp argument, that argument is applied num more times. If it follows
line_number , the file is split every line_number lines for num times from that point
until end-of-file is reached or num expires.
{*} Repeats previous operand as many times as necessary to finish input.
Enclose in appropriate quotes all regexp arguments containing blanks or other characters meaningful to
the shell. Regular expressions must not contain embedded new-lines.
csplit does not alter or remove
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1