 |
 |
 |
 |
|
|
Date: 05/23/00
- Next message: Egon Schmid: "[PHPDOC] cvs: phpdoc /en/functions/ swf.xml"
- Previous message: Sterling Hughes: "[PHPDOC] cvs: phpdoc / manual.xml.in"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
eschmid Tue May 23 14:29:30 2000 EDT
Modified files:
/phpdoc/de/functions mysql.xml
Log:
Cleaned up a bit and a test for spaceing in the function prototypes.
Index: phpdoc/de/functions/mysql.xml
diff -u phpdoc/de/functions/mysql.xml:1.14 phpdoc/de/functions/mysql.xml:1.15
--- phpdoc/de/functions/mysql.xml:1.14 Mon Jan 24 13:49:32 2000
+++ phpdoc/de/functions/mysql.xml Tue May 23 14:29:30 2000
@@ -12,59 +12,101 @@
<para>
In diesem Dokument werden ein Reihe von Begriffen benutzt, die
hier kurz erläutert werden sollen.
- <simplelist>
- <member>Anfrageergebnis, Ergebnis - Die Rückgabe auf eine Anfrage
- an den Datenbankserver. Anfragen können sowohl Datenbankanfragen sein, die
- Teile des Datenbankinhalts umfassen oder Informationen über eine
- Datenbank oder den Datenbankserver liefern. Ist das Ergebnis eine
- Datenbankanfrage kann man es sich als Tabelle vorstellen,
- in der die Zeilen die Datensätze sind und die Felder den Spalten
- ensprechen. Ein Ergebnis besteht aus 0 oder beliebig vielen Datensätzen.</member>
- <member>Ergebnis-Kennung - Eine Referenz auf ein Ergebnis. Über diese
- Kennung erfolgt grundsätzlich der Zugriff auf das Ergebnis.</member>
- <member>Datensatz - Eine Zeile aus einem Anfrageergebnis bestehend aus
- den Werten der einzelnen Felder.</member>
- <member>Datensatzzeiger - Ein interner Zeiger auf einen Datensatz in
- einem Anfrageergebnis. Dieser Zeiger bestimmt auf welchen Datensatz
- zugegriffen wird. Der Zeiger kann sowohl impliziet als auch expliziet
- verändert werden.</member>
- <member>Feld - Entspricht einer Spalte im Anfrageergebnis.</member>
- <member>Feldzeiger - Wie Datensatzzeiger bei Zugriffen auf Felder
- eines Anfrageergebnisses.</member>
- <member>Verbindungs-Kennung - Eine Referenz auf eine Verbindung zum
- Datenbank-Server. Mit dieser Verbindung ist beispielsweise die
- Datenbank, der Benutzer,
- der Rechnername auf dem die Datenbank läuft und weiters verknüpft. Jeder
- Zugriff auf den Server nutzt diese Kennung. Wenn die
- Kennung beim Aufruf einer Funktion nicht angegeben wird, so wird
- die aktuelle Verbindungs-Kennung verwendet, die intern von PHP
- verwaltet wird.</member>
- </simplelist>
+
+ <variablelist>
+ <varlistentry><term>Anfrageergebnis, Ergebnis</term>
+ <listitem>
+ <para>
+ Die Rückgabe auf eine Anfrage an den Datenbankserver. Anfragen
+ können sowohl Datenbankanfragen sein, die Teile des
+ Datenbankinhalts umfassen oder Informationen über eine
+ Datenbank oder den Datenbankserver liefern. Ist das Ergebnis
+ eine Datenbankanfrage kann man es sich als Tabelle vorstellen,
+ in der die Zeilen die Datensätze sind und die Felder den
+ Spalten ensprechen. Ein Ergebnis besteht aus 0 oder beliebig
+ vielen Datensätzen.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>Ergebnis-Kennung</term>
+ <listitem>
+ <para>
+ Eine Referenz auf ein Ergebnis. Über diese Kennung erfolgt
+ grundsätzlich der Zugriff auf das Ergebnis.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>Datensatz</term>
+ <listitem>
+ <para>
+ Eine Zeile aus einem Anfrageergebnis bestehend aus den Werten
+ der einzelnen Felder.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>Datensatzzeiger</term>
+ <listitem>
+ <para>
+ Ein interner Zeiger auf einen Datensatz in einem
+ Anfrageergebnis. Dieser Zeiger bestimmt auf welchen Datensatz
+ zugegriffen wird. Der Zeiger kann sowohl impliziet als auch
+ expliziet verändert werden.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>Feld</term>
+ <listitem>
+ <para>
+ Entspricht einer Spalte im Anfrageergebnis.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>Feldzeiger</term>
+ <listitem>
+ <para>
+ Wie Datensatzzeiger bei Zugriffen auf Felder eines
+ Anfrageergebnisses.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>Verbindungs-Kennung</term>
+ <listitem>
+ <para>
+ Eine Referenz auf eine Verbindung zum Datenbank-Server. Mit
+ dieser Verbindung ist beispielsweise die Datenbank, der
+ Benutzer, der Rechnername auf dem die Datenbank läuft und
+ weiters verknüpft. Jeder Zugriff auf den Server nutzt diese
+ Kennung. Wenn die Kennung beim Aufruf einer Funktion nicht
+ angegeben wird, so wird die aktuelle Verbindungs-Kennung
+ verwendet, die intern von PHP verwaltet wird.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
</partintro>
<refentry id="function.mysql-affected-rows">
<refnamediv>
<refname>mysql_affected_rows</refname>
- <refpurpose>Liefert die Anzahl betroffener Datensätze einer vorhergehenden MySQL Operation</refpurpose>
+ <refpurpose>
+ Liefert die Anzahl betroffener Datensätze einer vorhergehenden
+ MySQL Operation
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<funcsynopsis>
<funcdef>int <function>mysql_affected_rows</function></funcdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_affected_rows</function> liefert die Anzahl
- betroffener Datensätze durch die letzte INSERT, UPDATE oder DELETE
- Anfrage an den Server, der mit der angegebenen Verbindungskennung
- assoziiert wird. Wenn die
- Verbindungskennung nicht angegeben wird, wird die zur Zeit offene
- Verbindung verwendet.
+ <function>Mysql_affected_rows</function> liefert die Anzahl
+ betroffener Datensätze durch die letzte INSERT, UPDATE oder
+ DELETE Anfrage an den Server, der mit der angegebenen
+ Verbindungskennung assoziiert wird. Wenn die Verbindungskennung
+ nicht angegeben wird, wird die zur Zeit offene Verbindung
+ verwendet.
</para>
<para>
Wenn die letzte Anfrage ein DELETE ohne WHERE-Anweisung war,
@@ -72,10 +114,10 @@
wird aber trotzdem Null zurückliefern.
</para>
<para>
- Diese Funktion macht keinen Sinn bei SELECT-Anfragen, sondern
- nur wenn Datensätze modifiziert wurden. Um die Anzahl der gelieferten
- Datensätze einer SELECT-Anfrage zu erhalten, benutzen Sie die Funktion
- <function>mysql_num_rows</function>.
+ Diese Funktion macht keinen Sinn bei SELECT-Anfragen, sondern nur
+ wenn Datensätze modifiziert wurden. Um die Anzahl der gelieferten
+ Datensätze einer SELECT-Anfrage zu erhalten, benutzen Sie die
+ Funktion <function>mysql_num_rows</function>.
</para>
</refsect1>
</refentry>
@@ -93,28 +135,18 @@
<funcdef>int <function>mysql_change_user</function></funcdef>
<paramdef>string <parameter>Benutzername</parameter></paramdef>
<paramdef>string <parameter>Kennwort</parameter></paramdef>
- <paramdef>string
- <parameter>
- <optional>Datenbank</optional>
- </parameter>
- </paramdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
- </funcsynopsis>
- <para>
- <function>mysql_change_user</function> ändert den angemeldeten
- Benutzer der Datenbank-Verbindung in den Benutzer mit dem übergebenen
- Namen und Kennwort.
- Fehlt die Verbindungs-Kennung wird die Änderung
- für die aktive Verbindung vorgenommen.
- If a database is
- specified, this will default or current database after the user
- has been changed.
- Wenn die Anmeldung als neuer Benutzer mit dem angegebenen Kennwort
- fehlschlägt, bleibt der aktuelle Benutzer aktiv.
+ <paramdef>string <parameter><optional>Datenbank</optional></parameter></paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ <function>Mysql_change_user</function> ändert den angemeldeten
+ Benutzer der Datenbank-Verbindung in den Benutzer mit dem
+ übergebenen Namen und Kennwort. Fehlt die Verbindungs-Kennung
+ wird die Änderung für die aktive Verbindung vorgenommen. If a
+ database is specified, this will default or current database
+ after the user has been changed. Wenn die Anmeldung als neuer
+ Benutzer mit dem angegebenen Kennwort fehlschlägt, bleibt der
+ aktuelle Benutzer aktiv.
</para>
<note>
<para>
@@ -135,21 +167,16 @@
<title>Beschreibung</title>
<funcsynopsis>
<funcdef>int <function>mysql_close</function></funcdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
Rückgabewert: true im Erfolgsfall, false im Fehlerfall.
</para>
<para>
- <function>mysql_close</function> schließt die Verbindung zur
- MySQL-Datenbank, die zur Verbindungs-Kennung gehört.
- Wenn die <parameter>Verbindungs-Kennung</parameter> nicht angegeben wird,
- wird die aktuelle
- Verbindung geschlossen.
+ <function>Mysql_close</function> schließt die Verbindung zur
+ MySQL-Datenbank, die zur Verbindungs-Kennung gehört. Wenn die
+ <parameter>Verbindungs-Kennung</parameter> nicht angegeben wird,
+ wird die aktuelle Verbindung geschlossen.
</para>
<note>
<graphic fileref="../images/note.gif"/>
@@ -192,65 +219,52 @@
<title>Beschreibung</title>
<funcsynopsis>
<funcdef>int <function>mysql_connect</function></funcdef>
- <paramdef>string
- <parameter>
- <optional>hostname
- <optional>:port</optional>
- <optional>:/path/to/socket</optional>
- </optional>
- </parameter>
- </paramdef>
- <paramdef>string
- <parameter>
- <optional>Benutzername</optional>
- </parameter>
- </paramdef>
- <paramdef>string
- <parameter>
- <optional>Kennwort</optional>
- </parameter>
- </paramdef>
+ <paramdef>string <parameter><optional>hostname<optional>:port</optional><optional>:/path/to/socket</optional></optional></parameter></paramdef>
+ <paramdef>string <parameter><optional>Benutzername</optional></parameter></paramdef>
+ <paramdef>string <parameter><optional>Kennwort</optional></parameter></paramdef>
</funcsynopsis>
<para>
Rückgabewert: Eine Verbindungs-Kennung im Erfolgsfall oder false
im Fehlerfall.
</para>
<para>
- <function>mysql_connect</function> öffnet eine Verbindung zu einem
+ <function>Mysql_connect</function> öffnet eine Verbindung zu einem
MySQL server. Alle Argumente sind optional, und wenn alle fehlen
wird ('localhost', Benutzername des Benutzers dem der Server-Prozess
gehört, leeres Kennwort) angenommen.
</para>
<para>
- Der Parameter <parameter>hostname</parameter> kann zudem die Portnummer
- enthalten, z.B.
- "hostname:port" oder den Pfad zu einem Socket
- z.B. ":/path/to/socket" für Zugriffe auf dem lokalen Rechner.
+ Der Parameter <parameter>hostname</parameter> kann zudem die
+ Portnummer enthalten, z.B. "hostname:port" oder den
+ Pfad zu einem Socket z.B. ":/path/to/socket" für
+ Zugriffe auf dem lokalen Rechner.
<note>
<para>
- Unterstützung für ":port" wurde in PHP 3.0B4 hinzugefügt.
+ Unterstützung für ":port" wurde in PHP 3.0B4
+ hinzugefügt.
</para>
<para>
- Unterstützung für ":/path/to/socket" wurde in
- PHP 3.0.10 hinzugefügt.
+ Unterstützung für ":/path/to/socket" wurde in PHP
+ 3.0.10 hinzugefügt.
</para>
<para>
- Fehlermeldung können unterdrückt werden, wenn dem Funktionsname ein '@'
- voran gestellt wird.
+ Fehlermeldung können unterdrückt werden, wenn dem Funktionsname
+ ein '@' voran gestellt wird.
</para>
</note>
</para>
<para>
Für den Fall, dass ein Aufruf von
- <function>mysql_connect</function> mit den gleichen Argumenten erfolgt,
- wird keine neue Verbindung aufgebaut, sondern die Verbindungs-Kennung
- der schon bestehenden Verbindung zurückgeliefert.
+ <function>mysql_connect</function> mit den gleichen Argumenten
+ erfolgt, wird keine neue Verbindung aufgebaut, sondern die
+ Verbindungs-Kennung der schon bestehenden Verbindung
+ zurückgeliefert.
</para>
<para>
Die Verbindung zum Datenbank-Server wird geschlossen, sobald das
- PHP-Skript beendet wird oder
- <function>mysql_close</function> aufgerufen wird.
- </para>
+ PHP-Skript beendet wird oder <function>mysql_close</function>
+ aufgerufen wird.
+ </para>
<example>
<title>Verbindung zum Datenbanksserver öffnen</title>
<programlisting role="php">
@@ -263,8 +277,8 @@
?>
</programlisting>
</example>
- <para> Siehe auch
- <function>mysql_pconnect</function> und
+ <para>
+ Siehe auch <function>mysql_pconnect</function> und
<function>mysql_close</function>.
</para>
</refsect1>
@@ -280,15 +294,12 @@
<funcsynopsis>
<funcdef>int <function>mysql_create_db</function></funcdef>
<paramdef>string <parameter>Datenbankname</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_create_db</function> versucht eine neue Datenbank auf
- dem Server mit der angegebenen Verbindungs-Kennung zu erzeugen.
+ <function>mysql_create_db</function> versucht eine neue Datenbank
+ auf dem Server mit der angegebenen Verbindungs-Kennung zu
+ erzeugen.
</para>
<example>
<title>Erzeugen einer Datenbank</title>
@@ -331,16 +342,16 @@
Rückgabewert: true im Erfolgsfall, false im Fehlerfall.
</para>
<para>
- <function>mysql_data_seek</function> bewegt den internen Datensatz-Zeiger
- eines Anfrageergebnisses zum Datensatz mit
- der übergebenen Nummer. Der nächste Aufruf von
+ <function>mysql_data_seek</function> bewegt den internen
+ Datensatz-Zeiger eines Anfrageergebnisses zum Datensatz mit der
+ übergebenen Nummer. Der nächste Aufruf von
<function>mysql_fetch_row</function> liefert den entsprechenden
Datensatz.
</para>
<para>
- Das Argument <parameter>Datensatznummer</parameter> ist 0 oder größer.
+ Das Argument <parameter>Datensatznummer</parameter> ist 0 oder
+ größer.
</para>
-
<example>
<title>Positionieren des Datensatzzeigers</title>
<programlisting role="php">
@@ -390,27 +401,24 @@
<funcdef>int <function>mysql_db_query</function></funcdef>
<paramdef>string <parameter>Datenbank</parameter></paramdef>
<paramdef>string <parameter>Anfrage</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
- Rückgabewert: Eine Ergebnis-Kennung als Referenz auf das Anfrageergebnis,
- oder false im Fehlerfall.
+ Rückgabewert: Eine Ergebnis-Kennung als Referenz auf das
+ Anfrageergebnis, oder false im Fehlerfall.
</para>
<para>
- <function>mysql_db_query</function> wählt eine Datenbank und führt eine
- Anfrage darauf aus. Wenn der optionale Parameter
+ <function>Msql_db_query</function> wählt eine Datenbank und führt
+ eine Anfrage darauf aus. Wenn der optionale Parameter
<parameter>Verbindungs-Kennung</parameter> nicht angegeben ist,
- wird versucht die aktuelle Verbindung zu nutzen. Wenn auch
- dies fehlschlägt, wird weiter versucht die Verbindung aufzubauen, wie
+ wird versucht die aktuelle Verbindung zu nutzen. Wenn auch dies
+ fehlschlägt, wird weiter versucht die Verbindung aufzubauen, wie
dies mit <function>mysql_connect</function> ohne Angabe von
Argumenten geschehen würde.
</para>
- <para> Für Rückwärtskompatibilität
- kann auch <function>mysql</function> verwendet werden.
+ <para>
+ Für Rückwärtskompatibilität kann auch <function>mysql</function>
+ verwendet werden.
</para>
<para>
Siehe auch <function>mysql_connect</function>.
@@ -428,11 +436,7 @@
<funcsynopsis>
<funcdef>int <function>mysql_drop_db</function></funcdef>
<paramdef>string <parameter>Datenbankname</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
Rückgabewert: true im Erfolgsfall, false ein Fehlerfall.
@@ -442,8 +446,9 @@
vom Server mit der übergebenen Verbindungs-Kennung zu entfernen.
</para>
<para>
- Siehe auch: <function>mysql_create_db</function>. Für Rückwärtskompatibilität
- kann auch <function>mysql_dropdb</function> verwendet werden.
+ Siehe auch: <function>mysql_create_db</function>. Für
+ Rückwärtskompatibilität kann auch
+ <function>mysql_dropdb</function> verwendet werden.
</para>
</refsect1>
</refentry>
@@ -451,18 +456,15 @@
<refentry id="function.mysql-errno">
<refnamediv>
<refname>mysql_errno</refname>
- <refpurpose>Liefert die Fehlernummer einer zuvor ausgeführten
- Operation</refpurpose>
+ <refpurpose>
+ Liefert die Fehlernummer einer zuvor ausgeführten Operation
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<funcsynopsis>
<funcdef>int <function>mysql_errno</function></funcdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
Fehler, die vom MySQL Server kommen, führen nicht zu einer
@@ -490,18 +492,15 @@
<refentry id="function.mysql-error">
<refnamediv>
<refname>mysql_error</refname>
- <refpurpose>Liefert den Fehlertext der zuvor ausgeführten
- MySQL Operation</refpurpose>
+ <refpurpose>
+ Liefert den Fehlertext der zuvor ausgeführten MySQL Operation
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<funcsynopsis>
<funcdef>string <function>mysql_error</function></funcdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
Fehler, die vom MySQL Server kommen, führen nicht zu einer
@@ -538,28 +537,25 @@
<funcsynopsis>
<funcdef>array <function>mysql_fetch_array</function></funcdef>
<paramdef>int <parameter>Ergebnis-Kennung</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>Ergebnistyp</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Ergebnistyp</optional></parameter></paramdef>
</funcsynopsis>
<para>
Liefert ein Array that mit den aktuellen Datensatz enthält oder
- false, wenn keine weiteren Datensätze vorliegen.</para>
+ false, wenn keine weiteren Datensätze vorliegen.
+ </para>
<para>
- <function>mysql_fetch_array</function> ist einen erweiterte Version von
- <function>mysql_fetch_row</function>. Der Datensatz wird in einem
- assoziativen Array abgelegt, in dem die Schlüssel den Namen der
- Datensatzfelder entsprechen.
+ <function>Mysql_fetch_array</function> ist eine erweiterte
+ Version von <function>mysql_fetch_row</function>. Der Datensatz
+ wird in einem assoziativen Array abgelegt, in dem die Schlüssel
+ den Namen der Datensatzfelder entsprechen.
</para>
<para>
- Wenn zwei oder mehrere Felder des Ergebnisses den gleich Feldnamen
- haben, dann wird der Wert des letzten Feldes im Array unter dem
- Feldnamen abgelegt.
- Um auch auf die anderen Felder mit dem gleichen Namen zugreifen zu
- können, müssen Sie den numerischen Index des Arrays verwenden oder
- einen Alias für das Feld erzeugen.
+ Wenn zwei oder mehrere Felder des Ergebnisses den gleich
+ Feldnamen haben, dann wird der Wert des letzten Feldes im Array
+ unter dem Feldnamen abgelegt. Um auch auf die anderen Felder mit
+ dem gleichen Namen zugreifen zu können, müssen Sie den
+ numerischen Index des Arrays verwenden oder einen Alias für das
+ Feld erzeugen.
<informalexample>
<programlisting>
select t1.f1 as foo t2.f1 as bar from t1, t2
@@ -569,13 +565,13 @@
<para>
Zu betonen ist, dass der Gebrauch von
<function>mysql_fetch_array</function> NICHT signifikant
- langsamer ist als <function>mysql_fetch_row</function>,
- obwohl die Funktion einen sichtlichen Mehrwert bedeutet.
+ langsamer ist als <function>mysql_fetch_row</function>, obwohl
+ die Funktion einen sichtlichen Mehrwert bedeutet.
</para>
<para>
Das optionale zweite Argumente <parameter>Ergebnistyp</parameter>
- in <function>mysql_fetch_array</function> ist eine Konstante und kann
- die folgenden Werte annehmen: MYSQL_ASSOC, MYSQL_NUM und
+ in <function>mysql_fetch_array</function> ist eine Konstante und
+ kann die folgenden Werte annehmen: MYSQL_ASSOC, MYSQL_NUM und
MYSQL_BOTH. (Diese Eigenschaft wurde in PHP 3.0.7 hinzugefügt.)
</para>
<para>
@@ -587,12 +583,12 @@
<programlisting role="php">
<?php
mysql_connect($host,$user,$password);
-$result = mysql_db_query("database","select * from table");
-while($row = mysql_fetch_array($result)) {
+$result = mysql_db_query ("database","select * from table");
+while ($row = mysql_fetch_array($result)) {
echo $row["user_id"];
echo $row["fullname"];
}
-mysql_free_result($result);
+mysql_free_result ($result);
?>
</programlisting>
</example>
@@ -611,21 +607,18 @@
<funcsynopsis>
<funcdef>object <function>mysql_fetch_field</function></funcdef>
<paramdef>int <parameter>Ergebnis-Kennung</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>Feld-Offset</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Feld-Offset</optional></parameter></paramdef>
</funcsynopsis>
<para>
Liefert ein Objekt mit Feldinformationen.
</para>
<para>
- <function>mysql_fetch_field</function> kann gebraucht werden, um
- Feldinformationen über Felder in einem Anfrageergebnis zu erhalten.
- Wenn der Feld-Offset nicht angegeben wird, werden die Information des
- nächsten noch nicht mit
- <function>mysql_fetch_field</function> erfragten Feldes geliefert.
+ <function>Mysql_fetch_field</function> kann gebraucht werden, um
+ Feldinformationen über Felder in einem Anfrageergebnis zu
+ erhalten. Wenn der Feld-Offset nicht angegeben wird, werden die
+ Information des nächsten noch nicht mit
+ <function>mysql_fetch_field</function> erfragten Feldes
+ geliefert.
</para>
<para>
Des Eigenschaften des Objekts sind:
@@ -693,7 +686,7 @@
</itemizedlist>
</para>
<para>
- Siehe auch <function>mysql_field_seek</function>
+ Siehe auch <function>mysql_field_seek</function>.
</para>
</refsect1>
</refentry>
@@ -716,13 +709,12 @@
zuletzt geholten Datensatz enthält, oder false im Fehlerfall.
</para>
<para>
- <function>mysql_fetch_lengths</function> liefert die Längen eines jeden
- Feldes in dem mit
- <function>mysql_fetch_row</function>,
+ <function>Mysql_fetch_lengths</function> liefert die Längen eines
+ jeden Feldes in dem mit <function>mysql_fetch_row</function>,
<function>mysql_fetch_array</function> oder
- <function>mysql_fetch_object</function> zuletzt geholten Datensatzes,
- in einem Array.
- </para>
+ <function>mysql_fetch_object</function> zuletzt geholten
+ Datensatzes, in einem Array.
+ </para>
<para>
Siehe auch: <function>mysql_fetch_row</function>.
</para>
@@ -739,46 +731,43 @@
<funcsynopsis>
<funcdef>object <function>mysql_fetch_object</function></funcdef>
<paramdef>int <parameter>Ergebnis-Kennung</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>Ergebnistyp</optional>
- </parameter>
- </paramdef>
- </funcsynopsis>
- <para>
- Liefert ein Objekt mit Eigenschaften, die den Felder des geholten Datensatz
- entsprechen, oder false when keine weiteren Datensätze vorhanden sind.
- </para>
- <para>
- <function>mysql_fetch_object</function> ist ähnlich zu
- <function>mysql_fetch_array</function>, mit einem Unterschied - ein
- Objekt wird zurück geliefert, anstatt eines Arrays. Indirekt bedeutet
- dies, das Sie die Felder nur mit ihren Feldnamen und nicht mir
- dem Offset ansprechen können.
- (Nummer sind ungültige Namen für Eigenschaften).
+ <paramdef>int <parameter><optional>Ergebnistyp</optional></parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ Liefert ein Objekt mit Eigenschaften, die den Felder des geholten
+ Datensatz entsprechen, oder false when keine weiteren Datensätze
+ vorhanden sind.
+ </para>
+ <para>
+ <function>Mysql_fetch_object</function> ist ähnlich zu
+ <function>mysql_fetch_array</function>, mit einem Unterschied -
+ ein Objekt wird zurück geliefert, anstatt eines Arrays. Indirekt
+ bedeutet dies, das Sie die Felder nur mit ihren Feldnamen und
+ nicht mir dem Offset ansprechen können. (Nummer sind ungültige
+ Namen für Eigenschaften).
</para>
<para>
Das optionale zweite Argumente <parameter>Ergebnistyp</parameter>
- in <function>mysql_fetch_array</function> ist eine Konstante und kann
- die folgenden Werte annehmen: MYSQL_ASSOC, MYSQL_NUM und
+ in <function>mysql_fetch_array</function> ist eine Konstante und
+ kann die folgenden Werte annehmen: MYSQL_ASSOC, MYSQL_NUM und
MYSQL_BOTH.
</para>
<para>
Unter Berücksichtigung der Ausführungsgeschwindigkeit ist diese
- Funktion identisch zu
- <function>mysql_fetch_array</function> und fast so schnell wie
- <function>mysql_fetch_row</function> (der Unterschied ist unwesentlich).
+ Funktion identisch zu <function>mysql_fetch_array</function> und
+ fast so schnell wie <function>mysql_fetch_row</function> (der
+ Unterschied ist unwesentlich).
<example>
<title>mysql fetch object</title>
<programlisting role="php">
<?php
-mysql_connect($host,$user,$password);
-$result = mysql_db_query("database","select * from table");
-while($row = mysql_fetch_object($result)) {
+mysql_connect ($host,$user,$password);
+$result = mysql_db_query ("database","select * from table");
+while ($row = mysql_fetch_object ($result)) {
echo $row->user_id;
echo $row->fullname;
}
-mysql_free_result($result);
+mysql_free_result ($result);
?>
</programlisting>
</example>
@@ -806,9 +795,10 @@
wenn keine weiteren Datensätze verfügbar sind.
</para>
<para>
- <function>mysql_fetch_row</function> liefert einen Datensatz aus dem
- Anfrageergebnis mit der übergebenen Kennung. Der Datensatz wird als
- Array geliefert. Jeder Feldwert ist als ein Element abgelegt.
+ <function>Mysql_fetch_row</function> liefert einen Datensatz aus
+ dem Anfrageergebnis mit der übergebenen Kennung. Der Datensatz
+ wird als Array geliefert. Jeder Feldwert ist als ein Element
+ abgelegt.
</para>
<para>
Folgende Aufrufe von <function>mysql_fetch_row</function> liefern
@@ -840,17 +830,17 @@
<paramdef>int <parameter>Feldindex</parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_field_name</function> liefert den Namen eines Feldes in
- einem Anfrageergebnis. Argumente der Funktion ist die Kennung des
- Anfrageergebnisses und der Feldindex, z.B.
+ <function>Mysql_field_name</function> liefert den Namen eines
+ Feldes in einem Anfrageergebnis. Argumente der Funktion ist die
+ Kennung des Anfrageergebnisses und der Feldindex, z.B.
<literal>mysql_field_name($result,2);</literal>
</para>
<para>
Dies liefert den Namen des zweiten Feldes im Anfrageergebnis.
</para>
<para>
- Für Rückwärtskompatibilität kann <function>mysql_fieldname</function>
- verwendet werden.
+ Für Rückwärtskompatibilität kann
+ <function>mysql_fieldname</function> verwendet werden.
</para>
</refsect1>
</refentry>
@@ -870,10 +860,10 @@
<paramdef>int <parameter>Feldoffset</parameter></paramdef>
</funcsynopsis>
<para>
- Setzt den Feldzeiger auf den angegeben Feldoffset. Wenn mit dem nächste
- Aufruf von
- <function>mysql_fetch_field</function> keinen Feldoffset übergeben wird,
- wird das Feld auf den der Zeiger verweist zurückgeliefert.
+ Setzt den Feldzeiger auf den angegeben Feldoffset. Wenn mit dem
+ nächste Aufruf von <function>mysql_fetch_field</function> keinen
+ Feldoffset übergeben wird, wird das Feld auf den der Zeiger
+ verweist zurückgeliefert.
</para>
<para>
Siehe auch: <function>mysql_fetch_field</function>.
@@ -897,7 +887,7 @@
</funcsynopsis>
<para>
Liefert den Namen der Tabelle, die das genannte Feld enthält.
- Für Rückwärtskompatibilität can
+ Für Rückwärtskompatibilität kann
<function>mysql_fieldtable</function> verwendet werden.
</para>
</refsect1>
@@ -918,22 +908,22 @@
<paramdef>int <parameter>Feldoffset</parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_field_type</function> ist ähnlich zu
+ <function>Mysql_field_type</function> ist ähnlich zu
<function>mysql_field_name</function>. Die Argumente sind
- identisch, aber der Feldtyp wird zurückgeliefert. Dieser kann einer von
- "int", "real", "string", "blob", oder anderen sein, wie in der
- Dokumentation zu MySQL angegeben.
+ identisch, aber der Feldtyp wird zurückgeliefert. Dieser kann
+ einer von "int", "real", "string", "blob", oder anderen sein, wie
+ in der Dokumentation zu MySQL angegeben.
<example>
- <title>mysql field types</title>
+ <title>Mysql Field Types</title>
<programlisting role="php">
<?php
-mysql_connect("localhost:3306");
-mysql_select_db("wisconsin");
-$result = mysql_query("SELECT * FROM onek");
-$fields = mysql_num_fields($result);
-$rows = mysql_num_rows($result);
+mysql_connect ("localhost:3306");
+mysql_select_db ("wisconsin");
+$result = mysql_query ("SELECT * FROM onek");
+$fields = mysql_num_fields ($result);
+$rows = mysql_num_rows ($result);
$i = 0;
-$table = mysql_field_table($result, $i);
+$table = mysql_field_table ($result, $i);
echo "Your '".$table."' table has ".$fields." fields and ".$rows." records <BR>";
echo "The table has the following fields <BR>";
while ($i < $fields) {
@@ -950,8 +940,8 @@
</example>
</para>
<para>
- Für Rückwärtskompatibilität kann <function>mysql_fieldtype</function>
- verwendet werden.
+ Für Rückwärtskompatibilität kann
+ <function>mysql_fieldtype</function> verwendet werden.
</para>
</refsect1>
</refentry>
@@ -971,19 +961,20 @@
<paramdef>int <parameter>Feldoffset</parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_field_flags</function> liefert die Flags des Feldes
- mit dem übergeben Offset. Die Flags werden als einzelne Word pro
- Flag und Leerzeichen getrennt geliefert, so dass sie leicht mit
- <function>explode</function> getrennt werden können.
- </para>
- <para>Die folgenden Flags werden geliefert, wenn Ihre Version von MySQL
- diese unterstützt: "not_null", "primary_key",
- "unique_key", "multiple_key", "blob", "unsigned", "zerofill",
- "binary", "enum", "auto_increment", "timestamp".
+ <function>Mysql_field_flags</function> liefert die Flags des
+ Feldes mit dem übergeben Offset. Die Flags werden als einzelne
+ Worte pro Flag und Leerzeichen getrennt geliefert, so dass sie
+ leicht mit <function>explode</function> getrennt werden können.
+ </para>
+ <para>
+ Die folgenden Flags werden geliefert, wenn Ihre Version von MySQL
+ diese unterstützt: "not_null", "primary_key", "unique_key",
+ "multiple_key", "blob", "unsigned", "zerofill", "binary", "enum",
+ "auto_increment", "timestamp".
</para>
<para>
- Für Rückwärtskompatibilität kann <function>mysql_fieldflags</function>
- verwendet werden.
+ Für Rückwärtskompatibilität kann
+ <function>mysql_fieldflags</function> verwendet werden.
</para>
</refsect1>
</refentry>
@@ -1003,8 +994,8 @@
<paramdef>int <parameter>Feldoffset</parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_field_len</function> liefert die Länge des Feldes mit
- dem übergebenen Feldoffset. Für Rückwärtskompatibilität kann
+ <function>Mysql_field_len</function> liefert die Länge des Feldes
+ mit dem übergebenen Feldoffset. Für Rückwärtskompatibilität kann
<function>mysql_fieldlen</function> verwendet werden.
</para>
</refsect1>
@@ -1013,7 +1004,7 @@
<refentry id="function.mysql-free-result">
<refnamediv>
<refname>mysql_free_result</refname>
- <refpurpose>Entfernt ein Ergebnis</refpurpose>
+ <refpurpose>Gibt den belegten Speicher wieder frei</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
@@ -1022,14 +1013,15 @@
<paramdef>int <parameter>Ergebnis-Kennung</parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_free_result</function> entfernt ein Ergebnis und gibt
- den belegten Speicher frei. Die Funktion muss nur dann aufgerufen werden,
- wenn der Speicherbedarf zur Laufzeit des PHP-Skripts zu hoch wird. Nach
- Ablauf des PHP-Skripts wird der Speicher ohnehin freigegeben.
+ <function>Mysql_free_result</function> entfernt ein Ergebnis und
+ gibt den belegten Speicher frei. Die Funktion muss nur dann
+ aufgerufen werden, wenn der Speicherbedarf zur Laufzeit des
+ PHP-Skripts zu hoch wird. Nach Ablauf des PHP-Skripts wird der
+ Speicher ohnehin freigegeben.
</para>
<para>
- Für Rückwärtskompatibilität kann <function>mysql_freeresult</function>
- verwendet werden.
+ Für Rückwärtskompatibilität kann
+ <function>mysql_freeresult</function> verwendet werden.
</para>
</refsect1>
</refentry>
@@ -1045,17 +1037,13 @@
<title>Beschreibung</title>
<funcsynopsis>
<funcdef>int <function>mysql_insert_id</function></funcdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_insert_id</function> liefert die Kennung (ID), die bei
- der letzten INSERT-Operation für
- eine automatisch inkrementiertes Feld (AUTO_INCREMENTED) vergeben wurde.
- Wenn die <parameter>Verbindungs-Kennung</parameter> nicht angegeben wird,
+ <function>Mysql_insert_id</function> liefert die Kennung (ID),
+ die bei der letzten INSERT-Operation für eine automatisch
+ inkrementiertes Feld (AUTO_INCREMENTED) vergeben wurde. Wenn die
+ <parameter>Verbindungs-Kennung</parameter> nicht angegeben wird,
wird die aktuelle Verbindung verwendet.
</para>
</refsect1>
@@ -1072,33 +1060,28 @@
<funcdef>int <function>mysql_list_fields</function></funcdef>
<paramdef>string <parameter>Datenbankname</parameter></paramdef>
<paramdef>string <parameter>Tabellenname</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_list_fields</function> fordert Information über eine
- Tabelle an.
- Argumente sind der Datenbankname und der Tabellenname.
- the table name. Die zurückgelieferte Ergebnis-Kennung kann von den
- Funktionen
+ <function>Mysql_list_fields</function> fordert Information über
+ eine Tabelle an. Argumente sind der Datenbankname und der
+ Tabellenname. the table name. Die zurückgelieferte
+ Ergebnis-Kennung kann von den Funktionen
<function>mysql_field_flags</function>,
<function>mysql_field_len</function>,
<function>mysql_field_name</function> und
<function>mysql_field_type</function> verwendet werden.
</para>
<para>
- Die Erbebnis-Kennung is ein positiver ganzzahliger Wert.
- Die Funktion liefert -1 im Fehlerfall. Eine mögliche Fehlermeldung
- wird in der Variablen <literal>$phperrmsg</literal> abgelegt, es sei
- denn die Funktion wurde als <literal> <email protected>()</literal> aufgerufen.
- In diesem Fall wird die Fehlermeldung ausgegeben.
+ Die Erbebnis-Kennung ist ein positiver ganzzahliger Wert. Die
+ Funktion liefert -1 im Fehlerfall. Eine mögliche Fehlermeldung
+ wird in der Variablen <literal>$phperrmsg</literal> abgelegt, es
+ sei denn die Funktion wurde als <literal> <email protected>()</literal>
+ aufgerufen. In diesem Fall wird die Fehlermeldung ausgegeben.
</para>
<para>
- Für Rückwärtskompatibilität kann <function>mysql_listfields</function>
- verwendet werden.
+ Für Rückwärtskompatibilität kann
+ <function>mysql_listfields</function> verwendet werden.
</para>
</refsect1>
</refentry>
@@ -1114,21 +1097,18 @@
<title>Beschreibung</title>
<funcsynopsis>
<funcdef>int <function>mysql_list_dbs</function></funcdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_list_dbs</function> liefert die Kennung eines Ergebnisses,
- dass alle Datenbanken auf dem Datenbankserver enthält.
- Benutzen Sie die Funktion <function>mysql_tablename</function>, um das
- Ergebnis zu durchlaufen.
+ <function>Mysql_list_dbs</function> liefert die Kennung eines
+ Ergebnisses, dass alle Datenbanken auf dem Datenbankserver
+ enthält. Benutzen Sie die Funktion
+ <function>mysql_tablename</function>, um das Ergebnis zu
+ durchlaufen.
</para>
<para>
- Für Rückwärtskompatibilität kann <function>mysql_listdbs</function>
- verwendet werden.
+ Für Rückwärtskompatibilität kann
+ <function>mysql_listdbs</function> verwendet werden.
</para>
</refsect1>
</refentry>
@@ -1143,22 +1123,19 @@
<funcsynopsis>
<funcdef>int <function>mysql_list_tables</function></funcdef>
<paramdef>string <parameter>Datenbankname</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_list_tables</function> liefert eine Liste der Datenbank
- mit dem übergegebenen Namen, ähnlich wie die Funktion
+ <function>Mysql_list_tables</function> liefert eine Liste der
+ Datenbank mit dem übergegebenen Namen, ähnlich wie die Funktion
<function>mysql_db_query</function> bei Datenbankanfragen. Die
- Funktion <function>mysql_tablename</function> sollte genutzt werden,
- um die tatsächlichen Namen der Tabellen im Ergebnis zu erfragen.
+ Funktion <function>mysql_tablename</function> sollte genutzt
+ werden, um die tatsächlichen Namen der Tabellen im Ergebnis zu
+ erfragen.
</para>
<para>
- Für Rückwärtskompatibilität kann <function>mysql_listtables</function>
- verwendet werden.
+ Für Rückwärtskompatibilität kann
+ <function>mysql_listtables</function> verwendet werden.
</para>
</refsect1>
</refentry>
@@ -1175,18 +1152,18 @@
<paramdef>int <parameter>Ergebnis-Kennung</parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_num_fields</function> liefert die Anzahl der Felder in
- einem Ergebnis.
+ <function>Mysql_num_fields</function> liefert die Anzahl der
+ Felder in einem Ergebnis.
</para>
<para>
- Siehe auch:
- <function>mysql_db_query</function>,
+ Siehe auch: <function>mysql_db_query</function>,
<function>mysql_query</function>,
- <function>mysql_fetch_field</function>,
- <function>mysql_num_rows</function>.</para>
+ <function>mysql_fetch_field</function> und
+ <function>mysql_num_rows</function>.
+ </para>
<para>
- Für Rückwärtskompatibilität kann <function>mysql_numfields</function>
- verwendet werden.
+ Für Rückwärtskompatibilität kann
+ <function>mysql_numfields</function> verwendet werden.
</para>
</refsect1>
</refentry>
@@ -1203,18 +1180,17 @@
<paramdef>int <parameter>Ergebnis-Kennung</parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_num_rows</function> liefert die Anzahl der Datensätze im
- Ergebnis
+ <function>Mysql_num_rows</function> liefert die Anzahl der
+ Datensätze im Ergebnis.
</para>
<para>
- Siehe auch:
- <function>mysql_db_query</function>,
- <function>mysql_query</function> und,
+ Siehe auch: <function>mysql_db_query</function>,
+ <function>mysql_query</function> und
<function>mysql_fetch_row</function>.
</para>
<para>
- Für Rückwärtskompatibilität kann <function>mysql_numrows</function>
- verwendet werden.
+ Für Rückwärtskompatibilität kann
+ <function>mysql_numrows</function> verwendet werden.
</para>
</refsect1>
</refentry>
@@ -1230,37 +1206,25 @@
<title>Beschreibung</title>
<funcsynopsis>
<funcdef>int <function>mysql_pconnect</function></funcdef>
- <paramdef>string
- <parameter>
- <optional>hostname
- <optional>:port</optional>
- <optional>:/path/to/socket</optional>
- </optional>
- </parameter>
- </paramdef>
- <paramdef>string
- <parameter><optional>Benutztername</optional></parameter>
- </paramdef>
- <paramdef>string
- <parameter><optional>Benutzerkennwort</optional></parameter>
- </paramdef>
- </funcsynopsis>
- <para>
- Rückgabewert: Eine gültige Verbindung-Kennung im Erfolgsfall oder false im
- Fehlerfall.
- </para>
- <para>
- <function>mysql_pconnect</function> baut eine Verbindung zum MySQL
- Server auf.
- Alle Argumente sind optional, und wenn alle fehlen
- wird ('localhost', Benutzername des Benutzers dem der Server-Prozess
- gehört, leeres Kennwort) angenommen.
- </para>
+ <paramdef>string <parameter><optional>hostname<optional>:port</optional><optional>:/path/to/socket</optional></optional></parameter></paramdef>
+ <paramdef>string <parameter><optional>Benutztername</optional></parameter></paramdef>
+ <paramdef>string <parameter><optional>Benutzerkennwort</optional></parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ Rückgabewert: Eine gültige Verbindung-Kennung im Erfolgsfall oder
+ false im Fehlerfall.
+ </para>
<para>
- Der Parameter <parameter>hostname</parameter> kann zudem die Portnummer
- enthalten, z.B.
- "hostname:port" oder den Pfad zu einem Socket
- z.B. ":/path/to/socket" für Zugriffe auf dem lokalen Rechner.
+ <function>Mysql_pconnect</function> baut eine Verbindung zum
+ MySQL Server auf. Alle Argumente sind optional, und wenn alle
+ fehlen wird ('localhost', Benutzername des Benutzers dem der
+ Server-Prozess gehört, leeres Kennwort) angenommen.
+ </para>
+ <para>
+ Der Parameter <parameter>hostname</parameter> kann zudem die
+ Portnummer enthalten, z.B. "hostname:port" oder den
+ Pfad zu einem Socket z.B. ":/path/to/socket" für
+ Zugriffe auf dem lokalen Rechner.
<note>
<para>
Unterstützung für ":port" wurde in PHP 3.0B4 hinzugefügt.
@@ -1272,22 +1236,23 @@
</note>
</para>
<para>
- <function>mysql_pconnect</function> verhält sich sehr ähnlich zu
+ <function>Mysql_pconnect</function> verhält sich sehr ähnlich zu
<function>mysql_connect</function>, weist aber zwei wesentliche
Unterschiede auf.
</para>
<para>
Erstens, vor dem Verbindungsaufbau wird zunächst versucht eine
(persistente) Verbindung zum gleichen Host und mit dem gleichen
- Benutzernamen und Kennwort zu finden. Wenn dies der Fall ist, wird
- die Verbindungskennung dieser Verbindung zurückgeliefert und keine
- neue Verbindung geöffnet.
+ Benutzernamen und Kennwort zu finden. Wenn dies der Fall ist,
+ wird die Verbindungskennung dieser Verbindung zurückgeliefert und
+ keine neue Verbindung geöffnet.
</para>
<para>
- Zweitens, die Verbindung zum SQL Server wird nicht mit Beendigung des
- PHP-Skripts geschlossen. Sie bleibt bestehen für einen möglichen,
- zukünftigen Verbindungsaufbau.
- (<function>mysql_close</function> schließt keine mit
+
+ Zweitens, die Verbindung zum SQL Server wird nicht mit Beendigung
+ des PHP-Skripts geschlossen. Sie bleibt bestehen für einen
+ möglichen, zukünftigen Verbindungsaufbau.
+ (<function>Mysql_close</function> schließt keine mit
<function>mysql_pconnect</function> geöffnete Verbindungen).
</para>
<para>
@@ -1306,34 +1271,32 @@
<funcsynopsis>
<funcdef>int <function>mysql_query</function></funcdef>
<paramdef>string <parameter>Anfrage</parameter></paramdef>
- <paramdef>int
- <parameter><optional>Verbindungs-Kennung</optional></parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_query</function> sendet eine Anfrage zu der zur Zeit
- aktiven Datenbank-Verbindung oder der Verbindung mit der übergegebenen
- Kennung.
- Wenn keine offene Verbindung besteht, wird versucht eine Verbindung
- aufzubauen, als ob
- <function>mysql_connect</function> ohne Argumente aufgerufen wird.
+ <function>Mysql_query</function> sendet eine Anfrage zu der zur
+ Zeit aktiven Datenbank-Verbindung oder der Verbindung mit der
+ übergegebenen Kennung. Wenn keine offene Verbindung besteht,
+ wird versucht eine Verbindung aufzubauen, als ob
+ <function>mysql_connect</function> ohne Argumente aufgerufen
+ wird.
</para>
<para>
- Die Anfrage sollte nicht mir einem Semikolon enden.
+ Die Anfrage sollte nicht mit einem Semikolon enden.
</para>
<para>
- <function>mysql_query</function> liefert TRUE (non-zero) oder FALSE,
- um anzuzeigen, ob die Anfrage erfolgreich war oder nicht.
+ <function>Mysql_query</function> liefert TRUE (non-zero) oder
+ FALSE, um anzuzeigen, ob die Anfrage erfolgreich war oder nicht.
Wird im Erfolgsfall TRUE zurückgeliefert, dann sagt dies nichts
- über die Zahl veränderter oder gelieferter Datensätze aus.
- Es ist durchaus möglich, dass eine Anfrage erfolgreich ist, ohne
+ über die Zahl veränderter oder gelieferter Datensätze aus. Es
+ ist durchaus möglich, dass eine Anfrage erfolgreich ist, ohne
einen einzigen Datensatz zur verändern oder zu liefern.
</para>
<para>
Die folgende Anfrage ist syntaktisch falsch, deshalb liefert
<function>mysql_query</function> FALSE zurück:
<example>
- <title><function>mysql_query</function></title>
+ <title><function>Mysql_query</function></title>
<programlisting role="php">
<?php
$result = mysql_query ("SELECT * WHERE 1=1")
@@ -1345,10 +1308,10 @@
<para>
Die folgende Anfrage ist semantisch falsch, wenn
<literal>my_col</literal> ist kein Feld in der Tabelle
- <literal>my_tbl</literal>. Deshalb schlägt <function>mysql_query</function>
- fehl und liefert FALSE:
+ <literal>my_tbl</literal>. Deshalb schlägt
+ <function>mysql_query</function> fehl und liefert FALSE:
<example>
- <title><function>mysql_query</function></title>
+ <title><function>Mysql_query</function></title>
<programlisting role="php">
<?php
$result = mysql_query ("SELECT my_col FROM my_tbl")
@@ -1358,20 +1321,19 @@
</example>
</para>
<para>
- <function>mysql_query</function> schlägt ebenso fehl und liefert FALSE,
- wenn Sie keinen Zugriff auf die Tabelle(n) haben.
+ <function>Mysql_query</function> schlägt ebenso fehl und liefert
+ FALSE, wenn Sie keinen Zugriff auf die Tabelle(n) haben.
</para>
<para>
Angenommen eine Anfrage ist erfolgreich, dann können Sie mit
<function>mysql_affected_rows</function> herausfinden wieviele
- Datensätze beeinflusst wurden
- (für DELETE, INSERT, REPLACE, oder UPDATE
- Anweisungen). Bei SELECT Anweisungen,
- liefert <function>mysql_query</function> eine Ergebnis-Kennung, die
- man mit <function>mysql_result</function> weiter verarbeiten kann.
+ Datensätze beeinflusst wurden (für DELETE, INSERT, REPLACE, oder
+ UPDATE Anweisungen). Bei SELECT Anweisungen, liefert
+ <function>mysql_query</function> eine Ergebnis-Kennung, die man
+ mit <function>mysql_result</function> weiter verarbeiten kann.
Wenn das Ergebnis nicht mehr gebraucht wird, können die belegten
- Resourcen mit
- <function>mysql_free_result</function> freigegeben werden.
+ Resourcen mit <function>mysql_free_result</function> freigegeben
+ werden.
</para>
<para>
Siehe auch: <function>mysql_affected_rows</function>,
@@ -1395,37 +1357,33 @@
<funcdef>int <function>mysql_result</function></funcdef>
<paramdef>int <parameter>Ergebnis-Kennung</parameter></paramdef>
<paramdef>int <parameter>Datensatz-Index</parameter></paramdef>
- <paramdef>mixed
- <parameter>
- <optional>Feld</optional>
- </parameter>
- </paramdef>
+ <paramdef>mixed <parameter><optional>Feld</optional></parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_result</function> liefert den Inhalt eines Feldes aus
- einem Anfrageergebnis. Das Argument <parameter>Feld</parameter>
- kann der Feldname, der Feldoffset ein Bezeichner in der Form
- 'Feldname.Tabellenname' sein. When das Feld einen Alias besitzt
- ('select foo as bar from...') muss der Alias anstatt des Feldnamens
- verwendet werden.
+ <function>Mysql_result</function> liefert den Inhalt eines Feldes
+ aus einem Anfrageergebnis. Das Argument
+ <parameter>Feld</parameter> kann der Feldname, der Feldoffset ein
+ Bezeichner in der Form 'Feldname.Tabellenname' sein. Wenn das
+ Feld einen Alias besitzt ('select foo as bar from...') muss der
+ Alias anstatt des Feldnamens verwendet werden.
</para>
<para>
- Wenn auf Anfrageergebnisse mit vielen Datensätzen zugegriffen werden
- soll, sollten Sie die Funktionen, die auf ganze Datensätze zugreifen,
- in Betracht ziehen (siehe unten). Diese Funktionen sind sehr viel
- schneller als.
- <function>mysql_result</function>. Beachten Sie auch, dass die Angabe
- eines numerischen Offsets für das Feld sehr viel schneller ist als
- die übrigen möglichen Angaben.
+ Wenn auf Anfrageergebnisse mit vielen Datensätzen zugegriffen
+ werden soll, sollten Sie die Funktionen, die auf ganze Datensätze
+ zugreifen, in Betracht ziehen (siehe unten). Diese Funktionen
+ sind sehr viel schneller als
+ <function>mysql_result</function>. Beachten Sie auch, dass die
+ Angabe eines numerischen Offsets für das Feld sehr viel schneller
+ ist als die übrigen möglichen Angaben.
</para>
<para>
- Aufrufe von <function>mysql_result</function> sollten nicht
- mit Aufruf anderen Funktion, die auch auf das Ergebnis zugreifen,
+ Aufrufe von <function>mysql_result</function> sollten nicht mit
+ Aufruf anderen Funktion, die auch auf das Ergebnis zugreifen,
verschachtelt werden.
</para>
<para>
Empfohlende, leistungsfähigere Alternativen:
- <function>mysql_fetch_row</function>,
+ <function>mysql_fetch_row</function>,
<function>mysql_fetch_array</function> und
<function>mysql_fetch_object</function>.
</para>
@@ -1442,37 +1400,32 @@
<funcsynopsis>
<funcdef>int <function>mysql_select_db</function></funcdef>
<paramdef>string <parameter>Datenbankname</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>Verbindungs-Kennung</optional>
- </parameter>
- </paramdef>
+ <paramdef>int <parameter><optional>Verbindungs-Kennung</optional></parameter></paramdef>
</funcsynopsis>
<para>
Rückgabewert: true im Erfolgsfall, false im Fehlerfall.
</para>
<para>
- <function>mysql_select_db</function> setzt die aktuelle Datenbank
+ <function>Mysql_select_db</function> setzt die aktuelle Datenbank
auf dem Server zu dem die Verbindung mir der übergegebenen
- Verbindungs-Kennung besteht.
- Fehlt die Verbindungs-Kennung wird die aktive Verbindung genommen.
- Wenn auch diese nicht existiert, wird weiter versucht die Verbindung
- aufzubauen, wie
- dies mit <function>mysql_connect</function> ohne Angabe von
- Argumenten geschehen würde.
+ Verbindungs-Kennung besteht. Fehlt die Verbindungs-Kennung wird
+ die aktive Verbindung genommen. Wenn auch diese nicht existiert,
+ wird weiter versucht die Verbindung aufzubauen, wie dies mit
+ <function>mysql_connect</function> ohne Angabe von Argumenten
+ geschehen würde.
</para>
<para>
Jeder weitere Aufruf von <function>mysql_query</function> nutzt
die aktive Verbindung.
</para>
- <para> Siehe auch:
- <function>mysql_connect</function>,
+ <para>
+ Siehe auch: <function>mysql_connect</function>,
<function>mysql_pconnect</function> und
<function>mysql_query</function>.
</para>
<para>
- Für Rückwärtskompatibilität kann <function>mysql_selectdb</function>
- verwendet werden.
+ Für Rückwärtskompatibilität kann
+ <function>mysql_selectdb</function> verwendet werden.
</para>
</refsect1>
</refentry>
@@ -1490,11 +1443,12 @@
<paramdef>int <parameter>i</parameter></paramdef>
</funcsynopsis>
<para>
- <function>mysql_tablename</function> ermittelt aus einem Ergbenis,
- das von <function>mysql_list_tables</function> geliefert wurde sowie
- einem Index <parameter>i</parameter> den Namen der Tabelle.
- Die Funktion <function>mysql_num_rows</function> kann verwendet werden,
- um die Anzahl der Tabellen im Erbebnis zu ermitteln.
+ <function>Mysql_tablename</function> ermittelt aus einem
+ Ergbenis, das von <function>mysql_list_tables</function>
+ geliefert wurde sowie einem Index <parameter>i</parameter> den
+ Namen der Tabelle. Die Funktion
+ <function>mysql_num_rows</function> kann verwendet werden, um die
+ Anzahl der Tabellen im Erbebnis zu ermitteln.
<example>
<title><function>Mysql_tablename</function> Bespiel</title>
<programlisting role="php">
- Next message: Egon Schmid: "[PHPDOC] cvs: phpdoc /en/functions/ swf.xml"
- Previous message: Sterling Hughes: "[PHPDOC] cvs: phpdoc / manual.xml.in"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]