Struct struson::reader::simple::ArrayReader

pub struct ArrayReader<'a, J: JsonReader> { /* private fields */ }

Available on crate feature experimental only.

Reader for an arbitrary amount of JSON array items

This struct is used by ValueReader::read_array.

Implementations

impl<J: JsonReader> ArrayReader<'_, J>

pub fn has_next(&mut self) -> Result<bool, ReaderError>

Checks if there is a next item in the JSON array, without consuming it

Returns true if there is a next item, false otherwise. This method can be useful as condition of a while loop when processing a JSON array of unknown size.

Examples

let json_reader = SimpleJsonReader::new("[1, 2]".as_bytes());
json_reader.read_array(|array_reader| {
    while array_reader.has_next()? {
        let value = array_reader.read_number_as_string()?;
        println!("{value}");
    }
    Ok(())
})?;

Trait Implementations

impl<'a, J: Debug + JsonReader> Debug for ArrayReader<'a, J>

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

Formats the value using the given formatter.

impl<J: JsonReader> ValueReader<J> for &mut ArrayReader<'_, J>

fn peek_value(&mut self) -> Result<ValueType, ReaderError>

Peeks at the type of the next JSON value, without consuming it

fn read_null(self) -> Result<(), ReaderError>

Consumes a JSON null value

fn read_bool(self) -> Result<bool, ReaderError>

Consumes and returns a JSON boolean value

fn read_str<T>( self, f: impl FnOnce(&str) -> Result<T, Box<dyn Error>> ) -> Result<T, Box<dyn Error>>

Consumes a JSON string value as borrowed str

fn read_string(self) -> Result<String, ReaderError>

Consumes and returns a JSON string value as owned String

fn read_string_with_reader<T>( self, f: impl FnOnce(StringValueReader<'_>) -> Result<T, Box<dyn Error>> ) -> Result<T, Box<dyn Error>>

Consumes a JSON string using a Read

fn read_number<T: FromStr>(self) -> Result<Result<T, T::Err>, ReaderError>

Consumes and returns a JSON number value

fn read_number_as_string(self) -> Result<String, ReaderError>

Consumes and returns the string representation of a JSON number value

fn read_deserialize<'de, D: Deserialize<'de>>( self ) -> Result<D, DeserializerError>

Available on crate feature serde only.

Deserializes a Serde Deserialize from the next value

fn skip_value(self) -> Result<(), ReaderError>

Skips the next JSON value

fn read_array<T>( self, f: impl FnOnce(&mut ArrayReader<'_, J>) -> Result<T, Box<dyn Error>> ) -> Result<T, Box<dyn Error>>

Consumes a JSON array

fn read_object_borrowed_names( self, f: impl FnMut(MemberReader<'_, J>) -> Result<(), Box<dyn Error>> ) -> Result<(), Box<dyn Error>>

Consumes a JSON object and all of its members, reading names as borrowed str

fn read_object_owned_names( self, f: impl FnMut(String, SingleValueReader<'_, J>) -> Result<(), Box<dyn Error>> ) -> Result<(), Box<dyn Error>>

Consumes a JSON object and all of its members, reading names as owned String

fn read_seeked<T>( self, path: &JsonPath, f: impl FnOnce(SingleValueReader<'_, J>) -> Result<T, Box<dyn Error>> ) -> Result<T, Box<dyn Error>>

Seeks to a value and consumes it

fn read_seeked_multi( self, path: &MultiJsonPath, at_least_one_match: bool, f: impl FnMut(SingleValueReader<'_, J>) -> Result<(), Box<dyn Error>> ) -> Result<(), Box<dyn Error>>

Seeks to multiple values and consumes them

fn read_array_items( self, f: impl FnMut(SingleValueReader<'_, J>) -> Result<(), Box<dyn Error>> ) -> Result<(), Box<dyn Error>>

where Self: Sized,

Consumes a JSON array and all of its items