gstrtspurl

gstrtspurl — handling RTSP urls

Functions

Types and Values

Object Hierarchy


Includes

#include <gst/rtsp/gstrtspurl.h>

Description

Provides helper functions to handle RTSP urls.

Last reviewed on 2007-07-25 (0.10.14)

Functions

gst_rtsp_url_parse ()

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().

Parameters

urlstr

the url string to parse

 

url

location to hold the result.

[out]

Returns

a GstRTSPResult.


gst_rtsp_url_copy ()

GstRTSPUrl *
gst_rtsp_url_copy (const GstRTSPUrl *url);

Make a copy of url .

Parameters

url

a GstRTSPUrl

 

Returns

a copy of url . Free with gst_rtsp_url_free() after usage.


gst_rtsp_url_free ()

void
gst_rtsp_url_free (GstRTSPUrl *url);

Free the memory used by url .

Parameters

url

a GstRTSPUrl

 

gst_rtsp_url_get_request_uri ()

gchar *
gst_rtsp_url_get_request_uri (const GstRTSPUrl *url);

Get a newly allocated string describing the request URI for url .

Parameters

url

a GstRTSPUrl

 

Returns

a string with the request URI. g_free() after usage.


gst_rtsp_url_set_port ()

GstRTSPResult
gst_rtsp_url_set_port (GstRTSPUrl *url,
                       guint16 port);

Set the port number in url to port .

Parameters

url

a GstRTSPUrl

 

port

the port

 

Returns

GST_RTSP_OK.


gst_rtsp_url_get_port ()

GstRTSPResult
gst_rtsp_url_get_port (const GstRTSPUrl *url,
                       guint16 *port);

Get the port number of url .

Parameters

url

a GstRTSPUrl

 

port

location to hold the port

 

Returns

GST_RTSP_OK.


gst_rtsp_url_decode_path_components ()

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.

Parameters

url

a GstRTSPUrl

 

Returns

a string vector. g_strfreev() after usage.

Types and Values

GST_RTSP_DEFAULT_PORT

#define GST_RTSP_DEFAULT_PORT       554

The default RTSP port to connect to.


struct GstRTSPUrl

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

Members

GstRTSPLowerTrans transports;

the transports allowed

 

GstRTSPFamily family;

the family

 

gchar *user;

the user

 

gchar *passwd;

the password

 

gchar *host;

the host

 

guint16 port;

the port

 

gchar *abspath;

the absolute path

 

gchar *query;

additional query parameters