Scroll to navigation

BSON_CONTEXT_NEW(3) libbson BSON_CONTEXT_NEW(3)

SYNOPSIS

bson_context_t *
bson_context_new (bson_context_flags_t flags);


PARAMETERS

•
flags: A bson_context_flags_t <>.

The following flags may be used: * BSON_CONTEXT_NONE meaning creating ObjectIDs with this context is not a thread-safe operation. * BSON_CONTEXT_DISABLE_PID_CACHE meaning creating ObjectIDs will also check if the process has changed by calling getpid() on every ObjectID generation.

The following flags are deprecated and have no effect:

  • BSON_CONTEXT_DISABLE_HOST_CACHE
  • BSON_CONTEXT_THREAD_SAFE
  • BSON_CONTEXT_USE_TASK_ID

DESCRIPTION

Creates a new bson_context_t <>. This is rarely needed as bson_context_get_default() <> serves most use-cases.

RETURNS

A newly allocated bson_context_t <> that should be freed with bson_context_destroy() <>.

Author

MongoDB, Inc

Copyright

2009-present, MongoDB, Inc.

November 26, 2025 2.2.0