1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT

use glib::translate::*;
use glib::GString;
use gst_rtsp_sys;
use std::ptr;
use RTSPResult;

glib_wrapper! {
    /// Provides helper functions to handle RTSP urls.
    #[derive(Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
    pub struct RTSPUrl(Boxed<gst_rtsp_sys::GstRTSPUrl>);

    match fn {
        copy => |ptr| gst_rtsp_sys::gst_rtsp_url_copy(mut_override(ptr)),
        free => |ptr| gst_rtsp_sys::gst_rtsp_url_free(ptr),
        get_type => || gst_rtsp_sys::gst_rtsp_url_get_type(),
    }
}

impl RTSPUrl {
    /// Splits the path of `self` 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.
    ///
    /// # Returns
    ///
    /// `None`-terminated array of URL components. Free with
    /// `g_strfreev` when no longer needed.
    pub fn decode_path_components(&self) -> Vec<GString> {
        unsafe {
            FromGlibPtrContainer::from_glib_full(gst_rtsp_sys::gst_rtsp_url_decode_path_components(
                self.to_glib_none().0,
            ))
        }
    }

    /// Get a newly allocated string describing the request URI for `self`.
    ///
    /// # Returns
    ///
    /// a string with the request URI. `g_free` after usage.
    pub fn get_request_uri(&self) -> Option<GString> {
        unsafe {
            from_glib_full(gst_rtsp_sys::gst_rtsp_url_get_request_uri(
                self.to_glib_none().0,
            ))
        }
    }

    /// Get a newly allocated string describing the request URI for `self`
    /// combined with the control path for `control_path`
    ///
    /// Feature: `v1_18`
    ///
    /// ## `control_path`
    /// an RTSP aggregate control path
    ///
    /// # Returns
    ///
    /// a string with the request URI combined with the control path.
    /// `g_free` after usage.
    #[cfg(any(feature = "v1_18", feature = "dox"))]
    pub fn get_request_uri_with_control(&self, control_path: &str) -> Option<GString> {
        unsafe {
            from_glib_full(gst_rtsp_sys::gst_rtsp_url_get_request_uri_with_control(
                self.to_glib_none().0,
                control_path.to_glib_none().0,
            ))
        }
    }

    /// Set the port number in `self` to `port`.
    /// ## `port`
    /// the port
    ///
    /// # Returns
    ///
    /// `RTSPResult::Ok`.
    pub fn set_port(&mut self, port: u16) -> RTSPResult {
        unsafe {
            from_glib(gst_rtsp_sys::gst_rtsp_url_set_port(
                self.to_glib_none_mut().0,
                port,
            ))
        }
    }

    /// Parse the RTSP `urlstr` into a newly allocated `RTSPUrl`. Free after usage
    /// with `RTSPUrl::free`.
    /// ## `urlstr`
    /// the url string to parse
    /// ## `url`
    /// location to hold the result.
    ///
    /// # Returns
    ///
    /// a `RTSPResult`.
    pub fn parse(urlstr: &str) -> (RTSPResult, RTSPUrl) {
        assert_initialized_main_thread!();
        unsafe {
            let mut url = ptr::null_mut();
            let ret = from_glib(gst_rtsp_sys::gst_rtsp_url_parse(
                urlstr.to_glib_none().0,
                &mut url,
            ));
            (ret, from_glib_full(url))
        }
    }
}

unsafe impl Send for RTSPUrl {}