LDAP Library Functions                     ldapgetvalues(3LDAP)



NAME
     ldapgetvalues,   ldapgetvalueslen,   ldapcountvalues,
     ldapcountvalueslen,  ldapvaluefree, ldapvaluefreelen
     - LDAP attribute value handling functions

SYNOPSIS
     cc[ flag... ] file... -lldap[ library... ]
     #include 
     #include 

     char **ldapgetvalues(LDAP *ld, LDAPMessage *entry, char *attr);


     struct berval **ldapgetvalueslen(LDAP *ld, LDAPMessage *entry,
          char *attr);


     ldapcountvalues(char **vals);


     ldapcountvalueslen(struct berval **vals);


     ldapvaluefree(char **vals);


     ldapvaluefreelen(struct berval **vals);


DESCRIPTION
     These functions are used to retrieve and  manipulate  attri-
     bute   values   from   an   LDAP   entry   as   returned  by
     ldapfirstentry(3LDAP)      or      ldapnextentry(3LDAP).
     ldapgetvalues()  takes  the  entry  and the attribute attr
     whose values are desired and returns a null-terminated array
     of the attribute's values.  attr may be an attribute type as
     returned      from      ldapfirstattribute(3LDAP)       or
     ldapnextattribute(3LDAP),  or  if  the  attribute  type is
     known it can simply be given.


     The number of values in the array can be counted by  calling
     ldapcountvalues().  The  array  of  values returned can be
     freed by calling ldapvaluefree().


     If the attribute values are binary in nature, and  thus  not
     suitable  to  be  returned  as  an  array  of  char *'s, the
     ldapgetvalueslen() function  can  be  used  instead.   It
     takes  the same parameters as ldapgetvalues(), but returns
     a null-terminated array of pointers  to  berval  structures,
     each containing the length of and a pointer to a value.



SunOS 5.11          Last change: 28 Jan 2002                    1






LDAP Library Functions                     ldapgetvalues(3LDAP)



     The number of values in the array can be counted by  calling
     ldapcountvalueslen(). The array of values returned can be
     freed by calling ldapvaluefreelen().

ERORS
     If    an    error    occurs    in    ldapgetvalues()    or
     ldapgetvalueslen(),  NUL returned and the lderrno field
     in the ld parameter is  set  to  indicate  the  error.   See
     ldaperror(3LDAP) for a description of possible error codes.

ATRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
     Availability                 SUNWcsl (32-bit)            
                                  SUNWcslx (64-bit)           
     Interface Stability          Evolving                    
    


SEE ALSO
     ldap(3LDAP),                        ldapfirstentry(3LDAP),
     ldapfirstattribute(3LDAP),    ldaperror(3LDAP),    attri-
     butes(5)

NOTES
     These functions allocates memory that the caller must free.
























SunOS 5.11          Last change: 28 Jan 2002                    2