---
name: "bson_value_copy"
section: "3"
platform: "linux"
package: "libbson-doc"
version: "1.30.4-1+deb13u3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/bson_value_copy"
---

# 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.

**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.