manpages.info - online man pages   

SunOS man pages : fmlcut (1)

FMLI Commands                                          fmlcut(1F)

NAME

fmlcut - cut out selected fields of each line of a file

SYNOPSIS

fmlcut -clist [ filename ... ] fmlcut -flist [ -dchar ] [ -s ] [ filename ... ]

DESCRIPTION

The fmlcut function cuts out columns from a table or fields from each line in filename; in database parlance, it imple- ments the projection of a relation. fmlcut can be used as a filter; if filename is not specified or is -, the standard input is read. list specifies the fields to be selected. Fields can be fixed length (character positions) or variable length (separated by a field delimiter character), depending on whether -c or -f is specified. Note: Either the -c or the -f option must be specified.

OPTIONS

list A comma-separated list of integer field numbers (in increasing order), with optional - to indicate ranges. For example: 1,4,7; 1-3,8; -5,10 (short for 1-5,10); or 3- (short for third through last field). -clist If -c is specified, list specifies character positions (for instance, -c1-72 would pass the first 72 charac- ters of each line). Note: No space intervenes between -c and list. -flist If -f is specified, list is a list of fields assumed to be separated in the file by the default delimiter character, TAB, or by char if the -d option is speci- fied. For example, -f1,7 copies the first and seventh field only. Lines with no delimiter characters are passed through intact (useful for table subheadings), unless -s is specified. Note: No space intervenes between -f and list. The following options can be used if you have specified -f. -dchar If -d is specified, char is the field delimiter. Space or other characters with special meaning to FMLI must be quoted. Note: No space inter- venes between -d and char . The default field delimiter is TAB. -s Suppresses lines with no delimiter characters. If -s is not specified, lines with no delimiters SunOS 5.8 Last change: 5 Jul 1990 1 FMLI Commands fmlcut(1F) will be passed through untouched.

EXAMPLES

Example 1: Getting login IDs and names The following example gets the login IDs and names. example% fmlcut -d: -f1,5 /etc/passwd Example 2: Getting the current login name The next example gets the current login name. example% `who am i | fmlcut -f1 -d" "`

ATTRIBUTES

See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWcsu | |_____________________________|_____________________________|

SEE ALSO

fmlgrep(1F), attributes(5)

DIAGNOSTICS

fmlcut returns the following exit values: 0 when the selected field is successfully cut out 2 on syntax errors The following error messages may be displayed on the FMLI message line: ERROR: line too long A line has more than 1023 characters or fields, or there is no new-line character. ERROR: bad list for c/f option Missing -c or -f option or incorrectly specified list. No error occurs if a line has fewer fields than the list calls for. ERROR: no fields The list is empty. SunOS 5.8 Last change: 5 Jul 1990 2 FMLI Commands fmlcut(1F) ERROR: no delimiter Missing char on -d option.

NOTES

fmlcut cannot correctly process lines longer than 1023 char- acters, or lines with no newline character. SunOS 5.8 Last change: 5 Jul 1990 3