GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::LDAP::FILTER (3)

.ds Aq ’

NAME

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

CONTENTS

SYNOPSIS



  use Net::LDAP::Filter;

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



DESCRIPTION

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

CONSTRUCTOR

new ( [ FILTER ] ) Create a new object. If FILTER is given, parse it.

METHODS

parse ( FILTER ) Parse FILTER, updating the object to represent it.
as_string Return the filter in text form.
print ( [ FH ] ) Print the text representation of the filter to FH, or the currently selected output handle if FH is 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 <B>notB> operator, the negation is done by recursively applying 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))))



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



SEE ALSO

Net::LDAP, Other online documentation

ACKNOWLEDGEMENTS

This document is based on a document originally written by Russell Fulton <r.fulton@auckland.ac.nz>.

AUTHOR

Graham Barr <gbarr@pobox.com>

Please report any bugs, or post any suggestions, to the perl-ldap mailing list <perl-ldap@perl.org>.

COPYRIGHT

Copyright (c) 1997-2004 Graham Barr. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::LDAP::FILTER (3) 2015-04-02

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.