Whole document tree

ao_append_option

declared in "ao/ao.h";

Append a key-value pair to a linked list of options. The key and value strings are duplicated into newly allocated memory, so the calling function retains ownership of the string parameters.

int ao_append_option(ao_option **options, const char *key, const char *value);

Parameters

options

Address of the pointer to the head of the option list. For an empty list *options will be NULL.

key

A string holding the option key.

num_bytes

A string holding the option value.

Return Values

1 indicates success.

0 indicates memory allocation failure.