26.12. slapi_filter_list_first()

Applies only to filters of the types LDAP_FILTER_EQUALITY, LDAP_FILTER_GE, LDAP_FILTER_LE, and LDAP_FILTER_APPROX. Gets the first filter that makes up the specified filter.
Description

To iterate through all filters that make up a specified filter, use this function in conjunction with the slapi_filter_list_next() 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 first filter in this list is:
					(ou=Accounting)
Call the slapi_filter_list_first() function to get the first filter in the list.
Syntax

#include "slapi-plugin.h"
Slapi_Filter *slapi_filter_list_first( Slapi_Filter *f );

Parameters

This function takes the following parameter:

f
Filter of which you want to get the first component.
Returns

This function returns the first filter that makes up the specified filter f.

Memory Concerns

No duplication of the filter is done, so this filter should not be freed independently of the original filter.