43.10. slapi_valueset_next_value()

Description

Call this function when you wish to get the next value of a Slapi_ValueSet, after having first called slapi_valueset_first_value(). The returned value is the index of the value in the Slapi_ValueSet structure and must be passed to slapi_valueset_next_value().

Syntax

#include "slapi-plugin.h"
int slapi_valueset_next_value( Slapi_ValueSet *vs, int index, Slapi_Value **v);

Parameters

This function takes the following parameters:

vs
Pointer to the Slapi_ValueSet structure from which you wish to get the value.
index
Value returned by the previous call to slapi_valueset_next_value or slapi_value_first_value().
v
Address to the pointer to the Slapi_Value structure for the returned value.
Returns

This function returns one of the following values:

  • The index of the value in the Slapi_ValueSet.
  • -1 if there was no more value or the input index is incorrect.
Memory Concerns

This function gives a pointer to the actual value within the Slapi_ValueSet and you should not free it from memory.