getdns_list creation/destruction functions

Functions

getdns_listgetdns_list_create ()
 
getdns_listgetdns_list_create_with_context (getdns_context *context)
 
getdns_listgetdns_list_create_with_memory_functions (void *(*malloc)(size_t), void *(*realloc)(void *, size_t), void(*free)(void *))
 
getdns_listgetdns_list_create_with_extended_memory_functions (void *userarg, void *(*malloc)(void *userarg, size_t), void *(*realloc)(void *userarg, void *, size_t), void(*free)(void *userarg, void *))
 
void getdns_list_destroy (getdns_list *list)
 

Detailed Description

Function Documentation

getdns_list* getdns_list_create ( )

create a new list with no items

Returns
pointer to an allocated list, NULL if insufficient memory
getdns_list* getdns_list_create_with_context ( getdns_context context)
getdns_list* getdns_list_create_with_memory_functions ( void *(*)(size_t)  malloc,
void *(*)(void *, size_t)  realloc,
void(*)(void *)  free 
)
getdns_list* getdns_list_create_with_extended_memory_functions ( void *  userarg,
void *(*)(void *userarg, size_t)  malloc,
void *(*)(void *userarg, void *, size_t)  realloc,
void(*)(void *userarg, void *)  free 
)
void getdns_list_destroy ( getdns_list list)

free memory allocated to the list (also frees all children of the list) note that lists and bindata retrieved from the list via the getdns_list_get_* helper functions will be destroyed as well - if you fetched them previously you MUST copy those instances BEFORE you destroy the list else unpleasant things will happen at run-time