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

NAME

7       getdns_dict_get,   getdns_dict_get_bindata,  getdns_dict_get_data_type,
8       getdns_dict_get_dict,    getdns_dict_get_int,     getdns_dict_get_list,
9       getdns_dict_get_names -- get value by name from a getdns dict
10
11

LIBRARY

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

SYNOPSIS

17       #include <getdns.h>
18
19       getdns_return_t
20       getdns_dict_get_bindata (getdns_dict *this_dict,
21          char *name,
22          getdns_bindata **answer)
23
24       getdns_return_t
25       getdns_dict_get_data_type (getdns_dict *this_dict,
26          char *name,
27          getdns_data_type *answer)
28
29       getdns_return_t
30       getdns_dict_get_dict (getdns_dict *this_dict,
31          char *name,
32          getdns_dict **answer)
33
34       getdns_return_t
35       getdns_dict_get_int (getdns_dict *this_dict,
36          char *name,
37          uint32_t *answer)
38
39       getdns_return_t
40       getdns_dict_get_list (getdns_dict *this_dict,
41          char *name,
42          getdns_list **answer)
43
44       getdns_return_t
45       getdns_dict_get_names (getdns_dict *this_dict,
46          getdns_list **answer)
47
48

DESCRIPTION

50       The  getdns_dict  type  is used to manage name/value pairs in which the
51       names are strings and the data types of the  values  are  heterogeneous
52       and include
53          getdns_bindata
54          getdns_dict
55          getdns_list
56          uint32_t
57
58
59       this_dict the dictionary from which to retrieve the list of names
60
61       name the name whose associated value is to be returned in answer
62
63       answer  the  list  of all names in the dictionary, note that the caller
64       must  free  storage   allocated   to   the   list   via   a   call   to
65       getdns_list_destroy(3)
66
67

RETURN VALUES

69       Upon  successful  completion  the functions return GETDNS_RETURN_GOOD ,
70       otherwise the following error values are returned:
71
72       GETDNS_RETURN_GENERIC_ERROR if this_dict is not a valid dictionary
73
74       GETDNS_RETURN_NO_SUCH_DICT_NAME if the name argument doesn't  exist  in
75       the dictionary
76
77       GETDNS_RETURN_WRONG_TYPE_REQUESTED  if  the requested data type doesn't
78       match the contents of the indexed argument or name
79
80

EXAMPLES

82       TBD
83
84

SEE ALSO

86       libgetdns(3),  getdns_address(3),  getdns_dict(3),  getdns_dict_set(3),
87       getdns_general(3),   getdns_hostname(3),   getdns_list(3),  getdns_ser‐
88       vice(3),
89
90
91
92
93getdns 1.5.2                     December 2015              getdns_dict_get(3)