Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 66 / 612

Working with Search Filters
66 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
You can use the following front-end function to normalize and convert the case of a
DN:
• Use
slapi_dn_normalize()
normalize a DN.
• Use
slapi_dn_ignore_case()
to convert all characters in a DN to lowercase.
• Use
slapi_dn_normalize_case()
to both normalize the DN and convert all
characters in the DN to lowercase.
Working with Search Filters
When a client requests an LDAP search operation, the front-end passes the search
filter to the back-end as part of the parameter block. (The filter is passed through
the
SLAPI_SEARCH_FILTER
parameter. A string representation of the filter is also
available in the
SLAPI_SEARCH_STRFILTER
parameter.)
To manipulate search filters, call the following front-end routines:
NOTE These functions operate on the actual DN specified in the
argument, not a copy of the DN. If you want to modify a copy of the
DN, call
slapi_ch_strdup()
to make a copy of the DN.
Table 5-3
Front-End Functions for Manipulating Filters
Function Description
slapi_filter_test()
Determine if an entry matches a filter’s criteria
slapi_filter_get_choice()
Get the filter type
slapi_filter_get_ava()
Get the attribute type and value used for
comparison in an attribute-value assertion
filter (only applicable to the following searches:
LDAP_FILTER_EQUALITY
,
LDAP_FILTER_GE
,
LDAP_FILTER_LE
, and
LDAP_FILTER_APPROX)
slapi_filter_get_type()
Get the type of attribute that the filter is
searching for (only applicable to
LDAP_FILTER_PRESENT
searches)
slapi_filter_get_subfilt()
Get the substring pattern used for the filter
(applicable only to
LDAP_FILTER_SUBSTRING
searches)