2020-12-15 10:53:31 +00:00
|
|
|
// Take a look at the license at the top of the repository in the LICENSE file.
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2023-01-03 18:58:25 +00:00
|
|
|
use std::{
|
|
|
|
borrow::{Borrow, BorrowMut, ToOwned},
|
|
|
|
fmt,
|
|
|
|
marker::PhantomData,
|
|
|
|
mem,
|
|
|
|
ops::{Deref, DerefMut},
|
|
|
|
ptr, str,
|
|
|
|
};
|
|
|
|
|
|
|
|
use glib::{
|
2023-01-15 18:38:13 +00:00
|
|
|
prelude::*,
|
2023-01-03 18:58:25 +00:00
|
|
|
translate::*,
|
2023-11-23 11:31:16 +00:00
|
|
|
value::{FromValue, SendValue},
|
2023-01-15 18:38:13 +00:00
|
|
|
IntoGStr,
|
2023-01-03 18:58:25 +00:00
|
|
|
};
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2020-11-21 13:46:48 +00:00
|
|
|
use crate::Fraction;
|
2017-07-24 23:03:18 +00:00
|
|
|
|
2021-04-20 07:19:02 +00:00
|
|
|
#[derive(Clone, Debug, Eq, PartialEq, thiserror::Error)]
|
2022-03-07 11:18:56 +00:00
|
|
|
pub enum GetError<E: std::error::Error> {
|
2020-05-26 15:52:49 +00:00
|
|
|
#[error("GetError: Structure field with name {name} not found")]
|
2021-04-20 07:19:02 +00:00
|
|
|
FieldNotFound { name: &'static str },
|
2020-05-26 15:52:49 +00:00
|
|
|
#[error("GetError: Structure field with name {name} not retrieved")]
|
2019-08-11 07:33:34 +00:00
|
|
|
ValueGetError {
|
2021-04-20 07:19:02 +00:00
|
|
|
name: &'static str,
|
2020-05-26 15:52:49 +00:00
|
|
|
#[source]
|
2022-03-07 11:18:56 +00:00
|
|
|
error: E,
|
2019-08-11 07:33:34 +00:00
|
|
|
},
|
|
|
|
}
|
|
|
|
|
2022-03-07 11:18:56 +00:00
|
|
|
impl<E: std::error::Error> GetError<E> {
|
2021-04-20 07:19:02 +00:00
|
|
|
fn new_field_not_found(name: &'static str) -> Self {
|
2020-03-22 14:18:47 +00:00
|
|
|
skip_assert_initialized!();
|
2019-08-11 07:33:34 +00:00
|
|
|
GetError::FieldNotFound { name }
|
|
|
|
}
|
|
|
|
|
2022-03-07 11:18:56 +00:00
|
|
|
fn from_value_get_error(name: &'static str, error: E) -> Self {
|
2021-04-20 07:19:02 +00:00
|
|
|
skip_assert_initialized!();
|
2022-03-07 11:18:56 +00:00
|
|
|
GetError::ValueGetError { name, error }
|
2019-08-11 07:33:34 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-06-01 13:15:59 +00:00
|
|
|
#[doc(alias = "GstStructure")]
|
2022-01-17 19:23:31 +00:00
|
|
|
#[repr(transparent)]
|
2021-04-02 20:32:57 +00:00
|
|
|
pub struct Structure(ptr::NonNull<ffi::GstStructure>);
|
2017-11-15 20:33:51 +00:00
|
|
|
unsafe impl Send for Structure {}
|
2018-09-22 08:00:17 +00:00
|
|
|
unsafe impl Sync for Structure {}
|
2017-07-07 13:04:54 +00:00
|
|
|
|
|
|
|
impl Structure {
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_new")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn builder(name: impl IntoGStr) -> Builder {
|
2022-12-25 10:47:02 +00:00
|
|
|
skip_assert_initialized!();
|
2017-11-11 12:14:49 +00:00
|
|
|
Builder::new(name)
|
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_new_empty")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn new_empty(name: impl IntoGStr) -> Structure {
|
2017-07-10 09:36:15 +00:00
|
|
|
assert_initialized_main_thread!();
|
2018-04-01 08:29:15 +00:00
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
let ptr = name.run_with_gstr(|name| ffi::gst_structure_new_empty(name.as_ptr()));
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!ptr.is_null());
|
2020-10-24 16:56:48 +00:00
|
|
|
Structure(ptr::NonNull::new_unchecked(ptr))
|
2018-04-01 08:29:15 +00:00
|
|
|
}
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
2020-04-20 09:11:06 +00:00
|
|
|
#[allow(clippy::should_implement_trait)]
|
2023-01-15 21:06:45 +00:00
|
|
|
pub fn from_iter(
|
2023-01-15 18:38:13 +00:00
|
|
|
name: impl IntoGStr,
|
2023-01-15 21:06:45 +00:00
|
|
|
iter: impl IntoIterator<Item = (impl IntoGStr, SendValue)>,
|
2021-09-21 21:54:11 +00:00
|
|
|
) -> Structure {
|
2022-12-25 10:47:02 +00:00
|
|
|
skip_assert_initialized!();
|
2020-04-20 09:11:06 +00:00
|
|
|
let mut structure = Structure::new_empty(name);
|
|
|
|
|
2021-10-18 13:31:46 +00:00
|
|
|
iter.into_iter()
|
|
|
|
.for_each(|(f, v)| structure.set_value(f, v));
|
2020-04-20 09:11:06 +00:00
|
|
|
|
|
|
|
structure
|
|
|
|
}
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
2022-05-06 19:41:15 +00:00
|
|
|
impl IntoGlibPtr<*mut ffi::GstStructure> for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2022-05-06 19:41:15 +00:00
|
|
|
unsafe fn into_glib_ptr(self) -> *mut ffi::GstStructure {
|
|
|
|
let s = mem::ManuallyDrop::new(self);
|
|
|
|
s.0.as_ptr()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-07-07 13:04:54 +00:00
|
|
|
impl Deref for Structure {
|
|
|
|
type Target = StructureRef;
|
|
|
|
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2017-07-07 13:04:54 +00:00
|
|
|
fn deref(&self) -> &StructureRef {
|
2021-04-02 20:32:57 +00:00
|
|
|
unsafe { &*(self.0.as_ptr() as *const StructureRef) }
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl DerefMut for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2017-07-07 13:04:54 +00:00
|
|
|
fn deref_mut(&mut self) -> &mut StructureRef {
|
2021-04-02 20:32:57 +00:00
|
|
|
unsafe { &mut *(self.0.as_ptr() as *mut StructureRef) }
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl AsRef<StructureRef> for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2017-07-07 13:04:54 +00:00
|
|
|
fn as_ref(&self) -> &StructureRef {
|
|
|
|
self.deref()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl AsMut<StructureRef> for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2017-07-07 13:04:54 +00:00
|
|
|
fn as_mut(&mut self) -> &mut StructureRef {
|
|
|
|
self.deref_mut()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl Clone for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2017-07-07 13:04:54 +00:00
|
|
|
fn clone(&self) -> Self {
|
2018-04-01 08:29:15 +00:00
|
|
|
unsafe {
|
2021-04-02 20:32:57 +00:00
|
|
|
let ptr = ffi::gst_structure_copy(self.0.as_ref());
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!ptr.is_null());
|
2020-10-24 16:56:48 +00:00
|
|
|
Structure(ptr::NonNull::new_unchecked(ptr))
|
2018-04-01 08:29:15 +00:00
|
|
|
}
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl Drop for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2017-07-07 13:04:54 +00:00
|
|
|
fn drop(&mut self) {
|
2021-04-02 20:32:57 +00:00
|
|
|
unsafe { ffi::gst_structure_free(self.0.as_mut()) }
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl fmt::Debug for Structure {
|
2017-12-01 09:21:20 +00:00
|
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
2022-08-24 13:19:13 +00:00
|
|
|
f.debug_tuple("Structure").field(self.as_ref()).finish()
|
2017-12-01 09:21:20 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl fmt::Display for Structure {
|
2017-07-07 13:04:54 +00:00
|
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
2018-04-07 10:37:44 +00:00
|
|
|
// Need to make sure to not call ToString::to_string() here, which
|
|
|
|
// we have because of the Display impl. We need StructureRef::to_string()
|
|
|
|
f.write_str(&StructureRef::to_string(self.as_ref()))
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl PartialEq for Structure {
|
|
|
|
fn eq(&self, other: &Structure) -> bool {
|
2022-11-21 09:11:24 +00:00
|
|
|
StructureRef::eq(self, other)
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-11-21 09:11:24 +00:00
|
|
|
impl Eq for Structure {}
|
|
|
|
|
2017-07-07 13:04:54 +00:00
|
|
|
impl PartialEq<StructureRef> for Structure {
|
|
|
|
fn eq(&self, other: &StructureRef) -> bool {
|
2022-11-21 09:11:24 +00:00
|
|
|
StructureRef::eq(self, other)
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-11-21 09:11:24 +00:00
|
|
|
impl PartialEq<Structure> for StructureRef {
|
|
|
|
fn eq(&self, other: &Structure) -> bool {
|
|
|
|
StructureRef::eq(other, self)
|
|
|
|
}
|
|
|
|
}
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2017-07-13 11:57:02 +00:00
|
|
|
impl str::FromStr for Structure {
|
2019-12-17 19:00:42 +00:00
|
|
|
type Err = glib::BoolError;
|
2017-07-13 11:57:02 +00:00
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_from_string")]
|
2020-11-28 11:34:36 +00:00
|
|
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
2019-10-04 06:11:30 +00:00
|
|
|
assert_initialized_main_thread!();
|
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
let structure =
|
|
|
|
s.run_with_gstr(|s| ffi::gst_structure_from_string(s.as_ptr(), ptr::null_mut()));
|
2019-10-04 06:11:30 +00:00
|
|
|
if structure.is_null() {
|
2020-12-17 22:38:06 +00:00
|
|
|
Err(glib::bool_error!("Failed to parse structure from string"))
|
2019-10-04 06:11:30 +00:00
|
|
|
} else {
|
2021-04-02 20:32:57 +00:00
|
|
|
Ok(Self(ptr::NonNull::new_unchecked(structure)))
|
2019-10-04 06:11:30 +00:00
|
|
|
}
|
|
|
|
}
|
2017-07-13 11:57:02 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-07-07 13:04:54 +00:00
|
|
|
impl Borrow<StructureRef> for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2017-07-07 13:04:54 +00:00
|
|
|
fn borrow(&self) -> &StructureRef {
|
2021-04-02 20:32:57 +00:00
|
|
|
self.as_ref()
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl BorrowMut<StructureRef> for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2017-07-07 13:04:54 +00:00
|
|
|
fn borrow_mut(&mut self) -> &mut StructureRef {
|
2021-04-02 20:32:57 +00:00
|
|
|
self.as_mut()
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl ToOwned for StructureRef {
|
|
|
|
type Owned = Structure;
|
|
|
|
|
|
|
|
fn to_owned(&self) -> Structure {
|
2018-04-01 08:29:15 +00:00
|
|
|
unsafe {
|
2021-04-02 20:32:57 +00:00
|
|
|
let ptr = ffi::gst_structure_copy(&self.0);
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!ptr.is_null());
|
2020-10-24 16:56:48 +00:00
|
|
|
Structure(ptr::NonNull::new_unchecked(ptr))
|
2018-04-01 08:29:15 +00:00
|
|
|
}
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-07-10 14:13:49 +00:00
|
|
|
impl glib::types::StaticType for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2017-07-10 14:13:49 +00:00
|
|
|
fn static_type() -> glib::types::Type {
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe { from_glib(ffi::gst_structure_get_type()) }
|
2017-07-10 14:13:49 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-11-21 13:46:48 +00:00
|
|
|
impl<'a> ToGlibPtr<'a, *const ffi::GstStructure> for Structure {
|
2022-12-17 16:48:35 +00:00
|
|
|
type Storage = PhantomData<&'a Self>;
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-11-21 13:46:48 +00:00
|
|
|
fn to_glib_none(&'a self) -> Stash<'a, *const ffi::GstStructure, Self> {
|
2022-12-17 16:48:35 +00:00
|
|
|
unsafe { Stash(self.0.as_ref(), PhantomData) }
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-11-21 13:46:48 +00:00
|
|
|
fn to_glib_full(&self) -> *const ffi::GstStructure {
|
2021-04-02 20:32:57 +00:00
|
|
|
unsafe { ffi::gst_structure_copy(self.0.as_ref()) }
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-11-21 13:46:48 +00:00
|
|
|
impl<'a> ToGlibPtr<'a, *mut ffi::GstStructure> for Structure {
|
2022-12-17 16:48:35 +00:00
|
|
|
type Storage = PhantomData<&'a Self>;
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-11-21 13:46:48 +00:00
|
|
|
fn to_glib_none(&'a self) -> Stash<'a, *mut ffi::GstStructure, Self> {
|
2021-04-02 20:32:57 +00:00
|
|
|
unsafe {
|
|
|
|
Stash(
|
|
|
|
self.0.as_ref() as *const ffi::GstStructure as *mut ffi::GstStructure,
|
2022-12-17 16:48:35 +00:00
|
|
|
PhantomData,
|
2021-04-02 20:32:57 +00:00
|
|
|
)
|
|
|
|
}
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-11-21 13:46:48 +00:00
|
|
|
fn to_glib_full(&self) -> *mut ffi::GstStructure {
|
2021-04-02 20:32:57 +00:00
|
|
|
unsafe { ffi::gst_structure_copy(self.0.as_ref()) }
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-11-21 13:46:48 +00:00
|
|
|
impl<'a> ToGlibPtrMut<'a, *mut ffi::GstStructure> for Structure {
|
2022-12-17 16:48:35 +00:00
|
|
|
type Storage = PhantomData<&'a mut Self>;
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-11-21 13:46:48 +00:00
|
|
|
fn to_glib_none_mut(&'a mut self) -> StashMut<*mut ffi::GstStructure, Self> {
|
2022-12-17 16:48:35 +00:00
|
|
|
unsafe { StashMut(self.0.as_mut(), PhantomData) }
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-11-21 13:46:48 +00:00
|
|
|
impl FromGlibPtrNone<*const ffi::GstStructure> for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe fn from_glib_none(ptr: *const ffi::GstStructure) -> Self {
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!ptr.is_null());
|
2020-11-21 13:46:48 +00:00
|
|
|
let ptr = ffi::gst_structure_copy(ptr);
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!ptr.is_null());
|
2021-04-02 20:32:57 +00:00
|
|
|
Structure(ptr::NonNull::new_unchecked(ptr))
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-11-21 13:46:48 +00:00
|
|
|
impl FromGlibPtrNone<*mut ffi::GstStructure> for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe fn from_glib_none(ptr: *mut ffi::GstStructure) -> Self {
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!ptr.is_null());
|
2020-11-21 13:46:48 +00:00
|
|
|
let ptr = ffi::gst_structure_copy(ptr);
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!ptr.is_null());
|
2021-04-02 20:32:57 +00:00
|
|
|
Structure(ptr::NonNull::new_unchecked(ptr))
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-11-21 13:46:48 +00:00
|
|
|
impl FromGlibPtrFull<*const ffi::GstStructure> for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe fn from_glib_full(ptr: *const ffi::GstStructure) -> Self {
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!ptr.is_null());
|
2021-04-02 20:32:57 +00:00
|
|
|
Structure(ptr::NonNull::new_unchecked(ptr as *mut ffi::GstStructure))
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-11-21 13:46:48 +00:00
|
|
|
impl FromGlibPtrFull<*mut ffi::GstStructure> for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe fn from_glib_full(ptr: *mut ffi::GstStructure) -> Self {
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!ptr.is_null());
|
2021-04-02 20:32:57 +00:00
|
|
|
Structure(ptr::NonNull::new_unchecked(ptr))
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-05-15 22:45:34 +00:00
|
|
|
impl FromGlibPtrBorrow<*const ffi::GstStructure> for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2022-05-15 22:45:34 +00:00
|
|
|
unsafe fn from_glib_borrow(ptr: *const ffi::GstStructure) -> Borrowed<Self> {
|
|
|
|
Borrowed::new(from_glib_full(ptr))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl FromGlibPtrBorrow<*mut ffi::GstStructure> for Structure {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2022-05-15 22:45:34 +00:00
|
|
|
unsafe fn from_glib_borrow(ptr: *mut ffi::GstStructure) -> Borrowed<Self> {
|
|
|
|
Borrowed::new(from_glib_full(ptr))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-04-20 07:19:02 +00:00
|
|
|
impl glib::value::ValueType for Structure {
|
|
|
|
type Type = Self;
|
|
|
|
}
|
|
|
|
|
2021-12-16 17:39:43 +00:00
|
|
|
impl glib::value::ValueTypeOptional for Structure {}
|
|
|
|
|
2021-04-20 07:19:02 +00:00
|
|
|
unsafe impl<'a> glib::value::FromValue<'a> for Structure {
|
|
|
|
type Checker = glib::value::GenericValueTypeOrNoneChecker<Self>;
|
|
|
|
|
|
|
|
unsafe fn from_value(value: &'a glib::Value) -> Self {
|
|
|
|
skip_assert_initialized!();
|
|
|
|
from_glib_none(
|
|
|
|
glib::gobject_ffi::g_value_get_boxed(value.to_glib_none().0) as *mut ffi::GstStructure
|
|
|
|
)
|
2017-08-09 22:13:28 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-04-20 07:19:02 +00:00
|
|
|
impl glib::value::ToValue for Structure {
|
|
|
|
fn to_value(&self) -> glib::Value {
|
2021-04-25 16:46:18 +00:00
|
|
|
let mut value = glib::Value::for_value_type::<Self>();
|
2021-04-20 07:19:02 +00:00
|
|
|
unsafe {
|
|
|
|
glib::gobject_ffi::g_value_set_boxed(
|
|
|
|
value.to_glib_none_mut().0,
|
|
|
|
glib::translate::ToGlibPtr::<*const ffi::GstStructure>::to_glib_none(self).0
|
|
|
|
as *mut _,
|
|
|
|
)
|
|
|
|
}
|
|
|
|
value
|
|
|
|
}
|
|
|
|
|
|
|
|
fn value_type(&self) -> glib::Type {
|
|
|
|
Self::static_type()
|
2017-08-09 22:13:28 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-04-20 07:19:02 +00:00
|
|
|
impl glib::value::ToValueOptional for Structure {
|
|
|
|
fn to_value_optional(s: Option<&Self>) -> glib::Value {
|
|
|
|
skip_assert_initialized!();
|
2021-04-25 16:46:18 +00:00
|
|
|
let mut value = glib::Value::for_value_type::<Self>();
|
2021-04-20 07:19:02 +00:00
|
|
|
unsafe {
|
|
|
|
glib::gobject_ffi::g_value_set_boxed(
|
|
|
|
value.to_glib_none_mut().0,
|
|
|
|
glib::translate::ToGlibPtr::<*const ffi::GstStructure>::to_glib_none(&s).0
|
|
|
|
as *mut _,
|
|
|
|
)
|
|
|
|
}
|
|
|
|
value
|
2017-08-18 13:28:08 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-11-26 11:56:53 +00:00
|
|
|
impl From<Structure> for glib::Value {
|
|
|
|
fn from(v: Structure) -> glib::Value {
|
|
|
|
skip_assert_initialized!();
|
|
|
|
let mut value = glib::Value::for_value_type::<Structure>();
|
|
|
|
unsafe {
|
|
|
|
glib::gobject_ffi::g_value_take_boxed(
|
|
|
|
value.to_glib_none_mut().0,
|
|
|
|
glib::translate::IntoGlibPtr::<*mut ffi::GstStructure>::into_glib_ptr(v) as *mut _,
|
|
|
|
)
|
|
|
|
}
|
|
|
|
value
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-08-09 22:13:28 +00:00
|
|
|
impl GlibPtrDefault for Structure {
|
2020-11-21 13:46:48 +00:00
|
|
|
type GlibType = *mut ffi::GstStructure;
|
2017-08-09 22:13:28 +00:00
|
|
|
}
|
|
|
|
|
2023-01-02 17:03:08 +00:00
|
|
|
unsafe impl TransparentPtrType for Structure {}
|
|
|
|
|
2020-10-24 17:06:59 +00:00
|
|
|
#[repr(transparent)]
|
2021-06-01 13:15:59 +00:00
|
|
|
#[doc(alias = "GstStructure")]
|
2020-11-21 13:46:48 +00:00
|
|
|
pub struct StructureRef(ffi::GstStructure);
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2018-09-22 08:00:17 +00:00
|
|
|
unsafe impl Send for StructureRef {}
|
|
|
|
unsafe impl Sync for StructureRef {}
|
|
|
|
|
2017-07-07 13:04:54 +00:00
|
|
|
impl StructureRef {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-11-21 13:46:48 +00:00
|
|
|
pub unsafe fn from_glib_borrow<'a>(ptr: *const ffi::GstStructure) -> &'a StructureRef {
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!ptr.is_null());
|
2017-07-07 13:04:54 +00:00
|
|
|
|
|
|
|
&*(ptr as *mut StructureRef)
|
|
|
|
}
|
|
|
|
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-11-21 13:46:48 +00:00
|
|
|
pub unsafe fn from_glib_borrow_mut<'a>(ptr: *mut ffi::GstStructure) -> &'a mut StructureRef {
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!ptr.is_null());
|
2017-07-07 13:04:54 +00:00
|
|
|
|
|
|
|
&mut *(ptr as *mut StructureRef)
|
|
|
|
}
|
|
|
|
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2022-08-11 14:02:02 +00:00
|
|
|
pub fn as_ptr(&self) -> *const ffi::GstStructure {
|
2020-11-21 13:46:48 +00:00
|
|
|
self as *const Self as *const ffi::GstStructure
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2022-08-11 14:02:02 +00:00
|
|
|
pub fn as_mut_ptr(&self) -> *mut ffi::GstStructure {
|
2020-11-21 13:46:48 +00:00
|
|
|
self as *const Self as *mut ffi::GstStructure
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_get")]
|
2022-03-07 11:18:56 +00:00
|
|
|
pub fn get<'a, T: FromValue<'a>>(
|
|
|
|
&'a self,
|
2023-01-15 18:38:13 +00:00
|
|
|
name: impl IntoGStr,
|
2022-03-07 11:18:56 +00:00
|
|
|
) -> Result<T, GetError<<<T as FromValue<'a>>::Checker as glib::value::ValueTypeChecker>::Error>>
|
2021-04-20 07:19:02 +00:00
|
|
|
{
|
2022-01-11 10:49:42 +00:00
|
|
|
let name = glib::Quark::from_str(name);
|
2021-04-20 07:19:02 +00:00
|
|
|
self.get_by_quark(name)
|
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_get")]
|
2022-03-07 11:18:56 +00:00
|
|
|
pub fn get_optional<'a, T: FromValue<'a>>(
|
|
|
|
&'a self,
|
2023-01-15 18:38:13 +00:00
|
|
|
name: impl IntoGStr,
|
2022-03-07 11:18:56 +00:00
|
|
|
) -> Result<
|
|
|
|
Option<T>,
|
|
|
|
GetError<<<T as FromValue<'a>>::Checker as glib::value::ValueTypeChecker>::Error>,
|
|
|
|
> {
|
2022-01-11 10:49:42 +00:00
|
|
|
let name = glib::Quark::from_str(name);
|
2021-04-20 07:19:02 +00:00
|
|
|
self.get_optional_by_quark(name)
|
|
|
|
}
|
|
|
|
|
2021-05-02 09:41:18 +00:00
|
|
|
#[doc(alias = "get_value")]
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_get_value")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn value(
|
|
|
|
&self,
|
|
|
|
name: impl IntoGStr,
|
|
|
|
) -> Result<&SendValue, GetError<std::convert::Infallible>> {
|
2022-01-11 10:49:42 +00:00
|
|
|
let name = glib::Quark::from_str(name);
|
2021-04-20 07:19:02 +00:00
|
|
|
self.value_by_quark(name)
|
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_id_get")]
|
2022-03-07 11:18:56 +00:00
|
|
|
pub fn get_by_quark<'a, T: FromValue<'a>>(
|
|
|
|
&'a self,
|
|
|
|
name: glib::Quark,
|
|
|
|
) -> Result<T, GetError<<<T as FromValue<'a>>::Checker as glib::value::ValueTypeChecker>::Error>>
|
2021-04-20 07:19:02 +00:00
|
|
|
{
|
2022-03-07 11:18:56 +00:00
|
|
|
self.value_by_quark(name)
|
|
|
|
.map_err(|err| match err {
|
|
|
|
GetError::FieldNotFound { name } => GetError::FieldNotFound { name },
|
|
|
|
_ => unreachable!(),
|
|
|
|
})?
|
2019-08-11 07:33:34 +00:00
|
|
|
.get()
|
2022-01-11 10:49:42 +00:00
|
|
|
.map_err(|err| GetError::from_value_get_error(name.as_str(), err))
|
2019-08-13 15:02:57 +00:00
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_id_get")]
|
2021-04-20 07:19:02 +00:00
|
|
|
pub fn get_optional_by_quark<'a, T: FromValue<'a>>(
|
|
|
|
&'a self,
|
|
|
|
name: glib::Quark,
|
2022-03-07 11:18:56 +00:00
|
|
|
) -> Result<
|
|
|
|
Option<T>,
|
|
|
|
GetError<<<T as FromValue<'a>>::Checker as glib::value::ValueTypeChecker>::Error>,
|
|
|
|
> {
|
2021-04-20 07:19:02 +00:00
|
|
|
self.value_by_quark(name)
|
|
|
|
.ok()
|
|
|
|
.map(|v| v.get())
|
|
|
|
.transpose()
|
2022-01-11 10:49:42 +00:00
|
|
|
.map_err(|err| GetError::from_value_get_error(name.as_str(), err))
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_id_get_value")]
|
2022-03-07 11:18:56 +00:00
|
|
|
pub fn value_by_quark(
|
|
|
|
&self,
|
|
|
|
name: glib::Quark,
|
|
|
|
) -> Result<&SendValue, GetError<std::convert::Infallible>> {
|
2017-07-07 13:04:54 +00:00
|
|
|
unsafe {
|
2021-04-27 15:15:46 +00:00
|
|
|
let value = ffi::gst_structure_id_get_value(&self.0, name.into_glib());
|
2017-07-07 13:04:54 +00:00
|
|
|
|
|
|
|
if value.is_null() {
|
2022-01-11 10:49:42 +00:00
|
|
|
return Err(GetError::new_field_not_found(name.as_str()));
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
2019-08-11 07:33:34 +00:00
|
|
|
Ok(&*(value as *const SendValue))
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_set")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn set(&mut self, name: impl IntoGStr, value: impl Into<glib::Value> + Send) {
|
2022-11-26 22:54:12 +00:00
|
|
|
let value = glib::SendValue::from_owned(value);
|
2017-07-07 13:04:54 +00:00
|
|
|
self.set_value(name, value);
|
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_set_value")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn set_value(&mut self, name: impl IntoGStr, value: SendValue) {
|
2017-07-07 13:04:54 +00:00
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
name.run_with_gstr(|name| {
|
|
|
|
ffi::gst_structure_take_value(&mut self.0, name.as_ptr(), &mut value.into_raw())
|
|
|
|
});
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_id_set")]
|
2022-11-26 11:56:53 +00:00
|
|
|
pub fn set_by_quark(&mut self, name: glib::Quark, value: impl Into<glib::Value> + Send) {
|
2022-11-26 22:54:12 +00:00
|
|
|
let value = glib::SendValue::from_owned(value);
|
2021-04-20 07:19:02 +00:00
|
|
|
self.set_value_by_quark(name, value);
|
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_id_set_value")]
|
2021-04-20 07:19:02 +00:00
|
|
|
pub fn set_value_by_quark(&mut self, name: glib::Quark, value: SendValue) {
|
|
|
|
unsafe {
|
2021-10-18 13:31:46 +00:00
|
|
|
ffi::gst_structure_id_take_value(&mut self.0, name.into_glib(), &mut value.into_raw());
|
2021-04-20 07:19:02 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-05-02 09:41:18 +00:00
|
|
|
#[doc(alias = "get_name")]
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_get_name")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn name<'a>(&self) -> &'a glib::GStr {
|
|
|
|
unsafe { glib::GStr::from_ptr(ffi::gst_structure_get_name(&self.0)) }
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_get_name_id")]
|
2021-04-20 07:19:02 +00:00
|
|
|
pub fn name_quark(&self) -> glib::Quark {
|
|
|
|
unsafe { from_glib(ffi::gst_structure_get_name_id(&self.0)) }
|
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_set_name")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn set_name(&mut self, name: impl IntoGStr) {
|
|
|
|
unsafe {
|
|
|
|
name.run_with_gstr(|name| ffi::gst_structure_set_name(&mut self.0, name.as_ptr()))
|
|
|
|
}
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
|
2021-12-13 20:00:01 +00:00
|
|
|
#[doc(alias = "gst_structure_has_name")]
|
|
|
|
pub fn has_name(&self, name: &str) -> bool {
|
|
|
|
self.name() == name
|
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_has_field")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn has_field(&self, field: impl IntoGStr) -> bool {
|
2017-07-07 13:04:54 +00:00
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
field.run_with_gstr(|field| {
|
|
|
|
from_glib(ffi::gst_structure_has_field(&self.0, field.as_ptr()))
|
|
|
|
})
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_has_field_typed")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn has_field_with_type(&self, field: impl IntoGStr, type_: glib::Type) -> bool {
|
2017-07-24 23:03:18 +00:00
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
field.run_with_gstr(|field| {
|
|
|
|
from_glib(ffi::gst_structure_has_field_typed(
|
|
|
|
&self.0,
|
|
|
|
field.as_ptr(),
|
|
|
|
type_.into_glib(),
|
|
|
|
))
|
|
|
|
})
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_id_has_field")]
|
2021-04-20 07:19:02 +00:00
|
|
|
pub fn has_field_by_quark(&self, field: glib::Quark) -> bool {
|
2021-04-27 15:15:46 +00:00
|
|
|
unsafe { from_glib(ffi::gst_structure_id_has_field(&self.0, field.into_glib())) }
|
2021-04-20 07:19:02 +00:00
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_id_has_field_typed")]
|
2021-04-20 07:19:02 +00:00
|
|
|
pub fn has_field_with_type_by_quark(&self, field: glib::Quark, type_: glib::Type) -> bool {
|
|
|
|
unsafe {
|
|
|
|
from_glib(ffi::gst_structure_id_has_field_typed(
|
|
|
|
&self.0,
|
2021-04-27 15:15:46 +00:00
|
|
|
field.into_glib(),
|
|
|
|
type_.into_glib(),
|
2021-04-20 07:19:02 +00:00
|
|
|
))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_remove_field")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn remove_field(&mut self, field: impl IntoGStr) {
|
2017-07-07 13:04:54 +00:00
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
field.run_with_gstr(|field| {
|
|
|
|
ffi::gst_structure_remove_field(&mut self.0, field.as_ptr())
|
|
|
|
});
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-12-12 15:52:32 +00:00
|
|
|
#[doc(alias = "gst_structure_remove_fields")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn remove_fields(&mut self, fields: impl IntoIterator<Item = impl IntoGStr>) {
|
|
|
|
for f in fields.into_iter() {
|
2017-07-24 23:03:18 +00:00
|
|
|
self.remove_field(f)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_remove_all_fields")]
|
2017-07-07 13:04:54 +00:00
|
|
|
pub fn remove_all_fields(&mut self) {
|
|
|
|
unsafe {
|
2020-11-21 13:46:48 +00:00
|
|
|
ffi::gst_structure_remove_all_fields(&mut self.0);
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
pub fn fields(&self) -> FieldIterator {
|
|
|
|
FieldIterator::new(self)
|
|
|
|
}
|
|
|
|
|
|
|
|
pub fn iter(&self) -> Iter {
|
|
|
|
Iter::new(self)
|
|
|
|
}
|
|
|
|
|
2021-05-02 09:41:18 +00:00
|
|
|
#[doc(alias = "get_nth_field_name")]
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_nth_field_name")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn nth_field_name<'a>(&self, idx: u32) -> Option<&'a glib::GStr> {
|
2022-05-22 09:20:40 +00:00
|
|
|
if idx >= self.n_fields() {
|
|
|
|
return None;
|
|
|
|
}
|
|
|
|
|
2017-07-07 13:04:54 +00:00
|
|
|
unsafe {
|
2020-11-21 13:46:48 +00:00
|
|
|
let field_name = ffi::gst_structure_nth_field_name(&self.0, idx);
|
2022-12-25 10:47:02 +00:00
|
|
|
debug_assert!(!field_name.is_null());
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2023-01-15 18:38:13 +00:00
|
|
|
Some(glib::GStr::from_ptr(field_name))
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_n_fields")]
|
2017-07-24 23:03:18 +00:00
|
|
|
pub fn n_fields(&self) -> u32 {
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe { ffi::gst_structure_n_fields(&self.0) as u32 }
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_can_intersect")]
|
2017-07-24 23:03:18 +00:00
|
|
|
pub fn can_intersect(&self, other: &StructureRef) -> bool {
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe { from_glib(ffi::gst_structure_can_intersect(&self.0, &other.0)) }
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_intersect")]
|
2017-12-17 09:52:52 +00:00
|
|
|
pub fn intersect(&self, other: &StructureRef) -> Option<Structure> {
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe { from_glib_full(ffi::gst_structure_intersect(&self.0, &other.0)) }
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_is_subset")]
|
2017-07-24 23:03:18 +00:00
|
|
|
pub fn is_subset(&self, superset: &StructureRef) -> bool {
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe { from_glib(ffi::gst_structure_is_subset(&self.0, &superset.0)) }
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_fixate")]
|
2017-07-24 23:03:18 +00:00
|
|
|
pub fn fixate(&mut self) {
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe { ffi::gst_structure_fixate(&mut self.0) }
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_fixate_field")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn fixate_field(&mut self, name: impl IntoGStr) -> bool {
|
2017-07-24 23:03:18 +00:00
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
name.run_with_gstr(|name| {
|
|
|
|
from_glib(ffi::gst_structure_fixate_field(&mut self.0, name.as_ptr()))
|
|
|
|
})
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_fixate_field_boolean")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn fixate_field_bool(&mut self, name: impl IntoGStr, target: bool) -> bool {
|
2017-07-24 23:03:18 +00:00
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
name.run_with_gstr(|name| {
|
|
|
|
from_glib(ffi::gst_structure_fixate_field_boolean(
|
|
|
|
&mut self.0,
|
|
|
|
name.as_ptr(),
|
|
|
|
target.into_glib(),
|
|
|
|
))
|
|
|
|
})
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_fixate_field_string")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn fixate_field_str(&mut self, name: impl IntoGStr, target: impl IntoGStr) -> bool {
|
2017-07-24 23:03:18 +00:00
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
name.run_with_gstr(|name| {
|
|
|
|
target.run_with_gstr(|target| {
|
|
|
|
from_glib(ffi::gst_structure_fixate_field_string(
|
|
|
|
&mut self.0,
|
|
|
|
name.as_ptr(),
|
|
|
|
target.as_ptr(),
|
|
|
|
))
|
|
|
|
})
|
|
|
|
})
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_fixate_field_nearest_double")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn fixate_field_nearest_double(&mut self, name: impl IntoGStr, target: f64) -> bool {
|
2017-07-24 23:03:18 +00:00
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
name.run_with_gstr(|name| {
|
|
|
|
from_glib(ffi::gst_structure_fixate_field_nearest_double(
|
|
|
|
&mut self.0,
|
|
|
|
name.as_ptr(),
|
|
|
|
target,
|
|
|
|
))
|
|
|
|
})
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_fixate_field_nearest_fraction")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn fixate_field_nearest_fraction(
|
2017-07-24 23:03:18 +00:00
|
|
|
&mut self,
|
2023-01-15 18:38:13 +00:00
|
|
|
name: impl IntoGStr,
|
|
|
|
target: impl Into<Fraction>,
|
2017-07-24 23:03:18 +00:00
|
|
|
) -> bool {
|
2017-08-30 11:39:09 +00:00
|
|
|
skip_assert_initialized!();
|
|
|
|
|
2017-07-24 23:03:18 +00:00
|
|
|
let target = target.into();
|
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
name.run_with_gstr(|name| {
|
|
|
|
from_glib(ffi::gst_structure_fixate_field_nearest_fraction(
|
|
|
|
&mut self.0,
|
|
|
|
name.as_ptr(),
|
|
|
|
target.numer(),
|
|
|
|
target.denom(),
|
|
|
|
))
|
|
|
|
})
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_fixate_field_nearest_int")]
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn fixate_field_nearest_int(&mut self, name: impl IntoGStr, target: i32) -> bool {
|
2017-07-24 23:03:18 +00:00
|
|
|
unsafe {
|
2023-01-15 18:38:13 +00:00
|
|
|
name.run_with_gstr(|name| {
|
|
|
|
from_glib(ffi::gst_structure_fixate_field_nearest_int(
|
|
|
|
&mut self.0,
|
|
|
|
name.as_ptr(),
|
|
|
|
target,
|
|
|
|
))
|
|
|
|
})
|
2017-07-24 23:03:18 +00:00
|
|
|
}
|
|
|
|
}
|
2021-07-09 11:55:29 +00:00
|
|
|
|
2023-05-04 05:55:48 +00:00
|
|
|
#[cfg(feature = "v1_20")]
|
|
|
|
#[cfg_attr(docsrs, doc(cfg(feature = "v1_20")))]
|
2021-07-09 11:55:29 +00:00
|
|
|
#[doc(alias = "gst_structure_serialize")]
|
|
|
|
pub fn serialize(&self, flags: crate::SerializeFlags) -> glib::GString {
|
|
|
|
unsafe { from_glib_full(ffi::gst_structure_serialize(&self.0, flags.into_glib())) }
|
|
|
|
}
|
2022-01-08 19:39:31 +00:00
|
|
|
|
2023-12-19 08:44:25 +00:00
|
|
|
#[cfg(feature = "v1_24")]
|
|
|
|
#[cfg_attr(docsrs, doc(cfg(feature = "v1_24")))]
|
|
|
|
#[doc(alias = "gst_structure_serialize")]
|
2024-02-12 14:10:24 +00:00
|
|
|
#[doc(alias = "gst_structure_serialize_full")]
|
2023-12-19 08:44:25 +00:00
|
|
|
pub fn serialize_strict(
|
|
|
|
&self,
|
|
|
|
flags: crate::SerializeFlags,
|
|
|
|
) -> Result<glib::GString, glib::BoolError> {
|
|
|
|
unsafe {
|
2024-02-12 14:10:24 +00:00
|
|
|
let res = ffi::gst_structure_serialize_full(
|
2023-12-19 08:44:25 +00:00
|
|
|
&self.0,
|
|
|
|
flags.into_glib() | ffi::GST_SERIALIZE_FLAG_STRICT,
|
|
|
|
);
|
|
|
|
if res.is_null() {
|
|
|
|
Err(glib::bool_error!("Failed to serialize structure to string"))
|
|
|
|
} else {
|
|
|
|
Ok(from_glib_full(res))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-01-08 19:39:31 +00:00
|
|
|
#[doc(alias = "gst_structure_foreach")]
|
|
|
|
pub fn foreach<F: FnMut(glib::Quark, &glib::Value) -> std::ops::ControlFlow<()>>(
|
|
|
|
&self,
|
|
|
|
mut func: F,
|
|
|
|
) -> bool {
|
|
|
|
unsafe {
|
|
|
|
unsafe extern "C" fn trampoline<
|
|
|
|
F: FnMut(glib::Quark, &glib::Value) -> std::ops::ControlFlow<()>,
|
|
|
|
>(
|
|
|
|
quark: glib::ffi::GQuark,
|
|
|
|
value: *const glib::gobject_ffi::GValue,
|
|
|
|
user_data: glib::ffi::gpointer,
|
|
|
|
) -> glib::ffi::gboolean {
|
|
|
|
let func = &mut *(user_data as *mut F);
|
|
|
|
let res = func(from_glib(quark), &*(value as *const glib::Value));
|
|
|
|
|
|
|
|
matches!(res, std::ops::ControlFlow::Continue(_)).into_glib()
|
|
|
|
}
|
|
|
|
let func = &mut func as *mut F;
|
|
|
|
from_glib(ffi::gst_structure_foreach(
|
|
|
|
self.as_ptr(),
|
|
|
|
Some(trampoline::<F>),
|
|
|
|
func as glib::ffi::gpointer,
|
|
|
|
))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
#[doc(alias = "gst_structure_map_in_place")]
|
|
|
|
pub fn map_in_place<F: FnMut(glib::Quark, &mut glib::Value) -> std::ops::ControlFlow<()>>(
|
|
|
|
&mut self,
|
|
|
|
mut func: F,
|
|
|
|
) -> bool {
|
|
|
|
unsafe {
|
|
|
|
unsafe extern "C" fn trampoline<
|
|
|
|
F: FnMut(glib::Quark, &mut glib::Value) -> std::ops::ControlFlow<()>,
|
|
|
|
>(
|
|
|
|
quark: glib::ffi::GQuark,
|
|
|
|
value: *mut glib::gobject_ffi::GValue,
|
|
|
|
user_data: glib::ffi::gpointer,
|
|
|
|
) -> glib::ffi::gboolean {
|
|
|
|
let func = &mut *(user_data as *mut F);
|
|
|
|
let res = func(from_glib(quark), &mut *(value as *mut glib::Value));
|
|
|
|
|
|
|
|
matches!(res, std::ops::ControlFlow::Continue(_)).into_glib()
|
|
|
|
}
|
|
|
|
let func = &mut func as *mut F;
|
|
|
|
from_glib(ffi::gst_structure_map_in_place(
|
|
|
|
self.as_mut_ptr(),
|
|
|
|
Some(trampoline::<F>),
|
|
|
|
func as glib::ffi::gpointer,
|
|
|
|
))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
#[doc(alias = "gst_structure_filter_and_map_in_place")]
|
|
|
|
pub fn filter_map_in_place<F: FnMut(glib::Quark, glib::Value) -> Option<glib::Value>>(
|
|
|
|
&mut self,
|
|
|
|
mut func: F,
|
|
|
|
) {
|
|
|
|
unsafe {
|
|
|
|
unsafe extern "C" fn trampoline<
|
|
|
|
F: FnMut(glib::Quark, glib::Value) -> Option<glib::Value>,
|
|
|
|
>(
|
|
|
|
quark: glib::ffi::GQuark,
|
|
|
|
value: *mut glib::gobject_ffi::GValue,
|
|
|
|
user_data: glib::ffi::gpointer,
|
|
|
|
) -> glib::ffi::gboolean {
|
|
|
|
let func = &mut *(user_data as *mut F);
|
|
|
|
|
|
|
|
let v = mem::replace(
|
|
|
|
&mut *(value as *mut glib::Value),
|
|
|
|
glib::Value::uninitialized(),
|
|
|
|
);
|
|
|
|
match func(from_glib(quark), v) {
|
|
|
|
None => glib::ffi::GFALSE,
|
|
|
|
Some(v) => {
|
|
|
|
*value = v.into_raw();
|
|
|
|
glib::ffi::GTRUE
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
let func = &mut func as *mut F;
|
|
|
|
ffi::gst_structure_filter_and_map_in_place(
|
|
|
|
self.as_mut_ptr(),
|
|
|
|
Some(trampoline::<F>),
|
|
|
|
func as glib::ffi::gpointer,
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
2018-04-06 10:21:45 +00:00
|
|
|
impl fmt::Display for StructureRef {
|
|
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
2020-11-21 13:46:48 +00:00
|
|
|
let s = unsafe { glib::GString::from_glib_full(ffi::gst_structure_to_string(&self.0)) };
|
2019-10-04 06:11:30 +00:00
|
|
|
f.write_str(&s)
|
2018-04-06 10:21:45 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-07-07 13:04:54 +00:00
|
|
|
impl fmt::Debug for StructureRef {
|
|
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
2022-08-24 13:19:13 +00:00
|
|
|
let mut debug = f.debug_struct(self.name());
|
|
|
|
|
|
|
|
for (id, field) in self.iter() {
|
|
|
|
if field.type_() == Structure::static_type() {
|
|
|
|
let s = field.get::<Structure>().unwrap();
|
|
|
|
debug.field(id, &s);
|
|
|
|
} else if field.type_() == crate::Array::static_type() {
|
|
|
|
let arr = field.get::<crate::Array>().unwrap();
|
|
|
|
debug.field(id, &arr);
|
|
|
|
} else if field.type_() == crate::List::static_type() {
|
|
|
|
let list = field.get::<crate::List>().unwrap();
|
|
|
|
debug.field(id, &list);
|
|
|
|
} else {
|
|
|
|
debug.field(id, &field);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
debug.finish()
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl PartialEq for StructureRef {
|
2021-05-19 20:35:47 +00:00
|
|
|
#[doc(alias = "gst_structure_is_equal")]
|
2017-07-07 13:04:54 +00:00
|
|
|
fn eq(&self, other: &StructureRef) -> bool {
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe { from_glib(ffi::gst_structure_is_equal(&self.0, &other.0)) }
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl Eq for StructureRef {}
|
|
|
|
|
2020-05-27 10:07:32 +00:00
|
|
|
impl glib::types::StaticType for StructureRef {
|
2022-12-18 08:18:31 +00:00
|
|
|
#[inline]
|
2020-05-27 10:07:32 +00:00
|
|
|
fn static_type() -> glib::types::Type {
|
2020-11-21 13:46:48 +00:00
|
|
|
unsafe { from_glib(ffi::gst_structure_get_type()) }
|
2020-05-27 10:07:32 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-04-20 07:19:02 +00:00
|
|
|
unsafe impl<'a> glib::value::FromValue<'a> for &'a StructureRef {
|
|
|
|
type Checker = glib::value::GenericValueTypeOrNoneChecker<Self>;
|
|
|
|
|
|
|
|
unsafe fn from_value(value: &'a glib::Value) -> Self {
|
|
|
|
skip_assert_initialized!();
|
|
|
|
&*(glib::gobject_ffi::g_value_get_boxed(value.to_glib_none().0) as *const StructureRef)
|
2020-05-27 10:07:32 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-04-20 07:19:02 +00:00
|
|
|
impl glib::value::ToValue for StructureRef {
|
|
|
|
fn to_value(&self) -> glib::Value {
|
|
|
|
let mut value = glib::Value::for_value_type::<Structure>();
|
|
|
|
unsafe {
|
|
|
|
glib::gobject_ffi::g_value_set_boxed(
|
|
|
|
value.to_glib_none_mut().0,
|
|
|
|
self.as_ptr() as *mut _,
|
|
|
|
)
|
|
|
|
}
|
|
|
|
value
|
|
|
|
}
|
|
|
|
|
|
|
|
fn value_type(&self) -> glib::Type {
|
|
|
|
Self::static_type()
|
2020-05-27 10:07:32 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-04-20 07:19:02 +00:00
|
|
|
impl glib::value::ToValueOptional for StructureRef {
|
|
|
|
fn to_value_optional(s: Option<&Self>) -> glib::Value {
|
|
|
|
skip_assert_initialized!();
|
|
|
|
let mut value = glib::Value::for_value_type::<Structure>();
|
|
|
|
unsafe {
|
|
|
|
glib::gobject_ffi::g_value_set_boxed(
|
|
|
|
value.to_glib_none_mut().0,
|
|
|
|
s.map(|s| s.as_ptr()).unwrap_or(ptr::null()) as *mut _,
|
|
|
|
)
|
2020-05-27 10:07:32 +00:00
|
|
|
}
|
2021-04-20 07:19:02 +00:00
|
|
|
value
|
2020-05-27 10:07:32 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-01-22 15:43:29 +00:00
|
|
|
#[derive(Debug)]
|
2017-07-07 13:04:54 +00:00
|
|
|
pub struct FieldIterator<'a> {
|
|
|
|
structure: &'a StructureRef,
|
2022-05-20 13:58:46 +00:00
|
|
|
idx: usize,
|
|
|
|
n_fields: usize,
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
impl<'a> FieldIterator<'a> {
|
2017-08-30 11:39:09 +00:00
|
|
|
fn new(structure: &'a StructureRef) -> FieldIterator<'a> {
|
|
|
|
skip_assert_initialized!();
|
2017-07-07 13:04:54 +00:00
|
|
|
let n_fields = structure.n_fields();
|
|
|
|
|
|
|
|
FieldIterator {
|
2018-07-20 07:21:06 +00:00
|
|
|
structure,
|
2017-07-07 13:04:54 +00:00
|
|
|
idx: 0,
|
2022-05-20 13:58:46 +00:00
|
|
|
n_fields: n_fields as usize,
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl<'a> Iterator for FieldIterator<'a> {
|
2023-01-15 18:38:13 +00:00
|
|
|
type Item = &'static glib::GStr;
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2020-03-12 18:17:15 +00:00
|
|
|
fn next(&mut self) -> Option<Self::Item> {
|
2017-07-07 13:04:54 +00:00
|
|
|
if self.idx >= self.n_fields {
|
|
|
|
return None;
|
|
|
|
}
|
|
|
|
|
2022-05-20 13:58:46 +00:00
|
|
|
let field_name = self.structure.nth_field_name(self.idx as u32).unwrap();
|
|
|
|
self.idx += 1;
|
|
|
|
|
|
|
|
Some(field_name)
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
fn size_hint(&self) -> (usize, Option<usize>) {
|
2022-05-20 13:58:46 +00:00
|
|
|
let remaining = self.n_fields - self.idx;
|
2017-07-07 13:04:54 +00:00
|
|
|
|
|
|
|
(remaining, Some(remaining))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl<'a> DoubleEndedIterator for FieldIterator<'a> {
|
|
|
|
fn next_back(&mut self) -> Option<Self::Item> {
|
|
|
|
if self.idx == self.n_fields {
|
|
|
|
return None;
|
|
|
|
}
|
|
|
|
|
|
|
|
self.n_fields -= 1;
|
2022-05-20 13:58:46 +00:00
|
|
|
Some(self.structure.nth_field_name(self.n_fields as u32).unwrap())
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl<'a> ExactSizeIterator for FieldIterator<'a> {}
|
|
|
|
|
2022-05-20 13:58:46 +00:00
|
|
|
impl<'a> std::iter::FusedIterator for FieldIterator<'a> {}
|
|
|
|
|
2019-01-22 15:43:29 +00:00
|
|
|
#[derive(Debug)]
|
2017-07-07 13:04:54 +00:00
|
|
|
pub struct Iter<'a> {
|
|
|
|
iter: FieldIterator<'a>,
|
|
|
|
}
|
|
|
|
|
|
|
|
impl<'a> Iter<'a> {
|
2017-08-30 11:39:09 +00:00
|
|
|
fn new(structure: &'a StructureRef) -> Iter<'a> {
|
|
|
|
skip_assert_initialized!();
|
2017-07-24 08:52:28 +00:00
|
|
|
Iter {
|
|
|
|
iter: FieldIterator::new(structure),
|
|
|
|
}
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl<'a> Iterator for Iter<'a> {
|
2023-01-15 18:38:13 +00:00
|
|
|
type Item = (&'static glib::GStr, &'a SendValue);
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2020-03-12 18:17:15 +00:00
|
|
|
fn next(&mut self) -> Option<Self::Item> {
|
2022-05-20 13:58:46 +00:00
|
|
|
let f = self.iter.next()?;
|
|
|
|
let v = self.iter.structure.value(f);
|
|
|
|
Some((f, v.unwrap()))
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
fn size_hint(&self) -> (usize, Option<usize>) {
|
|
|
|
self.iter.size_hint()
|
|
|
|
}
|
2022-05-20 13:58:46 +00:00
|
|
|
|
|
|
|
fn count(self) -> usize {
|
|
|
|
self.iter.count()
|
|
|
|
}
|
|
|
|
|
|
|
|
fn nth(&mut self, n: usize) -> Option<Self::Item> {
|
|
|
|
let f = self.iter.nth(n)?;
|
|
|
|
let v = self.iter.structure.value(f);
|
|
|
|
Some((f, v.unwrap()))
|
|
|
|
}
|
|
|
|
|
|
|
|
fn last(self) -> Option<Self::Item> {
|
|
|
|
let structure = self.iter.structure;
|
|
|
|
let f = self.iter.last()?;
|
|
|
|
let v = structure.value(f);
|
|
|
|
Some((f, v.unwrap()))
|
|
|
|
}
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
impl<'a> DoubleEndedIterator for Iter<'a> {
|
|
|
|
fn next_back(&mut self) -> Option<Self::Item> {
|
2022-05-20 13:58:46 +00:00
|
|
|
let f = self.iter.next_back()?;
|
|
|
|
let v = self.iter.structure.value(f);
|
|
|
|
Some((f, v.unwrap()))
|
|
|
|
}
|
|
|
|
|
|
|
|
fn nth_back(&mut self, n: usize) -> Option<Self::Item> {
|
|
|
|
let f = self.iter.nth_back(n)?;
|
|
|
|
let v = self.iter.structure.value(f);
|
|
|
|
Some((f, v.unwrap()))
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl<'a> ExactSizeIterator for Iter<'a> {}
|
|
|
|
|
2022-05-20 13:58:46 +00:00
|
|
|
impl<'a> std::iter::FusedIterator for Iter<'a> {}
|
|
|
|
|
2021-10-16 20:13:31 +00:00
|
|
|
impl<'a> IntoIterator for &'a StructureRef {
|
|
|
|
type IntoIter = Iter<'a>;
|
2023-01-15 18:38:13 +00:00
|
|
|
type Item = (&'static glib::GStr, &'a SendValue);
|
2021-10-16 20:13:31 +00:00
|
|
|
|
|
|
|
fn into_iter(self) -> Self::IntoIter {
|
|
|
|
self.iter()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-10-20 10:53:23 +00:00
|
|
|
impl<'a> std::iter::Extend<(&'a str, SendValue)> for StructureRef {
|
|
|
|
fn extend<T: IntoIterator<Item = (&'a str, SendValue)>>(&mut self, iter: T) {
|
|
|
|
iter.into_iter().for_each(|(f, v)| self.set_value(f, v));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2023-01-15 18:38:13 +00:00
|
|
|
impl<'a> std::iter::Extend<(&'a glib::GStr, SendValue)> for StructureRef {
|
|
|
|
fn extend<T: IntoIterator<Item = (&'a glib::GStr, SendValue)>>(&mut self, iter: T) {
|
|
|
|
iter.into_iter().for_each(|(f, v)| self.set_value(f, v));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-10-20 11:28:14 +00:00
|
|
|
impl std::iter::Extend<(String, SendValue)> for StructureRef {
|
|
|
|
fn extend<T: IntoIterator<Item = (String, SendValue)>>(&mut self, iter: T) {
|
|
|
|
iter.into_iter().for_each(|(f, v)| self.set_value(&f, v));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2023-01-15 18:38:13 +00:00
|
|
|
impl std::iter::Extend<(glib::GString, SendValue)> for StructureRef {
|
|
|
|
fn extend<T: IntoIterator<Item = (glib::GString, SendValue)>>(&mut self, iter: T) {
|
|
|
|
iter.into_iter().for_each(|(f, v)| self.set_value(&f, v));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-10-20 11:28:14 +00:00
|
|
|
impl std::iter::Extend<(glib::Quark, SendValue)> for StructureRef {
|
|
|
|
fn extend<T: IntoIterator<Item = (glib::Quark, SendValue)>>(&mut self, iter: T) {
|
|
|
|
iter.into_iter()
|
|
|
|
.for_each(|(f, v)| self.set_value_by_quark(f, v));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-01-22 15:43:29 +00:00
|
|
|
#[derive(Debug)]
|
2021-12-03 23:17:29 +00:00
|
|
|
#[must_use = "The builder must be built to be used"]
|
2017-11-11 12:14:49 +00:00
|
|
|
pub struct Builder {
|
|
|
|
s: Structure,
|
|
|
|
}
|
|
|
|
|
|
|
|
impl Builder {
|
2023-01-15 18:38:13 +00:00
|
|
|
fn new(name: impl IntoGStr) -> Self {
|
2020-03-22 14:18:47 +00:00
|
|
|
skip_assert_initialized!();
|
2017-11-11 12:14:49 +00:00
|
|
|
Builder {
|
|
|
|
s: Structure::new_empty(name),
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2023-01-15 18:38:13 +00:00
|
|
|
pub fn field(mut self, name: impl IntoGStr, value: impl Into<glib::Value> + Send) -> Self {
|
2017-11-11 12:14:49 +00:00
|
|
|
self.s.set(name, value);
|
|
|
|
self
|
|
|
|
}
|
|
|
|
|
2021-12-03 23:17:29 +00:00
|
|
|
#[must_use = "Building the structure without using it has no effect"]
|
2017-11-11 12:14:49 +00:00
|
|
|
pub fn build(self) -> Structure {
|
|
|
|
self.s
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-07-07 13:04:54 +00:00
|
|
|
#[cfg(test)]
|
|
|
|
mod tests {
|
|
|
|
use super::*;
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn new_set_get() {
|
2019-08-16 13:04:01 +00:00
|
|
|
use glib::{value, Type};
|
|
|
|
|
2020-11-21 13:46:48 +00:00
|
|
|
crate::init().unwrap();
|
2017-07-07 13:04:54 +00:00
|
|
|
|
|
|
|
let mut s = Structure::new_empty("test");
|
2021-04-11 19:39:50 +00:00
|
|
|
assert_eq!(s.name(), "test");
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2021-10-24 16:11:30 +00:00
|
|
|
s.set("f1", "abc");
|
2017-11-26 21:58:02 +00:00
|
|
|
s.set("f2", &String::from("bcd"));
|
2021-10-24 16:11:30 +00:00
|
|
|
s.set("f3", 123i32);
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2021-04-20 07:19:02 +00:00
|
|
|
assert_eq!(s.get::<&str>("f1"), Ok("abc"));
|
|
|
|
assert_eq!(s.get::<Option<&str>>("f2"), Ok(Some("bcd")));
|
|
|
|
assert_eq!(s.get::<i32>("f3"), Ok(123i32));
|
2019-08-13 15:02:57 +00:00
|
|
|
assert_eq!(s.get_optional::<&str>("f1"), Ok(Some("abc")));
|
|
|
|
assert_eq!(s.get_optional::<&str>("f4"), Ok(None));
|
|
|
|
assert_eq!(s.get_optional::<i32>("f3"), Ok(Some(123i32)));
|
|
|
|
assert_eq!(s.get_optional::<i32>("f4"), Ok(None));
|
2019-08-11 07:33:34 +00:00
|
|
|
|
2019-08-16 13:04:01 +00:00
|
|
|
assert_eq!(
|
|
|
|
s.get::<i32>("f2"),
|
|
|
|
Err(GetError::from_value_get_error(
|
|
|
|
"f2",
|
2021-04-20 07:19:02 +00:00
|
|
|
value::ValueTypeMismatchError::new(Type::STRING, Type::I32),
|
2019-08-16 13:04:01 +00:00
|
|
|
))
|
|
|
|
);
|
|
|
|
assert_eq!(
|
2021-04-20 07:19:02 +00:00
|
|
|
s.get::<bool>("f3"),
|
2019-08-16 13:04:01 +00:00
|
|
|
Err(GetError::from_value_get_error(
|
|
|
|
"f3",
|
2021-04-20 07:19:02 +00:00
|
|
|
value::ValueTypeMismatchError::new(Type::I32, Type::BOOL),
|
2019-08-16 13:04:01 +00:00
|
|
|
))
|
|
|
|
);
|
|
|
|
assert_eq!(
|
|
|
|
s.get::<&str>("f4"),
|
|
|
|
Err(GetError::new_field_not_found("f4"))
|
|
|
|
);
|
2021-04-20 07:19:02 +00:00
|
|
|
assert_eq!(s.get::<i32>("f4"), Err(GetError::new_field_not_found("f4")));
|
2017-07-07 13:04:54 +00:00
|
|
|
|
|
|
|
assert_eq!(s.fields().collect::<Vec<_>>(), vec!["f1", "f2", "f3"]);
|
2017-07-12 07:38:34 +00:00
|
|
|
|
|
|
|
let v = s.iter().map(|(f, v)| (f, v.clone())).collect::<Vec<_>>();
|
|
|
|
assert_eq!(v.len(), 3);
|
|
|
|
assert_eq!(v[0].0, "f1");
|
2021-04-20 07:19:02 +00:00
|
|
|
assert_eq!(v[0].1.get::<&str>(), Ok("abc"));
|
2017-07-12 07:38:34 +00:00
|
|
|
assert_eq!(v[1].0, "f2");
|
2021-04-20 07:19:02 +00:00
|
|
|
assert_eq!(v[1].1.get::<&str>(), Ok("bcd"));
|
2017-07-12 07:38:34 +00:00
|
|
|
assert_eq!(v[2].0, "f3");
|
2021-04-20 07:19:02 +00:00
|
|
|
assert_eq!(v[2].1.get::<i32>(), Ok(123i32));
|
2017-07-07 13:04:54 +00:00
|
|
|
|
2023-11-23 11:31:16 +00:00
|
|
|
let s2 = Structure::builder("test")
|
2021-10-24 16:11:30 +00:00
|
|
|
.field("f1", "abc")
|
2022-12-13 09:28:00 +00:00
|
|
|
.field("f2", String::from("bcd"))
|
2021-10-24 16:11:30 +00:00
|
|
|
.field("f3", 123i32)
|
2017-11-11 12:14:49 +00:00
|
|
|
.build();
|
2023-11-23 11:31:16 +00:00
|
|
|
assert_eq!(s, s2);
|
2017-11-11 12:14:49 +00:00
|
|
|
}
|
2018-04-06 10:01:17 +00:00
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn test_string_conversion() {
|
2020-11-21 13:46:48 +00:00
|
|
|
crate::init().unwrap();
|
2019-01-27 01:02:11 +00:00
|
|
|
|
2018-04-06 10:16:47 +00:00
|
|
|
let a = "Test, f1=(string)abc, f2=(uint)123;";
|
2018-04-06 10:01:17 +00:00
|
|
|
|
2021-10-31 16:00:02 +00:00
|
|
|
let s = a.parse::<Structure>().unwrap();
|
2021-04-20 07:19:02 +00:00
|
|
|
assert_eq!(s.get::<&str>("f1"), Ok("abc"));
|
|
|
|
assert_eq!(s.get::<u32>("f2"), Ok(123));
|
2018-04-06 10:01:17 +00:00
|
|
|
|
|
|
|
assert_eq!(a, s.to_string());
|
|
|
|
}
|
2019-09-24 09:34:08 +00:00
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn test_from_value_optional() {
|
2024-02-03 08:13:51 +00:00
|
|
|
use glib::value::ToValue;
|
2021-04-20 07:19:02 +00:00
|
|
|
|
2020-11-21 13:46:48 +00:00
|
|
|
crate::init().unwrap();
|
2019-09-24 09:34:08 +00:00
|
|
|
|
2021-04-20 07:19:02 +00:00
|
|
|
let a = None::<&Structure>.to_value();
|
|
|
|
assert!(a.get::<Option<Structure>>().unwrap().is_none());
|
2021-10-31 16:00:02 +00:00
|
|
|
let b = "foo".parse::<Structure>().unwrap().to_value();
|
2021-04-20 07:19:02 +00:00
|
|
|
assert!(b.get::<Option<Structure>>().unwrap().is_some());
|
2019-09-24 09:34:08 +00:00
|
|
|
}
|
2020-04-20 09:11:06 +00:00
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn test_new_from_iter() {
|
2020-11-21 13:46:48 +00:00
|
|
|
crate::init().unwrap();
|
2020-04-20 09:11:06 +00:00
|
|
|
|
|
|
|
let s = Structure::builder("test")
|
2021-10-24 16:11:30 +00:00
|
|
|
.field("f1", "abc")
|
2022-12-13 09:28:00 +00:00
|
|
|
.field("f2", String::from("bcd"))
|
2021-10-24 16:11:30 +00:00
|
|
|
.field("f3", 123i32)
|
2020-04-20 09:11:06 +00:00
|
|
|
.build();
|
|
|
|
|
2021-10-18 13:31:46 +00:00
|
|
|
let s2 = Structure::from_iter(
|
|
|
|
s.name(),
|
|
|
|
s.iter()
|
|
|
|
.filter(|(f, _)| *f == "f1")
|
|
|
|
.map(|(f, v)| (f, v.clone())),
|
|
|
|
);
|
2020-04-20 09:11:06 +00:00
|
|
|
|
2021-04-11 19:39:50 +00:00
|
|
|
assert_eq!(s2.name(), "test");
|
2021-04-20 07:19:02 +00:00
|
|
|
assert_eq!(s2.get::<&str>("f1"), Ok("abc"));
|
2020-04-20 09:11:06 +00:00
|
|
|
assert!(s2.get::<&str>("f2").is_err());
|
|
|
|
assert!(s2.get::<&str>("f3").is_err());
|
|
|
|
}
|
2022-08-24 13:19:13 +00:00
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn test_debug() {
|
|
|
|
crate::init().unwrap();
|
|
|
|
|
|
|
|
let s = Structure::builder("test")
|
|
|
|
.field("f1", "abc")
|
2022-11-01 09:10:57 +00:00
|
|
|
.field("f2", String::from("bcd"))
|
2022-08-24 13:19:13 +00:00
|
|
|
.field("f3", 123i32)
|
|
|
|
.field(
|
|
|
|
"f4",
|
2022-11-01 09:10:57 +00:00
|
|
|
Structure::builder("nested").field("badger", true).build(),
|
2022-08-24 13:19:13 +00:00
|
|
|
)
|
2022-11-01 09:10:57 +00:00
|
|
|
.field("f5", crate::Array::new(["a", "b", "c"]))
|
|
|
|
.field("f6", crate::List::new(["d", "e", "f"]))
|
2022-08-24 13:19:13 +00:00
|
|
|
.build();
|
|
|
|
|
2023-01-25 08:09:45 +00:00
|
|
|
assert_eq!(format!("{s:?}"), "Structure(test { f1: (gchararray) \"abc\", f2: (gchararray) \"bcd\", f3: (gint) 123, f4: Structure(nested { badger: (gboolean) TRUE }), f5: Array([(gchararray) \"a\", (gchararray) \"b\", (gchararray) \"c\"]), f6: List([(gchararray) \"d\", (gchararray) \"e\", (gchararray) \"f\"]) })");
|
2022-08-24 13:19:13 +00:00
|
|
|
}
|
2017-07-07 13:04:54 +00:00
|
|
|
}
|