cvs: phpdoc-ja /reference/pdo/functions PDO-query.xml PDOStatement-bindParam.xml PDOStatement-closeCursor.xml PDOStatement-errorCode.xml

shimooka Tue Jul 19 10:59:08 2005 EDT Modified files: /phpdoc-ja/reference/pdo/functions PDO-query.xml PDOStatement-bindParam.xml PDOStatement-closeCursor.xml PDOStatement-errorCode.xml Log: translation updated

http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-query.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-query.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-query.xml:1.2 phpdoc-ja/reference/pdo/functions/PDO-query.xml:1.3 --- phpdoc-ja/reference/pdo/functions/PDO-query.xml:1.2 Mon Jul 11 13:00:28 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-query.xml Tue Jul 19 10:59:07 2005 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='utf-8'?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.3 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: shimooka Status: ready --> <!-- CREDITS: hirokawa --> <refentry id="function.PDO-query"> <refnamediv> @@ -12,7 +12,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>object</type><methodname>PDO::query</methodname> + <type>PDOStatement</type><methodname>PDO::query</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> </methodsynopsis> http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDOStatement-bindParam.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-ja/reference/pdo/functions/PDOStatement-bindParam.xml diff -u phpdoc-ja/reference/pdo/functions/PDOStatement-bindParam.xml:1.2 phpdoc-ja/reference/pdo/functions/PDOStatement-bindParam.xml:1.3 --- phpdoc-ja/reference/pdo/functions/PDOStatement-bindParam.xml:1.2 Sat Jun 18 01:02:08 2005 +++ phpdoc-ja/reference/pdo/functions/PDOStatement-bindParam.xml Tue Jul 19 10:59:07 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.6 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.8 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. --> <refentry id="function.PDOStatement-bindParam"> <refnamediv> @@ -21,21 +21,16 @@ </methodsynopsis> &warn.experimental.func; <para> - 指定された変数名に SQL 文パラメータをバインドします。 - SQL 文パラメータは、名前付けされたプレースホルダ - もしくは疑問符プレースホルダのいずれかが可能です。 + 準備された SQL 文中で、 + 対応する名前もしくは疑問符プレースホルダにパラメータをバインドします。 </para> <para> - 出力パラメータは、SQL 文が実行されたとき、バインドされた PHP - 変数の値にデータベースによって返される値をセットします。これにより、 - 例えば機能をサポートするデータベースに対して、 - 出力もしくは入出力パラメータを用いてストアドプロシージャを - コールすることができます。 - </para> - <para> - NULL でない入力専用変数に対しては、代わりに - <function>PDOStatement::execute</function> - に入力値の配列を渡すことができます。 + ほとんどのパラメータは入力パラメータです。つまり、クエリを構築する際、 + パラメータは読み込み専用で使用されます。 + いくつかのドライバは、出力パラメータとしてデータを返す + ストアドプロシージャの実行をサポートしており、 + またいくつかのドライバは、データを渡し更新された値を受け取る、 + といった入出力パラメータもサポートしています。 </para> </refsect1> @@ -139,6 +134,7 @@ </programlisting> </example> +<!-- <example><title>プリペアドステートメントに NULL 値を渡す</title> <programlisting role='php'> <![CDATA[ @@ -159,7 +155,7 @@ ]]> </programlisting> </example> - +--> <example><title>INOUT パラメータを持つストアドプロシージャをコールする</title> <programlisting role='php'> <![CDATA[ http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDOStatement-closeCursor.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/pdo/functions/PDOStatement-closeCursor.xml diff -u phpdoc-ja/reference/pdo/functions/PDOStatement-closeCursor.xml:1.1 phpdoc-ja/reference/pdo/functions/PDOStatement-closeCursor.xml:1.2 --- phpdoc-ja/reference/pdo/functions/PDOStatement-closeCursor.xml:1.1 Sat Jul 9 22:54:45 2005 +++ phpdoc-ja/reference/pdo/functions/PDOStatement-closeCursor.xml Tue Jul 19 10:59:07 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.1 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.2 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. --> <refentry id="function.PDOStatement-closeCursor"> <refnamediv> @@ -20,15 +20,21 @@ <para> <function>PDOStatement::closeCursor</function> は、 - 他のクエリが文を発行できるようにサーバへの接続を解放しますが、 + 他の SQL 文を発行できるようにサーバへの接続を解放しますが、 ステートメントは再実行可能な状態のまま残されます。 </para> <para> - このメソッドは、オプションのドライバ固有のメソッド (最大の効率を得るため) - もしくはドライバ固有の関数がインストールされていない場合の汎用的な - PDO フォールバックとして実装されています。 + このメソッドは以前に実行された PDOStatement + オブジェクトが行をまだフェッチしていない場合に PDOStatement + オブジェクトの実行をサポートしていないデータベースドライバに対して有用です。 + もし使用しているデータベースドライバがこの制限を受ける場合、 + out-of-sequence エラーが出力されます。 </para> <para> + <function>PDOStatement::closeCursor</function>は、 + オプションのドライバ固有のメソッド (最大の効率を得るため) + もしくはドライバ固有の関数がインストールされていない場合の汎用的な + PDO フォールバックとして実装されています。 汎用的な PDO フォールバックは、PHP スクリプト中に以下のようなコードを書くことと意味的に等価です。 <programlisting role="php"> @@ -40,6 +46,7 @@ if (!$stmt->nextRowset()) break; } while (true); +?> ]]> </programlisting> </para> @@ -80,38 +87,47 @@ </refsect1> --> - - <!-- Use when examples exist <refsect1 role="examples"> &reftitle.examples; <para> <example> - <title>A <function>PDOStatement::closeCursor</function> example</title> + <title><function>PDOStatement::closeCursor</function> の例</title> <para> - Any text that describes the purpose of the example, or - what goes on in the example should go here (inside the - <example> tag, not out + 以下の例では、PDOStatement オブジェクト <varname>$stmt</varname> + は複数の行を返しますが、このアプリケーションは先頭行のみフェッチし、 + PDOStatement オブジェクトをフェッチしていない行がある状態のままにします。 + このアプリケーションがが全てのデータベースドライバで動作するよう、 + PDOStatement オブジェクト <varname>$otherStmt</varname> を実行する前に + <varname>$stmt</varname> に対して + <function>PDOStatement::closeCursor</function> + の呼び出しを挿入しています。 </para> <programlisting role="php"> <![CDATA[ <?php -if ($anexample === true) { - echo 'Use the PEAR Coding Standards'; -} +// PDOStatement オブジェクトを生成する +$stmt = $dbh->prepare('SELECT foo FROM bar'); + +// 第二の PDOStatement オブジェクトを生成する +$stmt = $dbh->prepare('SELECT foobaz FROM foobar'); + +// 最初の文を実行する +$stmt->execute(); + +// 結果から先頭行のみフェッチする +$stmt->fetch(); + +// 続く closeCursor() のコールはいくつかのドライバでは必要となる +$stmt->closeCursor(); + +// ここで第二の文を実行することができる +$otherStmt->execute(); ?> ]]> </programlisting> - &example.outputs; - <screen> -<![CDATA[ -Use the PEAR Coding Standards -]]> - </screen> </example> </para> </refsect1> - --> - <refsect1 role="seealso"> &reftitle.seealso; http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDOStatement-errorCode.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/pdo/functions/PDOStatement-errorCode.xml diff -u phpdoc-ja/reference/pdo/functions/PDOStatement-errorCode.xml:1.1 phpdoc-ja/reference/pdo/functions/PDOStatement-errorCode.xml:1.2 --- phpdoc-ja/reference/pdo/functions/PDOStatement-errorCode.xml:1.1 Mon May 2 03:14:33 2005 +++ phpdoc-ja/reference/pdo/functions/PDOStatement-errorCode.xml Tue Jul 19 10:59:07 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.3 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.4 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. --> <refentry id="function.PDOStatement-errorCode"> <refnamediv> @@ -21,11 +21,10 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - SQLSTATE を返します。これは、ANSI SQL 標準で定義された英数 5 - 文字の ID です。 - <function>PDOStatement::errorCode</function> は、 - PDOStatement オブジェクトを用いて実行された操作に対する - エラーコードのみを取得します。 + <function>PDOStatement::errorCode</function> + は PDOStatement オブジェクトを用いて実行された操作に対する + エラーコードを取得することを除き、 + <function>PDO::errorCode</function> と等価です。 </para> </refsect1>