.. highlightlang:: us

.. index:: sqlite3_open

.. _sqlite3_open:

sqlite3_open
============

.. us.tag  sqlite3_open NOTREADYENGLISH sqlite3 New550

:ref:`sqlite3_open` opens an SQLite database. If the database does not exist it
will be created.

.. function::  db = sqlite3_open(ssFileName)

.. us.return

**Return Value**

*db* is a database handle. This handle can be used to access the database. If the
database cannot be opened or cannot be created, an exception is created.

.. us.params

**Parameters**

.. uparam:: ssFileName

   *ssFileName* is the complete database file name e.g. ``"c:/database/test.db"``.
   If an empty string is given ``""`` a temporary  database is created, which
   will be deleted by a :ref:`sqlite3_close` call. If the string ``":memory:"``
   is given the database will be created in memory.

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.5.0
     - New.

.. seealso::
   :ref:`overview-sqlite`,
   :ref:`sqlite3_execute`,
   :ref:`sqlite3_close`,
   :ref:`GetExceptionInfo`

:sub:`id-1256205`