eschmid Mon Apr 16 13:26:33 2001 EDT
Modified files:
/phpdoc/de Translators
/phpdoc/de/functions msql.xml
Log:
Translation by Cornelia Boenigk.
Index: phpdoc/de/Translators
diff -u phpdoc/de/Translators:1.152 phpdoc/de/Translators:1.153
--- phpdoc/de/Translators:1.152 Sat Apr 14 02:37:26 2001
+++ phpdoc/de/Translators Mon Apr 16 13:26:33 2001
@@ -23,6 +23,7 @@
zimt Peter Petermann [EMAIL PROTECTED]
Urs Gehrig [EMAIL PROTECTED]
Friedhelm Betz [EMAIL PROTECTED]
+ Cornelia Boenigk [EMAIL PROTECTED]
Thomas Schöfbeck [EMAIL PROTECTED]
@@ -93,6 +94,7 @@
mcrypt.xml Mark Kronsbein in Arbeit
mhash.xml Jan Lehnardt fertig
misc.xml Thomas Schuermann fertig
+msql.xml Cornelia Boenigk fertig
mssql.xml Martin Samesch fertig
mysql.xml Uwe Steinmann fertig
network.xml Thomas Schuermann fertig (bis V. 1.26)
Index: phpdoc/de/functions/msql.xml
diff -u /dev/null phpdoc/de/functions/msql.xml:1.6
--- /dev/null Mon Apr 16 13:26:33 2001
+++ phpdoc/de/functions/msql.xml Mon Apr 16 13:26:33 2001
@@ -0,0 +1,1185 @@
+<?xml version='1.0'?>
+<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 verfügen zu können, müssen
+ Sie PHP mit der mSQL-Unterstützung 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql</function></funcdef>
+ <paramdef>string <parameter>database</parameter></paramdef>
+ <paramdef>string <parameter>query</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>link_identifier</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt eine positive Zahl als mSQL Ergebniskennung für diese Abfrage
+ zurück oder false bei einem Fehler
+ </para>
+ <para>
+ <function>msql</function> wählt eine Datenbank aus und führt 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 würde
+ <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 Datensätze zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_affected_rows</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt die Anzahl Datensätze zurück, die von der letzten Abfrage
+ betroffen ("berührt") wurden. (z. B. die Anzahl der Zeilen, die
+ von einem SELECT zurückgeliefert wurden, die Anzahl der Zeilen,
+ die durch einen UPDATE geändert wurden oder die Anzahl der Zeilen,
+ die von einem DELETE gelöscht 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_close</function></funcdef>
+ <paramdef>int <parameter>link_identifier</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt bei Erfolg true zurück, bei einem Fehler false.
+ </para>
+ <para>
+ <function>msql_close</function> schliesst die mit der angegebenen
+ Verbindungskennung verknüpfte Verbindung zum mSQL Datenbankserver.
+ Falls die Verbindungskennung nicht angegeben ist, wird die zuletzt
+ geöffnete Verbindung geschlossen.
+ </para>
+ <para>
+ Beachten Sie, dass diese Funktion normalerweise nicht notwendig
+ ist, weil geöffnete nicht-persistente Verbindungen automatisch
+ geschlossen werden, wenn die Ausführung des Skripts beendet ist.
+ </para>
+ <para>
+ <function>msql_close</function> schliesst keine persistenten
+ Verbindungen, die mit <function>msql_pconnect</function> geöffnet
+ 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_connect</function></funcdef>
+ <paramdef>string
+ <parameter>
+ <optional>hostname</optional>
+ </parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>hostname<optional>:port</optional></optional>
+ </parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>username</optional>
+ </parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>password</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt bei Erfolg eine positive Zahl als Verbindungskennung zurück
+ 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 geöffneten
+ Verbindung zurückgegeben.
+ </para>
+ <para>
+ Die Verbindung zum Server wird geschlossen, sobald die Ausführung
+ 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_create_db</function></funcdef>
+ <paramdef>string <parameter>database name</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>link_identifier</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ msql_create_db() erzeugt eine neue Datenbank auf dem mSQL-Server,
+ die mit der angegebenen Verbindungskennung verknüpft 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_createdb</function></funcdef>
+ <paramdef>string <parameter>database name</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>link_identifier</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_data_seek</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int <parameter>row_number</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt bei Erfolg true zurück, bei Fehler false.
+ </para>
+ <para>
+ <function>msql_data_seek</function> bewegt den internen
+ Datensatzzeiger der mSQL Ergebnismenge, die mit der angegebenen
+ Abfrage-ID verknüpft ist, zu der übergebenen Zeile. Der nächste
+ Aufruf von <function>msql_fetch_row</function> gibt diese Zeile
+ zurück.
+ </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 zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>msql_dbname</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int <parameter>i</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>msql_dbname</function> gibt den Namen der Datenbank
+ zurück, 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 verfügbar sind.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id='function.msql-drop-db'>
+ <refnamediv>
+ <refname>msql_drop_db</refname>
+ <refpurpose>Löscht eine mSQL Datenbank</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_drop_db</function></funcdef>
+ <paramdef>string <parameter>database_name</parameter></paramdef>
+ <paramdef>int <parameter>link_identifier</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt bei Erfolg true zurück, bei Fehler false.
+ </para>
+ <para>
+ <function>msql_drop_db</function> löscht eine Datenbank, die mit der
+ übergebenen Verbindungskennung verknüpft ist, vollständig 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>Löscht 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 zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>msql_error</function></funcdef>
+ <paramdef> <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Fehler, die von mSQL zurückgeliefert 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_fetch_array</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>result_type</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt die Inhalte des gelesenen Datensatzes in einem assoziativen
+ Array zurück 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>. Zusätzlich zur Speicherung
+ der Daten in einem numerischen Array speichert diese Funktion den
+ Datensatz mit assoziativen Indizes, indem sie die Feldnamen als
+ Schlüssel 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 zurückliefert, das nur ein Feld enthält, welches
+ den Wert 0 (oder einen leeren String oder NULL) enthält.
+ </para>
+ <para>
+ Wichtig zu bemerken ist,
+ <function>msql_fetch_array</function> ist NICHT wesentlich langsamer
+ als <function>msql_fetch_row</function>, obwohl es einen zusätzlichen
+ Ergebniswert zurückgibt.
+ </para>
+ <para>
+ Für 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 zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>object <function>msql_fetch_field</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int <parameter>field_offset</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt Feldinformationen in einem Objekt zurück
+ </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 nächste, noch nicht mit
+ <function>msql_fetch_field</function> geholte Feld zurückgegeben.
+ </para>
+ <para>
+ Die Eigenschaften dieses Objekts sind:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ name - Spaltenname
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ table - Tabellenname, zu der die Spalte gehört
+ </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 Primärschlüssel ist
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ unique - 1 falls die Spalte ein eindeutiger Schlüssel 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_fetch_object</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>result_type</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt ein Objekt mit den Eigenschaften jeder Spalte der geholten Zeile
+ eines Abfrageergebnisses zurück, oder false, falls keine Zeilen mehr
+ geholt werden können.
+ </para>
+ <para>
+ <function>msql_fetch_object</function> ist ähnlich wie
+ <function>msql_fetch_array</function>, mit einem Unterschied - dass
+ ein Objekt anstelle eines Arrays zurückgegeben wird. Indirekt bdeutet
+ das, dass man auf die Daten nur über die Feldnamen zugreifen kann,
+ und nicht über ihre Feldnummern. (Ziffern sind unzulässige Namen für
+ 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>msql_fetch_row</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt ein Array mit einem Element für jede Spalte des Datensatzes
+ zurück, 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 verknüpft ist.
+ Der Datensatz wird als Array zurückgegeben. 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 nächste Zeile des Abfrageergebnisses zurück, oder
+ false, wenn keine Datensätze mehr gelesen werden können.
+ </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 zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>msql_fieldname</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int <parameter>field</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>msql_fieldname</function> Gibt den Namen des bezeichneten
+ Feldes zurück. <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 zurück, das
+ mit dem Ergebnisbezeichner verknüpft 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_field_seek</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int <parameter>field_offset</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Setzt den internen Feld-Zeiger auf das angegebenen Feld. Falls der
+ nächste Aufruf von <function>msql_fetch_field</function> keinen
+ Parameter für den Index enthält, wird dieses Feld zurückgegeben.
+ </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 für ein Feld zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_fieldtable</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int <parameter>field</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt den Namen der Tabelle zurück, 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 zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>msql_fieldtype</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int <parameter>i</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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 zurückgegeben. Das kann "int",
+ "char" oder "real" sein.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id='function.msql-fieldflags'>
+ <refnamediv>
+ <refname>msql_fieldflags</refname>
+ <refpurpose>Gibt alle Flags für das angegebene Feld zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>msql_fieldflags</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int <parameter>i</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>msql_fieldflags</function> gibt die Flags für das
+ angegebene Feld zurück. 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 Länge des angegebenen Feldes zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_fieldlen</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int <parameter>i</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>msql_fieldlen</function> gibt die Länge des angegebenen
+ Feldes zurück.
+ </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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_free_result</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>msql_free_result</function> gibt den Speicher, den das
+ mit <parameter>query_identifier</parameter> verknüpfte 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
+ während 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_list_fields</function></funcdef>
+ <paramdef>string <parameter>database</parameter></paramdef>
+ <paramdef>string <parameter>tablename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>msql_list_fields</function> liefert Informationen
+ über die angegebene Tabelle. Argumente sind der Name der Datenbank
+ und der Tabellenname. Ein Ergebnisbezeichner wird zurückgegeben,
+ 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> zurück, 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_list_dbs</function></funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>msql_list_dbs</function> gibt einen Ergebnisbezeichner
+ zurück, der Namen aller Datenbanken, die auf dem mSQL-Server liegen,
+ enthält. 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_list_tables</function></funcdef>
+ <paramdef>string <parameter>database</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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
+zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_num_fields</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>msql_num_fields</function> Gibt die Anzahl der Felder eines
+ Abfrageergebnisses zurück.
+ </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
+zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_num_rows</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>Msql_num_rows</function> Gibt die Anzahl der Zeilen eines
+ Abfrageergebnisses zurück.
+ </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
+zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_numfields</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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
+zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_numrows</function></funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_pconnect</function></funcdef>
+ <paramdef>string
+ <parameter>
+ <optional>hostname</optional>
+ </parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>hostname<optional>:port</optional></optional>
+ </parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>username</optional>
+ </parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>password</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt bei Erfolg eine positive Zahl als mSQL Verbindungskennung
+ für die persistente Verbindung zurück, oder false bei einem Fehler.
+ </para>
+ <para>
+ <function>msql_pconnect</function> verhält sich sehr ähnlich wie
+ <function>msql_connect</function>, mit zwei grossen Unterschieden.
+ </para>
+ <para>
+ Erstens, wenn die Verbindung aufgebaut wird, prüft die Funktion
+ zuerst, ob eine geöffnete persistente Verbindung zu demselben Host
+ besteht. Wird eine Verbindung gefunden, wird deren Verbindungskennung
+ zurückgegeben anstatt eine neue Verbindung aufzubauen.
+ </para>
+ <para>
+ Zweitens, die Verbindung zum mSQL-Server wird nicht geschlossen, wenn
+ die Ausführung des Skripts beendet ist. Stattdessen bleibt die Verbindung
+ für den späteren 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_query</function></funcdef>
+ <paramdef>string <parameter>query</parameter></paramdef>
+ <paramdef>int <parameter>link_identifier</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>msql_query</function> schickt eine Datenbankabfrage
+ an die aktuelle Datenbank auf dem Server, die mit der angegebenen
+ Verbindungskennung verknüpft ist. Wenn keine Verbindungskennung
+ angegeben ist, wird die zuletzt geöffnete Verbindung angenommen.
+ Falls keine Verbindung geöffnet ist, versucht die Funktion, eine
+ Verbindung aufzubauen, die sie so benutzt, als wäre
+ <function>msql_connect</function> aufgerufen worden.
+ </para>
+ <para>
+ Gibt bei Erfolg eine positive Zahl als mSQL Verbindungskennung
+ zurück, 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 regulären 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_result</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int <parameter>i</parameter></paramdef>
+ <paramdef>mixed <parameter>field</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt den Wert zurück, 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 zurück. 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 für das field Argument viel schneller ist, als
+ die Angabe eines Feldnamens oder eines Tabellenname.Feldname Arguments.
+ </para>
+ <para>
+ Empfohlene Alternativen mit hoher Ausführungsgeschwindigkeit:
+ <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>Wählt eine mSQL Datenbank aus</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>msql_select_db</function></funcdef>
+ <paramdef>string <parameter>database_name</parameter></paramdef>
+ <paramdef>int <parameter>link_identifier</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt bei Erfolg true zurück, false bei einem Fehler.
+ </para>
+ <para>
+ <function>msql_select_db</function> wählt die aktuell aktive
+ Datenbank, die mit der übergebenen Verbindungskennung verknüpft
+ ist, auf dem Server aus. Falls keine Verbindungskennung angegeben
+ wurde, wird die zuletzt geöffnete Verbindung vorausgesetzt. Falls
+ keine Verbindung geöffnet ist, versucht die Funktion eine Verbindung
+ aufzubauen und zu benutzen, so als wäre <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>Wählt 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 für ein Feld zurück</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>msql_tablename</function></funcdef>
+ <paramdef>int <parameter>query_identifier</parameter></paramdef>
+ <paramdef>int <parameter>field</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>msql_tablename</function> hat als Argumente einen
+ Ergebnisbezeichner, der von der Funktion <function>msql_list_tables</function>
+ zurückgegeben wurde, und einen Integerwert und gibt den Namen
+ einer Tabelle zurück. 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'>
+<?php
+msql_connect ("localhost");
+$result = msql_list_tables ("wisconsin");
+$i = 0;
+while ($i < msql_numrows ($result)) {
+ $tb_names[$i] = msql_tablename ($result, $i);
+ echo $tb_names[$i] . "<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
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
