Struct glib::value::Value

#[repr(C)]
pub struct Value(_, _);

A generic value capable of carrying various types.

Once created the type of the value can’t be changed.

Some types (e.g. String and objects) support None values while others (e.g. numeric types) don’t.

Value does not implement the Send trait, but SendValue can be used instead.

See the module documentation for more details.

Implementations

impl Value

pub fn from_type(type_: Type) -> Self

Creates a new Value that is initialized with type_

pub fn downcast<'a, T: FromValueOptional<'a> + SetValue>(
    self
) -> Result<TypedValue<T>, Self>

Tries to downcast to a TypedValue.

Returns Ok(TypedValue<T>) if the value carries a type corresponding to T and Err(self) otherwise.

pub fn downcast_ref<'a, T: FromValueOptional<'a> + SetValue>(
    &self
) -> Option<&TypedValue<T>>

Tries to downcast to a &TypedValue.

Returns Some(&TypedValue<T>) if the value carries a type corresponding to T and None otherwise.

pub fn get<'a, T: FromValueOptional<'a>>(&'a self) -> Option<T>

Tries to get a value of type T.

Returns Some if the type is correct and the value is not None.

This function doesn’t distinguish between type mismatches and correctly typed None values. Use downcast or is for that.

pub fn is<'a, T: FromValueOptional<'a> + SetValue>(&self) -> bool

Returns true if the type of the value corresponds to T or is a sub-type of T.

pub fn type_(&self) -> Type

Returns the type of the value.

pub fn type_transformable(src: Type, dst: Type) -> bool

Returns whether Values of type src can be transformed to type dst.

pub fn try_into_send_value<'a, T: Send + FromValueOptional<'a> + SetValue>(
    self
) -> Result<SendValue, Self>

Trait Implementations

impl Clone for Value

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Value

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

Formats the value using the given formatter.

impl Drop for Value

fn drop(&mut self)

Executes the destructor for this type.

impl<'a, T: ?Sized + SetValue> From<&'a T> for Value

fn from(value: &'a T) -> Self

Converts to this type from the input type.

impl<'a, T: ?Sized + SetValueOptional> From<Option<&'a T>> for Value

fn from(value: Option<&'a T>) -> Self

Converts to this type from the input type.

impl From<SendValue> for Value

fn from(value: SendValue) -> Self

Converts to this type from the input type.

impl<T> From<TypedValue<T>> for Value

fn from(value: TypedValue<T>) -> Self

Converts to this type from the input type.

impl FromGlibContainerAsVec<*mut GValue, *const *mut GValue> for Value

unsafe fn from_glib_none_num_as_vec(
    ptr: *const *mut GValue,
    num: usize
) -> Vec<Self>

unsafe fn from_glib_container_num_as_vec(
    _: *const *mut GValue,
    _: usize
) -> Vec<Self>

unsafe fn from_glib_full_num_as_vec(_: *const *mut GValue, _: usize) -> Vec<Self>

impl FromGlibContainerAsVec<*mut GValue, *mut *mut GValue> for Value

unsafe fn from_glib_none_num_as_vec(
    ptr: *mut *mut GValue,
    num: usize
) -> Vec<Self>

unsafe fn from_glib_container_num_as_vec(
    ptr: *mut *mut GValue,
    num: usize
) -> Vec<Self>

unsafe fn from_glib_full_num_as_vec(
    ptr: *mut *mut GValue,
    num: usize
) -> Vec<Self>

impl FromGlibPtrArrayContainerAsVec<*mut GValue, *const *mut GValue> for Value

unsafe fn from_glib_none_as_vec(ptr: *const *mut GValue) -> Vec<Self>

unsafe fn from_glib_container_as_vec(_: *const *mut GValue) -> Vec<Self>

unsafe fn from_glib_full_as_vec(_: *const *mut GValue) -> Vec<Self>

impl FromGlibPtrArrayContainerAsVec<*mut GValue, *mut *mut GValue> for Value

unsafe fn from_glib_none_as_vec(ptr: *mut *mut GValue) -> Vec<Self>

unsafe fn from_glib_container_as_vec(ptr: *mut *mut GValue) -> Vec<Self>

unsafe fn from_glib_full_as_vec(ptr: *mut *mut GValue) -> Vec<Self>

impl FromGlibPtrFull<*mut GValue> for Value

unsafe fn from_glib_full(ptr: *mut GValue) -> Self

impl FromGlibPtrNone<*const GValue> for Value

unsafe fn from_glib_none(ptr: *const GValue) -> Self

impl FromGlibPtrNone<*mut GValue> for Value

unsafe fn from_glib_none(ptr: *mut GValue) -> Self

impl<'a> ToGlibContainerFromSlice<'a, *const GValue> for &'a Value

type Storage = &'a [&'a Value]

fn to_glib_none_from_slice(
    t: &'a [&'a Value]
) -> (*const GValue, &'a [&'a Value])

fn to_glib_container_from_slice(
    _: &'a [&'a Value]
) -> (*const GValue, &'a [&'a Value])

fn to_glib_full_from_slice(_: &[&'a Value]) -> *const GValue

impl<'a> ToGlibContainerFromSlice<'a, *mut GValue> for &'a Value

type Storage = &'a [&'a Value]

fn to_glib_none_from_slice(t: &'a [&'a Value]) -> (*mut GValue, &'a [&'a Value])

fn to_glib_container_from_slice(
    t: &'a [&'a Value]
) -> (*mut GValue, &'a [&'a Value])

fn to_glib_full_from_slice(t: &[&'a Value]) -> *mut GValue

impl<'a> ToGlibPtr<'a, *const GValue> for Value

type Storage = &'a Value

fn to_glib_none(&'a self) -> Stash<'a, *const GValue, Self>

Transfer: none.

fn to_glib_container(&'a self) -> Stash<'a, P, Self>

Transfer: container.

fn to_glib_full(&self) -> P

Transfer: full.

impl<'a> ToGlibPtrMut<'a, *mut GValue> for Value

type Storage = &'a mut Value

fn to_glib_none_mut(&'a mut self) -> StashMut<'a, *mut GValue, Self>

Transfer: none.

impl ToValue for Value

fn to_value(&self) -> Value

Returns a Value clone of self.

fn to_value_type(&self) -> Type

Returns the type identifer of self.

impl Uninitialized for Value

unsafe fn uninitialized() -> Value

Returns an uninitialized value.