


      CSPLIT(1)                   (UNIX 5.0)                  CSPLIT(1)



      NAME
           csplit - context split

      SYNTAX
           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.
8                       .
8                       .
8                       .
                 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


9      Page 1                                          (73 A2 02MT REV1)






      CSPLIT(1)                   (UNIX 5.0)                  CSPLIT(1)



                         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.

      EXAMPLES
                split -f cobol file  '/procedure division/'  /par5./  /par16./

           This example 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}

           This example would split 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.







      Page 2                                          (73 A2 02MT REV1)



