Project

General

Profile

Actions

Filter » History » Revision 4

« Previous | Revision 4/22 (diff) | Next »
Per Amundsen, 08/13/2014 10:09 AM


Added in 1.9.4

/filter [-asdfkwxnpriocteubglLz] [n-n2] [c s] <infile | dialog id> <outfile | dialog id | alias> [alias] <matchtext>

Scans lines of text in a window, file or dialog control, any matches are then written out to another window, file, or dialog control.
The order of the switch are important, they define what is the infile and what is the outfile, see the examples for more information.

The $filtered identifier will retrieve the number of matches found.

Switches

  1. w - indicates the parameter is a window
  2. f - indicates the parameter is a file
  3. a - sorts filtered lines by calling the optional [alias] parameter, the alias is passed two lines, $1 and $2, it must compare both and return -1, 0, or 1 to indicate relative sort order of these lines to each other
  4. x - excludes matching lines
  5. n - prefixes lines with a line number (the Nth match)
  6. d - TODO
  7. s - indicates the status window will be used
  8. p - TODO
  9. r - specifies the range of lines n to n2 for filtering
  10. b - strips BURK codes when matching text
  11. g - indicates the matchtext is a regular expression
  12. z - TODO
  13. k - indicates that you have specified an <alias> as the output instead of a window name. The alias will be called with the result of each filtered line with the form $<alias>($1) where $1 is the matched line
  14. i - indicates that you have provided a [dialog id] custom dialog control as the input
  15. o - indicates that you have provided a [dialog id] custom dialog control as the output
  16. c - switch clears the output window/file before writing to it
  17. t - TODO
  18. e - TODO
  19. u - TODO
  20. l - filters from the side-listbox in the first window
  21. L - filters to the side-listbox in the second window

Parameters

[n-n2] - if -r is used, indicates the range of lines to be scanned*
[c s] - if -t is used, indicates how to do the sort
<infile | dialog id> - if no switch implies a window's name to be use as the infile, you must provide an infile (a window, a file, or a dialog control)
<outfile | dialog id | alias> - if no switch implies a window's name to be used as the outfile, you must provide an outfile (a window, a file, a dialog control, or an alias name if -k is used)
[alias] - optional alias called if -a is used
<matchtext> - the expression used for the search, if $null is used, it matches everything.

;filter from the file "c:\my file.txt" to the custom window @mywin
/filter -fw "c:\my file.txt" @mywin *findthis*

;filter from the custom window @mywin to the file "c:\my file.txt" 
filter -wf @mywin "c:\my file.txt" *findthat*

;filter from the status window to the single message window
/filter -sd *findthis*

;filter from the single message window to the status window
/filter -ds *findthat*

;filter from the filename @this_is_a_file to the dialog 'dialog', id '1'
/filter -fo @this_is_a_file dialog 1 *findthis*

;filter from a file and call an alias for each line
/filter -fk file myalias *findthat*

;filter from a file to a file using regex
/filter -ffg file1 file2 /regex here/

Updated by Per Amundsen over 9 years ago · 4 revisions

Also available in: PDF HTML TXT