cvs: phpdoc /de/functions dbm.xml

From: Date: Tue, 10 Oct 2000 13:47:04 +0000
Subject: cvs: phpdoc /de/functions dbm.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969332419@lists.php.net to get a copy of this message
martin Tue Oct 10 06:47:04 2000 EDT Modified files: /phpdoc/de/functions dbm.xml Log: German translation for DBM functions contributed by <Holger.Schranz@Fujitsu-Siemens.com> Index: phpdoc/de/functions/dbm.xml diff -u phpdoc/de/functions/dbm.xml:1.3 phpdoc/de/functions/dbm.xml:1.4 --- phpdoc/de/functions/dbm.xml:1.3 Sat Jun 24 00:38:42 2000 +++ phpdoc/de/functions/dbm.xml Tue Oct 10 06:47:04 2000 @@ -1,38 +1,43 @@ <reference id="ref.dbm"> - <title>dbm functions</title> + <title>DBM Datenbankfunktionen</title> <titleabbrev>DBM</titleabbrev> <partintro> - <simpara> - These functions allow you to store records stored in a dbm-style - database. This type of database (supported by the Berkeley db, - gdbm, and some system libraries, as well as a built-in flatfile - library) stores key/value pairs (as opposed to the full-blown - records supported by relational databases).</simpara> - <para> - <example> - <title>dbm example</title> - <programlisting role="php"> -$dbm = dbmopen("lastseen", "w"); -if (dbmexists($dbm, $userid)) { - $last_seen = dbmfetch($dbm, $userid); + <simpara> + Diese Funktionen erlauben Ihnen den Zugriff auf Datensätze die + im DBM-Format vorliegen. + + Im Gegensatz zu den relationalen Datenbanken (mySQL, etc.) + werden die Datensätze in Form von ISAM-Sätzen gespeichert. + DBM Datenbanken werden von verschiedenen Systemfunktionen als + interne Arbeitsbibliothek benützt. Diese Datenbank-Art wird + auch von der Berkeley DB und GDBM verwendet. + </simpara> + <para> + <example> + <title>Beispiel für ein DBM Script</title> + <programlisting role="php"> +$dbm = dbmopen ("lastseen", "w"); +if (dbmexists ($dbm, $userid)) { + $last_seen = dbmfetch ($dbm, $userid); } else { - dbminsert($dbm, $userid, time()); + dbminsert ($dbm, $userid, time()); } do_stuff(); -dbmreplace($dbm, $userid, time()); -dbmclose($dbm); -</programlisting></example> - </para> +dbmreplace ($dbm, $userid, time()); +dbmclose ($dbm); + </programlisting> + </example> + </para> </partintro> <refentry id="function.dbmopen"> <refnamediv> <refname>dbmopen</refname> - <refpurpose>opens a dbm database</refpurpose> + <refpurpose>Öffnen einer DBM Datenbank</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>int <function>dbmopen</function></funcdef> @@ -41,34 +46,84 @@ </funcprototype> </funcsynopsis> <para> - The first argument is the full-path filename of the dbm file to be opened - and the second is the file open mode which is one of "r", "n", "c" or "w" - for read-only, new (implies read-write, and most likely will truncate an - already-existing database of the same name), create (implies read-write, - and will not truncate an already-existing database of the same name) - and read-write respectively.</para> - <para> - Returns an identifer to be passed to the other dbm functions on success, - or false on failure.</para> - <para> - If ndbm support is used, ndbm will actually create filename.dir and - filename.pag files. gdbm only uses one file, as does the internal flat-file - support, and Berkeley db creates a filename.db file. Note that PHP does its - own file locking in addition to any file locking that may be done by the dbm - library itself. PHP does not delete the .lck files it creates. It uses these - files simply as fixed inodes on which to do the file locking. For more - information on dbm files, see your Unix man pages, or obtain GNU's gdbm from - <filename role="url">ftp://prep.ai.mit.edu/pub/gnu</filename>.</para> + Das erste Argument ist der vollqualifizierte Dateiname der DBM Datenbank, + die geöffnet werden soll. Das zweite Argument ist der Modus, + mit dem die DBM Datenbank geöffnet werden soll. + Es gibt 4 Möglichkeiten, eine DBM 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 + "read-writeable" gö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> + Wenn die angegebene DBM Datenbank geöffnet werden konnte, + wird ein Identifier zurückgegeben. Dieser Identifier muss + für alle weiteren Aufrufe, die an die DBM Datenbank getätigt + werden, mitgegeben werden. + Wenn das Öffenen der DBM Datenbank fehlgeschlagen ist, + wird das Ergebnis FALSE zurückgegeben. + </para> + <para> + Wenn die NDBM Unterstützung aktiviert wird, werden jeweils + zwei Dateien <filename>filename.dir</filename> und + <filename>filename.pag</filename> erzeugt. GDBM, ebenso wie + der interne "Flat-File" Mechanismus und die Berkeley DB, + verwenden nur eine Datei (und diese heisst bei der Berkeley + DB <filename>filename.db</filename>). + + Bitte beachten Sie, dass PHP seine Dateisperren zusätzlich + zu den vorhanden DBM-Bibliothekseigenen Routinen verwendet. + PHP löscht auch die <filename>.lck</filename> Dateien nicht + wieder. Es verwendet diese Datei nur als zusätzliches + Mittel für Dateilocking. Wenn Sie mehr über + DBM-Datenbanken wissen wollen, sehen Sie in den + UNIX-Manualseiten nach, oder schauen bei <ulink + url="&url.gdbm;">GNU's GDBM</ulink> nach. + </para> </refsect1> </refentry> <refentry id="function.dbmclose"> <refnamediv> <refname>dbmclose</refname> - <refpurpose>closes a dbm database</refpurpose> + <refpurpose>Schließen einer DBM Datenbank</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>dbmclose</function></funcdef> @@ -76,17 +131,25 @@ </funcprototype> </funcsynopsis> <para> - Unlocks and closes the specified database.</para> + Gibt Zugiffssperren auf Datensätze frei und schließt die angegebene + DBM Datenbank. + </para> + <para> + Liefert TRUE bei Erfolg bzw. FALSE bei Fehler. + </para> </refsect1> </refentry> <refentry id="function.dbmexists"> <refnamediv> <refname>dbmexists</refname> - <refpurpose>tells if a value exists for a key in a dbm database</refpurpose> + <refpurpose> + Prüft, ob ein Eintrag für den angegebenen Schlüssel + in der DBM Datenbank vorhanden ist. + </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>dbmexists</function></funcdef> @@ -95,17 +158,23 @@ </funcprototype> </funcsynopsis> <para> - Returns true if there is a value associated with the <parameter>key</parameter>.</para> + Wenn in der DBM Datenbank ein Eintrag mit dem angegebenen Schlüssel + <parameter>key</parameter> vorhanden ist, wird als Ergebnis + TRUE zurückgegeben. + </para> </refsect1> </refentry> <refentry id="function.dbmfetch"> <refnamediv> <refname>dbmfetch</refname> - <refpurpose>fetches a value for a key from a dbm database</refpurpose> + <refpurpose> + Holt einen Datensatz mit dem angegebenen Schlüssel + aus der DBM Datenbank. + </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>string <function>dbmfetch</function></funcdef> @@ -114,17 +183,22 @@ </funcprototype> </funcsynopsis> <para> - Returns the value associated with <parameter>key</parameter>.</para> + Liefert den Datensatz, der dem <parameter>key</parameter> in der + DBM Datenbank entspricht. + </para> </refsect1> </refentry> <refentry id="function.dbminsert"> <refnamediv> <refname>dbminsert</refname> - <refpurpose>inserts a value for a key in a dbm database</refpurpose> + <refpurpose> + Schreibt einen Datensatz mit dem angegebenen Schlüssel + in die DBM Datenbank. + </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>int <function>dbminsert</function></funcdef> @@ -133,22 +207,44 @@ <paramdef>string <parameter>value</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Adds the value to the database with the specified key.</para> <para> - Returns -1 if the database was opened read-only, 0 if the insert - was successful, and 1 if the specified key already exists. (To replace - the value, use <function>dbmreplace</function>.)</para> + Schreibt den Datensatz mit angegebenen Schlüssel in die + Datenbank. + </para> + <para> + Ergebniswerte: + <variablelist> + <varlistentry> + <term>-1</term> + <listitem><simpara>nur Leseberechtigung.</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>0</term> + <listitem><simpara>Aktion erfolgreich beendet.</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>1</term> + <listitem><simpara>Ein Eintrag mit dem angegebenen Schlüssel + existiert bereits in der Datenbank.</simpara> + </listitem> + </varlistentry> + </variablelist> + </para> </refsect1> </refentry> <refentry id="function.dbmreplace"> <refnamediv> <refname>dbmreplace</refname> - <refpurpose>replaces the value for a key in a dbm database</refpurpose> + <refpurpose> + Ersetzt einen Datensatz mit dem angegebenen Schlüssel + in der DBM Datenbank. + </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>dbmreplace</function></funcdef> @@ -158,20 +254,27 @@ </funcprototype> </funcsynopsis> <para> - Replaces the value for the specified key in the database.</para> - <para> - This will also add the key to the database if it didn't already - exist.</para> + Schreibt einen Datensatz mit dem angegebenen Satzschlüssel in + die Datenbank bzw. ersetzt ihn. + </para> + <para> + Wenn ein Eintrag mit den angegebenen Schlüssel vorhanden ist, + wird dieser überschrieben. Ansonsten wird ein Datensatz mit + mit den Schlüssel neu angelegt. + </para> </refsect1> </refentry> <refentry id="function.dbmdelete"> <refnamediv> <refname>dbmdelete</refname> - <refpurpose>deletes the value for a key from a dbm database</refpurpose> + <refpurpose> + Löscht einen Datensatz mit dem angegebenen Schlüssel + aus der DBM Datenbank. + </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>dbmdelete</function></funcdef> @@ -179,20 +282,26 @@ <paramdef>string <parameter>key</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Deletes the value for <parameter>key</parameter> in the database.</para> <para> - Returns false if the key didn't exist in the database.</para> + Löscht einen vorhanden Datensatz, der dem + <parameter>key</parameter> entspricht, aus der Datenbank. + </para> + <para> + Wenn kein Datensatz zum Löschen gefunden wurde, wird der + Returncode FALSE zurückgegeben. + </para> </refsect1> </refentry> <refentry id="function.dbmfirstkey"> <refnamediv> <refname>dbmfirstkey</refname> - <refpurpose>retrieves the first key from a dbm database</refpurpose> + <refpurpose> + Gibt den ersten Schlüssel der DBM Datenbank zurück. + </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>string <function>dbmfirstkey</function></funcdef> @@ -200,19 +309,24 @@ </funcprototype> </funcsynopsis> <para> - Returns the first key in the database. Note that no particular order - is guaranteed since the database may be built using a hash-table, - which doesn't guarantee any ordering.</para> + Gibt den ersten Schlüssel der DBM Datenbank zurück. + </para> + <note><para>Achtung: Es gibt keine Garantie für eine bestimmte Reihenfolge + innerhalb der Datenbank, da die Datenbank auf einen + Hash-Algorithmus aufgebaut ist. + </para></note> </refsect1> </refentry> <refentry id="function.dbmnextkey"> <refnamediv> <refname>dbmnextkey</refname> - <refpurpose>retrieves the next key from a dbm database</refpurpose> + <refpurpose> + Stellt den nächsten Schlüssel aus den Datenbank zur Verfügung. + </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>string <function>dbmnextkey</function></funcdef> @@ -221,30 +335,35 @@ </funcprototype> </funcsynopsis> <para> - Returns the next key after <parameter>key</parameter>. By calling - <function>dbmfirstkey</function> followed by successive - calls to <function>dbmnextkey</function> it is possible to - visit every key/value pair in the dbm database. For example: - <example> - <title>Visiting every key/value pair in a dbm database.</title> - <programlisting> -$key = dbmfirstkey($dbm_id); + Gibt den auf <parameter>key</parameter> folgenden Schlüssel + an den Aufrufer zurück. Um alle Schlüssel einer DBM Datenbank + auszulesen, wird <function>dbmfirstkey</function>, gefolgt von + wiederholten Aufrufen von <function>dbmnextkey</function> + verwendet, wie im folgenden Script: + <example> + <title>Ausgeben aller Schlüssel mit Datensätzen einer DBM Datenbank</title> + <programlisting role="php"> +$key = dbmfirstkey ($dbm_id); while ($key) { - echo "$key = " . dbmfetch($dbm_id, $key) . "\n"; - $key = dbmnextkey($dbm_id, $key); + echo "$key = " . dbmfetch ($dbm_id, $key) . "\n"; + $key = dbmnextkey ($dbm_id, $key); } </programlisting> - </example></para> + </example> + </para> </refsect1> </refentry> <refentry id="function.dblist"> <refnamediv> <refname>dblist</refname> - <refpurpose>describes the dbm-compatible library being used</refpurpose> + <refpurpose> + Liefert eine Beschreibung, welches DBM-Format + verwendet wird. + </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>string <function>dblist</function></funcdef> @@ -266,7 +385,7 @@ sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil -sgml-default-dtd-file:"../manual.ced" +sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil

« previous php.doc (#969332419) next »