NAME

bson_as_json() - The bson_as_json() function shall encode bson as a JSON encoded UTF-8 string.

SYNOPSIS

char *
bson_as_json (const bson_t *bson,
              size_t       *length);

PARAMETERS

bson
A bson_t \&.

length
An optional location for the length of the resulting string.

DESCRIPTION

The bson_as_json(3) function shall encode bson as a JSON encoded UTF-8 string.

The caller is responsible for freeing the resulting UTF-8 encoded string by calling bson_free(3) with the result.

If non-NULL, length will be set to the length of the result in bytes.

RETURNS

If successful, a newly allocated UTF-8 encoded string and length is set.

Upon failure, NULL is returned.

EXAMPLE

char *str = bson_as_json (doc, NULL);
printf ("%s\n", str);
bson_free (str);

COLOPHON

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