TSORT v2.00 - field oriented sorting |
Revised 2-Jan-99. Copyright (c) 1996-99 by Rune Berg. TextTools Freeware. |
Usage | Description | Example | Options | Limitations | Return Codes | Version History | tt_r6
Usage | Top | Next |
tsort [log logfile] [options] [from infile] [to outfile] expr [...]
Description | Top | Previous | Next |
tsort sorts infile on the results of the given expression(s), and writes the sorted data to outfile. Expressions are as for tcols.
infile must be an ASCII text file. tsort sees each input line as a row of (by default) whitespace-separated fields; see tcols for more info.
tsort ignores empty (whitespace only) input lines.
tsort compares data the same way as trows does.
tsort retains the relative order of lines for which the expressions evaluate the same.
The output lines are identical to the input lines. tsort only changes their order.
If you don't specify infile, tsort reads from standard input.
If you don't specify outfile, tsort writes to standard output.
If you don't specify logfile, tsort writes error messages to standard
error.
Example | Top | Previous | Next |
Consider the file "records.txt":
Band "The Band" 1969 "Violent Femmes" "Violent Femmes" 1983 Beatles Revolver 1966 Beatles "Rubber Soul" 1965 "Waits, Tom" Swordfishtrombones 1983 Band "Music From Big Pink" 1968
The command:
tsort from records.txt $1.duqt $3
sorts the records on band/artist name (stripped of surrounding double quotes) and further on year of release, printing:
Band "Music From Big Pink" 1968 Band "The Band" 1969 Beatles "Rubber Soul" 1965 Beatles Revolver 1966 "Violent Femmes" "Violent Femmes" 1983 "Waits, Tom" Swordfishtrombones 1983
Options | Top | Previous | Next |
tsort recognizes the following command line options:
Option | Function |
---|---|
-iC | Separate input fields by character C (except \). Use \t to form a tab. |
-d | Sort on descending values. |
-r | Print a one-line report after processing. |
-fppN | Use floating-point precision N (0..15, default 6) decimal digits for
internal representation and comparisons. See separate discussion on floating point numbers for more details. |
-he | Print summary of expression usage to standard output, then exit. |
-hfc | Print summary of character functions to standard output, then exit. |
-hfs | Print summary of string functions to standard output, then exit. |
-hfv | Print summary of conversion functions to standard output, then exit. |
-hfm | Print summary of maths functions to standard output, then exit. |
-hfx | Print summary of miscellanous functions to standard output, then exit. |
-hf name | Print summary of named function to standard output, then exit. |
-v | Print banner with version number to standard error (or logfile, if used), then exit. |
Limitations | Top | Previous | Next |
tsort has the same limitations as tcols.
tsort runs out of memory when infile, or the expressions evaluated thereof, are too large.
Return Codes | Top | Previous | Next |
tsort returns with one of the following codes ("error levels"):
Code | Meaning |
---|---|
0 | Success |
101 | Out of memory |
102 | Incorrect command line arguments |
104 | Error opening file |
105 | I/O error |
106 | Capacity overrun |
107 | File name clash |
109 | Bad input data |
Version History | Top | Previous |
These are the released versions:
Version | Date | Changes |
---|---|---|
1.10 | 25-Feb-96 | n/a |
1.20 | 13-May-96 | * New function .nl : append newline char. * New function .prf : print formatted. * New function .tr : trim leading and trailing blanks. |
1.30 | 24-Sep-96 | * New expression $n : yields current data line number. * New expression $e(/NAME/) : yields value of environment variable. * New function .dup(n) : yields n duplicates of what it's applied to. * Improved function .prf : now does field width, left-just., integers, etc. * Improved functions .trl .trt .tr : they now trim any whitespace, not just blanks. |
1.40 | 23-Feb-97 | * Available as Win32 console mode version. * Increased capacity and speed. |
1.50 | 21-Jun-97 | * Gives proper return codes. |
2.00 | 2-Jan-99 | * Supports floating point numbers. * New functions .cc & family: various forms of character replacement. * New functions .dc & family: various forms of character deletion. * New option -r : one-line report. * Win32 version has increased max. input line length / fields per line. * Win32 version has coloured response texts. * New options -hfc -hfs -hfv -hfm -hfx : these replace the -hf option. |
End of document |