Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) Standard preamble: ========================================================================
NAMENet::LDAP::Filter - representation of LDAP filters
use Net::LDAP::Filter; $filter = Net::LDAP::Filter->new( $filter_str );
DESCRIPTIONThe Net::LDAP::Filter object lets you directly manipulate
- new ( [ FILTER] )
Create a new object.
If FILTERis given, parse it.
- parse ( FILTER)
Parse FILTER,updating the object to represent it.
- Return the filter in text form.
- print ( [ FH] )
Print the text representation of the filter to FH,or the currently selected output handle ifFHis not given.
- negate ( )
Logically negate/invert the filter object so that it matches the opposite
set of entries as the original.
Instead of simply negating the text form by surrounding it with the not operator, the negation is done by recursively applying De Morgan's law.
Here is an example:
gets negated to
FILTER SYNTAXBelow is the syntax for a filter given in
filter = "(" filtercomp ")" filtercomp = and / or / not / item and = "&" filterlist or = "|" filterlist not = "!" filter filterlist = 1*filter item = simple / present / substring / extensible simple = attr filtertype value filtertype = equal / approx / greater / less equal = "=" approx = "~=" greater = ">=" less = "<=" extensible = attr [":dn"] [":" matchingrule] ":=" value / [":dn"] ":" matchingrule ":=" value present = attr "=*" substring = attr "=" [initial] any [final] initial = value any = "*" *(value "*") final = value attr = AttributeDescription from Section 4.1.4 of RFC 4511 matchingrule = MatchingRuleId from Section 4.1.8 of RFC 4511 value = AttributeValue from Section 4.1.5 of RFC 4511 Special Character encodings --------------------------- * \2a, \* ( \28, \( ) \29, \) \ \5c, \\ NUL \00
SEE ALSONet::LDAP, Other online documentation
ACKNOWLEDGEMENTSThis document is based on a document originally written by Russell Fulton <firstname.lastname@example.org>.
AUTHORGraham Barr <email@example.com>
Please report any bugs, or post any suggestions, to the perl-ldap mailing list <firstname.lastname@example.org>.