Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 67 / 612

Working with Search Filters
Chapter 5 Front-End API Functions 67
Determining if an Entry Matches a Filter
After retrieving a filter from the
SLAPI_SEARCH_FILTER
parameter of the
parameter block, you can call the
slapi_filter_test()
function to determine if
entries in your database match the filter.
Getting the Filter Type
To determine the type of filter you are using, call
slapi_filter_get_choice()
.
This function returns the filter type, which can be any one of the following values:
slapi_str2filter()
Convert a string representation of a filter to a
filter of the datatype
Slapi_Filter
slapi_filter_join()
Construct a new
LDAP_FILTER_AND
,
LDAP_FILTER_OR
, or
LDAP_FILTER_NOT
filter from other filters
slapi_filter_list_first()
,
slapi_filter_list_next()
Get the components of a filter (only applicable
to
LDAP_FILTER_AND
,
LDAP_FILTER_OR
,
and
LDAP_FILTER_NOT
searches)
slapi_filter_free()
Free a filter from memory
Table 5-4 Types of Filters
Filter Type Description
LDAP_FILTER_AND
The search should find entries matching all filters that
are specified in this complex filter.
LDAP_FILTER_OR
The search should find entries matching any filter
specified in this complex filter.
LDAP_FILTER_NOT
The search should find entries not matching the
specified filter.
LDAP_FILTER_EQUALITY
The search should find entries that contain a value
equal to the specified attribute value.
LDAP_FILTER_SUBSTRINGS
The search should find entries that contain a value
matching the specified substrings.
Table 5-3 Front-End Functions for Manipulating Filters (Continued)
Function Description