cvs: phpdoc /de/functions dba.xml
| From: | Martin Kraemer | Date: | Thu, 17 May 2001 12:39:11 +0000 |
| Subject: | cvs: phpdoc /de/functions dba.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969335375@lists.php.net to get a copy of this message | ||
martin Thu May 17 05:39:11 2001 EDT
Modified files:
/phpdoc/de/functions dba.xml
Log:
Improve wording, fix typos, improve layout
Index: phpdoc/de/functions/dba.xml diff -u phpdoc/de/functions/dba.xml:1.5 phpdoc/de/functions/dba.xml:1.6 --- phpdoc/de/functions/dba.xml:1.5 Sun Feb 25 14:06:16 2001 +++ phpdoc/de/functions/dba.xml Thu May 17 05:39:11 2001 @@ -1,84 +1,118 @@ <reference id="ref.dba"> - <title>Datenbank (dbm-style) Abstraktions Funktionen</title> + <title>dba Datenbank (dbm-style) Abstraktions-Funktionen</title> <titleabbrev>dba</titleabbrev> <partintro> <para> Diese Funktionen bilden die Basis für den Zugriff auf - Datenbanken im Berkeley DB Stil. + Datenbanken vom Typ "Berkeley DB". </para> <para> - Es handelt sich hierbei um eine generelle Abstraktionsschicht für - verschiedenen textbasierte Datenbanken. - Als solche ist der Funktionsumfang beschränkt auf einen Bruchteil - des Funktionsumfangs moderner Datenbanken wie zum Beispiel - <ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink>. - (Diese sollte nicht verwechselt werden mit IBM's DB2 Software, + "dba" implementiert eine generelle Abstraktionsschicht für + verschiedene dateibasierte Datenbanken. + Der Funktionsumfang ist daher beschränkt auf eine + gemeinsame Teilmenge des Funktionsumfangs aktueller Datenbanken + (zum Beispiel + <ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink>, + nicht zu verwechseln mit IBM's DB2 Software, die über die <link linkend="ref.odbc">ODBC Funktionen</link> - unterstützt wird.) + unterstützt wird). </para> <para> - Das Verhalten verschiedener Aspekte des Systems ist abhängig von - der Implementation des zugrunde liegenden Datenbanksystems. + Das Verhalten der dba-Funktionen ist teilweise abhängig von + der Implementation des zugrundeliegenden Datenbanksystems. Funktionen wie zum Beispiel <function>dba_optimize</function> - und <function>dba_sync</function> funktionieren wie angepriesen mit - der einen Datenbank und versagen ihren Dienst mit Anderen. + und <function>dba_sync</function> funktionieren vielleicht bei + einer Datenbank, und tun gar nichts bei einer Anderen. </para> <para> - Um Unterstützung für einen der folgenden Handler - verfügbar zu machen, fügen Sie bitte den jeweils angegebenen - --with Kompilerschalter in ihre PHP Konfigurationszeile ein: - <itemizedlist> - <listitem> - <simpara> - Dbm ist der älteste und der original Typ der Datenbanken - im Berkeley DB Stil. Sie sollten dieses System wenn möglich - vermeiden. - Wir ünterstützen nicht die Kompatibilitätsfunktionen, - die in DB2 und gdbm enthalten sind, da sie nur auf - Quellcode Basis kompatibel sind und nicht mit dem original dbm - Format arbeiten können. (--with-dbm) - </simpara> - </listitem> - <listitem> - <simpara> - Ndbm ist neuer und flexibler als Dbm. Es hat jedoch immer noch - die meisten Einschränkungen von Dbm und ist daher ebenfalls - nicht empfehlenswert. (--with-ndbm) - </simpara> - </listitem> - <listitem> - <simpara> - Gdbm ist der <ulink url="&url.gdbm;">GNU Datenbank Manager</ulink>. - (--with-gdbm) - </simpara> - </listitem> - <listitem> - <simpara> - DB2 ist <ulink url="&url.sleepycat;">Sleepycat Software's - DB2</ulink>. Es wird beschrieben als "Werkzeugsatz, der - schnell verfügbaren eingebauten Datenbank Support sowohl - für Einzel- als auch für Client/Server- Applikationen - zur Verfügung stellt." (--with-db2) - </simpara> - </listitem> - <listitem> - <simpara> - DB3 ist <ulink url="&url.sleepycat;">Sleepycat Software's - DB3</ulink>. (--with-db3) - </simpara> - </listitem> - <listitem> - <simpara> - Cdb ist "ein schnelles, zuverlässiges und kompaktes - Paket zum Erstellen und Auslesen konstanter Datenbanken." - Es stammt vom Autor von qmail und kann <ulink url="&url.cdb;"> - hier</ulink> heruntergeladen werden. Da es ein konstantes - System ist, werden nur Lese-Operationen unterstützt. - (--with-cdb) - </simpara> - </listitem> - </itemizedlist> + Beim Aufruf von <function>dba_open</function> oder + <function>dba_popen</function> muss einer der verfügbaren + Handler-Namen aus der nachfolgenden Handler-Tabelle angegeben + werden. Die tatsächlich verfügbaren Handler in + Ihrer PHP-Installation können Sie mit der Funktion + <function>phpinfo</function> anzeigen lassen. (Um zum + Zeitpunkt der PHP-Generierung die Unterstützung für + einen der folgenden Handler verfügbar zu machen, + fügen Sie bitte den jeweils angegebenen + <literal>--with-XXXX</literal> Compilerschalter in ihren + PHP-Konfigurations-Aufruf ein.) + <table> + <title>Liste der DBA-Handler</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Handler</entry> + <entry>Hinweise</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>dbm</literal></entry> + <entry> + Dbm ist der ursprüngliche und älteste Typ der + "Berkeley DB" Datenbanken. Sie sollten diesen Typ + wenn möglich vermeiden. + Die in DB2 und gdbm enthaltenen dbm-Kompatibilitätsfunktionen + werden ebenfalls nicht unterstützt, da sie nur auf + Quellcode-Basis kompatibel sind, aber Dateien im originalen + dbm-Format nicht bearbeiten können. + (<literal>--with-dbm</literal>) + </entry> + </row> + + <row> + <entry><literal>ndbm</literal></entry> + <entry> + Ndbm ist neuer und flexibler als Dbm. Es hat jedoch + die meisten Einschränkungen von Dbm übernommen + und ist daher ebenfalls nicht empfehlenswert. + (<literal>--with-ndbm</literal>) + </entry> + </row> + + <row> + <entry><literal>gdbm</literal></entry> + <entry> + Gdbm ist der <ulink url="&url.gdbm;">GNU Datenbank Manager</ulink>. + (<literal>--with-gdbm</literal>) + </entry> + </row> + + <row> + <entry><literal>db2</literal></entry> + <entry> + DB2 ist <ulink url="&url.sleepycat;">Sleepycat Software's + DB2</ulink>. Es wird beschrieben als "Werkzeugsatz für + eingebaute Unterstützung von Hochleistungs-Datenbanken + für Standalone- und Client/Server- Applikationen". + (<literal>--with-db2</literal>) + </entry> + </row> + + <row> + <entry><literal>db3</literal></entry> + <entry> + DB3 ist <ulink url="&url.sleepycat;">Sleepycat Software's + DB3</ulink>. (<literal>--with-db3</literal>) + </entry> + </row> + + <row> + <entry><literal>cdb</literal></entry> + <entry> + Cdb ist "ein schnelles, zuverlässiges und kompaktes + Paket zum Erstellen und Auslesen konstanter Datenbanken." + Es stammt vom Autor von qmail und kann <ulink url="&url.cdb;"> + hier</ulink> heruntergeladen werden. Da es für konstante + Daten ausgelegt ist, werden nur Lese-Operationen unterstützt. + (<literal>--with-cdb</literal>) + </entry> + </row> + + </tbody> + </tgroup> + </table> </para> <para> <example> @@ -107,22 +141,22 @@ </para> <para> DBA arbeitet binärsicher und besitzt keine willkürlichen Limits. - Es vererbt alle Einschränkungen von der Datenbank Implementation, die - ihm zugrunde liegt. + Es erbt allerdings alle Einschränkungen von der + zugrundeliegenden Datenbank-Implementation. </para> <para> - Alle textbasierten Datenbanken müssen einen Weg zur + Alle dateibasierten Datenbanken müssen einen Weg zur Verfügung stellen, um den Dateimodus einer neu erstellten Datenbank zu bestimmen, soweit dies überhaupt möglich ist. - Der Dateimodus wird für gewöhnlich als viertes Argument + Der Dateimodus wird gewöhnlich als viertes Argument an die Funktionen <function>dba_open</function> oder <function>dba_popen</function> übergeben. </para> <para> - Sie können auf alle Einträge in einer Datenbank auf - linearem Weg durch die Verwendung von <function>dba_firstkey</function> + Sie können auf alle Einträge in einer Datenbank + sequentiell durch die Verwendung von <function>dba_firstkey</function> und <function>dba_nextkey</function> zugreifen. Während die - Datenbank so durchlaufen wird, kann sie nicht verändert werden. + Datenbank so durchlaufen wird, darf sie nicht verändert werden. </para> <para> <example> @@ -130,7 +164,7 @@ <programlisting role="php"> <?php -# ...oeffnen der Datenbank... +# ...Oeffnen der Datenbank... $key = dba_firstkey ($id); @@ -153,7 +187,7 @@ <refentry id="function.dba-close"> <refnamediv> <refname>dba_close</refname> - <refpurpose>Datenbank schliessen</refpurpose> + <refpurpose>Datenbank schließen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -164,16 +198,16 @@ </funcprototype> </funcsynopsis> <para> - <function>Dba_close</function> schliesst die aufgebaute - Verbindung zur Datenbank, die durch <parameter>handle</parameter> - festgelegt wird, und gibt alle Resourcen wieder frei. + <function>dba_close</function> schließt die offene + Datenbank, die durch <parameter>handle</parameter> + festgelegt wird, und gibt alle zugehörigen Ressourcen frei. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>Dba_close</function> besitzt keinen Rückgabewert. + <function>dba_close</function> besitzt keinen Rückgabewert. </para> <para> Siehe auch <function>dba_open</function> und @@ -185,35 +219,35 @@ <refentry id="function.dba-delete"> <refnamediv> <refname>dba_delete</refname> - <refpurpose>Löschen des durch key festgelegten Eintrages</refpurpose> + <refpurpose>Löschen des zu key gehörigen Eintrages</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>dba_delete</function></funcdef> + <funcdef>bool <function>dba_delete</function></funcdef> <paramdef>string <parameter>key</parameter></paramdef> <paramdef>int <parameter>handle</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>dba_delete</function> löscht den Eintrag, der - durch <parameter>key</parameter> festgelegt ist, aus der - Datenbank, die mit <parameter>handle</parameter> spezifiziert - ist. + <function>dba_delete</function> löscht den Eintrag mit dem + Schlüsel <parameter>key</parameter> aus der durch + <parameter>handle</parameter> spezifizierten Datenbank. </para> <para> <parameter>key</parameter> ist der Schlüssel des Eintrags, der gelöscht wird. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>dba_delete</function> hat als Rückgabewert true - oder false, abhängig davon, ob der Eintrag gelöscht - wurde oder nicht. + <function>dba_delete</function> hat als Rückgabewert + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob der Löschvorgang erfolgreich war + oder nicht. </para> <para> Siehe auch <function>dba_exists</function>, @@ -226,7 +260,7 @@ <refentry id="function.dba-exists"> <refnamediv> <refname>dba_exists</refname> - <refpurpose>Überprüfen, ob key existiert</refpurpose> + <refpurpose>Überprüfen, ob Datensatz mit Schlüssel key existiert</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -238,21 +272,23 @@ </funcprototype> </funcsynopsis> <para> - <function>Dba_exists</function> überprüft, ob - <parameter>key</parameter> in der Datenbank, die durch - <parameter>handle</parameter> spezifiziert wird, existiert. + <function>dba_exists</function> überprüft, ob + ein Datensatz mit dem Schlüssel <parameter>key</parameter> + in der durch <parameter>handle</parameter> spezifizierten Datenbank + existiert. </para> <para> <parameter>Key</parameter> ist der Schlüssel, dessen Existenz überprüft werden soll. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>Dba_exists</function> hat als Rückgabewert true - oder false, abhängig davon, ob der Schlüssel gefunden + <function>dba_exists</function> hat als Rückgabewert + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob der Schlüssel gefunden wurde oder nicht. </para> <para> @@ -266,7 +302,7 @@ <refentry id="function.dba-fetch"> <refnamediv> <refname>dba_fetch</refname> - <refpurpose>Daten, die durch key festgelegt sind, auslesen</refpurpose> + <refpurpose>Datensatz für Schlüssel "key" auslesen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -278,25 +314,26 @@ </funcprototype> </funcsynopsis> <para> - <function>Dba_fetch</function> liest die Daten, die durch - <parameter>key</parameter> festgelegt, sind aus der - Datenbank, die durch <parameter>handle</parameter> spezifiziert - ist, aus. + <function>dba_fetch</function> liest die durch den Schlüssel + <parameter>key</parameter> festgelegten Daten + aus der durch <parameter>handle</parameter> spezifizierten + Datenbank aus. </para> <para> <parameter>Key</parameter> ist der Schlüssel, mit dem die Daten identifizert werden. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>Dba_fetch</function> hat als Rückgabewert - entweder den ausgelesenen String oder false, abhängig - davon, ob das Schlüssel/Wert Paar gefunden wurde oder - nicht. + <function>dba_fetch</function> hat als Rückgabewert + entweder den zum Schlüssel <parameter>key</parameter> + passenden Werte-String oder <literal>false</literal>, + abhängig davon, ob das Schlüssel/Wert-Paar + gefunden wurde oder nicht. </para> <para> Siehe auch <function>dba_exists</function>, @@ -309,7 +346,7 @@ <refentry id="function.dba-firstkey"> <refnamediv> <refname>dba_firstkey</refname> - <refpurpose>Ersten Schlüssel auslesen</refpurpose> + <refpurpose>Ersten Schlüssel bestimmen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -320,24 +357,26 @@ </funcprototype> </funcsynopsis> <para> - <function>Dba_firstkey</function> gibt den ersten Schlüssel - aus der Datenbank, die durch <parameter>handle</parameter> - spezifiziert wird, zurück und setzt den internen - Zähler zurück. Dies erlaubt eine lineare Suche durch + <function>dba_firstkey</function> gibt den ersten Schlüssel + aus der durch <parameter>handle</parameter> + spezifizierten Datenbank zurück und setzt den internen + Schlüssel-Zeiger zurück. Dies erlaubt in Verbindung mit + <function>dba_nextkey</function> eine sequentielle Suche durch die gesamte Datenbank. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>Dba_firstkey</function> hat als Rückgabewert - den Schlüssel oder false, abhängig davon, ob die - Aktion erfolgreich war oder fehlschlug. + <function>dba_firstkey</function> liefert als Rückgabewert + den Schlüssel oder <literal>false</literal>, + abhängig davon, ob die Aktion erfolgreich war oder fehlschlug. </para> <para> Siehe auch - <function>Dba_nextkey</function> + <function>dba_nextkey</function> + und Beispiel 2 im <link linkend="ref.dba">DBA-Überblick</link> </para> </refsect1> </refentry> @@ -345,7 +384,7 @@ <refentry id="function.dba-insert"> <refnamediv> <refname>dba_insert</refname> - <refpurpose>Eintrag einfügen</refpurpose> + <refpurpose>Datensatz einfügen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -358,10 +397,10 @@ </funcprototype> </funcsynopsis> <para> - <function>dba_insert</function> fügt den Eintrag, der + <function>dba_insert</function> fügt den Datensatz, der durch <parameter>key</parameter> und <parameter>value</parameter> - beschrieben wird in die Datenbank, die durch - <parameter>handle</parameter> spezifiziert wird, ein. Die Aktion + beschrieben wird, in die durch <parameter>handle</parameter> + spezifizierte Datenbank ein. Die Aktion schlägt fehl, wenn es bereits einen Eintrag mit dem gleichen <parameter>key</parameter> in der Datenbank gibt. </para> @@ -374,12 +413,13 @@ werden soll. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>dba_insert</function> hat als Rückgabewert true - oder false, abhängig davon, ob die Aktion erfolgreich + <function>dba_insert</function> hat als Rückgabewert + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob die Aktion erfolgreich war oder nicht. </para> <para> @@ -395,7 +435,7 @@ <refentry id="function.dba-nextkey"> <refnamediv> <refname>dba_nextkey</refname> - <refpurpose>Nächsten Schlüssel auslesen</refpurpose> + <refpurpose>Nachfolgenden Schlüssel bestimmen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -406,23 +446,24 @@ </funcprototype> </funcsynopsis> <para> - <function>dba_nextkey</function> gibt den nächsten - Schlüssel aus der Datenbank, die durch - <parameter>handle</parameter> spezifiziert wird, zurück - und erhöht den internen Schlüsselzähler um eins. + <function>dba_nextkey</function> gibt den nachfolgenden + Schlüssel aus der durch + <parameter>handle</parameter> spezifizierten Datenbank zurück + und erhöht den internen Schlüssel-Zeiger. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> <function>dba_nextkey</function> hat als Rückgabewert den - Schlüssel oder false, abhängig davon, ob die Aktion - erfolgreich war oder nicht. + Schlüssel oder <literal>false</literal>, + abhängig davon, ob die Aktion erfolgreich war oder nicht. </para> <para> Siehe auch <function>dba_firstkey</function> + und Beispiel 2 im <link linkend="ref.dba">DBA-Überblick</link> </para> </refsect1> </refentry> @@ -430,7 +471,7 @@ <refentry id="function.dba-popen"> <refnamediv> <refname>dba_popen</refname> - <refpurpose>Persistene Verbindung zu einer Datenbank öffnen</refpurpose> + <refpurpose>Persistente Datenbank-Verbindung öffnen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -447,28 +488,69 @@ <para> <function>dba_popen</function> stellt eine persistente Datenbankinstanz für <parameter>path</parameter> mit - <parameter>mode</parameter> her und benutzt dabei + <parameter>mode</parameter> her und benutzt dabei den Handler <parameter>handler</parameter>. </para> <para> - <parameter>path</parameter> ist für gewöhnlich ein + <parameter>path</parameter> ist ein gültiger Pfad in Ihrem Dateisystem. </para> <para> - <parameter>mode</parameter> ist "r" für Lesezugriff, - "w" für Lese- und Schreibzugriff, "c" für Lese- - und Schreibzugriff und die Möglichkeit, die - Datenbank zu erstellen, falls sie nicht existiert, und "n" - ist für Erstellen, Bearbeiten und Lese- und Schreibzugriff. + Das <parameter>mode</parameter> Argument beschreibt den Modus, + mit dem die Datenbank geöffnet werden soll. + Es gibt 4 Möglichkeiten, eine DBA Datenbank zu öffnen: + <variablelist> + <varlistentry> + <term>"r" (read-only)</term> + <listitem><para> + Eine existierende Datenbank soll nur lesend + geöffnet werden.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"n" (new)</term> + <listitem><para> + Eine neue Datenbank soll angelegt werden. + Diese wird automatisch als read-write geöffnet. + Eine existierende Datenbank wird inhaltlich + gelöscht.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"c" (create)</term> + <listitem><para> + Eine neue Datenbank soll angelegt werden. + Diese wird automatisch als read-write geöffnet. + Im Gegensatz zu "n" wird eine bereits existierende + Datenbank inhaltlich nicht gelöscht, sondern nur + für Lese- und Schreibzugriff geöffnet.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"w" (read-write)</term> + <listitem><para> + Eine existierende Datenbank soll lesend und + schreibend geöffnet werden.</para> + </listitem> + </varlistentry> + </variablelist> </para> <para> - <parameter>handler</parameter> ist der Name des Handlers, der für + <parameter>handler</parameter> ist der + <link linkend="ref.dba">Name des Handlers</link>, der für den Zugriff auf <parameter>path</parameter> benutzt werden soll. + Die (oben durch <parameter><optional>...</optional></parameter> + gekennzeichneten) optionalen Argumente der Funktion + <function>dba_popen</function> werden an ihn übergeben. </para> <para> - <function>dba_popen</function> hat als Rückgabewert eine - positive Handler ID oder false, abhängig davon, ob - die Verbindung hergestellt werden konnte oder nicht. + <function>dba_popen</function> liefert als Rückgabewert eine + positive Zugriffs-"handle" oder <literal>false</literal>, + abhängig davon, ob die Verbindung hergestellt werden + konnte oder nicht. </para> <para> Siehe auch @@ -500,24 +582,65 @@ her und benutzt dabei <parameter>handler</parameter>. </para> <para> - <parameter>path</parameter> ist für gewöhnlich ein + <parameter>path</parameter> ist ein gültiger Pfad in Ihrem Dateisystem. </para> <para> - <parameter>mode</parameter> ist "r" für Lesezugriff, - "w" für Lese- und Schreibzugriff, "c" für Lese- - und Schreibzugriff und die Möglichkeit, die - Datenbank zu erstellen, falls sie nicht existiert, und "n" - ist für Erstellen, Bearbeiten und Lese- und Schreibzugriff. + Das <parameter>mode</parameter> Argument beschreibt den Modus, + mit dem die Datenbank geöffnet werden soll. + Es gibt 4 Möglichkeiten, eine DBA Datenbank zu öffnen: + <variablelist> + <varlistentry> + <term>"r" (read-only)</term> + <listitem><para> + Eine existierende Datenbank soll nur lesend + geöffnet werden.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"n" (new)</term> + <listitem><para> + Eine neue Datenbank soll angelegt werden. + Diese wird automatisch als read-write geöffnet. + Eine existierende Datenbank wird inhaltlich + gelöscht.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"c" (create)</term> + <listitem><para> + Eine neue Datenbank soll angelegt werden. + Diese wird automatisch als read-write geöffnet. + Im Gegensatz zu "n" wird eine bereits existierende + Datenbank inhaltlich nicht gelöscht, sondern nur + für Lese- und Schreibzugriff geöffnet.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"w" (read-write)</term> + <listitem><para> + Eine existierende Datenbank soll lesend und + schreibend geöffnet werden.</para> + </listitem> + </varlistentry> + </variablelist> </para> <para> - <parameter>handler</parameter> ist der Name des Handlers, der für + <parameter>handler</parameter> ist der + <link linkend="ref.dba">Name des Handlers</link>, der für den Zugriff auf <parameter>path</parameter> benutzt werden soll. + Die (oben durch <parameter><optional>...</optional></parameter> + gekennzeichneten) optionalen Argumente der Funktion + <function>dba_open</function> werden an ihn übergeben. </para> <para> - <function>dba_open</function> hat als Rückgabewert eine - positive Handler ID oder false, abhängig davon, ob - die Verbindung hergestellt werden konnte oder nicht. + <function>dba_open</function> liefert als Rückgabewert eine + positive Zugriffs-"handle" oder <literal>false</literal>, + abhängig davon, ob die Verbindung hergestellt werden + konnte oder nicht. </para> <para> Siehe auch @@ -546,12 +669,13 @@ spezifiziert wird. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> <function>dba_optimize</function> hat als Rückgabewert - true oder false, abhängig davon, ob die Optimierung + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob die Optimierung erfolgreich war oder ob sie fehlschlug. </para> <para> @@ -564,7 +688,7 @@ <refentry id="function.dba-replace"> <refnamediv> <refname>dba_replace</refname> - <refpurpose>Ersetzen oder Einfügen eines Eintrags</refpurpose> + <refpurpose>Datensatz ersetzen oder einfügen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -578,10 +702,10 @@ </funcsynopsis> <para> <function>dba_replace</function> ersetzt oder fügt - einen Eintrag, der durch <parameter>key</parameter> und - <parameter>value</parameter> beschrieben wird, in die - Datenbank, die durch <parameter>handle</parameter> - spezifiziert wird, ein. + in der durch <parameter>handle</parameter> + spezifizierten Datenbank einen Datensatz ein, + der durch den Schlüssel <parameter>key</parameter> und + den Wert <parameter>value</parameter> beschrieben wird. </para> <para> <parameter>key</parameter> ist der Schlüssel des Eintrags, @@ -592,13 +716,13 @@ werden soll. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>dba_replace</function> hat als Rückgabewert - true oder false, abhängig davon, ob die Aktion erfolgreich - war oder nicht. + <function>dba_replace</function> liefert als Rückgabewert + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob die Aktion erfolgreich war oder nicht. </para> <para> Siehe auch <function>dba_exists</function>, @@ -629,13 +753,13 @@ dies unterstützt wird. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> <function>dba_sync</function> hat als Rückgabewert - true oder false, abhängig davon, ob die Aktion erfolgreich - war oder nicht. + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob die Aktion erfolgreich war oder nicht. </para> <para> Siehe auch <function>dba_optimize</function>
Index: phpdoc/de/functions/dba.xml diff -u phpdoc/de/functions/dba.xml:1.5 phpdoc/de/functions/dba.xml:1.6 --- phpdoc/de/functions/dba.xml:1.5 Sun Feb 25 14:06:16 2001 +++ phpdoc/de/functions/dba.xml Thu May 17 05:39:11 2001 @@ -1,84 +1,118 @@ <reference id="ref.dba"> - <title>Datenbank (dbm-style) Abstraktions Funktionen</title> + <title>dba Datenbank (dbm-style) Abstraktions-Funktionen</title> <titleabbrev>dba</titleabbrev> <partintro> <para> Diese Funktionen bilden die Basis für den Zugriff auf - Datenbanken im Berkeley DB Stil. + Datenbanken vom Typ "Berkeley DB". </para> <para> - Es handelt sich hierbei um eine generelle Abstraktionsschicht für - verschiedenen textbasierte Datenbanken. - Als solche ist der Funktionsumfang beschränkt auf einen Bruchteil - des Funktionsumfangs moderner Datenbanken wie zum Beispiel - <ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink>. - (Diese sollte nicht verwechselt werden mit IBM's DB2 Software, + "dba" implementiert eine generelle Abstraktionsschicht für + verschiedene dateibasierte Datenbanken. + Der Funktionsumfang ist daher beschränkt auf eine + gemeinsame Teilmenge des Funktionsumfangs aktueller Datenbanken + (zum Beispiel + <ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink>, + nicht zu verwechseln mit IBM's DB2 Software, die über die <link linkend="ref.odbc">ODBC Funktionen</link> - unterstützt wird.) + unterstützt wird). </para> <para> - Das Verhalten verschiedener Aspekte des Systems ist abhängig von - der Implementation des zugrunde liegenden Datenbanksystems. + Das Verhalten der dba-Funktionen ist teilweise abhängig von + der Implementation des zugrundeliegenden Datenbanksystems. Funktionen wie zum Beispiel <function>dba_optimize</function> - und <function>dba_sync</function> funktionieren wie angepriesen mit - der einen Datenbank und versagen ihren Dienst mit Anderen. + und <function>dba_sync</function> funktionieren vielleicht bei + einer Datenbank, und tun gar nichts bei einer Anderen. </para> <para> - Um Unterstützung für einen der folgenden Handler - verfügbar zu machen, fügen Sie bitte den jeweils angegebenen - --with Kompilerschalter in ihre PHP Konfigurationszeile ein: - <itemizedlist> - <listitem> - <simpara> - Dbm ist der älteste und der original Typ der Datenbanken - im Berkeley DB Stil. Sie sollten dieses System wenn möglich - vermeiden. - Wir ünterstützen nicht die Kompatibilitätsfunktionen, - die in DB2 und gdbm enthalten sind, da sie nur auf - Quellcode Basis kompatibel sind und nicht mit dem original dbm - Format arbeiten können. (--with-dbm) - </simpara> - </listitem> - <listitem> - <simpara> - Ndbm ist neuer und flexibler als Dbm. Es hat jedoch immer noch - die meisten Einschränkungen von Dbm und ist daher ebenfalls - nicht empfehlenswert. (--with-ndbm) - </simpara> - </listitem> - <listitem> - <simpara> - Gdbm ist der <ulink url="&url.gdbm;">GNU Datenbank Manager</ulink>. - (--with-gdbm) - </simpara> - </listitem> - <listitem> - <simpara> - DB2 ist <ulink url="&url.sleepycat;">Sleepycat Software's - DB2</ulink>. Es wird beschrieben als "Werkzeugsatz, der - schnell verfügbaren eingebauten Datenbank Support sowohl - für Einzel- als auch für Client/Server- Applikationen - zur Verfügung stellt." (--with-db2) - </simpara> - </listitem> - <listitem> - <simpara> - DB3 ist <ulink url="&url.sleepycat;">Sleepycat Software's - DB3</ulink>. (--with-db3) - </simpara> - </listitem> - <listitem> - <simpara> - Cdb ist "ein schnelles, zuverlässiges und kompaktes - Paket zum Erstellen und Auslesen konstanter Datenbanken." - Es stammt vom Autor von qmail und kann <ulink url="&url.cdb;"> - hier</ulink> heruntergeladen werden. Da es ein konstantes - System ist, werden nur Lese-Operationen unterstützt. - (--with-cdb) - </simpara> - </listitem> - </itemizedlist> + Beim Aufruf von <function>dba_open</function> oder + <function>dba_popen</function> muss einer der verfügbaren + Handler-Namen aus der nachfolgenden Handler-Tabelle angegeben + werden. Die tatsächlich verfügbaren Handler in + Ihrer PHP-Installation können Sie mit der Funktion + <function>phpinfo</function> anzeigen lassen. (Um zum + Zeitpunkt der PHP-Generierung die Unterstützung für + einen der folgenden Handler verfügbar zu machen, + fügen Sie bitte den jeweils angegebenen + <literal>--with-XXXX</literal> Compilerschalter in ihren + PHP-Konfigurations-Aufruf ein.) + <table> + <title>Liste der DBA-Handler</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Handler</entry> + <entry>Hinweise</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>dbm</literal></entry> + <entry> + Dbm ist der ursprüngliche und älteste Typ der + "Berkeley DB" Datenbanken. Sie sollten diesen Typ + wenn möglich vermeiden. + Die in DB2 und gdbm enthaltenen dbm-Kompatibilitätsfunktionen + werden ebenfalls nicht unterstützt, da sie nur auf + Quellcode-Basis kompatibel sind, aber Dateien im originalen + dbm-Format nicht bearbeiten können. + (<literal>--with-dbm</literal>) + </entry> + </row> + + <row> + <entry><literal>ndbm</literal></entry> + <entry> + Ndbm ist neuer und flexibler als Dbm. Es hat jedoch + die meisten Einschränkungen von Dbm übernommen + und ist daher ebenfalls nicht empfehlenswert. + (<literal>--with-ndbm</literal>) + </entry> + </row> + + <row> + <entry><literal>gdbm</literal></entry> + <entry> + Gdbm ist der <ulink url="&url.gdbm;">GNU Datenbank Manager</ulink>. + (<literal>--with-gdbm</literal>) + </entry> + </row> + + <row> + <entry><literal>db2</literal></entry> + <entry> + DB2 ist <ulink url="&url.sleepycat;">Sleepycat Software's + DB2</ulink>. Es wird beschrieben als "Werkzeugsatz für + eingebaute Unterstützung von Hochleistungs-Datenbanken + für Standalone- und Client/Server- Applikationen". + (<literal>--with-db2</literal>) + </entry> + </row> + + <row> + <entry><literal>db3</literal></entry> + <entry> + DB3 ist <ulink url="&url.sleepycat;">Sleepycat Software's + DB3</ulink>. (<literal>--with-db3</literal>) + </entry> + </row> + + <row> + <entry><literal>cdb</literal></entry> + <entry> + Cdb ist "ein schnelles, zuverlässiges und kompaktes + Paket zum Erstellen und Auslesen konstanter Datenbanken." + Es stammt vom Autor von qmail und kann <ulink url="&url.cdb;"> + hier</ulink> heruntergeladen werden. Da es für konstante + Daten ausgelegt ist, werden nur Lese-Operationen unterstützt. + (<literal>--with-cdb</literal>) + </entry> + </row> + + </tbody> + </tgroup> + </table> </para> <para> <example> @@ -107,22 +141,22 @@ </para> <para> DBA arbeitet binärsicher und besitzt keine willkürlichen Limits. - Es vererbt alle Einschränkungen von der Datenbank Implementation, die - ihm zugrunde liegt. + Es erbt allerdings alle Einschränkungen von der + zugrundeliegenden Datenbank-Implementation. </para> <para> - Alle textbasierten Datenbanken müssen einen Weg zur + Alle dateibasierten Datenbanken müssen einen Weg zur Verfügung stellen, um den Dateimodus einer neu erstellten Datenbank zu bestimmen, soweit dies überhaupt möglich ist. - Der Dateimodus wird für gewöhnlich als viertes Argument + Der Dateimodus wird gewöhnlich als viertes Argument an die Funktionen <function>dba_open</function> oder <function>dba_popen</function> übergeben. </para> <para> - Sie können auf alle Einträge in einer Datenbank auf - linearem Weg durch die Verwendung von <function>dba_firstkey</function> + Sie können auf alle Einträge in einer Datenbank + sequentiell durch die Verwendung von <function>dba_firstkey</function> und <function>dba_nextkey</function> zugreifen. Während die - Datenbank so durchlaufen wird, kann sie nicht verändert werden. + Datenbank so durchlaufen wird, darf sie nicht verändert werden. </para> <para> <example> @@ -130,7 +164,7 @@ <programlisting role="php"> <?php -# ...oeffnen der Datenbank... +# ...Oeffnen der Datenbank... $key = dba_firstkey ($id); @@ -153,7 +187,7 @@ <refentry id="function.dba-close"> <refnamediv> <refname>dba_close</refname> - <refpurpose>Datenbank schliessen</refpurpose> + <refpurpose>Datenbank schließen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -164,16 +198,16 @@ </funcprototype> </funcsynopsis> <para> - <function>Dba_close</function> schliesst die aufgebaute - Verbindung zur Datenbank, die durch <parameter>handle</parameter> - festgelegt wird, und gibt alle Resourcen wieder frei. + <function>dba_close</function> schließt die offene + Datenbank, die durch <parameter>handle</parameter> + festgelegt wird, und gibt alle zugehörigen Ressourcen frei. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>Dba_close</function> besitzt keinen Rückgabewert. + <function>dba_close</function> besitzt keinen Rückgabewert. </para> <para> Siehe auch <function>dba_open</function> und @@ -185,35 +219,35 @@ <refentry id="function.dba-delete"> <refnamediv> <refname>dba_delete</refname> - <refpurpose>Löschen des durch key festgelegten Eintrages</refpurpose> + <refpurpose>Löschen des zu key gehörigen Eintrages</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>dba_delete</function></funcdef> + <funcdef>bool <function>dba_delete</function></funcdef> <paramdef>string <parameter>key</parameter></paramdef> <paramdef>int <parameter>handle</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>dba_delete</function> löscht den Eintrag, der - durch <parameter>key</parameter> festgelegt ist, aus der - Datenbank, die mit <parameter>handle</parameter> spezifiziert - ist. + <function>dba_delete</function> löscht den Eintrag mit dem + Schlüsel <parameter>key</parameter> aus der durch + <parameter>handle</parameter> spezifizierten Datenbank. </para> <para> <parameter>key</parameter> ist der Schlüssel des Eintrags, der gelöscht wird. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>dba_delete</function> hat als Rückgabewert true - oder false, abhängig davon, ob der Eintrag gelöscht - wurde oder nicht. + <function>dba_delete</function> hat als Rückgabewert + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob der Löschvorgang erfolgreich war + oder nicht. </para> <para> Siehe auch <function>dba_exists</function>, @@ -226,7 +260,7 @@ <refentry id="function.dba-exists"> <refnamediv> <refname>dba_exists</refname> - <refpurpose>Überprüfen, ob key existiert</refpurpose> + <refpurpose>Überprüfen, ob Datensatz mit Schlüssel key existiert</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -238,21 +272,23 @@ </funcprototype> </funcsynopsis> <para> - <function>Dba_exists</function> überprüft, ob - <parameter>key</parameter> in der Datenbank, die durch - <parameter>handle</parameter> spezifiziert wird, existiert. + <function>dba_exists</function> überprüft, ob + ein Datensatz mit dem Schlüssel <parameter>key</parameter> + in der durch <parameter>handle</parameter> spezifizierten Datenbank + existiert. </para> <para> <parameter>Key</parameter> ist der Schlüssel, dessen Existenz überprüft werden soll. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>Dba_exists</function> hat als Rückgabewert true - oder false, abhängig davon, ob der Schlüssel gefunden + <function>dba_exists</function> hat als Rückgabewert + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob der Schlüssel gefunden wurde oder nicht. </para> <para> @@ -266,7 +302,7 @@ <refentry id="function.dba-fetch"> <refnamediv> <refname>dba_fetch</refname> - <refpurpose>Daten, die durch key festgelegt sind, auslesen</refpurpose> + <refpurpose>Datensatz für Schlüssel "key" auslesen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -278,25 +314,26 @@ </funcprototype> </funcsynopsis> <para> - <function>Dba_fetch</function> liest die Daten, die durch - <parameter>key</parameter> festgelegt, sind aus der - Datenbank, die durch <parameter>handle</parameter> spezifiziert - ist, aus. + <function>dba_fetch</function> liest die durch den Schlüssel + <parameter>key</parameter> festgelegten Daten + aus der durch <parameter>handle</parameter> spezifizierten + Datenbank aus. </para> <para> <parameter>Key</parameter> ist der Schlüssel, mit dem die Daten identifizert werden. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>Dba_fetch</function> hat als Rückgabewert - entweder den ausgelesenen String oder false, abhängig - davon, ob das Schlüssel/Wert Paar gefunden wurde oder - nicht. + <function>dba_fetch</function> hat als Rückgabewert + entweder den zum Schlüssel <parameter>key</parameter> + passenden Werte-String oder <literal>false</literal>, + abhängig davon, ob das Schlüssel/Wert-Paar + gefunden wurde oder nicht. </para> <para> Siehe auch <function>dba_exists</function>, @@ -309,7 +346,7 @@ <refentry id="function.dba-firstkey"> <refnamediv> <refname>dba_firstkey</refname> - <refpurpose>Ersten Schlüssel auslesen</refpurpose> + <refpurpose>Ersten Schlüssel bestimmen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -320,24 +357,26 @@ </funcprototype> </funcsynopsis> <para> - <function>Dba_firstkey</function> gibt den ersten Schlüssel - aus der Datenbank, die durch <parameter>handle</parameter> - spezifiziert wird, zurück und setzt den internen - Zähler zurück. Dies erlaubt eine lineare Suche durch + <function>dba_firstkey</function> gibt den ersten Schlüssel + aus der durch <parameter>handle</parameter> + spezifizierten Datenbank zurück und setzt den internen + Schlüssel-Zeiger zurück. Dies erlaubt in Verbindung mit + <function>dba_nextkey</function> eine sequentielle Suche durch die gesamte Datenbank. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>Dba_firstkey</function> hat als Rückgabewert - den Schlüssel oder false, abhängig davon, ob die - Aktion erfolgreich war oder fehlschlug. + <function>dba_firstkey</function> liefert als Rückgabewert + den Schlüssel oder <literal>false</literal>, + abhängig davon, ob die Aktion erfolgreich war oder fehlschlug. </para> <para> Siehe auch - <function>Dba_nextkey</function> + <function>dba_nextkey</function> + und Beispiel 2 im <link linkend="ref.dba">DBA-Überblick</link> </para> </refsect1> </refentry> @@ -345,7 +384,7 @@ <refentry id="function.dba-insert"> <refnamediv> <refname>dba_insert</refname> - <refpurpose>Eintrag einfügen</refpurpose> + <refpurpose>Datensatz einfügen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -358,10 +397,10 @@ </funcprototype> </funcsynopsis> <para> - <function>dba_insert</function> fügt den Eintrag, der + <function>dba_insert</function> fügt den Datensatz, der durch <parameter>key</parameter> und <parameter>value</parameter> - beschrieben wird in die Datenbank, die durch - <parameter>handle</parameter> spezifiziert wird, ein. Die Aktion + beschrieben wird, in die durch <parameter>handle</parameter> + spezifizierte Datenbank ein. Die Aktion schlägt fehl, wenn es bereits einen Eintrag mit dem gleichen <parameter>key</parameter> in der Datenbank gibt. </para> @@ -374,12 +413,13 @@ werden soll. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>dba_insert</function> hat als Rückgabewert true - oder false, abhängig davon, ob die Aktion erfolgreich + <function>dba_insert</function> hat als Rückgabewert + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob die Aktion erfolgreich war oder nicht. </para> <para> @@ -395,7 +435,7 @@ <refentry id="function.dba-nextkey"> <refnamediv> <refname>dba_nextkey</refname> - <refpurpose>Nächsten Schlüssel auslesen</refpurpose> + <refpurpose>Nachfolgenden Schlüssel bestimmen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -406,23 +446,24 @@ </funcprototype> </funcsynopsis> <para> - <function>dba_nextkey</function> gibt den nächsten - Schlüssel aus der Datenbank, die durch - <parameter>handle</parameter> spezifiziert wird, zurück - und erhöht den internen Schlüsselzähler um eins. + <function>dba_nextkey</function> gibt den nachfolgenden + Schlüssel aus der durch + <parameter>handle</parameter> spezifizierten Datenbank zurück + und erhöht den internen Schlüssel-Zeiger. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> <function>dba_nextkey</function> hat als Rückgabewert den - Schlüssel oder false, abhängig davon, ob die Aktion - erfolgreich war oder nicht. + Schlüssel oder <literal>false</literal>, + abhängig davon, ob die Aktion erfolgreich war oder nicht. </para> <para> Siehe auch <function>dba_firstkey</function> + und Beispiel 2 im <link linkend="ref.dba">DBA-Überblick</link> </para> </refsect1> </refentry> @@ -430,7 +471,7 @@ <refentry id="function.dba-popen"> <refnamediv> <refname>dba_popen</refname> - <refpurpose>Persistene Verbindung zu einer Datenbank öffnen</refpurpose> + <refpurpose>Persistente Datenbank-Verbindung öffnen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -447,28 +488,69 @@ <para> <function>dba_popen</function> stellt eine persistente Datenbankinstanz für <parameter>path</parameter> mit - <parameter>mode</parameter> her und benutzt dabei + <parameter>mode</parameter> her und benutzt dabei den Handler <parameter>handler</parameter>. </para> <para> - <parameter>path</parameter> ist für gewöhnlich ein + <parameter>path</parameter> ist ein gültiger Pfad in Ihrem Dateisystem. </para> <para> - <parameter>mode</parameter> ist "r" für Lesezugriff, - "w" für Lese- und Schreibzugriff, "c" für Lese- - und Schreibzugriff und die Möglichkeit, die - Datenbank zu erstellen, falls sie nicht existiert, und "n" - ist für Erstellen, Bearbeiten und Lese- und Schreibzugriff. + Das <parameter>mode</parameter> Argument beschreibt den Modus, + mit dem die Datenbank geöffnet werden soll. + Es gibt 4 Möglichkeiten, eine DBA Datenbank zu öffnen: + <variablelist> + <varlistentry> + <term>"r" (read-only)</term> + <listitem><para> + Eine existierende Datenbank soll nur lesend + geöffnet werden.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"n" (new)</term> + <listitem><para> + Eine neue Datenbank soll angelegt werden. + Diese wird automatisch als read-write geöffnet. + Eine existierende Datenbank wird inhaltlich + gelöscht.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"c" (create)</term> + <listitem><para> + Eine neue Datenbank soll angelegt werden. + Diese wird automatisch als read-write geöffnet. + Im Gegensatz zu "n" wird eine bereits existierende + Datenbank inhaltlich nicht gelöscht, sondern nur + für Lese- und Schreibzugriff geöffnet.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"w" (read-write)</term> + <listitem><para> + Eine existierende Datenbank soll lesend und + schreibend geöffnet werden.</para> + </listitem> + </varlistentry> + </variablelist> </para> <para> - <parameter>handler</parameter> ist der Name des Handlers, der für + <parameter>handler</parameter> ist der + <link linkend="ref.dba">Name des Handlers</link>, der für den Zugriff auf <parameter>path</parameter> benutzt werden soll. + Die (oben durch <parameter><optional>...</optional></parameter> + gekennzeichneten) optionalen Argumente der Funktion + <function>dba_popen</function> werden an ihn übergeben. </para> <para> - <function>dba_popen</function> hat als Rückgabewert eine - positive Handler ID oder false, abhängig davon, ob - die Verbindung hergestellt werden konnte oder nicht. + <function>dba_popen</function> liefert als Rückgabewert eine + positive Zugriffs-"handle" oder <literal>false</literal>, + abhängig davon, ob die Verbindung hergestellt werden + konnte oder nicht. </para> <para> Siehe auch @@ -500,24 +582,65 @@ her und benutzt dabei <parameter>handler</parameter>. </para> <para> - <parameter>path</parameter> ist für gewöhnlich ein + <parameter>path</parameter> ist ein gültiger Pfad in Ihrem Dateisystem. </para> <para> - <parameter>mode</parameter> ist "r" für Lesezugriff, - "w" für Lese- und Schreibzugriff, "c" für Lese- - und Schreibzugriff und die Möglichkeit, die - Datenbank zu erstellen, falls sie nicht existiert, und "n" - ist für Erstellen, Bearbeiten und Lese- und Schreibzugriff. + Das <parameter>mode</parameter> Argument beschreibt den Modus, + mit dem die Datenbank geöffnet werden soll. + Es gibt 4 Möglichkeiten, eine DBA Datenbank zu öffnen: + <variablelist> + <varlistentry> + <term>"r" (read-only)</term> + <listitem><para> + Eine existierende Datenbank soll nur lesend + geöffnet werden.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"n" (new)</term> + <listitem><para> + Eine neue Datenbank soll angelegt werden. + Diese wird automatisch als read-write geöffnet. + Eine existierende Datenbank wird inhaltlich + gelöscht.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"c" (create)</term> + <listitem><para> + Eine neue Datenbank soll angelegt werden. + Diese wird automatisch als read-write geöffnet. + Im Gegensatz zu "n" wird eine bereits existierende + Datenbank inhaltlich nicht gelöscht, sondern nur + für Lese- und Schreibzugriff geöffnet.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>"w" (read-write)</term> + <listitem><para> + Eine existierende Datenbank soll lesend und + schreibend geöffnet werden.</para> + </listitem> + </varlistentry> + </variablelist> </para> <para> - <parameter>handler</parameter> ist der Name des Handlers, der für + <parameter>handler</parameter> ist der + <link linkend="ref.dba">Name des Handlers</link>, der für den Zugriff auf <parameter>path</parameter> benutzt werden soll. + Die (oben durch <parameter><optional>...</optional></parameter> + gekennzeichneten) optionalen Argumente der Funktion + <function>dba_open</function> werden an ihn übergeben. </para> <para> - <function>dba_open</function> hat als Rückgabewert eine - positive Handler ID oder false, abhängig davon, ob - die Verbindung hergestellt werden konnte oder nicht. + <function>dba_open</function> liefert als Rückgabewert eine + positive Zugriffs-"handle" oder <literal>false</literal>, + abhängig davon, ob die Verbindung hergestellt werden + konnte oder nicht. </para> <para> Siehe auch @@ -546,12 +669,13 @@ spezifiziert wird. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> <function>dba_optimize</function> hat als Rückgabewert - true oder false, abhängig davon, ob die Optimierung + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob die Optimierung erfolgreich war oder ob sie fehlschlug. </para> <para> @@ -564,7 +688,7 @@ <refentry id="function.dba-replace"> <refnamediv> <refname>dba_replace</refname> - <refpurpose>Ersetzen oder Einfügen eines Eintrags</refpurpose> + <refpurpose>Datensatz ersetzen oder einfügen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -578,10 +702,10 @@ </funcsynopsis> <para> <function>dba_replace</function> ersetzt oder fügt - einen Eintrag, der durch <parameter>key</parameter> und - <parameter>value</parameter> beschrieben wird, in die - Datenbank, die durch <parameter>handle</parameter> - spezifiziert wird, ein. + in der durch <parameter>handle</parameter> + spezifizierten Datenbank einen Datensatz ein, + der durch den Schlüssel <parameter>key</parameter> und + den Wert <parameter>value</parameter> beschrieben wird. </para> <para> <parameter>key</parameter> ist der Schlüssel des Eintrags, @@ -592,13 +716,13 @@ werden soll. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> - <function>dba_replace</function> hat als Rückgabewert - true oder false, abhängig davon, ob die Aktion erfolgreich - war oder nicht. + <function>dba_replace</function> liefert als Rückgabewert + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob die Aktion erfolgreich war oder nicht. </para> <para> Siehe auch <function>dba_exists</function>, @@ -629,13 +753,13 @@ dies unterstützt wird. </para> <para> - <parameter>handle</parameter> ist ein Datenbankhandle das von - <function>dba_open</function> zurückgegeben wird. + <parameter>handle</parameter> ist ein Datenbankhandle, das von + <function>dba_open</function> zurückgegeben wurde. </para> <para> <function>dba_sync</function> hat als Rückgabewert - true oder false, abhängig davon, ob die Aktion erfolgreich - war oder nicht. + <literal>true</literal> oder <literal>false</literal>, + abhängig davon, ob die Aktion erfolgreich war oder nicht. </para> <para> Siehe auch <function>dba_optimize</function>