Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 361 / 612

Functions for Dealing with Filters
Chapter 15 Function Reference 361
Memory Concerns
No duplication of the filter is done, so this filter should not be freed independently
of the original filter.
See Also
slapi_filter_list_next()
slapi_filter_list_next()
(Applies only to filters of the types
LDAP_FILTER_EQUALITY
,
LDAP_FILTER_GE
,
LDAP_FILTER_LE
,
LDAP_FILTER_APPROX
) Gets the next filter (following
fprev
) that
makes up the specified filter
f
.
Syntax
#include “slapi-plugin.h”
Slapi_Filter *slapi_filter_list_next( Slapi_Filter *f,
Slapi_Filter *fprev );
Parameters
This function takes the following parameters:
Returns
This function returns the next filter (after
fprev
) that makes up the specified filter
f
.
Description
To iterate through all filters that make up a specified filter, use this function in
conjunction with the
slapi_filter_list_first()
function.
Filters of the type
LDAP_FILTER_AND
,
LDAP_FILTER_OR
, and
LDAP_FILTER_NOT
generally consist of one or more other filters. For example, if the filter is:
(&(ou=Accounting)(l=Sunnyvale))
the next filter after
(ou=Accounting)
in this list is:
(l=Sunnyvale)
Call the
slapi_filter_list_next()
function to get the filters from this list.
f
Filter from which you want to get the next component (after
fprev
).
fprev
Filter within the specified filter
f
.