mdz_xml_parse

Read-only parsing XML-document under pcText with length nTextLength. After successful parsing, DOM-structure will be built with a root at mdz_Xml.m_pRootElement.

mdz_bool mdz_xml_parse(
  const struct mdz_Xml* pXml,
  const char* pcText,
  size_t nTextLength,
  mdz_bool bTrimSpaces);

Parameter	Description
pXml	pointer to XML-parser instance returned by mdz_xml_create()
pcText	XML-document to parce (single-bytes string)
nTextLength	length of XML-document to parce in bytes
bTrimSpaces	if leading/trail spaces in element text should be trimmed/deleted (makes DOM-structure in-memory size smaller)

Return	Description
mdz_false	if pXml == NULL
mdz_false	if license is invalid/expired (MDZ_XML_ERROR_LICENSE)
mdz_false	if pcText is NULL or empty or nTextLength is too small (MDZ_XML_ERROR_PARAM)
mdz_false	if there are memory-allocation problems (MDZ_XML_ERROR_MEMORY)
mdz_false	if there are parsing problems (MDZ_XML_ERROR_PARSE). In shis case mdz_Xml.m_nErrorPos contains position of unexpected/erroneous character in XML-document
mdz_true	parsing succeeded

mdz_xml API Reference is generated using mdzApiRefGenerator.