getdns_dict_set(3)                  getdns                  getdns_dict_set(3)



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


getdns 1.7.3                     December 2015              getdns_dict_set(3)