Enum Value 

pub enum Value {
    Any(Any),
    YText(TextRef),
    YArray(ArrayRef),
    YMap(MapRef),
    YXmlElement(XmlElementRef),
    YXmlFragment(XmlFragmentRef),
    YXmlText(XmlTextRef),
    YDoc(Doc),
    UndefinedRef(BranchPtr),
}

Value that can be returned by Yrs data types. This includes Any which is an extension representation of JSON, but also nested complex collaborative structures specific to Yrs.

Variants

Any(Any)

Any value that it treated as a single element in it’s entirety.

YText(TextRef)

Instance of a TextRef.

YArray(ArrayRef)

Instance of an ArrayRef.

YMap(MapRef)

Instance of a MapRef.

YXmlElement(XmlElementRef)

Instance of a XmlElementRef.

YXmlFragment(XmlFragmentRef)

Instance of a XmlFragmentRef.

YXmlText(XmlTextRef)

Instance of a XmlTextRef.

YDoc(Doc)

Subdocument.

UndefinedRef(BranchPtr)

Instance of a shared collection of undefined type. Usually happens when it refers to a root type that has not been defined locally. Can also refer to a [WeakRef] if “weak” feature flag was not set.

Implementations

impl Value

pub fn cast<T>(self) -> Result<T, Value>

where T: TryFrom<Value, Error = Value>,

pub fn to_string<T>(self, txn: &T) -> String

where T: ReadTxn,

Converts current value into stringified representation.

pub fn try_branch(&self) -> Option<&Branch>

Trait Implementations

impl Clone for Value

fn clone(&self) -> Value

Returns a duplicate 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 Default for Value

fn default() -> Value

Returns the “default value” for a type.

impl Display for Value

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

Formats the value using the given formatter.

impl<T> From<T> for Value

where T: Into<Any>,

fn from(v: T) -> Value

Converts to this type from the input type.

impl Into<Value> for BranchPtr

fn into(self) -> Value

Converts current branch data into a Value. It uses a type ref information to resolve, which value variant is a correct one for this branch. Since branch represent only complex types Value::Any will never be returned from this method.

impl PartialEq for Value

fn eq(&self, other: &Value) -> 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 ToJson for Value

fn to_json<T>(&self, txn: &T) -> Any

where T: ReadTxn,

Converts current value into Any object equivalent that resembles enhanced JSON payload. Rules are:

• Primitive types (Value::Any) are passed right away, as no transformation is needed.
• Value::YArray is converted into JSON-like array.
• Value::YMap is converted into JSON-like object map.
• Value::YText, Value::YXmlText and Value::YXmlElement are converted into strings (XML types are stringified XML representation).

impl TryFrom<Value> for Arc<[u8]>

type Error = Value

The type returned in the event of a conversion error.

fn try_from( value: Value, ) -> Result<Arc<[u8]>, <Arc<[u8]> as TryFrom<Value>>::Error>

Performs the conversion.

impl TryFrom<Value> for Arc<str>

type Error = Value

The type returned in the event of a conversion error.

fn try_from( value: Value, ) -> Result<Arc<str>, <Arc<str> as TryFrom<Value>>::Error>

Performs the conversion.

impl TryFrom<Value> for ArrayRef

type Error = Value

The type returned in the event of a conversion error.

fn try_from( value: Value, ) -> Result<ArrayRef, <ArrayRef as TryFrom<Value>>::Error>

Performs the conversion.

impl TryFrom<Value> for Doc

type Error = Value

The type returned in the event of a conversion error.

fn try_from(value: Value) -> Result<Doc, <Doc as TryFrom<Value>>::Error>

Performs the conversion.

impl TryFrom<Value> for MapRef

type Error = Value

The type returned in the event of a conversion error.

fn try_from(value: Value) -> Result<MapRef, <MapRef as TryFrom<Value>>::Error>

Performs the conversion.

impl TryFrom<Value> for String

type Error = Value

The type returned in the event of a conversion error.

fn try_from(value: Value) -> Result<String, <String as TryFrom<Value>>::Error>

Performs the conversion.

impl TryFrom<Value> for TextRef

type Error = Value

The type returned in the event of a conversion error.

fn try_from(value: Value) -> Result<TextRef, <TextRef as TryFrom<Value>>::Error>

Performs the conversion.

impl TryFrom<Value> for Vec<u8>

type Error = Value

The type returned in the event of a conversion error.

fn try_from(value: Value) -> Result<Vec<u8>, <Vec<u8> as TryFrom<Value>>::Error>

Performs the conversion.

impl TryFrom<Value> for XmlElementRef

type Error = Value

The type returned in the event of a conversion error.

fn try_from( value: Value, ) -> Result<XmlElementRef, <XmlElementRef as TryFrom<Value>>::Error>

Performs the conversion.

impl TryFrom<Value> for XmlFragmentRef

type Error = Value

The type returned in the event of a conversion error.

fn try_from( value: Value, ) -> Result<XmlFragmentRef, <XmlFragmentRef as TryFrom<Value>>::Error>

Performs the conversion.

impl TryFrom<Value> for XmlNode

type Error = Value

The type returned in the event of a conversion error.

fn try_from(value: Value) -> Result<XmlNode, <XmlNode as TryFrom<Value>>::Error>

Performs the conversion.

impl TryFrom<Value> for XmlTextRef

type Error = Value

The type returned in the event of a conversion error.

fn try_from( value: Value, ) -> Result<XmlTextRef, <XmlTextRef as TryFrom<Value>>::Error>

Performs the conversion.

impl StructuralPartialEq for Value