helpText
immutable
auto helpText =
q"EOS
Synopsis: tsv-select [options] [file...]
tsv-select reads files or standard input and writes selected fields to
standard output. Fields are written in the order listed. This is similar
to Unix 'cut', but with the ability to reorder fields.
Fields can be specified by field number or, for files with header lines,
by field name. Use '--H|header' to enable selection by name. This also
manages header lines from multiple files, retaining only the first header.
Field numbers start with one. The field list is comma separated. Ranges
can be used, and wildcards can be used when specifying fields by name.
Fields can be dropped using '--e|exclude'. Fields not included in the
'--f|fields' option can be selected as a group using '--r|rest'.
Examples:
# Selecting fields. Output is in the order listed
tsv-select -H date,time file.tsv
tsv-select -f 2,1 file.tsv
tsv-select -f 5-7,2,9-11
tsv-select -H -f '*_date' file.tsv
# Dropping fields
tsv-select --exclude 1 file.tsv
tsv-select -H -e date,time file.tsv
# Move fields to the front or the back
tsv-select -f 1 --rest first file.tsv # Move field 1 to the end
tsv-select -H -f date --rest last # Move 'date' field to the front
# Read multiple files, keep the header from only the first
tsv-select data*.tsv -H --fields 1,2,4-7,14
Use '--help-verbose' for detailed information. Use '--help-fields' for
details about field lists and field names.
Options:
EOS";
tsv_utils tsv_select
enumsfunctionsstatic variablesstructsvariables