HP-UX Reference (11i v1 00/12) - 1 User Commands N-Z (vol 2)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1/neqn.1
________________________________________________________________
___ ___
p
pdls(1) pdls(1)
(TO BE OBSOLETED)
initial-value-document
server
filter="
FilterCriteria"
Specifies the selection criteria you want used to select a subset from the candidate objects (if you
request attribute values for multiple objects). A filter is a logical expression consisting of relations of
attributes to attribute values. Among the objects you specify, only objects whose attribute values
match the filter expression are returned.
You can only use attributes for the object class you specify in the command (see the -c option or the
class command attribute). The filter may contain an attribute other than one of those you are
requesting.
FilterCriteria is a text string delimited by quotes. The filter syntax is one of the following:
1. A filter item consisting of an "attribute operator value".
Table 1 shows the operators and the data formats they can be used with to separate the attri-
bute and value.
Table 1. Attribute Operators for Filters
Time
Operation Operator Strings Integers Format
Equal == XX X
Match first part of a value =* XX X
Match last part of a value *= XX X
Match any part of a value,
such as a substring *=* XX X
Attribute present (any value) ==* XX X
(See Note 1)
Match approximately,
for case-insensitive substring ˜= X- -
(See Notes 2 and 3)
Match a value greater
than that specified > -X X
Match a value less
than that specified < -X X
Note 1: Testing for attribute present returns true when the attribute has a value, not just
when the attribute exists. A false value may be needed to satisfy the requirement such as
using quotes, as long as the false value conforms to the general syntax.
Note 2: An approximate match is when at least half of the target string, regardless of start-
ing position, matches the filter value.
Note 3: A case insensitive match is when the target string may have a mix of upper- and
lowercase characters, but the character do match.
2. In the previous table the attribute present operation consists of an attribute name followed by
the equality operator followed by an * in the place of an attribute value. For example:
-f "printers-assigned==*"
If the attribute has no value, the filter item is evaluated as false. It evaluates as true if the
attribute has been assigned any value.
3. Each attribute in a filter item can be compared to only one attribute value. To compare an
attribute to more than one value, or to filter on more than one attribute, separate the filter
items with one of the following operators:
&& AND operator, as in: filter-item && filter-item
The expression evaluates to true only if both filter-items evaluate to true.
|| OR operator, as in: filter-item || filter-item
The expression evaluates to true if either of the filter-items evaluate to true.
Section 1−−684 − 3 − HP-UX Release 11i: December 2000
___
___