Trait glib::value::ToValue

source ·
pub trait ToValue {
    // Required methods
    fn to_value(&self) -> Value;
    fn value_type(&self) -> Type;
}
Expand description

Trait to convert a value to a Value.

Similar to other common conversion traits, the following invariants are guaranteed:

  • Invertibility: x.to_value().get().unwrap() == x. In words, FromValue is the inverse of ToValue.
  • Idempotence: x.to_value() == x.to_value().to_value(). In words, applying ToValue multiple times yields the same result as applying it once. Idempotence also applies the other way around: value.get::<Value>() is a no-op.

There is also the possibility to wrap values within values, see BoxedValue. All (un-)boxing needs to be done manually, and will be preserved under the conversion methods.

The conversion methods may cause values to be cloned, which may result in reference counter changes or heap allocations depending on the source and target type.

Required Methods§

source

fn to_value(&self) -> Value

Convert a value to a Value.

source

fn value_type(&self) -> Type

Returns the type identifer of self.

This is the type of the value to be returned by to_value.

Implementations on Foreign Types§

source§

impl ToValue for &str

source§

impl ToValue for &Path

source§

impl ToValue for bool

source§

impl ToValue for char

source§

impl ToValue for f32

source§

impl ToValue for f64

source§

impl ToValue for i8

source§

impl ToValue for i32

source§

impl ToValue for i64

source§

impl ToValue for str

source§

impl ToValue for u8

source§

impl ToValue for u32

source§

impl ToValue for u64

source§

impl ToValue for Box<str>

source§

impl ToValue for String

source§

impl ToValue for Vec<GString>

source§

impl ToValue for Vec<String>

source§

impl ToValue for NonZeroI8

source§

impl ToValue for NonZeroI32

source§

impl ToValue for NonZeroI64

source§

impl ToValue for NonZeroU8

source§

impl ToValue for NonZeroU32

source§

impl ToValue for NonZeroU64

source§

impl ToValue for NonNull<Pointee>

source§

impl ToValue for Path

source§

impl ToValue for PathBuf

source§

impl<'a> ToValue for &'a [&'a str]

source§

impl<'a> ToValue for [&'a str]

source§

impl<T: ToValue + StaticType> ToValue for &T

Blanket implementation for all references.

source§

impl<T: ToValueOptional + StaticType> ToValue for Option<T>

Blanket implementation for all optional types.

Implementors§