cvs: phpdoc-de /reference/dba/functions dba-close.xml dba-delete.xml dba-exists.xml dba-fetch.xml dba-firstkey.xml dba-handlers.xml dba-insert.xml
dba-key-split.xml dba-list.xml dba-nextkey.xml dba-open.xml dba-optimize.xml dba-popen.xml dba-replace.xml dba-sync.xml

From: Date: Tue, 01 Jan 2008 16:13:30 +0000
Subject: cvs: phpdoc-de /reference/dba/functions dba-close.xml dba-delete.xml dba-exists.xml dba-fetch.xml dba-firstkey.xml dba-handlers.xml dba-insert.xml
dba-key-split.xml dba-list.xml dba-nextkey.xml dba-open.xml dba-optimize.xml dba-popen.xml dba-replace.xml dba-sync.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-2348@lists.php.net to get a copy of this message
samesch Tue Jan 1 16:13:30 2008 UTC Added files: /phpdoc-de/reference/dba/functions dba-handlers.xml dba-key-split.xml dba-list.xml Modified files: /phpdoc-de/reference/dba/functions dba-close.xml dba-delete.xml dba-exists.xml dba-fetch.xml dba-firstkey.xml dba-insert.xml dba-nextkey.xml dba-open.xml dba-optimize.xml dba-popen.xml dba-replace.xml dba-sync.xml Log: syncing with EN (Happy New Year)

http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-close.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-close.xml diff -u phpdoc-de/reference/dba/functions/dba-close.xml:1.7 phpdoc-de/reference/dba/functions/dba-close.xml:1.8 --- phpdoc-de/reference/dba/functions/dba-close.xml:1.7 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-close.xml Tue Jan 1 16:13:30 2008 @@ -1,35 +1,59 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-close" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_close</refname> - <refpurpose>Datenbank schließen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>void</type><methodname>dba_close</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <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 wurde. - </para> - <para> - <function>dba_close</function> besitzt keinen Rückgabewert. - </para> - <para> - Siehe auch <function>dba_open</function> und - <function>dba_popen</function> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.7 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-close" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_close</refname> + <refpurpose>Schließt eine DBA-Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>dba_close</methodname> + <methodparam><type>resource</type><parameter>Verbindungskennung</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_close</function> schließt die offene Datenbank und gibt alle + Ressourcen der angegebenen Datenbank-Verbindungskennung frei. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Verbindungskennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von <function>dba_open</function> + oder <function>dba_popen</function> zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_open</function></member> + <member><function>dba_popen</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-delete.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-delete.xml diff -u phpdoc-de/reference/dba/functions/dba-delete.xml:1.6 phpdoc-de/reference/dba/functions/dba-delete.xml:1.7 --- phpdoc-de/reference/dba/functions/dba-delete.xml:1.6 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-delete.xml Tue Jan 1 16:13:30 2008 @@ -1,44 +1,70 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-delete" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_delete</refname> - <refpurpose>Löschen des zu key gehörigen Eintrages</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>dba_delete</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_delete</function> löscht den Eintrag mit dem - Schlüssel <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 wurde. - </para> - <para> - <function>dba_delete</function> hat als Rückgabewert - &true; oder &false;, - abhängig davon, ob der Löschvorgang erfolgreich war - oder nicht. - </para> - <para> - Siehe auch <function>dba_exists</function>, - <function>dba_fetch</function>, <function>dba_insert</function>, - und <function>dba_replace</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-delete" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_delete</refname> + <refpurpose>Löscht den zum angegebenen Schlüssel gehörigen DBA-Eintrag</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_delete</methodname> + <methodparam><type>string</type><parameter>Schlüssel</parameter></methodparam> + <methodparam><type>resource</type><parameter>Verbindungskennung</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_delete</function> löscht den angegebenen Eintrag aus der + Datenbank. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Schlüssel</parameter></term> + <listitem> + <para> + Der Schlüssel des zu löschenden Eintrags. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Verbindungskennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von <function>dba_open</function> + oder <function>dba_popen</function> zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_exists</function></member> + <member><function>dba_fetch</function></member> + <member><function>dba_insert</function></member> + <member><function>dba_replace</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-exists.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-exists.xml diff -u phpdoc-de/reference/dba/functions/dba-exists.xml:1.6 phpdoc-de/reference/dba/functions/dba-exists.xml:1.7 --- phpdoc-de/reference/dba/functions/dba-exists.xml:1.6 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-exists.xml Tue Jan 1 16:13:30 2008 @@ -1,45 +1,70 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-exists" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_exists</refname> - <refpurpose>Überprüfen, ob Datensatz mit Schlüssel key existiert</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>dba_exists</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <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 wurde. - </para> - <para> - <function>dba_exists</function> hat als Rückgabewert - &true; oder &false;, - abhängig davon, ob der Schlüssel gefunden - wurde oder nicht. - </para> - <para> - Siehe auch <function>dba_fetch</function>, - <function>dba_delete</function>, <function>dba_insert</function>, - und <function>dba_replace</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-exists" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_exists</refname> + <refpurpose>Überprüft, ob ein angegebener Schlüssel existiert</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_exists</methodname> + <methodparam><type>string</type><parameter>Schlüssel</parameter></methodparam> + <methodparam><type>resource</type><parameter>Verbindungskennung</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_exists</function> überprüft, ob der angegebene + <parameter>Schlüssel</parameter> in der Datenbank existiert. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Schlüssel</parameter></term> + <listitem> + <para> + Der Schlüssel, für den die Überprüfung durchgeführt wird. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Verbindungskennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von <function>dba_open</function> + oder <function>dba_popen</function> zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt &true; zurück, falls der Schlüssel existiert und andernfalls &false;. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_delete</function></member> + <member><function>dba_fetch</function></member> + <member><function>dba_insert</function></member> + <member><function>dba_replace</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-fetch.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-fetch.xml diff -u phpdoc-de/reference/dba/functions/dba-fetch.xml:1.6 phpdoc-de/reference/dba/functions/dba-fetch.xml:1.7 --- phpdoc-de/reference/dba/functions/dba-fetch.xml:1.6 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-fetch.xml Tue Jan 1 16:13:30 2008 @@ -1,47 +1,123 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-fetch" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_fetch</refname> - <refpurpose>Datensatz für Schlüssel "key" auslesen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>dba_fetch</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <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 wurde. - </para> - - <para> - <function>dba_fetch</function> hat als Rückgabewert - entweder den zum Schlüssel <parameter>key</parameter> - passenden Werte-String oder &false;, - abhängig davon, ob das Schlüssel/Wert-Paar - gefunden wurde oder nicht. - </para> - <para> - Siehe auch <function>dba_exists</function>, - <function>dba_delete</function>, <function>dba_insert</function>, - und <function>dba_replace</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.10 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-fetch" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_fetch</refname> + <refpurpose>Liest die Daten zu einem angegebenen Schlüssel aus</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>dba_fetch</methodname> + <methodparam><type>string</type><parameter>Schlüssel</parameter></methodparam> + <methodparam><type>resource</type><parameter>Verbindungskennung</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>dba_fetch</methodname> + <methodparam><type>string</type><parameter>Schlüssel</parameter></methodparam> + <methodparam><type>int</type><parameter>überspringen</parameter></methodparam> + <methodparam><type>resource</type><parameter>Verbindungskennung</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_fetch</function> liest die durch + <parameter>Schlüssel</parameter> festgelegten Daten aus der durch + <parameter>Verbindungskennung</parameter> spezifizierten Datenbank aus. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Schlüssel</parameter></term> + <listitem> + <para> + Der Schlüssel, durch den die Daten bestimmt sind. + </para> + <note> + <para> + Wenn mit ini-Dateien gearbeitet wird, akzeptiert diese Funktion Arrays + als Schlüssel, wobei der Index 0 die Gruppe ist und der Index 1 der + Name des Wertes. Siehe <function>dba_key_split</function>. + </para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>überspringen</parameter></term> + <listitem> + <para> + Die Anzahl der Schlüssel-Wert-Paare, die bei cdb-Datenbanken ignoriert + werden sollen. Dieser Wert wird bei allen anderen Datenbanken, die + keine Unterstützung für mehrere Schlüssel mit dem selben Namen bieten, + ignoriert. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Verbindungskennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von <function>dba_open</function> + oder <function>dba_popen</function> zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Falls das Schlüssel/Wert-Paar gefunden wird, wird die zugehörige + Zeichenkette zurückgegeben, andernfalls &false;. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3</entry> + <entry> + Der Parameter <parameter>überspringen</parameter> steht zur Verfügung, + um die Fähigkeit von cdb zu unterstützen, mehrere Schlüssel mit dem + selben Namen haben zu können. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_exists</function></member> + <member><function>dba_delete</function></member> + <member><function>dba_insert</function></member> + <member><function>dba_replace</function></member> + <member><function>dba_key_split</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-firstkey.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-firstkey.xml diff -u phpdoc-de/reference/dba/functions/dba-firstkey.xml:1.6 phpdoc-de/reference/dba/functions/dba-firstkey.xml:1.7 --- phpdoc-de/reference/dba/functions/dba-firstkey.xml:1.6 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-firstkey.xml Tue Jan 1 16:13:30 2008 @@ -1,41 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-firstkey" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_firstkey</refname> - <refpurpose>Ersten Schlüssel bestimmen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>dba_firstkey</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <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 wurde. - </para> - <para> - <function>dba_firstkey</function> liefert als Rückgabewert - den Schlüssel oder &false;, - abhängig davon, ob die Aktion erfolgreich war oder fehlschlug. - </para> - <para> - Siehe auch - <function>dba_nextkey</function> - und Beispiel 2 im <link linkend="ref.dba">DBA-Ü;berblick</link> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-firstkey" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_firstkey</refname> + <refpurpose>Liefert den ersten Schlüssel</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>dba_firstkey</methodname> + <methodparam><type>resource</type><parameter>Verbindungskennung</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_firstkey</function> gibt den ersten Schlüssel aus der + Datenbank zurück und setzt den internen Schlüssel-Zeiger zurück. Dies + erlaubt eine sequentielle Suche durch die gesamte Datenbank. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Verbindungskennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von <function>dba_open</function> + oder <function>dba_popen</function> zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt bei Erfolg den Schlüssel zurück oder &false;, falls ein Fehler + auftrat. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_nextkey</function></member> + <member><function>dba_key_split</function></member> + <member>Beispiel 2 der <link linkend="dba.examples">DBA Beispiele</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-insert.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-insert.xml diff -u phpdoc-de/reference/dba/functions/dba-insert.xml:1.6 phpdoc-de/reference/dba/functions/dba-insert.xml:1.7 --- phpdoc-de/reference/dba/functions/dba-insert.xml:1.6 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-insert.xml Tue Jan 1 16:13:30 2008 @@ -1,54 +1,83 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-insert" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_insert</refname> - <refpurpose>Datensatz einfügen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>dba_insert</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>string</type><parameter>value</parameter></methodparam> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_insert</function> fügt den Datensatz, der - durch <parameter>key</parameter> und <parameter>value</parameter> - 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> - <para> - <parameter>key</parameter> ist der Schlüssel des Eintrags, - der eingefügt werden soll. - </para> - <para> - <parameter>value</parameter> ist der Wert, der eingefügt - werden soll. - </para> - <para> - <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 - war oder nicht. - </para> - <para> - Siehe auch - <function>dba_exists</function> - <function>dba_delete</function> - <function>dba_fetch</function> - <function>dba_replace</function> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-insert" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_insert</refname> + <refpurpose>Fügt einen Eintrag ein</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_insert</methodname> + <methodparam><type>string</type><parameter>Schlüssel</parameter></methodparam> + <methodparam><type>string</type><parameter>Wert</parameter></methodparam> + <methodparam><type>resource</type><parameter>Verbindungskennung</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_insert</function> fügt den Eintrag, der durch + <parameter>Schlüssel</parameter> und <parameter>Wert</parameter> + beschrieben wird, in die Datenbank ein. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Schlüssel</parameter></term> + <listitem> + <para> + Der Schlüssel des einzufügenden Eintrags. Die Aktion schlägt fehl, wenn + es den Schlüssel schon in der Datenbank gibt. Verwenden Sie + <function>dba_replace</function>, falls Sie einen vorhandenen Schlüssel + ersetzen wollen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Wert</parameter></term> + <listitem> + <para> + Der Wert, der eingefügt werden soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Verbindungskennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von <function>dba_open</function> + oder <function>dba_popen</function> zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_exists</function></member> + <member><function>dba_delete</function></member> + <member><function>dba_fetch</function></member> + <member><function>dba_replace</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-nextkey.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-nextkey.xml diff -u phpdoc-de/reference/dba/functions/dba-nextkey.xml:1.6 phpdoc-de/reference/dba/functions/dba-nextkey.xml:1.7 --- phpdoc-de/reference/dba/functions/dba-nextkey.xml:1.6 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-nextkey.xml Tue Jan 1 16:13:30 2008 @@ -1,39 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-nextkey" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_nextkey</refname> - <refpurpose>Nachfolgenden Schlüssel bestimmen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>dba_nextkey</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <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 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. - </para> - <para> - Siehe auch - <function>dba_firstkey</function> - und Beispiel 2 im <link linkend="ref.dba">DBA-Überblick</link> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-nextkey" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_nextkey</refname> + <refpurpose>Liefert den nachfolgenden Schlüssel</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>dba_nextkey</methodname> + <methodparam><type>resource</type><parameter>Verbindungskennung</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_nextkey</function> gibt den nachfolgenden Schlüssel aus der + Datenbank zurück und erhöht den internen Schlüssel-Zeiger. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Verbindungskennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von <function>dba_open</function> + oder <function>dba_popen</function> zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt bei Erfolg den Schlüssel zurück oder &false;, falls ein Fehler + auftrat. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_firstkey</function></member> + <member><function>dba_key_split</function></member> + <member>Beispiel 2 der <link linkend="dba.examples">DBA Beispiele</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-open.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-open.xml diff -u phpdoc-de/reference/dba/functions/dba-open.xml:1.6 phpdoc-de/reference/dba/functions/dba-open.xml:1.7 --- phpdoc-de/reference/dba/functions/dba-open.xml:1.6 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-open.xml Tue Jan 1 16:13:30 2008 @@ -1,93 +1,244 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-open" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_open</refname> - <refpurpose>Verbindung zu einer Datenbank öffnen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>dba_open</methodname> - <methodparam><type>string</type><parameter>path</parameter></methodparam> - <methodparam><type>string</type><parameter>mode</parameter></methodparam> - <methodparam><type>string</type><parameter>handler</parameter></methodparam> - <methodparam choice="opt"><parameter>...</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_open</function> stellt eine Datenbankinstanz - für <parameter>path</parameter> mit <parameter>mode</parameter> - her und benutzt dabei <parameter>handler</parameter>. - </para> - <para> - <parameter>path</parameter> ist ein - gültiger Pfad in Ihrem Dateisystem. - </para> - <para> - 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 - <link linkend="ref.dba">Name des Handlers</link>, der für - den Zugriff auf <parameter>path</parameter> benutzt werden soll. - Die (oben durch <parameter>...</parameter> - gekennzeichneten) optionalen Argumente der Funktion - <function>dba_open</function> werden an ihn übergeben. - </para> - <para> - <function>dba_open</function> liefert als Rückgabewert eine - positive Zugriffs-"handle" oder &false;, - abhängig davon, ob die Verbindung hergestellt werden - konnte oder nicht. - </para> - <para> - Siehe auch - <function>dba_popen</function> - <function>dba_close</function> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.20 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-open" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_open</refname> + <refpurpose>Öffnet eine Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>dba_open</methodname> + <methodparam><type>string</type><parameter>Pfad</parameter></methodparam> + <methodparam><type>string</type><parameter>Modus</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>Handler</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_open</function> stellt eine Datenbankinstanz für + <parameter>Pfad</parameter> mit <parameter>Modus</parameter> her und + benutzt dabei <parameter>Handler</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Pfad</parameter></term> + <listitem> + <para> + Ein gültiger Pfad in Ihrem Dateisystem. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Modus</parameter></term> + <listitem> + <para> + Das ist <literal>r</literal> für lesenden Zugriff, <literal>w</literal> + für lesenden und schreibenden Zugriff auf eine existierende Datenbank, + <literal>c</literal> für lesenden und schreibenden Zugriff und + Erstellen der Datenbank, falls sie noch nicht existiert und + <literal>n</literal> für das Erstellen einer Datenbank, bzw. deren + Zurücksetzen auf die Größe 0, falls sie schon existiert und lesenden + und schreibenden Zugriff. + </para> + <para> + Zusätzlich können Sie mit dem nächsten Buchstaben die + Datenbank-Sperrmethode festlegen. Verwenden Sie <literal>l</literal> + um die Datenbank mit einer <filename>.lck</filename>-Datei zu sperren + oder <literal>d</literal> um die Datenbank-Datei selbst zu sperren. Es + ist wichtig, dass alle Ihre Anwendungen das einheitlich machen. + </para> + <para> + Falls Sie den Zugriff testen wollen, ohne auf die Sperrung zu warten, + können Sie <literal>t</literal> als dritten Buchstaben anfügen. Wenn + Sie sich absolut sicher sind, dass Sie keine Datenbanksperre benötigen, + können Sie statt <literal>l</literal> oder <literal>d</literal> + <literal>-</literal> verwenden. Wenn weder <literal>d</literal> oder + <literal>l</literal> noch <literal>-</literal> verwendet wird, sperrt + dba die Datenbank-Datei wie bei Verwendung von <literal>d</literal>. + </para> + <note> + <para> + Es kann jeweils nur einen Schreibzugriff auf eine Datenbank-Datei + geben. Wenn dba auf einen Webserver verwendet wird und mehr als eine + Anfrage Schreibzugriff benötigt, kann nur einer nach dem anderen + erledigt werden. Auch das Lesen ist während des Schreibens nicht + erlaubt. Die dba-Erweiterung verwendet Sperren, um dies zu verhindern. + Siehe folgende Tabelle: + <table> + <title>DBA-Sperrung</title> + <tgroup cols="9"> + <thead> + <row> + <entry>schon geöffnet</entry> + <entry><parameter>Modus</parameter> = "rl"</entry> + <entry><parameter>Modus</parameter> = "rlt"</entry> + <entry><parameter>Modus</parameter> = "wl"</entry> + <entry><parameter>Modus</parameter> = "wlt"</entry> + <entry><parameter>Modus</parameter> = "rd"</entry> + <entry><parameter>Modus</parameter> = "rdt"</entry> + <entry><parameter>Modus</parameter> = "wd"</entry> + <entry><parameter>Modus</parameter> = "wdt"</entry> + </row> + </thead> + <tbody> + <row> + <entry>nicht geöffnet</entry> + <entry>OK</entry> + <entry>OK</entry> + <entry>OK</entry> + <entry>OK</entry> + <entry>OK</entry> + <entry>OK</entry> + <entry>OK</entry> + <entry>OK</entry> + </row> + <row> + <entry><parameter>Modus</parameter> = "rl"</entry> + <entry>OK</entry> + <entry>OK</entry> + <entry>warten</entry> + <entry>&false;</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + </row> + <row> + <entry><parameter>Modus</parameter> = "wl"</entry> + <entry>warten</entry> + <entry>&false;</entry> + <entry>warten</entry> + <entry>&false;</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + </row> + <row> + <entry><parameter>Modus</parameter> = "rd"</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + <entry>OK</entry> + <entry>OK</entry> + <entry>warten</entry> + <entry>&false;</entry> + </row> + <row> + <entry><parameter>Modus</parameter> = "wd"</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + <entry>unzulässig</entry> + <entry>warten</entry> + <entry>&false;</entry> + <entry>warten</entry> + <entry>&false;</entry> + </row> + </tbody> + </tgroup> + </table> + <simplelist> + <member>OK: der zweite Aufruf ist erfolgreich.</member> + <member>warten: der zweite Aufruf wartet bis für den ersten <function>dba_close</function> aufgerufen wird.</member> + <member>&false;: der zweite Aufruf gibt &false; zurück.</member> + <member>unzulässig: Sie dürfen beim Parameter <parameter>Modus</parameter> die Modifikatoren "l" und "d" nicht zusammen verwenden.</member> + </simplelist> + </para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Handler</parameter></term> + <listitem> + <para> + Der Name des <link linkend="dba.requirements">Handlers</link>, der für + den Zugriff auf <parameter>Pfad</parameter> benutzt werden soll. Er + bekommt alle optionalen Argumente, die der Funktion + <function>dba_open</function> mitgegeben wurden, übergeben und kann + damit in deren Name verfahren. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine positive Verbindungskennung zurück oder &false;, falls ein Fehler + auftrat. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.0</entry> + <entry> + Es ist möglich, Datenbank-Dateien über eine Netzwerkverbindung zu + öffnen. Falls eine Socket-Verbindung verwendet wird (wie bei HTTP oder + FTP), wird anstelle der Datenquelle selbst die Verbindung gesperrt. + Das ist wichtig zu wissen, weil in einem solchen Fall die Sperrung von + der Datenquelle ignoriert wird und eine andere Lösung gefunden werden + muss. + </entry> + </row> + <row> + <entry>4.3.0</entry> + <entry> + Die Sperrung und die <parameter>Modus</parameter>-Modifikatoren "l", + "d" und "-" wurden hinzugefügt. In vorhergehenden PHP-Versionen müssen + außer bei GDBM bei allen Datenbank-Handlern Semaphore verwendet + werden, um gleichzeitigen Zugriffen auf eine Datenbank vorzubeugen. + Siehe <link linkend="book.sem">Semaphore</link>. + </entry> + </row> + <row> + <entry>vor 4.3.5</entry> + <entry> + Der Öffnen-Modus "c" funktioniert bei einigen internen Handlern nicht + korrekt und setzt existierende Datenbanken auf 0, statt Daten + anzufügen. Auch dbm und ndbm funktionieren in typischen + Konfigurationen beim Modus "c" nicht (das kann nicht behoben werden). + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_popen</function></member> + <member><function>dba_close</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-optimize.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-optimize.xml diff -u phpdoc-de/reference/dba/functions/dba-optimize.xml:1.6 phpdoc-de/reference/dba/functions/dba-optimize.xml:1.7 --- phpdoc-de/reference/dba/functions/dba-optimize.xml:1.6 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-optimize.xml Tue Jan 1 16:13:30 2008 @@ -1,38 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-optimize" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_optimize</refname> - <refpurpose>Optimieren einer Datenbank</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>dba_optimize</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_optimize</function> optimiert die zugrunde - liegende Datenbank, die durch <parameter>handle</parameter> - spezifiziert wird. - </para> - <para> - <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 - erfolgreich war oder ob sie fehlschlug. - </para> - <para> - Siehe auch - <function>dba_sync</function> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-optimize" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_optimize</refname> + <refpurpose>Optimiert eine Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_optimize</methodname> + <methodparam><type>resource</type><parameter>Verbindungskennung</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_optimize</function> optimiert die zugrunde liegende + Datenbank. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Verbindungskennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von <function>dba_open</function> + oder <function>dba_popen</function> zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_sync</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-popen.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-popen.xml diff -u phpdoc-de/reference/dba/functions/dba-popen.xml:1.6 phpdoc-de/reference/dba/functions/dba-popen.xml:1.7 --- phpdoc-de/reference/dba/functions/dba-popen.xml:1.6 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-popen.xml Tue Jan 1 16:13:30 2008 @@ -1,95 +1,84 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-popen" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_popen</refname> - <refpurpose>Persistente Datenbank-Verbindung öffnen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>dba_popen</methodname> - <methodparam><type>string</type><parameter>path</parameter></methodparam> - <methodparam><type>string</type><parameter>mode</parameter></methodparam> - <methodparam><type>string</type><parameter>handler</parameter></methodparam> - <methodparam choice="opt"><parameter>...</parameter></methodparam> - </methodsynopsis> - - <para> - <function>dba_popen</function> stellt eine persistente - Datenbankinstanz für <parameter>path</parameter> mit - <parameter>mode</parameter> her und benutzt dabei den Handler - <parameter>handler</parameter>. - </para> - <para> - <parameter>path</parameter> ist ein - gültiger Pfad in Ihrem Dateisystem. - </para> - <para> - 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 - <link linkend="ref.dba">Name des Handlers</link>, der für - den Zugriff auf <parameter>path</parameter> benutzt werden soll. - Die (oben durch <parameter>...</parameter> - gekennzeichneten) optionalen Argumente der Funktion - <function>dba_popen</function> werden an ihn übergeben. - </para> - <para> - <function>dba_popen</function> liefert als Rückgabewert eine - positive Zugriffs-"handle" oder &false;, - abhängig davon, ob die Verbindung hergestellt werden - konnte oder nicht. - </para> - <para> - Siehe auch - <function>dba_open</function> - <function>dba_close</function> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-popen" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_popen</refname> + <refpurpose>Öffnet eine persistente Datenbank-Verbindung</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>dba_popen</methodname> + <methodparam><type>string</type><parameter>Pfad</parameter></methodparam> + <methodparam><type>string</type><parameter>Modus</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>Handler</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_popen</function> stellt eine persistente Datenbankinstanz für + <parameter>Pfad</parameter> mit <parameter>Modus</parameter> her und + benutzt dabei den Handler <parameter>Handler</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Pfad</parameter></term> + <listitem> + <para> + Ein gültiger Pfad in Ihrem Dateisystem. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Modus</parameter></term> + <listitem> + <para> + Das ist <literal>r</literal> für lesenden Zugriff, <literal>w</literal> + für lesenden und schreibenden Zugriff auf eine existierende Datenbank, + <literal>c</literal> für lesenden und schreibenden Zugriff und + Erstellen der Datenbank, falls sie noch nicht existiert und + <literal>n</literal> für das Erstellen einer Datenbank, bzw. deren + Zurücksetzen auf die Größe 0, falls sie schon existiert und lesenden + und schreibenden Zugriff. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Handler</parameter></term> + <listitem> + <para> + Der Name des <link linkend="dba.requirements">Handlers</link>, der für + den Zugriff auf <parameter>Pfad</parameter> benutzt werden soll. Er + bekommt alle optionalen Argumente, die der Funktion + <function>dba_popen</function> mitgegeben wurden, übergeben und kann + damit in deren Name verfahren. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine positive Verbindungskennung zurück oder &false;, falls ein Fehler + auftrat. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_open</function></member> + <member><function>dba_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-replace.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-replace.xml diff -u phpdoc-de/reference/dba/functions/dba-replace.xml:1.6 phpdoc-de/reference/dba/functions/dba-replace.xml:1.7 --- phpdoc-de/reference/dba/functions/dba-replace.xml:1.6 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-replace.xml Tue Jan 1 16:13:30 2008 @@ -1,50 +1,81 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-replace" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_replace</refname> - <refpurpose>Datensatz ersetzen oder einfügen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>dba_replace</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>string</type><parameter>value</parameter></methodparam> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_replace</function> ersetzt oder fügt - 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, - der eingefügt werden soll. - </para> - <para> - <parameter>value</parameter> ist der Wert, der eingefügt - werden soll. - </para> - <para> - <parameter>handle</parameter> ist ein Datenbankhandle, das von - <function>dba_open</function> zurückgegeben wurde. - </para> - <para> - <function>dba_replace</function> liefert als Rückgabewert - &true; oder &false;, - abhängig davon, ob die Aktion erfolgreich war oder nicht. - </para> - <para> - Siehe auch <function>dba_exists</function>, - <function>dba_delete</function>, <function>dba_fetch</function>, - und <function>dba_insert</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-replace" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_replace</refname> + <refpurpose>Ersetzt einen Eintrag oder fügt ihn ein</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_replace</methodname> + <methodparam><type>string</type><parameter>Schlüssel</parameter></methodparam> + <methodparam><type>string</type><parameter>Wert</parameter></methodparam> + <methodparam><type>resource</type><parameter>Verbindungskennung</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_replace</function> ersetzt in der durch + <parameter>Verbindungskennung</parameter> spezifizierten Datenbank den + Eintrag, der durch <parameter>Schlüssel</parameter> und + <parameter>Wert</parameter> beschrieben wird, oder fügt ihn ein. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Schlüssel</parameter></term> + <listitem> + <para> + Der Schlüssel des zu ersetzenden Eintrags. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Wert</parameter></term> + <listitem> + <para> + Der Wert, der ersetzt werden soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Verbindungskennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von <function>dba_open</function> + oder <function>dba_popen</function> zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_exists</function></member> + <member><function>dba_delete</function></member> + <member><function>dba_fetch</function></member> + <member><function>dba_insert</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-sync.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dba/functions/dba-sync.xml diff -u phpdoc-de/reference/dba/functions/dba-sync.xml:1.6 phpdoc-de/reference/dba/functions/dba-sync.xml:1.7 --- phpdoc-de/reference/dba/functions/dba-sync.xml:1.6 Sat Jun 23 13:21:31 2007 +++ phpdoc-de/reference/dba/functions/dba-sync.xml Tue Jan 1 16:13:30 2008 @@ -1,38 +1,59 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.dba-sync" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dba_sync</refname> - <refpurpose>Datenbank synchronisieren</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>dba_sync</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_sync</function> synchronisiert die Datenbank, - die durch <parameter>handle</parameter> spezifiziert wird. - Dies kann möglicherweise einen physikalischen - Schreibvorgang auf den Datenträger auslösen, falls - dies unterstützt wird. - </para> - <para> - <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. - </para> - <para> - Siehe auch <function>dba_optimize</function> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: nobody Status: ready --> +<refentry xml:id="function.dba-sync" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dba_sync</refname> + <refpurpose>Synchronisiert eine Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_sync</methodname> + <methodparam><type>resource</type><parameter>Verbindungskennung</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_sync</function> synchronisiert die Datenbank. Dies kann + möglicherweise einen physikalischen Schreibvorgang auf den Datenträger + auslösen, falls dies unterstützt wird. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Verbindungskennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von <function>dba_open</function> + oder <function>dba_popen</function> zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_optimize</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-handlers.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/dba/functions/dba-handlers.xml +++ phpdoc-de/reference/dba/functions/dba-handlers.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.8 Maintainer: nobody Status: ready --> <refentry xml:id="function.dba-handlers" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>dba_handlers</refname> <refpurpose>Listet alle verfügbaren Handler auf</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>dba_handlers</methodname> <methodparam choice="opt"><type>bool</type><parameter>komplette_info</parameter></methodparam> </methodsynopsis> <para> <function>dba_handlers</function> listet alle Handler auf, die von dieser Erweiterung unterstützt werden. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>komplette_info</parameter></term> <listitem> <para> Schaltet die Anzeige der kompletten Information im Ergebnis ein/aus. Der voreingestellte Wert ist &false;. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Gibt ein Array mit Datenbank-Handlern zurück. Falls <parameter>komplette_info</parameter> auf &true; gesetzt war, ist es ein assoziatives Array mit den Namen der Handler als Schlüssel und deren Versionsinformationen als Wert. Andernfalls ist das Ergebnis ein indiziertes Array mit den Namen der Handler. </para> <note> <para> Falls die interne cdb-Bibliothek verwendet wird, sehen Sie <literal>cdb</literal> und <literal>cdb_make</literal>. </para> </note> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>dba_handlers</function> Beispiel</title> <programlisting role="php"> <![CDATA[ <?php echo "Verfügbare DBA-Handler:\n"; foreach (dba_handlers(true) as $handler_name => $handler_version) { // die Versionen "säubern" $handler_version = str_replace('$', '', $handler_version); echo " - $handler_name: $handler_version\n"; } ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Verfügbare DBA-Handler: - cdb: 0.75, Revision: 1.3.2.3 - cdb_make: 0.75, Revision: 1.2.2.4 - db2: Sleepycat Software: Berkeley DB 2.7.7: (08/20/99) - inifile: 1.0, Revision: 1.6.2.3 - flatfile: 1.0, Revision: 1.5.2.4 ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-key-split.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/dba/functions/dba-key-split.xml +++ phpdoc-de/reference/dba/functions/dba-key-split.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.7 Maintainer: nobody Status: ready --> <refentry xml:id="function.dba-key-split" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>dba_key_split</refname> <refpurpose>Zerlegt einen Schlüssel in Zeichenketten-Darstellung in eine Array-Darstellung</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>mixed</type><methodname>dba_key_split</methodname> <methodparam><type>mixed</type><parameter>Schlüssel</parameter></methodparam> </methodsynopsis> <para> <function>dba_key_split</function> zerlegt einen Schlüssel, der in Zeichenketten-Darstellung vorliegt in eine Array-Darstellung. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>Schlüssel</parameter></term> <listitem> <para> Der Schlüssel in Zeichenketten-Darstellung. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Gibt ein Array der Form <literal>array(0 =&gt; gruppe, 1 =&gt; wert_name)</literal> zurück. Falls <parameter>Schlüssel</parameter> &null; oder &false; ist, gibt diese Funktion &false; zurück. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>dba_firstkey</function></member> <member><function>dba_nextkey</function></member> <member><function>dba_fetch</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dba/functions/dba-list.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/dba/functions/dba-list.xml +++ phpdoc-de/reference/dba/functions/dba-list.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: nobody Status: ready --> <refentry xml:id="function.dba-list" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>dba_list</refname> <refpurpose>Listet alle offenen Datenbank-Dateien auf</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>dba_list</methodname> <void/> </methodsynopsis> <para> <function>dba_list</function> listet alle offenen Datenbank-Dateien auf. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Ein assoziatives Array der Form <literal>Ressource-ID =&gt; Dateiname</literal>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.doc.de (#2348) next »