cvs: phpdoc-de /reference/dbase/functions dbase-add-record.xml dbase-close.xml dbase-create.xml dbase-delete-record.xml
dbase-get-record-with-names.xml dbase-get-record.xml dbase-numfields.xml dbase-numrecords.xml dbase-open.xml dbase-pack.xml dbase-replace-record.xml
| From: | Martin Samesch | Date: | Mon, 05 May 2008 21:26:44 +0000 |
| Subject: | cvs: phpdoc-de /reference/dbase/functions dbase-add-record.xml dbase-close.xml dbase-create.xml dbase-delete-record.xml dbase-get-record-with-names.xml dbase-get-record.xml dbase-numfields.xml dbase-numrecords.xml dbase-open.xml dbase-pack.xml dbase-replace-record.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2640@lists.php.net to get a copy of this message | ||
samesch Mon May 5 21:26:44 2008 UTC
Modified files:
/phpdoc-de/reference/dbase/functions dbase-add-record.xml
dbase-close.xml
dbase-create.xml
dbase-delete-record.xml
dbase-get-record-with-names.xml
dbase-get-record.xml
dbase-numfields.xml
dbase-numrecords.xml
dbase-open.xml dbase-pack.xml
dbase-replace-record.xml
Log:
syncing with EN
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dbase/functions/dbase-add-record.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-add-record.xml diff -u phpdoc-de/reference/dbase/functions/dbase-add-record.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-add-record.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-add-record.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-add-record.xml Mon May 5 21:26:44 2008 @@ -1,28 +1,106 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-add-record" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_add_record</refname> - <refpurpose> - Hängt einen neuen Datensatz an eine dBase-Datenbank an - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_add_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>array</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - Hängt den per <parameter>record</parameter> definierten Datensatz - an die Datenbank an. Wenn die Anzahl der Einträge im angegebenen - Record nicht gleich der Anzahl der Felder in der Datenbank ist, - wird dieser Befehl scheitern und &false; / falsch zurück geben. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-add-record" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_add_record</refname> + <refpurpose>Hängt einen Datensatz an eine Datenbank an</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_add_record</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + <methodparam><type>array</type><parameter>Datensatz</parameter></methodparam> + </methodsynopsis> + <para> + Hängt die angegebenen Daten an die Datenbank an. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz</parameter></term> + <listitem> + <para> + Ein indiziertes Datenarray. Falls die Anzahl der Elemente nicht mit der + Anzahl der Datenbankfelder übereinstimmt, schlägt + <function>dbase_add_record</function> fehl. + </para> + <note> + <para> + Vergessen Sie nicht, den <literal>deleted</literal>-Schlüssel + zu löschen, wenn Sie für diesen Parameter den Rückgabewert von + <function>dbase_get_record</function> verwenden. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Einen Datensatz in eine dBase-Datenbank einfügen</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im lesen/schreiben-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 2); + +if ($db) { + dbase_add_record($db, array( + date('Ymd'), + 'Maxim Topolov', + '23', + 'max@example.com', + 'T')); + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_delete_record</function></member> + <member><function>dbase_replace_record</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/dbase/functions/dbase-close.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-close.xml diff -u phpdoc-de/reference/dbase/functions/dbase-close.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-close.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-close.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-close.xml Mon May 5 21:26:44 2008 @@ -1,23 +1,84 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-close" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_close</refname> - <refpurpose>Schließt eine dBase-Datenbank</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_close</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Schließt die durch <parameter>dbase_identifier</parameter> - angegebene Datenbank. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-close" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_close</refname> + <refpurpose>Schließt eine Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_close</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + </methodsynopsis> + <para> + Schließt die angegebene Datenbank-Verbindungskennung. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Schließen einer dBase-Datenbankdatei</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im nur-lesen-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + // ein paar Daten auslesen ... + + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_open</function></member> + <member><function>dbase_create</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/dbase/functions/dbase-create.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-create.xml diff -u phpdoc-de/reference/dbase/functions/dbase-create.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-create.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-create.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-create.xml Mon May 5 21:26:44 2008 @@ -1,101 +1,107 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-create" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_create</refname> - <refpurpose>Erzeugt eine dBase-Datenbank</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>dbase_create</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>array</type><parameter>fields</parameter></methodparam> - </methodsynopsis> - <para> - Der <parameter>fields</parameter>-Parameter ist ein Array, - das aus weiteren Arrays besteht. Jedes Array beschreibt das - Format eines Feldes der Datenbank. Jedes Feld-Array besteht - aus einem Namen, einem Zeichen zur Festlegung des Feldtyps, - der Länge und dem Wert für die Anzahl der Nachkommastellen. - </para> - <para> - Die verfügbaren Feldtypen sind: - <variablelist> - <varlistentry> - <term>L</term> - <listitem> - <simpara> - Boolean. Diese haben keine Länge oder Nachkommstellen. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>M</term> - <listitem> - <simpara> - Memo. (Beachten sie, dass diese von PHP nicht unterstützt - werden.) Auch diese haben keine Länge oder Nachkommastellen. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>D</term> - <listitem> - <simpara> - Datum (gespeichert als JJJJMMTT). Ebenfalls keine Länge und - Nachkommastellen. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>N</term> - <listitem> - <simpara> - Zahl. Diese haben sowohl eine Angabe der Länge als auch der - Nachkommastellen. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>C</term> - <listitem> - <simpara> - Zeichenkette / String / Charakter. Hier ist eine Längenangabe - erforderlich. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - Konnte die Datenbank erfolgreich erzeugt werden, wird ein - dbase_identifier zurück gegeben, anderenfalls &false; / falsch. - <example> - <title>Erzeugen einer dBase-Datenbank-Datei</title> - <programlisting role="php"> - // "Datenbank"-Name - $dbname = "/tmp/test.dbf"; - - // Datenbank-"Definitionen" - $def = - array( - array("Datum", "D"), - array("Name", "C", 50), - array("Alter", "N", 3, 0), - array("Email", "C", 128), - array("IstMitglied", "L") - ); - - // Erzeugung - if (!dbase_create($dbname, $def)) - print "<strong>Error!</strong>"; - </programlisting> - </example> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-create" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_create</refname> + <refpurpose>Erzeugt eine Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_create</methodname> + <methodparam><type>string</type><parameter>Dateiname</parameter></methodparam> + <methodparam><type>array</type><parameter>Felder</parameter></methodparam> + </methodsynopsis> + <para> + Erzeugt eine der angegebenen Definition entsprechende dBase-Datenbank. + </para> + ¬e.sm.uidcheck; + ¬e.open-basedir.func; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Dateiname</parameter></term> + <listitem> + <para> + Der Name der Datenbank. Das kann ein relativer oder absoluter Pfad zu + der Datei sein, in der dBase die Daten speichert. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Felder</parameter></term> + <listitem> + <para> + Ein Array aus Arrays, von denen jedes das Format eines Datenbankfeldes + beschreibt. Jedes Feld besteht aus einem Namen, einem Zeichen für den + Feldtyp und gegebenenfalls einer Länge und einer Genauigkeit. + </para> + <note> + <para> + Feldnamen dürfen nicht mehr als zehn Zeichen haben. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine Datenbank-Verbindungskennung zurück, falls die Datenbank + erfolgreich erzeugt werden konnte oder &false;, falls ein Fehler auftrat. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Erzeugen einer dBase-Datenbankdatei</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// Datenbank-"Definition" +$def = array( + array("Datum", "D"), + array("Name", "C", 50), + array("Alter", "N", 3, 0), + array("Email", "C", 128), + array("IstMitglied", "L") +); + +// Erzeugung +if (!dbase_create('/tmp/test.dbf', $def)) { + echo "Fehler, konnte die Datenbank nicht erzeugen\n"; +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_open</function></member> + <member><function>dbase_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/dbase/functions/dbase-delete-record.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-delete-record.xml diff -u phpdoc-de/reference/dbase/functions/dbase-delete-record.xml:1.7 phpdoc-de/reference/dbase/functions/dbase-delete-record.xml:1.8 --- phpdoc-de/reference/dbase/functions/dbase-delete-record.xml:1.7 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-delete-record.xml Mon May 5 21:26:44 2008 @@ -1,26 +1,75 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-delete-record" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_delete_record</refname> - <refpurpose>Markiert einen Datensatz als gelöscht</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_delete_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - Markiert den Datensatz <parameter>record</parameter> in der - Datenbank als gelöscht. Um ihn wirklich (physisch) zu entfernen, - müssen sie noch die Funktion <function>dbase_pack</function> - aufrufen. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-delete-record" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_delete_record</refname> + <refpurpose>Markiert einen Datensatz als gelöscht</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_delete_record</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + <methodparam><type>int</type><parameter>Datensatz_Nummer</parameter></methodparam> + </methodsynopsis> + <para> + Markiert den angegebenen Datensatz in der Datenbank als gelöscht. + </para> + <note> + <para> + Um den Datensatz wirklich aus der Datenbank zu entfernen, müssen sie noch + <function>dbase_pack</function> aufrufen. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz_Nummer</parameter></term> + <listitem> + <para> + Eine Ganzzahl, die von 1 bis zur Anzahl der Datensätze in der Datenbank + (wie von <function>dbase_numrecords</function> zurückgegeben) geht. + </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>dbase_add_record</function></member> + <member><function>dbase_replace_record</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/dbase/functions/dbase-get-record-with-names.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-get-record-with-names.xml diff -u phpdoc-de/reference/dbase/functions/dbase-get-record-with-names.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-get-record-with-names.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-get-record-with-names.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-get-record-with-names.xml Mon May 5 21:26:44 2008 @@ -1,34 +1,118 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-get-record-with-names" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_get_record_with_names</refname> - <refpurpose> - Gibt einen Datensatz einer dBase-Datenbank als assoziatives - Array zurück - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>array</type><methodname>dbase_get_record_with_names</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die Daten von <parameter>record</parameter> in einem - assoziativen Array zurück. Das Array enthält auch einen - assoziativen Bereich, der 'deleted' heisst und auf 1 steht, wenn - der Datensatz als gelöscht markiert ist (siehe - <function>dbase_delete_record</function>). - </para> - <para> - Jedes Feld wird in den entsprechenden PHP-Typ konvertiert - (Datumsangaben werden zu Zeichenketten / Strings). - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-get-record-with-names" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_get_record_with_names</refname> + <refpurpose>Liefert einen Datensatz aus einer Datenbank als assoziatives Array</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>dbase_get_record_with_names</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + <methodparam><type>int</type><parameter>Datensatz_Nummer</parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen Datensatz aus einer dBase-Datenbank als assoziatives Array + zurück. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz_Nummer</parameter></term> + <listitem> + <para> + Der Index des Datensatzes + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ein assoziatives Array mit dem Datensatz. Dieses Array enthält einen + zusätzlichen Schlüssel namens <literal>deleted</literal>, der auf 1 + gesetzt ist, wenn der Datensatz zum Löschen markiert wurde (siehe + <function>dbase_delete_record</function>). + </para> + <para> + Jedes Feld wird in den entsprechenden PHP-Typ umgewandelt, ausgenommen: + <itemizedlist> + <listitem> + <simpara> + Datumsfelder werden als Zeichenkette zurückgegeben. + </simpara> + </listitem> + <listitem> + <simpara> + Ganzzahlen, die zu einem Überlauf geführt hätten (> 32 Bit), werden + als Zeichenkette zurückgegeben. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + Falls ein Fehler auftritt, gibt + <function>dbase_get_record_with_names</function> &false; zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Liste aller in der Datenbank eingetragener Mitglieder</title> + <programlisting role="php"> +<![CDATA[ +<?php +// im nur-lesen-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + $anzahl_datensaetze = dbase_numrecords($db); + for ($i = 1; $i <= $anzahl_datensaetze; $i++) { + $datensatz = dbase_get_record_with_names($db, $i); + if ($datensatz['IstMitglied'] == 1) { + echo "Mitglied #$i: " . trim($datensatz['Name']) . "\n"; + } + } +} +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_get_record</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/dbase/functions/dbase-get-record.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-get-record.xml diff -u phpdoc-de/reference/dbase/functions/dbase-get-record.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-get-record.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-get-record.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-get-record.xml Mon May 5 21:26:44 2008 @@ -1,33 +1,90 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-get-record" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_get_record</refname> - <refpurpose> - Liest einen Datensatz aus einer dBase-Datenbank - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>array</type><methodname>dbase_get_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die Daten von <parameter>record</parameter> in einem Array - zurück. Das Array hat einen bei 0 beginnenden Index und enthält - einen zusätzlichen Bereich der mit 'deleted' bezeichnet wird. - Dieser ist auf 1 gesetzt, wenn der Datensatz als gelöscht - markiert ist (siehe <function>dbase_delete_record</function>). - </para> - <para> - Jedes Feld wird in den entsprechenden PHP-Typ umgesetzt - (Datumsangaben werden zu Zeichenketten / Strings). - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-get-record" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_get_record</refname> + <refpurpose>Liefert einen Datensatz aus einer Datenbank als indiziertes Array</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>dbase_get_record</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + <methodparam><type>int</type><parameter>Datensatz_Nummer</parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen Datensatz aus einer Datenbank als indiziertes Array zurück. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz_Nummer</parameter></term> + <listitem> + <para> + Der Index des Datensatzes + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ein indiziertes Array mit dem Datensatz. Dieses Array enthält zusätzlich + einen assoziativen Schlüssel namens <literal>deleted</literal>, der + auf 1 gesetzt ist, wenn der Datensatz zum Löschen markiert wurde (siehe + <function>dbase_delete_record</function>). + </para> + <para> + Jedes Feld wird in den entsprechenden PHP-Typ umgewandelt, ausgenommen: + <itemizedlist> + <listitem> + <simpara> + Datumsfelder werden als Zeichenkette zurückgegeben. + </simpara> + </listitem> + <listitem> + <simpara> + Ganzzahlen, die zu einem Überlauf geführt hätten (> 32 Bit), werden + als Zeichenkette zurückgegeben. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + Falls ein Fehler auftritt, gibt <function>dbase_get_record</function> + &false; zurück. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_get_record_with_names</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/dbase/functions/dbase-numfields.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-numfields.xml diff -u phpdoc-de/reference/dbase/functions/dbase-numfields.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-numfields.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-numfields.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-numfields.xml Mon May 5 21:26:44 2008 @@ -1,37 +1,87 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-numfields" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_numfields</refname> - <refpurpose> - Stellt fest, wieviele Felder eine dBase-Datenbank hat - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>dbase_numfields</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die Anzahl der Datenfelder (Spalten) in der angegebenen - Datenbank zurück. Feld-Nummern sind Werte zwischen 0 und - dbase_numfields($db)-1, wogegen die Datensatz-Werte zwischen 1 - und dbase_numrecords($db) sein können. - <example> - <title>Gebrauch von <function>dbase_numfields</function></title> - <programlisting role="php"> - $rec = dbase_get_record($db, $recno); - $nf = dbase_numfields($db); - for ($i=0; $i < $nf; $i++) { - print $rec[$i]."<br>\n"; - } - </programlisting> - </example> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-numfields" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_numfields</refname> + <refpurpose>Liefert die Anzahl der Felder einer Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_numfields</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + </methodsynopsis> + <para> + Gibt die Anzahl der Felder (Spalten) der angegebenen Datenbank zurück. + </para> + <note> + <para> + Die Anzahl der Felder liegt zwischen 0 und dbase_numfields($db)-1, wogegen + die Anzahl der Datensätze zwischen 1 und dbase_numrecords($db) liegt. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Anzahl der Felder in der Datenbank oder &false;, falls ein Fehler + auftrat. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>dbase_numfields</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$rec = dbase_get_record($db, $recno); +$nf = dbase_numfields($db); +for ($i = 0; $i < $nf; $i++) { + echo $rec[$i], "\n"; +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_numrecords</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/dbase/functions/dbase-numrecords.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-numrecords.xml diff -u phpdoc-de/reference/dbase/functions/dbase-numrecords.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-numrecords.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-numrecords.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-numrecords.xml Mon May 5 21:26:44 2008 @@ -1,27 +1,91 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-numrecords" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_numrecords</refname> - <refpurpose> - Ermittelt die Anzahl der Datensätze einer dBase-Datenbank - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>dbase_numrecords</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die Anzahl der Datensätze (Zeilen) in der angegebenen - Datenbank zurück. Datensatz-Nummern können Werte zwischen 1 und - dbase_numrecords($db) sein, wogegen Feld-Werte zwischen 0 und - dbase_numfields($db)-1 sein können. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-numrecords" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_numrecords</refname> + <refpurpose>Liefert die Anzahl der Datensätze einer Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_numrecords</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + </methodsynopsis> + <para> + Gibt die Anzahl der Datensätze (Zeilen) der angegebenen Datenbank zurück. + </para> + <note> + <para> + Die Anzahl der Datensätze liegt zwischen 1 und dbase_numrecords($db), + wogegen die Anzahl der Felder zwischen 0 und dbase_numfields($db)-1 liegt. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Anzahl der Datensätze in der Datenbank oder &false;, falls ein Fehler + auftrat. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Eine Schleife über alle Datensätze der Datenbank ausführen</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im nur-lesen-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + $anzahl_datensaetze = dbase_numrecords($db); + for ($i = 1; $i <= $anzahl_datensaetze; $i++) { + // mache hier mit jedem Datensatz etwas + } +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_num_fields</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/dbase/functions/dbase-open.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-open.xml diff -u phpdoc-de/reference/dbase/functions/dbase-open.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-open.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-open.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-open.xml Mon May 5 21:26:44 2008 @@ -1,30 +1,106 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-open" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_open</refname> - <refpurpose>Öffnet eine dBase-Datenbank</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>dbase_open</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> - <para> - Die Flags entsprechen denen des open()-Systemaufrufs - (normalerweise bedeutet 0 Nur-Lesen, 1 Nur-Schreiben und 2 - Lesen und Schreiben). - </para> - <para> - Gibt einen dbase_identifier für die geöffnete Datenbank zurück - oder &false; / falsch, wenn die Datenbank nicht geöffnet werden - konnte. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.11 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-open" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_open</refname> + <refpurpose>Öffnet eine Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_open</methodname> + <methodparam><type>string</type><parameter>Dateiname</parameter></methodparam> + <methodparam><type>int</type><parameter>Modus</parameter></methodparam> + </methodsynopsis> + <para> + <function>dbase_open</function> öffnet eine dBase-Datenbank im angegebenen + Zugriffsmodus. + </para> + ¬e.sm.uidcheck; + ¬e.open-basedir.func; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Dateiname</parameter></term> + <listitem> + <para> + Der Name der Datenbank. Das kann ein relativer oder absoluter Pfad zu + der Datei sein, in der dBase die Daten speichert. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Modus</parameter></term> + <listitem> + <para> + Eine Ganzzahl, die denen des <command>open()</command>-Systemaufrufs + entspricht (typischerweise bedeutet 0 nur lesen, 1 nur schreiben und 2 + lesen und schreiben). + </para> + <note> + <para> + Eine dBase-Datei kann nicht im nur-schreiben-Modus geöffnet werden, + weil diese Funktion dann die Informationen des Dateikopfs nicht lesen + könnte. Deshalb kann der <parameter>Modus</parameter> 1 nicht + verwendet werden. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Öffnen einer dBase-Datenbankdatei</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im nur-lesen-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + // ein paar Daten lesen ... + + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine Datenbank-Verbindungskennung für die geöffnete Datenbank zurück + oder &false;, falls ein Fehler auftrat. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_create</function></member> + <member><function>dbase_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/dbase/functions/dbase-pack.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-pack.xml diff -u phpdoc-de/reference/dbase/functions/dbase-pack.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-pack.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-pack.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-pack.xml Mon May 5 21:26:44 2008 @@ -1,27 +1,87 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-pack" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_pack</refname> - <refpurpose> - Entfernt die als gelöscht markierten Datensätze aus der Datenbank - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_pack</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Entfernt die in der angegebenen Datenbank als gelöscht markierten - Datensätze endgültig (physisch). Betroffen sind alle vorher per - <function>dbase_delete_record</function> als gelöscht markierten - Datensätze. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-pack" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_pack</refname> + <refpurpose>Entfernt die als gelöscht markierten Datensätze aus einer Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_pack</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + </methodsynopsis> + <para> + Entfernt die mittels <function>dbase_delete_record</function> als gelöscht + markierten Datensätze endgültig aus der angegebenen Datenbank. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Leeren einer dBase-Datenbank</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im lesen-schreiben-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 2); + +if ($db) { + $anzahl_datensaetze = dbase_numrecords($db); + for ($i = 1; $i <= $anzahl_datensaetze; $i++) { + dbase_delete_record($db, $i); + } + // Datensätze löschen + dbase_pack($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_delete_record</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/dbase/functions/dbase-replace-record.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-replace-record.xml diff -u phpdoc-de/reference/dbase/functions/dbase-replace-record.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-replace-record.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-replace-record.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-replace-record.xml Mon May 5 21:26:44 2008 @@ -1,37 +1,123 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-replace-record" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_replace_record</refname> - <refpurpose> - Ersetzt einen Datensatz in einer dBase-Datenbank - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_replace_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>array</type><parameter>record</parameter></methodparam> - <methodparam><type>int</type><parameter>dbase_record_number</parameter></methodparam> - </methodsynopsis> - <simpara> - Überschreibt die Daten des Datensatzes - <parameter>record_number</parameter> mit den Daten aus - <parameter>record</parameter> in der Datenbank. Falls die Anzahl - der definierten Einträge ungleich der Anzahl der Datenfelder in - dem angesprochenen Datensatz ist, wird die Ausführung dieses - Befehls abgewiesen und &false; / falsch zurück gegeben. - </simpara> - <simpara> - <parameter>dbase_record_number</parameter> ist ein Integer-Wert, - der von 1 bis zur Anzahl der Datensatz-Anzahl der Datenbank - reicht (wie er bei Aufruf der Funktion - <function>dbase_numrecords</function> zurück gegeben wird). - </simpara> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-replace-record" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_replace_record</refname> + <refpurpose>Ersetzt einen Datensatz in einer Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_replace_record</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + <methodparam><type>array</type><parameter>Datensatz</parameter></methodparam> + <methodparam><type>int</type><parameter>Datensatz_Nummer</parameter></methodparam> + </methodsynopsis> + <para> + Ersetzt in der Datenbank den angegebenen Datensatz + <parameter>Datensatz_Nummer</parameter> mit den Daten aus + <parameter>Datensatz</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz</parameter></term> + <listitem> + <para> + Ein indiziertes Datenarray. Falls die Anzahl der Elemente nicht mit der + Anzahl der Datenbankfelder übereinstimmt, schlägt + <function>dbase_replace_record</function> fehl. + </para> + <note> + <para> + Vergessen Sie nicht, den <literal>deleted</literal>-Schlüssel + zu löschen, wenn Sie für diesen Parameter den Rückgabewert von + <function>dbase_get_record</function> verwenden. + </para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz_Nummer</parameter></term> + <listitem> + <para> + Eine Ganzzahl, die von 1 bis zur Anzahl der Datensätze in der Datenbank + (wie von <function>dbase_numrecords</function> zurückgegeben) geht. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Aktualisieren eines Datensatzes in der Datenbank</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im lesen-schreiben-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 2); + +if ($db) { + // den alten Datensatz holen + $datensatz = dbase_get_record_with_names($db, 1); + + // den Eintrag 'deleted' entfernen + unset($datensatz['deleted']); + + // das Datumsfeld mit dem aktuellen Zeitstempel aktualisieren + $datensatz['Datum'] = date('Ymd'); + + // den Datensatz ersetzen + dbase_replace_record($db, $datensatz, 1); + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_add_record</function></member> + <member><function>dbase_delete_record</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/dbase/functions/dbase-add-record.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-add-record.xml diff -u phpdoc-de/reference/dbase/functions/dbase-add-record.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-add-record.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-add-record.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-add-record.xml Mon May 5 21:26:44 2008 @@ -1,28 +1,106 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-add-record" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_add_record</refname> - <refpurpose> - Hängt einen neuen Datensatz an eine dBase-Datenbank an - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_add_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>array</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - Hängt den per <parameter>record</parameter> definierten Datensatz - an die Datenbank an. Wenn die Anzahl der Einträge im angegebenen - Record nicht gleich der Anzahl der Felder in der Datenbank ist, - wird dieser Befehl scheitern und &false; / falsch zurück geben. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-add-record" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_add_record</refname> + <refpurpose>Hängt einen Datensatz an eine Datenbank an</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_add_record</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + <methodparam><type>array</type><parameter>Datensatz</parameter></methodparam> + </methodsynopsis> + <para> + Hängt die angegebenen Daten an die Datenbank an. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz</parameter></term> + <listitem> + <para> + Ein indiziertes Datenarray. Falls die Anzahl der Elemente nicht mit der + Anzahl der Datenbankfelder übereinstimmt, schlägt + <function>dbase_add_record</function> fehl. + </para> + <note> + <para> + Vergessen Sie nicht, den <literal>deleted</literal>-Schlüssel + zu löschen, wenn Sie für diesen Parameter den Rückgabewert von + <function>dbase_get_record</function> verwenden. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Einen Datensatz in eine dBase-Datenbank einfügen</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im lesen/schreiben-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 2); + +if ($db) { + dbase_add_record($db, array( + date('Ymd'), + 'Maxim Topolov', + '23', + 'max@example.com', + 'T')); + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_delete_record</function></member> + <member><function>dbase_replace_record</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/dbase/functions/dbase-close.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-close.xml diff -u phpdoc-de/reference/dbase/functions/dbase-close.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-close.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-close.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-close.xml Mon May 5 21:26:44 2008 @@ -1,23 +1,84 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-close" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_close</refname> - <refpurpose>Schließt eine dBase-Datenbank</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_close</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Schließt die durch <parameter>dbase_identifier</parameter> - angegebene Datenbank. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-close" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_close</refname> + <refpurpose>Schließt eine Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_close</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + </methodsynopsis> + <para> + Schließt die angegebene Datenbank-Verbindungskennung. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Schließen einer dBase-Datenbankdatei</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im nur-lesen-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + // ein paar Daten auslesen ... + + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_open</function></member> + <member><function>dbase_create</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/dbase/functions/dbase-create.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-create.xml diff -u phpdoc-de/reference/dbase/functions/dbase-create.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-create.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-create.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-create.xml Mon May 5 21:26:44 2008 @@ -1,101 +1,107 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-create" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_create</refname> - <refpurpose>Erzeugt eine dBase-Datenbank</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>dbase_create</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>array</type><parameter>fields</parameter></methodparam> - </methodsynopsis> - <para> - Der <parameter>fields</parameter>-Parameter ist ein Array, - das aus weiteren Arrays besteht. Jedes Array beschreibt das - Format eines Feldes der Datenbank. Jedes Feld-Array besteht - aus einem Namen, einem Zeichen zur Festlegung des Feldtyps, - der Länge und dem Wert für die Anzahl der Nachkommastellen. - </para> - <para> - Die verfügbaren Feldtypen sind: - <variablelist> - <varlistentry> - <term>L</term> - <listitem> - <simpara> - Boolean. Diese haben keine Länge oder Nachkommstellen. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>M</term> - <listitem> - <simpara> - Memo. (Beachten sie, dass diese von PHP nicht unterstützt - werden.) Auch diese haben keine Länge oder Nachkommastellen. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>D</term> - <listitem> - <simpara> - Datum (gespeichert als JJJJMMTT). Ebenfalls keine Länge und - Nachkommastellen. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>N</term> - <listitem> - <simpara> - Zahl. Diese haben sowohl eine Angabe der Länge als auch der - Nachkommastellen. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>C</term> - <listitem> - <simpara> - Zeichenkette / String / Charakter. Hier ist eine Längenangabe - erforderlich. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - Konnte die Datenbank erfolgreich erzeugt werden, wird ein - dbase_identifier zurück gegeben, anderenfalls &false; / falsch. - <example> - <title>Erzeugen einer dBase-Datenbank-Datei</title> - <programlisting role="php"> - // "Datenbank"-Name - $dbname = "/tmp/test.dbf"; - - // Datenbank-"Definitionen" - $def = - array( - array("Datum", "D"), - array("Name", "C", 50), - array("Alter", "N", 3, 0), - array("Email", "C", 128), - array("IstMitglied", "L") - ); - - // Erzeugung - if (!dbase_create($dbname, $def)) - print "<strong>Error!</strong>"; - </programlisting> - </example> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-create" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_create</refname> + <refpurpose>Erzeugt eine Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_create</methodname> + <methodparam><type>string</type><parameter>Dateiname</parameter></methodparam> + <methodparam><type>array</type><parameter>Felder</parameter></methodparam> + </methodsynopsis> + <para> + Erzeugt eine der angegebenen Definition entsprechende dBase-Datenbank. + </para> + ¬e.sm.uidcheck; + ¬e.open-basedir.func; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Dateiname</parameter></term> + <listitem> + <para> + Der Name der Datenbank. Das kann ein relativer oder absoluter Pfad zu + der Datei sein, in der dBase die Daten speichert. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Felder</parameter></term> + <listitem> + <para> + Ein Array aus Arrays, von denen jedes das Format eines Datenbankfeldes + beschreibt. Jedes Feld besteht aus einem Namen, einem Zeichen für den + Feldtyp und gegebenenfalls einer Länge und einer Genauigkeit. + </para> + <note> + <para> + Feldnamen dürfen nicht mehr als zehn Zeichen haben. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine Datenbank-Verbindungskennung zurück, falls die Datenbank + erfolgreich erzeugt werden konnte oder &false;, falls ein Fehler auftrat. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Erzeugen einer dBase-Datenbankdatei</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// Datenbank-"Definition" +$def = array( + array("Datum", "D"), + array("Name", "C", 50), + array("Alter", "N", 3, 0), + array("Email", "C", 128), + array("IstMitglied", "L") +); + +// Erzeugung +if (!dbase_create('/tmp/test.dbf', $def)) { + echo "Fehler, konnte die Datenbank nicht erzeugen\n"; +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_open</function></member> + <member><function>dbase_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/dbase/functions/dbase-delete-record.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-delete-record.xml diff -u phpdoc-de/reference/dbase/functions/dbase-delete-record.xml:1.7 phpdoc-de/reference/dbase/functions/dbase-delete-record.xml:1.8 --- phpdoc-de/reference/dbase/functions/dbase-delete-record.xml:1.7 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-delete-record.xml Mon May 5 21:26:44 2008 @@ -1,26 +1,75 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-delete-record" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_delete_record</refname> - <refpurpose>Markiert einen Datensatz als gelöscht</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_delete_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - Markiert den Datensatz <parameter>record</parameter> in der - Datenbank als gelöscht. Um ihn wirklich (physisch) zu entfernen, - müssen sie noch die Funktion <function>dbase_pack</function> - aufrufen. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-delete-record" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_delete_record</refname> + <refpurpose>Markiert einen Datensatz als gelöscht</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_delete_record</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + <methodparam><type>int</type><parameter>Datensatz_Nummer</parameter></methodparam> + </methodsynopsis> + <para> + Markiert den angegebenen Datensatz in der Datenbank als gelöscht. + </para> + <note> + <para> + Um den Datensatz wirklich aus der Datenbank zu entfernen, müssen sie noch + <function>dbase_pack</function> aufrufen. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz_Nummer</parameter></term> + <listitem> + <para> + Eine Ganzzahl, die von 1 bis zur Anzahl der Datensätze in der Datenbank + (wie von <function>dbase_numrecords</function> zurückgegeben) geht. + </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>dbase_add_record</function></member> + <member><function>dbase_replace_record</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/dbase/functions/dbase-get-record-with-names.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-get-record-with-names.xml diff -u phpdoc-de/reference/dbase/functions/dbase-get-record-with-names.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-get-record-with-names.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-get-record-with-names.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-get-record-with-names.xml Mon May 5 21:26:44 2008 @@ -1,34 +1,118 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-get-record-with-names" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_get_record_with_names</refname> - <refpurpose> - Gibt einen Datensatz einer dBase-Datenbank als assoziatives - Array zurück - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>array</type><methodname>dbase_get_record_with_names</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die Daten von <parameter>record</parameter> in einem - assoziativen Array zurück. Das Array enthält auch einen - assoziativen Bereich, der 'deleted' heisst und auf 1 steht, wenn - der Datensatz als gelöscht markiert ist (siehe - <function>dbase_delete_record</function>). - </para> - <para> - Jedes Feld wird in den entsprechenden PHP-Typ konvertiert - (Datumsangaben werden zu Zeichenketten / Strings). - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-get-record-with-names" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_get_record_with_names</refname> + <refpurpose>Liefert einen Datensatz aus einer Datenbank als assoziatives Array</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>dbase_get_record_with_names</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + <methodparam><type>int</type><parameter>Datensatz_Nummer</parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen Datensatz aus einer dBase-Datenbank als assoziatives Array + zurück. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz_Nummer</parameter></term> + <listitem> + <para> + Der Index des Datensatzes + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ein assoziatives Array mit dem Datensatz. Dieses Array enthält einen + zusätzlichen Schlüssel namens <literal>deleted</literal>, der auf 1 + gesetzt ist, wenn der Datensatz zum Löschen markiert wurde (siehe + <function>dbase_delete_record</function>). + </para> + <para> + Jedes Feld wird in den entsprechenden PHP-Typ umgewandelt, ausgenommen: + <itemizedlist> + <listitem> + <simpara> + Datumsfelder werden als Zeichenkette zurückgegeben. + </simpara> + </listitem> + <listitem> + <simpara> + Ganzzahlen, die zu einem Überlauf geführt hätten (> 32 Bit), werden + als Zeichenkette zurückgegeben. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + Falls ein Fehler auftritt, gibt + <function>dbase_get_record_with_names</function> &false; zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Liste aller in der Datenbank eingetragener Mitglieder</title> + <programlisting role="php"> +<![CDATA[ +<?php +// im nur-lesen-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + $anzahl_datensaetze = dbase_numrecords($db); + for ($i = 1; $i <= $anzahl_datensaetze; $i++) { + $datensatz = dbase_get_record_with_names($db, $i); + if ($datensatz['IstMitglied'] == 1) { + echo "Mitglied #$i: " . trim($datensatz['Name']) . "\n"; + } + } +} +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_get_record</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/dbase/functions/dbase-get-record.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-get-record.xml diff -u phpdoc-de/reference/dbase/functions/dbase-get-record.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-get-record.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-get-record.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-get-record.xml Mon May 5 21:26:44 2008 @@ -1,33 +1,90 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-get-record" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_get_record</refname> - <refpurpose> - Liest einen Datensatz aus einer dBase-Datenbank - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>array</type><methodname>dbase_get_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die Daten von <parameter>record</parameter> in einem Array - zurück. Das Array hat einen bei 0 beginnenden Index und enthält - einen zusätzlichen Bereich der mit 'deleted' bezeichnet wird. - Dieser ist auf 1 gesetzt, wenn der Datensatz als gelöscht - markiert ist (siehe <function>dbase_delete_record</function>). - </para> - <para> - Jedes Feld wird in den entsprechenden PHP-Typ umgesetzt - (Datumsangaben werden zu Zeichenketten / Strings). - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-get-record" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_get_record</refname> + <refpurpose>Liefert einen Datensatz aus einer Datenbank als indiziertes Array</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>dbase_get_record</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + <methodparam><type>int</type><parameter>Datensatz_Nummer</parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen Datensatz aus einer Datenbank als indiziertes Array zurück. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz_Nummer</parameter></term> + <listitem> + <para> + Der Index des Datensatzes + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ein indiziertes Array mit dem Datensatz. Dieses Array enthält zusätzlich + einen assoziativen Schlüssel namens <literal>deleted</literal>, der + auf 1 gesetzt ist, wenn der Datensatz zum Löschen markiert wurde (siehe + <function>dbase_delete_record</function>). + </para> + <para> + Jedes Feld wird in den entsprechenden PHP-Typ umgewandelt, ausgenommen: + <itemizedlist> + <listitem> + <simpara> + Datumsfelder werden als Zeichenkette zurückgegeben. + </simpara> + </listitem> + <listitem> + <simpara> + Ganzzahlen, die zu einem Überlauf geführt hätten (> 32 Bit), werden + als Zeichenkette zurückgegeben. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + Falls ein Fehler auftritt, gibt <function>dbase_get_record</function> + &false; zurück. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_get_record_with_names</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/dbase/functions/dbase-numfields.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-numfields.xml diff -u phpdoc-de/reference/dbase/functions/dbase-numfields.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-numfields.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-numfields.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-numfields.xml Mon May 5 21:26:44 2008 @@ -1,37 +1,87 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-numfields" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_numfields</refname> - <refpurpose> - Stellt fest, wieviele Felder eine dBase-Datenbank hat - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>dbase_numfields</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die Anzahl der Datenfelder (Spalten) in der angegebenen - Datenbank zurück. Feld-Nummern sind Werte zwischen 0 und - dbase_numfields($db)-1, wogegen die Datensatz-Werte zwischen 1 - und dbase_numrecords($db) sein können. - <example> - <title>Gebrauch von <function>dbase_numfields</function></title> - <programlisting role="php"> - $rec = dbase_get_record($db, $recno); - $nf = dbase_numfields($db); - for ($i=0; $i < $nf; $i++) { - print $rec[$i]."<br>\n"; - } - </programlisting> - </example> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-numfields" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_numfields</refname> + <refpurpose>Liefert die Anzahl der Felder einer Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_numfields</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + </methodsynopsis> + <para> + Gibt die Anzahl der Felder (Spalten) der angegebenen Datenbank zurück. + </para> + <note> + <para> + Die Anzahl der Felder liegt zwischen 0 und dbase_numfields($db)-1, wogegen + die Anzahl der Datensätze zwischen 1 und dbase_numrecords($db) liegt. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Anzahl der Felder in der Datenbank oder &false;, falls ein Fehler + auftrat. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>dbase_numfields</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$rec = dbase_get_record($db, $recno); +$nf = dbase_numfields($db); +for ($i = 0; $i < $nf; $i++) { + echo $rec[$i], "\n"; +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_numrecords</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/dbase/functions/dbase-numrecords.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-numrecords.xml diff -u phpdoc-de/reference/dbase/functions/dbase-numrecords.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-numrecords.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-numrecords.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-numrecords.xml Mon May 5 21:26:44 2008 @@ -1,27 +1,91 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-numrecords" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_numrecords</refname> - <refpurpose> - Ermittelt die Anzahl der Datensätze einer dBase-Datenbank - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>dbase_numrecords</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die Anzahl der Datensätze (Zeilen) in der angegebenen - Datenbank zurück. Datensatz-Nummern können Werte zwischen 1 und - dbase_numrecords($db) sein, wogegen Feld-Werte zwischen 0 und - dbase_numfields($db)-1 sein können. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-numrecords" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_numrecords</refname> + <refpurpose>Liefert die Anzahl der Datensätze einer Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_numrecords</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + </methodsynopsis> + <para> + Gibt die Anzahl der Datensätze (Zeilen) der angegebenen Datenbank zurück. + </para> + <note> + <para> + Die Anzahl der Datensätze liegt zwischen 1 und dbase_numrecords($db), + wogegen die Anzahl der Felder zwischen 0 und dbase_numfields($db)-1 liegt. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Anzahl der Datensätze in der Datenbank oder &false;, falls ein Fehler + auftrat. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Eine Schleife über alle Datensätze der Datenbank ausführen</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im nur-lesen-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + $anzahl_datensaetze = dbase_numrecords($db); + for ($i = 1; $i <= $anzahl_datensaetze; $i++) { + // mache hier mit jedem Datensatz etwas + } +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_num_fields</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/dbase/functions/dbase-open.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-open.xml diff -u phpdoc-de/reference/dbase/functions/dbase-open.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-open.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-open.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-open.xml Mon May 5 21:26:44 2008 @@ -1,30 +1,106 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-open" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_open</refname> - <refpurpose>Öffnet eine dBase-Datenbank</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>dbase_open</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> - <para> - Die Flags entsprechen denen des open()-Systemaufrufs - (normalerweise bedeutet 0 Nur-Lesen, 1 Nur-Schreiben und 2 - Lesen und Schreiben). - </para> - <para> - Gibt einen dbase_identifier für die geöffnete Datenbank zurück - oder &false; / falsch, wenn die Datenbank nicht geöffnet werden - konnte. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.11 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-open" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_open</refname> + <refpurpose>Öffnet eine Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_open</methodname> + <methodparam><type>string</type><parameter>Dateiname</parameter></methodparam> + <methodparam><type>int</type><parameter>Modus</parameter></methodparam> + </methodsynopsis> + <para> + <function>dbase_open</function> öffnet eine dBase-Datenbank im angegebenen + Zugriffsmodus. + </para> + ¬e.sm.uidcheck; + ¬e.open-basedir.func; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Dateiname</parameter></term> + <listitem> + <para> + Der Name der Datenbank. Das kann ein relativer oder absoluter Pfad zu + der Datei sein, in der dBase die Daten speichert. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Modus</parameter></term> + <listitem> + <para> + Eine Ganzzahl, die denen des <command>open()</command>-Systemaufrufs + entspricht (typischerweise bedeutet 0 nur lesen, 1 nur schreiben und 2 + lesen und schreiben). + </para> + <note> + <para> + Eine dBase-Datei kann nicht im nur-schreiben-Modus geöffnet werden, + weil diese Funktion dann die Informationen des Dateikopfs nicht lesen + könnte. Deshalb kann der <parameter>Modus</parameter> 1 nicht + verwendet werden. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Öffnen einer dBase-Datenbankdatei</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im nur-lesen-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + // ein paar Daten lesen ... + + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine Datenbank-Verbindungskennung für die geöffnete Datenbank zurück + oder &false;, falls ein Fehler auftrat. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_create</function></member> + <member><function>dbase_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/dbase/functions/dbase-pack.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-pack.xml diff -u phpdoc-de/reference/dbase/functions/dbase-pack.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-pack.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-pack.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-pack.xml Mon May 5 21:26:44 2008 @@ -1,27 +1,87 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-pack" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_pack</refname> - <refpurpose> - Entfernt die als gelöscht markierten Datensätze aus der Datenbank - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_pack</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Entfernt die in der angegebenen Datenbank als gelöscht markierten - Datensätze endgültig (physisch). Betroffen sind alle vorher per - <function>dbase_delete_record</function> als gelöscht markierten - Datensätze. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-pack" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_pack</refname> + <refpurpose>Entfernt die als gelöscht markierten Datensätze aus einer Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_pack</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + </methodsynopsis> + <para> + Entfernt die mittels <function>dbase_delete_record</function> als gelöscht + markierten Datensätze endgültig aus der angegebenen Datenbank. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Leeren einer dBase-Datenbank</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im lesen-schreiben-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 2); + +if ($db) { + $anzahl_datensaetze = dbase_numrecords($db); + for ($i = 1; $i <= $anzahl_datensaetze; $i++) { + dbase_delete_record($db, $i); + } + // Datensätze löschen + dbase_pack($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_delete_record</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/dbase/functions/dbase-replace-record.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/dbase/functions/dbase-replace-record.xml diff -u phpdoc-de/reference/dbase/functions/dbase-replace-record.xml:1.6 phpdoc-de/reference/dbase/functions/dbase-replace-record.xml:1.7 --- phpdoc-de/reference/dbase/functions/dbase-replace-record.xml:1.6 Mon Jan 21 11:28:50 2008 +++ phpdoc-de/reference/dbase/functions/dbase-replace-record.xml Mon May 5 21:26:44 2008 @@ -1,37 +1,123 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: samesch Status: working --> - <refentry xml:id="function.dbase-replace-record" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dbase_replace_record</refname> - <refpurpose> - Ersetzt einen Datensatz in einer dBase-Datenbank - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_replace_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>array</type><parameter>record</parameter></methodparam> - <methodparam><type>int</type><parameter>dbase_record_number</parameter></methodparam> - </methodsynopsis> - <simpara> - Überschreibt die Daten des Datensatzes - <parameter>record_number</parameter> mit den Daten aus - <parameter>record</parameter> in der Datenbank. Falls die Anzahl - der definierten Einträge ungleich der Anzahl der Datenfelder in - dem angesprochenen Datensatz ist, wird die Ausführung dieses - Befehls abgewiesen und &false; / falsch zurück gegeben. - </simpara> - <simpara> - <parameter>dbase_record_number</parameter> ist ein Integer-Wert, - der von 1 bis zur Anzahl der Datensatz-Anzahl der Datenbank - reicht (wie er bei Aufruf der Funktion - <function>dbase_numrecords</function> zurück gegeben wird). - </simpara> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> +<refentry xml:id="function.dbase-replace-record" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dbase_replace_record</refname> + <refpurpose>Ersetzt einen Datensatz in einer Datenbank</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_replace_record</methodname> + <methodparam><type>int</type><parameter>dBase_Kennung</parameter></methodparam> + <methodparam><type>array</type><parameter>Datensatz</parameter></methodparam> + <methodparam><type>int</type><parameter>Datensatz_Nummer</parameter></methodparam> + </methodsynopsis> + <para> + Ersetzt in der Datenbank den angegebenen Datensatz + <parameter>Datensatz_Nummer</parameter> mit den Daten aus + <parameter>Datensatz</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dBase_Kennung</parameter></term> + <listitem> + <para> + Die Datenbank-Verbindungskennung, die von + <function>dbase_open</function> oder <function>dbase_create</function> + zurückgegeben wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz</parameter></term> + <listitem> + <para> + Ein indiziertes Datenarray. Falls die Anzahl der Elemente nicht mit der + Anzahl der Datenbankfelder übereinstimmt, schlägt + <function>dbase_replace_record</function> fehl. + </para> + <note> + <para> + Vergessen Sie nicht, den <literal>deleted</literal>-Schlüssel + zu löschen, wenn Sie für diesen Parameter den Rückgabewert von + <function>dbase_get_record</function> verwenden. + </para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Datensatz_Nummer</parameter></term> + <listitem> + <para> + Eine Ganzzahl, die von 1 bis zur Anzahl der Datensätze in der Datenbank + (wie von <function>dbase_numrecords</function> zurückgegeben) geht. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Aktualisieren eines Datensatzes in der Datenbank</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// im lesen-schreiben-Modus öffnen +$db = dbase_open('/tmp/test.dbf', 2); + +if ($db) { + // den alten Datensatz holen + $datensatz = dbase_get_record_with_names($db, 1); + + // den Eintrag 'deleted' entfernen + unset($datensatz['deleted']); + + // das Datumsfeld mit dem aktuellen Zeitstempel aktualisieren + $datensatz['Datum'] = date('Ymd'); + + // den Datensatz ersetzen + dbase_replace_record($db, $datensatz, 1); + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_add_record</function></member> + <member><function>dbase_delete_record</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: