getdns_dict_get man page

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),

Referenced By

getdns_dict(3), getdns_dict_set(3).

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).

December 2015 getdns 0.9.0 getdns