table of contents
MST_INIT(3) | Library Functions Manual | MST_INIT(3) |
NAME¶
mst_init - Initializing and freeing MSTrace and MSTraceGroup structuresSYNOPSIS¶
#include <libmseed.h> MSTrace *mst_init ( MSTrace *mst ); void mst_free ( MSTrace **ppmst ); MSTraceGroup *mst_initgroup ( MSTraceGroup *mstg ); void mst_freegroup ( MSTraceGroup **ppmstg );
DESCRIPTION¶
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.
RETURN VALUES¶
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.
SEE ALSO¶
ms_intro(3).AUTHOR¶
Chad Trabant IRIS Data Management Center
2006/10/10 | Libmseed API |