libenatsc3sls

libentasc3sls is a collection of functions which parses service-level signaling XML documents into a compact representation using EnXML. Definitions and functions are provided for parsing HELD and USBD documents.

Function Reference

ENATSC3Status ENATSC3SLSHELDParse(
    const char *pXML, 
    int32_t sXML,
    ENATSC3SLSHELDNode *pParsedHELD
);

Parses a HELD document to an EnXML representation.

Parameters
    • pXML: The XML document.
    • sXML: The number of bytes in the XML document.
    • pParsedHELD A pointer to an ENATSC3SLSHELDNode . On successful return it is populated with the parsed document. pParsedATSC3HELD must be freed using  ENATSC3SLSHELDFree when the application is done with the parsed representation. On failure the contents of pParsedHELD is undefined and ENATSC3SLSHELDFree must not be called on it.
Return Values
    • ENATSC3Status_Success: The document was successfully parsed.
    • ENATSC3Status_Failure: An error was encountered parsing the document.
ENATSC3Status ENATSC3SLSHELDFree(
    ENATSC3SLSHELDNode *pParsedHELD
);

ENATSC3SLSHELDFree frees the memory associated with an  ENATSC3SLSHELDNode that was parsed using ENATSC3SLSHELDParse.

Parameters
    • pParsedHELD: A pointer to the ENATSC3SLSHELDNode.
Return Values
    • ENATSC3Status_Success: The object was freed.
    • ENATSC3Status_Failure: An error was encountered while freeing the object.
ENATSC3Status ENATSC3SLSUSBDParse(
    const char *pXML, 
    int32_t sXML,
    ENATSC3SLSUSBDNode *pParsedUSBD
);

Parses a USBD document to an EnXML representation.

Parameters
    • pXML: The XML document.
    • sXML: The number of bytes in the XML document.
    • pParsedUSBD A pointer to an ENATSC3SLSUSBDNode . On successful return it is populated with the parsed document. pParsedATSC3USBD must be freed using  ENATSC3SLSUSBDFree when the application is done with the parsed representation. On failure the contents of pParsedUSBD is undefined and ENATSC3SLSUSBDFree must not be called on it.
Return Values
    • ENATSC3Status_Success: The document was successfully parsed.
    • ENATSC3Status_Failure: An error was encountered parsing the document.
ENATSC3Status ENATSC3SLSUSBDFree(
    ENATSC3SLSUSBDNode *pParsedUSBD
);

ENATSC3SLSUSBDFree frees the memory associated with an  ENATSC3SLSUSBDNode that was parsed using ENATSC3SLSUSBDParse.

Parameters
    • pParsedUSBD: A pointer to the ENATSC3SLSUSBDNode.
Return Values
    • ENATSC3Status_Success: The object was freed.
    • ENATSC3Status_Failure: An error was encountered while freeing the object.