// 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,
            ))
        }
    }

    /// 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 {}