mdex_init3
Initialize and free a multicast index
Usage
#include <librecast/mdex.h>
mdex_t *mdex_init(size_t entries); void mdex_free(mdex_t *mdex);
Compile and link with -llibrecast.
Library
Librecast library (liblibrecast, -llibrecast)
Overview
The mdex_init function initializes a multicast index.
entries gives the initial number of entries to allocate. This is just a hint for initial memory allocation, and the index will be resized as required.
Return value
mdex_init() returns a pointer to a mdex_t handle, which should be freed by passing to mdex_free() when done. On error, NULL is returned, and errno is set to indicate the error.
The mdex_free() function returns no value, and preserves errno.
Errors
- ENOMEM
-
Not enough space/cannot allocate memory (POSIX.1-2001).