NAME

       getdns_list_get, getdns_list_get_bindata, getdns_list_get_data_type, getdns_list_get_dict,
       getdns_list_get_length, getdns_list_get_list, getdns_list_get_int -- get a value by  index
       from a getdns list

LIBRARY

       DNS Resolver library (libgetdns, -lgetdns)

SYNOPSIS

       #include <getdns.h>

       getdns_return_t
       getdns_list_get_bindata (getdns_list *this_list,
          size_t index,
          getdns_bindata **answer)

       getdns_return_t
       getdns_list_get_data_type (getdns_list *this_list,
          size_t index,
          getdns_data_type *answer)

       getdns_return_t
       getdns_list_get_dict (getdns_list *this_list,
          size_t index,
          getdns_dict **answer)

       getdns_return_t
       getdns_list_get_length (getdns_list *this_list,
          size_t *answer)

       getdns_return_t
       getdns_list_get_list (getdns_list *this_list,
          size_t index,
          getdns_list **answer)

       getdns_return_t
       getdns_list_get_int (getdns_list *this_list,
          size_t index,
          uint32_t *answer)

DESCRIPTION

       The  getdns_list  type is used to manage heterogeneous lists in which the objects are each
       one of the data types:
          getdns_bindata
          getdns_dict
          getdns_list
          uint32_t

       this_list the list from which to retrieve the object

       index the numeric index (0 based) of the item in the list you would like copied to answer

       answer a copy of the object in the list is placed in answer, the caller is responsible for
       freeing  the  storage  associated  with  that  object  by  calling the appropriate destroy
       function.

RETURN VALUES

       Upon successful  completion  the  functions  return  GETDNS_RETURN_GOOD  ,  otherwise  the
       following error values are returned:

       GETDNS_RETURN_GENERIC_ERROR if this_list is not a valid list

       GETDNS_RETURN_NO_SUCH_LIST_ITEM if index is out of range

       GETDNS_RETURN_WRONG_TYPE_REQUESTED  if  the requested data type doesn't match the contents
       of the indexed argument

EXAMPLES

       TBD

SEE ALSO

       libgetdns(3), getdns_address(3),  getdns_dict(3),  getdns_general(3),  getdns_hostname(3),
       getdns_service(3),