archived-doc-de/reference/sqlite/functions/sqlite-query.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.8 $ -->
<!-- EN-Revision: 1.16 Maintainer: lapistano Status: ready -->
<refentry xml:id="function.sqlite-query" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>sqlite_query</refname>
  <refname>SQLiteDatabase->query</refname>
  <refpurpose>Führt auf einer Datenbank eine Abfrage durch und liefert das Abfrageergebnis zurück</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>sqlite_query</methodname>
   <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam>
   <methodparam><type>string</type><parameter>query</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
   <methodparam choice="opt"><type>string</type><parameter role="reference">error_msg</parameter></methodparam>
  </methodsynopsis>
  <methodsynopsis>
   <type>resource</type><methodname>sqlite_query</methodname>
   <methodparam><type>string</type><parameter>query</parameter></methodparam>
   <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
   <methodparam choice="opt"><type>string</type><parameter role="reference">error_msg</parameter></methodparam>
  </methodsynopsis>
  <para>Objektorientierter Stil (Methode):</para>
  <classsynopsis>
   <ooclass><classname>SQLiteDatabase</classname></ooclass>
   <methodsynopsis>
    <type>SQLiteResult</type><methodname>query</methodname>
    <methodparam><type>string</type><parameter>query</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter role="reference">error_msg</parameter></methodparam>
   </methodsynopsis>
  </classsynopsis>
  <para>
   Führt eine, durch den Parameter <parameter>query</parameter> übergebene, 
   SQL-Anfrage auf der übergebenen Datenbank-Verbindung aus.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>dbhandle</parameter></term>
     <listitem>
      <para>
       Die SQLite-Datenbankressource, zurückgegeben von 
       <function>sqlite_open</function>, wenn prozedural genutzt.
       In der objektorientierten Notation wird dieser Parameter nicht
       benötigt.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>query</parameter></term>
     <listitem>
      <para>
       Die auszuführende Anfrage.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>result_type</parameter></term>
     <listitem>
      &sqlite.result-type;
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>error_msg</parameter></term>
     <listitem>
      <para>
       Die spezifizierte Variable wird im Falle eines Fehlers gesetzt.
       Diese ist besonders wichtig, denn SQL-Syntaxfehler können nicht mittels
       <function>sqlite_last_error</function> ausgelesen werden.
      </para>
     </listitem>
    </varlistentry>

   </variablelist>
  </para>
  &sqlite.param-compat;
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Diese Funktion gibt entweder ein Ergebnis-Handle oder im Fehlerfalle &false;
   zurück.
   Für Anfragen, die Reihen liefern, kann das Abfrageergebnis mit Funktionen, wie
   <function>sqlite_seek</function> oder <function>sqlite_fetch_array</function>
   augelesen werden.
  </para>
  <para>
   Ungeachtet des Anfrage-Typs, gibt diese Funktion &false; zurück, wenn
   die Anfrage fehlschlägt.
  </para>
  <para>
   <function>sqlite_query</function> gib ein gepuffertes Ergebnis, dessen Zeilen 
   einzeln Ansprechbar sind. Dies ist für kleine Abfragen nützlich, bei 
   denen man abwechselnd unterschiedliche Zeilen abfragen will. 
   Die gepufferten Ergebnisse belegen Speicher, um das gesamte Ergebnis
   halten zu können. Dieser Speicher wird erst dann wieder freigegeben, 
   wenn das komplette Ergebnis durchlaufen wurde. Wenn nur ein sequentieller 
   Zugriff auf die Daten nötig ist, wird empfohlen, die performantere 
   Funktion <function>sqlite_unbuffered_query</function> zu nutzen. 
  </para>
 </refsect1>

<refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>5.1.0</entry>
       <entry>
        <parameter>error_msg</parameter> wurde hinzugefügt
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <warning>
   <simpara>
    SQLite führt Mehrfach-Anfragen, die durch Semikolon getrennt wurden, aus,
    so dass Sie Anfragen ausführen können, die aus einer Datei oder 
    über ein Skript geladen wurden. Wie auch immer, das funktioniert nur, wenn 
    das Ergebins der Anfrage nicht benutzt wird. Sollte es doch genutzt werden, wird 
    nur die erste SQL-Anfrage der Liste ausgeführt. Die Funktion
    <function>sqlite_exec</function> wird immer Mehrfach-Anfragen ausführen.
   </simpara>
   <simpara>
    Wenn Mehrfach-Anfrage ausgeführt werden, wird die Funktion im Fehlerfall 
    &false; zurückgeben, anderenfalls jedoch ein undefiniertes Ergebnis 
    (das kann, sollte die Anfrage gelingen, &true; oder ein Ergebnis-Handle sein).
   </simpara>
  </warning>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>sqlite_unbuffered_query</function></member>
    <member><function>sqlite_array_query</function></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
 sgml-omittag:t
 sgml-shorttag:t
 sgml-minimize-attributes:nil
 sgml-always-quote-attributes:t
 sgml-indent-step:1
 sgml-indent-data:t
 sgml-parent-document:nil
 sgml-default-dtd-file:"../../manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil
 End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->