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

use FormatOptions;
use ParamList;
use ParserOptions;
use ffi;
use glib::object::IsA;
use glib::translate::*;
use glib_ffi;
use gobject_ffi;
use std::mem;
use std::ptr;

glib_wrapper! {
    /// A data structure representing a Content-Type.
    ///
    /// # Implements
    ///
    /// [`ContentTypeExt`](trait.ContentTypeExt.html)
    pub struct ContentType(Object<ffi::GMimeContentType, ffi::GMimeContentTypeClass>);

    match fn {
        get_type => || ffi::g_mime_content_type_get_type(),
    }
}

impl ContentType {
    /// Creates a Content-Type object with type `type_` and subtype `subtype`.
    /// ## `type_`
    /// the MIME type or `None` for the default value
    /// ## `subtype`
    /// the MIME subtype or `None` for the default value
    ///
    /// # Returns
    ///
    /// a new `ContentType` object.
    pub fn new(type_: &str, subtype: &str) -> ContentType {
        unsafe {
            from_glib_full(ffi::g_mime_content_type_new(type_.to_glib_none().0, subtype.to_glib_none().0))
        }
    }

    /// Parses the input string into a `ContentType` object.
    /// ## `options`
    /// a `ParserOptions` or `None`
    /// ## `str`
    /// input string containing a content-type (and params)
    ///
    /// # Returns
    ///
    /// a new `ContentType` object.
    pub fn parse<'a, P: Into<Option<&'a ParserOptions>>>(options: P, str: &str) -> Option<ContentType> {
        let options = options.into();
        unsafe {
            from_glib_full(ffi::g_mime_content_type_parse(mut_override(options.to_glib_none().0), str.to_glib_none().0))
        }
    }
}

/// Trait containing all `ContentType` methods.
///
/// # Implementors
///
/// [`ContentType`](struct.ContentType.html)
pub trait ContentTypeExt {
    /// Encodes the Content-Disposition header.
    /// ## `options`
    /// a `FormatOptions` or `None`
    ///
    /// # Returns
    ///
    /// a new string containing the encoded header value.
    fn encode<'a, P: Into<Option<&'a FormatOptions>>>(&self, options: P) -> Option<String>;

    /// Gets the Content-Type's media sub-type.
    ///
    /// # Returns
    ///
    /// the Content-Type's media sub-type.
    fn get_media_subtype(&self) -> Option<String>;

    /// Gets the Content-Type's media type.
    ///
    /// # Returns
    ///
    /// the Content-Type's media type.
    fn get_media_type(&self) -> Option<String>;

    /// Allocates a string buffer containing the type and subtype defined
    /// by the `self`.
    ///
    /// # Returns
    ///
    /// an allocated string containing the type and subtype of the
    /// content-type in the format: type/subtype.
    fn get_mime_type(&self) -> Option<String>;

    /// Gets the parameter value specified by `name` if it's available.
    /// ## `name`
    /// parameter name (aka attribute)
    ///
    /// # Returns
    ///
    /// the value of the requested parameter or `None` if the
    /// parameter is not set. If the parameter is set, the returned string
    /// will be in UTF-8.
    fn get_parameter(&self, name: &str) -> Option<String>;

    /// Gets the Content-Type's parameter list.
    ///
    /// # Returns
    ///
    /// the Content-Type's parameter list.
    fn get_parameters(&self) -> Option<ParamList>;

    /// Compares the given type and subtype with that of the given mime
    /// type object.
    /// ## `type_`
    /// MIME type to compare against
    /// ## `subtype`
    /// MIME subtype to compare against
    ///
    /// # Returns
    ///
    /// `true` if the MIME types match or `false` otherwise. You may
    /// use "*" in place of `type_` and/or `subtype` as a wilcard.
    fn is_type(&self, type_: &str, subtype: &str) -> bool;

    /// Sets the Content-Type's media subtype.
    /// ## `subtype`
    /// media subtype
    fn set_media_subtype(&self, subtype: &str);

    /// Sets the Content-Type's media type.
    /// ## `type_`
    /// media type
    fn set_media_type(&self, type_: &str);

    /// Sets a parameter on the Content-Type.
    ///
    /// Note: The `name` should be in US-ASCII while the `value` should be in
    /// UTF-8.
    /// ## `name`
    /// parameter name (aka attribute)
    /// ## `value`
    /// parameter value
    fn set_parameter(&self, name: &str, value: &str);
}

impl<O: IsA<ContentType>> ContentTypeExt for O {
    fn encode<'a, P: Into<Option<&'a FormatOptions>>>(&self, options: P) -> Option<String> {
        let options = options.into();
        unsafe {
            from_glib_full(ffi::g_mime_content_type_encode(self.to_glib_none().0, mut_override(options.to_glib_none().0)))
        }
    }

    fn get_media_subtype(&self) -> Option<String> {
        unsafe {
            from_glib_none(ffi::g_mime_content_type_get_media_subtype(self.to_glib_none().0))
        }
    }

    fn get_media_type(&self) -> Option<String> {
        unsafe {
            from_glib_none(ffi::g_mime_content_type_get_media_type(self.to_glib_none().0))
        }
    }

    fn get_mime_type(&self) -> Option<String> {
        unsafe {
            from_glib_full(ffi::g_mime_content_type_get_mime_type(self.to_glib_none().0))
        }
    }

    fn get_parameter(&self, name: &str) -> Option<String> {
        unsafe {
            from_glib_none(ffi::g_mime_content_type_get_parameter(self.to_glib_none().0, name.to_glib_none().0))
        }
    }

    fn get_parameters(&self) -> Option<ParamList> {
        unsafe {
            from_glib_none(ffi::g_mime_content_type_get_parameters(self.to_glib_none().0))
        }
    }

    fn is_type(&self, type_: &str, subtype: &str) -> bool {
        unsafe {
            from_glib(ffi::g_mime_content_type_is_type(self.to_glib_none().0, type_.to_glib_none().0, subtype.to_glib_none().0))
        }
    }

    fn set_media_subtype(&self, subtype: &str) {
        unsafe {
            ffi::g_mime_content_type_set_media_subtype(self.to_glib_none().0, subtype.to_glib_none().0);
        }
    }

    fn set_media_type(&self, type_: &str) {
        unsafe {
            ffi::g_mime_content_type_set_media_type(self.to_glib_none().0, type_.to_glib_none().0);
        }
    }

    fn set_parameter(&self, name: &str, value: &str) {
        unsafe {
            ffi::g_mime_content_type_set_parameter(self.to_glib_none().0, name.to_glib_none().0, value.to_glib_none().0);
        }
    }
}