getdns_list(3) getdns getdns_list(3)NAME
getdns_list, getdns_list_create, getdns_list_create_with_extended_mem‐
ory_functions, getdns_list_create_with_memory_functions,
getdns_list_destroy -- getdns list create and destroy routines
LIBRARY
DNS Resolver library (libgetdns, -lgetdns)
SYNOPSIS
#include <getdns.h>
getdns_list *
getdns_list_create ()
getdns_list *
getdns_list_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_list *getdns_list_create_with_memory_functions
(void *userarg,
void *(*malloc)(size_t sz),
void *(*realloc)(void *buf, size_t sz),
void (*free)(void *buf)
voidgetdns_list_destroy (getdns_list *this_dict)DESCRIPTION
The getdns_list type is used to manage heterogeneous indexed lists
name/value pairs in which the data types of the values 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 list before destroying the list. There are a
number of helper functions that provide access to the list 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 func‐
tions
this_list the list to destroy
RETURN VALUES
Upon successful completion the getdns_list_create function returns a
valid (empty) list structure that should be freed via a call to
getdns_list_destroy. If a parameter in invalid or in the event of some
error getdns_list_create returns NULL.
EXAMPLES
TBD
SEE ALSOlibgetdns(3), getdns_dict(3), getdns_list_get(3), getdns_list_set(3)getdns 0.9.0 December 2015 getdns_list(3)