This is the first stable release in the mongocxx 3.1.x series.

This release provides support for new features in MongoDB 3.4.

Please note that this version of mongocxx requires the MongoDB C Driver 1.5.0.

See the MongoDB C++ Driver Manual and the Driver Installation Instructions for more details on downloading, installing, and using this driver.

NOTE: The mongocxx 3.1.x series does not promise API or ABI stability across patch releases.

Note that there are no changes since the prior 3.1.0-rc0 release, with the exception of two documentation fixes (CXX-1149 and CXX-1155).

The full list of user-visible issues that have been resolved in 3.1.0 since the prior 3.0.x series are as follows:

Bug

• [CXX-894] - Return disengaged result optionals for unack'ed write operations
• [CXX-938] - stdx polyfills are not declared in the ABI inline namespace
• [CXX-1001] - mongocxx::cursor.begin() increments the iterator
• [CXX-1009] - mongocxx::pool should take options::pool, not options::ssl
• [CXX-1039] - Update link to final collation page in 3.4 manual
• [CXX-1047] - MSVC warning C4714, bsoncxx operator <<, view() etc. marked as __forceinline not inlined
• [CXX-1061] - Update link to final views page in 3.4 manual
• [CXX-1065] - read_concern::acknowledge_string should return const string_view
• [CXX-1070] - Confusing installation instructions
• [CXX-1093] - collection::distinct() should return error to user if collation specified and connection max wire version < 5
• [CXX-1100] - Having more than one iterator per cursor violates mongoc lifecycle constraints
• [CXX-1109] - Integration tests should pass against server versions 2.4 through 3.0
• [CXX-1135] - Read preference option not applied to distinct
• [CXX-1149] - Links to MongoDB Manual in documentation should point to development version of manual instead of stable version

New Feature

• [CXX-778] - Allow configuration of SSL independently of the C driver
• [CXX-859] - Implement Decimal 128 type spec
• [CXX-927] - Support sending writeConcern for commands that write
• [CXX-948] - Support new readConcern level "linearizable"
• [CXX-957] - Allow a user to decide whether to build static or shared libraries
• [CXX-971] - Support providing collation per operation
• [CXX-976] - Allow users to set a limit on acceptable staleness
• [CXX-978] - Add application name and driver version to the MongoDB handshake
• [CXX-999] - Support read-only views
• [CXX-1042] - Write mongocxx configuration guide
• [CXX-1051] - Add new top-level find options and deprecate options::find::modifiers()
• [CXX-1053] - Add getters to options::create_collection/options::create_view/validation_criteria classes, make setters support chaining, deprecate to_document() methods
• [CXX-1059] - Add aggregation pipeline class builder methods for new MongoDB 3.4 stages and $geoNear / $indexStats stages
• [CXX-1124] - Username no longer required for MONGODB-X509 auth
• [CXX-1132] - Test that collection::find(), collection::find_one(), and collection::find_one_and_*() fail with error if collation specified and server lacks collation support
• [CXX-1134] - Add bsoncxx generic internal error code
• [CXX-1142] - Make minimum value of maxStalenessSeconds 90 seconds
• [CXX-1155] - Add Windows configure/build/test instructions to cxx driver manual