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

// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// from gst-gir-files (https://gitlab.freedesktop.org/gstreamer/gir-files-rs.git)
// DO NOT EDIT

use crate::RTSPResult;
use glib::translate::*;
use std::ptr;

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

    match fn {
        copy => |ptr| ffi::gst_rtsp_url_copy(ptr),
        free => |ptr| ffi::gst_rtsp_url_free(ptr),
        type_ => || ffi::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.
    #[doc(alias = "gst_rtsp_url_decode_path_components")]
    pub fn decode_path_components(&self) -> Vec<glib::GString> {
        unsafe {
            FromGlibPtrContainer::from_glib_full(ffi::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.
    #[doc(alias = "gst_rtsp_url_get_request_uri")]
    #[doc(alias = "get_request_uri")]
    pub fn request_uri(&self) -> Option<glib::GString> {
        unsafe { from_glib_full(ffi::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`
    /// ## `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"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v1_18")))]
    #[doc(alias = "gst_rtsp_url_get_request_uri_with_control")]
    #[doc(alias = "get_request_uri_with_control")]
    pub fn request_uri_with_control(&self, control_path: &str) -> Option<glib::GString> {
        unsafe {
            from_glib_full(ffi::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`][crate::RTSPResult::Ok].
    #[doc(alias = "gst_rtsp_url_set_port")]
    pub fn set_port(&mut self, port: u16) -> RTSPResult {
        unsafe { from_glib(ffi::gst_rtsp_url_set_port(self.to_glib_none_mut().0, port)) }
    }

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

unsafe impl Send for RTSPUrl {}