BSON

An umbrella module providing a BSON parser, encoder, and decoder.

import BSON

Module information

BSON Usage Examples
Using BSON in production generally consists of three kinds of tasks: defining root types that model the documents you want to store as BSON, defining reusable supporting types to model fields in other types, and actually encoding and decoding BSON documents to and from binary data.
Read More
BSON Decoding and Encoding, Explained
This article walks through the process of implementing BSONDocumentDecodable and BSONDocumentEncodable conformances for a model type in detail, and explains the rationale behind library’s design decisions.
Read More
Advanced Serialization Patterns
Level up your BSON encoding skills by learning these composable serialiation patterns. Internalizing these techniques will help you write more efficient and maintainable database applications by avoiding temporary allocations and reusing generic library code.
Read More
Textures and Coordinates
BSON documents can embed arbitrary binary data. This is useful for storing trivial repeating values like RGB colors or 3D coordinates, and can save an enormous amount of keying overhead, though at the cost of making the data un-queryable, as the database will not understand your custom data format.
Read More

This module re-exports the BSONABI, BSONEncoding, BSONDecoding, and BSONArrays modules. Importing them directly is discouraged.

Some BSON modules (currently BSONLegacy and BSONReflection) are considered ancillary and are not included in this umbrella module.