Net::LDAP::Filter(3) User Contributed Perl Documentation Net::LDAP::Filter(3)

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

SYNOPSIS
         use Net::LDAP::Filter;

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

DESCRIPTION
       The NNeett::::LLDDAAPP::::FFiilltteerr object lets you directly manipulate LDAP filters
       without worrying about the string representation and all the associated
       escaping mechanisms.

CCOONNSSTTRRUUCCTTOORR
       new ( FILTER )
           Create a new object and parse FILTER.

MMEETTHHOODDSS
       parse ( FILTER )
           Parse FILTER. The next call to ber will return this filter encoded.

       asstring
           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.

FFIILLTTEERR SSYYNNTTAAXX
       Below is the syntax for a filter given in RFC-2254
       http://www.ietf.org/rfc/rfc2254.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.5 of RFC-2251
        matchingrule = MatchingRuleId from Section 4.1.9 of RFC-2251
        value        = AttributeValue from Section 4.1.6 of RFC-2251


        Special Character encodings
        --------------
           *               \2a, \*
           (               \28, \(
           )               \29, \)
           \               \5c, \\
           NUL             \00

SEE ALSO
       Net::LDAP, Other online documentation

AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS
       This document is based on a document originally written by Russell
       Fulton .

AUTHOR       Graham Barr 

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

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.



perl v5.8.8                       2005-04-25              Net::LDAP::Filter(3)