Red Hat DIRECTORY SERVER 7.1 - PLUG-IN PROGRAMMERS Manual page 72

Working with Entries, Attributes, and Values
If you want to continue the specification of a value on additional lines (in other
words, if the value wraps around to another line), use a single space (the ASCII 32
character) at the beginning of subsequent lines. For example:
dn: cn=Jane Doe
Refer to the Red Hat Directory Server Administrator's Guide for details on DN
syntax.
If a double-colon is used after a data type, it signifies that the value after the
double-colon is encoded as a base-64 string. Data is sometimes encoded as a
base-64 string. For example, it might be encoded this way if the value contains a
non-printing character or newline.
To get the LDIF string representation of an entry (and vice versa), call the
following functions:
• To convert an entry from the datatype
representation, call the
slapi_entry2str_with_options()
This function returns the LDIF string representation of the entry or NULL if
an error occurs. When you no longer need to use the string, you should free it
from memory by calling the
• To convert an LDIF string representation back to an entry of the datatype
Slapi_Entry
This function returns an entry of the datatype
occurred during the conversion process, the function returns NULL instead.
When you are done working with the entry, you should call the
slapi_entry_free()
NOTE
70 Red Hat Directory Server Plug-in Programmer's Guide • May 2005
inski, ou=Accoun
ting, dc=ex
ample
dc=com
, call the
slapi_str2entry()
function.
Calling
slapi_str2entry()
argument passed into the function (not a copy). If you still want to
use the string representation of the entry, make a copy of the string
before calling this function.
Slapi_Entry
slapi_entry2str()
functions.
slapi_ch_free_string()
function.
modifies the value of the string
to its LDIF string
and
function.
. If an error
Slapi_Entry