Struct Jiter 

pub struct Jiter<'j> { /* private fields */ }

A JSON iterator.

Implementations

impl<'j> Jiter<'j>

pub fn new(data: &'j [u8]) -> Self

Constructs a new Jiter.

Arguments

• data: The JSON data to be parsed.
• allow_inf_nan: Whether to allow NaN, Infinity and -Infinity as numbers.

pub fn with_allow_inf_nan(self) -> Self

pub fn with_allow_partial_strings(self) -> Self

pub fn current_position(&self) -> LinePosition

Get the current LinePosition of the parser.

pub fn current_index(&self) -> usize

Get the current index of the parser.

pub fn slice_to_current(&self, start: usize) -> &'j [u8]

Get a slice of the underlying JSON data from start to current_index.

pub fn error_position(&self, index: usize) -> LinePosition

Convert an error index to a LinePosition.

Arguments

• index: The index of the error to find the position of.

pub fn peek(&mut self) -> JiterResult<Peek>

Peek at the next JSON value without consuming it.

pub fn next_null(&mut self) -> JiterResult<()>

Assuming the next value is null, consume it. Error if it is not null, or is invalid JSON.

pub fn known_null(&mut self) -> JiterResult<()>

Knowing the next value is null, consume it.

pub fn next_bool(&mut self) -> JiterResult<bool>

Assuming the next value is true or false, consume it. Error if it is not a boolean, or is invalid JSON.

Returns

The boolean value.

pub fn known_bool(&mut self, peek: Peek) -> JiterResult<bool>

Knowing the next value is true or false, parse it.

pub fn next_number(&mut self) -> JiterResult<NumberAny>

Assuming the next value is a number, consume it. Error if it is not a number, or is invalid JSON.

Returns

A NumberAny representing the number.

pub fn known_number(&mut self, peek: Peek) -> JiterResult<NumberAny>

Knowing the next value is a number, parse it.

pub fn next_int(&mut self) -> JiterResult<NumberInt>

Assuming the next value is an integer, consume it. Error if it is not an integer, or is invalid JSON.

pub fn known_int(&mut self, peek: Peek) -> JiterResult<NumberInt>

Knowing the next value is an integer, parse it.

pub fn next_float(&mut self) -> JiterResult<f64>

Assuming the next value is a float, consume it. Error if it is not a float, or is invalid JSON.

pub fn known_float(&mut self, peek: Peek) -> JiterResult<f64>

Knowing the next value is a float, parse it.

pub fn next_number_bytes(&mut self) -> JiterResult<&[u8]>

Assuming the next value is a number, consume it and return bytes from the original JSON data.

pub fn known_number_bytes(&mut self, peek: Peek) -> JiterResult<&[u8]>

Knowing the next value is a number, parse it and return bytes from the original JSON data.

pub fn next_str(&mut self) -> JiterResult<&str>

Assuming the next value is a string, consume it. Error if it is not a string, or is invalid JSON.

pub fn known_str(&mut self) -> JiterResult<&str>

Knowing the next value is a string, parse it.

pub fn next_bytes(&mut self) -> JiterResult<&[u8]>

Assuming the next value is a string, consume it and return bytes from the original JSON data.

pub fn known_bytes(&mut self) -> JiterResult<&[u8]>

Knowing the next value is a string, parse it and return bytes from the original JSON data.

pub fn next_value(&mut self) -> JiterResult<JsonValue<'j>>

Parse the next JSON value and return it as a JsonValue. Error if it is invalid JSON.

pub fn known_value(&mut self, peek: Peek) -> JiterResult<JsonValue<'j>>

Parse the next JSON value and return it as a JsonValue. Error if it is invalid JSON.

Arguments

• peek: The Peek of the next JSON value.

pub fn next_skip(&mut self) -> JiterResult<()>

Parse the next JSON value, but don’t return it. This should be faster than returning the value, useful when you don’t care about this value. Error if it is invalid JSON.

WARNING: For performance reasons, this method does not check that strings would be valid UTF-8.

pub fn known_skip(&mut self, peek: Peek) -> JiterResult<()>

Parse the next JSON value, but don’t return it. Error if it is invalid JSON.

Arguments

• peek: The Peek of the next JSON value.

pub fn next_value_owned(&mut self) -> JiterResult<JsonValue<'static>>

Parse the next JSON value and return it as a JsonValue with static lifetime. Error if it is invalid JSON.

pub fn known_value_owned( &mut self, peek: Peek, ) -> JiterResult<JsonValue<'static>>

Parse the next JSON value and return it as a JsonValue with static lifetime. Error if it is invalid JSON.

Arguments

• peek: The Peek of the next JSON value.

pub fn next_array(&mut self) -> JiterResult<Option<Peek>>

Assuming the next value is an array, peek at the first value. Error if it is not an array, or is invalid JSON.

Returns

The Some(peek) of the first value in the array is not empty, None if it is empty.

pub fn known_array(&mut self) -> JiterResult<Option<Peek>>

Assuming the next value is an array, peat at the first value.

pub fn array_step(&mut self) -> JiterResult<Option<Peek>>

Peek at the next value in an array.

pub fn next_object(&mut self) -> JiterResult<Option<&str>>

Assuming the next value is an object, consume the first key. Error if it is not an object, or is invalid JSON.

Returns

The Some(key) of the first key in the object is not empty, None if it is empty.

pub fn known_object(&mut self) -> JiterResult<Option<&str>>

Assuming the next value is an object, conssume the first key and return bytes from the original JSON data.

pub fn next_object_bytes(&mut self) -> JiterResult<Option<&[u8]>>

Assuming the next value is an object, peek at the first key.

pub fn next_key(&mut self) -> JiterResult<Option<&str>>

Get the next key in an object, or None if there are no more keys.

pub fn next_key_bytes(&mut self) -> JiterResult<Option<&[u8]>>

Get the next key in an object as bytes, or None if there are no more keys.

pub fn finish(&mut self) -> JiterResult<()>

Finish parsing the JSON data. Error if there is more data to be parsed.

Trait Implementations

impl Clone for Jiter<'_>

fn clone(&self) -> Self

Clone a Jiter. Like the default implementation, but a new empty tape is used.

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

Performs copy-assignment from source.

impl<'j> Debug for Jiter<'j>

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

Formats the value using the given formatter.