Uri

A gstreamer.Uri object can be used to parse and split a URI string into its constituent parts. Two gstreamer.Uri objects can be joined to make a new gstreamer.Uri using the algorithm described in RFC3986.

class Uri {

GstUri* gstUri;

protected

bool ownedRef;

GstUri* getUriStruct(bool transferOwnership);

void* getStruct();

this(GstUri* gstUri, bool ownedRef);

static GType getType();

this(string scheme, string userinfo, string host, uint port, string path, string query, string fragment);

bool appendPath(string relativePath);

bool appendPathSegment(string pathSegment);

bool equal(Uri second);

Uri fromStringWithBase(string uri);

string getFragment();

string getHost();

HashTable getMediaFragmentTable();

string getPath();

ListG getPathSegments();

string getPathString();

uint getPort();

ListG getQueryKeys();

string getQueryString();

HashTable getQueryTable();

string getQueryValue(string queryKey);

string getScheme();

string getUserinfo();

bool isNormalized();

bool isWritable();

Uri join(Uri refUri);

Uri makeWritable();

Uri newWithBase(string scheme, string userinfo, string host, uint port, string path, string query, string fragment);

bool normalize();

bool queryHasKey(string queryKey);

bool removeQueryKey(string queryKey);

bool setFragment(string fragment);

bool setHost(string host);

bool setPath(string path);

bool setPathSegments(ListG pathSegments);

bool setPathString(string path);

bool setPort(uint port);

bool setQueryString(string query);

bool setQueryTable(HashTable queryTable);

bool setQueryValue(string queryKey, string queryValue);

bool setScheme(string scheme);

bool setUserinfo(string userinfo);

string toString();

static string construct(string protocol, string location);

static Uri fromString(string uri);

static string getLocation(string uri);

static string getProtocol(string uri);

static bool hasProtocol(string uri, string protocol);

static bool isValid(string uri);

static string joinStrings(string baseUri, string refUri);

static bool protocolIsSupported(GstURIType type, string protocol);

static bool protocolIsValid(string protocol);

static string filenameToUri(string filename);

static GQuark uriErrorQuark();

}

Constructors

this this(GstUri* gstUri, bool ownedRef): Sets our main struct and passes it to the parent class.
this this(string scheme, string userinfo, string host, uint port, string path, string query, string fragment): Creates a new gstreamer.Uri object with the given URI parts. The path and query strings will be broken down into their elements. All strings should not be escaped except where indicated.

Members

Functions

appendPath bool appendPath(string relativePath): Append a path onto the end of the path in the URI. The path is not normalized, call gst_uri_normalize|gst_uri_normalize to normalize the path.
appendPathSegment bool appendPathSegment(string pathSegment): Append a single path segment onto the end of the URI path.
equal bool equal(Uri second): Compares two gstreamer.Uri objects to see if they represent the same normalized URI.
fromStringWithBase Uri fromStringWithBase(string uri): Like Uri.fromString but also joins with a base URI.
getFragment string getFragment(): Get the fragment name from the URI or NULL if it doesn't exist. If uri is NULL then returns NULL.
getHost string getHost(): Get the host name from the URI or NULL if it doesn't exist. If uri is NULL then returns NULL.
getMediaFragmentTable HashTable getMediaFragmentTable(): Get the media fragment table from the URI, as defined by "Media Fragments URI 1.0". Hash table returned by this API is a list of "key-value" pairs, and the each pair is generated by splitting "URI fragment" per "&" sub-delims, then "key" and "value" are split by "=" sub-delims. The "key" returned by this API may be undefined keyword by standard. A value may be NULL to indicate that the key should appear in the fragment string in the URI, but does not have a value. Free the returned glib.HashTable with g_hash_table_unref|g_hash_table_unref when it is no longer required. Modifying this hash table does not affect the fragment in the URI.
getPath string getPath(): Extract the path string from the URI object.
getPathSegments ListG getPathSegments(): Get a list of path segments from the URI.
getPathString string getPathString(): Extract the path string from the URI object as a percent encoded URI path.
getPort uint getPort(): Get the port number from the URI or GST_URI_NO_PORT if it doesn't exist. If uri is NULL then returns GST_URI_NO_PORT.
getQueryKeys ListG getQueryKeys(): Get a list of the query keys from the URI.
getQueryString string getQueryString(): Get a percent encoded URI query string from the uri.
getQueryTable HashTable getQueryTable(): Get the query table from the URI. Keys and values in the table are freed with g_free when they are deleted. A value may be NULL to indicate that the key should appear in the query string in the URI, but does not have a value. Free the returned glib.HashTable with g_hash_table_unref|g_hash_table_unref when it is no longer required. Modifying this hash table will modify the query in the URI.
getQueryValue string getQueryValue(string queryKey): Get the value associated with the query_key key. Will return NULL if the key has no value or if the key does not exist in the URI query table. Because NULL is returned for both missing keys and keys with no value, you should use Uri.queryHasKey to determine if a key is present in the URI query.
getScheme string getScheme(): Get the scheme name from the URI or NULL if it doesn't exist. If uri is NULL then returns NULL.
getStruct void* getStruct(): the main Gtk struct as a void*
getUriStruct GstUri* getUriStruct(bool transferOwnership): Get the main Gtk struct
getUserinfo string getUserinfo(): Get the userinfo (usually in the form "username:password") from the URI or NULL if it doesn't exist. If uri is NULL then returns NULL.
isNormalized bool isNormalized(): Tests the uri to see if it is normalized. A NULL uri is considered to be normalized.
isWritable bool isWritable(): Check if it is safe to write to this gstreamer.Uri
join Uri join(Uri refUri): Join a reference URI onto a base URI using the method from RFC 3986. If either URI is NULL then the other URI will be returned with the ref count increased.
makeWritable Uri makeWritable(): Make the gstreamer.Uri writable.
newWithBase Uri newWithBase(string scheme, string userinfo, string host, uint port, string path, string query, string fragment): Like Uri.new, but joins the new URI onto a base URI.
normalize bool normalize(): Normalization will remove extra path segments ("." and "..") from the URI. It will also convert the scheme and host name to lower case and any percent-encoded values to uppercase.
queryHasKey bool queryHasKey(string queryKey): Check if there is a query table entry for the query_key key.
removeQueryKey bool removeQueryKey(string queryKey): Remove an entry from the query table by key.
setFragment bool setFragment(string fragment): Sets the fragment string in the URI. Use a value of NULL in fragment to unset the fragment string.
setHost bool setHost(string host): Set or unset the host for the URI.
setPath bool setPath(string path): Sets or unsets the path in the URI.
setPathSegments bool setPathSegments(ListG pathSegments): Replace the path segments list in the URI.
setPathString bool setPathString(string path): Sets or unsets the path in the URI.
setPort bool setPort(uint port): Set or unset the port number for the URI.
setQueryString bool setQueryString(string query): Sets or unsets the query table in the URI.
setQueryTable bool setQueryTable(HashTable queryTable): Set the query table to use in the URI. The old table is unreferenced and a reference to the new one is used instead. A value if NULL for query_table will remove the query string from the URI.
setQueryValue bool setQueryValue(string queryKey, string queryValue): This inserts or replaces a key in the query table. A query_value of NULL indicates that the key has no associated value, but will still be present in the query string.
setScheme bool setScheme(string scheme): Set or unset the scheme for the URI.
setUserinfo bool setUserinfo(string userinfo): Set or unset the user information for the URI.
toString string toString(): Convert the URI to a string.

Static functions

construct string construct(string protocol, string location): Constructs a URI for a given valid protocol and location.
filenameToUri string filenameToUri(string filename): Similar to g_filename_to_uri(), but attempts to handle relative file paths as well. Before converting filename into an URI, it will be prefixed by the current working directory if it is a relative path, and then the path will be canonicalised so that it doesn't contain any './' or '../' segments.
fromString Uri fromString(string uri): Parses a URI string into a new gstreamer.Uri object. Will return NULL if the URI cannot be parsed.
getLocation string getLocation(string uri): Extracts the location out of a given valid URI, ie. the protocol and "://" are stripped from the URI, which means that the location returned includes the hostname if one is specified. The returned string must be freed using g_free().
getProtocol string getProtocol(string uri): Extracts the protocol out of a given valid URI. The returned string must be freed using g_free().
getType GType getType()
hasProtocol bool hasProtocol(string uri, string protocol): Checks if the protocol of a given valid URI matches protocol.
isValid bool isValid(string uri): Tests if the given string is a valid URI identifier. URIs start with a valid scheme followed by ":" and maybe a string identifying the location.
joinStrings string joinStrings(string baseUri, string refUri): This is a convenience function to join two URI strings and return the result. The returned string should be g_free()'d after use.
protocolIsSupported bool protocolIsSupported(GstURIType type, string protocol): Checks if an element exists that supports the given URI protocol. Note that a positive return value does not imply that a subsequent call to Element.makeFromUri is guaranteed to work.
protocolIsValid bool protocolIsValid(string protocol): Tests if the given string is a valid protocol identifier. Protocols must consist of alphanumeric characters, '+', '-' and '.' and must start with a alphabetic character. See RFC 3986 Section 3.1.
uriErrorQuark GQuark uriErrorQuark()

Variables

gstUri GstUri* gstUri;: the main Gtk struct

gstreamer Uri classes

Uri