gurifuncs.h File Reference

__G_URI_FUNCS_H__

G_URI_RESERVED_CHARS_GENERIC_DELIMITERS

G_URI_RESERVED_CHARS_GENERIC_DELIMITERS:

Generic delimiters characters as defined in RFC 3986. Includes ":/?#[]@".

G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS

G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS

Subcomponent delimiter characters as defined in RFC 3986. Includes "!$&'()*+,;=".

G_URI_RESERVED_CHARS_ALLOWED_IN_PATH_ELEMENT

G_URI_RESERVED_CHARS_ALLOWED_IN_PATH_ELEMENT:

Allowed characters in path elements. Includes "!$&'()*+,;=:@".

G_URI_RESERVED_CHARS_ALLOWED_IN_PATH

G_URI_RESERVED_CHARS_ALLOWED_IN_PATH:

Allowed characters in a path. Includes "!$&'()*+,;=:@/".

G_URI_RESERVED_CHARS_ALLOWED_IN_USERINFO

G_URI_RESERVED_CHARS_ALLOWED_IN_USERINFO:

Allowed characters in userinfo as defined in RFC 3986. Includes "!$&'()*+,;=:".

g_uri_unescape_string ( const char *, const char * )

IMPORT_C char *g_uri_unescape_string(const char *escaped_string,
const char *illegal_characters
)

g_uri_unescape_string: : an escaped string to be unescaped. : an optional string of illegal characters not to be allowed.

Unescapes a whole escaped string.

If any of the characters in or the character zero appears as an escaped character in then that is an error and NULL will be returned. This is useful it you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname handling.

Returns: an unescaped version of . The returned string should be freed when no longer needed.

Since: 2.16

g_uri_unescape_segment ( const char *, const char *, const char * )

IMPORT_C char *g_uri_unescape_segment(const char *escaped_string,
const char *escaped_string_end,
const char *illegal_characters
)

g_uri_unescape_segment: : a string. : a string. : an optional string of illegal characters not to be allowed.

Unescapes a segment of an escaped string.

If any of the characters in or the character zero appears as an escaped character in then that is an error and NULL will be returned. This is useful it you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname handling.

Returns: an unescaped version of or NULL on error. The returned string should be freed when no longer needed.

Since: 2.16

g_uri_parse_scheme ( const char * )

IMPORT_C char *g_uri_parse_scheme(const char *uri)

g_uri_parse_scheme: : a valid URI.

Gets the scheme portion of a URI string. RFC 3986 decodes the scheme as: <programlisting> URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] </programlisting> Common schemes include "file", "http", "svn+ssh", etc.

Returns: The "Scheme" component of the URI, or NULL on error. The returned string should be freed when no longer needed.

Since: 2.16

g_uri_escape_string ( const char *, const char *, gboolean )

IMPORT_C char *g_uri_escape_string(const char *unescaped,
const char *reserved_chars_allowed,
gbooleanallow_utf8
)

g_uri_escape_string: : the unescaped input string. : a string of reserved characters that are allowed to be used. : TRUE if the result can include UTF-8 characters.

Escapes a string for use in a URI.

Normally all characters that are not "unreserved" (i.e. ASCII alphanumerical characters plus dash, dot, underscore and tilde) are escaped. But if you specify characters in they are not escaped. This is useful for the "reserved" characters in the URI specification, since those are allowed unescaped in some portions of a URI.

Returns: an escaped version of . The returned string should be freed when no longer needed.

Since: 2.16