xmlReadMemory

xmlReadMemory is a convenience routine in the libxml2 XML parsing library that constructs an xmlDocPtr from a block of XML data held in memory. It is typically used when an application has already loaded XML into a buffer and wishes to parse it without writing to the disk. The routine signature is

xmlDocPtr xmlReadMemory(const char *c, int size, const char *URL, const char *encoding, int options).

The first argument is a pointer to the XML data, the second specifies the number of bytes of data to read. The third argument, URL, is optional and is used only for error reporting; it can be a string that identifies the source of the data, such as the name of the file or a URL. The encoding argument allows the user to specify the character set used in the XML document. If it is NULL the parser determines the encoding from the XML declaration or the Byte Order Mark. The options parameter lets the caller enable or disable specific parser flags such as XML_PARSE_RECOVER, XML_PARSE_NOERROR, or XML_PARSE_NOWARNING.

On success xmlReadMemory returns a pointer to a newly allocated xmlDoc structure that represents the parsed XML tree. If parsing fails the function returns NULL and an error report is written to the error handler registered with xmlSetStructuredErrorFunc.

Usage example:

```

const char *data = "<book><title>Example</title></book>";

xmlDocPtr doc = xmlReadMemory(data, strlen(data), "example.xml", NULL, XML_PARSE_RECOVER);

```

The returned document can be manipulated with the standard libxml2 DOM API and freed with xmlFreeDoc when no longer needed.