Menu Docs
Página inicial do Docs
/ /

Driver do MongoDB C++

Bem-vindo ao site de documentação oficial do driver C++ do MongoDB.

Aprenda a instalar o driver, estabelecer uma conexão com o MongoDB e começar a trabalhar com dados no tutorial Introdução ao driver C++ .

Aprenda a criar e configurar uma conexão com uma implantação do MongoDB na seção Conectar ao MongoDB.

Saiba como você pode recuperar dados do MongoDB na seção Ler dados do MongoDB .

Saiba como você pode gravar dados no MongoDB na seção Gravar dados no MongoDB .

Saiba como usar o driver C++ para trabalhar com bancos de dados e coleções do MongoDB na seção Bancos de dados e coleções.

Saiba como trabalhar com tipos comuns de índices na seção Otimizar consultas com índices .

Aprenda a usar o driver C++ para realizar operações de agregação na seção Transformar seus dados com agregação.

Saiba mais sobre maneiras de autenticar seu aplicativo e criptografar seus dados na seção Proteger seus dados .

Saiba como trabalhar com formatos de dados especializados e tipos personalizados na seção Formatos de dados especializados .

Saiba mais sobre opções avançadas de configuração e instalação na seção Opções avançadas de configuração e instalação .

Para ver uma lista de novos recursos e alterações em cada versão, consulte a seção Novidades.

Saiba quais alterações você pode precisar fazer no seu aplicativo para atualizar as versões de drivers na seção Atualizar versões de drivers .

Saiba como relatar bugs, contribuir para o driver e encontrar ajuda na seção Problemas e ajuda .

Para tabelas de compatibilidade que mostram a versão recomendada do driver C++ para uso em versões específicas do C++ e do MongoDB Server, consulte a seção Compatibilidade.

Para obter informações detalhadas sobre tipos e métodos no driver C++, consulte a documentação da API do driver C++.

Importante

Recomendamos utilizar a biblioteca padrão C++ sempre que possível configurando a opção de configuração do CMAKE_CXX_STANDARD para 17 ou mais recente.

O Driver C ++ do MongoDB usa C++17 recursos std::optional<T> e std::string_view. Se você configurar o driver com um padrão pré-C++17, a biblioteca bsoncxx fornecerá implementações de polyfill para esses recursos C++17. O driver usa as implementações de polyfill bsoncxx quando a opção de configuração CMAKE_CXX_STANDARD é definida como um número menor que 17. Por padrão, esta opção está configurada para 11.

Aviso

A escolha da biblioteca polyfill tem um impacto direto na API pública e na ABI da biblioteca mongocxx. Alterar o polyfill pode levar a alterações significativas durante a compilação e alterações binárias durante a vinculação ou a execução. Para limitar a confiança no comportamento específico de polyfill, evite usar stdx::string_view e stdx::optional<T> com interfaces de biblioteca não bsoncxx e não mongocxx.

A estabilidade indica se este driver é recomendado para uso de produção. Atualmente, nenhum driver garante a estabilidade da API ou da ABI.

Para obter a documentação sobre versões anteriores, consulte a documentação antiga.

família/versão
Estabilidade
Desenvolvimento
Propósito

(ramificação mestre do repositório)

Instável

Desenvolvimento ativo

Desenvolvimento de novos recursos

mongocxx 4.0.x

estável

Somente correções de bugs

Versão atual do driver C++ estável

mongocxx 3.11.x

estável

Correções de bugs até novembro de 20}2025

Versão anterior do driver C++ estável

mongocxx 3.10.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.9.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.8.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.7.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.6.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.5.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.4.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.3.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.2.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.1.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.0.x

estável

none

Versão anterior do driver C++ estável |

O mongocxx é uma reescrita completa de um driver C++ para MongoDB baseado em libmongoc. Ele requer um compilador C++11 . Ele é conhecido por basear-se nas arquiteturas x86 e x86-64 para Linux, macOS, Windows e Openbsd.

A biblioteca do driver mongocxx inclui um pacote bson correspondente, bsoncxx, que implementa a especificação BSON. Essa biblioteca pode ser usada de modo autônomo para serialização e desserialização de objetos, mesmo quando não se está usando o MongoDB.

As versões do driver mongocxx têm números de versão como v3.xy

Observação

Não havia drivers v2.xy C++ para evitar confusão com os drivers legados obsoletos-0.0-26compatíveis-2.xy.

Os drivers do MongoDB C++ estão disponíveis sob os termos da Licença Apache, versão 2.0.

Próximo

Começar