URI/URL conversion

URI/URL stuff. More...

Functions

svn_boolean_t svn_path_is_url (const char *path)
 Return TRUE iff path looks like a valid absolute URL.
svn_boolean_t svn_path_is_uri_safe (const char *path)
 Return TRUE iff path is URI-safe, FALSE otherwise.
const char * svn_path_uri_encode (const char *path, apr_pool_t *pool)
 Return a URI-encoded copy of path, allocated in pool.
const char * svn_path_uri_decode (const char *path, apr_pool_t *pool)
 Return a URI-decoded copy of path, allocated in pool.
const char * svn_path_url_add_component (const char *url, const char *component, apr_pool_t *pool)
 Extend url by component, URI-encoding that component before adding it to the url; return the new url, allocated in pool.
const char * svn_path_uri_from_iri (const char *iri, apr_pool_t *pool)
 Convert iri (Internationalized URI) to an URI.
const char * svn_path_uri_autoescape (const char *uri, apr_pool_t *pool)
 URI-encode certain characters in uri that are not valid in an URI, but doesn't have any special meaning in uri at their positions.

Detailed Description

URI/URL stuff.


Function Documentation

const char* svn_path_uri_autoescape ( const char *  uri,
apr_pool_t *  pool 
)

URI-encode certain characters in uri that are not valid in an URI, but doesn't have any special meaning in uri at their positions.

If no characters need escaping, just return uri.

Note:
Currently, this function escapes <, >, ", space, {, }, |, \, ^, and `. This may be extended in the future to do context-dependent escaping.
Since:
New in 1.1.

const char* svn_path_uri_from_iri ( const char *  iri,
apr_pool_t *  pool 
)

Convert iri (Internationalized URI) to an URI.

The return value may be the same as iri if it was already a URI. Else, allocate the return value in pool.

Since:
New in 1.1.

const char* svn_path_url_add_component ( const char *  url,
const char *  component,
apr_pool_t *  pool 
)

Extend url by component, URI-encoding that component before adding it to the url; return the new url, allocated in pool.

If component is NULL, just return a copy of url, allocated in pool.

component need not be a single path segment, but if it contains multiple segments, they must be separated by '/'. component should not begin with '/', however; if it does, the behavior is undefined.

url need not be a canonical path; it may have a trailing '/'.

Note:
gstein suggests this for when component begins with '/':
"replace the path entirely https://example.com:4444/base/path joined with /leading/slash, should return: https://example.com:4444/leading/slash per the RFCs on combining URIs"

We may implement that someday, which is why leading '/' is merely undefined right now.


Generated on Sun Mar 1 17:18:35 2009 for Subversion by  doxygen 1.4.7