<?xml version='1.0' encoding='iso-8859-1' ?>
<reference id='ref.msql'>
  <title>mSQL Funktionen</title>
  <titleabbrev>mSQL</titleabbrev>
  <partintro>
   <simpara>
    Diese Funktionen erlauben Ihnen, auf einen mSQL-Datenbankserver
    zuzugreifen. Um ber diese Funktionen verfgen zu knnen, mssen
    Sie PHP mit der mSQL-Untersttzung kompilieren, indem Sie die
    Option
    <option role='configure'>--with-msql[=dir]</option> angeben.
    Das Standardverzeichnis ist /usr/local/Hughes.
   </simpara>
   <simpara>
   Mehr Informationen ber mSQL findet man bei <ulink url="&url.msql;">
   &url.msql;</ulink>.
   </simpara>
  </partintro>

  <refentry id='function.msql'>
   <refnamediv>
    <refname>msql</refname>
    <refpurpose>Sendet eine mSQL- Abfrage an den Datenbankserver</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql</methodname>
      <methodparam><type>string</type><parameter>database</parameter></methodparam>
      <methodparam><type>string</type><parameter>query</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt eine positive Zahl als mSQL Ergebniskennung fr diese Abfrage
     zurck oder &false; bei einem Fehler
     </para>
    <para>
     <function>msql</function> whlt eine Datenbank aus und fhrt auf
     ihr eine Abfrage aus. Falls die optionale Verbindungskennung nicht
     angegeben ist, versucht die Funktion, eine offene Verbindung zum
     Datenbankserver zu finden. Wenn keine Verbindung gefunden wird,
     wird versucht, eine zu erzeugen, so als wrde
     <function>msql_connect</function> ohne Argumente aufgerufen.
     (siehe <function>msql_connect</function>).
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-affected-rows'>
   <refnamediv>
    <refname>msql_affected_rows</refname>
    <refpurpose>Gibt die Anzahl der betroffenen Datenstze zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_affected_rows</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die Anzahl Datenstze zurck, die von der letzten Abfrage
     betroffen ("berhrt") wurden. (z. B. die Anzahl der Zeilen, die
     von einem SELECT zurckgeliefert wurden, die Anzahl der Zeilen,
     die durch einen UPDATE gendert wurden oder die Anzahl der Zeilen,
     die von einem DELETE gelscht wurden.)
     </para>
    <para>
     Siehe auch: <function>msql_query</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-close'>
   <refnamediv>
    <refname>msql_close</refname>
    <refpurpose>Schliesst eine mSQL-Verbindung</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_close</methodname>
      <methodparam><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt bei Erfolg &true; zurck, bei einem Fehler &false;.
    </para>
    <para>
     <function>msql_close</function> schliesst die mit der angegebenen
     Verbindungskennung verknpfte Verbindung zum mSQL Datenbankserver.
     Falls die Verbindungskennung nicht angegeben ist, wird die zuletzt
     geffnete Verbindung geschlossen.
    </para>
    <para>
     Beachten Sie, dass diese Funktion normalerweise nicht notwendig
     ist, weil geffnete nicht-persistente Verbindungen automatisch
     geschlossen werden, wenn die Ausfhrung des Skripts beendet ist.
    </para>
    <para>
     <function>msql_close</function> schliesst keine persistenten
     Verbindungen, die mit <function>msql_pconnect</function> geffnet
     wurden.
    </para>
    <para>
     Siehe auch: <function>msql_connect</function> und
     <function>msql_pconnect</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-connect'>
   <refnamediv>
    <refname>msql_connect</refname>
    <refpurpose>ffnet eine mSQL Verbindung</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_connect</methodname>
      <methodparam choice="opt"><type>string</type><parameter>
        server
       </parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        username
       </parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        password
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt bei Erfolg eine positive Zahl als Verbindungskennung zurck
     oder &false; bei einem Fehler.
    </para>
    <para>
     <function>msql_connect</function> erzeugt eine Verbindung zu einem
     mSQL Datenbankserver. Die Angabe eines Hostnamens als Argument ist
     optional. Wenn Hostname fehlt, wird localhost vorausgesetzt.
    </para>
    <para>
     Falls
     <function>msql_connect</function> zum zweiten Mal mit denselben
     Argumenten aufgerufen wird, wird keine neue Verbindung erzeugt,
     stattdessen wird die Verbindungskennung der aktuell geffneten
     Verbindung zurckgegeben.
    </para>
    <para>
     Die Verbindung zum Server wird geschlossen, sobald die Ausfhrung
     des Skripts beendet ist, es sei denn, die Verbindung wurde zuvor
     durch einen expliziten Aufruf von
     <function>msql_close</function> beendet.
    </para>
    <para>
     Siehe auch <function>msql_pconnect</function>,
     <function>msql_close</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-create-db'>
   <refnamediv>
    <refname>msql_create_db</refname>
    <refpurpose>Erzeugt eine mSQL Datenbank</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_create_db</methodname>
      <methodparam><type>string</type><parameter>database name</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     msql_create_db() erzeugt eine neue Datenbank auf dem mSQL-Server,
     die mit der angegebenen Verbindungskennung verknpft ist.
    </para>
    <para> Siehe auch: <function>msql_drop_db</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-createdb'>
   <refnamediv>
    <refname>msql_createdb</refname>
    <refpurpose>Erzeugt eine mSQL Datenbank</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_createdb</methodname>
      <methodparam><type>string</type><parameter>database name</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Identisch mit <function>msql_create_db</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-data-seek'>
   <refnamediv>
    <refname>msql_data_seek</refname>
    <refpurpose>Bewegt den internen Datensatzzeiger</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_data_seek</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>row_number</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt bei Erfolg &true; zurck, bei Fehler &false;.
    </para>
    <para>
     <function>msql_data_seek</function> bewegt den internen
     Datensatzzeiger der mSQL Ergebnismenge, die mit der angegebenen
     Abfrage-ID verknpft ist, zu der bergebenen Zeile. Der nchste
     Aufruf von <function>msql_fetch_row</function> gibt diese Zeile
     zurck.
    </para>
    <para>
     Siehe auch: <function>msql_fetch_row</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-dbname'>
   <refnamediv>
    <refname>msql_dbname</refname>
    <refpurpose>Gibt den aktuellen mSQL Datenbanknamen zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_dbname</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_dbname</function> gibt den Namen der Datenbank
     zurck, die auf Position <parameter>i</parameter> in der
     Ergebnismenge der Funktion <function>msql_listdbs</function>
     gespeichert ist. Die Funktion
     <function>msql_numrows</function> kann benutzt werden, um zu
     sehen, wieviele Datenbanknamen verfgbar sind.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-drop-db'>
   <refnamediv>
    <refname>msql_drop_db</refname>
    <refpurpose>Lscht eine mSQL Datenbank</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_drop_db</methodname>
      <methodparam><type>string</type><parameter>database_name</parameter></methodparam>
      <methodparam><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt bei Erfolg &true; zurck, bei Fehler &false;.
    </para>
    <para>
     <function>msql_drop_db</function> lscht eine Datenbank, die mit der
      bergebenen Verbindungskennung verknpft ist, vollstndig vom Server.
    </para>
    <para>
     Siehe auch: <function>msql_create_db</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-dropdb'>
   <refnamediv>
    <refname>msql_dropdb</refname>
    <refpurpose>Lscht eine mSQL Datenbank</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <para>
     Siehe <function>msql_drop_db</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-error'>
   <refnamediv>
    <refname>msql_error</refname>
    <refpurpose>Gibt die letzte mSQL-Fehlermeldung zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_error</methodname>
      <methodparam><type></type><parameter/></methodparam>
     </methodsynopsis>
    <para>
     Fehler, die von mSQL zurckgeliefert werden, geben keine Warnungen
     mehr aus. Benutzen Sie diese Funktion, um den Error-String
     zu erhalten.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-fetch-array'>
   <refnamediv>
    <refname>msql_fetch_array</refname>
    <refpurpose>Holt einen Datensatz als assoziatives Array</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_fetch_array</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die Inhalte des gelesenen Datensatzes in einem assoziativen
     Array zurck oder &false;, falls kein Datensatz mehr gelesen werden
     kann.
    </para>
    <para>
     <function>msql_fetch_array</function> ist eine erweiterte Version
     von <function>msql_fetch_row</function>. Zustzlich zur Speicherung
     der Daten in einem numerischen Array speichert diese Funktion den
     Datensatz mit assoziativen Indizes, indem sie die Feldnamen als
     Schlssel benutzt.
    </para>
    <para>
     Das zweite, optionale Argument <parameter>result_type</parameter>
     in <function>msql_fetch_array</function> ist eine Konstante, die
     die folgenden Werte annehmen kann: MSQL_ASSOC, MSQL_NUM, und
     MYSQL_BOTH.
    </para>
    <para>
     Seien Sie vorsichtig, wenn Sie ein Abfrageergebnis haben, das
     einen Datensatz zurckliefert, das nur ein Feld enthlt, welches
     den Wert 0 (oder einen leeren String oder &null;) enthlt.
    </para>
    <para>
     Wichtig zu bemerken ist,
     <function>msql_fetch_array</function> ist NICHT wesentlich langsamer
     als <function>msql_fetch_row</function>, obwohl es einen zustzlichen
     Ergebniswert zurckgibt.
    </para>
    <para>
     Fr weitere Einzelheiten siehe
     <function>msql_fetch_row</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-fetch-field'>
   <refnamediv>
    <refname>msql_fetch_field</refname>
    <refpurpose>Gibt Feldinformationen in einem Objekt zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>object</type><methodname>msql_fetch_field</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt Feldinformationen in einem Objekt zurck
    </para>
    <para>
     <function>msql_fetch_field</function> kann benutzt werden, um
     Informationen ber Felder eines bestimmten Abfrageergebnisses in
     einem Objekt zu erhalten. Falls der Feldname nicht angegeben
     wurde, wird das nchste, noch nicht mit
     <function>msql_fetch_field</function> geholte Feld zurckgegeben.
    </para>
    <para>
     Die Eigenschaften dieses Objekts sind:
     <itemizedlist>
      <listitem>
       <simpara>
        name - Spaltenname
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        table - Tabellenname, zu der die Spalte gehrt
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        not_null - 1 falls die Spalte keine NULL-Werte erlaubt
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        primary_key - 1 falls das Feld ein Primrschlssel ist
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        unique - 1 falls die Spalte ein eindeutiger Schlssel ist
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        type - der Typ der Spalteninhalte
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     Siehe auch <function>msql_field_seek</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-fetch-object'>
   <refnamediv>
    <refname>msql_fetch_object</refname>
    <refpurpose>Holt einen Datensatz als Objekt</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_fetch_object</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt ein Objekt mit den Eigenschaften jeder Spalte der geholten Zeile
     eines Abfrageergebnisses zurck, oder &false;, falls keine Zeilen mehr
     geholt werden knnen.
    </para>
    <para>
     <function>msql_fetch_object</function> ist hnlich wie
     <function>msql_fetch_array</function>, mit einem Unterschied - dass
     ein Objekt anstelle eines Arrays zurckgegeben wird. Indirekt bdeutet
     das, dass man auf die Daten nur ber die Feldnamen zugreifen kann,
     und nicht ber ihre Feldnummern. (Ziffern sind unzulssige Namen fr
     Eigenschaften.)
    </para>
    <para>
     Das optionale zweite Argument <parameter>result_type</parameter>
     in <function>msql_fetch_array</function> ist eine Konstante, die die
     folgenden Werte annehmen kann: MSQL_ASSOC, MSQL_NUM, und MSQL_BOTH.
    </para>
    <para>
     In der Geschwindigkeit ist die Funktion identisch zu
     <function>msql_fetch_array</function>, und fast so schnell wie
     <function>msql_fetch_row</function> (der Unterschied ist unerheblich).
    </para>
    <para> Siehe auch:
     <function>msql_fetch_array</function> und
     <function>msql_fetch_row</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-fetch-row'>
   <refnamediv>
    <refname>msql_fetch_row</refname>
    <refpurpose>Holt einen Datensatz als numerisches Array</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>msql_fetch_row</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt ein Array mit einem Element fr jede Spalte des Datensatzes
     zurck, oder &false;, falls kein Datensatz mehr geholt werden kann.
    </para>
    <para>
     <function>msql_fetch_row</function> holt einen Datensatz des
     Abfrageergebnisses, das mit dem Ergebnisbezeichner verknpft ist.
     Der Datensatz wird als Array zurckgegeben. Alle Spalteninhalte des
     Ergebnisses werden unter einem numerischen Index, der bei 0 beginnt,
     abgelegt.
    </para>
    <para>
     Aufeinanderfolgende Aufrufe von <function>msql_fetch_row</function>
     geben jeweils die nchste Zeile des Abfrageergebnisses zurck, oder
     &false;, wenn keine Datenstze mehr gelesen werden knnen.
    </para>
    <para>
     Siehe auch: <function>msql_fetch_array</function>,
     <function>msql_fetch_object</function>,
     <function>msql_data_seek</function>, und
     <function>msql_result</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-fieldname'>
   <refnamediv>
    <refname>msql_fieldname</refname>
    <refpurpose>Gibt den Feldnamen zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_fieldname</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fieldname</function> Gibt den Namen des bezeichneten
     Feldes zurck.  <parameter>query_identifier</parameter> ist der
     Ergebnisbezeichner, und <parameter>field</parameter> ist der Index
     des Feldes. <literal>msql_fieldname($result, 2);</literal> gibt
     den Namen des dritten Feldes des Abfrageergebnisses zurck, das
     mit dem Ergebnisbezeichner verknpft ist.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-field-seek'>
   <refnamediv>
    <refname>msql_field_seek</refname>
    <refpurpose>Setzt den internen Feld-Zeiger auf den angegebenen Feldindex</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_field_seek</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
     </methodsynopsis>
    <para>
     Setzt den internen Feld-Zeiger auf das angegebenen Feld. Falls der
     nchste Aufruf von <function>msql_fetch_field</function> keinen
     Parameter fr den Index enthlt, wird dieses Feld zurckgegeben.
    </para>
    <para>
     Siehe auch: <function>msql_fetch_field</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-fieldtable'>
   <refnamediv>
    <refname>msql_fieldtable</refname>
    <refpurpose>Gibt den Tabellennamen fr ein Feld zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_fieldtable</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt den Namen der Tabelle zurck, von wo <parameter>field</parameter>
     das Feld gelesen wurde.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-fieldtype'>
   <refnamediv>
    <refname>msql_fieldtype</refname>
    <refpurpose>Gibt den Datentyp des angegebenen Feldes zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_fieldtype</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fieldtype</function> ist hnlich wie die Funktion
     <function>msql_fieldname</function>. Die Argumente sind identisch,
     nur wird hier der Typ des Feldes zurckgegeben. Das kann "int",
     "char" oder "real" sein.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-fieldflags'>
   <refnamediv>
    <refname>msql_fieldflags</refname>
    <refpurpose>Gibt alle Flags fr das angegebene Feld zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_fieldflags</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fieldflags</function> gibt die Flags fr das
     angegebene Feld zurck. Im Moment ist das entweder "not &null;",
     "primary key", eine Kombination der beiden Flags oder ""
     (ein leerer String).
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-fieldlen'>
   <refnamediv>
    <refname>msql_fieldlen</refname>
    <refpurpose>Gibt die Lnge des angegebenen Feldes zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_fieldlen</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fieldlen</function> gibt die Lnge des angegebenen
     Feldes zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-free-result'>
   <refnamediv>
    <refname>msql_free_result</refname>
    <refpurpose>Gibt den durch Ergebnisse belegten Speicher frei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_free_result</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
    <function>msql_free_result</function> gibt den Speicher, den das
     mit <parameter>query_identifier</parameter> verknpfte Ergebnis
     belegt hat, frei. Wenn PHP ein Skript beendet, wird dieser
     Speicher automatisch freigegeben, so dass man diese Funktion nur
     aufrufen muss, um sicher zu sein, nicht zuviel Speicherplatz
     whrend der Laufzeit des Skripts zu belegen.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-freeresult'>
   <refnamediv>
    <refname>msql_freeresult</refname>
    <refpurpose>Gibt den durch Ergebnisse belegten Speicher frei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <para>Siehe <function>msql_free_result</function></para>
   </refsect1>
  </refentry>


  <refentry id='function.msql-list-fields'>
   <refnamediv>
    <refname>msql_list_fields</refname>
    <refpurpose>Listet alle Felder einer Tabelle auf</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_list_fields</methodname>
      <methodparam><type>string</type><parameter>database</parameter></methodparam>
      <methodparam><type>string</type><parameter>tablename</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_list_fields</function> liefert Informationen
     ber die angegebene Tabelle. Argumente sind der Name der Datenbank
     und der Tabellenname. Ein Ergebnisbezeichner wird zurckgegeben,
     der mit
     <function>msql_fieldflags</function>,
     <function>msql_fieldlen</function>,
     <function>msql_fieldname</function>, und
     <function>msql_fieldtype</function> benutzt werden kann. Ein
     Ergebnisbezeichner ist eine positive Ganzzahl. Die Funktion gibt
     <literal>-1</literal> zurck, falls ein Fehler auftritt. Ein String,
     der den Fehler beschreibt, wird in <literal>$phperrmsg</literal>
     geschrieben und auf dem Bildschirm ausgegeben, es sei denn, die
     Funktion wurde als <literal>@msql_list_fields()</literal> aufgerufen.
    </para>
    <para>
     Siehe auch <function>msql_error</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-listfields'>
   <refnamediv>
    <refname>msql_listfields</refname>
    <refpurpose>Listet alle Felder einer Tabelle auf</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <para>
     Siehe <function>msql_list_fields</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-list-dbs'>
   <refnamediv>
    <refname>msql_list_dbs</refname>
    <refpurpose>Listet alle mSQL Datenbanken auf dem Server auf</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_list_dbs</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>msql_list_dbs</function> gibt einen Ergebnisbezeichner
     zurck, der Namen aller Datenbanken, die auf dem mSQL-Server liegen,
     enthlt. Mit der Funktion <function>msql_dbname</function> kann
     dieser Ergebnisbezeichner durchlaufen werden.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-listdbs'>
   <refnamediv>
    <refname>msql_listdbs</refname>
    <refpurpose>Listet alle mSQL Datenbanken auf dem Server auf</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <para>
     Siehe <function>msql_list_dbs</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-list-tables'>
   <refnamediv>
    <refname>msql_list_tables</refname>
    <refpurpose>Listet alle Tabellen einer mSQL-Datenbank auf</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_list_tables</methodname>
      <methodparam><type>string</type><parameter>database</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_list_tables</function> hat als Argumente einen
     Datenbanknamen und liefert Ergebnisbezeichner, fast gleich,
     wie die Funktion <function>msql</function>. Die Funktion
     <function>msql_tablename</function> sollte benutzt werden, um die
     aktuellen Tabellennamen aus dem Ergebnisbezeichner zu erhalten.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-listtables'>
   <refnamediv>
    <refname>msql_listtables</refname>
    <refpurpose>Listet alle Tabellen einer mSQL-Datenbank auf</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <para>
     Siehe <function>msql_list_tables</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-num-fields'>
   <refnamediv>
    <refname>msql_num_fields</refname>
    <refpurpose>Gibt die Anzahl der Felder eines Abfrageergebnisses zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_num_fields</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_num_fields</function> Gibt die Anzahl der Felder eines
     Abfrageergebnisses zurck.
    </para>
    <para>
     Siehe auch: <function>msql</function>,
     <function>msql_query</function>,
     <function>msql_fetch_field</function>, und
     <function>msql_num_rows</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-num-rows'>
   <refnamediv>
    <refname>msql_num_rows</refname>
    <refpurpose>Gibt die Anzahl der Zeilen eines Abfrageergebnisses zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_num_rows</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_num_rows</function> Gibt die Anzahl der Zeilen eines
     Abfrageergebnisses zurck.
    </para>
    <para>
     Siehe auch: <function>msql</function>,
     <function>msql_query</function>, und
     <function>msql_fetch_row</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-numfields'>
   <refnamediv>
    <refname>msql_numfields</refname>
    <refpurpose>Gibt die Anzahl der Felder eines Abfrageergebnisses zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_numfields</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Identisch zu <function>msql_num_fields</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-numrows'>
   <refnamediv>
    <refname>msql_numrows</refname>
    <refpurpose>Gibt die Anzahl der Zeilen eines Abfrageergebnisses zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_numrows</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Identisch zu <function>msql_num_rows</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-pconnect'>
   <refnamediv>
    <refname>msql_pconnect</refname>
    <refpurpose>ffnet eine persistente mSQL Verbindung</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_pconnect</methodname>
      <methodparam choice="opt"><type>string</type><parameter>
        server
       </parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        username
       </parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        password
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt bei Erfolg eine positive Zahl als mSQL Verbindungskennung
     fr die persistente Verbindung zurck, oder &false; bei einem Fehler.
    </para>
    <para>
     <function>msql_pconnect</function> verhlt sich sehr hnlich wie
     <function>msql_connect</function>, mit zwei grossen Unterschieden.
    </para>
    <para>
     Erstens, wenn die Verbindung aufgebaut wird, prft die Funktion
     zuerst, ob eine geffnete persistente Verbindung zu demselben Host
     besteht. Wird eine Verbindung gefunden, wird deren Verbindungskennung
     zurckgegeben anstatt eine neue Verbindung aufzubauen.
    </para>
    <para>
     Zweitens, die Verbindung zum mSQL-Server wird nicht geschlossen, wenn
     die Ausfhrung des Skripts beendet ist. Stattdessen bleibt die Verbindung
     fr den spteren Gebrauch offen. (<function>msql_close</function> schliesst
     keine Verbindungen, die mit <function>msql_pconnect</function> erzeugt
     wurden).
    </para>
    <para>
     Darum wird diese Verbindungsart als 'persistent' bezeichnet.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-query'>
   <refnamediv>
    <refname>msql_query</refname>
    <refpurpose>Schickt eine mSQL-Abfrage zum Server</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_query</methodname>
      <methodparam><type>string</type><parameter>query</parameter></methodparam>
      <methodparam><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_query</function> schickt eine Datenbankabfrage
     an die aktuelle Datenbank auf dem Server, die mit der angegebenen
     Verbindungskennung verknpft ist. Wenn keine Verbindungskennung
     angegeben ist, wird die zuletzt geffnete Verbindung angenommen.
     Falls keine Verbindung geffnet ist, versucht die Funktion, eine
     Verbindung aufzubauen, die sie so benutzt, als wre
     <function>msql_connect</function> aufgerufen worden.
    </para>
    <para>
     Gibt bei Erfolg eine positive Zahl als mSQL Verbindungskennung
     zurck, &false; bei einem Fehler.
    </para>
    <para>
     Siehe auch: <function>msql</function>,
     <function>msql_select_db</function>, und
     <function>msql_connect</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-regcase'>
   <refnamediv>
    <refname>msql_regcase</refname>
    <refpurpose>
     bersetzt einen case-sensitiven regulren Ausdruck in einen insensitiven Ausdruck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <para>Siehe <function>sql_regcase</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-result'>
   <refnamediv>
    <refname>msql_result</refname>
    <refpurpose>Holt den Wert eines einzelnen Feldes der bergebenen Zeile</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_result</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>i</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt den Wert zurck, der in der bergebenen Zeile und Spalte des
     bezeichneten mSQL-Abfrageergebnisses steht.
    </para>
    <para>
     <function>msql_result</function> gibt den Inhalt einer Tabellenzelle
     des mSQL-Abfrageergebnisses zurck. Das field Argument kann sowohl
     der Index als auch der Feldname des Feldes sein, oder, ein mit dem
     Tabellennamen qualifizierter Feldname (Tabellenname.Feldname). Falls
     der Spaltenname ein Alias ist ('select foo as bar from ...'), wird
     der Aliasname anstatt des Feldnamens angegeben.
    </para>
    <para>
     Wenn man mit grossen Abfrageergebnissen arbeitet, sollte man die
     Benutzung der Funktionen in Betracht ziehen, die ganze Zeilen
     aus der Tabelle auslesen (wie unten beschrieben). Weil diese
     Funktionen die Inhalte von verschiedene Tabellenzellen in einem
     Funktionsaufruf holen, sind sie viel schneller als
     <function>msql_result</function>.  Beachten sie auch, dass die Angabe
     eines numerischen Index fr das field Argument viel schneller ist, als
     die Angabe eines Feldnamens oder eines Tabellenname.Feldname Arguments.
    </para>
    <para>
     Empfohlene Alternativen mit hoher Ausfhrungsgeschwindigkeit:
     <function>msql_fetch_row</function>,
     <function>msql_fetch_array</function>, und
     <function>msql_fetch_object</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-select-db'>
   <refnamediv>
    <refname>msql_select_db</refname>
    <refpurpose>Whlt eine mSQL Datenbank aus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_select_db</methodname>
      <methodparam><type>string</type><parameter>database_name</parameter></methodparam>
      <methodparam><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt bei Erfolg &true; zurck, &false; bei einem Fehler.
    </para>
    <para>
     <function>msql_select_db</function> whlt die aktuell aktive
     Datenbank, die mit der bergebenen Verbindungskennung verknpft
     ist, auf dem Server aus. Falls keine Verbindungskennung angegeben
     wurde, wird die zuletzt geffnete Verbindung vorausgesetzt. Falls
     keine Verbindung geffnet ist, versucht die Funktion eine Verbindung
     aufzubauen und zu benutzen, so als wre <function>msql_connect</function>
     aufgerufen worden.
    </para>
    <para>
     Jeder nachfolgende Aufruf von <function>msql_query</function> bezieht
     sich auf die aktive Datenbank.
    </para>
    <para>
     Siehe auch: <function>msql_connect</function>,
     <function>msql_pconnect</function>, und
     <function>msql_query</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-selectdb'>
   <refnamediv>
    <refname>msql_selectdb</refname>
    <refpurpose>Whlt eine mSQL Datenbank aus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <para>Siehe <function>msql_select_db</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.msql-tablename'>
   <refnamediv>
    <refname>msql_tablename</refname>
    <refpurpose>Gibt den Tabellennamen fr ein Feld zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_tablename</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_tablename</function> hat als Argumente einen
     Ergebnisbezeichner, der von der Funktion <function>msql_list_tables</function>
     zurckgegeben wurde, und einen Integerwert und gibt den Namen
     einer Tabelle zurck. Die Funktion <function>msql_numrows</function>
     kann benutzt werden, um die Anzahl der Tabellen in einem
     Ergebnisbezeichner festzustellen.
     <example>
      <title><function>msql_tablename</function> example</title>
      <programlisting role='php'>
&lt;?php
msql_connect ("localhost");
$result = msql_list_tables ("wisconsin");
$i = 0;
while ($i &lt; msql_numrows ($result)) {
    $tb_names[$i] = msql_tablename ($result, $i);
    echo $tb_names[$i] . "&lt;BR>";
    $i++;
}
?>
      </programlisting>
     </example>
    </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:
-->