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

FreeBSD Manual Pages

  
 
  

home | help
getdns_list(3)			    getdns			getdns_list(3)

NAME
       getdns_list_get,	  getdns_list_get_bindata,  getdns_list_get_data_type,
       getdns_list_get_dict,   getdns_list_get_length,	 getdns_list_get_list,
       getdns_list_get_int -- get a value by index from	a getdns list

LIBRARY
       DNS Resolver library (libgetdns,	-lgetdns)

SYNOPSIS
       #include	<getdns.h>

       getdns_return_t
       getdns_list_get_bindata (getdns_list *this_list,
	  size_t index,
	  getdns_bindata **answer)

       getdns_return_t
       getdns_list_get_data_type (getdns_list *this_list,
	  size_t index,
	  getdns_data_type *answer)

       getdns_return_t
       getdns_list_get_dict (getdns_list *this_list,
	  size_t index,
	  getdns_dict **answer)

       getdns_return_t
       getdns_list_get_length (getdns_list *this_list,
	  size_t *answer)

       getdns_return_t
       getdns_list_get_list (getdns_list *this_list,
	  size_t index,
	  getdns_list **answer)

       getdns_return_t
       getdns_list_get_int (getdns_list	*this_list,
	  size_t index,
	  uint32_t *answer)

DESCRIPTION
       The getdns_list type is used to manage heterogeneous lists in which the
       objects are each	one of the data	types:
	  getdns_bindata
	  getdns_dict
	  getdns_list
	  uint32_t

       this_list the list from which to	retrieve the object

       index the numeric index (0 based) of the	item in	 the  list  you	 would
       like copied to answer

       answer a	copy of	the object in the list is placed in answer, the	caller
       is responsible for freeing the storage associated with that  object  by
       calling the appropriate destroy function.

RETURN VALUES
       Upon  successful	 completion  the functions return GETDNS_RETURN_GOOD ,
       otherwise the following error values are	returned:

       GETDNS_RETURN_GENERIC_ERROR if this_list	is not a valid list

       GETDNS_RETURN_NO_SUCH_LIST_ITEM if index	is out of range

       GETDNS_RETURN_WRONG_TYPE_REQUESTED if the requested data	 type  doesn't
       match the contents of the indexed argument

EXAMPLES
       TBD

SEE ALSO
       libgetdns(3),   getdns_address(3),  getdns_dict(3),  getdns_general(3),
       getdns_hostname(3), getdns_service(3),

getdns 1.5.2			 December 2015			getdns_list(3)

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | EXAMPLES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getdns_list_get&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help