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>
