DOKK / manpages / debian 12 / libmseed-doc / mst_freegroup.3.en
MST_INIT(3) Library Functions Manual MST_INIT(3)

mst_init - Initializing and freeing MSTrace and MSTraceGroup structures

#include <libmseed.h>
MSTrace      *mst_init ( MSTrace *mst );
void        mst_free ( MSTrace **ppmst ); 
MSTraceGroup *mst_initgroup ( MSTraceGroup *mstg );
void        mst_freegroup ( MSTraceGroup **ppmstg );

mst_init will initialize a MSTrace structure. If the mst parameter is NULL a new structure will be allocated. If the mst parameter is not NULL the structure will be cleared and any memory allocated for the MSTrace.datasamples and MSTrace.prvtptr members will be freed.

mst_free will free all memory associated with a MSTrace structure and set the structure pointer (*ppmst) to 0. This includes any memory pointed to by the prvtptr member of the MSTrace structure.

mst_initgroup will initialize a MSTraceGroup structure. If the mstg parameter is NULL a new structure will be allocated. If the mstg parameter is not NULL the structure will be cleared and any all associated MSTrace structures will be freed.

mst_freegroup will free all memory associated with a MSTraceGroup structure and set the structure pointer (*ppmstg) to 0.

mst_init returns a pointer to the MSTrace structure initialized on success or NULL on error.

mst_initgroup returns a pointer to the MSTraceGroup structure initialized on success or NULL on error.

ms_intro(3).

Chad Trabant
IRIS Data Management Center
2006/10/10 Libmseed API