Gecko [ www.thearyasamaj.org ]

Name	Size	Permission
Control	[ DIR ]	drwxr-xr-x
Extension	[ DIR ]	drwxr-xr-x
Extra	[ DIR ]	drwxr-xr-x
Intermediate	[ DIR ]	drwxr-xr-x
ASN.pm	14.67 KB	-rw-r--r--
Bind.pm	2.1 KB	-rw-r--r--
Constant.pm	21.5 KB	-rw-r--r--
Control.pm	9.5 KB	-rw-r--r--
Entry.pm	8.24 KB	-rw-r--r--
Entry.pod	9.49 KB	-rw-r--r--
Examples.pod	11.47 KB	-rw-r--r--
Extension.pm	668 B	-rw-r--r--
Extra.pm	1.53 KB	-rw-r--r--
FAQ.pod	58.21 KB	-rw-r--r--
Filter.pm	7.02 KB	-rw-r--r--
Filter.pod	2.83 KB	-rw-r--r--
FilterMatch.pm	14.38 KB	-rw-r--r--
Intermediate.pm	6 KB	-rw-r--r--
LDIF.pm	18.15 KB	-rw-r--r--
LDIF.pod	6.17 KB	-rw-r--r--
Message.pm	5.54 KB	-rw-r--r--
Message.pod	3.11 KB	-rw-r--r--
RFC.pod	49.75 KB	-rw-r--r--
Reference.pod	1.08 KB	-rw-r--r--
RootDSE.pm	2.25 KB	-rw-r--r--
Schema.pm	10.3 KB	-rw-r--r--
Schema.pod	4.08 KB	-rw-r--r--
Search.pm	3.77 KB	-rw-r--r--
Search.pod	3.14 KB	-rw-r--r--
Security.pod	7.06 KB	-rw-r--r--
Util.pm	25.23 KB	-rw-r--r--

Code Editor : Filter.pod

=head1 NAME

Net::LDAP::Filter - representation of LDAP filters

=head1 SYNOPSIS

use Net::LDAP::Filter;

$filter = Net::LDAP::Filter->new( $filter_str );

=head1 DESCRIPTION

The B<Net::LDAP::Filter> object lets you directly manipulate LDAP
filters without worrying about the string representation and all the
associated escaping mechanisms.

=head1 CONSTRUCTOR

=over 4

=item new ( [ FILTER ] )

Create a new object.
If FILTER is given, parse it.

=back

=head1 METHODS

=over 4

=item parse ( FILTER )

Parse FILTER, updating the object to represent it.

=item as_string

Return the filter in text form.

=item print ( [ FH ] )

Print the text representation of the filter to FH, or the currently
selected output handle if FH is not given.

=item 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 B<not>
operator, the negation is done by recursively applying I<De Morgan's law>.

Here is an example:

(|(&(cn=A)(cn=B))(|(!(cn=C))(cn=D)))

gets negated to

(&(|(!(cn=A))(!(cn=B)))(&(cn=C)(!(cn=D))))

=back

=head1 FILTER SYNTAX

Below is the syntax for a filter given in RFC 4515
http://www.ietf.org/rfc/rfc4515.txt

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

=head1 SEE ALSO

L<Net::LDAP>,
L<Other online documentation|Net::LDAP::RFC>

=head1 ACKNOWLEDGEMENTS

This document is based on a document originally written by Russell Fulton
E<lt>r.fulton@auckland.ac.nzE<gt>.

=head1 AUTHOR

Graham Barr E<lt>gbarr@pobox.comE<gt>

Please report any bugs, or post any suggestions, to the perl-ldap mailing list
E<lt>perl-ldap@perl.orgE<gt>.

=head1 COPYRIGHT

=cut

${this.title}

Code Editor : Filter.pod