.. highlightlang:: us

.. _sqlite3_busy_timeout:

sqlite3_busy_timeout
====================

.. index:: sqlite3_busy_timeout

.. us.tag  sqlite3_busy_timeout NOTREADYENGLISH New550 sqlite3

:ref:`sqlite3_busy_timeout` sets the time limit to open a locked SQLite database.

.. function::  bool = sqlite3_busy_timeout(db, nMilliSeconds)

.. us.return

**Return Value**

*bool*.

.. us.params

**Parameters**

.. uparam:: db

   *db* is a handle returned by :ref:`sqlite3_open`.

.. uparam:: nMilliSeconds

   *nMilliSeconds* is a time in milliseconds.

.. us.comment

**Comment**

When the SQLite database is accessed for reading it is locked for writing until
the reading access is finished. Another process cannot access the database while
it is locked. The timeout time sets a limit while this process tries to access
the locked database. If the database is unlocked within the timeout time it can
be accessed, otherwise an access fails.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 5.5.0
     - New.

.. seealso::
   :ref:`overview-sqlite`

:sub:`id-1692406`