getdns_dict - Man Page

getdns dict create and destroy routines

Library

DNS Resolver library (libgetdns, -lgetdns)

Synopsis

#include <getdns.h>

getdns_dict *
getdns_dict_create ()

getdns_dict *
getdns_dict_create_with_extended_memory_functions

(void *userarg,
void *(*malloc)(void *userarg, size_t sz),
void *(*realloc)(void *userarg, void *buf, size_t sz),
void (*free)(void *userarg, void *buf)

getdns_dict *
getdns_dict_create_with_memory_functions

(void *(*malloc)(size_t sz),
void *(*realloc)(void *buf, size_t sz),
void (*free)(void *buf)

void
getdns_dict_destroy (getdns_dict *this_dict)

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

The destroy function performs a "deep" destroy, freeing storage for all of the members of the dictionary before destroying the dictionary.  There are a number of helper functions that provide access to the dictionary object, see their respective man pages.

userarg pass this argument to the user specified memory management functions for operations on lists created using extended memory functions

this_dict the dictionary to destroy

Return Values

Upon successful completion the getdns_dict_create function returns a valid (empty) dictionary structure that should be freed via a call to getdns_dict_destroy.  If a parameter in invalid or in the event of some error getdns_dict_create returns NULL.

Examples

TBD

See Also

libgetdns(3), getdns_dict_get(3), getdns_dict_set(3), getdns_list(3), getdns_pretty_print_dict(3).

Referenced By

getdns_dict_get(3), getdns_dict_set(3), getdns_list(3), getdns_list_get(3), getdns_pretty_print_dict(3), libgetdns(3).

The man pages getdns_dict_create(3), getdns_dict_create_with_extended_memory_functions(3), getdns_dict_create_with_memory_functions(3) and getdns_dict_destroy(3) are aliases of getdns_dict(3).

December 2015 getdns 1.7.3