Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 356 / 612

Functions for Dealing with Filters
356 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
Syntax
#include “slapi-plugin.h”
int slapi_filter_get_subfilt( Slapi_Filter *f, char **type,
char **initial, char ***any, char **final );
Parameters
This function takes the following parameters:
Returns
This function returns one of the following values:
• 0 if successful.
• -1 if the filter is not one of the types listed above.
Description
Filters of the type
LDAP_FILTER_SUBSTRINGS
generally compare a set of substrings
against an attribute. For example:
(cn=John*Q*Public)
This filter finds entries in which the value of the
cn
attribute starts with
John
,
contains
Q
, and ends with
Public
.
Call this function to get these substring values as well as the attribute type from
this filter. In the case of the example above, calling this function gets the
initial
substring
John
, the
any
substring
Q
, and the
final
substring
Public
in addition to
the attribute type
cn
.
See Also
slapi_filter_get_attribute_type()
slapi_filter_get_ava()
slapi_filter_get_choice()
f
Filter that you want to get the substring values from.
type
Pointer to the attribute type of the filter.
initial
Pointer to the initial substring (“starts with”) of the filter.
any
Pointer to an array of the substrings (“contains”) for the filter.
final
Pointer to the final substring (“ends with”) of the filter.