Struct yrs::types::xml::XmlTextRef

#[repr(transparent)]
pub struct XmlTextRef(_);

A shared data type used for collaborative text editing, that can be used in a context of [XmlElement] nodee. It enables multiple users to add and remove chunks of text in efficient manner. This type is internally represented as a mutable double-linked list of text chunks

• an optimization occurs during [Transaction::commit], which allows to squash multiple consecutively inserted characters together as a single chunk of text even between transaction boundaries in order to preserve more efficient memory model.

Just like [XmlElement], [XmlText] can be marked with extra metadata in form of attributes.

[XmlText] structure internally uses UTF-8 encoding and its length is described in a number of bytes rather than individual characters (a single UTF-8 code point can consist of many bytes).

Like all Yrs shared data types, [XmlText] is resistant to the problem of interleaving (situation when characters inserted one after another may interleave with other peers concurrent inserts after merging all updates together). In case of Yrs conflict resolution is solved by using unique document id to determine correct and consistent ordering.

Trait Implementations

impl AsMut<Branch> for XmlTextRef

fn as_mut(&mut self) -> &mut Branch

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<Branch> for XmlTextRef

fn as_ref(&self) -> &Branch

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for XmlTextRef

fn clone(&self) -> XmlTextRef

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for XmlTextRef

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

Formats the value using the given formatter.

impl From<BranchPtr> for XmlTextRef

fn from(inner: BranchPtr) -> Self

Converts to this type from the input type.

impl GetString for XmlTextRef

fn get_string<T: ReadTxn>(&self, txn: &T) -> String

Displays the content of a current collection in string format.

impl Observable for XmlTextRef

type Event = XmlTextEvent

fn try_observer(
    &self
) -> Option<&Observer<Arc<dyn Fn(&TransactionMut<'_>, &Self::Event)>>>

fn try_observer_mut(
    &mut self
) -> Option<&mut Observer<Arc<dyn Fn(&TransactionMut<'_>, &Self::Event)>>>

fn observe<F>(
    &mut self,
    f: F
) -> Subscription<Arc<dyn Fn(&TransactionMut<'_>, &Self::Event)>>where
    F: Fn(&TransactionMut<'_>, &Self::Event) + 'static,

Subscribes a given callback to be triggered whenever current y-type is changed. A callback is triggered whenever a transaction gets committed. This function does not trigger if changes have been observed by nested shared collections.

fn unobserve(&self, subscription_id: SubscriptionId)

Unsubscribes a previously subscribed event callback identified by given subscription_id.

impl PartialEq<XmlTextRef> for XmlTextRef

fn eq(&self, other: &XmlTextRef) -> bool

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

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Text for XmlTextRef

fn len<T: ReadTxn>(&self, txn: &T) -> u32

Returns a number of characters visible in a current text data structure.

fn insert(&self, txn: &mut TransactionMut<'_>, index: u32, chunk: &str)

Inserts a chunk of text at a given index. If index is 0, this chunk will be inserted at the beginning of a current text. If index is equal to current data structure length, this chunk will be appended at the end of it.

fn insert_with_attributes(
    &self,
    txn: &mut TransactionMut<'_>,
    index: u32,
    chunk: &str,
    attributes: Attrs
)

Inserts a chunk of text at a given index. If index is 0, this chunk will be inserted at the beginning of a current text. If index is equal to current data structure length, this chunk will be appended at the end of it. Collection of supplied attributes will be used to wrap provided text chunk range with a formatting blocks.

fn insert_embed(&self, txn: &mut TransactionMut<'_>, index: u32, content: Any)

Inserts an embed content at a given index.

fn insert_embed_with_attributes(
    &self,
    txn: &mut TransactionMut<'_>,
    index: u32,
    embed: Any,
    attributes: Attrs
)

Inserts an embed content of text at a given index. If index is 0, this content will be inserted at the beginning of a current text. If index is equal to current data structure length, this chunk will be appended at the end of it. Collection of supplied attributes will be used to wrap provided text content range with a formatting blocks.

fn push(&self, txn: &mut TransactionMut<'_>, chunk: &str)

Appends a given chunk of text at the end of a current text structure.

fn remove_range(&self, txn: &mut TransactionMut<'_>, index: u32, len: u32)

Removes up to a len characters from a current text structure, starting at given index. This method panics in case when not all expected characters were removed (due to insufficient number of characters to remove) or index is outside of the bounds of text.

fn format(
    &self,
    txn: &mut TransactionMut<'_>,
    index: u32,
    len: u32,
    attributes: Attrs
)

Wraps an existing piece of text within a range described by index-len parameters with formatting blocks containing provided attributes metadata.

fn diff<T, D, F>(&self, txn: &T, compute_ychange: F) -> Vec<Diff<D>>where
    T: ReadTxn,
    F: Fn(YChange) -> D,

fn diff_range<D, F>(
    &self,
    txn: &mut TransactionMut<'_>,
    hi: Option<&Snapshot>,
    lo: Option<&Snapshot>,
    compute_ychange: F
) -> Vec<Diff<D>>where
    F: Fn(YChange) -> D,

Returns the Delta representation of this YText type.

impl TryInto<XmlTextRef> for XmlNode

type Error = XmlNode

The type returned in the event of a conversion error.

fn try_into(self) -> Result<XmlTextRef, Self::Error>

Performs the conversion.

impl Xml for XmlTextRef

fn parent(&self) -> Option<XmlNode>

fn remove_attribute<K>(&self, txn: &mut TransactionMut<'_>, attr_name: &K)where
    K: AsRef<str>,

Removes an attribute recognized by an attr_name from a current XML element.

fn insert_attribute<K, V>(
    &self,
    txn: &mut TransactionMut<'_>,
    attr_name: K,
    attr_value: V
)where
    K: Into<Rc<str>>,
    V: AsRef<str>,

Inserts an attribute entry into current XML element.

fn get_attribute<T: ReadTxn>(&self, txn: &T, attr_name: &str) -> Option<String>

Returns a value of an attribute given its attr_name. Returns None if no such attribute can be found inside of a current XML element.

fn attributes<'a, T: ReadTxn>(&'a self, txn: &'a T) -> Attributes<'a, &'a T, T>

Returns an unordered iterator over all attributes (key-value pairs), that can be found inside of a current XML element.

fn siblings<'a, T: ReadTxn>(&self, txn: &'a T) -> Siblings<'a, T>

impl Eq for XmlTextRef

impl StructuralEq for XmlTextRef

impl StructuralPartialEq for XmlTextRef