cvs: phpdoc-de /reference/sqlite constants.xml functions.xml ini.xml reference.xml /reference/sqlite/functions sqlite-array-query.xml
sqlite-busy-timeout.xml sqlite-changes.xml sqlite-close.xml sqlite-column.xml sqlite-create-function.xml sqlite-current.xml sqlite-error-string.xml
sqlite-escape-string.xml sqlite-fetch-array.xml sqlite-fetch-string.xml sqlite-field-name.xml sqlite-has-more.xml sqlite-last-error.xml
sqlite-last-insert-rowid.xml sqlite-libencoding.xml sqlite-libversion.xml sqlite-next.xml sqlite-num-fields.xml sqlite-num-rows.xml sqlite-open.xml
sqlite-popen.xml sqlite-query.xml sqlite-register-aggregate.xml sqlite-rewind.xml sqlite-seek.xml sqlite-unbuffered-query.xml

From:	Johann-Peter Hartmann	Date:	Thu, 26 Jun 2003 07:35:32 +0000
Subject:	cvs: phpdoc-de /reference/sqlite constants.xml functions.xml ini.xml reference.xml /reference/sqlite/functions sqlite-array-query.xml sqlite-busy-timeout.xml sqlite-changes.xml sqlite-close.xml sqlite-column.xml sqlite-create-function.xml sqlite-current.xml sqlite-error-string.xml sqlite-escape-string.xml sqlite-fetch-array.xml sqlite-fetch-string.xml sqlite-field-name.xml sqlite-has-more.xml sqlite-last-error.xml sqlite-last-insert-rowid.xml sqlite-libencoding.xml sqlite-libversion.xml sqlite-next.xml sqlite-num-fields.xml sqlite-num-rows.xml sqlite-open.xml sqlite-popen.xml sqlite-query.xml sqlite-register-aggregate.xml sqlite-rewind.xml sqlite-seek.xml sqlite-unbuffered-query.xml
Groups:	php.doc.de
Request:	Send a blank email to doc-de+get-782@lists.php.net to get a copy of this message

hartmann Thu Jun 26 03:35:32 2003 EDT Added files: /phpdoc-de/reference/sqlite constants.xml functions.xml ini.xml reference.xml /phpdoc-de/reference/sqlite/functions sqlite-array-query.xml sqlite-busy-timeout.xml sqlite-changes.xml sqlite-close.xml sqlite-column.xml sqlite-create-function.xml sqlite-current.xml sqlite-error-string.xml sqlite-escape-string.xml sqlite-fetch-array.xml sqlite-fetch-string.xml sqlite-field-name.xml sqlite-has-more.xml sqlite-last-error.xml sqlite-last-insert-rowid.xml sqlite-libencoding.xml sqlite-libversion.xml sqlite-next.xml sqlite-num-fields.xml sqlite-num-rows.xml sqlite-open.xml sqlite-popen.xml sqlite-query.xml sqlite-register-aggregate.xml sqlite-rewind.xml sqlite-seek.xml sqlite-unbuffered-query.xml Log: Initial german documentation for sqlite, should be complete and up to date.

Index: phpdoc-de/reference/sqlite/constants.xml +++ phpdoc-de/reference/sqlite/constants.xml <?xml version='1.0' encoding='iso-8859-1'?>  <section id="sqlite.constants"> <title>Vordefinierte Konstanten</title> <para> Die Funktionen <function>sqlite_fetch_array</function> und <function>sqlite_current</function> nutzen eine Konstante für die unterschiedlichen Varianten von Ergebnis-Arrays. Die folgenden Konstanten sind definiert: </para> <para> <table> <title>SQLite Fetch Konstanten</title> <tgroup cols="2"> <thead> <row> <entry>Konstante</entry> <entry>Bedeutung</entry> </row> </thead> <tbody> <row> <entry>SQLITE_ASSOC</entry> <entry> Die Spalten werden in einem Array zurückgeliefert, bei dem der Spaltenname als Hashindex genutzt wird. </entry> </row> <row> <entry>SQLITE_BOTH</entry> <entry> Die Spalten werden in dem Array sowohl als numerischer wie auch als Spaltenname als Hashindex zurückgeliefert. </entry> </row> <row> <entry>SQLITE_NUM</entry> <entry> Die Spalten werden in dem Array nur mit einem numerischem Index zurückgeliefert. Der Index beginnt mit <literal>0</literal> für das erste Feld des Ergebnisses. </entry> </row> </tbody> </tgroup> </table> </para> </section>  Index: phpdoc-de/reference/sqlite/functions.xml +++ phpdoc-de/reference/sqlite/functions.xml &reference.sqlite.functions.sqlite-array-query; &reference.sqlite.functions.sqlite-busy-timeout; &reference.sqlite.functions.sqlite-changes; &reference.sqlite.functions.sqlite-close; &reference.sqlite.functions.sqlite-column; &reference.sqlite.functions.sqlite-create-function; &reference.sqlite.functions.sqlite-current; &reference.sqlite.functions.sqlite-error-string; &reference.sqlite.functions.sqlite-escape-string; &reference.sqlite.functions.sqlite-fetch-array; &reference.sqlite.functions.sqlite-fetch-string; &reference.sqlite.functions.sqlite-field-name; &reference.sqlite.functions.sqlite-has-more; &reference.sqlite.functions.sqlite-last-error; &reference.sqlite.functions.sqlite-last-insert-rowid; &reference.sqlite.functions.sqlite-libencoding; &reference.sqlite.functions.sqlite-libversion; &reference.sqlite.functions.sqlite-next; &reference.sqlite.functions.sqlite-num-fields; &reference.sqlite.functions.sqlite-num-rows; &reference.sqlite.functions.sqlite-open; &reference.sqlite.functions.sqlite-popen; &reference.sqlite.functions.sqlite-query; &reference.sqlite.functions.sqlite-register-aggregate; &reference.sqlite.functions.sqlite-rewind; &reference.sqlite.functions.sqlite-seek; &reference.sqlite.functions.sqlite-unbuffered-query; Index: phpdoc-de/reference/sqlite/ini.xml +++ phpdoc-de/reference/sqlite/ini.xml <?xml version="1.0" encoding="iso-8859-1"?>  <section id="sqlite.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>SQLite Konfiguration</title> <tgroup cols="3"> <thead> <row> <entry>Name</entry> <entry>Voreinstellung</entry> <entry>Einstellbar</entry> </row> </thead> <tbody> <row> <entry>sqlite.assoc_case</entry> <entry>0</entry> <entry>PHP_INI_SYSTEM</entry> </row> </tbody> </tgroup> </table> Für weitere Details und die Definition der PHP_INI_*-Konstanten siehe <function>ini_set</function>. </para> <para> Hier ist eine kurze Erläuterung der Konfigurationseinstellungen. <variablelist> <varlistentry id="ini.sqlite.assoc-case"> <term> <parameter>sqlite.assoc_case</parameter> <type>int</type> </term> <listitem> <para> Ob gemischte Schreibweise (<literal>0</literal>), Grossbuchstaben (<literal>1</literal>) oder Kleinbuchstaben (<literal>2</literal> für die Hash Indizes genutzt werden soll. </para> <para> Diese Option ist vor allen für die Kompatiblität zu anderen Datenbanksystemen notwendig, in denen die Namen der Spalten immer als Gross- oder Kleinbuchstaben zurückgeliefert werden - unabhängig von den eigentlichen Spaltenbezeichnungen im Datenbankschema. </para> <para> Die SQLite Bibliothek liefert die Spaltennamen in ihrer echten Schreibweise zurück (die dem entspricht, was Sie im Datenbankschema nutzen). Wenn <parameter>sqlite.assoc_case</parameter> auf <literal>0</literal> gesetzt ist, bleibt diese Schreibweise erhalten. Wenn es auf <literal>1</literal> oder <literal>2</literal> gesetzt ist, wird der Spaltenname von PHP automatisch zu Gross- bzw. Kleinbuchstaben gewandelt. </para> <para> Das Nutzen dieser Option erzeugt eine leichte Geschwindigkeitseinbuße, ist aber DEUTLICH schneller als die Nutzung von <function>strtolower</function> oder <function>strtoupper</function> im PHP-Script. </para> </listitem> </varlistentry> </variablelist> </para> </section>  Index: phpdoc-de/reference/sqlite/reference.xml +++ phpdoc-de/reference/sqlite/reference.xml <?xml version="1.0" encoding="iso-8859-1"?>  <reference id="ref.sqlite"> <title>SQLite</title> <titleabbrev>SQLite</titleabbrev> <partintro> &warn.experimental; <section id="sqlite.intro"> &reftitle.intro; <para> Dies ist eine Extension für den eingebetteten Datenbankserver SQLite. SQLite ist eine C-Bibliothek, die eine eingebettete Datenbankserver-Software enthält. Programme, die mit der SQLite Bibliothek verlinkt sind, können SQL-Datenbanken ohne einen separaten RDBMS-Prozess, also ohnen einen separaten Datenbankserver nutzen. </para> <para> SQLite ist keine Client-Bibliothek, die zur Verbindung mit einem grossen Datenbankserver genutzt wird. SQLite ist der Server. Die SQLite-Bibliothek liesst und schreibt direkt von und auf die Datenbankdateien auf der Festplatte. </para> <note> <para> Weitere Informationen finden Sie auf der SQLite Website. (<ulink url="&url.sqlite;">&url.sqlite;</ulink>). </para> </note> </section> <section id="sqlite.install"> <title>Installation</title> <para> Lesen Sie die Datei INSTALL, die im SQLite-Verzeichnis enthalten ist. SQLite selbst ist automatisch enthalten, es ist nicht notwendig, weitere Software zu installieren. </para> <para> Windows-Nutzer können die DLL-Version der SQLite-Extension hier downloaden: (<ulink url="&url.pecl.get.win;php_sqlite.dll">php_sqlite.dll</ulink>). </para> </section> <section id="sqlite.contact"> <title>Kontaktinformationen</title> <para> Mögliche Fragen über die Extension sollten auf den <ulink url="&url.php.support;">PHP Mailinglisten</ulink> gestellt werden. </para> </section> <section id="sqlite.requirements"> &reftitle.required; <para> Um die SQLite-Funktionen nutzen zu können, muss PHP mit SQLite-Support kompiliert werden, oder die SQLite-Extension dynamisch in der php.ini geladen werden. </para> </section> <section id="sqlite.resources"> &reftitle.resources; <para> Die SQLite-Extension nutz zwei verschiedene Resource-Typen. Der erste die die Datenbankverbindung, der zweite das Abfrageergebnis. </para> </section> &reference.sqlite.constants; &reference.sqlite.ini; </partintro> &reference.sqlite.functions; </reference>  Index: phpdoc-de/reference/sqlite/functions/sqlite-array-query.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-array-query.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-array-query"> <refnamediv> <refname>sqlite_array_query</refname> <refpurpose>Führt eine Datenbankabfrage durch und liefert das komplette Abfrageergebnis als Array zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>array</type><methodname>sqlite_array_query</methodname> <methodparam><type>resource</type><parameter>db</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>bool</type><parameter>decode_binary</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_array_query</function> ist vergleichbar mit der Nutzung von <function>sqlite_query</function> und dann <function>sqlite_fetch_array</function> für jede Zeile des Abfrageergebnisses und dem Speichern desselben in ein Array, wie im Beispiel unten beschrieben. Die Nutzung von <function>sqlite_array_query</function> ist deutlich schneller als solch ein Script. </para> <example> <title><function>sqlite_array_query</function> selbst gebaut</title> <programlisting role="php"> <![CDATA[<?php $q = sqlite_query($database, "SELECT * from foo LIMIT 100"); $rows = array(); while ($r = sqlite_fetch_array($q)) { $rows[] = $r; } ?>]]> </programlisting> </example> <tip> <para> <function>sqlite_array_query</function> ist am besten für Queries geeignet, die 45 und weniger Ergebniszeilen zurückliefern. Wenn Sie mehr Daten haben, sollten Sie Ihre Scripte eher mit <function>sqlite_unbuffered_query</function> schreiben, um eine optimale Geschwindigkeit zu erzielen. </para> </tip> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-busy-timeout.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-busy-timeout.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-busy-timeout"> <refnamediv><refname>sqlite_busy_timeout</refname> <refpurpose>Setzt die maximale Dauer für das Warten auf die Freigabe einer Datenbank, oder sperrt das Warten selbst.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>void</type><methodname>sqlite_busy_timeout</methodname> <methodparam><type>resource</type><parameter>Datenbank</parameter></methodparam> <methodparam><type>int</type><parameter>Millisekunden</parameter></methodparam> </methodsynopsis> <para> Setzt die maximale Zeit, in der auf die Freigabe der <parameter>Datenbank</parameter> gewartet wird, auf <parameter>Millisekunden</parameter> Wenn <parameter>Millisekunden</parameter> ist <literal>0</literal>, wird das Warten deaktiviert und unmittelbar der Statuscode <literal>SQLITE_BUSY</literal> zurückgeliefert, wenn ein anderer Prozess/Thread die <parameter>Datenbank</parameter> für eine Änderung gesperrt hat. </para> <para> PHP setzt die Voreinstellung auf 60 Sekunden, wenn die Datenbank geöffnet wird. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-changes.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-changes.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-changes"> <refnamediv> <refname>sqlite_changes</refname> <refpurpose>Gibt die Anzahl Zeilen zurück, die vom letzten SQL-Befehl geändert wurden. </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>sqlite_changes</methodname> <methodparam><type>resource</type><parameter>db</parameter></methodparam> </methodsynopsis> <para> Liefert die Anzahl Zeilen zurück, die durch das letzten SQL-Befehl geändert wurden, der an die Datenbank <parameter>db</parameter> geschickt wurde. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-close.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-close.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-close"> <refnamediv> <refname>sqlite_close</refname> <refpurpose>Schliesst eine offene SQLite Datenbank.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>void</type><methodname>sqlite_close</methodname> <methodparam><type>resource</type><parameter>Datenbank</parameter></methodparam> </methodsynopsis> <para> Schliesst die Verbindung zur angegebenen <parameter>Datenbank</parameter>. Wenn die Datenbankverbindung mit <function>sqlite_popen</function> persisten geöffnet wurde, wird sie geschlossen und von der Liste der persistenten Verbindungen entfernt. </para> <para> Siehe dazu auch <function>sqlite_open</function> und <function>sqlite_popen</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-column.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-column.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-column"> <refnamediv> <refname>sqlite_column</refname> <refpurpose>Holt eine Spalte aus der aktuellen Zeile des Abfrageergebnisses.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>mixed</type><methodname>sqlite_column</methodname> <methodparam><type>resource</type><parameter>Ergebnis</parameter></methodparam> <methodparam><type>mixed</type><parameter>Index_oder_Name</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>decode_binary</parameter></methodparam> </methodsynopsis> <para> Holt den Wert der benannten Spalte <parameter>Index_oder_Name</parameter> (wenn es ein String ist), oder Spalte Nummer <parameter>Index_oder_Name</parameter> (wenn es sich um eine Zahl handelt) aus der aktuellen Zeile des Abfrageergebnisses <parameter>Ergebnis</parameter>. Die Einstellung <parameter>decode_binary</parameter> arbeitet so wie in <function>sqlite_fetch_array</function> beschrieben. </para> <para> Benutzen Sie diese Funktion, wenn Sie über ein grosses Abfrageergebnis mit vielen Zeilen, oder auch mit Zeilen, die viele Daten enthalten, iterieren. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-create-function.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-create-function.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-create-function"> <refnamediv> <refname>sqlite_create_function</refname> <refpurpose>Erzeugt eine "reguläre" nutzerdefinierte Funktion für den Gebrauch in SQL-Befehlen.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>sqlite_create_function</methodname> <methodparam><type>resource</type><parameter>db</parameter></methodparam> <methodparam><type>string</type><parameter>SQL-Funktionsname</parameter></methodparam> <methodparam><type>mixed</type><parameter>callback</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>num_args</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_create_function</function> erlaubt Ihnen, eine PHP-Funktion in SQLite als <acronym>UDF</acronym> (User Defined Function = Nutzerdefinierte Funktion> zu erzeugen, so dass diese direkt in SQL-Befehlen genutzt werden kann. </para> <para> <parameter>db</parameter> spezifiziert die Datenbank, die um die Funktion erweitert werden soll, <parameter>SQL-Funktionsname</parameter> den Namen der Funktion, wie er in den SQL-Befehlen genutzt werden soll. <parameter>callback</parameter> ist eine beliebige gültige PHP-Funktion oder Methode, die aufgerufen werden soll, um die SQL-Funktion abzuarbeiten. Der optionale Parameter <parameter>num_args</parameter> wird vom SQLite-Parser als Hinweis auf die Parameterzahl genutzt. Es wird empfohlen, diesen Wert zu definieren, wenn Ihre Funktion immer mit der gleichen Parameterzahl arbeitet. </para> <para> Die UDF kann in jedem SQL-Befehl, der Funktionsaufrufe beinhalten kann, genutzt werden, wie z.B. SELECT, UPDATE oder auch Trigger. </para> <para> <example> <title><function>sqlite_create_function</function> Beispiel</title> <programlisting role="php"> <![CDATA[ <?php function md5_rueckwaerts($string) { return strrev(md5($string)); } sqlite_create_function($db, 'md5rw', 'md5_rueckwaerts', 1); $rows = sqlite_array_query($db, 'SELECT md5rw(filename) from files'); ?>]]> </programlisting> </example> </para> <para> In diesem Beispiel haben wir eine Funktion, die die md5-Summe eines Strings berechnet und dann rueckwaerts ausliefert. Wenn der SQL-Befehl durchgeführt wird, liefert er den Wert der Spalte filename durch unsere Funktion transformiert zurück. Die Daten, die in <parameter>$rows</parameter> stehen, enhalten also die bereits gewandelten Daten. </para> <para> Die Eleganz dieser Technik ist das Vermeiden des Durchfahrens des kompletten Abfrageergebnisses mit einer foreach()-Schleife. </para> <para> PHP registriert ausserdem automatisch eine spezielle Funktion mit dem Namen <literal>php</literal> wenn die Datenbank <parameter>db</parameter> zum ersten Mal geöffnet wird. Diese Funktion kann genutzt werden, um eine beliebige PHP-Funktion aufzurufen, ohne dass sie zunächst für SQLite erzeugt werden muss. </para> <para> <example> <title>Beispiel der Nutzung einer PHP-Funktion</title> <programlisting role="php"> <![CDATA[ <?php $rows = sqlite_array_query($db, "SELECT php('md5', filename) from files"); ?>]]> </programlisting> <para> In diesem Beispiel wird die Funktion <function>md5</function> für jeden Eintrag der Spalte <literal>filename</literal> in der Datenbank aufgerufen und das Ergebnis in <parameter>$rows</parameter> geschrieben. </para> </example> </para> <note> <para> Aus Performancegründen kodiert/dekodiert PHP nicht automatisch die Binärdaten der Spalten, die in die UDF/aus der UDF geliefert werden. Daher müssen Sie die Parameter und Rückgabewerte der Funktion jeweils selbst wandeln. </para> </note> <tip> <para> Es wird empfohlen, die UDFs nicht für Binärdaten zu nutzen, wenn Ihre Anwendung eine hohe Geschwindigkeit aufweisen soll. </para> </tip> <para> Siehe auch <function>sqlite_register_aggregate</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-current.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-current.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-current"> <refnamediv> <refname>sqlite_current</refname> <refpurpose>Holt die aktuelle Zeile als Array aus dem Abfrageergebnis.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>array</type><methodname>sqlite_current</methodname> <methodparam><type>resource</type><parameter>Ergebnis</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>Ergebnis_Typ</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>decode_binary</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_current</function> entspricht <function>sqlite_fetch_array</function> mit der Ausnahme, dass sie nicht zunächst automatisch auf die nächste Zeile wechselt; es werden also die Daten der aktuellen Position zurückgeliefert. </para> <para> Wenn die aktuelle Position hinter der letzten Zeile liegt, liefert die Funktion &false; zurück. &false; </para> <note> <para> Diese Funktion arbeitet nicht auf ungebufferten Abfrageergebnissen, wie sie von <function>sqlite_unbuffered_query</function> zurückgegeben werden. </para> </note> <para> Siehe auch <function>sqlite_seek</function> und <function>sqlite_next</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-error-string.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-error-string.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-error-string"> <refnamediv> <refname>sqlite_error_string</refname> <refpurpose>Liefert eine lesbare Beschreibung zu einem Fehlercode.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>sqlite_error_string</methodname> <methodparam><type>int</type><parameter>error_code</parameter></methodparam> </methodsynopsis> <para> Liefert eine menschenlesbare Beschreibung für den <parameter>error_code</parameter> zurück, der von <function>sqlite_last_error</function> stammt. </para> <para> Siehe dazu auch <function>sqlite_last_error</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-escape-string.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-escape-string.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-escape-string"> <refnamediv> <refname>sqlite_escape_string</refname> <refpurpose>Bereit einen String für die Verwendund als SQL-Parameter auf.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>sqlite_escape_string</methodname> <methodparam><type>string</type><parameter>item</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_escape_string</function> bereitet den String <parameter>item</parameter> so auf, dass er korrekt innerhalb eines SQL-Befehls als Parameter genutzt werden kann. Diese Wandlung enhält die Verdopplung von einfachen Anführungszeichen (<literal>'</literal>) und die Überprüfung von nicht binärkompatiblen Zeichen. </para> <para> Wenn <parameter>item</parameter> das Char-Zeichen <literal>NUL</literal> enthält, oder wenn es mit dem Char-Zeichen <literal>0x01</literal> beginnt, wandelt PHP <parameter>item</parameter> in ein binär kodiertes Format, so dass es sicher in die Datenbank geschrieben und aus der Datenbank abgefragt werden kann. </para> <para> Auch wenn die Aufbereitung ein sicheres Einfügen der Daten ermöglicht, werden einfache Stringvergleiche und <literal>LIKE</literal>-Bedingungen in Ihren Abfragen unbrauchbar gemacht, wenn die Spalten Binärdaten enthalten. In der Praxis sollte dies kein Problem darstellen, weil Ihr Datenbankschema ohnehin keine Binärdaten enthält (denn eigentlich könnte es besser sein, die Binärdaten auf andere Art und Weise, z.B. in Dateien zu speichern). </para> <warning> <simpara> <function>addslashes</function> sollte <emphasis>NICHT</emphasis> genutzt werden, um Strings für SQLite-Queries aufzubereiten; es kann zu undefinierten Resultaten beim Abfragen der Daten führen. </simpara> </warning> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-fetch-array.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-fetch-array.xml <?xml version="1.0" encoding="iso-8859-1"?> <refentry id="function.sqlite-fetch-array"> <refnamediv> <refname>sqlite_fetch_array</refname> <refpurpose>Holt die nächste Zeile aus einem Datenbankergebnis und gibt sie als Array zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>array</type><methodname>sqlite_fetch_array</methodname> <methodparam><type>resource</type><parameter>Ergebnis</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>Ergebnis_Typ</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>decode_binary</parameter></methodparam> </methodsynopsis> <para> Holt die nächste Zeile aus einem gegebenen <parameter>Ergebnis</parameter>-Handle. Wenn in diesem keine weiteren Zeilen enthalten sind, wird &false; zurückgeliefert, ansonsten ein assoziatives Array, das die Zeilendaten enthält. </para> <para> <parameter>Ergebnis_Typ</parameter> spezifiziert, wie Sie das Ergebnis erhalten möchten. Der Standard-Wert ist <literal>SQLITE_BOTH</literal>. Damit werden die Spalten sowohl mit Ihrer Nummer als auch mit Ihrem Namen als Hashindex genutzt. <literal>SQLITE_ASSOC</literal> erzeugt ein Array, dass nur mit den Spaltennamen indiziert ist, <literal>SQLITE_NUM</literal> eine reine Indizierung mit den Spaltennummern. </para> <para> Die Spaltennamen, die von <literal>SQLITE_ASSOC</literal> und <literal>SQLITE_BOTH</literal> genutzt werden, werden je nach Inhalt der Konfigurationsdirektive <link linkend="ini.sqlite.assoc-case"> sqlite.assoc_case</link> in Gross- oder Kleinbuchstaben gewandelt. </para> <para> Wenn <parameter>decode_binary</parameter> auf &true; gesetzt ist (das ist die Standardeinstellung), dekodiert PHP automatisch die Binärkodierung, in die die Daten gewandelt werden, wenn sie mittels <function>sqlite_escape_string</function> bearbeitet wurden. In den meisten Fällen werden Sie diesen Wert in der Standardeinstellung lassen, solange Sie die Daten nicht auch mit anderen SQLite-Fähigen Applikationen teilen. </para> <para> Siehe auch <function>sqlite_array_query</function> und <function>sqlite_fetch_string</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-fetch-string.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-fetch-string.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-fetch-string"> <refnamediv> <refname>sqlite_fetch_string</refname> <refpurpose>Liefert die erste Spalte eines Abfrageergebnisses als String zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>sqlite_fetch_string</methodname> <methodparam><type>resource</type><parameter>Ergebnis</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>Ergebnis_Typ</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>decode_binary</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_fetch_string</function> entspricht <function>sqlite_fetch_array</function>, nur dass es nur den Wert aus der ersten Spalte aus dem <parameter>Ergebnis</parameter> zurückliefert. </para> <para> Dies ist der optimale Weg, Daten aus einem Ergebnis zu holen, wenn man nur am Inhalt der ersten Spalte interessiert ist. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-field-name.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-field-name.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-field-name"> <refnamediv> <refname>sqlite_field_name</refname> <refpurpose>Gibt den Namen eines bestimmten Feldes zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>sqlite_field_name</methodname> <methodparam><type>resource</type><parameter>Ergebnis</parameter></methodparam> <methodparam><type>int</type><parameter>Feld_Index</parameter></methodparam> </methodsynopsis> <para> Liefert für eine Spaltennummer <parameter>Feld_Index</parameter> den Namen dieses Feldes im <parameter>Ergebnis</parameter> zurück. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-has-more.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-has-more.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-has-more"> <refnamediv> <refname>sqlite_has_more</refname> <refpurpose>Liefert zurück, ob noch mehr Zeilen im Ergebnis vorliegen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>sqlite_has_more</methodname> <methodparam><type>resource</type><parameter>Ergebnis</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_has_more</function> liefert &true; zurück, wenn im aktuellen <parameter>Ergebnis</parameter> noch weitere Zeilen vorliegen, bzw. &false;, wenn das <parameter>Ergebnis</parameter> keine weiteren bzw. gar keine Zeilen enthält. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-last-error.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-last-error.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-last-error"> <refnamediv> <refname>sqlite_last_error</refname> <refpurpose>Gibt den Fehlercode des letzten Fehlers für eine Datenbank zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>sqlite_last_error</methodname> <methodparam><type>resource</type><parameter>db</parameter></methodparam> </methodsynopsis> <para> Lifert den Fehlercode für die letzte Operation, die auf der Datenbank <parameter>db</parameter> durchgeführt wurde, zurück. </para> <para> Siehe auch <function>sqlite_error_string</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-last-insert-rowid.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-last-insert-rowid.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-last-insert-rowid"> <refnamediv> <refname>sqlite_last_insert_rowid</refname> <refpurpose>Gibt die Nummer der zuletzt eingefügten Zeile zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>sqlite_last_insert_rowid</methodname> <methodparam><type>resource</type><parameter>db</parameter></methodparam> </methodsynopsis> <para> Liefert die Nummer der Zeile, die als letztes in die Datenbank <parameter>db</parameter> eingefügt wurde zurück, wenn es aus auto-increment-Feld angelegt wurde. </para> <tip> <para> Sie können Auto-Increment-Felder in SQLite erzeugen, indem Sie sie als <literal>INTEGER PRIMARY KEY</literal> anlegen. </para> </tip> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-libencoding.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-libencoding.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-libencoding"> <refnamediv> <refname>sqlite_libencoding</refname> <refpurpose>Gibt die Kodierung der genutzten SQLite-Bibliothek zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>sqlite_libencoding</methodname> <void/> </methodsynopsis> <para> Die SQLite Bibliothek kann entweder mit der ISO-8859-1-Kodierung oder mit UTF-8 kompiliert werden. Diese Funktion erlaubt es Ihnen, festzustellen, welche Kodierung von der von Ihnen genutzten Datenbank unterstützt wird. </para> <warning> <para> Die Standarddistribution von PHP enhält eine SQLite-Library mit ISO-8859-1-Kodierung. In Wahrheit wird aber nicht ISO-8859-1 genutzt, sondern die von Ihnen genutzte Locale-Einstellung für Stringvergleiche und Sortierreihenfolgen. Also handelt es sich eigentlich eher um '8-Bit' als um ISO-8859-1. </para> </warning> <para> Wenn SQLite mit UTF-8-Unterstützung kompiliert wurde, kümmert sich SQLite zwar um das Kodieren und Dekodieren von UTF-8-Multibyte Zeichen, aber es kümmert sich nicht um alle Details, die die Nutzung der Daten betreffen (es wird zum Beispiel keine Normalisierung durchgeführt). Einige Vergleichsoperationen werden unter Umständen nicht korrekt durchgeführt. </para> <para> PHP sollte in einer Webserver-Konfiguration nicht mit eine SQLite-Version mit einkompilierte UTF-8-Unterstützung genutzt werden, dann die SQLite-Bibliothek den Prozess abricht, sobald ein Problem mit der UTF-8-Kodierung feststellt. </para> <para> Siehe auch <function>sqlite_libversion</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-libversion.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-libversion.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-libversion"> <refnamediv> <refname>sqlite_libversion</refname> <refpurpose>Liefert die Version der genutzten SQLite-Bibliothek zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>sqlite_libversion</methodname> <void/> </methodsynopsis> <para> Gibt die Versionsnummer der genutzten SQLite-Bibliothek als String zurück. </para> <para> Siehe auch <function>sqlite_libencoding</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-next.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-next.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-next"> <refnamediv> <refname>sqlite_next</refname> <refpurpose>Springt zur nächsten Zeile</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>sqlite_next</methodname> <methodparam><type>resource</type><parameter>Ergebnis</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_next</function> schaltet das Abfrageergebnis <parameter>Ergebnis</parameter> auf die nächste Zeile um. Die Funktion liefert &false; zurück, wenn keine weiteren Zeilen vorhanden sind, ansonsten &true; </para> <note> <para> Diese Funktion kann nicht mit ungebufferten Ergebnisses genutzt werden. </para> </note> <para> Siehe auch <function>sqlite_seek</function>, <function>sqlite_current</function> und <function>sqlite_rewind</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-num-fields.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-num-fields.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-num-fields"> <refnamediv> <refname>sqlite_num_fields</refname> <refpurpose>Gibt die Anzahl Felder für ein Abfrageergebnis zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>sqlite_num_fields</methodname> <methodparam><type>resource</type><parameter>Ergebnis</parameter></methodparam> </methodsynopsis> <para> Liefert die Anzahl an Feldern im Abfrageergebnis <parameter>Ergebnis</parameter> zurück. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-num-rows.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-num-rows.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-num-rows"> <refnamediv> <refname>sqlite_num_rows</refname> <refpurpose>Liefert die Anzahl an Zeilen, die in einem Abfrageergebnis enthalten sind, zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>sqlite_num_rows</methodname> <methodparam><type>resource</type><parameter>Ergebnis</parameter></methodparam> </methodsynopsis> <para> Gibt die Anzahl Zeilen, die in dem Abfrageergebnis <parameter>Ergebnis</parameter> enthalten sind, zurück. </para> <note> <para> Diese Funktion kann nicht mit ungebufferten Abfrageergebnissen genutzt werden. </para> </note> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-open.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-open.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-open"> <refnamediv> <refname>sqlite_open</refname> <refpurpose>Öffnet eine SQLite Datenbank. Wenn die Datenbank nicht existiert, wird sie erzeugt.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>resource</type><methodname>sqlite_open</methodname> <methodparam><type>string</type><parameter>Datei</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>&Fehler</parameter></methodparam> </methodsynopsis> <para> Liefert eine Datenbankresource bei einer erfolgreichen Verbindung zurück, sonst &false;. </para> <para> Der Parameter <parameter>Datei</parameter> enthält den Namen der Datenbank. Es kann sich dabei um einen relativen und auch um einen absoluten Pfad zu der Datei handeln, in der SQLite die Daten speichern wird. Wenn die Datei noch nicht existiert, wird SQlite versuchen, sie anzulegen. Sie <emphasis>MÜSSEN</emphasis> Schreibrechte auf die Datei haben, wenn Sie Daten in die Datenbank eintragen oder die Datenbank ändern wollen. </para> <para> Der Parameter <parameter>mode</parameter> spezifiziert den Modus der Datei und sollte genutzt werden, wenn die Datenbank nur Lesezugriff erlauben soll. Zur Zeit wird dieser Parameter von der SQLite-Bibliothek ignoriert. Der Standardwert für Modus ist der oktale Wert <literal>06666</literal>. Es handelt sich dabei um den empfohlenen Wert, wenn der Parameter <parameter>Fehler</parameter> genutzt werden soll. </para> <para> <parameter>Fehler</parameter> wird per Referenz übergeben und enthält eine lesbare Fehlermeldung, warum die Datenbank nicht geöffnet werden konnte - wenn ein Fehler vorlag. </para> <para> <example> <title><function>sqlite_open</function> Beispiel</title> <programlisting role="php"> <![CDATA[ <?php if ($db = sqlite_open('mysqlitedb', 0666, $sqliteerror)) { sqlite_query('CREATE TABLE foo (bar varchar(10))'); sqlite_query("INSERT INTO foo VALUES ('fnord')"); $result = sqlite_query('select bar from foo'); var_dump(sqlite_fetch_array($result)); } else { die ($sqliteerror); } ?>]]> </programlisting> </example> </para> <tip> <simpara> Auf Unix-Plattformen müssten Skripte, die den Systembefehl fork() nutzen, für SQLite angepasst werden. Wenn Sie solch ein Skript haben, sollten sie vor dem fork() die Datenbank schliessen und sie nach dem fork() im Kind- und/oder Vaterprozess neu öffnen. Weitere Informaitonen hierzu For more information on this issue, see <ulink url="&url.sqlite.interface.c;">The C language interface to the SQLite library</ulink> in the section entitled <literal>Multi-Threading And SQLite</literal>. </simpara> </tip> <tip> <simpara> It is not recommended to work with SQLite databases mounted on NFS partitions. Since NFS is notoriously bad when it comes to locking you may find that you cannot even open the database at all, and if it succeeds, the locking behaviour may be undefined. </simpara> </tip> <note> <simpara> Starting with SQLite library version 2.8.2, you can specify <literal>:memory:</literal> as the <parameter>filename</parameter> to create a database that lives only in the memory of the computer. This is useful mostly for temporary processing, as the in-memory database will be destroyed when the process ends. It can also be useful when coupled with the <literal>ATTACH DATABASE</literal> SQL statement to load other databases and move and query data betweem them. </simpara> </note> <note> <simpara> SQLite is &safemode; and open_basedir aware. </simpara> </note> <para> See also <function>sqlite_popen</function>, <function>sqlite_close</function> and <function>sqlite_query</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-popen.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-popen.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-popen"> <refnamediv> <refname>sqlite_popen</refname> <refpurpose>Opens a persistent handle to an SQLite database. Will create the database if it does not exist</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>resource</type><methodname>sqlite_popen</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>&errmessage</parameter></methodparam> </methodsynopsis> <simpara> This function behaves identically to <function>sqlite_open</function> except that is uses the persistent resource mechanism of PHP. For information about the meaning of the parameters, read the <function>sqlite_open</function> manual page. </simpara> <para> <function>sqlite_popen</function> will first check to see if a persistent handle has already been opened for the given <parameter>filename</parameter>. If it finds one, it returns that handle to your script, otherwise it opens a fresh handle to the database. </para> <para> The benefit of this approach is that you don't incurr the performance cost of re-reading the database and index schema on each page hit served by persistent web server SAPI's (any SAPI except for regular CGI or CLI). </para> <note> <simpara> If you use persistent handles and have the database updated by a background process (perhaps via a crontab), and that process re-creates the database by overwriting it (either by unlinking and rebuilding, or moving the updated version to replace the current version), you may experience undefined behaviour when a persistent handle on the old version of the database is recycled. </simpara> <simpara> To avoid this situation, have your background processes open the same database file and perform their updates in a transaction. </simpara> </note> <para> See also <function>sqlite_popen</function>, <function>sqlite_close</function> and <function>sqlite_query</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-query.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-query.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-query"> <refnamediv> <refname>sqlite_query</refname> <refpurpose>Führt auf einer Datenbank eine Abfrage durch und liefert das Abfrageergebnis zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>resource</type><methodname>sqlite_query</methodname> <methodparam><type>resource</type><parameter>db</parameter></methodparam> <methodparam><type>string</type><parameter>Abfrage</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>resource</type><methodname>sqlite_query</methodname> <methodparam><type>string</type><parameter>Abfrage</parameter></methodparam> <methodparam><type>resource</type><parameter>db</parameter></methodparam> </methodsynopsis> <para> Führt die den durch <parameter>Abfrage</parameter> gegebenen SQL-Befehl auf der Datenbank <parameter>db</parameter> durch, </para> <para> Für Abfrage, die Zeilen zurückliefern, gibt diese Funktion ein Abfrageergebnis zurück, dass von Funkionen wie <function> sqlite_fetch_array</function> oder auch <function>sqlite_seek</function> genutzt werden kann. </para> <para> Für alle anderen Arten von Abfragen gibt diese Funktion ein boolsches Resultat zurück, &true; bei Erfolg und &false; bei einem Fehler. </para> <para> Unabhänging vom Abfragetyp liefert die Funktion &false; zurück wenn die Abfrage 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> <note> <simpara> Two alternative syntaxes are supported for compatibility with other database extensions (such as MySQL). The preferred form is the first one, where the <parameter>db</parameter> parameter is the first parameter to the function. </simpara> </note> <warning> <simpara> SQLite <emphasis>will</emphasis> execute multiple queries separated by semicolons, so you can use it to execute a batch of SQL that you have loaded from a file or have embedded in a script. </simpara> <simpara> When executing multiple queries, the return value of this function will be &false; if the was an error, but undefined otherwise (it might be &true; for success or it might return a result handle). </simpara> </warning> <para> See also <function>sqlite_array_query</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-register-aggregate.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-register-aggregate.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-register-aggregate"> <refnamediv> <refname>sqlite_register_aggregate</refname> <refpurpose>Erzeugt eine aggregierende UDF zur Nutzung in SQL-Befehlen</refpurpose></refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>sqlite_register_aggregate</methodname> <methodparam><type>resource</type><parameter>db</parameter></methodparam> <methodparam><type>string</type><parameter>Funktionsname</parameter></methodparam> <methodparam><type>mixed</type><parameter>Schrittfunktion</parameter></methodparam> <methodparam><type>mixed</type><parameter>Finalefunktion</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>Argumentenzahl</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_register_aggregate</function> entspricht etwa der Funktion <function>sqlite_create_function</function> mit der Ausnahme, dass die erzeugte Funktion für Zusammenfassungsoperationen über alle Zeilen einer Query genutzt werden kann. </para> <para> Der Hauptunterschied zwischen dieser Funktion und <function>sqlite_create_function</function> besteht darin, dass hier zwei Funktionen benötigt werden, um das Aggregate zu erzeugen. <parameter>Schrittfunktion</parameter> wird für jede einzelne Zeile des Ergebnis aufgerufen. Die PHP Funktion sollte in dieser Funktion das Aggregationsergebnis aufbauen und zwischenspeichern. Nachdem alle Zeilen bearbeitet wurden, wird die Funktion <parameter>Finalefunktion</parameter> aufgerufen, die die gesammelten Daten zusammenführt und das Ergebnis der gesamten Funktion zurückliefert. </para> <para> <example> <title>Funktionsbeispiel für Aggregatsfunktionen max_laenge</title> <programlisting role="php"> <![CDATA[ <?php $data = array( 'eins', 'zwei', 'drei', 'vier' 'fünf' 'sechs', 'sieben', 'acht', 'neun' 'zehn' ); $db = sqlite_open(':memory:'); sqlite_query($db, "CREATE TABLE strings(a)"); foreach ($data as $str) { sqlite_query($db, "INSERT INTO strings VALUES('" . sqlite_escape_string($str) . "')"); } function max_laenge_schritt(&$context, $string) { if (strlen($string) > $context) { $context = strlen($string); } } function max_laenge_finalisieren(&$context) { return $context; } sqlite_create_aggregate($db, 'max_laenge', 'max_laenge_schritt', 'max_laenge_finalisieren'); var_dump(sqlite_array_query($db, 'SELECT max_laenge(a) from strings')); ?>]]> </programlisting> </example> </para> <para> In diesem Beispiel erzeugen wir eine Aggregationsfunktion, die die Länge des längsten Strings für eine bestimmte Spalte der Tabelle ermittelt. Für jede einzelne Zeile wird die Funktion <literal>max_laenge_schritt </literal> mit dem <parameter>context</parameter> aufgerufen. Der Kontextparameter verhält sich wie eine normale PHP-Variable und kann zum Beispiel ein Objekt oder ein Array sein. In diesem Beispiel wird er einfach dazu benutzt, die bislang größte Länge zwischenzuspeichern. Wenn der <parameter>string</parameter> länger als er ist, wird die Kontextvariable auf diesen neuen Wert geändert. </para> <para> Nachdem alle einzelnen Zeilen bearbeitet wurden, ruft SQLite die Funktion <literal>max_laenge_finalisieren</literal> auf um die Zusammenfassung des Ergebnisses zu ermitteln. Hier könnten zum Beispiel Berechnungen erfolgen, die auf den in der Kontextvariablen <parameter>context</parameter> gesammelten Informationen beruhen. In unserem einfachem Beispiel haben wir das Resultat aber schon in jeder Schrittfunktion automatisch berechnet, also brauchen wir hier nur den Wert der Kontextvariablen zurückzuliefern. </para> <tip> <para> Es ist NICHT empfohlen, eine Kopie jedes einzelnen Wertes in der Kontext- Variablen zu speichern, weil SQLite dann deutlich mehr Speicher zum Bearbeiten der Funktion benötigen würde - stellen Sie sich einfach vor, wieviel Speicher sie benötigen würden, wenn Sie mehr als eine Million Zeilen dort halten würden, von denen jede einen 32 Bytes langen String enthält. </para> </tip> <para> Siehe auch <function>sqlite_create_function</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-rewind.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-rewind.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-rewind"> <refnamediv> <refname>sqlite_rewind</refname> <refpurpose>Springt zur ersten Zeile</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>sqlite_rewind</methodname> <methodparam><type>resource</type><parameter>Ergebnis</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_rewind</function> springt zurück auf die erste Zeile eines Abfrageergebnisses. Sie gibt &false; zurück, wenn das Ergebnis leer ist, ansonsten &true;. </para> <note> <para> Diese Funktion kann nicht mit ungebufferten Ergebnissen genutzt werden. </para> </note> <para> Siehe auch <function>sqlite_next</function>, <function> sqlite_current</function> und <function>sqlite_seek</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-seek.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-seek.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-seek"> <refnamediv> <refname>sqlite_seek</refname> <refpurpose>Springe auf eine bestimmte Zeilennummer</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>sqlite_rewind</methodname> <methodparam><type>resource</type><parameter>Ergebnis</parameter></methodparam> <methodparam><type>int</type><parameter>Zeilennummer</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_seek</function> springt auf die Zeile mit der <parameter>Zeilennummer</parameter>. Die Zeilennummerierung beginnt mit Zeile 1. Die Funktion liefert &false; zurück, wenn die Zeile nicht existiert, ansonsten &true;. </para> <note> <para> Diese Funktion kann nicht mit ungebufferten Ergebnissen genutzt werden. </para> </note> <para> Siehe auch <function>sqlite_next</function>, <function>sqlite_current</function> and <function>sqlite_rewind</function>. </para> </refsect1> </refentry>  Index: phpdoc-de/reference/sqlite/functions/sqlite-unbuffered-query.xml +++ phpdoc-de/reference/sqlite/functions/sqlite-unbuffered-query.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id="function.sqlite-unbuffered-query"> <refnamediv> <refname>sqlite_unbuffered_query</refname> <refpurpose>Führt eine Abfrage durch, aber übernimmt die Daten nicht gleich in das PHP</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>resource</type><methodname>sqlite_unbuffered_query</methodname> <methodparam><type>resource</type><parameter>db</parameter></methodparam> <methodparam><type>string</type><parameter>Abfrage</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>resource</type><methodname>sqlite_unbuffered_query</methodname> <methodparam><type>string</type><parameter>Abfrage</parameter></methodparam> <methodparam><type>resource</type><parameter>db</parameter></methodparam> </methodsynopsis> <para> <function>sqlite_unbuffered_query</function> entspricht im wesentlichen <function>sqlite_query</function>, nur dass das Ergebnis hier nur Zeile für Zeile sequentiell vorwärts gelesen werden kann. </para> <para> Diese Funktions ist ideal, um Dinge wie HTML-Tabellen, bei denen nur eine Zeile zur Zeit ausgegeben werden muss, und die Zeilen nicht durcheinander abgefragt werden sollen. </para> <note> <para> Funktionen wie etwa <function>sqlite_seek</function> und <function>sqlite_rewind</function> funktionieren mit mit Abfrageresultaten, die von dieser Funktion zurückgeliefert werden. </para> </note> </refsect1> </refentry>