Struct DomEntry 

pub struct DomEntry<'a> { /* private fields */ }

A single token in a Dom.

The representation is a fixed-size 16-byte struct:

word	bits	meaning
0 (offset 0)	63–60	DomEntryKind discriminant
0 (offset 0)	59–0	string/key length or object/array end-index
1 (offset 8)	63–0	pointer to string bytes (null for non-string kinds)

For EscapedString / EscapedKey the pointer is the data pointer of a Box<str> whose ownership is transferred into (and out of) this entry. DomEntry implements Drop to free that allocation.

For Bool the low bit of the payload encodes the value (0 = false, 1 = true). For Null, EndObject, EndArray both payload and pointer are zero.

Implementations

impl<'a> DomEntry<'a>

pub fn kind(&self) -> DomEntryKind

The discriminant.

pub fn null_entry() -> Self

pub fn bool_entry(v: bool) -> Self

pub fn number_entry(s: &'a str) -> Self

pub fn string_entry(s: &'a str) -> Self

pub fn escaped_string_entry(s: Box<str>) -> Self

pub fn key_entry(s: &'a str) -> Self

pub fn escaped_key_entry(s: Box<str>) -> Self

pub fn start_object_entry(end_idx: usize) -> Self

payload will be backfilled with the end-index later.

pub fn end_object_entry() -> Self

pub fn start_array_entry(end_idx: usize) -> Self

payload will be backfilled with the end-index later.

pub fn end_array_entry() -> Self

pub fn as_start_object(&self) -> Option<usize>

Returns Some(end_index) if this is StartObject, else None.

pub fn as_start_array(&self) -> Option<usize>

Returns Some(end_index) if this is StartArray, else None.

pub fn as_bool(&self) -> Option<bool>

Returns Some(b) if this is Bool, else None.

pub fn as_number(&self) -> Option<&'a str>

Returns the number text if this is Number, else None.

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

Returns the string text if this is String or EscapedString, else None.

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

Returns the key text if this is Key or EscapedKey, else None.

impl<'a> DomEntry<'a>

Convenience constructors using the old enum-variant names so existing test/user code keeps a familiar style.

pub const Null: DomEntry<'static>

Alias: DomEntry::Null → DomEntry::null_entry().

pub const EndObject: DomEntry<'static>

Alias: DomEntry::EndObject → DomEntry::end_object_entry().

pub const EndArray: DomEntry<'static>

Alias: DomEntry::EndArray → DomEntry::end_array_entry().

pub fn Bool(v: bool) -> Self

Construct a Bool entry. Replaces DomEntry::Bool(v).

pub fn Number(s: &'a str) -> Self

Construct a Number entry. Replaces DomEntry::Number(s).

pub fn String(s: &'a str) -> Self

Construct a String entry. Replaces DomEntry::String(s).

pub fn EscapedString(s: Box<str>) -> Self

Construct an EscapedString entry. Replaces DomEntry::EscapedString(b).

pub fn Key(s: &'a str) -> Self

Construct a Key entry. Replaces DomEntry::Key(s).

pub fn EscapedKey(s: Box<str>) -> Self

Construct an EscapedKey entry. Replaces DomEntry::EscapedKey(b).

pub fn StartObject(end_idx: usize) -> Self

Construct a StartObject entry. Replaces DomEntry::StartObject(n).

pub fn StartArray(end_idx: usize) -> Self

Construct a StartArray entry. Replaces DomEntry::StartArray(n).

Trait Implementations

impl<'a> Clone for DomEntry<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for DomEntry<'a>

Custom Debug that renders the same variant names as the old enum.

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

Formats the value using the given formatter.

impl<'a> Drop for DomEntry<'a>

fn drop(&mut self)

Executes the destructor for this type.

impl<'a> PartialEq for DomEntry<'a>

Equality. For EscapedString/EscapedKey we compare the string content.

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.

impl<'a> Send for DomEntry<'a>

impl<'a> Sync for DomEntry<'a>