NAME bson_oid_get_time_t() – Fetches the generation time in seconds since the UNIX Epoch of oid. SYNOPSIS time_t bson_oid_get_time_t(const bson_oid_t *oid); PARAMETERS oid A bson_oid_t \&. DESCRIPTION Fetches the generation time in seconds since the UNIX Epoch of oid \&. RETURNS A time_t containing the seconds since the UNIX epoch of oid \&. COLOPHON This page…
NAME bson_oid_equal() – Checks if two bson_oid_t contain the same bytes. SYNOPSIS bool bson_oid_equal(const bson_oid_t *oid1, const bson_oid_t *oid2); PARAMETERS oid1 A bson_oid_t \&. oid2 A bson_oid_t \&. DESCRIPTION Checks if two bson_oid_t contain the same bytes. RETURNS true if they are equal, otherwise false. COLOPHON This page is part of libbson. Please report any…
NAME bson_oid_copy() – Copies the contents of src into dst. SYNOPSIS void bson_oid_copy(const bson_oid_t *src, bson_oid_t *dst); PARAMETERS src A bson_oid_t \&. dst A bson_oid_t \&. DESCRIPTION Copies the contents of src into dst. COLOPHON This page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER. Index
NAME bson_oid_compare() – The bson_oid_compare() function shall return a qsort() style value of a lexicographical sort of _oid1_ and _oid2_. SYNOPSIS int bson_oid_compare(const bson_oid_t *oid1, const bson_oid_t *oid2); PARAMETERS oid1 A bson_oid_t \&. oid2 A bson_oid_t \&. DESCRIPTION The bson_oid_compare(3) function shall return a qsort() style value of a lexicographical sort of _oid1_ and _oid2_….
NAME bson_new_from_json() – The bson_new_from_json() function allocates and initialize a new bson_t by parsing the JSON found in data. Only a single JSON object may exist in data or an error will be set and NULL returned. SYNOPSIS bson_t * bson_new_from_json (const uint8_t *data, ssize_t len, bson_error_t *error); PARAMETERS data A UTF-8 encoded string containing…
NAME bson_new_from_data() – The bson_new_from_data() function shall create a new bson_t on the heap and copy the contents of data. This may be helpful when working with language bindings but is generally expected to be slower. SYNOPSIS bson_t * bson_new_from_data (const uint8_t *data, size_t length); PARAMETERS data A BSON encoded document buffer. length The length…
NAME bson_new_from_buffer() – TODO: SYNOPSIS bson_t * bson_new_from_buffer (uint8_t **buf, size_t *buf_len, bson_realloc_func realloc_func, void *realloc_func_ctx); PARAMETERS buf A uint8_t. buf_len A size_t. realloc_func A bson_realloc_func. realloc_func_ctx A (null). DESCRIPTION TODO: RETURNS TODO: COLOPHON This page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER. Index
NAME bson_new() – The bson_new() function shall create a new bson_t structure on the heap. It should be freed with bson_destroy() when it is no longer in use. SYNOPSIS bson_t * bson_new(void); DESCRIPTION The bson_new(3) function shall create a new bson_t structure on the heap. It should be freed with bson_destroy(3) when it is no…
NAME bson_mem_set_table() – This function shall install a new memory allocator to be used by Libbson. SYNOPSIS typedef struct _bson_mem_vtable_t { void *(*malloc)(size_t num_bytes); void *(*calloc)(size_t n_members, size_t num_bytes); void *(*realloc)(void *mem, size_t num_bytes); void (*free)(void *mem); void *padding[4]; } bson_mem_vtable_t; void bson_mem_set_vtable(const bson_mem_vtable_t *vtable); PARAMETERS vtable A bson_mem_vtable_t with every non-padding field set. DESCRIPTION…
NAME bson_mem_restore_vtable() – This function shall restore the default memory allocator to be used by Libbson. SYNOPSIS void bson_mem_restore_vtable(void); DESCRIPTION This function shall restore the default memory allocator to be used by Libbson. NOTE This function MUST be called at the end of the process. Failure to do so will result in memory being freed…
NAME bson_md5_t – BSON MD5 Abstraction SYNOPSIS typedef struct { uint32_t count[2]; /* message length in bits, lsw first */ uint32_t abcd[4]; /* digest buffer */ uint8_t buf[64]; /* accumulate block */ } bson_md5_t; DESCRIPTION bson_md5_t encapsulates an implementation of the MD5 algorithm. This is used in OID generation for the MD5(hostname) bytes. It is…
NAME bson_md5_init() – Initialize a new instance of the MD5 algorithm. SYNOPSIS void bson_md5_init(bson_md5_t *pms); PARAMETERS pms A bson_md5_t \&. DESCRIPTION Initialize a new instance of the MD5 algorithm. COLOPHON This page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER. Index
NAME bson_md5_finish() – Completes the MD5 algorithm and stores the digest in digest. SYNOPSIS void bson_md5_finish(bson_md5_t *pms, uint8_t digest[16]); PARAMETERS pms A bson_md5_t \&. digest A location for the digest. DESCRIPTION Completes the MD5 algorithm and stores the digest in digest \&. COLOPHON This page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER….
NAME bson_md5_append() – Feeds more data into the MD5 algorithm. SYNOPSIS void bson_md5_append(bson_md5_t *pms, const uint8_t *data, uint32_t nbytes); PARAMETERS pms A bson_md5_t \&. data A memory region to feed to the md5 algorithm. nbytes The length of data in bytes. DESCRIPTION Feeds more data into the MD5 algorithm. COLOPHON This page is part of…
NAME bson_malloc0() – This is a portable malloc() wrapper that also sets the memory to zero. Similar to calloc(). SYNOPSIS void * bson_malloc0(size_t num_bytes); PARAMETERS num_bytes A size_t. DESCRIPTION This is a portable malloc(3) wrapper that also sets the memory to zero. Similar to calloc(3) \&. In general, this function will return an allocation at…
NAME bson_malloc() – This is a portable malloc() wrapper. SYNOPSIS void * bson_malloc(size_t num_bytes); PARAMETERS num_bytes A size_t containing the number of bytes to allocate. DESCRIPTION This is a portable malloc(3) wrapper. In general, this function will return an allocation at least sizeof(void*) bytes or bigger. If there was a failure to allocate num_bytes bytes,…
NAME bson_json_reader_t – Bulk JSON to BSON conversion SYNOPSIS #include <bson.h> typedef struct _bson_json_reader_t bson_json_reader_t; typedef enum { BSON_JSON_ERROR_READ_CORRUPT_JS = 1, BSON_JSON_ERROR_READ_INVALID_PARAM, BSON_JSON_ERROR_READ_CB_FAILURE, } bson_json_error_code_t; DESCRIPTION The bson_json_reader_t structure is used for reading a sequence of JSON documents and transforming them to bson_t documents. This can often be useful if you want to perform bulk…
NAME bson_json_reader_read() – Reads the next BSON document from the underlying JSON source. SYNOPSIS int bson_json_reader_read (bson_json_reader_t *reader, bson_t *bson, bson_error_t *error); PARAMETERS reader A bson_json_reader_t \&. bson A bson_t \&. error A bson_error_t \&. DESCRIPTION Reads the next BSON document from the underlying JSON source. ERRORS Errors are propagated via the error parameter. RETURNS…
NAME bson_json_reader_new_from_file() – Creates a new bson_json_reader_t using the underlying file found at filename. SYNOPSIS bson_json_reader_t * bson_json_reader_new_from_file(const char *filename, bson_error_t *error); PARAMETERS filename A file-name in the system file-name encoding. error A bson_error_t \&. DESCRIPTION Creates a new bson_json_reader_t using the underlying file found at filename \&. ERRORS Errors are propagated via error \&….
NAME bson_json_reader_new_from_fd() – Creates a new JSON to BSON converter that will be reading from the file-descriptor fd. SYNOPSIS bson_json_reader_t * bson_json_reader_new_from_fd (int fd, bool close_on_destroy); PARAMETERS fd An open file-descriptor. close_on_destroy Whether close(3) should be called on fd when the reader is destroyed. DESCRIPTION Creates a new JSON to BSON converter that will be…