String Functions

The string functions defined in <am_string_set.h> are:

• am_string_set_allocate()

• am_string_set_destroy()

am_string_set_allocate()

Allocates memory and initializes the string set size.

Syntax

#include "am_string_set.h"
AM_EXPORT am_string_set_t *
am_string_set_allocate(int size);

Parameters

This function takes the following parameter:

size

Number of strings in the set.

Returns

This function returns the allocated am_string_set_t, or NULL if size is less than zero.

am_string_set_destroy()

Releases memory in the specified string set object by freeing each string in the set, then freeing the associated pointers, and finally, the structure itself.

Syntax

#include "am_string_set.h"
AM_EXPORT void 
am_string_set_destroy(am_string_set_t *string_set);

Parameters

This function takes the following parameter:

string_set

Pointer to the specified string set object.

Returns

This function returns no values.