From WikiChip
mirc/commands/filter
< mirc‎ | commands
Revision as of 19:52, 22 December 2013 by Ouims (talk | contribs) (Parameters)

The /filter command scans lines of text in a window or file, or dialog control, and if any of them matcht the matchext, they are written out to another window or file, or another dialog control which you can then use. The order of the switch are important, they define what is the infile and what is the outfile, see the examples for more informations. You can filter blank lines by specifying $crlf for the matchtext. /filter also fills the $filtered identifier with the number of matches found, if any.

Synopsis

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

Switches

  • -w - indicates the parameter is a window
  • -f - indicates the parameter is a file
  • -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
  • -x - excludes matching lines
  • -n - prefixes lines with a line number (the Nth match)
  • -d - indicates the single message window will be used
  • -s - indicates the status window will be used
  • -p - wraps the text output in a custom window
  • -r - specifies the range of lines n to n2 for filtering
  • -b - strips BURK codes when matching text
  • -g - indicates the matchtext is a regular expression
  • -z - retains line colors when filtering between custom windows
  • -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
  • -i - indicates that you have provided a [dialog id] custom dialog control as the input
  • -o - indicates that you have provided a [dialog id] custom dialog control as the output
  • -c - switch clears the output window/file before writing to it
  • -t - switch sorts the output based on [c s], column C using character S as the columns separator
  • -e - used with -t, specifies a descending sort
  • -u - used with -t, specifies a numeric sort
  • -l - filters from the side-listbox in the first window
  • -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 uses * for a wildcard match but $null for a regex match.

Example

;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/

Compatibility

Added: 5.3

Added On: 13/12/97

Note: Individual switches were not taken into consideration.

See also