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(i8Vec<u8, Global>),
}
Expand description

Represents any valid MessagePack value.

Variants

Nil

Nil represents nil.

Boolean(bool)

Boolean represents true or false.

Tuple Fields of Boolean

0: bool
Integer(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());

Tuple Fields of Integer

0: Integer
F32(f32)

A 32-bit floating point number.

Tuple Fields of F32

0: f32
F64(f64)

A 64-bit floating point number.

Tuple Fields of F64

0: f64
String(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

Tuple Fields of String

0: Utf8String
Binary(Vec<u8, Global>)

Binary extending Raw type represents a byte array.

Tuple Fields of Binary

0: Vec<u8, Global>
Array(Vec<Value, Global>)

Array represents a sequence of objects.

Tuple Fields of Array

0: Vec<Value, Global>

Map represents key-value pairs of objects.

Tuple Fields of Map

0: Vec<(Value, Value), Global>
Ext(i8Vec<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.

Tuple Fields of Ext

0: i81: Vec<u8, Global>

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());

Returns true if the Value is a Binary. Returns false otherwise.

Returns true if the Value is an Array. Returns false otherwise.

Returns true if the Value is a Map. Returns false otherwise.

Returns true if the Value is an Ext. Returns false otherwise.

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

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Formats the value using the given formatter. Read more

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Performs the conversion.

Note that an Iterator<Item = u8> will be collected into an Array, rather than a Binary

Creates a value from an iterator. Read more

The returned type after indexing.

Performs the indexing (container[index]) operation. Read more

The returned type after indexing.

Performs the indexing (container[index]) operation. Read more

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=.

Returns the value contained in self. Read more

Returns the value contained in self. Read more

Returns the value contained in self. Read more

This is needed because the blanket impl TryFrom<Value> for Value uses Error = !.

Returns the value contained in self. Read more

Returns the value contained in self. Read more

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.

Returns the value contained in self. Read more

Returns the value contained in self. Read more

Returns the value contained in self. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Performs the conversion.

Performs the conversion.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

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

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

Converts the given value to a String. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.