Struct VariantType 

pub struct VariantType { /* private fields */ }

Describes Variant types.

The Variant type system (based on the D-Bus one) describes types with “type strings”. VariantType is an owned immutable type string (you can think of it as a Box<str> statically guaranteed to be a valid type string), &VariantTy is a borrowed one (like &str). .

Any type string of a container that contains an indefinite type is, itself, an indefinite type. For example, the type string a* (corresponding to G_VARIANT_TYPE_ARRAY) is an indefinite type that is a supertype of every array type. (*s) is a supertype of all tuples that contain exactly two items where the second item is a string.

a{?*} is an indefinite type that is a supertype of all arrays containing dictionary entries where the key is any basic type and the value is any type at all. This is, by definition, a dictionary, so this type string corresponds to G_VARIANT_TYPE_DICTIONARY. Note that, due to the restriction that the key of a dictionary entry must be a basic type, {**} is not a valid type string.

Implementations

impl VariantType

pub fn new(type_string: &str) -> Result<VariantType, BoolError>

Tries to create a VariantType from a string slice.

Returns Ok if the string is a valid type string, Err otherwise. Creates a new [type@GLib.VariantType] corresponding to the type string given by @type_string.

It is appropriate to call GLib::VariantType::free() on the return value.

It is a programmer error to call this function with an invalid type string. Use [string_is_valid()][Self::string_is_valid()] if you are unsure.

type_string

a valid GVariant type string

Returns

a new [type@GLib.VariantType]

pub fn new_dict_entry( key_type: &VariantTy, value_type: &VariantTy, ) -> VariantType

Creates a VariantType from a key and value type. Constructs the type corresponding to a dictionary entry with a key of type @key and a value of type @value.

It is appropriate to call GLib::VariantType::free() on the return value.

key

a basic type to use for the key

value

a type to use for the value

Returns

a new dictionary entry type Since 2.24

pub fn new_array(elem_type: &VariantTy) -> VariantType

Creates a VariantType from an array element type. Constructs the type corresponding to an array of elements of the type @type_.

It is appropriate to call [first()][Self::first()] on the return value.

element

an element type

Returns

a new array type Since 2.24

pub fn new_maybe(child_type: &VariantTy) -> VariantType

Creates a VariantType from a maybe element type. instance containing type @type_ or Nothing.

It is appropriate to call GLib::VariantType::free() on the return value.

element

an element type

Returns

type Since 2.24

pub fn new_tuple( items: impl IntoIterator<Item = impl AsRef<VariantTy>>, ) -> VariantType

Creates a VariantType from a maybe element type. Constructs a new tuple type, from @items.

@length is the number of items in @items, or -1 to indicate that @items is NULL-terminated.

It is appropriate to call GLib::VariantType::free() on the return value.

items

an array of types, one for each item

Returns

a new tuple type Since 2.24

pub fn from_string( type_string: impl Into<GString>, ) -> Result<VariantType, BoolError>

Tries to create a VariantType from an owned string.

Returns Ok if the string is a valid type string, Err otherwise.

Methods from Deref<Target = VariantTy>

pub const BOOLEAN: &'static VariantTy

pub const BYTE: &'static VariantTy

pub const INT16: &'static VariantTy

pub const UINT16: &'static VariantTy

pub const INT32: &'static VariantTy

pub const UINT32: &'static VariantTy

pub const INT64: &'static VariantTy

pub const UINT64: &'static VariantTy

pub const DOUBLE: &'static VariantTy

pub const STRING: &'static VariantTy

pub const OBJECT_PATH: &'static VariantTy

pub const SIGNATURE: &'static VariantTy

pub const VARIANT: &'static VariantTy

pub const HANDLE: &'static VariantTy

pub const UNIT: &'static VariantTy

pub const ANY: &'static VariantTy

pub const BASIC: &'static VariantTy

pub const MAYBE: &'static VariantTy

pub const ARRAY: &'static VariantTy

pub const TUPLE: &'static VariantTy

pub const DICT_ENTRY: &'static VariantTy

pub const DICTIONARY: &'static VariantTy

pub const STRING_ARRAY: &'static VariantTy

pub const OBJECT_PATH_ARRAY: &'static VariantTy

pub const BYTE_STRING: &'static VariantTy

pub const BYTE_STRING_ARRAY: &'static VariantTy

pub const VARDICT: &'static VariantTy

pub fn as_str(&self) -> &str

Converts to a string slice.

pub fn is_definite(&self) -> bool

Check if this variant type is a definite type.

pub fn is_container(&self) -> bool

Check if this variant type is a container type.

pub fn is_basic(&self) -> bool

Check if this variant type is a basic type.

pub fn is_maybe(&self) -> bool

Check if this variant type is a maybe type.

pub fn is_array(&self) -> bool

Check if this variant type is an array type.

pub fn is_tuple(&self) -> bool

Check if this variant type is a tuple type.

pub fn is_dict_entry(&self) -> bool

Check if this variant type is a dict entry type.

pub fn is_variant(&self) -> bool

Check if this variant type is a variant.

pub fn is_subtype_of(&self, supertype: &Self) -> bool

Check if this variant type is a subtype of another.

pub fn element(&self) -> &VariantTy

Return the element type of this variant type.

Panics

This function panics if not called with an array or maybe type.

pub fn tuple_types(&self) -> VariantTyIterator<'_>

Iterate over the types of this variant type.

Panics

This function panics if not called with a tuple or dictionary entry type.

pub fn first(&self) -> Option<&VariantTy>

Return the first type of this variant type.

Panics

This function panics if not called with a tuple or dictionary entry type.

pub fn next(&self) -> Option<&VariantTy>

Return the next type of this variant type.

pub fn n_items(&self) -> usize

Return the number of items in this variant type.

pub fn key(&self) -> &VariantTy

Return the key type of this variant type.

Panics

This function panics if not called with a dictionary entry type.

pub fn value(&self) -> &VariantTy

Return the value type of this variant type.

Panics

This function panics if not called with a dictionary entry type.

Trait Implementations

impl AsRef<VariantTy> for VariantType

fn as_ref(&self) -> &VariantTy

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

impl Borrow<VariantTy> for VariantType

fn borrow(&self) -> &VariantTy

Immutably borrows from an owned value.

impl Clone for VariantType

fn clone(&self) -> VariantType

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VariantType

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

Formats the value using the given formatter.

impl Deref for VariantType

type Target = VariantTy

The resulting type after dereferencing.

fn deref(&self) -> &VariantTy

Dereferences the value.

impl Display for VariantType

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

Formats the value using the given formatter.

impl Drop for VariantType

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Eq for VariantType

impl<'a> From<VariantType> for Cow<'a, VariantTy>

fn from(ty: VariantType) -> Cow<'a, VariantTy>

Converts to this type from the input type.

impl FromStr for VariantType

type Err = BoolError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

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

impl Hash for VariantType

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

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 VariantType

fn eq(&self, other: &Self) -> 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<'a, 'b> PartialEq<&'a VariantTy> for VariantType

fn eq(&self, other: &&'a VariantTy) -> 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<'a, 'b> PartialEq<&'a str> for VariantType

fn eq(&self, other: &&'a str) -> 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<'a, 'b> PartialEq<Cow<'a, VariantTy>> for VariantType

fn eq(&self, other: &Cow<'a, VariantTy>) -> 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<'a, 'b> PartialEq<String> for VariantType

fn eq(&self, other: &String) -> 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<'a, 'b> PartialEq<VariantTy> for VariantType

fn eq(&self, other: &VariantTy) -> 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<'a, 'b> PartialEq<VariantType> for VariantTy

fn eq(&self, other: &VariantType) -> 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<'a, 'b> PartialEq<VariantType> for &'a VariantTy

fn eq(&self, other: &VariantType) -> 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<'a, 'b> PartialEq<VariantType> for Cow<'a, VariantTy>

fn eq(&self, other: &VariantType) -> 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<'a, 'b> PartialEq<VariantType> for str

fn eq(&self, other: &VariantType) -> 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<'a, 'b> PartialEq<VariantType> for &'a str

fn eq(&self, other: &VariantType) -> 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<'a, 'b> PartialEq<VariantType> for String

fn eq(&self, other: &VariantType) -> 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<'a, 'b> PartialEq<str> for VariantType

fn eq(&self, other: &str) -> 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 Send for VariantType

impl StaticType for VariantType

fn static_type() -> Type

Returns the type identifier of Self.

impl Sync for VariantType