Struct Variant

pub struct Variant { /* private fields */ }

A generic immutable value capable of carrying various types.

See the module documentation for more details.

GLib type: Shared boxed type with reference counted clone semantics.

Implementations

impl Variant

pub fn as_ptr(&self) -> *mut GVariant

Return the inner pointer to the underlying C value.

pub unsafe fn from_glib_ptr_borrow(ptr: &*mut GVariant) -> &Variant

Borrows the underlying C value.

impl Variant

pub fn type_(&self) -> &VariantTy

Returns the type of the value.

pub fn is<T>(&self) -> bool

where T: StaticVariantType,

Returns true if the type of the value corresponds to T.

pub fn is_type(&self, type_: &VariantTy) -> bool

Returns true if the type of the value corresponds to type_.

This is equivalent to self.type_().is_subtype_of(type_).

pub fn classify(&self) -> VariantClass

Returns the classification of the variant.

pub fn get<T>(&self) -> Option<T>

where T: FromVariant,

Tries to extract a value of type T.

Returns Some if T matches the variant’s type.

pub fn try_get<T>(&self) -> Result<T, VariantTypeMismatchError>

where T: FromVariant,

Tries to extract a value of type T.

pub fn from_variant(value: &Variant) -> Variant

Boxes value.

pub fn as_variant(&self) -> Option<Variant>

Unboxes self.

Returns Some if self contains a Variant.

pub fn child_value(&self, index: usize) -> Variant

Reads a child item out of a container Variant instance.

Panics

• if self is not a container type.
• if given index is larger than number of children.

pub fn try_child_value(&self, index: usize) -> Option<Variant>

Try to read a child item out of a container Variant instance.

It returns None if self is not a container type or if the given index is larger than number of children.

pub fn try_child_get<T>( &self, index: usize, ) -> Result<Option<T>, VariantTypeMismatchError>

where T: StaticVariantType + FromVariant,

Try to read a child item out of a container Variant instance.

It returns Ok(None) if self is not a container type or if the given index is larger than number of children. An error is thrown if the type does not match.

pub fn child_get<T>(&self, index: usize) -> T

where T: StaticVariantType + FromVariant,

Read a child item out of a container Variant instance.

Panics

• if self is not a container type.
• if given index is larger than number of children.
• if the expected variant type does not match

pub fn str(&self) -> Option<&str>

Tries to extract a &str.

Returns Some if the variant has a string type (s, o or g type strings).

pub fn fixed_array<T>(&self) -> Result<&[T], VariantTypeMismatchError>

where T: FixedSizeVariantType,

Tries to extract a &[T] from a variant of array type with a suitable element type.

Returns an error if the type is wrong.

pub fn array_from_iter<T>( children: impl IntoIterator<Item = Variant>, ) -> Variant

where T: StaticVariantType,

Creates a new Variant array from children.

Panics

This function panics if not all variants are of type T.

pub fn array_from_iter_with_type( type_: &VariantTy, children: impl IntoIterator<Item = impl AsRef<Variant>>, ) -> Variant

Creates a new Variant array from children with the specified type.

Panics

This function panics if not all variants are of type type_.

pub fn array_from_fixed_array<T>(array: &[T]) -> Variant

where T: FixedSizeVariantType,

Creates a new Variant array from a fixed array.

pub fn tuple_from_iter( children: impl IntoIterator<Item = impl AsRef<Variant>>, ) -> Variant

Creates a new Variant tuple from children.

pub fn from_dict_entry(key: &Variant, value: &Variant) -> Variant

Creates a new dictionary entry Variant.

DictEntry should be preferred over this when the types are known statically.

pub fn from_maybe<T>(child: Option<&Variant>) -> Variant

where T: StaticVariantType,

Creates a new maybe Variant.

pub fn from_some(child: &Variant) -> Variant

Creates a new maybe Variant from a child.

pub fn from_none(type_: &VariantTy) -> Variant

Creates a new maybe Variant with Nothing.

pub fn as_maybe(&self) -> Option<Variant>

Extract the value of a maybe Variant.

Returns the child value, or None if the value is Nothing.

Panics

Panics if the variant is not maybe-typed.

pub fn print(&self, type_annotate: bool) -> GString

Pretty-print the contents of this variant in a human-readable form.

A variant can be recreated from this output via Variant::parse.

pub fn parse(type_: Option<&VariantTy>, text: &str) -> Result<Variant, Error>

Parses a GVariant from the text representation produced by print().

pub fn from_bytes<T>(bytes: &Bytes) -> Variant

where T: StaticVariantType,

Constructs a new serialized-mode GVariant instance.

pub unsafe fn from_bytes_trusted<T>(bytes: &Bytes) -> Variant

where T: StaticVariantType,

Constructs a new serialized-mode GVariant instance.

This is the same as from_bytes, except that checks on the passed data are skipped.

You should not use this function on data from external sources.

Safety

Since the data is not validated, this is potentially dangerous if called on bytes which are not guaranteed to have come from serialising another Variant. The caller is responsible for ensuring bad data is not passed in.

pub fn from_data<T, A>(data: A) -> Variant

where T: StaticVariantType, A: AsRef<[u8]>,

Constructs a new serialized-mode GVariant instance.

pub unsafe fn from_data_trusted<T, A>(data: A) -> Variant

where T: StaticVariantType, A: AsRef<[u8]>,

Constructs a new serialized-mode GVariant instance.

This is the same as from_data, except that checks on the passed data are skipped.

You should not use this function on data from external sources.

Safety

Since the data is not validated, this is potentially dangerous if called on bytes which are not guaranteed to have come from serialising another Variant. The caller is responsible for ensuring bad data is not passed in.

pub fn from_bytes_with_type(bytes: &Bytes, type_: &VariantTy) -> Variant

Constructs a new serialized-mode GVariant instance with a given type.

pub unsafe fn from_bytes_with_type_trusted( bytes: &Bytes, type_: &VariantTy, ) -> Variant

Constructs a new serialized-mode GVariant instance with a given type.

This is the same as from_bytes, except that checks on the passed data are skipped.

You should not use this function on data from external sources.

Safety

Since the data is not validated, this is potentially dangerous if called on bytes which are not guaranteed to have come from serialising another Variant. The caller is responsible for ensuring bad data is not passed in.

pub fn from_data_with_type<A>(data: A, type_: &VariantTy) -> Variant

where A: AsRef<[u8]>,

Constructs a new serialized-mode GVariant instance with a given type.

pub unsafe fn from_data_with_type_trusted<A>( data: A, type_: &VariantTy, ) -> Variant

where A: AsRef<[u8]>,

Constructs a new serialized-mode GVariant instance with a given type.

This is the same as from_data, except that checks on the passed data are skipped.

You should not use this function on data from external sources.

Safety

Since the data is not validated, this is potentially dangerous if called on bytes which are not guaranteed to have come from serialising another Variant. The caller is responsible for ensuring bad data is not passed in.

pub fn data_as_bytes(&self) -> Bytes

Returns the serialized form of a GVariant instance.

pub fn data(&self) -> &[u8]

Returns the serialized form of a GVariant instance.

pub fn size(&self) -> usize

Returns the size of serialized form of a GVariant instance.

pub fn store(&self, data: &mut [u8]) -> Result<usize, BoolError>

Stores the serialized form of a GVariant instance into the given slice.

The slice needs to be big enough.

pub fn normal_form(&self) -> Variant

Returns a copy of the variant in normal form.

pub fn byteswap(&self) -> Variant

Returns a copy of the variant in the opposite endianness.

pub fn n_children(&self) -> usize

Determines the number of children in a container GVariant instance.

pub fn iter(&self) -> VariantIter

Create an iterator over items in the variant.

Note that this heap allocates a variant for each element, which can be particularly expensive for large arrays.

pub fn array_iter_str( &self, ) -> Result<VariantStrIter<'_>, VariantTypeMismatchError>

Create an iterator over borrowed strings from a GVariant of type as (array of string).

This will fail if the variant is not an array of with the expected child type.

A benefit of this API over Self::iter() is that it minimizes allocation, and provides strongly typed access.

let strs = &["foo", "bar"];
let strs_variant: glib::Variant = strs.to_variant();
for s in strs_variant.array_iter_str()? {
    println!("{}", s);
}

pub fn is_container(&self) -> bool

Return whether this Variant is a container type.

pub fn is_normal_form(&self) -> bool

Return whether this Variant is in normal form.

pub fn is_object_path(string: &str) -> bool

Return whether input string is a valid VariantClass::ObjectPath.

pub fn is_signature(string: &str) -> bool

Return whether input string is a valid VariantClass::Signature.

Trait Implementations

impl AsRef<Variant> for Variant

fn as_ref(&self) -> &Variant

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Variant

fn clone(&self) -> Variant

Makes a clone of this shared reference.

This increments the strong reference count of the reference. Dropping the reference will decrement it again.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Variant

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for Variant

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<T> From<&[T]> for Variant

where T: StaticVariantType + ToVariant,

fn from(s: &[T]) -> Variant

Converts to this type from the input type.

impl From<&OsStr> for Variant

fn from(s: &OsStr) -> Variant

Converts to this type from the input type.

impl From<&Path> for Variant

fn from(p: &Path) -> Variant

Converts to this type from the input type.

impl<'a, T> From<&'a T> for Variant

where T: Into<Variant> + Clone,

fn from(v: &'a T) -> Variant

Converts to this type from the input type.

impl From<&str> for Variant

fn from(s: &str) -> Variant

Converts to this type from the input type.

impl From<()> for Variant

fn from(_: ()) -> Variant

Converts to this type from the input type.

impl<T0> From<(T0,)> for Variant

where T0: Into<Variant>,

fn from(t: (T0,)) -> Variant

Converts to this type from the input type.

impl<T0, T1> From<(T0, T1)> for Variant

where T0: Into<Variant>, T1: Into<Variant>,

fn from(t: (T0, T1)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2> From<(T0, T1, T2)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>,

fn from(t: (T0, T1, T2)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3> From<(T0, T1, T2, T3)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>,

fn from(t: (T0, T1, T2, T3)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4> From<(T0, T1, T2, T3, T4)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>,

fn from(t: (T0, T1, T2, T3, T4)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4, T5> From<(T0, T1, T2, T3, T4, T5)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>, T5: Into<Variant>,

fn from(t: (T0, T1, T2, T3, T4, T5)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4, T5, T6> From<(T0, T1, T2, T3, T4, T5, T6)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>, T5: Into<Variant>, T6: Into<Variant>,

fn from(t: (T0, T1, T2, T3, T4, T5, T6)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4, T5, T6, T7> From<(T0, T1, T2, T3, T4, T5, T6, T7)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>, T5: Into<Variant>, T6: Into<Variant>, T7: Into<Variant>,

fn from(t: (T0, T1, T2, T3, T4, T5, T6, T7)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8> From<(T0, T1, T2, T3, T4, T5, T6, T7, T8)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>, T5: Into<Variant>, T6: Into<Variant>, T7: Into<Variant>, T8: Into<Variant>,

fn from(t: (T0, T1, T2, T3, T4, T5, T6, T7, T8)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9> From<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>, T5: Into<Variant>, T6: Into<Variant>, T7: Into<Variant>, T8: Into<Variant>, T9: Into<Variant>,

fn from(t: (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10> From<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>, T5: Into<Variant>, T6: Into<Variant>, T7: Into<Variant>, T8: Into<Variant>, T9: Into<Variant>, T10: Into<Variant>,

fn from(t: (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11> From<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>, T5: Into<Variant>, T6: Into<Variant>, T7: Into<Variant>, T8: Into<Variant>, T9: Into<Variant>, T10: Into<Variant>, T11: Into<Variant>,

fn from(t: (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12> From<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>, T5: Into<Variant>, T6: Into<Variant>, T7: Into<Variant>, T8: Into<Variant>, T9: Into<Variant>, T10: Into<Variant>, T11: Into<Variant>, T12: Into<Variant>,

fn from(t: (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12)) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13> From<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>, T5: Into<Variant>, T6: Into<Variant>, T7: Into<Variant>, T8: Into<Variant>, T9: Into<Variant>, T10: Into<Variant>, T11: Into<Variant>, T12: Into<Variant>, T13: Into<Variant>,

fn from( t: (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13), ) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14> From<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>, T5: Into<Variant>, T6: Into<Variant>, T7: Into<Variant>, T8: Into<Variant>, T9: Into<Variant>, T10: Into<Variant>, T11: Into<Variant>, T12: Into<Variant>, T13: Into<Variant>, T14: Into<Variant>,

fn from( t: (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14), ) -> Variant

Converts to this type from the input type.

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15> From<(T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15)> for Variant

where T0: Into<Variant>, T1: Into<Variant>, T2: Into<Variant>, T3: Into<Variant>, T4: Into<Variant>, T5: Into<Variant>, T6: Into<Variant>, T7: Into<Variant>, T8: Into<Variant>, T9: Into<Variant>, T10: Into<Variant>, T11: Into<Variant>, T12: Into<Variant>, T13: Into<Variant>, T14: Into<Variant>, T15: Into<Variant>,

fn from( t: (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15), ) -> Variant

Converts to this type from the input type.

impl<K, V> From<BTreeMap<K, V>> for Variant

where K: StaticVariantType + Into<Variant> + Eq + Hash, V: StaticVariantType + Into<Variant>,

fn from(m: BTreeMap<K, V>) -> Variant

Converts to this type from the input type.

impl<K, V> From<DictEntry<K, V>> for Variant

where K: StaticVariantType + Into<Variant>, V: StaticVariantType + Into<Variant>,

fn from(e: DictEntry<K, V>) -> Variant

Converts to this type from the input type.

impl<A, T> From<FixedSizeVariantArray<A, T>> for Variant

where A: AsRef<[T]>, T: FixedSizeVariantType,

fn from(a: FixedSizeVariantArray<A, T>) -> Variant

Converts to this type from the input type.

impl From<Handle> for Variant

fn from(h: Handle) -> Variant

Converts to this type from the input type.

impl<K, V> From<HashMap<K, V>> for Variant

where K: StaticVariantType + Into<Variant> + Eq + Hash, V: StaticVariantType + Into<Variant>,

fn from(m: HashMap<K, V>) -> Variant

Converts to this type from the input type.

impl From<ObjectPath> for Variant

fn from(p: ObjectPath) -> Variant

Converts to this type from the input type.

impl<T> From<Option<T>> for Variant

where T: StaticVariantType + Into<Variant>,

fn from(v: Option<T>) -> Variant

Converts to this type from the input type.

impl From<OsString> for Variant

fn from(s: OsString) -> Variant

Converts to this type from the input type.

impl From<PathBuf> for Variant

fn from(p: PathBuf) -> Variant

Converts to this type from the input type.

impl From<Signature> for Variant

fn from(s: Signature) -> Variant

Converts to this type from the input type.

impl From<String> for Variant

fn from(s: String) -> Variant

Converts to this type from the input type.

impl From<Variant> for VariantDict

fn from(other: Variant) -> VariantDict

Converts to this type from the input type.

impl From<VariantDict> for Variant

fn from(d: VariantDict) -> Variant

Consume a given VariantDict and call VariantDict::end on it.

Note: While this method consumes the VariantDict, the underlying object could still be accessed through other clones because of the reference counted clone semantics.

impl<T> From<Vec<T>> for Variant

where T: StaticVariantType + Into<Variant>,

fn from(v: Vec<T>) -> Variant

Converts to this type from the input type.

impl From<bool> for Variant

fn from(v: bool) -> Variant

Converts to this type from the input type.

impl From<f64> for Variant

fn from(v: f64) -> Variant

Converts to this type from the input type.

impl From<i16> for Variant

fn from(v: i16) -> Variant

Converts to this type from the input type.

impl From<i32> for Variant

fn from(v: i32) -> Variant

Converts to this type from the input type.

impl From<i64> for Variant

fn from(v: i64) -> Variant

Converts to this type from the input type.

impl From<u16> for Variant

fn from(v: u16) -> Variant

Converts to this type from the input type.

impl From<u32> for Variant

fn from(v: u32) -> Variant

Converts to this type from the input type.

impl From<u64> for Variant

fn from(v: u64) -> Variant

Converts to this type from the input type.

impl From<u8> for Variant

fn from(v: u8) -> Variant

Converts to this type from the input type.

impl<T> FromIterator<T> for Variant

where T: Into<Variant> + StaticVariantType,

fn from_iter<I>(iter: I) -> Variant

where I: IntoIterator<Item = T>,

Creates a value from an iterator.

impl FromStr for Variant

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Variant, <Variant as FromStr>::Err>

Parses a string s to return a value of this type.

impl FromVariant for Variant

fn from_variant(variant: &Variant) -> Option<Variant>

Tries to extract a value.

impl HasParamSpec for Variant

type ParamSpec = ParamSpecVariant

type SetValue = Variant

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = for<'a> fn(&'a str, &'a VariantTy) -> ParamSpecVariantBuilder<'a>

fn param_spec_builder() -> <Variant as HasParamSpec>::BuilderFn

impl Hash for Variant

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Variant

fn eq(&self, other: &Variant) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Variant

fn partial_cmp(&self, other: &Variant) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for Variant

fn static_type() -> Type

Returns the type identifier of Self.

impl StaticVariantType for Variant

fn static_variant_type() -> Cow<'static, VariantTy>

Returns the VariantType corresponding to Self.

impl ToVariant for Variant

fn to_variant(&self) -> Variant

Returns a Variant clone of self.

impl Eq for Variant

impl Send for Variant

impl Sync for Variant