|  |  |  | Evolution Connector for Microsoft Exchange Programmer’s Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
E2kUri; E2kUri * e2k_uri_new (const gchar *uri_string); void e2k_uri_free (E2kUri *uri); const gchar * e2k_uri_get_param (E2kUri *uri,const gchar *name); void e2k_uri_decode (gchar *part); gchar * e2k_uri_encode (const gchar *in,gboolean wss_encode,const gchar *extra_enc_chars); void e2k_uri_append_encoded (GString *str,const gchar *in,gboolean wss_encode,const gchar *extra_enc_chars); const gchar * e2k_uri_path (const gchar *uri_string); gchar * e2k_uri_concat (const gchar *uri_prefix,const gchar *tail); const gchar * e2k_uri_relative (const gchar *uri_prefix,const gchar *uri);
typedef struct {
	gchar  *protocol;
	gchar  *user;
	gchar  *domain;
	gchar  *authmech;
	gchar  *passwd;
	gchar  *host;
	gint    port;
	gchar  *path;
	GData *params;
	gchar  *query;
	gchar  *fragment;
} E2kUri;
E2kUri *            e2k_uri_new                         (const gchar *uri_string);
Parses uri_string.
| 
 | the URI | 
| Returns : | a parsed E2kUri | 
const gchar * e2k_uri_get_param (E2kUri *uri,const gchar *name);
Fetches a parameter from uri
| 
 | an E2kUri | 
| 
 | name of the parameter | 
| Returns : | the value of name, orNULLif it is not set | 
void                e2k_uri_decode                      (gchar *part);
Undoes URI-escaping in part in-place.
| 
 | a piece of a URI | 
gchar * e2k_uri_encode (const gchar *in,gboolean wss_encode,const gchar *extra_enc_chars);
Encodes URI-unsafe characters as in e2k_uri_append_encoded()
| 
 | data to encode | 
| 
 | whether or not to use the special Web Storage System encoding rules | 
| 
 | additional characters beyond the normal URI-reserved
characters to encode when appending to str | 
| Returns : | the encoded string | 
void e2k_uri_append_encoded (GString *str,const gchar *in,gboolean wss_encode,const gchar *extra_enc_chars);
Appends in to str, encoding URI-unsafe characters as needed
(optionally including some Exchange-specific encodings).
When appending a path, you must append each segment separately;
e2k_uri_append_encoded() will encode any "/"s passed in.
| 
 | a GStringcontaining part of a URI | 
| 
 | data to append to str | 
| 
 | whether or not to use the special Web Storage System encoding rules | 
| 
 | additional characters beyond the normal URI-reserved
characters to encode when appending to str | 
const gchar *       e2k_uri_path                        (const gchar *uri_string);
Returns the path component of uri_string, including the initial
"/". (The return value is actually a pointer into the passed-in
string, meaning this will only really work if the URI has no
query/fragment/etc.)
| 
 | a well-formed absolute URI | 
| Returns : | the path component of uri_string. | 
gchar * e2k_uri_concat (const gchar *uri_prefix,const gchar *tail);
Constructs a new URI consisting of the concatenation of
uri_prefix and tail. If uri_prefix does not end with a "/",
one will be inserted between uri_prefix and tail.
| 
 | an absolute URI | 
| 
 | a relative path | 
| Returns : | the new URI | 
const gchar * e2k_uri_relative (const gchar *uri_prefix,const gchar *uri);
Returns a URI describing uri's relation to uri_prefix; either a
relative URI consisting of the subpath of uri underneath
uri_prefix, or all of uri if it is not a sub-uri of uri_prefix.
| 
 | an absolute URI | 
| 
 | another URI, presumably a child of uri_prefix | 
| Returns : | the relative URI |