Struct mungos::Document

pub struct Document { /* private fields */ }

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) -> Iter<'_>

Gets an iterator over the entries of the map.

pub fn iter_mut(&mut self) -> IterMut<'_>

Gets an iterator over pairs of keys and mutable values.

pub fn clear(&mut self)

Clears the document, removing all values.

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

Returns a reference to the Bson corresponding to the key.

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

Gets a mutable reference to the Bson corresponding to the key

pub fn get_f64(&self, key: impl AsRef<str>) -> Result<f64, ValueAccessError>

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

pub fn get_f64_mut(
    &mut self,
    key: impl AsRef<str>
) -> Result<&mut f64, ValueAccessError>

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: impl AsRef<str>
) -> Result<&Decimal128, ValueAccessError>

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

pub fn get_decimal128_mut(
    &mut self,
    key: impl AsRef<str>
) -> Result<&mut Decimal128, ValueAccessError>

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

pub fn get_str(&self, key: impl AsRef<str>) -> Result<&str, ValueAccessError>

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

pub fn get_str_mut(
    &mut self,
    key: impl AsRef<str>
) -> Result<&mut str, ValueAccessError>

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

pub fn get_array(
    &self,
    key: impl AsRef<str>
) -> Result<&Vec<Bson, Global>, ValueAccessError>

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: impl AsRef<str>
) -> Result<&mut Vec<Bson, Global>, ValueAccessError>

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

pub fn get_document(
    &self,
    key: impl AsRef<str>
) -> Result<&Document, ValueAccessError>

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: impl AsRef<str>
) -> Result<&mut Document, ValueAccessError>

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

pub fn get_bool(&self, key: impl AsRef<str>) -> Result<bool, ValueAccessError>

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

pub fn get_bool_mut(
    &mut self,
    key: impl AsRef<str>
) -> Result<&mut bool, ValueAccessError>

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: impl AsRef<str>) -> bool

Returns wether this key has a null value

pub fn get_i32(&self, key: impl AsRef<str>) -> Result<i32, ValueAccessError>

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

pub fn get_i32_mut(
    &mut self,
    key: impl AsRef<str>
) -> Result<&mut i32, ValueAccessError>

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: impl AsRef<str>) -> Result<i64, ValueAccessError>

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

pub fn get_i64_mut(
    &mut self,
    key: impl AsRef<str>
) -> Result<&mut i64, ValueAccessError>

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: impl AsRef<str>
) -> Result<Timestamp, ValueAccessError>

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

pub fn get_timestamp_mut(
    &mut self,
    key: impl AsRef<str>
) -> Result<&mut Timestamp, ValueAccessError>

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: impl AsRef<str>
) -> Result<&Vec<u8, Global>, ValueAccessError>

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: impl AsRef<str>
) -> Result<&mut Vec<u8, Global>, ValueAccessError>

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: impl AsRef<str>
) -> Result<ObjectId, ValueAccessError>

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

pub fn get_object_id_mut(
    &mut self,
    key: impl AsRef<str>
) -> Result<&mut ObjectId, ValueAccessError>

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: impl AsRef<str>
) -> Result<&DateTime, ValueAccessError>

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: impl AsRef<str>
) -> Result<&mut DateTime, ValueAccessError>

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: impl AsRef<str>) -> bool

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

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

Gets a collection of all keys in the document.

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

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, BT>(&mut self, key: KT, val: BT) -> Option<Bson>where
    KT: Into<String>,
    BT: Into<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: impl AsRef<str>) -> Option<Bson>

Takes the value of the entry out of the document, and returns it. Computes in O(n) time (average).

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

pub fn to_writer<W>(&self, writer: W) -> Result<(), Error>where
    W: Write,

Attempts to serialize the Document into a byte stream.

While the method signature indicates an owned writer must be passed in, a mutable reference may also be passed in due to blanket implementations of Write provided in the standard library.

use bson::doc;

let mut v: Vec<u8> = Vec::new();
let doc = doc! { "x" : 1 };
doc.to_writer(&mut v)?;

pub fn from_reader<R>(reader: R) -> Result<Document, Error>where
    R: Read,

Attempts to deserialize a Document from a byte stream.

While the method signature indicates an owned reader must be passed in, a mutable reference may also be passed in due to blanket implementations of Read provided in the standard library.

use bson::{doc, Document};
use std::io::Cursor;

let mut v: Vec<u8> = Vec::new();
let doc = doc! { "x" : 1 };
doc.to_writer(&mut v)?;

// read from mutable reference
let mut reader = Cursor::new(v.clone());
let doc1 = Document::from_reader(&mut reader)?;

// read from owned value
let doc2 = Document::from_reader(Cursor::new(v))?;

assert_eq!(doc, doc1);
assert_eq!(doc, doc2);

pub fn from_reader_utf8_lossy<R>(reader: R) -> Result<Document, Error>where
    R: Read,

Attempt to deserialize a Document that may contain invalid UTF-8 strings from a byte stream.

This is mainly useful when reading raw BSON returned from a MongoDB server, which in rare cases can contain invalidly truncated strings (https://jira.mongodb.org/browse/SERVER-24007). For most use cases, Document::from_reader can be used instead.

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, fmt: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for Document

fn default() -> Document

Returns the “default value” for a type.

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

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

Deserialize this value given this Deserializer.

impl Display for Document

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

Formats the value using the given formatter.

impl Extend<(String, Bson)> for Document

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

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 UpdateModifications

fn from(item: Document) -> UpdateModifications

Converts to this type from the input type.

impl FromIterator<(String, Bson)> for Document

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

Creates a value from an iterator.

impl Into<Document> for AggStage

fn into(self) -> Document

Converts this type into the (usually inferred) input type.

impl<'a> IntoIterator for &'a Document

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

The type of the elements being iterated over.

type IntoIter = Iter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a Document as IntoIterator>::IntoIter

Creates an iterator from a value.

impl IntoIterator for Document

type Item = (String, Bson)

The type of the elements being iterated over.

type IntoIter = IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> <Document as IntoIterator>::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: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Document

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

Serialize this value into the given Serde serializer.

impl TryFrom<&RawDocument> for Document

type Error = Error

The type returned in the event of a conversion error.

fn try_from(rawdoc: &RawDocument) -> Result<Document, Error>

Performs the conversion.

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<Document, Error>

Performs the conversion.

impl TryFrom<RawDocumentBuf> for Document

type Error = Error

The type returned in the event of a conversion error.

fn try_from(raw: RawDocumentBuf) -> Result<Document, Error>

Performs the conversion.

impl StructuralPartialEq for Document