The options that can be used are shown below.
Option | Item name | Parameter | Example | Explanation |
---|---|---|---|---|
SkipChar | Skip character | String to be excluded from search target (More than one string can be specified.) | @SkipChar("\n") | If performing pattern search (string) and complete match of string search, specify characters to be excluded from the search target. |
SeparateChar | Separate character | Word separator character | @SeparateChar("\t") | If performing pattern search (word), specify the word separator character. |
ANKmix | Distinguish between upper-case and lower-case single-byte alphabetics | true | @ANKmix(true) | Specify the handling of upper-case and lower-case for single-byte alphabetics in search target strings.
|
KNJmix | Distinguish between upper-case and lower-case double-byte alphabetics | true | @KNJmix(true) | Specify the handling of upper-case and lower-case for double-byte alphabetics in search target strings.
|
If filter rules are used to perform pattern search (string) and string search, specify the strings (skip characters) that are excluded as search targets.
Syntax
@SkipChar("parameter")
Values specified in parameter
Specify characters, excluding control characters. The characters specified are case-sensitive.
Specify spaces, horizontal tabs, and line feeds as follows:
Character | Specification method |
---|---|
Single-byte space | \s |
Double-byte space | \S |
Horizontal tab | \t |
Line feed | \n |
Example
Example when specifying a single-byte space
@SkipChar("\s")
There can be more than one character specified. If there are multiple specifications, specify with each string separated by a comma (,).
Example
Example when specifying single-byte spaces and double-byte spaces
@SkipChar("\s,\S")
Characters can be specified in UTF-8 encoding. If using the character codes to specify characters, express the code with an escape character added. The escape character is "\". If character codes are expressed using multi-byte characters, use single-byte spaces to separate them.
Example
Example when specifying @ (single-byte character)
@SkipChar("\40")
Example when specifying @ (double-byte character)
@SkipChar("\EF \BC \A0")
Use up to 4096 bytes to specify skip characters.
Note
This option is not valid for condition expression of comparisons between items.
The following characters cannot be specified:
Prohibited characters |
---|
" |
, (*1) |
\n (*1) |
< (*2) |
> (*2) |
] (*2) |
' (*2) |
*1: Can be specified as an exception if the input event type to all IF-THEN statements in filter rules is XML.
*2: Can be specified as an exception if the input event type to all IF-THEN statements in filter rules is CSV.
Operation when option is omitted
If this option is omitted, all characters are treated as search targets.
If pattern search (word) is specified in a filter rule search expression, specify the delimiter character (separator character).
Syntax
@SeparateChar("parameter")
Values specified in parameter
Specify ASCII characters, excluding control characters, and line feeds and horizontal tabs.
If the characters shown below are specified, express them by adding an escape character. The escape character is "\".
Character | Specification method |
---|---|
Single-byte space | \s |
Line feed | \n |
Horizontal tab | \t |
Comma | \, |
Double-quotation marks | \" |
\ (backslash) | \\ |
Example
Example when specifying a single-byte space
@SeparateChar("\s")
There can be more than one character specified. If there are multiple specifications, specify with each string separated by a comma (,).
Example
Example when specifying a single-byte space and a horizontal tab
@SeparateChar("\s,\t")
Use up to 4096 bytes to specify separator characters.
Note
The following characters cannot be specified:
Prohibited characters |
---|
" (*1) |
, (*1) |
\n (*1) |
< (*2) |
> (*2) |
] (*2) |
*1: Can be specified as an exception if the input event type to all IF-THEN statements in filter rules is XML.
*2: Can be specified as an exception if the input event type to all IF-THEN statements in filter rules is CSV.
Operation when option is omitted
If this option is omitted, it is assumed that the following "separator characters" have been specified:
\t | \n (*1) | \s | \" (*1) | ! | $ |
% | & | ' | ( | ) | * |
+ | \, (*1) | - | . | / | : |
; | < (*2) | = | > (*2) | ? | @ |
[ | \\ | ] (*2) | ^ | _ | ` |
{ | | | } | ~ |
*1: Not assumed to be a separator character if the input event type to IF-THEN statements is CSV.
*2: Not assumed to be a separator character if the input event type to IF-THEN statements is XML.
Specify how upper-case and lower-case are handled for single-byte alphabetic search target strings.
Syntax
@ANKmix(parameter)
Values specified in parameter
Single-byte alphabetics are not case-sensitive.
Single-byte alphabetics are case-sensitive.
Operation when option is omitted
If this option is omitted, it is assumed that false is specified.
Note
This option is not valid for condition expression of comparisons between items.
Example
Examples of search processing results when the ANKmix parameter is false (case-sensitive) and when it is true (not case-sensitive)
Search keyword | Search target characters | false: case-sensitive | true: not case-sensitive |
---|---|---|---|
ab | ab | Y | Y |
AB | x | Y | |
aB | x | Y | |
Ab | x | Y | |
AB | ab | x | Y |
AB | Y | Y | |
aB | x | Y | |
Ab | x | Y |
Y: Hit
x: Not hit
Specify how upper-case and lower-case are handled for double-byte alphabetic search target strings.
Syntax
@KNJmix(parameter)
Values specified in parameter
Double-byte alphabetics are not case-sensitive.
Double-byte alphabetics are case-sensitive.
Operation when option is omitted
If this option is omitted, it is assumed that false is specified.
Note
This option is not valid for condition expression of comparisons between items.
Example
Examples of search processing results when the KNJmix parameter is false (case-sensitive) and when it is true (not case-sensitive)