NAME

       getdns_dict_get, getdns_dict_get_bindata, getdns_dict_get_data_type, getdns_dict_get_dict,
       getdns_dict_get_int, getdns_dict_get_list, getdns_dict_get_names -- get value by name from
       a getdns dict

LIBRARY

       DNS Resolver library (libgetdns, -lgetdns)

SYNOPSIS

       #include <getdns.h>

       getdns_return_t
       getdns_dict_get_bindata (getdns_dict *this_dict,
          char *name,
          getdns_bindata **answer)

       getdns_return_t
       getdns_dict_get_data_type (getdns_dict *this_dict,
          char *name,
          getdns_data_type *answer)

       getdns_return_t
       getdns_dict_get_dict (getdns_dict *this_dict,
          char *name,
          getdns_dict **answer)

       getdns_return_t
       getdns_dict_get_int (getdns_dict *this_dict,
          char *name,
          uint32_t *answer)

       getdns_return_t
       getdns_dict_get_list (getdns_dict *this_dict,
          char *name,
          getdns_list **answer)

       getdns_return_t
       getdns_dict_get_names (getdns_dict *this_dict,
          getdns_list **answer)

DESCRIPTION

       The getdns_dict type is used to manage name/value pairs in which the names are strings and
       the data types of the values are heterogeneous and include
          getdns_bindata
          getdns_dict
          getdns_list
          uint32_t

       this_dict the dictionary from which to retrieve the list of names

       name the name whose associated value is to be returned in answer

       answer the list of all names in the dictionary, note that the  caller  must  free  storage
       allocated to the list via a call to getdns_list_destroy(3)

RETURN VALUES

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

       GETDNS_RETURN_GENERIC_ERROR if this_dict is not a valid dictionary

       GETDNS_RETURN_NO_SUCH_DICT_NAME if the name argument doesn't exist in the dictionary

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

EXAMPLES

       TBD

SEE ALSO

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