Function xmlOpenCharEncodingHandler

ThirdParty/libxml2/vtklibxml2/encoding.c:1934–1975

* xmlOpenCharEncodingHandler: * @name: a string describing the char encoding. * @output: boolean, use handler for output * @out: pointer to result * * Find or create a handler matching the encoding. If no default or * registered handler could be found, try to create a handler using * iconv or ICU if supported. * * The handler must be closed with xmlCharEncCloseFunc. * * If the encodi

 * Returns an xmlParserErrors error code.
 */
int
xmlOpenCharEncodingHandler(const char *name, int output,
                           xmlCharEncodingHandler **out) {
    const char *nalias;
    const char *norig;
    xmlCharEncoding enc;
    int ret;

    if (out == NULL)
        return(XML_ERR_ARGUMENT);
    *out = NULL;

    if (name == NULL)
        return(XML_ERR_ARGUMENT);

    if ((xmlStrcasecmp(BAD_CAST name, BAD_CAST "UTF-8") == 0) ||
        (xmlStrcasecmp(BAD_CAST name, BAD_CAST "UTF8") == 0))
        return(XML_ERR_OK);

    /*
     * Do the alias resolution
     */
    norig = name;
    nalias = xmlGetEncodingAlias(name);
    if (nalias != NULL)
	name = nalias;

    ret = xmlFindHandler(name, output, out);
    if (*out != NULL)
        return(0);
    if (ret != XML_ERR_UNSUPPORTED_ENCODING)
        return(ret);

    /*
     * Fallback using the canonical names
     *
     * TODO: We should make sure that the name of the returned
     * handler equals norig.
     */
    enc = xmlParseCharEncoding(norig);
    return(xmlLookupCharEncodingHandler(enc, out));
}

/**
 * xmlFindCharEncodingHandler: