Scroll to navigation

BSON_VALUE_COPY(3) libbson BSON_VALUE_COPY(3)

SYNOPSIS

void
bson_value_copy (const bson_value_t *src, bson_value_t *dst);


PARAMETERS

  • src: A bson_value_t <> to copy from.
  • dst: A bson_value_t <> to copy into.

DESCRIPTION

This function will copy the boxed content in src into dst. dst must be freed with bson_value_destroy() <> when no longer in use. dst MUST be an uninitialized bson_value_t <> to avoid leaking memory.

Note:

If src represents a BSON UTF-8 string, bson_value_copy() <> attempts to NULL terminate the copied string in dst. If src.value.v_utf8.len is SIZE_MAX, the copied string is (necessarily) not NULL terminated.


Author

MongoDB, Inc

Copyright

2009-present, MongoDB, Inc.

November 26, 2025 2.2.0