cvs: phpdoc /ja/functions ingres_ii.xml

hirokawa Mon Nov 27 05:57:37 2000 EDT Modified files: /phpdoc/ja/functions ingres_ii.xml Log: update translations.

Index: phpdoc/ja/functions/ingres_ii.xml diff -u phpdoc/ja/functions/ingres_ii.xml:1.2 phpdoc/ja/functions/ingres_ii.xml:1.3 --- phpdoc/ja/functions/ingres_ii.xml:1.2 Sun Nov 26 04:47:20 2000 +++ phpdoc/ja/functions/ingres_ii.xml Mon Nov 27 05:57:37 2000 @@ -320,36 +320,34 @@ </funcprototype> </funcsynopsis> <para> - For delete, insert or update queries, - <function>ingres_num_rows</function> returns the number of rows - affected by the query. For other queries, - <function>ingres_num_rows</function> returns the number of rows - in the query's result. + delete, insert, update クエリの場合、 + <function>ingres_num_rows</function> は、そのクエリにより作用され + た行(レコード)の数を返します。その他のクエリの場合、 + <function>ingres_num_rows</function> はクエリ結果のレコード数を返 + します。 </para> <para> <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>, - <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. + この関数は、主にデータベースで修正されたレコードの数を得る際に + 有用です。この関数が <function>ingres_fetch_array</function>、 + <function>ingres_fetch_object</function>、 + <function>ingres_fetch_row</function> を使用する前にコールされ + た場合、サーバは結果のデータを削除し、スクリプトは結果を得るこ + とができなくなります。 </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. + 代わりにこれらの取得用関数のどれかをもう結果が残っていないとい + う意味で false を返すまでループ処理を行い、結果のデータを取得す + る必要があります。 </simpara> </note> </para> <para> - See also - <function>ingres_query</function>, - <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and - <function>ingres_fetch_row</function>. + <function>ingres_query</function>、 + <function>ingres_fetch_array</function>、 + <function>ingres_fetch_object</function>、 + <function>ingres_fetch_row</function> も参照下さい。 </para> </refsect1> </refentry> @@ -372,16 +370,15 @@ </funcprototype> </funcsynopsis> <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> は、 + <function>ingres_query</function> をコールした後で、Ingres サーバ + により返された結果のフィールド数を返します。 </para> <para> - See also - <function>ingres_query</function>, - <function>ingres_fetch_array</function>, - <function>ingres_fetch_object</function> and - <function>ingres_fetch_row</function>. + <function>ingres_query</function>、 + <function>ingres_fetch_array</function>、 + <function>ingres_fetch_object</function>、 + <function>ingres_fetch_row</function> も参照下さい。 </para> </refsect1> </refentry> @@ -396,29 +393,26 @@ <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> <para> - <function>ingres_field_name</function> returns the name of a field - in a query result, or false on failure. + <function>ingres_field_name</function> は、クエリ結果の場合はフィー + ルド名、失敗した場合は false を返します。 </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by - <function>ingres_num_fields</function>. + <parameter>index</parameter> はフィールド番号であり、1 と + <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_row</function>. + <function>ingres_query</function>、 + <function>ingres_fetch_array</function>、 + <function>ingres_fetch_object</function>、 + <function>ingres_fetch_row</function> も参照下さい。 </para> </refsect1> </refentry> @@ -441,28 +435,27 @@ </paramdef> </funcprototype> </funcsynopsis> + <para> + <function>ingres_field_type</function> はクエリ結果のフィールド型、 + 失敗した場合は、false を返します。返される型は、例えば、 + "IIAPI_BYTE_TYPE", "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", + "IIAPI_FLT_TYPE", "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE" になります。 + これらの型のいくつかは、フィールド長に応じて複数のSQL型をマップす + ることが可能です(<function>ingres_field_length</function>を参照 + 下さい)。例えば、"IIAPI_FLT_TYPE" は、float4 または float8 とする + ことが可能です。詳細な情報については、Ingres/OpenAPI User Guide + の Appendix C を参照下さい。 + </para> <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 - "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 - <function>ingres_num_fields</function>. + <parameter>index</parameter> はフィールド番号であり、1と + <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_row</function>. + <function>ingres_fetch_object</function>, + <function>ingres_fetch_row</function> も参照下さい。 </para> </refsect1> </refentry> @@ -486,20 +479,19 @@ </funcprototype> </funcsynopsis> <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> は、フィールドにNULLが + 設定可能な場合に true、設定できない場合に false を返します。 </para> <para> - <parameter>index</parameter> is the number of the field and must be - between 1 and the value given by - <function>ingres_num_fields</function>. + <parameter>index</parameter> はフィールド番号であり、1 と + <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_row</function>. + <function>ingres_fetch_object</function>, + <function>ingres_fetch_row</function> も参照下さい。 </para> </refsect1> </refentry> @@ -523,21 +515,21 @@ </funcprototype> </funcsynopsis> <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> はフィールド長を返します。 + フィールド長は、フィールドをサーバに保存する際に使用されるバイト + 数です。詳細な情報については、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 - <function>ingres_num_fields</function>. + <parameter>index</parameter> はフィールド番号であり、1 と + <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_row</function>. + <function>ingres_fetch_object</function>, + <function>ingres_fetch_row</function> も参照下さい。 </para> </refsect1> </refentry> @@ -561,22 +553,21 @@ </funcprototype> </funcsynopsis> <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> はフィールドの精度を + 返します。この値は、decimal、float、SQLデータ money 型でのみ使用 + されます。詳細な情報については、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 - <function>ingres_num_fields</function>. + <parameter>index</parameter> はフィールド番号であり、1 と + <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_row</function>. + <function>ingres_fetch_object</function>, + <function>ingres_fetch_row</function> も参照下さい。 </para> </refsect1> </refentry> @@ -591,30 +582,28 @@ <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> <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> はフィールドのスケールを + 返します。この値は、SQLデータ decimal 型でのみ使用されます。詳細 + な情報については、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 - <function>ingres_num_fields</function>. + <parameter>index</parameter> はフィールド番号であり、1 と + <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_row</function>. + <function>ingres_fetch_object</function>, + <function>ingres_fetch_row</function> も参照下さい。 </para> </refsect1> </refentry> @@ -638,23 +627,23 @@ </funcprototype> </funcsynopsis> <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> は、取得したレコード(行) + に対応する配列を返します。レコードがもうない場合は false を返しま + す。 </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> の拡張版です。 + 結果として返される配列の数値添字にデータを保存するだけでなく、フィー + ルド名をキーとして連想配列にもデータが保存されます。 </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. + 結果において複数のカラムが同じフィールド名を有している場合、後の + カラムが優先されます。同名の他のカラムにアクセスするには、カラム + の添字番号を使用するか、カラムのエイリアスを作成する必要がありま + す。 <informalexample> - <programlisting> -ingres_query(select t1.f1 as foo t2.f1 as bar from t1, t2); + <programlisting role="php"> +ingres_query (select t1.f1 as foo t2.f1 as bar from t1, t2); $result = ingres_fetch_array(); $foo = $result["foo"]; $bar = $result["bar"]; @@ -662,14 +651,14 @@ </informalexample> </para> <para> - <parameter>result_type</parameter> can be II_NUM for enumerated array, - II_ASSOC for associative array, or II_BOTH (default). + <parameter>result_type</parameter> には、数値添字の場合に II_NUM、 + 連想配列の場合に II_ASSOC、両方の場合に II_BOTH (デフォルト)を指 + 定可能です。 </para> <para> - Speed-wise, the function is identical to - <function>ingres_fetch_object</function>, and almost as quick as - <function>ingres_fetch_row</function> (the difference is - insignificant). + 速度面では、この関数は<function>ingres_fetch_object</function> + と同じで、<function>ingres_fetch_row</function> とほぼ同等です(差 + は僅かです)。 </para> <para> <example> @@ -680,9 +669,9 @@ ingres_query ("select * from table"); while ($row = ingres_fetch_array()) { - echo $row["user_id"]; # using associative array + echo $row["user_id"]; # 連想配列を使用する echo $row["fullname"]; - echo $row[1]; # using enumerated array + echo $row[1]; # 数値添字配列を使用する echo $row[2]; } ?> @@ -690,12 +679,11 @@ </example> </para> <para> - See also <function>ingres_query</function>, <function>ingres_num_fields</function>, <function>ingres_field_name</function>, - <function>ingres_fetch_object</function> and - <function>ingres_fetch_row</function>. + <function>ingres_fetch_object</function>, + <function>ingres_fetch_row</function> も参照下さい。 </para> </refsect1> </refentry> @@ -716,18 +704,18 @@ </funcprototype> </funcsynopsis> <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> は取得したレコード(行)を有 + する配列を返します。レコードがもうない場合は false を返します。各 + カラムは、オフセット1から始まる配列オフセットに保存されます。 </para> <para> - Subsequent call to <function>ingres_fetch_row</function> would - return the next row in the result set, or false if there are no - more rows. + <function>ingres_fetch_row</function> を連続的にコールした場合、 + 結果集合の中の次のレコードが返され、もうレコードがない場合はfalse + を返します。 </para> <para> <example> - <title><function>ingres_fetch_row</function> example</title> + <title><function>ingres_fetch_row</function> の例</title> <programlisting role="php"> &lt;?php ingres_connect ($database, $user, $password); @@ -742,11 +730,10 @@ </example> </para> <para> - See also <function>ingres_num_fields</function>, <function>ingres_query</function>, - <function>ingres_fetch_array</function> and - <function>ingres_fetch_object</function>. + <function>ingres_fetch_array</function>, + <function>ingres_fetch_object</function>も参照下さい。 </para> </refsect1> </refentry> @@ -770,30 +757,30 @@ </funcprototype> </funcsynopsis> <para> - <function>ingres_fetch_object</function> Returns an object that - corresponds to the fetched row, or false if there are no more rows. + <function>ingres_fetch_object</function> は取得したレコード(行)を + オブジェクトとして返します。レコードがもうない場合は false を返し + ます。 </para> - <para> - This function is similar to - <function>ingres_fetch_array</function>, with one difference - an - object is returned, instead of an array. Indirectly, that means - that you can only access the data by the field names, and not by - their offsets (numbers are illegal property names). - </para> - <para> - The optional argument <parameter>result_type</parameter> is a - constant and can take the following values: II_ASSOC, - II_NUM, and II_BOTH. - </para> - <para> - Speed-wise, the function is identical to - <function>ingres_fetch_array</function>, and almost as quick as - <function>ingres_fetch_row</function> (the difference is - insignificant). + <para> + この関数は <function>ingres_fetch_array</function> に似ていますが、 + 配列の代わりにオブジェクトが返されるという違いが一つあります。間 + 接的なアクセス、つまり、オフセットではなくフィールド名によりデー + タをアクセスすることのみが可能です(数値はプロパティ名としては使用 + できません)。 </para> <para> + オプションの引数 <parameter>result_type</parameter> は定数であり、 + 次の値のどれかとなります: II_ASSOC, + II_NUM, II_BOTH + </para> + <para> + 速度の面では、この関数は <function>ingres_fetch_array</function> + と等価であり、<function>ingres_fetch_row</function> とほぼ同等で + す(違いは僅かです)。 + </para> + <para> <example> - <title><function>ingres_fetch_object</function> example</title> + <title><function>ingres_fetch_object</function> の例</title> <programlisting role="php"> &lt;?php ingres_connect ($database, $user, $password); @@ -807,12 +794,11 @@ </example> </para> <para> - See also <function>ingres_query</function>, <function>ingres_num_fields</function>, <function>ingres_field_name</function>, - <function>ingres_fetch_array</function> and - <function>ingres_fetch_row</function>. + <function>ingres_fetch_array</function>, + <function>ingres_fetch_row</function> も参照下さい。 </para> </refsect1> </refentry> @@ -833,19 +819,19 @@ </funcprototype> </funcsynopsis> <para> - <function>ingres_rollback</function> rolls back the currently open - transaction, actualy canceling all changes made to the database - during the transaction. + <function>ingres_rollback</function> は現在オープンされているトラ + ンザクションをロールバックし、トランザクションの間にデータベース + に行われた全ての変更をキャンセルします。 </para> <para> - This closes the transaction. A new one can be open by sending a - query with <function>ingres_query</function>. + この関数は、トランザクションをクローズします。 + <function>ingres_query</function> によりクエリを送信することによ + り、新規のトランザクションをオープンすることが可能です。 </para> <para> - See also <function>ingres_query</function>, - <function>ingres_commit</function> and - <function>ingres_autocommit</function>. + <function>ingres_commit</function>, + <function>ingres_autocommit</function> も参照下さい。 </para> </refsect1> </refentry> @@ -866,23 +852,23 @@ </funcprototype> </funcsynopsis> <para> - <function>ingres_commit</function> commits the currently open - transaction, making all changes made to the database permanent. + <function>ingres_commit</function> は現在オープンされているトラン + ザクションをオープンし、全ての変更をデータベースに保存します。 </para> <para> - This closes the transaction. A new one can be open by sending a - query with <function>ingres_query</function>. + この関数はトランザクションをクローズします。 + <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. + トランザクションをオープンする前に + <function>ingres_autocommit</function> をコールすることにより、各 + クエリの後に自動的にサーバ側でコミットを行うことも可能です。 </para> <para> - See also <function>ingres_query</function>, - <function>ingres_rollback</function> and - <function>ingres_autocommit</function>. + <function>ingres_rollback</function>, + <function>ingres_autocommit</function>も参照下さい。 </para> </refsect1> </refentry> @@ -903,23 +889,23 @@ </funcprototype> </funcsynopsis> <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). + <function>ingres_autocommit</function> は、サーバの "autocommit" + モードをオンまたはオフに切替えるために、トランザクションをオープ + ンする前(最初に<function>ingres_query</function>をコールする前ま + たは<function>ingres_rollback</function>または + <function>ingres_autocommit</function>をコールした直後)にコールさ + れます(スクリプトの実行開始には、autocommitモードはオフです)。 </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>. + autocommit モードがオンの場合、各クエリはサーバにより自動的にコミッ + トされます。これは、<function>ingres_query</function> をコールし + た後に常に <function>ingres_commit</function> をコールすることと + 等価です。 </para> <para> - See also <function>ingres_query</function>, - <function>ingres_rollback</function> and - <function>ingres_commit</function>. + <function>ingres_rollback</function>, + <function>ingres_commit</function>も参照下さい。 </para> </refsect1> </refentry>