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