<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.dbase">
  <title>dBase Funktionen</title>
  <titleabbrev>dBase</titleabbrev>

  <partintro>
   <simpara>
    Diese Funktionen erlauben ihnen den Zugriff auf Datenstze, die
    im dBase-Format (also in dBase-Datenbanken) (dbf) vorliegen.
   </simpara>
   <simpara>
    Es gibt keine Untersttzug fr Indizes oder Memo-Felder. Auch
    Sperrfunktionen fr Datenstze / -banken sind nicht vorhanden.
    Zwei gleichzeitig ablaufende Webserver-Prozesse, die die
    selbe dBase-Datei bearbeiten, werden ihre Datenbank zerstren.
   </simpara>
   <simpara>
    Anders als bei SQL-Datenbanken knnen in dBase-"Datenbanken" die
    Felddefinitionen nicht nachtrglich gendert werden. Nachdem die
    dbf-Datei erzeugt wurde, sind die Definitionen festgelegt. Es
    werden keine Index-Funktionen untersttzt, die Abfragen
    beschleunigen oder etwa ihre Datenorganisation untersttzen.
    dBase-Dateien sind einfache sequentielle Dateien mit fester
    Datensatzlnge. Neue Datenstze werden am Dateiende angehngt
    und gelschte Datenstze werden beibehalten, bis sie
    <function>dbase_pack</function> aufrufen.
   </simpara>
   <simpara>
    Wir empfehlen, keine Produktions-DBF-Datenbanken zu benutzen.
    Whlen sie zur Nutzung von Produktions-Daten mit PHP nur echte
    SQL-Server-Datenbanken; MySQL oder Postgres sind dabei eine gute
    Wahl. dBase-Untersttzung durch PHP dient hauptschlich dem Im-
    und Export von Daten zu oder aus ihrer Web-Datenbank, wobei das
    DBF-Datei-Format vor allem wegen der Windows-Tabellenkalulationen
    und -Organizer untersttzt wird. Im- und Export ist der einzige
    Grund fr die dBase-Untersttzung durch PHP.
   </simpara>
  </partintro>

  <refentry id="function.dbase-create">
   <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 Lnge und dem Wert fr die Anzahl der Nachkommastellen.
    </para>
    <para>
     Die verfgbaren Feldtypen sind:
     <variablelist>
      <varlistentry>
       <term>L</term> 
       <listitem>
	<simpara> 
	 Boolean. Diese haben keine Lnge oder Nachkommstellen.
	</simpara>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>M</term>
       <listitem>
	<simpara>
	 Memo. (Beachten sie, dass diese von PHP nicht untersttzt
	 werden.)  Auch diese haben keine Lnge oder Nachkommastellen.
	</simpara>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>D</term>
       <listitem>
	<simpara>
	 Datum (gespeichert als JJJJMMTT). Ebenfalls keine Lnge und
	 Nachkommastellen.
	</simpara>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>N</term>
       <listitem>
	<simpara>
	 Zahl. Diese haben sowohl eine Angabe der Lnge als auch der
	 Nachkommastellen.
	</simpara>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>C</term>
       <listitem>
	<simpara>
	 Zeichenkette / String / Charakter. Hier ist eine Lngenangabe
	 erforderlich.
	</simpara>
       </listitem>
      </varlistentry>
     </variablelist>
    </para>
    <para>
     Konnte die Datenbank erfolgreich erzeugt werden, wird ein
     dbase_identifier zurck 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 "&lt;strong>Error!&lt;/strong>";
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dbase-open">
   <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 fr die geffnete Datenbank zurck
     oder &false; / falsch, wenn die Datenbank nicht geffnet werden
     konnte.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dbase-close">
   <refnamediv>
    <refname>dbase_close</refname>
    <refpurpose>Schliet 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>
     Schliet die durch <parameter>dbase_identifier</parameter>
     angegebene Datenbank.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dbase-pack">
   <refnamediv>
    <refname>dbase_pack</refname>
    <refpurpose>
     Entfernt die als gelscht markierten Datenstze 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 gelscht markierten
     Datenstze endgltig (physisch).  Betroffen sind alle vorher per
     <function>dbase_delete_record</function> als gelscht markierten
     Datenstze.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.dbase-add-record">
   <refnamediv>
    <refname>dbase_add_record</refname>
    <refpurpose>
     Hngt 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>
     Hngt den per <parameter>record</parameter> definierten Datensatz
     an die Datenbank an. Wenn die Anzahl der Eintrge im angegebenen
     Record nicht gleich der Anzahl der Felder in der Datenbank ist,
     wird dieser Befehl scheitern und &false; / falsch zurck geben.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dbase-replace-record">
   <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 Eintrge ungleich der Anzahl der Datenfelder in
     dem angesprochenen Datensatz ist, wird die Ausfhrung dieses
     Befehls abgewiesen und &false; / falsch zurck 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> zurck gegeben wird).
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.dbase-delete-record">
   <refnamediv>
    <refname>dbase_delete_record</refname>
    <refpurpose>Markiert einen Datensatz als gelscht</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Bschreibung:</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 gelscht.  Um ihn wirklich (physisch) zu entfernen,
     mssen sie noch die Funktion <function>dbase_pack</function>
     aufrufen.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dbase-get-record">
   <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
     zurck. Das Array hat einen bei 0 beginnenden Index und enthlt
     einen zustzlichen Bereich der mit 'deleted' bezeichnet wird.
     Dieser ist auf 1 gesetzt, wenn der Datensatz als gelscht
     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>

  <refentry id="function.dbase-get-record-with-names">
   <refnamediv>
    <refname>dbase_get_record_with_names</refname>
    <refpurpose>
     Gibt einen Datensatz einer dBase-Datenbank als assoziatives
     Array zurck
    </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 zurck. Das Array enthlt auch einen
     assoziativen Bereich, der 'deleted' heisst und auf 1 steht, wenn
     der Datensatz als gelscht 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>

  <refentry id="function.dbase-numfields">
   <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 zurck. Feld-Nummern sind Werte zwischen 0 und
     dbase_numfields($db)-1, wogegen die Datensatz-Werte zwischen 1 
     und dbase_numrecords($db) sein knnen.
     <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 &lt; $nf; $i++) {
         print $rec[$i]."&lt;br>\n";
       }
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dbase-numrecords">
   <refnamediv>
    <refname>dbase_numrecords</refname>
    <refpurpose>
     Ermittelt die Anzahl der Datenstze 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 Datenstze (Zeilen) in der angegebenen
     Datenbank zurck. Datensatz-Nummern knnen Werte zwischen 1 und
     dbase_numrecords($db) sein, wogegen Feld-Werte zwischen 0 und
     dbase_numfields($db)-1 sein knnen.
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- 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:
-->