helpTextVerbose
immutable
auto helpTextVerbose =
q"EOS
Synopsis: tsv-filter [options] [file...]
Filter lines of tab-delimited files via comparison tests against fields. Multiple
tests can be specified, by default they are evaluated as AND clause. Lines
satisfying the tests are written to standard output.
Typical test syntax is '--op field:value', where 'op' is an operator, 'field' is a
1-based field index, and 'value' is the comparison basis. For example, '--lt 3:500'
tests if field 3 is less than 500. A more complete example:
tsv-filter --header --gt 1:50 --lt 1:100 --le 2:1000 data.tsv
This outputs all lines from file data.tsv where field 1 is greater than 50 and less
than 100, and field 2 is less than or equal to 1000. The header is also output.
Field lists can be used to specify multiple fields at once. For example:
tsv-filter --not-blank 1-10 --str-ne 1,2,5:'--' data.tsv
tests that fields 1-10 are not blank and fields 1,2,5 are not "--".
Tests available include:
* Test if a field is empty (no characters) or blank (empty or whitespace only).
* Test if a field is interpretable as a number, a finite number, NaN, or Infinity.
* Compare a field to a number - Numeric equality and relational tests.
* Compare a field to a string - String equality and relational tests.
* Test if a field matches a regular expression. Case sensitive or insensitive.
* Test if a field contains a string. Sub-string search, case sensitive or insensitive.
* Test a field's character or byte length.
* Field to field comparisons - Similar to the other tests, except comparing
one field to another in the same line.
Details:
* The run is aborted if there are not enough fields in an input line.
* Numeric tests will fail and abort the run if a field cannot be interpreted as a
number. This includes fields with no text. To avoid this use '--is-numeric' or
'--is-finite' prior to the numeric test. For example, '--is-numeric 5 --gt 5:100'
ensures field 5 is numeric before running the --gt test.
* Regular expression syntax is defined by the D programming language. They follow
common conventions (perl, python, etc.). Most common forms work as expected.
Options:
EOS";
tsv_utils tsv_filter
aliasesfunctionsstatic variablesstructsvariables