Function xmlCanonicPath

ThirdParty/libxml2/vtklibxml2/uri.c:2781–2804

* xmlCanonicPath: * @path: the resource locator in a filesystem notation * * Prepares a path. * * If the path contains the substring "://", it is considered a * Legacy Extended IRI. Characters which aren't allowed in URIs are * escaped. * * Otherwise, the path is considered a filesystem path which is * copied without modification. * * The caller is responsible for freeing the memory o

 * Returns the escaped path.
 */
xmlChar *
xmlCanonicPath(const xmlChar *path)
{
    xmlChar *ret;

    if (path == NULL)
	return(NULL);

    /* Check if this is an "absolute uri" */
    if (xmlStrstr(path, BAD_CAST "://") != NULL) {
	/*
         * Escape all characters except reserved, unreserved and the
         * percent sign.
         *
         * xmlURIEscapeStr already keeps unreserved characters, so we
         * pass gen-delims, sub-delims and "%" to ignore.
         */
        ret = xmlURIEscapeStr(path, BAD_CAST ":/?#[]@!$&()*+,;='%");
    } else {
        ret = xmlStrdup((const xmlChar *) path);
    }

    return(ret);
}

/**
 * xmlPathToURI: