bson_uint32_to_string - bson_uint32_to_string()

NAME  SYNOPSIS  PARAMETERS  DESCRIPTION  ARRAY ELEMENT KEY BUILDING  RETURNS  AUTHOR  COPYRIGHT 

NAME

bson_uint32_to_string − bson_uint32_to_string()

SYNOPSIS

size_t
bson_uint32_to_string (uint32_t value,
                       const char **strptr,
                       char *str,
                       size_t size);

PARAMETERS

value: A uint32_t.

strptr: A location for the resulting string pointer.

str: A location to buffer the string.

size: A size_t containing the size of str.

DESCRIPTION

Converts value to a string.

If value is from 0 to 999, it will use a constant string in the data section of the library.

If not, a string will be formatted using str and snprintf().

strptr will always be set. It will either point to str or a constant string. Use this as your key.

ARRAY ELEMENT KEY BUILDING

Each element in a BSON array has a monotonic string key like "0", "1", etc. This function is optimized for generating such string keys.

char str[16];
const char *key;
uint32_t i;


for (i = 0; i < 10; i++) {
   bson_uint32_to_string (i, &key, str, sizeof str);
   printf ("Key: %s\n", key);
}

RETURNS

The number of bytes in the resulting string.

AUTHOR

MongoDB, Inc

COPYRIGHT

2017-present, MongoDB, Inc


Updated 2024-01-29 - jenkler.se | uex.se