// 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 crate::ListModel;
use glib::{prelude::*, translate::*};
use std::fmt;
#[cfg(any(feature = "v2_64", feature = "dox"))]
#[cfg_attr(feature = "dox", doc(cfg(feature = "v2_64")))]
use std::mem;

glib::wrapper! {
    /// [`ListStore`][crate::ListStore] is a simple implementation of [`ListModel`][crate::ListModel] that stores all
    /// items in memory.
    ///
    /// It provides insertions, deletions, and lookups in logarithmic time
    /// with a fast path for the common case of iterating the list linearly.
    ///
    /// ## Properties
    ///
    ///
    /// #### `item-type`
    ///  The type of items contained in this list store. Items must be
    /// subclasses of [`glib::Object`][crate::glib::Object].
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `n-items`
    ///  The number of items contained in this list store.
    ///
    /// Readable
    ///
    /// # Implements
    ///
    /// [`trait@glib::ObjectExt`], [`ListModelExt`][trait@crate::prelude::ListModelExt], [`ListModelExtManual`][trait@crate::prelude::ListModelExtManual]
    #[doc(alias = "GListStore")]
    pub struct ListStore(Object<ffi::GListStore, ffi::GListStoreClass>) @implements ListModel;

    match fn {
        type_ => || ffi::g_list_store_get_type(),
    }
}

impl ListStore {
    /// Creates a new [`ListStore`][crate::ListStore] with items of type `item_type`. `item_type`
    /// must be a subclass of [`glib::Object`][crate::glib::Object].
    /// ## `item_type`
    /// the `GType` of items in the list
    ///
    /// # Returns
    ///
    /// a new [`ListStore`][crate::ListStore]
    #[doc(alias = "g_list_store_new")]
    pub fn new(item_type: glib::types::Type) -> ListStore {
        unsafe { from_glib_full(ffi::g_list_store_new(item_type.into_glib())) }
    }

    // rustdoc-stripper-ignore-next
    /// Creates a new builder-pattern struct instance to construct [`ListStore`] objects.
    ///
    /// This method returns an instance of [`ListStoreBuilder`](crate::builders::ListStoreBuilder) which can be used to create [`ListStore`] objects.
    pub fn builder() -> ListStoreBuilder {
        ListStoreBuilder::new()
    }

    /// Appends `item` to `self`. `item` must be of type [`item-type`][struct@crate::ListStore#item-type].
    ///
    /// This function takes a ref on `item`.
    ///
    /// Use [`splice()`][Self::splice()] to append multiple items at the same time
    /// efficiently.
    /// ## `item`
    /// the new item
    #[doc(alias = "g_list_store_append")]
    pub fn append(&self, item: &impl IsA<glib::Object>) {
        unsafe {
            ffi::g_list_store_append(self.to_glib_none().0, item.as_ref().to_glib_none().0);
        }
    }

    /// Looks up the given `item` in the list store by looping over the items until
    /// the first occurrence of `item`. If `item` was not found, then `position` will
    /// not be set, and this method will return [`false`].
    ///
    /// If you need to compare the two items with a custom comparison function, use
    /// [`find_with_equal_func()`][Self::find_with_equal_func()] with a custom `GEqualFunc` instead.
    /// ## `item`
    /// an item
    ///
    /// # Returns
    ///
    /// Whether `self` contains `item`. If it was found, `position` will be
    /// set to the position where `item` occurred for the first time.
    ///
    /// ## `position`
    /// the first position of `item`, if it was found.
    #[cfg(any(feature = "v2_64", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v2_64")))]
    #[doc(alias = "g_list_store_find")]
    pub fn find(&self, item: &impl IsA<glib::Object>) -> Option<u32> {
        unsafe {
            let mut position = mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::g_list_store_find(
                self.to_glib_none().0,
                item.as_ref().to_glib_none().0,
                position.as_mut_ptr(),
            ));
            if ret {
                Some(position.assume_init())
            } else {
                None
            }
        }
    }

    /// Inserts `item` into `self` at `position`. `item` must be of type
    /// [`item-type`][struct@crate::ListStore#item-type] or derived from it. `position` must be smaller
    /// than the length of the list, or equal to it to append.
    ///
    /// This function takes a ref on `item`.
    ///
    /// Use [`splice()`][Self::splice()] to insert multiple items at the same time
    /// efficiently.
    /// ## `position`
    /// the position at which to insert the new item
    /// ## `item`
    /// the new item
    #[doc(alias = "g_list_store_insert")]
    pub fn insert(&self, position: u32, item: &impl IsA<glib::Object>) {
        unsafe {
            ffi::g_list_store_insert(
                self.to_glib_none().0,
                position,
                item.as_ref().to_glib_none().0,
            );
        }
    }

    /// Removes the item from `self` that is at `position`. `position` must be
    /// smaller than the current length of the list.
    ///
    /// Use [`splice()`][Self::splice()] to remove multiple items at the same time
    /// efficiently.
    /// ## `position`
    /// the position of the item that is to be removed
    #[doc(alias = "g_list_store_remove")]
    pub fn remove(&self, position: u32) {
        unsafe {
            ffi::g_list_store_remove(self.to_glib_none().0, position);
        }
    }

    /// Removes all items from `self`.
    #[doc(alias = "g_list_store_remove_all")]
    pub fn remove_all(&self) {
        unsafe {
            ffi::g_list_store_remove_all(self.to_glib_none().0);
        }
    }
}

impl Default for ListStore {
    fn default() -> Self {
        glib::object::Object::new::<Self>()
    }
}

// rustdoc-stripper-ignore-next
/// A [builder-pattern] type to construct [`ListStore`] objects.
///
/// [builder-pattern]: https://doc.rust-lang.org/1.0.0/style/ownership/builders.html
#[must_use = "The builder must be built to be used"]
pub struct ListStoreBuilder {
    builder: glib::object::ObjectBuilder<'static, ListStore>,
}

impl ListStoreBuilder {
    fn new() -> Self {
        Self {
            builder: glib::object::Object::builder(),
        }
    }

    /// The type of items contained in this list store. Items must be
    /// subclasses of [`glib::Object`][crate::glib::Object].
    pub fn item_type(self, item_type: glib::types::Type) -> Self {
        Self {
            builder: self.builder.property("item-type", item_type),
        }
    }

    // rustdoc-stripper-ignore-next
    /// Build the [`ListStore`].
    #[must_use = "Building the object from the builder is usually expensive and is not expected to have side effects"]
    pub fn build(self) -> ListStore {
        self.builder.build()
    }
}

impl fmt::Display for ListStore {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        f.write_str("ListStore")
    }
}