Enum RelatesTo 

pub enum RelatesTo {
    Annotation {
        event_id: EventId,
        key: String,
    },
    Replace {
        event_id: EventId,
    },
    Thread {
        event_id: EventId,
        is_falling_back: bool,
        in_reply_to: Option<InReplyTo>,
    },
    InReplyTo(InReplyTo),
    Unknown(Value),
}

One event’s m.relates_to field, parsed into the shape its rel_type (or, for the legacy reply pointer, the absence of one) implies. Never fails to parse: an m.relates_to value that matches none of the shapes below becomes RelatesTo::Unknown, carrying the raw value.

Variants

Annotation

m.annotation (reactions): key is the reaction’s own content (e.g. an emoji), event_id the event being reacted to.

Fields

event_id: EventId

The event being annotated.

key: String

The annotation’s key (an emoji, for m.reaction).

Replace

m.replace (edits, MSC2676): event_id is the event being replaced. The replacement content itself lives at the top level of the edit event’s own content, under m.new_content — not part of this type, since that key sits alongside m.relates_to, not inside it.

Fields

event_id: EventId

The event being replaced.

Thread

m.thread (MSC3440).

Fields

event_id: EventId

The thread’s root event.

is_falling_back: bool

true if this reply also sets m.in_reply_to purely for clients without threading UI, and should not be shown twice by a client that does understand threads.

in_reply_to: Option<InReplyTo>

The specific event within the thread this one is a rich reply to, if any.

InReplyTo(InReplyTo)

The legacy rich-reply pointer (m.in_reply_to with no rel_type alongside it) — still sent for backward compatibility even when an event carries a “real” relation.

Unknown(Value)

An m.relates_to value present but not matching any shape above — kept verbatim rather than rejected (module doc).

Implementations

impl RelatesTo

pub fn from_content(content: &Value) -> Option<Self>

Extracts and parses content["m.relates_to"], if present. Returns None only when the field itself is absent — most events don’t relate to anything. See this type’s own doc for what happens when the field is present but unrecognized.

Trait Implementations

impl Clone for RelatesTo

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RelatesTo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RelatesTo

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RelatesTo

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RelatesTo

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RelatesTo