get_values Function

This function retrieves all of the values associated for a given attribute in a given entry.

Syntax

DBMS_LDAP.get_values (

ld  IN SESSION,
ldapentry  IN MESSAGE,
attr  IN VARCHAR2)

RETURN STRING_COLLECTION;

Parameters

Table 20-43 get_values Function Parameters

Parameter	Description
ld (IN)	A valid LDAP session handle.
ldapentry (IN)	A valid handle to an entry returned from a search result.
attr (IN)	The name of the attribute for which values are being sought.

Return Values

Table 20-44 get_values Function Return Values

Value	Description
STRING_COLLECTION	A PL/SQL string collection containing all of the values of the given attribute. NULL if there are no values associated with the given attribute.

Exceptions

Table 20-45 get_values Function Exceptions

Exception	Description
invalid session	Raised if the session handle ld is invalid.
invalid message	Raised if the incoming entry handle is invalid.

Usage Notes

The function get_values can only be called after the handle to entry has been first retrieved by a call to either first_entry or next_entry. The name of the attribute can be known beforehand, and it can also be determined by a call to first_attribute or next_attribute. The function get_values always assumes that the datatype of the attribute it is retrieving is String. For retrieving binary datatypes, use get_values_len.

See Also: "first_entry Function" "next_entry Function" "get_values_len Function" "count_values Function"

.