User Commands cut(1) NAME cut - cut out selected fields of each line of a file SYNOPSIS /usr/bin/cut /usr/bin/cut [ options ] [file ...] ksh93 cut [ options ] [file ...] DESCRIPTION cut bytes, characters, or character-delimited fields from one or more files, contatenating them on standard output. The option argument list is a comma-separated or blank-separated list of positive numbers and ranges. Ranges can be of three forms. The first is two positive integers separated by a hyphen (low-high), which represents all fields from low to high. The second is a positive number preceded by a hyphen (-high), which represents all fields from field 1 to high. The last is a positive number followed by a hyphen (low-), which represents all fields from low to the last field, inclusive. Elements in the list can be repeated, can overlap, and can appear in any order. The order of the output is that of the input. One and only one of -b, -c, or -f must be specified. If no file is given, or if the file is -, cut cuts from standard input. The start of the file is defined as the current offset. OPTIONS The following options are supported: -b, --bytes=list cut based on a list of bytes. -c, --characters=list cut based on a list of characters. -d, --delimiter=delim The field character for the -f option is set to delim. The default is the tab character. -f, --fields=list cut based on fields separated by the delimiter character specified with the -d optiion. -n, --nosplit Do not split characters. -R|r, --reclen=reclen If reclen > 0, the input will be read as fixed length records of length reclen when used with the -b or -c option. -s, --suppress|only-delimited Suppress lines with no delimiter characters, when used with the -f option. By default, lines with no delimiters will be passsed in untouched. -D, --line-delimeter|output-delimiter=ldelim The line delimiter character for the -f option is set to ldelim. The default is the newline character. -N, --nonewline Do not output new-lines at end of each record when used with the -b or -c option. --man, --html, --nroff Prints builtin manual page in either plain text, HTML or nroff format. --help Prints basic help information --version Prints version information OPERANDS The following operands are supported: file A path name of an input file. If no file operands are specified, or if a file operand is -, the standard input will be used. USAGE See largefile(5) for the description of the behavior of cut when encountering files greater than or equal to 2 Gbyte (2 **31 bytes). EXAMPLES Example 1: Mapping user IDs A mapping of user IDs to names follows: example% cut -d: -f1,5 /etc/passwd SunOS 5.10 Last change: 29 Apr 1999 2 User Commands cut(1) Example 2: Setting current login name To set name to current login name: example$ name=$(who am i | cut -f1 -d' ') ENVIRONMENT VARIABLES See environ(5) for descriptions of the following environment variables that affect the execution of cut: LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, and NLSPATH. EXIT STATUS The following exit values are returned: 0 All input files were output successfully. >0 An error occurred. ATTRIBUTES See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWcsu | |_____________________________|_____________________________| | CSI | Enabled | |_____________________________|_____________________________| | Interface Stability | Standard | |_____________________________|_____________________________| SEE ALSO grep(1), paste(1), ksh93(1), attributes(5), environ(5), largefile(5), standards(5) SunOS 5.10 Last change: 29 Apr 1999 4