Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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_de-
     stroy -- 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  respec-
     tive man pages.

     userarg  pass  this  argument to the user specified memory management func-
     tions 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_de-
     stroy.   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 1.7.3			  December 2015 		  getdns_list(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=getdns_list_create&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help