Evolution Connector for Microsoft Exchange Programmer’s Reference Manual | ||||
---|---|---|---|---|
Top | Description |
Synopsis
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
);
Details
E2kUri
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;
e2k_uri_new ()
E2kUri * e2k_uri_new (const gchar *uri_string
);
Parses uri_string
.
|
the URI |
Returns : |
a parsed E2kUri
|
e2k_uri_get_param ()
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 , or NULL if it is not set
|
e2k_uri_decode ()
void e2k_uri_decode (gchar *part
);
Undoes URI-escaping in part
in-place.
|
a piece of a URI |
e2k_uri_encode ()
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 |
e2k_uri_append_encoded ()
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 GString containing 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
|
e2k_uri_path ()
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 .
|
e2k_uri_concat ()
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 |
e2k_uri_relative ()
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 |