DragonFly On-Line Manual Pages

getdns_list(3)                      getdns                      getdns_list(3)

NAME
       getdns_list, getdns_list_create,
       getdns_list_create_with_extended_memory_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)

             void
             getdns_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
       functions

       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 ALSO
       libgetdns(3), getdns_dict(3), getdns_list_get(3), getdns_list_set(3)

getdns 0.9.0                     December 2015                  getdns_list(3)