Content-type: text/html Man page of fmlcut

fmlcut

Section: FMLI Commands (1F)
Updated: 5 Jul 1990
Index Return to Main Contents
 

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 implements 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 characters 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 specified. 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 intervenes 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 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 attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWcsu

 

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.

ERROR: no delimiter

Missing char on -d option.

 

NOTES

fmlcut cannot correctly process lines longer than 1023 characters, or lines with no newline character.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
ATTRIBUTES
SEE ALSO
DIAGNOSTICS
NOTES

This document was created by man2html, using the manual pages.
Time: 02:38:39 GMT, October 02, 2010