📄 csplit.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>csplit</title></head><body bgcolor=white><center><font size=2>The Single UNIX ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_001_014_244"> </a>NAME</h4><blockquote>csplit - split files based on context</blockquote><h4><a name = "tag_001_014_245"> </a>SYNOPSIS</h4><blockquote><pre><code>csplit <b>[</b>-ks<b>][</b>-f <i>prefix</i><b>][</b>-n <i>number</i><b>] </b><i>file arg1</i> ...<i>argn</i></code></pre></blockquote><h4><a name = "tag_001_014_246"> </a>DESCRIPTION</h4><blockquote>The<i>csplit</i>utility reads the file named by the<i>file</i>operand, writes all or part of that fileinto other files as directed by the<i>arg</i>operands, and writes the sizes of the files.</blockquote><h4><a name = "tag_001_014_247"> </a>OPTIONS</h4><blockquote>The<i>csplit</i>utility supports the <b>XBD</b> specification, <a href="../xbd/utilconv.html#usg"><b>Utility Syntax Guidelines</b> </a> .<p>The following options are supported:<dl compact><dt><b>-f </b><i>prefix</i><dd>Name the created files<i>prefix</i><b>00</b>,<i>prefix</i><b>01</b>,...,<i>prefixn</i>.The default is <b>xx00</b> ...<b>xx</b><i>n</i>.If the<i>prefix</i>argument would create a filename exceeding{NAME_MAX}bytes, an error will result,<i>csplit</i>will exit with a diagnostic messageand no files will be created.<dt><b>-k</b><dd>Leave previously created files intact.By default,<i>csplit</i>will remove created files if an error occurs.<dt><b>-n </b><i>number</i><dd>Use<i>number</i>decimal digits to form filenames for the file pieces.The default is 2.<dt><b>-s</b><dd>Suppress the output of file size messages.</dl></blockquote><h4><a name = "tag_001_014_248"> </a>OPERANDS</h4><blockquote>The following operands are supported:<dl compact><dt><i>file</i><dd>The pathname of a text file to be split.If<i>file</i>is "-", the standard input will be used.</dl><p>The operands<i>arg1</i>...<i>argn</i>can be a combination of the following:<dl compact><dt>/<i>rexp</i>/<b>[</b><i>offset</i><b>]</b><dd>Create a file using the content of the linesfrom the current line up to, but not including,the line that results from the evaluation of theregular expression with<i>offset</i>,if any, applied.The regular expression<i>rexp</i>must follow the rules forbasic regular expressions described inthe <b>XBD</b> specification, <a href="../xbd/re.html#tag_007_003"><b>Basic Regular Expressions</b> </a> .The optional<i>offset</i>must be a positive or negative integer value representing a number of lines.The integer value must be preceded by "+" or "-".If the selection of lines from an offset expression of this typewould create a file with zero lines, or one withgreater than the number of lines left in the input file, theresults are unspecified.After the section is created,the current line will be set to the line that resultsfrom the evaluation of the regular expression with anyoffset applied.The pattern match of<i>rexp</i>always is applied from the current lineto the end of the file.<dt>%<i>rexp</i>%<b>[</b><i>offset</i><b>]</b><dd>This operand is the same as/<i>rexp</i>/<b>[</b><i>offset</i><b>]</b>,except thatno file will be created for theselected section of the input file.<dt><i>line_no</i><dd>Create a file from the current line up to(but not including) the line number<i>line_no</i>.Lines in the file will be numbered starting at one.The current line becomes<i>line_no</i>.<dt><b>{</b><i>num</i><b>}</b><dd>Repeat operand.This operand can follow any of the operands described previously.If it follows a<i>rexp</i>type operand, that operand will be applied<i>num</i>more times.If it follows a<i>line_no</i>operand, the file will be split every<i>line_no</i>lines,<i>num</i>times, from that point.</dl><p>An error will be reported if an operand does not reference a linebetween the current position and the end of the file.</blockquote><h4><a name = "tag_001_014_249"> </a>STDIN</h4><blockquote>See the INPUT FILES section.</blockquote><h4><a name = "tag_001_014_250"> </a>INPUT FILES</h4><blockquote>The input file must be a text file.</blockquote><h4><a name = "tag_001_014_251"> </a>ENVIRONMENT VARIABLES</h4><blockquote>The following environment variables affect the execution of<i>csplit</i>:<dl compact><dt><i>LANG</i><dd>Provide a default value for the internationalisation variablesthat are unset or null.If<i>LANG</i>is unset or null, the corresponding value from theimplementation-dependent default locale will be used.If any of the internationalisation variables contains an invalid setting, theutility will behave as if none of the variables had been defined.<dt><i>LC_ALL</i><dd>If set to a non-empty string value,override the values of all the other internationalisation variables.<dt><i>LC_COLLATE</i><dd>Determine the locale for thebehaviour of ranges, equivalence classesand multi-character collating elementswithin regular expressions.<dt><i>LC_CTYPE</i><dd>Determine thelocale for the interpretation of sequences of bytes of text data ascharacters (for example, single- as opposed to multi-byte charactersin arguments and input files) andthe behaviour of character classes within regular expressions.<dt><i>LC_MESSAGES</i><dd>Determine the locale that should be used to affectthe format and contents of diagnosticmessages written to standard error.<dt><i>NLSPATH</i><dd>Determine the location of message cataloguesfor the processing of<i>LC_MESSAGES .</i></dl></blockquote><h4><a name = "tag_001_014_252"> </a>ASYNCHRONOUS EVENTS</h4><blockquote>If the<b>-k</b>option is specified, created files will be retained.Otherwise the default action occurs.</blockquote><h4><a name = "tag_001_014_253"> </a>STDOUT</h4><blockquote>Unless the<b>-s</b>option is used, the standard output will consist of one line per file created,with a format as follows:<p><code><tt>"%d\n"</tt>, <<i>file size in bytes</i>></code></blockquote><h4><a name = "tag_001_014_254"> </a>STDERR</h4><blockquote>Used only for diagnostic messages.</blockquote><h4><a name = "tag_001_014_255"> </a>OUTPUT FILES</h4><blockquote>The output files will contain portions of the original input file, otherwiseunchanged.</blockquote><h4><a name = "tag_001_014_256"> </a>EXTENDED DESCRIPTION</h4><blockquote>None.<br></blockquote><h4><a name = "tag_001_014_257"> </a>EXIT STATUS</h4><blockquote>The following exit values are returned:<dl compact><dt>0<dd>Successful completion.<dt>>0<dd>An error occurred.</dl></blockquote><h4><a name = "tag_001_014_258"> </a>CONSEQUENCES OF ERRORS</h4><blockquote>By default, created files will be removed if an error occurs.When the<b>-k</b>option is specified, created files will not be removedif an error occurs.</blockquote><h4><a name = "tag_001_014_259"> </a>APPLICATION USAGE</h4><blockquote>None.</blockquote><h4><a name = "tag_001_014_260"> </a>EXAMPLES</h4><blockquote><ol><p><li>This example creates four files, <b>cobol00</b> ... <b>cobol03</b>:<pre><code>csplit -f cobol file '/procedure division/' /par5./ /par16./</code></pre><p>After editing the split files, they can be recombined as follows:<pre><code>cat cobol0[0-3] > file</code></pre><p>Note that this example overwrites the original file.<p><li>This example would split the file after the first 99 lines,and every 100 lines thereafter, up to 9999 lines;this is because lines in the file are numbered from 1rather than zero, for historical reasons:<pre><code>csplit -k file 100 {99}</code></pre><p><li>Assuming that<b>prog.c</b>follows the C-languagecoding convention of ending routines with a"}"at the beginning of the line,this example will create a file containing each separateC routine (up to 21) in<b>prog.c</b>:<pre><code>csplit -k prog.c '%main(%' '/^}/+1' {20}</code></pre><p></ol></blockquote><h4><a name = "tag_001_014_261"> </a>FUTURE DIRECTIONS</h4><blockquote>The IEEE PASC 1003.2 Interpretations Committee has forwarded concerns about parts of this interface definition to the IEEE PASC Shell and Utilities Working Groupwhich is identifying the corrections.A future revision of this specification will align withIEEE Std. 1003.2b when finalised.</blockquote><h4><a name = "tag_001_014_262"> </a>SEE ALSO</h4><blockquote><i><a href="sed.html">sed</a></i>,<i><a href="split.html">split</a></i>.</blockquote><hr size=2 noshade><center><font size=2>UNIX ® is a registered Trademark of The Open Group.<br>Copyright © 1997 The Open Group<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]</font></center><hr size=2 noshade></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -