DragonFly On-Line Manual Pages

Search: Section:  


SPLIT(1)               DragonFly General Commands Manual              SPLIT(1)

NAME

split -- split a file into pieces

SYNOPSIS

split -d [-a suffix_length] [-b byte_count[suffix]] [-l line_count] [-p pattern] [file [name]]

DESCRIPTION

The split utility reads the given file and breaks it up into files of 1000 lines each. If file is a single dash (`-') or absent, split reads from the standard input. The options are as follows: -a suffix_length Use suffix_length letters to form the suffix of the file name. -b byte_count[suffix] Create smaller files byte_count bytes in length. An optional suffix (as documented in dehumanize_number(3)) is supported. -d Use a numeric suffix instead of a alphabetic suffix. -l line_count Create smaller files n lines in length. -p pattern The file is split whenever an input line matches pattern, which is interpreted as an extended regular expression. The matching line will be the first line of the next output file. This option is incompatible with the -b and -l options. If additional arguments are specified, the first is used as the name of the input file which is to be split. If a second additional argument is specified, it is used as a prefix for the names of the files into which the file is split. In this case, each file into which the file is split is named by the prefix followed by a lexically ordered suffix using suffix_length characters in the range ``a-z''. If -a is not specified, two letters are used as the suffix. If the name argument is not specified, the file is split into lexically ordered files named with prefix ``x'' and with suffixes as above.

SEE ALSO

re_format(7)

STANDARDS

The split utility conforms to IEEE Std 1003.1-2001 (``POSIX.1'').

HISTORY

A split command appeared in Version 3 AT&T UNIX.

BUGS

The maximum line length for matching patterns is 65536. DragonFly 3.5 May 25, 2013 DragonFly 3.5 split(n) Tcl Built-In Commands split(n) ______________________________________________________________________________

NAME

split - Split a string into a proper Tcl list

SYNOPSIS

split string ?splitChars? ______________________________________________________________________________

DESCRIPTION

Returns a list created by splitting string at each character that is in the splitChars argument. Each element of the result list will consist of the characters from string that lie between instances of the characters in splitChars. Empty list elements will be generated if string contains adjacent characters in splitChars, or if the first or last character of string is in splitChars. If splitChars is an empty string then each character of string becomes a separate element of the result list. SplitChars defaults to the standard white-space characters.

EXAMPLES

Divide up a USENET group name into its hierarchical components: split "comp.lang.tcl" . -> comp lang tcl See how the split command splits on every character in splitChars, which can result in information loss if you are not careful: split "alpha beta gamma" "temp" -> al {ha b} {} {a ga} {} a Extract the list words from a string that is not a well-formed list: split "Example with {unbalanced brace character" -> Example with \{unbalanced brace character Split a string into its constituent characters split "Hello world" {} -> H e l l o { } w o r l d PARSING RECORD-ORIENTED FILES Parse a Unix /etc/passwd file, which consists of one entry per line, with each line consisting of a colon-separated list of fields: ## Read the file set fid [open /etc/passwd] set content [read $fid] close $fid ## Split into records on newlines set records [split $content "\n"] ## Iterate over the records foreach rec $records { ## Split into fields on colons set fields [split $rec ":"] ## Assign fields to variables and print some out... lassign $fields \ userName password uid grp longName homeDir shell puts "$longName uses [file tail $shell] for a login shell" }

SEE ALSO

join(n), list(n), string(n)

KEYWORDS

list, split, string Tcl split(n)

Search: Section: