19.15. slapi_attr_next_value()

Description

Use this function to get the next value of an attribute. The value of an attribute associated with an index is placed into a value. This is part of a set of functions to enumerate over a Slapi_Attr structure.

Syntax

#include "slapi-plugin.h"
int slapi_attr_next_value( Slapi_Attr *a, int hint, Slapi_Value **v );

Parameters

This function takes the following parameters:

a Attribute contained the desired value.
hint Index of the value to be returned.
v Holds the value of the attribute.
Returns

This function returns one of the following values:

  • hint plus 1 if the value is found.
  • -1 if null or if a value at hint is not found.