.. highlightlang:: us

.. index:: sqlite3_open

.. _sqlite3_open:

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

.. us.tag  sqlite3_open NOTREADYGERMAN sqlite3 New550

:ref:`sqlite3_open` öffnet eine sqlite-Datenbank. Falls die Datenbank nicht
existiert, wird sie erzeugt.

.. function::  db = sqlite3_open(ssFileName)

.. us.return

**Returnwert**

*db* ist die Zugriffsnummer der Datenbank. Falls die Datei nicht erzeugt oder 
geöffnet werden kann, wird ein Exception erzeugt.

.. us.params

**Parameter**

.. uparam:: ssFileName

   *ssFileName* ist der vollständige Name der Datenbank inklusive Pfad, z. B.
   ``"c:/database/test.db"``. Wird eine leere Zeichenkette ``""`` angegeben, wird
   eine temporäre Datenbank erzeugt, die bei :ref:`sqlite3_close` wieder gelöscht wird. 
   Wird der String ``":memory:"`` angegeben, wird die Datenbank im Speicher
   gehalten.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.5.0
     - Neu.

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

:sub:`id-1256205`