GStreamer Base Plugins 0.10 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 |
guint16 |
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. |
Returns : |
a GstRTSPResult. |
GstRTSPUrl * gst_rtsp_url_copy (const GstRTSPUrl *url
);
Make a copy of url
.
|
a GstRTSPUrl |
Returns : |
a copy of url . Free with gst_rtsp_url_free() after usage. |
Since 0.10.22
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 "foo2fbar
"
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. |
Since 0.10.32