getdns_dict_get - Man Page
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),
Referenced By
getdns_dict(3), getdns_dict_set(3).
The man pages getdns_dict_get_bindata(3), getdns_dict_get_data_type(3), getdns_dict_get_dict(3), getdns_dict_get_int(3), getdns_dict_get_list(3) and getdns_dict_get_names(3) are aliases of getdns_dict_get(3).