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

// 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 RTSPResult;
use ffi;
use glib::translate::*;
use glib_ffi;
use gobject_ffi;
use std::mem;
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(mut_override(ptr)),
        free => |ptr| ffi::gst_rtsp_url_free(ptr),
        get_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.
    pub fn decode_path_components(&self) -> Vec<String> {
        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.
    pub fn get_request_uri(&self) -> Option<String> {
        unsafe {
            from_glib_full(ffi::gst_rtsp_url_get_request_uri(self.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(ffi::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(ffi::gst_rtsp_url_parse(urlstr.to_glib_none().0, &mut url));
            (ret, from_glib_full(url))
        }
    }
}

unsafe impl Send for RTSPUrl {}