Struct bson::document::Document

pub struct Document { /* fields omitted */ }

A BSON document represented as an associative HashMap with insertion ordering.

Implementations

impl Document

pub fn new() -> Document

Creates a new empty Document.

pub fn iter(&self) -> DocumentIterator

Gets an iterator over the entries of the map.

pub fn clear(&mut self)

Clears the document, removing all values.

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

Returns a reference to the Bson corresponding to the key.

pub fn get_mut(&mut self, key: &str) -> Option<&mut Bson>

Gets a mutable reference to the Bson corresponding to the key

pub fn get_f64(&self, key: &str) -> ValueAccessResult<f64>

Get a floating point value for this key if it exists and has the correct type.

pub fn get_f64_mut(&mut self, key: &str) -> ValueAccessResult<&mut f64>

Get a mutable reference to a floating point value for this key if it exists and has the correct type.

pub fn get_decimal128(&self, key: &str) -> ValueAccessResult<&Decimal128>

Get a reference to a Decimal128 value for key, if it exists.

pub fn get_decimal128_mut(
    &mut self,
    key: &str
) -> ValueAccessResult<&mut Decimal128>

Get a mutable reference to a Decimal128 value for key, if it exists.

pub fn get_str(&self, key: &str) -> ValueAccessResult<&str>

Get a string slice this key if it exists and has the correct type.

pub fn get_str_mut(&mut self, key: &str) -> ValueAccessResult<&mut str>

Get a mutable string slice this key if it exists and has the correct type.

pub fn get_array(&self, key: &str) -> ValueAccessResult<&Array>

Get a reference to an array for this key if it exists and has the correct type.

pub fn get_array_mut(&mut self, key: &str) -> ValueAccessResult<&mut Array>

Get a mutable reference to an array for this key if it exists and has the correct type.

pub fn get_document(&self, key: &str) -> ValueAccessResult<&Document>

Get a reference to a document for this key if it exists and has the correct type.

pub fn get_document_mut(
    &mut self,
    key: &str
) -> ValueAccessResult<&mut Document>

Get a mutable reference to a document for this key if it exists and has the correct type.

pub fn get_bool(&self, key: &str) -> ValueAccessResult<bool>

Get a bool value for this key if it exists and has the correct type.

pub fn get_bool_mut(&mut self, key: &str) -> ValueAccessResult<&mut bool>

Get a mutable reference to a bool value for this key if it exists and has the correct type.

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

Returns wether this key has a null value

pub fn get_i32(&self, key: &str) -> ValueAccessResult<i32>

Get an i32 value for this key if it exists and has the correct type.

pub fn get_i32_mut(&mut self, key: &str) -> ValueAccessResult<&mut i32>

Get a mutable reference to an i32 value for this key if it exists and has the correct type.

pub fn get_i64(&self, key: &str) -> ValueAccessResult<i64>

Get an i64 value for this key if it exists and has the correct type.

pub fn get_i64_mut(&mut self, key: &str) -> ValueAccessResult<&mut i64>

Get a mutable reference to an i64 value for this key if it exists and has the correct type.

pub fn get_timestamp(&self, key: &str) -> ValueAccessResult<Timestamp>

Get a time stamp value for this key if it exists and has the correct type.

pub fn get_timestamp_mut(
    &mut self,
    key: &str
) -> ValueAccessResult<&mut Timestamp>

Get a mutable reference to a time stamp value for this key if it exists and has the correct type.

pub fn get_binary_generic(&self, key: &str) -> ValueAccessResult<&Vec<u8>>

Get a reference to a generic binary value for this key if it exists and has the correct type.

pub fn get_binary_generic_mut(
    &mut self,
    key: &str
) -> ValueAccessResult<&mut Vec<u8>>

Get a mutable reference generic binary value for this key if it exists and has the correct type.

pub fn get_object_id(&self, key: &str) -> ValueAccessResult<&ObjectId>

Get a reference to an object id value for this key if it exists and has the correct type.

pub fn get_object_id_mut(
    &mut self,
    key: &str
) -> ValueAccessResult<&mut ObjectId>

Get a mutable reference to an object id value for this key if it exists and has the correct type.

pub fn get_datetime(&self, key: &str) -> ValueAccessResult<&DateTime<Utc>>

Get a reference to a UTC datetime value for this key if it exists and has the correct type.

pub fn get_datetime_mut(
    &mut self,
    key: &str
) -> ValueAccessResult<&mut DateTime<Utc>>

Get a mutable reference to a UTC datetime value for this key if it exists and has the correct type.

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

Returns true if the map contains a value for the specified key.

pub fn keys<'a>(&'a self) -> Keys<'a>

Gets a collection of all keys in the document.

pub fn values<'a>(&'a self) -> Values<'a>

Gets a collection of all values in the document.

pub fn len(&self) -> usize

Returns the number of elements in the document.

pub fn is_empty(&self) -> bool

Returns true if the document contains no elements

pub fn insert<KT: Into<String>, BT: Into<Bson>>(
    &mut self,
    key: KT,
    val: BT
) -> Option<Bson>

Sets the value of the entry with the OccupiedEntry's key, and returns the entry's old value. Accepts any type that can be converted into Bson.

pub fn remove(&mut self, key: &str) -> Option<Bson>

Takes the value of the entry out of the document, and returns it.

pub fn entry(&mut self, k: String) -> Entry

pub fn to_writer<W: Write + ?Sized>(&self, writer: &mut W) -> Result<()>

Attempts to serialize the Document into a byte stream.

pub fn from_reader<R: Read + ?Sized>(reader: &mut R) -> Result<Document>

Attempts to deserialize a Document from a byte stream.

Trait Implementations

impl Clone for Document

fn clone(&self) -> Document

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Document

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

Formats the value using the given formatter.

impl Default for Document

fn default() -> Self

Returns the "default value" for a type.

impl<'de> Deserialize<'de> for Document

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, 

Deserialize this value given this Deserializer.

impl Display for Document

fn fmt(&self, fmt: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Extend<(String, Bson)> for Document

fn extend<T: IntoIterator<Item = (String, Bson)>>(&mut self, iter: T)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬 This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬 This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl From<Document> for Bson

fn from(a: Document) -> Bson

Performs the conversion.

impl From<LinkedHashMap<String, Bson, RandomState>> for Document

fn from(tree: LinkedHashMap<String, Bson>) -> Document

Performs the conversion.

impl FromIterator<(String, Bson)> for Document

fn from_iter<T: IntoIterator<Item = (String, Bson)>>(iter: T) -> Self

Creates a value from an iterator.

impl IntoIterator for Document

type Item = (String, Bson)

The type of the elements being iterated over.

type IntoIter = DocumentIntoIterator

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a Document

type Item = (&'a String, &'a Bson)

The type of the elements being iterated over.

type IntoIter = DocumentIterator<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq<Document> for Document

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Serialize for Document

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Document

impl TryFrom<Map<String, Value>> for Document

This converts from the input JSON as if it were MongoDB Extended JSON v2.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(obj: Map<String, Value>) -> Result<Self>

Performs the conversion.