EVL

Table of Contents


Products, services and company names referenced in this document may be either trademarks or registered trademarks of their respective owners.

Copyright © 2017–2020 EVL Tool, s.r.o.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts.

Map

(since EVL 1.0)

Map input columns to output ones.

Map

is to be used in EVS job structure definition file. <f_in> and <f_out> are either input and output file or flow name.

evl map

is intended for standalone usage, i.e. to be invoked from command line and reading records from standard input and writing to standard output.

EVD, EVM and EVS are EVL definition files, for details see evl-evd(5), evl-evm(5) and evl-evs(5).

Synopsis

syntax/Map
Map
  <f_in> <f_out> (<evd_in>|-D <inline_evd>) (<evd_out>|-d <inline_evd>) <evm>
  [-x|--text-input] [-y|--text-output]
  [-o <f_out>] [--output<n>=<f_out>]... [--outputs=<varname>]
  [--reject <f_out>] [--reject<n>=<f_out>]... [--rejects=<varname>]

evl map
  (<evd_in>|-D <inline_evd>) (<evd_out>|-d <inline_evd>) <evm>
  [-x|--text-input] [-y|--text-output]
  [-o <f_out>] [--output<n>=<f_out>]... [--outputs=<varname>]
  [--reject=<f_out>] [--reject<n>=<f_out>]... [--rejects=<varname>]
  [--verbose]

evl map
  ( --help | --usage | --version )

Options

-D, --input-definition=<inline_evd>

either this option or the file <evd_in> must be presented. Example: ‘-D 'id int, user_id string'

-d, --output-definition=<inline_evd>

either this option or the file <evd_out> must be presented. Example: ‘-d 'user_sum long'

-o, --output=<f_out>

when ‘output()’ function is used in the mapping, out structure is forwarded into <f_out>

--output<n>=<f_out>

when function ‘output(<n>)’ is used in mapping, where <n> is an integer from 4 to 16, out structure is forwarded into <f_out>

--outputs=<varname>

specifies an array ‘${<varname>[@]}’ which contains filenames to be used for ‘output(N)’ functions in mapping. Example: for ‘--outputs=OUTFILE’, ‘${OUTFILE[120]}’ is the filename used for ‘output(120)

--reject=<f_out>

when ‘reject()’ function is used in the mapping, input record is rejected into <f_out>

--reject<n>=<f_out>

when function ‘reject(<n>)’ is used in mapping, where <n> is an integer from 4 to 16, input record is rejected into <f_out>

--rejects=<varname>

specifies an array ‘${<varname>[@]}’ which contains filenames to be used for ‘reject(N)’ functions in mapping. Example: for ‘--rejects=REJECTS’, ‘${REJECTS[1000]}’ is the filename used for ‘reject(1000)

-x, --text-input

suppose the input as text, not binary

-y, --text-output

write the output as text, not binary

Standard options:

--help

print this help and exit

--usage

print short usage information and exit

-v, --verbose

print to stderr info/debug messages of the component

--version

print version and exit