BSONDocument

@dynamicMemberLookup
public struct BSONDocument
extension BSONDocument: Codable
extension BSONDocument: Collection
extension BSONDocument: Sequence
extension BSONDocument: BSONValue
extension BSONDocument: Equatable
extension BSONDocument: CustomStringConvertible
extension BSONDocument: ExpressibleByDictionaryLiteral
extension BSONDocument: Hashable

A struct representing the BSON document type.

Show on GitHub

  • Declaration

    Swift

    public func encode(to encoder: Encoder) throws
    Show on GitHub

  • This method will work with any Decoder, but for non-BSON decoders, we do not support decoding Dates, because of limitations of decoding to AnyBSONValues. See AnyBSONValue.init(from:) for more information.

    Declaration

    Swift

    public init(from decoder: Decoder) throws
    Show on GitHub

  • The index type of a document.

    Declaration

    Swift

    public typealias Index = Int
    Show on GitHub

  • Returns the start index of the Document.

    Declaration

    Swift

    public var startIndex: Index { get }
    Show on GitHub

  • Returns the end index of the Document.

    Declaration

    Swift

    public var endIndex: Index { get }
    Show on GitHub

  • Returns the index after the given index for this Document.

    Declaration

    Swift

    public func index(after i: Index) -> Index
    Show on GitHub

  • Allows access to a KeyValuePair from the BSONDocument, given the position of the desired KeyValuePair held within. This method does not guarantee constant-time (O(1)) access.

    Declaration

    Swift

    public subscript(position: Index) -> KeyValuePair { get }
    Show on GitHub

  • Allows access to a KeyValuePair from the BSONDocument, given a range of indices of the desired KeyValuePair‘s held within. This method does not guarantee constant-time (O(1)) access.

    Declaration

    Swift

    public subscript(bounds: Range<Index>) -> BSONDocument { get }
    Show on GitHub

  • The element type of a document: a tuple containing an individual key-value pair.

    Declaration

    Swift

    public typealias KeyValuePair = (key: String, value: BSON)
    Show on GitHub

  • The type that is returned from methods such as dropFirst() and split().

    Declaration

    Swift

    public typealias SubSequence = BSONDocument
    Show on GitHub

  • Returns a Bool indicating whether the document is empty.

    Declaration

    Swift

    public var isEmpty: Bool { get }
    Show on GitHub

  • Returns a BSONDocumentIterator over the values in this BSONDocument.

    Declaration

    Swift

    public func makeIterator() -> BSONDocumentIterator
    Show on GitHub

  • Returns a new document containing the keys of this document with the values transformed by the given closure.

    Throws

    An error if transform throws an error.

    Declaration

    Swift

    public func mapValues(_ transform: (BSON) throws -> BSON) rethrows -> BSONDocument

    Parameters

    transform

    A closure that transforms a BSON. transform accepts each value of the document as its parameter and returns a transformed BSON.

    Return Value

    A document containing the keys and transformed values of this document.

    Show on GitHub

  • Returns a document containing all but the given number of initial key-value pairs.

    Declaration

    Swift

    public func dropFirst(_ n: Int) -> BSONDocument

    Parameters

    k

    The number of key-value pairs to drop from the beginning of the document. k must be > 0.

    Return Value

    A document starting after the specified number of key-value pairs.

    Show on GitHub

  • Returns a document containing all but the given number of final key-value pairs.

    Declaration

    Swift

    public func dropLast(_ n: Int) -> BSONDocument

    Parameters

    k

    The number of key-value pairs to drop from the end of the document. Must be greater than or equal to zero.

    Return Value

    A document leaving off the specified number of final key-value pairs.

    Show on GitHub

  • Returns a document by skipping the initial, consecutive key-value pairs that satisfy the given predicate.

    Throws

    An error if predicate throws an error.

    Declaration

    Swift

    public func drop(while predicate: (KeyValuePair) throws -> Bool) rethrows -> BSONDocument

    Parameters

    predicate

    A closure that takes a key-value pair as its argument and returns a boolean indicating whether the key-value pair should be included in the result.

    Return Value

    A document starting after the initial, consecutive key-value pairs that satisfy predicate.

    Show on GitHub

  • Returns a document, up to the specified maximum length, containing the initial key-value pairs of the document.

    Declaration

    Swift

    public func prefix(_ maxLength: Int) -> BSONDocument

    Parameters

    maxLength

    The maximum length for the returned document. Must be greater than or equal to zero.

    Return Value

    A document starting at the beginning of this document with at most maxLength key-value pairs.

    Show on GitHub

  • Returns a document containing the initial, consecutive key-value pairs that satisfy the given predicate.

    Throws

    An error if predicate throws an error.

    Declaration

    Swift

    public func prefix(while predicate: (KeyValuePair) throws -> Bool) rethrows -> BSONDocument

    Parameters

    predicate

    A closure that takes a key-value pair as its argument and returns a boolean indicating whether the key-value pair should be included in the result.

    Return Value

    A document containing the initial, consecutive key-value pairs that satisfy predicate.

    Show on GitHub

  • Returns a document, up to the specified maximum length, containing the final key-value pairs of the document.

    Declaration

    Swift

    public func suffix(_ maxLength: Int) -> BSONDocument

    Parameters

    maxLength

    The maximum length for the returned document. Must be greater than or equal to zero.

    Return Value

    A document ending at the end of this document with at most maxLength key-value pairs.

    Show on GitHub

  • Returns the longest possible subsequences of the document, in order, that don’t contain key-value pairs satisfying the given predicate. Key-value pairs that are used to split the document are not returned as part of any subsequence.

    Declaration

    Swift

    public func split(
    maxSplits: Int = Int.max,
    omittingEmptySubsequences: Bool = true,
    whereSeparator isSeparator: (KeyValuePair) throws -> Bool
) rethrows -> [BSONDocument]

    Parameters

    maxSplits

    The maximum number of times to split the document, or one less than the number of subsequences to return. If maxSplits + 1 subsequences are returned, the last one is a suffix of the original document containing the remaining key-value pairs. maxSplits must be greater than or equal to zero. The default value is Int.max.
    omittingEmptySubsequences

    If false, an empty document is returned in the result for each pair of consecutive key-value pairs satisfying the isSeparator predicate and for each key-value pair at the start or end of the document satisfying the isSeparator predicate. If true, only nonempty documents are returned. The default value is true.
    isSeparator

    A closure that returns true if its argument should be used to split the document and otherwise returns false.

    Return Value

    An array of documents, split from this document’s key-value pairs.

    Show on GitHub

  • Returns a new document containing the elements of the document that satisfy the given predicate.

    Throws

    An error if isIncluded throws an error.

    Declaration

    Swift

    public func filter(_ isIncluded: (KeyValuePair) throws -> Bool) rethrows -> BSONDocument

    Parameters

    isIncluded

    A closure that takes a key-value pair as its argument and returns a Bool indicating whether the pair should be included in the returned document.

    Return Value

    A document containing the key-value pairs that isIncluded allows.

    Show on GitHub

  • Returns a [String] containing the keys in this BSONDocument.

    Declaration

    Swift

    public var keys: [String] { get }
    Show on GitHub

  • Returns a [BSON] containing the values stored in this BSONDocument.

    Declaration

    Swift

    public var values: [BSON] { get }
    Show on GitHub

  • Returns the number of (key, value) pairs stored at the top level of this BSONDocument.

    Declaration

    Swift

    public var count: Int { get }
    Show on GitHub

  • Returns the relaxed extended JSON representation of this BSONDocument. On error, an empty string will be returned.

    Declaration

    Swift

    public func toExtendedJSONString() -> String
    Show on GitHub

  • Returns the canonical extended JSON representation of this BSONDocument. On error, an empty string will be returned.

    Declaration

    Swift

    public func toCanonicalExtendedJSONString() -> String
    Show on GitHub

  • Returns a copy of the raw BSON data for this Document, represented as Data.

    Declaration

    Swift

    public func toData() -> Data
    Show on GitHub

  • Initializes a new, empty BSONDocument.

    Declaration

    Swift

    public init()
    Show on GitHub

  • Constructs a new BSONDocument from the provided JSON text.

    Throws

    Throws:

    Declaration

    Swift

    public init(fromJSON: Data) throws

    Parameters

    fromJSON

    a JSON document as Data to parse into a BSONDocument

    Return Value

    the parsed BSONDocument

    Show on GitHub

  • Convenience initializer for constructing a BSONDocument from a String.

    Throws

    Declaration

    Swift

    public init(fromJSON json: String) throws
    Show on GitHub

  • Constructs a BSONDocument from raw BSON Data.

    Throws

    See also

    http://bsonspec.org/

    Declaration

    Swift

    public init(fromBSON bson: Data) throws
    Show on GitHub

  • Returns a Boolean indicating whether this BSONDocument contains the provided key.

    Declaration

    Swift

    public func hasKey(_ key: String) -> Bool
    Show on GitHub

  • Allows setting values and retrieving values using subscript syntax. For example:

     let d = Document()
 d["a"] = 1
 print(d["a"]) // prints 1

    A nil return value indicates that the subscripted key does not exist in the BSONDocument. A true BSON null is returned as BSON.null.

    Declaration

    Swift

    public subscript(key: String) -> BSON? { get set }
    Show on GitHub

  • An implementation identical to subscript(key: String), but offers the ability to choose a default value if the key is missing. For example:

     let d: Document = ["hello": "world"]
 print(d["hello", default: "foo"]) // prints "world"
 print(d["a", default: "foo"]) // prints "foo"

    Declaration

    Swift

    public subscript(key: String, default defaultValue: @autoclosure () -> BSON) -> BSON { get }
    Show on GitHub

  • Allows setting values and retrieving values using dot-notation syntax. For example:

     let d = Document()
 d.a = 1
 print(d.a) // prints 1

    A nil return value indicates that the key does not exist in the BSONDocument. A true BSON null is returned as BSON.null.

    Declaration

    Swift

    public subscript(dynamicMember member: String) -> BSON? { get set }
    Show on GitHub

  • Declaration

    Swift

    public static func == (lhs: BSONDocument, rhs: BSONDocument) -> Bool
    Show on GitHub

  • Returns the relaxed extended JSON representation of this BSONDocument. On error, an empty string will be returned.

    Declaration

    Swift

    public var description: String { get }
    Show on GitHub

  • Initializes a BSONDocument using a dictionary literal where the keys are Strings and the values are BSONs. For example: d: Document = ["a" : 1 ]

    Declaration

    Swift

    public init(dictionaryLiteral keyValuePairs: (String, BSON)...)

    Parameters

    dictionaryLiteral

    a [String: BSON]

    Return Value

    a new BSONDocument

    Show on GitHub

  • Declaration

    Swift

    public func hash(into hasher: inout Hasher)
    Show on GitHub