Struct Element 

pub struct Element<'buf> { /* private fields */ }

A JSON Element with identity, source span, and value.

Each element carries a shared reference to the document it was parsed from, so Element::path() can resolve its path.

Implementations

impl<'buf> Element<'buf>

pub fn id(&self) -> ElemId

pub fn span(&self) -> Span

pub fn full_span(&self) -> Span

Returns the span covering the value plus any trailing comma and whitespace.

Choose the removal span based on the element’s position in its parent:

Case	Span to erase
Replace value	Element::span
Remove non-last item	element.full_span()
Remove last item (siblings exist)	siblings[i-1].span().end .. element.span().end
Remove only item	element.span()

When there is no trailing comma (root element or last sibling), full_span() == span(). Erasing full_span of a last item leaves a dangling comma on the previous sibling; use the predecessor’s span().end as the start of the removal range instead.

pub fn value(&self) -> &Value<'buf>

pub fn path(&self) -> Path

Returns the RFC 9535 path to this element.

NOTE: The Path is constructed anew every time this functions is called.

pub fn source_json_value(&self) -> &'buf str

Returns the slice of the source JSON that this element spans.

pub fn source(&self) -> &'buf str

The full source string; all element spans are relative to this.

pub fn location(&self) -> Location

Return the location that this element begins at.

pub fn as_value(&self) -> &Value<'buf>

Return the inner Value by ref.

pub fn to_raw_str(&self) -> Option<RawStr<'buf>>

Return Some(&str) if the Value is a String.

pub fn as_object_fields(&self) -> Option<&[Field<'buf>]>

Return Some(&[Field]) if the Value is a Object.

pub fn as_array(&self) -> Option<&[Element<'buf>]>

pub fn as_number_str(&self) -> Option<&str>

pub fn is_null(&self) -> bool

Return true if the Elements Value is null.

pub fn is_object(&self) -> bool

Return true if the Elements Value is an object.

pub fn is_array(&self) -> bool

Return true if the Elements Value is an array.

Trait Implementations

impl<'buf> Clone for Element<'buf>

fn clone(&self) -> Element<'buf>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'buf> Debug for Element<'buf>

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

Formats the value using the given formatter.

impl Eq for Element<'_>

impl PartialEq for Element<'_>

fn eq(&self, other: &Self) -> 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.