getdns_list_set functions

Functions
getdns_return_t	getdns_list_set_dict (getdns_list *list, size_t index, const getdns_dict *child_dict)
getdns_return_t	getdns_list_set_list (getdns_list *list, size_t index, const getdns_list *child_list)
getdns_return_t	getdns_list_set_bindata (getdns_list *list, size_t index, const getdns_bindata *child_bindata)
getdns_return_t	getdns_list_set_int (getdns_list *list, size_t index, uint32_t child_uint32)

Detailed Description

Function Documentation

getdns_return_t getdns_list_set_dict	(	getdns_list *	list,
		size_t	index,
		const getdns_dict *	child_dict
	)

assign the child_dict to an item in a parent list, the parent list copies the child dict and will free the copy when the list is destroyed

Parameters

list	list containing the item to which child_list is to be assigned
index	index of the item within list to which child_list is to be assigned
*child_dict	dict to assign to the item

Returns

GETDNS_RETURN_GOOD on success

GETDNS_RETURN_NO_SUCH_LIST_ITEM if index is out of range, or list is NULL

getdns_return_t getdns_list_set_list	(	getdns_list *	list,
		size_t	index,
		const getdns_list *	child_list
	)

assign the child_list to an item in a parent list, the parent list copies the child list and will free the copy when the list is destroyed

Parameters

list	list containing the item to which child_list is to be assigned
index	index of the item within list to which child_list is to be assigned
*child_list	list to assign to the item

Returns

GETDNS_RETURN_GOOD on success

GETDNS_RETURN_NO_SUCH_LIST_ITEM if index is out of range, or list is NULL

getdns_return_t getdns_list_set_bindata	(	getdns_list *	list,
		size_t	index,
		const getdns_bindata *	child_bindata
	)

assign the child_bindata to an item in a parent list, the parent list copies the child data and will free the copy when the list is destroyed

Parameters

list	list contiaining the item to which child_list is to be assigned
index	index of the item within list to which child_list is to be assigned
*child_bindata	data to assign to the item

Returns

GETDNS_RETURN_GOOD on success

GETDNS_RETURN_NO_SUCH_LIST_ITEM if index is out of range, or list is NULL

getdns_return_t getdns_list_set_int	(	getdns_list *	list,
		size_t	index,
		uint32_t	child_uint32
	)

set the integer value of the indexed item (zero based index)

Returns

GETDNS_RETURN_GOOD on success

GETDNS_RETURN_NO_SUCH_LIST_ITEM if index is out of range, or list is NULL