Enum nvim_rs::Value [−][src]
pub enum Value {
Nil,
Boolean(bool),
Integer(Integer),
F32(f32),
F64(f64),
String(Utf8String),
Binary(Vec<u8, Global>),
Array(Vec<Value, Global>),
Map(Vec<(Value, Value), Global>),
Ext(i8, Vec<u8, Global>),
}
Expand description
Represents any valid MessagePack value.
Variants
Nil
Nil represents nil.
Boolean(bool)
Tuple Fields
0: bool
Boolean represents true or false.
Integer(Integer)
Tuple Fields
0: Integer
Integer represents an integer.
A value of an Integer
object is limited from -(2^63)
upto (2^64)-1
.
Examples
use rmpv::Value;
assert_eq!(42, Value::from(42).as_i64().unwrap());
F32(f32)
Tuple Fields
0: f32
A 32-bit floating point number.
F64(f64)
Tuple Fields
0: f64
A 64-bit floating point number.
String(Utf8String)
Tuple Fields
0: Utf8String
String extending Raw type represents a UTF-8 string.
Note
String objects may contain invalid byte sequence and the behavior of a deserializer depends on the actual implementation when it received invalid byte sequence. Deserializers should provide functionality to get the original byte array so that applications can decide how to handle the object
Binary(Vec<u8, Global>)
Binary extending Raw type represents a byte array.
Array(Vec<Value, Global>)
Array represents a sequence of objects.
Map(Vec<(Value, Value), Global>)
Map represents key-value pairs of objects.
Ext(i8, Vec<u8, Global>)
Extended implements Extension interface: represents a tuple of type information and a byte array where type information is an integer whose meaning is defined by applications.
Implementations
Converts the current owned Value to a ValueRef.
Panics
Panics in unable to allocate memory to keep all internal structures and buffers.
Examples
use rmpv::{Value, ValueRef};
let val = Value::Array(vec![
Value::Nil,
Value::from(42),
Value::Array(vec![
Value::String("le message".into())
])
]);
let expected = ValueRef::Array(vec![
ValueRef::Nil,
ValueRef::from(42),
ValueRef::Array(vec![
ValueRef::from("le message"),
])
]);
assert_eq!(expected, val.as_ref());
Returns true if the Value
is a Null. Returns false otherwise.
Examples
use rmpv::Value;
assert!(Value::Nil.is_nil());
Returns true if the Value
is a Boolean. Returns false otherwise.
Examples
use rmpv::Value;
assert!(Value::Boolean(true).is_bool());
assert!(!Value::Nil.is_bool());
Returns true if the Value
is convertible to an i64. Returns false otherwise.
Examples
use rmpv::Value;
assert!(Value::from(42).is_i64());
assert!(!Value::from(42.0).is_i64());
Returns true if the Value
is convertible to an u64. Returns false otherwise.
Examples
use rmpv::Value;
assert!(Value::from(42).is_u64());
assert!(!Value::F32(42.0).is_u64());
assert!(!Value::F64(42.0).is_u64());
Returns true if (and only if) the Value
is a f32. Returns false otherwise.
Examples
use rmpv::Value;
assert!(Value::F32(42.0).is_f32());
assert!(!Value::from(42).is_f32());
assert!(!Value::F64(42.0).is_f32());
Returns true if (and only if) the Value
is a f64. Returns false otherwise.
Examples
use rmpv::Value;
assert!(Value::F64(42.0).is_f64());
assert!(!Value::from(42).is_f64());
assert!(!Value::F32(42.0).is_f64());
Returns true if the Value
is a Number. Returns false otherwise.
Examples
use rmpv::Value;
assert!(Value::from(42).is_number());
assert!(Value::F32(42.0).is_number());
assert!(Value::F64(42.0).is_number());
assert!(!Value::Nil.is_number());
Returns true if the Value
is a String. Returns false otherwise.
Examples
use rmpv::Value;
assert!(Value::String("value".into()).is_str());
assert!(!Value::Nil.is_str());
If the Value
is a Boolean, returns the associated bool.
Returns None otherwise.
Examples
use rmpv::Value;
assert_eq!(Some(true), Value::Boolean(true).as_bool());
assert_eq!(None, Value::Nil.as_bool());
If the Value
is an integer, return or cast it to a i64.
Returns None otherwise.
Examples
use rmpv::Value;
assert_eq!(Some(42i64), Value::from(42).as_i64());
assert_eq!(None, Value::F64(42.0).as_i64());
If the Value
is an integer, return or cast it to a u64.
Returns None otherwise.
Examples
use rmpv::Value;
assert_eq!(Some(42u64), Value::from(42).as_u64());
assert_eq!(None, Value::from(-42).as_u64());
assert_eq!(None, Value::F64(42.0).as_u64());
If the Value
is a number, return or cast it to a f64.
Returns None otherwise.
Examples
use rmpv::Value;
assert_eq!(Some(42.0), Value::from(42).as_f64());
assert_eq!(Some(42.0), Value::F32(42.0f32).as_f64());
assert_eq!(Some(42.0), Value::F64(42.0f64).as_f64());
assert_eq!(Some(2147483647.0), Value::from(i32::max_value() as i64).as_f64());
assert_eq!(None, Value::Nil.as_f64());
If the Value
is a String, returns the associated str.
Returns None otherwise.
Examples
use rmpv::Value;
assert_eq!(Some("le message"), Value::String("le message".into()).as_str());
assert_eq!(None, Value::Boolean(true).as_str());
If the Value
is a Binary or a String, returns the associated slice.
Returns None otherwise.
Examples
use rmpv::Value;
assert_eq!(Some(&[1, 2, 3, 4, 5][..]), Value::Binary(vec![1, 2, 3, 4, 5]).as_slice());
assert_eq!(None, Value::Boolean(true).as_slice());
If the Value
is an Array, returns the associated vector.
Returns None otherwise.
Examples
use rmpv::Value;
let val = Value::Array(vec![Value::Nil, Value::Boolean(true)]);
assert_eq!(Some(&vec![Value::Nil, Value::Boolean(true)]), val.as_array());
assert_eq!(None, Value::Nil.as_array());
If the Value
is a Map, returns the associated vector of key-value tuples.
Returns None otherwise.
Note
MessagePack represents map as a vector of key-value tuples.
Examples
use rmpv::Value;
let val = Value::Map(vec![(Value::Nil, Value::Boolean(true))]);
assert_eq!(Some(&vec![(Value::Nil, Value::Boolean(true))]), val.as_map());
assert_eq!(None, Value::Nil.as_map());
If the Value
is an Ext, returns the associated tuple with a ty and slice.
Returns None otherwise.
Examples
use rmpv::Value;
assert_eq!(Some((42, &[1, 2, 3, 4, 5][..])), Value::Ext(42, vec![1, 2, 3, 4, 5]).as_ext());
assert_eq!(None, Value::Boolean(true).as_ext());
Trait Implementations
Creates a value from an iterator. Read more
This is needed because the blanket impl TryFrom<Value> for Value
uses
Error = !
.
The bound Value: From<T>
is necessary so we can recover the values if one
of the elements could not be unpacked. In practice, though, we only
implement TryUnpack<T>
in those cases anyways.
Auto Trait Implementations
impl RefUnwindSafe for Value
impl UnwindSafe for Value
Blanket Implementations
Mutably borrows from an owned value. Read more