Syntax
#include "slapi-plugin.h" Slapi_Entry *slapi_str2entry( char *s, int flags ); Parameters
#include "slapi-plugin.h" Slapi_Entry *slapi_str2entry( char *s, int flags );
The function has the following parameters:
s
flags
The value of the flags argument can be one of the following values:
SLAPI_STR2ENTRY_REMOVEDUPVALS
SLAPI_STR2ENTRY_ADDRDNVALS
Returns
Pointer to the Slapi_Entry structure representing the entry, or NULL if the string cannot be converted (for example, if no DN is specified in the string).
Description
A directory entry can be described by a string in LDIF format (for details, see "Converting Between Entries and Strings" on page 61).
Calling the slapi_str2entry() function converts a string description in this format to a Slapi_Entry structure, which you can pass to other API functions.
Note. This function modifies the string argument s. If you still need to use this string value, you should make a copy of this string before calling slapi_str2entry().
If an error occurred during the conversion process, the function returns NULL instead of the entry.
When you are done working with the entry, you should call the slapi_entry_free() function.
To convert an entry to a string description, call the slapi_entry2str() function.
See Also
slapi_entry2str().