Function xmlReadFile

ThirdParty/libxml2/vtklibxml2/parser.c:13874–13901

* xmlReadFile: * @filename: a file or URL * @encoding: the document encoding (optional) * @options: a combination of xmlParserOption * * Convenience function to parse an XML file from the filesystem, * the network or a global user-define resource loader. * * See xmlCtxtReadFile for details. * * Returns the resulting document tree */

 * Returns the resulting document tree
 */
xmlDocPtr
xmlReadFile(const char *filename, const char *encoding, int options)
{
    xmlParserCtxtPtr ctxt;
    xmlParserInputPtr input;
    xmlDocPtr doc;

    ctxt = xmlNewParserCtxt();
    if (ctxt == NULL)
        return(NULL);

    xmlCtxtUseOptions(ctxt, options);

    /*
     * Backward compatibility for users of command line utilities like
     * xmlstarlet expecting "-" to mean stdin. This is dangerous and
     * should be removed at some point.
     */
    if ((filename != NULL) && (filename[0] == '-') && (filename[1] == 0))
        input = xmlNewInputFd(ctxt, filename, STDIN_FILENO, encoding, 0);
    else
        input = xmlNewInputURL(ctxt, filename, NULL, encoding, 0);

    doc = xmlCtxtParseDocument(ctxt, input);

    xmlFreeParserCtxt(ctxt);
    return(doc);
}

/**
 * xmlReadMemory: