cvs: phpdoc /de Translators /de/functions ingres_ii.xml /en/functions ingres_ii.xml
| From: | Egon Schmid | Date: | Tue, 04 Sep 2001 01:26:14 +0000 |
| Subject: | cvs: phpdoc /de Translators /de/functions ingres_ii.xml /en/functions ingres_ii.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969337444@lists.php.net to get a copy of this message | ||
eschmid Mon Sep 3 21:26:14 2001 EDT
Modified files:
/phpdoc/de Translators
/phpdoc/en/functions ingres_ii.xml
/phpdoc/de/functions ingres_ii.xml
Log:
Only whitespace.
Index: phpdoc/de/Translators diff -u phpdoc/de/Translators:1.193 phpdoc/de/Translators:1.194 --- phpdoc/de/Translators:1.193 Mon Sep 3 00:06:20 2001 +++ phpdoc/de/Translators Mon Sep 3 21:26:13 2001 @@ -93,7 +93,7 @@ image.xml Thomas Schuermann fertig (bis V. 1.26) imap.xml Hartmut Holzgraefe Änderungen info.xml Mark Kronsbein fertig -ingress_ii.xml Cornelia Boenigk fertig +ingres_ii.xml Cornelia Boenigk fertig (bis V. 1.10) ircg.xml Georg Richter fertig (bis V. 1.9) java.xml Sebastian Bergmann fertig ldap.xml Friedhelm Betz fertig (bis V. 1.29) Index: phpdoc/en/functions/ingres_ii.xml diff -u phpdoc/en/functions/ingres_ii.xml:1.9 phpdoc/en/functions/ingres_ii.xml:1.10 --- phpdoc/en/functions/ingres_ii.xml:1.9 Mon Sep 3 00:01:53 2001 +++ phpdoc/en/functions/ingres_ii.xml Mon Sep 3 21:26:13 2001 @@ -1,5 +1,5 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <reference id="ref.ingres"> <title>Ingres II functions</title> <titleabbrev>Ingres II</titleabbrev> @@ -20,29 +20,32 @@ </simpara> <simpara> When using this extension with Apache, if Apache does not start - and complains with "PHP Fatal error: Unable to start - ingres_ii module in Unknown on line 0" - then make sure the environement variable II_SYSTEM is correctly - set. Adding "export II_SYSTEM="/home/ingres/II" in the script - that starts Apache, just before launching httpd, should be fine. + and complains with "PHP Fatal error: Unable to start ingres_ii + module in Unknown on line 0" then make sure the environement + variable II_SYSTEM is correctly set. Adding "export + II_SYSTEM="/home/ingres/II" in the script that starts Apache, just + before launching httpd, should be fine. </simpara> <note> <para> - If you already used PHP extensions to access other database servers, - note that Ingres doesn't allow concurrent queries and/or transaction - over one connection, thus you won't find any result or transaction - handle in this extension. The result of a query must be treated - before sending another query, and a transaction must be commited or - rolled back before opening another transaction (which is automaticaly - done when sending the first query). + If you already used PHP extensions to access other database + servers, note that Ingres doesn't allow concurrent queries and/or + transaction over one connection, thus you won't find any result + or transaction handle in this extension. The result of a query + must be treated before sending another query, and a transaction + must be commited or rolled back before opening another + transaction (which is automaticaly done when sending the first + query). </para> </note> </partintro> <refentry id="function.ingres-connect"> <refnamediv> - <refname>ingres_connect</refname> - <refpurpose>Open a connection to an Ingres II database.</refpurpose> + <refname>ingres_connect</refname> + <refpurpose> + Open a connection to an Ingres II database + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -60,20 +63,22 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - Returns a Ingres II link resource on success, or &false; on failure. + Returns a Ingres II link resource on success, or &false; on + failure. </para> <para> <function>ingres_connect</function> opens a connection with the - Ingres database designated by <parameter>database</parameter>, which - follows the syntax <parameter>[node_id::]dbname[/svr_class]</parameter>. + Ingres database designated by <parameter>database</parameter>, + which follows the syntax + <parameter>[node_id::]dbname[/svr_class]</parameter>. </para> <para> If some parameters are missing, <function>ingres_connect</function> uses the values in <filename>php.ini</filename> for <parameter>ingres.default_database</parameter>, - <parameter>ingres.default_user</parameter> and + <parameter>ingres.default_user</parameter>, and <parameter>ingres.default_password</parameter>. </para> <para> @@ -97,8 +102,9 @@ </programlisting> </example> <example> - <title><function>ingres_connect</function> example - using default link</title> + <title> + <function>ingres_connect</function> example using default link + </title> <programlisting> <?php ingres_connect ("mydb", "user", "pass") @@ -109,7 +115,7 @@ </programlisting> </example> <para> See also - <function>ingres_pconnect</function>, and + <function>ingres_pconnect</function> and <function>ingres_close</function>. </para> </refsect1> @@ -119,7 +125,7 @@ <refnamediv> <refname>ingres_pconnect</refname> <refpurpose> - Open a persistent connection to an Ingres II database. + Open a persistent connection to an Ingres II database </refpurpose> </refnamediv> <refsect1> @@ -138,27 +144,28 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - Returns a Ingres II link resource on success, or &false; on failure. + Returns a Ingres II link resource on success, or &false; on + failure. </para> <para> - See <function>ingres_connect</function> for parameters details and - examples. There are only 2 differences between + See <function>ingres_connect</function> for parameters details + and examples. There are only 2 differences between <function>ingres_pconnect</function> and - <function>ingres_connect</function> : - First, when connecting, the function will first try to find a - (persistent) link that's already opened with the same parameters. - If one is found, an identifier for it will be returned instead of - opening a new connection. Second, the connection to the Ingres - server will not be closed when the execution of the script ends. - Instead, the link will remain open for future use - (<function>ingres_close</function> will not close links established - by <function>ingres_pconnect</function>). This type of link is - therefore called 'persistent'. + <function>ingres_connect</function> : First, when connecting, the + function will first try to find a (persistent) link that's + already opened with the same parameters. If one is found, an + identifier for it will be returned instead of opening a new + connection. Second, the connection to the Ingres server will not + be closed when the execution of the script ends. Instead, the + link will remain open for future use + (<function>ingres_close</function> will not close links + established by <function>ingres_pconnect</function>). This type + of link is therefore called 'persistent'. </para> <para> See also - <function>ingres_connect</function>, and + <function>ingres_connect</function> and <function>ingres_close</function>. </para> </refsect1> @@ -179,7 +186,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Returns &true; on success, or &false; on failure. </para> @@ -195,7 +202,7 @@ are automatically closed at the end of the script. </para> <para> See also - <function>ingres_connect</function>, and + <function>ingres_connect</function> and <function>ingres_pconnect</function>. </para> </refsect1> @@ -219,7 +226,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Returns &true; on success, or &false; on failure. </para> @@ -229,42 +236,55 @@ must be a valid SQL query (see the Ingres SQL reference guide) </para> <para> - The query becomes part of the currently open transaction. - If there is no open transaction, <function>ingres_query</function> + The query becomes part of the currently open transaction. If + there is no open transaction, <function>ingres_query</function> opens a new transaction. To close the transaction, you can either - call <function>ingres_commit</function> to commit the changes made - to the database or <function>ingres_rollback</function> to cancel these - changes. When the script ends, any open transaction is rolled back - (by calling <function>ingres_rollback</function>). You can also - use <function>ingres_autocommit</function> before opening a new + call <function>ingres_commit</function> to commit the changes + made to the database or <function>ingres_rollback</function> to + cancel these changes. When the script ends, any open transaction + is rolled back (by calling + <function>ingres_rollback</function>). You can also use + <function>ingres_autocommit</function> before opening a new transaction to have every SQL query immediatly commited. </para> <para> - Some types of SQL queries can't be sent with this function : + Some types of SQL queries can't be sent with this function: <itemizedlist> <listitem> - <simpara>close (see <function>ingres_close</function>).</simpara> + <simpara> + close (see <function>ingres_close</function>) + </simpara> </listitem> <listitem> - <simpara>commit (see <function>ingres_commit</function>).</simpara> + <simpara> + commit (see <function>ingres_commit</function>) + </simpara> </listitem> <listitem> - <simpara>connect (see <function>ingres_connect</function>).</simpara> + <simpara> + connect (see <function>ingres_connect</function>) + </simpara> </listitem> <listitem> - <simpara>disconnect (see <function>ingres_close</function>).</simpara> + <simpara> + disconnect (see <function>ingres_close</function>) + </simpara> + </listitem> + <listitem> + <simpara>get dbevent</simpara> + </listitem> + <listitem> + <simpara>prepare to commit</simpara> </listitem> - <listitem><simpara>get dbevent</simpara></listitem> - <listitem><simpara>prepare to commit</simpara></listitem> <listitem> <simpara> - rollback (see <function>ingres_rollback</function>). + rollback (see <function>ingres_rollback</function>) </simpara> </listitem> <listitem><simpara>savepoint</simpara></listitem> <listitem> <simpara> - set autocommit (see <function>ingres_autocommit</function>). + set autocommit (see <function>ingres_autocommit</function>) </simpara> </listitem> <listitem> @@ -294,7 +314,7 @@ <function>ingres_fetch_object</function>, <function>ingres_fetch_row</function>, <function>ingres_commit</function>, - <function>ingres_rollback</function> and + <function>ingres_rollback</function>, and <function>ingres_autocommit</function>. </para> </refsect1> @@ -317,7 +337,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> For delete, insert or update queries, <function>ingres_num_rows</function> returns the number of rows @@ -329,17 +349,16 @@ <note> <simpara> This function is mainly meant to get the number of rows - modified in the database. - If this function is called before using - <function>ingres_fetch_array</function>, + modified in the database. If this function is called before + using <function>ingres_fetch_array</function>, <function>ingres_fetch_object</function> or <function>ingres_fetch_row</function> the server will delete the result's data and the script won't be able to get them. </simpara> <simpara> - You should instead retrieve the result's data using one of these - fetch functions in a loop until it returns &false;, indicating that - no more results are available. + You should instead retrieve the result's data using one of + these fetch functions in a loop until it returns &false;, + indicating that no more results are available. </simpara> </note> </para> @@ -347,7 +366,7 @@ See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -370,17 +389,17 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_num_fields</function> returns the number of fields - in the results returned by the Ingres server after a call to - <function>ingres_query</function> + <function>ingres_num_fields</function> returns the number of + fields in the results returned by the Ingres server after a call + to <function>ingres_query</function> </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -404,7 +423,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_field_name</function> returns the name of a field in a query result, or &false; on failure. @@ -426,8 +445,10 @@ <refentry id="function.ingres-field-type"> <refnamediv> - <refname>ingres_field_type</refname> - <refpurpose>Get the type of a field in a query result.</refpurpose> + <refname>ingres_field_type</refname> + <refpurpose> + Get the type of a field in a query result + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -442,28 +463,28 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_type</function> returns the type of a field - in a query result, or &false; on failure. - Examples of types returned are "IIAPI_BYTE_TYPE", - "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", "IIAPI_FLT_TYPE", - "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE". Some of these types can map - to more than one SQL type depending on the length of the field - (see <function>ingres_field_length</function>). For example + <function>ingres_field_type</function> returns the type of a + field in a query result, or &false; on failure. Examples of + types returned are "IIAPI_BYTE_TYPE", "IIAPI_CHA_TYPE", + "IIAPI_DTE_TYPE", "IIAPI_FLT_TYPE", "IIAPI_INT_TYPE", + "IIAPI_VCH_TYPE". Some of these types can map to more than one + SQL type depending on the length of the field (see + <function>ingres_field_length</function>). For example "IIAPI_FLT_TYPE" can be a float4 or a float8. For detailed information, see the Ingres/OpenAPI User Guide - Appendix C. </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by + <parameter>index</parameter> is the number of the field and must + be between 1 and the value given by <function>ingres_num_fields</function>. </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -472,7 +493,7 @@ <refentry id="function.ingres-field-nullable"> <refnamediv> <refname>ingres_field_nullable</refname> - <refpurpose>Test if a field is nullable.</refpurpose> + <refpurpose>Test if a field is nullable</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -487,21 +508,21 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_nullable</function> returns &true; if the field - can be set to the &null; value and &false; if it can't. + <function>ingres_field_nullable</function> returns &true; if the + field can be set to the &null; value and &false; if it can't. </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by + <parameter>index</parameter> is the number of the field and must + be between 1 and the value given by <function>ingres_num_fields</function>. </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -510,7 +531,7 @@ <refentry id="function.ingres-field-length"> <refnamediv> <refname>ingres_field_length</refname> - <refpurpose>Get the length of a field.</refpurpose> + <refpurpose>Get the length of a field</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -525,22 +546,23 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_length</function> returns the length of a field. - This is the number of bytes used by the server to store the field. - For detailed information, see the Ingres/OpenAPI User Guide - Appendix C. + <function>ingres_field_length</function> returns the length of a + field. This is the number of bytes used by the server to store + the field. For detailed information, see the Ingres/OpenAPI User + Guide - Appendix C. </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by + <parameter>index</parameter> is the number of the field and must + be between 1 and the value given by <function>ingres_num_fields</function>. </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -549,38 +571,39 @@ <refentry id="function.ingres-field-precision"> <refnamediv> <refname>ingres_field_precision</refname> - <refpurpose>Get the precision of a field.</refpurpose> + <refpurpose>Get the precision of a field</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>ingres_field_precision</function></funcdef> - <paramdef>int - <parameter>index</parameter> + <funcdef>int + <function>ingres_field_precision</function> + </funcdef> + <paramdef>int <parameter>index</parameter> </paramdef> <paramdef>resource <parameter><optional>link</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_precision</function> returns the precision of - a field. This value is used only for decimal, float and money SQL data - types. For detailed information, see the Ingres/OpenAPI User Guide - - Appendix C. + <function>ingres_field_precision</function> returns the precision + of a field. This value is used only for decimal, float and money + SQL data types. For detailed information, see the Ingres/OpenAPI + User Guide - Appendix C. </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by + <parameter>index</parameter> is the number of the field and must + be between 1 and the value given by <function>ingres_num_fields</function>. </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -589,7 +612,7 @@ <refentry id="function.ingres-field-scale"> <refnamediv> <refname>ingres_field_scale</refname> - <refpurpose>Get the scale of a field.</refpurpose> + <refpurpose>Get the scale of a field</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -606,20 +629,21 @@ </funcsynopsis> &warn.experimental.func; <para> - <function>ingres_field_scale</function> returns the scale of a field. - This value is used only for the decimal SQL data type. For detailed - information, see the Ingres/OpenAPI User Guide - Appendix C. + <function>ingres_field_scale</function> returns the scale of a + field. This value is used only for the decimal SQL data + type. For detailed information, see the Ingres/OpenAPI User Guide + - Appendix C. </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by + <parameter>index</parameter> is the number of the field and must + be between 1 and the value given by <function>ingres_num_fields</function>. </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -628,7 +652,7 @@ <refentry id="function.ingres-fetch-array"> <refnamediv> <refname>ingres_fetch_array</refname> - <refpurpose>Fetch a row of result into an array.</refpurpose> + <refpurpose>Fetch a row of result into an array</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -643,22 +667,24 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_fetch_array</function> Returns an array that corresponds - to the fetched row, or &false; if there are no more rows. + <function>ingres_fetch_array</function> Returns an array that + corresponds to the fetched row, or &false; if there are no more + rows. </para> <para> This function is an extended version of - <function>ingres_fetch_row</function>. In addition to storing the - data in the numeric indices of the result array, it also stores - the data in associative indices, using the field names as keys. + <function>ingres_fetch_row</function>. In addition to storing + the data in the numeric indices of the result array, it also + stores the data in associative indices, using the field names as + keys. </para> <para> If two or more columns of the result have the same field names, - the last column will take precedence. To access the other column(s) - of the same name, you must use the numeric index of the column or - make an alias for the column. + the last column will take precedence. To access the other + column(s) of the same name, you must use the numeric index of the + column or make an alias for the column. <informalexample> <programlisting> ingres_query(select t1.f1 as foo t2.f1 as bar from t1, t2); @@ -669,8 +695,9 @@ </informalexample> </para> <para> - <parameter>result_type</parameter> can be INGRES_NUM for enumerated array, - INGRES_ASSOC for associative array, or INGRES_BOTH (default). + <parameter>result_type</parameter> can be INGRES_NUM for + enumerated array, INGRES_ASSOC for associative array, or + INGRES_BOTH (default). </para> <para> Speed-wise, the function is identical to @@ -701,7 +728,7 @@ <function>ingres_query</function>, <function>ingres_num_fields</function>, <function>ingres_field_name</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -710,7 +737,9 @@ <refentry id="function.ingres-fetch-row"> <refnamediv> <refname>ingres_fetch_row</refname> - <refpurpose>Fetch a row of result into an enumerated array.</refpurpose> + <refpurpose> + Fetch a row of result into an enumerated array + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -722,11 +751,12 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_fetch_row</function> returns an array that corresponds - to the fetched row, or &false; if there are no more rows. Each result - column is stored in an array offset, starting at offset 1. + <function>ingres_fetch_row</function> returns an array that + corresponds to the fetched row, or &false; if there are no more + rows. Each result column is stored in an array offset, starting + at offset 1. </para> <para> Subsequent call to <function>ingres_fetch_row</function> would @@ -753,7 +783,7 @@ See also <function>ingres_num_fields</function>, <function>ingres_query</function>, - <function>ingres_fetch_array</function> and + <function>ingres_fetch_array</function>, and <function>ingres_fetch_object</function>. </para> </refsect1> @@ -768,7 +798,9 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>object <function>ingres_fetch_object</function></funcdef> + <funcdef>object + <function>ingres_fetch_object</function> + </funcdef> <paramdef>int <parameter><optional>result_type</optional></parameter> </paramdef> @@ -777,10 +809,11 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_fetch_object</function> Returns an object that - corresponds to the fetched row, or &false; if there are no more rows. + corresponds to the fetched row, or &false; if there are no more + rows. </para> <para> This function is similar to @@ -820,7 +853,7 @@ <function>ingres_query</function>, <function>ingres_num_fields</function>, <function>ingres_field_name</function>, - <function>ingres_fetch_array</function> and + <function>ingres_fetch_array</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -829,7 +862,7 @@ <refentry id="function.ingres-rollback"> <refnamediv> <refname>ingres_rollback</refname> - <refpurpose>Roll back a transaction.</refpurpose> + <refpurpose>Roll back a transaction</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -841,11 +874,11 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_rollback</function> rolls back the currently open - transaction, actually canceling all changes made to the database - during the transaction. + <function>ingres_rollback</function> rolls back the currently + open transaction, actually canceling all changes made to the + database during the transaction. </para> <para> This closes the transaction. A new one can be open by sending a @@ -854,7 +887,7 @@ <para> See also <function>ingres_query</function>, - <function>ingres_commit</function> and + <function>ingres_commit</function>, and <function>ingres_autocommit</function>. </para> </refsect1> @@ -863,7 +896,7 @@ <refentry id="function.ingres-commit"> <refnamediv> <refname>ingres_commit</refname> - <refpurpose>Commit a transaction.</refpurpose> + <refpurpose>Commit a transaction</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -875,7 +908,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_commit</function> commits the currently open transaction, making all changes made to the database permanent. @@ -885,14 +918,14 @@ query with <function>ingres_query</function>. </para> <para> - You can also have the server commit automaticaly after every query - by calling <function>ingres_autocommit</function> before opening the - transaction. + You can also have the server commit automaticaly after every + query by calling <function>ingres_autocommit</function> before + opening the transaction. </para> <para> See also <function>ingres_query</function>, - <function>ingres_rollback</function> and + <function>ingres_rollback</function>, and <function>ingres_autocommit</function>. </para> </refsect1> @@ -901,7 +934,7 @@ <refentry id="function.ingres-autocommit"> <refnamediv> <refname>ingres_autocommit</refname> - <refpurpose>Switch autocommit on or off.</refpurpose> + <refpurpose>Switch autocommit on or off</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -913,24 +946,25 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_autocommit</function> is called before opening a - transaction (before the first call to <function>ingres_query</function> - or just after a call to <function>ingres_rollback</function> or - <function>ingres_autocommit</function>) to switch the "autocommit" mode - of the server on or off (when the script begins the autocommit mode is - off). + transaction (before the first call to + <function>ingres_query</function> or just after a call to + <function>ingres_rollback</function> or + <function>ingres_autocommit</function>) to switch the + "autocommit" mode of the server on or off (when the script begins + the autocommit mode is off). </para> <para> - When the autocommit mode is on, every query is automaticaly commited - by the server, as if <function>ingres_commit</function> was called - after every call to <function>ingres_query</function>. + When the autocommit mode is on, every query is automaticaly + commited by the server, as if <function>ingres_commit</function> + was called after every call to <function>ingres_query</function>. </para> <para> See also <function>ingres_query</function>, - <function>ingres_rollback</function> and + <function>ingres_rollback</function>, and <function>ingres_commit</function>. </para> </refsect1> Index: phpdoc/de/functions/ingres_ii.xml diff -u phpdoc/de/functions/ingres_ii.xml:1.3 phpdoc/de/functions/ingres_ii.xml:1.4 --- phpdoc/de/functions/ingres_ii.xml:1.3 Mon Sep 3 00:03:46 2001 +++ phpdoc/de/functions/ingres_ii.xml Mon Sep 3 21:26:14 2001 @@ -1,5 +1,5 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <reference id="ref.ingres"> <title>Ingres II Funktionen</title> <titleabbrev>Ingres II</titleabbrev> @@ -13,20 +13,20 @@ Damit Ihnen diese Funktionen zur Verfügung stehen, müssen Sie php mit der Ingres-Unterstützung kompilieren, indem Sie die Option <option role="configure">--with-ingres</option> angeben. Ausserdem - brauchen Sie die Open API Bibliothek sowie header Dateien, die in - Ingres II eingebunden werden. Falls die II_SYSTEM Umgebungsvariable - nicht korrekt gesetzt ist, müssen Sie vielleicht + brauchen Sie die Open API Bibliothek sowie header Dateien, die in + Ingres II eingebunden werden. Falls die II_SYSTEM + Umgebungsvariable nicht korrekt gesetzt ist, müssen Sie vielleicht <option role="configure">--with-ingres=DIR</option> benutzen, um Ihr Inges Installationsverzeichnis anzugeben. </simpara> <simpara> Wenn Sie diese Erweiterung mit Apache benutzen, und Ihr Apache - fährt nicht hoch, sondern bringt die Fehlermeldung: "PHP Fatal error: - Unable to start ingres_ii module in Unknown on line 0", dann - vergewissern Sie sich, dass die Umgebungsvariable II_SYSTEM korrekt - gesetzt ist. Wenn Sie im Startskript für den Apache "export - II_SYSTEM="/home/ingres/II" angeben, gerade bevor httpd gestartet - wird, sollte dieses Problem gelöst sein. + fährt nicht hoch, sondern bringt die Fehlermeldung: "PHP Fatal + error: Unable to start ingres_ii module in Unknown on line 0", + dann vergewissern Sie sich, dass die Umgebungsvariable II_SYSTEM + korrekt gesetzt ist. Wenn Sie im Startskript für den Apache + "export II_SYSTEM="/home/ingres/II" angeben, gerade bevor httpd + gestartet wird, sollte dieses Problem gelöst sein. </simpara> <note> <para> @@ -47,7 +47,9 @@ <refentry id="function.ingres-connect"> <refnamediv> <refname>ingres_connect</refname> - <refpurpose>Eine Verbindung zu einem Ingres II Datenbankserver öffnen.</refpurpose> + <refpurpose> + Eine Verbindung zu einem Ingres II Datenbankserver öffnen + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -55,7 +57,7 @@ <funcprototype> <funcdef>resource <function>ingres_connect</function></funcdef> <paramdef>string - <parameter><optional>database</optional></parameter> + <parameter><optional>database</optional></parameter> </paramdef> <paramdef>string <parameter><optional>username</optional></parameter> @@ -65,7 +67,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Gibt bei Erfolg eine Ingres II Verbindungskennung zurück, oder &false;, wenn ein Fehler auftritt. @@ -107,8 +109,10 @@ </programlisting> </example> <example> - <title><function>ingres_connect</function> Beispiel mit - der aktuellen Verbindungskennung</title> + <title> + <function>ingres_connect</function> Beispiel mit der aktuellen + Verbindungskennung + </title> <programlisting> <?php ingres_connect ("mydb", "user", "pass") @@ -119,7 +123,7 @@ </programlisting> </example> <para> Siehe auch - <function>ingres_pconnect</function>, und + <function>ingres_pconnect</function> und <function>ingres_close</function>. </para> </refsect1> @@ -129,7 +133,8 @@ <refnamediv> <refname>ingres_pconnect</refname> <refpurpose> - Öffnet eine persistente Verbindung zu einem Ingres II Datenbankserver. + Öffnet eine persistente Verbindung zu einem Ingres II + Datenbankserver </refpurpose> </refnamediv> <refsect1> @@ -148,31 +153,31 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Gibt bei Erfolg eine Ingres II Verbindungskennung zurück oder oder &false;, wenn ein Fehler aufgetreten ist. </para> <para> Zu den Details über die Parameter siehe - <function>ingres_connect</function> und die Beispiele . Es gibt + <function>ingres_connect</function> und die Beispiele. Es gibt nur zwei Unterschiede zwischen den Funktionen <function>ingres_pconnect</function> und - <function>ingres_connect</function> : - Zum ersten: beim Verbindungsaufbau schaut die Funktion zuerst, - ob schon eine geöffnete persistente Verbindung besteht, die mit - denselben Parametern geöffnet wurde. Falls eine gefunden wird, - wird ein Identifizierer zurückgegeben, anstatt eine neue Verbindung - zu öffnen. - Zum zweiten: Die Verbindung zum Ingres Server wird nicht geschlossen - wenn die Ausführung des Skripts beendet ist, sondern die Verbindung - bleibt zum weiteren Gebrauch offen - (<function>ingres_close</function> schliesst die Verbindungen, die - mit <function>ingres_pconnect</function> geöffnet wurden nicht). - Darum wird diese Art der Verbindung 'persistent' genannt. + <function>ingres_connect</function>: Zum ersten: beim + Verbindungsaufbau schaut die Funktion zuerst, ob schon eine + geöffnete persistente Verbindung besteht, die mit denselben + Parametern geöffnet wurde. Falls eine gefunden wird, wird ein + Identifizierer zurückgegeben, anstatt eine neue Verbindung zu + öffnen. Zum zweiten: Die Verbindung zum Ingres Server wird nicht + geschlossen wenn die Ausführung des Skripts beendet ist, sondern + die Verbindung bleibt zum weiteren Gebrauch offen + (<function>ingres_close</function> schliesst die Verbindungen, + die mit <function>ingres_pconnect</function> geöffnet wurden + nicht). Darum wird diese Art der Verbindung 'persistent' + genannt. </para> <para> Siehe auch - <function>ingres_connect</function>, und + <function>ingres_connect</function> und <function>ingres_close</function>. </para> </refsect1> @@ -180,8 +185,10 @@ <refentry id="function.ingres-close"> <refnamediv> - <refname>ingres_close</refname> - <refpurpose>Schliesst eine Ingres II Datenbankverbindung</refpurpose> + <refname>ingres_close</refname> + <refpurpose> + Schliesst eine Ingres II Datenbankverbindung + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -193,16 +200,16 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Gibt bei Erfolg &true; zurück, bei einem Fehler &false;. </para> <para> <function>ingres_close</function> schliesst die Verbindung zu dem - Ingres Datenbankserver, der mit der übergebenen Verbindunkskennung - verknüpft ist. Falls der Parameter <parameter>link</parameter> - nicht angegeben wurde, wird die zuletzt geöffnete Verbindung - geschlossen. + Ingres Datenbankserver, der mit der übergebenen + Verbindunkskennung verknüpft ist. Falls der Parameter + <parameter>link</parameter> nicht angegeben wurde, wird die + zuletzt geöffnete Verbindung geschlossen. </para> <para> <function>ingres_close</function> ist normalerweise nicht nötig, @@ -211,7 +218,7 @@ geschlossen werden. </para> <para> Siehe auch - <function>ingres_connect</function>, und + <function>ingres_connect</function> und <function>ingres_pconnect</function>. </para> </refsect1> @@ -220,7 +227,9 @@ <refentry id="function.ingres-query"> <refnamediv> <refname>ingres_query</refname> - <refpurpose>Sendet eine SQL Abfrage an den Ingres II Server</refpurpose> + <refpurpose> + Sendet eine SQL Abfrage an den Ingres II Server + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -235,7 +244,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Gibt bei Erfolg &true; zurück und bei einem Fehler &false;. </para> @@ -255,42 +264,60 @@ zrückzusetzen. Wenn das Skript beendet wird, wird jede offene Transaktion zurückgesetzt (indem die Funktion <function>ingres_rollback</function> aufgerufen wird). Sie können - auch die Funktion <function>ingres_autocommit</function> benutzen, - bevor Sie eine neue Transaktion öffnen, damit werden alle einzelnen - SQL-Abfrage sofort gesendet. + auch die Funktion <function>ingres_autocommit</function> + benutzen, bevor Sie eine neue Transaktion öffnen, damit werden + alle einzelnen SQL-Abfrage sofort gesendet. </para> <para> Einige SQL Abfragen können mit dieser Funktion nicht gesendet werden: <itemizedlist> <listitem> - <simpara>close (siehe <function>ingres_close</function>).</simpara> + <simpara> + close (siehe <function>ingres_close</function>) + </simpara> + </listitem> + <listitem> + <simpara> + commit (siehe <function>ingres_commit</function>) + </simpara> + </listitem> + <listitem> + <simpara> + connect (siehe <function>ingres_connect</function>) + </simpara> </listitem> - <listitem> - <simpara>commit (siehe <function>ingres_commit</function>).</simpara> + <listitem> + <simpara> + disconnect (siehe <function>ingres_close</function>) + </simpara> </listitem> <listitem> - <simpara>connect (siehe <function>ingres_connect</function>).</simpara> + <simpara> + get dbevent</simpara> </listitem> <listitem> - <simpara>disconnect (siehe <function>ingres_close</function>).</simpara> + <simpara> + prepare to commit</simpara> </listitem> - <listitem><simpara>get dbevent</simpara></listitem> - <listitem><simpara>prepare to commit</simpara></listitem> <listitem> <simpara> - rollback (siehe <function>ingres_rollback</function>). + rollback (siehe <function>ingres_rollback</function>) </simpara> </listitem> - <listitem><simpara>savepoint</simpara></listitem> + <listitem> + <simpara>savepoint</simpara> + </listitem> <listitem> <simpara> - set autocommit (siehe <function>ingres_autocommit</function>). + set autocommit (siehe <function>ingres_autocommit</function>) </simpara> </listitem> <listitem> - <simpara>und alle Abfragen, die Cursors benutzen, werden - nicht unterstützt.</simpara> + <simpara> + und alle Abfragen, die Cursors benutzen, werden nicht + unterstützt + </simpara> </listitem> </itemizedlist> </para> @@ -327,7 +354,7 @@ <refname>ingres_num_rows</refname> <refpurpose> Gibt die Anzahl der Datensätze der Ergebnismenge zurück oder die - Anzahl der von der letzten Abfrage betroffenen Datensätze. + Anzahl der von der letzten Abfrage betroffenen Datensätze </refpurpose> </refnamediv> <refsect1> @@ -340,13 +367,13 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Bei delete-, insert- or update-queries, gibt - <function>ingres_num_rows</function> die Anzahl der durch diese + <function>ingres_num_rows</function> die Anzahl der durch diese Abfragen betroffenen Datensätze zurück. Bei den anderen Abfragen - gibt <function>ingres_num_rows</function> die Anzahl der Datensätze - in der Ergebnismenge zurück. + gibt <function>ingres_num_rows</function> die Anzahl der + Datensätze in der Ergebnismenge zurück. </para> <para> <note> @@ -395,11 +422,12 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_num_fields</function> liefert die Anzahl der Felder - in der Ergebnismenge zurück, die vom Ingres Server nach einem Aufruf - von <function>ingres_query</function> zurückgegeben wurde. + <function>ingres_num_fields</function> liefert die Anzahl der + Felder in der Ergebnismenge zurück, die vom Ingres Server nach + einem Aufruf von <function>ingres_query</function> zurückgegeben + wurde. </para> <para> See also @@ -414,31 +442,32 @@ <refentry id="function.ingres-field-name"> <refnamediv> <refname>ingres_field_name</refname> - <refpurpose>Holt den Namen eines Feldes in einer Ergebnismenge. </refpurpose> + <refpurpose> + Holt den Namen eines Feldes in einer Ergebnismenge + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>string <function>ingres_field_name</function></funcdef> - <paramdef>int - <parameter>index</parameter> - </paramdef> + <paramdef>int <parameter>index</parameter></paramdef> <paramdef>resource <parameter><optional>link</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_name</function> gibt den Namen eines Feldes - in einer Ergebnismenge zurück oder &false;, falls ein Fehler - aufgetreten ist. + <function>ingres_field_name</function> gibt den Namen eines + Feldes in einer Ergebnismenge zurück oder &false;, falls ein + Fehler aufgetreten ist. </para> <para> - <parameter>index</parameter> gibt die Nummer des Feldes an und muss - zwischen 1 und dem Wert, der von - <function>ingres_num_fields</function> zurückgegeben wird, liegen. + <parameter>index</parameter> gibt die Nummer des Feldes an und + muss zwischen 1 und dem Wert, der von + <function>ingres_num_fields</function> zurückgegeben wird, + liegen. </para> <para> Siehe auch @@ -453,7 +482,9 @@ <refentry id="function.ingres-field-type"> <refnamediv> <refname>ingres_field_type</refname> - <refpurpose>Gibt den Typ eines Feldes in einer Ergebnismenge zurück.</refpurpose> + <refpurpose> + Gibt den Typ eines Feldes in einer Ergebnismenge zurück + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -468,18 +499,19 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_type</function> gibt den Typ eines Feldes in - einer Ergebnismenge zurück oder &false;, wenn ein Fehler aufgetreten - ist. Beispiele von Rückgabewerten sind: "IIAPI_BYTE_TYPE", - "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", "IIAPI_FLT_TYPE", - "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE". Einige dieser Typen können, in - Abhängigkeit von der Feldlänge, mehrere SQL Typen umfassen. - (siehe <function>ingres_field_length</function>). Beispielsweise kann + <function>ingres_field_type</function> gibt den Typ eines Feldes + in einer Ergebnismenge zurück oder &false;, wenn ein Fehler + aufgetreten ist. Beispiele von Rückgabewerten sind: + "IIAPI_BYTE_TYPE", "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", + "IIAPI_FLT_TYPE", "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE". Einige + dieser Typen können, in Abhängigkeit von der Feldlänge, mehrere + SQL Typen umfassen. (siehe + <function>ingres_field_length</function>). Beispielsweise kann "IIAPI_FLT_TYPE" entweder float4 oder float8 sein. Genauere - Informationen darüber finden Sie in dem Ingres/OpenAPI User Guide - - Appendix C. + Informationen darüber finden Sie in dem Ingres/OpenAPI User Guide + - Appendix C. </para> <para> <parameter>index</parameter> ist die Feldnummer und muss zwischen 1 @@ -499,30 +531,33 @@ <refentry id="function.ingres-field-nullable"> <refnamediv> <refname>ingres_field_nullable</refname> - <refpurpose>Prüft, ob für ein Feld NULL-Werte zugelassen sind.</refpurpose> + <refpurpose> + Prüft, ob für ein Feld NULL-Werte zugelassen sind + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>ingres_field_nullable</function></funcdef> - <paramdef>int - <parameter>index</parameter> + <funcdef>bool + <function>ingres_field_nullable</function> + </funcdef> + <paramdef>int <parameter>index</parameter> </paramdef> <paramdef>resource <parameter><optional>link</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_nullable</function> gibt &true; zurück, falls - in dieser Spalte &null;-Werte zugelasssen sind und &false;, falls - das nicht erlaubt ist. + <function>ingres_field_nullable</function> gibt &true; zurück, + falls in dieser Spalte &null;-Werte zugelasssen sind und &false;, + falls das nicht erlaubt ist. </para> <para> - <parameter>index</parameter> ist die Feldnummer und muss zwischen 1 - und dem Wert liegen, den die Funktion + <parameter>index</parameter> ist die Feldnummer und muss zwischen + 1 und dem Wert liegen, den die Funktion <function>ingres_num_fields</function> zurückgibt. </para> <para> @@ -538,7 +573,7 @@ <refentry id="function.ingres-field-length"> <refnamediv> <refname>ingres_field_length</refname> - <refpurpose>Gibt die Länge eines Feldes zurück.</refpurpose> + <refpurpose>Gibt die Länge eines Feldes zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -555,14 +590,14 @@ </funcsynopsis> &warn.experimental.func; <para> - <function>ingres_field_length</function> gibt die Länge eines Feldes - zurück. Das ist die Anzahl der Bytes, die der Server zum Speichern - des Feldes belegt. Für genauere Informationen schauen sie in den - Ingres/OpenAPI User Guide - Appendix C. + <function>ingres_field_length</function> gibt die Länge eines + Feldes zurück. Das ist die Anzahl der Bytes, die der Server zum + Speichern des Feldes belegt. Für genauere Informationen schauen + sie in den Ingres/OpenAPI User Guide - Appendix C. </para> <para> - <parameter>index</parameter> ist die Feldnummer und muss zwischen 1 - und dem Wert liegen, den die Funktion + <parameter>index</parameter> ist die Feldnummer und muss zwischen + 1 und dem Wert liegen, den die Funktion <function>ingres_num_fields</function> zurückgibt. </para> <para> @@ -578,7 +613,7 @@ <refentry id="function.ingres-field-precision"> <refnamediv> <refname>ingres_field_precision</refname> - <refpurpose>Gibt die Genauigkeit eines Feldes zurück.</refpurpose> + <refpurpose>Gibt die Genauigkeit eines Feldes zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -593,7 +628,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_field_precision</function> gibt die Genauigkeit eines Feldes zurück. Dieser Rückgabewert wird nur für @@ -602,8 +637,8 @@ Ingres/OpenAPI User Guide - Appendix C an. </para> <para> - <parameter>index</parameter> ist die Feldnummer und muss zwischen 1 - und dem Wert liegen, den die Funktion + <parameter>index</parameter> ist die Feldnummer und muss zwischen + 1 und dem Wert liegen, den die Funktion <function>ingres_num_fields</function> zurückgibt. </para> <para> @@ -619,32 +654,30 @@ <refentry id="function.ingres-field-scale"> <refnamediv> <refname>ingres_field_scale</refname> - <refpurpose>Gibt den Skalar eines Feldes zurück.</refpurpose> + <refpurpose>Gibt den Skalar eines Feldes zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ingres_field_scale</function></funcdef> - <paramdef>int - <parameter>index</parameter> - </paramdef> + <paramdef>int <parameter>index</parameter></paramdef> <paramdef>resource <parameter><optional>link</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_scale</function> gibt den Skalar eines Feldes - zurück.Dieser Rückgabewert wird nur für Dezimalzahlen, + <function>ingres_field_scale</function> gibt den Skalar eines + Feldes zurück.Dieser Rückgabewert wird nur für Dezimalzahlen, Fliesskommazahlen und monetäre SQL Datentypen benutzt. Für nähere Informationen schauen Sie sich den Ingres/OpenAPI User Guide - Appendix C an. </para> <para> - <parameter>index</parameter> ist die Feldnummer und muss zwischen 1 - und dem Wert liegen, den die Funktion + <parameter>index</parameter> ist die Feldnummer und muss zwischen + 1 und dem Wert liegen, den die Funktion <function>ingres_num_fields</function> zurückgibt. </para> <para> @@ -660,7 +693,9 @@ <refentry id="function.ingres-fetch-array"> <refnamediv> <refname>ingres_fetch_array</refname> - <refpurpose>Liest eine Zeile der Ergebnismenge in ein Array ein.</refpurpose> + <refpurpose> + Liest eine Zeile der Ergebnismenge in ein Array ein + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -675,7 +710,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_fetch_array</function> Gibt ein Array zurück, das die die entsprechende Zeile der Ergebnismenge enthält oder &false; @@ -687,11 +722,13 @@ der Daten unter numerischen Indizes werden die Daten auch unter assoziativen Indizes im Ergebnisarray gespeichert, in dem die Feldnamen als Schlüssel benutzt werden. + </para> <para> Falls eine oder mehrere Spalten der Ergebnismenge dieselben - Feldnamen haben, bekommt die letzte Spalte die Priorität. Um auf die - anderen Spalten zuzugreifen, müssen sie entweder den numerischen - Index der Spalte benutzen oder Aliase für die Spalten machen. + Feldnamen haben, bekommt die letzte Spalte die Priorität. Um auf + die anderen Spalten zuzugreifen, müssen sie entweder den + numerischen Index der Spalte benutzen oder Aliase für die Spalten + machen. <informalexample> <programlisting> ingres_query(select t1.f1 as foo t2.f1 as bar from t1, t2); @@ -744,7 +781,9 @@ <refentry id="function.ingres-fetch-row"> <refnamediv> <refname>ingres_fetch_row</refname> - <refpurpose>Holt eine Zeile aus einer Ergebnismenge in ein numerisches Array.</refpurpose> + <refpurpose> + Holt eine Zeile aus einer Ergebnismenge in ein numerisches Array + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -756,7 +795,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_fetch_row</function> gibt ein Array zurück, das die entsprechende Zeile der Ergebnismenge enthält oder &false;, @@ -765,9 +804,9 @@ </para> <para> Aufeinanderfolgende Aufrufe von - <function>ingres_fetch_row</function> würden immer die nächste Zeile - der Ergebnismenge zurückgeben oder &false;, wenn es keine Zeilen - mehr gibt. + <function>ingres_fetch_row</function> würden immer die nächste + Zeile der Ergebnismenge zurückgeben oder &false;, wenn es keine + Zeilen mehr gibt. </para> <para> <example> @@ -798,13 +837,15 @@ <refentry id="function.ingres-fetch-object"> <refnamediv> <refname>ingres_fetch_object</refname> - <refpurpose>Holt eine Zeile als Objekt.</refpurpose> + <refpurpose>Holt eine Zeile als Objekt</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>object <function>ingres_fetch_object</function></funcdef> + <funcdef>object + <function>ingres_fetch_object</function> + </funcdef> <paramdef>int <parameter><optional>result_type</optional></parameter> </paramdef> @@ -816,21 +857,21 @@ &warn.experimental.func; <para> <function>ingres_fetch_object</function> Gibt ein Objekt zurück, - das mit der geholten Zeile einer Ergebnismenge korrespondiert oder - &false;, wenn es keine Zeilen mehr in der Egebnismenge gibt. + das mit der geholten Zeile einer Ergebnismenge korrespondiert + oder &false;, wenn es keine Zeilen mehr in der Egebnismenge gibt. </para> <para> Diese Funktion ist ähnlich zu <function>ingres_fetch_array</function>, mit einem Unterschied - ein Objekt wird anstelle eines Arrays zurückgegeben. Indirekt heisst das, dass Sie die Daten nur über ihre Feldnamen ansprechen - können und nicht über ihre Offsets (Zahlen sind unzulässige - Namen für Objekteigenschaften). + können und nicht über ihre Offsets (Zahlen sind unzulässige Namen + für Objekteigenschaften). </para> <para> - Das optionale Argument <parameter>result_type</parameter> ist eine - Konstante, die die folgenden Werte annehmen kann: INGRES_ASSOC, - INGRES_NUM und INGRES_BOTH. + Das optionale Argument <parameter>result_type</parameter> ist + eine Konstante, die die folgenden Werte annehmen kann: + INGRES_ASSOC, INGRES_NUM und INGRES_BOTH. </para> <para> Diese Funktion ist von der Geschwindigkeit her identisch zu @@ -867,7 +908,7 @@ <refentry id="function.ingres-rollback"> <refnamediv> <refname>ingres_rollback</refname> - <refpurpose>Setzt eine Transaktion zurück.</refpurpose> + <refpurpose>Setzt eine Transaktion zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -879,16 +920,17 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_rollback</function> setzt die aktuell geöffnete - Transaktion zurück und macht alle Änderungen, die in der Transaktion - bereits durchgeführt wurden, wieder rückgängig. + Transaktion zurück und macht alle Änderungen, die in der + Transaktion bereits durchgeführt wurden, wieder rückgängig. </para> <para> - Diese Funktion schliesst die Transaktion. Eine Neue Transaktion kann - geöffnet werden, wenn man mit <function>ingres_query</function> eine - neue Abfrage an den Datenbankserver schickt. + Diese Funktion schliesst die Transaktion. Eine Neue Transaktion + kann geöffnet werden, wenn man mit + <function>ingres_query</function> eine neue Abfrage an den + Datenbankserver schickt. </para> <para> Siehe auch @@ -902,7 +944,7 @@ <refentry id="function.ingres-commit"> <refnamediv> <refname>ingres_commit</refname> - <refpurpose>Schliesst eine Transaktion ab.</refpurpose> + <refpurpose>Schliesst eine Transaktion ab</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -914,7 +956,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_commit</function> schliesst die aktuell offene Transaktion ab, indem alle Veränderungen in die Datenbank @@ -942,8 +984,10 @@ <refentry id="function.ingres-autocommit"> <refnamediv> - <refname>ingres_autocommit</refname> - <refpurpose>Schaltet den autocommit-Modus an oder aus.</refpurpose> + <refname>ingres_autocommit</refname> + <refpurpose> + Schaltet den autocommit-Modus an oder aus + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -955,15 +999,15 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_autocommit</function> wird vor dem Öffnen einer Transaktion aufgerufen (vor dem ersten Aufruf der Funktion <function>ingres_query</function> oder gleich nach einem Aufruf von <function>ingres_rollback</function> oder <function>ingres_autocommit</function>) um in den "autocommit" - Modus des Servers ein- oder auszuschalten (beim Beginn eines Skripts - ist der autocommit-Modus ausgeschaltet). + Modus des Servers ein- oder auszuschalten (beim Beginn eines + Skripts ist der autocommit-Modus ausgeschaltet). </para> <para> Wenn der autocommit-Modus eingeschaltet ist, wird jede Abfrage
Index: phpdoc/de/Translators diff -u phpdoc/de/Translators:1.193 phpdoc/de/Translators:1.194 --- phpdoc/de/Translators:1.193 Mon Sep 3 00:06:20 2001 +++ phpdoc/de/Translators Mon Sep 3 21:26:13 2001 @@ -93,7 +93,7 @@ image.xml Thomas Schuermann fertig (bis V. 1.26) imap.xml Hartmut Holzgraefe Änderungen info.xml Mark Kronsbein fertig -ingress_ii.xml Cornelia Boenigk fertig +ingres_ii.xml Cornelia Boenigk fertig (bis V. 1.10) ircg.xml Georg Richter fertig (bis V. 1.9) java.xml Sebastian Bergmann fertig ldap.xml Friedhelm Betz fertig (bis V. 1.29) Index: phpdoc/en/functions/ingres_ii.xml diff -u phpdoc/en/functions/ingres_ii.xml:1.9 phpdoc/en/functions/ingres_ii.xml:1.10 --- phpdoc/en/functions/ingres_ii.xml:1.9 Mon Sep 3 00:01:53 2001 +++ phpdoc/en/functions/ingres_ii.xml Mon Sep 3 21:26:13 2001 @@ -1,5 +1,5 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <reference id="ref.ingres"> <title>Ingres II functions</title> <titleabbrev>Ingres II</titleabbrev> @@ -20,29 +20,32 @@ </simpara> <simpara> When using this extension with Apache, if Apache does not start - and complains with "PHP Fatal error: Unable to start - ingres_ii module in Unknown on line 0" - then make sure the environement variable II_SYSTEM is correctly - set. Adding "export II_SYSTEM="/home/ingres/II" in the script - that starts Apache, just before launching httpd, should be fine. + and complains with "PHP Fatal error: Unable to start ingres_ii + module in Unknown on line 0" then make sure the environement + variable II_SYSTEM is correctly set. Adding "export + II_SYSTEM="/home/ingres/II" in the script that starts Apache, just + before launching httpd, should be fine. </simpara> <note> <para> - If you already used PHP extensions to access other database servers, - note that Ingres doesn't allow concurrent queries and/or transaction - over one connection, thus you won't find any result or transaction - handle in this extension. The result of a query must be treated - before sending another query, and a transaction must be commited or - rolled back before opening another transaction (which is automaticaly - done when sending the first query). + If you already used PHP extensions to access other database + servers, note that Ingres doesn't allow concurrent queries and/or + transaction over one connection, thus you won't find any result + or transaction handle in this extension. The result of a query + must be treated before sending another query, and a transaction + must be commited or rolled back before opening another + transaction (which is automaticaly done when sending the first + query). </para> </note> </partintro> <refentry id="function.ingres-connect"> <refnamediv> - <refname>ingres_connect</refname> - <refpurpose>Open a connection to an Ingres II database.</refpurpose> + <refname>ingres_connect</refname> + <refpurpose> + Open a connection to an Ingres II database + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -60,20 +63,22 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - Returns a Ingres II link resource on success, or &false; on failure. + Returns a Ingres II link resource on success, or &false; on + failure. </para> <para> <function>ingres_connect</function> opens a connection with the - Ingres database designated by <parameter>database</parameter>, which - follows the syntax <parameter>[node_id::]dbname[/svr_class]</parameter>. + Ingres database designated by <parameter>database</parameter>, + which follows the syntax + <parameter>[node_id::]dbname[/svr_class]</parameter>. </para> <para> If some parameters are missing, <function>ingres_connect</function> uses the values in <filename>php.ini</filename> for <parameter>ingres.default_database</parameter>, - <parameter>ingres.default_user</parameter> and + <parameter>ingres.default_user</parameter>, and <parameter>ingres.default_password</parameter>. </para> <para> @@ -97,8 +102,9 @@ </programlisting> </example> <example> - <title><function>ingres_connect</function> example - using default link</title> + <title> + <function>ingres_connect</function> example using default link + </title> <programlisting> <?php ingres_connect ("mydb", "user", "pass") @@ -109,7 +115,7 @@ </programlisting> </example> <para> See also - <function>ingres_pconnect</function>, and + <function>ingres_pconnect</function> and <function>ingres_close</function>. </para> </refsect1> @@ -119,7 +125,7 @@ <refnamediv> <refname>ingres_pconnect</refname> <refpurpose> - Open a persistent connection to an Ingres II database. + Open a persistent connection to an Ingres II database </refpurpose> </refnamediv> <refsect1> @@ -138,27 +144,28 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - Returns a Ingres II link resource on success, or &false; on failure. + Returns a Ingres II link resource on success, or &false; on + failure. </para> <para> - See <function>ingres_connect</function> for parameters details and - examples. There are only 2 differences between + See <function>ingres_connect</function> for parameters details + and examples. There are only 2 differences between <function>ingres_pconnect</function> and - <function>ingres_connect</function> : - First, when connecting, the function will first try to find a - (persistent) link that's already opened with the same parameters. - If one is found, an identifier for it will be returned instead of - opening a new connection. Second, the connection to the Ingres - server will not be closed when the execution of the script ends. - Instead, the link will remain open for future use - (<function>ingres_close</function> will not close links established - by <function>ingres_pconnect</function>). This type of link is - therefore called 'persistent'. + <function>ingres_connect</function> : First, when connecting, the + function will first try to find a (persistent) link that's + already opened with the same parameters. If one is found, an + identifier for it will be returned instead of opening a new + connection. Second, the connection to the Ingres server will not + be closed when the execution of the script ends. Instead, the + link will remain open for future use + (<function>ingres_close</function> will not close links + established by <function>ingres_pconnect</function>). This type + of link is therefore called 'persistent'. </para> <para> See also - <function>ingres_connect</function>, and + <function>ingres_connect</function> and <function>ingres_close</function>. </para> </refsect1> @@ -179,7 +186,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Returns &true; on success, or &false; on failure. </para> @@ -195,7 +202,7 @@ are automatically closed at the end of the script. </para> <para> See also - <function>ingres_connect</function>, and + <function>ingres_connect</function> and <function>ingres_pconnect</function>. </para> </refsect1> @@ -219,7 +226,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Returns &true; on success, or &false; on failure. </para> @@ -229,42 +236,55 @@ must be a valid SQL query (see the Ingres SQL reference guide) </para> <para> - The query becomes part of the currently open transaction. - If there is no open transaction, <function>ingres_query</function> + The query becomes part of the currently open transaction. If + there is no open transaction, <function>ingres_query</function> opens a new transaction. To close the transaction, you can either - call <function>ingres_commit</function> to commit the changes made - to the database or <function>ingres_rollback</function> to cancel these - changes. When the script ends, any open transaction is rolled back - (by calling <function>ingres_rollback</function>). You can also - use <function>ingres_autocommit</function> before opening a new + call <function>ingres_commit</function> to commit the changes + made to the database or <function>ingres_rollback</function> to + cancel these changes. When the script ends, any open transaction + is rolled back (by calling + <function>ingres_rollback</function>). You can also use + <function>ingres_autocommit</function> before opening a new transaction to have every SQL query immediatly commited. </para> <para> - Some types of SQL queries can't be sent with this function : + Some types of SQL queries can't be sent with this function: <itemizedlist> <listitem> - <simpara>close (see <function>ingres_close</function>).</simpara> + <simpara> + close (see <function>ingres_close</function>) + </simpara> </listitem> <listitem> - <simpara>commit (see <function>ingres_commit</function>).</simpara> + <simpara> + commit (see <function>ingres_commit</function>) + </simpara> </listitem> <listitem> - <simpara>connect (see <function>ingres_connect</function>).</simpara> + <simpara> + connect (see <function>ingres_connect</function>) + </simpara> </listitem> <listitem> - <simpara>disconnect (see <function>ingres_close</function>).</simpara> + <simpara> + disconnect (see <function>ingres_close</function>) + </simpara> + </listitem> + <listitem> + <simpara>get dbevent</simpara> + </listitem> + <listitem> + <simpara>prepare to commit</simpara> </listitem> - <listitem><simpara>get dbevent</simpara></listitem> - <listitem><simpara>prepare to commit</simpara></listitem> <listitem> <simpara> - rollback (see <function>ingres_rollback</function>). + rollback (see <function>ingres_rollback</function>) </simpara> </listitem> <listitem><simpara>savepoint</simpara></listitem> <listitem> <simpara> - set autocommit (see <function>ingres_autocommit</function>). + set autocommit (see <function>ingres_autocommit</function>) </simpara> </listitem> <listitem> @@ -294,7 +314,7 @@ <function>ingres_fetch_object</function>, <function>ingres_fetch_row</function>, <function>ingres_commit</function>, - <function>ingres_rollback</function> and + <function>ingres_rollback</function>, and <function>ingres_autocommit</function>. </para> </refsect1> @@ -317,7 +337,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> For delete, insert or update queries, <function>ingres_num_rows</function> returns the number of rows @@ -329,17 +349,16 @@ <note> <simpara> This function is mainly meant to get the number of rows - modified in the database. - If this function is called before using - <function>ingres_fetch_array</function>, + modified in the database. If this function is called before + using <function>ingres_fetch_array</function>, <function>ingres_fetch_object</function> or <function>ingres_fetch_row</function> the server will delete the result's data and the script won't be able to get them. </simpara> <simpara> - You should instead retrieve the result's data using one of these - fetch functions in a loop until it returns &false;, indicating that - no more results are available. + You should instead retrieve the result's data using one of + these fetch functions in a loop until it returns &false;, + indicating that no more results are available. </simpara> </note> </para> @@ -347,7 +366,7 @@ See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -370,17 +389,17 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_num_fields</function> returns the number of fields - in the results returned by the Ingres server after a call to - <function>ingres_query</function> + <function>ingres_num_fields</function> returns the number of + fields in the results returned by the Ingres server after a call + to <function>ingres_query</function> </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -404,7 +423,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_field_name</function> returns the name of a field in a query result, or &false; on failure. @@ -426,8 +445,10 @@ <refentry id="function.ingres-field-type"> <refnamediv> - <refname>ingres_field_type</refname> - <refpurpose>Get the type of a field in a query result.</refpurpose> + <refname>ingres_field_type</refname> + <refpurpose> + Get the type of a field in a query result + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -442,28 +463,28 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_type</function> returns the type of a field - in a query result, or &false; on failure. - Examples of types returned are "IIAPI_BYTE_TYPE", - "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", "IIAPI_FLT_TYPE", - "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE". Some of these types can map - to more than one SQL type depending on the length of the field - (see <function>ingres_field_length</function>). For example + <function>ingres_field_type</function> returns the type of a + field in a query result, or &false; on failure. Examples of + types returned are "IIAPI_BYTE_TYPE", "IIAPI_CHA_TYPE", + "IIAPI_DTE_TYPE", "IIAPI_FLT_TYPE", "IIAPI_INT_TYPE", + "IIAPI_VCH_TYPE". Some of these types can map to more than one + SQL type depending on the length of the field (see + <function>ingres_field_length</function>). For example "IIAPI_FLT_TYPE" can be a float4 or a float8. For detailed information, see the Ingres/OpenAPI User Guide - Appendix C. </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by + <parameter>index</parameter> is the number of the field and must + be between 1 and the value given by <function>ingres_num_fields</function>. </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -472,7 +493,7 @@ <refentry id="function.ingres-field-nullable"> <refnamediv> <refname>ingres_field_nullable</refname> - <refpurpose>Test if a field is nullable.</refpurpose> + <refpurpose>Test if a field is nullable</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -487,21 +508,21 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_nullable</function> returns &true; if the field - can be set to the &null; value and &false; if it can't. + <function>ingres_field_nullable</function> returns &true; if the + field can be set to the &null; value and &false; if it can't. </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by + <parameter>index</parameter> is the number of the field and must + be between 1 and the value given by <function>ingres_num_fields</function>. </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -510,7 +531,7 @@ <refentry id="function.ingres-field-length"> <refnamediv> <refname>ingres_field_length</refname> - <refpurpose>Get the length of a field.</refpurpose> + <refpurpose>Get the length of a field</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -525,22 +546,23 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_length</function> returns the length of a field. - This is the number of bytes used by the server to store the field. - For detailed information, see the Ingres/OpenAPI User Guide - Appendix C. + <function>ingres_field_length</function> returns the length of a + field. This is the number of bytes used by the server to store + the field. For detailed information, see the Ingres/OpenAPI User + Guide - Appendix C. </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by + <parameter>index</parameter> is the number of the field and must + be between 1 and the value given by <function>ingres_num_fields</function>. </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -549,38 +571,39 @@ <refentry id="function.ingres-field-precision"> <refnamediv> <refname>ingres_field_precision</refname> - <refpurpose>Get the precision of a field.</refpurpose> + <refpurpose>Get the precision of a field</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>ingres_field_precision</function></funcdef> - <paramdef>int - <parameter>index</parameter> + <funcdef>int + <function>ingres_field_precision</function> + </funcdef> + <paramdef>int <parameter>index</parameter> </paramdef> <paramdef>resource <parameter><optional>link</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_precision</function> returns the precision of - a field. This value is used only for decimal, float and money SQL data - types. For detailed information, see the Ingres/OpenAPI User Guide - - Appendix C. + <function>ingres_field_precision</function> returns the precision + of a field. This value is used only for decimal, float and money + SQL data types. For detailed information, see the Ingres/OpenAPI + User Guide - Appendix C. </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by + <parameter>index</parameter> is the number of the field and must + be between 1 and the value given by <function>ingres_num_fields</function>. </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -589,7 +612,7 @@ <refentry id="function.ingres-field-scale"> <refnamediv> <refname>ingres_field_scale</refname> - <refpurpose>Get the scale of a field.</refpurpose> + <refpurpose>Get the scale of a field</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -606,20 +629,21 @@ </funcsynopsis> &warn.experimental.func; <para> - <function>ingres_field_scale</function> returns the scale of a field. - This value is used only for the decimal SQL data type. For detailed - information, see the Ingres/OpenAPI User Guide - Appendix C. + <function>ingres_field_scale</function> returns the scale of a + field. This value is used only for the decimal SQL data + type. For detailed information, see the Ingres/OpenAPI User Guide + - Appendix C. </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by + <parameter>index</parameter> is the number of the field and must + be between 1 and the value given by <function>ingres_num_fields</function>. </para> <para> See also <function>ingres_query</function>, <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -628,7 +652,7 @@ <refentry id="function.ingres-fetch-array"> <refnamediv> <refname>ingres_fetch_array</refname> - <refpurpose>Fetch a row of result into an array.</refpurpose> + <refpurpose>Fetch a row of result into an array</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -643,22 +667,24 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_fetch_array</function> Returns an array that corresponds - to the fetched row, or &false; if there are no more rows. + <function>ingres_fetch_array</function> Returns an array that + corresponds to the fetched row, or &false; if there are no more + rows. </para> <para> This function is an extended version of - <function>ingres_fetch_row</function>. In addition to storing the - data in the numeric indices of the result array, it also stores - the data in associative indices, using the field names as keys. + <function>ingres_fetch_row</function>. In addition to storing + the data in the numeric indices of the result array, it also + stores the data in associative indices, using the field names as + keys. </para> <para> If two or more columns of the result have the same field names, - the last column will take precedence. To access the other column(s) - of the same name, you must use the numeric index of the column or - make an alias for the column. + the last column will take precedence. To access the other + column(s) of the same name, you must use the numeric index of the + column or make an alias for the column. <informalexample> <programlisting> ingres_query(select t1.f1 as foo t2.f1 as bar from t1, t2); @@ -669,8 +695,9 @@ </informalexample> </para> <para> - <parameter>result_type</parameter> can be INGRES_NUM for enumerated array, - INGRES_ASSOC for associative array, or INGRES_BOTH (default). + <parameter>result_type</parameter> can be INGRES_NUM for + enumerated array, INGRES_ASSOC for associative array, or + INGRES_BOTH (default). </para> <para> Speed-wise, the function is identical to @@ -701,7 +728,7 @@ <function>ingres_query</function>, <function>ingres_num_fields</function>, <function>ingres_field_name</function>, - <function>ingres_fetch_object</function> and + <function>ingres_fetch_object</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -710,7 +737,9 @@ <refentry id="function.ingres-fetch-row"> <refnamediv> <refname>ingres_fetch_row</refname> - <refpurpose>Fetch a row of result into an enumerated array.</refpurpose> + <refpurpose> + Fetch a row of result into an enumerated array + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -722,11 +751,12 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_fetch_row</function> returns an array that corresponds - to the fetched row, or &false; if there are no more rows. Each result - column is stored in an array offset, starting at offset 1. + <function>ingres_fetch_row</function> returns an array that + corresponds to the fetched row, or &false; if there are no more + rows. Each result column is stored in an array offset, starting + at offset 1. </para> <para> Subsequent call to <function>ingres_fetch_row</function> would @@ -753,7 +783,7 @@ See also <function>ingres_num_fields</function>, <function>ingres_query</function>, - <function>ingres_fetch_array</function> and + <function>ingres_fetch_array</function>, and <function>ingres_fetch_object</function>. </para> </refsect1> @@ -768,7 +798,9 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>object <function>ingres_fetch_object</function></funcdef> + <funcdef>object + <function>ingres_fetch_object</function> + </funcdef> <paramdef>int <parameter><optional>result_type</optional></parameter> </paramdef> @@ -777,10 +809,11 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_fetch_object</function> Returns an object that - corresponds to the fetched row, or &false; if there are no more rows. + corresponds to the fetched row, or &false; if there are no more + rows. </para> <para> This function is similar to @@ -820,7 +853,7 @@ <function>ingres_query</function>, <function>ingres_num_fields</function>, <function>ingres_field_name</function>, - <function>ingres_fetch_array</function> and + <function>ingres_fetch_array</function>, and <function>ingres_fetch_row</function>. </para> </refsect1> @@ -829,7 +862,7 @@ <refentry id="function.ingres-rollback"> <refnamediv> <refname>ingres_rollback</refname> - <refpurpose>Roll back a transaction.</refpurpose> + <refpurpose>Roll back a transaction</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -841,11 +874,11 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_rollback</function> rolls back the currently open - transaction, actually canceling all changes made to the database - during the transaction. + <function>ingres_rollback</function> rolls back the currently + open transaction, actually canceling all changes made to the + database during the transaction. </para> <para> This closes the transaction. A new one can be open by sending a @@ -854,7 +887,7 @@ <para> See also <function>ingres_query</function>, - <function>ingres_commit</function> and + <function>ingres_commit</function>, and <function>ingres_autocommit</function>. </para> </refsect1> @@ -863,7 +896,7 @@ <refentry id="function.ingres-commit"> <refnamediv> <refname>ingres_commit</refname> - <refpurpose>Commit a transaction.</refpurpose> + <refpurpose>Commit a transaction</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -875,7 +908,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_commit</function> commits the currently open transaction, making all changes made to the database permanent. @@ -885,14 +918,14 @@ query with <function>ingres_query</function>. </para> <para> - You can also have the server commit automaticaly after every query - by calling <function>ingres_autocommit</function> before opening the - transaction. + You can also have the server commit automaticaly after every + query by calling <function>ingres_autocommit</function> before + opening the transaction. </para> <para> See also <function>ingres_query</function>, - <function>ingres_rollback</function> and + <function>ingres_rollback</function>, and <function>ingres_autocommit</function>. </para> </refsect1> @@ -901,7 +934,7 @@ <refentry id="function.ingres-autocommit"> <refnamediv> <refname>ingres_autocommit</refname> - <refpurpose>Switch autocommit on or off.</refpurpose> + <refpurpose>Switch autocommit on or off</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -913,24 +946,25 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_autocommit</function> is called before opening a - transaction (before the first call to <function>ingres_query</function> - or just after a call to <function>ingres_rollback</function> or - <function>ingres_autocommit</function>) to switch the "autocommit" mode - of the server on or off (when the script begins the autocommit mode is - off). + transaction (before the first call to + <function>ingres_query</function> or just after a call to + <function>ingres_rollback</function> or + <function>ingres_autocommit</function>) to switch the + "autocommit" mode of the server on or off (when the script begins + the autocommit mode is off). </para> <para> - When the autocommit mode is on, every query is automaticaly commited - by the server, as if <function>ingres_commit</function> was called - after every call to <function>ingres_query</function>. + When the autocommit mode is on, every query is automaticaly + commited by the server, as if <function>ingres_commit</function> + was called after every call to <function>ingres_query</function>. </para> <para> See also <function>ingres_query</function>, - <function>ingres_rollback</function> and + <function>ingres_rollback</function>, and <function>ingres_commit</function>. </para> </refsect1> Index: phpdoc/de/functions/ingres_ii.xml diff -u phpdoc/de/functions/ingres_ii.xml:1.3 phpdoc/de/functions/ingres_ii.xml:1.4 --- phpdoc/de/functions/ingres_ii.xml:1.3 Mon Sep 3 00:03:46 2001 +++ phpdoc/de/functions/ingres_ii.xml Mon Sep 3 21:26:14 2001 @@ -1,5 +1,5 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <reference id="ref.ingres"> <title>Ingres II Funktionen</title> <titleabbrev>Ingres II</titleabbrev> @@ -13,20 +13,20 @@ Damit Ihnen diese Funktionen zur Verfügung stehen, müssen Sie php mit der Ingres-Unterstützung kompilieren, indem Sie die Option <option role="configure">--with-ingres</option> angeben. Ausserdem - brauchen Sie die Open API Bibliothek sowie header Dateien, die in - Ingres II eingebunden werden. Falls die II_SYSTEM Umgebungsvariable - nicht korrekt gesetzt ist, müssen Sie vielleicht + brauchen Sie die Open API Bibliothek sowie header Dateien, die in + Ingres II eingebunden werden. Falls die II_SYSTEM + Umgebungsvariable nicht korrekt gesetzt ist, müssen Sie vielleicht <option role="configure">--with-ingres=DIR</option> benutzen, um Ihr Inges Installationsverzeichnis anzugeben. </simpara> <simpara> Wenn Sie diese Erweiterung mit Apache benutzen, und Ihr Apache - fährt nicht hoch, sondern bringt die Fehlermeldung: "PHP Fatal error: - Unable to start ingres_ii module in Unknown on line 0", dann - vergewissern Sie sich, dass die Umgebungsvariable II_SYSTEM korrekt - gesetzt ist. Wenn Sie im Startskript für den Apache "export - II_SYSTEM="/home/ingres/II" angeben, gerade bevor httpd gestartet - wird, sollte dieses Problem gelöst sein. + fährt nicht hoch, sondern bringt die Fehlermeldung: "PHP Fatal + error: Unable to start ingres_ii module in Unknown on line 0", + dann vergewissern Sie sich, dass die Umgebungsvariable II_SYSTEM + korrekt gesetzt ist. Wenn Sie im Startskript für den Apache + "export II_SYSTEM="/home/ingres/II" angeben, gerade bevor httpd + gestartet wird, sollte dieses Problem gelöst sein. </simpara> <note> <para> @@ -47,7 +47,9 @@ <refentry id="function.ingres-connect"> <refnamediv> <refname>ingres_connect</refname> - <refpurpose>Eine Verbindung zu einem Ingres II Datenbankserver öffnen.</refpurpose> + <refpurpose> + Eine Verbindung zu einem Ingres II Datenbankserver öffnen + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -55,7 +57,7 @@ <funcprototype> <funcdef>resource <function>ingres_connect</function></funcdef> <paramdef>string - <parameter><optional>database</optional></parameter> + <parameter><optional>database</optional></parameter> </paramdef> <paramdef>string <parameter><optional>username</optional></parameter> @@ -65,7 +67,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Gibt bei Erfolg eine Ingres II Verbindungskennung zurück, oder &false;, wenn ein Fehler auftritt. @@ -107,8 +109,10 @@ </programlisting> </example> <example> - <title><function>ingres_connect</function> Beispiel mit - der aktuellen Verbindungskennung</title> + <title> + <function>ingres_connect</function> Beispiel mit der aktuellen + Verbindungskennung + </title> <programlisting> <?php ingres_connect ("mydb", "user", "pass") @@ -119,7 +123,7 @@ </programlisting> </example> <para> Siehe auch - <function>ingres_pconnect</function>, und + <function>ingres_pconnect</function> und <function>ingres_close</function>. </para> </refsect1> @@ -129,7 +133,8 @@ <refnamediv> <refname>ingres_pconnect</refname> <refpurpose> - Öffnet eine persistente Verbindung zu einem Ingres II Datenbankserver. + Öffnet eine persistente Verbindung zu einem Ingres II + Datenbankserver </refpurpose> </refnamediv> <refsect1> @@ -148,31 +153,31 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Gibt bei Erfolg eine Ingres II Verbindungskennung zurück oder oder &false;, wenn ein Fehler aufgetreten ist. </para> <para> Zu den Details über die Parameter siehe - <function>ingres_connect</function> und die Beispiele . Es gibt + <function>ingres_connect</function> und die Beispiele. Es gibt nur zwei Unterschiede zwischen den Funktionen <function>ingres_pconnect</function> und - <function>ingres_connect</function> : - Zum ersten: beim Verbindungsaufbau schaut die Funktion zuerst, - ob schon eine geöffnete persistente Verbindung besteht, die mit - denselben Parametern geöffnet wurde. Falls eine gefunden wird, - wird ein Identifizierer zurückgegeben, anstatt eine neue Verbindung - zu öffnen. - Zum zweiten: Die Verbindung zum Ingres Server wird nicht geschlossen - wenn die Ausführung des Skripts beendet ist, sondern die Verbindung - bleibt zum weiteren Gebrauch offen - (<function>ingres_close</function> schliesst die Verbindungen, die - mit <function>ingres_pconnect</function> geöffnet wurden nicht). - Darum wird diese Art der Verbindung 'persistent' genannt. + <function>ingres_connect</function>: Zum ersten: beim + Verbindungsaufbau schaut die Funktion zuerst, ob schon eine + geöffnete persistente Verbindung besteht, die mit denselben + Parametern geöffnet wurde. Falls eine gefunden wird, wird ein + Identifizierer zurückgegeben, anstatt eine neue Verbindung zu + öffnen. Zum zweiten: Die Verbindung zum Ingres Server wird nicht + geschlossen wenn die Ausführung des Skripts beendet ist, sondern + die Verbindung bleibt zum weiteren Gebrauch offen + (<function>ingres_close</function> schliesst die Verbindungen, + die mit <function>ingres_pconnect</function> geöffnet wurden + nicht). Darum wird diese Art der Verbindung 'persistent' + genannt. </para> <para> Siehe auch - <function>ingres_connect</function>, und + <function>ingres_connect</function> und <function>ingres_close</function>. </para> </refsect1> @@ -180,8 +185,10 @@ <refentry id="function.ingres-close"> <refnamediv> - <refname>ingres_close</refname> - <refpurpose>Schliesst eine Ingres II Datenbankverbindung</refpurpose> + <refname>ingres_close</refname> + <refpurpose> + Schliesst eine Ingres II Datenbankverbindung + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -193,16 +200,16 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Gibt bei Erfolg &true; zurück, bei einem Fehler &false;. </para> <para> <function>ingres_close</function> schliesst die Verbindung zu dem - Ingres Datenbankserver, der mit der übergebenen Verbindunkskennung - verknüpft ist. Falls der Parameter <parameter>link</parameter> - nicht angegeben wurde, wird die zuletzt geöffnete Verbindung - geschlossen. + Ingres Datenbankserver, der mit der übergebenen + Verbindunkskennung verknüpft ist. Falls der Parameter + <parameter>link</parameter> nicht angegeben wurde, wird die + zuletzt geöffnete Verbindung geschlossen. </para> <para> <function>ingres_close</function> ist normalerweise nicht nötig, @@ -211,7 +218,7 @@ geschlossen werden. </para> <para> Siehe auch - <function>ingres_connect</function>, und + <function>ingres_connect</function> und <function>ingres_pconnect</function>. </para> </refsect1> @@ -220,7 +227,9 @@ <refentry id="function.ingres-query"> <refnamediv> <refname>ingres_query</refname> - <refpurpose>Sendet eine SQL Abfrage an den Ingres II Server</refpurpose> + <refpurpose> + Sendet eine SQL Abfrage an den Ingres II Server + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -235,7 +244,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Gibt bei Erfolg &true; zurück und bei einem Fehler &false;. </para> @@ -255,42 +264,60 @@ zrückzusetzen. Wenn das Skript beendet wird, wird jede offene Transaktion zurückgesetzt (indem die Funktion <function>ingres_rollback</function> aufgerufen wird). Sie können - auch die Funktion <function>ingres_autocommit</function> benutzen, - bevor Sie eine neue Transaktion öffnen, damit werden alle einzelnen - SQL-Abfrage sofort gesendet. + auch die Funktion <function>ingres_autocommit</function> + benutzen, bevor Sie eine neue Transaktion öffnen, damit werden + alle einzelnen SQL-Abfrage sofort gesendet. </para> <para> Einige SQL Abfragen können mit dieser Funktion nicht gesendet werden: <itemizedlist> <listitem> - <simpara>close (siehe <function>ingres_close</function>).</simpara> + <simpara> + close (siehe <function>ingres_close</function>) + </simpara> + </listitem> + <listitem> + <simpara> + commit (siehe <function>ingres_commit</function>) + </simpara> + </listitem> + <listitem> + <simpara> + connect (siehe <function>ingres_connect</function>) + </simpara> </listitem> - <listitem> - <simpara>commit (siehe <function>ingres_commit</function>).</simpara> + <listitem> + <simpara> + disconnect (siehe <function>ingres_close</function>) + </simpara> </listitem> <listitem> - <simpara>connect (siehe <function>ingres_connect</function>).</simpara> + <simpara> + get dbevent</simpara> </listitem> <listitem> - <simpara>disconnect (siehe <function>ingres_close</function>).</simpara> + <simpara> + prepare to commit</simpara> </listitem> - <listitem><simpara>get dbevent</simpara></listitem> - <listitem><simpara>prepare to commit</simpara></listitem> <listitem> <simpara> - rollback (siehe <function>ingres_rollback</function>). + rollback (siehe <function>ingres_rollback</function>) </simpara> </listitem> - <listitem><simpara>savepoint</simpara></listitem> + <listitem> + <simpara>savepoint</simpara> + </listitem> <listitem> <simpara> - set autocommit (siehe <function>ingres_autocommit</function>). + set autocommit (siehe <function>ingres_autocommit</function>) </simpara> </listitem> <listitem> - <simpara>und alle Abfragen, die Cursors benutzen, werden - nicht unterstützt.</simpara> + <simpara> + und alle Abfragen, die Cursors benutzen, werden nicht + unterstützt + </simpara> </listitem> </itemizedlist> </para> @@ -327,7 +354,7 @@ <refname>ingres_num_rows</refname> <refpurpose> Gibt die Anzahl der Datensätze der Ergebnismenge zurück oder die - Anzahl der von der letzten Abfrage betroffenen Datensätze. + Anzahl der von der letzten Abfrage betroffenen Datensätze </refpurpose> </refnamediv> <refsect1> @@ -340,13 +367,13 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> Bei delete-, insert- or update-queries, gibt - <function>ingres_num_rows</function> die Anzahl der durch diese + <function>ingres_num_rows</function> die Anzahl der durch diese Abfragen betroffenen Datensätze zurück. Bei den anderen Abfragen - gibt <function>ingres_num_rows</function> die Anzahl der Datensätze - in der Ergebnismenge zurück. + gibt <function>ingres_num_rows</function> die Anzahl der + Datensätze in der Ergebnismenge zurück. </para> <para> <note> @@ -395,11 +422,12 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_num_fields</function> liefert die Anzahl der Felder - in der Ergebnismenge zurück, die vom Ingres Server nach einem Aufruf - von <function>ingres_query</function> zurückgegeben wurde. + <function>ingres_num_fields</function> liefert die Anzahl der + Felder in der Ergebnismenge zurück, die vom Ingres Server nach + einem Aufruf von <function>ingres_query</function> zurückgegeben + wurde. </para> <para> See also @@ -414,31 +442,32 @@ <refentry id="function.ingres-field-name"> <refnamediv> <refname>ingres_field_name</refname> - <refpurpose>Holt den Namen eines Feldes in einer Ergebnismenge. </refpurpose> + <refpurpose> + Holt den Namen eines Feldes in einer Ergebnismenge + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>string <function>ingres_field_name</function></funcdef> - <paramdef>int - <parameter>index</parameter> - </paramdef> + <paramdef>int <parameter>index</parameter></paramdef> <paramdef>resource <parameter><optional>link</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_name</function> gibt den Namen eines Feldes - in einer Ergebnismenge zurück oder &false;, falls ein Fehler - aufgetreten ist. + <function>ingres_field_name</function> gibt den Namen eines + Feldes in einer Ergebnismenge zurück oder &false;, falls ein + Fehler aufgetreten ist. </para> <para> - <parameter>index</parameter> gibt die Nummer des Feldes an und muss - zwischen 1 und dem Wert, der von - <function>ingres_num_fields</function> zurückgegeben wird, liegen. + <parameter>index</parameter> gibt die Nummer des Feldes an und + muss zwischen 1 und dem Wert, der von + <function>ingres_num_fields</function> zurückgegeben wird, + liegen. </para> <para> Siehe auch @@ -453,7 +482,9 @@ <refentry id="function.ingres-field-type"> <refnamediv> <refname>ingres_field_type</refname> - <refpurpose>Gibt den Typ eines Feldes in einer Ergebnismenge zurück.</refpurpose> + <refpurpose> + Gibt den Typ eines Feldes in einer Ergebnismenge zurück + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -468,18 +499,19 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_type</function> gibt den Typ eines Feldes in - einer Ergebnismenge zurück oder &false;, wenn ein Fehler aufgetreten - ist. Beispiele von Rückgabewerten sind: "IIAPI_BYTE_TYPE", - "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", "IIAPI_FLT_TYPE", - "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE". Einige dieser Typen können, in - Abhängigkeit von der Feldlänge, mehrere SQL Typen umfassen. - (siehe <function>ingres_field_length</function>). Beispielsweise kann + <function>ingres_field_type</function> gibt den Typ eines Feldes + in einer Ergebnismenge zurück oder &false;, wenn ein Fehler + aufgetreten ist. Beispiele von Rückgabewerten sind: + "IIAPI_BYTE_TYPE", "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", + "IIAPI_FLT_TYPE", "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE". Einige + dieser Typen können, in Abhängigkeit von der Feldlänge, mehrere + SQL Typen umfassen. (siehe + <function>ingres_field_length</function>). Beispielsweise kann "IIAPI_FLT_TYPE" entweder float4 oder float8 sein. Genauere - Informationen darüber finden Sie in dem Ingres/OpenAPI User Guide - - Appendix C. + Informationen darüber finden Sie in dem Ingres/OpenAPI User Guide + - Appendix C. </para> <para> <parameter>index</parameter> ist die Feldnummer und muss zwischen 1 @@ -499,30 +531,33 @@ <refentry id="function.ingres-field-nullable"> <refnamediv> <refname>ingres_field_nullable</refname> - <refpurpose>Prüft, ob für ein Feld NULL-Werte zugelassen sind.</refpurpose> + <refpurpose> + Prüft, ob für ein Feld NULL-Werte zugelassen sind + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>ingres_field_nullable</function></funcdef> - <paramdef>int - <parameter>index</parameter> + <funcdef>bool + <function>ingres_field_nullable</function> + </funcdef> + <paramdef>int <parameter>index</parameter> </paramdef> <paramdef>resource <parameter><optional>link</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_nullable</function> gibt &true; zurück, falls - in dieser Spalte &null;-Werte zugelasssen sind und &false;, falls - das nicht erlaubt ist. + <function>ingres_field_nullable</function> gibt &true; zurück, + falls in dieser Spalte &null;-Werte zugelasssen sind und &false;, + falls das nicht erlaubt ist. </para> <para> - <parameter>index</parameter> ist die Feldnummer und muss zwischen 1 - und dem Wert liegen, den die Funktion + <parameter>index</parameter> ist die Feldnummer und muss zwischen + 1 und dem Wert liegen, den die Funktion <function>ingres_num_fields</function> zurückgibt. </para> <para> @@ -538,7 +573,7 @@ <refentry id="function.ingres-field-length"> <refnamediv> <refname>ingres_field_length</refname> - <refpurpose>Gibt die Länge eines Feldes zurück.</refpurpose> + <refpurpose>Gibt die Länge eines Feldes zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -555,14 +590,14 @@ </funcsynopsis> &warn.experimental.func; <para> - <function>ingres_field_length</function> gibt die Länge eines Feldes - zurück. Das ist die Anzahl der Bytes, die der Server zum Speichern - des Feldes belegt. Für genauere Informationen schauen sie in den - Ingres/OpenAPI User Guide - Appendix C. + <function>ingres_field_length</function> gibt die Länge eines + Feldes zurück. Das ist die Anzahl der Bytes, die der Server zum + Speichern des Feldes belegt. Für genauere Informationen schauen + sie in den Ingres/OpenAPI User Guide - Appendix C. </para> <para> - <parameter>index</parameter> ist die Feldnummer und muss zwischen 1 - und dem Wert liegen, den die Funktion + <parameter>index</parameter> ist die Feldnummer und muss zwischen + 1 und dem Wert liegen, den die Funktion <function>ingres_num_fields</function> zurückgibt. </para> <para> @@ -578,7 +613,7 @@ <refentry id="function.ingres-field-precision"> <refnamediv> <refname>ingres_field_precision</refname> - <refpurpose>Gibt die Genauigkeit eines Feldes zurück.</refpurpose> + <refpurpose>Gibt die Genauigkeit eines Feldes zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -593,7 +628,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_field_precision</function> gibt die Genauigkeit eines Feldes zurück. Dieser Rückgabewert wird nur für @@ -602,8 +637,8 @@ Ingres/OpenAPI User Guide - Appendix C an. </para> <para> - <parameter>index</parameter> ist die Feldnummer und muss zwischen 1 - und dem Wert liegen, den die Funktion + <parameter>index</parameter> ist die Feldnummer und muss zwischen + 1 und dem Wert liegen, den die Funktion <function>ingres_num_fields</function> zurückgibt. </para> <para> @@ -619,32 +654,30 @@ <refentry id="function.ingres-field-scale"> <refnamediv> <refname>ingres_field_scale</refname> - <refpurpose>Gibt den Skalar eines Feldes zurück.</refpurpose> + <refpurpose>Gibt den Skalar eines Feldes zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ingres_field_scale</function></funcdef> - <paramdef>int - <parameter>index</parameter> - </paramdef> + <paramdef>int <parameter>index</parameter></paramdef> <paramdef>resource <parameter><optional>link</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>ingres_field_scale</function> gibt den Skalar eines Feldes - zurück.Dieser Rückgabewert wird nur für Dezimalzahlen, + <function>ingres_field_scale</function> gibt den Skalar eines + Feldes zurück.Dieser Rückgabewert wird nur für Dezimalzahlen, Fliesskommazahlen und monetäre SQL Datentypen benutzt. Für nähere Informationen schauen Sie sich den Ingres/OpenAPI User Guide - Appendix C an. </para> <para> - <parameter>index</parameter> ist die Feldnummer und muss zwischen 1 - und dem Wert liegen, den die Funktion + <parameter>index</parameter> ist die Feldnummer und muss zwischen + 1 und dem Wert liegen, den die Funktion <function>ingres_num_fields</function> zurückgibt. </para> <para> @@ -660,7 +693,9 @@ <refentry id="function.ingres-fetch-array"> <refnamediv> <refname>ingres_fetch_array</refname> - <refpurpose>Liest eine Zeile der Ergebnismenge in ein Array ein.</refpurpose> + <refpurpose> + Liest eine Zeile der Ergebnismenge in ein Array ein + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -675,7 +710,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_fetch_array</function> Gibt ein Array zurück, das die die entsprechende Zeile der Ergebnismenge enthält oder &false; @@ -687,11 +722,13 @@ der Daten unter numerischen Indizes werden die Daten auch unter assoziativen Indizes im Ergebnisarray gespeichert, in dem die Feldnamen als Schlüssel benutzt werden. + </para> <para> Falls eine oder mehrere Spalten der Ergebnismenge dieselben - Feldnamen haben, bekommt die letzte Spalte die Priorität. Um auf die - anderen Spalten zuzugreifen, müssen sie entweder den numerischen - Index der Spalte benutzen oder Aliase für die Spalten machen. + Feldnamen haben, bekommt die letzte Spalte die Priorität. Um auf + die anderen Spalten zuzugreifen, müssen sie entweder den + numerischen Index der Spalte benutzen oder Aliase für die Spalten + machen. <informalexample> <programlisting> ingres_query(select t1.f1 as foo t2.f1 as bar from t1, t2); @@ -744,7 +781,9 @@ <refentry id="function.ingres-fetch-row"> <refnamediv> <refname>ingres_fetch_row</refname> - <refpurpose>Holt eine Zeile aus einer Ergebnismenge in ein numerisches Array.</refpurpose> + <refpurpose> + Holt eine Zeile aus einer Ergebnismenge in ein numerisches Array + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -756,7 +795,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_fetch_row</function> gibt ein Array zurück, das die entsprechende Zeile der Ergebnismenge enthält oder &false;, @@ -765,9 +804,9 @@ </para> <para> Aufeinanderfolgende Aufrufe von - <function>ingres_fetch_row</function> würden immer die nächste Zeile - der Ergebnismenge zurückgeben oder &false;, wenn es keine Zeilen - mehr gibt. + <function>ingres_fetch_row</function> würden immer die nächste + Zeile der Ergebnismenge zurückgeben oder &false;, wenn es keine + Zeilen mehr gibt. </para> <para> <example> @@ -798,13 +837,15 @@ <refentry id="function.ingres-fetch-object"> <refnamediv> <refname>ingres_fetch_object</refname> - <refpurpose>Holt eine Zeile als Objekt.</refpurpose> + <refpurpose>Holt eine Zeile als Objekt</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>object <function>ingres_fetch_object</function></funcdef> + <funcdef>object + <function>ingres_fetch_object</function> + </funcdef> <paramdef>int <parameter><optional>result_type</optional></parameter> </paramdef> @@ -816,21 +857,21 @@ &warn.experimental.func; <para> <function>ingres_fetch_object</function> Gibt ein Objekt zurück, - das mit der geholten Zeile einer Ergebnismenge korrespondiert oder - &false;, wenn es keine Zeilen mehr in der Egebnismenge gibt. + das mit der geholten Zeile einer Ergebnismenge korrespondiert + oder &false;, wenn es keine Zeilen mehr in der Egebnismenge gibt. </para> <para> Diese Funktion ist ähnlich zu <function>ingres_fetch_array</function>, mit einem Unterschied - ein Objekt wird anstelle eines Arrays zurückgegeben. Indirekt heisst das, dass Sie die Daten nur über ihre Feldnamen ansprechen - können und nicht über ihre Offsets (Zahlen sind unzulässige - Namen für Objekteigenschaften). + können und nicht über ihre Offsets (Zahlen sind unzulässige Namen + für Objekteigenschaften). </para> <para> - Das optionale Argument <parameter>result_type</parameter> ist eine - Konstante, die die folgenden Werte annehmen kann: INGRES_ASSOC, - INGRES_NUM und INGRES_BOTH. + Das optionale Argument <parameter>result_type</parameter> ist + eine Konstante, die die folgenden Werte annehmen kann: + INGRES_ASSOC, INGRES_NUM und INGRES_BOTH. </para> <para> Diese Funktion ist von der Geschwindigkeit her identisch zu @@ -867,7 +908,7 @@ <refentry id="function.ingres-rollback"> <refnamediv> <refname>ingres_rollback</refname> - <refpurpose>Setzt eine Transaktion zurück.</refpurpose> + <refpurpose>Setzt eine Transaktion zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -879,16 +920,17 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_rollback</function> setzt die aktuell geöffnete - Transaktion zurück und macht alle Änderungen, die in der Transaktion - bereits durchgeführt wurden, wieder rückgängig. + Transaktion zurück und macht alle Änderungen, die in der + Transaktion bereits durchgeführt wurden, wieder rückgängig. </para> <para> - Diese Funktion schliesst die Transaktion. Eine Neue Transaktion kann - geöffnet werden, wenn man mit <function>ingres_query</function> eine - neue Abfrage an den Datenbankserver schickt. + Diese Funktion schliesst die Transaktion. Eine Neue Transaktion + kann geöffnet werden, wenn man mit + <function>ingres_query</function> eine neue Abfrage an den + Datenbankserver schickt. </para> <para> Siehe auch @@ -902,7 +944,7 @@ <refentry id="function.ingres-commit"> <refnamediv> <refname>ingres_commit</refname> - <refpurpose>Schliesst eine Transaktion ab.</refpurpose> + <refpurpose>Schliesst eine Transaktion ab</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -914,7 +956,7 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_commit</function> schliesst die aktuell offene Transaktion ab, indem alle Veränderungen in die Datenbank @@ -942,8 +984,10 @@ <refentry id="function.ingres-autocommit"> <refnamediv> - <refname>ingres_autocommit</refname> - <refpurpose>Schaltet den autocommit-Modus an oder aus.</refpurpose> + <refname>ingres_autocommit</refname> + <refpurpose> + Schaltet den autocommit-Modus an oder aus + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -955,15 +999,15 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> <function>ingres_autocommit</function> wird vor dem Öffnen einer Transaktion aufgerufen (vor dem ersten Aufruf der Funktion <function>ingres_query</function> oder gleich nach einem Aufruf von <function>ingres_rollback</function> oder <function>ingres_autocommit</function>) um in den "autocommit" - Modus des Servers ein- oder auszuschalten (beim Beginn eines Skripts - ist der autocommit-Modus ausgeschaltet). + Modus des Servers ein- oder auszuschalten (beim Beginn eines + Skripts ist der autocommit-Modus ausgeschaltet). </para> <para> Wenn der autocommit-Modus eingeschaltet ist, wird jede Abfrage