libao - function - ao_append_option

libao documentation | libao version 0.8.0 - 20010804

# 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.

copyright © 2001 Stan Seibert | xiph.org indigo@aztec.asu.edu
libao documentation | libao version 0.8.0 - 20010804