|  |  |  | GStreamer Base Plugins 1.0 Library Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
#include <gst/rtsp/gstrtspurl.h> #define GST_RTSP_DEFAULT_PORT struct GstRTSPUrl; GstRTSPResult gst_rtsp_url_parse (const gchar *urlstr,GstRTSPUrl **url); GstRTSPUrl * gst_rtsp_url_copy (const GstRTSPUrl *url); void gst_rtsp_url_free (GstRTSPUrl *url); gchar * gst_rtsp_url_get_request_uri (const GstRTSPUrl *url); GstRTSPResult gst_rtsp_url_set_port (GstRTSPUrl *url,guint16 port); GstRTSPResult gst_rtsp_url_get_port (const GstRTSPUrl *url,guint16 *port); gchar ** gst_rtsp_url_decode_path_components (const GstRTSPUrl *url);
struct GstRTSPUrl {
  GstRTSPLowerTrans  transports;
  GstRTSPFamily      family;
  gchar             *user;
  gchar             *passwd;
  gchar             *host;
  guint16            port;
  gchar             *abspath;
  gchar             *query;
};
This structure contains the result of a parsed RTSP URL
| GstRTSPLowerTrans  | the transports allowed | 
| GstRTSPFamily  | the family | 
| gchar * | the user | 
| gchar * | the password | 
| gchar * | the host | 
| the port | |
| gchar * | the absolute path | 
| gchar * | additional query parameters | 
GstRTSPResult gst_rtsp_url_parse (const gchar *urlstr,GstRTSPUrl **url);
Parse the RTSP urlstr into a newly allocated GstRTSPUrl. Free after usage
with gst_rtsp_url_free().
| 
 | the url string to parse | 
| 
 | location to hold the result. [out] | 
| Returns : | a GstRTSPResult. | 
GstRTSPUrl *        gst_rtsp_url_copy                   (const GstRTSPUrl *url);
Make a copy of url.
| 
 | a GstRTSPUrl | 
| Returns : | a copy of url. Free withgst_rtsp_url_free()after usage. | 
void                gst_rtsp_url_free                   (GstRTSPUrl *url);
Free the memory used by url.
| 
 | a GstRTSPUrl | 
gchar *             gst_rtsp_url_get_request_uri        (const GstRTSPUrl *url);
Get a newly allocated string describing the request URI for url.
| 
 | a GstRTSPUrl | 
| Returns : | a string with the request URI. g_free()after usage. | 
GstRTSPResult gst_rtsp_url_set_port (GstRTSPUrl *url,guint16 port);
Set the port number in url to port.
| 
 | a GstRTSPUrl | 
| 
 | the port | 
| Returns : | GST_RTSP_OK. | 
GstRTSPResult gst_rtsp_url_get_port (const GstRTSPUrl *url,guint16 *port);
Get the port number of url.
| 
 | a GstRTSPUrl | 
| 
 | location to hold the port | 
| Returns : | GST_RTSP_OK. | 
gchar **            gst_rtsp_url_decode_path_components (const GstRTSPUrl *url);
Splits the path of url on '/' boundaries, decoding the resulting components,
The decoding performed by this routine is "URI decoding", as defined in RFC 3986, commonly known as percent-decoding. For example, a string "foo%2fbar" will decode to "foo/bar" -- the %2f being replaced by the corresponding byte with hex value 0x2f. Note that there is no guarantee that the resulting byte sequence is valid in any given encoding. As a special case, %00 is not unescaped to NUL, as that would prematurely terminate the string.
Also note that since paths usually start with a slash, the first component will usually be the empty string.
| 
 | a GstRTSPUrl | 
| Returns : | a string vector. g_strfreev()after usage. |