getdns_dict_set man page

getdns_dict_set, getdns_dict_set_bindata, getdns_dict_set_dict, getdns_dict_set_int, getdns_dict_set_list, -- 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).

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

December 2015 getdns 0.9.0 getdns