.. highlightlang:: us

.. _sqlite3_execute:

sqlite3_execute
===============

.. index:: sqlite3_execute

.. us.tag  sqlite3_execute NOTREADYGERMAN New550 sqlite3

:ref:`sqlite3_execute` führt eine SQL-Anweisung aus.

.. function::  result = sqlite3_execute(db, ssSQL)

.. us.return

**Returnwert**

*result* ist ein leerer String oder eine String-Matrix. Bei einem Fehler, wird
eine Exception erzeugt.

.. us.params

**Parameter**

.. uparam:: db

   *db* ist die mit :ref:`sqlite3_open` erzeugte Datenbank-Zugriffsnummer.

.. uparam:: ssSQL

   *ssSQL* ist ein SQL-String (siehe Beispiel). Die Syntax des SQL-Strings wird
   unter :ref:`sqlite-(sql)` beschrieben.

.. us.example

**Beispiel**

Die folgende Funktion erzeugt eine SQLite-Datenbank mit einer Tabelle.

::

   db = sqlite3_open("c:/addresses.db");
   sqlite3_execute(db, "create table Addresses(FirstName varchar(100), LastName varchar(100), EMail varchar(100));");
   sqlite3_execute(db, "insert into Addresses values('Peter', 'Mueller', 'peter.mueller@axz.de');");
   sqlite3_close(db);

Einträge lesen:

::

   db = sqlite3_open("c:/addresses.db");
   smAddresses = sqlite3_execute(db, "select * from Addresses;");
   sqlite3_close(db);
   print smAddresses + "|";

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.5.0
     - Neu.

.. seealso::
   :ref:`uberblick-sqlite`,
   :ref:`sqlite3_open`,
   :ref:`GetExceptionInfo`

:sub:`id-507022`