:man_page: bson_oid_init_sequence

bson_oid_init_sequence()
========================

.. warning::
   .. deprecated:: 1.14.0

      This function is deprecated and should not be used in new code.

      Please use :symbol:`bson_oid_init()` in new code.

Synopsis
--------

.. code-block:: c

  void
  bson_oid_init_sequence (bson_oid_t *oid, bson_context_t *context)
    BSON_GNUC_DEPRECATED_FOR (bson_oid_init);

Parameters
----------

* ``oid``: A :symbol:`bson_oid_t`.
* ``context``: An optional :symbol:`bson_context_t`.

Description
-----------

Generates a new ObjectID with the next 64-bit sequence number in ``context``. The first 4 bytes contain the current time and the following 8 contain the sequence number in big-endian format.

The :symbol:`bson_oid_t` generated by this function is not guaranteed to be globally unique. Only unique within this context. It is however, guaranteed to be sequential.
