bson_append_utf8 man page

bson_append_utf8() — The bson_append_utf8() function shall append a UTF-8 encoded string to bson.

Synopsis

bool
bson_append_utf8 (bson_t     *bson,
                  const char *key,
                  int         key_length,
                  const char *value,
                  int         length);

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(3)
value
A UTF‐8 encoded string.
length
The number of bytes in value excluding the trailing , or ‐1 to determine the length with strlen(3)

Description

The bson_append_utf8(3) function shall append a UTF‐8 encoded string to bson

_value_ MUST be valid UTF‐8.

Some UTF‐8 implementations allow for to be contained within the string (excluding the termination

It is suggested to use modified UTF‐8 which uses a 2 byte representation for embedded within the string. This will allow these UTF‐8 encoded strings to used with many libc functions.

Returns

true if the operation was applied successfully, otherwise false and bson should be discarded.

Colophon

This page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.

Info

2016‐10‐28 libbson