fmlcut(1f) [sunos man page]

fmlcut(1F)							   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 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 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 characters, or lines with no newline character.

SunOS 5.10							    5 Jul 1990								fmlcut(1F)

Check Out this Related Man Page

CUT(1)							    BSD General Commands Manual 						    CUT(1)

NAME

     cut -- select portions of each line of a file

SYNOPSIS

     cut -b list [-n] [file ...]
     cut -c list [file ...]
     cut -f list [-d delim] [-s] [file ...]

DESCRIPTION

     The cut utility selects portions of each line (as specified by list) from each file and writes them to the standard output.  If the file
     argument is a single dash ('-') or no file arguments were specified, lines are read from the standard input.  The items specified by list can
     be in terms of column position or in terms of fields delimited by a special character.  Column numbering starts from 1.

     list is a comma or whitespace separated set of increasing numbers and/or number ranges.  Number ranges consist of a number, a dash (-), and a
     second number and select the fields or columns from the first number to the second, inclusive.  Numbers or number ranges may be preceded by a
     dash, which selects all fields or columns from 1 to the first number.  Numbers or number ranges may be followed by a dash, which selects all
     fields or columns from the last number to the end of the line.  Numbers and number ranges may be repeated, overlapping, and in any order.	It
     is not an error to select fields or columns not present in the input line.

     The options are as follows:

     -b list	 The list specifies byte positions.

     -c list	 The list specifies character positions.

     -d string	 Use the first character of string as the field delimiter character.  The default is the <TAB> character.

     -f list	 The list specifies fields, separated by the field delimiter character.  The selected fields are output, separated by the field
		 delimiter character.

     -n 	 Do not split multi-byte characters.

     -s 	 Suppresses lines with no field delimiter characters.  Unless specified, lines with no delimiters are passed through unmodified.

EXIT STATUS

     cut exits 0 on success, 1 if an error occurred.

SEE ALSO

     paste(1)

STANDARDS

     The cut utility conforms to IEEE Std 1003.2-1992 (``POSIX.2'').

BSD
								 December 21, 2008							       BSD

Linux and UNIX Man Pages

fmlcut(1f) [sunos man page]

Check Out this Related Man Page