ldap_get_attributes(3) [php man page]

LDAP_GET_ATTRIBUTES(3)							 1						    LDAP_GET_ATTRIBUTES(3)

ldap_get_attributes - Get attributes from a search result entry

SYNOPSIS

       array ldap_get_attributes (resource  $link_identifier, resource	$result_entry_identifier)

DESCRIPTION

	Reads attributes and values from an entry in the search result.

	Having	located  a specific entry in the directory, you can find out what information is held for that entry by using this call. You would
       use this call for an application which "browses" directory entries and/or where you do not know the structure of the directory entries.	In
       many  applications  you will be searching for a specific attribute such as an email address or a surname, and won't care what other data is
       held.

       return_value["count"] = number of attributes in the entry
       return_value[0] = first attribute
       return_value[n] = nth attribute

       return_value["attribute"]["count"] = number of values for attribute
       return_value["attribute"][0] = first value of the attribute
       return_value["attribute"][i] = (i+1)th value of the attribute

PARAMETERS

	      o $link_identifier
		- An LDAP link identifier, returned by ldap_connect(3).

	      o $result_entry_identifier
		-

RETURN VALUES

	Returns a complete entry information in a multi-dimensional array on success and FALSE on error.

EXAMPLES

       Example #1

	       Show the list of attributes held for a particular directory entry

	      <?php
	      // $ds is the link identifier for the directory

	      // $sr is a valid search result from a prior call to
	      // one of the ldap directory search calls

	      $entry = ldap_first_entry($ds, $sr);

	      $attrs = ldap_get_attributes($ds, $entry);

	      echo $attrs["count"] . " attributes held for this entry:<p>";

	      for ($i=0; $i < $attrs["count"]; $i++) {
		  echo $attrs[$i] . "<br />";
	      }
	      ?>

SEE ALSO

       ldap_first_attribute(3), ldap_next_attribute(3).

PHP Documentation Group 												    LDAP_GET_ATTRIBUTES(3)

ldap_first_attribute(3LDAP)				      LDAP Library Functions				       ldap_first_attribute(3LDAP)

NAME

       ldap_first_attribute, ldap_next_attribute - step through LDAP entry attributes

SYNOPSIS

       cc [ flag...] file... -lldap[ library...]
       #include <lber.h>
       #include <ldap.h>

       char *ldap_first_attribute(LDAP *ld, LDAPMessage *entry,
	    BerElement **berptr);

       char *ldap_next_attribute(LDAP *ld, LDAPMessage *entry,
	    BerElement *ber);

DESCRIPTION

       The ldap_first_attribute() function gets the value of the first attribute in an entry.

       The ldap_first_attribute() function returns the name of the first attribute in the entry. To get the value of the first attribute, pass the
       attribute name to the ldap_get_values() function or to the ldap_get_values_len() function.

       The ldap_next_attribute() function gets the value of the next attribute in an entry.

       After stepping through the attributes, the  application	should	call  ber_free()  to  free  the  BerElement  structure	allocated  by  the
       ldap_first_attribute() function if the structure is other than NULL.

ERRORS

       If  an  error occurs, NULL is returned and the ld_errno field in the ld parameter is set to indicate the error. See ldap_error(3LDAP) for a
       description of possible error codes.

ATTRIBUTES

       See attributes(5) for a description of the following attributes:

       +-----------------------------+----------------------------------+
       |      ATTRIBUTE TYPE	     |	       ATTRIBUTE VALUE		|
       +-----------------------------+----------------------------------+
       |MT-Level		     |SUNWcsl (32-bit)SUNWcslx (64-bit) |
       +-----------------------------+----------------------------------+
       |Interface Stability	     |Evolving				|
       +-----------------------------+----------------------------------+

SEE ALSO

       ldap(3LDAP), ldap_first_entry(3LDAP), ldap_get_values(3LDAP), ldap_error(3LDAP), attributes(5)

NOTES

       The ldap_first_attribute() function alllocates memory that might need to be freed by the caller by means of ber_free(3LDAP).

SunOS 5.11							    16 Dec 2003 				       ldap_first_attribute(3LDAP)