cvs: peardoc /ja/package/database/db intro-dsn.xml intro-execute.xml intro-fetch.xml intro-portability.xml

elf Tue Mar 2 17:58:33 2004 EDT Modified files: /peardoc/ja/package/database/db intro-dsn.xml intro-execute.xml intro-fetch.xml intro-portability.xml Log: o Sync with en.

http://cvs.php.net/diff.php/peardoc/ja/package/database/db/intro-dsn.xml?r1=1.9&r2=1.10&ty=u Index: peardoc/ja/package/database/db/intro-dsn.xml diff -u peardoc/ja/package/database/db/intro-dsn.xml:1.9 peardoc/ja/package/database/db/intro-dsn.xml:1.10 --- peardoc/ja/package/database/db/intro-dsn.xml:1.9 Tue Feb 24 11:29:08 2004 +++ peardoc/ja/package/database/db/intro-dsn.xml Tue Mar 2 17:58:32 2004 @@ -1,5 +1,5 @@ -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.18 Maintainer: elf Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.19 Maintainer: elf Status: ready --> <refentry id="package.database.db.intro-dsn"> <refnamediv> <refname>導入 - DSN</refname> @@ -23,11 +23,11 @@ <member> <parameter>dbsyntax</parameter>: SQL構文等のデータベース関連構文です。 - When using ODBC as the - <parameter>phptype</parameter>, set this to the DBMS type the ODBC - driver is connecting to. Examples: <literal>access</literal>, + <parameter>phptype</parameter>としてODBCを使用する場合、 + ODBCドライバが接続しているDBMSタイプにこれをセットしてください。 + 例: <literal>access</literal>, <literal>db2</literal>, <literal>mssql</literal>, - <literal>navision</literal>, <literal>solid</literal>, etc. + <literal>navision</literal>, <literal>solid</literal>, その他 </member> <member> <parameter>protocol</parameter>: http://cvs.php.net/diff.php/peardoc/ja/package/database/db/intro-execute.xml?r1=1.5&r2=1.6&ty=u Index: peardoc/ja/package/database/db/intro-execute.xml diff -u peardoc/ja/package/database/db/intro-execute.xml:1.5 peardoc/ja/package/database/db/intro-execute.xml:1.6 --- peardoc/ja/package/database/db/intro-execute.xml:1.5 Tue Feb 24 11:29:08 2004 +++ peardoc/ja/package/database/db/intro-execute.xml Tue Mar 2 17:58:32 2004 @@ -1,5 +1,5 @@ -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.14 Maintainer: elf Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.15 Maintainer: elf Status: ready --> <refentry id="package.database.db.intro-execute"> <refnamediv> <refname>導入 - 準備と実行</refname> @@ -59,7 +59,7 @@ <para> 汎用の命令文を作成するのは簡単です。 SQLクエリを通常通り作成します。すなわち - <programlisting> + <programlisting role="sql"> <![CDATA[ SELECT surname, name, age FROM person @@ -68,7 +68,7 @@ </programlisting> 次にスクリプト実行時に置換されるパラメータを確認します。 このパラメータを置換子で置換します。 - <programlisting> + <programlisting role="sql"> <![CDATA[ SELECT surname, name, age FROM person @@ -135,7 +135,7 @@ </programlisting> </example> この例では、以下のようにクエリが4回実行されます。 - <programlisting> + <programlisting role="sql"> <![CDATA[ INSERT INTO numbers VALUES ('1', 'one', 'en') INSERT INTO numbers VALUES ('2', 'two', 'to') http://cvs.php.net/diff.php/peardoc/ja/package/database/db/intro-fetch.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/ja/package/database/db/intro-fetch.xml diff -u peardoc/ja/package/database/db/intro-fetch.xml:1.3 peardoc/ja/package/database/db/intro-fetch.xml:1.4 --- peardoc/ja/package/database/db/intro-fetch.xml:1.3 Tue Feb 24 11:29:08 2004 +++ peardoc/ja/package/database/db/intro-fetch.xml Tue Mar 2 17:58:32 2004 @@ -1,12 +1,12 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.11 Maintainer: elf Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.14 Maintainer: elf Status: ready --> <refentry id="package.database.db.intro-fetch"> <refnamediv> <refname>導入 - フェッチと取得</refname> <refpurpose>クエリ結果からレコードを取得する</refpurpose> </refnamediv> <refsect1 id="package.database.db.intro-fetch.desc"> - <title>説明</title> + &title.desc; <refsect2> <title>フェッチ関数</title> <simpara> @@ -20,14 +20,14 @@ <function>fetchRow</function></link> はレコードを返し、レコードがもうな い場合は&null;を、 エラーが発生した場合は<link - linkend="package.database.db.db-error"> - <classname>DB_Error</classname></link>を返します。 + linkend="package.database.db.db-error">&class.db-error;</link> + を返します。 <link linkend="package.database.db.db-result.fetchinto"> <function>fetchInto</function></link>は変数を引数とし、 ここには、結果レコードへのリファレンスが直接代入されます。 この関数は、結果セットが空の場合に&null;を、または<link - linkend="package.database.db.db-error"> - <classname>DB_Error</classname></link>を返します。 + linkend="package.database.db.db-error">&class.db-error;</link> + を返します。 <link linkend="package.database.db.db-result.fetchinto"> <function>fetchInto</function></link>は変数を引数とし、 ここには、結果レコードへのリファレンスが直接代入されます。 @@ -40,13 +40,13 @@ <programlisting role="php"> <![CDATA[ <?php -... +// Once you have a valid DB object named $db... $db = DB::connect($dsn); $res = $db->query("SELECT * FROM mytable"); // Get each row of data on each iteration until // there are no more rows -while ($row = $res->fetchRow()) { +while ($row =& $res->fetchRow()) { $id = $row[0]; } // Or: @@ -76,16 +76,17 @@ <programlisting role="php"> <![CDATA[ <?php -$res = $db->query('SELECT id, name, email FROM users'); -$row = $res->fetchRow(DB_FETCHMODE_ORDERED); +$res =& $db->query('SELECT id, name, email FROM users'); +$row =& $res->fetchRow(DB_FETCHMODE_ORDERED); /* -$row には以下が含まれます。 -array ( - 0 => <column "id" data>, - 1 => <column "name" data>, - 2 => <column "email" data> -) -*/ + * $row には以下が含まれます。 + * array ( + * 0 => <column "id" data>, + * 1 => <column "name" data>, + * 2 => <column "email" data> + * ) + */ + // 以下のようにアクセスします。 $id = $row[0]; $name = $row[1]; @@ -107,16 +108,18 @@ <programlisting role="php"> <![CDATA[ <?php -$res = $db->query('SELECT id, name, email FROM users'); -$row = $res->fetchRow(DB_FETCHMODE_ASSOC); +// Once you have a valid DB object named $db... +$res =& $db->query('SELECT id, name, email FROM users'); +$row =& $res->fetchRow(DB_FETCHMODE_ASSOC); /* -$row には以下が含まれます。 -array ( - 'id' => <column "id" data>, - 'name' => <column "name" data>, - 'email' => <column "email" data> -) -*/ + * $row には以下が含まれます。 + * array ( + * 'id' => <column "id" data>, + * 'name' => <column "name" data>, + * 'email' => <column "email" data> + * ) + */ + // 以下のようにアクセスします。 $id = $row['id']; $name = $row['name']; @@ -139,17 +142,19 @@ <programlisting role="php"> <![CDATA[ <?php -$res = $db->query('SELECT id, name, email FROM users'); -$row = $res->fetchRow(DB_FETCHMODE_OBJECT); +// Once you have a valid DB object named $db... +$res =& $db->query('SELECT id, name, email FROM users'); +$row =& $res->fetchRow(DB_FETCHMODE_OBJECT); /* -$row には以下が含まれます。 -db_row Object -( - [id] => <column "id" data>, - [name] => <column "name" data>, - [email] => <column "email" data> -) -*/ + * $row には以下が含まれます。 + * db_row Object + * ( + * [id] => <column "id" data>, + * [name] => <column "name" data>, + * [email] => <column "email" data> + * ) + */ + // 以下のようにアクセスします。 $id = $row->id; $name = $row->name; @@ -173,7 +178,7 @@ <programlisting role="php"> <![CDATA[ -while ($row = $result->fetchRow(DB_FETCHMODE_ASSOC)) { +while ($row =& $result->fetchRow(DB_FETCHMODE_ASSOC)) { $id = $row['id']; } ]]> @@ -183,13 +188,16 @@ <title>インスタンス毎</title> <programlisting role="php"> <![CDATA[ -$db = DB::connect($dsn); -// これは、PEAR DBインスタンスのデフォルトの取得モードを -// (全てのクエリについて)設定します -while ($row = $result->fetchRow()) { +<?php +// Once you have a valid DB object named $db... +$db->setFetchMode(DB_FETCHMODE_ASSOC); + +$res =& $db->query('SELECT * FROM users'); + +while ($row =& $res->fetchRow()) { $id = $row['id']; } - +?> ]]> </programlisting> </example> @@ -210,7 +218,9 @@ <title>番号で取得</title> <programlisting role="php"> <![CDATA[ -... +<?php +// Once you have a valid DB object named $db... + // 取得を開始するレコード $from = 50; @@ -221,12 +231,13 @@ $to = $from + $resPage; foreach (range($from, $to) as $rowNum) { -if (!$row = $res->fetchrow($fetchmode, $rowNum)) { + if (!$row =& $res->fetchRow($fetchmode, $rowNum)) { break; } $id = $row[0]; .... } +?> ]]> </programlisting> </example> @@ -243,12 +254,14 @@ <title>開放する</title> <programlisting role="php"> <![CDATA[ -... -$result = $db->query('SELECT * FROM clients'); -while ($row = $result->fetchRow()) { -... +<?php +// Once you have a valid DB object named $db... +$res =& $db->query('SELECT name, address FROM clients'); +while ($row =& $res->fetchRow()) { + echo $row['name'] . ', ' . $row['address'] . "\n"; } -$result->free(); +$res->free(); +?> ]]> </programlisting> </example> @@ -268,7 +281,10 @@ クエリから先頭カラムの最初の結果を取得します。 <programlisting role="php"> <![CDATA[ +<?php +// Once you have a valid DB object named $db... $numrows = $db->getOne('select count(id) from clients'); +?> ]]> </programlisting> </para> @@ -277,10 +293,13 @@ </link>は、先頭レコードを配列として返します。 <programlisting role="php"> <![CDATA[ -$sql = 'select name, address, phone from clients where id=1'; -if (is_array($row = $db->getRow($sql))) { - list($name, $address, $phone) = $row; +<?php +// Once you have a valid DB object named $db... +$sql = 'select name, address from clients where id=1'; +while ($row =& $db->getRow($sql)) { + echo $row['name'] . ', ' . $row['address'] . "\n"; } +?> ]]> </programlisting> </para> @@ -292,13 +311,21 @@ 2番目のパラメータとして取得するカラムの番号を指定可能です。 <programlisting role="php"> <![CDATA[ - $all_client_names = $db->getCol('SELECT name FROM clients'); +<?php +// Once you have a valid DB object named $db... +$data =& $db->getCol('SELECT name FROM clients'); + +/* + * Will return: + * array( + * 0 => 'Stig', + * 1 => 'Jon', + * 2 => 'Colin' + * ) + */ +?> ]]> </programlisting> - The above sentence could return for example: - <programlisting role="php"> - $all_client_names = array('Stig', 'Jon', 'Colin'); - </programlisting> </para> <para> <link linkend="package.database.db.db-common.getassoc"> @@ -307,15 +334,18 @@ 最初のカラムをキーとする連想配列として返します。 <programlisting role="php"> <![CDATA[ -$data = getAssoc('SELECT name, surname, phone FROM mytable') +<?php +// Once you have a valid DB object named $db... +$data =& $db->getAssoc('SELECT name, surname, phone FROM mytable'); /* -Will return: -array( - 'Peter' => array('Smith', '944679408'), - 'Tomas' => array('Cox', '944679408'), - 'Richard' => array('Merz', '944679408') -) -*/ + * Will return: + * array( + * 'Peter' => array('Smith', '944679408'), + * 'Tomas' => array('Cox', '944679408'), + * 'Richard' => array('Merz', '944679408') + * ) + */ +?> ]]> </programlisting> </para> @@ -360,8 +390,10 @@ "SELECT"クエリから返されたレコードの総数を返します。 <programlisting role="php"> <![CDATA[ +<?php // Number of rows echo $res->numRows(); +?> ]]> </programlisting> </para> @@ -373,8 +405,10 @@ "SELECT"クエリから返された総カラム数を返します。 <programlisting role="php"> <![CDATA[ +<?php // Number of cols echo $res->numCols(); +?> ]]> </programlisting> </para> http://cvs.php.net/diff.php/peardoc/ja/package/database/db/intro-portability.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/ja/package/database/db/intro-portability.xml diff -u peardoc/ja/package/database/db/intro-portability.xml:1.3 peardoc/ja/package/database/db/intro-portability.xml:1.4 --- peardoc/ja/package/database/db/intro-portability.xml:1.3 Tue Feb 24 11:29:08 2004 +++ peardoc/ja/package/database/db/intro-portability.xml Tue Mar 2 17:58:32 2004 @@ -1,5 +1,5 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.9 Maintainer: elf Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.11Maintainer: elf Status: ready --> <refentry id="package.database.db.intro-portability"> <refnamediv> <refname>導入 - 移植性</refname> @@ -20,11 +20,9 @@ PEAR DBは差を克服するために努めます。 </para> <para> - <link linkend="package.database.db.db.connect"> - <function>connect</function> - </link>と<link linkend="package.database.db.db-common.setoption"> - <function>setOption</function> - </link>をしようすることで、 + <link linkend="package.database.db.db.connect"><function>connect</function></link> + と<link linkend="package.database.db.db-common.setoption"> + <function>setOption</function></link>をしようすることで、 どのポータビリティモードが可能になるか制御します。 </para> <para>