Struct JSONObjectWriter

pub struct JSONObjectWriter<'a, Writer: JSONWriter = String> {
    pub writer: &'a mut Writer,
    /* private fields */
}

Helper for appending a JSON object to the borrowed buffer.

Appends ‘{’ on creation. Appends ‘}’ when dropped.

Fields

writer: &'a mut Writer

Mutable borrow of buffer

Consider using the methods instead of using this field directly. This field should not be used unless you know what you are doing.

Implementations

impl<W: JSONWriter> JSONObjectWriter<'_, W>

pub fn new(writer: &mut W) -> JSONObjectWriter<'_, W>

Creates a new JSONObjectWriter that writes to the given buffer. Writes ‘{’ to the buffer immediately.

pub fn object<'a>(&'a mut self, key: &str) -> JSONObjectWriter<'a, W>

Starts writing a nested object with given key:

Esacapes key, writes “"key":{” and returns a JSONObjectWriter

pub fn array<'a>(&'a mut self, key: &str) -> JSONArrayWriter<'a, W>

Starts writing a nested array with given key:

Esacapes key, writes “"key":[” and returns a JSONArrayWriter.

pub fn value<T: JSONWriterValue>(&mut self, key: &str, value: T)

Escapes and appends key:value to the buffer

pub fn string_writer(&mut self, key: &str) -> JSONStringWriter<'_, W>

Write string with the given key, where the body of the string is built up using the JSONStringWriter that impls the fmt::Write trait and so can be used in the write! macro.

pub fn write_key(&mut self, key: &str)

Writes a key without any value.

Consider using the methods value(key, value), object(key) and array(key) instead of using this method directly.

Warning: If you use this method, you will have to write the value to the buffer yourself afterwards.

pub fn end(self)

Drops the writer. Dropping causes ‘}’ to be appended to the buffer.

impl JSONObjectWriter<'_, String>

pub fn output_buffered_data<Writer: Write>( &mut self, writer: &mut Writer, ) -> Result<usize, Error>

Writes the entire buffer to given writer and clears entire buffer on success.

pub fn buffer_len(&self) -> usize

Returns buffer length in bytes

Trait Implementations

impl<'a, W: JSONWriter> Drop for JSONObjectWriter<'a, W>

fn drop(&mut self)

Executes the destructor for this type.