getdns_dict_set - Man Page
set a value by name in a getdns dict
Library
DNS Resolver library (libgetdns, -lgetdns)
Synopsis
- #include <getdns.h>
- getdns_return_t
- getdns_dict_set_bindata (getdns_dict *this_dict,
char *name,
getdns_bindata *child_bindata)- getdns_return_t
- getdns_dict_set_dict (getdns_dict *this_dict,
char *name,
getdns_dict *child_dict)- getdns_return_t
- getdns_dict_set_int (getdns_dict *this_dict,
char *name,
uint32_t child_uint32_t)- getdns_return_t
- getdns_dict_set_list (getdns_dict *this_dict,
char *name,
getdns_list *child_list)
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 in which to add/update the name/value pair
name the name whose associated value is to be set. If the name exists in the dictionary the value associated with that name is replaced, if the name does not exist in the dictionary a new item is added to the dictionary.
child_bindata child_dict child_list child_uint32 value to assign the name
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
Examples
TBD
See Also
libgetdns(3), getdns_address(3), getdns_dict(3), getdns_dict_get(3), getdns_general(3), getdns_hostname(3), getdns_service(3)
Referenced By
getdns_dict(3), getdns_dict_get(3).
The man pages getdns_dict_set_bindata(3), getdns_dict_set_dict(3), getdns_dict_set_int(3) and getdns_dict_set_list(3) are aliases of getdns_dict_set(3).