filter Parameter

Sets options for the filter operation.

Scope: Global

Syntax

query filter.{historysize|case|match} 
set filter.{historysize|case|match} Value 

Options

historysize 
The number of filter strings or character pattern expressions saved for future recall in the Filter window.
Value 
Must be an integer value between 0 and 25 inclusive.
case 
Permitted values for Value are:
on 
String or character pattern matching takes character case into account.
off 
String or character pattern matching ignores character case.
inverse 
Toggle between values of on and off.
match 
Permitted values Value are:
on 
The string in the Include all lines with this string field is treated as regular expression character pattern matching string.
off 
The string in the Include all lines with this string field is treated as a literal string.
inverse 
Toggle between values of on and off.

Description

The filter parameter lets you set the default options. Changes to filter options are saved between Editor sessions.

Examples

  1. To make the filter operation character case-sensitive, type:
    set filter.case on 
  2. To treat the entry in the Include all lines with this string field as a regular expression pattern, type:
    set filter.match on 
  3. To change the maximum number of entries in the saved string and character pattern list to 10, type:
    set filter.size 10 
  4. To query the maximum number of entries in the saved string and character pattern list, type:
    query filter.size

API Return Codes

-1 
No parameter sub-item was specified. Enter one of size, match, or size as a parameter sub-item.
-2 
An invalid setting was assigned to a parameter sub-item. Enter one of size, match, or size as a parameter sub-item, followed by a valid value for the sub-item.