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

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

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

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

pub fn get_str(&self, key: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<str>) -> bool

Returns wether this key has a null value

pub fn get_i32(&self, key: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<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: impl AsRef<str>) -> ValueAccessResult<ObjectId>

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

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>, ) -> ValueAccessResult<&mut DateTime>

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: 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: 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: Write>(&self, writer: W) -> Result<()>

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: Read>(reader: R) -> Result<Document>

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: Read>(reader: R) -> Result<Document>

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 duplicate 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

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

Converts to this type from the input type.

impl FromIterator<(String, Bson)> for Document

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

Creates a value from an iterator.

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) -> Self::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) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for Document

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

Tests for self and other values to be equal, and is used by ==.

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

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::Ok, S::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>

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<Self>

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>

Performs the conversion.

impl StructuralPartialEq for Document