Struct Object 

pub(crate) struct Object {
    members: Vec<Member>,
    inner: Trivia,
    base: String,
    unit: Indent,
}

An object with its members in source order.

Member names are unique.

Fields

members: Vec<Member>

inner: Trivia

Trivia before the closing brace.

base: String

The indent of the member that holds this object. The first member inserted into an object with no line break of its own is placed relative to it.

unit: Indent

One level of indentation for members inserted into this object.

Implementations

impl Object

pub(in json) fn new() -> Self

pub(super) fn build(entries: &Entries, dialect: Dialect, depth: usize) -> Self

The canonical object for entries, at depth.

pub(in json) fn closed_by( self, inner: Trivia, ) -> Self

This object with the trivia before its closing brace.

pub(super) fn indent_unit(&self) -> Option<Indent>

The indent unit of the first multi-line member, if there is one.

fn detect_unit(&self, base: &str) -> Option<Indent>

The same for an object that starts a line at indent base.

pub(super) fn set_unit(&mut self, unit: &Indent)

Set the indent unit for members inserted into this object.

pub(in json) fn push( &mut self, member: Member, ) -> Result<(), DuplicateKey>

Append a parsed member.

Errors

Returns the name when it is already present.

fn position(&self, name: &str) -> Option<usize>

pub(in json) fn keys( &self, ) -> impl Iterator<Item = &str>

The member names in source order.

pub(in json) fn get( &self, name: &str, ) -> Option<&Value>

pub(in json) fn descend( &mut self, name: &str, ) -> Option<&mut Value>

Enter the value of name for editing. An object value takes this object’s indent unit and the indent it is placed at, so that members inserted into it line up.

pub(in json) fn insert( &mut self, name: &str, value: Value, )

Replace the value of name, or append a member.

An existing member keeps its own leading trivia, so the user’s spacing and comments stay, unless value carries a comment of its own. Then the leading trivia of value replaces it. A new member takes the leading trivia of value, moved to the indent of its siblings, and a key spelled the canonical way for the dialect it is printed in. value is laid out like a canonical member value: its lines are indented relative to the indent of its leading trivia.

An empty object stays as it is until a member is inserted into it. Then it takes a line break and the indent of the member that holds it, so that the new member and its closing brace line up.

fn replace_member(&mut self, index: usize, value: Value, from: &str)

Give the member at index the body of value. from is the indent of the leading trivia of value.

fn append_member( &mut self, name: &str, value: Value, from: &str, commented: bool, )

Add a member for value after the last one. from is the indent of the leading trivia of value, which has a comment when commented.

fn expand_before(&mut self, index: usize)

Put the member at index on a line of its own. A one-line object is expanded to one member per line.

fn expand(&mut self) -> String

Move every member to its own line and the closing brace to a line of its own. Returns the indent of the members.

fn reindent_incoming(value: &mut Value, from: &str, to: &str)

Fit the body of an incoming value to its new place.

fn plan_layout(&self) -> Layout

Where a new member goes.

fn empty_base(&self) -> String

The indent of the line that holds the closing brace of an empty object, once it has one.

fn expand_empty(&mut self)

Move the closing brace of an empty object to a line of its own.

pub(in json) fn remove( &mut self, name: &str, )

Remove the member name with its leading trivia. A removed last member hands its comma style to the new last member. An object left empty prints as {} unless a comment is left inside it.

pub(super) fn trivia_mut(&mut self, visit: &mut dyn FnMut(&mut Trivia))

pub(super) fn write(&self, f: &mut Formatter<'_>, dialect: Dialect) -> Result

Trait Implementations

impl Clone for Object

fn clone(&self) -> Object

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Object

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

Formats the value using the given formatter.

impl Eq for Object

impl PartialEq for Object

fn eq(&self, other: &Object) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Object