IF YOU WOULD LIKE TO GET AN ACCOUNT, please write an
email to Administrator. User accounts are meant only to access repo
and report issues and/or generate pull requests.
This is a purpose-specific Git hosting for
BaseALT
projects. Thank you for your understanding!
Только зарегистрированные пользователи имеют доступ к сервису!
Для получения аккаунта, обратитесь к администратору.
</pre><p>Expresses the URI of the <ahref="libxml-SAX.html#reference">reference</a> in terms relative to the base. Some examples of this operation include: base = "http://site1.com/docs/book1.html" URI input URI returned docs/pic1.gif pic1.gif docs/img/pic1.gif img/pic1.gif img/pic1.gif ../img/pic1.gif http://site1.com/docs/pic1.gif pic1.gif http://site2.com/docs/pic1.gif http://site2.com/docs/pic1.gif base = "docs/book1.html" URI input URI returned docs/pic1.gif pic1.gif docs/img/pic1.gif img/pic1.gif img/pic1.gif ../img/pic1.gif http://site1.com/docs/pic1.gif http://site1.com/docs/pic1.gif Note: if the URI <ahref="libxml-SAX.html#reference">reference</a> is really wierd or complicated, it may be worthwhile to first convert it into a "nice" one by calling <ahref="libxml-uri.html#xmlBuildURI">xmlBuildURI</a> (using 'base') before calling this routine, since this routine (for reasonable efficiency) assumes URI has already been through some validation.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>URI</tt></i>:</span></td><td>the URI <ahref="libxml-SAX.html#reference">reference</a> under consideration</td></tr><tr><td><spanclass="term"><i><tt>base</tt></i>:</span></td><td>the base value</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new URI string (to be freed by the caller) or NULL in case error.</td></tr></tbody></table></div><h3><aname="xmlBuildURI"id="xmlBuildURI"></a>Function: xmlBuildURI</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlBuildURI (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * URI, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * base)<br/>
</pre><p>Computes he final URI of the <ahref="libxml-SAX.html#reference">reference</a> done by checking that the given URI is valid, and building the final URI using the base URI. This is processed according to section 5.2 of the RFC 2396 5.2. Resolving Relative References to Absolute Form</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>URI</tt></i>:</span></td><td>the URI instance found in the document</td></tr><tr><td><spanclass="term"><i><tt>base</tt></i>:</span></td><td>the base value</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new URI string (to be freed by the caller) or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlCanonicPath"id="xmlCanonicPath"></a>Function: xmlCanonicPath</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlCanonicPath (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * path)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>path</tt></i>:</span></td><td>the resource locator in a filesystem notation</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new canonic path, or a duplicate of the path parameter if the construction fails. The caller is responsible for freeing the memory occupied by the returned string. If there is insufficient memory available, or the argument is NULL, the function returns NULL.</td></tr></tbody></table></div><h3><aname="xmlCreateURI"id="xmlCreateURI"></a>Function: xmlCreateURI</h3><preclass="programlisting"><ahref="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> xmlCreateURI (void)<br/>
</pre><p>Simply creates an empty <ahref="libxml-uri.html#xmlURI">xmlURI</a></p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new structure or NULL in case of error</td></tr></tbody></table></div><h3><aname="xmlFreeURI"id="xmlFreeURI"></a>Function: xmlFreeURI</h3><preclass="programlisting">void xmlFreeURI (<ahref="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>uri</tt></i>:</span></td><td>pointer to an <ahref="libxml-uri.html#xmlURI">xmlURI</a></td></tr></tbody></table></div><h3><aname="xmlNormalizeURIPath"id="xmlNormalizeURIPath"></a>Function: xmlNormalizeURIPath</h3><preclass="programlisting">int xmlNormalizeURIPath (char * path)<br/>
</pre><p>Applies the 5 normalization steps to a path string--that is, RFC 2396 Section 5.2, steps 6.c through 6.g. Normalization occurs directly on the string, no new allocation is done</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>path</tt></i>:</span></td><td>pointer to the path string</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 or an error code</td></tr></tbody></table></div><h3><aname="xmlParseURI"id="xmlParseURI"></a>Function: xmlParseURI</h3><preclass="programlisting"><ahref="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> xmlParseURI (const char * str)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the URI string to analyze</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a newly built <ahref="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> or NULL in case of error</td></tr></tbody></table></div><h3><aname="xmlParseURIRaw"id="xmlParseURIRaw"></a>Function: xmlParseURIRaw</h3><preclass="programlisting"><ahref="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> xmlParseURIRaw (const char * str, <br/> int raw)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the URI string to analyze</td></tr><tr><td><spanclass="term"><i><tt>raw</tt></i>:</span></td><td>if 1 unescaping of URI pieces are disabled</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a newly built <ahref="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> or NULL in case of error</td></tr></tbody></table></div><h3><aname="xmlParseURIReference"id="xmlParseURIReference"></a>Function: xmlParseURIReference</h3><preclass="programlisting">int xmlParseURIReference (<ahref="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri, <br/> const char * str)<br/>
</pre><p>Parse an URI <ahref="libxml-SAX.html#reference">reference</a> string based on RFC 3986 and fills in the appropriate fields of the @uri structure URI-reference = URI / relative-ref</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>uri</tt></i>:</span></td><td>pointer to an URI structure</td></tr><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the string to analyze</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 or the error code</td></tr></tbody></table></div><h3><aname="xmlPathToURI"id="xmlPathToURI"></a>Function: xmlPathToURI</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlPathToURI (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * path)<br/>
</pre><p>Constructs an URI expressing the existing path</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>path</tt></i>:</span></td><td>the resource locator in a filesystem notation</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new URI, or a duplicate of the path parameter if the construction fails. The caller is responsible for freeing the memory occupied by the returned string. If there is insufficient memory available, or the argument is NULL, the function returns NULL.</td></tr></tbody></table></div><h3><aname="xmlPrintURI"id="xmlPrintURI"></a>Function: xmlPrintURI</h3><preclass="programlisting">void xmlPrintURI (FILE * stream, <br/><ahref="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>stream</tt></i>:</span></td><td>a FILE* for the output</td></tr><tr><td><spanclass="term"><i><tt>uri</tt></i>:</span></td><td>pointer to an <ahref="libxml-uri.html#xmlURI">xmlURI</a></td></tr></tbody></table></div><h3><aname="xmlSaveUri"id="xmlSaveUri"></a>Function: xmlSaveUri</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlSaveUri (<ahref="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>uri</tt></i>:</span></td><td>pointer to an <ahref="libxml-uri.html#xmlURI">xmlURI</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new string (to be deallocated by caller)</td></tr></tbody></table></div><h3><aname="xmlURIEscape"id="xmlURIEscape"></a>Function: xmlURIEscape</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlURIEscape (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * str)<br/>
</pre><p>Escaping routine, does not do validity checks ! It will try to escape the chars needing this, but this is heuristic based it's impossible to be sure.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the string of the URI to escape</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>an copy of the string, but escaped 25 May 2001 Uses <ahref="libxml-uri.html#xmlParseURI">xmlParseURI</a> and <ahref="libxml-uri.html#xmlURIEscapeStr">xmlURIEscapeStr</a> to try to escape correctly according to RFC2396. - Carl Douglas</td></tr></tbody></table></div><h3><aname="xmlURIEscapeStr"id="xmlURIEscapeStr"></a>Function: xmlURIEscapeStr</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlURIEscapeStr (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * str, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * list)<br/>
</pre><p>This routine escapes a string to hex, ignoring reserved <ahref="libxml-SAX.html#characters">characters</a> (a-z) and the <ahref="libxml-SAX.html#characters">characters</a> in the exception list.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>string to escape</td></tr><tr><td><spanclass="term"><i><tt>list</tt></i>:</span></td><td>exception list string of chars not to escape</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new escaped string or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlURIUnescapeString"id="xmlURIUnescapeString"></a>Function: xmlURIUnescapeString</h3><preclass="programlisting">char * xmlURIUnescapeString (const char * str, <br/> int len, <br/> char * target)<br/>
</pre><p>Unescaping routine, but does not check that the string is an URI. The output is a direct unsigned char translation of %XX values (no encoding) Note that the length of the result can only be smaller or same size as the input string.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the string to unescape</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the length in bytes to unescape (or <= 0 to indicate full string)</td></tr><tr><td><spanclass="term"><i><tt>target</tt></i>:</span></td><td>optional destination buffer</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a copy of the string, but unescaped, will return NULL only in case of error</td></tr></tbody></table></div><p><ahref="../bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
