CSPLIT(1) BSD General Commands Manual CSPLIT(1)NAME
csplit -- split files based on context
SYNOPSIS
csplit [-ks] [-f prefix] [-n number] file args ...
DESCRIPTION
The csplit utility splits file into pieces using the patterns args. If file is a dash ('-'), csplit reads from standard input.
Files are created with a prefix of ``xx'' and two decimal digits. The size of each file is written to standard output as it is created. If
an error occurs whilst files are being created, or a HUP, INT, or TERM signal is received, all files previously written are removed.
The options are as follows:
-f prefix
Create file names beginning with prefix, instead of ``xx''.
-k Do not remove previously created files if an error occurs or a HUP, INT, or TERM signal is received.
-n number
Create file names beginning with number of decimal digits after the prefix, instead of 2.
-s Do not write the size of each output file to standard output as it is created.
The args operands may be a combination of the following patterns:
/regexp/[[+|-]offset]
Create a file containing the input from the current line to (but not including) the next line matching the given basic regular
expression. An optional offset from the line that matched may be specified.
%regexp%[[+|-]offset]
Same as above but a file is not created for the output.
line_no
Create containing the input from the current line to (but not including) the specified line number.
{num} Repeat the previous pattern the specified number of times. If it follows a line number pattern, a new file will be created for each
line_no lines, num times. The first line of the file is line number 1 for historic reasons.
After all the patterns have been processed, the remaining input data (if there is any) will be written to a new file.
Requesting to split at a line before the current line number or past the end of the file will result in an error.
ENVIRONMENT
The LANG, LC_ALL, LC_COLLATE and LC_CTYPE environment variables affect the execution of csplit as described in environ(7).
EXIT STATUS
The csplit utility exits 0 on success, and >0 if an error occurs.
EXAMPLES
Split the mdoc(7) file foo.1 into one file for each section (up to 21 plus one for the rest, if any):
csplit -k foo.1 '%^.Sh%' '/^.Sh/' '{20}'
Split standard input after the first 99 lines and every 100 lines thereafter:
csplit -k - 100 '{19}'
SEE ALSO sed(1), split(1), re_format(7)STANDARDS
The csplit utility conforms to IEEE Std 1003.1-2001 (``POSIX.1'').
HISTORY
A csplit command appeared in PWB UNIX.
BUGS
Input lines are limited to LINE_MAX (2048) bytes in length.
BSD February 6, 2014 BSD
Check Out this Related Man Page
csplit(1) General Commands Manual csplit(1)NAME
csplit - Splits files by context
SYNOPSIS
csplit [-f prefix] [-ks] [-nnumber] file | - arg1...argn
The csplit command reads the specified file (or standard input) and separates it into segments defined by the specified arguments. The
csplit command optionally prints the sizes, in bytes, of each file created.
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
csplit: XCU5.0
Refer to the standards(5) reference page for more information about industry standards and associated tags.
OPTIONS
Specifies the prefix name (xx by default) for the created file segments. Leaves previously created file segments intact in the event of an
error. By default, created files are removed if an error occurs. Uses number decimal digits to form file names for the file pieces. The
default is 2. Suppresses the display of file size messages.
OPERANDS
Specifies the text file to be split. If you specify - in place of the input file name, csplit reads from standard input.
The operands arg1...argn can be a combination of the following: Creates a file using the contents of the lines from the current line up to,
but not including, the line that results from the evaluation of the regular expression with an offset, if included. The offset argument
can be any integer (positive or negative) that represents a number of lines. A plus or minus sign is required. Has the same effect as
/pattern/, except that no segment file is created. Moves forward or backward the specified number of lines from the line matched by an
immediately preceding pattern argument (for example, /Page/-5). Creates a file containing the segment from the current line up to, but not
including, line_number, which becomes the current line. Repeats the preceding argument the specified number of times. This number can
follow any of the pattern or line_number arguments. If it follows a pattern argument, csplit reuses that pattern the specified number of
times. If it follows a line_number argument, csplit splits the file from that point every line_number of lines for number times.
DESCRIPTION
By default, csplit writes the file segments to files named xx00 ...xxn, where n is the number of arguments listed on the command line (n
may not be greater than 99). These new files get the following pieces of file: From the start of file up to, but not including, the line
referenced by the first argument. From the line referenced by the first argument up to the line referenced by the second argument. From
the line referenced by the last argument to the end of file.
The csplit command does not alter the original file, unless a generated file overwrites the original file.
Quote all pattern arguments that contain spaces or other characters special to the shell. Patterns may not contain embedded newline char-
acters.
[Tru64 UNIX] See the grep(1) reference page for information about creating patterns. In an expression such as [a-z], the dash means
"through" according to the current collating sequence. The collating sequence is determined by the value of the LC_COLLATE environment
variable.
Unless the -s option is specified, csplit writes one line, containing the file size in bytes, for each file created to standard output.
EXIT STATUS
The following exit values are returned: Successful completion. An error occurred.
Unless the -k option is used, any files created before the error was detected will be removed.
EXAMPLES
To split the text of a book into a separate file for each chapter, enter: csplit book "/^Chapter *[0-9]/" {9}
This creates files named xx00, xx01, xx02,...,xx09, which contain individual chapters of the file book. Each chapter begins with a
line that contains only the word Chapter and the chapter number. The file xx00 contains the front matter that comes before the
first chapter. The {9} after the pattern causes csplit to create up to 9 individual chapters; the remainder are placed in xx10. To
specify the prefix for the created file names, enter: csplit -f chap book "/^Chapter *[0-9]/" {9}
This splits book into files named chap00, chap01,...chap9, chap10.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of csplit: Provides a default value for the internationalization variables that
are unset or null. If LANG is unset or null, the corresponding value from the default locale is used. If any of the internationalization
variables contain an invalid setting, the utility behaves as if none of the variables had been defined. If set to a non-empty string
value, overrides the values of all the other internationalization variables. Determines the locale for the behavior of ranges, equivalence
classes, and multicharacter collating elements within regular expressions. Determines the locale for the interpretation of sequences of
bytes of text data as characters (for example, single-byte as opposed to multibyte characters in arguments and input files) and the behav-
ior of character classes within regular expressions. Determines the locale for the format and contents of diagnostic messages written to
standard error. Determines the location of message catalogues for the processing of LC_MESSAGES.
SEE ALSO
Commands: ed(1), grep(1), sed(1), sh(1b), sh(1p), split(1)
Files: regexp(3)
Standards: standards(5)csplit(1)