cvs: phpdoc-de /reference/ifx/functions ifx-free-result.xml ifx-get-blob.xml ifx-get-char.xml ifx-getsqlca.xml ifx-htmltbl-result.xml
ifx-nullformat.xml ifx-num-fields.xml ifx-num-rows.xml ifx-pconnect.xml ifx-query.xml
| From: | Cornelia Boenigk | Date: | Wed, 11 Dec 2002 00:32:21 +0000 |
| Subject: | cvs: phpdoc-de /reference/ifx/functions ifx-free-result.xml ifx-get-blob.xml ifx-get-char.xml ifx-getsqlca.xml ifx-htmltbl-result.xml ifx-nullformat.xml ifx-num-fields.xml ifx-num-rows.xml ifx-pconnect.xml ifx-query.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-362@lists.php.net to get a copy of this message | ||
conni Tue Dec 10 19:32:21 2002 EDT
Modified files:
/phpdoc-de/reference/ifx/functions ifx-free-result.xml
ifx-get-blob.xml
ifx-get-char.xml
ifx-getsqlca.xml
ifx-htmltbl-result.xml
ifx-nullformat.xml
ifx-num-fields.xml
ifx-num-rows.xml
ifx-pconnect.xml ifx-query.xml
Log:
initial translation
Index: phpdoc-de/reference/ifx/functions/ifx-free-result.xml diff -u phpdoc-de/reference/ifx/functions/ifx-free-result.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-free-result.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-free-result.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-free-result.xml Tue Dec 10 19:32:21 2002 @@ -1,20 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-free-result"> <refnamediv> <refname>ifx_free_result</refname> - <refpurpose>Releases resources for the query</refpurpose> + <refpurpose>Gibt den belegten Speicher einer Ergebnismenge wieder frei</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_free_result</methodname> <methodparam><type>int</type><parameter>result_id</parameter></methodparam> </methodsynopsis> <para> - Releases resources for the query associated with - <parameter>result_id</parameter>. Returns &false; on error. + Gibt den belegten Speicher, der mit der Ergebniskennung + <parameter>result_id</parameter> verknüpft ist, wieder frei. + Bei einem Fehler wird &false; zurückgegeben. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-get-blob.xml diff -u phpdoc-de/reference/ifx/functions/ifx-get-blob.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-get-blob.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-get-blob.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-get-blob.xml Tue Dec 10 19:32:21 2002 @@ -1,20 +1,20 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-get-blob"> <refnamediv> <refname>ifx_get_blob</refname> - <refpurpose>Return the content of a blob object</refpurpose> + <refpurpose>Gibt den Inhalt eines Large Objects zurück</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_get_blob</methodname> <methodparam><type>int</type><parameter>bid</parameter></methodparam> </methodsynopsis> <para> - Returns the content of the blob object for the given blob - object-id <parameter>bid</parameter>. + Gibt den Inhalt des Large Objects zurück, das durch die gegebene + Objekt-ID <parameter>bid</parameter> bestimmt wird. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-get-char.xml diff -u phpdoc-de/reference/ifx/functions/ifx-get-char.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-get-char.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-get-char.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-get-char.xml Tue Dec 10 19:32:21 2002 @@ -1,20 +1,20 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-get-char"> <refnamediv> <refname>ifx_get_char</refname> - <refpurpose>Return the content of the char object</refpurpose> + <refpurpose>Gibt den Inhalt eines Zeichen-Objekts zurück</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_get_char</methodname> <methodparam><type>int</type><parameter>bid</parameter></methodparam> </methodsynopsis> <para> - Returns the content of the char object for the given char - object-id <parameter>bid</parameter>. + Gibt den Inhalt des durch die Objekt-ID <parameter>bid</parameter> + gegebenen Zeichen-Objekts zurück. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-getsqlca.xml diff -u phpdoc-de/reference/ifx/functions/ifx-getsqlca.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-getsqlca.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-getsqlca.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-getsqlca.xml Tue Dec 10 19:32:21 2002 @@ -1,45 +1,45 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-getsqlca"> <refnamediv> <refname>ifx_getsqlca</refname> <refpurpose> - Get the contents of sqlca.sqlerrd[0..5] after a query + Gibt den Inhalt von sqlca.sqlerrd[0..5] nach einer Abfrage zurück </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>array</type><methodname>ifx_getsqlca</methodname> <methodparam><type>int</type><parameter>result_id</parameter></methodparam> </methodsynopsis> <para> - <parameter>result_id</parameter> is a valid result id returned by - <function>ifx_query</function> or - <function>ifx_prepare</function>. + <parameter>result_id</parameter> ist eine gültige Ergebniskennung, die + von <function>ifx_query</function> oder <function>ifx_prepare</function> + zurückgegeben wurde. </para> <para> - Returns a pseudo-row (associative array) with sqlca.sqlerrd[0] - ... sqlca.sqlerrd[5] after the query associated with - <parameter>result_id</parameter>. + Diese Funktion gibt nach einer Abfrage, die mit <parameter>result_id</parameter> + verknüpft ist, eine Pseudo-Zeile (assoziatives Array) mit + sqlca.sqlerrd[0] ... sqlca.sqlerrd[5] zurück. </para> <para> - For inserts, updates and deletes the values returned are those as - set by the server after executing the query. This gives access to - the number of affected rows and the serial insert value. For - SELECTs the values are those saved after the PREPARE - statement. This gives access to the *estimated* number of - affected rows. The use of this function saves the overhead of - executing a "select dbinfo('sqlca.sqlerrdx')" query, as it - retrieves the values that were saved by the ifx driver at the - appropriate moment. + Bei INSERTs, UPDATEs und DELETEs sind die zurückgegebenen Werte die, + die der Server nach dem Ausführen der Abfrage setzt. Dadurch bekommt + man Zugriff auf die Anzahl der betroffenen Zeilen und auf den + Eingabewert eines Serial-Feldes. Bei SELECTs sind das die Werte, die + nach einem PREPARE-Kommando gespeichert wurden. Hier hat man Zugriff + auf die *geschätzte* Anzahl der betroffenen Zeilen. Der Gebrauch + dieser Funktion erspart den Overhead für die Ausführung einer + "select dbinfo('sqlca.sqlerrdx')"-Abfrage, weil hier die Werte gelesen + werden, die der ifx-Treiber im passenden Moment gespeichert hat. </para> <example> - <title>Retrieve Informix sqlca.sqlerrd[x] values</title> + <title>Informix sqlca.sqlerrd[x] Werte ermitteln</title> <programlisting role="php"> <![CDATA[ -/* assume the first column of 'sometable' is a serial */ +/* angenommen, das erste Feld von 'sometable' ist vom Typ SERIAL */ $qid = ifx_query("insert into sometable values (0, '2nd column', 'another column') ", $connid); if (! $qid) { @@ -47,7 +47,7 @@ } $sqlca = ifx_getsqlca ($qid); $serial_value = $sqlca["sqlerrd1"]; -echo "The serial value of the inserted row is : " . $serial_value<br>\n"; +echo "Der Wert des SERIAL-Feldes der eingefügten Zeile ist: " . $serial_value<br>\n"; ]]> </programlisting> </example> Index: phpdoc-de/reference/ifx/functions/ifx-htmltbl-result.xml diff -u phpdoc-de/reference/ifx/functions/ifx-htmltbl-result.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-htmltbl-result.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-htmltbl-result.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-htmltbl-result.xml Tue Dec 10 19:32:21 2002 @@ -1,44 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-htmltbl-result"> <refnamediv> <refname>ifx_htmltbl_result</refname> <refpurpose> - Formats all rows of a query into a HTML table + Gibt alle Zeilen einer Abfrage als HTML-Tabelle formatiert zurück </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_htmltbl_result</methodname> <methodparam><type>int</type><parameter>result_id</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>html_table_options</parameter></methodparam> </methodsynopsis> <para> - Returns the number of rows fetched or &false; on error. + Gibt die Anzahl der gelesenen Zeilen aus oder &false; bei einem Fehler. </para> <para> - Formats all rows of the <parameter>result_id</parameter> query - into a html table. The optional second argument is a string of - <table> tag options + Gibt alle Zeilen der durch <parameter>result_id</parameter> bestimmten + Abfrage fornmatiert in einer HTML-Tabelle zurück. Das optionale zweite + Argument ist ein String mit <table>-Tag Optionen. </para> <example> - <title>Informix results as HTML table</title> + <title>Informix Ergebnisse als HTML Tabellen</title> <programlisting role="php"> <![CDATA[ $rid = ifx_prepare ("select * from emp where name like " . $name, $connid, IFX_SCROLL); if (! $rid) { - ... error ... + ... Fehler ... } $rowcount = ifx_affected_rows ($rid); if ($rowcount > 1000) { - printf ("Too many rows in result set (%d)\n<br>", $rowcount); - die ("Please restrict your query<br>\n"); + printf ("Zu viele Zeilen in der Ergebnismenge (%d)\n<br>", $rowcount); + die ("Bitte beschränken Sie die Abfrage<br>\n"); } if (! ifx_do($rid) { - ... error ... + ... Fehler ... } ifx_htmltbl_result ($rid, "border=\"2\""); Index: phpdoc-de/reference/ifx/functions/ifx-nullformat.xml diff -u phpdoc-de/reference/ifx/functions/ifx-nullformat.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-nullformat.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-nullformat.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-nullformat.xml Tue Dec 10 19:32:21 2002 @@ -1,22 +1,23 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-nullformat"> <refnamediv> <refname>ifx_nullformat</refname> <refpurpose> - Sets the default return value on a fetch row + Setzt den aktuellen Rückgabewert für Nullwerte beim Lesen von Zeilen </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>void</type><methodname>ifx_nullformat</methodname> <methodparam><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> - Sets the default return value of a NULL-value on a fetch row. - Mode "0" returns "", and mode "1" returns "&null;". + Hiermit wird festgelegt, wie Nullwerte in einer Ergebnismenge + dargestellt werden sollen. Modus "0" gibt "" (einen leerren String), + und Modus "1" gibt "&null; zurück". </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-num-fields.xml diff -u phpdoc-de/reference/ifx/functions/ifx-num-fields.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-num-fields.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-num-fields.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-num-fields.xml Tue Dec 10 19:32:21 2002 @@ -1,24 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-num-fields"> <refnamediv> <refname>ifx_num_fields</refname> - <refpurpose>Returns the number of columns in the query</refpurpose> + <refpurpose>Gibt die Anzahl der Spalten einer Abfrage zurück</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_num_fields</methodname> <methodparam><type>int</type><parameter>result_id</parameter></methodparam> </methodsynopsis> <para> - Returns the number of columns in query for - <parameter>result_id</parameter> or &false; on error + Gibt die Anzahl der Spalten in dem durch <parameter>result_id</parameter> bestimmten Abfrageergebnis zurück oder &false;, falls ein Fehler auftritt. </para> <para> - After preparing or executing a query, this call gives you the - number of columns in the query. + Nachdem eine Abfrage vorbereitet oder ausgeführt wurde, liefert diese Funktion die Anzahl der Spalten in der Abfrage. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-num-rows.xml diff -u phpdoc-de/reference/ifx/functions/ifx-num-rows.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-num-rows.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-num-rows.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-num-rows.xml Tue Dec 10 19:32:21 2002 @@ -1,22 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-num-rows"> <refnamediv> <refname>ifx_num_rows</refname> <refpurpose>Count the rows already fetched from a query</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_num_rows</methodname> <methodparam><type>int</type><parameter>result_id</parameter></methodparam> </methodsynopsis> <para> - Gives the number of rows fetched so far for a query with - <parameter>result_id</parameter> after a - <function>ifx_query</function> or <function>ifx_do</function> - query. + Gibt nach der Ausführung von <function>ifx_query</function> oder + <function>ifx_do</function>die Anzahl der Zeilen in der durch + <parameter>result_id</parameter> gegebenen Ergebnismenge zurück. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-pconnect.xml diff -u phpdoc-de/reference/ifx/functions/ifx-pconnect.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-pconnect.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-pconnect.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-pconnect.xml Tue Dec 10 19:32:21 2002 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-pconnect"> <refnamediv> <refname>ifx_pconnect</refname> - <refpurpose>Open persistent Informix connection</refpurpose> + <refpurpose>Öffnet eine persistente Informix Verbindung</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_pconnect</methodname> <methodparam choice="opt"><type>string</type><parameter>database</parameter></methodparam> @@ -15,32 +15,34 @@ <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> </methodsynopsis> <para> - Returns: A positive Informix persistent link identifier on success, - or &false; on error + Gibt bei einem erfolgreichen Verbindungsaufbau eine positive Informix + Verbindungskennung zurück oder &false;, falls ein Fehler auftrat. </para> <para> - <function>ifx_pconnect</function> acts very much like - <function>ifx_connect</function> with two major differences. + <function>ifx_pconnect</function> verhält sich sehr ähnlich wie + <function>ifx_connect</function> mit hauptsächlich zwei Unterschieden: </para> <para> - This function behaves exactly like <function>ifx_connect</function> - when PHP is not running as an Apache module. - First, when connecting, the function would first try to find a - (persistent) link that's already open with the same host, - username and password. If one is found, an identifier for it - will be returned instead of opening a new connection. + Diese Funktion verhält sich exakt wie <function>ifx_connect</function> + wenn PHP nicht als Apache-Modul läuft. Bei einem Verbindungsaufbau + wird zuerst versucht, eine bereits geöffnete (persistente) Verbindung + zu finden, die mit denselben Angaben für Host, Benutzername und + Passwort geöffnet wurde. Wird eine solche Verbindung gefunden, so wird + deren Verbindungskennung zurückgegeben, anstatt eine neue Verbindung + zu öffnen. </para> <para> - Second, the connection to the SQL server will not be closed when - the execution of the script ends. Instead, the link will remain - open for future use (<function>ifx_close</function> will not - close links established by <function>ifx_pconnect</function>). + Zweitens wird die Verbindung zum SQL-Server nicht geschlossen, wenn + die Ausführung des Skripts beendet ist. Stattdessen bleibt sie + für die weitere Benutzung offen (<function>ifx_close</function> + schliesst keine Verbindung, die mit + <function>ifx_pconnect</function> geöffnet wurde). </para> <para> - This type of links is therefore called 'persistent'. + Aus diesem Grunde werden solche Verbindungen 'persistent' genannt. </para> <para> - See also: <function>ifx_connect</function>. + Siehe auch: <function>ifx_connect</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-query.xml diff -u phpdoc-de/reference/ifx/functions/ifx-query.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-query.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-query.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-query.xml Tue Dec 10 19:32:21 2002 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-query"> <refnamediv> <refname>ifx_query</refname> - <refpurpose>Send Informix query</refpurpose> + <refpurpose>Schickt eine Informix Abfrage an den Server</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> @@ -18,68 +18,68 @@ </parameter></methodparam> </methodsynopsis> <para> - Returns: A positive Informix result identifier on success, or - &false; on error. + Gibt bei Erfolg einen positiven Integerwert als Ergebniskennung + zurück oder &false;, falls ein Fehler auftrat. </para> - <para> - A "result_id" resource used by other functions to retrieve the - query results. Sets "affected_rows" for retrieval by the - <function>ifx_affected_rows</function> function. + <para> + Die Ergebniskennung, "result-id", wird von anderen Funktionen + benutzt. Die Zahl der betroffenen Zeilen wird für spätere Abfragen + mit <function>ifx_affected_rows</function> gesetzt. </para> - <para> - <function>ifx_query</function> sends a query to the currently - active database on the server that's associated with the - specified link identifier. <!-- If the link identifier isn't - specified, the last opened link is assumed. If no link is open, - the function tries to establish a link as if - <function>ifx_connect</function> was called, and use it. --> - </para> - <para> - Executes <parameter>query</parameter> on connection - <parameter>conn_id</parameter>. For "select-type" queries a - cursor is declared and opened. The optional - <parameter>cursor_type</parameter> parameter allows you to make - this a "scroll" and/or "hold" cursor. It's a bitmask and can be - either IFX_SCROLL, IFX_HOLD, or both or'ed together. Non-select - queries are "execute immediate". IFX_SCROLL and IFX_HOLD are - symbolic constants and as such shouldn't be between quotes. I you - omit this parameter the cursor is a normal sequential cursor. - </para> - <para> - For either query type the number of (estimated or real) affected - rows is saved for retrieval by - <function>ifx_affected_rows</function>. - </para> - <para> - If you have BLOB (BYTE or TEXT) columns in an update query, you - can add a <parameter>blobidarray</parameter> parameter containing - the corresponding "blob ids", and you should replace those - columns with a "?" in the query text. - </para> - <para> - If the contents of the TEXT (or BYTE) column allow it, you can - also use "ifx_textasvarchar(1)" and "ifx_byteasvarchar(1)". This - allows you to treat TEXT (or BYTE) columns just as if they were - ordinary (but long) VARCHAR columns for select queries, and you - don't need to bother with blob id's. - </para><para> - With ifx_textasvarchar(0) or ifx_byteasvarchar(0) (the default - situation), select queries will return BLOB columns as blob id's - (integer value). You can get the value of the blob as a string - or file with the blob functions (see below). + <para> + <function>ifx_query</function> schickt eine Abfrage an die + gegenwärtig aktive Datenbank auf dem Server, die durch die angegebene + Verbindungskennung bezeichnet wird. + </para> + <para> + Auf der Verbindung <parameter>conn_id</parameter> wird eine + <parameter>query</parameter> ausgeführt. Bei SELECT-Abfragen wird ein + Cursor deklariert und geöffnet. Mit dem optionalen Parameter + <parameter>cursor_type</parameter> können Sie bestimmen, ob dies ein + "scroll"- und/oder ein "hold"-Cursor sein soll. Dies ist eine + Bitmaske, die entweder die Werte IFX_SCROLL, IFX_HOLD oder beides + (mit OR verknüpft) annehmen kann. Andere Abfragen auuser SELECTs + werden unverzüglich ausgeführt. IFX_SCROLL und IFX_HOLD sind + symbolische Konstanten und als solche sollten sie nicht in + Anführungszeichen eingeschlossen werden. Wenn Sie den Parameter + weglassen, definieren Sie einen ganz normalen sequentiellen Cursor. + </para> + <para> + Für jeden Abfragetyp wird die Anzahl der betroffenen Zeilen (geschätzt oder wirklich) für spätere Abfragen mit <function>ifx_affected_rows</function> gespeichert. </para> <para> - See also: <function>ifx_connect</function>. + Falls Sie BLOB-Felder (BYTE oder TEXT) in einem UPDATE haben, können + Sie den Parameter <parameter>blobidarray</parameter> benutzen, der + die entsprechenden blob-ids enthält und Sie sollten diese Felder in + der Abfrage durch "?" ersetzen. + </para> + <para> + Falls der Inhalt der TEXT- (oder BYTE) Spalte es erlaubt, können Sie + auch "ifx_textasvarchar(1)" und "ifx_byteasvarchar(1)" benutzen. + Damit können Sie TEXT- oder BYTE-Felder behandeln, als wären sie + normale (nur sehr lange) VARCHAR-Felder in SELECT-Abfragen und Sie + brauchen sich nicht um blob-ids kümmern. + </para> + <para> + Mit ifx_textasvarchar(0) oder ifx_byteasvarchar(0) (der + Standardeinstellung) werden für BLOB-Spalten in SELECT-Abfragen die + blob-ids (Integerwerte) zurückgegeben. Sie können die Inhalte der + BLOBs mit den BLOB-Funktionen als Zeichenketten oder Dateien erhalten + (siehe weiter unten) . + </para> + <para> + <para> + Siehe auch: <function>ifx_connect</function>. <example> <title> - Show all rows of the "orders" table as a html table + Gibt alle Zeilen der "orders"-Tabelle als HTML-Tabelle zurück </title> <programlisting role="php"> <![CDATA[ -ifx_textasvarchar(1); // use "text mode" for blobs +ifx_textasvarchar(1); // "text mode" bei blobs benutzen $res_id = ifx_query("select * from orders", $conn_id); if (! $res_id) { - printf("Can't select orders : %s\n<br>%s<br>\n", ifx_error()); + printf("Kann orders nicht abfragen: %s\n<br>%s<br>\n", ifx_error()); ifx_errormsg(); die; } @@ -89,23 +89,23 @@ </programlisting> </example> <example> - <title>Insert some values into the "catalog" table</title> + <title>Ein paar Werte in die "catalog"-Tabelle einfügen</title> <programlisting role="php"> <![CDATA[ - // create blob id's for a byte and text column -$textid = ifx_create_blob(0, 0, "Text column in memory"); -$byteid = ifx_create_blob(1, 0, "Byte column in memory"); - // store blob id's in a blobid array + // blob id's für byte- und text-Spalten erzeugen +$textid = ifx_create_blob(0, 0, "Text Spalte im Speicher"); +$byteid = ifx_create_blob(1, 0, "Byte Spalte im Speicher"); + // blob id's in einem blobid array speichern $blobidarray[] = $textid; $blobidarray[] = $byteid; - // launch query + // Abfrage ausführen $query = "insert into catalog (stock_num, manu_code, " . "cat_descr,cat_picture) values(1,'HRO',?,?)"; $res_id = ifx_query($query, $conn_id, $blobidarray); if (! $res_id) { - ... error ... + ... Fehler ... } - // free result id + // Speicher freigeben ifx_free_result($res_id); ]]> </programlisting> @@ -133,4 +133,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file
Index: phpdoc-de/reference/ifx/functions/ifx-free-result.xml diff -u phpdoc-de/reference/ifx/functions/ifx-free-result.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-free-result.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-free-result.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-free-result.xml Tue Dec 10 19:32:21 2002 @@ -1,20 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-free-result"> <refnamediv> <refname>ifx_free_result</refname> - <refpurpose>Releases resources for the query</refpurpose> + <refpurpose>Gibt den belegten Speicher einer Ergebnismenge wieder frei</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_free_result</methodname> <methodparam><type>int</type><parameter>result_id</parameter></methodparam> </methodsynopsis> <para> - Releases resources for the query associated with - <parameter>result_id</parameter>. Returns &false; on error. + Gibt den belegten Speicher, der mit der Ergebniskennung + <parameter>result_id</parameter> verknüpft ist, wieder frei. + Bei einem Fehler wird &false; zurückgegeben. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-get-blob.xml diff -u phpdoc-de/reference/ifx/functions/ifx-get-blob.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-get-blob.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-get-blob.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-get-blob.xml Tue Dec 10 19:32:21 2002 @@ -1,20 +1,20 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-get-blob"> <refnamediv> <refname>ifx_get_blob</refname> - <refpurpose>Return the content of a blob object</refpurpose> + <refpurpose>Gibt den Inhalt eines Large Objects zurück</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_get_blob</methodname> <methodparam><type>int</type><parameter>bid</parameter></methodparam> </methodsynopsis> <para> - Returns the content of the blob object for the given blob - object-id <parameter>bid</parameter>. + Gibt den Inhalt des Large Objects zurück, das durch die gegebene + Objekt-ID <parameter>bid</parameter> bestimmt wird. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-get-char.xml diff -u phpdoc-de/reference/ifx/functions/ifx-get-char.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-get-char.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-get-char.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-get-char.xml Tue Dec 10 19:32:21 2002 @@ -1,20 +1,20 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-get-char"> <refnamediv> <refname>ifx_get_char</refname> - <refpurpose>Return the content of the char object</refpurpose> + <refpurpose>Gibt den Inhalt eines Zeichen-Objekts zurück</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_get_char</methodname> <methodparam><type>int</type><parameter>bid</parameter></methodparam> </methodsynopsis> <para> - Returns the content of the char object for the given char - object-id <parameter>bid</parameter>. + Gibt den Inhalt des durch die Objekt-ID <parameter>bid</parameter> + gegebenen Zeichen-Objekts zurück. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-getsqlca.xml diff -u phpdoc-de/reference/ifx/functions/ifx-getsqlca.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-getsqlca.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-getsqlca.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-getsqlca.xml Tue Dec 10 19:32:21 2002 @@ -1,45 +1,45 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-getsqlca"> <refnamediv> <refname>ifx_getsqlca</refname> <refpurpose> - Get the contents of sqlca.sqlerrd[0..5] after a query + Gibt den Inhalt von sqlca.sqlerrd[0..5] nach einer Abfrage zurück </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>array</type><methodname>ifx_getsqlca</methodname> <methodparam><type>int</type><parameter>result_id</parameter></methodparam> </methodsynopsis> <para> - <parameter>result_id</parameter> is a valid result id returned by - <function>ifx_query</function> or - <function>ifx_prepare</function>. + <parameter>result_id</parameter> ist eine gültige Ergebniskennung, die + von <function>ifx_query</function> oder <function>ifx_prepare</function> + zurückgegeben wurde. </para> <para> - Returns a pseudo-row (associative array) with sqlca.sqlerrd[0] - ... sqlca.sqlerrd[5] after the query associated with - <parameter>result_id</parameter>. + Diese Funktion gibt nach einer Abfrage, die mit <parameter>result_id</parameter> + verknüpft ist, eine Pseudo-Zeile (assoziatives Array) mit + sqlca.sqlerrd[0] ... sqlca.sqlerrd[5] zurück. </para> <para> - For inserts, updates and deletes the values returned are those as - set by the server after executing the query. This gives access to - the number of affected rows and the serial insert value. For - SELECTs the values are those saved after the PREPARE - statement. This gives access to the *estimated* number of - affected rows. The use of this function saves the overhead of - executing a "select dbinfo('sqlca.sqlerrdx')" query, as it - retrieves the values that were saved by the ifx driver at the - appropriate moment. + Bei INSERTs, UPDATEs und DELETEs sind die zurückgegebenen Werte die, + die der Server nach dem Ausführen der Abfrage setzt. Dadurch bekommt + man Zugriff auf die Anzahl der betroffenen Zeilen und auf den + Eingabewert eines Serial-Feldes. Bei SELECTs sind das die Werte, die + nach einem PREPARE-Kommando gespeichert wurden. Hier hat man Zugriff + auf die *geschätzte* Anzahl der betroffenen Zeilen. Der Gebrauch + dieser Funktion erspart den Overhead für die Ausführung einer + "select dbinfo('sqlca.sqlerrdx')"-Abfrage, weil hier die Werte gelesen + werden, die der ifx-Treiber im passenden Moment gespeichert hat. </para> <example> - <title>Retrieve Informix sqlca.sqlerrd[x] values</title> + <title>Informix sqlca.sqlerrd[x] Werte ermitteln</title> <programlisting role="php"> <![CDATA[ -/* assume the first column of 'sometable' is a serial */ +/* angenommen, das erste Feld von 'sometable' ist vom Typ SERIAL */ $qid = ifx_query("insert into sometable values (0, '2nd column', 'another column') ", $connid); if (! $qid) { @@ -47,7 +47,7 @@ } $sqlca = ifx_getsqlca ($qid); $serial_value = $sqlca["sqlerrd1"]; -echo "The serial value of the inserted row is : " . $serial_value<br>\n"; +echo "Der Wert des SERIAL-Feldes der eingefügten Zeile ist: " . $serial_value<br>\n"; ]]> </programlisting> </example> Index: phpdoc-de/reference/ifx/functions/ifx-htmltbl-result.xml diff -u phpdoc-de/reference/ifx/functions/ifx-htmltbl-result.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-htmltbl-result.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-htmltbl-result.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-htmltbl-result.xml Tue Dec 10 19:32:21 2002 @@ -1,44 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-htmltbl-result"> <refnamediv> <refname>ifx_htmltbl_result</refname> <refpurpose> - Formats all rows of a query into a HTML table + Gibt alle Zeilen einer Abfrage als HTML-Tabelle formatiert zurück </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_htmltbl_result</methodname> <methodparam><type>int</type><parameter>result_id</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>html_table_options</parameter></methodparam> </methodsynopsis> <para> - Returns the number of rows fetched or &false; on error. + Gibt die Anzahl der gelesenen Zeilen aus oder &false; bei einem Fehler. </para> <para> - Formats all rows of the <parameter>result_id</parameter> query - into a html table. The optional second argument is a string of - <table> tag options + Gibt alle Zeilen der durch <parameter>result_id</parameter> bestimmten + Abfrage fornmatiert in einer HTML-Tabelle zurück. Das optionale zweite + Argument ist ein String mit <table>-Tag Optionen. </para> <example> - <title>Informix results as HTML table</title> + <title>Informix Ergebnisse als HTML Tabellen</title> <programlisting role="php"> <![CDATA[ $rid = ifx_prepare ("select * from emp where name like " . $name, $connid, IFX_SCROLL); if (! $rid) { - ... error ... + ... Fehler ... } $rowcount = ifx_affected_rows ($rid); if ($rowcount > 1000) { - printf ("Too many rows in result set (%d)\n<br>", $rowcount); - die ("Please restrict your query<br>\n"); + printf ("Zu viele Zeilen in der Ergebnismenge (%d)\n<br>", $rowcount); + die ("Bitte beschränken Sie die Abfrage<br>\n"); } if (! ifx_do($rid) { - ... error ... + ... Fehler ... } ifx_htmltbl_result ($rid, "border=\"2\""); Index: phpdoc-de/reference/ifx/functions/ifx-nullformat.xml diff -u phpdoc-de/reference/ifx/functions/ifx-nullformat.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-nullformat.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-nullformat.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-nullformat.xml Tue Dec 10 19:32:21 2002 @@ -1,22 +1,23 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-nullformat"> <refnamediv> <refname>ifx_nullformat</refname> <refpurpose> - Sets the default return value on a fetch row + Setzt den aktuellen Rückgabewert für Nullwerte beim Lesen von Zeilen </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>void</type><methodname>ifx_nullformat</methodname> <methodparam><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> - Sets the default return value of a NULL-value on a fetch row. - Mode "0" returns "", and mode "1" returns "&null;". + Hiermit wird festgelegt, wie Nullwerte in einer Ergebnismenge + dargestellt werden sollen. Modus "0" gibt "" (einen leerren String), + und Modus "1" gibt "&null; zurück". </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-num-fields.xml diff -u phpdoc-de/reference/ifx/functions/ifx-num-fields.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-num-fields.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-num-fields.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-num-fields.xml Tue Dec 10 19:32:21 2002 @@ -1,24 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-num-fields"> <refnamediv> <refname>ifx_num_fields</refname> - <refpurpose>Returns the number of columns in the query</refpurpose> + <refpurpose>Gibt die Anzahl der Spalten einer Abfrage zurück</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_num_fields</methodname> <methodparam><type>int</type><parameter>result_id</parameter></methodparam> </methodsynopsis> <para> - Returns the number of columns in query for - <parameter>result_id</parameter> or &false; on error + Gibt die Anzahl der Spalten in dem durch <parameter>result_id</parameter> bestimmten Abfrageergebnis zurück oder &false;, falls ein Fehler auftritt. </para> <para> - After preparing or executing a query, this call gives you the - number of columns in the query. + Nachdem eine Abfrage vorbereitet oder ausgeführt wurde, liefert diese Funktion die Anzahl der Spalten in der Abfrage. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-num-rows.xml diff -u phpdoc-de/reference/ifx/functions/ifx-num-rows.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-num-rows.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-num-rows.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-num-rows.xml Tue Dec 10 19:32:21 2002 @@ -1,22 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-num-rows"> <refnamediv> <refname>ifx_num_rows</refname> <refpurpose>Count the rows already fetched from a query</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_num_rows</methodname> <methodparam><type>int</type><parameter>result_id</parameter></methodparam> </methodsynopsis> <para> - Gives the number of rows fetched so far for a query with - <parameter>result_id</parameter> after a - <function>ifx_query</function> or <function>ifx_do</function> - query. + Gibt nach der Ausführung von <function>ifx_query</function> oder + <function>ifx_do</function>die Anzahl der Zeilen in der durch + <parameter>result_id</parameter> gegebenen Ergebnismenge zurück. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-pconnect.xml diff -u phpdoc-de/reference/ifx/functions/ifx-pconnect.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-pconnect.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-pconnect.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-pconnect.xml Tue Dec 10 19:32:21 2002 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-pconnect"> <refnamediv> <refname>ifx_pconnect</refname> - <refpurpose>Open persistent Informix connection</refpurpose> + <refpurpose>Öffnet eine persistente Informix Verbindung</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_pconnect</methodname> <methodparam choice="opt"><type>string</type><parameter>database</parameter></methodparam> @@ -15,32 +15,34 @@ <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> </methodsynopsis> <para> - Returns: A positive Informix persistent link identifier on success, - or &false; on error + Gibt bei einem erfolgreichen Verbindungsaufbau eine positive Informix + Verbindungskennung zurück oder &false;, falls ein Fehler auftrat. </para> <para> - <function>ifx_pconnect</function> acts very much like - <function>ifx_connect</function> with two major differences. + <function>ifx_pconnect</function> verhält sich sehr ähnlich wie + <function>ifx_connect</function> mit hauptsächlich zwei Unterschieden: </para> <para> - This function behaves exactly like <function>ifx_connect</function> - when PHP is not running as an Apache module. - First, when connecting, the function would first try to find a - (persistent) link that's already open with the same host, - username and password. If one is found, an identifier for it - will be returned instead of opening a new connection. + Diese Funktion verhält sich exakt wie <function>ifx_connect</function> + wenn PHP nicht als Apache-Modul läuft. Bei einem Verbindungsaufbau + wird zuerst versucht, eine bereits geöffnete (persistente) Verbindung + zu finden, die mit denselben Angaben für Host, Benutzername und + Passwort geöffnet wurde. Wird eine solche Verbindung gefunden, so wird + deren Verbindungskennung zurückgegeben, anstatt eine neue Verbindung + zu öffnen. </para> <para> - Second, the connection to the SQL server will not be closed when - the execution of the script ends. Instead, the link will remain - open for future use (<function>ifx_close</function> will not - close links established by <function>ifx_pconnect</function>). + Zweitens wird die Verbindung zum SQL-Server nicht geschlossen, wenn + die Ausführung des Skripts beendet ist. Stattdessen bleibt sie + für die weitere Benutzung offen (<function>ifx_close</function> + schliesst keine Verbindung, die mit + <function>ifx_pconnect</function> geöffnet wurde). </para> <para> - This type of links is therefore called 'persistent'. + Aus diesem Grunde werden solche Verbindungen 'persistent' genannt. </para> <para> - See also: <function>ifx_connect</function>. + Siehe auch: <function>ifx_connect</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/ifx/functions/ifx-query.xml diff -u phpdoc-de/reference/ifx/functions/ifx-query.xml:1.1 phpdoc-de/reference/ifx/functions/ifx-query.xml:1.2 --- phpdoc-de/reference/ifx/functions/ifx-query.xml:1.1 Thu Aug 22 18:34:11 2002 +++ phpdoc-de/reference/ifx/functions/ifx-query.xml Tue Dec 10 19:32:21 2002 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/ifx.xml, last change in rev 1.2 --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision 1.2: Maintainer: conni Status: ready --> <refentry id="function.ifx-query"> <refnamediv> <refname>ifx_query</refname> - <refpurpose>Send Informix query</refpurpose> + <refpurpose>Schickt eine Informix Abfrage an den Server</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>ifx_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> @@ -18,68 +18,68 @@ </parameter></methodparam> </methodsynopsis> <para> - Returns: A positive Informix result identifier on success, or - &false; on error. + Gibt bei Erfolg einen positiven Integerwert als Ergebniskennung + zurück oder &false;, falls ein Fehler auftrat. </para> - <para> - A "result_id" resource used by other functions to retrieve the - query results. Sets "affected_rows" for retrieval by the - <function>ifx_affected_rows</function> function. + <para> + Die Ergebniskennung, "result-id", wird von anderen Funktionen + benutzt. Die Zahl der betroffenen Zeilen wird für spätere Abfragen + mit <function>ifx_affected_rows</function> gesetzt. </para> - <para> - <function>ifx_query</function> sends a query to the currently - active database on the server that's associated with the - specified link identifier. <!-- If the link identifier isn't - specified, the last opened link is assumed. If no link is open, - the function tries to establish a link as if - <function>ifx_connect</function> was called, and use it. --> - </para> - <para> - Executes <parameter>query</parameter> on connection - <parameter>conn_id</parameter>. For "select-type" queries a - cursor is declared and opened. The optional - <parameter>cursor_type</parameter> parameter allows you to make - this a "scroll" and/or "hold" cursor. It's a bitmask and can be - either IFX_SCROLL, IFX_HOLD, or both or'ed together. Non-select - queries are "execute immediate". IFX_SCROLL and IFX_HOLD are - symbolic constants and as such shouldn't be between quotes. I you - omit this parameter the cursor is a normal sequential cursor. - </para> - <para> - For either query type the number of (estimated or real) affected - rows is saved for retrieval by - <function>ifx_affected_rows</function>. - </para> - <para> - If you have BLOB (BYTE or TEXT) columns in an update query, you - can add a <parameter>blobidarray</parameter> parameter containing - the corresponding "blob ids", and you should replace those - columns with a "?" in the query text. - </para> - <para> - If the contents of the TEXT (or BYTE) column allow it, you can - also use "ifx_textasvarchar(1)" and "ifx_byteasvarchar(1)". This - allows you to treat TEXT (or BYTE) columns just as if they were - ordinary (but long) VARCHAR columns for select queries, and you - don't need to bother with blob id's. - </para><para> - With ifx_textasvarchar(0) or ifx_byteasvarchar(0) (the default - situation), select queries will return BLOB columns as blob id's - (integer value). You can get the value of the blob as a string - or file with the blob functions (see below). + <para> + <function>ifx_query</function> schickt eine Abfrage an die + gegenwärtig aktive Datenbank auf dem Server, die durch die angegebene + Verbindungskennung bezeichnet wird. + </para> + <para> + Auf der Verbindung <parameter>conn_id</parameter> wird eine + <parameter>query</parameter> ausgeführt. Bei SELECT-Abfragen wird ein + Cursor deklariert und geöffnet. Mit dem optionalen Parameter + <parameter>cursor_type</parameter> können Sie bestimmen, ob dies ein + "scroll"- und/oder ein "hold"-Cursor sein soll. Dies ist eine + Bitmaske, die entweder die Werte IFX_SCROLL, IFX_HOLD oder beides + (mit OR verknüpft) annehmen kann. Andere Abfragen auuser SELECTs + werden unverzüglich ausgeführt. IFX_SCROLL und IFX_HOLD sind + symbolische Konstanten und als solche sollten sie nicht in + Anführungszeichen eingeschlossen werden. Wenn Sie den Parameter + weglassen, definieren Sie einen ganz normalen sequentiellen Cursor. + </para> + <para> + Für jeden Abfragetyp wird die Anzahl der betroffenen Zeilen (geschätzt oder wirklich) für spätere Abfragen mit <function>ifx_affected_rows</function> gespeichert. </para> <para> - See also: <function>ifx_connect</function>. + Falls Sie BLOB-Felder (BYTE oder TEXT) in einem UPDATE haben, können + Sie den Parameter <parameter>blobidarray</parameter> benutzen, der + die entsprechenden blob-ids enthält und Sie sollten diese Felder in + der Abfrage durch "?" ersetzen. + </para> + <para> + Falls der Inhalt der TEXT- (oder BYTE) Spalte es erlaubt, können Sie + auch "ifx_textasvarchar(1)" und "ifx_byteasvarchar(1)" benutzen. + Damit können Sie TEXT- oder BYTE-Felder behandeln, als wären sie + normale (nur sehr lange) VARCHAR-Felder in SELECT-Abfragen und Sie + brauchen sich nicht um blob-ids kümmern. + </para> + <para> + Mit ifx_textasvarchar(0) oder ifx_byteasvarchar(0) (der + Standardeinstellung) werden für BLOB-Spalten in SELECT-Abfragen die + blob-ids (Integerwerte) zurückgegeben. Sie können die Inhalte der + BLOBs mit den BLOB-Funktionen als Zeichenketten oder Dateien erhalten + (siehe weiter unten) . + </para> + <para> + <para> + Siehe auch: <function>ifx_connect</function>. <example> <title> - Show all rows of the "orders" table as a html table + Gibt alle Zeilen der "orders"-Tabelle als HTML-Tabelle zurück </title> <programlisting role="php"> <![CDATA[ -ifx_textasvarchar(1); // use "text mode" for blobs +ifx_textasvarchar(1); // "text mode" bei blobs benutzen $res_id = ifx_query("select * from orders", $conn_id); if (! $res_id) { - printf("Can't select orders : %s\n<br>%s<br>\n", ifx_error()); + printf("Kann orders nicht abfragen: %s\n<br>%s<br>\n", ifx_error()); ifx_errormsg(); die; } @@ -89,23 +89,23 @@ </programlisting> </example> <example> - <title>Insert some values into the "catalog" table</title> + <title>Ein paar Werte in die "catalog"-Tabelle einfügen</title> <programlisting role="php"> <![CDATA[ - // create blob id's for a byte and text column -$textid = ifx_create_blob(0, 0, "Text column in memory"); -$byteid = ifx_create_blob(1, 0, "Byte column in memory"); - // store blob id's in a blobid array + // blob id's für byte- und text-Spalten erzeugen +$textid = ifx_create_blob(0, 0, "Text Spalte im Speicher"); +$byteid = ifx_create_blob(1, 0, "Byte Spalte im Speicher"); + // blob id's in einem blobid array speichern $blobidarray[] = $textid; $blobidarray[] = $byteid; - // launch query + // Abfrage ausführen $query = "insert into catalog (stock_num, manu_code, " . "cat_descr,cat_picture) values(1,'HRO',?,?)"; $res_id = ifx_query($query, $conn_id, $blobidarray); if (! $res_id) { - ... error ... + ... Fehler ... } - // free result id + // Speicher freigeben ifx_free_result($res_id); ]]> </programlisting> @@ -133,4 +133,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file