cvs: phpdoc-ja /reference/ibm_db2/functions db2-set-option.xml /reference/stats .cvsignore reference.xml

takagi Sun Oct 8 07:12:28 2006 UTC Added files: /phpdoc-ja/reference/stats reference.xml .cvsignore /phpdoc-ja/reference/ibm_db2/functions db2-set-option.xml Log: initial translation.

http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/stats/reference.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/stats/reference.xml +++ phpdoc-ja/reference/stats/reference.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <!-- Purpose: mathcrypto.math --> <!-- Membership: pecl --> <reference id="ref.stats"> <title>統計関数</title> <titleabbrev>Statistics</titleabbrev> <partintro> <section id="stats.intro"> &reftitle.intro; <para> 統計用の拡張モジュールです。統計計算のために有用な関数を、 何十個も含んでいます。この拡張モジュールは、B. Brown &amp; J. Lavato の DCDFLIB (Library of C routines for Cumulative Distributions Functions, Inverses, and Other parameters) および Barry Brown, James Lavato &amp; Kathy Russell の RANDLIB という 2 つの科学ライブラリのラッパーです。 CD 関数および PD 関数を含みます。 </para> </section> <section id="stats.installation"> &reftitle.install; <para> &pecl.moved; </para> <para> &pecl.info; <ulink url="&url.pecl.package;stats">&url.pecl.package;stats</ulink>. </para> <para> &pecl.windows.download; </para> </section> <section id="stats.requirements"> &reftitle.required; <para> 外部ライブラリは不要です。使用するライブラリは、 この拡張モジュールにバンドルされています。 </para> </section> </partintro> &reference.stats.functions; </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/stats/.cvsignore?view=markup&rev=1.1 Index: phpdoc-ja/reference/stats/.cvsignore +++ phpdoc-ja/reference/stats/.cvsignore functions.xml http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/ibm_db2/functions/db2-set-option.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/ibm_db2/functions/db2-set-option.xml +++ phpdoc-ja/reference/ibm_db2/functions/db2-set-option.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <refentry id="function.db2-set-option"> <refnamediv> <refname>db2_set_option</refname> <refpurpose>接続リソースあるいはステートメントリソースのオプションを設定する</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <!-- All Functions have this --> <type>bool</type><methodname>db2_set_option</methodname> <!-- Required Parameter (First Param) --> <methodparam><type>resource</type><parameter>resource</parameter></methodparam> <!-- Required Parameter (Second Param) --> <methodparam><type>array</type><parameter>options</parameter></methodparam> <!-- Optional Parameter (Third Param) --> <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> </methodsynopsis> <para> ステートメントリソースあるいは接続リソースのオプションを設定します。 結果セットリソースのオプションを設定することはできません。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>resource</parameter></term> <listitem> <para> <function>db2_prepare</function> が返す有効なステートメントリソースか、 あるいは <function>db2_connect</function> や <function>db2_pconnect</function> が返す有効な接続リソース。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>options</parameter></term> <listitem> <para> ステートメントあるいは接続のオプションを含む連想配列。 このパラメータは、自動コミットの値を変更したりカーソルの型を (スクロール可能、あるいは前進のみに) 変更したり、結果セットに表示されるカラム名を (小文字、大文字、あるいは元のままに) 設定したりする際に使用します。 <variablelist> <varlistentry> <term><parameter>autocommit</parameter></term> <listitem> <para> <literal>DB2_AUTOCOMMIT_ON</literal> を渡すと、 指定した接続リソースの自動コミットをオンにします。 </para> <para> <literal>DB2_AUTOCOMMIT_OFF</literal> を渡すと、 指定した接続リソースの自動コミットをオフにします。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>cursor</parameter></term> <listitem> <para> <literal>DB2_FORWARD_ONLY</literal> を渡すと、 ステートメントリソースに前進のみのカーソルを指定します。 これはデフォルトのカーソル型であり、 すべてのデータベースサーバでサポートされています。 </para> <para> <literal>DB2_SCROLLABLE</literal> を渡すと、 ステートメントリソースにスクロール可能なカーソルを指定します。 このカーソルは、順番どおり以外の方法で結果セットの行にアクセス可能です。 しかし、IBM DB2 Universal Database でしかサポートされていません。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>binmode</parameter></term> <listitem> <para> <literal>DB2_BINARY</literal> を渡すと、 バイナリデータがそのままの形式で返されるようになります。 これはデフォルトのモードです。&php.ini; で <literal>ibm_db2.binmode=1</literal> とするのと同じことです。 </para> <para> <literal>DB2_CONVERT</literal> を渡すと、 バイナリデータを十六進エンコーディングで変換して返します。 これは、&php.ini; で <literal>ibm_db2.binmode=2</literal> とするのと同じことです。 </para> <para> <literal>DB2_PASSTHRU</literal> を渡すと、 バイナリデータを &null; に変換するようになります。これは &php.ini; で <literal>ibm_db2.binmode=3</literal> とするのと同じことです。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>db2_attr_case</parameter></term> <listitem> <para> <literal>DB2_CASE_LOWER</literal> を渡すと、 結果セットのカラム名を小文字で返します。 </para> <para> <literal>DB2_CASE_UPPER</literal> を渡すと、 結果セットのカラム名を大文字で返します。 </para> <para> <literal>DB2_CASE_NATURAL</literal> を渡すと、 結果セットのカラム名をそのまま何もせずに返します。 </para> </listitem> </varlistentry> </variablelist> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>type</parameter></term> <listitem> <para> この関数に渡すリソースの型を、整数値で指定します。 リソースの型とこの値は必ず一致していなければなりません。 <variablelist> <varlistentry> <term><parameter></parameter></term> <listitem> <para> <literal>1</literal> は、 接続リソースがこの関数に渡されることを表します。 </para> <para> <literal>1</literal> 以外の整数を指定すると、 ステートメントリソースがこの関数に渡されることを表します。 </para> </listitem> </varlistentry> </variablelist> </para> </listitem> </varlistentry> </variablelist> </para> <para> </para> <para> 次の表は、それぞれのオプションがどのリソース型で使用可能かをまとめたものです。 <table> <title>リソースとパラメータの対応</title> <tgroup cols="5"> <colspec colnum="1" colname="col1" align="center" /> <colspec colnum="2" colname="col2" align="center" /> <colspec colnum="3" colname="col3" align="center" /> <colspec colnum="4" colname="col4" align="center" /> <colspec colnum="5" colname="col5" align="center" /> <thead> <row> <entry morerows="1">キー</entry> <entry morerows="1">値</entry> <entry namest="col3" nameend="col5">リソースの型</entry> </row> </thead> <tbody> <row> <entry colname="col3">接続</entry> <entry colname="col4">ステートメント</entry> <entry colname="col5">結果セット</entry> </row> <row> <entry>autocommit</entry> <entry><literal>DB2_AUTOCOMMIT_ON</literal></entry> <entry colname="col3">X</entry> <entry colname="col4">-</entry> <entry colname="col5">-</entry> </row> <row> <entry>autocommit</entry> <entry><literal>DB2_AUTOCOMMIT_OFF</literal></entry> <entry colname="col3">X</entry> <entry colname="col4">-</entry> <entry colname="col5">-</entry> </row> <row> <entry>cursor</entry> <entry><literal>DB2_SCROLLABLE</literal></entry> <entry colname="col3">X</entry> <entry colname="col4">X</entry> <entry colname="col5">-</entry> </row> <row> <entry>cursor</entry> <entry><literal>DB2_FORWARD_ONLY</literal></entry> <entry colname="col3">X</entry> <entry colname="col4">X</entry> <entry colname="col5">-</entry> </row> <row> <entry>binmode</entry> <entry><literal>DB2_BINARY</literal></entry> <entry colname="col3">X</entry> <entry colname="col4">X</entry> <entry colname="col5">-</entry> </row> <row> <entry>binmode</entry> <entry><literal>DB2_CONVERT</literal></entry> <entry colname="col3">X</entry> <entry colname="col4">X</entry> <entry colname="col5">-</entry> </row> <row> <entry>binmode</entry> <entry><literal>DB2_PASSTHRU</literal></entry> <entry colname="col3">X</entry> <entry colname="col4">X</entry> <entry colname="col5">-</entry> </row> <row> <entry>db2_attr_case</entry> <entry><literal>DB2_CASE_LOWER</literal></entry> <entry colname="col3">X</entry> <entry colname="col4">X</entry> <entry colname="col5">-</entry> </row> <row> <entry>db2_attr_case</entry> <entry><literal>DB2_CASE_UPPER</literal></entry> <entry colname="col3">X</entry> <entry colname="col4">X</entry> <entry colname="col5">-</entry> </row> <row> <entry>db2_attr_case</entry> <entry><literal>DB2_CASE_NATURAL</literal></entry> <entry colname="col3">X</entry> <entry colname="col4">X</entry> <entry colname="col5">-</entry> </row> </tbody> </tgroup> </table> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <!-- Place Changelog next if any --> <!-- Place Examples next if any --> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>接続リソースにひとつのパラメータを設定する</title> <para> </para> <programlisting role="php"> <![CDATA[ <?php /* データベース接続用のパラメータ */ $database = 'SAMPLE'; $hostname = 'localhost'; $port = 50000; $protocol = 'TCPIP'; $username = 'db2inst1'; $password = 'ibmdb2'; /* 接続文字列 */ $conn_string = "DRIVER={IBM DB2 ODBC DRIVER};DATABASE=$database;"; $conn_string .= "HOSTNAME=$hostname;PORT=$port;PROTOCOL=$protocol;"; $conn_string .= "UID=$username;PWD=$password;"; /* 接続リソースを取得します */ $conn = db2_connect($conn_string, '', ''); /* 有効なキーと値を使用して、オプションの連想配列を作成します */ $options = array('autocommit' => DB2_AUTOCOMMIT_ON); /* 正しいリソースとオプションの配列、そして型を表す値を指定して関数をコールします */ $result = db2_set_option($conn, $options, 1); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> </programlisting> &example.outputs; <screen><![CDATA[オプションの設定に成功しました]]></screen> </example> <example> <title>接続リソースに複数のパラメータを設定する</title> <para> </para> <programlisting role="php"> <![CDATA[ <?php /* データベース接続用のパラメータ */ $database = 'SAMPLE'; $hostname = 'localhost'; $port = 50000; $protocol = 'TCPIP'; $username = 'db2inst1'; $password = 'ibmdb2'; /* 接続文字列 */ $conn_string = "DRIVER={IBM DB2 ODBC DRIVER};DATABASE=$database;"; $conn_string .= "HOSTNAME=$hostname;PORT=$port;PROTOCOL=$protocol;"; $conn_string .= "UID=$username;PWD=$password;"; /* 接続リソースを取得します */ $conn = db2_connect($conn_string, '', ''); /* 有効なキーと値を使用して、オプションの連想配列を作成します */ $options = array('autocommit' => DB2_AUTOCOMMIT_OFF, 'binmode' => DB2_PASSTHRU, 'db2_attr_case' => DB2_CASE_UPPER, 'cursor' => DB2_SCROLLABLE); /* 正しいリソースとオプションの配列、そして型を表す値を指定して関数をコールします */ $result = db2_set_option($conn, $options, 1); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> </programlisting> &example.outputs; <screen><![CDATA[オプションの設定に成功しました]]></screen> </example> <!-- Behaves Incorrectly --> <example> <title>複数のパラメータを間違ったキーで設定する</title> <para> </para> <programlisting role="php"> <![CDATA[ <?php /* データベース接続用のパラメータ */ $database = 'SAMPLE'; $hostname = 'localhost'; $port = 50000; $protocol = 'TCPIP'; $username = 'db2inst1'; $password = 'ibmdb2'; /* 接続文字列 */ $conn_string = "DRIVER={IBM DB2 ODBC DRIVER};DATABASE=$database;"; $conn_string .= "HOSTNAME=$hostname;PORT=$port;PROTOCOL=$protocol;"; $conn_string .= "UID=$username;PWD=$password;"; /* 接続リソースを取得します */ $conn = db2_connect($conn_string, '', ''); /* 有効なキーと値を使用して、オプションの連想配列を作成します */ $options = array('autocommit' => DB2_AUTOCOMMIT_OFF, 'MY_INVALID_KEY' => DB2_PASSTHRU, 'db2_attr_case' => DB2_CASE_UPPER, 'cursor' => DB2_SCROLLABLE); /* 正しいリソースとオプションの配列、そして型を表す値を指定して関数をコールします */ $result = db2_set_option($conn, $options, 1); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> </programlisting> &example.outputs; <screen><![CDATA[オプションが設定できませんでした]]></screen> </example> <!-- Behaves Incorrectly --> <example> <title>複数のパラメータを間違った値で設定する</title> <para> </para> <programlisting role="php"> <![CDATA[ <?php /* データベース接続用のパラメータ */ $database = 'SAMPLE'; $hostname = 'localhost'; $port = 50000; $protocol = 'TCPIP'; $username = 'db2inst1'; $password = 'ibmdb2'; /* 接続文字列 */ $conn_string = "DRIVER={IBM DB2 ODBC DRIVER};DATABASE=$database;"; $conn_string .= "HOSTNAME=$hostname;PORT=$port;PROTOCOL=$protocol;"; $conn_string .= "UID=$username;PWD=$password;"; /* 接続リソースを取得します */ $conn = db2_connect($conn_string, '', ''); /* 有効なキーと値を使用して、オプションの連想配列を作成します */ $options = array('autocommit' => DB2_AUTOCOMMIT_OFF, 'binmode' => 'INVALID_VALUE', 'db2_attr_case' => DB2_CASE_UPPER, 'cursor' => DB2_SCROLLABLE); /* 正しいリソースとオプションの配列、そして型を表す値を指定して関数をコールします */ $result = db2_set_option($conn, $options, 1); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> </programlisting> &example.outputs; <screen><![CDATA[オプションが設定できませんでした]]></screen> </example> <example> <title>複数のパラメータを接続リソースに設定する (間違った型を指定する)</title> <para> </para> <programlisting role="php"> <![CDATA[ <?php /* データベース接続用のパラメータ */ $database = 'SAMPLE'; $hostname = 'localhost'; $port = 50000; $protocol = 'TCPIP'; $username = 'db2inst1'; $password = 'ibmdb2'; /* 接続文字列 */ $conn_string = "DRIVER={IBM DB2 ODBC DRIVER};DATABASE=$database;"; $conn_string .= "HOSTNAME=$hostname;PORT=$port;PROTOCOL=$protocol;"; $conn_string .= "UID=$username;PWD=$password;"; /* 接続リソースを取得します */ $conn = db2_connect($conn_string, '', ''); /* 有効なキーと値を使用して、オプションの連想配列を作成します */ $options = array('autocommit' => DB2_AUTOCOMMIT_OFF, 'binmode' => DB2_PASSTHRU, 'db2_attr_case' => DB2_CASE_UPPER, 'cursor' => DB2_SCROLLABLE); /* 正しいリソースとオプションの配列、そして間違った型を表す値を指定して関数をコールします */ $result = db2_set_option($conn, $options, 2); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> </programlisting> &example.outputs; <screen><![CDATA[オプションが設定できませんでした]]></screen> </example> <example> <title>複数のパラメータを間違ったリソースに設定する</title> <para> </para> <programlisting role="php"> <![CDATA[ <?php /* データベース接続用のパラメータ */ $database = 'SAMPLE'; $hostname = 'localhost'; $port = 50000; $protocol = 'TCPIP'; $username = 'db2inst1'; $password = 'ibmdb2'; /* 接続文字列 */ $conn_string = "DRIVER={IBM DB2 ODBC DRIVER};DATABASE=$database;"; $conn_string .= "HOSTNAME=$hostname;PORT=$port;PROTOCOL=$protocol;"; $conn_string .= "UID=$username;PWD=$password;"; /* 接続リソースを取得します */ $conn = db2_connect($conn_string, '', ''); /* 有効なキーと値を使用して、オプションの連想配列を作成します */ $options = array('autocommit' => DB2_AUTOCOMMIT_OFF, 'binmode' => DB2_PASSTHRU, 'db2_attr_case' => DB2_CASE_UPPER, 'cursor' => DB2_SCROLLABLE); $stmt = db2_prepare($conn, 'SELECT * FROM EMPLOYEE'); /* 間違ったリソース、そして正しいオプションの配列と型を表す値を指定して関数をコールします */ $result = db2_set_option($stmt, $options, 1); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> </programlisting> &example.outputs; <screen><![CDATA[オプションが設定できませんでした]]></screen> </example> <example> <title>すべてひとつにまとめる</title> <para> </para> <programlisting role="php"> <![CDATA[ <?php /* データベース接続用のパラメータ */ $database = 'SAMPLE'; $hostname = 'localhost'; $port = 50000; $protocol = 'TCPIP'; $username = 'db2inst1'; $password = 'ibmdb2'; /* 接続文字列 */ $conn_string = "DRIVER={IBM DB2 ODBC DRIVER};DATABASE=$database;"; $conn_string .= "HOSTNAME=$hostname;PORT=$port;PROTOCOL=$protocol;"; $conn_string .= "UID=$username;PWD=$password;"; /* 接続リソースを取得します */ $conn = db2_connect($conn_string, '', ''); /* 有効なキーと値を使用して、オプションの連想配列を作成します */ $options = array('db2_attr_case' => DB2_CASE_LOWER, 'cursor' => DB2_SCROLLABLE); $stmt = db2_prepare($conn, 'SELECT * FROM EMPLOYEE WHERE EMPNO = ? OR EMPNO = ?'); /* 正しいリソースとオプションの配列、そして型を表す値を指定して関数をコールします */ $option_result = db2_set_option($stmt, $options, 2); $result = db2_execute($stmt, array('000130', '000140')); /* スクロール可能なカーソルのため、1 行目より先に 2 行目を取得します */ print_r(db2_fetch_assoc($stmt, 2)); print '<br /><br />'; print_r(db2_fetch_assoc($stmt, 1)); ?> ]]> </programlisting> &example.outputs; <screen><![CDATA[Array ( [empno] => 000140 [firstnme] => HEATHER [midinit] => A [lastname] => NICHOLLS [workdept] => C01 [phoneno] => 1793 [hiredate] => 1976-12-15 [job] => ANALYST [edlevel] => 18 [sex] => F [birthdate] => 1946-01-19 [salary] => 28420.00 [bonus] => 600.00 [comm] => 2274.00 ) Array ( [empno] => 000130 [firstnme] => DELORES [midinit] => M [lastname] => QUINTANA [workdept] => C01 [phoneno] => 4578 [hiredate] => 1971-07-28 [job] => ANALYST [edlevel] => 16 [sex] => F [birthdate] => 1925-09-15 [salary] => 23800.00 [bonus] => 500.00 [comm] => 1904.00 )]]></screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>db2_connect</function></member> <member><function>db2_pconnect</function></member> <member><function>db2_exec</function></member> <member><function>db2_prepare</function></member> <member><function>db2_cursor_type</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->