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
                 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.

     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.


Man(1) output converted with man2html