exfld — Apollo

1.1;exfld (extract_fields), revision 1.1, 81/07/01
EXFLD (EXTRACT_FIELDS) -- Manipulate fields of data.
usage:  EXFLD {field-list | -T [c]} output_format [pathname ...]


FORMAT

  EXFLD {field_spec} output_format [pathname ...]


  EXFLD  manipulates  data  kept  in  formatted  fields.    It  copies data from
  specified fields of the input files to specified places in standard output.


ARGUMENTS

  field_spec
  (required)         Specify either one of the following two arguments:

  field_list
                    Integer list identifying fields in  the  input  file  to  be
                     copied.  Up to 9 input fields are allowed.  You can specify
                     a field by the  columns  in  which  it  occurs  or  by  its
                     starting  column  and  length.  For example, 5-10 denotes a
                     field that extends from column 5 through column 10, and 3+2
                     denotes  a  field  that  starts  in  column  3  and spans 2
                     columns.  When specifying more than one field, separate the
                     specifications with commas, for example:

                          5-10,16,72+8

                     Fields  can overlap, and need not be in ascending numerical
                     order.  Thus

                          1-25,10,3

                     is a valid field specification.

  -T [c]
                    Free-format separator specification.  If input fields do not
                     fall  in  certain columns, but rather are separated by some
                     character (such as a blank or a comma), describe the fields
                     by  using  '-T  c',  replacing  'c'  with  the  appropriate
                     separator.  A tab character is the default for 'c'.

  output_format
  (required)         Specify literal string representing output format.   Fields
                     from  input  are  referred  to as $1, $2, $3, and so forth,
                     denoting the order in which the fields are specified.    Up
                     to  9 fields are allowed, plus the argument $0 which refers
                     to the whole line.  Place  the  $n  symbol  in  the  output
                     format  wherever  the  corresponding  field  should appear,
                     surrounded by  any  characters  desired.  For  example,  an
                     output format of:

                          "$2 somewords $1"

                     would produce an output line such as:

                           field2 somewords field1

  pathname
  (optional)         Specify input file to be manipulated.

                     Default if omitted:  read standard input


EXAMPLES

  $ exfld 1-5,14-18 "$2 follows $1"        Specify extraction.
  ABCDE is not DEFGH                       Input text from standard input.
  DEFGH follows ABCDE                      Result.
  *** EOF ***                              Signal completion with CTRL/Z.
  $
Museum
