Error getting tags :
error 404Error getting tags :
error 404 filter | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
Version
filter
Basics
Expander triangle
Type
Command
Syntax

filter container {with | without} filterPattern

Introduced
1.0
Changed
2.1.1
Environment
Desktop, Web and Server
Platform Support
MacOS,Mac OS X,Windows,Linux
Security
None required
Summary
Filters each line in a container, removing the lines that do or don't match a pattern.
Examples

filter myVariable with "A?2"
filter me without "*[a-zA-Z]*"
filter field 22 with "[0-9]*"
filter field "Sorted Lines" with "[" & mySelection & "]"

Additional Comments
Expander triangle

Use the filter command to pick specific lines in a container.

Parameters:

The container is any expression that evaluates to a container.

The filterPattern is an expression used to match certain lines.

Comments:

The filter...with form places the lines that contain a match for the specified filterPattern in the container, replacing the previous contents.

The filter...without form places the lines that do not contain a match for the specified filterPattern in the container, replacing the previous contents.

A filterPattern consists of a string of characters to match which may be combined with any number of the following special characters:

*

Matches zero or more of any character. The filterPattern A*C matches "AC", "ABC", or "ADZXC".

?

Matches exactly one character. The filterPattern A?C matches "ABC", but not "AC" or "ADZXC".

[chars]

Matches any one of the characters inside the brackets. The filterPattern A[BC]D matches "ABD" or "ACD", but not "AD" or "ABCD".

[char-char]

Matches any character whose ASCII value is between the first character and the second character.

Changes to Revolution:

The filter...without form was added in version 2.1.1. In previous versions, the filter command could be used only to retrieve lines that matched a wildcard expression.

User Comments
Expander triangle
User thumbnail
paulclaude@tiscali.it
StarStarStarStarStar
Feb 18, 2010
Beware: the filter command has a limit on the size of a line. It is 65535.