1
2getdns_list_set(3)                  getdns                  getdns_list_set(3)
3
4
5

NAME

7       getdns_list_set,     getdns_list_set_bindata,     getdns_list_set_dict,
8       getdns_list_set_int, getdns_list_set_list, -- set a value by index from
9       a getdns list
10
11

LIBRARY

13       DNS Resolver library (libgetdns, -lgetdns)
14
15

SYNOPSIS

17       #include <getdns.h>
18
19       getdns_return_t
20       getdns_list_set_bindata (getdns_list *this_list,
21          size_t index,
22          getdns_bindata *child_bindata)
23
24       getdns_return_t
25       getdns_list_set_dict (getdns_list *this_list,
26          size_t index,
27          getdns_dict *child_dict)
28
29       getdns_return_t
30       getdns_list_set_int (getdns_list *this_list,
31          size_t index,
32          uint32_t child_uint32_t)
33
34       getdns_return_t
35       getdns_list_set_list (getdns_list *this_list,
36          size_t index,
37          getdns_list *child_list)
38
39

DESCRIPTION

41       The  getdns_list type is used to manage a heterogeneous indexed list of
42       values that include:
43          getdns_bindata
44          getdns_dict
45          getdns_list
46          uint32_t
47
48
49       this_list the list in which to add/update the indexed item
50
51       index the index whose associated value is to  be  set.   If  the  index
52       exists in the list the value associated with that index is replaced, if
53       the index does not exist in the list a new item is added to the list at
54       the specified index.
55
56       child_bindata  child_dict  child_list  child_uint32 value to assign the
57       indexed element
58
59

RETURN VALUES

61       Upon successful completion the functions  return  GETDNS_RETURN_GOOD  ,
62       otherwise the following error values are returned:
63
64       GETDNS_RETURN_NO_SUCH_LIST_ITEM if the index is out of range
65
66       GETDNS_RETURN_GENERIC_ERROR if this_list is not a valid list
67
68

EXAMPLES

70       TBD
71
72

SEE ALSO

74       libgetdns(3),  getdns_address(3),  getdns_list(3),  getdns_list_get(3),
75       getdns_general(3), getdns_hostname(3), getdns_service(3),
76
77
78
79
80getdns 1.5.2                     December 2015              getdns_list_set(3)