Scroll to navigation

BSON_APPEND_DBPOINTER(3) Libbson BSON_APPEND_DBPOINTER(3)

NAME

bson_append_dbpointer - bson_append_dbpointer()

SYNOPSIS

#define BSON_APPEND_DBPOINTER(b, key, coll, oid) \
   bson_append_dbpointer (b, key, (int) strlen (key), coll, oid)
bool
bson_append_dbpointer (bson_t *bson,
                       const char *key,
                       int key_length,
                       const char *collection,
                       const bson_oid_t *oid);


PARAMETERS

  • bson: A bson_t.
  • key: An ASCII C string containing the name of the field.
  • key_length: The length of key in bytes, or -1 to determine the length with strlen().
  • collection: The target collection name.
  • oid: The target document identifier.

DESCRIPTION

WARNING:
The dbpointer field type is DEPRECATED and should only be used when interacting with legacy systems.


RETURNS

Returns true if the operation was applied successfully. The function will fail if appending the array grows bson larger than INT32_MAX.

AUTHOR

MongoDB, Inc

COPYRIGHT

2017-present, MongoDB, Inc
August 31, 2019 1.15.1