FEX(1)

NAME
fex - simple and powerful field extraction

SYNOPSIS
fex selector ...

DESCRIPTION
fex helps you split things by field. Common tasks you might do with awk or cut are much simpler in fex, and there are things in fex you can't do nearly as easily in awk or cut.

SELECTOR SYNTAX
The selector syntax looks like this:

  <delimiter><selection>...

The delimiter is a single character that is used to split the input string.

The first delimiter is implied as space ' '. You can specify multiple fields with curly braces and numbers split by commas. Also valid in curly braces {} are number ranges. Number ranges are similar to python array slices, split by colon.

The selection is one of the following and is used to choose fields split by the delimiter.

a single number
    A single number will select that numbered field. Like awk, field start at 1.

    Example selecting third field:

      % echo "a b c d e" | fex '3'
      c

    Example selecting the second field delimited by slash:

      % echo "/home/hello/world" | fex '/2'
      hello

{N:M}
    This is a range selection. The syntax for ranges is, in curly braces, N:M, which chooses the fields in range N to M, inclusive.

    Example selecting first through fourth fields:

      % echo "a b c d e" | fex '{1:4}'
      a b c d

{N,M,...}
    The syntax for multiple selections is numbers within curly braces.

    Example selecting first and fifth fields:

      % echo "a b c d e" | fex '{1,5}'
      a e

{range,field,field,range,field}
    Combining the above, you can actually select ranges and individual fields using the {...} syntax by delimiting each selection by comma.

    Example selecting fields 1 to 3, and 5: {1:3,5}

      % echo "a b c d e" | fex '{1:3,5}'
      a b c e

{?range,field,...}
    The {?...} notation turns on 'non greedy' field separation. The differences here can be shown best by example, first:

      % echo "1...2.3.4" | fex '.{1:3}'
      1.2.3
      % echo "1...2.3.4" | fex '.{?1:3}'
      1..

    In the first example, fex uses '.' as delimiter and ignores empty fields. In the second example (non greedy), it does not ignore those empty fields.

/regexp/
    The /regexp/ selection will choose only fields that match the given pattern.

    Example, pulling out words with 'addr:' in it from 'ifconfig' output:

      % ifconfig | fex ' /addr:[0-9]/'
      addr:127.0.0.1
      addr:192.168.0.28

EXAMPLES

Show the MTU for a given interface
    The 'mtu' in ifconfig output looks like 'mtu:1500'. So have fex split by space, then grab fields matching /mtu:/, split by colon, and choose the last field.

      % ifconfig wlan0 | fex ' /mtu:/:-1'
      1500

Parse apache logs
    Pull the IP address (first field by space) and the path requested (2nd field in "GET <path> ...")

        % fex 1 '"2 2' < /b/logs/access
        65.57.245.11 /
        65.57.245.11 /icons/blank.gif
        65.57.245.11 /icons/folder.gif

SEE ALSO
awk(1), cut(1),

Project site: <http://www.semicomplete.com/projects/fex>

Source Code: <https://github.com/jordansissel/fex>

CONTACT
Please send questions to jls@semicomplete.com

File bugs and feature requests at the following URL:

<https://github.com/jordansissel/fex/issues>

Alternately, if you prefer email, feel free to file bugs by email. Whatever works for you :)

Patches, ideas, and other contributions by many, nice folks. See the CHANGELIST file for who provided what.

AUTHOR
fex was written by Jordan Sissel.