NAME

csplit − context split

SYNOPSIS

csplit −s ] [ −k ] [ −f prefix ] file arg1 [ ... argn ]

DESCRIPTION

Csplit reads file and separates it into n+1 sections, defined by the arguments arg1... argn. By default the sections are placed in xx00 ... xxn (n may not be greater than 99).  These sections get the following pieces of file:

00: From the start of file up to (but not including) the line referenced by arg1.

01: From the line referenced by arg1 up to the line referenced by arg2.

.  .  . 

n+1: From the line referenced by argn to the end of file.

The options to csplit are:

−s Csplit normally prints the character counts for each file created.  If the −s option is present, csplit suppresses the printing of all character counts. 

−k Csplit normally removes created files if an error occurs.  If the −k option is present, csplit leaves previously created files intact. 

−f prefix If the −f option is used, the created files are named prefix00 ... prefixn. The default is xx00 ... xxn.

The arguments (arg1 ... argn) to csplit can be a combination of the following:

/rexp/ A file is to be created for the section from the current line up to (but not including) the line containing the regular expression rexp. The current line becomes the line containing rexp. This argument may be followed by an optional + or − some number of lines (e.g., /Page/−5). 

%rexp% This argument is the same as /rexp/, except that no file is created for the section.

lnno A file is to be created from the current line up to (but not including) lnno. The current line becomes lnno.

{num} Repeat argument.  This argument may follow any of the above arguments.  If it follows a rexp type argument, that argument is applied num more times.  If it follows lnno, the file will be split every lnno lines (num times) from that point. 

Enclose all rexp type arguments that contain blanks or other characters meaningful to the Shell in the appropriate quotes.  Regular expressions may not contain embedded new-lines.  Csplit does not affect the original file; it is the users responsibility to remove it. 

EXAMPLE

csplit −f cobol file  ’/procedure division/’  /par5./  /par16./

creates four files, "cobol00 ... cobol03".  After editing the split files, they can be recombined as follows:

cat cobol0[0−3] > file

Note that this example overwrites the original file. 

csplit −k file  100  {99}

splits the file at every 100 lines, up to 10,000 lines.  The −k option causes the created files to be retained if there are less than 10,000 lines; however, an error message would still be printed. 

csplit −k prog.c  ’%main(%’  ’/^}/+1’  {20}

assuming that "prog.c" follows the normal C coding convention of ending routines with a } at the beginning of the line, this example will create a file containing each separate C routine (up to 21) in "prog.c". 

SEE ALSO

ed(1), sh(1), regexp(5). 

DIAGNOSTICS

Self explanatory except for:

arg − out of range

which means that the given argument did not reference a line between the current position and the end of the file. 

Version 3.6  —  December 20, 1987