Struct JsonCursor 

pub struct JsonCursor<'de> { /* private fields */ }

A low-level, allocation-free cursor for routing selected object fields.

Prefer normal Serde deserialization for application models. JsonCursor is intended for protocol envelopes whose hot path must inspect a few fields and defer large nested values as crate::RawJson.

Implementations

impl<'de> JsonCursor<'de>

pub const fn from_slice(input: &'de [u8]) -> Self

Creates a cursor over a byte slice.

pub fn from_str(input: &'de str) -> Self

Creates a cursor over a UTF-8 string.

pub fn object<T>( &mut self, visitor: impl FnOnce(&mut Object<'_, 'de>) -> Result<T>, ) -> Result<T>

Visits the next value as an object.

Unvisited fields are validated and skipped before this method returns.

Errors

Returns an error for malformed JSON or when the next value is not an object.

pub fn end(&mut self) -> Result<()>

Verifies that no trailing value or garbage remains.

Errors

Returns an error when non-whitespace input remains.