Struct ImDocument

pub struct ImDocument<S> { /* private fields */ }

Type representing a parsed TOML document

Implementations

impl ImDocument<&'static str>

pub fn new() -> Self

Creates an empty document

impl<S: AsRef<str>> ImDocument<S>

pub fn parse(raw: S) -> Result<Self, TomlError>

Available on crate feature parse only.

Parse a TOML document

impl<S> ImDocument<S>

pub fn as_item(&self) -> &Item

Returns a reference to the root item.

pub fn as_table(&self) -> &Table

Returns a reference to the root table.

pub fn iter(&self) -> Iter<'_>

Returns an iterator over the root table.

pub fn trailing(&self) -> &RawString

Whitespace after last element

impl<S: AsRef<str>> ImDocument<S>

pub fn raw(&self) -> &str

Access the raw, unparsed document

impl<S: AsRef<str>> ImDocument<S>

pub fn into_mut(self) -> DocumentMut

Allow editing of the DocumentMut

Methods from Deref<Target = Table>

pub fn get_values(&self) -> Vec<(Vec<&Key>, &Value)>

Get key/values for values that are visually children of this table

For example, this will return dotted keys

pub fn is_implicit(&self) -> bool

If a table has no key/value pairs and implicit, it will not be displayed.

pub fn is_dotted(&self) -> bool

Check if this is a wrapper for dotted keys, rather than a standard table

pub fn position(&self) -> Option<usize>

The position of the Table within the DocumentMut.

Returns None if the Table was created manually (i.e. not via parsing) in which case its position is set automatically. This can be overridden with Table::set_position.

pub fn decor(&self) -> &Decor

Returns the decor associated with a given key of the table.

pub fn key(&self, key: &str) -> Option<&Key>

Returns an accessor to a key’s formatting

pub fn key_decor(&self, key: &str) -> Option<&Decor>

👎Deprecated since 0.21.1: Replaced with key_mut

Returns the decor associated with a given key of the table.

pub fn span(&self) -> Option<Range<usize>>

The location within the original document

This generally requires an ImDocument.

pub fn iter(&self) -> Iter<'_>

Returns an iterator over all key/value pairs, including empty.

pub fn len(&self) -> usize

Returns the number of non-empty items in the table.

pub fn is_empty(&self) -> bool

Returns true if the table is empty.

pub fn get<'a>(&'a self, key: &str) -> Option<&'a Item>

Returns an optional reference to an item given the key.

pub fn get_key_value<'a>(&'a self, key: &str) -> Option<(&'a Key, &'a Item)>

Return references to the key-value pair stored for key, if it is present, else None.

pub fn contains_key(&self, key: &str) -> bool

Returns true if the table contains an item with the given key.

pub fn contains_table(&self, key: &str) -> bool

Returns true if the table contains a table with the given key.

pub fn contains_value(&self, key: &str) -> bool

Returns true if the table contains a value with the given key.

pub fn contains_array_of_tables(&self, key: &str) -> bool

Returns true if the table contains an array of tables with the given key.

Trait Implementations

impl<S: Clone> Clone for ImDocument<S>

fn clone(&self) -> ImDocument<S>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S: Debug> Debug for ImDocument<S>

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

Formats the value using the given formatter.

impl Default for ImDocument<&'static str>

fn default() -> Self

Returns the “default value” for a type.

impl<S> Deref for ImDocument<S>

type Target = Table

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl FromStr for ImDocument<String>

Available on crate feature parse only.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a document from a &str

type Err = TomlError

The associated error which can be returned from parsing.

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.