| Swfdec Reference Manual | ||||
|---|---|---|---|---|
#include <swfdec/swfdec.h>
SwfdecURL;
SwfdecURL* swfdec_url_new (const char *string);
SwfdecURL* swfdec_url_new_from_input (const char *input);
SwfdecURL* swfdec_url_new_components (const char *protocol,
const char *hostname,
guint port,
const char *path,
const char *query);
SwfdecURL* swfdec_url_new_relative (const SwfdecURL *url,
const char *string);
SwfdecURL* swfdec_url_new_parent (const SwfdecURL *url);
SwfdecURL* swfdec_url_copy (const SwfdecURL *url);
void swfdec_url_free (SwfdecURL *url);
const char* swfdec_url_get_protocol (const SwfdecURL *url);
gboolean swfdec_url_has_protocol (const SwfdecURL *url,
const char *protocol);
const char* swfdec_url_get_host (const SwfdecURL *url);
guint swfdec_url_get_port (const SwfdecURL *url);
const char* swfdec_url_get_path (const SwfdecURL *url);
const char* swfdec_url_get_query (const SwfdecURL *url);
const char* swfdec_url_get_url (const SwfdecURL *url);
gboolean swfdec_url_is_local (const SwfdecURL *url);
gboolean swfdec_url_is_parent (const SwfdecURL *parent,
const SwfdecURL *child);
char* swfdec_url_format_for_display (const SwfdecURL *url);
gboolean swfdec_url_equal (gconstpointer a,
gconstpointer b);
guint swfdec_url_hash (gconstpointer url);
gboolean swfdec_url_path_is_relative (const char *path);
SwfdecURL is Swfdec's way of handling URLs. You probably don't need to mess
with this type unless you want to write a SwfdecLoader. In that case you
will want to use swfdec_loader_get_url() to get its url and then use the
functions in this section to access it.
see_also: SwfdecLoader
typedef struct _SwfdecURL SwfdecURL;
this is the structure used for URLs. It is a boxed type to glib's type system and it is not reference counted. It is also a static struct in that it cannot be modified after creation.
SwfdecURL* swfdec_url_new (const char *string);
Parses the given string into a URL for use in swfdec.
SwfdecURL* swfdec_url_new_from_input (const char *input);
Tries to guess the right URL from the given input. This function is meant
as a utility function helping to convert user input (like command line
arguments) to a URL without requiring the full URL.
|
the input povided |
Returns : |
a new url best matching the given input.
|
SwfdecURL* swfdec_url_new_components (const char *protocol, const char *hostname, guint port, const char *path, const char *query);
Creates a new URL from the given components.
SwfdecURL* swfdec_url_new_relative (const SwfdecURL *url, const char *string);
Parses string into a new URL. If the given string is a relative URL, it
uses url to resolve it to an absolute url; url must already contain a
directory path.
SwfdecURL* swfdec_url_new_parent (const SwfdecURL *url);
Creates a new url that is the parent of url. If the given url has no
parent, a copy of itself is returned.
void swfdec_url_free (SwfdecURL *url);
Frees the URL and its associated ressources.
|
a SwfdecURL |
const char* swfdec_url_get_protocol (const SwfdecURL *url);
Gets the protocol used by this URL, such as "http" or "file".
|
a SwfdecURL |
Returns : |
the protocol used or "error" if the URL is broken |
gboolean swfdec_url_has_protocol (const SwfdecURL *url, const char *protocol);
Checks if the given url references the given protocol
const char* swfdec_url_get_host (const SwfdecURL *url);
Gets the host for url as a lower case string.
guint swfdec_url_get_port (const SwfdecURL *url);
Gets the port number specified by the given url. If the url does not
specify a port number, 0 will be returned.
|
a SwfdecURL |
Returns : |
the specified port or 0 if none was given. |
const char* swfdec_url_get_path (const SwfdecURL *url);
Gets the path associated with url. If it contains no path, NULL is
returned.
const char* swfdec_url_get_query (const SwfdecURL *url);
Gets the query string associated with url. If the URL does not have a query
string, NULL is returned.
const char* swfdec_url_get_url (const SwfdecURL *url);
Gets the whole URL.
|
a SwfdecURL |
Returns : |
the complete URL as string |
gboolean swfdec_url_is_local (const SwfdecURL *url);
Checks if the given url references a local resource. Local resources are
treated differently by Flash, since they get a higher degree of trust.
|
the url to check |
Returns : |
TRUE if the given url is local.
|
gboolean swfdec_url_is_parent (const SwfdecURL *parent, const SwfdecURL *child);
Checks if the given parent url is a parent url of the given child url. The
algorithm used is the same as checking policy files if hey apply. If parent
equals child, TRUE is returned. This function does not compare query
strings.
char* swfdec_url_format_for_display (const SwfdecURL *url);
Creates a string suitable to display the given url. An example for using
this function is to identify a currently playing Flash URL. Use
swfdec_player_get_url() to query the player's URL and then use this function
to get a displayable string.
|
the url to display |
Returns : |
A new string containig a short description for this URL. g_free()
after use.
|
gboolean swfdec_url_equal (gconstpointer a, gconstpointer b);
Compares the 2 given URLs for equality. 2 URLs are considered equal, when
they point to the same resource. This function is intended to be
used together with swfdec_url_hash() in a GHashtable.
guint swfdec_url_hash (gconstpointer url);
Creates a hash value for the given url. This function is intended to be
used together with swfdec_url_equal() in a GHashtable.
|
a SwfdecURL |
Returns : |
a hash value |