cvs: peardoc /ja/package/database db-dataobject.xml /ja/package/database/db-dataobject/db-dataobject count.xml free.xml selectas.xml

From: Date: Thu, 07 Jul 2005 10:24:50 +0000
Subject: cvs: peardoc /ja/package/database db-dataobject.xml /ja/package/database/db-dataobject/db-dataobject count.xml free.xml selectas.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-6471@lists.php.net to get a copy of this message
haruki Thu Jul 7 06:24:50 2005 EDT Added files: /peardoc/ja/package/database/db-dataobject/db-dataobject free.xml Modified files: /peardoc/ja/package/database db-dataobject.xml /peardoc/ja/package/database/db-dataobject/db-dataobject selectas.xml count.xml Log: sync with en

http://cvs.php.net/diff.php/peardoc/ja/package/database/db-dataobject.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/ja/package/database/db-dataobject.xml diff -u peardoc/ja/package/database/db-dataobject.xml:1.1 peardoc/ja/package/database/db-dataobject.xml:1.2 --- peardoc/ja/package/database/db-dataobject.xml:1.1 Fri Apr 1 18:47:46 2005 +++ peardoc/ja/package/database/db-dataobject.xml Thu Jul 7 06:24:50 2005 @@ -1,115 +1,116 @@ -<?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.11 Maintainer: shimooka Status: ready --> - -<sect1 id="package.database.db-dataobject"> - <title>DB_DataObject</title> - - <para> - SQL ビルダとデータモデル層 - </para> - <para> - この章では、DB_DataObject SQL - ビルダとデータモデル層の使用方法について説明しています。 - </para> - - &package.database.db-dataobject.intro-purpose; - &package.database.db-dataobject.intro-configuration; - &package.database.db-dataobject.intro-autobuilding; - - &package.database.db-dataobject.db-dataobject.factory; - &package.database.db-dataobject.db-dataobject.get; - &package.database.db-dataobject.db-dataobject.staticget; - &package.database.db-dataobject.db-dataobject.staticget2; - &package.database.db-dataobject.db-dataobject.find; - &package.database.db-dataobject.db-dataobject.fetch; - &package.database.db-dataobject.db-dataobject.count; - - <!-- Depreciated ? - &package.database.db-dataobject.db-dataobject.fetchrow; - --> - - - - - &package.database.db-dataobject.db-dataobject.insert; - &package.database.db-dataobject.db-dataobject.update; - &package.database.db-dataobject.db-dataobject.delete; - - - &package.database.db-dataobject.intro-filters; - - &package.database.db-dataobject.db-dataobject.query; - &package.database.db-dataobject.db-dataobject.selectadd; - &package.database.db-dataobject.db-dataobject.whereadd; - &package.database.db-dataobject.db-dataobject.escape; - &package.database.db-dataobject.db-dataobject.limit; - &package.database.db-dataobject.db-dataobject.orderby; - &package.database.db-dataobject.db-dataobject.groupby; - - - - - &package.database.db-dataobject.intro-relations; - &package.database.db-dataobject.db-dataobject.getlink; - &package.database.db-dataobject.db-dataobject.getlinks; - <!-- - not sure if this should be public... - and it may be replaced eventually.. - &package.database.db-dataobject.db-dataobject.getlinkarray; - - --> - &package.database.db-dataobject.db-dataobject.selectas; - &package.database.db-dataobject.db-dataobject.joinadd; - - <!-- other usefull stuff --> - &package.database.db-dataobject.db-dataobject.settersgetters; - - &package.database.db-dataobject.db-dataobject.setfrom; - &package.database.db-dataobject.db-dataobject.toarray; - &package.database.db-dataobject.db-dataobject.validate; - - &package.database.db-dataobject.db-dataobject.tablename; - &package.database.db-dataobject.db-dataobject.database; - &package.database.db-dataobject.db-dataobject.table; - &package.database.db-dataobject.db-dataobject.keys; - - &package.database.db-dataobject.db-dataobject.getdatabaseconnection; - &package.database.db-dataobject.db-dataobject.getdatabaseresult; - - -<!-- staticAutoLoad is missing?? --> - - - - &package.database.db-dataobject.db-dataobject.debuglevel; - &package.database.db-dataobject.db-dataobject.debug; - &package.database.db-dataobject.db-dataobject.raiseerror; - -<!-- casting.. a little experimental at present --> - &package.database.db-dataobject.intro-casting; - - <!-- This shouldnt really be public.... - &package.database.db-dataobject.db-dataobject.staticinitialize; - --> - - - </sect1> -<!-- 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 -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 ---> +<?xml version="1.0" encoding="utf-8" ?> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.12 Maintainer: shimooka Status: ready --> + +<sect1 id="package.database.db-dataobject"> + <title>DB_DataObject</title> + + <para> + SQL ビルダとデータモデル層 + </para> + <para> + この章では、DB_DataObject SQL + ビルダとデータモデル層の使用方法について説明しています。 + </para> + + &package.database.db-dataobject.intro-purpose; + &package.database.db-dataobject.intro-configuration; + &package.database.db-dataobject.intro-autobuilding; + + &package.database.db-dataobject.db-dataobject.factory; + &package.database.db-dataobject.db-dataobject.get; + &package.database.db-dataobject.db-dataobject.staticget; + &package.database.db-dataobject.db-dataobject.staticget2; + &package.database.db-dataobject.db-dataobject.find; + &package.database.db-dataobject.db-dataobject.fetch; + &package.database.db-dataobject.db-dataobject.count; + + <!-- Depreciated ? + &package.database.db-dataobject.db-dataobject.fetchrow; + --> + + + + + &package.database.db-dataobject.db-dataobject.insert; + &package.database.db-dataobject.db-dataobject.update; + &package.database.db-dataobject.db-dataobject.delete; + + + &package.database.db-dataobject.intro-filters; + + &package.database.db-dataobject.db-dataobject.query; + &package.database.db-dataobject.db-dataobject.free; + &package.database.db-dataobject.db-dataobject.selectadd; + &package.database.db-dataobject.db-dataobject.whereadd; + &package.database.db-dataobject.db-dataobject.escape; + &package.database.db-dataobject.db-dataobject.limit; + &package.database.db-dataobject.db-dataobject.orderby; + &package.database.db-dataobject.db-dataobject.groupby; + + + + + &package.database.db-dataobject.intro-relations; + &package.database.db-dataobject.db-dataobject.getlink; + &package.database.db-dataobject.db-dataobject.getlinks; + <!-- + not sure if this should be public... - and it may be replaced eventually.. + &package.database.db-dataobject.db-dataobject.getlinkarray; + + --> + &package.database.db-dataobject.db-dataobject.selectas; + &package.database.db-dataobject.db-dataobject.joinadd; + + <!-- other usefull stuff --> + &package.database.db-dataobject.db-dataobject.settersgetters; + + &package.database.db-dataobject.db-dataobject.setfrom; + &package.database.db-dataobject.db-dataobject.toarray; + &package.database.db-dataobject.db-dataobject.validate; + + &package.database.db-dataobject.db-dataobject.tablename; + &package.database.db-dataobject.db-dataobject.database; + &package.database.db-dataobject.db-dataobject.table; + &package.database.db-dataobject.db-dataobject.keys; + + &package.database.db-dataobject.db-dataobject.getdatabaseconnection; + &package.database.db-dataobject.db-dataobject.getdatabaseresult; + + +<!-- staticAutoLoad is missing?? --> + + + + &package.database.db-dataobject.db-dataobject.debuglevel; + &package.database.db-dataobject.db-dataobject.debug; + &package.database.db-dataobject.db-dataobject.raiseerror; + +<!-- casting.. a little experimental at present --> + &package.database.db-dataobject.intro-casting; + + <!-- This shouldnt really be public.... + &package.database.db-dataobject.db-dataobject.staticinitialize; + --> + + + </sect1> +<!-- 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 +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/diff.php/peardoc/ja/package/database/db-dataobject/db-dataobject/selectas.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/ja/package/database/db-dataobject/db-dataobject/selectas.xml diff -u peardoc/ja/package/database/db-dataobject/db-dataobject/selectas.xml:1.1 peardoc/ja/package/database/db-dataobject/db-dataobject/selectas.xml:1.2 --- peardoc/ja/package/database/db-dataobject/db-dataobject/selectas.xml:1.1 Fri Apr 1 18:47:47 2005 +++ peardoc/ja/package/database/db-dataobject/db-dataobject/selectas.xml Thu Jul 7 06:24:50 2005 @@ -1,178 +1,178 @@ -<?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.2 Maintainer: shimooka Status: ready --> -<refentry id="package.database.db-dataobject.db-dataobject.selectas"> - <refnamediv> - <refname>-&gt;selectAs()</refname> - <refpurpose>クエリの取得 コンポーネントを構築する (通常は結合のため)</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - - <funcprototype> - <funcdef>void <function>$DB_DataObject-&gt;selectAs</function></funcdef> - - <paramdef> - object | array <parameter><optional>$columns_or_object</optional></parameter> - string <parameter><optional>$format</optional></parameter> - string <parameter><optional>$table_name</optional></parameter> - </paramdef> - - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db-dataobject.db-dataobject.selectas.desc"> - &title.desc; - <para> - 現在のオブジェクトのカラム名、提供されたオブジェクトあるいは配列に基づいた - 取得アイテムを自動生成します。 - </para> - <para> - これは、カラム名の衝突を起こしている時 - (両方の表に 'id' カラムが存在するなど) 、主に固定フォーマットでカラムの改名を可能にするための joinAdd を用いた結合で使用されます。 - </para> - <para> - selectAs にパラメータを渡さない場合、現在の SELECT - (通常デフォルトの *) をリセットし、現在のオブジェクトのカラム名に基づいた - 取得リストを構築します。 - </para> - - </refsect1> - - <refsect1 id="package.database.db-dataobject.db-dataobject.selectas.parameter"> - &title.param; - <para> - <itemizedlist> - - <listitem> - <para> - <parameter>object | array $column_or_object</parameter> - - データオブジェクトもしくはカラム名の配列を指定します - </para> - </listitem> - - <listitem> - <para> - <parameter>string $format</parameter> - - カラムが現れたときに使用するフォーマットで、sprintf - フォーマットを指定します。 - %s はカラム名に置換されますので、car_%s は SQL 中で - 'car.name as car_name' が生成されることなります。 - </para> - </listitem> - - <listitem> - <para> - <parameter>string $tableName</parameter> - - これは1番目の引数として配列が指定された、 - あるいはテーブルを他の名前で結合している場合に使用されます。 - </para> - </listitem> - - </itemizedlist> - </para> - </refsect1> - - - - - <refsect1 id="package.database.db-dataobject.db-dataobject.selectas.note"> - &title.note; - - &note.notstatic; - - - - <simpara></simpara> - </refsect1> - - - <refsect1 id="package.database.db-dataobject.db-dataobject.selectas.example"> - &title.example; - <example> - <title><function>selectAs</function> の使用</title> - <programlisting role="php"> - <![CDATA[ -<?php -// ok lets see what is going on.. -DB_DataObject::debugLevel(1); - -$person = new DataObjects_Person; - - -// to generate "person.id as id , person.name as name ......." -$person->selectAs(); - -// to generate a restricted list.. "person.age as age , person.name as name" -$person->selectAs(array('age','name')); - -// using another object. -$car = new DataObjects_Car; - -// this is the first car ( -$car->use = 'first'; - - -// using the joinadd add the car.. -$person->joinAdd($car); - -// now add all the select columsn for the car eg. "car.id as car_id, car.name as car_name ...." -$person->selectAs($car, 'car_%s'); - - -// select only a few columns from the car table. -// note you have to use the table name at the end.. -$person->selectAs(array('color','topspeed'), 'car_%s','car'); - - - - -// now the user can have a second car.... -$secondcar = new DataObjects_Car; -$secondcar->use = 'second'; - -// now since we alreay have one car, the sql statement would get messy -// so we are joining this as the second car "FROM person INNER JOIN car ..... , car as secondcar WHERE ..... -$person->joinAdd($secondcar,'','secondcar'); - -// and we can now add all the columns -// "secondcar.id as secondcar_id, secondcar.name as secondcar_name ........ -// note that you must use the last field as the SECONDCAR.ID format uses the 'AS' name, rather than the -// objects real table name 'car' -$person->selectAs($secondcar, 'secondcar_%s','secondcar'); - - - -// ok fire of a query... -$person->find(); -while ($person->fetch()) { - ...... -} - - -?> -]]> - </programlisting> - </example> - - </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 -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 ---> +<?xml version="1.0" encoding="utf-8" ?> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: shimooka Status: ready --> +<refentry id="package.database.db-dataobject.db-dataobject.selectas"> + <refnamediv> + <refname>-&gt;selectAs()</refname> + <refpurpose>クエリの取得 コンポーネントを構築する (通常は結合のため)</refpurpose> + </refnamediv> + <refsynopsisdiv> + <funcsynopsis> + + <funcprototype> + <funcdef>void <function>$DB_DataObject-&gt;selectAs</function></funcdef> + + + <paramdef> object | array <parameter><optional>$columns_or_object</optional></parameter></paramdef> + <paramdef> string <parameter><optional>$format</optional></parameter></paramdef> + <paramdef> string <parameter><optional>$table_name</optional></parameter></paramdef> + + + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + <refsect1 id="package.database.db-dataobject.db-dataobject.selectas.desc"> + &title.desc; + <para> + 現在のオブジェクトのカラム名、提供されたオブジェクトあるいは配列に基づいた + 取得アイテムを自動生成します。 + </para> + <para> + これは、カラム名の衝突を起こしている時 + (両方の表に 'id' カラムが存在するなど) 、主に固定フォーマットでカラムの改名を可能にするための joinAdd を用いた結合で使用されます。 + </para> + <para> + selectAs にパラメータを渡さない場合、現在の SELECT + (通常デフォルトの *) をリセットし、現在のオブジェクトのカラム名に基づいた + 取得リストを構築します。 + </para> + + </refsect1> + + <refsect1 id="package.database.db-dataobject.db-dataobject.selectas.parameter"> + &title.param; + <para> + <itemizedlist> + + <listitem> + <para> + <parameter>object | array $column_or_object</parameter> - + データオブジェクトもしくはカラム名の配列を指定します + </para> + </listitem> + + <listitem> + <para> + <parameter>string $format</parameter> - + カラムが現れたときに使用するフォーマットで、sprintf + フォーマットを指定します。 + %s はカラム名に置換されますので、car_%s は SQL 中で + 'car.name as car_name' が生成されることなります。 + </para> + </listitem> + + <listitem> + <para> + <parameter>string $tableName</parameter> - + これは1番目の引数として配列が指定された、 + あるいはテーブルを他の名前で結合している場合に使用されます。 + </para> + </listitem> + + </itemizedlist> + </para> + </refsect1> + + + + + <refsect1 id="package.database.db-dataobject.db-dataobject.selectas.note"> + &title.note; + + &note.notstatic; + + + + <simpara></simpara> + </refsect1> + + + <refsect1 id="package.database.db-dataobject.db-dataobject.selectas.example"> + &title.example; + <example> + <title><function>selectAs</function> の使用</title> + <programlisting role="php"> + <![CDATA[ +<?php +// ok lets see what is going on.. +DB_DataObject::debugLevel(1); + +$person = new DataObjects_Person; + + +// to generate "person.id as id , person.name as name ......." +$person->selectAs(); + +// to generate a restricted list.. "person.age as age , person.name as name" +$person->selectAs(array('age','name')); + +// using another object. +$car = new DataObjects_Car; + +// this is the first car ( +$car->use = 'first'; + + +// using the joinadd add the car.. +$person->joinAdd($car); + +// now add all the select columsn for the car eg. "car.id as car_id, car.name as car_name ...." +$person->selectAs($car, 'car_%s'); + + +// select only a few columns from the car table. +// note you have to use the table name at the end.. +$person->selectAs(array('color','topspeed'), 'car_%s','car'); + + + + +// now the user can have a second car.... +$secondcar = new DataObjects_Car; +$secondcar->use = 'second'; + +// now since we alreay have one car, the sql statement would get messy +// so we are joining this as the second car "FROM person INNER JOIN car ..... , car as secondcar WHERE ..... +$person->joinAdd($secondcar,'','secondcar'); + +// and we can now add all the columns +// "secondcar.id as secondcar_id, secondcar.name as secondcar_name ........ +// note that you must use the last field as the SECONDCAR.ID format uses the 'AS' name, rather than the +// objects real table name 'car' +$person->selectAs($secondcar, 'secondcar_%s','secondcar'); + + + +// ok fire of a query... +$person->find(); +while ($person->fetch()) { + ...... +} + + +?> +]]> + </programlisting> + </example> + + </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 +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/diff.php/peardoc/ja/package/database/db-dataobject/db-dataobject/count.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/ja/package/database/db-dataobject/db-dataobject/count.xml diff -u peardoc/ja/package/database/db-dataobject/db-dataobject/count.xml:1.1 peardoc/ja/package/database/db-dataobject/db-dataobject/count.xml:1.2 --- peardoc/ja/package/database/db-dataobject/db-dataobject/count.xml:1.1 Fri Apr 1 18:47:47 2005 +++ peardoc/ja/package/database/db-dataobject/db-dataobject/count.xml Thu Jul 7 06:24:50 2005 @@ -1,116 +1,161 @@ -<?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.5 Maintainer: shimooka Status: ready --> -<refentry id="package.database.db-dataobject.db-dataobject.count"> - <refnamediv> - <refname>-&gt;count()</refname> - <refpurpose>select count() リクエストを実行する</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - - <funcprototype> - <funcdef>int <function>$DB_DataObject-&gt;count</function></funcdef> - - - <paramdef></paramdef> - - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db-dataobject.db-dataobject.count.desc"> - &title.desc; - <para> - これは、表のキーカラムによる select count() リクエストを実行し、 - 結果の行数を返します。 - count() に適用されるデフォルトの条件は、オブジェクト変数と whereAdd - の設定内容の組み合わせです。 - もし、定数 DB_DATAOBJECT_WHEREADD_ONLY が第1パラメータに指定された場合、 - whereAdd の設定内容だけが使用されます。 - - - </para> - </refsect1> - - <refsect1 id="package.database.db-dataobject.db-dataobject.count.parameter"> - &title.param; - <para> - <itemizedlist> - - <listitem> - <para> - <parameter>boolean $useWhereAddOnly</parameter> - - whereAdd 条件のみ使用するかどうかを指定します - (デフォルトでは、count オブジェクトの設定内容と - whereAdd の条件の両方が使用されます) 。 - </para> - </listitem> - - </itemizedlist> - </para> - </refsect1> - - - <refsect1 id="package.database.db-dataobject.db-dataobject.count.return"> - &title.returns; - <para> - <parameter>int</parameter> - 結果の数 - </para> - </refsect1> - - - - <refsect1 id="package.database.db-dataobject.db-dataobject.count.note"> - &title.note; - - &note.notstatic; - - - - <simpara></simpara> - </refsect1> - - <refsect1 id="package.database.db-dataobject.db-dataobject.count.example"> - &title.example; - <example> - <title>オブジェクト変数に基づいたデータの簡単な検索とフェッチ</title> - <programlisting role="php"> - <![CDATA[ -$person = new DataObjects_Person; - -$person->whereAdd('name like '%test%'); -$total = $person->count(); - -echo "There are {$total} people with a name like test"; -]]> - </programlisting> - </example> - <example> - <title>結果の SQL </title> - <programlisting> - <![CDATA[ -SELECT count(id) FROM person WHERE name like '%test%' -]]> - </programlisting> - </example> - </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 -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 ---> +<?xml version="1.0" encoding="utf-8" ?> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.8 Maintainer: shimooka Status: ready --> +<refentry id="package.database.db-dataobject.db-dataobject.count"> + <refnamediv> + <refname>-&gt;count()</refname> + <refpurpose>select count() リクエストを実行する</refpurpose> + </refnamediv> + <refsynopsisdiv> + <funcsynopsis> + + <funcprototype> + <funcdef>int <function>$DB_DataObject-&gt;count</function></funcdef> + <paramdef>string|boolean <parameter><optional>$countWhat|$whereAddOnly</optional></parameter></paramdef> + <paramdef>boolean <parameter><optional>$whereAddOnly</optional></parameter></paramdef> + + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + <refsect1 id="package.database.db-dataobject.db-dataobject.count.desc"> + &title.desc; + <para> + これは、表のキーカラムによる select count() リクエストを実行し、 + 結果の行数を返します。 + count() に適用されるデフォルトの条件は、オブジェクト変数と whereAdd + の設定内容の組み合わせです。 + もし、定数 DB_DATAOBJECT_WHEREADD_ONLY が第1パラメータに指定された場合、 + whereAdd の設定内容だけが使用されます。 + + + </para> + </refsect1> + + <refsect1 id="package.database.db-dataobject.db-dataobject.count.parameter"> + &title.param; + <para> + <itemizedlist> + + <listitem> + <para> + <parameter>string $countWhat</parameter> - + デフォルトカウントは、主キーをカウントします。 + もし何か他をカウントする必要がある場合で、単純に DISTINCT + を指定する場合は DISTINCT を前に付けた主キーをカウントします。 + その他の場合は独自の値をカウントします + (エスケープが必要な場合、忘れないようにしてください) 。 + + </para> + </listitem> + <listitem> + <para> + <parameter>boolean $useWhereAddOnly</parameter> - + whereAdd 条件のみ使用するかどうかを指定します + (デフォルトでは、count オブジェクトの設定内容と + whereAdd の条件の両方が使用されます) 。 + </para> + </listitem> + + </itemizedlist> + </para> + </refsect1> + + + <refsect1 id="package.database.db-dataobject.db-dataobject.count.return"> + &title.returns; + <para> + <parameter>int|false</parameter> - 結果の数もしくは失敗時に false + </para> + </refsect1> + + + + <refsect1 id="package.database.db-dataobject.db-dataobject.count.note"> + &title.note; + + &note.notstatic; + + + + <simpara></simpara> + </refsect1> + + <refsect1 id="package.database.db-dataobject.db-dataobject.count.example"> + &title.example; + <example> + <title>オブジェクト変数に基づいたデータの簡単な検索とフェッチ</title> + <programlisting role="php"> + <![CDATA[ +<?php + +/* using property values */ +$person = new DataObjects_Person; +$person->name = "test" +$total = $person->count(); +echo "There are {$total} people with a name like test"; + +/* using countWhat */ +$person = new DataObjects_Person; +$total = $person->count('DISTINCT name'); +echo "There are {$total} names in the database"; + +/* using countWhat value = DISTINCT */ +$person = new DataObjects_Person; +$total = $person->count('DISTINCT'); +echo "There are {$total} names in the database"; + +/* using whereOnly */ +$person = new DataObjects_Person; +$person->name = "test"; +$person->whereAdd("name like '%test%"); +$total = $person->count(DB_DATAOBJECT_WHEREADD_ONLY); +echo "There are {$total} names in the database"; + +?> +]]> + </programlisting> + </example> + <example> + <title>結果の SQL </title> + <programlisting> + <![CDATA[ +SELECT count(person.id) AS DATAOBJECT_NUM + FROM person + WHERE person.name = 'test'; + +SELECT count(DISTINCT name) AS DATAOBJECT_NUM + FROM person; + +SELECT count(DISTINCT person.id) AS DATAOBJECT_NUM + FROM person; + +SELECT count(person.id) AS DATAOBJECT_NUM + FROM person + WHERE name like '%test%'; + + + +]]> + </programlisting> + </example> + </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 +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/co.php/peardoc/ja/package/database/db-dataobject/db-dataobject/free.xml?r=1.1&p=1 Index: peardoc/ja/package/database/db-dataobject/db-dataobject/free.xml +++ peardoc/ja/package/database/db-dataobject/db-dataobject/free.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: shimooka Status: ready --> <refentry id="package.database.db-dataobject.db-dataobject.free"> <refnamediv> <refname>-&gt;free()</refname> <refpurpose>リソースを解放する</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcprototype> <funcdef>object <function>$DB_DataObject-&gt;free</function></funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.database.db-dataobject.db-dataobject.free.desc"> &title.desc; <para> DataObject はプライベートなグローバル変数として結果セットを保持しています。 通常これは結果を処理した後、もしくはリクエストの終了時に解放されます。 しかし、クエリを直接実行している、データを挿入しているなどの いくつかの状況ではデータをキャッシュする必要がありません。 </para> <para> このメソッドを使用することで、全ての結果セットを解放することができます (注意してください) ! このメソッドは、実行中の fetch() ループを停止させます。 </para> <para> 通常、大量の挿入やクエリを実行している場合のみ、 このメソッドを使用する必要があります。 </para> </refsect1> <refsect1 id="package.database.db-dataobject.db-dataobject.free.note"> &title.note; &note.notstatic; </refsect1> <refsect1 id="package.database.db-dataobject.db-dataobject.free.example"> &title.example; <example> <title>ループ内でリソースを解放する</title> <programlisting role="php"><![CDATA[ <?php for ($i = 0; i< 10000; $i++) { $person = new DataObjects_Person; $person->query(' ... do something ... '); $person->free(); } ?> ]]> </programlisting> </example> </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 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 -->
« previous php.pear.doc (#6471) next »